@xzzpig/pi-subagents 0.22.0 → 0.24.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1133) hide show
  1. package/CHANGELOG.md +346 -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-3G4JXNZ4.js +4130 -0
  14. package/bundle/chunk-3U633XDZ.js +749 -0
  15. package/bundle/chunk-4QFZZV3O.js +57 -0
  16. package/bundle/chunk-62OCY2S4.js +14 -0
  17. package/bundle/chunk-7J4ZXMY7.js +18 -0
  18. package/bundle/chunk-7K3Z6DM7.js +276 -0
  19. package/bundle/chunk-BGIYHF2W.js +138 -0
  20. package/bundle/chunk-CTPAE36Y.js +94 -0
  21. package/bundle/chunk-D4EHT5SJ.js +14 -0
  22. package/bundle/chunk-ED55MIC2.js +1681 -0
  23. package/bundle/chunk-F3NSN7UH.js +7331 -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-KD2IMFN4.js +1310 -0
  28. package/bundle/chunk-LCDJWBVM.js +57 -0
  29. package/bundle/chunk-LPVUHUZ7.js +5503 -0
  30. package/bundle/chunk-MYCL5QEJ.js +1372 -0
  31. package/bundle/chunk-NCWCVJLT.js +1768 -0
  32. package/bundle/chunk-NIXWDZZV.js +9 -0
  33. package/bundle/chunk-NTRJDXBC.js +4175 -0
  34. package/bundle/chunk-OFGSZBHP.js +16924 -0
  35. package/bundle/chunk-OTLRAB22.js +143 -0
  36. package/bundle/chunk-QXASAHIA.js +173 -0
  37. package/bundle/chunk-RB4GELQA.js +458 -0
  38. package/bundle/chunk-RK2HDPLK.js +1234 -0
  39. package/bundle/chunk-SW2VMNIU.js +526 -0
  40. package/bundle/chunk-T65XRVVM.js +940 -0
  41. package/bundle/chunk-U4ODUYAG.js +235 -0
  42. package/bundle/chunk-UFNSLL5D.js +9796 -0
  43. package/bundle/chunk-UKG4V45O.js +228 -0
  44. package/bundle/chunk-UQDHXMUG.js +264 -0
  45. package/bundle/chunk-V2KFIGFH.js +8774 -0
  46. package/bundle/chunk-VO3G7HI3.js +85 -0
  47. package/bundle/chunk-WPW4V6HM.js +227 -0
  48. package/bundle/chunk-WW76JRIX.js +175 -0
  49. package/bundle/chunk-XA3DY6UG.js +161 -0
  50. package/bundle/chunk-YFCK7H2S.js +129 -0
  51. package/bundle/chunk-YYREO77V.js +137 -0
  52. package/bundle/chunk-Z6TFJ6BR.js +400 -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/missions.md +2 -0
  70. package/docs/observability.md +20 -5
  71. package/docs/standalone-background.md +8 -6
  72. package/docs/tool-reference.md +18 -5
  73. package/docs/workflows.md +25 -7
  74. package/index.d.ts +3 -0
  75. package/index.js +14 -0
  76. package/node_modules/@xzzpig/pi-components/package.json +1 -2
  77. package/package.json +107 -87
  78. package/skills/council-mode/SKILL.md +1 -4
  79. package/skills/pi-subagents/SKILL.md +130 -106
  80. package/skills/pi-subagents/references/orchestration.md +124 -0
  81. package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
  82. package/src/agents/advertised-agent-prompt.d.ts +13 -0
  83. package/src/agents/advertised-agent-prompt.js +68 -0
  84. package/src/agents/agent-eject.d.ts +39 -0
  85. package/src/agents/agent-eject.js +263 -0
  86. package/src/agents/agent-management.d.ts +33 -0
  87. package/src/agents/agent-management.js +1541 -0
  88. package/src/agents/agent-memory.d.ts +48 -0
  89. package/src/agents/agent-memory.js +350 -0
  90. package/src/agents/agent-refinements.d.ts +99 -0
  91. package/src/agents/agent-refinements.js +568 -0
  92. package/src/agents/agent-scope.d.ts +3 -0
  93. package/src/agents/agent-scope.js +8 -0
  94. package/src/agents/agent-selection.d.ts +2 -0
  95. package/src/agents/agent-selection.js +22 -0
  96. package/src/agents/agent-serializer.d.ts +7 -0
  97. package/src/agents/agent-serializer.js +213 -0
  98. package/src/agents/agents.d.ts +352 -0
  99. package/src/agents/agents.js +2817 -0
  100. package/src/agents/builtin-names.d.ts +1 -0
  101. package/src/agents/builtin-names.js +16 -0
  102. package/src/agents/chain-serializer.d.ts +6 -0
  103. package/src/agents/chain-serializer.js +318 -0
  104. package/src/agents/frontmatter.d.ts +19 -0
  105. package/src/agents/frontmatter.js +166 -0
  106. package/src/agents/global-npm-root.d.ts +6 -0
  107. package/src/agents/global-npm-root.js +57 -0
  108. package/src/agents/identity.d.ts +7 -0
  109. package/src/agents/identity.js +29 -0
  110. package/src/agents/proactive-skills.d.ts +35 -0
  111. package/src/agents/proactive-skills.js +155 -0
  112. package/src/agents/runtime-agent-events.d.ts +26 -0
  113. package/src/agents/runtime-agent-events.js +52 -0
  114. package/src/agents/runtime-agent-registry.d.ts +66 -0
  115. package/src/agents/runtime-agent-registry.js +415 -0
  116. package/src/agents/runtime-discovery.d.ts +13 -0
  117. package/src/agents/runtime-discovery.js +27 -0
  118. package/src/agents/skills.d.ts +34 -0
  119. package/src/agents/skills.js +718 -0
  120. package/src/api/agent-management.d.ts +2 -0
  121. package/src/api/agent-management.js +2 -0
  122. package/src/api/agents.d.ts +6 -0
  123. package/src/api/agents.js +3 -0
  124. package/src/api/background-work.d.ts +41 -0
  125. package/src/api/background-work.js +171 -0
  126. package/src/api/capability-ceiling.d.ts +1 -0
  127. package/src/api/capability-ceiling.js +1 -0
  128. package/src/api/child-tool-plan.d.ts +1 -0
  129. package/src/api/child-tool-plan.js +1 -0
  130. package/src/api/control-channel.d.ts +1 -0
  131. package/src/api/control-channel.js +1 -0
  132. package/src/api/delegation.d.ts +132 -0
  133. package/src/api/delegation.js +8 -0
  134. package/src/api/external-job-provider.d.ts +57 -0
  135. package/src/api/external-job-provider.js +139 -0
  136. package/src/api/external-runs.d.ts +47 -0
  137. package/src/api/external-runs.js +245 -0
  138. package/src/api/inspectors.d.ts +20 -0
  139. package/src/api/inspectors.js +11 -0
  140. package/src/api/intercom-bridge.d.ts +1 -0
  141. package/src/api/intercom-bridge.js +1 -0
  142. package/src/api/preflight.d.ts +183 -0
  143. package/src/api/preflight.js +455 -0
  144. package/src/api/project-panes.d.ts +7 -0
  145. package/src/api/project-panes.js +7 -0
  146. package/src/api/required-child-extensions.d.ts +1 -0
  147. package/src/api/required-child-extensions.js +1 -0
  148. package/src/api/shared-types.d.ts +1 -0
  149. package/src/api/shared-types.js +1 -0
  150. package/src/api/supervisor-routing.d.ts +110 -0
  151. package/src/api/supervisor-routing.js +95 -0
  152. package/src/api/workflow-resources.d.ts +2 -0
  153. package/src/api/workflow-resources.js +1 -0
  154. package/src/extension/active-runs-prompt.d.ts +7 -0
  155. package/src/extension/active-runs-prompt.js +29 -0
  156. package/src/extension/config.d.ts +7 -0
  157. package/src/extension/config.js +290 -0
  158. package/src/extension/context-injection.d.ts +52 -0
  159. package/src/extension/context-injection.js +102 -0
  160. package/src/extension/control-notices.d.ts +18 -0
  161. package/src/extension/control-notices.js +29 -0
  162. package/src/extension/declaration-pinning.d.ts +18 -0
  163. package/src/extension/declaration-pinning.js +167 -0
  164. package/src/extension/doctor.d.ts +34 -0
  165. package/src/extension/doctor.js +236 -0
  166. package/src/extension/fanout-child.d.ts +6 -0
  167. package/src/extension/fanout-child.js +278 -0
  168. package/src/extension/herdr-pi-bridge.d.ts +16 -0
  169. package/src/extension/herdr-pi-bridge.js +261 -0
  170. package/src/extension/index.d.ts +18 -0
  171. package/src/extension/index.js +1288 -0
  172. package/src/extension/public-execution.d.ts +71 -0
  173. package/src/extension/public-execution.js +214 -0
  174. package/src/extension/reply-workflow-script.d.ts +11 -0
  175. package/src/extension/reply-workflow-script.js +71 -0
  176. package/src/extension/rpc.d.ts +84 -0
  177. package/src/extension/rpc.js +729 -0
  178. package/src/extension/schemas.d.ts +276 -0
  179. package/src/extension/schemas.js +311 -0
  180. package/src/extension/steering-notices.d.ts +14 -0
  181. package/src/extension/steering-notices.js +22 -0
  182. package/src/extension/subagent-guide.d.ts +4 -0
  183. package/src/extension/subagent-guide.js +114 -0
  184. package/src/extension/subagent-options.d.ts +7 -0
  185. package/src/extension/subagent-options.js +64 -0
  186. package/src/extension/tool-activation.d.ts +7 -0
  187. package/src/extension/tool-activation.js +185 -0
  188. package/src/extension/tool-description.d.ts +19 -0
  189. package/src/extension/tool-description.js +169 -0
  190. package/src/extension/tool-result.d.ts +9 -0
  191. package/src/extension/tool-result.js +16 -0
  192. package/src/extension/upgrade-notice.d.ts +6 -0
  193. package/src/extension/upgrade-notice.js +42 -0
  194. package/src/inspectors/actions.d.ts +24 -0
  195. package/src/inspectors/actions.js +182 -0
  196. package/src/inspectors/ghostty/actions.d.ts +11 -0
  197. package/src/inspectors/ghostty/actions.js +62 -0
  198. package/src/inspectors/ghostty/plugin.d.ts +7 -0
  199. package/src/inspectors/ghostty/plugin.js +23 -0
  200. package/src/inspectors/herdr/actions.d.ts +25 -0
  201. package/src/inspectors/herdr/actions.js +133 -0
  202. package/src/inspectors/herdr/client.d.ts +41 -0
  203. package/src/inspectors/herdr/client.js +129 -0
  204. package/src/inspectors/herdr/focus.d.ts +24 -0
  205. package/src/inspectors/herdr/focus.js +49 -0
  206. package/src/inspectors/herdr/plugin.d.ts +6 -0
  207. package/src/inspectors/herdr/plugin.js +14 -0
  208. package/src/inspectors/herdr/project-panes.d.ts +136 -0
  209. package/src/inspectors/herdr/project-panes.js +610 -0
  210. package/src/inspectors/inspector-runner.d.ts +23 -0
  211. package/src/inspectors/inspector-runner.js +161 -0
  212. package/src/inspectors/plugins.d.ts +8 -0
  213. package/src/inspectors/plugins.js +82 -0
  214. package/src/inspectors/session-roots-codec.d.ts +15 -0
  215. package/src/inspectors/session-roots-codec.js +32 -0
  216. package/src/inspectors/shell-command.d.ts +1 -0
  217. package/src/inspectors/shell-command.js +16 -0
  218. package/src/inspectors/tmux/actions.d.ts +25 -0
  219. package/src/inspectors/tmux/actions.js +181 -0
  220. package/src/inspectors/tmux/client.d.ts +27 -0
  221. package/src/inspectors/tmux/client.js +64 -0
  222. package/src/inspectors/tmux/plugin.d.ts +7 -0
  223. package/src/inspectors/tmux/plugin.js +14 -0
  224. package/src/inspectors/types.d.ts +48 -0
  225. package/src/inspectors/types.js +1 -0
  226. package/src/integrations/herdr-status.d.ts +47 -0
  227. package/src/integrations/herdr-status.js +350 -0
  228. package/src/integrations/pi-web-session-liveness.d.ts +19 -0
  229. package/src/integrations/pi-web-session-liveness.js +53 -0
  230. package/src/integrations/program-status.d.ts +30 -0
  231. package/src/integrations/program-status.js +188 -0
  232. package/src/intercom/fork-supervisor-routing.d.ts +90 -0
  233. package/src/intercom/fork-supervisor-routing.js +392 -0
  234. package/src/intercom/intercom-bridge.d.ts +58 -0
  235. package/src/intercom/intercom-bridge.js +193 -0
  236. package/src/intercom/native-supervisor-channel.d.ts +97 -0
  237. package/src/intercom/native-supervisor-channel.js +1184 -0
  238. package/src/intercom/result-intercom.d.ts +35 -0
  239. package/src/intercom/result-intercom.js +376 -0
  240. package/src/intercom/supervisor-ui.d.ts +29 -0
  241. package/src/intercom/supervisor-ui.js +49 -0
  242. package/src/missions/actions.d.ts +54 -0
  243. package/src/missions/actions.js +400 -0
  244. package/src/missions/goal-driver.d.ts +16 -0
  245. package/src/missions/goal-driver.js +171 -0
  246. package/src/missions/lifecycle.d.ts +50 -0
  247. package/src/missions/lifecycle.js +388 -0
  248. package/src/missions/store.d.ts +21 -0
  249. package/src/missions/store.js +605 -0
  250. package/src/missions/types.d.ts +169 -0
  251. package/src/missions/types.js +9 -0
  252. package/src/missions/workflow-state.d.ts +14 -0
  253. package/src/missions/workflow-state.js +273 -0
  254. package/src/policy/authority.d.ts +9 -0
  255. package/src/policy/authority.js +41 -0
  256. package/src/profiles/profiles.d.ts +134 -0
  257. package/src/profiles/profiles.js +526 -0
  258. package/src/runs/background/active-async-capacity.d.ts +115 -0
  259. package/src/runs/background/active-async-capacity.js +517 -0
  260. package/src/runs/background/active-run-index.d.ts +12 -0
  261. package/src/runs/background/active-run-index.js +157 -0
  262. package/src/runs/background/async-execution.d.ts +304 -0
  263. package/src/runs/background/async-execution.js +2206 -0
  264. package/src/runs/background/async-job-tracker.d.ts +37 -0
  265. package/src/runs/background/async-job-tracker.js +921 -0
  266. package/src/runs/background/async-resume.d.ts +60 -0
  267. package/src/runs/background/async-resume.js +707 -0
  268. package/src/runs/background/async-retention.d.ts +45 -0
  269. package/src/runs/background/async-retention.js +932 -0
  270. package/src/runs/background/async-status-snapshot.d.ts +9 -0
  271. package/src/runs/background/async-status-snapshot.js +26 -0
  272. package/src/runs/background/async-status.d.ts +177 -0
  273. package/src/runs/background/async-status.js +710 -0
  274. package/src/runs/background/auto-drain.d.ts +16 -0
  275. package/src/runs/background/auto-drain.js +71 -0
  276. package/src/runs/background/await-async-run.d.ts +26 -0
  277. package/src/runs/background/await-async-run.js +83 -0
  278. package/src/runs/background/binary-bootstrap.d.ts +8 -0
  279. package/src/runs/background/binary-bootstrap.js +69 -0
  280. package/src/runs/background/boot-id.d.ts +12 -0
  281. package/src/runs/background/boot-id.js +47 -0
  282. package/src/runs/background/calendar-schedule.d.ts +26 -0
  283. package/src/runs/background/calendar-schedule.js +93 -0
  284. package/src/runs/background/chain-append.d.ts +34 -0
  285. package/src/runs/background/chain-append.js +299 -0
  286. package/src/runs/background/chain-root-attachment.d.ts +51 -0
  287. package/src/runs/background/chain-root-attachment.js +186 -0
  288. package/src/runs/background/completion-batcher.d.ts +51 -0
  289. package/src/runs/background/completion-batcher.js +119 -0
  290. package/src/runs/background/completion-dedupe.d.ts +13 -0
  291. package/src/runs/background/completion-dedupe.js +48 -0
  292. package/src/runs/background/completion-replay.d.ts +47 -0
  293. package/src/runs/background/completion-replay.js +266 -0
  294. package/src/runs/background/control-channel.d.ts +170 -0
  295. package/src/runs/background/control-channel.js +610 -0
  296. package/src/runs/background/fleet-view.d.ts +63 -0
  297. package/src/runs/background/fleet-view.js +666 -0
  298. package/src/runs/background/index-segment.d.ts +16 -0
  299. package/src/runs/background/index-segment.js +58 -0
  300. package/src/runs/background/inspect-rpc.d.ts +64 -0
  301. package/src/runs/background/inspect-rpc.js +422 -0
  302. package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
  303. package/src/runs/background/interrupted-elsewhere.js +68 -0
  304. package/src/runs/background/notify.d.ts +214 -0
  305. package/src/runs/background/notify.js +1001 -0
  306. package/src/runs/background/owned-process-tree.d.ts +10 -0
  307. package/src/runs/background/owned-process-tree.js +116 -0
  308. package/src/runs/background/parallel-groups.d.ts +3 -0
  309. package/src/runs/background/parallel-groups.js +46 -0
  310. package/src/runs/background/pid-namespace.d.ts +2 -0
  311. package/src/runs/background/pid-namespace.js +19 -0
  312. package/src/runs/background/process-terminal-candidate.d.ts +17 -0
  313. package/src/runs/background/process-terminal-candidate.js +96 -0
  314. package/src/runs/background/process-terminal.d.ts +21 -0
  315. package/src/runs/background/process-terminal.js +227 -0
  316. package/src/runs/background/result-delivery-ownership.d.ts +14 -0
  317. package/src/runs/background/result-delivery-ownership.js +38 -0
  318. package/src/runs/background/result-files.d.ts +63 -0
  319. package/src/runs/background/result-files.js +629 -0
  320. package/src/runs/background/result-watcher.d.ts +92 -0
  321. package/src/runs/background/result-watcher.js +819 -0
  322. package/src/runs/background/resume-guidance.d.ts +4 -0
  323. package/src/runs/background/resume-guidance.js +57 -0
  324. package/src/runs/background/retained-children.d.ts +24 -0
  325. package/src/runs/background/retained-children.js +128 -0
  326. package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
  327. package/src/runs/background/retained-nested-route-tracker.js +90 -0
  328. package/src/runs/background/run-child-session.d.ts +123 -0
  329. package/src/runs/background/run-child-session.js +670 -0
  330. package/src/runs/background/run-id-query.d.ts +3 -0
  331. package/src/runs/background/run-id-query.js +6 -0
  332. package/src/runs/background/run-id-resolver.d.ts +22 -0
  333. package/src/runs/background/run-id-resolver.js +172 -0
  334. package/src/runs/background/run-status.d.ts +25 -0
  335. package/src/runs/background/run-status.js +850 -0
  336. package/src/runs/background/runner-aliases.d.ts +17 -0
  337. package/src/runs/background/runner-aliases.js +191 -0
  338. package/src/runs/background/runner-child-launch.d.ts +24 -0
  339. package/src/runs/background/runner-child-launch.js +72 -0
  340. package/src/runs/background/runner-child-sessions.d.ts +6 -0
  341. package/src/runs/background/runner-child-sessions.js +34 -0
  342. package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
  343. package/src/runs/background/runner-http-dispatcher.js +115 -0
  344. package/src/runs/background/runner-startup-failure.d.ts +13 -0
  345. package/src/runs/background/runner-startup-failure.js +46 -0
  346. package/src/runs/background/scheduled-runs.d.ts +127 -0
  347. package/src/runs/background/scheduled-runs.js +1265 -0
  348. package/src/runs/background/stale-run-reconciler.d.ts +62 -0
  349. package/src/runs/background/stale-run-reconciler.js +509 -0
  350. package/src/runs/background/steering.d.ts +51 -0
  351. package/src/runs/background/steering.js +246 -0
  352. package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
  353. package/src/runs/background/subagent-runner-bootstrap.js +283 -0
  354. package/src/runs/background/subagent-runner.d.ts +210 -0
  355. package/src/runs/background/subagent-runner.js +4963 -0
  356. package/src/runs/background/subagent-wait.d.ts +124 -0
  357. package/src/runs/background/subagent-wait.js +756 -0
  358. package/src/runs/background/terminal-run-index.d.ts +10 -0
  359. package/src/runs/background/terminal-run-index.js +209 -0
  360. package/src/runs/background/top-level-async.d.ts +7 -0
  361. package/src/runs/background/top-level-async.js +5 -0
  362. package/src/runs/background/wait-completions.d.ts +28 -0
  363. package/src/runs/background/wait-completions.js +264 -0
  364. package/src/runs/background/wait-config.d.ts +8 -0
  365. package/src/runs/background/wait-config.js +46 -0
  366. package/src/runs/background/wait-subscriptions.d.ts +26 -0
  367. package/src/runs/background/wait-subscriptions.js +339 -0
  368. package/src/runs/background/wait-tool.d.ts +6 -0
  369. package/src/runs/background/wait-tool.js +48 -0
  370. package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
  371. package/src/runs/background/workflow-terminal-proof.js +116 -0
  372. package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
  373. package/src/runs/foreground/async-dismiss-action.js +82 -0
  374. package/src/runs/foreground/async-steering-action.d.ts +31 -0
  375. package/src/runs/foreground/async-steering-action.js +294 -0
  376. package/src/runs/foreground/async-stop-action.d.ts +13 -0
  377. package/src/runs/foreground/async-stop-action.js +213 -0
  378. package/src/runs/foreground/command-action.d.ts +12 -0
  379. package/src/runs/foreground/command-action.js +38 -0
  380. package/src/runs/foreground/execution.d.ts +10 -0
  381. package/src/runs/foreground/execution.js +2322 -0
  382. package/src/runs/foreground/foreground-control.d.ts +24 -0
  383. package/src/runs/foreground/foreground-control.js +138 -0
  384. package/src/runs/foreground/foreground-history.d.ts +25 -0
  385. package/src/runs/foreground/foreground-history.js +267 -0
  386. package/src/runs/foreground/prompt-audit.d.ts +32 -0
  387. package/src/runs/foreground/prompt-audit.js +138 -0
  388. package/src/runs/foreground/subagent-executor.d.ts +316 -0
  389. package/src/runs/foreground/subagent-executor.js +7986 -0
  390. package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
  391. package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
  392. package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
  393. package/src/runs/foreground/workflow-foreground-steering.js +148 -0
  394. package/src/runs/shared/abort-recovery.d.ts +26 -0
  395. package/src/runs/shared/abort-recovery.js +108 -0
  396. package/src/runs/shared/acceptance.d.ts +144 -0
  397. package/src/runs/shared/acceptance.js +1616 -0
  398. package/src/runs/shared/agent-contract.d.ts +5 -0
  399. package/src/runs/shared/agent-contract.js +35 -0
  400. package/src/runs/shared/async-status-projection.d.ts +100 -0
  401. package/src/runs/shared/async-status-projection.js +566 -0
  402. package/src/runs/shared/background-process-options.d.ts +4 -0
  403. package/src/runs/shared/background-process-options.js +6 -0
  404. package/src/runs/shared/capability-ceiling.d.ts +58 -0
  405. package/src/runs/shared/capability-ceiling.js +179 -0
  406. package/src/runs/shared/chain-outputs.d.ts +18 -0
  407. package/src/runs/shared/chain-outputs.js +104 -0
  408. package/src/runs/shared/child-commands.d.ts +29 -0
  409. package/src/runs/shared/child-commands.js +254 -0
  410. package/src/runs/shared/child-hooks.d.ts +31 -0
  411. package/src/runs/shared/child-hooks.js +173 -0
  412. package/src/runs/shared/child-identity.d.ts +23 -0
  413. package/src/runs/shared/child-identity.js +40 -0
  414. package/src/runs/shared/child-launch-plan.d.ts +70 -0
  415. package/src/runs/shared/child-launch-plan.js +88 -0
  416. package/src/runs/shared/child-launch.d.ts +128 -0
  417. package/src/runs/shared/child-launch.js +262 -0
  418. package/src/runs/shared/child-lifecycle.d.ts +13 -0
  419. package/src/runs/shared/child-lifecycle.js +22 -0
  420. package/src/runs/shared/child-runtime-config.d.ts +111 -0
  421. package/src/runs/shared/child-runtime-config.js +44 -0
  422. package/src/runs/shared/child-session.d.ts +178 -0
  423. package/src/runs/shared/child-session.js +726 -0
  424. package/src/runs/shared/child-tool-plan.d.ts +101 -0
  425. package/src/runs/shared/child-tool-plan.js +430 -0
  426. package/src/runs/shared/claude-code-adapter.d.ts +80 -0
  427. package/src/runs/shared/claude-code-adapter.js +255 -0
  428. package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
  429. package/src/runs/shared/codex-exec-adapter.js +127 -0
  430. package/src/runs/shared/context-mode.d.ts +12 -0
  431. package/src/runs/shared/context-mode.js +38 -0
  432. package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
  433. package/src/runs/shared/cursor-agent-adapter.js +99 -0
  434. package/src/runs/shared/dynamic-fanout.d.ts +49 -0
  435. package/src/runs/shared/dynamic-fanout.js +273 -0
  436. package/src/runs/shared/effective-system-prompt.d.ts +17 -0
  437. package/src/runs/shared/effective-system-prompt.js +23 -0
  438. package/src/runs/shared/extension-bindings.d.ts +25 -0
  439. package/src/runs/shared/extension-bindings.js +96 -0
  440. package/src/runs/shared/external-cli-contract.d.ts +29 -0
  441. package/src/runs/shared/external-cli-contract.js +145 -0
  442. package/src/runs/shared/external-cli-preflight.d.ts +41 -0
  443. package/src/runs/shared/external-cli-preflight.js +159 -0
  444. package/src/runs/shared/external-cli-runner.d.ts +65 -0
  445. package/src/runs/shared/external-cli-runner.js +425 -0
  446. package/src/runs/shared/external-job-bridge.d.ts +24 -0
  447. package/src/runs/shared/external-job-bridge.js +486 -0
  448. package/src/runs/shared/external-job-runner.d.ts +44 -0
  449. package/src/runs/shared/external-job-runner.js +352 -0
  450. package/src/runs/shared/fast-mode-extension.d.ts +3 -0
  451. package/src/runs/shared/fast-mode-extension.js +8 -0
  452. package/src/runs/shared/fork-placed-env.d.ts +4 -0
  453. package/src/runs/shared/fork-placed-env.js +13 -0
  454. package/src/runs/shared/git-environment.d.ts +2 -0
  455. package/src/runs/shared/git-environment.js +27 -0
  456. package/src/runs/shared/herdr-connection.d.ts +79 -0
  457. package/src/runs/shared/herdr-connection.js +269 -0
  458. package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
  459. package/src/runs/shared/herdr-external-adapters.js +404 -0
  460. package/src/runs/shared/herdr-machine.d.ts +59 -0
  461. package/src/runs/shared/herdr-machine.js +294 -0
  462. package/src/runs/shared/herdr-pane-host.d.ts +88 -0
  463. package/src/runs/shared/herdr-pane-host.js +155 -0
  464. package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
  465. package/src/runs/shared/herdr-pi-protocol.js +57 -0
  466. package/src/runs/shared/herdr-placed-run.d.ts +144 -0
  467. package/src/runs/shared/herdr-placed-run.js +380 -0
  468. package/src/runs/shared/host-step-status.d.ts +33 -0
  469. package/src/runs/shared/host-step-status.js +244 -0
  470. package/src/runs/shared/lane-metadata.d.ts +23 -0
  471. package/src/runs/shared/lane-metadata.js +126 -0
  472. package/src/runs/shared/launch-cwd.d.ts +1 -0
  473. package/src/runs/shared/launch-cwd.js +16 -0
  474. package/src/runs/shared/local-machine-access.d.ts +5 -0
  475. package/src/runs/shared/local-machine-access.js +28 -0
  476. package/src/runs/shared/long-running-guard.d.ts +34 -0
  477. package/src/runs/shared/long-running-guard.js +256 -0
  478. package/src/runs/shared/mcp-config-sources.d.ts +33 -0
  479. package/src/runs/shared/mcp-config-sources.js +418 -0
  480. package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
  481. package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
  482. package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
  483. package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
  484. package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
  485. package/src/runs/shared/model-resolution-diagnostic.js +116 -0
  486. package/src/runs/shared/model-resolution.d.ts +109 -0
  487. package/src/runs/shared/model-resolution.js +411 -0
  488. package/src/runs/shared/model-scope.d.ts +68 -0
  489. package/src/runs/shared/model-scope.js +171 -0
  490. package/src/runs/shared/mutation-evidence.d.ts +18 -0
  491. package/src/runs/shared/mutation-evidence.js +198 -0
  492. package/src/runs/shared/nested-events.d.ts +135 -0
  493. package/src/runs/shared/nested-events.js +1090 -0
  494. package/src/runs/shared/nested-path.d.ts +8 -0
  495. package/src/runs/shared/nested-path.js +34 -0
  496. package/src/runs/shared/nested-render.d.ts +20 -0
  497. package/src/runs/shared/nested-render.js +115 -0
  498. package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
  499. package/src/runs/shared/orca-progress-tabs.js +503 -0
  500. package/src/runs/shared/parallel-handoff.d.ts +78 -0
  501. package/src/runs/shared/parallel-handoff.js +783 -0
  502. package/src/runs/shared/parallel-utils.d.ts +177 -0
  503. package/src/runs/shared/parallel-utils.js +125 -0
  504. package/src/runs/shared/partial-output.d.ts +24 -0
  505. package/src/runs/shared/partial-output.js +35 -0
  506. package/src/runs/shared/permissions.d.ts +12 -0
  507. package/src/runs/shared/permissions.js +92 -0
  508. package/src/runs/shared/pi-spawn.d.ts +31 -0
  509. package/src/runs/shared/pi-spawn.js +211 -0
  510. package/src/runs/shared/placed-run-owner.d.ts +49 -0
  511. package/src/runs/shared/placed-run-owner.js +93 -0
  512. package/src/runs/shared/placement-host.d.ts +99 -0
  513. package/src/runs/shared/placement-host.js +157 -0
  514. package/src/runs/shared/process-signal.d.ts +15 -0
  515. package/src/runs/shared/process-signal.js +21 -0
  516. package/src/runs/shared/profile-extensions.d.ts +21 -0
  517. package/src/runs/shared/profile-extensions.js +122 -0
  518. package/src/runs/shared/profile-launch-env.d.ts +26 -0
  519. package/src/runs/shared/profile-launch-env.js +90 -0
  520. package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
  521. package/src/runs/shared/readonly-drain-observation.js +50 -0
  522. package/src/runs/shared/rex-machine.d.ts +25 -0
  523. package/src/runs/shared/rex-machine.js +83 -0
  524. package/src/runs/shared/rex-pane-host.d.ts +62 -0
  525. package/src/runs/shared/rex-pane-host.js +327 -0
  526. package/src/runs/shared/run-fanout-budget.d.ts +14 -0
  527. package/src/runs/shared/run-fanout-budget.js +258 -0
  528. package/src/runs/shared/run-ownership.d.ts +3 -0
  529. package/src/runs/shared/run-ownership.js +8 -0
  530. package/src/runs/shared/runner-launcher.d.ts +11 -0
  531. package/src/runs/shared/runner-launcher.js +24 -0
  532. package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
  533. package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
  534. package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
  535. package/src/runs/shared/sandbox-profile-guard.js +106 -0
  536. package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
  537. package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
  538. package/src/runs/shared/session-lease.d.ts +69 -0
  539. package/src/runs/shared/session-lease.js +250 -0
  540. package/src/runs/shared/single-output.d.ts +90 -0
  541. package/src/runs/shared/single-output.js +349 -0
  542. package/src/runs/shared/spawn-budget.d.ts +20 -0
  543. package/src/runs/shared/spawn-budget.js +93 -0
  544. package/src/runs/shared/structured-output.d.ts +66 -0
  545. package/src/runs/shared/structured-output.js +483 -0
  546. package/src/runs/shared/subagent-control.d.ts +50 -0
  547. package/src/runs/shared/subagent-control.js +247 -0
  548. package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
  549. package/src/runs/shared/subagent-prompt-runtime.js +776 -0
  550. package/src/runs/shared/tool-availability.d.ts +16 -0
  551. package/src/runs/shared/tool-availability.js +29 -0
  552. package/src/runs/shared/tool-budget.d.ts +21 -0
  553. package/src/runs/shared/tool-budget.js +78 -0
  554. package/src/runs/shared/tool-timeout.d.ts +31 -0
  555. package/src/runs/shared/tool-timeout.js +73 -0
  556. package/src/runs/shared/usage-budget.d.ts +7 -0
  557. package/src/runs/shared/usage-budget.js +74 -0
  558. package/src/runs/shared/usage-reconciliation.d.ts +8 -0
  559. package/src/runs/shared/usage-reconciliation.js +71 -0
  560. package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
  561. package/src/runs/shared/workflow-async-child-guidance.js +17 -0
  562. package/src/runs/shared/workflow-graph.d.ts +31 -0
  563. package/src/runs/shared/workflow-graph.js +221 -0
  564. package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
  565. package/src/runs/shared/worktree-cleanup-apply.js +178 -0
  566. package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
  567. package/src/runs/shared/worktree-cleanup-plan.js +803 -0
  568. package/src/runs/shared/worktree-lock.d.ts +5 -0
  569. package/src/runs/shared/worktree-lock.js +40 -0
  570. package/src/runs/shared/worktree-setup-command.d.ts +38 -0
  571. package/src/runs/shared/worktree-setup-command.js +200 -0
  572. package/src/runs/shared/worktree.d.ts +181 -0
  573. package/src/runs/shared/worktree.js +1346 -0
  574. package/src/shared/accessible-dir.d.ts +11 -0
  575. package/src/shared/accessible-dir.js +39 -0
  576. package/src/shared/agent-stream-options.d.ts +5 -0
  577. package/src/shared/agent-stream-options.js +3 -0
  578. package/src/shared/artifacts.d.ts +22 -0
  579. package/src/shared/artifacts.js +272 -0
  580. package/src/shared/atomic-json.d.ts +19 -0
  581. package/src/shared/atomic-json.js +61 -0
  582. package/src/shared/capacity-resilient-json.d.ts +26 -0
  583. package/src/shared/capacity-resilient-json.js +86 -0
  584. package/src/shared/child-cache-retention.d.ts +29 -0
  585. package/src/shared/child-cache-retention.js +40 -0
  586. package/src/shared/child-session-name.d.ts +8 -0
  587. package/src/shared/child-session-name.js +40 -0
  588. package/src/shared/child-transcript.d.ts +37 -0
  589. package/src/shared/child-transcript.js +225 -0
  590. package/src/shared/completion-owner.d.ts +7 -0
  591. package/src/shared/completion-owner.js +13 -0
  592. package/src/shared/disabled-features.d.ts +93 -0
  593. package/src/shared/disabled-features.js +120 -0
  594. package/src/shared/display-text.d.ts +5 -0
  595. package/src/shared/display-text.js +154 -0
  596. package/src/shared/edit-distance.d.ts +4 -0
  597. package/src/shared/edit-distance.js +32 -0
  598. package/src/shared/extension-context.d.ts +21 -0
  599. package/src/shared/extension-context.js +39 -0
  600. package/src/shared/file-coalescer.d.ts +11 -0
  601. package/src/shared/file-coalescer.js +34 -0
  602. package/src/shared/file-lease.d.ts +10 -0
  603. package/src/shared/file-lease.js +106 -0
  604. package/src/shared/file-system-retry.d.ts +31 -0
  605. package/src/shared/file-system-retry.js +84 -0
  606. package/src/shared/fork-context.d.ts +64 -0
  607. package/src/shared/fork-context.js +185 -0
  608. package/src/shared/fork-session-cwd.d.ts +2 -0
  609. package/src/shared/fork-session-cwd.js +23 -0
  610. package/src/shared/formatters.d.ts +35 -0
  611. package/src/shared/formatters.js +137 -0
  612. package/src/shared/jsonl-writer.d.ts +20 -0
  613. package/src/shared/jsonl-writer.js +67 -0
  614. package/src/shared/launch-contract.d.ts +65 -0
  615. package/src/shared/launch-contract.js +145 -0
  616. package/src/shared/model-info.d.ts +55 -0
  617. package/src/shared/model-info.js +103 -0
  618. package/src/shared/model-response-aliases.d.ts +1 -0
  619. package/src/shared/model-response-aliases.js +15 -0
  620. package/src/shared/node-executable.d.ts +1 -0
  621. package/src/shared/node-executable.js +20 -0
  622. package/src/shared/opencode-session-headers.d.ts +12 -0
  623. package/src/shared/opencode-session-headers.js +26 -0
  624. package/src/shared/package-version.d.ts +2 -0
  625. package/src/shared/package-version.js +14 -0
  626. package/src/shared/parent-wake.d.ts +26 -0
  627. package/src/shared/parent-wake.js +68 -0
  628. package/src/shared/permission-profile.d.ts +26 -0
  629. package/src/shared/permission-profile.js +49 -0
  630. package/src/shared/prompt-resources.d.ts +5 -0
  631. package/src/shared/prompt-resources.js +10 -0
  632. package/src/shared/provider-diagnostics.d.ts +9 -0
  633. package/src/shared/provider-diagnostics.js +75 -0
  634. package/src/shared/pruned-fork.d.ts +34 -0
  635. package/src/shared/pruned-fork.js +434 -0
  636. package/src/shared/required-child-extensions.d.ts +34 -0
  637. package/src/shared/required-child-extensions.js +105 -0
  638. package/src/shared/runtime-module-path.d.ts +10 -0
  639. package/src/shared/runtime-module-path.js +16 -0
  640. package/src/shared/sandbox-profile.d.ts +12 -0
  641. package/src/shared/sandbox-profile.js +35 -0
  642. package/src/shared/session-file-trust.d.ts +1 -0
  643. package/src/shared/session-file-trust.js +20 -0
  644. package/src/shared/session-identity.d.ts +8 -0
  645. package/src/shared/session-identity.js +32 -0
  646. package/src/shared/session-succession.d.ts +4 -0
  647. package/src/shared/session-succession.js +24 -0
  648. package/src/shared/session-tokens.d.ts +2 -0
  649. package/src/shared/session-tokens.js +58 -0
  650. package/src/shared/settings-file-lease.d.ts +4 -0
  651. package/src/shared/settings-file-lease.js +38 -0
  652. package/src/shared/settings.d.ts +146 -0
  653. package/src/shared/settings.js +247 -0
  654. package/src/shared/shortcuts.d.ts +1 -0
  655. package/src/shared/shortcuts.js +17 -0
  656. package/src/shared/status-format.d.ts +9 -0
  657. package/src/shared/status-format.js +60 -0
  658. package/src/shared/thinking-ceiling.d.ts +13 -0
  659. package/src/shared/thinking-ceiling.js +37 -0
  660. package/src/shared/types.d.ts +2840 -0
  661. package/src/shared/types.js +276 -0
  662. package/src/shared/utf8.d.ts +5 -0
  663. package/src/shared/utf8.js +12 -0
  664. package/src/shared/utils.d.ts +83 -0
  665. package/src/shared/utils.js +612 -0
  666. package/src/shared/watch-strategy.d.ts +2 -0
  667. package/src/shared/watch-strategy.js +5 -0
  668. package/src/shared/workflow-child-permit.d.ts +58 -0
  669. package/src/shared/workflow-child-permit.js +159 -0
  670. package/src/slash/delegation-adapters.d.ts +154 -0
  671. package/src/slash/delegation-adapters.js +316 -0
  672. package/src/slash/delegation-json.d.ts +10 -0
  673. package/src/slash/delegation-json.js +117 -0
  674. package/src/slash/delegation-request.d.ts +12 -0
  675. package/src/slash/delegation-request.js +174 -0
  676. package/src/slash/prompt-template-bridge.d.ts +29 -0
  677. package/src/slash/prompt-template-bridge.js +399 -0
  678. package/src/slash/prompt-workflows.d.ts +21 -0
  679. package/src/slash/prompt-workflows.js +274 -0
  680. package/src/slash/selector.d.ts +47 -0
  681. package/src/slash/selector.js +117 -0
  682. package/src/slash/slash-bridge.d.ts +30 -0
  683. package/src/slash/slash-bridge.js +132 -0
  684. package/src/slash/slash-commands.d.ts +10 -0
  685. package/src/slash/slash-commands.js +1059 -0
  686. package/src/slash/slash-live-state.d.ts +21 -0
  687. package/src/slash/slash-live-state.js +263 -0
  688. package/src/slash/subagent-cost.d.ts +29 -0
  689. package/src/slash/subagent-cost.js +310 -0
  690. package/src/slash/subagents-admin.d.ts +3 -0
  691. package/src/slash/subagents-admin.js +481 -0
  692. package/src/tui/fleet-layout.d.ts +20 -0
  693. package/src/tui/fleet-layout.js +17 -0
  694. package/src/tui/fleet-native-transcript.d.ts +53 -0
  695. package/src/tui/fleet-native-transcript.js +339 -0
  696. package/src/tui/fleet-status.d.ts +92 -0
  697. package/src/tui/fleet-status.js +1132 -0
  698. package/src/tui/fleet-transcript.d.ts +64 -0
  699. package/src/tui/fleet-transcript.js +544 -0
  700. package/src/tui/fleet-viewport.d.ts +12 -0
  701. package/src/tui/fleet-viewport.js +35 -0
  702. package/src/tui/fleet.d.ts +196 -0
  703. package/src/tui/fleet.js +1588 -0
  704. package/src/tui/mouse-events.d.ts +21 -0
  705. package/src/tui/mouse-events.js +26 -0
  706. package/src/tui/render-helpers.d.ts +23 -0
  707. package/src/tui/render-helpers.js +100 -0
  708. package/src/tui/render.d.ts +66 -0
  709. package/src/tui/render.js +3707 -0
  710. package/src/tui/running-tone.d.ts +10 -0
  711. package/src/tui/running-tone.js +22 -0
  712. package/src/tui/subagent-messages.d.ts +22 -0
  713. package/src/tui/subagent-messages.js +270 -0
  714. package/src/ui-silent-marker.d.ts +20 -0
  715. package/src/ui-silent-marker.js +25 -0
  716. package/src/watchdog/change-signature.d.ts +7 -0
  717. package/src/watchdog/change-signature.js +243 -0
  718. package/src/watchdog/child-status.d.ts +53 -0
  719. package/src/watchdog/child-status.js +187 -0
  720. package/src/watchdog/diff-tool.d.ts +25 -0
  721. package/src/watchdog/diff-tool.js +104 -0
  722. package/src/watchdog/emission-guard.d.ts +36 -0
  723. package/src/watchdog/emission-guard.js +97 -0
  724. package/src/watchdog/guidance.d.ts +3 -0
  725. package/src/watchdog/guidance.js +19 -0
  726. package/src/watchdog/lsp-diagnostics.d.ts +17 -0
  727. package/src/watchdog/lsp-diagnostics.js +489 -0
  728. package/src/watchdog/model-selection.d.ts +24 -0
  729. package/src/watchdog/model-selection.js +167 -0
  730. package/src/watchdog/permission-arbiter.d.ts +20 -0
  731. package/src/watchdog/permission-arbiter.js +135 -0
  732. package/src/watchdog/register-child.d.ts +13 -0
  733. package/src/watchdog/register-child.js +128 -0
  734. package/src/watchdog/register-main.d.ts +11 -0
  735. package/src/watchdog/register-main.js +400 -0
  736. package/src/watchdog/render.d.ts +3 -0
  737. package/src/watchdog/render.js +33 -0
  738. package/src/watchdog/review.d.ts +36 -0
  739. package/src/watchdog/review.js +319 -0
  740. package/src/watchdog/rules.d.ts +21 -0
  741. package/src/watchdog/rules.js +58 -0
  742. package/src/watchdog/runtime.d.ts +195 -0
  743. package/src/watchdog/runtime.js +864 -0
  744. package/src/watchdog/scope.d.ts +14 -0
  745. package/src/watchdog/scope.js +44 -0
  746. package/src/watchdog/settings.d.ts +29 -0
  747. package/src/watchdog/settings.js +480 -0
  748. package/src/watchdog/tool-actions.d.ts +17 -0
  749. package/src/watchdog/tool-actions.js +150 -0
  750. package/src/watchdog/turn-delta.d.ts +15 -0
  751. package/src/watchdog/turn-delta.js +188 -0
  752. package/src/watchdog/types.d.ts +141 -0
  753. package/src/watchdog/types.js +27 -0
  754. package/src/watchdog/warning-format.d.ts +7 -0
  755. package/src/watchdog/warning-format.js +59 -0
  756. package/src/workflows/chat-progress.d.ts +37 -0
  757. package/src/workflows/chat-progress.js +129 -0
  758. package/src/workflows/host-command.d.ts +30 -0
  759. package/src/workflows/host-command.js +227 -0
  760. package/src/workflows/scripted-workflow.d.ts +204 -0
  761. package/src/workflows/scripted-workflow.js +1673 -0
  762. package/src/workflows/structured-workflow-scripts.d.ts +10 -0
  763. package/src/workflows/structured-workflow-scripts.js +179 -0
  764. package/src/workflows/workflow-auto-resume.d.ts +32 -0
  765. package/src/workflows/workflow-auto-resume.js +102 -0
  766. package/src/workflows/workflow-checklist.d.ts +127 -0
  767. package/src/workflows/workflow-checklist.js +314 -0
  768. package/src/workflows/workflow-child-summary.d.ts +24 -0
  769. package/src/workflows/workflow-child-summary.js +195 -0
  770. package/src/workflows/workflow-launch-record.d.ts +27 -0
  771. package/src/workflows/workflow-launch-record.js +48 -0
  772. package/src/workflows/workflow-preflight.d.ts +58 -0
  773. package/src/workflows/workflow-preflight.js +288 -0
  774. package/src/workflows/workflow-receipt.d.ts +34 -0
  775. package/src/workflows/workflow-receipt.js +454 -0
  776. package/src/workflows/workflow-resources.d.ts +55 -0
  777. package/src/workflows/workflow-resources.js +271 -0
  778. package/src/workflows/workflow-resume-claim.d.ts +82 -0
  779. package/src/workflows/workflow-resume-claim.js +210 -0
  780. package/src/workflows/workflow-resume.d.ts +56 -0
  781. package/src/workflows/workflow-resume.js +106 -0
  782. package/src/workflows/workflow-reuse.d.ts +61 -0
  783. package/src/workflows/workflow-reuse.js +186 -0
  784. package/src/workflows/workflow-revival.d.ts +33 -0
  785. package/src/workflows/workflow-revival.js +111 -0
  786. package/src/workflows/workflow-settlement.d.ts +84 -0
  787. package/src/workflows/workflow-settlement.js +203 -0
  788. package/src/workflows/workflow-stop-cause.d.ts +6 -0
  789. package/src/workflows/workflow-stop-cause.js +8 -0
  790. package/workflow-script-worker.cjs +1342 -0
  791. package/index.ts +0 -18
  792. package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
  793. package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
  794. package/skills/pi-subagents/references/execution-controls.md +0 -561
  795. package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
  796. package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
  797. package/skills/pi-subagents/references/review-and-validation.md +0 -73
  798. package/src/agents/advertised-agent-prompt.ts +0 -82
  799. package/src/agents/agent-eject.ts +0 -339
  800. package/src/agents/agent-management.ts +0 -1442
  801. package/src/agents/agent-memory.ts +0 -341
  802. package/src/agents/agent-refinements.ts +0 -624
  803. package/src/agents/agent-scope.ts +0 -10
  804. package/src/agents/agent-selection.ts +0 -25
  805. package/src/agents/agent-serializer.ts +0 -195
  806. package/src/agents/agents.ts +0 -3169
  807. package/src/agents/builtin-names.ts +0 -16
  808. package/src/agents/chain-serializer.ts +0 -285
  809. package/src/agents/frontmatter.ts +0 -153
  810. package/src/agents/global-npm-root.ts +0 -58
  811. package/src/agents/identity.ts +0 -30
  812. package/src/agents/proactive-skills.ts +0 -197
  813. package/src/agents/runtime-agent-events.ts +0 -70
  814. package/src/agents/runtime-agent-registry.ts +0 -457
  815. package/src/agents/runtime-discovery.ts +0 -39
  816. package/src/agents/skills.ts +0 -787
  817. package/src/api/agent-management.ts +0 -9
  818. package/src/api/agents.ts +0 -19
  819. package/src/api/background-work.ts +0 -206
  820. package/src/api/capability-ceiling.ts +0 -16
  821. package/src/api/child-tool-plan.ts +0 -5
  822. package/src/api/control-channel.ts +0 -4
  823. package/src/api/delegation.ts +0 -131
  824. package/src/api/external-job-provider.ts +0 -195
  825. package/src/api/external-runs.ts +0 -282
  826. package/src/api/inspectors.ts +0 -27
  827. package/src/api/intercom-bridge.ts +0 -3
  828. package/src/api/preflight.ts +0 -641
  829. package/src/api/project-panes.ts +0 -32
  830. package/src/api/required-child-extensions.ts +0 -6
  831. package/src/api/shared-types.ts +0 -29
  832. package/src/api/supervisor-routing.ts +0 -196
  833. package/src/api/workflow-resources.ts +0 -6
  834. package/src/extension/config.ts +0 -262
  835. package/src/extension/context-injection.ts +0 -123
  836. package/src/extension/control-notices.ts +0 -53
  837. package/src/extension/declaration-pinning.ts +0 -164
  838. package/src/extension/doctor.ts +0 -284
  839. package/src/extension/fanout-child.ts +0 -282
  840. package/src/extension/herdr-pi-bridge.ts +0 -166
  841. package/src/extension/index.ts +0 -1212
  842. package/src/extension/public-execution.ts +0 -262
  843. package/src/extension/reply-workflow-script.ts +0 -67
  844. package/src/extension/rpc.ts +0 -881
  845. package/src/extension/schemas.ts +0 -337
  846. package/src/extension/steering-notices.ts +0 -35
  847. package/src/extension/subagent-guide.ts +0 -127
  848. package/src/extension/subagent-options.ts +0 -47
  849. package/src/extension/tool-activation.ts +0 -147
  850. package/src/extension/tool-description.ts +0 -193
  851. package/src/extension/tool-result.ts +0 -19
  852. package/src/extension/upgrade-notice.ts +0 -40
  853. package/src/inspectors/actions.ts +0 -174
  854. package/src/inspectors/ghostty/actions.ts +0 -74
  855. package/src/inspectors/ghostty/plugin.ts +0 -29
  856. package/src/inspectors/herdr/actions.ts +0 -155
  857. package/src/inspectors/herdr/client.ts +0 -130
  858. package/src/inspectors/herdr/focus.ts +0 -55
  859. package/src/inspectors/herdr/plugin.ts +0 -20
  860. package/src/inspectors/herdr/project-panes.ts +0 -733
  861. package/src/inspectors/inspector-runner.ts +0 -153
  862. package/src/inspectors/plugins.ts +0 -76
  863. package/src/inspectors/session-roots-codec.ts +0 -31
  864. package/src/inspectors/shell-command.ts +0 -16
  865. package/src/inspectors/tmux/actions.ts +0 -204
  866. package/src/inspectors/tmux/client.ts +0 -85
  867. package/src/inspectors/tmux/plugin.ts +0 -21
  868. package/src/inspectors/types.ts +0 -51
  869. package/src/integrations/herdr-status.ts +0 -385
  870. package/src/integrations/pi-web-session-liveness.ts +0 -73
  871. package/src/integrations/program-status.ts +0 -215
  872. package/src/intercom/fork-supervisor-routing.ts +0 -533
  873. package/src/intercom/intercom-bridge.ts +0 -235
  874. package/src/intercom/native-supervisor-channel.ts +0 -1066
  875. package/src/intercom/result-intercom.ts +0 -433
  876. package/src/intercom/supervisor-ui.ts +0 -72
  877. package/src/missions/actions.ts +0 -433
  878. package/src/missions/goal-driver.ts +0 -177
  879. package/src/missions/lifecycle.ts +0 -367
  880. package/src/missions/store.ts +0 -613
  881. package/src/missions/types.ts +0 -190
  882. package/src/missions/workflow-state.ts +0 -281
  883. package/src/policy/authority.ts +0 -50
  884. package/src/profiles/profiles.ts +0 -674
  885. package/src/runs/background/active-async-capacity.ts +0 -548
  886. package/src/runs/background/active-run-index.ts +0 -155
  887. package/src/runs/background/async-execution.ts +0 -2479
  888. package/src/runs/background/async-job-tracker.ts +0 -869
  889. package/src/runs/background/async-resume.ts +0 -686
  890. package/src/runs/background/async-retention.ts +0 -953
  891. package/src/runs/background/async-status-snapshot.ts +0 -46
  892. package/src/runs/background/async-status.ts +0 -787
  893. package/src/runs/background/auto-drain.ts +0 -92
  894. package/src/runs/background/await-async-run.ts +0 -83
  895. package/src/runs/background/binary-bootstrap.ts +0 -67
  896. package/src/runs/background/calendar-schedule.ts +0 -90
  897. package/src/runs/background/chain-append.ts +0 -321
  898. package/src/runs/background/chain-root-attachment.ts +0 -263
  899. package/src/runs/background/completion-batcher.ts +0 -168
  900. package/src/runs/background/completion-dedupe.ts +0 -58
  901. package/src/runs/background/completion-replay.ts +0 -287
  902. package/src/runs/background/control-channel.ts +0 -659
  903. package/src/runs/background/fleet-view.ts +0 -692
  904. package/src/runs/background/index-segment.ts +0 -59
  905. package/src/runs/background/inspect-rpc.ts +0 -443
  906. package/src/runs/background/notify.ts +0 -1083
  907. package/src/runs/background/owned-process-tree.ts +0 -131
  908. package/src/runs/background/parallel-groups.ts +0 -45
  909. package/src/runs/background/pid-namespace.ts +0 -18
  910. package/src/runs/background/process-terminal-candidate.ts +0 -98
  911. package/src/runs/background/process-terminal.ts +0 -231
  912. package/src/runs/background/result-delivery-ownership.ts +0 -45
  913. package/src/runs/background/result-files.ts +0 -634
  914. package/src/runs/background/result-watcher.ts +0 -842
  915. package/src/runs/background/resume-guidance.ts +0 -56
  916. package/src/runs/background/retained-children.ts +0 -136
  917. package/src/runs/background/retained-nested-route-tracker.ts +0 -96
  918. package/src/runs/background/run-child-session.ts +0 -725
  919. package/src/runs/background/run-id-query.ts +0 -7
  920. package/src/runs/background/run-id-resolver.ts +0 -183
  921. package/src/runs/background/run-status.ts +0 -803
  922. package/src/runs/background/runner-aliases.ts +0 -183
  923. package/src/runs/background/runner-child-launch.ts +0 -96
  924. package/src/runs/background/runner-child-sessions.ts +0 -32
  925. package/src/runs/background/runner-http-dispatcher.ts +0 -122
  926. package/src/runs/background/runner-startup-failure.ts +0 -56
  927. package/src/runs/background/scheduled-runs.ts +0 -1222
  928. package/src/runs/background/stale-run-reconciler.ts +0 -463
  929. package/src/runs/background/steering.ts +0 -260
  930. package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
  931. package/src/runs/background/subagent-runner.ts +0 -5251
  932. package/src/runs/background/subagent-wait.ts +0 -895
  933. package/src/runs/background/terminal-run-index.ts +0 -183
  934. package/src/runs/background/top-level-async.ts +0 -14
  935. package/src/runs/background/wait-completions.ts +0 -262
  936. package/src/runs/background/wait-config.ts +0 -50
  937. package/src/runs/background/wait-subscriptions.ts +0 -354
  938. package/src/runs/background/wait-tool.ts +0 -57
  939. package/src/runs/background/workflow-terminal-proof.ts +0 -85
  940. package/src/runs/foreground/async-dismiss-action.ts +0 -86
  941. package/src/runs/foreground/async-steering-action.ts +0 -276
  942. package/src/runs/foreground/async-stop-action.ts +0 -216
  943. package/src/runs/foreground/command-action.ts +0 -41
  944. package/src/runs/foreground/execution.ts +0 -2315
  945. package/src/runs/foreground/foreground-control.ts +0 -157
  946. package/src/runs/foreground/foreground-history.ts +0 -164
  947. package/src/runs/foreground/prompt-audit.ts +0 -172
  948. package/src/runs/foreground/subagent-executor.ts +0 -8252
  949. package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
  950. package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
  951. package/src/runs/shared/abort-recovery.ts +0 -119
  952. package/src/runs/shared/acceptance.ts +0 -1664
  953. package/src/runs/shared/agent-contract.ts +0 -38
  954. package/src/runs/shared/async-status-projection.ts +0 -664
  955. package/src/runs/shared/background-process-options.ts +0 -9
  956. package/src/runs/shared/capability-ceiling.ts +0 -214
  957. package/src/runs/shared/chain-outputs.ts +0 -116
  958. package/src/runs/shared/child-commands.ts +0 -229
  959. package/src/runs/shared/child-hooks.ts +0 -175
  960. package/src/runs/shared/child-identity.ts +0 -62
  961. package/src/runs/shared/child-launch-plan.ts +0 -163
  962. package/src/runs/shared/child-launch.ts +0 -389
  963. package/src/runs/shared/child-lifecycle.ts +0 -28
  964. package/src/runs/shared/child-runtime-config.ts +0 -136
  965. package/src/runs/shared/child-session.ts +0 -699
  966. package/src/runs/shared/child-tool-plan.ts +0 -599
  967. package/src/runs/shared/claude-code-adapter.ts +0 -288
  968. package/src/runs/shared/codex-exec-adapter.ts +0 -129
  969. package/src/runs/shared/context-mode.ts +0 -44
  970. package/src/runs/shared/cursor-agent-adapter.ts +0 -114
  971. package/src/runs/shared/dynamic-fanout.ts +0 -297
  972. package/src/runs/shared/effective-system-prompt.ts +0 -33
  973. package/src/runs/shared/extension-bindings.ts +0 -103
  974. package/src/runs/shared/external-cli-contract.ts +0 -177
  975. package/src/runs/shared/external-cli-preflight.ts +0 -190
  976. package/src/runs/shared/external-cli-runner.ts +0 -437
  977. package/src/runs/shared/external-job-bridge.ts +0 -514
  978. package/src/runs/shared/external-job-runner.ts +0 -389
  979. package/src/runs/shared/fast-mode-extension.ts +0 -10
  980. package/src/runs/shared/fork-command-result.ts +0 -10
  981. package/src/runs/shared/git-environment.ts +0 -29
  982. package/src/runs/shared/herdr-connection.ts +0 -134
  983. package/src/runs/shared/herdr-external-adapters.ts +0 -169
  984. package/src/runs/shared/herdr-machine.ts +0 -279
  985. package/src/runs/shared/herdr-pi-protocol.ts +0 -59
  986. package/src/runs/shared/herdr-placed-run.ts +0 -264
  987. package/src/runs/shared/host-step-status.ts +0 -231
  988. package/src/runs/shared/lane-metadata.ts +0 -126
  989. package/src/runs/shared/launch-cwd.ts +0 -16
  990. package/src/runs/shared/long-running-guard.ts +0 -221
  991. package/src/runs/shared/mcp-config-sources.ts +0 -426
  992. package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
  993. package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
  994. package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
  995. package/src/runs/shared/model-resolution.ts +0 -503
  996. package/src/runs/shared/model-scope.ts +0 -224
  997. package/src/runs/shared/mutation-evidence.ts +0 -199
  998. package/src/runs/shared/nested-events.ts +0 -1125
  999. package/src/runs/shared/nested-path.ts +0 -38
  1000. package/src/runs/shared/nested-render.ts +0 -127
  1001. package/src/runs/shared/orca-progress-tabs.ts +0 -511
  1002. package/src/runs/shared/parallel-handoff.ts +0 -789
  1003. package/src/runs/shared/parallel-utils.ts +0 -292
  1004. package/src/runs/shared/partial-output.ts +0 -48
  1005. package/src/runs/shared/permissions.ts +0 -86
  1006. package/src/runs/shared/pi-spawn.ts +0 -205
  1007. package/src/runs/shared/process-signal.ts +0 -35
  1008. package/src/runs/shared/profile-extensions.ts +0 -134
  1009. package/src/runs/shared/profile-launch-env.ts +0 -121
  1010. package/src/runs/shared/readonly-drain-observation.ts +0 -42
  1011. package/src/runs/shared/run-fanout-budget.ts +0 -267
  1012. package/src/runs/shared/run-history.ts +0 -288
  1013. package/src/runs/shared/runner-launcher.ts +0 -25
  1014. package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
  1015. package/src/runs/shared/sandbox-profile-guard.ts +0 -119
  1016. package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
  1017. package/src/runs/shared/session-lease.ts +0 -293
  1018. package/src/runs/shared/single-output.ts +0 -366
  1019. package/src/runs/shared/spawn-budget.ts +0 -128
  1020. package/src/runs/shared/structured-output.ts +0 -463
  1021. package/src/runs/shared/subagent-control.ts +0 -295
  1022. package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
  1023. package/src/runs/shared/tool-availability.ts +0 -37
  1024. package/src/runs/shared/tool-budget.ts +0 -87
  1025. package/src/runs/shared/tool-timeout.ts +0 -93
  1026. package/src/runs/shared/usage-budget.ts +0 -65
  1027. package/src/runs/shared/usage-reconciliation.ts +0 -73
  1028. package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
  1029. package/src/runs/shared/workflow-graph.ts +0 -225
  1030. package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
  1031. package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
  1032. package/src/runs/shared/worktree-lock.ts +0 -29
  1033. package/src/runs/shared/worktree-setup-command.ts +0 -213
  1034. package/src/runs/shared/worktree.ts +0 -1554
  1035. package/src/shared/accessible-dir.ts +0 -47
  1036. package/src/shared/agent-stream-options.ts +0 -5
  1037. package/src/shared/artifacts.ts +0 -281
  1038. package/src/shared/atomic-json.ts +0 -85
  1039. package/src/shared/capacity-resilient-json.ts +0 -102
  1040. package/src/shared/child-cache-retention.ts +0 -43
  1041. package/src/shared/child-session-name.ts +0 -48
  1042. package/src/shared/child-transcript.ts +0 -264
  1043. package/src/shared/completion-owner.ts +0 -14
  1044. package/src/shared/disabled-features.ts +0 -123
  1045. package/src/shared/display-text.ts +0 -150
  1046. package/src/shared/edit-distance.ts +0 -33
  1047. package/src/shared/extension-context.ts +0 -37
  1048. package/src/shared/file-coalescer.ts +0 -49
  1049. package/src/shared/file-lease.ts +0 -74
  1050. package/src/shared/file-system-retry.ts +0 -95
  1051. package/src/shared/fork-context.ts +0 -243
  1052. package/src/shared/fork-session-cwd.ts +0 -27
  1053. package/src/shared/formatters.ts +0 -142
  1054. package/src/shared/jsonl-writer.ts +0 -92
  1055. package/src/shared/launch-contract.ts +0 -206
  1056. package/src/shared/model-info.ts +0 -132
  1057. package/src/shared/model-response-aliases.ts +0 -13
  1058. package/src/shared/node-executable.ts +0 -21
  1059. package/src/shared/opencode-session-headers.ts +0 -30
  1060. package/src/shared/package-version.ts +0 -17
  1061. package/src/shared/parent-wake.ts +0 -79
  1062. package/src/shared/permission-profile.ts +0 -56
  1063. package/src/shared/prompt-resources.ts +0 -11
  1064. package/src/shared/pruned-fork.ts +0 -469
  1065. package/src/shared/required-child-extensions.ts +0 -115
  1066. package/src/shared/runtime-module-path.ts +0 -19
  1067. package/src/shared/sandbox-profile.ts +0 -37
  1068. package/src/shared/session-file-trust.ts +0 -19
  1069. package/src/shared/session-identity.ts +0 -10
  1070. package/src/shared/session-tokens.ts +0 -55
  1071. package/src/shared/settings-file-lease.ts +0 -36
  1072. package/src/shared/settings.ts +0 -412
  1073. package/src/shared/shortcuts.ts +0 -13
  1074. package/src/shared/status-format.ts +0 -55
  1075. package/src/shared/thinking-ceiling.ts +0 -46
  1076. package/src/shared/types.ts +0 -3105
  1077. package/src/shared/utf8.ts +0 -11
  1078. package/src/shared/utils.ts +0 -610
  1079. package/src/shared/watch-strategy.ts +0 -12
  1080. package/src/shared/workflow-child-permit.ts +0 -212
  1081. package/src/slash/delegation-adapters.ts +0 -452
  1082. package/src/slash/delegation-json.ts +0 -108
  1083. package/src/slash/delegation-request.ts +0 -176
  1084. package/src/slash/prompt-template-bridge.ts +0 -435
  1085. package/src/slash/prompt-workflows.ts +0 -298
  1086. package/src/slash/selector.ts +0 -147
  1087. package/src/slash/slash-bridge.ts +0 -192
  1088. package/src/slash/slash-commands.ts +0 -1096
  1089. package/src/slash/slash-live-state.ts +0 -310
  1090. package/src/slash/subagent-cost.ts +0 -317
  1091. package/src/slash/subagents-admin.ts +0 -489
  1092. package/src/tui/fleet-native-transcript.ts +0 -424
  1093. package/src/tui/fleet-status.ts +0 -1139
  1094. package/src/tui/fleet-transcript.ts +0 -591
  1095. package/src/tui/fleet.ts +0 -1618
  1096. package/src/tui/mouse-events.ts +0 -42
  1097. package/src/tui/render-helpers.ts +0 -111
  1098. package/src/tui/render.ts +0 -3824
  1099. package/src/tui/running-tone.ts +0 -28
  1100. package/src/tui/subagent-messages.ts +0 -305
  1101. package/src/ui-silent-marker.ts +0 -32
  1102. package/src/watchdog/change-signature.ts +0 -260
  1103. package/src/watchdog/child-status.ts +0 -225
  1104. package/src/watchdog/diff-tool.ts +0 -112
  1105. package/src/watchdog/emission-guard.ts +0 -125
  1106. package/src/watchdog/guidance.ts +0 -20
  1107. package/src/watchdog/lsp-diagnostics.ts +0 -538
  1108. package/src/watchdog/model-selection.ts +0 -187
  1109. package/src/watchdog/permission-arbiter.ts +0 -154
  1110. package/src/watchdog/register-child.ts +0 -136
  1111. package/src/watchdog/register-main.ts +0 -425
  1112. package/src/watchdog/render.ts +0 -31
  1113. package/src/watchdog/review.ts +0 -362
  1114. package/src/watchdog/rules.ts +0 -70
  1115. package/src/watchdog/runtime.ts +0 -927
  1116. package/src/watchdog/scope.ts +0 -51
  1117. package/src/watchdog/settings.ts +0 -520
  1118. package/src/watchdog/tool-actions.ts +0 -156
  1119. package/src/watchdog/turn-delta.ts +0 -190
  1120. package/src/watchdog/types.ts +0 -186
  1121. package/src/watchdog/warning-format.ts +0 -72
  1122. package/src/workflows/chat-progress.ts +0 -152
  1123. package/src/workflows/host-command.ts +0 -235
  1124. package/src/workflows/scripted-workflow.ts +0 -2733
  1125. package/src/workflows/structured-workflow-scripts.ts +0 -177
  1126. package/src/workflows/workflow-checklist.ts +0 -442
  1127. package/src/workflows/workflow-child-summary.ts +0 -172
  1128. package/src/workflows/workflow-preflight.ts +0 -297
  1129. package/src/workflows/workflow-receipt.ts +0 -390
  1130. package/src/workflows/workflow-resources.ts +0 -275
  1131. package/src/workflows/workflow-reuse.ts +0 -120
  1132. package/src/workflows/workflow-revival.ts +0 -123
  1133. 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
- }