@intentius/chant 0.124.54 → 0.124.56

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 (1077) hide show
  1. package/dist/__fixtures__/estate-ledger.d.ts +13 -0
  2. package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
  3. package/dist/__fixtures__/estate-ledger.js +67 -0
  4. package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
  5. package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
  6. package/dist/__fixtures__/oidc-emulator.js +26 -2
  7. package/dist/__fixtures__/product-words.d.ts +78 -0
  8. package/dist/__fixtures__/product-words.d.ts.map +1 -0
  9. package/dist/__fixtures__/product-words.js +43 -0
  10. package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  11. package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  12. package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  13. package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  14. package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  15. package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  16. package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
  17. package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
  18. package/dist/__golden__/wave-loop/op-held-on.json +28 -7
  19. package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  20. package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  21. package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  22. package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
  23. package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  24. package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
  25. package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
  26. package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
  27. package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  28. package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  29. package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
  30. package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  31. package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  32. package/dist/__golden__/wave-loop/op-overridden.json +28 -7
  33. package/dist/__golden__/wave-loop/op-per-run.json +20 -4
  34. package/dist/__golden__/wave-loop/op-point.json +18 -4
  35. package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
  36. package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
  37. package/dist/__golden__/wave-loop/op-spend.json +10 -2
  38. package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
  39. package/dist/__golden__/wave-loop/op-wide.json +20 -4
  40. package/dist/bucket-check/azure.d.ts +108 -0
  41. package/dist/bucket-check/azure.d.ts.map +1 -0
  42. package/dist/bucket-check/azure.js +258 -0
  43. package/dist/bucket-check/fixtures/azure.json +153 -0
  44. package/dist/bucket-check/fixtures/gcs.json +148 -0
  45. package/dist/bucket-check/fixtures/s3.json +277 -0
  46. package/dist/bucket-check/gcs.d.ts +77 -0
  47. package/dist/bucket-check/gcs.d.ts.map +1 -0
  48. package/dist/bucket-check/gcs.js +202 -0
  49. package/dist/bucket-check/index.d.ts +48 -0
  50. package/dist/bucket-check/index.d.ts.map +1 -0
  51. package/dist/bucket-check/index.js +44 -0
  52. package/dist/bucket-check/s3.d.ts +116 -0
  53. package/dist/bucket-check/s3.d.ts.map +1 -0
  54. package/dist/bucket-check/s3.js +362 -0
  55. package/dist/bucket-check/types.d.ts +66 -0
  56. package/dist/bucket-check/types.d.ts.map +1 -0
  57. package/dist/bucket-check/types.js +31 -0
  58. package/dist/bucket-check/wire.d.ts +27 -0
  59. package/dist/bucket-check/wire.d.ts.map +1 -0
  60. package/dist/bucket-check/wire.js +32 -0
  61. package/dist/bucket-check.d.ts +6 -0
  62. package/dist/bucket-check.d.ts.map +1 -0
  63. package/dist/bucket-check.js +5 -0
  64. package/dist/capabilities/templates.d.ts.map +1 -1
  65. package/dist/capabilities/templates.js +1 -2
  66. package/dist/change-set.d.ts.map +1 -1
  67. package/dist/change-set.js +2 -3
  68. package/dist/ci-agent.d.ts +381 -0
  69. package/dist/ci-agent.d.ts.map +1 -0
  70. package/dist/ci-agent.js +832 -0
  71. package/dist/ci-audit/attribution.d.ts +111 -0
  72. package/dist/ci-audit/attribution.d.ts.map +1 -0
  73. package/dist/ci-audit/attribution.js +194 -0
  74. package/dist/ci-audit/audit-log.d.ts +144 -0
  75. package/dist/ci-audit/audit-log.d.ts.map +1 -0
  76. package/dist/ci-audit/audit-log.js +149 -0
  77. package/dist/ci-audit/index.d.ts +12 -0
  78. package/dist/ci-audit/index.d.ts.map +1 -0
  79. package/dist/ci-audit/index.js +12 -0
  80. package/dist/ci-audit/unrecorded.d.ts +74 -0
  81. package/dist/ci-audit/unrecorded.d.ts.map +1 -0
  82. package/dist/ci-audit/unrecorded.js +95 -0
  83. package/dist/ci-audit.d.ts +3 -0
  84. package/dist/ci-audit.d.ts.map +1 -0
  85. package/dist/ci-audit.js +2 -0
  86. package/dist/ci-control.d.ts +42 -0
  87. package/dist/ci-control.d.ts.map +1 -0
  88. package/dist/ci-control.js +41 -0
  89. package/dist/ci-estate/delivery.d.ts +137 -0
  90. package/dist/ci-estate/delivery.d.ts.map +1 -0
  91. package/dist/ci-estate/delivery.js +311 -0
  92. package/dist/ci-estate/overdue.d.ts +34 -0
  93. package/dist/ci-estate/overdue.d.ts.map +1 -0
  94. package/dist/ci-estate/overdue.js +58 -0
  95. package/dist/ci-estate/page.d.ts +134 -0
  96. package/dist/ci-estate/page.d.ts.map +1 -0
  97. package/dist/ci-estate/page.js +233 -0
  98. package/dist/ci-estate/rows.d.ts +118 -0
  99. package/dist/ci-estate/rows.d.ts.map +1 -0
  100. package/dist/ci-estate/rows.js +126 -0
  101. package/dist/ci-estate.d.ts +92 -0
  102. package/dist/ci-estate.d.ts.map +1 -0
  103. package/dist/ci-estate.js +82 -0
  104. package/dist/ci-handover.d.ts +29 -5
  105. package/dist/ci-handover.d.ts.map +1 -1
  106. package/dist/ci-handover.js +50 -16
  107. package/dist/ci-identity.d.ts +82 -7
  108. package/dist/ci-identity.d.ts.map +1 -1
  109. package/dist/ci-identity.js +86 -15
  110. package/dist/ci-job-guard.d.ts +139 -0
  111. package/dist/ci-job-guard.d.ts.map +1 -0
  112. package/dist/ci-job-guard.js +287 -0
  113. package/dist/ci-jobs.d.ts +7 -0
  114. package/dist/ci-jobs.d.ts.map +1 -1
  115. package/dist/ci-jobs.js +7 -0
  116. package/dist/ci-product-words.d.ts +296 -0
  117. package/dist/ci-product-words.d.ts.map +1 -0
  118. package/dist/ci-product-words.js +407 -0
  119. package/dist/ci-product.d.ts +117 -0
  120. package/dist/ci-product.d.ts.map +1 -0
  121. package/dist/ci-product.js +113 -0
  122. package/dist/ci-respond-run.d.ts +73 -0
  123. package/dist/ci-respond-run.d.ts.map +1 -0
  124. package/dist/ci-respond-run.js +247 -0
  125. package/dist/ci-respond.d.ts +189 -0
  126. package/dist/ci-respond.d.ts.map +1 -0
  127. package/dist/ci-respond.js +285 -0
  128. package/dist/cli/commands/audit.d.ts +2 -2
  129. package/dist/cli/commands/audit.d.ts.map +1 -1
  130. package/dist/cli/commands/audit.js +3 -2
  131. package/dist/cli/commands/carve.js +2 -2
  132. package/dist/cli/commands/init.d.ts +2 -0
  133. package/dist/cli/commands/init.d.ts.map +1 -1
  134. package/dist/cli/commands/init.js +1 -1
  135. package/dist/cli/handlers/agent.d.ts +17 -0
  136. package/dist/cli/handlers/agent.d.ts.map +1 -0
  137. package/dist/cli/handlers/agent.js +114 -0
  138. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  139. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  140. package/dist/cli/handlers/approve-confirm.js +142 -0
  141. package/dist/cli/handlers/approve.d.ts.map +1 -1
  142. package/dist/cli/handlers/approve.js +19 -1
  143. package/dist/cli/handlers/audit-log.d.ts +12 -0
  144. package/dist/cli/handlers/audit-log.d.ts.map +1 -0
  145. package/dist/cli/handlers/audit-log.js +81 -0
  146. package/dist/cli/handlers/build.d.ts +7 -0
  147. package/dist/cli/handlers/build.d.ts.map +1 -1
  148. package/dist/cli/handlers/build.js +124 -1
  149. package/dist/cli/handlers/ci-check-job.d.ts +11 -0
  150. package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
  151. package/dist/cli/handlers/ci-check-job.js +27 -0
  152. package/dist/cli/handlers/ci-check.d.ts +3 -0
  153. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  154. package/dist/cli/handlers/ci-check.js +63 -0
  155. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  156. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  157. package/dist/cli/handlers/ci-forge-check.js +89 -0
  158. package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
  159. package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
  160. package/dist/cli/handlers/e2e-safe-run.js +23 -0
  161. package/dist/cli/handlers/fan-out.js +4 -0
  162. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  163. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  164. package/dist/cli/handlers/gate-pending.js +44 -0
  165. package/dist/cli/handlers/init.d.ts.map +1 -1
  166. package/dist/cli/handlers/init.js +1 -0
  167. package/dist/cli/handlers/ledger.js +1 -1
  168. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  169. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  170. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  171. package/dist/cli/handlers/lock.d.ts.map +1 -1
  172. package/dist/cli/handlers/lock.js +64 -5
  173. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  174. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  175. package/dist/cli/handlers/notify-relay.js +130 -0
  176. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  177. package/dist/cli/handlers/pr-env.js +42 -11
  178. package/dist/cli/handlers/pr.d.ts +43 -3
  179. package/dist/cli/handlers/pr.d.ts.map +1 -1
  180. package/dist/cli/handlers/pr.js +908 -205
  181. package/dist/cli/handlers/promote.d.ts.map +1 -1
  182. package/dist/cli/handlers/promote.js +21 -2
  183. package/dist/cli/handlers/release.d.ts.map +1 -1
  184. package/dist/cli/handlers/release.js +3 -0
  185. package/dist/cli/handlers/run-wave.d.ts +8 -0
  186. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  187. package/dist/cli/handlers/run-wave.js +160 -2
  188. package/dist/cli/handlers/run.d.ts +6 -1
  189. package/dist/cli/handlers/run.d.ts.map +1 -1
  190. package/dist/cli/handlers/run.js +86 -1
  191. package/dist/cli/handlers/serve.d.ts.map +1 -1
  192. package/dist/cli/handlers/serve.js +10 -1
  193. package/dist/cli/main.d.ts +11 -1
  194. package/dist/cli/main.d.ts.map +1 -1
  195. package/dist/cli/main.js +178 -13
  196. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  197. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  198. package/dist/cli/mcp/ledger-tools.js +122 -0
  199. package/dist/cli/mcp/product-tools.d.ts +78 -0
  200. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  201. package/dist/cli/mcp/product-tools.js +93 -0
  202. package/dist/cli/mcp/read-only.d.ts +34 -0
  203. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  204. package/dist/cli/mcp/read-only.js +61 -0
  205. package/dist/cli/mcp/report-tools.d.ts +48 -0
  206. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  207. package/dist/cli/mcp/report-tools.js +128 -0
  208. package/dist/cli/mcp/server.d.ts +28 -1
  209. package/dist/cli/mcp/server.d.ts.map +1 -1
  210. package/dist/cli/mcp/server.js +86 -15
  211. package/dist/cli/mcp-config.d.ts +9 -2
  212. package/dist/cli/mcp-config.d.ts.map +1 -1
  213. package/dist/cli/mcp-config.js +8 -3
  214. package/dist/cli/parse-args.d.ts.map +1 -1
  215. package/dist/cli/parse-args.js +164 -3
  216. package/dist/cli/registry.d.ts +73 -0
  217. package/dist/cli/registry.d.ts.map +1 -1
  218. package/dist/cloud-lister/sigv4.d.ts +42 -7
  219. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  220. package/dist/cloud-lister/sigv4.js +72 -22
  221. package/dist/components/adoption.d.ts +69 -0
  222. package/dist/components/adoption.d.ts.map +1 -0
  223. package/dist/components/adoption.js +92 -0
  224. package/dist/components/apply-lease.d.ts +19 -0
  225. package/dist/components/apply-lease.d.ts.map +1 -0
  226. package/dist/components/apply-lease.js +41 -0
  227. package/dist/components/capability.d.ts +159 -5
  228. package/dist/components/capability.d.ts.map +1 -1
  229. package/dist/components/capability.js +39 -6
  230. package/dist/components/check-hooks.d.ts +116 -0
  231. package/dist/components/check-hooks.d.ts.map +1 -0
  232. package/dist/components/check-hooks.js +192 -0
  233. package/dist/components/check-steps.d.ts +74 -0
  234. package/dist/components/check-steps.d.ts.map +1 -0
  235. package/dist/components/check-steps.js +102 -0
  236. package/dist/components/ci-services.d.ts +57 -0
  237. package/dist/components/ci-services.d.ts.map +1 -0
  238. package/dist/components/ci-services.js +60 -0
  239. package/dist/components/cli-support.d.ts +13 -0
  240. package/dist/components/cli-support.d.ts.map +1 -1
  241. package/dist/components/cli-support.js +10 -2
  242. package/dist/components/driver.d.ts +32 -3
  243. package/dist/components/driver.d.ts.map +1 -1
  244. package/dist/components/driver.js +59 -5
  245. package/dist/components/fan-out-run.d.ts +12 -0
  246. package/dist/components/fan-out-run.d.ts.map +1 -1
  247. package/dist/components/fan-out-run.js +56 -16
  248. package/dist/components/groups.d.ts.map +1 -1
  249. package/dist/components/groups.js +23 -5
  250. package/dist/components/pr-env-ledger.d.ts +32 -0
  251. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  252. package/dist/components/pr-env-ledger.js +38 -0
  253. package/dist/components/pr-env-ports.d.ts +12 -0
  254. package/dist/components/pr-env-ports.d.ts.map +1 -1
  255. package/dist/components/pr-env-ports.js +13 -3
  256. package/dist/components/pr-env-run.d.ts +6 -0
  257. package/dist/components/pr-env-run.d.ts.map +1 -1
  258. package/dist/components/pr-env-run.js +3 -2
  259. package/dist/components/pr-environment.d.ts +32 -4
  260. package/dist/components/pr-environment.d.ts.map +1 -1
  261. package/dist/components/pr-environment.js +26 -8
  262. package/dist/components/pr-pipeline.d.ts +297 -5
  263. package/dist/components/pr-pipeline.d.ts.map +1 -1
  264. package/dist/components/pr-pipeline.js +329 -18
  265. package/dist/components/pr-policy.d.ts +26 -2
  266. package/dist/components/pr-policy.d.ts.map +1 -1
  267. package/dist/components/pr-policy.js +41 -7
  268. package/dist/components/pr-run.d.ts +71 -0
  269. package/dist/components/pr-run.d.ts.map +1 -1
  270. package/dist/components/pr-run.js +91 -7
  271. package/dist/components/pr-targets.d.ts +24 -0
  272. package/dist/components/pr-targets.d.ts.map +1 -0
  273. package/dist/components/pr-targets.js +48 -0
  274. package/dist/components/product-pipeline.d.ts +250 -0
  275. package/dist/components/product-pipeline.d.ts.map +1 -0
  276. package/dist/components/product-pipeline.js +212 -0
  277. package/dist/components/promote.d.ts +6 -0
  278. package/dist/components/promote.d.ts.map +1 -1
  279. package/dist/components/promote.js +4 -1
  280. package/dist/components/release-compile.d.ts +22 -1
  281. package/dist/components/release-compile.d.ts.map +1 -1
  282. package/dist/components/release-compile.js +85 -0
  283. package/dist/components/release-promote.d.ts +15 -1
  284. package/dist/components/release-promote.d.ts.map +1 -1
  285. package/dist/components/release-promote.js +67 -2
  286. package/dist/components/repo-lock.d.ts +27 -0
  287. package/dist/components/repo-lock.d.ts.map +1 -0
  288. package/dist/components/repo-lock.js +49 -0
  289. package/dist/components/row-lease.d.ts +84 -0
  290. package/dist/components/row-lease.d.ts.map +1 -0
  291. package/dist/components/row-lease.js +110 -0
  292. package/dist/components/wave-plan.d.ts +42 -0
  293. package/dist/components/wave-plan.d.ts.map +1 -1
  294. package/dist/components/wave-plan.js +72 -4
  295. package/dist/control/applied.d.ts +89 -0
  296. package/dist/control/applied.d.ts.map +1 -0
  297. package/dist/control/applied.js +175 -0
  298. package/dist/control/consumers.d.ts +78 -0
  299. package/dist/control/consumers.d.ts.map +1 -0
  300. package/dist/control/consumers.js +172 -0
  301. package/dist/control/dispatch.d.ts +334 -0
  302. package/dist/control/dispatch.d.ts.map +1 -0
  303. package/dist/control/dispatch.js +519 -0
  304. package/dist/control/edges.d.ts +75 -0
  305. package/dist/control/edges.d.ts.map +1 -0
  306. package/dist/control/edges.js +133 -0
  307. package/dist/control/reconcile.d.ts +120 -0
  308. package/dist/control/reconcile.d.ts.map +1 -0
  309. package/dist/control/reconcile.js +178 -0
  310. package/dist/control/records.d.ts +187 -0
  311. package/dist/control/records.d.ts.map +1 -0
  312. package/dist/control/records.js +307 -0
  313. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  314. package/dist/discovery/sandbox/bundle.js +25 -1
  315. package/dist/e2e-harness/bucket.d.ts +21 -0
  316. package/dist/e2e-harness/bucket.d.ts.map +1 -0
  317. package/dist/e2e-harness/bucket.js +61 -0
  318. package/dist/e2e-harness/claim.d.ts +70 -0
  319. package/dist/e2e-harness/claim.d.ts.map +1 -0
  320. package/dist/e2e-harness/claim.js +98 -0
  321. package/dist/e2e-harness/driver.d.ts +64 -0
  322. package/dist/e2e-harness/driver.d.ts.map +1 -0
  323. package/dist/e2e-harness/driver.js +243 -0
  324. package/dist/e2e-harness/forgejo.d.ts +77 -0
  325. package/dist/e2e-harness/forgejo.d.ts.map +1 -0
  326. package/dist/e2e-harness/forgejo.js +205 -0
  327. package/dist/e2e-harness/git.d.ts +32 -0
  328. package/dist/e2e-harness/git.d.ts.map +1 -0
  329. package/dist/e2e-harness/git.js +67 -0
  330. package/dist/e2e-harness/index.d.ts +22 -0
  331. package/dist/e2e-harness/index.d.ts.map +1 -0
  332. package/dist/e2e-harness/index.js +48 -0
  333. package/dist/e2e-harness/jobs.d.ts +8 -0
  334. package/dist/e2e-harness/jobs.d.ts.map +1 -0
  335. package/dist/e2e-harness/jobs.js +34 -0
  336. package/dist/e2e-harness/pins.d.ts +45 -0
  337. package/dist/e2e-harness/pins.d.ts.map +1 -0
  338. package/dist/e2e-harness/pins.js +44 -0
  339. package/dist/e2e-harness/ports.d.ts +113 -0
  340. package/dist/e2e-harness/ports.d.ts.map +1 -0
  341. package/dist/e2e-harness/ports.js +4 -0
  342. package/dist/e2e-harness/reports.d.ts +45 -0
  343. package/dist/e2e-harness/reports.d.ts.map +1 -0
  344. package/dist/e2e-harness/reports.js +57 -0
  345. package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
  346. package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
  347. package/dist/e2e-harness/safe-run-cli.js +43 -0
  348. package/dist/e2e-harness/safe-run.d.ts +61 -0
  349. package/dist/e2e-harness/safe-run.d.ts.map +1 -0
  350. package/dist/e2e-harness/safe-run.js +172 -0
  351. package/dist/e2e-harness/scenario.d.ts +11 -0
  352. package/dist/e2e-harness/scenario.d.ts.map +1 -0
  353. package/dist/e2e-harness/scenario.js +89 -0
  354. package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  355. package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
  356. package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  357. package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  358. package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  359. package/dist/e2e-harness/schemas/index.d.ts +191 -0
  360. package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
  361. package/dist/e2e-harness/schemas/index.js +62 -0
  362. package/dist/e2e-harness/stack.d.ts +124 -0
  363. package/dist/e2e-harness/stack.d.ts.map +1 -0
  364. package/dist/e2e-harness/stack.js +207 -0
  365. package/dist/e2e-harness/steps.d.ts +11 -0
  366. package/dist/e2e-harness/steps.d.ts.map +1 -0
  367. package/dist/e2e-harness/steps.js +22 -0
  368. package/dist/e2e-harness.d.ts +3 -0
  369. package/dist/e2e-harness.d.ts.map +1 -0
  370. package/dist/e2e-harness.js +2 -0
  371. package/dist/engine-facts.d.ts.map +1 -1
  372. package/dist/engine-facts.js +1 -2
  373. package/dist/exit-codes.d.ts +54 -0
  374. package/dist/exit-codes.d.ts.map +1 -0
  375. package/dist/exit-codes.js +55 -0
  376. package/dist/forge-check/check.d.ts +63 -0
  377. package/dist/forge-check/check.d.ts.map +1 -0
  378. package/dist/forge-check/check.js +139 -0
  379. package/dist/forge-check/contract.d.ts +152 -0
  380. package/dist/forge-check/contract.d.ts.map +1 -0
  381. package/dist/forge-check/contract.js +118 -0
  382. package/dist/forge-check/forge.d.ts +42 -0
  383. package/dist/forge-check/forge.d.ts.map +1 -0
  384. package/dist/forge-check/forge.js +338 -0
  385. package/dist/forge-check/index.d.ts +24 -0
  386. package/dist/forge-check/index.d.ts.map +1 -0
  387. package/dist/forge-check/index.js +23 -0
  388. package/dist/forge-check/pulumi.d.ts +44 -0
  389. package/dist/forge-check/pulumi.d.ts.map +1 -0
  390. package/dist/forge-check/pulumi.js +184 -0
  391. package/dist/forge-check/read-only.d.ts +26 -0
  392. package/dist/forge-check/read-only.d.ts.map +1 -0
  393. package/dist/forge-check/read-only.js +53 -0
  394. package/dist/forge-check/trust.d.ts +94 -0
  395. package/dist/forge-check/trust.d.ts.map +1 -0
  396. package/dist/forge-check/trust.js +532 -0
  397. package/dist/forge-check/types.d.ts +80 -0
  398. package/dist/forge-check/types.d.ts.map +1 -0
  399. package/dist/forge-check/types.js +18 -0
  400. package/dist/forge-check.d.ts +6 -0
  401. package/dist/forge-check.d.ts.map +1 -0
  402. package/dist/forge-check.js +5 -0
  403. package/dist/gate-decision.d.ts +1 -0
  404. package/dist/gate-decision.d.ts.map +1 -1
  405. package/dist/gate-decision.js +2 -0
  406. package/dist/gate-policy.d.ts +47 -1
  407. package/dist/gate-policy.d.ts.map +1 -1
  408. package/dist/gate-policy.js +50 -2
  409. package/dist/index.d.ts +1 -0
  410. package/dist/index.d.ts.map +1 -1
  411. package/dist/index.js +2 -0
  412. package/dist/lexicon.d.ts +152 -6
  413. package/dist/lexicon.d.ts.map +1 -1
  414. package/dist/lifecycle/adoption-file.d.ts +24 -0
  415. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  416. package/dist/lifecycle/adoption-file.js +1 -2
  417. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  418. package/dist/lifecycle/cloud-index.js +1 -2
  419. package/dist/lifecycle/gate-applied.d.ts +6 -0
  420. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  421. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  422. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  423. package/dist/lifecycle/gate-ledger.js +10 -1
  424. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  425. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  426. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  427. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  428. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  429. package/dist/lifecycle/gated-request-digest.js +35 -0
  430. package/dist/lifecycle/gated-request.d.ts +126 -0
  431. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  432. package/dist/lifecycle/gated-request.js +204 -0
  433. package/dist/lifecycle/identity-match.d.ts +15 -0
  434. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  435. package/dist/lifecycle/identity-match.js +11 -6
  436. package/dist/lifecycle/index-diff.d.ts +40 -0
  437. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  438. package/dist/lifecycle/index-diff.js +1 -2
  439. package/dist/lifecycle/index-document.d.ts.map +1 -1
  440. package/dist/lifecycle/index-document.js +1 -2
  441. package/dist/lifecycle/index-import.d.ts +4 -1
  442. package/dist/lifecycle/index-import.d.ts.map +1 -1
  443. package/dist/lifecycle/index-import.js +29 -32
  444. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  445. package/dist/lifecycle/ledger-read.js +7 -3
  446. package/dist/lifecycle/lock-rows.d.ts +76 -0
  447. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  448. package/dist/lifecycle/lock-rows.js +140 -0
  449. package/dist/lifecycle/query.d.ts +50 -3
  450. package/dist/lifecycle/query.d.ts.map +1 -1
  451. package/dist/lifecycle/query.js +97 -7
  452. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  453. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  454. package/dist/lifecycle/release-catalog-site.js +232 -0
  455. package/dist/lifecycle/release-catalog.d.ts +201 -0
  456. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  457. package/dist/lifecycle/release-catalog.js +198 -0
  458. package/dist/lifecycle/release-changelog.d.ts +41 -0
  459. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  460. package/dist/lifecycle/release-changelog.js +38 -0
  461. package/dist/lifecycle/release-cut.d.ts +1 -0
  462. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  463. package/dist/lifecycle/release-cut.js +1 -1
  464. package/dist/lifecycle/release-ledger.d.ts +16 -0
  465. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  466. package/dist/lifecycle/release-ledger.js +9 -0
  467. package/dist/lifecycle/release-publish.d.ts +43 -22
  468. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  469. package/dist/lifecycle/release-read.d.ts.map +1 -1
  470. package/dist/lifecycle/release-read.js +3 -0
  471. package/dist/lifecycle/release-status.d.ts +106 -0
  472. package/dist/lifecycle/release-status.d.ts.map +1 -0
  473. package/dist/lifecycle/release-status.js +115 -0
  474. package/dist/lifecycle/resource-lock.d.ts +120 -0
  475. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  476. package/dist/lifecycle/resource-lock.js +317 -0
  477. package/dist/lifecycle/retention.d.ts.map +1 -1
  478. package/dist/lifecycle/retention.js +3 -0
  479. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  480. package/dist/lifecycle/run-ledger.js +9 -1
  481. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  482. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  483. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  484. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  485. package/dist/lifecycle/snapshot-store.js +1 -2
  486. package/dist/lifecycle/target-lock.d.ts +15 -0
  487. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  488. package/dist/lifecycle/target-lock.js +25 -10
  489. package/dist/lifecycle/wave-plans.d.ts +23 -7
  490. package/dist/lifecycle/wave-plans.d.ts.map +1 -1
  491. package/dist/lifecycle/wave-plans.js +9 -2
  492. package/dist/mcp/types.d.ts +7 -0
  493. package/dist/mcp/types.d.ts.map +1 -1
  494. package/dist/notify-product.d.ts +43 -0
  495. package/dist/notify-product.d.ts.map +1 -0
  496. package/dist/notify-product.js +58 -0
  497. package/dist/notify-relay.d.ts +197 -0
  498. package/dist/notify-relay.d.ts.map +1 -0
  499. package/dist/notify-relay.js +321 -0
  500. package/dist/notify.d.ts +44 -4
  501. package/dist/notify.d.ts.map +1 -1
  502. package/dist/notify.js +77 -14
  503. package/dist/object-store/azure-blob.d.ts +129 -0
  504. package/dist/object-store/azure-blob.d.ts.map +1 -0
  505. package/dist/object-store/azure-blob.js +341 -0
  506. package/dist/object-store/common.d.ts +108 -0
  507. package/dist/object-store/common.d.ts.map +1 -0
  508. package/dist/object-store/common.js +80 -0
  509. package/dist/object-store/errors.d.ts +28 -0
  510. package/dist/object-store/errors.d.ts.map +1 -0
  511. package/dist/object-store/errors.js +21 -0
  512. package/dist/object-store/from-env.d.ts +18 -0
  513. package/dist/object-store/from-env.d.ts.map +1 -0
  514. package/dist/object-store/from-env.js +22 -0
  515. package/dist/object-store/gcs.d.ts +106 -0
  516. package/dist/object-store/gcs.d.ts.map +1 -0
  517. package/dist/object-store/gcs.js +393 -0
  518. package/dist/object-store/index.d.ts +9 -0
  519. package/dist/object-store/index.d.ts.map +1 -0
  520. package/dist/object-store/index.js +8 -0
  521. package/dist/object-store/s3.d.ts +146 -0
  522. package/dist/object-store/s3.d.ts.map +1 -0
  523. package/dist/object-store/s3.js +306 -0
  524. package/dist/op/activities/converge.d.ts.map +1 -1
  525. package/dist/op/activities/converge.js +2 -1
  526. package/dist/op/activities/index.d.ts +1 -1
  527. package/dist/op/activities/index.d.ts.map +1 -1
  528. package/dist/op/activities/index.js +1 -1
  529. package/dist/op/activities/review-agent.d.ts +55 -2
  530. package/dist/op/activities/review-agent.d.ts.map +1 -1
  531. package/dist/op/activities/review-agent.js +65 -5
  532. package/dist/op/approval-status.d.ts +103 -0
  533. package/dist/op/approval-status.d.ts.map +1 -0
  534. package/dist/op/approval-status.js +197 -0
  535. package/dist/op/gate.d.ts +29 -1
  536. package/dist/op/gate.d.ts.map +1 -1
  537. package/dist/op/gate.js +59 -23
  538. package/dist/op/generate-pipeline.d.ts.map +1 -1
  539. package/dist/op/generate-pipeline.js +7 -1
  540. package/dist/op/index.d.ts +12 -1
  541. package/dist/op/index.d.ts.map +1 -1
  542. package/dist/op/index.js +7 -1
  543. package/dist/op/op-waves-after-plan.d.ts +137 -0
  544. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  545. package/dist/op/op-waves-after-plan.js +163 -0
  546. package/dist/op/op-waves-capability-spec.d.ts +63 -0
  547. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  548. package/dist/op/op-waves-capability-spec.js +115 -0
  549. package/dist/op/op-waves-capability.d.ts +197 -0
  550. package/dist/op/op-waves-capability.d.ts.map +1 -0
  551. package/dist/op/op-waves-capability.js +311 -0
  552. package/dist/op/op-waves-events.d.ts +54 -0
  553. package/dist/op/op-waves-events.d.ts.map +1 -0
  554. package/dist/op/op-waves-events.js +122 -0
  555. package/dist/op/op-waves-notify.d.ts +7 -1
  556. package/dist/op/op-waves-notify.d.ts.map +1 -1
  557. package/dist/op/op-waves-notify.js +35 -16
  558. package/dist/op/op-waves-release-port.d.ts +18 -0
  559. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  560. package/dist/op/op-waves-release-port.js +61 -0
  561. package/dist/op/op-waves-release.d.ts +92 -0
  562. package/dist/op/op-waves-release.d.ts.map +1 -0
  563. package/dist/op/op-waves-release.js +96 -0
  564. package/dist/op/op-waves-run.d.ts +182 -6
  565. package/dist/op/op-waves-run.d.ts.map +1 -1
  566. package/dist/op/op-waves-run.js +1076 -44
  567. package/dist/op/op-waves-stand-down.d.ts +60 -0
  568. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  569. package/dist/op/op-waves-stand-down.js +96 -0
  570. package/dist/op/op-waves.d.ts +187 -8
  571. package/dist/op/op-waves.d.ts.map +1 -1
  572. package/dist/op/op-waves.js +203 -19
  573. package/dist/op/runtime.d.ts +95 -0
  574. package/dist/op/runtime.d.ts.map +1 -1
  575. package/dist/op/runtime.js +18 -0
  576. package/dist/op/stage-hooks.d.ts +45 -7
  577. package/dist/op/stage-hooks.d.ts.map +1 -1
  578. package/dist/op/stage-hooks.js +61 -3
  579. package/dist/op/steward-beside.d.ts.map +1 -1
  580. package/dist/op/steward-beside.js +2 -1
  581. package/dist/op/types.d.ts +2 -2
  582. package/dist/op/types.d.ts.map +1 -1
  583. package/dist/op/types.js +3 -2
  584. package/dist/otlp-metrics.d.ts +38 -0
  585. package/dist/otlp-metrics.d.ts.map +1 -0
  586. package/dist/otlp-metrics.js +82 -0
  587. package/dist/otlp.d.ts +249 -0
  588. package/dist/otlp.d.ts.map +1 -0
  589. package/dist/otlp.js +425 -0
  590. package/dist/override-gate.d.ts.map +1 -1
  591. package/dist/override-gate.js +5 -0
  592. package/dist/parallelism.d.ts +17 -0
  593. package/dist/parallelism.d.ts.map +1 -0
  594. package/dist/parallelism.js +33 -0
  595. package/dist/policy-packs.d.ts +69 -0
  596. package/dist/policy-packs.d.ts.map +1 -0
  597. package/dist/policy-packs.js +205 -0
  598. package/dist/policy-source.d.ts +51 -0
  599. package/dist/policy-source.d.ts.map +1 -0
  600. package/dist/policy-source.js +102 -0
  601. package/dist/pr-forge.d.ts +40 -0
  602. package/dist/pr-forge.d.ts.map +1 -1
  603. package/dist/pr-forge.js +146 -37
  604. package/dist/pr-loop.d.ts +158 -11
  605. package/dist/pr-loop.d.ts.map +1 -1
  606. package/dist/pr-loop.js +302 -44
  607. package/dist/pr-merge.d.ts +64 -0
  608. package/dist/pr-merge.d.ts.map +1 -0
  609. package/dist/pr-merge.js +78 -0
  610. package/dist/pr-post.d.ts +86 -1
  611. package/dist/pr-post.d.ts.map +1 -1
  612. package/dist/pr-post.js +141 -5
  613. package/dist/pr-report-url.d.ts +32 -4
  614. package/dist/pr-report-url.d.ts.map +1 -1
  615. package/dist/pr-report-url.js +45 -5
  616. package/dist/pr-requires.d.ts +13 -2
  617. package/dist/pr-requires.d.ts.map +1 -1
  618. package/dist/pr-requires.js +14 -0
  619. package/dist/release-floors.d.ts +1 -1
  620. package/dist/release-floors.js +1 -1
  621. package/dist/run-event.d.ts +26 -1
  622. package/dist/run-event.d.ts.map +1 -1
  623. package/dist/run-event.js +3 -1
  624. package/dist/scheduled-op-cloud.d.ts +32 -0
  625. package/dist/scheduled-op-cloud.d.ts.map +1 -0
  626. package/dist/scheduled-op-cloud.js +69 -0
  627. package/dist/sorted-json.d.ts +10 -0
  628. package/dist/sorted-json.d.ts.map +1 -0
  629. package/dist/sorted-json.js +14 -0
  630. package/dist/terraform/credentials.d.ts +59 -0
  631. package/dist/terraform/credentials.d.ts.map +1 -0
  632. package/dist/terraform/credentials.js +149 -0
  633. package/dist/utils.d.ts +1 -4
  634. package/dist/utils.d.ts.map +1 -1
  635. package/dist/utils.js +1 -9
  636. package/dist/wave-runtime.d.ts +1 -1
  637. package/dist/wave-runtime.js +2 -2
  638. package/dist/wave-runtime.mjs +405 -287
  639. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  640. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  641. package/dist/workspace/ci-lock-grain.d.ts +17 -0
  642. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  643. package/dist/workspace/ci-lock-grain.js +21 -0
  644. package/dist/workspace/ci-run.d.ts +2 -1
  645. package/dist/workspace/ci-run.d.ts.map +1 -1
  646. package/dist/workspace/ci-run.js +10 -3
  647. package/dist/workspace/declaration.d.ts +16 -4
  648. package/dist/workspace/declaration.d.ts.map +1 -1
  649. package/dist/workspace/declaration.js +5 -2
  650. package/dist/workspace/declaration.schema.json +27 -3
  651. package/dist/workspace/drift-cli.d.ts.map +1 -1
  652. package/dist/workspace/drift-cli.js +8 -3
  653. package/dist/workspace/exit-cli.d.ts +1 -1
  654. package/dist/workspace/exit-cli.d.ts.map +1 -1
  655. package/dist/workspace/exit-cli.js +2 -1
  656. package/dist/workspace/import-fetch.d.ts +4 -2
  657. package/dist/workspace/import-fetch.d.ts.map +1 -1
  658. package/dist/workspace/import-fetch.js +4 -2
  659. package/dist/workspace/import-init.d.ts.map +1 -1
  660. package/dist/workspace/import-init.js +4 -2
  661. package/dist/workspace/ledger.schema.json +7 -3
  662. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  663. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  664. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  665. package/dist/workspace/pr-report.schema.json +79 -3
  666. package/dist/workspace/promote.d.ts +1 -1
  667. package/dist/workspace/promote.d.ts.map +1 -1
  668. package/dist/workspace/promote.js +2 -1
  669. package/dist/workspace/records-cli.d.ts +2 -2
  670. package/dist/workspace/records-cli.d.ts.map +1 -1
  671. package/dist/workspace/records-cli.js +3 -2
  672. package/dist/workspace/release-catalog.schema.json +277 -0
  673. package/dist/workspace/run-event.schema.json +18 -1
  674. package/dist/workspace/work-cli.d.ts +3 -1
  675. package/dist/workspace/work-cli.d.ts.map +1 -1
  676. package/dist/workspace/work-cli.js +7 -2
  677. package/dist/workspace/workspace-run.d.ts.map +1 -1
  678. package/dist/workspace/workspace-run.js +2 -1
  679. package/package.json +21 -1
  680. package/src/__fixtures__/estate-ledger.ts +101 -0
  681. package/src/__fixtures__/oidc-emulator.ts +31 -2
  682. package/src/__fixtures__/product-words.ts +44 -0
  683. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  684. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  685. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  686. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  687. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  688. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  689. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  690. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  691. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  692. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  693. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  694. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  695. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  696. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  697. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  698. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  699. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  700. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  701. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  702. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  703. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  704. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  705. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  706. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  707. package/src/__golden__/wave-loop/op-point.json +18 -4
  708. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  709. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  710. package/src/__golden__/wave-loop/op-spend.json +10 -2
  711. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  712. package/src/__golden__/wave-loop/op-wide.json +20 -4
  713. package/src/bucket-check/azure.ts +307 -0
  714. package/src/bucket-check/bucket-check.test.ts +210 -0
  715. package/src/bucket-check/fixtures/azure.json +153 -0
  716. package/src/bucket-check/fixtures/gcs.json +148 -0
  717. package/src/bucket-check/fixtures/s3.json +277 -0
  718. package/src/bucket-check/gcs.ts +257 -0
  719. package/src/bucket-check/index.ts +61 -0
  720. package/src/bucket-check/s3.ts +433 -0
  721. package/src/bucket-check/types.ts +75 -0
  722. package/src/bucket-check/wire.ts +50 -0
  723. package/src/bucket-check.ts +5 -0
  724. package/src/capabilities/templates.test.ts +2 -3
  725. package/src/capabilities/templates.ts +1 -2
  726. package/src/cdk/advise.test.ts +1 -1
  727. package/src/change-set-bundle.test.ts +0 -1
  728. package/src/change-set.ts +2 -3
  729. package/src/ci-agent.test.ts +348 -0
  730. package/src/ci-agent.ts +1025 -0
  731. package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
  732. package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
  733. package/src/ci-audit/attribution.ts +260 -0
  734. package/src/ci-audit/audit-log.ts +220 -0
  735. package/src/ci-audit/ci-audit.test.ts +175 -0
  736. package/src/ci-audit/index.ts +15 -0
  737. package/src/ci-audit/unrecorded.ts +140 -0
  738. package/src/ci-audit.ts +2 -0
  739. package/src/ci-control.ts +173 -0
  740. package/src/ci-estate/delivery.ts +433 -0
  741. package/src/ci-estate/overdue.ts +81 -0
  742. package/src/ci-estate/page.ts +343 -0
  743. package/src/ci-estate/rows.ts +251 -0
  744. package/src/ci-estate.test.ts +281 -0
  745. package/src/ci-estate.ts +175 -0
  746. package/src/ci-handover.ts +67 -16
  747. package/src/ci-identity-database.test.ts +54 -0
  748. package/src/ci-identity-pulumi.test.ts +163 -0
  749. package/src/ci-identity-targets.test.ts +3 -1
  750. package/src/ci-identity.ts +123 -22
  751. package/src/ci-job-guard.test.ts +154 -0
  752. package/src/ci-job-guard.ts +319 -0
  753. package/src/ci-jobs.ts +8 -0
  754. package/src/ci-product-comment-targets.test.ts +45 -0
  755. package/src/ci-product-words.test.ts +101 -0
  756. package/src/ci-product-words.ts +565 -0
  757. package/src/ci-product.ts +226 -0
  758. package/src/ci-respond-run.ts +291 -0
  759. package/src/ci-respond.test.ts +264 -0
  760. package/src/ci-respond.ts +412 -0
  761. package/src/ci-shared-reads.test.ts +145 -0
  762. package/src/cli/commands/audit.test.ts +1 -1
  763. package/src/cli/commands/audit.ts +3 -2
  764. package/src/cli/commands/carve.test.ts +1 -1
  765. package/src/cli/commands/carve.ts +2 -2
  766. package/src/cli/commands/init.ts +3 -1
  767. package/src/cli/component-wave-args.test.ts +16 -0
  768. package/src/cli/handlers/agent.ts +126 -0
  769. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  770. package/src/cli/handlers/approve-confirm.ts +200 -0
  771. package/src/cli/handlers/approve.ts +18 -1
  772. package/src/cli/handlers/audit-log.ts +74 -0
  773. package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
  774. package/src/cli/handlers/build.test.ts +7 -0
  775. package/src/cli/handlers/build.ts +113 -1
  776. package/src/cli/handlers/ci-check-job.test.ts +114 -0
  777. package/src/cli/handlers/ci-check-job.ts +33 -0
  778. package/src/cli/handlers/ci-check.ts +63 -0
  779. package/src/cli/handlers/ci-forge-check.ts +91 -0
  780. package/src/cli/handlers/e2e-safe-run.ts +27 -0
  781. package/src/cli/handlers/fan-out.test.ts +10 -10
  782. package/src/cli/handlers/fan-out.ts +5 -0
  783. package/src/cli/handlers/gate-pending.ts +46 -0
  784. package/src/cli/handlers/init.ts +1 -0
  785. package/src/cli/handlers/ledger.ts +1 -1
  786. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  787. package/src/cli/handlers/lock.test.ts +29 -2
  788. package/src/cli/handlers/lock.ts +66 -6
  789. package/src/cli/handlers/notify-relay.ts +130 -0
  790. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  791. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  792. package/src/cli/handlers/pr-env.ts +48 -11
  793. package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
  794. package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
  795. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  796. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  797. package/src/cli/handlers/pr-waves.test.ts +8 -2
  798. package/src/cli/handlers/pr.test.ts +8 -8
  799. package/src/cli/handlers/pr.ts +879 -205
  800. package/src/cli/handlers/promote.test.ts +5 -5
  801. package/src/cli/handlers/promote.ts +22 -2
  802. package/src/cli/handlers/release.ts +2 -0
  803. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  804. package/src/cli/handlers/run-wave.ts +144 -2
  805. package/src/cli/handlers/run.test.ts +6 -4
  806. package/src/cli/handlers/run.ts +86 -1
  807. package/src/cli/handlers/serve.ts +10 -1
  808. package/src/cli/main.test.ts +1 -1
  809. package/src/cli/main.ts +180 -13
  810. package/src/cli/mcp/ledger-tools.ts +126 -0
  811. package/src/cli/mcp/product-tools.test.ts +123 -0
  812. package/src/cli/mcp/product-tools.ts +129 -0
  813. package/src/cli/mcp/read-only.test.ts +134 -0
  814. package/src/cli/mcp/read-only.ts +68 -0
  815. package/src/cli/mcp/report-tools.ts +135 -0
  816. package/src/cli/mcp/server.test.ts +5 -4
  817. package/src/cli/mcp/server.ts +90 -16
  818. package/src/cli/mcp-config.ts +8 -3
  819. package/src/cli/parse-args.ts +119 -2
  820. package/src/cli/registry.ts +73 -0
  821. package/src/cloud-lister/sigv4.ts +80 -23
  822. package/src/components/adoption.test.ts +140 -0
  823. package/src/components/adoption.ts +140 -0
  824. package/src/components/apply-lease.ts +49 -0
  825. package/src/components/capability.ts +180 -6
  826. package/src/components/check-hooks.test.ts +66 -0
  827. package/src/components/check-hooks.ts +255 -0
  828. package/src/components/check-steps.test.ts +70 -0
  829. package/src/components/check-steps.ts +158 -0
  830. package/src/components/ci-services.test.ts +51 -0
  831. package/src/components/ci-services.ts +82 -0
  832. package/src/components/cli-support.ts +23 -2
  833. package/src/components/driver.test.ts +3 -3
  834. package/src/components/driver.ts +73 -6
  835. package/src/components/fan-out-run.ts +68 -18
  836. package/src/components/groups.ts +21 -4
  837. package/src/components/plan-flags.test.ts +46 -0
  838. package/src/components/pr-comment-preview-targets.test.ts +34 -0
  839. package/src/components/pr-comment-preview.test.ts +54 -0
  840. package/src/components/pr-env-ledger.test.ts +9 -0
  841. package/src/components/pr-env-ledger.ts +42 -0
  842. package/src/components/pr-env-ports.ts +29 -4
  843. package/src/components/pr-env-run-bundle.test.ts +2 -14
  844. package/src/components/pr-env-run.test.ts +19 -0
  845. package/src/components/pr-env-run.ts +12 -2
  846. package/src/components/pr-environment.test.ts +29 -0
  847. package/src/components/pr-environment.ts +40 -8
  848. package/src/components/pr-pipeline-runners.test.ts +80 -0
  849. package/src/components/pr-pipeline.test.ts +15 -0
  850. package/src/components/pr-pipeline.ts +498 -18
  851. package/src/components/pr-policy.ts +45 -7
  852. package/src/components/pr-run.test.ts +1 -1
  853. package/src/components/pr-run.ts +138 -11
  854. package/src/components/pr-stale-job.test.ts +34 -0
  855. package/src/components/pr-targets.test.ts +35 -0
  856. package/src/components/pr-targets.ts +45 -0
  857. package/src/components/product-pipeline.test.ts +200 -0
  858. package/src/components/product-pipeline.ts +383 -0
  859. package/src/components/promote.ts +10 -1
  860. package/src/components/release-compile.ts +87 -1
  861. package/src/components/release-promote.ts +65 -1
  862. package/src/components/repo-lock.ts +52 -0
  863. package/src/components/row-lease.test.ts +490 -0
  864. package/src/components/row-lease.ts +167 -0
  865. package/src/components/wave-plan-policy.test.ts +19 -0
  866. package/src/components/wave-plan.ts +96 -6
  867. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  868. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  869. package/src/control/applied.test.ts +148 -0
  870. package/src/control/applied.ts +191 -0
  871. package/src/control/consumers.test.ts +129 -0
  872. package/src/control/consumers.ts +192 -0
  873. package/src/control/control.test.ts +302 -0
  874. package/src/control/dispatch.ts +699 -0
  875. package/src/control/edges.test.ts +112 -0
  876. package/src/control/edges.ts +164 -0
  877. package/src/control/note-checkout.test.ts +91 -0
  878. package/src/control/reconcile.ts +250 -0
  879. package/src/control/records.ts +395 -0
  880. package/src/discovery/sandbox/bundle.ts +25 -1
  881. package/src/e2e-harness/__project__/chant.config.ts +4 -0
  882. package/src/e2e-harness/__project__/src/compose.ts +33 -0
  883. package/src/e2e-harness/bucket.ts +69 -0
  884. package/src/e2e-harness/claim.test.ts +150 -0
  885. package/src/e2e-harness/claim.ts +140 -0
  886. package/src/e2e-harness/driver.test.ts +304 -0
  887. package/src/e2e-harness/driver.ts +294 -0
  888. package/src/e2e-harness/forgejo.ts +267 -0
  889. package/src/e2e-harness/git.ts +96 -0
  890. package/src/e2e-harness/index.ts +50 -0
  891. package/src/e2e-harness/jobs.ts +35 -0
  892. package/src/e2e-harness/pins.ts +52 -0
  893. package/src/e2e-harness/ports.ts +130 -0
  894. package/src/e2e-harness/reports.ts +79 -0
  895. package/src/e2e-harness/safe-run-cli.test.ts +102 -0
  896. package/src/e2e-harness/safe-run-cli.ts +54 -0
  897. package/src/e2e-harness/safe-run.ts +198 -0
  898. package/src/e2e-harness/scenario.ts +89 -0
  899. package/src/e2e-harness/schemas/README.md +62 -0
  900. package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  901. package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
  902. package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  903. package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  904. package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  905. package/src/e2e-harness/schemas/index.ts +220 -0
  906. package/src/e2e-harness/schemas.test.ts +145 -0
  907. package/src/e2e-harness/stack.test.ts +124 -0
  908. package/src/e2e-harness/stack.ts +306 -0
  909. package/src/e2e-harness/steps.ts +30 -0
  910. package/src/e2e-harness.ts +2 -0
  911. package/src/engine-facts.test.ts +2 -3
  912. package/src/engine-facts.ts +1 -2
  913. package/src/exit-codes.test.ts +32 -0
  914. package/src/exit-codes.ts +61 -0
  915. package/src/forge-check/check.ts +155 -0
  916. package/src/forge-check/contract.ts +215 -0
  917. package/src/forge-check/forge-check.test.ts +427 -0
  918. package/src/forge-check/forge.ts +318 -0
  919. package/src/forge-check/index.ts +43 -0
  920. package/src/forge-check/pulumi.ts +192 -0
  921. package/src/forge-check/read-only.ts +56 -0
  922. package/src/forge-check/trust.ts +527 -0
  923. package/src/forge-check/types.ts +78 -0
  924. package/src/forge-check.ts +5 -0
  925. package/src/gate-decision-bundle.test.ts +11 -0
  926. package/src/gate-decision.ts +3 -0
  927. package/src/gate-policy.ts +92 -3
  928. package/src/gated-waves-bundle.test.ts +0 -1
  929. package/src/index.ts +2 -0
  930. package/src/lexicon.ts +143 -6
  931. package/src/lifecycle/adoption-file.ts +1 -2
  932. package/src/lifecycle/cloud-index.test.ts +2 -3
  933. package/src/lifecycle/cloud-index.ts +1 -2
  934. package/src/lifecycle/control-entries-ledger.test.ts +69 -0
  935. package/src/lifecycle/gate-applied.ts +6 -0
  936. package/src/lifecycle/gate-ledger.ts +35 -1
  937. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  938. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  939. package/src/lifecycle/gated-request-digest.ts +49 -0
  940. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  941. package/src/lifecycle/gated-request.ts +279 -0
  942. package/src/lifecycle/identity-match.ts +25 -6
  943. package/src/lifecycle/index-diff.ts +1 -2
  944. package/src/lifecycle/index-document.ts +1 -2
  945. package/src/lifecycle/index-import.test.ts +14 -0
  946. package/src/lifecycle/index-import.ts +54 -34
  947. package/src/lifecycle/ledger-read.ts +7 -3
  948. package/src/lifecycle/lock-rows.test.ts +109 -0
  949. package/src/lifecycle/lock-rows.ts +167 -0
  950. package/src/lifecycle/publish-target-context.test.ts +108 -0
  951. package/src/lifecycle/query.test.ts +2 -3
  952. package/src/lifecycle/query.ts +109 -8
  953. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  954. package/src/lifecycle/release-catalog-site.ts +291 -0
  955. package/src/lifecycle/release-catalog.test.ts +192 -0
  956. package/src/lifecycle/release-catalog.ts +353 -0
  957. package/src/lifecycle/release-changelog.test.ts +70 -0
  958. package/src/lifecycle/release-changelog.ts +71 -0
  959. package/src/lifecycle/release-cut.ts +2 -2
  960. package/src/lifecycle/release-ledger.ts +19 -0
  961. package/src/lifecycle/release-publish.ts +45 -22
  962. package/src/lifecycle/release-read.ts +2 -0
  963. package/src/lifecycle/release-status.test.ts +185 -0
  964. package/src/lifecycle/release-status.ts +175 -0
  965. package/src/lifecycle/resource-lock.test.ts +175 -0
  966. package/src/lifecycle/resource-lock.ts +354 -0
  967. package/src/lifecycle/retention.ts +2 -0
  968. package/src/lifecycle/run-ledger.ts +7 -1
  969. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  970. package/src/lifecycle/snapshot-store.ts +1 -2
  971. package/src/lifecycle/target-lock.ts +24 -9
  972. package/src/lifecycle/wave-plans.ts +33 -5
  973. package/src/mcp/types.ts +7 -0
  974. package/src/notify-product.ts +76 -0
  975. package/src/notify-relay.test.ts +213 -0
  976. package/src/notify-relay.ts +407 -0
  977. package/src/notify.ts +95 -14
  978. package/src/object-store/azure-blob.ts +374 -0
  979. package/src/object-store/common.ts +133 -0
  980. package/src/object-store/errors.ts +26 -0
  981. package/src/object-store/from-env.ts +36 -0
  982. package/src/object-store/gcs.ts +436 -0
  983. package/src/object-store/index.ts +8 -0
  984. package/src/object-store/object-store.test.ts +130 -0
  985. package/src/object-store/s3.ts +350 -0
  986. package/src/op/activities/converge.ts +2 -1
  987. package/src/op/activities/index.ts +1 -1
  988. package/src/op/activities/review-agent.open.test.ts +78 -0
  989. package/src/op/activities/review-agent.test.ts +13 -0
  990. package/src/op/activities/review-agent.ts +89 -5
  991. package/src/op/approval-status.test.ts +134 -0
  992. package/src/op/approval-status.ts +235 -0
  993. package/src/op/gate-review.test.ts +2 -1
  994. package/src/op/gate.ts +81 -22
  995. package/src/op/generate-pipeline.ts +7 -1
  996. package/src/op/index.ts +23 -0
  997. package/src/op/op-waves-after-plan.test.ts +288 -0
  998. package/src/op/op-waves-after-plan.ts +238 -0
  999. package/src/op/op-waves-capability-spec.ts +133 -0
  1000. package/src/op/op-waves-capability.test.ts +217 -0
  1001. package/src/op/op-waves-capability.ts +370 -0
  1002. package/src/op/op-waves-events.ts +135 -0
  1003. package/src/op/op-waves-notify-words.test.ts +149 -0
  1004. package/src/op/op-waves-notify.ts +41 -16
  1005. package/src/op/op-waves-parallelism.test.ts +89 -0
  1006. package/src/op/op-waves-pull-request.test.ts +219 -0
  1007. package/src/op/op-waves-release-port.ts +64 -0
  1008. package/src/op/op-waves-release.test.ts +209 -0
  1009. package/src/op/op-waves-release.ts +132 -0
  1010. package/src/op/op-waves-run-record.test.ts +32 -0
  1011. package/src/op/op-waves-run.ts +1235 -52
  1012. package/src/op/op-waves-stand-down.test.ts +240 -0
  1013. package/src/op/op-waves-stand-down.ts +107 -0
  1014. package/src/op/op-waves-trace.test.ts +205 -0
  1015. package/src/op/op-waves.test.ts +112 -0
  1016. package/src/op/op-waves.ts +320 -22
  1017. package/src/op/runtime.ts +107 -0
  1018. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  1019. package/src/op/stage-hooks.ts +91 -12
  1020. package/src/op/steward-beside.ts +2 -1
  1021. package/src/op/types.ts +3 -2
  1022. package/src/otlp-metrics.ts +96 -0
  1023. package/src/otlp.test.ts +243 -0
  1024. package/src/otlp.ts +543 -0
  1025. package/src/override-gate-bundle.test.ts +2 -0
  1026. package/src/override-gate.ts +4 -0
  1027. package/src/parallelism.test.ts +38 -0
  1028. package/src/parallelism.ts +33 -0
  1029. package/src/policy-packs.ts +230 -0
  1030. package/src/policy-source.test.ts +256 -0
  1031. package/src/policy-source.ts +111 -0
  1032. package/src/pr-forge-bundle.test.ts +1 -1
  1033. package/src/pr-forge.ts +175 -33
  1034. package/src/pr-loop-bundle.test.ts +7 -3
  1035. package/src/pr-loop-narrowed.test.ts +63 -0
  1036. package/src/pr-loop-words.test.ts +155 -0
  1037. package/src/pr-loop.ts +398 -52
  1038. package/src/pr-merge.test.ts +100 -0
  1039. package/src/pr-merge.ts +105 -0
  1040. package/src/pr-post-stale.test.ts +163 -0
  1041. package/src/pr-post.ts +190 -5
  1042. package/src/pr-report-url.ts +61 -6
  1043. package/src/pr-requires.test.ts +37 -1
  1044. package/src/pr-requires.ts +16 -2
  1045. package/src/product-subpaths-plain-node.e2e.test.ts +212 -0
  1046. package/src/release-floors.ts +1 -1
  1047. package/src/run-event.ts +28 -1
  1048. package/src/scheduled-op-cloud.ts +68 -0
  1049. package/src/sorted-json.ts +17 -0
  1050. package/src/stage-hooks-bundle.test.ts +6 -0
  1051. package/src/terraform/credentials.test.ts +77 -0
  1052. package/src/terraform/credentials.ts +162 -0
  1053. package/src/utils.ts +2 -11
  1054. package/src/wave-loop-golden.test.ts +2 -1
  1055. package/src/wave-runtime.ts +2 -2
  1056. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  1057. package/src/workspace/ci-lock-grain.test.ts +31 -0
  1058. package/src/workspace/ci-lock-grain.ts +29 -0
  1059. package/src/workspace/ci-report-url.test.ts +1 -1
  1060. package/src/workspace/ci-run.test.ts +1 -1
  1061. package/src/workspace/ci-run.ts +10 -3
  1062. package/src/workspace/declaration.schema.json +27 -3
  1063. package/src/workspace/declaration.test.ts +1 -1
  1064. package/src/workspace/declaration.ts +26 -10
  1065. package/src/workspace/drift-cli.ts +8 -3
  1066. package/src/workspace/exit-cli.ts +2 -1
  1067. package/src/workspace/import-fetch.ts +4 -2
  1068. package/src/workspace/import-init.ts +4 -2
  1069. package/src/workspace/ledger.schema.json +7 -3
  1070. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  1071. package/src/workspace/pr-report.schema.json +79 -3
  1072. package/src/workspace/promote.ts +2 -1
  1073. package/src/workspace/records-cli.ts +3 -2
  1074. package/src/workspace/release-catalog.schema.json +277 -0
  1075. package/src/workspace/run-event.schema.json +18 -1
  1076. package/src/workspace/work-cli.ts +8 -2
  1077. package/src/workspace/workspace-run.ts +2 -1
@@ -0,0 +1,134 @@
1
+ /**
2
+ * #4630: `<product>/approval` on an open pull request's head, from the
3
+ * policy at base, the head's recorded plans and the forge's reviews, on
4
+ * fake GitHub, GitLab and Forgejo forges.
5
+ */
6
+
7
+ import { describe, expect, test } from "vitest";
8
+ import { assertProductWords } from "../ci-product-words";
9
+ import type { HeadPlans } from "../lifecycle/wave-plans";
10
+ import { parseHeadPlans } from "../lifecycle/wave-plans";
11
+ import type { ForgeStatus, PrApprovalResult } from "../pr-forge";
12
+ import { approvalStatusOf, headWaveHolds, postApprovalStatus, postOpenApprovalStatuses } from "./approval-status";
13
+ import type { OpWavesSpec } from "./op-waves";
14
+ import type { OpWaveShowAtBase } from "./op-waves-run";
15
+
16
+ const HEAD = "a".repeat(40);
17
+ const BASE = "b".repeat(40);
18
+
19
+ const SPEC: OpWavesSpec = {
20
+ name: "plywood-up",
21
+ op: "plywood-up",
22
+ plan: ["./bin/plan", "{target}", "{plan}"],
23
+ waves: [
24
+ { name: "dev", runs: [{ target: "dev" }], gate: "never", approval: "pr-review" },
25
+ { name: "prod", runs: [{ target: "prod" }], gate: "on-destructive", approval: "pr-review" },
26
+ ],
27
+ };
28
+
29
+ /** The spec as it stands at base: what the policy is read from. */
30
+ const atBase = (spec: OpWavesSpec | null): OpWaveShowAtBase => () => ({ sha: BASE, text: spec ? JSON.stringify(spec) : null });
31
+
32
+ const plans = (waves: HeadPlans["waves"]): HeadPlans => ({ version: 1, name: SPEC.name, head: HEAD, timestamp: "2026-10-28T00:00:00Z", waves });
33
+
34
+ function fakeForge(kind: "github" | "gitlab" | "forgejo", approval: PrApprovalResult) {
35
+ const statuses: Array<{ sha: string; status: ForgeStatus }> = [];
36
+ const asked: Array<{ pr: number; head: string }> = [];
37
+ const forge = {
38
+ kind,
39
+ runUrl: "https://ci.example/run/1",
40
+ async prApproved(pr: number, head: string) {
41
+ asked.push({ pr, head });
42
+ return approval;
43
+ },
44
+ async setStatus(sha: string, status: ForgeStatus) {
45
+ statuses.push({ sha, status });
46
+ },
47
+ async openPullRequests() {
48
+ return [
49
+ { number: 3, head: "feature", headSha: HEAD, base: "main", baseSha: BASE, fork: false },
50
+ { number: 4, head: "fork-branch", headSha: "c".repeat(40), base: "main", fork: true },
51
+ ];
52
+ },
53
+ };
54
+ return { forge, statuses, asked };
55
+ }
56
+
57
+ const approved: PrApprovalResult = { passed: true, reason: "approved", approvers: ["github:lee"], excluded: [] };
58
+ const notApproved: PrApprovalResult = { passed: false, reason: "no writer other than the author approved a1b2c3d4", approvers: [], excluded: [] };
59
+
60
+ describe("which waves the gate will hold (#4630)", () => {
61
+ test("never holds nothing, on-destructive holds a destructive plan, always holds a change; no facts read as a change", () => {
62
+ expect(headWaveHolds("never", { changes: true, destructive: true })).toBe(false);
63
+ expect(headWaveHolds("on-destructive", { changes: true, destructive: false })).toBe(false);
64
+ expect(headWaveHolds("on-destructive", { changes: true, destructive: true })).toBe(true);
65
+ expect(headWaveHolds("always", { changes: false })).toBe(false);
66
+ expect(headWaveHolds("always", {})).toBe(true);
67
+ });
68
+
69
+ test("the plans record keeps the facts, and an older record without them still parses", () => {
70
+ const text = JSON.stringify(plans([{ wave: 1, name: "dev", digest: "d1", changes: true, destructive: false }]));
71
+ expect(parseHeadPlans(text)?.waves[0]).toEqual({ wave: 1, name: "dev", digest: "d1", changes: true, destructive: false });
72
+ expect(parseHeadPlans(JSON.stringify(plans([{ wave: 1, name: "dev", digest: "d1" }])))?.waves[0]).toEqual({ wave: 1, name: "dev", digest: "d1" });
73
+ });
74
+ });
75
+
76
+ describe("<product>/approval on the head (#4630)", () => {
77
+ for (const kind of ["github", "gitlab", "forgejo"] as const) {
78
+ test(`pending while a held wave has no approving review, success once it has (${kind})`, async () => {
79
+ const recorded = plans([
80
+ { wave: 1, name: "dev", digest: "d1", changes: true, destructive: true },
81
+ { wave: 2, name: "prod", digest: "d2", changes: true, destructive: true },
82
+ ]);
83
+ const words = assertProductWords({ product: "plywood" });
84
+ const waiting = fakeForge(kind, notApproved);
85
+ const status = await postApprovalStatus({ spec: SPEC, specFile: "waves.json", forge: waiting.forge, pr: 3, head: HEAD, base: BASE, show: atBase(SPEC), readPlans: async () => recorded }, words);
86
+ expect(status).toMatchObject({ state: "pending", waits: [2] });
87
+ expect(waiting.statuses).toEqual([{ sha: HEAD, status: { context: "plywood/approval", state: "pending", description: expect.stringContaining("wave 2 wait"), url: "https://ci.example/run/1" } }]);
88
+ expect(waiting.asked).toEqual([{ pr: 3, head: HEAD }]);
89
+
90
+ const done = fakeForge(kind, approved);
91
+ const ok = await postApprovalStatus({ spec: SPEC, specFile: "waves.json", forge: done.forge, pr: 3, head: HEAD, base: BASE, show: atBase(SPEC), readPlans: async () => recorded }, words);
92
+ expect(ok).toMatchObject({ state: "success", approvers: ["github:lee"] });
93
+ expect(done.statuses[0]!.status.description).toContain("by github:lee");
94
+ });
95
+ }
96
+
97
+ test("a plan no gate holds is success without asking for reviews", async () => {
98
+ const { forge, asked } = fakeForge("github", notApproved);
99
+ const status = await approvalStatusOf({
100
+ spec: SPEC,
101
+ specFile: "waves.json",
102
+ forge,
103
+ pr: 3,
104
+ head: HEAD,
105
+ base: BASE,
106
+ show: atBase(SPEC),
107
+ readPlans: async () => plans([{ wave: 1, name: "dev", digest: "d1", changes: true }, { wave: 2, name: "prod", digest: "d2", changes: true, destructive: false }]),
108
+ });
109
+ expect(status).toMatchObject({ state: "success", waits: [] });
110
+ expect(asked).toEqual([]);
111
+ });
112
+
113
+ test("the policy is read at base: a head that loosens it still waits", async () => {
114
+ const loosened: OpWavesSpec = { ...SPEC, waves: SPEC.waves.map((w) => ({ ...w, gate: "never" as const })) };
115
+ const strict: OpWavesSpec = { ...SPEC, waves: SPEC.waves.map((w) => ({ ...w, gate: "always" as const })) };
116
+ const { forge } = fakeForge("forgejo", notApproved);
117
+ const status = await approvalStatusOf({ spec: loosened, specFile: "waves.json", forge, pr: 3, head: HEAD, base: BASE, show: atBase(strict), readPlans: async () => plans([{ wave: 1, name: "dev", digest: "d1", changes: true }, { wave: 2, name: "prod", digest: "d2", changes: true }]) });
118
+ expect(status).toMatchObject({ state: "pending", waits: [1, 2] });
119
+ });
120
+
121
+ test("plans not recorded yet are pending; no pr-review wave at base is success", async () => {
122
+ const { forge } = fakeForge("github", approved);
123
+ expect(await approvalStatusOf({ spec: SPEC, specFile: "waves.json", forge, pr: 3, head: HEAD, base: BASE, show: atBase(SPEC), readPlans: async () => null })).toMatchObject({ state: "pending", description: expect.stringContaining("not recorded yet") });
124
+ const ledgerOnly: OpWavesSpec = { ...SPEC, waves: SPEC.waves.map(({ approval: _a, ...w }) => w) };
125
+ expect(await approvalStatusOf({ spec: SPEC, specFile: "waves.json", forge, pr: 3, head: HEAD, base: BASE, show: atBase(ledgerOnly), readPlans: async () => null })).toMatchObject({ state: "success" });
126
+ });
127
+
128
+ test("--open posts on every open merge request from the repository, and leaves forks out", async () => {
129
+ const { forge, statuses } = fakeForge("gitlab", notApproved);
130
+ const done = await postOpenApprovalStatuses({ spec: SPEC, specFile: "waves.json", forge, branch: "main", show: atBase(SPEC), readPlans: async () => plans([{ wave: 2, name: "prod", digest: "d2", changes: true, destructive: true }]) }, assertProductWords({ product: "plywood" }));
131
+ expect(done.posted.map((p) => p.pr)).toEqual([3]);
132
+ expect(statuses.map((s) => s.sha)).toEqual([HEAD]);
133
+ });
134
+ });
@@ -0,0 +1,235 @@
1
+ /**
2
+ * The approval status before merge (#4630): `<product>/approval` on an open
3
+ * pull request's head says whether the waves its merge will run wait for an
4
+ * approval. It covers the waves whose approval at base is `pr-review` and,
5
+ * under the 2026-10-28 ruling, the waves whose approval is `pull-request`.
6
+ *
7
+ * - `pending` while a wave whose gate the plan will hold has no approval
8
+ * that would pass it: under `pr-review` an approving review of that head,
9
+ * by a writer other than its author; under `pull-request` the pull
10
+ * request's own approval (below).
11
+ * - `success` once every such wave has one, or when no wave's gate holds
12
+ * the plan.
13
+ *
14
+ * Which waves the gate holds is read the way the wave job reads it after the
15
+ * merge: each wave's approval mode and policy from the spec at the pull
16
+ * request's base (`readOpWavePolicy`), applied to the facts the head's plans
17
+ * record (`chant run wave --record-plans`, `../lifecycle/wave-plans.ts`):
18
+ * whether a run changes anything and whether a plan is destructive. A head
19
+ * whose plans are not recorded yet is pending, since nothing says its waves
20
+ * pass.
21
+ *
22
+ * The pull request's own approval, for a `pull-request` wave: an approval at
23
+ * the pull request's gate (`approvals.pullRequest.gate` at base) whose
24
+ * change set covers the wave's change set at the head, as the merged wave
25
+ * checks it (`planCoveredBy`). The approval is read on the pull request's
26
+ * op (`pr-<n>`), where the product's approve line records it, and on the
27
+ * spec's op, which the merged wave reads. The head's change set is the one
28
+ * `--record-plans` stored for the wave; a record without one is pending.
29
+ *
30
+ * The status job reads only: the pull request, its reviews and
31
+ * `chant/lifecycle`. It writes the one commit status. On GitHub and Forgejo
32
+ * it runs after the record-plans job and on every review; on GitLab, whose
33
+ * approvals start no pipeline, a scheduled pipeline of the target branch
34
+ * posts it for every open merge request (`--open`). An approval recorded on
35
+ * the ledger starts no run on any forge: the next push, review or `--open`
36
+ * run posts it. The status advises: the gate after the merge decides, from
37
+ * the ledger and the merged review.
38
+ */
39
+
40
+ import { activeProductWords, productStatusContext, type CiProductWords } from "../ci-product-words";
41
+ import type { ChangeSetDocument } from "../change-set";
42
+ import type { GateResolutionRecord } from "../lifecycle/gate-ledger";
43
+ import type { HeadPlans } from "../lifecycle/wave-plans";
44
+ import type { PrApproverFilter, PrForge } from "../pr-forge";
45
+ import type { OpWaveGatePolicy, OpWavesSpec } from "./op-waves";
46
+ import type { OpWaveShowAtBase } from "./op-waves-run";
47
+
48
+ /** What the status says. */
49
+ export interface ApprovalStatus {
50
+ state: "pending" | "success";
51
+ description: string;
52
+ /** The waves whose gate the plan will hold, by number. */
53
+ waits: number[];
54
+ /** Who approved the head, when someone did. */
55
+ approvers: string[];
56
+ }
57
+
58
+ export interface ApprovalStatusInput {
59
+ spec: OpWavesSpec;
60
+ /** The spec's path, which the policy is read from at `base`. */
61
+ specFile: string;
62
+ forge: Pick<PrForge, "prApproved" | "kind">;
63
+ pr: number;
64
+ /** The pull request's head commit. */
65
+ head: string;
66
+ /** The pull request's base commit, which the policy is read at. */
67
+ base: string;
68
+ cwd?: string;
69
+ /** The head's recorded plans. Default: `chant/lifecycle` at `cwd`. */
70
+ readPlans?: (name: string, head: string) => Promise<HeadPlans | null>;
71
+ /** How the spec is read at base. Default `git show`. */
72
+ show?: OpWaveShowAtBase;
73
+ /** Who may approve, as the forge's requires check takes it. */
74
+ approvers?: PrApproverFilter;
75
+ /** The resolutions on one op's gate ledger, for a `pull-request` wave. Default: `chant/lifecycle` at `cwd`. */
76
+ readResolutions?: (op: string) => Promise<GateResolutionRecord[]>;
77
+ /** A stored change set by digest, for a `pull-request` wave. Default: `_change-sets/` on `chant/lifecycle` at `cwd`. */
78
+ changeSets?: (digest: string) => Promise<ChangeSetDocument | undefined>;
79
+ }
80
+
81
+ /** Whether `policy` holds a wave with these facts. A record with no facts reads as changing, so it holds under `always`. */
82
+ export function headWaveHolds(policy: OpWaveGatePolicy, facts: { changes?: boolean; destructive?: boolean }): boolean {
83
+ if (policy === "never") return false;
84
+ if (facts.changes === false) return false;
85
+ if (policy === "on-destructive") return facts.destructive === true;
86
+ return true;
87
+ }
88
+
89
+ const short = (sha: string): string => sha.slice(0, 8);
90
+ const cut = (text: string): string => (text.length > 135 ? `${text.slice(0, 132)}...` : text);
91
+
92
+ /** The status for one pull request's head. Throws only when the spec cannot be read at base. */
93
+ export async function approvalStatusOf(input: ApprovalStatusInput): Promise<ApprovalStatus> {
94
+ const cwd = input.cwd ?? process.cwd();
95
+ const { readOpWavePolicy } = await import("./op-waves-run");
96
+ const rulesOf = (name: string) => readOpWavePolicy(input.specFile, name, input.base, cwd, ...(input.show ? [input.show] : []));
97
+ const asked = input.spec.waves
98
+ .map((w, i) => ({ k: i + 1, wave: w, rules: rulesOf(w.name) }))
99
+ .filter(({ rules }) => rules.approval === "pr-review" || rules.approval === "pull-request");
100
+ if (asked.length === 0) return { state: "success", description: "no wave takes its approval from the pull request", waits: [], approvers: [] };
101
+ const plans = await (input.readPlans ?? ((name, head) => ledgerHeadPlans(name, head, cwd)))(input.spec.name, input.head);
102
+ if (!plans) {
103
+ return { state: "pending", description: cut(`the plans of ${short(input.head)} are not recorded yet, so every wave may wait`), waits: asked.map((r) => r.k), approvers: [] };
104
+ }
105
+ const factsOf = (k: number) => plans.waves.find((w) => w.wave === k);
106
+ const holding = asked.filter(({ k, rules }) => headWaveHolds(rules.policy, factsOf(k) ?? {}));
107
+ const waits = holding.map((r) => r.k);
108
+ if (waits.length === 0) return { state: "success", description: cut(`no wave waits for an approval at ${short(input.head)}`), waits, approvers: [] };
109
+
110
+ const unmet: string[] = [];
111
+ const approvers = new Set<string>();
112
+ // pr-review: one approving review of the head answers every such wave.
113
+ const byReview = holding.filter((r) => r.rules.approval === "pr-review").map((r) => r.k);
114
+ if (byReview.length > 0) {
115
+ const which = wavesLabel(byReview);
116
+ if (!input.forge.prApproved) unmet.push(`${which}: ${input.forge.kind} cannot say who approved the head`);
117
+ else {
118
+ const approved = await input.forge.prApproved(input.pr, input.head, input.approvers);
119
+ if (approved.passed && approved.approvers.length > 0) for (const a of approved.approvers) approvers.add(a);
120
+ else unmet.push(`${which}: ${approved.reason}`);
121
+ }
122
+ }
123
+ // pull-request: the pull request's own approval, whose change set must cover each wave's.
124
+ const byPullRequest = holding.filter((r) => r.rules.approval === "pull-request");
125
+ if (byPullRequest.length > 0) {
126
+ const read = pullRequestApprovalReader(input, cwd);
127
+ for (const { k, rules } of byPullRequest) {
128
+ const got = await read(rules.pullRequestGate, factsOf(k)?.changeSet);
129
+ if (got.approvedBy) approvers.add(got.approvedBy);
130
+ else unmet.push(`wave ${k}: ${got.reason}`);
131
+ }
132
+ }
133
+ const which = wavesLabel(waits);
134
+ if (unmet.length > 0) return { state: "pending", description: cut(`${which} wait: ${unmet.join("; ")}`), waits, approvers: [] };
135
+ const by = [...approvers];
136
+ return { state: "success", description: cut(`${which} approved at ${short(input.head)} by ${by.join(", ")}`), waits, approvers: by };
137
+ }
138
+
139
+ const wavesLabel = (ks: readonly number[]): string => `wave${ks.length === 1 ? "" : "s"} ${ks.join(", ")}`;
140
+
141
+ /**
142
+ * How a `pull-request` wave's approval is found before merge: the newest
143
+ * approval at the pull request's gate, on the pull request's op or the
144
+ * spec's, whose change set covers the wave's change set at the head.
145
+ */
146
+ function pullRequestApprovalReader(input: ApprovalStatusInput, cwd: string) {
147
+ const resolutionsOf = input.readResolutions ?? ((op: string) => ledgerResolutions(op, cwd));
148
+ const changeSetOf = input.changeSets ?? ((digest: string) => ledgerChangeSet(digest, cwd));
149
+ let all: Promise<GateResolutionRecord[]> | undefined;
150
+ const resolutions = () =>
151
+ (all ??= (async () => {
152
+ // The pull request's op, as `prOp` (../pr-loop.ts) names it, and the spec's.
153
+ const ops = [...new Set([`pr-${input.pr}`, input.spec.name])];
154
+ return (await Promise.all(ops.map((op) => resolutionsOf(op)))).flat();
155
+ })());
156
+ return async (gate: string | undefined, digest: string | undefined): Promise<{ approvedBy?: string; reason: string }> => {
157
+ if (!gate) return { reason: "the spec at base names no approvals.pullRequest.gate" };
158
+ if (!digest) return { reason: `the plans of ${short(input.head)} carry no change set to check the pull request's approval against` };
159
+ const fresh = await changeSetOf(digest).catch(() => undefined);
160
+ if (!fresh) return { reason: `the change set ${digest} of ${short(input.head)} is not stored` };
161
+ const approvals = (await resolutions()).filter((r) => r.gate === gate && (r.changeSet ?? r.planDigest)).sort((a, b) => (a.timestamp < b.timestamp ? 1 : -1));
162
+ if (approvals.length === 0) return { reason: `the pull request's gate ${gate} has no approval` };
163
+ const { planCoveredBy } = await import("../components/pr-run");
164
+ let reason = `no approval at ${gate} covers its plans`;
165
+ for (const r of approvals) {
166
+ const approvedDigest = (r.changeSet ?? r.planDigest)!;
167
+ const approved = approvedDigest === fresh.digest ? fresh : await changeSetOf(approvedDigest).catch(() => undefined);
168
+ if (!approved) {
169
+ reason = `the change set ${approvedDigest} the approval at ${gate} names is not stored`;
170
+ continue;
171
+ }
172
+ const why = fresh.members.map((m) => planCoveredBy(approved, fresh, m.member)).find((w) => w !== undefined);
173
+ if (why === undefined) return { approvedBy: r.resolvedBy, reason: "" };
174
+ reason = why;
175
+ }
176
+ return { reason };
177
+ };
178
+ }
179
+
180
+ /** Post the status on the head. Returns what was posted. */
181
+ export async function postApprovalStatus(
182
+ input: ApprovalStatusInput & { forge: Pick<PrForge, "prApproved" | "kind" | "setStatus" | "runUrl"> },
183
+ words: CiProductWords = activeProductWords(),
184
+ ): Promise<ApprovalStatus> {
185
+ const status = await approvalStatusOf(input);
186
+ await input.forge.setStatus(input.head, {
187
+ context: productStatusContext(words, "approval"),
188
+ state: status.state,
189
+ description: status.description,
190
+ ...(input.forge.runUrl ? { url: input.forge.runUrl } : {}),
191
+ });
192
+ return status;
193
+ }
194
+
195
+ /**
196
+ * Post the status on every open pull request into `branch` (#4630), for
197
+ * GitLab's scheduled pipeline: the forge names each head and base. One
198
+ * that fails is a warning, and the rest are posted.
199
+ */
200
+ export async function postOpenApprovalStatuses(
201
+ input: Omit<ApprovalStatusInput, "pr" | "head" | "base"> & { forge: Pick<PrForge, "prApproved" | "kind" | "setStatus" | "runUrl" | "openPullRequests">; branch: string },
202
+ words: CiProductWords = activeProductWords(),
203
+ ): Promise<{ posted: Array<{ pr: number; status: ApprovalStatus }>; warnings: string[] }> {
204
+ if (!input.forge.openPullRequests) throw new Error(`${input.forge.kind} cannot list its open pull requests, so --open is not for it`);
205
+ const posted: Array<{ pr: number; status: ApprovalStatus }> = [];
206
+ const warnings: string[] = [];
207
+ for (const open of await input.forge.openPullRequests(input.branch)) {
208
+ if (open.fork) continue;
209
+ try {
210
+ const status = await postApprovalStatus({ ...input, pr: open.number, head: open.headSha, base: open.baseSha ?? input.branch }, words);
211
+ posted.push({ pr: open.number, status });
212
+ } catch (err) {
213
+ warnings.push(`!${open.number}: ${err instanceof Error ? err.message : String(err)}`);
214
+ }
215
+ }
216
+ return { posted, warnings };
217
+ }
218
+
219
+ async function ledgerHeadPlans(name: string, head: string, cwd: string): Promise<HeadPlans | null> {
220
+ const { gitLedgerReadPort, requireLifecycleLedger } = await import("../lifecycle/git");
221
+ const { readHeadPlans } = await import("../lifecycle/wave-plans");
222
+ await requireLifecycleLedger({ cwd });
223
+ return readHeadPlans(gitLedgerReadPort({ cwd }), name, head);
224
+ }
225
+
226
+ async function ledgerResolutions(op: string, cwd: string): Promise<GateResolutionRecord[]> {
227
+ const { readGateLedger } = await import("../lifecycle/gate-ledger");
228
+ return (await readGateLedger(op, { cwd })).resolutions;
229
+ }
230
+
231
+ async function ledgerChangeSet(digest: string, cwd: string): Promise<ChangeSetDocument | undefined> {
232
+ const { readStoredChangeSet } = await import("../lifecycle/change-set-store");
233
+ const got = await readStoredChangeSet(digest, { cwd });
234
+ return got.status === "found" ? got.document : undefined;
235
+ }
@@ -177,7 +177,8 @@ describe("a pr-review wave (#3684)", () => {
177
177
  const h = harness(digest("a"));
178
178
  let written: unknown;
179
179
  const recorded = await recordOpWaveHeadPlans({ spec: spec("pr-review"), cwd: h.cwd, exec: h.exec, head: HEAD, now: "t", write: async (p) => void (written = p) });
180
- expect(recorded.waves).toEqual([{ wave: 1, name: "prod", digest: set(digest("a")) }]);
180
+ // #4630: the record keeps whether the wave changes anything and whether it is destructive.
181
+ expect(recorded.waves).toEqual([{ wave: 1, name: "prod", digest: set(digest("a")), changes: true, destructive: false }]);
181
182
  expect(written).toEqual(recorded);
182
183
  });
183
184
  });
package/src/op/gate.ts CHANGED
@@ -32,6 +32,9 @@
32
32
  * decision without an orphan branch on disk.
33
33
  */
34
34
 
35
+ import type { ChangeSetDocument } from "../change-set";
36
+ import { persistChangeSet } from "../lifecycle/change-set-store";
37
+ import { activeProductWords, approveLine, isChantWords } from "../ci-product-words";
35
38
  import {
36
39
  appendGateResolution,
37
40
  appendPendingGate,
@@ -48,7 +51,8 @@ import {
48
51
  } from "../lifecycle/gate-ledger";
49
52
  import { describePlanDigest, samePlanDigest } from "../lifecycle/plan-digest";
50
53
  import { isModelAuthored } from "../lifecycle/gate-origin";
51
- import { appliedGatePath, isApprovalSpent, parseAppliedGateLines, type AppliedGateRecord } from "../lifecycle/gate-applied";
54
+ import { appliedGatePath, isApprovalSpent, parseAppliedGateLines, type AppliedGateRecord, type FinishedGateRecord } from "../lifecycle/gate-applied";
55
+ import { gatedRequestAttachmentPath } from "../lifecycle/gated-request-digest";
52
56
  import { sortedJsonReplacer } from "../utils";
53
57
  import { gateContextDigest, type GateApprover, type GateBaseApproval, type ResolvedGateApproval } from "./gate-approval";
54
58
  import {
@@ -115,6 +119,19 @@ export interface GateLedgerPort {
115
119
  readApplied?(op: string): Promise<AppliedGateRecord[]>;
116
120
  /** Record that a wave is about to apply under an approval (#3784), which spends it. */
117
121
  appendApplied?(record: AppliedGateRecord): Promise<{ pushed: boolean; pushWarning?: string }>;
122
+ /**
123
+ * Record how an apply under an approval ended (#4623): a `finished` line in
124
+ * the same `_gates/<op>/applied.jsonl`, naming the applied line's time.
125
+ * Absent on a port that keeps none.
126
+ */
127
+ appendFinished?(record: FinishedGateRecord): Promise<{ pushed: boolean; pushWarning?: string }>;
128
+ /**
129
+ * Store a file a held request carries, such as a migration's proof, at
130
+ * `_gates/<op>/requests/<digest>.json` (#4623), once, before the pending
131
+ * fact that asks for it. Pushed with that fact. Absent on a port that
132
+ * keeps none.
133
+ */
134
+ storeRequestAttachment?(op: string, digest: string, text: string): Promise<void>;
118
135
  /**
119
136
  * Store the checkpoint of a run that stops at a gate that resumes (#3947),
120
137
  * at `_gates/<op>/checkpoints/<runId>.json`. Written before the pending
@@ -124,6 +141,13 @@ export interface GateLedgerPort {
124
141
  writeCheckpoint?(checkpoint: GateCheckpoint): Promise<void>;
125
142
  /** The text of a run's checkpoint, or null when there is none (#3947). */
126
143
  readCheckpoint?(op: string, runId: string): Promise<string | null>;
144
+ /**
145
+ * Store a change-set document under its digest in `_change-sets/`
146
+ * (#4551), before the pending fact that cites it as `changeSet`. Throws for
147
+ * a document that is not one or does not hash to its digest. Absent on a
148
+ * port that keeps none, and the fact then cites none.
149
+ */
150
+ storeChangeSet?(doc: ChangeSetDocument): Promise<void>;
127
151
  }
128
152
 
129
153
  /** A workspace's rule for which approvals of a gate count (#3163): a signed approval, from a class when it names one. */
@@ -191,6 +215,10 @@ export function gitGateLedgerPort(opts?: { cwd?: string }): GateLedgerPort {
191
215
  await requireLifecycleLedger(opts);
192
216
  return readGateCheckpointText(op, runId, opts);
193
217
  },
218
+ async storeChangeSet(doc) {
219
+ // Pushed with the pending fact that cites it.
220
+ await persistChangeSet(doc, opts);
221
+ },
194
222
  async readApplied(op) {
195
223
  await requireLifecycleLedger(opts);
196
224
  const { dir, file } = appliedGatePath(op);
@@ -198,30 +226,43 @@ export function gitGateLedgerPort(opts?: { cwd?: string }): GateLedgerPort {
198
226
  return text ? parseAppliedGateLines(text) : [];
199
227
  },
200
228
  async appendApplied(record) {
201
- const { dir, file } = appliedGatePath(record.op);
202
- const line = JSON.stringify(record, sortedJsonReplacer);
203
- // #3985: write on top of the remote's ledger, not a local copy another
204
- // writer has since moved past, so the push that follows can land.
229
+ return appendAppliedFileLine(record.op, record as unknown as Record<string, unknown>, `Applied under ${record.gate}`);
230
+ },
231
+ async appendFinished(record) {
232
+ return appendAppliedFileLine(record.op, record as unknown as Record<string, unknown>, `Finished under ${record.gate}`);
233
+ },
234
+ async storeRequestAttachment(op, digest, text) {
235
+ const { dir, file } = gatedRequestAttachmentPath(op, digest);
205
236
  await requireLifecycleLedger(opts);
206
- let lastErr: unknown;
207
- // The same append-and-retry as a ledger line: another writer to the branch is the ordinary case.
208
- for (let attempt = 1; attempt <= 5; attempt++) {
209
- try {
210
- const prior = await readPathSha(dir, file, opts);
211
- const existing = prior ? await readBlobBySha(prior, opts) : null;
212
- await writeBlobToPath(dir, file, existing ? `${existing.replace(/\n$/, "")}\n${line}\n` : `${line}\n`, `Applied under ${record.gate}`, {
213
- ...opts,
214
- expectPriorPathSha: prior,
215
- });
216
- return pushLifecycleReport(opts);
217
- } catch (err) {
218
- if (!(err instanceof RefCASConflictError)) throw err;
219
- lastErr = err;
220
- }
221
- }
222
- throw lastErr;
237
+ if ((await readPathSha(dir, file, opts)) === null) await writeBlobToPath(dir, file, text, `Request on ${op}: ${digest}`, opts);
223
238
  },
224
239
  };
240
+
241
+ /** Append one line to `_gates/<op>/applied.jsonl` on top of the remote's ledger, retrying on a concurrent writer, and push. */
242
+ async function appendAppliedFileLine(op: string, record: Record<string, unknown>, message: string): Promise<{ pushed: boolean; pushWarning?: string }> {
243
+ const { dir, file } = appliedGatePath(op);
244
+ const line = JSON.stringify(record, sortedJsonReplacer);
245
+ // #3985: write on top of the remote's ledger, not a local copy another
246
+ // writer has since moved past, so the push that follows can land.
247
+ await requireLifecycleLedger(opts);
248
+ let lastErr: unknown;
249
+ // The same append-and-retry as a ledger line: another writer to the branch is the ordinary case.
250
+ for (let attempt = 1; attempt <= 5; attempt++) {
251
+ try {
252
+ const prior = await readPathSha(dir, file, opts);
253
+ const existing = prior ? await readBlobBySha(prior, opts) : null;
254
+ await writeBlobToPath(dir, file, existing ? `${existing.replace(/\n$/, "")}\n${line}\n` : `${line}\n`, message, {
255
+ ...opts,
256
+ expectPriorPathSha: prior,
257
+ });
258
+ return pushLifecycleReport(opts);
259
+ } catch (err) {
260
+ if (!(err instanceof RefCASConflictError)) throw err;
261
+ lastErr = err;
262
+ }
263
+ }
264
+ throw lastErr;
265
+ }
225
266
  }
226
267
 
227
268
  /** A gate ledger held in memory — what a test, or a caller that has already read the ledger, hands {@link evaluateGate}. */
@@ -231,6 +272,10 @@ export function memoryGateLedgerPort(
231
272
  appended: PendingGateRecord[];
232
273
  resolved: GateResolutionRecord[];
233
274
  applied: AppliedGateRecord[];
275
+ /** The finished lines appended (#4623). */
276
+ finished: FinishedGateRecord[];
277
+ /** Stored request attachments by `<op>/<digest>` (#4623). */
278
+ attachments: Map<string, string>;
234
279
  /** Checkpoint texts by `<op>/<runId>` (#3947). */
235
280
  checkpoints: Map<string, string>;
236
281
  } {
@@ -240,11 +285,22 @@ export function memoryGateLedgerPort(
240
285
  const resolved: GateResolutionRecord[] = [];
241
286
  const applied: AppliedGateRecord[] = [...(seed.applied ?? [])];
242
287
  const checkpoints = new Map<string, string>();
288
+ const finished: FinishedGateRecord[] = [];
289
+ const attachments = new Map<string, string>();
243
290
  return {
244
291
  appended,
245
292
  resolved,
246
293
  applied,
294
+ finished,
295
+ attachments,
247
296
  checkpoints,
297
+ async appendFinished(record) {
298
+ finished.push(record);
299
+ return { pushed: true };
300
+ },
301
+ async storeRequestAttachment(op, digest, text) {
302
+ if (!attachments.has(`${op}/${digest}`)) attachments.set(`${op}/${digest}`, text);
303
+ },
248
304
  async writeCheckpoint(checkpoint) {
249
305
  checkpoints.set(`${checkpoint.op}/${checkpoint.runId}`, gateCheckpointText(checkpoint));
250
306
  },
@@ -1040,6 +1096,9 @@ export async function evaluateGate(port: GateLedgerPort, input: GateCheckInput):
1040
1096
  * it.
1041
1097
  */
1042
1098
  export function approveCommand(op: string, gate: string, environment?: string, planDigest?: string, sealed = false): string {
1099
+ // #4550: under a product's words (its bin set them), the product's approve line.
1100
+ const words = activeProductWords();
1101
+ if (!isChantWords(words)) return approveLine(words, { op, gate, digest: planDigest ?? "", sign: sealed, ...(environment !== undefined ? { target: environment } : {}) });
1043
1102
  return `chant approve ${op} ${gate}` +
1044
1103
  (environment === undefined ? "" : ` --env ${environment}`) +
1045
1104
  (planDigest === undefined ? "" : ` --plan ${planDigest}`) +
@@ -28,6 +28,7 @@ import {
28
28
  type OpWavesPipelineOptions,
29
29
  } from "../lexicon";
30
30
  import { assertOpWavesSpec, type OpWaveJob, type OpWavesSpec } from "./op-waves";
31
+ import { activeProductWords } from "../ci-product-words";
31
32
 
32
33
  /**
33
34
  * Load a lexicon's plugin (`@intentius/chant-lexicon-<name>`) to reach its
@@ -158,7 +159,12 @@ export async function generateOpWavesPipeline(
158
159
  return { success: false, error: `Unknown Op(s): ${unknown.join(", ")}.${known ? ` Known Ops: ${known}` : " No Ops discovered."}` };
159
160
  }
160
161
  try {
161
- const { files, jobs } = plugin.generateOpWavesPipeline(spec, options);
162
+ // #4607: a product's bin, when it runs the generator in process with its words, is the command in each job.
163
+ const active = activeProductWords();
164
+ const bin = options.bin ?? active.bin;
165
+ // #4617: the control dispatch speaks in the product's words too.
166
+ const words = options.words ?? (spec.control ? active : undefined);
167
+ const { files, jobs } = plugin.generateOpWavesPipeline(spec, { ...options, ...(bin ? { bin } : {}), ...(words ? { words } : {}) });
162
168
  return { success: true, files, jobs };
163
169
  } catch (err) {
164
170
  return { success: false, error: err instanceof Error ? err.message : String(err) };
package/src/op/index.ts CHANGED
@@ -78,7 +78,9 @@ export {
78
78
  runStageHooksAsync,
79
79
  spawnExecAsync,
80
80
  opWaveNeedsApproval,
81
+ opWavePlanPath,
81
82
  opWavePlansPath,
83
+ OP_WAVE_PLAN_PATH_FLOOR,
82
84
  opWaveRunsPath,
83
85
  opWaveSetDigest,
84
86
  parseOpWavesSpec,
@@ -87,6 +89,7 @@ export {
87
89
  readOpWavePolicy,
88
90
  runOpWave,
89
91
  runOpWaveApplyHooks,
92
+ opWaveResourceLines,
90
93
  } from "./op-waves-run";
91
94
  export type {
92
95
  OpWaveBaseRules,
@@ -115,7 +118,27 @@ export type {
115
118
  RunOpWaveOptions,
116
119
  RunOpWaveResult,
117
120
  } from "./op-waves-run";
121
+ export {
122
+ OP_WAVE_COST_FORMATS,
123
+ OP_WAVE_COST_MEMBER,
124
+ opWaveCostVerdict,
125
+ opWaveHoldsAt,
126
+ opWaveHoldsProblems,
127
+ opWaveStepInput,
128
+ opWaveStepProblems,
129
+ readCostEstimate,
130
+ } from "./op-waves-capability";
131
+ export type { OpWaveCostFormat, OpWaveCostHold, OpWaveCostVerdict, OpWaveHolds, OpWaveRunCost, OpWaveStep, OpWaveStepApply, OpWaveStepPlan } from "./op-waves-capability";
118
132
  export { notifyOpWave, opWaveNotifyFields } from "./op-waves-notify";
133
+ export { OP_WAVE_STAND_DOWN_FLOOR, gitOpWaveNewerCommit, newerCommitOnBranch, opWaveRunBranch, opWaveStandDownReason, tipAppliesTargets } from "./op-waves-stand-down";
134
+ export type { OpWaveNewerCommit, OpWaveNewerCommitPort } from "./op-waves-stand-down";
135
+ export { OP_WAVE_RELEASE_RECORD_FLOOR, opWaveReleaseNames, opWaveReleaseProblems, releaseOfCommit } from "./op-waves-release";
136
+ export { gitOpWaveReleasePort } from "./op-waves-release-port";
137
+ export type { OpWaveReleaseNames, OpWaveReleaseOutcome, OpWaveReleasePort, OpWaveReleaseRequest } from "./op-waves-release";
138
+ export { foldPolicyRows, opWaveAfterPlanProblems, opWaveAfterPlanResultProblems, runOpWaveAfterPlanHooks } from "./op-waves-after-plan";
139
+ export type { OpWaveAfterPlanHook, OpWaveAfterPlanOutcome, OpWaveAfterPlanResult, OpWaveAfterPlanRun, OpWaveAfterPlanRunOutcome } from "./op-waves-after-plan";
140
+ export { OP_WAVE_AFTER_PLAN_FLOOR } from "./runtime";
141
+ export type { OpRunPolicyRow, OpRunWave, OpRunWavePlan, OpRunWaveTarget } from "./runtime";
119
142
  export type { OpWaveOutcome } from "./op-waves-notify";
120
143
  export { loadActivities, loadProfiles, resolveActivity } from "./activity-registry";
121
144
  export type { ActivityFn } from "./activity-registry";