ksj09406
26d9d042bf
LOCAL 칸을 이 파일에만 쓰고 스테이징하는 단추라 Save & Commit 과 짝이 되게 이름만 바꿈. 알림 · 막힘 안내 · 웹 문서도 Save. 하는 일은 그대로(충돌 24 → 23, 커밋 없음 확인). 7차 지시서: 6차 D-1 에서 걸린 세 가지(마지막 저장 뒤 남은 차이 · 로그 3-Way 안 씀 · 기록 파일 남음)와 pull · rebase · cherry-pick 충돌. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
145 lines
10 KiB
Markdown
145 lines
10 KiB
Markdown
# 작업 지시 — MergeHub 7차 (병합 화면이 사실대로 말하게 · 병합 말고 다른 충돌 길)
|
|
|
|
대상: `D:\Sorce\MergeTool\MergeHub` (플러그인) · `D:\Sorce\MergeTool\UbisamPlatform` (셸)
|
|
전제: 1~6차 지시서는 모두 끝났다([../진행상황.md](../진행상황.md)).
|
|
|
|
**이번 지시서가 나온 곳** — 6차 D-1 에서 시험 저장소를 새로 만들어 MergeHub 만으로 처음부터 병합 커밋까지 다시 했다.
|
|
줄끝 · BOM 이 바뀐 파일은 0/33 이었고 5차의 23가지 중 18가지가 사라졌다. 대신 **새로 걸린 것이 세 가지**였고,
|
|
6차에서 일부러 뺀 **병합이 아닌 충돌 길**(pull · rebase · cherry-pick)이 남아 있다.
|
|
근거와 수치는 [../history/2026-09-14-6차.md](../history/2026-09-14-6차.md) 의 D-1 에 있다.
|
|
|
|
| 6차 D-1 에서 잰 것 | 값 |
|
|
|---|---|
|
|
| 충돌 | git 26 · 머지 주석 자동 2 · 파일 단위 Accept 15(1.3초) · 3분할 저장 7 · 지우기/남기기 2 |
|
|
| 줄끝 · BOM · 인코딩이 내 쪽과 달라진 파일 | **0 / 33** · 충돌 표식 0줄 |
|
|
| 병합 커밋 | 부모 둘 · `Merge branch 'feature/theirs' into feature/mine` |
|
|
| 5차 C-1 의 23가지 | 사라짐 18 · 정해서 남음 1(머지 주석) · 이번 흐름에서 안 남 3 · 따로 안 봄 1(#12 줄 번호) |
|
|
|
|
---
|
|
|
|
## 공통 규칙
|
|
|
|
- **A → B → C → D 순서로 진행한다.** A 는 사람이 화면을 보고 잘못 판단하게 만드는 것이라 먼저다.
|
|
- **항목 하나를 끝낼 때마다** 빌드하고 실제로 실행해 화면을 확인한 뒤 보고한다.
|
|
- **항목 하나가 끝나면 기록을 세 군데에 남기고 로컬 커밋한다**(4차 D-2 규칙).
|
|
1. **상세**는 `doc/history/YYYY-MM-DD-7차.md` — 원인 · 판단 · 확인한 결과
|
|
2. [../진행상황.md](../진행상황.md) 은 **대기 → 완료로 상태만**
|
|
3. [../history/changelog.md](../history/changelog.md) 에 한 줄 — 날짜 · 무엇을 왜 · 커밋
|
|
- **푸쉬하지 않는다.**
|
|
- **실제 소스를 열지 않는다**(2026-09-11 결정). 시험 재료는 우리가 만들어 쓴다.
|
|
- **확인은 `C1Repo` 로 만든 저장소로 한다.** 씨앗이 고정돼 몇 번을 만들어도 같다.
|
|
고치기 전에 문제가 **다시 나는 것부터 보이고**, 고친 뒤 안 나는 것을 보인다.
|
|
- 기존 검사 하네스 22벌(948건)은 계속 통과해야 한다. 로직을 건드리면 **테스트를 먼저 늘린다.**
|
|
- 빌드 경고 0 · 오류 0 을 유지한다. 앱이 실행 중이면 `UbisamBase.Shell` 을 먼저 종료한다.
|
|
- 사용자 설정 파일(`D:\UbisamConfig\Settings\MergeHubSettings.json`)은 시험 전에 백업하고, 끝나면 **바이트 그대로** 되돌린다.
|
|
- 플랫폼을 고치면 다른 소비 프로그램에 미치는 영향을 함께 적고
|
|
`UbisamPlatform/doc/history/changelog.md` 에 남긴다.
|
|
|
|
---
|
|
|
|
## A. 병합 화면이 사실과 다르게 말하는 것
|
|
|
|
### A-1. 마지막 충돌을 저장하면 "남은 차이" 가 뜬다 (D-1 N2)
|
|
|
|
- 마지막 충돌 파일을 [Save] 하면, **아직 병합 커밋 전인데** 파일 비교 탭이 두 칸(HEAD 내 쪽 ↔ 워킹트리)으로 떨어져
|
|
"남은 차이 3줄 · BASE와 다름 3" 을 보인다(`Weld/Unit1.cs`). 방금 고른 줄이 "차이" 로 세어져 **덜 푼 것처럼** 읽힌다.
|
|
충돌 탭은 같은 때 "충돌 정리 끝 · 푼 것 26개" 라고 한다. 두 화면이 다른 말을 한다.
|
|
- 짚이는 곳: `HomeViewModel.ReloadAfterResolveAsync` 가 남은 충돌이 없으면 `LoadCommitAsync` 로 보통 화면(HEAD 대비)을 연다.
|
|
병합 중이라는 사정을 모른다.
|
|
- 방향: 병합 중이고 충돌이 0 이면 파일 비교 탭도 "**충돌 정리 끝 · 병합 커밋을 할 수 있습니다**" 를 말한다.
|
|
푼 파일을 보여 줄 거라면 무엇과 견준 차이인지(내 쪽 대비 받은 변경) 제목과 요약에 적는다.
|
|
- **판정 기준**: D-1 과 같은 순서로 마지막 충돌을 저장했을 때 파일 비교 탭의 요약 · 상태바가 "남은 차이" 가 아니라
|
|
병합 커밋을 할 수 있다는 말을 한다. 충돌 탭과 말이 같다. 병합 커밋 뒤에는 지금처럼 보통 화면(B-8)으로 돌아간다.
|
|
|
|
### A-2. 3분할에서 줄을 골라도 로그는 "3-Way 안 씀" 이라고 한다 (D-1 N1)
|
|
|
|
- 네 칸에서 Take Theirs 를 누르면 로그가 **"101행 (3-Way 안 씀) 반영"** 이라고 적는다. D-1 로그 11줄이 모두 그랬다.
|
|
결과 파일은 맞다 — 글자만 틀렸다.
|
|
- 짚이는 곳: `HomeViewModel.cs` 의 `"{line.RemoteNumber}행 {RemoteBranch} 반영"` 이 3-Way 콤보 값을 쓴다.
|
|
병합 중 충돌 파일은 콤보를 건드리지 않고 네 칸을 띄우므로(6차 A-3) 콤보는 `(3-Way 안 씀)` 그대로다.
|
|
- 머리의 3-Way 콤보도 같은 때 `(3-Way 안 씀)` 을 보이는지 **고치기 전에 화면으로 확인**하고, 그렇다면 같이 고친다.
|
|
- **판정 기준**: 병합 중 네 칸에서 줄을 고르면 로그가 상대 쪽 이름(예: `feature/theirs`)이나 "Theirs" 로 적는다.
|
|
Take Mine 도 무엇을 골랐는지 적힌다. 네 칸이 떠 있는 동안 화면 어디에도 "3-Way 안 씀" 이 없다.
|
|
충돌이 아닌 파일의 2-Way · 브랜치 3-Way 로그는 지금 그대로다.
|
|
|
|
---
|
|
|
|
## B. 치우기
|
|
|
|
### B-1. 병합 커밋 뒤에도 `.git/MERGEHUB_CONFLICTS` 가 남는다 (D-1 N3)
|
|
|
|
- 병합에서 충돌이 나면 처음 충돌 목록을 `.git/MERGEHUB_CONFLICTS` 에 적는다(6차 C-1, "푼 것 M개 (M/전체)" 용).
|
|
**지우는 곳이 없다.** 병합 커밋 · 작업 취소 뒤에도 남는다.
|
|
- 첫 줄의 MERGE_HEAD 와 대조하므로 다음 병합에 해는 없다. 그래도 남의 `.git` 에 우리 파일을 흘리지 않는다.
|
|
- 짚이는 곳: `GitService.RememberMergeConflicts` 만 있고, 병합 커밋 · `--abort`(작업 취소) 길에 치우는 코드가 없다.
|
|
- **판정 기준**: MergeHub 로 병합 커밋을 하거나 작업 취소를 하면 파일이 없다.
|
|
MergeHub 밖(터미널)에서 병합을 끝낸 경우에는 다음에 저장소를 열 때 MERGE_HEAD 가 없으면 치운다.
|
|
|
|
---
|
|
|
|
## C. 병합 말고 다른 충돌 길 (6차에서 뺀 것)
|
|
|
|
6차는 "병합만 끝까지 믿을 수 있게" 를 목표로 pull · rebase · cherry-pick 을 뺐다. 같은 네 칸을 쓰지만 끝까지 해 본 적이 없다.
|
|
|
|
### C-1. pull 이 낸 충돌에는 머지 주석 자동 풀기가 안 걸린다
|
|
|
|
- `GitService.Pull` 은 안에서 `Merge()` 를 부르므로 처음 충돌 목록은 적힌다.
|
|
하지만 **머지 주석만 다른 충돌을 푸는 `ResolveNoteOnlyConflicts` 는 `GitViewModel.MergeAsync` 에서만 부른다.**
|
|
pull 로 같은 저장소를 받으면 사람에게 26개를 묻게 된다(6차 B-5 가 약속한 것과 다르다).
|
|
- 병합 커밋 메시지 기본값(`Merge branch …`)도 MergeAsync 에만 있다. pull 뒤의 메시지를 확인한다.
|
|
- **판정 기준**: 만든 저장소에서 원격을 흉내 낸 bare 저장소를 두고 pull 했을 때 알림 · 로그 · 충돌 수가 [Merge] 와 같다
|
|
("충돌 24건 (머지 주석만 다른 2건은 자동으로 풀림)"). 병합 커밋 메시지가 원격 브랜치 이름을 담는다.
|
|
|
|
### C-2. rebase · cherry-pick 충돌을 네 칸으로 끝까지
|
|
|
|
- rebase 계속 · cherry-pick 충돌도 파일 비교 탭 네 칸으로 열리는지, **제목(LOCAL · REMOTE 가 무엇인지)** 이 맞는지 본 적이 없다.
|
|
rebase 에서는 "내 쪽" 과 "상대 쪽" 이 병합과 **거꾸로**다(upstream 이 ours). 화면이 그 사정을 말해야 한다.
|
|
- [Save] 뒤 흐름: 병합은 [병합 커밋] 인데 rebase 는 [계속], cherry-pick 은 커밋이다. 충돌 탭 단추와 안내가 작업에 맞는지 본다.
|
|
- 생성기(`C1Repo`)에 rebase · cherry-pick 용 갈래를 더한다(같은 씨앗, 기존 병합 경우는 그대로).
|
|
- **판정 기준**: 만든 저장소에서 rebase 와 cherry-pick 을 각각 MergeHub 만으로 끝까지 간다.
|
|
네 칸 제목이 실제 쪽을 말한다. 끝난 커밋에 **줄끝 · BOM 이 바뀐 파일 0개**, 충돌 표식 0.
|
|
|
|
---
|
|
|
|
## D. 확인
|
|
|
|
### D-1. 세 길을 처음부터 다시 끝까지
|
|
|
|
- A~C 를 고친 뒤 저장소를 새로 만들어 **병합 · pull · rebase · cherry-pick** 을 각각 처음부터 끝까지 한다.
|
|
- 6차 D-1 에서 **따로 안 본 #12(MERGED 칸 줄 번호)** 를 이번에는 네 칸 화면으로 찍어 확인한다(`Motion/Unit0.cs` · `Weld/Unit1.cs` 끝 줄).
|
|
- 6차 D-1 과 **같은 표로** 적는다. 새로 걸린 것은 고치지 말고 적는다 — 그 목록이 8차가 된다.
|
|
- **판정 기준**: 네 길 모두 MergeHub 만으로 커밋(또는 rebase 끝)까지 간다. 줄끝 · BOM 이 바뀐 파일 0개.
|
|
A-1 · A-2 · B-1 이 다시 나지 않는다.
|
|
|
|
---
|
|
|
|
## E. 추가 요청
|
|
|
|
### E-1. [해결로 저장] 이름을 [Save] 로 (2026-09-14, 사용자)
|
|
|
|
- 병합 중에 보이는 그 단추는 LOCAL 칸 내용을 저장하는 단추다. 이름을 **Save** 로 바꾼다(단추 옆 Save & Commit 과 짝).
|
|
- 하는 일은 그대로다 — 이 파일만 쓰고 스테이징, 커밋은 안 함, Ctrl+S.
|
|
- 알림 · 막힘 안내 · 웹 문서의 이름도 같이 바꾼다. 지난 기록(history)은 그때 이름 그대로 둔다.
|
|
- **판정 기준**: 병합 중 단추가 "Save" 이고 "해결로 저장" 은 화면 어디에도 없다. 눌렀을 때 충돌이 하나 줄고 커밋은 안 생긴다.
|
|
|
|
---
|
|
|
|
## 이번 지시서에서 하지 않는 것
|
|
|
|
- **실제 소스로 병합해 보기** — 실제 소스는 열지 않는다(2026-09-11 결정).
|
|
- **머지 주석을 병합에서 끄기** — 6차 B-5 에서 "소스에 넣고 비교 · 병합에서는 무시" 로 정했다. D-1 에서도 그대로 동작했다.
|
|
- 빠른 비교(크기 · 수정일)가 내용만 바뀐 파일을 놓치는 것 — 폴더 비교의 알려진 한계로 둔다.
|
|
- 같은 줄 접기(4차 B-2) · 외부 편집기(4차 B-4) · 로그인·권한 · Gitea PR — 미룬 그대로 둔다.
|
|
|
|
---
|
|
|
|
## 보고 형식
|
|
|
|
항목마다 이렇게 적는다.
|
|
|
|
- 고치기 전에 문제가 **다시 나는 것**을 어떻게 보였는지 (만든 저장소의 어느 파일로)
|
|
- 무엇이 원인이었는지 한두 줄
|
|
- 어떤 파일을 어떻게 고쳤는지
|
|
- 실제로 실행해 확인한 결과 (바이트 · 줄끝 · 충돌 수처럼 **눈이 아닌 값**으로)
|
|
- 커밋 해시
|