@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,162 @@
1
+ /**
2
+ * The token Terraform and OpenTofu send to a host (chant#4563), found the way
3
+ * the CLIs find it:
4
+ *
5
+ * 1. `TF_TOKEN_<host>`: the host in its comparison form (lower case, punycode
6
+ * for an internationalised name, port 443 dropped), dots written `_` and
7
+ * dashes `__`. A variable whose name decodes to the host matches too, so
8
+ * `TF_TOKEN_App_Terraform_Io` is read for app.terraform.io, as the CLIs
9
+ * read it. A host with another port has no variable form.
10
+ * 2. A `credentials "<host>" { token = "..." }` block in the CLI config file
11
+ * `TF_CLI_CONFIG_FILE` names (HCL, or the same shape in JSON).
12
+ * 3. `credentials.tfrc.json` at the CLI's default path:
13
+ * `$HOME/.terraform.d/credentials.tfrc.json`, or
14
+ * `%APPDATA%\terraform.d\credentials.tfrc.json` on Windows.
15
+ *
16
+ * The variable wins over both files. Credential helpers are not run.
17
+ *
18
+ * This sits in core, not in the terraform lexicon, because core's own import
19
+ * code (`workspace init --from tfc`) reads the same token and core does not
20
+ * depend on the lexicon. The lexicon's registry reader imports it from here.
21
+ *
22
+ * A token found here is only ever put in an `Authorization` header. The
23
+ * `from` this module reports names the variable or the file, never the value.
24
+ */
25
+
26
+ import { existsSync, readFileSync } from "node:fs";
27
+ import { join } from "node:path";
28
+
29
+ /** Where the lookup reads: the environment, and how a file is read (a test passes a map). */
30
+ export interface CredentialsOptions {
31
+ /** Default `process.env`. `HOME` (or `APPDATA` on Windows) in it locates the default credentials file; without it that file is skipped. */
32
+ env?: Record<string, string | undefined>;
33
+ /** Reads a file's text, or undefined when it is missing. Default: the file system. */
34
+ readFile?: (path: string) => string | undefined;
35
+ /** Default `process.platform`. */
36
+ platform?: string;
37
+ }
38
+
39
+ /** A token and where it was found: a variable's name or a file's path. */
40
+ export interface TerraformCredential {
41
+ token: string;
42
+ from: string;
43
+ }
44
+
45
+ /**
46
+ * The host in the form the CLIs compare credentials by: lower case, an
47
+ * internationalised name in punycode, and the default port 443 dropped.
48
+ * Undefined when the text is not a host.
49
+ */
50
+ export function credentialsHost(host: string): string | undefined {
51
+ const raw = host.trim().replace(/^[a-z][a-z0-9+.-]*:\/\//i, "").split("/")[0]!;
52
+ if (!raw) return undefined;
53
+ try {
54
+ const u = new URL(`https://${raw}`);
55
+ if (u.username || u.password) return undefined;
56
+ return u.port && u.port !== "443" ? `${u.hostname}:${u.port}` : u.hostname;
57
+ } catch {
58
+ return undefined;
59
+ }
60
+ }
61
+
62
+ /**
63
+ * The variable a host's token is read from: `TF_TOKEN_` and the host with
64
+ * dashes written `__` and dots `_`. Undefined for a host with a port other
65
+ * than 443, which only the credentials file can name.
66
+ */
67
+ export function tokenVariable(host: string): string | undefined {
68
+ const h = credentialsHost(host);
69
+ if (!h || h.includes(":")) return undefined;
70
+ return `TF_TOKEN_${h.replace(/-/g, "__").replace(/\./g, "_")}`;
71
+ }
72
+
73
+ /** The host a `TF_TOKEN_` variable's name stands for, in comparison form. */
74
+ const hostOfVariable = (name: string): string | undefined => {
75
+ const rest = name.slice("TF_TOKEN_".length);
76
+ if (!rest) return undefined;
77
+ return credentialsHost(rest.replace(/__/g, "\u0000").replace(/_/g, ".").replace(/\u0000/g, "-"));
78
+ };
79
+
80
+ const defaultReadFile = (path: string): string | undefined => {
81
+ try {
82
+ return existsSync(path) ? readFileSync(path, "utf-8") : undefined;
83
+ } catch {
84
+ return undefined;
85
+ }
86
+ };
87
+
88
+ /** The default credentials.tfrc.json path, or undefined when the environment names no home. */
89
+ export function credentialsFilePath(options: CredentialsOptions = {}): string | undefined {
90
+ const env = options.env ?? process.env;
91
+ const platform = options.platform ?? process.platform;
92
+ if (platform === "win32") return env.APPDATA ? join(env.APPDATA, "terraform.d", "credentials.tfrc.json") : undefined;
93
+ return env.HOME ? join(env.HOME, ".terraform.d", "credentials.tfrc.json") : undefined;
94
+ }
95
+
96
+ /** The token a credentials map gives a host, matching keys in comparison form. */
97
+ const tokenIn = (credentials: unknown, host: string): string | undefined => {
98
+ if (!credentials || typeof credentials !== "object") return undefined;
99
+ for (const [key, value] of Object.entries(credentials as Record<string, unknown>)) {
100
+ // A JSON CLI config may hold each block as a one-element list.
101
+ const block = Array.isArray(value) ? value[0] : value;
102
+ if (credentialsHost(key) !== host || !block || typeof block !== "object") continue;
103
+ const token = (block as { token?: unknown }).token;
104
+ if (typeof token === "string" && token) return token;
105
+ }
106
+ return undefined;
107
+ };
108
+
109
+ /** `credentials "<host>" { token = "..." }` blocks in an HCL CLI config, by host. */
110
+ const hclCredentials = (text: string): Record<string, { token: string }> => {
111
+ const out: Record<string, { token: string }> = {};
112
+ const noComments = text.replace(/\/\*[\s\S]*?\*\//g, "").replace(/^\s*(#|\/\/).*$/gm, "");
113
+ const block = /credentials\s+"([^"]+)"\s*\{([^}]*)\}/g;
114
+ for (let m = block.exec(noComments); m; m = block.exec(noComments)) {
115
+ const token = /(?:^|[\s;])token\s*=\s*"((?:[^"\\]|\\.)*)"/.exec(m[2]!)?.[1];
116
+ if (token) out[m[1]!] = { token: token.replace(/\\(.)/g, "$1") };
117
+ }
118
+ return out;
119
+ };
120
+
121
+ /** The credentials a CLI config file's text holds, read as JSON when it parses and as HCL otherwise. */
122
+ const fileCredentials = (text: string): unknown => {
123
+ try {
124
+ return (JSON.parse(text) as { credentials?: unknown }).credentials;
125
+ } catch {
126
+ return hclCredentials(text);
127
+ }
128
+ };
129
+
130
+ /** The token for a host and where it came from, or undefined when the CLIs would send none. */
131
+ export function terraformCredential(host: string, options: CredentialsOptions = {}): TerraformCredential | undefined {
132
+ const h = credentialsHost(host);
133
+ if (!h) return undefined;
134
+ const env = options.env ?? process.env;
135
+ const readFile = options.readFile ?? defaultReadFile;
136
+
137
+ const exact = tokenVariable(h);
138
+ if (exact && env[exact]) return { token: env[exact]!, from: exact };
139
+ if (!h.includes(":")) {
140
+ for (const [name, value] of Object.entries(env)) {
141
+ if (value && name.startsWith("TF_TOKEN_") && hostOfVariable(name) === h) return { token: value, from: name };
142
+ }
143
+ }
144
+
145
+ const files = [env.TF_CLI_CONFIG_FILE, credentialsFilePath({ ...options, env })].filter((p): p is string => !!p);
146
+ for (const path of files) {
147
+ const text = readFile(path);
148
+ if (text === undefined) continue;
149
+ const token = tokenIn(fileCredentials(text), h);
150
+ if (token) return { token, from: path };
151
+ }
152
+ return undefined;
153
+ }
154
+
155
+ /** The token for a host, or undefined. */
156
+ export const terraformToken = (host: string, options: CredentialsOptions = {}): string | undefined => terraformCredential(host, options)?.token;
157
+
158
+ /** `{ Authorization: "Bearer <token>" }` for a host with a token, else `{}`. */
159
+ export function authorizationFor(host: string, options: CredentialsOptions = {}): Record<string, string> {
160
+ const token = terraformToken(host, options);
161
+ return token ? { Authorization: `Bearer ${token}` } : {};
162
+ }
package/src/utils.ts CHANGED
@@ -24,17 +24,8 @@ export function isAttrRefLike(value: unknown): value is AttrRef {
24
24
  );
25
25
  }
26
26
 
27
- /**
28
- * JSON.stringify replacer that sorts object keys for deterministic output.
29
- */
30
- export function sortedJsonReplacer(_key: string, value: unknown): unknown {
31
- if (value && typeof value === "object" && !Array.isArray(value)) {
32
- return Object.fromEntries(
33
- Object.entries(value as Record<string, unknown>).sort(([a], [b]) => a.localeCompare(b))
34
- );
35
- }
36
- return value;
37
- }
27
+ export { sortedJsonReplacer } from "./sorted-json";
28
+
38
29
 
39
30
  /**
40
31
  * Get all property names that have AttrRef values
@@ -182,7 +182,8 @@ async function opScenario(
182
182
  }
183
183
  out.push({ ...(label ? { label } : {}), job: { wave: rest.wave, decide: rest.decide, share: rest.share }, result, ledger: ledgerOf(gates), calls: h.calls.slice(from).length, logs: h.logs.slice(logFrom).length });
184
184
  }
185
- await expect(JSON.stringify(h.transcript({ jobs: out }), null, 2) + "\n").toMatchFileSnapshot(`${GOLDEN}/op-${name}.json`);
185
+ // A target's start time and duration (#4555) are the clock's, so they read as 0, as in the fan-out goldens.
186
+ await expect(JSON.stringify(scrubDurations(h.transcript({ jobs: out })), null, 2) + "\n").toMatchFileSnapshot(`${GOLDEN}/op-${name}.json`);
186
187
  } finally {
187
188
  h.done();
188
189
  }
@@ -2,7 +2,7 @@
2
2
  * The slim wave-job runtime (#3896): the four commands a generated Op waves
3
3
  * pipeline runs, and nothing else.
4
4
  *
5
- * chant run wave --spec <file> --wave <k> [--decide | --share <i> | --record-plans]
5
+ * chant run wave --spec <file> --wave <k> [--decide | --share <i> | --record-plans | --waves-outcome]
6
6
  * chant run resume [--gate <op>/<gate>] [--dry-run]
7
7
  * chant approve <op> <gate> [...]
8
8
  * chant workspace points ask|answer|list|... [...]
@@ -50,7 +50,7 @@ Usage: node wave-runtime.mjs <command> [options]
50
50
 
51
51
  Commands:
52
52
  run wave --spec <file> --wave <k> Plan, gate and apply wave k of an Op waves spec
53
- (--decide, --share <i>, --record-plans, --base <ref>, --json)
53
+ (--decide, --share <i>, --record-plans, --waves-outcome, --base <ref>, --json)
54
54
  run resume Start the CI jobs that wait at gates whose approval arrived
55
55
  (--gate <op>/<gate>, --dry-run, --json)
56
56
  approve <op> <gate> Record a gate's resolution on the lifecycle ledger
@@ -377,7 +377,10 @@ function fixConfig(text: string): string {
377
377
 
378
378
  const FLY_EDITS: Edit[] = [
379
379
  {
380
- find: /import \{ FlySite \} from "@intentius\/chud-runtime\/lexicon";\n/,
380
+ // The quotes are character classes so tsc-alias, which rewrites anything
381
+ // shaped like `from "<path>"` in the build, leaves the escaped slashes
382
+ // alone (chant#4591: it dropped them, and dist/ failed to parse).
383
+ find: /import \{ FlySite \} from ["]@intentius\/chud-runtime\/lexicon["];\n/,
381
384
  replace: "",
382
385
  required: "the FlySite import from @intentius/chud-runtime/lexicon",
383
386
  unless: /^(?![\s\S]*FlySite)/,
@@ -0,0 +1,31 @@
1
+ /**
2
+ * #4552, ruling A: `ci.lockGrain: target | resource | repo` at the top level
3
+ * and on a member, the member's winning.
4
+ */
5
+ import { describe, expect, test } from "vitest";
6
+ import { parseDeclaration, WorkspaceReadError } from "./declaration";
7
+ import { lockGrainOf } from "./ci-lock-grain";
8
+
9
+ const parse = (doc: unknown) => parseDeclaration(JSON.stringify(doc, null, 2), "chant.workspace.json");
10
+ const member = (name: string, ci?: unknown) => ({ name, dir: name, kind: "other", because: "x", ...(ci ? { ci } : {}) });
11
+
12
+ describe("ci.lockGrain", () => {
13
+ test("reads at both levels, and a member's own wins", () => {
14
+ const d = parse({ name: "acme", schema: 1, ci: { lockGrain: "repo" }, members: [member("net", { lockGrain: "resource" }), member("web")] });
15
+ expect(d.ci?.lockGrain).toBe("repo");
16
+ expect(d.members.find((m) => m.name === "net")?.ciLockGrain).toBe("resource");
17
+ expect(d.members.find((m) => m.name === "web")?.ciLockGrain).toBeNull();
18
+ expect(lockGrainOf(d, "net")).toBe("resource");
19
+ expect(lockGrainOf(d, "web")).toBe("repo");
20
+ expect(lockGrainOf(d, null)).toBe("repo");
21
+ });
22
+
23
+ test("absent at both levels, the member takes its lexicon's default", () => {
24
+ const d = parse({ name: "acme", schema: 1, members: [member("net")] });
25
+ expect(lockGrainOf(d, "net")).toBeNull();
26
+ });
27
+
28
+ test("a grain outside the three is refused", () => {
29
+ expect(() => parse({ name: "acme", schema: 1, ci: { lockGrain: "stack" }, members: [member("net")] })).toThrow(WorkspaceReadError);
30
+ });
31
+ });
@@ -0,0 +1,30 @@
1
+ /**
2
+ * `ci.lockGrain` read at base (#4552), as `ci.locks` (./ci-locks.ts) and
3
+ * `ci.workflow` (./ci-workflow-at.ts) are: the target branch's tip, so a
4
+ * pull request cannot widen what its own apply may run beside.
5
+ */
6
+ import { NEXT_RELEASE } from "../release-floors";
7
+ import type { CiLockGrain, Declaration } from "./declaration";
8
+ import { memberAtCwd } from "./security";
9
+ import { scopeSource } from "./write-scope";
10
+
11
+ /** The first chant that reads `ci.lockGrain`; a declaration that sets it needs this `minReader`. */
12
+ export const CI_LOCK_GRAIN_FLOOR = NEXT_RELEASE;
13
+
14
+ /** The grain a member takes from the declaration: its own `ci.lockGrain`, else the top level's, else null. */
15
+ export function lockGrainOf(declaration: Pick<Declaration, "ci" | "members">, member: string | null | undefined): CiLockGrain | null {
16
+ const own = member ? declaration.members.find((m) => m.name === member)?.ciLockGrain : null;
17
+ return own ?? declaration.ci?.lockGrain ?? null;
18
+ }
19
+
20
+ /**
21
+ * The `ci.lockGrain` of the member holding `cwd`, or of `member` when given,
22
+ * read at `at` when given, else at base, else from the working tree. Null
23
+ * outside a workspace and when neither the member nor the top level sets one.
24
+ */
25
+ export function ciLockGrainAt(cwd: string, at?: string, member?: string): CiLockGrain | null {
26
+ const source = scopeSource(cwd, at);
27
+ const d = source.declaration;
28
+ if (!d) return null;
29
+ return lockGrainOf(d, member ?? memberAtCwd(source, cwd));
30
+ }
@@ -104,7 +104,7 @@ describe("reportUrlOf", () => {
104
104
 
105
105
  test("a declared URL no job can upload to fails with its place and reason code, unless the flag is given", async () => {
106
106
  const w = workspace({ reportUrl: "https://reports.example/acme" });
107
- await expect(declaredReportUrl(w.app)).rejects.toThrow(/chant\.workspace\.json:\d+:\d+: ci\.reportUrl https:\/\/reports\.example\/acme: takes an s3:\/\/<bucket>\/<prefix> or file:\/\/<directory> URL \[declaration-invalid\]/);
107
+ await expect(declaredReportUrl(w.app)).rejects.toThrow(/chant\.workspace\.json:\d+:\d+: ci\.reportUrl https:\/\/reports\.example\/acme: takes an s3:\/\/<bucket>\/<prefix>, gs:\/\/<bucket>\/<prefix>, az:\/\/<account>\/<container>\/<prefix> or file:\/\/<directory> URL \[declaration-invalid\]/);
108
108
  expect(await reportUrlOf("file:///elsewhere", w.app)).toBe("file:///elsewhere");
109
109
  });
110
110
  });
@@ -513,7 +513,7 @@ describe("chant ci run, then ci tick from runs (#4094)", () => {
513
513
  ] }));
514
514
  expect(at([ok("build"), fail("apply", 1)])).toEqual({ code: "failed", reason: "members cluster-a failed (stack CREATE_FAILED), cluster-b failed", phase: "apply", exitCode: 1 });
515
515
  writeFileSync(join(dir, "pr-apply.json"), JSON.stringify({ status: "refused", refusal: "plan-changed", message: "the plan changed after review\nsecond line" }));
516
- expect(at([ok("build"), fail("apply", 3)])).toEqual({ code: "plan-changed", reason: "the plan changed after review", phase: "apply", exitCode: 3 });
516
+ expect(at([ok("build"), fail("apply", 4)])).toEqual({ code: "plan-changed", reason: "the plan changed after review", phase: "apply", exitCode: 4 });
517
517
  // A report that says the job did its work leaves the command's failure.
518
518
  writeFileSync(join(dir, "pr-apply.json"), JSON.stringify({ status: "applied", members: [] }));
519
519
  expect(at([ok("build"), fail("apply", 1)])!.code).toBe("command-failed");
@@ -93,6 +93,7 @@ import { holdsForgeToken, withoutForgeTokens } from "../ci-handover";
93
93
  import { postPlanReport } from "../pr-post";
94
94
  import { overdueOpsAt } from "../op/schedule-overdue";
95
95
  import { PR_APPLY_GATE, type PrOverdue } from "../pr-loop";
96
+ import { activeProductWords, productContext, type CiProductWords } from "../ci-product-words";
96
97
  import type { CommandContext } from "../cli/registry";
97
98
  import { formatError, formatWarning } from "../cli/format";
98
99
  import { CHANT_CI_RUN_FORGE_ENV, CHANT_CI_RUN_ID_ENV, FORGE_RUN_ENV, resolveCiJob, type RunOrigin } from "../lifecycle/release-ledger";
@@ -414,8 +415,9 @@ const cut = (text: string, max = STATUS_DESCRIPTION): string => (text.length > m
414
415
  * `chant/<gate>`, which is `chant/pr-apply` unless `--gate` renamed the gate.
415
416
  * pr-plan's own status is `chant/plan` (../pr-loop.ts), a different context.
416
417
  */
417
- export function ciStatusContext(job: CiJobName, gate?: string): string {
418
- return job === "apply" ? `chant/${gate ?? PR_APPLY_GATE}` : `chant/${CI_JOB_OPS[job]}`;
418
+ export function ciStatusContext(job: CiJobName, gate?: string, words: CiProductWords = activeProductWords()): string {
419
+ // #4550: every context chant posts takes the product's prefix, so a product's repository shows no `chant/` check.
420
+ return productContext(words, job === "apply" ? (gate ?? PR_APPLY_GATE) : CI_JOB_OPS[job]);
419
421
  }
420
422
 
421
423
  /**
@@ -1184,13 +1186,14 @@ export function ciLoopOptions(args: CommandContext["args"]): PrLoopPipelineOptio
1184
1186
  ...(args.waveGate ? { waveGate: args.waveGate } : {}),
1185
1187
  ...(args.requireReview === true ? { requireReview: true } : {}),
1186
1188
  ...(args.applyBeforeMerge ? { applyBeforeMerge: true } : {}),
1189
+ ...(args.requires ? { applyRequires: args.requires } : {}),
1187
1190
  };
1188
1191
  }
1189
1192
 
1190
1193
  const USAGE =
1191
1194
  "chant ci run plan|record|apply|env-up|env-post|env-down|env-sweep --env <env> --base <sha> [--pr <n>] [--commit <sha>] [--head <sha>] [--result <r>] [--forge github|gitlab|forgejo] " +
1192
1195
  "[--gate <name>] [--wave-gate <name>] [--wave <k>] [--branch <name>] [--events-json] [--report-url <url>] [--run-index-limit <n>] [--image <image>] [--before-script <line>]... " +
1193
- "[--pr-build] [--pr-build-command <line>] [--require-review] [--apply-before-merge] [--no-status] [--status-url <url template>] " +
1196
+ "[--pr-build] [--pr-build-command <line>] [--require-review] [--apply-before-merge [--requires <list>]] [--no-status] [--status-url <url template>] " +
1194
1197
  "[--chant <command>] [--pass-env <NAME>]... [--secrets <file>] [--key <runner key.pem>] [-o <dir>] [--in-place | --local] [--no-push] [--verbose] | chant ci run --at <sha> | chant ci run --setup-key [--trust [--principal <name>]] [--state <dir>] [--branch <name>]";
1195
1198
 
1196
1199
  const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
@@ -218,6 +218,9 @@
218
218
  "hooks": {
219
219
  "$ref": "#/$defs/ciHooks"
220
220
  },
221
+ "lockGrain": {
222
+ "$ref": "#/$defs/ciLockGrain"
223
+ },
221
224
  "locks": {
222
225
  "enum": ["apply", "plan"],
223
226
  "description": "When a pull request takes its target locks, _locks/<gate>.json on chant/lifecycle (#4293). apply: the pull request's apply takes them, and chant lock takes them by hand. plan: its plan takes them too, through chant lock --stage plan in a job that runs the target branch's code. Under either, chant components pr-apply refuses a target that another open pull request holds, and a lock whose pull request merged or closed reads as released. Absent: nothing is locked. Read from the declaration at base. Added in schema 1 by chant 0.124.41, so a declaration that uses it sets minReader to 0.124.41 or newer."
@@ -228,7 +231,7 @@
228
231
  "reportUrl": {
229
232
  "type": "string",
230
233
  "minLength": 1,
231
- "description": "Where the pull-request jobs copy their reports and events, and where chant ci run keeps the run index, <reportUrl>/runs/index.json (#4160): an s3://<bucket>/<prefix> or file://<directory> URL, as --report-url takes. chant build --pr-loop, chant ci run, chant ci serve and chant ci runs use it when --report-url is not given, and the flag wins. Readers find it in chant workspace ls --json as ci.reportUrl. Added in schema 1 by chant 0.124.32, so a declaration that uses it sets minReader to 0.124.32 or newer."
234
+ "description": "Where the pull-request jobs copy their reports and events, and where chant ci run keeps the run index, <reportUrl>/runs/index.json (#4160): an s3://<bucket>/<prefix>, gs://<bucket>/<prefix>, az://<account>/<container>/<prefix> or file://<directory> URL, as --report-url takes. gs:// and az:// URLs (#4554) need minReader 0.124.55 or newer. chant build --pr-loop, chant ci run, chant ci serve and chant ci runs use it when --report-url is not given, and the flag wins. Readers find it in chant workspace ls --json as ci.reportUrl. Added in schema 1 by chant 0.124.32, so a declaration that uses it sets minReader to 0.124.32 or newer."
232
235
  },
233
236
  "branches": {
234
237
  "type": "object",
@@ -298,6 +301,20 @@
298
301
  "subscriptionId": { "type": "string", "minLength": 1, "description": "Set as AZURE_SUBSCRIPTION_ID and ARM_SUBSCRIPTION_ID when given." },
299
302
  "audience": { "type": "string", "minLength": 1, "description": "The OIDC token's audience. Default api://AzureADTokenExchange." },
300
303
  "authority": { "type": "string", "pattern": "^https?://", "description": "The Entra authority host, for an emulator. Default https://login.microsoftonline.com." },
304
+ "database": { "type": "boolean", "description": "Also trade each identity for an Azure Database for PostgreSQL token, set as AZURE_DATABASE_ACCESS_TOKEN, which the sql lexicon's entra token source signs in with (#4572). Default false. Added in schema 1 by chant 0.124.55, so a declaration that sets database sets minReader to 0.124.55 or newer." },
305
+ "rules": { "$ref": "#/$defs/ciCloudIdentityRules" }
306
+ }
307
+ },
308
+ "pulumi": {
309
+ "type": "object",
310
+ "additionalProperties": false,
311
+ "patternProperties": { "^x-": true },
312
+ "required": ["organization", "rules"],
313
+ "description": "Pulumi Cloud access tokens (#4549), traded through Pulumi Cloud's OAuth token exchange and set as PULUMI_ACCESS_TOKEN: the plan and record jobs preview with the plan token, the apply jobs run up with the apply token. The rules' identities are team:<name>, user:<login>, organization or organization:admin. Added in schema 1 by chant 0.124.55, so a declaration that uses it sets minReader to 0.124.55 or newer.",
314
+ "properties": {
315
+ "organization": { "type": "string", "minLength": 1, "description": "The Pulumi organization." },
316
+ "audience": { "type": "string", "minLength": 1, "description": "The OIDC token's audience. Default urn:pulumi:org:<organization>." },
317
+ "apiUrl": { "type": "string", "pattern": "^https?://", "description": "The Pulumi Cloud API, for a self-hosted one or a fake. Default https://api.pulumi.com. When set, the trade sets PULUMI_BACKEND_URL to it too." },
301
318
  "rules": { "$ref": "#/$defs/ciCloudIdentityRules" }
302
319
  }
303
320
  }
@@ -739,6 +756,9 @@
739
756
  },
740
757
  "hooks": {
741
758
  "$ref": "#/$defs/ciHooks"
759
+ },
760
+ "lockGrain": {
761
+ "$ref": "#/$defs/ciLockGrain"
742
762
  }
743
763
  }
744
764
  },
@@ -1898,13 +1918,17 @@
1898
1918
  "enum": ["trunk-curated", "trunk-curated+apply-on-merge", "apply-before-merge"],
1899
1919
  "description": "A prescribed delivery workflow (#4168). trunk-curated: a merge records the plan and deploys nothing; releases are cut from green commits and promoted through each member's environments, gated in the last. trunk-curated+apply-on-merge: the same, with the apply on merge turned back on. apply-before-merge (#4301, ws-106): the same as trunk-curated, and a person may also apply an open pull request's plan from its head under its gate, once it is approved, mergeable, undiverged and its checks passed (chant components pr-apply --before-merge); added by chant 0.124.42, so a declaration that uses it sets minReader to 0.124.42 or newer. chant workspace check reports what a member under one still lacks (WSP151), and chant ci init writes it. At the top level for every member, or on a member, which wins. Added in schema 1 by chant 0.124.34, so a declaration that uses it sets minReader to 0.124.34 or newer."
1900
1920
  },
1921
+ "ciLockGrain": {
1922
+ "enum": ["target", "resource", "repo"],
1923
+ "description": "What one apply holds while it applies (#4552). target: the component, root or stack; the engine's own lock keeps one target's applies apart. resource: a lease on one row per changed resource, in _locks/rows/<gate>.json at the root of chant/lifecycle, taken before the apply and released after, and under ci.locks a pull request locks those row keys in place of its component names. A held row stops the apply with exit 5. repo: one apply at a time in the repository, which the generated pipeline keeps. Absent: each member takes its lexicon's default, resource for choudoufu and plunge and target for Terraform, tofu, Terragrunt and stock Pulumi, which refuse resource. At the top level for every member, or on a member, which wins. Read from the declaration at base. Added in schema 1 by chant 0.124.55, so a declaration that uses it sets minReader to 0.124.55 or newer."
1924
+ },
1901
1925
  "ciHooks": {
1902
1926
  "type": "object",
1903
- "description": "Stage hooks the pull-request jobs run (#4288), in the shape an Op waves spec's hooks take: before.observe, before.plan, after.plan, before.apply and after.apply, each a list of { command, name?, onFailure?, perRun?, targets? }. targets are component names or patterns. chant components pr-plan, pr-record and pr-apply read them from the declaration at base, the top level's first and then the member's. after.gate and apply.runBy are refused. Added in schema 1 by chant 0.124.41, so a declaration that uses it sets minReader to 0.124.41 or newer."
1927
+ "description": "Stage hooks the pull-request jobs run (#4288), in the shape an Op waves spec's hooks take: before.observe, before.plan, after.plan, before.apply and after.apply, each a list of { command, name?, onFailure?, perRun?, targets? }. targets are component names or patterns. chant components pr-plan, pr-record and pr-apply read them from the declaration at base, the top level's first and then the member's. after.gate and apply.runBy are refused. Added in schema 1 by chant 0.124.41, so a declaration that uses it sets minReader to 0.124.41 or newer. check (#4556) is a list of hooks a product's check job runs through chant ci check, before any plan, with onFailure fail and no {plan}; added in schema 1 by chant 0.124.55, so a declaration that uses check sets minReader to 0.124.55 or newer."
1904
1928
  },
1905
1929
  "ciPolicy": {
1906
1930
  "type": "object",
1907
- "description": "Gate-time policy on the pull-request jobs (#4294): a policy engine run over the change set, with the policy read at base. engine names the result shape the command prints, conftest (the default) or opa. path is the policy directory, relative to the declaration (default policy). namespace is the package to read. command replaces the engine's own argv, with {policy} for the policy directory exported from base and {input} for the input file. deny rules refuse the apply unless an override counts; hold rules make the plan wait for a person's approval; warn rules are advice. There is no unattended outcome. Added in schema 1 by chant 0.124.41, so a declaration that uses it sets minReader to 0.124.41 or newer."
1931
+ "description": "Gate-time policy on the pull-request jobs (#4294): a policy engine run over the change set, with the policy read at base. engine names the result shape the command prints, conftest (the default) or opa. path is the policy directory, relative to the declaration (default policy). namespace is the package to read. command replaces the engine's own argv, with {policy} for the policy directory exported from base and {input} for the input file. deny rules refuse the apply unless an override counts; hold rules make the plan wait for a person's approval; warn rules are advice. There is no unattended outcome. source (#4613) is { repo, ref, path? }: a shared repository whose ref the job fetches, read in place of path, with the commit read recorded on the report and the wave's decision; path inside it defaults to policy, and path beside source is refused. packs (#4613) is a list of { dir, config? }: CrossGuard packs every pulumi-up preview runs, copied from the declaration's directory at base, or from the top of source when it is set. Added in schema 1 by chant 0.124.41, so a declaration that uses it sets minReader to 0.124.41 or newer; source and packs were added in schema 1 by chant 0.124.55, so a declaration that sets either sets minReader to 0.124.55 or newer."
1908
1932
  },
1909
1933
  "ciPhaseName": {
1910
1934
  "type": "string",
@@ -460,7 +460,7 @@ describe("ci.reportUrl (#4160)", () => {
460
460
  for (const reportUrl of ["https://reports.example/acme", "ftp://example/x", "reports/"]) {
461
461
  const err = failure(base([], { ci: { reportUrl } }));
462
462
  expect(err.code).toBe("declaration-invalid");
463
- expect(err.message).toBe(`ci.reportUrl ${reportUrl}: takes an s3://<bucket>/<prefix> or file://<directory> URL`);
463
+ expect(err.message).toBe(`ci.reportUrl ${reportUrl}: takes an s3://<bucket>/<prefix>, gs://<bucket>/<prefix>, az://<account>/<container>/<prefix> or file://<directory> URL`);
464
464
  expect(err.location?.line).toBeGreaterThan(1);
465
465
  }
466
466
  expect(failure(base([], { ci: { reportUrl: "" } })).code).toBe("declaration-invalid");
@@ -20,7 +20,7 @@ import { RETENTION_KINDS, type RetentionOverride } from "../lifecycle/retention-
20
20
  import { parseReportUrl } from "../pr-report-url";
21
21
  import schema from "./declaration.schema.json" with { type: "json" };
22
22
  import { routeConflicts } from "./ci-branches";
23
- import { cloudIdentityProblems, CLOUDS, type CloudIdentityDeclaration } from "../ci-identity";
23
+ import { cloudIdentityProblems, IDENTITY_CLOUDS, type CloudIdentityDeclaration } from "../ci-identity";
24
24
  import { expandGlob } from "./glob";
25
25
  import { EXAMPLES_KIND, holdsChantProject, REPO_KIND } from "./kinds";
26
26
  import { parseJsonText, pointerToken, type TextLocation } from "./jsonc";
@@ -29,7 +29,7 @@ import type { SecurityGroup } from "./security";
29
29
  import { joinPath, type WorkspaceTree } from "./tree";
30
30
  import { loadAjv2020 } from "./ajv2020";
31
31
  import { readChantPackageVersion } from "../package-version";
32
- import { assertPrLoopHooks, type OpWaveHooks } from "../op/op-waves";
32
+ import { assertPrLoopHooks, type CiHooks } from "../op/op-waves";
33
33
  import { quorumProblems, type GateQuorumSpec } from "../op/gate-quorum";
34
34
  import { gateBaseApprovalProblems, type GateApprovalMode, type GatePolicyRef } from "../op/gate-approval";
35
35
  import { assertGatePolicySettings, type GatePolicySettings } from "../gate-policy";
@@ -301,6 +301,14 @@ export type CiWorkflow = "trunk-curated" | "trunk-curated+apply-on-merge" | "app
301
301
  */
302
302
  export type CiLocks = "apply" | "plan";
303
303
 
304
+ /**
305
+ * What one apply holds while it applies, and what a pull request's target
306
+ * locks name under `ci.locks` (#4552, ../lifecycle/lock-rows.ts). `target`:
307
+ * the component, root or stack. `resource`: one row per changed resource.
308
+ * `repo`: one apply at a time in the repository.
309
+ */
310
+ export type CiLockGrain = "target" | "resource" | "repo";
311
+
304
312
  /** The declaration's `ci` block (#3573). */
305
313
  export interface CiDeclaration {
306
314
  green: CiGreen | null;
@@ -308,6 +316,8 @@ export interface CiDeclaration {
308
316
  workflow?: CiWorkflow;
309
317
  /** `ci.locks` (#4293): when a pull request takes its target locks; absent when the declaration sets none, and then nothing is locked. */
310
318
  locks?: CiLocks;
319
+ /** `ci.lockGrain` (#4552): the grain every member takes unless it names its own; absent when the declaration sets none, and then each member takes its lexicon's default. */
320
+ lockGrain?: CiLockGrain;
311
321
  /**
312
322
  * `ci.reportUrl` (#4160): where the pull-request jobs copy their reports
313
323
  * and `chant ci run` keeps the run index, `<reportUrl>/runs/index.json`.
@@ -322,7 +332,7 @@ export interface CiDeclaration {
322
332
  * `pr-record` and `pr-apply` read them from the declaration at base.
323
333
  * Absent when the declaration sets none.
324
334
  */
325
- hooks?: OpWaveHooks;
335
+ hooks?: CiHooks;
326
336
  /**
327
337
  * `ci.branches` (#4292): branch name to member-name globs. A member a glob
328
338
  * matches applies from that branch alone; the others apply from every
@@ -343,7 +353,8 @@ export interface CiDeclaration {
343
353
  policy?: GatePolicySettings;
344
354
  /**
345
355
  * `ci.identity` (#4296): `cloud` gives each cloud's plan and apply
346
- * identities by environment and member globs (../ci-identity.ts).
356
+ * identities by environment and member globs (../ci-identity.ts), and
357
+ * Pulumi Cloud's preview and up tokens under `pulumi` (#4549).
347
358
  * Absent when unset.
348
359
  */
349
360
  identity?: { cloud: CloudIdentityDeclaration };
@@ -704,7 +715,9 @@ export interface Member {
704
715
  /** The member's own `ci.workflow` (#4168 step 6), which wins over the top level's; null when it names none. */
705
716
  ciWorkflow: CiWorkflow | null;
706
717
  /** The member's own `ci.hooks` (#4288), run after the top level's; null when it names none. */
707
- ciHooks: OpWaveHooks | null;
718
+ ciHooks: CiHooks | null;
719
+ /** The member's own `ci.lockGrain` (#4552), which wins over the top level's; null when it names none. */
720
+ ciLockGrain: CiLockGrain | null;
708
721
  suppress: Suppression[];
709
722
  /** The entry's JSON Pointer in the file, for messages. */
710
723
  pointer: string;
@@ -1027,6 +1040,7 @@ export function parseDeclaration(text: string, file: string, reader: string = re
1027
1040
  security: [...((e.security as SecurityGroup[] | undefined) ?? [])],
1028
1041
  ciWorkflow: ((e.ci as { workflow?: CiWorkflow } | undefined)?.workflow) ?? null,
1029
1042
  ciHooks: ciHooksOf((e.ci as { hooks?: unknown } | undefined)?.hooks, `${pointer}/ci/hooks`, at),
1043
+ ciLockGrain: ((e.ci as { lockGrain?: CiLockGrain } | undefined)?.lockGrain) ?? null,
1030
1044
  suppress,
1031
1045
  pointer,
1032
1046
  };
@@ -1304,14 +1318,14 @@ function retentionOf(raw: unknown): RetentionOverride | null {
1304
1318
  }
1305
1319
 
1306
1320
  /** A `ci.hooks` block (#4288), refused when a pull-request job could not run it. Null when absent. */
1307
- function ciHooksOf(raw: unknown, pointer: string, at: (pointer: string, key?: boolean) => ErrorLocation): OpWaveHooks | null {
1321
+ function ciHooksOf(raw: unknown, pointer: string, at: (pointer: string, key?: boolean) => ErrorLocation): CiHooks | null {
1308
1322
  if (raw === undefined) return null;
1309
1323
  try {
1310
- assertPrLoopHooks(pointer.slice(1).replace(/\//g, "."), raw as OpWaveHooks);
1324
+ assertPrLoopHooks(pointer.slice(1).replace(/\//g, "."), raw as CiHooks);
1311
1325
  } catch (err) {
1312
1326
  throw new WorkspaceReadError("declaration-invalid", err instanceof Error ? err.message : String(err), at(pointer));
1313
1327
  }
1314
- return structuredClone(raw as OpWaveHooks);
1328
+ return structuredClone(raw as CiHooks);
1315
1329
  }
1316
1330
 
1317
1331
  /** A `ci.branches` or `ci.labels` map, copied without its `x-` keys. */
@@ -1337,7 +1351,8 @@ function ciPolicyOf(raw: unknown, at: (pointer: string, key?: boolean) => ErrorL
1337
1351
  */
1338
1352
  function cloudIdentityOf(raw: CloudIdentityDeclaration, at: (pointer: string, key?: boolean) => ErrorLocation): CloudIdentityDeclaration {
1339
1353
  const out: CloudIdentityDeclaration = {};
1340
- for (const cloud of CLOUDS) {
1354
+ // #4549: Pulumi Cloud's identities are read with the clouds'.
1355
+ for (const cloud of IDENTITY_CLOUDS) {
1341
1356
  const c = raw[cloud];
1342
1357
  if (c === undefined) continue;
1343
1358
  const kept = Object.fromEntries(Object.entries(c).filter(([k]) => !k.startsWith("x-")));
@@ -1351,7 +1366,7 @@ function cloudIdentityOf(raw: CloudIdentityDeclaration, at: (pointer: string, ke
1351
1366
 
1352
1367
  function ciOf(raw: unknown, at: (pointer: string, key?: boolean) => ErrorLocation): CiDeclaration | null {
1353
1368
  if (raw === undefined) return null;
1354
- const block = raw as { reportUrl?: string; workflow?: CiWorkflow; hooks?: unknown; identity?: { cloud?: CloudIdentityDeclaration }; branches?: Record<string, string[]>; labels?: Record<string, string[]>; locks?: CiLocks; policy?: unknown; prEnvironment?: { template: string; ttl?: string; teardown?: { name?: string; command: string[]; lexicons?: string[] } }; green?: { branch: string | string[]; window?: string; phases: Record<string, string[] | { runs: string[]; skipped?: CiSkipped; build?: CiBuild }>; require: string[]; preMerge?: string[]; signedSince?: string; source?: CiSource } };
1369
+ const block = raw as { reportUrl?: string; workflow?: CiWorkflow; hooks?: unknown; identity?: { cloud?: CloudIdentityDeclaration }; branches?: Record<string, string[]>; labels?: Record<string, string[]>; locks?: CiLocks; lockGrain?: CiLockGrain; policy?: unknown; prEnvironment?: { template: string; ttl?: string; teardown?: { name?: string; command: string[]; lexicons?: string[] } }; green?: { branch: string | string[]; window?: string; phases: Record<string, string[] | { runs: string[]; skipped?: CiSkipped; build?: CiBuild }>; require: string[]; preMerge?: string[]; signedSince?: string; source?: CiSource } };
1355
1370
  const hooks = ciHooksOf(block.hooks, "/ci/hooks", at);
1356
1371
  const policy = ciPolicyOf(block.policy, at);
1357
1372
  const workflow = {
@@ -1360,6 +1375,7 @@ function ciOf(raw: unknown, at: (pointer: string, key?: boolean) => ErrorLocatio
1360
1375
  ...(block.branches !== undefined ? { branches: globMap(block.branches) } : {}),
1361
1376
  ...(block.labels !== undefined ? { labels: globMap(block.labels) } : {}),
1362
1377
  ...(block.locks !== undefined ? { locks: block.locks } : {}),
1378
+ ...(block.lockGrain !== undefined ? { lockGrain: block.lockGrain } : {}),
1363
1379
  ...(policy ? { policy } : {}),
1364
1380
  ...(block.identity?.cloud !== undefined ? { identity: { cloud: cloudIdentityOf(block.identity.cloud, at) } } : {}),
1365
1381
  ...(block.prEnvironment !== undefined
@@ -102,8 +102,13 @@ export const DRIFT_READS_BY_KIND: Record<string, readonly DriftRead[]> = {
102
102
  /** The kinds whose engine reads one resource on its own, for `--resource`. */
103
103
  export const DRIFT_RESOURCE_KINDS: readonly string[] = ["choudoufu", "pulumi"];
104
104
 
105
- /** The exit status `chant lifecycle drift` gives a refused read (`../cli/handlers/lifecycle-drift.ts`). */
106
- const MEMBER_REFUSED_EXIT = 3;
105
+ /**
106
+ * The exit statuses a refused `chant lifecycle drift` read can carry
107
+ * (`../cli/handlers/lifecycle-drift.ts`): 1 since #4553, 3 from a reader
108
+ * project on an older chant. The `{"refused": ...}` stdout line is what says
109
+ * the read was refused.
110
+ */
111
+ const MEMBER_REFUSED_EXITS: readonly number[] = [1, 3];
107
112
 
108
113
  const USAGE =
109
114
  "chant workspace drift [dir] --member <name> [--read <state|plan|refresh|live-read|ownership>] [--resource <addr>] [--env <env>] [--components] [--stream] [-o <file>]";
@@ -282,7 +287,7 @@ export async function readWorkspaceDrift(query: DriftQuery): Promise<DriftReadRe
282
287
  return { lines: [start, ...settled.records.map(driftRecordLine), settled.line] };
283
288
  }
284
289
 
285
- if (result.exitCode === MEMBER_REFUSED_EXIT) {
290
+ if (MEMBER_REFUSED_EXITS.includes(result.exitCode)) {
286
291
  let refused: { code?: string; message?: string } | undefined;
287
292
  try {
288
293
  refused = (JSON.parse(result.stdout.trim().split("\n").pop() ?? "") as { refused?: { code?: string; message?: string } }).refused;
@@ -14,6 +14,7 @@
14
14
  */
15
15
 
16
16
  import { execFileSync } from "node:child_process";
17
+ import { CHANT_EXIT } from "../exit-codes";
17
18
  import { createHash } from "node:crypto";
18
19
  import { existsSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
19
20
  import { tmpdir } from "node:os";
@@ -29,7 +30,7 @@ import { spawnChant } from "./lineage-upgrade";
29
30
  const USAGE = "chant workspace exit [<member>...] [--member <name>] [--dry-run] [--drill] [--output <patch file>] [--json]";
30
31
 
31
32
  /** The exit code of a gated exit: the same as `chant run`'s gated run. */
32
- export const EXIT_GATED = 3;
33
+ export const EXIT_GATED = CHANT_EXIT.waiting;
33
34
 
34
35
  const EXIT_DIR = ".chant/exit";
35
36
 
@@ -4,8 +4,10 @@
4
4
  * Reads the Terraform Cloud API or the Spacelift GraphQL API into the input
5
5
  * documents `import-source.ts` maps. The transport is a parameter, so a test
6
6
  * feeds fixture responses and nothing here is reached without a token. A
7
- * token is read from `--token`, else `TFE_TOKEN` / `TF_TOKEN_app_terraform_io`
8
- * for Terraform Cloud and `SPACELIFT_API_TOKEN` for Spacelift. Only reads:
7
+ * token is read from `--token`, else `TFE_TOKEN`, else the Terraform CLI's
8
+ * own lookup for app.terraform.io (`TF_TOKEN_app_terraform_io`, then the CLI
9
+ * config and credentials.tfrc.json; ../terraform/credentials.ts) for
10
+ * Terraform Cloud, and `SPACELIFT_API_TOKEN` for Spacelift. Only reads:
9
11
  * every request is a GET, or a GraphQL query with no mutation.
10
12
  */
11
13