dsh-agent-board 1.9.0 → 1.9.2

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.
@@ -0,0 +1,458 @@
1
+ // dsh-agent-board — 可编程故障供应商层测试(test/fault-provider.test.mjs)
2
+ // 锁五档行为 + 必备观测面(验收口径):
3
+ // ① 秒拆文本前缀匹配 isModelKillFailure 口径——e2e 熔断旅程三连拉黑锁全链(badModels 只认模型面失败)
4
+ // ② 限流文本能被 parseModelCooldown 命中(中文带重置形态)——e2e 冷却登记锁全链
5
+ // ③ 目录 shrink 后 listModels/listProviders 反映(运行中可变,每次现取不缓存)
6
+ // ④ spawn 日志逐条留痕(model 复合格式重构 = 取模链拆分点的逆操作)
7
+ // ⑤ 缺省 createMockCtx 零故障表时行为与现状一致(hasActivationApi 路径保全 + 抽样 integration 断言路径)
8
+ // ⑥ hang 挂死(result 永不落定 + 真日志文件 writeChildLog 布局 + 零事件)
9
+ // ⑦ empty 空响应(output text=''; continuable 面空文本失败结算)
10
+ // ⑧ slow 慢响应(虚拟时钟延时后正常落定)
11
+ // ⑨ 次数窗口(times: N 前 N 次命中后自愈)
12
+ // ⑩ llm.stream 桩(probeModel 消费口径:finish/stop 健康、finish/error+failure.message 失败)
13
+ // 端到端用例全部跑在「真实 index.mjs apply(mockCtx)」上:installFaults 必须先于 plugin.apply;
14
+ // 每用例独立 mockCtx + 独立临时 HOME,互不污染(顶层用例默认串行,严禁并行)。
15
+ import { test } from 'node:test'
16
+ import assert from 'node:assert/strict'
17
+ import fs from 'node:fs'
18
+ import path from 'node:path'
19
+ import { createMockCtx } from './helpers/mock-ctx.mjs'
20
+ import { installFaults } from './helpers/fault-provider.mjs'
21
+ import { parseModelCooldown } from '../lib/dispatch.mjs'
22
+ import * as plugin from '../index.mjs'
23
+
24
+ // 把 os.homedir() 钉到本用例临时 HOME(Windows 认 USERPROFILE——事件结算读子会话日志的
25
+ // findRunLog 回退路径 os.homedir()/.dsh/sessions 才能命中 <home> 下的故障日志)
26
+ function pinHomedir(env) {
27
+ var had = Object.prototype.hasOwnProperty.call(process.env, 'USERPROFILE')
28
+ var prev = process.env.USERPROFILE
29
+ process.env.USERPROFILE = env.home
30
+ return function () { if (had) process.env.USERPROFILE = prev; else delete process.env.USERPROFILE }
31
+ }
32
+ // 故障日志文件路径(writeChildLog 布局:<home>/.dsh/sessions/<桶>/<childId>/session.v4.jsonl.zstd)
33
+ function childLogPath(env, childId, bucket) {
34
+ return path.join(env.home, '.dsh', 'sessions', bucket || 'test-bucket', childId, 'session.v4.jsonl.zstd')
35
+ }
36
+ // 建卡封装(显式 description 避开空描述软提示;pipeline=work 只做不验,验证旅程不被 Verifier 干扰)
37
+ async function createTask(env, id, extra) {
38
+ var args = { sessionId: env.sid, id: id, title: '故障注入任务 ' + id, description: 'fault-provider 用例 ' + id, pipeline: 'work' }
39
+ if (extra) { for (var k in extra) args[k] = extra[k] }
40
+ var r = await env.rpc('create-task', args)
41
+ assert.equal(r.ok, true, 'create-task 成功: ' + id)
42
+ return r.task
43
+ }
44
+ // 捕获 result 的拒绝值(裸字符串):防御性空 catch 已由 provider 就地挂好,这里追加消费者取文本
45
+ async function rejectionOf(result) {
46
+ var text = null
47
+ result.catch(function (e) { text = String(e) })
48
+ await new Promise(function (r) { setImmediate(r) })
49
+ return text
50
+ }
51
+
52
+ // ===== 缺省①:createMockCtx 零故障时行为与现状逐字一致(零回归红线)=====
53
+ test('缺省①:零 installFaults——subagents 无 startActivation(hasActivationApi 路径保全)+ 抽样 integration 断言路径', async () => {
54
+ var env = createMockCtx()
55
+ try {
56
+ assert.ok(typeof env.ctx.subagents.startActivation !== 'function', '缺省 subagents 不得带 startActivation(spawn 路径不翻)')
57
+ assert.equal(env.faults, undefined, '缺省无 faults 观测面')
58
+ plugin.apply(env.ctx)
59
+ await createTask(env, 'task-z1')
60
+ await env.clock.advance(50)
61
+ await env.waitFor(function () { return env.continuables.length >= 1 }, 'worker spawn 发生(老 startContinuable 路径)')
62
+ assert.equal(env.continuables[0].label, 'worker:task-z1', 'spawn label 形如 worker:<taskId>')
63
+ assert.equal(env.runs.length, 0, 'Worker 走 continuable 面,不动一次性 start')
64
+ var t = await env.waitFor(function () { var x = env.task('task-z1'); return x && x.status === 'in-progress' && x.claimedBy === env.continuables[0].childId ? x : null }, '落卡 in-progress 且 claimedBy=childId')
65
+ assert.ok(t.runs && t.runs[0] && t.runs[0].continuable === true, 'run 留档 continuable=true(既有口径不变)')
66
+ } finally { await env.cleanup() }
67
+ })
68
+
69
+ // ===== 缺省②:installFaults 无 programs = 纯观察面(spawn 逐字委托 + 日志留痕 + llm 缺省空目录)=====
70
+ test('缺省②:installFaults 无 programs——spawn 逐字委托、日志留痕、llm 目录缺省空(行为与现状一致)', async () => {
71
+ var env = createMockCtx()
72
+ try {
73
+ var h = installFaults(env, { programs: [] })
74
+ plugin.apply(env.ctx)
75
+ assert.equal(h.activation, false, '缺省不合成 startActivation(activation opt-in 缺省 false)')
76
+ assert.ok(typeof env.ctx.subagents.startActivation !== 'function', '无 programs 时同样不加 startActivation')
77
+ await createTask(env, 'task-z2')
78
+ await env.clock.advance(50)
79
+ await env.waitFor(function () { return h.spawnLog.length >= 1 }, 'worker spawn 日志留痕')
80
+ var e = h.spawnLog[0]
81
+ assert.equal(e.method, 'startContinuable', 'method 留痕')
82
+ assert.equal(e.delivery, 'continuable', 'delivery 留痕(老 continuable 路径)')
83
+ assert.equal(e.label, 'worker:task-z2', 'label 留痕')
84
+ assert.equal(e.provider, 'mock-provider', 'provider 留痕')
85
+ assert.equal(e.model, '', '无 modelOverride = 父模型(model 复合串为空)')
86
+ assert.equal(e.fault, null, '无程序命中 → fault=null')
87
+ assert.equal(env.continuables[0].label, 'worker:task-z2', 'spawn 逐字委托(原 label)')
88
+ assert.ok(String(env.continuables[0].childId).indexOf('fault-child-') !== 0, '委托路径不产合成 childId')
89
+ var llm = env.ctx.get('llm')
90
+ assert.deepEqual(llm.listProviders(), [], '缺省目录空 → listProviders [](与原 recorder 一致)')
91
+ assert.deepEqual(await llm.listModels('mock-provider'), [], '缺省目录空 → listModels []')
92
+ assert.equal(Object.keys(h.directory.current()).length, 0, '缺省目录映射为空')
93
+ assert.ok(env.llm.listProviders >= 1, 'llm 调用留痕计数照常累加(原记录器口径)')
94
+ } finally { await env.cleanup() }
95
+ })
96
+ // ===== 五档③:one-shot start 路径五档行为(秒拆/限流/空/慢/挂 + 结果面形态 + spawn 日志逐条)=====
97
+ test('五档③:one-shot start 路径——秒拆/限流/空/慢/挂 各档行为 + 结果面形态 + spawn 日志逐条留痕', async () => {
98
+ var env = createMockCtx()
99
+ try {
100
+ var FIXED = new Date(2026, 9, 27, 19, 0, 0).getTime()
101
+ var h = installFaults(env, { programs: [
102
+ { type: 'instant-kill', diagnostic: 'mock-fault: unit' },
103
+ { type: 'rate-limit', resetAt: FIXED },
104
+ { type: 'empty' },
105
+ { type: 'slow', delayMs: 100, text: 'slow 交付' },
106
+ { type: 'hang' },
107
+ ] })
108
+ var sub = env.ctx.subagents
109
+ // ① instant-kill:result 以裸字符串拒,前缀锚定 isModelKillFailure 口径
110
+ var run1 = await sub.start('p', { label: 'worker:t1' })
111
+ assert.equal(run1.__fault, 'instant-kill', '__fault 留档')
112
+ var t1 = await rejectionOf(run1.result)
113
+ assert.ok(t1 !== null && t1.indexOf('子会话被宿主拆除(stopReason: error') === 0, '秒拆前缀(isModelKillFailure 锚定口径,裸字符串不被 Error: 前缀污染)')
114
+ assert.ok(t1.indexOf('子会话被宿主拆除(stopReason: completed') !== 0, 'stopReason 非 completed(计入熔断)')
115
+ assert.ok(t1.indexOf('mock-fault: unit') > 0, 'diagnostic 落文本')
116
+ // ④ rate-limit:裸字符串拒 + parseModelCooldown 中文带重置命中(精确 until)
117
+ var run2 = await sub.start('p', { label: 'worker:t2' })
118
+ var t2 = await rejectionOf(run2.result)
119
+ assert.ok(t2 !== null && t2.indexOf('429') === 0, '429 开头')
120
+ var hit = parseModelCooldown(t2)
121
+ assert.ok(hit && hit.kind === 'rate-limit' && hit.parsed === true, '限流文本被 parseModelCooldown 命中(中文带重置形态)')
122
+ assert.equal(hit.until, FIXED, '重置时刻 = 程序 resetAt(本地时区精确 ts)')
123
+ // ③ empty:落定 output text=''
124
+ var run3 = await sub.start('p', { label: 'worker:t3' })
125
+ var r3 = await run3.result
126
+ assert.equal(r3.stopReason, 'completed', '空响应 stopReason=completed')
127
+ assert.equal(r3.output[0].text, '', '空响应 output text=\'\'')
128
+ // ⑤ slow:延时(虚拟时钟)后正常落定
129
+ var run4 = await sub.start('p', { label: 'worker:t4' })
130
+ var settledEarly = false
131
+ run4.result.then(function () { settledEarly = true })
132
+ await new Promise(function (r5) { setImmediate(r5) })
133
+ assert.equal(settledEarly, false, '延时未到不落定(虚拟时钟掌控)')
134
+ await env.clock.advance(150)
135
+ var r4 = await run4.result
136
+ assert.equal(r4.stopReason, 'completed')
137
+ assert.equal(r4.output[0].text, 'slow 交付', '延时后正常落定(可编程延时)')
138
+ // ② hang:result 永不落定零事件 + 真日志文件(writeChildLog 布局)
139
+ var run5 = await sub.start('p', { label: 'worker:t5' })
140
+ var settled5 = false
141
+ run5.result.then(function () { settled5 = true })
142
+ await new Promise(function (r6) { setTimeout(r6, 30) })
143
+ assert.equal(settled5, false, '挂死永不落定')
144
+ var lp = childLogPath(env, run5.id)
145
+ assert.ok(fs.existsSync(lp), '挂死真日志文件已写(<home>/.dsh/sessions/<桶>/<runId>/session.v4.jsonl.zstd)')
146
+ assert.ok(fs.statSync(lp).size > 0, '日志文件非空(零产出检测 logSizeOf 有基线)')
147
+ // spawn 日志:5 条逐条留痕(model 复合格式重构 + fault 分档)
148
+ assert.equal(h.spawnLog.length, 5, 'spawn 日志逐条留痕')
149
+ assert.deepEqual(h.spawnLog.map(function (e) { return e.method }), ['start', 'start', 'start', 'start', 'start'])
150
+ assert.deepEqual(h.spawnLog.map(function (e) { return e.fault }), ['instant-kill', 'rate-limit', 'empty', 'slow', 'hang'])
151
+ assert.deepEqual(h.spawnLog.map(function (e) { return e.label }), ['worker:t1', 'worker:t2', 'worker:t3', 'worker:t4', 'worker:t5'])
152
+ } finally { await env.cleanup() }
153
+ })
154
+
155
+ // ===== 次数窗口④:times: 2 → 前 2 次秒拆后自愈(第 3 次起逐字委托原 start)=====
156
+ test('次数窗口④:times: 2——前 2 次秒拆后自愈(连败软闸/恢复旅程场景)', async () => {
157
+ var env = createMockCtx()
158
+ try {
159
+ var h = installFaults(env, { programs: [{ type: 'instant-kill', times: 2 }] })
160
+ var sub = env.ctx.subagents
161
+ var run1 = await sub.start('p', { label: 'worker:t1' })
162
+ await assert.rejects(function () { return run1.result }, function (e) { return String(e).indexOf('子会话被宿主拆除') === 0 }, '第 1 次秒拆')
163
+ var run2 = await sub.start('p', { label: 'worker:t2' })
164
+ await assert.rejects(function () { return run2.result }, function (e) { return String(e).indexOf('子会话被宿主拆除') === 0 }, '第 2 次秒拆')
165
+ var run3 = await sub.start('p', { label: 'worker:t3' })
166
+ assert.equal(run3.__fault, undefined, '第 3 次起自愈(无 __fault)')
167
+ assert.ok(String(run3.id).indexOf('fault-run-') !== 0, '第 3 次起逐字委托原 start(原 run id 形态)')
168
+ assert.ok(typeof run3.resolveWith === 'function', '委托 run 保留原结算驱动器')
169
+ run3.resolveWith('自愈交付')
170
+ var r3 = await run3.result
171
+ assert.equal(r3.output[0].text, '自愈交付', '委托 run 的测试驱动结算照常可用')
172
+ assert.deepEqual(h.spawnLog.map(function (e) { return e.fault }), ['instant-kill', 'instant-kill', null], 'spawn 日志 fault 分档(前 2 后自愈)')
173
+ assert.equal(h.programs[0].used, 2, '次数窗口消耗 2 次')
174
+ assert.equal(h.programs[0].done, true, 'times 用尽即 done(自愈)')
175
+ } finally { await env.cleanup() }
176
+ })
177
+ // ===== 观测面⑤:llm 目录可编程且运行中可变(shrink/add 即刻生效,每次现取不缓存)=====
178
+ test('观测面⑤:llm 目录可编程且运行中可变——shrink/add 即刻生效(每次现取不缓存)', async () => {
179
+ var env = createMockCtx()
180
+ try {
181
+ var h = installFaults(env, { directory: ['prov-a/model-a', 'prov-a/model-b', 'prov-b/model-x'] })
182
+ var llm = env.ctx.get('llm')
183
+ assert.deepEqual(llm.listProviders().map(function (p) { return p.id }), ['prov-a', 'prov-b'], '目录 → provider 清单(首段 slash 拆分)')
184
+ assert.deepEqual((await llm.listModels('prov-a')).map(function (m) { return m.id }), ['model-a', 'model-b'], 'provider → model 清单')
185
+ assert.deepEqual((await llm.listModels('prov-b')).map(function (m) { return m.id }), ['model-x'])
186
+ // 运行中 shrink:listModels 每次现取不缓存(目录失效场景靠中途 shrink 实现)
187
+ h.directory.remove('prov-a/model-b')
188
+ assert.deepEqual((await llm.listModels('prov-a')).map(function (m) { return m.id }), ['model-a'], 'shrink 后 listModels 反映')
189
+ assert.equal(h.directory.has('prov-a/model-b'), false, 'has 反映 shrink')
190
+ h.directory.add('prov-a/model-c')
191
+ assert.deepEqual((await llm.listModels('prov-a')).map(function (m) { return m.id }), ['model-a', 'model-c'], 'add 即刻生效')
192
+ h.directory.set(['prov-z/only'])
193
+ assert.deepEqual(llm.listProviders().map(function (p) { return p.id }), ['prov-z'], 'set 整体替换')
194
+ // 目录失效闸 e2e 在下方独立用例;这里锁 API 面本身
195
+ assert.ok(typeof h.directory.remove === 'function' && typeof h.directory.add === 'function', '目录操作面在位')
196
+ } finally { await env.cleanup() }
197
+ })
198
+
199
+ // ===== 观测面⑤b:llm.stream 桩(probeModel 消费口径:finish/stop 健康、finish/error+failure.message 失败)=====
200
+ test('观测面⑤b:llm.stream 桩——健康 finish/stop、per-model error+failure.message、文本可被 parseModelCooldown 命中', async () => {
201
+ var env = createMockCtx()
202
+ try {
203
+ installFaults(env, {
204
+ directory: { 'prov-a/model-a': true, 'prov-a/bad-m': true },
205
+ stream: { 'prov-a/bad-m': { kind: 'error', message: '429 RATE_LIMIT: 限额将在 2026-10-27 19:00:00 重置' } },
206
+ })
207
+ var llm = env.ctx.get('llm')
208
+ // 健康:finish/stop(probeModel 消费口径——证明模型链路可用)
209
+ var ok = []
210
+ for await (var c of llm.stream({ provider: 'prov-a', model: 'model-a', messages: [], maxTokens: 1 })) ok.push(c)
211
+ assert.equal(ok.length, 1, '健康流单 finish 帧')
212
+ assert.equal(ok[0].type, 'finish')
213
+ assert.equal(ok[0].reason.kind, 'stop', '健康 = finish/stop')
214
+ // 失败:finish/error + failure.message(probeModel 读 failure.message 为失败文本)
215
+ var bad = []
216
+ for await (var c2 of llm.stream({ provider: 'prov-a', model: 'bad-m', messages: [], maxTokens: 1 })) bad.push(c2)
217
+ assert.equal(bad[0].type, 'finish')
218
+ assert.equal(bad[0].reason.kind, 'error', '失败 = finish/error')
219
+ assert.ok(String(bad[0].reason.failure.message).indexOf('429 RATE_LIMIT') === 0, 'failure.message 携带故障文本')
220
+ // probeModel 消费口径复演:failure.message 文本可被 parseModelCooldown 命中(冷却登记链路可用)
221
+ var hit = parseModelCooldown(bad[0].reason.failure.message)
222
+ assert.ok(hit && hit.kind === 'rate-limit' && hit.parsed === true, 'stream 失败文本可进冷却登记链路')
223
+ assert.equal(env.llm.streams.length, 2, 'stream 调用留痕(prov/model 复合串)')
224
+ assert.equal(env.llm.streams[1].model, 'prov-a/bad-m', 'stream 留痕按复合串拼回')
225
+ } finally { await env.cleanup() }
226
+ })
227
+ // ===== e2e⑥:秒拆三连熔断旅程(activation 契约一次性面)——kill 前缀全链命中 + badModels 拉黑 + 取模链跳模型 =====
228
+ // 一次性面(workerContinuable:false):失败重试恒为 fresh spawn(one-shot 无续跑资格,不经
229
+ // tryResumeWorker);kill 以 run.result 裸字符串拒 → settleRun String(err) 直接前缀命中 isModelKillFailure。
230
+ test('e2e⑥:秒拆三连熔断旅程——kill 前缀全链命中 + badModels 拉黑 + 任务 blocked + 取模链跳模型', async () => {
231
+ var env = createMockCtx()
232
+ var restoreHome = pinHomedir(env)
233
+ try {
234
+ var h = installFaults(env, { activation: true, programs: [{ type: 'instant-kill', times: 3 }] })
235
+ plugin.apply(env.ctx)
236
+ await createTask(env, 'task-kill')
237
+ env.patchBoard(function (d) { d.workerModel = 'prov/glm-kill'; d.workerContinuable = false }) // 一次性面:重试恒 fresh spawn
238
+ for (var round = 1; round <= 3; round++) {
239
+ await env.clock.advance(50)
240
+ await env.waitFor(function () { return h.spawnLog.length >= round }, '第 ' + round + ' 轮 spawn')
241
+ var e = h.spawnLog[round - 1]
242
+ assert.equal(e.method, 'startActivation', 'activation 契约(opt-in 后 spawn 翻到新路径)')
243
+ assert.equal(e.delivery, 'caller', '一次性面走 delivery=caller(run.result 结算)')
244
+ assert.equal(e.model, 'prov/glm-kill', '取模链命中板级模型(agentOptions 复合串重构)')
245
+ assert.equal(e.fault, 'instant-kill', '故障程序命中留痕')
246
+ if (round < 3) await env.waitFor(function () { var x = env.task('task-kill'); return x && x.retryCount === round ? x : null }, '第 ' + round + ' 轮失败结算(retryCount)')
247
+ }
248
+ // 3 连 → 任务 blocked(worker 失败 x3)+ badModels 拉黑(isModelKillFailure 前缀全链命中)
249
+ var t = await env.waitFor(function () { var x = env.task('task-kill'); return x && x.status === 'blocked' ? x : null }, '三连失败 blocked')
250
+ assert.equal(t.retryCount, 3, 'retryCount 计满 3')
251
+ assert.ok(String(t.lastError).indexOf('子会话被宿主拆除(stopReason: error') === 0, 'lastError 前缀(run.result 裸字符串拒 → String(err) 口径,isModelKillFailure 命中)')
252
+ // 熔断拉黑(badModels 只认模型面失败):下一张同模型任务的 spawn 跳过该模型(父模型兜底 → model='')
253
+ await createTask(env, 'task-after')
254
+ await env.clock.advance(50)
255
+ await env.waitFor(function () { return h.spawnLog.length >= 4 }, '熔断后 spawn')
256
+ assert.equal(h.spawnLog[3].model, '', '熔断模型被取模链跳过(父模型兜底,agentOptions 不挂)——kill 前缀喂进熔断的全链证明')
257
+ assert.equal(h.spawnLog[3].fault, null, 'times: 3 已自愈(第 4 次 spawn 无故障)')
258
+ // 健康面 circuit 状态(get-tasks modelHealthView 公开口径)
259
+ var gt = await env.rpc('get-tasks', { sessionId: env.sid })
260
+ var mh = gt.modelHealth || (gt.data && gt.data.modelHealth) || {}
261
+ assert.equal(mh['prov/glm-kill'] && mh['prov/glm-kill'].state, 'circuit', '健康面 circuit 状态(badModels 拉黑公开可见)')
262
+ } finally { restoreHome(); await env.cleanup() }
263
+ })
264
+
265
+ // ===== e2e⑦:限流旅程——429 文本全链被 parseModelCooldown 命中(冷却登记 + 卡 messages 留痕 + 取模链跳过)=====
266
+ test('e2e⑦:限流旅程——429 文本全链命中(冷却登记 + 卡 messages 额度冷却留痕 + 取模链跳模型 + 健康面 cooldown)', async () => {
267
+ var env = createMockCtx()
268
+ var restoreHome = pinHomedir(env)
269
+ try {
270
+ var h = installFaults(env, { activation: true, programs: [{ type: 'rate-limit', resetInMs: 5 * 60000 }] })
271
+ plugin.apply(env.ctx)
272
+ await createTask(env, 'task-rl')
273
+ env.patchBoard(function (d) { d.workerModel = 'prov/glm-rl' })
274
+ await env.clock.advance(50)
275
+ await env.waitFor(function () { return h.spawnLog.length >= 1 }, '第 1 轮 spawn')
276
+ assert.equal(h.spawnLog[0].model, 'prov/glm-rl', '取模链命中板级模型')
277
+ assert.equal(h.spawnLog[0].fault, 'rate-limit', '限流程序命中留痕')
278
+ // 失败结算 → 冷却登记(settleWorker 失败臂 sniffModelCooldown②,先写卡)→ 失败臂重排(retryCount+1)。
279
+ // 两笔是分开的持锁写——waitFor 必须同时等到 retryCount 与冷却留痕(不能捕获中间态快照)。
280
+ var t = await env.waitFor(function () { var x = env.task('task-rl'); return x && x.retryCount === 1 && x.messages && x.messages.some(function (m) { return m.kind === 'cooldown' }) ? x : null }, '冷却登记 + 失败结算落卡')
281
+ var cm = t.messages.filter(function (m) { return m.kind === 'cooldown' })[0]
282
+ assert.ok(cm.text.indexOf('额度冷却至') >= 0, '限流分态留痕(「额度冷却至 HH:mm」)')
283
+ assert.equal(t.retryCount, 1, '失败结算 retryCount+1')
284
+ // 取模链冷却跳过:重派 spawn 走父模型兜底(cooldown → 降档链空 → parent)
285
+ await env.clock.advance(50)
286
+ await env.waitFor(function () { return h.spawnLog.length >= 2 }, '冷却后重派 spawn')
287
+ assert.equal(h.spawnLog[1].model, '', '冷却模型被取模链跳过(父模型兜底)——429 文本进冷却表的全链证明')
288
+ assert.equal(h.spawnLog[1].fault, null, 'times 缺省=1 已自愈')
289
+ // 健康面 cooldown 状态 + until 精确 ts(重置时刻可编程)
290
+ var gt = await env.rpc('get-tasks', { sessionId: env.sid })
291
+ var mh = gt.modelHealth || (gt.data && gt.data.modelHealth) || {}
292
+ var entry = mh['prov/glm-rl']
293
+ assert.ok(entry && entry.state === 'cooldown', '健康面 cooldown 状态')
294
+ assert.ok(entry.until > Date.now() && entry.until <= Date.now() + 6 * 60000, 'until ≈ now+5min(重置时刻可编程)')
295
+ } finally { restoreHome(); await env.cleanup() }
296
+ })
297
+ // ===== e2e⑧:挂死旅程(缺省 continuable 路径)——childId 返回零事件 + 真日志文件 + rec 挂 running =====
298
+ test('e2e⑧:挂死旅程(缺省 continuable 路径)——childId 返回零事件 + 真日志文件(writeChildLog 布局)+ 持续 running 假相', async () => {
299
+ var env = createMockCtx()
300
+ var restoreHome = pinHomedir(env)
301
+ try {
302
+ var h = installFaults(env, { programs: [{ type: 'hang' }] })
303
+ plugin.apply(env.ctx)
304
+ await createTask(env, 'task-hang')
305
+ env.patchBoard(function (d) { d.workerModel = 'prov/glm-hang' })
306
+ await env.clock.advance(50)
307
+ await env.waitFor(function () { return env.continuables.length >= 1 }, '挂死 spawn 发生')
308
+ var c = env.continuables[0]
309
+ assert.equal(c.label, 'worker:task-hang')
310
+ assert.equal(c.__fault, 'hang', '挂死程序命中(__fault 留档)')
311
+ await env.waitFor(function () { var x = env.task('task-hang'); return x && x.status === 'in-progress' ? x : null }, '落卡 in-progress')
312
+ // 真日志文件(挂死零产出检测 hungZeroOutputSweep 的 logSizeOf 基线)
313
+ var lp = childLogPath(env, c.childId)
314
+ assert.ok(fs.existsSync(lp) && fs.statSync(lp).size > 0, '挂死真日志文件(<home>/.dsh/sessions/<桶>/<childId>/session.v4.jsonl.zstd)')
315
+ // 零事件:推进多轮虚拟时间也不结算(无 running→idle 重放、result 永不落定)
316
+ await env.clock.advance(200)
317
+ var t2 = env.task('task-hang')
318
+ assert.equal(t2.status, 'in-progress', '零事件——挂死 run 持续 running 假相(不报错不结算)')
319
+ assert.equal(h.spawnLog[0].fault, 'hang')
320
+ assert.equal(h.spawnLog[0].model, 'prov/glm-hang')
321
+ } finally { restoreHome(); await env.cleanup() }
322
+ })
323
+
324
+ // ===== e2e⑨:空响应旅程(缺省 continuable 路径)——空 assistant 日志 + idle 重放 → 空文本失败结算重排 =====
325
+ test('e2e⑨:空响应旅程(缺省 continuable 路径)——空 assistant 日志 + idle 重放 → 空文本按失败结算重排', async () => {
326
+ var env = createMockCtx()
327
+ var restoreHome = pinHomedir(env)
328
+ try {
329
+ var h = installFaults(env, { programs: [{ type: 'empty' }] })
330
+ plugin.apply(env.ctx)
331
+ await createTask(env, 'task-empty')
332
+ await env.clock.advance(50)
333
+ await env.waitFor(function () { return env.continuables.length >= 1 }, 'spawn 发生')
334
+ var c = env.continuables[0]
335
+ assert.equal(c.__fault, 'empty')
336
+ // 空响应:settleContinuable 读到空文本按失败结算(pending 重排,绝不当成空完成推进 verifying)
337
+ var t = await env.waitFor(function () { var x = env.task('task-empty'); return x && x.retryCount === 1 ? x : null }, '空文本失败结算(retryCount 1)')
338
+ assert.ok(t.lastError, '失败原因落卡留痕')
339
+ assert.equal(t.status, 'pending', '失败 → 重新排队')
340
+ assert.ok(h.spawnLog[0].fault === 'empty' && h.spawnLog[0].method === 'startContinuable')
341
+ } finally { restoreHome(); await env.cleanup() }
342
+ })
343
+ // ===== 五档⑩:activation 契约各档行为 + delivery 记录 + teardown 形态 =====
344
+ test('五档⑩:activation 契约(opt-in)——startActivation 各档行为 + delivery 记录 + teardown 拆除落定形态', async () => {
345
+ var env = createMockCtx()
346
+ try {
347
+ var FIXED = new Date(2026, 9, 27, 20, 0, 0).getTime()
348
+ var h = installFaults(env, {
349
+ activation: true,
350
+ healthyText: 'activation 健康交付',
351
+ programs: [
352
+ { type: 'instant-kill', diagnostic: 'act-kill' },
353
+ { type: 'rate-limit', resetAt: FIXED, form: 'teardown' },
354
+ { type: 'empty' },
355
+ { type: 'slow', delayMs: 80, text: 'act slow 交付' },
356
+ { type: 'hang' },
357
+ ],
358
+ })
359
+ var sub = env.ctx.subagents
360
+ // ① instant-kill:result 裸字符串拒(前缀口径同 one-shot;activation 拒绝臂包「子会话 activation 异常:」仍命中)
361
+ var act1 = await sub.startActivation({ provider: 'p', label: 'worker:t1', request: { prompt: 'x' }, delivery: 'parent' })
362
+ assert.equal(act1.__fault, 'instant-kill')
363
+ var t1 = await rejectionOf(act1.result)
364
+ assert.ok(t1 !== null && t1.indexOf('子会话被宿主拆除(stopReason: error') === 0, '秒拆前缀')
365
+ // ④ rate-limit teardown 形态:result 以 { stopReason:'error', diagnostic } 落定(dispatch 拆除臂构造前缀)
366
+ var act2 = await sub.startActivation({ provider: 'p', label: 'worker:t2', request: { prompt: 'x' }, delivery: 'parent' })
367
+ var r2 = await act2.result
368
+ assert.equal(r2.stopReason, 'error', 'teardown 落定 stopReason=error')
369
+ assert.ok(String(r2.diagnostic).indexOf('429 RATE_LIMIT') === 0, 'diagnostic 携带限流文本')
370
+ var tornText = '子会话被宿主拆除(stopReason: error,' + r2.diagnostic + ')'
371
+ var hit2 = parseModelCooldown(tornText)
372
+ assert.ok(hit2 && hit2.kind === 'rate-limit' && hit2.parsed === true && hit2.until === FIXED, 'teardown 文本经拆除臂构造后仍被 parseModelCooldown 命中(精确 ts)')
373
+ // ③ empty:写空 assistant 日志 + idle 重放(result 不落定——parked 正常完成语义)
374
+ var act3 = await sub.startActivation({ provider: 'p', label: 'worker:t3', request: { prompt: 'x' }, delivery: 'parent' })
375
+ assert.ok(fs.existsSync(childLogPath(env, act3.childId)), '空响应日志已写')
376
+ var s3 = false
377
+ act3.result.then(function () { s3 = true })
378
+ await new Promise(function (r) { setTimeout(r, 30) })
379
+ assert.equal(s3, false, '空响应 parked——result 不落定')
380
+ // ⑤ slow:延时后写健康日志 + idle 重放
381
+ var act4 = await sub.startActivation({ provider: 'p', label: 'worker:t4', request: { prompt: 'x' }, delivery: 'parent' })
382
+ await new Promise(function (r) { setTimeout(r, 30) })
383
+ assert.ok(!fs.existsSync(childLogPath(env, act4.childId)), '延时未到日志未写')
384
+ await env.clock.advance(150)
385
+ await new Promise(function (r) { setTimeout(r, 30) })
386
+ assert.ok(fs.existsSync(childLogPath(env, act4.childId)), 'slow 健康日志延时后写入')
387
+ // ② hang:日志 + 永不落定
388
+ var act5 = await sub.startActivation({ provider: 'p', label: 'worker:t5', request: { prompt: 'x' }, delivery: 'parent' })
389
+ assert.ok(fs.existsSync(childLogPath(env, act5.childId)), '挂死日志已写')
390
+ var s5 = false
391
+ act5.result.then(function () { s5 = true })
392
+ await new Promise(function (r) { setTimeout(r, 30) })
393
+ assert.equal(s5, false, '挂死永不落定')
394
+ // delivery='caller':一次性面——健康合成 result 正常落定(无故障时)
395
+ var act6 = await sub.startActivation({ provider: 'p', label: 'verifier:t6', request: { prompt: 'x' }, delivery: 'caller' })
396
+ var r6 = await act6.result
397
+ assert.equal(r6.output[0].text, 'activation 健康交付', 'caller 面健康合成 result 正常落定')
398
+ // spawn 日志:delivery/method/fault 逐条
399
+ assert.deepEqual(h.spawnLog.map(function (e) { return e.delivery }), ['parent', 'parent', 'parent', 'parent', 'parent', 'caller'], 'delivery 逐条留痕')
400
+ assert.deepEqual(h.spawnLog.map(function (e) { return e.fault }), ['instant-kill', 'rate-limit', 'empty', 'slow', 'hang', null], 'fault 分档逐条留痕')
401
+ } finally { await env.cleanup() }
402
+ })
403
+
404
+ // ===== 五档⑪:老 startContinuable(无 result 承诺)——instant-kill/rate-limit 只能 spawn 层拒 =====
405
+ test('五档⑪:老 startContinuable——instant-kill/rate-limit spawn 层拒(throw,不产子会话)', async () => {
406
+ var env = createMockCtx()
407
+ try {
408
+ var h = installFaults(env, { programs: [{ type: 'instant-kill' }, { type: 'rate-limit' }] })
409
+ var sub = env.ctx.subagents
410
+ await assert.rejects(function () { return sub.startContinuable({ provider: 'p', label: 'worker:t1', request: {} }) }, function (e) { return e.message.indexOf('子会话被宿主拆除(stopReason: error') === 0 }, '秒拆 spawn 层拒(e.message 前缀)')
411
+ await assert.rejects(function () { return sub.startContinuable({ provider: 'p', label: 'worker:t2', request: {} }) }, function (e) { return e.message.indexOf('429') === 0 }, '限流 spawn 层拒')
412
+ assert.deepEqual(h.spawnLog.map(function (e) { return e.fault }), ['instant-kill', 'rate-limit'], 'spawn 日志留痕')
413
+ assert.equal(env.continuables.length, 0, 'spawn 层拒不产子会话(dispatch catch 冷却嗅探①通道消费)')
414
+ } finally { await env.cleanup() }
415
+ })
416
+
417
+ // ===== 剧本⑫:match 过滤(role/method)+ 多程序按序共存 =====
418
+ test('剧本⑫:match 过滤(role/method)+ 多程序按序共存(first-match-wins + times 自愈)', async () => {
419
+ var env = createMockCtx()
420
+ try {
421
+ var h = installFaults(env, { programs: [
422
+ { type: 'instant-kill', times: 1, match: { role: 'verifier' } },
423
+ { type: 'slow', delayMs: 50, match: { method: 'start' } },
424
+ ] })
425
+ var sub = env.ctx.subagents
426
+ var w1 = await sub.start('p', { label: 'worker:t1' }) // slow 命中(method=start)
427
+ await env.clock.advance(100)
428
+ var r1 = await w1.result
429
+ assert.equal(r1.stopReason, 'completed', 'slow 命中后正常落定')
430
+ var v1 = await sub.start('p', { label: 'verifier:t1' }) // instant-kill 命中(role=verifier)
431
+ await assert.rejects(function () { return v1.result }, function (e) { return String(e).indexOf('子会话被宿主拆除') === 0 }, 'verifier 角色过滤命中秒拆')
432
+ var w2 = await sub.start('p', { label: 'worker:t2' }) // slow 已自愈 → 委托原 start
433
+ assert.equal(w2.__fault, undefined, 'times 用尽后自愈(逐字委托)')
434
+ assert.deepEqual(h.spawnLog.map(function (e) { return e.fault }), ['slow', 'instant-kill', null], '多程序按序消费留痕')
435
+ } finally { await env.cleanup() }
436
+ })
437
+
438
+ // ===== 观测面⑬:目录失效闸 e2e——中途 shrink 后下一 spawn 跳过目录外模型(outOfDir 闸)=====
439
+ test('观测面⑬:目录失效闸 e2e——中途 shrink 后下一 spawn 跳过目录外模型(stale-model 留痕落卡)', async () => {
440
+ var env = createMockCtx()
441
+ try {
442
+ var h = installFaults(env, { directory: { 'prov/m1': true, 'prov/m2': true }, programs: [] })
443
+ plugin.apply(env.ctx)
444
+ await createTask(env, 'task-da')
445
+ env.patchBoard(function (d) { d.tasks[0].model = 'prov/m1' })
446
+ await env.clock.advance(50)
447
+ await env.waitFor(function () { return h.spawnLog.length >= 1 }, 'spawn a')
448
+ assert.equal(h.spawnLog[0].model, 'prov/m1', '目录内模型正常命中')
449
+ h.directory.remove('prov/m1') // 中途 shrink(目录失效:目录仍有 prov/m2 非空 → outOfDir 闸生效)
450
+ await createTask(env, 'task-db')
451
+ env.patchBoard(function (d) { d.tasks[1].model = 'prov/m1' })
452
+ await env.clock.advance(50)
453
+ await env.waitFor(function () { return h.spawnLog.length >= 2 }, 'spawn b')
454
+ assert.equal(h.spawnLog[1].model, '', '目录外模型被 outOfDir 闸跳过(父模型兜底)')
455
+ var tb = await env.waitFor(function () { var x = env.task('task-db'); return x && x.messages && x.messages.some(function (m) { return m.kind === 'stale-model' }) ? x : null }, 'stale-model 留痕落卡')
456
+ assert.ok(tb.messages.some(function (m) { return m.kind === 'stale-model' && m.text.indexOf('prov/m1') >= 0 }), 'stale-model 留痕带模型 id')
457
+ } finally { await env.cleanup() }
458
+ })