fix(agentctl): converge automation into w4 and drop fork

Port deploy phase transition guards and cleanup markdown projection into agentctl_w4, delete the unused automation module, and pin illegal jumps with a regression test.
2026-09-23 14:39:49 +08:00
parent 21c1278c04
commit dd75f42c98
4 changed files with 127 additions and 413 deletions
@@ -0,0 +1,70 @@
+---
+title: "W1-U1r：agentctl automation 归一"
+task_id: agentctl-automation-converge-2026-09-23
+status: in_progress
+created: 2026-09-23
+updated: 2026-09-23
+owner: Cursor
+task_type: implementation
+task_tier: single
+policy_revision: "agent-governance-2026-09-21-r1 @ 21c1278c04566f90230c6e354121041f2c020214"
+branch: fix/agentctl-automation-converge-2026-09-23
+worktree: .worktrees/agentctl-automation-converge-2026-09-23
+base_dev_sha: "21c1278c04566f90230c6e354121041f2c020214"
+write_scope: ["scripts", ".doc"]
+allowed_environments: []
+mutex: agentctl-automation-converge
+review_state: pending
+integration_state: pending
+deployment: not_required
+cleanup: pending
+cleanup_owner: "独立维护者"
+cleanup_trigger: "合入 local_dev 且无进程占用后复查"
+remote_sync: not_requested
+---
+
+# W1-U1r：agentctl automation 归一
+
+## 用户目标与授权
+
+- 用户目标：删除分叉 `scripts/agentctl_automation.py`，移植部署阶段转移校验与 cleanup Markdown 投影到 `agentctl_w4.py`。
+- 授权：W1 波次实施计划 U1r；write_scope=`scripts`（+ short-term/CURRENT）；不 push。
+- 交付终点：代码合入 local_dev；五态可审。
+
+## 移植与丢弃
+
+### 已移植
+
+- `deployment_set_phase` 合法转移边（`prepared→deploying→accepting→passed`；非法 `passed→deploying` 拒绝）。
+- `project_cleanup_markdown` → `agentctl_w4.py`（供 W2-U5）。
+
+### 已丢弃（检索证据）
+
+| 符号 | 取代方 / 原因 |
+|---|---|
+| `assess_cleanup_entry` | `agentctl.py` `cleanup_status` 8 gate |
+| `process_platform_ready` | W1-B macOS 进程层三值 `alive_status` |
+| `build_command_for_job` | 无调用方的 `*-proxy` 占位 |
+| automation `jobs` schema | W4 `jobs` 已 landed |
+| `operations` / `doc_registry` 表 | 活库 `.tables` 无此二者 |
+
+`DEFAULT_DOC_REGISTRY` per-doc 规则不在本包移植，交 U2 策略 JSON。
+
+## 步骤与验收
+
+1. [x] worktree + register + CURRENT 认领
+2. [x] 移植 phase 校验与 `project_cleanup_markdown`
+3. [x] 删除 `agentctl_automation.py`；`rg agentctl_automation` 为空；清理 0 字节 `.locks/state.db`
+4. [x] 补 `test_deploy_phase_transition_rejects_illegal_jump`；`unittest discover` 104 ran / 2 skipped / OK
+5. [ ] 原子提交 + 候选 validate/integrate
+
+## 验证与证据
+
+| 范围 | 命令 | 结果 |
+|---|---|---|
+| 全套治理脚本 | `python3 -B -m unittest discover -s scripts/tests -p 'test_*.py' -v` | Ran 104 / OK (skipped=2) |
+
+## 相关链接
+
+- [实施承接计划](../../remediation/2026-09-23-coordination-db-daemon-implementation-undertaking-plan.md)
+- [W1 实施计划](file:///Users/weichen/.cursor/plans/w1_三包实施_43ec5550.plan.md)