@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,169 +0,0 @@
1
- // src/execution/__tests__/format-schema-instruction.test.ts
2
- //
3
- // 锁定 formatSchemaInstruction 契约:构造 schema enforcement 的 MANDATORY 指令。
4
- // [审查项#2] 注入链变更:指令仅经 agent-opts-resolver 进 appendSystemPrompt
5
- // (ASP 单点),runSpawn 的 task + instruction 后缀拼接已删除——本测试随之改锁
6
- // resolver 导出的同名函数。一旦漏掉 "structured-output" 关键词或 JSON 序列化漂移,
7
- // schema 模式会静默失效——agent 可能直接把 JSON 写进文本响应。
8
- //
9
- // [审查项#4] 锁定 AP 告知句:注入侧校验用 additionalProperties:false 收窄后的
10
- // parameters,指令必须前置告知「schema 外字段被拒」,否则拒绝显得凭空。
11
- //
12
- // 纯函数测试:不依赖 Pi 运行时、不 spawn 进程、不 mock。只 import 被测函数。
13
- import { describe, expect, it } from "vitest";
14
-
15
- import { formatSchemaInstruction } from "../../orchestration/agent-opts-resolver.ts";
16
-
17
- describe("formatSchemaInstruction", () => {
18
- // ── 指令文本契约 ──────────────────────────────────────────────
19
-
20
- it("contains the structured-output tool keyword", () => {
21
- const out = formatSchemaInstruction({ type: "object" });
22
- expect(out).toContain("structured-output");
23
- });
24
-
25
- it("emits a MANDATORY structured-output directive (not free-form JSON)", () => {
26
- const out = formatSchemaInstruction({ type: "object" });
27
- expect(out).toContain("MANDATORY");
28
- expect(out).toContain("must be calling the `structured-output` tool");
29
- expect(out).toContain("Do NOT output JSON in your text response");
30
- });
31
-
32
- it("announces that fields outside the schema are rejected (AP 告知,审查项#4)", () => {
33
- const out = formatSchemaInstruction({ type: "object" });
34
- expect(out).toContain("Fields not defined in this schema are rejected");
35
- expect(out).toContain("do not add extra fields");
36
- });
37
-
38
- it("author-declared additionalProperties → weak wording (AP 条件化:声明时作者 schema 管辖额外字段)", () => {
39
- // D4 只在「未声明」时注入 false;作者显式声明 true 时额外字段实际放行——
40
- // 无条件「一律拒绝」强承诺与参数层行为不符,改用弱承诺措辞。
41
- const out = formatSchemaInstruction({ type: "object", additionalProperties: true });
42
- expect(out).not.toContain("Fields not defined in this schema are rejected");
43
- expect(out).toContain("follow this schema's own additionalProperties declaration");
44
- });
45
-
46
- // ── schema 序列化(compact:与 schemaEnv 复用同串,IF7 #13)───────
47
-
48
- it("embeds the schema as compact JSON inside a fenced block", () => {
49
- const schema: Record<string, unknown> = {
50
- type: "object",
51
- properties: { name: { type: "string" } },
52
- };
53
- const out = formatSchemaInstruction(schema);
54
- // 必须包含 JSON.stringify(schema) 的完整结果(compact,无缩进)
55
- expect(out).toContain(JSON.stringify(schema));
56
- expect(out).toContain("```json");
57
- expect(out).toContain("```");
58
- });
59
-
60
- it("locks the full output structure for a minimal schema", () => {
61
- const out = formatSchemaInstruction({ type: "object" });
62
- // 完整结构快照——任何指令措辞/顺序/序列化漂移都会被捕获。
63
- // [HISTORICAL] runner task 后缀双重注入删除后,本函数迁至 resolver 成为唯一
64
- // 文案源;JSON 从 pretty(indent=2)改为 compact(与 schemaEnv 同串复用)。
65
- expect(out).toBe(
66
- [
67
- "## MANDATORY: Structured Output Requirement",
68
- "",
69
- "This task requires structured output.",
70
- "Your FINAL action must be calling the `structured-output` tool.",
71
- "",
72
- "Your call arguments ARE the result data itself — the tool's parameter schema IS the required shape of your result.",
73
- "Your result must conform to this schema:",
74
- "```json",
75
- '{"type":"object"}',
76
- "```",
77
- "",
78
- "Rules:",
79
- "- Call the structured-output tool with your result data as its arguments. The system validates them against the schema above automatically.",
80
- "- Do NOT output JSON in your text response — use the structured-output tool.",
81
- "- Do NOT skip this step. The structured-output call IS your result.",
82
- "- Complete all other work FIRST, then call structured-output as the last action.",
83
- "- Fields not defined in this schema are rejected — do not add extra fields.",
84
- ].join("\n"),
85
- );
86
- });
87
-
88
- it("locks the single-parameter wording: arguments ARE the data coexists with the mandatory tool call", () => {
89
- const out = formatSchemaInstruction({ type: "object" });
90
- // 新口径双支柱必须共存:① 参数即数据(arguments ARE the data)② 必须调用工具
91
- expect(out).toContain("arguments ARE the result data itself");
92
- expect(out).toContain("parameter schema IS the required shape of your result");
93
- expect(out).toContain("must be calling the `structured-output` tool");
94
- // 旧双参数警告语义不得回流(工具已是单参数形态,警告失去对象)
95
- expect(out).not.toMatch(/do NOT pass a .schema. parameter/i);
96
- expect(out).not.toContain("ONLY the `data` parameter");
97
- expect(out).not.toContain("enforced by the system");
98
- });
99
-
100
- // ── 特殊字符转义(注入风险路径)──────────────────────────────
101
-
102
- it("escapes double quotes inside schema string values", () => {
103
- const schema: Record<string, unknown> = { prompt: 'say "hi"' };
104
- const out = formatSchemaInstruction(schema);
105
- // JSON.stringify 会把内层 " 转义为 \"
106
- expect(out).toContain('say \\"hi\\"');
107
- // 原始未转义形式(含成对字面双引号)绝不能回流进 JSON 体内
108
- expect(out).not.toContain('say "hi"');
109
- });
110
-
111
- it("escapes newlines inside schema string values", () => {
112
- const schema: Record<string, unknown> = { text: "line1\nline2" };
113
- const out = formatSchemaInstruction(schema);
114
- // 换行被序列化为字面反斜杠-n,不能是真实换行符
115
- expect(out).toContain("line1\\nline2");
116
- expect(out).not.toContain("line1\nline2");
117
- });
118
-
119
- it("escapes backslashes inside schema string values", () => {
120
- const schema: Record<string, unknown> = { path: "C:\\Users\\x" };
121
- const out = formatSchemaInstruction(schema);
122
- // 单反斜杠被序列化为 \\,避免后续解析误把转义序列当指令
123
- expect(out).toContain("C:\\\\Users\\\\x");
124
- expect(out).not.toContain("C:\\Users\\x");
125
- });
126
-
127
- // ── 边界值 ────────────────────────────────────────────────────
128
-
129
- it("handles empty schema object", () => {
130
- const out = formatSchemaInstruction({});
131
- expect(out).toContain("structured-output");
132
- expect(out).toContain("{}");
133
- });
134
-
135
- it("preserves null values in schema", () => {
136
- const schema: Record<string, unknown> = { default: null };
137
- const out = formatSchemaInstruction(schema);
138
- // JSON.stringify 对 null 保留字面 "null"(不会 omit 键,也不会变字符串)。
139
- // compact 序列化无空格:'"default":null'
140
- expect(out).toContain('"default":null');
141
- });
142
-
143
- it("serializes nested objects and arrays", () => {
144
- const schema: Record<string, unknown> = {
145
- type: "object",
146
- required: ["name", "age"],
147
- properties: {
148
- name: { type: "string" },
149
- age: { type: "integer", minimum: 0 },
150
- },
151
- };
152
- const out = formatSchemaInstruction(schema);
153
- expect(out).toContain(JSON.stringify(schema));
154
- });
155
-
156
- // ── 确定性 ────────────────────────────────────────────────────
157
-
158
- it("is deterministic — same schema produces identical output", () => {
159
- const schema: Record<string, unknown> = { a: 1, b: [2, 3] };
160
- expect(formatSchemaInstruction(schema)).toBe(formatSchemaInstruction(schema));
161
- });
162
-
163
- it("is deterministic across different object key insertion (value-equal schemas)", () => {
164
- // JSON.stringify 按对象自身属性顺序序列化;同序构造的等价 schema 应产出相同指令
165
- const a: Record<string, unknown> = { x: 1, y: 2 };
166
- const b: Record<string, unknown> = { x: 1, y: 2 };
167
- expect(formatSchemaInstruction(a)).toBe(formatSchemaInstruction(b));
168
- });
169
- });
@@ -1,458 +0,0 @@
1
- // src/__tests__/format.test.ts
2
- import { visibleWidth } from "@earendil-works/pi-tui";
3
- import { describe, expect, it } from "vitest";
4
-
5
- import {
6
- formatElapsedSeconds,
7
- formatTokens,
8
- padToVisible,
9
- sanitizeLabel,
10
- segFillColored,
11
- shortId,
12
- spinnerGlyph,
13
- statusGlyph,
14
- truncLine,
15
- wrapText,
16
- } from "../../interface/format.ts";
17
-
18
- // ============================================================
19
- // formatTokens
20
- // ============================================================
21
- describe("formatTokens", () => {
22
- it("shows plain value below 1000", () => {
23
- expect(formatTokens(0)).toBe("0");
24
- expect(formatTokens(820)).toBe("820");
25
- expect(formatTokens(999)).toBe("999");
26
- });
27
-
28
- it("shows N.Nk between 1000 and 9999", () => {
29
- expect(formatTokens(1000)).toBe("1.0k");
30
- expect(formatTokens(8200)).toBe("8.2k");
31
- expect(formatTokens(9999)).toBe("10.0k");
32
- });
33
-
34
- it("shows rounded Nk at 10000+", () => {
35
- expect(formatTokens(10000)).toBe("10k");
36
- expect(formatTokens(23000)).toBe("23k");
37
- expect(formatTokens(99999)).toBe("100k");
38
- });
39
- });
40
-
41
- // ============================================================
42
- // formatElapsedSeconds
43
- // ============================================================
44
- describe("formatElapsedSeconds", () => {
45
- it("shows Xs below 60", () => {
46
- expect(formatElapsedSeconds(0)).toBe("0s");
47
- expect(formatElapsedSeconds(12)).toBe("12s");
48
- expect(formatElapsedSeconds(59)).toBe("59s");
49
- });
50
-
51
- it("shows Xm Ys between 60 and 3599", () => {
52
- expect(formatElapsedSeconds(60)).toBe("1m0s");
53
- expect(formatElapsedSeconds(72)).toBe("1m12s");
54
- expect(formatElapsedSeconds(3599)).toBe("59m59s");
55
- });
56
-
57
- it("shows Xh Ym at 3600+", () => {
58
- expect(formatElapsedSeconds(3600)).toBe("1h0m");
59
- expect(formatElapsedSeconds(3661)).toBe("1h1m");
60
- expect(formatElapsedSeconds(7325)).toBe("2h2m");
61
- });
62
- });
63
-
64
- // ============================================================
65
- // statusGlyph
66
- // ============================================================
67
- describe("statusGlyph", () => {
68
- it("running → no icon, accent color", () => {
69
- expect(statusGlyph("running")).toEqual({ icon: undefined, color: "accent" });
70
- });
71
-
72
- it("done → checkmark, success", () => {
73
- expect(statusGlyph("closed")).toEqual({ icon: "✓", color: "success" });
74
- });
75
-
76
- it("closed → checkmark, success", () => {
77
- expect(statusGlyph("closed")).toEqual({ icon: "✓", color: "success" });
78
- });
79
- });
80
-
81
- // ============================================================
82
- // spinnerGlyph
83
- // ============================================================
84
- describe("spinnerGlyph", () => {
85
- it("returns a frame for valid seed", () => {
86
- expect(spinnerGlyph(0)).toBe("⠋");
87
- expect(spinnerGlyph(1)).toBe("⠙");
88
- expect(spinnerGlyph(9)).toBe("⠏");
89
- });
90
-
91
- it("wraps around (mod 10)", () => {
92
- expect(spinnerGlyph(10)).toBe("⠋");
93
- expect(spinnerGlyph(15)).toBe("⠴"); // index 5
94
- });
95
-
96
- it("falls back to frame 0 on NaN", () => {
97
- expect(spinnerGlyph(NaN)).toBe("⠋");
98
- });
99
-
100
- it("handles negative seeds via abs", () => {
101
- expect(spinnerGlyph(-1)).toBe("⠙"); // abs(-1) % 10 = 1 → ⠙
102
- expect(spinnerGlyph(-10)).toBe("⠋");
103
- });
104
-
105
- it("falls back to frame 0 on Infinity", () => {
106
- expect(spinnerGlyph(Infinity)).toBe("⠋");
107
- });
108
- });
109
-
110
- // ============================================================
111
- // sanitizeLabel
112
- // ============================================================
113
- describe("sanitizeLabel", () => {
114
- it("replaces CRLF/LF with single space", () => {
115
- expect(sanitizeLabel("line1\r\nline2\nline3")).toBe("line1 line2 line3");
116
- });
117
-
118
- it("replaces tabs with 2 spaces", () => {
119
- expect(sanitizeLabel("a\tb")).toBe("a b");
120
- });
121
-
122
- it("collapses multiple consecutive newlines into one space", () => {
123
- // /[\r\n]+/g treats \r\n\r\n as one match → single space
124
- expect(sanitizeLabel("a\r\n\r\nb")).toBe("a b");
125
- });
126
-
127
- it("leaves clean text unchanged", () => {
128
- expect(sanitizeLabel("read foo.ts")).toBe("read foo.ts");
129
- });
130
- });
131
-
132
- // ============================================================
133
- // padToVisible
134
- // ============================================================
135
- describe("padToVisible", () => {
136
- it("pads short text to width with trailing spaces", () => {
137
- expect(padToVisible("ab", 5)).toBe("ab ");
138
- });
139
-
140
- it("returns unchanged when already at width", () => {
141
- expect(padToVisible("hello", 5)).toBe("hello");
142
- });
143
-
144
- it("returns unchanged when wider than width", () => {
145
- expect(padToVisible("hello world", 5)).toBe("hello world");
146
- });
147
-
148
- it("handles CJK width (2 columns per char)", () => {
149
- // 你好 = 4 visible columns
150
- expect(padToVisible("你好", 6)).toBe("你好 ");
151
- });
152
- });
153
-
154
- // ============================================================
155
- // segFillColored
156
- // ============================================================
157
- describe("segFillColored", () => {
158
- it("returns empty string for width <= 0", () => {
159
- expect(segFillColored("title", "-", 0)).toBe("");
160
- expect(segFillColored("title", "-", -1)).toBe("");
161
- });
162
-
163
- it("pure fill when no title", () => {
164
- expect(segFillColored(undefined, "-", 5)).toBe("-----");
165
- });
166
-
167
- it("title + fill to width", () => {
168
- expect(segFillColored("Hi", "-", 5)).toBe("Hi---");
169
- });
170
-
171
- it("truncates title when wider than width", () => {
172
- const result = segFillColored("Hello World", "-", 5);
173
- // title visible width 11 > 5 → truncated to 5 (with ellipsis = 4 chars + …)
174
- expect(result.length).toBeLessThanOrEqual(10); // visible width 5 but may include ANSI
175
- });
176
-
177
- it("preserves ANSI in title and fill separately (no nesting color loss)", () => {
178
- const redTitle = "\x1b[31mHi\x1b[0m";
179
- const blueFill = "\x1b[34m-\x1b[0m";
180
- const result = segFillColored(redTitle, blueFill, 5);
181
- // title visible width = 2 ("Hi"), fill count = 3
182
- expect(result).toContain(redTitle);
183
- expect(result).toContain(blueFill);
184
- // fill repeated 3 times
185
- expect(result).toBe(redTitle + blueFill + blueFill + blueFill);
186
- });
187
- });
188
-
189
- // ============================================================
190
- // truncLine
191
- // ============================================================
192
- describe("truncLine", () => {
193
- it("returns text unchanged when within width", () => {
194
- expect(truncLine("hello", 10)).toBe("hello");
195
- expect(truncLine("hello", 5)).toBe("hello");
196
- });
197
-
198
- it("returns empty string for width <= 0", () => {
199
- expect(truncLine("hello", 0)).toBe("");
200
- });
201
-
202
- it("truncates with ellipsis when exceeding width", () => {
203
- const result = truncLine("hello world", 8);
204
- // 纯文本截断不发 \x1b[0m(全局重置会破坏外层背景色)
205
- expect(result.endsWith("…")).toBe(true);
206
- expect(result).not.toContain("\x1b[0m");
207
- // visible width should be 8 (7 chars + ellipsis)
208
- });
209
-
210
- it("handles CJK characters (2 columns each)", () => {
211
- // 你好世界 = 8 visible columns; truncate to 5 → 2 chars (4 cols) + …
212
- const result = truncLine("你好世界", 5);
213
- expect(result.endsWith("…")).toBe(true);
214
- expect(result).not.toContain("\x1b[0m");
215
- });
216
-
217
- it("handles emoji correctly", () => {
218
- const result = truncLine("😀😁😂🤣😃", 3);
219
- expect(result.endsWith("…")).toBe(true);
220
- expect(result).not.toContain("\x1b[0m");
221
- });
222
-
223
- it("reapplies active ANSI styles before ellipsis (no background break)", () => {
224
- // red text that exceeds width → ellipsis should have red re-applied
225
- const input = "\x1b[31mhello world this is long\x1b[0m";
226
- const result = truncLine(input, 10);
227
- expect(result.endsWith("…\x1b[0m")).toBe(true);
228
- // The ellipsis should be preceded by the active red style (re-applied)
229
- // Check that the last grapheme sequence includes the red SGR before …
230
- expect(result).toMatch(/\x1b\[31m…\x1b\[0m$/);
231
- });
232
-
233
- it("clears style stack on reset code", () => {
234
- // text with reset in the middle → after reset, no style re-applied
235
- const input = "\x1b[31mab\x1b[0mcdefghijk";
236
- const result = truncLine(input, 6);
237
- // reset 后 activeStyles 为空 → 截断不发 \x1b[0m
238
- expect(result.endsWith("…")).toBe(true);
239
- });
240
-
241
- it("flattens newlines to spaces (single-line rendering safety)", () => {
242
- // 多行 prompt / turn.text 含 \n,单行渲染时 \n 会意外换行破坏行对齐。
243
- // truncLine 作为单行渲染入口必须剥离 \n(用空格替代保留词边界)。
244
- const multiLine = "只读任务:分析核心逻辑。\n项目根:/Users/test\n输出:报告";
245
- const result = truncLine(multiLine, 80);
246
- expect(result).not.toContain("\n");
247
- expect(result).toContain("只读任务");
248
- expect(result).toContain("项目根");
249
- });
250
-
251
- it("flattens \r\n sequences", () => {
252
- const crlf = "line1\r\nline2\r\nline3";
253
- const result = truncLine(crlf, 80);
254
- expect(result).not.toContain("\r");
255
- expect(result).not.toContain("\n");
256
- });
257
- });
258
-
259
- // ============================================================
260
- // truncLine — legacy 对拍(indexOf 化重构的逐字节等价锚定)
261
- // ============================================================
262
-
263
- /**
264
- * 旧实现参照:改造前的 per-char 版本,逐字取自 git 历史(093e28fe3~1 的
265
- * format.ts truncLine)。现行实现(indexOf("\\x1b") 段跳过)必须与其逐字节
266
- * 等价——本函数即对拍 oracle,与 helpers-bounded-serialize.test.ts 的
267
- * legacySerialize 同形态(参照物随测试落盘,防「验证只存在于改造当时」)。
268
- */
269
- const legacySegmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
270
-
271
- function legacyTruncLine(text: string, maxWidth: number): string {
272
- if (maxWidth <= 0) return "";
273
- const flat = text.replace(/[\r\n]+/g, " ");
274
- if (visibleWidth(flat) <= maxWidth) return flat;
275
-
276
- const targetWidth = Math.max(0, maxWidth - 1);
277
- let result = "";
278
- let currentWidth = 0;
279
- let activeStyles: string[] = [];
280
- let i = 0;
281
-
282
- while (i < flat.length) {
283
- // 捕获 ANSI SGR 序列
284
- const ansiMatch = flat.slice(i).match(/^\x1b\[[0-9;]*m/);
285
- if (ansiMatch) {
286
- const code = ansiMatch[0];
287
- result += code;
288
-
289
- if (code === "\x1b[0m" || code === "\x1b[m") {
290
- activeStyles = []; // reset → 清空栈
291
- } else {
292
- activeStyles.push(code);
293
- }
294
- i += code.length;
295
- continue;
296
- }
297
-
298
- // 找到下一段纯文本(非 ANSI)的边界
299
- let end = i;
300
- while (end < flat.length && !flat.slice(end).match(/^\x1b\[[0-9;]*m/)) {
301
- end++;
302
- }
303
-
304
- // 按 grapheme 迭代这段文本,累加到 targetWidth
305
- const textPortion = flat.slice(i, end);
306
- for (const seg of legacySegmenter.segment(textPortion)) {
307
- const grapheme = seg.segment;
308
- const graphemeWidth = visibleWidth(grapheme);
309
-
310
- if (currentWidth + graphemeWidth > targetWidth) {
311
- return result + activeStyles.join("") + "…" + (activeStyles.length ? "\x1b[0m" : "");
312
- }
313
-
314
- result += grapheme;
315
- currentWidth += graphemeWidth;
316
- }
317
- i = end;
318
- }
319
-
320
- // 理论上 visibleWidth 检查已提前返回,此行兜底
321
- return result + activeStyles.join("") + "…" + (activeStyles.length ? "\x1b[0m" : "");
322
- }
323
-
324
- /** 确定性 PRNG(mulberry32):fuzz 用例固定 seed 生成,失败可按 case 编号 + seed 复现。 */
325
- function mulberry32(seed: number): () => number {
326
- let s = seed | 0;
327
- return () => {
328
- s = (s + 0x6d2b79f5) | 0;
329
- let t = Math.imul(s ^ (s >>> 15), 1 | s);
330
- t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
331
- return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
332
- };
333
- }
334
-
335
- /** 定向混排片段池:ASCII / CJK / emoji(含肤色修饰与 ZWJ 组合)/ SGR / 非 SGR ESC(OSC、CSI-K、裸 ESC)/ 换行。 */
336
- const FUZZ_PIECES = [
337
- "plain", " ", "a", "0", "MiXeD-Case_123",
338
- "你好世界", "汉字宽度测试", "日本語テキスト",
339
- "😀", "😁😂🤣", "👍🏽", "👨‍👩‍👧‍👦", "é", "é",
340
- "\x1b[31m", "\x1b[0m", "\x1b[m", "\x1b[1;32m", "\x1b[38;5;196m",
341
- "\x1b[K", "\x1b]0;title\x07", "\x1bZ", "\x1b",
342
- "\n", "\r\n",
343
- ];
344
-
345
- function genFuzzText(rand: () => number): string {
346
- const pieceCount = Math.floor(rand() * 40);
347
- let out = "";
348
- for (let p = 0; p < pieceCount; p++) {
349
- out += FUZZ_PIECES[Math.floor(rand() * FUZZ_PIECES.length)];
350
- }
351
- return out;
352
- }
353
-
354
- describe("truncLine — legacy 对拍(per-char 参照逐字节等价)", () => {
355
- it("定向 fuzz:300 随机 ESC/SGR/CJK/emoji 混排用例(固定 seed 可复现)与旧实现逐字节一致", () => {
356
- const rand = mulberry32(20260815);
357
- let truncated = 0;
358
- for (let i = 0; i < 300; i++) {
359
- const text = genFuzzText(rand);
360
- const maxWidth = Math.floor(rand() * 61); // 0..60,含 0/1 边界
361
- const actual = truncLine(text, maxWidth);
362
- expect(
363
- actual,
364
- `case #${i} text=${JSON.stringify(text)} maxWidth=${maxWidth}`,
365
- ).toBe(legacyTruncLine(text, maxWidth));
366
- if (actual.endsWith("…")) truncated++;
367
- }
368
- // 前置有效性:fuzz 确实命中了截断路径(否则对拍只测了「宽度内原样返回」早退分支)
369
- expect(truncated).toBeGreaterThan(100);
370
- });
371
-
372
- it("手工对抗用例:SGR 重叠 / OSC 内截断 / CSI-K 混排 / 串尾裸 ESC", () => {
373
- const cases: Array<[string, number]> = [
374
- ["\x1b[31m红\x1b[32m绿\x1b[1;4m加粗下划线尾巴超宽截断点", 9],
375
- ["AB\x1b]0;title\x07CDEFGHIJKLMNOP", 10],
376
- ["\x1b[31mred\x1b[K\x1b[32mgreen tail past width", 10],
377
- ["text almost at width limit\x1b", 22],
378
- ["before \x1bZ after bare esc tail", 12],
379
- ["\x1b[m你\x1b[0m好\x1b[38;5;196m世👨‍👩‍👧‍👦界".repeat(3), 14],
380
- ];
381
- for (const [text, maxWidth] of cases) {
382
- expect(truncLine(text, maxWidth)).toBe(legacyTruncLine(text, maxWidth));
383
- }
384
- });
385
- });
386
-
387
- // ============================================================
388
- // wrapText
389
- // ============================================================
390
- describe("wrapText", () => {
391
- it("returns text as-is when shorter than width", () => {
392
- expect(wrapText("hello", 80)).toEqual(["hello"]);
393
- });
394
-
395
- it("wraps long text into multiple lines (no truncation)", () => {
396
- const text = "abcdefghij"; // 10 chars
397
- const lines = wrapText(text, 4);
398
- // 每行最多 4 列,10 字符 → 3 行(4+4+2),不截断不省略号
399
- expect(lines.join("")).toBe("abcdefghij");
400
- for (const l of lines.slice(0, -1)) {
401
- expect(visibleWidth(l)).toBeLessThanOrEqual(4);
402
- }
403
- });
404
-
405
- it("preserves original newlines as paragraph breaks", () => {
406
- const text = "第一行\n第二行";
407
- const lines = wrapText(text, 80);
408
- expect(lines).toEqual(["第一行", "第二行"]);
409
- });
410
-
411
- it("wraps CJK text correctly (2 columns each)", () => {
412
- // 你好世界你好世界 = 8 CJK chars = 16 columns, wrap to 4 columns
413
- const text = "你好世界你好世界";
414
- const lines = wrapText(text, 4);
415
- // 每行最多 4 列 = 2 CJK chars, 共 4 行
416
- expect(lines).toHaveLength(4);
417
- expect(lines.join("")).toBe(text);
418
- });
419
-
420
- it("handles width <= 0 by returning original", () => {
421
- expect(wrapText("hello", 0)).toEqual(["hello"]);
422
- });
423
-
424
- it("preserves empty lines from blank paragraphs", () => {
425
- const text = "a\n\nb";
426
- expect(wrapText(text, 80)).toEqual(["a", "", "b"]);
427
- });
428
- });
429
-
430
- // ============================================================
431
- // shortId
432
- // ============================================================
433
- describe("shortId", () => {
434
- it("returns sync id unchanged (run-N already short)", () => {
435
- expect(shortId("run-1")).toBe("run-1");
436
- expect(shortId("run-42")).toBe("run-42");
437
- });
438
-
439
- it("strips timestamp from background id (bg-tag-seq-<ts> → bg-tag-seq)", () => {
440
- // 算法回归:多段 id 取前 3 段(SHORT_ID_BG_SEGMENTS)。
441
- // 注意:当前 subagent ID 已改为 sa-<uuid>(见下面 sa- 用例),workflow ID 为 wf-<ts>-<rand>,
442
- // 实际不再产生 bg- 形态 id;此处保留作为 shortId 算法的多段降级回归(4 段 → 3 段)。
443
- expect(shortId("bg-f6f731-10-1719500000000")).toBe("bg-f6f731-10");
444
- expect(shortId("bg-abc123-99-1719500123456")).toBe("bg-abc123-99");
445
- });
446
-
447
- it("handles pure uuid and wf- runId (regression baseline)", () => {
448
- // 纯 UUID 回归(5段 → 取前3段)
449
- expect(shortId("550e8400-e29b-41d4-a716-446655440000")).toBe("550e8400-e29b-41d4");
450
- // wf- 前缀 runId 回归(3段 → 取前3段=原样)
451
- expect(shortId("wf-1719500000000-a1b2c3")).toBe("wf-1719500000000-a1b2c3");
452
- });
453
-
454
- it("keeps sa- prefix for subagent id (sa-<uuid> → sa-<uuid 前3段>)", () => {
455
- // sa- 前缀 subagent ID(保留前缀 + UUID 前 3 段)
456
- expect(shortId("sa-550e8400-e29b-41d4-a716-446655440000")).toBe("sa-550e8400-e29b-41d4");
457
- });
458
- });