2026-05-25 に kouchou-ai-developer-wiki 自体の Quartz 表示調整と push 運用を確認した観測メモ。対象は nishio/kouchou-ai-developer-wiki の main で、kouchou-ai 本体 repo ではない。
Observations
- commit
e136cd4(Hide index and log from graph) で、quartz.layout.tsのComponent.Graph()にlocalGraph/globalGraph共通でremoveSlugs: ["index", "log"]を渡すようにした。source-codeより quartz/components/Graph.tsxのD3Configと default options にremoveSlugsを追加し、quartz/components/scripts/graph.inline.tsでfetchData由来の graph node を描画前に slug filter するようにした。source-codeより- 意図は、
wiki/index.mdとwiki/log.mdが知識生成の導線として重要すぎるため、graph 上で全体を吸い込みすぎる問題を避けること。ページ自体は公開されたままで、Explorer / wikilink / URL からは到達できる。source-codeより - 検証では
pnpm buildがwiki/152 files を処理し、public/へ 322 files を出力して成功した。scripts/lint_wiki.pyも壊れた wikilink / index 未登録 / frontmatter 不備 0 で通過した。source-codeより - 一方、通常の
pnpm checkは Node 既定ヒープで OOM し、NODE_OPTIONS=--max-old-space-size=8192 pnpm checkでもwork/配下の local clone まで TypeScript が拾って大量の既存エラーを出した。現状の commit gate としてはpnpm buildの方が実使用経路に近い。source-codeより
Push observation
- 先行する wiki 更新 commit
4cd4775(Update wiki operation notes) では、git push origin mainが GitHub 側のInternal Server Errorで 2 回拒否された。退避用 branch / draft PR を作ったが、Wiki 更新が PR 経由になる運用は望ましくないと判断された。github-dev-docsより mainは protected ではなく、localHEADはorigin/mainからの fast-forward だったため、gh api -X PATCH repos/nishio/kouchou-ai-developer-wiki/git/refs/heads/main -F sha=<HEAD> -F force=falseでrefs/heads/mainを直接進めた。force=falseにより fast-forward でない更新は拒否される。github-dev-docsより- 同じ commit が
mainに入ったため退避 PR は GitHub 上でMERGED扱いになり、退避 branchcodex/wiki-operation-notes-20260525は削除した。github-dev-docsより - その後の
e136cd4は通常のgit push origin mainで成功した。したがって、今後の wiki 更新は PR を作らず、まず direct push を試す。GitHub 側の transient error で direct push だけが落ち、かつmainが unprotected / fast-forward 可能な場合だけ、API fast-forward を fallback にする。github-dev-docsより
Open Questions
pnpm checkがwork/配下 clone を拾う状態を、tsconfig.jsonのexcludeで直すべきか。tsconfig.tsbuildinfoが検証時に生成されるため、ignore 対象にするべきか。wiki/log.mdは graph から除外したが、公開ページとして残すか、より内部向け導線に寄せるか。
Updates
- 2026-05-25: 初版作成