@zhushanwen/pi-subagent-workflow 8.6.0 → 8.7.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 (347) hide show
  1. package/package.json +9 -13
  2. package/relay/relay.mjs +1 -1
  3. package/src/host/__tests__/pi-host.test.ts +214 -0
  4. package/src/host/pi-host.ts +109 -0
  5. package/src/index.ts +89 -32
  6. package/src/injectors/__tests__/engine-awareness.test.ts +292 -0
  7. package/src/injectors/__tests__/engine-section-stability.test.ts +341 -0
  8. package/src/injectors/__tests__/subagent-list-injector.test.ts +5 -5
  9. package/src/injectors/__tests__/workflow-list-injector.test.ts +5 -5
  10. package/src/injectors/engine-awareness.ts +123 -0
  11. package/src/injectors/model-list-injector.ts +1 -1
  12. package/src/injectors/subagent-list-injector.ts +8 -8
  13. package/src/injectors/workflow-list-injector.ts +8 -8
  14. package/src/interface/__tests__/detectors.test.ts +3 -3
  15. package/src/interface/__tests__/subagent-tool-path-guard.test.ts +2 -2
  16. package/src/interface/__tests__/tool-workflow-script-generate.test.ts +2 -2
  17. package/src/interface/__tests__/tool-workflow-throw-paths.test.ts +1 -1
  18. package/src/interface/bg-notify-render.ts +4 -4
  19. package/src/interface/commands.ts +3 -3
  20. package/src/interface/format.ts +2 -2
  21. package/src/interface/helpers.ts +1 -1
  22. package/src/interface/list-component.ts +4 -4
  23. package/src/interface/list-shared.ts +2 -2
  24. package/src/interface/list-view.ts +2 -2
  25. package/src/interface/subagent-actions.ts +263 -11
  26. package/src/interface/subagent-tool-schema.ts +20 -13
  27. package/src/interface/subagent-tool.ts +11 -6
  28. package/src/interface/subagents.ts +3 -3
  29. package/src/interface/tool-render.ts +34 -2
  30. package/src/interface/tool-workflow-script.ts +4 -4
  31. package/src/interface/tool-workflow.ts +6 -6
  32. package/src/interface/views/WorkflowsView.ts +5 -5
  33. package/src/interface/views/__tests__/WorkflowsView-signature.test.ts +3 -3
  34. package/src/interface/views/__tests__/detail-content-session-file.test.ts +2 -2
  35. package/src/interface/views/detail-content.ts +4 -4
  36. package/src/interface/views/format.ts +4 -4
  37. package/src/{orchestration/jsonl-run-store.ts → jsonl-run-store.ts} +11 -11
  38. package/src/execution/__tests__/__fixtures__/notifier-golden-snapshots.json +0 -53
  39. package/src/execution/__tests__/__fixtures__/truncline.snapshot.json +0 -1
  40. package/src/execution/__tests__/agent-registry.test.ts +0 -363
  41. package/src/execution/__tests__/agent-result-mapper.test.ts +0 -150
  42. package/src/execution/__tests__/alive-store.test.ts +0 -147
  43. package/src/execution/__tests__/ask-user-transit-e2e.test.ts +0 -490
  44. package/src/execution/__tests__/before-agent-start-injection.test.ts +0 -132
  45. package/src/execution/__tests__/bg-notify-render.test.ts +0 -329
  46. package/src/execution/__tests__/channel-registry-handshake.test.ts +0 -243
  47. package/src/execution/__tests__/chat-engine-routing.test.ts +0 -601
  48. package/src/execution/__tests__/chatmode-first-round-closure-service.test.ts +0 -365
  49. package/src/execution/__tests__/chatmode-first-round-closure-spawn.test.ts +0 -190
  50. package/src/execution/__tests__/chatmode-round-notify-real-chain.test.ts +0 -215
  51. package/src/execution/__tests__/concurrency-pool.test.ts +0 -250
  52. package/src/execution/__tests__/config.test.ts +0 -110
  53. package/src/execution/__tests__/conversation-wiring.test.ts +0 -198
  54. package/src/execution/__tests__/crash-recovery.test.ts +0 -320
  55. package/src/execution/__tests__/delivery-methods.test.ts +0 -422
  56. package/src/execution/__tests__/dialog-queue.test.ts +0 -299
  57. package/src/execution/__tests__/epipe-fallback.test.ts +0 -241
  58. package/src/execution/__tests__/execute-and-await-worktree.test.ts +0 -243
  59. package/src/execution/__tests__/execute-nesting.test.ts +0 -323
  60. package/src/execution/__tests__/execute-options-mapper.test.ts +0 -200
  61. package/src/execution/__tests__/execution-record.test.ts +0 -1394
  62. package/src/execution/__tests__/explicit-agent-ref-guard.test.ts +0 -171
  63. package/src/execution/__tests__/finalize-record.test.ts +0 -368
  64. package/src/execution/__tests__/finalized-marker.test.ts +0 -82
  65. package/src/execution/__tests__/format-schema-instruction.test.ts +0 -169
  66. package/src/execution/__tests__/format.test.ts +0 -458
  67. package/src/execution/__tests__/gc-timer.test.ts +0 -184
  68. package/src/execution/__tests__/get-record-for-action-restart.test.ts +0 -254
  69. package/src/execution/__tests__/gui-mode-dispatch.test.ts +0 -59
  70. package/src/execution/__tests__/helpers/mock-extension-api.ts +0 -30
  71. package/src/execution/__tests__/helpers/spawn-mock.ts +0 -242
  72. package/src/execution/__tests__/host-mode.test.ts +0 -87
  73. package/src/execution/__tests__/index-session-start-identity.test.ts +0 -371
  74. package/src/execution/__tests__/index-session-start.test.ts +0 -672
  75. package/src/execution/__tests__/lifecycle-manager-lock.test.ts +0 -211
  76. package/src/execution/__tests__/lifecycle-manager.test.ts +0 -383
  77. package/src/execution/__tests__/lifecycle-predicates.test.ts +0 -116
  78. package/src/execution/__tests__/list-component.test.ts +0 -401
  79. package/src/execution/__tests__/list-fields.test.ts +0 -140
  80. package/src/execution/__tests__/manifest-parentid.test.ts +0 -117
  81. package/src/execution/__tests__/model-resolver.test.ts +0 -465
  82. package/src/execution/__tests__/nested-visibility-env-propagation.test.ts +0 -287
  83. package/src/execution/__tests__/nested-visibility.test.ts +0 -325
  84. package/src/execution/__tests__/notifier-flush.test.ts +0 -612
  85. package/src/execution/__tests__/notifier-golden-snapshot.test.ts +0 -261
  86. package/src/execution/__tests__/notify-ledger.test.ts +0 -826
  87. package/src/execution/__tests__/one-shot-upgrade.test.ts +0 -205
  88. package/src/execution/__tests__/output-collector.test.ts +0 -358
  89. package/src/execution/__tests__/parent-child-matrix.test.ts +0 -336
  90. package/src/execution/__tests__/path-encoding.test.ts +0 -104
  91. package/src/execution/__tests__/pi-invocation.test.ts +0 -134
  92. package/src/execution/__tests__/record-store.test.ts +0 -1057
  93. package/src/execution/__tests__/records-cwd-isolation.test.ts +0 -91
  94. package/src/execution/__tests__/recursive-visibility-baseline.test.ts +0 -339
  95. package/src/execution/__tests__/recursive-visibility-env.test.ts +0 -273
  96. package/src/execution/__tests__/relay-agent.test.ts +0 -448
  97. package/src/execution/__tests__/relay-env.test.ts +0 -42
  98. package/src/execution/__tests__/resource-policy.test.ts +0 -109
  99. package/src/execution/__tests__/rpc-mode.test.ts +0 -89
  100. package/src/execution/__tests__/run-and-finalize-chatmode.test.ts +0 -267
  101. package/src/execution/__tests__/run-spawn-chatmode-settled.test.ts +0 -253
  102. package/src/execution/__tests__/run-spawn-edges.test.ts +0 -687
  103. package/src/execution/__tests__/run-spawn-integration.test.ts +0 -933
  104. package/src/execution/__tests__/run-spawn-resume.test.ts +0 -322
  105. package/src/execution/__tests__/run-spawn-rpc-mode.test.ts +0 -196
  106. package/src/execution/__tests__/run-spawn-stdout-callback-throw.test.ts +0 -199
  107. package/src/execution/__tests__/sdk-contract.test.ts +0 -273
  108. package/src/execution/__tests__/session-context-resolver.test.ts +0 -167
  109. package/src/execution/__tests__/session-file-gc.test.ts +0 -293
  110. package/src/execution/__tests__/session-pending.test.ts +0 -197
  111. package/src/execution/__tests__/session-reconstructor.test.ts +0 -379
  112. package/src/execution/__tests__/session-runner-epipe.test.ts +0 -178
  113. package/src/execution/__tests__/session-runner-schema-env.test.ts +0 -350
  114. package/src/execution/__tests__/session-start-reaper.test.ts +0 -233
  115. package/src/execution/__tests__/spawn-args.test.ts +0 -445
  116. package/src/execution/__tests__/spawn-event-adapter-rpc.test.ts +0 -189
  117. package/src/execution/__tests__/spawn-event-adapter.test.ts +0 -167
  118. package/src/execution/__tests__/spawn-worktree-guidance.test.ts +0 -207
  119. package/src/execution/__tests__/spawned-children.test.ts +0 -92
  120. package/src/execution/__tests__/start-sync-model-guard.test.ts +0 -150
  121. package/src/execution/__tests__/startup-config-declaration.test.ts +0 -35
  122. package/src/execution/__tests__/status-refactor.test.ts +0 -345
  123. package/src/execution/__tests__/stdin-writer.test.ts +0 -463
  124. package/src/execution/__tests__/stream-sink-retirement.test.ts +0 -261
  125. package/src/execution/__tests__/subagent-service-abort.test.ts +0 -60
  126. package/src/execution/__tests__/subagent-service-message-close.test.ts +0 -629
  127. package/src/execution/__tests__/subagent-service-parent-guard.test.ts +0 -180
  128. package/src/execution/__tests__/subagent-service.test.ts +0 -788
  129. package/src/execution/__tests__/subprocess-agent-runner-routing.test.ts +0 -310
  130. package/src/execution/__tests__/subprocess-agent-runner.test.ts +0 -599
  131. package/src/execution/__tests__/temp-prompt.test.ts +0 -53
  132. package/src/execution/__tests__/timeout-integration.test.ts +0 -615
  133. package/src/execution/__tests__/tombstone-store.test.ts +0 -73
  134. package/src/execution/__tests__/tool-action.test.ts +0 -476
  135. package/src/execution/__tests__/truncline-snapshot.test.ts +0 -81
  136. package/src/execution/__tests__/turn-limiter-semantics.test.ts +0 -194
  137. package/src/execution/__tests__/turn-limiter.test.ts +0 -65
  138. package/src/execution/__tests__/ui-channels.test.ts +0 -187
  139. package/src/execution/__tests__/ui-interaction-model.test.ts +0 -67
  140. package/src/execution/__tests__/ui-request-handler-factory.test.ts +0 -370
  141. package/src/execution/__tests__/ui-request-handler.test.ts +0 -204
  142. package/src/execution/__tests__/ui-request-observability.test.ts +0 -114
  143. package/src/execution/__tests__/ui-request-queue.test.ts +0 -133
  144. package/src/execution/__tests__/worktree-manager.test.ts +0 -633
  145. package/src/execution/__tests__/worktree-pid-registration.integration.test.ts +0 -229
  146. package/src/execution/__tests__/worktree-reconcile.integration.test.ts +0 -181
  147. package/src/execution/__tests__/worktree-registry.test.ts +0 -199
  148. package/src/execution/agent-registry.ts +0 -199
  149. package/src/execution/agent-result-mapper.ts +0 -90
  150. package/src/execution/alive-store.ts +0 -92
  151. package/src/execution/argv-mirror.ts +0 -113
  152. package/src/execution/best-effort.ts +0 -38
  153. package/src/execution/channel-registry-access.ts +0 -144
  154. package/src/execution/concurrency-pool.ts +0 -116
  155. package/src/execution/config.ts +0 -96
  156. package/src/execution/dialog-queue.ts +0 -330
  157. package/src/execution/engine/__tests__/common/data-dir.test.ts +0 -53
  158. package/src/execution/engine/__tests__/common/errors.test.ts +0 -132
  159. package/src/execution/engine/__tests__/common/event-journal.test.ts +0 -177
  160. package/src/execution/engine/__tests__/common/kill-chain.test.ts +0 -192
  161. package/src/execution/engine/__tests__/common/nesting-guard.test.ts +0 -81
  162. package/src/execution/engine/__tests__/common/persona-router.test.ts +0 -123
  163. package/src/execution/engine/__tests__/common/pool-manager.test.ts +0 -154
  164. package/src/execution/engine/__tests__/common/schema-emulation.test.ts +0 -128
  165. package/src/execution/engine/__tests__/conformance/__fixtures__/pi-golden-events.json +0 -28
  166. package/src/execution/engine/__tests__/conformance/agent-event-invariants.ts +0 -141
  167. package/src/execution/engine/__tests__/conformance/contract.abort.test.ts +0 -109
  168. package/src/execution/engine/__tests__/conformance/contract.agent-events.test.ts +0 -101
  169. package/src/execution/engine/__tests__/conformance/contract.probe.test.ts +0 -77
  170. package/src/execution/engine/__tests__/conformance/contract.read-degradation.test.ts +0 -104
  171. package/src/execution/engine/__tests__/conformance/contract.relay.test.ts +0 -342
  172. package/src/execution/engine/__tests__/conformance/engine-conformance.live.test.ts +0 -201
  173. package/src/execution/engine/__tests__/conformance/golden-replay.pi.test.ts +0 -76
  174. package/src/execution/engine/__tests__/conformance/golden-replay.zcode.test.ts +0 -79
  175. package/src/execution/engine/__tests__/engine-discovery.test.ts +0 -87
  176. package/src/execution/engine/__tests__/engines-declaration.test.ts +0 -36
  177. package/src/execution/engine/__tests__/model-prompt.test.ts +0 -85
  178. package/src/execution/engine/__tests__/paths.test.ts +0 -39
  179. package/src/execution/engine/__tests__/registry.test.ts +0 -120
  180. package/src/execution/engine/__tests__/routing.test.ts +0 -231
  181. package/src/execution/engine/common/data-dir.ts +0 -62
  182. package/src/execution/engine/common/errors.ts +0 -183
  183. package/src/execution/engine/common/event-journal.ts +0 -254
  184. package/src/execution/engine/common/journal-replay.ts +0 -62
  185. package/src/execution/engine/common/kill-chain.ts +0 -221
  186. package/src/execution/engine/common/nesting-guard.ts +0 -50
  187. package/src/execution/engine/common/persona-router.ts +0 -108
  188. package/src/execution/engine/common/pool-manager.ts +0 -226
  189. package/src/execution/engine/common/schema-emulation.ts +0 -189
  190. package/src/execution/engine/common/session-view-projection.ts +0 -51
  191. package/src/execution/engine/engine-discovery.ts +0 -65
  192. package/src/execution/engine/engines/pi/__tests__/pi-engine.test.ts +0 -469
  193. package/src/execution/engine/engines/pi/__tests__/reader.test.ts +0 -155
  194. package/src/execution/engine/engines/pi/__tests__/task-spec-mapper.test.ts +0 -164
  195. package/src/execution/engine/engines/pi/pi-engine.ts +0 -415
  196. package/src/execution/engine/engines/pi/reader.ts +0 -48
  197. package/src/execution/engine/engines/pi/registration.ts +0 -35
  198. package/src/execution/engine/engines/pi/task-spec-mapper.ts +0 -100
  199. package/src/execution/engine/engines/zcode/__tests__/__fixtures__/zcode-golden-spawn.json +0 -39
  200. package/src/execution/engine/engines/zcode/__tests__/launcher.test.ts +0 -150
  201. package/src/execution/engine/engines/zcode/__tests__/parser.test.ts +0 -246
  202. package/src/execution/engine/engines/zcode/__tests__/preparer.test.ts +0 -228
  203. package/src/execution/engine/engines/zcode/__tests__/reader.test.ts +0 -210
  204. package/src/execution/engine/engines/zcode/__tests__/registration.test.ts +0 -64
  205. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.live.test.ts +0 -127
  206. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.test.ts +0 -580
  207. package/src/execution/engine/engines/zcode/constants.ts +0 -43
  208. package/src/execution/engine/engines/zcode/golden-sample.ts +0 -39
  209. package/src/execution/engine/engines/zcode/launcher.ts +0 -161
  210. package/src/execution/engine/engines/zcode/parser.ts +0 -436
  211. package/src/execution/engine/engines/zcode/preparer.ts +0 -363
  212. package/src/execution/engine/engines/zcode/reader.ts +0 -381
  213. package/src/execution/engine/engines/zcode/registration.ts +0 -37
  214. package/src/execution/engine/engines/zcode/zcode-engine.ts +0 -658
  215. package/src/execution/engine/host-task-spec.ts +0 -47
  216. package/src/execution/engine/model-prompt.ts +0 -59
  217. package/src/execution/engine/paths.ts +0 -42
  218. package/src/execution/engine/port.ts +0 -153
  219. package/src/execution/engine/registry.ts +0 -123
  220. package/src/execution/engine/routing.ts +0 -218
  221. package/src/execution/engine/types.ts +0 -309
  222. package/src/execution/execute-options-mapper.ts +0 -112
  223. package/src/execution/execution-record.ts +0 -965
  224. package/src/execution/finalize-record.ts +0 -251
  225. package/src/execution/finalized-marker.ts +0 -51
  226. package/src/execution/get-state-handshake.ts +0 -104
  227. package/src/execution/host-mode.ts +0 -56
  228. package/src/execution/idle-gc.ts +0 -47
  229. package/src/execution/lifecycle-manager.ts +0 -513
  230. package/src/execution/lifecycle-predicates.ts +0 -65
  231. package/src/execution/manifest-store.ts +0 -256
  232. package/src/execution/model-config-service.ts +0 -219
  233. package/src/execution/model-resolver.ts +0 -248
  234. package/src/execution/notifier.ts +0 -330
  235. package/src/execution/notify-ledger.ts +0 -580
  236. package/src/execution/output-collector.ts +0 -228
  237. package/src/execution/path-encoding.ts +0 -60
  238. package/src/execution/pi-invocation.ts +0 -120
  239. package/src/execution/record-entry.ts +0 -132
  240. package/src/execution/record-store.ts +0 -1234
  241. package/src/execution/relay-env.ts +0 -37
  242. package/src/execution/session-context-resolver.ts +0 -64
  243. package/src/execution/session-file-gc.ts +0 -120
  244. package/src/execution/session-pending.ts +0 -164
  245. package/src/execution/session-reconstructor.ts +0 -678
  246. package/src/execution/session-runner.ts +0 -1781
  247. package/src/execution/sessions-index.ts +0 -304
  248. package/src/execution/spawn-event-adapter.ts +0 -363
  249. package/src/execution/stdin-writer.ts +0 -198
  250. package/src/execution/stream-sink.ts +0 -126
  251. package/src/execution/subagent-service.ts +0 -2141
  252. package/src/execution/subprocess-agent-runner.ts +0 -317
  253. package/src/execution/temp-prompt.ts +0 -62
  254. package/src/execution/tombstone-store.ts +0 -72
  255. package/src/execution/turn-limiter.ts +0 -102
  256. package/src/execution/types.ts +0 -973
  257. package/src/execution/ui-channels.ts +0 -216
  258. package/src/execution/ui-interaction-model.ts +0 -48
  259. package/src/execution/ui-request-handler-factory.ts +0 -212
  260. package/src/execution/ui-request-observability.ts +0 -81
  261. package/src/execution/ui-request-queue.ts +0 -184
  262. package/src/execution/worktree-manager.ts +0 -688
  263. package/src/execution/worktree-registry.ts +0 -222
  264. package/src/orchestration/__tests__/__fixtures__/worker-template.snapshot.txt +0 -349
  265. package/src/orchestration/__tests__/agent-call-catch-fallback.test.ts +0 -202
  266. package/src/orchestration/__tests__/agent-call-stream.test.ts +0 -152
  267. package/src/orchestration/__tests__/args-validator.test.ts +0 -143
  268. package/src/orchestration/__tests__/config-loader.test.ts +0 -503
  269. package/src/orchestration/__tests__/error-recovery-handlers.test.ts +0 -809
  270. package/src/orchestration/__tests__/error-recovery-postmessage-defense.test.ts +0 -405
  271. package/src/orchestration/__tests__/error-recovery-serialize-failed-result.test.ts +0 -56
  272. package/src/orchestration/__tests__/error-recovery-workflow-call.test.ts +0 -166
  273. package/src/orchestration/__tests__/execute-agent-call.test.ts +0 -451
  274. package/src/orchestration/__tests__/jsonl-run-store-corrupt-entry.test.ts +0 -150
  275. package/src/orchestration/__tests__/jsonl-run-store-loadall-sources.test.ts +0 -171
  276. package/src/orchestration/__tests__/jsonl-run-store-retention.test.ts +0 -202
  277. package/src/orchestration/__tests__/jsonl-run-store-session-file.test.ts +0 -1030
  278. package/src/orchestration/__tests__/launcher-nested-workflow.test.ts +0 -600
  279. package/src/orchestration/__tests__/lifecycle-runid-injection.test.ts +0 -96
  280. package/src/orchestration/__tests__/lifecycle.test.ts +0 -659
  281. package/src/orchestration/__tests__/non-cloneable-return-e2e.test.ts +0 -95
  282. package/src/orchestration/__tests__/review-fix-loop-e2e.test.ts +0 -2025
  283. package/src/orchestration/__tests__/script-lint.test.ts +0 -831
  284. package/src/orchestration/__tests__/skill-discovery.test.ts +0 -201
  285. package/src/orchestration/__tests__/test-mocks.ts +0 -197
  286. package/src/orchestration/__tests__/worker-exit-without-result.test.ts +0 -368
  287. package/src/orchestration/__tests__/worker-host.test.ts +0 -120
  288. package/src/orchestration/__tests__/worker-returnmeta-passthrough.test.ts +0 -164
  289. package/src/orchestration/__tests__/worker-script-builder-runtime.test.ts +0 -563
  290. package/src/orchestration/__tests__/worker-script-builder.test.ts +0 -309
  291. package/src/orchestration/__tests__/worker-script-template-snapshot.test.ts +0 -129
  292. package/src/orchestration/__tests__/workflow-nesting-e2e.test.ts +0 -317
  293. package/src/orchestration/__tests__/workflow-script-lint-memo.test.ts +0 -110
  294. package/src/orchestration/__tests__/workflows-e2e.test.ts +0 -537
  295. package/src/orchestration/agent-opts-resolver.ts +0 -174
  296. package/src/orchestration/args-validator.ts +0 -127
  297. package/src/orchestration/config-loader.ts +0 -315
  298. package/src/orchestration/error-recovery.ts +0 -1018
  299. package/src/orchestration/execute-agent-call.ts +0 -256
  300. package/src/orchestration/launcher.ts +0 -455
  301. package/src/orchestration/lifecycle.ts +0 -399
  302. package/src/orchestration/models/__tests__/budget.test.ts +0 -307
  303. package/src/orchestration/models/__tests__/trace.test.ts +0 -408
  304. package/src/orchestration/models/agent-call.ts +0 -83
  305. package/src/orchestration/models/budget.ts +0 -118
  306. package/src/orchestration/models/ports.ts +0 -164
  307. package/src/orchestration/models/run-runtime.ts +0 -104
  308. package/src/orchestration/models/run-spec.ts +0 -83
  309. package/src/orchestration/models/run-state.ts +0 -44
  310. package/src/orchestration/models/trace.ts +0 -183
  311. package/src/orchestration/models/types.ts +0 -301
  312. package/src/orchestration/models/workflow-run.ts +0 -254
  313. package/src/orchestration/models/workflow-script-registry.ts +0 -35
  314. package/src/orchestration/models/workflow-script.ts +0 -117
  315. package/src/orchestration/script-lint.ts +0 -766
  316. package/src/orchestration/skill-discovery.ts +0 -115
  317. package/src/orchestration/worker-handle.ts +0 -115
  318. package/src/orchestration/worker-host.ts +0 -98
  319. package/src/orchestration/worker-script-builder.ts +0 -421
  320. package/src/orchestration/workflow-files.ts +0 -85
  321. package/src/orchestration/workflow-script-registry-impl.ts +0 -133
  322. package/src/shared/__tests__/agent-ref.test.ts +0 -34
  323. package/src/shared/__tests__/meta-parser.test.ts +0 -304
  324. package/src/shared/__tests__/model-ref.test.ts +0 -306
  325. package/src/shared/__tests__/resource-discovery-manifest-cache.test.ts +0 -280
  326. package/src/shared/__tests__/resource-discovery.test.ts +0 -736
  327. package/src/shared/__tests__/resource-meta.test.ts +0 -51
  328. package/src/shared/__tests__/schema-jsonify.test.ts +0 -81
  329. package/src/shared/__tests__/timer-delay.test.ts +0 -61
  330. package/src/shared/agent-event.ts +0 -13
  331. package/src/shared/agent-ref.ts +0 -57
  332. package/src/shared/meta-parser.ts +0 -261
  333. package/src/shared/model-ref.ts +0 -286
  334. package/src/shared/resource-discovery.ts +0 -811
  335. package/src/shared/resource-meta.ts +0 -65
  336. package/src/shared/schema-env.ts +0 -44
  337. package/src/shared/schema-jsonify.ts +0 -58
  338. package/src/shared/timer-delay.ts +0 -54
  339. package/src/shared/xml-injection.ts +0 -35
  340. package/workflows/README.md +0 -81
  341. package/workflows/_shared/agent-refs.cjs +0 -40
  342. package/workflows/chain.js +0 -131
  343. package/workflows/map-reduce.js +0 -174
  344. package/workflows/parallel.js +0 -148
  345. package/workflows/review-fix-loop-utils.cjs +0 -1309
  346. package/workflows/review-fix-loop.js +0 -1404
  347. 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
- });