@intentius/chant 0.124.54 → 0.124.55

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 (894) 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 +833 -0
  71. package/dist/ci-control.d.ts +42 -0
  72. package/dist/ci-control.d.ts.map +1 -0
  73. package/dist/ci-control.js +42 -0
  74. package/dist/ci-estate/delivery.d.ts +137 -0
  75. package/dist/ci-estate/delivery.d.ts.map +1 -0
  76. package/dist/ci-estate/delivery.js +311 -0
  77. package/dist/ci-estate/overdue.d.ts +34 -0
  78. package/dist/ci-estate/overdue.d.ts.map +1 -0
  79. package/dist/ci-estate/overdue.js +58 -0
  80. package/dist/ci-estate/page.d.ts +134 -0
  81. package/dist/ci-estate/page.d.ts.map +1 -0
  82. package/dist/ci-estate/page.js +233 -0
  83. package/dist/ci-estate/rows.d.ts +118 -0
  84. package/dist/ci-estate/rows.d.ts.map +1 -0
  85. package/dist/ci-estate/rows.js +126 -0
  86. package/dist/ci-estate.d.ts +68 -0
  87. package/dist/ci-estate.d.ts.map +1 -0
  88. package/dist/ci-estate.js +83 -0
  89. package/dist/ci-handover.d.ts +29 -5
  90. package/dist/ci-handover.d.ts.map +1 -1
  91. package/dist/ci-handover.js +50 -16
  92. package/dist/ci-identity.d.ts +82 -7
  93. package/dist/ci-identity.d.ts.map +1 -1
  94. package/dist/ci-identity.js +87 -15
  95. package/dist/ci-product-words.d.ts +290 -0
  96. package/dist/ci-product-words.d.ts.map +1 -0
  97. package/dist/ci-product-words.js +373 -0
  98. package/dist/ci-product.d.ts +82 -0
  99. package/dist/ci-product.d.ts.map +1 -0
  100. package/dist/ci-product.js +78 -0
  101. package/dist/cli/commands/audit.d.ts +2 -2
  102. package/dist/cli/commands/audit.d.ts.map +1 -1
  103. package/dist/cli/commands/audit.js +3 -2
  104. package/dist/cli/commands/carve.js +2 -2
  105. package/dist/cli/commands/init.d.ts +2 -0
  106. package/dist/cli/commands/init.d.ts.map +1 -1
  107. package/dist/cli/commands/init.js +1 -1
  108. package/dist/cli/handlers/agent.d.ts +17 -0
  109. package/dist/cli/handlers/agent.d.ts.map +1 -0
  110. package/dist/cli/handlers/agent.js +114 -0
  111. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  112. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  113. package/dist/cli/handlers/approve-confirm.js +142 -0
  114. package/dist/cli/handlers/approve.d.ts.map +1 -1
  115. package/dist/cli/handlers/approve.js +19 -1
  116. package/dist/cli/handlers/build.d.ts.map +1 -1
  117. package/dist/cli/handlers/build.js +43 -1
  118. package/dist/cli/handlers/ci-check.d.ts +3 -0
  119. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  120. package/dist/cli/handlers/ci-check.js +34 -0
  121. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  122. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  123. package/dist/cli/handlers/ci-forge-check.js +89 -0
  124. package/dist/cli/handlers/fan-out.js +4 -0
  125. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  126. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  127. package/dist/cli/handlers/gate-pending.js +44 -0
  128. package/dist/cli/handlers/init.d.ts.map +1 -1
  129. package/dist/cli/handlers/init.js +1 -0
  130. package/dist/cli/handlers/ledger.js +1 -1
  131. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  132. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  133. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  134. package/dist/cli/handlers/lock.d.ts.map +1 -1
  135. package/dist/cli/handlers/lock.js +64 -5
  136. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  137. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  138. package/dist/cli/handlers/notify-relay.js +130 -0
  139. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  140. package/dist/cli/handlers/pr-env.js +42 -11
  141. package/dist/cli/handlers/pr.d.ts +38 -3
  142. package/dist/cli/handlers/pr.d.ts.map +1 -1
  143. package/dist/cli/handlers/pr.js +653 -205
  144. package/dist/cli/handlers/promote.d.ts.map +1 -1
  145. package/dist/cli/handlers/promote.js +21 -2
  146. package/dist/cli/handlers/release.d.ts.map +1 -1
  147. package/dist/cli/handlers/release.js +3 -0
  148. package/dist/cli/handlers/run-wave.d.ts +8 -0
  149. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  150. package/dist/cli/handlers/run-wave.js +71 -1
  151. package/dist/cli/handlers/run.d.ts +6 -1
  152. package/dist/cli/handlers/run.d.ts.map +1 -1
  153. package/dist/cli/handlers/run.js +86 -1
  154. package/dist/cli/handlers/serve.d.ts.map +1 -1
  155. package/dist/cli/handlers/serve.js +10 -1
  156. package/dist/cli/main.d.ts +11 -1
  157. package/dist/cli/main.d.ts.map +1 -1
  158. package/dist/cli/main.js +124 -13
  159. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  160. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  161. package/dist/cli/mcp/ledger-tools.js +122 -0
  162. package/dist/cli/mcp/product-tools.d.ts +78 -0
  163. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  164. package/dist/cli/mcp/product-tools.js +93 -0
  165. package/dist/cli/mcp/read-only.d.ts +34 -0
  166. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  167. package/dist/cli/mcp/read-only.js +61 -0
  168. package/dist/cli/mcp/report-tools.d.ts +48 -0
  169. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  170. package/dist/cli/mcp/report-tools.js +128 -0
  171. package/dist/cli/mcp/server.d.ts +28 -1
  172. package/dist/cli/mcp/server.d.ts.map +1 -1
  173. package/dist/cli/mcp/server.js +86 -15
  174. package/dist/cli/mcp-config.d.ts +9 -2
  175. package/dist/cli/mcp-config.d.ts.map +1 -1
  176. package/dist/cli/mcp-config.js +8 -3
  177. package/dist/cli/parse-args.d.ts.map +1 -1
  178. package/dist/cli/parse-args.js +57 -3
  179. package/dist/cli/registry.d.ts +35 -0
  180. package/dist/cli/registry.d.ts.map +1 -1
  181. package/dist/cloud-lister/sigv4.d.ts +42 -7
  182. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  183. package/dist/cloud-lister/sigv4.js +72 -22
  184. package/dist/components/adoption.d.ts +69 -0
  185. package/dist/components/adoption.d.ts.map +1 -0
  186. package/dist/components/adoption.js +93 -0
  187. package/dist/components/apply-lease.d.ts +19 -0
  188. package/dist/components/apply-lease.d.ts.map +1 -0
  189. package/dist/components/apply-lease.js +41 -0
  190. package/dist/components/capability.d.ts +122 -5
  191. package/dist/components/capability.d.ts.map +1 -1
  192. package/dist/components/capability.js +14 -6
  193. package/dist/components/check-hooks.d.ts +113 -0
  194. package/dist/components/check-hooks.d.ts.map +1 -0
  195. package/dist/components/check-hooks.js +192 -0
  196. package/dist/components/ci-services.d.ts +57 -0
  197. package/dist/components/ci-services.d.ts.map +1 -0
  198. package/dist/components/ci-services.js +61 -0
  199. package/dist/components/cli-support.d.ts +13 -0
  200. package/dist/components/cli-support.d.ts.map +1 -1
  201. package/dist/components/cli-support.js +10 -2
  202. package/dist/components/driver.d.ts +20 -3
  203. package/dist/components/driver.d.ts.map +1 -1
  204. package/dist/components/driver.js +24 -4
  205. package/dist/components/fan-out-run.d.ts +12 -0
  206. package/dist/components/fan-out-run.d.ts.map +1 -1
  207. package/dist/components/fan-out-run.js +56 -16
  208. package/dist/components/groups.d.ts.map +1 -1
  209. package/dist/components/groups.js +19 -2
  210. package/dist/components/pr-env-ledger.d.ts +32 -0
  211. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  212. package/dist/components/pr-env-ledger.js +39 -0
  213. package/dist/components/pr-env-ports.d.ts +12 -0
  214. package/dist/components/pr-env-ports.d.ts.map +1 -1
  215. package/dist/components/pr-env-ports.js +13 -3
  216. package/dist/components/pr-env-run.d.ts +6 -0
  217. package/dist/components/pr-env-run.d.ts.map +1 -1
  218. package/dist/components/pr-env-run.js +3 -2
  219. package/dist/components/pr-environment.d.ts +31 -3
  220. package/dist/components/pr-environment.d.ts.map +1 -1
  221. package/dist/components/pr-environment.js +25 -7
  222. package/dist/components/pr-pipeline.d.ts +169 -3
  223. package/dist/components/pr-pipeline.d.ts.map +1 -1
  224. package/dist/components/pr-pipeline.js +184 -9
  225. package/dist/components/pr-policy.d.ts +26 -2
  226. package/dist/components/pr-policy.d.ts.map +1 -1
  227. package/dist/components/pr-policy.js +41 -7
  228. package/dist/components/pr-run.d.ts +63 -0
  229. package/dist/components/pr-run.d.ts.map +1 -1
  230. package/dist/components/pr-run.js +82 -3
  231. package/dist/components/pr-targets.d.ts +24 -0
  232. package/dist/components/pr-targets.d.ts.map +1 -0
  233. package/dist/components/pr-targets.js +48 -0
  234. package/dist/components/product-pipeline.d.ts +217 -0
  235. package/dist/components/product-pipeline.d.ts.map +1 -0
  236. package/dist/components/product-pipeline.js +193 -0
  237. package/dist/components/promote.d.ts +6 -0
  238. package/dist/components/promote.d.ts.map +1 -1
  239. package/dist/components/promote.js +4 -1
  240. package/dist/components/release-compile.d.ts +22 -1
  241. package/dist/components/release-compile.d.ts.map +1 -1
  242. package/dist/components/release-compile.js +85 -0
  243. package/dist/components/release-promote.d.ts +15 -1
  244. package/dist/components/release-promote.d.ts.map +1 -1
  245. package/dist/components/release-promote.js +67 -2
  246. package/dist/components/repo-lock.d.ts +27 -0
  247. package/dist/components/repo-lock.d.ts.map +1 -0
  248. package/dist/components/repo-lock.js +49 -0
  249. package/dist/components/row-lease.d.ts +84 -0
  250. package/dist/components/row-lease.d.ts.map +1 -0
  251. package/dist/components/row-lease.js +110 -0
  252. package/dist/components/wave-plan.d.ts +34 -0
  253. package/dist/components/wave-plan.d.ts.map +1 -1
  254. package/dist/components/wave-plan.js +54 -2
  255. package/dist/control/applied.d.ts +89 -0
  256. package/dist/control/applied.d.ts.map +1 -0
  257. package/dist/control/applied.js +175 -0
  258. package/dist/control/consumers.d.ts +78 -0
  259. package/dist/control/consumers.d.ts.map +1 -0
  260. package/dist/control/consumers.js +172 -0
  261. package/dist/control/dispatch.d.ts +334 -0
  262. package/dist/control/dispatch.d.ts.map +1 -0
  263. package/dist/control/dispatch.js +519 -0
  264. package/dist/control/edges.d.ts +75 -0
  265. package/dist/control/edges.d.ts.map +1 -0
  266. package/dist/control/edges.js +133 -0
  267. package/dist/control/reconcile.d.ts +120 -0
  268. package/dist/control/reconcile.d.ts.map +1 -0
  269. package/dist/control/reconcile.js +178 -0
  270. package/dist/control/records.d.ts +187 -0
  271. package/dist/control/records.d.ts.map +1 -0
  272. package/dist/control/records.js +307 -0
  273. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  274. package/dist/discovery/sandbox/bundle.js +25 -1
  275. package/dist/engine-facts.d.ts.map +1 -1
  276. package/dist/engine-facts.js +1 -2
  277. package/dist/exit-codes.d.ts +48 -0
  278. package/dist/exit-codes.d.ts.map +1 -0
  279. package/dist/exit-codes.js +49 -0
  280. package/dist/forge-check/check.d.ts +63 -0
  281. package/dist/forge-check/check.d.ts.map +1 -0
  282. package/dist/forge-check/check.js +139 -0
  283. package/dist/forge-check/contract.d.ts +152 -0
  284. package/dist/forge-check/contract.d.ts.map +1 -0
  285. package/dist/forge-check/contract.js +118 -0
  286. package/dist/forge-check/forge.d.ts +42 -0
  287. package/dist/forge-check/forge.d.ts.map +1 -0
  288. package/dist/forge-check/forge.js +338 -0
  289. package/dist/forge-check/index.d.ts +24 -0
  290. package/dist/forge-check/index.d.ts.map +1 -0
  291. package/dist/forge-check/index.js +23 -0
  292. package/dist/forge-check/pulumi.d.ts +44 -0
  293. package/dist/forge-check/pulumi.d.ts.map +1 -0
  294. package/dist/forge-check/pulumi.js +184 -0
  295. package/dist/forge-check/read-only.d.ts +26 -0
  296. package/dist/forge-check/read-only.d.ts.map +1 -0
  297. package/dist/forge-check/read-only.js +53 -0
  298. package/dist/forge-check/trust.d.ts +94 -0
  299. package/dist/forge-check/trust.d.ts.map +1 -0
  300. package/dist/forge-check/trust.js +532 -0
  301. package/dist/forge-check/types.d.ts +80 -0
  302. package/dist/forge-check/types.d.ts.map +1 -0
  303. package/dist/forge-check/types.js +18 -0
  304. package/dist/forge-check.d.ts +6 -0
  305. package/dist/forge-check.d.ts.map +1 -0
  306. package/dist/forge-check.js +5 -0
  307. package/dist/gate-decision.d.ts +1 -0
  308. package/dist/gate-decision.d.ts.map +1 -1
  309. package/dist/gate-decision.js +2 -0
  310. package/dist/gate-policy.d.ts +47 -1
  311. package/dist/gate-policy.d.ts.map +1 -1
  312. package/dist/gate-policy.js +50 -2
  313. package/dist/index.d.ts +1 -0
  314. package/dist/index.d.ts.map +1 -1
  315. package/dist/index.js +2 -0
  316. package/dist/lexicon.d.ts +106 -6
  317. package/dist/lexicon.d.ts.map +1 -1
  318. package/dist/lifecycle/adoption-file.d.ts +24 -0
  319. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  320. package/dist/lifecycle/adoption-file.js +1 -2
  321. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  322. package/dist/lifecycle/cloud-index.js +1 -2
  323. package/dist/lifecycle/gate-applied.d.ts +6 -0
  324. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  325. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  326. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  327. package/dist/lifecycle/gate-ledger.js +11 -1
  328. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  329. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  330. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  331. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  332. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  333. package/dist/lifecycle/gated-request-digest.js +35 -0
  334. package/dist/lifecycle/gated-request.d.ts +126 -0
  335. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  336. package/dist/lifecycle/gated-request.js +205 -0
  337. package/dist/lifecycle/identity-match.d.ts +15 -0
  338. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  339. package/dist/lifecycle/identity-match.js +11 -6
  340. package/dist/lifecycle/index-diff.d.ts +40 -0
  341. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  342. package/dist/lifecycle/index-diff.js +1 -2
  343. package/dist/lifecycle/index-document.d.ts.map +1 -1
  344. package/dist/lifecycle/index-document.js +1 -2
  345. package/dist/lifecycle/index-import.d.ts +4 -1
  346. package/dist/lifecycle/index-import.d.ts.map +1 -1
  347. package/dist/lifecycle/index-import.js +29 -32
  348. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  349. package/dist/lifecycle/ledger-read.js +7 -3
  350. package/dist/lifecycle/lock-rows.d.ts +76 -0
  351. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  352. package/dist/lifecycle/lock-rows.js +140 -0
  353. package/dist/lifecycle/query.d.ts +50 -3
  354. package/dist/lifecycle/query.d.ts.map +1 -1
  355. package/dist/lifecycle/query.js +97 -6
  356. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  357. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  358. package/dist/lifecycle/release-catalog-site.js +232 -0
  359. package/dist/lifecycle/release-catalog.d.ts +201 -0
  360. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  361. package/dist/lifecycle/release-catalog.js +198 -0
  362. package/dist/lifecycle/release-changelog.d.ts +41 -0
  363. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  364. package/dist/lifecycle/release-changelog.js +38 -0
  365. package/dist/lifecycle/release-cut.d.ts +1 -0
  366. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  367. package/dist/lifecycle/release-cut.js +1 -1
  368. package/dist/lifecycle/release-ledger.d.ts +16 -0
  369. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  370. package/dist/lifecycle/release-ledger.js +10 -0
  371. package/dist/lifecycle/release-publish.d.ts +43 -22
  372. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  373. package/dist/lifecycle/release-read.d.ts.map +1 -1
  374. package/dist/lifecycle/release-read.js +3 -0
  375. package/dist/lifecycle/release-status.d.ts +86 -0
  376. package/dist/lifecycle/release-status.d.ts.map +1 -0
  377. package/dist/lifecycle/release-status.js +136 -0
  378. package/dist/lifecycle/resource-lock.d.ts +120 -0
  379. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  380. package/dist/lifecycle/resource-lock.js +317 -0
  381. package/dist/lifecycle/retention.d.ts.map +1 -1
  382. package/dist/lifecycle/retention.js +3 -0
  383. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  384. package/dist/lifecycle/run-ledger.js +9 -1
  385. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  386. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  387. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  388. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  389. package/dist/lifecycle/snapshot-store.js +1 -2
  390. package/dist/lifecycle/target-lock.d.ts +15 -0
  391. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  392. package/dist/lifecycle/target-lock.js +25 -10
  393. package/dist/mcp/types.d.ts +7 -0
  394. package/dist/mcp/types.d.ts.map +1 -1
  395. package/dist/notify-product.d.ts +43 -0
  396. package/dist/notify-product.d.ts.map +1 -0
  397. package/dist/notify-product.js +58 -0
  398. package/dist/notify-relay.d.ts +197 -0
  399. package/dist/notify-relay.d.ts.map +1 -0
  400. package/dist/notify-relay.js +321 -0
  401. package/dist/notify.d.ts +44 -4
  402. package/dist/notify.d.ts.map +1 -1
  403. package/dist/notify.js +77 -14
  404. package/dist/object-store/azure-blob.d.ts +129 -0
  405. package/dist/object-store/azure-blob.d.ts.map +1 -0
  406. package/dist/object-store/azure-blob.js +341 -0
  407. package/dist/object-store/common.d.ts +108 -0
  408. package/dist/object-store/common.d.ts.map +1 -0
  409. package/dist/object-store/common.js +80 -0
  410. package/dist/object-store/errors.d.ts +28 -0
  411. package/dist/object-store/errors.d.ts.map +1 -0
  412. package/dist/object-store/errors.js +21 -0
  413. package/dist/object-store/from-env.d.ts +18 -0
  414. package/dist/object-store/from-env.d.ts.map +1 -0
  415. package/dist/object-store/from-env.js +22 -0
  416. package/dist/object-store/gcs.d.ts +106 -0
  417. package/dist/object-store/gcs.d.ts.map +1 -0
  418. package/dist/object-store/gcs.js +393 -0
  419. package/dist/object-store/index.d.ts +9 -0
  420. package/dist/object-store/index.d.ts.map +1 -0
  421. package/dist/object-store/index.js +8 -0
  422. package/dist/object-store/s3.d.ts +146 -0
  423. package/dist/object-store/s3.d.ts.map +1 -0
  424. package/dist/object-store/s3.js +306 -0
  425. package/dist/op/activities/converge.d.ts.map +1 -1
  426. package/dist/op/activities/converge.js +2 -1
  427. package/dist/op/activities/index.d.ts +1 -1
  428. package/dist/op/activities/index.d.ts.map +1 -1
  429. package/dist/op/activities/index.js +1 -1
  430. package/dist/op/activities/review-agent.d.ts +55 -2
  431. package/dist/op/activities/review-agent.d.ts.map +1 -1
  432. package/dist/op/activities/review-agent.js +65 -5
  433. package/dist/op/gate.d.ts +29 -1
  434. package/dist/op/gate.d.ts.map +1 -1
  435. package/dist/op/gate.js +59 -23
  436. package/dist/op/generate-pipeline.d.ts.map +1 -1
  437. package/dist/op/generate-pipeline.js +7 -1
  438. package/dist/op/index.d.ts +12 -1
  439. package/dist/op/index.d.ts.map +1 -1
  440. package/dist/op/index.js +7 -1
  441. package/dist/op/op-waves-after-plan.d.ts +137 -0
  442. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  443. package/dist/op/op-waves-after-plan.js +163 -0
  444. package/dist/op/op-waves-capability-spec.d.ts +55 -0
  445. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  446. package/dist/op/op-waves-capability-spec.js +94 -0
  447. package/dist/op/op-waves-capability.d.ts +197 -0
  448. package/dist/op/op-waves-capability.d.ts.map +1 -0
  449. package/dist/op/op-waves-capability.js +311 -0
  450. package/dist/op/op-waves-events.d.ts +54 -0
  451. package/dist/op/op-waves-events.d.ts.map +1 -0
  452. package/dist/op/op-waves-events.js +122 -0
  453. package/dist/op/op-waves-notify.d.ts +7 -1
  454. package/dist/op/op-waves-notify.d.ts.map +1 -1
  455. package/dist/op/op-waves-notify.js +35 -16
  456. package/dist/op/op-waves-release-port.d.ts +18 -0
  457. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  458. package/dist/op/op-waves-release-port.js +61 -0
  459. package/dist/op/op-waves-release.d.ts +92 -0
  460. package/dist/op/op-waves-release.d.ts.map +1 -0
  461. package/dist/op/op-waves-release.js +97 -0
  462. package/dist/op/op-waves-run.d.ts +175 -4
  463. package/dist/op/op-waves-run.d.ts.map +1 -1
  464. package/dist/op/op-waves-run.js +981 -41
  465. package/dist/op/op-waves-stand-down.d.ts +60 -0
  466. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  467. package/dist/op/op-waves-stand-down.js +97 -0
  468. package/dist/op/op-waves.d.ts +152 -8
  469. package/dist/op/op-waves.d.ts.map +1 -1
  470. package/dist/op/op-waves.js +161 -17
  471. package/dist/op/runtime.d.ts +91 -0
  472. package/dist/op/runtime.d.ts.map +1 -1
  473. package/dist/op/runtime.js +19 -0
  474. package/dist/op/stage-hooks.d.ts +45 -7
  475. package/dist/op/stage-hooks.d.ts.map +1 -1
  476. package/dist/op/stage-hooks.js +61 -3
  477. package/dist/op/steward-beside.d.ts.map +1 -1
  478. package/dist/op/steward-beside.js +2 -1
  479. package/dist/op/types.d.ts +2 -2
  480. package/dist/op/types.d.ts.map +1 -1
  481. package/dist/op/types.js +3 -2
  482. package/dist/otlp-metrics.d.ts +38 -0
  483. package/dist/otlp-metrics.d.ts.map +1 -0
  484. package/dist/otlp-metrics.js +82 -0
  485. package/dist/otlp.d.ts +249 -0
  486. package/dist/otlp.d.ts.map +1 -0
  487. package/dist/otlp.js +426 -0
  488. package/dist/override-gate.d.ts.map +1 -1
  489. package/dist/override-gate.js +5 -0
  490. package/dist/policy-packs.d.ts +69 -0
  491. package/dist/policy-packs.d.ts.map +1 -0
  492. package/dist/policy-packs.js +205 -0
  493. package/dist/policy-source.d.ts +51 -0
  494. package/dist/policy-source.d.ts.map +1 -0
  495. package/dist/policy-source.js +103 -0
  496. package/dist/pr-forge.d.ts +40 -0
  497. package/dist/pr-forge.d.ts.map +1 -1
  498. package/dist/pr-forge.js +92 -0
  499. package/dist/pr-loop.d.ts +149 -11
  500. package/dist/pr-loop.d.ts.map +1 -1
  501. package/dist/pr-loop.js +283 -44
  502. package/dist/pr-post.d.ts +16 -0
  503. package/dist/pr-post.d.ts.map +1 -1
  504. package/dist/pr-post.js +26 -1
  505. package/dist/pr-report-url.d.ts +32 -4
  506. package/dist/pr-report-url.d.ts.map +1 -1
  507. package/dist/pr-report-url.js +46 -5
  508. package/dist/pr-requires.d.ts +13 -2
  509. package/dist/pr-requires.d.ts.map +1 -1
  510. package/dist/pr-requires.js +14 -0
  511. package/dist/release-floors.d.ts +1 -1
  512. package/dist/release-floors.js +1 -1
  513. package/dist/run-event.d.ts +26 -1
  514. package/dist/run-event.d.ts.map +1 -1
  515. package/dist/run-event.js +4 -1
  516. package/dist/sorted-json.d.ts +10 -0
  517. package/dist/sorted-json.d.ts.map +1 -0
  518. package/dist/sorted-json.js +14 -0
  519. package/dist/terraform/credentials.d.ts +59 -0
  520. package/dist/terraform/credentials.d.ts.map +1 -0
  521. package/dist/terraform/credentials.js +149 -0
  522. package/dist/utils.d.ts +1 -4
  523. package/dist/utils.d.ts.map +1 -1
  524. package/dist/utils.js +1 -9
  525. package/dist/wave-runtime.d.ts +1 -1
  526. package/dist/wave-runtime.js +2 -2
  527. package/dist/wave-runtime.mjs +390 -285
  528. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  529. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  530. package/dist/workspace/ci-lock-grain.d.ts +12 -0
  531. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  532. package/dist/workspace/ci-lock-grain.js +27 -0
  533. package/dist/workspace/ci-run.d.ts +2 -1
  534. package/dist/workspace/ci-run.d.ts.map +1 -1
  535. package/dist/workspace/ci-run.js +6 -3
  536. package/dist/workspace/declaration.d.ts +16 -4
  537. package/dist/workspace/declaration.d.ts.map +1 -1
  538. package/dist/workspace/declaration.js +5 -2
  539. package/dist/workspace/declaration.schema.json +27 -3
  540. package/dist/workspace/drift-cli.d.ts.map +1 -1
  541. package/dist/workspace/drift-cli.js +8 -3
  542. package/dist/workspace/exit-cli.d.ts +1 -1
  543. package/dist/workspace/exit-cli.d.ts.map +1 -1
  544. package/dist/workspace/exit-cli.js +2 -1
  545. package/dist/workspace/import-fetch.d.ts +4 -2
  546. package/dist/workspace/import-fetch.d.ts.map +1 -1
  547. package/dist/workspace/import-fetch.js +4 -2
  548. package/dist/workspace/import-init.d.ts.map +1 -1
  549. package/dist/workspace/import-init.js +4 -2
  550. package/dist/workspace/ledger.schema.json +7 -3
  551. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  552. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  553. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  554. package/dist/workspace/pr-report.schema.json +74 -3
  555. package/dist/workspace/promote.d.ts +1 -1
  556. package/dist/workspace/promote.d.ts.map +1 -1
  557. package/dist/workspace/promote.js +2 -1
  558. package/dist/workspace/records-cli.d.ts +2 -2
  559. package/dist/workspace/records-cli.d.ts.map +1 -1
  560. package/dist/workspace/records-cli.js +3 -2
  561. package/dist/workspace/release-catalog.schema.json +277 -0
  562. package/dist/workspace/run-event.schema.json +18 -1
  563. package/dist/workspace/work-cli.d.ts +3 -1
  564. package/dist/workspace/work-cli.d.ts.map +1 -1
  565. package/dist/workspace/work-cli.js +7 -2
  566. package/dist/workspace/workspace-run.d.ts.map +1 -1
  567. package/dist/workspace/workspace-run.js +2 -1
  568. package/package.json +21 -1
  569. package/src/__fixtures__/estate-ledger.ts +101 -0
  570. package/src/__fixtures__/oidc-emulator.ts +31 -2
  571. package/src/__fixtures__/product-words.ts +44 -0
  572. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  573. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  574. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  575. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  576. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  577. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  578. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  579. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  580. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  581. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  582. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  583. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  584. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  585. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  586. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  587. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  588. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  589. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  590. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  591. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  592. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  593. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  594. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  595. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  596. package/src/__golden__/wave-loop/op-point.json +18 -4
  597. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  598. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  599. package/src/__golden__/wave-loop/op-spend.json +10 -2
  600. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  601. package/src/__golden__/wave-loop/op-wide.json +20 -4
  602. package/src/bucket-check/azure.ts +307 -0
  603. package/src/bucket-check/bucket-check.test.ts +210 -0
  604. package/src/bucket-check/fixtures/azure.json +153 -0
  605. package/src/bucket-check/fixtures/gcs.json +148 -0
  606. package/src/bucket-check/fixtures/s3.json +277 -0
  607. package/src/bucket-check/gcs.ts +257 -0
  608. package/src/bucket-check/index.ts +61 -0
  609. package/src/bucket-check/s3.ts +433 -0
  610. package/src/bucket-check/types.ts +75 -0
  611. package/src/bucket-check/wire.ts +50 -0
  612. package/src/bucket-check.ts +5 -0
  613. package/src/capabilities/templates.test.ts +2 -3
  614. package/src/capabilities/templates.ts +1 -2
  615. package/src/cdk/advise.test.ts +1 -1
  616. package/src/change-set-bundle.test.ts +0 -1
  617. package/src/change-set.ts +2 -3
  618. package/src/ci-agent.test.ts +348 -0
  619. package/src/ci-agent.ts +1026 -0
  620. package/src/ci-control.ts +174 -0
  621. package/src/ci-estate/delivery.ts +433 -0
  622. package/src/ci-estate/overdue.ts +81 -0
  623. package/src/ci-estate/page.ts +343 -0
  624. package/src/ci-estate/rows.ts +251 -0
  625. package/src/ci-estate.test.ts +281 -0
  626. package/src/ci-estate.ts +176 -0
  627. package/src/ci-handover.ts +67 -16
  628. package/src/ci-identity-database.test.ts +55 -0
  629. package/src/ci-identity-pulumi.test.ts +163 -0
  630. package/src/ci-identity-targets.test.ts +6 -2
  631. package/src/ci-identity.ts +124 -22
  632. package/src/ci-product-words.test.ts +101 -0
  633. package/src/ci-product-words.ts +536 -0
  634. package/src/ci-product.ts +174 -0
  635. package/src/ci-shared-reads.test.ts +145 -0
  636. package/src/cli/commands/audit.test.ts +1 -1
  637. package/src/cli/commands/audit.ts +3 -2
  638. package/src/cli/commands/carve.test.ts +1 -1
  639. package/src/cli/commands/carve.ts +2 -2
  640. package/src/cli/commands/init.ts +3 -1
  641. package/src/cli/component-wave-args.test.ts +16 -0
  642. package/src/cli/handlers/agent.ts +126 -0
  643. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  644. package/src/cli/handlers/approve-confirm.ts +200 -0
  645. package/src/cli/handlers/approve.ts +18 -1
  646. package/src/cli/handlers/build.test.ts +7 -0
  647. package/src/cli/handlers/build.ts +44 -1
  648. package/src/cli/handlers/ci-check.ts +33 -0
  649. package/src/cli/handlers/ci-forge-check.ts +91 -0
  650. package/src/cli/handlers/fan-out.test.ts +10 -10
  651. package/src/cli/handlers/fan-out.ts +5 -0
  652. package/src/cli/handlers/gate-pending.ts +46 -0
  653. package/src/cli/handlers/init.ts +1 -0
  654. package/src/cli/handlers/ledger.ts +1 -1
  655. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  656. package/src/cli/handlers/lock.test.ts +29 -2
  657. package/src/cli/handlers/lock.ts +66 -6
  658. package/src/cli/handlers/notify-relay.ts +130 -0
  659. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  660. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  661. package/src/cli/handlers/pr-env.ts +48 -11
  662. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  663. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  664. package/src/cli/handlers/pr-waves.test.ts +8 -2
  665. package/src/cli/handlers/pr.test.ts +8 -8
  666. package/src/cli/handlers/pr.ts +655 -205
  667. package/src/cli/handlers/promote.test.ts +5 -5
  668. package/src/cli/handlers/promote.ts +22 -2
  669. package/src/cli/handlers/release.ts +2 -0
  670. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  671. package/src/cli/handlers/run-wave.ts +65 -1
  672. package/src/cli/handlers/run.test.ts +6 -4
  673. package/src/cli/handlers/run.ts +86 -1
  674. package/src/cli/handlers/serve.ts +10 -1
  675. package/src/cli/main.ts +126 -13
  676. package/src/cli/mcp/ledger-tools.ts +126 -0
  677. package/src/cli/mcp/product-tools.test.ts +123 -0
  678. package/src/cli/mcp/product-tools.ts +129 -0
  679. package/src/cli/mcp/read-only.test.ts +134 -0
  680. package/src/cli/mcp/read-only.ts +68 -0
  681. package/src/cli/mcp/report-tools.ts +135 -0
  682. package/src/cli/mcp/server.test.ts +5 -4
  683. package/src/cli/mcp/server.ts +90 -16
  684. package/src/cli/mcp-config.ts +8 -3
  685. package/src/cli/parse-args.ts +42 -2
  686. package/src/cli/registry.ts +35 -0
  687. package/src/cloud-lister/sigv4.ts +80 -23
  688. package/src/components/adoption.test.ts +140 -0
  689. package/src/components/adoption.ts +141 -0
  690. package/src/components/apply-lease.ts +49 -0
  691. package/src/components/capability.ts +130 -6
  692. package/src/components/check-hooks.test.ts +66 -0
  693. package/src/components/check-hooks.ts +252 -0
  694. package/src/components/ci-services.test.ts +51 -0
  695. package/src/components/ci-services.ts +83 -0
  696. package/src/components/cli-support.ts +23 -2
  697. package/src/components/driver.test.ts +3 -3
  698. package/src/components/driver.ts +38 -5
  699. package/src/components/fan-out-run.ts +68 -18
  700. package/src/components/groups.ts +17 -2
  701. package/src/components/pr-comment-preview.test.ts +54 -0
  702. package/src/components/pr-env-ledger.test.ts +9 -0
  703. package/src/components/pr-env-ledger.ts +43 -0
  704. package/src/components/pr-env-ports.ts +29 -4
  705. package/src/components/pr-env-run-bundle.test.ts +8 -0
  706. package/src/components/pr-env-run.test.ts +19 -0
  707. package/src/components/pr-env-run.ts +12 -2
  708. package/src/components/pr-environment.test.ts +29 -0
  709. package/src/components/pr-environment.ts +39 -7
  710. package/src/components/pr-pipeline.test.ts +15 -0
  711. package/src/components/pr-pipeline.ts +274 -9
  712. package/src/components/pr-policy.ts +45 -7
  713. package/src/components/pr-run.test.ts +1 -1
  714. package/src/components/pr-run.ts +121 -5
  715. package/src/components/pr-targets.test.ts +35 -0
  716. package/src/components/pr-targets.ts +45 -0
  717. package/src/components/product-pipeline.test.ts +200 -0
  718. package/src/components/product-pipeline.ts +341 -0
  719. package/src/components/promote.ts +10 -1
  720. package/src/components/release-compile.ts +87 -1
  721. package/src/components/release-promote.ts +65 -1
  722. package/src/components/repo-lock.ts +52 -0
  723. package/src/components/row-lease.test.ts +490 -0
  724. package/src/components/row-lease.ts +167 -0
  725. package/src/components/wave-plan-policy.test.ts +19 -0
  726. package/src/components/wave-plan.ts +78 -4
  727. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  728. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  729. package/src/control/applied.test.ts +148 -0
  730. package/src/control/applied.ts +191 -0
  731. package/src/control/consumers.test.ts +129 -0
  732. package/src/control/consumers.ts +192 -0
  733. package/src/control/control.test.ts +302 -0
  734. package/src/control/dispatch.ts +699 -0
  735. package/src/control/edges.test.ts +112 -0
  736. package/src/control/edges.ts +164 -0
  737. package/src/control/note-checkout.test.ts +91 -0
  738. package/src/control/reconcile.ts +250 -0
  739. package/src/control/records.ts +395 -0
  740. package/src/discovery/sandbox/bundle.ts +25 -1
  741. package/src/engine-facts.test.ts +2 -3
  742. package/src/engine-facts.ts +1 -2
  743. package/src/exit-codes.test.ts +31 -0
  744. package/src/exit-codes.ts +55 -0
  745. package/src/forge-check/check.ts +155 -0
  746. package/src/forge-check/contract.ts +215 -0
  747. package/src/forge-check/forge-check.test.ts +427 -0
  748. package/src/forge-check/forge.ts +318 -0
  749. package/src/forge-check/index.ts +43 -0
  750. package/src/forge-check/pulumi.ts +192 -0
  751. package/src/forge-check/read-only.ts +56 -0
  752. package/src/forge-check/trust.ts +527 -0
  753. package/src/forge-check/types.ts +78 -0
  754. package/src/forge-check.ts +5 -0
  755. package/src/gate-decision-bundle.test.ts +13 -0
  756. package/src/gate-decision.ts +3 -0
  757. package/src/gate-policy.ts +92 -3
  758. package/src/gated-waves-bundle.test.ts +0 -1
  759. package/src/index.ts +2 -0
  760. package/src/lexicon.ts +95 -6
  761. package/src/lifecycle/adoption-file.ts +1 -2
  762. package/src/lifecycle/cloud-index.test.ts +2 -3
  763. package/src/lifecycle/cloud-index.ts +1 -2
  764. package/src/lifecycle/control-entries-ledger.test.ts +70 -0
  765. package/src/lifecycle/gate-applied.ts +6 -0
  766. package/src/lifecycle/gate-ledger.ts +36 -1
  767. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  768. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  769. package/src/lifecycle/gated-request-digest.ts +49 -0
  770. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  771. package/src/lifecycle/gated-request.ts +280 -0
  772. package/src/lifecycle/identity-match.ts +25 -6
  773. package/src/lifecycle/index-diff.ts +1 -2
  774. package/src/lifecycle/index-document.ts +1 -2
  775. package/src/lifecycle/index-import.test.ts +14 -0
  776. package/src/lifecycle/index-import.ts +54 -34
  777. package/src/lifecycle/ledger-read.ts +7 -3
  778. package/src/lifecycle/lock-rows.test.ts +109 -0
  779. package/src/lifecycle/lock-rows.ts +167 -0
  780. package/src/lifecycle/publish-target-context.test.ts +108 -0
  781. package/src/lifecycle/query.test.ts +2 -3
  782. package/src/lifecycle/query.ts +109 -7
  783. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  784. package/src/lifecycle/release-catalog-site.ts +291 -0
  785. package/src/lifecycle/release-catalog.test.ts +193 -0
  786. package/src/lifecycle/release-catalog.ts +353 -0
  787. package/src/lifecycle/release-changelog.test.ts +70 -0
  788. package/src/lifecycle/release-changelog.ts +71 -0
  789. package/src/lifecycle/release-cut.ts +2 -2
  790. package/src/lifecycle/release-ledger.ts +20 -0
  791. package/src/lifecycle/release-publish.ts +45 -22
  792. package/src/lifecycle/release-read.ts +2 -0
  793. package/src/lifecycle/release-status.test.ts +186 -0
  794. package/src/lifecycle/release-status.ts +176 -0
  795. package/src/lifecycle/resource-lock.test.ts +175 -0
  796. package/src/lifecycle/resource-lock.ts +354 -0
  797. package/src/lifecycle/retention.ts +2 -0
  798. package/src/lifecycle/run-ledger.ts +7 -1
  799. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  800. package/src/lifecycle/snapshot-store.ts +1 -2
  801. package/src/lifecycle/target-lock.ts +24 -9
  802. package/src/mcp/types.ts +7 -0
  803. package/src/notify-product.ts +76 -0
  804. package/src/notify-relay.test.ts +213 -0
  805. package/src/notify-relay.ts +407 -0
  806. package/src/notify.ts +95 -14
  807. package/src/object-store/azure-blob.ts +374 -0
  808. package/src/object-store/common.ts +133 -0
  809. package/src/object-store/errors.ts +26 -0
  810. package/src/object-store/from-env.ts +36 -0
  811. package/src/object-store/gcs.ts +436 -0
  812. package/src/object-store/index.ts +8 -0
  813. package/src/object-store/object-store.test.ts +130 -0
  814. package/src/object-store/s3.ts +350 -0
  815. package/src/op/activities/converge.ts +2 -1
  816. package/src/op/activities/index.ts +1 -1
  817. package/src/op/activities/review-agent.open.test.ts +78 -0
  818. package/src/op/activities/review-agent.test.ts +13 -0
  819. package/src/op/activities/review-agent.ts +89 -5
  820. package/src/op/gate.ts +81 -22
  821. package/src/op/generate-pipeline.ts +7 -1
  822. package/src/op/index.ts +21 -0
  823. package/src/op/op-waves-after-plan.test.ts +276 -0
  824. package/src/op/op-waves-after-plan.ts +238 -0
  825. package/src/op/op-waves-capability-spec.ts +113 -0
  826. package/src/op/op-waves-capability.test.ts +217 -0
  827. package/src/op/op-waves-capability.ts +370 -0
  828. package/src/op/op-waves-events.ts +135 -0
  829. package/src/op/op-waves-notify-words.test.ts +149 -0
  830. package/src/op/op-waves-notify.ts +41 -16
  831. package/src/op/op-waves-pull-request.test.ts +142 -0
  832. package/src/op/op-waves-release-port.ts +64 -0
  833. package/src/op/op-waves-release.test.ts +209 -0
  834. package/src/op/op-waves-release.ts +133 -0
  835. package/src/op/op-waves-run-record.test.ts +32 -0
  836. package/src/op/op-waves-run.ts +1142 -49
  837. package/src/op/op-waves-stand-down.test.ts +240 -0
  838. package/src/op/op-waves-stand-down.ts +108 -0
  839. package/src/op/op-waves-trace.test.ts +205 -0
  840. package/src/op/op-waves.test.ts +112 -0
  841. package/src/op/op-waves.ts +261 -20
  842. package/src/op/runtime.ts +104 -0
  843. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  844. package/src/op/stage-hooks.ts +91 -12
  845. package/src/op/steward-beside.ts +2 -1
  846. package/src/op/types.ts +3 -2
  847. package/src/otlp-metrics.ts +96 -0
  848. package/src/otlp.test.ts +243 -0
  849. package/src/otlp.ts +544 -0
  850. package/src/override-gate-bundle.test.ts +2 -0
  851. package/src/override-gate.ts +4 -0
  852. package/src/policy-packs.ts +230 -0
  853. package/src/policy-source.test.ts +256 -0
  854. package/src/policy-source.ts +112 -0
  855. package/src/pr-forge.ts +123 -0
  856. package/src/pr-loop-bundle.test.ts +6 -2
  857. package/src/pr-loop-words.test.ts +155 -0
  858. package/src/pr-loop.ts +371 -52
  859. package/src/pr-post.ts +32 -1
  860. package/src/pr-report-url.ts +62 -6
  861. package/src/pr-requires.test.ts +37 -1
  862. package/src/pr-requires.ts +16 -2
  863. package/src/product-subpaths-plain-node.e2e.test.ts +211 -0
  864. package/src/release-floors.ts +1 -1
  865. package/src/run-event.ts +29 -1
  866. package/src/sorted-json.ts +17 -0
  867. package/src/stage-hooks-bundle.test.ts +8 -0
  868. package/src/terraform/credentials.test.ts +77 -0
  869. package/src/terraform/credentials.ts +162 -0
  870. package/src/utils.ts +2 -11
  871. package/src/wave-loop-golden.test.ts +2 -1
  872. package/src/wave-runtime.ts +2 -2
  873. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  874. package/src/workspace/ci-lock-grain.test.ts +31 -0
  875. package/src/workspace/ci-lock-grain.ts +30 -0
  876. package/src/workspace/ci-report-url.test.ts +1 -1
  877. package/src/workspace/ci-run.test.ts +1 -1
  878. package/src/workspace/ci-run.ts +6 -3
  879. package/src/workspace/declaration.schema.json +27 -3
  880. package/src/workspace/declaration.test.ts +1 -1
  881. package/src/workspace/declaration.ts +26 -10
  882. package/src/workspace/drift-cli.ts +8 -3
  883. package/src/workspace/exit-cli.ts +2 -1
  884. package/src/workspace/import-fetch.ts +4 -2
  885. package/src/workspace/import-init.ts +4 -2
  886. package/src/workspace/ledger.schema.json +7 -3
  887. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  888. package/src/workspace/pr-report.schema.json +74 -3
  889. package/src/workspace/promote.ts +2 -1
  890. package/src/workspace/records-cli.ts +3 -2
  891. package/src/workspace/release-catalog.schema.json +277 -0
  892. package/src/workspace/run-event.schema.json +18 -1
  893. package/src/workspace/work-cli.ts +8 -2
  894. package/src/workspace/workspace-run.ts +2 -1
@@ -0,0 +1,341 @@
1
+ /**
2
+ * The product pipeline (#4550): the one chant generator terragucci's and
3
+ * plywood's pull request jobs come from. The two differ only in the words
4
+ * and presets each passes.
5
+ *
6
+ * Under the 2026-10-27 ruling (A, hybrid) the plan side is the pull request
7
+ * loop's: the plan job (`pr-plan`), the plan-note job (`pr-post`) and the
8
+ * comment jobs. The apply on merge runs on op waves: one job per wave, each
9
+ * running `chant run wave`, whose plan and apply steps come from chant's
10
+ * capabilities (#4545 for Terraform, #4541 for Pulumi and plunge). The spec
11
+ * names the steps; this module fills the op and gate names from the words
12
+ * and leaves the steps as the spec gives them.
13
+ *
14
+ * Approvals (ruling B) are a preset: `per-wave` keeps each wave's own digest
15
+ * (terragucci), and `pull-request` lets the pull request's approval apply
16
+ * every wave whose plan its change set covers (plywood), through the op
17
+ * waves' `pull-request` approval source (../op/op-waves.ts).
18
+ *
19
+ * The jobs come back as the descriptors the forge lexicons already
20
+ * serialize (`PrLoopJob`, `OpWaveJob`). A product adds its own jobs to the
21
+ * same map before it writes the file.
22
+ */
23
+
24
+ import type { ForgeKind } from "../pr-forge";
25
+ import { layerWaves } from "../gated-waves";
26
+ import { opWaveBinArgv, opWaveJobs, opWavesControlTarget, type OpWave, type OpWaveJob, type OpWavesSpec } from "../op/op-waves";
27
+ import { controlNoteCheckout, type ControlNoteCheckout } from "../control/dispatch";
28
+ import {
29
+ assertProductWords,
30
+ CHANT_WORDS,
31
+ commentLine,
32
+ type CiProductApplyMode,
33
+ type CiProductCommand,
34
+ type CiProductWords,
35
+ type CiProductWordsInput,
36
+ } from "../ci-product-words";
37
+ import { prCommentLockJobs, prCommentPreviewJob, prLoopJobs, prLoopPostJob, withProductBin, type PrCommentLockJob, type PrCommentPreviewJob, type PrLoopJob, type PrLoopPipelineOptions } from "./pr-pipeline";
38
+ import type { DriverComponent } from "./driver";
39
+ import type { ScheduledOpSpec } from "../lexicon";
40
+ import type { CiRunner } from "../ci-jobs";
41
+ import { resolveAgentSpec, type OpAgentSpec } from "../ci-agent";
42
+
43
+ /** Where the generator writes a product's waves spec, which chant reads at base (#4550). */
44
+ export const PRODUCT_WAVES_SPEC_DIR = ".chant/op-waves";
45
+
46
+ /** The waves spec file of op `name`: `.chant/op-waves/<name>.spec.json`. */
47
+ export function productWavesSpecFile(name: string): string {
48
+ return `${PRODUCT_WAVES_SPEC_DIR}/${name}.spec.json`;
49
+ }
50
+
51
+ /** What {@link productPipelineJobs} takes: the pull request loop's options, the words, and the waves the merge applies. */
52
+ export interface ProductPipelineOptions extends Omit<PrLoopPipelineOptions, "words" | "waveGate" | "applyOnMerge"> {
53
+ words: CiProductWordsInput | CiProductWords;
54
+ /** The workspace member the pipeline is for. */
55
+ member?: string;
56
+ /**
57
+ * The waves the apply on merge runs, as the product's config maps onto
58
+ * them. Absent: a merge records the plan (the record job), and a release
59
+ * deploys it.
60
+ */
61
+ waves?: OpWavesSpec;
62
+ /** Where the spec is written, from the job's directory. Default {@link productWavesSpecFile}. */
63
+ wavesSpecFile?: string;
64
+ /**
65
+ * The product runs an agent job that answers its agent command (#4616):
66
+ * `true` for the defaults, or the agent's settings. The pipeline then
67
+ * returns the agent's Op spec, which the product writes and generates with
68
+ * `chant run --generate <forge> --spec <file>` as it does its other
69
+ * scheduled Ops.
70
+ */
71
+ agent?: boolean | ProductAgentOptions;
72
+ /**
73
+ * The apply on merge from the component graph (#4588), when `waves` is
74
+ * absent: the spec `pr-apply --wave-gate` runs, a wave per layer of
75
+ * `components`, each run a component planned and applied through the
76
+ * component plan-wave and apply-wave steps, a wave whose plan the approval
77
+ * does not cover waiting at `<waveGate>-wave-<k>`. `base` is what the
78
+ * steps measure the change from, by default `HEAD^1`, the commit before
79
+ * the merge.
80
+ */
81
+ componentWaves?: { components: readonly Pick<DriverComponent, "name" | "dependsOn">[]; waveGate?: string; base?: string };
82
+ }
83
+
84
+ /** The jobs of one product pipeline. */
85
+ export interface ProductPipelineJobs {
86
+ /** The words, every slot filled and checked. */
87
+ words: CiProductWords;
88
+ /** The plan job: `pr-plan` with the words. */
89
+ plan: PrLoopJob;
90
+ /**
91
+ * The plan-note job: `pr-post`. With a control repo named on the loop's
92
+ * `control` or the waves spec's (#4619), `control` is the step the note
93
+ * job runs before `pr-post`: a read-only fetch of the control repo's
94
+ * `chant/lifecycle` that sets `CHANT_CONTROL_DIR`, so the note marks the
95
+ * cross-stack edges.
96
+ */
97
+ post: { command: string; env: Record<string, string>; control?: ControlNoteCheckout };
98
+ /** The record job, when no waves apply on merge. */
99
+ record?: PrLoopJob;
100
+ /** The apply before merge, answering the apply comment, with `applyBeforeMerge`. */
101
+ applyBeforeMerge?: PrLoopJob;
102
+ /** The comment each command answers, `/<product> <word>`, for the commands the pipeline has a job for. */
103
+ comments: Partial<Record<CiProductCommand, string>>;
104
+ /** The apply on merge: the spec with the words' names, its file, and a job per wave (per share or group). */
105
+ waves?: { spec: OpWavesSpec; specFile: string; jobs: OpWaveJob[] };
106
+ /**
107
+ * The comment lock and unlock jobs (#4588), under `locks: "plan"`:
108
+ * `/<product> lock` keeps the locks the plan took, `/<product> unlock`
109
+ * releases them. The forge lexicons render the same jobs.
110
+ */
111
+ locks?: PrCommentLockJob[];
112
+ /**
113
+ * The comment preview (#4620), with `previewComment`: `/<product> <plan
114
+ * word>` plans the pull request's head again with a read token, and the
115
+ * job after it posts the note. The forge lexicons render the same jobs.
116
+ */
117
+ preview?: PrCommentPreviewJob;
118
+ /**
119
+ * The agent (#4616), with `agent`: the comment it answers, `/<product>
120
+ * agent <ask>`, and the scheduled Op spec whose generated workflow runs
121
+ * it: the agent job with a read token and the model's key, and the push
122
+ * job with the write token.
123
+ */
124
+ agent?: { comment: string; name: string; spec: ScheduledOpSpec };
125
+ }
126
+
127
+ /** An agent's settings as a product passes them (#4616): {@link OpAgentSpec} without the trigger, which the pipeline names. */
128
+ export interface ProductAgentOptions extends Omit<OpAgentSpec, "on" | "comment" | "branch"> {
129
+ /** The agent's name: its workflow, its jobs and its runs on the ledger. Default `<product>-agent`. */
130
+ name?: string;
131
+ /** Where its jobs run. */
132
+ runner?: CiRunner;
133
+ }
134
+
135
+ /** The agent's Op spec for `/<product> agent <ask>` (#4616). The settings are checked here, so a product finds a bad one when it generates. */
136
+ export function productAgentSpec(wordsIn: CiProductWordsInput | CiProductWords, comment: string, options: ProductAgentOptions = {}): ScheduledOpSpec {
137
+ const words = assertProductWords(wordsIn);
138
+ const { name: given, runner, ...settings } = options;
139
+ const name = given ?? `${words.product}-agent`;
140
+ const agent: OpAgentSpec = { on: "comment", comment, ...settings };
141
+ resolveAgentSpec(name, agent, words.product);
142
+ return { name, trigger: { kind: "pull_request" }, agent, ...(runner !== undefined ? { runner } : {}) };
143
+ }
144
+
145
+ /**
146
+ * The `agent` of a scheduled drift Op (#4616): after the Op's run exits with
147
+ * chant's `drift` code, the agent changes the code to say what is live and
148
+ * opens or updates a pull request from `<product>/agent/<op>`.
149
+ */
150
+ export function productDriftAgent(wordsIn: CiProductWordsInput | CiProductWords, op: string, options: Omit<OpAgentSpec, "on" | "comment"> = {}): OpAgentSpec {
151
+ const words = assertProductWords(wordsIn);
152
+ const agent: OpAgentSpec = { on: "drift", ...options };
153
+ resolveAgentSpec(op, agent, words.product);
154
+ return agent;
155
+ }
156
+
157
+ /**
158
+ * The waves spec with the product's names (#4550): the op the gates are
159
+ * recorded under, the wave gate pattern, and under the `pull-request`
160
+ * preset each wave's approval taken from the pull request's gate. A wave
161
+ * that names its own approval keeps it. Nothing else changes, so the plan
162
+ * and apply steps stay the capability steps the spec names.
163
+ */
164
+ export function productWavesSpec(spec: OpWavesSpec, wordsIn: CiProductWordsInput | CiProductWords): OpWavesSpec {
165
+ const words = assertProductWords(wordsIn);
166
+ const byPullRequest = words.approval === "pull-request";
167
+ return {
168
+ ...spec,
169
+ name: words.op ?? spec.name,
170
+ ...(words.gateName !== CHANT_WORDS.gateName ? { gateName: words.gateName } : {}),
171
+ waves: spec.waves.map((w): OpWave => (byPullRequest && w.approval === undefined ? { ...w, approval: "pull-request" } : w)),
172
+ ...(byPullRequest ? { approvals: { ...(spec.approvals ?? {}), pullRequest: { gate: words.prGate } } } : {}),
173
+ };
174
+ }
175
+
176
+ /**
177
+ * The product pipeline's jobs for `forge` (#4550): the plan side from the
178
+ * pull request loop with the words, and the apply on merge on op waves. The
179
+ * words are refused when a command names a job the pipeline does not have.
180
+ */
181
+ export function productPipelineJobs(forge: ForgeKind, env: string, options: ProductPipelineOptions): ProductPipelineJobs {
182
+ const jobs: CiProductCommand[] = ["plan"];
183
+ if (options.applyBeforeMerge || options.waves || options.componentWaves) jobs.push("apply");
184
+ if (options.locks === "plan") jobs.push("lock", "unlock");
185
+ if (options.agent) jobs.push("agent");
186
+ // #4601: the note's merge sentence follows the jobs built here: waves on merge, an apply before merge, else a record for a release.
187
+ // Words that ask for before-merge keep it when the pipeline has that job beside its waves.
188
+ const built: CiProductApplyMode = options.waves || options.componentWaves ? "on-merge" : options.applyBeforeMerge ? "before-merge" : "release";
189
+ const applyMode: CiProductApplyMode = options.words.applyMode === "before-merge" && options.applyBeforeMerge ? "before-merge" : built;
190
+ const words = assertProductWords({ ...options.words, applyMode }, { jobs });
191
+ const { waves: given, wavesSpecFile, member, agent: _agent, componentWaves, ...loop } = options;
192
+ const prLoop: PrLoopPipelineOptions = { ...loop, words, gate: options.gate ?? words.prGate };
193
+ const [plan, apply, record] = prLoopJobs(forge, env, prLoop, member);
194
+ const comments: Partial<Record<CiProductCommand, string>> = {};
195
+ for (const c of jobs) {
196
+ const line = commentLine(words, c);
197
+ if (line) comments[c] = line;
198
+ }
199
+ // #4619: the loop's control target, else the waves spec's.
200
+ const controlTarget = options.control?.target ?? (given?.control ? opWavesControlTarget(given.control) : undefined);
201
+ const out: ProductPipelineJobs = {
202
+ words,
203
+ plan: plan!,
204
+ post: { ...prLoopPostJob(forge, env, member, words), ...(controlTarget ? { control: controlNoteCheckout(forge, controlTarget, words) } : {}) },
205
+ comments,
206
+ ...(options.applyBeforeMerge ? { applyBeforeMerge: apply! } : {}),
207
+ };
208
+ const locks = prCommentLockJobs(forge, { locks: options.locks, words });
209
+ if (locks.length > 0) out.locks = locks;
210
+ const preview = prCommentPreviewJob(forge, env, prLoop, member);
211
+ if (preview) out.preview = preview;
212
+ // #4616: the agent answers its comment from a workflow of its own, generated from this spec.
213
+ const agentComment = options.agent ? comments.agent : undefined;
214
+ if (options.agent && agentComment) {
215
+ const spec = productAgentSpec(words, agentComment, options.agent === true ? {} : options.agent);
216
+ out.agent = { comment: agentComment, name: spec.name, spec };
217
+ }
218
+ // #4588: without a spec of the product's own, the component graph's waves on op waves.
219
+ const op = words.op ?? componentWaves?.waveGate ?? words.prGate;
220
+ const spec = given ?? (componentWaves
221
+ ? componentWavesSpec(componentWaves.components, words, componentWaveSteps({ ...(words.bin ? { bin: words.bin } : {}), env, base: componentWaves.base ?? "HEAD^1", ...(member ? { member } : {}), op, gate: prLoop.gate }), { ...(componentWaves.waveGate ? { gate: componentWaves.waveGate } : {}) })
222
+ : undefined);
223
+ if (!spec) return { ...out, record: record! };
224
+ const named = productWavesSpec(spec, words);
225
+ const specFile = wavesSpecFile ?? productWavesSpecFile(named.name);
226
+ return { ...out, waves: { spec: named, specFile, jobs: opWaveJobs(named, specFile, { bin: words.bin }) } };
227
+ }
228
+
229
+ /** The capability steps a component waves spec runs (#4545, #4541): argv templates over `{runs}` and `{plans}`. */
230
+ export interface ComponentWaveSteps {
231
+ /** Plan every run of a wave through the capability registry, writing `{plans}`. */
232
+ planWave: string[];
233
+ /** Apply a wave's approved set through the capability registry. */
234
+ applyWave: string[];
235
+ }
236
+
237
+ /** Where a component waves spec keeps the outputs each wave's components left, for the next wave's plans (#4588). */
238
+ export function componentWaveOutputsFile(op: string): string {
239
+ return `${PRODUCT_WAVES_SPEC_DIR}/${op}/outputs.json`;
240
+ }
241
+
242
+ /** What {@link componentWaveSteps} names on each step's line (#4588). */
243
+ export interface ComponentWaveStepOptions {
244
+ /** The command in place of `chant`, a product's `words.bin`. */
245
+ bin?: string;
246
+ env: string;
247
+ /** The commit the change is measured from: what `pr-apply` was given. */
248
+ base: string;
249
+ /** The commit applied. Absent: the job's checkout. */
250
+ head?: string;
251
+ /** The workspace member. */
252
+ member?: string;
253
+ /** The file the waves hand outputs on in. Default {@link componentWaveOutputsFile} of `op`. */
254
+ outputs?: string;
255
+ /** The op the outputs file is named by. */
256
+ op: string;
257
+ /** The pull request's gate, whose rows file the apply leases on the resource grain. */
258
+ gate?: string;
259
+ }
260
+
261
+ /**
262
+ * The component plan-wave and apply-wave steps (#4588): `chant components
263
+ * plan-wave` plans a wave's components through the project's capabilities
264
+ * and writes the op-waves plans file with the wave's change set, and
265
+ * `chant components apply-wave` plans the approved runs again, refuses any
266
+ * whose plan moved (exit 4), and applies the rest. Both read the outputs
267
+ * the waves before them left from the outputs file, and apply-wave adds its
268
+ * own.
269
+ */
270
+ export function componentWaveSteps(options: ComponentWaveStepOptions): ComponentWaveSteps {
271
+ const bin = opWaveBinArgv(options.bin);
272
+ const common = [
273
+ "--env", options.env, "--base", options.base,
274
+ ...(options.head ? ["--head", options.head] : []),
275
+ ...(options.member ? ["--member", options.member] : []),
276
+ ...(options.gate ? ["--gate", options.gate] : []),
277
+ "--wave-outputs", options.outputs ?? componentWaveOutputsFile(options.op),
278
+ ];
279
+ return {
280
+ planWave: [...bin, "components", "plan-wave", "--runs", "{runs}", "--plans", "{plans}", ...common],
281
+ applyWave: [...bin, "components", "apply-wave", "--runs", "{runs}", "--plans", "{plans}", ...common],
282
+ };
283
+ }
284
+
285
+ /** What {@link componentWavesSpec} takes beside the graph, the words and the steps. */
286
+ export interface ComponentWavesSpecOptions {
287
+ /** The wave gate's base name: wave k waits at `<gate>-wave-<k>` (or the words' `gateName`). Default the words' `prGate`. */
288
+ gate?: string;
289
+ branches?: string[];
290
+ /**
291
+ * The op the gates are recorded under. `pr-apply --wave-gate` passes the
292
+ * pull request's (`pr-<n>`), and then every wave takes the pull request's
293
+ * approval whatever the words' preset. Default the words' `op`.
294
+ */
295
+ op?: string;
296
+ /** The pull request's gate, whose approval a wave applies under when it covers the wave. Default the words' `prGate`. */
297
+ prGate?: string;
298
+ /** The layers, when the caller already has them (a derivation's `waves`). Default: layered from `dependsOn`. */
299
+ waves?: readonly (readonly string[])[];
300
+ }
301
+
302
+ /**
303
+ * A waves spec from the component graph (#4550, ruling A; #4588): a wave per
304
+ * layer of the graph, each run a component, planned and applied through the
305
+ * component plan-wave and apply-wave steps under the words' op and gate
306
+ * names. `pr-apply --wave-gate` runs its waves on it.
307
+ */
308
+ export function componentWavesSpec(
309
+ components: readonly Pick<DriverComponent, "name" | "dependsOn">[],
310
+ wordsIn: CiProductWordsInput | CiProductWords,
311
+ steps: ComponentWaveSteps,
312
+ options: ComponentWavesSpecOptions = {},
313
+ ): OpWavesSpec {
314
+ const words = assertProductWords(wordsIn);
315
+ const layers = options.waves ?? layerWaves(components.map((c) => ({ name: c.name, dependsOn: c.dependsOn ?? [] })));
316
+ const name = options.op ?? words.op ?? options.gate ?? words.prGate;
317
+ const spec: OpWavesSpec = {
318
+ name,
319
+ op: name,
320
+ gate: options.gate ?? words.prGate,
321
+ planWave: steps.planWave,
322
+ applyWave: steps.applyWave,
323
+ ...(options.branches ? { branches: options.branches } : {}),
324
+ waves: layers.map((layer, i) => ({ name: `wave-${i + 1}`, runs: layer.map((target) => ({ target })) })),
325
+ };
326
+ const named = productWavesSpec(spec, words);
327
+ if (options.op === undefined) return named;
328
+ // The pull request's own op: every wave applies under its approval when that covers the wave's plan, else at its own gate.
329
+ return {
330
+ ...named,
331
+ name: options.op,
332
+ op: options.op,
333
+ waves: named.waves.map((w) => ({ ...w, approval: "pull-request" as const })),
334
+ approvals: { ...(named.approvals ?? {}), pullRequest: { gate: options.prGate ?? words.prGate } },
335
+ };
336
+ }
337
+
338
+ /** A shell line with the product's bin in place of `chant`, for a product's own jobs beside these. */
339
+ export function productCommand(words: CiProductWords, line: string): string {
340
+ return withProductBin(line, words.bin);
341
+ }
@@ -61,6 +61,8 @@ import { planAndRunComponentGroup, runComponentGroup } from "./groups";
61
61
  import type { Release } from "../lifecycle/release-store";
62
62
  import type { RunProgressEvent } from "./run-progress";
63
63
  import type { RunEventSink } from "../run-event-stream";
64
+ import type { LockGrain } from "../lifecycle/lock-rows";
65
+ import type { RowLeasePort } from "./row-lease";
64
66
 
65
67
  /**
66
68
  * Step kinds that produce an artifact at build time: the build family, and the
@@ -651,6 +653,10 @@ export interface RunPromotionOptions {
651
653
  groupRuns?: readonly GroupRun[];
652
654
  /** A promote with no release gate to bind plans each group in its wave (#4465). */
653
655
  planGroupsAtWave?: boolean;
656
+ /** `ci.lockGrain` as declared (#4594), for every step's `DeployContext.lockGrain`. */
657
+ lockGrain?: LockGrain;
658
+ /** The run's row lease (#4594): a step or group on the resource grain leases its rows through it before it applies. Absent: no lease. */
659
+ rowLease?: RowLeasePort;
654
660
  }
655
661
 
656
662
  /** The run in `runs` that plans exactly the members of `group`. */
@@ -678,6 +684,8 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
678
684
  const item = plan.items.find((i) => i.component === component);
679
685
  return item ? { version: item.digest, revision: item.source.gitSha } : undefined;
680
686
  };
687
+ // #4594: the grain and the row lease reach every step and group.
688
+ const leasing = { ...(options.lockGrain ? { lockGrain: options.lockGrain } : {}), ...(options.rowLease ? { rowLease: options.rowLease } : {}) };
681
689
  // ws-107 (#4465): a group applies as one, through its approved plan.
682
690
  const grouped = options.grouped?.groups?.length ? options.grouped : undefined;
683
691
  const byName = new Map(targets.map((c) => [c.name, c]));
@@ -691,7 +699,7 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
691
699
  components: byName,
692
700
  registry,
693
701
  env: plan.to,
694
- ctxOf: (name: string) => deployContext({ env: plan.to, releaseIdentity }, name),
702
+ ctxOf: (name: string) => deployContext({ env: plan.to, releaseIdentity, ...leasing }, name),
695
703
  componentOutputs,
696
704
  };
697
705
  const approved = approvedRunOf(options.groupRuns, group);
@@ -708,6 +716,7 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
708
716
  releases: expected,
709
717
  // #3061: the workload's service.version and vcs.ref.head.revision are the earlier release's own.
710
718
  releaseIdentity,
719
+ ...leasing,
711
720
  ...(groups ? { groups } : {}),
712
721
  ...(options.onProgress ? { onProgress: options.onProgress } : {}),
713
722
  ...(options.onRunEvent ? { onRunEvent: options.onRunEvent } : {}),
@@ -24,6 +24,12 @@
24
24
  * build, as a chart named from a repository, is not recorded, and the
25
25
  * promote leaves it as written.
26
26
  *
27
+ * Since #4542 a step whose capability answers `releaseInputs` has its files
28
+ * recorded the same way: `terraform-apply` names a root by key, and the
29
+ * terraform lexicon answers the root's directory, its local modules and its
30
+ * var files ({@link stepReleaseInputs}). Each directory is named in `trees`.
31
+ * A step whose files can't be deployed from a copy is printed and left out.
32
+ *
27
33
  * A project with no components (#4046) is compiled the way `chant build --env
28
34
  * <env> -o <output>` builds it ({@link compileBuildOutput}): every file that
29
35
  * build writes is a template with `component: null`, and the target's params
@@ -43,7 +49,7 @@ import { applyConfigDefaults } from "./config-defaults";
43
49
  import { fanOutRegistry } from "./fan-out-support";
44
50
  import { ARCHIVE_STEP_KINDS, BUILD_STEP_KINDS, PUBLISH_STEP_KINDS } from "./promote";
45
51
  import { DriverRunFailure, runInterpretDriver, type DriverComponent, type DriverGate, type DriverPhase, type DriverStep } from "./driver";
46
- import type { CapabilityRegistry } from "./capability";
52
+ import type { CapabilityRegistry, ReleaseInputs, ReleaseInputsUnbound } from "./capability";
47
53
  import { memoryGateLedgerPort } from "../op/gate";
48
54
  import type { ReleaseArtifact, ReleaseParam } from "../lifecycle/release-store";
49
55
 
@@ -170,6 +176,51 @@ export function recordedInputRefs(component: DriverComponent): RecordedInputRef[
170
176
  return out;
171
177
  }
172
178
 
179
+ /** A step whose capability answered `releaseInputs` (#4542), with its answer. */
180
+ export interface StepReleaseInputs {
181
+ phase: string;
182
+ /** The step object as it sits in the composition, so a promote can find it again. */
183
+ step: DriverStep;
184
+ answer: ReleaseInputs | ReleaseInputsUnbound;
185
+ }
186
+
187
+ /**
188
+ * The steps of `component` whose capability answers `releaseInputs` (#4542),
189
+ * build and publish steps left out. Paths are normalised to `/`-separated
190
+ * and relative to `memberDir`; one that leaves it makes the step unbound,
191
+ * since its copy could not sit under the member's directory. A throw is an
192
+ * unbound answer naming the error.
193
+ */
194
+ export async function stepReleaseInputs(component: DriverComponent, registry: CapabilityRegistry, memberDir: string): Promise<StepReleaseInputs[]> {
195
+ const out: StepReleaseInputs[] = [];
196
+ for (const { phase, step } of stepsOf(component.deploy)) {
197
+ if (BUILD_STEP_KINDS.includes(step.kind) || PUBLISH_STEP_KINDS.includes(step.kind) || !registry.has(step.kind)) continue;
198
+ const capability = registry.resolve(step.kind);
199
+ if (!capability.releaseInputs) continue;
200
+ const { kind: _kind, ...input } = step;
201
+ let answer: ReleaseInputs | ReleaseInputsUnbound | null;
202
+ try {
203
+ answer = await capability.releaseInputs(input as never, { memberDir });
204
+ } catch (err) {
205
+ answer = { unbound: err instanceof Error ? err.message : String(err) };
206
+ }
207
+ if (answer === null) continue;
208
+ if ("unbound" in answer) {
209
+ out.push({ phase, step, answer });
210
+ continue;
211
+ }
212
+ const norm = (p: string): string => relative(memberDir, resolve(memberDir, p)).split("\\").join("/") || ".";
213
+ const paths = [...new Set(answer.paths.map(norm))].sort();
214
+ const outside = paths.find((p) => p === ".." || p.startsWith("../") || isAbsolute(p));
215
+ if (outside !== undefined) {
216
+ out.push({ phase, step, answer: { unbound: `it reads "${outside}", outside the member's directory, so a recorded copy can't keep its place` } });
217
+ continue;
218
+ }
219
+ out.push({ phase, step, answer: { field: answer.field, dir: norm(answer.dir), paths } });
220
+ }
221
+ return out;
222
+ }
223
+
173
224
  /** The fields of a step of `kind` whose paths a cut records and a promote points at the recorded copy. */
174
225
  export function recordedFields(kind: string): string[] {
175
226
  return [...TEMPLATE_FIELDS, ...(DEPLOY_INPUT_FIELDS[kind] ?? [])];
@@ -345,6 +396,41 @@ export async function compileEnvironment(inputs: CompileInputs, env: string): Pr
345
396
  trees.push({ component: ref.component, path: dir });
346
397
  }
347
398
  }
399
+ // #4542: the files a capability names for a step that names them indirectly, as a terraform root by key.
400
+ let registry: CapabilityRegistry | null | undefined;
401
+ for (const { component } of components) {
402
+ const candidates = stepsOf(component.deploy).some(({ step }) => !BUILD_STEP_KINDS.includes(step.kind) && !PUBLISH_STEP_KINDS.includes(step.kind));
403
+ if (!candidates) continue;
404
+ if (registry === undefined) {
405
+ registry = await fanOutRegistry(inputs.projectDir, config).catch((err: unknown) => {
406
+ console.error(`release compile: the capability plugins did not load, so no step's own files are recorded: ${err instanceof Error ? err.message : String(err)}`);
407
+ return null;
408
+ });
409
+ }
410
+ if (registry === null) break;
411
+ for (const { phase, step, answer } of await stepReleaseInputs(component, registry, inputs.projectDir)) {
412
+ if ("unbound" in answer) {
413
+ console.error(`release compile: component "${component.name}": its ${step.kind} step in phase "${phase}" is not recorded for "${env}": ${answer.unbound}`);
414
+ continue;
415
+ }
416
+ for (const path of answer.paths) {
417
+ const key = `${component.name}\u0000${path}`;
418
+ if (seen.has(key)) continue;
419
+ seen.add(key);
420
+ const file = resolve(inputs.projectDir, path);
421
+ if (!existsSync(file)) continue;
422
+ if (statSync(file).isFile()) {
423
+ templates.push(templateOf(component.name, path, file));
424
+ continue;
425
+ }
426
+ for (const f of directoryFiles(inputs.projectDir, path)) {
427
+ const under = relative(resolve(inputs.projectDir, path), resolve(inputs.projectDir, f)).split("\\").join("/");
428
+ templates.push(templateOf(component.name, path === "." ? under : `${path}/${under}`, resolve(inputs.projectDir, f)));
429
+ }
430
+ trees.push({ component: component.name, path });
431
+ }
432
+ }
433
+ }
348
434
  return {
349
435
  env,
350
436
  params,
@@ -21,12 +21,23 @@
21
21
  * chart named from a repository, is left as written. A target cut before
22
22
  * #4155 is pinned as it was then: template fields only, other paths read from
23
23
  * the checkout.
24
+ *
25
+ * A step whose capability answers `releaseInputs` (#4542), as `terraform-apply`
26
+ * does for its root, is pointed at the component's recorded files as one
27
+ * layout: every file the target records for the component is written under
28
+ * `.chant/release-templates/<digest>/` at its path from the member's
29
+ * directory, so a root's `../modules/x` still resolves, and the step's field
30
+ * names the copy of the directory it runs in. The step then plans the
31
+ * release's files against the environment, and the release gate binds that
32
+ * plan. A step whose directory the release does not record is left as
33
+ * written.
24
34
  */
25
35
 
26
36
  import { mkdirSync, readdirSync, rmSync, rmdirSync, writeFileSync } from "node:fs";
27
37
  import { basename, dirname, join } from "node:path";
28
38
  import type { DriverComponent, DriverGate, DriverPhase, DriverStep } from "./driver";
29
- import { recordedFields, recordedInputRefs, TEMPLATE_FIELDS, templateRefs, type RecordedInputRef } from "./release-compile";
39
+ import { recordedFields, recordedInputRefs, stepReleaseInputs, TEMPLATE_FIELDS, templateRefs, type RecordedInputRef } from "./release-compile";
40
+ import type { CapabilityRegistry } from "./capability";
30
41
  import { templateBytesDigest, type Release, type ReleaseTarget } from "../lifecycle/release-store";
31
42
  import { computePlanDigest } from "../lifecycle/plan-digest";
32
43
  import type { ReleaseRecord } from "../lifecycle/release-ledger";
@@ -96,6 +107,7 @@ export async function pinReleaseTemplates(
96
107
  release: Release,
97
108
  target: ReleaseTarget,
98
109
  readTemplate: TemplateReader,
110
+ layout?: { registry: CapabilityRegistry; memberDir: string },
99
111
  ): Promise<{ components: DriverComponent[]; files: PinnedTemplate[] } | { errors: string[] }> {
100
112
  const errors: string[] = [];
101
113
  const files: PinnedTemplate[] = [];
@@ -104,6 +116,26 @@ export async function pinReleaseTemplates(
104
116
  const full = target.trees !== undefined;
105
117
  for (const component of components) {
106
118
  const replace = new Map<string, string>();
119
+ // #4542: steps whose capability names their files, pointed at the component's recorded layout.
120
+ const stepPins = new Map<DriverStep, { field: string; value: string }>();
121
+ if (full && layout) {
122
+ let base: string | null | undefined;
123
+ for (const { step, answer } of await stepReleaseInputs(component, layout.registry, layout.memberDir)) {
124
+ if ("unbound" in answer) continue;
125
+ if (!target.trees!.some((t) => t.component === component.name && t.path === answer.dir)) continue;
126
+ if (base === undefined) {
127
+ const pinned = await pinLayout(component.name, target, readTemplate);
128
+ if ("errors" in pinned) {
129
+ errors.push(...pinned.errors);
130
+ base = null;
131
+ } else {
132
+ files.push(...pinned.files);
133
+ base = pinned.base;
134
+ }
135
+ }
136
+ if (base !== null) stepPins.set(step, { field: answer.field, value: answer.dir === "." ? base : join(base, answer.dir) });
137
+ }
138
+ }
107
139
  const refs: RecordedInputRef[] = full ? recordedInputRefs(component) : templateRefs(component).map((r) => ({ ...r, required: true }));
108
140
  for (const ref of refs) {
109
141
  if (replace.has(ref.value)) continue;
@@ -142,6 +174,8 @@ export async function pinReleaseTemplates(
142
174
  if (isPhase(step)) return rewrite(step);
143
175
  if (isGate(step)) return step;
144
176
  const next: DriverStep = { ...step };
177
+ const pin = stepPins.get(step);
178
+ if (pin) next[pin.field] = pin.value;
145
179
  for (const field of full ? recordedFields(step.kind) : TEMPLATE_FIELDS) {
146
180
  const v = next[field];
147
181
  if (typeof v === "string" && replace.has(v)) next[field] = replace.get(v);
@@ -200,6 +234,36 @@ async function pinTree(
200
234
  return { path, files: read.map((r) => ({ path: join(path, r.rel), content: r.content, ...(r.encoding ? { encoding: r.encoding } : {}) })) };
201
235
  }
202
236
 
237
+ /**
238
+ * Every file the target records for `component`, under
239
+ * `.chant/release-templates/<digest>/` at its path from the member's
240
+ * directory (#4542). The digest is a plan digest over the paths and their
241
+ * digests, so the base names the layout and a gate approval bound to a plan
242
+ * of it still matches on a re-run.
243
+ */
244
+ async function pinLayout(
245
+ component: string,
246
+ target: ReleaseTarget,
247
+ readTemplate: TemplateReader,
248
+ ): Promise<{ base: string; files: PinnedTemplate[] } | { errors: string[] }> {
249
+ const errors: string[] = [];
250
+ const read: Array<{ path: string; content: string; encoding?: "base64"; digest: string }> = [];
251
+ for (const e of target.templates.filter((t) => t.component === component)) {
252
+ if (e.path.startsWith("/") || e.path.split("/").includes("..")) {
253
+ errors.push(`component "${component}": "${e.path}" is not a path inside the member's directory; refusing to write it`);
254
+ continue;
255
+ }
256
+ const got = await readChecked(component, e.path, e, target, readTemplate);
257
+ if ("error" in got) errors.push(got.error);
258
+ else read.push({ path: e.path, content: got.content, digest: e.digest, ...(e.encoding ? { encoding: e.encoding } : {}) });
259
+ }
260
+ if (errors.length > 0) return { errors };
261
+ read.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
262
+ const digest = computePlanDigest("release-layout", read.map(({ path, digest }) => ({ path, digest })));
263
+ const base = join(RELEASE_TEMPLATES_DIR, digest.replace(/:/g, "_"));
264
+ return { base, files: read.map((r) => ({ path: join(base, r.path), content: r.content, ...(r.encoding ? { encoding: r.encoding } : {}) })) };
265
+ }
266
+
203
267
  /**
204
268
  * The files a release's target records, read back by digest and checked, for
205
269
  * `chant release export` (#4046). A project with no components has no deploy
@@ -0,0 +1,52 @@
1
+ /**
2
+ * The `repo` lock grain in a generated pipeline (#4552): one apply at a time
3
+ * in the repository. GitHub runs the apply jobs in one concurrency group,
4
+ * GitLab in one resource group, and Forgejo, whose runner does not queue on
5
+ * a concurrency group, through a lock tag on the remote,
6
+ * `refs/tags/chant-apply-lock`, the way terragucci's Forgejo pipelines do
7
+ * (`forgejoLock` in terragucci's `render.ts` at 18f6431).
8
+ *
9
+ * The tag points at an empty commit whose subject is the holder's lease,
10
+ * `run <id> <epoch>`. A runner that kills a job never runs its exit trap, so
11
+ * a waiter takes the lock over, with a lease push, when `chant lock --alive`
12
+ * says the holder's run is gone or its lease is older than
13
+ * `CHANT_LOCK_STALE` seconds (default 7200; `TG_LOCK_STALE` is read as an
14
+ * alias). The step's exit trap lets go of the tag.
15
+ */
16
+
17
+ /** The concurrency or resource group every apply job of a pipeline on the repo grain shares. */
18
+ export const REPO_APPLY_GROUP = "chant-apply-repo";
19
+
20
+ /** The tag Forgejo applies on the repo grain hold. */
21
+ export const REPO_LOCK_REF = "refs/tags/chant-apply-lock";
22
+
23
+ /**
24
+ * The shell lines that take the repo lock tag before an apply on Forgejo,
25
+ * and let go of it when the step's shell exits. They run in the apply
26
+ * command's own step, before it, so the trap fires when the apply ends.
27
+ * Waits up to an hour, polling every `CHANT_LOCK_POLL` seconds (default 10).
28
+ */
29
+ export function forgejoRepoLockLines(): string[] {
30
+ const id = "${GITHUB_RUN_ID:-$$}";
31
+ return [
32
+ `lock_ref="${REPO_LOCK_REF}"`,
33
+ 'empty="$(git mktree </dev/null)"',
34
+ `mine="$(GIT_AUTHOR_NAME=chant GIT_AUTHOR_EMAIL=chant@localhost GIT_COMMITTER_NAME=chant GIT_COMMITTER_EMAIL=chant@localhost git commit-tree "$empty" -m "run ${id} $(date +%s)")"`,
35
+ 'stale="${CHANT_LOCK_STALE:-${TG_LOCK_STALE:-7200}}"',
36
+ "tries=0",
37
+ 'until git push -q origin "$mine:$lock_ref" 2>/dev/null; do',
38
+ ' held="$(git ls-remote origin "$lock_ref" | cut -f1)"',
39
+ ' if [ -n "$held" ] && git fetch -q origin "+$lock_ref:$lock_ref" 2>/dev/null; then',
40
+ ' lease="$(git log -1 --format=%s "$lock_ref")"',
41
+ ' holder="$(echo "$lease" | cut -d" " -f2)"; since="$(echo "$lease" | cut -d" " -f3)"',
42
+ ' if [ "$(chant lock --alive "$holder" 2>/dev/null)" = dead ] || [ $(( $(date +%s) - ${since:-0} )) -ge "$stale" ]; then',
43
+ ' echo "the apply lock was held by run $holder, which is gone; taking it over"',
44
+ ' git push -q --force-with-lease="$lock_ref:$held" origin "+$mine:$lock_ref" 2>/dev/null && break',
45
+ " fi",
46
+ " fi",
47
+ ' if [ "$tries" -ge 360 ]; then echo "another apply has held $lock_ref for an hour" >&2; exit 1; fi',
48
+ ' sleep "${CHANT_LOCK_POLL:-10}"; tries=$((tries + 1))',
49
+ "done",
50
+ "trap 'git push -q --force-with-lease=\"$lock_ref:$mine\" origin \":$lock_ref\" || true' EXIT",
51
+ ];
52
+ }