OSS 결과 보고서

---

💡 안녕하세요. Open UP 운영사무국입니다. 본 페이지는 13주간 진행된 Challenges(4주) 및 Masters(9주) 프로그램 기간 동안 진행했던 ①멘티 활동, ②컨트리뷰션 내역을 정리하는 최종보고서 작성 페이지입니다.

Untitled

• **멘티** 최종보고 작성 기간: ~10월 15일(수) └ 13주간 진행된 프로그램 활동에 대한 최종보고서 작성 └ 중간보고와 동일하게, 사무국이 개별 노션 페이지 초청 → 해당 페이지에서 최종보고서 작성
• **사무국** 멘티 최종보고 검토 기간: ~10월 17일(금)
• **멘토** 최종보고 작성 기간: ~10월 15일(수)** **└ 멘티 최종보고서 작성 이후, 멘토가 팀 최종보고서 작성 └ 본 보고서는 아카데미 최종 수상팀 선정을 위한 중요한 기준!!

📡 **2025 OSSCA 프로그램 최종 수료**** **를 위해선 멘티 개별 최종보고서 제출은 필수입니다.

📘 원활한 보고서 작성 및 리뷰를 위해 ‘23 오픈소스 컨트리뷰션 아카데미 [참여형] 팀 멘티의 최종보고서를 참고 자료로 공유합니다.

• 개인정보 보호를 위해, 예시 자료 내 사진, 성함 등은 모자이크 및 일부 삭제 했습니다.

Untitled

Untitled

Untitled

---

☑️ 멘티 정보

💡 프로젝트명 & 이름 & 컨트리뷰션 기간

**프로젝트명 : **Githru-vscode-ext

이름 : 박재현

---

**2025 OSSCA [참여형] 활동기간: 약 13주** 2025. 7. 12 (토) - 2025. 11. 1 (토)

**[Challenges: 4주]** 2025. 7. 12 (토) - 2025. 8. 15 (금)

**[Masters: 9주]** 2025. 8. 16 (토) - 2025. 11. 1 (토)

---

☑️ 컨트리뷰션 활동 내역

💡 Challenges(4주) & Masters(9주) 프로그램 기간 동안 진행했던 활동 내역을 모두 정리해 주세요.

• 진행 과정, 기여 활동 내역, 관련 링크, 온⸱오프라인 모임 등

요약

항목	비교	값 (줄)
추가	1137	1137 줄
삭제	846	846 줄

• 주요 기여 내용 : CSMDict 를 빌드로직을 최신 커밋부터 진행하는 것으로 방향 전환

상세목록

PR

제목	분류	날짜
https://github.com/githru/githru-vscode-ext/pull/801	fix	07/22
https://github.com/githru/githru-vscode-ext/pull/810	refactor	07/29
https://github.com/githru/githru-vscode-ext/pull/890	refactor	09/18
https://github.com/githru/githru-vscode-ext/pull/914	feature	09/30
https://github.com/githru/githru-vscode-ext/pull/915	refactor	09/30
https://github.com/githru/githru-vscode-ext/pull/917	feature	09/30
https://github.com/githru/githru-vscode-ext/pull/920	fix	10/01

Issue

제목	분류	날짜
https://github.com/githru/githru-vscode-ext/issues/787	fix	07/13
https://github.com/githru/githru-vscode-ext/issues/798	fix	07/22
https://github.com/githru/githru-vscode-ext/issues/799	fix	07/22
https://github.com/githru/githru-vscode-ext/issues/800	refactor	07/22
https://github.com/githru/githru-vscode-ext/issues/805	feature	07/24
https://github.com/githru/githru-vscode-ext/issues/806	fix	07/24
https://github.com/githru/githru-vscode-ext/issues/842	feature	08/18
https://github.com/githru/githru-vscode-ext/issues/845	feature	08/18
https://github.com/githru/githru-vscode-ext/issues/846	feature	08/18
https://github.com/githru/githru-vscode-ext/issues/847	feature	08/18
https://github.com/githru/githru-vscode-ext/issues/870	feature	08/28
https://github.com/githru/githru-vscode-ext/issues/889	refactor	09/18
https://github.com/githru/githru-vscode-ext/issues/892	refactor	09/20
https://github.com/githru/githru-vscode-ext/issues/912	feature	09/30
https://github.com/githru/githru-vscode-ext/issues/913	feature	09/30
https://github.com/githru/githru-vscode-ext/issues/916	feature	09/30
https://github.com/githru/githru-vscode-ext/issues/919	fix	10/01

활동 내용

1️⃣ Githru/Performance 팀 정기/비정기 모임

• 매주 월요일 19:30 정기적으로 Open Up 또는 디스코드로 온/오프라인 모임 진행
• Performance/Refactor/Test 각 팀의 금주 진행 현황 및 차주 계획 공유
• 논의가 필요한 내용이 있을 경우, 해당 안건에 대한 회의 진행
• 멘토님께 실시간 질의 및 피드백 요청
• 모각코 진행

2️⃣ 세미나 참여

• 비정기적인 멘토님 세미나 참여

3️⃣ 자료 공유

• AI, 회의 내용, Githru 등 여러 주제에 관련된 다양한 내용 공유

4️⃣ 논의할 내용 공유

주요 기여 내용

1️⃣ CSM Squash merge 방향 개선

최신순으로 CSM(Commit Summary Model) 빌드 시 squash merge 로직을 개선하여 over-squashing 문제를 해결

1. CommitNode에 mergedIntoStem 플래그 추가

• 머지 부모 노드가 어느 stem으로 병합되었는지 추적하는 mergedIntoStem 필드 추가
• 이를 통해 향후 머지 포인트를 정확하게 식별 가능

1. Squash 범위 제한 로직 구현

• AS-IS : stem의 끝까지 모든 노드를 squash (over-squashing 발생)
• TO-BE : 다음 mergedIntoStem 노드 직전까지만 squash
• 이후 머지를 위해 남겨둬야 할 커밋을 보호

1. 커밋 정렬 순서 수정

• 시간순 정렬: 오래된 커밋 → 최신 커밋 (올바른 순서)
• commit.sequence 기준 오름차순 정렬 적용

1. 테스트 케이스 업데이트

• 모든 테스트 데이터에 mergedIntoStem 플래그 명시
• master 브랜치와 sub1 브랜치 케이스 모두 업데이트
• 머지 구조를 명확하게 표현하여 테스트 신뢰성 향상

2️⃣ CSMDict Pagination builder 구현

대규모 저장소에서 효율적인 지연 로딩(lazy loading)을 위해 커서 기반 페이지네이션을 지원하는 CSM Dictionary Builder를 구현

1. **buildPaginatedCSMDict**** 함수 추가**

• 커서 기반 페이지네이션: lastCommitId를 커서로 사용하여 다음 페이지 탐색
• 페이지 크기 제어: perPage 파라미터로 한 번에 로드할 커밋 수 조절
• 유효성 검증: perPage, stemDict, lastCommitId에 대한 포괄적인 검증
• PR 통합: 기존 buildCSMDict와 동일하게 Pull Request 정보 통합

1. 코드 품질 개선 (리팩토링)

• 중복 제거: buildPRDict 유틸리티 함수 추출
• 코드 재사용성: buildCSMNodesWithPR 함수 추출로 공통 로직 공유
• JSDoc 개선: 모든 함수에 상세한 문서화 및 예제 추가
• 일관성: 변수명 통일 (prDict, baseStem) 및 검증 로직 일관화

1. 테스트 커버리지 강화

• 8개의 테스트 케이스 추가 (csm.spec.ts)

3️⃣ remote Repo 파싱 함수 개선

1. Azure DevOps URL 파싱 지원

• 기존 문제: getRepo 함수가 GitHub URL만 지원하여 Azure DevOps 저장소에서 오류 발생
• 해결 방안: Azure DevOps URL 패턴을 지원하도록 정규식 패턴 추가
• 지원 URL 형식:

1. ** 테스트 코드 추가**

• GitHub URL 다양한 형식 검증 (HTTPS/SSH, .git 확장자 유무, 사용자명 포함 등)
• Azure DevOps URL 형식 검증
• 잘못된 URL 형식에 대한 에러 처리 검증

---

로직 분석을 위한 테스트 시각화

☑️ 정량적 성과 요약

💡 기여 활동에 대해 명시적으로 확인할 수 있도록, 기여의 종류에 따라 정량적 성과를 작성해 주세요. 표 & 그래프를 사용하여 작성 요청드립니다. **- 필수 항목 : 아래 표의 항목 4개 (PR, 머지, 커밋, 이슈) ** ※ 필수 항목 모두 채울 수 없는 경우에는, 채울 수 있는 항목만 채워주세요. ※ 필수 항목 외에 기타 항목은(리뷰, 번역 등) 필수 항목 밑으로 이어서 작성해 주세요.

	총 합계	Challenges	Masters
Pull Request	7	2	5
Merge	10	2	8
Commit	29	8	21
Issue	17	6	11
Review	16	6	10
모임	17	7	10

---

☑️ 아카데미 참가 후기 & 앞으로의 계획

💡 약 13주간 달려온 여러분! 정말 고생 많으셨습니다. 아카데미 프로그램 참가 후기를 말씀해 주세요. 또 향후 컨트리뷰터로써 멘티님의 계획을 작성해 주세요.

약 13주 동안 Githru-vscode-ext 프로젝트의 컨트리뷰터로 참여하며 많은 배움을 얻었습니다.

평소 깊이 고민해보지 않았던 “데이터를 빠르게 가공하고 시각화하기 위한 알고리즘 설계”를 직접 탐구할 수 있었고, 멘토님과의 세미나를 통해 프론트엔드 아키텍처 전반에 대한 사고의 폭을 넓힐 수 있었습니다. 그 과정이 정말 흥미로웠고, 개인적으로도 크게 성장하는 시간이었다고 느낍니다.

바쁜 일정 속에서도 매주 온·오프라인으로 팀원들과 만나 이슈를 논의하고 함께 해결해 나가는 과정은 매우 뜻깊었습니다. 특히 코드의 변경 주기가 빠른 프로젝트 특성상, 전체 맥락을 빠르게 이해하고 핵심 로직을 찾아 들어가는 역동적인 경험은 오픈소스에서만 느낄 수 있는 소중한 기회였습니다.

이번 활동 중 CSMDict의 빌드 속도를 최신순으로 변경해 유의미한 성능 개선을 이뤘지만, 여전히 도전할 과제들이 남아 있습니다.

앞으로는 최신순 기준의 20개 또는 30개 단위 커밋 페이징 처리, 페이지 로딩 피드백 제공, 다음 페이지 프리페칭 기능 등을 구현해 사용자 경험을 한 층 높이는 것을 목표로 하고 있습니다.

회사 프로젝트와 달리, 오픈소스는 빠르게 변하는 코드에 적응하면서 알고리즘적 사고를 지속적으로 요구하는 점이 특히 재미있었습니다.

이번 아카데미를 계기로 얻은 경험을 바탕으로 앞으로도 꾸준히 Githru 프로젝트에 기여하며 남은 과제들을 하나씩 완성해나가고 싶습니다. 또한 함께한 동료와 멘토분들과의 인연을 이어가며, 지속적인 성장의 발판으로 삼고자 합니다.

---

💡 작성이 끝나셨다면, 아래 ***“작성 완료”***를 체크해 주세요. 멘티 최종보고서 작성 기간은 ~10월 15일(수)까지입니다. 작성 기한 내 미작성 시, 미제출로 분류되며 **2025 OSSCA 프로그램 최종수료 및 수료증 발급**이 불가합니다.

• [x] 작성완료