@xzzpig/pi-subagents 0.22.0 → 0.24.1

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 (1138) hide show
  1. package/CHANGELOG.md +355 -0
  2. package/README.md +2 -2
  3. package/agents/evidence-auditor.md +1 -0
  4. package/agents/oracle.md +1 -0
  5. package/agents/reviewer.md +1 -0
  6. package/bundle/agent-management.js +16 -0
  7. package/bundle/agents.js +41 -0
  8. package/bundle/background-work.js +16 -0
  9. package/bundle/capability-ceiling.js +22 -0
  10. package/bundle/child-tool-plan.js +11 -0
  11. package/bundle/chunk-355ECEP2.js +1321 -0
  12. package/bundle/chunk-35GII5EF.js +637 -0
  13. package/bundle/chunk-3U633XDZ.js +749 -0
  14. package/bundle/chunk-4QFZZV3O.js +57 -0
  15. package/bundle/chunk-62OCY2S4.js +14 -0
  16. package/bundle/chunk-6BJUEES3.js +276 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-BGIYHF2W.js +138 -0
  19. package/bundle/chunk-CTPAE36Y.js +94 -0
  20. package/bundle/chunk-D4EHT5SJ.js +14 -0
  21. package/bundle/chunk-ED55MIC2.js +1681 -0
  22. package/bundle/chunk-EUPJB4S7.js +5503 -0
  23. package/bundle/chunk-FG6SQJAR.js +940 -0
  24. package/bundle/chunk-FJWI64H7.js +490 -0
  25. package/bundle/chunk-H36HBZB2.js +753 -0
  26. package/bundle/chunk-ICNYIALB.js +7347 -0
  27. package/bundle/chunk-JEA2ZKUA.js +1372 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LMGQAJ3O.js +9872 -0
  30. package/bundle/chunk-LVWU2HOO.js +1234 -0
  31. package/bundle/chunk-NIXWDZZV.js +9 -0
  32. package/bundle/chunk-QXASAHIA.js +173 -0
  33. package/bundle/chunk-RB4GELQA.js +458 -0
  34. package/bundle/chunk-RU522D5W.js +1768 -0
  35. package/bundle/chunk-SLNMBXLL.js +7336 -0
  36. package/bundle/chunk-SW2VMNIU.js +526 -0
  37. package/bundle/chunk-TGLFTQWJ.js +143 -0
  38. package/bundle/chunk-TMHVDPYW.js +4132 -0
  39. package/bundle/chunk-U4ODUYAG.js +235 -0
  40. package/bundle/chunk-UKG4V45O.js +228 -0
  41. package/bundle/chunk-UQDHXMUG.js +264 -0
  42. package/bundle/chunk-V2KFIGFH.js +8774 -0
  43. package/bundle/chunk-VO3G7HI3.js +85 -0
  44. package/bundle/chunk-WPW4V6HM.js +227 -0
  45. package/bundle/chunk-WW76JRIX.js +175 -0
  46. package/bundle/chunk-X6LOM3Z4.js +4175 -0
  47. package/bundle/chunk-XA3DY6UG.js +161 -0
  48. package/bundle/chunk-Y6H2G6KX.js +1310 -0
  49. package/bundle/chunk-YFCK7H2S.js +129 -0
  50. package/bundle/chunk-YYREO77V.js +137 -0
  51. package/bundle/chunk-Z6TFJ6BR.js +400 -0
  52. package/bundle/chunk-ZWXU5SPQ.js +16932 -0
  53. package/bundle/control-channel.js +11 -0
  54. package/bundle/delegation.js +14 -0
  55. package/bundle/external-job-provider.js +20 -0
  56. package/bundle/external-runs.js +21 -0
  57. package/bundle/index.js +30 -0
  58. package/bundle/inspectors.js +8 -0
  59. package/bundle/intercom-bridge.js +11 -0
  60. package/bundle/preflight.js +468 -0
  61. package/bundle/project-panes.js +28 -0
  62. package/bundle/required-child-extensions.js +6 -0
  63. package/bundle/shared-types.js +8 -0
  64. package/bundle/supervisor-routing.js +12 -0
  65. package/bundle/workflow-resources.js +7 -0
  66. package/docs/agents.md +42 -10
  67. package/docs/configuration.md +59 -14
  68. package/docs/extension-api.md +61 -9
  69. package/docs/goal-auto-continuation-gate.md +26 -0
  70. package/docs/missions.md +2 -0
  71. package/docs/observability.md +20 -5
  72. package/docs/standalone-background.md +8 -6
  73. package/docs/tool-reference.md +18 -5
  74. package/docs/workflows.md +25 -7
  75. package/index.d.ts +3 -0
  76. package/index.js +14 -0
  77. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  78. package/package.json +107 -87
  79. package/skills/council-mode/SKILL.md +1 -4
  80. package/skills/pi-subagents/SKILL.md +130 -106
  81. package/skills/pi-subagents/references/orchestration.md +124 -0
  82. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  83. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  84. package/src/agents/advertised-agent-prompt.js +68 -0
  85. package/src/agents/agent-eject.d.ts +39 -0
  86. package/src/agents/agent-eject.js +263 -0
  87. package/src/agents/agent-management.d.ts +33 -0
  88. package/src/agents/agent-management.js +1541 -0
  89. package/src/agents/agent-memory.d.ts +48 -0
  90. package/src/agents/agent-memory.js +350 -0
  91. package/src/agents/agent-refinements.d.ts +99 -0
  92. package/src/agents/agent-refinements.js +568 -0
  93. package/src/agents/agent-scope.d.ts +3 -0
  94. package/src/agents/agent-scope.js +8 -0
  95. package/src/agents/agent-selection.d.ts +2 -0
  96. package/src/agents/agent-selection.js +22 -0
  97. package/src/agents/agent-serializer.d.ts +7 -0
  98. package/src/agents/agent-serializer.js +213 -0
  99. package/src/agents/agents.d.ts +352 -0
  100. package/src/agents/agents.js +2817 -0
  101. package/src/agents/builtin-names.d.ts +1 -0
  102. package/src/agents/builtin-names.js +16 -0
  103. package/src/agents/chain-serializer.d.ts +6 -0
  104. package/src/agents/chain-serializer.js +318 -0
  105. package/src/agents/frontmatter.d.ts +19 -0
  106. package/src/agents/frontmatter.js +166 -0
  107. package/src/agents/global-npm-root.d.ts +6 -0
  108. package/src/agents/global-npm-root.js +57 -0
  109. package/src/agents/identity.d.ts +7 -0
  110. package/src/agents/identity.js +29 -0
  111. package/src/agents/proactive-skills.d.ts +35 -0
  112. package/src/agents/proactive-skills.js +155 -0
  113. package/src/agents/runtime-agent-events.d.ts +26 -0
  114. package/src/agents/runtime-agent-events.js +52 -0
  115. package/src/agents/runtime-agent-registry.d.ts +66 -0
  116. package/src/agents/runtime-agent-registry.js +415 -0
  117. package/src/agents/runtime-discovery.d.ts +13 -0
  118. package/src/agents/runtime-discovery.js +27 -0
  119. package/src/agents/skills.d.ts +34 -0
  120. package/src/agents/skills.js +718 -0
  121. package/src/api/agent-management.d.ts +2 -0
  122. package/src/api/agent-management.js +2 -0
  123. package/src/api/agents.d.ts +6 -0
  124. package/src/api/agents.js +3 -0
  125. package/src/api/background-work.d.ts +41 -0
  126. package/src/api/background-work.js +171 -0
  127. package/src/api/capability-ceiling.d.ts +1 -0
  128. package/src/api/capability-ceiling.js +1 -0
  129. package/src/api/child-tool-plan.d.ts +1 -0
  130. package/src/api/child-tool-plan.js +1 -0
  131. package/src/api/control-channel.d.ts +1 -0
  132. package/src/api/control-channel.js +1 -0
  133. package/src/api/delegation.d.ts +132 -0
  134. package/src/api/delegation.js +8 -0
  135. package/src/api/external-job-provider.d.ts +57 -0
  136. package/src/api/external-job-provider.js +139 -0
  137. package/src/api/external-runs.d.ts +47 -0
  138. package/src/api/external-runs.js +245 -0
  139. package/src/api/inspectors.d.ts +20 -0
  140. package/src/api/inspectors.js +11 -0
  141. package/src/api/intercom-bridge.d.ts +1 -0
  142. package/src/api/intercom-bridge.js +1 -0
  143. package/src/api/preflight.d.ts +183 -0
  144. package/src/api/preflight.js +455 -0
  145. package/src/api/project-panes.d.ts +7 -0
  146. package/src/api/project-panes.js +7 -0
  147. package/src/api/required-child-extensions.d.ts +1 -0
  148. package/src/api/required-child-extensions.js +1 -0
  149. package/src/api/shared-types.d.ts +1 -0
  150. package/src/api/shared-types.js +1 -0
  151. package/src/api/supervisor-routing.d.ts +110 -0
  152. package/src/api/supervisor-routing.js +95 -0
  153. package/src/api/workflow-resources.d.ts +2 -0
  154. package/src/api/workflow-resources.js +1 -0
  155. package/src/extension/active-runs-prompt.d.ts +7 -0
  156. package/src/extension/active-runs-prompt.js +29 -0
  157. package/src/extension/config.d.ts +7 -0
  158. package/src/extension/config.js +290 -0
  159. package/src/extension/context-injection.d.ts +52 -0
  160. package/src/extension/context-injection.js +102 -0
  161. package/src/extension/control-notices.d.ts +18 -0
  162. package/src/extension/control-notices.js +29 -0
  163. package/src/extension/declaration-pinning.d.ts +18 -0
  164. package/src/extension/declaration-pinning.js +167 -0
  165. package/src/extension/doctor.d.ts +34 -0
  166. package/src/extension/doctor.js +236 -0
  167. package/src/extension/fanout-child.d.ts +6 -0
  168. package/src/extension/fanout-child.js +278 -0
  169. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  170. package/src/extension/herdr-pi-bridge.js +261 -0
  171. package/src/extension/index.d.ts +18 -0
  172. package/src/extension/index.js +1300 -0
  173. package/src/extension/public-execution.d.ts +71 -0
  174. package/src/extension/public-execution.js +214 -0
  175. package/src/extension/reply-workflow-script.d.ts +11 -0
  176. package/src/extension/reply-workflow-script.js +71 -0
  177. package/src/extension/rpc.d.ts +84 -0
  178. package/src/extension/rpc.js +729 -0
  179. package/src/extension/schemas.d.ts +276 -0
  180. package/src/extension/schemas.js +311 -0
  181. package/src/extension/steering-notices.d.ts +14 -0
  182. package/src/extension/steering-notices.js +22 -0
  183. package/src/extension/subagent-guide.d.ts +4 -0
  184. package/src/extension/subagent-guide.js +114 -0
  185. package/src/extension/subagent-options.d.ts +7 -0
  186. package/src/extension/subagent-options.js +64 -0
  187. package/src/extension/tool-activation.d.ts +7 -0
  188. package/src/extension/tool-activation.js +185 -0
  189. package/src/extension/tool-description.d.ts +19 -0
  190. package/src/extension/tool-description.js +169 -0
  191. package/src/extension/tool-result.d.ts +9 -0
  192. package/src/extension/tool-result.js +16 -0
  193. package/src/extension/upgrade-notice.d.ts +6 -0
  194. package/src/extension/upgrade-notice.js +42 -0
  195. package/src/goal-auto-continue-gate.d.ts +17 -0
  196. package/src/goal-auto-continue-gate.js +61 -0
  197. package/src/goal-auto-continue-state.d.ts +22 -0
  198. package/src/goal-auto-continue-state.js +20 -0
  199. package/src/inspectors/actions.d.ts +24 -0
  200. package/src/inspectors/actions.js +182 -0
  201. package/src/inspectors/ghostty/actions.d.ts +11 -0
  202. package/src/inspectors/ghostty/actions.js +62 -0
  203. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  204. package/src/inspectors/ghostty/plugin.js +23 -0
  205. package/src/inspectors/herdr/actions.d.ts +25 -0
  206. package/src/inspectors/herdr/actions.js +133 -0
  207. package/src/inspectors/herdr/client.d.ts +41 -0
  208. package/src/inspectors/herdr/client.js +129 -0
  209. package/src/inspectors/herdr/focus.d.ts +24 -0
  210. package/src/inspectors/herdr/focus.js +49 -0
  211. package/src/inspectors/herdr/plugin.d.ts +6 -0
  212. package/src/inspectors/herdr/plugin.js +14 -0
  213. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  214. package/src/inspectors/herdr/project-panes.js +610 -0
  215. package/src/inspectors/inspector-runner.d.ts +23 -0
  216. package/src/inspectors/inspector-runner.js +161 -0
  217. package/src/inspectors/plugins.d.ts +8 -0
  218. package/src/inspectors/plugins.js +82 -0
  219. package/src/inspectors/session-roots-codec.d.ts +15 -0
  220. package/src/inspectors/session-roots-codec.js +32 -0
  221. package/src/inspectors/shell-command.d.ts +1 -0
  222. package/src/inspectors/shell-command.js +16 -0
  223. package/src/inspectors/tmux/actions.d.ts +25 -0
  224. package/src/inspectors/tmux/actions.js +181 -0
  225. package/src/inspectors/tmux/client.d.ts +27 -0
  226. package/src/inspectors/tmux/client.js +64 -0
  227. package/src/inspectors/tmux/plugin.d.ts +7 -0
  228. package/src/inspectors/tmux/plugin.js +14 -0
  229. package/src/inspectors/types.d.ts +48 -0
  230. package/src/inspectors/types.js +1 -0
  231. package/src/integrations/herdr-status.d.ts +47 -0
  232. package/src/integrations/herdr-status.js +350 -0
  233. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  234. package/src/integrations/pi-web-session-liveness.js +53 -0
  235. package/src/integrations/program-status.d.ts +30 -0
  236. package/src/integrations/program-status.js +188 -0
  237. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  238. package/src/intercom/fork-supervisor-routing.js +392 -0
  239. package/src/intercom/intercom-bridge.d.ts +58 -0
  240. package/src/intercom/intercom-bridge.js +193 -0
  241. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  242. package/src/intercom/native-supervisor-channel.js +1184 -0
  243. package/src/intercom/result-intercom.d.ts +35 -0
  244. package/src/intercom/result-intercom.js +376 -0
  245. package/src/intercom/supervisor-ui.d.ts +29 -0
  246. package/src/intercom/supervisor-ui.js +49 -0
  247. package/src/missions/actions.d.ts +54 -0
  248. package/src/missions/actions.js +400 -0
  249. package/src/missions/goal-driver.d.ts +16 -0
  250. package/src/missions/goal-driver.js +171 -0
  251. package/src/missions/lifecycle.d.ts +50 -0
  252. package/src/missions/lifecycle.js +388 -0
  253. package/src/missions/store.d.ts +21 -0
  254. package/src/missions/store.js +605 -0
  255. package/src/missions/types.d.ts +169 -0
  256. package/src/missions/types.js +9 -0
  257. package/src/missions/workflow-state.d.ts +14 -0
  258. package/src/missions/workflow-state.js +273 -0
  259. package/src/policy/authority.d.ts +9 -0
  260. package/src/policy/authority.js +41 -0
  261. package/src/profiles/profiles.d.ts +134 -0
  262. package/src/profiles/profiles.js +526 -0
  263. package/src/runs/background/active-async-capacity.d.ts +115 -0
  264. package/src/runs/background/active-async-capacity.js +517 -0
  265. package/src/runs/background/active-run-index.d.ts +12 -0
  266. package/src/runs/background/active-run-index.js +157 -0
  267. package/src/runs/background/async-execution.d.ts +306 -0
  268. package/src/runs/background/async-execution.js +2210 -0
  269. package/src/runs/background/async-job-tracker.d.ts +37 -0
  270. package/src/runs/background/async-job-tracker.js +926 -0
  271. package/src/runs/background/async-resume.d.ts +60 -0
  272. package/src/runs/background/async-resume.js +707 -0
  273. package/src/runs/background/async-retention.d.ts +45 -0
  274. package/src/runs/background/async-retention.js +932 -0
  275. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  276. package/src/runs/background/async-status-snapshot.js +26 -0
  277. package/src/runs/background/async-status.d.ts +179 -0
  278. package/src/runs/background/async-status.js +712 -0
  279. package/src/runs/background/auto-drain.d.ts +16 -0
  280. package/src/runs/background/auto-drain.js +71 -0
  281. package/src/runs/background/await-async-run.d.ts +26 -0
  282. package/src/runs/background/await-async-run.js +83 -0
  283. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  284. package/src/runs/background/binary-bootstrap.js +69 -0
  285. package/src/runs/background/boot-id.d.ts +12 -0
  286. package/src/runs/background/boot-id.js +47 -0
  287. package/src/runs/background/calendar-schedule.d.ts +26 -0
  288. package/src/runs/background/calendar-schedule.js +93 -0
  289. package/src/runs/background/chain-append.d.ts +34 -0
  290. package/src/runs/background/chain-append.js +299 -0
  291. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  292. package/src/runs/background/chain-root-attachment.js +186 -0
  293. package/src/runs/background/completion-batcher.d.ts +51 -0
  294. package/src/runs/background/completion-batcher.js +119 -0
  295. package/src/runs/background/completion-dedupe.d.ts +13 -0
  296. package/src/runs/background/completion-dedupe.js +48 -0
  297. package/src/runs/background/completion-replay.d.ts +47 -0
  298. package/src/runs/background/completion-replay.js +266 -0
  299. package/src/runs/background/control-channel.d.ts +170 -0
  300. package/src/runs/background/control-channel.js +610 -0
  301. package/src/runs/background/fleet-view.d.ts +63 -0
  302. package/src/runs/background/fleet-view.js +666 -0
  303. package/src/runs/background/index-segment.d.ts +16 -0
  304. package/src/runs/background/index-segment.js +58 -0
  305. package/src/runs/background/inspect-rpc.d.ts +64 -0
  306. package/src/runs/background/inspect-rpc.js +422 -0
  307. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  308. package/src/runs/background/interrupted-elsewhere.js +68 -0
  309. package/src/runs/background/notify.d.ts +216 -0
  310. package/src/runs/background/notify.js +1006 -0
  311. package/src/runs/background/owned-process-tree.d.ts +10 -0
  312. package/src/runs/background/owned-process-tree.js +116 -0
  313. package/src/runs/background/parallel-groups.d.ts +3 -0
  314. package/src/runs/background/parallel-groups.js +46 -0
  315. package/src/runs/background/pid-namespace.d.ts +2 -0
  316. package/src/runs/background/pid-namespace.js +19 -0
  317. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  318. package/src/runs/background/process-terminal-candidate.js +96 -0
  319. package/src/runs/background/process-terminal.d.ts +21 -0
  320. package/src/runs/background/process-terminal.js +227 -0
  321. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  322. package/src/runs/background/result-delivery-ownership.js +38 -0
  323. package/src/runs/background/result-files.d.ts +63 -0
  324. package/src/runs/background/result-files.js +629 -0
  325. package/src/runs/background/result-watcher.d.ts +92 -0
  326. package/src/runs/background/result-watcher.js +819 -0
  327. package/src/runs/background/resume-guidance.d.ts +4 -0
  328. package/src/runs/background/resume-guidance.js +57 -0
  329. package/src/runs/background/retained-children.d.ts +24 -0
  330. package/src/runs/background/retained-children.js +128 -0
  331. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  332. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  333. package/src/runs/background/run-child-session.d.ts +123 -0
  334. package/src/runs/background/run-child-session.js +670 -0
  335. package/src/runs/background/run-id-query.d.ts +3 -0
  336. package/src/runs/background/run-id-query.js +6 -0
  337. package/src/runs/background/run-id-resolver.d.ts +22 -0
  338. package/src/runs/background/run-id-resolver.js +172 -0
  339. package/src/runs/background/run-status.d.ts +25 -0
  340. package/src/runs/background/run-status.js +850 -0
  341. package/src/runs/background/runner-aliases.d.ts +17 -0
  342. package/src/runs/background/runner-aliases.js +191 -0
  343. package/src/runs/background/runner-child-launch.d.ts +24 -0
  344. package/src/runs/background/runner-child-launch.js +72 -0
  345. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  346. package/src/runs/background/runner-child-sessions.js +34 -0
  347. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  348. package/src/runs/background/runner-http-dispatcher.js +115 -0
  349. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  350. package/src/runs/background/runner-startup-failure.js +46 -0
  351. package/src/runs/background/scheduled-runs.d.ts +127 -0
  352. package/src/runs/background/scheduled-runs.js +1265 -0
  353. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  354. package/src/runs/background/stale-run-reconciler.js +509 -0
  355. package/src/runs/background/steering.d.ts +51 -0
  356. package/src/runs/background/steering.js +246 -0
  357. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  358. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  359. package/src/runs/background/subagent-runner.d.ts +210 -0
  360. package/src/runs/background/subagent-runner.js +4963 -0
  361. package/src/runs/background/subagent-wait.d.ts +124 -0
  362. package/src/runs/background/subagent-wait.js +756 -0
  363. package/src/runs/background/terminal-run-index.d.ts +10 -0
  364. package/src/runs/background/terminal-run-index.js +209 -0
  365. package/src/runs/background/top-level-async.d.ts +7 -0
  366. package/src/runs/background/top-level-async.js +5 -0
  367. package/src/runs/background/wait-completions.d.ts +28 -0
  368. package/src/runs/background/wait-completions.js +264 -0
  369. package/src/runs/background/wait-config.d.ts +8 -0
  370. package/src/runs/background/wait-config.js +46 -0
  371. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  372. package/src/runs/background/wait-subscriptions.js +339 -0
  373. package/src/runs/background/wait-tool.d.ts +6 -0
  374. package/src/runs/background/wait-tool.js +48 -0
  375. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  376. package/src/runs/background/workflow-terminal-proof.js +116 -0
  377. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  378. package/src/runs/foreground/async-dismiss-action.js +82 -0
  379. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  380. package/src/runs/foreground/async-steering-action.js +294 -0
  381. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  382. package/src/runs/foreground/async-stop-action.js +213 -0
  383. package/src/runs/foreground/command-action.d.ts +12 -0
  384. package/src/runs/foreground/command-action.js +38 -0
  385. package/src/runs/foreground/execution.d.ts +10 -0
  386. package/src/runs/foreground/execution.js +2322 -0
  387. package/src/runs/foreground/foreground-control.d.ts +24 -0
  388. package/src/runs/foreground/foreground-control.js +138 -0
  389. package/src/runs/foreground/foreground-history.d.ts +25 -0
  390. package/src/runs/foreground/foreground-history.js +267 -0
  391. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  392. package/src/runs/foreground/prompt-audit.js +138 -0
  393. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  394. package/src/runs/foreground/subagent-executor.js +7990 -0
  395. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  396. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  397. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  398. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  399. package/src/runs/shared/abort-recovery.d.ts +26 -0
  400. package/src/runs/shared/abort-recovery.js +108 -0
  401. package/src/runs/shared/acceptance.d.ts +144 -0
  402. package/src/runs/shared/acceptance.js +1616 -0
  403. package/src/runs/shared/agent-contract.d.ts +5 -0
  404. package/src/runs/shared/agent-contract.js +35 -0
  405. package/src/runs/shared/async-status-projection.d.ts +100 -0
  406. package/src/runs/shared/async-status-projection.js +566 -0
  407. package/src/runs/shared/background-process-options.d.ts +4 -0
  408. package/src/runs/shared/background-process-options.js +6 -0
  409. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  410. package/src/runs/shared/capability-ceiling.js +179 -0
  411. package/src/runs/shared/chain-outputs.d.ts +18 -0
  412. package/src/runs/shared/chain-outputs.js +104 -0
  413. package/src/runs/shared/child-commands.d.ts +29 -0
  414. package/src/runs/shared/child-commands.js +254 -0
  415. package/src/runs/shared/child-hooks.d.ts +31 -0
  416. package/src/runs/shared/child-hooks.js +173 -0
  417. package/src/runs/shared/child-identity.d.ts +23 -0
  418. package/src/runs/shared/child-identity.js +40 -0
  419. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  420. package/src/runs/shared/child-launch-plan.js +88 -0
  421. package/src/runs/shared/child-launch.d.ts +128 -0
  422. package/src/runs/shared/child-launch.js +262 -0
  423. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  424. package/src/runs/shared/child-lifecycle.js +22 -0
  425. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  426. package/src/runs/shared/child-runtime-config.js +44 -0
  427. package/src/runs/shared/child-session.d.ts +178 -0
  428. package/src/runs/shared/child-session.js +726 -0
  429. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  430. package/src/runs/shared/child-tool-plan.js +430 -0
  431. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  432. package/src/runs/shared/claude-code-adapter.js +255 -0
  433. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  434. package/src/runs/shared/codex-exec-adapter.js +127 -0
  435. package/src/runs/shared/context-mode.d.ts +12 -0
  436. package/src/runs/shared/context-mode.js +38 -0
  437. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  438. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  439. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  440. package/src/runs/shared/dynamic-fanout.js +273 -0
  441. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  442. package/src/runs/shared/effective-system-prompt.js +23 -0
  443. package/src/runs/shared/extension-bindings.d.ts +25 -0
  444. package/src/runs/shared/extension-bindings.js +96 -0
  445. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  446. package/src/runs/shared/external-cli-contract.js +145 -0
  447. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  448. package/src/runs/shared/external-cli-preflight.js +159 -0
  449. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  450. package/src/runs/shared/external-cli-runner.js +425 -0
  451. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  452. package/src/runs/shared/external-job-bridge.js +486 -0
  453. package/src/runs/shared/external-job-runner.d.ts +44 -0
  454. package/src/runs/shared/external-job-runner.js +352 -0
  455. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  456. package/src/runs/shared/fast-mode-extension.js +8 -0
  457. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  458. package/src/runs/shared/fork-placed-env.js +13 -0
  459. package/src/runs/shared/git-environment.d.ts +2 -0
  460. package/src/runs/shared/git-environment.js +27 -0
  461. package/src/runs/shared/herdr-connection.d.ts +79 -0
  462. package/src/runs/shared/herdr-connection.js +269 -0
  463. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  464. package/src/runs/shared/herdr-external-adapters.js +404 -0
  465. package/src/runs/shared/herdr-machine.d.ts +59 -0
  466. package/src/runs/shared/herdr-machine.js +294 -0
  467. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  468. package/src/runs/shared/herdr-pane-host.js +155 -0
  469. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  470. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  471. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  472. package/src/runs/shared/herdr-placed-run.js +380 -0
  473. package/src/runs/shared/host-step-status.d.ts +33 -0
  474. package/src/runs/shared/host-step-status.js +244 -0
  475. package/src/runs/shared/lane-metadata.d.ts +23 -0
  476. package/src/runs/shared/lane-metadata.js +126 -0
  477. package/src/runs/shared/launch-cwd.d.ts +1 -0
  478. package/src/runs/shared/launch-cwd.js +16 -0
  479. package/src/runs/shared/local-machine-access.d.ts +5 -0
  480. package/src/runs/shared/local-machine-access.js +28 -0
  481. package/src/runs/shared/long-running-guard.d.ts +34 -0
  482. package/src/runs/shared/long-running-guard.js +256 -0
  483. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  484. package/src/runs/shared/mcp-config-sources.js +418 -0
  485. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  486. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  487. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  488. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  489. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  490. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  491. package/src/runs/shared/model-resolution.d.ts +109 -0
  492. package/src/runs/shared/model-resolution.js +411 -0
  493. package/src/runs/shared/model-scope.d.ts +68 -0
  494. package/src/runs/shared/model-scope.js +171 -0
  495. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  496. package/src/runs/shared/mutation-evidence.js +198 -0
  497. package/src/runs/shared/nested-events.d.ts +135 -0
  498. package/src/runs/shared/nested-events.js +1090 -0
  499. package/src/runs/shared/nested-path.d.ts +8 -0
  500. package/src/runs/shared/nested-path.js +34 -0
  501. package/src/runs/shared/nested-render.d.ts +20 -0
  502. package/src/runs/shared/nested-render.js +115 -0
  503. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  504. package/src/runs/shared/orca-progress-tabs.js +503 -0
  505. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  506. package/src/runs/shared/parallel-handoff.js +783 -0
  507. package/src/runs/shared/parallel-utils.d.ts +177 -0
  508. package/src/runs/shared/parallel-utils.js +125 -0
  509. package/src/runs/shared/partial-output.d.ts +24 -0
  510. package/src/runs/shared/partial-output.js +35 -0
  511. package/src/runs/shared/permissions.d.ts +12 -0
  512. package/src/runs/shared/permissions.js +92 -0
  513. package/src/runs/shared/pi-spawn.d.ts +31 -0
  514. package/src/runs/shared/pi-spawn.js +211 -0
  515. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  516. package/src/runs/shared/placed-run-owner.js +93 -0
  517. package/src/runs/shared/placement-host.d.ts +99 -0
  518. package/src/runs/shared/placement-host.js +157 -0
  519. package/src/runs/shared/process-signal.d.ts +15 -0
  520. package/src/runs/shared/process-signal.js +21 -0
  521. package/src/runs/shared/profile-extensions.d.ts +21 -0
  522. package/src/runs/shared/profile-extensions.js +122 -0
  523. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  524. package/src/runs/shared/profile-launch-env.js +90 -0
  525. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  526. package/src/runs/shared/readonly-drain-observation.js +50 -0
  527. package/src/runs/shared/rex-machine.d.ts +25 -0
  528. package/src/runs/shared/rex-machine.js +83 -0
  529. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  530. package/src/runs/shared/rex-pane-host.js +327 -0
  531. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  532. package/src/runs/shared/run-fanout-budget.js +258 -0
  533. package/src/runs/shared/run-ownership.d.ts +3 -0
  534. package/src/runs/shared/run-ownership.js +8 -0
  535. package/src/runs/shared/runner-launcher.d.ts +11 -0
  536. package/src/runs/shared/runner-launcher.js +24 -0
  537. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  538. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  539. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  540. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  541. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  542. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  543. package/src/runs/shared/session-lease.d.ts +69 -0
  544. package/src/runs/shared/session-lease.js +250 -0
  545. package/src/runs/shared/single-output.d.ts +90 -0
  546. package/src/runs/shared/single-output.js +349 -0
  547. package/src/runs/shared/spawn-budget.d.ts +20 -0
  548. package/src/runs/shared/spawn-budget.js +93 -0
  549. package/src/runs/shared/structured-output.d.ts +66 -0
  550. package/src/runs/shared/structured-output.js +483 -0
  551. package/src/runs/shared/subagent-control.d.ts +50 -0
  552. package/src/runs/shared/subagent-control.js +247 -0
  553. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  554. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  555. package/src/runs/shared/tool-availability.d.ts +16 -0
  556. package/src/runs/shared/tool-availability.js +29 -0
  557. package/src/runs/shared/tool-budget.d.ts +21 -0
  558. package/src/runs/shared/tool-budget.js +78 -0
  559. package/src/runs/shared/tool-timeout.d.ts +31 -0
  560. package/src/runs/shared/tool-timeout.js +73 -0
  561. package/src/runs/shared/usage-budget.d.ts +7 -0
  562. package/src/runs/shared/usage-budget.js +74 -0
  563. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  564. package/src/runs/shared/usage-reconciliation.js +71 -0
  565. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  566. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  567. package/src/runs/shared/workflow-graph.d.ts +31 -0
  568. package/src/runs/shared/workflow-graph.js +221 -0
  569. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  570. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  571. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  572. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  573. package/src/runs/shared/worktree-lock.d.ts +5 -0
  574. package/src/runs/shared/worktree-lock.js +40 -0
  575. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  576. package/src/runs/shared/worktree-setup-command.js +200 -0
  577. package/src/runs/shared/worktree.d.ts +181 -0
  578. package/src/runs/shared/worktree.js +1346 -0
  579. package/src/shared/accessible-dir.d.ts +11 -0
  580. package/src/shared/accessible-dir.js +39 -0
  581. package/src/shared/agent-stream-options.d.ts +5 -0
  582. package/src/shared/agent-stream-options.js +3 -0
  583. package/src/shared/artifacts.d.ts +22 -0
  584. package/src/shared/artifacts.js +272 -0
  585. package/src/shared/atomic-json.d.ts +19 -0
  586. package/src/shared/atomic-json.js +61 -0
  587. package/src/shared/capacity-resilient-json.d.ts +26 -0
  588. package/src/shared/capacity-resilient-json.js +86 -0
  589. package/src/shared/child-cache-retention.d.ts +29 -0
  590. package/src/shared/child-cache-retention.js +40 -0
  591. package/src/shared/child-session-name.d.ts +8 -0
  592. package/src/shared/child-session-name.js +40 -0
  593. package/src/shared/child-transcript.d.ts +37 -0
  594. package/src/shared/child-transcript.js +225 -0
  595. package/src/shared/completion-owner.d.ts +7 -0
  596. package/src/shared/completion-owner.js +13 -0
  597. package/src/shared/disabled-features.d.ts +93 -0
  598. package/src/shared/disabled-features.js +120 -0
  599. package/src/shared/display-text.d.ts +5 -0
  600. package/src/shared/display-text.js +154 -0
  601. package/src/shared/edit-distance.d.ts +4 -0
  602. package/src/shared/edit-distance.js +32 -0
  603. package/src/shared/extension-context.d.ts +21 -0
  604. package/src/shared/extension-context.js +39 -0
  605. package/src/shared/file-coalescer.d.ts +11 -0
  606. package/src/shared/file-coalescer.js +34 -0
  607. package/src/shared/file-lease.d.ts +10 -0
  608. package/src/shared/file-lease.js +106 -0
  609. package/src/shared/file-system-retry.d.ts +31 -0
  610. package/src/shared/file-system-retry.js +84 -0
  611. package/src/shared/fork-context.d.ts +64 -0
  612. package/src/shared/fork-context.js +185 -0
  613. package/src/shared/fork-session-cwd.d.ts +2 -0
  614. package/src/shared/fork-session-cwd.js +23 -0
  615. package/src/shared/formatters.d.ts +35 -0
  616. package/src/shared/formatters.js +137 -0
  617. package/src/shared/jsonl-writer.d.ts +20 -0
  618. package/src/shared/jsonl-writer.js +67 -0
  619. package/src/shared/launch-contract.d.ts +65 -0
  620. package/src/shared/launch-contract.js +145 -0
  621. package/src/shared/model-info.d.ts +55 -0
  622. package/src/shared/model-info.js +103 -0
  623. package/src/shared/model-response-aliases.d.ts +1 -0
  624. package/src/shared/model-response-aliases.js +15 -0
  625. package/src/shared/node-executable.d.ts +1 -0
  626. package/src/shared/node-executable.js +20 -0
  627. package/src/shared/opencode-session-headers.d.ts +12 -0
  628. package/src/shared/opencode-session-headers.js +26 -0
  629. package/src/shared/package-version.d.ts +2 -0
  630. package/src/shared/package-version.js +14 -0
  631. package/src/shared/parent-wake.d.ts +26 -0
  632. package/src/shared/parent-wake.js +68 -0
  633. package/src/shared/permission-profile.d.ts +26 -0
  634. package/src/shared/permission-profile.js +49 -0
  635. package/src/shared/prompt-resources.d.ts +5 -0
  636. package/src/shared/prompt-resources.js +10 -0
  637. package/src/shared/provider-diagnostics.d.ts +9 -0
  638. package/src/shared/provider-diagnostics.js +75 -0
  639. package/src/shared/pruned-fork.d.ts +34 -0
  640. package/src/shared/pruned-fork.js +434 -0
  641. package/src/shared/required-child-extensions.d.ts +34 -0
  642. package/src/shared/required-child-extensions.js +105 -0
  643. package/src/shared/runtime-module-path.d.ts +10 -0
  644. package/src/shared/runtime-module-path.js +16 -0
  645. package/src/shared/sandbox-profile.d.ts +12 -0
  646. package/src/shared/sandbox-profile.js +35 -0
  647. package/src/shared/session-file-trust.d.ts +1 -0
  648. package/src/shared/session-file-trust.js +20 -0
  649. package/src/shared/session-identity.d.ts +8 -0
  650. package/src/shared/session-identity.js +32 -0
  651. package/src/shared/session-succession.d.ts +4 -0
  652. package/src/shared/session-succession.js +24 -0
  653. package/src/shared/session-tokens.d.ts +2 -0
  654. package/src/shared/session-tokens.js +58 -0
  655. package/src/shared/settings-file-lease.d.ts +4 -0
  656. package/src/shared/settings-file-lease.js +38 -0
  657. package/src/shared/settings.d.ts +146 -0
  658. package/src/shared/settings.js +247 -0
  659. package/src/shared/shortcuts.d.ts +1 -0
  660. package/src/shared/shortcuts.js +17 -0
  661. package/src/shared/status-format.d.ts +9 -0
  662. package/src/shared/status-format.js +60 -0
  663. package/src/shared/thinking-ceiling.d.ts +13 -0
  664. package/src/shared/thinking-ceiling.js +37 -0
  665. package/src/shared/types.d.ts +2842 -0
  666. package/src/shared/types.js +276 -0
  667. package/src/shared/utf8.d.ts +5 -0
  668. package/src/shared/utf8.js +12 -0
  669. package/src/shared/utils.d.ts +83 -0
  670. package/src/shared/utils.js +612 -0
  671. package/src/shared/watch-strategy.d.ts +2 -0
  672. package/src/shared/watch-strategy.js +5 -0
  673. package/src/shared/workflow-child-permit.d.ts +58 -0
  674. package/src/shared/workflow-child-permit.js +159 -0
  675. package/src/slash/delegation-adapters.d.ts +154 -0
  676. package/src/slash/delegation-adapters.js +316 -0
  677. package/src/slash/delegation-json.d.ts +10 -0
  678. package/src/slash/delegation-json.js +117 -0
  679. package/src/slash/delegation-request.d.ts +12 -0
  680. package/src/slash/delegation-request.js +174 -0
  681. package/src/slash/prompt-template-bridge.d.ts +29 -0
  682. package/src/slash/prompt-template-bridge.js +399 -0
  683. package/src/slash/prompt-workflows.d.ts +21 -0
  684. package/src/slash/prompt-workflows.js +274 -0
  685. package/src/slash/selector.d.ts +47 -0
  686. package/src/slash/selector.js +117 -0
  687. package/src/slash/slash-bridge.d.ts +30 -0
  688. package/src/slash/slash-bridge.js +132 -0
  689. package/src/slash/slash-commands.d.ts +10 -0
  690. package/src/slash/slash-commands.js +1059 -0
  691. package/src/slash/slash-live-state.d.ts +21 -0
  692. package/src/slash/slash-live-state.js +263 -0
  693. package/src/slash/subagent-cost.d.ts +29 -0
  694. package/src/slash/subagent-cost.js +310 -0
  695. package/src/slash/subagents-admin.d.ts +3 -0
  696. package/src/slash/subagents-admin.js +481 -0
  697. package/src/tui/fleet-layout.d.ts +20 -0
  698. package/src/tui/fleet-layout.js +17 -0
  699. package/src/tui/fleet-native-transcript.d.ts +53 -0
  700. package/src/tui/fleet-native-transcript.js +339 -0
  701. package/src/tui/fleet-status.d.ts +92 -0
  702. package/src/tui/fleet-status.js +1132 -0
  703. package/src/tui/fleet-transcript.d.ts +64 -0
  704. package/src/tui/fleet-transcript.js +544 -0
  705. package/src/tui/fleet-viewport.d.ts +12 -0
  706. package/src/tui/fleet-viewport.js +35 -0
  707. package/src/tui/fleet.d.ts +196 -0
  708. package/src/tui/fleet.js +1588 -0
  709. package/src/tui/mouse-events.d.ts +21 -0
  710. package/src/tui/mouse-events.js +26 -0
  711. package/src/tui/render-helpers.d.ts +23 -0
  712. package/src/tui/render-helpers.js +100 -0
  713. package/src/tui/render.d.ts +66 -0
  714. package/src/tui/render.js +3707 -0
  715. package/src/tui/running-tone.d.ts +10 -0
  716. package/src/tui/running-tone.js +22 -0
  717. package/src/tui/subagent-messages.d.ts +22 -0
  718. package/src/tui/subagent-messages.js +270 -0
  719. package/src/ui-silent-marker.d.ts +20 -0
  720. package/src/ui-silent-marker.js +25 -0
  721. package/src/watchdog/change-signature.d.ts +7 -0
  722. package/src/watchdog/change-signature.js +243 -0
  723. package/src/watchdog/child-status.d.ts +53 -0
  724. package/src/watchdog/child-status.js +187 -0
  725. package/src/watchdog/diff-tool.d.ts +25 -0
  726. package/src/watchdog/diff-tool.js +104 -0
  727. package/src/watchdog/emission-guard.d.ts +36 -0
  728. package/src/watchdog/emission-guard.js +97 -0
  729. package/src/watchdog/guidance.d.ts +3 -0
  730. package/src/watchdog/guidance.js +19 -0
  731. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  732. package/src/watchdog/lsp-diagnostics.js +489 -0
  733. package/src/watchdog/model-selection.d.ts +24 -0
  734. package/src/watchdog/model-selection.js +167 -0
  735. package/src/watchdog/permission-arbiter.d.ts +20 -0
  736. package/src/watchdog/permission-arbiter.js +135 -0
  737. package/src/watchdog/register-child.d.ts +13 -0
  738. package/src/watchdog/register-child.js +128 -0
  739. package/src/watchdog/register-main.d.ts +11 -0
  740. package/src/watchdog/register-main.js +400 -0
  741. package/src/watchdog/render.d.ts +3 -0
  742. package/src/watchdog/render.js +33 -0
  743. package/src/watchdog/review.d.ts +36 -0
  744. package/src/watchdog/review.js +319 -0
  745. package/src/watchdog/rules.d.ts +21 -0
  746. package/src/watchdog/rules.js +58 -0
  747. package/src/watchdog/runtime.d.ts +195 -0
  748. package/src/watchdog/runtime.js +864 -0
  749. package/src/watchdog/scope.d.ts +14 -0
  750. package/src/watchdog/scope.js +44 -0
  751. package/src/watchdog/settings.d.ts +29 -0
  752. package/src/watchdog/settings.js +480 -0
  753. package/src/watchdog/tool-actions.d.ts +17 -0
  754. package/src/watchdog/tool-actions.js +150 -0
  755. package/src/watchdog/turn-delta.d.ts +15 -0
  756. package/src/watchdog/turn-delta.js +188 -0
  757. package/src/watchdog/types.d.ts +141 -0
  758. package/src/watchdog/types.js +27 -0
  759. package/src/watchdog/warning-format.d.ts +7 -0
  760. package/src/watchdog/warning-format.js +59 -0
  761. package/src/workflows/chat-progress.d.ts +37 -0
  762. package/src/workflows/chat-progress.js +129 -0
  763. package/src/workflows/host-command.d.ts +30 -0
  764. package/src/workflows/host-command.js +227 -0
  765. package/src/workflows/scripted-workflow.d.ts +204 -0
  766. package/src/workflows/scripted-workflow.js +1673 -0
  767. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  768. package/src/workflows/structured-workflow-scripts.js +179 -0
  769. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  770. package/src/workflows/workflow-auto-resume.js +102 -0
  771. package/src/workflows/workflow-checklist.d.ts +127 -0
  772. package/src/workflows/workflow-checklist.js +314 -0
  773. package/src/workflows/workflow-child-summary.d.ts +24 -0
  774. package/src/workflows/workflow-child-summary.js +195 -0
  775. package/src/workflows/workflow-launch-record.d.ts +27 -0
  776. package/src/workflows/workflow-launch-record.js +48 -0
  777. package/src/workflows/workflow-preflight.d.ts +58 -0
  778. package/src/workflows/workflow-preflight.js +288 -0
  779. package/src/workflows/workflow-receipt.d.ts +34 -0
  780. package/src/workflows/workflow-receipt.js +454 -0
  781. package/src/workflows/workflow-resources.d.ts +55 -0
  782. package/src/workflows/workflow-resources.js +271 -0
  783. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  784. package/src/workflows/workflow-resume-claim.js +210 -0
  785. package/src/workflows/workflow-resume.d.ts +56 -0
  786. package/src/workflows/workflow-resume.js +106 -0
  787. package/src/workflows/workflow-reuse.d.ts +61 -0
  788. package/src/workflows/workflow-reuse.js +186 -0
  789. package/src/workflows/workflow-revival.d.ts +33 -0
  790. package/src/workflows/workflow-revival.js +111 -0
  791. package/src/workflows/workflow-settlement.d.ts +84 -0
  792. package/src/workflows/workflow-settlement.js +203 -0
  793. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  794. package/src/workflows/workflow-stop-cause.js +8 -0
  795. package/workflow-script-worker.cjs +1342 -0
  796. package/index.ts +0 -18
  797. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  798. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  799. package/skills/pi-subagents/references/execution-controls.md +0 -561
  800. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  801. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  802. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  803. package/src/agents/advertised-agent-prompt.ts +0 -82
  804. package/src/agents/agent-eject.ts +0 -339
  805. package/src/agents/agent-management.ts +0 -1442
  806. package/src/agents/agent-memory.ts +0 -341
  807. package/src/agents/agent-refinements.ts +0 -624
  808. package/src/agents/agent-scope.ts +0 -10
  809. package/src/agents/agent-selection.ts +0 -25
  810. package/src/agents/agent-serializer.ts +0 -195
  811. package/src/agents/agents.ts +0 -3169
  812. package/src/agents/builtin-names.ts +0 -16
  813. package/src/agents/chain-serializer.ts +0 -285
  814. package/src/agents/frontmatter.ts +0 -153
  815. package/src/agents/global-npm-root.ts +0 -58
  816. package/src/agents/identity.ts +0 -30
  817. package/src/agents/proactive-skills.ts +0 -197
  818. package/src/agents/runtime-agent-events.ts +0 -70
  819. package/src/agents/runtime-agent-registry.ts +0 -457
  820. package/src/agents/runtime-discovery.ts +0 -39
  821. package/src/agents/skills.ts +0 -787
  822. package/src/api/agent-management.ts +0 -9
  823. package/src/api/agents.ts +0 -19
  824. package/src/api/background-work.ts +0 -206
  825. package/src/api/capability-ceiling.ts +0 -16
  826. package/src/api/child-tool-plan.ts +0 -5
  827. package/src/api/control-channel.ts +0 -4
  828. package/src/api/delegation.ts +0 -131
  829. package/src/api/external-job-provider.ts +0 -195
  830. package/src/api/external-runs.ts +0 -282
  831. package/src/api/inspectors.ts +0 -27
  832. package/src/api/intercom-bridge.ts +0 -3
  833. package/src/api/preflight.ts +0 -641
  834. package/src/api/project-panes.ts +0 -32
  835. package/src/api/required-child-extensions.ts +0 -6
  836. package/src/api/shared-types.ts +0 -29
  837. package/src/api/supervisor-routing.ts +0 -196
  838. package/src/api/workflow-resources.ts +0 -6
  839. package/src/extension/config.ts +0 -262
  840. package/src/extension/context-injection.ts +0 -123
  841. package/src/extension/control-notices.ts +0 -53
  842. package/src/extension/declaration-pinning.ts +0 -164
  843. package/src/extension/doctor.ts +0 -284
  844. package/src/extension/fanout-child.ts +0 -282
  845. package/src/extension/herdr-pi-bridge.ts +0 -166
  846. package/src/extension/index.ts +0 -1212
  847. package/src/extension/public-execution.ts +0 -262
  848. package/src/extension/reply-workflow-script.ts +0 -67
  849. package/src/extension/rpc.ts +0 -881
  850. package/src/extension/schemas.ts +0 -337
  851. package/src/extension/steering-notices.ts +0 -35
  852. package/src/extension/subagent-guide.ts +0 -127
  853. package/src/extension/subagent-options.ts +0 -47
  854. package/src/extension/tool-activation.ts +0 -147
  855. package/src/extension/tool-description.ts +0 -193
  856. package/src/extension/tool-result.ts +0 -19
  857. package/src/extension/upgrade-notice.ts +0 -40
  858. package/src/inspectors/actions.ts +0 -174
  859. package/src/inspectors/ghostty/actions.ts +0 -74
  860. package/src/inspectors/ghostty/plugin.ts +0 -29
  861. package/src/inspectors/herdr/actions.ts +0 -155
  862. package/src/inspectors/herdr/client.ts +0 -130
  863. package/src/inspectors/herdr/focus.ts +0 -55
  864. package/src/inspectors/herdr/plugin.ts +0 -20
  865. package/src/inspectors/herdr/project-panes.ts +0 -733
  866. package/src/inspectors/inspector-runner.ts +0 -153
  867. package/src/inspectors/plugins.ts +0 -76
  868. package/src/inspectors/session-roots-codec.ts +0 -31
  869. package/src/inspectors/shell-command.ts +0 -16
  870. package/src/inspectors/tmux/actions.ts +0 -204
  871. package/src/inspectors/tmux/client.ts +0 -85
  872. package/src/inspectors/tmux/plugin.ts +0 -21
  873. package/src/inspectors/types.ts +0 -51
  874. package/src/integrations/herdr-status.ts +0 -385
  875. package/src/integrations/pi-web-session-liveness.ts +0 -73
  876. package/src/integrations/program-status.ts +0 -215
  877. package/src/intercom/fork-supervisor-routing.ts +0 -533
  878. package/src/intercom/intercom-bridge.ts +0 -235
  879. package/src/intercom/native-supervisor-channel.ts +0 -1066
  880. package/src/intercom/result-intercom.ts +0 -433
  881. package/src/intercom/supervisor-ui.ts +0 -72
  882. package/src/missions/actions.ts +0 -433
  883. package/src/missions/goal-driver.ts +0 -177
  884. package/src/missions/lifecycle.ts +0 -367
  885. package/src/missions/store.ts +0 -613
  886. package/src/missions/types.ts +0 -190
  887. package/src/missions/workflow-state.ts +0 -281
  888. package/src/policy/authority.ts +0 -50
  889. package/src/profiles/profiles.ts +0 -674
  890. package/src/runs/background/active-async-capacity.ts +0 -548
  891. package/src/runs/background/active-run-index.ts +0 -155
  892. package/src/runs/background/async-execution.ts +0 -2479
  893. package/src/runs/background/async-job-tracker.ts +0 -869
  894. package/src/runs/background/async-resume.ts +0 -686
  895. package/src/runs/background/async-retention.ts +0 -953
  896. package/src/runs/background/async-status-snapshot.ts +0 -46
  897. package/src/runs/background/async-status.ts +0 -787
  898. package/src/runs/background/auto-drain.ts +0 -92
  899. package/src/runs/background/await-async-run.ts +0 -83
  900. package/src/runs/background/binary-bootstrap.ts +0 -67
  901. package/src/runs/background/calendar-schedule.ts +0 -90
  902. package/src/runs/background/chain-append.ts +0 -321
  903. package/src/runs/background/chain-root-attachment.ts +0 -263
  904. package/src/runs/background/completion-batcher.ts +0 -168
  905. package/src/runs/background/completion-dedupe.ts +0 -58
  906. package/src/runs/background/completion-replay.ts +0 -287
  907. package/src/runs/background/control-channel.ts +0 -659
  908. package/src/runs/background/fleet-view.ts +0 -692
  909. package/src/runs/background/index-segment.ts +0 -59
  910. package/src/runs/background/inspect-rpc.ts +0 -443
  911. package/src/runs/background/notify.ts +0 -1083
  912. package/src/runs/background/owned-process-tree.ts +0 -131
  913. package/src/runs/background/parallel-groups.ts +0 -45
  914. package/src/runs/background/pid-namespace.ts +0 -18
  915. package/src/runs/background/process-terminal-candidate.ts +0 -98
  916. package/src/runs/background/process-terminal.ts +0 -231
  917. package/src/runs/background/result-delivery-ownership.ts +0 -45
  918. package/src/runs/background/result-files.ts +0 -634
  919. package/src/runs/background/result-watcher.ts +0 -842
  920. package/src/runs/background/resume-guidance.ts +0 -56
  921. package/src/runs/background/retained-children.ts +0 -136
  922. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  923. package/src/runs/background/run-child-session.ts +0 -725
  924. package/src/runs/background/run-id-query.ts +0 -7
  925. package/src/runs/background/run-id-resolver.ts +0 -183
  926. package/src/runs/background/run-status.ts +0 -803
  927. package/src/runs/background/runner-aliases.ts +0 -183
  928. package/src/runs/background/runner-child-launch.ts +0 -96
  929. package/src/runs/background/runner-child-sessions.ts +0 -32
  930. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  931. package/src/runs/background/runner-startup-failure.ts +0 -56
  932. package/src/runs/background/scheduled-runs.ts +0 -1222
  933. package/src/runs/background/stale-run-reconciler.ts +0 -463
  934. package/src/runs/background/steering.ts +0 -260
  935. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  936. package/src/runs/background/subagent-runner.ts +0 -5251
  937. package/src/runs/background/subagent-wait.ts +0 -895
  938. package/src/runs/background/terminal-run-index.ts +0 -183
  939. package/src/runs/background/top-level-async.ts +0 -14
  940. package/src/runs/background/wait-completions.ts +0 -262
  941. package/src/runs/background/wait-config.ts +0 -50
  942. package/src/runs/background/wait-subscriptions.ts +0 -354
  943. package/src/runs/background/wait-tool.ts +0 -57
  944. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  945. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  946. package/src/runs/foreground/async-steering-action.ts +0 -276
  947. package/src/runs/foreground/async-stop-action.ts +0 -216
  948. package/src/runs/foreground/command-action.ts +0 -41
  949. package/src/runs/foreground/execution.ts +0 -2315
  950. package/src/runs/foreground/foreground-control.ts +0 -157
  951. package/src/runs/foreground/foreground-history.ts +0 -164
  952. package/src/runs/foreground/prompt-audit.ts +0 -172
  953. package/src/runs/foreground/subagent-executor.ts +0 -8252
  954. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  955. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  956. package/src/runs/shared/abort-recovery.ts +0 -119
  957. package/src/runs/shared/acceptance.ts +0 -1664
  958. package/src/runs/shared/agent-contract.ts +0 -38
  959. package/src/runs/shared/async-status-projection.ts +0 -664
  960. package/src/runs/shared/background-process-options.ts +0 -9
  961. package/src/runs/shared/capability-ceiling.ts +0 -214
  962. package/src/runs/shared/chain-outputs.ts +0 -116
  963. package/src/runs/shared/child-commands.ts +0 -229
  964. package/src/runs/shared/child-hooks.ts +0 -175
  965. package/src/runs/shared/child-identity.ts +0 -62
  966. package/src/runs/shared/child-launch-plan.ts +0 -163
  967. package/src/runs/shared/child-launch.ts +0 -389
  968. package/src/runs/shared/child-lifecycle.ts +0 -28
  969. package/src/runs/shared/child-runtime-config.ts +0 -136
  970. package/src/runs/shared/child-session.ts +0 -699
  971. package/src/runs/shared/child-tool-plan.ts +0 -599
  972. package/src/runs/shared/claude-code-adapter.ts +0 -288
  973. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  974. package/src/runs/shared/context-mode.ts +0 -44
  975. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  976. package/src/runs/shared/dynamic-fanout.ts +0 -297
  977. package/src/runs/shared/effective-system-prompt.ts +0 -33
  978. package/src/runs/shared/extension-bindings.ts +0 -103
  979. package/src/runs/shared/external-cli-contract.ts +0 -177
  980. package/src/runs/shared/external-cli-preflight.ts +0 -190
  981. package/src/runs/shared/external-cli-runner.ts +0 -437
  982. package/src/runs/shared/external-job-bridge.ts +0 -514
  983. package/src/runs/shared/external-job-runner.ts +0 -389
  984. package/src/runs/shared/fast-mode-extension.ts +0 -10
  985. package/src/runs/shared/fork-command-result.ts +0 -10
  986. package/src/runs/shared/git-environment.ts +0 -29
  987. package/src/runs/shared/herdr-connection.ts +0 -134
  988. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  989. package/src/runs/shared/herdr-machine.ts +0 -279
  990. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  991. package/src/runs/shared/herdr-placed-run.ts +0 -264
  992. package/src/runs/shared/host-step-status.ts +0 -231
  993. package/src/runs/shared/lane-metadata.ts +0 -126
  994. package/src/runs/shared/launch-cwd.ts +0 -16
  995. package/src/runs/shared/long-running-guard.ts +0 -221
  996. package/src/runs/shared/mcp-config-sources.ts +0 -426
  997. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  998. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  999. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  1000. package/src/runs/shared/model-resolution.ts +0 -503
  1001. package/src/runs/shared/model-scope.ts +0 -224
  1002. package/src/runs/shared/mutation-evidence.ts +0 -199
  1003. package/src/runs/shared/nested-events.ts +0 -1125
  1004. package/src/runs/shared/nested-path.ts +0 -38
  1005. package/src/runs/shared/nested-render.ts +0 -127
  1006. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1007. package/src/runs/shared/parallel-handoff.ts +0 -789
  1008. package/src/runs/shared/parallel-utils.ts +0 -292
  1009. package/src/runs/shared/partial-output.ts +0 -48
  1010. package/src/runs/shared/permissions.ts +0 -86
  1011. package/src/runs/shared/pi-spawn.ts +0 -205
  1012. package/src/runs/shared/process-signal.ts +0 -35
  1013. package/src/runs/shared/profile-extensions.ts +0 -134
  1014. package/src/runs/shared/profile-launch-env.ts +0 -121
  1015. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1016. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1017. package/src/runs/shared/run-history.ts +0 -288
  1018. package/src/runs/shared/runner-launcher.ts +0 -25
  1019. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1020. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1021. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1022. package/src/runs/shared/session-lease.ts +0 -293
  1023. package/src/runs/shared/single-output.ts +0 -366
  1024. package/src/runs/shared/spawn-budget.ts +0 -128
  1025. package/src/runs/shared/structured-output.ts +0 -463
  1026. package/src/runs/shared/subagent-control.ts +0 -295
  1027. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1028. package/src/runs/shared/tool-availability.ts +0 -37
  1029. package/src/runs/shared/tool-budget.ts +0 -87
  1030. package/src/runs/shared/tool-timeout.ts +0 -93
  1031. package/src/runs/shared/usage-budget.ts +0 -65
  1032. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1033. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1034. package/src/runs/shared/workflow-graph.ts +0 -225
  1035. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1036. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1037. package/src/runs/shared/worktree-lock.ts +0 -29
  1038. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1039. package/src/runs/shared/worktree.ts +0 -1554
  1040. package/src/shared/accessible-dir.ts +0 -47
  1041. package/src/shared/agent-stream-options.ts +0 -5
  1042. package/src/shared/artifacts.ts +0 -281
  1043. package/src/shared/atomic-json.ts +0 -85
  1044. package/src/shared/capacity-resilient-json.ts +0 -102
  1045. package/src/shared/child-cache-retention.ts +0 -43
  1046. package/src/shared/child-session-name.ts +0 -48
  1047. package/src/shared/child-transcript.ts +0 -264
  1048. package/src/shared/completion-owner.ts +0 -14
  1049. package/src/shared/disabled-features.ts +0 -123
  1050. package/src/shared/display-text.ts +0 -150
  1051. package/src/shared/edit-distance.ts +0 -33
  1052. package/src/shared/extension-context.ts +0 -37
  1053. package/src/shared/file-coalescer.ts +0 -49
  1054. package/src/shared/file-lease.ts +0 -74
  1055. package/src/shared/file-system-retry.ts +0 -95
  1056. package/src/shared/fork-context.ts +0 -243
  1057. package/src/shared/fork-session-cwd.ts +0 -27
  1058. package/src/shared/formatters.ts +0 -142
  1059. package/src/shared/jsonl-writer.ts +0 -92
  1060. package/src/shared/launch-contract.ts +0 -206
  1061. package/src/shared/model-info.ts +0 -132
  1062. package/src/shared/model-response-aliases.ts +0 -13
  1063. package/src/shared/node-executable.ts +0 -21
  1064. package/src/shared/opencode-session-headers.ts +0 -30
  1065. package/src/shared/package-version.ts +0 -17
  1066. package/src/shared/parent-wake.ts +0 -79
  1067. package/src/shared/permission-profile.ts +0 -56
  1068. package/src/shared/prompt-resources.ts +0 -11
  1069. package/src/shared/pruned-fork.ts +0 -469
  1070. package/src/shared/required-child-extensions.ts +0 -115
  1071. package/src/shared/runtime-module-path.ts +0 -19
  1072. package/src/shared/sandbox-profile.ts +0 -37
  1073. package/src/shared/session-file-trust.ts +0 -19
  1074. package/src/shared/session-identity.ts +0 -10
  1075. package/src/shared/session-tokens.ts +0 -55
  1076. package/src/shared/settings-file-lease.ts +0 -36
  1077. package/src/shared/settings.ts +0 -412
  1078. package/src/shared/shortcuts.ts +0 -13
  1079. package/src/shared/status-format.ts +0 -55
  1080. package/src/shared/thinking-ceiling.ts +0 -46
  1081. package/src/shared/types.ts +0 -3105
  1082. package/src/shared/utf8.ts +0 -11
  1083. package/src/shared/utils.ts +0 -610
  1084. package/src/shared/watch-strategy.ts +0 -12
  1085. package/src/shared/workflow-child-permit.ts +0 -212
  1086. package/src/slash/delegation-adapters.ts +0 -452
  1087. package/src/slash/delegation-json.ts +0 -108
  1088. package/src/slash/delegation-request.ts +0 -176
  1089. package/src/slash/prompt-template-bridge.ts +0 -435
  1090. package/src/slash/prompt-workflows.ts +0 -298
  1091. package/src/slash/selector.ts +0 -147
  1092. package/src/slash/slash-bridge.ts +0 -192
  1093. package/src/slash/slash-commands.ts +0 -1096
  1094. package/src/slash/slash-live-state.ts +0 -310
  1095. package/src/slash/subagent-cost.ts +0 -317
  1096. package/src/slash/subagents-admin.ts +0 -489
  1097. package/src/tui/fleet-native-transcript.ts +0 -424
  1098. package/src/tui/fleet-status.ts +0 -1139
  1099. package/src/tui/fleet-transcript.ts +0 -591
  1100. package/src/tui/fleet.ts +0 -1618
  1101. package/src/tui/mouse-events.ts +0 -42
  1102. package/src/tui/render-helpers.ts +0 -111
  1103. package/src/tui/render.ts +0 -3824
  1104. package/src/tui/running-tone.ts +0 -28
  1105. package/src/tui/subagent-messages.ts +0 -305
  1106. package/src/ui-silent-marker.ts +0 -32
  1107. package/src/watchdog/change-signature.ts +0 -260
  1108. package/src/watchdog/child-status.ts +0 -225
  1109. package/src/watchdog/diff-tool.ts +0 -112
  1110. package/src/watchdog/emission-guard.ts +0 -125
  1111. package/src/watchdog/guidance.ts +0 -20
  1112. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1113. package/src/watchdog/model-selection.ts +0 -187
  1114. package/src/watchdog/permission-arbiter.ts +0 -154
  1115. package/src/watchdog/register-child.ts +0 -136
  1116. package/src/watchdog/register-main.ts +0 -425
  1117. package/src/watchdog/render.ts +0 -31
  1118. package/src/watchdog/review.ts +0 -362
  1119. package/src/watchdog/rules.ts +0 -70
  1120. package/src/watchdog/runtime.ts +0 -927
  1121. package/src/watchdog/scope.ts +0 -51
  1122. package/src/watchdog/settings.ts +0 -520
  1123. package/src/watchdog/tool-actions.ts +0 -156
  1124. package/src/watchdog/turn-delta.ts +0 -190
  1125. package/src/watchdog/types.ts +0 -186
  1126. package/src/watchdog/warning-format.ts +0 -72
  1127. package/src/workflows/chat-progress.ts +0 -152
  1128. package/src/workflows/host-command.ts +0 -235
  1129. package/src/workflows/scripted-workflow.ts +0 -2733
  1130. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1131. package/src/workflows/workflow-checklist.ts +0 -442
  1132. package/src/workflows/workflow-child-summary.ts +0 -172
  1133. package/src/workflows/workflow-preflight.ts +0 -297
  1134. package/src/workflows/workflow-receipt.ts +0 -390
  1135. package/src/workflows/workflow-resources.ts +0 -275
  1136. package/src/workflows/workflow-reuse.ts +0 -120
  1137. package/src/workflows/workflow-revival.ts +0 -123
  1138. package/src/workflows/workflow-settlement.ts +0 -252
@@ -1,1664 +0,0 @@
1
- import { spawn } from "node:child_process";
2
- import { spawnSync } from "node:child_process";
3
- import { createHash } from "node:crypto";
4
- import * as fs from "node:fs";
5
- import * as path from "node:path";
6
- import type {
7
- AcceptanceConfig,
8
- AcceptanceEvidenceKind,
9
- AcceptanceInput,
10
- AgentContract,
11
- AcceptanceLedger,
12
- AcceptanceLevel,
13
- AcceptanceReport,
14
- AcceptanceReviewGate,
15
- AcceptanceRole,
16
- AcceptanceRuntimeCheck,
17
- AcceptanceRuntimeCheckStatus,
18
- AcceptanceReviewResult,
19
- AcceptanceVerifyCommand,
20
- AcceptanceVerifyResult,
21
- JsonSchemaObject,
22
- ResolvedAcceptanceConfig,
23
- ResolvedAcceptanceGate,
24
- SingleResult,
25
- SubagentRunMode,
26
- ChildWatchdogProgress,
27
- } from "../../shared/types.ts";
28
- import { unresolvedChildWatchdogBlockers } from "../../watchdog/child-status.ts";
29
- import { isAgentContract } from "./agent-contract.ts";
30
- import { validateStructuredOutputValue } from "./structured-output.ts";
31
-
32
- const LEVEL_RANK: Record<Exclude<AcceptanceLevel, "auto">, number> = {
33
- none: 0,
34
- attested: 1,
35
- checked: 2,
36
- verified: 3,
37
- };
38
-
39
- const VALID_LEVELS = new Set<AcceptanceLevel>(["auto", "none", "attested", "checked", "verified"]);
40
- const VALID_EVIDENCE_KINDS: AcceptanceEvidenceKind[] = [
41
- "changed-files",
42
- "tests-added",
43
- "commands-run",
44
- "validation-output",
45
- "residual-risks",
46
- "no-staged-files",
47
- "diff-summary",
48
- "review-findings",
49
- "manual-notes",
50
- ];
51
- const VALID_EVIDENCE = new Set<AcceptanceEvidenceKind>(VALID_EVIDENCE_KINDS);
52
- const ACCEPTANCE_EVIDENCE_HELP = `Supported evidence kinds: ${VALID_EVIDENCE_KINDS.join(", ")}. Example: { level: "checked", evidence: ["commands-run", "changed-files"] }.`;
53
- const ACCEPTANCE_OBJECT_EXAMPLE = "Example: { level: \"checked\", evidence: [\"commands-run\", \"changed-files\"] }.";
54
- const ACCEPTANCE_CONFIG_KEYS = new Set(["level", "report", "preserveStagedIndex", "criteria", "evidence", "verify", "review", "stopRules", "reason"]);
55
- const ACCEPTANCE_GATE_KEYS = new Set(["id", "must", "evidence", "severity"]);
56
- const ACCEPTANCE_VERIFY_KEYS = new Set(["id", "command", "timeoutMs", "cwd", "env", "allowFailure", "output", "schema"]);
57
- const ACCEPTANCE_REVIEW_KEYS = new Set(["agent", "focus", "required"]);
58
- const EXPLICIT_REVIEWED_UNAVAILABLE = "is an achieved status, not a requestable acceptance level. For a read-only reviewer call, omit acceptance. To require independent review of a writer result, use acceptance.review.required and orchestrate the reviewer separately.";
59
-
60
- function normalizeLevel(level: AcceptanceLevel | undefined): Exclude<AcceptanceLevel, "auto"> | "auto" {
61
- return level ?? "auto";
62
- }
63
-
64
- function unique<T>(items: T[]): T[] {
65
- return [...new Set(items)];
66
- }
67
-
68
- function requiredEvidenceForLevel(level: Exclude<AcceptanceLevel, "auto">): AcceptanceEvidenceKind[] {
69
- switch (level) {
70
- case "none":
71
- return [];
72
- case "attested":
73
- return ["manual-notes", "residual-risks"];
74
- case "checked":
75
- return ["changed-files", "tests-added", "commands-run", "residual-risks", "no-staged-files"];
76
- case "verified":
77
- return ["changed-files", "tests-added", "commands-run", "validation-output", "residual-risks", "no-staged-files"];
78
- }
79
- }
80
-
81
- function inferLevel(input: {
82
- agentName: string;
83
- acceptanceRole?: AcceptanceRole;
84
- task?: string;
85
- mode?: SubagentRunMode;
86
- async?: boolean;
87
- dynamic?: boolean;
88
- dynamicGroup?: boolean;
89
- }): { level: Exclude<AcceptanceLevel, "auto">; reasons: string[]; criteria: string[]; evidence: AcceptanceEvidenceKind[]; review?: { agent?: string; required?: boolean } } {
90
- if (input.acceptanceRole === "writer" && (input.async || input.dynamic || input.dynamicGroup)) {
91
- const reasons = [input.async ? "async declared writer" : "dynamic declared writer"];
92
- if (input.dynamic || input.dynamicGroup) reasons.push("dynamic fanout context");
93
- return {
94
- level: "checked",
95
- reasons,
96
- criteria: ["Implement the requested change without widening scope", "Return evidence sufficient for an independent acceptance review"],
97
- evidence: requiredEvidenceForLevel("checked"),
98
- review: { agent: "reviewer", required: true },
99
- };
100
- }
101
- if (input.acceptanceRole === "writer") {
102
- return {
103
- level: "checked",
104
- reasons: ["declared writer acceptance role"],
105
- criteria: ["Implement the requested change without widening scope"],
106
- evidence: requiredEvidenceForLevel("checked"),
107
- };
108
- }
109
- if (input.acceptanceRole === "read-only") {
110
- return {
111
- level: "none",
112
- reasons: ["declared read-only acceptance role"],
113
- criteria: ["Return concrete findings with file paths and severity when applicable"],
114
- evidence: ["review-findings", "residual-risks"],
115
- };
116
- }
117
- return {
118
- level: "attested",
119
- reasons: ["default lightweight attestation"],
120
- criteria: ["Return a concise result and residual risks when applicable"],
121
- evidence: ["manual-notes", "residual-risks"],
122
- };
123
- }
124
-
125
- type AcceptanceInputNormalizationResult = { value: unknown; error?: string };
126
-
127
- function normalizeAcceptanceValue(input: unknown, pathLabel = "acceptance"): AcceptanceInputNormalizationResult {
128
- if (typeof input !== "string") return { value: input };
129
- const trimmed = input.trim();
130
- if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return { value: input };
131
- let parsed: unknown;
132
- try {
133
- parsed = JSON.parse(trimmed);
134
- } catch (error) {
135
- return {
136
- value: input,
137
- error: `${pathLabel} JSON string must encode a valid acceptance object: ${error instanceof Error ? error.message : String(error)}`,
138
- };
139
- }
140
- if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
141
- const kind = parsed === null ? "null" : Array.isArray(parsed) ? "an array" : typeof parsed;
142
- return { value: input, error: `${pathLabel} JSON string must encode an object; got ${kind}.` };
143
- }
144
- return { value: parsed };
145
- }
146
-
147
- export function normalizeAcceptanceInput(input: unknown): AcceptanceConfig {
148
- const normalized = normalizeAcceptanceValue(input);
149
- if (normalized.error) throw new Error(normalized.error);
150
- input = normalized.value;
151
- if (input === undefined || input === "auto") return { level: "auto" };
152
- if (input === false) return { level: "none", reason: "disabled by deprecated false shorthand" };
153
- if (typeof input === "string") return { level: input as AcceptanceConfig["level"] };
154
- return { ...(input as AcceptanceConfig) };
155
- }
156
-
157
- export type ResolvedAcceptanceReportMode = "off" | "optional" | "required";
158
-
159
- export function resolveAcceptanceReportMode(input: unknown): ResolvedAcceptanceReportMode {
160
- const normalized = normalizeAcceptanceValue(input);
161
- if (normalized.error) throw new Error(normalized.error);
162
- const value = normalized.value;
163
- const report = value && typeof value === "object" && !Array.isArray(value) ? (value as AcceptanceConfig).report : undefined;
164
- return value === false || report === "off" ? "off" : report === "on" ? "required" : "optional";
165
- }
166
-
167
- type GateAcceptanceNormalizationResult =
168
- | { ok: true; acceptance?: AcceptanceInput }
169
- | { ok: false; error: string };
170
-
171
- const GATE_OBJECT_KEYS = new Set(["command", "output", "schema", "timeoutMs"]);
172
- export const GATE_INPUT_ERROR = "gate must be a non-empty command string or { command, output?: \"json\", schema?, timeoutMs? }.";
173
-
174
- export interface GateObjectInput {
175
- command: string;
176
- output?: "json";
177
- schema?: JsonSchemaObject;
178
- timeoutMs?: number;
179
- }
180
-
181
- /** Validates the two accepted gate shapes without normalizing them. Shared by preflight and the workflow sandbox mirror. */
182
- export function parseGateInput(gate: unknown): { ok: true; gate: GateObjectInput } | { ok: false; error: string } {
183
- if (typeof gate === "string") {
184
- return gate.trim() ? { ok: true, gate: { command: gate.trim() } } : { ok: false, error: GATE_INPUT_ERROR };
185
- }
186
- if (!gate || typeof gate !== "object" || Array.isArray(gate)) return { ok: false, error: GATE_INPUT_ERROR };
187
- const value = gate as Record<string, unknown>;
188
- for (const key of Object.keys(value)) {
189
- if (!GATE_OBJECT_KEYS.has(key)) return { ok: false, error: `gate.${key} is not supported.` };
190
- }
191
- if (typeof value.command !== "string" || !value.command.trim()) return { ok: false, error: GATE_INPUT_ERROR };
192
- if (value.output !== undefined && value.output !== "json") return { ok: false, error: "gate.output must be \"json\" when present." };
193
- if (value.schema !== undefined) {
194
- if (value.output !== "json") return { ok: false, error: "gate.schema requires gate.output: \"json\"." };
195
- if (!value.schema || typeof value.schema !== "object" || Array.isArray(value.schema)) return { ok: false, error: "gate.schema must be a JSON Schema object." };
196
- }
197
- if (value.timeoutMs !== undefined && (!Number.isInteger(value.timeoutMs) || (value.timeoutMs as number) < 1)) return { ok: false, error: "gate.timeoutMs must be an integer >= 1." };
198
- const parsed: GateObjectInput = { command: value.command.trim() };
199
- if (value.output === "json") parsed.output = "json";
200
- // SAFETY: schema was checked above to be a non-array object; timeoutMs to be an integer >= 1.
201
- if (value.schema !== undefined) parsed.schema = value.schema as JsonSchemaObject;
202
- if (value.timeoutMs !== undefined) parsed.timeoutMs = value.timeoutMs as number;
203
- return { ok: true, gate: parsed };
204
- }
205
-
206
- /** True when an acceptance policy declares at least one `output: "json"` verify command, from either the gate shorthand or an explicit verify list. */
207
- export function acceptanceHasTypedVerify(acceptance: AcceptanceInput | undefined): boolean {
208
- if (!acceptance || typeof acceptance !== "object") return false;
209
- return Array.isArray(acceptance.verify) && acceptance.verify.some((command) => command && typeof command === "object" && command.output === "json");
210
- }
211
-
212
- export const TYPED_VERIFY_OUTPUT_SCHEMA_CONFLICT = "a typed verify command (output: \"json\") cannot be combined with outputSchema; the child would have two structured-output sources.";
213
-
214
- export function normalizeGateAcceptance(gate: unknown, acceptance: AcceptanceInput | undefined): GateAcceptanceNormalizationResult {
215
- if (gate === undefined) {
216
- if (acceptance === undefined) return { ok: true };
217
- const normalized = normalizeAcceptanceValue(acceptance);
218
- return normalized.error ? { ok: false, error: normalized.error } : { ok: true, acceptance: normalized.value as AcceptanceInput };
219
- }
220
- const parsed = parseGateInput(gate);
221
- if (!parsed.ok) return { ok: false, error: parsed.error };
222
- if (acceptance !== undefined && acceptance !== false) return { ok: false, error: "gate cannot be combined with acceptance; use one gate command or acceptance.verify." + describeGateAcceptanceConflict(gate, acceptance) };
223
- return { ok: true, acceptance: { level: "verified", verify: [{ id: "gate", ...parsed.gate }] } };
224
- }
225
-
226
- export function describeGateAcceptanceConflict(gate: unknown, acceptance: unknown): string {
227
- const render = (value: unknown): string => {
228
- let encoded: string;
229
- try {
230
- encoded = JSON.stringify(value) ?? String(value);
231
- } catch {
232
- encoded = String(value);
233
- }
234
- return encoded.length > 120 ? `${encoded.slice(0, 120)}...` : encoded;
235
- };
236
- return ` Both fields were present: gate=${render(gate)} acceptance=${render(acceptance)}.`;
237
- }
238
-
239
- function explicitAcceptanceCanDisable(explicit: AcceptanceConfig): boolean {
240
- return explicit.level === "none" && typeof explicit.reason === "string" && explicit.reason.trim().length > 0;
241
- }
242
-
243
- function explicitAcceptanceRequestsPolicy(explicit: AcceptanceConfig): boolean {
244
- return (explicit.level !== undefined && explicit.level !== "auto") || Object.keys(explicit).some((key) => key !== "level");
245
- }
246
-
247
- function unsupportedEvidenceKindMessage(pathLabel: string, item: unknown): string {
248
- const value = typeof item === "string" ? ` "${item}"` : "";
249
- return `${pathLabel}${value} is not a supported evidence kind. ${ACCEPTANCE_EVIDENCE_HELP}`;
250
- }
251
-
252
- export function validateAcceptanceInput(input: unknown, pathLabel = "acceptance"): string[] {
253
- const errors: string[] = [];
254
- if (input === undefined) return errors;
255
- if (input === false) return errors;
256
- const normalized = normalizeAcceptanceValue(input, pathLabel);
257
- if (normalized.error) return [normalized.error];
258
- input = normalized.value;
259
- if (typeof input === "string") {
260
- if (input === "reviewed") errors.push(`${pathLabel} ${EXPLICIT_REVIEWED_UNAVAILABLE}`);
261
- else if (!VALID_LEVELS.has(input as AcceptanceLevel)) errors.push(`${pathLabel} has invalid level '${input}'.`);
262
- else if (input === "none") errors.push(`${pathLabel} level "none" requires a reason; use { level: "none", reason: "..." }.`);
263
- else if (input === "verified") errors.push(`${pathLabel} level "verified" requires object form with at least one runtime verify command. Use level "checked" or provide a non-empty acceptance.verify array.`);
264
- return errors;
265
- }
266
- if (!input || typeof input !== "object" || Array.isArray(input)) {
267
- errors.push(`${pathLabel} must be a string level, false, or an object. ${ACCEPTANCE_OBJECT_EXAMPLE}`);
268
- return errors;
269
- }
270
- const value = input as Record<string, unknown>;
271
- for (const key of Object.keys(value)) {
272
- if (!ACCEPTANCE_CONFIG_KEYS.has(key)) errors.push(`${pathLabel}.${key} is not supported.`);
273
- }
274
- if (value.level === "reviewed") {
275
- errors.push(`${pathLabel}.level ${EXPLICIT_REVIEWED_UNAVAILABLE}`);
276
- } else if (value.level !== undefined && (typeof value.level !== "string" || !VALID_LEVELS.has(value.level as AcceptanceLevel))) {
277
- errors.push(`${pathLabel}.level must be one of auto, none, attested, checked, verified.`);
278
- }
279
- if (value.report !== undefined && value.report !== "on" && value.report !== "off") {
280
- errors.push(`${pathLabel}.report must be on or off.`);
281
- }
282
- if (value.preserveStagedIndex !== undefined && value.preserveStagedIndex !== true) {
283
- errors.push(`${pathLabel}.preserveStagedIndex must be true when provided.`);
284
- }
285
- if (value.preserveStagedIndex === true && value.level !== "checked" && value.level !== "verified") {
286
- errors.push(`${pathLabel}.preserveStagedIndex requires level checked or verified.`);
287
- }
288
- if (value.level === "none" && (typeof value.reason !== "string" || !value.reason.trim())) {
289
- errors.push(`${pathLabel}.reason is required when level is none.`);
290
- }
291
- if (value.reason !== undefined && typeof value.reason !== "string") errors.push(`${pathLabel}.reason must be a string.`);
292
- if (value.criteria !== undefined && !Array.isArray(value.criteria)) errors.push(`${pathLabel}.criteria must be an array.`);
293
- if (Array.isArray(value.criteria)) {
294
- const criterionIds = new Set<string>();
295
- for (const [index, criterion] of value.criteria.entries()) {
296
- if (typeof criterion === "string") continue;
297
- const criterionPath = `${pathLabel}.criteria[${index}]`;
298
- if (!criterion || typeof criterion !== "object" || Array.isArray(criterion)) {
299
- errors.push(`${criterionPath} must be a string or an object.`);
300
- continue;
301
- }
302
- const gate = criterion as Record<string, unknown>;
303
- for (const key of Object.keys(gate)) {
304
- if (!ACCEPTANCE_GATE_KEYS.has(key)) errors.push(`${criterionPath}.${key} is not supported.`);
305
- }
306
- if (typeof gate.id !== "string" || !gate.id.trim()) {
307
- errors.push(`${criterionPath}.id is required.`);
308
- } else {
309
- const normalizedId = normalizedToken(gate.id);
310
- if (criterionIds.has(normalizedId)) errors.push(`${criterionPath}.id duplicates normalized criterion id '${normalizedId}'.`);
311
- criterionIds.add(normalizedId);
312
- }
313
- if (typeof gate.must !== "string" || !gate.must.trim()) errors.push(`${criterionPath}.must is required.`);
314
- if (gate.evidence !== undefined && !Array.isArray(gate.evidence)) errors.push(`${criterionPath}.evidence must be an array. ${ACCEPTANCE_EVIDENCE_HELP}`);
315
- if (Array.isArray(gate.evidence)) {
316
- for (const [evidenceIndex, item] of gate.evidence.entries()) {
317
- if (typeof item !== "string" || !VALID_EVIDENCE.has(item as AcceptanceEvidenceKind)) {
318
- errors.push(unsupportedEvidenceKindMessage(`${criterionPath}.evidence[${evidenceIndex}]`, item));
319
- }
320
- }
321
- }
322
- if (gate.severity !== undefined && gate.severity !== "required" && gate.severity !== "recommended") {
323
- errors.push(`${criterionPath}.severity must be required or recommended.`);
324
- }
325
- }
326
- }
327
- if (Array.isArray(value.evidence)) {
328
- for (const [index, item] of value.evidence.entries()) {
329
- if (typeof item !== "string" || !VALID_EVIDENCE.has(item as AcceptanceEvidenceKind)) {
330
- errors.push(unsupportedEvidenceKindMessage(`${pathLabel}.evidence[${index}]`, item));
331
- }
332
- }
333
- } else if (value.evidence !== undefined) {
334
- errors.push(`${pathLabel}.evidence must be an array. ${ACCEPTANCE_EVIDENCE_HELP}`);
335
- }
336
- if (value.level === "verified" && (!Array.isArray(value.verify) || value.verify.length === 0)) {
337
- errors.push(`${pathLabel}.verify must contain at least one runtime command when level is verified. Use level "checked" or provide a non-empty acceptance.verify array.`);
338
- } else if (value.verify !== undefined && !Array.isArray(value.verify)) {
339
- errors.push(`${pathLabel}.verify must be an array.`);
340
- }
341
- if (Array.isArray(value.verify)) {
342
- for (const [index, command] of value.verify.entries()) {
343
- if (!command || typeof command !== "object" || Array.isArray(command)) {
344
- errors.push(`${pathLabel}.verify[${index}] must be an object.`);
345
- continue;
346
- }
347
- const cmd = command as Record<string, unknown>;
348
- for (const key of Object.keys(cmd)) {
349
- if (!ACCEPTANCE_VERIFY_KEYS.has(key)) errors.push(`${pathLabel}.verify[${index}].${key} is not supported.`);
350
- }
351
- if (typeof cmd.id !== "string" || !cmd.id.trim()) errors.push(`${pathLabel}.verify[${index}].id is required.`);
352
- if (typeof cmd.command !== "string" || !cmd.command.trim()) errors.push(`${pathLabel}.verify[${index}].command is required.`);
353
- if (cmd.timeoutMs !== undefined && (typeof cmd.timeoutMs !== "number" || !Number.isInteger(cmd.timeoutMs) || cmd.timeoutMs < 1)) {
354
- errors.push(`${pathLabel}.verify[${index}].timeoutMs must be an integer >= 1.`);
355
- }
356
- if (cmd.cwd !== undefined && typeof cmd.cwd !== "string") errors.push(`${pathLabel}.verify[${index}].cwd must be a string.`);
357
- if (cmd.env !== undefined) {
358
- if (!cmd.env || typeof cmd.env !== "object" || Array.isArray(cmd.env)) {
359
- errors.push(`${pathLabel}.verify[${index}].env must be an object.`);
360
- } else {
361
- for (const [envKey, envValue] of Object.entries(cmd.env as Record<string, unknown>)) {
362
- if (typeof envValue !== "string") errors.push(`${pathLabel}.verify[${index}].env.${envKey} must be a string.`);
363
- }
364
- }
365
- }
366
- if (cmd.allowFailure !== undefined && typeof cmd.allowFailure !== "boolean") {
367
- errors.push(`${pathLabel}.verify[${index}].allowFailure must be a boolean.`);
368
- }
369
- if (cmd.output !== undefined && cmd.output !== "json") errors.push(`${pathLabel}.verify[${index}].output must be "json" when present.`);
370
- if (cmd.schema !== undefined) {
371
- if (cmd.output !== "json") errors.push(`${pathLabel}.verify[${index}].schema requires output: "json".`);
372
- if (!cmd.schema || typeof cmd.schema !== "object" || Array.isArray(cmd.schema)) errors.push(`${pathLabel}.verify[${index}].schema must be a JSON Schema object.`);
373
- }
374
- }
375
- }
376
- if (value.review !== undefined && value.review !== false) {
377
- if (!value.review || typeof value.review !== "object" || Array.isArray(value.review)) {
378
- errors.push(`${pathLabel}.review must be false or an object.`);
379
- } else {
380
- const review = value.review as Record<string, unknown>;
381
- for (const key of Object.keys(review)) {
382
- if (!ACCEPTANCE_REVIEW_KEYS.has(key)) errors.push(`${pathLabel}.review.${key} is not supported.`);
383
- }
384
- if (review.agent !== undefined && typeof review.agent !== "string") errors.push(`${pathLabel}.review.agent must be a string.`);
385
- if (review.focus !== undefined && typeof review.focus !== "string") errors.push(`${pathLabel}.review.focus must be a string.`);
386
- if (review.required !== undefined && typeof review.required !== "boolean") errors.push(`${pathLabel}.review.required must be a boolean.`);
387
- }
388
- }
389
- if (value.stopRules !== undefined && !Array.isArray(value.stopRules)) errors.push(`${pathLabel}.stopRules must be an array.`);
390
- if (Array.isArray(value.stopRules)) {
391
- for (const [index, item] of value.stopRules.entries()) {
392
- if (typeof item !== "string") errors.push(`${pathLabel}.stopRules[${index}] must be a string.`);
393
- }
394
- }
395
- return errors;
396
- }
397
-
398
- type ExecutionAcceptanceInput = {
399
- acceptance?: unknown;
400
- outputSchema?: unknown;
401
- tasks?: Array<{ acceptance?: unknown; outputSchema?: unknown }>;
402
- chain?: Array<{
403
- acceptance?: unknown;
404
- outputSchema?: unknown;
405
- parallel?: Array<{ acceptance?: unknown; outputSchema?: unknown }> | { acceptance?: unknown; outputSchema?: unknown };
406
- }>;
407
- };
408
-
409
- export function validateExecutionAcceptancePolicy(input: ExecutionAcceptanceInput): string[] {
410
- const errors = validateAcceptanceInput(input.acceptance, "acceptance");
411
- for (const [index, task] of (input.tasks ?? []).entries()) {
412
- errors.push(...validateAcceptanceInput(task.acceptance, `tasks[${index}].acceptance`));
413
- }
414
- for (const [stepIndex, step] of (input.chain ?? []).entries()) {
415
- errors.push(...validateAcceptanceInput(step.acceptance, `chain[${stepIndex}].acceptance`));
416
- if (Array.isArray(step.parallel)) {
417
- for (const [taskIndex, task] of step.parallel.entries()) {
418
- errors.push(...validateAcceptanceInput(task.acceptance, `chain[${stepIndex}].parallel[${taskIndex}].acceptance`));
419
- }
420
- } else if (step.parallel) {
421
- errors.push(...validateAcceptanceInput(step.parallel.acceptance, `chain[${stepIndex}].parallel.acceptance`));
422
- }
423
- }
424
- return errors;
425
- }
426
-
427
- export function validateExecutionAcceptance(input: ExecutionAcceptanceInput): string[] {
428
- const errors = validateExecutionAcceptancePolicy(input);
429
- errors.push(...validateAcceptanceReportMode(input.acceptance, input.outputSchema, "acceptance"));
430
- for (const [index, task] of (input.tasks ?? []).entries()) {
431
- errors.push(...validateAcceptanceReportMode(task.acceptance, task.outputSchema, `tasks[${index}].acceptance`));
432
- }
433
- for (const [stepIndex, step] of (input.chain ?? []).entries()) {
434
- errors.push(...validateAcceptanceReportMode(step.acceptance, step.outputSchema, `chain[${stepIndex}].acceptance`));
435
- if (Array.isArray(step.parallel)) {
436
- for (const [taskIndex, task] of step.parallel.entries()) {
437
- errors.push(...validateAcceptanceReportMode(task.acceptance, task.outputSchema, `chain[${stepIndex}].parallel[${taskIndex}].acceptance`));
438
- }
439
- } else if (step.parallel) {
440
- errors.push(...validateAcceptanceReportMode(step.parallel.acceptance, step.parallel.outputSchema, `chain[${stepIndex}].parallel.acceptance`));
441
- }
442
- }
443
- return errors;
444
- }
445
-
446
- function validateAcceptanceReportMode(acceptance: unknown, outputSchema: unknown, pathLabel: string): string[] {
447
- const normalized = normalizeAcceptanceValue(acceptance, pathLabel);
448
- if (normalized.error) return [];
449
- acceptance = normalized.value;
450
- if (!acceptance || typeof acceptance !== "object" || Array.isArray(acceptance)) return [];
451
- if (!("report" in acceptance)) return [];
452
- return outputSchema === undefined || outputSchema === false ? [`${pathLabel}.report requires outputSchema.`] : [];
453
- }
454
-
455
- function normalizeCriteria(criteria: Array<string | { id?: string; must?: string; evidence?: AcceptanceEvidenceKind[]; severity?: "required" | "recommended" }> | undefined, evidence: AcceptanceEvidenceKind[]): ResolvedAcceptanceGate[] {
456
- return (criteria ?? []).map((criterion, index): ResolvedAcceptanceGate => {
457
- if (typeof criterion === "string") {
458
- return { id: `criterion-${index + 1}`, must: criterion, evidence, severity: "required" };
459
- }
460
- return {
461
- id: criterion.id?.trim() || `criterion-${index + 1}`,
462
- must: criterion.must ?? "",
463
- evidence: criterion.evidence?.filter((item) => VALID_EVIDENCE.has(item)) ?? evidence,
464
- severity: criterion.severity ?? "required",
465
- };
466
- }).filter((criterion) => criterion.must.trim());
467
- }
468
-
469
- export function resolveEffectiveAcceptance(input: {
470
- explicit?: AcceptanceInput;
471
- agentName: string;
472
- acceptanceRole?: AcceptanceRole;
473
- task?: string;
474
- mode?: SubagentRunMode;
475
- async?: boolean;
476
- dynamic?: boolean;
477
- dynamicGroup?: boolean;
478
- agentContract?: AgentContract;
479
- }): ResolvedAcceptanceConfig {
480
- const explicit = normalizeAcceptanceInput(input.explicit);
481
- const explicitLevel = normalizeLevel(explicit.level);
482
- if (isAgentContract(input.agentContract)) {
483
- const level = explicitAcceptanceCanDisable(explicit) || explicitLevel === "auto"
484
- ? "none"
485
- : explicitLevel;
486
- const evidence = unique(explicit.evidence ?? []);
487
- const criteria = normalizeCriteria(
488
- explicit.criteria as Array<string | { id?: string; must?: string; evidence?: AcceptanceEvidenceKind[]; severity?: "required" | "recommended" }> | undefined,
489
- evidence,
490
- );
491
- return {
492
- level,
493
- explicit: input.explicit !== undefined,
494
- inferredReason: [],
495
- criteria,
496
- evidence,
497
- preserveStagedIndex: explicit.preserveStagedIndex,
498
- verify: explicit.verify ?? [],
499
- review: explicit.review,
500
- stopRules: explicit.stopRules ?? [],
501
- reason: explicit.reason,
502
- };
503
- }
504
- const inferred = inferLevel(input);
505
- const inferredLevel = inferred.level === "none" && explicitAcceptanceRequestsPolicy(explicit) ? "attested" : inferred.level;
506
- const level = explicitAcceptanceCanDisable(explicit)
507
- ? "none"
508
- : explicitLevel === "auto"
509
- ? inferredLevel
510
- : (LEVEL_RANK[explicitLevel] >= LEVEL_RANK[inferredLevel] ? explicitLevel : inferredLevel);
511
- const evidence = unique([...(level === inferredLevel ? inferred.evidence : requiredEvidenceForLevel(level)), ...(explicit.evidence ?? [])]);
512
- const criteria = normalizeCriteria(
513
- (explicit.criteria?.length ? explicit.criteria : inferred.criteria) as Array<string | { id?: string; must?: string; evidence?: AcceptanceEvidenceKind[]; severity?: "required" | "recommended" }>,
514
- evidence,
515
- );
516
- const review = explicit.review !== undefined ? explicit.review : inferred.review;
517
- return {
518
- level,
519
- explicit: input.explicit !== undefined,
520
- inferredReason: inferred.reasons,
521
- criteria: level === "none" ? [] : criteria,
522
- evidence: level === "none" ? [] : evidence,
523
- preserveStagedIndex: explicit.preserveStagedIndex,
524
- verify: explicit.verify ?? [],
525
- review,
526
- stopRules: explicit.stopRules ?? [],
527
- reason: explicit.reason,
528
- };
529
- }
530
-
531
- function acceptanceRequiresChildReport(acceptance: ResolvedAcceptanceConfig): boolean {
532
- return acceptance.criteria.length > 0 || acceptance.evidence.length > 0;
533
- }
534
-
535
- /** Label a declared review gate the same way in prompts and capability summaries. */
536
- export function formatReviewGateLabel(review: AcceptanceReviewGate): string {
537
- const status = review.required === false ? "optional" : "required";
538
- return review.agent ? `${status} by ${review.agent}` : status;
539
- }
540
-
541
- export function formatAcceptancePrompt(acceptance: ResolvedAcceptanceConfig, options: { reportOptional?: boolean; structuredOutput?: boolean } = {}): string {
542
- if (acceptance.level === "none") return "";
543
- if (options.reportOptional && !acceptanceRequiresChildReport(acceptance)) return "";
544
- const lines = [
545
- "",
546
- "## Acceptance Contract",
547
- `Acceptance level: ${acceptance.level}`,
548
- "Completion is not accepted from prose alone. End with a structured acceptance report.",
549
- "",
550
- "Criteria:",
551
- ...(acceptance.criteria.length ? acceptance.criteria.map((criterion) => `- ${criterion.id}: ${criterion.must}`) : ["- Return the requested result."]),
552
- "",
553
- `Required evidence: ${acceptance.evidence.join(", ") || "none"}`,
554
- ];
555
- if (acceptance.preserveStagedIndex) {
556
- lines.push("The host will verify that the staged index is unchanged from launch; report noStagedFiles truthfully even when the preserved index is non-empty.");
557
- }
558
- if (acceptance.verify.length > 0) {
559
- lines.push("", "Runtime verification commands configured by parent:");
560
- for (const command of acceptance.verify) lines.push(`- ${command.id}: ${command.command}`);
561
- }
562
- if (acceptance.review) {
563
- lines.push("", `Review gate: ${formatReviewGateLabel(acceptance.review)}.`);
564
- if (acceptance.review.focus) lines.push(`Review focus: ${acceptance.review.focus}`);
565
- }
566
- if (acceptance.stopRules.length > 0) {
567
- lines.push("", "Stop rules:", ...acceptance.stopRules.map((rule) => `- ${rule}`));
568
- }
569
- lines.push(
570
- "",
571
- options.structuredOutput
572
- ? "Include an `acceptanceReport` object in your final `structured_output` tool call in this shape:"
573
- : "Finish with a fenced JSON block tagged `acceptance-report` in this shape:",
574
- "Use empty arrays when no items apply; array fields contain strings unless object entries are shown.",
575
- "Empty-string entries (`[\"\"]`) are ignored; use `[]` when nothing applies.",
576
- "`criteriaSatisfied[].status` must be exactly one of: satisfied, not-satisfied, not-applicable.",
577
- "`commandsRun[].result` must be exactly one of: passed, failed, not-run.",
578
- "`manualNotes` and `notes` are optional strings; an empty string means no note and does not satisfy `manual-notes` evidence.",
579
- ...(options.structuredOutput ? [] : ["```acceptance-report"]),
580
- JSON.stringify({
581
- criteriaSatisfied: acceptance.criteria
582
- .filter((criterion) => criterion.severity !== "recommended")
583
- .map((criterion) => ({ id: criterion.id, status: "satisfied", evidence: "specific proof" })),
584
- changedFiles: ["src/file.ts"],
585
- testsAddedOrUpdated: ["test/file.test.ts"],
586
- commandsRun: [{ command: "command", result: "passed", summary: "short result" }],
587
- validationOutput: ["validation output or concise summary"],
588
- residualRisks: ["none"],
589
- noStagedFiles: true,
590
- diffSummary: "short description of the diff",
591
- reviewFindings: ["blocker: file.ts:12 - issue found, or no blockers"],
592
- manualNotes: "anything else the parent should know",
593
- }, null, 2),
594
- ...(options.structuredOutput ? [] : ["```"]),
595
- );
596
- return lines.join("\n");
597
- }
598
-
599
- function extractBalancedJson(text: string, start: number): string | undefined {
600
- let depth = 0;
601
- let inString = false;
602
- let escaped = false;
603
- for (let i = start; i < text.length; i++) {
604
- const char = text[i]!;
605
- if (inString) {
606
- if (escaped) escaped = false;
607
- else if (char === "\\") escaped = true;
608
- else if (char === "\"") inString = false;
609
- continue;
610
- }
611
- if (char === "\"") {
612
- inString = true;
613
- continue;
614
- }
615
- if (char === "{") depth++;
616
- if (char === "}") {
617
- depth--;
618
- if (depth === 0) return text.slice(start, i + 1);
619
- }
620
- }
621
- return undefined;
622
- }
623
-
624
- const ACCEPTANCE_REPORT_WRAPPERS = new Set(["acceptance", "acceptance-report", "acceptance_report", "acceptanceReport"]);
625
-
626
- const ACCEPTANCE_REPORT_FIELDS: Record<string, keyof AcceptanceReport> = {
627
- criteriaSatisfied: "criteriaSatisfied",
628
- criteria_satisfied: "criteriaSatisfied",
629
- changedFiles: "changedFiles",
630
- changed_files: "changedFiles",
631
- testsAddedOrUpdated: "testsAddedOrUpdated",
632
- tests_added_or_updated: "testsAddedOrUpdated",
633
- commandsRun: "commandsRun",
634
- commands_run: "commandsRun",
635
- validationOutput: "validationOutput",
636
- validation_output: "validationOutput",
637
- residualRisks: "residualRisks",
638
- residual_risks: "residualRisks",
639
- noStagedFiles: "noStagedFiles",
640
- no_staged_files: "noStagedFiles",
641
- diffSummary: "diffSummary",
642
- diff_summary: "diffSummary",
643
- reviewFindings: "reviewFindings",
644
- review_findings: "reviewFindings",
645
- manualNotes: "manualNotes",
646
- manual_notes: "manualNotes",
647
- notes: "notes",
648
- };
649
-
650
- const CRITERION_REPORT_FIELDS = new Set(["id", "status", "evidence"]);
651
- const COMMAND_REPORT_FIELDS = new Set(["command", "result", "summary"]);
652
-
653
- function normalizedToken(value: string): string {
654
- return value.trim().toLowerCase().replace(/[\s_]+/g, "-").replace(/-+/g, "-");
655
- }
656
-
657
- function normalizeCriterionStatus(value: unknown): unknown {
658
- if (typeof value !== "string") return value;
659
- const token = normalizedToken(value);
660
- if (["satisfied", "met", "complete", "completed", "done", "pass", "passed", "success", "succeeded"].includes(token)) return "satisfied";
661
- if (["not-satisfied", "not-met", "unmet", "incomplete", "fail", "failed"].includes(token)) return "not-satisfied";
662
- if (["not-applicable", "n-a", "na", "skip", "skipped"].includes(token)) return "not-applicable";
663
- return value;
664
- }
665
-
666
- function normalizeCommandResult(value: unknown): unknown {
667
- if (typeof value !== "string") return value;
668
- const token = normalizedToken(value);
669
- if (["passed", "pass", "success", "successful", "succeeded", "ok"].includes(token)) return "passed";
670
- if (["failed", "fail", "failure", "error"].includes(token)) return "failed";
671
- if (["not-run", "not-executed", "skip", "skipped"].includes(token)) return "not-run";
672
- return value;
673
- }
674
-
675
- function normalizeCriterionReport(value: unknown, pathLabel: string, errors: string[]): unknown {
676
- if (!value || typeof value !== "object" || Array.isArray(value)) return value;
677
- const normalized: Record<string, unknown> = {};
678
- for (const [key, fieldValue] of Object.entries(value as Record<string, unknown>)) {
679
- if (!CRITERION_REPORT_FIELDS.has(key)) {
680
- errors.push(`${pathLabel}.${key}: unsupported acceptance criterion field`);
681
- continue;
682
- }
683
- normalized[key] = key === "id" && typeof fieldValue === "string"
684
- ? normalizedToken(fieldValue)
685
- : key === "status"
686
- ? normalizeCriterionStatus(fieldValue)
687
- : fieldValue;
688
- }
689
- return normalized;
690
- }
691
-
692
- function normalizeCommandReport(value: unknown, pathLabel: string, errors: string[]): unknown {
693
- if (!value || typeof value !== "object" || Array.isArray(value)) return value;
694
- const normalized: Record<string, unknown> = {};
695
- for (const [key, fieldValue] of Object.entries(value as Record<string, unknown>)) {
696
- if (!COMMAND_REPORT_FIELDS.has(key)) {
697
- errors.push(`${pathLabel}.${key}: unsupported acceptance command field`);
698
- continue;
699
- }
700
- normalized[key] = key === "result" ? normalizeCommandResult(fieldValue) : fieldValue;
701
- }
702
- return normalized;
703
- }
704
-
705
- function normalizeAcceptanceReportValue(value: unknown, pathLabel = ""): { value: unknown; pathLabel: string; errors: string[] } {
706
- const errors: string[] = [];
707
- let reportValue = value;
708
- let reportPath = pathLabel;
709
- if (reportValue && typeof reportValue === "object" && !Array.isArray(reportValue)) {
710
- const record = reportValue as Record<string, unknown>;
711
- const wrapperKeys = Object.keys(record).filter((key) => ACCEPTANCE_REPORT_WRAPPERS.has(key));
712
- if (wrapperKeys.length > 0) {
713
- const wrapperKey = wrapperKeys[0]!;
714
- if (wrapperKeys.length > 1) errors.push(`${pathLabel || "acceptance-report"}: multiple acceptance report wrappers are ambiguous`);
715
- for (const key of Object.keys(record)) {
716
- if (key !== wrapperKey) errors.push(`${pathFor(pathLabel, key)}: unsupported alongside acceptance report wrapper '${wrapperKey}'`);
717
- }
718
- reportValue = record[wrapperKey];
719
- reportPath = pathFor(pathLabel, wrapperKey);
720
- }
721
- }
722
- if (!reportValue || typeof reportValue !== "object" || Array.isArray(reportValue)) return { value: reportValue, pathLabel: reportPath, errors };
723
-
724
- const normalized: Record<string, unknown> = {};
725
- for (const [key, fieldValue] of Object.entries(reportValue as Record<string, unknown>)) {
726
- const canonical = ACCEPTANCE_REPORT_FIELDS[key];
727
- if (!canonical) {
728
- errors.push(`${pathFor(reportPath, key)}: unsupported acceptance report field`);
729
- continue;
730
- }
731
- if (Object.hasOwn(normalized, canonical)) {
732
- errors.push(`${pathFor(reportPath, key)}: duplicates normalized field '${canonical}'`);
733
- continue;
734
- }
735
- const fieldPath = pathFor(reportPath, canonical);
736
- switch (canonical) {
737
- case "criteriaSatisfied": {
738
- const items = Array.isArray(fieldValue) ? fieldValue : fieldValue && typeof fieldValue === "object" ? [fieldValue] : fieldValue;
739
- normalized[canonical] = Array.isArray(items)
740
- ? items.map((item, index) => normalizeCriterionReport(item, `${fieldPath}[${index}]`, errors))
741
- : items;
742
- break;
743
- }
744
- case "commandsRun": {
745
- const items = Array.isArray(fieldValue) ? fieldValue : fieldValue && typeof fieldValue === "object" ? [fieldValue] : fieldValue;
746
- normalized[canonical] = Array.isArray(items)
747
- ? items.map((item, index) => normalizeCommandReport(item, `${fieldPath}[${index}]`, errors))
748
- : items;
749
- break;
750
- }
751
- case "changedFiles":
752
- case "testsAddedOrUpdated":
753
- case "validationOutput":
754
- case "residualRisks":
755
- case "reviewFindings": {
756
- // Tolerate empty-string entries ("[\"\"]"): models write them for "no items"
757
- // and a single empty entry must not reject the whole report. Drop them at
758
- // parse time; non-string entries are kept so validateStringArrayField still
759
- // flags structural garbage.
760
- const items = typeof fieldValue === "string" ? [fieldValue] : fieldValue;
761
- normalized[canonical] = Array.isArray(items)
762
- ? items.filter((item) => typeof item !== "string" || item.trim().length > 0)
763
- : items;
764
- break;
765
- }
766
- case "noStagedFiles": {
767
- const token = typeof fieldValue === "string" ? fieldValue.trim().toLowerCase() : undefined;
768
- normalized[canonical] = token === "true" ? true : token === "false" ? false : fieldValue;
769
- break;
770
- }
771
- default:
772
- normalized[canonical] = fieldValue;
773
- }
774
- }
775
- return { value: normalized, pathLabel: reportPath, errors };
776
- }
777
-
778
- function hasGenericAcceptanceReportSignal(value: unknown): boolean {
779
- if (!value || typeof value !== "object" || Array.isArray(value)) return false;
780
- const record = value as Record<string, unknown>;
781
- return "criteriaSatisfied" in record && [
782
- "changedFiles",
783
- "testsAddedOrUpdated",
784
- "commandsRun",
785
- "validationOutput",
786
- "residualRisks",
787
- "noStagedFiles",
788
- "diffSummary",
789
- "reviewFindings",
790
- "manualNotes",
791
- ].some((key) => key in record);
792
- }
793
-
794
- function parseReportJson(body: string): unknown {
795
- const trimmed = body.trim();
796
- try {
797
- return JSON.parse(trimmed) as unknown;
798
- } catch (error) {
799
- const jsonStart = trimmed.indexOf("{");
800
- if (jsonStart > 0) {
801
- const json = extractBalancedJson(trimmed, jsonStart);
802
- if (json) return JSON.parse(json) as unknown;
803
- }
804
- throw error;
805
- }
806
- }
807
-
808
- function fencedBlocks(output: string, tag: string): string[] {
809
- return [...output.matchAll(new RegExp(`\`\`\`${tag}\\s*\\n([\\s\\S]*?)\`\`\``, "gi"))]
810
- .map((match) => match[1]?.trim())
811
- .filter((value): value is string => Boolean(value));
812
- }
813
-
814
- function parseAcceptanceReportBody(body: string): { report?: AcceptanceReport; errors: string[] } {
815
- return validateAcceptanceReport(parseReportJson(body));
816
- }
817
-
818
- interface AcceptanceReportParseResult {
819
- report?: AcceptanceReport;
820
- error?: string;
821
- /** True when an acceptance-report signal was found but its envelope was invalid. */
822
- malformed?: boolean;
823
- sourcePath?: string;
824
- }
825
-
826
- function parseUnterminatedAcceptanceReportFence(output: string): AcceptanceReportParseResult {
827
- const opener = /```acceptance[-_]report\b[^\n]*\n/gi.exec(output);
828
- if (!opener) return {};
829
- const bodyStart = opener.index + opener[0].length;
830
- if (output.indexOf("```", bodyStart) !== -1) return {};
831
- try {
832
- const validation = validateAcceptanceReport(JSON.parse(output.slice(bodyStart).trim()) as unknown);
833
- return validation.report
834
- ? { report: validation.report }
835
- : { error: `Failed to parse acceptance-report: Invalid acceptance-report: ${validation.errors.join("; ")}`, malformed: true };
836
- } catch (error) {
837
- return { error: `Failed to parse acceptance-report: ${error instanceof Error ? error.message : String(error)}`, malformed: true };
838
- }
839
- }
840
-
841
- function parseGenericJsonAcceptanceReportBody(body: string): AcceptanceReportParseResult {
842
- const parsed = parseReportJson(body);
843
- const normalized = normalizeAcceptanceReportValue(parsed);
844
- const hasCriteriaMarker = normalized.value !== null
845
- && typeof normalized.value === "object"
846
- && !Array.isArray(normalized.value)
847
- && "criteriaSatisfied" in normalized.value;
848
- if (!hasGenericAcceptanceReportSignal(normalized.value) && !(hasCriteriaMarker && normalized.errors.length > 0)) return {};
849
- const validation = validateAcceptanceReport(parsed);
850
- return validation.report
851
- ? { report: validation.report }
852
- : { error: `Invalid acceptance-report: ${validation.errors.join("; ")}`, malformed: true };
853
- }
854
-
855
- export const ACCEPTANCE_REPORT_NOT_FOUND = "Structured acceptance report not found.";
856
-
857
- export function parseAcceptanceReport(output: string): AcceptanceReportParseResult {
858
- const explicitFencePresent = /```acceptance[-_]report\b/i.test(output);
859
- const fenced = fencedBlocks(output, "acceptance[-_]report");
860
- const parseErrors: string[] = [];
861
- for (const body of fenced) {
862
- try {
863
- const validation = parseAcceptanceReportBody(body);
864
- if (validation.report) return { report: validation.report };
865
- parseErrors.push(`Invalid acceptance-report: ${validation.errors.join("; ")}`);
866
- } catch (error) {
867
- parseErrors.push(error instanceof Error ? error.message : String(error));
868
- }
869
- }
870
- if (parseErrors.length > 0) return { error: `Failed to parse acceptance-report: ${parseErrors.join("; ")}`, malformed: true };
871
- if (explicitFencePresent) {
872
- const recovered = parseUnterminatedAcceptanceReportFence(output);
873
- if (recovered.report || recovered.error) return recovered;
874
- return { error: "Failed to parse acceptance-report: Empty or unterminated acceptance-report fence.", malformed: true };
875
- }
876
- for (const body of fencedBlocks(output, "(?:json|jsonc|json5)")) {
877
- try {
878
- const parsed = parseGenericJsonAcceptanceReportBody(body);
879
- if (parsed.report) return { report: parsed.report };
880
- if (parsed.error) return { error: `Failed to parse acceptance-report: ${parsed.error}`, malformed: parsed.malformed };
881
- } catch {
882
- // Ignore unrelated malformed generic JSON. A recognizable report shape
883
- // returns exact validation errors above instead of being mistaken for prose.
884
- }
885
- }
886
- const markerIndex = output.search(/ACCEPTANCE_REPORT\s*:/i);
887
- if (markerIndex !== -1) {
888
- const jsonStart = output.indexOf("{", markerIndex);
889
- if (jsonStart === -1) {
890
- return { error: "Failed to parse acceptance-report: Expected a JSON object after ACCEPTANCE_REPORT:.", malformed: true };
891
- }
892
- const json = extractBalancedJson(output, jsonStart);
893
- if (!json) {
894
- return { error: "Failed to parse acceptance-report: Unterminated JSON object after ACCEPTANCE_REPORT:.", malformed: true };
895
- }
896
- try {
897
- const parsed = JSON.parse(json) as unknown;
898
- const validation = validateAcceptanceReport(parsed);
899
- if (validation.report) return { report: validation.report };
900
- return { error: `Failed to parse acceptance-report: Invalid acceptance-report: ${validation.errors.join("; ")}`, malformed: true };
901
- } catch (error) {
902
- const message = error instanceof Error ? error.message : String(error);
903
- return { error: `Failed to parse acceptance-report: ${message}`, malformed: true };
904
- }
905
- }
906
- return { error: ACCEPTANCE_REPORT_NOT_FOUND };
907
- }
908
-
909
- function parseAcceptanceReportSources(
910
- output: string,
911
- fileOutput: { content: string; path: string; authoritative?: boolean } | undefined,
912
- ): AcceptanceReportParseResult {
913
- const fromText = () => parseAcceptanceReport(output);
914
- const fromFile = () => {
915
- if (!fileOutput) return { error: ACCEPTANCE_REPORT_NOT_FOUND };
916
- const parsed = parseAcceptanceReport(fileOutput.content);
917
- return parsed.report || parsed.error === ACCEPTANCE_REPORT_NOT_FOUND
918
- ? parsed
919
- : {
920
- ...parsed,
921
- error: `${parsed.error} (in configured output ${fileOutput.path})`,
922
- sourcePath: fileOutput.path,
923
- };
924
- };
925
- const [primary, secondary] = fileOutput?.authoritative ? [fromFile, fromText] : [fromText, fromFile];
926
- const first = primary();
927
- // A malformed report in the primary source is a defect to surface, not a
928
- // miss to paper over with the secondary source; only a genuinely absent
929
- // report falls through.
930
- if (first.report || first.error !== ACCEPTANCE_REPORT_NOT_FOUND) return first;
931
- return secondary();
932
- }
933
-
934
- export function stripAcceptanceReport(output: string): string {
935
- const trailingFencePattern = /\n?```(acceptance[-_]report|json|jsonc|json5)\s*\n([\s\S]*?)```\s*/gi;
936
- let trailingFence: { index: number; tag: string; body: string } | undefined;
937
- for (const match of output.matchAll(trailingFencePattern)) {
938
- const end = (match.index ?? 0) + match[0].length;
939
- if (output.slice(end).trim().length === 0 && match[1] && match[2]) {
940
- trailingFence = { index: match.index ?? 0, tag: match[1].toLowerCase(), body: match[2] };
941
- }
942
- }
943
- if (trailingFence) {
944
- if (trailingFence.tag === "acceptance-report" || trailingFence.tag === "acceptance_report") return output.slice(0, trailingFence.index).trimEnd();
945
- try {
946
- if (parseGenericJsonAcceptanceReportBody(trailingFence.body).report) return output.slice(0, trailingFence.index).trimEnd();
947
- } catch {
948
- // Leave unrelated or malformed generic JSON fences visible.
949
- }
950
- }
951
- return output
952
- .replace(/\n?```acceptance[-_]report\s*\n[\s\S]*?```\s*$/i, "")
953
- .replace(/\n?ACCEPTANCE_REPORT\s*:\s*\{[\s\S]*\}\s*$/i, "")
954
- .trimEnd();
955
- }
956
-
957
- function isStringArray(value: unknown): value is string[] {
958
- return Array.isArray(value) && value.every((item) => typeof item === "string");
959
- }
960
-
961
- function pathFor(base: string, segment: string): string {
962
- return base ? `${base}.${segment}` : segment;
963
- }
964
-
965
- function describeValidationValue(value: unknown): string {
966
- if (value === undefined) return "missing";
967
- if (value === null) return "null";
968
- if (Array.isArray(value)) return "array";
969
- if (typeof value === "object") return "object";
970
- if (typeof value === "string") {
971
- const short = value.length > 80 ? `${value.slice(0, 77)}...` : value;
972
- return JSON.stringify(short);
973
- }
974
- return `${typeof value} ${String(value)}`;
975
- }
976
-
977
- function pushTypeError(errors: string[], pathLabel: string, expected: string, value: unknown): void {
978
- errors.push(`${pathLabel}: expected ${expected}; got ${describeValidationValue(value)}`);
979
- }
980
-
981
- function validateStringArrayField(errors: string[], value: unknown, pathLabel: string): void {
982
- if (!Array.isArray(value)) {
983
- pushTypeError(errors, pathLabel, "string[]", value);
984
- return;
985
- }
986
- for (const [index, item] of value.entries()) {
987
- if (typeof item !== "string" || !item.trim()) pushTypeError(errors, `${pathLabel}[${index}]`, "non-empty string", item);
988
- }
989
- }
990
-
991
- export function validateAcceptanceReport(value: unknown, pathLabel = ""): { report?: AcceptanceReport; errors: string[] } {
992
- const normalized = normalizeAcceptanceReportValue(value, pathLabel);
993
- value = normalized.value;
994
- pathLabel = normalized.pathLabel;
995
- const errors = normalized.errors;
996
- if (!value || typeof value !== "object" || Array.isArray(value)) {
997
- pushTypeError(errors, pathLabel || "acceptance-report", "object", value);
998
- return { errors };
999
- }
1000
- const report = value as AcceptanceReport;
1001
- if (report.criteriaSatisfied !== undefined) {
1002
- if (!Array.isArray(report.criteriaSatisfied)) {
1003
- pushTypeError(errors, pathFor(pathLabel, "criteriaSatisfied"), "array", report.criteriaSatisfied);
1004
- } else {
1005
- const criterionIds = new Set<string>();
1006
- for (const [index, item] of report.criteriaSatisfied.entries()) {
1007
- const itemPath = `${pathFor(pathLabel, "criteriaSatisfied")}[${index}]`;
1008
- if (!item || typeof item !== "object" || Array.isArray(item)) {
1009
- pushTypeError(errors, itemPath, "object", item);
1010
- continue;
1011
- }
1012
- const criterion = item as { id?: unknown; status?: unknown; evidence?: unknown };
1013
- if (criterion.id !== undefined && typeof criterion.id !== "string") {
1014
- pushTypeError(errors, `${itemPath}.id`, "string", criterion.id);
1015
- } else if (typeof criterion.id === "string" && criterion.id) {
1016
- if (criterionIds.has(criterion.id)) errors.push(`${itemPath}.id: duplicate normalized criterion id '${criterion.id}'`);
1017
- criterionIds.add(criterion.id);
1018
- }
1019
- if (criterion.status !== "satisfied" && criterion.status !== "not-satisfied" && criterion.status !== "not-applicable") {
1020
- pushTypeError(errors, `${itemPath}.status`, "one of \"satisfied\", \"not-satisfied\", \"not-applicable\"", criterion.status);
1021
- }
1022
- if (typeof criterion.evidence !== "string" || !criterion.evidence.trim()) pushTypeError(errors, `${itemPath}.evidence`, "non-empty string", criterion.evidence);
1023
- }
1024
- }
1025
- }
1026
- if (report.changedFiles !== undefined) validateStringArrayField(errors, report.changedFiles, pathFor(pathLabel, "changedFiles"));
1027
- if (report.testsAddedOrUpdated !== undefined) validateStringArrayField(errors, report.testsAddedOrUpdated, pathFor(pathLabel, "testsAddedOrUpdated"));
1028
- if (report.commandsRun !== undefined) {
1029
- if (!Array.isArray(report.commandsRun)) {
1030
- pushTypeError(errors, pathFor(pathLabel, "commandsRun"), "array", report.commandsRun);
1031
- } else {
1032
- for (const [index, item] of report.commandsRun.entries()) {
1033
- const itemPath = `${pathFor(pathLabel, "commandsRun")}[${index}]`;
1034
- if (!item || typeof item !== "object" || Array.isArray(item)) {
1035
- pushTypeError(errors, itemPath, "object", item);
1036
- continue;
1037
- }
1038
- const command = item as { command?: unknown; result?: unknown; summary?: unknown };
1039
- if (typeof command.command !== "string" || !command.command.trim()) pushTypeError(errors, `${itemPath}.command`, "non-empty string", command.command);
1040
- if (command.result !== "passed" && command.result !== "failed" && command.result !== "not-run") {
1041
- pushTypeError(errors, `${itemPath}.result`, "one of \"passed\", \"failed\", \"not-run\"", command.result);
1042
- }
1043
- if (typeof command.summary !== "string" || !command.summary.trim()) pushTypeError(errors, `${itemPath}.summary`, "non-empty string", command.summary);
1044
- }
1045
- }
1046
- }
1047
- if (report.validationOutput !== undefined) validateStringArrayField(errors, report.validationOutput, pathFor(pathLabel, "validationOutput"));
1048
- if (report.residualRisks !== undefined) validateStringArrayField(errors, report.residualRisks, pathFor(pathLabel, "residualRisks"));
1049
- if (report.noStagedFiles !== undefined && typeof report.noStagedFiles !== "boolean") pushTypeError(errors, pathFor(pathLabel, "noStagedFiles"), "boolean", report.noStagedFiles);
1050
- if (report.diffSummary !== undefined && (typeof report.diffSummary !== "string" || !report.diffSummary.trim())) pushTypeError(errors, pathFor(pathLabel, "diffSummary"), "non-empty string", report.diffSummary);
1051
- if (report.reviewFindings !== undefined) validateStringArrayField(errors, report.reviewFindings, pathFor(pathLabel, "reviewFindings"));
1052
- if (report.manualNotes !== undefined && typeof report.manualNotes !== "string") pushTypeError(errors, pathFor(pathLabel, "manualNotes"), "string", report.manualNotes);
1053
- if (report.notes !== undefined && typeof report.notes !== "string") pushTypeError(errors, pathFor(pathLabel, "notes"), "string", report.notes);
1054
- if (errors.length > 0) return { errors };
1055
- const hasReportField = report.criteriaSatisfied !== undefined
1056
- || report.changedFiles !== undefined
1057
- || report.testsAddedOrUpdated !== undefined
1058
- || report.commandsRun !== undefined
1059
- || report.validationOutput !== undefined
1060
- || report.residualRisks !== undefined
1061
- || report.noStagedFiles !== undefined
1062
- || report.diffSummary !== undefined
1063
- || report.manualNotes !== undefined
1064
- || report.notes !== undefined
1065
- || report.reviewFindings !== undefined;
1066
- return hasReportField
1067
- ? { report, errors }
1068
- : { errors: [`${pathLabel || "acceptance-report"}: expected at least one acceptance report field`] };
1069
- }
1070
-
1071
- function checkCriteriaSatisfied(criteria: ResolvedAcceptanceGate[], report: AcceptanceReport): AcceptanceRuntimeCheck[] {
1072
- const reports = new Map((report.criteriaSatisfied ?? []).filter((item) => item.id).map((item) => [normalizedToken(item.id!), item]));
1073
- return criteria.filter((criterion) => criterion.severity !== "recommended").map((criterion) => {
1074
- const item = reports.get(normalizedToken(criterion.id));
1075
- if (!item) return { id: `criterion:${criterion.id}`, status: "failed", message: `Required criterion '${criterion.id}' was not reported.` };
1076
- if (item.status !== "satisfied") return { id: `criterion:${criterion.id}`, status: "failed", message: `Required criterion '${criterion.id}' was reported as ${item.status}.` };
1077
- return { id: `criterion:${criterion.id}`, status: "passed", message: `Required criterion '${criterion.id}' satisfied.` };
1078
- });
1079
- }
1080
-
1081
- function reportEvidenceStatus(report: AcceptanceReport, kind: AcceptanceEvidenceKind): AcceptanceRuntimeCheckStatus {
1082
- switch (kind) {
1083
- case "changed-files":
1084
- if (!isStringArray(report.changedFiles)) return "failed";
1085
- return report.changedFiles.length === 0 ? "not-applicable" : "passed";
1086
- case "tests-added":
1087
- if (!isStringArray(report.testsAddedOrUpdated)) return "failed";
1088
- return report.testsAddedOrUpdated.length === 0 ? "not-applicable" : "passed";
1089
- case "commands-run": return Array.isArray(report.commandsRun) && report.commandsRun.length > 0 ? "passed" : "failed";
1090
- case "validation-output": return isStringArray(report.validationOutput) && report.validationOutput.length > 0 ? "passed" : "failed";
1091
- case "residual-risks": return isStringArray(report.residualRisks) ? "passed" : "failed";
1092
- case "no-staged-files": return report.noStagedFiles === true ? "passed" : "failed";
1093
- case "diff-summary": return typeof report.diffSummary === "string" && report.diffSummary.trim().length > 0 ? "passed" : "failed";
1094
- case "review-findings": return isStringArray(report.reviewFindings) ? "passed" : "failed";
1095
- case "manual-notes": return Boolean((report.manualNotes ?? report.notes)?.trim()) ? "passed" : "failed";
1096
- }
1097
- }
1098
-
1099
- function checkNoStagedFiles(cwd: string): AcceptanceRuntimeCheck {
1100
- const result = spawnSync("git", ["status", "--short"], { cwd, encoding: "utf-8", windowsHide: true });
1101
- if (result.status !== 0) {
1102
- return { id: "no-staged-files", status: "not-applicable", message: "git status unavailable; no staged-files check skipped" };
1103
- }
1104
- const staged = result.stdout.split(/\r?\n/).filter((line) => line.length >= 2 && line[0] !== " " && line[0] !== "?");
1105
- return staged.length === 0
1106
- ? { id: "no-staged-files", status: "passed", message: "No staged files detected." }
1107
- : { id: "no-staged-files", status: "failed", message: `Staged files present: ${staged.join(", ")}` };
1108
- }
1109
-
1110
- /** Capture the repository-wide index tree. Throws when Git cannot provide trustworthy evidence. */
1111
- export function captureStagedIndexBaseline(cwd: string): string {
1112
- const result = spawnSync("git", ["write-tree"], { cwd, encoding: "utf-8", windowsHide: true });
1113
- const oid = result.stdout.trim();
1114
- if (result.status !== 0 || !oid) {
1115
- const detail = result.stderr.trim();
1116
- throw new Error(`Unable to capture staged index baseline${detail ? `: ${detail}` : "."}`);
1117
- }
1118
- return oid;
1119
- }
1120
-
1121
- function checkStagedIndexUnchanged(cwd: string, baseline: string): AcceptanceRuntimeCheck {
1122
- try {
1123
- const terminal = captureStagedIndexBaseline(cwd);
1124
- return terminal === baseline
1125
- ? { id: "staged-index-unchanged", status: "passed", message: "Staged index matches the launch baseline." }
1126
- : { id: "staged-index-unchanged", status: "failed", message: "Staged index changed after launch." };
1127
- } catch (error) {
1128
- return { id: "staged-index-unchanged", status: "failed", message: error instanceof Error ? error.message : String(error) };
1129
- }
1130
- }
1131
-
1132
- function runStructuralChecks(acceptance: ResolvedAcceptanceConfig, report: AcceptanceReport, cwd: string): AcceptanceRuntimeCheck[] {
1133
- const checks: AcceptanceRuntimeCheck[] = [];
1134
- for (const kind of acceptance.evidence) {
1135
- if (kind === "no-staged-files" && acceptance.preserveStagedIndex) continue;
1136
- if (kind === "no-staged-files" && report.noStagedFiles === undefined) continue;
1137
- const status = reportEvidenceStatus(report, kind);
1138
- checks.push({
1139
- id: `evidence:${kind}`,
1140
- status,
1141
- message: status === "passed"
1142
- ? `${kind} evidence present.`
1143
- : status === "not-applicable"
1144
- ? `${kind} evidence explicitly reported as not applicable.`
1145
- : `${kind} evidence missing from child report.`,
1146
- });
1147
- }
1148
- if (!acceptance.preserveStagedIndex && acceptance.evidence.includes("no-staged-files")) checks.push(checkNoStagedFiles(cwd));
1149
- return checks;
1150
- }
1151
-
1152
- function trimOutput(value: string): string | undefined {
1153
- const trimmed = value.trim();
1154
- if (!trimmed) return undefined;
1155
- return trimmed.length > 12_000 ? `${trimmed.slice(0, 12_000)}\n...[truncated]` : trimmed;
1156
- }
1157
-
1158
- const SENSITIVE_ENV_KEY_PATTERN = /(?:^|_)(?:TOKEN|SECRET|PASSWORD|PASS|AUTH|CREDENTIAL|COOKIE|SESSION|PRIVATE|API_KEY|ACCESS_KEY)(?:_|$)/i;
1159
-
1160
- function effectiveVerifyEnv(env: Record<string, string> | undefined): Record<string, string> {
1161
- const inherited = Object.fromEntries(Object.entries(process.env).flatMap(([key, value]) => {
1162
- return typeof value === "string" ? [[key, value]] : [];
1163
- }));
1164
- return { ...inherited, ...(env ?? {}) };
1165
- }
1166
-
1167
- function verifyRedactionEnv(env: Record<string, string> | undefined): Record<string, string> {
1168
- return Object.fromEntries(Object.entries(effectiveVerifyEnv(env)).filter(([key, value]) => {
1169
- return value.length >= 4 && SENSITIVE_ENV_KEY_PATTERN.test(key);
1170
- }));
1171
- }
1172
-
1173
- function redactVerifyEnv(value: string, env: Record<string, string> | undefined): string {
1174
- let redacted = value;
1175
- const secrets = [...new Set(Object.values(verifyRedactionEnv(env)).filter(Boolean))].sort((left, right) => right.length - left.length);
1176
- for (const secret of secrets) redacted = redacted.replaceAll(secret, "[REDACTED]");
1177
- return redacted;
1178
- }
1179
-
1180
- function uniqueStrings(items: Array<string | undefined>): string[] {
1181
- return unique(items.map((item) => item?.trim()).filter((item): item is string => Boolean(item)));
1182
- }
1183
-
1184
- export function aggregateAcceptanceReport(input: {
1185
- results: Array<Pick<SingleResult, "agent" | "acceptance" | "error"> & { exitCode: number | null }>;
1186
- notes?: string;
1187
- }): AcceptanceReport {
1188
- const childReports = input.results.map((result) => result.acceptance?.childReport).filter((report): report is AcceptanceReport => Boolean(report));
1189
- const blockers = input.results.filter((result) => result.exitCode !== 0 || result.acceptance?.status === "rejected");
1190
- const successfulChildren = input.results.length > 0 && blockers.length === 0;
1191
- return {
1192
- criteriaSatisfied: [
1193
- { id: "criterion-1", status: successfulChildren ? "satisfied" : "not-satisfied", evidence: successfulChildren ? `All ${input.results.length} dynamic child run(s) completed without child or acceptance blockers.` : "Dynamic fanout produced no accepted child evidence." },
1194
- { id: "criterion-2", status: successfulChildren ? "satisfied" : "not-satisfied", evidence: successfulChildren ? "Collected child acceptance evidence for aggregate review." : "Dynamic fanout produced no aggregate review evidence." },
1195
- ...input.results.map((result, index): { id?: string; status: "satisfied" | "not-satisfied" | "not-applicable"; evidence: string } => ({
1196
- id: `child-${index + 1}`,
1197
- status: result.exitCode === 0 && result.acceptance?.status !== "rejected" ? "satisfied" : "not-satisfied",
1198
- evidence: `${result.agent}: acceptance ${result.acceptance?.status ?? "unreported"}${result.error ? ` (${result.error})` : ""}`,
1199
- })),
1200
- ],
1201
- changedFiles: uniqueStrings(childReports.flatMap((report) => report.changedFiles ?? [])),
1202
- testsAddedOrUpdated: uniqueStrings(childReports.flatMap((report) => report.testsAddedOrUpdated ?? [])),
1203
- commandsRun: childReports.flatMap((report) => report.commandsRun ?? []),
1204
- validationOutput: uniqueStrings(childReports.flatMap((report) => report.validationOutput ?? [])),
1205
- residualRisks: uniqueStrings([
1206
- ...childReports.flatMap((report) => report.residualRisks ?? []),
1207
- ...blockers.map((result) => `${result.agent}: ${result.error ?? "child or acceptance gate failed"}`),
1208
- ]),
1209
- noStagedFiles: childReports.length > 0 && childReports.every((report) => report.noStagedFiles === true),
1210
- reviewFindings: uniqueStrings(childReports.flatMap((report) => report.reviewFindings ?? [])),
1211
- manualNotes: input.notes ?? `Aggregated acceptance evidence from ${input.results.length} dynamic fanout child run(s).`,
1212
- notes: input.notes,
1213
- };
1214
- }
1215
-
1216
- const DEFAULT_VERIFY_TIMEOUT_MS = 120_000;
1217
-
1218
- function hash(value: string): string {
1219
- return createHash("sha256").update(value).digest("hex");
1220
- }
1221
-
1222
- interface VerifyWorkspaceState {
1223
- kind: "git-tracked";
1224
- repoRoot: string;
1225
- cwdRelative: string;
1226
- head: string;
1227
- diffHash: string;
1228
- }
1229
-
1230
- function readVerifyWorkspaceState(cwd: string): VerifyWorkspaceState | undefined {
1231
- const repo = spawnSync("git", ["rev-parse", "--show-toplevel"], { cwd, encoding: "utf-8", windowsHide: true });
1232
- if (repo.status !== 0 || !repo.stdout.trim()) return undefined;
1233
- const repoRoot = fs.realpathSync(repo.stdout.trim());
1234
- const head = spawnSync("git", ["rev-parse", "HEAD"], { cwd: repoRoot, encoding: "utf-8", windowsHide: true });
1235
- const diff = spawnSync("git", ["diff", "--binary", "--full-index", "HEAD", "--"], { cwd: repoRoot, encoding: "utf-8", maxBuffer: 50 * 1024 * 1024, windowsHide: true });
1236
- if (head.status !== 0 || diff.status !== 0 || !head.stdout.trim()) return undefined;
1237
- return {
1238
- kind: "git-tracked",
1239
- repoRoot,
1240
- cwdRelative: path.relative(repoRoot, fs.realpathSync(cwd)) || ".",
1241
- head: head.stdout.trim(),
1242
- diffHash: hash(diff.stdout),
1243
- };
1244
- }
1245
-
1246
- function isCachedVerifyResult(value: unknown): value is AcceptanceVerifyResult {
1247
- if (!value || typeof value !== "object" || Array.isArray(value)) return false;
1248
- const result = value as Partial<AcceptanceVerifyResult>;
1249
- return typeof result.id === "string"
1250
- && typeof result.command === "string"
1251
- && (typeof result.exitCode === "number" || result.exitCode === null)
1252
- && (result.status === "passed" || result.status === "failed" || result.status === "timed-out" || result.status === "allowed-failure")
1253
- && typeof result.durationMs === "number";
1254
- }
1255
-
1256
- const TYPED_VERIFY_OUTPUT_MAX_BYTES = 12_000;
1257
-
1258
- /**
1259
- * A passing `output: "json"` command must print one JSON document on stdout.
1260
- * The parsed value becomes the run's structured output; anything else turns
1261
- * the passing run into a failed one so acceptance rejects rather than
1262
- * silently dropping the verdict. Stdout is already bounded by trimOutput, so a
1263
- * truncated document is detected by its marker instead of a parse guess.
1264
- */
1265
- async function applyTypedVerifyOutput(command: AcceptanceVerifyCommand, run: AcceptanceVerifyResult): Promise<void> {
1266
- if (run.status !== "passed") return;
1267
- const stdout = run.stdout ?? "";
1268
- const fail = (message: string): void => {
1269
- run.status = "failed";
1270
- run.structuredOutputError = message;
1271
- };
1272
- if (!stdout.trim()) return fail("output: \"json\" command printed nothing on stdout.");
1273
- if (stdout.endsWith("...[truncated]")) return fail(`output: "json" stdout exceeded ${TYPED_VERIFY_OUTPUT_MAX_BYTES} characters and was truncated.`);
1274
- let value: unknown;
1275
- try {
1276
- value = JSON.parse(stdout);
1277
- } catch (error) {
1278
- return fail(`output: "json" stdout is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
1279
- }
1280
- if (command.schema) {
1281
- const validation = await validateStructuredOutputValue(command.schema, value);
1282
- if (validation.status === "invalid") return fail(`output: "json" stdout does not match gate.schema: ${validation.message}`);
1283
- }
1284
- run.structuredOutput = value;
1285
- }
1286
-
1287
- /** The first typed verify result on a ledger, if any command produced one. */
1288
- export function typedVerifyOutput(ledger: AcceptanceLedger | undefined): { value: unknown } | undefined {
1289
- const run = ledger?.verifyRuns?.find((entry) => entry.structuredOutput !== undefined);
1290
- return run ? { value: run.structuredOutput } : undefined;
1291
- }
1292
-
1293
- async function runMemoizedVerifyCommand(command: AcceptanceVerifyCommand, defaultCwd: string, options: {
1294
- signal?: AbortSignal;
1295
- abortMessage?: string;
1296
- artifactsDir?: string;
1297
- runId?: string;
1298
- } = {}): Promise<AcceptanceVerifyResult> {
1299
- const cwd = command.cwd ? path.resolve(defaultCwd, command.cwd) : defaultCwd;
1300
- let workspaceState: VerifyWorkspaceState | undefined;
1301
- try {
1302
- workspaceState = readVerifyWorkspaceState(cwd);
1303
- } catch {
1304
- workspaceState = undefined;
1305
- }
1306
- // Typed gates read inputs (a report file, a log) that can change without
1307
- // the tracked tree changing, so their verdicts are never reused.
1308
- if (!workspaceState || !options.artifactsDir || !options.runId || command.output === "json") {
1309
- return runVerifyCommand(command, defaultCwd, options);
1310
- }
1311
- const envKeys = Object.keys(command.env ?? {}).sort();
1312
- const envHash = hash(JSON.stringify(Object.fromEntries(Object.entries(effectiveVerifyEnv(command.env)).sort(([left], [right]) => left.localeCompare(right)))));
1313
- const timeoutMs = command.timeoutMs ?? DEFAULT_VERIFY_TIMEOUT_MS;
1314
- const cacheKey = hash(JSON.stringify({
1315
- version: 1,
1316
- command: command.command,
1317
- cwdRelative: workspaceState.cwdRelative,
1318
- envKeys,
1319
- envHash,
1320
- timeoutMs,
1321
- allowFailure: command.allowFailure === true,
1322
- head: workspaceState.head,
1323
- diffHash: workspaceState.diffHash,
1324
- }));
1325
- const artifactPath = path.join(options.artifactsDir, "acceptance", "verify", options.runId, `${cacheKey}.json`);
1326
- try {
1327
- const cached = JSON.parse(fs.readFileSync(artifactPath, "utf-8")) as { cacheKey?: unknown; result?: unknown };
1328
- if (cached.cacheKey === cacheKey && isCachedVerifyResult(cached.result)) {
1329
- return { ...cached.result, id: command.id, command: command.command, cwd, artifactPath, cacheKey, memoized: true, envKeys, envHash, workspaceState };
1330
- }
1331
- } catch {
1332
- // A cache miss or unreadable artifact must not prevent host verification.
1333
- }
1334
- const result = await runVerifyCommand(command, defaultCwd, options);
1335
- const evidenced: AcceptanceVerifyResult = { ...result, artifactPath, cacheKey, memoized: false, envKeys, envHash, workspaceState };
1336
- try {
1337
- fs.mkdirSync(path.dirname(artifactPath), { recursive: true });
1338
- fs.writeFileSync(artifactPath, JSON.stringify({
1339
- version: 1,
1340
- cacheKey,
1341
- command: command.command,
1342
- cwdRelative: workspaceState.cwdRelative,
1343
- envKeys,
1344
- envHash,
1345
- timeoutMs,
1346
- allowFailure: command.allowFailure === true,
1347
- workspaceState,
1348
- result: evidenced,
1349
- }, null, 2), "utf-8");
1350
- } catch (error) {
1351
- evidenced.artifactError = error instanceof Error ? error.message : String(error);
1352
- delete evidenced.artifactPath;
1353
- }
1354
- return evidenced;
1355
- }
1356
-
1357
- /**
1358
- * On Windows with `shell: true`, cmd.exe parses the command line itself and an
1359
- * unquoted executable path containing spaces (e.g. `C:\Program Files\...\tool.exe`)
1360
- * is split at the first space, so cmd tries to run `C:\Program` and fails.
1361
- *
1362
- * The command line is ambiguous, so only an unquoted absolute drive path with
1363
- * a space in a directory component is safe to identify as an executable. That
1364
- * path is quoted; everything after it is preserved as arguments.
1365
- *
1366
- * Commands that already start with a quote, single-token commands, and commands
1367
- * whose first token already ends in an executable extension are returned
1368
- * unchanged. Non-Windows platforms pass the command through untouched.
1369
- */
1370
- export function quoteExecutableForShell(command: string, platform: string = process.platform): string {
1371
- if (platform !== "win32") return command;
1372
- const trimmed = command.trimStart();
1373
- if (trimmed.startsWith("\"")) return command;
1374
- const firstToken = trimmed.match(/^\S+/)?.[0];
1375
- if (/\.(?:exe|bat|cmd|com|ps1)$/i.test(firstToken ?? "")) return command;
1376
- const match = trimmed.match(/^([A-Za-z]:\\[^"<>|&*?\r\n]*?\s[^"<>|&*?\r\n]*?\\[^"<>|&*?\r\n]*?\.(?:exe|bat|cmd|com|ps1))(?=\s|$)/i);
1377
- const executable = match?.[1];
1378
- if (executable && /\s/.test(executable) && !/[A-Za-z]:\\/.test(executable.slice(3))) {
1379
- const rest = trimmed.slice(executable.length);
1380
- const leading = command.slice(0, command.length - trimmed.length);
1381
- return `${leading}"${executable}"${rest}`;
1382
- }
1383
- const extensionlessSpacedFilenameMatch = trimmed.match(/^([A-Za-z]:\\[^"<>|&*?\r\n]*?\s[^"<>|&*?\r\n]*?)(?=\s+--|$)/i);
1384
- const extensionlessSpacedFilename = extensionlessSpacedFilenameMatch?.[1];
1385
- if (extensionlessSpacedFilename && /\s/.test(extensionlessSpacedFilename.slice(0, extensionlessSpacedFilename.lastIndexOf("\\"))) && !/[A-Za-z]:\\/.test(extensionlessSpacedFilename.slice(3))) {
1386
- const rest = trimmed.slice(extensionlessSpacedFilename.length);
1387
- const leading = command.slice(0, command.length - trimmed.length);
1388
- return `${leading}"${extensionlessSpacedFilename}"${rest}`;
1389
- }
1390
- const extensionlessMatch = trimmed.match(/^([A-Za-z]:\\[^"<>|&*?\r\n]*?\s[^"<>|&*?\r\n]*?\\[^"<>|&*?\s\r\n]+)(?=\s|$)/i);
1391
- const extensionlessExecutable = extensionlessMatch?.[1];
1392
- if (extensionlessExecutable && /\s/.test(extensionlessExecutable) && !/[A-Za-z]:\\/.test(extensionlessExecutable.slice(3)) && !/\s/.test(extensionlessExecutable.slice(extensionlessExecutable.lastIndexOf("\\") + 1))) {
1393
- const rest = trimmed.slice(extensionlessExecutable.length);
1394
- const leading = command.slice(0, command.length - trimmed.length);
1395
- return `${leading}"${extensionlessExecutable}"${rest}`;
1396
- }
1397
- return command;
1398
- }
1399
-
1400
- function runVerifyCommand(command: AcceptanceVerifyCommand, defaultCwd: string, options: { signal?: AbortSignal; abortMessage?: string } = {}): Promise<AcceptanceVerifyResult> {
1401
- return new Promise((resolve) => {
1402
- const startedAt = Date.now();
1403
- const cwd = command.cwd ? path.resolve(defaultCwd, command.cwd) : defaultCwd;
1404
- let stdout = "";
1405
- let stderr = "";
1406
- let timedOut = false;
1407
- let settled = false;
1408
- let hardKill: NodeJS.Timeout | undefined;
1409
- const child = spawn(quoteExecutableForShell(command.command), {
1410
- cwd,
1411
- env: effectiveVerifyEnv(command.env),
1412
- shell: true,
1413
- stdio: ["ignore", "pipe", "pipe"],
1414
- windowsHide: true,
1415
- });
1416
- const finish = (result: Omit<AcceptanceVerifyResult, "id" | "command" | "cwd" | "durationMs">) => {
1417
- if (settled) return;
1418
- settled = true;
1419
- clearTimeout(timeout);
1420
- if (hardKill) clearTimeout(hardKill);
1421
- options.signal?.removeEventListener("abort", abortVerification);
1422
- resolve({
1423
- id: command.id,
1424
- command: command.command,
1425
- cwd,
1426
- durationMs: Date.now() - startedAt,
1427
- ...result,
1428
- });
1429
- };
1430
- const abortVerification = () => {
1431
- if (settled || timedOut) return;
1432
- timedOut = true;
1433
- child.kill("SIGTERM");
1434
- hardKill = setTimeout(() => {
1435
- child.kill("SIGKILL");
1436
- finish({
1437
- exitCode: null,
1438
- status: "timed-out",
1439
- stdout: trimOutput(redactVerifyEnv(stdout, command.env)),
1440
- stderr: trimOutput(redactVerifyEnv(stderr || options.abortMessage || "Acceptance verification timed out.", command.env)),
1441
- });
1442
- }, 1000);
1443
- hardKill.unref?.();
1444
- };
1445
- const timeout = setTimeout(abortVerification, command.timeoutMs ?? DEFAULT_VERIFY_TIMEOUT_MS);
1446
- timeout.unref?.();
1447
- if (options.signal?.aborted) abortVerification();
1448
- else options.signal?.addEventListener("abort", abortVerification, { once: true });
1449
- child.stdout.on("data", (chunk: Buffer) => {
1450
- stdout += chunk.toString();
1451
- });
1452
- child.stderr.on("data", (chunk: Buffer) => {
1453
- stderr += chunk.toString();
1454
- });
1455
- child.on("close", (exitCode) => {
1456
- const passed = exitCode === 0 && !timedOut;
1457
- finish({
1458
- exitCode,
1459
- status: timedOut ? "timed-out" : passed ? "passed" : command.allowFailure ? "allowed-failure" : "failed",
1460
- stdout: trimOutput(redactVerifyEnv(stdout, command.env)),
1461
- stderr: trimOutput(redactVerifyEnv(stderr || (timedOut ? options.abortMessage ?? "" : ""), command.env)),
1462
- });
1463
- });
1464
- child.on("error", (error) => {
1465
- finish({
1466
- exitCode: timedOut ? null : 1,
1467
- status: timedOut ? "timed-out" : command.allowFailure ? "allowed-failure" : "failed",
1468
- stderr: timedOut
1469
- ? trimOutput(redactVerifyEnv(stderr || options.abortMessage || "Acceptance verification timed out.", command.env))
1470
- : redactVerifyEnv(error instanceof Error ? error.message : String(error), command.env),
1471
- });
1472
- });
1473
- });
1474
- }
1475
-
1476
- export async function evaluateAcceptance(input: {
1477
- acceptance: ResolvedAcceptanceConfig;
1478
- output: string;
1479
- cwd: string;
1480
- /** Host-captured launch index tree; required by preserveStagedIndex. */
1481
- stagedIndexBaseline?: string;
1482
- /**
1483
- * Content the child sent to its configured output file (from its own write
1484
- * tool calls, not from disk, so a concurrent writer to the same path cannot
1485
- * be misattributed). Searched for the acceptance report; searched before
1486
- * the assistant output when `authoritative` (outputMode "file-only").
1487
- */
1488
- fileOutput?: { content: string; path: string; authoritative?: boolean; durable?: boolean };
1489
- report?: AcceptanceReport;
1490
- reportError?: string;
1491
- reviewResult?: AcceptanceReviewResult;
1492
- signal?: AbortSignal;
1493
- abortMessage?: string;
1494
- reportOptional?: boolean;
1495
- artifactsDir?: string;
1496
- runId?: string;
1497
- watchdog?: ChildWatchdogProgress;
1498
- }): Promise<AcceptanceLedger> {
1499
- const acceptance = input.acceptance;
1500
- const initialStatus = acceptance.level === "none" ? "not-required" : "claimed";
1501
- const ledger: AcceptanceLedger = {
1502
- status: initialStatus,
1503
- evidenceStatus: initialStatus,
1504
- explicit: acceptance.explicit,
1505
- effectiveAcceptance: acceptance,
1506
- inferredReason: acceptance.inferredReason,
1507
- criteria: acceptance.criteria,
1508
- runtimeChecks: [],
1509
- verifyRuns: [],
1510
- };
1511
- if (acceptance.level === "none") return ledger;
1512
-
1513
- if (input.watchdog) {
1514
- const unresolved = unresolvedChildWatchdogBlockers(input.watchdog);
1515
- ledger.runtimeChecks.push(unresolved.length
1516
- ? { id: "watchdog-blocker", status: "failed", message: "Unresolved watchdog blocker (details are available in child watchdog status)." }
1517
- : { id: "watchdog-blocker", status: "passed", message: "No unresolved watchdog blockers." });
1518
- }
1519
-
1520
- const parsed: AcceptanceReportParseResult = input.reportError
1521
- ? { error: input.reportError }
1522
- : input.report !== undefined
1523
- ? (() => {
1524
- const validation = validateAcceptanceReport(input.report);
1525
- return validation.report
1526
- ? { report: validation.report }
1527
- : { error: `Failed to parse acceptance-report: Invalid acceptance-report: ${validation.errors.join("; ")}`, malformed: true };
1528
- })()
1529
- : parseAcceptanceReportSources(input.output, input.fileOutput);
1530
- const durableFileOutput = input.fileOutput?.authoritative && input.fileOutput.durable ? input.fileOutput : undefined;
1531
- if (parsed.malformed && parsed.sourcePath && durableFileOutput) {
1532
- ledger.recovery = {
1533
- status: "available-for-review",
1534
- reason: "acceptance-metadata-rejected",
1535
- reportPath: parsed.sourcePath,
1536
- reportHash: hash(durableFileOutput.content),
1537
- };
1538
- }
1539
- const needsReport = acceptanceRequiresChildReport(acceptance);
1540
- if (parsed.report) {
1541
- ledger.childReport = parsed.report;
1542
- ledger.status = "attested";
1543
- ledger.evidenceStatus = "attested";
1544
- } else if (!input.reportOptional || needsReport || parsed.error !== ACCEPTANCE_REPORT_NOT_FOUND) {
1545
- ledger.childReportParseError = parsed.error;
1546
- ledger.runtimeChecks.push({ id: "attestation", status: "failed", message: parsed.error ?? "Structured acceptance report missing." });
1547
- if (ledger.recovery) {
1548
- ledger.status = "rejected";
1549
- ledger.evidenceStatus = "rejected";
1550
- }
1551
- if (!input.reportOptional) {
1552
- ledger.status = "rejected";
1553
- ledger.evidenceStatus = "rejected";
1554
- return ledger;
1555
- }
1556
- } else {
1557
- ledger.childReportParseError = parsed.error;
1558
- }
1559
-
1560
- if (parsed.report && LEVEL_RANK[acceptance.level] >= LEVEL_RANK.checked) {
1561
- ledger.runtimeChecks = [
1562
- ...ledger.runtimeChecks,
1563
- ...checkCriteriaSatisfied(acceptance.criteria, parsed.report),
1564
- ...runStructuralChecks(acceptance, parsed.report, input.cwd),
1565
- ];
1566
- if (!ledger.runtimeChecks.some((check) => check.status === "failed")) {
1567
- ledger.status = "checked";
1568
- ledger.evidenceStatus = "checked";
1569
- }
1570
- }
1571
-
1572
- if (LEVEL_RANK[acceptance.level] >= LEVEL_RANK.verified && (acceptance.level === "verified" || acceptance.verify.length > 0)) {
1573
- if (acceptance.level === "verified" && acceptance.verify.length === 0) {
1574
- ledger.runtimeChecks.push({ id: "verification-config", status: "failed", message: "verified acceptance requires runtime verify commands." });
1575
- ledger.status = "rejected";
1576
- ledger.evidenceStatus = "rejected";
1577
- } else {
1578
- ledger.verifyRuns = [];
1579
- for (const command of acceptance.verify) {
1580
- const run = await runMemoizedVerifyCommand(command, input.cwd, {
1581
- signal: input.signal,
1582
- abortMessage: input.abortMessage,
1583
- artifactsDir: input.artifactsDir,
1584
- runId: input.runId,
1585
- });
1586
- if (command.output === "json") await applyTypedVerifyOutput(command, run);
1587
- ledger.verifyRuns.push(run);
1588
- if (input.signal?.aborted) break;
1589
- }
1590
- if (ledger.verifyRuns.some((run) => run.status === "failed" || run.status === "timed-out")) {
1591
- ledger.status = "rejected";
1592
- ledger.evidenceStatus = "rejected";
1593
- } else if (!ledger.runtimeChecks.some((check) => check.status === "failed")) {
1594
- ledger.status = "verified";
1595
- ledger.evidenceStatus = "verified";
1596
- }
1597
- }
1598
- }
1599
-
1600
- if (acceptance.preserveStagedIndex) {
1601
- ledger.runtimeChecks.push(input.stagedIndexBaseline
1602
- ? checkStagedIndexUnchanged(input.cwd, input.stagedIndexBaseline)
1603
- : { id: "staged-index-unchanged", status: "failed", message: "Staged index launch baseline is unavailable." });
1604
- }
1605
-
1606
- if (ledger.status === "rejected" || ledger.runtimeChecks.some((check) => check.status === "failed")) {
1607
- ledger.status = "rejected";
1608
- ledger.evidenceStatus = "rejected";
1609
- return ledger;
1610
- }
1611
- if (ledger.status === "claimed") {
1612
- ledger.status = acceptance.level === "verified" ? "verified" : acceptance.level;
1613
- ledger.evidenceStatus = ledger.status;
1614
- }
1615
-
1616
- if (acceptance.review) {
1617
- if (input.reviewResult?.status === "reviewed") {
1618
- ledger.reviewResult = input.reviewResult;
1619
- ledger.status = "reviewed";
1620
- } else if (input.reviewResult?.status === "blockers") {
1621
- ledger.reviewResult = input.reviewResult;
1622
- ledger.status = "rejected";
1623
- } else if (acceptance.review.required !== false) {
1624
- ledger.reviewResult = input.reviewResult ?? {
1625
- status: "review-required",
1626
- findings: [{
1627
- severity: "non-blocking",
1628
- issue: "Independent review has not been supplied.",
1629
- rationale: "The run cannot be marked reviewed from child evidence alone.",
1630
- }],
1631
- };
1632
- ledger.status = "review-required";
1633
- }
1634
- }
1635
-
1636
- return ledger;
1637
- }
1638
-
1639
- export function buildSkippedAcceptanceLedger(acceptance: ResolvedAcceptanceConfig, input: { id: string; message: string }): AcceptanceLedger {
1640
- const status = acceptance.level === "none" ? "not-required" : "rejected";
1641
- return {
1642
- status,
1643
- evidenceStatus: status,
1644
- explicit: acceptance.explicit,
1645
- effectiveAcceptance: acceptance,
1646
- inferredReason: acceptance.inferredReason,
1647
- criteria: acceptance.criteria,
1648
- runtimeChecks: acceptance.level === "none"
1649
- ? []
1650
- : [{ id: input.id, status: "failed", message: input.message }],
1651
- verifyRuns: [],
1652
- };
1653
- }
1654
-
1655
- export function acceptanceFailureMessage(ledger: AcceptanceLedger): string | undefined {
1656
- if (ledger.status !== "rejected") return undefined;
1657
- const failedCheck = ledger.runtimeChecks.find((check) => check.status === "failed");
1658
- if (failedCheck) return `Acceptance rejected: ${failedCheck.message}`;
1659
- const failedVerify = ledger.verifyRuns.find((run) => run.status === "failed" || run.status === "timed-out");
1660
- if (failedVerify?.structuredOutputError) return `Acceptance verification '${failedVerify.id}' failed: ${failedVerify.structuredOutputError}`;
1661
- if (failedVerify) return `Acceptance verification '${failedVerify.id}' ${failedVerify.status}.`;
1662
- if (ledger.reviewResult?.status === "blockers") return "Acceptance review found blockers.";
1663
- return "Acceptance rejected.";
1664
- }