治理文件存量债 (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/*.mddocs/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.mjsapps/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 会在改动治理文件时自动拦截。