dsh-workplan 1.8.18 → 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 +159 -0
- package/README.en.md +1 -1
- package/README.md +1 -1
- package/client.js +1 -0
- package/docs/postmortem-1.8.7-20261031.md +113 -0
- package/docs/release-notes-1.9.1.md +67 -0
- package/lib/host.js +105 -5
- package/lib/plan.js +151 -1
- package/lib/runtime.js +390 -37
- package/lib/supersede-digest.js +115 -0
- package/lib/supersede.js +378 -0
- package/package.json +2 -2
- package/src/client.ts +1 -0
- package/src/host.ts +113 -4
- package/src/plan.ts +166 -1
- package/src/runtime.ts +416 -35
- package/src/supersede-digest.ts +116 -0
- package/src/supersede.ts +429 -0
package/CHANGELOG.md
CHANGED
|
@@ -1,3 +1,162 @@
|
|
|
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
|
+
|
|
1
160
|
## 1.8.18 — 2026-10-31
|
|
2
161
|
|
|
3
162
|
**修复:`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.
|
|
80
|
+
dsh plugin --profile web add dsh-workplan@1.9.1
|
|
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
package/client.js
CHANGED
|
@@ -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 调用工具。
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# v1.9.1 — 圈注三行能自己变绿,1.9.0 的四项遗留全修完
|
|
2
|
+
|
|
3
|
+
## 一句话
|
|
4
|
+
|
|
5
|
+
`dsh_workplan_followup` 让被中止的子会话在**用户授权后自己再跑完一个正常回合**,
|
|
6
|
+
界面据此变绿;同时把 1.9.0 明确留到「下一批」的四项(superseded 写侧、P1 拒绝码、
|
|
7
|
+
W1 digest、W5 真实取消联测)全部落地。npm 上此前最新是 **1.8.18**,`1.9.0` 与
|
|
8
|
+
`1.9.1` 都从未发布,所以升到 1.9.1 会一次性拿到 1.9.0 与 1.9.1 的全部修复。
|
|
9
|
+
|
|
10
|
+
## 你会看到什么变化
|
|
11
|
+
|
|
12
|
+
| 之前 | 现在 |
|
|
13
|
+
|---|---|
|
|
14
|
+
| 被整轮预算 / 900s 上限中止的子会话永远是灰点(`lastTurnCompleted=false`),改台账也不会变绿 | `dsh_workplan_followup` 把说明投递给父会话登记过的**直接**子会话;子会话自己跑完一轮后 `turn/end` 正常,界面自然变绿 |
|
|
15
|
+
| 想把一个已取消计划的交付责任转给另一个计划,只能手改记录 → 重启后 live 与 replay 分叉 | `dsh_workplan_cancel` 支持 `disposition:'superseded'` + `supersededBy`,V1–V8 核验全过才写、`coverage`/`digest` 由运行时复算,append 成功才翻内存状态 |
|
|
16
|
+
| 全部子任务 done 但证据有缺口时,`present` 的拒绝码是 `ACTIVE_NOT_READY`,用户分不清「没做完」和「证据不齐」 | 统一走 `activeDenyCode()`:`remaining` 空 + `blockers` 非空 ⇒ `EVIDENCE_GAP`,其余 ⇒ `ACTIVE_NOT_READY`;拒绝文案不变 |
|
|
17
|
+
| 覆盖映射存进日志后无法复核是否被改动 | `sha256(canonical(mapping))` 规范化摘要(sort_keys + 紧凑分隔符 + 非 ASCII 不转义),读侧只重算、不信任缓存值,重算不一致即 stale |
|
|
18
|
+
| 取消 / 取代的信封只在单测里用桩件验证 | W5 联测直接走真实 `buildCancelMessage` 信封 → durable 记录 → replay 读回,覆盖两种处置与终态互斥 |
|
|
19
|
+
|
|
20
|
+
## 修复内容
|
|
21
|
+
|
|
22
|
+
### 1. `dsh_workplan_followup`(1.9.1 主体)
|
|
23
|
+
|
|
24
|
+
- 只允许根会话调用;目标必须是父会话 `subagent/catalog` 里登记的**直接**子会话。
|
|
25
|
+
- 只投递、不改状态:不写台账、不触发 `present`、不改 `lastTurnCompleted`;
|
|
26
|
+
是否变绿由子会话自己的下一轮 `turn/end` 决定。
|
|
27
|
+
- 拒绝码:`NOT_ROOT` / `NOT_DIRECT_CHILD` / `NO_SUBAGENT_SERVICE` / `DELIVERY_FAILED`;
|
|
28
|
+
空 message 或超 4000 字符直接拒绝。
|
|
29
|
+
|
|
30
|
+
### 2. superseded 写侧(唯一入口)
|
|
31
|
+
|
|
32
|
+
- `src/supersede.ts`:`supersedePlanRecord()` 是 `superseded` 的唯一写路径;
|
|
33
|
+
V1–V8 任一失败返回 `ok:false` + `SUPERSEDE_*` 码,**不改内存、不写日志**。
|
|
34
|
+
- `src/plan.ts`:`buildCancelMessage(..., { disposition:'superseded' })` 是全仓库唯一
|
|
35
|
+
拼装 `workplan-cancel` 信封的出口;自动覆盖路径只允许写 `cancelled`。
|
|
36
|
+
- 用户确认(V8)必须是真实用户消息:同时包含两个 planId 且含
|
|
37
|
+
「确认/同意/可以/按此执行」之一;模型自述不算确认。
|
|
38
|
+
|
|
39
|
+
### 3. P1 拒绝码统一
|
|
40
|
+
|
|
41
|
+
- `PRESENT_DENY_CODES` + `activeDenyCode()` 收敛 `present` 的两个未完成分支;
|
|
42
|
+
码值对外可断言,文案逐字保留;`EVIDENCE_GAP` 散落字符串 0 处。
|
|
43
|
+
|
|
44
|
+
### 4. W1 digest
|
|
45
|
+
|
|
46
|
+
- `src/supersede-digest.ts`:`canonicalMappingJson()` / `computeMappingDigest()` /
|
|
47
|
+
`verifyMappingDigest()` / `withMappingDigest()`;摘要只证明「存下来的 mapping
|
|
48
|
+
没被改动」,不证明两项工作在语义上等价。
|
|
49
|
+
|
|
50
|
+
### 5. W5 真实取消信封联测
|
|
51
|
+
|
|
52
|
+
- `tests/workplan-w5-cancel-e2e.test.ts` 5 例:1.8.19 真实信封字段契约不变、
|
|
53
|
+
事故同构场景、生产写路径 schema 一致、D2 未放宽、superseded 增量字段降级可读。
|
|
54
|
+
|
|
55
|
+
## 升级与兼容
|
|
56
|
+
|
|
57
|
+
- 旧调用不受影响:`dsh_workplan_cancel` 的 `disposition` 缺省仍是 `cancelled`。
|
|
58
|
+
- 旧会话可回放:`superseded` 是增量字段,旧读侧按 `cancelled` 降级可读。
|
|
59
|
+
- 需要 Node ≥ 22(`engines.node` 未变)。
|
|
60
|
+
|
|
61
|
+
## 证据(发布时复核)
|
|
62
|
+
|
|
63
|
+
- `npm run check` EXIT 0(无诊断)。
|
|
64
|
+
- `npm test` EXIT 0:**306 / 306**(1.9.0 基线 277,净增 29)。
|
|
65
|
+
- 两次构建 7 个产物(`lib/*.js` + `client.js`)sha256 完全一致。
|
|
66
|
+
- `npm pack`:产物清单、体积与 `shasum` 在发布记录 `docs/release-record-1.9.1-20261101.md` 中逐项登记
|
|
67
|
+
(本文件自身也在包内,因此不在此处写会随本文件变化的体积数字)。
|
package/lib/host.js
CHANGED
|
@@ -101,6 +101,7 @@ const PROMPT_SECTION = [
|
|
|
101
101
|
*/
|
|
102
102
|
'5. 「完成」只有一个判据:计划里全部子任务都是 done,**且** deliveryReady=true(每个 done 项 verification="structured"、acceptance 非空且逐项 result="pass"、无缺失产物)。用户取消 ≠ 完成:取消只停止执行,未完成项仍然是未完成。`dsh_workplan_dispatch` 返回 ok:true / complete:true 只表示调用成功或状态全 done,必须再看 deliveryReady 与 完成 X/Y;只要 deliveryReady=false 或还有 pending/blocked,就禁止 present 交付物、禁止写“已完成/最终版/已交付”、禁止给收尾性最终答复,必须先再次调用 dsh_workplan_dispatch 续跑剩余项。',
|
|
103
103
|
'6. 如果续跑被拒绝、受阻项无法恢复、证据补不齐、计划已取消但未完成,或用户要求先看中间结果:答复开头必须写「未完成:剩余 N 项(列出 ID)与原因」,正文只能按中间结果表述,不得包装成成品。取消不会给你交付许可。',
|
|
104
|
+
'7. 子任务有硬执行上限(默认 15 分钟/步)与整轮预算(默认 20 分钟):子 Agent 接近上限时应先把已完成内容落盘并在结论里列出路径。任何「达到执行上限」「本轮预算用尽」都不等于「什么都没做」:状态里的 error 会列出「声明产物已在盘上」,必须先用文件核对;若产物已覆盖验收标准,用 dsh_workplan_update 复核改判,只补缺失部分再续跑,禁止无视盘上产物把整步重跑。',
|
|
104
105
|
'结果消息里每个完成项都带 verification 与 acceptance:`structured` 是子 Agent 逐条自检通过,`unverified` 是自述但未逐条确认,`failed` 是自检失败(已按受阻处理),`legacy` 是旧格式回传。只有 structured 且 acceptance 每项 pass 才算可交付;其余必须你自己核对产物,并用 dsh_workplan_update 的 verification/acceptance/artifacts 字段把核对结果写回(这些字段会持久化、刷新后仍生效),不要把“看着没问题”当成证据。',
|
|
105
106
|
'子 Agent 通过 `needs` 提出的跨部门需求会列在结果消息的「跨部门待转达」里:由你逐条处理(补派、向用户确认或直接完成),不要忽略。',
|
|
106
107
|
'长任务可以用 `dsh_workplan_dispatch({ mode: "async" })` 先开跑并立即答复用户,再用 `dsh_workplan_status` 查看进度;async 返回的是“已开跑”,不是“已完成”。',
|
|
@@ -253,7 +254,12 @@ function createCancelTool(runtime) {
|
|
|
253
254
|
description: '取消当前会话尚未派发/正在等待派发的任务分解计划。仅取消计划记录,不伪造任何完成;'
|
|
254
255
|
+ '取消后计划在面板中显示为“已取消”,不会启动任何部门 Agent。'
|
|
255
256
|
+ '注意:取消不等于完成。取消后如仍有未完成项或证据缺口,present 仍会被拒绝,'
|
|
256
|
-
+ '答复必须按「未完成:剩余 N 项与原因」说明。'
|
|
257
|
+
+ '答复必须按「未完成:剩余 N 项与原因」说明。'
|
|
258
|
+
+ 'disposition="superseded" 是另一种处置:把交付责任转移给一个可验证的承接计划。'
|
|
259
|
+
+ '运行时逐条复算(V1–V8):源计划必须已取消且未全 done、承接计划必须定义更晚且非终态、'
|
|
260
|
+
+ '映射必须覆盖源计划全部子任务、每个映射目标必须有 done+structured 证据与全通过的验收、'
|
|
261
|
+
+ '且本会话存在同时含两个 planId 的用户确认消息。任一不满足即拒绝并返回 SUPERSEDE_* 码,'
|
|
262
|
+
+ '状态不变;被取代不等于完成。',
|
|
257
263
|
parameters: {
|
|
258
264
|
type: 'object',
|
|
259
265
|
properties: {
|
|
@@ -263,7 +269,39 @@ function createCancelTool(runtime) {
|
|
|
263
269
|
},
|
|
264
270
|
reason: {
|
|
265
271
|
type: 'string',
|
|
266
|
-
description: '
|
|
272
|
+
description: '取消/取代原因,会写入会话记录。',
|
|
273
|
+
},
|
|
274
|
+
disposition: {
|
|
275
|
+
type: 'string',
|
|
276
|
+
enum: ['cancelled', 'superseded'],
|
|
277
|
+
description: '处置方式:cancelled=用户撤销(默认);superseded=责任已转移给承接计划。',
|
|
278
|
+
},
|
|
279
|
+
supersededBy: {
|
|
280
|
+
type: 'object',
|
|
281
|
+
description: 'disposition=superseded 时必填:承接计划与逐项覆盖映射。'
|
|
282
|
+
+ '只给映射意图,requiredCount/coveredCount/coverage/digest 由运行时复算,不接受自报。',
|
|
283
|
+
properties: {
|
|
284
|
+
planId: {
|
|
285
|
+
type: 'string',
|
|
286
|
+
description: '承接计划的 planId(必须定义得过且未终止)。',
|
|
287
|
+
},
|
|
288
|
+
mapping: {
|
|
289
|
+
type: 'array',
|
|
290
|
+
description: '源计划每个定义子任务一条映射;from 必须恰好覆盖全部源项(各一次)。',
|
|
291
|
+
items: {
|
|
292
|
+
type: 'object',
|
|
293
|
+
properties: {
|
|
294
|
+
from: { type: 'string', description: '源计划子任务 ID。' },
|
|
295
|
+
to: { type: 'string', description: '承接计划子任务 ID。' },
|
|
296
|
+
basis: { type: 'string', description: '覆盖依据(为什么这两项是同一责任)。' },
|
|
297
|
+
},
|
|
298
|
+
required: ['from', 'to', 'basis'],
|
|
299
|
+
additionalProperties: false,
|
|
300
|
+
},
|
|
301
|
+
},
|
|
302
|
+
},
|
|
303
|
+
required: ['planId', 'mapping'],
|
|
304
|
+
additionalProperties: false,
|
|
267
305
|
},
|
|
268
306
|
},
|
|
269
307
|
additionalProperties: false,
|
|
@@ -272,9 +310,18 @@ function createCancelTool(runtime) {
|
|
|
272
310
|
schema: cancelToolOutputSchema(),
|
|
273
311
|
render(_args, value) {
|
|
274
312
|
const result = isRecord(value) ? value : {};
|
|
275
|
-
if (!result.ok)
|
|
276
|
-
return textContent(
|
|
313
|
+
if (!result.ok) {
|
|
314
|
+
return textContent(`处置失败${result.code ? `(${String(result.code)})` : ''}:`
|
|
315
|
+
+ `${String(result.error ?? '未知错误')}`);
|
|
316
|
+
}
|
|
277
317
|
const stats = isRecord(result.stats) ? result.stats : {};
|
|
318
|
+
if (result.phase === 'superseded') {
|
|
319
|
+
const by = isRecord(result.supersededBy) ? result.supersededBy : {};
|
|
320
|
+
return textContent(`计划 ${String(result.planId ?? '')} 已被取代:承接计划 ${String(by.planId ?? '')}`
|
|
321
|
+
+ `(映射 ${Number(by.coveredCount ?? 0)}/${Number(by.requiredCount ?? 0)},digest 已复算)`
|
|
322
|
+
+ `|源计划仍是 ${Number(stats.done ?? 0)}/${Number(stats.total ?? 0)}:被取代不等于完成,`
|
|
323
|
+
+ '不得 present 源计划,只能使用承接计划通过交付就绪检查的产物。');
|
|
324
|
+
}
|
|
278
325
|
const cancelledIncomplete = result.phase !== 'done';
|
|
279
326
|
return textContent(`已取消计划 ${String(result.planId ?? '')}:${String(result.reason ?? '用户取消')}`
|
|
280
327
|
+ `(完成 ${Number(stats.done ?? 0)}/${Number(stats.total ?? 0)})`
|
|
@@ -291,6 +338,58 @@ function createCancelTool(runtime) {
|
|
|
291
338
|
},
|
|
292
339
|
};
|
|
293
340
|
}
|
|
341
|
+
function createFollowupTool(runtime) {
|
|
342
|
+
return {
|
|
343
|
+
name: 'dsh_workplan_followup',
|
|
344
|
+
description: '把一条说明投递给本会话的某个**直接子会话**,让它继续跑一个正常回合。'
|
|
345
|
+
+ '用途仅限:子任务被预算/超时中止、但产物已在盘上,且用户明确同意补发 follow-up 时,'
|
|
346
|
+
+ '让子会话自己收尾,从而让它自己的 turn/end 变成 completed。'
|
|
347
|
+
+ '它不写计划状态、不触发交付、也不改变界面判定;投递本身不等于完成。'
|
|
348
|
+
+ '不是直接子会话(父会话 catalog 未登记)一律拒绝。',
|
|
349
|
+
parameters: {
|
|
350
|
+
type: 'object',
|
|
351
|
+
properties: {
|
|
352
|
+
sessionId: {
|
|
353
|
+
type: 'string',
|
|
354
|
+
description: '直接子会话 ID(父会话 subagent/catalog 中登记的那一个)。',
|
|
355
|
+
},
|
|
356
|
+
message: {
|
|
357
|
+
type: 'string',
|
|
358
|
+
description: '发给子会话的说明:确认已有产物、只补缺口、不要整步重跑;不要要求它伪造完成。',
|
|
359
|
+
},
|
|
360
|
+
},
|
|
361
|
+
required: ['sessionId', 'message'],
|
|
362
|
+
additionalProperties: false,
|
|
363
|
+
},
|
|
364
|
+
output: {
|
|
365
|
+
schema: {
|
|
366
|
+
type: 'object',
|
|
367
|
+
properties: {
|
|
368
|
+
ok: { type: 'boolean' },
|
|
369
|
+
sessionId: { type: 'string' },
|
|
370
|
+
messageId: { type: 'string' },
|
|
371
|
+
code: { type: 'string' },
|
|
372
|
+
error: { type: 'string' },
|
|
373
|
+
},
|
|
374
|
+
required: ['ok'],
|
|
375
|
+
additionalProperties: true,
|
|
376
|
+
},
|
|
377
|
+
render(_args, value) {
|
|
378
|
+
const result = isRecord(value) ? value : {};
|
|
379
|
+
if (!result.ok) {
|
|
380
|
+
return textContent(`follow-up 未投递:${String(result.error ?? result.code ?? '未知错误')}`);
|
|
381
|
+
}
|
|
382
|
+
return textContent(`已向子会话 ${String(result.sessionId ?? '')} 投递 follow-up`
|
|
383
|
+
+ (result.messageId ? `(messageId ${String(result.messageId)})` : '')
|
|
384
|
+
+ '。投递只代表消息被接收;界面状态要等该子会话自己的回合正常结束才会变化。');
|
|
385
|
+
},
|
|
386
|
+
},
|
|
387
|
+
async execute(args, exec) {
|
|
388
|
+
const parsed = asObject(args) ?? {};
|
|
389
|
+
return runtime.followupTool(exec.agent, parsed, exec.signal);
|
|
390
|
+
},
|
|
391
|
+
};
|
|
392
|
+
}
|
|
294
393
|
function createStatusTool(runtime) {
|
|
295
394
|
return {
|
|
296
395
|
name: 'dsh_workplan_status',
|
|
@@ -501,6 +600,7 @@ export function apply(ctx, config = {}) {
|
|
|
501
600
|
ctx.effect(() => ctx.tools.register(createUpdateTool(runtime)));
|
|
502
601
|
ctx.effect(() => ctx.tools.register(createCancelTool(runtime)));
|
|
503
602
|
ctx.effect(() => ctx.tools.register(createStatusTool(runtime)));
|
|
603
|
+
ctx.effect(() => ctx.tools.register(createFollowupTool(runtime)));
|
|
504
604
|
ctx.effect(() => ctx.tools.register(createDispatchTool(runtime)));
|
|
505
605
|
/*
|
|
506
606
|
* Plan mode produces a plan for review, not department execution. Denying
|
|
@@ -573,7 +673,7 @@ export function apply(ctx, config = {}) {
|
|
|
573
673
|
}
|
|
574
674
|
export const meta = {
|
|
575
675
|
name,
|
|
576
|
-
version: '1.
|
|
676
|
+
version: '1.9.1',
|
|
577
677
|
promptOrder: PROMPT_ORDER,
|
|
578
678
|
routes: ['/dsh-workplan/plans', '/dsh-workplan/vendor/chart.umd.js'],
|
|
579
679
|
};
|