@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,307 @@
1
+ /**
2
+ * chant#4558: the Azure Blob check. Four ARM reads (blob service properties,
3
+ * the account's management policy, the account, the container), then
4
+ * {@link evaluateAzure}, a port of choudoufu's
5
+ * pkg/staterecord/azurecontract.go (CheckAzureContract).
6
+ *
7
+ * With an `endpoint` (an ARM emulator), the target must carry a bearer token
8
+ * and every call is pinned to that endpoint; DefaultAzureCredential is never
9
+ * used against it.
10
+ */
11
+
12
+ import { resolveAzureToken, sdkCredentialChains, type CredentialChains } from "../cloud-lister/credentials";
13
+ import { jsonBody, type TlsOptions, type WireResponse } from "../cloud-lister/transport";
14
+ import { isReadError, type BucketFinding, type BucketReport, type ReadError } from "./types";
15
+ import { BucketCheckError, namespacePrefix, sendGet, type WireOptions } from "./wire";
16
+
17
+ export interface AzureBlobTarget {
18
+ store: "azblob";
19
+ subscriptionId: string;
20
+ resourceGroup: string;
21
+ account: string;
22
+ container: string;
23
+ /** An ARM emulator's base, e.g. `http://localhost:4580`. Requires `token`. */
24
+ endpoint?: string;
25
+ token?: string;
26
+ tls?: TlsOptions;
27
+ }
28
+
29
+ const API_VERSION = "2023-05-01";
30
+
31
+ interface DateAfter {
32
+ daysAfterModificationGreaterThan?: number;
33
+ daysAfterCreationGreaterThan?: number;
34
+ daysAfterLastAccessTimeGreaterThan?: number;
35
+ daysAfterLastTierChangeGreaterThan?: number;
36
+ }
37
+
38
+ export interface AzureManagementPolicyRule {
39
+ name?: string;
40
+ enabled?: boolean;
41
+ type?: string;
42
+ definition?: {
43
+ filters?: { blobTypes?: string[]; prefixMatch?: string[]; blobIndexMatch?: unknown[] };
44
+ actions?: {
45
+ baseBlob?: { delete?: DateAfter; tierToArchive?: DateAfter; tierToCool?: DateAfter };
46
+ version?: { delete?: { daysAfterCreationGreaterThan?: number } };
47
+ snapshot?: unknown;
48
+ };
49
+ };
50
+ }
51
+
52
+ /** The ARM documents the check reads, each as returned or as the read's error. */
53
+ export interface AzureInput {
54
+ blobServices: { properties?: { isVersioningEnabled?: boolean } } | ReadError;
55
+ managementPolicy: { properties?: { policy?: { rules?: AzureManagementPolicyRule[] } } } | ReadError;
56
+ account: { properties?: { allowBlobPublicAccess?: boolean } } | ReadError;
57
+ /** Read only to say whether a container is already public; its failure is ignored. */
58
+ container?: { properties?: { publicAccess?: string } } | ReadError;
59
+ }
60
+
61
+ export interface AzureEvaluateOptions {
62
+ account: string;
63
+ resourceGroup: string;
64
+ container: string;
65
+ /** Blob-name prefixes inside the container. */
66
+ namespaces?: readonly string[];
67
+ recoveryDays?: number;
68
+ }
69
+
70
+ function readFailure(setting: BucketFinding["setting"], action: string, e: ReadError): BucketFinding {
71
+ if (e.error.status !== 403) {
72
+ throw new BucketCheckError(`azurerm: reading the storage account's ${setting} setting failed: ${e.error.code ?? `HTTP ${e.error.status ?? "?"}`}`);
73
+ }
74
+ return { setting, verdict: "unreadable", found: `${action} was denied`, unwaivable: false, fix: `Grant the identity ${action} on the storage account, or have someone who holds it confirm the setting.` };
75
+ }
76
+
77
+ const ruleName = (r: AzureManagementPolicyRule): string => (r.name ? r.name : "(unnamed rule)");
78
+ const enabled = (r: AzureManagementPolicyRule): boolean => r.enabled === undefined || r.enabled;
79
+ const filters = (r: AzureManagementPolicyRule) => r.definition?.filters ?? {};
80
+ const actions = (r: AzureManagementPolicyRule) => r.definition?.actions ?? {};
81
+
82
+ function touchesBlockBlobs(r: AzureManagementPolicyRule): boolean {
83
+ const types = filters(r).blobTypes ?? [];
84
+ return types.length === 0 || types.some((t) => t.toLowerCase() === "blockblob");
85
+ }
86
+
87
+ function dateAfter(d: DateAfter | undefined): string {
88
+ if (!d) return "";
89
+ const pairs: Array<[number | undefined, string]> = [
90
+ [d.daysAfterModificationGreaterThan, "since last modification"],
91
+ [d.daysAfterCreationGreaterThan, "since creation"],
92
+ [d.daysAfterLastAccessTimeGreaterThan, "since last access"],
93
+ [d.daysAfterLastTierChangeGreaterThan, "since the last tier change"],
94
+ ];
95
+ for (const [days, what] of pairs) if (days !== undefined) return `after ${days} day(s) ${what}`;
96
+ return "";
97
+ }
98
+
99
+ function harmsCurrent(r: AzureManagementPolicyRule): string {
100
+ const base = actions(r).baseBlob;
101
+ if (!base) return "";
102
+ const del = dateAfter(base.delete);
103
+ if (del) return `deletes current blobs ${del}`;
104
+ const arch = dateAfter(base.tierToArchive);
105
+ if (arch) return `moves current blobs to the archive tier ${arch}, where a blob cannot be read until it is rehydrated`;
106
+ return "";
107
+ }
108
+
109
+ function noncurrentDays(r: AzureManagementPolicyRule): number {
110
+ const d = actions(r).version?.delete?.daysAfterCreationGreaterThan;
111
+ return d === undefined ? 0 : Math.trunc(d);
112
+ }
113
+
114
+ function covers(r: AzureManagementPolicyRule, target: string): boolean {
115
+ const prefixes = filters(r).prefixMatch ?? [];
116
+ return prefixes.length === 0 || prefixes.some((p) => target.startsWith(p));
117
+ }
118
+
119
+ function mayReach(r: AzureManagementPolicyRule, targets: readonly string[]): boolean {
120
+ const prefixes = filters(r).prefixMatch ?? [];
121
+ if (prefixes.length === 0) return true;
122
+ return prefixes.some((p) => targets.some((t) => t.startsWith(p) || p.startsWith(t)));
123
+ }
124
+
125
+ export function azureLifecycleFix(account: string, resourceGroup: string, container: string, namespaces: readonly string[], recoveryDays: number): string {
126
+ const prefixMatch = (namespaces.length === 0 ? [""] : namespaces).map((ns) => `${container}/${namespacePrefix(ns)}`);
127
+ const policy = {
128
+ rules: [
129
+ {
130
+ name: "expire-previous-versions",
131
+ enabled: true,
132
+ type: "Lifecycle",
133
+ definition: {
134
+ filters: { blobTypes: ["blockBlob"], prefixMatch },
135
+ actions: { version: { delete: { daysAfterCreationGreaterThan: recoveryDays } } },
136
+ },
137
+ },
138
+ ],
139
+ };
140
+ return (
141
+ `Write ${JSON.stringify(policy)} to policy.json, then: az storage account management-policy create --account-name ${account} --resource-group ${resourceGroup} --policy @policy.json ` +
142
+ `(this replaces the account's lifecycle policy, so add this rule to any it already has; ${recoveryDays} days is how long a deleted or overwritten record stays recoverable)`
143
+ );
144
+ }
145
+
146
+ export function evaluateAzure(input: AzureInput, options: AzureEvaluateOptions): BucketFinding[] {
147
+ return [versioning(input, options), lifecycle(input, options), publicAccess(input, options)];
148
+ }
149
+
150
+ function versioning(input: AzureInput, o: AzureEvaluateOptions): BucketFinding {
151
+ const b = input.blobServices;
152
+ if (isReadError(b)) return readFailure("blob_versioning", "Microsoft.Storage/storageAccounts/blobServices/read", b);
153
+ if (b.properties?.isVersioningEnabled === true) return { setting: "blob_versioning", verdict: "ok", found: "blob versioning is enabled", unwaivable: false };
154
+ return {
155
+ setting: "blob_versioning",
156
+ verdict: "fail",
157
+ found: "blob versioning is not enabled",
158
+ unwaivable: false,
159
+ fix: `az storage account blob-service-properties update --account-name ${o.account} --resource-group ${o.resourceGroup} --enable-versioning true`,
160
+ };
161
+ }
162
+
163
+ function lifecycle(input: AzureInput, o: AzureEvaluateOptions): BucketFinding {
164
+ const namespaces = o.namespaces ?? [];
165
+ const fail = (found: string): BucketFinding => ({
166
+ setting: "lifecycle_management",
167
+ verdict: "fail",
168
+ found,
169
+ unwaivable: false,
170
+ fix: azureLifecycleFix(o.account, o.resourceGroup, o.container, namespaces, o.recoveryDays ?? 30),
171
+ });
172
+ const p = input.managementPolicy;
173
+ if (isReadError(p)) {
174
+ if (p.error.status === 404) return fail("the storage account has no lifecycle management policy");
175
+ return readFailure("lifecycle_management", "Microsoft.Storage/storageAccounts/managementPolicies/read", p);
176
+ }
177
+ const rules = p.properties?.policy?.rules ?? [];
178
+ const targets = namespaces.length === 0 ? [`${o.container}/`] : namespaces.map((ns) => `${o.container}/${namespacePrefix(ns)}`);
179
+
180
+ const deleting: string[] = [];
181
+ for (const r of rules) {
182
+ if (!enabled(r) || !touchesBlockBlobs(r)) continue;
183
+ const what = harmsCurrent(r);
184
+ if (what === "" || !mayReach(r, targets)) continue;
185
+ deleting.push(`rule "${ruleName(r)}" ${what}, and a record is a current blob`);
186
+ }
187
+ if (deleting.length > 0) {
188
+ return {
189
+ setting: "lifecycle_management",
190
+ verdict: "fail",
191
+ found: deleting.join("; "),
192
+ unwaivable: true,
193
+ fix: "Remove the baseBlob delete or tierToArchive action from that rule, or limit the rule to a prefix outside these blobs. Only a version delete belongs on a rule that reaches them.",
194
+ };
195
+ }
196
+
197
+ const near: string[] = [];
198
+ const covering: AzureManagementPolicyRule[] = [];
199
+ for (const r of rules) {
200
+ if (noncurrentDays(r) <= 0) continue;
201
+ if (!enabled(r)) near.push(`rule "${ruleName(r)}" deletes previous versions but is disabled`);
202
+ else if (!touchesBlockBlobs(r)) near.push(`rule "${ruleName(r)}" deletes previous versions but not of block blobs, which is what a record is`);
203
+ else if (filters(r).blobIndexMatch !== undefined) near.push(`rule "${ruleName(r)}" deletes previous versions but is filtered by blob index tag, which this check does not rely on`);
204
+ else covering.push(r);
205
+ }
206
+ const used: string[] = [];
207
+ const uncovered: string[] = [];
208
+ for (const t of targets) {
209
+ const hit = covering.find((r) => covers(r, t));
210
+ if (hit) {
211
+ const d = `rule "${ruleName(hit)}" deletes previous versions after ${noncurrentDays(hit)} day(s)`;
212
+ if (!used.includes(d)) used.push(d);
213
+ } else {
214
+ uncovered.push(t);
215
+ }
216
+ }
217
+ if (uncovered.length === 0 && covering.length > 0) return { setting: "lifecycle_management", verdict: "ok", found: used.join("; "), unwaivable: false };
218
+ for (const r of covering) {
219
+ const quoted = (filters(r).prefixMatch ?? []).map((x) => `"${x}"`).join(", ");
220
+ for (const t of uncovered) near.push(`rule "${ruleName(r)}" deletes previous versions but only under ${quoted}, which does not contain "${t}"`);
221
+ }
222
+ if (near.length > 0) return fail(near.join("; "));
223
+ if (rules.length === 0) return fail("the lifecycle management policy has no rules");
224
+ return fail(`none of the lifecycle management policy's ${rules.length} rule(s) deletes previous versions`);
225
+ }
226
+
227
+ function publicAccess(input: AzureInput, o: AzureEvaluateOptions): BucketFinding {
228
+ const a = input.account;
229
+ if (isReadError(a)) return readFailure("public_access", "Microsoft.Storage/storageAccounts/read", a);
230
+ const allow = a.properties?.allowBlobPublicAccess;
231
+ if (allow === false) return { setting: "public_access", verdict: "ok", found: "the storage account disallows anonymous blob access", unwaivable: false };
232
+ let found = allow === undefined ? "the storage account does not set allowBlobPublicAccess, which accounts created before 2023 read as allowed" : "the storage account allows anonymous blob access";
233
+ const c = input.container;
234
+ const level = c && !isReadError(c) ? c.properties?.publicAccess : undefined;
235
+ if (level !== undefined && level !== "None") found += `, and container "${o.container}" is already readable anonymously at level "${level}"`;
236
+ return {
237
+ setting: "public_access",
238
+ verdict: "fail",
239
+ found,
240
+ unwaivable: false,
241
+ fix: `az storage account update --name ${o.account} --resource-group ${o.resourceGroup} --allow-blob-public-access false`,
242
+ };
243
+ }
244
+
245
+ export interface AzureReadOptions extends WireOptions {
246
+ chains?: CredentialChains;
247
+ }
248
+
249
+ export function azureUrls(target: AzureBlobTarget): { blobServices: string; managementPolicy: string; account: string; container: string } {
250
+ const base = (target.endpoint ?? "https://management.azure.com").replace(/\/+$/, "");
251
+ const acct = `${base}/subscriptions/${encodeURIComponent(target.subscriptionId)}/resourceGroups/${encodeURIComponent(target.resourceGroup)}/providers/Microsoft.Storage/storageAccounts/${encodeURIComponent(target.account)}`;
252
+ const q = `?api-version=${API_VERSION}`;
253
+ return {
254
+ blobServices: `${acct}/blobServices/default${q}`,
255
+ managementPolicy: `${acct}/managementPolicies/default${q}`,
256
+ account: `${acct}${q}`,
257
+ container: `${acct}/blobServices/default/containers/${encodeURIComponent(target.container)}${q}`,
258
+ };
259
+ }
260
+
261
+ function asDoc<T>(res: WireResponse): T | ReadError {
262
+ if (res.status >= 200 && res.status < 300) return (jsonBody(res) ?? {}) as T;
263
+ const body = jsonBody(res) as { error?: { code?: string } } | undefined;
264
+ return { error: { status: res.status, ...(body?.error?.code ? { code: body.error.code } : {}) } };
265
+ }
266
+
267
+ export async function readAzure(target: AzureBlobTarget, options: AzureReadOptions = {}): Promise<AzureInput> {
268
+ const token = await resolveAzureToken(target, options.chains ?? sdkCredentialChains);
269
+ const headers = { accept: "application/json", authorization: `Bearer ${token}` };
270
+ const wire: WireOptions = { ...options, ...(target.tls ? { tls: target.tls } : {}) };
271
+ const urls = azureUrls(target);
272
+ const get = (url: string) => sendGet("azure", url, headers, target.endpoint, wire);
273
+ const account = await get(urls.account);
274
+ if (account.status === 404) throw new BucketCheckError(`azurerm: storage account ${target.account} in ${target.resourceGroup} does not exist; the check creates nothing`);
275
+ const blobServices = await get(urls.blobServices);
276
+ const managementPolicy = await get(urls.managementPolicy);
277
+ let container: AzureInput["container"];
278
+ try {
279
+ container = asDoc(await get(urls.container));
280
+ } catch {
281
+ container = undefined;
282
+ }
283
+ return {
284
+ blobServices: asDoc(blobServices),
285
+ managementPolicy: asDoc(managementPolicy),
286
+ account: asDoc(account),
287
+ ...(container !== undefined ? { container } : {}),
288
+ };
289
+ }
290
+
291
+ export async function checkAzureBlob(target: AzureBlobTarget, options: AzureReadOptions & { namespaces?: readonly string[]; recoveryDays?: number } = {}): Promise<BucketReport> {
292
+ const input = await readAzure(target, options);
293
+ const settings = evaluateAzure(input, {
294
+ account: target.account,
295
+ resourceGroup: target.resourceGroup,
296
+ container: target.container,
297
+ namespaces: options.namespaces ?? [],
298
+ ...(options.recoveryDays !== undefined ? { recoveryDays: options.recoveryDays } : {}),
299
+ });
300
+ return {
301
+ store: "azblob",
302
+ bucket: `${target.account}/${target.container}`,
303
+ namespaces: [...(options.namespaces ?? [])],
304
+ correct: settings.every((f) => f.verdict === "ok"),
305
+ settings,
306
+ };
307
+ }
@@ -0,0 +1,210 @@
1
+ /**
2
+ * chant#4558: the shared fixture set through chant's evaluators, and the
3
+ * wire behaviour against fake fetchers (no socket is opened, no cloud is
4
+ * reached, no credential chain is asked).
5
+ */
6
+ import { readFileSync } from "node:fs";
7
+ import { describe, expect, it } from "vitest";
8
+ import { fakeFetcher, refusingChains, steppingClock } from "../cloud-lister/fakes";
9
+ import { ListerConfigError } from "../cloud-lister/credentials";
10
+ import type { WireResponse } from "../cloud-lister/transport";
11
+ import {
12
+ BUCKET_SETTINGS,
13
+ BucketCheckError,
14
+ checkBucket,
15
+ evaluateAzure,
16
+ evaluateGcs,
17
+ evaluateS3,
18
+ refusedFindings,
19
+ type AzureInput,
20
+ type BucketFinding,
21
+ type GcsInput,
22
+ type S3Input,
23
+ } from "./index";
24
+ import { parseLifecycle, parsePublicAccessBlock, parseVersioning } from "./s3";
25
+
26
+ interface Case<I> {
27
+ name: string;
28
+ bucket?: string;
29
+ account?: string;
30
+ resourceGroup?: string;
31
+ container?: string;
32
+ namespaces: string[];
33
+ input: I;
34
+ expect: Array<{ setting: string; verdict: string; unwaivable: boolean }>;
35
+ }
36
+
37
+ function load<I>(store: string): { store: string; cases: Array<Case<I>> } {
38
+ return JSON.parse(readFileSync(new URL(`./fixtures/${store}.json`, import.meta.url), "utf8"));
39
+ }
40
+
41
+ const shape = (fs: BucketFinding[]) => fs.map((f) => ({ setting: f.setting, verdict: f.verdict, unwaivable: f.unwaivable }));
42
+
43
+ describe("shared fixtures", () => {
44
+ const s3 = load<S3Input>("s3");
45
+ it.each(s3.cases.map((c) => [c.name, c] as const))("s3 %s", (_n, c) => {
46
+ const findings = evaluateS3(c.input, { bucket: c.bucket!, namespaces: c.namespaces });
47
+ expect(shape(findings)).toEqual(c.expect);
48
+ for (const f of findings) {
49
+ expect(f.found).not.toBe("");
50
+ if (f.verdict !== "ok") expect(f.fix).toBeTruthy();
51
+ }
52
+ });
53
+
54
+ const gcs = load<GcsInput>("gcs");
55
+ it.each(gcs.cases.map((c) => [c.name, c] as const))("gcs %s", (_n, c) => {
56
+ expect(shape(evaluateGcs(c.input, { bucket: c.bucket!, namespaces: c.namespaces }))).toEqual(c.expect);
57
+ });
58
+
59
+ const azure = load<AzureInput>("azure");
60
+ it.each(azure.cases.map((c) => [c.name, c] as const))("azure %s", (_n, c) => {
61
+ const findings = evaluateAzure(c.input, { account: c.account!, resourceGroup: c.resourceGroup!, container: c.container!, namespaces: c.namespaces });
62
+ expect(shape(findings)).toEqual(c.expect);
63
+ });
64
+
65
+ it("every fixture lists every setting of its store, in order", () => {
66
+ for (const [file, store] of [["s3", "s3"], ["gcs", "gcs"], ["azure", "azblob"]] as const) {
67
+ for (const c of load<unknown>(file).cases) expect(c.expect.map((e) => e.setting)).toEqual([...BUCKET_SETTINGS[store]]);
68
+ }
69
+ });
70
+ });
71
+
72
+ describe("refusedFindings", () => {
73
+ it("honours a waiver except on an unwaivable finding", () => {
74
+ const c = load<S3Input>("s3").cases.find((x) => x.name === "current-expiry-reaches-records")!;
75
+ const settings = evaluateS3({ ...c.input, versioning: {} }, { bucket: "b", namespaces: c.namespaces });
76
+ const report = { store: "s3" as const, bucket: "b", namespaces: c.namespaces, correct: false, settings };
77
+ expect(refusedFindings(report, ["versioning", "lifecycle"]).map((f) => f.setting)).toEqual(["lifecycle"]);
78
+ });
79
+ });
80
+
81
+ describe("S3 XML documents", () => {
82
+ it("reads versioning, the public access block and lifecycle rules", () => {
83
+ expect(parseVersioning(`<?xml version="1.0"?><VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"><Status>Enabled</Status></VersioningConfiguration>`)).toEqual({ Status: "Enabled" });
84
+ expect(parseVersioning(`<VersioningConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"/>`)).toEqual({});
85
+ expect(
86
+ parsePublicAccessBlock(
87
+ `<PublicAccessBlockConfiguration><BlockPublicAcls>true</BlockPublicAcls><IgnorePublicAcls>true</IgnorePublicAcls><BlockPublicPolicy>false</BlockPublicPolicy><RestrictPublicBuckets>true</RestrictPublicBuckets></PublicAccessBlockConfiguration>`,
88
+ ),
89
+ ).toEqual({ PublicAccessBlockConfiguration: { BlockPublicAcls: true, IgnorePublicAcls: true, BlockPublicPolicy: false, RestrictPublicBuckets: true } });
90
+ const lc = parseLifecycle(
91
+ `<LifecycleConfiguration><Rule><ID>records</ID><Filter><Prefix>records/</Prefix></Filter><Status>Enabled</Status><NoncurrentVersionExpiration><NoncurrentDays>30</NoncurrentDays></NoncurrentVersionExpiration></Rule>` +
92
+ `<Rule><ID>tagged</ID><Filter><And><Prefix>x/</Prefix><Tag><Key>k</Key><Value>v</Value></Tag></And></Filter><Status>Enabled</Status><Expiration><Days>7</Days></Expiration></Rule></LifecycleConfiguration>`,
93
+ );
94
+ expect(lc.Rules).toEqual([
95
+ { ID: "records", Status: "Enabled", Filter: { Prefix: "records/" }, NoncurrentVersionExpiration: { NoncurrentDays: 30 } },
96
+ { ID: "tagged", Status: "Enabled", Filter: { And: { Prefix: "x/", Tags: [{ Key: "k", Value: "v" }] } }, Expiration: { Days: 7 } },
97
+ ]);
98
+ });
99
+ });
100
+
101
+ const xml = (status: number, body: string): WireResponse => ({ status, headers: { "content-type": "application/xml" }, body });
102
+ const ENDPOINT = "http://localhost:4566";
103
+ const CREDS = { accessKeyId: "test", secretAccessKey: "test" };
104
+
105
+ describe("S3 on the wire", () => {
106
+ it("sends three signed GETs to the emulator only, path style, without asking a chain", async () => {
107
+ const chains = refusingChains();
108
+ const fake = fakeFetcher((call) => {
109
+ const q = new URL(call.url).search;
110
+ if (q === "?versioning") return xml(200, `<VersioningConfiguration><Status>Enabled</Status></VersioningConfiguration>`);
111
+ if (q === "?lifecycle")
112
+ return xml(200, `<LifecycleConfiguration><Rule><ID>r</ID><Filter><Prefix>records/</Prefix></Filter><Status>Enabled</Status><NoncurrentVersionExpiration><NoncurrentDays>30</NoncurrentDays></NoncurrentVersionExpiration></Rule></LifecycleConfiguration>`);
113
+ if (q === "?publicAccessBlock") return xml(404, `<Error><Code>NoSuchPublicAccessBlockConfiguration</Code></Error>`);
114
+ return undefined;
115
+ });
116
+ const report = await checkBucket(
117
+ { store: "s3", bucket: "records-prod", region: "us-east-1", endpoint: ENDPOINT, credentials: CREDS },
118
+ { fetcher: fake.fetcher, chains, now: steppingClock(), namespaces: ["records/prod"] },
119
+ );
120
+ expect(chains.count).toEqual({ aws: 0, azure: 0, gcp: 0 });
121
+ expect(fake.calls.map((c) => `${c.method} ${c.url}`)).toEqual([
122
+ `GET ${ENDPOINT}/records-prod?versioning`,
123
+ `GET ${ENDPOINT}/records-prod?lifecycle`,
124
+ `GET ${ENDPOINT}/records-prod?publicAccessBlock`,
125
+ ]);
126
+ for (const c of fake.calls) {
127
+ expect(c.headers.authorization).toMatch(/^AWS4-HMAC-SHA256 Credential=test\/20261026\/us-east-1\/s3\/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=[0-9a-f]{64}$/);
128
+ expect(c.headers["x-amz-content-sha256"]).toBe("e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855");
129
+ }
130
+ expect(report.correct).toBe(false);
131
+ expect(report.settings.map((f) => f.verdict)).toEqual(["ok", "ok", "fail"]);
132
+ expect(report.settings[2]!.fix).toContain("put-public-access-block --bucket records-prod");
133
+ });
134
+
135
+ it("refuses an endpoint without static credentials and never asks the default chain", async () => {
136
+ const chains = refusingChains();
137
+ const fake = fakeFetcher(() => undefined);
138
+ await expect(checkBucket({ store: "s3", bucket: "b", region: "us-east-1", endpoint: ENDPOINT }, { fetcher: fake.fetcher, chains })).rejects.toBeInstanceOf(ListerConfigError);
139
+ expect(chains.count.aws).toBe(0);
140
+ expect(fake.calls).toEqual([]);
141
+ });
142
+
143
+ it("refuses a bucket that does not exist", async () => {
144
+ const fake = fakeFetcher(() => xml(404, `<Error><Code>NoSuchBucket</Code></Error>`));
145
+ await expect(
146
+ checkBucket({ store: "s3", bucket: "missing", region: "us-east-1", endpoint: ENDPOINT, credentials: CREDS }, { fetcher: fake.fetcher, chains: refusingChains(), now: steppingClock() }),
147
+ ).rejects.toBeInstanceOf(BucketCheckError);
148
+ });
149
+
150
+ it("reports a denied read as unreadable and names the owner check", async () => {
151
+ const fake = fakeFetcher(() => xml(403, `<Error><Code>AccessDenied</Code></Error>`));
152
+ const report = await checkBucket(
153
+ { store: "s3", bucket: "b", region: "us-east-1", endpoint: ENDPOINT, credentials: CREDS, expectedOwner: "111122223333" },
154
+ { fetcher: fake.fetcher, chains: refusingChains(), now: steppingClock() },
155
+ );
156
+ expect(report.settings.map((f) => f.verdict)).toEqual(["unreadable", "unreadable", "unreadable"]);
157
+ expect(report.settings[0]!.found).toContain("111122223333");
158
+ expect(fake.calls[0]!.headers["x-amz-expected-bucket-owner"]).toBe("111122223333");
159
+ });
160
+ });
161
+
162
+ describe("GCS on the wire", () => {
163
+ it("reads the bucket resource from the emulator with no token when token is null", async () => {
164
+ const chains = refusingChains();
165
+ const fake = fakeFetcher(() => ({
166
+ status: 200,
167
+ headers: {},
168
+ body: JSON.stringify({
169
+ versioning: { enabled: true },
170
+ lifecycle: { rule: [{ action: { type: "Delete" }, condition: { isLive: false, daysSinceNoncurrentTime: 7 } }] },
171
+ iamConfiguration: { publicAccessPrevention: "enforced", uniformBucketLevelAccess: { enabled: true } },
172
+ }),
173
+ }));
174
+ const report = await checkBucket({ store: "gcs", bucket: "records", endpoint: "http://localhost:4443", token: null }, { fetcher: fake.fetcher, chains });
175
+ expect(chains.count.gcp).toBe(0);
176
+ expect(fake.calls).toHaveLength(1);
177
+ expect(fake.calls[0]!.url).toBe("http://localhost:4443/storage/v1/b/records?projection=noAcl");
178
+ expect(fake.calls[0]!.headers.authorization).toBeUndefined();
179
+ expect(report.correct).toBe(true);
180
+ });
181
+
182
+ it("refuses an endpoint without a token", async () => {
183
+ const chains = refusingChains();
184
+ await expect(checkBucket({ store: "gcs", bucket: "records", endpoint: "http://localhost:4443" }, { fetcher: fakeFetcher(() => undefined).fetcher, chains })).rejects.toBeInstanceOf(ListerConfigError);
185
+ expect(chains.count.gcp).toBe(0);
186
+ });
187
+ });
188
+
189
+ describe("Azure on the wire", () => {
190
+ it("reads four ARM documents from the emulator with the given token", async () => {
191
+ const chains = refusingChains();
192
+ const fake = fakeFetcher((call) => {
193
+ const path = new URL(call.url).pathname;
194
+ if (path.endsWith("/managementPolicies/default")) return { status: 404, headers: {}, body: JSON.stringify({ error: { code: "ManagementPolicyNotFound" } }) };
195
+ if (path.endsWith("/containers/tfstate")) return { status: 200, headers: {}, body: JSON.stringify({ properties: { publicAccess: "None" } }) };
196
+ if (path.endsWith("/blobServices/default")) return { status: 200, headers: {}, body: JSON.stringify({ properties: { isVersioningEnabled: true } }) };
197
+ if (path.endsWith("/storageAccounts/stateprod")) return { status: 200, headers: {}, body: JSON.stringify({ properties: { allowBlobPublicAccess: false } }) };
198
+ return undefined;
199
+ });
200
+ const report = await checkBucket(
201
+ { store: "azblob", subscriptionId: "00000000-0000-0000-0000-000000000000", resourceGroup: "state-rg", account: "stateprod", container: "tfstate", endpoint: "http://localhost:4580", token: "fake" },
202
+ { fetcher: fake.fetcher, chains, namespaces: ["records/prod"] },
203
+ );
204
+ expect(chains.count.azure).toBe(0);
205
+ expect(fake.calls.every((c) => c.method === "GET" && c.url.startsWith("http://localhost:4580/subscriptions/") && c.headers.authorization === "Bearer fake")).toBe(true);
206
+ expect(report.bucket).toBe("stateprod/tfstate");
207
+ expect(report.settings.map((f) => f.verdict)).toEqual(["ok", "fail", "ok"]);
208
+ expect(report.settings[1]!.fix).toContain('"prefixMatch":["tfstate/records/prod/"]');
209
+ });
210
+ });