@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,91 @@
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";
11
+ import type { CloudIdentityDeclaration } from "../../ci-identity";
12
+ import type { ForgeFetch } from "../../pr-forge";
13
+ import type { CommandContext } from "../registry";
14
+
15
+ const USAGE = "chant ci forge-check [--env <env>] [--member <name>] [--forge github|gitlab|forgejo] [--repo <owner/name>] [--branch <default>] [--require-clouds] [--json]";
16
+
17
+ /** The environment chant's generated pull-request pipelines default to. */
18
+ const DEFAULT_ENV = "production";
19
+
20
+ export async function runCiForgeCheck(ctx: CommandContext): Promise<number> {
21
+ const { args } = ctx;
22
+ const [{ forgeCheck, forgeCheckExit, describeForgeCheck, forgeCheckTarget, pipelineContract }, { resolveCloudIdentity }, { CHANT_EXIT }, { activeProductWords }, { findWorkspaceRoot }] = await Promise.all([
23
+ import("../../forge-check/index"),
24
+ import("../../ci-identity"),
25
+ import("../../exit-codes"),
26
+ import("../../ci-product-words"),
27
+ import("../../project-root"),
28
+ ]);
29
+ const fail = (message: string): number => {
30
+ console.error(formatError({ message, hint: USAGE }));
31
+ return CHANT_EXIT.failed;
32
+ };
33
+ if (args.forge !== undefined && !["github", "gitlab", "forgejo"].includes(args.forge)) return fail(`--forge is ${args.forge}; give github, gitlab or forgejo`);
34
+ let target;
35
+ try {
36
+ target = forgeCheckTarget(process.env, { ...(args.forge ? { kind: args.forge as "github" | "gitlab" | "forgejo" } : {}), ...(args.ciRepo ? { repo: args.ciRepo } : {}) });
37
+ } catch (err) {
38
+ return fail(err instanceof Error ? err.message : String(err));
39
+ }
40
+
41
+ const found = findWorkspaceRoot(process.cwd());
42
+ let decl: CloudIdentityDeclaration | undefined;
43
+ let memberNames: string[] = [];
44
+ if (found) {
45
+ const [{ readDeclaration, WorkspaceReadError }, { workingTree }] = await Promise.all([import("../../workspace/declaration"), import("../../workspace/tree")]);
46
+ try {
47
+ const declaration = readDeclaration(workingTree(found.dir));
48
+ decl = declaration.ci?.identity?.cloud;
49
+ memberNames = (declaration.members ?? []).map((m) => m.name);
50
+ } catch (err) {
51
+ if (err instanceof WorkspaceReadError) return fail(`${err.describe()} [${err.code}]`);
52
+ throw err;
53
+ }
54
+ }
55
+ const unknown = (args.members ?? []).filter((m) => !memberNames.includes(m));
56
+ if (unknown.length) return fail(`--member names ${unknown.join(", ")}, which the workspace declaration does not list`);
57
+ const env = args.env ?? DEFAULT_ENV;
58
+ const members: (string | undefined)[] = args.members?.length ? args.members : memberNames.length ? memberNames : [undefined];
59
+ const pipelines = members.flatMap((member) => {
60
+ const identity = resolveCloudIdentity(decl, env, member);
61
+ return identity ? [{ name: member ? `${member}/${env}` : env, identity, ...(member ? { member } : {}) }] : [];
62
+ });
63
+ const words = activeProductWords();
64
+ const host = target.host;
65
+ const result = await forgeCheck(
66
+ {
67
+ target,
68
+ words,
69
+ ...(args.requireClouds ? { requireClouds: true } : {}),
70
+ contract: (live) =>
71
+ pipelineContract({
72
+ forge: target.kind,
73
+ repository: {
74
+ host,
75
+ path: live.path ?? target.repo,
76
+ defaultBranch: args.branch ?? live.defaultBranch ?? "main",
77
+ ...(live.ownerId ? { ownerId: live.ownerId } : {}),
78
+ ...(live.repoId ? { repoId: live.repoId } : {}),
79
+ },
80
+ pipelines,
81
+ words,
82
+ }),
83
+ },
84
+ { fetch: globalThis.fetch as unknown as ForgeFetch, env: process.env },
85
+ );
86
+ if (args.json) console.log(JSON.stringify(result, null, 2));
87
+ else console.log(describeForgeCheck(result));
88
+ if (!decl) console.error("ci forge-check: no ci.identity.cloud in the workspace declaration, so no trust was checked");
89
+ else if (pipelines.length === 0) console.error(`ci forge-check: no rule of ci.identity.cloud covers environment ${env}, so no trust was checked`);
90
+ return forgeCheckExit(result);
91
+ }
@@ -334,17 +334,17 @@ describe("proof: a mid-run failure blocks its subtree and leaves the independent
334
334
  });
335
335
  });
336
336
 
337
- describe("a step that refuses its plan because the plan moved exits 3 (#3997)", () => {
338
- test("marked planMoved: exit 3, and its subtree is blocked as for any failure", async () => {
337
+ describe("a step that refuses its plan because the plan moved exits 4 (#3997, #4553)", () => {
338
+ test("marked planMoved: exit 4, and its subtree is blocked as for any failure", async () => {
339
339
  refusal = { "cluster-a": planMovedError("cluster-a") };
340
- expect(await runComponentsFanOut(ctx({ base: "main", env: "test" }))).toBe(3);
340
+ expect(await runComponentsFanOut(ctx({ base: "main", env: "test" }))).toBe(4);
341
341
  expect(ran).not.toContain("app-one");
342
342
  expect(ran).toContain("app-three");
343
343
  });
344
344
 
345
- test("an exitCode of 3 on the step's error is the same mark", async () => {
345
+ test("an exitCode of 3 on the step's error, the moved code before #4553, is the same mark", async () => {
346
346
  refusal = { "cluster-a": exitCodeError("cluster-a", 3) };
347
- expect(await runComponentsFanOut(ctx({ base: "main", env: "test" }))).toBe(3);
347
+ expect(await runComponentsFanOut(ctx({ base: "main", env: "test" }))).toBe(4);
348
348
  });
349
349
 
350
350
  test("any other exitCode is ignored, and the failure exits 1", async () => {
@@ -352,10 +352,10 @@ describe("a step that refuses its plan because the plan moved exits 3 (#3997)",
352
352
  expect(await runComponentsFanOut(ctx({ base: "main", env: "test" }))).toBe(1);
353
353
  });
354
354
 
355
- test("one moved plan beside another failure still exits 3", async () => {
355
+ test("one moved plan beside another failure still exits 4", async () => {
356
356
  refusal = { "cluster-a": planMovedError("cluster-a") };
357
357
  failing = ["cluster-b"];
358
- expect(await runComponentsFanOut(ctx({ base: "main", env: "test" }))).toBe(3);
358
+ expect(await runComponentsFanOut(ctx({ base: "main", env: "test" }))).toBe(4);
359
359
  });
360
360
  });
361
361
 
@@ -601,11 +601,11 @@ describe("gated waves (#3049): one gate per wave, bound to the wave's set digest
601
601
  }
602
602
 
603
603
  test.each([
604
- ["marked planMoved", 3, () => planMovedError("net")],
605
- ["with exitCode 3", 3, () => exitCodeError("net", 3)],
604
+ ["marked planMoved", 4, () => planMovedError("net")],
605
+ ["with exitCode 3", 4, () => exitCodeError("net", 3)],
606
606
  ["with exitCode 7", 1, () => exitCodeError("net", 7)],
607
607
  ["unmarked", 1, () => new Error("net failed")],
608
- ])("an approved wave whose step fails with an error %s exits %i (#3997)", async (_label, code, error) => {
608
+ ])("an approved wave whose step fails with an error %s exits %i (#3997, #4553)", async (_label, code, error) => {
609
609
  const run = () => runComponentsFanOut(ctx({ base: "main", env: "test", waveGate: "release" }));
610
610
  await approveWave1(run);
611
611
  refusal = { net: error() };
@@ -458,10 +458,15 @@ async function fanOut(ctx: CommandContext, projectPath: string, config: ChantCon
458
458
  // wave and apply as one group; under --wave-gate none forms (ruling 1).
459
459
  const runPlan = await formRunGroups({ components: derived.components, plan: derived.plan, registry, env, ...(waveGate ? { waveGate: true } : {}) });
460
460
 
461
+ // #4594: ci.lockGrain, and on the resource grain the row lease each step, group or gated wave takes in the pull-request loop's rows file.
462
+ const { applyLeaseOptions } = await import("../../components/apply-lease");
463
+ const leasing = await applyLeaseOptions(process.cwd());
464
+
461
465
  let result;
462
466
  try {
463
467
  result = await runFanOut(runPlan, derived.components, registry, {
464
468
  env,
469
+ ...leasing,
465
470
  ...(runPlan.groups?.length ? { planGroupsAtWave: true } : {}),
466
471
  releaseIdentity: () => (revision ? { revision } : {}),
467
472
  componentOutputs,
@@ -0,0 +1,46 @@
1
+ /**
2
+ * `chant run pending --plan <digest> [--op <op>] [--json]` (#4607): the
3
+ * standing pending gates waiting on a plan digest, with the pull request a
4
+ * pull request gate belongs to. A product's approve verb runs it (or calls
5
+ * `pendingGatesByPlan` from `@intentius/chant/ci-product`) to find the op and
6
+ * gate a digest waits at, so a person types the digest the note showed and
7
+ * nothing else.
8
+ */
9
+
10
+ import type { CommandContext } from "../registry";
11
+ import { formatError, formatInfo } from "../format";
12
+ import { requireLifecycleLedger } from "../../lifecycle/git";
13
+ import { pendingGatesByPlan, type PendingGateByPlan } from "../../lifecycle/gate-pending-by-plan";
14
+
15
+ function describe(g: PendingGateByPlan): string {
16
+ const where = g.pr !== undefined ? ` (pull request ${g.pr}${g.member ? `, member ${g.member}` : ""})` : "";
17
+ const env = g.environment ? ` in ${g.environment}` : "";
18
+ const by = g.matched === "changeSet" ? " by its change set" : "";
19
+ return `${g.op} / ${g.gate}${env}${where} waits on this plan${by}, since ${g.timestamp}, until ${g.expiresAt}`;
20
+ }
21
+
22
+ export async function runPendingCommand(ctx: CommandContext): Promise<number> {
23
+ const { args } = ctx;
24
+ const digest = args.plan;
25
+ if (!digest) {
26
+ console.error(formatError({ message: "chant run pending needs the digest a plan printed: --plan <digest>" }));
27
+ return 1;
28
+ }
29
+ try {
30
+ await requireLifecycleLedger();
31
+ } catch (err) {
32
+ console.error(formatError({ message: `Cannot read the gate ledgers: ${err instanceof Error ? err.message : String(err)}` }));
33
+ return 1;
34
+ }
35
+ const gates = await pendingGatesByPlan(digest, args.op ? { op: args.op } : {});
36
+ if (args.json) {
37
+ console.log(JSON.stringify({ plan: digest, gates }, null, 2));
38
+ return 0;
39
+ }
40
+ if (gates.length === 0) {
41
+ console.error(formatInfo(`No gate is waiting on ${digest}: it was approved, it expired, or no run reached a gate with it.`));
42
+ return 0;
43
+ }
44
+ for (const g of gates) console.error(formatInfo(describe(g)));
45
+ return 0;
46
+ }
@@ -22,6 +22,7 @@ export async function runInit(ctx: CommandContext): Promise<number> {
22
22
  skill: args.skill,
23
23
  force: args.force,
24
24
  skipMcp: args.skipMcp,
25
+ mcpReadOnly: args.mcpReadOnly,
25
26
  skipInstall: true,
26
27
  });
27
28
  await printInitResult(result, { skipInstall: false, cwd: args.path });
@@ -11,7 +11,7 @@ import { formatError, formatWarning } from "../format";
11
11
  import type { CommandContext } from "../registry";
12
12
  import { queryLedgers } from "./query";
13
13
 
14
- const USAGE = "chant ledger <resources|snapshots|runs|gates|deploys|releases|cuts> [dir] [--member <name>] [--where <field><op><value>]... [--since <time>] [--at <rev>] [--json]";
14
+ const USAGE = "chant ledger <resources|snapshots|runs|gates|deploys|releases|cuts|applies|pr_envs|control_entries|release_status> [dir] [--member <name>] [--where <field><op><value>]... [--since <time>] [--at <rev>] [--json]";
15
15
 
16
16
  const cell = (v: unknown): string => (v === null || v === undefined ? "" : typeof v === "object" ? JSON.stringify(v) : String(v));
17
17
 
@@ -20,13 +20,18 @@
20
20
  */
21
21
 
22
22
  import { basename, resolve } from "node:path";
23
+ import { CHANT_EXIT } from "../../exit-codes";
23
24
  import { loadChantConfig } from "../../config";
24
25
  import { DRIFT_READS, encodeDriftLine, type DriftLine, type DriftRead, type ReadDriftRefusalCode } from "../../drift-record";
25
26
  import { formatError } from "../format";
26
27
  import type { CommandContext } from "../registry";
27
28
 
28
- /** The exit status of a refused read. */
29
- export const DRIFT_REFUSED_EXIT = 3;
29
+ /**
30
+ * The exit status of a refused read: `CHANT_EXIT.failed` (#4553; 3 before).
31
+ * The `{"refused": ...}` line on stdout says why, and `chant workspace drift`
32
+ * reads that line, so the code carries nothing more.
33
+ */
34
+ export const DRIFT_REFUSED_EXIT = CHANT_EXIT.failed;
30
35
 
31
36
  const USAGE = "chant lifecycle drift [--member <name>] [--read <state|plan|refresh|live-read|ownership>] [--resource <addr>]";
32
37
 
@@ -58,13 +58,13 @@ afterEach(() => {
58
58
  });
59
59
 
60
60
  describe("chant lock and chant unlock", () => {
61
- test("lock takes named targets, a second pull request exits 3 naming the holder, unlock frees them", async () => {
61
+ test("lock takes named targets, a second pull request exits 5 naming the holder, unlock frees them", async () => {
62
62
  const taken = await run(["lock", "web", "api", "--pr", "1", "--by", "alice", "--json"]);
63
63
  expect(taken.code).toBe(0);
64
64
  expect(JSON.parse(taken.out)).toMatchObject({ gate: "pr-apply", pr: 1, ok: true, stage: "lock", taken: ["api", "web"] });
65
65
 
66
66
  const held = await run(["lock", "web", "--pr", "2", "--by", "bob"]);
67
- expect(held.code).toBe(3);
67
+ expect(held.code).toBe(5);
68
68
  expect(held.err).toContain("web is locked by pull request 1 (locked with chant lock by alice), so pull request 2 is not locked");
69
69
 
70
70
  const listed = await run(["lock", "--list", "--json"]);
@@ -88,6 +88,33 @@ describe("chant lock and chant unlock", () => {
88
88
  expect(wrong.err).toContain("is the report of pull request 4, not 5");
89
89
  });
90
90
 
91
+ test("--list shows the apply rows of the gate with the run that holds each (#4594)", async () => {
92
+ const { takeLockRows } = await import("../../lifecycle/resource-lock");
93
+ const holder = { run: "4711", at: "2026-10-27T10:00:00.000Z", url: "https://forge.example/acme/infra/actions/runs/4711" };
94
+ const rows = [
95
+ { key: "urn urn:pulumi:dev::site::aws:s3/bucket:Bucket::logs", target: "site", address: "logs" },
96
+ { key: "estate e01 aws_s3_bucket.logs", target: "e01", address: "aws_s3_bucket.logs" },
97
+ ];
98
+ expect(await takeLockRows("pr-apply", rows, holder, { cwd: repo, alive: async () => "alive" })).toMatchObject({ ok: true });
99
+
100
+ const text = await run(["lock", "--list"]);
101
+ expect(text.code).toBe(0);
102
+ expect(text.out).toContain("estate e01 aws_s3_bucket.logs\trun 4711\t2026-10-27T10:00:00.000Z\thttps://forge.example/acme/infra/actions/runs/4711");
103
+ expect(text.out).toContain("urn urn:pulumi:dev::site::aws:s3/bucket:Bucket::logs\trun 4711");
104
+ expect(text.err).toContain("no target locks on pr-apply");
105
+
106
+ const json = JSON.parse((await run(["lock", "--list", "--json"])).out);
107
+ expect(json.rowsPath).toBe("_locks/rows/pr-apply.json");
108
+ expect(Object.keys(json.rows)).toEqual(["estate e01 aws_s3_bucket.logs", "urn urn:pulumi:dev::site::aws:s3/bucket:Bucket::logs"]);
109
+ expect(json.rows["estate e01 aws_s3_bucket.logs"]).toEqual(holder);
110
+ });
111
+
112
+ test("--list says no apply rows are held when the rows file is empty (#4594)", async () => {
113
+ const listed = await run(["lock", "--list", "--json"]);
114
+ expect(JSON.parse(listed.out)).toMatchObject({ gate: "pr-apply", rows: {} });
115
+ expect((await run(["lock", "--list"])).err).toContain("no apply rows held on pr-apply");
116
+ });
117
+
91
118
  test("refuses without --pr or targets, an unknown stage, and a gate that is not a file name", async () => {
92
119
  expect((await run(["lock", "web"])).err).toContain("--pr <n>");
93
120
  expect((await run(["lock", "--pr", "1"])).err).toContain("needs the targets");
@@ -5,7 +5,9 @@
5
5
  * ```
6
6
  * chant lock <target>... --pr <n> [--stage plan|apply|lock] [--head <sha>] [--by <who>] [--gate <name>] [--forge <kind>] [--json]
7
7
  * chant lock --from-report <pr-plan.json> --pr <n> [--stage plan] [--forge <kind>] [--json]
8
+ * chant lock --keep --pr <n> [--head <sha>] [--gate <name>] [--forge <kind>] [--json]
8
9
  * chant lock --list [--gate <name>] [--json]
10
+ * chant lock --alive <run>
9
11
  * chant unlock --pr <n> [<target>...] [--gate <name>] [--json]
10
12
  * ```
11
13
  *
@@ -13,7 +15,25 @@
13
15
  * which are what `pr-apply` checks under `ci.locks`, or any other name a
14
16
  * pipeline locks by. `--from-report` reads them from a pull-request report
15
17
  * (`selection.waves`), so a lock job that runs the target branch's code can
16
- * lock what the plan job, which ran the pull request's code, selected.
18
+ * lock what the plan job, which ran the pull request's code, selected. When
19
+ * a member is on the resource lock grain (#4552) the report carries
20
+ * `lockTargets`, its row keys, and those are locked instead.
21
+ *
22
+ * `--list` prints the target locks, then the apply rows of the gate's rows
23
+ * file (#4552, #4594), each with the run that holds it and when it took it.
24
+ *
25
+ * `--keep` (#4588) takes again, at stage `lock`, every lock the pull request
26
+ * holds now: the components (or row keys) its plan locked under `ci.locks:
27
+ * plan`. A plan lock is let go when a later plan no longer reaches the
28
+ * target; a kept one stays until the pull request closes or `chant unlock`.
29
+ * It is what a `/<product> lock` comment runs, on the target branch's
30
+ * commit, so no code of the change runs. A pull request that holds no lock
31
+ * yet fails with a line saying its plan has to run first.
32
+ *
33
+ * `--alive <run>` prints `alive` or `dead` for a run that holds rows or the
34
+ * Forgejo repo lock tag (#4552): `dead` when the forge says the run
35
+ * finished, `alive` while it runs or when nobody can say. The lock tag's
36
+ * shell asks it before taking a lease over.
17
37
  *
18
38
  * `--forge` reads which holders are still open, so a lock whose pull
19
39
  * request merged or closed is taken over, and, with `--head`, posts the
@@ -23,6 +43,7 @@
23
43
  * request holds a target (nothing is locked), 1 on an error.
24
44
  */
25
45
  import { readFileSync } from "node:fs";
46
+ import { CHANT_EXIT } from "../../exit-codes";
26
47
  import { resolve } from "node:path";
27
48
  import type { CommandContext } from "../registry";
28
49
  import { formatError, formatInfo, formatSuccess, formatWarning } from "../format";
@@ -39,8 +60,8 @@ import {
39
60
  type TargetLockStage,
40
61
  } from "../../lifecycle/target-lock";
41
62
 
42
- /** The exit for a target another open pull request holds: 3, as a run stopped at a gate exits (`GATED_EXIT_CODE` in ./run.ts). */
43
- const HELD_EXIT_CODE = 3;
63
+ /** The exit for a target another open pull request holds: `CHANT_EXIT.held`, 5 (#4553). */
64
+ const HELD_EXIT_CODE = CHANT_EXIT.held;
44
65
 
45
66
  /** The status `chant lock --head <sha> --forge <kind>` posts. */
46
67
  export const LOCK_STATUS_CONTEXT = "chant/lock";
@@ -76,13 +97,17 @@ const prName = (forge: PrForge | undefined) => (n: number) => (forge?.kind === "
76
97
 
77
98
  /** The components a `pr-plan.json` selected, and the head it planned, checked against `--pr`. */
78
99
  function fromReport(file: string, pr: number): { targets: string[]; head?: string } | { error: string } {
79
- let doc: { pr?: unknown; head?: unknown; selection?: { waves?: unknown } };
100
+ let doc: { pr?: unknown; head?: unknown; selection?: { waves?: unknown }; lockTargets?: unknown };
80
101
  try {
81
102
  doc = JSON.parse(readFileSync(resolve(file), "utf8"));
82
103
  } catch (err) {
83
104
  return { error: `--from-report: could not read "${file}": ${err instanceof Error ? err.message : String(err)}` };
84
105
  }
85
106
  if (doc.pr !== pr) return { error: `--from-report: "${file}" is the report of ${doc.pr === null || doc.pr === undefined ? "no pull request" : `pull request ${String(doc.pr)}`}, not ${pr}` };
107
+ // #4552: a member on the resource grain locks its row keys, which the report lists.
108
+ if (Array.isArray(doc.lockTargets) && doc.lockTargets.every((t) => typeof t === "string" && t !== "")) {
109
+ return { targets: doc.lockTargets as string[], ...(typeof doc.head === "string" ? { head: doc.head } : {}) };
110
+ }
86
111
  const waves = doc.selection?.waves;
87
112
  if (!Array.isArray(waves) || !waves.every((w) => Array.isArray(w) && w.every((n) => typeof n === "string"))) {
88
113
  return { error: `--from-report: "${file}" has no selection.waves; pass a pr-plan.json that chant components pr-plan wrote` };
@@ -105,21 +130,45 @@ export async function runLock(ctx: CommandContext): Promise<number> {
105
130
  const gate = gateOf(ctx);
106
131
  if (typeof gate !== "string") return fail(gate.error);
107
132
 
133
+ if (args.aliveRun !== undefined) {
134
+ const { forgeLockLiveness } = await import("../../lifecycle/resource-lock");
135
+ // The lease's age is the caller's to judge (the tag carries its own), so only the forge and the process are asked here.
136
+ const verdict = await forgeLockLiveness(process.env)({ run: args.aliveRun, at: new Date().toISOString() });
137
+ console.log(verdict);
138
+ return 0;
139
+ }
140
+
108
141
  if (args.list) {
109
142
  if (targetsOf(ctx).length > 0 || args.pr !== undefined) return fail("--list prints every lock; drop the targets and --pr");
110
143
  let file;
144
+ let held;
111
145
  try {
112
146
  file = await readTargetLocks(gate);
147
+ // #4594: the apply rows of the gate (#4552), each with the run that holds it.
148
+ const { readLockRows } = await import("../../lifecycle/resource-lock");
149
+ held = await readLockRows(gate);
113
150
  } catch (err) {
114
151
  return fail(err instanceof Error ? err.message : String(err));
115
152
  }
116
153
  const rows = Object.entries(file.locks).sort(([a], [b]) => a.localeCompare(b));
154
+ const leased = Object.entries(held.rows)
155
+ .sort(([a], [b]) => a.localeCompare(b))
156
+ .map(([key, run]) => ({ key, holder: held.holders[run]! }));
117
157
  if (args.json) {
118
- console.log(JSON.stringify({ gate, path: await targetLockPathAt(gate), locks: Object.fromEntries(rows) }, null, 2));
158
+ const { lockRowsPath } = await import("../../lifecycle/resource-lock");
159
+ console.log(
160
+ JSON.stringify(
161
+ { gate, path: await targetLockPathAt(gate), locks: Object.fromEntries(rows), rowsPath: lockRowsPath(gate), rows: Object.fromEntries(leased.map((r) => [r.key, r.holder])) },
162
+ null,
163
+ 2,
164
+ ),
165
+ );
119
166
  return 0;
120
167
  }
121
168
  if (rows.length === 0) console.error(formatInfo(`no target locks on ${gate}`));
122
169
  for (const [target, l] of rows) console.log(`${target}\tpull request ${l.pr}\t${l.stage}\t${l.by}\t${l.at}`);
170
+ if (leased.length === 0) console.error(formatInfo(`no apply rows held on ${gate}`));
171
+ for (const { key, holder } of leased) console.log(`${key}\trun ${holder.run}\t${holder.at}${holder.url ? `\t${holder.url}` : ""}`);
123
172
  return 0;
124
173
  }
125
174
 
@@ -129,7 +178,18 @@ export async function runLock(ctx: CommandContext): Promise<number> {
129
178
 
130
179
  let targets = targetsOf(ctx);
131
180
  let head = args.head;
132
- if (args.fromReport) {
181
+ if (args.keepLocks) {
182
+ if (targets.length > 0 || args.fromReport) return fail("--keep keeps the locks the pull request holds; drop the names and --from-report");
183
+ let file;
184
+ try {
185
+ file = await readTargetLocks(gate);
186
+ } catch (err) {
187
+ return fail(err instanceof Error ? err.message : String(err));
188
+ }
189
+ targets = Object.entries(file.locks).filter(([, l]) => l.pr === args.pr).map(([target]) => target).sort();
190
+ head ??= Object.values(file.locks).find((l) => l.pr === args.pr)?.head;
191
+ if (targets.length === 0) return fail(`pull request ${args.pr} holds no lock on ${gate} yet, so there is nothing to keep`, "Its plan takes the locks under ci.locks: plan; comment again once the plan job ran.");
192
+ } else if (args.fromReport) {
133
193
  if (targets.length > 0) return fail("--from-report reads the targets from the report; drop the names");
134
194
  const read = fromReport(args.fromReport, args.pr);
135
195
  if ("error" in read) return fail(read.error);
@@ -0,0 +1,130 @@
1
+ /**
2
+ * `chant notify relay` (#4611): serve the relay that turns a chat click into
3
+ * a `chant approve` (../../notify-relay.ts), from a checkout of the repo.
4
+ *
5
+ * ```
6
+ * CHANT_RELAY_KEY=... SLACK_SIGNING_SECRET=... chant notify relay
7
+ * ```
8
+ *
9
+ * Settings come from the environment (`RELAY_ENV`), as a container or
10
+ * function host sets them: the relay key, the Slack signing secret, the
11
+ * Teams HMAC key, the relay's principal (default `<product>-relay`), the
12
+ * maximum age of a button (default a day), and the host and port (default
13
+ * 127.0.0.1:8787). The relay refuses to start with neither chat secret, or
14
+ * with no relay key, since it could then verify nothing.
15
+ *
16
+ * Each click fetches `chant/lifecycle`, reads the signers file at base, and
17
+ * records through `recordGateApproval`, one click at a time, so two clicks
18
+ * never race on the ledger.
19
+ */
20
+ import { activeProductWords } from "../../ci-product-words";
21
+ import { CHANT_EXIT } from "../../exit-codes";
22
+ import { DEFAULT_RELAY_MAX_AGE_SECONDS } from "../../notify";
23
+ import { DEFAULT_RELAY_HOST, DEFAULT_RELAY_PORT, RELAY_ENV, startRelayServer, type RelayDeps, type RelayPending, type RelaySettings } from "../../notify-relay";
24
+ import { formatError, formatInfo } from "../format";
25
+ import type { CommandContext } from "../registry";
26
+
27
+ /** The relay's settings, read from `env`, or the first problem with them. */
28
+ export function relaySettingsFromEnv(env: NodeJS.ProcessEnv): { settings: RelaySettings; host: string; port: number } | { error: string } {
29
+ const key = env[RELAY_ENV.key];
30
+ if (!key) return { error: `${RELAY_ENV.key} is not set; it holds the key notify signs the buttons with (notify.relay on the sending side)` };
31
+ const slackSecret = env[RELAY_ENV.slackSecret] || undefined;
32
+ const teamsSecret = env[RELAY_ENV.teamsSecret] || undefined;
33
+ if (!slackSecret && !teamsSecret) return { error: `set ${RELAY_ENV.slackSecret}, ${RELAY_ENV.teamsSecret} or both, so the relay can verify a click` };
34
+ const maxAgeText = env[RELAY_ENV.maxAge];
35
+ const maxAge = maxAgeText === undefined || maxAgeText === "" ? DEFAULT_RELAY_MAX_AGE_SECONDS : Number(maxAgeText);
36
+ if (!Number.isInteger(maxAge) || maxAge <= 0) return { error: `${RELAY_ENV.maxAge} is a whole number of seconds (got ${JSON.stringify(maxAgeText)})` };
37
+ const portText = env[RELAY_ENV.port];
38
+ const port = portText === undefined || portText === "" ? DEFAULT_RELAY_PORT : Number(portText);
39
+ if (!Number.isInteger(port) || port < 0 || port > 65535) return { error: `${RELAY_ENV.port} is a port number (got ${JSON.stringify(portText)})` };
40
+ const slackResponse = env[RELAY_ENV.slackResponse]?.split(",").map((s) => s.trim()).filter(Boolean);
41
+ return {
42
+ settings: { key, ...(slackSecret ? { slackSecret } : {}), ...(teamsSecret ? { teamsSecret } : {}), maxAgeSeconds: maxAge, ...(slackResponse?.length ? { slackResponse } : {}) },
43
+ host: env[RELAY_ENV.host] || DEFAULT_RELAY_HOST,
44
+ port,
45
+ };
46
+ }
47
+
48
+ /** One at a time: each click's ledger read and write finish before the next starts. */
49
+ function serial(): <T>(fn: () => Promise<T>) => Promise<T> {
50
+ let tail: Promise<unknown> = Promise.resolve();
51
+ return <T>(fn: () => Promise<T>) => {
52
+ const run = tail.then(fn, fn);
53
+ tail = run.catch(() => undefined);
54
+ return run;
55
+ };
56
+ }
57
+
58
+ /** The relay's reads and writes against the checkout at `cwd`. */
59
+ export function checkoutRelayDeps(cwd: string, principal: string): RelayDeps {
60
+ const words = activeProductWords();
61
+ const one = serial();
62
+ return {
63
+ principal,
64
+ words,
65
+ async signers() {
66
+ const { scopeSource } = await import("../../workspace/write-scope");
67
+ const policy = scopeSource(cwd).policy;
68
+ return { signers: policy.signers, path: policy.signersPath };
69
+ },
70
+ pending: (digest) =>
71
+ one(async () => {
72
+ const { fetchLifecycle } = await import("../../lifecycle/git");
73
+ const { pendingGatesByPlan } = await import("../../lifecycle/gate-pending-by-plan");
74
+ const { readGateLedger } = await import("../../lifecycle/gate-ledger");
75
+ const { latestPendingGate } = await import("../../lifecycle/gate-ledger-select");
76
+ await fetchLifecycle({ cwd });
77
+ const out: RelayPending[] = [];
78
+ for (const p of await pendingGatesByPlan(digest, { cwd })) {
79
+ const digestAsked = p.planDigest ?? p.changeSet;
80
+ if (!digestAsked) continue;
81
+ const fact = latestPendingGate((await readGateLedger(p.op, { cwd })).pending.filter((f) => f.environment === p.environment), p.gate);
82
+ out.push({ op: p.op, gate: p.gate, digest: digestAsked, ...(p.environment !== undefined ? { environment: p.environment } : {}), ...(fact?.request ? { request: fact.request } : {}) });
83
+ }
84
+ return out;
85
+ }),
86
+ approve: (input) =>
87
+ one(async () => {
88
+ const { recordGateApproval } = await import("./approve");
89
+ // chant approve prints why it refused; the relay sends that line to the thread.
90
+ const said: string[] = [];
91
+ const was = console.error;
92
+ console.error = (...parts: unknown[]) => {
93
+ said.push(parts.map(String).join(" "));
94
+ was(...parts);
95
+ };
96
+ try {
97
+ const out = await recordGateApproval(input.op, input.gate, {
98
+ origin: "cli",
99
+ actor: input.actor,
100
+ relayedBy: input.relayedBy,
101
+ plan: input.digest,
102
+ ...(input.environment !== undefined ? { environment: input.environment } : {}),
103
+ cwd,
104
+ });
105
+ if (out.ok) return { ok: true as const };
106
+ // eslint-disable-next-line no-control-regex
107
+ const reason = said.map((l) => l.replace(/\u001b\[[0-9;]*m/g, "").trim()).filter(Boolean)[0];
108
+ return { ok: false as const, error: reason ?? `chant approve ${input.op} ${input.gate} refused the approval` };
109
+ } finally {
110
+ console.error = was;
111
+ }
112
+ }),
113
+ };
114
+ }
115
+
116
+ /** `chant notify relay`. Runs until the process is stopped. */
117
+ export async function runNotifyRelay(_ctx: CommandContext): Promise<number> {
118
+ const read = relaySettingsFromEnv(process.env);
119
+ if ("error" in read) {
120
+ console.error(formatError({ message: `chant notify relay did not start: ${read.error}` }));
121
+ return CHANT_EXIT.failed;
122
+ }
123
+ const words = activeProductWords();
124
+ const principal = process.env[RELAY_ENV.principal]?.trim() || `${words.product}-relay`;
125
+ const deps = checkoutRelayDeps(process.cwd(), principal);
126
+ const { url } = await startRelayServer(read.settings, deps, { host: read.host, port: read.port, log: (line) => console.error(formatInfo(line)) });
127
+ console.error(formatInfo(`${words.product} notify relay listens at ${url} (POST /slack, POST /teams, GET /healthz), recording approvals relayed by ${principal}`));
128
+ await new Promise<void>(() => {});
129
+ return 0;
130
+ }
@@ -270,7 +270,8 @@ describe("pr-apply --before-merge (#4301)", () => {
270
270
  onRun = (r) => void ran.push(r);
271
271
  expect(await runComponentsPrApply(ctx({}))).toBe(0);
272
272
  expect(ran).toEqual(["net", "app"]);
273
- expect(taken).toEqual([{ gate: "pr-apply", targets: ["net", "app"], holder: expect.objectContaining({ pr: 12, stage: "apply", head: HEAD }) }]);
273
+ // #4552: the lock targets go to the lock file sorted (lockTargetsOf).
274
+ expect(taken).toEqual([{ gate: "pr-apply", targets: ["app", "net"], holder: expect.objectContaining({ pr: 12, stage: "apply", head: HEAD }) }]);
274
275
  expect(await applyReport()).toMatchObject({ status: "applied", beforeMerge: { requires: expect.any(Array) } });
275
276
  });
276
277
  });
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * #4155: a pull request's approval binds the files a step without a `plan`
3
3
  * deploys from. A chart changed after approval, or a function's sources
4
- * beside a planning step, moves the digest and pr-apply exits 3. A build
4
+ * beside a planning step, moves the digest and pr-apply exits 4 (moved, #4553). A build
5
5
  * whose output differs every time does not.
6
6
  */
7
7
 
@@ -148,10 +148,10 @@ describe("a Helm chart changed after approval (#4155)", () => {
148
148
  expect(await runComponentsPrApply(ctx({ pr: 12 }))).toBe(0);
149
149
  });
150
150
 
151
- test("a file in the chart changed: pr-apply exits 3 and applies nothing", async () => {
151
+ test("a file in the chart changed: pr-apply exits 4 and applies nothing", async () => {
152
152
  await planAndApprove();
153
153
  await write("chart/templates/deployment.yaml", "replicas: 20\n");
154
- expect(await runComponentsPrApply(ctx({ pr: 12 }))).toBe(3);
154
+ expect(await runComponentsPrApply(ctx({ pr: 12 }))).toBe(4);
155
155
  const report = JSON.parse(await readFile(join(dir, "pr-apply.json"), "utf8"));
156
156
  expect(report.status).not.toBe("applied");
157
157
  });
@@ -159,10 +159,10 @@ describe("a Helm chart changed after approval (#4155)", () => {
159
159
  test("a file added to the chart, or a changed values file, does the same", async () => {
160
160
  await planAndApprove();
161
161
  await write("chart/templates/service.yaml", "port: 80\n");
162
- expect(await runComponentsPrApply(ctx({ pr: 12 }))).toBe(3);
162
+ expect(await runComponentsPrApply(ctx({ pr: 12 }))).toBe(4);
163
163
  await planAndApprove();
164
164
  await write("values-prod.yaml", "image: other\n");
165
- expect(await runComponentsPrApply(ctx({ pr: 12 }))).toBe(3);
165
+ expect(await runComponentsPrApply(ctx({ pr: 12 }))).toBe(4);
166
166
  });
167
167
  });
168
168
 
@@ -186,10 +186,10 @@ describe("a function's sources beside a planning step (#4155)", () => {
186
186
  expect(JSON.stringify(plan)).toContain("api#inputs");
187
187
  });
188
188
 
189
- test("a changed source moves the digest: pr-apply exits 3", async () => {
189
+ test("a changed source moves the digest: pr-apply exits 4", async () => {
190
190
  await planAndApprove();
191
191
  await write("fn/index.js", "export const handler = () => 2;\n");
192
- expect(await runComponentsPrApply(ctx({ pr: 12 }))).toBe(3);
192
+ expect(await runComponentsPrApply(ctx({ pr: 12 }))).toBe(4);
193
193
  });
194
194
 
195
195
  test("an unchanged rebuild whose output differs every run still applies under the approval", async () => {