[patternflow-bot]

ops / https://claude.ai/code/session_01ANQCgLTDUW21jJTBJFydEx

라즈베리 파이 같은 리눅스 컴퓨터에서 사이트의 패턴 엔진으로 HUB75 패널, 수신 카드, HDMI 화면에 패턴을 띄우는 플레이어의 설계 초안을 새 문서 하나로 썼다. 정리 RFC §2.7 이 요구한 초안 둘 중 하나로, 출력과 입력과 계약마다 무엇이 들고 PR 이 몇 개(14개)인지, 창작자에게 묻는 질문 아홉 개를 담았다. 머지해도 펌웨어와 사이트는 그대로고, Part 1(왜)은 창작자가 쓰도록 비워 뒀다.

좋아지는 것: 없음

할 일

• 계획서 표의 PR 3(k3) 읽기: 고칠 파일은 docs/rfc-linux-player.md 하나
• k3 가 적은 절대로 Part 2 쓰기: 무엇 · 엔진 · 출력 · 입력 · 계약 · 못 하는 것 · 자리 · 일의 순서 · 질문
• 300줄 아래로 (298줄)
• 다른 초안은 백틱 한 줄로만 부르기 (k4 가 링크로 바꾼다)
• check_links.py · doc-map · check:voice · check:human-lock
• dev merge 하고 다시 확인 (그새 머지된 정리 3단계 PR 7 반영)
• CI 초록 확인 (head 8e2bcdf)

한 일

docs/rfc-linux-player.md 298줄. 틀은 rfc-cleanup.md 그대로고(제목, 날짜 줄, Status 블록 "Draft", Part 1/Part 2 문단 복사, 빈 # Part 1 — Why), Part 2 는 아홉 절이다.

• 2.1 무엇인가: 리눅스 프로세스. 펌웨어도 에디션도 아니다.
• 2.2 엔진: PatternRuntime 을 감싼 DeviceSim 에 출력을 붙인 것. Basics 34개, 나머지 JS 프리셋 14개, 커뮤니티 JS. 128×64 밖의 크기와 // @matrix 가 막히는 곳.
• 2.3 출력 셋: rpi-rgb-led-matrix 는 GPL 이라 트리 밖의 C++ 프로그램과 파이프로, Colorlight 5A-75B 는 raw Ethernet(CAP_NET_RAW), HDMI 는 /dev/fb0.
• 2.4 입력: USB 노브(evdev), MIDI(ALSA raw + RTP-MIDI 5004/5005), OSC 9001, 콘솔 슬라이더처럼 POST /api/params.
• 2.5 계약: REST → OSC → MIDI → MQTT → audio 순서, REST 다섯 경로, 포트 80/81 권한, 4단계 가상 패널에서 가져올 것과 안 가져올 것(/vp/, 수동 시계).
• 2.6 못 하는 것: .pfm, 브라우저 플래시, C++ 피처, 보드만의 일.
• 2.7 자리: 이 레포 tools/linux-player/ 또는 따로. 사이트에 실린 파이 빌드 둘.
• 2.8 PR 14개 표(파일, 줄, PR, player/site). core·ABI·feature 는 하나도 없다.
• 2.9 질문 아홉, 각각 기본값.

증거

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

$ git fetch --tags && cd web && npm run doc-map      # 그 뒤 CSV 둘은 git checkout 으로 되돌림
1084 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
# 이 파일에서 나온 줄 10개, 모두 resolves = yes (#the-three-words, #the-site 앵커 포함)

$ npm run check:voice
base: adbe923 (the merge-base with origin/dev)
read: 298 added lines in 1 file
check:voice: nothing found

$ npm run check:human-lock
base: adbe923 (the merge-base with origin/dev)
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-linux-player.md
check:human-lock: no locked words changed

$ git diff --stat origin/dev...HEAD
 docs/rfc-linux-player.md | 298 +++++++++++
 1 file changed, 298 insertions(+)

CI (head 8e2bcdf, dev adbe923 위): "Docs point at files that exist"(docs-links.yml) success, "Drift checks"(drift.yml, PF_DRIFT_STRICT=1) success.

실행법

cd web && npm ci
python3 ../.github/scripts/check_links.py
npm run check:voice -- ../docs/rfc-linux-player.md
npm run check:human-lock
git fetch --tags && npm run doc-map && git checkout -- ../docs/investigations/2026-10-doc-map.csv ../docs/investigations/2026-10-doc-parity.csv

가정

• 표의 PR 3 은 k3 이고 고칠 파일은 docs/rfc-linux-player.md 하나다. CHANGELOG.md, docs/rfc-cleanup-progress.md, docs/README.md, doc-map CSV 는 고치지 않았다(k4 몫).
• 틀은 계획서 D1 대로 rfc-cleanup.md 머리를 따랐다. Part 1/Part 2 문단은 원문 그대로 복사해서 그 안의 em dash 와 굵은 글씨도 그대로다. Status 블록은 무엇이 proposed 로 올리는지 말하지 않는다(계획서 질문 34).
• 다른 초안 docs/rfc-any-resolution.md 는 30번째 줄 한 줄에서만 백틱으로 부른다. k4 가 그 한 줄을 링크로 바꾼다. 나머지 자리에서는 "the firmware path" 라고만 쓴다.
• k1 기록은 머지돼 있어 링크했다(#the-site). 4단계 계획(가상 패널)은 아직 머지 전이라 D3 대로 경로를 백틱으로 쓰고 k 번호를 적고, 그 계획이 바뀌거나 들어오지 않으면 무엇이 늘어나는지 적었다.
• 일하는 사이 정리 3단계 PR 7([DONE] 정리 3단계 PR 7 — 펌웨어와 사이트가 같이 쓰는 값이 한 파일에 모이고, 낡으면 CI 가 빨개진다 #45, shared/constants.json)이 dev 에 머지됐다. dev 를 merge 하고, 디텐트 문장을 계획이 아닌 사실로 고치고, 사실 기준 SHA 를 adbe923 으로 바꿨다. 인용한 줄 번호는 그 merge 가 건드리지 않은 파일이라 그대로 맞다.
• 처음 쓴 판이 365줄이라 298줄로 줄였다. D5(절 끝마다 파일, PR 수, core/ABI/feature/site 인지)는 절 끝의 "(rows …)" 가 §2.8 표의 행을 가리키는 꼴로 지켰다. 표에 파일, 줄, PR, where 열이 있다.
• PR 수, 줄 수, player/ 아래 파일 이름은 추정이다(D5 단위). 구현과 시제품은 없다(D4). 프레임 바이트 수와 HDMI 배율은 산수라고 적었다.
• 바깥 사실은 각 저장소 README 에서 확인했다. rpi-rgb-led-matrix 는 GPL-2.0 이상이고, root 로 시작해 권한을 내리고, snd_bcm2835 가 올라와 있으면 끝나고, Pi 5 지원은 README 안에서 두 번 다르게 말한다. Colorlight 프로토콜은 공개되지 않았고 haraldkubota/colorlight(MIT)가 캡처로 알아낸 것이다. EtherType 같은 세부는 확인하지 못해 적지 않았다.
• 계획서 결과 11(lock 이 셋째 RFC 의 Part 1 을 읽는가)은 읽는다. check:human-lock 이 "Part 1 of 3 RFCs" 로 센다. 질문 30 기본값대로 창작자가 이 브랜치에서 머지 전에 Part 1 을 쓰면 새 파일로 읽힌다. k4 가 진행 기록에 적을 사실이다.
• §2.10 대로 사람이 머지 전에 한 번 읽어야 한다. 창작자 몫이다.
• 본문에 "Generated with" 줄을 넣지 않았다. AGENTS.md 의 글 규칙이 PR 설명에도 그 줄을 막는다.

Changelog

Docs

• The Linux player has a draft RFC. docs/rfc-linux-player.md is Part 2 of the player path in the cleanup RFC's §2.7: the site's engine in a Linux process, with outputs for a Pi's HUB75 HAT through rpi-rgb-led-matrix, a Colorlight receiving card and HDMI, input from USB encoders, MIDI, OSC and the web knobs, the contracts it speaks and in what order, what it cannot do, the work as fourteen PRs, and nine questions for the maintainer. Part 1 is left for him. Nothing the firmware or the site does changes.

Upstream

• What: Add docs/rfc-linux-player.md, Part 2 of the Linux player RFC from cleanup step 5 (k3): the site engine in a Linux process, its outputs, inputs and contracts, what it cannot do, the work as 14 PRs and 9 open questions. Part 1 is left empty.
• Checks: Docs only, so no command from section 2.1 item 1 applies. Ran python .github/scripts/check_links.py, npm run doc-map (CSVs checked out again), npm run check:voice and npm run check:human-lock; all pass.
• Docs map: none committed. The new file adds 10 rows, all resolving, and step 5's k4 regenerates both CSVs.