|
1 | 1 | # Sync Align Tasks(同步对齐任务) |
2 | 2 |
|
| 3 | +Generated(生成时间): 2026-05-15T01:30:16+08:00 |
| 4 | +Based on(基于): `.specify/sync/proposals.json` (interactive approve, `P001`..`P007`) |
| 5 | +Approved Proposals(已批准提案): `P001`, `P002`, `P003`, `P004`, `P005`, `P006`, `P007` (Option C 见 `M007`) |
| 6 | + |
| 7 | +--- |
| 8 | + |
| 9 | +## Task P001: Align 004-3-child-slot-control/FR-001, FR-003, SC-001..SC-004 |
| 10 | + |
| 11 | +**Spec Requirement(规格需求)**: `004-3-child-slot-control` — `FR-001`, `FR-003`, `SC-001`..`SC-004` |
| 12 | + |
| 13 | +**Direction(方向)**: ALIGN(规格到代码) |
| 14 | + |
| 15 | +**Current Code(当前代码)**: `ActiveChildAttempt` 仅服务关闭流水线, `current_state` 仅返回子任务数量与是否已关闭. |
| 16 | + |
| 17 | +**Required Change(需要变更)**: 引入运行时私有 `ChildSlot` 模型, 收敛 `active_attempts`, 关闭流水线从槽位读取活动尝试, 扩展 `current_state` 返回每子任务槽位摘要, 为暂停, 恢复, 隔离, 移除与关闭结果增加槽位终态字段. |
| 18 | + |
| 19 | +**Files to Modify(需要修改的文件)**: |
| 20 | + |
| 21 | +- `src/runtime/control_loop.rs` |
| 22 | +- `src/runtime/shutdown_pipeline.rs` |
| 23 | +- `src/runtime/mod.rs` |
| 24 | +- `src/control/command.rs` |
| 25 | +- `src/shutdown/report.rs` (若公开状态形状变化) |
| 26 | +- `src/tests/supervisor_control_test.rs` 或新增 `src/tests/` 下对齐测试 |
| 27 | + |
| 28 | +**Estimated Effort(预估工作量)**: LARGE(大) |
| 29 | + |
| 30 | +### Acceptance Criteria(验收标准) |
| 31 | + |
| 32 | +- [ ] 每个声明子任务在运行时有唯一槽位视图, 含 `generation`, `attempt`, 活动句柄与预算字段中与规格一致子集. |
| 33 | +- [ ] `ShutdownTree` 关闭路径从槽位读取活动尝试, 不维护第二套并行事实源. |
| 34 | +- [ ] `current_state` 或等价查询返回每子任务摘要, 满足 `FR-003` 可测试子集. |
| 35 | +- [ ] 新增或更新测试证明槽位摘要在暂停, 运行与关闭后一致. |
| 36 | + |
| 37 | +--- |
| 38 | + |
| 39 | +## Task P002: Align 004-3-child-slot-control/FR-002 |
| 40 | + |
| 41 | +**Spec Requirement(规格需求)**: `004-3-child-slot-control` — `FR-002` |
| 42 | + |
| 43 | +**Direction(方向)**: ALIGN(规格到代码) |
| 44 | + |
| 45 | +**Current Code(当前代码)**: `pause_child`, `remove_child`, `quarantine_child` 主要 `set_child_state`, 未停止真实任务. |
| 46 | + |
| 47 | +**Required Change(需要变更)**: 暂停发取消并等待结束或超时, 隔离停止尝试并禁止自动重启, 移除停止尝试并移除或标记槽位, 重复命令幂等. |
| 48 | + |
| 49 | +**Files to Modify(需要修改的文件)**: |
| 50 | + |
| 51 | +- `src/runtime/control_loop.rs` |
| 52 | +- `src/control/command.rs` |
| 53 | +- `src/tests/supervisor_control_test.rs` |
| 54 | + |
| 55 | +**Estimated Effort(预估工作量)**: LARGE(大) |
| 56 | + |
| 57 | +### Acceptance Criteria(验收标准) |
| 58 | + |
| 59 | +- [ ] 三条命令均触发对真实 `CancellationToken` / `AbortHandle` 路径的可观察动作. |
| 60 | +- [ ] 测试断言任务在暂停, 隔离或移除后不再无约束运行. |
| 61 | +- [ ] 重复同一停止类命令返回幂等结果且无双重停止风暴. |
| 62 | + |
| 63 | +--- |
| 64 | + |
| 65 | +## Task P003: Align 004-4-generation-fencing/FR-001..FR-003, SC-001..SC-004 |
| 66 | + |
| 67 | +**Spec Requirement(规格需求)**: `004-4-generation-fencing` — `FR-001`..`FR-003`, `SC-001`..`SC-004` |
| 68 | + |
| 69 | +**Direction(方向)**: ALIGN(规格到代码) |
| 70 | + |
| 71 | +**Current Code(当前代码)**: `spawn_child_attempt` 立即 `abort` 旧尝试并启动新尝试, `record_child_exit` 未校验代际. |
| 72 | + |
| 73 | +**Required Change(需要变更)**: 统一重启流水线: 取消, 等待, 超时中止, 再升代际, 退出记录校验 `(child_id, generation, attempt)`, 旧代际迟到标 stale, `current_state` 暴露代际. |
| 74 | + |
| 75 | +**Files to Modify(需要修改的文件)**: |
| 76 | + |
| 77 | +- `src/runtime/control_loop.rs` |
| 78 | +- `src/runtime/shutdown_pipeline.rs` |
| 79 | +- `src/tests/` 下代际与重启相关集成测试 |
| 80 | + |
| 81 | +**Estimated Effort(预估工作量)**: LARGE(大) |
| 82 | + |
| 83 | +### Acceptance Criteria(验收标准) |
| 84 | + |
| 85 | +- [ ] 连续重启仅最后一代可处于运行中语义有测试覆盖. |
| 86 | +- [ ] 旧代际迟到退出不覆盖注册表中当前代际槽位. |
| 87 | +- [ ] `current_state` 或等价结构暴露 `generation` 与冲突诊断字段. |
| 88 | + |
| 89 | +--- |
| 90 | + |
| 91 | +## Task P004: Align 004-1-runtime-lifecycle-guard/FR-002, SC-002 |
| 92 | + |
| 93 | +**Spec Requirement(规格需求)**: `004-1-runtime-lifecycle-guard` — `FR-002`, `SC-002` |
| 94 | + |
| 95 | +**Direction(方向)**: ALIGN(规格到代码) |
| 96 | + |
| 97 | +**Current Code(当前代码)**: `watchdog` 主要字符串 `broadcast`, 未将 `RuntimeControlLoopFailed` 写入 `ObservabilityPipeline`. |
| 98 | + |
| 99 | +**Required Change(需要变更)**: 启动路径持有观测入口, 失败路径构造类型化事件并经 `ObservabilityPipeline::emit` 落 journal, metrics, audit, 保留字符串广播为兼容旁路. |
| 100 | + |
| 101 | +**Files to Modify(需要修改的文件)**: |
| 102 | + |
| 103 | +- `src/runtime/watchdog.rs` |
| 104 | +- `src/runtime/lifecycle.rs` 或 `Supervisor` 启动绑定 |
| 105 | +- `src/event/payload.rs` |
| 106 | +- `src/observe/pipeline.rs` |
| 107 | +- `src/observe/metrics.rs` |
| 108 | +- `src/tests/` 下控制循环失败可观测性测试 |
| 109 | + |
| 110 | +**Estimated Effort(预估工作量)**: MEDIUM(中) |
| 111 | + |
| 112 | +### Acceptance Criteria(验收标准) |
| 113 | + |
| 114 | +- [ ] 控制循环异常退出时, 测试能断言至少一条类型化监督器事件进入观测测试夹具. |
| 115 | +- [ ] metrics 或 audit 中至少一项出现与失败对应的低基数计数或事实记录. |
| 116 | + |
| 117 | +--- |
| 118 | + |
| 119 | +## Task P005: Align 004-2-real-shutdown-pipeline/FR-003 |
| 120 | + |
| 121 | +**Spec Requirement(规格需求)**: `004-2-real-shutdown-pipeline` — `FR-003` |
| 122 | + |
| 123 | +**Direction(方向)**: ALIGN(规格到代码) |
| 124 | + |
| 125 | +**Current Code(当前代码)**: `ShutdownReconcileReport` 中 journal, metrics 状态来自 `core_runtime_completed()` 默认常量. |
| 126 | + |
| 127 | +**Required Change(需要变更)**: `execute_shutdown` 各阶段发出类型化关闭事件, 对账状态由 emit 结果或流水线可观测状态推导, 套接字保持 `NotOwned`. |
| 128 | + |
| 129 | +**Files to Modify(需要修改的文件)**: |
| 130 | + |
| 131 | +- `src/runtime/control_loop.rs` |
| 132 | +- `src/shutdown/report.rs` |
| 133 | +- `src/event/payload.rs` |
| 134 | +- `src/observe/pipeline.rs` |
| 135 | +- `src/tests/supervisor_real_shutdown_pipeline_test.rs` |
| 136 | + |
| 137 | +**Estimated Effort(预估工作量)**: MEDIUM(中) |
| 138 | + |
| 139 | +### Acceptance Criteria(验收标准) |
| 140 | + |
| 141 | +- [ ] 测试或观测夹具证明关闭完成路径上 journal, metrics 状态非无条件 `Recorded` 盲填. |
| 142 | +- [ ] 契约测试仍通过, 且不引入 compatibility export. |
| 143 | + |
| 144 | +--- |
| 145 | + |
| 146 | +## Task P006: Align 003-supervisor-dashboard/SC-003, SC-012 |
| 147 | + |
| 148 | +**Spec Requirement(规格需求)**: `003-supervisor-dashboard` — `SC-003`, `SC-012` |
| 149 | + |
| 150 | +**Direction(方向)**: ALIGN(规格到代码, 跨仓) |
| 151 | + |
| 152 | +**Current Code(当前代码)**: `specs/003-supervisor-dashboard/tasks.md` 中 `T066` 等仍未闭合. |
| 153 | + |
| 154 | +**Required Change(需要变更)**: 在相邻 `rust-supervisor-ui` 仓库实现 Playwright 定位验收与 `package.json` / `src` 下无 React 组件体系证明. |
| 155 | + |
| 156 | +**Files to Modify(需要修改的文件)**: |
| 157 | + |
| 158 | +- `../rust-supervisor-ui/` (仓库根与 `tests/` 或 CI 配置, 本任务不强制修改当前主仓) |
| 159 | +- `specs/003-supervisor-dashboard/tasks.md` (闭合勾选与证据链接) |
| 160 | + |
| 161 | +**Estimated Effort(预估工作量)**: LARGE(大) |
| 162 | + |
| 163 | +### Acceptance Criteria(验收标准) |
| 164 | + |
| 165 | +- [ ] `T066` 及相关成功标准在 `tasks.md` 可勾选并附运行命令或 CI 链接. |
| 166 | +- [ ] 自动化脚本证明无 React 运行时依赖与无 `.tsx`/`.jsx` 业务源码. |
| 167 | + |
| 168 | +--- |
| 169 | + |
| 170 | +## Task M007: Apply P007 Option C — drift supersession index |
| 171 | + |
| 172 | +**Spec Requirement(规格需求)**: 工作流元任务 — `001-create-supervisor-core` 宽口径条款与 `004` 系列关系 |
| 173 | + |
| 174 | +**Direction(方向)**: META(元, 不改 `001` 正文) |
| 175 | + |
| 176 | +**Current Code(当前代码)**: 无代码变更. |
| 177 | + |
| 178 | +**Required Change(需要变更)**: 维护 `.specify/sync/drift-supersession.md`, 并在下次 `speckit.sync.analyze` 人工 triage 或脚本增强时引用该表, 将表中左列需求在已选右列规格活跃时的漂移标为 **SUPERSEDED**. |
| 179 | + |
| 180 | +**Files to Modify(需要修改的文件)**: |
| 181 | + |
| 182 | +- `.specify/sync/drift-supersession.md` (已创建, 后续迭代补行) |
| 183 | +- 可选: 生成 `drift-report` 的脚本或技能说明 |
| 184 | + |
| 185 | +**Estimated Effort(预估工作量)**: SMALL(小) |
| 186 | + |
| 187 | +### Acceptance Criteria(验收标准) |
| 188 | + |
| 189 | +- [ ] 评审承认 `001` 正文未改, 但同步工作流有可查 supersession 表. |
| 190 | +- [ ] `apply-report` 与本任务交叉引用一致. |
| 191 | + |
| 192 | +--- |
| 193 | + |
| 194 | +以下为历史 apply 产物 (2026-05-08), 其中绝对路径可能指向旧工作区克隆, **保留供审计**, 不作为当前仓库路径规范. |
| 195 | + |
| 196 | +--- |
| 197 | + |
| 198 | +## Historical: 2026-05-08 apply(历史应用) |
| 199 | + |
3 | 200 | Generated(生成时间): 2026-05-08T01:55:02+08:00 |
4 | 201 | Based on(基于): `.specify/sync/proposals.json` |
5 | 202 | Approved Proposals(已批准提案): `P001`, `P002` |
6 | 203 |
|
7 | | -## Task A001: Align 001-create-supervisor-core/FR-063 |
| 204 | +### Task A001: Align 001-create-supervisor-core/FR-063 |
8 | 205 |
|
9 | 206 | **Spec Requirement(规格需求)**: `FR-063` |
10 | 207 |
|
@@ -70,7 +267,7 @@ Approved Proposals(已批准提案): `P001`, `P002` |
70 | 267 | - [X] 003 dashboard(看板) spec(规格), plan(计划), data model(数据模型), task(任务) 和 contract(契约) 文档全部改为 state(状态) 语义. |
71 | 268 | - [X] 不新增 compatibility export(兼容导出), 历史别名或旧协议别名. |
72 | 269 |
|
73 | | -## Task A002: Align 001-create-supervisor-core/SC-031 |
| 270 | +### Task A002: Align 001-create-supervisor-core/SC-031 |
74 | 271 |
|
75 | 272 | **Spec Requirement(规格需求)**: `SC-031` |
76 | 273 |
|
|
0 commit comments