dsh-workplan 1.8.4 → 1.9.1

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,689 @@
1
+ ## 1.9.1 — 2026-11-01
2
+
3
+ **新增:`dsh_workplan_followup` —— 用户授权后,向直接子会话补发 follow-up。**
4
+
5
+ > 背景:事故夜三条子会话(`a0d5b134` / `031225ef` / `7934905a`)被整轮预算与
6
+ > 900s 上限中止,末轮 `turn/end = aborted/parent`,DSH 界面据此永远显示
7
+ > idle(灰点);台账侧它们早已是 done/structured。用户 2026-11-01 明确同意
8
+ > 「补发 follow-up,让圈注三行真正变绿」——正确做法是让子会话自己再跑完一个
9
+ > 正常回合,而不是伪造 turn/end、改投影缓存或手工刷 UI。
10
+
11
+ ### 新增
12
+
13
+ - `dsh_workplan_followup({ sessionId, message })`:调用官方
14
+ `subagents.sendMessage(agent, childId, [{type:'text',text}], {signal})`,
15
+ 把说明投递给父会话 `subagent/catalog` 里登记过的**直接**子会话。
16
+ - 只允许根会话;子 Agent 会话调用返回 `NOT_ROOT`。
17
+ - 未在 catalog 登记的目标返回 `NOT_DIRECT_CHILD`,不做猜测式投递。
18
+ - 空 message / 超过 4000 字符直接拒绝;子会话服务缺失返回
19
+ `NO_SUBAGENT_SERVICE`;投递异常返回 `DELIVERY_FAILED` 并保留原文。
20
+ - 工具只投递:不写计划状态、不触发 present、不改 `lastTurnCompleted`;
21
+ 界面是否变绿由子会话自己下一轮的 `turn/end` 决定。
22
+ - `src/runtime.ts` 新增 `followupTool`;`src/host.ts` 新增 `createFollowupTool`
23
+ 并在插件装配处注册;`tests/workplan-followup-tool.test.ts` 3 条。
24
+ - 本提交(followup 单项)`npm test` **277/277**;`npm run check` 无诊断;两次构建
25
+ 5 产物 sha256 一致。并入下方四项后的发布态为 **306/306**、7 产物一致。
26
+
27
+ ### 边界
28
+
29
+ - 本工具不是「把子任务标完成」的捷径:它不会替子会话产出交付物,也不能
30
+ 绕过 `present`/`deliveryReady` 闸门;投递后仍需核对子会话自己的回合结果。
31
+ - 目标必须是直接子会话;孙会话、同标签的其他历史会话都不在允许范围。
32
+
33
+ ### 一并发布:1.9.0 遗留的四项(superseded 写侧 / P1 拒绝码 / W1 digest / W5 联测)
34
+
35
+ > 背景:1.9.0 的「已知残余(下一批)」把四项留到下一批。本版把四项落地后与
36
+ > 1.9.1 合并为**同一个制品**发布:npm 上此前最新是 1.8.18,`1.9.0` 与 `1.9.1`
37
+ > 都从未发布到 npm,本地 `v1.9.1` 标签也从未 push(`git ls-remote --tags` 无
38
+ > `v1.9` 条目),因此 1.9.1 是用户第一个同时拿到 1.9.0、1.9.1 与四项修复的版本;
39
+ > 发布前该标签重挂到并入四项后的发布提交,标签与 npm 制品指向同一棵树。
40
+
41
+ #### superseded 写侧:唯一写入入口
42
+
43
+ - `src/supersede.ts`(新增):`supersedePlanRecord()` 是 `superseded` 的**唯一**
44
+ 写路径。写入顺序固定为「V1–V8 全量核验 → 运行时复算 `coverage`/`digest` →
45
+ `buildCancelMessage(..., { disposition:'superseded' })` 写 durable 记录 →
46
+ append 成功后内存记录才翻成 `phase='superseded'`」;任何一步失败都返回
47
+ `ok:false` + 失败码,**不改内存、不写日志**(消除「UI 说被取代、重启后说未完成」
48
+ 的 live/replay 分叉)。
49
+ - `dsh_workplan_cancel` 新增可选参数 `disposition: 'cancelled' | 'superseded'`
50
+ (缺省仍是 `cancelled`,旧调用行为不变)与 `supersededBy { planId, mapping[] }`;
51
+ `mapping` 每条含 `from`/`to`/`basis`/`evidence`,只表达映射意图,
52
+ `requiredCount`/`coveredCount`/`coverage`/`digest` 一律由运行时复算,不接受自报。
53
+ - 失败码(对外契约,按字面值断言):`SUPERSEDE_TARGET_UNKNOWN`、
54
+ `SUPERSEDE_ORDER_INVALID`、`SUPERSEDE_SOURCE_NOT_CANCELLED`、
55
+ `SUPERSEDE_SOURCE_DONE`、`SUPERSEDE_SOURCE_EMPTY`、
56
+ `SUPERSEDE_MAPPING_INCOMPLETE`、`SUPERSEDE_TARGET_ITEM_UNKNOWN`、
57
+ `SUPERSEDE_EVIDENCE_GAP`、`SUPERSEDE_TARGET_TERMINAL`、
58
+ `SUPERSEDE_NOT_CONFIRMED`、`SUPERSEDE_WRITE_FAILED`。
59
+ - 运行时侧:`superseded` 与 `cancelled` 终态互斥;自动覆盖路径**只允许**写
60
+ `cancelled`,永不写 `superseded`;被取代的计划不允许被普通取消静默改回
61
+ `cancelled`。
62
+ - 语义边界:运行时只验承接计划那一侧的机器事实(存在、时序、状态、结构化证据、
63
+ 验收、产物);「两项工作在语义上等价」是人的判断,只能由用户确认承载(V8:一条
64
+ 同时包含两个 planId 且含「确认/同意/可以/按此执行」之一的用户消息)。
65
+
66
+ #### P1 拒绝码统一(`EVIDENCE_GAP`)
67
+
68
+ - `src/plan.ts` 新增 `PRESENT_DENY_CODES` 与 `activeDenyCode()`:`remaining` 为空
69
+ 且 `blockers` 非空 ⇒ `EVIDENCE_GAP`,其余 ⇒ `ACTIVE_NOT_READY`。`present` 的
70
+ 两个未完成分支(全部 done 但证据缺口 / 仍有子任务未完成)共用同一个码值来源,
71
+ 不再各写一份判断;拒绝文案逐字保持不变,码值对外可断言。
72
+ - 门禁扫描:`EVIDENCE_GAP` 的散落字符串 **0 处**,拒绝点只引用常量或
73
+ `activeDenyCode()`。
74
+
75
+ #### W1 digest:覆盖映射摘要
76
+
77
+ - `src/supersede-digest.ts`(新增):`canonicalMappingJson()` 固定规范化口径
78
+ (对象键按 Unicode 码位升序、分隔符 `,`/`:` 无空白、非 ASCII 不转义、数组保持
79
+ 存储顺序);`computeMappingDigest()` 输出 `sha256:<64 位小写十六进制>`;
80
+ `verifyMappingDigest()` 仅在「mapping 是数组 + digest 形如 `sha256:<64hex>` +
81
+ 重算值逐字符相等」时返回 true,其余一律 false(fail-closed,调用方据此判定 stale)。
82
+ - 写入方先落盘 digest 再写信封;读取方(replay / present 复验)只重算,不信任
83
+ 缓存数值。
84
+
85
+ #### W5:真实取消信封联测
86
+
87
+ - `tests/workplan-w5-cancel-e2e.test.ts`(新增 5 例):不使用桩件,直接走真实的
88
+ `buildCancelMessage` 信封 → durable 记录 → replay 读回,覆盖 `cancelled` 与
89
+ `superseded` 两种处置的写入/读回链路与终态互斥。
90
+
91
+ #### 测试与门禁
92
+
93
+ - 四项定向共 **29 例**:`tests/workplan-supersede.test.ts` 9、
94
+ `tests/present-deny-code.test.ts` 10、`tests/supersede-digest.test.ts` 5、
95
+ `tests/workplan-w5-cancel-e2e.test.ts` 5;`tests/workplan-host.test.ts` 的
96
+ 工具参数集合断言随写侧收敛更新(1 例替换)。
97
+ - 全量 `npm test` **306/306**(1.9.0 基线 277,净增 29);`npm run check` 无诊断;
98
+ 两次构建 7 个产物字节一致;`npm pack --dry-run` 产物含 `lib/supersede.js`、
99
+ `lib/supersede-digest.js` 与对应 `src/*.ts`。
100
+
101
+ ## 1.9.0 — 2026-11-01
102
+
103
+ **修复:终态计划不再无限挡门;取消/被取代与「本回合点名」解耦;present 只硬拦本回合点名的终态计划。**
104
+
105
+ > 背景:`wp-bea31753` 被取消(0/8)后,`present` 仍把它当作「最后可判定计划」
106
+ > 硬拦;同一计划 `dispatch` 又返回 `PLAN_CANCELLED`,形成「不能交付、不能派发、
107
+ > 收尾 steer 还说两件都不能做」的双向死锁(日志 seq 7167 → 7174 → 7175)。
108
+ > 更早的 T5-C 语义把「已取消」等同「不可交付」,但 1.8.16 的全会话并集又把
109
+ > 取消计划排除在未完成集合之外——两处判断互相矛盾,正是死锁来源。
110
+
111
+ ### 修复
112
+
113
+ - `src/plan.ts` 新增 `TERMINAL_PHASES` / `isTerminalPhase`:`cancelled` 与
114
+ `superseded` 统一为终态,`reconcilePhase` 不再把终态改回 `active`。
115
+ - `src/runtime.ts`:
116
+ - `present` 的候选集合排除终态计划;终态计划只在「本回合结构化点名」时判定
117
+ (D2 硬拦不放宽),不再自动写回 live、不再永久挡门(D1)。
118
+ - 已取消计划被点名时文案逐字保留「已取消 + 完成 N/M + 不得调用 present」。
119
+ - 新增只读 `superseded` 判定:`supersededBy.successorPlanId` 缺失/终止/未就绪
120
+ ⇒ `SUPERSEDED_STALE`;承接计划就绪才放行。**写入路径(V1–V8 核验、覆盖映射、
121
+ 用户确认)不在本版**,`dsh_workplan_cancel` 仍只写 `cancelled`。
122
+ - `dispatch` 对 `superseded` 返回 `PLAN_SUPERSEDED`;`cancelled` 返回体逐字保留。
123
+ - `stopGateApplies`:终态计划不再自动触发收尾 steer(点名 `cancelled` 仍提醒一次)。
124
+ - 由 T10 产出的补丁按 `git apply` 应用:3 文件 +120/−12;`tsc --noEmit` 通过;
125
+ 更新 `tests/present-gate-evidence.test.ts` 的 A6/A8、`tests/delivery-gate.test.ts`
126
+ 与 `tests/workplan-turn-stop-gate.test.ts` 中「取消一律拒绝」的旧断言为
127
+ 「非点名放行 / 点名硬拦」;全量 **274/274**。
128
+ - 已知残余(下一批):`superseded` 写入路径、P1 `EVIDENCE_GAP` 拒绝码统一、
129
+ W1 digest 规范化、W5 replay 与真实取消信封联测、A6/A8 之外的全量回归。
130
+
131
+ ## 1.8.19 — 2026-10-31
132
+
133
+ **修复:子任务超时/整轮预算中止时,不再抹掉已落盘的产物与运行痕迹。**
134
+
135
+ > 背景(2026-10-31 缺口补齐轮):T11、T12 在 23:23:38 被 900 秒硬上限强制结束,
136
+ > 但它们的交付物在 23:22–23:23 已经落盘(T11 32,996 字节报告 + 140 行索引;
137
+ > T12 51,547 字节报告),父会话只看到「达到执行上限」,产物存在与否完全不进
138
+ > 状态;T10 在 23:07:25 被 20 分钟整轮预算中止,重置为 pending 时按设计清空
139
+ > `childId/startedAt`,卡片显示「从未开始」,用户只能问「T10 为什么自己停止」。
140
+ > 这两条路径都不探测盘上产物,重跑一次就是 15 分钟的重复劳动。
141
+
142
+ ### 修复
143
+
144
+ - `src/runtime.ts` 新增 `findSubtaskById`、`timeoutBlockedPatch`、`budgetResetError`:
145
+ - 硬超时的 `blocked` 补丁现在会探测该子任务声明的 `outputs`,把已在盘上的
146
+ 文件写进 `error`(「该步声明的产物已在盘上:…(先核对,不要当作从未运行)」)
147
+ 与 `artifacts/missingArtifacts`;判定仍是 `blocked`,不自动重试。
148
+ - 整轮预算重置的 `error` 保留上一轮 `childId`(前 8 位)、运行时长与已落盘
149
+ 产物,例如「本轮预算用尽,等待续跑;上一轮子会话 a0d5b134;运行 526s;
150
+ 声明产物已在盘上:…」;仍按设计重置为 `pending` 并可续跑。
151
+ - `src/plan.ts` 的 `buildChildPrompt` 增加 `resumeHint`:上一轮被中止且状态里
152
+ 有 `artifacts[].exists=true` 时,下一次尝试的提示词先列出这些文件,要求
153
+ read/grep 核对、已覆盖验收的部分保持原样、只补缺失部分。
154
+ - `src/host.ts` 的 `PROMPT_SECTION` 增加第 7 条:超时/预算中止不等于「什么都没
155
+ 做」,主 Agent 必须先核对盘上产物;覆盖验收标准的用 `dsh_workplan_update`
156
+ 改判,禁止无视产物整步重跑。
157
+ - 新增 `tests/timeout-artifact-evidence.test.ts` 4 条(超时产物入 error/artifacts、
158
+ 无产物不编造、预算重置保留子会话与时长、提示词续跑段),全量 **274/274**。
159
+
160
+ ## 1.8.18 — 2026-10-31
161
+
162
+ **修复:`present` 对空计划与「取消后重启」两条边界的判定,并补上已交付文件的写保护。**
163
+
164
+ > 背景:1.8.16 的 `present` 闸门已按计划逐个检查,但 T5/T7 的边界复验发现两处
165
+ > 判定偏差:一个空计划(`stages: []`,只可能来自畸形历史消息)永远到不了
166
+ > `ready`,`present` 会拿「0 个子任务虽都已 done」这种错文案永久拒绝;反过来,
167
+ > 取消一个未完成计划再重启宿主,回放时既没有 live record 也没有本回合计划,
168
+ > 闸门会放行——这和取消工具自己的契约「取消后如仍有未完成项或证据缺口,
169
+ > present 仍会被拒绝」直接矛盾。另有一处交付完整性缺口:`present` 不复制文件,
170
+ > `write`/`edit` 也不校验路径,事故的迟到回合就在卡片发出后原地改写了同一份
171
+ > 报告。
172
+
173
+ ### 修复
174
+
175
+ - `src/runtime.ts` 新增 `definedSubtaskCount(plan)`:闸门按「计划定义了几个子任务」
176
+ 判断是不是交付对象。空计划不再进入禁止清单(消除 U6 假拒绝),但畸形计划
177
+ (`flattenSubtasks` 抛错)仍按「不可判断」失败关闭。
178
+ - `presentDenialReason` 的候选集增加 `lastGateablePlanRecord(session)`:重启后
179
+ live record 与本回合计划都不存在时,回退到最近一个「定义了工作」的计划;
180
+ 被取消但未完成的计划因此仍拒绝 `present`。较新的已就绪计划不受历史取消项
181
+ 阻塞;空计划不能拿来当挡箭牌(A8)。
182
+ - 新增写保护:`present` 时把「当时已定义的计划 id + 交付路径」钉进会话事件快照;
183
+ 新的 `fileWriteGuardReason`(`src/host.ts`,注册在 `ctx.tools.guard`)在根会话
184
+ 对同一路径的 `write`/`edit`/`str_replace_editor` 请求上检查,只要这些计划仍未
185
+ 通过交付就绪检查就拒绝,并给出续跑 / 取消 / 重新 present 三个出口。`present`
186
+ 之后才定义的新计划不在快照里,所以「用户要求改版 → 新计划」不会被卡死;
187
+ plan 模式、子会话、其它路径一律放行。
188
+ - 两条 guard 是并列的单调拒绝(`tools.guard` 的 `guardReason` 逐条求值,取第一个
189
+ 非空原因),互不覆盖。
190
+
191
+ ### 测试
192
+
193
+ - `tests/present-gate-evidence.test.ts`:A1–A8(未完成必拒、全 done 无证据必拒、
194
+ 空计划放行、plan 模式防死锁、按定义而非状态过滤、取消后重启仍拒、旧计划取消
195
+ 不阻塞新计划、空计划挡箭牌无效)。
196
+ - `tests/workplan-presented-write-guard.test.ts`:7 条(拒绝与出口、相对/绝对路径
197
+ 归一、present 后新计划放行、就绪放行、取消放行、非根会话/plan 模式放行、
198
+ 只接管三个写工具)。
199
+ - 全量 `npm test` = 270 pass / 0 fail;`npm run check` 无诊断;两次构建的 5 个
200
+ 产物 sha256 一致。
201
+
202
+ ## 1.8.17 — 2026-10-31
203
+
204
+ **修复:回放出来的记录缺少 `errors` 字段,预算到点清理子任务时整轮崩掉,剩余子任务被连带判为受阻。**
205
+
206
+ > 背景:17:51:37 对 `wp-40ce5eee` 的派发在 20 分钟预算边界中止。宿主刚重启,
207
+ > 内存里没有记录,`dispatchTool` 用 `reconstructFromSession` 从会话日志重建;
208
+ > 重建出的记录带着 `plan/statuses/phase/…`,唯独没有 `errors`。预算中止时
209
+ > `disposeActivation` 往 `record.errors` 里追一条清理失败信息,展开
210
+ > `[...record.errors]` 抛出 `TypeError: record.errors is not iterable`,
211
+ > 异常冒到本轮调度器,把还没跑的 T5–T10 一并标成受阻(6 项),其中三项
212
+ > 其实已经开始执行。这不是子 Agent 的失败,而是记录形状不一致导致的假受阻。
213
+
214
+ ### 修复
215
+
216
+ - `reconstructFromSession` 的每个快照新增 `errors: string[]`:回放结果消息时
217
+ 把 durable 的失败行并入(`result.errors`,保留最近 20 条),返回的记录始终
218
+ 带 `errors` 数组;`ReplaySnapshot` 接口同步。
219
+ - 所有 `[...record.errors, …]` 展开点补 `?? []` 守卫(dispose 失败、子任务
220
+ 重试说明、剩余预算不足、子任务超时、超时状态写入失败、预算收尾、子任务
221
+ 错误记录),重建记录与内存记录的字段形状就此对齐。
222
+ - 测试:新增 `tests/workplan-replay-errors.test.ts` 2 条——回放记录始终有
223
+ `errors` 数组并保留 durable 失败行;回放记录再派发时子任务失败只记错,
224
+ 不再抛错炸掉整轮。
225
+
226
+ 验证:`npm run check` 无诊断;`npm test` 255/255;`npm run build` 前后
227
+ 5 个产物 sha256 一致。
228
+
229
+ ## 1.8.16 — 2026-10-31
230
+
231
+ **修复:`present` 闸门检查会话里所有未完成的计划,不再只看「本回合/最后定义」的那一个。**
232
+
233
+ > 背景:1.8.15 的活体 E2E 直接暴露了缺口——本会话里 `wp-6753e19f` 停在
234
+ > 13/14,而最后定义的计划已就绪,`present` 仍然把根因报告交付成功。1.8.15
235
+ > 只把「按本回合消息点名」接进闸门,但一个会话可以同时存在多个计划(这次
236
+ > 事故会话前后有四个),只判其中一个就等于没判。
237
+
238
+ ### 修复
239
+
240
+ - `present` 闸门新增 `sessionPlanRecords()`:从会话日志里收集所有定义过的
241
+ `planId`,逐个按显式 planId 重建(各自带回扫窗口),再逐个做
242
+ `deliveryReadiness` 检查。
243
+ - 有多个未就绪计划时,拒绝文案逐条列出「计划 / 完成数 / 剩余项 / 证据缺口」,
244
+ 并说明先 `dispatch` 续跑、用 `update` 补证据;全部就绪前不得 `present`。
245
+ - **取消不是绕过交付闸门的逃生口**:取消只停止执行,不改变「未完成」的结论;
246
+ 对已取消且未就绪、又恰好是本回合/当前记录所指的计划,仍然拒绝 `present`
247
+ (T5-C 语义保持不变)。已取消的计划不会被当成交付阻塞项长期卡住其他计划。
248
+ - 测试:新增「会话里还有未完成计划时 present 不得放行,即使最后定义的计划
249
+ 已就绪」,并断言取消之后仍拒绝。
250
+
251
+ 验证:`npm run check` 无诊断;`npm test` 253/253;`npm run build` 前后产物
252
+ sha256 一致。
253
+
254
+ ## 1.8.15 — 2026-10-31
255
+
256
+ **修复:取消成为真正的终态;长会话默认回放不再丢掉计划;`present` 按本回合的计划判定;构建指纹覆盖 `watchdog.js`。**
257
+
258
+ > 背景:对 1.8.13 / 1.8.14 字节的独立复核(T4e、T5c、T3 三份报告)实测出
259
+ > 四类缺陷:取消之后 `dispatch` 仍会真的启动部门 Agent;派发途中第二次取消
260
+ > 会再写一条取消消息;已取消回合的结果消息仍教模型「继续派发」;超过 2000
261
+ > 事件的会话里默认回放返回 null,`present` 因看不到计划而静默放行。另外
262
+ > `buildHash` 未覆盖 `lib/watchdog.js`,`/dsh-workplan/plans` 载荷没有版本
263
+ > 身份,UI 无法判断进程加载的是不是旧构建。
264
+
265
+ ### 修复
266
+
267
+ - **取消是终态**:`dispatch` 遇到 `phase: 'cancelled'` 的计划直接返回
268
+ `ok: false / code: 'PLAN_CANCELLED'`,不启动任何部门 Agent;已取消回合的
269
+ 结果摘要与正文改成「已取消……不得交付,也不要再次派发」,不再教模型
270
+ 「再次调用 dispatch 即可继续跑」。
271
+ - **取消幂等覆盖派发途中**:派发进行中收到取消时记录 `abortRequested`,
272
+ 第二次取消返回 `alreadyCancelled: true`,durable 取消消息只写一条。
273
+ - **长会话默认回放**:窗口起点会向前回扫到最后定义的计划消息,避免
274
+ `reconstructFromSession` 在长会话里返回 null 而让交付闸门静默失效。
275
+ - **`present` 按本回合的计划判定**:新增 `currentTurnOf`,`present` 闸门优先
276
+ 用本回合消息里点名的 `planId` 重建;默认回放保持「最后定义的计划」契约,
277
+ 因为同一个默认答案也喂给 `dispatch`,改成「最后活动」会让旧计划截获新任务
278
+ 的默认派发目标。
279
+ - **构建指纹**:`buildHash` 的哈希文件加入 `lib/watchdog.js`。
280
+ - **UI 身份**:`/dsh-workplan/plans` 载荷返回 `version` 与 `runtime`
281
+ (pid / startedAt / entryPath / buildHash)。
282
+ - **测试**:新增 `tests/workplan-1815-guards.test.ts` 6 条;订正 1.8.14 发布
283
+ 说明里与实现不符的 N5 描述。
284
+
285
+ 验证:`npm run check` 无诊断;`npm test` 252/252;`npm run build` 前后 5 个
286
+ 产物 sha256 一致;`git diff --exit-code -- lib client.js` 为空。
287
+
288
+ ## 1.8.14 — 2026-10-31
289
+
290
+ **修复:事故报告 §12.6 表 A 里仍然开放的运行态/持久化缺口(N1、N5、N8、N12、N13),并让「重启后到底加载了哪份构建」可以自证。**
291
+
292
+ > 背景:1.8.13 把「完成」收敛成一个谓词,但重启复验仍然只能靠
293
+ > `ps`/`lsof`/文件 mtime 推断进程加载了什么;同时回放、取消、结果写入
294
+ > 三个持久化边界仍有可复现缺口。本轮按「运行态自证 → 持久化一致性 →
295
+ > 可观测性」的顺序修,全部以测试钉住。
296
+
297
+ ### 修复
298
+
299
+ - **N1 运行态自证**:`dsh_workplan_status`(以及 `dispatch`)新增 `runtime`
300
+ 字段:`version / pid / startedAt / uptimeMs / entryPath / buildHash`。
301
+ 宿主在激活时对实际加载的 `host.js + runtime.js + plan.js` 做 sha256
302
+ (取前 16 位),因此同一版本号重新构建、或 profile 重组后内存里仍是旧模块,
303
+ 都会被指纹区分出来;`startedAt` 由 `process.uptime()` 推导,是真实进程
304
+ 启动时间,不是插件构造时间。
305
+ - **无计划时也回答身份**:`status` 的 `NO_PLAN` 分支过去只有错误文案,导致
306
+ 报告 §14.6 第 2 步(新会话里调 `status` 确认版本)无法执行。现在该分支同样
307
+ 返回 `version` 与 `runtime`,渲染行也显示 `v…|build …|pid …|启动 …`。
308
+ - **N5 收尾闸门按本回合结算消息认计划**:`onTurnStopping` 先用本回合 durable
309
+ 消息里点名的 `planId` 重建,再退回收尾检查。默认回放**仍保持「最后定义的
310
+ 计划」契约**——它同时是 `dispatch` 的默认目标,改成「最后活动」会让旧计划
311
+ 截获新任务的派发目标。1.8.14 发布说明初稿曾写成「默认回放改最后活动」,
312
+ 与实现不符,已在 1.8.15 更正。
313
+ - **N8 取消幂等**:第二次取消不再追加第二条取消消息,而是返回
314
+ `alreadyCancelled: true`;已取消状态在回放里由 cancel 消息**或**
315
+ 结果消息的 `phase: 'cancelled'` 任一方确认。
316
+ - **派发途中取消持久化**:1.8.13 在中止分支直接 `return`,不写任何 durable
317
+ 消息;若随后结果消息写入失败,重启会把计划当成仍在执行。现在中止分支也写
318
+ 取消消息,并在返回值里报告 `cancelRecorded`。
319
+ - **N12 取消写入失败可报告**:取消消息的 `session.append` 加了 `try/catch`,
320
+ 失败进入 `record.errors` 并返回 `cancelRecorded: false`,不再抛出后留下
321
+ 「UI 已取消、日志没有」的分裂状态。
322
+ - **N13 结果写入失败可报告**:结果消息 `append` 失败时除宿主日志外,
323
+ 同时 `pushRecordError`,`status.errors` 与 UI 都能看到本轮结果未落盘。
324
+ - **取消途中的回放**:结果消息 `phase: 'cancelled'` 现在会让回放快照进入
325
+ 已取消,不再依赖是否存在 cancel 消息。
326
+
327
+ ### 测试
328
+
329
+ - 新增 6 条回归:默认回放跟随最后活动计划;途中取消(结果 phase)回放仍取消;
330
+ 连续两次取消只写一条消息;中止分支写 durable 取消;取消写失败报告
331
+ `cancelRecorded:false`;结果写失败进入 `errors`;无计划时 `status` 返回
332
+ 版本与构建指纹。
333
+ - `npm run check` 无诊断;`npm test` 全绿(见发布记录)。
334
+
335
+ ## 1.8.13 — 2026-10-31
336
+
337
+ **修复:四套「完成」判定各自为政——全 done 无证据仍可交付、取消后仍可 present、补证无法持久化。**
338
+
339
+ > 背景:1.8.9 声称修好「按 planId 分账 / 结算回合识别 / present 证据闸门」,
340
+ > 但重启后的行为探针(T5、T6、T6b)证明仍有四个可复现缺口:
341
+ > B(全 done 但 legacy/空 acceptance/缺产物只拦一部分)、C(取消 1/3 后
342
+ > `planIncomplete` 直接 false,present 放行)、D(结构化结果 acceptance 为空
343
+ > 仍被判 structured)、A1(预算重置清空 `childId` 后结算回合不被武装)。
344
+ > 根因不是某条分支写错,而是「计划完成」「证据通过」「可以交付」三个事实
345
+ > 没有单一事实源:结果消息、回合闸门、present、dispatch 快照各算各的。
346
+
347
+ ### 修复
348
+
349
+ - 新增唯一的 `deliveryReadiness(plan snapshot, { phase })`(`src/plan.ts`):
350
+ 每个子任务必须 `status=done`、`verification=structured`、`acceptance` 非空
351
+ 且每项 `result=pass`、无 `missingArtifacts`、无 `artifacts[].exists=false`;
352
+ 未完成项进入 `remaining`,其余进入可命名的 `blockers`。
353
+ `ready = total > 0 && remaining 为空 && blockers 为空`。
354
+ - 取消不再豁免:`cancelled` 仍有未完成项时,`blockers` 头部写明
355
+ 「计划已取消但只完成 X/Y:取消只停止执行,不等于完成」。
356
+ - `adjudicateResult`:空 `acceptance` 从 `structured` 降级为 `unverified`
357
+ (没有验收项不等于验收通过,T5-D 根因)。
358
+ - 四处判定统一改用 `deliveryReadiness`:
359
+ - 结果消息:全部 done 但证据未通过时,第 3 条改为
360
+ 「【证据未通过,禁止交付】」,第 4 条给出补证/改 blocked 的出路;
361
+ 未完成时仍为「【未完成,禁止交付】」;
362
+ - 回合收尾闸门:不再只看 pending/in_progress,取消、全 blocked、
363
+ 证据缺口都会注入 steer;取消/受阻分支明确要求「不要 dispatch、
364
+ 不要 present、按未完成口径收尾」;
365
+ - `present` 工具闸门:`ready` 才放行;拒绝文案不再把 cancel 写成交付许可;
366
+ - `dispatch` 快照 / `status` 工具:新增 `deliveryReady`、
367
+ `deliveryBlockers`、`deliveryRemaining` 与插件 `version`,模型与 UI
368
+ 看到的是同一个结论。
369
+ - `dsh_workplan_update` 新增 `verification`、`acceptance`、`artifacts`、
370
+ `missingArtifacts` 参数;这些字段写入 `workplan-update` 消息并进入回放,
371
+ 人工补证后刷新/重启仍然生效(此前只接字符串 evidence,且不落盘)。
372
+ - 提示词第 5 条改为「全部 done **且** deliveryReady=true」;明确
373
+ 「用户取消 ≠ 完成」;取消文案、dispatch render、status render 同步。
374
+ - 顺带修复:`present` 取消分支的重复句;`modelStatusLines` 补充
375
+ `acceptance` 摘要,主 Agent 能看到每项验收的 criterion/result。
376
+
377
+ ### 验证
378
+
379
+ - `npm run check` 无诊断;`npm test`:**238 tests / 238 pass / 0 fail**
380
+ (1.8.12 基线 233,新增 5 条:`tests/delivery-gate.test.ts` 4 条 +
381
+ 证据契约新增「空 acceptance→unverified」1 条;相对 1.8.8 的 220 条累计 +18)。
382
+ - 行为探针 `docs/rca-99984ebd-20261031/probes/T6b-delivery-gate-probes.mjs`
383
+ 在构建产物上逐项复现:B0–B5 全部拒绝;C0/C1 拒绝;D0=
384
+ `done/unverified`;G0/G1 放行;S0/S1/S2 各 steer 1 次、S3 steer 0;
385
+ U0 补证后 `deliveryReady` 由 false 变 true 且回放仍为 true;
386
+ V0 `status` 返回 `version` 与 `deliveryReady`。
387
+ - **运行进程仍是 1.8.9(PID 16366),必须重启 `dsh web` 后上述行为才会
388
+ 在真实会话中生效**;重启后用
389
+ `node docs/rca-99984ebd-20261031/probes/T6b-delivery-gate-probes.mjs`
390
+ 与 `dsh_workplan_status` 的 `version` 字段复核。
391
+
392
+ ## 1.8.12 — 2026-10-31
393
+
394
+ **修复:部门子 Agent 首轮「处理失败」——提示词里的 `包名:行号` 被 Harness 当成跨会话引用。**
395
+
396
+ > 现象:同一轮派出的 4 个子会话(`0d55b72d`、`37e6b366`、`5964c07d`、`538a8fef`)
397
+ > 都在 `turn 1` 的 37ms 内结束,`turn/end` 的 reason 是
398
+ > `invalid session reference URI "dsh-session:1980"`,没有任何模型步。
399
+ > 对用户来说,这就是「处理失败」,且主 Agent 侧只看到子任务立刻结束。
400
+ >
401
+ > 成因:Harness 的 `@deepseek-ai/dsh-session-reference` 在 `agent/pre-step`
402
+ > 扫描每条 `source.kind === 'user'` 消息的文本块,裸的
403
+ > `dsh-session:<payload>` 会被当作引用候选去 base64url 解码 + `JSON.parse`;
404
+ > `1980` 解出的字节不是合法 UTF-8 JSON,抛 `SessionReferenceError`,整个
405
+ > turn 在第一次模型调用之前中止。该文本来自前一个子任务的完成摘要——它在
406
+ > 报告里把 `ctx.sessions.get()` 的源码位置写成 `dsh-session:1980`——再经
407
+ > 「兄弟部门进展」进入后续子任务的提示词。子 Agent 的首条消息正是
408
+ > `source.kind === 'user'`,于是必炸。
409
+
410
+ ### 修复
411
+
412
+ - `buildChildPrompt` 的唯一出口统一调用新增的
413
+ `defuseSessionReferenceText()`:无法规范化的裸 token 转义成
414
+ `dsh-session\:<payload>`(文字与行号保留,只是不再命中引用正则);
415
+ 规范 URI(真正的跨会话引用)原样保留;显式 Markdown 引用
416
+ `@[label](dsh-session:…)` 的语义不变,仍由 Harness 严格校验。
417
+ - 消毒覆盖整段提示词:全局任务、对话背景、依赖结果、兄弟部门摘要、
418
+ 失败重试说明;任一处出现 citation 都不会再让子任务在首轮死亡。
419
+ - 新增 `isCanonicalSessionUri()`,规范化判断与 Harness 的
420
+ `encodeSessionReferenceUri` 逐字节一致。
421
+
422
+ ### 验证
423
+
424
+ - `npm run check` 无诊断。
425
+ - `npm test`:233 tests / 233 pass / 0 fail(新增 5 条:转义与正则不命中、
426
+ 规范 URI 保留、幂等、背景消毒、原始请求/依赖结果消毒)。
427
+ - 用事故原始提示词(23,098 字符,`/tmp/t9_prompt.txt`)回放打补丁后的
428
+ Harness 解析器:不再抛错、`references` 为 0、文本未变。
429
+ - 附带的 Harness 本地热修复(见
430
+ `docs/rca-99984ebd-20261031/harness-hotfix/`)在模块级验证 5/5 通过;
431
+ **需要重启 DSH 进程后才能生效**,升级 Harness 后要重跑 apply 脚本。
432
+
433
+ ## 1.8.11 — 2026-10-31
434
+
435
+ **修复两处在真实生命周期下仍会漏拦的缺陷:结算回合的谱系认亲、人工改判的重复回放。**
436
+
437
+ > 背景:1.8.10 的重启后核验(wp-91b6a96b)用真实字节与真实日志做了 8 项探针,
438
+ > 其中两项证明 1.8.7–1.8.10 的闸门仍有漏洞:
439
+ >
440
+ > 1. `subagent-settled` 到达父会话时,子会话已经被
441
+ > `dsh-subagent` 的 `finishDisposal` dispose 掉(dispose 在 notifySettlement
442
+ > 之前),`ctx.sessions.get(senderId)` 恒为 undefined,1.8.9 的
443
+ > `isChildSessionOf` 在真实生命周期下从未成立过——事故 turn 2 的路径仍然
444
+ > 可以绕过关卡。
445
+ > 2. 一次 `dsh_workplan_update` 会在会话里留下 durable `workplan-update` 消息
446
+ > 与配对的 `tool/result` 两份记录;回放两份都应用,第二次以 `system` 身份
447
+ > 把 revision 再抬一级并覆盖 summary,人工改判的作者与证据后缀丢失。
448
+
449
+ ### 修复
450
+
451
+ - `turnCarriesPlanWork` 的 `subagent-settled` 认亲新增第三来源:父会话自己的
452
+ `subagent/catalog` 事件(spawn 时追加,重启、回放、预算重置都不会改写)。
453
+ 判定顺序仍是 childId → live 会话谱系 → spawn 记录;三处都不命中才放行,
454
+ 无关后台任务不会误激活闸门。扫描结果按 `session.seq` 缓存。
455
+ - `reconstructFromSession` 记录每条 durable `workplan-update` 的 seq 与状态;
456
+ 配对的 `tool/result` 若在它之后且状态相同,则不再重复 `applyStatus`。
457
+ durable 消息缺席时,`tool/result` 仍独立生效(保持 1.6.0 的容错语义)。
458
+
459
+ ### 验证
460
+
461
+ - `npm run check` 无诊断。
462
+ - `npm test`:228 tests / 228 pass / 0 fail(新增 3 条:dispose 后按 spawn 记录
463
+ 认亲、三处都无记录不激活、人工改判只写一次)。
464
+ - 真实生命周期探针(T7)报告在 1.8.9 上 A1a 为 steered:0;「dispose 在
465
+ notifySettlement 之前」的顺序已由我独立复读 `dsh-subagent/lib/index.js`
466
+ 确认(`:2026` dispose → `:2040` notify)。本版的对应语义由新增用例覆盖:
467
+ 父会话事件里只剩 catalog 记录、live 会话为空时,闸门仍 steer 一次。
468
+
469
+ ## 1.8.10 — 2026-10-31
470
+
471
+ **修复:长会话的回放窗口越过 plan 消息,旧计划无法按 planId 重建。**
472
+
473
+ > 背景:1.8.9 上线重启后,`dsh_workplan_status({planId: "wp-6753e19f…"})`
474
+ > 仍然返回最新生成的计划。原因是回放窗口固定为最近 2000 个事件,而本会话
475
+ > 已有 2256 个事件,`wp-6753e19f` 的 plan 消息在 seq 22,早已落在窗口之外;
476
+ > 按 planId 重建得到 `null`,`status` 与 `dispatch` 一起退回内存里的新计划。
477
+
478
+ ### 修复
479
+
480
+ - `reconstructFromSession(session, targetPlanId)` 在窗口内找不到目标计划时,
481
+ 从窗口起点向前扫描,直到找到该计划的 plan 消息,再把回放起点前移到那里。
482
+ 只有显式指定 planId 才会触发这段扫描,默认回放行为不变。
483
+ - 真实日志验证:同一份 2256 事件的会话日志重放 `wp-6753e19f` 得到 13/14
484
+ (T1–T4、T6–T14 done,仅 T5 blocked),与重启前一致。
485
+
486
+ ### 验证
487
+
488
+ - `npm run check` 无诊断。
489
+ - `npm test` → **224 tests / 224 pass / 0 fail**(1.8.9 基线 223,新增 1 条:
490
+ 窗口外的旧计划仍可按 planId 重建)。
491
+
492
+ ### 残余
493
+
494
+ - 不指定 planId 的默认回放仍只保证最新计划可用;同一会话里并存多个计划时,
495
+ 卡片默认展示最新那个。要续跑旧计划必须显式传 `planId`。
496
+
497
+ ## 1.8.9 — 2026-10-31
498
+
499
+ **修复:重启后计划进度回退,以及结算回合认亲与 `present` 的证据闸门。**
500
+
501
+ > 背景:1.8.8 上线后重启 Web 服务,`wp-6753e19f` 从 13/14 退回 5/14。
502
+ > 排查发现回放只保留“最后一个计划”的状态:会话里出现第二个计划后,前一个
503
+ > 计划迟到的 result 与 update 全部被丢弃。同时 T5 审计指出两条剩余绕过路径,
504
+ > 一并修复。
505
+
506
+ ### 修复
507
+
508
+ - **回放按 planId 分账**:旧 `reconstructFromSession` 只有一组 `plan/statuses`。
509
+ 当“继续”被误判生成第二个计划(事故里是 `wp-dd26f206`),前一个计划被压进
510
+ 冻结快照,后续 `result.planId` / `update.planId` 不匹配而被丢弃,重启后永远
511
+ 回到冻结时的 5/14。现在每个计划独立快照,按载荷里的 `planId` 路由;
512
+ 显式传入 `targetPlanId` 时优先返回该计划。真实会话日志重放已从 5/14 恢复为
513
+ 13/14,与重启前一致。
514
+ - **结算回合按会话谱系认亲**:预算暂停会把未完成项重置为 `pending`,而
515
+ `normaliseStatusEntry` 对 `pending` 强制 `childId: null`(不变量 I6 不允许
516
+ `pending` 携带 `childId`),事故里的 T11 因此从 `planChildIds` 消失,turn 2
517
+ 仍能绕过收尾闸门。新增 `isChildSessionOf()`:`subagent-settled` 的发送者
518
+ 只要 `header.parentSession` 指向当前会话,就仍视为本计划的子会话。
519
+ - **`present` 的证据硬缺口**:计划全部 `done` 但存在自检失败
520
+ (`verification === 'failed'`)、验收项失败(`acceptance[].result === 'fail'`)
521
+ 或缺失声明产物(`missingArtifacts` 非空)时,`present` 在工具执行前被拒绝,
522
+ 并提示先用 `dsh_workplan_update` 复核补证,或把对应子任务改回 `blocked`。
523
+ `legacy`/无结构化证据的软缺口不在此层拦截:拦死会让所有旧计划永久不可
524
+ 交付、只剩 `cancel` 一条逃生路,反而制造新的死锁;软缺口仍由提示词与结果
525
+ 消息约束。
526
+
527
+ ### 验证
528
+
529
+ - `npm run check` 无诊断。
530
+ - `npm test` → **223 tests / 223 pass / 0 fail**(1.8.8 基线 220,新增 3 条:
531
+ 第二个计划不得冻结前一个计划的 result/update、`childId` 被清空后结算回合
532
+ 仍被拦截、全 `done` 但有证据硬缺口时 `present` 仍被拒绝)。
533
+ - 用 1657 事件的真实会话日志重放 `wp-6753e19f`:13 个 `done`(T1–T4、T6–T14),
534
+ 仅 T5 `blocked`。
535
+
536
+ ### 残余
537
+
538
+ - 取消计划后 `planIncomplete` 为 `false`,`present` 会放行。当前语义是
539
+ “取消即表示剩余产物只能作为中间结果交付”,拒绝文案也要求先取消再在正文
540
+ 说明;是否要在取消后仍禁止 `present` 属于产品决策,本轮未改。
541
+ - `payload.status === 'done'` 但 `acceptance` 为空时仍按结构化证据接收,
542
+ 只能靠自检失败拦住明确错误的证据。
543
+
544
+ ## 1.8.8 — 2026-10-31
545
+
546
+ **补丁:把 1.8.7 的收尾闸门补到「结算唤醒的回合」与 `present` 工具层。**
547
+
548
+ > 背景:审计计划 `wp-6753e19f` 的 T7 在复核事故 turn 2 时发现,1.8.7 仍有两个
549
+ > 绕过路径,而这两条正是事故第二个回合的真实路径:它在 11/13 收尾,却由
550
+ > `subagent-settled` 消息唤醒,既没有人工任务标记,也没被 `present` 层拦住。
551
+
552
+ ### 修复
553
+
554
+ - **H9 结算唤醒的回合绕过闸门**:`humanMessages()` 只认人类 `user` 消息,
555
+ 由子 Agent 结算通知(`subagent-settled`)或 workplan 结果消息唤醒的回合不会
556
+ 写 `activeTurns`,`onTurnStopping` 首行直接放行。新增
557
+ `turnCarriesPlanWork()`:从 `session.seq - 1` 回扫本回合事件,识别
558
+ `subagent-settled` / `workplan-result` / `workplan-continue` 三类来源;
559
+ 对 `subagent-settled` 还要求 `senderSessionId` 属于本计划的子会话,
560
+ 无关子 Agent 的结算不会误激活闸门。
561
+ - **H10 `present` 没有工具级闸门**:1.8.7 只把「未完成不得交付」写进
562
+ `PROMPT_SECTION`,模型仍可在回合中途 `present`。新增
563
+ `presentDenialReason()` 并接入 `ctx.tools.guard`:根会话的计划未完成时,
564
+ `present` 在执行前被拒绝,拒绝文案列出剩余项,并给出两条出路——
565
+ 先 `dsh_workplan_dispatch` 续跑,或确认无法继续时先 `dsh_workplan_cancel`。
566
+ - **全部剩余项都 blocked 时不再空转 steer**:没有可运行子任务时,每回合
567
+ steer 只会消耗回合而不推进;现在只拦 `present`,不再 steer。
568
+ - 闸门仍按回合计数、上限 2 次,避免死循环。
569
+
570
+ ### 验证
571
+
572
+ - `npm run check` 无诊断。
573
+ - `npm test` → **220 tests / 220 pass / 0 fail**(1.8.7 基线 215,新增 5 条:
574
+ 结算唤醒拦截、无关结算不误激活、`present` 拒绝/放行、全 blocked 行为)。
575
+ - `npm run build` 确定性:`lib/host.js`、`lib/runtime.js`、`lib/plan.js`、
576
+ `lib/watchdog.js`、`client.js` 五个产物构建前后 sha256 一致。
577
+
578
+ ### 说明
579
+
580
+ - 版本同步:`package.json`、`package-lock.json`、`README.md` / `README.en.md`
581
+ 安装命令、`src/host.ts` 的 `meta.version` 均为 1.8.8。
582
+ - 本次未改 `client.ts`;运行中的 `dsh web` 需要重启后才会加载新 `lib/*.js`。
583
+
584
+ ## 1.8.7 — 2026-10-31
585
+
586
+ **修复:计划没做完就把中间结果当成品交付——「未完成即输出」的根治。**
587
+
588
+ > 事故(2026-10-31,会话 `session-99984ebd-7d13-47d5-87a0-e9ba7271b883`,
589
+ > 计划 `wp-66f57fa3…`,13 项子任务):11:48:54 主 Agent 调
590
+ > `dsh_workplan_dispatch({mode:"wait"})`;12:02:54 计划以「本轮预算用尽,可续跑
591
+ > (完成 10/13,受阻 0)|已加入进行中的派发并等到结果」返回,同一秒注入的
592
+ > 「部门执行结果」第 3 条写着「给出最终答复」、第 4 条又写「再次调用
593
+ > dsh_workplan_dispatch」;模型照第 3 条执行,12:04:22 `present` 了报告、
594
+ > 12:04:25 `turn/end` 记 `completed`。12:13 的第二个回合把进度写成
595
+ > 「11/13,可续跑,不是失败」后再次收尾,T12/T13 再没跑过。用户看到的就是一份
596
+ > 半成品「成品报告」。
597
+
598
+ ### 根因(五层,缺一层都拦不住)
599
+
600
+ 1. **结果消息自相矛盾**:未完成时仍写「3. 给出最终答复」,与「4. 再派发续跑」
601
+ 直接冲突(`src/plan.ts` `buildResultMessage`);摘要也固定写「请主 Agent
602
+ 核对并整合」(`buildResultSummary`),把暂停包装成交付。
603
+ 2. **工具返回误导**:`ok: true` + 「已加入进行中的派发并等到结果」读起来像成功,
604
+ 且没有任何 `complete` 字段可供模型判断(`src/host.ts` dispatch render、
605
+ `dispatchToolOutputSchema`)。
606
+ 3. **提示词只有软约束**:只说「不要声称未经验证的完成」,没有「未完成禁止
607
+ present/禁止写已完成」的硬规则。
608
+ 4. **回合结束不受约束**:插件只订阅 `agent/pre-step`,模型随时可以收尾;
609
+ 预算暂停只是提示「可续跑」,没有强制点。
610
+ 5. **没有回归用例**:上一版 1.8.4 只修了「已结束 ∧ 正在做」,没有覆盖
611
+ 「已结束 ∧ 还有 pending/blocked」。
612
+
613
+ ### 修复
614
+
615
+ - **结果消息分叉**:`buildResultSummary` / `buildResultMessage` 在
616
+ `done < total` 时第一句即「未完成:完成 d/t,剩余 N 项」,职责清单改为
617
+ 「【未完成,禁止交付】」+ 恢复动作;只有全部 done 才出现「给出最终答复」。
618
+ - **工具文案分开**:dispatch render 三种口径——「已开跑,尚未完成」/「未完成:
619
+ 完成 d/t,剩余 N 项」/「已完成:完成 d/t」;schema 增加 `complete` 与
620
+ `remaining`;工具描述写明 `complete=false` 必须续跑。
621
+ - **提示词硬规则**:`PROMPT_SECTION` 新增第 5、6 条:完成唯一判据是全部 done;
622
+ `ok:true` 不等于完成;未完成时禁止 `present`、禁止「已完成/最终版/已交付」、
623
+ 禁止收尾答复,必须先续跑;确有阻碍时答复开头必须写「未完成:剩余 N 项」。
624
+ - **回合收尾闸门**:`src/runtime.ts` 新增 `onTurnStopping`,在官方
625
+ `agent/turn-stopping`(serial、边界提交前 await)里检查本会话计划:仍有
626
+ 未完成项时先等正在跑的派发,再用 `agent.steer()` 注入「计划没做完,这个回合
627
+ 不关闭」并附续跑指令;每回合最多 2 次,全 done/已取消/非任务回合直接放行。
628
+
629
+ ### 测试
630
+
631
+ - 新增 `tests/workplan-turn-stop-gate.test.ts`(6 条):摘要/结果消息在未完成与
632
+ 完成时的分叉、收尾指令文案、steer 拦截与上限、全 done/已取消/非本回合放行、
633
+ 后台派发仍在跑时先等结果再判定。
634
+ - `npm test` → **215 tests / 215 pass / 0 fail**;`npm run check` 无诊断。
635
+
636
+ ### 升级
637
+
638
+ ```bash
639
+ dsh plugin --profile web add dsh-workplan@1.8.7
640
+ ```
641
+
642
+ 插件在 `dsh web` 启动时加载,**升级后需重启一次 `dsh web` 才生效**(重启会中断正在
643
+ 运行的会话)。
644
+
645
+ ---
646
+
647
+ ## 1.8.6 — 2026-10-30
648
+
649
+ **修复:子 Agent 被中断时「证据已在盘上却不被承认」,以及把「待跑」冒充成「卡住」。**
650
+
651
+ > 事故(2026-10-30 21:34:54,ETF 计划 `wp-008107ca…`)里 T6 的子 Agent 在写出
652
+ > 38,140 字节产物后被打断(`turn/end` 记 `aborted`、`reason.kind = "user"`)。
653
+ > 计划把它判成受阻,并把 T7–T12 六个下游一并级联成 blocked;主 Agent 只能自己
654
+ > 逐条核对「文件其实已经在盘上」。同一轮里另有一处:`ready` 为空时所有 pending
655
+ > 被改写成 blocked,预算暂停与真失败在卡片上长得一模一样。
656
+
657
+ ### 修复
658
+
659
+ - **D5 中断也要留证据**:新增 `probeInterruptedEvidence()`,中断时把「声明过的产物」
660
+ 与「核到在盘上的文件」取并集写进该步的 `artifacts` / `missingArtifacts`(不再只
661
+ 拼进报错字符串);状态仍是 `blocked`,判定不放宽。
662
+ - **D5 不再连坐下游**:`dispatchPlan` 用 `interruptedIds` 记住被中断的步骤,级联时
663
+ 跳过它们,并在 `errors` 里写明「被中断但产物已核对,未自动级联下游;请据实改判
664
+ 或续跑」。
665
+ - **D8 不再把 pending 写成 blocked**:新增 `describePendingCause()`,按上游状态、
666
+ 缺失产物、legacy 回执分别给出原因;本轮结束时 pending 保持 pending,阶段为
667
+ `paused`(没有真失败项时),不再被覆盖成 `blocked`。
668
+
669
+ ### 测试
670
+
671
+ - 新增 4 条:中断写入 `artifacts`/`missingArtifacts`、下游保持 `pending` 且阶段为
672
+ `blocked`(真有失败项时)、上游产物缺失时下游 `pending` + 阶段 `paused`、全部完成
673
+ 时不多写解释文案。
674
+ - `npm test` → **209 tests / 209 pass / 0 fail**;`npm run check` 无诊断。
675
+
676
+ ### 升级
677
+
678
+ ```bash
679
+ dsh plugin --profile web add dsh-workplan@1.8.6
680
+ ```
681
+
682
+ 插件在 `dsh web` 启动时加载,**升级后需重启一次 `dsh web` 才生效**(重启会中断正在
683
+ 运行的会话)。
684
+
685
+ ---
686
+
1
687
  ## 1.8.4 — 2026-10-30
2
688
 
3
689
  **修复:左侧栏「任务进度」同时显示「已结束」和「正在做」。**