@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,17 @@
1
+ /**
2
+ * `chant agent prepare|run|land` (#4616): the three steps of the agent jobs
3
+ * the Op generator writes for a scheduled Op spec's `agent`
4
+ * (../../ci-agent.ts says what each does and which token each holds).
5
+ *
6
+ * ```
7
+ * chant agent prepare --forge <kind> [--output <dir>] the agent job, read token: decide
8
+ * chant agent run --forge <kind> [--output <dir>] the agent job, the model's key and no forge token
9
+ * chant agent land --forge <kind> [--output <dir>] the push job, write token: commit, push, pull request, record
10
+ * ```
11
+ *
12
+ * The settings come from the job's `CHANT_AGENT_*` variables, which the
13
+ * generator wrote into the workflow file of the base branch.
14
+ */
15
+ import type { CommandContext } from "../registry.js";
16
+ export declare function runAgentCommandLine(ctx: CommandContext): Promise<number>;
17
+ //# sourceMappingURL=agent.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAuBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkClD,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAuD9E"}
@@ -0,0 +1,114 @@
1
+ /**
2
+ * `chant agent prepare|run|land` (#4616): the three steps of the agent jobs
3
+ * the Op generator writes for a scheduled Op spec's `agent`
4
+ * (../../ci-agent.ts says what each does and which token each holds).
5
+ *
6
+ * ```
7
+ * chant agent prepare --forge <kind> [--output <dir>] the agent job, read token: decide
8
+ * chant agent run --forge <kind> [--output <dir>] the agent job, the model's key and no forge token
9
+ * chant agent land --forge <kind> [--output <dir>] the push job, write token: commit, push, pull request, record
10
+ * ```
11
+ *
12
+ * The settings come from the job's `CHANT_AGENT_*` variables, which the
13
+ * generator wrote into the workflow file of the base branch.
14
+ */
15
+ import { execFileSync } from "node:child_process";
16
+ import { readFileSync } from "node:fs";
17
+ import { tmpdir } from "node:os";
18
+ import { join, resolve } from "node:path";
19
+ import { AGENT_DIR, AgentError, agentSettingsFromEnv, landAgentChange, prepareAgentRun, runAgent, runAgentCommand, } from "../../ci-agent.js";
20
+ import { activeProductWords } from "../../ci-product-words.js";
21
+ import { CHANT_EXIT } from "../../exit-codes.js";
22
+ import { appendRunRecord, readRunLedger } from "../../lifecycle/run-ledger.js";
23
+ import { pushLifecycle } from "../../lifecycle/git.js";
24
+ import { resolveCiRun } from "../../lifecycle/release-ledger.js";
25
+ import { FORGE_KINDS, forgeFromEnv } from "../../pr-forge.js";
26
+ import { formatError, formatInfo } from "../format.js";
27
+ const USAGE = "chant agent prepare|run|land --forge github|gitlab|forgejo [--output <dir>]";
28
+ function fail(message) {
29
+ console.error(formatError({ message, hint: USAGE }));
30
+ return CHANT_EXIT.failed;
31
+ }
32
+ /** git with hooks and fsmonitor off: nothing here runs code from the repository. */
33
+ const git = (args, opts = {}) => execFileSync("git", ["-c", "core.hooksPath=/dev/null", "-c", "core.fsmonitor=false", ...args], {
34
+ cwd: opts.cwd,
35
+ input: opts.input,
36
+ encoding: "utf8",
37
+ stdio: ["pipe", "pipe", "pipe"],
38
+ env: { ...process.env, GIT_TERMINAL_PROMPT: "0" },
39
+ maxBuffer: 64 << 20,
40
+ });
41
+ function eventOf() {
42
+ const file = process.env.GITHUB_EVENT_PATH;
43
+ if (!file)
44
+ return undefined;
45
+ try {
46
+ return JSON.parse(readFileSync(file, "utf8"));
47
+ }
48
+ catch {
49
+ return undefined;
50
+ }
51
+ }
52
+ function workDir(name) {
53
+ return join(process.env.RUNNER_TEMP || process.env.TMPDIR || tmpdir(), name);
54
+ }
55
+ export async function runAgentCommandLine(ctx) {
56
+ const action = ctx.args.path;
57
+ if (action !== "prepare" && action !== "run" && action !== "land")
58
+ return fail(action ? `agent ${action} is not one of prepare, run or land` : "agent needs an action: prepare, run or land");
59
+ const kind = ctx.args.forge;
60
+ if (!kind || !FORGE_KINDS.includes(kind))
61
+ return fail(`--forge is one of ${FORGE_KINDS.join(", ")}`);
62
+ const words = activeProductWords();
63
+ const dir = resolve(ctx.args.output ?? AGENT_DIR);
64
+ let settings;
65
+ try {
66
+ settings = agentSettingsFromEnv(process.env, words.product);
67
+ }
68
+ catch (e) {
69
+ return fail(e.message);
70
+ }
71
+ const readRuns = async () => (await readRunLedger(settings.env, settings.name)).records;
72
+ const forge = () => forgeFromEnv(kind);
73
+ try {
74
+ if (action === "prepare") {
75
+ const d = await prepareAgentRun({ settings, words, dir, env: process.env, event: eventOf(), forge: settings.on === "comment" && kind !== "gitlab" ? forge() : undefined, readRuns, git, now: new Date() });
76
+ console.error(formatInfo(d.go ? `${words.product} agent: runs on ${d.sha?.slice(0, 12)}${d.pr ? ` for #${d.pr}` : ""}` : `${words.product} agent: does not run: ${d.reason}`));
77
+ return CHANT_EXIT.done;
78
+ }
79
+ if (action === "run") {
80
+ const r = await runAgent({ settings, dir, workDir: workDir("chant-agent-work"), env: process.env, git, runCommand: runAgentCommand });
81
+ console.error(formatInfo(`${words.product} agent: exited ${r.rc}${r.changed ? ", with a change" : ", changing nothing"}`));
82
+ // The push job says why on the pull request; this job stays green so it runs.
83
+ return CHANT_EXIT.done;
84
+ }
85
+ const ci = resolveCiRun(process.env);
86
+ const out = await landAgentChange({
87
+ settings,
88
+ words,
89
+ dir,
90
+ workDir: workDir("chant-agent-land"),
91
+ env: process.env,
92
+ event: eventOf(),
93
+ forge: forge(),
94
+ git,
95
+ push: ({ cwd, ref, lease }) => {
96
+ git(["push", "-q", ...(lease ? [`--force-with-lease=${lease}`] : []), "origin", `HEAD:${ref}`], { cwd });
97
+ },
98
+ readRuns,
99
+ record: async (input) => {
100
+ await appendRunRecord(input);
101
+ await pushLifecycle();
102
+ },
103
+ now: () => new Date(),
104
+ ...(ci ? { runOrigin: ci.runOrigin } : {}),
105
+ });
106
+ console.error(formatInfo(`${words.product} agent: ${out.result}: ${out.reason}`));
107
+ return out.code;
108
+ }
109
+ catch (e) {
110
+ if (e instanceof AgentError)
111
+ return fail(e.message);
112
+ return fail(`agent ${action}: ${e.message}`);
113
+ }
114
+ }
@@ -0,0 +1,84 @@
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.js";
24
+ import type { PendingGateRecord } from "../../lifecycle/gate-ledger.js";
25
+ /** The streams the terminal check reads. `process` in the CLI; tests pass their own. */
26
+ export interface ApprovalTerminal {
27
+ stdin: {
28
+ isTTY?: boolean;
29
+ };
30
+ stdout: {
31
+ isTTY?: boolean;
32
+ };
33
+ env: Record<string, string | undefined>;
34
+ }
35
+ /**
36
+ * Whether `chant approve` asks before recording: a person at a terminal, on
37
+ * a shell channel, who did not pass `--yes` or `--json`.
38
+ */
39
+ export declare function interactiveApproval(args: Pick<ParsedArgs, "yes" | "json">, terminal?: ApprovalTerminal): Promise<boolean>;
40
+ /** What the confirmation decided. */
41
+ export type ApprovalConfirmation =
42
+ /** Nothing to show (no plan, a bad `--plan`, a ledger that can't be read): record as before, which reports the problem. */
43
+ {
44
+ status: "skipped";
45
+ }
46
+ /** The person typed the target's name; approve exactly `plan`. */
47
+ | {
48
+ status: "confirmed";
49
+ plan: string;
50
+ target: string;
51
+ }
52
+ /** Nothing is recorded; exit with `code`. */
53
+ | {
54
+ status: "refused";
55
+ code: number;
56
+ };
57
+ export interface ConfirmApprovalOptions {
58
+ /** `--plan`, when given. */
59
+ plan?: string;
60
+ /** `--env`, when given. */
61
+ environment?: string;
62
+ /** Where the ledger is read from. Defaults to the process's directory. */
63
+ cwd?: string;
64
+ /** Asks one question and resolves to the answer, or null at end of input. Defaults to a readline prompt on stderr. */
65
+ ask?: (question: string) => Promise<string | null>;
66
+ /** Where the plan is printed. Defaults to stdout. */
67
+ out?: (text: string) => void;
68
+ /** Where the questions' surroundings and refusals go. Defaults to stderr. */
69
+ err?: (text: string) => void;
70
+ }
71
+ /** Ask one line on the terminal; null when input ends before an answer. */
72
+ export declare function askLine(question: string): Promise<string | null>;
73
+ /**
74
+ * The name a person types to approve: the environment the pending fact was
75
+ * recorded in, else the one `--env` names, else the gate's own name.
76
+ */
77
+ export declare function approvalTarget(gate: string, standing: Pick<PendingGateRecord, "environment"> | undefined, environment?: string): string;
78
+ /**
79
+ * Show the plan `chant approve <op> <gate>` would approve and ask for the
80
+ * target's name. The caller has already decided the run is interactive
81
+ * ({@link interactiveApproval}).
82
+ */
83
+ export declare function confirmApproval(opName: string, gate: string, opts?: ConfirmApprovalOptions): Promise<ApprovalConfirmation>;
84
+ //# sourceMappingURL=approve-confirm.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"approve-confirm.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/approve-confirm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,wFAAwF;AACxF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC3B,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,MAAM,CAAC,EACtC,QAAQ,GAAE,gBAA0B,GACnC,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED,qCAAqC;AACrC,MAAM,MAAM,oBAAoB;AAC9B,2HAA2H;AACzH;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE;AACvB,kEAAkE;GAChE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AACvD,6CAA6C;GAC3C;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,MAAM,WAAW,sBAAsB;IACrC,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sHAAsH;IACtH,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnD,qDAAqD;IACrD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,6EAA6E;IAC7E,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,2EAA2E;AAC3E,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CActE;AAQD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,GAAG,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvI;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,sBAA2B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA0FpI"}
@@ -0,0 +1,142 @@
1
+ import { CHANT_EXIT } from "../../exit-codes.js";
2
+ /**
3
+ * Whether `chant approve` asks before recording: a person at a terminal, on
4
+ * a shell channel, who did not pass `--yes` or `--json`.
5
+ */
6
+ export async function interactiveApproval(args, terminal = process) {
7
+ if (args.yes || args.json)
8
+ return false;
9
+ const ci = terminal.env.CI;
10
+ if (ci !== undefined && ci !== "" && ci !== "false" && ci !== "0")
11
+ return false;
12
+ if (terminal.stdin.isTTY !== true || terminal.stdout.isTTY !== true)
13
+ return false;
14
+ const { currentGateOrigin, isModelAuthored } = await import("../../lifecycle/gate-origin.js");
15
+ return !isModelAuthored(currentGateOrigin());
16
+ }
17
+ /** Ask one line on the terminal; null when input ends before an answer. */
18
+ export async function askLine(question) {
19
+ const { createInterface } = await import("node:readline");
20
+ const rl = createInterface({ input: process.stdin, output: process.stderr });
21
+ return new Promise((resolveAnswer) => {
22
+ let answered = false;
23
+ rl.question(question, (answer) => {
24
+ answered = true;
25
+ resolveAnswer(answer);
26
+ rl.close();
27
+ });
28
+ rl.on("close", () => {
29
+ if (!answered)
30
+ resolveAnswer(null);
31
+ });
32
+ });
33
+ }
34
+ /** The standing pending fact `chant approve` answers: the same pick `recordGateApproval` makes. */
35
+ function standingFact(pending, gate, environment, latest) {
36
+ const bound = pending.some((p) => p.gate === gate && p.environment !== undefined);
37
+ return latest(bound && environment !== undefined ? pending.filter((p) => p.environment === environment) : pending, gate);
38
+ }
39
+ /**
40
+ * The name a person types to approve: the environment the pending fact was
41
+ * recorded in, else the one `--env` names, else the gate's own name.
42
+ */
43
+ export function approvalTarget(gate, standing, environment) {
44
+ return standing?.environment ?? environment ?? gate;
45
+ }
46
+ /**
47
+ * Show the plan `chant approve <op> <gate>` would approve and ask for the
48
+ * target's name. The caller has already decided the run is interactive
49
+ * ({@link interactiveApproval}).
50
+ */
51
+ export async function confirmApproval(opName, gate, opts = {}) {
52
+ const out = opts.out ?? ((t) => void process.stdout.write(t));
53
+ const err = opts.err ?? ((t) => void process.stderr.write(t));
54
+ const ask = opts.ask ?? askLine;
55
+ const cwd = opts.cwd ?? process.cwd();
56
+ const { ledgerRecordingOff } = await import("../../lifecycle/no-record.js");
57
+ if (ledgerRecordingOff())
58
+ return { status: "skipped" };
59
+ const { requireLifecycleLedger } = await import("../../lifecycle/git.js");
60
+ const { readGateLedger, latestPendingGate } = await import("../../lifecycle/gate-ledger.js");
61
+ const { isPlanDigest, samePlanDigest } = await import("../../lifecycle/plan-digest.js");
62
+ let standing;
63
+ try {
64
+ await requireLifecycleLedger();
65
+ standing = standingFact((await readGateLedger(opName)).pending, gate, opts.environment, latestPendingGate);
66
+ }
67
+ catch {
68
+ // The record that follows reads the same ledger and says what is wrong.
69
+ return { status: "skipped" };
70
+ }
71
+ if (opts.plan !== undefined && !isPlanDigest(opts.plan))
72
+ return { status: "skipped" };
73
+ const digest = opts.plan ?? standing?.planDigest;
74
+ if (digest === undefined)
75
+ return { status: "skipped" };
76
+ const ofStanding = standing?.planDigest !== undefined && samePlanDigest(digest, standing.planDigest);
77
+ const target = approvalTarget(gate, standing, opts.environment);
78
+ const lines = [`Gate "${gate}" on "${opName}"${standing?.environment !== undefined ? ` in ${standing.environment}` : ""}`];
79
+ if (standing && ofStanding) {
80
+ if (standing.description)
81
+ lines.push(` ${standing.description}`);
82
+ lines.push(` waiting since ${standing.timestamp}${standing.gitSha ? ` at ${standing.gitSha.slice(0, 12)}` : ""}`);
83
+ if (standing.url)
84
+ lines.push(` ${standing.url}`);
85
+ }
86
+ else if (standing?.planDigest !== undefined) {
87
+ lines.push(` --plan names ${digest}; the gate's pending fact waits on ${standing.planDigest}`);
88
+ }
89
+ else {
90
+ lines.push(` no pending fact stands; --plan names ${digest}`);
91
+ }
92
+ lines.push(` plan ${digest}`);
93
+ out(`${lines.join("\n")}\n\n`);
94
+ // chant#4551: a pending fact cites the change set it was asked for. Read
95
+ // structurally so this compiles before and after that field lands.
96
+ const cited = ofStanding ? standing?.changeSet : undefined;
97
+ const changeSet = typeof cited === "string" ? cited : digest;
98
+ const { CHANGE_SET_DIGEST_PATTERN } = await import("../../workspace/change-set-show.js");
99
+ let shown = false;
100
+ if (CHANGE_SET_DIGEST_PATTERN.test(changeSet)) {
101
+ try {
102
+ const { readStoredChangeSet } = await import("../../lifecycle/change-set-store.js");
103
+ const read = await readStoredChangeSet(changeSet, { cwd });
104
+ if (read.status === "found") {
105
+ const { groupChangeSet, renderPlanSummaryText } = await import("../../plan-summary.js");
106
+ out(renderPlanSummaryText(groupChangeSet(read.document)));
107
+ shown = true;
108
+ }
109
+ else if (read.status === "malformed") {
110
+ err(`The stored plan can't be shown: ${read.message}\n`);
111
+ }
112
+ }
113
+ catch (e) {
114
+ err(`The stored plan can't be read: ${e instanceof Error ? e.message : String(e)}\n`);
115
+ }
116
+ }
117
+ if (!shown) {
118
+ err(`No plan is stored on chant/lifecycle under ${changeSet}. The run that stopped at the gate printed it; ` +
119
+ `the digest above is what this approval binds.\n`);
120
+ }
121
+ const answer = await ask(`\nApprove this plan for ${target}, ${digest}? Type ${target} to approve: `);
122
+ if (answer === null || answer.trim() !== target) {
123
+ err(`Not approved: the answer was not ${target}.\n`);
124
+ return { status: "refused", code: CHANT_EXIT.declined };
125
+ }
126
+ // Read the fact again: what is approved is what the person saw.
127
+ if (opts.plan === undefined) {
128
+ let now;
129
+ try {
130
+ now = standingFact((await readGateLedger(opName)).pending, gate, opts.environment, latestPendingGate);
131
+ }
132
+ catch {
133
+ return { status: "confirmed", plan: digest, target };
134
+ }
135
+ if (now?.planDigest === undefined || !samePlanDigest(now.planDigest, digest)) {
136
+ err(`Not approved: the plan moved while you were asked (now ${now?.planDigest ?? "no pending plan"}); ` +
137
+ `run chant approve ${opName} ${gate} again.\n`);
138
+ return { status: "refused", code: CHANT_EXIT.moved };
139
+ }
140
+ }
141
+ return { status: "confirmed", plan: digest, target };
142
+ }
@@ -1 +1 @@
1
- {"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/approve.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EACuE,KAAK,UAAU,EAC5F,MAAM,6BAA6B,CAAC;AAOrC,OAAO,EAEuC,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAChG,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAiE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAO3H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkDlD,wBAAsB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAqHrE;AAED,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oGAAoG;IACpG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AA0ClB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA0Y9B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,oBAAoB,EAAE,EAC7B,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,OAAO,GAAE,SAAS,iBAAiB,EAA+B,EAClE,KAAK,GAAE,eAAgC,GACtC,MAAM,EAAE,CAuCV"}
1
+ {"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/approve.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EACuE,KAAK,UAAU,EAC5F,MAAM,6BAA6B,CAAC;AAOrC,OAAO,EAEuC,KAAK,mBAAmB,EAAE,KAAK,oBAAoB,EAChG,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAiE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAO3H,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkDlD,wBAAsB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAkIrE;AAED,8DAA8D;AAC9D,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;;;OAOG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oGAAoG;IACpG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,EAAE,EAAE,KAAK,CAAA;CAAE,CAAC;AA0ClB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA8Y9B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,oBAAoB,EAC9B,MAAM,EAAE,oBAAoB,EAC5B,KAAK,EAAE,oBAAoB,EAAE,EAC7B,QAAQ,EAAE,iBAAiB,GAAG,SAAS,EACvC,OAAO,GAAE,SAAS,iBAAiB,EAA+B,EAClE,KAAK,GAAE,eAAgC,GACtC,MAAM,EAAE,CAuCV"}
@@ -137,11 +137,26 @@ export async function runApprove(ctx) {
137
137
  // has applied since #2126 (`../handlers/run.ts`'s `runOpApprove`). Reading
138
138
  // only `--actor` here meant every README that teaches `--approver you`
139
139
  // recorded the shell user instead (#2192).
140
+ // #4575: a person at a terminal sees the plan and types the target's name
141
+ // first, and the approval binds the digest they were shown. --yes, --json,
142
+ // CI and no terminal record as before.
143
+ let plan = ctx.args.plan;
144
+ const confirm = await import("./approve-confirm.js");
145
+ if (await confirm.interactiveApproval(ctx.args)) {
146
+ const answered = await confirm.confirmApproval(opName, gate, {
147
+ ...(plan !== undefined ? { plan } : {}),
148
+ ...(ctx.args.env !== undefined ? { environment: ctx.args.env } : {}),
149
+ });
150
+ if (answered.status === "refused")
151
+ return answered.code;
152
+ if (answered.status === "confirmed")
153
+ plan = answered.plan;
154
+ }
140
155
  const outcome = await recordGateApproval(opName, gate, {
141
156
  actor: ctx.args.approver ?? ctx.args.actor,
142
157
  note: ctx.args.note,
143
158
  url: ctx.args.url,
144
- plan: ctx.args.plan,
159
+ plan,
145
160
  ...(ctx.args.env !== undefined ? { environment: ctx.args.env } : {}),
146
161
  allowSameOrigin: ctx.args.allowSameOrigin,
147
162
  ...(ctx.args.roles ? { roles: ctx.args.roles } : {}),
@@ -340,6 +355,8 @@ export async function recordGateApproval(opName, gate, opts) {
340
355
  // planned for. An approval of that fact's plan is for that release too; an
341
356
  // approval of another plan names none, and no release gate counts it.
342
357
  const releaseDigest = standing?.releaseDigest !== undefined && samePlanDigest(planDigest, standing.planDigest) ? standing.releaseDigest : undefined;
358
+ // #4551: and the change set the fact cites, so the approval names the plans it was asked for.
359
+ const changeSet = standing?.changeSet !== undefined && samePlanDigest(planDigest, standing.planDigest) ? standing.changeSet : undefined;
343
360
  // #4033 (ws-105): a release gate whose release was cut from a revoked
344
361
  // commit is superseded. Its promote refuses the release, so an approval of
345
362
  // it would count for nothing; refuse it here, whatever plan is named.
@@ -557,6 +574,7 @@ export async function recordGateApproval(opName, gate, opts) {
557
574
  ...(checkpointDigest !== undefined ? { checkpointDigest } : {}),
558
575
  ...(environment !== undefined ? { environment } : {}),
559
576
  ...(releaseDigest !== undefined ? { releaseDigest } : {}),
577
+ ...(changeSet !== undefined ? { changeSet } : {}),
560
578
  // #4020: the commit and run the gate waited on, off the fact this approves.
561
579
  ...(standing?.gitSha ? { gitSha: standing.gitSha } : {}),
562
580
  ...(standing?.runId ? { runId: standing.runId } : {}),
@@ -1 +1 @@
1
- {"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/build.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA2PlD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAsJnE"}
1
+ {"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/build.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAsSlD,wBAAsB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAsJnE"}
@@ -8,6 +8,34 @@ import { loadChantConfigUpward } from "../../config.js";
8
8
  import { resolveCliBuildParams, parseParamFlags } from "../build-params-cli.js";
9
9
  import { findWorkspaceRoot } from "../../project-root.js";
10
10
  import { resolvePromotionSource } from "../../components/promote-order.js";
11
+ import { activeProductWords, isChantWords } from "../../ci-product-words.js";
12
+ /**
13
+ * The engine install lines the project's lexicons give (#4550,
14
+ * `LexiconPlugin.ciSetup`), for the default image. A lexicon that cannot
15
+ * load gives none; with none at all the pipeline keeps installing OpenTofu.
16
+ */
17
+ async function engineSetupFor(path) {
18
+ const { loadPlugin, resolveProjectLexicons } = await import("../plugins.js");
19
+ const { engineSetupLines } = await import("../../components/pr-pipeline.js");
20
+ let names;
21
+ try {
22
+ names = await resolveProjectLexicons(path);
23
+ }
24
+ catch {
25
+ return [];
26
+ }
27
+ const lines = [];
28
+ for (const name of names) {
29
+ try {
30
+ const plugin = await loadPlugin(name);
31
+ lines.push(plugin.ciSetup?.({ dir: path }));
32
+ }
33
+ catch {
34
+ // not installed: it gives no lines
35
+ }
36
+ }
37
+ return engineSetupLines(lines);
38
+ }
11
39
  /**
12
40
  * The `prLoop` generator option from `--pr-loop`'s flags (#3183): the gate
13
41
  * and the branch, and with `--events-json` and `--report-url` (#4007) the
@@ -21,9 +49,14 @@ import { resolvePromotionSource } from "../../components/promote-order.js";
21
49
  * `--pr-env` (#4298) adds the jobs of a pull request's environment.
22
50
  * `--apply-before-merge` (#4301) writes the apply job that applies an open
23
51
  * pull request before it merges, beside the record job.
52
+ * `--preview-comment` (#4620) writes the jobs that answer the product's plan
53
+ * comment with a preview of the pull request's head.
24
54
  */
25
55
  function prLoopOption(args, reportUrl, requireReview = false, requireRunnerStart = false) {
56
+ // #4550: a product's bin set its words; the generated jobs answer its comment and run its bin.
57
+ const words = activeProductWords();
26
58
  return {
59
+ ...(isChantWords(words) ? {} : { words }),
27
60
  ...(args.gate ? { gate: args.gate } : {}),
28
61
  ...(args.branch ? { branch: args.branch } : {}),
29
62
  ...(args.eventsJson ? { events: true } : {}),
@@ -35,6 +68,8 @@ function prLoopOption(args, reportUrl, requireReview = false, requireRunnerStart
35
68
  ...(args.applyOnMerge ? { applyOnMerge: true } : {}),
36
69
  ...(args.prEnv ? { prEnvironment: true } : {}),
37
70
  ...(args.applyBeforeMerge ? { applyBeforeMerge: true } : {}),
71
+ ...(args.previewComment ? { previewComment: true } : {}),
72
+ ...(args.requires ? { applyRequires: args.requires } : {}),
38
73
  };
39
74
  }
40
75
  /**
@@ -173,6 +208,13 @@ async function runGenerateComponents(ctx) {
173
208
  if (found && args.prLoop && lexicon !== "gitlab") {
174
209
  locks = (await import("../../workspace/ci-locks.js")).ciLocksAt(resolve(args.path)) === "plan" ? "plan" : undefined;
175
210
  }
211
+ // #4550: the engine lines of the project's lexicons, in place of OpenTofu for every project.
212
+ const engineSetup = args.prLoop && !args.image ? await engineSetupFor(resolve(args.path)) : [];
213
+ // #4552: ci.lockGrain: repo keeps one apply at a time in the repository, read from the declaration like ci.locks.
214
+ let lockGrain;
215
+ if (found && args.prLoop) {
216
+ lockGrain = (await import("../../workspace/ci-lock-grain.js")).ciLockGrainAt(resolve(args.path), undefined, plan?.member.name) === "repo" ? "repo" : undefined;
217
+ }
176
218
  // Which lexicons support generate mode is a property of the loaded lexicon
177
219
  // plugins (those implementing `generateComponentPipeline`, #688), not a
178
220
  // hard-coded core list — `generateComponentsPipeline` returns a descriptive
@@ -191,7 +233,7 @@ async function runGenerateComponents(ctx) {
191
233
  : {}),
192
234
  // #3183: a plan job per pull request and an apply job per merge.
193
235
  // #4292: on the branch ci.branches routes the member to, when it routes it.
194
- ...(args.prLoop ? { prLoop: { ...prLoopOption(args, reportUrl, reviewRules, isolatedRunners), ...(plan?.branch ? { branch: plan.branch } : {}), ...(identity ? { identity } : {}), ...(prEnvIdentity ? { prEnvIdentity } : {}), ...(locks ? { locks } : {}) } } : {}),
236
+ ...(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 } : {}) } } : {}),
195
237
  // #4002: the job image and the lines that install what it lacks, chant itself included.
196
238
  ...(args.image ? { image: args.image } : {}),
197
239
  ...(args.beforeScript?.length ? { beforeScript: args.beforeScript } : {}),
@@ -0,0 +1,3 @@
1
+ import type { CommandContext } from "../registry.js";
2
+ export declare function runCiCheck(ctx: CommandContext): Promise<number>;
3
+ //# sourceMappingURL=ci-check.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ci-check.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/ci-check.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,wBAAsB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBrE"}
@@ -0,0 +1,34 @@
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.js";
10
+ const USAGE = "chant ci check --base <rev> [<target>...] [--output <dir>] [--json]";
11
+ export async function runCiCheck(ctx) {
12
+ const { args } = ctx;
13
+ if (!args.base) {
14
+ 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.` }));
15
+ return 1;
16
+ }
17
+ const targets = (args.positionals ?? []).slice(1);
18
+ const { runCheckHooks } = await import("../../components/check-hooks.js");
19
+ let report;
20
+ try {
21
+ report = runCheckHooks({ base: args.base, targets, ...(args.output ? { dir: args.output } : {}) });
22
+ }
23
+ catch (err) {
24
+ console.error(formatError({ message: err instanceof Error ? err.message : String(err), hint: USAGE }));
25
+ return 1;
26
+ }
27
+ if (args.json)
28
+ console.log(JSON.stringify(report, null, 2));
29
+ else if (report.status === "none")
30
+ console.error("ci check: no ci.hooks.check at base, so nothing ran");
31
+ else
32
+ 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`);
33
+ return report.status === "failed" ? 1 : 0;
34
+ }
@@ -0,0 +1,3 @@
1
+ import type { CommandContext } from "../registry.js";
2
+ export declare function runCiForgeCheck(ctx: CommandContext): Promise<number>;
3
+ //# sourceMappingURL=ci-forge-check.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ci-forge-check.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/ci-forge-check.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAOlD,wBAAsB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAuE1E"}
@@ -0,0 +1,89 @@
1
+ /**
2
+ * `chant ci forge-check [--env <env>] [--member <name>] [--forge <forge>]
3
+ * [--repo <owner/name>] [--branch <default>] [--require-clouds] [--json]`
4
+ * (#4608): read the live forge, the clouds and Pulumi Cloud against the
5
+ * pull-request pipelines `ci.identity.cloud` gives the workspace, one row
6
+ * per expected setting. Read-only. Exits chant's `failed` (1) on a
7
+ * mismatch, or with --require-clouds on a cloud left unchecked; `done` (0)
8
+ * otherwise. See ../../forge-check/index.ts.
9
+ */
10
+ import { formatError } from "../format.js";
11
+ const USAGE = "chant ci forge-check [--env <env>] [--member <name>] [--forge github|gitlab|forgejo] [--repo <owner/name>] [--branch <default>] [--require-clouds] [--json]";
12
+ /** The environment chant's generated pull-request pipelines default to. */
13
+ const DEFAULT_ENV = "production";
14
+ export async function runCiForgeCheck(ctx) {
15
+ const { args } = ctx;
16
+ const [{ forgeCheck, forgeCheckExit, describeForgeCheck, forgeCheckTarget, pipelineContract }, { resolveCloudIdentity }, { CHANT_EXIT }, { activeProductWords }, { findWorkspaceRoot }] = await Promise.all([
17
+ import("../../forge-check/index.js"),
18
+ import("../../ci-identity.js"),
19
+ import("../../exit-codes.js"),
20
+ import("../../ci-product-words.js"),
21
+ import("../../project-root.js"),
22
+ ]);
23
+ const fail = (message) => {
24
+ console.error(formatError({ message, hint: USAGE }));
25
+ return CHANT_EXIT.failed;
26
+ };
27
+ if (args.forge !== undefined && !["github", "gitlab", "forgejo"].includes(args.forge))
28
+ return fail(`--forge is ${args.forge}; give github, gitlab or forgejo`);
29
+ let target;
30
+ try {
31
+ target = forgeCheckTarget(process.env, { ...(args.forge ? { kind: args.forge } : {}), ...(args.ciRepo ? { repo: args.ciRepo } : {}) });
32
+ }
33
+ catch (err) {
34
+ return fail(err instanceof Error ? err.message : String(err));
35
+ }
36
+ const found = findWorkspaceRoot(process.cwd());
37
+ let decl;
38
+ let memberNames = [];
39
+ if (found) {
40
+ const [{ readDeclaration, WorkspaceReadError }, { workingTree }] = await Promise.all([import("../../workspace/declaration.js"), import("../../workspace/tree.js")]);
41
+ try {
42
+ const declaration = readDeclaration(workingTree(found.dir));
43
+ decl = declaration.ci?.identity?.cloud;
44
+ memberNames = (declaration.members ?? []).map((m) => m.name);
45
+ }
46
+ catch (err) {
47
+ if (err instanceof WorkspaceReadError)
48
+ return fail(`${err.describe()} [${err.code}]`);
49
+ throw err;
50
+ }
51
+ }
52
+ const unknown = (args.members ?? []).filter((m) => !memberNames.includes(m));
53
+ if (unknown.length)
54
+ return fail(`--member names ${unknown.join(", ")}, which the workspace declaration does not list`);
55
+ const env = args.env ?? DEFAULT_ENV;
56
+ const members = args.members?.length ? args.members : memberNames.length ? memberNames : [undefined];
57
+ const pipelines = members.flatMap((member) => {
58
+ const identity = resolveCloudIdentity(decl, env, member);
59
+ return identity ? [{ name: member ? `${member}/${env}` : env, identity, ...(member ? { member } : {}) }] : [];
60
+ });
61
+ const words = activeProductWords();
62
+ const host = target.host;
63
+ const result = await forgeCheck({
64
+ target,
65
+ words,
66
+ ...(args.requireClouds ? { requireClouds: true } : {}),
67
+ contract: (live) => pipelineContract({
68
+ forge: target.kind,
69
+ repository: {
70
+ host,
71
+ path: live.path ?? target.repo,
72
+ defaultBranch: args.branch ?? live.defaultBranch ?? "main",
73
+ ...(live.ownerId ? { ownerId: live.ownerId } : {}),
74
+ ...(live.repoId ? { repoId: live.repoId } : {}),
75
+ },
76
+ pipelines,
77
+ words,
78
+ }),
79
+ }, { fetch: globalThis.fetch, env: process.env });
80
+ if (args.json)
81
+ console.log(JSON.stringify(result, null, 2));
82
+ else
83
+ console.log(describeForgeCheck(result));
84
+ if (!decl)
85
+ console.error("ci forge-check: no ci.identity.cloud in the workspace declaration, so no trust was checked");
86
+ else if (pipelines.length === 0)
87
+ console.error(`ci forge-check: no rule of ci.identity.cloud covers environment ${env}, so no trust was checked`);
88
+ return forgeCheckExit(result);
89
+ }