@zhushanwen/pi-subagent-workflow 8.6.0 → 8.8.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.
Files changed (364) hide show
  1. package/README.md +5 -11
  2. package/package.json +13 -20
  3. package/relay/relay.mjs +1 -1
  4. package/skills/workflow-script-format/SKILL.md +32 -13
  5. package/src/host/__tests__/pi-host.test.ts +235 -0
  6. package/src/host/pi-host.ts +163 -0
  7. package/src/index.ts +141 -138
  8. package/src/injectors/__tests__/engine-awareness.test.ts +292 -0
  9. package/src/injectors/__tests__/engine-section-stability.test.ts +343 -0
  10. package/src/injectors/__tests__/model-list-injector.test.ts +18 -21
  11. package/src/injectors/__tests__/subagent-list-injector.test.ts +59 -19
  12. package/src/injectors/__tests__/workflow-list-injector.test.ts +31 -17
  13. package/src/injectors/engine-awareness.ts +119 -0
  14. package/src/injectors/model-list-injector.ts +15 -58
  15. package/src/injectors/subagent-list-injector.ts +56 -114
  16. package/src/injectors/workflow-list-injector.ts +37 -70
  17. package/src/interface/__tests__/detectors.test.ts +48 -37
  18. package/src/interface/__tests__/subagent-tool-path-guard.test.ts +2 -2
  19. package/src/interface/__tests__/subagent-tool-prompt.test.ts +6 -3
  20. package/src/interface/__tests__/tool-workflow-run-builtin-name.test.ts +216 -0
  21. package/src/interface/__tests__/tool-workflow-script-generate.test.ts +17 -6
  22. package/src/interface/__tests__/tool-workflow-throw-paths.test.ts +38 -2
  23. package/src/interface/bg-notify-render.ts +7 -17
  24. package/src/interface/command-actions.ts +5 -15
  25. package/src/interface/commands.ts +4 -4
  26. package/src/interface/format.ts +17 -6
  27. package/src/interface/gui-mappers.ts +18 -22
  28. package/src/interface/helpers.ts +9 -130
  29. package/src/interface/list-component.ts +5 -5
  30. package/src/interface/list-shared.ts +3 -3
  31. package/src/interface/list-view.ts +3 -3
  32. package/src/interface/subagent-actions.ts +66 -439
  33. package/src/interface/subagent-tool-schema.ts +21 -17
  34. package/src/interface/subagent-tool.ts +12 -7
  35. package/src/interface/subagents.ts +4 -4
  36. package/src/interface/tool-render.ts +37 -15
  37. package/src/interface/tool-workflow-script.ts +34 -76
  38. package/src/interface/tool-workflow.ts +57 -94
  39. package/src/interface/views/WorkflowsView.ts +8 -16
  40. package/src/interface/views/__tests__/WorkflowsView-signature.test.ts +3 -3
  41. package/src/interface/views/__tests__/detail-content-session-file.test.ts +2 -2
  42. package/src/interface/views/detail-content.ts +4 -4
  43. package/src/interface/views/format.ts +23 -62
  44. package/src/{orchestration/jsonl-run-store.ts → jsonl-run-store.ts} +137 -225
  45. package/agents/analyst.md +0 -61
  46. package/agents/coder.md +0 -70
  47. package/agents/debugger.md +0 -67
  48. package/agents/doc-reviewer.md +0 -50
  49. package/agents/explorer.md +0 -64
  50. package/agents/general-purpose.md +0 -32
  51. package/agents/orchestrator.md +0 -63
  52. package/agents/planner.md +0 -54
  53. package/agents/researcher.md +0 -65
  54. package/agents/reviewer.md +0 -74
  55. package/src/execution/__tests__/__fixtures__/notifier-golden-snapshots.json +0 -53
  56. package/src/execution/__tests__/__fixtures__/truncline.snapshot.json +0 -1
  57. package/src/execution/__tests__/agent-registry.test.ts +0 -363
  58. package/src/execution/__tests__/agent-result-mapper.test.ts +0 -150
  59. package/src/execution/__tests__/alive-store.test.ts +0 -147
  60. package/src/execution/__tests__/ask-user-transit-e2e.test.ts +0 -490
  61. package/src/execution/__tests__/before-agent-start-injection.test.ts +0 -132
  62. package/src/execution/__tests__/bg-notify-render.test.ts +0 -329
  63. package/src/execution/__tests__/channel-registry-handshake.test.ts +0 -243
  64. package/src/execution/__tests__/chat-engine-routing.test.ts +0 -601
  65. package/src/execution/__tests__/chatmode-first-round-closure-service.test.ts +0 -365
  66. package/src/execution/__tests__/chatmode-first-round-closure-spawn.test.ts +0 -190
  67. package/src/execution/__tests__/chatmode-round-notify-real-chain.test.ts +0 -215
  68. package/src/execution/__tests__/concurrency-pool.test.ts +0 -250
  69. package/src/execution/__tests__/config.test.ts +0 -110
  70. package/src/execution/__tests__/conversation-wiring.test.ts +0 -198
  71. package/src/execution/__tests__/crash-recovery.test.ts +0 -320
  72. package/src/execution/__tests__/delivery-methods.test.ts +0 -422
  73. package/src/execution/__tests__/dialog-queue.test.ts +0 -299
  74. package/src/execution/__tests__/epipe-fallback.test.ts +0 -241
  75. package/src/execution/__tests__/execute-and-await-worktree.test.ts +0 -243
  76. package/src/execution/__tests__/execute-nesting.test.ts +0 -323
  77. package/src/execution/__tests__/execute-options-mapper.test.ts +0 -200
  78. package/src/execution/__tests__/execution-record.test.ts +0 -1394
  79. package/src/execution/__tests__/explicit-agent-ref-guard.test.ts +0 -171
  80. package/src/execution/__tests__/finalize-record.test.ts +0 -368
  81. package/src/execution/__tests__/finalized-marker.test.ts +0 -82
  82. package/src/execution/__tests__/format-schema-instruction.test.ts +0 -169
  83. package/src/execution/__tests__/format.test.ts +0 -458
  84. package/src/execution/__tests__/gc-timer.test.ts +0 -184
  85. package/src/execution/__tests__/get-record-for-action-restart.test.ts +0 -254
  86. package/src/execution/__tests__/gui-mode-dispatch.test.ts +0 -59
  87. package/src/execution/__tests__/helpers/mock-extension-api.ts +0 -30
  88. package/src/execution/__tests__/helpers/spawn-mock.ts +0 -242
  89. package/src/execution/__tests__/host-mode.test.ts +0 -87
  90. package/src/execution/__tests__/index-session-start-identity.test.ts +0 -371
  91. package/src/execution/__tests__/index-session-start.test.ts +0 -672
  92. package/src/execution/__tests__/lifecycle-manager-lock.test.ts +0 -211
  93. package/src/execution/__tests__/lifecycle-manager.test.ts +0 -383
  94. package/src/execution/__tests__/lifecycle-predicates.test.ts +0 -116
  95. package/src/execution/__tests__/list-component.test.ts +0 -401
  96. package/src/execution/__tests__/list-fields.test.ts +0 -140
  97. package/src/execution/__tests__/manifest-parentid.test.ts +0 -117
  98. package/src/execution/__tests__/model-resolver.test.ts +0 -465
  99. package/src/execution/__tests__/nested-visibility-env-propagation.test.ts +0 -287
  100. package/src/execution/__tests__/nested-visibility.test.ts +0 -325
  101. package/src/execution/__tests__/notifier-flush.test.ts +0 -612
  102. package/src/execution/__tests__/notifier-golden-snapshot.test.ts +0 -261
  103. package/src/execution/__tests__/notify-ledger.test.ts +0 -826
  104. package/src/execution/__tests__/one-shot-upgrade.test.ts +0 -205
  105. package/src/execution/__tests__/output-collector.test.ts +0 -358
  106. package/src/execution/__tests__/parent-child-matrix.test.ts +0 -336
  107. package/src/execution/__tests__/path-encoding.test.ts +0 -104
  108. package/src/execution/__tests__/pi-invocation.test.ts +0 -134
  109. package/src/execution/__tests__/record-store.test.ts +0 -1057
  110. package/src/execution/__tests__/records-cwd-isolation.test.ts +0 -91
  111. package/src/execution/__tests__/recursive-visibility-baseline.test.ts +0 -339
  112. package/src/execution/__tests__/recursive-visibility-env.test.ts +0 -273
  113. package/src/execution/__tests__/relay-agent.test.ts +0 -448
  114. package/src/execution/__tests__/relay-env.test.ts +0 -42
  115. package/src/execution/__tests__/resource-policy.test.ts +0 -109
  116. package/src/execution/__tests__/rpc-mode.test.ts +0 -89
  117. package/src/execution/__tests__/run-and-finalize-chatmode.test.ts +0 -267
  118. package/src/execution/__tests__/run-spawn-chatmode-settled.test.ts +0 -253
  119. package/src/execution/__tests__/run-spawn-edges.test.ts +0 -687
  120. package/src/execution/__tests__/run-spawn-integration.test.ts +0 -933
  121. package/src/execution/__tests__/run-spawn-resume.test.ts +0 -322
  122. package/src/execution/__tests__/run-spawn-rpc-mode.test.ts +0 -196
  123. package/src/execution/__tests__/run-spawn-stdout-callback-throw.test.ts +0 -199
  124. package/src/execution/__tests__/sdk-contract.test.ts +0 -273
  125. package/src/execution/__tests__/session-context-resolver.test.ts +0 -167
  126. package/src/execution/__tests__/session-file-gc.test.ts +0 -293
  127. package/src/execution/__tests__/session-pending.test.ts +0 -197
  128. package/src/execution/__tests__/session-reconstructor.test.ts +0 -379
  129. package/src/execution/__tests__/session-runner-epipe.test.ts +0 -178
  130. package/src/execution/__tests__/session-runner-schema-env.test.ts +0 -350
  131. package/src/execution/__tests__/session-start-reaper.test.ts +0 -233
  132. package/src/execution/__tests__/spawn-args.test.ts +0 -445
  133. package/src/execution/__tests__/spawn-event-adapter-rpc.test.ts +0 -189
  134. package/src/execution/__tests__/spawn-event-adapter.test.ts +0 -167
  135. package/src/execution/__tests__/spawn-worktree-guidance.test.ts +0 -207
  136. package/src/execution/__tests__/spawned-children.test.ts +0 -92
  137. package/src/execution/__tests__/start-sync-model-guard.test.ts +0 -150
  138. package/src/execution/__tests__/startup-config-declaration.test.ts +0 -35
  139. package/src/execution/__tests__/status-refactor.test.ts +0 -345
  140. package/src/execution/__tests__/stdin-writer.test.ts +0 -463
  141. package/src/execution/__tests__/stream-sink-retirement.test.ts +0 -261
  142. package/src/execution/__tests__/subagent-service-abort.test.ts +0 -60
  143. package/src/execution/__tests__/subagent-service-message-close.test.ts +0 -629
  144. package/src/execution/__tests__/subagent-service-parent-guard.test.ts +0 -180
  145. package/src/execution/__tests__/subagent-service.test.ts +0 -788
  146. package/src/execution/__tests__/subprocess-agent-runner-routing.test.ts +0 -310
  147. package/src/execution/__tests__/subprocess-agent-runner.test.ts +0 -599
  148. package/src/execution/__tests__/temp-prompt.test.ts +0 -53
  149. package/src/execution/__tests__/timeout-integration.test.ts +0 -615
  150. package/src/execution/__tests__/tombstone-store.test.ts +0 -73
  151. package/src/execution/__tests__/tool-action.test.ts +0 -476
  152. package/src/execution/__tests__/truncline-snapshot.test.ts +0 -81
  153. package/src/execution/__tests__/turn-limiter-semantics.test.ts +0 -194
  154. package/src/execution/__tests__/turn-limiter.test.ts +0 -65
  155. package/src/execution/__tests__/ui-channels.test.ts +0 -187
  156. package/src/execution/__tests__/ui-interaction-model.test.ts +0 -67
  157. package/src/execution/__tests__/ui-request-handler-factory.test.ts +0 -370
  158. package/src/execution/__tests__/ui-request-handler.test.ts +0 -204
  159. package/src/execution/__tests__/ui-request-observability.test.ts +0 -114
  160. package/src/execution/__tests__/ui-request-queue.test.ts +0 -133
  161. package/src/execution/__tests__/worktree-manager.test.ts +0 -633
  162. package/src/execution/__tests__/worktree-pid-registration.integration.test.ts +0 -229
  163. package/src/execution/__tests__/worktree-reconcile.integration.test.ts +0 -181
  164. package/src/execution/__tests__/worktree-registry.test.ts +0 -199
  165. package/src/execution/agent-registry.ts +0 -199
  166. package/src/execution/agent-result-mapper.ts +0 -90
  167. package/src/execution/alive-store.ts +0 -92
  168. package/src/execution/argv-mirror.ts +0 -113
  169. package/src/execution/best-effort.ts +0 -38
  170. package/src/execution/channel-registry-access.ts +0 -144
  171. package/src/execution/concurrency-pool.ts +0 -116
  172. package/src/execution/config.ts +0 -96
  173. package/src/execution/dialog-queue.ts +0 -330
  174. package/src/execution/engine/__tests__/common/data-dir.test.ts +0 -53
  175. package/src/execution/engine/__tests__/common/errors.test.ts +0 -132
  176. package/src/execution/engine/__tests__/common/event-journal.test.ts +0 -177
  177. package/src/execution/engine/__tests__/common/kill-chain.test.ts +0 -192
  178. package/src/execution/engine/__tests__/common/nesting-guard.test.ts +0 -81
  179. package/src/execution/engine/__tests__/common/persona-router.test.ts +0 -123
  180. package/src/execution/engine/__tests__/common/pool-manager.test.ts +0 -154
  181. package/src/execution/engine/__tests__/common/schema-emulation.test.ts +0 -128
  182. package/src/execution/engine/__tests__/conformance/__fixtures__/pi-golden-events.json +0 -28
  183. package/src/execution/engine/__tests__/conformance/agent-event-invariants.ts +0 -141
  184. package/src/execution/engine/__tests__/conformance/contract.abort.test.ts +0 -109
  185. package/src/execution/engine/__tests__/conformance/contract.agent-events.test.ts +0 -101
  186. package/src/execution/engine/__tests__/conformance/contract.probe.test.ts +0 -77
  187. package/src/execution/engine/__tests__/conformance/contract.read-degradation.test.ts +0 -104
  188. package/src/execution/engine/__tests__/conformance/contract.relay.test.ts +0 -342
  189. package/src/execution/engine/__tests__/conformance/engine-conformance.live.test.ts +0 -201
  190. package/src/execution/engine/__tests__/conformance/golden-replay.pi.test.ts +0 -76
  191. package/src/execution/engine/__tests__/conformance/golden-replay.zcode.test.ts +0 -79
  192. package/src/execution/engine/__tests__/engine-discovery.test.ts +0 -87
  193. package/src/execution/engine/__tests__/engines-declaration.test.ts +0 -36
  194. package/src/execution/engine/__tests__/model-prompt.test.ts +0 -85
  195. package/src/execution/engine/__tests__/paths.test.ts +0 -39
  196. package/src/execution/engine/__tests__/registry.test.ts +0 -120
  197. package/src/execution/engine/__tests__/routing.test.ts +0 -231
  198. package/src/execution/engine/common/data-dir.ts +0 -62
  199. package/src/execution/engine/common/errors.ts +0 -183
  200. package/src/execution/engine/common/event-journal.ts +0 -254
  201. package/src/execution/engine/common/journal-replay.ts +0 -62
  202. package/src/execution/engine/common/kill-chain.ts +0 -221
  203. package/src/execution/engine/common/nesting-guard.ts +0 -50
  204. package/src/execution/engine/common/persona-router.ts +0 -108
  205. package/src/execution/engine/common/pool-manager.ts +0 -226
  206. package/src/execution/engine/common/schema-emulation.ts +0 -189
  207. package/src/execution/engine/common/session-view-projection.ts +0 -51
  208. package/src/execution/engine/engine-discovery.ts +0 -65
  209. package/src/execution/engine/engines/pi/__tests__/pi-engine.test.ts +0 -469
  210. package/src/execution/engine/engines/pi/__tests__/reader.test.ts +0 -155
  211. package/src/execution/engine/engines/pi/__tests__/task-spec-mapper.test.ts +0 -164
  212. package/src/execution/engine/engines/pi/pi-engine.ts +0 -415
  213. package/src/execution/engine/engines/pi/reader.ts +0 -48
  214. package/src/execution/engine/engines/pi/registration.ts +0 -35
  215. package/src/execution/engine/engines/pi/task-spec-mapper.ts +0 -100
  216. package/src/execution/engine/engines/zcode/__tests__/__fixtures__/zcode-golden-spawn.json +0 -39
  217. package/src/execution/engine/engines/zcode/__tests__/launcher.test.ts +0 -150
  218. package/src/execution/engine/engines/zcode/__tests__/parser.test.ts +0 -246
  219. package/src/execution/engine/engines/zcode/__tests__/preparer.test.ts +0 -228
  220. package/src/execution/engine/engines/zcode/__tests__/reader.test.ts +0 -210
  221. package/src/execution/engine/engines/zcode/__tests__/registration.test.ts +0 -64
  222. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.live.test.ts +0 -127
  223. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.test.ts +0 -580
  224. package/src/execution/engine/engines/zcode/constants.ts +0 -43
  225. package/src/execution/engine/engines/zcode/golden-sample.ts +0 -39
  226. package/src/execution/engine/engines/zcode/launcher.ts +0 -161
  227. package/src/execution/engine/engines/zcode/parser.ts +0 -436
  228. package/src/execution/engine/engines/zcode/preparer.ts +0 -363
  229. package/src/execution/engine/engines/zcode/reader.ts +0 -381
  230. package/src/execution/engine/engines/zcode/registration.ts +0 -37
  231. package/src/execution/engine/engines/zcode/zcode-engine.ts +0 -658
  232. package/src/execution/engine/host-task-spec.ts +0 -47
  233. package/src/execution/engine/model-prompt.ts +0 -59
  234. package/src/execution/engine/paths.ts +0 -42
  235. package/src/execution/engine/port.ts +0 -153
  236. package/src/execution/engine/registry.ts +0 -123
  237. package/src/execution/engine/routing.ts +0 -218
  238. package/src/execution/engine/types.ts +0 -309
  239. package/src/execution/execute-options-mapper.ts +0 -112
  240. package/src/execution/execution-record.ts +0 -965
  241. package/src/execution/finalize-record.ts +0 -251
  242. package/src/execution/finalized-marker.ts +0 -51
  243. package/src/execution/get-state-handshake.ts +0 -104
  244. package/src/execution/host-mode.ts +0 -56
  245. package/src/execution/idle-gc.ts +0 -47
  246. package/src/execution/lifecycle-manager.ts +0 -513
  247. package/src/execution/lifecycle-predicates.ts +0 -65
  248. package/src/execution/manifest-store.ts +0 -256
  249. package/src/execution/model-config-service.ts +0 -219
  250. package/src/execution/model-resolver.ts +0 -248
  251. package/src/execution/notifier.ts +0 -330
  252. package/src/execution/notify-ledger.ts +0 -580
  253. package/src/execution/output-collector.ts +0 -228
  254. package/src/execution/path-encoding.ts +0 -60
  255. package/src/execution/pi-invocation.ts +0 -120
  256. package/src/execution/record-entry.ts +0 -132
  257. package/src/execution/record-store.ts +0 -1234
  258. package/src/execution/relay-env.ts +0 -37
  259. package/src/execution/session-context-resolver.ts +0 -64
  260. package/src/execution/session-file-gc.ts +0 -120
  261. package/src/execution/session-pending.ts +0 -164
  262. package/src/execution/session-reconstructor.ts +0 -678
  263. package/src/execution/session-runner.ts +0 -1781
  264. package/src/execution/sessions-index.ts +0 -304
  265. package/src/execution/spawn-event-adapter.ts +0 -363
  266. package/src/execution/stdin-writer.ts +0 -198
  267. package/src/execution/stream-sink.ts +0 -126
  268. package/src/execution/subagent-service.ts +0 -2141
  269. package/src/execution/subprocess-agent-runner.ts +0 -317
  270. package/src/execution/temp-prompt.ts +0 -62
  271. package/src/execution/tombstone-store.ts +0 -72
  272. package/src/execution/turn-limiter.ts +0 -102
  273. package/src/execution/types.ts +0 -973
  274. package/src/execution/ui-channels.ts +0 -216
  275. package/src/execution/ui-interaction-model.ts +0 -48
  276. package/src/execution/ui-request-handler-factory.ts +0 -212
  277. package/src/execution/ui-request-observability.ts +0 -81
  278. package/src/execution/ui-request-queue.ts +0 -184
  279. package/src/execution/worktree-manager.ts +0 -688
  280. package/src/execution/worktree-registry.ts +0 -222
  281. package/src/orchestration/__tests__/__fixtures__/worker-template.snapshot.txt +0 -349
  282. package/src/orchestration/__tests__/agent-call-catch-fallback.test.ts +0 -202
  283. package/src/orchestration/__tests__/agent-call-stream.test.ts +0 -152
  284. package/src/orchestration/__tests__/args-validator.test.ts +0 -143
  285. package/src/orchestration/__tests__/config-loader.test.ts +0 -503
  286. package/src/orchestration/__tests__/error-recovery-handlers.test.ts +0 -809
  287. package/src/orchestration/__tests__/error-recovery-postmessage-defense.test.ts +0 -405
  288. package/src/orchestration/__tests__/error-recovery-serialize-failed-result.test.ts +0 -56
  289. package/src/orchestration/__tests__/error-recovery-workflow-call.test.ts +0 -166
  290. package/src/orchestration/__tests__/execute-agent-call.test.ts +0 -451
  291. package/src/orchestration/__tests__/jsonl-run-store-corrupt-entry.test.ts +0 -150
  292. package/src/orchestration/__tests__/jsonl-run-store-loadall-sources.test.ts +0 -171
  293. package/src/orchestration/__tests__/jsonl-run-store-retention.test.ts +0 -202
  294. package/src/orchestration/__tests__/jsonl-run-store-session-file.test.ts +0 -1030
  295. package/src/orchestration/__tests__/launcher-nested-workflow.test.ts +0 -600
  296. package/src/orchestration/__tests__/lifecycle-runid-injection.test.ts +0 -96
  297. package/src/orchestration/__tests__/lifecycle.test.ts +0 -659
  298. package/src/orchestration/__tests__/non-cloneable-return-e2e.test.ts +0 -95
  299. package/src/orchestration/__tests__/review-fix-loop-e2e.test.ts +0 -2025
  300. package/src/orchestration/__tests__/script-lint.test.ts +0 -831
  301. package/src/orchestration/__tests__/skill-discovery.test.ts +0 -201
  302. package/src/orchestration/__tests__/test-mocks.ts +0 -197
  303. package/src/orchestration/__tests__/worker-exit-without-result.test.ts +0 -368
  304. package/src/orchestration/__tests__/worker-host.test.ts +0 -120
  305. package/src/orchestration/__tests__/worker-returnmeta-passthrough.test.ts +0 -164
  306. package/src/orchestration/__tests__/worker-script-builder-runtime.test.ts +0 -563
  307. package/src/orchestration/__tests__/worker-script-builder.test.ts +0 -309
  308. package/src/orchestration/__tests__/worker-script-template-snapshot.test.ts +0 -129
  309. package/src/orchestration/__tests__/workflow-nesting-e2e.test.ts +0 -317
  310. package/src/orchestration/__tests__/workflow-script-lint-memo.test.ts +0 -110
  311. package/src/orchestration/__tests__/workflows-e2e.test.ts +0 -537
  312. package/src/orchestration/agent-opts-resolver.ts +0 -174
  313. package/src/orchestration/args-validator.ts +0 -127
  314. package/src/orchestration/config-loader.ts +0 -315
  315. package/src/orchestration/error-recovery.ts +0 -1018
  316. package/src/orchestration/execute-agent-call.ts +0 -256
  317. package/src/orchestration/launcher.ts +0 -455
  318. package/src/orchestration/lifecycle.ts +0 -399
  319. package/src/orchestration/models/__tests__/budget.test.ts +0 -307
  320. package/src/orchestration/models/__tests__/trace.test.ts +0 -408
  321. package/src/orchestration/models/agent-call.ts +0 -83
  322. package/src/orchestration/models/budget.ts +0 -118
  323. package/src/orchestration/models/ports.ts +0 -164
  324. package/src/orchestration/models/run-runtime.ts +0 -104
  325. package/src/orchestration/models/run-spec.ts +0 -83
  326. package/src/orchestration/models/run-state.ts +0 -44
  327. package/src/orchestration/models/trace.ts +0 -183
  328. package/src/orchestration/models/types.ts +0 -301
  329. package/src/orchestration/models/workflow-run.ts +0 -254
  330. package/src/orchestration/models/workflow-script-registry.ts +0 -35
  331. package/src/orchestration/models/workflow-script.ts +0 -117
  332. package/src/orchestration/script-lint.ts +0 -766
  333. package/src/orchestration/skill-discovery.ts +0 -115
  334. package/src/orchestration/worker-handle.ts +0 -115
  335. package/src/orchestration/worker-host.ts +0 -98
  336. package/src/orchestration/worker-script-builder.ts +0 -421
  337. package/src/orchestration/workflow-files.ts +0 -85
  338. package/src/orchestration/workflow-script-registry-impl.ts +0 -133
  339. package/src/shared/__tests__/agent-ref.test.ts +0 -34
  340. package/src/shared/__tests__/meta-parser.test.ts +0 -304
  341. package/src/shared/__tests__/model-ref.test.ts +0 -306
  342. package/src/shared/__tests__/resource-discovery-manifest-cache.test.ts +0 -280
  343. package/src/shared/__tests__/resource-discovery.test.ts +0 -736
  344. package/src/shared/__tests__/resource-meta.test.ts +0 -51
  345. package/src/shared/__tests__/schema-jsonify.test.ts +0 -81
  346. package/src/shared/__tests__/timer-delay.test.ts +0 -61
  347. package/src/shared/agent-event.ts +0 -13
  348. package/src/shared/agent-ref.ts +0 -57
  349. package/src/shared/meta-parser.ts +0 -261
  350. package/src/shared/model-ref.ts +0 -286
  351. package/src/shared/resource-discovery.ts +0 -811
  352. package/src/shared/resource-meta.ts +0 -65
  353. package/src/shared/schema-env.ts +0 -44
  354. package/src/shared/schema-jsonify.ts +0 -58
  355. package/src/shared/timer-delay.ts +0 -54
  356. package/src/shared/xml-injection.ts +0 -35
  357. package/workflows/README.md +0 -81
  358. package/workflows/_shared/agent-refs.cjs +0 -40
  359. package/workflows/chain.js +0 -131
  360. package/workflows/map-reduce.js +0 -174
  361. package/workflows/parallel.js +0 -148
  362. package/workflows/review-fix-loop-utils.cjs +0 -1309
  363. package/workflows/review-fix-loop.js +0 -1404
  364. package/workflows/scatter-gather.js +0 -178
@@ -1,612 +0,0 @@
1
- /**
2
- * BgNotifier flushPendingNotifications — 单通道 triggerTurn 契约(U2 / D5)。
3
- *
4
- * 迁移史:deliverAs 从 'followUp' 改为 'steer'(FR-3/AC-3,commit d214d0d83)后,
5
- * U2 courier 单通道化再收敛——steer / followUp / nextTurn 通道全部删除(nextTurn
6
- * 唯一 drain 点在 session.prompt() 内,主 agent 长 streaming 场景下无限期滞留,
7
- * 设计 D5 实测证伪),唯一发送形态 = sendCustomMessage({triggerTurn:true});busy
8
- * 场景由 ledger(settled 边沿 + isIdle 二次复查)或内核 settled 订阅在空闲边沿驱动。
9
- *
10
- * 测试方法:mock NotifierHost,捕获 sendMessage 调用参数,断言 options 恰为
11
- * { triggerTurn: true }(G4 字节锁定测试新锚:行为契约不变,机械迁移)。
12
- */
13
-
14
- import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
15
-
16
- import { createNotifier, type BgNotifier, type NotifierHost } from "../notifier.ts";
17
-
18
- /** mock host:捕获所有 sendMessage 调用 + 控制 hasRunningBackground + isIdle。 */
19
- function makeMockHost(): NotifierHost & {
20
- sendMessageCalls: { message: unknown; options: unknown }[];
21
- hasRunningBackground: ReturnType<typeof vi.fn>;
22
- isIdle: ReturnType<typeof vi.fn>;
23
- } {
24
- const sendMessageCalls: { message: unknown; options: unknown }[] = [];
25
- const hasRunningBackground = vi.fn(() => false);
26
- const isIdle = vi.fn(() => true);
27
- return {
28
- sendMessageCalls,
29
- hasRunningBackground,
30
- isIdle,
31
- sendMessage(message, options) {
32
- sendMessageCalls.push({ message, options });
33
- },
34
- };
35
- }
36
-
37
- describe("BgNotifier.flushPendingNotifications — 单通道 triggerTurn 契约(U2/D5)", () => {
38
- let host: ReturnType<typeof makeMockHost>;
39
- let notifier: BgNotifier;
40
-
41
- beforeEach(() => {
42
- host = makeMockHost();
43
- notifier = createNotifier(host);
44
- });
45
-
46
- afterEach(() => {
47
- notifier.dispose();
48
- });
49
-
50
- it("flush 时 sendMessage 的 options 恰为 { triggerTurn: true }(无 deliverAs,D5 单通道)", () => {
51
- notifier.notify({
52
- id: "bg-test-1",
53
- status: "closed",
54
- agent: "explorer",
55
- result: "done",
56
- startedAt: Date.now() - 1000,
57
- endedAt: Date.now(),
58
- });
59
-
60
- // hasRunningBackground=false → notify 立即 flush
61
- expect(host.sendMessageCalls).toHaveLength(1);
62
- const call = host.sendMessageCalls[0];
63
- expect(call.options).toEqual({ triggerTurn: true });
64
- });
65
-
66
- it("flush 时 triggerTurn 必须为 true(让父 agent 立即唤醒)", () => {
67
- notifier.notify({
68
- id: "bg-test-2",
69
- status: "closed",
70
- agent: "worker",
71
- error: "boom",
72
- startedAt: Date.now(),
73
- endedAt: Date.now(),
74
- });
75
-
76
- expect(host.sendMessageCalls).toHaveLength(1);
77
- expect(host.sendMessageCalls[0].options).toEqual({ triggerTurn: true });
78
- });
79
- });
80
-
81
- describe("BgNotifier — isIdle gate 竞态修复", () => {
82
- let host: ReturnType<typeof makeMockHost>;
83
- let notifier: BgNotifier;
84
-
85
- beforeEach(() => {
86
- vi.useFakeTimers();
87
- host = makeMockHost();
88
- notifier = createNotifier(host);
89
- });
90
-
91
- afterEach(() => {
92
- notifier.dispose();
93
- vi.useRealTimers();
94
- });
95
-
96
- it("主 agent busy 时 flush 退避,idle 后才 sendMessage(规避 agent_end→finishRun 竞态窗口)", () => {
97
- // 模拟竞态:notify 时主 agent 仍 streaming(isIdle=false)
98
- host.isIdle.mockReturnValue(false);
99
- notifier.notify({
100
- id: "bg-race-1",
101
- status: "closed",
102
- agent: "worker",
103
- result: "ok",
104
- startedAt: Date.now(),
105
- endedAt: Date.now(),
106
- });
107
-
108
- // busy 退避:未发送
109
- expect(host.sendMessageCalls).toHaveLength(0);
110
- expect(host.isIdle).toHaveBeenCalled();
111
-
112
- // 推进 1 个退避间隔(100ms)——仍 busy,继续退避
113
- vi.advanceTimersByTime(100);
114
- expect(host.sendMessageCalls).toHaveLength(0);
115
-
116
- // 主 agent 变 idle
117
- host.isIdle.mockReturnValue(true);
118
- vi.advanceTimersByTime(100);
119
-
120
- // idle 后发送,单通道 {triggerTurn:true}(U2/D5:无 deliverAs)
121
- expect(host.sendMessageCalls).toHaveLength(1);
122
- expect(host.sendMessageCalls[0].options).toEqual({ triggerTurn: true });
123
- });
124
-
125
- it("主 agent 持续 busy 达退避上限后强制发送(防通知饿死)", () => {
126
- host.isIdle.mockReturnValue(false);
127
- notifier.notify({
128
- id: "bg-starve-1",
129
- status: "closed",
130
- agent: "worker",
131
- result: "ok",
132
- startedAt: Date.now(),
133
- endedAt: Date.now(),
134
- });
135
-
136
- expect(host.sendMessageCalls).toHaveLength(0);
137
- // 推进超过退避上限(50 × 100ms = 5s)
138
- vi.advanceTimersByTime(10_000);
139
-
140
- // 达上限后 fallthrough 强制发送(至少不丢消息)
141
- expect(host.sendMessageCalls).toHaveLength(1);
142
- });
143
-
144
- it("未注入 isIdle 时不 gate,保持原立即发送行为(向后兼容)", () => {
145
- // 重建无 isIdle 的 host(模拟旧调用方/测试 host)
146
- const legacyHost: NotifierHost = {
147
- sendMessage: (message, options) => host.sendMessage(message, options),
148
- hasRunningBackground: () => false,
149
- };
150
- const legacyNotifier = createNotifier(legacyHost);
151
- legacyNotifier.notify({
152
- id: "bg-legacy-1",
153
- status: "closed",
154
- agent: "worker",
155
- result: "ok",
156
- startedAt: Date.now(),
157
- endedAt: Date.now(),
158
- });
159
-
160
- // 无 isIdle gate → 立即发送
161
- expect(host.sendMessageCalls).toHaveLength(1);
162
- legacyNotifier.dispose();
163
- });
164
-
165
- it("dispose 后退避 timer 不再触发发送", () => {
166
- host.isIdle.mockReturnValue(false);
167
- notifier.notify({
168
- id: "bg-dispose-1",
169
- status: "closed",
170
- agent: "worker",
171
- result: "ok",
172
- startedAt: Date.now(),
173
- endedAt: Date.now(),
174
- });
175
-
176
- notifier.dispose();
177
- // 推进足够久,退避 timer 若未清会触发
178
- vi.advanceTimersByTime(10_000);
179
- expect(host.sendMessageCalls).toHaveLength(0);
180
- });
181
- });
182
-
183
- describe("BgNotifier dedup 按轮次(G1 决策 9:对话模式豁免 60s dedup)", () => {
184
- let host: ReturnType<typeof makeMockHost>;
185
- let notifier: BgNotifier;
186
-
187
- beforeEach(() => {
188
- host = makeMockHost();
189
- // hasRunningBackground=false → notify 立即 flush(不排队);dedup 仍在 push 前生效
190
- notifier = createNotifier(host);
191
- });
192
-
193
- afterEach(() => {
194
- notifier.dispose();
195
- });
196
-
197
- it("对话模式:同 id 不同 round 的两次 notify 不互相吞(round 参与 dedup key)", () => {
198
- notifier.notify({
199
- id: "sa-chat", status: "idle", agent: "w", round: 1, result: "round1",
200
- startedAt: 1, endedAt: 2,
201
- });
202
- notifier.notify({
203
- id: "sa-chat", status: "idle", agent: "w", round: 2, result: "round2",
204
- startedAt: 3, endedAt: 4,
205
- });
206
-
207
- // MF-1 修复:dedup key=id:round,不同 round 不互相吞
208
- expect(host.sendMessageCalls).toHaveLength(2);
209
- });
210
-
211
- it("同 id 同 round 60s 内第二次被 dedup 吞(防重复通知)", () => {
212
- notifier.notify({
213
- id: "sa-dup", status: "idle", agent: "w", round: 1, result: "r",
214
- startedAt: 1, endedAt: 2,
215
- });
216
- notifier.notify({
217
- id: "sa-dup", status: "idle", agent: "w", round: 1, result: "r",
218
- startedAt: 3, endedAt: 4,
219
- });
220
-
221
- // 第二条被吞(dedup key=sa-dup:1 命中)
222
- expect(host.sendMessageCalls).toHaveLength(1);
223
- });
224
-
225
- it("非 chatMode(round undefined → key=id:0)行为同旧(向后兼容,60s 内同 id 吞)", () => {
226
- // round undefined → dedup key="sa-once:0",与旧 record.id 单 key 行为一致
227
- notifier.notify({
228
- id: "sa-once", status: "closed", agent: "w", result: "done",
229
- startedAt: 1, endedAt: 2,
230
- });
231
- notifier.notify({
232
- id: "sa-once", status: "closed", agent: "w", result: "done",
233
- startedAt: 3, endedAt: 4,
234
- });
235
-
236
- // 第二条被吞(旧 dedup 行为不变,一次性模式回归)
237
- expect(host.sendMessageCalls).toHaveLength(1);
238
- });
239
- });
240
-
241
- describe("BgNotifier buildLlmContent 指针行(wave2:chatMode sessionFile 透传)", () => {
242
- let host: ReturnType<typeof makeMockHost>;
243
- let notifier: BgNotifier;
244
-
245
- beforeEach(() => {
246
- host = makeMockHost();
247
- // hasRunningBackground=false → notify 立即 flush,sendMessageCalls 恰 1 条
248
- notifier = createNotifier(host);
249
- });
250
-
251
- afterEach(() => {
252
- notifier.dispose();
253
- });
254
-
255
- /** 取唯一一条已发消息的 content(前置断言恰 1 条)。 */
256
- function sentContent(): string {
257
- expect(host.sendMessageCalls).toHaveLength(1);
258
- return (host.sendMessageCalls[0]!.message as { content: string }).content;
259
- }
260
-
261
- it("running(轮次通知)+ sessionFile → 末尾追加 \\n\\n 空行分隔的指针行", () => {
262
- notifier.notify({
263
- id: "sa-ptr-1", status: "running", agent: "w", round: 1, result: "round1 text",
264
- sessionFile: "/tmp/sessions/child-1.jsonl",
265
- startedAt: 1, endedAt: 2,
266
- });
267
-
268
- expect(sentContent()).toBe(
269
- 'Subagent "w" (sa-ptr-1) finished a round. Reply:\nround1 text' +
270
- "\n\nFull transcript: /tmp/sessions/child-1.jsonl",
271
- );
272
- });
273
-
274
- it("closed 成功文案 + sessionFile → 指针行追加在最终串末尾", () => {
275
- notifier.notify({
276
- id: "sa-ptr-2", status: "closed", agent: "w", result: "final result",
277
- sessionFile: "/tmp/sessions/child-2.jsonl",
278
- startedAt: 1, endedAt: 2,
279
- });
280
-
281
- expect(sentContent()).toBe(
282
- 'Subagent "w" (sa-ptr-2) completed. Result:\nfinal result' +
283
- "\n\nFull transcript: /tmp/sessions/child-2.jsonl",
284
- );
285
- });
286
-
287
- it("closed + patchFile + sessionFile → 指针行追加在 patch 提示串末尾(最终串)", () => {
288
- notifier.notify({
289
- id: "sa-ptr-3", status: "closed", agent: "w", result: "did work",
290
- patchFile: "/tmp/patches/sa-ptr-3.patch",
291
- sessionFile: "/tmp/sessions/child-3.jsonl",
292
- startedAt: 1, endedAt: 2,
293
- });
294
-
295
- const content = sentContent();
296
- expect(content).toContain("git apply /tmp/patches/sa-ptr-3.patch");
297
- expect(content.endsWith("\n\nFull transcript: /tmp/sessions/child-3.jsonl")).toBe(true);
298
- });
299
-
300
- it("sessionFile 缺失 → 省略整行(running 通知正文与无指针形态逐字节一致)", () => {
301
- notifier.notify({
302
- id: "sa-ptr-4", status: "running", agent: "w", round: 2, result: "round2 text",
303
- startedAt: 1, endedAt: 2,
304
- });
305
-
306
- expect(sentContent()).toBe('Subagent "w" (sa-ptr-4) finished a round. Reply:\nround2 text');
307
- });
308
-
309
- it("cancelled → 不追加指针行(即使 sessionFile 有值)", () => {
310
- notifier.notify({
311
- id: "sa-ptr-5", status: "closed", closedReason: "cancelled", agent: "w",
312
- sessionFile: "/tmp/sessions/child-5.jsonl",
313
- startedAt: 1, endedAt: 2,
314
- });
315
-
316
- expect(sentContent()).toBe('Subagent "w" (sa-ptr-5) cancelled.');
317
- });
318
-
319
- it("gc-failed(closed + closedReason=gc + error 有值)→ 不追加指针行", () => {
320
- notifier.notify({
321
- id: "sa-ptr-6", status: "closed", closedReason: "gc", agent: "w",
322
- error: "spawn EPIPE",
323
- sessionFile: "/tmp/sessions/child-6.jsonl",
324
- startedAt: 1, endedAt: 2,
325
- });
326
-
327
- expect(sentContent()).toBe('Subagent "w" (sa-ptr-6) failed: spawn EPIPE');
328
- });
329
-
330
- it("[review 修复] gc-failed + patchFile 并存 → failed 文案优先(失败轮也会写 patchFile,patch 提示不可达)", () => {
331
- // 回归锚定:doFinalizeRecord Step 0 对 worktreeHandle 无条件 collectPatch,gc 失败 +
332
- // worktree 并存时 patchFile 有值。[U3] 判定收口到单一 deriveOutcome(cancelled →
333
- // failed → patch/result),否则 LLM 被告知 completed 掩盖失败。
334
- notifier.notify({
335
- id: "sa-ptr-8", status: "closed", closedReason: "gc", agent: "w",
336
- error: "spawn EPIPE",
337
- patchFile: "/tmp/patches/sa-ptr-8.patch",
338
- sessionFile: "/tmp/sessions/child-8.jsonl",
339
- startedAt: 1, endedAt: 2,
340
- });
341
-
342
- expect(sentContent()).toBe('Subagent "w" (sa-ptr-8) failed: spawn EPIPE');
343
- });
344
-
345
- it("[U3][D6 显式取舍] parent-shutdown 合成关闭 + patchFile 并存 → failed 文案优先(patch 提示不可达)", () => {
346
- // disposeAllRecords 合成 result 恒写 error:"closed due to ..." → outcome='failed';
347
- // worktree 失败并存时仍不得展示 patch 提示(「failed 优先于 patchFile 提示」保真)。
348
- notifier.notify({
349
- id: "sa-u3-ps", status: "closed", closedReason: "parent-shutdown", agent: "w",
350
- error: "closed due to parent-shutdown",
351
- patchFile: "/tmp/patches/sa-u3-ps.patch",
352
- startedAt: 1, endedAt: 2,
353
- });
354
-
355
- expect(sentContent()).toBe('Subagent "w" (sa-u3-ps) failed: closed due to parent-shutdown');
356
- });
357
-
358
- it("[U3] details payload 物化 outcome:closed 入参缺省时按 deriveOutcome 兑底填充", () => {
359
- notifier.notify({
360
- id: "sa-u3-mat", status: "closed", closedReason: "gc", agent: "w",
361
- error: "boom",
362
- startedAt: 1, endedAt: 2,
363
- });
364
-
365
- expect(host.sendMessageCalls).toHaveLength(1);
366
- const msg = host.sendMessageCalls[0]!.message as { details?: { outcome?: string } };
367
- expect(msg.details?.outcome).toBe("failed");
368
- });
369
-
370
- it("[U3] 显式 outcome 优先于 closedReason 兑底(一等字段直读)", () => {
371
- notifier.notify({
372
- id: "sa-u3-explicit", status: "closed", closedReason: "gc", agent: "w",
373
- outcome: "cancelled",
374
- startedAt: 1, endedAt: 2,
375
- });
376
-
377
- expect(sentContent()).toBe('Subagent "w" (sa-u3-explicit) cancelled.');
378
- });
379
-
380
- it("[U3] running(轮次通知)不物化 outcome(终态语义不适用活跃态)", () => {
381
- notifier.notify({
382
- id: "sa-u3-round", status: "running", agent: "w", round: 1, result: "r1",
383
- startedAt: 1, endedAt: 2,
384
- });
385
-
386
- expect(host.sendMessageCalls).toHaveLength(1);
387
- const msg = host.sendMessageCalls[0]!.message as { details?: { outcome?: string } };
388
- expect(msg.details?.outcome).toBeUndefined();
389
- });
390
-
391
- it("one-shot(sessionFile 未透传 → undefined)→ closed 通知与改造前逐字节一致(基线常量锚定)", () => {
392
- notifier.notify({
393
- id: "sa-ptr-7", status: "closed", agent: "worker", result: "done",
394
- startedAt: 1, endedAt: 2,
395
- });
396
-
397
- // 改造前形态:sessionFile undefined 时指针为空串,追加不改变输出——逐字节锁定
398
- expect(sentContent()).toBe('Subagent "worker" (sa-ptr-7) completed. Result:\ndone');
399
- });
400
-
401
- it("[C-2] closed + totalRounds(chatMode close 终态通知)→ 文案附轮次统计 after N rounds", () => {
402
- notifier.notify({
403
- id: "sa-rounds-1", status: "closed", agent: "w", totalRounds: 3, result: "",
404
- sessionFile: "/tmp/sessions/child-rounds.jsonl",
405
- startedAt: 1, endedAt: 2,
406
- });
407
-
408
- // 设计 D2 路径①:closed 分支文案附轮次统计 + sessionFile 提示;
409
- // 路径②正文空串(idle close)形态也走本分支(result 空串非 nullish,不触发 (empty))
410
- expect(sentContent()).toBe(
411
- 'Subagent "w" (sa-rounds-1) completed after 3 rounds. Result:\n' +
412
- "\n\nFull transcript: /tmp/sessions/child-rounds.jsonl",
413
- );
414
- });
415
-
416
- it("[C-2] 对照:totalRounds 缺失(one-shot 完成通知)→ 无轮次统计,文案逐字节保持 completed. Result:", () => {
417
- notifier.notify({
418
- id: "sa-rounds-2", status: "closed", agent: "w", result: "done",
419
- sessionFile: "/tmp/sessions/child-oneshot.jsonl",
420
- startedAt: 1, endedAt: 2,
421
- });
422
-
423
- // one-shot record 无轮次语义(totalRounds 不设置)——G4:文案不含统计
424
- expect(sentContent()).toBe(
425
- 'Subagent "w" (sa-rounds-2) completed. Result:\ndone' +
426
- "\n\nFull transcript: /tmp/sessions/child-oneshot.jsonl",
427
- );
428
- });
429
- });
430
-
431
- describe("BgNotifier — subscribeSettled 装配(must-fix #4 / D8 settled 边沿驱动)", () => {
432
- let host: ReturnType<typeof makeMockHost>;
433
- let notifier: BgNotifier;
434
- /** 内核经 port.subscribeSettled 注册的 settled 边沿回调(测试手动触发模拟 pi 事件)。 */
435
- let settledEdges: Array<() => void>;
436
-
437
- beforeEach(() => {
438
- vi.useFakeTimers();
439
- host = makeMockHost();
440
- settledEdges = [];
441
- // host 注入原生订阅能力;notifier port 内部用 disposed 标志包装(D8 适配)
442
- host.onAgentSettled = (handler) => {
443
- settledEdges.push(handler);
444
- };
445
- notifier = createNotifier(host);
446
- });
447
-
448
- afterEach(() => {
449
- notifier.dispose();
450
- vi.useRealTimers();
451
- });
452
-
453
- it("busy 入队 → settled 事件触发 → flush 送达(不依赖退避轮询)", () => {
454
- host.isIdle.mockReturnValue(false);
455
- notifier.notify({
456
- id: "bg-settled-1",
457
- status: "closed",
458
- agent: "worker",
459
- result: "ok",
460
- startedAt: Date.now(),
461
- endedAt: Date.now(),
462
- });
463
-
464
- // busy 入队:内核装配了 subscribeSettled → settled 边沿驱动,注册过订阅
465
- expect(host.sendMessageCalls).toHaveLength(0);
466
- expect(settledEdges.length).toBeGreaterThanOrEqual(1);
467
-
468
- // 有订阅装配下内核不走退避强发——推进远超退避上限(50 × 100ms)仍不发送
469
- vi.advanceTimersByTime(10_000);
470
- expect(host.sendMessageCalls).toHaveLength(0);
471
-
472
- // settled 边沿(isIdle 已先于事件复位,agent-session.js:327-336)→ flush 送达
473
- host.isIdle.mockReturnValue(true);
474
- settledEdges[0]!();
475
-
476
- expect(host.sendMessageCalls).toHaveLength(1);
477
- expect(host.sendMessageCalls[0]!.options).toEqual({ triggerTurn: true });
478
- });
479
-
480
- it("dispose 后 settled 边沿不再触发发送(内核 disposed 拦截)", () => {
481
- host.isIdle.mockReturnValue(false);
482
- notifier.notify({
483
- id: "bg-settled-2",
484
- status: "closed",
485
- agent: "worker",
486
- result: "ok",
487
- startedAt: Date.now(),
488
- endedAt: Date.now(),
489
- });
490
- notifier.dispose();
491
-
492
- host.isIdle.mockReturnValue(true);
493
- settledEdges[0]!();
494
-
495
- expect(host.sendMessageCalls).toHaveLength(0);
496
- });
497
- });
498
-
499
- describe("BgNotifier — revive 重建内核 handle(must-fix #5)", () => {
500
- let host: ReturnType<typeof makeMockHost>;
501
- let notifier: BgNotifier;
502
-
503
- beforeEach(() => {
504
- host = makeMockHost();
505
- notifier = createNotifier(host);
506
- });
507
-
508
- afterEach(() => {
509
- notifier.dispose();
510
- });
511
-
512
- it("dispose → notify 静默丢弃 → revive → notify 恢复送达", () => {
513
- notifier.notify({
514
- id: "bg-revive-1",
515
- status: "closed",
516
- agent: "worker",
517
- result: "ok",
518
- startedAt: 1,
519
- endedAt: 2,
520
- });
521
- expect(host.sendMessageCalls).toHaveLength(1);
522
-
523
- // session_shutdown:dispose(内核 handle 销毁,disposed 不可逆)
524
- notifier.dispose();
525
-
526
- // dispose 窗口内的 notify:外层 disposed 短路,静默丢弃(旧有语义)
527
- notifier.notify({
528
- id: "bg-revive-2",
529
- status: "closed",
530
- agent: "worker",
531
- result: "dropped",
532
- startedAt: 3,
533
- endedAt: 4,
534
- });
535
- expect(host.sendMessageCalls).toHaveLength(1);
536
-
537
- // /resume /fork /new 后的 revive:必须重建内核 handle——旧实现仅复位外层标志,
538
- // 内核已 dispose,此后所有 notify 被内核静默吞(通知永久丢失)
539
- notifier.revive();
540
- notifier.notify({
541
- id: "bg-revive-3",
542
- status: "closed",
543
- agent: "worker",
544
- result: "alive again",
545
- startedAt: 5,
546
- endedAt: 6,
547
- });
548
-
549
- expect(host.sendMessageCalls).toHaveLength(2);
550
- const msg = host.sendMessageCalls[1]!.message as { content: string };
551
- expect(msg.content).toContain("bg-revive-3");
552
- });
553
-
554
- it("revive 后同 id 重复通知不被旧生命周期的 dedup LRU 吞(新 handle 状态复位)", () => {
555
- notifier.notify({ id: "bg-revive-dup", status: "closed", agent: "w", result: "r1", startedAt: 1, endedAt: 2 });
556
- notifier.dispose();
557
- notifier.revive();
558
- // 同 id 第二次:旧 handle 的 dedup LRU 已随 dispose 清空 + 重建,不被吞
559
- notifier.notify({ id: "bg-revive-dup", status: "closed", agent: "w", result: "r2", startedAt: 3, endedAt: 4 });
560
- expect(host.sendMessageCalls).toHaveLength(2);
561
- });
562
- });
563
-
564
- describe("U3_UNIT: createNotifier unit verification", () => {
565
- it("createNotifier returns object with notify/flush/dispose/revive", () => {
566
- const host = makeMockHost();
567
- const notifier = createNotifier(host);
568
- expect(typeof notifier.notify).toBe("function");
569
- expect(typeof notifier.flushPendingNotifications).toBe("function");
570
- expect(typeof notifier.dispose).toBe("function");
571
- expect(typeof notifier.revive).toBe("function");
572
- notifier.dispose();
573
- });
574
-
575
- it("notify calls host.sendMessage with customType=subagent-bg-notify", () => {
576
- const host = makeMockHost();
577
- const notifier = createNotifier(host);
578
- notifier.notify({
579
- id: "u3-test-1", status: "closed", agent: "worker", result: "ok",
580
- startedAt: 1, endedAt: 2,
581
- });
582
- expect(host.sendMessageCalls).toHaveLength(1);
583
- const msg = host.sendMessageCalls[0]!.message as { customType: string };
584
- expect(msg.customType).toBe("subagent-bg-notify");
585
- notifier.dispose();
586
- });
587
-
588
- it("notify with mergeHoldActive=true defers flush until explicit call", () => {
589
- const sendMessageCalls: unknown[] = [];
590
- const host: NotifierHost = {
591
- sendMessage: (msg) => { sendMessageCalls.push(msg); },
592
- hasRunningBackground: () => true,
593
- isIdle: () => true,
594
- };
595
- const notifier = createNotifier(host);
596
- notifier.notify({
597
- id: "u3-merge-1", status: "closed", agent: "w", result: "r1",
598
- startedAt: 1, endedAt: 2,
599
- });
600
- notifier.notify({
601
- id: "u3-merge-2", status: "closed", agent: "w", result: "r2",
602
- startedAt: 3, endedAt: 4,
603
- });
604
- // mergeHoldActive=true → messages queued, not sent yet
605
- expect(sendMessageCalls).toHaveLength(0);
606
- notifier.flushPendingNotifications();
607
- expect(sendMessageCalls).toHaveLength(1);
608
- const content = (sendMessageCalls[0] as { content: string }).content;
609
- expect(content).toContain("\n\n---\n\n");
610
- notifier.dispose();
611
- });
612
- });