@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,243 +0,0 @@
1
- // src/__tests__/execute-and-await-worktree.test.ts
2
- //
3
- // executeAndAwait 的 worktree 失败收尾测试(W1 code review 修复回归锁)。
4
- //
5
- // 覆盖:worktreeManager.create 抛错时 record 被 finalizeFailed(status→failed)且原错外抛。
6
- // (worktree 与 fork 解耦后,worktree:true+fork:false 的解耦验证见 subagent-service.test.ts。)
7
- //
8
- // ── mock 策略 ──
9
- //
10
- // 复用 execute-nesting.test.ts 的 spawn / node:fs / manifest-store / temp-prompt / alive-store
11
- // / finalized-marker mock 范式(见该文件头部详细注释)。本文件 **不驱动 FakeChild 完成**——
12
- // 被测的两个分支都在 runSpawn 之前抛/收尾(worktree create 在步骤 2.5,runSpawn 在步骤 5),
13
- // 因此 spawn 即使被调也无人驱动,测试在抛错后立即断言即可结束。
14
- //
15
- // worktreeManager 是 SubagentService 构造时 new 出的私有字段(WorktreeManager 实例,非模块)。
16
- // 测试 2 用 vi.spyOn(Reflect.get(service, "worktreeManager"), "create") 注入抛错,无需模块级 mock。
17
-
18
- import { PassThrough } from "node:stream";
19
-
20
- import { afterEach, describe, expect, it, vi } from "vitest";
21
-
22
- // ── mock modules(与 execute-nesting.test.ts 同范式)──
23
-
24
- vi.mock("node:child_process", async () => {
25
- const { EventEmitter } = await import("node:events");
26
- const { PassThrough } = await import("node:stream");
27
-
28
- class FakeChild extends EventEmitter {
29
- pid = 12345;
30
- stdout = new PassThrough();
31
- stderr = new PassThrough();
32
- killed = false;
33
- killSignal: string | undefined;
34
- kill(sig?: string): boolean {
35
- this.killed = true;
36
- this.killSignal = sig;
37
- return true;
38
- }
39
- }
40
-
41
- return {
42
- spawn: vi.fn(() => new FakeChild()),
43
- // buildEnvBlock 的 git branch 调用(execFile 异步):默认 err-first 兜底 → catch → branch=""
44
- execFile: vi.fn(
45
- (
46
- _cmd: string,
47
- _args: readonly string[],
48
- _opts: unknown,
49
- cb: (err: Error | null, stdout?: string, stderr?: string) => void,
50
- ) => cb(new Error("execFile not configured in this test")),
51
- ),
52
- };
53
- });
54
-
55
- vi.mock("node:fs", async () => {
56
- const actual = await import("node:fs");
57
- return {
58
- default: {
59
- ...actual,
60
- mkdirSync: vi.fn(),
61
- existsSync: vi.fn(() => false),
62
- appendFileSync: vi.fn(),
63
- writeFileSync: vi.fn(),
64
- readdirSync: vi.fn(() => []),
65
- },
66
- mkdirSync: vi.fn(),
67
- existsSync: vi.fn(() => false),
68
- appendFileSync: vi.fn(),
69
- writeFileSync: vi.fn(),
70
- readdirSync: vi.fn(() => []),
71
- promises: actual.promises,
72
- };
73
- });
74
-
75
- vi.mock("../alive-store.ts", async (importOriginal) => {
76
- const actual = await importOriginal<typeof import("../alive-store.ts")>();
77
- return {
78
- ...actual,
79
- writeAliveMarker: vi.fn(),
80
- removeAliveMarker: vi.fn(),
81
- };
82
- });
83
-
84
- vi.mock("../finalized-marker.ts", () => ({
85
- writeFinalized: vi.fn(),
86
- readFinalized: vi.fn(() => false),
87
- }));
88
-
89
- vi.mock("../manifest-store.ts", () => {
90
- class FakeManifestStore {
91
- writeManifest = vi.fn(async () => {});
92
- readManifest = vi.fn(async () => null);
93
- listAllSync = vi.fn(() => []);
94
- recoverTmpFiles = vi.fn(async () => []);
95
- }
96
- return { ManifestStore: FakeManifestStore };
97
- });
98
-
99
- vi.mock("../temp-prompt.ts", () => ({
100
- writePromptToTempFile: vi.fn(async (agent: string) => {
101
- const safeName = agent.replace(/[^\w.-]+/g, "_");
102
- return { dir: `/tmp/fake-${safeName}`, filePath: `/tmp/fake-${safeName}/prompt-${safeName}.md` };
103
- }),
104
- cleanupTempPrompt: vi.fn(async () => {}),
105
- }));
106
-
107
- import { ModelConfigService } from "../model-config-service.ts";
108
- import type { ModelInfo, ModelRegistryLike } from "../model-resolver.ts";
109
- import type { RecordStore } from "../record-store.ts";
110
- import type { WorktreeManager } from "../worktree-manager.ts";
111
- import { SubagentService } from "../subagent-service.ts";
112
-
113
- // ── 辅助:service 构造(与 execute-nesting.test.ts setup 等价)──
114
-
115
- function makeEmptyRegistry(): ModelRegistryLike {
116
- return { getAvailable: () => [], find: () => undefined, hasConfiguredAuth: () => true };
117
- }
118
-
119
- function makePi() {
120
- return { sendMessage: vi.fn(), appendEntry: vi.fn(), events: { emit: vi.fn() } };
121
- }
122
-
123
- interface SetupResult {
124
- service: SubagentService;
125
- worktreeManager: WorktreeManager;
126
- }
127
-
128
- function setup(): SetupResult {
129
- const agentDir = "/tmp/exec-await-worktree-it"; // fs 已 mock,路径不需真实存在
130
- const modelService = new ModelConfigService({ agentDir });
131
- modelService.initModel({
132
- modelRegistry: makeEmptyRegistry(),
133
- sessionId: "exec-await-worktree-it",
134
- ctxModel: { id: "m", name: "M", provider: "p", reasoning: false },
135
- });
136
- const service = new SubagentService({
137
- cwd: agentDir,
138
- modelService,
139
- getMainSessionFile: () => "/mock/main-session.jsonl",
140
- });
141
- service.initSession({ pi: makePi(), sessionId: "exec-await-worktree-it" });
142
- // worktreeManager 是 SubagentService 构造时 new 的 private 字段(无外部注入入口),
143
- // 测试经 Reflect.get 访问后 cast 到生产导出类型 WorktreeManager(已在文件顶部 import),
144
- // 让字段/方法签名与生产类型契约绑定。
145
- const worktreeManager = Reflect.get(service, "worktreeManager") as WorktreeManager;
146
- return { service, worktreeManager };
147
- }
148
-
149
- const ctxModel: ModelInfo = { id: "m", name: "M", provider: "p", reasoning: false };
150
-
151
- /**
152
- * 从 service 取出 private store(断言 record 终态用)。
153
- *
154
- * worktreeManager 与 store 都是 SubagentService 构造时 new 出的 private 字段——
155
- * 无外部注入入口,测试只能经 Reflect.get 访问。这里 cast 到生产导出类型
156
- * (RecordStore / WorktreeManager)而非内联匿名 shape,让测试与生产类型契约绑定:
157
- * 字段改名/签名变更时 tsc 立即报错(而非静默漂移)。
158
- */
159
- function getStore(service: SubagentService): RecordStore {
160
- return Reflect.get(service, "store") as RecordStore;
161
- }
162
-
163
- describe("executeAndAwait worktree 失败收尾", () => {
164
- afterEach(() => {
165
- vi.restoreAllMocks();
166
- });
167
-
168
- // ============================================================
169
- // worktreeManager.create 抛错 → record 收尾为 failed + 原错外抛
170
- // ============================================================
171
- it("worktreeManager.create 失败时 finalizeFailed 收尾 record 并抛原错", async () => {
172
- const { service, worktreeManager } = setup();
173
-
174
- const createErr = new Error("worktree create boom");
175
- vi.spyOn(worktreeManager, "create").mockImplementation(() => {
176
- throw createErr;
177
- });
178
-
179
- // spy store.archive:finalizeFailed 真实收尾链(CAS→completeRecord→archive)的最末一步。
180
- // 捕获传入 archive 的 record,断言其 status 已被推向 "failed"(证明 finalizeFailed 完整执行,
181
- // 而非仅 tryTransition 中途返回)。archive 真实执行(不 mockImplementation)以保留移出 running map 的语义。
182
- const store = getStore(service);
183
- const archiveSpy = vi.spyOn(store, "archive");
184
-
185
- await expect(
186
- service.executeAndAwait({
187
- task: "worktree create will fail",
188
- slug: "worktree-create-fail",
189
- worktree: true,
190
- fork: true,
191
- ctxModel,
192
- }),
193
- ).rejects.toBe(createErr);
194
-
195
- // finalizeFailed 完整执行:record 经 CAS→completeRecord 推到 failed 终态后 archive。
196
- expect(archiveSpy).toHaveBeenCalledTimes(1);
197
- // store 现已强类型为 RecordStore → archive 入参为 ExecutionRecord,无需 `as` 断言。
198
- const archivedRecord = archiveSpy.mock.calls[0]![0];
199
- expect(archivedRecord.status).toBe("closed");
200
- // archive 后 record 已移出 running map → listRunning 空、getMutable 取不到。
201
- expect(store.listRunning()).toHaveLength(0);
202
- expect(store.getMutable(archivedRecord.id)).toBeUndefined();
203
- });
204
-
205
- // ============================================================
206
- // create-await 竞态守卫(Phase 2):create await 窗口内 dispose 抢先把
207
- // record CAS 成 closed → 守卫 cleanup + throw cancelled(失败 throw 语义,
208
- // SAR.run 的 catch 会转 AgentResult.error)。守卫 throw 不落在 try 内
209
- // (否则被上方 catch 当 create 失败再走 finalizeFailed,对已 closed record 语义未定义)。
210
- // ============================================================
211
- it("守卫:create await 窗口内 dispose 抢先 → cleanup 被调 + throw cancelled(不进 runAndFinalize)", async () => {
212
- const { service, worktreeManager } = setup();
213
-
214
- const handle = Object.freeze({
215
- path: "/tmp/wt-guard2",
216
- branch: "pi-sub-guard2",
217
- baseCommit: "abc123",
218
- mainCwd: "/repo",
219
- }) as Parameters<WorktreeManager["cleanup"]>[0];
220
- let resolveCreate!: (h: unknown) => void;
221
- vi.spyOn(worktreeManager, "create").mockImplementation(
222
- () => new Promise((r) => { resolveCreate = r; }) as ReturnType<WorktreeManager["create"]>,
223
- );
224
- const cleanupSpy = vi.spyOn(worktreeManager, "cleanup").mockResolvedValue(undefined);
225
-
226
- const execP = service.executeAndAwait({
227
- task: "guard test",
228
- slug: "guard-test",
229
- worktree: true,
230
- fork: true,
231
- ctxModel,
232
- });
233
- // 微任务推进:record 已建 + executeAndAwait 挂在 pending create 上
234
- await new Promise((r) => { setTimeout(r, 0); });
235
- // dispose 抢先:CAS running → closed(此刻 worktreeHandle 仍 undefined,
236
- // dispose 的 fire-and-forget cleanup 跳过)——守卫是唯一清理点
237
- service.disposeAllRecords("parent-shutdown");
238
- resolveCreate(handle);
239
-
240
- await expect(execP).rejects.toThrow("cancelled during worktree creation");
241
- expect(cleanupSpy).toHaveBeenCalledWith(handle);
242
- });
243
- });
@@ -1,323 +0,0 @@
1
- // src/__tests__/execute-nesting.test.ts
2
- //
3
- // D-030~D-033 嵌套 / 并发池 / 节流回归锁。独立于 execute-integration.test.ts。
4
- //
5
- // 用例:
6
- // D-032 background 进并发池(分层配额:max(1, maxConcurrent - depth))
7
- // D-033 execute 入口通用嵌套护栏(execCtxAls 计 fork+非 fork 嵌套,深度>MAX 拒)
8
- // (原「嵌套抑制 onUpdate」「节流清理 throttleState」用例组已随 onEventThrottled
9
- // 死路径删除一并移除——swf-perf-impl ledger #22 / cleanup-slice TC4)
10
- //
11
- // ── mock 策略 ──
12
- //
13
- // [关键] runSpawn(session-runner.ts)通过 child_process.spawn("pi",...) 启动子进程,
14
- // 事件经 stdout JSON 流回流。它 **不走 getSdk / createAgentSession**。
15
- // 因此本文件 mock 的是 node:child_process.spawn(返回 FakeChild),而非 getSdk/fakeSession
16
- // (那是对 in-process run() 的旧 mock,在 spawn 改造后是死代码)。
17
- //
18
- // mock 模式参考 run-spawn-integration.test.ts(该文件是 spawn 改造后的正确 mock 范式):
19
- // - node:child_process.spawn → FakeChild(EventEmitter + PassThrough),测试控制器
20
- // emit stdout JSON 行(header + SdkEvent)/ stderr / close 时序。
21
- // - node:child_process.execFile → err-first callback 默认兜底(buildEnvBlock 的 git
22
- // branch 调用失败 → catch → branch="",避免副作用)。
23
- // - node:fs 同步方法 → mock(mkdirSync/existsSync/appendFileSync/writeFileSync/readdirSync),
24
- // 避免 sessionDir/sessionFile 触碰真实文件系统。
25
- // - fs.promises.* → 保留真实实现(temp-prompt 整体被 mock,不触发真实 I/O)。
26
- // - temp-prompt → mock(writePromptToTempFile 返回固定路径,消除 fake-timers flaky)。
27
- // - alive-store.writeAliveMarker → mock(避免写 .alive sidecar)。
28
- //
29
- // 所有断言语义不变:它们测的是 SubagentService 的 **编排逻辑**
30
- // (pool.acquire / execCtxAls 深度),这些逻辑
31
- // 无论事件来自 fakeSession.subscribe 还是 FakeChild.stdout 都一致。
32
-
33
- import type { PassThrough } from "node:stream";
34
-
35
- import { afterEach, describe, expect, it, vi } from "vitest";
36
-
37
- // ── mock modules ──
38
- //
39
- // vitest 会把 vi.mock 提升到文件顶部(早于其他 import / 声明)。mock 工厂若要引用
40
- // FakeChild,需在工厂内部 import(async 工厂可用 await import),而非引用顶部
41
- // 顶层 import(它们在 vi.mock 执行时尚未绑定)。
42
-
43
- vi.mock("node:child_process", async () => {
44
- const { EventEmitter } = await import("node:events");
45
- const { PassThrough } = await import("node:stream");
46
-
47
- // FakeChild:模拟 ChildProcess(EventEmitter + PassThrough streams)。
48
- // 测试通过 lastSpawnedChild() 取回实例,控制 emit stdout JSON 行 / close 时序。
49
- class FakeChild extends EventEmitter {
50
- pid = 12345;
51
- stdout = new PassThrough();
52
- stderr = new PassThrough();
53
- killed = false;
54
- killSignal: string | undefined;
55
- kill(sig?: string): boolean {
56
- this.killed = true;
57
- this.killSignal = sig;
58
- return true;
59
- }
60
- }
61
-
62
- return {
63
- spawn: vi.fn(() => new FakeChild()),
64
- // buildEnvBlock 的 git branch 调用(execFile 异步):默认 err-first 兜底 → catch → branch=""
65
- execFile: vi.fn(
66
- (
67
- _cmd: string,
68
- _args: readonly string[],
69
- _opts: unknown,
70
- cb: (err: Error | null, stdout?: string, stderr?: string) => void,
71
- ) => cb(new Error("execFile not configured in this test")),
72
- ),
73
- };
74
- });
75
-
76
- // node:fs:同步方法 mock(runSpawn 用到的全部),promises 保留真实实现(temp-prompt 用)。
77
- vi.mock("node:fs", async () => {
78
- const actual = await import("node:fs");
79
- return {
80
- default: {
81
- ...actual,
82
- mkdirSync: vi.fn(),
83
- existsSync: vi.fn(() => false),
84
- appendFileSync: vi.fn(),
85
- writeFileSync: vi.fn(),
86
- readdirSync: vi.fn(() => []),
87
- },
88
- // 具名导出与 default 保持一致
89
- mkdirSync: vi.fn(),
90
- existsSync: vi.fn(() => false),
91
- appendFileSync: vi.fn(),
92
- writeFileSync: vi.fn(),
93
- readdirSync: vi.fn(() => []),
94
- // promises 保留真实实现——temp-prompt 已被 mock(见下方 vi.mock),不再触发真实 I/O
95
- promises: actual.promises,
96
- };
97
- });
98
-
99
- // alive-store:mock writeAliveMarker(runSpawn 写 .alive sidecar)+ removeAliveMarker
100
- // (finalizeRecord 收尾删 .alive)。其余导出(readAliveMarker/isProcessAlive)保留真实实现
101
- // (worktree-manager/record-store 用,本组用例不涉及但保留以避免间接报错)。
102
- vi.mock("../alive-store.ts", async (importOriginal) => {
103
- const actual = await importOriginal<typeof import("../alive-store.ts")>();
104
- return {
105
- ...actual,
106
- writeAliveMarker: vi.fn(),
107
- removeAliveMarker: vi.fn(),
108
- };
109
- });
110
-
111
- // finalized-marker mock:避免真实 fs 写 sidecar(测试不关心 finalized 行为)
112
- vi.mock("../finalized-marker.ts", () => ({
113
- writeFinalized: vi.fn(),
114
- readFinalized: vi.fn(() => false),
115
- }));
116
-
117
- // manifest-store mock:writeManifest 用真实 fs.promises 写盘,但本文件 fs 同步方法已 mock
118
- // (目录从不真实创建)→ open/rename/unlink 全 ENOENT → bestEffort 异步 console.debug。
119
- // 这些延迟 console 通过 worker RPC(onUserConsoleLog)回流,与 vitest teardown 形成 race:
120
- // "Closing rpc while onUserConsoleLog was pending" → unhandled rejection / exit 1(flaky)。
121
- // 本组用例测编排逻辑(pool / depth / throttle),不测 manifest 持久化(有 manifest-store.test.ts
122
- // 独立覆盖)。故 mock 成 no-op,消除 teardown race 的根因——异步 console 输出。
123
- vi.mock("../manifest-store.ts", () => {
124
- class FakeManifestStore {
125
- writeManifest = vi.fn(async () => {});
126
- readManifest = vi.fn(async () => null);
127
- listAllSync = vi.fn(() => []);
128
- recoverTmpFiles = vi.fn(async () => []);
129
- }
130
- return { ManifestStore: FakeManifestStore };
131
- });
132
-
133
- // temp-prompt:mock 掉真实 fs.promises I/O,消除 fake-timers 下的 flaky 竞态
134
- // (详见 run-spawn-integration.test.ts 同名 mock 的注释)。
135
- vi.mock("../temp-prompt.ts", () => ({
136
- writePromptToTempFile: vi.fn(async (agent: string) => {
137
- const safeName = agent.replace(/[^\w.-]+/g, "_");
138
- return { dir: `/tmp/fake-${safeName}`, filePath: `/tmp/fake-${safeName}/prompt-${safeName}.md` };
139
- }),
140
- cleanupTempPrompt: vi.fn(async () => {}),
141
- }));
142
-
143
- import { spawn } from "node:child_process";
144
-
145
- import { waitForSpawn } from "./helpers/spawn-mock.ts";
146
- import { ModelConfigService } from "../model-config-service.ts";
147
- import type { ModelInfo, ModelRegistryLike } from "../model-resolver.ts";
148
- import { MAX_FORK_DEPTH } from "../session-context-resolver.ts";
149
- import { SubagentService } from "../subagent-service.ts";
150
-
151
- const mockSpawn = vi.mocked(spawn);
152
-
153
- /**
154
- * spawn mock 返回的 fake child 类型。
155
- * 由于 FakeChild 定义在 vi.mock 工厂内部(作用域隔离),此处用结构子集类型描述,
156
- * 测试代码通过此类型访问 stdout/stderr/kill 等成员。
157
- */
158
- interface FakeChild {
159
- pid: number;
160
- stdout: PassThrough;
161
- stderr: PassThrough;
162
- killed: boolean;
163
- killSignal: string | undefined;
164
- kill(sig?: string): boolean;
165
- emit(event: string, ...args: unknown[]): boolean;
166
- }
167
-
168
- /** 从最近一次 spawn 调用取回返回的 FakeChild(测试控制器)。 */
169
- function lastSpawnedChild(): FakeChild {
170
- const result = mockSpawn.mock.results.at(-1);
171
- if (!result) throw new Error("spawn was not called yet");
172
- return result.value as FakeChild;
173
- }
174
-
175
- // ============================================================
176
- // 辅助:FakeChild stdout 驱动(替代旧 fakeSession.subscribe 的事件注入)
177
- // ============================================================
178
-
179
- /** 构造 session header 行(stdout 首行,runSpawn 据此回填 record.sessionFile)。 */
180
- function sessionHeader(id = "nest-session"): Record<string, unknown> {
181
- return {
182
- type: "session",
183
- id,
184
- timestamp: "2026-07-03T12-00-00-000Z",
185
- cwd: "/tmp/test",
186
- };
187
- }
188
-
189
- /** 向 stdout 写一行 JSON(自动补换行,runSpawn 按 \n split 行)。 */
190
- function emitStdoutLine(child: FakeChild, obj: Record<string, unknown>): void {
191
- child.stdout.write(`${JSON.stringify(obj)}\n`);
192
- }
193
-
194
- /**
195
- * 驱动 FakeChild 完成 session:写 header + 可选事件 + close(0)。
196
- *
197
- * 这是「让 runSpawn 自然 resolve」的标准收尾路径。runSpawn 在 close 后判定 success
198
- * (exitCode=0 → success=true),并跑 identity 补写 + finalizeRecord。
199
- *
200
- * @param events header 之后、close 之前 emit 的 SdkEvent 行(tool/message/turn 等)
201
- */
202
- async function driveChildToCompletion(child: FakeChild, events: Record<string, unknown>[] = []): Promise<void> {
203
- emitStdoutLine(child, sessionHeader());
204
- for (const e of events) emitStdoutLine(child, e);
205
- child.stdout.end();
206
- child.stderr.end();
207
- child.emit("close", 0);
208
- }
209
-
210
- // ============================================================
211
- // 辅助:service 构造(与旧 setup 等价,但不再装配 fakeSdk)
212
- // ============================================================
213
-
214
- function makeEmptyRegistry(): ModelRegistryLike {
215
- return { getAvailable: () => [], find: () => undefined, hasConfiguredAuth: () => true };
216
- }
217
-
218
- function makePi() {
219
- return { sendMessage: vi.fn(), appendEntry: vi.fn(), events: { emit: vi.fn() } };
220
- }
221
-
222
- interface SetupResult {
223
- service: SubagentService;
224
- }
225
-
226
- function setup(): SetupResult {
227
- const agentDir = "/tmp/nest-it"; // fs 已 mock,路径不需真实存在
228
- const modelService = new ModelConfigService({ agentDir });
229
- modelService.initModel({
230
- modelRegistry: makeEmptyRegistry(),
231
- sessionId: "nest-it",
232
- ctxModel: { id: "m", name: "M", provider: "p", reasoning: false },
233
- });
234
- const service = new SubagentService({
235
- cwd: agentDir,
236
- modelService,
237
- getMainSessionFile: () => "/mock/main-session.jsonl",
238
- });
239
- service.initSession({ pi: makePi(), sessionId: "nest-it" });
240
- return { service };
241
- }
242
-
243
- const ctxModel: ModelInfo = { id: "m", name: "M", provider: "p", reasoning: false };
244
-
245
- /** execCtxAls.run 的 duck-type(绕过 import AsyncLocalStorage,足够本组用例)。 */
246
- interface ExecCtxAls {
247
- run: <T>(store: { recordId: string | undefined; depth: number }, cb: () => T) => T;
248
- }
249
-
250
- describe("嵌套护栏 / 并发池 / 节流(D-030~D-033 回归锁)", () => {
251
- afterEach(() => {
252
- vi.clearAllMocks();
253
- });
254
-
255
- // ============================================================
256
- // D-032: background execute 进并发池(分层配额)
257
- // ============================================================
258
-
259
- it("[D-032] background execute 调 pool.acquire(进池限流)", async () => {
260
- const { service } = setup();
261
-
262
- const pool = Reflect.get(service, "pool") as { acquire: ReturnType<typeof vi.fn>; release: ReturnType<typeof vi.fn> };
263
- const acquireSpy = vi.spyOn(pool, "acquire");
264
-
265
- const execPromise = service.execute({ task: "bg in pool", ctxModel });
266
- // detached runAndFinalize → acquire。等 spawn 拿到 child 再驱动完成。
267
- await waitForSpawn(mockSpawn);
268
- await driveChildToCompletion(lastSpawnedChild());
269
-
270
- // 等 detached promise 链跑完(kickOffBackground 的 .then notify)
271
- await new Promise<void>((r) => setTimeout(r, 10));
272
-
273
- expect(acquireSpy).toHaveBeenCalled();
274
- // background execute 立即返回 handle(不等完成)
275
- const handle = await execPromise;
276
- expect(handle.mode).toBe("background");
277
- });
278
-
279
- // ============================================================
280
- // D-033: 通用嵌套护栏(execute 入口,execCtxAls 非 fork 路径)
281
- // ============================================================
282
-
283
- it("[D-033] execCtxAls depth=MAX 时 execute 抛错(nestingDepth=MAX+1 被拒)", async () => {
284
- const { service } = setup();
285
-
286
- const execCtxAls = Reflect.get(service, "execCtxAls") as ExecCtxAls;
287
-
288
- await expect(
289
- execCtxAls.run({ recordId: "parent", depth: MAX_FORK_DEPTH }, () =>
290
- service.execute({ task: "too deep", ctxModel }),
291
- ),
292
- ).rejects.toThrow(/nesting depth/);
293
-
294
- // 无副作用:guard 在 createRecordForMode 之前,record 未创建
295
- expect(service.collectRecords(10)).toHaveLength(0);
296
- // guard 在 spawn 之前——不应 spawn 任何子进程
297
- expect(mockSpawn).not.toHaveBeenCalled();
298
- });
299
-
300
- it("[D-033] execCtxAls depth=MAX-1 时 execute 不抛(nestingDepth=MAX 允许)", async () => {
301
- const { service } = setup();
302
-
303
- const execCtxAls = Reflect.get(service, "execCtxAls") as ExecCtxAls;
304
-
305
- const execPromise = execCtxAls.run({ recordId: "parent", depth: MAX_FORK_DEPTH - 1 }, () =>
306
- service.execute({ task: "at limit", ctxModel }),
307
- );
308
- await waitForSpawn(mockSpawn);
309
- await driveChildToCompletion(lastSpawnedChild(), [
310
- { type: "turn_end" },
311
- { type: "message_end", message: { usage: { input: 1 } } },
312
- ]);
313
- const result = await execPromise;
314
-
315
- expect(result.mode).toBe("background");
316
- });
317
-
318
- // ============================================================
319
- // 原嵌套抑制 onUpdate / 节流清理 throttleState 用例组(:322-355)已删除——
320
- // onEventThrottled 死路径删除(swf-perf-impl ledger #22 / cleanup-slice TC4/IF14,
321
- // 详见 .cw/swf-perf-impl/cleanup-slice-design.json)。恢复点:本 slice 前的 git 历史。
322
- // ============================================================
323
- });