docs: 进度口径收敛到机械唯一源——修正三套矛盾数字(147/100→233/233) + 现状基线降级

排查发现进度数字三套互相矛盾:总览/现状基线/主台账历史段=147/86、agent-specs=100/127、module-reality=233/0。核机械真值:覆盖 JSON summary=233/233 completed/0 needs(每 op 带 testFiles 证据 + P1rApiCoverageReportTest 校验 summary 自算防手工拨)。⚠️ JSON generatedAt=2026-05-25 未随内容刷新(手工维护痕迹),已在文档标注以 summary+testFiles 为准。

修正:① 总览(我上轮新建,误抄过时台账)147/233→233/233、各域 full、接口门≠端到端两口径分清、定位为人读封面(权威以台账/JSON为准);② 主台账 头部加机械源口径声明(233/0)+门禁中→满+验收债标已清零;③ 现状基线降级为 2026-06-13 历史快照(顶部时效横幅+性质去SSOT);④ AGENTS序2/module-reality 改引用;⑤ agent-specs/.agent 注记历史数字;⑥ meta-schema review 回指 execution v0.2 已证伪地基(待决策提案);⑦ design-docs/00 加'设计≠进度';⑧ dev-baseline 申明旧 SSOT 自称失效。

确立单一真实源:设计=design-docs;进度=进度总账(叙述)+覆盖JSON(机械);人读=项目功能与进度总览(封面)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

.agents/knowledge/module-reality-baseline.md

@@ -1,6 +1,6 @@
 # knowledge:模块真实现状基线(指针)
 
-> **真实现状的权威 SSOT**:[`docs/agent-specs/2026-06-13-项目目标与模块现状基线.md`](../../docs/agent-specs/2026-06-13-项目目标与模块现状基线.md)(逐模块证据)+ [`2026-06-13-目标达成对抗复盘.md`](../../docs/agent-specs/2026-06-13-目标达成对抗复盘.md)(失控根因)。本文件只做导航 + 关键结论蒸馏;**冲突时以代码与覆盖率台账为准**。
+> **模块现状导航**:逐模块证据见 [`...现状基线.md`](../../docs/agent-specs/2026-06-13-项目目标与模块现状基线.md)(**2026-06-13 历史快照**)+ 根因见 [`...对抗复盘.md`](../../docs/agent-specs/2026-06-13-目标达成对抗复盘.md)。本文件只做导航 + 关键结论蒸馏;**进度机械源 = 覆盖 JSON(当前 233/233);冲突时以代码 + 覆盖率台账 + 主台账为准**。
 
 ## 关键结论(蒸馏,基线源自 2026-06-13,coverage 状态已于 2026-06-19 同步)
 - **后端不是空壳**:9 BC 后端普遍是真实业务逻辑(幂等 / 乐观锁 / 审计 / Shadow→Canonical 硬闸门 / 真实 HTTP 外部集成)。覆盖率台账 233 operation:**233 completed / 0 needs_verification;catch_all / generic_persistence / sse_placeholder / missing / blocked 全为 0**。逐域 operation:account 33 / ai 41 / content 51 / events 1 / knowledge 59 / market 32 / meta 16;completed operation 已带 `testFiles` 证据锚点并由覆盖门禁校验。

AGENTS.md

@@ -56,7 +56,7 @@ oh-my-muse/
 |---|---|---|
 | 0 | [`docs/项目功能与进度总览.md`](docs/项目功能与进度总览.md) | **人读全局**:功能清单 + 进度表 + 待办表(一眼看全局;详细流水仍在 `mvp/进度总账.md`) |
 | 1 | [`.agents/rules/verification-and-anti-false-green.md`](.agents/rules/verification-and-anti-false-green.md) | **脊柱规则**:完成=机械验证、机械门禁优先、反假绿 |
-| 2 | `docs/agent-specs/2026-06-13-项目目标与模块现状基线.md` | 项目目标 + 模块**真实**现状(避免重复探索) |
+| 2 | `docs/agent-specs/2026-06-13-项目目标与模块现状基线.md` | 项目目标 + 模块现状(**2026-06-13 历史快照**;当前现状以序0总览 / 主台账 / 覆盖 JSON 为准) |
 | 3 | `docs/agent-specs/2026-06-13-目标达成对抗复盘.md` | 失控根因(假绿)与重定路径 |
 | 4 | [`.agents/README.md`](.agents/README.md) | 能力中枢导航 |
 | 5 | design-docs(`00-文档大纲.md` 入口 + `架构-01/02`、`后端-01`) | 设计事实 |

design-docs/00-文档大纲.md

@@ -5,6 +5,7 @@
 - 目标读者：产品 / 架构 / 前端 / 后端 / 文档维护者
 - 阅读时间：10–20 分钟
 - 边界说明：本文件只负责导航、边界和归属，不重复解释概念；概念解释必须落在对应主文档中。
+- **设计 ≠ 进度**：design-docs 是**设计意图 SSOT**（要建成什么），**不代表已实现**；实现进度见 [`docs/mvp/进度总账.md`](../docs/mvp/进度总账.md)（进度 SSOT）+ [`docs/项目功能与进度总览.md`](../docs/项目功能与进度总览.md)（人读全局）+ 覆盖 JSON（接口门机械源）。
 
 ## 目标
 

docs/agent-specs/.agent

@@ -4,7 +4,7 @@
 
 边界：本目录只记录审阅版、执行版、review gate 与交接约束，不承载代码实现，不修改 OpenAPI、scanner 或 coverage 口径。
 
-> 归档说明(2026-06-20)：P1R 解锁(审阅版/执行版)与 agent 基建交付等**已完成阶段文档**已移至 [`docs/archive/`](../archive/README.md)；下文 P1R-7b 历史记述中提到的这些路径均以归档副本为准。本目录现仅留：现状基线、对抗复盘、P0 冻结令(知识网根基)与 meta-schema 当前文档。人读全局见 [`docs/项目功能与进度总览.md`](../项目功能与进度总览.md)。
+> 归档说明(2026-06-20)：P1R 解锁(审阅版/执行版)与 agent 基建交付等**已完成阶段文档**已移至 [`docs/archive/`](../archive/README.md)；下文 P1R-7b 历史记述中提到的这些路径均以归档副本为准。本目录现仅留：现状基线、对抗复盘、P0 冻结令(知识网根基)与 meta-schema 当前文档。人读全局见 [`docs/项目功能与进度总览.md`](../项目功能与进度总览.md)。**下文出现的覆盖数(`completed=100/127/147`、`needsVerification=133/86` 等)均为 P1R 各阶段历史快照,当前接口覆盖门口径以覆盖 JSON(233/233)/主台账为准。**
 
 当前状态：P1R-7b 执行版已作为全局方案下的 AI 子计划通过 fresh spec re-review（Erdos）和 fresh quality/feasibility review（Carver）。Task 1 只读 preflight 已双 PASS（Ramanujan / Descartes），Task 2 migration/schema 已双 PASS（Boyle / Lorentz），Task 3 AI DO/Mapper/Service 与 terminal fact 同事务 outbox 已双 PASS（Wegener / Bohr），Task 4 AI worker / dispatcher 已在修复 spec review FAIL 后双 PASS（Hume / Linnaeus）。Task 4 focused evidence 为 Worker tests=20、Mapper tests=5，均 failures=0/errors=0/skipped=0；残余非阻塞风险包括 worker 默认开关口径、retryable 状态日志、terminalFact 与 outbox 完整一致性后续加固。Task 5 focused E2E 已由 Task 5a done 可见性和 Task 5b error / duplicate / rejected 证据合并收口，并通过 fresh spec review（Ptolemy）与 fresh quality/feasibility review（Curie）双 PASS；本地 evidence 为 `P1rAiEventsPublishEndToEndTest` tests=4、failures=0/errors=0/skipped=0，覆盖 done owner 可见与跨 owner 不可见、error payload 不泄露敏感 detail、duplicate replay 同 eventId/sequenceNo、rejected -> outbox dead_letter 且 visible query 为空。该证据仍是 focused harness，不代表 P1R-7b completed，也不代表 Events/Market completed。Task 6 曾因 coverage scanner `--check` 会重写受保护 coverage JSON/Markdown 而 BLOCKED；该 diff 已按受保护边界回退，当前 protected diff 为空。执行版修订 spec review（Feynman）FAIL：Task 7 仍直跑 scanner，Market 命令只看 completionStatus；spec re-review（Banach）FAIL：Task 6 Market 命令仍只看 completionStatus。已修复为 Task 6/Task 7 都在临时隔离副本运行 scanner，当前 worktree protected diff 必须为空，并用 `implementationStatus/completionStatus` 验证 Market 为 `dedicated/needs_verification 32`；修订方案 fresh spec re-review（Kuhn）PASS、fresh quality/feasibility review（Meitner）PASS。Task 6 revised gate 由 fresh implementer（Lorentz）DONE，本轮无文件改动；evidence 为 dependency test 2/2、P1R focused gates 29/29、Migration SQL 4/4、Flyway `_test` 4/4 均 failures=0/errors=0/skipped=0；隔离副本 scanner exit 0，summary 为 completed=100、needsVerification=133、incomplete=0、genericPersistence=0、ssePlaceholder=0；Events `streamEvents=dedicated/needs_verification`，Market 32 个 operation 均为 `dedicated/needs_verification`；dependency tree 证明 AI server 依赖 events-api、不依赖 events-server，Events server 不反向依赖 AI/Knowledge/Market/Member/Content server。下一步必须 fresh Task 6 spec review，未双 PASS 前不能进入 Task 7。
 

docs/agent-specs/2026-06-13-项目目标与模块现状基线.md

@@ -5,12 +5,14 @@
 | 版本 | v1.0 |
 | 日期 | 2026-06-13 |
 | 读者 | 决策与执行(管理者 / 工程执行 / 后续 Agent) |
-| 性质 | 项目现状基线 SSOT(单一事实源) |
+| 性质 | 项目现状**历史快照**(2026-06-13 冻结,**非当前 SSOT**) |
 | 用途 | 后续工作据此进行,**避免重复探索**;凡与本文冲突,以经核实的代码与覆盖率台账为准 |
 | 边界 | 只汇编"目标设计 + 模块当前真实现状";不重新设计、不下达任务。模块完成度为**只读判断**(未实跑 mvn/npm),已逐项标注证据 |
 
 ---
 
+> ⚠️ **时效声明(2026-06-20)**:本文为 **2026-06-13 历史快照、已降级、非当前 SSOT**。文内覆盖数(147 completed / 86 needs_verification / 63% 等)为**当时值**;**当前接口覆盖门 = 233/233 completed**(机械源:[覆盖 JSON](../superpowers/reports/p1r-api-coverage.json))。当前进度以 [主台账](../mvp/进度总账.md) + 覆盖 JSON 为准;人读全局见 [项目功能与进度总览](../项目功能与进度总览.md)。本文仅作 06-13 现状考古留存。
+>
 > ⚠️ 引用说明(2026-06-14 补):本文内联引用的 `docs/memorys/*`、`docs/agent-specs/*审阅版/执行版` 过程文档已作为 churn 清理;唯一操作干货已蒸馏入 [`.agents/knowledge/external-deps-and-gotchas.md`](../../.agents/knowledge/external-deps-and-gotchas.md),完整原文见 git 历史。本文作为现状基线快照保留,内联引用路径仅供 git 追溯。
 
 ## 结论先行(TL;DR)

docs/agent-specs/2026-06-17-meta-schema用量投影-review.md

@@ -1,7 +1,7 @@
 # Meta Schema 用量投影建模 —— 评审版设计
 
 > 版本:v0.2(评审版) · 日期:2026-06-17(决策确认 2026-06-20) · 目标读者:架构决策者(人类) · 类型:评审版(结论先行,无代码细节)
-> 状态:**方向已确认(2026-06-20,见 §十)**,执行版编写中。本文件不实现任何代码。
+> 状态:**待决策提案、非现行设计**。方向已确认(2026-06-20,见 §十),但 ⚠️ **本评审版的方案前提已被执行版证伪**——见 [执行版 v0.2](2026-06-20-meta-schema用量投影-execution.md) 顶部「评审修订摘要」(破坏字段集生产者 + schema_key 来源在代码中**不存在、须从零新建**)。落地细节与修正以执行版为准;本文件不实现任何代码。
 > 关联:[进度总账 §五A](../mvp/进度总账.md)(MetaImpactFacade 置后判定)、[bc-boundaries](../../.agents/rules/bc-boundaries.md)(本设计须遵守的边界门)。
 
 ---

docs/dev-baseline/README.md

@@ -15,3 +15,5 @@
 | BC 边界 | [`../../.agents/rules/bc-boundaries.md`](../../.agents/rules/bc-boundaries.md) |
 
 若本目录旧文档与上述事实源、代码或测试证据冲突,以后者为准。后续只在需要考古旧约束来源时读取本目录;新增或修正规则应回写 `.agents/rules/**` 与总账,不要继续扩写这里。
+
+**本目录内任何旧文档(含内部 `*/CLAUDE.md` 等)的"SSOT / 单一事实源"自称均已失效**——现行 SSOT:设计 = `design-docs/`、进度 = `docs/mvp/进度总账.md`(+ 覆盖 JSON 为接口门机械源)。

docs/mvp/进度总账.md

@@ -1,7 +1,8 @@
 # Muse 进度总账(单一进度源)
 
 > **本文件是项目进度的唯一 SSOT**。进度更新只进**本文件 + 各模块 `.agent`**;**不再新增“状态推进 / 收口 / completedApproval”过程文档**(过程文档 churn 是失控根因之一,见 [对抗复盘](../agent-specs/2026-06-13-目标达成对抗复盘.md))。
-> 模块**真实现状**的权威基线见 [现状基线 spec](../agent-specs/2026-06-13-项目目标与模块现状基线.md);本文件只记“进度”,不重复其证据细节。
+> **接口覆盖门机械唯一源** = [覆盖 JSON `p1r-api-coverage.json`](../superpowers/reports/p1r-api-coverage.json)(经 `P1rApiCoverageReportTest` 校验 summary 自算 + testFiles 证据),当前 **233/233 completed / 0 needs_verification**;⚠️ 该口径 = 接口门,**≠ 端到端可用**(整体 ~76%,见 §二)。
+> 模块现状细节见 [现状基线 spec](../agent-specs/2026-06-13-项目目标与模块现状基线.md)(**2026-06-13 历史快照**,文内 147/86 为当时值,以本文件 + 覆盖 JSON 为准);人读全局见 [项目功能与进度总览](../项目功能与进度总览.md)。
 
 ---
 
@@ -45,7 +46,7 @@
 | 事件/SSE (events) | 88% | [.agent](../../muse-cloud/muse-module-events/.agent) |
 | 账户/个人中心 (account→member) | 68% | [.agent](../../muse-cloud/muse-module-member/.agent) |
 
-> 整体只读评估 ≈ 76%:后端实现高、内部验证门禁中、前端用户端低、跨 BC 集成与机械门禁低(机械门禁项本轮已补 BC + 契约门)。
+> 整体只读评估 ≈ 76%:后端实现高、**接口覆盖门已满(233/233)但 ≠ 端到端可用**、前端用户端低、跨 BC 集成低(机械门禁本轮已补 BC + 契约门)。
 
 > **2026-06-14 更新 —— P1 后端"环境阻塞"已解除**:此前"86 个 needs_verification 须真实 PG、本地不可验"的判断**已被实测推翻**。接通共享远端 PG(详见 §四 时间线 + [.agents/knowledge §四](../../.agents/knowledge/external-deps-and-gotchas.md))真跑 20 个 `P1r*IT`,**19/20 类零功能失败**——completed-approval / Flyway 迁移 / events-publish outbox 等后端路径在真实 PG 上获机械绿证据(非假绿)。**仍未验证/未达**:前端 muse-studio(无 FE 运行栈);唯一红 `P1rKnowledgeFlywayMigrationIT`(陈旧硬编码 V14,待改为动态版本);live-acceptance 中需 `MUSE_P1R_EXTERNAL_ACCEPTANCE=true` 才真跑的用例;以及覆盖台账 completed≠端到端可用(FE 断链仍在)。
 
@@ -117,7 +118,7 @@
 - ⬜ 4× `Unavailable*SourceOwnerFacade`(AI←Account/Meta/Market/Knowledge 源属主校验,**中**):返回 `owner_missing`。属"源传播事件驱动"副路径,不阻 MVP#1 核心切片;各 owner BC 出 source-owner 出站 API。
 - ⏸ 正确 fail-closed(非缺口):`UnavailableNewApiAccountFacade`/`UnavailableAccountFileServiceFacade`/`UnavailableSecurityToolGrantApprovalFacade`——依赖未配置的外部服务(New-API/对象存储/治理审批),保持 fail-closed。
 
-### B. 验收债:86 个 needs_verification operation(B-debt,门禁口径→真实证据)
+### B. 验收债:86 个 needs_verification operation(✅ **已清零 → 233/233 completed**;门禁口径→真实证据)
 - ✅ **验收债真实 IT 战役(2026-06-15 起,goal=验收债·真实 IT)**。原 needs_verification(台账 `docs/superpowers/reports/p1r-api-coverage.json`)= **content 37 / market 28 / account 21 = 86**;截至 2026-06-17 已全部补齐真实 PG 证据,并按用户批准翻为 completed。当前 coverage summary=**233 completed / 0 needs_verification / 0 incomplete / 0 blocked**。范式:`P1rContentCoreCompletedApprovalIT` / 本批新 IT;跑法见 §四(`_test` 库 + argLine + `-DreuseForks=false`)。
   - **批1 ✅ 已交付(content work/chapter/block 生命周期 11 op)**:`P1rContentWorkLifecycleCompletedApprovalIT`(commit 2499c24,1/1 绿 mini-infra PG,独立复跑+逐 assert 反假绿复核)覆盖 createWork/updateWork/deleteWork、createChapter/updateChapter/deleteChapter/reorderChapters、createBlock/deleteBlock/mergeBlocks/splitBlock;每 op 断言 HTTP+真实 muse_content_* 持久化事实 + command_log。产出=Codex 起草 + Opus fork 落地纠偏双代理。**证据已人工批准并翻 completed**(已按人工批准加入 `P1rApiCoverageReportTest` 批准集合并同步台账 completionStatus)。
   - **批2 ✅ 已交付(market 发布生产侧 5 op,2026-06-16)**:`P1rMarketPublishProducerCompletedApprovalIT`(真实 PG `muse_p1r_market_publish_test`,3/3 绿)覆盖 savePublishDraft/runPublishCheck/submitPublishRequest/withdrawPublishRequest/listMyPublishRecords;断言 HTTP + publish_draft/check/request/review_event/market_command/market_account_projection + Account 投影端口调用 + 失败检查不可提交。测试内仅对专属 `_test` 库做缺库自动创建,不放宽 `_test`/密码环境变量/凭据 query 守卫。**证据已人工批准并翻 completed**。

docs/项目功能与进度总览.md

@@ -1,8 +1,7 @@
 # Muse 项目功能与进度总览
 
-> **用途**:给人阅读的单一全局视图——系统有哪些功能、做到哪一步、还差什么。
+> **定位(权威边界)**:本页是**进度台账的人读封面**(给人一眼看全局)。**进度的机械唯一源 = 覆盖门 JSON [`p1r-api-coverage.json`](superpowers/reports/p1r-api-coverage.json)(由 `P1rApiCoverageReportTest` 校验);叙述权威 = 主台账 [`进度总账.md`](mvp/进度总账.md)**。本页数字为 **2026-06-20 口径快照**,如与机械源/主台账冲突,**以后者为准、不以本页为准**。
-> **更新**:2026-06-20 · **维护**:每次重大里程碑后刷新(详细流水仍在 [`docs/mvp/进度总账.md`](mvp/进度总账.md),本文是其人读摘要)。
+> **两个口径别混**:① **接口覆盖门**(机械)=每个 HTTP 端点是否有"真实 PG IT + testFiles 证据";② **整体完成度**(多维评估)=含前端/跨 BC 集成。覆盖门 100% **≠** 产品可用(对抗复盘 R4:禁用单一% 当可用度)。
-> **数据源**:`docs/mvp/进度总账.md`(主台账) + `docs/agent-specs/2026-06-13-项目目标与模块现状基线.md`(现状基线) + 各模块 `.agent` + git log + 覆盖门 JSON。
 > **图例**:✅ 完成并验证 · 🟡 部分/进行中 · 🔴 缺失或受阻 · ⚪ 设计上暂关闭 · — 不适用
 
 ---
@@ -15,7 +14,7 @@
 | 后端业务实现 | **~80%**(真实端到端逻辑,无桩) |
 | 前端用户端 muse-studio | **~30%**(AI 候选链断、知识/市场生产端 UI 缺) |
 | 前端管理端 muse-admin | 较完整(meta 治理、市场审核、系统权限均真实) |
-| 内部验证覆盖门 | **147/233 操作通过(63%)**(86 项多为"码在、待认证") |
+| 接口覆盖门(机械口径) | **233/233 通过(100%)**——每条带 testFiles 证据 + 门禁校验;⚠️ **接口门 100% ≠ 端到端可用**(故整体仍 ~76%) |
 | 跨 BC 集成 | 偏低(多处 facade 仍 Unavailable) |
 
 **一句话**:Muse 是一套**真实、高质量的后端实现**,配**诚实的验证门**,但**用户端前端严重欠缺**。"AI 绝不黑箱改稿、须用户复核"的目标后端已具备(`mergeBlockSuggestion` 已证),但卡在用户可见层(studio 从不调该端点)。非空壳、非假完成——是待补前端 + 跨 BC 接线的真实工程。
@@ -29,19 +28,20 @@
 
 ## 二、模块进度表
 
-| 模块 | 完成度 | 后端 | 前端 studio | 前端 admin | 覆盖门 | 关键风险/缺口 |
+| 模块 | 完成度 | 后端 | 前端 studio | 前端 admin | 接口门(机械) | 关键风险/缺口 |
 |---|:---:|:---:|:---:|:---:|:---:|---|
-| **AI 编排** (ai) | 72% | ✅ 真实 | 🟡 全 MSW | — | 24/41 | New-API 真端到端未验;grant/runtime 物理隔离仅最小 ArchUnit |
+| **AI 编排** (ai) | 72% | ✅ 真实 | 🟡 全 MSW | — | 41/41 | New-API 真端到端未验;grant/runtime 物理隔离仅最小 ArchUnit |
-| **作品/正文** (content) | 82% | ✅ 真实 | 🔴 候选链断 | — | 35/51 | **Accept Suggestion 前端缺**;EditorPage 仍 demo 壳 |
+| **作品/正文** (content) | 82% | ✅ 真实 | 🔴 候选链断 | — | 51/51 | **Accept Suggestion 前端缺**;EditorPage 仍 demo 壳 |
-| **知识库** (knowledge) | 72% | ✅ 真实 | 🟡 ~1/3 UI | — | 24/59 | 工作台缺 2/3;recheck/outbox worker ⚪默认关 |
+| **知识库** (knowledge) | 72% | ✅ 真实 | 🟡 ~1/3 UI | — | 59/59 | 工作台缺 2/3;recheck/outbox worker ⚪默认关 |
-| **市场** (market) | 82% | ✅ 真实 | 🔴 生产端无 UI | ✅ 真实 | 28/32 | 发布/handoff/申诉**生产者 UI 缺**(草稿保存已通) |
+| **市场** (market) | 82% | ✅ 真实 | 🔴 生产端无 UI | ✅ 真实 | 32/32 | 发布/handoff/申诉**生产者 UI 缺**(草稿保存已通) |
 | **元引擎/治理** (meta) | 82% | ✅ 真实 | 🟡 用户端引擎缺 | ✅ 真实 | 16/16 | **影响预览 Unavailable → 发布链运行期阻塞**;facade-api 契约未建 |
 | **事件/SSE** (events) | 88% | ✅ 真实 | 🟡 统一客户端未接 | — | 1/1 | `connectEventStream` 仅自测、无组件消费 |
-| **账户/会员** (member) | 68% | ✅ 真实 | 🔴 ~21% UI | 🟡 受限桩 | 12/33 | 21 端点无 UI;New-API/FileService facade Unavailable |
+| **账户/会员** (member) | 68% | ✅ 真实 | 🔴 ~21% UI | 🟡 受限桩 | 33/33 | 21 端点无 UI;New-API/FileService facade Unavailable |
 | **平台底座** (gateway/system/infra…) | 80% | ✅ 真实 | ✅ 真实 | ✅ 真实 | — | 网关运行期转发未验(Nacos);pay/bpm/mp/report ⚪默认隐藏、0 覆盖 |
-| **整体** | **~76%** | **~80%** | **~30%** | 良好 | **147/233** | 前端用户端缺口 + 跨 BC 集成偏低 |
+| **整体** | **~76%** | **~80%** | **~30%** | 良好 | **233/233** | 前端用户端缺口 + 跨 BC 集成偏低 |
 
-> 覆盖门"操作"=单个 HTTP 端点,须 MockMvc + 真实 PostgreSQL IT + Flyway V1–V21 + 覆盖 JSON 证据锚点、且无 catch_all/generic/sse_placeholder/missing/blocked 才算通过。86 项"待验证"多为"码已在、门未认证",非缺实现。
+> **接口门(机械口径)**:每个 HTTP 端点须 MockMvc + 真实 PostgreSQL IT + Flyway + 覆盖 JSON 的 `testFiles` 证据锚点,且无 catch_all/generic/sse_placeholder/missing/blocked。**当前 233/233 全通过**(机械源:[覆盖 JSON](superpowers/reports/p1r-api-coverage.json),经 `P1rApiCoverageReportTest` 校验 summary 自算防手工拨 + testFiles 指向真实测试源)。
+> ⚠️ **接口门 ≠ 完成度列**:完成度含前端/跨 BC,故同模块可"接口门 full 但完成度 72%"。⚠️ 覆盖 JSON 的 `generatedAt=2026-05-25` 未随内容刷新(手工维护痕迹),以 summary + testFiles 锚点为准,不以该时间戳为准。
 
 ---
 
@@ -168,9 +168,10 @@
 
 | 类别 | 位置 | 说明 |
 |---|---|---|
-| **设计 SSOT** | `design-docs/`(33 篇) | 产品/架构/前后端/流程的单一事实源,实现反向对齐它 |
+| **设计 SSOT(唯一)** | `design-docs/`(33 篇) | 设计意图单一事实源(要建成什么,**≠已实现**),实现反向对齐它 |
-| **详细主台账** | `docs/mvp/进度总账.md` | 逐任务流水(权威但密),本文是其人读摘要 |
+| **进度 SSOT·叙述(唯一)** | `docs/mvp/进度总账.md` | 逐任务流水(权威但密);本文是其人读封面 |
-| **现状基线** | `docs/agent-specs/2026-06-13-项目目标与模块现状基线.md` | 各模块现状权威细节(被各 `.agent` 引用) |
+| **进度 SSOT·机械** | `docs/superpowers/reports/p1r-api-coverage.json` | 接口覆盖门机械源(当前 233/233),经 `P1rApiCoverageReportTest` 校验 |
-| **本文(人读入口)** | `docs/项目功能与进度总览.md` | 功能清单 + 进度 + 待办,给人看全局 |
+| **本文(人读封面)** | `docs/项目功能与进度总览.md` | 功能清单 + 进度 + 待办;**权威以上两者为准,本页为口径快照** |
-| **历史过程文档** | `docs/archive/` | 已完成阶段的工作文档(P0冻结/复盘/P1R解锁等),归档留存 |
+| **现状基线(历史)** | `docs/agent-specs/2026-06-13-...基线.md` | **2026-06-13 历史快照**(已降级、非 SSOT),仅作现状考古 |
+| **历史过程文档** | `docs/archive/` | 已完成阶段工作文档(P0冻结/复盘/P1R解锁等)归档 |
 | **早期基线归档** | `docs/dev-baseline/` | 早期 dev-baseline 历史 |