@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,19 @@
1
+ import { describe, expect, test } from "vitest";
2
+ import { capabilityPolicyOf, isPolicyDeniedError } from "./wave-plan";
3
+
4
+ // chant#4541's pulumi-up marks a CrossGuard denial `policyDenied` and puts its
5
+ // findings, and advisory ones on the plan's artifact, in the gate-policy shape.
6
+ describe("a capability's policy findings (#4550)", () => {
7
+ test("reads the policyDenied mark and its findings", () => {
8
+ const err = Object.assign(new Error("denied"), { policyDenied: true as const, member: "shop/dev", findings: { denials: [{ rule: "crossguard.p.r", message: "no" }], holds: [], warnings: [] } });
9
+ expect(isPolicyDeniedError(err)).toBe(true);
10
+ expect(isPolicyDeniedError(new Error("x"))).toBe(false);
11
+ expect(capabilityPolicyOf("shop/dev", err.findings, true)).toEqual({ member: "shop/dev", denied: true, denials: [{ rule: "crossguard.p.r", message: "no" }], holds: [], warnings: [] });
12
+ });
13
+
14
+ test("advisory findings on an artifact come back; none is undefined", () => {
15
+ expect(capabilityPolicyOf("m", { denials: [], holds: [{ rule: "r", message: "advise" }], warnings: [] }, false)?.holds).toEqual([{ rule: "r", message: "advise" }]);
16
+ expect(capabilityPolicyOf("m", { denials: [], holds: [], warnings: [] }, false)).toBeUndefined();
17
+ expect(capabilityPolicyOf("m", undefined, false)).toBeUndefined();
18
+ });
19
+ });
@@ -27,6 +27,7 @@
27
27
  * `@<component>.publish.*`) resolves.
28
28
  */
29
29
 
30
+ import { resolvePlannedLock, type PlannedLock } from "../lifecycle/lock-rows";
30
31
  import type { PlanShape } from "./covered-round";
31
32
  import { assertTargetsAccepted, resolveStepInput, unresolvedWiringSources, type DriverComponent, type DriverPhase, type DriverStep } from "./driver";
32
33
  import { componentPlanDigest } from "./gate-plan";
@@ -45,8 +46,56 @@ import type { ChangeSetPart } from "../change-set";
45
46
  * merges a run's outputs; absent when no step's plan says.
46
47
  */
47
48
  export type WaveComponentPlan =
48
- | { component: string; members: WaveMember[]; plans: Record<string, unknown>; parts: ChangeSetPart[]; outputs?: PlannedOutputs; shapes?: Record<string, PlanShape> }
49
- | { component: string; error: string };
49
+ | {
50
+ component: string;
51
+ members: WaveMember[];
52
+ plans: Record<string, unknown>;
53
+ parts: ChangeSetPart[];
54
+ outputs?: PlannedOutputs;
55
+ shapes?: Record<string, PlanShape>;
56
+ policy?: CapabilityPolicyFindings[];
57
+ /** Each planned member's lock grain and rows (#4552), by member. Absent when no step planned. */
58
+ locks?: Record<string, PlannedLock>;
59
+ /** Each planned member's location in a pull request's environment (#4609), by member. Absent when no step gave one. */
60
+ locations?: Record<string, string>;
61
+ }
62
+ | { component: string; error: string; policy?: CapabilityPolicyFindings[] };
63
+
64
+ /** A policy engine's findings a capability's plan carried for one member (#4550): `denied` when the plan threw `policyDenied`. */
65
+ export interface CapabilityPolicyFindings {
66
+ member: string;
67
+ denied: boolean;
68
+ denials: Array<{ rule: string; message: string }>;
69
+ holds: Array<{ rule: string; message: string }>;
70
+ warnings: string[];
71
+ }
72
+
73
+ const findingList = (v: unknown): Array<{ rule: string; message: string }> =>
74
+ Array.isArray(v) ? v.filter((f): f is { rule: string; message: string } => typeof f?.rule === "string" && typeof f?.message === "string").map((f) => ({ rule: f.rule, message: f.message })) : [];
75
+
76
+ /**
77
+ * The findings a capability's plan or its policy error carries (#4550), in
78
+ * the gate-policy shape (`{ denials, holds, warnings }`) that chant#4541's
79
+ * `pulumi-up` puts on its artifact as `policy` and on a
80
+ * `PulumiPolicyDeniedError` as `findings`. Undefined when there are none.
81
+ */
82
+ export function capabilityPolicyOf(member: string, findings: unknown, denied: boolean): CapabilityPolicyFindings | undefined {
83
+ if (findings === null || typeof findings !== "object") return denied ? { member, denied, denials: [], holds: [], warnings: [] } : undefined;
84
+ const f = findings as { denials?: unknown; holds?: unknown; warnings?: unknown };
85
+ const out = {
86
+ member,
87
+ denied,
88
+ denials: findingList(f.denials),
89
+ holds: findingList(f.holds),
90
+ warnings: Array.isArray(f.warnings) ? f.warnings.filter((w): w is string => typeof w === "string") : [],
91
+ };
92
+ return denied || out.denials.length + out.holds.length + out.warnings.length > 0 ? out : undefined;
93
+ }
94
+
95
+ /** Whether `err` is a capability's policy denial (#4550): the `policyDenied: true` mark, as `planMoved` marks a moved plan. */
96
+ export function isPolicyDeniedError(err: unknown): err is { policyDenied: true; member?: unknown; findings?: unknown } {
97
+ return typeof err === "object" && err !== null && (err as { policyDenied?: unknown }).policyDenied === true;
98
+ }
50
99
 
51
100
  /** A part with no entries, for a member whose planner describes no changes. `unbound` steps become its holes (#4155). */
52
101
  function emptyPart(member: WaveMember, unbound: ComponentDeployInputs["unbound"] = []): ChangeSetPart {
@@ -103,6 +152,9 @@ export async function planWaveComponent(
103
152
  const parts: ChangeSetPart[] = [];
104
153
  let outputs: PlannedOutputs | undefined;
105
154
  const shapes: Record<string, PlanShape> = {};
155
+ const policy: CapabilityPolicyFindings[] = [];
156
+ const locks: Record<string, PlannedLock> = {};
157
+ const locations: Record<string, string> = {};
106
158
  assertTargetsAccepted(component, registry, ctx);
107
159
  for (const step of capabilitySteps(component.deploy)) {
108
160
  const capability = registry.resolve(step.kind);
@@ -114,8 +166,15 @@ export async function planWaveComponent(
114
166
  members.push(member);
115
167
  parts.push(planned.changeSet ?? emptyPart(member));
116
168
  if (planned.artifact !== undefined) plans[planned.member] = planned.artifact;
169
+ // #4550: advisory findings the plan carried (pulumi-up's CrossGuard), for the note.
170
+ const found = capabilityPolicyOf(planned.member, (planned.artifact as { policy?: unknown } | undefined)?.policy, false);
171
+ if (found) policy.push(found);
117
172
  if (planned.shape) shapes[planned.member] = { ...planned.shape, member: planned.member };
118
173
  if (planned.outputs) outputs = mergePlannedOutputs(outputs, planned.outputs);
174
+ // #4609: where the member's copy lives in a pull request's environment (a review stack).
175
+ if (typeof planned.location === "string" && planned.location !== "") locations[planned.member] = planned.location;
176
+ // #4552: the member's grain (declared at base, else its lexicon's) and, on the resource grain, its rows.
177
+ locks[planned.member] = await resolvePlannedLock(capability, input, planned, ctx.lockGrain);
119
178
  }
120
179
  // #4155: the steps without a plan, which no member above covers.
121
180
  const planless = (step: DriverStep): boolean => !registry.has(step.kind) || registry.resolve(step.kind).plan === undefined;
@@ -144,9 +203,24 @@ export async function planWaveComponent(
144
203
  parts.push(emptyPart(member, read.unbound));
145
204
  }
146
205
  }
147
- return { component: component.name, members, plans, parts, ...(outputs ? { outputs } : {}), ...(Object.keys(shapes).length > 0 ? { shapes } : {}) };
206
+ return {
207
+ component: component.name,
208
+ members,
209
+ plans,
210
+ parts,
211
+ ...(outputs ? { outputs } : {}),
212
+ ...(Object.keys(shapes).length > 0 ? { shapes } : {}),
213
+ ...(policy.length > 0 ? { policy } : {}),
214
+ ...(Object.keys(locks).length > 0 ? { locks } : {}),
215
+ ...(Object.keys(locations).length > 0 ? { locations } : {}),
216
+ };
148
217
  } catch (err) {
149
- return { component: component.name, error: err instanceof Error ? err.message : String(err) };
218
+ const message = err instanceof Error ? err.message : String(err);
219
+ if (isPolicyDeniedError(err)) {
220
+ const denied = capabilityPolicyOf(typeof err.member === "string" ? err.member : component.name, err.findings, true)!;
221
+ return { component: component.name, error: message, policy: [denied] };
222
+ }
223
+ return { component: component.name, error: message };
150
224
  }
151
225
  }
152
226
 
@@ -0,0 +1,15 @@
1
+ [
2
+ {
3
+ "component": "vpc",
4
+ "version": "1.2.0",
5
+ "consumers": [
6
+ { "root": "units/network", "file": "units/network/terragrunt.hcl", "address": "terragrunt.terraform" },
7
+ { "root": "live/prod", "file": "live/prod/main.tf", "address": "module.vpc" }
8
+ ]
9
+ },
10
+ {
11
+ "component": "cache",
12
+ "digest": "sha256:1111111111111111111111111111111111111111111111111111111111111111",
13
+ "consumers": [{ "root": "services/api", "file": "services/api/cache.tf", "address": "module.cache" }]
14
+ }
15
+ ]
@@ -0,0 +1,23 @@
1
+ {
2
+ "contract": 1,
3
+ "consumers": [
4
+ {
5
+ "component": "vpc",
6
+ "version": "1.2.0",
7
+ "consumers": [
8
+ { "root": "live/prod", "file": "live/prod/main.tf", "address": "module.vpc" },
9
+ { "root": "live/dev", "file": "live/dev/main.tf", "address": "module.vpc" }
10
+ ]
11
+ },
12
+ {
13
+ "component": "vpc",
14
+ "version": "1.1.0",
15
+ "consumers": [{ "root": "live/legacy", "file": "live/legacy/main.tf", "address": "module.vpc" }]
16
+ },
17
+ {
18
+ "component": "eks",
19
+ "version": "3.0.0",
20
+ "consumers": [{ "root": "live/prod", "file": "live/prod/eks.tf", "address": "module.eks" }]
21
+ }
22
+ ]
23
+ }
@@ -0,0 +1,148 @@
1
+ /**
2
+ * The apply outcome a dispatch carries and the control repo's record of it
3
+ * (#4617). Written for the ci-products session; run at epic-ready.
4
+ */
5
+
6
+ import { describe, expect, test } from "vitest";
7
+ import type { WaveMemberOutcome } from "../wave-blocked";
8
+ import {
9
+ applyOutcomeOf,
10
+ controlAppliedProblems,
11
+ latestControlApplies,
12
+ parseControlApplied,
13
+ recordControlApplied,
14
+ recordControlAppliedFromEnv,
15
+ type ControlAppliedRecord,
16
+ } from "./applied";
17
+ import type { ControlLedgerPort } from "./records";
18
+ import { controlDependentsScript, controlDispatchRequest, controlDispatchScript, controlPipelineSpec, resolveControlTarget } from "./dispatch";
19
+
20
+ const SHA = "0123456789abcdef0123456789abcdef01234567";
21
+
22
+ const outcomes = (o: Record<string, WaveMemberOutcome>) => new Map(Object.entries(o));
23
+
24
+ function memoryLedger(): ControlLedgerPort & { lines: string[] } {
25
+ const lines: string[] = [];
26
+ return {
27
+ lines,
28
+ async read() {
29
+ return lines.length > 0 ? lines.join("\n") + "\n" : null;
30
+ },
31
+ async append(line) {
32
+ lines.push(line);
33
+ return `commit-${lines.length}`;
34
+ },
35
+ };
36
+ }
37
+
38
+ describe("the waves' outcome (#4617)", () => {
39
+ test("every run applied or had nothing to apply: applied", () => {
40
+ expect(applyOutcomeOf(outcomes({ a: { status: "applied" }, b: { status: "unchanged" } }))).toEqual({ outcome: "applied", applied: ["a"], counts: { applied: 1, unchanged: 1 } });
41
+ });
42
+
43
+ test("some applied and some failed or were blocked: partial", () => {
44
+ const s = applyOutcomeOf(outcomes({ net: { status: "applied" }, db: { status: "failed" }, app: { status: "blocked", by: "db" } }));
45
+ expect(s.outcome).toBe("partial");
46
+ expect(s.applied).toEqual(["net"]);
47
+ });
48
+
49
+ test("nothing to apply anywhere: unchanged", () => {
50
+ expect(applyOutcomeOf(outcomes({ a: { status: "unchanged" } })).outcome).toBe("unchanged");
51
+ });
52
+
53
+ test("nothing applied and a wave waits, with runs blocked behind it: waiting", () => {
54
+ expect(applyOutcomeOf(outcomes({ a: { status: "unchanged" }, b: { status: "waiting" }, c: { status: "blocked", by: "b" } })).outcome).toBe("waiting");
55
+ });
56
+
57
+ test("nothing applied and a run failed, or no wave wrote an outcome: failed", () => {
58
+ expect(applyOutcomeOf(outcomes({ a: { status: "failed" } })).outcome).toBe("failed");
59
+ expect(applyOutcomeOf(outcomes({ a: { status: "refused" } })).outcome).toBe("failed");
60
+ expect(applyOutcomeOf(new Map()).outcome).toBe("failed");
61
+ });
62
+ });
63
+
64
+ describe("the dispatch carries the outcome (#4617)", () => {
65
+ test("in GitHub's client_payload, Forgejo's inputs and GitLab's trigger variables", () => {
66
+ const d = { member: "network", op: "deploy", sha: SHA, outcome: "partial" as const };
67
+ const gh = controlDispatchRequest(resolveControlTarget({ repo: "github.com/acme/control", op: "deploy" }, "network"), d);
68
+ expect(gh.body).toEqual({ json: { event_type: "chant-applied", client_payload: { member: "network", op: "deploy", sha: SHA, outcome: "partial" } } });
69
+ const fj = controlDispatchRequest(resolveControlTarget({ repo: "codeberg.org/acme/control", op: "deploy" }, "network"), d);
70
+ expect(fj.body).toEqual({ json: { ref: "main", inputs: { member: "network", op: "deploy", sha: SHA, outcome: "partial" } } });
71
+ const gl = controlDispatchRequest(resolveControlTarget({ repo: "gitlab.com/acme/control", op: "deploy" }, "network"), d);
72
+ expect("form" in gl.body && gl.body.form).toContainEqual(["variables[CHANT_CONTROL_OUTCOME]", "partial"]);
73
+ });
74
+
75
+ test("the pull request loop's dispatch, with no outcome, is unchanged", () => {
76
+ const gh = controlDispatchRequest(resolveControlTarget({ repo: "github.com/acme/control", op: "deploy" }, "network"), { member: "network", op: "deploy", sha: SHA });
77
+ expect(gh.body).toEqual({ json: { event_type: "chant-applied", client_payload: { member: "network", op: "deploy", sha: SHA } } });
78
+ });
79
+
80
+ test("an outcome chant does not know is refused", () => {
81
+ expect(() =>
82
+ controlDispatchRequest(resolveControlTarget({ repo: "github.com/acme/control", op: "deploy" }, "network"), { member: "network", op: "deploy", sha: SHA, outcome: "maybe" as never }),
83
+ ).toThrow(/outcome "maybe"/);
84
+ });
85
+
86
+ test("the script reads the outcome from CHANT_CONTROL_OUTCOME, checks it, and keeps the token on stdin", () => {
87
+ const target = resolveControlTarget({ repo: "github.com/acme/control", op: "deploy" }, "network");
88
+ const script = controlDispatchScript(target, { outcome: true });
89
+ expect(script).toContain('outcome="${CHANT_CONTROL_OUTCOME:-}"');
90
+ expect(script).toContain('case "$outcome" in applied|partial|unchanged|waiting|failed) ;;');
91
+ expect(script).toContain(`"outcome":"'"$outcome"'"`);
92
+ expect(script).toContain("-H @-");
93
+ expect(script).not.toContain("$CHANT_CONTROL_TOKEN -");
94
+ expect(controlDispatchScript(target)).not.toContain("CHANT_CONTROL_OUTCOME");
95
+ const gitlab = controlDispatchScript(resolveControlTarget({ repo: "gitlab.com/acme/control", op: "deploy" }, "network"), { outcome: true });
96
+ expect(gitlab).toContain('--form "variables[CHANT_CONTROL_OUTCOME]=$outcome"');
97
+ expect(gitlab).toContain("--form 'token=<-'");
98
+ });
99
+ });
100
+
101
+ describe("the control repo's side (#4617)", () => {
102
+ test("the step records a dispatch that carries an outcome, and runs dependents only when something applied", () => {
103
+ const script = controlDependentsScript({ label: "plywood" });
104
+ expect(script).toContain('outcome="${CHANT_CONTROL_OUTCOME:-}"');
105
+ expect(script).toContain("recordControlAppliedFromEnv");
106
+ expect(script).toContain('case "$outcome" in ""|applied|partial) ;;');
107
+ expect(script.indexOf("recordControlAppliedFromEnv")).toBeLessThan(script.indexOf("workspace run --dependents-of"));
108
+ expect(script).toMatch(/node --input-type=module -e '[^']*'/);
109
+ });
110
+
111
+ test("the GitHub and Forgejo workflow takes the outcome from the payload or the manual input", () => {
112
+ const spec = controlPipelineSpec("forgejo", { product: "plywood" });
113
+ expect(spec.inputs.outcome).toMatchObject({ required: false, type: "string" });
114
+ expect(spec.env.CHANT_CONTROL_OUTCOME).toBe("${{ github.event.client_payload.outcome || inputs.outcome }}");
115
+ expect(controlPipelineSpec("gitlab").env).toEqual({});
116
+ });
117
+ });
118
+
119
+ describe("the apply records (#4617)", () => {
120
+ const at = (iso: string) => () => new Date(iso);
121
+
122
+ test("a record's digest covers every field, and a tampered line is left out", async () => {
123
+ const port = memoryLedger();
124
+ const { record } = await recordControlApplied(port, { member: "network", op: "deploy", sha: SHA, outcome: "applied" }, { now: at("2026-10-27T10:00:00.000Z") });
125
+ expect(controlAppliedProblems(record)).toEqual([]);
126
+ const tampered = { ...record, outcome: "failed" } as ControlAppliedRecord;
127
+ expect(controlAppliedProblems(tampered)).toContain("digest does not match the record");
128
+ const { records, malformed } = parseControlApplied(`${port.lines[0]}\n${JSON.stringify(tampered)}\nnot json\n`);
129
+ expect(records).toHaveLength(1);
130
+ expect(malformed).toBe(2);
131
+ });
132
+
133
+ test("each member's newest apply that applied something", async () => {
134
+ const port = memoryLedger();
135
+ await recordControlApplied(port, { member: "network", op: "deploy", sha: SHA, outcome: "applied" }, { now: at("2026-10-27T10:00:00.000Z") });
136
+ await recordControlApplied(port, { member: "network", op: "deploy", sha: SHA, outcome: "failed" }, { now: at("2026-10-27T11:00:00.000Z") });
137
+ await recordControlApplied(port, { member: "dns", op: "deploy", sha: SHA, outcome: "unchanged" }, { now: at("2026-10-27T12:00:00.000Z") });
138
+ const latest = latestControlApplies(parseControlApplied(await port.read()).records);
139
+ expect([...latest.keys()]).toEqual(["network"]);
140
+ expect(latest.get("network")!.at).toBe("2026-10-27T10:00:00.000Z");
141
+ });
142
+
143
+ test("the control repo's call records nothing for a dispatch with no outcome or no sha", async () => {
144
+ expect(await recordControlAppliedFromEnv({ env: { CHANT_CONTROL_MEMBER: "network", CHANT_CONTROL_OP: "deploy", CHANT_CONTROL_SHA: SHA } })).toEqual({ skipped: "the dispatch carries no outcome" });
145
+ expect((await recordControlAppliedFromEnv({ env: { CHANT_CONTROL_OUTCOME: "applied", CHANT_CONTROL_SHA: "" } })).skipped).toMatch(/no commit sha/);
146
+ expect((await recordControlAppliedFromEnv({ env: { CHANT_CONTROL_OUTCOME: "sideways", CHANT_CONTROL_SHA: SHA } })).skipped).toMatch(/not one chant knows/);
147
+ });
148
+ });
@@ -0,0 +1,191 @@
1
+ /**
2
+ * The apply outcome a member's dispatch carries, and the control repo's
3
+ * record of it (#4617).
4
+ *
5
+ * A member that applies through op waves tells the control repo once the
6
+ * last wave ran, whatever the waves did: the dispatch carries the outcome
7
+ * the wave jobs' outcome files add up to ({@link applyOutcomeOf}). The
8
+ * control repo's pipeline appends one `control-applied` line per dispatch to
9
+ * `_control/applied.jsonl` on its `chant/lifecycle`, beside the entries
10
+ * (./records.ts), and runs the member's dependents only when something
11
+ * applied. A pull request note reads the newest apply of each member from
12
+ * there to mark a cross-stack edge stale or current (./edges.ts).
13
+ *
14
+ * This module imports `node:crypto` and the outcome rule alone; the git
15
+ * port loads on first use, so a product bundle can carry it.
16
+ */
17
+
18
+ import { createHash } from "node:crypto";
19
+ import { passesThrough, type WaveMemberOutcome } from "../wave-blocked";
20
+ import { CONTROL_LEDGER_DIR, type ControlLedgerPort } from "./records";
21
+ import { CONTROL_APPLY_OUTCOMES, CONTROL_OUTCOME_VAR, CONTROL_RUNS_DEPENDENTS, type ControlApplyOutcome } from "./dispatch";
22
+
23
+ export { CONTROL_APPLY_OUTCOMES, CONTROL_OUTCOME_VAR, CONTROL_RUNS_DEPENDENTS, type ControlApplyOutcome };
24
+
25
+ /** The outcome, and the counts behind it. */
26
+ export interface ApplyOutcomeSummary {
27
+ outcome: ControlApplyOutcome;
28
+ /** The runs that applied, sorted. */
29
+ applied: string[];
30
+ /** Each status with how many runs ended in it. */
31
+ counts: Record<string, number>;
32
+ }
33
+
34
+ /** The outcome of a set of runs, from each one's newest outcome (`earlierWaveOutcomes` over every wave). */
35
+ export function applyOutcomeOf(members: ReadonlyMap<string, WaveMemberOutcome>): ApplyOutcomeSummary {
36
+ const counts: Record<string, number> = {};
37
+ const applied: string[] = [];
38
+ let through = 0;
39
+ let waiting = false;
40
+ for (const [name, o] of members) {
41
+ counts[o.status] = (counts[o.status] ?? 0) + 1;
42
+ if (o.status === "applied") applied.push(name);
43
+ if (passesThrough(o)) through++;
44
+ if (o.status === "waiting" || (o.status === "blocked" && o.by !== undefined && members.get(o.by)?.status === "waiting")) waiting = true;
45
+ }
46
+ applied.sort();
47
+ const all = members.size;
48
+ let outcome: ControlApplyOutcome;
49
+ if (all === 0) outcome = "failed";
50
+ else if (applied.length > 0) outcome = through === all ? "applied" : "partial";
51
+ else if (through === all) outcome = "unchanged";
52
+ else outcome = waiting ? "waiting" : "failed";
53
+ return { outcome, applied, counts };
54
+ }
55
+
56
+ /** The file the apply records are kept in, beside the entries. */
57
+ export const CONTROL_APPLIED_FILE = "applied.jsonl";
58
+ export const CONTROL_APPLIED_KIND = "control-applied";
59
+
60
+ /** One line of `_control/applied.jsonl`: one dispatch the control repo took. */
61
+ export interface ControlAppliedRecord {
62
+ version: 1;
63
+ kind: typeof CONTROL_APPLIED_KIND;
64
+ /** The member's name in the control repo's workspace. */
65
+ member: string;
66
+ op: string;
67
+ /** The member's commit the waves ran at. */
68
+ sha: string;
69
+ outcome: ControlApplyOutcome;
70
+ /** When the control repo took the dispatch, ISO 8601. */
71
+ at: string;
72
+ /** sha256 over the canonical JSON of every other field. */
73
+ digest: string;
74
+ }
75
+
76
+ const NAME = /^[A-Za-z0-9][A-Za-z0-9._/-]{0,127}$/;
77
+ const SHA = /^[0-9a-f]{7,64}$/;
78
+
79
+ function digestOf(fields: Omit<ControlAppliedRecord, "digest">): string {
80
+ const keys = Object.keys(fields).sort() as Array<keyof typeof fields>;
81
+ return `sha256:${createHash("sha256").update(JSON.stringify(Object.fromEntries(keys.map((k) => [k, fields[k]])))).digest("hex")}`;
82
+ }
83
+
84
+ /** The problems with one parsed line, or [] when it is a record. */
85
+ export function controlAppliedProblems(v: unknown): string[] {
86
+ if (typeof v !== "object" || v === null || Array.isArray(v)) return ["not an object"];
87
+ const r = v as Record<string, unknown>;
88
+ const out: string[] = [];
89
+ if (r.version !== 1) out.push("version must be 1");
90
+ if (r.kind !== CONTROL_APPLIED_KIND) out.push(`kind must be ${CONTROL_APPLIED_KIND}`);
91
+ if (!(typeof r.member === "string" && NAME.test(r.member))) out.push("member must be a member's name");
92
+ if (!(typeof r.op === "string" && NAME.test(r.op))) out.push("op must be an Op's name");
93
+ if (!(typeof r.sha === "string" && SHA.test(r.sha))) out.push("sha must be a commit sha");
94
+ if (!CONTROL_APPLY_OUTCOMES.includes(r.outcome as ControlApplyOutcome)) out.push(`outcome must be one of ${CONTROL_APPLY_OUTCOMES.join(", ")}`);
95
+ if (!(typeof r.at === "string" && !Number.isNaN(Date.parse(r.at)))) out.push("at must be a time");
96
+ if (typeof r.digest !== "string") out.push("digest is missing");
97
+ else if (out.length === 0) {
98
+ const { digest: _d, ...rest } = r as unknown as ControlAppliedRecord;
99
+ if (digestOf(rest) !== r.digest) out.push("digest does not match the record");
100
+ }
101
+ return out;
102
+ }
103
+
104
+ /** Every line of the file that is a record; the rest are counted as malformed. */
105
+ export function parseControlApplied(text: string | null | undefined): { records: ControlAppliedRecord[]; malformed: number } {
106
+ const records: ControlAppliedRecord[] = [];
107
+ let malformed = 0;
108
+ for (const raw of (text ?? "").split("\n")) {
109
+ if (!raw.trim()) continue;
110
+ let v: unknown;
111
+ try {
112
+ v = JSON.parse(raw);
113
+ } catch {
114
+ malformed++;
115
+ continue;
116
+ }
117
+ if (controlAppliedProblems(v).length > 0) malformed++;
118
+ else records.push(v as ControlAppliedRecord);
119
+ }
120
+ return { records, malformed };
121
+ }
122
+
123
+ /** Each member's newest record whose outcome applied something ({@link CONTROL_RUNS_DEPENDENTS}). */
124
+ export function latestControlApplies(records: readonly ControlAppliedRecord[]): Map<string, ControlAppliedRecord> {
125
+ const out = new Map<string, ControlAppliedRecord>();
126
+ for (const r of records) {
127
+ if (!CONTROL_RUNS_DEPENDENTS.includes(r.outcome)) continue;
128
+ const had = out.get(r.member);
129
+ if (!had || Date.parse(had.at) <= Date.parse(r.at)) out.set(r.member, r);
130
+ }
131
+ return out;
132
+ }
133
+
134
+ /** The control repo's `_control/applied.jsonl` on its local `chant/lifecycle`, under the member prefix of `cwd`. */
135
+ export function gitControlAppliedLedger(opts: { cwd?: string } = {}): ControlLedgerPort {
136
+ return {
137
+ async read() {
138
+ const { readBlobFromPath } = await import("../lifecycle/git");
139
+ return readBlobFromPath(CONTROL_LEDGER_DIR, CONTROL_APPLIED_FILE, opts);
140
+ },
141
+ async append(line, message) {
142
+ const { appendLedgerLine } = await import("../lifecycle/git");
143
+ return appendLedgerLine(CONTROL_LEDGER_DIR, CONTROL_APPLIED_FILE, line, message, opts);
144
+ },
145
+ };
146
+ }
147
+
148
+ /** Appends one record of a dispatch the control repo took. Does not push. */
149
+ export async function recordControlApplied(
150
+ port: ControlLedgerPort,
151
+ d: { member: string; op: string; sha: string; outcome: ControlApplyOutcome },
152
+ opts: { now?: () => Date } = {},
153
+ ): Promise<{ record: ControlAppliedRecord; commit: string }> {
154
+ const fields: Omit<ControlAppliedRecord, "digest"> = {
155
+ version: 1,
156
+ kind: CONTROL_APPLIED_KIND,
157
+ member: d.member,
158
+ op: d.op,
159
+ sha: d.sha,
160
+ outcome: d.outcome,
161
+ at: (opts.now ?? (() => new Date()))().toISOString(),
162
+ };
163
+ const record: ControlAppliedRecord = { ...fields, digest: digestOf(fields) };
164
+ const problems = controlAppliedProblems(record);
165
+ if (problems.length > 0) throw new Error(`not a control apply record: ${problems.join(", ")}`);
166
+ const commit = await port.append(JSON.stringify(record), `Control: ${d.member} ${d.outcome} at ${d.sha.slice(0, 12)}`);
167
+ return { record, commit };
168
+ }
169
+
170
+ /**
171
+ * The control repo's step's call (`controlDependentsScript`): records the
172
+ * dispatch the environment carries and pushes `chant/lifecycle`. Returns
173
+ * what it wrote, or why it wrote nothing. A push that fails is a warning:
174
+ * the dependents still run.
175
+ */
176
+ export async function recordControlAppliedFromEnv(
177
+ opts: { cwd?: string; env?: Record<string, string | undefined>; now?: () => Date } = {},
178
+ ): Promise<{ recorded?: ControlAppliedRecord; skipped?: string; pushWarning?: string }> {
179
+ const env = opts.env ?? process.env;
180
+ const member = env.CHANT_CONTROL_MEMBER ?? "";
181
+ const op = env.CHANT_CONTROL_OP ?? "";
182
+ const sha = env.CHANT_CONTROL_SHA ?? "";
183
+ const outcome = env[CONTROL_OUTCOME_VAR] ?? "";
184
+ if (!outcome) return { skipped: "the dispatch carries no outcome" };
185
+ if (!CONTROL_APPLY_OUTCOMES.includes(outcome as ControlApplyOutcome)) return { skipped: `the dispatch's outcome "${outcome}" is not one chant knows` };
186
+ if (!SHA.test(sha)) return { skipped: "the dispatch names no commit sha" };
187
+ const { record } = await recordControlApplied(gitControlAppliedLedger({ cwd: opts.cwd }), { member, op, sha, outcome: outcome as ControlApplyOutcome }, opts.now ? { now: opts.now } : {});
188
+ const { pushLifecycleReport } = await import("../lifecycle/git");
189
+ const pushed = await pushLifecycleReport({ ...(opts.cwd ? { cwd: opts.cwd } : {}) });
190
+ return { recorded: record, ...(pushed.pushWarning ? { pushWarning: pushed.pushWarning } : {}) };
191
+ }
@@ -0,0 +1,129 @@
1
+ /**
2
+ * Consumers joined across a control repo (#4600): two projects' consumers.json
3
+ * give one consumer list per version, each consumer named by its project, and
4
+ * the join feeds the release catalog as its consumers input.
5
+ */
6
+ import { readFileSync } from "node:fs";
7
+ import { join } from "node:path";
8
+ import { describe, expect, test } from "vitest";
9
+ import { buildReleaseCatalog } from "../lifecycle/release-catalog";
10
+ import type { ReleaseRecord } from "../lifecycle/release-ledger";
11
+ import { consumersDocument, joinControlConsumers, parseConsumersDocument, readControlConsumers } from "./consumers";
12
+ import type { ControlEntry } from "./records";
13
+
14
+ const FIX = join(import.meta.dirname, "__fixtures__", "consumers");
15
+ const INFRA = "github.com/acme/infra";
16
+ const APPS = "gitlab.example.com/acme/apps";
17
+ const fixture = (name: string) => readFileSync(join(FIX, name, "consumers.json"), "utf-8");
18
+ const projects = () => [
19
+ { project: INFRA, document: fixture("infra") },
20
+ { project: APPS, document: fixture("apps") },
21
+ ];
22
+
23
+ const entry = (id: string, project?: string): ControlEntry => ({
24
+ id,
25
+ entry: project ? "project" : "defaults",
26
+ ...(project ? { project } : {}),
27
+ settings: {},
28
+ estates: [],
29
+ digest: `sha256:${id}`,
30
+ at: "2026-10-27T00:00:00.000Z",
31
+ });
32
+
33
+ describe("joinControlConsumers", () => {
34
+ test("gives one consumer list per version across both projects", () => {
35
+ const { consumers, problems } = joinControlConsumers(projects());
36
+ expect(problems).toEqual([]);
37
+ expect(consumers.map((c) => [c.component, c.version ?? c.digest, c.consumers.length])).toEqual([
38
+ ["cache", "sha256:1111111111111111111111111111111111111111111111111111111111111111", 1],
39
+ ["eks", "3.0.0", 1],
40
+ ["vpc", "1.1.0", 1],
41
+ ["vpc", "1.2.0", 4],
42
+ ]);
43
+ const vpc12 = consumers.find((c) => c.component === "vpc" && c.version === "1.2.0")!;
44
+ expect(vpc12.consumers.map((c) => [c.repo, c.root, c.address])).toEqual([
45
+ [INFRA, "live/dev", "module.vpc"],
46
+ [INFRA, "live/prod", "module.vpc"],
47
+ [APPS, "live/prod", "module.vpc"],
48
+ [APPS, "units/network", "terragrunt.terraform"],
49
+ ]);
50
+ });
51
+
52
+ test("drops a consumer listed twice and keeps a repo the file names", () => {
53
+ const doc = { contract: 1, consumers: [{ component: "vpc", version: "1.2.0", consumers: [{ root: "a" }, { root: "a" }, { root: "b", repo: "github.com/acme/other" }] }] };
54
+ const { consumers } = joinControlConsumers([{ project: INFRA, document: doc }]);
55
+ expect(consumers[0]!.consumers).toEqual([
56
+ { root: "a", repo: INFRA },
57
+ { root: "b", repo: "github.com/acme/other" },
58
+ ]);
59
+ });
60
+
61
+ test("names each problem by its project and keeps what it could read", () => {
62
+ const bad = JSON.stringify({ contract: 1, consumers: [{ component: "vpc", consumers: [] }, { component: "eks", version: "1.0.0", consumers: [{ root: "x" }] }] });
63
+ const { consumers, problems } = joinControlConsumers([
64
+ { project: INFRA, document: bad },
65
+ { project: APPS, document: "{not json" },
66
+ ]);
67
+ expect(consumers.map((c) => c.component)).toEqual(["eks"]);
68
+ expect(problems.some((p) => p.startsWith(`${INFRA}: consumers.json: consumers[0]: names neither`))).toBe(true);
69
+ expect(problems.some((p) => p.startsWith(`${APPS}: consumers.json: not JSON`))).toBe(true);
70
+ });
71
+
72
+ test("refuses another contract", () => {
73
+ expect(parseConsumersDocument({ contract: 2, consumers: [] }).problems[0]).toContain("contract 2");
74
+ });
75
+
76
+ test("feeds the catalog one consumer list per version", () => {
77
+ const rec = (component: string, releaseVersion: string, digest: string): ReleaseRecord => ({
78
+ version: 1,
79
+ component,
80
+ env: "registry",
81
+ digest,
82
+ gitSha: "1111111111111111111111111111111111111111",
83
+ runId: "run-1",
84
+ timestamp: "2026-10-01T00:00:00.000Z",
85
+ actor: "ci",
86
+ releaseVersion,
87
+ });
88
+ const { consumers } = joinControlConsumers(projects());
89
+ const catalog = buildReleaseCatalog({ releases: [rec("vpc", "1.2.0", "sha256:v12"), rec("vpc", "1.1.0", "sha256:v11")], consumers }, { generatedAt: "2026-10-27T00:00:00.000Z", chant: "0.0.0-test" });
90
+ const vpc = catalog.components.find((c) => c.name === "vpc")!;
91
+ expect(vpc.versions.find((v) => v.version === "1.2.0")!.consumers.map((c) => c.repo)).toEqual([INFRA, INFRA, APPS, APPS]);
92
+ expect(vpc.versions.find((v) => v.version === "1.1.0")!.consumers).toHaveLength(1);
93
+ });
94
+ });
95
+
96
+ describe("readControlConsumers", () => {
97
+ test("reads each project the control repo lists, passes the defaults over, and names the missing", async () => {
98
+ const asked: string[] = [];
99
+ const read = async (project: string) => {
100
+ asked.push(project);
101
+ if (project === INFRA) return fixture("infra");
102
+ if (project === APPS) return fixture("apps");
103
+ return null;
104
+ };
105
+ const got = await readControlConsumers([entry("ctl-001"), entry("ctl-002", INFRA), entry("ctl-003", APPS), entry("ctl-004", "github.com/acme/empty")], read);
106
+ expect(asked).toEqual(["github.com/acme/empty", INFRA, APPS]);
107
+ expect(got.missing).toEqual(["github.com/acme/empty"]);
108
+ expect(got.problems).toEqual([]);
109
+ expect(got.consumers.find((c) => c.component === "vpc" && c.version === "1.2.0")!.consumers).toHaveLength(4);
110
+ });
111
+
112
+ test("names a project whose read fails and joins the rest", async () => {
113
+ const got = await readControlConsumers([entry("ctl-002", INFRA), entry("ctl-003", APPS)], async (p) => {
114
+ if (p === APPS) throw new Error("403 from the forge");
115
+ return fixture("infra");
116
+ });
117
+ expect(got.problems).toEqual([`${APPS}: consumers.json could not be read: 403 from the forge`]);
118
+ expect(got.consumers.find((c) => c.version === "1.2.0")!.consumers).toHaveLength(2);
119
+ });
120
+ });
121
+
122
+ describe("consumersDocument", () => {
123
+ test("writes a document the join reads back, the same bytes for the same input", () => {
124
+ const { consumers } = parseConsumersDocument(fixture("infra"));
125
+ const text = consumersDocument(consumers);
126
+ expect(consumersDocument([...consumers].reverse())).toBe(text);
127
+ expect(parseConsumersDocument(text).consumers).toHaveLength(3);
128
+ });
129
+ });