@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,433 @@
1
+ /**
2
+ * chant#4558: the S3 bucket check. Three reads (GetBucketVersioning,
3
+ * GetBucketLifecycleConfiguration, GetPublicAccessBlock), signed with the
4
+ * cloud lister's SigV4 (packages/core/src/cloud-lister/sigv4.ts), then
5
+ * {@link evaluateS3}, which is a port of choudoufu's
6
+ * pkg/staterecord/bucketcontract.go (CheckBucketContract) so init passes
7
+ * exactly the buckets plunge and choudoufu open.
8
+ *
9
+ * With an `endpoint`, the target must carry static credentials and every
10
+ * call is pinned to that endpoint; the default provider chain is never used
11
+ * against it (cloud-lister/credentials.ts resolveAwsCredentials).
12
+ */
13
+
14
+ import { createHash } from "node:crypto";
15
+ import { resolveAwsCredentials, sdkCredentialChains, type AwsStaticCredentials, type CredentialChains } from "../cloud-lister/credentials";
16
+ import { signV4 } from "../cloud-lister/sigv4";
17
+ import type { TlsOptions, WireResponse } from "../cloud-lister/transport";
18
+ import { isReadError, type BucketFinding, type BucketReport, type ReadError } from "./types";
19
+ import { BucketCheckError, namespacePrefix, sendGet, type WireOptions } from "./wire";
20
+
21
+ export interface S3BucketTarget {
22
+ store: "s3";
23
+ bucket: string;
24
+ region: string;
25
+ /** An emulator's S3 base, e.g. `http://localhost:4566`. Requires `credentials`. */
26
+ endpoint?: string;
27
+ credentials?: AwsStaticCredentials;
28
+ /** Twelve-digit account that must own the bucket, sent as x-amz-expected-bucket-owner. */
29
+ expectedOwner?: string;
30
+ tls?: TlsOptions;
31
+ }
32
+
33
+ // ---------------------------------------------------------------------------
34
+ // The fixture shape: the S3 API's own field names, as aws-sdk-go-v2's output
35
+ // types and the REST XML documents spell them.
36
+
37
+ export interface S3LifecycleRule {
38
+ ID?: string;
39
+ Status?: string;
40
+ Prefix?: string;
41
+ Filter?: {
42
+ Prefix?: string;
43
+ Tag?: { Key?: string; Value?: string };
44
+ ObjectSizeGreaterThan?: number;
45
+ ObjectSizeLessThan?: number;
46
+ And?: { Prefix?: string; Tags?: Array<{ Key?: string; Value?: string }>; ObjectSizeGreaterThan?: number; ObjectSizeLessThan?: number };
47
+ };
48
+ Expiration?: { Days?: number; Date?: string; ExpiredObjectDeleteMarker?: boolean };
49
+ NoncurrentVersionExpiration?: { NoncurrentDays?: number; NewerNoncurrentVersions?: number };
50
+ }
51
+
52
+ export interface S3PublicAccessBlockConfiguration {
53
+ BlockPublicAcls?: boolean;
54
+ IgnorePublicAcls?: boolean;
55
+ BlockPublicPolicy?: boolean;
56
+ RestrictPublicBuckets?: boolean;
57
+ }
58
+
59
+ export interface S3Input {
60
+ versioning: { Status?: string } | ReadError;
61
+ lifecycle: { Rules?: S3LifecycleRule[] } | ReadError;
62
+ publicAccessBlock: { PublicAccessBlockConfiguration?: S3PublicAccessBlockConfiguration } | ReadError;
63
+ }
64
+
65
+ // ---------------------------------------------------------------------------
66
+ // Evaluation.
67
+
68
+ export interface S3EvaluateOptions {
69
+ bucket: string;
70
+ namespaces?: readonly string[];
71
+ expectedOwner?: string;
72
+ /** Days a noncurrent version is kept in the suggested lifecycle rule; the recovery window. Default 30. */
73
+ recoveryDays?: number;
74
+ }
75
+
76
+ function denied(e: ReadError): boolean {
77
+ return e.error.status === 403 || e.error.code === "AccessDenied" || e.error.code === "AllAccessDisabled";
78
+ }
79
+
80
+ function readFailure(setting: BucketFinding["setting"], permission: string, e: ReadError, expectedOwner: string | undefined): BucketFinding {
81
+ if (!denied(e)) {
82
+ throw new BucketCheckError(`s3: reading the bucket's ${setting} setting failed: ${e.error.code ?? `HTTP ${e.error.status ?? "?"}`}`);
83
+ }
84
+ let found = `${permission} was denied`;
85
+ if (expectedOwner) found += `, which is also what S3 answers when the bucket is owned by an account other than ${expectedOwner}`;
86
+ return { setting, verdict: "unreadable", found, unwaivable: false, fix: `Grant the identity ${permission} on the bucket, or have someone who holds it confirm the setting.` };
87
+ }
88
+
89
+ const ruleId = (r: S3LifecycleRule): string => (r.ID ? r.ID : "(unnamed rule)");
90
+
91
+ function rulePrefix(r: S3LifecycleRule): string {
92
+ let prefix = r.Prefix ?? "";
93
+ if (r.Filter) {
94
+ if (r.Filter.And?.Prefix) prefix = r.Filter.And.Prefix;
95
+ if (r.Filter.Prefix) prefix = r.Filter.Prefix;
96
+ }
97
+ return prefix;
98
+ }
99
+
100
+ function filteredBeyondPrefix(r: S3LifecycleRule): string {
101
+ const why = "is filtered by tag or object size, which this check does not rely on";
102
+ const f = r.Filter;
103
+ if (!f) return "";
104
+ if (f.Tag !== undefined || f.ObjectSizeGreaterThan !== undefined || f.ObjectSizeLessThan !== undefined) return why;
105
+ if (f.And && ((f.And.Tags?.length ?? 0) > 0 || f.And.ObjectSizeGreaterThan !== undefined || f.And.ObjectSizeLessThan !== undefined)) return why;
106
+ return "";
107
+ }
108
+
109
+ function expiresCurrent(r: S3LifecycleRule): string {
110
+ const e = r.Expiration;
111
+ if (!e) return "";
112
+ if ((e.Days ?? 0) > 0) return `after ${e.Days} day(s)`;
113
+ if (e.Date) {
114
+ const d = new Date(e.Date);
115
+ if (!Number.isNaN(d.getTime()) && d.getTime() > 0) return `on ${d.toISOString().slice(0, 10)}`;
116
+ }
117
+ return "";
118
+ }
119
+
120
+ function mayReach(r: S3LifecycleRule, namespaces: readonly string[]): boolean {
121
+ const prefix = rulePrefix(r);
122
+ if (prefix === "" || namespaces.length === 0) return true;
123
+ return namespaces.some((ns) => {
124
+ const n = namespacePrefix(ns);
125
+ return n.startsWith(prefix) || prefix.startsWith(n);
126
+ });
127
+ }
128
+
129
+ function describeNoncurrent(r: S3LifecycleRule): string {
130
+ const nve = r.NoncurrentVersionExpiration ?? {};
131
+ let d = `rule "${ruleId(r)}" expires noncurrent versions after ${nve.NoncurrentDays ?? 0} day(s)`;
132
+ if ((nve.NewerNoncurrentVersions ?? 0) > 0) d += `, keeping the newest ${nve.NewerNoncurrentVersions} whatever their age`;
133
+ return d;
134
+ }
135
+
136
+ /** The lifecycle configuration the fix suggests: one noncurrent-expiry rule per namespace, or one with no filter. */
137
+ export function s3LifecycleFix(bucket: string, namespaces: readonly string[], recoveryDays: number): string {
138
+ const rules = (namespaces.length === 0 ? [""] : namespaces).map((ns, i) => ({
139
+ ID: namespaces.length <= 1 ? "expire-noncurrent" : `expire-noncurrent-${i + 1}`,
140
+ Status: "Enabled",
141
+ Filter: ns === "" ? {} : { Prefix: namespacePrefix(ns) },
142
+ NoncurrentVersionExpiration: { NoncurrentDays: recoveryDays },
143
+ }));
144
+ return (
145
+ `aws s3api put-bucket-lifecycle-configuration --bucket ${bucket} --lifecycle-configuration '${JSON.stringify({ Rules: rules })}' ` +
146
+ `(this replaces the bucket's lifecycle configuration, so add these rules to any it already has; ${recoveryDays} days is how long a deleted or overwritten record stays recoverable)`
147
+ );
148
+ }
149
+
150
+ export function evaluateS3(input: S3Input, options: S3EvaluateOptions): BucketFinding[] {
151
+ const { bucket, expectedOwner } = options;
152
+ const namespaces = options.namespaces ?? [];
153
+ const recoveryDays = options.recoveryDays ?? 30;
154
+ return [versioning(input, bucket, expectedOwner), lifecycle(input, bucket, namespaces, expectedOwner, recoveryDays), publicAccessBlock(input, bucket, expectedOwner)];
155
+ }
156
+
157
+ function versioning(input: S3Input, bucket: string, expectedOwner: string | undefined): BucketFinding {
158
+ const v = input.versioning;
159
+ if (isReadError(v)) return readFailure("versioning", "s3:GetBucketVersioning", v, expectedOwner);
160
+ if (v.Status === "Enabled") return { setting: "versioning", verdict: "ok", found: "versioning is Enabled", unwaivable: false };
161
+ return {
162
+ setting: "versioning",
163
+ verdict: "fail",
164
+ found: v.Status === "Suspended" ? "versioning is Suspended" : "versioning has never been enabled",
165
+ unwaivable: false,
166
+ fix: `aws s3api put-bucket-versioning --bucket ${bucket} --versioning-configuration Status=Enabled`,
167
+ };
168
+ }
169
+
170
+ function lifecycle(input: S3Input, bucket: string, namespaces: readonly string[], expectedOwner: string | undefined, recoveryDays: number): BucketFinding {
171
+ const fail = (found: string): BucketFinding => ({ setting: "lifecycle", verdict: "fail", found, unwaivable: false, fix: s3LifecycleFix(bucket, namespaces, recoveryDays) });
172
+ const l = input.lifecycle;
173
+ if (isReadError(l)) {
174
+ if (l.error.code === "NoSuchLifecycleConfiguration") return fail("the bucket has no lifecycle configuration");
175
+ return readFailure("lifecycle", "s3:GetLifecycleConfiguration", l, expectedOwner);
176
+ }
177
+ const rules = l.Rules ?? [];
178
+
179
+ const deleting: string[] = [];
180
+ for (const r of rules) {
181
+ if (r.Status !== "Enabled") continue;
182
+ const when = expiresCurrent(r);
183
+ if (when === "" || !mayReach(r, namespaces)) continue;
184
+ deleting.push(`rule "${ruleId(r)}" expires current objects ${when}, and a record is a current object`);
185
+ }
186
+ if (deleting.length > 0) {
187
+ return {
188
+ setting: "lifecycle",
189
+ verdict: "fail",
190
+ found: deleting.join("; "),
191
+ unwaivable: true,
192
+ fix: "Remove the Expiration action from that rule, or limit the rule to a prefix outside these keys. Only NoncurrentVersionExpiration belongs on a rule that reaches them.",
193
+ };
194
+ }
195
+
196
+ const near: string[] = [];
197
+ const covering: S3LifecycleRule[] = [];
198
+ for (const r of rules) {
199
+ if (!r.NoncurrentVersionExpiration || (r.NoncurrentVersionExpiration.NoncurrentDays ?? 0) <= 0) continue;
200
+ if (r.Status !== "Enabled") {
201
+ near.push(`rule "${ruleId(r)}" expires noncurrent versions but is ${r.Status ?? ""}`);
202
+ continue;
203
+ }
204
+ const why = filteredBeyondPrefix(r);
205
+ if (why !== "") {
206
+ near.push(`rule "${ruleId(r)}" expires noncurrent versions but ${why}`);
207
+ continue;
208
+ }
209
+ covering.push(r);
210
+ }
211
+ const used: string[] = [];
212
+ const uncovered: string[] = [];
213
+ const targets = namespaces.length === 0 ? [""] : namespaces;
214
+ for (const ns of targets) {
215
+ const hit = covering.find((r) => {
216
+ const p = rulePrefix(r);
217
+ return p === "" || (ns !== "" && namespacePrefix(ns).startsWith(p));
218
+ });
219
+ if (hit) {
220
+ const d = describeNoncurrent(hit);
221
+ if (!used.includes(d)) used.push(d);
222
+ } else {
223
+ uncovered.push(ns);
224
+ }
225
+ }
226
+ if (uncovered.length === 0 && covering.length > 0) return { setting: "lifecycle", verdict: "ok", found: used.join("; "), unwaivable: false };
227
+ for (const r of covering) {
228
+ if (namespaces.length === 0) {
229
+ near.push(`rule "${ruleId(r)}" expires noncurrent versions but only under the prefix "${rulePrefix(r)}", and this check was not told which keys the store writes`);
230
+ continue;
231
+ }
232
+ for (const ns of uncovered) {
233
+ near.push(`rule "${ruleId(r)}" expires noncurrent versions but only under the prefix "${rulePrefix(r)}", which does not contain "${namespacePrefix(ns)}"`);
234
+ }
235
+ }
236
+ if (near.length > 0) return fail(near.join("; "));
237
+ if (rules.length === 0) return fail("the lifecycle configuration has no rules");
238
+ return fail(`none of the lifecycle configuration's ${rules.length} rule(s) expires noncurrent versions`);
239
+ }
240
+
241
+ function publicAccessBlock(input: S3Input, bucket: string, expectedOwner: string | undefined): BucketFinding {
242
+ const fix = `aws s3api put-public-access-block --bucket ${bucket} --public-access-block-configuration BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true`;
243
+ const p = input.publicAccessBlock;
244
+ const none: BucketFinding = { setting: "public_access_block", verdict: "fail", found: "the bucket has no public-access block configuration", unwaivable: false, fix };
245
+ if (isReadError(p)) {
246
+ if (p.error.code === "NoSuchPublicAccessBlockConfiguration") return none;
247
+ return readFailure("public_access_block", "s3:GetBucketPublicAccessBlock", p, expectedOwner);
248
+ }
249
+ const cfg = p.PublicAccessBlockConfiguration;
250
+ if (!cfg) return none;
251
+ const off = (["BlockPublicAcls", "IgnorePublicAcls", "BlockPublicPolicy", "RestrictPublicBuckets"] as const).filter((k) => cfg[k] !== true);
252
+ if (off.length > 0) return { setting: "public_access_block", verdict: "fail", found: `public-access block has ${off.join(", ")} off`, unwaivable: false, fix };
253
+ return { setting: "public_access_block", verdict: "ok", found: "all four public-access block settings are on", unwaivable: false };
254
+ }
255
+
256
+ // ---------------------------------------------------------------------------
257
+ // The S3 REST XML documents, read into the fixture shape. Only what the three
258
+ // responses carry: elements and text, no attributes, no namespaces kept.
259
+
260
+ interface XmlNode {
261
+ name: string;
262
+ children: XmlNode[];
263
+ text: string;
264
+ }
265
+
266
+ const ENTITIES: Record<string, string> = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
267
+
268
+ function decode(s: string): string {
269
+ return s.replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, (m, e: string) => {
270
+ if (e[0] === "#") return String.fromCodePoint(e[1] === "x" || e[1] === "X" ? parseInt(e.slice(2), 16) : parseInt(e.slice(1), 10));
271
+ return ENTITIES[e] ?? m;
272
+ });
273
+ }
274
+
275
+ /** A tolerant parser for the small documents S3 returns. Exported for tests. */
276
+ export function parseXml(xml: string): XmlNode {
277
+ const root: XmlNode = { name: "#root", children: [], text: "" };
278
+ const stack: XmlNode[] = [root];
279
+ const re = /<\?[\s\S]*?\?>|<!--[\s\S]*?-->|<(\/?)([A-Za-z_][\w:.-]*)[^>]*?(\/?)>|([^<]+)/g;
280
+ let m: RegExpExecArray | null;
281
+ while ((m = re.exec(xml)) !== null) {
282
+ const top = stack[stack.length - 1]!;
283
+ if (m[4] !== undefined) {
284
+ top.text += decode(m[4]);
285
+ continue;
286
+ }
287
+ if (m[2] === undefined) continue;
288
+ const name = m[2].replace(/^.*:/, "");
289
+ if (m[1] === "/") {
290
+ if (stack.length > 1) stack.pop();
291
+ continue;
292
+ }
293
+ const node: XmlNode = { name, children: [], text: "" };
294
+ top.children.push(node);
295
+ if (m[3] !== "/") stack.push(node);
296
+ }
297
+ return root;
298
+ }
299
+
300
+ const child = (n: XmlNode | undefined, name: string): XmlNode | undefined => n?.children.find((c) => c.name === name);
301
+ const kids = (n: XmlNode | undefined, name: string): XmlNode[] => n?.children.filter((c) => c.name === name) ?? [];
302
+ const text = (n: XmlNode | undefined, name: string): string | undefined => {
303
+ const c = child(n, name);
304
+ return c === undefined ? undefined : c.text.trim();
305
+ };
306
+ const num = (n: XmlNode | undefined, name: string): number | undefined => {
307
+ const t = text(n, name);
308
+ return t === undefined || t === "" ? undefined : Number(t);
309
+ };
310
+ const bool = (n: XmlNode | undefined, name: string): boolean | undefined => {
311
+ const t = text(n, name);
312
+ return t === undefined ? undefined : t.toLowerCase() === "true";
313
+ };
314
+
315
+ function defined<T extends object>(o: T): T {
316
+ for (const k of Object.keys(o) as Array<keyof T>) if (o[k] === undefined) delete o[k];
317
+ return o;
318
+ }
319
+
320
+ export function parseVersioning(xml: string): { Status?: string } {
321
+ const doc = child(parseXml(xml), "VersioningConfiguration");
322
+ return defined({ Status: text(doc, "Status") || undefined });
323
+ }
324
+
325
+ export function parsePublicAccessBlock(xml: string): { PublicAccessBlockConfiguration?: S3PublicAccessBlockConfiguration } {
326
+ const doc = child(parseXml(xml), "PublicAccessBlockConfiguration");
327
+ if (!doc) return {};
328
+ return {
329
+ PublicAccessBlockConfiguration: defined({
330
+ BlockPublicAcls: bool(doc, "BlockPublicAcls"),
331
+ IgnorePublicAcls: bool(doc, "IgnorePublicAcls"),
332
+ BlockPublicPolicy: bool(doc, "BlockPublicPolicy"),
333
+ RestrictPublicBuckets: bool(doc, "RestrictPublicBuckets"),
334
+ }),
335
+ };
336
+ }
337
+
338
+ export function parseLifecycle(xml: string): { Rules: S3LifecycleRule[] } {
339
+ const doc = child(parseXml(xml), "LifecycleConfiguration");
340
+ const rules = kids(doc, "Rule").map((r) => {
341
+ const f = child(r, "Filter");
342
+ const and = child(f, "And");
343
+ const tag = (t: XmlNode) => defined({ Key: text(t, "Key"), Value: text(t, "Value") });
344
+ const e = child(r, "Expiration");
345
+ const nve = child(r, "NoncurrentVersionExpiration");
346
+ return defined<S3LifecycleRule>({
347
+ ID: text(r, "ID"),
348
+ Status: text(r, "Status"),
349
+ Prefix: text(r, "Prefix"),
350
+ Filter: f
351
+ ? defined({
352
+ Prefix: text(f, "Prefix"),
353
+ Tag: child(f, "Tag") ? tag(child(f, "Tag")!) : undefined,
354
+ ObjectSizeGreaterThan: num(f, "ObjectSizeGreaterThan"),
355
+ ObjectSizeLessThan: num(f, "ObjectSizeLessThan"),
356
+ And: and
357
+ ? defined({
358
+ Prefix: text(and, "Prefix"),
359
+ Tags: kids(and, "Tag").length > 0 ? kids(and, "Tag").map(tag) : undefined,
360
+ ObjectSizeGreaterThan: num(and, "ObjectSizeGreaterThan"),
361
+ ObjectSizeLessThan: num(and, "ObjectSizeLessThan"),
362
+ })
363
+ : undefined,
364
+ })
365
+ : undefined,
366
+ Expiration: e ? defined({ Days: num(e, "Days"), Date: text(e, "Date"), ExpiredObjectDeleteMarker: bool(e, "ExpiredObjectDeleteMarker") }) : undefined,
367
+ NoncurrentVersionExpiration: nve ? defined({ NoncurrentDays: num(nve, "NoncurrentDays"), NewerNoncurrentVersions: num(nve, "NewerNoncurrentVersions") }) : undefined,
368
+ });
369
+ });
370
+ return { Rules: rules };
371
+ }
372
+
373
+ /** A non-2xx S3 answer as a {@link ReadError}. */
374
+ export function parseS3Error(res: WireResponse): ReadError {
375
+ const code = text(child(parseXml(res.body), "Error"), "Code");
376
+ return { error: defined({ code, status: res.status }) };
377
+ }
378
+
379
+ // ---------------------------------------------------------------------------
380
+ // Reading a live bucket.
381
+
382
+ export interface S3ReadOptions extends WireOptions {
383
+ chains?: CredentialChains;
384
+ now?: () => Date;
385
+ }
386
+
387
+ const EMPTY_SHA256 = createHash("sha256").update("").digest("hex");
388
+
389
+ export function s3Url(target: S3BucketTarget, subresource: string): string {
390
+ if (target.endpoint !== undefined) {
391
+ return `${target.endpoint.replace(/\/+$/, "")}/${encodeURIComponent(target.bucket)}?${subresource}`;
392
+ }
393
+ // Virtual-hosted unless the name has a dot, which breaks the wildcard certificate.
394
+ if (target.bucket.includes(".")) return `https://s3.${target.region}.amazonaws.com/${encodeURIComponent(target.bucket)}?${subresource}`;
395
+ return `https://${target.bucket}.s3.${target.region}.amazonaws.com/?${subresource}`;
396
+ }
397
+
398
+ export async function readS3(target: S3BucketTarget, options: S3ReadOptions = {}): Promise<S3Input> {
399
+ const credentials = await resolveAwsCredentials(target, options.chains ?? sdkCredentialChains);
400
+ const now = options.now ?? (() => new Date());
401
+ const wire: WireOptions = { ...options, ...(target.tls ? { tls: target.tls } : {}) };
402
+ const get = async (subresource: string): Promise<WireResponse> => {
403
+ const url = s3Url(target, subresource);
404
+ const base: Record<string, string> = { "x-amz-content-sha256": EMPTY_SHA256 };
405
+ if (target.expectedOwner) base["x-amz-expected-bucket-owner"] = target.expectedOwner;
406
+ const headers = signV4({ method: "GET", url, headers: base, body: "", region: target.region, service: "s3", credentials, now: now() });
407
+ const res = await sendGet("aws", url, headers, target.endpoint, wire);
408
+ if (res.status === 404 && parseS3Error(res).error.code === "NoSuchBucket") {
409
+ throw new BucketCheckError(`s3: bucket ${target.bucket} does not exist; the check creates no bucket`);
410
+ }
411
+ return res;
412
+ };
413
+ const ok = (r: WireResponse) => r.status >= 200 && r.status < 300;
414
+ const v = await get("versioning");
415
+ const l = await get("lifecycle");
416
+ const p = await get("publicAccessBlock");
417
+ return {
418
+ versioning: ok(v) ? parseVersioning(v.body) : parseS3Error(v),
419
+ lifecycle: ok(l) ? parseLifecycle(l.body) : parseS3Error(l),
420
+ publicAccessBlock: ok(p) ? parsePublicAccessBlock(p.body) : parseS3Error(p),
421
+ };
422
+ }
423
+
424
+ export async function checkS3Bucket(target: S3BucketTarget, options: S3ReadOptions & { namespaces?: readonly string[]; recoveryDays?: number } = {}): Promise<BucketReport> {
425
+ const input = await readS3(target, options);
426
+ const settings = evaluateS3(input, {
427
+ bucket: target.bucket,
428
+ namespaces: options.namespaces ?? [],
429
+ ...(target.expectedOwner ? { expectedOwner: target.expectedOwner } : {}),
430
+ ...(options.recoveryDays !== undefined ? { recoveryDays: options.recoveryDays } : {}),
431
+ });
432
+ return { store: "s3", bucket: target.bucket, namespaces: [...(options.namespaces ?? [])], correct: settings.every((f) => f.verdict === "ok"), settings };
433
+ }
@@ -0,0 +1,75 @@
1
+ /**
2
+ * chant#4558: the shared bucket check's vocabulary.
3
+ *
4
+ * Setting names are the ones plunge and choudoufu already use in
5
+ * `allow_insecure` (plunge site/src/content/docs/use/setup.md, choudoufu
6
+ * pkg/staterecord/{bucketcontract,gcscontract,azurecontract}.go), so a
7
+ * product can map a waiver it reads onto a finding here by name.
8
+ *
9
+ * Verdicts are choudoufu `live-bucket -json`'s: "ok", "fail", "unreadable".
10
+ * A denied read is never a pass. GCS's `list_isolation`, which only ever
11
+ * warns a run, is not checked here.
12
+ */
13
+
14
+ export type BucketStore = "s3" | "gcs" | "azblob";
15
+
16
+ export type BucketVerdict = "ok" | "fail" | "unreadable";
17
+
18
+ export const BUCKET_SETTINGS = {
19
+ s3: ["versioning", "lifecycle", "public_access_block"],
20
+ gcs: ["object_versioning", "noncurrent_lifecycle", "public_access_prevention", "uniform_bucket_level_access"],
21
+ azblob: ["blob_versioning", "lifecycle_management", "public_access"],
22
+ } as const satisfies Record<BucketStore, readonly string[]>;
23
+
24
+ export type BucketSetting = (typeof BUCKET_SETTINGS)[BucketStore][number];
25
+
26
+ export interface BucketFinding {
27
+ setting: BucketSetting;
28
+ verdict: BucketVerdict;
29
+ /** One clause quoting what the store has: "versioning is Suspended". */
30
+ found: string;
31
+ /**
32
+ * A lifecycle rule that deletes current records. No `allow_insecure`
33
+ * reaches it, in plunge or choudoufu, so a product must not offer one.
34
+ */
35
+ unwaivable: boolean;
36
+ /** The command or change that fixes this setting; absent when it passed. */
37
+ fix?: string;
38
+ }
39
+
40
+ export interface BucketReport {
41
+ store: BucketStore;
42
+ /** The bucket, or `account/container` for azblob. */
43
+ bucket: string;
44
+ /**
45
+ * The key prefixes the lifecycle rule was checked against. Empty means
46
+ * only a rule with no prefix filter is credited, the stricter answer that
47
+ * holds for every estate sharing the bucket.
48
+ */
49
+ namespaces: string[];
50
+ /** Every setting passed. */
51
+ correct: boolean;
52
+ /** One finding per setting, always all of them, in BUCKET_SETTINGS order. */
53
+ settings: BucketFinding[];
54
+ }
55
+
56
+ /** An API read that failed, recorded in the fixture shape: `{ "error": { "code": "AccessDenied", "status": 403 } }`. */
57
+ export interface ReadError {
58
+ error: { code?: string; status?: number };
59
+ }
60
+
61
+ export function isReadError(v: unknown): v is ReadError {
62
+ return typeof v === "object" && v !== null && "error" in v && typeof (v as ReadError).error === "object";
63
+ }
64
+
65
+ /**
66
+ * The findings a run refuses on once `waived` (the product's
67
+ * `allow_insecure` list) is applied: every finding that did not pass and is
68
+ * neither waived nor waivable. An unwaivable finding is refused whatever
69
+ * the list says. Init asks whether the bucket is correct and reads
70
+ * {@link BucketReport.correct}; this is for a product that also honours a
71
+ * waiver the way plunge and choudoufu do on open.
72
+ */
73
+ export function refusedFindings(report: BucketReport, waived: readonly string[]): BucketFinding[] {
74
+ return report.settings.filter((f) => f.verdict !== "ok" && (f.unwaivable || !waived.includes(f.setting)));
75
+ }
@@ -0,0 +1,50 @@
1
+ /**
2
+ * chant#4558: the bucket check's one way onto the network.
3
+ *
4
+ * Every read the check makes is a GET built here, and nothing else is sent.
5
+ * When a target names its own endpoint (an emulator such as floci), every
6
+ * call is pinned to that endpoint's origin, so a URL built wrong cannot reach
7
+ * a public cloud host. The sender is the cloud lister's node http/https
8
+ * fetcher (packages/core/src/cloud-lister/transport.ts); a test passes its
9
+ * own {@link Fetcher} and opens no socket.
10
+ */
11
+
12
+ import { nodeFetcher, type Fetcher, type TlsOptions, type WireResponse } from "../cloud-lister/transport";
13
+ import type { WireCall } from "../cloud-lister/guard";
14
+
15
+ export class BucketCheckError extends Error {
16
+ constructor(message: string) {
17
+ super(message);
18
+ this.name = "BucketCheckError";
19
+ }
20
+ }
21
+
22
+ export interface WireOptions {
23
+ /** Replaces node's http/https; tests answer from a route table. */
24
+ fetcher?: Fetcher;
25
+ tls?: TlsOptions;
26
+ /** Called with each call before it is sent (tests record with it). */
27
+ onSend?: (call: WireCall) => void;
28
+ }
29
+
30
+ /** One GET, refused unless it goes to `pinnedOrigin` when that is set. */
31
+ export async function sendGet(
32
+ substrate: WireCall["substrate"],
33
+ url: string,
34
+ headers: Record<string, string>,
35
+ pinnedOrigin: string | undefined,
36
+ options: WireOptions,
37
+ ): Promise<WireResponse> {
38
+ if (pinnedOrigin !== undefined && new URL(url).origin !== new URL(pinnedOrigin).origin) {
39
+ throw new BucketCheckError(`chant's bucket check refused ${url}: this check is pinned to ${pinnedOrigin}`);
40
+ }
41
+ const call: WireCall = { substrate, method: "GET", url, headers };
42
+ options.onSend?.(call);
43
+ return (options.fetcher ?? nodeFetcher)(call, options.tls);
44
+ }
45
+
46
+ /** `"tofu-records/prod"` as `"tofu-records/prod/"`; `""` stays `""`. Same rule as choudoufu's staterecord.NamespacePrefix. */
47
+ export function namespacePrefix(prefix: string): string {
48
+ if (prefix === "") return "";
49
+ return prefix.replace(/\/+$/, "") + "/";
50
+ }
@@ -0,0 +1,5 @@
1
+ /**
2
+ * chant#4558: `@intentius/chant/bucket-check`, the shared bucket check for
3
+ * terragucci init and plywood init. See ./bucket-check/index.ts.
4
+ */
5
+ export * from "./bucket-check/index";
@@ -9,7 +9,6 @@ import { join } from "node:path";
9
9
  import { describe, expect, it } from "vitest";
10
10
  import type { GraphIR } from "../graph-ir";
11
11
  import { __searchInternals, resolveKindTerms } from "../cli/handlers/search";
12
- import { NEXT_RELEASE } from "../release-floors";
13
12
  import {
14
13
  CAPABILITY_TEMPLATES_FLOOR,
15
14
  TemplateCatalogError,
@@ -206,7 +205,7 @@ describe("the export", () => {
206
205
  expect(parseTemplates(onDisk)).toEqual(investigationTemplates());
207
206
  });
208
207
 
209
- it("carries its floor at the next release", () => {
210
- expect(CAPABILITY_TEMPLATES_FLOOR).toBe(NEXT_RELEASE);
208
+ it("carries its floor at 0.124.54, where it shipped", () => {
209
+ expect(CAPABILITY_TEMPLATES_FLOOR).toBe("0.124.54");
211
210
  });
212
211
  });
@@ -22,11 +22,10 @@
22
22
  * as query parameters, never spliced into the text: the resource's key is
23
23
  * `$key` and every other input is `$<name>`.
24
24
  */
25
- import { NEXT_RELEASE } from "../release-floors";
26
25
  import data from "./templates.json" with { type: "json" };
27
26
 
28
27
  /** The first chant whose capabilities document carries `templates` (#4531). */
29
- export const CAPABILITY_TEMPLATES_FLOOR = NEXT_RELEASE;
28
+ export const CAPABILITY_TEMPLATES_FLOOR = "0.124.54";
30
29
 
31
30
  /** The version of templates.json's shape. */
32
31
  export const TEMPLATES_DATA_VERSION = 1;
@@ -117,7 +117,7 @@ describe("carve advise --from <cdk.out>", () => {
117
117
  const text = formatCarveReport(r);
118
118
  expect(text).toContain("CDK cloud-assembly carve-out advisory");
119
119
  expect(text).toContain("Advises only");
120
- expect(text).toContain("LEAVE IN CDK");
120
+ expect(text).toContain("STAYS IN CDK");
121
121
  expect(text).not.toMatch(/cdk deploy|cdk destroy|terraform state rm/i);
122
122
  });
123
123
 
@@ -57,7 +57,6 @@ describe("the change-set bundle", () => {
57
57
  "packages/core/src/lifecycle/plan-digest.ts",
58
58
  "packages/core/src/plan-summary.ts",
59
59
  // The next-release floor constant (#4480): no imports.
60
- "packages/core/src/release-floors.ts",
61
60
  ]);
62
61
  const bytes = result.outputFiles.reduce((n, f) => n + f.contents.byteLength, 0);
63
62
  expect(bytes).toBeLessThan(BUDGET_BYTES);
package/src/change-set.ts CHANGED
@@ -45,7 +45,6 @@
45
45
  import { computePlanDigest } from "./lifecycle/plan-digest";
46
46
  import type { ChangeSet as LifecycleChangeSet, ChangeSetEntry as LifecycleEntry } from "./lifecycle/change-set";
47
47
  import type { ChangeSet as ReconcileChangeSet } from "./reconcile";
48
- import { NEXT_RELEASE } from "./release-floors";
49
48
 
50
49
  /** The schema a change-set document names in `$schema`. */
51
50
  export const CHANGE_SET_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/change-set/v1/change-set.schema.json";
@@ -54,10 +53,10 @@ export const CHANGE_SET_SCHEMA_ID = "https://intentius.io/chant/schemas/workspac
54
53
  export const CHANGE_SET_CONTRACT = 1;
55
54
 
56
55
  /** The first chant whose change set can carry a member's `group` (ws-107, #4440). */
57
- export const CHANGE_SET_GROUP_FLOOR = NEXT_RELEASE;
56
+ export const CHANGE_SET_GROUP_FLOOR = "0.124.54";
58
57
 
59
58
  /** The first chant whose change set can carry a member's `placeholders` (#4463). */
60
- export const CHANGE_SET_PLACEHOLDERS_FLOOR = NEXT_RELEASE;
59
+ export const CHANGE_SET_PLACEHOLDERS_FLOOR = "0.124.54";
61
60
 
62
61
  /** What a planner proposes for one resource. `no-op`, `read` and `forget` appear only when the planner reports them. */
63
62
  export type ChangeSetAction = "create" | "update" | "replace" | "delete" | "read" | "no-op" | "forget";