From d58d5bc1dd65622f645b70f1abfe2a367bc53615 Mon Sep 17 00:00:00 2001 From: weichen Date: Fri, 16 Oct 2026 06:25:19 +0000 Subject: [PATCH] Review design docs and freeze cockpit contract decisions Why: user approved the four design documents and authorized implementation (/goal); the plan's section-7 tradeoffs gate the I1 public DTO and had to be frozen before any implementation unit starts. A read-only audit of the RDM backend (Agent-System-RDM main 5df66106) supplied the source facts. Evidence: audit findings recorded in rollout section 7 (tree is doc->section only, no confidence field, no persisted conflict entity, per-project event seq complete); review fixes folded into the read-model contract (statReasons, structuralGap, AssertionSummary); precheck receipt READY imported via task-resume. Impact: unlocks I1 implementation in the RDM repo; design deliverable ready for PR/CI/merge; no business code, pins, database or deployment touched. Refs: .task/feature-document-visualization-plan.md --- .task/feature-document-visualization-plan.md | 77 ++++++++++++++----- ...26-10-16-document-visualization-rollout.md | 16 ++-- ...ument-visualization-read-model-contract.md | 16 ++++ 3 files changed, 83 insertions(+), 26 deletions(-) diff --git a/.task/feature-document-visualization-plan.md b/.task/feature-document-visualization-plan.md index ed4c5e02..8d650d2d 100644 --- a/.task/feature-document-visualization-plan.md +++ b/.task/feature-document-visualization-plan.md @@ -7,12 +7,12 @@ - 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）= 9edb011e63ab9bf104360379e52c30075bd2f344 - 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-document-visualization-plan（worktree）；分支：feature/document-visualization-plan -- 授权与交付终点：形成并交付文档可视化展示的详细设计系列；允许只读源审计、写入 `docs/superpowers/specs/**`、`docs/superpowers/plans/**` 和本任务卡；不实施业务代码、数据迁移、部署、运行验收或生产环境修改。 +- 授权与交付终点：形成并交付文档可视化展示的详细设计系列；允许只读源审计、写入 `docs/superpowers/specs/**`、`docs/superpowers/plans/**` 和本任务卡；不实施业务代码、数据迁移、部署、运行验收或生产环境修改。**2026-10-16 扩展**：用户评审通过四份文档并下达 `/goal 按照方案开始实施`，授权按实施计划 rollout.md 的 I1–I4 顺序连续推进（I1 落点 RDM 后端仓，独立任务卡），本卡继续承载设计交付的 Review/PR/合入/闭合。 - 交付模式：goal-first（目标、范围和交付终点一次确认；范围内连续推进） - 实施执行：agent-per-unit（配置：AGENT-EXECUTION.md） - 合入执行：agent（已授权交付范围内，Review 通过、冲突解决且当前 HEAD 的 CI 通过后合入） - 人工决策点：仅限目标/范围/验收变更、重大取舍、高后果操作或无法自动判定的业务验收 -- 当前阶段：方案设计；当前增量：D1（四份设计文档，待用户评审） +- 当前阶段：设计交付收口（评审通过、决策冻结）→ 后续 I1 在 RDM 仓另立任务；当前增量：D1（设计文档，评审通过待合入） - 流程依据：仓库根目录 policy/delivery.md（归档后仍按仓库根目录定位） ## 目标与非目标 @@ -27,24 +27,25 @@ | 单元 ID | 预期范围 | 配置摘要 | 角色 | 候选顺序 | attempt | CLI/模型 | 终态 | transport | fallback | 源码外收据路径 | |---|---|---|---|---|---|---|---|---|---|---| -| D1 设计文档系列 | `docs/superpowers/specs/2026-10-16-document-visualization-*.md`, `docs/superpowers/plans/2026-10-16-document-visualization-rollout.md` | design | Codex 主模型 | 不适用（主模型规划/设计） | 1 | Codex | 完成（待用户评审） | 本地工作区 | 不适用 | — | +| D1 设计文档系列 | `docs/superpowers/specs/2026-10-16-document-visualization-*.md`, `docs/superpowers/plans/2026-10-16-document-visualization-rollout.md` | design | Codex 主模型 | 不适用（主模型规划/设计） | 1 | Codex | 完成（2026-10-16 评审通过） | 本地工作区 | 不适用 | — | ## 关联方向与规划 - 适用状态：已有 RDM 两树一网追溯审计方案、既有三栏工作台和 UI 设计令牌；本次仅补齐其缺失的文档可视化展示设计。 - 主记录路径/版本：`modules/documents/docs/proposals/2026-10-11-rdm-two-trees-trace-audit-integration.md`（当前 Dev 组合指针；实现前需重新核对） -- 对应里程碑：待用户评审后拆分 I1 聚合读取、I2 全景、I3 阅读器、I4 组合验收 +- 实现落点（2026-10-16 审计确认）：RDM 后端在独立仓 `/home/weichen/projects/Agent-System-RDM`（main `5df66106`）；Dev 的 `modules/documents`（73bbb4c）是纯文档仓。I1 聚合读取命令落在 RDM 仓 `plugins/rdm` + `internal/rdmapp`，经基座 `POST /api/commands/{id}` 暴露。 +- 对应里程碑：I1 聚合读取（RDM 仓）→ I2 全景 → I3 阅读器 → I4 组合验收（I2/I3 落 Frontend/UI + Dev 组合，另立任务） ## 需求分析 | ID | 描述 | 项目符合度及依据 | 优先级 | 验收条件 | 依赖 | 结论 | |---|---|---|---|---|---|---| -| DV-R01–DV-R08 | 见 `docs/superpowers/specs/2026-10-16-document-visualization-design.md` §11 | 复用 RDM 两树一网、三栏工作台和 UI 令牌；实现前需核对当前组件源码 | P0/P1 | 见总规格、契约和交互规格对应验收条款 | RDM 读服务、项目授权、Frontend/UI 当前 pin | 待用户评审 | +| DV-R01–DV-R08 | 见 `docs/superpowers/specs/2026-10-16-document-visualization-design.md` §11 | 复用 RDM 两树一网、三栏工作台和 UI 令牌；实现前需核对当前组件源码 | P0/P1 | 见总规格、契约和交互规格对应验收条款 | RDM 读服务、项目授权、Frontend/UI 当前 pin | 已评审通过（2026-10-16；四项契约取舍已冻结，见 rollout §7） | ## 方案与计划 - 方案引用：`docs/superpowers/specs/2026-10-16-document-visualization-design.md`、`...-read-model-contract.md`、`...-view-spec.md` -- 实施计划引用：`docs/superpowers/plans/2026-10-16-document-visualization-rollout.md`（I1–I4，待用户评审） +- 实施计划引用：`docs/superpowers/plans/2026-10-16-document-visualization-rollout.md`（I1–I4；2026-10-16 评审通过，§7 四项决策已冻结） - 测试计划引用：实施计划 §4–§5；当前所有业务/浏览器/CI 验证 `NOT_RUN` ## 阶段记录 @@ -54,8 +55,10 @@ | 需求拆解 | `9edb011e63` | 完成（SELF） | Codex 主模型 | 2026-10-16 | 用户提示与现有 RDM/Workbench 源审计 | | 需求评估 | `9edb011e63` | 完成（SELF） | Codex 主模型 | 2026-10-16 | 现有四入口能力与可视化缺口核对 | | 需求表确认 | `9edb011e63` | 完成（SELF） | Codex 主模型 | 2026-10-16 | DV-R01–DV-R08 与范围/非目标冻结 | -| 方案设计 | 工作区未提交候选 | 完成（待用户评审） | Codex 主模型 | 2026-10-16 | 四份设计/计划文档；git diff --check 通过 | -| 实施计划 | 待定 | 待执行 | — | — | — | +| 方案设计 | 工作区未提交候选 | 完成（2026-10-16 评审通过） | Codex 主模型 | 2026-10-16 | 四份设计/计划文档；git diff --check 通过 | +| 设计评审 | `5466f2cddb`（base `9edb011e63`） | 通过 | 主模型 ZCode/GLM 全新会话（评审者未参与 D1 撰写） | 2026-10-16 | 四文档内部一致性核对 + RDM 后端（Agent-System-RDM main `5df66106`）只读源审计；结论可实施；评审修正见同提交（rollout §7 冻结；契约补 statReasons/structuralGap/AssertionSummary） | +| 契约决策冻结 | 同评审提交 | 完成 | 主模型（用户 `/goal 按照方案开始实施`） | 2026-10-16 | rollout §7：①分母只计已有节点 ②置信度读模型固定、未映射为 unknown ③冲突只投影现有检测视图 ④首屏只显示章节概览 | +| 实施计划 | RDM 仓待立卡 | 待执行 | — | — | — | | 实施与自检 | 待定 | 待执行 | — | — | — | | 正式测试与验收 | 待定 | 待执行 | — | — | — | | 代码 Review | 待定 | 待执行 | — | — | — | @@ -90,23 +93,23 @@ ## 结果与验证（完成后填写） -- 结果：已形成四份可评审文档；未修改业务代码、组件 pin、数据库或部署。 -- 验证：`git diff --check` PASS（SELF）；文档/接口/浏览器/CI/部署/运行验收 NOT_RUN。 -- 影响与剩余项：需用户评审并冻结实施计划 §7 的四个公开契约取舍；批准后另立 I1–I4 实施任务。 +- 结果：已形成四份可评审文档并评审通过（2026-10-16）；评审冻结 rollout §7 四项契约取舍，补齐契约 statReasons/structuralGap/AssertionSummary；未修改业务代码、组件 pin、数据库或部署。 +- 验证：`git diff --check` PASS（SELF）；文档/接口/浏览器/CI/部署/运行验收 NOT_RUN（设计文档本身除外：评审+CI 见合入记录）。 +- 影响与剩余项：I1–I4 业务实施在 RDM 后端仓（`/home/weichen/projects/Agent-System-RDM`）与后续 Dev 前端集成中另立任务推进；本卡收口设计交付。 ## 规划进展与下一步 -- 本次推进/剩余：补齐文档驾驶舱的结构、读取契约、双视图和实施验收设计；实现与运行验收未启动。 -- 首选下一任务：用户评审四份文档并冻结完成度分母、置信度枚举、冲突范围和首屏摘要暴露边界。 -- 推荐依据：这些取舍会改变 I1 公开 DTO 和首屏用户结果，必须在实现前冻结。 -- 前置条件/待确认：实施计划 §7 四项决策；当前 Dev/RDM/Frontend/UI 组件 pin 在实现前重新核对。 -- 预期产物/验收条件：批准后的 I1–I4 任务卡、聚合读取服务、双视图浏览器验收和精确 HEAD CI。 +- 本次推进/剩余：设计四件套评审通过、四项决策冻结；I1–I4 实现与运行验收未启动。 +- 首选下一任务：**I1 聚合读取服务与 DTO**，落点 RDM 后端仓（`Agent-System-RDM`，main；实施前重核其 HEAD）：新增 document-cockpit 只读命令，适配 `rdm.inspect.*` 既有事实，按 rollout §7 冻结映射（树 doc→section + structuralGap、置信度未映射为 unknown、冲突只投影碰撞检测+supersedes、首屏章节概览）。授权依据：用户 2026-10-16 `/goal 按照方案开始实施`。 +- 推荐依据：四项取舍已冻结解锁公开 DTO；RDM 源审计确认 seq/授权/可见性拆分（`AuthorizeDocMetadataReadScoped`/`sectionBodyReadable`）与事件流可直接承载契约。 +- 前置条件/待确认：RDM 仓自身任务卡/工作流与候选 CLI 可用性；Dev 组合 pin 在 I2/I3 集成前重新核对。 +- 预期产物/验收条件：RDM I1 任务卡、cockpit 命令实现与单元/负例测试（同节点跨项目 404、同快照 revision、DTO 状态可判定、历史不落批次中间），精确 HEAD CI。 - 重复任务核对：既有 RDM 四入口和 Workbench 方案是依赖/复用，不替代本次文档驾驶舱方案；未发现同名在途实现任务。 -- 启动授权：本次仅授权方案文档；业务实施需用户评审后另行确认。 +- 启动授权：设计交付收口已授权；I1 及后续增量的实施授权已由用户 `/goal` 给出，按 rollout 顺序连续推进。 ## 合入与清理 -- Review 记录：NOT_RUN（审阅智能体/平台身份、base/head、结论、问题闭合及重放依据） +- Review 记录：设计评审通过 2026-10-16；审阅者=主模型 ZCode/GLM 全新会话（未参与 D1 撰写，阶段会话隔离成立）；对象 base `9edb011e63` → head `5466f2cddb`；方法=四文档内部一致性核对 + RDM 后端只读源审计（Agent-System-RDM main `5df66106`）；发现=4 项（§7 未冻结、stats 缺 unavailableReason 字段、TreeNode 缺 structuralGap、AssertionSummary 未定义），全部闭合于本提交；PR/CI 记录见下。 - 冲突记录：NOT_RUN（最新目标同步、冲突处置、组合兼容核验及复审/补测） - CI 记录：NOT_RUN（当前 HEAD 完整 SHA、全部必需检查、运行链接、执行身份及 GATE 结果） - 合入记录：NOT_RUN（交付授权范围、PR、被核验 HEAD、合入 SHA、目标分支及内容核验） @@ -149,3 +152,41 @@ "receipt_sha256": "220c9eab8152f98ce946f19c5d0c790353fbd8c7d25229006dc34f343ba70a46" } ``` + + +```json +{ + "schema": 1, + "source": "SELF", + "timestamp": "2026-10-16T06:21:21.872586+00:00", + "command": "make precheck", + "command_sha256": "8fd03cdee8adbb8562846a1a114cc0623779a8654412cd20aac9b495e7eb0450", + "cwd": "/home/weichen/projects/Agent-System-Dev-wt-feature-document-visualization-plan", + "common_dir": "/home/weichen/projects/Agent-System-Dev/.git", + "before": { + "head": "5466f2cddb4b4a5bc9b9d0371ad692d01fc924f1", + "branch": "feature/document-visualization-plan", + "target_branch": "main", + "target_head": "9edb011e63ab9bf104360379e52c30075bd2f344", + "status": "", + "tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", + "untracked": {}, + "submodules": " 4f583ca3eeeb07a56a714c5086de84dcd6ad2980 deps/agent-command (heads/main)\n ed2af3e6048928b1fd0ba6da1f9d0c1bafec82d4 deps/agent-command/deps/development-guidelines (remotes/origin/feature/delivery-mechanism-5-ged2af3e)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n c348441691e8bdab784a03aa9be64d53dacff341 deps/agent-native (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c deps/agent-native/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-native/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-native/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-native/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-native/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/logging-system/deps/development-guidelines (26b562d)\n 490b0b2dfa1567cb16ff7a7230fd78e52bc2938e deps/agent-squad (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c deps/agent-squad/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-squad/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-squad/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n c348441691e8bdab784a03aa9be64d53dacff341 deps/agent-squad/deps/agent-native (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c deps/agent-squad/deps/agent-native/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-squad/deps/agent-native/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-squad/deps/agent-native/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-squad/deps/agent-native/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-squad/deps/agent-native/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-squad/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-squad/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/logging-system/deps/development-guidelines (26b562d)\n 2f5b19872be2a4597838a4131ad75d1be089ee5e deps/development-guidelines (heads/main)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/logging-system/deps/development-guidelines (26b562d)\n ab12fea4745cf22fb7648c1c25b18433ac8a3650 modules/backend (v0.5.0-23-gab12fea)\n 4f583ca3eeeb07a56a714c5086de84dcd6ad2980 modules/backend/deps/agent-command (heads/main)\n ed2af3e6048928b1fd0ba6da1f9d0c1bafec82d4 modules/backend/deps/agent-command/deps/development-guidelines (remotes/origin/feature/delivery-mechanism-5-ged2af3e)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c modules/backend/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n c348441691e8bdab784a03aa9be64d53dacff341 modules/backend/deps/agent-native (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c modules/backend/deps/agent-native/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-native/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-native/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-native/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-native/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/logging-system/deps/development-guidelines (26b562d)\n 490b0b2dfa1567cb16ff7a7230fd78e52bc2938e modules/backend/deps/agent-squad (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c modules/backend/deps/agent-squad/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-squad/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-squad/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n c348441691e8bdab784a03aa9be64d53dacff341 modules/backend/deps/agent-squad/deps/agent-native (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-squad/deps/agent-native/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-squad/deps/agent-native/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-squad/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-squad/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/logging-system/deps/development-guidelines (26b562d)\n 1a5ef6b75cc74088786487d82b6f6b70bf977280 modules/backend/deps/agent-system-core (v0.4.0-3-g1a5ef6b)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/logging-system/deps/development-guidelines (26b562d)\n 1a5ef6b75cc74088786487d82b6f6b70bf977280 modules/core (v0.4.0-3-g1a5ef6b)\n 73bbb4cea686eb84826d5066bb4c44bf883c9365 modules/documents (remotes/origin/feature/layered-python-env)\n 3bbb918795516b842573db262d2663a9e31dea14 modules/frontend (v0.4.0-37-g3bbb918)\n c9187473fb1ae9e8f3946cdf9b67055ee732054a modules/ui (v0.4.0-9-gc918747)\n" + }, + "after": { + "head": "5466f2cddb4b4a5bc9b9d0371ad692d01fc924f1", + "branch": "feature/document-visualization-plan", + "target_branch": "main", + "target_head": "9edb011e63ab9bf104360379e52c30075bd2f344", + "status": "", + "tracked_diff_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855", + "untracked": {}, + "submodules": " 4f583ca3eeeb07a56a714c5086de84dcd6ad2980 deps/agent-command (heads/main)\n ed2af3e6048928b1fd0ba6da1f9d0c1bafec82d4 deps/agent-command/deps/development-guidelines (remotes/origin/feature/delivery-mechanism-5-ged2af3e)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n c348441691e8bdab784a03aa9be64d53dacff341 deps/agent-native (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c deps/agent-native/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-native/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-native/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-native/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-native/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-native/deps/logging-system/deps/development-guidelines (26b562d)\n 490b0b2dfa1567cb16ff7a7230fd78e52bc2938e deps/agent-squad (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c deps/agent-squad/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-squad/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-squad/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n c348441691e8bdab784a03aa9be64d53dacff341 deps/agent-squad/deps/agent-native (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c deps/agent-squad/deps/agent-native/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-squad/deps/agent-native/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-squad/deps/agent-native/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-squad/deps/agent-native/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-squad/deps/agent-native/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/agent-native/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/agent-squad/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/agent-squad/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/agent-squad/deps/logging-system/deps/development-guidelines (26b562d)\n 2f5b19872be2a4597838a4131ad75d1be089ee5e deps/development-guidelines (heads/main)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 deps/logging-system/deps/development-guidelines (26b562d)\n ab12fea4745cf22fb7648c1c25b18433ac8a3650 modules/backend (v0.5.0-23-gab12fea)\n 4f583ca3eeeb07a56a714c5086de84dcd6ad2980 modules/backend/deps/agent-command (heads/main)\n ed2af3e6048928b1fd0ba6da1f9d0c1bafec82d4 modules/backend/deps/agent-command/deps/development-guidelines (remotes/origin/feature/delivery-mechanism-5-ged2af3e)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c modules/backend/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n c348441691e8bdab784a03aa9be64d53dacff341 modules/backend/deps/agent-native (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c modules/backend/deps/agent-native/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-native/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-native/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-native/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-native/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-native/deps/logging-system/deps/development-guidelines (26b562d)\n 490b0b2dfa1567cb16ff7a7230fd78e52bc2938e modules/backend/deps/agent-squad (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c modules/backend/deps/agent-squad/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-squad/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-squad/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n c348441691e8bdab784a03aa9be64d53dacff341 modules/backend/deps/agent-squad/deps/agent-native (heads/main)\n 343b1e6d9a5b58e47bf7e594826221036ae8175c modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent (heads/main)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/agent-intent/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-squad/deps/agent-native/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-squad/deps/agent-native/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/agent-native/deps/logging-system/deps/development-guidelines (26b562d)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/development-guidelines (26b562d)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/agent-squad/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/agent-squad/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/agent-squad/deps/logging-system/deps/development-guidelines (26b562d)\n 1a5ef6b75cc74088786487d82b6f6b70bf977280 modules/backend/deps/agent-system-core (v0.4.0-3-g1a5ef6b)\n a3ee67bba269e1276c14e22c026171ecf2cf6190 modules/backend/deps/error-code-system (a3ee67b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/error-code-system/deps/development-guidelines (26b562d)\n 49b5d8be604d05e4246dffa0d10fa1c2b7ad45d7 modules/backend/deps/logging-system (49b5d8b)\n 26b562d2e34fbc560711296a309c91c74ffc55b1 modules/backend/deps/logging-system/deps/development-guidelines (26b562d)\n 1a5ef6b75cc74088786487d82b6f6b70bf977280 modules/core (v0.4.0-3-g1a5ef6b)\n 73bbb4cea686eb84826d5066bb4c44bf883c9365 modules/documents (remotes/origin/feature/layered-python-env)\n 3bbb918795516b842573db262d2663a9e31dea14 modules/frontend (v0.4.0-37-g3bbb918)\n c9187473fb1ae9e8f3946cdf9b67055ee732054a modules/ui (v0.4.0-9-gc918747)\n" + }, + "after_error": null, + "exit_code": 0, + "output": "make[1]: Entering directory '/home/weichen/projects/Agent-System-Dev-wt-feature-document-visualization-plan'\n[repo] branch=feature/document-visualization-plan head=5466f2cddb\n[remote] origin/main=9edb011e63 ahead=2 behind=0\n[tree] clean submodules_drift=0 uninit=0\n[worktrees] linked=15\n[recycle] merged un-recycled branches: feature/card-close-20261015-064117Z feature/layered-python-env feature/workbench-flow-completion fix/model-key-secret-overlay\n[hooks] core.hooksPath=scripts/hooks（pre-commit/post-merge 实际接线）\n[facts] policy/facts.md 6 条事实均在有效期内\n[required-reading] core/baseline.md, workflows/delivery.md §1, policy/delivery.md\n[R0] 9edb011e63（完整：9edb011e63ab9bf104360379e52c30075bd2f344）\n[worktree] before-sync: recursive component checks passed\n[verdict] READY — 保留本次 precheck receipt 后建任务工作区：PRECHECK_RECEIPT=/tmp/task-precheck.json make task-start NAME=feature/your-branch\nmake[1]: Leaving directory '/home/weichen/projects/Agent-System-Dev-wt-feature-document-visualization-plan'\n", + "output_sha256": "29a17dac74b61f4d275950f1601342402880914588b3360060b02f163efa2964", + "receipt_sha256": "c5801c2b82381a2f1abc86148435661ca3aa83339ebc6f4d4ee76f49530b2bfb" +} +``` diff --git a/docs/superpowers/plans/2026-10-16-document-visualization-rollout.md b/docs/superpowers/plans/2026-10-16-document-visualization-rollout.md index c8b95fba..79321a3c 100644 --- a/docs/superpowers/plans/2026-10-16-document-visualization-rollout.md +++ b/docs/superpowers/plans/2026-10-16-document-visualization-rollout.md @@ -95,18 +95,18 @@ 每个增量在实现前需有独立任务卡、当前基线和明确文件范围；实现单元按仓库 `AGENT-EXECUTION.md` 路由，主模型负责集成和验证。请求审核、合入和完成声明前分别执行 `make task-sync`，命令输出通过 `make evidence` 写入任务卡。作者本地测试只能标 `SELF`；精确 HEAD 的 CI 标 `GATE`，独立复跑标 `REPLAY`。 -## 7. 未决决策 +## 7. 契约决策（已冻结 2026-10-16） -以下问题会改变公开契约或用户结果，在实现前需要用户/项目 owner 选择： +用户于 2026-10-16 评审四份文档并授权进入实施（`/goal 按照方案开始实施`），本节四项取舍由本轮评审冻结。依据为实施前对 RDM 后端（独立仓 `Agent-System-RDM`，main `5df66106`）的只读源审计；后续领域数据演进时按契约 §9 版本规则扩展，不在本版内回改。 -1. 文档完成度的分母：只统计已有叶节点，还是把模板要求的缺失章节也纳入分母。 -2. 来源置信度是否沿用现有枚举，还是由本次读模型固定为 `high/medium/low/unknown`。 -3. 冲突计算的首期范围：字段级断言，还是先只显示领域已登记的冲突关系。 -4. 全景首屏是否允许直接显示段落摘要，还是只显示章节概览以降低敏感内容暴露。 +1. **完成度分母只统计已存在的文档/章节节点。** 现状：文档树叶节点即章节 Section（`internal/domain/doctree.go:40-51`），`Section.Require` 标记必选章节，但“模板要求而未实例化的章节”缺少已核实的权威数据源；纳入分母会引入猜测值，触碰“不得生成猜测值”停止条件。树内结构性缺失继续由 `missingChildCount` 与 `structuralGap` 承载；模板级完成度留待后续增量，且须先核对 `Doc.Template` 的实例化语义。 +2. **置信度由读模型固定为 `high/medium/low/unknown`，适配器不猜测。** 现状：领域仅有来源溯源枚举 `human|rule|model`（`internal/domain/eventlog.go:53-60`），无 confidence 数值；核验语义仅存在于法规双通道 `RegSource.Verified()`（`internal/domain/regcheck.go:13-27`）。v1 适配规则：只有可复核证据（如法规来源已核验）才产出 `high`，其余一律 `unknown`；禁止把溯源枚举直译为置信等级。 +3. **首期冲突只投影领域现有检测视图，不做字段级断言。** 现状：无持久化冲突实体；冲突是 `fc.Detector` 对切片对的运行时碰撞检测（`internal/domain/fc/collide.go:27-53`），裁决落为 `supersedes` 追溯边并关闭成对 pending 项（`collide.go:125-145`）。v1 映射：pending 碰撞 → `open`；存在 supersedes 裁决 → `resolved`/`superseded`（按实际边语义）；`acknowledged` 首期不产生。字段级断言冲突须等领域先有字段级断言登记，属后续领域增量。 +4. **全景首屏只显示章节概览与统计，不显示段落摘要。** 现状：文档树只有 doc→section 两级，无段落层（`internal/domain/domain.go:23-35`）；且首屏共享面上的正文摘要在无逐字段披露检查时会扩大敏感内容暴露。段落/正文摘要在选中节点与阅读器内按权限展示。 -在这些决策未冻结前，不启动 I1 的公开 DTO 实现；可以继续做只读源审计和示例数据映射，但不得把示例当作运行能力。 +I1 的公开 DTO 实现自本节冻结起解锁；实施落点为 RDM 后端仓（聚合读取服务与命令），Dev 仓只承载文档、组合 pin 与后续前端集成。 ## 8. 当前状态与下一步 -本计划已形成可评审的设计交付，所有 I1–I4、测试、CI、部署和业务验收均为 `NOT_RUN`。下一步是先评审四份文档并冻结第 7 节取舍；批准后再把 I1 拆成实际实施单元和独立任务卡。 +四份文档已于 2026-10-16 评审通过，§7 四项决策冻结，实施授权已由用户给出（`/goal 按照方案开始实施`）。I1–I4、测试、CI、部署和业务验收仍为 `NOT_RUN`。下一步：合入本设计 PR 后，在 RDM 后端仓为 I1（聚合读取服务与 DTO）建立实施任务并按 AGENT-EXECUTION.md 拆分派发；I1 适配目标为 `rdm.inspect.*` 既有事实与 §7 冻结的映射规则。 diff --git a/docs/superpowers/specs/2026-10-16-document-visualization-read-model-contract.md b/docs/superpowers/specs/2026-10-16-document-visualization-read-model-contract.md index 40cb398a..be8f7c13 100644 --- a/docs/superpowers/specs/2026-10-16-document-visualization-read-model-contract.md +++ b/docs/superpowers/specs/2026-10-16-document-visualization-read-model-contract.md @@ -58,6 +58,9 @@ interface CockpitOverview { conflictCount: number | null pendingChangeCount: number | null updatedAt?: string + // 任一统计为 null 时，必须在本表给出该字段名的 unavailableReason + // （如 forbidden_source / projection_lag / upstream_error），见 §6。 + statReasons: Record } documents: TreeNode[] recentChanges: ChangeSummary[] @@ -84,6 +87,9 @@ interface TreeNode { conflictCount: number impactCount: number missingChildCount: number + // 现有层级不足以表达契约层级时为 true（v1：文档树只有 document -> section， + // 章节即叶节点；subsection/paragraph 枚举值保留给后续层级扩展）。 + structuralGap: boolean } lastChangedAt?: string lastChangedBy?: ActorSummary @@ -154,6 +160,14 @@ interface ChangeSummary { version?: string } +interface AssertionSummary { + node: NodeRef + claim: string + sourceRef?: { kind: SourceKind; id: string } + visibility: 'full' | 'redacted' | 'metadata_only' + redactedReason?: 'private' | 'forbidden' | 'expired' | 'not_loaded' +} + interface ConflictSummary { id: string node: NodeRef @@ -166,6 +180,8 @@ interface ConflictSummary { } ``` +v1 冲突投影（冻结于实施计划 §7.3）：领域无持久化冲突实体，适配器只转换现有碰撞检测视图与 `supersedes` 裁决边；`acknowledged` 首期不产生，一侧受限时对应 `AssertionSummary` 降为 `redacted` 并给出 `redactedReason`。 + 历史查询和导出只能使用已提交批次结束序号。读服务不得把正在写入的中间事件投影为“最近变化”。 ## 6. 筛选、排序和缓存