weichen/Agent-System
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(test): archive DOCREV waves and record unit evidence

Browse Source 
Update CURRENT/FEATURE-MATRIX, archive short-term tasks, and add
document-revision management test report for Wave 0–6 delivery.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
weichen
2026-09-13 06:15:20 +00:00
co-authored by Cursor
parent 9aafe7bd37
commit 4f5bde899a
6 changed files with 110 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.doc/ops/short-term/2026-09-13-document-revision-wave0-contract.md → .doc/archive/ops/2026-09-13-document-revision-wave0-contract.md
+1 -1
View File
@@ -1,6 +1,6 @@
---
title: "DOCREV Wave 0：契约冻结"
status: in_progress
status: done
created: 2026-09-13
updated: 2026-09-13
owner: Cursor
.doc/archive/ops/2026-09-13-document-revision-wave1-6-implementation.md
+45
View File
@@ -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`
.doc/ops/CURRENT.md
+6 -5
View File
@@ -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/<slug>` 或 `fix/<slug>`，**禁止** `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) |
.doc/remediation/2026-09-13-document-revision-management-implementation-plan.md
+1 -1
View File
@@ -1,6 +1,6 @@
---
title: "文档修改、智能体版本与差异认知能力实施方案"
status: in_progress
status: done
created: 2026-09-13
updated: 2026-09-13
---
.doc/status/FEATURE-MATRIX.md
+1 -1
View File
@@ -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` |
.doc/test-reports/2026-09-13-document-revision-management-test-report.md
+56
View File
@@ -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 验收。