Agent-System/.doc/status/FEATURE-MATRIX.md

模块与功能完成度（SSOT）

更新: 2026-09-20（模块开发规范与耦合审计已合入文档；批次 A–G 仍为 planned，不改 production_ready） production_ready: yes（权威来源：gap-matrix；本表不推导发布门禁） 发布缺口: ../remediation/gap-matrix.md 协作焦点: ../ops/CURRENT.md 连续性审计: ../audit/2026-09-16-feature-matrix-production-readiness-audit.md 整改计划: ../remediation/2026-09-16-feature-matrix-production-readiness-plan.md

本表描述能力成熟度；上线 blocker 见 gap-matrix。二者正交：能力行不必全部 done 才能发布；partial/deferred 不得自动回退 production_ready。

2026-09-19 深度审计的 critical/high 已分四批合入 dev（数据一致性、鉴权、SSE/事件、前端 XSS）。不改 production_ready。未做项在 long-term。

---

状态契约

字段	含义
声明范围	本行冻结的能力边界；done 只对该边界负责
状态	done | partial | planned | deferred | blocked | removed（已下线，仅留历史证据）
发布关系	与当前首发/已签门禁的关系：non_blocker / 补证 / 加固 / deferred_enhancement
关闭条件	何时可将本行升为 done（或关闭 partial）；stub/SKIP/fallback 不得冒充
证据	可追溯到报告/commit/环境/schema；代码或 artifact 变化后须重验
mutex	并行认领互斥键（见 CURRENT）

状态判定

• done：声明范围内能力已达生产验收证据；不表示该领域永无后续。新增增强须拆行或进 backlog。
• partial：已交付可用子集，关闭条件仍未满足。
• planned：方案存在，尚未开始实施。
• deferred：明确不进当前路线，且不是发布 blocker（除非盘点确认违规 → 升 gap-matrix）。
• blocked：本行目标无法继续，须写明 blocker 与恢复条件。
• production_ready：只由 gap-matrix 发布门禁决定。

重验触发器

授权谓词/owner port、schema/迁移/compose/镜像/环境晋升、flag 升级、PI Runner/model/protocol、event consumer/writer、浏览器持久化边界变化时，受影响行须重验；历史 PASS 不能单独证明新 artifact。

禁止

• 靠缩小声明范围制造 done（须保留 before/after 与义务迁移）。
• 用 stub、SKIP、deterministic fallback 冒充真实 PI / 完整叙事闭环。
• 无真实 blocker 变化时改写 gap-matrix / production_ready。

---

完成度矩阵

模块	声明范围	状态	发布关系	证据	剩余工作 / 关闭条件	mutex
Agent worktree 治理自动化	主目录保护、任务 worktree、机器认领、候选集成、dev 部署与安全清理	partial	non_blocker	方案；L1 验收；W1-B macOS；W4 剩余	L1 与 macOS with/docs apply/validate/integrate 已合入。W4 landed：durable queue schema + enqueue/list/cancel/tick。仍 deferred：完整 docs projection apply、真实 deploy/recover 收据、PI 源码镜像 compose、跨机隔离与清理可见性。本行不升 done	agent-workflow-governance
意图识别 L1	18 类 Intent、三分支消解、写/只读分流、双标签 DOC_BUSY、intent 纯依赖边界	done	non_blocker	intent-recognition；工作流作用域；审计；报告；双标签；U1–U3	边界 before：含 U9–U12 叙事混入 → after：U9–U12 迁至「多意图扩面」行。关闭：纯依赖边界回归即重开	intent
多意图持久计划（U1–U8 基线）	app/intentflow 生命周期、HITL、默认 legacy、U1–U8 代码与安全基线	partial	non_blocker（默认 legacy）	设计；U1–U8；Wave2 真 PI；Track I1	after Track I1：生产组合根已去 Fake query owner，改真实 QueryOwner；receipt 含 auth scope digest；confirm 后走既有步骤内核 dispatcher。默认仍 MULTI_INTENT_PLAN_TIER=legacy。升 auto_read/confirm 需 Track I2（项目 allowlist + 频率门）。U9–U12 仍独立 dry-run	intent-plan
多意图扩面（U9–U12）	U9 LLM 分段实验；U10 mutate；U11 docgov；U12 workflow/run-control	partial	deferred_enhancement	设计；go/no-go GO；脚手架；U9；U10；U11；U12；2026-09-20 复核	U9 proposer 已实现和注入但未进入生产聊天分段调用；提议请求已带 reasoning profile。U10–U12 当前为 dry-run/validated-only adapter。历史直接调用/PI 测试继续有效，不代表 live 接线。逐域实现和验收，禁止以 full 一次放量	intent-plan
对话 / ctxmgr baseline	多轮上下文、刷新/重登/重启恢复、授权同集正文与计数、U10 端口化停止扩面	done	non_blocker	multi-turn；刷新审计；U10；门禁 B3（项目 6359）	before：语义摘要误标 D5 混入 → after：摘要迁「语义摘要 D3」；D7 数据治理独立。U10 停止扩面	chat
语义摘要（D3）	授权后可见集合上的语义摘要；shadow → 可选替换 deterministic	partial	deferred_enhancement	chat-agent-p6-backlog；go/no-go GO；pu6；脚手架；W2 真 PI；Track S1	after Track S1：durable chat_summary_shadow_jobs + 后台租约/watermark/provenance 已合入；served Narrative 保持确定性。shadow 默认 off；SEMANTIC_SUMMARY_REPLACE 未接线。2026-09-23 实测 DOCREV 路径 schema 63。授权可见集 digest 已进 shadow 路径。本行不升 done	chat
对话数据治理（D7）	留存/删除口径、库·备份·日志控制、敏感字段加密边界	deferred	deferred_enhancement（违规则升 blocker）	计划 Scope Boundaries；D7 ADR 草案；W7 盘点；红线证据	只读盘点 + Track E ID-only 符合性已补。口径仍 pending-compliance-signoff；禁止物理删除。本行不升 done	chat
智能体小队	角色-任务-工作区-黑板	done	non_blocker	agent-squad；test 2026-09-07	非关键步骤降级(A5/A6)属 backlog	squad
工作流治理	三正式工作流、设置页/DutyMode、动作级鉴权、真实 PI 三工作流 E2E、full/none 混合长链	done	non_blocker	三工作流整改；409/职责；鉴权；PI E2E；Wave2 full/none	full 跨用户审批 + none 免审批不阻塞已签。纯软件自举仍独立 planned	workflow
研发设计控制（rdev）	医疗第 4 工作流：13×60 manifest/模板、squad.rdev_doc.v1 kind 编排、main-completed 硬 precheck、StageKey 动态化；不含前端/真 PI/键名空间化	partial	deferred_enhancement	设计；收口；报告；P3 历史	after 2026-09-22 收口：rd_proposal 标题门禁 + 法规表首表截止 dry PASS；nightly 脚本已扩四工作流（FullChain×3+FullNone）。P3 真 PI 三样本重跑因缺 env:dev blocked（不以 stub 冒充）。剩余：获环境后重跑 P3。本行保持 partial	workflow-def / rdev-templates
纯软件项目自举	软件项目创建、Bootstrap、Delivery、受控工程交接	partial	deferred_enhancement（明确不挡首发）	设计；ADR；L1 报告；W5a；红线证据	after W5a + 红线证据：catalog 驱动创建、软件不挂医疗 key。SWBOOT-10 仍 stub（L1–L4 证据已补；L5/L6 待授权）。本行不升 done	workflow-design
IAM / 鉴权	项目级 API 鉴权 + RBAC；会话/阶段授权	done	加固	v3 full inventory；session 中断；fail-closed；410 策略；R13	全路由 inventory + session 中断负例 + 410 冻结 + R13 基线已签	authz
文档治理	法定文档生命周期 + 租约 + 受控正文读取	done	non_blocker	docgov；正文 UI；canonical hash；键统一	项目 143 只读；不终止。doc_proj* 同一发布键不能再并存	docgov
文档版本 baseline	账本、人工修订、确定性 diff+lineage、运行时 UI、负责人通知	done	non_blocker	管理；Round20 UI；ADR；proposed/authoritative	before：完整 PI narrative 混入 → after：迁「PI change-report 叙事」。fallback 报告是本行内显式行为，不是缺口。lineage GET 已按 URL 项目和文档可见性裁剪。test_manager 血缘的下游/上游版本改读文档版本，不再写死 1。Agent 候选报告为 proposed，正式提交才写 authoritative 后继并挂到版本；拒绝、替代后旧报告不能再出建议。人工修订、导入和聊天卡仍未分开预估与正式报告，见 T1。项目追踪索引见下一行	docgov
阶段回溯与影响闭环	五表追踪索引、影响报告、L1 文档修订、L2 阶段再打开、待复核软标记、对话修订提案	done	deferred_enhancement（不挡首发）	设计；Track T；对话化报告；T 补强	已合入 dev。常驻「需求与影响」面板已退役。2026-09-23 实测 DOCREV 路径 schema 63；test=rc-v1.1.0-beta.1 schema 61；main 本轮未晋升。阶段推进确认门禁仍在。不签 D7 对话 ADR	trace-index
PI change-report 叙事	只读消费 diff+lineage 的 PI 叙事；失败全量降级 fallback	partial	deferred_enhancement	Round20；go/no-go GO；pu7；W3 真 PI；红线负例	flag 默认 off（红线不放量）。fallback 全量负例单测已补。pi-agent reasoning 路径已带 --no-tools。不打开开关	docgov
前端工作台	三栏 + 块文档 + SSE；错误卡/TaskRunCard 竖向进度/busy；版本冲突信封；demo seed 默认关；终止 preview	done	non_blocker	workbench；双标签；demo；B4（项目 6363）；TaskRunCard	before：空「缺口」却 partial → after：本行 done。其他 409 消费方信封复用另列 hardening backlog	web
PI Runner / 配置链	pi-agent + MiniMax + typed-result-v1	done	non_blocker	piagent；container-env；typed-result	文档生成仍使用读写和搜索工具。tool_profile=reasoning argv 为 --no-tools。2026-09-22 实测 pi-agent 已 bind-mount pi-args.mjs	pi-agent
三环境运维	dev/test/main + 共享 KB；对话/业务库隔离	done	non_blocker	PROJECT.md §4；晋升报告；DOCREV	2026-09-23 实测：本地/共享 dev DOCREV 路径 schema 63；test health schema 61（rc-v1.1.0-beta.1）；main 本轮未晋升	infra
CI / E2E	PR CI、PG 集成、治理 PG、已签真实 PI 门禁；nightly schedule/workflow_dispatch + infra/product 分类 receipt	done	加固（阻止下一次晋升，不自动否定已发布）	BUG-08；PI 三工作流；Wave2B；Wave2C；W1 green + receipt 6e2476f0…	before：partial（FullNone product_fail / secrets 文案过时）→ after：secrets 已配；duplicate goose 00048 已清；FullNone+U8 nightly verdict=pass	ci
Artifact 同 digest 晋升	候选 commit 一次构建、按 digest 晋升、promotion receipt	done	加固	计划 PU5B；Wave2B；Wave2C	关闭：same-image pin（candidate-images-* + PINNED_IMAGE_MODE + promote --require-digests）。声明：单机 retag/digest pin；远程 registry 推送另立任务	infra
可靠事件核心	PG dispatcher、notify/advance/projection live、生产闭包 hook 退出、Phase2 选择性解耦已合入	done	non_blocker	E0A–E2 等；复盘；shared live；phase2 closeout	before：与 FAV off 混成 partial → after：FAV 独立行。选择性后续解耦按收益触发	architecture-docs / events
模块开发规范	窄端口、领域事件、wire DTO 三种契约；故障隔离红线；新增模块/表/事件流程。不含批次 A–G 的代码整改	done	non_blocker	规范；审计；ADR	文档入口已立。代码整改不在本行	module-decoupling-spec
模块解耦批次 A–G	server 端口装配、chat 解环、docgov 词汇、工作流单向依赖、巨型文件、前端 api client、21 条例外清零	done	non_blocker	分批计划；审计；A；B；C；D；E；F；G1；G2/G3	after 2026-09-22：A–F 与 E 已合入；G1/G2/G3 例外清零后 arch-check --mode block PASS 且 baseline import/sql_write/path/event 全 0。关闭本伞行	module-decoupling-spec
Final Artifact Vault（FAV）	不可变终态制品库；FAV_DEGRADED_READ=false	partial	deferred_enhancement	Track E 复盘；U7 报告；W6 shadow；红线证据	subscriber shadow 只计算 intended outcome。live 未放量；观察窗起点已登记。FAV_DEGRADED_READ 默认 false；禁止整支 merge	events
系统管理台	全屏系统级管理视图（总览/KB/特性开关/系统设置/工作流/角色/用户/文档 8 分组）；/api/v1/admin/system/*；system_settings 白名单可写；吸收下线 AdminSettingsModal；细粒度 system:* + 设置审计日志（goose 00065）	done	non_blocker	short-term；测试报告；residual modular-decouple-residual-2026-09-23	剩余 deferred：Playwright 实跑、KB 运维动作、白名单项接消费方	web + sysadmin
个人工程中控台（已移出）	原本地只读看板与后来的 Control Center 都不再属于本仓库	removed	进度管理改由独立项目承担	历史设计；历史报告	2026-09-19 删除 cmd/control-center、internal/controlcenter、control-center/web、deploy/control-center。不恢复 engineering-dashboard	—

---

Wave 0 边界 lineage（收口摘要）

行	before 状态/口径	after	原义务去向	现有证据是否覆盖冻结边界
Intent L1	partial（混入 U9–U12）	done	U9–U12 → 多意图扩面	是（双标签 + 分流 + U1–U3）
Chat/ctxmgr	partial（混入语义摘要 D5 误标）	done	D3 摘要行；D7 治理行	是（B3 项目 6359）
Document revision	partial（混入完整 PI 叙事）	done	PI change-report 叙事行	是（Round20；fallback 为声明行为）
Frontend workbench	partial（缺口栏已空）	done	Wave 3 已收口 projectMembers/freeformDoc/taskRuns/chatSessions 结构化错误信封复用	是（B4 项目 6363）
可靠事件	partial（与 FAV 混行）	done	FAV 独立 deferred	是（E0–E2 + shared live）

---

更新规则

1. 模块状态变化时同步本表；仅当发布 blocker 出现或关闭时改 gap-matrix
2. 同一 mutex 同时仅一个 Agent in_progress（见 CURRENT）
3. 新能力行：复制 ../ops/templates/feature-matrix-row.md
4. 拆行/收口须保留 before/after 与义务迁移（见上表）；禁止缩口径假完成

2026-09-17 首次加载性能专项

首次加载与重启首访性能优化：done（U1–U5/U7 关账口径；U6 明确不加索引）。审计 · 方案 · U2 报告 · 2026-09-22 收口。U2：自托管字体 + br/gzip。U3：导出/预览/管理台/块编辑器/Mermaid/公式延迟加载；2026-09-22 对 schema 61 部署包 index-CgkGfOP7.js 浏览器瀑布 n=20（含慢网）确认首屏与首可操作路径无 katex/mermaid/docx。U4：登录只同步当前项目成员；会话列表代次合并。U5：/auth/me 复用已核用户。U6：不加索引（瓶颈曾是成员扇出，无慢 SQL 证据）。U1：慢网 + CPU 4x 各 n=20 — 10 Mbps 表单 p75 599 ms（预算 1500）、2 Mbps p75 1346 ms（预算 3000），未放宽阈值。U7：重启报告 postgres+app→/ready 1.0–1.2 s；2026-09-22 补测 /ready 后冷导航表单可见 n=20，p75 75 ms，相对约 10 s 历史诊断达到 ≤5 s（50%）目标——仅限该口径，不宣称宿主机整机开机首访。macOS 用 PLAYWRIGHT_CHANNEL=msedge（沙箱无法拉 Playwright Chromium）。mutex web + static-delivery / loading-performance-audit。

2026-09-17 文档编制人兼任方案

新增能力 done（U1–U6，已合入 dev@09a9921）：方案 · 源码核查 · U6 验收 · 收口交接。任务归档：archive/ops/2026-09-17-document-author-only-u{1..6}.md。总开关默认 off；test/main 晋升与开放授权另授。变更提案 HTTP 仍缺（audit）。mutex document-duty-policy。