@zhushanwen/subagent-core 0.4.0 → 0.6.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 (309) hide show
  1. package/dist/{chunk-4KN4TTG7.js → chunk-43ONBFZX.js} +1 -1
  2. package/dist/{chunk-X7SZ5HLQ.js → chunk-V3VHZ2VX.js} +20 -27
  3. package/dist/execution/engine/engines/zcode/constants.cjs +29 -41
  4. package/dist/execution/engine/engines/zcode/constants.d.cts +65 -53
  5. package/dist/execution/engine/engines/zcode/constants.d.ts +65 -53
  6. package/dist/execution/engine/engines/zcode/constants.js +17 -27
  7. package/dist/execution/engine/engines/zcode/reader.d.cts +2 -1
  8. package/dist/execution/engine/engines/zcode/reader.d.ts +2 -1
  9. package/dist/execution/engine/engines/zcode/reader.js +2 -2
  10. package/dist/index.cjs +17100 -14082
  11. package/dist/index.d.cts +5336 -4033
  12. package/dist/index.d.ts +5336 -4033
  13. package/dist/index.js +17020 -14055
  14. package/dist/{types-DpUO16pj.d.cts → types-C3fE3R9x.d.cts} +280 -112
  15. package/dist/{types-DpUO16pj.d.ts → types-C3fE3R9x.d.ts} +280 -112
  16. package/dist.bundle/index.cjs +34933 -0
  17. package/package.json +3 -3
  18. package/src/__tests__/agent-opts-resolver-schema-prompt.test.ts +0 -1
  19. package/src/__tests__/append-system-prompt-assembly.test.ts +8 -7
  20. package/src/__tests__/fr4-get-state-handshake.test.ts +2 -2
  21. package/src/__tests__/m2-append-content-probe.test.ts +0 -1
  22. package/src/__tests__/manifest-store.test.ts +10 -9
  23. package/src/__tests__/record-store-cache.test.ts +0 -2
  24. package/src/__tests__/record-store-index.test.ts +1 -2
  25. package/src/__tests__/review-fix-loop-script.test.ts +4 -2
  26. package/src/__tests__/review-fix-loop-utils.test.ts +10 -10
  27. package/src/__tests__/robustness-low-batch1.test.ts +6 -5
  28. package/src/__tests__/robustness-medium-batch1.test.ts +2 -2
  29. package/src/__tests__/robustness-medium-batch2.test.ts +17 -6
  30. package/src/__tests__/robustness-medium-batch4.test.ts +2 -2
  31. package/src/__tests__/session-runner.test.ts +1 -1
  32. package/src/core/__tests__/host-services.test.ts +2 -2
  33. package/src/core/__tests__/logger.test.ts +1 -1
  34. package/src/core/error-message.ts +9 -0
  35. package/src/core/host-services.ts +21 -5
  36. package/src/core/notify-ports.ts +18 -5
  37. package/src/execution/__tests__/agent-profile.test.ts +4 -4
  38. package/src/execution/__tests__/agent-registry.test.ts +370 -0
  39. package/src/execution/__tests__/agent-result-mapper.test.ts +18 -2
  40. package/src/execution/__tests__/agents-assembly.test.ts +2 -2
  41. package/src/execution/__tests__/alive-store.test.ts +1 -1
  42. package/src/execution/__tests__/ask-user-transit-e2e.test.ts +6 -6
  43. package/src/execution/__tests__/chat-engine-routing.test.ts +68 -33
  44. package/src/execution/__tests__/chatmode-first-round-closure-spawn.test.ts +4 -4
  45. package/src/execution/__tests__/cold-resurrect.test.ts +283 -0
  46. package/src/execution/__tests__/collect-budget.test.ts +291 -0
  47. package/src/execution/__tests__/collect-coordinator-service.test.ts +327 -0
  48. package/src/execution/__tests__/collect-coordinator.test.ts +371 -0
  49. package/src/execution/__tests__/collect-mixed-dispatch.test.ts +262 -0
  50. package/src/execution/__tests__/config-collect-sync.test.ts +120 -0
  51. package/src/execution/__tests__/config.test.ts +1 -1
  52. package/src/execution/__tests__/delivery-methods.test.ts +75 -62
  53. package/src/execution/__tests__/descendant-sweep-guards.test.ts +220 -0
  54. package/src/execution/__tests__/descendant-sweep.test.ts +6 -6
  55. package/src/execution/__tests__/dialog-queue.test.ts +2 -2
  56. package/src/execution/__tests__/engine-model-validation.test.ts +741 -0
  57. package/src/execution/__tests__/epipe-fallback.test.ts +29 -24
  58. package/src/execution/__tests__/execute-and-await-worktree.test.ts +21 -91
  59. package/src/execution/__tests__/execute-nesting.test.ts +34 -188
  60. package/src/execution/__tests__/execution-record.test.ts +217 -60
  61. package/src/execution/__tests__/execution-runtime-face.test.ts +5 -5
  62. package/src/execution/__tests__/explicit-agent-ref-guard.test.ts +4 -4
  63. package/src/execution/__tests__/finalize-record.test.ts +173 -17
  64. package/src/execution/__tests__/finalized-marker.test.ts +1 -1
  65. package/src/execution/__tests__/gc-timer.test.ts +56 -3
  66. package/src/execution/__tests__/get-record-for-action-restart.test.ts +12 -12
  67. package/src/execution/__tests__/get-state-handshake.test.ts +1 -1
  68. package/src/execution/__tests__/helpers/mock-extension-api.ts +1 -1
  69. package/src/execution/__tests__/helpers/session-runner-mocks.ts +113 -0
  70. package/src/execution/__tests__/helpers/spawn-mock.ts +150 -3
  71. package/src/execution/__tests__/helpers/subagent-service-mocks.ts +137 -0
  72. package/src/execution/__tests__/keep-alive-no-progress.test.ts +50 -148
  73. package/src/execution/__tests__/kill-all-escalation.test.ts +2 -2
  74. package/src/execution/__tests__/lifecycle-predicates.test.ts +1 -2
  75. package/src/execution/__tests__/manifest-parentid.test.ts +4 -4
  76. package/src/execution/__tests__/manifest-store-tmp-recovery.test.ts +1 -1
  77. package/src/execution/__tests__/max-turns-to-watchdog-ms.test.ts +1 -1
  78. package/src/execution/__tests__/model-resolver.test.ts +2 -2
  79. package/src/execution/__tests__/nested-visibility-env-propagation.test.ts +23 -121
  80. package/src/execution/__tests__/nested-visibility.test.ts +2 -0
  81. package/src/execution/__tests__/notify-batch.test.ts +500 -0
  82. package/src/execution/__tests__/notify-ledger.test.ts +1000 -18
  83. package/src/execution/__tests__/output-collector.test.ts +117 -6
  84. package/src/execution/__tests__/pi-invocation.test.ts +36 -4
  85. package/src/execution/__tests__/record-entry-collect.test.ts +102 -0
  86. package/src/execution/__tests__/record-store.test.ts +10 -9
  87. package/src/execution/__tests__/records-cwd-isolation.test.ts +2 -2
  88. package/src/execution/__tests__/recursive-visibility-baseline.test.ts +29 -132
  89. package/src/execution/__tests__/recursive-visibility-env.test.ts +55 -179
  90. package/src/execution/__tests__/relay-env.test.ts +12 -1
  91. package/src/execution/__tests__/rpc-mode.test.ts +2 -2
  92. package/src/execution/__tests__/run-and-finalize-anchoring.test.ts +387 -0
  93. package/src/execution/__tests__/run-and-finalize-chatmode.test.ts +15 -9
  94. package/src/execution/__tests__/run-spawn-chatmode-settled.test.ts +4 -4
  95. package/src/execution/__tests__/run-spawn-edges.test.ts +17 -15
  96. package/src/execution/__tests__/run-spawn-integration.test.ts +2 -2
  97. package/src/execution/__tests__/run-spawn-resume.test.ts +2 -2
  98. package/src/execution/__tests__/run-spawn-rpc-mode.test.ts +2 -2
  99. package/src/execution/__tests__/run-spawn-stdout-callback-throw.test.ts +4 -4
  100. package/src/execution/__tests__/service-kill-escalation.test.ts +7 -5
  101. package/src/execution/__tests__/session-context-resolver.test.ts +0 -2
  102. package/src/execution/__tests__/session-file-gc.test.ts +36 -1
  103. package/src/execution/__tests__/session-pending.test.ts +257 -14
  104. package/src/execution/__tests__/session-reconstructor.test.ts +366 -15
  105. package/src/execution/__tests__/session-runner-branch-cache-lru.test.ts +1 -1
  106. package/src/execution/__tests__/session-runner-close-prune.test.ts +2 -2
  107. package/src/execution/__tests__/session-runner-dispatch.test.ts +489 -0
  108. package/src/execution/__tests__/session-runner-epipe.test.ts +3 -3
  109. package/src/execution/__tests__/session-runner-heartbeat-idle-fallback.test.ts +5 -4
  110. package/src/execution/__tests__/session-runner-lifecycle-helpers.test.ts +290 -0
  111. package/src/execution/__tests__/session-runner-schema-env.test.ts +7 -5
  112. package/src/execution/__tests__/settled-watchdog.test.ts +282 -47
  113. package/src/execution/__tests__/spawn-args.test.ts +11 -10
  114. package/src/execution/__tests__/spawn-event-adapter-rpc.test.ts +26 -23
  115. package/src/execution/__tests__/spawn-event-adapter.test.ts +3 -3
  116. package/src/execution/__tests__/spawn-worktree-guidance.test.ts +5 -4
  117. package/src/execution/__tests__/spawned-children.test.ts +2 -1
  118. package/src/execution/__tests__/start-collect-guard.test.ts +255 -0
  119. package/src/execution/__tests__/start-sync-model-guard.test.ts +5 -5
  120. package/src/execution/__tests__/stdin-writer.test.ts +6 -4
  121. package/src/execution/__tests__/stream-sink-retirement.test.ts +6 -6
  122. package/src/execution/__tests__/subagent-actions-core.test.ts +48 -22
  123. package/src/execution/__tests__/subagent-service-message-close.test.ts +29 -26
  124. package/src/execution/__tests__/subagent-service-multiproc-guard.test.ts +21 -8
  125. package/src/execution/__tests__/subagent-service-notify-gate.test.ts +27 -22
  126. package/src/execution/__tests__/subagent-service-parent-guard.test.ts +30 -29
  127. package/src/execution/__tests__/subagent-service-recovery-bounds.test.ts +45 -20
  128. package/src/execution/__tests__/subagent-service.test.ts +37 -30
  129. package/src/execution/__tests__/subprocess-agent-runner-routing.test.ts +88 -12
  130. package/src/execution/__tests__/subprocess-agent-runner-timeout.test.ts +75 -0
  131. package/src/execution/__tests__/subprocess-agent-runner.test.ts +22 -20
  132. package/src/execution/__tests__/sync-collect-recovery.test.ts +1117 -0
  133. package/src/execution/__tests__/temp-prompt.test.ts +1 -1
  134. package/src/execution/__tests__/timeout-integration.test.ts +6 -5
  135. package/src/execution/__tests__/tombstone-store.test.ts +1 -1
  136. package/src/execution/__tests__/turn-limiter-semantics.test.ts +1 -1
  137. package/src/execution/__tests__/turn-limiter.test.ts +1 -1
  138. package/src/execution/__tests__/ui-request-handler-factory.test.ts +12 -6
  139. package/src/execution/__tests__/ui-request-handler.test.ts +4 -3
  140. package/src/execution/__tests__/ui-request-queue.test.ts +142 -2
  141. package/src/execution/__tests__/worktree-git-ops.test.ts +1 -1
  142. package/src/execution/__tests__/worktree-manager.test.ts +14 -5
  143. package/src/execution/__tests__/worktree-pid-registration.integration.test.ts +4 -3
  144. package/src/execution/__tests__/worktree-reconcile-aging.test.ts +2 -2
  145. package/src/execution/__tests__/worktree-reconcile.integration.test.ts +1 -1
  146. package/src/execution/__tests__/worktree-registry.test.ts +1 -1
  147. package/src/execution/agent-registry.ts +74 -30
  148. package/src/execution/agent-result-mapper.ts +3 -0
  149. package/src/execution/cold-resurrect.ts +199 -0
  150. package/src/execution/collect-coordinator.ts +200 -0
  151. package/src/execution/config.ts +77 -5
  152. package/src/execution/engine/__tests__/common/capability-gate.test.ts +91 -0
  153. package/src/execution/engine/__tests__/common/data-dir.test.ts +1 -1
  154. package/src/execution/engine/__tests__/common/event-journal.test.ts +1 -1
  155. package/src/execution/engine/__tests__/common/journal-wiring.test.ts +84 -0
  156. package/src/execution/engine/__tests__/common/kill-chain.test.ts +34 -7
  157. package/src/execution/engine/__tests__/common/persona-router.test.ts +4 -5
  158. package/src/execution/engine/__tests__/common/pool-manager.test.ts +213 -53
  159. package/src/execution/engine/__tests__/common/session-view-service-zcode-dbpath.test.ts +149 -0
  160. package/src/execution/engine/__tests__/common/session-view-service.test.ts +499 -0
  161. package/src/execution/engine/__tests__/conformance/contract.abort.test.ts +22 -112
  162. package/src/execution/engine/__tests__/conformance/contract.agent-events.test.ts +15 -28
  163. package/src/execution/engine/__tests__/conformance/contract.read-degradation.test.ts +1 -1
  164. package/src/execution/engine/__tests__/conformance/engine-conformance.live.test.ts +12 -12
  165. package/src/execution/engine/__tests__/conformance/golden-replay.pi.test.ts +2 -2
  166. package/src/execution/engine/__tests__/conformance/golden-replay.zcode.test.ts +21 -82
  167. package/src/execution/engine/__tests__/conformance/zcode-appserver-harness.ts +4 -7
  168. package/src/execution/engine/__tests__/engine-discovery.test.ts +15 -3
  169. package/src/execution/engine/__tests__/model-prompt.test.ts +15 -3
  170. package/src/execution/engine/__tests__/registry.test.ts +4 -2
  171. package/src/execution/engine/__tests__/routing.test.ts +115 -6
  172. package/src/execution/engine/common/capability-gate.ts +92 -0
  173. package/src/execution/engine/common/journal-wiring.ts +97 -0
  174. package/src/execution/engine/common/kill-chain.ts +42 -10
  175. package/src/execution/engine/common/nesting-guard.ts +66 -0
  176. package/src/execution/engine/common/persona-router.ts +18 -8
  177. package/src/execution/engine/common/pool-manager.ts +332 -78
  178. package/src/execution/engine/common/session-view-service.ts +506 -0
  179. package/src/execution/engine/common/session-view-types.ts +125 -0
  180. package/src/execution/engine/engines/pi/__tests__/pi-engine.test.ts +174 -28
  181. package/src/execution/engine/engines/pi/__tests__/spawn-opts-direct.test.ts +257 -0
  182. package/src/execution/{argv-mirror.ts → engine/engines/pi/argv-mirror.ts} +43 -21
  183. package/src/execution/{get-state-handshake.ts → engine/engines/pi/get-state-handshake.ts} +1 -1
  184. package/src/execution/{output-collector.ts → engine/engines/pi/output-collector.ts} +108 -19
  185. package/src/execution/engine/engines/pi/pi-engine.ts +434 -38
  186. package/src/execution/{pi-invocation.ts → engine/engines/pi/pi-invocation.ts} +2 -2
  187. package/src/execution/engine/engines/pi/reader.ts +11 -0
  188. package/src/execution/engine/engines/pi/registration.ts +4 -2
  189. package/src/execution/{session-runner.ts → engine/engines/pi/session-runner.ts} +617 -412
  190. package/src/execution/{spawn-event-adapter.ts → engine/engines/pi/spawn-event-adapter.ts} +75 -34
  191. package/src/execution/{stdin-writer.ts → engine/engines/pi/stdin-writer.ts} +10 -9
  192. package/src/execution/{temp-prompt.ts → engine/engines/pi/temp-prompt.ts} +2 -2
  193. package/src/execution/{turn-limiter.ts → engine/engines/pi/turn-limiter.ts} +1 -1
  194. package/src/execution/engine/engines/zcode/__tests__/__fixtures__/fake-appserver.mjs +54 -27
  195. package/src/execution/engine/engines/zcode/__tests__/appserver-launcher.test.ts +321 -0
  196. package/src/execution/engine/engines/zcode/__tests__/connection.test.ts +13 -12
  197. package/src/execution/engine/engines/zcode/__tests__/parser.test.ts +7 -210
  198. package/src/execution/engine/engines/zcode/__tests__/preparer.test.ts +6 -110
  199. package/src/execution/engine/engines/zcode/__tests__/session-channel-dispose-harvest.test.ts +247 -0
  200. package/src/execution/engine/engines/zcode/__tests__/session-channel-turn-timers.test.ts +451 -0
  201. package/src/execution/engine/engines/zcode/__tests__/session-channel.test.ts +20 -8
  202. package/src/execution/engine/engines/zcode/__tests__/zcode-engine-appserver.test.ts +77 -110
  203. package/src/execution/engine/engines/zcode/__tests__/zcode-engine-degrade.test.ts +26 -320
  204. package/src/execution/engine/engines/zcode/__tests__/zcode-engine-dispose.test.ts +210 -0
  205. package/src/execution/engine/engines/zcode/__tests__/zcode-engine-retry.test.ts +353 -0
  206. package/src/execution/engine/engines/zcode/__tests__/zcode-engine-status.test.ts +282 -0
  207. package/src/execution/engine/engines/zcode/__tests__/zcode-engine-timeout.test.ts +372 -0
  208. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.live.test.ts +48 -148
  209. package/src/execution/engine/engines/zcode/appserver-launcher.ts +167 -0
  210. package/src/execution/engine/engines/zcode/connection.ts +24 -11
  211. package/src/execution/engine/engines/zcode/constants.ts +75 -71
  212. package/src/execution/engine/engines/zcode/golden-sample.ts +8 -46
  213. package/src/execution/engine/engines/zcode/parser.ts +12 -346
  214. package/src/execution/engine/engines/zcode/preparer.ts +12 -143
  215. package/src/execution/engine/engines/zcode/session-channel.ts +351 -39
  216. package/src/execution/engine/engines/zcode/zcode-engine.ts +665 -760
  217. package/src/execution/engine/host-task-spec.ts +32 -36
  218. package/src/execution/engine/model-validation.ts +177 -0
  219. package/src/execution/engine/port.ts +24 -6
  220. package/src/execution/engine/routing.ts +75 -1
  221. package/src/execution/engine/types.ts +30 -103
  222. package/src/execution/execution-record.ts +229 -144
  223. package/src/execution/finalize-record.ts +141 -99
  224. package/src/execution/idle-gc.ts +28 -0
  225. package/src/execution/lifecycle-predicates.ts +1 -1
  226. package/src/execution/notifier.ts +234 -25
  227. package/src/execution/notify-host.ts +232 -0
  228. package/src/execution/record-entry.ts +16 -0
  229. package/src/execution/record-store.ts +280 -103
  230. package/src/execution/round-settlement.ts +93 -0
  231. package/src/execution/session-file-gc.ts +96 -62
  232. package/src/execution/session-reconstructor.ts +256 -143
  233. package/src/execution/sessions-index.ts +117 -47
  234. package/src/execution/settled-watchdog.ts +264 -52
  235. package/src/execution/subagent-actions-core.ts +84 -28
  236. package/src/execution/subagent-service.ts +1225 -964
  237. package/src/execution/subprocess-agent-runner.ts +144 -97
  238. package/src/execution/sync-rebuild.ts +87 -0
  239. package/src/execution/types.ts +72 -0
  240. package/src/execution/ui-request-handler-factory.ts +102 -74
  241. package/src/execution/ui-request-queue.ts +50 -19
  242. package/src/index.ts +442 -316
  243. package/src/orchestration/__tests__/agent-call-catch-fallback.test.ts +1 -1
  244. package/src/orchestration/__tests__/agent-call-stream.test.ts +2 -2
  245. package/src/orchestration/__tests__/args-validator.test.ts +14 -0
  246. package/src/orchestration/__tests__/config-loader.test.ts +1 -1
  247. package/src/orchestration/__tests__/error-recovery-rebuild-failure.test.ts +1 -1
  248. package/src/orchestration/__tests__/error-recovery-terminal-hardening.test.ts +11 -9
  249. package/src/orchestration/__tests__/execute-agent-call.test.ts +151 -11
  250. package/src/orchestration/__tests__/file-run-store-prune.test.ts +1 -1
  251. package/src/orchestration/__tests__/file-run-store-throttle.test.ts +1 -1
  252. package/src/orchestration/__tests__/file-run-store.test.ts +7 -6
  253. package/src/orchestration/__tests__/launcher-nested-workflow.test.ts +2 -2
  254. package/src/orchestration/__tests__/lifecycle-abort-broadcast-signal.test.ts +1 -1
  255. package/src/orchestration/__tests__/lifecycle-runid-injection.test.ts +3 -3
  256. package/src/orchestration/__tests__/lifecycle.test.ts +7 -5
  257. package/src/orchestration/__tests__/non-cloneable-return-e2e.test.ts +1 -1
  258. package/src/orchestration/__tests__/review-fix-loop-scriptpath-failfast.test.ts +1 -1
  259. package/src/orchestration/__tests__/run-snapshot.test.ts +8 -5
  260. package/src/orchestration/__tests__/script-generate.test.ts +5 -5
  261. package/src/orchestration/__tests__/script-lint.test.ts +17 -0
  262. package/src/orchestration/__tests__/skill-discovery.test.ts +2 -2
  263. package/src/orchestration/__tests__/test-mocks.ts +2 -0
  264. package/src/orchestration/__tests__/worker-exit-without-result.test.ts +7 -6
  265. package/src/orchestration/__tests__/worker-message-pump-finalize-run.test.ts +229 -0
  266. package/src/orchestration/__tests__/{error-recovery-handlers.test.ts → worker-message-pump-handlers.test.ts} +27 -19
  267. package/src/orchestration/__tests__/{error-recovery-postmessage-defense.test.ts → worker-message-pump-postmessage-defense.test.ts} +8 -8
  268. package/src/orchestration/__tests__/{error-recovery-serialize-failed-result.test.ts → worker-message-pump-serialize-failed-result.test.ts} +2 -2
  269. package/src/orchestration/__tests__/{error-recovery-workflow-call.test.ts → worker-message-pump-workflow-call.test.ts} +1 -1
  270. package/src/orchestration/__tests__/worker-pending-timeout-abort.test.ts +1 -1
  271. package/src/orchestration/__tests__/worker-script-builder.test.ts +1 -1
  272. package/src/orchestration/__tests__/workflow-files.test.ts +10 -10
  273. package/src/orchestration/__tests__/workflow-nesting-e2e.test.ts +1 -1
  274. package/src/orchestration/__tests__/workflow-script-registry-impl.test.ts +1 -1
  275. package/src/orchestration/agent-opts-resolver.ts +1 -1
  276. package/src/orchestration/args-validator.ts +53 -31
  277. package/src/orchestration/execute-agent-call.ts +19 -73
  278. package/src/orchestration/launcher.ts +128 -81
  279. package/src/orchestration/lifecycle.ts +43 -45
  280. package/src/orchestration/models/ports.ts +4 -4
  281. package/src/orchestration/models/run-runtime.ts +2 -2
  282. package/src/orchestration/models/trace.ts +1 -1
  283. package/src/orchestration/models/types.ts +111 -22
  284. package/src/orchestration/models/workflow-run.ts +1 -1
  285. package/src/orchestration/script-lint.ts +91 -58
  286. package/src/orchestration/{error-recovery.ts → worker-message-pump.ts} +157 -150
  287. package/src/shared/__tests__/atomic-write.test.ts +1 -1
  288. package/src/shared/__tests__/meta-parser.test.ts +151 -0
  289. package/src/shared/__tests__/resource-discovery-host-roots.test.ts +5 -5
  290. package/src/shared/__tests__/resource-discovery.test.ts +258 -215
  291. package/src/shared/atomic-write.ts +12 -9
  292. package/src/shared/meta-parser.ts +158 -84
  293. package/src/shared/model-ref.ts +15 -2
  294. package/src/shared/resource-discovery.ts +9 -183
  295. package/src/shared/schema-jsonify.ts +1 -1
  296. package/workflows/review-fix-loop-utils.cjs +151 -89
  297. package/workflows/review-fix-loop-utils.d.cts +287 -0
  298. package/src/execution/__tests__/execute-options-mapper.test.ts +0 -200
  299. package/src/execution/engine/engines/pi/__tests__/task-spec-mapper.test.ts +0 -164
  300. package/src/execution/engine/engines/pi/task-spec-mapper.ts +0 -100
  301. package/src/execution/engine/engines/zcode/__tests__/__fixtures__/zcode-golden-spawn.json +0 -39
  302. package/src/execution/engine/engines/zcode/__tests__/launcher.test.ts +0 -150
  303. package/src/execution/engine/engines/zcode/__tests__/preparer-appserver.test.ts +0 -387
  304. package/src/execution/engine/engines/zcode/__tests__/zcode-engine.test.ts +0 -710
  305. package/src/execution/engine/engines/zcode/appserver-home.ts +0 -442
  306. package/src/execution/engine/engines/zcode/appserver-probe.ts +0 -141
  307. package/src/execution/engine/engines/zcode/launcher.ts +0 -161
  308. package/src/execution/execute-options-mapper.ts +0 -115
  309. package/src/shared/__tests__/resource-discovery-manifest-cache.test.ts +0 -288
@@ -13,10 +13,16 @@ import * as path from "node:path";
13
13
 
14
14
  import { afterEach, beforeEach, describe, expect, it } from "vitest";
15
15
 
16
- import { IDENTITY_CUSTOM_TYPE, reconstructFromFile } from "../session-reconstructor.ts";
16
+ import {
17
+ IDENTITY_CUSTOM_TYPE,
18
+ readIdentityAnywhere,
19
+ readIdentityHeader,
20
+ readIdentityTail,
21
+ reconstructFromFile,
22
+ } from "../session-reconstructor.ts";
17
23
 
18
24
  /** 写一行到文件(JSON.stringify + 换行)。 */
19
- function writeLine(file: number | fs.PathOrFileDescriptor, obj: unknown): void {
25
+ function writeLine(file: number, obj: unknown): void {
20
26
  fs.writeSync(file, `${JSON.stringify(obj)}\n`);
21
27
  }
22
28
 
@@ -77,7 +83,7 @@ describe("reconstructFromFile", () => {
77
83
  filePath = path.join(tmpDir, "test.jsonl");
78
84
  });
79
85
  afterEach(() => {
80
- fs.rmSync(tmpDir, { recursive: true, force: true });
86
+ fs.rmSync(tmpDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 20 });
81
87
  });
82
88
 
83
89
  function writeJsonl(lines: unknown[]): void {
@@ -113,7 +119,7 @@ describe("reconstructFromFile", () => {
113
119
  it("thinking block 累积进 turn.thinking", () => {
114
120
  writeJsonl([
115
121
  headerLine(),
116
- identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }),
122
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
117
123
  assistantEntry([
118
124
  { type: "thinking", thinking: "let me think" },
119
125
  { type: "text", text: "answer" },
@@ -127,7 +133,7 @@ describe("reconstructFromFile", () => {
127
133
  it("多 assistant message → 多 turn,result 用空行拼接", () => {
128
134
  writeJsonl([
129
135
  headerLine(),
130
- identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }),
136
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
131
137
  assistantEntry([{ type: "text", text: "first" }], { ts: 1000 }),
132
138
  assistantEntry([{ type: "text", text: "second" }], { ts: 2000, parentId: undefined }),
133
139
  ]);
@@ -190,7 +196,7 @@ describe("reconstructFromFile", () => {
190
196
  it("读出 identity 里的 parentRecordId/depth(递归层级)", () => {
191
197
  writeJsonl([
192
198
  headerLine(),
193
- identityEntry({ id: "run-2", agent: "w", mode: "sync", task: "t", startedAt: 100, rootSessionId: "sess-A", parentRecordId: "run-1", depth: 2 }),
199
+ identityEntry({ id: "run-2", agent: "w", mode: "background", task: "t", startedAt: 100, rootSessionId: "sess-A", parentRecordId: "run-1", depth: 2 }),
194
200
  assistantEntry([{ type: "text", text: "ok" }]),
195
201
  ]);
196
202
  const rec = reconstructFromFile(filePath);
@@ -228,7 +234,7 @@ describe("reconstructFromFile", () => {
228
234
  it("toolCall + toolResult → InternalToolCall done", () => {
229
235
  writeJsonl([
230
236
  headerLine(),
231
- identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }),
237
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
232
238
  assistantEntry([
233
239
  { type: "toolCall", id: "call-1", name: "read", arguments: { path: "/x.ts" } },
234
240
  ]),
@@ -245,7 +251,7 @@ describe("reconstructFromFile", () => {
245
251
  it("toolResult isError → InternalToolCall failed", () => {
246
252
  writeJsonl([
247
253
  headerLine(),
248
- identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }),
254
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
249
255
  assistantEntry([
250
256
  { type: "toolCall", id: "call-1", name: "bash", arguments: { command: "false" } },
251
257
  ]),
@@ -259,7 +265,7 @@ describe("reconstructFromFile", () => {
259
265
  it("孤儿 toolResult(无匹配 toolCall)→ 丢弃,不崩", () => {
260
266
  writeJsonl([
261
267
  headerLine(),
262
- identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }),
268
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
263
269
  assistantEntry([{ type: "text", text: "ok" }]),
264
270
  toolResultEntry("nonexistent", "read"),
265
271
  ]);
@@ -276,7 +282,7 @@ describe("reconstructFromFile", () => {
276
282
  it("stopReason=error → lastError + error 字段", () => {
277
283
  writeJsonl([
278
284
  headerLine(),
279
- identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }),
285
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
280
286
  assistantEntry([{ type: "text", text: "partial" }], {
281
287
  stopReason: "error", errorMessage: "API timeout",
282
288
  }),
@@ -290,7 +296,7 @@ describe("reconstructFromFile", () => {
290
296
  it("stopReason=aborted 无 errorMessage → lastError = 'aborted'", () => {
291
297
  writeJsonl([
292
298
  headerLine(),
293
- identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }),
299
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
294
300
  assistantEntry([{ type: "text", text: "" }], { stopReason: "aborted" }),
295
301
  ]);
296
302
  const rec = reconstructFromFile(filePath);
@@ -301,7 +307,7 @@ describe("reconstructFromFile", () => {
301
307
  it("前序 error 但最后 stop → lastError 清除(镜像 turn_end 语义),status=done", () => {
302
308
  writeJsonl([
303
309
  headerLine(),
304
- identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }),
310
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
305
311
  assistantEntry([{ type: "text", text: "oops" }], {
306
312
  stopReason: "error", errorMessage: "transient", ts: 1000,
307
313
  }),
@@ -321,7 +327,7 @@ describe("reconstructFromFile", () => {
321
327
  it("tool_start + tool_end + turn_end 条目", () => {
322
328
  writeJsonl([
323
329
  headerLine(),
324
- identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }),
330
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
325
331
  assistantEntry([
326
332
  { type: "toolCall", id: "c1", name: "read", arguments: { path: "/x.ts" } },
327
333
  ]),
@@ -359,7 +365,7 @@ describe("reconstructFromFile", () => {
359
365
  it("有 identity 但无 assistant message → undefined", () => {
360
366
  writeJsonl([
361
367
  headerLine(),
362
- identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }),
368
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
363
369
  ]);
364
370
  expect(reconstructFromFile(filePath)).toBeUndefined();
365
371
  });
@@ -368,7 +374,7 @@ describe("reconstructFromFile", () => {
368
374
  const fd = fs.openSync(filePath, "w");
369
375
  fs.writeSync(fd, `${JSON.stringify(headerLine())}\n`);
370
376
  fs.writeSync(fd, "THIS IS NOT JSON\n");
371
- fs.writeSync(fd, `${JSON.stringify(identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }))}\n`);
377
+ fs.writeSync(fd, `${JSON.stringify(identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }))}\n`);
372
378
  fs.writeSync(fd, `${JSON.stringify(assistantEntry([{ type: "text", text: "survived" }]))}\n`);
373
379
  fs.closeSync(fd);
374
380
  const rec = reconstructFromFile(filePath);
@@ -376,4 +382,349 @@ describe("reconstructFromFile", () => {
376
382
  expect(rec!.result).toBe("survived");
377
383
  });
378
384
  });
385
+
386
+ // ============================================================
387
+ // 分支覆盖补充(特征锚定,守护行为保持重构)
388
+ // ============================================================
389
+ describe("分支覆盖补充(特征锚定)", () => {
390
+ it("无 session header(第 1 行非 header)→ 该行仍按普通 entry 解析,正常重建", () => {
391
+ writeJsonl([
392
+ identityEntry({ id: "r1", agent: "w", mode: "sync", task: "t", startedAt: 100 }),
393
+ assistantEntry([{ type: "text", text: "no header" }]),
394
+ ]);
395
+ const rec = reconstructFromFile(filePath);
396
+ expect(rec).toBeDefined();
397
+ expect(rec!.result).toBe("no header");
398
+ });
399
+
400
+ it("首行(header 位)损坏 JSON → 跳过该行,后续行仍解析", () => {
401
+ const fd = fs.openSync(filePath, "w");
402
+ fs.writeSync(fd, "CORRUPTED FIRST LINE\n");
403
+ fs.writeSync(fd, `${JSON.stringify(identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }))}\n`);
404
+ fs.writeSync(fd, `${JSON.stringify(assistantEntry([{ type: "text", text: "after corrupt header" }]))}\n`);
405
+ fs.closeSync(fd);
406
+ const rec = reconstructFromFile(filePath);
407
+ expect(rec).toBeDefined();
408
+ expect(rec!.result).toBe("after corrupt header");
409
+ });
410
+
411
+ it("文件只有空白行 → undefined(entries 为空)", () => {
412
+ fs.writeFileSync(filePath, "\n\n \n", "utf-8");
413
+ expect(reconstructFromFile(filePath)).toBeUndefined();
414
+ });
415
+
416
+ it("identity custom entry 的 data 非法(缺 task)→ undefined", () => {
417
+ writeJsonl([
418
+ headerLine(),
419
+ identityEntry({ id: "r1", agent: "w", mode: "background", startedAt: 100 }), // 缺 task
420
+ assistantEntry([{ type: "text", text: "orphan identity" }]),
421
+ ]);
422
+ expect(reconstructFromFile(filePath)).toBeUndefined();
423
+ });
424
+
425
+ it("model_change → model = provider/modelId(多次出现时后写覆盖)", () => {
426
+ writeJsonl([
427
+ headerLine(),
428
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
429
+ { type: "model_change", provider: "p1", modelId: "m1", timestamp: new Date(500).toISOString() },
430
+ assistantEntry([{ type: "text", text: "first" }], { ts: 1000 }),
431
+ { type: "model_change", provider: "p2", modelId: "m2", timestamp: new Date(1500).toISOString() },
432
+ assistantEntry([{ type: "text", text: "second" }], { ts: 2000 }),
433
+ ]);
434
+ const rec = reconstructFromFile(filePath);
435
+ expect(rec!.model).toBe("p2/m2");
436
+ });
437
+
438
+ it("model_change 字段非字符串(provider 缺失)→ model 保持空串", () => {
439
+ writeJsonl([
440
+ headerLine(),
441
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
442
+ { type: "model_change", provider: 42, modelId: "m1", timestamp: new Date(500).toISOString() },
443
+ assistantEntry([{ type: "text", text: "ok" }]),
444
+ ]);
445
+ const rec = reconstructFromFile(filePath);
446
+ expect(rec!.model).toBe("");
447
+ });
448
+
449
+ it("thinking_level_change → thinkingLevel 恢复;无该 entry → undefined", () => {
450
+ writeJsonl([
451
+ headerLine(),
452
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
453
+ { type: "thinking_level_change", thinkingLevel: "high", timestamp: new Date(500).toISOString() },
454
+ assistantEntry([{ type: "text", text: "ok" }]),
455
+ ]);
456
+ const withLevel = reconstructFromFile(filePath);
457
+ expect(withLevel!.thinkingLevel).toBe("high");
458
+
459
+ writeJsonl([
460
+ headerLine(),
461
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
462
+ assistantEntry([{ type: "text", text: "ok" }]),
463
+ ]);
464
+ const withoutLevel = reconstructFromFile(filePath);
465
+ expect(withoutLevel!.thinkingLevel).toBeUndefined();
466
+ });
467
+
468
+ it("entry.timestamp 非法(Date.parse NaN)→ endedAt 回落 message.timestamp", () => {
469
+ writeJsonl([
470
+ headerLine(),
471
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
472
+ { ...(assistantEntry([{ type: "text", text: "bad ts" }], { ts: 7777 }) as Record<string, unknown>), timestamp: "not-a-date" },
473
+ ]);
474
+ const rec = reconstructFromFile(filePath);
475
+ expect(rec!.endedAt).toBe(7777);
476
+ });
477
+
478
+ it("assistant message 无 content(非数组)→ 空 turn,usage 与 stopReason 均被跳过", () => {
479
+ writeJsonl([
480
+ headerLine(),
481
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
482
+ {
483
+ type: "message",
484
+ timestamp: new Date(3000).toISOString(),
485
+ message: {
486
+ role: "assistant",
487
+ content: "not-an-array",
488
+ usage: { input: 100, output: 100 },
489
+ stopReason: "error",
490
+ errorMessage: "boom",
491
+ timestamp: 3000,
492
+ },
493
+ },
494
+ ]);
495
+ const rec = reconstructFromFile(filePath);
496
+ // turn 在 content 校验前已创建 → record 存在
497
+ expect(rec).toBeDefined();
498
+ expect(rec!.turnCount).toBe(1);
499
+ expect(rec!.turns[0].text).toBe("");
500
+ expect(rec!.totalTokens).toBe(0); // usage 被 continue 跳过
501
+ expect(rec!.lastError).toBeUndefined(); // stopReason=error 也被跳过
502
+ expect(rec!.error).toBeUndefined();
503
+ expect(rec!.endedAt).toBe(3000);
504
+ });
505
+
506
+ it("assistant message content 合法但无 usage → totalTokens 0,正常重建", () => {
507
+ writeJsonl([
508
+ headerLine(),
509
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
510
+ {
511
+ type: "message",
512
+ timestamp: new Date(1000).toISOString(),
513
+ message: {
514
+ role: "assistant",
515
+ content: [{ type: "text", text: "no usage" }],
516
+ stopReason: "stop",
517
+ timestamp: 1000,
518
+ },
519
+ },
520
+ ]);
521
+ const rec = reconstructFromFile(filePath);
522
+ expect(rec!.result).toBe("no usage");
523
+ expect(rec!.totalTokens).toBe(0);
524
+ });
525
+
526
+ it("孤儿 toolCall(toolResult 未到达)→ toolCalls 空,turn_end label 兜底 'turn'", () => {
527
+ writeJsonl([
528
+ headerLine(),
529
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
530
+ assistantEntry([{ type: "toolCall", id: "c1", name: "read", arguments: { path: "/x" } }]),
531
+ ]);
532
+ const rec = reconstructFromFile(filePath);
533
+ expect(rec).toBeDefined();
534
+ expect(rec!.turns[0].toolCalls).toHaveLength(0);
535
+ const turnEnd = rec!.eventLog.find((e) => e.type === "turn_end");
536
+ expect(turnEnd?.label).toBe("turn"); // 空 text turn 的摘要兜底
537
+ });
538
+
539
+ it("stopReason 非 error/aborted/stop(如 length)→ lastError 保持前值不清除", () => {
540
+ writeJsonl([
541
+ headerLine(),
542
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
543
+ assistantEntry([{ type: "text", text: "oops" }], {
544
+ stopReason: "error", errorMessage: "transient", ts: 1000,
545
+ }),
546
+ assistantEntry([{ type: "text", text: "truncated" }], { stopReason: "length", ts: 2000 }),
547
+ ]);
548
+ const rec = reconstructFromFile(filePath);
549
+ expect(rec!.lastError).toBe("transient");
550
+ expect(rec!.error).toBe("transient");
551
+ });
552
+
553
+ it("toolResult 配对 → result.content/details 透传,startedTs 取 assistant timestamp", () => {
554
+ writeJsonl([
555
+ headerLine(),
556
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100 }),
557
+ assistantEntry([{ type: "toolCall", id: "c9", name: "bash", arguments: { command: "ls" } }]),
558
+ toolResultEntry("c9", "bash", { text: "file1\nfile2" }),
559
+ ]);
560
+ const rec = reconstructFromFile(filePath);
561
+ const tc = rec!.turns[0].toolCalls[0];
562
+ expect(tc.result).toEqual({ content: [{ type: "text", text: "file1\nfile2" }], details: undefined });
563
+ expect(tc.startedTs).toBe(1000);
564
+ });
565
+
566
+ it("identity 的 chatMode/worktree/forkDepth 经展开透传到 record", () => {
567
+ writeJsonl([
568
+ headerLine(),
569
+ identityEntry({ id: "r1", agent: "w", mode: "background", task: "t", startedAt: 100, chatMode: true, worktree: true, forkDepth: 2 }),
570
+ assistantEntry([{ type: "text", text: "ok" }]),
571
+ ]);
572
+ const rec = reconstructFromFile(filePath);
573
+ expect(rec!.chatMode).toBe(true);
574
+ expect(rec!.worktree).toBe(true);
575
+ expect(rec!.forkDepth).toBe(2);
576
+ });
577
+ });
578
+ });
579
+
580
+ // ============================================================
581
+ // 轻量 identity 扫描(readIdentityHeader / readIdentityTail / readIdentityAnywhere)
582
+ // ============================================================
583
+ // 直测三入口(parseIdentityFromText 的宿主):头/尾窗口命中、预筛、从后往前、
584
+ // 归一化 fallback、损坏行跳过。
585
+ describe("轻量 identity 扫描(readIdentityHeader / readIdentityTail / readIdentityAnywhere)", () => {
586
+ let tmpDir: string;
587
+ let filePath: string;
588
+
589
+ beforeEach(() => {
590
+ tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "sr-identity-scan-"));
591
+ filePath = path.join(tmpDir, "scan.jsonl");
592
+ });
593
+ afterEach(() => {
594
+ fs.rmSync(tmpDir, { recursive: true, force: true, maxRetries: 5, retryDelay: 20 });
595
+ });
596
+
597
+ /** 写原始文本行(不经 JSON.stringify——填充行/截断行构造用)。 */
598
+ function writeRaw(lines: string[]): void {
599
+ fs.writeFileSync(filePath, lines.map((l) => `${l}\n`).join(""), "utf-8");
600
+ }
601
+
602
+ /** >64KB 的无特征填充行(预筛跳过,永不被 JSON.parse)。 */
603
+ const fillerLine = "F".repeat(70 * 1024);
604
+
605
+ it("identity 在头部 → 读出身份 + identity 之前途经的 model/thinkingLevel", () => {
606
+ writeRaw([
607
+ JSON.stringify(headerLine()),
608
+ JSON.stringify({ type: "model_change", provider: "p1", modelId: "m1", timestamp: new Date(500).toISOString() }),
609
+ JSON.stringify({ type: "thinking_level_change", thinkingLevel: "high", timestamp: new Date(600).toISOString() }),
610
+ JSON.stringify(identityEntry({
611
+ id: "bg-9", agent: "worker", mode: "sync", task: "scan", startedAt: 42,
612
+ slug: "s9", rootSessionId: "sess-R", depth: 1, forkDepth: 0,
613
+ })),
614
+ ]);
615
+ expect(readIdentityHeader(filePath)).toEqual({
616
+ id: "bg-9",
617
+ agent: "worker",
618
+ mode: "sync",
619
+ task: "scan",
620
+ slug: "s9",
621
+ startedAt: 42,
622
+ rootSessionId: "sess-R",
623
+ parentRecordId: undefined,
624
+ depth: 1,
625
+ forkDepth: 0,
626
+ chatMode: undefined,
627
+ worktree: undefined,
628
+ model: "p1/m1",
629
+ thinkingLevel: "high",
630
+ sessionFile: filePath,
631
+ });
632
+ });
633
+
634
+ it("identity 之后的 model_change 不捕获(找到即停)", () => {
635
+ writeRaw([
636
+ JSON.stringify(headerLine()),
637
+ JSON.stringify(identityEntry({ id: "bg-8", agent: "w", mode: "background", task: "t", startedAt: 1 })),
638
+ JSON.stringify({ type: "model_change", provider: "late", modelId: "m", timestamp: new Date(900).toISOString() }),
639
+ ]);
640
+ expect(readIdentityHeader(filePath)?.model).toBe("");
641
+ });
642
+
643
+ it("头部无 identity → readIdentityHeader undefined", () => {
644
+ writeRaw([JSON.stringify(headerLine()), JSON.stringify({ type: "model_change", provider: "p", modelId: "m" })]);
645
+ expect(readIdentityHeader(filePath)).toBeUndefined();
646
+ });
647
+
648
+ it("文件缺失 → 三入口均 undefined(不抛)", () => {
649
+ const missing = path.join(tmpDir, "nope.jsonl");
650
+ expect(readIdentityHeader(missing)).toBeUndefined();
651
+ expect(readIdentityTail(missing)).toBeUndefined();
652
+ expect(readIdentityAnywhere(missing)).toBeUndefined();
653
+ });
654
+
655
+ it("identity 仅在尾部(>64KB 填充)→ header miss / tail 命中 / anywhere 命中", () => {
656
+ writeRaw([
657
+ JSON.stringify(headerLine()),
658
+ fillerLine,
659
+ JSON.stringify(identityEntry({ id: "bg-tail", agent: "w", mode: "background", task: "t", startedAt: 7 })),
660
+ ]);
661
+ expect(readIdentityHeader(filePath)).toBeUndefined();
662
+ const tail = readIdentityTail(filePath);
663
+ expect(tail?.id).toBe("bg-tail");
664
+ // model/thinkingLevel 在尾部窗口外 → best-effort 空/undefined
665
+ expect(tail?.model).toBe("");
666
+ expect(tail?.thinkingLevel).toBeUndefined();
667
+ expect(readIdentityAnywhere(filePath)?.id).toBe("bg-tail");
668
+ });
669
+
670
+ it("尾部多轮 identity → tail/anywhere 从后往前取最后一条(最新鲜)", () => {
671
+ writeRaw([
672
+ JSON.stringify(headerLine()),
673
+ fillerLine,
674
+ JSON.stringify(identityEntry({ id: "bg-old", agent: "w", mode: "background", task: "t", startedAt: 1 })),
675
+ JSON.stringify(identityEntry({ id: "bg-new", agent: "w", mode: "background", task: "t2", startedAt: 2 })),
676
+ ]);
677
+ expect(readIdentityTail(filePath)?.id).toBe("bg-new");
678
+ expect(readIdentityAnywhere(filePath)?.id).toBe("bg-new");
679
+ });
680
+
681
+ it("尾部块首行残缺(含特征串的截断 JSON)→ 跳过该行,后续行仍命中", () => {
682
+ writeRaw([
683
+ JSON.stringify(headerLine()),
684
+ fillerLine,
685
+ '{"type":"custom","customType":"subagent-identity","data":{"id":"trunc"', // 截断行
686
+ JSON.stringify(identityEntry({ id: "bg-after-trunc", agent: "w", mode: "background", task: "t", startedAt: 3 })),
687
+ ]);
688
+ expect(readIdentityTail(filePath)?.id).toBe("bg-after-trunc");
689
+ });
690
+
691
+ it("旧 identity(parentSessionId、无 slug/depth)→ rootSessionId fallback + slug 兜底空串 + depth 0", () => {
692
+ writeRaw([
693
+ JSON.stringify(headerLine()),
694
+ JSON.stringify(identityEntry({ id: "bg-old", agent: "w", mode: "background", task: "t", startedAt: 1, parentSessionId: "sess-legacy" })),
695
+ ]);
696
+ expect(readIdentityHeader(filePath)).toMatchObject({
697
+ id: "bg-old",
698
+ slug: "",
699
+ rootSessionId: "sess-legacy",
700
+ depth: 0,
701
+ forkDepth: undefined,
702
+ });
703
+ });
704
+
705
+ it("identity 的 chatMode/worktree 透传到轻量 recon", () => {
706
+ writeRaw([
707
+ JSON.stringify(headerLine()),
708
+ JSON.stringify(identityEntry({ id: "bg-chat", agent: "w", mode: "background", task: "t", startedAt: 1, chatMode: true, worktree: true })),
709
+ ]);
710
+ expect(readIdentityHeader(filePath)).toMatchObject({ chatMode: true, worktree: true });
711
+ });
712
+
713
+ it("identity data 非法(缺 task)→ 各入口 undefined", () => {
714
+ writeRaw([
715
+ JSON.stringify(headerLine()),
716
+ JSON.stringify(identityEntry({ id: "bg-bad", agent: "w", mode: "background", startedAt: 1 })), // 缺 task
717
+ ]);
718
+ expect(readIdentityHeader(filePath)).toBeUndefined();
719
+ expect(readIdentityTail(filePath)).toBeUndefined();
720
+ expect(readIdentityAnywhere(filePath)).toBeUndefined();
721
+ });
722
+
723
+ it("损坏行(无特征串)预筛跳过,identity 行仍命中", () => {
724
+ writeRaw([
725
+ "THIS IS NOT JSON",
726
+ JSON.stringify(identityEntry({ id: "bg-prefilter", agent: "w", mode: "background", task: "t", startedAt: 5 })),
727
+ ]);
728
+ expect(readIdentityHeader(filePath)?.id).toBe("bg-prefilter");
729
+ });
379
730
  });
@@ -32,7 +32,7 @@ import {
32
32
  _getBranchCacheSizeForTest,
33
33
  _resetBranchCacheForTest,
34
34
  buildEnvBlock,
35
- } from "../session-runner.ts";
35
+ } from "../engine/engines/pi/session-runner.ts";
36
36
 
37
37
  /** execFile mock 回填 br-<cwd>(branch 与 cwd 一一对应,淘汰行为可断言)。 */
38
38
  function stubGitBranchSuccess(): void {
@@ -73,7 +73,7 @@ vi.mock("../alive-store.ts", () => ({
73
73
  writeAliveMarker: vi.fn(),
74
74
  }));
75
75
 
76
- vi.mock("../temp-prompt.ts", () => ({
76
+ vi.mock("../engine/engines/pi/temp-prompt.ts", () => ({
77
77
  writePromptToTempFile: vi.fn(async (agent: string) => {
78
78
  const safeName = agent.replace(/[^\w.-]+/g, "_");
79
79
  return { dir: `/tmp/fake-${safeName}`, filePath: `/tmp/fake-${safeName}/prompt-${safeName}.md` };
@@ -81,7 +81,7 @@ vi.mock("../temp-prompt.ts", () => ({
81
81
  cleanupTempPrompt: vi.fn(async () => {}),
82
82
  }));
83
83
 
84
- import { runSpawn } from "../session-runner.ts";
84
+ import { runSpawn } from "../engine/engines/pi/session-runner.ts";
85
85
  import { clearPendingCursors, listActivePendingFromSessionFile } from "../session-pending.ts";
86
86
  import {
87
87
  type FakeChild,