diff --git a/.doc/ops/short-term/2026-09-22-modular-contract-standard.md b/.doc/ops/short-term/2026-09-22-modular-contract-standard.md index f06951cd..a76e4afb 100644 --- a/.doc/ops/short-term/2026-09-22-modular-contract-standard.md +++ b/.doc/ops/short-term/2026-09-22-modular-contract-standard.md @@ -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 退出后核对祖先、忽略文件、进程和唯一产物，再决定清理。