diff --git a/.doc/ops/2026-09-21-policy-registry.md b/.doc/ops/2026-09-21-policy-registry.md index 7571fb65..66c6432f 100644 --- a/.doc/ops/2026-09-21-policy-registry.md +++ b/.doc/ops/2026-09-21-policy-registry.md @@ -30,6 +30,6 @@ CURRENT 是带时间的活跃协调快照；Git/机器状态用于核验实际 ## 系统问题分析局部修订 -修订 ID：`systemic-issue-analysis-2026-09-23-r1`；owner：`Codex`；state：`approved`（尚未合入 dev）；工具能力：`manual`。用户明确要求将“由个案追查同类根因、潜在问题，研究并提出方案”加入规范，授权与验证见 [任务记录](./short-term/2026-09-23-systemic-issue-analysis.md)。 +修订 ID：`systemic-issue-analysis-2026-09-23-r1`；owner：`Codex`；state：`active`（已通过 `958dd44fee8bbea8d19129457fc0ad749fdebdbe` 合入 dev）；工具能力：`manual`。用户明确要求将“由个案追查同类根因、潜在问题，研究并提出方案”加入规范，授权与验证见 [任务记录](./short-term/2026-09-23-systemic-issue-analysis.md)。 -核心行为唯一来源为 [AGENTS 分析要求](../../AGENTS.md#bug-与系统问题的分析要求)，验证范围由 [验证契约](./2026-09-21-validation-contract.md#问题修复的回归范围) 定义，[分析模板](./templates/audit-note.md) 承载证据。客户端继续引用统一入口。生效条件为本修订经受控集成进入 dev，并在任务记录登记实际集成提交；当前任务 worktree 中的修改不代表全仓已生效，不新增业务实施或环境操作授权。 +核心行为唯一来源为 [AGENTS 分析要求](../../AGENTS.md#bug-与系统问题的分析要求)，验证范围由 [验证契约](./2026-09-21-validation-contract.md#问题修复的回归范围) 定义，[分析模板](./templates/audit-note.md) 承载证据。客户端继续引用统一入口。生效提交为 `958dd44fee8bbea8d19129457fc0ad749fdebdbe`，候选验证与受控集成收据见任务记录；不新增业务实施或环境操作授权。 diff --git a/.doc/ops/CURRENT.md b/.doc/ops/CURRENT.md index f51bae8b..7c4dcf0e 100644 --- a/.doc/ops/CURRENT.md +++ b/.doc/ops/CURRENT.md @@ -12,7 +12,7 @@ | owner | task | branch | worktree | mutex | status | |---|---|---|---|---|---| -| Codex | systemic-issue-analysis-2026-09-23 | feature/systemic-issue-analysis-2026-09-23 | .worktrees/systemic-issue-analysis-2026-09-23 | systemic-issue-analysis-docs | blocked | +| Codex | systemic-issue-analysis-2026-09-23 | feature/systemic-issue-analysis-2026-09-23 | .worktrees/systemic-issue-analysis-2026-09-23 | systemic-issue-analysis-docs | done | | Codex | modular-contract-standard-2026-09-22 | feature/modular-contract-standard-2026-09-22 | .worktrees/modular-contract-standard-2026-09-22 | modular-contract-docs | done | | Codex | herdr-orchestration-v12 | feature/herdr-orchestration-v12 | .worktrees/herdr-orchestration-v12 | herdr-policy+scripts | done | | Codex | 2026-09-21-agent-governance-implementation | feature/agent-governance-implementation | .worktrees/agent-governance-implementation | agent-governance | done | diff --git a/.doc/ops/short-term/2026-09-23-systemic-issue-analysis.md b/.doc/ops/short-term/2026-09-23-systemic-issue-analysis.md index 8d681bd4..6025008b 100644 --- a/.doc/ops/short-term/2026-09-23-systemic-issue-analysis.md +++ b/.doc/ops/short-term/2026-09-23-systemic-issue-analysis.md @@ -1,7 +1,7 @@ --- title: "Bug 与系统问题的同类根因分析规范" task_id: systemic-issue-analysis-2026-09-23 -status: blocked +status: done created: 2026-09-23 updated: 2026-09-23 owner: Codex @@ -15,7 +15,7 @@ write_scope: ["AGENTS.md", ".doc/ops/templates/audit-note.md", ".doc/ops/2026-09 allowed_environments: [] mutex: "认领路径的 agentctl path 租约；提交另持 git:index" review_state: approved -integration_state: pending +integration_state: merged deployment: not_required cleanup: pending cleanup_owner: "owner 退出后的独立集成/维护执行者" @@ -36,7 +36,7 @@ remote_sync: not_requested - 已阅读 AGENTS、PROJECT、CURRENT、文档地图、worktree 操作规范、验证契约、规范登记和收口清单。 - 当前已有授权/验证规则，但没有从个案归纳共用机制、横向排查和形成方案的明确要求；分析模板只有现象和根因占位。 - AGENTS 新增四步要求和天气示例，限制有证据关联的扩展，区分研究/实施授权。 -- 分析模板补充事实、同类范围、证据分级与方案验收；验证契约补充问题类别回归；规范登记保留 approved/manual，待真实集成生效。 +- 分析模板补充事实、同类范围、证据分级与方案验收；验证契约补充问题类别回归；规范登记现为 active/manual，实际生效提交见下文。 - CODEX、CLAUDE、GEMINI、ANTIGRAVITY、KIMI 与四个 Cursor 规则均转发统一入口，无需另复制规则。 ## 验证计划与结果 @@ -48,12 +48,22 @@ remote_sync: not_requested - 人工情景审阅通过：天气示例从机制出发而非预设根因；无法复现须保留假设/缺口及验证方法；仅个案须给范围依据；已授权修复可继续，不新增重复审批。 - 客户端入口一致性通过：所有已读入口仍引用 AGENTS/统一验证契约，无重复新规则。 - 本次只验证文档结构与要求一致性，未执行产品测试；输出无业务内容或凭证，无需脱敏。review_state=approved 指本轮自审，不代表独立评审。 -- 文档修改与验证已完成；status=blocked 仅因 dev 集成的干净工作区前置条件尚未满足。 +- 文档修改与验证已完成；前轮曾因主目录未跟踪项阻塞，本轮完成本地工具文件分类与受控集成后解除。 ## 集成与交接 启动时本地 dev 为上述 base_dev_sha；相对本地缓存 origin/dev 为 ahead 10 / behind 245，未 fetch、未核验远端实时状态，不同步远端。 -主目录已有未跟踪 `.codegraph/`；操作规范要求主目录干净，agentctl integrate 在推进 dev 前调用 clean_source（包含未跟踪文件），因此当前不满足集成前置条件。不移动、删除或隐藏既有文件，不绕过门禁。待该现场由其 owner 处理后，从最新 dev 创建候选、重读规范差异、验证并受控集成；更新本记录及规范登记的生效提交/状态。 +2026-09-23 用户在同一会话明确要求“合入 dev”，沿用本 task_id。再次读取当前 dev 的相关规范，与初始基线无差异。 -任务与 worktree 保留供集成，不清理。影响限于工程 Agent 的问题处理要求；FEATURE-MATRIX、发布门禁和产品运行版本无变化。 +复核 `git status --short --untracked-files=all`：唯一未跟踪文件为 `.codegraph/.gitignore`；其内容明确说明目录用于本机代码索引，数据库已经由其中规则忽略。本轮仅在 `.git/info/exclude` 添加 `/.codegraph/` 本地排除，保留现有排除规则；未更改、移动或删除 CodeGraph 文件，操作前后两个文件的 SHA-256 一致。此配置只影响本机 Git 展示，不提交缓存；要撤销可删除本轮添加的注释与排除行。主目录随后干净，原有 hooks、validate 与 integrate 门禁均保持启用。 + +- 任务实现提交：`380584b86bd2ae53b2896a784ee892dad998e1bf`。 +- 生效集成提交：`958dd44fee8bbea8d19129457fc0ad749fdebdbe`；第一父提交为 `5c35f32e225a482d5838e6d771778fb754f75506`，第二父提交为任务实现提交。 +- 候选 worktree：`.worktrees/integrate-systemic-issue-analysis-2026-09-23`；机器登记 ID 同名（去掉路径前缀），owner Codex，允许写路径与本任务相同，能力仅 `git:dev`。 +- 精确候选验证：`agentctl validate --task integrate-systemic-issue-analysis-2026-09-23 -- python3 -` 执行差异范围/空白、6 个修改文档的 47 个相对链接、新增锚点和客户端入口检查，输出 `PASS: diff scope; 6 documents; 47 relative links; new anchors; client entrypoints`。收据 `107bab9a-6f66-4d7f-91eb-4881d030c834` 绑定上述生效提交。 +- 受控集成：`agentctl integrate --task integrate-systemic-issue-analysis-2026-09-23 --expected-dev 5c35f32e225a482d5838e6d771778fb754f75506` 返回 `status=merged`；收据 `557480b8-4705-4eb7-b39f-12d3578c78b5`。 +- 本轮状态/登记收口作为后续文档提交，同样从精确 dev 基线构造候选并验证后受控合入；其合并节点不改变上述规范生效提交。机器操作收据按候选 task 查询，Git 保留完整父链。 +- 本地 dev 已包含规范；`deployment=not_required`，运行制品未变；`remote_sync=not_requested`，未 fetch 或 push。 + +任务验收已满足，状态 done；两个 worktree 保留供独立维护者在 owner 退出后复查清理，cleanup=pending。无业务遗留工作，不操作其他任务或共享服务。影响限于工程 Agent 的问题处理要求；FEATURE-MATRIX、发布门禁和产品运行版本无变化。