治理文件存量债 (governance debt)
本质与导读
实时列表:
python3 scripts/lint/check_governance.py(退出码 1 = 有 error)。
状态:已清零(2026-06-05)
check_governance.py 2026-06-05 上线时扫出 33 条存量死引用,同日全部修复,当前 check_governance.py = 0 error / 0 warning。
修复明细:
- 断裂内链(11 条):
docs/content/*.md与docs/subsystems/下相对深度写错——./rules.md→../rules.md、./content/X.md→./X.md、./style.md→../style.md(topic-structure / long-content-display / markdown-rendering / ai-search-worker)。 - 已删 workflow 架构描述(architecture.md §3):5 个已删 workflow(build-assets / pages-deploy / feed / daily-maintain / auto-ingest-health)整节重写为现状——部署=CF 原生 git 集成、每日深讲=CCR routine、派生内容=build.mjs、其余已退役。
- dashboard 引用(operations.md 4 处 + tree):
wiki/dashboard.md+generate_dashboard.py已退役 → 改指 web app dashboard(scripts/dashboards/emit_domains.py);tree 图images/mermaid/→images/svg/。 - GHA 触发(governance.md):audit.yml 周期触发已随 billing 停摆 → audit.py 改手动跑。
- 路径补全(upgrade-plan.md):
scripts/build.mjs→apps/web/scripts/build.mjs。 - stale 结论(cf-pages-migration.md):"git 集成漏触发→必须 GHA" 已加 2026-06-05 纠正(真因是 stamp-sw 正则 bug,CF git 集成实际可用)。
同时修了 check_governance.py 两个误报:.ts 吞 .tsx 前缀(扩展名后加 (?![\w]) 边界)、链接检查未屏蔽 code 区([← 索引](../index.md) 等示例性 wiki 页模板内容被误判)。
后续若 check_governance.py 再报 error,在此追加并修复;pre-commit Gate D 会在改动治理文件时自动拦截。