@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,293 +0,0 @@
1
- // src/__tests__/session-file-gc.test.ts
2
- //
3
- // 锁定 maybeCleanupExpiredSessionFiles 的 TTL 边界(数据安全风险):
4
- // - 概率门(CLEANUP_PROBABILITY = 1/20)
5
- // - TTL 边界(mtimeMs 恰好 = now - TTL_MS)
6
- // - 只删 .jsonl,不删 .txt 等
7
- // - 递归 walk 子目录
8
- // - best-effort 吞错(只读目录不外抛)
9
- //
10
- // 边界算错会误删未过期 session 文件或不清理——数据安全风险。
11
- import * as fs from "node:fs";
12
- import * as os from "node:os";
13
- import * as path from "node:path";
14
-
15
- import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
16
-
17
- import * as aliveStore from "../alive-store.ts";
18
- import { maybeCleanupExpiredSessionFiles } from "../session-file-gc.ts";
19
-
20
- // ============================================================
21
- // helpers
22
- // ============================================================
23
-
24
- let tmpAgentDir: string;
25
-
26
- beforeEach(() => {
27
- tmpAgentDir = fs.mkdtempSync(path.join(os.tmpdir(), "subagents-gc-test-"));
28
- });
29
-
30
- afterEach(() => {
31
- fs.rmSync(tmpAgentDir, { recursive: true, force: true });
32
- vi.restoreAllMocks();
33
- });
34
-
35
- /** 强制 Math.random 返回 0(< CLEANUP_PROBABILITY → 必触发清理)。 */
36
- function forceCleanupTrigger(): void {
37
- vi.spyOn(Math, "random").mockReturnValue(0);
38
- }
39
-
40
- /** 强制 Math.random 返回 1(>= CLEANUP_PROBABILITY → 跳过清理)。 */
41
- function forceCleanupSkip(): void {
42
- vi.spyOn(Math, "random").mockReturnValue(1);
43
- }
44
-
45
- /** 创建一个 .jsonl 文件,mtime 设为指定天数前。 */
46
- function createSessionFile(relPath: string, daysAgo: number): string {
47
- const fullPath = path.join(tmpAgentDir, "subagents", relPath);
48
- fs.mkdirSync(path.dirname(fullPath), { recursive: true });
49
- fs.writeFileSync(fullPath, `{"id":"${relPath}"}\n`, "utf-8");
50
- // 设置 mtime:daysAgo 天前
51
- const targetTime = Date.now() / 1000 - daysAgo * 86400;
52
- fs.utimesSync(fullPath, targetTime, targetTime);
53
- return fullPath;
54
- }
55
-
56
- // ============================================================
57
- // maybeCleanupExpiredSessionFiles
58
- // ============================================================
59
-
60
- describe("maybeCleanupExpiredSessionFiles", () => {
61
- it("skips cleanup when random >= CLEANUP_PROBABILITY (probability gate)", () => {
62
- forceCleanupSkip();
63
- const oldFile = createSessionFile("old.jsonl", 31); // 31 天前,超 TTL
64
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
65
- // 概率门跳过 → 文件仍在
66
- expect(fs.existsSync(oldFile)).toBe(true);
67
- });
68
-
69
- it("triggers cleanup when random < CLEANUP_PROBABILITY", () => {
70
- forceCleanupTrigger();
71
- const oldFile = createSessionFile("old.jsonl", 31);
72
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
73
- expect(fs.existsSync(oldFile)).toBe(false);
74
- });
75
-
76
- it("deletes files older than 30 days (TTL)", () => {
77
- forceCleanupTrigger();
78
- const old = createSessionFile("old.jsonl", 31);
79
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
80
- expect(fs.existsSync(old)).toBe(false);
81
- });
82
-
83
- it("preserves files younger than 30 days", () => {
84
- forceCleanupTrigger();
85
- const young = createSessionFile("young.jsonl", 29);
86
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
87
- expect(fs.existsSync(young)).toBe(true);
88
- });
89
-
90
- it("does NOT delete non-.jsonl files even if old (e.g. .txt)", () => {
91
- forceCleanupTrigger();
92
- const oldTxt = createSessionFile("old.txt", 31);
93
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
94
- // .txt 不在清理范围
95
- expect(fs.existsSync(oldTxt)).toBe(true);
96
- });
97
-
98
- it("recursively walks subdirectories", () => {
99
- forceCleanupTrigger();
100
- // 子目录中的旧文件
101
- const oldNested = createSessionFile(
102
- path.join("encoded-cwd-1", "sessions", "sess-old.jsonl"),
103
- 31,
104
- );
105
- const youngNested = createSessionFile(
106
- path.join("encoded-cwd-1", "sessions", "sess-young.jsonl"),
107
- 5,
108
- );
109
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
110
- expect(fs.existsSync(oldNested)).toBe(false);
111
- expect(fs.existsSync(youngNested)).toBe(true);
112
- });
113
-
114
- it("no-op when subagents dir does not exist (no throw)", () => {
115
- forceCleanupTrigger();
116
- // tmpAgentDir 下没有 subagents/ 目录
117
- expect(() => maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd")).not.toThrow();
118
- });
119
-
120
- it("best-effort: never throws when 'subagents' is a file not a dir (readdirSync ENOTDIR)", () => {
121
- // ESM 不允许 spyOn 命名空间导出,改用真实错误场景:
122
- // 创建一个名为 subagents 的普通文件(非目录),existsSync 返 true 但 readdirSync 抛 ENOTDIR
123
- forceCleanupTrigger();
124
- const fileNotDir = path.join(tmpAgentDir, "subagents");
125
- fs.writeFileSync(fileNotDir, "not a directory", "utf-8");
126
- // walkAndClean 内部 readdirSync 抛错 → 被其 try/catch 吞掉 → 不外抛
127
- expect(() => maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd")).not.toThrow();
128
- });
129
-
130
- it("TTL boundary: file just under 30 days is NOT deleted (strict greater-than semantics)", () => {
131
- // walkAndClean 条件: now - stat.mtimeMs > TTL_MS(严格大于)
132
- // 设 mtime 为 30 天前减去 2 分钟 → now - mtimeMs = TTL_MS - 2min + ε < TTL_MS → 保留
133
- // 用 2 分钟缓冲消除「设 mtime 与 Date.now() 调用之间的几 ms 时间差」造成的抖动
134
- forceCleanupTrigger();
135
- const boundary = createSessionFile("boundary.jsonl", 0);
136
- // 覆盖 mtime 为「30 天 - 2 分钟」前
137
- const targetTime = Date.now() / 1000 - (30 * 86400 - 120);
138
- fs.utimesSync(boundary, targetTime, targetTime);
139
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
140
- // 严格 < TTL_MS → 不删(边界保留)
141
- expect(fs.existsSync(boundary)).toBe(true);
142
- });
143
-
144
- it("handles empty subagents dir (no files, no throw)", () => {
145
- forceCleanupTrigger();
146
- // 创建空 subagents 目录
147
- fs.mkdirSync(path.join(tmpAgentDir, "subagents"), { recursive: true });
148
- expect(() => maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd")).not.toThrow();
149
- });
150
-
151
- // ---- .finalized sidecar 清理 ----
152
-
153
- it("deletes .finalized sidecar along with expired .jsonl", () => {
154
- forceCleanupTrigger();
155
- const jsonl = createSessionFile("sess-finalized.jsonl", 31);
156
- const finalized = `${jsonl}.finalized`;
157
- fs.writeFileSync(finalized, "", "utf-8");
158
- const targetTime = Date.now() / 1000 - 31 * 86400;
159
- fs.utimesSync(finalized, targetTime, targetTime);
160
-
161
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
162
-
163
- expect(fs.existsSync(jsonl)).toBe(false);
164
- expect(fs.existsSync(finalized)).toBe(false);
165
- });
166
-
167
- it("cleans orphan .finalized sidecar when .jsonl already gone", () => {
168
- forceCleanupTrigger();
169
- const subagentsDir = path.join(tmpAgentDir, "subagents");
170
- fs.mkdirSync(subagentsDir, { recursive: true });
171
- const orphan = path.join(subagentsDir, "dead-session.jsonl.finalized");
172
- fs.writeFileSync(orphan, "", "utf-8");
173
- const targetTime = Date.now() / 1000 - 31 * 86400;
174
- fs.utimesSync(orphan, targetTime, targetTime);
175
-
176
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
177
-
178
- expect(fs.existsSync(orphan)).toBe(false);
179
- });
180
-
181
- // ---- .alive sidecar + pid 探活 ----
182
-
183
- it("preserves expired .jsonl when .alive sidecar indicates live process (D-024)", () => {
184
- forceCleanupTrigger();
185
- const jsonl = createSessionFile("sess-alive.jsonl", 31);
186
- const alivePath = `${jsonl}.alive`;
187
- fs.writeFileSync(alivePath, JSON.stringify({ pid: 1, id: "s1", startedAt: Date.now() }), "utf-8");
188
-
189
- vi.spyOn(aliveStore, "readAliveMarker").mockReturnValue({ pid: 1, id: "s1", startedAt: Date.now() });
190
- vi.spyOn(aliveStore, "isProcessAlive").mockReturnValue(true);
191
-
192
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
193
-
194
- expect(fs.existsSync(jsonl)).toBe(true);
195
- expect(fs.existsSync(alivePath)).toBe(true);
196
- });
197
-
198
- it("deletes expired .jsonl + .alive when process is dead", () => {
199
- forceCleanupTrigger();
200
- const jsonl = createSessionFile("sess-dead.jsonl", 31);
201
- const alivePath = `${jsonl}.alive`;
202
- fs.writeFileSync(alivePath, JSON.stringify({ pid: 99999, id: "s2", startedAt: Date.now() }), "utf-8");
203
-
204
- vi.spyOn(aliveStore, "readAliveMarker").mockReturnValue({ pid: 99999, id: "s2", startedAt: Date.now() });
205
- vi.spyOn(aliveStore, "isProcessAlive").mockReturnValue(false);
206
-
207
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
208
-
209
- expect(fs.existsSync(jsonl)).toBe(false);
210
- expect(fs.existsSync(alivePath)).toBe(false);
211
- });
212
-
213
- it("cleans orphan .alive sidecar when .jsonl already gone", () => {
214
- forceCleanupTrigger();
215
- const subagentsDir = path.join(tmpAgentDir, "subagents");
216
- fs.mkdirSync(subagentsDir, { recursive: true });
217
- const orphan = path.join(subagentsDir, "dead-session.jsonl.alive");
218
- fs.writeFileSync(orphan, JSON.stringify({ pid: 99999, id: "s3", startedAt: Date.now() }), "utf-8");
219
- const targetTime = Date.now() / 1000 - 31 * 86400;
220
- fs.utimesSync(orphan, targetTime, targetTime);
221
-
222
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
223
-
224
- expect(fs.existsSync(orphan)).toBe(false);
225
- });
226
-
227
- it("deletes .jsonl + all sidecars (.cancelled, .finalized, .alive) together", () => {
228
- forceCleanupTrigger();
229
- const jsonl = createSessionFile("sess-all-sidecars.jsonl", 31);
230
- const cancelled = `${jsonl}.cancelled`;
231
- const finalized = `${jsonl}.finalized`;
232
- const alive = `${jsonl}.alive`;
233
- fs.writeFileSync(cancelled, "", "utf-8");
234
- fs.writeFileSync(finalized, "", "utf-8");
235
- fs.writeFileSync(alive, JSON.stringify({ pid: 99999, id: "s4", startedAt: Date.now() }), "utf-8");
236
-
237
- vi.spyOn(aliveStore, "readAliveMarker").mockReturnValue({ pid: 99999, id: "s4", startedAt: Date.now() });
238
- vi.spyOn(aliveStore, "isProcessAlive").mockReturnValue(false);
239
-
240
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
241
-
242
- expect(fs.existsSync(jsonl)).toBe(false);
243
- expect(fs.existsSync(cancelled)).toBe(false);
244
- expect(fs.existsSync(finalized)).toBe(false);
245
- expect(fs.existsSync(alive)).toBe(false);
246
- });
247
-
248
- // ---- [F2] manifest .json 清理(仅 records 子目录内)----
249
- // records 目录布局:subagents/<enc>/records/<id>.json(D-004 cwd 物理隔离)。
250
- // allowManifestJson 仅在名为 records 的子目录内打开,防止误删 enc 外层的
251
- // worktrees.json(worktree reaper 依赖的状态文件)。
252
-
253
- it("[F2] deletes expired manifest .json inside records/ subdir", () => {
254
- forceCleanupTrigger();
255
- const manifest = createSessionFile(
256
- path.join("--Users-x-proj--", "records", "rec-1.json"),
257
- 31,
258
- );
259
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
260
- expect(fs.existsSync(manifest)).toBe(false);
261
- });
262
-
263
- it("[F2] preserves manifest .json younger than TTL inside records/", () => {
264
- forceCleanupTrigger();
265
- const manifest = createSessionFile(
266
- path.join("--Users-x-proj--", "records", "rec-young.json"),
267
- 5,
268
- );
269
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
270
- expect(fs.existsSync(manifest)).toBe(true);
271
- });
272
-
273
- it("[F2] CRITICAL: does NOT delete worktrees.json at subagents/ root (regression)", () => {
274
- // 破坏性风险点:worktrees.json 在 agentDir/subagents/worktrees.json(enc 外层第一层)。
275
- // 暴力匹配所有 .json 会误删 → worktree reaper 失效。allowManifestJson 只在名为 records
276
- // 的子目录内打开,根层的 worktrees.json 必须保留。
277
- forceCleanupTrigger();
278
- const worktrees = createSessionFile("worktrees.json", 31);
279
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
280
- expect(fs.existsSync(worktrees)).toBe(true);
281
- });
282
-
283
- it("[F2] preserves .json.tmp.* inside records/ (recoverTmpFiles owns them)", () => {
284
- // 跳过 .tmp.:session_start 的 recoverTmpFiles 同步处理 tmp,GC 不重复。
285
- forceCleanupTrigger();
286
- const tmp = createSessionFile(
287
- path.join("--Users-x-proj--", "records", "rec-2.json.tmp.123"),
288
- 31,
289
- );
290
- maybeCleanupExpiredSessionFiles(tmpAgentDir, "/cwd");
291
- expect(fs.existsSync(tmp)).toBe(true);
292
- });
293
- });
@@ -1,197 +0,0 @@
1
- // src/execution/__tests__/session-pending.test.ts
2
- //
3
- // readActivePendingFromSessionFile:读 session 文件算活跃后代(pending 差集)。
4
- // 覆盖:差集、快速路径过滤、文件不存在/坏行/未回填 sessionFile。
5
-
6
- import * as fs from "node:fs";
7
- import * as os from "node:os";
8
- import * as path from "node:path";
9
-
10
- import { afterEach, beforeEach, describe, expect, it } from "vitest";
11
-
12
- import { readActivePendingFromSessionFile, clearPendingCursors } from "../session-pending.ts";
13
-
14
- function makeTmpSessionFile(lines: string[]): string {
15
- const dir = fs.mkdtempSync(path.join(os.tmpdir(), "session-pending-test-"));
16
- const file = path.join(dir, "session.jsonl");
17
- fs.writeFileSync(file, lines.join("\n") + "\n");
18
- return file;
19
- }
20
-
21
- const mkRegister = (id: string, type: "subagent" | "workflow" = "subagent") =>
22
- JSON.stringify({ type: "custom", customType: "pending:register", data: { id, type, name: id } });
23
-
24
- const mkUnregister = (id: string, reason = "completed", ts = "2026-08-06T08:00:00.000Z") =>
25
- JSON.stringify({ type: "custom", customType: "pending:unregister", data: { id, reason }, timestamp: ts });
26
-
27
- const mkMessage = (role: string, text: string) =>
28
- JSON.stringify({ type: "message", id: `m-${Date.now()}-${Math.random()}`, message: { role, content: [{ type: "text", text }] } });
29
-
30
- describe("readActivePendingFromSessionFile", () => {
31
- const tmpFiles: string[] = [];
32
-
33
- afterEach(() => {
34
- for (const f of tmpFiles.splice(0)) {
35
- try {
36
- fs.rmSync(path.dirname(f), { recursive: true, force: true });
37
- } catch {
38
- // 清理失败不影响断言
39
- }
40
- }
41
- });
42
-
43
- it("无 pending entries → count 0", () => {
44
- const file = makeTmpSessionFile([mkMessage("user", "hi"), mkMessage("assistant", "hello")]);
45
- tmpFiles.push(file);
46
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 0, recentUnregister: false });
47
- });
48
-
49
- it("纯 register → count = 活跃后代数", () => {
50
- const file = makeTmpSessionFile([mkRegister("bg-1"), mkRegister("bg-2", "workflow")]);
51
- tmpFiles.push(file);
52
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 2, recentUnregister: false });
53
- });
54
-
55
- it("register + unregister 同 id → 差集抵消", () => {
56
- const file = makeTmpSessionFile([mkRegister("bg-1"), mkUnregister("bg-1")]);
57
- tmpFiles.push(file);
58
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 0, recentUnregister: false });
59
- });
60
-
61
- it("混合:部分注销 → 只统计仍活跃的(真实 e2e 场景:P 的 agent_end 时 explorer 未注销)", () => {
62
- const file = makeTmpSessionFile([
63
- mkRegister("bg-1"),
64
- mkUnregister("bg-1", "completed"),
65
- mkRegister("explorer-1"),
66
- mkMessage("assistant", "waiting for explorer..."),
67
- ]);
68
- tmpFiles.push(file);
69
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 1, recentUnregister: false });
70
- });
71
-
72
- it("fork 继承的主 session register 已被 expired unregister 抵消 → 不干扰", () => {
73
- // 模拟 P fork 主 session:继承 register(sessionId 不匹配),session_start 重建补 unregister(expired)
74
- const file = makeTmpSessionFile([
75
- mkRegister("parent-bg"),
76
- mkUnregister("parent-bg", "expired"),
77
- mkRegister("my-bg"),
78
- ]);
79
- tmpFiles.push(file);
80
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 1, recentUnregister: false });
81
- });
82
-
83
- it("坏行(截断 JSON)跳过,不影响其余判定", () => {
84
- const file = makeTmpSessionFile([
85
- '{"type":"custom","customType":"pending:register","data":{"id":"bg-1"',
86
- mkRegister("bg-2"),
87
- ]);
88
- tmpFiles.push(file);
89
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 1, recentUnregister: false });
90
- });
91
-
92
- it("sessionFile 未回填(undefined)→ error(调用方保守不 kill)", () => {
93
- const res = readActivePendingFromSessionFile(undefined);
94
- expect(res.count).toBe(0);
95
- expect(res.error).toBeDefined();
96
- });
97
-
98
- it("文件不存在 → error(调用方保守不 kill)", () => {
99
- const res = readActivePendingFromSessionFile("/nonexistent/path/session.jsonl");
100
- expect(res.count).toBe(0);
101
- expect(res.error).toBeDefined();
102
- });
103
-
104
- it("最近 60s 内有 unregister → recentUnregister=true(后代刚完成,唤醒在路上——竞态窗口不 kill)", () => {
105
- const file = makeTmpSessionFile([
106
- mkRegister("bg-live"),
107
- mkUnregister("bg-live", "completed", new Date().toISOString()),
108
- ]);
109
- tmpFiles.push(file);
110
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 0, recentUnregister: true });
111
- });
112
-
113
- it("unregister 在 60s 窗口外 → recentUnregister=false(正常 kill 路径)", () => {
114
- const file = makeTmpSessionFile([
115
- mkRegister("bg-live"),
116
- mkUnregister("bg-live", "completed", "2020-01-01T00:00:00.000Z"),
117
- ]);
118
- tmpFiles.push(file);
119
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 0, recentUnregister: false });
120
- });
121
-
122
- // [S-4] fast-path 按值匹配而非序列化格式。旧行 `line.includes('"customType":"pending:')`
123
- // 耦合 pi 的 JSON 序列化空格习惯(冒号后无空格)。若 pi 改序列化(单行内冒号后加空格),
124
- // 旧实现全过滤 → count=0 → keep-alive 静默失效 → recursive tree 被杀、steer 丢失。
125
- // 本用例构造冒号后带空格的单行 JSON,验证值匹配仍命中 + 解析正确。
126
- it("S-4: 序列化冒号后带空格 → 仍正确解析(防 fast-path 格式耦合导致 keep-alive 静默失效)", () => {
127
- const file = makeTmpSessionFile([
128
- `{ "type": "message", "message": { "role": "user", "content": [] } }`,
129
- `{ "type": "custom", "customType": "pending:register", "data": { "id": "bg-1", "type": "subagent", "name": "bg-1" } }`,
130
- `{ "type": "custom", "customType": "pending:unregister", "data": { "id": "bg-1", "reason": "completed" }, "timestamp": "2020-01-01T00:00:00.000Z" }`,
131
- `{ "type": "custom", "customType": "pending:register", "data": { "id": "bg-2", "type": "subagent", "name": "bg-2" } }`,
132
- ]);
133
- tmpFiles.push(file);
134
- // bg-1 register+unregister 抵消,bg-2 仍活跃 → count=1。
135
- // 旧 fast-path(`"customType":"pending:` 冒号无空格)会跳过所有行 → count=0(静默失效)。
136
- expect(readActivePendingFromSessionFile(file)).toEqual({ count: 1, recentUnregister: false });
137
- });
138
- });
139
-
140
- // [perf] 增量游标行为:同文件重复判定(层主被多个后代唤醒 N 次 → N 次 agent_end)
141
- // 只读上次 offset 之后的新增行,累计差集语义与全量读一致。
142
- describe("readActivePendingFromSessionFile — 增量游标 [perf]", () => {
143
- let dir: string;
144
- let file: string;
145
-
146
- beforeEach(() => {
147
- dir = fs.mkdtempSync(path.join(os.tmpdir(), "session-pending-incr-"));
148
- file = path.join(dir, "session.jsonl");
149
- clearPendingCursors();
150
- });
151
-
152
- afterEach(() => {
153
- fs.rmSync(dir, { recursive: true, force: true });
154
- });
155
-
156
- it("首次全量 + append 后增量:unregister 只抵消对应 id(与全量读一致)", () => {
157
- fs.writeFileSync(file, mkRegister("d1") + "\n" + mkRegister("d2") + "\n");
158
- expect(readActivePendingFromSessionFile(file).count).toBe(2);
159
-
160
- fs.appendFileSync(file, mkUnregister("d1", "completed") + "\n");
161
- const r = readActivePendingFromSessionFile(file);
162
- expect(r.error).toBeUndefined();
163
- expect(r.count).toBe(1);
164
- });
165
-
166
- it("EOF 半行(append 竞态)不入账,补全换行后入账", () => {
167
- fs.writeFileSync(file, mkRegister("d1") + "\n");
168
- expect(readActivePendingFromSessionFile(file).count).toBe(1);
169
-
170
- // 半行:无尾换行 → offset 不推进该行
171
- const full = mkUnregister("d1", "completed", new Date().toISOString());
172
- fs.appendFileSync(file, full.slice(0, full.length - 4));
173
- expect(readActivePendingFromSessionFile(file).count).toBe(1);
174
-
175
- // 补全(剩余字符 + 换行)→ 消费
176
- fs.appendFileSync(file, full.slice(-4) + "\n");
177
- const r = readActivePendingFromSessionFile(file);
178
- expect(r.count).toBe(0);
179
- expect(r.recentUnregister).toBe(true);
180
- });
181
-
182
- it("文件 truncate/重建(size 回退)→ 重置游标从头全读", () => {
183
- fs.writeFileSync(file, mkRegister("d1") + "\n" + mkRegister("d2") + "\n");
184
- expect(readActivePendingFromSessionFile(file).count).toBe(2);
185
-
186
- fs.writeFileSync(file, mkRegister("d3") + "\n");
187
- expect(readActivePendingFromSessionFile(file).count).toBe(1);
188
- });
189
-
190
- it("clearPendingCursors 后重新全量(累计 entries 不残留旧账)", () => {
191
- fs.writeFileSync(file, mkRegister("d1") + "\n");
192
- expect(readActivePendingFromSessionFile(file).count).toBe(1);
193
- clearPendingCursors();
194
- fs.appendFileSync(file, mkRegister("d2") + "\n");
195
- expect(readActivePendingFromSessionFile(file).count).toBe(2);
196
- });
197
- });