@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,55 @@
1
+ /**
2
+ * #4572: `ci.identity.cloud.azure.database` asks the trade for a second
3
+ * Entra token per identity, for Azure Database for PostgreSQL's scope, set
4
+ * as AZURE_DATABASE_ACCESS_TOKEN. Pure checks of the spec and the script;
5
+ * nothing reaches Entra.
6
+ */
7
+
8
+ import { describe, expect, test } from "vitest";
9
+ import {
10
+ AZURE_DATABASE_SCOPE,
11
+ AZURE_DATABASE_TOKEN_ENV,
12
+ AZURE_DATABASE_TOKEN_FLOOR,
13
+ resolveCloudIdentity,
14
+ TRADE_JS,
15
+ TRADED_VARS,
16
+ type CloudIdentityDeclaration,
17
+ } from "./ci-identity";
18
+ import { NEXT_RELEASE } from "./release-floors";
19
+
20
+ const azure = (database?: boolean): CloudIdentityDeclaration => ({
21
+ azure: {
22
+ tenantId: "00000000-0000-0000-0000-000000000001",
23
+ ...(database === undefined ? {} : { database }),
24
+ rules: [{ plan: "11111111-1111-1111-1111-111111111111", apply: "22222222-2222-2222-2222-222222222222" }],
25
+ },
26
+ });
27
+
28
+ describe("azure database tokens", () => {
29
+ test("database: true reaches both trades", () => {
30
+ const id = resolveCloudIdentity(azure(true), "prod")!;
31
+ expect(id.plan.azure?.database).toBe(true);
32
+ expect(id.apply.azure?.database).toBe(true);
33
+ });
34
+
35
+ test("without database the trade asks for no database token", () => {
36
+ expect(resolveCloudIdentity(azure(), "prod")!.plan.azure).not.toHaveProperty("database");
37
+ expect(resolveCloudIdentity(azure(false), "prod")!.plan.azure).not.toHaveProperty("database");
38
+ });
39
+
40
+ test("the script asks for the database scope only under z.database and sets the variable", () => {
41
+ expect(TRADE_JS).toContain(`if(z.database)`);
42
+ expect(TRADE_JS).toContain(JSON.stringify(AZURE_DATABASE_SCOPE));
43
+ expect(TRADE_JS).toContain(`${AZURE_DATABASE_TOKEN_ENV}:db`);
44
+ // The script sits in single quotes on a shell line.
45
+ expect(TRADE_JS).not.toContain("'");
46
+ });
47
+
48
+ test("the database token is a traded variable, so steps that drop cloud credentials drop it", () => {
49
+ expect(TRADED_VARS.azure).toContain(AZURE_DATABASE_TOKEN_ENV);
50
+ });
51
+
52
+ test("the floor is the next release", () => {
53
+ expect(AZURE_DATABASE_TOKEN_FLOOR).toBe(NEXT_RELEASE);
54
+ });
55
+ });
@@ -0,0 +1,163 @@
1
+ /**
2
+ * #4549: a Pulumi Cloud identity in `ci.identity.cloud`. The plan and record
3
+ * jobs trade the forge's OIDC token for a preview token, the apply jobs for
4
+ * an up token, through Pulumi Cloud's OAuth token exchange. The trade tests
5
+ * run the generated `node -e` line with `sh`, as a forge step runs it,
6
+ * against the local emulator's fake exchange (./__fixtures__/oidc-emulator.ts).
7
+ * Test values only; nothing reaches api.pulumi.com.
8
+ */
9
+
10
+ import { execFile } from "node:child_process";
11
+ import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
12
+ import { tmpdir } from "node:os";
13
+ import { join } from "node:path";
14
+ import { promisify } from "node:util";
15
+ import { afterAll, beforeAll, describe, expect, test } from "vitest";
16
+ import {
17
+ CLOUDS,
18
+ cloudIdentityProblems,
19
+ gitlabTradeIdTokens,
20
+ idTokenVar,
21
+ IDENTITY_CLOUDS,
22
+ OIDC_REQUEST_VARS,
23
+ pulumiTokenRequest,
24
+ resolveCloudIdentity,
25
+ TRADE_SPEC_ENV,
26
+ TRADED_VARS,
27
+ tradeLine,
28
+ type CloudIdentityDeclaration,
29
+ type CloudTradeSpec,
30
+ } from "./ci-identity";
31
+ import { emulatedPulumiToken, EMULATED_JWT_PREFIX, startOidcEmulator, type OidcEmulator } from "./__fixtures__/oidc-emulator";
32
+
33
+ const run = promisify(execFile);
34
+
35
+ const DECL: CloudIdentityDeclaration = {
36
+ pulumi: {
37
+ organization: "acme",
38
+ rules: [
39
+ { environments: ["prod"], plan: "team:prod-preview", apply: "team:prod-deploy" },
40
+ { plan: "user:ci-preview", apply: "organization:admin" },
41
+ ],
42
+ },
43
+ };
44
+
45
+ describe("which Pulumi Cloud tokens a pipeline takes (#4549)", () => {
46
+ test("the plan trade names the preview token and the apply trade the up token, with the organization's audience", () => {
47
+ const id = resolveCloudIdentity(DECL, "prod")!;
48
+ expect(id.plan).toEqual({ pulumi: { token: "team:prod-preview", organization: "acme", audience: "urn:pulumi:org:acme" } });
49
+ expect(id.apply).toEqual({ pulumi: { token: "team:prod-deploy", organization: "acme", audience: "urn:pulumi:org:acme" } });
50
+ expect(resolveCloudIdentity(DECL, "staging")!.apply.pulumi!.token).toBe("organization:admin");
51
+ });
52
+
53
+ test("a declared audience and API URL are kept", () => {
54
+ const id = resolveCloudIdentity({ pulumi: { ...DECL.pulumi!, audience: "acme", apiUrl: "https://pulumi.example.test" } }, "prod")!;
55
+ expect(id.plan.pulumi).toMatchObject({ audience: "acme", apiUrl: "https://pulumi.example.test" });
56
+ });
57
+
58
+ test("CLOUDS stays the cloud providers; the identity keys add pulumi", () => {
59
+ expect([...CLOUDS]).toEqual(["aws", "gcp", "azure"]);
60
+ expect([...IDENTITY_CLOUDS]).toEqual(["aws", "gcp", "azure", "pulumi"]);
61
+ expect(OIDC_REQUEST_VARS).toContain(idTokenVar("pulumi"));
62
+ expect(TRADED_VARS.pulumi).toContain("PULUMI_ACCESS_TOKEN");
63
+ });
64
+
65
+ test("GitLab asks for one id token with the organization's audience", () => {
66
+ expect(gitlabTradeIdTokens(resolveCloudIdentity(DECL, "prod")!.plan)).toEqual({ CHANT_ID_TOKEN_PULUMI: { aud: "urn:pulumi:org:acme" } });
67
+ });
68
+
69
+ test("an identity names a token the exchange can give", () => {
70
+ expect(pulumiTokenRequest("team:deployers")).toEqual({ tokenType: "urn:pulumi:token-type:access_token:team", scope: "team:deployers" });
71
+ expect(pulumiTokenRequest("user:ci-bot")).toEqual({ tokenType: "urn:pulumi:token-type:access_token:personal", scope: "user:ci-bot" });
72
+ expect(pulumiTokenRequest("organization")).toEqual({ tokenType: "urn:pulumi:token-type:access_token:organization" });
73
+ expect(pulumiTokenRequest("organization:admin")).toEqual({ tokenType: "urn:pulumi:token-type:access_token:organization", scope: "admin" });
74
+ for (const bad of ["deployers", "team:", "team:a b", "org", "pul-abc123"]) expect(pulumiTokenRequest(bad), bad).toBeUndefined();
75
+ });
76
+
77
+ test("a rule whose identity is no token, or that previews with the up token, is a problem", () => {
78
+ expect(cloudIdentityProblems(DECL)).toEqual([]);
79
+ const bad = cloudIdentityProblems({ pulumi: { organization: "acme", rules: [{ plan: "deployers", apply: "team:deploy" }] } });
80
+ expect(bad).toEqual([expect.objectContaining({ pointer: "/ci/identity/cloud/pulumi/rules/0/plan" })]);
81
+ const same = cloudIdentityProblems({ pulumi: { organization: "acme", rules: [{ plan: "organization", apply: "organization" }] } });
82
+ expect(same[0]!.message).toContain("plans and applies as organization");
83
+ });
84
+ });
85
+
86
+ const dirs: string[] = [];
87
+ let emu: OidcEmulator;
88
+ beforeAll(async () => {
89
+ emu = await startOidcEmulator();
90
+ });
91
+ afterAll(async () => {
92
+ await emu.close();
93
+ for (const d of dirs) rmSync(d, { recursive: true, force: true });
94
+ });
95
+
96
+ const BASE = { PATH: process.env.PATH ?? "/usr/bin:/bin", HOME: process.env.HOME ?? "/tmp" };
97
+
98
+ /** Run the trade line as a step does, with `spec` pointed at the emulator's fake exchange. */
99
+ async function trade(spec: CloudTradeSpec, format: "github-env" | "sh", env: Record<string, string> = emu.requestEnv): Promise<{ out: string; stdout: string; stderr: string; code: number; file: string }> {
100
+ const dir = mkdtempSync(join(tmpdir(), "chant-pulumi-trade-"));
101
+ dirs.push(dir);
102
+ const file = join(dir, format === "sh" ? "cloud.sh" : "github-env");
103
+ if (format === "github-env") writeFileSync(file, "EARLIER=1\n");
104
+ try {
105
+ const r = await run("sh", ["-c", tradeLine(file, format)], { env: { ...BASE, ...env, [TRADE_SPEC_ENV]: JSON.stringify(emu.pointAt(spec)) } });
106
+ return { out: existsSync(file) ? readFileSync(file, "utf-8") : "", stdout: r.stdout, stderr: r.stderr, code: 0, file };
107
+ } catch (e) {
108
+ const err = e as { stdout: string; stderr: string; code: number };
109
+ return { out: existsSync(file) ? readFileSync(file, "utf-8") : "", stdout: err.stdout, stderr: err.stderr, code: err.code, file };
110
+ }
111
+ }
112
+
113
+ describe("the Pulumi Cloud trade, run against the fake exchange (#4549)", () => {
114
+ const prod = () => resolveCloudIdentity(DECL, "prod")!;
115
+
116
+ test("the plan job's trade gets the preview token alone, masked, in PULUMI_ACCESS_TOKEN", async () => {
117
+ const before = { minted: emu.log.minted.length, pulumi: emu.log.pulumi.length };
118
+ const r = await trade(prod().plan, "github-env");
119
+ expect(r.stderr).not.toContain("failed");
120
+ expect(r.code).toBe(0);
121
+ const preview = emulatedPulumiToken("team:prod-preview");
122
+ expect(r.out).toContain(`PULUMI_ACCESS_TOKEN=${preview}\n`);
123
+ expect(r.out).toContain(`PULUMI_BACKEND_URL=${emu.url}/pulumi\n`);
124
+ expect(r.stdout).toContain(`::add-mask::${preview}`);
125
+ expect(r.out).not.toContain(emulatedPulumiToken("team:prod-deploy"));
126
+ expect(r.out + r.stdout + r.stderr).not.toContain(EMULATED_JWT_PREFIX);
127
+ expect(emu.log.minted.slice(before.minted)).toEqual(["urn:pulumi:org:acme"]);
128
+ expect(emu.log.pulumi.slice(before.pulumi).map((x) => ({ tokenType: x.tokenType, scope: x.scope, audience: x.audience }))).toEqual([
129
+ { tokenType: "urn:pulumi:token-type:access_token:team", scope: "team:prod-preview", audience: "urn:pulumi:org:acme" },
130
+ ]);
131
+ });
132
+
133
+ test("the apply job's trade gets the up token", async () => {
134
+ const r = await trade(prod().apply, "sh");
135
+ expect(r.code).toBe(0);
136
+ const probe = await run("sh", ["-c", `. "${r.file}"; echo "$PULUMI_ACCESS_TOKEN"`], { env: BASE });
137
+ expect(probe.stdout.trim()).toBe(emulatedPulumiToken("team:prod-deploy"));
138
+ });
139
+
140
+ test("an organization admin token asks for the organization token type with the admin scope", async () => {
141
+ const before = emu.log.pulumi.length;
142
+ const r = await trade(resolveCloudIdentity(DECL, "staging")!.apply, "sh");
143
+ expect(r.code).toBe(0);
144
+ expect(emu.log.pulumi.slice(before).map((x) => [x.tokenType, x.scope])).toEqual([["urn:pulumi:token-type:access_token:organization", "admin"]]);
145
+ });
146
+
147
+ test("on GitLab the token comes from CHANT_ID_TOKEN_PULUMI, and no request URL is needed", async () => {
148
+ const before = emu.log.minted.length;
149
+ const jwt = `${EMULATED_JWT_PREFIX}.gitlab.pulumi`;
150
+ const r = await trade(prod().plan, "sh", { [idTokenVar("pulumi")]: jwt });
151
+ expect(r.code).toBe(0);
152
+ expect(emu.log.minted.length).toBe(before);
153
+ expect(emu.log.pulumi.at(-1)!.token).toBe(jwt);
154
+ expect(r.out).not.toContain(jwt);
155
+ });
156
+
157
+ test("an identity the exchange has no token for fails the step and writes nothing", async () => {
158
+ const r = await trade({ pulumi: { ...prod().plan.pulumi!, token: "deployers" } }, "sh");
159
+ expect(r.code).not.toBe(0);
160
+ expect(r.stderr).toContain("Pulumi Cloud has no token for deployers");
161
+ expect(r.out).toBe("");
162
+ });
163
+ });
@@ -281,7 +281,7 @@ describe("the plan trade with targets, run against the emulator (#4332)", () =>
281
281
  });
282
282
 
283
283
  describe("the ci-identity bundle (#4332)", () => {
284
- test("holds ci-identity.ts alone, with no glob library, and stays small", async () => {
284
+ test("holds ci-identity.ts and the floor constant alone, with no glob library, and stays small", async () => {
285
285
  const result = await build({
286
286
  entryPoints: [join(REPO, "packages", "core", "src", "ci-identity.ts")],
287
287
  bundle: true,
@@ -292,7 +292,11 @@ describe("the ci-identity bundle (#4332)", () => {
292
292
  outdir: "out",
293
293
  logLevel: "silent",
294
294
  });
295
- expect(Object.keys(result.metafile.inputs).map((i) => i.replace(/^.*?packages\//, "packages/"))).toEqual(["packages/core/src/ci-identity.ts"]);
295
+ expect(Object.keys(result.metafile.inputs).map((i) => i.replace(/^.*?packages\//, "packages/"))).toEqual([
296
+ // The next-release floor constant (#4480, the #4549 token floors): no imports.
297
+ "packages/core/src/release-floors.ts",
298
+ "packages/core/src/ci-identity.ts",
299
+ ]);
296
300
  expect(result.outputFiles.reduce((n, f) => n + f.contents.byteLength, 0)).toBeLessThan(24 * 1024);
297
301
  });
298
302
  });
@@ -48,14 +48,47 @@
48
48
  * the OIDC token. chant trades it, so the change's code never holds a token
49
49
  * another client could be traded for; a tool that needs the OIDC token
50
50
  * itself cannot plan under this block.
51
+ *
52
+ * Pulumi Cloud (#4549) is traded the same way, through its OAuth token
53
+ * exchange (`POST <apiUrl>/api/oauth/token`, RFC 8693), for a Pulumi access
54
+ * token in PULUMI_ACCESS_TOKEN. Its identities name the token asked for:
55
+ * `team:<name>`, `user:<login>`, `organization` or `organization:admin`. So
56
+ * the plan and record jobs preview with one token, the apply jobs run `up`
57
+ * with another, and the pull request's program never sees the `up` token.
58
+ * No long-lived Pulumi token sits in the forge's secrets.
51
59
  */
52
60
 
53
61
  import { readFileSync } from "node:fs";
62
+ import { NEXT_RELEASE } from "./release-floors";
54
63
 
55
- /** The clouds `ci.identity.cloud` names. */
64
+ /** The cloud providers `ci.identity.cloud` names. */
56
65
  export const CLOUDS = ["aws", "gcp", "azure"] as const;
57
66
  export type Cloud = (typeof CLOUDS)[number];
58
67
 
68
+ /**
69
+ * Every key of `ci.identity.cloud`: the cloud providers and Pulumi Cloud
70
+ * (#4549), whose access tokens are traded the same way. {@link CLOUDS}
71
+ * keeps the providers alone, as a Terraform product reads them.
72
+ */
73
+ export const IDENTITY_CLOUDS = [...CLOUDS, "pulumi"] as const;
74
+ export type IdentityCloud = (typeof IDENTITY_CLOUDS)[number];
75
+
76
+ /** The first chant that reads `ci.identity.cloud.pulumi` (#4549): a declaration that sets it needs this `minReader`. */
77
+ export const PULUMI_CLOUD_IDENTITY_FLOOR = NEXT_RELEASE;
78
+
79
+ /**
80
+ * The first chant that reads `ci.identity.cloud.azure.database` (#4572): the
81
+ * trade also asks Entra for a token Azure Database for PostgreSQL accepts.
82
+ * A declaration that sets it needs this `minReader`.
83
+ */
84
+ export const AZURE_DATABASE_TOKEN_FLOOR = NEXT_RELEASE;
85
+
86
+ /** The Entra scope of Azure Database for PostgreSQL's sign-in tokens (#4572). */
87
+ export const AZURE_DATABASE_SCOPE = "https://ossrdbms-aad.database.windows.net/.default";
88
+
89
+ /** The variable the trade sets to the database token with `azure.database` (#4572); the sql lexicon's `entra` token source reads it. */
90
+ export const AZURE_DATABASE_TOKEN_ENV = "AZURE_DATABASE_ACCESS_TOKEN";
91
+
59
92
  /** One rule: the environments, members and targets it covers, and their two identities. */
60
93
  export interface CloudIdentityRule {
61
94
  /** Environment-name globs. Absent: every environment. */
@@ -108,6 +141,29 @@ export interface AzureCloudIdentity {
108
141
  audience?: string;
109
142
  /** The Entra authority host, for an emulator. Default `https://login.microsoftonline.com`. */
110
143
  authority?: string;
144
+ /**
145
+ * Also trade for a database token (#4572): a second client credentials
146
+ * grant per identity, for {@link AZURE_DATABASE_SCOPE}, set as
147
+ * {@link AZURE_DATABASE_TOKEN_ENV}. The sql lexicon's `entra` token source
148
+ * signs in to Azure Database for PostgreSQL with it. Default false.
149
+ */
150
+ database?: boolean;
151
+ rules: CloudIdentityRule[];
152
+ }
153
+
154
+ /**
155
+ * Pulumi Cloud (#4549). The rules' identities name the access token traded
156
+ * for: `team:<name>` (a team token), `user:<login>` (a personal token),
157
+ * `organization` or `organization:admin` (an organization token). The
158
+ * organization's OIDC issuer policies decide which a forge token may get.
159
+ */
160
+ export interface PulumiCloudIdentity {
161
+ /** The Pulumi organization. */
162
+ organization: string;
163
+ /** The OIDC token's audience. Default `urn:pulumi:org:<organization>`. */
164
+ audience?: string;
165
+ /** 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. */
166
+ apiUrl?: string;
111
167
  rules: CloudIdentityRule[];
112
168
  }
113
169
 
@@ -116,6 +172,7 @@ export interface CloudIdentityDeclaration {
116
172
  aws?: AwsCloudIdentity;
117
173
  gcp?: GcpCloudIdentity;
118
174
  azure?: AzureCloudIdentity;
175
+ pulumi?: PulumiCloudIdentity;
119
176
  }
120
177
 
121
178
  /**
@@ -127,11 +184,13 @@ export interface CloudIdentityDeclaration {
127
184
  export interface CloudTradeSpec {
128
185
  aws?: { role?: string; targets?: Array<{ targets: string[]; role: string }>; region: string; audience: string; endpoint?: string };
129
186
  gcp?: { serviceAccount?: string; targets?: Array<{ targets: string[]; serviceAccount: string }>; provider: string; audience: string; stsEndpoint?: string; iamEndpoint?: string };
130
- azure?: { clientId?: string; targets?: Array<{ targets: string[]; clientId: string }>; tenantId: string; audience: string; subscriptionId?: string; authority?: string };
187
+ azure?: { clientId?: string; targets?: Array<{ targets: string[]; clientId: string }>; tenantId: string; audience: string; subscriptionId?: string; authority?: string; database?: boolean };
188
+ /** Pulumi Cloud (#4549): `token` is the identity, such as `team:deployers`. */
189
+ pulumi?: { token?: string; targets?: Array<{ targets: string[]; token: string }>; organization: string; audience: string; apiUrl?: string };
131
190
  }
132
191
 
133
192
  /** The key a cloud's trade names its identity under. */
134
- export const IDENTITY_KEY = { aws: "role", gcp: "serviceAccount", azure: "clientId" } as const;
193
+ export const IDENTITY_KEY = { aws: "role", gcp: "serviceAccount", azure: "clientId", pulumi: "token" } as const;
135
194
 
136
195
  /** A pipeline's two trades: the plan and record jobs', and the apply jobs'. */
137
196
  export interface PipelineCloudIdentity {
@@ -228,7 +287,7 @@ export function ruleFor(rules: readonly CloudIdentityRule[], env: string, member
228
287
  const providerPath = (p: string): string => p.replace(/^(https:)?\/\/iam\.googleapis\.com\//, "");
229
288
 
230
289
  /** Where each cloud trades, the same for every identity of the cloud. */
231
- function cloudPlace(decl: CloudIdentityDeclaration, cloud: Cloud): Record<string, string> {
290
+ function cloudPlace(decl: CloudIdentityDeclaration, cloud: IdentityCloud): Record<string, string | boolean> {
232
291
  if (cloud === "aws") {
233
292
  const a = decl.aws!;
234
293
  return { region: a.region ?? "us-east-1", audience: a.audience ?? "sts.amazonaws.com", ...(a.endpoint ? { endpoint: a.endpoint } : {}) };
@@ -243,17 +302,22 @@ function cloudPlace(decl: CloudIdentityDeclaration, cloud: Cloud): Record<string
243
302
  ...(g.iamEndpoint ? { iamEndpoint: g.iamEndpoint } : {}),
244
303
  };
245
304
  }
305
+ if (cloud === "pulumi") {
306
+ const p = decl.pulumi!;
307
+ return { organization: p.organization, audience: p.audience ?? pulumiAudience(p.organization), ...(p.apiUrl ? { apiUrl: p.apiUrl } : {}) };
308
+ }
246
309
  const z = decl.azure!;
247
310
  return {
248
311
  tenantId: z.tenantId,
249
312
  audience: z.audience ?? "api://AzureADTokenExchange",
250
313
  ...(z.subscriptionId ? { subscriptionId: z.subscriptionId } : {}),
251
314
  ...(z.authority ? { authority: z.authority } : {}),
315
+ ...(z.database ? { database: true } : {}),
252
316
  };
253
317
  }
254
318
 
255
319
  /** One cloud's trade: its own identity, the targets that take another, and where it trades. */
256
- function cloudTrade(decl: CloudIdentityDeclaration, cloud: Cloud, own: string | undefined, targets: Array<{ targets: string[]; id: string }>): Record<string, unknown> {
320
+ function cloudTrade(decl: CloudIdentityDeclaration, cloud: IdentityCloud, own: string | undefined, targets: Array<{ targets: string[]; id: string }>): Record<string, unknown> {
257
321
  const key = IDENTITY_KEY[cloud];
258
322
  return {
259
323
  ...(own !== undefined ? { [key]: own } : {}),
@@ -275,7 +339,7 @@ export function resolveCloudIdentity(decl: CloudIdentityDeclaration | undefined,
275
339
  if (!decl) return undefined;
276
340
  const plan: Record<string, unknown> = {};
277
341
  const apply: Record<string, unknown> = {};
278
- for (const cloud of CLOUDS) {
342
+ for (const cloud of IDENTITY_CLOUDS) {
279
343
  const rules = decl[cloud]?.rules;
280
344
  if (!rules) continue;
281
345
  const covering = rules.filter((r) => matches(r.environments, env) && matches(r.members, member));
@@ -299,7 +363,7 @@ export function resolveTargetCloudIdentity(decl: CloudIdentityDeclaration | unde
299
363
  if (!decl) return undefined;
300
364
  const plan: Record<string, unknown> = {};
301
365
  const apply: Record<string, unknown> = {};
302
- for (const cloud of CLOUDS) {
366
+ for (const cloud of IDENTITY_CLOUDS) {
303
367
  const rule = decl[cloud] && ruleFor(decl[cloud]!.rules, env, member, target);
304
368
  if (!rule) continue;
305
369
  plan[cloud] = cloudTrade(decl, cloud, rule.plan, []);
@@ -324,7 +388,7 @@ export const PR_ENV_IDENTITY_PROBE = "pr-1";
324
388
  export function resolvePrEnvCloudIdentity(decl: CloudIdentityDeclaration | undefined, member?: string): CloudTradeSpec | undefined {
325
389
  if (!decl) return undefined;
326
390
  const named: CloudIdentityDeclaration = {};
327
- for (const cloud of CLOUDS) {
391
+ for (const cloud of IDENTITY_CLOUDS) {
328
392
  const c = decl[cloud];
329
393
  if (c) (named as Record<string, unknown>)[cloud] = { ...c, rules: c.rules.filter((r) => r.environments !== undefined) };
330
394
  }
@@ -359,13 +423,13 @@ export function cloudIdentityGroups(decl: CloudIdentityDeclaration | undefined,
359
423
  const byKey = new Map<string, { base: string; group: CloudIdentityGroup }>();
360
424
  for (const target of targets) {
361
425
  const identity = resolveTargetCloudIdentity(decl, env, member, target);
362
- const key = JSON.stringify(identity ? CLOUDS.map((c) => [identity.plan[c] ? tradeIdentities({ [c]: identity.plan[c] }) : [], identity.apply[c] ? tradeIdentities({ [c]: identity.apply[c] }) : []]) : null);
426
+ const key = JSON.stringify(identity ? IDENTITY_CLOUDS.map((c) => [identity.plan[c] ? tradeIdentities({ [c]: identity.plan[c] }) : [], identity.apply[c] ? tradeIdentities({ [c]: identity.apply[c] }) : []]) : null);
363
427
  const at = byKey.get(key);
364
428
  if (at) {
365
429
  at.group.targets.push(target);
366
430
  continue;
367
431
  }
368
- const rule = CLOUDS.map((c) => decl?.[c] && ruleFor(decl[c]!.rules, env, member, target)).find((r) => r?.targets !== undefined);
432
+ const rule = IDENTITY_CLOUDS.map((c) => decl?.[c] && ruleFor(decl[c]!.rules, env, member, target)).find((r) => r?.targets !== undefined);
369
433
  const named = rule ? (rule.name ?? (nameFrom(rule.targets![0]!) || "group")) : DEFAULT_IDENTITY_GROUP;
370
434
  // An Op wave's own jobs are `decide` and `share-<i>` (./op/op-waves.ts), so a group takes neither name.
371
435
  const base = named === "decide" || /^share-\d+$/.test(named) ? `${named}-targets` : named;
@@ -420,9 +484,9 @@ export function oneApplyIdentityProblem(spec: CloudTradeSpec): string | undefine
420
484
  return undefined;
421
485
  }
422
486
 
423
- /** The clouds a trade covers, in {@link CLOUDS} order. */
424
- export function tradedClouds(spec: CloudTradeSpec): Cloud[] {
425
- return CLOUDS.filter((c) => spec[c] !== undefined);
487
+ /** The clouds a trade covers, in {@link IDENTITY_CLOUDS} order. */
488
+ export function tradedClouds(spec: CloudTradeSpec): IdentityCloud[] {
489
+ return IDENTITY_CLOUDS.filter((c) => spec[c] !== undefined);
426
490
  }
427
491
 
428
492
  /** Every identity a trade names, once each: the roles, the service accounts, the client ids, its targets' too (#4332). */
@@ -444,23 +508,47 @@ export function tradeIdentities(spec: CloudTradeSpec): string[] {
444
508
  */
445
509
  export function cloudIdentityProblems(decl: CloudIdentityDeclaration): Array<{ pointer: string; message: string }> {
446
510
  const out: Array<{ pointer: string; message: string }> = [];
447
- for (const cloud of CLOUDS) {
511
+ for (const cloud of IDENTITY_CLOUDS) {
448
512
  const rules = decl[cloud]?.rules ?? [];
449
513
  const applies = new Set(rules.map((r) => r.apply));
450
514
  rules.forEach((r, i) => {
451
515
  const pointer = `/ci/identity/cloud/${cloud}/rules/${i}`;
452
516
  if (r.plan === r.apply) out.push({ pointer, message: `ci.identity.cloud.${cloud}.rules[${i}] plans and applies as ${r.plan}; the plan runs the pull request's code, so give it an identity of its own` });
453
517
  else if (applies.has(r.plan)) out.push({ pointer, message: `ci.identity.cloud.${cloud}.rules[${i}] plans as ${r.plan}, which another rule applies as; the plan runs the pull request's code, so give it an identity no rule applies as` });
518
+ if (cloud === "pulumi") {
519
+ for (const side of ["plan", "apply"] as const) {
520
+ if (!pulumiTokenRequest(r[side])) out.push({ pointer: `${pointer}/${side}`, message: `ci.identity.cloud.pulumi.rules[${i}].${side} is ${JSON.stringify(r[side])}; a Pulumi Cloud identity is team:<name>, user:<login>, organization or organization:admin` });
521
+ }
522
+ }
454
523
  });
455
524
  }
456
525
  return out;
457
526
  }
458
527
 
528
+ /** The OIDC audience Pulumi Cloud's token exchange takes for `organization` (#4549). */
529
+ export function pulumiAudience(organization: string): string {
530
+ return `urn:pulumi:org:${organization}`;
531
+ }
532
+
533
+ /**
534
+ * The token a Pulumi Cloud identity asks the exchange for (#4549): its
535
+ * `requested_token_type` and `scope`, or undefined when `identity` is none
536
+ * of `team:<name>`, `user:<login>`, `organization`, `organization:admin`.
537
+ * The trade script reads identities the same way.
538
+ */
539
+ export function pulumiTokenRequest(identity: string): { tokenType: string; scope?: string } | undefined {
540
+ const m = /^(team|user):([^\s:]+)$/.exec(identity);
541
+ if (m) return { tokenType: `urn:pulumi:token-type:access_token:${m[1] === "team" ? "team" : "personal"}`, scope: identity };
542
+ if (identity === "organization") return { tokenType: "urn:pulumi:token-type:access_token:organization" };
543
+ if (identity === "organization:admin") return { tokenType: "urn:pulumi:token-type:access_token:organization", scope: "admin" };
544
+ return undefined;
545
+ }
546
+
459
547
  /** The variable the trade step reads its {@link CloudTradeSpec} from, as JSON. */
460
548
  export const TRADE_SPEC_ENV = "CHANT_CLOUD_TRADE";
461
549
 
462
- /** The GitLab `id_tokens` variable a cloud's token comes in: `CHANT_ID_TOKEN_AWS`, `_GCP`, `_AZURE`. */
463
- export function idTokenVar(cloud: Cloud): string {
550
+ /** The GitLab `id_tokens` variable a cloud's token comes in: `CHANT_ID_TOKEN_AWS`, `_GCP`, `_AZURE`, `_PULUMI`. */
551
+ export function idTokenVar(cloud: IdentityCloud): string {
464
552
  return `CHANT_ID_TOKEN_${cloud.toUpperCase()}`;
465
553
  }
466
554
 
@@ -469,13 +557,14 @@ export function idTokenVar(cloud: Cloud): string {
469
557
  * the GitLab `id_tokens` variables the trade reads. A step that runs the
470
558
  * change's code starts without them, once the trade is done.
471
559
  */
472
- export const OIDC_REQUEST_VARS = ["ACTIONS_ID_TOKEN_REQUEST_TOKEN", "ACTIONS_ID_TOKEN_REQUEST_URL", ...CLOUDS.map(idTokenVar), TRADE_SPEC_ENV] as const;
560
+ export const OIDC_REQUEST_VARS = ["ACTIONS_ID_TOKEN_REQUEST_TOKEN", "ACTIONS_ID_TOKEN_REQUEST_URL", ...IDENTITY_CLOUDS.map(idTokenVar), TRADE_SPEC_ENV] as const;
473
561
 
474
562
  /** The variables the trade sets, per cloud. */
475
- export const TRADED_VARS: Record<Cloud, readonly string[]> = {
563
+ export const TRADED_VARS: Record<IdentityCloud, readonly string[]> = {
476
564
  aws: ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_SESSION_TOKEN", "AWS_REGION", "AWS_DEFAULT_REGION"],
477
565
  gcp: ["GOOGLE_OAUTH_ACCESS_TOKEN", "CLOUDSDK_AUTH_ACCESS_TOKEN"],
478
- azure: ["AZURE_ACCESS_TOKEN", "AZURE_CLIENT_ID", "AZURE_TENANT_ID", "ARM_CLIENT_ID", "ARM_TENANT_ID", "AZURE_SUBSCRIPTION_ID", "ARM_SUBSCRIPTION_ID"],
566
+ azure: ["AZURE_ACCESS_TOKEN", "AZURE_CLIENT_ID", "AZURE_TENANT_ID", "ARM_CLIENT_ID", "ARM_TENANT_ID", "AZURE_SUBSCRIPTION_ID", "ARM_SUBSCRIPTION_ID", AZURE_DATABASE_TOKEN_ENV],
567
+ pulumi: ["PULUMI_ACCESS_TOKEN", "PULUMI_BACKEND_URL"],
479
568
  };
480
569
 
481
570
  /**
@@ -497,7 +586,7 @@ export const CLOUD_TARGETS_ENV = "CHANT_CLOUD_TARGETS";
497
586
  /** The file {@link CLOUD_TARGETS_ENV} names: per cloud, the job's own identity, the targets that take another, and each identity's variables. */
498
587
  export interface CloudTargetsFile {
499
588
  version: 1;
500
- clouds: Partial<Record<Cloud, { default?: string; targets: Array<{ targets: string[]; identity: string }>; vars: Record<string, Record<string, string>> }>>;
589
+ clouds: Partial<Record<IdentityCloud, { default?: string; targets: Array<{ targets: string[]; identity: string }>; vars: Record<string, Record<string, string>> }>>;
501
590
  }
502
591
 
503
592
  /**
@@ -557,8 +646,21 @@ export const TRADE_JS = [
557
646
  'for(const cid of ids("azure")){',
558
647
  'const at=json(await post(host+"/"+encodeURIComponent(z.tenantId)+"/oauth2/v2.0/token",{"content-type":"application/x-www-form-urlencoded"},new URLSearchParams({client_id:cid,scope:"https://management.azure.com/.default",grant_type:"client_credentials",client_assertion_type:"urn:ietf:params:oauth:client-assertion-type:jwt-bearer",client_assertion:tok}).toString()),"Entra").access_token;',
559
648
  'if(!clean(at))throw new Error("Entra gave no token for "+cid);',
560
- "by.azure[cid]={AZURE_ACCESS_TOKEN:at,AZURE_CLIENT_ID:cid,AZURE_TENANT_ID:z.tenantId,ARM_CLIENT_ID:cid,ARM_TENANT_ID:z.tenantId,...(z.subscriptionId?{AZURE_SUBSCRIPTION_ID:z.subscriptionId,ARM_SUBSCRIPTION_ID:z.subscriptionId}:{})};secrets.push(at);said.push(cid)}",
649
+ // #4572: with azure.database, a second grant for Azure Database for PostgreSQL's scope.
650
+ `let db;if(z.database){db=json(await post(host+"/"+encodeURIComponent(z.tenantId)+"/oauth2/v2.0/token",{"content-type":"application/x-www-form-urlencoded"},new URLSearchParams({client_id:cid,scope:${JSON.stringify(AZURE_DATABASE_SCOPE)},grant_type:"client_credentials",client_assertion_type:"urn:ietf:params:oauth:client-assertion-type:jwt-bearer",client_assertion:tok}).toString()),"Entra").access_token;if(!clean(db))throw new Error("Entra gave no database token for "+cid);secrets.push(db)}`,
651
+ `by.azure[cid]={AZURE_ACCESS_TOKEN:at,AZURE_CLIENT_ID:cid,AZURE_TENANT_ID:z.tenantId,ARM_CLIENT_ID:cid,ARM_TENANT_ID:z.tenantId,...(z.subscriptionId?{AZURE_SUBSCRIPTION_ID:z.subscriptionId,ARM_SUBSCRIPTION_ID:z.subscriptionId}:{}),...(db?{${AZURE_DATABASE_TOKEN_ENV}:db}:{})};secrets.push(at);said.push(cid)}`,
561
652
  "if(z.clientId)Object.assign(vars,by.azure[z.clientId])}",
653
+ // #4549: Pulumi Cloud's OAuth token exchange, one access token per identity (pulumiTokenRequest).
654
+ 'if(spec.pulumi){const p=spec.pulumi;const tok=await idToken("pulumi",p.audience);by.pulumi={};',
655
+ 'const api=trim(p.apiUrl||"https://api.pulumi.com");',
656
+ 'for(const id of ids("pulumi")){',
657
+ 'const m=/^(team|user):([^\\s:]+)$/.exec(id),org=id==="organization"||id==="organization:admin";if(!m&&!org)throw new Error("Pulumi Cloud has no token for "+id);',
658
+ 'const f={audience:"urn:pulumi:org:"+p.organization,grant_type:"urn:ietf:params:oauth:grant-type:token-exchange",subject_token_type:"urn:ietf:params:oauth:token-type:id_token",requested_token_type:"urn:pulumi:token-type:access_token:"+(m?(m[1]==="team"?"team":"personal"):"organization"),subject_token:tok};',
659
+ 'if(m)f.scope=id;else if(id==="organization:admin")f.scope="admin";',
660
+ 'const at=json(await post(api+"/api/oauth/token",{"content-type":"application/x-www-form-urlencoded",accept:"application/json"},new URLSearchParams(f).toString()),"Pulumi Cloud").access_token;',
661
+ 'if(!clean(at))throw new Error("Pulumi Cloud gave no token for "+id);',
662
+ 'by.pulumi[id]={PULUMI_ACCESS_TOKEN:at,...(p.apiUrl?{PULUMI_BACKEND_URL:api}:{})};secrets.push(at);said.push("Pulumi Cloud "+id)}',
663
+ "if(p.token)Object.assign(vars,by.pulumi[p.token])}",
562
664
  // #4332: with targets, every identity's variables go in a file of their own, outside the checkout.
563
665
  'const clouds=Object.keys(by);if(clouds.some((c)=>(spec[c].targets||[]).length>0)){',
564
666
  'const doc={version:1,clouds:{}};for(const c of clouds){const s=spec[c];doc.clouds[c]={...(s[KEY[c]]?{default:s[KEY[c]]}:{}),targets:(s.targets||[]).map((t)=>({targets:t.targets,identity:t[KEY[c]]})),vars:by[c]}}',
@@ -614,7 +716,7 @@ export function targetCloudEnv(env: Readonly<Record<string, string | undefined>>
614
716
  const path = env[CLOUD_TARGETS_ENV];
615
717
  if (!path) return out;
616
718
  const file = readTargetsFile(path, read);
617
- for (const cloud of CLOUDS) {
719
+ for (const cloud of IDENTITY_CLOUDS) {
618
720
  const c = file.clouds[cloud];
619
721
  if (!c) continue;
620
722
  const id = targetIdentityIn(c, target);
@@ -0,0 +1,101 @@
1
+ import { afterEach, describe, expect, test } from "vitest";
2
+ import {
3
+ activeProductWords,
4
+ approveLine,
5
+ assertProductWords,
6
+ CHANT_WORDS,
7
+ commentLine,
8
+ overrideLine,
9
+ parseProductComment,
10
+ productStatusContext,
11
+ productWordsProblems,
12
+ resolveProductWords,
13
+ setActiveProductWords,
14
+ withProductWords,
15
+ } from "./ci-product-words";
16
+ import { PLYWOOD, TERRAGUCCI, YODEL } from "./__fixtures__/product-words";
17
+
18
+ afterEach(() => {
19
+ setActiveProductWords(undefined);
20
+ });
21
+
22
+ describe("a CI product's words (#4550)", () => {
23
+ test("every slot defaults to chant's word", () => {
24
+ expect(resolveProductWords({})).toEqual(CHANT_WORDS);
25
+ expect(productStatusContext(CHANT_WORDS, "plan")).toBe("chant/plan");
26
+ expect(commentLine(CHANT_WORDS, "apply")).toBe("/chant apply");
27
+ });
28
+
29
+ test("a product's status contexts, comments and approve lines are its own", () => {
30
+ const w = assertProductWords(PLYWOOD);
31
+ expect(productStatusContext(w, "plan")).toBe("plywood/preview");
32
+ expect(productStatusContext(w, "plan", "shop-dev")).toBe("plywood/preview/shop-dev");
33
+ expect(commentLine(w, "apply")).toBe("/plywood up");
34
+ expect(approveLine(w, { op: "pulumi-up", gate: "wave-2", digest: "sha256:abc" })).toBe("plywood approve wave-2 --plan sha256:abc --sign");
35
+ expect(overrideLine(w, { op: "policy-override", gate: "up", rules: ["b", "a"] })).toBe("plywood override up --rule a --rule b --reason <text>");
36
+ });
37
+
38
+ test("the approve and override templates take {target} (#4574)", () => {
39
+ const yodel = assertProductWords({ product: "yodel", approve: "yodel approve {target} --plan {digest}", override: "yodel override {target} --rule {rule} --reason {reason}" });
40
+ expect(approveLine(yodel, { op: "migrate", gate: "wave-1", digest: "sha256:abc", target: "prod/acme" })).toBe("yodel approve prod/acme --plan sha256:abc");
41
+ expect(overrideLine(yodel, { op: "policy-override", rules: ["no-drop"], target: "prod/acme", reason: "planned" })).toBe("yodel override prod/acme --rule no-drop --reason planned");
42
+ });
43
+
44
+ test("the apply mode follows the words: waves on merge for a product with an op or per-wave approvals, else a release (#4601)", () => {
45
+ expect(CHANT_WORDS.applyMode).toBe("release");
46
+ expect(assertProductWords(PLYWOOD).applyMode).toBe("on-merge");
47
+ expect(assertProductWords(TERRAGUCCI).applyMode).toBe("on-merge");
48
+ expect(assertProductWords(YODEL).applyMode).toBe("on-merge");
49
+ expect(assertProductWords({ product: "acme" }).applyMode).toBe("release");
50
+ expect(assertProductWords({ ...PLYWOOD, applyMode: "before-merge" }).applyMode).toBe("before-merge");
51
+ expect(productWordsProblems(resolveProductWords({ applyMode: "later" as never })).some((p) => /applyMode is "later"/.test(p))).toBe(true);
52
+ });
53
+
54
+ test("words that could reach a shell or collide are refused", () => {
55
+ const bad = resolveProductWords({ product: "Ply wood", stages: { plan: "apply" }, commands: { "$(x)": "apply", go: "deploy" as never }, approve: "x {op} {who}; rm" });
56
+ const problems = productWordsProblems(bad, { jobs: ["plan"] });
57
+ expect(problems.some((p) => /product is "Ply wood"/.test(p))).toBe(true);
58
+ expect(problems.some((p) => /stages.apply and stages.plan are both "apply"/.test(p))).toBe(true);
59
+ expect(problems.some((p) => /commands.\$\(x\)/.test(p))).toBe(true);
60
+ expect(problems.some((p) => /needs a apply job/.test(p))).toBe(true);
61
+ expect(problems.some((p) => /\{who\}/.test(p))).toBe(true);
62
+ expect(problems.some((p) => /shell syntax/.test(p))).toBe(true);
63
+ expect(() => assertProductWords(PLYWOOD, { jobs: ["plan"] })).toThrow(/commands.up needs a apply job/);
64
+ });
65
+
66
+ test("the active words are set for a command and put back after it", async () => {
67
+ expect(activeProductWords()).toBe(CHANT_WORDS);
68
+ const seen = await withProductWords(PLYWOOD, async () => activeProductWords().product);
69
+ expect(seen).toBe("plywood");
70
+ expect(activeProductWords()).toBe(CHANT_WORDS);
71
+ });
72
+ });
73
+
74
+ describe("the comment grammar (moved from terragucci's comment.ts)", () => {
75
+ const tg = assertProductWords(TERRAGUCCI);
76
+ const pw = assertProductWords(PLYWOOD);
77
+
78
+ test("reads the product's commands and nothing addressed elsewhere", () => {
79
+ expect(parseProductComment(pw, "/plywood up")).toEqual({ kind: "apply" });
80
+ expect(parseProductComment(pw, "/plywood up wave-2")).toEqual({ kind: "apply", wave: 2 });
81
+ expect(parseProductComment(pw, "/plywood preview shop-dev")).toEqual({ kind: "plan", member: "shop-dev" });
82
+ expect(parseProductComment(pw, "/terragucci apply")).toBeUndefined();
83
+ expect(parseProductComment(tg, "/terragucci lock")).toEqual({ kind: "lock" });
84
+ expect(parseProductComment(tg, "/terragucci agent rename the bucket")).toEqual({ kind: "agent", ask: "rename the bucket" });
85
+ });
86
+
87
+ test("refuses what it never runs, and anything unsafe", () => {
88
+ expect(parseProductComment(pw, "/plywood approve up")).toMatchObject({ kind: "refused", reason: expect.stringMatching(/never runs `approve`/) });
89
+ expect(parseProductComment(pw, "/plywood up\nrm -rf /")).toMatchObject({ kind: "refused" });
90
+ expect(parseProductComment(pw, "/plywood preview ../etc")).toMatchObject({ kind: "refused" });
91
+ expect(parseProductComment(pw, "/plywood up now")).toMatchObject({ kind: "refused" });
92
+ expect(parseProductComment(pw, "/plywood lock everything")).toMatchObject({ kind: "refused" });
93
+ });
94
+
95
+ test("an alias reads only where its variable turns it on", () => {
96
+ expect(parseProductComment(tg, "atlantis plan -d envs/dev/orders")).toBeUndefined();
97
+ expect(parseProductComment(tg, "atlantis plan -d ./envs/dev/orders/", { TG_ATLANTIS_COMMENTS: "1" })).toEqual({ kind: "plan", member: "envs/dev/orders" });
98
+ expect(parseProductComment(tg, "atlantis apply", { TG_ATLANTIS_COMMENTS: "1" })).toEqual({ kind: "apply" });
99
+ expect(parseProductComment(tg, "atlantis plan -w staging", { TG_ATLANTIS_COMMENTS: "1" })).toMatchObject({ kind: "refused" });
100
+ });
101
+ });