[patternflow-bot]

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

정리 5단계 계획서의 PR 2 로, 패널 크기를 펌웨어를 다시 굽지 않고 콘솔 페이지에서 고르는 길을 RFC 초안 한 장(Part 2 만)으로 썼어요. 크기가 박힌 36곳의 갈 곳, 128×64 와 같은 메모리 안이라는 한계, PR 19개 순서와 여섯 질문이 들어 있고, 머지해도 코드는 그대로예요. Part 1 은 비워 뒀어요.

좋아지는 것: 없음

할 일

• 계획서 표의 PR 2 줄 읽기: 고칠 파일은 docs/rfc-any-resolution.md 하나
• rfc-cleanup.md 의 틀(D1): 제목, 날짜 줄, Draft 상태, Part 1·2 문단 그대로, 빈 # Part 1 — Why, 번호 붙은 Part 2, 마지막 절은 열린 질문
• §2.7 이 요구한 것: 36곳 목록, 런타임 구조체와 컴파일 기본값, 캐시 키에 W×H, 콘솔 페이지, 사이트, 가상 패널, 한계
• 제안 절마다 끝에 고칠 파일·PR 수·영역(core·ABI·feature·site)(D5)
• 300줄 미만: 298줄
• 인용한 줄 번호를 지금 dev 에서 다시 확인
• 다른 초안(docs/rfc-linux-player.md)은 백틱으로 한 줄에만(k4 가 링크로 바꿈)
• check_links.py, doc-map(CSV 되돌림), check:voice, check:human-lock
• 기준 브랜치 dev(adbe923) merge

한 일

docs/rfc-any-resolution.md 를 새로 만들었어요. 절은 계획서 k2 순서 그대로예요: 바뀌는 것과 그대로인 것, 크기가 사는 곳(36곳 표), 런타임 geometry(NVS pf_panel, 부팅 때 initDisplay() 전에 읽음), 모듈(크기마다 빌드, 캐시 키, 다른 크기 모듈이 보이는 화면), 콘솔 페이지(core, 다음 부팅에 적용, 돌아가는 길 셋), 사이트, 가상 패널, 한계, 작업 순서, 열린 질문.

계획서에 없던 것 중 초안에 넣은 사실:

• begin() 이 실패하면 기기가 Wi-Fi 전에 while (1) 로 멈춰요(core_display.h:71-74). 그래서 저장한 geometry 가 메모리에 안 맞으면 콘솔로 돌아갈 길이 없어요. 초안은 pf_panel 을 지우고 다시 켜는 쪽을 제안해요.
• Origin 과 보정 카드만 펌웨어에 들어가고, 나머지 33개 프리셋은 basics.zip 안의 128×64 모듈이에요. 크기를 바꾸면 Origin 말고 전부 PATTERN FAILED 가 떠요. 그래서 크기마다 Basics 팩이 필요해요(질문 4).
• 메뉴와 정보 화면은 64×128 세로 화면 기준이라, 64 폭 패널에서는 글줄이 겹쳐요(patternflow.ino:924-945, 산수).
• builder_rev 는 core_module_loader.h 를 통째로 해시해요(builderRev.ts:44). 그래서 그 파일을 고치는 core PR 마다 캐시가 한 번씩 다시 구워져요.

증거

$ python3 .github/scripts/check_links.py
all 689 relative links resolve

$ git fetch --tags && (cd web && npm run doc-map)
1078 links from 216 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
# 새 행 4개(이 초안 → 계획서 2개 앵커 포함, 모두 resolves=yes). CSV 둘은 git checkout 으로 되돌림.

$ cd web && npm run check:voice
base: a800fd3 (the merge-base with origin/dev)
read: 297 added lines in 1 file
check:voice: nothing found
# dev merge 뒤 파일 통째로(-- ../docs/rfc-any-resolution.md)도: nothing found

$ cd web && npm run check:human-lock
locked: 74 journal files, 33 release files, docs/manifesto.md, 3 README sections, Part 1 of 3 RFCs, 166 roadmap strings, 0 paths in docs/.human-written
this diff touches 1 locked file
new      docs/rfc-any-resolution.md
check:human-lock: no locked words changed

$ wc -l docs/rfc-any-resolution.md
298 docs/rfc-any-resolution.md

docs/ 만 고쳐서 §2.1(1) 명령(빌드·check:ci 등)은 해당이 없어요(계획서 「The PRs in detail」).

실행법

docs/rfc-any-resolution.md 를 GitHub 에서 열어 읽으면 돼요. 검사를 다시 돌리려면 위 증거의 명령을 리포 루트(check_links.py)와 web/(나머지)에서 실행해요. doc-map 뒤에는 CSV 둘을 git checkout 으로 되돌려요.

가정

• 표가 PR 2 에 적은 파일 하나만 고쳤어요. CHANGELOG.md·docs/rfc-cleanup-progress.md·docs/README.md·doc-map CSV 는 안 고쳤어요(CSV·README 는 k4 몫).
• 사실의 기준(D3): PR 을 열 때 dev 는 a800fd3 였는데, 쓰는 사이 정리 3단계 k7([DONE] 정리 3단계 PR 7 — 펌웨어와 사이트가 같이 쓰는 값이 한 파일에 모이고, 낡으면 CI 가 빨개진다 #45)이 머지돼 shared/constants.json 이 생겼어요. 초안은 지금 트리(adbe923)를 기준으로 고쳐 썼고, 그 사이 인용한 줄은 하나도 안 움직였어요([DONE] 정리 3단계 PR 7 — 펌웨어와 사이트가 같이 쓰는 값이 한 파일에 모이고, 낡으면 CI 가 빨개진다 #45 는 새 파일과 web/package.json 만 고침). 아직 안 들어온 step 3 k8·k9 와 step 4 k2·k8 은 계획과 k 로 이름만 대고, 바뀌면 초안의 무엇이 달라지는지 적었어요.
• 크기 한계(계획서 질문 32 기본값): 산수로 128×64 와 같은 메모리, 곧 W×H ≤ 8,192(깊이 8)까지만 페이지에 내요. 근거 heap 수치 98,708 B 는 2026-08-18 측정이고 모듈 코드가 PSRAM 으로 옮기기 전 값이라 초안에 그렇게 적었어요. 하드웨어 측정은 안 했어요(D4).
• 캐시 키(질문 33 기본값): §2.7 대로 열(column)을 제안하고 마이그레이션 비용을 적었고, builder_rev 에 크기를 섞는 싼 길을 옆에 적었어요.
• 네트워크 없이 돌아가는 길로 K4 버튼을 켤 때 누르고 있기를 제안했어요. 지금 트리엔 그런 동작이 없어서 질문 2 로 남겼어요.
• Part 1 은 비웠어요(D1, 계획서 질문 30). check:human-lock 이 이 초안의 Part 1 도 읽어요(「Part 1 of 3 RFCs」, 「new docs/rfc-any-resolution.md」). 계획서 finding 11 의 답은 「k8 이 docs/rfc-*.md 를 다 읽는다」예요. 그래서 머지 뒤 Part 1 을 쓰면 lock 이 빨개지고, 머지 전 이 브랜치에서 쓰면 새 파일로 읽혀요.
• Part 1·2 문단은 D1 대로 rfc-cleanup.md 에서 글자 그대로 옮겼어요. 굵은 글씨와 대시가 들어 있지만 그대로 뒀어요.
• 계획서 질문 34(플레이어가 어디 사나)는 PR 3 몫이라 이 초안엔 없어요. 플레이어 초안은 S-PWM 한계를 말하는 한 줄에서만 백틱으로 불렀어요.

Changelog

Docs

• The any-resolution RFC has a draft. docs/rfc-any-resolution.md is Part 2 only. It says where each of the 36 uses of PANEL_RES_W and PANEL_RES_H goes, proposes a geometry read from NVS at boot and set on a core console page, keeps one module build per size with the size in the cache key, states the limits (classic HUB75 only, S-PWM unsupported, W × H up to 8,192 at depth 8, the stock's own memory) and orders the work as 19 PRs. Part 1 is the maintainer's and is empty.

Upstream

• What: new docs/rfc-any-resolution.md, the any-resolution RFC draft, Part 2 only (298 lines): the 36 PANEL_RES uses, a geometry read from NVS at boot, one module build per size, a core console page, the limits and a 19-PR order.
• Checks: docs only, so the 2.1(1) commands do not apply; ran python .github/scripts/check_links.py, npm run doc-map (0 unresolved, CSVs checked out again), npm run check:voice and npm run check:human-lock, all clean.
• Docs map: none (docs/README.md and the two doc-map CSVs take the new file in step 5 k4)

🤖 Generated with Claude Code

https://claude.ai/code/session_01UoPQcL6u1sSqMMm8yP3945