@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,338 @@
1
+ /**
2
+ * The forge's side of the check (#4608), lifted from terragucci's
3
+ * `forge check` and widened to branch protection and required statuses:
4
+ *
5
+ * GitHub each apply job's forge environment exists and deploys from the
6
+ * default branch alone (protected branches, or one custom policy
7
+ * naming the default branch); each apply runner group is limited
8
+ * to selected workflows (org-level, so a token without
9
+ * Self-hosted runners: read gets `unknown`); each protected
10
+ * branch is protected by branch protection or a ruleset, and the
11
+ * default branch requires each required status
12
+ * GitLab each forge environment is protected (Premium: on another
13
+ * edition the row is `unknown`); every runner carrying an apply
14
+ * runner's tags takes protected refs only; each variable the apply
15
+ * jobs read is protected and scoped to their environment; each
16
+ * protected branch is protected; merge requests need a passing
17
+ * pipeline, which holds the required statuses
18
+ * Forgejo each protected branch is protected, and its rule checks each
19
+ * required status
20
+ *
21
+ * The default branch's head is read through chant's forge client
22
+ * (`branchHead` and `commitStatuses`, #4554), so a required status no job
23
+ * has posted yet shows as `unknown` before it blocks every merge.
24
+ */
25
+ import { forgeClient, ForgeApiError } from "../pr-forge.js";
26
+ import { ReadOnlyError } from "./read-only.js";
27
+ import { couldNot, SCOPES, unique } from "./types.js";
28
+ const authHeaders = (t) => {
29
+ if (t.kind === "gitlab")
30
+ return t.token ? { [t.tokenHeader ?? "PRIVATE-TOKEN"]: t.token } : {};
31
+ if (t.kind === "github")
32
+ return { ...(t.token ? { Authorization: `Bearer ${t.token}` } : {}), Accept: "application/vnd.github+json" };
33
+ return { ...(t.token ? { Authorization: `token ${t.token}` } : {}), Accept: "application/json" };
34
+ };
35
+ /** A GET of `path` under the target's REST base, parsed as JSON. */
36
+ export async function read(fetch, t, path) {
37
+ const url = `${t.apiBase.replace(/\/+$/, "")}${path}`;
38
+ try {
39
+ const res = await fetch(url, { method: "GET", headers: authHeaders(t) });
40
+ const text = await res.text();
41
+ if (!res.ok)
42
+ return { ok: false, status: res.status, why: text.slice(0, 300) };
43
+ return { ok: true, value: (text ? JSON.parse(text) : null) };
44
+ }
45
+ catch (e) {
46
+ if (e instanceof ReadOnlyError)
47
+ throw e;
48
+ return { ok: false, status: undefined, why: e.message };
49
+ }
50
+ }
51
+ /** The project path a GitLab call takes. */
52
+ const projectPath = (t) => `/projects/${encodeURIComponent(decodeURIComponent(t.repo))}`;
53
+ /** The repository's default branch, full path and (Forgejo) numeric ids. */
54
+ export async function readRepository(fetch, t) {
55
+ const r = await read(fetch, t, t.kind === "gitlab" ? projectPath(t) : `/repos/${t.repo}`);
56
+ if (!r.ok)
57
+ return r;
58
+ const v = r.value ?? {};
59
+ const path = t.kind === "gitlab" ? v.path_with_namespace : v.full_name;
60
+ return {
61
+ ok: true,
62
+ value: {
63
+ ...(v.default_branch ? { defaultBranch: v.default_branch } : {}),
64
+ ...(path ? { path } : {}),
65
+ ...(t.kind === "forgejo" && v.owner?.id !== undefined ? { ownerId: String(v.owner.id) } : {}),
66
+ ...(t.kind === "forgejo" && v.id !== undefined ? { repoId: String(v.id) } : {}),
67
+ },
68
+ };
69
+ }
70
+ const applyJobs = (c) => c.jobs.filter((j) => j.identity === "apply");
71
+ const forgeEnvironments = (c) => unique(applyJobs(c).flatMap((j) => (j.forgeEnvironment ? [j.forgeEnvironment] : [])));
72
+ const protectedBranches = (c) => unique(c.protectedBranches ?? [c.repository.defaultBranch]);
73
+ /** A branch glob as GitLab and Forgejo write them: `*` any run of characters. */
74
+ const branchGlob = (glob, branch) => new RegExp(`^${glob.replace(/[.+^${}()|[\]\\?]/g, "\\$&").replace(/\*/g, ".*")}$`).test(branch);
75
+ /** One GitHub branch: whether branch protection or a ruleset protects it, and the status contexts either requires. */
76
+ async function githubBranch(fetch, t, b) {
77
+ const br = await read(fetch, t, `/repos/${t.repo}/branches/${encodeURIComponent(b)}`);
78
+ if (!br.ok)
79
+ return { found: br.status === 404 ? "no such branch" : couldNot(br, SCOPES.github), status: br.status === 404 ? "mismatch" : "unknown", required: br };
80
+ // Rulesets are readable with read access; a 404 means none applies.
81
+ const rules = await read(fetch, t, `/repos/${t.repo}/rules/branches/${encodeURIComponent(b)}`);
82
+ const list = rules.ok && Array.isArray(rules.value) ? rules.value : [];
83
+ const kinds = unique(list.map((r) => r.type));
84
+ const byProtection = br.value?.protected === true;
85
+ const found = [...(byProtection ? ["branch protection"] : []), ...(kinds.length ? [`rulesets: ${kinds.join(", ")}`] : [])].join("; ") || "not protected";
86
+ const checks = br.value?.protection?.required_status_checks;
87
+ const contexts = unique([...(checks?.contexts ?? []), ...(checks?.checks ?? []).map((x) => x.context), ...list.flatMap((r) => (r.type === "required_status_checks" ? (r.parameters?.required_status_checks ?? []).map((x) => x.context) : []))]);
88
+ return { found, status: byProtection || kinds.length > 0 ? "match" : "mismatch", required: { ok: true, value: contexts } };
89
+ }
90
+ export async function githubRows(fetch, t, c) {
91
+ const rows = [];
92
+ const branch = c.repository.defaultBranch;
93
+ for (const env of forgeEnvironments(c)) {
94
+ const row = (check, expected, found, status) => rows.push({ where: "github", check, subject: env, expected, found, status });
95
+ const r = await read(fetch, t, `/repos/${t.repo}/environments/${encodeURIComponent(env)}`);
96
+ if (!r.ok) {
97
+ if (r.status === 404)
98
+ row("environment", "exists", "missing", "mismatch");
99
+ else
100
+ row("environment", "exists", couldNot(r, SCOPES.github), "unknown");
101
+ continue;
102
+ }
103
+ row("environment", "exists", "exists", "match");
104
+ const expected = `deploys from ${branch} only`;
105
+ const p = r.value?.deployment_branch_policy;
106
+ if (!p) {
107
+ row("deployment-branches", expected, "any branch: no deployment branch rule", "mismatch");
108
+ }
109
+ else if (p.protected_branches) {
110
+ row("deployment-branches", expected, "protected branches", "match");
111
+ }
112
+ else {
113
+ const b = await read(fetch, t, `/repos/${t.repo}/environments/${encodeURIComponent(env)}/deployment-branch-policies?per_page=100`);
114
+ if (!b.ok) {
115
+ row("deployment-branches", expected, couldNot(b, SCOPES.github), "unknown");
116
+ continue;
117
+ }
118
+ const list = b.value?.branch_policies ?? [];
119
+ const ok = list.length === 1 && list[0].name === branch && list[0].type !== "tag";
120
+ row("deployment-branches", expected, `custom: ${list.map((x) => `${x.name}${x.type === "tag" ? " (tag)" : ""}`).join(", ") || "none"}`, ok ? "match" : "mismatch");
121
+ }
122
+ }
123
+ const groups = unique(applyJobs(c).flatMap((j) => (j.runner?.group ? [j.runner.group] : [])));
124
+ if (groups.length) {
125
+ const owner = t.repo.split("/")[0];
126
+ const r = await read(fetch, t, `/orgs/${owner}/actions/runner-groups?per_page=100`);
127
+ for (const g of groups) {
128
+ const expected = "limited to selected workflows";
129
+ if (!r.ok) {
130
+ rows.push({ where: "github", check: "runner-group", subject: g, expected, found: couldNot(r, SCOPES.githubOrg), status: "unknown" });
131
+ continue;
132
+ }
133
+ const found = (r.value?.runner_groups ?? []).find((x) => x.name === g);
134
+ if (!found)
135
+ rows.push({ where: "github", check: "runner-group", subject: g, expected, found: `no runner group ${g} in ${owner}`, status: "mismatch" });
136
+ else if (found.restricted_to_workflows)
137
+ rows.push({ where: "github", check: "runner-group", subject: g, expected, found: `selected workflows: ${(found.selected_workflows ?? []).join(", ") || "none"}`, status: "match" });
138
+ else
139
+ rows.push({ where: "github", check: "runner-group", subject: g, expected, found: "every workflow", status: "mismatch" });
140
+ }
141
+ }
142
+ const branches = unique([...protectedBranches(c), ...((c.requiredStatuses ?? []).length ? [branch] : [])]);
143
+ let def;
144
+ for (const b of branches) {
145
+ const g = await githubBranch(fetch, t, b);
146
+ if (b === branch)
147
+ def = g.required;
148
+ if (!protectedBranches(c).includes(b))
149
+ continue;
150
+ rows.push({ where: "github", check: "protected-branch", subject: b, expected: "protected", found: g.found, status: g.status });
151
+ }
152
+ for (const ctx of c.requiredStatuses ?? []) {
153
+ const expected = `${branch} requires ${ctx} before a merge`;
154
+ if (!def || !def.ok)
155
+ rows.push({ where: "github", check: "required-status", subject: ctx, expected, found: def ? couldNot(def, SCOPES.github) : "not read", status: "unknown" });
156
+ else
157
+ rows.push({ where: "github", check: "required-status", subject: ctx, expected, found: def.value.length ? `required: ${def.value.join(", ")}` : "no required status", status: def.value.includes(ctx) ? "match" : "mismatch" });
158
+ }
159
+ return rows;
160
+ }
161
+ export async function gitlabRows(fetch, t, c) {
162
+ const rows = [];
163
+ const pid = projectPath(t);
164
+ const envs = forgeEnvironments(c);
165
+ if (envs.length) {
166
+ const r = await read(fetch, t, `${pid}/protected_environments?per_page=100`);
167
+ for (const env of envs) {
168
+ if (!r.ok) {
169
+ const why = r.status === 404 || r.status === 403 ? `could not read (${r.status}); ${SCOPES.gitlabEdition}` : couldNot(r, SCOPES.gitlab);
170
+ rows.push({ where: "gitlab", check: "protected-environment", subject: env, expected: "protected", found: why, status: "unknown" });
171
+ continue;
172
+ }
173
+ const ok = (r.value ?? []).some((p) => p.name === env);
174
+ rows.push({ where: "gitlab", check: "protected-environment", subject: env, expected: "protected", found: ok ? "protected" : "not protected", status: ok ? "match" : "mismatch" });
175
+ }
176
+ }
177
+ const tagSets = new Map();
178
+ for (const j of applyJobs(c))
179
+ if (j.runner?.labels.length)
180
+ tagSets.set([...j.runner.labels].sort().join(","), j.runner.labels);
181
+ for (const tags of tagSets.values()) {
182
+ const subject = `tags ${tags.join(", ")}`;
183
+ const expected = "every runner with these tags runs protected refs only (ref_protected)";
184
+ const r = await read(fetch, t, `${pid}/runners?tag_list=${encodeURIComponent(tags.join(","))}&per_page=100`);
185
+ if (!r.ok) {
186
+ rows.push({ where: "gitlab", check: "protected-runners", subject, expected, found: couldNot(r, SCOPES.gitlab), status: "unknown" });
187
+ continue;
188
+ }
189
+ const runners = r.value ?? [];
190
+ if (runners.length === 0) {
191
+ rows.push({ where: "gitlab", check: "protected-runners", subject, expected, found: "no runner of the project carries these tags", status: "mismatch" });
192
+ continue;
193
+ }
194
+ const open = [];
195
+ let unread;
196
+ for (const runner of runners) {
197
+ const d = await read(fetch, t, `/runners/${runner.id}`);
198
+ if (!d.ok)
199
+ unread = couldNot(d, SCOPES.gitlab);
200
+ else if (d.value?.access_level !== "ref_protected")
201
+ open.push(`#${runner.id}${runner.description ? ` (${runner.description})` : ""} ${d.value?.access_level ?? "no access level"}`);
202
+ }
203
+ if (open.length)
204
+ rows.push({ where: "gitlab", check: "protected-runners", subject, expected, found: open.join("; "), status: "mismatch" });
205
+ else if (unread)
206
+ rows.push({ where: "gitlab", check: "protected-runners", subject, expected, found: unread, status: "unknown" });
207
+ else
208
+ rows.push({ where: "gitlab", check: "protected-runners", subject, expected, found: `${runners.length} runner(s), each ref_protected`, status: "match" });
209
+ }
210
+ const names = unique(c.gitlabVariables ?? []);
211
+ if (envs.length && names.length) {
212
+ const vars = [];
213
+ let failed;
214
+ for (let page = 1; page <= 50; page++) {
215
+ const r = await read(fetch, t, `${pid}/variables?per_page=100&page=${page}`);
216
+ if (!r.ok) {
217
+ failed = r;
218
+ break;
219
+ }
220
+ vars.push(...(r.value ?? []));
221
+ if ((r.value ?? []).length < 100)
222
+ break;
223
+ }
224
+ for (const env of envs) {
225
+ for (const name of names) {
226
+ const subject = `${name} in ${env}`;
227
+ const expected = `scoped to ${env}, protected`;
228
+ if (failed && !failed.ok) {
229
+ rows.push({ where: "gitlab", check: "variable", subject, expected, found: couldNot(failed, SCOPES.gitlab), status: "unknown" });
230
+ continue;
231
+ }
232
+ const defs = vars.filter((v) => v.key === name);
233
+ if (defs.length === 0) {
234
+ rows.push({ where: "gitlab", check: "variable", subject, expected, found: "no project variable of this name (group and instance variables are not read)", status: "unknown" });
235
+ continue;
236
+ }
237
+ const mine = defs.find((v) => v.environment_scope === env);
238
+ const found = defs.map((v) => `scope ${v.environment_scope ?? "*"}, ${v.protected ? "protected" : "not protected"}`).join("; ");
239
+ rows.push({ where: "gitlab", check: "variable", subject, expected, found, status: mine?.protected ? "match" : "mismatch" });
240
+ }
241
+ }
242
+ }
243
+ const branches = protectedBranches(c);
244
+ const pb = await read(fetch, t, `${pid}/protected_branches?per_page=100`);
245
+ for (const b of branches) {
246
+ if (!pb.ok) {
247
+ rows.push({ where: "gitlab", check: "protected-branch", subject: b, expected: "protected", found: couldNot(pb, SCOPES.gitlab), status: "unknown" });
248
+ continue;
249
+ }
250
+ const rule = (pb.value ?? []).map((p) => p.name).find((n) => n === b || branchGlob(n, b));
251
+ rows.push({ where: "gitlab", check: "protected-branch", subject: b, expected: "protected", found: rule ? `protected by ${rule}` : "not protected", status: rule ? "match" : "mismatch" });
252
+ }
253
+ if ((c.requiredStatuses ?? []).length) {
254
+ const p = await read(fetch, t, pid);
255
+ for (const ctx of c.requiredStatuses ?? []) {
256
+ const expected = `merge requests need a passing pipeline, which holds ${ctx}`;
257
+ if (!p.ok) {
258
+ rows.push({ where: "gitlab", check: "required-status", subject: ctx, expected, found: couldNot(p, SCOPES.gitlab), status: "unknown" });
259
+ continue;
260
+ }
261
+ const must = p.value?.only_allow_merge_if_pipeline_succeeds === true;
262
+ const skipped = p.value?.allow_merge_on_skipped_pipeline === true;
263
+ const found = must ? (skipped ? "pipelines must succeed, but a skipped pipeline may merge" : "pipelines must succeed") : "a merge request may merge with a failed pipeline";
264
+ rows.push({ where: "gitlab", check: "required-status", subject: ctx, expected, found, status: must && !skipped ? "match" : "mismatch" });
265
+ }
266
+ }
267
+ return rows;
268
+ }
269
+ export async function forgejoRows(fetch, t, c) {
270
+ const rows = [];
271
+ const r = await read(fetch, t, `/repos/${t.repo}/branch_protections`);
272
+ const ruleOf = (b) => (r.ok ? (r.value ?? []).find((p) => { const n = p.rule_name || p.branch_name || ""; return n === b || (n !== "" && branchGlob(n, b)); }) : undefined);
273
+ for (const b of protectedBranches(c)) {
274
+ if (!r.ok) {
275
+ rows.push({ where: "forgejo", check: "protected-branch", subject: b, expected: "protected", found: couldNot(r, SCOPES.forgejo), status: "unknown" });
276
+ continue;
277
+ }
278
+ const rule = ruleOf(b);
279
+ const name = rule ? rule.rule_name || rule.branch_name : undefined;
280
+ rows.push({ where: "forgejo", check: "protected-branch", subject: b, expected: "protected", found: name ? `protected by rule ${name}` : "not protected", status: name ? "match" : "mismatch" });
281
+ }
282
+ const branch = c.repository.defaultBranch;
283
+ for (const ctx of c.requiredStatuses ?? []) {
284
+ const expected = `${branch} requires ${ctx} before a merge`;
285
+ if (!r.ok) {
286
+ rows.push({ where: "forgejo", check: "required-status", subject: ctx, expected, found: couldNot(r, SCOPES.forgejo), status: "unknown" });
287
+ continue;
288
+ }
289
+ const rule = ruleOf(branch);
290
+ const patterns = rule?.enable_status_check ? (rule.status_check_contexts ?? []) : [];
291
+ const ok = patterns.some((p) => p === ctx || branchGlob(p, ctx));
292
+ const found = !rule ? `${branch} has no protection rule` : !rule.enable_status_check ? "the rule checks no status" : `required: ${patterns.join(", ") || "none"}`;
293
+ rows.push({ where: "forgejo", check: "required-status", subject: ctx, expected, found, status: ok ? "match" : "mismatch" });
294
+ }
295
+ return rows;
296
+ }
297
+ /**
298
+ * Whether each required status has been posted on the default branch's
299
+ * head, read with chant's forge client (#4554). A required status no job
300
+ * posts blocks every merge, so its name is worth seeing next to the forge's
301
+ * list. One not posted yet is `unknown`: the pipeline may not have run.
302
+ */
303
+ export async function statusReportedRows(fetch, t, c) {
304
+ const contexts = c.requiredStatuses ?? [];
305
+ if (!contexts.length)
306
+ return [];
307
+ const branch = c.repository.defaultBranch;
308
+ const forge = forgeClient(t, fetch);
309
+ let head;
310
+ let posted;
311
+ let why;
312
+ try {
313
+ if (forge.branchHead)
314
+ head = await forge.branchHead(branch);
315
+ else {
316
+ const b = await read(fetch, t, `${projectPath(t)}/repository/branches/${encodeURIComponent(branch)}`);
317
+ head = b.ok ? b.value?.commit?.id : undefined;
318
+ }
319
+ if (head && forge.commitStatuses)
320
+ posted = (await forge.commitStatuses(head, branch)).map((s) => s.context);
321
+ }
322
+ catch (e) {
323
+ if (e instanceof ReadOnlyError)
324
+ throw e;
325
+ why = e instanceof ForgeApiError ? `could not read (${e.status})` : `could not read: ${e.message}`;
326
+ }
327
+ return contexts.map((ctx) => {
328
+ const expected = `${ctx} is posted on ${branch}`;
329
+ if (why)
330
+ return { where: t.kind, check: "status-reported", subject: ctx, expected, found: why, status: "unknown" };
331
+ if (!head)
332
+ return { where: t.kind, check: "status-reported", subject: ctx, expected, found: `could not read ${branch}'s head`, status: "unknown" };
333
+ if (!posted)
334
+ return { where: t.kind, check: "status-reported", subject: ctx, expected, found: "the forge client reads no statuses", status: "unknown" };
335
+ const ok = posted.includes(ctx);
336
+ return { where: t.kind, check: "status-reported", subject: ctx, expected, found: ok ? `posted on ${head.slice(0, 12)}` : `not posted on ${head.slice(0, 12)}${posted.length ? ` (posted: ${posted.join(", ")})` : ""}`, status: ok ? "match" : "unknown" };
337
+ });
338
+ }
@@ -0,0 +1,24 @@
1
+ /**
2
+ * chant#4608: the forge and trust-policy check in CI core, shared by
3
+ * terragucci (`terragucci forge check`) and plywood (`plywood forge check`),
4
+ * and run as `chant ci forge-check`.
5
+ *
6
+ * It reads the live forge and cloud setup against a contract of jobs and
7
+ * identities (./contract.ts): each apply job's forge environment, runner
8
+ * groups and GitLab protected runners and variables, branch protection and
9
+ * required statuses, each AWS role's trust policy, each GCP workload
10
+ * identity provider's condition, each Azure app's federated credentials,
11
+ * and each Pulumi Cloud organization's OIDC issuer and its policies.
12
+ * Read-only: every call goes through ./read-only.ts.
13
+ *
14
+ * Lifted from terragucci's `packages/terragucci/src/forge-check.ts`, which
15
+ * terragucci#1282 deletes once it calls this.
16
+ */
17
+ export * from "./types.js";
18
+ export * from "./contract.js";
19
+ export { assertReadOnly, readOnly, ReadOnlyError, READ_ACTIONS } from "./read-only.js";
20
+ export { read, readRepository, githubRows, gitlabRows, forgejoRows, statusReportedRows } from "./forge.js";
21
+ export { awsCredentials, awsRows, awsTrustPolicy, trustJobs, trustJob, issuerKey, compareTrust, rolesOf, gcpCondition, celTerms, celNarrowerOrEqual, gcpRows, federatedCredential, azureRows, AZURE_GRAPH_TOKEN_ENV, type TrustJob, type LiveValue, type FederatedCredential, } from "./trust.js";
22
+ export { pulumiRows, policyGrants, PULUMI_TOKEN_ENV } from "./pulumi.js";
23
+ export { forgeCheck, forgeCheckExit, describeForgeCheck, countRows, forgeCheckCommand, forgeCheckSchema, forgeCheckTarget, uncheckedClouds, ForgeCheckTargetError, type ForgeCheckInput } from "./check.js";
24
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forge-check/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACxG,OAAO,EACL,cAAc,EACd,OAAO,EACP,cAAc,EACd,SAAS,EACT,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,kBAAkB,EAClB,OAAO,EACP,mBAAmB,EACnB,SAAS,EACT,qBAAqB,EACrB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,mBAAmB,GACzB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * chant#4608: the forge and trust-policy check in CI core, shared by
3
+ * terragucci (`terragucci forge check`) and plywood (`plywood forge check`),
4
+ * and run as `chant ci forge-check`.
5
+ *
6
+ * It reads the live forge and cloud setup against a contract of jobs and
7
+ * identities (./contract.ts): each apply job's forge environment, runner
8
+ * groups and GitLab protected runners and variables, branch protection and
9
+ * required statuses, each AWS role's trust policy, each GCP workload
10
+ * identity provider's condition, each Azure app's federated credentials,
11
+ * and each Pulumi Cloud organization's OIDC issuer and its policies.
12
+ * Read-only: every call goes through ./read-only.ts.
13
+ *
14
+ * Lifted from terragucci's `packages/terragucci/src/forge-check.ts`, which
15
+ * terragucci#1282 deletes once it calls this.
16
+ */
17
+ export * from "./types.js";
18
+ export * from "./contract.js";
19
+ export { assertReadOnly, readOnly, ReadOnlyError, READ_ACTIONS } from "./read-only.js";
20
+ export { read, readRepository, githubRows, gitlabRows, forgejoRows, statusReportedRows } from "./forge.js";
21
+ export { awsCredentials, awsRows, awsTrustPolicy, trustJobs, trustJob, issuerKey, compareTrust, rolesOf, gcpCondition, celTerms, celNarrowerOrEqual, gcpRows, federatedCredential, azureRows, AZURE_GRAPH_TOKEN_ENV, } from "./trust.js";
22
+ export { pulumiRows, policyGrants, PULUMI_TOKEN_ENV } from "./pulumi.js";
23
+ export { forgeCheck, forgeCheckExit, describeForgeCheck, countRows, forgeCheckCommand, forgeCheckSchema, forgeCheckTarget, uncheckedClouds, ForgeCheckTargetError } from "./check.js";
@@ -0,0 +1,44 @@
1
+ /**
2
+ * Pulumi Cloud's side of the check (#4608, for #4549's identities): the
3
+ * organization has the forge registered as an OIDC issuer, and the issuer's
4
+ * authorization policies give each token the contract names to its jobs
5
+ * and to no other subject.
6
+ *
7
+ * Two reads per organization, both GETs with `Authorization: token
8
+ * <PULUMI_ACCESS_TOKEN>`, as Pulumi Cloud's REST API documents them:
9
+ *
10
+ * GET <apiUrl>/api/orgs/<org>/oidc/issuers
11
+ * { oidcIssuers: [{ id, name, url, ... }] }
12
+ * GET <apiUrl>/api/orgs/<org>/auth/policies/oidcissuers/<issuer id>
13
+ * { policies: [{ decision, tokenType, teamName, userLogin,
14
+ * authorizedPermissions, rules: { sub, aud, ... } }] }
15
+ *
16
+ * A policy grants a token when its decision is `allow` and its token type
17
+ * (and team, user, or the organization's admin permission) is the
18
+ * identity's: `team:<name>`, `user:<login>`, `organization`,
19
+ * `organization:admin` (`pulumiTokenRequest` in ../ci-identity.ts). Its
20
+ * rules are claim values, where `*` stands for any text. A grant must admit
21
+ * each job that takes the token, and each grant's `sub` must be within some
22
+ * such job's subject. A grant with no `sub` rule admits any subject.
23
+ *
24
+ * The shapes follow Pulumi's documentation and are tested against a
25
+ * loopback fake only; no real organization has been read.
26
+ */
27
+ import type { ForgeFetch } from "../pr-forge.js";
28
+ import type { ForgeCheckContract } from "./contract.js";
29
+ import { type CheckRow, type ForgeCheckDeps } from "./types.js";
30
+ /** The variable holding a Pulumi access token that can read the organization's issuers. */
31
+ export declare const PULUMI_TOKEN_ENV = "PULUMI_ACCESS_TOKEN";
32
+ interface PulumiPolicy {
33
+ decision?: string;
34
+ tokenType?: string;
35
+ teamName?: string;
36
+ userLogin?: string;
37
+ authorizedPermissions?: string[];
38
+ rules?: Record<string, unknown>;
39
+ }
40
+ /** Whether a policy grants the token `identity` names; false for an identity Pulumi Cloud has no token for. */
41
+ export declare function policyGrants(p: PulumiPolicy, identity: string): boolean;
42
+ export declare function pulumiRows(c: ForgeCheckContract, fetch: ForgeFetch, deps: ForgeCheckDeps): Promise<CheckRow[]>;
43
+ export {};
44
+ //# sourceMappingURL=pulumi.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pulumi.d.ts","sourceRoot":"","sources":["../../src/forge-check/pulumi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAY,MAAM,YAAY,CAAC;AAG/D,OAAO,EAAkB,KAAK,QAAQ,EAAoB,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAE/F,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AAWtD,UAAU,YAAY;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,+GAA+G;AAC/G,wBAAgB,YAAY,CAAC,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQvE;AAiDD,wBAAsB,UAAU,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA+EpH"}
@@ -0,0 +1,184 @@
1
+ /**
2
+ * Pulumi Cloud's side of the check (#4608, for #4549's identities): the
3
+ * organization has the forge registered as an OIDC issuer, and the issuer's
4
+ * authorization policies give each token the contract names to its jobs
5
+ * and to no other subject.
6
+ *
7
+ * Two reads per organization, both GETs with `Authorization: token
8
+ * <PULUMI_ACCESS_TOKEN>`, as Pulumi Cloud's REST API documents them:
9
+ *
10
+ * GET <apiUrl>/api/orgs/<org>/oidc/issuers
11
+ * { oidcIssuers: [{ id, name, url, ... }] }
12
+ * GET <apiUrl>/api/orgs/<org>/auth/policies/oidcissuers/<issuer id>
13
+ * { policies: [{ decision, tokenType, teamName, userLogin,
14
+ * authorizedPermissions, rules: { sub, aud, ... } }] }
15
+ *
16
+ * A policy grants a token when its decision is `allow` and its token type
17
+ * (and team, user, or the organization's admin permission) is the
18
+ * identity's: `team:<name>`, `user:<login>`, `organization`,
19
+ * `organization:admin` (`pulumiTokenRequest` in ../ci-identity.ts). Its
20
+ * rules are claim values, where `*` stands for any text. A grant must admit
21
+ * each job that takes the token, and each grant's `sub` must be within some
22
+ * such job's subject. A grant with no `sub` rule admits any subject.
23
+ *
24
+ * The shapes follow Pulumi's documentation and are tested against a
25
+ * loopback fake only; no real organization has been read.
26
+ */
27
+ import { ReadOnlyError } from "./read-only.js";
28
+ import { admits, hasWildcard, within } from "./trust.js";
29
+ import { SCOPES, unique } from "./types.js";
30
+ /** The variable holding a Pulumi access token that can read the organization's issuers. */
31
+ export const PULUMI_TOKEN_ENV = "PULUMI_ACCESS_TOKEN";
32
+ const DEFAULT_API = "https://api.pulumi.com";
33
+ /** Whether a policy grants the token `identity` names; false for an identity Pulumi Cloud has no token for. */
34
+ export function policyGrants(p, identity) {
35
+ if ((p.decision ?? "").toLowerCase() !== "allow")
36
+ return false;
37
+ const m = /^(team|user):(.+)$/.exec(identity);
38
+ if (m?.[1] === "team")
39
+ return p.tokenType === "team" && p.teamName === m[2];
40
+ if (m?.[1] === "user")
41
+ return p.tokenType === "personal" && p.userLogin === m[2];
42
+ if (identity === "organization")
43
+ return p.tokenType === "organization" && !(p.authorizedPermissions ?? []).includes("admin");
44
+ if (identity === "organization:admin")
45
+ return p.tokenType === "organization" && (p.authorizedPermissions ?? []).includes("admin");
46
+ return false;
47
+ }
48
+ const ruleValues = (rules, claim) => {
49
+ const v = rules?.[claim];
50
+ if (v === undefined)
51
+ return null;
52
+ const list = typeof v === "string" ? [v] : Array.isArray(v) ? v.filter((x) => typeof x === "string") : [];
53
+ return list.map((value) => ({ value, like: hasWildcard(value) }));
54
+ };
55
+ const sameIssuer = (a, b) => a !== undefined && a.replace(/\/+$/, "") === b.replace(/\/+$/, "");
56
+ /** Each organization the contract's jobs trade in, keyed by API and organization. */
57
+ function organizationsOf(c) {
58
+ const out = new Map();
59
+ for (const j of c.jobs) {
60
+ if (!j.pulumi)
61
+ continue;
62
+ const api = (j.pulumi.apiUrl ?? DEFAULT_API).replace(/\/+$/, "");
63
+ const key = `${api} ${j.pulumi.organization}`;
64
+ const org = out.get(key) ?? { organization: j.pulumi.organization, api, audience: j.pulumi.audience, tokens: new Map() };
65
+ for (const t of j.pulumi.tokens) {
66
+ const have = org.tokens.get(t) ?? [];
67
+ if (!have.some((h) => h.subject === j.token.subject && h.issuer === j.token.issuer))
68
+ have.push(j.token);
69
+ org.tokens.set(t, have);
70
+ }
71
+ out.set(key, org);
72
+ }
73
+ return [...out.values()];
74
+ }
75
+ async function getJson(fetch, url, token) {
76
+ try {
77
+ const res = await fetch(url, { method: "GET", headers: { authorization: `token ${token}`, accept: "application/vnd.pulumi+8" } });
78
+ const text = await res.text();
79
+ if (!res.ok)
80
+ return { ok: false, status: res.status, why: text.slice(0, 300) };
81
+ return { ok: true, value: JSON.parse(text) };
82
+ }
83
+ catch (e) {
84
+ if (e instanceof ReadOnlyError)
85
+ throw e;
86
+ return { ok: false, status: undefined, why: e.message };
87
+ }
88
+ }
89
+ export async function pulumiRows(c, fetch, deps) {
90
+ const orgs = organizationsOf(c);
91
+ if (!orgs.length)
92
+ return [];
93
+ const token = deps.env[PULUMI_TOKEN_ENV];
94
+ const rows = [];
95
+ for (const org of orgs) {
96
+ const issuers = unique([...org.tokens.values()].flat().map((t) => t.issuer));
97
+ const trustRow = (identity, expected, found, status) => rows.push({ where: "pulumi", check: "trust", subject: `${org.organization} ${identity}`, expected, found, status });
98
+ const expectedOf = (jobs) => jobs.map((t) => `sub ${t.subject}${t.pattern ? " (like)" : ""}`).join("; ");
99
+ if (!token) {
100
+ for (const issuer of issuers)
101
+ rows.push({ where: "pulumi", check: "oidc-issuer", subject: `${org.organization} ${issuer}`, expected: "registered", found: `not checked: no Pulumi Cloud credentials (${PULUMI_TOKEN_ENV})`, status: "not-checked" });
102
+ for (const [identity, jobs] of org.tokens)
103
+ trustRow(identity, expectedOf(jobs), `not checked: no Pulumi Cloud credentials (${PULUMI_TOKEN_ENV})`, "not-checked");
104
+ continue;
105
+ }
106
+ const base = `${org.api}/api/orgs/${encodeURIComponent(org.organization)}`;
107
+ const list = await getJson(fetch, `${base}/oidc/issuers`, token);
108
+ const registered = new Map();
109
+ for (const issuer of issuers) {
110
+ const subject = `${org.organization} ${issuer}`;
111
+ if (!list.ok) {
112
+ rows.push({ where: "pulumi", check: "oidc-issuer", subject, expected: "registered", found: `could not read (${list.status ?? "no answer"}); ${SCOPES.pulumi}`, status: "unknown" });
113
+ continue;
114
+ }
115
+ const found = (list.value.oidcIssuers ?? []).find((i) => sameIssuer(i.url, issuer) || sameIssuer(i.issuer, issuer));
116
+ if (found)
117
+ registered.set(issuer, found);
118
+ rows.push({ where: "pulumi", check: "oidc-issuer", subject, expected: "registered", found: found ? `registered as ${found.name ?? found.id}` : "not registered", status: found ? "match" : "mismatch" });
119
+ }
120
+ const policies = new Map();
121
+ for (const [issuer, i] of registered) {
122
+ const r = await getJson(fetch, `${base}/auth/policies/oidcissuers/${encodeURIComponent(i.id)}`, token);
123
+ policies.set(issuer, r.ok ? { ok: true, value: r.value.policies ?? [] } : { ok: false, why: `could not read (${r.status ?? "no answer"}); ${SCOPES.pulumi}` });
124
+ }
125
+ for (const [identity, jobs] of org.tokens) {
126
+ const expected = expectedOf(jobs);
127
+ const problems = [];
128
+ const seen = [];
129
+ let unread;
130
+ let unregistered = false;
131
+ for (const issuer of unique(jobs.map((t) => t.issuer))) {
132
+ const mine = jobs.filter((t) => t.issuer === issuer);
133
+ const p = policies.get(issuer);
134
+ if (!p) {
135
+ if (list.ok)
136
+ unregistered = true;
137
+ else
138
+ unread = `could not read the issuers; ${SCOPES.pulumi}`;
139
+ continue;
140
+ }
141
+ if (!p.ok) {
142
+ unread = p.why;
143
+ continue;
144
+ }
145
+ const grants = p.value.filter((x) => policyGrants(x, identity));
146
+ for (const g of grants) {
147
+ const subs = ruleValues(g.rules, "sub");
148
+ const auds = ruleValues(g.rules, "aud");
149
+ seen.push(`sub ${subs === null ? "any" : subs.map((s) => s.value).join(" | ")}${auds ? ` aud ${auds.map((a) => a.value).join(" | ")}` : ""}`);
150
+ if (subs === null) {
151
+ problems.push(`a policy grants ${identity} with no sub rule, so it admits any subject of the issuer`);
152
+ continue;
153
+ }
154
+ for (const s of subs)
155
+ if (!mine.some((t) => within(s, t.subject, t.pattern)))
156
+ problems.push(`grants ${identity} to sub ${s.value}${s.like ? " (like)" : ""}, which no job that takes it presents`);
157
+ if (auds)
158
+ for (const a of auds)
159
+ if (!within(a, org.audience, false))
160
+ problems.push(`grants ${identity} to aud ${a.value}, not ${org.audience}`);
161
+ }
162
+ for (const t of mine) {
163
+ const ok = grants.some((g) => {
164
+ const subs = ruleValues(g.rules, "sub");
165
+ const auds = ruleValues(g.rules, "aud");
166
+ return (subs === null || subs.some((s) => admits(s, t.subject, t.pattern))) && (auds === null || auds.some((a) => admits(a, org.audience, false)));
167
+ });
168
+ if (!ok)
169
+ problems.push(`no policy grants ${identity} to sub ${t.subject}${t.pattern ? " (like)" : ""}`);
170
+ }
171
+ }
172
+ const found = seen.length ? seen.join("; ") : "no policy grants it";
173
+ if (problems.length)
174
+ trustRow(identity, expected, `${found}; ${unique(problems).join("; ")}`, "mismatch");
175
+ else if (unregistered)
176
+ trustRow(identity, expected, "the forge is not a registered issuer", "mismatch");
177
+ else if (unread)
178
+ trustRow(identity, expected, unread, "unknown");
179
+ else
180
+ trustRow(identity, expected, found, "match");
181
+ }
182
+ }
183
+ return rows;
184
+ }
@@ -0,0 +1,26 @@
1
+ /**
2
+ * The forge check's one way out (#4608): every request it makes passes
3
+ * {@link assertReadOnly} first. GET and HEAD go through, and a POST only
4
+ * when it is an AWS Query API read named in {@link READ_ACTIONS}. Anything
5
+ * else is refused before it is sent, so the check cannot write to a forge,
6
+ * a cloud or Pulumi Cloud.
7
+ *
8
+ * Lifted from terragucci's `forge check` (INTENTIUS/terragucci
9
+ * packages/terragucci/src/forge-check.ts, `assertReadOnly` and `readOnly`).
10
+ */
11
+ import type { ForgeFetch } from "../pr-forge.js";
12
+ /** The AWS Query API actions a request may name: reads alone. */
13
+ export declare const READ_ACTIONS: readonly string[];
14
+ export declare class ReadOnlyError extends Error {
15
+ constructor(message: string);
16
+ }
17
+ /**
18
+ * Refuse any request that could write: a method other than GET or HEAD, or an
19
+ * AWS Query action (`Action=` in the query or a form body) not in
20
+ * READ_ACTIONS. A POST passes only as such a read action, which the Query API
21
+ * takes as GET or POST alike. `command` names the command in the message.
22
+ */
23
+ export declare function assertReadOnly(url: string, method: string, body?: string, command?: string): void;
24
+ /** `fetch`, refusing every request {@link assertReadOnly} refuses before it is sent. */
25
+ export declare function readOnly(fetch: ForgeFetch, command?: string): ForgeFetch;
26
+ //# sourceMappingURL=read-only.d.ts.map