fix(docs): 修 6 处指向不存在实体的文档硬伤——迁移文件名、ACP 审批链（Responder 在 edge-server 0 命中）、SDK 适配器注册事实（sdkAdapterIDs/IsSDKAdapter 0 命中）、run.error→run.failed、projectQueries 归属 Web，并把 known-flaky 自写的 300 行拆分阈值对齐门禁真实的 170（5 文件净 0 行）

[DeliciousBuding]

做了什么

文档屎山批（round-71）：把活跃文档里指向不存在实体的 6 处硬伤改成事实，并修掉 1 处「文档自己写的规则与门禁不一致」。5 files changed, 6 insertions(+), 6 deletions(-) —— 全是同行替换，不增行（各文件仍在自己的行数预算内）。

文件	原文（假）	改成（真）	主机核验
docs/architecture/05-deployment.md	hub-server/migrations/0062、0063	0062_agent_team_runs_indexes.up.sql、0063_agent_run_events_unique_seq.up.sql	ls hub-server/migrations/ 两个文件都在 ✅
docs/architecture/03-runtime-adapters.md	审批链 request_permission → Responder → broker	session/request_permission → PermissionDecisionBroker（RequestPermission 桥接）	git grep Responder -- edge-server = 0 命中；acp.go:122-124、acp_client.go:46 写的正是 session/request_permission → RequestPermission ✅
同上	SDK 适配器「属于 sdkAdapterIDs，IsSDKAdapter() 返回 true」	注册 ID anthropic-sdk/openai-sdk，由 cmd/agenthub-edge 的 registerSDKAdapters 按 --anthropic-sdk-path/--openai-sdk-path 注册	git grep "sdkAdapterIDs|IsSDKAdapter" = 0 命中；adapter_registry.go:62,140 = registerSDKAdapters ✅
docs/architecture/06-auth-identity.md	「所有 Desktop 的 Hub API 查询（… projectQueries.ts）」	Desktop 三个查询文件 + 明写 projectQueries.ts 是 app/web 侧	app/desktop/src/api/projectQueries.ts 不存在，app/web/src/api/projectQueries.ts 存在 ✅
docs/architecture/11-protocol-capability-mapping.md	Run lifecycle 事件 run.error	run.failed	api/events.md、edge-server/internal/httpserver/server.go、lifecycle/* 用的都是 run.failed；run.error 在 api/、edge 生产代码里 0 命中 ✅
docs/governance/known-flaky.md	「本文件超过 300 行时拆分」	「超过 170 行（verify-doc-ssot.py 行数预算）时拆分」	verify-doc-ssot.py:304 = "docs/governance/known-flaky.md": 170；文件当前 167 行 ⇒ 原文档给的自拆阈值比门禁晚 130 行，按它做必然先撞门禁 ✅

普查分母（车道实测，主机抽查复核）

• 批 1 死链接/死路径：核 217 个相对 markdown 链接（0 缺失）+ 522 个反引号仓库路径 + 586 个文件名引用 ⇒ 真死路径 1 处（已修）。其余 51 条路径未命中与 73 个文件名未命中逐条判定为：墓碑句（「已删除/已迁移」）、模块内相对路径、外迁私有文档、刻意 gitignored 的 ux 截图 ⇒ 不改。
• 批 2 死实体：核 106 个环境变量（0 缺失）、28 个 make 目标、63 个 CI job 名、115 个 scripts 文件全部存在；876 个符号候选 ⇒ 真死/错位 4 处（已修）。round-70/69 删掉的东西（chore(scripts): 消融一个自闭环的 Windows-path 死簇——删掉 6 个仓库内不可达的 smoke/release 脚本（−3,080 行，互相引用成闭环、用反斜杠路径互调、其中一处调用早已不存在的 .ps1），并修好 3 个活脚本在 Linux 上必然失败的路径（smoke matrix 的 tauri-dry 行改为真跑 verify-tauri-package-dry.py，实测 PASS） #2281 的 6 个脚本、refactor(testkit): 消融两层纯转发 shim——删掉 edge/hub internal/testkit 里只把 WaitFor/Eventually 原样转给 pkg/testkit 的 2×25 行复制层，11 个测试文件 import 直指 pkg/testkit（净 −44 行、−1 包） #2283 的 internal/testkit、chore(frontend): 消融 4 个必红且零消费者的 format 门禁——app 的 prettier --check 实测 870/1137 个被跟踪 ts/tsx 不合规、desktop 79 个，CI/Makefile/scripts/verify 从不调用；删脚本 + 2 处随之零消费者的 prettier devDep（lockfile 同步，frozen-lockfile rc=0），.prettierrc 保留给编辑器 #2287 的 format 脚本与 prettier devDep）在活跃文档里零引用。
• 批 3 手抄分岔：比对端口/超时/计数/门禁名单/证据等级等 14 个事实域 ⇒ 分岔 1 处（已修，即上表最后一行），其余一致。

门禁（主机独立复跑）

$ python3 scripts/verify/verify-doc-ssot.py                       rc=0（AGENTS path check 99 / script mirror ok / self-test wiring 29 ok / doc SSOT ok）
$ python3 scripts/verify/tests/verify-doc-entrypoints.Tests.py    rc=0（OK；被测 verifier = verify-doc-ssot.py）
$ bash /tmp/run-validate.sh <worktree>                            PASS=61 FAIL=0 SKIP(merge-ref)=1
$ git diff --check origin/master...HEAD                           rc=0
$ bash scripts/verify/verify-commit-messages.sh master HEAD       rc=0（3 commits）
$ bash scripts/verify/check-secrets.sh --range origin/master...HEAD → Secret guard passed
$ git diff --name-only origin/master...HEAD | grep -E '^(AGENTS\.md|scripts/|\.github/|Makefile|CHANGELOG\.md|docs/archives/|reference/|app/|api/openapi\.yaml)' → 空（禁区 0 命中）

行数预算最紧的 5 个文件（改后仍在预算内）：05-deployment 200/200、11-protocol 200/200、04-frontend 150/150、developer-quickstart 170/170、07-design 141/150。

暗卷：植入 2 个假实体（DockerfileX 路径 + doRequestWithRetryX 符号）后，扫描器输出 PATH_MISS / SYM_MISS 两条红；revert 后复跑 0 命中 ⇒ 扫描方法不是摆设。

只报未做（需要裁决或属技术口径讨论）

docs/decisions.md 里的 deployments/dev/（历史裁决的条件句，不是当前路径声明）、EnvSanitizer 概念标签、Available=false 伪代码、05-deployment 的 ACCESS EXCLUSIVE 锁技术口径（要不要细化到「哪些表多大」需实测数据）、ArtifactCard 功能代称、以及 docs/archives 删留 / Mobile 口径 / owner 取值域（#2258、operator 裁决）。

诚实记账

任务书里写的自测文件名 scripts/verify/tests/verify-doc-ssot.Tests.py 在本仓全历史都不存在；真实的 doc 门禁自测是 verify-doc-entrypoints.Tests.py（主机已复跑 rc=0）。这是任务书的错，不是车道的错，记在这里避免下一轮再抄错。

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: 663abec6-7951-4043-bf4e-c4c34613af0b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}