docs(ops): record verified dev integration and evidence archive

This commit is contained in:
weichen
2026-09-22 13:09:27 +00:00
parent 9814a67ee6
commit 4f6ec3ed4d
@@ -15,7 +15,7 @@ write_scope: [".doc/ops/short-term/2026-09-22-modular-contract-standard.md", ".d
allowed_environments: []
mutex: "path:本任务四份文档;CURRENT 使用行级 CAS"
review_state: approved
integration_state: pending
integration_state: merged
deployment: not_required
cleanup: retained-with-reason
cleanup_owner: 独立维护者
@@ -29,7 +29,7 @@ remote_sync: not_requested
2026-09-22 用户要求:“梳理当前系统,看系统的多模块、功能之间的解耦做的如何,并制定规范(和本项目无关的通用规范)”,重点为统一封装、HTTP/Socket/IPC/RPC 通信、接口契约、总线调度、并发数据完整性和幂等,并形成设计规划。交付终点是可审研究与规范草案。允许隔离任务区写文档、只读源码与官方资料检索;不实施业务代码、不部署、不操作数据库、不 push。
本次是跨项目标准的新研究任务,引用 2026-09-20 项目专用审查作为输入,不代替原 A–G 整改任务、不改变现行 ADR。用户 AGENTS 指定的 .doc taxonomy 优先于技能默认 docs/plans 目录。共享主目录原有三项未跟踪 promotion receipts 保留。
本次是跨项目标准的新研究任务,引用 2026-09-20 项目专用审查作为输入,不代替原 A–G 整改任务、不改变现行 ADR。用户 AGENTS 指定的 .doc taxonomy 优先于技能默认 docs/plans 目录。研究阶段保留共享主目录原有三项未跟踪 promotion receipts;后续经用户确认归档,见集成结果。
## 产物与步骤
@@ -60,7 +60,7 @@ remote_sync: not_requested
| 稳定 ID | Python 检查规范 MCS-01–22 与计划 U1–U8 | 唯一且完整 |
| 差异 | git diff --check;git diff -- .doc/ops/CURRENT.md | 无空白错误;CURRENT 仅本任务行,使用 CAS 收据 |
| 运行与业务 | Go/arch-check/PG/PI/浏览器/部署 | 本次不适用,未执行;不报告产品 PASS |
| 主目录 | git rev-parse dev 与 git status --short | dev 仍为基线 SHA,原三项未跟踪 promotion receipts 保留 |
| 研究阶段主目录 | git rev-parse dev 与 git status --short | 当时 dev 为基线 SHA,原三项未跟踪 promotion receipts 保留;后续结果见集成节 |
所有新增文件也由 Python 检查,避免 git diff --check 不覆盖 untracked 的盲区。只保存源码定位、文档检查结果与公开官方资料链接,不保存业务正文、秘密或环境值。
@@ -87,7 +87,7 @@ remote_sync: not_requested
### 交接
- 影响:新增三份研究/规范/规划文档与本任务记录;CURRENT 仅任务 worktree 内本任务认领行;不改业务、原生效规范、FEATURE-MATRIX 或 gap-matrix。
- 影响:新增三份研究/规范/规划文档与本任务记录;CURRENT 仅本任务认领行,经受控集成进入 dev;不改业务、原生效规范、FEATURE-MATRIX 或 gap-matrix。
- 本地保存:研究完成时文档未提交;后续用户授权本地 dev 集成,执行状态与证据见下节。
- 部署:not_required;运行制品未检查、未修改。
- 远端:not_requested,未 fetch/push;创建时 local tracking 比较 0/6,不能代表实时远端。
@@ -103,3 +103,17 @@ remote_sync: not_requested
候选执行登记 integrate-modular-contract-standard-2026-09-22,分支 feature/integrate-modular-contract-standard-2026-09-22,同名 .worktrees 路径,scope 为本任务五文档,能力仅 git:dev。从上述确切 dev 创建 --no-ff 候选;冻结 SHA 由 Git merge 父节点及 agentctl validate/integrate 收据记录。验证为文件白名单、相对链接、ID、内容哈希、CURRENT 单行差异与 git diff --check;普通文档无须 Go/PI 或容器重建。
集成前障碍:主目录保留三项非本任务未跟踪 promotion-receipts,clean_source 对集成不适用构建证据例外。按 AGENTS 不擅自移动他人未提交文件;先完成可审候选,再处理该障碍,不绕过 hooks 或清洁检查。
### 集成结果与证据归档
用户在针对三项未跟踪证据的明确归档请求后回复“继续”,授权按原样归档、校验后继续集成。归档前再次核实 dev 基线、三个对象清单及此前计算的清单摘要,无变化;以同文件系统 rename 保留原文件,归档后逐个核对 11 个文件的大小和 SHA-256,合计 16960 字节。未读取或修改 .env。
- 本地文档提交:9814a67ee61dd97a31b104135c354f3ac0850bfc。
- 首次集成候选/实际 dev 合入:3f89eff70af427cbf3649b6d079a03ebfc2c65e2;父节点为原 dev 基线及上述文档提交。
- 候选验证收据:9e10402e-ce43-4a5e-a421-d01fc471b568,8 条本地链接、3 份核心文档哈希、22 条规则、8 个单元、五文件白名单与 CURRENT 单行差异通过。
- 原样归档收据:a1aec604-dd4c-4d5a-b84d-abe6fb0e044a。完整清单及原路径映射位于主仓 .locks/evidence-archive/modular-contract-standard-2026-09-22/manifest.json;三个对象和 11 个原始文件均实际保存在同目录,不只记录旧路径。
- 受控集成收据:c84f146c-8c05-4f9c-bc5f-b4aafef6b808,status=merged。主目录以 --ff-only 接收已验证的 --no-ff 候选,未绕过门禁。
- 本节是首次成功集成后的收口记录,另作纯文档提交,通过同一候选工作区从 3f89eff7 基线构造新 --no-ff 节点并重新验证后集成;最终提交由 Git 历史及机器收据定位,避免自引用 SHA。
- 原证据恢复:确有原路径消费者需要且目标路径不存在时,由后续获授权维护者依据 manifest 复制/移回并校验;不得覆盖后续新生成证据。归档不改变这些旧证据的测试结论。
- 未 push,未 fetch,未部署/重启。当前读取到的 origin/dev 跟踪引用已与上轮不同,未将其并入本次本地 dev;不声称已与远端同步。
- 任务/候选 worktree 保留;本次不执行清理。独立维护者待 owner 退出后核对祖先、忽略文件、进程和唯一产物,再决定清理。