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