Files
Agent-System/.doc/ops/short-term/2026-09-14-document-reliability-pilot.md
WeiCHEN e3290ebd68 docs(ops): reconcile W1-D status drift against schema 61 facts
Align sysadmin readiness reasons, FEATURE-MATRIX schema claims, CURRENT FAV wording, pseudo-done task statuses, G1/G2 exception counts, and residual gap-matrix schema notes with measured 2026-09-22 evidence without flipping production_ready.
2026-09-22 21:24:02 +08:00

4.5 KiB
Raw Permalink Blame History

title, status, created, updated, owner, branch, worktree, mutex, superseded_by
title status created updated owner branch worktree mutex superseded_by
文档可靠性纵向试点 M0–M1 done 2026-09-14 2026-09-22 Cursor refactor/document-reliability-pilot .worktrees/refactor-document-reliability-pilot docgov ./2026-09-14-document-reliability-m1-live-and-m2.md

文档可靠性纵向试点 M0–M1

W1-D 重裁(2026-09-22):本文件曾标 blocked,并以试点报告「停止扩面」禁止 U5–U12。随后证据链已超越该门禁:

  1. M1 活验报告 末句 继续 M2(刷新/跨用户/真 PI/多会话已签字);
  2. M1 活验 + 条件 M2 任务 status: done;
  3. M2 报告 末句 继续 M3;internal/workspace WorkspaceRef/Capability 已生产接线,module-boundaries.yaml unwrap_owners 含多包。

因此本任务改为 done(试点范围已关闭),不再用「停止扩面」阻挡 workspace 路径改造(G1/G2)。历史试点报告原文不改写;门禁以活验/M2 报告为准。M3+ 仍需独立授权。

目标

在不横向搬包的前提下,完成 U1–U4,使受控文档在并发提交、页面刷新、重登、restart、rebuild 和 projection 缺失后仍从数据库账本返回唯一授权正文。

范围

  • U1 架构基线与 production writer/path 门禁。
  • U2 应用 UnitOfWork 和跨属主事务能力。
  • U3 人工编辑、agent commit、批准/驳回事务化。
  • U4 授权后的文档统一读模型。
  • 项目 143 等价脱敏 hazard 与新项目真实 PI/UI 验收。

非目标

  • 不启用 FAV degraded read。
  • 不拆 chatlog/contextasm/squadrun 包。
  • 不统一错误信封,不修改 PI Runner 协议。
  • 不清理历史 dev 数据。

步骤

  1. 从最新 dev(a8f9451)创建实现分支,登记 CURRENT 并确认 docgov mutex 已释放。
  2. U1:四类规则 arch-check + archtest + 可重放基线(新违规 block)。
  3. 实现 U2,验证任意属主写入/commit 故障整体回滚。
  4. 实现 U3,删除提交后 outbox 正确性回调。
  5. 实现 U4,保证 GET 零写入和 projection 缺失不再伪装成 404。
  6. 隔离库 PG + 目标包 race 已跑;真实 PI / 浏览器 / rebuild 由后续活验任务签字。
  7. 写 test report;更新验收清单、FEATURE-MATRIX、CURRENT 和 gap-matrix。

验收标准

  • 同一 ETag 并发编辑只有一个合法赢家(内存 8 协程 + 隔离库双会话)。
  • 任一事务故障点不会留下部分提交(U2 隔离库)。
  • 项目 143 等价 hazard 和新项目刷新/重启目标 404/409/projection missing 为 0 — 由活验报告关闭(原试点未测)。
  • 服务端匿名/未知文档/跨项目/错误责任人 fail closed;浏览器跨登录 — 由活验报告关闭。
  • 1、2、4 个 app 实例的最终状态一致 — 由活验/隔离库双 pool 关闭。
  • M1 试点报告结论保留为历史「停止扩面」;活验报告结论为「继续 M2」。

相关链接

M2+ 门(历史 / 已超越)

原约束:「仅当 M1 报告最后一句为继续 M2」才开工 U5–U7;试点报告写「停止扩面」。已被活验报告「继续 M2」与 M2 任务 done 超越;不得再引用本段阻挡 workspace 路径改造。M3(含 FAV live)仍须独立审批。

证据 / 备注

隔离库与目标包 race 见 pilot test-report assets。活验与 M2 证据见上链。