dsh-workplan 1.8.18 → 1.10.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,3 +1,357 @@
1
+ ## 1.10.6 — 2026-11-01
2
+
3
+ **修复:单个子任务超时后的「自动重试一次」在真实链路里是死代码;自动续跑开关默认关闭,等于从来没有打开过。**
4
+
5
+ > 用户 19:40 的原话:「超时的已分配子任务不会自动完美重试吗?这不是严重缺陷吗?」
6
+ > 上一轮 1.10.3 声称修好了,但本轮 T6 的探针实测:`CHILD_TIMEOUT` 场景
7
+ > `activationCalls=1`(策略函数返回 true,真实调度却只跑一次)。
8
+
9
+ ### 根因(两处,缺一不可)
10
+
11
+ 1. `src/runtime.ts` 里 900s 上限计时器先置 `guard.timedOut=true`,`catch` 首行
12
+ `if (guard.timedOut) break` 在调用重试策略**之前**就跳出循环;同一计时器
13
+ 还 `abort` 了 `child.controller`,于是 `isAbort` 恒真。策略正确,链路不可达。
14
+ 2. 「重试前的产物核对」在修复前是**同一瞬间读两次**(recorded / current 背靠背),
15
+ 生产环境永远不可能不一致 —— 「冲突不覆盖」只在注入假 `stat` 的测试里成立。
16
+
17
+ ### 修复
18
+
19
+ - 把重试从 `executeSubtask` 内层循环**移到 `runSubtask` 外层**(新增
20
+ `runSubtaskAttempt`),每次尝试拿一个全新的 `child controller`,不再被上一次
21
+ 的 `abort` 与 `guard.timedOut` 拦住;最多重试一次(`attemptOffset: 2` 双闸门)。
22
+ - 产物指纹改为**上限触发那一刻**取快照,重试前再读一次比对;不一致则跳过重试、
23
+ 行上写 `artifactConflict`,绝不覆盖别人刚写的文件。
24
+ - 重试前把 `CHILD_TIMEOUT` 作为 `priorFailure` 注入子 Agent 提示词,并附上
25
+ 「已在盘上的产物清单,先核对再补缺口」(1.8.19 的 resumeHint 复用)。
26
+ - **自动续跑默认开启**:`AUTO_RESUME_DEFAULTS.enabled` 由 `false` 改为 `true`,
27
+ host 侧新增 `autoResumeEnabledFrom()` 三态解析(配置 > 环境变量 > 默认开启),
28
+ `autoResume: false` 或 `DSH_WORKPLAN_AUTO_RESUME=0` 可显式关闭。
29
+ 旧实现里 `=0` 也等于「没配」,唯一结果是默认关闭 —— 这就是 1h57m 空窗的开关原因。
30
+
31
+ ### 测试
32
+
33
+ `npm test` 331 → 332 全绿;新增 `tests/workplan-auto-retry.test.ts`(2 条真实调度
34
+ 链路用例,含负控制:换回旧代码 → `2 !== 1` 失败)与 `autoResumeEnabledFrom` 的
35
+ 11 条解析用例。
36
+
37
+ ## 1.10.5 — 2026-11-01
38
+
39
+ **修复:1.10.4 漏拷 `lib/auto-resume.js`,导致插件整包加载失败(`ERR_MODULE_NOT_FOUND`)。**
40
+
41
+ > 现象(用户 19:32 重启后的终端):`dsh: warning: 1 entry did not activate`
42
+ > `dsh-workplan-plugin ... failed to import: Cannot find module
43
+ > '.../lib/auto-resume.js' imported from '.../lib/runtime.js'` —— 工作台工具在
44
+ > 该进程里全部不可用(`unknown tool "dsh_workplan_status"`)。
45
+
46
+ ### 根因
47
+
48
+ `npm run build` 用的是**写死的文件名列表** `cp dist/plan.js dist/runtime.js … lib/`。
49
+ 1.10.4 新增 `src/auto-resume.ts` 后,`tsc` 生成了 `dist/auto-resume.js`,但列表没加它,
50
+ 于是 `lib/runtime.js` 里 `import './auto-resume.js'` 在运行时解析失败。
51
+ `tsc` 与单测都发现不了:它们只编译,不按包内相对路径去解析 `lib/`。
52
+
53
+ ### 修复
54
+
55
+ - `package.json` 的 build 改为 `cp dist/*.js lib/ && cp dist/client.js client.js`——
56
+ 以后再加模块不会漏。
57
+ - 新增 `tests/build-artifacts.test.ts`(2 例):**dist 里每个 .js 都必须在 lib 有同名文件**,
58
+ 且 `client.js` 与 `dist/client.js` 字节一致。漏拷会让 `npm test` 直接红。
59
+ - 重建后 `lib/` 共 8 个 js;用真实 profile 软链 `import('~/.dsh/profiles/web/node_modules/dsh-workplan/lib/host.js')`
60
+ 实测 **HOST IMPORT OK**,导出 13 个符号。
61
+ - 全量 `npm test`:**329 pass / 0 fail**。
62
+
63
+ ## 1.10.4 — 2026-11-01
64
+
65
+ **新增:自动续跑(auto-resume)——回合结束后自己再开一轮,直到做完或命中停止码。**
66
+
67
+ > 背景:用户连问三次「超时的已分配子任务不会自动完美重试吗」「不能全面预防吗」
68
+ > 「它不会主动告诉负责人发生了什么、负责人也不能追问吗」。取证结论:插件有
69
+ > `dispatch`(4 次额度)、`followup`(无额度、保留子会话上下文)、`turn-stopping`
70
+ > 施压三种**人工**入口,唯独没有「回合结束后自己开一轮」的驱动——这是实现缺口
71
+ > (T3 定性),严重度 S2(T4,场景 A/B 均已发生,4/4 中止子会话靠人工恢复)。
72
+
73
+ ### 新增
74
+
75
+ - `src/auto-resume.ts`(新模块,纯函数):`decideAutoResume()` 判定「是否再开一轮」,
76
+ 返回唯一继续码 `SCHEDULED` 或 11 个停止码(DISABLED / NO_PLAN / CANCELLED /
77
+ SUPERSEDED / ALREADY_RUNNING / PLAN_MODE / PHASE_NOT_PAUSED / NOTHING_PENDING /
78
+ HAS_BLOCKED / BUDGET_EXHAUSTED / NO_PROGRESS);指数退避 `min(300s, 30s·2^n)`。
79
+ - `src/runtime.ts`:轮结束钩子记账 + 定时器 + 5 条撤销路径;每轮上限
80
+ `maxAttempts=2`、硬上限 4,与既有 `MAX_PLAN_RESUMES=4`(仅 blocked 修复计费、
81
+ paused 不计)**正交**。定时器 `unref()`,不会阻止进程退出。
82
+ - `src/host.ts`:开关默认**关闭**(`autoResume:true` 或 `DSH_WORKPLAN_AUTO_RESUME=1`),
83
+ 先灰度再默认开启。
84
+ - **D6 修复**:正常完成(全部 done、无 pending/blocked)的轮不再写
85
+ 「[auto-resume] 停止(PHASE_NOT_PAUSED)」噪音行。
86
+ - **D1 修复**:定时器到点后的五道复核不再裸 `return`,每个分支都写停止码
87
+ (`SCHEDULE_REVOKED_*` / `CANCELLED` / `PHASE_TERMINAL` / `PLAN_MODE` /
88
+ `PHASE_NOT_PAUSED` / `NOTHING_PENDING`),满足 I9 可见性。
89
+
90
+ ### 回归
91
+
92
+ - 新增 9 条纯函数单测(`tests/auto-resume.test.ts`)+既有套件:**327 pass / 0 fail**。
93
+ - `qa/replay_check.py` 64 项只读断言(含 T12 事故重放)通过;`design/verify_retry_patch.py` 12/12。
94
+ - 未验证:定时器跨回合真正拉起子 Agent 需 build + 重启 + 开灰度后实测(需主 Agent)。
95
+
96
+ ## 1.10.3 — 2026-11-01
97
+
98
+ **修复:单个子任务撞上 900 秒硬上限时,只要整轮预算还够再跑一次,就自动重试。**
99
+
100
+ > 背景:用户问「超时的已分配子任务不会自动完美重试吗?这不是严重缺陷吗」。
101
+ > 核对源码:`shouldRetryAttempt` 对 `CHILD_TIMEOUT` 无条件 `return false`,
102
+ > 即使整轮 20 分钟里还剩十几分钟可用也一样——于是「只是这一步慢了」被判成阻塞,
103
+ > 必须等主 Agent 人工改判或重新派发。`CHILD_STALLED`(无事件)本来就会自动重试,
104
+ > 硬超时反而不重试,口径不一致。
105
+
106
+ ### 修复
107
+
108
+ - `src/runtime.ts` `shouldRetryAttempt`:`CHILD_TIMEOUT` 改为「剩余预算 >
109
+ max(空闲窗口, 120s) 时自动重试一次」,仍然最多两次尝试(`attempt >= 2` 直接停),
110
+ 不会形成重试风暴;重试沿用 1.7.0 的「带上一次失败原因」提示词。
111
+ - 「剩余预算不足,未重试」的说明原先显式排除 `CHILD_TIMEOUT`,现已一并覆盖。
112
+ - `TOTAL_TIMEOUT`(整轮预算用光)与 `ABORTED`(有人决定停)仍**不自动重试**:
113
+ 前者重试必被同一把闸刀砍掉,后者重试等于违背决定。
114
+ - `tests/workplan-retry-feedback.test.ts`:新增两条断言(剩余 10 分钟→重试;
115
+ 第二次超时→不重试)。全量 **318 pass / 0 fail**。
116
+
117
+ ### 边界(如实)
118
+
119
+ - 这只解决「单个子任务超时」。**整轮预算耗尽仍是暂停 + 需一次续跑指令**,
120
+ 没有做「自动重新派发」——那会在用户不知情时继续消耗时间与 token。
121
+ - 若一次超时发生在整轮预算只剩 < 2 分钟,仍会直接判阻塞并写明原因。
122
+
123
+ ## 1.10.2 — 2026-11-01
124
+
125
+ **补漏:即使调用方显式传 `error`,`done` 结果也一律清空 `error`;并补一条真实渲染 A/B 回归、一道单行一致性门禁。**
126
+
127
+ > 背景:1.10.1 只在 `patch.error === undefined/null` 时清空,而回放子会话 result 的
128
+ > `done+error`、或任何显式传字符串 error 的写入,仍能把「完成 + 失败文本」写进
129
+ > 持久化记录(实测写入 `{"status":"done","error":"HOSTILE-1"}` 成立)。读侧自愈能
130
+ > 兜住展示,但记录层仍脏。本版把写入口收敛为无条件清空,旧文本先归档 `lastError`。
131
+
132
+ ### 修复
133
+
134
+ - `src/plan.ts` `applyStatus`:done 分支改为**无条件** `next.error = null`(非空文本先由
135
+ 上方逻辑归档进 `lastError/lastErrorAt`),覆盖 `applyStatus` 与 `applyResultStatuses` 两条入口。
136
+ - 新增 `tests/status-truth.test.ts` 的「显式 error 的 done 也必须清空」用例。
137
+
138
+ ### 回归
139
+
140
+ - 新增 `tests/client-done-error-render.test.ts`(4 例):用**真实 `client.js` 构建产物** +
141
+ 最小脏数据夹具渲染,并用 `DSH_WP_CLIENT_BUNDLE` 对 1.9.1 旧 bundle 做 A/B 对照
142
+ ——旧版 3 失败(done 行显示原因、无留档、文本重复)、新版 4/4 通过、pending 对照组两版都过。
143
+ - 全量 `npm test`:**318 pass / 0 fail**(1.10.1 为 313)。
144
+
145
+ ### 门禁
146
+
147
+ - `fix/progress_gate.py` 新增 **GC-08**:任一 `status=done` 的子任务归一后 `error` 非空即阻断
148
+ (不套 100% 前置条件)。自证用例 7→9(V8/V9),对真实 85% 中途快照 `_result_step_76.json`
149
+ 命中此前漏检的 T7。
150
+
151
+ ### 已知未修
152
+
153
+ - `src/client.ts:1112` `plainError` 会把含「未完成」的子任务 summary 整句改写为
154
+ 「这件事没有做完。」(首页实测 2 处误报);属独立缺陷,本版未改。
155
+
156
+ ## 1.10.1 — 2026-11-01
157
+
158
+ **修复:`done` 行残留 `error`,导致「已完成 13/13(100%)」与「卡住原因:本轮预算用尽」同屏。**
159
+
160
+ > 背景:用户截图显示 T12 子会话已中止(27 秒、无最终答复),面板侧栏却是
161
+ > 13/13 完成。根因不是百分比算错,而是同一个状态行上 `status=done` 与
162
+ > `error="本轮预算用尽,等待续跑"` 并存:`applyStatus` 的 done 分支从不清理
163
+ > `error`,改判路径又传 `undefined`(被解释为「保留旧值」),而客户端无条件
164
+ > 把 `error` 渲染成「卡住原因」。同类缺陷另见 equal-revision 二次回放、
165
+ > 分母取 `statuses.length`(写 5 行即可 100%)、`deliveryReady` 下发却无人消费。
166
+
167
+ ### 修复
168
+
169
+ - `plan.ts` `applyStatus`:`done` 时把旧 `error` 迁入 `lastError` 并清空
170
+ `error`(I12:完成的行没有「卡住原因」);显式 `error: null` 同样先留档;
171
+ 新增 `completedBy / attemptOutcome / attemptEndedAt / priorOutcome`。
172
+ - `plan.ts` `normaliseStatusEntry`:读侧迁移历史脏数据(`done+error` →
173
+ `done+lastError`),刷新即干净,不必重写会话日志。
174
+ - `plan.ts` `applyResultStatuses`:相等 `revision` 的结果快照不再二次应用
175
+ (此前每次回放把 T1–T7 各抬一级 revision)。
176
+ - `plan.ts` `deriveAggregates` / `derivePlanSnapshot`:分母改为计划定义条数
177
+ `N`,缺失行按 pending 计入;`progress` 未全部完成时封顶 99。
178
+ - `plan.ts` `aggregateInvariantViolations`:I1 改为「不得小于」并新增
179
+ I12(done 行不得带 error)、I13(进度与计数必须一致)。
180
+ - `runtime.ts` `serialisePlan`:下发时传定义条数;计划 `done/cancelled` 时把
181
+ 计划级 `errors` 归档为 `archivedErrors`,不再与 100% 同屏。
182
+ - `client.ts`:`error` 只对非 done 行渲染(blocked →「卡住原因」,
183
+ 其余 →「还没做完的原因」),done 行改为灰色「上一轮的失败记录(仅留档)」;
184
+ 新增「还不能交付」横幅,消费此前从未被读取的 `deliveryReady/deliveryBlockers`;
185
+ `100%` 需同时满足加权进度 100(`cappedPercent`)。
186
+ - `locale`:新增 `pendingReason / lastErrorNote / notDeliverable / notDeliverableHint`。
187
+ - **1.10.1 追加(DF-05,P0)**:`deliveryReadiness` 对账分母——状态明细少于计划定义时
188
+ 记为阻塞,修掉「定义 13 项、只写 5 行且全 done ⇒ `ready=true`」的放行漏洞。
189
+
190
+ ### 回归
191
+
192
+ - 新增 `tests/status-truth.test.ts`(7 例):done 清 error 并留档、读侧迁移、
193
+ I12、分母对账、I13、回放幂等、全 done 一致性。
194
+ - 全量 `npm test`:**313 pass / 0 fail**(1.9.1 为 306)。
195
+
196
+ ## 1.9.1 — 2026-11-01
197
+
198
+ **新增:`dsh_workplan_followup` —— 用户授权后,向直接子会话补发 follow-up。**
199
+
200
+ > 背景:事故夜三条子会话(`a0d5b134` / `031225ef` / `7934905a`)被整轮预算与
201
+ > 900s 上限中止,末轮 `turn/end = aborted/parent`,DSH 界面据此永远显示
202
+ > idle(灰点);台账侧它们早已是 done/structured。用户 2026-11-01 明确同意
203
+ > 「补发 follow-up,让圈注三行真正变绿」——正确做法是让子会话自己再跑完一个
204
+ > 正常回合,而不是伪造 turn/end、改投影缓存或手工刷 UI。
205
+
206
+ ### 新增
207
+
208
+ - `dsh_workplan_followup({ sessionId, message })`:调用官方
209
+ `subagents.sendMessage(agent, childId, [{type:'text',text}], {signal})`,
210
+ 把说明投递给父会话 `subagent/catalog` 里登记过的**直接**子会话。
211
+ - 只允许根会话;子 Agent 会话调用返回 `NOT_ROOT`。
212
+ - 未在 catalog 登记的目标返回 `NOT_DIRECT_CHILD`,不做猜测式投递。
213
+ - 空 message / 超过 4000 字符直接拒绝;子会话服务缺失返回
214
+ `NO_SUBAGENT_SERVICE`;投递异常返回 `DELIVERY_FAILED` 并保留原文。
215
+ - 工具只投递:不写计划状态、不触发 present、不改 `lastTurnCompleted`;
216
+ 界面是否变绿由子会话自己下一轮的 `turn/end` 决定。
217
+ - `src/runtime.ts` 新增 `followupTool`;`src/host.ts` 新增 `createFollowupTool`
218
+ 并在插件装配处注册;`tests/workplan-followup-tool.test.ts` 3 条。
219
+ - 本提交(followup 单项)`npm test` **277/277**;`npm run check` 无诊断;两次构建
220
+ 5 产物 sha256 一致。并入下方四项后的发布态为 **306/306**、7 产物一致。
221
+
222
+ ### 边界
223
+
224
+ - 本工具不是「把子任务标完成」的捷径:它不会替子会话产出交付物,也不能
225
+ 绕过 `present`/`deliveryReady` 闸门;投递后仍需核对子会话自己的回合结果。
226
+ - 目标必须是直接子会话;孙会话、同标签的其他历史会话都不在允许范围。
227
+
228
+ ### 一并发布:1.9.0 遗留的四项(superseded 写侧 / P1 拒绝码 / W1 digest / W5 联测)
229
+
230
+ > 背景:1.9.0 的「已知残余(下一批)」把四项留到下一批。本版把四项落地后与
231
+ > 1.9.1 合并为**同一个制品**发布:npm 上此前最新是 1.8.18,`1.9.0` 与 `1.9.1`
232
+ > 都从未发布到 npm,本地 `v1.9.1` 标签也从未 push(`git ls-remote --tags` 无
233
+ > `v1.9` 条目),因此 1.9.1 是用户第一个同时拿到 1.9.0、1.9.1 与四项修复的版本;
234
+ > 发布前该标签重挂到并入四项后的发布提交,标签与 npm 制品指向同一棵树。
235
+
236
+ #### superseded 写侧:唯一写入入口
237
+
238
+ - `src/supersede.ts`(新增):`supersedePlanRecord()` 是 `superseded` 的**唯一**
239
+ 写路径。写入顺序固定为「V1–V8 全量核验 → 运行时复算 `coverage`/`digest` →
240
+ `buildCancelMessage(..., { disposition:'superseded' })` 写 durable 记录 →
241
+ append 成功后内存记录才翻成 `phase='superseded'`」;任何一步失败都返回
242
+ `ok:false` + 失败码,**不改内存、不写日志**(消除「UI 说被取代、重启后说未完成」
243
+ 的 live/replay 分叉)。
244
+ - `dsh_workplan_cancel` 新增可选参数 `disposition: 'cancelled' | 'superseded'`
245
+ (缺省仍是 `cancelled`,旧调用行为不变)与 `supersededBy { planId, mapping[] }`;
246
+ `mapping` 每条含 `from`/`to`/`basis`/`evidence`,只表达映射意图,
247
+ `requiredCount`/`coveredCount`/`coverage`/`digest` 一律由运行时复算,不接受自报。
248
+ - 失败码(对外契约,按字面值断言):`SUPERSEDE_TARGET_UNKNOWN`、
249
+ `SUPERSEDE_ORDER_INVALID`、`SUPERSEDE_SOURCE_NOT_CANCELLED`、
250
+ `SUPERSEDE_SOURCE_DONE`、`SUPERSEDE_SOURCE_EMPTY`、
251
+ `SUPERSEDE_MAPPING_INCOMPLETE`、`SUPERSEDE_TARGET_ITEM_UNKNOWN`、
252
+ `SUPERSEDE_EVIDENCE_GAP`、`SUPERSEDE_TARGET_TERMINAL`、
253
+ `SUPERSEDE_NOT_CONFIRMED`、`SUPERSEDE_WRITE_FAILED`。
254
+ - 运行时侧:`superseded` 与 `cancelled` 终态互斥;自动覆盖路径**只允许**写
255
+ `cancelled`,永不写 `superseded`;被取代的计划不允许被普通取消静默改回
256
+ `cancelled`。
257
+ - 语义边界:运行时只验承接计划那一侧的机器事实(存在、时序、状态、结构化证据、
258
+ 验收、产物);「两项工作在语义上等价」是人的判断,只能由用户确认承载(V8:一条
259
+ 同时包含两个 planId 且含「确认/同意/可以/按此执行」之一的用户消息)。
260
+
261
+ #### P1 拒绝码统一(`EVIDENCE_GAP`)
262
+
263
+ - `src/plan.ts` 新增 `PRESENT_DENY_CODES` 与 `activeDenyCode()`:`remaining` 为空
264
+ 且 `blockers` 非空 ⇒ `EVIDENCE_GAP`,其余 ⇒ `ACTIVE_NOT_READY`。`present` 的
265
+ 两个未完成分支(全部 done 但证据缺口 / 仍有子任务未完成)共用同一个码值来源,
266
+ 不再各写一份判断;拒绝文案逐字保持不变,码值对外可断言。
267
+ - 门禁扫描:`EVIDENCE_GAP` 的散落字符串 **0 处**,拒绝点只引用常量或
268
+ `activeDenyCode()`。
269
+
270
+ #### W1 digest:覆盖映射摘要
271
+
272
+ - `src/supersede-digest.ts`(新增):`canonicalMappingJson()` 固定规范化口径
273
+ (对象键按 Unicode 码位升序、分隔符 `,`/`:` 无空白、非 ASCII 不转义、数组保持
274
+ 存储顺序);`computeMappingDigest()` 输出 `sha256:<64 位小写十六进制>`;
275
+ `verifyMappingDigest()` 仅在「mapping 是数组 + digest 形如 `sha256:<64hex>` +
276
+ 重算值逐字符相等」时返回 true,其余一律 false(fail-closed,调用方据此判定 stale)。
277
+ - 写入方先落盘 digest 再写信封;读取方(replay / present 复验)只重算,不信任
278
+ 缓存数值。
279
+
280
+ #### W5:真实取消信封联测
281
+
282
+ - `tests/workplan-w5-cancel-e2e.test.ts`(新增 5 例):不使用桩件,直接走真实的
283
+ `buildCancelMessage` 信封 → durable 记录 → replay 读回,覆盖 `cancelled` 与
284
+ `superseded` 两种处置的写入/读回链路与终态互斥。
285
+
286
+ #### 测试与门禁
287
+
288
+ - 四项定向共 **29 例**:`tests/workplan-supersede.test.ts` 9、
289
+ `tests/present-deny-code.test.ts` 10、`tests/supersede-digest.test.ts` 5、
290
+ `tests/workplan-w5-cancel-e2e.test.ts` 5;`tests/workplan-host.test.ts` 的
291
+ 工具参数集合断言随写侧收敛更新(1 例替换)。
292
+ - 全量 `npm test` **306/306**(1.9.0 基线 277,净增 29);`npm run check` 无诊断;
293
+ 两次构建 7 个产物字节一致;`npm pack --dry-run` 产物含 `lib/supersede.js`、
294
+ `lib/supersede-digest.js` 与对应 `src/*.ts`。
295
+
296
+ ## 1.9.0 — 2026-11-01
297
+
298
+ **修复:终态计划不再无限挡门;取消/被取代与「本回合点名」解耦;present 只硬拦本回合点名的终态计划。**
299
+
300
+ > 背景:`wp-bea31753` 被取消(0/8)后,`present` 仍把它当作「最后可判定计划」
301
+ > 硬拦;同一计划 `dispatch` 又返回 `PLAN_CANCELLED`,形成「不能交付、不能派发、
302
+ > 收尾 steer 还说两件都不能做」的双向死锁(日志 seq 7167 → 7174 → 7175)。
303
+ > 更早的 T5-C 语义把「已取消」等同「不可交付」,但 1.8.16 的全会话并集又把
304
+ > 取消计划排除在未完成集合之外——两处判断互相矛盾,正是死锁来源。
305
+
306
+ ### 修复
307
+
308
+ - `src/plan.ts` 新增 `TERMINAL_PHASES` / `isTerminalPhase`:`cancelled` 与
309
+ `superseded` 统一为终态,`reconcilePhase` 不再把终态改回 `active`。
310
+ - `src/runtime.ts`:
311
+ - `present` 的候选集合排除终态计划;终态计划只在「本回合结构化点名」时判定
312
+ (D2 硬拦不放宽),不再自动写回 live、不再永久挡门(D1)。
313
+ - 已取消计划被点名时文案逐字保留「已取消 + 完成 N/M + 不得调用 present」。
314
+ - 新增只读 `superseded` 判定:`supersededBy.successorPlanId` 缺失/终止/未就绪
315
+ ⇒ `SUPERSEDED_STALE`;承接计划就绪才放行。**写入路径(V1–V8 核验、覆盖映射、
316
+ 用户确认)不在本版**,`dsh_workplan_cancel` 仍只写 `cancelled`。
317
+ - `dispatch` 对 `superseded` 返回 `PLAN_SUPERSEDED`;`cancelled` 返回体逐字保留。
318
+ - `stopGateApplies`:终态计划不再自动触发收尾 steer(点名 `cancelled` 仍提醒一次)。
319
+ - 由 T10 产出的补丁按 `git apply` 应用:3 文件 +120/−12;`tsc --noEmit` 通过;
320
+ 更新 `tests/present-gate-evidence.test.ts` 的 A6/A8、`tests/delivery-gate.test.ts`
321
+ 与 `tests/workplan-turn-stop-gate.test.ts` 中「取消一律拒绝」的旧断言为
322
+ 「非点名放行 / 点名硬拦」;全量 **274/274**。
323
+ - 已知残余(下一批):`superseded` 写入路径、P1 `EVIDENCE_GAP` 拒绝码统一、
324
+ W1 digest 规范化、W5 replay 与真实取消信封联测、A6/A8 之外的全量回归。
325
+
326
+ ## 1.8.19 — 2026-10-31
327
+
328
+ **修复:子任务超时/整轮预算中止时,不再抹掉已落盘的产物与运行痕迹。**
329
+
330
+ > 背景(2026-10-31 缺口补齐轮):T11、T12 在 23:23:38 被 900 秒硬上限强制结束,
331
+ > 但它们的交付物在 23:22–23:23 已经落盘(T11 32,996 字节报告 + 140 行索引;
332
+ > T12 51,547 字节报告),父会话只看到「达到执行上限」,产物存在与否完全不进
333
+ > 状态;T10 在 23:07:25 被 20 分钟整轮预算中止,重置为 pending 时按设计清空
334
+ > `childId/startedAt`,卡片显示「从未开始」,用户只能问「T10 为什么自己停止」。
335
+ > 这两条路径都不探测盘上产物,重跑一次就是 15 分钟的重复劳动。
336
+
337
+ ### 修复
338
+
339
+ - `src/runtime.ts` 新增 `findSubtaskById`、`timeoutBlockedPatch`、`budgetResetError`:
340
+ - 硬超时的 `blocked` 补丁现在会探测该子任务声明的 `outputs`,把已在盘上的
341
+ 文件写进 `error`(「该步声明的产物已在盘上:…(先核对,不要当作从未运行)」)
342
+ 与 `artifacts/missingArtifacts`;判定仍是 `blocked`,不自动重试。
343
+ - 整轮预算重置的 `error` 保留上一轮 `childId`(前 8 位)、运行时长与已落盘
344
+ 产物,例如「本轮预算用尽,等待续跑;上一轮子会话 a0d5b134;运行 526s;
345
+ 声明产物已在盘上:…」;仍按设计重置为 `pending` 并可续跑。
346
+ - `src/plan.ts` 的 `buildChildPrompt` 增加 `resumeHint`:上一轮被中止且状态里
347
+ 有 `artifacts[].exists=true` 时,下一次尝试的提示词先列出这些文件,要求
348
+ read/grep 核对、已覆盖验收的部分保持原样、只补缺失部分。
349
+ - `src/host.ts` 的 `PROMPT_SECTION` 增加第 7 条:超时/预算中止不等于「什么都没
350
+ 做」,主 Agent 必须先核对盘上产物;覆盖验收标准的用 `dsh_workplan_update`
351
+ 改判,禁止无视产物整步重跑。
352
+ - 新增 `tests/timeout-artifact-evidence.test.ts` 4 条(超时产物入 error/artifacts、
353
+ 无产物不编造、预算重置保留子会话与时长、提示词续跑段),全量 **274/274**。
354
+
1
355
  ## 1.8.18 — 2026-10-31
2
356
 
3
357
  **修复:`present` 对空计划与「取消后重启」两条边界的判定,并补上已交付文件的写保护。**
package/README.en.md CHANGED
@@ -77,7 +77,7 @@ The full contract — roles, data shapes, state machine, recovery, and the three
77
77
  ## Install
78
78
 
79
79
  ```bash
80
- dsh plugin --profile web add dsh-workplan@1.8.18
80
+ dsh plugin --profile web add dsh-workplan@1.10.6
81
81
  ```
82
82
 
83
83
  Restart the DSH Web process (or reload the page) so the bundle is picked up.
package/README.md CHANGED
@@ -66,7 +66,7 @@ grep -RInE "child_process|execSync|eval\(|writeFileSync" src || echo "0 命中
66
66
  ## 一键安装
67
67
 
68
68
  ```bash
69
- dsh plugin --profile web add dsh-workplan@1.8.18
69
+ dsh plugin --profile web add dsh-workplan@1.10.6
70
70
  ```
71
71
 
72
72
  装完**重启一次 DSH Web**(或重新载入当前页面)让插件生效。
package/client.js CHANGED
@@ -75,6 +75,7 @@ window.__ModuleLoader__.load({
75
75
  "paused": "预算用完,可续跑",
76
76
  "degraded": "安排失败",
77
77
  "cancelled": "已取消",
78
+ "superseded": "已由他计划承接",
78
79
  "ended": "已结束,可续跑"
79
80
  },
80
81
  "status": {
@@ -116,6 +117,10 @@ window.__ModuleLoader__.load({
116
117
  "willDeliver": "做完交付",
117
118
  "waitFor": "要等",
118
119
  "blockedReason": "卡住原因",
120
+ "pendingReason": "还没做完的原因",
121
+ "lastErrorNote": "上一轮的失败记录(已完成,仅留档)",
122
+ "notDeliverable": "还不能交付",
123
+ "notDeliverableHint": "「全部做完」不等于「可以交付」:交付还需要每一行都有可核对的证据。下面是没有通过的部分。",
119
124
  "progressLabel": "进度",
120
125
  "more": "更多细节(不看也不影响理解)",
121
126
  "why": "为什么这样安排",
@@ -288,6 +293,10 @@ window.__ModuleLoader__.load({
288
293
  "willDeliver": "What it delivers",
289
294
  "waitFor": "Waits for",
290
295
  "blockedReason": "Why it is stuck",
296
+ "pendingReason": "Why it is not finished yet",
297
+ "lastErrorNote": "Previous attempt's failure (done, kept for the record)",
298
+ "notDeliverable": "Not deliverable yet",
299
+ "notDeliverableHint": "All rows done does not mean deliverable: every row needs checkable evidence. The gaps are listed below.",
291
300
  "progressLabel": "Progress",
292
301
  "more": "More detail (optional)",
293
302
  "why": "Why it is arranged this way",
@@ -1371,7 +1380,20 @@ window.__ModuleLoader__.load({
1371
1380
  const status = item?.status ?? 'pending';
1372
1381
  const tone = toneOfStatus(status);
1373
1382
  const pct = clampPct(item?.progress ?? 0);
1374
- return h('div', { className: `dsh-wp-subtask dsh-wp-tone-${tone}` }, h('div', { className: 'dsh-wp-subtask-head' }, h('div', { className: 'dsh-wp-subtask-title' }, `${workLabel(t, index)}:${subtask.title}`), h(Pill, { tone }, progressText(item, t))), h('div', { className: 'dsh-wp-subtask-meta' }, h('span', null, `${t('who')}:${deptName(t, subtask.department)} · ${subtask.role}`)), h('div', { className: 'dsh-wp-subtask-body' }, h('p', null, h('strong', null, `${t('what')}:`), subtask.objective), h('div', null, h('strong', null, `${t('how')}:`), h(Bullets, { items: subtask.method })), h('div', null, h('strong', null, `${t('doneWhen')}:`), h(Bullets, { items: subtask.acceptance })), subtask.outputs?.length ? h('div', null, h('strong', null, `${t('willDeliver')}:`), h(Bullets, { items: subtask.outputs })) : null, subtask.dependsOn?.length ? h('p', { className: 'dsh-wp-muted' }, `${t('waitFor')}:先等前面的工作做完,才能开始这一步。`) : null), status === 'in_progress' ? h(Progress, { value: pct, tone }) : null, status === 'in_progress' ? h('div', { className: 'dsh-wp-progress-meta' }, h('span', null, `${t('progressLabel')} ${pct}%`)) : null, status !== 'blocked' && item?.summary ? h('p', { className: 'dsh-wp-muted' }, `${t('summary')}:${plainError(item.summary)}`) : null, item?.error ? h('p', { className: 'dsh-wp-error-text' }, `${t('blockedReason')}:${plainError(item.error)}`) : null, h('details', { className: 'dsh-wp-details' }, h('summary', null, t('more')), h('div', { className: 'dsh-wp-grid', style: { marginTop: '8px' } }, h(Field, { label: t('person') }, subtask.role || '—'), h(Field, { label: t('inputs') }, h(Bullets, { items: subtask.inputs })), h(Field, { label: t('risk') }, subtask.risk || '—'), h(Field, { label: t('planId') }, subtask.id || '—'))));
1383
+ return h('div', { className: `dsh-wp-subtask dsh-wp-tone-${tone}` }, h('div', { className: 'dsh-wp-subtask-head' }, h('div', { className: 'dsh-wp-subtask-title' }, `${workLabel(t, index)}:${subtask.title}`), h(Pill, { tone }, progressText(item, t))), h('div', { className: 'dsh-wp-subtask-meta' }, h('span', null, `${t('who')}:${deptName(t, subtask.department)} · ${subtask.role}`)), h('div', { className: 'dsh-wp-subtask-body' }, h('p', null, h('strong', null, `${t('what')}:`), subtask.objective), h('div', null, h('strong', null, `${t('how')}:`), h(Bullets, { items: subtask.method })), h('div', null, h('strong', null, `${t('doneWhen')}:`), h(Bullets, { items: subtask.acceptance })), subtask.outputs?.length ? h('div', null, h('strong', null, `${t('willDeliver')}:`), h(Bullets, { items: subtask.outputs })) : null, subtask.dependsOn?.length ? h('p', { className: 'dsh-wp-muted' }, `${t('waitFor')}:先等前面的工作做完,才能开始这一步。`) : null), status === 'in_progress' ? h(Progress, { value: pct, tone }) : null, status === 'in_progress' ? h('div', { className: 'dsh-wp-progress-meta' }, h('span', null, `${t('progressLabel')} ${pct}%`)) : null, status !== 'blocked' && item?.summary ? h('p', { className: 'dsh-wp-muted' }, `${t('summary')}:${plainError(item.summary)}`) : null,
1384
+ /*
1385
+ * [1.10.0] R-02:「卡住原因」只属于没做完的行。
1386
+ *
1387
+ * 1.9.1 无条件渲染 `item.error`,只要历史记录里残留一句失败文本,就会在
1388
+ * 一行 status=done 的卡片下面写「卡住原因:本轮预算用尽…」——「已完成」
1389
+ * 与「卡住了」同屏,正是用户截图里的矛盾。数据层已经保证 done 行没有
1390
+ * error(I12),这里再做一次呈现守卫:任何历史载荷、旧缓存都不会重现。
1391
+ */
1392
+ item?.error && status !== 'done'
1393
+ ? h('p', { className: 'dsh-wp-error-text' }, `${t(status === 'blocked' ? 'blockedReason' : 'pendingReason')}:${plainError(item.error)}`)
1394
+ : null, status === 'done' && item?.lastError
1395
+ ? h('p', { className: 'dsh-wp-muted' }, `${t('lastErrorNote')}:${plainError(item.lastError)}`)
1396
+ : null, h('details', { className: 'dsh-wp-details' }, h('summary', null, t('more')), h('div', { className: 'dsh-wp-grid', style: { marginTop: '8px' } }, h(Field, { label: t('person') }, subtask.role || '—'), h(Field, { label: t('inputs') }, h(Bullets, { items: subtask.inputs })), h(Field, { label: t('risk') }, subtask.risk || '—'), h(Field, { label: t('planId') }, subtask.id || '—'))));
1375
1397
  }
1376
1398
  function StageCard({ stage, statuses, index, t }) {
1377
1399
  const byId = useMemo(() => new Map((statuses || []).map((item) => [item.subtaskId, item])), [statuses]);
@@ -1430,6 +1452,24 @@ window.__ModuleLoader__.load({
1430
1452
  function planPercent(done, total) {
1431
1453
  return total > 0 ? Math.round((done / total) * 100) : null;
1432
1454
  }
1455
+ /*
1456
+ * [1.10.0] C-11:100% 只有一个来源。
1457
+ *
1458
+ * `done/total` 是「行数」,服务端的 `stats.progress` 是「加权完成度」,
1459
+ * 二者在 12 done + 1 blocked@95 时分别是 92 与 95(T3 实测)。界面只展示
1460
+ * 一个数:行数百分比;但只要加权口径还差一点(或全部行 done 却不可交付),
1461
+ * 就不允许显示成 100——"100%" 在这一页上必须同时意味着「每行都做完」。
1462
+ */
1463
+ function cappedPercent(raw, stats) {
1464
+ if (raw === null)
1465
+ return null;
1466
+ const weighted = Number(stats?.progress);
1467
+ if (raw >= 100 && Number.isFinite(weighted) && weighted < 100)
1468
+ return 99;
1469
+ if (raw > 100)
1470
+ return 100;
1471
+ return raw;
1472
+ }
1433
1473
  // 与 groupTotals 同一套口径:先夹到 [0,total],再让「正在做/还没开始」
1434
1474
  // 吃掉剩余量,四段之和恒等于总数(构成条不会溢出或出现负宽度)。
1435
1475
  function planCounts(stats) {
@@ -1439,7 +1479,7 @@ window.__ModuleLoader__.load({
1439
1479
  const blocked = Math.min(planCount(source.blocked), total - done);
1440
1480
  const active = Math.min(planCount(source.inProgress), total - done - blocked);
1441
1481
  const pending = Math.max(0, total - done - blocked - active);
1442
- return { total, done, active, blocked, pending, percent: planPercent(done, total) };
1482
+ return { total, done, active, blocked, pending, percent: cappedPercent(planPercent(done, total), source) };
1443
1483
  }
1444
1484
  /*
1445
1485
  * [1.5.2] 完成语义的第二道保险:状态文案必须服从计数事实。
@@ -1754,7 +1794,18 @@ window.__ModuleLoader__.load({
1754
1794
  badge: h(Pill, { tone }, phaseLabel(phase, session, t)),
1755
1795
  }, session.updatedAt
1756
1796
  ? h('div', { className: 'dsh-wp-meta dsh-wp-session-updated' }, `${t('updatedAt')} ${formatTime(session.updatedAt)}`)
1757
- : null, open === true ? h(PlanOverview, { t, stats, counts, rows: stageRows }) : null, session.degraded ? h('div', { className: 'dsh-wp-banner dsh-wp-banner--degraded' }, h('strong', null, t('degraded')), h('div', null, plainError(session.error || '')), h('div', { className: 'dsh-wp-muted' }, t('degradedHint'))) : null, h(Guide, { session, t }), departments.length ? h('div', { className: 'dsh-wp-section' }, h('div', { className: 'dsh-wp-section-title' }, t('who')), h('div', { className: 'dsh-wp-departments' }, departments.map((dept) => h(Pill, { key: dept.id, tone: dept.blocked > 0 ? 'blocked' : dept.done === dept.total ? 'done' : 'active' }, `${deptName(t, dept.id)} ${dept.done}/${dept.total} ${t('stats.done')}`)))) : null, h('div', { className: 'dsh-wp-section' }, h('div', { className: 'dsh-wp-section-title' }, t('steps')), (session.stages || []).map((stage, index) => h(StageCard, {
1797
+ : null, open === true ? h(PlanOverview, { t, stats, counts, rows: stageRows }) : null, session.degraded ? h('div', { className: 'dsh-wp-banner dsh-wp-banner--degraded' }, h('strong', null, t('degraded')), h('div', null, plainError(session.error || '')), h('div', { className: 'dsh-wp-muted' }, t('degradedHint'))) : null,
1798
+ /*
1799
+ * [1.10.0] C-09:把服务端已经下发、却从来没人读的交付门禁搬上界面。
1800
+ *
1801
+ * 1.9.1 的载荷里一直带着 `deliveryReady / deliveryBlockers`(present 用的
1802
+ * 就是同一份判定),但 `client.ts` 一处都没消费。于是「13/13、100%、绿」,
1803
+ * 而 present 被拒——「进度 100% ≠ 可交付」这条事实在界面上完全不可见。
1804
+ */
1805
+ session.deliveryReady === false
1806
+ ? h('div', { className: 'dsh-wp-banner dsh-wp-banner--degraded' }, h('strong', null, t('notDeliverable')), h('div', { className: 'dsh-wp-muted' }, t('notDeliverableHint')), Array.isArray(session.deliveryBlockers) && session.deliveryBlockers.length
1807
+ ? h('ul', { className: 'dsh-wp-muted' }, session.deliveryBlockers.slice(0, 6).map((blocker, index) => h('li', { key: index }, plainError(String(blocker)))))
1808
+ : null) : null, h(Guide, { session, t }), departments.length ? h('div', { className: 'dsh-wp-section' }, h('div', { className: 'dsh-wp-section-title' }, t('who')), h('div', { className: 'dsh-wp-departments' }, departments.map((dept) => h(Pill, { key: dept.id, tone: dept.blocked > 0 ? 'blocked' : dept.done === dept.total ? 'done' : 'active' }, `${deptName(t, dept.id)} ${dept.done}/${dept.total} ${t('stats.done')}`)))) : null, h('div', { className: 'dsh-wp-section' }, h('div', { className: 'dsh-wp-section-title' }, t('steps')), (session.stages || []).map((stage, index) => h(StageCard, {
1758
1809
  key: stage.id,
1759
1810
  stage,
1760
1811
  statuses: session.statuses || [],
@@ -2301,7 +2352,7 @@ window.__ModuleLoader__.load({
2301
2352
  return {
2302
2353
  label: raw.length > 14 ? `${raw.slice(0, 14)}…` : raw,
2303
2354
  // [1.5.2] 与卡片/组头同一个百分比函数,杜绝第二套口径。
2304
- value: planPercent(planCount(session.stats?.done), planCount(session.stats?.total)) ?? 0,
2355
+ value: cappedPercent(planPercent(planCount(session.stats?.done), planCount(session.stats?.total)), session.stats) ?? 0,
2305
2356
  };
2306
2357
  }), [groups, t]);
2307
2358
  /*
@@ -383,3 +383,116 @@ assertion)。这一条尚未实施。
383
383
  - 落码后尚未在运行实例验证:补丁未提交前进程仍加载 1.8.17,活体写拒绝与
384
384
  `present` 行为要等重启后按 T7-N3 清单跑。
385
385
  - 1.8.18 与并行工程的改动共用工作树,提交时整体评审,不单独 cherry-pick。
386
+
387
+ ## 15. 1.8.19:超时与预算中止不得抹掉已落盘的产物
388
+
389
+ ### 15.1 事故(2026-10-31 23:07–23:23)
390
+
391
+ - T10(子会话 `a0d5b134…`)22:58:20 启动,23:07:25 收到
392
+ `turn/end {"kind":"aborted","reason":{"kind":"parent"}}`——这是 20 分钟整轮
393
+ 预算(`TOTAL_TIMEOUT_MS = 1200000`)的父级中止,不是模型自己停、不是完成、
394
+ 也不是工具报错。它的覆盖率产物 23:06:26 已经落盘;预算分支把状态重置为
395
+ `pending` 时按 `applyStatus` 语义清空 `childId/startedAt`,卡片于是显示
396
+ 「从未开始」。
397
+ - T11(`031225ef…`)与 T12(`7934905a…`)23:08:38 启动,23:23:38 收到
398
+ `turn/end` 的父级中止——恰好是 900 秒硬上限(`CHILD_TIMEOUT_MS = 900000`)。
399
+ T11 的 `T11_索引登记与扫描复核_20261031.md`(32,996 B)与 T12 的
400
+ `T12_缺口补齐报告_20261031.md`(51,547 B)分别在 23:22–23:23 落盘,比被杀
401
+ 早 4–60 秒;父会话只看到 `blocked / 达到执行上限`,没有任何产物线索。
402
+ - 判定:三条子任务的 deliverable 都已完整落盘,主 Agent 复核后改判
403
+ T11/T12/T13 done(wp-79fb0f9e 13/13);但「超时=什么都没做」的记账必须修。
404
+
405
+ ### 15.2 修复
406
+
407
+ - `timeoutBlockedPatch`:硬超时先把子任务声明的 `outputs` 对照磁盘,命中的
408
+ 文件写进 `error` 与 `artifacts`,未命中的进 `missingArtifacts`;判定不变。
409
+ - `budgetResetError`:预算重置的 error 保留上一轮 `childId`(前 8 位)、运行
410
+ 秒数与已落盘产物,重置后仍是 `pending`(可续跑)。
411
+ - `buildChildPrompt` 的 `resumeHint`:下一次尝试先列出上一轮已落盘产物,要求
412
+ 核对后只补缺失,不整步重写。
413
+ - `PROMPT_SECTION` 第 7 条:把「超时 ≠ 什么都没做」写成主 Agent 的硬规则。
414
+
415
+ ### 15.3 验证
416
+
417
+ - `tests/timeout-artifact-evidence.test.ts` 4 条:超时产物入 error/artifacts、
418
+ 无产物不编造、预算重置保留子会话与时长、提示词续跑段。
419
+ - `npm run check` 无诊断;`npm test` 274/274;两次构建 5 产物 sha256 一致。
420
+
421
+ ### 15.4 残余
422
+
423
+ - 900 秒上限与 20 分钟预算是策略值,未改默认;超时仍不自动重试,只保证
424
+ 「证据不丢、重试有据、提示词不重写」。
425
+ - 运行进程仍加载 1.8.18;1.8.19 的活体验证需重启后补。
426
+
427
+ ## 16. 1.9.0:终态解耦,取消/被取代不再无限挡门(2026-11-01)
428
+
429
+ ### 16.1 现象与机制
430
+
431
+ - `wp-bea31753` 被取消(0/8)后,`present` 仍把它选为「最后可判定计划」并硬拦
432
+ (`runtime.ts:3253-3261` 写回 live → `3267-3286` 拒绝);同一计划 `dispatch`
433
+ 返回 `PLAN_CANCELLED`(`2620-2635`),收尾 steer 又说两件都不能做 → 双向死锁。
434
+ 日志实例:seq 7167 cancel → 7174 present → 7175 `isError`。
435
+ - 根因是两套判断互相矛盾:1.8.13 起「已取消」仍算不可交付,1.8.16 又把取消计划
436
+ 排除出全会话未完成并集;回退分支单独把终态计划捞回来,于是取消既不能解除
437
+ 挡门、也不能派发。
438
+
439
+ ### 16.2 修复
440
+
441
+ - `TERMINAL_PHASES` / `isTerminalPhase`:`cancelled`、`superseded` 统一为终态,
442
+ `reconcilePhase` 不再把终态改回 active。
443
+ - 终态解耦(D1):终态计划不进入 present 的全局未完成集合、不自动写回 live、
444
+ 不自动触发收尾 steer;只有本回合结构化点名时才判定(D2,`cancelled` 文案
445
+ 逐字保留)。
446
+ - `superseded` 只做读取/判定/拒绝:`supersededBy.successorPlanId` 缺失、承接
447
+ 计划终止或未就绪 ⇒ `SUPERSEDED_STALE`;承接计划就绪才放行。写入路径不在本版。
448
+ - `dispatch` 对 `superseded` 返回 `PLAN_SUPERSEDED`;`cancelled` 返回体不变。
449
+
450
+ ### 16.3 语义变更(必须披露)
451
+
452
+ - 旧行为:取消一个未完成计划后,即使非本回合点名,present 也拒绝(T5-C)。
453
+ - 新行为:非本回合点名的终态计划不再阻塞交付;**取消仍然不是完成**——
454
+ 记录仍是 cancelled 0/N,本回合点名它时仍按「已取消 + 不得调用 present」硬拦。
455
+ - 理由:取消是用户叫停;让一个被叫停的计划永久堵死整个会话的交付,代价高于
456
+ 「取消后再交付」。需要「取消后仍禁止交付」的会话,应保留计划为 active 并
457
+ 用 update 补证据,而不是取消。
458
+
459
+ ### 16.4 验证与残余
460
+
461
+ - `npm run check` 无诊断;`npm test` 274/274;两次构建 5 产物 sha256 一致。
462
+ - 更新 A6/A8、delivery-gate 与 turn-stop-gate 中「取消一律拒绝」的旧断言为
463
+ 「非点名放行 / 点名硬拦」。
464
+ - 残余:`superseded` 写入路径、P1 `EVIDENCE_GAP` 拒绝码统一、W1 digest 规范化、
465
+ W5 与真实取消信封 replay 联测、活体重启验证。
466
+
467
+ ## 17. 1.9.1:为「被中止但产物已交付」的子会话补发 follow-up(2026-11-01)
468
+
469
+ ### 17.1 事实
470
+
471
+ - 事故夜三条子会话 `a0d5b134`(qa:T10)、`031225ef`(engineering:T11)、
472
+ `7934905a`(writing:T12)分别在 23:07:25 / 23:23:38 被整轮预算与 900s
473
+ 子任务上限中止;三条末轮都是 `turn/end = aborted/parent`。
474
+ - 台账侧三条早已 `done + verification=structured + acceptance 全 pass`
475
+ (durable seq 6197 / 6464 / 6471),父会话重启只回放台账
476
+ (`runtime.ts:1541`),不会改写子会话的 `turn/end`。
477
+ - DSH Web 子智能体列表只读 `subagentTiming.lastTurnCompleted`
478
+ (`dsh-client-ui-subagent/lib/client.js:203-204` 文案、`:272` 状态点),
479
+ 该字段由子会话末轮 `turn/end` 推出 ⇒ 两条数据源 3/3 冲突,界面永远灰点。
480
+
481
+ ### 17.2 处置
482
+
483
+ - 用户 2026-11-01 明确同意「补发 follow-up,让圈注三行真正变绿」(路径 A)。
484
+ - 新增 `dsh_workplan_followup`:调用官方
485
+ `subagents.sendMessage(sender, targetId, content, {signal})`。service 的语义
486
+ 是「向发送者的直接父/直接 continuable 子投递;running 目标在下一步收,
487
+ idle 目标开新一轮,缺席的直接子会话冷恢复」——正是路径 A 需要的真实
488
+ follow-up,而不是伪造记录。
489
+ - 守卫:根会话、catalog 直接子会话、message 非空且 ≤4000 字符、服务缺失/
490
+ 投递异常均显式失败;工具不写计划状态、不触发 present、不改
491
+ `lastTurnCompleted`。
492
+ - 新增 `tests/workplan-followup-tool.test.ts` 3 条;全量 277/277。
493
+
494
+ ### 17.3 边界与残余
495
+
496
+ - 补发成功 ≠ 界面变绿:必须等子会话自己跑完并 `turn/end = completed`。
497
+ - 若子会话再次被预算/上限中止,灰点保留;不得改投影缓存或手写 turn/end。
498
+ - 本版不自动补发:必须用户明确授权后由主 Agent 调用工具。