@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,276 @@
1
+ /**
2
+ * `chant approve` at a terminal (#4575): the plan is shown, the target's name
3
+ * is asked for, and only that answer records an approval of the plan shown.
4
+ * Against temp repos; the terminal is faked (isTTY on stdin and stdout, and
5
+ * readline's question). Nothing is pushed.
6
+ */
7
+
8
+ import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
9
+ import { withTestDir } from "@intentius/chant-test-utils";
10
+ import { spawnSync } from "node:child_process";
11
+ import { readFileSync, writeFileSync } from "node:fs";
12
+ import { join } from "node:path";
13
+ import { composeChangeSet, lifecyclePlanPart, type ChangeSetDocument } from "../../change-set";
14
+ import type { ChangeSet as LifecycleChangeSet } from "../../lifecycle/change-set";
15
+ import { persistChangeSet } from "../../lifecycle/change-set-store";
16
+ import { appendPendingGate, readGateLedger } from "../../lifecycle/gate-ledger";
17
+ import { resetGateOrigin } from "../../lifecycle/gate-origin";
18
+ import { CHANT_EXIT } from "../../exit-codes";
19
+ import type { ParsedArgs } from "../registry";
20
+
21
+ vi.mock("../../op/discover", () => ({ discoverOps: async () => ({ errors: [], ops: new Map() }) }));
22
+
23
+ /** The answers the faked terminal gives, in order; undefined is end of input. */
24
+ const answers: Array<string | undefined> = [];
25
+ const questions: string[] = [];
26
+ vi.mock("node:readline", () => ({
27
+ createInterface: () => {
28
+ let onClose: (() => void) | undefined;
29
+ return {
30
+ question: (q: string, cb: (a: string) => void) => {
31
+ questions.push(q);
32
+ const a = answers.shift();
33
+ if (a === undefined) onClose?.();
34
+ else cb(a);
35
+ },
36
+ close: () => undefined,
37
+ on: (event: string, fn: () => void) => {
38
+ if (event === "close") onClose = fn;
39
+ },
40
+ };
41
+ },
42
+ }));
43
+
44
+ const { approvalTarget, confirmApproval, interactiveApproval } = await import("./approve-confirm");
45
+ const { runApprove } = await import("./approve");
46
+
47
+ const plan = JSON.parse(
48
+ readFileSync(join(import.meta.dirname, "..", "..", "__fixtures__", "change-set", "lifecycle-plan.floci.json"), "utf8"),
49
+ ) as LifecycleChangeSet;
50
+ const doc = (): ChangeSetDocument => composeChangeSet([lifecyclePlanPart({ member: "queues", plan })]);
51
+ const OTHER = `jcs1-sha256:${"e".repeat(64)}`;
52
+
53
+ function git(args: string[], cwd: string): void {
54
+ spawnSync("git", args, { cwd, encoding: "utf-8" });
55
+ }
56
+
57
+ /** A repo whose gate `prod-apply` on `app-apply` waits in prod on a stored change set. */
58
+ async function repoWithGate(dir: string): Promise<ChangeSetDocument> {
59
+ git(["init", "-q", "-b", "main"], dir);
60
+ git(["config", "user.email", "t@chant.dev"], dir);
61
+ git(["config", "user.name", "T"], dir);
62
+ writeFileSync(join(dir, "README.md"), "x\n");
63
+ git(["add", "."], dir);
64
+ git(["commit", "-q", "-m", "init"], dir);
65
+ const d = doc();
66
+ await persistChangeSet(d, { cwd: dir });
67
+ await appendPendingGate(
68
+ {
69
+ op: "app-apply",
70
+ gate: "prod-apply",
71
+ timestamp: "2026-10-27T00:00:00.000Z",
72
+ expiresAt: "2999-01-01T00:00:00.000Z",
73
+ planDigest: d.digest,
74
+ environment: "prod",
75
+ description: "apply the queues to prod",
76
+ },
77
+ { cwd: dir },
78
+ );
79
+ return d;
80
+ }
81
+
82
+ function ctx(args: Partial<ParsedArgs>) {
83
+ return {
84
+ args: { command: "approve", path: "app-apply", extraPositional: "prod-apply", format: "", fix: false, watch: false, verbose: false, help: false, live: false, actor: "alice", ...args } as ParsedArgs,
85
+ plugins: [],
86
+ serializers: [],
87
+ };
88
+ }
89
+
90
+ const tty = { stdin: { isTTY: true }, stdout: { isTTY: true }, env: {} as Record<string, string | undefined> };
91
+
92
+ describe("interactiveApproval (#4575)", () => {
93
+ afterEach(() => resetGateOrigin());
94
+
95
+ test("a person at a terminal is asked", async () => {
96
+ expect(await interactiveApproval({}, tty)).toBe(true);
97
+ });
98
+
99
+ test("--yes, --json, CI and a missing terminal are not", async () => {
100
+ expect(await interactiveApproval({ yes: true }, tty)).toBe(false);
101
+ expect(await interactiveApproval({ json: true }, tty)).toBe(false);
102
+ expect(await interactiveApproval({}, { ...tty, env: { CI: "true" } })).toBe(false);
103
+ expect(await interactiveApproval({}, { ...tty, stdin: { isTTY: false } })).toBe(false);
104
+ expect(await interactiveApproval({}, { ...tty, stdout: {} })).toBe(false);
105
+ });
106
+
107
+ test("CI=false still asks", async () => {
108
+ expect(await interactiveApproval({}, { ...tty, env: { CI: "false" } })).toBe(true);
109
+ });
110
+ });
111
+
112
+ describe("approvalTarget (#4575)", () => {
113
+ test("the fact's environment, else --env, else the gate", () => {
114
+ expect(approvalTarget("prod-apply", { environment: "prod" }, "stage")).toBe("prod");
115
+ expect(approvalTarget("prod-apply", {}, "stage")).toBe("stage");
116
+ expect(approvalTarget("prod-apply", undefined)).toBe("prod-apply");
117
+ });
118
+ });
119
+
120
+ describe("confirmApproval (#4575)", () => {
121
+ const cwd = process.cwd();
122
+ beforeEach(() => {
123
+ vi.spyOn(console, "error").mockImplementation(() => {});
124
+ });
125
+ afterEach(() => {
126
+ process.chdir(cwd);
127
+ resetGateOrigin();
128
+ vi.restoreAllMocks();
129
+ });
130
+
131
+ test("shows the stored plan and confirms on the target's name", async () => {
132
+ await withTestDir(async (dir) => {
133
+ const d = await repoWithGate(dir);
134
+ process.chdir(dir);
135
+ let shown = "";
136
+ const asked: string[] = [];
137
+ const c = await confirmApproval("app-apply", "prod-apply", {
138
+ cwd: dir,
139
+ out: (t) => (shown += t),
140
+ err: () => undefined,
141
+ ask: async (q) => (asked.push(q), "prod"),
142
+ });
143
+ expect(c).toEqual({ status: "confirmed", plan: d.digest, target: "prod" });
144
+ expect(shown).toContain(d.digest);
145
+ expect(shown).toContain("apply the queues to prod");
146
+ expect(shown).toContain("queues");
147
+ expect(asked[0]).toContain("Type prod to approve");
148
+ });
149
+ });
150
+
151
+ test("a wrong answer and end of input record nothing", async () => {
152
+ await withTestDir(async (dir) => {
153
+ await repoWithGate(dir);
154
+ process.chdir(dir);
155
+ for (const answer of ["staging", "", null]) {
156
+ let said = "";
157
+ const c = await confirmApproval("app-apply", "prod-apply", { cwd: dir, out: () => undefined, err: (t) => (said += t), ask: async () => answer });
158
+ expect(c).toEqual({ status: "refused", code: CHANT_EXIT.declined });
159
+ expect(said).toContain("the answer was not prod");
160
+ }
161
+ });
162
+ });
163
+
164
+ test("a plan that moves while the person is asked is not approved", async () => {
165
+ await withTestDir(async (dir) => {
166
+ await repoWithGate(dir);
167
+ process.chdir(dir);
168
+ const c = await confirmApproval("app-apply", "prod-apply", {
169
+ cwd: dir,
170
+ out: () => undefined,
171
+ err: () => undefined,
172
+ ask: async () => {
173
+ await appendPendingGate(
174
+ { op: "app-apply", gate: "prod-apply", timestamp: "2026-10-27T01:00:00.000Z", expiresAt: "2999-01-01T00:00:00.000Z", planDigest: OTHER, environment: "prod" },
175
+ { cwd: dir },
176
+ );
177
+ return "prod";
178
+ },
179
+ });
180
+ expect(c).toEqual({ status: "refused", code: CHANT_EXIT.moved });
181
+ });
182
+ });
183
+
184
+ test("a gate with no pending fact and no --plan is left to the record, which refuses it", async () => {
185
+ await withTestDir(async (dir) => {
186
+ await repoWithGate(dir);
187
+ process.chdir(dir);
188
+ const ask = vi.fn(async () => "prod");
189
+ expect(await confirmApproval("app-apply", "other-gate", { cwd: dir, out: () => undefined, err: () => undefined, ask })).toEqual({ status: "skipped" });
190
+ expect(ask).not.toHaveBeenCalled();
191
+ });
192
+ });
193
+
194
+ test("with no stored plan it says so and still asks for the digest", async () => {
195
+ await withTestDir(async (dir) => {
196
+ await repoWithGate(dir);
197
+ process.chdir(dir);
198
+ let said = "";
199
+ const c = await confirmApproval("app-apply", "prod-apply", { cwd: dir, plan: OTHER, out: () => undefined, err: (t) => (said += t), ask: async () => "prod" });
200
+ expect(c).toEqual({ status: "confirmed", plan: OTHER, target: "prod" });
201
+ expect(said).toContain(`No plan is stored on chant/lifecycle under ${OTHER}`);
202
+ });
203
+ });
204
+ });
205
+
206
+ describe("chant approve with a faked terminal (#4575)", () => {
207
+ const cwd = process.cwd();
208
+ const stdinTTY = Object.getOwnPropertyDescriptor(process.stdin, "isTTY");
209
+ const stdoutTTY = Object.getOwnPropertyDescriptor(process.stdout, "isTTY");
210
+ beforeEach(() => {
211
+ answers.length = 0;
212
+ questions.length = 0;
213
+ vi.stubEnv("CI", "");
214
+ Object.defineProperty(process.stdin, "isTTY", { value: true, configurable: true });
215
+ Object.defineProperty(process.stdout, "isTTY", { value: true, configurable: true });
216
+ vi.spyOn(console, "error").mockImplementation(() => {});
217
+ vi.spyOn(console, "log").mockImplementation(() => {});
218
+ vi.spyOn(process.stdout, "write").mockImplementation(() => true);
219
+ vi.spyOn(process.stderr, "write").mockImplementation(() => true);
220
+ });
221
+ afterEach(() => {
222
+ process.chdir(cwd);
223
+ if (stdinTTY) Object.defineProperty(process.stdin, "isTTY", stdinTTY);
224
+ else delete (process.stdin as { isTTY?: boolean }).isTTY;
225
+ if (stdoutTTY) Object.defineProperty(process.stdout, "isTTY", stdoutTTY);
226
+ else delete (process.stdout as { isTTY?: boolean }).isTTY;
227
+ vi.unstubAllEnvs();
228
+ resetGateOrigin();
229
+ vi.restoreAllMocks();
230
+ });
231
+
232
+ test("the target's name records an approval of the plan shown", async () => {
233
+ await withTestDir(async (dir) => {
234
+ const d = await repoWithGate(dir);
235
+ process.chdir(dir);
236
+ answers.push("prod");
237
+ expect(await runApprove(ctx({}))).toBe(0);
238
+ expect(questions).toHaveLength(1);
239
+ const { resolutions } = await readGateLedger("app-apply", { cwd: dir });
240
+ expect(resolutions).toEqual([expect.objectContaining({ resolvedBy: "alice", planDigest: d.digest, environment: "prod" })]);
241
+ });
242
+ });
243
+
244
+ test("another answer records nothing and exits declined", async () => {
245
+ await withTestDir(async (dir) => {
246
+ await repoWithGate(dir);
247
+ process.chdir(dir);
248
+ answers.push("yes");
249
+ expect(await runApprove(ctx({}))).toBe(CHANT_EXIT.declined);
250
+ expect((await readGateLedger("app-apply", { cwd: dir })).resolutions).toEqual([]);
251
+ });
252
+ });
253
+
254
+ test("--yes and --json record as before, without asking", async () => {
255
+ for (const flags of [{ yes: true }, { json: true }]) {
256
+ await withTestDir(async (dir) => {
257
+ const d = await repoWithGate(dir);
258
+ process.chdir(dir);
259
+ expect(await runApprove(ctx(flags))).toBe(0);
260
+ expect(questions).toEqual([]);
261
+ expect((await readGateLedger("app-apply", { cwd: dir })).resolutions).toEqual([expect.objectContaining({ planDigest: d.digest })]);
262
+ });
263
+ }
264
+ });
265
+
266
+ test("no terminal records as before, without asking", async () => {
267
+ await withTestDir(async (dir) => {
268
+ const d = await repoWithGate(dir);
269
+ process.chdir(dir);
270
+ Object.defineProperty(process.stdin, "isTTY", { value: false, configurable: true });
271
+ expect(await runApprove(ctx({}))).toBe(0);
272
+ expect(questions).toEqual([]);
273
+ expect((await readGateLedger("app-apply", { cwd: dir })).resolutions).toEqual([expect.objectContaining({ planDigest: d.digest })]);
274
+ });
275
+ });
276
+ });
@@ -0,0 +1,200 @@
1
+ /**
2
+ * `chant approve` at a terminal (#4575): show the plan the gate waits on and
3
+ * ask the person to type the target's name before anything is recorded.
4
+ *
5
+ * Ruled on INTENTIUS/sql-yodeler#285 (F): the type-the-name confirmation
6
+ * lives in chant core, so every product's approve word gets it from here and
7
+ * drops its own prompt. `yodel approve` is the model: it prints the plan and
8
+ * its digest, asks "Type <env> to approve", refuses a wrong answer, and reads
9
+ * the plan again after the answer so the approval is for the plan the person
10
+ * saw.
11
+ *
12
+ * Only a person at a terminal is asked: stdin and stdout both a TTY, no
13
+ * `--yes`, no `--json`, no `CI` in the environment, and a channel a person
14
+ * types on (not MCP or ACP). Every other run records as it did before.
15
+ *
16
+ * The plan shown is the stored change set (`_change-sets/<digest>.json`,
17
+ * `../../lifecycle/change-set-store.ts`) the pending fact cites: its
18
+ * `changeSet` field once chant#4551 adds one, else its `planDigest` when that
19
+ * is a change-set digest (pull-request and release gates). When none is
20
+ * stored, the pending fact's own lines are shown and the person is told where
21
+ * the plan was printed.
22
+ */
23
+ import type { ParsedArgs } from "../registry";
24
+ import type { PendingGateRecord } from "../../lifecycle/gate-ledger";
25
+ import { CHANT_EXIT } from "../../exit-codes";
26
+
27
+ /** The streams the terminal check reads. `process` in the CLI; tests pass their own. */
28
+ export interface ApprovalTerminal {
29
+ stdin: { isTTY?: boolean };
30
+ stdout: { isTTY?: boolean };
31
+ env: Record<string, string | undefined>;
32
+ }
33
+
34
+ /**
35
+ * Whether `chant approve` asks before recording: a person at a terminal, on
36
+ * a shell channel, who did not pass `--yes` or `--json`.
37
+ */
38
+ export async function interactiveApproval(
39
+ args: Pick<ParsedArgs, "yes" | "json">,
40
+ terminal: ApprovalTerminal = process,
41
+ ): Promise<boolean> {
42
+ if (args.yes || args.json) return false;
43
+ const ci = terminal.env.CI;
44
+ if (ci !== undefined && ci !== "" && ci !== "false" && ci !== "0") return false;
45
+ if (terminal.stdin.isTTY !== true || terminal.stdout.isTTY !== true) return false;
46
+ const { currentGateOrigin, isModelAuthored } = await import("../../lifecycle/gate-origin");
47
+ return !isModelAuthored(currentGateOrigin());
48
+ }
49
+
50
+ /** What the confirmation decided. */
51
+ export type ApprovalConfirmation =
52
+ /** Nothing to show (no plan, a bad `--plan`, a ledger that can't be read): record as before, which reports the problem. */
53
+ | { status: "skipped" }
54
+ /** The person typed the target's name; approve exactly `plan`. */
55
+ | { status: "confirmed"; plan: string; target: string }
56
+ /** Nothing is recorded; exit with `code`. */
57
+ | { status: "refused"; code: number };
58
+
59
+ export interface ConfirmApprovalOptions {
60
+ /** `--plan`, when given. */
61
+ plan?: string;
62
+ /** `--env`, when given. */
63
+ environment?: string;
64
+ /** Where the ledger is read from. Defaults to the process's directory. */
65
+ cwd?: string;
66
+ /** Asks one question and resolves to the answer, or null at end of input. Defaults to a readline prompt on stderr. */
67
+ ask?: (question: string) => Promise<string | null>;
68
+ /** Where the plan is printed. Defaults to stdout. */
69
+ out?: (text: string) => void;
70
+ /** Where the questions' surroundings and refusals go. Defaults to stderr. */
71
+ err?: (text: string) => void;
72
+ }
73
+
74
+ /** Ask one line on the terminal; null when input ends before an answer. */
75
+ export async function askLine(question: string): Promise<string | null> {
76
+ const { createInterface } = await import("node:readline");
77
+ const rl = createInterface({ input: process.stdin, output: process.stderr });
78
+ return new Promise((resolveAnswer) => {
79
+ let answered = false;
80
+ rl.question(question, (answer) => {
81
+ answered = true;
82
+ resolveAnswer(answer);
83
+ rl.close();
84
+ });
85
+ rl.on("close", () => {
86
+ if (!answered) resolveAnswer(null);
87
+ });
88
+ });
89
+ }
90
+
91
+ /** The standing pending fact `chant approve` answers: the same pick `recordGateApproval` makes. */
92
+ function standingFact(pending: PendingGateRecord[], gate: string, environment: string | undefined, latest: (all: PendingGateRecord[], gate: string) => PendingGateRecord | undefined): PendingGateRecord | undefined {
93
+ const bound = pending.some((p) => p.gate === gate && p.environment !== undefined);
94
+ return latest(bound && environment !== undefined ? pending.filter((p) => p.environment === environment) : pending, gate);
95
+ }
96
+
97
+ /**
98
+ * The name a person types to approve: the environment the pending fact was
99
+ * recorded in, else the one `--env` names, else the gate's own name.
100
+ */
101
+ export function approvalTarget(gate: string, standing: Pick<PendingGateRecord, "environment"> | undefined, environment?: string): string {
102
+ return standing?.environment ?? environment ?? gate;
103
+ }
104
+
105
+ /**
106
+ * Show the plan `chant approve <op> <gate>` would approve and ask for the
107
+ * target's name. The caller has already decided the run is interactive
108
+ * ({@link interactiveApproval}).
109
+ */
110
+ export async function confirmApproval(opName: string, gate: string, opts: ConfirmApprovalOptions = {}): Promise<ApprovalConfirmation> {
111
+ const out = opts.out ?? ((t: string) => void process.stdout.write(t));
112
+ const err = opts.err ?? ((t: string) => void process.stderr.write(t));
113
+ const ask = opts.ask ?? askLine;
114
+ const cwd = opts.cwd ?? process.cwd();
115
+
116
+ const { ledgerRecordingOff } = await import("../../lifecycle/no-record");
117
+ if (ledgerRecordingOff()) return { status: "skipped" };
118
+ const { requireLifecycleLedger } = await import("../../lifecycle/git");
119
+ const { readGateLedger, latestPendingGate } = await import("../../lifecycle/gate-ledger");
120
+ const { isPlanDigest, samePlanDigest } = await import("../../lifecycle/plan-digest");
121
+
122
+ let standing: PendingGateRecord | undefined;
123
+ try {
124
+ await requireLifecycleLedger();
125
+ standing = standingFact((await readGateLedger(opName)).pending, gate, opts.environment, latestPendingGate);
126
+ } catch {
127
+ // The record that follows reads the same ledger and says what is wrong.
128
+ return { status: "skipped" };
129
+ }
130
+ if (opts.plan !== undefined && !isPlanDigest(opts.plan)) return { status: "skipped" };
131
+ const digest = opts.plan ?? standing?.planDigest;
132
+ if (digest === undefined) return { status: "skipped" };
133
+ const ofStanding = standing?.planDigest !== undefined && samePlanDigest(digest, standing.planDigest);
134
+ const target = approvalTarget(gate, standing, opts.environment);
135
+
136
+ const lines: string[] = [`Gate "${gate}" on "${opName}"${standing?.environment !== undefined ? ` in ${standing.environment}` : ""}`];
137
+ if (standing && ofStanding) {
138
+ if (standing.description) lines.push(` ${standing.description}`);
139
+ lines.push(` waiting since ${standing.timestamp}${standing.gitSha ? ` at ${standing.gitSha.slice(0, 12)}` : ""}`);
140
+ if (standing.url) lines.push(` ${standing.url}`);
141
+ } else if (standing?.planDigest !== undefined) {
142
+ lines.push(` --plan names ${digest}; the gate's pending fact waits on ${standing.planDigest}`);
143
+ } else {
144
+ lines.push(` no pending fact stands; --plan names ${digest}`);
145
+ }
146
+ lines.push(` plan ${digest}`);
147
+ out(`${lines.join("\n")}\n\n`);
148
+
149
+ // chant#4551: a pending fact cites the change set it was asked for. Read
150
+ // structurally so this compiles before and after that field lands.
151
+ const cited = ofStanding ? (standing as { changeSet?: unknown } | undefined)?.changeSet : undefined;
152
+ const changeSet = typeof cited === "string" ? cited : digest;
153
+ const { CHANGE_SET_DIGEST_PATTERN } = await import("../../workspace/change-set-show");
154
+ let shown = false;
155
+ if (CHANGE_SET_DIGEST_PATTERN.test(changeSet)) {
156
+ try {
157
+ const { readStoredChangeSet } = await import("../../lifecycle/change-set-store");
158
+ const read = await readStoredChangeSet(changeSet, { cwd });
159
+ if (read.status === "found") {
160
+ const { groupChangeSet, renderPlanSummaryText } = await import("../../plan-summary");
161
+ out(renderPlanSummaryText(groupChangeSet(read.document)));
162
+ shown = true;
163
+ } else if (read.status === "malformed") {
164
+ err(`The stored plan can't be shown: ${read.message}\n`);
165
+ }
166
+ } catch (e) {
167
+ err(`The stored plan can't be read: ${e instanceof Error ? e.message : String(e)}\n`);
168
+ }
169
+ }
170
+ if (!shown) {
171
+ err(
172
+ `No plan is stored on chant/lifecycle under ${changeSet}. The run that stopped at the gate printed it; ` +
173
+ `the digest above is what this approval binds.\n`,
174
+ );
175
+ }
176
+
177
+ const answer = await ask(`\nApprove this plan for ${target}, ${digest}? Type ${target} to approve: `);
178
+ if (answer === null || answer.trim() !== target) {
179
+ err(`Not approved: the answer was not ${target}.\n`);
180
+ return { status: "refused", code: CHANT_EXIT.declined };
181
+ }
182
+
183
+ // Read the fact again: what is approved is what the person saw.
184
+ if (opts.plan === undefined) {
185
+ let now: PendingGateRecord | undefined;
186
+ try {
187
+ now = standingFact((await readGateLedger(opName)).pending, gate, opts.environment, latestPendingGate);
188
+ } catch {
189
+ return { status: "confirmed", plan: digest, target };
190
+ }
191
+ if (now?.planDigest === undefined || !samePlanDigest(now.planDigest, digest)) {
192
+ err(
193
+ `Not approved: the plan moved while you were asked (now ${now?.planDigest ?? "no pending plan"}); ` +
194
+ `run chant approve ${opName} ${gate} again.\n`,
195
+ );
196
+ return { status: "refused", code: CHANT_EXIT.moved };
197
+ }
198
+ }
199
+ return { status: "confirmed", plan: digest, target };
200
+ }
@@ -158,11 +158,24 @@ export async function runApprove(ctx: CommandContext): Promise<number> {
158
158
  // has applied since #2126 (`../handlers/run.ts`'s `runOpApprove`). Reading
159
159
  // only `--actor` here meant every README that teaches `--approver you`
160
160
  // recorded the shell user instead (#2192).
161
+ // #4575: a person at a terminal sees the plan and types the target's name
162
+ // first, and the approval binds the digest they were shown. --yes, --json,
163
+ // CI and no terminal record as before.
164
+ let plan = ctx.args.plan;
165
+ const confirm = await import("./approve-confirm");
166
+ if (await confirm.interactiveApproval(ctx.args)) {
167
+ const answered = await confirm.confirmApproval(opName, gate, {
168
+ ...(plan !== undefined ? { plan } : {}),
169
+ ...(ctx.args.env !== undefined ? { environment: ctx.args.env } : {}),
170
+ });
171
+ if (answered.status === "refused") return answered.code;
172
+ if (answered.status === "confirmed") plan = answered.plan;
173
+ }
161
174
  const outcome = await recordGateApproval(opName, gate, {
162
175
  actor: ctx.args.approver ?? ctx.args.actor,
163
176
  note: ctx.args.note,
164
177
  url: ctx.args.url,
165
- plan: ctx.args.plan,
178
+ plan,
166
179
  ...(ctx.args.env !== undefined ? { environment: ctx.args.env } : {}),
167
180
  allowSameOrigin: ctx.args.allowSameOrigin,
168
181
  ...(ctx.args.roles ? { roles: ctx.args.roles } : {}),
@@ -449,6 +462,9 @@ export async function recordGateApproval(
449
462
  // approval of another plan names none, and no release gate counts it.
450
463
  const releaseDigest =
451
464
  standing?.releaseDigest !== undefined && samePlanDigest(planDigest, standing.planDigest) ? standing.releaseDigest : undefined;
465
+ // #4551: and the change set the fact cites, so the approval names the plans it was asked for.
466
+ const changeSet =
467
+ standing?.changeSet !== undefined && samePlanDigest(planDigest, standing.planDigest) ? standing.changeSet : undefined;
452
468
  // #4033 (ws-105): a release gate whose release was cut from a revoked
453
469
  // commit is superseded. Its promote refuses the release, so an approval of
454
470
  // it would count for nothing; refuse it here, whatever plan is named.
@@ -671,6 +687,7 @@ export async function recordGateApproval(
671
687
  ...(checkpointDigest !== undefined ? { checkpointDigest } : {}),
672
688
  ...(environment !== undefined ? { environment } : {}),
673
689
  ...(releaseDigest !== undefined ? { releaseDigest } : {}),
690
+ ...(changeSet !== undefined ? { changeSet } : {}),
674
691
  // #4020: the commit and run the gate waited on, off the fact this approves.
675
692
  ...(standing?.gitSha ? { gitSha: standing.gitSha } : {}),
676
693
  ...(standing?.runId ? { runId: standing.runId } : {}),
@@ -29,6 +29,13 @@ vi.mock("../../config", async () => {
29
29
  return { ...actual, loadChantConfigUpward: (...args: unknown[]) => loadChantConfigUpwardMock(...args) };
30
30
  });
31
31
 
32
+ // #4550's engine lines load each lexicon the project lists, and with path "." that is this repository's every lexicon,
33
+ // 10 to 20s cold. The generator is mocked here, so no test reads the lines: the project lists none.
34
+ vi.mock("../plugins", async () => {
35
+ const actual = await vi.importActual<typeof import("../plugins")>("../plugins");
36
+ return { ...actual, resolveProjectLexicons: async () => [] };
37
+ });
38
+
32
39
  const { runBuild } = await import("./build");
33
40
 
34
41
  function makeArgs(overrides: Partial<ParsedArgs> = {}): ParsedArgs {
@@ -10,6 +10,33 @@ import { resolveCliBuildParams, parseParamFlags } from "../build-params-cli";
10
10
  import { findWorkspaceRoot } from "../../project-root";
11
11
  import { resolvePromotionSource } from "../../components/promote-order";
12
12
  import type { PrLoopPipelineOptions } from "../../components/pr-pipeline";
13
+ import { activeProductWords, isChantWords } from "../../ci-product-words";
14
+
15
+ /**
16
+ * The engine install lines the project's lexicons give (#4550,
17
+ * `LexiconPlugin.ciSetup`), for the default image. A lexicon that cannot
18
+ * load gives none; with none at all the pipeline keeps installing OpenTofu.
19
+ */
20
+ async function engineSetupFor(path: string): Promise<string[]> {
21
+ const { loadPlugin, resolveProjectLexicons } = await import("../plugins");
22
+ const { engineSetupLines } = await import("../../components/pr-pipeline");
23
+ let names: string[];
24
+ try {
25
+ names = await resolveProjectLexicons(path);
26
+ } catch {
27
+ return [];
28
+ }
29
+ const lines: Array<string[] | undefined> = [];
30
+ for (const name of names) {
31
+ try {
32
+ const plugin = await loadPlugin(name);
33
+ lines.push(plugin.ciSetup?.({ dir: path }));
34
+ } catch {
35
+ // not installed: it gives no lines
36
+ }
37
+ }
38
+ return engineSetupLines(lines);
39
+ }
13
40
 
14
41
  /**
15
42
  * The `prLoop` generator option from `--pr-loop`'s flags (#3183): the gate
@@ -24,9 +51,14 @@ import type { PrLoopPipelineOptions } from "../../components/pr-pipeline";
24
51
  * `--pr-env` (#4298) adds the jobs of a pull request's environment.
25
52
  * `--apply-before-merge` (#4301) writes the apply job that applies an open
26
53
  * pull request before it merges, beside the record job.
54
+ * `--preview-comment` (#4620) writes the jobs that answer the product's plan
55
+ * comment with a preview of the pull request's head.
27
56
  */
28
57
  function prLoopOption(args: CommandContext["args"], reportUrl: string | undefined, requireReview = false, requireRunnerStart = false): PrLoopPipelineOptions {
58
+ // #4550: a product's bin set its words; the generated jobs answer its comment and run its bin.
59
+ const words = activeProductWords();
29
60
  return {
61
+ ...(isChantWords(words) ? {} : { words }),
30
62
  ...(args.gate ? { gate: args.gate } : {}),
31
63
  ...(args.branch ? { branch: args.branch } : {}),
32
64
  ...(args.eventsJson ? { events: true } : {}),
@@ -38,6 +70,8 @@ function prLoopOption(args: CommandContext["args"], reportUrl: string | undefine
38
70
  ...(args.applyOnMerge ? { applyOnMerge: true } : {}),
39
71
  ...(args.prEnv ? { prEnvironment: true } : {}),
40
72
  ...(args.applyBeforeMerge ? { applyBeforeMerge: true } : {}),
73
+ ...(args.previewComment ? { previewComment: true } : {}),
74
+ ...(args.requires ? { applyRequires: args.requires } : {}),
41
75
  };
42
76
  }
43
77
 
@@ -177,6 +211,15 @@ async function runGenerateComponents(ctx: CommandContext): Promise<number> {
177
211
  locks = (await import("../../workspace/ci-locks")).ciLocksAt(resolve(args.path)) === "plan" ? "plan" : undefined;
178
212
  }
179
213
 
214
+ // #4550: the engine lines of the project's lexicons, in place of OpenTofu for every project.
215
+ const engineSetup = args.prLoop && !args.image ? await engineSetupFor(resolve(args.path)) : [];
216
+
217
+ // #4552: ci.lockGrain: repo keeps one apply at a time in the repository, read from the declaration like ci.locks.
218
+ let lockGrain: "repo" | undefined;
219
+ if (found && args.prLoop) {
220
+ lockGrain = (await import("../../workspace/ci-lock-grain")).ciLockGrainAt(resolve(args.path), undefined, plan?.member.name) === "repo" ? "repo" : undefined;
221
+ }
222
+
180
223
  // Which lexicons support generate mode is a property of the loaded lexicon
181
224
  // plugins (those implementing `generateComponentPipeline`, #688), not a
182
225
  // hard-coded core list — `generateComponentsPipeline` returns a descriptive
@@ -198,7 +241,7 @@ async function runGenerateComponents(ctx: CommandContext): Promise<number> {
198
241
  : {}),
199
242
  // #3183: a plan job per pull request and an apply job per merge.
200
243
  // #4292: on the branch ci.branches routes the member to, when it routes it.
201
- ...(args.prLoop ? { prLoop: { ...prLoopOption(args, reportUrl, reviewRules, isolatedRunners), ...(plan?.branch ? { branch: plan.branch } : {}), ...(identity ? { identity } : {}), ...(prEnvIdentity ? { prEnvIdentity } : {}), ...(locks ? { locks } : {}) } } : {}),
244
+ ...(args.prLoop ? { prLoop: { ...prLoopOption(args, reportUrl, reviewRules, isolatedRunners), ...(plan?.branch ? { branch: plan.branch } : {}), ...(identity ? { identity } : {}), ...(prEnvIdentity ? { prEnvIdentity } : {}), ...(locks ? { locks } : {}), ...(engineSetup.length > 0 ? { engineSetup } : {}), ...(lockGrain ? { lockGrain } : {}) } } : {}),
202
245
  // #4002: the job image and the lines that install what it lacks, chant itself included.
203
246
  ...(args.image ? { image: args.image } : {}),
204
247
  ...(args.beforeScript?.length ? { beforeScript: args.beforeScript } : {}),
@@ -0,0 +1,33 @@
1
+ /**
2
+ * `chant ci check --base <rev> [<target>...] [--output <dir>] [--json]`
3
+ * (#4556): run the `ci.hooks.check` hooks the workspace declaration at
4
+ * `--base` names, as a product's check job does. Each target is a root,
5
+ * stack or component the change touches; a `perRun` hook runs once per
6
+ * target. Exits 0 when every hook passed or none is declared, 1 when one
7
+ * failed. See `../../components/check-hooks.ts`.
8
+ */
9
+ import { formatError } from "../format";
10
+ import type { CommandContext } from "../registry";
11
+
12
+ const USAGE = "chant ci check --base <rev> [<target>...] [--output <dir>] [--json]";
13
+
14
+ export async function runCiCheck(ctx: CommandContext): Promise<number> {
15
+ const { args } = ctx;
16
+ if (!args.base) {
17
+ console.error(formatError({ message: "chant ci check needs --base <rev>, the commit the change is measured from", hint: `${USAGE}. The hooks are read at base, so a change cannot remove a required check.` }));
18
+ return 1;
19
+ }
20
+ const targets = (args.positionals ?? []).slice(1);
21
+ const { runCheckHooks } = await import("../../components/check-hooks");
22
+ let report;
23
+ try {
24
+ report = runCheckHooks({ base: args.base, targets, ...(args.output ? { dir: args.output } : {}) });
25
+ } catch (err) {
26
+ console.error(formatError({ message: err instanceof Error ? err.message : String(err), hint: USAGE }));
27
+ return 1;
28
+ }
29
+ if (args.json) console.log(JSON.stringify(report, null, 2));
30
+ else if (report.status === "none") console.error("ci check: no ci.hooks.check at base, so nothing ran");
31
+ else console.error(`ci check: ${report.hooks.filter((h) => h.outcome === "passed").length} passed, ${report.hooks.filter((h) => h.outcome === "failed").length} failed, ${report.hooks.filter((h) => h.outcome === "skipped").length} skipped`);
32
+ return report.status === "failed" ? 1 : 0;
33
+ }