@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,527 @@
1
+ /**
2
+ * The clouds' side of the check (#4608), lifted from terragucci's
3
+ * `forge check`:
4
+ *
5
+ * AWS each role's trust admits each job the contract names and no
6
+ * other subject or audience (iam GetRole, Signature Version 4,
7
+ * signed with chant's one signer, ../cloud-lister/sigv4.ts)
8
+ * GCP the workload identity provider's attribute condition is the
9
+ * contract's or narrower
10
+ * Azure each app's federated credentials are the contract's, and no other
11
+ *
12
+ * A cloud with no credentials in the environment gets `not-checked` rows.
13
+ */
14
+
15
+ import { join } from "node:path";
16
+ import { readFileSync } from "node:fs";
17
+ import { homedir } from "node:os";
18
+ import type { AwsStaticCredentials } from "../cloud-lister/credentials";
19
+ import { sha256Hex, signV4 } from "../cloud-lister/sigv4";
20
+ import { encodeStrict, xmlText } from "../object-store/common";
21
+ import type { ForgeFetch } from "../pr-forge";
22
+ import type { ForgeCheckContract, JobToken } from "./contract";
23
+ import { ReadOnlyError } from "./read-only";
24
+ import { SCOPES, unique, type CheckRow, type CheckStatus, type ForgeCheckDeps } from "./types";
25
+
26
+ // ── AWS ──────────────────────────────────────────────────────────────────────
27
+
28
+ /** Static credentials from the environment, or from the shared credentials file's profile (AWS_PROFILE, else default). */
29
+ export function awsCredentials(env: Record<string, string | undefined>, readFile: (path: string) => string | undefined): AwsStaticCredentials | undefined {
30
+ if (env.AWS_ACCESS_KEY_ID && env.AWS_SECRET_ACCESS_KEY) return { accessKeyId: env.AWS_ACCESS_KEY_ID, secretAccessKey: env.AWS_SECRET_ACCESS_KEY, ...(env.AWS_SESSION_TOKEN ? { sessionToken: env.AWS_SESSION_TOKEN } : {}) };
31
+ const file = env.AWS_SHARED_CREDENTIALS_FILE || join(env.HOME || homedir(), ".aws", "credentials");
32
+ const text = readFile(file);
33
+ if (!text) return undefined;
34
+ const profile = env.AWS_PROFILE || env.AWS_DEFAULT_PROFILE || "default";
35
+ let section = "";
36
+ const kv: Record<string, string> = {};
37
+ for (const line of text.split(/\r?\n/)) {
38
+ const head = /^\s*\[([^\]]+)\]\s*$/.exec(line);
39
+ if (head) section = head[1]!.trim();
40
+ else if (section === profile) {
41
+ const m = /^\s*([A-Za-z_]+)\s*=\s*(.*?)\s*$/.exec(line);
42
+ if (m) kv[m[1]!.toLowerCase()] = m[2]!;
43
+ }
44
+ }
45
+ if (!kv.aws_access_key_id || !kv.aws_secret_access_key) return undefined;
46
+ return { accessKeyId: kv.aws_access_key_id, secretAccessKey: kv.aws_secret_access_key, ...(kv.aws_session_token ? { sessionToken: kv.aws_session_token } : {}) };
47
+ }
48
+
49
+ /** IAM's endpoint and signing region for a role's partition. */
50
+ function iamEndpoint(partition: string, env: Record<string, string | undefined>): { url: string; region: string } {
51
+ const region = partition === "aws-cn" ? "cn-north-1" : partition === "aws-us-gov" ? "us-gov-west-1" : "us-east-1";
52
+ const url = env.AWS_ENDPOINT_URL_IAM || (partition === "aws-cn" ? "https://iam.cn-north-1.amazonaws.com.cn" : partition === "aws-us-gov" ? "https://iam.us-gov.amazonaws.com" : "https://iam.amazonaws.com");
53
+ return { url: url.replace(/\/+$/, ""), region };
54
+ }
55
+
56
+ /** One job a trust must admit: the token's provider (the issuer without https://), `sub` (a pattern with `like`) and `aud`. */
57
+ export interface TrustJob {
58
+ provider: string;
59
+ sub: string;
60
+ like: boolean;
61
+ aud: string;
62
+ }
63
+
64
+ /** The issuer as AWS names its OIDC provider and condition keys: the URL without its scheme. */
65
+ export const issuerKey = (issuer: string): string => issuer.replace(/^https?:\/\//, "").replace(/\/+$/, "");
66
+
67
+ /** The trust job a token and audience make. */
68
+ export const trustJob = (token: JobToken, aud: string): TrustJob => ({ provider: issuerKey(token.issuer), sub: token.subject, like: token.pattern, aud });
69
+
70
+ /** The partition and account of an IAM role ARN; placeholders when `arn` is not one. */
71
+ function arnParts(arn: string | undefined): { partition: string; account: string } {
72
+ const m = arn?.match(/^arn:([^:]+):iam::(\d{12}):/);
73
+ return m ? { partition: m[1]!, account: m[2]! } : { partition: "aws", account: "<account-id>" };
74
+ }
75
+
76
+ /**
77
+ * An IAM role's trust policy for the jobs that take it, as a JSON string: a
78
+ * statement per job, AssumeRoleWithWebIdentity from the forge's OIDC
79
+ * provider in the role's account when the token's `aud` and `sub` are that
80
+ * job's (StringLike for a subject pattern). AWS reads no other claim of a
81
+ * GitLab token.
82
+ */
83
+ export function awsTrustPolicy(jobs: readonly { token: JobToken; audience: string }[], role?: string): string {
84
+ const { partition, account } = arnParts(role);
85
+ const seen = new Set<string>();
86
+ const statements: unknown[] = [];
87
+ for (const { token, audience } of jobs) {
88
+ const key = issuerKey(token.issuer);
89
+ const condition: Record<string, Record<string, string>> = token.pattern
90
+ ? { StringEquals: { [`${key}:aud`]: audience }, StringLike: { [`${key}:sub`]: token.subject } }
91
+ : { StringEquals: { [`${key}:aud`]: audience, [`${key}:sub`]: token.subject } };
92
+ const statement = { Effect: "Allow", Principal: { Federated: `arn:${partition}:iam::${account}:oidc-provider/${key}` }, Action: "sts:AssumeRoleWithWebIdentity", Condition: condition };
93
+ const id = JSON.stringify(statement);
94
+ if (seen.has(id)) continue;
95
+ seen.add(id);
96
+ statements.push(statement);
97
+ }
98
+ return JSON.stringify({ Version: "2012-10-17", Statement: statements });
99
+ }
100
+
101
+ const asList = (v: unknown): string[] => (typeof v === "string" ? [v] : Array.isArray(v) ? v.filter((x): x is string => typeof x === "string") : []);
102
+ const providerOf = (federated: string): string => (federated === "*" ? "*" : (federated.split(":oidc-provider/")[1] ?? federated));
103
+
104
+ /** The jobs a trust policy (JSON) names, as {@link awsTrustPolicy} writes them. */
105
+ export function trustJobs(policy: string): TrustJob[] {
106
+ const doc = JSON.parse(policy) as { Statement?: { Principal?: { Federated?: string }; Condition?: Record<string, Record<string, string>> }[] };
107
+ return (doc.Statement ?? []).flatMap((st) => {
108
+ const provider = providerOf(st.Principal?.Federated ?? "");
109
+ const eq = st.Condition?.StringEquals ?? {};
110
+ const like = st.Condition?.StringLike ?? {};
111
+ const sub = eq[`${provider}:sub`] ?? like[`${provider}:sub`];
112
+ const aud = eq[`${provider}:aud`];
113
+ return sub === undefined || aud === undefined ? [] : [{ provider, sub, like: eq[`${provider}:sub`] === undefined, aud }];
114
+ });
115
+ }
116
+
117
+ /** IAM's StringLike: `*` any run of characters, `?` one. */
118
+ export const likeMatch = (pattern: string, s: string): boolean => new RegExp(`^${pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*").replace(/\?/g, ".")}$`).test(s);
119
+ export const hasWildcard = (s: string): boolean => /[*?]/.test(s);
120
+
121
+ /** A value a live trust holds, and whether it is a pattern. */
122
+ export interface LiveValue {
123
+ value: string;
124
+ like: boolean;
125
+ }
126
+
127
+ /** A live statement's values for `<provider>:<claim>` under StringEquals and StringLike (with ForAnyValue/ForAllValues and IfExists); null when no such condition constrains it. */
128
+ function conditionValues(cond: Record<string, Record<string, unknown>> | undefined, provider: string, claim: string): LiveValue[] | null {
129
+ const out: LiveValue[] = [];
130
+ let constrained = false;
131
+ for (const [op, keys] of Object.entries(cond ?? {})) {
132
+ const base = op.replace(/^(ForAnyValue|ForAllValues):/, "").replace(/IfExists$/, "");
133
+ if (base !== "StringEquals" && base !== "StringLike") continue;
134
+ for (const [k, v] of Object.entries(keys ?? {})) {
135
+ if (k.toLowerCase() !== `${provider}:${claim}`.toLowerCase()) continue;
136
+ constrained = true;
137
+ for (const value of asList(v)) out.push({ value, like: base === "StringLike" && hasWildcard(value) });
138
+ }
139
+ }
140
+ return constrained ? out : null;
141
+ }
142
+
143
+ /** Whether a live value admits no token the job's own does not: the same value, a literal the job's pattern matches, or a narrower pattern. */
144
+ export function within(v: LiveValue, expected: string, expectedLike: boolean): boolean {
145
+ if (!v.like) return expectedLike ? likeMatch(expected, v.value) : v.value === expected;
146
+ if (!expectedLike) return false;
147
+ if (v.value === expected) return true;
148
+ const prefix = expected.endsWith("*") && !hasWildcard(expected.slice(0, -1)) ? expected.slice(0, -1) : undefined;
149
+ return prefix !== undefined && v.value.startsWith(prefix);
150
+ }
151
+
152
+ /** Whether a live value admits the job's token. */
153
+ export function admits(v: LiveValue, expected: string, expectedLike: boolean): boolean {
154
+ if (expectedLike) return v.like && v.value === expected;
155
+ return v.like ? likeMatch(v.value, expected) : v.value === expected;
156
+ }
157
+
158
+ export const describeJob = (j: TrustJob): string => `sub ${j.sub}${j.like ? " (like)" : ""} aud ${j.aud}`;
159
+
160
+ function asStatements(doc: unknown): { Effect?: string; Action?: unknown; Principal?: unknown; Condition?: Record<string, Record<string, unknown>> }[] {
161
+ const s = (doc as { Statement?: unknown } | null)?.Statement;
162
+ return (Array.isArray(s) ? s : s ? [s] : []) as ReturnType<typeof asStatements>;
163
+ }
164
+
165
+ /**
166
+ * Compare a role's live trust document with the jobs it must admit: each job
167
+ * admitted, and every web identity statement no wider than some job (its
168
+ * provider, each sub and aud pair). Returns the problems and a summary of
169
+ * what the live document admits.
170
+ */
171
+ export function compareTrust(doc: unknown, jobs: readonly TrustJob[], account: string | undefined): { problems: string[]; found: string } {
172
+ const problems: string[] = [];
173
+ const seen: string[] = [];
174
+ const live = asStatements(doc).filter((st) => st.Effect === "Allow" && asList(st.Action).some((a) => a === "sts:AssumeRoleWithWebIdentity" || a === "sts:*" || a === "*"));
175
+ type Grant = { provider: string; account?: string; subs: LiveValue[] | null; auds: LiveValue[] | null };
176
+ const grants: Grant[] = live.flatMap((st) => {
177
+ const principal = st.Principal === "*" ? ["*"] : asList((st.Principal as { Federated?: unknown } | undefined)?.Federated);
178
+ return principal.map((f) => {
179
+ const provider = providerOf(f);
180
+ const acct = /^arn:[^:]+:iam::(\d{12}):/.exec(f)?.[1];
181
+ return { provider, ...(acct ? { account: acct } : {}), subs: conditionValues(st.Condition, provider, "sub"), auds: conditionValues(st.Condition, provider, "aud") };
182
+ });
183
+ });
184
+ for (const g of grants) {
185
+ const fmt = (vs: LiveValue[] | null): string => (vs === null ? "any" : vs.map((v) => v.value).join(" | ") || "none");
186
+ seen.push(`${g.provider}: sub ${fmt(g.subs)} aud ${fmt(g.auds)}`);
187
+ const mine = jobs.filter((j) => j.provider === g.provider);
188
+ if (g.provider === "*" || mine.length === 0) {
189
+ problems.push(`trusts ${g.provider === "*" ? "any principal" : `the provider ${g.provider}`}, which no job of this role presents`);
190
+ continue;
191
+ }
192
+ if (account && g.account && g.account !== account) problems.push(`trusts ${g.provider} in account ${g.account}, not the role's ${account}`);
193
+ if (g.subs === null) problems.push(`a statement for ${g.provider} has no sub condition, so it admits any subject`);
194
+ if (g.auds === null) problems.push(`a statement for ${g.provider} has no aud condition, so it admits any audience`);
195
+ if (g.subs === null || g.auds === null) continue;
196
+ for (const s of g.subs) {
197
+ for (const a of g.auds) {
198
+ if (!mine.some((j) => within(s, j.sub, j.like) && within(a, j.aud, false))) problems.push(`admits sub ${s.value}${s.like ? " (like)" : ""} with aud ${a.value}, which no job of this role presents`);
199
+ }
200
+ }
201
+ }
202
+ for (const j of jobs) {
203
+ const ok = grants.some((g) => g.provider === j.provider && (!account || !g.account || g.account === account) && (g.subs === null || g.subs.some((s) => admits(s, j.sub, j.like))) && (g.auds === null || g.auds.some((a) => admits(a, j.aud, false))));
204
+ if (!ok) problems.push(`does not admit ${describeJob(j)}`);
205
+ }
206
+ return { problems: unique(problems), found: seen.length ? seen.join("; ") : "no web identity statement" };
207
+ }
208
+
209
+ function readIfThere(path: string): string | undefined {
210
+ try {
211
+ return readFileSync(path, "utf-8");
212
+ } catch {
213
+ return undefined;
214
+ }
215
+ }
216
+
217
+ /** Every role the contract's jobs take, with the jobs each must admit. */
218
+ export function rolesOf(c: ForgeCheckContract): Map<string, TrustJob[]> {
219
+ const roles = new Map<string, TrustJob[]>();
220
+ for (const j of c.jobs) {
221
+ if (!j.aws) continue;
222
+ const job = trustJob(j.token, j.aws.audience);
223
+ for (const arn of j.aws.roles) {
224
+ const have = roles.get(arn) ?? [];
225
+ if (!have.some((h) => JSON.stringify(h) === JSON.stringify(job))) have.push(job);
226
+ roles.set(arn, have);
227
+ }
228
+ }
229
+ return roles;
230
+ }
231
+
232
+ export async function awsRows(c: ForgeCheckContract, fetch: ForgeFetch, deps: ForgeCheckDeps, product = "chant"): Promise<CheckRow[]> {
233
+ const roles = rolesOf(c);
234
+ if (roles.size === 0) return [];
235
+ const creds = awsCredentials(deps.env, deps.readFile ?? readIfThere);
236
+ const rows: CheckRow[] = [];
237
+ for (const [arn, jobs] of roles) {
238
+ const expected = jobs.map(describeJob).join("; ");
239
+ const row = (found: string, status: CheckStatus): number => rows.push({ where: "aws", check: "trust", subject: arn, expected, found, status });
240
+ if (!creds) {
241
+ row("not checked: no AWS credentials (AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY, or a profile with static keys)", "not-checked");
242
+ continue;
243
+ }
244
+ const m = /^arn:([^:]+):iam::(\d{12}):role\/(?:.*\/)?([^/]+)$/.exec(arn);
245
+ if (!m) {
246
+ row("not a role ARN, so it cannot be read", "unknown");
247
+ continue;
248
+ }
249
+ const [, partition, account, name] = m;
250
+ const { url: base, region } = iamEndpoint(partition!, deps.env);
251
+ // A form POST, as the AWS SDKs send it: IAM takes the Query API as GET or POST, and floci answers only POST.
252
+ const url = `${base}/`;
253
+ const body = `Action=GetRole&RoleName=${encodeStrict(name!)}&Version=2010-05-08`;
254
+ const headers = signV4({ method: "POST", url, headers: { "content-type": "application/x-www-form-urlencoded" }, body, payloadHash: sha256Hex(body), region, service: "iam", credentials: creds, now: (deps.now ?? (() => new Date()))() });
255
+ let res: Awaited<ReturnType<ForgeFetch>>;
256
+ try {
257
+ res = await fetch(url, { method: "POST", headers, body });
258
+ } catch (e) {
259
+ if (e instanceof ReadOnlyError) throw e;
260
+ row(`could not read: ${(e as Error).message}`, "unknown");
261
+ continue;
262
+ }
263
+ const xml = await res.text();
264
+ if (!res.ok) {
265
+ const code = xmlText(xml, "Code") ?? String(res.status);
266
+ if (code === "NoSuchEntity") row("no such role", "mismatch");
267
+ else row(`could not read (${res.status} ${code}); ${SCOPES.aws}`, "unknown");
268
+ continue;
269
+ }
270
+ const raw = xmlText(xml, "AssumeRolePolicyDocument");
271
+ let doc: unknown;
272
+ try {
273
+ doc = JSON.parse(decodeURIComponent(raw ?? ""));
274
+ } catch {
275
+ row(`GetRole answered without a trust policy ${product} could read`, "unknown");
276
+ continue;
277
+ }
278
+ const { problems, found } = compareTrust(doc, jobs, account);
279
+ row(problems.length ? `${found}; ${problems.join("; ")}` : found, problems.length ? "mismatch" : "match");
280
+ }
281
+ return rows;
282
+ }
283
+
284
+ // ── GCP ──────────────────────────────────────────────────────────────────────
285
+
286
+ const cel = (s: string): string => `'${s.replace(/\\/g, "\\\\").replace(/'/g, "\\'")}'`;
287
+
288
+ /**
289
+ * A Workload Identity Federation provider's attribute condition (CEL over
290
+ * `assertion`, the token's claims) for the jobs that take it: each job's
291
+ * subject, or the subject's prefix for a pattern, and on GitLab its
292
+ * environment, which must be protected, on a protected ref. Several jobs
293
+ * are joined with ||.
294
+ */
295
+ export function gcpCondition(tokens: readonly JobToken[]): string {
296
+ const one = (token: JobToken): string => {
297
+ const sub = token.pattern ? `assertion.sub.startsWith(${cel(token.subject.replace(/\*$/, ""))})` : `assertion.sub == ${cel(token.subject)}`;
298
+ const env = token.claims.environment;
299
+ return env === undefined ? sub : `${sub} && assertion.environment == ${cel(env)} && assertion.environment_protected == 'true' && assertion.ref_protected == 'true'`;
300
+ };
301
+ const each = unique(tokens.map(one));
302
+ return each.length === 1 ? each[0]! : each.map((c) => `(${c})`).join(" || ");
303
+ }
304
+
305
+ /** A CEL expression in disjunctive normal form: each term a set of conjuncts, compared as text without spaces outside quotes. Undefined past `limit` terms. */
306
+ export function celTerms(expr: string, limit = 256): string[][] | undefined {
307
+ const norm = (s: string): string => {
308
+ let out = "";
309
+ let q: string | undefined;
310
+ for (let i = 0; i < s.length; i++) {
311
+ const ch = s[i]!;
312
+ if (q) {
313
+ out += ch;
314
+ if (ch === "\\") out += s[++i] ?? "";
315
+ else if (ch === q) q = undefined;
316
+ } else if (ch === "'" || ch === '"') {
317
+ q = ch;
318
+ out += "'";
319
+ } else if (!/\s/.test(ch)) out += ch;
320
+ }
321
+ return out.replace(/"/g, "'");
322
+ };
323
+ const split = (s: string, op: "&&" | "||"): string[] => {
324
+ const parts: string[] = [];
325
+ let depth = 0;
326
+ let q: string | undefined;
327
+ let start = 0;
328
+ for (let i = 0; i < s.length; i++) {
329
+ const ch = s[i]!;
330
+ if (q) {
331
+ if (ch === "\\") i++;
332
+ else if (ch === q) q = undefined;
333
+ } else if (ch === "'" || ch === '"') q = ch;
334
+ else if (ch === "(") depth++;
335
+ else if (ch === ")") depth--;
336
+ else if (depth === 0 && s.startsWith(op, i)) {
337
+ parts.push(s.slice(start, i));
338
+ start = i + 2;
339
+ i++;
340
+ }
341
+ }
342
+ parts.push(s.slice(start));
343
+ return parts.map((p) => p.trim());
344
+ };
345
+ const strip = (s: string): string => {
346
+ let t = s.trim();
347
+ while (t.startsWith("(") && t.endsWith(")")) {
348
+ // Only when the outer parentheses wrap the whole expression.
349
+ let depth = 0;
350
+ let whole = true;
351
+ for (let i = 0; i < t.length; i++) {
352
+ if (t[i] === "(") depth++;
353
+ else if (t[i] === ")") depth--;
354
+ if (depth === 0 && i < t.length - 1) {
355
+ whole = false;
356
+ break;
357
+ }
358
+ }
359
+ if (!whole) break;
360
+ t = t.slice(1, -1).trim();
361
+ }
362
+ return t;
363
+ };
364
+ const dnf = (s: string): string[][] | undefined => {
365
+ const e = strip(s);
366
+ const ors = split(e, "||");
367
+ if (ors.length > 1) {
368
+ const out: string[][] = [];
369
+ for (const o of ors) {
370
+ const d = dnf(o);
371
+ if (!d) return undefined;
372
+ out.push(...d);
373
+ }
374
+ return out.length > limit ? undefined : out;
375
+ }
376
+ const ands = split(e, "&&");
377
+ if (ands.length === 1) return [[norm(e)]];
378
+ let out: string[][] = [[]];
379
+ for (const a of ands) {
380
+ const d = dnf(a);
381
+ if (!d) return undefined;
382
+ out = out.flatMap((t) => d.map((u) => [...t, ...u]));
383
+ if (out.length > limit) return undefined;
384
+ }
385
+ return out;
386
+ };
387
+ return dnf(expr);
388
+ }
389
+
390
+ /** Whether `live` admits no token `expected` refuses: each of its terms holds every conjunct of some term of `expected`. */
391
+ export function celNarrowerOrEqual(live: string, expected: string): boolean {
392
+ const l = celTerms(live);
393
+ const e = celTerms(expected);
394
+ if (!l || !e) return false;
395
+ return l.every((lt) => e.some((et) => et.every((c) => lt.includes(c))));
396
+ }
397
+
398
+ export async function gcpRows(c: ForgeCheckContract, fetch: ForgeFetch, deps: ForgeCheckDeps): Promise<CheckRow[]> {
399
+ const providers = new Map<string, JobToken[]>();
400
+ for (const j of c.jobs) {
401
+ if (!j.gcp) continue;
402
+ const have = providers.get(j.gcp.provider) ?? [];
403
+ have.push(j.token);
404
+ providers.set(j.gcp.provider, have);
405
+ }
406
+ const token = deps.env.GOOGLE_OAUTH_ACCESS_TOKEN;
407
+ const origin = (deps.endpoints?.gcpIam ?? "https://iam.googleapis.com").replace(/\/+$/, "");
408
+ const rows: CheckRow[] = [];
409
+ for (const [name, tokens] of providers) {
410
+ const expected = gcpCondition(tokens);
411
+ const row = (found: string, status: CheckStatus): number => rows.push({ where: "gcp", check: "trust", subject: name, expected: `${expected}, or narrower`, found, status });
412
+ if (!token) {
413
+ row("not checked: no GCP credentials (GOOGLE_OAUTH_ACCESS_TOKEN)", "not-checked");
414
+ continue;
415
+ }
416
+ if (!/^projects\/[^/]+\/locations\/[^/]+\/workloadIdentityPools\/[^/]+\/providers\/[^/]+$/.test(name)) {
417
+ row("not a provider's full resource name, so it cannot be read", "unknown");
418
+ continue;
419
+ }
420
+ let res: Awaited<ReturnType<ForgeFetch>>;
421
+ try {
422
+ res = await fetch(`${origin}/v1/${name}`, { method: "GET", headers: { authorization: `Bearer ${token}`, accept: "application/json" } });
423
+ } catch (e) {
424
+ if (e instanceof ReadOnlyError) throw e;
425
+ row(`could not read: ${(e as Error).message}`, "unknown");
426
+ continue;
427
+ }
428
+ const text = await res.text();
429
+ if (!res.ok) {
430
+ if (res.status === 404) row("no such provider", "mismatch");
431
+ else row(`could not read (${res.status}); ${SCOPES.gcp}`, "unknown");
432
+ continue;
433
+ }
434
+ let live: string | undefined;
435
+ try {
436
+ live = (JSON.parse(text) as { attributeCondition?: string }).attributeCondition;
437
+ } catch {
438
+ row("the provider's answer is not JSON", "unknown");
439
+ continue;
440
+ }
441
+ if (!live) row("no attribute condition: any token of the issuer", "mismatch");
442
+ else if (celNarrowerOrEqual(live, expected)) row(celNarrowerOrEqual(expected, live) ? live : `${live} (narrower)`, "match");
443
+ else row(`${live} (wider, or not provably narrower)`, "mismatch");
444
+ }
445
+ return rows;
446
+ }
447
+
448
+ // ── Azure ────────────────────────────────────────────────────────────────────
449
+
450
+ /** The variable holding a Microsoft Graph access token. */
451
+ export const AZURE_GRAPH_TOKEN_ENV = "AZURE_GRAPH_TOKEN";
452
+
453
+ export interface FederatedCredential {
454
+ issuer: string;
455
+ subject: string | null;
456
+ expression: string | null;
457
+ audiences: string[];
458
+ }
459
+
460
+ const credentialText = (x: FederatedCredential): string => `issuer ${x.issuer} ${x.subject !== null ? `subject ${x.subject}` : `claims ${x.expression}`} aud ${x.audiences.join(", ")}`;
461
+ const sameCredential = (a: FederatedCredential, b: FederatedCredential): boolean =>
462
+ a.issuer === b.issuer && a.subject === b.subject && a.expression === b.expression && [...a.audiences].sort().join("\n") === [...b.audiences].sort().join("\n");
463
+
464
+ /** The federated credential a job's token needs: its subject, or for a pattern an Entra flexible credential's expression. */
465
+ export function federatedCredential(token: JobToken, audience: string): FederatedCredential {
466
+ return { issuer: token.issuer, subject: token.pattern ? null : token.subject, expression: token.pattern ? `claims['sub'] matches ${cel(token.subject)}` : null, audiences: [audience] };
467
+ }
468
+
469
+ export async function azureRows(c: ForgeCheckContract, fetch: ForgeFetch, deps: ForgeCheckDeps): Promise<CheckRow[]> {
470
+ const apps = new Map<string, FederatedCredential[]>();
471
+ for (const j of c.jobs) {
472
+ if (!j.azure) continue;
473
+ const cred = federatedCredential(j.token, j.azure.audience);
474
+ for (const id of j.azure.clientIds) {
475
+ const have = apps.get(id) ?? [];
476
+ if (!have.some((h) => sameCredential(h, cred))) have.push(cred);
477
+ apps.set(id, have);
478
+ }
479
+ }
480
+ const token = deps.env[AZURE_GRAPH_TOKEN_ENV];
481
+ const origin = (deps.endpoints?.graph ?? "https://graph.microsoft.com").replace(/\/+$/, "");
482
+ const rows: CheckRow[] = [];
483
+ for (const [id, creds] of apps) {
484
+ const row = (found: string, status: CheckStatus): number => rows.push({ where: "azure", check: "trust", subject: id, expected: creds.map(credentialText).join("; "), found, status });
485
+ if (!token) {
486
+ row(`not checked: no Azure credentials (${AZURE_GRAPH_TOKEN_ENV})`, "not-checked");
487
+ continue;
488
+ }
489
+ let res: Awaited<ReturnType<ForgeFetch>>;
490
+ try {
491
+ res = await fetch(`${origin}/v1.0/applications(appId='${encodeURIComponent(id)}')/federatedIdentityCredentials`, { method: "GET", headers: { authorization: `Bearer ${token}`, accept: "application/json" } });
492
+ } catch (e) {
493
+ if (e instanceof ReadOnlyError) throw e;
494
+ row(`could not read: ${(e as Error).message}`, "unknown");
495
+ continue;
496
+ }
497
+ const text = await res.text();
498
+ if (!res.ok) {
499
+ if (res.status === 404) row("no application with this appId (a managed identity's credentials are not read)", "unknown");
500
+ else row(`could not read (${res.status}); ${SCOPES.azure}`, "unknown");
501
+ continue;
502
+ }
503
+ type Live = { name?: string; issuer?: string; subject?: string | null; audiences?: string[]; claimsMatchingExpression?: string | { value?: string } | null };
504
+ let value: Live[];
505
+ try {
506
+ value = (JSON.parse(text) as { value?: Live[] }).value ?? [];
507
+ } catch {
508
+ row("Microsoft Graph's answer is not JSON", "unknown");
509
+ continue;
510
+ }
511
+ const live = value.map((v) => ({
512
+ name: v.name ?? "",
513
+ cred: {
514
+ issuer: v.issuer ?? "",
515
+ subject: v.subject ?? null,
516
+ expression: typeof v.claimsMatchingExpression === "string" ? v.claimsMatchingExpression : (v.claimsMatchingExpression?.value ?? null),
517
+ audiences: v.audiences ?? [],
518
+ },
519
+ }));
520
+ const missing = creds.filter((e) => !live.some((l) => sameCredential(l.cred, e)));
521
+ const extra = live.filter((l) => !creds.some((e) => sameCredential(l.cred, e)));
522
+ const problems = [...missing.map((m) => `missing ${credentialText(m)}`), ...extra.map((x) => `wider: ${x.name ? `${x.name}: ` : ""}${credentialText(x.cred)}`)];
523
+ const found = live.length ? live.map((l) => credentialText(l.cred)).join("; ") : "no federated credential";
524
+ row(problems.length ? `${found}; ${problems.join("; ")}` : found, problems.length ? "mismatch" : "match");
525
+ }
526
+ return rows;
527
+ }
@@ -0,0 +1,78 @@
1
+ /**
2
+ * The forge check's rows and result (#4608).
3
+ */
4
+
5
+ import type { IdentityCloud } from "../ci-identity";
6
+ import type { ForgeFetch, ForgeKind } from "../pr-forge";
7
+ import type { ForgeCheckRepository } from "./contract";
8
+
9
+ export const CHECK_STATUSES = ["match", "mismatch", "unknown", "not-checked"] as const;
10
+
11
+ /**
12
+ * `match` and `mismatch` compare what was read with the contract. `unknown`:
13
+ * the setting could not be read (a scope the token lacks, an edition without
14
+ * the feature). `not-checked`: no credentials for that cloud.
15
+ */
16
+ export type CheckStatus = (typeof CHECK_STATUSES)[number];
17
+
18
+ export type CheckWhere = ForgeKind | IdentityCloud;
19
+
20
+ export interface CheckRow {
21
+ where: CheckWhere;
22
+ /**
23
+ * What is checked: repository, environment, deployment-branches,
24
+ * runner-group, protected-environment, protected-runners, variable,
25
+ * protected-branch, required-status, status-reported, oidc-issuer, trust.
26
+ */
27
+ check: string;
28
+ /** The thing checked: an environment, a runner group or tag set, a variable, a branch, a status, a role, a provider, an app, a Pulumi token. */
29
+ subject: string;
30
+ expected: string;
31
+ found: string;
32
+ status: CheckStatus;
33
+ }
34
+
35
+ export interface ForgeCheckResult {
36
+ /** `<product>.forge-check/v1`. */
37
+ schema: string;
38
+ /** The config the contract came from, when the product names one. */
39
+ file?: string;
40
+ forge: ForgeKind;
41
+ repository: ForgeCheckRepository;
42
+ rows: CheckRow[];
43
+ counts: Record<CheckStatus, number>;
44
+ /** No mismatch, and with `requireClouds` no cloud left unchecked. */
45
+ ok: boolean;
46
+ }
47
+
48
+ export interface ForgeCheckDeps {
49
+ /** Every request goes through ./read-only.ts's wrapper around it. */
50
+ fetch: ForgeFetch;
51
+ /** Credentials: AWS_ACCESS_KEY_ID and the rest, GOOGLE_OAUTH_ACCESS_TOKEN, AZURE_GRAPH_TOKEN, PULUMI_ACCESS_TOKEN, and AWS_ENDPOINT_URL_IAM. */
52
+ env: Record<string, string | undefined>;
53
+ /** Reads the AWS shared credentials file; undefined when there is none. */
54
+ readFile?: (path: string) => string | undefined;
55
+ now?: () => Date;
56
+ /** For a loopback fake: GCP IAM's and Microsoft Graph's origins. */
57
+ endpoints?: { gcpIam?: string; graph?: string };
58
+ }
59
+
60
+ /** A read's outcome: the value, or why it could not be had. */
61
+ export type Read<T> = { ok: true; value: T } | { ok: false; status: number | undefined; why: string };
62
+
63
+ export const couldNot = (r: { status: number | undefined }, need: string): string => `could not read (${r.status ?? "no answer"}); ${need}`;
64
+
65
+ export const unique = <T>(xs: readonly T[]): T[] => [...new Set(xs)];
66
+
67
+ /** The scopes each read needs, as the rows and the docs name them. */
68
+ export const SCOPES = {
69
+ github: "the token needs Metadata: read and Actions: read on the repository (classic: repo)",
70
+ githubOrg: "the token needs Self-hosted runners: read on the organization (classic: admin:org)",
71
+ gitlab: "the token needs the read_api scope and the Maintainer role",
72
+ gitlabEdition: "protected environments are GitLab Premium; on another edition, or without read_api and the Maintainer role, they cannot be read",
73
+ forgejo: "the token needs read:repository, and its user admin on the repository",
74
+ aws: "the credentials need iam:GetRole on the role",
75
+ gcp: "the token needs iam.workloadIdentityPoolProviders.get on the provider",
76
+ azure: "the token needs Application.Read.All (Microsoft Graph)",
77
+ pulumi: "the token needs to read the organization's OIDC issuers and their policies (an organization admin's)",
78
+ };
@@ -0,0 +1,5 @@
1
+ /**
2
+ * chant#4608: `@intentius/chant/forge-check`, the forge and trust-policy
3
+ * check terragucci and plywood share. See ./forge-check/index.ts.
4
+ */
5
+ export * from "./forge-check/index";
@@ -34,7 +34,11 @@ describe("the gate-decision bundle", () => {
34
34
  expect(inputs.filter((i) => pattern.test(i)), String(pattern)).toEqual([]);
35
35
  }
36
36
  expect(inputs.map((i) => i.replace(/^.*?packages\//, "packages/")).sort()).toEqual([
37
+ // The product's words (#4550): gate and status names, no imports.
38
+ "packages/core/src/ci-product-words.ts",
37
39
  "packages/core/src/content-digest.ts",
40
+ // The control repo's settings check (#4568, #4617), which the spec checks.
41
+ "packages/core/src/control/dispatch.ts",
38
42
  "packages/core/src/declarable.ts",
39
43
  "packages/core/src/effect-receipt.ts",
40
44
  "packages/core/src/gate-decision.ts",
@@ -42,6 +46,8 @@ describe("the gate-decision bundle", () => {
42
46
  "packages/core/src/lifecycle/gate-applied.ts",
43
47
  "packages/core/src/lifecycle/gate-ledger-select.ts",
44
48
  "packages/core/src/lifecycle/gate-seal.ts",
49
+ // The gated-request digest (#4551) and its sorted-key replacer.
50
+ "packages/core/src/lifecycle/gated-request-digest.ts",
45
51
  "packages/core/src/lifecycle/plan-digest.ts",
46
52
  "packages/core/src/notify-verify.ts",
47
53
  "packages/core/src/notify.ts",
@@ -49,7 +55,14 @@ describe("the gate-decision bundle", () => {
49
55
  "packages/core/src/op/gate-plan-context.ts",
50
56
  "packages/core/src/op/gate-point.ts",
51
57
  "packages/core/src/op/gate-quorum.ts",
58
+ // The step and holds settings checks (#4545), with no run-time imports.
59
+ "packages/core/src/op/op-waves-capability-spec.ts",
60
+ // The release names a wave writes (#4615), checked with the spec.
61
+ "packages/core/src/op/op-waves-release.ts",
52
62
  "packages/core/src/op/op-waves.ts",
63
+ // The next-release floor constant (#4480): no imports.
64
+ "packages/core/src/release-floors.ts",
65
+ "packages/core/src/sorted-json.ts",
53
66
  "packages/core/src/wave-blocked.ts",
54
67
  "packages/core/src/wave-layout.ts",
55
68
  "packages/core/src/workspace/class-data.ts",
@@ -425,6 +425,9 @@ export function reviewApproval(merged: MergedReview, headDigest: string | undefi
425
425
  return { approved: true, review: { ...seen, approvers: merged.approvers } };
426
426
  }
427
427
 
428
+ // #4551: a gated request's shape and digest, for a product deciding one without git.
429
+ export { gatedRequestDigest, gatedRequestOf, type GatedRequest } from "./lifecycle/gated-request-digest";
430
+
428
431
  // ── the decision ─────────────────────────────────────────────────────────
429
432
 
430
433
  /** The gate ledger lines of one op, as `chant/lifecycle` holds them in `_gates/<op>.jsonl`. */