[patternflow-bot]

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

사이트의 패턴 런타임과 가이드 시뮬레이터가 패널 크기, 노브 수, 한 바퀴 24 클릭, 버스 최댓값 1000, 길게 누르기와 디바운스 값을 제 파일에 숫자로 적어 두지 않고 PR 7 이 만든 shared/constants.json 에서 읽게 했어요. 머지하면 이 값이 바뀔 때 사이트 쪽 사본을 하나하나 찾아 고칠 일이 없어지고, 화면에 보이는 것은 그대로예요.

좋아지는 것: 없음

할 일

• 계획서 표에서 PR 9 의 범위와 파일 확인 (표의 여섯 파일만 고침)
• 다섯 파일이 @/lib/shared/constants 에서 값을 읽고, 내보내던 이름은 그대로 둠
• panelScreens.ts 가 펌웨어 상수를 줄 번호 말고 이름으로 가리킴
• pattern-sandbox.html 다시 빌드, 바뀐 곳이 상수 자리뿐인 것 확인
• typecheck · lint · check:ci · check:panels · human-lock · voice
• dev merge 뒤 다시 검사
• 이 PR 의 CI(Web CI, Drift checks) success (30f000f, 5086f68, 마지막 head 9f86682)

한 일

• web/src/lib/pattern/harness.ts: PATTERN_MATRIX_WIDTH/HEIGHT 는 기본 패널(PANEL_GEOMETRIES[PANEL_GEOM_DEFAULT])의 resW/resH, PATTERN_KNOB_COUNT 는 KNOB_COUNT, PATTERN_DETENTS_PER_TURN 은 DETENTS_PER_TURN. 없는 파일(patternflowControls.ts)을 가리키던 "Keep in sync" 줄은 controls.ts 가 같은 값을 읽는다는 줄로 바꿈.
• web/src/lib/pattern/controls.ts: ENCODER_CLICKS_PER_TURN 은 DETENTS_PER_TURN, BUS_WIRE_MAX 는 BUS_MAX, TURNS_PER_FULL_RANGE 는 shared 값을 그대로 다시 내보냄. harness.ts 를 더는 import 하지 않음.
• web/src/lib/pattern/matrix.ts: DEFAULT_MATRIX 가 기본 패널 크기에서, MATRIX_HEAVY_PIXELS 는 DEFAULT_MATRIX 에서.
• web/src/lib/guide/panelScreens.ts: PANEL_W/PANEL_H 는 기본 패널 크기, FIRMWARE.longPressMs·buttonDebounceMs·edgesPerDetent 는 LONG_PRESS_MS·BUTTON_DEBOUNCE_MS·EDGES_PER_DETENT. 펌웨어 상수(MODE_HOLD_MS, BRIGHTNESS_IDLE_MS … WAKE_GUARD_MS, DEFAULT_BRIGHTNESS, MODULE_NAME_BYTES, pfLedC 들, PF_UI_PITCH_SELECT)는 이름과 파일로만 가리키고, 그 주석 안의 동작 설명은 줄 대신 함수 이름(Button::longPressed, readInputFrame, loop(), drawKnobMap, savePatternIfSettled …)으로.
• web/src/lib/guide/deviceSim.ts: 자기 BUS_UNITS_PER_CLICK = 10 을 지우고 shared 값을, 0..1000 은 BUS_MAX, 노브 넷은 KNOB_COUNT, 4 edges 는 EDGES_PER_DETENT, 한 바퀴는 DETENTS_PER_TURN.
• web/public/pattern-sandbox.html: npm run build:sandbox 로 다시 빌드.

증거

$ npm run typecheck        → exit 0
$ npm run lint             → exit 0, 경고 0
$ npm run check:panels     → Test Files 35 passed (35), Tests 478 passed (478)
$ npm run check:ci         → exit 0
  pattern-sandbox.html is up to date
  passed bom · bom-schematic · changelog · editions · features · links-absolute · markers · presets · shared
  skipped roadmap (gh 로그인 없는 자리라 건너뜀. CI 는 PF_DRIFT_STRICT=1 로 돈다)
$ npm run check:human-lock → this diff touches 0 locked files / no locked words changed
$ npm run check:voice      → read: 97 added lines in 6 files / nothing found
$ npm run doc-map          (git fetch --tags 뒤, 두 CSV 는 다시 checkout)
  1088 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

dev merge 전과 뒤에 같은 명령을 다 돌렸고 둘 다 위와 같았어요. 두 번째 merge 로 PR 8(#52, 펌웨어가 core_shared.h 를 읽음)이 들어왔는데, panelScreens.ts 가 이름으로 가리키는 MODE_HOLD_MS·Button::longPressed·Button::pressed·knobSubSteps·DEFAULT_BRIGHTNESS·PF_SLEEP_ENABLED·PF_WEBUPDATE_ENABLED 는 그대로 있고 값만 PF_SHARED_* 에서 와요. DEFAULT_BRIGHTNESS 는 config.h 241 행에서 245 행으로 움직였는데, 이제 이름으로 가리키니 따라 고칠 게 없어요.

75d33b1 의 Web CI 빨강은 아래 「가정」의 : number 를 붙이기 전 typecheck 의 같은 일곱 줄이었고 725c53a 에서 고쳤어요. 30f000f 와 5086f68 에선 Web CI build 와 Drift checks 둘 다 success 였어요.

세 번째 merge 로 PR 14(#54, lint·테스트 도구 판 올림, web/package-lock.json 만)가 들어와서 npm ci 를 다시 하고 typecheck, npm run lint -- --max-warnings=0, check:ci(478/478), human-lock, voice, doc-map 을 다시 돌렸고 위와 같았어요. 마지막 head 는 9f86682 이고, 거기서도 Web CI build 와 Drift checks 둘 다 success 였어요.

check:sandbox-sync 가 처음엔 빨갰어요(소스가 바뀌었으니). 다시 빌드한 pattern-sandbox.html 을 원래 판과 ;·{·} 마다 잘라 비교하면 바뀐 곳은 이것뿐이에요. 숫자가 그 숫자를 가진 이름으로 바뀌었고 값은 같아요.

+var PANEL_GEOMETRIES={"128x64_SINGLE":{id:1,physW:128,physH:64,chain:1,resW:128,resH:64},"64x64_SINGLE":{…},"64x64_CHAIN2":{…}}
+,PANEL_GEOM_DEFAULT="128x64_SINGLE",KNOB_COUNT=4,DETENTS_PER_TURN=24;
+var PATTERN_MATRIX_WIDTH=PANEL_GEOMETRIES[PANEL_GEOM_DEFAULT].resW,PATTERN_MATRIX_HEIGHT=…resH,PATTERN_KNOB_COUNT=KNOB_COUNT,PATTERN_DETENTS_PER_TURN=DETENTS_PER_TURN;
-constructor(width=128,height=64){
+constructor(width=PATTERN_MATRIX_WIDTH,height=PATTERN_MATRIX_HEIGHT){
-…delta*(24/unitsPerTurn)}
+…delta*(PATTERN_DETENTS_PER_TURN/unitsPerTurn)}
-width:128,height:64}
+width:PANEL_GEOMETRIES[PANEL_GEOM_DEFAULT].resW,height:PANEL_GEOMETRIES[PANEL_GEOM_DEFAULT].resH}
-var MATRIX_HEAVY_PIXELS=8192*4;
+var MATRIX_HEAVY_PIXELS=DEFAULT_MATRIX.width*DEFAULT_MATRIX.height*4;
-…live.knobValues=msg.knobValues.slice(0,4)…
+…live.knobValues=msg.knobValues.slice(0,PATTERN_KNOB_COUNT)…
-…live.knobValues=msg.values.slice(0,4)…
+…live.knobValues=msg.values.slice(0,PATTERN_KNOB_COUNT)…

17219 바이트에서 17916 바이트로 늘어난 건 패널 표와 상수 이름들이 번들에 들어온 몫이에요.

실행법

web/ 에서 npm ci 뒤 npm run typecheck && npm run lint && npm run check:ci. 샌드박스만 보려면 npm run check:sandbox-sync.

가정

• panelScreens.ts 는 펌웨어 상수만 이름으로 바꿨어요(계획서 k9 그대로). drawNetworkInfo, patternflow.ino:739-852 같은 함수 범위와 Adafruit_GFX·HUB75 줄 번호는 머리 주석이 말하는 대로 v3.10.4 판 줄로 남겼고, 머리 주석에 "Firmware constants are cited by name" 한 문장을 더했어요.
• shared 에 없는 스무 개 타이밍(BRIGHTNESS_IDLE_MS 5000 같은 것)은 숫자로 남겼어요. 질문 23 의 기본값(D7)이 그래요.
• PANEL_GEOMETRIES 가 as const 라 resW 의 타입이 넓어지지 않는 128 이 돼서, 기본 인자로 쓰는 PATTERN_MATRIX_WIDTH/HEIGHT 와 PANEL_W/PANEL_H 에 : number 를 붙였어요. 전엔 = 128 이 넓어지는 리터럴이라 같은 일을 했어요. 런타임 값은 그대로예요.
• deviceSim.ts 의 허용 edges 목록 [1, 2, 4] 와 버스 시작값 500 은 숫자로 뒀어요. 펌웨어 core_bus.h 도 500 을 그대로 써요.
• docs/rest-api.md:382 가 ENCODER_CLICKS_PER_TURN 과 TURNS_PER_FULL_RANGE 를 controls.ts 에 있다고 말해서 두 이름 다 controls.ts 에서 그대로 내보내요.
• npm run doc-map 이 doc-map CSV 에 두 줄을 더하는데, 둘 다 이미 dev 에 있던 docs/investigations/2026-10-panel-geometry.md 몫이라 이 PR 과 상관없어요. 계획서대로 두 CSV 는 다시 checkout 했어요.
• CHANGELOG.md 는 고치지 않았어요. 넣을 줄은 아래에.

Changelog

Web

• The site reads the panel size and the knob numbers from shared/constants.json. harness.ts, controls.ts, matrix.ts, panelScreens.ts and deviceSim.ts in web/src/lib/ take the 128×64 canvas, the four knobs, 24 detents a turn, the bus maximum of 1000, the long press, the debounce and the edges in a detent from web/src/lib/shared/constants.ts, and keep every name they export. The guide's panel screens cite firmware constants by name instead of by line number, which had drifted. Nothing a page shows changes, and the rebuilt sandbox differs only where a literal became its constant's name.

Upstream

• What: harness.ts, controls.ts, matrix.ts, panelScreens.ts and deviceSim.ts in web/src/lib take the panel size, knob count, detents a turn, bus maximum and encoder timings from web/src/lib/shared/constants.ts and keep every exported name. panelScreens.ts cites firmware constants by name.
• Checks: npm run typecheck, npm run lint, npm run check:ci (with check:sandbox-sync and check:shared), npm run check:panels and npm run check:human-lock pass. The rebuilt sandbox differs only where a literal became its constant's name.
• Docs map: none

🤖 Generated with Claude Code

https://claude.ai/code/session_017qFibswRLZuop4M5gmR2gb