dsh-workplan 1.11.1 → 1.12.0

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.
@@ -2,8 +2,10 @@
2
2
 
3
3
  > 这份文档回答四个问题:**谁把什么写给谁、什么时候算完成、失败后谁接手、改代码时哪些地方必须一起改。**
4
4
  >
5
- > 适用版本:**1.7.0(当前已发布,2026-10-30)**。文中每一项能力都已落到代码与测试;标注「未处理」的是明确不做、留待后续版本的范围,不要当现状。
5
+ > 适用版本:**1.12.0**。文中每一项能力都已落到代码与测试;标注「未处理」的是明确不做、留待后续版本的范围,不要当现状。
6
6
  >
7
+ <!-- [D-45] 本文版本与实现口径已对齐 1.12.0;核对项:权限 7 处、present 仅根会话、下游可读 artifacts。 -->
8
+
7
9
  > 约定:本文只用「文件 + 符号名」定位代码(例如 `src/plan.ts#buildChildPrompt`),**不写行号**,避免代码改动后文档漂移。核对命令见 §11。
8
10
 
9
11
  ---
@@ -21,13 +23,13 @@
21
23
 
22
24
  要点:
23
25
 
24
- - **部门是职责标签,不是组织架构。** 1.6.0 的 `src/plan.ts#DEPARTMENTS`(12 个)只用于生成提示词与界面分组;**没有部门负责人、部门队列、部门内串行**。是否并行只由 `dependsOn` 与全局并发 5 决定。
26
+ - **部门是职责标签,不是组织架构。** 1.12.0 的 `src/plan.ts#DEPARTMENTS`(12 个)只用于生成提示词与界面分组(未知值归入「未知部门」桶,不回显原文);**没有部门负责人、部门队列、部门内串行**。是否并行只由 `dependsOn` 与全局并发 5 决定。
25
27
  - **主 Agent 是唯一中枢。** 子 Agent 之间没有消息通道;跨部门信息只能经主 Agent 转达(见 §5、§7)。
26
- - **子 Agent 的权限是「代码硬约束 + 提示词软约束」两层。** 硬约束只有三条 `NOT_ROOT` 拒绝(dispatch / update / cancel);「不要重启服务、不要安装」只在 `buildChildPrompt` 文本里,**没有工具层护栏**。
28
+ - **子 Agent 的权限是「代码硬约束 + 提示词软约束」两层。** 代码层有 **7 处 `NOT_ROOT` 拒绝**:dispatch / update / replan / cancel / instruct / handoff / followup;`present` 另有独立守卫,对非根会话直接返回 `NOT_ROOT`(1.11.0 起,见 §5.2.1)。但「已交付文件写保护」只对**根会话**生效(`presentedWriteDenialReason` 对子会话直接返回 `undefined`),子会话仍可改写已交付文件(§7.2 L13);「不要重启服务、不要安装/升级依赖」仍只在 `buildChildPrompt` 文本里,**没有工具层护栏**(见 §7.2 L11)。
27
29
 
28
30
  ---
29
31
 
30
- ## 2. 端到端流程(1.6.0 实际行为)
32
+ ## 2. 端到端流程(1.12.0 实际行为)
31
33
 
32
34
  ```
33
35
  用户消息
@@ -242,7 +244,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
242
244
  3. 工作目录;
243
245
  4. 最近对话背景(**截断到 7000 字**;1.7.0 在每次派发前重新采样,之后不再二次截断);
244
246
  5. 本子任务的 `role/objective/method/inputs/outputs/acceptance/risk`;
245
- 6. **仅 `dependsOn` 里的上游结果**:`{id, title, status, summary}`,summary 已是 3000 字以内的截断文本。
247
+ 6. **仅 `dependsOn` 里的上游结果**:`{id, title, status, summary}`,外加 `artifacts[]` 中 `exists:true` 的可消费产物 `ref`(1.8+ 起);summary 已是 3000 字以内的截断文本。
246
248
 
247
249
  **下游看不到上游的原始对话**,但 1.7.0 会附上**兄弟任务的只读一览**(`buildTeamBrief`:id、部门、目标、产出、状态;已完成的带摘要),并用 `needs` 汇总需要主 Agent 转达的协作请求。产物本身仍要靠工作区文件与摘要传递,因此上游必须把「产物在哪、怎么用、什么算合格」写进摘要或落成文件。
248
250
 
@@ -250,7 +252,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
250
252
 
251
253
  子 Agent 必须用**自由文本**汇报,并满足:
252
254
 
253
- - 优先在输出末尾追加结构化证据块(`<!-- WORKPLAN_EVIDENCE:START -->` … JSON … `<!-- WORKPLAN_EVIDENCE:END -->`),含 `status` / `blockedReason` / `acceptance[]` / `artifacts[]` / `needs[]`。这是 1.7.0 的主信号:`partial`、任一验收 `fail`、坏块都判受阻,只有全 `pass` 直接采信。
255
+ - 优先在输出末尾追加结构化证据块(`<!-- WORKPLAN_EVIDENCE:START -->` … JSON … `<!-- WORKPLAN_EVIDENCE:END -->`),含 `status` / `blockedReason` / `acceptance[]` / `artifacts[]` / `needs[]`。这是 1.11.0 起的完成判据:`partial`、任一验收 `fail`、坏块都判受阻,只有全 `pass` 直接采信。
254
256
  - 没有证据块时,失败仍可**第一行**写 `BLOCKED: 原因`(大小写不敏感,中英文冒号都认,行首允许空白)——按 `legacy` 判受阻。
255
257
  - **1.11.0 起,没有证据块、也没有 `BLOCKED` 的「纯散文」不再算完成**:默认(`strictCompletion`,可用 `DSH_WORKPLAN_STRICT_COMPLETION=0` 关闭)判 `blocked` + `unverified`,错误信息写明「结果块缺失,无法确认验收项是否真的通过」。历史回放仍按 `legacy` 读取,避免旧计划整体失效。
256
258
  - 验收条目自称 `pass` 但 `evidence` 为空时,1.11.0 降级为 `unverified`,且 `deliveryReadiness` 增加「验收自称通过但没有证据」阻塞项。
@@ -258,7 +260,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
258
260
  - 不编造命令输出、文件或证据;无法确认就写「未验证」;
259
261
  - 需要别人配合时,写「需要主 Agent 执行/确认什么」,**不要等待或空转**。
260
262
 
261
- `summary` 会被截断到 3000 字,因此**关键结论和绝对路径要放在最前面**。
263
+ `summary` 会被截断到 3000 字,因此**关键结论和产物路径要放在最前面**。
262
264
 
263
265
  ### 5.2.1 验收覆盖与上游门槛(1.11.0)
264
266
 
@@ -269,12 +271,12 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
269
271
 
270
272
  ### 5.3 跨部门转达
271
273
 
272
- 1.11.0 **仍没有**子 Agent 直连、共享黑板或会签——这是刻意的权限边界,不是遗漏。跨部门只有三条路:
274
+ 1.12.0 **仍没有**子 Agent 直连、共享黑板或会签——这是刻意的权限边界,不是遗漏。跨部门只有三条路:
273
275
 
274
276
  1. **带编号的 hand-off(1.11.0 新增,唯一处置入口)**:子 Agent 每条 `needs` 由 `applyStatus` 自动登记为 `{id: H1, request, department, status}`;主 Agent 用 `dsh_workplan_handoff` 处置:`list` / `assign`(登记责任部门)/ `resolve`(写入答复或产物引用)/ `close`(确认无需动作)。四态为 `open → routed → answered / closed`。**未处置的 hand-off 会进 `deliveryReadiness`,直接拦住交付**;对正处于「待指示」的行执行 `resolve`,会复用 `instructSubtask` 把答复直接投递给该子会话。
275
277
  - `assign` 只登记责任,**不会自动产生工作**(插件没有常驻部门代理);需要产出时用 `dsh_workplan_replan(action=add)` 建该部门的子任务,或由主 Agent 自己完成,再 `resolve`。
276
278
  2. **经主 Agent 对话**:`dsh_workplan_instruct` 回答请示、`dsh_workplan_replan` 就地修订计划;
277
- 3. **经工作区文件**:上游把接口/产物落到双方都能读到的路径,并在摘要里写绝对路径;`dependsOn` 上游的 `artifacts[].ref`(`exists:true`)会作为「可消费产物」注入下游提示词。
279
+ 3. **经工作区文件**:上游把接口/产物落到双方都能读到的路径,并在摘要里写**工作目录相对路径或绝对路径(同一产物只用一种)**;`dependsOn` 上游的 `artifacts[].ref`(`exists:true`)会作为「可消费产物」注入下游提示词。
278
280
 
279
281
  「兄弟任务只读一览」与 `needs` 清单自 1.7.0 起存在(`buildTeamBrief`、`buildResultMessage`);子 Agent 直连仍然不开放。
280
282
 
@@ -282,14 +284,14 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
282
284
 
283
285
  ## 6. 失败与恢复
284
286
 
285
- | 现象 | 1.6.0 的实际行为 | 正确恢复动作 |
287
+ | 现象 | 1.12.0 的实际行为 | 正确恢复动作 |
286
288
  |---|---|---|
287
289
  | 子 Agent 5 分钟无新事件 | 判 `CHILD_STALLED`,同一 prompt 重试 1 次 | 若仍失败转 `blocked`;主 Agent 核对并决定续跑或接手 |
288
290
  | 单项超过 15 分钟 | 强制结束,记 `blocked` | 拆小任务或提高 `childTimeoutMs` 后重派 |
289
291
  | 整轮 20 分钟预算用尽 | 阶段 `paused`,剩余项保持 `pending`,**不消耗续跑额度** | 再次 `dispatch` 即续跑,已完成不重跑 |
290
292
  | 子任务 `blocked` | 下游依赖被级联标记 `blocked`;错误只写「上游子任务受阻:T1、T2」 | 先修上游;再 `dispatch` 续跑(额度内) |
291
293
  | 续跑额度用尽 | `resumeAvailable:false`,结果消息要求主 Agent 直接接手 | 主 Agent 自己完成或向用户说明,不要重复派发 |
292
- | 运行中 `update` 改判 | **允许**,但会被子任务结束时的结果覆盖(无锁) | 等本轮结束再改判;这是 1.7.0 要修的缺陷 |
294
+ | 运行中 `update` 改判 | **拒绝**(`TASK_RUNNING`);`force:true` 才允许,并记录为人工改判 | 等本轮结束再改判;确需覆盖再显式 `force` |
293
295
  | 刷新页面 | 由结果消息回放;显式 cancel 会回放 | 若改判消失,属已知缺陷(§8) |
294
296
  | 新一轮取代未派发旧计划 | 旧计划只改内存为 `cancelled`,不落盘(plan 模式下未派发的计划例外:会保留) | 刷新前不要依赖「已取消」结论 |
295
297
  | 规划失败 | `degraded` 消息,不自动重规划 | 向用户说明并询问是否重试 |
@@ -303,15 +305,15 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
303
305
 
304
306
  ### 7.1 硬约束(代码层,改动需同步测试)
305
307
 
306
- 1. 只有 root 会话能 `dispatch` / `update` / `cancel`;子 Agent 调用会被 `NOT_ROOT` 拒绝。
308
+ 1. 只有 root 会话能 `dispatch` / `update` / `replan` / `cancel` / `instruct` / `handoff` / `followup`(共 7 处 `NOT_ROOT`);子 Agent 调用会被拒绝。`present` 另有独立守卫:非根会话返回 `NOT_ROOT`(1.11.0 起,§5.2.1),不在这 7 处之内;已交付文件写保护仍只覆盖根会话(§7.2 L13)。
307
309
  2. 子 Agent 派生深度上限 1(`maxDepth: 1`)。
308
310
  3. plan 模式下 `dispatch` 被 `tools.guard` 拒绝,并给出原因。
309
311
  4. 状态枚举只有 4 个值;计划版本 `PLAN_VERSION = 1`。
310
312
  5. `stats` 不缓存,统一由 `derivePlanSnapshot` 在出口派生;实时与回放必须同源。
311
313
 
312
- ### 7.2 限制清单(1.7.0 现状:哪些已处理、哪些明确不做)
314
+ ### 7.2 限制清单(1.12.0 现状:哪些已处理、哪些明确不做)
313
315
 
314
- | # | 限制 | 影响 | 1.7.0 状态 |
316
+ | # | 限制 | 影响 | 1.12.0 状态 |
315
317
  |---|---|---|---|
316
318
  | L1 | 派发期间主 Agent 无法观测进度 | 用户问「做到哪了」时主 Agent 无上下文 | 已处理(async 派发 + `status` 工具) |
317
319
  | L2 | 回传是自由文本,非空即 `done` | 「假完成」;验收标准没有被逐条核对 | 已处理(结构化证据 + 确定性裁决) |
@@ -323,7 +325,8 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
323
325
  | L8 | 部门之间无直接通信 | 跨部门接口对不上只能等失败 | 部分处理(兄弟只读一览 + needs 转达,仍不直连) |
324
326
  | L9 | 一个会话只有一个计划槽位;计划之间无依赖/汇总 | 超长任务只能靠多轮对话承载 | 不做(后续版本评估) |
325
327
  | L10 | 对话背景在计划时刻冻结,且 prompt 内再截断到 5000 字 | 续跑时子 Agent 拿到旧背景 | 已处理(派发时重新采样、7000 字、不二次截断) |
326
- | L11 | 子 Agent 的「不要重启/安装」只是提示词 | 越权动作无法被插件拦截 | 不做(属宿主工具护栏) |
328
+ | L11 | 子 Agent 的「不要重启/安装」只是提示词 | 重启/停服/安装/升级等**进程与依赖动作**无法被插件拦截 | 部分处理(进程/依赖动作在插件层不可拦截;`present` 已由根会话守卫拒绝,已交付文件写保护仅覆盖根会话,见 L13) |
329
+ | L13 | 已交付文件的写保护只覆盖根会话 | 子会话可改写已交付文件,绕过「交付后不再改动」的约束 | 未处理(D-37 剩余部分:`present` 已由 1.11.0 拒绝子会话,写保护仍需宿主按会话过滤) |
327
330
  | L12 | 无证据块,无产物检查,无预算提示 | 计划过大时必然多轮 | 已处理(三者均已实现) |
328
331
 
329
332
  **关于阶段(L7)的正式口径:阶段是展示分组,不是执行门槛。** `readySubtasks` 只读 `dependsOn`,不读 stage。这样设计是为了避免「一个慢任务拖红整个阶段」。如果产品上需要阶段验收,必须单独立项并改调度语义,不能在文档里暗示它已经生效。
@@ -332,7 +335,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
332
335
 
333
336
  ## 8. 写者所有权(当前与目标)
334
337
 
335
- ### 8.1 1.7.0 实际
338
+ ### 8.1 1.12.0 实际
336
339
 
337
340
  | 事实 | 写入者 | 写入位置 | 回放 |
338
341
  |---|---|---|---|
@@ -343,7 +346,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
343
346
  | 续跑计数 | `dispatchPlan` | 内存 `resumeCount` | 结果消息的 `resumeCount` |
344
347
  | 面板数字 | 无(全派生) | — | `derivePlanSnapshot` |
345
348
 
346
- ### 8.2 写保护规则(1.7.0 已实现)
349
+ ### 8.2 写保护规则(1.11.0 已实现,仅覆盖根会话)
347
350
 
348
351
  - 调度器与主 Agent 的改判都走同一条 `applyStatus`,每次写入递增 `revision`;
349
352
  - 运行中的子任务拒绝 `update`(`TASK_RUNNING`),除非 `force:true`;
@@ -363,7 +366,7 @@ pending ──dispatch──▶ executing ──全部 done──▶ done
363
366
 
364
367
  ---
365
368
 
366
- ## 9. 1.7.0 契约与实现状态
369
+ ## 9. 1.12.0 契约与实现状态
367
370
 
368
371
  | 能力 | 设计要点 | 状态 |
369
372
  |---|---|---|
@@ -5,7 +5,8 @@
5
5
  ## 0. 先厘清:部门是什么,不是什么
6
6
 
7
7
  - **是职责标签。** `src/plan.ts#DEPARTMENTS` 里的 12 个 key 决定子任务的提示词、面板分组与统计口径。
8
- - **不是组织架构。** 1.7.0 仍没有部门负责人、部门队列、部门内串行、部门预算;同一部门的两个子任务也可以并行。
8
+ - **不是组织架构。** 1.12.0 仍没有部门负责人、部门队列、部门内串行、部门预算;同一部门的两个子任务也可以并行。
9
+ - **`role` 是执行角色,不是负责人。** 它由规划器写成一句话(如「执行工程师」),只用于子提示词与卡片展示;没有任免、没有汇报关系、也不带权限。面板文案已统一为「执行角色」(旧版写「负责人」,属于口径漂移)。
9
10
  - **不是通信通道。** 部门之间不能直接对话;跨部门信息经主 Agent 转达、落到工作区文件,或写进子 Agent 回传的 `needs`(1.11.0 起自动登记为带编号、可处置、会拦住交付的 hand-off,见协作契约 §5.3)。
10
11
  - **不代表权限。** 任何部门都不能派发、改判、取消计划;这些只有主 Agent 能做。
11
12
 
@@ -30,7 +31,7 @@
30
31
  | `legal` | 法务合规 / Legal | 条款、隐私、许可、合规风险 | 适用法域与版本、风险等级、需人工复核项 | `product`、`security`、`writing` |
31
32
  | `finance` | 财务 / Finance | 成本、预算、计价、对账 | 口径与币种、假设、区间与敏感性 | `product`、`operations`、`writing` |
32
33
 
33
- > 部门 key 必须与 `src/plan.ts#DEPARTMENTS` 完全一致;新增部门要同时改代码、本文与协作契约 §1。**不要**在计划里写自由文本部门名。
34
+ > 部门 key 必须与 `src/plan.ts#DEPARTMENTS` 完全一致;新增部门要同时改代码、客户端中英文文案、本文与协作契约 §1。一致性由 `tests/t11-lowrisk-patches.test.ts` 断言(代码 ↔ 客户端 zh/en ↔ 本文表格),不靠人工记忆。**不要**在计划里写自由文本部门名。
34
35
 
35
36
  ---
36
37
 
@@ -41,7 +42,7 @@
41
42
  一个子任务要能被下游直接接手,它的结果摘要(≤3000 字,超出被截断)必须包含:
42
43
 
43
44
  1. **做了什么**:一句话结论 + 关键决定;
44
- 2. **产物在哪**:绝对路径(文件/目录)或可访问 URL;没有产物就写「无文件产物」;
45
+ 2. **产物在哪**:以**工作目录为基准的相对路径**(推荐,便于整目录迁移)或**绝对路径**,二选一并保持同一份产物只用一种;也可写可访问 URL。插件当前**不做**路径归一化(`exists` 在检查时以 cwd 解析相对 ref,不是写入时快照),所以同一产物混写两种形式会让下游解析出两个位置。没有产物就写「无文件产物」;
45
46
  3. **怎么用/怎么验**:下游复现或验收的最短命令/步骤;
46
47
  4. **边界与遗留**:没做什么、已知风险、需要谁确认。
47
48
 
@@ -64,7 +65,7 @@
64
65
 
65
66
  ### 2.4 交接自检清单(交接前逐条过)
66
67
 
67
- - [ ] 结论在第一段,路径是绝对路径,且文件真的存在;
68
+ - [ ] 结论在第一段,路径与产物真实位置一致(相对路径以工作目录为基准;不要同一产物混写相对/绝对两种),且文件真的存在;
68
69
  - [ ] 验收标准逐条有「通过 / 未通过 / 未验证」,没有把「没测」写成「通过」;
69
70
  - [ ] 下游不需要读我的对话就能开始;
70
71
  - [ ] 失败信号在第一行,且是 `BLOCKED:` 开头;
@@ -173,7 +174,7 @@
173
174
 
174
175
  ---
175
176
 
176
- ## 6. 1.7.0 对交接的影响(目标,未发布)
177
+ ## 6. 1.11.0 对交接的影响(已实现)
177
178
 
178
179
  | 变化 | 对部门交接的意义 |
179
180
  |---|---|
@@ -182,13 +183,13 @@
182
183
  | 兄弟任务只读一览 | 并行部门能看到彼此的目标与边界(仍不能直连) |
183
184
  | 运行中写保护 + `revision` | 主 Agent 改判不会被子任务结束覆盖;交接结论更稳定 |
184
185
 
185
- 在这些能力发布前,**按本文 §2 的手写约定执行**;发布后以协作契约 §9 的实际状态为准。
186
+ 以上能力均已落到代码与测试;交接时仍按本文 §2 的四段摘要执行,实际字段与状态以协作契约 §9 为准。
186
187
 
187
188
  ---
188
189
 
189
190
  ## 7. 维护规则
190
191
 
191
- - 改部门列表:同步 `src/plan.ts#DEPARTMENTS`、本文 §1、协作契约 §1。
192
+ - 改部门列表:同步 `src/plan.ts#DEPARTMENTS`、`src/client.ts` 中英文 `dept` 表、本文 §1、协作契约 §1,并跑 `tests/t11-lowrisk-patches.test.ts`(不一致即失败)。
192
193
  - 改交接字段:同步协作契约 §3.3/§3.4 与三处回传代码(见协作契约 §8.3)。
193
194
  - 新增链路:先确认它是否只是 `dependsOn` 的一种写法,避免把建议写成硬规则。
194
195
  - 本文不写行号;核对命令见协作契约 §11。
@@ -0,0 +1,66 @@
1
+ # dsh-workplan 1.12.0 — 低风险补丁 rebase、理解与分配护栏、分步进度折叠
2
+
3
+ 发布日期:2026-11-02
4
+
5
+ 1.12.0 把四批改动收敛到同一条发布链上:**T11 的 15 个低风险缺陷**重新 rebase 到 1.11.1 之上、**任务理解与部门分配**补上可执行护栏、**分步进度**改为默认收起、点击展开,以及**默认自动派发 + 验收稳定编号(U-16)**收口。全量回归 **459 / 459 通过、0 失败**。
6
+
7
+ ## 亮点
8
+
9
+ ### 1. 15 个低风险缺陷,44 个 hunk 全部有回归
10
+
11
+ - 45 个源 hunk:31 个可直用、11 个按新上下文改写、3 个废弃(D-15 / D-17 已被 1.11.0 以不同实现修好,强打会回退);最终 44 个 patch hunk、7 个文件。
12
+ - 每个 hunk 至少 1 条可执行用例,新增 52 条;在未打补丁的基线上同批对照,**43 / 44 个 hunk 为 fail-before**。唯一例外(hunk 33 / D-19)在基线本就拒绝环,已标注为「补独立基线」,不冒充判别力。
13
+ - 覆盖缺陷:`D-04 / D-07 / D-08 / D-09 / D-10 / D-11 / D-15 / D-17 / D-19 / D-21 / D-28 / D-30 / D-31 / D-35 / D-45`。
14
+
15
+ ### 2. 任务理解与部门分配:从「只有枚举」到「有锚点、有理由、能拒绝」
16
+
17
+ - **只读锚点**:用户原文 + `sha256` 存进计划;哈希不一致即降级,不带着被改写的「原要求」通过校验。
18
+ - **要素抽取**:版本号、日期、编号、路径、数量、数值边界、指代、矛盾;无上下文的裸「它」判 `needs-context`,不猜。
19
+ - **部门能力目录**:12 个部门各有职责、典型产物、关键词;分配输出 `fit / weak / mismatch`,受保护部门还会检查「原任务从未涉及该领域」的侵入。
20
+ - **偏离自检**:硬要素缺失、交付动作缺失、部门矛盾会被 `DEVIATION:` / `CLARIFY:` / `CONTEXT:` 阻断并走既有重试,不派发。
21
+ - **回退开关**:`DSH_WORKPLAN_CONTEXT_GUARD=off` 时审计照常运行、只告警不阻断。
22
+
23
+ 真实历史计划回放:41 个子任务 `fit 41/41`、`mismatch 0`;一个含 7 个硬要素的样本 0 丢失。这只证明「旧计划不被误伤」,**不证明真实模型对新任务的理解质量**。
24
+
25
+ ### 3. 自动化闭环:预算到点不再丢状态
26
+
27
+ 修掉 4 组「看起来在跑、实际丢状态」的缺陷:预算到点不再把 `escalated` / `instructed` / `replanned` 重置为 `pending`;`replanned` 旧行不再被当作待续跑;`HAS_BLOCKED` 不再被 `NOTHING_PENDING` 抢先;修正 3 处「自动续跑默认关闭」的错误文案与 1 处不存在的强制派发注释。
28
+
29
+ ### 4. 分步进度:默认收起,点一下展开
30
+
31
+ - 每行默认收起,只显示状态点、第 N 步名称、进度条、done/total、状态词;
32
+ - 点击行或键盘 Enter / Space 展开该步摘要(目标、检查点、子任务状态),再次触发收起;
33
+ - `aria-expanded` / `aria-controls` 与 `hidden` 面板同步,点击不冒泡到外层卡片;
34
+ - 展开状态按会话持久化(`dsh-workplan:planrow-open:v1:<sessionId>`),刷新后恢复;localStorage 不可用时降级为纯内存。
35
+
36
+ ### 5. 默认自动派发与验收编号(U-16)
37
+
38
+ - **自动派发**:计划落地后立即以 async 方式调用 `dispatchPlan`,结果仍由 `finishRound` 写回;计划消息改为「已自动派发,不要重复调用 dispatch」。plan 模式不自动派发;`autoDispatch:false` 或 `DSH_WORKPLAN_AUTO_DISPATCH=0` 可回到 plan-first。预算、取消、幂等、交付门禁与自动续跑保留。
39
+ - **验收编号**:子提示词把计划验收编号为 A1…An,证据必须按编号对号入座;`acceptanceCoverage` 去掉反向包含,计划要求「通过登录测试与越权测试」时,只写「通过登录测试」不再算覆盖。复跑探针 `BYPASS=BLOCKED`。
40
+
41
+ ## 验证
42
+
43
+ | 检查 | 结果 |
44
+ |---|---|
45
+ | `npm run check` | exit 0 |
46
+ | `npm test` | **459 / 459 pass,0 fail,exit 0** |
47
+ | 版本一致性 | 10 个声明点全部 `1.12.0`(`node _t14_release_20261102/verify_version.mjs .` → `ALL_EQUAL=1.12.0`) |
48
+ | 基线对照 | 43 / 44 hunk fail-before;基线原套件 364 / 364 |
49
+
50
+ ## 升级
51
+
52
+ ```bash
53
+ dsh plugin --profile web add dsh-workplan@1.12.0
54
+ ```
55
+
56
+ 装完重启 DSH Web(或重新载入页面)。无破坏性变更:`PLAN_VERSION` 仍为 1,未删除或改名任何字段/工具,新增字段全部可选,旧计划按 1.11.1 语义降级回放。
57
+
58
+ ## 已知限制(不折算为已修)
59
+
60
+ - **U-17**:42 条 `present` 缺陷中,12 条由本版 44 个 hunk 覆盖;28 条仍无逐条复验;D-01 / D-13 属高风险补丁范围、未合入本版(D-13 的级联修复已在 1.11.1)。不要把「44 个 hunk 全覆盖」理解成「42 条缺陷全修」。
61
+ - **自动派发的宿主端到端**:默认开启已由配置解析与计划消息单测覆盖;真实宿主里「计划落地即开跑」的端到端演练尚未单独执行,发布后应补一次观察。
62
+ - **真实模型评测**:20 条任务的理解质量 / 部门命中率尚未验证。
63
+ - **真实浏览器点击**:组件级 17 / 17 通过,GUI 手工点验仍需发布前完成。
64
+ - **索引源**:本仓库只能向上游提条目 PR;catalog 的 npm 包由上游 CI 重建,PR 合并前不能写「已上索引」。
65
+
66
+ 完整变更记录见 [CHANGELOG.md](../CHANGELOG.md) 的 `1.12.0` 段。发布操作单与回滚方式见 `_t14_release_20261102/T14_1.12.0发布操作单_20261102.md`。
@@ -0,0 +1,61 @@
1
+ # Release record — dsh-workplan 1.11.1 (2026-11-02)
2
+
3
+ Patch release on top of 1.11.0. It fixes a defect that 1.11.0 claimed but did not
4
+ actually enforce at the data layer.
5
+
6
+ ## Source
7
+
8
+ | Item | Value |
9
+ | --- | --- |
10
+ | Commit | `f7c92dc` |
11
+ | Tag | `v1.11.1` (annotated object `06b2b1881809d3cc770292be767447a4505b296c`) |
12
+ | Version declarations | `package.json`, `package-lock.json` (2), `src/host.ts` meta, `CHANGELOG.md`, `README.md`, `README.en.md` — all `1.11.1` |
13
+ | Base | `v1.11.0` @ `71f0b65` |
14
+
15
+ ## What changed
16
+
17
+ `applyReplanStatuses` now cascades a cancelled upstream through the dependency
18
+ graph instead of only marking the cancelled row:
19
+
20
+ - direct dependents become `blocked` with `blockedBy` pointing at the cancelled row;
21
+ - transitive dependents become `blocked` with an error that names the root
22
+ cancelled row and the cancellation reason;
23
+ - live path and replay path use the same function, so a refresh cannot revert
24
+ the cascade.
25
+
26
+ Before this, `probe_d13.mjs` reported `FAIL(before)` against the released 1.11.0
27
+ `lib/`; after the fix it reports `PASS` against the `v1.11.1` tag build.
28
+
29
+ ## Verification
30
+
31
+ | Check | Result |
32
+ | --- | --- |
33
+ | `npm run check` | exit 0 |
34
+ | `npm test` | **364 / 364 passed, 0 failed** |
35
+ | `probe_d13.mjs lib` on the tag clone | `PASS: D-13 cancel cascades A -> B -> C` |
36
+ | Clean-clone build + pack | succeeded |
37
+
38
+ ## GitHub Release
39
+
40
+ - URL: https://github.com/abbaababa/dsh-workplan/releases/tag/v1.11.1
41
+ - Asset: `dsh-workplan-1.11.1.tgz`
42
+ - Size: 918,951 bytes
43
+ - SHA-256: `6cb91fe77f540068186bb9a47198742c2ee5ce58705bd0fa4a56e2260026e0a1`
44
+
45
+ ## npm
46
+
47
+ - `dsh-workplan@1.11.1` published; registry propagation can take a few minutes
48
+ before `npm view dsh-workplan@latest version` reports it.
49
+
50
+ ## Catalog index
51
+
52
+ - PR https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/11316 updated
53
+ to `v1.11.1/dsh-workplan-1.11.1.tgz` (OPEN, MERGEABLE, single file).
54
+ - The upstream catalog npm package is still rebuilt by the upstream CI; this
55
+ repository cannot publish it.
56
+
57
+ ## Known limits (unchanged from 1.11.0)
58
+
59
+ SSE push (4 s polling), department duties as data, contract v2, checkpoint
60
+ runtime semantics, child-session shell guard, per-artifact locking, and the
61
+ remaining medium/low items in `_t10_defect_triage_20261102/defects.json`.
@@ -32,7 +32,8 @@
32
32
  * re-running a done subtask cannot fix a missing acceptance item, it only
33
33
  * produces duplicate work and a chance to overwrite the evidence.
34
34
  *
35
- * Default: **off**. See `AUTO_RESUME_DEFAULTS.enabled`.
35
+ * Default: **on**. `AUTO_RESUME_DEFAULTS.enabled = true`; turn it off with
36
+ * profile `autoResume: false` or `DSH_WORKPLAN_AUTO_RESUME=0`.
36
37
  */
37
38
  /** Tunables that are policy, not deployment config. */
38
39
  export const AUTO_RESUME_DEFAULTS = Object.freeze({
@@ -99,6 +100,25 @@ export function autoResumeEnabledFrom(configValue, envValue) {
99
100
  }
100
101
  return AUTO_RESUME_DEFAULTS.enabled === true;
101
102
  }
103
+ /**
104
+ * [1.12.0] Count the rows that still participate in scheduling.
105
+ *
106
+ * A `closure:'replanned'` row keeps `status:'pending'` for audit. Counting it as
107
+ * pending made `armAutoResume` schedule a continuation round that could dispatch
108
+ * nothing (every live row was done) and then append a misleading
109
+ * `PHASE_NOT_PAUSED` stop line to `record.errors`.
110
+ *
111
+ * `armAutoResume` now passes these counts to `decideAutoResume`; `total` there
112
+ * still comes from `derivePlanSnapshot` (same live-row rule).
113
+ *
114
+ * @param statuses - the plan's status list.
115
+ * @returns live `done` / `pending` / `blocked` counts.
116
+ */
117
+ export function liveResumeCounts(statuses) {
118
+ const live = (Array.isArray(statuses) ? statuses : []).filter((item) => item?.closure !== 'replanned');
119
+ const count = (status) => live.filter((item) => item?.status === status).length;
120
+ return { done: count('done'), pending: count('pending'), blocked: count('blocked') };
121
+ }
102
122
  /**
103
123
  * Decide whether one more round may start, and when.
104
124
  *
@@ -107,8 +127,8 @@ export function autoResumeEnabledFrom(configValue, envValue) {
107
127
  * 2. user stop (`cancelled`, `superseded`) — never resurrect a decision
108
128
  * 3. already running / plan mode
109
129
  * 4. only a `paused` phase is auto-continuable
110
- * 5. nothing pending (includes "all done, evidence gap" — human work)
111
- * 6. any `blocked` row — a real failure, not a budget artifact
130
+ * 5. any `blocked` row — a real failure, not a budget artifact
131
+ * 6. nothing pending (includes "all done, evidence gap" — human work)
112
132
  * 7. attempt / progress budgets
113
133
  *
114
134
  * @param input - the frozen facts of the round that just ended.
@@ -125,7 +145,7 @@ export function decideAutoResume(input) {
125
145
  delayMs: 0,
126
146
  });
127
147
  if (input.enabled !== true) {
128
- return stop('AUTO_RESUME_DISABLED', '自动续跑开关未开启(默认关闭)');
148
+ return stop('AUTO_RESUME_DISABLED', '自动续跑开关未开启(已被显式关闭:profile autoResume:false 或 DSH_WORKPLAN_AUTO_RESUME=0)');
129
149
  }
130
150
  if (input.degraded === true || Number(input.total) <= 0) {
131
151
  return stop('NO_PLAN', '没有可续跑的计划(自动分解降级或子任务数为 0)');
@@ -145,6 +165,17 @@ export function decideAutoResume(input) {
145
165
  if (input.phase !== 'paused') {
146
166
  return stop('PHASE_NOT_PAUSED', `计划阶段是 ${String(input.phase ?? 'unknown')},只有 paused(预算到点)才自动续跑`);
147
167
  }
168
+ /*
169
+ * [1.12.0] 「有 blocked」先于「没有 pending」(T11)。
170
+ *
171
+ * 旧顺序把 `done=N, blocked=1, pending=0` 判成 NOTHING_PENDING(证据缺口),
172
+ * 而真正要处理的是那条 blocked 行。1.12 起预算到点会保留等指示行并把阶段写成
173
+ * blocked(PHASE_NOT_PAUSED 先命中),但历史会话回放仍可能出现 paused + blocked,
174
+ * 所以这里按可执行的优先序回答。
175
+ */
176
+ if (Number(input.blocked) > 0) {
177
+ return stop('HAS_BLOCKED', `存在 ${input.blocked} 个 blocked 子任务:那是真实失败,需人工改判或显式续跑,不自动修复`);
178
+ }
148
179
  if (Number(input.pending) <= 0) {
149
180
  /*
150
181
  * Also the evidence-gap case: all rows done but deliveryReady=false.
@@ -153,9 +184,6 @@ export function decideAutoResume(input) {
153
184
  */
154
185
  return stop('NOTHING_PENDING', '没有 pending 项:若仍未就绪,那是证据缺口,需主 Agent 复核,不能靠重跑 done 项解决');
155
186
  }
156
- if (Number(input.blocked) > 0) {
157
- return stop('HAS_BLOCKED', `存在 ${input.blocked} 个 blocked 子任务:那是真实失败,需人工改判或显式续跑,不自动修复`);
158
- }
159
187
  if (attempt >= maxAttempts) {
160
188
  return stop('BUDGET_EXHAUSTED', `自动续跑已用满 ${maxAttempts} 轮,交给主 Agent 决定`);
161
189
  }