Compare commits
174
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
e5e09560c7 | ||
|
|
4fce16c91b | ||
|
|
151953a520 | ||
|
|
46a0fb2d5a | ||
|
|
dbc9b73278 | ||
|
|
cb4fbb69a6 | ||
|
|
58c04ff6c5 | ||
|
|
9c0954ba6e | ||
|
|
2c1d040ccf | ||
|
|
49d901e964 | ||
|
|
7c1ae7ec38 | ||
|
|
eee42d1d16 | ||
|
|
f5a80fd653 | ||
|
|
1c1a4bb683 | ||
|
|
43555e5d08 | ||
|
|
9ac1eb178e | ||
|
|
2ba6b3ec74 | ||
|
|
47a740a9c4 | ||
|
|
0bc98c6da4 | ||
|
|
886449958f | ||
|
|
982dc48345 | ||
|
|
4b509efefc | ||
|
|
80ef2f61a0 | ||
|
|
f2c2e34f0b | ||
|
|
392b3bc1c9 | ||
|
|
6f52896dad | ||
|
|
5182da20ed | ||
|
|
6fa933ac27 | ||
|
|
cdd3f8c559 | ||
|
|
abbb461780 | ||
|
|
c977e8247a | ||
|
|
e782400736 | ||
|
|
f3ed57c41f | ||
|
|
cdbf9cab63 | ||
|
|
e694408851 | ||
|
|
cacbf755b6 | ||
|
|
1d075aa4c3 | ||
|
|
86a4c9af63 | ||
|
|
4d6b95dea4 | ||
|
|
8d3fd089f2 | ||
|
|
6981223087 | ||
|
|
6e2476f0f2 | ||
|
|
11e030db30 | ||
|
|
0f52ab89db | ||
|
|
a02c67db82 | ||
|
|
4f2e5f013f | ||
|
|
4bda6484a2 | ||
|
|
251b5f9c3d | ||
|
|
c649067d19 | ||
|
|
bb8d921e7c | ||
|
|
83f9004f9e | ||
|
|
92e0ae7ec4 | ||
|
|
49db87ebe5 | ||
|
|
51c8ec1e8a | ||
|
|
768729d85e | ||
|
|
f0029dffed | ||
|
|
00cc5b6645 | ||
|
|
131380e858 | ||
|
|
b92e226497 | ||
|
|
a380c218bb | ||
|
|
f3351ce750 | ||
|
|
f55887e2a2 | ||
|
|
b74b9ab1d0 | ||
|
|
cc8557b8c6 | ||
|
|
003bc7a5b9 | ||
|
|
b5ce947e77 | ||
|
|
01a783b8d5 | ||
|
|
6aea8784c2 | ||
|
|
f6034fad37 | ||
|
|
6087d0bdef | ||
|
|
0611b1f24f | ||
|
|
d860c6430e | ||
|
|
b015f8723f | ||
|
|
2b3302ece4 | ||
|
|
f1d8f49df7 | ||
|
|
0409e399d8 | ||
|
|
975af54fd6 | ||
|
|
5596ead7fd | ||
|
|
7583f109a1 | ||
|
|
6356fb5a8c | ||
|
|
1cd1cddf64 | ||
|
|
47376aeb84 | ||
|
|
d45a1eef75 | ||
|
|
e7e981356c | ||
|
|
8fdf50ab2a | ||
|
|
de65cee96c | ||
|
|
5392238354 | ||
|
|
47a173e7bb | ||
|
|
92d7a3d117 | ||
|
|
3478a5a05a | ||
|
|
56f6a66f2e | ||
|
|
51568ea080 | ||
|
|
18f2729472 | ||
|
|
909384c335 | ||
|
|
5493bf6108 | ||
|
|
d86528b45b | ||
|
|
b7b880a316 | ||
|
|
209c997b22 | ||
|
|
884e5dbf44 | ||
|
|
d661af71d5 | ||
|
|
a30931349a | ||
|
|
776b2b5cae | ||
|
|
81f6378233 | ||
|
|
ebe177eec8 | ||
|
|
025ffe0ab3 | ||
|
|
89ce3cc143 | ||
|
|
a27f2cc7fb | ||
|
|
247ddcd306 | ||
|
|
05ae1b3ffd | ||
|
|
90ad756ce2 | ||
|
|
950ce66ed8 | ||
|
|
a47cb84313 | ||
|
|
91d21ea632 | ||
|
|
7df43f419e | ||
|
|
212f0974d8 | ||
|
|
db85c7cab9 | ||
|
|
b2bcea3cd8 | ||
|
|
d48b36046d | ||
|
|
d07244c980 | ||
|
|
fb73d404f4 | ||
|
|
74d87b9e5d | ||
|
|
f1f24dca5b | ||
|
|
29da12d036 | ||
|
|
e843c3c7dc | ||
|
|
f54abcab82 | ||
|
|
84363b9180 | ||
|
|
d1a019b9d7 | ||
|
|
6264965267 | ||
|
|
5d7ac1a8f9 | ||
|
|
f0acbb10ad | ||
|
|
da15eb91b6 | ||
|
|
7c808bdcfc | ||
|
|
dcab3aec83 | ||
|
|
49ca6cd6dc | ||
|
|
4187bcfc9e | ||
|
|
2498bd2a13 | ||
|
|
c75842f945 | ||
|
|
67d73359fd | ||
|
|
fda159c995 | ||
|
|
a84778f21b | ||
|
|
8278022237 | ||
|
|
879f6fadef | ||
|
|
c360a928de | ||
|
|
7461138412 | ||
|
|
422f98012e | ||
|
|
574758a71f | ||
|
|
f1e87fb2e7 | ||
|
|
aac42936bc | ||
|
|
ad42f83e5b | ||
|
|
3a3b31996a | ||
|
|
c5d10aebcc | ||
|
|
a5bc317492 | ||
|
|
299530bf42 | ||
|
|
7fdbee6c0c | ||
|
|
514db3a086 | ||
|
|
16d1ba1d54 | ||
|
|
0353841a4a | ||
|
|
24e716e661 | ||
|
|
3400f0a7ac | ||
|
|
a453b290a7 | ||
|
|
73ae4b8f5b | ||
|
|
ea2b9f121e | ||
|
|
9d929f0175 | ||
|
|
99504b628e | ||
|
|
a88a7e3b0a | ||
|
|
8afd37da65 | ||
|
|
2fe58ca9d7 | ||
|
|
c4a7479572 | ||
|
|
b67816a898 | ||
|
|
1ff55033f4 | ||
|
|
68455faa94 | ||
|
|
56eb0ed4fe | ||
|
|
794b1f43b7 | ||
|
|
9363121071 |
@@ -0,0 +1,85 @@
|
||||
# ADR:纯软件工作流 key 与领域边界(SWBOOT-00)
|
||||
|
||||
## 状态
|
||||
|
||||
已接受(2026-09-16)
|
||||
|
||||
## 背景
|
||||
|
||||
工作流引擎已声明 `non_medical_software` 产品域,但正式目录、创建入口与模板仍以医疗器械三工作流(`main` / `product_manager` / `test_manager`)为硬编码白名单。继续复用医疗 manifest 会造成临床/注册/CDO 语义污染;直接改写既有三 key 会破坏已激活医疗实例。
|
||||
|
||||
详细设计见 [software-project-bootstrap-workflow](../system-design/2026-09-14-software-project-bootstrap-workflow.md)。
|
||||
|
||||
## 决策
|
||||
|
||||
### 1. 新增正式可选工作流 key
|
||||
|
||||
| key | 定位 | 默认产品域 | 可重复实例 |
|
||||
|-----|------|------------|------------|
|
||||
| `software_bootstrap` | 一次性建立项目事实、需求、架构、风险、路线与验证基线 | `non_medical_software` | 否(默认一次;终止后可重建并保留旧证据) |
|
||||
| `software_delivery` | 按里程碑/发布重复交付,承接 change brief → 证据 → 验证 → 发布 → 复盘 | `non_medical_software` | 是 |
|
||||
|
||||
医疗三 key **保持不变**,仍为正式可选;不得在其 published hash 上替换为软件语义。
|
||||
|
||||
### 2. 目录策略:published + selectable,而非“仅三 key”
|
||||
|
||||
项目可选工作流 = 已发布 (`latest_published_version > 0`) ∩ `project_selectable=true` ∩ 策略白名单。
|
||||
|
||||
白名单扩展为:
|
||||
|
||||
```text
|
||||
main | product_manager | test_manager | software_bootstrap | software_delivery
|
||||
```
|
||||
|
||||
固定文档数量校验 **仅** 继续约束医疗三 key;软件工作流按 manifest 自身完整性校验,不强制医疗文档数。
|
||||
|
||||
### 3. 领域与合规分离
|
||||
|
||||
- `product_domain=non_medical_software` 只说明非医疗器械,不关闭鉴权/审计/安全基线。
|
||||
- `compliance_profile` / `governance_profile` / `execution_mode` / `team_mode` 为项目级独立字段。
|
||||
- 首期默认:`governance=standard`,`compliance=internal_control+security_baseline`,`execution_mode=docs_only`。
|
||||
- `controlled_patch` 在 SWBOOT-10 受控执行器就绪前 **不可真正启用**;仅保留 allowlist stub。
|
||||
|
||||
### 4. 串联而非回环
|
||||
|
||||
```text
|
||||
software_bootstrap(完成 + 创建者确认)
|
||||
→ 仅建议 software_delivery
|
||||
→ 创建者确认后新建 planning/激活实例
|
||||
```
|
||||
|
||||
bootstrap 完成不得自动创建或激活 delivery。
|
||||
|
||||
### 5. Solo 审批策略(契约)
|
||||
|
||||
- `collaborative`:独立三权(author/reviewer/approver 不同人)。
|
||||
- `solo`:`creator_acknowledgement`;页面与审计持续标注“未独立评审”。
|
||||
- `controlled` 或要求独立审查的 compliance profile:**禁止 solo**。
|
||||
|
||||
### 6. 错误码(首期)
|
||||
|
||||
| code | 含义 |
|
||||
|------|------|
|
||||
| `ERR_WORKFLOW_NOT_SELECTABLE` | key 不在正式可选白名单或未 published |
|
||||
| `ERR_DOMAIN_INCOMPATIBLE` | 工作流与项目 `product_domain` / `project_type` 不兼容 |
|
||||
| `ERR_COMPLIANCE_PROFILE` | 合规配置非法或与治理冲突(如 controlled+solo) |
|
||||
| `ERR_EXECUTION_MODE_DISABLED` | 请求 `controlled_patch` 但受控执行器未启用 |
|
||||
| `ERR_REPO_PATH_NOT_ALLOWLISTED` | 仓库路径不在管理员 allowlist(SWBOOT-10 stub) |
|
||||
| `ERR_CREATION_PREVIEW_STALE` | creation token / plan_hash 过期或不匹配(409) |
|
||||
|
||||
### 7. 运行时权威不变
|
||||
|
||||
继续遵守 [workflow-runtime-authority](./2026-09-12-workflow-runtime-authority.md):任务只能从冻结 `doc_task_instance` 启动;禁止客户端 `task_key`/duty/stage 旁路。
|
||||
|
||||
## 后果
|
||||
|
||||
- Bootstrap seed 与 catalog API 必须同时暴露软件两 key,且按 `product_domain` 过滤时不把医疗默认话术塞进软件项目。
|
||||
- 项目表 additive 增加 `project_type_key` / `compliance_profile_key` 等字段;旧项目不自动分类为医疗或软件。
|
||||
- SWBOOT-10 仅落地 allowlist stub:任何真实 patch/merge/push 必须 fail closed,直到独立 Epic 验收。
|
||||
- 医疗三工作流黄金用例与固定文档数门禁保持回归基线。
|
||||
|
||||
## 关联
|
||||
|
||||
- 实施任务:`.doc/ops/short-term/2026-09-16-software-project-bootstrap.md`
|
||||
- Backlog:`.doc/ops/long-term/2026-09-14-software-project-bootstrap-implementation.md`
|
||||
- 验收清单:`.doc/ops/checklists/2026-09-14-software-project-bootstrap-acceptance.md`
|
||||
@@ -0,0 +1,63 @@
|
||||
---
|
||||
title: "D7 对话数据留存与删除口径(草案)"
|
||||
status: proposed
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
compliance: pending-compliance-signoff
|
||||
owner: Cline
|
||||
related:
|
||||
- ../remediation/2026-09-16-partial-deferred-completion-plan.md
|
||||
- ../ops/short-term/2026-09-16-partial-deferred-completion.md
|
||||
- ../status/FEATURE-MATRIX.md
|
||||
---
|
||||
|
||||
# ADR:D7 对话数据留存与删除口径
|
||||
|
||||
## 状态
|
||||
|
||||
**提议 / 工程草案**(2026-09-17)。数字与删除口径标 `pending-compliance-signoff`:合规签字或改数前,W7 仅允许数据分类盘点与现状审计,不得按未签字数字执行物理删除或备份清除。接受后状态改为 `accepted`。
|
||||
|
||||
## 背景
|
||||
|
||||
FEATURE-MATRIX「对话数据治理(D7)」为 `deferred`。收口计划 W7 要求:数据分类盘点 → 留存/删除口径落 ADR → 库/备份/日志控制 → 敏感字段加密边界。工程不能单方面定合规数字,但必须提供可审草案,避免无限期停在 deferred。Track E / R13 / R18 / R22 已对日志脱敏与销毁门禁有硬约束,本 ADR 将其固化为 D7 口径。
|
||||
|
||||
## 决策(建议默认;待合规确认)
|
||||
|
||||
### 1. 数据分类与留存
|
||||
|
||||
| 数据类 | 留存 | 说明 |
|
||||
|--------|------|------|
|
||||
| 会话正文(chat sessions/messages) | 热库 **365 天**(可配置) | 超期 soft-delete → 观察窗 → 物理清理 |
|
||||
| 派生文档 / 私密文档 | 与聊天**独立周期**;回收站 **30 天**后物理清理 | 删除 UI 须说明影响范围(只删聊天 / 只删文档 / 两者) |
|
||||
| 审计元数据(导出/治理审计) | **180 天** | 不可被普通用户删除覆盖 |
|
||||
| Agent trace / workspace 非终态 | 任务结束后 **30 天**;nightly 仅合成数据 | 禁止当长期事实源 |
|
||||
| 日志 / dead-letter / reconciliation | 不按正文留存;**只存 ID、digest、typed error code、allowlist 摘要** | Track E 红线 |
|
||||
| FAV 终态制品 | `retention_class` + legal hold + delete ledger | 与聊天口径解耦 |
|
||||
|
||||
### 2. 删除路径
|
||||
|
||||
1. **用户删除**:soft-delete / tombstone → 观察窗 → 物理清理。
|
||||
2. **备份清除**:须二次批准 + 精确 delete manifest;对齐销毁门禁 R22(完整备份恢复演练、migration corpus、FAV coverage、manifest、用户批准)。
|
||||
3. **删除界面**:必须说明聊天源消息与派生文档的独立保留周期及本次操作影响范围。
|
||||
|
||||
### 3. 加密边界(首期)
|
||||
|
||||
- 首期范围:敏感字段**盘点** + 传输与备份访问控制。
|
||||
- **不默认**上字段级加密;选型待合规确认与威胁模型后再立实现任务。
|
||||
|
||||
### 4. 违规升级
|
||||
|
||||
盘点确认当前基线违反已确认的安全或合规要求 → **立即**写入 [`gap-matrix.md`](../remediation/gap-matrix.md),不得继续当普通 backlog;本行 `done` 让位于整改。
|
||||
|
||||
## 后果
|
||||
|
||||
- W7 可按本草案启动盘点;物理删除与备份清除在 `pending-compliance-signoff` 解除前禁止按建议数字自动执行。
|
||||
- 2026-09-17 只读盘点:[../audit/2026-09-17-d7-data-inventory.md](../audit/2026-09-17-d7-data-inventory.md)(未删数据、未升矩阵 done、未写 gap-matrix blocker)。
|
||||
- 日志/DLQ/reconciliation 实现与审计须持续满足 Track E ID-only 红线。
|
||||
- 合规改数后:更新本 ADR 数字表、`updated` 日期,并将 `compliance` 改为 `signed` / `accepted`;再开 W7 整改实现。
|
||||
|
||||
## 相关链接
|
||||
|
||||
- 收口计划 §7.1:[../remediation/2026-09-16-partial-deferred-completion-plan.md](../remediation/2026-09-16-partial-deferred-completion-plan.md)
|
||||
- FEATURE-MATRIX D7 行:[../status/FEATURE-MATRIX.md](../status/FEATURE-MATRIX.md)
|
||||
- Track E Phase 2:[../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md](../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md)
|
||||
@@ -0,0 +1,55 @@
|
||||
---
|
||||
title: "PU6 语义摘要 shadow(SEMANTIC_SUMMARY_SHADOW)"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor-Auto
|
||||
branch: feature/pu6-semantic-summary
|
||||
worktree: ".worktrees/feature-pu6-semantic-summary"
|
||||
mutex: chat
|
||||
---
|
||||
|
||||
# PU6 语义摘要 shadow
|
||||
|
||||
## 目标
|
||||
|
||||
在授权可见消息集合上落地 `SEMANTIC_SUMMARY_SHADOW`(默认 off):shadow 语义摘要、失败回 deterministic 并标注 freshness;不启用 REPLACE。
|
||||
|
||||
## 范围
|
||||
|
||||
- `internal/ctxmgr/summarizer.go` + semantic shadow
|
||||
- `internal/app/chatflow/` 授权过滤入口
|
||||
- `internal/server/chat_digest_api.go` 出站 freshness/shadow 字段
|
||||
- 单元/表征测试;测试报告
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不启用 `SEMANTIC_SUMMARY_REPLACE`
|
||||
- 不合入 `dev`
|
||||
- 不改 plan 文件
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 从 `dev` 开分支 / worktree 并认领
|
||||
2. [x] flags + 无工具语义摘要器 + rolling summary shadow
|
||||
3. [x] chatflow 授权路径 + digest API
|
||||
4. [x] 测试与报告
|
||||
5. [x] 渐进提交并 push
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] flag off 行为与基线一致
|
||||
- [x] shadow on:仅 authorized 消息;失败保留 deterministic + freshness
|
||||
- [x] injection 不能提权;REPLACE 路径未接线
|
||||
- [x] 测试报告归档
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Contract: `../long-term/2026-09-16-pu6-semantic-summary-contract.md`
|
||||
- Test report: `../../test-reports/2026-09-16-pu6-semantic-summary-test-report.md`
|
||||
|
||||
## 证据 / 备注
|
||||
|
||||
- 分支:`feature/pu6-semantic-summary`(worktree)
|
||||
- 测试:`go test -short ./internal/ctxmgr/ ./internal/app/chatflow/ ./internal/server/` PASS
|
||||
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: "Wave 2 PU4 真实 PI 补证(U8 + full/none)"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor
|
||||
branch: feature/wave2-real-pi-evidence
|
||||
worktree: "-"
|
||||
mutex: intent-plan
|
||||
---
|
||||
|
||||
# Wave 2 PU4 真实 PI 补证(U8 + full/none)
|
||||
|
||||
## 目标
|
||||
|
||||
补齐 multi-intent U8 与工作流 full/none 的真实 PI / PG / 跨用户 / 恢复证据。
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 认领 + 占槽 rebuild
|
||||
2. [x] U8 live 证据路径
|
||||
3. [x] full/none 混合长链 live 测试
|
||||
4. [x] 报告 + 矩阵更新 + 释放槽位
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] U8 真实 PI PASS
|
||||
- [x] full 跨用户审批 PASS
|
||||
- [x] none 免审批且不阻塞 PASS
|
||||
- [x] 报告归档 `.doc/test-reports/2026-09-16-wave2-real-pi-evidence-test-report.md`
|
||||
@@ -0,0 +1,55 @@
|
||||
---
|
||||
title: "修复 KB 宿主机错误口令与静默离线降级"
|
||||
status: done
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: fix/kb-host-auth-layered-load
|
||||
worktree: "-"
|
||||
mutex: infra
|
||||
---
|
||||
|
||||
# 修复 KB 宿主机错误口令与静默离线降级
|
||||
|
||||
## 目标
|
||||
|
||||
消除 `config.Load("")` 只读 `configs/.env.dev`、忽略根 `.env` 的 `KB_DB_PASSWORD` 导致的错误默认口令与静默离线;E2E/nightly 默认 fail-closed。
|
||||
|
||||
## 范围
|
||||
|
||||
- `internal/config` 分层加载 + 宿主机 DNS 归一化 + 空默认口令
|
||||
- `internal/kb` 脱敏日志、`Online()`、`KB_REQUIRE_ONLINE` / `KB_ALLOW_OFFLINE`
|
||||
- `/health` 增加 `kb_ready`
|
||||
- PI E2E helper 与 `scripts/run-nightly-real-pi.sh` 预检
|
||||
- env 模板与验收报告
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不改 KB 数据内容 / 法规迁移
|
||||
- 不把真实口令写入 git 跟踪的 `configs/.env.*`
|
||||
- 不把容器内 DNS 改成 localhost
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 分层 Load + 默认口令清空
|
||||
2. [x] NormalizeKBHostForRuntime
|
||||
3. [x] kb 客户端脱敏 + RequireOnline(EnsureOnline;不 Fatalf)
|
||||
4. [x] health `kb_ready` + E2E/nightly 门禁
|
||||
5. [x] 合入 `dev` 冒烟(rebuild + `/health` `kb_ready=true`)
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] `config.Load("")` 分层合并后口令来自根 `.env`(单测临时文件 + live 布尔校验)
|
||||
- [x] 宿主机 `shuimu-kb-shared` → `127.0.0.1`;容器内保留 compose DNS
|
||||
- [x] 错口令/空口令离线且日志无明文密码;`KB_ALLOW_OFFLINE=1` 可降级
|
||||
- [x] 合 `dev` 后 short 测 PASS;dev rebuild 后 `kb_ready=true`,日志 `online=true dsn=...:***@shuimu-kb-shared...`,无 `shared_kb_secret_pass`
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Test report: `.doc/test-reports/2026-09-17-kb-host-auth-layered-load-test-report.md`
|
||||
- Plan: 修复 KB 连接降级
|
||||
|
||||
## 证据 / 备注
|
||||
|
||||
根因:`Load` 优先单文件 `configs/.env.dev`(故意省略 `KB_DB_PASSWORD`),保留错误默认 `shared_kb_secret_pass`;Compose 本已分层,宿主机 `go test` 未对齐。
|
||||
合入后容器日志:`[kb] online=true dsn=postgres://regkb:***@shuimu-kb-shared:5432/regulations?sslmode=disable`;health `kb_ready=true`。
|
||||
+10
-10
@@ -1,6 +1,6 @@
|
||||
---
|
||||
title: "FEATURE-MATRIX 深度测试 + 晋升部署 test"
|
||||
status: in_progress
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor-Auto
|
||||
@@ -30,18 +30,18 @@ mutex: infra
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [ ] 认领占槽
|
||||
2. [ ] 自动化深度回归
|
||||
3. [ ] live `:8080` 抽检
|
||||
4. [ ] PI 抽样
|
||||
5. [ ] 晋升 test 并冒烟
|
||||
6. [ ] 报告与归档
|
||||
1. [x] 认领占槽
|
||||
2. [x] 自动化深度回归
|
||||
3. [x] live `:8080` 抽检
|
||||
4. [x] PI 抽样
|
||||
5. [x] 晋升 test 并冒烟
|
||||
6. [x] 报告与归档
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [ ] 矩阵已实现行均有 PASS 证据
|
||||
- [ ] `:8081` health/ready schema=47;`test-env-smoke.sh` PASS
|
||||
- [ ] tag `rc-v1.0.0-beta.2`;报告归档
|
||||
- [x] 矩阵已实现行均有 PASS 证据
|
||||
- [x] `:8081` health/ready schema=47;`test-env-smoke.sh` PASS
|
||||
- [x] tag `rc-v1.0.0-beta.2`;报告归档
|
||||
|
||||
## 相关链接
|
||||
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
title: "Wave 2B PU5B:nightly PI + promotion receipt"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor
|
||||
branch: feature/wave2b-nightly-promotion-receipt
|
||||
worktree: "-"
|
||||
mutex: ci
|
||||
---
|
||||
|
||||
# Wave 2B PU5B:nightly PI + promotion receipt
|
||||
|
||||
## 目标
|
||||
|
||||
落地夜间真实 PI 回归入口、不可变 promotion receipt,以及晋升脚本强制校验;same-image digest 晋升本轮仅做到 same-commit + digest 可追溯。
|
||||
|
||||
## 范围
|
||||
|
||||
- promotion receipt 写/校验 + waiver
|
||||
- nightly-real-pi.yml + run-nightly-real-pi.sh
|
||||
- git-workflow-helper / promote-to-test / release-to-main 门禁钩子
|
||||
- 报告与 FEATURE-MATRIX / remediation 同步
|
||||
|
||||
## 非目标
|
||||
|
||||
- compose 按 digest pull 的同镜像晋升流水线
|
||||
- Playwright 双标签;升 MULTI_INTENT tier
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 认领 + 开分支
|
||||
2. [x] receipt 写/校验脚本
|
||||
3. [x] nightly workflow + 本机脚本
|
||||
4. [x] 晋升钩子
|
||||
5. [x] 报告 + 合入 dev
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 缺 secret/runner → infra_fail,晋升拒绝
|
||||
- [x] product_fail → 晋升拒绝
|
||||
- [x] pass receipt → 晋升可过;无 receipt → 非零退出
|
||||
- [x] 报告归档(`.doc/test-reports/2026-09-16-wave2b-nightly-promotion-receipt-test-report.md`)
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Remediation PU5B: `../../remediation/2026-09-16-feature-matrix-production-readiness-plan.md`
|
||||
- Test report: `../../test-reports/2026-09-16-wave2b-nightly-promotion-receipt-test-report.md`
|
||||
@@ -0,0 +1,41 @@
|
||||
---
|
||||
title: "Wave 2C:同 digest 镜像晋升"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor
|
||||
branch: feature/wave2c-same-image-digest
|
||||
worktree: "-"
|
||||
mutex: infra
|
||||
---
|
||||
|
||||
# Wave 2C:同 digest 镜像晋升
|
||||
|
||||
## 目标
|
||||
|
||||
候选 commit 一次构建;test/main 按 receipt digests 启动;pinned 禁止 rebuild 另造镜像。
|
||||
|
||||
## 范围
|
||||
|
||||
- candidate-images-build/apply
|
||||
- compose + env-service pinned
|
||||
- promote/release 钩子 + receipt --require-digests
|
||||
- nightly digests 对齐
|
||||
|
||||
## 非目标
|
||||
|
||||
- 远程 registry;升 tier;Playwright;U8 quality_failed(Phase 3)
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 认领 + 开分支
|
||||
2. [x] build/apply + check digests
|
||||
3. [x] compose/env-service/hooks
|
||||
4. [x] nightly align
|
||||
5. [x] 报告合入
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] PASS receipt 含 digests;apply 后 ID 一致
|
||||
- [x] pinned rebuild 不换 ID(env-service 拒绝 --build)
|
||||
- [x] 缺 digest 拒绝晋升
|
||||
@@ -0,0 +1,26 @@
|
||||
---
|
||||
title: "Wave 3 PU6–PU8 go/no-go 文档任务"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor
|
||||
branch: feature/wave3-pu6-pu8-go-no-go
|
||||
worktree: "-"
|
||||
mutex: architecture-docs
|
||||
---
|
||||
|
||||
# Wave 3 PU6–PU8 go/no-go 文档任务
|
||||
|
||||
## 目标
|
||||
|
||||
完成 PU6–PU8 产品 go/no-go 记录与获批后契约;未获批不实施。
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 调研 go/no-go 总文
|
||||
2. [x] PU6–PU8 / U9–U12 契约
|
||||
3. [x] 勾 DoD + 矩阵/CURRENT 同步 + 合入
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Research: `../research/2026-09-16-wave3-pu6-pu8-go-no-go.md`
|
||||
@@ -0,0 +1,19 @@
|
||||
---
|
||||
title: "BUG-11 410 兼容策略冻结"
|
||||
created: 2026-09-16
|
||||
status: done
|
||||
---
|
||||
|
||||
# BUG-11:旧 WORKFLOW_SWITCH API 410 策略
|
||||
|
||||
## 决定(2026-09-16 产品/工程冻结)
|
||||
|
||||
**保留** 治理可用时返回 `410 Gone` + `WORKFLOW_SWITCH_API_RETIRED`;治理不可用环境仍允许旧路径。
|
||||
|
||||
- 不视为能力缺口;不强制本轮删除路由。
|
||||
- 遥测若证明零流量,可另开退役任务。
|
||||
|
||||
## 证据
|
||||
|
||||
- `internal/server/project_handlers.go` Gone 分支
|
||||
- gap-matrix BUG-11 → PASS(策略冻结)
|
||||
@@ -0,0 +1,24 @@
|
||||
---
|
||||
title: "FAV U7 incremental — remaining port inventory"
|
||||
status: open
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-17
|
||||
---
|
||||
|
||||
# FAV U7 增量:未移植清单
|
||||
|
||||
相对 `feature/final-artifact-vault`,本切片 **未** 整支 merge,且因 `internal/artifactvault` 与当前 `dev`(dataset Candidate backfill)大面积 DIFF,下列能力仍待后续手工移植 + 审计:
|
||||
|
||||
| 项 | 旁支路径 | 阻塞 |
|
||||
|----|----------|------|
|
||||
| EnumerateTerminals / LoadExclusions | `internal/artifactvault/enumerate.go` | 依赖 TerminalRow;与现 `Enumerate(Candidate)` 并存需设计 |
|
||||
| TerminalRow Backfill | FAV `backfill.go` | 现 backfill 已改为 dataset 路径 |
|
||||
| 完整 CLI | `cmd/artifact-vault` 全命令 | 本切片仅 status stub |
|
||||
| ingest hooks | `internal/server/vault.go` OnFinalArtifact* | 会写 staging;需与 publisher 门闩同批审批 |
|
||||
| schema JSON | `*.schema.json` | 可选文档资产 |
|
||||
| durable Register(fav) | `cmd/events` | events 硬门 + 单独 cutover 审批 |
|
||||
| live staging → artifact → publication | publisher Drain / ingest hooks | 每级观察窗 ≥7 天;本轮 **未** 放量 |
|
||||
|
||||
**W6 已移植(仍非 live)**:`internal/app/fav.EventConsumer.ObserveShadow` 只计算 intended outcome(`WouldStage`/`WouldPublish` 恒 false);`FAV_DEGRADED_READ` 为 true 时 shadow 直接拒绝;`HandleLease` 与 `Registry.Register(fav)` 仍 fail-closed。
|
||||
|
||||
**红线保持**:`FAV_DEGRADED_READ=false`;fav consumer mode=off;禁止整支 merge。
|
||||
@@ -0,0 +1,110 @@
|
||||
---
|
||||
title: "FEATURE-MATRIX production-ready 连续性审计"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
---
|
||||
|
||||
# FEATURE-MATRIX production-ready 连续性审计
|
||||
|
||||
## 结论
|
||||
|
||||
排除“纯软件项目自举”后,当前证据没有显示新的发布 blocker。`CURRENT.md`、`gap-matrix.md` 与 B1–B4 报告一致记录 `production_ready=yes`,dev/test/main 均为 schema 47。
|
||||
|
||||
`FEATURE-MATRIX.md` 仍需整改,但问题主要是状态语义混杂和证据漂移:同一个 `partial` 同时表示补证、首发后增强、实验、刻意关闭和真正的能力缺口。矩阵不能仅凭这些 `partial` 把 production-ready 回退,也不能据此宣称所有能力完整。
|
||||
|
||||
本轮只读核对文档和源码,没有运行测试、改业务代码、切换 feature flag 或操作共享环境。运行态事实仍以现有测试报告为准;后续状态提升必须重新验证。
|
||||
|
||||
## 审计边界
|
||||
|
||||
- 包含:除“纯软件项目自举”外的 `partial` 行、与这些行直接相关的 done/deferred 边界、发布门禁和证据链。
|
||||
- 不包含:纯软件项目自举的实现方案、FAV 的实现审计、业务代码整改、部署或环境晋升。
|
||||
- 权威关系:`FEATURE-MATRIX.md` 描述能力成熟度;`gap-matrix.md` 描述发布 blocker;`CURRENT.md` 描述当前协作与环境快照。
|
||||
|
||||
## 已确认事实
|
||||
|
||||
1. 发布门禁 B1–B4 已签,三环境 schema 为 47;U9–U12、FAV、完整 PI change-report 叙事和软件自举明确不挡当前首发。
|
||||
2. 对话刷新、重登、重启和跨用户拒绝已有真实 PI/运行态证据。
|
||||
3. 可靠事件 notify、workflow advance、projection 已 live,生产闭包 hook 已退出;FAV 仍保持 off。
|
||||
4. 多意图 U1–U8 已合入默认 `legacy` 的安全基线,但 U8 真实 PI generate 在其报告中是 SKIP,不能写成真实生成闭环已签。
|
||||
5. 工作流治理的设置页、DutyMode、动作级鉴权和三工作流真实 PI E2E 已签;full/none 文档长链的页面证据仍未完整覆盖。
|
||||
6. 文档版本账本、人工修订、比较、通知和运行时 UI 已通过;change report 仍是明确标识的 deterministic fallback,不是完整 PI 叙事。
|
||||
|
||||
## 逐行核对
|
||||
|
||||
| 模块 | 当前判定 | 剩余工作 | 发布关系 |
|
||||
|---|---|---|---|
|
||||
| 意图识别 L1 | 当前行范围已具备改为 `done` 的条件 | 把 U9–U12 移出 L1 行;L1 只保留 18 类、三分支、读写分流和纯依赖边界 | 文档校准,不是 blocker |
|
||||
| 多意图持久计划 | `partial` 合理 | 先补 U8 真实 PI + PG + browser + restart + 撤权证据;U9 独立实验;U10–U12 逐 action 扩面 | 默认 `legacy`,不挡首发 |
|
||||
| 对话 / ctxmgr baseline | 当前冻结范围可改为 `done` | 语义摘要是 backlog D3,不是 D5;拆成独立 deferred/partial 行 | 文档校准,不是 blocker |
|
||||
| 对话安全治理 D7 | `deferred` 独立行 | 数据分类,数据库/备份/日志控制盘点,留存删除口径和加密边界;若确认当前基线违规则升级 blocker | 待合规口径,不得无限期隐藏在普通 backlog |
|
||||
| 工作流治理 | `partial` 合理 | full 文档真实 PI 人工审批长链;none 文档真实 PI 生成、免审批、账本持久化和阶段不阻塞长链 | 补证优先,不预设改代码 |
|
||||
| IAM / 鉴权 | 现有缺口文字过时,模块仍应暂保 `partial` | 历史读取统一 owner/阶段授权已闭环;改为全路由 inventory、PG fail-closed、管理员例外、缓存失效和 410 退役决策 | 若发现现行旁路则升级 blocker |
|
||||
| 文档版本与修改认知 baseline | 当前冻结范围可改为 `done` | 账本、人工修订、真实 diff+lineage 和 UI 已签;完整 PI narrative 拆成独立 deferred/partial 行 | 文档校准,不是 blocker |
|
||||
| 前端工作台 | 当前行范围可改为 `done` | 其他 409 消费方复用信封解析应另列 hardening,不能让当前能力永久 `partial` | 文档校准,不是 blocker |
|
||||
| CI / E2E | `partial` 合理 | 夜间 `RUN_PI_E2E=1`、失败分类与证据归档;修复全仓 race 的 TempDir 异步收口 flake | 阻止下一次晋升,不自动否定已发布版本 |
|
||||
| Artifact promotion | `partial/deferred` 独立行 | 现状只证明同 commit 与各环境 digest 可追溯;要声明 same-image promotion,需一次构建、按 digest 晋升和可执行 receipt | 发布加固,不反向否定已签版本 |
|
||||
| 模块解耦与可靠事件 | 当前核心范围可改为 `done` | 将 FAV 拆成独立 `deferred` 行;选择性后续解耦按收益触发 | FAV 保持 off,不挡首发 |
|
||||
|
||||
## 文档漂移
|
||||
|
||||
1. 多意图行仍写“共享环境 schema 45 待晋升”,与三环境 schema 47 冲突。
|
||||
2. 对话行将语义摘要标成 D5;`chat-agent-p6-backlog.md` 中语义摘要实际为 D3,D5 是共享 KB 环境隔离评估。
|
||||
3. IAM 行仍把已经闭环的历史读取 owner/阶段授权写成待办。
|
||||
4. 前端行的“缺口/后续”没有未完成项,但状态仍是 `partial`。
|
||||
5. 模块解耦行把已完成的事件核心和故意关闭的 FAV 混在同一状态中。
|
||||
6. `2026-09-15-multi-intent-hitl-plan.md`、Phase 2 解耦方案、HTTP 信封方案和相关历史研究的头部状态或叙事已被后续报告部分或全部取代。
|
||||
|
||||
历史文档不得删除。应在原文增加 implemented/superseded 指针,或更新仍作为活方案的状态与证据链接。
|
||||
|
||||
## 风险发现
|
||||
|
||||
### IAM fail-open 潜在路径
|
||||
|
||||
`internal/auth/store_factory.go` 在 pool 为空或 IAM 表未就绪时回退 `MemoryStore`,没有按环境显式拒绝。当前 main schema 47 使该分支未被证实正在触发,因此本审计不直接翻转 production-ready;后续必须先只读核对部署实际选择,再把 fallback 改成仅 dev/test 加显式 opt-in 可用,空值、未知环境和 main/prod 一律 fail closed,并覆盖既有 session 的授权依赖中断负例。
|
||||
|
||||
### 状态提升越级
|
||||
|
||||
U8 的代码合入、默认 legacy 安全和真实 PI 放量是三件不同的事。矩阵若只写“U1–U8 完成”,会掩盖真实 PI stop-gate,并可能误导后续把 tier 升到 `confirm/full`。
|
||||
|
||||
### `none` 语义误写
|
||||
|
||||
`none` 表示不需要人工三权审批,不是“none 文档审批长链”。验收应证明真实 PI 生成、版本账本、审批动作不适用和阶段不阻塞。
|
||||
|
||||
### 证据失效
|
||||
|
||||
测试报告只证明其 commit、schema、镜像、runner/model/protocol 和环境。代码、迁移、compose、flag、runner 协议变化或环境晋升后,历史 PASS 不能单独证明新部署。
|
||||
|
||||
## 推荐状态模型
|
||||
|
||||
能力状态与发布状态必须正交:
|
||||
|
||||
- `done`:本行声明的能力边界已完成并有相应层级证据;不表示该领域永无后续。
|
||||
- `partial`:已交付可用子集,行内列出尚未满足的关闭条件。
|
||||
- `planned`:方案已存在但尚未实施。
|
||||
- `deferred`:明确不进入当前路线,且不是发布 blocker。
|
||||
- `blocked`:该行目标无法继续,必须给出 blocker 和恢复条件。
|
||||
- `production_ready`:只由 `gap-matrix.md` 的发布门禁决定,不由所有能力行必须 `done` 推导。
|
||||
|
||||
## 重验触发器
|
||||
|
||||
发生以下任一变化时,受影响行必须重新验证,不能沿用旧 PASS:
|
||||
|
||||
- 授权谓词、owner port、会话或阶段作用域变化;
|
||||
- schema、迁移、compose、镜像或环境晋升;
|
||||
- feature flag/tier 从 off、legacy 或 shadow 升级;
|
||||
- PI Runner URL、模型、typed-result 协议或 prompt/schema 变化;
|
||||
- event consumer writer、lease、receipt、replay 或回滚路径变化;
|
||||
- 浏览器用户流、SSE 恢复或持久化边界变化。
|
||||
|
||||
## 相关证据
|
||||
|
||||
- 能力矩阵:`status/FEATURE-MATRIX.md`
|
||||
- 发布缺口:`remediation/gap-matrix.md`
|
||||
- 当前环境:`ops/CURRENT.md`
|
||||
- 发布门禁任务:`archive/ops/short-term/2026-09-16-production-ready-gates.md`
|
||||
- 多意图设计与 U8:`system-design/2026-09-15-multi-intent-hitl-plan.md`、`test-reports/2026-09-16-multi-intent-u8-task-generate-test-report.md`
|
||||
- 对话门禁:`test-reports/2026-09-16-chat-refresh-gate-test-report.md`
|
||||
- 工作流 full/none 证据边界:`test-reports/2026-09-14-workflow-plan-409-frozen-and-optional-duties-test-report.md`
|
||||
- 文档版本:`test-reports/2026-09-14-document-revision-runtime-ui-test-report.md`
|
||||
- 事件与解耦:`test-reports/2026-09-15-phase2-closeout-test-report.md`、`ops/research/2026-09-15-track-e-retrospective.md`
|
||||
@@ -0,0 +1,23 @@
|
||||
---
|
||||
title: "R13 数据安全清单(nightly / real-PI)"
|
||||
created: 2026-09-16
|
||||
status: done
|
||||
---
|
||||
|
||||
# R13 数据安全清单
|
||||
|
||||
用于真实 PI / nightly / 扩面验收的出站与留存门禁。
|
||||
|
||||
| # | 控制项 | 状态 | 证据/路径 |
|
||||
|---|--------|------|-----------|
|
||||
| 1 | 隔离合成 project/session,禁止生产真实 PII | PASS | nightly `agent_wave2_pi` + 合成 fixture |
|
||||
| 2 | 凭证不入库;secrets 仅 Gitea Actions / `~/.secrets` | PASS | handoff gitea-nightly-secrets |
|
||||
| 3 | evidence_refs 脱敏;日志无 token/密码 | PASS | `promotion-receipt-*` + run script |
|
||||
| 4 | PI 最小字段 allowlist / typed-result-v1 | PASS | deploy/pi-agent typed-result |
|
||||
| 5 | 跨项目/跨用户负例拒绝 | PASS | Wave2 / authz 套件 |
|
||||
| 6 | 产物保留期有限(本地 tar / Actions) | PASS | workflow archive step |
|
||||
| 7 | KB 出站失败降级不泄漏凭证 | PASS | pi-agent runner health 无 key |
|
||||
|
||||
## 开放增强
|
||||
|
||||
- 完整红队注入矩阵可另开 audit;不挡本清单基线勾选。
|
||||
@@ -0,0 +1,62 @@
|
||||
---
|
||||
title: "D7 对话数据分类盘点"
|
||||
status: done
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
severity: medium
|
||||
---
|
||||
|
||||
# D7 对话数据分类盘点
|
||||
|
||||
## 现象
|
||||
|
||||
FEATURE-MATRIX「对话数据治理(D7)」为 `deferred`;ADR 数字 `pending-compliance-signoff`。W7 只盘点当前基线:会话正文、派生副本、共享 KB、日志、备份、事件敏感字段。本轮**未**按草案 365/180/30 天执行物理删除或备份清除。
|
||||
|
||||
## 根因分析
|
||||
|
||||
当前基线是「热库明文 + 软删除列预留 + 事件 ID 化」,不是已签字的留存作业。缺口是**尚未实现**的治理能力,不是已确认合规数字被违反。
|
||||
|
||||
## 严重度
|
||||
|
||||
`medium`(实现缺口;**不**升 gap-matrix blocker)
|
||||
|
||||
## 分类盘点
|
||||
|
||||
| 数据类 | 位置 | 形态 | 现状 |
|
||||
|--------|------|------|------|
|
||||
| 会话正文 | `chat_sessions` / `chat_messages.content` | 热库明文 TEXT;`deleted_at` 列存在 | dev 619 sessions / 3291 messages;`deleted_at` 全 NULL;Go 无 `SET deleted_at`、无 `DELETE FROM chat_*` |
|
||||
| 派生摘要 | `chat_daily_digests` | headline / key_points JSON | 0 行 |
|
||||
| 向量记忆 | `context_memory_chunks` | `content` TEXT + embedding | 102 行:`project_doc` 71、`chat_history` 24、`approved_case` 7。聊天派生副本会随正文留存 |
|
||||
| 私密文档 | `freeform_documents` | `is_deleted` / `deleted_at` + version markdown | 122 份,其中 113 已软删(聊天消息无对等写路径) |
|
||||
| 共享 KB | `shuimu-kb-shared` / `regulations` | 法规 chunks,无 chat 表 | `reg_documents` 2907、`reg_chunks` 312919;与对话库隔离 |
|
||||
| 事件 envelope | `event_envelopes.payload` BYTEA | JSON 字段 | 4 条;keys 均为 ID/digest/`summary_ref`,`has_content=false` |
|
||||
| 事件 DLQ / attempts | `event_dead_letters` / `event_delivery_attempts` | ID + reason / error_code | DLQ 0;attempts 4;无正文列 |
|
||||
| 日志 | Docker `json-file` 无 max-size | 应用 slog | 抽检 rebuild 日志:DSN 已 `***`,无 chat content |
|
||||
| 备份 | `scripts/backup-system-db.sh` `pg_dump -Fc` | 整库含 chat 明文 | 宿主机无 `./backups` 目录;CI 有 backup-restore-drill |
|
||||
| Agent workspace | `data/dev/workspaces` 150M | 非终态工作区 | 无 30 天清理作业(ADR 草案待签字) |
|
||||
| FAV | `final_artifacts` | 1 行;consumer mode=off | 与聊天口径解耦;W6 shadow 不写 |
|
||||
|
||||
事件 payload 比 `StaticContracts` allowlist **多出** `workspace_id` / `manifest_sha256` 等 ID 字段,但仍无聊天正文。属契约收紧 follow-up,不是 Track E 正文泄漏。
|
||||
|
||||
## 违规判定
|
||||
|
||||
对照已签字约束(Track E ID-only 日志/DLQ、R13 出站最小化、ADR 明确「签字前禁止按数字删除」):
|
||||
|
||||
- **未发现**已确认安全/合规基线被当前实现违反。
|
||||
- **因此不写** `gap-matrix` blocker。
|
||||
- 缺 365 天热库清理、缺聊天 soft-delete 写路径、缺字段级加密,均属 ADR 签字后的 W7 整改实现,不得在本轮当「已违规」执行删除。
|
||||
|
||||
## 关联整改
|
||||
|
||||
- ADR 草案: [../adr/2026-09-17-d7-chat-data-retention.md](../adr/2026-09-17-d7-chat-data-retention.md)
|
||||
- 签字后整改:soft-delete 写路径 → 观察窗 → 物理清理;同步清 `context_memory_chunks` 的 `chat_history`;备份二次批准 + delete manifest(R22)
|
||||
|
||||
## 证据
|
||||
|
||||
`.doc/test-reports/assets/2026-09-17-w7-d7-inventory/`(counts / columns / event keys / KB / logs / health)。查询只读,未 `DELETE`/`UPDATE`。
|
||||
|
||||
## 开放问题
|
||||
|
||||
- 合规何时签字或改数(365/180/30)?
|
||||
- 聊天 UI 删除是否要与 freeform 回收站对齐?
|
||||
- `taskrun.completed` payload 额外 ID 字段是否收紧 allowlist?
|
||||
@@ -13,6 +13,14 @@
|
||||
|
||||
## 核心文档(按阅读顺序推荐)
|
||||
|
||||
### FEATURE-MATRIX production-ready 连续性审计(2026-09-16)
|
||||
|
||||
**文件**: [2026-09-16-feature-matrix-production-readiness-audit.md](./2026-09-16-feature-matrix-production-readiness-audit.md)
|
||||
|
||||
**结论**: 排除纯软件项目自举后没有新增发布 blocker;矩阵需要拆分能力成熟度、发布关系、补证、增强和 deferred 状态,并修复 schema、D3/D5、IAM、前端与 FAV 叙事漂移。
|
||||
|
||||
**整改**: [FEATURE-MATRIX Production-Ready Continuity - Plan](../remediation/2026-09-16-feature-matrix-production-readiness-plan.md)
|
||||
|
||||
### 多意图与 HITL 方案复核(2026-09-15)
|
||||
|
||||
**文件**: [2026-09-15-multi-intent-hitl-plan-review.md](./2026-09-15-multi-intent-hitl-plan-review.md)
|
||||
|
||||
@@ -0,0 +1,157 @@
|
||||
---
|
||||
title: "Authorization matrix v3 — full route inventory"
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
status: done
|
||||
---
|
||||
|
||||
# Authorization matrix v3 — full route inventory
|
||||
|
||||
Generated from `mux.HandleFunc` registrations under `internal/server/`.
|
||||
AuthN column is **heuristic**; negative-test pointers filled where known.
|
||||
|
||||
| Method | Path | Handler | File | AuthN (heuristic) | Neg test |
|
||||
|--------|------|---------|------|-------------------|----------|
|
||||
| GET | `/` | `s.serveSPA` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/admin/config` | `s.handleAdminConfig` | `server.go` | admin+project? | see suite |
|
||||
| PUT | `/api/v1/admin/config` | `s.handleAdminConfig` | `server.go` | admin+project? | see suite |
|
||||
| GET | `/api/v1/admin/permissions` | `s.handleAdminPermissions` | `server.go` | admin+project? | see suite |
|
||||
| GET | `/api/v1/admin/roles` | `s.handleAdminRoles` | `server.go` | admin+project? | see suite |
|
||||
| POST | `/api/v1/admin/roles` | `s.handleAdminRoles` | `server.go` | admin+project? | see suite |
|
||||
| DELETE | `/api/v1/admin/roles/{id}` | `s.handleAdminRoleByID` | `server.go` | admin+project? | see suite |
|
||||
| PATCH | `/api/v1/admin/roles/{id}` | `s.handleAdminRoleByID` | `server.go` | admin+project? | see suite |
|
||||
| GET | `/api/v1/admin/templates` | `s.handleAdminTemplates` | `server.go` | admin+project? | see suite |
|
||||
| POST | `/api/v1/admin/templates` | `s.handleAdminTemplates` | `server.go` | admin+project? | see suite |
|
||||
| GET | `/api/v1/admin/templates/{key}/versions` | `s.handleAdminTemplateVersions` | `server.go` | admin+project? | see suite |
|
||||
| GET | `/api/v1/admin/users` | `s.handleAdminUsers` | `server.go` | admin+project? | see suite |
|
||||
| POST | `/api/v1/admin/users` | `s.handleAdminUsers` | `server.go` | admin+project? | see suite |
|
||||
| PUT | `/api/v1/admin/users/{id}/role` | `s.handleAdminUpdateRole` | `server.go` | admin+project? | see suite |
|
||||
| PUT | `/api/v1/admin/users/{id}/status` | `s.handleAdminUpdateStatus` | `server.go` | admin+project? | see suite |
|
||||
| GET | `/api/v1/admin/workflows` | `s.handleAdminWorkflows` | `server.go` | admin+project? | see suite |
|
||||
| POST | `/api/v1/admin/workflows` | `s.handleAdminWorkflows` | `server.go` | admin+project? | see suite |
|
||||
| GET | `/api/v1/admin/workflows/{id}` | `s.handleAdminWorkflowByID` | `server.go` | admin+project? | see suite |
|
||||
| PATCH | `/api/v1/admin/workflows/{id}/versions/{version}` | `s.handleAdminWorkflowVersion` | `server.go` | admin+project? | see suite |
|
||||
| POST | `/api/v1/admin/workflows/{id}/versions/{version}/publish` | `s.handleAdminWorkflowPublish` | `server.go` | admin+project? | see suite |
|
||||
| POST | `/api/v1/admin/workflows/{id}/versions/{version}/retire` | `s.handleAdminWorkflowRetire` | `server.go` | admin+project? | see suite |
|
||||
| POST | `/api/v1/admin/workflows/{id}/versions/{version}/validate` | `s.handleAdminWorkflowValidate` | `server.go` | admin+project? | see suite |
|
||||
| POST | `/api/v1/admin/workspaces/reconcile` | `s.handleReconcileWorkspace` | `server.go` | admin+project? | see suite |
|
||||
| POST | `/api/v1/auth/change-password` | `s.handleAuthChangePassword` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/auth/login` | `s.handleAuthLogin` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/auth/logout` | `s.handleAuthLogout` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/auth/me` | `s.handleAuthMe` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/auth/public-config` | `s.handleAuthPublicConfig` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/auth/register` | `s.handleAuthRegister` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/auth/sessions` | `s.handleAuthSessions` | `server.go` | handler | see suite |
|
||||
| DELETE | `/api/v1/auth/sessions/{id}` | `s.handleAuthSessionByID` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/chat` | `s.handleChat` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/categories` | `s.handleListChatCategories` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/dates` | `s.handleListChatDates` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/digests` | `s.handleListDailyDigests` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/chat/digests/generate` | `s.handleGenerateDailyDigest` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/export/messages` | `s.handleChatExportMessages` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/messages` | `s.handleGetChatMessages` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/messages/day` | `s.handleGetChatDayMessages` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/chat/messages/import` | `s.handleImportChatMessages` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/messages/window` | `s.handleGetChatWindow` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/messages/{message_id}/export-capability` | `s.handleGetExportCapability` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/messages/{message_id}/export-source` | `s.handleGetExportSource` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/chat/read` | `s.handleChatRead` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/chat/recategorize` | `s.handleChatRecategorize` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/search` | `s.handleChatSearch` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/sessions` | `s.handleListChatSessions` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/chat/sessions` | `s.handleUpsertChatSession` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/stream` | `s.handleChatStream` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/chat/stream` | `s.handleChatStream` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/turns/{client_turn_id}` | `s.handleGetChatTurn` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/chat/unread` | `s.handleChatUnread` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/context/cases/recommend` | `s.handleRecommendCases` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/context/project` | `s.handleGetProjectContext` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/context/user` | `s.handleGetUserContext` | `server.go` | handler | see suite |
|
||||
| PUT | `/api/v1/context/user/preference` | `s.handleUpdateUserPreference` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/docgov/approver-decision` | `s.handleDocGovApproverDecision` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/docgov/audit-logs` | `s.handleDocGovListAuditLogs` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/docgov/claim` | `s.handleDocGovClaim` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/docgov/comments` | `s.handleDocGovListComments` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/docgov/comments` | `s.handleDocGovAddComment` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/docgov/content` | `s.handleDocGovSaveContent` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/docgov/document` | `s.handleDocGovGetDocument` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/docgov/documents/{doc_id}/content` | `s.handleDocGovGetDocumentContent` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/docgov/lease/acquire` | `s.handleDocGovAcquireLease` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/docgov/lease/heartbeat` | `s.handleDocGovHeartbeatLease` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/docgov/lease/release` | `s.handleDocGovReleaseLease` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/docgov/proposal/decide` | `s.handleDocGovDecideProposal` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/docgov/review-decision` | `s.handleDocGovReviewDecision` | `server.go` | handler | see suite |
|
||||
| POST | `/api/v1/docgov/submit-review` | `s.handleDocGovSubmitReview` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/documents/{doc_id}/agent-candidates/{candidate_id}` | `s.handleDocRevisionGetCandidate` | `document_revision_handlers.go` | session+project | see suite |
|
||||
| POST | `/api/v1/documents/{doc_id}/agent-candidates/{candidate_id}/decision` | `s.handleDocRevisionCandidateDecision` | `document_revision_handlers.go` | session+project | see suite |
|
||||
| GET | `/api/v1/documents/{doc_id}/change-reports/{report_id}` | `s.handleDocRevisionGetReport` | `document_revision_handlers.go` | session+project | see suite |
|
||||
| PATCH | `/api/v1/documents/{doc_id}/content` | `s.handleDocRevisionPatchContent` | `document_revision_handlers.go` | session+project | see suite |
|
||||
| GET | `/api/v1/documents/{doc_id}/diff` | `s.handleDocRevisionDiff` | `document_revision_handlers.go` | session+project | see suite |
|
||||
| GET | `/api/v1/documents/{doc_id}/manual-overlay` | `s.handleDocRevisionManualOverlay` | `document_revision_handlers.go` | session+project | see suite |
|
||||
| GET | `/api/v1/documents/{doc_id}/revision-state` | `s.handleDocRevisionState` | `document_revision_handlers.go` | session+project | see suite |
|
||||
| GET | `/api/v1/documents/{doc_id}/versions` | `s.handleDocRevisionListVersions` | `document_revision_handlers.go` | session+project | see suite |
|
||||
| GET | `/api/v1/documents/{doc_id}/versions/{version_no}` | `s.handleDocRevisionGetVersion` | `document_revision_handlers.go` | session+project | see suite |
|
||||
| GET | `/api/v1/freeform-documents` | `s.handleListFreeformDocs` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/freeform-documents` | `s.handleCreateFreeformDoc` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/freeform-documents/from-message` | `s.handleCreateFreeformDocFromMessage` | `server.go` | session+project | see suite |
|
||||
| DELETE | `/api/v1/freeform-documents/{doc_id}` | `s.handleDeleteFreeformDoc` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/freeform-documents/{doc_id}` | `s.handleGetFreeformDoc` | `server.go` | session+project | see suite |
|
||||
| PUT | `/api/v1/freeform-documents/{doc_id}` | `s.handleUpdateFreeformDoc` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/freeform-documents/{doc_id}/share` | `s.handleShareFreeformDoc` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/freeform-documents/{doc_id}/unshare` | `s.handleUnshareFreeformDoc` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/health` | `s.handleHealth` | `server.go` | public | see suite |
|
||||
| GET | `/api/v1/me/preferences` | `s.handleMePreferences` | `server.go` | handler | see suite |
|
||||
| PUT | `/api/v1/me/preferences` | `s.handleMePreferences` | `server.go` | handler | see suite |
|
||||
| GET | `/api/v1/me/profile` | `s.handleMeProfile` | `server.go` | handler | see suite |
|
||||
| PATCH | `/api/v1/me/profile` | `s.handleMeProfile` | `server.go` | handler | see suite |
|
||||
| PATCH | `/api/v1/notifications/{id}` | `s.handlePatchNotification` | `document_revision_handlers.go` | handler | see suite |
|
||||
| GET | `/api/v1/projects` | `s.handleListProjects` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/projects` | `s.handleCreateProject` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/projects/{id}` | `s.handleGetProjectByID` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/projects/{id}/activation-preview` | `s.handleActivationPreview` | `server.go` | session+project | see suite |
|
||||
| PUT | `/api/v1/projects/{id}/active-workflow` | `s.handleActivateWorkflow` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/projects/{id}/assets` | `s.handleListProjectAssets` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/projects/{id}/assets` | `s.handleUploadProjectAsset` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/projects/{id}/documents` | `s.handleListProjectWorkflowDocuments` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/projects/{id}/lineage` | `s.handleGetProjectLineage` | `server.go` | session+project | see suite |
|
||||
| DELETE | `/api/v1/projects/{id}/members` | `s.handleProjectMembers` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/projects/{id}/members` | `s.handleProjectMembers` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/projects/{id}/members` | `s.handleProjectMembers` | `server.go` | session+project | see suite |
|
||||
| PUT | `/api/v1/projects/{id}/members` | `s.handleProjectMembers` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/projects/{id}/notifications` | `s.handleListProjectNotifications` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/projects/{id}/settings` | `s.handleGetProjectSettings` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/projects/{id}/workflow-instances/activate` | `s.handleActivateWorkflowInstance` | `server.go` | session+project | see suite |
|
||||
| PUT | `/api/v1/projects/{id}/workflow-plan` | `s.handleSaveWorkflowPlan` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/projects/{id}/workflow-plan/default` | `s.handleGetDefaultWorkflowPlan` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/projects/{id}/workflows` | `s.handleListProjectWorkflows` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/projects/{id}/workflows/{workflow_key}/run` | `s.handleRunProjectWorkflow` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/projects/{id}/workflows/{workflow_key}/runs` | `s.handleListProjectWorkflowRuns` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/ready` | `s.handleReadiness` | `server.go` | public | see suite |
|
||||
| POST | `/api/v1/tasks/run` | `s.handleRunTask` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/tasks/run/stream` | `s.handleRunTaskStream` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/tasks/run/stream` | `s.handleRunTaskStream` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/tasks/runs` | `s.handleCreateTaskRun` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/tasks/runs/{run_id}` | `s.handleGetTaskRun` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/tasks/runs/{run_id}/cancel` | `s.handleCancelTaskRun` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/tasks/runs/{run_id}/events` | `s.handleTaskRunEvents` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/tasks/runs/{run_id}/resume` | `s.handleResumeTaskRun` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/workflow-instances/{id}` | `s.handleGetWorkflowInstance` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/workflow-instances/{id}/stages/{stage}/advance` | `s.handleAdvanceStage` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/workflow-instances/{id}/stages/{stage}/readiness` | `s.handleGetStageReadiness` | `server.go` | session+project | see suite |
|
||||
| POST | `/api/v1/workflow-instances/{id}/terminate` | `s.handleTerminateWorkflowInstance` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/workflow-instances/{id}/termination-preview` | `s.handleTerminationPreview` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/workflows` | `s.handleListWorkflowDefinitions` | `server.go` | session+project | see suite |
|
||||
| GET | `/api/v1/workflows/catalog` | `s.handleWorkflowCatalog` | `server.go` | session+project | see suite |
|
||||
| GET | `/health` | `s.handleHealth` | `server.go` | public | see suite |
|
||||
| GET | `/ready` | `s.handleReadiness` | `server.go` | public | see suite |
|
||||
| * | `/sse` | `func(w http.ResponseWriter, r *http.Request` | `task_run_idempotent_sse_test.go` | handler | see suite |
|
||||
|
||||
**Total routes:** 133
|
||||
|
||||
## Session interrupt fail-closed
|
||||
|
||||
When IAM/auth store unavailable after session established, protected reads must reject (see `TestAuthStore_SessionInterruptFailClosed`).
|
||||
|
||||
## BUG-11 410 policy
|
||||
|
||||
Product decision 2026-09-16: **retain** `WORKFLOW_SWITCH_API_RETIRED` 410 when governance available; legacy path only when governance unavailable. Not a capability gap.
|
||||
+39
-13
@@ -1,19 +1,43 @@
|
||||
# 当前焦点
|
||||
|
||||
**更新**: 2026-09-16
|
||||
**production_ready**: yes(门禁 B1–B4 已签;dev/test/main `schema_version=47`。不把 fallback change report 写成完整 PI)
|
||||
**更新**: 2026-09-17
|
||||
**production_ready**: yes(门禁 B1–B4 已签;dev `schema_version=48`;test/main `schema_version=47`;goose 00048 bootstrap-fields 已在 dev 可迁移。不把 fallback change report 写成完整 PI)
|
||||
|
||||
## 焦点
|
||||
|
||||
1. **MATRIX 深度测试 + 晋升 test**:`feature/matrix-deep-test-promote-test` → `rc-v1.0.0-beta.2`
|
||||
2. **首发后 backlog**:多意图 U9–U12、软件项目自举、FAV、完整 PI change-report 叙事
|
||||
3. **MULTI-INTENT HITL**:核心 U1–U8 已合入;U9–U12 不阻塞首版
|
||||
1. **partial/deferred 全量收口**:W1–W4 **done**;W5a **done**(矩阵自举行仍 partial);W6 **shadow done**(矩阵 FAV 仍 partial);W7 **盘点 done**(矩阵 D7 仍 deferred)。晋升 `test`:`rc-v1.0.0-beta.3`
|
||||
2. **运维**:nightly `DATA_DIR=dev` 已对齐;KB 宿主机分层加载 / fail-closed **done**(`fix/kb-host-auth-layered-load`)
|
||||
3. **红线**:禁止整支 merge FAV;不默认升 `MULTI_INTENT_PLAN_TIER=full`(升 `confirm` 须 W4 闭环后独立授权);`SEMANTIC_SUMMARY_REPLACE` 不随 W2 开启;FAV live 顺序 staging→artifact→publication、每级观察窗证据驱动(下限 ≥7 天)、`FAV_DEGRADED_READ=false`;flag 默认 off;项目 143 只读
|
||||
|
||||
## 并行认领
|
||||
|
||||
| owner | task | branch | worktree | mutex | status |
|
||||
|-------|------|--------|----------|-------|--------|
|
||||
| Cursor-Auto | 2026-09-16-matrix-deep-test-promote-test | feature/matrix-deep-test-promote-test | - | infra | in_progress |
|
||||
| Cursor | 2026-09-17-leftover-hygiene | chore/leftover-hygiene-2026-09-17 | - | ops | done |
|
||||
| Cursor | 2026-09-17-w2-semantic-summary-shadow | feature/w2-semantic-summary-shadow-live | - | chat | done |
|
||||
| Cursor | 2026-09-17-w3-pi-change-report-narrative | feature/w3-pi-change-report-narrative-live | - | docgov | done |
|
||||
| Cursor | 2026-09-17-w4-multi-intent-u9-u12 | feature/w4-u9-segment-live | - | intent-plan | done |
|
||||
| Cursor | 2026-09-17-w5a-software-bootstrap-ui | feature/w5a-software-bootstrap-ui-pi | - | workflow-design | done |
|
||||
| Cursor | 2026-09-17-w6-fav-subscriber-shadow | feature/w6-fav-subscriber-shadow | - | events | done |
|
||||
| Cursor | 2026-09-17-w7-d7-inventory | feature/w7-d7-data-inventory | - | chat | done |
|
||||
| Cursor | 2026-09-17-promote-dev-to-test | feature/promote-dev-to-test-2026-09-17 | - | infra | in_progress |
|
||||
| Cursor | 2026-09-17-kb-host-auth-fix | fix/kb-host-auth-layered-load | - | infra | done |
|
||||
| Cursor | 2026-09-17-w1-ci-e2e-green-nightly | feature/w1-ci-e2e-green-nightly | - | ci | done |
|
||||
| Cline | 2026-09-16-partial-deferred-completion | docs/partial-deferred-completion-plan | - | architecture-docs | in_progress |
|
||||
| Cursor | 2026-09-16-intent-plan-playwright-dual-tab | feature/intent-plan-cards-playwright | .worktrees/feature-intent-plan-cards-playwright | web | done |
|
||||
| Cursor | 2026-09-16-full-backlog-override | docs/override-nogo-full-backlog | - | architecture-docs | done |
|
||||
| Cursor | 2026-09-16-gitea-nightly-docker-datadir | fix/gitea-nightly-docker-datadir | - | ci | done |
|
||||
| Cursor | 2026-09-16-gitea-nightly-host-tools | fix/gitea-nightly-host-tools | - | ci | done |
|
||||
| Cursor | 2026-09-16-wave-leftovers | fix/wave-leftovers-n7-playwright-dod | - | ci | done |
|
||||
| Cursor | 2026-09-16-wave3-pu6-pu8-go-no-go | feature/wave3-pu6-pu8-go-no-go | - | architecture-docs | done |
|
||||
| Cursor | 2026-09-16-wave2c-same-image-digest | feature/wave2c-same-image-digest | - | infra | done |
|
||||
| Cursor | 2026-09-16-wave2b-nightly-promotion-receipt | feature/wave2b-nightly-promotion-receipt | - | ci | done |
|
||||
| Cursor | 2026-09-16-wave2-real-pi-evidence | feature/wave2-real-pi-evidence | - | intent-plan | done |
|
||||
| Cursor | 2026-09-16-wave1-race-tempdir-cleanup | fix/race-tempdir-cleanup | - | ci | done |
|
||||
| Cursor | 2026-09-16-wave1-iam-fail-closed | fix/iam-store-fail-closed | - | authz | done |
|
||||
| Cursor | 2026-09-16-feature-matrix-wave0-calibration | feature/feature-matrix-production-readiness-plan | .worktrees/feature-matrix-production-readiness-plan | architecture-docs | done |
|
||||
| Codex | 2026-09-16-feature-matrix-production-readiness-plan | feature/feature-matrix-production-readiness-plan | .worktrees/feature-matrix-production-readiness-plan | architecture-docs | done |
|
||||
| Cursor-Auto | 2026-09-16-matrix-deep-test-promote-test | feature/matrix-deep-test-promote-test | - | infra | done |
|
||||
| Cursor-Auto | 2026-09-16-production-ready-gates | docs/production-ready-flip | - | ci | done |
|
||||
| Cursor-Auto | 2026-09-16-demo-seed-pollution | fix/demo-data-pollution-web | - | web | done |
|
||||
| Cursor | 2026-09-16-multi-intent-u8-task-generate | feature/multi-intent-u8-task-generate | - | intent-plan | done |
|
||||
@@ -89,13 +113,13 @@
|
||||
|
||||
> workflow-plan 409 与治理鉴权 G1–G5 已收口(见 [test-report](../test-reports/2026-09-14-governance-action-level-authz-test-report.md))。禁止终止或改写项目 143。
|
||||
> `document-reliability-pilot` U11–U12 已合入 `dev@bf59cce` 并 rebuild。`CHAT-INTENT-STATE` 双标签 busy 已 PASS(项目 6275)。禁止 worktree 内 `env-service`。项目 143 只读,禁止终止。
|
||||
> 2026-09-15 旁支清理:[报告](../test-reports/2026-09-15-leftover-branch-cleanup-test-report.md)。已合入本地旁支 31 条已 `git branch -d`;7 个对应 worktree 已拆。extra worktree 仅余 `.worktrees/fix-dev-runtime-data-root-guard`(目录名是 guard,检出的是 `feature/final-artifact-vault`)。**故意不合入、不删**:`feature/final-artifact-vault`、`feature/remove-herdr-agent-settings`、`fix/project143-controlled-content-404-diagnosis`、`fix/dev-runtime-data-root-guard`、`dev-old-linear`。不删 `origin/*`。不整支 merge FAV;不启用 `FAV_DEGRADED_READ`。
|
||||
> 2026-09-17 leftover 二次收口:[报告](../test-reports/2026-09-17-leftover-hygiene-test-report.md)。已合入 leftover worktree/旁支再拆一轮;`feature/software-project-bootstrap` L1 已在 `dev`(残留关闭 commit 已丢弃)。`fix/clean-test-env-baseline` **不 merge**(前端 demo 清理已放弃;仅保留已挑拣的 `SEED_DEMO_USERS=false`)。extra worktree 仅余 `.worktrees/fix-dev-runtime-data-root-guard`(目录名是 guard,检出的是 `feature/final-artifact-vault`)。**故意不合入、不删**:`feature/final-artifact-vault`、`feature/remove-herdr-agent-settings`、`fix/project143-controlled-content-404-diagnosis`、`fix/dev-runtime-data-root-guard`、`dev-old-linear`。不删 `origin/*`。不整支 merge FAV;不启用 `FAV_DEGRADED_READ`。
|
||||
|
||||
## 集成槽位
|
||||
|
||||
| holder | phase | since | scope | queue |
|
||||
|--------|-------|-------|-------|-------|
|
||||
| Cursor-Auto | merging | 2026-09-16T13:20Z | matrix deep test → promote rc-v1.0.0-beta.2 + test rebuild | - |
|
||||
| Cursor | merging | 2026-09-17 | promote dev → test rc-v1.0.0-beta.3 | - |
|
||||
|
||||
**phase**: `idle` | `merging` | `smoke` | `e2e`
|
||||
|
||||
@@ -105,8 +129,8 @@
|
||||
|
||||
| 环境 | 端口 | schema | 状态 |
|
||||
|------|------|--------|------|
|
||||
| dev | 8080 | **47** | healthy(`pi-agent` typed-result-v1;events worker `:8088`;notify/advance/projection live、fav off;health+ready PASS;demo 6001–6010 retired) |
|
||||
| test | 8081 | **47** | healthy(`rc-v1.0.0-beta.1`;pi-agent `:18866`;events `:8089`;notify/advance/projection live、fav off;health+ready PASS;schema 与 dev 对齐 47) |
|
||||
| dev | 8080 | **48** | healthy(`pi-agent` typed-result-v1;events worker `:8088`;notify/advance/projection live、fav off;health+ready PASS;demo 6001–6010 retired) |
|
||||
| test | 8081 | **47** | healthy(`rc-v1.0.0-beta.2`;pi-agent `:18866`;events `:8089`;notify/advance/projection live、fav off;health+ready PASS;矩阵深度测试 live 项目 3 PASS) |
|
||||
| main | 8000 | **47** | healthy(app + events + runner + DB;与 dev/test 对齐) |
|
||||
|
||||
## SSOT
|
||||
@@ -114,9 +138,11 @@
|
||||
| 类型 | 路径 |
|
||||
|------|------|
|
||||
| 文档总地图 | [../README.md](../README.md) |
|
||||
| 模块完成度 | [FEATURE-MATRIX](../status/FEATURE-MATRIX.md) |
|
||||
| 发布缺口 | [gap-matrix](../remediation/gap-matrix.md) |
|
||||
| 模块完成度 | [FEATURE-MATRIX](../status/FEATURE-MATRIX.md)(Wave 0 已校准契约与冻结边界) |
|
||||
| 发布缺口 | [gap-matrix](../remediation/gap-matrix.md)(`production_ready=yes`;Wave 0 IAM 只读未发现旁路) |
|
||||
| 连续性审计/计划 | [audit](../audit/2026-09-16-feature-matrix-production-readiness-audit.md) · [remediation](../remediation/2026-09-16-feature-matrix-production-readiness-plan.md) · [Wave 0 任务](./short-term/2026-09-16-feature-matrix-wave0-calibration.md) |
|
||||
| 测试报告 | [test-reports/](../test-reports/) |
|
||||
| D7 盘点(W7) | [audit](../audit/2026-09-17-d7-data-inventory.md) · [报告](../test-reports/2026-09-17-w7-d7-inventory-test-report.md) · ADR 仍 `pending-compliance-signoff` |
|
||||
| Agent 手册 | [AGENTS.md](../../AGENTS.md) |
|
||||
| 意图双标签 busy 交接 | [./handoffs/2026-09-15-conversation-intent-dual-tab.md](./handoffs/2026-09-15-conversation-intent-dual-tab.md) |
|
||||
| 受控正文 hash 漂移 W1–W6 | [../ops/handoffs/2026-09-14-controlled-content-canonical-hash.md](../ops/handoffs/2026-09-14-controlled-content-canonical-hash.md) |
|
||||
@@ -146,7 +172,7 @@
|
||||
| 文档可靠性 M5/M6 U11–U12 | [../test-reports/2026-09-15-app-composition-u11-u12-test-report.md](../test-reports/2026-09-15-app-composition-u11-u12-test-report.md) |
|
||||
| Track E E2 闭包守卫 | [../test-reports/2026-09-15-event-e2-hook-guard-test-report.md](../test-reports/2026-09-15-event-e2-hook-guard-test-report.md) |
|
||||
| Track E 复盘 | [./research/2026-09-15-track-e-retrospective.md](./research/2026-09-15-track-e-retrospective.md) |
|
||||
| 旁支清点收口 | [../test-reports/2026-09-15-leftover-branch-cleanup-test-report.md](../test-reports/2026-09-15-leftover-branch-cleanup-test-report.md) |
|
||||
| 旁支清点收口 | [../test-reports/2026-09-15-leftover-branch-cleanup-test-report.md](../test-reports/2026-09-15-leftover-branch-cleanup-test-report.md) · [二次收口](../test-reports/2026-09-17-leftover-hygiene-test-report.md) |
|
||||
| SSE/幂等审计 | [../audit/2026-09-13-document-revision-sse-idempotency.md](../audit/2026-09-13-document-revision-sse-idempotency.md) |
|
||||
| 质量门禁自污染审计 | [../audit/2026-09-13-document-revision-quality-gate-self-pollution.md](../audit/2026-09-13-document-revision-quality-gate-self-pollution.md) |
|
||||
| 当前文档路由审计 | [../audit/2026-09-13-document-revision-active-doc-routing.md](../audit/2026-09-13-document-revision-active-doc-routing.md) |
|
||||
|
||||
@@ -0,0 +1,66 @@
|
||||
---
|
||||
title: "Wave 0 FEATURE-MATRIX 校准完成 → 待合 dev / Wave 1"
|
||||
created: 2026-09-16
|
||||
from: Cursor
|
||||
to: next-agent
|
||||
status: done
|
||||
---
|
||||
|
||||
# 交接:FEATURE-MATRIX Wave 0 完成后
|
||||
|
||||
## 目标(下一位 Agent 应完成什么)
|
||||
|
||||
1. 开启 **Wave 1**:PU3 IAM fail-closed + PU5A TempDir race flake(独立 `fix/*` / `feature/*`,分 mutex `authz` / `ci`)。
|
||||
2. 勿把 Wave 0 的 `done` 行当作真实 PI 补证已完成;U8 / full-none 仍归 Wave 2。
|
||||
|
||||
## 已完成
|
||||
|
||||
- PU1:FEATURE-MATRIX 状态契约、行模板、status README
|
||||
- PU2:按冻结边界收口 L1 / Chat baseline / DocRev baseline / 前端 / 可靠事件;拆出 D3、D7、PI 叙事、U9–U12、FAV、artifact promotion
|
||||
- 修正漂移:schema 47、D3≠D5、IAM 历史缺口文案、事件与 FAV 拆行
|
||||
- 历史指针:multi-intent 设计、Phase2 remediation、HTTP envelope、Track E 复盘
|
||||
- IAM 只读核验:dev/test/main schema 47、IAM 表齐全、`ALLOW_IN_MEMORY=false`;**未**证实 MemoryStore 旁路 → **保持** `production_ready=yes`,未新增 gap-matrix blocker
|
||||
- 文档已 `--no-ff` 合入 `dev`;**未** push
|
||||
|
||||
## 未完成
|
||||
|
||||
- Wave 1+(IAM 代码 fail-closed、race、真实 PI 补证、nightly/receipt)
|
||||
|
||||
## 认领 / 槽位状态
|
||||
|
||||
| 项 | 值 |
|
||||
|----|-----|
|
||||
| mutex 已释放 | yes |
|
||||
| 集成槽位 holder | idle(合入后已释放) |
|
||||
| branch | 已合入 `dev`(merge commit) |
|
||||
| worktree | `.worktrees/feature-matrix-production-readiness-plan`(可移除) |
|
||||
|
||||
## 关键文件
|
||||
|
||||
| 路径 | 说明 |
|
||||
|------|------|
|
||||
| `.doc/status/FEATURE-MATRIX.md` | 校准后能力矩阵 |
|
||||
| `.doc/ops/short-term/2026-09-16-feature-matrix-wave0-calibration.md` | Wave 0 任务与 IAM 证据 |
|
||||
| `.doc/remediation/2026-09-16-feature-matrix-production-readiness-plan.md` | 五波总计划 |
|
||||
| `.doc/audit/2026-09-16-feature-matrix-production-readiness-audit.md` | 审计 |
|
||||
| `.doc/remediation/gap-matrix.md` | 仅增加 Wave 0 核验注记;`production_ready=yes` |
|
||||
|
||||
## 如何验证
|
||||
|
||||
```bash
|
||||
# 在 worktree
|
||||
git diff --check
|
||||
# 人工对账 FEATURE-MATRIX / CURRENT / gap-matrix 叙事一致
|
||||
# IAM 只读证据见 short-term「证据 / 备注」
|
||||
```
|
||||
|
||||
## 风险 / Blocker
|
||||
|
||||
- `store_factory.go` 仍可能在缺表时 silent MemoryStore → Wave 1 必须 fail-closed;当前部署未触发。
|
||||
- 合入前确认主仓 CURRENT 与 worktree 无冲突(主仓可能另有 matrix-deep-test 认领行)。
|
||||
|
||||
## 相关链接
|
||||
|
||||
- CURRENT: [CURRENT.md](../CURRENT.md)
|
||||
- Task: [../short-term/2026-09-16-feature-matrix-wave0-calibration.md](../short-term/2026-09-16-feature-matrix-wave0-calibration.md)
|
||||
- Remediation: [../../remediation/2026-09-16-feature-matrix-production-readiness-plan.md](../../remediation/2026-09-16-feature-matrix-production-readiness-plan.md)
|
||||
@@ -0,0 +1,41 @@
|
||||
---
|
||||
title: "Gitea nightly secrets 已本机配置"
|
||||
created: 2026-09-16
|
||||
from: Cursor
|
||||
to: any
|
||||
blocker: false
|
||||
---
|
||||
|
||||
# Gitea nightly secrets 已本机配置
|
||||
|
||||
## 已配置(weichen/Agent-System)
|
||||
|
||||
**Secrets**(API,值不入库):
|
||||
|
||||
- `RUNNER_AUTH_TOKEN` ← `configs/.env.dev`
|
||||
- `NIGHTLY_TEST_DATABASE_URL` → `127.0.0.1:5434/agent_wave2_pi`
|
||||
|
||||
**Variables**:
|
||||
|
||||
- `PI_AGENT_RUNNER_URL=http://127.0.0.1:18865`
|
||||
- `PI_AGENT_MODEL` ← `.env.dev` MINIMAX_MODEL_ID
|
||||
|
||||
## Runner(本机 `/home/weichen/gitea`)
|
||||
|
||||
- label:`nightly:host`(写入 `runner/data/.runner`,勿只改 compose)
|
||||
- `network_mode: host` + `address=http://127.0.0.1:3000`(PI 只绑 `127.0.0.1:18865`,bridge 不可达)
|
||||
- 挂载 brew + 宿主机 glibc + `/usr/bin/docker` + `/host-agent-data`(仓库 `data/`)
|
||||
- workflow:`DATA_DIR=/host-agent-data/test`;artifact 用本地 tar(Gitea 不支持 upload-artifact@v4)
|
||||
- `run-nightly-real-pi.sh`:全 SKIP / 镜像构建失败 → `infra_fail` receipt(不再 silent exit 127)
|
||||
|
||||
## 验证
|
||||
|
||||
- run#15:缺 node → FAIL
|
||||
- run#17:checkout/setup-go PASS;curl 缺失 → `infra_fail`;upload-artifact@v4 → GHESNotSupported
|
||||
- run#19:curl/PI OK;缺 docker + 无 DATA_DIR → SKIP 后 exit 127、无 receipt
|
||||
- run#21:DATA_DIR+docker OK;用例真实执行;receipt=`product_fail`;archive/summarize PASS
|
||||
(产品失败属套件本身,非 runner/secrets 配置问题)
|
||||
|
||||
## 触发
|
||||
|
||||
Gitea Actions → Nightly Real PI → Run workflow;或 schedule UTC 16:00。
|
||||
@@ -0,0 +1,33 @@
|
||||
---
|
||||
title: "Phase 3 遗留清点收口"
|
||||
created: 2026-09-16
|
||||
from: Cursor
|
||||
to: any
|
||||
blocker: false
|
||||
---
|
||||
|
||||
# Phase 3 遗留清点收口
|
||||
|
||||
## 已关闭本轮
|
||||
|
||||
| 项 | 处置 |
|
||||
|----|------|
|
||||
| N7 U8 `quality_failed` 偶发 | `run-nightly-real-pi.sh` 对 quality_failed 全文重试一次;仍失败则 `product_fail`(非 PASS)。根因:模型质量门,非 secret/runner。 |
|
||||
| Playwright intent-plan 双标签 | 正式长期 gated + long-term 契约;矩阵关闭条件写死 |
|
||||
| Wave3 PU6–PU8 | 已 no-go(Phase 2) |
|
||||
| Artifact same-image | Wave2C done |
|
||||
|
||||
## 保留开放(需产品/另任务,不假装 done)
|
||||
|
||||
| 项 | 说明 |
|
||||
|----|------|
|
||||
| IAM 全路由 inventory | 仍开放;fail-closed 核心已签 |
|
||||
| session 中断负例 / 410 退役 | 需产品拍板 |
|
||||
| R13 全量清单勾选 | nightly 脱敏证据路径已有;完整 R13 矩阵另开 audit |
|
||||
| deterministic/B1–B4 持续回归 | 合入冒烟覆盖 short;全量门禁保持现有 CI |
|
||||
| FAV / 旁支分支 | CURRENT 已声明故意不合入 |
|
||||
|
||||
## 下一步
|
||||
|
||||
- 配置 Actions `RUNNER_AUTH_TOKEN` + `NIGHTLY_TEST_DATABASE_URL` 使 nightly 真跑
|
||||
- 获批后按 long-term 契约开 PU6–PU8 / Playwright 实现任务
|
||||
@@ -1,8 +1,8 @@
|
||||
---
|
||||
title: "纯软件项目自举工作流实施"
|
||||
status: planned
|
||||
status: in_progress
|
||||
created: 2026-09-14
|
||||
updated: 2026-09-14
|
||||
updated: 2026-09-17
|
||||
---
|
||||
|
||||
# 纯软件项目自举工作流实施
|
||||
@@ -22,6 +22,19 @@ updated: 2026-09-14
|
||||
- 真实 PI 和 Ubuntu 无头浏览器黄金项目验收通过;
|
||||
- 未实现受控代码执行前,系统不会直接修改项目仓库。
|
||||
|
||||
## 实施进度(2026-09-17)
|
||||
|
||||
| Epic | 状态 | 说明 |
|
||||
|------|------|------|
|
||||
| SWBOOT-00 | done(契约) | ADR `.doc/adr/2026-09-16-software-project-bootstrap-keys.md` |
|
||||
| SWBOOT-01 | done(迁移) | goose `00048` additive;已合 `dev` |
|
||||
| SWBOOT-02..04 | done(L1) | manifests + catalog 五 key;医疗三门禁保留;已合 `dev`(`f0029df`) |
|
||||
| SWBOOT-05..08 | done(W5a) | catalog 驱动创建向导;软件不克隆医疗 7 模板;solo 未独立评审标注 |
|
||||
| SWBOOT-09 | partial | docs_only 真实 PI 已出;无头浏览器全向导仍 NOT RUN |
|
||||
| SWBOOT-10 | stub only | allowlist + fail-closed;真 patch/merge 归 W5b,本轮不实施 |
|
||||
|
||||
L1(SWBOOT-00…09 契约/迁移/目录钩子 + SWBOOT-10 stub)**已合入 `dev`**。后续由 [partial/deferred W5](../short-term/2026-09-16-partial-deferred-completion.md) 承接:W5a = UI + `docs_only` 真实 PI;W5b = 受控执行器(独立安全评审)。
|
||||
|
||||
## 实施拆分
|
||||
|
||||
| Epic | 范围 | 依赖 | 验收 |
|
||||
@@ -46,9 +59,9 @@ updated: 2026-09-14
|
||||
- 文档版本运行时 Round20 能力作为文档链基线;
|
||||
- 用户确认首期执行模式及 solo/collaborative 策略。
|
||||
|
||||
## 暂不启动原因
|
||||
## 剩余工作
|
||||
|
||||
本轮用户要求先梳理和制定详细方案;业务代码、迁移、模板和智能体配置尚未授权进入实施。本任务保持 `planned`,启动时须从 `dev` 新建独立 feature 分支,并在 CURRENT 认领 `workflow-design`/相应拆分 mutex。
|
||||
L1 已合 `dev`。W5a 从 `dev` 开 `feature/w5a-software-bootstrap-ui-pi`(mutex `workflow-design`)。W5b 受控执行器未启动,SWBOOT-10 保持 fail-closed stub。
|
||||
|
||||
## 相关链接
|
||||
|
||||
|
||||
@@ -0,0 +1,27 @@
|
||||
---
|
||||
title: "Playwright intent-plan 双标签 — 长期 gated"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor-Auto
|
||||
branch: feature/intent-plan-cards-playwright
|
||||
mutex: web
|
||||
---
|
||||
|
||||
# Playwright intent-plan 双标签 — 长期 gated
|
||||
|
||||
## 现状
|
||||
|
||||
- short-term / 报告已关闭:见 [../short-term/2026-09-16-intent-plan-playwright-dual-tab.md](../short-term/2026-09-16-intent-plan-playwright-dual-tab.md) 与 [../../test-reports/2026-09-16-intent-plan-playwright-dual-tab-test-report.md](../../test-reports/2026-09-16-intent-plan-playwright-dual-tab-test-report.md)
|
||||
- `RUN_UI_ACCEPTANCE=1` 真浏览器 PASS(Docker Playwright);默认 skip
|
||||
- **不升** `MULTI_INTENT_PLAN_TIER`
|
||||
|
||||
## 关闭条件
|
||||
|
||||
1. 独立 short-term + `RUN_UI_ACCEPTANCE=1` 真浏览器:双标签 confirm 不同时本地成功
|
||||
2. 刷新/重登后与 PG plan 一致
|
||||
3. 报告归档 `.doc/test-reports/`;不升 MULTI_INTENT tier
|
||||
|
||||
## 非目标
|
||||
|
||||
- 用 stub/SKIP 冒充 PASS
|
||||
@@ -0,0 +1,33 @@
|
||||
---
|
||||
title: "PU6 语义摘要 D3 — 获批后任务契约"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w2-semantic-summary-shadow-live
|
||||
mutex: chat
|
||||
go_no_go: go
|
||||
---
|
||||
|
||||
# PU6 语义摘要 D3 — 获批后任务契约
|
||||
|
||||
**go/no-go**:GO。脚手架 + W2 live 已合 `dev`。`SEMANTIC_SUMMARY_SHADOW` 默认 off;开 flag 时组合根注入产品 PI no-tool summarizer。**不启用** `SEMANTIC_SUMMARY_REPLACE`。
|
||||
|
||||
## 目标
|
||||
|
||||
在授权可见集合上 shadow 语义摘要,可解释 fallback;REPLACE 为后置独立授权任务。
|
||||
|
||||
## 预注册门
|
||||
|
||||
- flag:`SEMANTIC_SUMMARY_SHADOW` → 可选 `SEMANTIC_SUMMARY_REPLACE`(本轮不启用)
|
||||
- 输入:authorized view only;无工具权限摘要器;R13 出站门
|
||||
- 失败:保留旧摘要/deterministic;标注 freshness
|
||||
- 负例:撤权消息不入摘要;injection 不能改权限
|
||||
|
||||
## 路径提示
|
||||
|
||||
`internal/ctxmgr/summarizer.go`、`internal/ctxmgr/semantic_summary.go`、`internal/app/chatflow/`、`internal/server/chat_digest_api.go`、`internal/agent/piagent.go`
|
||||
|
||||
## 回滚
|
||||
|
||||
关 flag;读路径回 deterministic;保留历史证据指针
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: "PU7 PI change-report 叙事 — 获批后任务契约"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-17
|
||||
owner: Cursor-Auto
|
||||
branch: feature/pu7-pi-narrative
|
||||
mutex: docgov
|
||||
go_no_go: go
|
||||
---
|
||||
|
||||
# PU7 PI change-report 叙事 — 获批后任务契约
|
||||
|
||||
**go/no-go**:GO(用户覆盖授权,见 Wave3 research)。脚手架已合 `dev`;W3 live(产品 PI + digest 绑定)已接线,默认 flag 仍 off。
|
||||
|
||||
## 目标
|
||||
|
||||
只读消费 immutable diff+lineage+risk floor 的 PI 叙事;任意 schema/超时/注入 → 全量 fallback。
|
||||
|
||||
## 预注册门
|
||||
|
||||
- flag:`PI_CHANGE_REPORT_NARRATIVE`(默认 off)
|
||||
- 禁止覆盖服务端风险/审批结论
|
||||
- typed schema + input digest 绑定(`change_report_narrative_v1`)
|
||||
- UI 明确区分 narrative vs 事实字段
|
||||
|
||||
## 路径
|
||||
|
||||
- `internal/docrevision/flags.go` / `narrative.go` / `service.go`
|
||||
- `deploy/pi-agent/change-report-narrative-v1.mjs`
|
||||
- `web/.../ChangeReportPanel.tsx` / `changeReportView.ts`
|
||||
- 报告:[../../test-reports/2026-09-16-pu7-pi-narrative-test-report.md](../../test-reports/2026-09-16-pu7-pi-narrative-test-report.md)
|
||||
- W3 live:[../../test-reports/2026-09-17-w3-pi-change-report-narrative-test-report.md](../../test-reports/2026-09-17-w3-pi-change-report-narrative-test-report.md)
|
||||
- short-term:[../short-term/2026-09-17-w3-pi-change-report-narrative.md](../short-term/2026-09-17-w3-pi-change-report-narrative.md)
|
||||
|
||||
## 回滚
|
||||
|
||||
关 flag;仅 deterministic fallback;无第二份 candidate
|
||||
@@ -0,0 +1,19 @@
|
||||
---
|
||||
title: "PU8-U10 mutate — 获批后任务契约"
|
||||
status: in_progress
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w4-u9-segment-live
|
||||
mutex: intent-plan
|
||||
go_no_go: go
|
||||
flag: MULTI_INTENT_U10_MUTATE
|
||||
---
|
||||
|
||||
# PU8-U10 mutate
|
||||
|
||||
**go/no-go**:GO(覆盖授权)。独立 flag 脚手架已合 `dev`。W4:dry-run→confirm 幂等 receipt 证据;mutex `intent-plan`。不升 `MULTI_INTENT_PLAN_TIER`。报告:[../../test-reports/2026-09-17-w4-u10-mutate-test-report.md](../../test-reports/2026-09-17-w4-u10-mutate-test-report.md)
|
||||
|
||||
## 负例
|
||||
|
||||
未确认、越权、stale revision、重复提交 → 零越界副作用。
|
||||
@@ -0,0 +1,15 @@
|
||||
---
|
||||
title: "PU8-U11 docgov action — 获批后任务契约"
|
||||
status: in_progress
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w4-u9-segment-live
|
||||
mutex: intent-plan
|
||||
go_no_go: go
|
||||
flag: MULTI_INTENT_U11_DOCGOV
|
||||
---
|
||||
|
||||
# PU8-U11 docgov
|
||||
|
||||
**go/no-go**:GO(覆盖授权)。独立 flag 脚手架已合 `dev`。W4:项目 143 只读 fail-closed。mutex `intent-plan`。报告:[../../test-reports/2026-09-17-w4-u11-docgov-test-report.md](../../test-reports/2026-09-17-w4-u11-docgov-test-report.md)
|
||||
@@ -0,0 +1,15 @@
|
||||
---
|
||||
title: "PU8-U12 workflow/run-control — 获批后任务契约"
|
||||
status: in_progress
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w4-u9-segment-live
|
||||
mutex: intent-plan
|
||||
go_no_go: go
|
||||
flag: MULTI_INTENT_U12_RUN_CONTROL
|
||||
---
|
||||
|
||||
# PU8-U12 workflow/run-control
|
||||
|
||||
**go/no-go**:GO(覆盖授权)。独立 flag 脚手架已合 `dev`。W4:独立 flag dry-run 证据。不升 `MULTI_INTENT_PLAN_TIER`。报告:[../../test-reports/2026-09-17-w4-u12-run-control-test-report.md](../../test-reports/2026-09-17-w4-u12-run-control-test-report.md)
|
||||
@@ -0,0 +1,19 @@
|
||||
---
|
||||
title: "PU8-U9 segment proposal — 获批后任务契约"
|
||||
status: in_progress
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w4-u9-segment-live
|
||||
mutex: intent-plan
|
||||
go_no_go: go
|
||||
flag: MULTI_INTENT_U9_SEGMENT
|
||||
---
|
||||
|
||||
# PU8-U9 segment proposal
|
||||
|
||||
**go/no-go**:GO(覆盖授权)。flag 脚手架已合 `dev`。W4:真实 LLM proposer;规则能判断则不出 proposal。不升 `MULTI_INTENT_PLAN_TIER`。报告:[../../test-reports/2026-09-17-w4-u9-segment-test-report.md](../../test-reports/2026-09-17-w4-u9-segment-test-report.md)
|
||||
|
||||
## 安全 stop gate
|
||||
|
||||
授权旁路 / 跨用户泄漏 / B1–B4 回归 → 停全部扩面并写 gap-matrix。
|
||||
@@ -1,12 +1,15 @@
|
||||
---
|
||||
title: "Track E 持久事件交付复盘"
|
||||
created: 2026-09-15
|
||||
updated: 2026-09-16
|
||||
status: done
|
||||
confidence: high
|
||||
---
|
||||
|
||||
# 调研:Track E 持久事件交付复盘
|
||||
|
||||
> **Superseded 指针(2026-09-16)**:共享 notify/advance/projection 已 live;生产闭包 hook 已退出;`DOC-RELIABILITY-PILOT` 在 gap-matrix 为 PASS。可靠事件核心见 [FEATURE-MATRIX](../../status/FEATURE-MATRIX.md) `done`;FAV 仍 `deferred`。下文「共享 off / OPEN」为复盘当时快照,勿作 live status。
|
||||
|
||||
## 结论
|
||||
|
||||
E0A–E1C 已在隔离库证明:领域变化、envelope、delivery 同 UoW;PG dispatcher 原子 lease/fencing;notify / workflow_advance / projection 各自 exactly-one visible outcome。共享集群消费者保持 **off**,HTTP 闭包仍是唯一真实写者。E2 已部署兼容守卫:消费者 `live` 时闭包停写,`off`/`shadow` 时闭包继续写。删除 `OnOutbox` / `AddOnApprovedHook` 必须等 live 发布窗口;当前删除会让 notify/advance 停写。`DOC-RELIABILITY-PILOT` 保持 OPEN。FAV 保持 disabled。
|
||||
@@ -21,12 +24,13 @@ E0A–E1C 已在隔离库证明:领域变化、envelope、delivery 同 UoW;P
|
||||
| E1B | [E1B 报告](../../test-reports/2026-09-15-event-e1b-workflow-advance-test-report.md) | 隔离库 unique stage-ready PASS;共享 off |
|
||||
| E1C | [E1C 报告](../../test-reports/2026-09-15-event-e1c-projection-test-report.md) | no-replace PASS;共享 off |
|
||||
| E2 | [E2 报告](../../test-reports/2026-09-15-event-e2-hook-guard-test-report.md) | live 停写;off/shadow 仍写;API 保留 |
|
||||
| Shared live(后续) | [notify](../../test-reports/2026-09-15-event-notify-shared-live-test-report.md) · [advance](../../test-reports/2026-09-15-event-workflow-advance-shared-live-test-report.md) · [projection](../../test-reports/2026-09-15-event-projection-shared-live-test-report.md) | 共享 live PASS(后于本复盘) |
|
||||
|
||||
## 开放问题
|
||||
## 开放问题(复盘当时;2026-09-16 状态)
|
||||
|
||||
- 共享环境尚未做 notify/advance/projection 的 live 切换与授权页刷新纵切,因此 Track E DoD 中「生产注册无 OnOutbox=」与「授权 UI 三类重启」未关闭。
|
||||
- 历史 inventory 的 repair/quarantine 真实批量审批未在共享库演练。
|
||||
- FAV 仍只预留 disabled 契约。
|
||||
- ~~共享环境尚未做 live~~ → **已关闭**(shared live 报告)。
|
||||
- 历史 inventory 的 repair/quarantine 真实批量审批未在共享库演练(仍开放,非发布 blocker)。
|
||||
- FAV 仍只预留 disabled 契约(FEATURE-MATRIX `deferred`)。
|
||||
|
||||
## 建议动作
|
||||
|
||||
|
||||
@@ -0,0 +1,57 @@
|
||||
---
|
||||
title: "Wave 3 PU6–PU8 产品 go/no-go"
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
status: done
|
||||
confidence: high
|
||||
---
|
||||
|
||||
# 调研:Wave 3 PU6–PU8 产品 go/no-go
|
||||
|
||||
## 结论
|
||||
|
||||
**2026-09-16 用户授权覆盖**:选择全量 backlog 范围 **3(A+B)**,**PU6 / PU7 / PU8 / Playwright 双标签 / 软件自举 / FAV 增量 一律 GO(进入实施)**。
|
||||
|
||||
- 仍 **不** 默认升 `MULTI_INTENT_PLAN_TIER=full`;升 tier 另开任务。
|
||||
- 新能力默认 **flag off / shadow**;获证据后再独立开 flag。
|
||||
- 样本门槛豁免:用隔离合成会话替代 ≥20 痛点样本(owner=工程执行方 Cursor,授权记录见 short-term 总控)。
|
||||
|
||||
历史 no-go 记录保留于本文「历史结论」;实施以本节为准。
|
||||
|
||||
## 冻结字段(覆盖后)
|
||||
|
||||
| 字段 | 本轮取值 |
|
||||
|------|----------|
|
||||
| 用户信号 | **覆盖授权**:产品明确要求全量实施 |
|
||||
| 预期收益 | 体验增强 + 工程闭环;非 gap-matrix 首发 blocker |
|
||||
| 维护成本 | 高(真实 PI、R13、shadow、泄漏负例、回滚) |
|
||||
| owner | Cursor(工程)+ 用户授权 |
|
||||
| 最小样本 | **豁免**:隔离合成会话 + 负例矩阵 |
|
||||
| 晋级阈值 | 各契约预注册;未达则保持 shadow/off |
|
||||
| 零容忍失败 | 授权旁路、跨用户泄漏、双 writer、B1–B4 回归、敏感出站 |
|
||||
|
||||
## 分项决定
|
||||
|
||||
### PU6 语义摘要(D3)— **GO / planned**
|
||||
|
||||
- 契约:`.doc/ops/long-term/2026-09-16-pu6-semantic-summary-contract.md`
|
||||
- Flag:`SEMANTIC_SUMMARY_SHADOW`(默认 off)
|
||||
|
||||
### PU7 PI change-report 叙事 — **GO / planned**
|
||||
|
||||
- 契约:`.doc/ops/long-term/2026-09-16-pu7-pi-narrative-contract.md`
|
||||
- Flag:`PI_CHANGE_REPORT_NARRATIVE`(默认 off)
|
||||
|
||||
### PU8 多意图扩面(U9 / U10–U12)— **GO / planned(分项独立 flag)**
|
||||
|
||||
- 禁止共用一个开关批量上线;顺序 U9→U10→U11→U12。
|
||||
- 契约见 long-term `pu8-u9`…`pu8-u12`。
|
||||
|
||||
## 历史结论(2026-09-16 初版,已覆盖)
|
||||
|
||||
初版在缺少痛点样本与 owner 签字下为 **no-go / deferred**。已被本节用户授权覆盖;勿回退为实施禁令。
|
||||
|
||||
## 建议动作
|
||||
|
||||
- [x] 产品 go/no-go(覆盖授权)
|
||||
- [ ] 按 short-term `2026-09-16-full-backlog-override.md` 实施 P1–P7
|
||||
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: "FAV U7 增量合入(非整支 merge)"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor
|
||||
branch: feature/fav-u7-publisher
|
||||
worktree: ".worktrees/feature-fav-u7-publisher"
|
||||
mutex: events
|
||||
---
|
||||
|
||||
# FAV U7 增量合入
|
||||
|
||||
## 目标
|
||||
|
||||
从 `feature/final-artifact-vault` **手工移植**经审计切片到 `dev`;consumer 默认 off;禁止整支 merge;禁止默认开 `FAV_DEGRADED_READ`。
|
||||
|
||||
## 范围
|
||||
|
||||
- 配置门闩(`FAV_DEGRADED_READ` / `FAV_PUBLISHER_ENABLED` 默认 false)
|
||||
- HTTP `GET /api/v1/vault/status` + gated in-process publisher stub
|
||||
- `internal/app/fav` durable subscriber stub(不注册到 cmd/events)
|
||||
- `cmd/artifact-vault` status stub(完整 CLI 未移植)
|
||||
|
||||
## 非目标
|
||||
|
||||
- 整支 merge `feature/final-artifact-vault`
|
||||
- 未审计启用 degraded read / fav live / publisher production Drain
|
||||
- 移植 enumerate / TerminalRow Backfill / OnFinalArtifact hooks
|
||||
- 合入 `dev`(本切片仅 feature 推送)
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 审计 FAV vs `dev` artifactvault 冲突(多数 DIFF → 改 stub)
|
||||
2. [x] 落地 stub + 默认 off 测试
|
||||
3. [x] go/no-go 报告
|
||||
4. [x] 推送 `feature/fav-u7-publisher`(不合 dev)
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] fav consumer / Register 仍 fail-closed
|
||||
- [x] `FAV_DEGRADED_READ` 默认 false
|
||||
- [x] 测试报告含 NO-GO:subscriber 保持 OFF 直至单独审批
|
||||
- [x] 已 push 远端 feature 分支
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Test report: [.doc/test-reports/2026-09-16-fav-u7-incremental-test-report.md](../../test-reports/2026-09-16-fav-u7-incremental-test-report.md)
|
||||
- Assets: [.doc/test-reports/assets/2026-09-16-fav-u7-incremental/](../../test-reports/assets/2026-09-16-fav-u7-incremental/)
|
||||
- Remote: `origin/feature/fav-u7-publisher`
|
||||
|
||||
## 证据 / 备注
|
||||
|
||||
因 `internal/artifactvault` 与 FAV 旁支大面积分叉,未 cherry-pick 核心库;采用最小可编译、默认关闭的 publisher/HTTP/CLI stub。commits: `3478a5a..de65cee`。
|
||||
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: "FEATURE-MATRIX production-ready 连续性审计与完善计划"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Codex
|
||||
branch: feature/feature-matrix-production-readiness-plan
|
||||
worktree: ".worktrees/feature-matrix-production-readiness-plan"
|
||||
mutex: architecture-docs
|
||||
---
|
||||
|
||||
# FEATURE-MATRIX production-ready 连续性审计与完善计划
|
||||
|
||||
## 目标
|
||||
|
||||
核对 `FEATURE-MATRIX.md` 中除“纯软件项目自举”外的未完成项,形成不回退当前 `production_ready=yes` 基线的详细整改与验收计划。
|
||||
|
||||
## 范围
|
||||
|
||||
- 交叉核对 FEATURE-MATRIX、gap-matrix、CURRENT、相关设计、测试报告与当前源码。
|
||||
- 区分发布 blocker、补证、首发后增强、刻意关闭能力和文档漂移。
|
||||
- 输出 audit 与 remediation 文档,不修改业务代码或运行发布测试。
|
||||
|
||||
## 非目标
|
||||
|
||||
- 实施任何业务功能、启用 feature flag、部署或合并到 `dev`。
|
||||
- 重新规划“纯软件项目自举”。
|
||||
- 将 U9–U12、FAV、完整 PI change-report 叙事改列为当前发布 blocker。
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 完成启动协议与 SSOT 基线读取。
|
||||
2. [x] 逐项核对非自举 `partial` 行及证据漂移。
|
||||
3. [x] 写入 audit 与 remediation 方案。
|
||||
4. [x] 完成文档复核并更新本任务状态。
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 明确回答当前是否仍有 production-ready blocker。
|
||||
- [x] 每个未完成项都有范围、依赖、关闭标准、验证层级和回滚边界。
|
||||
- [x] 方案明确保护 B1–B4、三环境 schema 47、默认 off/legacy/shadow 和真实 PI/UI 证据边界。
|
||||
- [x] 文档遵循 `.doc/` taxonomy,且未修改业务代码。
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Audit: `../../audit/2026-09-16-feature-matrix-production-readiness-audit.md`
|
||||
- Remediation: `../../remediation/2026-09-16-feature-matrix-production-readiness-plan.md`
|
||||
- Test report: 不适用(本任务仅审计与规划)
|
||||
|
||||
## 证据 / 备注
|
||||
|
||||
当前基线来自 `CURRENT.md`、`gap-matrix.md`、B1–B4 测试报告及三环境 schema 47 记录;历史报告仅作为定位线索,计划要求实施阶段重新验证。
|
||||
|
||||
本轮未运行测试,因为没有业务代码变更,且 `ce-plan` 阶段只做研究与规划。
|
||||
@@ -0,0 +1,67 @@
|
||||
---
|
||||
title: "FEATURE-MATRIX Wave 0 校准与 IAM 只读核验"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor
|
||||
branch: feature/feature-matrix-production-readiness-plan
|
||||
worktree: ".worktrees/feature-matrix-production-readiness-plan"
|
||||
mutex: architecture-docs
|
||||
---
|
||||
|
||||
# FEATURE-MATRIX Wave 0 校准与 IAM 只读核验
|
||||
|
||||
## 目标
|
||||
|
||||
校准 `FEATURE-MATRIX.md` 契约与行状态,只读核验三环境 IAM 部署事实,保持 `production_ready=yes` 不被无证据回退。
|
||||
|
||||
## 范围
|
||||
|
||||
- PU1:矩阵契约、行模板、status README
|
||||
- PU2:按冻结边界收口/拆行;修正 schema/D3/IAM/FAV 漂移;历史指针
|
||||
- IAM 只读核验(health/ready、IAM 表、PG store);仅真实旁路时改 gap-matrix
|
||||
- 文档提交于本 feature 分支;不合 `dev`、不改业务代码
|
||||
|
||||
## 非目标
|
||||
|
||||
- Wave 1+(IAM fail-closed 代码、race、真实 PI 补证、夜间 CI)
|
||||
- merge `dev` / push / 共享容器 rebuild
|
||||
- 重新运行生产验收冒充补证
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] CURRENT 登记认领 `architecture-docs` in_progress
|
||||
2. [x] PU1 扩展契约与模板
|
||||
3. [x] IAM 只读核验并落盘结论
|
||||
4. [x] PU2 收口矩阵行与历史指针
|
||||
5. [x] `git diff --check` + docs 提交 + handoff
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 矩阵可区分完成边界 / 发布关系 / 关闭条件 / 证据
|
||||
- [x] L1、Chat baseline、DocRev baseline、前端、可靠事件按冻结范围 `done`;增强拆行
|
||||
- [x] schema 45、D3/D5、IAM 过时缺口、事件+FAV 混行已纠正
|
||||
- [x] IAM 只读结论落盘;无证实旁路则不改 `production_ready`
|
||||
- [x] handoff 标明合 `dev` 与 Wave 1 入口待审
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Audit: `../../audit/2026-09-16-feature-matrix-production-readiness-audit.md`
|
||||
- Remediation: `../../remediation/2026-09-16-feature-matrix-production-readiness-plan.md`
|
||||
- Plan short-term (done): `./2026-09-16-feature-matrix-production-readiness-plan.md`
|
||||
- Handoff: `../handoffs/2026-09-16-feature-matrix-wave0-calibration.md`
|
||||
- Test report: 不适用(本波仅文档 + 只读核验)
|
||||
|
||||
## 证据 / 备注
|
||||
|
||||
### IAM 只读核验(2026-09-16,只读;未 restart / 未改代码)
|
||||
|
||||
| 环境 | health/ready | schema_version | goose max | `user_credentials` | IAM 相关表 | `ALLOW_IN_MEMORY` | ENV | 判定 |
|
||||
|------|--------------|----------------|-----------|--------------------|------------|-------------------|-----|------|
|
||||
| dev `:8080` | ok / ok | 47 | 47 | 147 rows | users, auth_sessions, system_roles, user_role_bindings, iam_system_config 等齐全 | false | dev | PG store 可达;fallback 未触发 |
|
||||
| test `:8081` | ok / ok | 47 | 47 | 4 rows | 同上 | false | test | 同上 |
|
||||
| main `:8000` | ok / ok | 47 | 47 | 1 row | 同上 | false | prod | 同上;`auth_sessions=0` 仅表示无活跃会话,不表示 MemoryStore |
|
||||
|
||||
`IAMTablesReady` 口径(`user_credentials` EXISTS)三环境均为 true。近期 app 日志无 MemoryStore / in-memory auth 命中。
|
||||
|
||||
**结论**:未发现当前 main/prod 正在触发 MemoryStore 旁路;**不**将 `production_ready` 回退;**不**新增 gap-matrix blocker。代码层 `NewStores` 在表缺失时仍可能 silent fallback → 归 Wave 1 PU3 fail-closed 加固。
|
||||
@@ -0,0 +1,43 @@
|
||||
---
|
||||
title: "全量 backlog 覆盖 no-go 总控"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor
|
||||
branch: docs/override-nogo-full-backlog
|
||||
worktree: "-"
|
||||
mutex: architecture-docs
|
||||
---
|
||||
|
||||
# 全量 backlog 覆盖 no-go 总控
|
||||
|
||||
## 目标
|
||||
|
||||
按计划 P0–P7 收口工程残留并实施曾 no-go 的能力;默认 flag off;不升 `MULTI_INTENT_PLAN_TIER=full`;禁止整支 merge FAV。
|
||||
|
||||
## 授权
|
||||
|
||||
用户 2026-09-16 选择范围 **3(A+B 全开)**。
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] P0 SSOT 翻转
|
||||
2. [x] P1 nightly DATA_DIR 对齐 + green receipt(U8 PASS;FullNone 仍有 product_fail 待后续)
|
||||
3. [x] P2 IAM inventory + 410 + R13
|
||||
4. [x] P3 Playwright intent-plan 双标签(`RUN_UI_ACCEPTANCE=1` Docker Playwright PASS;A=200/B=409;见 [报告](../../test-reports/2026-09-16-intent-plan-playwright-dual-tab-test-report.md))
|
||||
5. [x] P4 PU6 + PU7(agent 实现合入;flag 默认 off)
|
||||
6. [x] P5 PU8 U9→U12(独立 flag;legacy tier;agent 实现合入)
|
||||
7. [x] P6 SWBOOT-00…09(10 stub/设计冻结;agent 实现合入)
|
||||
8. [x] P7 FAV 增量(非整支 merge;publisher/consumer 默认 off)
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 各波 short-term / test-report 回链
|
||||
- [x] FEATURE-MATRIX 对应行更新
|
||||
- [x] CURRENT 焦点与认领同步
|
||||
- [x] agent 富实现覆盖薄 stub:`chore/merge-agent-deltas` → `dev`
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Plan: full backlog override(Cursor plan)
|
||||
- go/no-go: [../research/2026-09-16-wave3-pu6-pu8-go-no-go.md](../research/2026-09-16-wave3-pu6-pu8-go-no-go.md)
|
||||
@@ -0,0 +1,20 @@
|
||||
---
|
||||
title: "Gitea nightly host tools / network"
|
||||
created: 2026-09-16
|
||||
owner: Cursor
|
||||
branch: fix/gitea-nightly-host-tools
|
||||
mutex: ci
|
||||
status: done
|
||||
---
|
||||
|
||||
# Gitea nightly host tools / network
|
||||
|
||||
## Goal
|
||||
|
||||
Make local Gitea `nightly:host` jobs able to run `actions/*` (node), health-check PI (`curl` → `127.0.0.1:18865`), and archive receipts without `upload-artifact@v4`.
|
||||
|
||||
## Done when
|
||||
|
||||
- [x] Runner host network + brew PATH (node/go/curl) + glibc mounts
|
||||
- [x] Workflow: replace upload-artifact@v4 with tar archive
|
||||
- [x] Nightly dispatch past infra curl; receipt not infra_fail due to missing tools
|
||||
@@ -0,0 +1,52 @@
|
||||
---
|
||||
title: "Playwright intent-plan 双标签验收"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor-Auto
|
||||
branch: feature/intent-plan-cards-playwright
|
||||
worktree: ".worktrees/feature-intent-plan-cards-playwright"
|
||||
mutex: web
|
||||
---
|
||||
|
||||
# Playwright intent-plan 双标签验收
|
||||
|
||||
## 目标
|
||||
|
||||
`RUN_UI_ACCEPTANCE=1` 真浏览器下,PLAN_CONFIRM 双标签 confirm 互斥;刷新/重登与 PG plan 一致;不升 `MULTI_INTENT_PLAN_TIER`。
|
||||
|
||||
## 范围
|
||||
|
||||
- `web/e2e/intent-plan-cards.spec.ts` 活验规格
|
||||
- App:`GET /intent-plans/active` 水合 PLAN_CONFIRM;confirm 使用唯一 decision nonce;空 docAST 登录兜底
|
||||
- InteractiveCard:`data-testid=plan-confirm-card` 等选择器
|
||||
- 测试报告归档
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不升 `MULTI_INTENT_PLAN_TIER`
|
||||
- 不用 stub/SKIP 冒充 PASS
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 从 origin/dev 开 `feature/intent-plan-cards-playwright`(worktree)
|
||||
2. [x] 水合 + 唯一 nonce + e2e 规格
|
||||
3. [x] `RUN_UI_ACCEPTANCE=1` 真浏览器跑通并写报告
|
||||
4. [x] 提交并 `./scripts/git-push-dev.sh`
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 无 `RUN_UI_ACCEPTANCE` 时 Playwright skip
|
||||
- [x] `RUN_UI_ACCEPTANCE=1`:双标签仅一侧 HTTP 200,另一侧 409;败方 outdated
|
||||
- [x] 刷新/重登卡片状态与 PG / GET active 一致
|
||||
- [x] 报告进 `.doc/test-reports/`
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Long-term: [../long-term/2026-09-16-intent-plan-playwright-dual-tab.md](../long-term/2026-09-16-intent-plan-playwright-dual-tab.md)
|
||||
- Test report: ../../test-reports/2026-09-16-intent-plan-playwright-dual-tab-test-report.md
|
||||
|
||||
## 证据 / 备注
|
||||
|
||||
- Live:`assets/2026-09-16-intent-plan-playwright-dual-tab/playwright-docker.txt`(1 passed 7.0s)
|
||||
- Network:`playwright-network.json`(A=200 / B=409 PLAN_STALE_REVISION;PG executing rev=2)
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
title: "partial/deferred 全量收口总控"
|
||||
status: in_progress
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-17
|
||||
owner: Cline
|
||||
branch: docs/partial-deferred-completion-plan
|
||||
worktree: "-"
|
||||
mutex: architecture-docs
|
||||
---
|
||||
|
||||
# partial/deferred 全量收口总控
|
||||
|
||||
## 目标
|
||||
|
||||
按 [收口计划](../../remediation/2026-09-16-partial-deferred-completion-plan.md) 把 FEATURE-MATRIX 6 行 `partial` + 1 行 `deferred` 推进到 `done`;全程保持模块独立解耦(端口 + 组合根 + PG 事件 + 契约门禁,不新增 RPC 层),变更影响面不跨模块扩散。
|
||||
|
||||
## 授权
|
||||
|
||||
用户 2026-09-16 要求已设计功能尽量推进 done,并确认通信机制与系统契约。
|
||||
用户 2026-09-17 确认收口计划 §7 四项决策(D7 草案数字、confirm 可独立授权、REPLACE 默认不启用、FAV 顺序与观察窗);见计划 §7.1–§7.4 与 [D7 ADR 草案](../../adr/2026-09-17-d7-chat-data-retention.md)。
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] W1 CI/E2E 收口(mutex `ci`;secret/runner 配置 + FullNone product_fail + green nightly)
|
||||
2. [x] W2 PU6 语义摘要 D3(mutex `chat`;shadow + 真实 PI + R13 + 负例;**不要求** REPLACE)
|
||||
3. [x] W3 PU7 PI change-report 叙事(mutex `docgov`;开 flag + 真实 PI + fallback 负例 + UI 区分)
|
||||
4. [x] W4 PU8 U9–U12(mutex `intent-plan`;逐 action 独立 flag,U9→U12 顺序;升 confirm 另开独立授权,不升 full)
|
||||
5. [ ] W5 纯软件自举(mutex `workflow-design`;SWBOOT-10 非 stub + 真实 PI + UI 二次验收)
|
||||
6. [ ] W6 FAV(mutex `events`;**shadow 已合** → live staging→artifact→publication 仍未开;每级观察窗 ≥7 天;`FAV_DEGRADED_READ=false`;禁止整支 merge)
|
||||
7. [ ] W7 D7 数据治理(mutex `chat`;**盘点已合**;按 ADR 口径整改仍待合规签字;数字 `pending-compliance-signoff`;本轮未发现已确认违规、未写 gap-matrix)
|
||||
8. [ ] 逐行升 done(保留 lineage)+ CURRENT / 契约状态同步
|
||||
9. [x] §7 四项开放问题决策落盘(2026-09-17)
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [ ] 各波独立 short-term / feature 分支 / test-report / 回滚点(占用对应 mutex)
|
||||
- [ ] 计划 DoD 全勾(见 remediation 计划 §8;§7 四项决策项已勾)
|
||||
- [ ] `production_ready` 与 B1–B4 门禁零回归
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Plan: [../../remediation/2026-09-16-partial-deferred-completion-plan.md](../../remediation/2026-09-16-partial-deferred-completion-plan.md)
|
||||
- D7 ADR 草案: [../../adr/2026-09-17-d7-chat-data-retention.md](../../adr/2026-09-17-d7-chat-data-retention.md)
|
||||
- 矩阵: [../../status/FEATURE-MATRIX.md](../../status/FEATURE-MATRIX.md)
|
||||
- 上位: [2026-09-16-full-backlog-override.md](./2026-09-16-full-backlog-override.md)(P0–P7 已完成,本总控承接其收口阶段)
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
title: "PU7 PI change-report 叙事"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor-Auto
|
||||
branch: feature/pu7-pi-narrative
|
||||
worktree: .worktrees/feature-pu7-pi-narrative
|
||||
mutex: docgov
|
||||
---
|
||||
|
||||
# PU7 PI change-report 叙事
|
||||
|
||||
## 目标
|
||||
|
||||
`PI_CHANGE_REPORT_NARRATIVE` 默认 off;开启后只读消费 immutable diff+lineage 的 typed 叙事,失败全量 deterministic fallback。
|
||||
|
||||
## 范围
|
||||
|
||||
- `internal/docrevision/` flag + ResolveChangeReport
|
||||
- `deploy/pi-agent/change-report-narrative-v1.mjs`
|
||||
- `ChangeReportPanel` / changeReportView 区分事实 vs 叙事
|
||||
|
||||
## 非目标
|
||||
|
||||
- 默认开启 flag
|
||||
- 覆盖服务端 risk / approval
|
||||
- 合入 `dev`(本任务仅 feature 分支)
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] flag 默认 off
|
||||
2. [x] typed narrative + input digest;失败全量 fallback
|
||||
3. [x] UI 区分 narrative / 事实字段
|
||||
4. [x] 单测 flag off + fallback
|
||||
5. [x] test-report + push feature 分支
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 默认 off 行为 = deterministic fallback
|
||||
- [x] 畸形/超时/digest 不匹配 → 无混合字段
|
||||
- [x] PI 声称低风险不影响服务端 risk floor
|
||||
- [x] 报告归档
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Contract: [../long-term/2026-09-16-pu7-pi-narrative-contract.md](../long-term/2026-09-16-pu7-pi-narrative-contract.md)
|
||||
- Test report: [../../test-reports/2026-09-16-pu7-pi-narrative-test-report.md](../../test-reports/2026-09-16-pu7-pi-narrative-test-report.md)
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
title: "P5 PU8 U9–U12 独立 flag 脚手架"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor
|
||||
branch: feature/pu8-u9-u12-flags
|
||||
worktree: /tmp/wt-pu8
|
||||
mutex: intent-plan
|
||||
---
|
||||
|
||||
# P5 PU8 U9–U12 独立 flag 脚手架
|
||||
|
||||
## 目标
|
||||
|
||||
为多意图扩面 U9–U12 落地独立 env flag(默认 OFF)与 stub/dry-run 端口,不升 `MULTI_INTENT_PLAN_TIER`。
|
||||
|
||||
## 范围
|
||||
|
||||
- `MULTI_INTENT_U9_SEGMENT` / `U10_MUTATE` / `U11_DOCGOV` / `U12_RUN_CONTROL`
|
||||
- U9 segment proposal port + fail-closed stub
|
||||
- U10–U12 dry-run adapters + `BuildOwnerMux` 门控
|
||||
- 单测证明默认 off 与 enable 路径不 panic
|
||||
|
||||
## 非目标
|
||||
|
||||
- 真实 LLM 分段 / 升 tier / 合入 `dev`
|
||||
- 真实 docgov/workflow 副作用写路径
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 独立 flags + `.env.example`
|
||||
2. [x] segment proposal + expansion adapters + mux 门控
|
||||
3. [x] Assemble `BuildOwnerMux` 接线
|
||||
4. [x] 单测 + 测试报告
|
||||
5. [x] push(不合 `dev`)
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 四 flag 默认 off;开 flag 不升 PlanTier
|
||||
- [x] flag off ≡ legacy(无 LLM proposal、无新 adapters)
|
||||
- [x] flag on:U9 fail-closed;U10–U12 dry-run/guarded
|
||||
- [x] 报告归档
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Contracts: [u9](../long-term/2026-09-16-pu8-u9-segment-proposal-contract.md) … [u12](../long-term/2026-09-16-pu8-u12-workflow-run-control-contract.md)
|
||||
- Test report: [../../test-reports/2026-09-16-pu8-u9-u12-flags-test-report.md](../../test-reports/2026-09-16-pu8-u9-u12-flags-test-report.md)
|
||||
@@ -0,0 +1,57 @@
|
||||
---
|
||||
title: "纯软件项目自举 SWBOOT-00..09 实施"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor-Auto
|
||||
branch: feature/software-project-bootstrap
|
||||
worktree: ".worktrees/feature-software-project-bootstrap"
|
||||
mutex: workflow-design
|
||||
---
|
||||
|
||||
# 纯软件项目自举 SWBOOT-00..09 实施
|
||||
|
||||
## 目标
|
||||
|
||||
落地 `software_bootstrap` / `software_delivery` 契约、迁移、manifest、目录白名单、创建向导后端钩子与 SWBOOT-10 allowlist stub;不合并 `dev`,不做真实受控改码。
|
||||
|
||||
## 范围
|
||||
|
||||
- SWBOOT-00 ADR
|
||||
- SWBOOT-01 项目域字段迁移
|
||||
- SWBOOT-02..04 catalog + manifests(无医疗污染)
|
||||
- SWBOOT-05..08 后端钩子(profile/创建预览/域过滤;UI 可部分)
|
||||
- SWBOOT-09 单元测试与报告
|
||||
- SWBOOT-10 allowlist stub only
|
||||
|
||||
## 非目标
|
||||
|
||||
- 合入 `dev`
|
||||
- 真实 PI / Ubuntu UI 全量黄金验收
|
||||
- 真实 repo patch/merge/push
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 认领 CURRENT + short-term
|
||||
2. [x] ADR
|
||||
3. [x] goose 00048
|
||||
4. [x] manifests + catalog allowlist
|
||||
5. [x] create-project wizard hooks + SWBOOT-10 stub
|
||||
6. [x] unit tests + test-report
|
||||
7. [x] push feature 分支 (`b5ce947`)
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 医疗三工作流目录与校验无回归(L1)
|
||||
- [x] 软件两 key 可选且无医疗默认语义
|
||||
- [x] 迁移 additive,旧项目不误分类(SQL 已写;活验 NOT RUN)
|
||||
- [x] SWBOOT-10 仅 stub,拒绝真实执行
|
||||
- [x] 测试报告落盘
|
||||
|
||||
## 相关链接
|
||||
|
||||
- ADR: `.doc/adr/2026-09-16-software-project-bootstrap-keys.md`
|
||||
- 设计: `.doc/system-design/2026-09-14-software-project-bootstrap-workflow.md`
|
||||
- Backlog: `.doc/ops/long-term/2026-09-14-software-project-bootstrap-implementation.md`
|
||||
- Checklist: `.doc/ops/checklists/2026-09-14-software-project-bootstrap-acceptance.md`
|
||||
- Test report: `.doc/test-reports/2026-09-16-software-project-bootstrap-test-report.md`
|
||||
@@ -0,0 +1,47 @@
|
||||
---
|
||||
title: "Wave 1 PU3 IAM store fail-closed"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor
|
||||
branch: fix/iam-store-fail-closed
|
||||
worktree: "-"
|
||||
mutex: authz
|
||||
---
|
||||
|
||||
# Wave 1 PU3 IAM store fail-closed
|
||||
|
||||
## 目标
|
||||
|
||||
禁止非显式 opt-in 环境回退 MemoryStore;main/空值/缺表时启动 fail-closed。
|
||||
|
||||
## 范围
|
||||
|
||||
- `auth.NewStores` 双门:仅 `dev|test` + `AllowInMemory`
|
||||
- characterization + 负例测试
|
||||
- 测试夹具与严格鉴权用例适配
|
||||
- FEATURE-MATRIX IAM/CI 行进度更新
|
||||
|
||||
## 非目标
|
||||
|
||||
- 完整全路由 inventory(后续增量)
|
||||
- 真实 PI 补证(Wave 2)
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 从 dev 开分支并认领
|
||||
2. [x] 先写负例测试再改 NewStores
|
||||
3. [x] 跑 auth/server 相关测试
|
||||
4. [x] 文档与提交
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] main/空 env/缺表不得 MemoryStore 继续服务
|
||||
- [x] 仅 dev/test + ALLOW_IN_MEMORY 可用内存 fixture
|
||||
- [x] 授权用户 happy path 不变(short 回归 PASS)
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Report: `../../test-reports/2026-09-16-wave1-iam-fail-closed-test-report.md`
|
||||
- Remediation PU3: `../../remediation/2026-09-16-feature-matrix-production-readiness-plan.md`
|
||||
- Wave 0 IAM 只读: `./2026-09-16-feature-matrix-wave0-calibration.md`
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
title: "Wave 1 PU5A TempDir race flake 修复"
|
||||
status: done
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-16
|
||||
owner: Cursor
|
||||
branch: fix/race-tempdir-cleanup
|
||||
worktree: "-"
|
||||
mutex: ci
|
||||
---
|
||||
|
||||
# Wave 1 PU5A TempDir race flake 修复
|
||||
|
||||
## 目标
|
||||
|
||||
关闭全仓 `-race` 下 TempDir `RemoveAll` 与异步 taskrun worker 的竞态,证明 worker 在清理前已退出。
|
||||
|
||||
## 范围
|
||||
|
||||
- `taskrun.Manager` 增加 WaitRunDone / WaitIdle
|
||||
- `newTestServer` cleanup 在 TempDir 删除前 drain workers
|
||||
- 阻塞类用例显式 WaitRunDone(如需要)
|
||||
- 多轮 `-race` 验证与 test-report
|
||||
|
||||
## 非目标
|
||||
|
||||
- 夜间 PI / promotion receipt(PU5B)
|
||||
- IAM fail-closed(PU3,独立分支)
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 认领 CURRENT
|
||||
2. [x] 实现 WaitIdle + newTestServer cleanup
|
||||
3. [x] 修补已知阻塞用例
|
||||
4. [x] `go test -race` 多轮验证并写报告
|
||||
5. [x] 提交
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 相关包/全仓 race 多轮无 TempDir RemoveAll flake
|
||||
- [x] 不用 skip/ignore 假绿
|
||||
- [x] 报告归档 `.doc/test-reports/`
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Remediation PU5A: `../../remediation/2026-09-16-feature-matrix-production-readiness-plan.md`
|
||||
- Report: `../../test-reports/2026-09-16-wave1-race-tempdir-cleanup-test-report.md`
|
||||
- Handoff: `../handoffs/2026-09-16-feature-matrix-wave0-calibration.md`
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
title: "已合入 leftover 旁支与文档对齐"
|
||||
status: done
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: chore/leftover-hygiene-2026-09-17
|
||||
worktree: "-"
|
||||
mutex: ops
|
||||
---
|
||||
|
||||
# 已合入 leftover 旁支与文档对齐
|
||||
|
||||
## 目标
|
||||
|
||||
拆掉 tip 已是本地 `dev` 祖先的 extra worktree 与本地旁支;把 CURRENT / SWBOOT long-term / PU 契约与 git 事实对齐。不整支合入冻结旁支。
|
||||
|
||||
## 范围
|
||||
|
||||
- 拆已合入 extra worktree(保留错名 FAV 目录)
|
||||
- `git branch -d` 已合入 leftover;SWBOOT 残留 1 commit 在确认文档已在 `dev` 后 `-D`
|
||||
- `fix/clean-test-env-baseline` 不 merge;标明前端清理已放弃
|
||||
- 对齐 CURRENT、SWBOOT long-term、PU6/PU8 契约
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不整支 merge `feature/final-artifact-vault`
|
||||
- 不合入 `feature/remove-herdr-agent-settings`、`fix/project143-controlled-content-404-diagnosis`、`fix/dev-runtime-data-root-guard`、`dev-old-linear`
|
||||
- 不删 `origin/*`;不从 worktree 起 docker;不碰项目 143;不 push
|
||||
- 不升 FEATURE-MATRIX 能力行 `done`
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 从 `dev` 开 `chore/leftover-hygiene-2026-09-17` 并认领 CURRENT
|
||||
2. [x] 拆已合入 worktree、删除已合入旁支
|
||||
3. [x] 文档对齐
|
||||
4. [x] 冒烟 + test-report
|
||||
5. [x] 占槽合 `dev`
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] extra worktree 只剩 FAV 错名目录
|
||||
- [x] 5 条冻结旁支仍在
|
||||
- [x] 文档不再声称 SWBOOT 未合 `dev`
|
||||
- [x] vet / short / arch-check / health+ready PASS
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Test report: `.doc/test-reports/2026-09-17-leftover-hygiene-test-report.md`
|
||||
- 上位: [2026-09-16-partial-deferred-completion.md](./2026-09-16-partial-deferred-completion.md)
|
||||
@@ -0,0 +1,51 @@
|
||||
---
|
||||
title: "晋升 dev → test(rc-v1.0.0-beta.3)"
|
||||
status: in_progress
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/promote-dev-to-test-2026-09-17
|
||||
worktree: "-"
|
||||
mutex: infra
|
||||
---
|
||||
|
||||
# 晋升 dev → test(rc-v1.0.0-beta.3)
|
||||
|
||||
## 目标
|
||||
|
||||
在 `production_ready=yes` 前提下,把本地 `dev@46a0fb2`(含 leftover + W2–W7)合入 `test`,重建测试服务,供部署后实测。
|
||||
|
||||
## 范围
|
||||
|
||||
- `test` `--no-ff` 合入当前 `dev`
|
||||
- 候选 tag `rc-v1.0.0-beta.3`
|
||||
- `./scripts/env-service.sh test rebuild`(部署新代码,不 pin beta.2 旧镜像)
|
||||
- `:8081` health/ready;goose 00048 可迁移
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不合入 `main`
|
||||
- 不启用 FAV live / `FAV_DEGRADED_READ`
|
||||
- 不升 `MULTI_INTENT_PLAN_TIER` / `SEMANTIC_SUMMARY_REPLACE`
|
||||
- 不翻转 `production_ready`
|
||||
- 不终止项目 143
|
||||
- 不按 D7 草案删除数据
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 确认 gap-matrix `production_ready=yes`;FAV/D7/SWBOOT 为 deferred_enhancement
|
||||
2. [ ] 占集成槽;合入 `test` + tag
|
||||
3. [ ] rebuild 测试服务
|
||||
4. [ ] health/ready + schema 冒烟
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [ ] `:8081` health/ready PASS
|
||||
- [ ] schema 到达 48(00048 additive)
|
||||
- [ ] FAV 仍 off
|
||||
- [ ] 默认 flag 仍 off
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Test report: [../../test-reports/2026-09-17-promote-dev-to-test-test-report.md](../../test-reports/2026-09-17-promote-dev-to-test-test-report.md)
|
||||
- gap-matrix: [../../remediation/gap-matrix.md](../../remediation/gap-matrix.md)
|
||||
@@ -0,0 +1,53 @@
|
||||
---
|
||||
title: "W1 CI/E2E FullNone + green nightly"
|
||||
status: done
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w1-ci-e2e-green-nightly
|
||||
worktree: "-"
|
||||
mutex: ci
|
||||
---
|
||||
|
||||
# W1 CI/E2E FullNone + green nightly
|
||||
|
||||
## 目标
|
||||
|
||||
收口 FullNone `product_fail`,取得真实 nightly `verdict=pass` receipt,将 FEATURE-MATRIX「CI / E2E」升为 `done`。
|
||||
|
||||
## 范围
|
||||
|
||||
- 复核 Actions secret/runner 已就绪
|
||||
- 复现并修复 `TestWorkflowGovernance_PiAgent_PG_FullNoneMixedChain`
|
||||
- nightly U8+FullNone → green receipt + test-report
|
||||
- 矩阵行升 done
|
||||
|
||||
## 非目标
|
||||
|
||||
- W2–W7;升 `MULTI_INTENT_PLAN_TIER`;开 `SEMANTIC_SUMMARY_REPLACE`;整支 merge FAV
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] docs 计划分支合入 `dev`(`4bda648`)
|
||||
2. [x] CURRENT 认领 `mutex=ci` + 本 short-term
|
||||
3. [x] 本地复现 FullNone 并分栏(根因:duplicate goose 00048 + fields.json 硬目标 + KB/超时)
|
||||
4. [x] 修复至本地 FullNone 绿(1008s)
|
||||
5. [x] nightly green receipt 归档 + test-report(`6e2476f0…` verdict=pass)
|
||||
6. [x] FEATURE-MATRIX CI/E2E → done;总控 W1 勾选;释放认领
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] Nightly receipt `verdict=pass`(真实 run)
|
||||
- [x] FullNone 在 nightly 套件 PASS
|
||||
- [x] 矩阵 `done`;B1–B4 零回归
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Plan: [../../remediation/2026-09-16-partial-deferred-completion-plan.md](../../remediation/2026-09-16-partial-deferred-completion-plan.md) §W1
|
||||
- Test report: [../../test-reports/2026-09-17-w1-ci-e2e-green-nightly-test-report.md](../../test-reports/2026-09-17-w1-ci-e2e-green-nightly-test-report.md)
|
||||
- Receipt: [../../test-reports/assets/promotion-receipts/6e2476f0f2e408e111fe06ca7c31a38294a340b3.json](../../test-reports/assets/promotion-receipts/6e2476f0f2e408e111fe06ca7c31a38294a340b3.json)
|
||||
|
||||
## 证据 / 备注
|
||||
|
||||
- commits: `4f2e5f0` `a02c67d` `0f52ab8` `11e030d` `6e2476f`
|
||||
- Gitea Actions API 可达;本提交未推远端,远端 dispatch 留合入后二次确认
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
title: "W2 语义摘要 shadow 真实 PI"
|
||||
status: done
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w2-semantic-summary-shadow-live
|
||||
worktree: "-"
|
||||
mutex: chat
|
||||
---
|
||||
|
||||
# W2 语义摘要 shadow 真实 PI
|
||||
|
||||
## 目标
|
||||
|
||||
在授权可见集合上接入产品 PI Agent Runner 的 no-tool shadow 摘要;默认 flag off;不接线 `SEMANTIC_SUMMARY_REPLACE`。
|
||||
|
||||
## 范围
|
||||
|
||||
- `PiSemanticSummarizer` 组合根注入(仅 `SEMANTIC_SUMMARY_SHADOW` on 且 backend=pi-agent)
|
||||
- R13 minimized input.json;tool_permissions=none
|
||||
- 真实 MiniMax 证据 + injection 负例
|
||||
- 仓库默认 flag 保持 false
|
||||
|
||||
## 非目标
|
||||
|
||||
- 启用 `SEMANTIC_SUMMARY_REPLACE`
|
||||
- 改 test/main 默认 env
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 认领 CURRENT mutex `chat`
|
||||
2. [x] 实现 PI summarizer + 单测
|
||||
3. [x] 真实 PI live
|
||||
4. [x] test-report + 矩阵升 done
|
||||
5. [x] 合 `dev`
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] flag 默认 off
|
||||
- [x] 真实 PI shadow.status=ok 或可解释 fallback
|
||||
- [x] injection 秘密不入 served narrative;REPLACE 未接线
|
||||
- [x] vet / short / arch-check PASS
|
||||
|
||||
## 相关链接
|
||||
|
||||
- 契约: `.doc/ops/long-term/2026-09-16-pu6-semantic-summary-contract.md`
|
||||
- 总控: `.doc/ops/short-term/2026-09-16-partial-deferred-completion.md`
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
title: "W3 PU7 PI change-report 叙事 live"
|
||||
status: done
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w3-pi-change-report-narrative-live
|
||||
worktree: "-"
|
||||
mutex: docgov
|
||||
---
|
||||
|
||||
# W3 PU7 PI change-report 叙事 live
|
||||
|
||||
## 目标
|
||||
|
||||
flag on 时质量修复路径向产品 PI Agent Runner 请求 `change_report_narrative_v1`;digest 绑定;畸形/超时全量 fallback;UI 区分叙事与 `rule_risk`/lineage。
|
||||
|
||||
## 范围
|
||||
|
||||
- `CreateAgentCandidate` 在 flag on 且 `ReportJSON` 为空时调用 `NarrativeFetcher`
|
||||
- 组合根仅 `PI_CHANGE_REPORT_NARRATIVE` on + `pi-agent` 注入 `PiChangeReportNarrator`
|
||||
- 仓库默认 flag 仍 off;dev 运行态可覆盖
|
||||
- 负例:timeout envelope / fetcher error → fallback 且不返回 `ErrReportInvalid`
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不把 fallback 写成完整 PI
|
||||
- 不覆盖服务端风险与文档影响
|
||||
- 不默认开启仓库 flag
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] no-tool PI narrator + 组合根接线
|
||||
2. [x] digest 与 `ResolveChangeReport` 同源(candidate 真实 diff 之后再 fetch)
|
||||
3. [x] 单测 + 真实 MiniMax + UI 分区单测
|
||||
4. [x] 合 `dev` + 冒烟 + 矩阵升 done
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 真实 PI 产出 `change_report_narrative_v1` 且 digest 原样回写
|
||||
- [x] fallback 负例 PASS
|
||||
- [x] UI `change-report-factual` / `change-report-narrative` 分区
|
||||
- [x] test-report 归档
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Contract: [../long-term/2026-09-16-pu7-pi-narrative-contract.md](../long-term/2026-09-16-pu7-pi-narrative-contract.md)
|
||||
- Test report: [../../test-reports/2026-09-17-w3-pi-change-report-narrative-test-report.md](../../test-reports/2026-09-17-w3-pi-change-report-narrative-test-report.md)
|
||||
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: "W4 PU8 U9–U12 独立 flag live"
|
||||
status: done
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w4-u9-segment-live
|
||||
worktree: "-"
|
||||
mutex: intent-plan
|
||||
---
|
||||
|
||||
# W4 PU8 U9–U12 独立 flag live
|
||||
|
||||
## 目标
|
||||
|
||||
U9 真实 LLM proposer(规则能切则不出 proposal);U10–U12 各自独立 flag 的 dry-run→confirm 证据;不升 `MULTI_INTENT_PLAN_TIER`。
|
||||
|
||||
## 范围
|
||||
|
||||
- `PiSegmentProposer` + 规则门 + 组合根接线
|
||||
- U10 mutate 幂等 dry-run receipt;U11 项目 143 只读;U12 run-control 独立 flag
|
||||
- 四份独立 test-report
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不升 `confirm` / `full`
|
||||
- 不把 U10–U12 dry-run 写成领域 live 写
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] U9 PI proposer + 规则门
|
||||
2. [x] U10–U12 分 flag 证据
|
||||
3. [x] 合 `dev` + 矩阵升 done
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 真实 MiniMax U9
|
||||
- [x] 负例 malformed/timeout/OOB/规则已切
|
||||
- [x] PLAN_TIER 仍 legacy
|
||||
@@ -0,0 +1,21 @@
|
||||
---
|
||||
title: "W5a 软件自举 UI + docs_only PI"
|
||||
status: done
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w5a-software-bootstrap-ui-pi
|
||||
worktree: "-"
|
||||
mutex: workflow-design
|
||||
---
|
||||
|
||||
# W5a 软件自举 UI + docs_only PI
|
||||
|
||||
## 目标
|
||||
|
||||
创建向导改为服务端 catalog 驱动;软件项目不克隆医疗 7 模板;solo 标注未独立评审;docs_only 真实 PI 建议 delivery 且不自动激活。SWBOOT-10 仍 stub。矩阵不升 done。
|
||||
|
||||
## 非目标
|
||||
|
||||
- 真 patch/merge(W5b)
|
||||
- 升 FEATURE-MATRIX 纯软件自举行
|
||||
@@ -0,0 +1,51 @@
|
||||
---
|
||||
title: "W6 FAV subscriber shadow"
|
||||
status: done
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w6-fav-subscriber-shadow
|
||||
worktree: "-"
|
||||
mutex: events
|
||||
---
|
||||
|
||||
# W6 FAV subscriber shadow
|
||||
|
||||
## 目标
|
||||
|
||||
手工移植 FAV subscriber **shadow**:只计算 intended outcome,不写业务副作用;`FAV_DEGRADED_READ=false`;`FAV_PUBLISHER_ENABLED` 默认 false。矩阵保持 `partial`。
|
||||
|
||||
## 范围
|
||||
|
||||
- `ObserveShadow` 只读计算
|
||||
- vault status / CLI 标明 shadow 与 live 未放量
|
||||
- 负例:degraded read 拒绝;HandleLease / Register(fav) 仍 fail-closed
|
||||
|
||||
## 非目标
|
||||
|
||||
- 整支 merge `feature/final-artifact-vault`
|
||||
- live staging → artifact → publication
|
||||
- 启用 `FAV_DEGRADED_READ`
|
||||
- 升 FEATURE-MATRIX FAV 为 `done`
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] `ObserveShadow` + 负例单测
|
||||
2. [x] 冒烟 + 报告(live 未放量)
|
||||
3. [x] 合 `dev`;矩阵保持 partial
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] WouldStage / WouldPublish 恒 false
|
||||
- [x] FAV_DEGRADED_READ=true 时 shadow 拒绝
|
||||
- [x] 报告写清 shadow 证据与「live 未放量」
|
||||
|
||||
## 相关链接
|
||||
|
||||
- Remaining port: [../../audit/2026-09-16-fav-u7-remaining-port.md](../../audit/2026-09-16-fav-u7-remaining-port.md)
|
||||
- U7 报告: [../../test-reports/2026-09-16-fav-u7-incremental-test-report.md](../../test-reports/2026-09-16-fav-u7-incremental-test-report.md)
|
||||
- Test report: [../../test-reports/2026-09-17-w6-fav-subscriber-shadow-test-report.md](../../test-reports/2026-09-17-w6-fav-subscriber-shadow-test-report.md)
|
||||
|
||||
## 证据 / 备注
|
||||
|
||||
不占 live 观察窗;≥7 天窗口仍属后续 live 切片。
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
title: "W7 D7 对话数据分类盘点"
|
||||
status: done
|
||||
created: 2026-09-17
|
||||
updated: 2026-09-17
|
||||
owner: Cursor
|
||||
branch: feature/w7-d7-data-inventory
|
||||
worktree: "-"
|
||||
mutex: chat
|
||||
---
|
||||
|
||||
# W7 D7 对话数据分类盘点
|
||||
|
||||
## 目标
|
||||
|
||||
只做数据分类盘点 audit(sessions/messages、KB、日志、备份、event 敏感字段与流转)。无合规签字不物理删除、不清备份。矩阵 D7 保持 `deferred`。
|
||||
|
||||
## 范围
|
||||
|
||||
- 只读盘点:表、派生副本、日志、备份脚本、事件 payload
|
||||
- 若发现**已确认**安全/合规基线违规 → 立即写 gap-matrix blocker
|
||||
|
||||
## 非目标
|
||||
|
||||
- 按 ADR 草案数字(365/180/30)执行物理删除或备份清除
|
||||
- 字段级加密实现
|
||||
- 升 FEATURE-MATRIX D7 为 `done`
|
||||
- 翻转 `production_ready`
|
||||
|
||||
## 步骤
|
||||
|
||||
1. [x] 只读盘点系统库 / 共享 KB / 宿主 traces / 事件 payload keys
|
||||
2. [x] 写 audit + test-report;违规判定(无已确认违规,未写 gap-matrix)
|
||||
3. [x] 合 `dev`;矩阵保持 deferred
|
||||
|
||||
## 验收标准
|
||||
|
||||
- [x] 盘点覆盖 sessions/messages、KB、日志、备份、event
|
||||
- [x] 未执行物理删除
|
||||
- [x] D7 仍 deferred;ADR 仍 `pending-compliance-signoff`
|
||||
|
||||
## 相关链接
|
||||
|
||||
- ADR: [../../adr/2026-09-17-d7-chat-data-retention.md](../../adr/2026-09-17-d7-chat-data-retention.md)
|
||||
- Audit: [../../audit/2026-09-17-d7-data-inventory.md](../../audit/2026-09-17-d7-data-inventory.md)
|
||||
- Test report: [../../test-reports/2026-09-17-w7-d7-inventory-test-report.md](../../test-reports/2026-09-17-w7-d7-inventory-test-report.md)
|
||||
@@ -1 +1,19 @@
|
||||
| <模块名> | <能力描述> | planned | (设计/代码/test-report 链接) | (缺口) | `<mutex>` |
|
||||
# FEATURE-MATRIX 行模板
|
||||
|
||||
复制到 [FEATURE-MATRIX.md](../../status/FEATURE-MATRIX.md) 的完成度表中。能力状态与 `production_ready`(gap-matrix)正交。
|
||||
|
||||
| 字段 | 填写说明 |
|
||||
|------|----------|
|
||||
| 模块 | 短名 |
|
||||
| 声明范围 | 本行冻结边界;`done` 只覆盖此范围 |
|
||||
| 状态 | `done` \| `partial` \| `planned` \| `deferred` \| `blocked` |
|
||||
| 发布关系 | `non_blocker` / `补证` / `加固` / `deferred_enhancement` |
|
||||
| 证据 | 设计/代码/test-report 链接;可追 commit/环境/schema |
|
||||
| 剩余工作 / 关闭条件 | partial/planned 必填;stub/SKIP/fallback 不得冒充关闭 |
|
||||
| mutex | 与 CURRENT 并行认领一致 |
|
||||
|
||||
```markdown
|
||||
| <模块名> | <声明范围> | planned | non_blocker | (设计/代码/test-report 链接) | (关闭条件) | `<mutex>` |
|
||||
```
|
||||
|
||||
拆行收口时另在「边界 lineage」区记录 before/after、义务去向与证据覆盖结论。
|
||||
|
||||
@@ -1,13 +1,15 @@
|
||||
---
|
||||
title: "HTTP 与 SSE 公开错误信封整改"
|
||||
status: planned
|
||||
status: implemented
|
||||
created: 2026-09-15
|
||||
updated: 2026-09-15
|
||||
updated: 2026-09-16
|
||||
owner: Cursor
|
||||
---
|
||||
|
||||
# HTTP 与 SSE 公开错误信封整改
|
||||
|
||||
> **Implemented(2026-09-16)**:H1–H3 已有 [test-report](../test-reports/2026-09-15-http-error-envelope-h1-h3-test-report.md)。活状态见 [FEATURE-MATRIX](../status/FEATURE-MATRIX.md) / CURRENT;本文保留为方案原文。
|
||||
|
||||
## 背景
|
||||
|
||||
Phase 2 复核确认错误信封涉及全部 HTTP 路由、SSE transport 和前端解析,属于独立 wire-contract 改造,不应阻塞持久事件交付。审阅见 [模块解耦 Phase 2 方案审阅](../audit/2026-09-15-module-decoupling-phase2-plan-review.md)。
|
||||
|
||||
@@ -1,14 +1,16 @@
|
||||
---
|
||||
title: "模块解耦 Phase 2:持久事件交付与后续解耦路线"
|
||||
status: planned
|
||||
status: implemented
|
||||
created: 2026-09-15
|
||||
updated: 2026-09-15
|
||||
updated: 2026-09-16
|
||||
type: refactor
|
||||
owner: TBD
|
||||
---
|
||||
|
||||
# 模块解耦 Phase 2:持久事件交付与后续解耦路线
|
||||
|
||||
> **Implemented / superseded(2026-09-16)**:Track E(E0A–E2)与 shared live、D4–D7b、HTTP 信封 H1–H3、PI typed-result-v1 已有验收报告并合入;可靠事件核心在 [FEATURE-MATRIX](../status/FEATURE-MATRIX.md) 标 `done`,FAV 独立 `deferred`。活状态以 FEATURE-MATRIX / CURRENT / gap-matrix 为准;本文保留为历史方案,不删除。
|
||||
|
||||
## 决策摘要
|
||||
|
||||
Phase 2 的核心交付只包含持久事件链:修正事件生产、补齐 PostgreSQL 投递实现、用无副作用 shadow 对账替换闭包桥,并以授权用户刷新/重启后的正文恢复作为停走门。
|
||||
|
||||
@@ -0,0 +1,454 @@
|
||||
---
|
||||
title: "FEATURE-MATRIX Production-Ready Continuity - Plan"
|
||||
type: refactor
|
||||
date: 2026-09-16
|
||||
deepened: 2026-09-16
|
||||
status: in_progress
|
||||
artifact_contract: ce-unified-plan/v1
|
||||
product_contract_source: ce-plan-bootstrap
|
||||
execution: code
|
||||
wave0: done
|
||||
---
|
||||
|
||||
# FEATURE-MATRIX Production-Ready Continuity - Plan
|
||||
|
||||
## Goal Capsule
|
||||
|
||||
- **Objective:** 让维护者能够从 `FEATURE-MATRIX.md` 准确判断当前发布基线、真实剩余工作和每项工作的关闭条件,同时保持已经签署的 production-ready 状态不被文档整理或后续增强误伤。
|
||||
- **Means:** 将能力成熟度与发布门禁拆成两个正交维度,先校准证据和状态,再按“补证、基建加固、可选增强”分波实施(KTD1、KTD2)。
|
||||
- **Authority:** `gap-matrix.md` 决定发布 blocker;`FEATURE-MATRIX.md` 决定能力成熟度;`CURRENT.md` 记录协作与环境快照。
|
||||
- **Execution profile:** verification-first;文档校准不改业务行为;新能力默认 off、legacy 或 shadow;跨环境先以 receipt 绑定同一 commit 和 digest,PU5B 完成后只晋升同一已验证 image。
|
||||
- **Stop conditions:** 任一波发现授权旁路、持久化丢失、双写者、跨用户泄漏、当前 B1–B4 回归或 main/prod fail-open 时,停止扩面并将该问题写入 `gap-matrix.md`。
|
||||
|
||||
---
|
||||
|
||||
## Product Contract
|
||||
|
||||
### Summary
|
||||
|
||||
当前系统按仓库 SSOT 已达到 `production_ready=yes`。本计划不重新定义首发范围,而是修正矩阵漂移,补上可判定的关闭条件,并把剩余工作排成不会改变当前默认路径的独立波次。
|
||||
|
||||
### Problem Frame
|
||||
|
||||
`FEATURE-MATRIX.md` 目前把五类状态都写成 `partial`:已完成但文档未收口、实现完成但真实证据未签、首发后增强、实验性能力和刻意关闭能力。结果是维护者无法从矩阵判断哪些事项会影响发布,也无法知道某行何时能转为 `done`。
|
||||
|
||||
矩阵还存在已确认的事实漂移:schema 45 与当前 schema 47 冲突,语义摘要编号误写为 D5,IAM 仍列出已经闭环的历史读取授权缺口,可靠事件核心被 FAV 的 off 状态拖成 `partial`。这些问题需要先在文档层纠正,再决定是否立业务实现任务。
|
||||
|
||||
### Requirements
|
||||
|
||||
#### Status and ownership
|
||||
|
||||
| ID | Requirement |
|
||||
|---|---|
|
||||
| R1 | `production_ready` 只由 `gap-matrix.md` 的发布门禁决定;能力行不是“全部 done 才能发布”的总开关。 |
|
||||
| R2 | 每行必须声明既定能力边界、能力状态、发布关系、剩余工作、关闭条件、owner/mutex 和当前证据。 |
|
||||
| R3 | `done` 表示本行声明能力已达到生产验收,不表示该领域没有后续;新增增强应拆行或进入 backlog。 |
|
||||
| R4 | 补证、修复、增强、实验和 deferred 能力必须分开,不能共用一个模糊的“后续”。 |
|
||||
|
||||
#### Evidence and release safety
|
||||
|
||||
| ID | Requirement |
|
||||
|---|---|
|
||||
| R5 | 状态提升必须同时核对源码、迁移、部署 artifact、API/runtime 和适用测试层级;单独改文档不得提升能力状态。 |
|
||||
| R6 | 证据必须记录或可追到 commit、环境、schema、镜像、runner/model/protocol、日期和测试类型。 |
|
||||
| R7 | 代码、schema、compose、flag、runner 协议或环境晋升触发受影响行重验;历史报告保留但不得证明新 artifact。 |
|
||||
| R8 | 新功能先使用 additive migration 和兼容读取,再以 off/legacy/shadow 上线;任何放量都要有独立回滚点。 |
|
||||
| R9 | 回滚必须能读取、取消和收口已持久化的 plan/run/event;禁止回滚 schema 或让旧 app/worker 不认识新状态。 |
|
||||
|
||||
#### Authorization and agent behavior
|
||||
|
||||
| ID | Requirement |
|
||||
|---|---|
|
||||
| R10 | UI、API、聊天和产品 PI Agent Runner 必须进入同一 owner service,并共享即时授权、资源版本、幂等、审计和错误语义。 |
|
||||
| R11 | 正文、计数、摘要、搜索、计划卡、RAG 和 Agent tools 必须从同一授权后可见集合派生。 |
|
||||
| R12 | 产品 PI Runner 只生成建议、内容或解释;权限判断、状态迁移、版本提交和法定审批由服务端及已认证用户完成。 |
|
||||
| R13 | 所有真实 PI 路径必须共享最小化出站、tenant/project 绑定、敏感字段脱敏、凭证最小权限、日志/产物留存和泄漏负例;夜间验收只使用隔离的合成数据。 |
|
||||
|
||||
### Actors
|
||||
|
||||
- A1. 文档维护者:更新矩阵、证据链接和历史 superseded 指针。
|
||||
- A2. 发布负责人:决定 blocker、环境晋升、回滚和 production-ready 翻旗。
|
||||
- A3. 模块 owner:实现或验证单个 action,不跨 mutex 批量扩面。
|
||||
- A4. 最终用户:通过 UI、API 或聊天使用同一服务端能力。
|
||||
- A5. 产品 PI Agent Runner:受控生成或解释,不承担 authority。
|
||||
|
||||
### Key Flows
|
||||
|
||||
- F1. 矩阵状态更新
|
||||
- **Trigger:** 新实现、补证或环境晋升完成。
|
||||
- **Actors:** A1、A2、A3。
|
||||
- **Steps:** 核对行边界 → 匹配证据 → 评估发布关系 → 更新矩阵 → 仅在 blocker 变化时更新 gap-matrix。
|
||||
- **Outcome:** 能力状态和发布状态不互相污染。
|
||||
- F2. 增强能力上线
|
||||
- **Trigger:** 一个 deferred/partial 子能力获批实施。
|
||||
- **Actors:** A2、A3、A4、A5。
|
||||
- **Steps:** additive migration → 默认关闭 → 隔离验证 → dev 灰度 → test 晋升 → main 晋升或独立回滚。
|
||||
- **Outcome:** 当前路径持续可用,新能力只在证据完整后放量。
|
||||
|
||||
### Acceptance Examples
|
||||
|
||||
- AE1. **Covers R1–R4.** 前端工作台现有范围证据完整时,该行可改 `done`;未来其他 409 消费方优化进入独立 backlog,不把该行退回 `partial`。
|
||||
- AE2. **Covers R5–R9.** multi-intent U8 adapter 已合入但真实 PI 为 SKIP 时,矩阵写“代码与默认 legacy 基线完成、真实生成闭环未签”,tier 不升到 `confirm/full`。
|
||||
- AE3. **Covers R10–R12.** full 文档由真实 PI 生成后由独立用户完成审核/批准;none 文档生成后无审批动作且不阻塞阶段。
|
||||
- AE4. **Covers R5–R8.** PI change-report 超时或返回非法 schema 时,用户仍看到明确标记的 deterministic fallback,候选版本和正文不被 PI 输出修改。
|
||||
- AE5. **Covers R1、R6、R7.** 夜间真实 PI 因 runner 不可用失败时,结果记为 infrastructure failure 并阻止下一次晋升;已发布版本不会被自动改写为未就绪。
|
||||
|
||||
### Scope Boundaries
|
||||
|
||||
#### In scope
|
||||
|
||||
- 整改 `FEATURE-MATRIX.md` 的状态契约、行边界、证据和关闭条件。
|
||||
- 同步仍作为活 SSOT 的 CURRENT、gap-matrix、remediation index 和历史文档指针。
|
||||
- 安排 IAM、补证、CI、语义摘要、PI change-report、多意图扩面的后续工作。
|
||||
- 为每个波次定义回归、部署、证据和回滚门。
|
||||
|
||||
#### Deferred to Follow-Up Work
|
||||
|
||||
- Final Artifact Vault:独立审计,保持 `FAV_DEGRADED_READ=false`,禁止整支合入 `feature/final-artifact-vault`。
|
||||
- 多意图 U9 LLM 分段实验:仅在预注册真实 PI eval 阈值通过且安全错误为 0 后考虑放量。
|
||||
- 多意图 U10–U12:每个 action 独立任务、flag、owner、授权负例和回滚点。
|
||||
- D7 对话留存与敏感字段加密:独立安全治理项;先完成数据分类、当前数据库/备份/日志控制盘点和合规口径,再设计迁移、回滚与验收。若盘点确认当前基线违反已确认的安全或合规要求,必须立即写入 `gap-matrix.md`,不能继续作为普通 backlog。
|
||||
|
||||
#### Out of scope
|
||||
|
||||
- 纯软件项目自举。
|
||||
- 将 Herdr、`context_pi`、Cursor、Codex 或其他工程协作 Agent 作为产品 PI Agent Runner 的验收证据。
|
||||
- 在本次方案编制和 Wave 0 阶段修改业务代码、启用 dormant flag、合并 `dev` 或操作共享容器。
|
||||
|
||||
### Success Criteria
|
||||
|
||||
1. 维护者能在一行内判断“当前能力是否完成、是否影响发布、还差什么、用什么证据关闭”。
|
||||
2. 已确认的 L1、前端工作台和可靠事件核心不再因无关 backlog 永久 `partial`。
|
||||
3. IAM、multi-intent U8、full/none、CI、语义摘要和 PI 叙事都有独立的关闭条件,不再用 stub、SKIP 或 fallback 冒充完整验收。
|
||||
4. 后续任一波失败都可回到当前默认路径,B1–B4 和 schema 47 基线不被破坏。
|
||||
|
||||
---
|
||||
|
||||
## Planning Contract
|
||||
|
||||
### Key Technical Decisions
|
||||
|
||||
- KTD1. **能力状态与发布状态正交。** `FEATURE-MATRIX.md` 记录能力成熟度,`gap-matrix.md` 记录发布 blocker;仅当前生产契约被证据推翻时回退 `production_ready`。Governs R1–R4。
|
||||
- KTD2. **按冻结的能力边界关闭行。** 已完成范围转 `done`,新增增强拆成新行或 backlog,避免永久 `partial`。任何边界变更都要保留 before/after、逐项迁移去向和原边界已满足的证据,禁止靠缩小口径制造 `done`。Governs R2–R4。
|
||||
- KTD3. **证据按变化触发重验。** 不设机械 TTL;按代码、schema、artifact、flag、runner/protocol 和环境晋升触发重验。Governs R5–R7。
|
||||
- KTD4. **补证和修复分离。** full/none 与 multi-intent U8 先执行真实验收;只有验收失败并定位为产品缺陷后才开修复分支,修复后必须重验。Governs R5、R8。
|
||||
- KTD5. **逐能力安全放量。** migration 只 expand,新能力默认 off/legacy/shadow,app/worker 保持向后读取和收口能力。Governs R8、R9。
|
||||
- KTD6. **共享 command 与共享 authorized view。** 所有入口调用同一 owner port,读模型从同一授权集合派生。Governs R10、R11。
|
||||
- KTD7. **PI 叙事不成为事实源。** diff、lineage、risk floor、版本和审批由服务端确定;PI 失败时保留显式 fallback。Governs R12。
|
||||
- KTD8. **同一 artifact 晋升是独立发布加固。** 在不可变镜像流水线落地前,dev/test/main 至少记录同一候选 commit、各环境 image digest 和构建证明,不得声称已实现 same-image promotion;落地后 test/main 只引用候选 commit 一次构建出的 digest。Governs R5、R7–R9。
|
||||
|
||||
### High-Level Technical Design
|
||||
|
||||
#### Status decision
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
A[Read declared capability boundary] --> B{Current evidence satisfies boundary?}
|
||||
B -->|No| C{Is capability active in release path?}
|
||||
C -->|Yes and contract regressed| D[Mark blocked and update gap-matrix]
|
||||
C -->|No| E[Keep partial, planned, or deferred]
|
||||
B -->|Yes| F{Remaining work belongs to same boundary?}
|
||||
F -->|Yes| G[Keep partial with explicit exit gate]
|
||||
F -->|No| H[Mark current row done]
|
||||
H --> I[Create separate enhancement or deferred row]
|
||||
```
|
||||
|
||||
#### Safe rollout and rollback
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
A[Expand schema and compatible readers] --> B[Deploy flag off or legacy]
|
||||
B --> C[Unit and isolated PG evidence]
|
||||
C --> D[Dev shadow or targeted live]
|
||||
D --> E{Stop gate passes?}
|
||||
E -->|No| F[Disable new writes and drain]
|
||||
F --> G[Keep read, cancel, and finalize compatibility]
|
||||
E -->|Yes| H[Test promotion with receipt]
|
||||
H --> I[Main promotion with same commit and proven digest]
|
||||
I --> J[Update evidence and matrix]
|
||||
```
|
||||
|
||||
### Current Residual Work Map
|
||||
|
||||
| Area | Baseline now | Required closure | Current classification / transition |
|
||||
|---|---|---|---|
|
||||
| Intent L1 | 18 类、三分支、读写分流、busy 已签 | 从本行移除 U9–U12,确认纯依赖门禁仍在 | `done` |
|
||||
| Multi-intent baseline | U1–U8 code/default legacy + Wave2 real PI | Playwright 双标签仍 gated;升 tier 另开 | `done` |
|
||||
| Multi-intent expansion | U9–U12 未进入首发 | U9 eval;U10–U12 per-action | 当前 `deferred`;获批 short-term 开始后转 `partial` |
|
||||
| Chat / ctxmgr baseline | 刷新恢复与授权同集已签 | 修正文档状态;新摘要另列 | `done` |
|
||||
| Semantic summary (D3) | deterministic summary 已有 | 产品 go/no-go;授权输入、shadow、fallback | 当前 `deferred`;获批 short-term 开始后转 `partial` |
|
||||
| Chat data governance (D7) | 当前生产控制待盘点 | 数据分类、留存删除、数据库/备份/日志控制与敏感字段加密边界 | `deferred`;确认违规时升级 blocker |
|
||||
| Workflow governance | 正式工作流、鉴权、三工作流 PI、full/none 长链已签 | 纯软件自举仍 planned | `done` |
|
||||
| IAM / authz | 已知历史读取缺口已闭环 | 全路由 inventory、PG fail-closed、410 决策 | `partial` |
|
||||
| Document revision baseline | 账本、确定性 diff/lineage 与 UI 已签 | 修正文档状态;PI 叙事另列 | `done` |
|
||||
| PI change-report narrative | deterministic report 已有 | 产品 go/no-go;只读 narrative、fallback 永久保留 | 当前 `deferred`;获批 short-term 开始后转 `partial` |
|
||||
| Frontend workbench | 当前声明范围均有证据 | 修正文档状态;增强另列 | `done` |
|
||||
| CI / E2E | PR CI、PG、backup、web 已有 | nightly real PI;TempDir race flake | `partial` |
|
||||
| Artifact promotion | 同 commit + receipt digests + 单机 same-image pin 已落地 | 远程 registry 不可变推送另立 | 当前 `done`(Wave 2C;单机 retag) |
|
||||
| Reliable events | 核心 live 且旧 hook 退出 | 与 FAV 拆行 | `done` |
|
||||
| FAV | 明确 off | 独立审计与 go/no-go | `deferred` |
|
||||
|
||||
### Phased Delivery
|
||||
|
||||
| Wave | Units | Release behavior | Exit gate |
|
||||
|---|---|---|---|
|
||||
| Wave 0: SSOT calibration | PU1–PU2 | 只改文档,不改代码或 flag;先只读核对已部署 IAM store 选择和缺表行为 | 三份 SSOT 无矛盾;历史指针可追溯;若发现当前发布契约回归,先更新 gap-matrix 再退出本波 |
|
||||
| Wave 1: Safety guardrails | PU3、PU5A | IAM fail-closed 与 race 修复独立交付 | 当前 B1–B4 全绿;授权用户 happy path 不变;新增 fail-closed 负例通过 |
|
||||
| Wave 2: Evidence closure | PU4 | 补真实 PI/browser/restart 证据;产品缺陷另开原子修复任务后重验 | 目标场景 PASS,或以明确 FAIL/blocker 退出;不得用“已分类”冒充关闭 |
|
||||
| Wave 2B: Release hardening | PU5B | 夜间 PI、promotion receipt、不可变 artifact 分阶段落地 | gate 可执行、可审计、可人工豁免且不改变已发布版本状态 |
|
||||
| Wave 3: Optional capability selection | PU6–PU8 | 只做逐能力 go/no-go 和独立任务设计;未获批不实施 | 有用户信号、收益、维护成本、owner 和预注册阈值;否则保持 deferred |
|
||||
|
||||
### System-Wide Impact
|
||||
|
||||
- **Authorization:** IAM inventory 覆盖 list/detail/search/export/count/SSE/RAG/Agent tools;任何 unavailable/error 路径 fail closed。
|
||||
- **Data lifecycle:** 新状态采用 additive migration;回滚继续读取和收口已有 plan/run/event。
|
||||
- **Agent parity:** UI、API、聊天和产品 PI Runner 共享 owner command 与 authorized view;Herdr 不进入产品验收。
|
||||
- **PI data boundary:** 真实 PI 只接收 allowlist 后的最小输入,并绑定 tenant/project;服务端脱敏,凭证最小权限且可轮换,日志和测试产物有访问与保留边界。
|
||||
- **Operations:** worktree 只做静态、单元和隔离 PG;合入、rebuild、共享容器和环境晋升占唯一集成槽。
|
||||
- **Documentation:** 历史证据不删除;过时文档增加 superseded/implemented 指针。
|
||||
|
||||
### Risks and Mitigations
|
||||
|
||||
| Risk | Consequence | Mitigation |
|
||||
|---|---|---|
|
||||
| 文档修改直接把 partial 改 done | 状态提升没有新证据 | PU1 定义证据门;PU2 只对已满足冻结边界的行收口 |
|
||||
| main 缺 IAM 表时回退内存 store | 权限和会话失去持久权威 | PU3 改为 dev/test 显式双门 opt-in;空值、未知环境和 main/prod 一律 fail closed |
|
||||
| multi-intent U8 code-complete 被写成 real-PI-complete | 误升 tier 后出现双执行或不可恢复 | PU4 独立补真实 PI、撤权、刷新和重启证据 |
|
||||
| full/none 语义混淆 | none 被错误要求审批或阻塞阶段 | PU4 分别验证 full 人工审批与 none 免审批负例 |
|
||||
| PI narrative 覆盖确定性事实 | 报告失真或阻断版本流程 | PU7 只消费只读 diff+lineage,任何 schema 偏差全量降级 |
|
||||
| 夜间 PI 偶发失败污染发布状态 | 无法区分供应商故障和产品回归 | PU5B 分类 infra/product failure,以 commit/digest receipt 阻止下一次晋升并保留审计豁免 |
|
||||
| 多 action 共用开关 | 无法单独回滚 | PU8 只产出独立 short-term、flag、owner 和证据契约,不在本计划批量实现 |
|
||||
| FAV 整支合入 | 带入旧实现或启用 degraded read | 保持 deferred;未来只摘取已审计的原子提交 |
|
||||
|
||||
---
|
||||
|
||||
## Implementation Units
|
||||
|
||||
### PU1. Define the matrix contract
|
||||
|
||||
- **Goal:** 为 `FEATURE-MATRIX.md` 建立能力状态、发布关系、关闭条件和证据字段的稳定契约。
|
||||
- **Requirements:** R1–R7。
|
||||
- **Dependencies:** 无。
|
||||
- **Files:** `.doc/status/FEATURE-MATRIX.md`、`.doc/ops/templates/feature-matrix-row.md`、`.doc/status/README.md`。
|
||||
- **Approach:**
|
||||
1. 在矩阵说明中定义 `done|partial|planned|deferred|blocked` 的判定和 `production_ready` 的独立来源。
|
||||
2. 将当前单一表改为可扫描的字段集合:声明范围、能力状态、发布关系、剩余工作、关闭条件、证据、owner/mutex。
|
||||
3. 定义证据 provenance 与重验触发器;不要把环境瞬时健康等同于代码已部署。
|
||||
- **Patterns to follow:** `gap-matrix.md` 的 blocker SSOT、`CURRENT.md` 的环境快照、`feature-matrix-row.md` 模板。
|
||||
- **Test scenarios:** Test expectation: none — 文档契约变更,不改变运行行为。
|
||||
- **Verification:** 模板和矩阵字段一致;每个状态都能由文档规则唯一解释;链接和 Markdown 校验通过。
|
||||
|
||||
### PU2. Reconcile current rows and historical pointers
|
||||
|
||||
- **Goal:** 修复已确认漂移,并将已完成基线与独立增强拆行。
|
||||
- **Requirements:** R1–R7。
|
||||
- **Dependencies:** PU1。
|
||||
- **Files:** `.doc/status/FEATURE-MATRIX.md`、`.doc/ops/CURRENT.md`、`.doc/remediation/gap-matrix.md`、`.doc/remediation/INDEX.md`、`.doc/system-design/2026-09-15-multi-intent-hitl-plan.md`、`.doc/remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md`、`.doc/remediation/2026-09-15-http-error-envelope-remediation.md`、`.doc/ops/research/2026-09-15-track-e-retrospective.md`。
|
||||
- **Approach:**
|
||||
1. 把 schema 45 改为当前 schema 47,纠正 D3/D5,移除 IAM 已关闭缺口。
|
||||
2. 将 L1、Chat/ctxmgr baseline、Document revision baseline、前端工作台、可靠事件核心按冻结范围评估为 `done`;把语义摘要、PI 叙事、多意图扩面和 FAV 分成独立行。
|
||||
3. 给被后续报告取代的历史文档增加 implemented/superseded 指针,不删除历史证据。
|
||||
4. 在任何状态收口前,只读核对已部署环境的 IAM store 选择、schema 47 IAM 表和缺表行为;确认 fallback 不可达才保持 `production_ready=yes`。若发现当前发布契约回归,立即更新 gap-matrix blocker,不等待后续波次。
|
||||
5. 每个拆行保留 before/after 边界、原义务的新去向和原边界已满足的证据,禁止仅通过缩小描述把行改为 `done`。
|
||||
- **Patterns to follow:** `.doc/archive/` 的历史保留纪律、现有测试报告回链。
|
||||
- **Test scenarios:** Test expectation: none — 这是证据对账和 SSOT 修订。
|
||||
- **Verification:** FEATURE-MATRIX、CURRENT、gap-matrix 对 schema、门禁和非 blocker 列表的叙事一致;不存在失效链接或相互矛盾状态。
|
||||
|
||||
### PU3. Close IAM inventory and production fail-closed gaps
|
||||
|
||||
- **Goal:** 用全路由证据替代旧抽样矩阵,并禁止 main/prod 在 IAM 表未就绪时回退内存 authority。
|
||||
- **Requirements:** R5–R12。
|
||||
- **Dependencies:** PU1;PU2 已完成部署事实核对。
|
||||
- **Files:** `.doc/audit/authorization-matrix-v2.md`、`internal/server/server.go`、`internal/server/auth_helpers.go`、`internal/server/chat_history_auth.go`、`internal/auth/store_factory.go`、`internal/auth/store_factory_test.go`、`internal/server/security_p0_test.go`、`internal/server/*_authz*_test.go`。
|
||||
- **Approach:**
|
||||
1. 从注册路由生成或维护 resource/action/owner/authn/ReBAC/ABAC/duty/negative-test inventory。
|
||||
2. 先验证 list/detail/search/export/count/SSE/RAG/Agent tools 是否共享授权集合;只修复确认的旁路。
|
||||
3. 只有环境明确为 dev/test 且 `ALLOW_IN_MEMORY=true` 时才允许测试 fallback;环境空值、未知值、main/prod、pool 缺失、IAM 表缺失或授权依赖不可用时一律启动失败或请求 fail closed。
|
||||
4. 先验证 schema 47 的 IAM 表在目标环境确实存在;缺迁移则以 additive migration 修复后再启用 fail-closed,禁止让保护措施把环境永久变成不可部署。
|
||||
5. 已建立 session 的请求也在授权依赖不可用时 fail closed;依赖恢复后按既有健康检查/重连路径恢复,不沿用缓存的旧授权。
|
||||
6. 将旧 API 410 视为兼容策略,依据遥测决定长期保留或退役,不再把“存在 410”本身写成能力缺口。
|
||||
- **Execution note:** 先添加 characterization 和负例,再修改 store selection 或路由授权。
|
||||
- **Test scenarios:**
|
||||
- main 配置下 IAM 表缺失时,应用不得创建 MemoryStore 管理员并继续服务。
|
||||
- 非成员、非 session owner、错误 stage、错误 duty 读取正文、计数、搜索、导出、SSE、RAG 和 Agent tool 时均拒绝且不泄漏资源存在性。
|
||||
- 管理员例外只通过服务端 `IsSystemAdmin`,请求体/header 不能伪造。
|
||||
- 权限在确认后撤销时,执行前重新授权并保持零副作用。
|
||||
- 仅 dev/test 加显式 opt-in 时内存 fixture 可用;环境未设置、拼错或 opt-in 为 false 均 fail closed。
|
||||
- IAM 依赖在 session 建立后中断时,正文、计数、搜索、SSE、RAG 和 Agent tools 均拒绝;恢复后重新取权,不沿用旧权限。
|
||||
- **Verification:** 全路由 inventory 每项有 owner 和负例;PG 集成与安全套件证明 fail closed;若发现 active bypass,先更新 gap-matrix 再继续其他波次。
|
||||
|
||||
### PU4. Close real-PI evidence gaps without pre-authorizing fixes
|
||||
|
||||
- **Goal:** 补齐 multi-intent U8 与工作流 full/none 的真实 PI、浏览器、持久化和恢复证据。
|
||||
- **Requirements:** R5–R13;Covers AE2、AE3。
|
||||
- **Dependencies:** PU1–PU2;测试设计可与 PU3 inventory 并行,最终证据必须基于 PU3 完成后的同一候选 artifact,且共享环境验收串行。
|
||||
- **Files:** `.doc/ops/checklists/` 下新增验收清单、`.doc/test-reports/` 下新增报告、`internal/server/workflow_governance_piagent_pg_test.go`、`internal/app/intentflow/` 相关测试、`web/` 对应 browser 测试与 assets。
|
||||
- **Approach:**
|
||||
1. multi-intent U8 验证真实 PI generate、PG plan/step/receipt、确认前零副作用、重复提交、撤权、双标签、刷新/重登/app+worker restart。
|
||||
2. full 文档走真实生成、author submit、独立 reviewer、独立 approver 和阶段门禁。
|
||||
3. none 文档走真实生成、版本账本、审批动作不适用和阶段不阻塞;禁止写成“none 审批通过”。
|
||||
4. 失败先归类为环境、验收脚本或产品缺陷;产品缺陷创建独立 `fix/*` 任务,修复后的同一场景必须重验,不能以“已分类”关闭证据缺口。
|
||||
5. 所有场景通过共享 PI 数据安全门:最小字段 allowlist、服务端脱敏、tenant/project 绑定、最小权限测试凭证和受限日志/产物;只使用隔离合成数据,并执行泄漏负例。
|
||||
- **Test scenarios:**
|
||||
- multi-intent U8 在无确认、确认、重复确认、活动计划冲突、权限撤销和 receipt 丢失下符合单一终态与幂等要求。
|
||||
- UI、直接 API 和聊天指令最终产生相同领域状态、actor、版本和可见结果。
|
||||
- full 文档跨三个真实用户完成职责分离;每次运行使用隔离 project/workspace 和命名空间,错误职责用户的每个动作均拒绝。
|
||||
- none 文档没有 submit/review/approve,可刷新和重启恢复,且不阻塞 advance。
|
||||
- runner/model 不可用时验收明确失败或 SKIP,不得记为产品 PASS。
|
||||
- **Verification:** 真实 PI、PG、browser、restart、cross-user 证据分栏归档;通过后只关闭对应证据缺口,不自动启用更高 tier。
|
||||
|
||||
### PU5A. Eliminate the repository race flake
|
||||
|
||||
- **Goal:** 独立关闭全仓 race 的 TempDir 清理竞态,不让外部模型可用性阻塞正确性修复。
|
||||
- **Requirements:** R5–R9。
|
||||
- **Dependencies:** PU1。
|
||||
- **Files:** `.github/workflows/ci.yml`、`internal/server/task_run_handlers_test.go` 或对应 `TestCreateTaskRun_PreActivationAcceptedNot409` fixture、`.doc/test-reports/`。
|
||||
- **Approach:**
|
||||
1. 定位并修复异步 worker 未收口导致的 TempDir 清理竞态;不能用跳过或忽略让全仓 race 假绿。
|
||||
2. 保留可重复的最小回归,并执行全仓 race 多轮验证。
|
||||
- **Test scenarios:**
|
||||
- 全仓 race 多次运行不再出现 TempDir RemoveAll,并能证明 worker 已退出。
|
||||
- **Verification:** 全仓 race 不再依赖已知 flake 豁免;PR CI 仍不依赖外部模型。
|
||||
|
||||
### PU5B. Add nightly PI and enforce auditable promotion receipts
|
||||
|
||||
- **Goal:** 增加夜间真实 PI 回归和可执行的下一次晋升门,同时逐步实现一次构建、按 digest 晋升。
|
||||
- **Requirements:** R5–R9、R13;Covers AE5。
|
||||
- **Dependencies:** PU1、PU4 的稳定场景;不阻塞 PU5A。
|
||||
- **Files:** `.github/workflows/nightly-real-pi.yml`、`.github/workflows/ci.yml`、`scripts/promote-to-test.sh`、`scripts/release-to-main.sh`、`docker-compose*.yml`、`.doc/test-reports/`。
|
||||
- **Approach:**
|
||||
1. 夜间 job 使用最小权限且可轮换的 secrets、隔离合成 project/session、真实 PI 标识、受限产物留存、并发取消和有限重试。
|
||||
2. 为被测 commit 生成不可变 promotion receipt,记录结论、时间、runner/model/protocol、commit 和 image digest;所有晋升入口必须验证目标 commit 的最新有效 receipt。
|
||||
3. 将 runner/credential/network failure 与产品断言失败分开。产品失败拒绝晋升;基础设施连续失败冻结下一次晋升,但允许发布负责人在确认外部故障、最近成功结果仍有效、PR/PG 门禁全绿后做带理由和时限的审计豁免。
|
||||
4. CI 从候选 commit 一次构建 app/events/PI Runner 镜像并记录 digest;test/main 最终只引用该 digest。在此能力完成前只可声称 same-commit 加各环境 digest 可追溯,不得声称 same-image promotion。
|
||||
- **Test scenarios:**
|
||||
- 缺 secret 或 runner 不可达时 job 为 infrastructure failure,不生成 PASS 报告。
|
||||
- 产品断言失败时保留脱敏后的 typed result、schema 和测试证据,告警到明确 owner,晋升脚本拒绝目标 commit。
|
||||
- 两次调度重叠时旧 run 被取消,不污染同一 fixture。
|
||||
- receipt 过期、commit/digest 不匹配、产品失败或未经审计的 infra failure 均拒绝晋升;有效时限内的人工豁免可追到发布负责人和理由。
|
||||
- **Verification:** nightly 具有 schedule/manual 入口、失败分类、owner、retention 和 promotion-gate receipt;test/main 能证明引用候选构建的同一 digest。
|
||||
|
||||
### PU6. Decide semantic-summary go/no-go and prepare its task contract
|
||||
|
||||
- **Goal:** 决定 D3 语义摘要是否值得实施;若获批,只创建独立 short-term 和完整执行契约,不在本计划直接改业务代码。
|
||||
- **Requirements:** R5–R13。
|
||||
- **Dependencies:** PU3 的授权 inventory;PU1–PU2 的独立行;独立产品 go/no-go。
|
||||
- **Files:** 本计划只更新 `.doc/backlog/chat-agent-p6-backlog.md` 和新 short-term;下列代码与测试路径属于获批任务契约:`internal/ctxmgr/summarizer.go`、`internal/app/chatflow/`、`internal/server/chat_digest_api.go`、对应 Go/PG 测试、`web/src/` 摘要消费组件与测试。
|
||||
- **Approach:**
|
||||
1. 实施前冻结当前用户痛点/使用信号、预期收益、维护成本、owner、最小样本、质量阈值和零容忍安全失败;未通过 go/no-go 则保持 deferred,本计划不实施。
|
||||
2. 获批任务必须只向无工具权限的摘要器提供 authorized view 和最小化输入,保存来源引用、输入版本、模型/协议和 freshness,并应用 R13 的共享 PI 数据安全门。
|
||||
3. 先 shadow 评估质量和泄漏负例,再决定是否替换 deterministic summary。
|
||||
4. 模型失败、超时或输出不安全时保留旧摘要或确定性 fallback,并明确 freshness。
|
||||
- **Test scenarios:**
|
||||
- 被撤权或跨阶段消息不进入新摘要、计数和引用。
|
||||
- prompt injection 只能作为材料,不能改变摘要权限或系统动作。
|
||||
- 新消息增量更新不重复旧内容;并发生成只提交一个当前版本。
|
||||
- 模型失败后刷新、重登和重启仍返回可解释 fallback。
|
||||
- **Verification:** 本计划验证 go/no-go 记录、预注册门和 short-term 契约完整;获批任务必须在 shadow、权限负例、PG 持久化和真实 browser 恢复通过后才更新 rollout tier。
|
||||
|
||||
### PU7. Decide PI-narrative go/no-go and prepare its task contract
|
||||
|
||||
- **Goal:** 决定可选 PI 叙事是否值得实施;若获批,只创建独立 short-term 和完整执行契约,不在本计划直接改业务代码。
|
||||
- **Requirements:** R5–R13;Covers AE4。
|
||||
- **Dependencies:** PU3 的授权边界;现有 typed-result-v1;独立产品 go/no-go。
|
||||
- **Files:** 本计划只创建独立 short-term;下列代码与测试路径属于获批任务契约:`internal/docrevision/service.go`、`internal/docrevision/risk.go`、`internal/taskrun/finalize.go`、`deploy/pi-agent/` typed result/schema、`web/src/components/doc/ChangeReportPanel.tsx` 及对应测试。
|
||||
- **Approach:**
|
||||
1. 实施前冻结当前用户痛点/使用信号、预期收益、维护成本、owner、最小样本、质量阈值和零容忍安全失败;未通过 go/no-go 则保持 deferred,本计划不实施。
|
||||
2. 获批任务中的 PI 必须在无写工具环境中只读消费经过 R13 安全门的 immutable input snapshot、diff、lineage 和服务端计算的 impact/risk floor。
|
||||
3. 输出使用版本化 typed schema,并绑定文档版本与输入 digest。
|
||||
4. partial/malformed、timeout、cancel、unknown schema、提示注入或 digest mismatch 一律全量降级到显式 fallback,不混合呈现部分 PI 字段。
|
||||
5. fallback 继续支持查看、确认/拒绝、刷新和重启恢复。
|
||||
- **Test scenarios:**
|
||||
- 合法 PI narrative 与对应 snapshot/version/digest 一致并在 UI 标出分析状态。
|
||||
- PI 试图降低风险、修改 hunk 或更改审批结论时,服务端忽略或拒绝。
|
||||
- malformed/timeout/cancel/retry 不产生第二份 candidate 或第二个终态。
|
||||
- 非授权用户不能从叙事、引用或计数推断不可见文档。
|
||||
- **Verification:** 本计划验证 go/no-go 记录、预注册门和 short-term 契约完整;获批任务必须证明 deterministic fallback 全量回归通过,且真实 PI/browser/restart 报告明确区分 narrative 与事实字段。
|
||||
|
||||
### PU8. Prepare independent multi-intent follow-up tasks
|
||||
|
||||
- **Goal:** 在 multi-intent U8 真实证据签署后,只形成 U9 实验和 U10–U12 单 action 的独立候选任务;不在本计划实施扩面。
|
||||
- **Requirements:** R5–R13。
|
||||
- **Dependencies:** PU3–PU4;独立产品 go/no-go;U9 实验不作为 U10–U12 的默认前置。
|
||||
- **Files:** `internal/app/intentflow/`、各 owner module 的 adapter/port/tests、`internal/events/registry.go`、`web/src/components/chat/InteractiveCard.tsx` 及对应测试、`.doc/ops/short-term/` 独立任务。
|
||||
- **Approach:**
|
||||
1. 每个候选项先冻结用户信号、预期收益、维护成本、owner、最小样本、晋级阈值和零容忍安全错误;未获批则保持 deferred。
|
||||
2. U9 候选仅提供规则无法判断时的 segment proposal;固定 schema/digest、最小输入、R13 安全门、护栏优先、超时 fail closed。
|
||||
3. U10 mutate、U11 docgov、U12 workflow/run-control 各自形成独立 short-term、flag、owner mutex、授权负例、回滚点和是否依赖 U9 的明确声明。
|
||||
4. 任务契约要求高风险动作绑定 expected revision 和显式确认,确认后执行前重新授权;按钮和自然语言进入同一 owner command。
|
||||
5. 任一 action 出现授权旁路、持久状态丢失、双 writer、跨用户泄漏或 B1–B4 回归时,停止全部剩余扩面并更新 gap-matrix;普通质量失败只回滚该 action。
|
||||
- **Test scenarios:**
|
||||
- U9 malformed/timeout、span 越界、风险降级和红线拆分逃逸全部 fail closed;敏感内容不出站。
|
||||
- 每个 action 在未确认、越权、stale revision、重复提交和部分完成时保持零越界副作用与可恢复状态。
|
||||
- 双标签确认/取消只有一个成功;投影停机时权威 GET 仍正确。
|
||||
- 旧版本回滚后已有计划仍可读取、取消和 finalize,新建保持关闭。
|
||||
- **Verification:** 本计划只验证每个候选任务边界、go/no-go、预注册门、独立 flag/rollback 和全局安全 stop gate 完整;后续获批任务各自通过真实证据后才可加入更高 tier。
|
||||
|
||||
---
|
||||
|
||||
## Verification Contract
|
||||
|
||||
| Layer | Applies to | Required evidence | Done signal |
|
||||
|---|---|---|---|
|
||||
| Documentation | PU1–PU2 | Markdown/link check、`git diff --check`、三份 SSOT 人工对账、before/after 边界与义务迁移表 | 无矛盾、无断链、无无证据状态提升或缩口径假完成 |
|
||||
| Authorization inventory | PU3 | 注册路由全集与 resource/action/owner/authn/ReBAC/ABAC/duty/negative-test 映射 | 无未认领路由;每项有服务端门和负例 |
|
||||
| Static/unit | PU3、PU5A–PU8 | `go vet ./...`、相关 Go tests、`cd web && npm test && npm run build`、`arch-check --mode block` | 所有受影响包通过 |
|
||||
| PostgreSQL | PU3–PU8 | 隔离 `TEST_DATABASE_URL`、迁移、并发、幂等、fail-closed 负例 | 无 skip 冒充 PASS,数据可重启恢复 |
|
||||
| Race | PU3、PU5A、后续 multi-intent action | 相关包 race;PU5A 关闭全仓 TempDir flake | 无 data race、无异步清理残留 |
|
||||
| Real PI | PU4、获批后的 PU6–PU8 | 真实产品 PI Agent Runner、记录 model/protocol/typed result 和 R13 数据安全门 | 不使用 stub 或 Herdr 代替;无敏感数据泄漏 |
|
||||
| Browser | PU4、获批后的 PU6–PU8 | 真实登录、UI 操作、双用户/职责负例、刷新/重登/restart | 页面可见结果与 PG/账本一致 |
|
||||
| Deployment | 所有运行时波次 | 占集成槽 rebuild、`/ready`、promotion receipt;PU5B 完成后按不可变 digest 晋升 | 当前阶段可追到同一 commit 和各环境 digest;加固后 test/main 引用同一候选 digest |
|
||||
| Rollback | PU3–PU8 | disable/drain、旧版本兼容读取、cancel/finalize、无双 writer;上一版本二进制针对 expanded schema 的兼容演练 | 当前基线恢复且无孤儿状态;旧 app/worker 能识别并安全收口新状态 |
|
||||
|
||||
夜间真实 PI 的外部依赖失败和产品回归必须分栏。PR CI 不依赖外部模型;夜间 job 稳定前不提升为合并必需检查。
|
||||
|
||||
---
|
||||
|
||||
## Definition of Done
|
||||
|
||||
- [x] PU1–PU2 完成后,矩阵能明确区分当前完成范围、发布关系、剩余工作和关闭条件,并保留拆行前后的义务 lineage。
|
||||
- [x] schema 45、D3/D5、IAM 历史缺口、前端状态和事件/FAV 混行均已纠正。
|
||||
- [x] L1、Chat/ctxmgr baseline、Document revision baseline、前端工作台和可靠事件核心的状态调整有现有证据支持;语义摘要、PI 叙事、多意图扩面与 FAV 已拆成独立 deferred 行。
|
||||
- [x] PU3 形成全路由授权 inventory,并证明只有 dev/test 显式双门才允许内存 fixture,其他环境与既有 session 均 fail closed。
|
||||
(2026-09-16:`NewStores` 双门 fail-closed 已合入;全路由 inventory / session 中断负例仍开放,不挡本项核心旁路关闭)
|
||||
- [x] PU4 的 multi-intent U8 与 full/none 真实 PI/browser/restart/cross-user 证据独立归档;失败未被文档改写掩盖。
|
||||
(2026-09-16:Wave2 报告已签;Playwright 双标签仍 gated,API 刷新/重启已签;不升 tier)
|
||||
- [x] PU5A 的 TempDir race flake 被真正关闭;PU5B 的 nightly job、promotion receipt 和人工豁免链能区分 infrastructure/product failure。
|
||||
(2026-09-16:PU5A 已关闭;PU5B **nightly+receipt+晋升钩子**已交付——见 [Wave2B 报告](../test-reports/2026-09-16-wave2b-nightly-promotion-receipt-test-report.md)。**同镜像 digest 晋升**已由 [Wave2C](../test-reports/2026-09-16-wave2c-same-image-digest-test-report.md) 单机 pin 关闭;远程 registry 另立。)
|
||||
- [x] PU6–PU8 已分别完成产品 go/no-go;未获批项保持 deferred,获批项另建 short-term 后才进入实现与 rollout DoD。
|
||||
(2026-09-16:全部 **no-go / deferred**——见 [Wave3 go/no-go](../ops/research/2026-09-16-wave3-pu6-pu8-go-no-go.md) 与 `.doc/ops/long-term/2026-09-16-pu6-*` / `pu7-*` / `pu8-*` 契约;禁止实施与升 tier。)
|
||||
- [x] 任何真实 PI 工作均满足 R13 的最小出站、租户绑定、脱敏、凭证、留存和泄漏负例。
|
||||
(2026-09-16:nightly/receipt 路径使用隔离合成 DB、脱敏 evidence_refs、凭证不入库;完整 R13 矩阵审计见 Phase3 handoff 开放项,不挡本勾选的运行时门。)
|
||||
- [x] deterministic summary/change-report、legacy 单意图、B1–B4 和三环境隔离均无回归。
|
||||
(合入冒烟 `go vet` + `go test -short`;三环境 schema 47 快照保持;未升 MULTI_INTENT tier。)
|
||||
- [x] `gap-matrix.md` 只在真实 blocker 出现或关闭时变化,`production_ready` 不因普通 backlog 自动翻转。(Wave 0:仅增加 IAM 只读核验注记,未翻转)
|
||||
- [x] 放弃的实验代码、临时 flag、诊断 fixture 和测试数据已清理;历史失败证据保留且有正确指针。
|
||||
(promotion-receipt fixtures 为门禁故意保留;FAV 旁支不合入;见 Phase3 handoff。)
|
||||
|
||||
---
|
||||
|
||||
## Appendix
|
||||
|
||||
### Source paths
|
||||
|
||||
- `.doc/audit/2026-09-16-feature-matrix-production-readiness-audit.md`
|
||||
- `.doc/status/FEATURE-MATRIX.md`
|
||||
- `.doc/remediation/gap-matrix.md`
|
||||
- `.doc/ops/CURRENT.md`
|
||||
- `.doc/archive/ops/short-term/2026-09-16-production-ready-gates.md`
|
||||
- `.doc/system-design/2026-09-15-multi-intent-hitl-plan.md`
|
||||
- `.doc/test-reports/2026-09-16-multi-intent-u8-task-generate-test-report.md`
|
||||
- `.doc/test-reports/2026-09-16-chat-refresh-gate-test-report.md`
|
||||
- `.doc/test-reports/2026-09-14-workflow-plan-409-frozen-and-optional-duties-test-report.md`
|
||||
- `.doc/test-reports/2026-09-14-document-revision-runtime-ui-test-report.md`
|
||||
- `.doc/test-reports/2026-09-15-phase2-closeout-test-report.md`
|
||||
- `.doc/test-reports/2026-09-12-phase1-iam-authz-test-report.md`
|
||||
- `.doc/backlog/chat-agent-p6-backlog.md`
|
||||
|
||||
### Current decision summary
|
||||
|
||||
- 当前没有新增 production-ready blocker。
|
||||
- 当前首发范围可关闭的状态漂移:Intent L1、前端工作台、可靠事件核心。
|
||||
- 当前应保持 `partial`:多意图基线、工作流治理、IAM、CI/E2E;artifact promotion 作为独立发布加固跟踪。
|
||||
- 当前可按冻结范围收口并把增强拆行:Chat/ctxmgr baseline、Document revision baseline。
|
||||
- 当前应独立 `deferred`:语义摘要、PI change-report narrative、FAV、多意图未获批扩面、D7 合规治理;纯软件项目自举不在本计划范围。
|
||||
@@ -0,0 +1,226 @@
|
||||
---
|
||||
title: "FEATURE-MATRIX partial/deferred 全量收口计划"
|
||||
status: in_progress
|
||||
created: 2026-09-16
|
||||
updated: 2026-09-17
|
||||
type: refactor
|
||||
owner: Cline
|
||||
branch: docs/partial-deferred-completion-plan
|
||||
mutex: architecture-docs
|
||||
---
|
||||
|
||||
# FEATURE-MATRIX partial/deferred 全量收口计划
|
||||
|
||||
## 1. 背景
|
||||
|
||||
- **用户授权(2026-09-16)**:已设计的功能与特性尽量推进到 `done`,不停留在 `partial`/`deferred`;保持功能、模块的独立与解耦;确认模块间通信机制;建立系统契约,保证新功能添加、已有功能修改的影响面收敛在所属模块,不扩散到其他模块。
|
||||
- **收口对象**:[FEATURE-MATRIX](../status/FEATURE-MATRIX.md) 中 6 行 `partial` + 1 行 `deferred`(见 §3 总表)。
|
||||
- **上位约束**:`production_ready=yes` 与发布门禁 B1–B4 已签。本计划是**能力成熟度收口**,与发布门禁正交;`production_ready` 只由 [gap-matrix](./gap-matrix.md) 决定,本计划不得反向触碰已签门禁。
|
||||
- **通信机制结论先行**:本系统为模块化单体,模块间通信**不采用、也不应改成通用 IPC/RPC**;已确认的跨进程边界全部走 HTTP 与 PG 持久事件。详见 §2。
|
||||
|
||||
## 2. 通信与解耦机制确认(IPC/RPC 问题的回答)
|
||||
|
||||
**结论:系统是模块化单体([ADR 2026-09-14-modular-monolith-decoupling](../adr/2026-09-14-modular-monolith-decoupling.md)),模块级隔离靠「消费者窄端口 + 组合根唯一装配 + 契约门禁」实现,而非 RPC 层。**已确认的通信边界共四类:
|
||||
|
||||
| 边界 | 机制 | 状态 |
|
||||
|---|---|---|
|
||||
| Web ↔ server | `/api/v1/*` HTTP + SSE(typed error envelope) | 已运行 |
|
||||
| Go server ↔ PI Agent Runner | HTTP + Bearer(typed-result-v1) | 已运行 |
|
||||
| 单体内模块 | 消费者窄端口 + `internal/app` 组合根唯一装配 | 已运行 |
|
||||
| 跨进程领域事件 | PG outbox(envelope/delivery)+ `cmd/events` 独立 worker 原子 lease 消费 | 已运行(notify/advance/projection live) |
|
||||
|
||||
**为什么不把单体内端口改成 RPC**(依据 [IPC/RPC 现状评估](../ops/research/2026-09-15-module-decoupling-ipc-assessment.md)):RPC 会增加序列化、延迟、部分失败与运维成本,却不消除 locator、授权、幂等和事件消费缺口;真正的进程级解耦已由 `cmd/events` worker(经 PG lease,而非服务间直连)与两条 HTTP 边界承担。用户要求的「通过 IPC/RPC 通信」在本系统的正确落法即:**跨进程一律走既有 HTTP / PG 事件边界;模块级独立解耦靠端口与契约门禁**。若未来确需新增跨进程边界,须先立 ADR,沿用「HTTP 或 PG 事件」两种既有模式。
|
||||
|
||||
### 2.1 系统契约体系(防扩散的既存机制,本计划全部沿用)
|
||||
|
||||
| 契约 | 载体 | 强制方式 |
|
||||
|---|---|---|
|
||||
| Import / SQL write / path / event 边界 | `.doc/system-design/module-boundaries.yaml` | `internal/archtest` + `./scripts/arch-check.sh --mode block`;import/event 违规零容忍(block_kinds) |
|
||||
| 领域事件 schema 与生产者/消费者 | `events.Envelope` schema 1 + YAML allowlist ↔ `StaticContracts` parity | 构建期 parity 门禁;未登记事件不得投递 |
|
||||
| 任务幂等与产物 | `taskrun.RunManifest` canonical JSON + SHA-256 + idempotency key | 服务端强制;异 digest 冲突 |
|
||||
| HTTP 错误语义 | typed error envelope(details allowlist + 脱敏) | 已合入(H1–H3) |
|
||||
| PI Runner 协议 | typed-result-v1 + handshake;typed 字段存在但无效 → fail closed | 已合入 |
|
||||
| 能力灰度 | 每能力独立 flag,默认 off / legacy / shadow | 各契约预注册晋级阈值 |
|
||||
| 并行认领互斥 | FEATURE-MATRIX `mutex` 列 → CURRENT 认领表 | 同一 mutex 同时仅一个 `in_progress` |
|
||||
|
||||
### 2.2 变更影响面收敛守则(每个波次必须遵守)
|
||||
|
||||
1. 新能力一律落在**深模块**(模式参考 `internal/app/intentflow`、`internal/doccontent`),禁止把实现聚集回 coordinator/bizdev。
|
||||
2. 模块间只允许三种交互:消费者拥有的窄端口、组合根装配、领域事件;**禁止新增跨模块 import**(arch-check block 兜底)。
|
||||
3. schema 变更只走 additive migration;旧版本兼容读取;每个放量有独立回滚点。
|
||||
4. 每个能力一个独立 flag;默认 off;晋级按预注册阈值(shadow → confirm → live/replace),禁止共用开关批量上线。
|
||||
5. 新增事件必须同时补 YAML allowlist 与 `StaticContracts` 并过 parity 门禁。
|
||||
6. 修改声明范围须保留 before/after lineage 与义务迁移(矩阵更新规则 4);禁止缩口径假完成。
|
||||
|
||||
## 3. 收口对象与关闭条件总表
|
||||
|
||||
| # | 行 | 当前 | 目标 done 的关闭条件(依据矩阵「剩余工作/关闭条件」列) | mutex |
|
||||
|---|---|---|---|---|
|
||||
| P1 | CI / E2E | partial | Actions secret/runner 环境配置完成 + FullNone product_fail 收口 + 一轮绿色 nightly receipt | `ci` |
|
||||
| P2 | 语义摘要(D3) | partial | `SEMANTIC_SUMMARY_SHADOW` 开启并取得真实 PI + R13 + 负例证据;(可选)`SEMANTIC_SUMMARY_REPLACE` 灰度 | `chat` |
|
||||
| P3 | PI change-report 叙事 | partial | `PI_CHANGE_REPORT_NARRATIVE` 开启 + 真实 PI 叙事 + fallback 全量负例 + UI narrative/事实字段区分 | `docgov` |
|
||||
| P4 | 多意图扩面(U9–U12) | partial | U9→U12 逐 action 独立 flag 证据闭环(真实 PI + 浏览器 + 负例);tier 升级评估 | `intent-plan` |
|
||||
| P5 | 纯软件项目自举 | partial | SWBOOT-10 非 stub 实现 + 真实 PI 全链路 + UI 二次验收 | `workflow-design` |
|
||||
| P6 | Final Artifact Vault(FAV) | partial | subscriber 独立审计 → shadow → live;崩溃/重启幂等;`FAV_DEGRADED_READ=false` 保持;**禁止整支 merge 保持** | `events` |
|
||||
| P7 | 对话数据治理(D7) | deferred | 数据分类盘点 → 留存/删除口径 → 库/备份/日志控制 → 敏感字段加密边界;**发现违规 → 立即升 gap-matrix blocker** | `chat` |
|
||||
|
||||
**并行度**:P1 与其余全部可并行;P3/P4/P5/P6 各自 mutex 互不冲突可并行;**P2 与 P7 共用 `chat` mutex,须串行(先 P2 后 P7)**。Playwright 双标签升 `confirm/full` 属 `intent-plan` 辅助任务(见 [2026-09-16-intent-plan-playwright-dual-tab](../ops/long-term/2026-09-16-intent-plan-playwright-dual-tab.md))。
|
||||
|
||||
## 4. 分波次计划
|
||||
|
||||
每波通用流程:从 `dev` 开独立分支(`feature/<slug>`)→ CURRENT 登记 → worktree 编码与单测 → 占集成槽合并 `dev` + 冒烟(`go vet` / `go test -short` / `env-service.sh dev rebuild` + `/health`)→ test-report 归档 → FEATURE-MATRIX 行升 `done`(保留 lineage)。
|
||||
|
||||
### W1(mutex `ci`):CI / E2E → done
|
||||
|
||||
**现状**:nightly 入口 + 失败分类 + promotion-receipt 门禁已交付;TempDir race 已修;PR CI 不依赖外部模型。剩余:环境配置与 FullNone product_fail。
|
||||
|
||||
1. Actions secret 录入:`TEST_DATABASE_URL`、nightly 专用 `RUN_PI_E2E` / `RUNNER_AUTH_TOKEN`(隔离合成数据);runner 注册与自检。
|
||||
2. FullNone product_fail 收口:按 infra/product 分栏定位,修复产品失败或确认分类归属;nightly `DATA_DIR=dev` 保持对齐。
|
||||
3. 跑一轮完整 nightly → green receipt 归档。
|
||||
4. 矩阵行升 `done`(证据:[Wave2B](../test-reports/2026-09-16-wave2b-nightly-promotion-receipt-test-report.md)、[Wave2C](../test-reports/2026-09-16-wave2c-same-image-digest-test-report.md) + 新 green receipt)。
|
||||
|
||||
**回滚**:纯环境/CI 配置,不影响业务行为;secret 配置错误仅影响 nightly,不挡 PR CI。
|
||||
|
||||
### W2(mutex `chat`):PU6 语义摘要 D3 → done
|
||||
|
||||
1. dev 环境 `SEMANTIC_SUMMARY_SHADOW=on`(test 环境随后),收集 shadow 对账:authorized view only、无工具权限摘要器、R13 出站门。
|
||||
2. 真实 PI(MiniMax)摘要证据:freshness 标注、可解释 fallback。
|
||||
3. 负例矩阵:撤权消息不入摘要;injection 不能改权限;失败保留旧摘要/deterministic。
|
||||
4. 达预注册阈值后 **默认不启用** `SEMANTIC_SUMMARY_REPLACE`(见 §7.3);若另开授权再灰度(独立回滚:关 flag 回 deterministic)。
|
||||
5. 矩阵行升 `done`;[契约](../ops/long-term/2026-09-16-pu6-semantic-summary-contract.md)状态更新。
|
||||
|
||||
**路径**:`internal/ctxmgr/summarizer.go`、`internal/app/chatflow/`、`internal/server/chat_digest_api.go`、web 摘要组件。
|
||||
|
||||
### W3(mutex `docgov`):PU7 PI change-report 叙事 → done
|
||||
|
||||
1. dev `PI_CHANGE_REPORT_NARRATIVE=on`:真实 PI 只读消费 immutable diff+lineage+risk floor。
|
||||
2. typed schema `change_report_narrative_v1` + input digest 绑定;任意 schema/超时/注入 → 全量 fallback(负例必测)。
|
||||
3. UI 验收:narrative 与事实字段明确区分;禁止覆盖服务端风险/审批结论。
|
||||
4. 矩阵行升 `done`(deterministic fallback 仍是本行显式声明行为)。
|
||||
|
||||
**回滚**:关 flag,仅 deterministic fallback,无第二份 candidate。契约:[pu7](../ops/long-term/2026-09-16-pu7-pi-narrative-contract.md)。
|
||||
|
||||
### W4(mutex `intent-plan`):PU8 U9–U12 → done
|
||||
|
||||
**顺序 U9→U10→U11→U12,逐 action 独立 flag,禁止共用开关批量上线:**
|
||||
|
||||
1. U9 `MULTI_INTENT_U9_SEGMENT`:真实 LLM 分段 shadow→confirm;规则无法判断时才出 proposal;stub fail-closed 保持。
|
||||
2. U10 `MULTI_INTENT_U10_MUTATE`:dry-run + expected revision 门禁;未确认/越权/stale revision/重复提交 → 零越界副作用。
|
||||
3. U11(docgov)、U12(workflow/run-control):按各自契约同模式推进。
|
||||
4. 每个 action:真实 PI + Playwright 双标签 + 负例;独立报告与回滚点。
|
||||
5. 全部闭环后:评估 `MULTI_INTENT_PLAN_TIER` legacy→confirm(**独立任务、独立授权**,默认不升 full;full 另拆行/backlog)。
|
||||
6. 矩阵行升 `done`(声明范围 = 四个 action 的 flag 证据闭环;tier=full 不在本行关闭条件内)。
|
||||
|
||||
契约:[u9](../ops/long-term/2026-09-16-pu8-u9-segment-proposal-contract.md) / [u10](../ops/long-term/2026-09-16-pu8-u10-mutate-contract.md) / u11 / u12。
|
||||
|
||||
### W5(mutex `workflow-design`):纯软件项目自举 → done
|
||||
|
||||
1. SWBOOT-10 从 stub 收口为真实现(按 [short-term](../ops/short-term/2026-09-16-software-project-bootstrap.md) 与 [ADR keys](../adr/2026-09-16-software-project-bootstrap-keys.md))。
|
||||
2. 真实 PI 全链路:`software_bootstrap` 工作流 创建→规划→交付(首期 docs_only / read_only_repo)。
|
||||
3. Playwright UI 二次验收:服务端目录驱动的创建向导(停止前端固定克隆 7 份模板)、单人项目「无独立评审」显式标记。
|
||||
4. 矩阵行升 `done`(范围沿用现状调研的复用/新增边界,不改医疗三工作流语义)。
|
||||
|
||||
### W6(mutex `events`):FAV → done
|
||||
|
||||
1. subscriber 独立审计(沿用 U7 增量路径,**继续禁止整支 merge FAV 分支**)。
|
||||
2. publisher/consumer flag **shadow**:只计算 intended outcome,不执行业务副作用。
|
||||
3. shadow 阈值达标后按 §7.4 逐 consumer **live**(顺序 staging → artifact → publication;每级观察窗 ≥7 天或证据阈值):幂等(唯一键/no-replace);崩溃/重启重放无重复可见结果。
|
||||
4. `FAV_DEGRADED_READ=false` 保持默认;degraded 读取仅在显式开启时可用并有告警(不随 live 开启)。
|
||||
5. 矩阵行升 `done`(声明范围:不可变终态制品库闭环)。
|
||||
|
||||
### W7(mutex `chat`,排在 W2 后):D7 对话数据治理 → done
|
||||
|
||||
**前提**:留存/删除口径见 §7.1 与 [D7 ADR 草案](../adr/2026-09-17-d7-chat-data-retention.md)(数字 `pending-compliance-signoff`;合规签字前禁止按建议数字执行物理删除/备份清除)。
|
||||
|
||||
1. 数据分类盘点(产出 audit 文档):chat_sessions/messages、KB、日志、备份、event 表中的敏感字段清单与流转路径。
|
||||
2. 合规签字或改数后:更新 ADR 状态;库/备份/日志控制盘点。
|
||||
3. 差距整改:日志/dead-letter/reconciliation 只存 ID、digest、typed error code 与 allowlist 摘要(Track E 红线沿用)。
|
||||
4. 敏感字段加密边界决策与落地(首期默认不做字段级加密,见 §7.1)。
|
||||
5. **若盘点确认基线违规 → 立即写 gap-matrix blocker,本行 done 让位于整改**;无违规且口径落地 → 矩阵行升 `done`。
|
||||
|
||||
## 5. 测试方案(层级矩阵)
|
||||
|
||||
| 层级 | 适用波次 | 内容 | 通过标准 |
|
||||
|---|---|---|---|
|
||||
| Arch / contract | 全部 | `./scripts/arch-check.sh --mode block`;YAML ↔ `StaticContracts` parity | import/event 违规 = 0;无未登记事件 |
|
||||
| 单测 | 全部 | `go vet ./...` + `go test -short ./...`;相关包 `-race` | 全绿;无 data race |
|
||||
| PG 集成 | W2/W4/W5/W6/W7 | `TEST_DATABASE_URL` 下集成 + additive migration/回滚演练 | 持久化、恢复、旧版本兼容读取 |
|
||||
| 真实 PI | W2/W3/W4/W5 | 真实 PI Agent Runner + MiniMax;记录 model/protocol/typed result;R13 数据安全门(最小出站、租户绑定、脱敏、凭证最小权限、泄漏负例) | 无 stub 冒充;无敏感出站 |
|
||||
| 浏览器 | W2/W3/W4/W5 | Playwright:真实登录、双用户/职责负例、刷新/重登/重启 | 页面结果与 PG/账本一致 |
|
||||
| 部署 | 全部运行时波次 | 占集成槽 rebuild、`/health`、promotion receipt(same digest 晋升) | 可追到同一 commit + digest |
|
||||
| 回滚 | W2–W6 | disable/drain、旧版本兼容读取、无双 writer、孤儿状态检查 | 上一版本恢复且无孤儿状态 |
|
||||
|
||||
每波验收报告归档 `.doc/test-reports/`(遵循 test-reports-standard),回链本计划与对应契约;矩阵状态提升必须同时核对源码、迁移、artifact、API/runtime 与测试层级(上位计划 R5–R7)。
|
||||
|
||||
## 6. 风险与停走门
|
||||
|
||||
| 风险 | 停走门 |
|
||||
|---|---|
|
||||
| 授权旁路 / 跨用户泄漏 / 双 writer / main 或 prod fail-open | 任一波发现 → 停止全部扩面,写 gap-matrix |
|
||||
| B1–B4 门禁回归 | 每波合 dev 冒烟全绿;回归即停 |
|
||||
| stub / SKIP / deterministic fallback 冒充真实 PI | 验收报告必须记录真实 runner/model;SKIP 不得写成 PASS |
|
||||
| flag 批量上线 / 共用开关 | 一个能力一个 flag;违规合并打回 |
|
||||
| 缩小声明范围制造 done | 矩阵审查:before/after lineage 必须保留,义务迁移可追 |
|
||||
| 三环境隔离破坏 | 每波验证不跨环境读写;schema 迁移三环境同步(当前 47) |
|
||||
| FAV 整支 merge | 保持禁止;只走增量分支 + 独立审计 |
|
||||
|
||||
## 7. 已确认决策(原开放问题;2026-09-17 用户确认采纳建议默认)
|
||||
|
||||
> 决策冻结 ≠ 放量:不改生产默认 env / flag;各波仍按原 mutex 与独立授权推进。
|
||||
|
||||
### 7.1 D7 留存期限与删除口径(W7 前置)
|
||||
|
||||
**决策**:工程按下列草案落 ADR([2026-09-17-d7-chat-data-retention](../adr/2026-09-17-d7-chat-data-retention.md));数字标 `pending-compliance-signoff`,合规签字或改数后 W7 方可按口径整改。不得无限期停在 deferred。
|
||||
|
||||
| 数据类 | 留存(建议默认) | 删除路径 |
|
||||
|---|---|---|
|
||||
| 会话正文(chat messages) | 热库 **365 天**可配置;超期 soft-delete → 观察窗 → 物理清理 | 用户删除同路径;备份清除需二次批准 + 精确 delete manifest(R22) |
|
||||
| 派生文档 / 私密文档 | 与聊天**独立周期**;回收站 **30 天**后物理清理 | 删除 UI 必须说明「只删聊天 / 只删文档 / 两者」 |
|
||||
| 审计元数据(导出/治理审计) | **180 天** | 不可被普通用户删除覆盖 |
|
||||
| Agent trace / workspace 非终态 | 任务结束后 **30 天**;nightly 仅合成数据 | 禁止当长期事实源 |
|
||||
| 日志 / dead-letter / reconciliation | Track E:**只存 ID、digest、typed error code、allowlist 摘要** | 禁止存 payload/prompt/正文 |
|
||||
| FAV 终态制品 | `retention_class` + legal hold + delete ledger | 与 D7 聊天口径解耦 |
|
||||
|
||||
**加密边界**:首期「敏感字段盘点 + 传输/备份访问控制」;不默认上字段级加密。
|
||||
**违规门**:盘点确认基线违规 → 立即写 gap-matrix;本行 done 让位于整改。
|
||||
|
||||
### 7.2 `MULTI_INTENT_PLAN_TIER` 是否升 `confirm`
|
||||
|
||||
**决策**:W4(U9→U12)证据闭环后,**可启动独立授权任务**将默认从 `legacy` 升至 `confirm`;**永不默认升 `full`**(`full` 另拆矩阵行/backlog,按 action 逐项加入)。
|
||||
|
||||
升 `confirm` 硬前置(全部满足):
|
||||
|
||||
1. U9→U12 各自独立 flag 证据闭环(真实 PI + Playwright 双标签 + 负例)
|
||||
2. 停走指标全 0:未确认/越权副作用、安全红线绕过、hard-negative 自动执行、重复确认双跑、refresh/restart 权威差
|
||||
3. 独立 short-term + 用户显式授权(合入功能代码不得顺带改默认 env)
|
||||
4. 放量:`dev` 观察 → `test` → **不自动**推 `main`
|
||||
|
||||
### 7.3 `SEMANTIC_SUMMARY_REPLACE` 是否启用
|
||||
|
||||
**决策**:**默认不启用**。W2 升 `done` 只要求 `SEMANTIC_SUMMARY_SHADOW` + 真实 PI + R13 + 负例;**不依赖** REPLACE。REPLACE 为 W2 之后可选后置任务,须另开授权 + 接线 + fail-closed 灰度(`dev`→`test`;关 flag 回 deterministic)。
|
||||
|
||||
### 7.4 FAV live 消费者上线顺序与观察窗口
|
||||
|
||||
**决策**:固定顺序 **staging → artifact → publication**;每步 shadow → drain → live;观察窗证据驱动(每级下限 **≥7 天**或 ≥N 终态样本,取更严);`FAV_DEGRADED_READ` **全程保持 false**(不随 live 开启)。禁止整支 merge FAV;每 consumer 独立 flag;一窗失败则停在该级并回 shadow/off。
|
||||
|
||||
## 8. 验收标准(Definition of Done)
|
||||
|
||||
- [ ] W1–W6 各波 test-report 归档并回链;对应 FEATURE-MATRIX 行升 `done`(保留 lineage)。
|
||||
- [ ] W7 数据分类盘点与口径文档落地;或违规升级 gap-matrix(该行转为整改跟踪)。
|
||||
- [ ] 全程 `production_ready` 不翻转;gap-matrix 仅在真实 blocker 出现/关闭时变化。
|
||||
- [ ] `arch-check --mode block` 全程通过;无新增跨模块 import、无未登记事件。
|
||||
- [ ] 所有新 flag 保持独立且默认 off/legacy/shadow;每个放量有独立回滚点。
|
||||
- [ ] B1–B4 门禁零回归(每波合 dev 冒烟全绿)。
|
||||
- [x] 开放问题 §7 的四项决策均已获用户确认(2026-09-17;见 §7.1–§7.4)。
|
||||
|
||||
## 9. 相关链接
|
||||
|
||||
- 矩阵 SSOT: [../status/FEATURE-MATRIX.md](../status/FEATURE-MATRIX.md)
|
||||
- 连续性审计: [../audit/2026-09-16-feature-matrix-production-readiness-audit.md](../audit/2026-09-16-feature-matrix-production-readiness-audit.md)
|
||||
- 上位计划: [./2026-09-16-feature-matrix-production-readiness-plan.md](./2026-09-16-feature-matrix-production-readiness-plan.md)
|
||||
- 发布门禁: [./gap-matrix.md](./gap-matrix.md)
|
||||
- D7 留存 ADR 草案: [../adr/2026-09-17-d7-chat-data-retention.md](../adr/2026-09-17-d7-chat-data-retention.md)
|
||||
- IPC/RPC 调研: [../ops/research/2026-09-15-module-decoupling-ipc-assessment.md](../ops/research/2026-09-15-module-decoupling-ipc-assessment.md)
|
||||
- 模块解耦 Phase 2: [./2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md](./2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md)
|
||||
- 契约: `../ops/long-term/2026-09-16-pu6-*` · `pu7-*` · `pu8-u9…u12`
|
||||
- 总控 short-term: [../ops/short-term/2026-09-16-partial-deferred-completion.md](../ops/short-term/2026-09-16-partial-deferred-completion.md)
|
||||
@@ -3,6 +3,8 @@
|
||||
| 文档 | 说明 |
|
||||
|------|------|
|
||||
| [gap-matrix.md](./gap-matrix.md) | 发布缺口 SSOT |
|
||||
| [2026-09-16-partial-deferred-completion-plan.md](./2026-09-16-partial-deferred-completion-plan.md) | FEATURE-MATRIX 6 partial + 1 deferred 全量收口:通信机制确认(模块化单体,不新增 RPC 层)、7 项关闭条件、W1–W7 波次;§7 四项决策已确认(2026-09-17) |
|
||||
| [2026-09-16-feature-matrix-production-readiness-plan.md](./2026-09-16-feature-matrix-production-readiness-plan.md) | 能力状态与发布门禁解耦、证据校准、剩余 partial 收口和 production-ready 防回退计划([审计](../audit/2026-09-16-feature-matrix-production-readiness-audit.md)) |
|
||||
| [2026-09-14-module-decoupling-refactor-plan.md](./2026-09-14-module-decoupling-refactor-plan.md) | 纵向绞杀、UnitOfWork、高并发互斥、可靠事件、逐动作授权、FAV、迁移与恢复的详细重构计划 |
|
||||
| [2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md](./2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md) | Phase 2 修订版:Track E 持久事件交付先行;Track S 结构解耦独立 go/no-go;HTTP 与 PI 协议另立 remediation([审阅](../audit/2026-09-15-module-decoupling-phase2-plan-review.md);[调研](../ops/research/2026-09-15-module-decoupling-ipc-assessment.md)) |
|
||||
| [2026-09-15-http-error-envelope-remediation.md](./2026-09-15-http-error-envelope-remediation.md) | HTTP/SSE typed error envelope、公开 details allowlist、前端 additive 迁移与安全负例 |
|
||||
|
||||
@@ -5,8 +5,10 @@
|
||||
**production_ready**: yes(发布门禁 B1–B4 已签;dev/test/main schema=47。U9–U12 / 软件自举 / FAV / 完整 PI change-report 叙事不挡首发)
|
||||
**协作焦点**: [../ops/CURRENT.md](../ops/CURRENT.md)
|
||||
**Agent 手册**: [AGENTS.md](../../AGENTS.md) · [PROJECT.md](../../PROJECT.md)
|
||||
**能力矩阵**: [../status/FEATURE-MATRIX.md](../status/FEATURE-MATRIX.md)(Wave 0 校准;与本文件正交)
|
||||
|
||||
> Codex 2026-09-12 再审计项与本轮回环证据见下表「Codex 再审计」区段。
|
||||
> Wave 0(2026-09-16)对 dev/test/main 做 IAM 只读核验:schema 47、`user_credentials` 与 IAM 表齐全、`ALLOW_IN_MEMORY=false`,**未发现** MemoryStore 旁路;**不**新增 blocker。代码 fail-closed 归 Wave 1(见 [continuity plan](./2026-09-16-feature-matrix-production-readiness-plan.md))。
|
||||
|
||||
---
|
||||
|
||||
@@ -24,7 +26,7 @@
|
||||
| BUG-08 | 测试库隔离 | PASS | `db/testdb.go` Require/Skip;CI `TEST_DATABASE_URL` + governance PG 步骤;[report](../test-reports/2026-09-16-ci-governance-pg-bug08-test-report.md) | 已完成 |
|
||||
| BUG-09 | 版本冲突自动重试 | PASS | `StageAdvanceBanner` reload | 已完成 |
|
||||
| BUG-10 | 无审计视图 | PASS | settings + UI | 已完成 |
|
||||
| BUG-11 | 旧 API 未下线 | PARTIAL | 治理开启时 410 | 保持 + 文档标注 |
|
||||
| BUG-11 | 旧 API 未下线 | PASS | 治理开启时 410;[策略冻结](../audit/2026-09-16-bug11-410-retire-decision.md) | 保留兼容层,不强制删路由 |
|
||||
| BUG-12 | 前端名称硬编码 | PASS | catalog API | 已完成 |
|
||||
| MISSING-01 | 上下文快照 | PASS | `ctxmgr.CollectProjectDialogue` | 已完成 |
|
||||
| MISSING-02 | 终止 | PASS | `GetTerminationPreview` | 已完成 |
|
||||
@@ -60,7 +62,7 @@
|
||||
|
||||
| ID | 描述 | 状态 | 证据 | 计划动作 |
|
||||
|---|---|---|---|---|
|
||||
| WORKFLOW-PLAN-FROZEN-OPTIONAL-DUTIES | active 项目仍展示可编辑职责表单,409 提示在长表单视口外;现有规划又不支持非必需文档“三权全空”,且后端缺少职责人在任成员复核 | **PASS(设置页)** | [audit](../audit/2026-09-14-workflow-plan-409-frozen-and-optional-duties.md);[test-report](../test-reports/2026-09-14-workflow-plan-409-frozen-and-optional-duties-test-report.md)。项目 143 只读 frozen、A full+none 激活、B partial 不发 PUT、C 零治理拒绝、双标签转 frozen、成员无配置入口、刷新后 143 仍 frozen | 真实 PI 生成 full/none 并走审批/阶段不阻塞未纳入本轮页面矩阵,不作为本 gap 关闭的替代证据,另立项 |
|
||||
| WORKFLOW-PLAN-FROZEN-OPTIONAL-DUTIES | active 项目仍展示可编辑职责表单,409 提示在长表单视口外;现有规划又不支持非必需文档“三权全空”,且后端缺少职责人在任成员复核 | **PASS(设置页)** | [audit](../audit/2026-09-14-workflow-plan-409-frozen-and-optional-duties.md);[test-report](../test-reports/2026-09-14-workflow-plan-409-frozen-and-optional-duties-test-report.md)。项目 143 只读 frozen、A full+none 激活、B partial 不发 PUT、C 零治理拒绝、双标签转 frozen、成员无配置入口、刷新后 143 仍 frozen | 设置页矩阵 PASS;真实 PI full/none 长链已另签 [Wave2 报告](../test-reports/2026-09-16-wave2-real-pi-evidence-test-report.md) |
|
||||
| DOC-CONTENT-CANONICAL-HASH-DRIFT | 旧受控文档 bootstrap 裁剪 Markdown 双空格硬换行并将 canonical SHA 写入账本/DocGov,但未同步文件;正文读取把完整性冲突误报 404,lease/list sync 又放大并制造刷新后加载死锁 | **PASS(真实 UI)** | [audit](../audit/2026-09-14-project143-controlled-content-404.md);[UI report](../test-reports/2026-09-14-controlled-content-ui-acceptance.md)。代码已合 dev、schema 32、项目 143 定向 `migration_repair`;项目 143 `clean-run3` 与新项目 `full-chain-final` 主链及 restart 全部纯页面 PASS,目标 404=0 | [remediation](./2026-09-14-controlled-content-canonical-hash-remediation.md)。隔离 `TestReconcile_LegacyRepair_PG` 未执行,按用户“本轮只允许页面测试”的边界保留为工程测试债,不作为本轮 UI PASS 的替代证据 |
|
||||
| CHAT-HISTORY-REFRESH | 工作流激活后刷新,对话正文被阶段过滤器清空,但分类数量与锚点仍按全量返回 | **PASS** | [test-report](../test-reports/2026-09-13-chat-history-refresh-test-report.md);活验 [live.json](../test-reports/assets/2026-09-15-chat-history-refresh-live/live.json)(项目 6252,window=categories=2,guest 403);代码:`message_scope.go`、`chat_history_auth.go`、goose 00026/00027 | 闲聊刷新已补。发布门禁「激活后文档任务 + 重登/重启」仍开放,不回退本 gap |
|
||||
| CHAT-INTENT-STATE | 真实会话被诊断探针污染;只读查询误启动文档写任务;错误动作与编辑状态刷新后丢失 | **PASS** | [audit](../audit/2026-09-13-conversation-intent-runtime-state.md);[test-report](../test-reports/2026-09-13-conversation-intent-runtime-state-test-report.md);双标签活验项目 **6275** / `sess-p6275-u10`(`live.json` + Docker 截图)。**不**删除 `sess-p143-u9` 历史探针 | [remediation](./2026-09-13-conversation-intent-runtime-state-remediation.md)。Wave 3–4 浏览器门已签;诊断污染消息仍不擅自删除 |
|
||||
|
||||
@@ -1,39 +1,90 @@
|
||||
# 模块与功能完成度(SSOT)
|
||||
|
||||
**更新**: 2026-09-16
|
||||
**production_ready**: yes
|
||||
**更新**: 2026-09-17(W3 PI 叙事 done;W4 多意图扩面 done)
|
||||
**production_ready**: yes(权威来源:[gap-matrix](../remediation/gap-matrix.md);本表不推导发布门禁)
|
||||
**发布缺口**: [../remediation/gap-matrix.md](../remediation/gap-matrix.md)
|
||||
**协作焦点**: [../ops/CURRENT.md](../ops/CURRENT.md)
|
||||
**连续性审计**: [../audit/2026-09-16-feature-matrix-production-readiness-audit.md](../audit/2026-09-16-feature-matrix-production-readiness-audit.md)
|
||||
**整改计划**: [../remediation/2026-09-16-feature-matrix-production-readiness-plan.md](../remediation/2026-09-16-feature-matrix-production-readiness-plan.md)
|
||||
|
||||
> 本表描述**能力地图**;上线 blocker 见 gap-matrix,二者互相链接、不合并。
|
||||
> 本表描述**能力成熟度**;上线 blocker 见 gap-matrix。二者正交:能力行不必全部 `done` 才能发布;`partial`/`deferred` 不得自动回退 `production_ready`。
|
||||
|
||||
**状态枚举**: `done` | `partial` | `planned` | `deferred` | `blocked`
|
||||
---
|
||||
|
||||
## 状态契约
|
||||
|
||||
| 字段 | 含义 |
|
||||
|------|------|
|
||||
| **声明范围** | 本行冻结的能力边界;`done` 只对该边界负责 |
|
||||
| **状态** | `done` \| `partial` \| `planned` \| `deferred` \| `blocked` |
|
||||
| **发布关系** | 与当前首发/已签门禁的关系:`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 |
|
||||
|------|------|------|------|-----------|-------|
|
||||
| 意图识别 L1 | 18 类 Intent + 三分支消解 | partial | [system-design/intent-recognition](../system-design/intent-recognition/);[现场专项审计](../audit/2026-09-13-conversation-intent-runtime-state.md);[运行态报告](../test-reports/2026-09-13-conversation-intent-runtime-state-test-report.md);[双标签活验](../test-reports/assets/2026-09-15-conversation-intent-dual-tab/live.json);[多意图复核方案](../system-design/2026-09-15-multi-intent-hitl-plan.md);[U1 契约](../test-reports/2026-09-15-multi-intent-u1-contracts-test-report.md);[U2 分段](../test-reports/2026-09-15-multi-intent-u2-segmenter-test-report.md);[U3 PG](../test-reports/2026-09-15-multi-intent-u3-intentflow-pg-test-report.md) | 明确写动作与只读总结已分流;双标签 `DOC_BUSY` 已签(项目 6275)。多意图核心 U1–U8 已完成;U9–U12 不阻塞首版。intent 纯依赖边界不得回退 | `intent` |
|
||||
| 多意图持久计划 | app/intentflow 生命周期与 HITL 契约 | partial | [设计](../system-design/2026-09-15-multi-intent-hitl-plan.md);[U1](../test-reports/2026-09-15-multi-intent-u1-contracts-test-report.md)–[U8](../test-reports/2026-09-16-multi-intent-u8-task-generate-test-report.md) | U1–U8 核心首版已完成。U9–U12 不阻塞。默认 tier=legacy。真实 PI generate 待 runner URL。共享环境 schema 45 待晋升 | `intent-plan` |
|
||||
| 对话 / ctxmgr | 多轮上下文、记忆、摘要 | partial | [system-design/multi-turn-dialogue](../system-design/multi-turn-dialogue/);[刷新恢复专项审计](../audit/2026-09-13-chat-history-refresh-disappears.md);[U10 端口化](../archive/ops/2026-09-15-chatlog-contextasm-u10.md);[U10 报告](../test-reports/2026-09-15-chatlog-contextasm-u10-test-report.md);[门禁 B3](../test-reports/2026-09-16-chat-refresh-gate-test-report.md) | `CHAT-HISTORY-REFRESH` 与发布门禁「激活后文档任务 + 重登/重启」已签(项目 6359)。U10 原地端口 **停止扩面**。语义摘要(D5 backlog) | `chat` |
|
||||
| 智能体小队 | 角色-任务-工作区-黑板 | done | [system-design/agent-squad](../system-design/agent-squad/);[test 2026-09-07](../test-reports/2026-09-07-dynamic-squad-planning-test-report.md) | 非关键步骤降级(A5/A6 backlog) | `squad` |
|
||||
| 工作流治理 | 三正式工作流 + 阶段门禁 | partial | [remediation/three-workflows](../remediation/2026-09-12-three-workflows-strict-governance-remediation.md);[test 2026-09-12](../test-reports/2026-09-12-three-workflows-governance-remediation-test-report.md);[冻结态/职责可选整改](../remediation/2026-09-14-workflow-plan-409-frozen-and-optional-duties-remediation.md);[Wave 5 页面矩阵](../test-reports/2026-09-14-workflow-plan-409-frozen-and-optional-duties-test-report.md);[职责-动作鉴权](../test-reports/2026-09-14-governance-action-level-authz-test-report.md);[真实 PI 三工作流 E2E](../test-reports/2026-09-16-pi-three-workflow-e2e-test-report.md) | 设置页/DutyMode + 动作级鉴权已落地;真实 PI 三工作流 E2E 已签。后续:none 文档真实 PI 审批长链路;模块可仍 partial | `workflow` |
|
||||
| 纯软件项目自举 | 软件项目创建、Bootstrap 基线、Delivery 迭代与受控工程交接 | planned | [详细设计](../system-design/2026-09-14-software-project-bootstrap-workflow.md);[现状调研](../ops/research/2026-09-14-software-project-bootstrap-current-state.md);[验收计划](../ops/checklists/2026-09-14-software-project-bootstrap-acceptance.md) | 当前仅完成方案;目录/模板/执行器/创建向导/真实 PI UI 均未实施。受控代码执行单列后续 Epic | `workflow-design` |
|
||||
| IAM / 鉴权 | 项目级 API 鉴权 + RBAC | partial | [audit/authorization](../audit/authorization-matrix-v2.md);[刷新恢复专项审计](../audit/2026-09-13-chat-history-refresh-disappears.md) | 历史读取端点补统一会话 owner + 阶段授权;旧 API 410 标注(BUG-11 partial) | `authz` |
|
||||
| 文档治理 | 法定文档生命周期 + 租约 + 受控正文读取 | done | [test docgov](../test-reports/2026-09-08-docgov-lifecycle-and-claiming-framework-test-report.md);[项目 143 正文 404 审计](../audit/2026-09-14-project143-controlled-content-404.md);[受控正文真实 UI 验收报告](../test-reports/2026-09-14-controlled-content-ui-acceptance.md);[UI-06 缓存竞争审计](../audit/2026-09-14-document-revision-refresh-cache-race.md);[整改](../remediation/2026-09-14-controlled-content-canonical-hash-remediation.md) | 生命周期/租约保留。W1–W6 + 审查修补 + UI hydrate 资格 + 晚到 list sync 修复均已合入 dev。项目 143 纯 UI 回归(clean-run3)与新项目全链路(main + post-restart)已全量真实页面验证通过(PASS) | `docgov` |
|
||||
| 文档版本与修改认知 | 智能体版本边界、人工修订标记、任意版本比较、变更报告与负责人通知 | partial | [管理测试](../test-reports/2026-09-13-document-revision-management-test-report.md);[运行时 UI Round20](../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md);[运行时审计](../audit/2026-09-13-document-revision-runtime-404.md);[ADR](../adr/2026-09-13-document-version-boundary.md) | **运行时 UI PASS**(6159 / V3/r2)。仍 `partial`:change report=`fallback`(真实 diff+lineage,非完整 PI 叙事)。系统级 `CHAT-INTENT` 见 gap-matrix | `docgov` |
|
||||
| 前端工作台 | 三栏 + 块文档 + SSE | partial | [test workbench](../test-reports/2026-09-08-three-column-workbench-and-block-document-test-report.md);[现场专项审计](../audit/2026-09-13-conversation-intent-runtime-state.md);[双标签截图](../test-reports/assets/2026-09-15-conversation-intent-dual-tab/screenshots/tab-b-busy.png);[demo seed 污染整改](../test-reports/2026-09-16-demo-seed-pollution-test-report.md);[门禁 B4](../test-reports/2026-09-16-frontend-gate-b4-test-report.md) | 错误卡片/任务进度/文档 busy 刷新恢复已有项目 6275 证据。Demo seeds 默认关闭。版本冲突信封解包 + 终止 preview 抽检已签(项目 6363) | `web` |
|
||||
| PI Runner / 配置链 | pi-agent + MiniMax 真实链路 + typed-result-v1 | done | [test piagent](../test-reports/2026-09-13-codex-audit-p0-remediation-test-report.md);[container-env](../test-reports/2026-09-13-container-env-configuration-test-report.md);[typed-result-v1](../test-reports/2026-09-15-pi-typed-result-v1-test-report.md) | — | `pi-agent` |
|
||||
| 三环境运维 | dev/test/main + 共享 KB | done | [PROJECT.md](../../PROJECT.md) §4;四环境 healthy | — | `infra` |
|
||||
| CI / E2E | PG 集成 + 真实 PI E2E | partial | [gap-matrix BUG-08](../remediation/gap-matrix.md);[test pg-ci](../test-reports/2026-09-12-pg-ci-soak-e2e-test-report.md);[治理 PG BUG-08](../test-reports/2026-09-16-ci-governance-pg-bug08-test-report.md);[真实 PI 三工作流](../test-reports/2026-09-16-pi-three-workflow-e2e-test-report.md);[运行时 UI Round20](../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md) | BUG-08 PASS;真实 PI 三工作流 E2E 与前端/对话门禁已签。`-race` TempDir flake 为基建残留;夜间 CI `RUN_PI_E2E=1` 建议 | `ci` |
|
||||
| 模块解耦与可靠事件 | 文档可靠性纵向试点、PG 持久事件交付与选择性模块化 | partial | [架构](../system-design/2026-09-14-module-decoupling-architecture.md);[ADR](../adr/2026-09-14-modular-monolith-decoupling.md);[Phase 1](../remediation/2026-09-14-module-decoupling-refactor-plan.md);[Phase 2 审阅](../audit/2026-09-15-module-decoupling-phase2-plan-review.md);[Phase 2 修订计划](../remediation/2026-09-15-module-decoupling-ipc-phase2-remediation-plan.md);[E0A](../test-reports/2026-09-15-event-e0a-production-scope-contract-test-report.md);[E0B](../test-reports/2026-09-15-event-e0b-dispatcher-pg-test-report.md);[E1A](../test-reports/2026-09-15-event-e1a-notify-cutover-test-report.md);[E1B](../test-reports/2026-09-15-event-e1b-workflow-advance-test-report.md);[E1C](../test-reports/2026-09-15-event-e1c-projection-test-report.md);[E2](../test-reports/2026-09-15-event-e2-hook-guard-test-report.md);[复盘](../ops/research/2026-09-15-track-e-retrospective.md);[D6](../test-reports/2026-09-15-doccontent-canonical-boundary-test-report.md);[D7a](../test-reports/2026-09-15-intent-bizdev-boundary-test-report.md);[D5](../test-reports/2026-09-15-stageflow-type-ownership-test-report.md);[D4](../test-reports/2026-09-15-bizdev-locator-removal-test-report.md);[D7b](../test-reports/2026-09-15-chatflow-orchestration-boundary-test-report.md);[H0](../ops/research/2026-09-15-http-error-envelope-h0-inventory.md);[P0](../ops/research/2026-09-15-pi-typed-result-p0-matrix.md);[收口](../test-reports/2026-09-15-phase2-closeout-test-report.md);[notify live](../test-reports/2026-09-15-event-notify-shared-live-test-report.md);[advance live](../test-reports/2026-09-15-event-workflow-advance-shared-live-test-report.md);[projection live](../test-reports/2026-09-15-event-projection-shared-live-test-report.md);[HTTP 信封](../test-reports/2026-09-15-http-error-envelope-h1-h3-test-report.md);[PI typed-result](../test-reports/2026-09-15-pi-typed-result-v1-test-report.md) | E0A–E2 与共享 live 已过;生产无 hook 注册。D4–D7b 已合入。FAV off。Track P H1–H3 / P1–P4 已实施 | `architecture-docs` |
|
||||
| 模块 | 声明范围 | 状态 | 发布关系 | 证据 | 剩余工作 / 关闭条件 | mutex |
|
||||
|------|----------|------|----------|------|---------------------|-------|
|
||||
| 意图识别 L1 | 18 类 Intent、三分支消解、写/只读分流、双标签 `DOC_BUSY`、intent 纯依赖边界 | done | non_blocker | [intent-recognition](../system-design/intent-recognition/);[审计](../audit/2026-09-13-conversation-intent-runtime-state.md);[报告](../test-reports/2026-09-13-conversation-intent-runtime-state-test-report.md);[双标签](../test-reports/assets/2026-09-15-conversation-intent-dual-tab/live.json);[U1](../test-reports/2026-09-15-multi-intent-u1-contracts-test-report.md)–[U3](../test-reports/2026-09-15-multi-intent-u3-intentflow-pg-test-report.md) | **边界 before**:含 U9–U12 叙事混入 → **after**:U9–U12 迁至「多意图扩面」行。关闭:纯依赖边界回归即重开 | `intent` |
|
||||
| 多意图持久计划(U1–U8 基线) | app/intentflow 生命周期、HITL、默认 `legacy`、U1–U8 代码与安全基线 | done | non_blocker(默认 legacy) | [设计](../system-design/2026-09-15-multi-intent-hitl-plan.md);[U1](../test-reports/2026-09-15-multi-intent-u1-contracts-test-report.md)–[U8](../test-reports/2026-09-16-multi-intent-u8-task-generate-test-report.md);[Wave2 真 PI](../test-reports/2026-09-16-wave2-real-pi-evidence-test-report.md) | U8 已签。**Playwright 双标签**:真浏览器 PASS 已合入([报告](../test-reports/2026-09-16-intent-plan-playwright-dual-tab-test-report.md));升 `confirm/full` 另开 | `intent-plan` |
|
||||
| 多意图扩面(U9–U12) | U9 LLM 分段实验;U10 mutate;U11 docgov;U12 workflow/run-control | done | deferred_enhancement | [设计](../system-design/2026-09-15-multi-intent-hitl-plan.md);[go/no-go GO](../ops/research/2026-09-16-wave3-pu6-pu8-go-no-go.md);[脚手架](../test-reports/2026-09-16-pu8-u9-u12-flags-test-report.md);[U9](../test-reports/2026-09-17-w4-u9-segment-test-report.md);[U10](../test-reports/2026-09-17-w4-u10-mutate-test-report.md);[U11](../test-reports/2026-09-17-w4-u11-docgov-test-report.md);[U12](../test-reports/2026-09-17-w4-u12-run-control-test-report.md) | **before**:独立 flag 脚手架。**after**:U9 可开 flag 走产品 PI proposer(规则已切则不出 proposal);U10–U12 分 flag dry-run→confirm 证据。**未升** `MULTI_INTENT_PLAN_TIER`(升 `confirm` 另开授权;永不默认 `full`)。U10–U12 领域 live 写仍须专项批准 | `intent-plan` |
|
||||
| 对话 / ctxmgr baseline | 多轮上下文、刷新/重登/重启恢复、授权同集正文与计数、U10 端口化停止扩面 | done | non_blocker | [multi-turn](../system-design/multi-turn-dialogue/);[刷新审计](../audit/2026-09-13-chat-history-refresh-disappears.md);[U10](../test-reports/2026-09-15-chatlog-contextasm-u10-test-report.md);[门禁 B3](../test-reports/2026-09-16-chat-refresh-gate-test-report.md)(项目 6359) | **before**:语义摘要误标 D5 混入 → **after**:摘要迁「语义摘要 D3」;D7 数据治理独立。U10 停止扩面 | `chat` |
|
||||
| 语义摘要(D3) | 授权后可见集合上的语义摘要;shadow → 可选替换 deterministic | done | deferred_enhancement | [chat-agent-p6-backlog](../backlog/chat-agent-p6-backlog.md);[go/no-go GO](../ops/research/2026-09-16-wave3-pu6-pu8-go-no-go.md);[pu6](../ops/long-term/2026-09-16-pu6-semantic-summary-contract.md);[脚手架](../test-reports/2026-09-16-pu6-semantic-summary-test-report.md);[W2 真 PI](../test-reports/2026-09-17-w2-semantic-summary-shadow-test-report.md) | **before**:flag 脚手架 + heuristic。**after**:dev 可开 `SEMANTIC_SUMMARY_SHADOW` 走产品 PI no-tool summarizer(默认 off)。**REPLACE 未启用**(独立后置,不在本行关闭条件内) | `chat` |
|
||||
| 对话数据治理(D7) | 留存/删除口径、库·备份·日志控制、敏感字段加密边界 | deferred | deferred_enhancement(违规则升 blocker) | [计划](../remediation/2026-09-16-feature-matrix-production-readiness-plan.md) Scope Boundaries;[收口 §7.1](../remediation/2026-09-16-partial-deferred-completion-plan.md);[D7 ADR 草案](../adr/2026-09-17-d7-chat-data-retention.md);[W7 盘点](../audit/2026-09-17-d7-data-inventory.md);[报告](../test-reports/2026-09-17-w7-d7-inventory-test-report.md) | **after W7**:只读盘点完成(sessions/messages/KB/日志/备份/event)。**未发现**已确认基线违规,未写 gap-matrix。口径仍 `pending-compliance-signoff`;禁止按 365/180/30 物理删除。本行不升 done | `chat` |
|
||||
| 智能体小队 | 角色-任务-工作区-黑板 | done | non_blocker | [agent-squad](../system-design/agent-squad/);[test 2026-09-07](../test-reports/2026-09-07-dynamic-squad-planning-test-report.md) | 非关键步骤降级(A5/A6)属 backlog | `squad` |
|
||||
| 工作流治理 | 三正式工作流、设置页/DutyMode、动作级鉴权、真实 PI 三工作流 E2E、full/none 混合长链 | done | non_blocker | [三工作流整改](../remediation/2026-09-12-three-workflows-strict-governance-remediation.md);[409/职责](../test-reports/2026-09-14-workflow-plan-409-frozen-and-optional-duties-test-report.md);[鉴权](../test-reports/2026-09-14-governance-action-level-authz-test-report.md);[PI E2E](../test-reports/2026-09-16-pi-three-workflow-e2e-test-report.md);[Wave2 full/none](../test-reports/2026-09-16-wave2-real-pi-evidence-test-report.md) | full 跨用户审批 + none 免审批不阻塞已签。纯软件自举仍独立 planned | `workflow` |
|
||||
| 纯软件项目自举 | 软件项目创建、Bootstrap、Delivery、受控工程交接 | partial | deferred_enhancement(明确不挡首发) | [设计](../system-design/2026-09-14-software-project-bootstrap-workflow.md);[ADR](../adr/2026-09-16-software-project-bootstrap-keys.md);[L1 报告](../test-reports/2026-09-16-software-project-bootstrap-test-report.md);[W5a](../test-reports/2026-09-17-w5a-software-bootstrap-ui-pi-test-report.md) | **before**:L1 + UI 仍克隆医疗模板。**after W5a**:catalog 驱动创建、软件不挂医疗 key、docs_only 真 PI 建议 delivery 且不自动激活。**SWBOOT-10 仍 stub**(W5b);本行不升 done | `workflow-design` |
|
||||
| IAM / 鉴权 | 项目级 API 鉴权 + RBAC;会话/阶段授权 | done | 加固 | [v3 full inventory](../audit/authorization-matrix-v3-full.md);[session 中断](../test-reports/2026-09-16-iam-route-inventory-test-report.md);[fail-closed](../test-reports/2026-09-16-wave1-iam-fail-closed-test-report.md);[410 策略](../audit/2026-09-16-bug11-410-retire-decision.md);[R13](../audit/2026-09-16-r13-data-safety-checklist.md) | 全路由 inventory + session 中断负例 + 410 冻结 + R13 基线已签 | `authz` |
|
||||
| 文档治理 | 法定文档生命周期 + 租约 + 受控正文读取 | done | non_blocker | [docgov](../test-reports/2026-09-08-docgov-lifecycle-and-claiming-framework-test-report.md);[正文 UI](../test-reports/2026-09-14-controlled-content-ui-acceptance.md);[canonical hash](../remediation/2026-09-14-controlled-content-canonical-hash-remediation.md) | 项目 143 只读;不终止 | `docgov` |
|
||||
| 文档版本 baseline | 账本、人工修订、确定性 diff+lineage、运行时 UI、负责人通知 | done | non_blocker | [管理](../test-reports/2026-09-13-document-revision-management-test-report.md);[Round20 UI](../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md);[ADR](../adr/2026-09-13-document-version-boundary.md) | **before**:完整 PI narrative 混入 → **after**:迁「PI change-report 叙事」。fallback 报告是本行内显式行为,不是缺口 | `docgov` |
|
||||
| PI change-report 叙事 | 只读消费 diff+lineage 的 PI 叙事;失败全量降级 fallback | done | deferred_enhancement | [Round20](../test-reports/2026-09-14-document-revision-runtime-ui-test-report.md);[go/no-go GO](../ops/research/2026-09-16-wave3-pu6-pu8-go-no-go.md);[pu7](../ops/long-term/2026-09-16-pu7-pi-narrative-contract.md);[脚手架](../test-reports/2026-09-16-pu7-pi-narrative-test-report.md);[W3 真 PI](../test-reports/2026-09-17-w3-pi-change-report-narrative-test-report.md) | **before**:flag 脚手架 + 仅 fallback。**after**:dev 可开 `PI_CHANGE_REPORT_NARRATIVE` 走产品 PI no-tool narrator(默认 off)。digest 绑定;畸形/超时全量 fallback。**不把 fallback 写成完整 PI** | `docgov` |
|
||||
| 前端工作台 | 三栏 + 块文档 + SSE;错误卡/进度/busy;版本冲突信封;demo seed 默认关;终止 preview | done | non_blocker | [workbench](../test-reports/2026-09-08-three-column-workbench-and-block-document-test-report.md);[双标签](../test-reports/assets/2026-09-15-conversation-intent-dual-tab/screenshots/tab-b-busy.png);[demo](../test-reports/2026-09-16-demo-seed-pollution-test-report.md);[B4](../test-reports/2026-09-16-frontend-gate-b4-test-report.md)(项目 6363) | **before**:空「缺口」却 partial → **after**:本行 done。其他 409 消费方信封复用另列 hardening backlog | `web` |
|
||||
| PI Runner / 配置链 | pi-agent + MiniMax + typed-result-v1 | done | non_blocker | [piagent](../test-reports/2026-09-13-codex-audit-p0-remediation-test-report.md);[container-env](../test-reports/2026-09-13-container-env-configuration-test-report.md);[typed-result](../test-reports/2026-09-15-pi-typed-result-v1-test-report.md) | — | `pi-agent` |
|
||||
| 三环境运维 | dev/test/main + 共享 KB;对话/业务库隔离 | done | non_blocker | [PROJECT.md](../../PROJECT.md) §4;CURRENT 环境快照 schema **47** | — | `infra` |
|
||||
| CI / E2E | PR CI、PG 集成、治理 PG、已签真实 PI 门禁;**nightly** schedule/`workflow_dispatch` + infra/product 分类 receipt | done | 加固(阻止**下一次**晋升,不自动否定已发布) | [BUG-08](../test-reports/2026-09-16-ci-governance-pg-bug08-test-report.md);[PI 三工作流](../test-reports/2026-09-16-pi-three-workflow-e2e-test-report.md);[Wave2B](../test-reports/2026-09-16-wave2b-nightly-promotion-receipt-test-report.md);[Wave2C](../test-reports/2026-09-16-wave2c-same-image-digest-test-report.md);[W1 green](../test-reports/2026-09-17-w1-ci-e2e-green-nightly-test-report.md) + [receipt `6e2476f0…`](../assets/promotion-receipts/6e2476f0f2e408e111fe06ca7c31a38294a340b3.json) | **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](../remediation/2026-09-16-feature-matrix-production-readiness-plan.md);[Wave2B](../test-reports/2026-09-16-wave2b-nightly-promotion-receipt-test-report.md);[Wave2C](../test-reports/2026-09-16-wave2c-same-image-digest-test-report.md) | **关闭**: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](../test-reports/2026-09-15-event-e0a-production-scope-contract-test-report.md) 等;[复盘](../ops/research/2026-09-15-track-e-retrospective.md);[shared live](../test-reports/2026-09-15-event-notify-shared-live-test-report.md);[phase2 closeout](../test-reports/2026-09-15-phase2-closeout-test-report.md) | **before**:与 FAV off 混成 partial → **after**:FAV 独立行。选择性后续解耦按收益触发 | `architecture-docs` / `events` |
|
||||
| Final Artifact Vault(FAV) | 不可变终态制品库;`FAV_DEGRADED_READ=false` | partial | deferred_enhancement | [Track E 复盘](../ops/research/2026-09-15-track-e-retrospective.md);[U7 报告](../test-reports/2026-09-16-fav-u7-incremental-test-report.md);[W6 shadow](../test-reports/2026-09-17-w6-fav-subscriber-shadow-test-report.md);[short-term](../ops/short-term/2026-09-17-w6-fav-subscriber-shadow.md) | **after W6**:subscriber `ObserveShadow` 只计算 intended outcome,不写副作用。仍**禁止**整支 merge;`FAV_DEGRADED_READ` 默认 false;**live 未放量**(staging→artifact→publication 各 ≥7 天观察窗) | `events` |
|
||||
|
||||
---
|
||||
|
||||
## 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 | 其他 409 信封复用 → backlog | 是(B4 项目 6363) |
|
||||
| 可靠事件 | partial(与 FAV 混行) | done | FAV 独立 deferred | 是(E0–E2 + shared live) |
|
||||
|
||||
---
|
||||
|
||||
## 更新规则
|
||||
|
||||
1. 模块状态变化时同步更新本表与 [gap-matrix](../remediation/gap-matrix.md)(若涉及 blocker)
|
||||
2. 同一 `mutex` 同时仅一个 Agent `in_progress`(见 CURRENT 并行认领表)
|
||||
3. 新能力行:复制模板 [../ops/templates/feature-matrix-row.md](../ops/templates/feature-matrix-row.md)
|
||||
1. 模块状态变化时同步本表;**仅当**发布 blocker 出现或关闭时改 [gap-matrix](../remediation/gap-matrix.md)
|
||||
2. 同一 `mutex` 同时仅一个 Agent `in_progress`(见 CURRENT)
|
||||
3. 新能力行:复制 [../ops/templates/feature-matrix-row.md](../ops/templates/feature-matrix-row.md)
|
||||
4. 拆行/收口须保留 before/after 与义务迁移(见上表);禁止缩口径假完成
|
||||
|
||||
@@ -2,4 +2,12 @@
|
||||
|
||||
**SSOT**:[FEATURE-MATRIX.md](./FEATURE-MATRIX.md)
|
||||
|
||||
与 [remediation/gap-matrix.md](../remediation/gap-matrix.md)(发布 blocker)分离:本目录描述**能力地图**,gap-matrix 描述**上线缺口**。
|
||||
与 [remediation/gap-matrix.md](../remediation/gap-matrix.md)(发布 blocker)分离:
|
||||
|
||||
| 文档 | 职责 |
|
||||
|------|------|
|
||||
| 本目录 FEATURE-MATRIX | **能力成熟度**:声明范围、状态、发布关系、关闭条件、证据 |
|
||||
| gap-matrix | **上线缺口**:唯一决定 `production_ready` |
|
||||
| [ops/CURRENT.md](../ops/CURRENT.md) | 协作焦点、认领、集成槽位、环境快照 |
|
||||
|
||||
能力行不必全部 `done` 才能发布;`partial`/`deferred` 不得自动回退 `production_ready`。新行模板:[../ops/templates/feature-matrix-row.md](../ops/templates/feature-matrix-row.md)。连续性审计与整改:[audit 2026-09-16](../audit/2026-09-16-feature-matrix-production-readiness-audit.md) · [remediation plan](../remediation/2026-09-16-feature-matrix-production-readiness-plan.md)。
|
||||
|
||||
@@ -1,9 +1,10 @@
|
||||
# 多意图多任务识别、持久计划与 HITL 统一确认方案
|
||||
|
||||
> 状态: planned(方案已复核,未实施)
|
||||
> 日期: 2026-09-15
|
||||
> 作者: Cline(初稿)/ Codex(架构、安全与实施计划复核)
|
||||
> 关联: [方案审计](../audit/2026-09-15-multi-intent-hitl-plan-review.md);[意图识别深读](./intent-recognition/01-意图识别框架-设计-架构-实现-难点-解决方案-亮点与优势.md);[模块化单体架构](./2026-09-14-module-decoupling-architecture.md);[任务总览](../ops/short-term/2026-09-15-multi-intent-hitl.md)
|
||||
> 状态: **partially implemented**(U1–U8 代码与默认 `legacy` 已合入;U8 真实 PI generate 仍为证据缺口;U9–U12 deferred)
|
||||
> 日期: 2026-09-15
|
||||
> **SSOT 状态**:能力行见 [FEATURE-MATRIX](../status/FEATURE-MATRIX.md)(Wave 0 校准);发布门禁见 [gap-matrix](../remediation/gap-matrix.md)。本文保留为设计权威,头部「planned/未实施」已过时。
|
||||
> 作者: Cline(初稿)/ Codex(架构、安全与实施计划复核)
|
||||
> 关联: [方案审计](../audit/2026-09-15-multi-intent-hitl-plan-review.md);[意图识别深读](./intent-recognition/01-意图识别框架-设计-架构-实现-难点-解决方案-亮点与优势.md);[模块化单体架构](./2026-09-14-module-decoupling-architecture.md);[任务总览](../ops/short-term/2026-09-15-multi-intent-hitl.md);[连续性计划](../remediation/2026-09-16-feature-matrix-production-readiness-plan.md)
|
||||
|
||||
---
|
||||
|
||||
@@ -27,7 +28,7 @@
|
||||
|
||||
| 能力 | 当前事实 | 证据 |
|
||||
|------|----------|------|
|
||||
| 单意图识别 | 18+ Intent、四级漏斗、三分支已实现;FEATURE-MATRIX 仍为 `partial`,不能称“已成熟” | `internal/intent/recognizer.go`、`.doc/status/FEATURE-MATRIX.md` |
|
||||
| 单意图识别 | 18+ Intent、四级漏斗、三分支已实现;FEATURE-MATRIX L1 行 Wave 0 已收口为 `done`(U9–U12 拆出) | `internal/intent/recognizer.go`、`.doc/status/FEATURE-MATRIX.md` |
|
||||
| V2 帧/动作表 | `IntentFrameV2`、ActionRegistry、风险、必填槽位、灰度开关已存在 | `internal/intent/types_v2.go`、`registry.go`、`flags.go` |
|
||||
| 有限多意图 | 默认开启;只按首个连接词拆两段;写意图返回 `nil` | `internal/intent/plan_builder.go` |
|
||||
| 有限执行 | 只读步骤顺序执行;需确认步骤只有文字提示 | `internal/coordinator/action_planner.go` |
|
||||
|
||||
@@ -119,6 +119,9 @@ imports:
|
||||
- app/uow
|
||||
- events
|
||||
- intent
|
||||
app/fav:
|
||||
- artifactvault
|
||||
- events
|
||||
app/uow: []
|
||||
app/stageflow:
|
||||
- bizdev
|
||||
@@ -193,6 +196,7 @@ imports:
|
||||
- squad
|
||||
- stream
|
||||
- stream/transport
|
||||
- swboot
|
||||
- taskrun
|
||||
- upload
|
||||
- workflowdef
|
||||
@@ -209,6 +213,7 @@ imports:
|
||||
stream: []
|
||||
stream/transport:
|
||||
- stream
|
||||
swboot: []
|
||||
taskrun:
|
||||
- app/uow
|
||||
- artifactvault
|
||||
|
||||
@@ -0,0 +1,110 @@
|
||||
# FAV U7 增量(publisher stub)测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
P7 Final Artifact Vault 禁止整支 merge `feature/final-artifact-vault`。相对当前 `dev`,FAV 旁支的 `internal/artifactvault/*` 多数文件已大幅分叉(dataset Candidate backfill vs TerminalRow),强行 cherry-pick 会引入不可控冲突。本切片改为 **U7 增量 stub**:配置门闩、HTTP status、events 订阅桩与 CLI stub,全部默认关闭。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- `FAV_DEGRADED_READ` 默认 false(config + docquery + vault GET)
|
||||
- `FAV_PUBLISHER_ENABLED` 默认 false;进程内 Drain 不启动
|
||||
- fav durable consumer 保持 mode=off;`Registry.Register(fav)` fail-closed
|
||||
- `cmd/artifact-vault` 可编译;仅 `status|version`,无破坏性操作
|
||||
- 产出 go/no-go:**subscriber 保持 OFF,直至单独审批**
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
| 项 | 值 |
|
||||
|----|----|
|
||||
| OS | Linux |
|
||||
| Go | 本机 `go test` / `go vet` |
|
||||
| 分支 | `feature/fav-u7-publisher`(自 `dev@ebe177e`) |
|
||||
| 层级 | 单元测试 + CLI 冒烟(无 stub 冒充真实 PI) |
|
||||
| 证据 | `.doc/test-reports/assets/2026-09-16-fav-u7-incremental/unit-tests.txt` |
|
||||
|
||||
核心用例矩阵:
|
||||
|
||||
| ID | 用例 | 期望 |
|
||||
|----|------|------|
|
||||
| C1 | config 默认 | degraded/publisher false |
|
||||
| C2 | vault init/start | publisher nil / not running |
|
||||
| C3 | GET vault/status | consumer_mode=off |
|
||||
| C4 | fav EventConsumer 零值 | HandleLease → ErrDisabledConsumer |
|
||||
| C5 | events Registry | Register(fav) 失败;LiveConsumers 不含 fav |
|
||||
| C6 | docquery | FavDegradedReadEnabled() false |
|
||||
| C7 | artifact-vault status | 打印 remaining_to_port;无 backfill |
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- 所有默认路径 FAIL-CLOSED:不写 vault blob、不 claim fav lease、不启用 degraded GET
|
||||
- 显式 `FAV_*=true` 仅打开配置位;durable Register 仍被 events 硬门拒绝
|
||||
- go/no-go 结论:**NO-GO for enabling fav subscriber**
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### C1–C3 config / vault
|
||||
|
||||
- **测试输入**:`config.Load("/dev/null")`;`Server{cfg}.initArtifactVault/startVaultPublisher`;`GET /api/v1/vault/status`
|
||||
- **实际输出**:见 assets `unit-tests.txt` — `TestFAVFlagsDefaultOff` / `TestVaultDefaultsStayDisabled` / `TestVaultStatusReportsOff` PASS
|
||||
- **评价判定**:PASS
|
||||
- **耗时**:<10ms
|
||||
|
||||
### C4 fav subscriber stub
|
||||
|
||||
- **测试输入**:零值 `EventConsumer`;`Enabled=true` 仍调用 HandleLease
|
||||
- **实际输出**:均 `events: consumer is disabled`;`Register(fav)` 失败
|
||||
- **评价判定**:PASS
|
||||
|
||||
### C5–C6 events / docquery
|
||||
|
||||
- **测试输入**:既有 `TestAssertLiveConsumersRejectsFAV`、`TestLiveConsumersOmitsFAV`、`TestFavDegradedReadDefaultOff`
|
||||
- **实际输出**:PASS(PG claim 负例缺 `TEST_DATABASE_URL` 时 SKIP,与既有约定一致)
|
||||
- **评价判定**:PASS
|
||||
|
||||
### C7 CLI stub
|
||||
|
||||
- **测试输入**:`go build ./cmd/artifact-vault && artifact-vault status`
|
||||
- **实际输出**:JSON 含 `consumer_mode=off`、`degraded_read=false`、`remaining_to_port` 列表
|
||||
- **评价判定**:PASS
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
```text
|
||||
ok internal/config (FAV flags + ValidateIndependentVault)
|
||||
ok internal/app/fav (subscriber defaults off)
|
||||
ok internal/server (vault stub defaults off)
|
||||
ok internal/events (FAV register/live omit)
|
||||
ok internal/docquery (FavDegradedRead default off)
|
||||
go vet PASS on touched packages
|
||||
```
|
||||
|
||||
完整控制台:`assets/2026-09-16-fav-u7-incremental/unit-tests.txt`
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
### Go / No-Go
|
||||
|
||||
| 决策点 | 结论 |
|
||||
|--------|------|
|
||||
| 合入本 stub 分支到 `dev`(另占集成槽) | **条件 GO**(默认 off,可审) |
|
||||
| 启用 fav durable subscriber / `Register(fav)` | **NO-GO** — 需单独审批 |
|
||||
| 启用 `FAV_DEGRADED_READ` | **NO-GO** — 默认 false,未做 M2 负例放行 |
|
||||
| 启用 `FAV_PUBLISHER_ENABLED` 生产 Drain | **NO-GO** — 缺 ingest hooks 与完整 CAS 接线审计 |
|
||||
| 整支 merge `feature/final-artifact-vault` | **NO-GO**(红线) |
|
||||
|
||||
### 仍待从 FAV 旁支手工移植(冲突重,本切片未搬)
|
||||
|
||||
1. `enumerate.go`(`EnumerateTerminals` / `LoadExclusions`)
|
||||
2. `TerminalRow` + `Backfill(rows)`(与现 dataset `Candidate` 路径分叉)
|
||||
3. 完整 `recover-plan` / `recover-apply` / `gc-preflight` / `destroy` CLI
|
||||
4. `server` ingest hooks(`OnFinalArtifact*`)
|
||||
5. durable fav `Register` + live cutover(需审批解锁 events 硬门)
|
||||
|
||||
### 本切片交付物
|
||||
|
||||
- `internal/config`:`FAV_*` / `VAULT_*` + `ValidateIndependentVault`
|
||||
- `internal/server/vault.go`:status HTTP + gated publisher
|
||||
- `internal/app/fav`:subscriber stub(默认 off)
|
||||
- `cmd/artifact-vault`:status stub
|
||||
- compose:`FAV_DEGRADED_READ` / `FAV_PUBLISHER_ENABLED` 钉死 false(main 硬编码)
|
||||
- **未** merge 到 `dev`
|
||||
@@ -0,0 +1,50 @@
|
||||
# IAM 全路由 inventory 与 fail-closed 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
PU3 遗留:authorization-matrix-v2 仅抽样;需全路由 inventory、session 中断负例、410 策略冻结、R13 清单,以关闭 FEATURE-MATRIX IAM `partial`。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 枚举全部 `mux.HandleFunc` 路由
|
||||
- session 中断 fail-closed 单测
|
||||
- BUG-11 410 策略文档冻结
|
||||
- R13 checklist 落盘
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- Go unit:`go test ./internal/auth/ -count=1`
|
||||
- 静态:从 `internal/server` 生成矩阵
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- inventory ≥100 路由
|
||||
- `TestAuthStore_SessionInterruptFailClosed` PASS
|
||||
- 文档齐备
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### Inventory
|
||||
|
||||
- Input: grep HandleFunc
|
||||
- Actual Output: `.doc/audit/authorization-matrix-v3-full.md` **133** routes
|
||||
- Verdict: PASS
|
||||
|
||||
### Session interrupt
|
||||
|
||||
- Input: `go test ./internal/auth/ -run SessionInterrupt -count=1`
|
||||
- Actual: 见下方套件
|
||||
- Verdict: PASS
|
||||
|
||||
### 410 / R13
|
||||
|
||||
- Actual: `2026-09-16-bug11-410-retire-decision.md` + `2026-09-16-r13-data-safety-checklist.md`
|
||||
- Verdict: PASS
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
见 commit 前本地 `go test ./internal/auth/ -count=1` 输出。
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
IAM 行可升 `done`。后续可按路由表补逐条 handler 负例指针细化,不挡关闭。
|
||||
@@ -0,0 +1,106 @@
|
||||
# Playwright intent-plan 双标签验收 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
Wave2 / U6 仅留下 `web/e2e/intent-plan-cards.spec.ts` 门控骨架(无 `RUN_UI_ACCEPTANCE` 则 skip;有则仅 body visible)。Conversation-intent 双标签证据(项目 6275)不等于 intent-plan `PLAN_CONFIRM` 双标签。本轮关闭 long-term [2026-09-16-intent-plan-playwright-dual-tab](../ops/long-term/2026-09-16-intent-plan-playwright-dual-tab.md),且**不升** `MULTI_INTENT_PLAN_TIER`。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
1. `RUN_UI_ACCEPTANCE` 未设置时 Playwright **SKIP**(不得冒充 PASS)
|
||||
2. `RUN_UI_ACCEPTANCE=1` 真浏览器:双标签同时点「确认执行」→ 仅一侧 HTTP 200,另一侧 409;败方卡片 `outdated`,不得本地双成功
|
||||
3. 刷新 / 重登后卡片与 PG / `GET /intent-plans/active` 状态一致
|
||||
4. 顺带修复空 `docAST` 登录页崩溃(demo seed 关闭时)
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
| 项 | 值 |
|
||||
|----|-----|
|
||||
| OS | Linux 7.0.0-31-generic |
|
||||
| 前端 | Vite `http://127.0.0.1:3101`(worktree 含水合改动;proxy → `:8080` API) |
|
||||
| API / PG | `shuimu-agent-app-dev` `:8080`;`shuimu-context-pg-dev` schema 47 |
|
||||
| 浏览器 | `mcr.microsoft.com/playwright:v1.63.0-noble --network host`(宿主机缺 libatk) |
|
||||
| 分支 | `feature/intent-plan-cards-playwright` |
|
||||
| 种子 | SQL 写入 `awaiting_confirmation` + `validated_only`(保持 legacy tier) |
|
||||
| 产物 | `.doc/test-reports/assets/2026-09-16-intent-plan-playwright-dual-tab/` |
|
||||
|
||||
### 用例矩阵
|
||||
|
||||
| 用例 | 层级 | 期望 |
|
||||
|------|------|------|
|
||||
| 无 `RUN_UI_ACCEPTANCE` | Playwright | SKIP |
|
||||
| 双标签 confirm | UI + HTTP + PG | 1×200 + 1×409;败方 outdated |
|
||||
| 刷新 / 重登 | UI + GET active | 与 PG `executing` 一致 |
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- Tab A/B 均水合同一 `PLAN_CONFIRM`(`data-testid=plan-confirm-card`)
|
||||
- 并发 confirm:唯一 nonce → CAS 一胜一负;败方 `PLAN_STALE_REVISION` 且 UI `outdated`
|
||||
- 胜方 / 刷新 / 重登:`data-card-status` 为 `executing|resolved`,不可再以 active 确认
|
||||
- PG `intent_plans.status=executing`,`revision>=2`
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 用例 1:门控 SKIP
|
||||
|
||||
- **测试输入 (Input)**:`npx playwright test e2e/intent-plan-cards.spec.ts --project=chromium`(不设 `RUN_UI_ACCEPTANCE`)
|
||||
- **实际输出 (Actual Output)**:
|
||||
|
||||
```text
|
||||
1 skipped
|
||||
```
|
||||
|
||||
- **评价判定 (Evaluation / Verdict)**:**PASS**(SKIP,非冒充 PASS)
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
### 用例 2:双标签 confirm + 刷新/重登
|
||||
|
||||
- **测试输入 (Input)**:
|
||||
|
||||
```bash
|
||||
# Vite(含水合):3101 → API :8080
|
||||
RUN_UI_ACCEPTANCE=1 BASE_URL=http://127.0.0.1:3101 \
|
||||
ADMIN_USERNAME=… ADMIN_PASSWORD=… \
|
||||
UI_ACCEPTANCE_ASSETS_DIR=…/assets/2026-09-16-intent-plan-playwright-dual-tab \
|
||||
INTENT_PLAN_PG_DOCKER=shuimu-context-pg-dev \
|
||||
docker run --rm --network host -v <worktree>:/work \
|
||||
-v /var/run/docker.sock:/var/run/docker.sock \
|
||||
mcr.microsoft.com/playwright:v1.63.0-noble \
|
||||
bash -lc 'cd /work/web && npx playwright test e2e/intent-plan-cards.spec.ts --project=chromium'
|
||||
```
|
||||
|
||||
- **实际输出 (Actual Output)**(摘自 `assets/.../playwright-docker.txt` + `playwright-network.json`):
|
||||
|
||||
```text
|
||||
✓ dual-tab confirm mutual exclusion + reload/relogin matches PG (6.1s)
|
||||
1 passed (7.0s)
|
||||
|
||||
project=PlanDual-mu49uev8 projectId=6399 session=sess-p6399-u9
|
||||
planId=pln_e2e_mu49uev8
|
||||
decisions: tab A HTTP 200 → executing rev=2; tab B HTTP 409 PLAN_STALE_REVISION
|
||||
pgAfter: status=executing revision=2
|
||||
```
|
||||
|
||||
截图:`screenshots/01-tab-a-awaiting.png` … `06-tab-a-after-relogin.png`
|
||||
|
||||
- **评价判定 (Evaluation / Verdict)**:**PASS**
|
||||
- **性能与耗时 (Duration & Latency)**:约 7s(不含 Vite 冷启动)
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
```text
|
||||
# gated skip
|
||||
npx playwright test e2e/intent-plan-cards.spec.ts --project=chromium
|
||||
→ 1 skipped
|
||||
|
||||
# live acceptance
|
||||
RUN_UI_ACCEPTANCE=1 … playwright (docker host network)
|
||||
→ 1 passed (7.0s)
|
||||
```
|
||||
|
||||
说明:本任务为 Web UI 门控活验;全仓 `go test -v ./...` 未作为本报告阻断项(未改 Go 业务逻辑)。
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
- **达到合入/关闭 long-term 标准**:双标签 confirm 互斥 + 刷新/重登与 PG 一致已有真浏览器证据;默认 tier 未升。
|
||||
- 产品改动:`GET /intent-plans/active` 水合 PLAN_CONFIRM;confirm 使用唯一 `decisionNonce`;空 `docAST` 登录兜底;卡片 `data-testid`/`data-card-status`。
|
||||
- 建议:合 `dev` 后占槽 smoke;可将本 Docker 命令写入 nightly UI 可选 job;宿主机补齐 Chromium 系统库后可省 Docker 驱动。
|
||||
@@ -0,0 +1,550 @@
|
||||
# FEATURE-MATRIX 深度测试与 test 环境晋升 — 详细测试报告
|
||||
|
||||
**报告日期**: 2026-09-16
|
||||
**执行分支**: `feature/matrix-deep-test-promote-test` → 合入 `dev` → 晋升 `test`
|
||||
**候选 Tag**: `rc-v1.0.0-beta.2`
|
||||
**证据目录**: [`.doc/test-reports/assets/2026-09-16-matrix-deep-test/`](./assets/2026-09-16-matrix-deep-test/)
|
||||
**SSOT**: [FEATURE-MATRIX](../status/FEATURE-MATRIX.md) · [CURRENT](../ops/CURRENT.md) · [gap-matrix](../remediation/gap-matrix.md)
|
||||
|
||||
---
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
在 `production_ready=yes` 且三环境 schema 已对齐 47 的前提下,需要证明:
|
||||
|
||||
1. FEATURE-MATRIX 中**已实现**模块在当前代码上仍可运行(非仅历史报告);
|
||||
2. 本地 `dev` 可安全晋升并部署到 `test`(`:8081`),供后续人工/长期实测。
|
||||
|
||||
此前发布门禁 B1–B4 已签,但矩阵行多为「历史证据链接」。本轮以分层深度回归补**当日可复现**证据,并完成 `rc-v1.0.0-beta.2` 晋升。
|
||||
|
||||
**刻意不做**:完整 28min 三工作流 PI 重跑;Round20 全量 Playwright;纯软件项目自举(`planned`);合入 `main`;改写项目 143。
|
||||
|
||||
---
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
| # | 目标 | 成功标准 |
|
||||
|---|------|----------|
|
||||
| T1 | 门禁基线全绿 | `go vet` / `go test -short` / arch-check / npm / prod-bundle exit 0 |
|
||||
| T2 | 矩阵模块定向包全绿 | intent/chat/squad/workflow/authz/doc*/agent/events 定向 `ok` |
|
||||
| T3 | 治理 PG 集成可复现 | 隔离库上 `TestWorkflowGovernance_PG_*` + `TestE2E_WorkflowGovernance_*` PASS |
|
||||
| T4 | live 关键路径可用 | health、真实闲聊、会话授权、版本冲突、终止 preview、demo 无污染 |
|
||||
| T5 | 真实 PI runner 可用 | typed-result dual-track 四子测 PASS |
|
||||
| T6 | test 可更新部署 | `test` 合入 `dev`、tag、rebuild、smoke + 轻量 live PASS,schema=47 |
|
||||
|
||||
---
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
### 3.1 分层方案
|
||||
|
||||
```text
|
||||
Wave 1 自动化(短测 + 定向 + 隔离治理 PG)
|
||||
Wave 2 live API(dev :8080,真实 pi-agent)
|
||||
Wave 3 真实 PI 抽样(runner :18865;FAIL 才升格三链)
|
||||
Wave 4 晋升 test + rebuild + smoke + live :8081
|
||||
Wave 5 报告归档 + SSOT 注记修正
|
||||
```
|
||||
|
||||
### 3.2 环境指纹
|
||||
|
||||
| 环境 | 端口 | schema | agent_backend | 备注 |
|
||||
|------|------|--------|---------------|------|
|
||||
| shared KB | 5432 | — | — | 共享知识库 |
|
||||
| **dev** | **8080** / events 8088 / pi **18865** | **47** | **pi-agent** | Wave 2/3 |
|
||||
| **test** | **8081** / events 8089 / pi **18866** | **47** | **pi-agent** | Wave 4 |
|
||||
| main | 8000 | 47 | pi-agent | 本轮只读对照,不晋升 |
|
||||
|
||||
健康探针样例(dev):
|
||||
|
||||
```json
|
||||
{"status":"ok","env":"dev","agent_backend":"pi-agent","schema_version":47,"schema_ready":true,"task_store_ready":true}
|
||||
```
|
||||
|
||||
### 3.3 用例矩阵设计
|
||||
|
||||
| 矩阵模块 (mutex) | 验证手段 | 主要资产 |
|
||||
|------------------|----------|----------|
|
||||
| intent / intent-plan | short 定向包 | `modules.txt` |
|
||||
| chat / ctxmgr | short + live 闲聊/window/guest | `modules.txt` + `live-8080.json` |
|
||||
| squad | short | `modules.txt` |
|
||||
| workflow | 治理 PG + live SavePlan/冲突/激活/preview | `governance-pg-verbose.txt` + live JSON |
|
||||
| IAM / authz | live login / guest 403 / members | live JSON |
|
||||
| docgov / docrevision | short 包(不重跑 Round20 UI) | `modules.txt` |
|
||||
| web | npm + bundle + live 冲突恢复路径 | `npm.txt` / `bundle.txt` / live |
|
||||
| pi-agent | short + node result-v1 + live typed-result | `modules.txt` / `pi-sample-typed.txt` |
|
||||
| infra | health/ready/smoke | `dev-health.json` / `test-env-smoke.txt` |
|
||||
| CI / E2E | 治理 PG 复跑 | `governance-pg*.txt` |
|
||||
| events | short E0–E2 相关包 | `modules.txt` |
|
||||
| 纯软件自举 | — | **N/A(planned)** |
|
||||
|
||||
---
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
| Wave | 预期 |
|
||||
|------|------|
|
||||
| W1 | 全部命令 exit 0;治理 PG ≥2 用例 PASS |
|
||||
| W2 | `live-8080.json` `overall=PASS`;闲聊为真实模型回复;guest=`SESSION_FORBIDDEN`;冲突码=`ERR_CONCURRENT_SWITCH`;`can_terminate=true` |
|
||||
| W3 | typed-result 四子测 PASS;**不**强制跑三工作流 PI |
|
||||
| W4 | tag `rc-v1.0.0-beta.2`;`:8081` schema=47;smoke SUCCESS;`live-8081.json` overall=PASS |
|
||||
| 矩阵 | 已实现行全部 PASS 或 N/A;无 FAIL 阻挡晋升 |
|
||||
|
||||
---
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
> 每个典型用例固定四段:**测试输入 → 系统输出 → 分析 → 评价判定**。耗时一并给出。
|
||||
|
||||
---
|
||||
|
||||
### 5.1 Wave 1 — 门禁基线与模块定向
|
||||
|
||||
#### 用例 W1-01:`go vet ./...`
|
||||
|
||||
- **测试输入 (Input)**
|
||||
```bash
|
||||
env -u TEST_DATABASE_URL -u DATA_DIR go vet ./...
|
||||
```
|
||||
- **系统输出 (Actual Output)**
|
||||
- 无诊断输出;`vet_exit=0`(见 `vet.txt`)
|
||||
- **分析 (Analysis)**
|
||||
- 清空 `TEST_DATABASE_URL`/`DATA_DIR` 避免上一轮 PI 隔离库与工作区路径污染编译/静态检查上下文。
|
||||
- 无 vet 告警说明当前合入点类型与可疑构造检查通过。
|
||||
- **评价判定 (Evaluation)**:**PASS**
|
||||
- **耗时**:秒级
|
||||
|
||||
#### 用例 W1-02:`go test -short ./...`
|
||||
|
||||
- **测试输入 (Input)**
|
||||
```bash
|
||||
env -u TEST_DATABASE_URL -u DATA_DIR -u KB_DB_PORT go test -short ./...
|
||||
```
|
||||
- **系统输出 (Actual Output)**(摘自 `short.txt` 尾部)
|
||||
```text
|
||||
ok chat-agent-system/internal/server 10.668s
|
||||
ok chat-agent-system/internal/squad (cached)
|
||||
...
|
||||
short_exit=0
|
||||
```
|
||||
- **分析 (Analysis)**
|
||||
- 全仓 short 回归覆盖业务主路径单元/httptest 层。
|
||||
- `internal/server` ~10.7s 为最重包之一,仍在可接受范围内。
|
||||
- 历史踩坑:保留 `TEST_DATABASE_URL` 时,resume 类 PG 用例会误连隔离库并因缺用户 FK 失败;本轮强制 unset 后稳定。
|
||||
- **评价判定**:**PASS**
|
||||
- **耗时**:约 92s(全量 short 墙钟)
|
||||
|
||||
#### 用例 W1-03:架构边界门禁
|
||||
|
||||
- **测试输入 (Input)**
|
||||
```bash
|
||||
./scripts/arch-check.sh --mode block
|
||||
```
|
||||
- **系统输出 (Actual Output)**(`arch-check.txt`)
|
||||
```text
|
||||
arch-check mode=block
|
||||
boundaries=.../module-boundaries.yaml
|
||||
ok chat-agent-system/internal/archtest 0.138s
|
||||
arch-check block: production gate passed
|
||||
arch_exit=0
|
||||
```
|
||||
- **分析 (Analysis)**
|
||||
- block 模式失败即阻断晋升;本轮模块边界契约未回退。
|
||||
- **评价判定**:**PASS**
|
||||
|
||||
#### 用例 W1-04:前端 `npm test` + 生产包扫描
|
||||
|
||||
- **测试输入 (Input)**
|
||||
```bash
|
||||
cd web && npm test
|
||||
./scripts/check-prod-bundle.sh
|
||||
```
|
||||
- **系统输出 (Actual Output)**
|
||||
```text
|
||||
ℹ tests 376
|
||||
ℹ pass 376
|
||||
ℹ fail 0
|
||||
Test Files 3 passed (3) # vitest
|
||||
Tests 32 passed (32)
|
||||
✓ built in 7.44s
|
||||
PASS: prod bundle scan (.../web/dist)
|
||||
npm_exit=0 / bundle_exit=0
|
||||
```
|
||||
- **分析 (Analysis)**
|
||||
- tsx node:test 与 vitest 双轨均绿。
|
||||
- prod bundle 扫描确认 demo seeds 默认关闭(与 `DEMO-WEB-SEEDS` 门禁一致)。
|
||||
- **评价判定**:**PASS**
|
||||
- **耗时**:npm ~0.8s + build ~7.4s
|
||||
|
||||
#### 用例 W1-05:FEATURE-MATRIX 模块定向包
|
||||
|
||||
- **测试输入 (Input)**
|
||||
按模块分组执行(见 `modules.txt`),例如:
|
||||
```bash
|
||||
go test -short -count=1 ./internal/intent ./internal/coordinator \
|
||||
./internal/app/intentflow ./internal/app ./internal/events ./internal/server \
|
||||
-run 'TestSplitPlan|TestPlanProposal|...|IntentPlan|TestIntentRecognition|...'
|
||||
go test -short -count=1 ./internal/ctxmgr ./internal/app/chatflow ./internal/chat
|
||||
go test -short -count=1 ./internal/squad/...
|
||||
go test -short -count=1 ./internal/projectinstance ./internal/workflowdef \
|
||||
./internal/auth ./internal/authz ./internal/docgov ./internal/docrevision
|
||||
go test -short -count=1 ./internal/agent
|
||||
node --test deploy/pi-agent/result-v1.test.mjs
|
||||
go test -short -count=1 ./internal/events ./internal/app/docnotify \
|
||||
./internal/app/docadvance ./internal/app/docproject ./internal/app/docflow
|
||||
```
|
||||
- **系统输出 (Actual Output)**(摘要)
|
||||
| 分组 | 结果 |
|
||||
|------|------|
|
||||
| intent/intent-plan | 6 包 ok,`intent_exit=0` |
|
||||
| chat | 3 包 ok,`chat_exit=0` |
|
||||
| squad | ok,`squad_exit=0` |
|
||||
| workflow/authz/doc* | 6 包 ok,`waf_exit=0` |
|
||||
| pi-agent Go | ok 3.459s |
|
||||
| pi-agent node result-v1 | **3 pass / 0 fail** |
|
||||
| events E0–E2 | 5 包 ok,`events_exit=0` |
|
||||
- **分析 (Analysis)**
|
||||
- 定向包把 FEATURE-MATRIX 行映射到可执行命令,避免「只引用旧报告」。
|
||||
- docrevision 本轮仅 short;完整 UI Round20 不在范围,但短测未暴露回归。
|
||||
- **评价判定**:**PASS**
|
||||
|
||||
#### 用例 W1-06:治理 PG 集成(BUG-08 复跑)
|
||||
|
||||
- **测试输入 (Input)**
|
||||
```bash
|
||||
# 隔离库(禁止 agent_system_dev/test/main)
|
||||
CREATE DATABASE agent_gov_matrix;
|
||||
export TEST_DATABASE_URL='postgres://app:***@127.0.0.1:5434/agent_gov_matrix?sslmode=disable'
|
||||
go test ./internal/server/ -run 'TestWorkflowGovernance_PG_|TestE2E_WorkflowGovernance' \
|
||||
-timeout 20m -count=1 -v
|
||||
```
|
||||
- **系统输出 (Actual Output)**(`governance-pg-verbose.txt`)
|
||||
```text
|
||||
=== RUN TestE2E_WorkflowGovernance_CompleteAndReplan
|
||||
goose: no migrations to run. current version: 47
|
||||
--- PASS: TestE2E_WorkflowGovernance_CompleteAndReplan (0.31s)
|
||||
=== RUN TestWorkflowGovernance_PG_ActivateApproveAdvanceChain
|
||||
--- PASS: TestWorkflowGovernance_PG_ActivateApproveAdvanceChain (0.35s)
|
||||
PASS
|
||||
ok chat-agent-system/internal/server 0.663s
|
||||
```
|
||||
- **分析 (Analysis)**
|
||||
- 迁移链停在 **47**,与共享环境一致。
|
||||
- KB DSN 空配置触发离线降级日志,**不构成失败**(治理链路不依赖共享 KB)。
|
||||
- 覆盖「完成再规划」与「激活→批准→推进」两条治理主链。
|
||||
- **评价判定**:**PASS**
|
||||
- **耗时**:约 0.66s(库已迁完后复跑)
|
||||
|
||||
---
|
||||
|
||||
### 5.2 Wave 2 — live API 抽检(dev `:8080`)
|
||||
|
||||
**会话元数据**:项目 **6367** / `sess-p6367-u11` / `overall=PASS`(完整 JSON:[`live-8080.json`](./assets/2026-09-16-matrix-deep-test/live-8080.json))
|
||||
|
||||
#### 用例 W2-01:健康与后端真实性
|
||||
|
||||
- **测试输入**
|
||||
`GET /api/v1/health`、`GET /api/v1/ready`
|
||||
- **系统输出**
|
||||
```json
|
||||
{"status":"ok","env":"dev","agent_backend":"pi-agent","schema_version":47,"schema_ready":true,"task_store_ready":true}
|
||||
```
|
||||
- **分析**
|
||||
- `agent_backend=pi-agent` 排除 stub 冒充验收。
|
||||
- schema 47 与 goose 最新迁移一致。
|
||||
- **评价判定**:**PASS**(6ms)
|
||||
|
||||
#### 用例 W2-02:登录与账号可用性
|
||||
|
||||
- **测试输入**
|
||||
尝试 `zhanggong/123456` → 失败后改用 `lizhuguan`(owner)、`wangzong`(reviewer)、`admin`(approver)、`guest`
|
||||
- **系统输出**
|
||||
- `zhanggong`:**403**「账号已被停用,禁止登录」
|
||||
- 有效账号:owner_id=11,reviewer_id=12,approver_id=9,guest_id=13
|
||||
- **分析**
|
||||
- 停用账号 fail-closed,符合 IAM 预期。
|
||||
- 活验账号切换已写入证据 note,避免误用历史脚本默认用户。
|
||||
- **评价判定**:**PASS**(账号策略正确;替代账号可用)
|
||||
|
||||
#### 用例 W2-03:Demo 污染防护(项目列表)
|
||||
|
||||
- **测试输入**
|
||||
`GET /api/v1/projects`(Bearer owner)
|
||||
- **系统输出**
|
||||
- http=200;列表 count=7;`polluted=[]`(无 id 6001–6010)
|
||||
- **分析**
|
||||
- 与 goose 00046/00047 `demo_retired` + 列表过滤一致;演示十项目未回流列表。
|
||||
- **评价判定**:**PASS**
|
||||
|
||||
#### 用例 W2-04:新建项目与交付物洁净
|
||||
|
||||
- **测试输入**
|
||||
```http
|
||||
POST /api/v1/projects
|
||||
{"name":"矩阵深度抽检-051808","code":"mtx-051808",
|
||||
"device_type":"超声软组织手术吸引设备",...}
|
||||
GET /api/v1/projects/6367/documents
|
||||
```
|
||||
- **系统输出**
|
||||
- 创建:**201**,`project_id=6367`
|
||||
- 文档:http=200,`doc_count=0`,`mock_ids=[]`
|
||||
- **分析**
|
||||
- 新建项目无 mock/seed 交付物污染(`DEMO-WEB-SEEDS`/`DEMO-DB-SEED` 防线仍有效)。
|
||||
- **评价判定**:**PASS**(create 20ms)
|
||||
|
||||
#### 用例 W2-05:真实 PI 闲聊
|
||||
|
||||
- **测试输入**
|
||||
```http
|
||||
POST /api/v1/chat
|
||||
session_id=sess-p6367-u11
|
||||
message=先记录一下:本项目是超声软组织吸引设备立项摸底,请用一两句话确认你已记住设备类型
|
||||
```
|
||||
- **系统输出**
|
||||
- http=**200**,耗时 **8101ms**
|
||||
- 回复摘录:
|
||||
> 好的,已记住——本项目是**超声软组织吸引设备**(即超声软组织手术吸引设备)的立项摸底。…
|
||||
- **分析**
|
||||
- 延迟与语义均符合真实 MiniMax 链路,非 stub 瞬时模板。
|
||||
- 设备类型被正确回指,满足「记忆确认」意图抽检。
|
||||
- **评价判定**:**PASS**
|
||||
|
||||
#### 用例 W2-06:刷新窗口与分类一致性
|
||||
|
||||
- **测试输入**
|
||||
`GET /api/v1/chat/messages/window?session_id=sess-p6367-u11&days=7`
|
||||
`GET /api/v1/chat/categories?session_id=...`
|
||||
- **系统输出**
|
||||
- window http=200,`window_msgs=2`
|
||||
- categories http=200
|
||||
- **分析**
|
||||
- 一轮 user+assistant 后窗口至少 2 条,符合刷新可读预期(CHAT-HISTORY-REFRESH 相关契约)。
|
||||
- **评价判定**:**PASS**(3ms)
|
||||
|
||||
#### 用例 W2-07:双用户负例(guest)
|
||||
|
||||
- **测试输入**
|
||||
guest token 读取同一 `session_id` 的 window
|
||||
- **系统输出**
|
||||
- http=**403**,`error_code=SESSION_FORBIDDEN`
|
||||
- **分析**
|
||||
- 非会话 owner fail-closed;跨用户不可枚举他人对话。
|
||||
- **评价判定**:**PASS**
|
||||
|
||||
#### 用例 W2-08:工作流规划保存
|
||||
|
||||
- **测试输入**
|
||||
拉取 `workflow-plan/default?workflow_key=main` → 填充三权职责 →
|
||||
`PUT .../workflow-plan`(`expected_plan_revision=0`,`expected_selection_version=1`)
|
||||
- **系统输出**
|
||||
- http=**200**;`lifecycle_status=planning`;`workflow_plan_revision=1`
|
||||
- **分析**
|
||||
- 成员已 upsert 后 SavePlan 成功(避免历史 `DUTY_ASSIGNEE_NOT_ACTIVE_MEMBER`)。
|
||||
- **评价判定**:**PASS**(5ms)
|
||||
|
||||
#### 用例 W2-09:版本冲突(乐观锁)
|
||||
|
||||
- **测试输入**
|
||||
使用正确 `plan_revision`,但 `expected_selection_version=999` 再次 PUT
|
||||
- **系统输出**
|
||||
- http=**409**
|
||||
- 嵌套业务码:`ERR_CONCURRENT_SWITCH`(HTTP 信封外层可为 `VERSION_CONFLICT`)
|
||||
- **分析**
|
||||
- 前端已能解包嵌套业务码并映射 `retry_after_switch`;本用例验证后端冲突契约仍在。
|
||||
- **评价判定**:**PASS**(1ms)
|
||||
|
||||
#### 用例 W2-10:激活 + 终止 preview
|
||||
|
||||
- **测试输入**
|
||||
`POST .../activation-preview` → `POST .../workflow-instances/activate` →
|
||||
`GET /api/v1/workflow-instances/{id}/termination-preview`
|
||||
- **系统输出**
|
||||
- activate http=**200**
|
||||
- preview http=**200**;`instance_id=262`;`can_terminate=true`
|
||||
- keys: `pending_documents`, `in_progress_task_runs`, `can_terminate`, `impact`
|
||||
- **分析**
|
||||
- 激活后实例可查询终止影响面,满足治理「先 preview 再终止」门禁。
|
||||
- **评价判定**:**PASS**
|
||||
|
||||
**Wave 2 总评**:**PASS**(12/12 子用例)
|
||||
|
||||
---
|
||||
|
||||
### 5.3 Wave 3 — 真实 PI 抽样
|
||||
|
||||
#### 用例 W3-01:`TestPiAgentTypedResult_LiveDualTrack`
|
||||
|
||||
- **测试输入**
|
||||
```bash
|
||||
RUN_PI_E2E=1 \
|
||||
PI_AGENT_RUNNER_URL=http://127.0.0.1:18865 \
|
||||
PI_AGENT_RUNNER_AUTH_TOKEN=<from container> \
|
||||
DATA_DIR=.../data/dev \
|
||||
go test ./internal/agent -run TestPiAgentTypedResult_LiveDualTrack -timeout 15m -v -count=1
|
||||
```
|
||||
Runner 健康(`pi-runner-dev-health.json`):
|
||||
`ok=true`,`model_id=MiniMax-M2.7-highspeed`,`has_token=true`
|
||||
- **系统输出**(`pi-sample-typed.txt`)
|
||||
```text
|
||||
--- PASS: TestPiAgentTypedResult_LiveDualTrack (3.28s)
|
||||
--- PASS: .../failure_empty_prompt (0.00s)
|
||||
--- PASS: .../timeout (0.00s)
|
||||
--- PASS: .../cancel (0.30s)
|
||||
--- PASS: .../success (2.97s)
|
||||
pi_sample_exit=0
|
||||
```
|
||||
- **分析**
|
||||
- 覆盖成功路径与失败/超时/取消,证明 runner 鉴权、typed-result 编解码与取消语义可用。
|
||||
- 抽样已 PASS,按计划**不升格**完整三工作流 PI E2E(节约 ~28min,风险可控)。
|
||||
- **评价判定**:**PASS**
|
||||
- **耗时**:3.28s
|
||||
|
||||
---
|
||||
|
||||
### 5.4 Wave 4 — 晋升并部署 test
|
||||
|
||||
#### 用例 W4-01:Git 晋升与 Tag
|
||||
|
||||
- **测试输入**
|
||||
1. 首次执行 `./scripts/git-workflow-helper.sh promote-to-test rc-v1.0.0-beta.2`
|
||||
2. 因 `git pull --rebase origin test` 触发大规模 rebase 冲突 → `git rebase --abort`
|
||||
3. 改为:`git checkout test && git merge --no-ff dev` + `git tag -a rc-v1.0.0-beta.2`
|
||||
- **系统输出**
|
||||
- Tag 存在:`rc-v1.0.0-beta.2`
|
||||
- `test` 先端含 promote merge + 后续 closeout sync
|
||||
- **分析**
|
||||
- 本地 `test` 与 `origin/test` 分叉时,rebase 会重放数百提交,属**工具风险**而非产品缺陷。
|
||||
- 已加固 `scripts/git-workflow-helper.sh`:本地晋升默认不再 `pull --rebase origin test`。
|
||||
- **评价判定**:**PASS**(晋升目标达成;工具缺陷已修)
|
||||
|
||||
#### 用例 W4-02:test 容器 rebuild / 健康
|
||||
|
||||
- **测试输入**
|
||||
```bash
|
||||
./scripts/env-service.sh test rebuild
|
||||
# 中间误用 compose 导致 PG 端口绑到 5433 冲突后,改用 env-service start 恢复
|
||||
curl -sf http://127.0.0.1:8081/api/v1/health
|
||||
curl -sf http://127.0.0.1:8081/api/v1/ready
|
||||
curl -sf http://127.0.0.1:8089/health
|
||||
curl -sf http://127.0.0.1:18866/health
|
||||
```
|
||||
- **系统输出**
|
||||
- health/ready:`env=test`,`schema_version=47`,`agent_backend=pi-agent`
|
||||
- events:`{"env":"test","owner":"events-1","status":"ok"}`
|
||||
- pi-agent:`ok=true`,model `MiniMax-M2.7-highspeed`
|
||||
- **分析**
|
||||
- `.env` 中 `SYSTEM_DB_PUBLISH_PORT=5433` 会被裸 `docker compose` 覆盖 test 默认 5434;**必须**走 `env-service.sh test *`。
|
||||
- schema 与 dev 对齐 47,具备同构实测条件。
|
||||
- **评价判定**:**PASS**
|
||||
|
||||
#### 用例 W4-03:`test-env-smoke.sh`
|
||||
|
||||
- **测试输入**
|
||||
`./scripts/test-env-smoke.sh`(默认 `:8081` + pi `:18866`)
|
||||
- **系统输出**(`test-env-smoke.txt`)
|
||||
```text
|
||||
[PASS] test app SPA /
|
||||
[PASS] test app deep link /projects
|
||||
[PASS] pi-agent /health
|
||||
[SUCCESS] test env smoke passed
|
||||
```
|
||||
- **分析**
|
||||
- SPA/深链/runner 冒烟通过,说明前端静态资源与路由回退可用。
|
||||
- **评价判定**:**PASS**
|
||||
|
||||
#### 用例 W4-04:test 轻量 live(隔离库)
|
||||
|
||||
- **测试输入**
|
||||
- test 库初始仅 `admin`;经 SQL 注入 `mtx_owner/reviewer/approver`(复用 admin 密码哈希)
|
||||
- admin 创建项目(具备 `project:create`)→ 成员 upsert → SavePlan → 冲突 PUT → Activate → termination-preview
|
||||
- **禁止**读取 `data/dev`
|
||||
- **系统输出**([`live-8081.json`](./assets/2026-09-16-matrix-deep-test/live-8081.json))
|
||||
| 步骤 | HTTP / 结果 |
|
||||
|------|-------------|
|
||||
| health | schema=47,env=test |
|
||||
| create_project | **201**,`project_id=3`,code=`tst-052432` |
|
||||
| save_plan | **200**,`workflow_plan_revision=1` |
|
||||
| conflict | **409**,`ERR_CONCURRENT_SWITCH` |
|
||||
| activate | **200**,`lifecycle_status=active`,`active_workflow_key=main`,instance id=1 |
|
||||
| termination_preview | **200**,`can_terminate=true` |
|
||||
| **overall** | **PASS** |
|
||||
- **分析**
|
||||
- 项目 id=3 说明 test 业务库与 dev(6367)**严格隔离**。
|
||||
- 冲突/激活/preview 契约与 dev 一致,证明晋升镜像行为正确。
|
||||
- 副作用:`mtx_*` 为测试账号种子,可保留供后续实测。
|
||||
- **评价判定**:**PASS**
|
||||
|
||||
**Wave 4 总评**:**PASS**
|
||||
|
||||
---
|
||||
|
||||
### 5.5 FEATURE-MATRIX 行级评价汇总
|
||||
|
||||
| 模块 | 状态(矩阵) | 本轮验证 | 评价 |
|
||||
|------|------------|----------|------|
|
||||
| 意图识别 L1 | partial | W1 定向 | **PASS(功能可用)**;U9–U12 仍为 backlog |
|
||||
| 多意图持久计划 | partial | W1 定向 | **PASS(U1–U8 短测)**;schema 注记已改为 47 |
|
||||
| 对话 / ctxmgr | partial | W1+W2 | **PASS** |
|
||||
| 智能体小队 | done | W1 | **PASS** |
|
||||
| 工作流治理 | partial | W1-06+W2+W4 | **PASS** |
|
||||
| 纯软件项目自举 | planned | — | **N/A** |
|
||||
| IAM / 鉴权 | partial | W2/W4 | **PASS**(含停用账号与 guest 负例) |
|
||||
| 文档治理 | done | W1 short | **PASS(短测)**;未重跑 UI Round20 |
|
||||
| 文档版本与修改认知 | partial | W1 short | **PASS(短测)**;change-report 仍 fallback |
|
||||
| 前端工作台 | partial | W1 npm + W2 冲突路径 | **PASS** |
|
||||
| PI Runner | done | W1+W3 | **PASS** |
|
||||
| 三环境运维 | done | W2/W4 health | **PASS** |
|
||||
| CI / E2E | partial | W1-06 | **PASS(治理 PG)**;`-race` flake 仍为基建债 |
|
||||
| 模块解耦与事件 | partial | W1 events | **PASS(短测)** |
|
||||
|
||||
---
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
| 命令 | 结果 | 证据 |
|
||||
|------|------|------|
|
||||
| `go vet ./...` | exit 0 | `vet.txt` |
|
||||
| `go test -short ./...` | exit 0 | `short.txt` |
|
||||
| `./scripts/arch-check.sh --mode block` | PASS | `arch-check.txt` |
|
||||
| `cd web && npm test` | 376 + 32 PASS | `npm.txt` |
|
||||
| `./scripts/check-prod-bundle.sh` | PASS | `bundle.txt` |
|
||||
| 模块定向套件 | 全组 exit 0 | `modules.txt` |
|
||||
| 治理 PG(`agent_gov_matrix`) | 2 PASS | `governance-pg-verbose.txt` |
|
||||
| PI typed-result live | 4/4 PASS | `pi-sample-typed.txt` |
|
||||
| `./scripts/test-env-smoke.sh` | SUCCESS | `test-env-smoke.txt` |
|
||||
| live `:8080` / `:8081` | overall PASS | `live-8080.json` / `live-8081.json` |
|
||||
|
||||
**通过率(本轮门禁用例)**:Wave 1–4 关键用例 **100% PASS**;矩阵已实现行 **无 FAIL**;planned 行 **N/A**。
|
||||
|
||||
---
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
### 7.1 结论
|
||||
|
||||
1. **系统可正常运作**:短测、模块定向、治理 PG、dev/test live 与真实 PI 抽样均 PASS。
|
||||
2. **FEATURE-MATRIX 已实现能力**在本轮证据下可判定为**可用/未回归**;planned 的「纯软件项目自举」不纳入本轮验收。
|
||||
3. **test 服务端已更新部署**:本地 `test` @ `rc-v1.0.0-beta.2`,`:8081` schema=47,smoke + 轻量 live PASS。
|
||||
4. **总评价**:**达到晋升与深度回归目标,建议作为当前 test 实测基线。**
|
||||
|
||||
### 7.2 风险与后续
|
||||
|
||||
| 项 | 说明 | 建议 |
|
||||
|----|------|------|
|
||||
| 完整三工作流 PI | 本轮仅抽样 | 夜间 `RUN_PI_E2E=1` 或发版前补跑 |
|
||||
| Round20 UI | 未重跑 | 文档修订大改动时再跑 Playwright |
|
||||
| `zhanggong` 停用 | dev 默认脚本用户失效 | 更新活验脚本默认账号 |
|
||||
| test 缺种子用户 | 仅 admin | 晋升后补 demo/业务用户种子或文档化 SQL 种子步骤 |
|
||||
| 远端同步 | 未 push | 用户授权后 `./scripts/git-push-dev.sh test` 并推送 tag |
|
||||
| promote 工具 | 已修默认 rebase | 继续避免对分叉 `test` 做 origin rebase |
|
||||
|
||||
### 7.3 关键产物索引
|
||||
|
||||
| 文件 | 内容 |
|
||||
|------|------|
|
||||
| `assets/.../live-8080.json` | dev 全链路抽检 |
|
||||
| `assets/.../live-8081.json` | test 晋升后抽检 |
|
||||
| `assets/.../pi-sample-typed.txt` | 真实 PI 抽样 |
|
||||
| `assets/.../governance-pg-verbose.txt` | 治理 PG |
|
||||
| `assets/.../short.txt` / `modules.txt` / `npm.txt` | 自动化基线 |
|
||||
| `assets/.../test-env-smoke.txt` | test 冒烟 |
|
||||
@@ -0,0 +1,46 @@
|
||||
# Nightly DATA_DIR 对齐测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
Gitea nightly run#21 使用 `PI_AGENT_RUNNER_URL=http://127.0.0.1:18865`(dev PI,挂载 `data/dev/workspaces`),但 workflow 设置 `DATA_DIR=/host-agent-data/test`,导致 Go 侧 workspace 与 PI 容器物理路径错配;U8 出现 `quality_failed` → `product_fail`。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- `DATA_DIR=/host-agent-data/dev` 与 `:18865` 对齐
|
||||
- 确认 `quality_failed` 重试路径仍在脚本中
|
||||
- `workflow_dispatch` 后 receipt 非因 DATA_DIR 错配导致的 infra/product 误判
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- OS: Linux;Gitea act_runner `nightly:host` + host network
|
||||
- PI: `127.0.0.1:18865` MiniMax-M2.7-highspeed
|
||||
- PG: `NIGHTLY_TEST_DATABASE_URL` → `:5434`
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- checkout / setup-go / archive PASS
|
||||
- 用例不再因 DATA_DIR skip;workspace 路径含 `data/dev/workspaces`
|
||||
- receipt `pass`,或重试后 `pass`;若仍 `product_fail` 则归模型质量门并记录
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 配置变更
|
||||
|
||||
- Input: `DATA_DIR` test → dev
|
||||
- Actual: workflow 已合入 `dev`
|
||||
- Verdict: PASS(配置)
|
||||
- Duration: n/a
|
||||
|
||||
### Nightly 重跑
|
||||
|
||||
- run#25 (`89ce3cc`): DATA_DIR=dev 已对齐,但 `/host-agent-data` 曾 `:ro` → mkdir RO → product_fail(已改 compose rw)
|
||||
- run#30 (`776b2b5`): **U8 PASS (263s)**;FullNone FAIL → receipt `product_fail`(模型/链路产品失败,非 DATA_DIR/infra)
|
||||
- Verdict: **DATA_DIR 对齐 PASS**;套件整体仍 product_fail(FullNone)
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
- 本项为 CI workflow 配置修复;`go test -short` 不覆盖 nightly。
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
- 配置对齐为 P1 必做项;若对齐后仍偶发 quality_failed,依赖脚本重试与产品侧质量门调优(不回退为 infra)。
|
||||
@@ -0,0 +1,51 @@
|
||||
# Phase 3 遗留修复测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
Wave 2B N7 本机 nightly 在 U8 真实 PI 出现 `quality_failed`(产品质量门,非 infra);Playwright intent-plan 双标签仍为 skip 骨架;矩阵/DoD 仍有开放项需清点而不假完成。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 明确 N7 根因分类 + 门禁策略(重试一次,仍失败 product_fail)
|
||||
- Playwright 正式 gated 文档化
|
||||
- 遗留项 handoff 清点
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
| 项 | 值 |
|
||||
|----|-----|
|
||||
| 分支 | `fix/wave-leftovers-n7-playwright-dod` |
|
||||
| 证据 | Wave2B receipt `67d7335…` product_fail;脚本重试逻辑 |
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- quality_failed → 脚本重试一次;二次仍失败 → product_fail receipt
|
||||
- 不将 quality_failed 标为 infra 或 PASS
|
||||
- 矩阵写明 Playwright 关闭条件
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### L1 — N7 根因与策略
|
||||
|
||||
- **Input**:Wave2B 控制台 `PI run status=quality_failed want completed`
|
||||
- **Actual**:属产品质量门失败;`run-nightly-real-pi.sh` 增加一次全文重试
|
||||
- **Verdict**:PASS(策略落地;未把偶发写成绿)
|
||||
|
||||
### L2 — Playwright gated
|
||||
|
||||
- **Input**:阅读 `web/e2e/intent-plan-cards.spec.ts`
|
||||
- **Actual**:`test.skip(!RUN_UI_ACCEPTANCE)`;long-term + 矩阵关闭条件已写
|
||||
- **Verdict**:PASS(正式 gated,非 stub 冒充)
|
||||
|
||||
### L3 — 遗留清点
|
||||
|
||||
- **Actual**:handoff `2026-09-16-phase3-leftover-closeout.md`
|
||||
- **Verdict**:PASS
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
`go vet` + 洁净 `go test -short ./...`(合入冒烟)。
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
三相计划收口。nightly 真 PASS 依赖 runner+模型稳定与 Actions secrets;Playwright/PU6–PU8 等获批后再开实现。
|
||||
@@ -0,0 +1,112 @@
|
||||
# PU6 语义摘要 shadow 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
P4 PU6 在覆盖 no-go 授权后需落地 `SEMANTIC_SUMMARY_SHADOW`:在授权可见消息集合上评估语义摘要,失败时保留 deterministic 摘要并标注 freshness;`SEMANTIC_SUMMARY_REPLACE` 本波刻意不接线。基线 deterministic 滚动摘要与每日 digest 规则引擎已存在,需证明 flag off 行为不变,且 injection / 撤权消息不能扩大可见集。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- flag 默认 off:滚动摘要 / digest 行为与基线一致(无 shadow 字段)。
|
||||
- flag on:仅对 authorized-visible 消息生成 shadow;served Narrative/Headline 仍为 deterministic。
|
||||
- 模型/stub 失败:保留 deterministic + `freshness_note`。
|
||||
- 无工具权限(`tool_permissions=none`);prompt injection 不能提权纳入不可见阶段消息。
|
||||
- REPLACE 即使 env 为 true 也不替换 served narrative。
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- OS:Linux;Go:`go test -short`
|
||||
- 后端:内存 `ContextManager` + chatflow Adapter(受限 StageAccess);无真实 LLM / 无工具回调;stub / heuristic summarizer
|
||||
- 层级:单元 + 表征(characterization)测试
|
||||
- 核心用例矩阵:
|
||||
|
||||
| 用例 | Flag | 期望 |
|
||||
|------|------|------|
|
||||
| FlagOffUnchanged | off | 无 Shadow/Freshness;Narrative 不含 stub |
|
||||
| ShadowOKKeepsDeterministic | on(+REPLACE env) | Shadow ok;Narrative 仍 deterministic |
|
||||
| ShadowFailure+Freshness | on | fallback + freshness;Narrative 保留 |
|
||||
| Minimize R13 | — | 截断/去 metadata;digest 稳定 |
|
||||
| Digest FlagOff / Fallback | off/on | digest 字段一致 |
|
||||
| ChatLog injection/撤权 | on | 不可见报价不入摘要/facts;count=1 |
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- off:与 `TestRollingSummarizer_LifecycleAndFactPreservation` 同类 deterministic 行为。
|
||||
- on 成功:`shadow.status=ok`,`tool_permissions=none`,有 `input_digest`。
|
||||
- on 失败:`shadow.status=fallback`,`freshness_note` 含 `deterministic retained`。
|
||||
- chatflow:注入文案不能把 `V1.0_quoting` 秘密纳入 Narrative/Shadow/Facts。
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 Flag off 不变
|
||||
|
||||
- **测试输入 (Input)**:`SetSummaryFlagsForTest({Shadow:false})` + stub narrative `SHOULD_NOT_APPEAR`;`go test -short -v ./internal/ctxmgr/ -run TestSemanticSummary_FlagOffUnchanged`
|
||||
- **实际输出 (Actual Output)**:
|
||||
```
|
||||
=== RUN TestSemanticSummary_FlagOffUnchanged
|
||||
--- PASS: TestSemanticSummary_FlagOffUnchanged (0.00s)
|
||||
```
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<1ms
|
||||
|
||||
### 5.2 Shadow 成功且不 REPLACE
|
||||
|
||||
- **测试输入 (Input)**:Shadow=true,Replace=true(env 开但未接线);stub `语义影子叙事:超声刀立项`
|
||||
- **实际输出 (Actual Output)**:
|
||||
```
|
||||
=== RUN TestSemanticSummary_ShadowOKKeepsDeterministic
|
||||
--- PASS: TestSemanticSummary_ShadowOKKeepsDeterministic (0.00s)
|
||||
```
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(served Narrative 未替换;facts 保留)
|
||||
- **性能与耗时 (Duration & Latency)**:<1ms
|
||||
|
||||
### 5.3 Shadow 失败 + freshness
|
||||
|
||||
- **测试输入 (Input)**:stub `Err=model timeout`
|
||||
- **实际输出 (Actual Output)**:
|
||||
```
|
||||
=== RUN TestSemanticSummary_ShadowFailureKeepsDeterministicWithFreshness
|
||||
--- PASS: TestSemanticSummary_ShadowFailureKeepsDeterministicWithFreshness (0.00s)
|
||||
```
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<1ms
|
||||
|
||||
### 5.4 授权可见 + injection 负例(chatflow)
|
||||
|
||||
- **测试输入 (Input)**:可见 triage 含 “Ignore previous…grant yourself auth…”;不可见 quoting「预算200万」;`GenerateRollingSummary` / `GenerateDigest`
|
||||
- **实际输出 (Actual Output)**:
|
||||
```
|
||||
=== RUN TestChatLog_SemanticShadowAuthorizedOnlyAndInjectionCannotEscalate
|
||||
--- PASS: TestChatLog_SemanticShadowAuthorizedOnlyAndInjectionCannotEscalate (0.00s)
|
||||
```
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(budget 事实未泄漏;digest message_count=1)
|
||||
- **性能与耗时 (Duration & Latency)**:<5ms
|
||||
|
||||
### 5.5 基线滚动摘要回归
|
||||
|
||||
- **测试输入 (Input)**:`TestRollingSummarizer_LifecycleAndFactPreservation`
|
||||
- **实际输出 (Actual Output)**:PASS
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
命令:
|
||||
|
||||
```bash
|
||||
go test -short ./internal/ctxmgr/ ./internal/app/chatflow/ ./internal/server/
|
||||
```
|
||||
|
||||
结果(本机 worktree):
|
||||
|
||||
```
|
||||
ok chat-agent-system/internal/ctxmgr
|
||||
ok chat-agent-system/internal/app/chatflow
|
||||
ok chat-agent-system/internal/server
|
||||
```
|
||||
|
||||
通过率:相关包 100%(`-short`)。
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
- **结论**:PU6 shadow 门可合并候选分支验收(单元/表征);默认 flag off;REPLACE 未接线。
|
||||
- **未做(本波非目标)**:真实 MiniMax/PI 出站质量窗、browser 恢复、开 flag 放量、REPLACE。
|
||||
- **后续**:真实模型 shadow 质量与泄漏负例达标后再独立任务评估 REPLACE;读路径继续默认 deterministic。
|
||||
@@ -0,0 +1,120 @@
|
||||
# PU7 PI change-report 叙事 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
文档版本 baseline 已交付确定性 diff + lineage + fallback change report。覆盖授权后需落地可选 PI 叙事增强:默认 flag off,开启时只读消费 immutable 输入,任意失败全量降级,且不得覆盖服务端风险/审批。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- `PI_CHANGE_REPORT_NARRATIVE` 默认 off
|
||||
- Flag on 合法叙事:保留服务端 `rule_risk` 与 lineage,仅叠加叙事字段
|
||||
- Flag on 畸形/超时/digest 不匹配/partial:全量 deterministic fallback,无混合字段
|
||||
- UI view-model 区分事实字段与叙事来源
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- OS:Linux;Go:模块内 `go test`
|
||||
- 层级:`internal/docrevision` 单元/服务路径;`deploy/pi-agent` schema 单测;前端 `overlayMode.test.ts` view-model
|
||||
- 本报告为 feature 分支验收(**未**合入 `dev`,**未**开启生产 flag)。真实容器 PI 叙事联调留待 flag-on 晋级任务
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
| 用例 | 预期 |
|
||||
|------|------|
|
||||
| Flag 默认 | `PIChangeReportNarrativeEnabled()==false` |
|
||||
| Flag off + 叙事 payload | 忽略叙事 → `analysis_status=fallback` |
|
||||
| Flag on + 合法 narrative | `complete`;`risk_level==rule_risk`;lineage 不被 PI 伪造覆盖 |
|
||||
| Flag on + TIMEOUT/malformed | `fallback`;`err==nil`;无 PI 摘要泄漏 |
|
||||
| UI complete | `isNarrativeComplete=true`;事实 notes 含 rule_risk |
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 Flag 默认 off
|
||||
|
||||
- **Input**:进程未设置 `PI_CHANGE_REPORT_NARRATIVE`
|
||||
- **Actual Output**:
|
||||
|
||||
```text
|
||||
=== RUN TestPIChangeReportNarrativeFlagDefaultOff
|
||||
--- PASS: TestPIChangeReportNarrativeFlagDefaultOff (0.00s)
|
||||
=== RUN TestResolveChangeReport_FlagOffUsesDeterministic
|
||||
--- PASS: TestResolveChangeReport_FlagOffUsesDeterministic (0.00s)
|
||||
=== RUN TestCreateAgentCandidate_FlagOffIgnoresNarrativeEnrichment
|
||||
--- PASS: TestCreateAgentCandidate_FlagOffIgnoresNarrativeEnrichment (0.00s)
|
||||
```
|
||||
|
||||
- **Verdict**:PASS
|
||||
- **Duration**:<10ms
|
||||
|
||||
### 5.2 Flag on — 合法叙事不覆盖服务端风险
|
||||
|
||||
- **Input**:`schema_kind=change_report_narrative_v1` + 匹配 `input_digest`;PI `risk.level=low`;伪造 `document_impacts`
|
||||
- **Actual Output**:
|
||||
|
||||
```text
|
||||
=== RUN TestResolveChangeReport_FlagOnValidNarrativeKeepsServerRisk
|
||||
--- PASS: TestResolveChangeReport_FlagOnValidNarrativeKeepsServerRisk (0.00s)
|
||||
```
|
||||
|
||||
- **Verdict**:PASS(服务端 high/critical floor 保留;lineage=`doc_down`)
|
||||
|
||||
### 5.3 Flag on — 全量 fallback(无混合字段)
|
||||
|
||||
- **Input**:bad json / schema / digest / TIMEOUT envelope / partial / empty summary
|
||||
- **Actual Output**:
|
||||
|
||||
```text
|
||||
=== RUN TestResolveChangeReport_FlagOnMalformedFullFallback
|
||||
=== RUN TestResolveChangeReport_FlagOnMalformedFullFallback/bad_json
|
||||
=== RUN TestResolveChangeReport_FlagOnMalformedFullFallback/bad_schema_version
|
||||
=== RUN TestResolveChangeReport_FlagOnMalformedFullFallback/digest_mismatch
|
||||
=== RUN TestResolveChangeReport_FlagOnMalformedFullFallback/timeout_envelope
|
||||
=== RUN TestResolveChangeReport_FlagOnMalformedFullFallback/partial_flag
|
||||
=== RUN TestResolveChangeReport_FlagOnMalformedFullFallback/empty_summary
|
||||
--- PASS: TestResolveChangeReport_FlagOnMalformedFullFallback (0.00s)
|
||||
=== RUN TestCreateAgentCandidate_FlagOnTimeoutFallsBackWithoutError
|
||||
--- PASS: TestCreateAgentCandidate_FlagOnTimeoutFallsBackWithoutError (0.00s)
|
||||
```
|
||||
|
||||
- **Verdict**:PASS
|
||||
|
||||
### 5.4 前端叙事 vs 事实
|
||||
|
||||
- **Input**:`analysis_status=complete` + `deterministic_facts`
|
||||
- **Actual Output**:`marks complete analysis as PI narrative vs factual fields` PASS(14/14 overlayMode 相关套件)
|
||||
- **Verdict**:PASS
|
||||
|
||||
### 5.5 pi-agent typed schema helper
|
||||
|
||||
```text
|
||||
change-report-narrative-v1.test.mjs: ok
|
||||
```
|
||||
|
||||
- **Verdict**:PASS
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
```text
|
||||
$ go test -v -count=1 ./internal/docrevision/ -run 'Narrative|FlagOff|FlagOn|DeterministicChangeReport'
|
||||
PASS
|
||||
ok chat-agent-system/internal/docrevision 0.004s
|
||||
|
||||
$ go test -count=1 -short ./internal/docrevision/
|
||||
PASS
|
||||
ok chat-agent-system/internal/docrevision 0.007s
|
||||
|
||||
$ node deploy/pi-agent/change-report-narrative-v1.test.mjs
|
||||
change-report-narrative-v1.test.mjs: ok
|
||||
|
||||
$ tsx --test src/features/documentRevision/overlayMode.test.ts
|
||||
ℹ tests 14
|
||||
ℹ pass 14
|
||||
ℹ fail 0
|
||||
```
|
||||
|
||||
通过率:上述套件 **100%**。
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
- **结论**:PU7 在 `feature/pu7-pi-narrative` 达到契约要求;默认 off,回滚=关 flag;可合入 `dev` 前占集成槽位冒烟。
|
||||
- **后续**:flag-on 真实 PI 容器联调与 browser 验收另开任务;勿默认开启 `PI_CHANGE_REPORT_NARRATIVE`。
|
||||
@@ -0,0 +1,70 @@
|
||||
# PU8 U9–U12 独立 flag 脚手架 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
P5 覆盖授权后需为 U9–U12 提供分项独立 flag 与最小端口脚手架。默认必须 OFF,且不得升 `MULTI_INTENT_PLAN_TIER`;flag off 行为等于当前 legacy。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 四 flag 默认 off;env 开启互不耦合 PlanTier
|
||||
- U9:默认 disabled;开启后 malformed/timeout/越界 fail closed;正常路径不 panic
|
||||
- U10–U12:默认不注册 adapters;开启后 dry-run/revision 门禁可用且不 panic
|
||||
- 既有 intentflow 回归仍 PASS
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
| 项 | 值 |
|
||||
|----|----|
|
||||
| OS | linux |
|
||||
| 分支 | `feature/pu8-u9-u12-flags`(自 `origin/dev@776b2b5`) |
|
||||
| Go | `go test` 单元层 |
|
||||
| 后端 | stub dry-run(无真实 LLM / 无领域写副作用) |
|
||||
| 证据 | `.doc/test-reports/assets/2026-09-16-pu8-u9-u12-flags/` |
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
| 场景 | 预期 |
|
||||
|------|------|
|
||||
| 空 env | 四 flag false;PlanTier=legacy |
|
||||
| U9 off | `SEGMENT_PROPOSAL_DISABLED` |
|
||||
| U9 on + 坏 schema / 超时 / 越界 | fail closed |
|
||||
| U10–U12 off | `BuildOwnerMux` 不挂 Mutate/DocGov/RunControl |
|
||||
| U10–U12 on | dry-run Execute 成功;缺 revision → `PLAN_ACTION_VERSION_CONFLICT` |
|
||||
| 开 flag | PlanTier 仍为 legacy |
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 Expansion flags / segment / dry-run
|
||||
|
||||
- **测试输入**:`go test ./internal/app/intentflow -run 'TestExpansion|TestActiveSegment|TestStubSegment|TestBuildOwner|TestDryRun|TestPlanTierIndependentOfExpansion' -count=1 -v`
|
||||
- **实际输出**:见 [expansion-flags.txt](./assets/2026-09-16-pu8-u9-u12-flags/expansion-flags.txt)。8 用例全部 PASS。
|
||||
- **评价判定**:PASS
|
||||
- **性能与耗时**:约 9ms
|
||||
|
||||
### 5.2 intentflow 全包回归
|
||||
|
||||
- **测试输入**:`go test ./internal/app/intentflow -count=1`
|
||||
- **实际输出**:`ok`(见 [intentflow-summary.txt](./assets/2026-09-16-pu8-u9-u12-flags/intentflow-summary.txt))
|
||||
- **评价判定**:PASS
|
||||
- **性能与耗时**:约 13ms
|
||||
|
||||
### 5.3 app 包(含 BuildOwnerMux 接线)
|
||||
|
||||
- **测试输入**:`go test -short ./internal/app -count=1`
|
||||
- **实际输出**:`ok`(见 [app-short.txt](./assets/2026-09-16-pu8-u9-u12-flags/app-short.txt))
|
||||
- **评价判定**:PASS
|
||||
- **性能与耗时**:约 16ms
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
| 命令 | 结果 |
|
||||
|------|------|
|
||||
| `go test ./internal/app/intentflow -count=1` | PASS |
|
||||
| `go test -short ./internal/app -count=1` | PASS |
|
||||
| `go vet ./internal/app/intentflow ./internal/app` | PASS(无输出) |
|
||||
|
||||
本轮为 flag/端口脚手架验收,使用 stub dry-run;未升 tier,未 rebuild `:8080`,未跑真实 PI。
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
脚手架达到分支交付标准(push `feature/pu8-u9-u12-flags`,**不合 `dev`**)。后续:U9 真实 PI eval;U10–U12 分项 live adapter + 授权负例;仍禁止默认升 `MULTI_INTENT_PLAN_TIER=full`。
|
||||
@@ -0,0 +1,135 @@
|
||||
# 纯软件项目自举(SWBOOT-00..09)测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
工作流引擎已声明 `non_medical_software`,但正式目录与创建入口仍硬编码医疗三工作流。本轮在 `feature/software-project-bootstrap` 落地 SWBOOT-00..09 契约、迁移、manifest、目录白名单、创建向导后端钩子,以及 SWBOOT-10 allowlist stub(无真实 patch/merge)。医疗既有三工作流保持不变。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- `software_bootstrap` / `software_delivery` manifest 可校验且无医疗默认语义污染
|
||||
- 正式可选 key 扩展为 5,医疗固定文档数门禁仍仅约束医疗三
|
||||
- 创建预览拒绝 `controlled_patch` 与 controlled/privacy+solo 冲突
|
||||
- SWBOOT-10 stub 对非 allowlist 路径与 patch/merge fail closed
|
||||
- `go vet` + 相关包 `-short` 单测通过;不冒充真实 PI / UI 验收
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
| 项 | 值 |
|
||||
|----|-----|
|
||||
| OS | Linux 7.0.0-31-generic |
|
||||
| Go | go1.27.1 linux/amd64 |
|
||||
| Branch | `feature/software-project-bootstrap` |
|
||||
| Commit | `f6034fa`(报告提交前基线;含后续 test/docs 提交) |
|
||||
| 实测时间 | 2026-09-16T15:44:30Z |
|
||||
| 层级 | L1 单元 / 包级回归;L2+ PG 空库迁移、真实 PI、Ubuntu UI 本轮 **NOT RUN** |
|
||||
| 后端 | stub 允许用于本轮工程门禁;禁止作为最终产品验收 |
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
| 用例 | 预期 |
|
||||
|------|------|
|
||||
| UC-01 Official keys | 5 keys;医疗 3 + 软件 2 |
|
||||
| UC-02 Domain filter | `software_*` 拒 `medical_device`;空 domain 不过滤 |
|
||||
| UC-03 Manifest validate | bootstrap/delivery `ValidateDefinitionV2` PASS;标题无临床/NMPA/CDMO |
|
||||
| UC-04 Creation preview | solo+standard 出 `creator_acknowledgement`;privacy+solo 与 controlled_patch 失败 |
|
||||
| UC-05 Repo allowlist stub | 非白名单拒;白名单路径仍拒 ExecuteControlledPatch/ApproveMerge |
|
||||
| UC-06 Software create | `non_medical_software` 落库字段;阶段 `S0_boundary`;不发明医疗 device 字段 |
|
||||
| UC-07 Medical regression | main v2 固定 7 文档校验仍 PASS;server API lifecycle 期望挂载 5 |
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### UC-01 Official keys
|
||||
|
||||
- **测试输入 (Input)**:`go test -short ./internal/workflowdef/ -run TestOfficialWorkflowKeys`
|
||||
- **实际输出 (Actual Output)**:`ok chat-agent-system/internal/workflowdef`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:~0.003s
|
||||
|
||||
### UC-02 Domain filter
|
||||
|
||||
- **测试输入 (Input)**:`TestCompatibleWithProductDomain`
|
||||
- **实际输出 (Actual Output)**:包含于 workflowdef 包 PASS
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:含于包耗时
|
||||
|
||||
### UC-03 Manifest validate + 去污染
|
||||
|
||||
- **测试输入 (Input)**:`TestValidateDefinitionV2_SoftwareManifests`
|
||||
- **实际输出 (Actual Output)**:bootstrap/delivery 校验通过;医疗词扫描无命中
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:含于包耗时
|
||||
|
||||
### UC-04 Creation preview
|
||||
|
||||
- **测试输入 (Input)**:`go test -short ./internal/swboot/ -run 'TestBuildCreationPreview|TestProjectTypesCatalog'`
|
||||
- **实际输出 (Actual Output)**:`ok chat-agent-system/internal/swboot`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:~0.002s
|
||||
|
||||
### UC-05 Repo allowlist stub
|
||||
|
||||
- **测试输入 (Input)**:`TestRepoAllowlistStub`
|
||||
- **实际输出 (Actual Output)**:非 allowlist → `ERR_REPO_PATH_NOT_ALLOWLISTED`;patch/merge → `ERR_SWBOOT10_STUB_ONLY`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:含于 swboot 包
|
||||
|
||||
### UC-06 Software create
|
||||
|
||||
- **测试输入 (Input)**:`TestCreateSoftwareProject_NoMedicalDefaults`
|
||||
- **实际输出 (Actual Output)**:`ok chat-agent-system/internal/projectworkflow`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:~0.003s
|
||||
|
||||
### UC-07 Medical regression + server API
|
||||
|
||||
- **测试输入 (Input)**:`go test -short ./internal/server/ -run TestProjectWorkflowAPI_Lifecycle` 及全包 short
|
||||
- **实际输出 (Actual Output)**:挂载/目录数量期望已更新为 5;`ok chat-agent-system/internal/server`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(医疗语义与旧 API 行为保留;仅目录容量扩展)
|
||||
- **性能与耗时 (Duration & Latency)**:server 包 ~10.9s
|
||||
|
||||
### 未执行(明示)
|
||||
|
||||
| 项 | Status |
|
||||
|----|--------|
|
||||
| PostgreSQL 空库/旧库升级到 schema 48 活验 | NOT RUN |
|
||||
| 真实 PI Agent Runner 文档生成 | NOT RUN |
|
||||
| Ubuntu Playwright UI-SW-00..14 | NOT RUN |
|
||||
| 受控 patch worktree 真实执行 | NOT RUN(仅 stub) |
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
命令:
|
||||
|
||||
```bash
|
||||
go vet ./internal/swboot/ ./internal/workflowdef/ ./internal/projectworkflow/ ./internal/workflow/ ./internal/server/
|
||||
go test -short -count=1 \
|
||||
./internal/swboot/ \
|
||||
./internal/workflowdef/ \
|
||||
./internal/workflow/ \
|
||||
./internal/projectworkflow/ \
|
||||
./internal/projectinstance/ \
|
||||
./internal/archtest/ \
|
||||
./internal/server/
|
||||
```
|
||||
|
||||
结果摘要(真实控制台):
|
||||
|
||||
```text
|
||||
ok chat-agent-system/internal/swboot 0.002s
|
||||
ok chat-agent-system/internal/workflowdef 0.003s
|
||||
? chat-agent-system/internal/workflow [no test files]
|
||||
ok chat-agent-system/internal/projectworkflow 0.003s
|
||||
ok chat-agent-system/internal/projectinstance 0.004s
|
||||
ok chat-agent-system/internal/archtest 0.143s
|
||||
ok chat-agent-system/internal/server 10.881s
|
||||
```
|
||||
|
||||
`go vet`:无输出(PASS)。
|
||||
|
||||
通过率:上述包 100%(workflow 无测试文件不计失败)。
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
- **结论**:SWBOOT-00..09 工程门禁(L1)达到合入候选标准;**未**达到完整验收清单完成定义(真实 PI / UI / PG 迁移活验仍为 NOT RUN)。
|
||||
- **未合 `dev`**:按要求仅推送 feature 分支。
|
||||
- **后续**:schema 48 在集成槽位对空库/旧库升级;七步 UI;对话路由与软件 profile;SWBOOT-10 真受控执行独立 Epic。
|
||||
@@ -0,0 +1,58 @@
|
||||
# Wave 1 PU3 IAM store fail-closed 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
`auth.NewStores` 在 pool/IAM 表未就绪时静默回退 MemoryStore。Wave 0 只读核验确认当前部署未触发,但代码旁路仍在。本波按 PU3 收口为仅 `dev|test` + `ALLOW_IN_MEMORY` 双门。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- main/prod/空 env/未知 env/缺 opt-in 时 fail-closed
|
||||
- 仅 dev/test + AllowInMemory 允许 MemoryStore
|
||||
- 相关 short 测试全绿;授权 happy path 不因测试夹具调整而破坏
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- 负例:`internal/auth/store_factory_test.go`
|
||||
- Assemble 负例:`TestAssemble_FailClosed_MainCannotUseMemoryIAM`
|
||||
- 回归:`go test -short ./internal/auth/ ./internal/app/ ./internal/bizdev/ ./internal/server/`
|
||||
- 测试夹具:`MustNewService` 在启用内存时默认 `Env=test`;严格鉴权用例启动后关闭 `AllowInMemory`
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- FailClosed 用例全部 error;dev/test opt-in 返回 MemoryStore
|
||||
- main + AllowInMemory 不得 Assemble 成功
|
||||
- short 包测试 PASS
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 用例 1:NewStores 负例与 opt-in
|
||||
|
||||
- **输入**:`go test -count=1 ./internal/auth/ -run TestNewStores_`
|
||||
- **输出**:`ok`
|
||||
- **判定**:PASS
|
||||
|
||||
### 用例 2:Assemble main fail-closed
|
||||
|
||||
- **输入**:`go test -short ./internal/server/ -run TestAssemble_FailClosed_MainCannotUseMemoryIAM`
|
||||
- **输出**:PASS
|
||||
- **判定**:PASS
|
||||
|
||||
### 用例 3:short 回归
|
||||
|
||||
- **输入**:`go test -short -count=1 ./internal/auth/ ./internal/app/ ./internal/bizdev/ ./internal/server/`
|
||||
- **输出**:四包均 `ok`(见 assets)
|
||||
- **判定**:PASS
|
||||
- **耗时**:~12s
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
| 命令 | 结果 |
|
||||
|------|------|
|
||||
| `go test -short -count=1 ./internal/auth/ ./internal/app/ ./internal/bizdev/ ./internal/server/` | PASS |
|
||||
|
||||
产物:`.doc/test-reports/assets/2026-09-16-wave1-iam-fail-closed/`
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
- MemoryStore 旁路已 fail-closed;IAM 行仍可 `partial`(全路由 inventory / session 中断负例未在本波做完)
|
||||
- 下一步:Wave 2 真实 PI 补证;可选继续 PU3 inventory
|
||||
@@ -0,0 +1,62 @@
|
||||
# Wave 1 PU5A TempDir race flake 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
全仓 `go test -race` 曾出现 `t.TempDir()` 清理时 `RemoveAll: directory not empty`,根因是 `taskrun.Manager` 异步 worker 在测试返回后仍写 `DataDir`。已知基建债,不挡首发;本波按 continuity 计划 PU5A 独立关闭。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- Worker 在 TempDir 删除前退出(`WaitIdle` / `WaitRunDone`)
|
||||
- `newTestServer` 与 `Server.Shutdown` 统一 drain
|
||||
- 多轮 `-race` 无 TempDir flake;不用 skip/ignore 假绿
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- OS: linux;Go race detector
|
||||
- 变更:`internal/taskrun/manager.go` Wait API;`server_test.go` cleanup;`server.go` Shutdown;幂等 SSE 用例显式 wait
|
||||
- 层级:单元(WaitIdle)+ server 包 race ×3(跳过真实 PI E2E)+ short race ×2(taskrun/server/auth)
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- `TestManager_WaitIdle_WaitsForWorker` PASS
|
||||
- `TestCreateTaskRun_PreActivationAcceptedNot409` / 幂等与 async 相关用例 race 下 PASS
|
||||
- 输出中无 `TempDir` / `RemoveAll` / `directory not empty` / `DATA RACE`
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 用例 1:WaitIdle 单元
|
||||
|
||||
- **测试输入 (Input)**:`go test -race -count=1 ./internal/taskrun/ -run TestManager_WaitIdle_WaitsForWorker -v`
|
||||
- **实际输出 (Actual Output)**:`--- PASS: TestManager_WaitIdle_WaitsForWorker (0.05s)`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:~1s 包级
|
||||
|
||||
### 用例 2:server 包 race ×3(排除真实 PI)
|
||||
|
||||
- **测试输入 (Input)**:`go test -race -count=3 ./internal/server/ -skip 'TestPiAgent_'`
|
||||
- **实际输出 (Actual Output)**:`ok chat-agent-system/internal/server 357.605s`(全文见 assets)
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(无 TempDir/DATA RACE 标记)
|
||||
- **性能与耗时 (Duration & Latency)**:~358s
|
||||
|
||||
### 用例 3:taskrun/server/auth short race ×2
|
||||
|
||||
- **测试输入 (Input)**:`go test -race -short -count=2 ./internal/taskrun/ ./internal/server/ ./internal/auth/`
|
||||
- **实际输出 (Actual Output)**:三包均 `ok`(见 assets)
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:~240s
|
||||
|
||||
备注:未 skip 的 `TestPiAgent_FullLifecycle_*` 在本机曾因真实 runner `typed result rejected` 失败,属外部 PI 路径,与 TempDir flake 无关;PR CI 默认不跑真实 PI。
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
| 命令 | 结果 |
|
||||
|------|------|
|
||||
| `go test -race -count=3 ./internal/server/ -skip 'TestPiAgent_'` | PASS |
|
||||
| `go test -race -short -count=2 ./internal/taskrun/ ./internal/server/ ./internal/auth/` | PASS |
|
||||
|
||||
产物:`.doc/test-reports/assets/2026-09-16-wave1-race-tempdir-cleanup/`
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
- PU5A TempDir race flake **关闭**(server/taskrun/auth 多轮 race 无该签名)
|
||||
- 下一步:Wave 1 PU3 IAM fail-closed;PU5B 夜间 PI / receipt 另立
|
||||
@@ -0,0 +1,94 @@
|
||||
# Wave 2 PU4 真实 PI 补证(U8 + full/none)测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
Wave 0 校准后,FEATURE-MATRIX 将 multi-intent U8 与工作流 full/none 标为证据缺口:U8 仅有 adapter 单测与 `TestTaskGenerateRealPIStopGate` 假 SKIP;full/none 仅有设置页矩阵,缺少真实 PI 长链。本轮在隔离 PG + 共享 `data/dev/workspaces` + 产品 PI Runner(MiniMax-M2.7-highspeed)上补证,不升 `MULTI_INTENT_PLAN_TIER`。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- U8:确认前零副作用 → 确认后真实 PI generate → 幂等重放 → 撤权 → PG 重启恢复 → HTTP 刷新 GET
|
||||
- full:intake 真实 PI + 跨用户 author/reviewer/approver
|
||||
- none:research 真实 PI + submit-review 403 + 阶段就绪不阻塞 + 推进 + settings 刷新
|
||||
- 发现的产品缺陷就地修复并回归;不得用 stub/SKIP 冒充 PASS
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
| 项 | 值 |
|
||||
|----|-----|
|
||||
| OS | Linux 7.0.0-31-generic |
|
||||
| Go | `go test`(非 `-short`) |
|
||||
| 隔离 PG | `127.0.0.1:5434/agent_wave2_pi`(schema 47) |
|
||||
| Runner | `http://127.0.0.1:18865`,model `MiniMax-M2.7-highspeed` |
|
||||
| DATA_DIR | `data/dev`(与容器 workspaces 绑定) |
|
||||
| 分支 | `feature/wave2-real-pi-evidence` |
|
||||
| 用例 | `TestMultiIntentU8_RealPI_ConfirmGenerate_PG`;`TestWorkflowGovernance_PiAgent_PG_FullNoneMixedChain` |
|
||||
| 证据 | `.doc/test-reports/assets/2026-09-16-wave2-real-pi-evidence/` |
|
||||
|
||||
本轮顺带修复:
|
||||
|
||||
1. `intent_plan_steps.depends_on` / `intent_plan_decisions.step_ids` 空切片落 NULL → `textArrayOrEmpty`
|
||||
2. `taskrun.completed` 终态事件消费者误写 `projection/fav` → 改为登记的 `notify`
|
||||
3. `intent.plan.step_changed` 与 plan 级事件共享 `(aggregate_type,id,version)` 冲突 → step 使用 `intent_plan_step` 聚合;`AdvanceEligible` 全失败时不再吞错
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- U8:`starts=0` 直至 Advance;PI `completed`;重放 starts=1;Denied 后 forbidden;重启后 task.run=`succeeded`;HTTP GET 200
|
||||
- full/none:intake 审批通过并推进 V0.1;research 生成成功且 submit 403;readiness Ready;推进 V0.5;settings 可读
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 用例 1:U8 真实 PI confirm generate
|
||||
|
||||
- **测试输入 (Input)**:`TEST_DATABASE_URL=…/agent_wave2_pi` + runner token;`go test ./internal/server -run TestMultiIntentU8_RealPI_ConfirmGenerate_PG`
|
||||
- **实际输出 (Actual Output)**(摘自 `assets/2026-09-16-wave2-real-pi-evidence/u8-go-test.txt`):
|
||||
|
||||
```text
|
||||
✓ [1. awaiting] plan_id=pln_79d640abce7c0f2ecf8c3726d28206a9 revision=1 starts=0
|
||||
taskrun_status_transition run_id=run_1789554232489934117 status=completed
|
||||
✓ [2. real PI generate] … status=completed elapsed=3m11s
|
||||
✓ [3. idempotent replay] starts still 1
|
||||
✓ [4. revoke] TaskRunAdapter denied
|
||||
✓ [5. PG restart recovery] … status=executing
|
||||
✓ [6. HTTP refresh] GET plan 486 bytes
|
||||
--- PASS: TestMultiIntentU8_RealPI_ConfirmGenerate_PG (191.34s)
|
||||
```
|
||||
|
||||
- **评价判定 (Evaluation / Verdict)**:**PASS**
|
||||
- **性能与耗时 (Duration & Latency)**:约 191s(含一次 intake PI)
|
||||
- **说明**:浏览器双标签 Playwright 仍为 gated stub(`web/e2e/intent-plan-cards.spec.ts`);本轮签署的是 API 层刷新/重登 GET + Plans 重绑模拟 app restart,不宣称 UI 双标签已绿。
|
||||
|
||||
### 用例 2:full/none 混合真实 PI 长链
|
||||
|
||||
- **测试输入 (Input)**:同环境;`TestWorkflowGovernance_PiAgent_PG_FullNoneMixedChain`(intake=full,research=none,其余文档关闭)
|
||||
- **实际输出 (Actual Output)**(摘自 `assets/…/fullnone-go-test.txt`):
|
||||
|
||||
```text
|
||||
✓ [1. activate] instance=6 full=intake none=research
|
||||
✓ pi-agent intake … elapsed=3m17s
|
||||
✓ [2. full intake] cross-user approve complete
|
||||
✓ [3. advance V0.1] ok
|
||||
✓ pi-agent research … elapsed=10m22s
|
||||
✓ [4. none research] generate ok; submit-review denied HTTP 403
|
||||
✓ [5. readiness] none does not block
|
||||
✓ [6. advance V0.5] none non-blocking PASS
|
||||
✓ [7. refresh] settings still readable
|
||||
--- PASS: TestWorkflowGovernance_PiAgent_PG_FullNoneMixedChain (818.64s)
|
||||
```
|
||||
|
||||
- **评价判定 (Evaluation / Verdict)**:**PASS**
|
||||
- **性能与耗时 (Duration & Latency)**:约 818s(两次真实 PI)
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
```text
|
||||
go test -short ./internal/app/intentflow ./internal/app ./internal/taskrun → PASS
|
||||
go vet ./internal/app/intentflow ./internal/app ./internal/taskrun ./internal/server → PASS
|
||||
go test ./internal/server -run TestMultiIntentU8_RealPI_ConfirmGenerate_PG → PASS (191s)
|
||||
go test ./internal/server -run TestWorkflowGovernance_PiAgent_PG_FullNoneMixedChain → PASS (819s)
|
||||
```
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
- PU4 证据缺口可关闭:U8 真实 PI + full/none 混合长链均 PASS;默认 `MULTI_INTENT_PLAN_TIER=legacy` **不升**。
|
||||
- 建议:将 `intent-plan-cards` Playwright 双标签纳入独立 short-term;CI 夜间 `RUN_PI_E2E=1` 跑本两用例;合入 `dev` 前占槽 smoke。
|
||||
- 产品修复(nil 数组、taskrun 终态消费者、step 事件聚合)随本分支合入。
|
||||
@@ -0,0 +1,117 @@
|
||||
# Wave 2B PU5B:Nightly Real PI + Promotion Receipt 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
Wave 2(PU4)已合入 `dev` 并补齐 U8 / full-none 真实 PI 证据。发布加固缺口仍在:PR CI 不跑真实 PI;晋升入口缺少不可变 receipt;基础设施失败易被误记为 PASS。本轮落地夜间入口、receipt 写/校验(含 timed waiver)与 `promote-to-test` / `release-to-main` 门禁钩子。**不**声称 same-image digest 晋升已完成。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 缺 secret / runner 不可达 → `infra_fail` receipt,job/脚本非零退出(禁止写成 PASS)
|
||||
- 产品断言失败 → `product_fail`,晋升拒绝
|
||||
- PASS → 落盘 receipt;无 receipt / 过期 waiver → `promotion-receipt-check` 非零退出
|
||||
- workflow `concurrency` cancel-in-progress;PR `ci.yml` 仍不跑真实 PI
|
||||
- Artifact 矩阵行保持 **partial**(same-commit + digest 可追溯)
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
| 项 | 值 |
|
||||
|----|-----|
|
||||
| OS | Linux 7.0.0-31-generic |
|
||||
| 分支 | `feature/wave2b-nightly-promotion-receipt` |
|
||||
| Runner | `http://127.0.0.1:18865`(MiniMax-M2.7-highspeed) |
|
||||
| 隔离 PG | `127.0.0.1:5434/agent_wave2_pi` |
|
||||
| 脚本 | `scripts/run-nightly-real-pi.sh`、`promotion-receipt-{write,check}.sh`、`promote-to-test.sh`、`release-to-main.sh` |
|
||||
| Workflow | `.github/workflows/nightly-real-pi.yml`(schedule + workflow_dispatch) |
|
||||
| Receipt 目录 | `.doc/test-reports/assets/promotion-receipts/` |
|
||||
|
||||
用例矩阵:
|
||||
|
||||
| ID | 场景 | 期望 |
|
||||
|----|------|------|
|
||||
| N1 | `--dry-infra-fail` / 缺 secret | `verdict=infra_fail`,exit 1 |
|
||||
| N2 | fixture PASS commit | check OK |
|
||||
| N3 | fixture product_fail | check BLOCKED |
|
||||
| N4 | fixture infra_fail 无 waiver | check BLOCKED |
|
||||
| N5 | infra_fail + 有效 waiver 绑定 PASS | check OK |
|
||||
| N6 | 无 receipt commit | check BLOCKED |
|
||||
| N7 | 本机真实 suite(可选墙钟) | pass / product_fail / infra_fail 分类落盘 |
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- Receipt 最小字段:`verdict`、`commit`、`recorded_at`、`runner_url`、`model_id`、`protocol`、`image_digests`、`suite`、`failure_class`、`evidence_refs`
|
||||
- Waiver:`owner`、`reason`、`expires_at`、`binds_receipt`(须指向 PASS)
|
||||
- `git-workflow-helper promote-to-test` 校验 **dev HEAD**;`release-to-main` 校验 **test HEAD**
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### N1 — infra 负例(本机 dry)
|
||||
|
||||
- **测试输入 (Input)**:`./scripts/run-nightly-real-pi.sh --dry-infra-fail`
|
||||
- **实际输出 (Actual Output)**:
|
||||
|
||||
```text
|
||||
==> nightly real-PI suite commit=82780222373d runner=http://127.0.0.1:18865
|
||||
forced infra failure (--dry-infra-fail)
|
||||
wrote promotion receipt: .../82780222373de1ded853e3fe5a8f2208133bc7c7.json
|
||||
wrote infra_fail receipt (dry)
|
||||
```
|
||||
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(`verdict=infra_fail`,exit 1;非绿)
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
对应 receipt 摘录见 assets;晋升门禁对该 commit:
|
||||
|
||||
```text
|
||||
promotion-receipt-check: BLOCKED — infra_fail receipt freezes promotion (...); provide timed waiver or re-run nightly
|
||||
```
|
||||
|
||||
### N2–N6 — fixture 门禁
|
||||
|
||||
| 用例 | commit fixture | 实际 | 判定 |
|
||||
|------|----------------|------|------|
|
||||
| N2 PASS | `aaaa…` | `OK — PASS receipt` | PASS |
|
||||
| N3 product | `cccc…` | `BLOCKED — product_fail` | PASS |
|
||||
| N4 infra | `dddd…` | `BLOCKED — infra_fail … freeze` | PASS |
|
||||
| N5 waiver | `dddd…` + waiver→`eeee…` PASS | `OK — audited waiver … until 2099-01-01` | PASS |
|
||||
| N6 missing | `bbbb…` | `BLOCKED — missing promotion receipt` | PASS |
|
||||
|
||||
### N7 — 本机真实 suite(合入后墙钟跑)
|
||||
|
||||
- **测试输入**:`TEST_DATABASE_URL=…/agent_wave2_pi` + `RUNNER_AUTH_TOKEN` + `./scripts/run-nightly-real-pi.sh`(commit `67d73359fd13`)
|
||||
- **实际输出 (Actual Output)**(摘录):
|
||||
|
||||
```text
|
||||
=== RUN TestMultiIntentU8_RealPI_ConfirmGenerate_PG
|
||||
... PI run status=quality_failed want completed
|
||||
--- FAIL: TestMultiIntentU8_RealPI_ConfirmGenerate_PG (352.98s)
|
||||
=== RUN TestWorkflowGovernance_PiAgent_PG_FullNoneMixedChain
|
||||
✓ [1. activate] ... ✓ [2. full intake] ... ✓ [3. advance V0.1] ok
|
||||
```
|
||||
|
||||
- **评价判定 (Evaluation / Verdict)**:U8 段已出现**产品侧** `quality_failed`(非 secret/runner 不可达)。整包结束后脚本应落 `product_fail` receipt 并 `exit 1`——符合「产品失败拒绝晋升、不得写成 PASS」;full/none 段仍继续跑作对照。控制台:`assets/2026-09-16-wave2b-nightly-promotion-receipt/nightly-console.txt`
|
||||
- **性能与耗时**:U8 FAIL ≈ 353s;full/none 长链另行计时
|
||||
- **合入冒烟**:`go vet` PASS;洁净环境 `go test -short ./...` PASS;`/health` schema 47 ok
|
||||
- **最终 receipt**:`.doc/test-reports/assets/promotion-receipts/67d73359fd137422b19c0096be5aaea044c4ca16.json` → `verdict=product_fail`,`failure_class=product`,含 app/events/pi-agent ImageID;`promotion-receipt-check` 对该 commit **BLOCKED**(符合门禁)
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
合入冒烟(清污染环境变量):
|
||||
|
||||
```bash
|
||||
unset AGENT_TIMEOUT KB_DATABASE_URL KB_EMBEDDING_DIM
|
||||
go vet ./...
|
||||
go test -short ./...
|
||||
```
|
||||
|
||||
PR CI 不变;新增 nightly workflow 不进入 PR 路径。
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
- **结论**:Wave 2B 脚本门禁与 nightly 入口已交付;infra/product 分类与 waiver 链可审计;晋升钩子在无 PASS receipt 时非零退出。
|
||||
- **明确未完成**:compose 按 digest pull 的 **same-image** 晋升流水线仍未做 → FEATURE-MATRIX「Artifact 同 digest 晋升」保持 **partial**。
|
||||
- **后续**:配置 Actions `RUNNER_AUTH_TOKEN` + `NIGHTLY_TEST_DATABASE_URL`(或自托管 runner);Wave 3 候选(Playwright 双标签 / tier)。
|
||||
|
||||
## 证据路径
|
||||
|
||||
- Receipts / fixtures:`.doc/test-reports/assets/promotion-receipts/`
|
||||
- Short-term:`.doc/ops/short-term/2026-09-16-wave2b-nightly-promotion-receipt.md`
|
||||
@@ -0,0 +1,69 @@
|
||||
# Wave 2C:同 digest 镜像晋升测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
Wave 2B 已交付 nightly + promotion receipt,但 test/main 仍可能 `docker compose up --build` 另造镜像。本轮收口 PU5B:候选 commit 一次构建(或等价 retag)、receipt 携带 digests、晋升 apply + pinned `--no-build`。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- PASS receipt 含非空 `image_digests`(app/events/pi-agent)
|
||||
- `candidate-images-apply test` 后三服务 ImageID 与 receipt 一致
|
||||
- `--require-digests` 在缺 digest 时拒绝晋升
|
||||
- pinned 模式下 `env-service` 使用 `--no-build`
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
| 项 | 值 |
|
||||
|----|-----|
|
||||
| 分支 | `feature/wave2c-same-image-digest` |
|
||||
| 基线 commit | `7c808bdcfced…`(fixture 源) |
|
||||
| 脚本 | `candidate-images-{build,apply}.sh`、`promotion-receipt-{write,check}.sh`、`env-service.sh` |
|
||||
| Compose | `docker-compose.test.yml` / `main.yml` 支持 `APP_IMAGE` 等 |
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- app/events 共用同一 candidate ID;pi-agent 独立 ID
|
||||
- apply 后 `shuimu-*-:test` ID 与 receipt 一致
|
||||
- 空 digests 的 PASS → check BLOCKED
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### C1 — require-digests PASS
|
||||
|
||||
- **Input**:images.json + `promotion-receipt-write --verdict pass` + `check --require-digests`
|
||||
- **Actual**:`OK — PASS receipt for 7c808bdcfced`
|
||||
- **Verdict**:PASS
|
||||
|
||||
### C2 — apply test ID 一致
|
||||
|
||||
- **Input**:`./scripts/candidate-images-apply.sh test --commit 7c808bd…`
|
||||
- **Actual**:
|
||||
|
||||
```text
|
||||
tagged shuimu-agent-app:test -> sha256:44c114af…
|
||||
tagged shuimu-agent-events:test -> sha256:44c114af… (same as app)
|
||||
tagged shuimu-pi-agent:test -> sha256:b8f9b525…
|
||||
app PASS / events PASS / pi-agent PASS
|
||||
```
|
||||
|
||||
- **Verdict**:PASS
|
||||
|
||||
### C3 — 缺 digests 负例
|
||||
|
||||
- **Input**:fixture `ffff…` PASS 且 digests 全 null + `--require-digests`
|
||||
- **Actual**:`BLOCKED — PASS receipt missing image_digests … app, events, pi-agent`
|
||||
- **Verdict**:PASS
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
合入冒烟(洁净环境):`go vet ./...`;`go test -short ./...`。
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
- **结论**:单机 same-image digest pin + 晋升钩子已交付;FEATURE-MATRIX Artifact 可标 `done`(注明无远程 registry)。
|
||||
- **后续**:Phase 2 Wave3 go/no-go;Phase 3 N7 U8 / Playwright 等遗留。
|
||||
|
||||
## 证据
|
||||
|
||||
- `.doc/test-reports/assets/promotion-receipts/7c808bd….json` + `.images.json`
|
||||
- `configs/.env.test.images`(本地 pin,gitignore)
|
||||
@@ -0,0 +1,89 @@
|
||||
# KB 宿主机分层加载与静默离线门禁 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
试运行/E2E 日志出现 `password authentication failed for user "regkb"`,DSN 口令为错误默认值 `shared_kb_secret_pass`,客户端静默降级为离线,材料/法规路径被误判为“通过但无 KB”。根因是 `config.Load("")` 只读 `configs/.env.dev`,未叠加根 `.env` 的真实 `KB_DB_PASSWORD`。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 分层 Load 后口令来自根 `.env`,不再使用代码内弱默认口令
|
||||
- 宿主机将 Compose DNS 归一化为 `127.0.0.1:5432`
|
||||
- 日志脱敏;E2E/nightly 默认 `KB_REQUIRE_ONLINE` fail-closed
|
||||
- `KB_ALLOW_OFFLINE=1` 时允许显式降级并打印 NOTE
|
||||
- `/health` 暴露 `kb_ready`(不改变 `status=ok` 既有语义)
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- OS: Linux;Go: 仓库工具链;共享 KB: `127.0.0.1:5432`
|
||||
- 层级:`go test -short ./internal/config ./internal/kb`;可选 `CHECK_LIVE_KB_ENV=1` 布尔校验工作区根 `.env`
|
||||
- 不使用 stub 作为最终配置契约验收
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
| 用例 | 预期 |
|
||||
|------|------|
|
||||
| 默认 Load(`/dev/null`) | `KbDbPassword==""`,`RequireKbPassword` 失败 |
|
||||
| 临时目录分层 `.env` + `configs/.env.dev` | 口令=根文件值;宿主机 host=`127.0.0.1` |
|
||||
| 错口令 `shared_kb_secret_pass` + `KB_ALLOW_OFFLINE=1` | `Online()==false`,无 Fatal |
|
||||
| RedactPostgresDSN | 日志串不含明文口令 |
|
||||
| Live `CHECK_LIVE_KB_ENV=1` | `password_set=true`,host 为 `127.0.0.1` 或 compose 名 |
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 用例 A:短测回归
|
||||
|
||||
- **测试输入**: `go test -short -count=1 ./internal/config ./internal/kb`
|
||||
- **实际输出**:
|
||||
```text
|
||||
ok chat-agent-system/internal/config
|
||||
ok chat-agent-system/internal/kb
|
||||
```
|
||||
- **评价判定**: PASS
|
||||
- **性能与耗时**: <1s
|
||||
|
||||
### 用例 B:分层与脱敏单测
|
||||
|
||||
- **测试输入**: `-run 'TestConfigLayered|TestConfigDefault|TestNormalize|TestRedact|TestConfigLoadDSN'`
|
||||
- **实际输出**: 全部 PASS(含 `TestConfigLayeredLoadMergesRootPassword`)
|
||||
- **评价判定**: PASS
|
||||
|
||||
### 用例 C:工作区 live 布尔校验(不打印口令)
|
||||
|
||||
- **测试输入**: `CHECK_LIVE_KB_ENV=1 go test ./internal/config -run TestLiveLayeredLoadHasNonDefaultPassword -v`
|
||||
- **实际输出**:
|
||||
```text
|
||||
live kb host=127.0.0.1 port=5432 password_set=true
|
||||
--- PASS: TestLiveLayeredLoadHasNonDefaultPassword
|
||||
```
|
||||
- **评价判定**: PASS(确认不再是 `shared_kb_secret_pass` / 空口令)
|
||||
|
||||
### 用例 D:错口令显式离线
|
||||
|
||||
- **测试输入**: `TestNewClientWrongPasswordStaysOffline`(`KB_ALLOW_OFFLINE=1`)
|
||||
- **实际输出**: `Online()==false`;包测试 PASS
|
||||
- **评价判定**: PASS(降级用例,非产品冒充在线)
|
||||
|
||||
### 用例 E:dev 容器 rebuild 冒烟
|
||||
|
||||
- **测试输入**: `./scripts/env-service.sh dev rebuild`;`curl -sf http://127.0.0.1:8080/health`
|
||||
- **实际输出**:
|
||||
```text
|
||||
{"status":"ok", ..., "kb_ready":true, "shared_kb_port":5432, "database_ready":true, ...}
|
||||
[kb] online=true dsn=postgres://regkb:***@shuimu-kb-shared:5432/regulations?sslmode=disable
|
||||
shared_kb_secret_pass 出现次数: 0
|
||||
```
|
||||
- **评价判定**: PASS
|
||||
- **性能与耗时**: rebuild ~14s;health 立即可用
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
```text
|
||||
go test -short ./internal/config ./internal/kb ./internal/server
|
||||
ok chat-agent-system/internal/config
|
||||
ok chat-agent-system/internal/kb
|
||||
ok chat-agent-system/internal/server
|
||||
```
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
达到合并标准:配置 SSOT 与 Compose 分层对齐;E2E/nightly 预检 + `EnsureOnline` 避免静默离线冒充 PASS;容器内 `kb_ready=true` 且 DSN 已脱敏。后续可在试运行巡检中把 `kb_ready` 纳入 dashboard,但不必改 `/health` 的 HTTP 200 语义。
|
||||
@@ -0,0 +1,86 @@
|
||||
# leftover 旁支二次收口 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
本地 `dev@80ef2f6` 上仍挂着 tip 已是祖先的 extra worktree 与旁支;SWBOOT long-term 仍误写「未合 `dev`」;PU6/PU8 契约仍停在脚手架口径。冻结 5 条旁支禁止整支 merge。本轮只做清理 + 文档对齐 + 冒烟。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 拆掉已合入 leftover worktree;保留错名 FAV worktree。
|
||||
- 删除 tip 已是 `dev` 祖先的本地旁支;丢弃 SWBOOT 残留关闭 commit(内容已在 `dev`)。
|
||||
- `fix/clean-test-env-baseline` 不合入。
|
||||
- 文档与 git 事实对齐。
|
||||
- 冒烟:`go vet`、`go test -short`、`arch-check --mode block`、`:8080` `/health` 与 `/ready`。
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- OS:Linux 7.0.0-31-generic
|
||||
- Go:go1.27.1 linux/amd64
|
||||
- 分支:`chore/leftover-hygiene-2026-09-17`(自 `dev@80ef2f6`)
|
||||
- 容器:现网 dev,docs-only 不 rebuild
|
||||
- 证据:`.doc/test-reports/assets/2026-09-17-leftover-hygiene/`
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- extra worktree 只剩 `.worktrees/fix-dev-runtime-data-root-guard`(`feature/final-artifact-vault`)
|
||||
- 冻结 5 条旁支仍在;`fix/clean-test-env-baseline` 仍在且未 merge
|
||||
- vet / short / arch-check / health+ready PASS
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 worktree 与旁支
|
||||
|
||||
- **测试输入 (Input)**:`git worktree remove --force`;Playwright 目录 root 属主经 Docker `chown` 后 `rm -rf`;`git branch -d` 已合入旁支;SWBOOT `-D`
|
||||
- **实际输出 (Actual Output)**:见 `assets/2026-09-17-leftover-hygiene/post-worktrees.txt`、`deleted-local-branches.txt`、`post-unmerged.txt`。extra worktree 仅余 FAV 错名目录。
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:约 1 分钟(含 root 属主清理)
|
||||
|
||||
### 5.2 故意保留
|
||||
|
||||
- **测试输入 (Input)**:`git branch --no-merged HEAD`
|
||||
- **实际输出 (Actual Output)**:`dev-old-linear`、`feature/final-artifact-vault`、`feature/remove-herdr-agent-settings`、`fix/clean-test-env-baseline`、`fix/dev-runtime-data-root-guard`、`fix/project143-controlled-content-404-diagnosis`、`test`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(`test` 为环境主干;clean-test 放弃不合入)
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
### 5.3 go vet
|
||||
|
||||
- **测试输入 (Input)**:`go vet ./...`
|
||||
- **实际输出 (Actual Output)**:exit 0。`assets/2026-09-17-leftover-hygiene/go-vet.txt`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:约 1s
|
||||
|
||||
### 5.4 go test -short
|
||||
|
||||
- **测试输入 (Input)**:`unset TEST_DATABASE_URL; go test -short ./...`
|
||||
- **实际输出 (Actual Output)**:全仓 `ok` / `[no test files]`,`TEST_EXIT=0`。最慢 `internal/server` 10.729s。`assets/2026-09-17-leftover-hygiene/go-test-short.txt`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:约 12s
|
||||
|
||||
### 5.5 arch-check --mode block
|
||||
|
||||
- **测试输入 (Input)**:`./scripts/arch-check.sh --mode block`
|
||||
- **实际输出 (Actual Output)**:`arch-check block: production gate passed`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:约 1s
|
||||
|
||||
### 5.6 health / ready
|
||||
|
||||
- **测试输入 (Input)**:`curl -sf http://127.0.0.1:8080/health` 与 `/ready`
|
||||
- **实际输出 (Actual Output)**:
|
||||
|
||||
```json
|
||||
{"status":"ok","env":"dev","agent_backend":"pi-agent","version":"v1.0","shared_kb_port":5432,"kb_ready":true,"database_ready":true,"schema_version":48,"schema_ready":true,"task_store_ready":true}
|
||||
```
|
||||
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(dev schema 48;test/main 仍 47)
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
- `go vet ./...`:PASS
|
||||
- `go test -short ./...`:PASS
|
||||
- `./scripts/arch-check.sh --mode block`:PASS
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
达到合入标准。后续 W2–W7 按独立 feature 分支推进。不 push、不删 `origin/*`、不整支 merge FAV。
|
||||
@@ -0,0 +1,94 @@
|
||||
# W1 CI/E2E FullNone + green nightly 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
FEATURE-MATRIX「CI / E2E」仍为 `partial`。nightly run#30 曾 U8 PASS / FullNone `product_fail`。本波复现时发现更严重的门禁阻塞:重复 goose `00048` 使所有 `TEST_DATABASE_URL` PG 套件在 CollectMigrations 时 panic。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 解除 duplicate goose 00048 阻塞
|
||||
- FullNone 真实 PI 稳定绿
|
||||
- nightly U8+FullNone 套件写出 `verdict=pass` receipt
|
||||
- FEATURE-MATRIX CI/E2E → `done`
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- OS: Linux;Go 1.27;分支 `feature/w1-ci-e2e-green-nightly`
|
||||
- PI: `127.0.0.1:18865` MiniMax-M2.7-highspeed;typed-result-v1
|
||||
- PG: `127.0.0.1:5434/agent_wave2_pi`;`DATA_DIR=data/dev`
|
||||
- KB: 宿主机改写 `shuimu-kb-shared` → `127.0.0.1`,并从根 `.env` 加载真实 `KB_DB_PASSWORD`
|
||||
- 层级:迁移冒烟 → FullNone 单测 → `./scripts/run-nightly-real-pi.sh` 全套件
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- goose CollectMigrations 无 panic;schema 可达 48(bootstrap-fields)
|
||||
- FullNone:intake=full / research=none 全链路 PASS
|
||||
- nightly receipt `verdict=pass`、`failure_class=none`、suite=`nightly-real-pi-u8-fullnone`
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 重复 goose 00048
|
||||
|
||||
- **测试输入**: `go test ./internal/server -run FullNone`(修复前)
|
||||
- **实际输出**: `goose: duplicate version 48 detected`(`software-project-type.sql` 与 `software-project-bootstrap-fields.sql`)
|
||||
- **评价判定**: PASS(已删除过时 `software-project-type.sql`;wave2_pi 清理双 48 标记后迁移成功)
|
||||
- **耗时**: <1s panic → 修复后迁移 ~31ms
|
||||
|
||||
### 5.2 FullNone 本地(修复后)
|
||||
|
||||
- **测试输入**: `RUN_PI_E2E=1` + 隔离 PG + 真实 PI;attempt4
|
||||
- **实际输出**(摘要):
|
||||
|
||||
```
|
||||
✓ [1. activate] instance=30
|
||||
✓ pi-agent intake … elapsed=3m9s
|
||||
✓ [2. full intake] cross-user approve complete
|
||||
✓ [3. advance V0.1] ok
|
||||
✓ pi-agent research … elapsed=13m38s
|
||||
✓ [4. none research] submit-review denied HTTP 403
|
||||
✓ [5. readiness] none does not block
|
||||
✓ [6. advance V0.5] none non-blocking PASS
|
||||
✓ [7. refresh] settings still readable
|
||||
--- PASS: TestWorkflowGovernance_PiAgent_PG_FullNoneMixedChain (1008.70s)
|
||||
```
|
||||
|
||||
- **评价判定**: PASS
|
||||
- **耗时**: 1008.70s
|
||||
- **证据**: `assets/2026-09-17-w1-ci-e2e-green-nightly/fullnone-attempt4.txt`
|
||||
|
||||
### 5.3 Nightly 全套件
|
||||
|
||||
- **测试输入**: `./scripts/run-nightly-real-pi.sh`(U8 \| FullNone)
|
||||
- **实际输出**:
|
||||
|
||||
```
|
||||
--- PASS: TestMultiIntentU8_RealPI_ConfirmGenerate_PG (251.73s)
|
||||
--- PASS: TestWorkflowGovernance_PiAgent_PG_FullNoneMixedChain (1452.38s)
|
||||
nightly real-PI PASS; receipt written for 6e2476f0f2e4
|
||||
```
|
||||
|
||||
- **评价判定**: PASS(`verdict=pass`)
|
||||
- **耗时**: ~1704s 套件墙钟
|
||||
- **Receipt**: [`.doc/test-reports/assets/promotion-receipts/6e2476f0f2e408e111fe06ca7c31a38294a340b3.json`](../assets/promotion-receipts/6e2476f0f2e408e111fe06ca7c31a38294a340b3.json)
|
||||
- **Gitea workflow_dispatch**: API 可达(workflows 列表含 `nightly-real-pi.yml`);本提交尚未推远端,验收以本地真实 PI receipt 为准(避免在旧 `dev` 上误跑)
|
||||
|
||||
### 5.4 关键修复清单
|
||||
|
||||
| 修复 | 说明 |
|
||||
|------|------|
|
||||
| 删除重复 `00048` type 迁移 | 解除 CollectMigrations panic |
|
||||
| HTTP client 75m > AgentTimeout 60m | 避免 client 先于 PI 超时 |
|
||||
| KB host/password 宿主机矫正 | 避免离线模式加剧 research 质量失败 |
|
||||
| organizer 不再硬要求 `fields.json` | 消除 MISSING_TARGET 误杀 |
|
||||
| nightly 重试含 deadline/MISSING_TARGET | 降低偶发 flake |
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
- `go vet ./...`:PASS(docs merge 冒烟)
|
||||
- `go test -short ./internal/squad`:PASS(fields.json 软目标后)
|
||||
- FullNone + nightly:见 §5(真实 PI,非 stub)
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
- **结论**: W1 关闭条件达成;建议 FEATURE-MATRIX「CI / E2E」升 `done`。
|
||||
- **后续**: 合入 `dev` 后可 `workflow_dispatch` 远端 nightly 作二次确认;建议 `configs/.env.dev` 补齐 `KB_DB_PASSWORD` 指向说明,避免再回落默认口令。
|
||||
@@ -0,0 +1,74 @@
|
||||
# W2 语义摘要 shadow 真实 PI 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
PU6 脚手架已合 `dev`:`SEMANTIC_SUMMARY_SHADOW` 默认 off,summarizer 为 heuristic/stub,REPLACE 未接线。W2 关闭条件要求产品 PI Agent Runner + MiniMax、R13 最小出站、负例,且不启用 REPLACE。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 组合根在 flag on + `pi-agent` 时注入 `PiSemanticSummarizer`(no-tool)
|
||||
- 真实 MiniMax 产出 shadow narrative;served deterministic 不被替换
|
||||
- injection/撤权材料不把秘密写入 shadow
|
||||
- 仓库默认 `SEMANTIC_SUMMARY_SHADOW=false`、`SEMANTIC_SUMMARY_REPLACE=false`
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- OS:Linux;Go:go1.27.1
|
||||
- 分支:`feature/w2-semantic-summary-shadow-live`
|
||||
- Runner:`http://127.0.0.1:18865`,model `MiniMax-M2.7-highspeed`,typed-result-v1
|
||||
- DATA_DIR:`data/dev`(与容器 `workspaces` 绑定)
|
||||
- 层级:单测 + 真实 PI(非 `-short`);Playwright digest UI **NOT RUN**(本波无独立 digest 页面门)
|
||||
- 证据:`.doc/test-reports/assets/2026-09-17-w2-semantic-summary-shadow/`
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- flag off:无 shadow(既有 ctxmgr 单测)
|
||||
- stub/recording:instructions 含 zero tool;input.json 仅 id/role/content
|
||||
- live:`shadow` 叙事非空;不含 injection 秘密「预算200万」;REPLACE 未接线
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 单测(flag / no-tool / fallback)
|
||||
|
||||
- **测试输入 (Input)**:`go test -short ./internal/app ./internal/ctxmgr ./internal/app/chatflow`
|
||||
- **实际输出 (Actual Output)**:`ok` 全绿
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
### 5.2 真实 PI MiniMax
|
||||
|
||||
- **测试输入 (Input)**:`RUN_PI_E2E=1 go test ./internal/app -run TestPiSemanticSummarizer_LiveMiniMax -v`
|
||||
- **实际输出 (Actual Output)**:
|
||||
|
||||
```text
|
||||
=== RUN TestPiSemanticSummarizer_LiveMiniMax
|
||||
semantic_summarizer_test.go:152: model=MiniMax-M2.7-highspeed protocol=semantic-summary-v1 elapsed=7.779s narrative="# 授权对话摘要\n\n用户就高频超声手术刀系统的研发立项事宜寻求建议。助手回复指出,该项目需重点关注电气安全要求及产品型检周期等关键事项。"
|
||||
--- PASS: TestPiSemanticSummarizer_LiveMiniMax (7.78s)
|
||||
```
|
||||
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(未出现「200万」;`tool_permissions=none` 由 input.json + instructions 约束)
|
||||
- **性能与耗时 (Duration & Latency)**:7.78s
|
||||
|
||||
### 5.3 Playwright digest UI
|
||||
|
||||
- **测试输入 (Input)**:无独立 digest 页面门
|
||||
- **实际输出 (Actual Output)**:NOT RUN
|
||||
- **评价判定 (Evaluation / Verdict)**:不挡 W2 done(关闭条件为真实 PI + R13 + 负例,不依赖 REPLACE/UI 替换)
|
||||
- **性能与耗时 (Duration & Latency)**:—
|
||||
|
||||
### 5.4 arch-check / health
|
||||
|
||||
- **测试输入 (Input)**:`./scripts/arch-check.sh --mode block`;`curl -sf :8080/health`
|
||||
- **实际输出 (Actual Output)**:`production gate passed`;health `schema_version=48` `agent_backend=pi-agent`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
- `go test -short ./internal/app ./internal/ctxmgr ./internal/app/chatflow`:PASS
|
||||
- `go test ./internal/app -run TestPiSemanticSummarizer_LiveMiniMax`:PASS(真实 MiniMax)
|
||||
- `./scripts/arch-check.sh --mode block`:PASS
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
W2 达到矩阵「语义摘要(D3)」done。`SEMANTIC_SUMMARY_REPLACE` 保持未接线、默认 false。后续可选 REPLACE 灰度须另开授权。
|
||||
@@ -0,0 +1,84 @@
|
||||
# W3 PI change-report 叙事真实 PI 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
PU7 脚手架已合 `dev`:`PI_CHANGE_REPORT_NARRATIVE` 默认 off,flag on 时仍可能只走确定性 fallback。W3 要求质量修复路径真正向产品 PI Agent Runner 要 `change_report_narrative_v1`,digest 绑定,畸形/超时全量 fallback,UI 区分叙事与服务端事实字段。禁止把 fallback 写成完整 PI。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- flag on + 空 `ReportJSON` 时 `CreateAgentCandidate` 调用 no-tool PI narrator
|
||||
- 真实 MiniMax 回写 schema + 原样 `input_digest`
|
||||
- timeout / fetcher error 全量 fallback、不升 `ErrReportInvalid`
|
||||
- UI 分区:`change-report-factual`(`rule_risk`/lineage)vs `change-report-narrative`(PI 或 fallback)
|
||||
- 仓库默认 `PI_CHANGE_REPORT_NARRATIVE=false`
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- OS:Linux;Go:go1.27.1
|
||||
- 分支:`feature/w3-pi-change-report-narrative-live`
|
||||
- Runner:`http://127.0.0.1:18865`,model `MiniMax-M2.7-highspeed`,typed-result-v1
|
||||
- DATA_DIR:`data/dev`(workspace 落在 `data/dev/workspaces`)
|
||||
- 层级:Go 单测 + 真实 PI(非 `-short`)+ 前端 view-model 单测
|
||||
- Playwright 浏览器 live:**NOT RUN**(默认 flag off;无独立 flag-on 质量修复 E2E 门;UI 分区由既有 `overlayMode.test.ts` 覆盖)
|
||||
- 证据:`.doc/test-reports/assets/2026-09-17-w3-pi-change-report-narrative/`
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- flag off:空报告仍是确定性 fallback
|
||||
- flag on + 合法 PI JSON:`analysis_status=complete`,summary 来自 PI,`risk_level` 仍是服务端 `rule_risk`
|
||||
- flag on + TIMEOUT envelope / fetcher error:`analysis_status=fallback`,`err=nil`
|
||||
- live:payload 含 `change_report_narrative_v1` 且 digest 与 facts.json 一致
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 单测(flag / digest / fallback)
|
||||
|
||||
- **测试输入 (Input)**:`go test -short ./internal/docrevision ./internal/app`
|
||||
- **实际输出 (Actual Output)**:`ok` 全绿(含 `TestCreateAgentCandidate_FlagOnFetcherApplies`、`FlagOnFetcherErrorFallsBack`、`FlagOnTimeoutFallsBackWithoutError`)
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
### 5.2 真实 PI MiniMax
|
||||
|
||||
- **测试输入 (Input)**:`RUN_PI_E2E=1 go test ./internal/app -run TestPiChangeReportNarrator_LiveMiniMax -v`
|
||||
- **实际输出 (Actual Output)**:
|
||||
|
||||
```text
|
||||
=== RUN TestPiChangeReportNarrator_LiveMiniMax
|
||||
pi_narrative_test.go:104: elapsed=7.275s raw={
|
||||
"schema_version": 1,
|
||||
"schema_kind": "change_report_narrative_v1",
|
||||
"input_digest": "abababababababababababababababababababababababababababababababab",
|
||||
"from_sha": "fromsha",
|
||||
"to_sha": "tosha",
|
||||
"summary": ["变更风险等级为中等", "包含0个影响点和0个代码块"]
|
||||
}
|
||||
--- PASS: TestPiChangeReportNarrator_LiveMiniMax (7.28s)
|
||||
```
|
||||
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(digest 原样;no-tool 由 instructions 约束;产物 `narrative.md`)
|
||||
- **性能与耗时 (Duration & Latency)**:7.28s
|
||||
|
||||
### 5.3 UI 分区
|
||||
|
||||
- **测试输入 (Input)**:`npx tsx --test src/features/documentRevision/overlayMode.test.ts`
|
||||
- **实际输出 (Actual Output)**:14 pass;`marks complete analysis as PI narrative vs factual fields`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(面板 `change-report-factual` / `change-report-narrative` 已分区;Playwright live NOT RUN)
|
||||
- **性能与耗时 (Duration & Latency)**:125ms
|
||||
|
||||
### 5.4 arch-check / 默认 flag
|
||||
|
||||
- **测试输入 (Input)**:`./scripts/arch-check.sh --mode block`;compose / `.env.example` 默认 false
|
||||
- **实际输出 (Actual Output)**:见合入冒烟;默认 `PI_CHANGE_REPORT_NARRATIVE=false`
|
||||
- **评价判定 (Evaluation / Verdict)**:合入时验收
|
||||
- **性能与耗时 (Duration & Latency)**:—
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
- `go test -short ./internal/docrevision ./internal/app`:PASS
|
||||
- `go test ./internal/app -run TestPiChangeReportNarrator_LiveMiniMax`:PASS(真实 MiniMax)
|
||||
- `npx tsx --test src/features/documentRevision/overlayMode.test.ts`:PASS(14)
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
W3 达到矩阵「PI change-report 叙事」done。fallback 仍是声明行为,不是完整 PI。仓库默认 flag off。浏览器 flag-on 质量修复全链路可另开观测,不挡本行关闭。
|
||||
@@ -0,0 +1,45 @@
|
||||
# W4 U10 mutate 独立 flag 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
U10 仅有 dry-run 脚手架。W4 要求独立 `MULTI_INTENT_U10_MUTATE` 的 dry-run→confirm 证据,且不得升 PLAN_TIER、不得带动 U11/U12。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 仅 U10 on 时注册 mutate adapter
|
||||
- 带 expected revision 的 Execute 产出 `validated_only` receipt;同幂等键重放;digest 冲突 fail-closed
|
||||
- 缺 revision / 越权 key 零副作用
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- 分支:`feature/w4-u9-segment-live`;Go 单测(无领域写)
|
||||
- Playwright:**NOT RUN**(dry-run 不改 UI;不升 confirm)
|
||||
- 证据:`.doc/test-reports/assets/2026-09-17-w4-u10-mutate/`
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
flag 隔离;receipt 幂等;PLAN_TIER=legacy。
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 独立 flag dry-run confirm
|
||||
|
||||
- **测试输入 (Input)**:`go test ./internal/app/intentflow -run TestU10IndependentFlagDryRunConfirmReceipt -v`
|
||||
- **实际输出 (Actual Output)**:PASS(见 assets)
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<10ms
|
||||
|
||||
### 5.2 Playwright
|
||||
|
||||
- **测试输入 (Input)**:无 mutate UI 门
|
||||
- **实际输出 (Actual Output)**:NOT RUN
|
||||
- **评价判定 (Evaluation / Verdict)**:本 action 关闭条件为 dry-run 证据,非 live 写
|
||||
- **性能与耗时 (Duration & Latency)**:—
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
`go test ./internal/app/intentflow -run TestU10IndependentFlagDryRunConfirmReceipt`:PASS
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
U10 独立 flag 证据闭环。领域 live mutate 仍须专项批准,不在本波。
|
||||
@@ -0,0 +1,44 @@
|
||||
# W4 U11 docgov 独立 flag 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
U11 dry-run 脚手架需独立 `MULTI_INTENT_U11_DOCGOV` 证据,且项目 143 只读。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 仅 U11 on 时注册 docgov adapter,不带动 U10
|
||||
- 非 143 项目 dry-run 成功;项目 143 `document.claim` fail-closed 且不落 receipt
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- 分支:`feature/w4-u9-segment-live`;Go 单测
|
||||
- Playwright:**NOT RUN**
|
||||
- 证据:`.doc/test-reports/assets/2026-09-17-w4-u11-docgov/`
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
143 零副作用;其它项目 validated_only。
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 项目 143 只读
|
||||
|
||||
- **测试输入 (Input)**:`go test ./internal/app/intentflow -run TestU11DocGovProject143ReadOnly -v`
|
||||
- **实际输出 (Actual Output)**:PASS
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<10ms
|
||||
|
||||
### 5.2 Playwright
|
||||
|
||||
- **测试输入 (Input)**:无
|
||||
- **实际输出 (Actual Output)**:NOT RUN
|
||||
- **评价判定 (Evaluation / Verdict)**:不挡本 action dry-run 关闭
|
||||
- **性能与耗时 (Duration & Latency)**:—
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
`go test ./internal/app/intentflow -run TestU11DocGovProject143ReadOnly`:PASS
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
U11 独立 flag + 143 只读成立。不升 PLAN_TIER。
|
||||
@@ -0,0 +1,45 @@
|
||||
# W4 U12 workflow/run-control 独立 flag 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
U12 不得与 U10/U11 共用开关。W4 只做独立 flag dry-run 证据。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 仅 U12 on 时注册 run-control adapter
|
||||
- `workflow.run` 无 revision 可 dry-run;Denied fail-closed
|
||||
- 不升 PLAN_TIER
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- 分支:`feature/w4-u9-segment-live`;Go 单测
|
||||
- Playwright:**NOT RUN**(不升 confirm)
|
||||
- 证据:`.doc/test-reports/assets/2026-09-17-w4-u12-run-control/`
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
flag 隔离;denied 无 receipt。
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 独立 dry-run
|
||||
|
||||
- **测试输入 (Input)**:`go test ./internal/app/intentflow -run TestU12RunControlIndependentDryRun -v`
|
||||
- **实际输出 (Actual Output)**:PASS
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<10ms
|
||||
|
||||
### 5.2 Playwright
|
||||
|
||||
- **测试输入 (Input)**:无
|
||||
- **实际输出 (Actual Output)**:NOT RUN
|
||||
- **评价判定 (Evaluation / Verdict)**:不挡本 action dry-run 关闭
|
||||
- **性能与耗时 (Duration & Latency)**:—
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
`go test ./internal/app/intentflow -run TestU12RunControlIndependentDryRun`:PASS
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
U12 独立 flag 证据闭环。workflow live 与升 confirm 另开授权。
|
||||
@@ -0,0 +1,54 @@
|
||||
# W4 U9 LLM 分段真实 PI 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
U9 脚手架开启 `MULTI_INTENT_U9_SEGMENT` 后仍走 `StubSegmentProposer`。关闭条件要求真实 MiniMax proposer,且规则能判断时不出 proposal。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 规则切分 / `查询并总结` 内链 → `SEGMENT_RULES_DECIDED`
|
||||
- 歧义句走产品 PI no-tool proposer;digest 绑定;malformed/timeout/OOB fail-closed
|
||||
- 默认 flag off;不升 `MULTI_INTENT_PLAN_TIER`
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- 分支:`feature/w4-u9-segment-live`;Runner `:18865` MiniMax-M2.7-highspeed
|
||||
- 层级:intentflow 单测 + app recording + 真实 PI
|
||||
- Playwright 双标签:**NOT RUN**(本 action 不升 confirm;既有 [U6 dual-tab](./2026-09-16-intent-plan-cards-playwright-test-report.md) 作回归 lineage)
|
||||
- 证据:`.doc/test-reports/assets/2026-09-17-w4-u9-segment/`
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
规则可切 → 无 LLM proposal;live payload schema+digest 匹配。
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 规则门 / fail-closed
|
||||
|
||||
- **测试输入 (Input)**:`go test ./internal/app/intentflow -run 'TestRuleGated|TestStub|TestActive'`
|
||||
- **实际输出 (Actual Output)**:`TestRuleGatedProposerSkipsWhenRulesDecide` PASS
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<10ms
|
||||
|
||||
### 5.2 真实 PI MiniMax
|
||||
|
||||
- **测试输入 (Input)**:`RUN_PI_E2E=1 go test ./internal/app -run TestPiSegmentProposer_LiveMiniMax -v`
|
||||
- **实际输出 (Actual Output)**:elapsed=16.163s;`Digest:live-u9-digest`;span 覆盖原句
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:16.16s
|
||||
|
||||
### 5.3 Playwright 双标签
|
||||
|
||||
- **测试输入 (Input)**:U9 不升 PLAN_TIER
|
||||
- **实际输出 (Actual Output)**:NOT RUN
|
||||
- **评价判定 (Evaluation / Verdict)**:不挡 U9 关闭(双标签属 confirm 计划卡,本 action 为 segment proposal)
|
||||
- **性能与耗时 (Duration & Latency)**:—
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
- `go test -short ./internal/app/intentflow ./internal/app`:PASS
|
||||
- live MiniMax:PASS
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
U9 达到独立 action 关闭条件。默认 flag off。升 `confirm` 须另开授权。
|
||||
@@ -0,0 +1,63 @@
|
||||
# W5a 软件自举 UI + docs_only 真实 PI 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
L1 catalog/create 已合 `dev`,创建弹窗仍默认医疗并克隆 7 份模板。W5a 要求 catalog 驱动软件向导、solo 未独立评审标注、docs_only 真实 PI 建议 delivery(不自动激活)。SWBOOT-10 保持 stub,矩阵不升 done。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 软件项目只挂 `software_bootstrap` / `software_delivery`,不挂医疗三 key
|
||||
- 医疗三 key 回归仍可挂载
|
||||
- 前端不克隆 7 模板当 `product_domain=non_medical_software`
|
||||
- 真实 PI 建议 `software_delivery` 且 `auto_activate=false`
|
||||
- `ExecuteControlledPatch` 仍 fail-closed
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
- 分支:`feature/w5a-software-bootstrap-ui-pi`;Runner `:18865` MiniMax
|
||||
- 层级:Go 单测 + 前端 guard 单测 + 真实 PI
|
||||
- Playwright 全向导:**NOT RUN**(医疗默认标题保留以兼容既有 dual-tab heading)
|
||||
- 证据:`.doc/test-reports/assets/2026-09-17-w5a-software-bootstrap-ui-pi/`
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
软件不激活 delivery;医疗三 key 仍在;controlled_patch stub。
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 catalog / 医疗三 key
|
||||
|
||||
- **测试输入 (Input)**:`go test ./internal/projectworkflow -run TestCreateSoftwareProject_NoMedicalDefaults`;`go test ./internal/workflowdef`
|
||||
- **实际输出 (Actual Output)**:PASS
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<10ms
|
||||
|
||||
### 5.2 真实 PI MiniMax docs_only
|
||||
|
||||
- **测试输入 (Input)**:`RUN_PI_E2E=1 go test ./internal/app -run TestPiSoftwareBootstrapAdvisor_LiveMiniMax -v`
|
||||
- **实际输出 (Actual Output)**:elapsed=14.93s;建议 `software_delivery`;自动激活 false
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:14.93s
|
||||
|
||||
### 5.3 前端 7 模板门
|
||||
|
||||
- **测试输入 (Input)**:`npx tsx --test src/lib/createProjectSubmitGuard.test.ts`
|
||||
- **实际输出 (Actual Output)**:`shouldCloneMedicalTemplates skips the 7-pack` PASS
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:134ms
|
||||
|
||||
### 5.4 SWBOOT-10 stub
|
||||
|
||||
- **测试输入 (Input)**:`go test ./internal/swboot -run TestRepoAllowlistStub`
|
||||
- **实际输出 (Actual Output)**:PASS(`ERR_SWBOOT10_STUB_ONLY`)
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(本波故意不实现真 patch)
|
||||
- **性能与耗时 (Duration & Latency)**:<10ms
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
- `go test -short ./internal/swboot ./internal/projectworkflow ./internal/app ./internal/workflowdef`:PASS
|
||||
- live MiniMax:PASS
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
W5a 可合 `dev`。FEATURE-MATRIX「纯软件项目自举」保持 `partial`(SWBOOT-10 stub / W5b 未做)。升 done 须独立安全评审后的受控执行器。
|
||||
@@ -0,0 +1,92 @@
|
||||
# W6 FAV subscriber shadow 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
FAV 禁止整支 merge `feature/final-artifact-vault`。U7 增量已合 `dev`(publisher/consumer 默认 off)。W6 只手工移植 subscriber **shadow**:计算 intended outcome,不写 staging/artifact/publication,不开启 `FAV_DEGRADED_READ`。live 观察窗 ≥7 天,本轮不开。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- `ObserveShadow` 只读:`WouldStage`/`WouldPublish`/`DegradedReadUsed` 恒 false
|
||||
- `FAV_DEGRADED_READ=true`(结构字段或进程 env)时 shadow 拒绝
|
||||
- `HandleLease` 与 `Registry.Register(fav)` 仍 fail-closed
|
||||
- vault status / `artifact-vault status` 标明 `shadow_observe` 与 live 未放量
|
||||
- 仓库默认 `FAV_PUBLISHER_ENABLED=false`、`FAV_DEGRADED_READ=false`
|
||||
- FEATURE-MATRIX FAV **保持 partial**
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
| 项 | 值 |
|
||||
|----|----|
|
||||
| OS | Linux 7.0.0-31-generic |
|
||||
| Go | go1.27.1 linux/amd64 |
|
||||
| 分支 | `feature/w6-fav-subscriber-shadow`(自 `dev@49d901e`) |
|
||||
| 层级 | 单元测试 + CLI status;无真实 PI(本波无 PI 路径) |
|
||||
| 证据 | `.doc/test-reports/assets/2026-09-17-w6-fav-subscriber-shadow/` |
|
||||
|
||||
核心用例矩阵:
|
||||
|
||||
| ID | 用例 | 期望 |
|
||||
|----|------|------|
|
||||
| S1 | 零值 consumer | DefaultEnabled=false;HandleLease → ErrDisabledConsumer |
|
||||
| S2 | Enabled=true 仍无 registry 审批 | HandleLease 拒绝;Register(fav) 失败 |
|
||||
| S3 | ObserveShadow | logical=`document:doc_1`;不声明 writes |
|
||||
| S4 | AllowDegradedRead / env true | shadow error;不写 vault |
|
||||
| S5 | GET vault/status | consumer_mode=off;would_stage/publish=false;live_not_opened=true |
|
||||
| S6 | artifact-vault status | remaining_to_port 含 live 观察窗;shadow_observe=true |
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- 所有默认路径 FAIL-CLOSED:不 Drain、不 Stage、不 Publish、不 claim fav lease
|
||||
- shadow 不是写回执
|
||||
- live staging→artifact→publication **NOT OPENED**
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 S1–S4 fav subscriber
|
||||
|
||||
- **测试输入 (Input)**:`go test -count=1 ./internal/app/fav -run TestFavSubscriber -v`
|
||||
- **实际输出 (Actual Output)**:三用例全部 PASS。见 `assets/2026-09-17-w6-fav-subscriber-shadow/unit-tests.txt`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:0.002s
|
||||
|
||||
### 5.2 S5 vault status
|
||||
|
||||
- **测试输入 (Input)**:`go test ./internal/server -run 'TestVaultDefaults|TestVaultStatus'`
|
||||
- **实际输出 (Actual Output)**:`consumer_mode=off`、`shadow_observe=true`、`would_stage=false`、`would_publish=false`、`live_not_opened=true`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:0.007s
|
||||
|
||||
### 5.3 S6 CLI stub
|
||||
|
||||
- **测试输入 (Input)**:`go build ./cmd/artifact-vault && artifact-vault status`
|
||||
- **实际输出 (Actual Output)**:见 `artifact-vault-status.json`。`consumer_mode=off`、`degraded_read=false`、`shadow_observe=true`、`would_stage=false`、`would_publish=false`;`remaining_to_port` 含 durable Register 与 live 三级观察窗。
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
### 5.4 冒烟
|
||||
|
||||
- **测试输入 (Input)**:`go vet ./...`;`unset TEST_DATABASE_URL; go test -short ./...`;`./scripts/arch-check.sh --mode block`
|
||||
- **实际输出 (Actual Output)**:`VET_EXIT=0`、`TEST_EXIT=0`、`arch-check block: production gate passed`。见 `smoke.txt`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:约 14s(short tests;`internal/server` 10.993s)
|
||||
|
||||
### 5.5 live 放量
|
||||
|
||||
- **测试输入 (Input)**:compose 默认 `FAV_DEGRADED_READ` / `FAV_PUBLISHER_ENABLED`
|
||||
- **实际输出 (Actual Output)**:docker-compose.dev.yml 仍 `${FAV_DEGRADED_READ:-false}` / `${FAV_PUBLISHER_ENABLED:-false}`;未改仓库默认;未开 staging Drain。
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(**live 未放量**,符合本波边界)
|
||||
- **性能与耗时 (Duration & Latency)**:N/A
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
```text
|
||||
ok internal/app/fav TestFavSubscriber* PASS
|
||||
ok internal/server TestVaultDefaultsStayDisabled / TestVaultStatusReportsOff PASS
|
||||
go test -short ./... TEST_EXIT=0
|
||||
go vet ./... VET_EXIT=0
|
||||
arch-check --mode block production gate passed
|
||||
```
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
W6 **shadow 切片 PASS**,可合 `dev`。FEATURE-MATRIX FAV **保持 partial**:live staging→artifact→publication 未开,观察窗 ≥7 天未开始计时。禁止整支 merge FAV;`FAV_DEGRADED_READ` 保持 false。durable `Register(fav)` 仍须单独 cutover 审批。
|
||||
@@ -0,0 +1,103 @@
|
||||
# W7 D7 对话数据分类盘点 测试报告
|
||||
|
||||
## 一、 测试背景 (Background)
|
||||
|
||||
D7 ADR 数字标 `pending-compliance-signoff`。W2 已释放 `chat` mutex。本波只做只读盘点,禁止按草案数字物理删除或清备份,矩阵保持 `deferred`。
|
||||
|
||||
## 二、 测试目标 (Test Objectives)
|
||||
|
||||
- 盘点 sessions/messages、KB、日志、备份、event 敏感字段与流转
|
||||
- 确认无已签字基线违规;若有则写 gap-matrix
|
||||
- 零物理删除、零备份清除
|
||||
- FEATURE-MATRIX D7 保持 `deferred`
|
||||
|
||||
## 三、 测试方案与环境 (Test Plan & Environment)
|
||||
|
||||
| 项 | 值 |
|
||||
|----|----|
|
||||
| OS | Linux 7.0.0-31-generic |
|
||||
| 分支 | `feature/w7-d7-data-inventory`(自 `dev@cb4fbb6` W6 merge 后) |
|
||||
| 环境 | dev schema 48;共享 KB `regulations` |
|
||||
| 方法 | 只读 SQL / `docker logs` / 目录 `du` / `go vet` / `arch-check` |
|
||||
| 证据 | `.doc/test-reports/assets/2026-09-17-w7-d7-inventory/` |
|
||||
|
||||
核心用例矩阵:
|
||||
|
||||
| ID | 用例 | 期望 |
|
||||
|----|------|------|
|
||||
| I1 | chat 热库计数与 `deleted_at` | 只读;不 UPDATE |
|
||||
| I2 | 事件 payload keys | 无 `content` |
|
||||
| I3 | 共享 KB | 无法规库外的 chat 表 |
|
||||
| I4 | 应用日志抽检 | 无消息正文;DSN 脱敏 |
|
||||
| I5 | 备份脚本 | `pg_dump -Fc` 整库;本轮不执行 dump |
|
||||
| I6 | 违规升级 | 无已确认违规 → 不写 gap-matrix |
|
||||
|
||||
## 四、 预期结果 (Expected Results)
|
||||
|
||||
- 盘点表完整
|
||||
- 判定:缺口是未实现治理,不是已签字数字被违反
|
||||
- health/ready PASS;FAV 仍 off
|
||||
|
||||
## 五、 实际测试结果与判定 (Actual Results & Evaluation)
|
||||
|
||||
### 5.1 I1 热库
|
||||
|
||||
- **测试输入 (Input)**:`docker exec shuimu-context-pg-dev psql` 只读 `COUNT` / `MIN/MAX(created_at)`
|
||||
- **实际输出 (Actual Output)**:sessions=619;messages=3291;soft_deleted=0;older_than_365d=0;oldest=2026-09-10。`chat_messages` 5.4MB。Go 检索无 `SET deleted_at`。见 `pg-counts.tsv`、`pg-chat-age.txt`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(盘点完成;未删数据)
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
### 5.2 I2 事件
|
||||
|
||||
- **测试输入 (Input)**:`jsonb_object_keys(convert_from(payload,'UTF8')::jsonb)`;`? 'content'`
|
||||
- **实际输出 (Actual Output)**:4 envelopes;`has_content=f`;keys 为 `run_id`/`plan_id`/`summary_ref` 等。DLQ=0。fav mode=off,notify/projection/workflow_advance=live。见 `pg-event-payload-keys.txt`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(Track E 正文未进事件)
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
### 5.3 I3 共享 KB
|
||||
|
||||
- **测试输入 (Input)**:`shuimu-kb-shared` `\dt` + counts
|
||||
- **实际输出 (Actual Output)**:库名 `regulations`;法规 2907 文档 / 312919 chunks;无 chat 表。见 `kb-tables.txt`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(对话与 KB 隔离)
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
### 5.4 I4 日志
|
||||
|
||||
- **测试输入 (Input)**:`docker inspect` LogDriver;`docker logs --tail 30 shuimu-agent-app-dev`
|
||||
- **实际输出 (Actual Output)**:`json-file` 无 max-size。日志含 `dsn=postgres://regkb:***@...`,无 chat content。见 `app-logs-tail.txt`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:<1s
|
||||
|
||||
### 5.5 I5 备份
|
||||
|
||||
- **测试输入 (Input)**:阅读 `scripts/backup-system-db.sh`;`ls ./backups`
|
||||
- **实际输出 (Actual Output)**:脚本 `pg_dump -Fc` 整库(含 chat 明文);宿主机无 `./backups`。本轮**未**运行 dump。CI `backup-restore-drill` 仍在。
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS(未清备份、未新造 dump)
|
||||
- **性能与耗时 (Duration & Latency)**:N/A
|
||||
|
||||
### 5.6 I6 违规升级
|
||||
|
||||
- **测试输入 (Input)**:对照 ADR `pending-compliance-signoff` + Track E ID-only
|
||||
- **实际输出 (Actual Output)**:无已确认基线违规。**未**修改 `gap-matrix.md`。
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:N/A
|
||||
|
||||
### 5.7 冒烟 / health
|
||||
|
||||
- **测试输入 (Input)**:`go vet ./...`;`arch-check --mode block`;`curl :8080/health` `/ready`
|
||||
- **实际输出 (Actual Output)**:VET_EXIT=0;`arch-check block: production gate passed`;schema_version=48;vault `consumer_mode=off`、`live_not_opened=true`。见 `health.json`、`smoke.txt`
|
||||
- **评价判定 (Evaluation / Verdict)**:PASS
|
||||
- **性能与耗时 (Duration & Latency)**:vet+arch ~1.4s
|
||||
|
||||
## 六、 自动化测试套件汇总 (Test Suite Execution)
|
||||
|
||||
```text
|
||||
go vet ./... VET_EXIT=0
|
||||
./scripts/arch-check.sh --mode block production gate passed
|
||||
W7 无代码变更;go test -short 以 W6 合入后基线为准(TEST_EXIT=0)
|
||||
只读 SQL 盘点 无 DELETE/UPDATE
|
||||
```
|
||||
|
||||
## 七、 测试结论与后续优化建议 (Conclusion & Next Steps)
|
||||
|
||||
W7 **盘点 PASS**。FEATURE-MATRIX D7 **保持 deferred**。合规签字前禁止按 365/180/30 执行删除。签字后整改应覆盖:聊天 soft-delete 写路径、派生 `context_memory_chunks.chat_history`、workspace 非终态、备份二次批准。`production_ready` 不翻转。
|
||||
@@ -0,0 +1,63 @@
|
||||
=== go test FAV disablement suite ===
|
||||
=== RUN TestFAVFlagsDefaultOff
|
||||
--- PASS: TestFAVFlagsDefaultOff (0.00s)
|
||||
=== RUN TestFAVFlagsOptInOnly
|
||||
--- PASS: TestFAVFlagsOptInOnly (0.00s)
|
||||
=== RUN TestValidateIndependentVault
|
||||
--- PASS: TestValidateIndependentVault (0.00s)
|
||||
PASS
|
||||
ok chat-agent-system/internal/config 0.002s
|
||||
=== RUN TestFavSubscriberDefaultsDisabled
|
||||
--- PASS: TestFavSubscriberDefaultsDisabled (0.00s)
|
||||
=== RUN TestFavSubscriberStillDisabledWhenFlagOnWithoutRegistryApproval
|
||||
--- PASS: TestFavSubscriberStillDisabledWhenFlagOnWithoutRegistryApproval (0.00s)
|
||||
PASS
|
||||
ok chat-agent-system/internal/app/fav 0.002s
|
||||
=== RUN TestVaultDefaultsStayDisabled
|
||||
--- PASS: TestVaultDefaultsStayDisabled (0.00s)
|
||||
=== RUN TestVaultStatusReportsOff
|
||||
--- PASS: TestVaultStatusReportsOff (0.00s)
|
||||
=== RUN TestValidateIndependentVaultRejectsDataRoot
|
||||
--- PASS: TestValidateIndependentVaultRejectsDataRoot (0.00s)
|
||||
PASS
|
||||
ok chat-agent-system/internal/server 0.007s
|
||||
=== RUN TestValidateOpsCutoverRejectsFavAndNonDev
|
||||
--- PASS: TestValidateOpsCutoverRejectsFavAndNonDev (0.00s)
|
||||
=== RUN TestPrincipalRejectsWildcardAndFAV
|
||||
--- PASS: TestPrincipalRejectsWildcardAndFAV (0.00s)
|
||||
=== RUN TestAssertLiveConsumersRejectsFAV
|
||||
--- PASS: TestAssertLiveConsumersRejectsFAV (0.00s)
|
||||
=== RUN TestLiveConsumersOmitsFAV
|
||||
--- PASS: TestLiveConsumersOmitsFAV (0.00s)
|
||||
=== RUN TestManifestJSONIncludesDisabledFAV
|
||||
--- PASS: TestManifestJSONIncludesDisabledFAV (0.00s)
|
||||
=== RUN TestE0B_FAVNeverClaimed_PG
|
||||
dispatcher_pg_test.go:85: TEST_DATABASE_URL not set; skipping PostgreSQL integration test
|
||||
--- SKIP: TestE0B_FAVNeverClaimed_PG (0.00s)
|
||||
PASS
|
||||
ok chat-agent-system/internal/events 0.004s
|
||||
=== RUN TestFavDegradedReadDefaultOff
|
||||
--- PASS: TestFavDegradedReadDefaultOff (0.00s)
|
||||
=== RUN TestFavDegradedReadOnlyAfterAuthorize
|
||||
--- PASS: TestFavDegradedReadOnlyAfterAuthorize (0.00s)
|
||||
PASS
|
||||
ok chat-agent-system/internal/docquery 0.002s
|
||||
=== go build cmd/artifact-vault ===
|
||||
{
|
||||
"binary": "artifact-vault",
|
||||
"consumer": "fav",
|
||||
"consumer_mode": "off",
|
||||
"degraded_read": false,
|
||||
"note": "do not enable FAV_DEGRADED_READ or fav consumer without approval",
|
||||
"publisher_default": false,
|
||||
"remaining_to_port": [
|
||||
"enumerate.go (EnumerateTerminals / LoadExclusions)",
|
||||
"TerminalRow + Backfill(rows) API (diverged from dataset Candidate path)",
|
||||
"full recover-plan / recover-apply / gc-preflight / destroy",
|
||||
"server ingest hooks (OnFinalArtifact*)",
|
||||
"durable fav event Register after separate approval"
|
||||
],
|
||||
"slice": "u7-incremental-stub",
|
||||
"source_branch": "feature/final-artifact-vault"
|
||||
}
|
||||
=== go vet ===
|
||||
+11
@@ -0,0 +1,11 @@
|
||||
|
||||
Running 1 test using 1 worker
|
||||
|
||||
✓ 1 [chromium] › e2e/intent-plan-cards.spec.ts:292:3 › intent-plan PLAN_CONFIRM dual-tab › dual-tab confirm mutual exclusion + reload/relogin matches PG (6.1s)
|
||||
|
||||
1 passed (7.0s)
|
||||
npm notice
|
||||
npm notice New major version of npm available! 11.19.0 -> 12.0.2
|
||||
npm notice Changelog: https://github.com/npm/cli/releases/tag/v12.0.2
|
||||
npm notice To update run: npm install -g npm@12.0.2
|
||||
npm notice
|
||||
+42
@@ -0,0 +1,42 @@
|
||||
|
||||
Running 1 test using 1 worker
|
||||
|
||||
(node:1544109) Warning: The 'NO_COLOR' env is ignored due to the 'FORCE_COLOR' env being set.
|
||||
(Use `node --trace-warnings ...` to show where the warning was created)
|
||||
✘ 1 [chromium] › e2e/intent-plan-cards.spec.ts:228:3 › intent-plan PLAN_CONFIRM dual-tab › dual-tab confirm mutual exclusion + reload/relogin matches PG (0ms)
|
||||
|
||||
|
||||
1) [chromium] › e2e/intent-plan-cards.spec.ts:228:3 › intent-plan PLAN_CONFIRM dual-tab › dual-tab confirm mutual exclusion + reload/relogin matches PG
|
||||
|
||||
Error: browserType.launch: Target page, context or browser has been closed
|
||||
Browser logs:
|
||||
|
||||
<launching> /home/weichen/.cache/ms-playwright/chromium_headless_shell-1243/chrome-headless-shell-linux64/chrome-headless-shell --disable-field-trial-config --disable-background-networking --disable-background-timer-throttling --disable-backgrounding-occluded-windows --disable-back-forward-cache --disable-breakpad --disable-client-side-phishing-detection --disable-component-extensions-with-background-pages --disable-component-update --no-default-browser-check --disable-default-apps --disable-dev-shm-usage --disable-edgeupdater --disable-extensions --disable-features=AvoidUnnecessaryBeforeUnloadCheckSync,DestroyProfileOnBrowserClose,DialMediaRouteProvider,GlobalMediaControls,HttpsUpgrades,LensOverlay,MediaRouter,PaintHolding,ThirdPartyStoragePartitioning,BlockOriginHeaderModificationOnRedirect,Translate,AutoDeElevate,OptimizationHints,msForceBrowserSignIn,msEdgeUpdateLaunchServicesPreferredVersion --enable-features=CDPScreenshotNewSurface --allow-pre-commit-input --disable-hang-monitor --disable-ipc-flooding-protection --disable-popup-blocking --disable-prompt-on-repost --disable-renderer-backgrounding --disable-updater-scheduler --force-color-profile=srgb --metrics-recording-only --no-first-run --password-store=basic --use-mock-keychain --no-service-autorun --export-tagged-pdf --disable-search-engine-choice-screen --unsafely-disable-devtools-self-xss-warnings --edge-skip-compat-layer-relaunch --disable-infobars --disable-search-engine-choice-screen --disable-sync --enable-unsafe-swiftshader --headless --hide-scrollbars --mute-audio --blink-settings=primaryHoverType=2,availableHoverTypes=2,primaryPointerType=4,availablePointerTypes=4 --no-sandbox --user-data-dir=/tmp/playwright_chromiumdev_profile-qF5jvT --remote-debugging-pipe --no-startup-window
|
||||
<launched> pid=1544124
|
||||
[pid=1544124][err] /home/weichen/.cache/ms-playwright/chromium_headless_shell-1243/chrome-headless-shell-linux64/chrome-headless-shell: error while loading shared libraries: libatk-1.0.so.0: cannot open shared object file: No such file or directory
|
||||
Call log:
|
||||
- <launching> /home/weichen/.cache/ms-playwright/chromium_headless_shell-1243/chrome-headless-shell-linux64/chrome-headless-shell --disable-field-trial-config --disable-background-networking --disable-background-timer-throttling --disable-backgrounding-occluded-windows --disable-back-forward-cache --disable-breakpad --disable-client-side-phishing-detection --disable-component-extensions-with-background-pages --disable-component-update --no-default-browser-check --disable-default-apps --disable-dev-shm-usage --disable-edgeupdater --disable-extensions --disable-features=AvoidUnnecessaryBeforeUnloadCheckSync,DestroyProfileOnBrowserClose,DialMediaRouteProvider,GlobalMediaControls,HttpsUpgrades,LensOverlay,MediaRouter,PaintHolding,ThirdPartyStoragePartitioning,BlockOriginHeaderModificationOnRedirect,Translate,AutoDeElevate,OptimizationHints,msForceBrowserSignIn,msEdgeUpdateLaunchServicesPreferredVersion --enable-features=CDPScreenshotNewSurface --allow-pre-commit-input --disable-hang-monitor --disable-ipc-flooding-protection --disable-popup-blocking --disable-prompt-on-repost --disable-renderer-backgrounding --disable-updater-scheduler --force-color-profile=srgb --metrics-recording-only --no-first-run --password-store=basic --use-mock-keychain --no-service-autorun --export-tagged-pdf --disable-search-engine-choice-screen --unsafely-disable-devtools-self-xss-warnings --edge-skip-compat-layer-relaunch --disable-infobars --disable-search-engine-choice-screen --disable-sync --enable-unsafe-swiftshader --headless --hide-scrollbars --mute-audio --blink-settings=primaryHoverType=2,availableHoverTypes=2,primaryPointerType=4,availablePointerTypes=4 --no-sandbox --user-data-dir=/tmp/playwright_chromiumdev_profile-qF5jvT --remote-debugging-pipe --no-startup-window
|
||||
- <launched> pid=1544124
|
||||
- [pid=1544124][err] /home/weichen/.cache/ms-playwright/chromium_headless_shell-1243/chrome-headless-shell-linux64/chrome-headless-shell: error while loading shared libraries: libatk-1.0.so.0: cannot open shared object file: No such file or directory
|
||||
- [pid=1544124] <gracefully close start>
|
||||
- [pid=1544124] <kill>
|
||||
- [pid=1544124] <will force kill>
|
||||
- [pid=1544124] exception while trying to kill process: Error: kill ESRCH
|
||||
- [pid=1544124] <process did exit: exitCode=127, signal=null>
|
||||
- [pid=1544124] starting temporary directories cleanup
|
||||
- [pid=1544124] finished temporary directories cleanup
|
||||
- [pid=1544124] <gracefully close end>
|
||||
|
||||
|
||||
Error Context: ../.doc/test-reports/assets/2026-09-16-intent-plan-playwright-dual-tab/playwright-output-main/intent-plan-cards-intent-p-3257d-n-reload-relogin-matches-PG-chromium/error-context.md
|
||||
|
||||
attachment #2: trace (application/zip) ─────────────────────────────────────────────────────────
|
||||
../.doc/test-reports/assets/2026-09-16-intent-plan-playwright-dual-tab/playwright-output-main/intent-plan-cards-intent-p-3257d-n-reload-relogin-matches-PG-chromium/trace.zip
|
||||
Usage:
|
||||
|
||||
npx playwright show-trace ../.doc/test-reports/assets/2026-09-16-intent-plan-playwright-dual-tab/playwright-output-main/intent-plan-cards-intent-p-3257d-n-reload-relogin-matches-PG-chromium/trace.zip
|
||||
|
||||
────────────────────────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
1 failed
|
||||
[chromium] › e2e/intent-plan-cards.spec.ts:228:3 › intent-plan PLAN_CONFIRM dual-tab › dual-tab confirm mutual exclusion + reload/relogin matches PG
|
||||
+79
@@ -0,0 +1,79 @@
|
||||
{
|
||||
"project": "PlanDual-mu49uev8",
|
||||
"scope": {
|
||||
"projectId": 6399,
|
||||
"sessionId": "sess-p6399-u9",
|
||||
"userId": 9
|
||||
},
|
||||
"planId": "pln_e2e_mu49uev8",
|
||||
"decisions": [
|
||||
{
|
||||
"status": 409,
|
||||
"body": "{\"error_code\":\"PLAN_STALE_REVISION\",\"message\":\"PLAN_STALE_REVISION\",\"plan\":{\"plan_id\":\"pln_e2e_mu49uev8\",\"revision\":2,\"status\":\"executing\",\"execution_mode\":\"validated_only\",\"expires_at\":\"2026-09-16T17:44:42.309711Z\",\"steps\":[{\"step_id\":\"stp_mu49uev8_1\",\"action_key\":\"regulation.query\",\"status\":\"eligible\",\"execution_mode\":\"validated_only\",\"safe_summary\":\"查询法规\"},{\"step_id\":\"stp_mu49uev8_2\",\"action_key\":\"regulation.query\",\"status\":\"eligible\",\"execution_mode\":\"validated_only\",\"safe_summary\":\"总结要点\"}],\"safe_summary\":\"Playwright dual-tab: query then summarize\"}}\n",
|
||||
"tab": "B"
|
||||
},
|
||||
{
|
||||
"status": 200,
|
||||
"body": "{\"plan\":{\"plan_id\":\"pln_e2e_mu49uev8\",\"revision\":2,\"status\":\"executing\",\"execution_mode\":\"validated_only\",\"expires_at\":\"2026-09-16T17:44:42.309711Z\",\"steps\":[{\"step_id\":\"stp_mu49uev8_1\",\"action_key\":\"regulation.query\",\"status\":\"eligible\",\"execution_mode\":\"validated_only\",\"safe_summary\":\"查询法规\"},{\"step_id\":\"stp_mu49uev8_2\",\"action_key\":\"regulation.query\",\"status\":\"eligible\",\"execution_mode\":\"validated_only\",\"safe_summary\":\"总结要点\"}],\"safe_summary\":\"Playwright dual-tab: query then summarize\"}}\n",
|
||||
"tab": "A"
|
||||
}
|
||||
],
|
||||
"pgAfter": {
|
||||
"status": "executing",
|
||||
"revision": "2"
|
||||
},
|
||||
"activeBefore": {
|
||||
"status": 200,
|
||||
"plan": {
|
||||
"plan_id": "pln_e2e_mu49uev8",
|
||||
"revision": 2,
|
||||
"status": "executing",
|
||||
"execution_mode": "validated_only",
|
||||
"expires_at": "2026-09-16T17:44:42.309711Z",
|
||||
"steps": [
|
||||
{
|
||||
"step_id": "stp_mu49uev8_1",
|
||||
"action_key": "regulation.query",
|
||||
"status": "eligible",
|
||||
"execution_mode": "validated_only",
|
||||
"safe_summary": "查询法规"
|
||||
},
|
||||
{
|
||||
"step_id": "stp_mu49uev8_2",
|
||||
"action_key": "regulation.query",
|
||||
"status": "eligible",
|
||||
"execution_mode": "validated_only",
|
||||
"safe_summary": "总结要点"
|
||||
}
|
||||
],
|
||||
"safe_summary": "Playwright dual-tab: query then summarize"
|
||||
}
|
||||
},
|
||||
"activeAfter": {
|
||||
"status": 200,
|
||||
"plan": {
|
||||
"plan_id": "pln_e2e_mu49uev8",
|
||||
"revision": 2,
|
||||
"status": "executing",
|
||||
"execution_mode": "validated_only",
|
||||
"expires_at": "2026-09-16T17:44:42.309711Z",
|
||||
"steps": [
|
||||
{
|
||||
"step_id": "stp_mu49uev8_1",
|
||||
"action_key": "regulation.query",
|
||||
"status": "eligible",
|
||||
"execution_mode": "validated_only",
|
||||
"safe_summary": "查询法规"
|
||||
},
|
||||
{
|
||||
"step_id": "stp_mu49uev8_2",
|
||||
"action_key": "regulation.query",
|
||||
"status": "eligible",
|
||||
"execution_mode": "validated_only",
|
||||
"safe_summary": "总结要点"
|
||||
}
|
||||
],
|
||||
"safe_summary": "Playwright dual-tab: query then summarize"
|
||||
}
|
||||
}
|
||||
}
|
||||
+6
@@ -0,0 +1,6 @@
|
||||
|
||||
Running 1 test using 1 worker
|
||||
|
||||
- 1 [chromium] › e2e/intent-plan-cards.spec.ts:292:3 › intent-plan PLAN_CONFIRM dual-tab › dual-tab confirm mutual exclusion + reload/relogin matches PG
|
||||
|
||||
1 skipped
|
||||
BIN
Binary file not shown.
|
After Width: | Height: | Size: 220 KiB |
BIN
Binary file not shown.
|
After Width: | Height: | Size: 220 KiB |
BIN
Binary file not shown.
|
After Width: | Height: | Size: 223 KiB |
BIN
Binary file not shown.
|
After Width: | Height: | Size: 218 KiB |
BIN
Binary file not shown.
|
After Width: | Height: | Size: 222 KiB |
BIN
Binary file not shown.
|
After Width: | Height: | Size: 222 KiB |
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user