@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,140 @@
1
+ /**
2
+ * #4537: what `chant run --components <name> --adopt <file>` hands the
3
+ * deploy step. The adoption file is read and checked against the index
4
+ * version it names, the review prints each change set and is the gate
5
+ * (`--yes`, a terminal's answer, or no), and the command refuses `all`, a
6
+ * list, and another runtime. No cloud and no store: the index loader is a
7
+ * fake.
8
+ */
9
+ import { mkdtempSync, writeFileSync } from "node:fs";
10
+ import { tmpdir } from "node:os";
11
+ import { join } from "node:path";
12
+ import { describe, expect, test } from "vitest";
13
+ import { adoptionIndexRef, adoptionReview, loadDeployAdoption, renderAdoptionReview, type AdoptionReviewRequest } from "./adoption";
14
+ import { adoptRefusal } from "../cli/handlers/run";
15
+ import { parseArgs } from "../cli/parse-args";
16
+ import { indexDocumentDigest, indexScopeKey, indexVersionName, type CloudIndexScope, type IndexDocument } from "../lifecycle/index-document";
17
+ import type { AdoptionFile } from "../lifecycle/adoption-file";
18
+
19
+ const SCOPE: CloudIndexScope = { kind: "cloud", substrate: "aws", scopeId: "000000000000", locations: ["us-east-1"], types: "*" };
20
+ const BUCKET = "aws/000000000000/us-east-1/AWS::S3::Bucket/web-logs";
21
+ const graph = {
22
+ version: 1 as const,
23
+ nodes: [{ id: BUCKET, kind: "AWS::S3::Bucket", lexicon: "aws", attrs: {}, listedType: "AWS::S3::Bucket", location: "us-east-1", nativeId: "web-logs" }],
24
+ edges: [],
25
+ groups: {},
26
+ };
27
+ const INDEX: IndexDocument = {
28
+ index: "v1",
29
+ stamp: { source: { kind: "cloud", name: "behold-lister" }, scope: SCOPE, scopeKey: indexScopeKey(SCOPE), observedAt: "2026-10-26T12:00:00Z", digest: indexDocumentDigest({ graph, coverage: [] }) },
30
+ coverage: [],
31
+ graph,
32
+ };
33
+ const FILE: AdoptionFile = {
34
+ adopt: "v1",
35
+ index: { scopeKey: INDEX.stamp.scopeKey, version: indexVersionName(INDEX.stamp.observedAt, INDEX.stamp.digest), digest: INDEX.stamp.digest },
36
+ select: [{ node: BUCKET, as: "BucketWebLogs", type: "AWS::S3::Bucket" }],
37
+ };
38
+
39
+ function write(content: unknown): { dir: string; name: string } {
40
+ const dir = mkdtempSync(join(tmpdir(), "deploy-adoption-test-"));
41
+ writeFileSync(join(dir, "adopt.json"), typeof content === "string" ? content : JSON.stringify(content));
42
+ return { dir, name: "adopt.json" };
43
+ }
44
+
45
+ describe("loadDeployAdoption (#4537)", () => {
46
+ test("reads the file and the index version it names, by scope key and version", async () => {
47
+ const { dir, name } = write(FILE);
48
+ const asked: string[] = [];
49
+ const loaded = await loadDeployAdoption(name, {
50
+ cwd: dir,
51
+ loadIndex: async (ref) => {
52
+ asked.push(ref);
53
+ return [INDEX];
54
+ },
55
+ });
56
+ expect(asked).toEqual([adoptionIndexRef(FILE)]);
57
+ expect(asked[0]).toBe(`${INDEX.stamp.scopeKey}@${FILE.index.version}`);
58
+ expect(loaded.adoption).toEqual(FILE);
59
+ expect(loaded.index).toBe(INDEX);
60
+ });
61
+
62
+ test("refuses a missing file, a file that is not JSON, and one that is not an adoption file", async () => {
63
+ const none = mkdtempSync(join(tmpdir(), "deploy-adoption-test-"));
64
+ await expect(loadDeployAdoption("adopt.json", { cwd: none, loadIndex: async () => [INDEX] })).rejects.toThrow(/no such file/);
65
+ const bad = write("{not json");
66
+ await expect(loadDeployAdoption(bad.name, { cwd: bad.dir, loadIndex: async () => [INDEX] })).rejects.toThrow(/not JSON/);
67
+ const empty = write({ ...FILE, select: [] });
68
+ await expect(loadDeployAdoption(empty.name, { cwd: empty.dir, loadIndex: async () => [INDEX] })).rejects.toThrow(/select names no node/);
69
+ });
70
+
71
+ test("refuses a file that does not match the version read, and a node the version does not hold", async () => {
72
+ const other = { ...FILE, select: [{ node: "aws/000000000000/us-east-1/AWS::S3::Bucket/elsewhere", as: "BucketElsewhere" }] };
73
+ const { dir, name } = write(other);
74
+ await expect(loadDeployAdoption(name, { cwd: dir, loadIndex: async () => [INDEX] })).rejects.toThrow(/is not in index version/);
75
+ const stale = write({ ...FILE, index: { ...FILE.index, digest: "0".repeat(64), version: indexVersionName(INDEX.stamp.observedAt, "0".repeat(64)) } });
76
+ await expect(loadDeployAdoption(stale.name, { cwd: stale.dir, loadIndex: async () => [INDEX] })).rejects.toThrow(/digest does not match/);
77
+ });
78
+
79
+ test("says which version it could not read", async () => {
80
+ const { dir, name } = write(FILE);
81
+ await expect(
82
+ loadDeployAdoption(name, {
83
+ cwd: dir,
84
+ loadIndex: async () => {
85
+ throw new Error("no index version is recorded");
86
+ },
87
+ }),
88
+ ).rejects.toThrow(new RegExp(`could not read index version ${INDEX.stamp.scopeKey}@`));
89
+ });
90
+ });
91
+
92
+ const REQUEST: AdoptionReviewRequest = {
93
+ member: "web",
94
+ step: "markers",
95
+ changeSet: "cs-markers",
96
+ entries: [{ member: "web", lexicon: "aws", planner: "chant", address: "BucketWebLogs", type: "AWS::S3::Bucket", name: "BucketWebLogs", attributes: [{ path: "Tags" }], action: "update", disruption: "in-place" }],
97
+ lines: ["marker write, tags only: BucketWebLogs (AWS::S3::Bucket) Tags += chant:env=prod"],
98
+ };
99
+
100
+ describe("the adoption review (#4537)", () => {
101
+ test("prints the change set, its changes and each marker write as tags only", () => {
102
+ expect(renderAdoptionReview(REQUEST)).toEqual([
103
+ "Marker change set cs-markers for web: writes chant's marker tags on the imported resources, tags only",
104
+ " update BucketWebLogs (AWS::S3::Bucket): Tags",
105
+ " marker write, tags only: BucketWebLogs (AWS::S3::Bucket) Tags += chant:env=prod",
106
+ ]);
107
+ });
108
+
109
+ test("--yes approves after printing; a terminal is asked; with neither it declines and says how to approve", async () => {
110
+ const out: string[] = [];
111
+ expect(await adoptionReview({ yes: true, write: (l) => out.push(l) })(REQUEST)).toBe(true);
112
+ expect(out.at(-1)).toMatch(/approved by --yes/);
113
+
114
+ const questions: string[] = [];
115
+ expect(await adoptionReview({ yes: false, write: () => {}, ask: async (q) => (questions.push(q), false) })(REQUEST)).toBe(false);
116
+ expect(questions).toEqual(["Execute the marker change set cs-markers? [y/N] "]);
117
+
118
+ const lines: string[] = [];
119
+ expect(await adoptionReview({ yes: false, write: (l) => lines.push(l) })(REQUEST)).toBe(false);
120
+ expect(lines.at(-1)).toMatch(/run again with --yes/);
121
+ });
122
+ });
123
+
124
+ describe("--adopt <file> (#4537)", () => {
125
+ test("parses its file, and refuses a missing one", () => {
126
+ const parsed = parseArgs(["run", "--components", "web", "--env", "prod", "--adopt", "adopt.json", "--yes"]);
127
+ expect(parsed.adopt).toBe("adopt.json");
128
+ expect(parsed.yes).toBe(true);
129
+ expect(() => parseArgs(["run", "--components", "web", "--adopt"])).toThrow(/--adopt needs an adoption file/);
130
+ });
131
+ });
132
+
133
+ describe("adoptRefusal (#4537)", () => {
134
+ test("one component on the local runtime only", () => {
135
+ expect(adoptRefusal("web", "local")).toBeUndefined();
136
+ expect(adoptRefusal("all", "local")?.message).toMatch(/name one component, not all/);
137
+ expect(adoptRefusal("web,api", "local")?.message).toMatch(/not a list/);
138
+ expect(adoptRefusal("web", "fountain")?.message).toMatch(/local runtime only/);
139
+ });
140
+ });
@@ -0,0 +1,141 @@
1
+ /**
2
+ * `chant run --components <name> --env <env> --adopt <adoption-file>`
3
+ * (#4537): adopt the resources an adoption file names into the component's
4
+ * stack, through the lexicon's deploy step.
5
+ *
6
+ * Core reads the adoption file and the index version it names, refuses a file
7
+ * that does not match that version, and hands the step a
8
+ * {@link DeployAdoption} on `DeployContext.adoption`. The step (the aws
9
+ * lexicon's `cfn-deploy`, lexicons/aws/src/components/cfn-adopt.ts) plans and
10
+ * runs the adoption. Every change set it makes goes through
11
+ * {@link DeployAdoption.review} before it executes: that review is the gate
12
+ * (INTENTIUS/choudoufu#2284 Q3, "each engine's gate"). It prints the change
13
+ * set and each marker write as tags only, then asks. `--yes` answers yes for
14
+ * a run with no terminal; without `--yes` and without a terminal, the review
15
+ * declines, so the run shows the IMPORT change set, deletes it and changes
16
+ * nothing.
17
+ */
18
+ import { existsSync, readFileSync } from "node:fs";
19
+ import { resolve } from "node:path";
20
+ import { NEXT_RELEASE } from "../release-floors";
21
+ import type { ChangeSetEntry } from "../change-set";
22
+ import { adoptionFileProblems, adoptionFileProblemsAgainst, type AdoptionFile } from "../lifecycle/adoption-file";
23
+ import type { IndexDocument } from "../lifecycle/index-document";
24
+
25
+ /** The first chant whose `run --components` takes `--adopt`. */
26
+ export const DEPLOY_ADOPT_FLOOR = NEXT_RELEASE;
27
+
28
+ /** One change set the adoption asks to execute. */
29
+ export interface AdoptionReviewRequest {
30
+ /** The member (stack) the change set is for. */
31
+ member: string;
32
+ /** `import`: the IMPORT change set. `markers`: the UPDATE that writes chant's marker tags. */
33
+ step: "import" | "markers";
34
+ /** The change set's name, as the backend knows it. */
35
+ changeSet: string;
36
+ /** The change set's changes, as change-set entries. */
37
+ entries: ChangeSetEntry[];
38
+ /** What it writes, one line each: an import per resource, or a marker write as tags only. */
39
+ lines: string[];
40
+ }
41
+
42
+ /** The gate: show the change set and answer whether to execute it. */
43
+ export type AdoptionReview = (request: AdoptionReviewRequest) => Promise<boolean>;
44
+
45
+ /** How an adoption ended, as the step reports it. */
46
+ export interface DeployAdoptionOutcome {
47
+ member: string;
48
+ status: "adopted" | "refused" | "declined" | "failed";
49
+ /** Where it stopped: `plan` before any change set, `import` or `markers`. Absent when adopted. */
50
+ step?: "plan" | "import" | "markers";
51
+ /** What to print, one line each: what was adopted, every refusal, and what to do next. */
52
+ lines: string[];
53
+ }
54
+
55
+ /** What `--adopt <file>` hands the deploy step on `DeployContext.adoption`. */
56
+ export interface DeployAdoption {
57
+ /** The adoption file's path, as given. */
58
+ file: string;
59
+ adoption: AdoptionFile;
60
+ /** The index version the file names, read from the store or a file. */
61
+ index: IndexDocument;
62
+ review: AdoptionReview;
63
+ /**
64
+ * Set by the step that takes the adoption, so a second step refuses it and
65
+ * the command can tell when no step took it.
66
+ */
67
+ outcome?: DeployAdoptionOutcome;
68
+ }
69
+
70
+ /** The index version a file names, in the ref grammar `chant search --index` reads: `<scopeKey>@<version>`. */
71
+ export function adoptionIndexRef(file: AdoptionFile): string {
72
+ return `${file.index.scopeKey}@${file.index.version}`;
73
+ }
74
+
75
+ /**
76
+ * Read an adoption file and the index version it names. `indexAt` overrides
77
+ * where the version is read from (an index document file, as `chant import
78
+ * --index <file>` takes); otherwise it is the project's snapshot store.
79
+ * Throws with every refusal named.
80
+ */
81
+ export async function loadDeployAdoption(
82
+ file: string,
83
+ opts: { cwd: string; indexAt?: string; loadIndex?: (ref: string, cwd: string) => Promise<IndexDocument[]> },
84
+ ): Promise<Omit<DeployAdoption, "review">> {
85
+ const path = resolve(opts.cwd, file);
86
+ if (!existsSync(path)) throw new Error(`--adopt ${file}: no such file`);
87
+ let adoption: AdoptionFile;
88
+ try {
89
+ adoption = JSON.parse(readFileSync(path, "utf-8")) as AdoptionFile;
90
+ } catch (err) {
91
+ throw new Error(`--adopt ${file}: not JSON: ${err instanceof Error ? err.message : String(err)}`);
92
+ }
93
+ if (!adoption || typeof adoption !== "object") throw new Error(`--adopt ${file}: not an adoption file`);
94
+ const own = adoptionFileProblems(adoption);
95
+ if (own.length > 0) throw new Error(`--adopt ${file}: adoption file refused: ${own.join("; ")}`);
96
+ const load = opts.loadIndex ?? (async (ref: string, cwd: string) => (await import("../cli/commands/import-index")).loadIndexDocuments(ref, cwd));
97
+ const ref = opts.indexAt ?? adoptionIndexRef(adoption);
98
+ let docs: IndexDocument[];
99
+ try {
100
+ docs = await load(ref, opts.cwd);
101
+ } catch (err) {
102
+ throw new Error(`--adopt ${file}: could not read index version ${adoptionIndexRef(adoption)}: ${err instanceof Error ? err.message : String(err)}`);
103
+ }
104
+ const index = docs.find((d) => d.stamp?.scopeKey === adoption.index.scopeKey) ?? docs[0];
105
+ if (!index) throw new Error(`--adopt ${file}: ${ref} holds no index document`);
106
+ const against = adoptionFileProblemsAgainst(adoption, index);
107
+ if (against.length > 0) throw new Error(`--adopt ${file}: adoption file refused: ${against.join("; ")}`);
108
+ return { file, adoption, index };
109
+ }
110
+
111
+ /** A change set as review text: a heading, each change, then what it writes. */
112
+ export function renderAdoptionReview(request: AdoptionReviewRequest): string[] {
113
+ const heading =
114
+ request.step === "import"
115
+ ? `IMPORT change set ${request.changeSet} for ${request.member}: brings existing resources under the stack, without chant's markers`
116
+ : `Marker change set ${request.changeSet} for ${request.member}: writes chant's marker tags on the imported resources, tags only`;
117
+ const changes = request.entries.map((e) => ` ${e.importing ? "import" : e.action} ${e.address} (${e.type})${e.attributes.length > 0 ? `: ${e.attributes.map((a) => a.path).join(", ")}` : ""}`);
118
+ return [heading, ...(changes.length > 0 ? changes : [" (no changes listed)"]), ...request.lines.map((l) => ` ${l}`)];
119
+ }
120
+
121
+ /**
122
+ * The review `run --components --adopt` uses: print the change set, then
123
+ * answer. `yes` (`--yes`) approves. Otherwise a terminal is asked
124
+ * (`ask`), and with no terminal the review declines and says how to approve.
125
+ */
126
+ export function adoptionReview(opts: {
127
+ yes: boolean;
128
+ write: (line: string) => void;
129
+ ask?: (question: string) => Promise<boolean>;
130
+ }): AdoptionReview {
131
+ return async (request) => {
132
+ for (const line of renderAdoptionReview(request)) opts.write(line);
133
+ if (opts.yes) {
134
+ opts.write(` approved by --yes; executing ${request.changeSet}`);
135
+ return true;
136
+ }
137
+ if (opts.ask) return opts.ask(`Execute ${request.step === "import" ? "the IMPORT" : "the marker"} change set ${request.changeSet}? [y/N] `);
138
+ opts.write(` not executed: no terminal to answer and no --yes. Read the change set above, then run again with --yes to execute it.`);
139
+ return false;
140
+ };
141
+ }
@@ -0,0 +1,49 @@
1
+ /**
2
+ * The grain and the row lease a CLI apply path runs under (#4594):
3
+ * `chant run --components`, `chant components fan-out`, `promote`,
4
+ * `rollback` and `redeploy`. pr-apply, pr-env and op waves read the grain at
5
+ * base themselves and lease the rows their plan knows.
6
+ *
7
+ * The grain is `ci.lockGrain` of the member holding `cwd`, read the way
8
+ * ../workspace/ci-lock-grain.ts reads it: at base when the job has one,
9
+ * else from the working tree. The lease writes the pull-request loop's rows file,
10
+ * `_locks/rows/pr-apply.json`, so a run of these commands and a pull
11
+ * request's apply meet on the same rows (ruling B of #4552).
12
+ */
13
+ import { spawnSync } from "node:child_process";
14
+ import type { LockGrain } from "../lifecycle/lock-rows";
15
+ import { ledgerRowLease, type LedgerRowLeaseOptions, type RowLeasePort } from "./row-lease";
16
+
17
+ /** What a CLI apply path passes its runner: the declared grain and the lease port, each absent when it has none. */
18
+ export interface ApplyLeaseOptions {
19
+ lockGrain?: LockGrain;
20
+ rowLease?: RowLeasePort;
21
+ }
22
+
23
+ /** Whether `cwd` is inside a git work tree, where `chant/lifecycle` can hold rows. */
24
+ function inWorkTree(cwd: string): boolean {
25
+ const r = spawnSync("git", ["rev-parse", "--is-inside-work-tree"], { cwd, encoding: "utf8" });
26
+ return r.status === 0 && r.stdout.trim() === "true";
27
+ }
28
+
29
+ /**
30
+ * The grain and lease for an apply run from `cwd` (#4594). Outside a git
31
+ * work tree there is no ledger to hold rows in, so no lease is taken, as
32
+ * before; the grain is still passed so a lexicon's refusal of it stands.
33
+ * `gate` names the rows file; default `pr-apply`.
34
+ */
35
+ export async function applyLeaseOptions(cwd: string, opts: LedgerRowLeaseOptions & { gate?: string; at?: string; member?: string } = {}): Promise<ApplyLeaseOptions> {
36
+ let lockGrain: LockGrain | null = null;
37
+ try {
38
+ const { ciLockGrainAt } = await import("../workspace/ci-lock-grain");
39
+ lockGrain = ciLockGrainAt(cwd, opts.at, opts.member);
40
+ } catch {
41
+ // No declaration to read: each member takes its lexicon's default.
42
+ }
43
+ const { PR_APPLY_GATE } = await import("../pr-loop");
44
+ const { gate = PR_APPLY_GATE, at: _at, member: _member, ...lease } = opts;
45
+ return {
46
+ ...(lockGrain ? { lockGrain } : {}),
47
+ ...(inWorkTree(cwd) ? { rowLease: ledgerRowLease(gate, { cwd, ...lease }) } : {}),
48
+ };
49
+ }
@@ -13,8 +13,13 @@
13
13
  */
14
14
 
15
15
  import type { PlanShape } from "./covered-round";
16
+ import { CHANT_EXIT } from "../exit-codes";
16
17
  import type { ReleaseIdentity } from "../telemetry-attribution";
17
18
  import type { ChangeSetPart } from "../change-set";
19
+ import type { DeployAdoption } from "./adoption";
20
+ import type { LockGrain, LockRow } from "../lifecycle/lock-rows";
21
+ import type { RowLeasePort } from "./row-lease";
22
+ import type { CapabilityTraceFacts } from "../otlp";
18
23
 
19
24
  /**
20
25
  * Ambient information a capability's `run`/`rollback` receives, independent of
@@ -81,6 +86,39 @@ export interface DeployContext {
81
86
  * component refuses before anything plans or runs. Absent: the whole step.
82
87
  */
83
88
  targets?: string[];
89
+ /**
90
+ * `--adopt <adoption-file>` (#4537): the resources to adopt into this
91
+ * component's stack, the index version they come from, and the review
92
+ * every change set the adoption makes goes through before it executes. A
93
+ * deploy step that can adopt takes it by setting `outcome`; a step that
94
+ * cannot ignores it, and the command refuses a run no step took it in.
95
+ * Absent: a plain deploy. See ./adoption.ts.
96
+ */
97
+ adoption?: DeployAdoption;
98
+ /**
99
+ * The member's `ci.lockGrain` (#4552), read from the declaration at base
100
+ * by the caller: the member's own, else the workspace's. Absent when
101
+ * neither sets one, and then the capability's `defaultLockGrain` holds. A
102
+ * step input's own grain (`pulumi-up`'s `lockGrain`) wins over it.
103
+ */
104
+ lockGrain?: LockGrain;
105
+ /**
106
+ * The commit the caller reads policy at (#4613): the base a pull request
107
+ * or an op wave is measured from. A step that runs a policy engine of its
108
+ * own, such as `pulumi-up`'s CrossGuard packs, reads the packs and
109
+ * `ci.policy.packs` at this commit (`../policy-packs.ts`), so a change
110
+ * cannot loosen what judges it. Absent outside those jobs: the step reads
111
+ * its packs where they stand.
112
+ */
113
+ policyBase?: string;
114
+ /**
115
+ * The run's row lease (#4594), set by an apply path that plans inside its
116
+ * steps (`run --components`, `components fan-out`, a promote). The driver
117
+ * takes it around a step on the resource grain (./row-lease.ts); a
118
+ * capability never calls it. Absent where the caller leases the rows its
119
+ * plan knows (pr-apply, op waves) or takes no lease.
120
+ */
121
+ rowLease?: RowLeasePort;
84
122
  }
85
123
 
86
124
  /**
@@ -126,6 +164,22 @@ export interface CapabilityPlan {
126
164
  * approval covers it. Absent, core derives the shape from `changeSet`.
127
165
  */
128
166
  shape?: PlanShape;
167
+ /**
168
+ * The engine's own reasons the plan is destructive (#4569), sorted, when it
169
+ * classes more as destructive than a delete or replace in the change set
170
+ * (a Postgres table rewrite, a revoke, a ClickHouse mutation). An op wave
171
+ * counts a plan that names any as destructive, which `on-destructive`
172
+ * waits on. Absent or empty: the change set alone decides.
173
+ */
174
+ destructive?: string[];
175
+ /**
176
+ * Where this member's copy lives in a pull request's environment (#4609),
177
+ * as the capability says: `pulumi-up` answers `<engine>:<dir>#<stack>` for
178
+ * the review stack `pr-<n>` it planned. `pr-env up` keeps it on the
179
+ * environment's record under `locations`, where the lexicon's teardown
180
+ * reads it back. Absent outside a pull request's environment.
181
+ */
182
+ location?: string;
129
183
  }
130
184
 
131
185
  /**
@@ -181,6 +235,25 @@ export interface Capability<In = unknown, Out = unknown> {
181
235
  * is covered by its component's composition digest instead.
182
236
  */
183
237
  plan?(ctx: DeployContext, input: In): Promise<CapabilityPlan>;
238
+ /**
239
+ * Optional (#4552): the lock grain a member of this kind takes when
240
+ * `ci.lockGrain` sets none. `plan`, when given, is the member's plan. Absent:
241
+ * `target`. The terraform lexicon answers `resource` for choudoufu and
242
+ * `target` for Terraform, tofu and Terragrunt; the pulumi lexicon
243
+ * `resource` for plunge and `target` for stock Pulumi.
244
+ */
245
+ defaultLockGrain?(input: In, plan?: CapabilityPlan): LockGrain | Promise<LockGrain>;
246
+ /**
247
+ * Optional (#4552): why this member cannot take `grain`, or undefined when
248
+ * it can. A refusal names the engine, and stops the plan.
249
+ */
250
+ lockGrainRefusal?(input: In, grain: LockGrain, plan?: CapabilityPlan): string | undefined | Promise<string | undefined>;
251
+ /**
252
+ * Optional (#4552): the rows an apply of `plan` holds on the resource
253
+ * grain, one per changed resource, keyed as the lexicon keys them (see
254
+ * ../lifecycle/lock-rows.ts). Absent: the resource grain is refused.
255
+ */
256
+ lockRows?(input: In, plan: CapabilityPlan): LockRow[] | Promise<LockRow[]>;
184
257
  /**
185
258
  * Optional: the outputs `run` exposed when it last ran, read without
186
259
  * changing anything (#3183). A pull request's plan reads them for each
@@ -246,6 +319,28 @@ export interface Capability<In = unknown, Out = unknown> {
246
319
  * throw counts as no reads.
247
320
  */
248
321
  declaredReads?(ctx: DeclaredReadsContext, members: readonly DeclaredReadMember[]): Promise<DeclaredRead[]> | DeclaredRead[];
322
+ /**
323
+ * Optional (#4542): the local files a step deploys from when its input
324
+ * names them indirectly, as `terraform-apply` names a root by key. A
325
+ * release cut records them for the step's component, with their paths
326
+ * from the member's directory kept, and a promote or rollback under that
327
+ * release writes them under `.chant/release-templates/<digest>/` and sets
328
+ * the step's {@link ReleaseInputs.field} to the recorded copy of
329
+ * {@link ReleaseInputs.dir}, so the step plans the release's files. Null
330
+ * when the step deploys nothing local; {@link ReleaseInputsUnbound} when
331
+ * its files can't be deployed from a copy, which the cut prints.
332
+ */
333
+ releaseInputs?(input: In, ctx: ReleaseInputsContext): Promise<ReleaseInputs | ReleaseInputsUnbound | null> | ReleaseInputs | ReleaseInputsUnbound | null;
334
+ /**
335
+ * Optional (#4555): what this capability knows about one `run`, for the
336
+ * step's span and its op-wave run record. Engine facts go in `attributes`
337
+ * (the root or stack, the binary, resource counts), and the pieces the
338
+ * engine timed, such as each resource's provider call, in `spans`. Core
339
+ * writes every key under the CI product's prefix. Called after `run`
340
+ * returned (`output`) or threw (`error`); a throw here, or undefined,
341
+ * leaves the step with core's own facts.
342
+ */
343
+ traceFacts?(input: In, outcome: { output: Out } | { error: unknown }): Promise<CapabilityTraceFacts | undefined> | CapabilityTraceFacts | undefined;
249
344
  /**
250
345
  * Optional (#4435, ws-107): plan `members` as one, in one call. Declared
251
346
  * together with `runGroup`; a capability with only one of the two never
@@ -307,6 +402,27 @@ export interface ReportedGroupRead {
307
402
  output?: string;
308
403
  }
309
404
 
405
+ /** What `releaseInputs` is asked with (#4542). */
406
+ export interface ReleaseInputsContext {
407
+ /** The member's directory, which the answer's paths are relative to. */
408
+ memberDir: string;
409
+ }
410
+
411
+ /** The files a step deploys from (#4542), each relative to the member's directory. */
412
+ export interface ReleaseInputs {
413
+ /** The step field a promote under a release sets to the recorded copy of {@link dir}. */
414
+ field: string;
415
+ /** The directory the step runs in. One of {@link paths}. */
416
+ dir: string;
417
+ /** Every directory and file the step reads, {@link dir} included. */
418
+ paths: string[];
419
+ }
420
+
421
+ /** A step whose files a release can't deploy from a copy (#4542), and why. */
422
+ export interface ReleaseInputsUnbound {
423
+ unbound: string;
424
+ }
425
+
310
426
  /** What `declaredReads` is asked with (#4466). */
311
427
  export interface DeclaredReadsContext {
312
428
  /** The project root, which a step's relative file paths are read against. */
@@ -475,24 +591,32 @@ export type CapabilityOutput<C> = C extends Capability<unknown, infer Out> ? Out
475
591
 
476
592
  /**
477
593
  * The exit code of a command whose capability step refused a plan that moved
478
- * since it was approved: 3, the code `pr-apply` gives a moved digest and a
479
- * run gives a gate (#3997).
594
+ * since it was approved: `CHANT_EXIT.moved`, 4, the code `pr-apply` gives a
595
+ * moved digest (#3997, #4553). Before #4553 it was 3, a gate's code.
596
+ */
597
+ export const PLAN_MOVED_EXIT_CODE = CHANT_EXIT.moved;
598
+
599
+ /**
600
+ * The moved-plan code before #4553. A lexicon built against an older core
601
+ * may still set it on the error it throws for a moved plan; read for one
602
+ * release, then dropped.
480
603
  */
481
- export const PLAN_MOVED_EXIT_CODE = 3;
604
+ const LEGACY_PLAN_MOVED_EXIT_CODE = 3;
482
605
 
483
606
  /**
484
607
  * Whether `err` is a `run`'s refusal to apply a plan from
485
608
  * `DeployContext.plans` because the target moved since it was planned
486
609
  * (#3997). The mark is a `planMoved: true` property, not a class, so a
487
- * lexicon built against an older core can set it. An `exitCode` of
488
- * {@link PLAN_MOVED_EXIT_CODE} on the error is the same mark. Any other
610
+ * lexicon built against an older core can set it. An `exitCode` of 3 on
611
+ * the error, the moved code before #4553, is the same mark for one more
612
+ * release; a lexicon sets `planMoved` and core picks the number. Any other
489
613
  * `exitCode` is ignored: a failed step exits 1, so a capability can't pick
490
614
  * the process's exit code.
491
615
  */
492
616
  export function isPlanMovedError(err: unknown): boolean {
493
617
  if (typeof err !== "object" || err === null) return false;
494
618
  const e = err as { planMoved?: unknown; exitCode?: unknown };
495
- return e.planMoved === true || e.exitCode === PLAN_MOVED_EXIT_CODE;
619
+ return e.planMoved === true || e.exitCode === LEGACY_PLAN_MOVED_EXIT_CODE;
496
620
  }
497
621
 
498
622
  /**
@@ -0,0 +1,66 @@
1
+ import { mkdtempSync, readFileSync, writeFileSync } from "node:fs";
2
+ import { tmpdir } from "node:os";
3
+ import { join } from "node:path";
4
+ import { describe, expect, test } from "vitest";
5
+ import { assertOpWaveHooks, assertPrLoopHooks } from "../op/op-waves";
6
+ import { checkHookEnv, checkHooksOf, runCheckHooks, writeCiHook } from "./check-hooks";
7
+
8
+ describe("the check moment (#4556)", () => {
9
+ test("ci.hooks takes check hooks, and refuses approve and {plan} there", () => {
10
+ expect(() => assertPrLoopHooks("ci.hooks", { check: [{ name: "tflint", command: ["tflint", "--chdir", "{target}"], perRun: true }] })).not.toThrow();
11
+ expect(() => assertPrLoopHooks("ci.hooks", { check: [{ command: ["lint"], onFailure: "approve" }] })).toThrow(/nothing to approve/);
12
+ expect(() => assertPrLoopHooks("ci.hooks", { check: [{ command: ["lint", "{plan}"], perRun: true }] })).toThrow(/no \{plan\}/);
13
+ expect(() => assertPrLoopHooks("ci.hooks", { check: [{ command: ["lint", "{target}"] }] })).toThrow(/perRun/);
14
+ });
15
+
16
+ test("an Op waves spec has no check moment", () => {
17
+ expect(() => assertOpWaveHooks("Op waves", { check: [{ command: ["lint"] }] } as never)).toThrow(/check job/);
18
+ });
19
+
20
+ test("a check hook's environment has no forge token or cloud credentials", () => {
21
+ const env = checkHookEnv({ PATH: "/bin", GITHUB_TOKEN: "t", AWS_SECRET_ACCESS_KEY: "s", ACTIONS_ID_TOKEN_REQUEST_URL: "u", TF_TOKEN_app_terraform_io: "x", TF_TOKEN_registry_example_com: "y", PULUMI_ACCESS_TOKEN: "p" });
22
+ expect(env).toEqual({ PATH: "/bin" });
23
+ });
24
+
25
+ test("the top level's check hooks run before the member's", () => {
26
+ const declaration = { ci: { hooks: { check: [{ name: "a", command: ["a"] }] } }, members: [{ name: "net", ciHooks: { check: [{ name: "b", command: ["b"] }] } }] } as never;
27
+ expect(checkHooksOf(declaration, "net").map((h) => h.name)).toEqual(["a", "b"]);
28
+ });
29
+
30
+ test("runs each hook once, or once per target, and reports each call", () => {
31
+ const cwd = mkdtempSync(join(tmpdir(), "chant-check-"));
32
+ const calls: string[][] = [];
33
+ const report = runCheckHooks({
34
+ base: "abc123",
35
+ targets: ["roots/a", "roots/b"],
36
+ cwd,
37
+ read: { base: "abc123", hooks: [{ name: "fmt", command: ["fmt"] }, { name: "tflint", command: ["tflint", "{target}"], perRun: true, targets: ["roots/b"] }] },
38
+ exec: (argv, _cwd, env) => {
39
+ calls.push([...argv, env?.CHANT_HOOK ?? ""]);
40
+ return argv[1] === "roots/b" ? 2 : 0;
41
+ },
42
+ log: () => {},
43
+ });
44
+ expect(calls).toEqual([["fmt", "check"], ["tflint", "roots/b", "check"]]);
45
+ expect(report).toMatchObject({ status: "failed", base: "abc123", hooks: [{ name: "fmt", outcome: "passed", exit: 0 }, { name: "tflint", target: "roots/b", outcome: "failed", exit: 2 }] });
46
+ expect(JSON.parse(readFileSync(join(cwd, ".chant/check/check-hooks.json"), "utf8")).status).toBe("failed");
47
+ });
48
+
49
+ test("no check hook at base is status none", () => {
50
+ const cwd = mkdtempSync(join(tmpdir(), "chant-check-"));
51
+ expect(runCheckHooks({ base: "abc", cwd, read: { base: "abc", hooks: [] }, log: () => {} }).status).toBe("none");
52
+ });
53
+
54
+ test("writeCiHook adds a check hook, keeps the file's other keys, and replaces one of the same name", () => {
55
+ const root = mkdtempSync(join(tmpdir(), "chant-check-"));
56
+ writeFileSync(join(root, "chant.workspace.json"), JSON.stringify({ version: 1, members: [{ name: "net", path: "net" }] }, null, 2) + "\n");
57
+ expect(writeCiHook(root, "check", { name: "pre-commit", command: ["pre-commit", "run", "--all-files"] }).replaced).toBe(false);
58
+ expect(writeCiHook(root, "check", { name: "pre-commit", command: ["pre-commit", "run", "-a"] }).replaced).toBe(true);
59
+ writeCiHook(root, "check", { name: "tflint", command: ["tflint"] }, { member: "net" });
60
+ const doc = JSON.parse(readFileSync(join(root, "chant.workspace.json"), "utf8"));
61
+ expect(doc.ci.hooks.check).toEqual([{ name: "pre-commit", command: ["pre-commit", "run", "-a"] }]);
62
+ expect(doc.members[0].ci.hooks.check).toEqual([{ name: "tflint", command: ["tflint"] }]);
63
+ expect(doc.version).toBe(1);
64
+ expect(() => writeCiHook(root, "check", { command: ["x"], onFailure: "approve" })).toThrow(/nothing to approve/);
65
+ });
66
+ });