6차 — 병합을 끝까지 믿고 쓸 수 있게

15개 항목 중 A 다섯 · B-1 ~ B-6 이 끝났다(B-6: 같은 줄 충돌 15개 22.0초 → 1.2초). 남은 것은 아래 순서다.

C# 코드 스타일 맞춤에서 남긴 것

• 들여쓰기 · 공백 등 다른 서식은 맞추지 않는다 — 중괄호와 else · catch · finally 의 줄 위치만.
• git 병합 자체는 스타일을 모른다. 스타일만 다른 충돌도 git 은 충돌로 내고, MergeHub 는 네 칸에서 맞춰 보여 줄 뿐 자동으로 풀지는 않는다.

6차에서 남긴 것

• 머지 주석 자동 풀기는 Git 탭 [Merge] 에만 걸었다. pull · rebase · cherry-pick 이 낸 충돌에는 아직.
• rebase · cherry-pick 충돌을 끝까지 믿을 수 있게 하는 확인 — 6차에서 뺐다.
• MERGED 칸에서 반영하며 넣은 주석 줄이 다시 정렬하면 “무시” 색이 된다(차이 수에는 원래 안 세던 줄).
• 폴더 비교 뒤 화면 트리를 세우는 데 약 1초 — 줄일 자리로 적어 둠(5차 B-2).

미룬 것

기획안에서 아직 안 한 것

• Gitea PR · 리뷰 코멘트 인라인 표시 (기획 확장 범위) — 사내 Gitea 저장소가 아직 없다. 지금은 원격 주소 · 계정 설정과 Fetch · Pull · Push 까지.
• 멀티 레포 대시보드 · 오프라인 캐싱 (확장 범위)
• Roslyn 실시간 구문 검사 (확장 범위) — 가벼운 코드 검사로 대신했다. Roslyn 은 붙이지 않았다.
• 변경분 ZIP 내보내기 — 폴더로만 뽑는다.
• 기획 4단계: 사내 베타 배포와 피드백, 단축키 가이드 포함 매뉴얼 (기획 일정 09.29 ~ 10.02).
• 푸시 — 사내 Gitea 저장소가 만들어지면 그때 한 번에 올린다.

차수별 기록

1. 09-03
   기획안 v1.14주(영업일 20일) 개발 기준. MVP 8개 · Git 작업 UI화 5개 · 확장 3개.
2. 09-07
   머지툴 기본기 보강 · 사용성 보강“머지툴이 본체, Git 은 얹는 기능” 으로 방향 전환. 히스토그램 정렬, 진짜 3-Way(나중에 네 칸), Git 유무에 따라 화면 바꾸기, 언어 · 이진 파일, 폴더 비교. 작업자 이름 등록, 머지 주석을 고친 줄 위에 쌓기, WinMerge 단축키 + 설명 창, 셸 상 · 하단 띠 줄이기(코드 31줄 → 34줄).
3. 09-08
   2주차 — 기능 덩어리 ①~⑤① 폴더째 복사 · 삭제 · 보기 필터 · 비교 취소 ② 바꾸기 · 덩어리 반영 · 저장 형식 · 이진/그림 비교 ③ 자동 병합 · 충돌만 이동 · 병합 완료 판정 ④ amend · stash 목록 · 커밋 간 비교 · blame · 변경분 추출 ⑤ 명령줄 인자 · 탐색기 보내기.
4. 09-09
   3차 — 버그 정리 + 기능 확장 (23항목)폴더 고르기에서 죽던 것, 화면 이동 결함 3가지, 3-Way 스크롤 · 행 어긋남, 주석만 다름, C++ 전처리 색칠, 3-Way 덩어리 반영을 REMOTE 로, 결과 내보내기, 폴더 전체 검색, 끌어다 놓기. 22 완료 · 1 취소. 하네스 16벌 514건.
5. 09-10
   4차 — 로컬 머지툴 사용성 (13항목)저장 안 한 편집이 사라지던 길 8군데 막음, 보고서에 만든 사람, 최근 비교 목록, 폴더 목록 다음 파일로, 경로 표시 정리, 아래 상태 한 줄로, Git 원격 칸 접기(128px), 범례 눌러서 이동, ACTIONS 정리. 11 완료 · 2 취소. 17벌 571건.
6. 09-11
   5차 — 실제 소스에 맞추기CP949 67개 확인(실제 저장소 2,091개 깨짐 0) · 판별 코드 한 곳으로. 커밋 · 체크아웃 전에 저장 안 한 편집을 묻기. XAML 태그 · 속성 · 값 색칠(여러 줄 태그 포함). 폴더 비교 3.4배 / 4.7배. 20벌 698건.
7. 09-14
   5차 C-1 — 병합을 끝까지만든 저장소 303개 · 충돌 22개를 MergeHub 만으로 병합 커밋까지. 코드는 안 고치고 걸린 것 23가지를 적음.
8. 09-14
   6차 A-1 ~ B-6 · 추가 요청 E-1 ~ E-3아래 표. C# 스타일 맞춤 · 시연 재료 · 이 문서. 22벌 948건.

6차에서 끝낸 것

검사 하네스

차수 끝의 통과 건수. 로직을 건드리면 테스트를 먼저 늘린다.

기능 목록

1. 프로젝트 개요

배경 · 목적 — 바뀌지 않음

담당자의 실력 향상을 위한 자기주도 과제이면서 사내에서 실제로 쓰는 도구를 남긴다. TortoiseGit 은 셸 확장이 파일 상태를 폴링하고 이력 조회마다 git.exe 를 새로 띄워 저장소가 클수록 느리다. 병합 · 비교가 번거로워 Git 을 꺼리게 된다. Merge / Diff 를 한 프로그램으로 통합한다.

바뀐 것 — 머지툴이 본체 (09-07)

v1.1 은 “Git 저장소의 병합 화면” 이었다. 만들어 보니 Git 저장소 안 · C# 소스 · 두 칸 비교에 묶여 있어 실무에서 쓰기 어려웠다. Git 이 아니어도, 소스가 아니어도 비교가 되는 머지툴을 본체로 두고 Git 을 그 위에 얹었다. 그래서 기획에 없던 폴더 비교가 첫 탭이 됐다.

기대효과 — 확인된 것

• 사내 개발 자산 — 사내 요구가 생기면 바로 반영한다. 실제로 머지 주석 무시(B-5)는 결정한 날 들어갔다.
• 생산성 — 병합 저장이 줄끝을 보존해 리뷰할 diff 가 +3,367/−3,363 에서 +8/−4 로 줄었다.
• 개발 역량 — WPF · MVVM · libgit2 · 셸 플러그인 구조 경험이 기록(doc/history)으로 남는다.

2. 사용자 시나리오

타겟: 사내 Windows PC 개발자. Git 명령줄 경험은 필수 아님.

3. 상세 기능 명세

3.1 정보 구조도 (실제)

MergeHub (UbisamBase 셸 탭)
├─ 폴더 비교            — v1.1 에 없던 탭
│  ├─ 전체 / 빠른 비교 · 보기 필터 · 주석만 다름
│  ├─ 폴더째 복사 · 삭제
│  └─ 폴더 전체 검색 · 결과 내보내기
├─ 파일 비교
│  ├─ 두 칸 (기준 · 내 파일) · 커밋 이력 · 미니맵
│  ├─ 네 칸 (LOCAL · BASE · REMOTE · MERGED)
│  ├─ 반영 · Undo/Redo · 머지 주석
│  ├─ 저장 형식 · 비교 규칙 · 편집 잠금 · 코드 검사
│  └─ C# 스타일 맞춤  — AURORA / Allman
├─ Git
│  ├─ 저장소 연결 (로컬 · 원격 · Gitea 계정)
│  ├─ 브랜치 · 병합 / 충돌 / 변경 · 커밋
│  └─ 이력 / Blame / 태그 · 서브모듈
└─ 설정 (셸 설정 탭 → MergeHub)
   ├─ 비교 옵션 · 머지 주석 · 사내 Gitea · 데모
   └─ mergetool · 탐색기 보내기 등록은 Git 탭 버튼

v1.1 은 하단 탭 다섯 개(2-Way Diff · 3-Way Merge · Folder Diff · Branch Graph · Settings)였다. 두 칸과 네 칸은 한 탭 안에서 저절로 바뀌고, 커밋 그래프는 Git 탭 이력으로 들어갔다. 탭은 셸이 그린다.

3.2 기능 목록 — MVP 8개

Git 작업 UI화 — 1차 범위 5개

확장 범위 — 2차 이후

v1.1 에 없던 기능 — 만들면서 더한 것

• 폴더 비교 · 폴더 전체 검색 · 결과 내보내기
• 언어 13가지 색칠(XAML 여러 줄 태그 포함) · CP949 판별 · 이진/그림 비교
• 머지 주석 넣기와 비교 · 병합에서 무시, 주석만 다른 충돌 자동 해결
• 병합 중 [해결로 저장] · 한쪽 삭제 충돌 [파일 남기기]/[파일 지우기] · 병합 커밋 메시지
• WinMerge 단축키와 설명 창 · 최근 비교 목록 · 끌어다 놓기 · 북마크 · 찾기/바꾸기
• 저장 안 한 편집 보호(4차 A-1 · 5차 A-2)
• 완료 C# 코드 스타일 맞춤 (AURORA / Allman) · 충돌 여러 개 한 번에 · 발표 시연 재료

3.3 화면 정의 — 메인 화면

실제 파일 비교 탭은 이 틀에서 이렇게 달라졌다.

• 맨 위 한 줄: 최근 · 파일 콤보 · 3-Way 콤보 · 데모 전환 · [단축키] · [결과 내보내기]. 같은 경로가 세 곳에 나오던 것을 하나로(4차 C-1).
• 그 아래 색 구분 범례 — 눌러서 이동(4차 C-4).
• 가운데: 두 칸이면 커밋 이력 · BASE · LOCAL, 네 칸이면 위 LOCAL · BASE · REMOTE 와 아래 MERGED. 커밋 이력 칸은 네 칸일 때 폭을 양보한다.
• 오른쪽 ACTIONS: 자주 쓰는 것(저장 · 반영 · 충돌 이동 · 머지 설명 · 커밋) 위, 한 번 정하는 것(저장 형식 · 비교 규칙 · 편집 잠금)은 접는 칸(4차 C-5).
• 창 아래 상태 한 줄: 줄/열 · 인코딩 · 줄바꿈 · 켜진 무시 규칙 · 코드 검사(4차 C-2). 셸 상 · 하단 띠를 줄여 코드가 3줄 더 보인다.
• 다크 테마 리소스는 셸이 준다(라이트 · 다크).

4. 개발 일정 및 마일스톤

일하는 방식 — v1.1 에 없던 것

• 차수마다 지시서(doc/작업지시) → 항목마다 빌드 · 실행 · 화면 확인 → 기록 세 군데(상세 · 상태 · changelog 한 줄) → 로컬 커밋.
• 고치기 전에 문제가 다시 나는 것부터 보이고, 고친 뒤 안 나는 것을 값으로 보인다.
• 실제 고객 소스는 열지 않는다. 씨앗을 고정한 시험 저장소(C1Repo · 303개)와 시험 묶음(4,500개)을 만들어 쓴다.
• 푸시하지 않는다. 사내 Gitea 저장소가 생기면 한 번에 올린다.

비고(v1.1 과 같음): 담당 업무 외 시간(퇴근 후 · 주말)을 활용한다. 지연이 예상되면 확장 범위를 먼저 조정한다.

데모 폴더 구성

D:\Sorce\MergeTool\MergeHub\demo\
├─ make-demo.ps1              한 번 실행하면 아래를 모두 새로 만든다
├─ plain\left\  plain\right\  폴더 비교용
├─ style\Aurora.cs  Allman.cs 같은 코드, 스타일만 다름
├─ mergetool\Weld_BASE.cs  Weld_LOCAL.cs  Weld_REMOTE.cs  Weld.cs
└─ big\Big7479_left.cs  Big7479_right.cs  7,479줄

D:\MergeHubDemo\repo\          make-demo.ps1 이 만드는 Git 저장소
   feature/mine · feature/theirs

전날 준비

1. MergeHub 를 Release 로 빌드하고, 켜져 있는 UbisamBase.Shell 을 끈다.
2. PowerShell 에서 powershell -ExecutionPolicy Bypass -File D:\Sorce\MergeTool\MergeHub\demo\make-demo.ps1. 시연 직전에도 한 번 더 돌려 처음 상태로 만든다.
3. 저장소 병합을 미리 한 번 해 보고 충돌 수 · 자동으로 풀린 수를 적어 둔다(발표 때 숫자를 말하기 위해). 끝나면 make-demo.ps1 로 되돌린다.
4. 설정 → MergeHub → 데모: .git 있는 폴더 = D:\MergeHubDemo\repo, .git 없는 폴더 = …\demo\plain\left. 위 줄에 두 화면을 오가는 버튼이 생긴다.
5. 설정 → 머지 주석: “비교 · 병합에서 머지 주석 무시” 켬. 비교 옵션 “C# 코드 스타일 맞춤” 은 끔으로 둔다 — 시연 중에 화면에서 고르는 것을 보여 준다.
6. 셸 창을 최대화, 화면 배율 100~125%. 작업자 이름 창에는 발표자 이름.

대본

시연이 막히면

• 화면이 이상하면 F5(다시 비교). 저장소가 꼬이면 Git 탭 작업 취소 뒤 make-demo.ps1 을 다시 돌린다(1분 안쪽이어야 한다 — 전날 재 둔다).
• 병합 중 상태바의 인코딩 · 줄바꿈 값은 아직 틀릴 수 있다(B-7). 짚지 않는다.
• 병합 커밋 뒤 파일 비교 탭이 어정쩡하면(B-8) Git 탭 새로고침.

기능 비교

WinMerge 쪽은 공개된 기능 설명 기준이다(최신 2.16 판). MergeHub 쪽은 2026-09-14 소스와 기록 기준이다.

MergeHub 가 필요한 이유

1. 병합이 한 화면에서 끝난다. WinMerge 는 git 이 파일마다 하나씩 불러 주는 비교 창이다. 충돌이 22개면 명령줄과 WinMerge 를 22번 오간다. MergeHub 는 병합 → 충돌 목록 → 네 칸 → 해결로 저장 → 병합 커밋까지 탭 안에서 간다.
2. 반영 기록을 소스에 남기고, 그 기록 때문에 생기는 충돌은 스스로 푼다. 우리 팀은 누가 언제 반영했는지를 // [이름] 날짜 로 남긴다. WinMerge 에는 이 규칙이 없어 손으로 적어야 하고, 다음 병합 때 주석끼리 충돌한다. 만든 저장소에서 git 충돌 26개 중 2개가 이런 충돌이었다.
3. 리뷰할 diff 를 지킨다. 병합 결과를 내 쪽 파일의 줄끝 · 인코딩으로 쓴다. 3분할 저장이 LF 로 바꿔 쓰던 문제를 고친 뒤 3,367줄 파일의 diff 가 +8/−4 로 줄었다. CP949 한글 파일도 같은 규칙이다.
4. 스타일만 다른 diff 를 걷어 낸다. 사람마다 다른 C# 중괄호 자리를 AURORA / Allman 로 맞춘 뒤 견준다. 시연 파일에서 남은 차이가 39줄에서 진짜 변경 1줄로 준다.
5. 우리가 고친다. 사내 요구가 생기면 그날 넣는다 — C# 스타일 맞춤은 요청 당일 들어갔다. 기록과 검사(22벌 948건)가 저장소에 함께 있다.

WinMerge 가 더 나은 점

• 안정성과 검증 — 오래, 많은 사람이 썼다. MergeHub 는 아직 만든 시험 저장소로만 확인했고, 6차 D-1 (처음부터 다시 끝까지)도 남았다.
• 3-way 폴더 비교, 이미지 비교(겹쳐 보기 · 차이 강조), 표 · 압축 파일 · 문서 비교, 플러그인.
• 여러 비교를 동시에 여는 창 · 탭.
• 보고서 형식(HTML 등)과 다국어.
• 단독 실행 — 셸 없이 어느 PC 에서나 설치해 쓴다. MergeHub 는 UbisamBase 셸이 있어야 한다.
• 한 파일 안에서 줄 이동 선 표시 같은 세부 표시가 더 풍부하다.

같이 쓰는 방법