BoxPistols / BoxPistols/dev-album
照合できていない領域を埋める(cmux の実 UI・a11y の実描画・JS 描画の出典)
- Dominant language
- TypeScript
- Stars
- 1
- Forks
- 0
- Avg merge
- 15h 22m
- Merged PRs (30d)
- 49
Description
## 背景
全342ページの事実照合(high 466 / medium 933 / low 121)を終えたが、**原理的または環境的に照合できなかった領域**が残っている。公開後に順次埋める。
隠しておくと「全部確認済み」と誤解されるので明示しておく。
## 1. cmuxの実UI挙動(未確認)
cmux 0.64.20のCLI(`--help` / `docs`)と公式ドキュメントでは照合したが、**アプリ本体を起動していないため、ソケットが必要なコマンドと画面の見え方は実測していない**。
該当する記述は断定を外してあるが、実機で確認すれば書ける内容が含まれる。
- サイドバーが表示するメタデータ(gitブランチ、カレントディレクトリ、ポート)
- 通知リングの見え方
- `$CMUX_SURFACE_ID` / `$CMUX_WORKSPACE_ID` の実際の値
- `CmuxSetup.tsx` の「0.62.0でクリップボード画像ペースト対応」(変更履歴を確認できていない)
確認したら `VerifiedBox` の `verifiedAt` を更新する。
## 2. JS描画で本文を取得できない出典
`scripts/verify-verdicts.mjs` は取得したHTMLを平文化して照合するため、クライアント描画のページは中身が取れない。
- `m3.material.io`(Material Design 3)
- Apple HIGのDark Mode
- `design.google` の記事ライブラリ
現状はPlaywrightで開いて確認したものをevidenceに残しているが、機械照合の対象外。Playwright経由で取得する経路を用意するか、同じ内容を述べる取得可能な一次情報(`developer.android.com` のCompose Material 3など)へ寄せる。
## 3. PDFの多段組み表
DORAのレポートのように、`pdftotext -layout` で抽出すると列が交錯する表がある。逐語で連続した文字列が原文に存在しないため、抽出行そのものを引用に使っている(該当箇所のevidenceに明記)。
## 4. E2E / a11yの実描画
今回の一連の修正は `pnpm check` と `npx vitest run` では確認したが、**`pnpm test:e2e` / `pnpm test:a11y` は流していない**。文の削除・置換が多いので、実描画とコントラストの確認をしておきたい。
(PRのCIではe2eがpassしているので致命的な破綻は無いはずだが、a11yの3テーマ走査は別途)
## 5. 未照合のまま残した個別項目
- Vue公式のツリーシェイクの記述
- three.js docsの一部
- `DesignMd.tsx` の74 / 64 / 10件(典拠がユーザー本人の成果物リポジトリのため再現していない)
## 補足
判定の記録は `docs/audits/2026-08-16-medium-verdicts.json` と `-low-verdicts.json` にあり、各項目の `evidence` に「どこまで確認して、何が確認できなかったか」が書いてある。埋めるときはそこを起点にする。
Contributor guide
Research direction
Start with docs/audits/2026-08-16-medium-verdicts.json and -low-verdicts.json, using each evidence entry to identify unresolved items. Read scripts/verify-verdicts.mjs, then investigate the cmux UI, JS-rendered sources, PDF tables, and E2E/a11y rendering as applicable. Done means the missing evidence is recorded, VerifiedBox.verifiedAt is updated, and the relevant pnpm and Playwright checks have been run.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- playwright, typescript
- Domain
- accessibility, documentation, testing, tooling
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100