[DONE] 정리 마지막 기록(포크 #93)이 원래 레포 dev 위에 커밋 하나로 다시 얹혀, hub 가 거기서 다시 멈추지 않는다

[patternflow-bot]

lsh / https://claude.ai/code/session_01DpjXsYZbwT5PpwzpNCEEqq

hub upstream 이 멈춘 포크 PR #93 을 원래 레포 dev 위에 커밋 하나로 다시 얹었어요. 진행 기록과 정리 RFC 는 hub 묶음이 포크 판으로 싣는 기록이라 빼고, 문서 지도 여섯 줄과 #93 을 가리키는 From 줄만 담았어요. 포크 main 도 merge 해서 충돌을 풀었고 트리는 그대로예요. CI 는 human-lock 하나만 빨간데, 포크 main 과 비교할 때만 그렇고 원래 레포 dev 와 비교하면 통과해요.

좋아지는 것: 없음

할 일

• [DONE] 정리 진행 기록이 1~5단계와 게이트 여섯을 다 적고, 정리 RFC 가 Done 이 된다 #93 이 고친 파일 찾기: docs/investigations/2026-10-doc-map.csv · docs/rfc-cleanup-progress.md · docs/rfc-cleanup.md
• 기대는 앞 포크 PR 찾기: 없음. 원래 레포 dev 의 세 파일이 포크 9dff573([DONE] 정리 4단계를 닫는다 — 「done when」 둘이 맞고, 링크 1138개가 다 닿는 지도를 커밋한다 #92 머지) 판과 바이트까지 같고, b6c1fae 커밋 글이 [DONE] 정리를 시작하기 전 레포의 출발점(시험 결과·문서 지도)을 기록해 둔다 #11~[DONE] 정리 4단계를 닫는다 — 「done when」 둘이 맞고, 링크 1138개가 다 닿는 지도를 커밋한다 #92 를 다 적는다
• 원래 레포 dev 3b6e014 위에 얹기: CSV 만 2f094fe 판 그대로, 기록 둘은 안 실음
• 검사: 링크 · human-lock · voice · drift
• 포크 main 을 merge 해서 충돌 풀기(이어서 받은 지시): 8566dc6, 트리는 fad02d5 와 같음
• 이 head 의 CI: 열 job 중 아홉 초록, Drift checks 의 human-lock 하나 빨강(아래, 다시 돌려도 같음)
• [DONE] 직전 원래 레포 dev · 포크 main fetch·merge: 3b6e014 · 60d9f21 그대로, 둘 다 Already up to date.

한 일

• 브랜치를 원래 레포 dev 3b6e014 에서 다시 시작했다. 세션이 준 이름의 원격 브랜치는 이미 지워져 있어서 보통 push 로 올렸다.
• fad02d5 docs: the doc map lists the six links the cleanup's closing entry adds: docs/investigations/2026-10-doc-map.csv 를 2f094fe 판으로, +6 줄. 커밋 글에 From Patternflow-lab/Patternflow#93 (2f094fe). 한 줄.
• 안 실은 것: docs/rfc-cleanup-progress.md(+263 −7)와 docs/rfc-cleanup.md(+3 −2). 정리 진행 기록과 계획서라 hub 묶음 몫이다. CHANGELOG.md 도 안 고쳤다. [DONE] 정리 진행 기록이 1~5단계와 게이트 여섯을 다 적고, 정리 RFC 가 Done 이 된다 #93 의 줄은 아래 ## Changelog 에 있다.
• 8566dc6 포크 main(60d9f21) merge. 충돌 12파일(.github/SECURITY.md .github/SUPPORT.md AGENTS.md CHANGELOG.md README.md docs/AUDIO_GUIDE.md docs/README.md docs/REPOSITORY.md hardware/README.md web/README.md web/next.config.ts web/src/lib/guide/deviceSim.test.ts)은 다 원래 레포 dev 쪽을 뒀다. 포크 main 의 트리가 c894a5f([DONE] 웹 가이드 펌웨어 굽기·와이파이를 BOOT+RST 기본으로 고치고, 메인 README·문서를 정리한다 #7~[DONE] BUILD_GUIDE 굽기 순서를 웹 가이드와 맞추고, README 의 Crowd Supply 캠페인을 「진행 중, 10월 15일 마감」으로 바로잡는다 #9 를 원래 레포에 올린 커밋 셋의 끝, 원래 레포 dev 의 조상)와 같아서, 충돌한 줄마다 그 뒤 dev 가 더 고친 판이 맞다. 예: web/next.config.ts 는 dev 가 정리 3단계에서 옛 ?lang=en 주소 설명 주석을 더한 자리다. 저절로 merge 된 파일은 다 dev 판 그대로 나왔다.
• human-lock 실패를 PR 댓글로 적고 실패 job 을 한 번 다시 돌렸다. 검사 고침은 이 브랜치에 넣지 않았다.

증거

$ git diff --stat refs/upstream/dev 9dff573 -- docs/investigations/2026-10-doc-map.csv docs/rfc-cleanup-progress.md docs/rfc-cleanup.md
(출력 없음: 원래 레포 dev 판 = 포크 9dff573 판)
$ cmp <(git show 2f094fe:docs/investigations/2026-10-doc-map.csv) docs/investigations/2026-10-doc-map.csv && echo identical-to-2f094fe
identical-to-2f094fe
$ git diff --stat 3b6e014 HEAD
 docs/investigations/2026-10-doc-map.csv | 6 ++++++

포크 main merge:

$ git diff --stat origin/main c894a5f7          # 출력 없음: 포크 main 트리 = c894a5f
$ git merge-base --is-ancestor c894a5f7 HEAD && echo in-upstream-dev
in-upstream-dev
$ git merge origin/main                          # CONFLICT 12 files
$ git diff --name-only HEAD                      # 충돌 12파일 말고 dev 와 다른 파일 없음
$ git checkout --ours -- <12 files> && git add <12 files>
diff vs pre-merge HEAD: 0 lines
$ git log --format='%h %p' -1                    # 8566dc6 fad02d5 60d9f21

지도를 다시 만들어 맞대 봄(커밋 안 함). 2f094fe 의 기록 둘을 이 트리에 얹고 npm run doc-map 하면 두 기록에서 나가는 줄 14개가 커밋한 CSV 의 14줄과 같다:

14 regen.txt / 14 committed.txt
rows from the two records: identical

기록 없이 이 트리 그대로 만들면 그 여섯 줄이 빠진다. 기록이 들어오기 전엔 그게 맞다.

검사(컨테이너, Node 22.22.0, npm ci 뒤, 원래 레포 태그 28개 fetch). merge 뒤 8566dc6 에서 링크와 drift 를 다시 돌렸다:

$ python3 .github/scripts/check_links.py
all 737 relative links resolve
$ PF_LOCK_BASE=3b6e014 npm run check:human-lock
this diff touches 0 locked files
check:human-lock: no locked words changed
$ PF_LOCK_BASE=3b6e014 npm run check:voice
read: 0 added lines in 0 files
check:voice: nothing found
$ (커밋 글) | npm run check:voice -- -
read: 9 lines in 1 file
check:voice: nothing found
$ npm run check:drift          # 30 s
passed   audio-vectors bom bom-schematic changelog editions features links-absolute markers
passed   midi-vectors mqtt-vectors osc-vectors presets rest-vectors shared virtual-panel
skipped  roadmap               # gh 로그인이 없다

8566dc6 의 CI:

• 초록: Firmware builds default · audio · performance · clock · midi, Web CI, Docs point at files that exist, Core knows no features, Console pages in sync.
• 빨강: Drift checks. check:drift 단계(strict)는 지나고 다음 단계 check:human-lock 에서 멈춘다. 다시 돌려도 같다.

base: 60d9f21 (PF_LOCK_BASE)
changed  docs/releases/v3.0.0.md
changed  docs/releases/v3.1.0.md
check:human-lock: 2 locked texts changed

까닭은 이 댓글에 적었다. base 인 포크 main 이 정리 전 판이라, 1단계 067b400b 가 두 릴리스의 긴 글을 -notes.md 로 그대로 옮기고 옛 자리에 CHANGELOG 절을 둔 것이 diff 에 든다. 옮긴 글은 바이트까지 같다. human-lock.ts 는 옛 경로가 남아 있으면 옮겨 간 곳을 찾지 않는다. 컨테이너에서 PF_LOCK_BASE=60d9f21 로 같은 실패를 냈고, 댓글의 고침을 얹으면 moved … word for word 둘에 통과하고 진짜 낱말 고침은 여전히 잡는 것까지 봤다(되돌림).

실행법

git fetch https://github.com/engmung/Patternflow dev
git diff --stat FETCH_HEAD origin/claude/patternflow-upstream-cleanup-4y44wq   # CSV 6줄만
git log --format=%B fad02d5 -1 | grep '^From'
cd web && npm ci && npm run check:drift
PF_LOCK_BASE=60d9f21 npm run check:human-lock   # 이 PR 의 CI 와 같은 실패
PF_LOCK_BASE=3b6e014 npm run check:human-lock   # 원래 레포 dev 기준이면 통과

가정

• 정리 다시 짜기 규칙대로 진행 기록과 정리 RFC 를 싣지 않아서 [DONE] 정리 진행 기록이 1~5단계와 게이트 여섯을 다 적고, 정리 RFC 가 Done 이 된다 #93 에서 남는 건 CSV 하나다. 이 브랜치만 먼저 원래 레포에 들어가면 지도가 트리보다 여섯 줄 앞서고, hub 묶음이 두 기록을 포크 판으로 실으면 맞는다. 지도를 트리와 맞대는 CI 검사는 없다(web/scripts/doc-map.ts 는 CSV 를 쓰기만 한다).
• 겹침은 트리에서 보이지 않았다. [DONE] 정리 진행 기록이 1~5단계와 게이트 여섯을 다 적고, 정리 RFC 가 Done 이 된다 #93 의 diff 는 원래 레포 dev 에 그대로 붙는다. 3b6e014(big cleanup)는 트리가 b6c1fae 와 같은 merge 라, hub 가 그 merge 를 사람 고침으로 읽고 멈췄을 수 있다. From 줄이 있으면 hub 가 [DONE] 정리 진행 기록이 1~5단계와 게이트 여섯을 다 적고, 정리 RFC 가 Done 이 된다 #93 을 다시 얹지 않으니 어느 쪽이든 풀린다.
• 포크 main merge 는 이어서 받은 지시대로 했다. 머리말은 원래 레포로 보낼 브랜치에 포크 main 을 merge 하지 말라고 하는데, 지시가 뒤에 왔고 트리가 바뀌지 않아 따랐다. 그 대신 이 브랜치 히스토리에 merge 커밋 8566dc6 과 포크 main 의 한국어 커밋 60d9f21, 빈 시작 커밋 216cac7 이 섞였다. 원래 레포 PR 은 fad02d5 하나를 원래 레포 dev 에 cherry-pick 하거나 squash 하면 트리가 같고 From 줄도 남는다.
• human-lock 빨강을 [DONE] 으로 둔 까닭: 이 브랜치가 갈 곳은 원래 레포 dev 고 거기 기준으론 통과한다. 빨강은 PR base 가 포크 main 이라서 생기는 것이고, 고치려면 human-lock.ts 를 바꿔야 해서 [DONE] 정리 진행 기록이 1~5단계와 게이트 여섯을 다 적고, 정리 RFC 가 Done 이 된다 #93 몫만 싣는 이 브랜치에 넣지 않았다. 고칠지는 총괄이나 창작자가 정한다(고침은 댓글에).
• 원래 레포 dev 의 CHANGELOG.md 는 릴리스 절 31개를 다 가진 판이다(포크는 1단계에서 넷만 남기고 docs/releases/ 로 나눴다). 그래서 원래 레포 트리에서 지도를 다시 만들면 CHANGELOG.md 에서 나가는 줄이 수십 개 바뀐다. 저널 fine 글도 원래 레포에만 있다. [DONE] 정리 진행 기록이 1~5단계와 게이트 여섯을 다 적고, 정리 RFC 가 Done 이 된다 #93 과 상관없어서 건드리지 않았다.
• PR 은 포크 main 으로 냈다(정리 다시 짜기는 main 만 반대). 원래 레포 PR 은 열지 않았다.

Changelog

Docs

• The cleanup's progress log records steps 1 to 5 and the gate. docs/rfc-cleanup-progress.md has an entry for each step and checks the six items of §2.12 at 9dff573, and all six hold. docs/rfc-cleanup.md is marked done.

🤖 Generated with Claude Code

https://claude.ai/code/session_01DpjXsYZbwT5PpwzpNCEEqq

[patternflow-bot]

Drift checks 의 check:human-lock 이 8566dc6 에서 빨갛다(run 38869556133). 다른 아홉 job(펌웨어 다섯 · web · docs-links 등)은 초록이다.

base: 60d9f21 (PF_LOCK_BASE)
changed  docs/releases/v3.0.0.md
changed  docs/releases/v3.1.0.md
check:human-lock: 2 locked texts changed

이 PR 의 고침(fad02d5, CSV 6줄) 때문은 아니다. 이 PR 의 base 인 포크 main 60d9f21 은 원래 레포 main 에 #7~#9 만 얹은 판이라, base 와의 diff 에 원래 레포 dev 의 정리 전체가 들어간다. 그중 1단계 067b400b 가 v3.0.0.md·v3.1.0.md 의 긴 글을 v3.0.0-notes.md·v3.1.0-notes.md 로 옮기고 옛 자리에 CHANGELOG 절을 두었다. 옮긴 글은 바이트까지 같다(diff <(git show 60d9f21:docs/releases/v3.0.0.md) docs/releases/v3.0.0-notes.md 출력 없음, v3.1.0 도). human-lock.ts 는 옛 경로가 남아 있으면 그 글이 다른 파일로 옮겨 갔는지 보지 않고 changed 로 센다. 원래 레포 dev(3b6e014)를 base 로 하면 this diff touches 0 locked files 로 통과한다. 컨테이너에서 PF_LOCK_BASE=60d9f21 로 같은 실패를 냈다.

이 브랜치는 원래 레포로 가는 #93 몫만 싣는 거라 검사 고침은 넣지 않았다. 고친다면 이 정도다. 컨테이너에서 base 60d9f21 로 moved … word for word 둘에 통과하고, v3.0.0-notes.md 의 낱말 하나를 바꾸면 다시 1 locked text changed 로 빨개지는 것까지 봤다:

-function whereIs(text: string): string | null {
+function whereIs(text: string, not?: string): string | null {
 ...
-  return corpus.find((c) => c.text.includes(text))?.file ?? null;
+  return corpus.find((c) => c.file !== not && c.text.includes(text))?.file ?? null;
 }
 ...
     if (b ? a.plain.text === b.plain.text : !a.plain.text) same++;
-    else if (b) {
+    else if (b && whereIs(a.plain.text, c.path)) {
+      console.log(`moved    ${key} → ${whereIs(a.plain.text, c.path)}, word for word`);
+      moved++;
+    } else if (b) {

고치지 않으면 이 PR 의 base 가 포크 main 인 동안 이 검사는 계속 빨갛다. 실패한 job 은 한 번 다시 돌린다.

---

Generated by Claude Code