[patternflow-bot]

dev / https://claude.ai/code/session_01N6mLK559tyhVYe4Z9s6Y9Q

3단계 PR 1~26 이 모두 dev 에 머지돼서, 계획서 k27 대로 문서 지도를 다시 만들고 §2.5 의 「done when」 넷(lint·typecheck 0, 옛 경로마다 까닭, UPSTREAM.md 와 패치, CI 의 check:shared)이 다 맞는 것을 확인했다. 머지하면 링크 1095개가 모두 닿는 지도가 커밋되고, 3단계에는 진행 기록에 적는 일(글은 아래)과 원래 라이브러리 고침 여덟 개(PR 12 줄, 하나마다 창작자가 패널에 구워 본다)가 남는다.

좋아지는 것: 없음

할 일

• 계획서 표의 PR 27 확인: 2026-10-doc-map.csv·2026-10-doc-parity.csv (docs/rfc-cleanup-progress.md 는 작업 글대로 안 고침)
• 조건 확인: k1k26 이 dev 에 머지됨([DONE] 정리 3단계 PR 1 — 사이트 lint 경고 열둘 중 다섯(안 쓰는 이름 넷·훅 의존성 하나)이 사라진다 #38·[DONE] 정리 3단계 PR 2 — 사이트 lint 경고 열둘 중 일곱(img 태그)이 까닭을 적은 예외가 되어 사라진다 #39·[DONE] 정리 3단계 PR 4 — Pattern Lab 의 7월 저장 키 셋이 누가 언제 썼는지 주석으로 말한다 #41[DONE] 정리 3단계 PR 13 — 펌웨어·사이트 코드에 TODO·FIXME 가 새로 들어오면 CI 가 빨개진다 #49·[DONE] 정리 3단계 PR 8 — 펌웨어가 사이트와 같이 쓰는 값을 한 파일에서 읽는다 #52~[DONE] 정리 3단계 PR 14 — 사이트의 lint·테스트 도구가 지금 메이저 안의 새 판으로 올라간다 #54·[DONE] 정리 3단계 PR 15 — 커뮤니티 DB 도구 Drizzle 이 지금 메이저 안의 새 판으로 올라간다 #56~[DONE] 정리 3단계 PR 24 — 사이트 틀 Next 가 지금 메이저 안의 새 판으로 올라가 보안 권고 아홉 개가 닫힌다 #67). k12 는 아홉 중 하나([DONE] 정리 3단계 PR 12 — 패널 드라이버가 원래 라이브러리의 첫 고침을 받아 줄 디코더 값이 늘 정해진다 #48)만, 아래 「가정」
• 두 CSV 다시 만들기 (git fetch --tags 뒤 npm run doc-map 두 번, 바이트 같음)
• §2.5 「done when」 넷 확인
• 앞 PR 들이 k27 에 넘긴 것 찾기: [DONE] 정리 3단계 PR 12 — 패널 드라이버가 원래 라이브러리의 첫 고침을 받아 줄 디코더 값이 늘 정해진다 #48 의 두 줄은 [DONE] 정리 5단계 PR 4 — 두 설계 초안이 서로 이어지고 docs 목록에 올라 5단계를 닫는다 #55 가 이미 실었고, [DONE] 정리 3단계 PR 26 — 레포 지도 문서 셋이 shared/·패널 드라이버 패치·랩 저장 키를 지금 모습대로 가리킨다 #59 의 세 줄이 이 PR 의 세 줄이다
• 진행 기록에 넣을 글 (아래 「진행 기록, 머지하는 사람에게」, check:voice 통과)
• [DONE] 직전 dev fetch: c723fd4 그대로, 뒤처진 커밋 0 이라 merge 할 것 없음

한 일

dev 에 마지막으로 커밋된 지도(#55, 1092행)에 그 뒤 쌓인 3행을 싣는다. 셋 다 PR 26(#59)이 더한 링크이고 다 닿는다. no 는 0행이다.

• docs/REPOSITORY.md → shared/constants.json
• firmware/README.md → firmware/patternflow/src/hub75/UPSTREAM.md
• firmware/README.md → firmware/patternflow/src/hub75/VENDORED.md

짝 목록은 다시 만들어도 한 바이트도 안 바뀐다(1366쌍).

증거

$ git fetch --tags                       # 28 tags
$ cd web && npm ci && npm run doc-map
1095 links from 217 files → docs/investigations/2026-10-doc-map.csv
0 do not resolve
1366 Korean/English pairs → docs/investigations/2026-10-doc-parity.csv
7 en-short, 18 ko-short, 1 missing-ko, 1340 ok
$ npm run doc-map; cmp (앞 결과)          # second run byte-identical
$ git diff --stat origin/dev
 docs/investigations/2026-10-doc-map.csv | 3 +++

$ npm run typecheck                       # exit 0, 출력 없음
$ npm run lint -- --max-warnings=0        # exit 0, 출력 없음 (0단계 기록의 경고 12개 → 0)
$ npm run check:ci                        # exit 0, 26개
 Test Files  35 passed (35)
      Tests  478 passed (478)
passed bom · bom-schematic · changelog · editions · features · links-absolute · markers · presets · shared
skipped  roadmap                          # 이 세션은 engmung/Patternflow 를 못 읽는다. CI 는 아래
$ npm run check:human-lock                # this diff touches 0 locked files
$ npm run check:voice                     # nothing found
$ npm run check:voice -- (아래 진행 기록 글)  # read: 41 lines in 1 file / nothing found
$ python3 .github/scripts/check_links.py  # all 709 relative links resolve

head 140c031 의 CI: Drift checks success (run 38734640534, PF_DRIFT_STRICT: 1), Docs point at files that exist success. Drift 로그 끝:

passed   bom
passed   bom-schematic
passed   changelog
passed   editions
passed   features
passed   links-absolute
passed   markers
passed   presets
passed   roadmap
passed   shared
base: c723fd4 (PF_LOCK_BASE)
check:human-lock: no locked words changed

§2.5 「done when」.

1. lint 과 typecheck 가 깨끗하다. 위 두 명령이 0 이고, web-ci.yml 46줄이 --max-warnings=0 으로 돈다(PR 3). 맞다.
2. 옛 경로마다 까닭이 있다. 계획서 발견 4~6 이 꼽은 자리를 다시 읽었다. legacyDraft.ts 머리(e19fe19 25 July · 9be6e98 27 July), next.config.ts 의 /variants·/flash·?lang=en 둘, business/page.tsx(bbb6a21 12 May), deck.ts 의 pf-module-cart·pf-saved, zipDownload.ts 의 duplicate-name(e261978), builds/route.ts 의 "bin" 410(c5e0907 · 4c13474 · d7cd193), FeedControls.tsx 의 옛 북마크 매개변수(e146de6 · 5e5d50c · c4a57f1). 모두 쓴 것이나 가리키는 것과 날짜를 말한다. saveDraft 는 읽는 곳이 없어 빠졌다(web/src 에 0). 계획서 밖의 components/guide/legacy.ts 도 「Until October 2026 the Play guide was /guide itself」로 까닭을 말한다. 맞다.
3. UPSTREAM.md 와 패치가 있다. 그 파일의 두 명령을 글자 그대로(원래 레포를 새로 clone) 돌렸다.

rebuild: identical to the committed patch
patching file ESP32-HUB75-MatrixPanel-I2S-DMA.cpp
patching file ESP32-HUB75-MatrixPanel-I2S-DMA.h
diff -r exit 0
15 hunks
3b251e58a429f23385e977bc1d9475bde2b995559b2a09825812cfedb3201038  patternflow.patch   # PR 11·12 가 적은 값

4. check:shared 가 CI 에 있다. drift.ts shared 가 web/scripts/drift/ 에 있어 check:ci 끝의 check:drift(web-ci.yml 63줄)와 drift.yml 60줄에서 돈다. 위 CI 로그에 passed shared. 맞다.

펌웨어 쪽 가드도 dev 그대로 통과한다: check_boundaries.py (74 core files know none of 42 feature namespaces), check_presets.py, check_versions.py (core v3.11.0, audio v0.7.0, performance v0.4.0), console_pages.py check.

실행법

git fetch --tags && (cd web && npm ci && npm run doc-map) && git diff --stat
cd web && PF_DRIFT_STRICT=1 GH_TOKEN=… npm run check:drift

패치 확인은 firmware/patternflow/src/hub75/UPSTREAM.md 「Rebuilding the patch」의 두 명령을 저장소 맨 위에서.

가정

• 작업 글대로 표의 PR 27 파일 중 docs/rfc-cleanup-progress.md 는 고치지 않았다. 계획서 k27 은 거기에 3단계를 적으라고 하지만, 1단계 C3([DONE] 정리 1단계를 닫는다 — docs 안내 두 장이 옮긴 자리와 맞고, 링크 1066개가 다 닿는 지도를 커밋한다 #23)·2단계 k13([DONE] 정리 2단계를 닫는다 — 드리프트 검사 여덟 개가 CI 에서 다 통과하고, 링크 1072개가 다 닿는 지도를 커밋한다 #37)과 같이 넣을 글을 아래에 붙여 쓸 수 있게 두었다. 진행 기록엔 1·2·5단계 글도 아직 없어서, 머리 줄은 그 셋이 먼저 들어간 뒤의 꼴로 썼다.
• k12 는 끝나지 않았다. 계획서는 k27 을 「every other k」 뒤에 두는데, PR 11([DONE] 정리 3단계 PR 11 — 패널 드라이버가 원래 라이브러리와 다른 줄이 패치 한 장에 다 적힌다 #47)이 꼽은 원래 라이브러리 커밋 아홉 중 7bf3b6c 하나([DONE] 정리 3단계 PR 12 — 패널 드라이버가 원래 라이브러리의 첫 고침을 받아 줄 디코더 값이 늘 정해진다 #48)만 들어왔다. 남은 여덟(c09362a 538cb41 3ab92ad b40a838 203502b a15a887 6a49f09 c005c7b)은 하나마다 창작자가 기준 패널에 구워 봐야 해서 일꾼이 끝낼 수 없다. §2.5 의 「done when」은 그 여덟을 묻지 않으므로 3단계를 지금 닫고, 진행 기록 글에 여덟이 이어진다고 적었다. 그 여덟은 UPSTREAM.md·패치·드라이버 파일만 고쳐 지도를 바꾸지 않는다.
• [DONE] 정리 3단계 PR 12 — 패널 드라이버가 원래 라이브러리의 첫 고침을 받아 줄 디코더 값이 늘 정해진다 #48 의 「기준 패널에 구워 보고 한 줄」 칸이 아직 비어 있다(PR 댓글도 없다). 진행 기록 글에 7bf3b6c 도 구워 보기를 기다린다고 적었다.
• 이 PR 은 docs/ 만 고쳐 web-ci.yml·firmware-build.yml 이 돌지 않는다. check:ci·typecheck·lint 는 이 브랜치에서 손으로 돌렸고, 펌웨어를 안 건드려 build.sh all 은 해당이 없다.
• 300줄(§2.1): CSV 3줄, 생성물이다.
• 라벨 cleanup·step-3(D9)는 포크에 없어 달지 않았다(앞 PR 들과 같다).

Changelog

Docs

• The doc map is regenerated at the close of step 3 of the cleanup. All 1095 of its links resolve. The three new rows are links step 3 added to docs/REPOSITORY.md and firmware/README.md.

Upstream

• What: regenerate docs/investigations/2026-10-doc-map.csv at the close of cleanup step 3. The parity CSV comes out byte-identical, and no other file changes.
• Checks: npm run check:ci (26 suites), npm run typecheck, npm run lint -- --max-warnings=0, npm run check:human-lock, python3 .github/scripts/check_links.py; in drift.yml, npm run check:drift passes all ten checks strict, roadmap included.
• Docs map: three rows added, all resolving: docs/REPOSITORY.md to shared/constants.json, and firmware/README.md to UPSTREAM.md and VENDORED.md in firmware/patternflow/src/hub75/.

진행 기록, 머지하는 사람에게

docs/rfc-cleanup-progress.md 에 1·2·5단계 글(#23·#37 「for another …」, #55)이 먼저 들어간 뒤에 0단계와 같은 꼴로. 머리 줄과 표 3행 state, 그리고 절이다. 4단계는 계획서(#21)만 있고 PR 이 아직 없어서 다음이 4단계다. any-resolution 문턱(§2.12)은 4단계가 남아 그대로 「not met」.

**Where it stands: steps 0, 1, 2, 3 and 5 done, step 4 next.** Baseline SHA `8226f7e`.

| 3 | Code hygiene: … (그대로) | done ([#38](https://github.com/Patternflow-lab/Patternflow/pull/38)–[#68](https://github.com/Patternflow-lab/Patternflow/pull/68)) |

## Step 3 — code hygiene

Twenty-seven PRs, 15 October 2026:
[#38](https://github.com/Patternflow-lab/Patternflow/pull/38) to
[#67](https://github.com/Patternflow-lab/Patternflow/pull/67) as cut by
[investigations/2026-10-cleanup-step3-plan.md](investigations/2026-10-cleanup-step3-plan.md),
and [#68](https://github.com/Patternflow-lab/Patternflow/pull/68) to close it.
Four in that range are step 5's: #40, #50, #51 and #55.

`npm run lint` went from the baseline's 12 warnings to none. Five were fixed
in the code. The seven `<img>` tags each carry a one-line exception with its
reason, and `web-ci.yml` fails a pull request on a single warning.
`typecheck` was clean and stayed clean.

Every legacy path the plan found now says what wrote it or what links to it,
with the date and the commit. Code with no reader went, `saveDraft` among it.
The rest stays until questions 18 and 19 are answered.

`src/hub75/UPSTREAM.md` names upstream's tag 3.0.13 and its commit `a622186`,
and `patternflow.patch` is every line Patternflow changed, in 15 hunks. Nine
upstream commits after the tag touch none of them. One is in: `7bf3b6c`, which
sets `line_decoder` in the config constructor. The other eight follow one PR
each. Each needs a flash-and-look on the reference panel, and `7bf3b6c` is
still waiting for its own.

`shared/constants.json` holds the values §2.5 named, the 24 detents a turn
among them. `npm run gen:shared` writes `core_shared.h` and `constants.ts`
from it, and the firmware and the site read those. `check:shared` runs in
`check:ci` and in `drift.yml`. The MIDI page counted 20 detents a turn, and
counts 24 now.

Each web dependency family is on its newest release inside its major. Next
went from 16.3.0 to 16.4.1, which closed nine security advisories, and React
from 19.2.4 to 19.3.1. Majors wait (answer 4). The `markers` drift check holds
first-party code at no `TODO` or `FIXME`.

At [#68](https://github.com/Patternflow-lab/Patternflow/pull/68) `check:ci`
passes its 26 suites, `check:panels` its 478 tests, and lint and typecheck
are clean. The doc map has 1095 links out of 217 files, every one resolving.
The parity list is unchanged at 1366 pairs.

🤖 Generated with Claude Code

https://claude.ai/code/session_01N6mLK559tyhVYe4Z9s6Y9Q