From 4f5bde899aed3e4b63aaf877c77f801b1418e8b2 Mon Sep 17 00:00:00 2001 From: weichen Date: Sun, 13 Sep 2026 06:15:20 +0000 Subject: [PATCH] docs(test): archive DOCREV waves and record unit evidence MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update CURRENT/FEATURE-MATRIX, archive short-term tasks, and add document-revision management test report for Wave 0–6 delivery. Co-authored-by: Cursor --- ...-09-13-document-revision-wave0-contract.md | 2 +- ...ocument-revision-wave1-6-implementation.md | 45 +++++++++++++++ .doc/ops/CURRENT.md | 11 ++-- ...revision-management-implementation-plan.md | 2 +- .doc/status/FEATURE-MATRIX.md | 2 +- ...ocument-revision-management-test-report.md | 56 +++++++++++++++++++ 6 files changed, 110 insertions(+), 8 deletions(-) rename .doc/{ops/short-term => archive/ops}/2026-09-13-document-revision-wave0-contract.md (98%) create mode 100644 .doc/archive/ops/2026-09-13-document-revision-wave1-6-implementation.md create mode 100644 .doc/test-reports/2026-09-13-document-revision-management-test-report.md diff --git a/.doc/ops/short-term/2026-09-13-document-revision-wave0-contract.md b/.doc/archive/ops/2026-09-13-document-revision-wave0-contract.md similarity index 98% rename from .doc/ops/short-term/2026-09-13-document-revision-wave0-contract.md rename to .doc/archive/ops/2026-09-13-document-revision-wave0-contract.md index ea1aa53a..7a33b6bb 100644 --- a/.doc/ops/short-term/2026-09-13-document-revision-wave0-contract.md +++ b/.doc/archive/ops/2026-09-13-document-revision-wave0-contract.md @@ -1,6 +1,6 @@ --- title: "DOCREV Wave 0：契约冻结" -status: in_progress +status: done created: 2026-09-13 updated: 2026-09-13 owner: Cursor diff --git a/.doc/archive/ops/2026-09-13-document-revision-wave1-6-implementation.md b/.doc/archive/ops/2026-09-13-document-revision-wave1-6-implementation.md new file mode 100644 index 00000000..b6a436f3 --- /dev/null +++ b/.doc/archive/ops/2026-09-13-document-revision-wave1-6-implementation.md @@ -0,0 +1,45 @@ +--- +title: "DOCREV Wave 1–6：ledger 实施" +status: done +created: 2026-09-13 +updated: 2026-09-13 +owner: Cursor +branch: feature/document-revision-management +worktree: "-" +mutex: docgov +--- + +# DOCREV Wave 1–6：ledger 实施 + +## 目标 + +在 feature 分支交付快照内核、人工 PATCH、Agent candidate、比较 UI、通知与自由文档兼容。 + +## 范围 + +- Goose 00028、`internal/docrevision`、HTTP API、前端工具条、bizdev/freedoc/notification 接线 + +## 非目标 + +- 本任务不占集成槽位合入 `dev`；真实 PI 全链路补录另开集成窗口 + +## 步骤 + +1. [x] Wave 0 契约与 ADR +2. [x] Wave 1 迁移与内核 +3. [x] Wave 2 人工编辑 API/UI +4. [x] Wave 3 Agent candidate/commit +5. [x] Wave 4 比较 UI +6. [x] Wave 5 通知 +7. [x] Wave 6 自由文档兼容 + +## 验收标准 + +- [x] `go test -short ./internal/docrevision/...` PASS +- [x] 相关包回归 PASS +- [ ] 真实 PI + Playwright 双用户（集成槽位） + +## 相关链接 + +- Test report: `../../test-reports/2026-09-13-document-revision-management-test-report.md` +- ADR: `../../adr/2026-09-13-document-version-boundary.md` diff --git a/.doc/ops/CURRENT.md b/.doc/ops/CURRENT.md index d59d3dc6..190bcb02 100644 --- a/.doc/ops/CURRENT.md +++ b/.doc/ops/CURRENT.md @@ -1,11 +1,11 @@ # 当前焦点 **更新**: 2026-09-13 -**production_ready**: no（只读文档总结已通过真实 PI；刷新/双标签页 busy 浏览器 E2E 待补录） +**production_ready**: no（只读文档总结已通过真实 PI；刷新/双标签页 busy 浏览器 E2E 待补录；DOCREV 待合 dev） ## 焦点 -1. **DOCREV**: [Wave 0 契约冻结](short-term/2026-09-13-document-revision-wave0-contract.md) → Wave 1–6 实施（mutex `docgov`） +1. **DOCREV**: feature 分支 Wave0–6 代码已齐；待占集成槽位合 `dev` + migrate 00028 + 真实 PI/Playwright 补录 2. **CHAT**: [刷新恢复整改已实施](short-term/2026-09-13-chat-history-refresh-remediation.md)（待合 dev + PI E2E 补录） 3. **CI**: `TEST_DATABASE_URL` + 真实 PI E2E 实录；INTENT 发布 blocker 见 conversation-intent short-term @@ -15,7 +15,7 @@ |-------|------|--------|----------|-------|--------| | Cursor | chat-history-refresh-remediation | fix/chat-history-refresh | - | chat | in_progress | | Codex | conversation-intent-runtime-state | fix/conversation-intent-state | .worktrees/fix-conversation-intent-state | intent | in_progress | -| Cursor | document-revision-wave0-contract | feature/document-revision-management | - | docgov | in_progress | +| Cursor | document-revision-wave1-6-implementation | feature/document-revision-management | - | docgov | done | > 新任务开始前登记。`branch` 必须为 `feature/` 或 `fix/`，**禁止** `dev` / `test` / `main`。同一 `mutex` 同时仅一个 `in_progress`。 @@ -23,7 +23,7 @@ | holder | phase | since | scope | queue | |--------|-------|-------|-------|-------| -| - | idle | 2026-09-13 04:47 UTC | - | - | +| - | idle | 2026-09-13 04:47 UTC | - | document-revision-management（待 merge） | **phase**: `idle` | `merging` | `smoke` | `e2e` @@ -37,7 +37,7 @@ | test | 8081 | 25→27* | healthy | | main | 8000 | 25→27* | healthy（app + runner + DB） | -*合入并 migrate 后为 27；DOCREV 迁移从 00028 起 +*合入并 migrate 后为 27；DOCREV 迁移 00028 待合入 ## SSOT @@ -49,3 +49,4 @@ | 测试报告 | [test-reports/](../test-reports/) | | Agent 手册 | [AGENTS.md](../../AGENTS.md) | | DOCREV ADR | [../adr/2026-09-13-document-version-boundary.md](../adr/2026-09-13-document-version-boundary.md) | +| DOCREV 测试 | [../test-reports/2026-09-13-document-revision-management-test-report.md](../test-reports/2026-09-13-document-revision-management-test-report.md) | diff --git a/.doc/remediation/2026-09-13-document-revision-management-implementation-plan.md b/.doc/remediation/2026-09-13-document-revision-management-implementation-plan.md index a9ad595b..2689072b 100644 --- a/.doc/remediation/2026-09-13-document-revision-management-implementation-plan.md +++ b/.doc/remediation/2026-09-13-document-revision-management-implementation-plan.md @@ -1,6 +1,6 @@ --- title: "文档修改、智能体版本与差异认知能力实施方案" -status: in_progress +status: done created: 2026-09-13 updated: 2026-09-13 --- diff --git a/.doc/status/FEATURE-MATRIX.md b/.doc/status/FEATURE-MATRIX.md index 769b8408..9c48c37d 100644 --- a/.doc/status/FEATURE-MATRIX.md +++ b/.doc/status/FEATURE-MATRIX.md @@ -21,7 +21,7 @@ | 工作流治理 | 三正式工作流 + 阶段门禁 | done | [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) | Phase2 设计器 partial | `workflow` | | 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) | — | `docgov` | -| 文档版本与修改认知 | 智能体版本边界、人工修订标记、任意版本比较、变更报告与负责人通知 | partial | [专项分析](../audit/2026-09-13-document-revision-management-gap-analysis.md)；[系统设计](../system-design/document-revision-management.md)；[实施方案](../remediation/2026-09-13-document-revision-management-implementation-plan.md)；[ADR](../adr/2026-09-13-document-version-boundary.md) | 决策门已冻结；Wave 0 契约起实施（00028+） | `docgov` | +| 文档版本与修改认知 | 智能体版本边界、人工修订标记、任意版本比较、变更报告与负责人通知 | partial | [test 2026-09-13](../test-reports/2026-09-13-document-revision-management-test-report.md)；[ADR](../adr/2026-09-13-document-version-boundary.md)；[实施方案](../remediation/2026-09-13-document-revision-management-implementation-plan.md) | feature 分支已交付 Wave0–6 代码；真实 PI / 双用户 Playwright / 00028 容器 migrate 待占集成槽位 | `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) | 错误卡片/任务进度/文档 busy 状态刷新恢复与人工抽检待完成 | `web` | | PI Runner / 配置链 | pi-agent + MiniMax 真实链路 | 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) | — | `pi-agent` | | 三环境运维 | dev/test/main + 共享 KB | done | [PROJECT.md](../../PROJECT.md) §4；四环境 healthy | — | `infra` | diff --git a/.doc/test-reports/2026-09-13-document-revision-management-test-report.md b/.doc/test-reports/2026-09-13-document-revision-management-test-report.md new file mode 100644 index 00000000..9f896477 --- /dev/null +++ b/.doc/test-reports/2026-09-13-document-revision-management-test-report.md @@ -0,0 +1,56 @@ +# 文档修改与版本管理（DOCREV）测试报告 + +## 一、 测试背景 (Background) + +受控文档此前仅有当前 `output.md` 与 SHA，缺少不可变快照、智能体 Version 边界、人工 Revision 留痕、可信 diff 与负责人通知。本轮按 Wave 0–6 落地 revision ledger。 + +## 二、 测试目标 (Test Objectives) + +- Version/Revision 语义与契约时间线正确 +- 黄金 diff（中文段落/表格/列表/Mermaid/移动/no-op）通过 +- 人工保存幂等、冲突、生命周期锁定 +- high/critical 候选强制二次确认 +- 自由文档 legacy 导入后人工只加 Revision +- 并发下仅一个 open Version、revision_no 连续 + +## 三、 测试方案与环境 (Test Plan & Environment) + +- OS: Linux；Go 1.27；内存 ledger（`-short`）+ 契约 fixture +- 层级：Go unit/contract（`internal/docrevision`）、freedoc 回归、bizdev 编译链接 +- 真实 PI / Playwright 全链路：需在占集成槽位后对 `agent-dev` 补录（见后续证据目录） + +## 四、 预期结果 (Expected Results) + +- T0 模板开 V1·r0；人工保存只升 revision；Agent 确认后开 V2 且人工标记归零 +- high 风险未确认 → `ErrNeedsConfirmation` +- noop 不增 snapshot；幂等键返回同一 event + +## 五、 实际测试结果与判定 (Actual Results & Evaluation) + +### 用例：契约时间线 + 黄金 diff + 并发 + +- **测试输入 (Input)**：`go test -short ./internal/docrevision/...` +- **实际输出 (Actual Output)**： + +```text +ok chat-agent-system/internal/docrevision +``` + +- **评价判定 (Evaluation / Verdict)**：PASS +- **性能与耗时 (Duration & Latency)**：约 3–10ms（短测） + +### 用例：freedoc / notification / bizdev 回归 + +- **测试输入 (Input)**：`go test -short ./internal/freedoc/... ./internal/notification/... ./internal/bizdev/...` +- **实际输出 (Actual Output)**：均 `ok` +- **评价判定 (Evaluation / Verdict)**：PASS +- **性能与耗时 (Duration & Latency)**：<2s + +## 六、 自动化测试套件汇总 (Test Suite Execution) + +本波次聚焦 DOCREV 相关包短测。全量 `go test -short ./...` 与真实 PI E2E 在合入 `dev` 占集成槽位时执行并追加本报告附件。 + +## 七、 测试结论与后续优化建议 (Conclusion & Next Steps) + +- 内核、API、前端工具条与自由文档兼容已合入 feature 分支；FEATURE-MATRIX 标 `partial→` 本轮完成后更新为 done（能力代码齐，生产灰度与真实 PI 补录仍建议在集成槽位完成）。 +- 后续：影子写 flag 灰度、`TEST_DATABASE_URL` 迁移 00028 集成测、Playwright 双用户冲突与真实 PI change_report 验收。