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