@intentius/chant 0.124.54 → 0.124.56

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 (1077) 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 +832 -0
  71. package/dist/ci-audit/attribution.d.ts +111 -0
  72. package/dist/ci-audit/attribution.d.ts.map +1 -0
  73. package/dist/ci-audit/attribution.js +194 -0
  74. package/dist/ci-audit/audit-log.d.ts +144 -0
  75. package/dist/ci-audit/audit-log.d.ts.map +1 -0
  76. package/dist/ci-audit/audit-log.js +149 -0
  77. package/dist/ci-audit/index.d.ts +12 -0
  78. package/dist/ci-audit/index.d.ts.map +1 -0
  79. package/dist/ci-audit/index.js +12 -0
  80. package/dist/ci-audit/unrecorded.d.ts +74 -0
  81. package/dist/ci-audit/unrecorded.d.ts.map +1 -0
  82. package/dist/ci-audit/unrecorded.js +95 -0
  83. package/dist/ci-audit.d.ts +3 -0
  84. package/dist/ci-audit.d.ts.map +1 -0
  85. package/dist/ci-audit.js +2 -0
  86. package/dist/ci-control.d.ts +42 -0
  87. package/dist/ci-control.d.ts.map +1 -0
  88. package/dist/ci-control.js +41 -0
  89. package/dist/ci-estate/delivery.d.ts +137 -0
  90. package/dist/ci-estate/delivery.d.ts.map +1 -0
  91. package/dist/ci-estate/delivery.js +311 -0
  92. package/dist/ci-estate/overdue.d.ts +34 -0
  93. package/dist/ci-estate/overdue.d.ts.map +1 -0
  94. package/dist/ci-estate/overdue.js +58 -0
  95. package/dist/ci-estate/page.d.ts +134 -0
  96. package/dist/ci-estate/page.d.ts.map +1 -0
  97. package/dist/ci-estate/page.js +233 -0
  98. package/dist/ci-estate/rows.d.ts +118 -0
  99. package/dist/ci-estate/rows.d.ts.map +1 -0
  100. package/dist/ci-estate/rows.js +126 -0
  101. package/dist/ci-estate.d.ts +92 -0
  102. package/dist/ci-estate.d.ts.map +1 -0
  103. package/dist/ci-estate.js +82 -0
  104. package/dist/ci-handover.d.ts +29 -5
  105. package/dist/ci-handover.d.ts.map +1 -1
  106. package/dist/ci-handover.js +50 -16
  107. package/dist/ci-identity.d.ts +82 -7
  108. package/dist/ci-identity.d.ts.map +1 -1
  109. package/dist/ci-identity.js +86 -15
  110. package/dist/ci-job-guard.d.ts +139 -0
  111. package/dist/ci-job-guard.d.ts.map +1 -0
  112. package/dist/ci-job-guard.js +287 -0
  113. package/dist/ci-jobs.d.ts +7 -0
  114. package/dist/ci-jobs.d.ts.map +1 -1
  115. package/dist/ci-jobs.js +7 -0
  116. package/dist/ci-product-words.d.ts +296 -0
  117. package/dist/ci-product-words.d.ts.map +1 -0
  118. package/dist/ci-product-words.js +407 -0
  119. package/dist/ci-product.d.ts +117 -0
  120. package/dist/ci-product.d.ts.map +1 -0
  121. package/dist/ci-product.js +113 -0
  122. package/dist/ci-respond-run.d.ts +73 -0
  123. package/dist/ci-respond-run.d.ts.map +1 -0
  124. package/dist/ci-respond-run.js +247 -0
  125. package/dist/ci-respond.d.ts +189 -0
  126. package/dist/ci-respond.d.ts.map +1 -0
  127. package/dist/ci-respond.js +285 -0
  128. package/dist/cli/commands/audit.d.ts +2 -2
  129. package/dist/cli/commands/audit.d.ts.map +1 -1
  130. package/dist/cli/commands/audit.js +3 -2
  131. package/dist/cli/commands/carve.js +2 -2
  132. package/dist/cli/commands/init.d.ts +2 -0
  133. package/dist/cli/commands/init.d.ts.map +1 -1
  134. package/dist/cli/commands/init.js +1 -1
  135. package/dist/cli/handlers/agent.d.ts +17 -0
  136. package/dist/cli/handlers/agent.d.ts.map +1 -0
  137. package/dist/cli/handlers/agent.js +114 -0
  138. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  139. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  140. package/dist/cli/handlers/approve-confirm.js +142 -0
  141. package/dist/cli/handlers/approve.d.ts.map +1 -1
  142. package/dist/cli/handlers/approve.js +19 -1
  143. package/dist/cli/handlers/audit-log.d.ts +12 -0
  144. package/dist/cli/handlers/audit-log.d.ts.map +1 -0
  145. package/dist/cli/handlers/audit-log.js +81 -0
  146. package/dist/cli/handlers/build.d.ts +7 -0
  147. package/dist/cli/handlers/build.d.ts.map +1 -1
  148. package/dist/cli/handlers/build.js +124 -1
  149. package/dist/cli/handlers/ci-check-job.d.ts +11 -0
  150. package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
  151. package/dist/cli/handlers/ci-check-job.js +27 -0
  152. package/dist/cli/handlers/ci-check.d.ts +3 -0
  153. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  154. package/dist/cli/handlers/ci-check.js +63 -0
  155. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  156. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  157. package/dist/cli/handlers/ci-forge-check.js +89 -0
  158. package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
  159. package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
  160. package/dist/cli/handlers/e2e-safe-run.js +23 -0
  161. package/dist/cli/handlers/fan-out.js +4 -0
  162. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  163. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  164. package/dist/cli/handlers/gate-pending.js +44 -0
  165. package/dist/cli/handlers/init.d.ts.map +1 -1
  166. package/dist/cli/handlers/init.js +1 -0
  167. package/dist/cli/handlers/ledger.js +1 -1
  168. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  169. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  170. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  171. package/dist/cli/handlers/lock.d.ts.map +1 -1
  172. package/dist/cli/handlers/lock.js +64 -5
  173. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  174. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  175. package/dist/cli/handlers/notify-relay.js +130 -0
  176. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  177. package/dist/cli/handlers/pr-env.js +42 -11
  178. package/dist/cli/handlers/pr.d.ts +43 -3
  179. package/dist/cli/handlers/pr.d.ts.map +1 -1
  180. package/dist/cli/handlers/pr.js +908 -205
  181. package/dist/cli/handlers/promote.d.ts.map +1 -1
  182. package/dist/cli/handlers/promote.js +21 -2
  183. package/dist/cli/handlers/release.d.ts.map +1 -1
  184. package/dist/cli/handlers/release.js +3 -0
  185. package/dist/cli/handlers/run-wave.d.ts +8 -0
  186. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  187. package/dist/cli/handlers/run-wave.js +160 -2
  188. package/dist/cli/handlers/run.d.ts +6 -1
  189. package/dist/cli/handlers/run.d.ts.map +1 -1
  190. package/dist/cli/handlers/run.js +86 -1
  191. package/dist/cli/handlers/serve.d.ts.map +1 -1
  192. package/dist/cli/handlers/serve.js +10 -1
  193. package/dist/cli/main.d.ts +11 -1
  194. package/dist/cli/main.d.ts.map +1 -1
  195. package/dist/cli/main.js +178 -13
  196. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  197. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  198. package/dist/cli/mcp/ledger-tools.js +122 -0
  199. package/dist/cli/mcp/product-tools.d.ts +78 -0
  200. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  201. package/dist/cli/mcp/product-tools.js +93 -0
  202. package/dist/cli/mcp/read-only.d.ts +34 -0
  203. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  204. package/dist/cli/mcp/read-only.js +61 -0
  205. package/dist/cli/mcp/report-tools.d.ts +48 -0
  206. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  207. package/dist/cli/mcp/report-tools.js +128 -0
  208. package/dist/cli/mcp/server.d.ts +28 -1
  209. package/dist/cli/mcp/server.d.ts.map +1 -1
  210. package/dist/cli/mcp/server.js +86 -15
  211. package/dist/cli/mcp-config.d.ts +9 -2
  212. package/dist/cli/mcp-config.d.ts.map +1 -1
  213. package/dist/cli/mcp-config.js +8 -3
  214. package/dist/cli/parse-args.d.ts.map +1 -1
  215. package/dist/cli/parse-args.js +164 -3
  216. package/dist/cli/registry.d.ts +73 -0
  217. package/dist/cli/registry.d.ts.map +1 -1
  218. package/dist/cloud-lister/sigv4.d.ts +42 -7
  219. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  220. package/dist/cloud-lister/sigv4.js +72 -22
  221. package/dist/components/adoption.d.ts +69 -0
  222. package/dist/components/adoption.d.ts.map +1 -0
  223. package/dist/components/adoption.js +92 -0
  224. package/dist/components/apply-lease.d.ts +19 -0
  225. package/dist/components/apply-lease.d.ts.map +1 -0
  226. package/dist/components/apply-lease.js +41 -0
  227. package/dist/components/capability.d.ts +159 -5
  228. package/dist/components/capability.d.ts.map +1 -1
  229. package/dist/components/capability.js +39 -6
  230. package/dist/components/check-hooks.d.ts +116 -0
  231. package/dist/components/check-hooks.d.ts.map +1 -0
  232. package/dist/components/check-hooks.js +192 -0
  233. package/dist/components/check-steps.d.ts +74 -0
  234. package/dist/components/check-steps.d.ts.map +1 -0
  235. package/dist/components/check-steps.js +102 -0
  236. package/dist/components/ci-services.d.ts +57 -0
  237. package/dist/components/ci-services.d.ts.map +1 -0
  238. package/dist/components/ci-services.js +60 -0
  239. package/dist/components/cli-support.d.ts +13 -0
  240. package/dist/components/cli-support.d.ts.map +1 -1
  241. package/dist/components/cli-support.js +10 -2
  242. package/dist/components/driver.d.ts +32 -3
  243. package/dist/components/driver.d.ts.map +1 -1
  244. package/dist/components/driver.js +59 -5
  245. package/dist/components/fan-out-run.d.ts +12 -0
  246. package/dist/components/fan-out-run.d.ts.map +1 -1
  247. package/dist/components/fan-out-run.js +56 -16
  248. package/dist/components/groups.d.ts.map +1 -1
  249. package/dist/components/groups.js +23 -5
  250. package/dist/components/pr-env-ledger.d.ts +32 -0
  251. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  252. package/dist/components/pr-env-ledger.js +38 -0
  253. package/dist/components/pr-env-ports.d.ts +12 -0
  254. package/dist/components/pr-env-ports.d.ts.map +1 -1
  255. package/dist/components/pr-env-ports.js +13 -3
  256. package/dist/components/pr-env-run.d.ts +6 -0
  257. package/dist/components/pr-env-run.d.ts.map +1 -1
  258. package/dist/components/pr-env-run.js +3 -2
  259. package/dist/components/pr-environment.d.ts +32 -4
  260. package/dist/components/pr-environment.d.ts.map +1 -1
  261. package/dist/components/pr-environment.js +26 -8
  262. package/dist/components/pr-pipeline.d.ts +297 -5
  263. package/dist/components/pr-pipeline.d.ts.map +1 -1
  264. package/dist/components/pr-pipeline.js +329 -18
  265. package/dist/components/pr-policy.d.ts +26 -2
  266. package/dist/components/pr-policy.d.ts.map +1 -1
  267. package/dist/components/pr-policy.js +41 -7
  268. package/dist/components/pr-run.d.ts +71 -0
  269. package/dist/components/pr-run.d.ts.map +1 -1
  270. package/dist/components/pr-run.js +91 -7
  271. package/dist/components/pr-targets.d.ts +24 -0
  272. package/dist/components/pr-targets.d.ts.map +1 -0
  273. package/dist/components/pr-targets.js +48 -0
  274. package/dist/components/product-pipeline.d.ts +250 -0
  275. package/dist/components/product-pipeline.d.ts.map +1 -0
  276. package/dist/components/product-pipeline.js +212 -0
  277. package/dist/components/promote.d.ts +6 -0
  278. package/dist/components/promote.d.ts.map +1 -1
  279. package/dist/components/promote.js +4 -1
  280. package/dist/components/release-compile.d.ts +22 -1
  281. package/dist/components/release-compile.d.ts.map +1 -1
  282. package/dist/components/release-compile.js +85 -0
  283. package/dist/components/release-promote.d.ts +15 -1
  284. package/dist/components/release-promote.d.ts.map +1 -1
  285. package/dist/components/release-promote.js +67 -2
  286. package/dist/components/repo-lock.d.ts +27 -0
  287. package/dist/components/repo-lock.d.ts.map +1 -0
  288. package/dist/components/repo-lock.js +49 -0
  289. package/dist/components/row-lease.d.ts +84 -0
  290. package/dist/components/row-lease.d.ts.map +1 -0
  291. package/dist/components/row-lease.js +110 -0
  292. package/dist/components/wave-plan.d.ts +42 -0
  293. package/dist/components/wave-plan.d.ts.map +1 -1
  294. package/dist/components/wave-plan.js +72 -4
  295. package/dist/control/applied.d.ts +89 -0
  296. package/dist/control/applied.d.ts.map +1 -0
  297. package/dist/control/applied.js +175 -0
  298. package/dist/control/consumers.d.ts +78 -0
  299. package/dist/control/consumers.d.ts.map +1 -0
  300. package/dist/control/consumers.js +172 -0
  301. package/dist/control/dispatch.d.ts +334 -0
  302. package/dist/control/dispatch.d.ts.map +1 -0
  303. package/dist/control/dispatch.js +519 -0
  304. package/dist/control/edges.d.ts +75 -0
  305. package/dist/control/edges.d.ts.map +1 -0
  306. package/dist/control/edges.js +133 -0
  307. package/dist/control/reconcile.d.ts +120 -0
  308. package/dist/control/reconcile.d.ts.map +1 -0
  309. package/dist/control/reconcile.js +178 -0
  310. package/dist/control/records.d.ts +187 -0
  311. package/dist/control/records.d.ts.map +1 -0
  312. package/dist/control/records.js +307 -0
  313. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  314. package/dist/discovery/sandbox/bundle.js +25 -1
  315. package/dist/e2e-harness/bucket.d.ts +21 -0
  316. package/dist/e2e-harness/bucket.d.ts.map +1 -0
  317. package/dist/e2e-harness/bucket.js +61 -0
  318. package/dist/e2e-harness/claim.d.ts +70 -0
  319. package/dist/e2e-harness/claim.d.ts.map +1 -0
  320. package/dist/e2e-harness/claim.js +98 -0
  321. package/dist/e2e-harness/driver.d.ts +64 -0
  322. package/dist/e2e-harness/driver.d.ts.map +1 -0
  323. package/dist/e2e-harness/driver.js +243 -0
  324. package/dist/e2e-harness/forgejo.d.ts +77 -0
  325. package/dist/e2e-harness/forgejo.d.ts.map +1 -0
  326. package/dist/e2e-harness/forgejo.js +205 -0
  327. package/dist/e2e-harness/git.d.ts +32 -0
  328. package/dist/e2e-harness/git.d.ts.map +1 -0
  329. package/dist/e2e-harness/git.js +67 -0
  330. package/dist/e2e-harness/index.d.ts +22 -0
  331. package/dist/e2e-harness/index.d.ts.map +1 -0
  332. package/dist/e2e-harness/index.js +48 -0
  333. package/dist/e2e-harness/jobs.d.ts +8 -0
  334. package/dist/e2e-harness/jobs.d.ts.map +1 -0
  335. package/dist/e2e-harness/jobs.js +34 -0
  336. package/dist/e2e-harness/pins.d.ts +45 -0
  337. package/dist/e2e-harness/pins.d.ts.map +1 -0
  338. package/dist/e2e-harness/pins.js +44 -0
  339. package/dist/e2e-harness/ports.d.ts +113 -0
  340. package/dist/e2e-harness/ports.d.ts.map +1 -0
  341. package/dist/e2e-harness/ports.js +4 -0
  342. package/dist/e2e-harness/reports.d.ts +45 -0
  343. package/dist/e2e-harness/reports.d.ts.map +1 -0
  344. package/dist/e2e-harness/reports.js +57 -0
  345. package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
  346. package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
  347. package/dist/e2e-harness/safe-run-cli.js +43 -0
  348. package/dist/e2e-harness/safe-run.d.ts +61 -0
  349. package/dist/e2e-harness/safe-run.d.ts.map +1 -0
  350. package/dist/e2e-harness/safe-run.js +172 -0
  351. package/dist/e2e-harness/scenario.d.ts +11 -0
  352. package/dist/e2e-harness/scenario.d.ts.map +1 -0
  353. package/dist/e2e-harness/scenario.js +89 -0
  354. package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  355. package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
  356. package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  357. package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  358. package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  359. package/dist/e2e-harness/schemas/index.d.ts +191 -0
  360. package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
  361. package/dist/e2e-harness/schemas/index.js +62 -0
  362. package/dist/e2e-harness/stack.d.ts +124 -0
  363. package/dist/e2e-harness/stack.d.ts.map +1 -0
  364. package/dist/e2e-harness/stack.js +207 -0
  365. package/dist/e2e-harness/steps.d.ts +11 -0
  366. package/dist/e2e-harness/steps.d.ts.map +1 -0
  367. package/dist/e2e-harness/steps.js +22 -0
  368. package/dist/e2e-harness.d.ts +3 -0
  369. package/dist/e2e-harness.d.ts.map +1 -0
  370. package/dist/e2e-harness.js +2 -0
  371. package/dist/engine-facts.d.ts.map +1 -1
  372. package/dist/engine-facts.js +1 -2
  373. package/dist/exit-codes.d.ts +54 -0
  374. package/dist/exit-codes.d.ts.map +1 -0
  375. package/dist/exit-codes.js +55 -0
  376. package/dist/forge-check/check.d.ts +63 -0
  377. package/dist/forge-check/check.d.ts.map +1 -0
  378. package/dist/forge-check/check.js +139 -0
  379. package/dist/forge-check/contract.d.ts +152 -0
  380. package/dist/forge-check/contract.d.ts.map +1 -0
  381. package/dist/forge-check/contract.js +118 -0
  382. package/dist/forge-check/forge.d.ts +42 -0
  383. package/dist/forge-check/forge.d.ts.map +1 -0
  384. package/dist/forge-check/forge.js +338 -0
  385. package/dist/forge-check/index.d.ts +24 -0
  386. package/dist/forge-check/index.d.ts.map +1 -0
  387. package/dist/forge-check/index.js +23 -0
  388. package/dist/forge-check/pulumi.d.ts +44 -0
  389. package/dist/forge-check/pulumi.d.ts.map +1 -0
  390. package/dist/forge-check/pulumi.js +184 -0
  391. package/dist/forge-check/read-only.d.ts +26 -0
  392. package/dist/forge-check/read-only.d.ts.map +1 -0
  393. package/dist/forge-check/read-only.js +53 -0
  394. package/dist/forge-check/trust.d.ts +94 -0
  395. package/dist/forge-check/trust.d.ts.map +1 -0
  396. package/dist/forge-check/trust.js +532 -0
  397. package/dist/forge-check/types.d.ts +80 -0
  398. package/dist/forge-check/types.d.ts.map +1 -0
  399. package/dist/forge-check/types.js +18 -0
  400. package/dist/forge-check.d.ts +6 -0
  401. package/dist/forge-check.d.ts.map +1 -0
  402. package/dist/forge-check.js +5 -0
  403. package/dist/gate-decision.d.ts +1 -0
  404. package/dist/gate-decision.d.ts.map +1 -1
  405. package/dist/gate-decision.js +2 -0
  406. package/dist/gate-policy.d.ts +47 -1
  407. package/dist/gate-policy.d.ts.map +1 -1
  408. package/dist/gate-policy.js +50 -2
  409. package/dist/index.d.ts +1 -0
  410. package/dist/index.d.ts.map +1 -1
  411. package/dist/index.js +2 -0
  412. package/dist/lexicon.d.ts +152 -6
  413. package/dist/lexicon.d.ts.map +1 -1
  414. package/dist/lifecycle/adoption-file.d.ts +24 -0
  415. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  416. package/dist/lifecycle/adoption-file.js +1 -2
  417. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  418. package/dist/lifecycle/cloud-index.js +1 -2
  419. package/dist/lifecycle/gate-applied.d.ts +6 -0
  420. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  421. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  422. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  423. package/dist/lifecycle/gate-ledger.js +10 -1
  424. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  425. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  426. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  427. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  428. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  429. package/dist/lifecycle/gated-request-digest.js +35 -0
  430. package/dist/lifecycle/gated-request.d.ts +126 -0
  431. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  432. package/dist/lifecycle/gated-request.js +204 -0
  433. package/dist/lifecycle/identity-match.d.ts +15 -0
  434. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  435. package/dist/lifecycle/identity-match.js +11 -6
  436. package/dist/lifecycle/index-diff.d.ts +40 -0
  437. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  438. package/dist/lifecycle/index-diff.js +1 -2
  439. package/dist/lifecycle/index-document.d.ts.map +1 -1
  440. package/dist/lifecycle/index-document.js +1 -2
  441. package/dist/lifecycle/index-import.d.ts +4 -1
  442. package/dist/lifecycle/index-import.d.ts.map +1 -1
  443. package/dist/lifecycle/index-import.js +29 -32
  444. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  445. package/dist/lifecycle/ledger-read.js +7 -3
  446. package/dist/lifecycle/lock-rows.d.ts +76 -0
  447. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  448. package/dist/lifecycle/lock-rows.js +140 -0
  449. package/dist/lifecycle/query.d.ts +50 -3
  450. package/dist/lifecycle/query.d.ts.map +1 -1
  451. package/dist/lifecycle/query.js +97 -7
  452. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  453. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  454. package/dist/lifecycle/release-catalog-site.js +232 -0
  455. package/dist/lifecycle/release-catalog.d.ts +201 -0
  456. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  457. package/dist/lifecycle/release-catalog.js +198 -0
  458. package/dist/lifecycle/release-changelog.d.ts +41 -0
  459. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  460. package/dist/lifecycle/release-changelog.js +38 -0
  461. package/dist/lifecycle/release-cut.d.ts +1 -0
  462. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  463. package/dist/lifecycle/release-cut.js +1 -1
  464. package/dist/lifecycle/release-ledger.d.ts +16 -0
  465. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  466. package/dist/lifecycle/release-ledger.js +9 -0
  467. package/dist/lifecycle/release-publish.d.ts +43 -22
  468. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  469. package/dist/lifecycle/release-read.d.ts.map +1 -1
  470. package/dist/lifecycle/release-read.js +3 -0
  471. package/dist/lifecycle/release-status.d.ts +106 -0
  472. package/dist/lifecycle/release-status.d.ts.map +1 -0
  473. package/dist/lifecycle/release-status.js +115 -0
  474. package/dist/lifecycle/resource-lock.d.ts +120 -0
  475. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  476. package/dist/lifecycle/resource-lock.js +317 -0
  477. package/dist/lifecycle/retention.d.ts.map +1 -1
  478. package/dist/lifecycle/retention.js +3 -0
  479. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  480. package/dist/lifecycle/run-ledger.js +9 -1
  481. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  482. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  483. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  484. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  485. package/dist/lifecycle/snapshot-store.js +1 -2
  486. package/dist/lifecycle/target-lock.d.ts +15 -0
  487. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  488. package/dist/lifecycle/target-lock.js +25 -10
  489. package/dist/lifecycle/wave-plans.d.ts +23 -7
  490. package/dist/lifecycle/wave-plans.d.ts.map +1 -1
  491. package/dist/lifecycle/wave-plans.js +9 -2
  492. package/dist/mcp/types.d.ts +7 -0
  493. package/dist/mcp/types.d.ts.map +1 -1
  494. package/dist/notify-product.d.ts +43 -0
  495. package/dist/notify-product.d.ts.map +1 -0
  496. package/dist/notify-product.js +58 -0
  497. package/dist/notify-relay.d.ts +197 -0
  498. package/dist/notify-relay.d.ts.map +1 -0
  499. package/dist/notify-relay.js +321 -0
  500. package/dist/notify.d.ts +44 -4
  501. package/dist/notify.d.ts.map +1 -1
  502. package/dist/notify.js +77 -14
  503. package/dist/object-store/azure-blob.d.ts +129 -0
  504. package/dist/object-store/azure-blob.d.ts.map +1 -0
  505. package/dist/object-store/azure-blob.js +341 -0
  506. package/dist/object-store/common.d.ts +108 -0
  507. package/dist/object-store/common.d.ts.map +1 -0
  508. package/dist/object-store/common.js +80 -0
  509. package/dist/object-store/errors.d.ts +28 -0
  510. package/dist/object-store/errors.d.ts.map +1 -0
  511. package/dist/object-store/errors.js +21 -0
  512. package/dist/object-store/from-env.d.ts +18 -0
  513. package/dist/object-store/from-env.d.ts.map +1 -0
  514. package/dist/object-store/from-env.js +22 -0
  515. package/dist/object-store/gcs.d.ts +106 -0
  516. package/dist/object-store/gcs.d.ts.map +1 -0
  517. package/dist/object-store/gcs.js +393 -0
  518. package/dist/object-store/index.d.ts +9 -0
  519. package/dist/object-store/index.d.ts.map +1 -0
  520. package/dist/object-store/index.js +8 -0
  521. package/dist/object-store/s3.d.ts +146 -0
  522. package/dist/object-store/s3.d.ts.map +1 -0
  523. package/dist/object-store/s3.js +306 -0
  524. package/dist/op/activities/converge.d.ts.map +1 -1
  525. package/dist/op/activities/converge.js +2 -1
  526. package/dist/op/activities/index.d.ts +1 -1
  527. package/dist/op/activities/index.d.ts.map +1 -1
  528. package/dist/op/activities/index.js +1 -1
  529. package/dist/op/activities/review-agent.d.ts +55 -2
  530. package/dist/op/activities/review-agent.d.ts.map +1 -1
  531. package/dist/op/activities/review-agent.js +65 -5
  532. package/dist/op/approval-status.d.ts +103 -0
  533. package/dist/op/approval-status.d.ts.map +1 -0
  534. package/dist/op/approval-status.js +197 -0
  535. package/dist/op/gate.d.ts +29 -1
  536. package/dist/op/gate.d.ts.map +1 -1
  537. package/dist/op/gate.js +59 -23
  538. package/dist/op/generate-pipeline.d.ts.map +1 -1
  539. package/dist/op/generate-pipeline.js +7 -1
  540. package/dist/op/index.d.ts +12 -1
  541. package/dist/op/index.d.ts.map +1 -1
  542. package/dist/op/index.js +7 -1
  543. package/dist/op/op-waves-after-plan.d.ts +137 -0
  544. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  545. package/dist/op/op-waves-after-plan.js +163 -0
  546. package/dist/op/op-waves-capability-spec.d.ts +63 -0
  547. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  548. package/dist/op/op-waves-capability-spec.js +115 -0
  549. package/dist/op/op-waves-capability.d.ts +197 -0
  550. package/dist/op/op-waves-capability.d.ts.map +1 -0
  551. package/dist/op/op-waves-capability.js +311 -0
  552. package/dist/op/op-waves-events.d.ts +54 -0
  553. package/dist/op/op-waves-events.d.ts.map +1 -0
  554. package/dist/op/op-waves-events.js +122 -0
  555. package/dist/op/op-waves-notify.d.ts +7 -1
  556. package/dist/op/op-waves-notify.d.ts.map +1 -1
  557. package/dist/op/op-waves-notify.js +35 -16
  558. package/dist/op/op-waves-release-port.d.ts +18 -0
  559. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  560. package/dist/op/op-waves-release-port.js +61 -0
  561. package/dist/op/op-waves-release.d.ts +92 -0
  562. package/dist/op/op-waves-release.d.ts.map +1 -0
  563. package/dist/op/op-waves-release.js +96 -0
  564. package/dist/op/op-waves-run.d.ts +182 -6
  565. package/dist/op/op-waves-run.d.ts.map +1 -1
  566. package/dist/op/op-waves-run.js +1076 -44
  567. package/dist/op/op-waves-stand-down.d.ts +60 -0
  568. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  569. package/dist/op/op-waves-stand-down.js +96 -0
  570. package/dist/op/op-waves.d.ts +187 -8
  571. package/dist/op/op-waves.d.ts.map +1 -1
  572. package/dist/op/op-waves.js +203 -19
  573. package/dist/op/runtime.d.ts +95 -0
  574. package/dist/op/runtime.d.ts.map +1 -1
  575. package/dist/op/runtime.js +18 -0
  576. package/dist/op/stage-hooks.d.ts +45 -7
  577. package/dist/op/stage-hooks.d.ts.map +1 -1
  578. package/dist/op/stage-hooks.js +61 -3
  579. package/dist/op/steward-beside.d.ts.map +1 -1
  580. package/dist/op/steward-beside.js +2 -1
  581. package/dist/op/types.d.ts +2 -2
  582. package/dist/op/types.d.ts.map +1 -1
  583. package/dist/op/types.js +3 -2
  584. package/dist/otlp-metrics.d.ts +38 -0
  585. package/dist/otlp-metrics.d.ts.map +1 -0
  586. package/dist/otlp-metrics.js +82 -0
  587. package/dist/otlp.d.ts +249 -0
  588. package/dist/otlp.d.ts.map +1 -0
  589. package/dist/otlp.js +425 -0
  590. package/dist/override-gate.d.ts.map +1 -1
  591. package/dist/override-gate.js +5 -0
  592. package/dist/parallelism.d.ts +17 -0
  593. package/dist/parallelism.d.ts.map +1 -0
  594. package/dist/parallelism.js +33 -0
  595. package/dist/policy-packs.d.ts +69 -0
  596. package/dist/policy-packs.d.ts.map +1 -0
  597. package/dist/policy-packs.js +205 -0
  598. package/dist/policy-source.d.ts +51 -0
  599. package/dist/policy-source.d.ts.map +1 -0
  600. package/dist/policy-source.js +102 -0
  601. package/dist/pr-forge.d.ts +40 -0
  602. package/dist/pr-forge.d.ts.map +1 -1
  603. package/dist/pr-forge.js +146 -37
  604. package/dist/pr-loop.d.ts +158 -11
  605. package/dist/pr-loop.d.ts.map +1 -1
  606. package/dist/pr-loop.js +302 -44
  607. package/dist/pr-merge.d.ts +64 -0
  608. package/dist/pr-merge.d.ts.map +1 -0
  609. package/dist/pr-merge.js +78 -0
  610. package/dist/pr-post.d.ts +86 -1
  611. package/dist/pr-post.d.ts.map +1 -1
  612. package/dist/pr-post.js +141 -5
  613. package/dist/pr-report-url.d.ts +32 -4
  614. package/dist/pr-report-url.d.ts.map +1 -1
  615. package/dist/pr-report-url.js +45 -5
  616. package/dist/pr-requires.d.ts +13 -2
  617. package/dist/pr-requires.d.ts.map +1 -1
  618. package/dist/pr-requires.js +14 -0
  619. package/dist/release-floors.d.ts +1 -1
  620. package/dist/release-floors.js +1 -1
  621. package/dist/run-event.d.ts +26 -1
  622. package/dist/run-event.d.ts.map +1 -1
  623. package/dist/run-event.js +3 -1
  624. package/dist/scheduled-op-cloud.d.ts +32 -0
  625. package/dist/scheduled-op-cloud.d.ts.map +1 -0
  626. package/dist/scheduled-op-cloud.js +69 -0
  627. package/dist/sorted-json.d.ts +10 -0
  628. package/dist/sorted-json.d.ts.map +1 -0
  629. package/dist/sorted-json.js +14 -0
  630. package/dist/terraform/credentials.d.ts +59 -0
  631. package/dist/terraform/credentials.d.ts.map +1 -0
  632. package/dist/terraform/credentials.js +149 -0
  633. package/dist/utils.d.ts +1 -4
  634. package/dist/utils.d.ts.map +1 -1
  635. package/dist/utils.js +1 -9
  636. package/dist/wave-runtime.d.ts +1 -1
  637. package/dist/wave-runtime.js +2 -2
  638. package/dist/wave-runtime.mjs +405 -287
  639. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  640. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  641. package/dist/workspace/ci-lock-grain.d.ts +17 -0
  642. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  643. package/dist/workspace/ci-lock-grain.js +21 -0
  644. package/dist/workspace/ci-run.d.ts +2 -1
  645. package/dist/workspace/ci-run.d.ts.map +1 -1
  646. package/dist/workspace/ci-run.js +10 -3
  647. package/dist/workspace/declaration.d.ts +16 -4
  648. package/dist/workspace/declaration.d.ts.map +1 -1
  649. package/dist/workspace/declaration.js +5 -2
  650. package/dist/workspace/declaration.schema.json +27 -3
  651. package/dist/workspace/drift-cli.d.ts.map +1 -1
  652. package/dist/workspace/drift-cli.js +8 -3
  653. package/dist/workspace/exit-cli.d.ts +1 -1
  654. package/dist/workspace/exit-cli.d.ts.map +1 -1
  655. package/dist/workspace/exit-cli.js +2 -1
  656. package/dist/workspace/import-fetch.d.ts +4 -2
  657. package/dist/workspace/import-fetch.d.ts.map +1 -1
  658. package/dist/workspace/import-fetch.js +4 -2
  659. package/dist/workspace/import-init.d.ts.map +1 -1
  660. package/dist/workspace/import-init.js +4 -2
  661. package/dist/workspace/ledger.schema.json +7 -3
  662. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  663. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  664. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  665. package/dist/workspace/pr-report.schema.json +79 -3
  666. package/dist/workspace/promote.d.ts +1 -1
  667. package/dist/workspace/promote.d.ts.map +1 -1
  668. package/dist/workspace/promote.js +2 -1
  669. package/dist/workspace/records-cli.d.ts +2 -2
  670. package/dist/workspace/records-cli.d.ts.map +1 -1
  671. package/dist/workspace/records-cli.js +3 -2
  672. package/dist/workspace/release-catalog.schema.json +277 -0
  673. package/dist/workspace/run-event.schema.json +18 -1
  674. package/dist/workspace/work-cli.d.ts +3 -1
  675. package/dist/workspace/work-cli.d.ts.map +1 -1
  676. package/dist/workspace/work-cli.js +7 -2
  677. package/dist/workspace/workspace-run.d.ts.map +1 -1
  678. package/dist/workspace/workspace-run.js +2 -1
  679. package/package.json +21 -1
  680. package/src/__fixtures__/estate-ledger.ts +101 -0
  681. package/src/__fixtures__/oidc-emulator.ts +31 -2
  682. package/src/__fixtures__/product-words.ts +44 -0
  683. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  684. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  685. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  686. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  687. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  688. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  689. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  690. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  691. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  692. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  693. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  694. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  695. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  696. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  697. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  698. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  699. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  700. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  701. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  702. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  703. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  704. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  705. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  706. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  707. package/src/__golden__/wave-loop/op-point.json +18 -4
  708. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  709. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  710. package/src/__golden__/wave-loop/op-spend.json +10 -2
  711. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  712. package/src/__golden__/wave-loop/op-wide.json +20 -4
  713. package/src/bucket-check/azure.ts +307 -0
  714. package/src/bucket-check/bucket-check.test.ts +210 -0
  715. package/src/bucket-check/fixtures/azure.json +153 -0
  716. package/src/bucket-check/fixtures/gcs.json +148 -0
  717. package/src/bucket-check/fixtures/s3.json +277 -0
  718. package/src/bucket-check/gcs.ts +257 -0
  719. package/src/bucket-check/index.ts +61 -0
  720. package/src/bucket-check/s3.ts +433 -0
  721. package/src/bucket-check/types.ts +75 -0
  722. package/src/bucket-check/wire.ts +50 -0
  723. package/src/bucket-check.ts +5 -0
  724. package/src/capabilities/templates.test.ts +2 -3
  725. package/src/capabilities/templates.ts +1 -2
  726. package/src/cdk/advise.test.ts +1 -1
  727. package/src/change-set-bundle.test.ts +0 -1
  728. package/src/change-set.ts +2 -3
  729. package/src/ci-agent.test.ts +348 -0
  730. package/src/ci-agent.ts +1025 -0
  731. package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
  732. package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
  733. package/src/ci-audit/attribution.ts +260 -0
  734. package/src/ci-audit/audit-log.ts +220 -0
  735. package/src/ci-audit/ci-audit.test.ts +175 -0
  736. package/src/ci-audit/index.ts +15 -0
  737. package/src/ci-audit/unrecorded.ts +140 -0
  738. package/src/ci-audit.ts +2 -0
  739. package/src/ci-control.ts +173 -0
  740. package/src/ci-estate/delivery.ts +433 -0
  741. package/src/ci-estate/overdue.ts +81 -0
  742. package/src/ci-estate/page.ts +343 -0
  743. package/src/ci-estate/rows.ts +251 -0
  744. package/src/ci-estate.test.ts +281 -0
  745. package/src/ci-estate.ts +175 -0
  746. package/src/ci-handover.ts +67 -16
  747. package/src/ci-identity-database.test.ts +54 -0
  748. package/src/ci-identity-pulumi.test.ts +163 -0
  749. package/src/ci-identity-targets.test.ts +3 -1
  750. package/src/ci-identity.ts +123 -22
  751. package/src/ci-job-guard.test.ts +154 -0
  752. package/src/ci-job-guard.ts +319 -0
  753. package/src/ci-jobs.ts +8 -0
  754. package/src/ci-product-comment-targets.test.ts +45 -0
  755. package/src/ci-product-words.test.ts +101 -0
  756. package/src/ci-product-words.ts +565 -0
  757. package/src/ci-product.ts +226 -0
  758. package/src/ci-respond-run.ts +291 -0
  759. package/src/ci-respond.test.ts +264 -0
  760. package/src/ci-respond.ts +412 -0
  761. package/src/ci-shared-reads.test.ts +145 -0
  762. package/src/cli/commands/audit.test.ts +1 -1
  763. package/src/cli/commands/audit.ts +3 -2
  764. package/src/cli/commands/carve.test.ts +1 -1
  765. package/src/cli/commands/carve.ts +2 -2
  766. package/src/cli/commands/init.ts +3 -1
  767. package/src/cli/component-wave-args.test.ts +16 -0
  768. package/src/cli/handlers/agent.ts +126 -0
  769. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  770. package/src/cli/handlers/approve-confirm.ts +200 -0
  771. package/src/cli/handlers/approve.ts +18 -1
  772. package/src/cli/handlers/audit-log.ts +74 -0
  773. package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
  774. package/src/cli/handlers/build.test.ts +7 -0
  775. package/src/cli/handlers/build.ts +113 -1
  776. package/src/cli/handlers/ci-check-job.test.ts +114 -0
  777. package/src/cli/handlers/ci-check-job.ts +33 -0
  778. package/src/cli/handlers/ci-check.ts +63 -0
  779. package/src/cli/handlers/ci-forge-check.ts +91 -0
  780. package/src/cli/handlers/e2e-safe-run.ts +27 -0
  781. package/src/cli/handlers/fan-out.test.ts +10 -10
  782. package/src/cli/handlers/fan-out.ts +5 -0
  783. package/src/cli/handlers/gate-pending.ts +46 -0
  784. package/src/cli/handlers/init.ts +1 -0
  785. package/src/cli/handlers/ledger.ts +1 -1
  786. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  787. package/src/cli/handlers/lock.test.ts +29 -2
  788. package/src/cli/handlers/lock.ts +66 -6
  789. package/src/cli/handlers/notify-relay.ts +130 -0
  790. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  791. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  792. package/src/cli/handlers/pr-env.ts +48 -11
  793. package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
  794. package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
  795. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  796. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  797. package/src/cli/handlers/pr-waves.test.ts +8 -2
  798. package/src/cli/handlers/pr.test.ts +8 -8
  799. package/src/cli/handlers/pr.ts +879 -205
  800. package/src/cli/handlers/promote.test.ts +5 -5
  801. package/src/cli/handlers/promote.ts +22 -2
  802. package/src/cli/handlers/release.ts +2 -0
  803. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  804. package/src/cli/handlers/run-wave.ts +144 -2
  805. package/src/cli/handlers/run.test.ts +6 -4
  806. package/src/cli/handlers/run.ts +86 -1
  807. package/src/cli/handlers/serve.ts +10 -1
  808. package/src/cli/main.test.ts +1 -1
  809. package/src/cli/main.ts +180 -13
  810. package/src/cli/mcp/ledger-tools.ts +126 -0
  811. package/src/cli/mcp/product-tools.test.ts +123 -0
  812. package/src/cli/mcp/product-tools.ts +129 -0
  813. package/src/cli/mcp/read-only.test.ts +134 -0
  814. package/src/cli/mcp/read-only.ts +68 -0
  815. package/src/cli/mcp/report-tools.ts +135 -0
  816. package/src/cli/mcp/server.test.ts +5 -4
  817. package/src/cli/mcp/server.ts +90 -16
  818. package/src/cli/mcp-config.ts +8 -3
  819. package/src/cli/parse-args.ts +119 -2
  820. package/src/cli/registry.ts +73 -0
  821. package/src/cloud-lister/sigv4.ts +80 -23
  822. package/src/components/adoption.test.ts +140 -0
  823. package/src/components/adoption.ts +140 -0
  824. package/src/components/apply-lease.ts +49 -0
  825. package/src/components/capability.ts +180 -6
  826. package/src/components/check-hooks.test.ts +66 -0
  827. package/src/components/check-hooks.ts +255 -0
  828. package/src/components/check-steps.test.ts +70 -0
  829. package/src/components/check-steps.ts +158 -0
  830. package/src/components/ci-services.test.ts +51 -0
  831. package/src/components/ci-services.ts +82 -0
  832. package/src/components/cli-support.ts +23 -2
  833. package/src/components/driver.test.ts +3 -3
  834. package/src/components/driver.ts +73 -6
  835. package/src/components/fan-out-run.ts +68 -18
  836. package/src/components/groups.ts +21 -4
  837. package/src/components/plan-flags.test.ts +46 -0
  838. package/src/components/pr-comment-preview-targets.test.ts +34 -0
  839. package/src/components/pr-comment-preview.test.ts +54 -0
  840. package/src/components/pr-env-ledger.test.ts +9 -0
  841. package/src/components/pr-env-ledger.ts +42 -0
  842. package/src/components/pr-env-ports.ts +29 -4
  843. package/src/components/pr-env-run-bundle.test.ts +2 -14
  844. package/src/components/pr-env-run.test.ts +19 -0
  845. package/src/components/pr-env-run.ts +12 -2
  846. package/src/components/pr-environment.test.ts +29 -0
  847. package/src/components/pr-environment.ts +40 -8
  848. package/src/components/pr-pipeline-runners.test.ts +80 -0
  849. package/src/components/pr-pipeline.test.ts +15 -0
  850. package/src/components/pr-pipeline.ts +498 -18
  851. package/src/components/pr-policy.ts +45 -7
  852. package/src/components/pr-run.test.ts +1 -1
  853. package/src/components/pr-run.ts +138 -11
  854. package/src/components/pr-stale-job.test.ts +34 -0
  855. package/src/components/pr-targets.test.ts +35 -0
  856. package/src/components/pr-targets.ts +45 -0
  857. package/src/components/product-pipeline.test.ts +200 -0
  858. package/src/components/product-pipeline.ts +383 -0
  859. package/src/components/promote.ts +10 -1
  860. package/src/components/release-compile.ts +87 -1
  861. package/src/components/release-promote.ts +65 -1
  862. package/src/components/repo-lock.ts +52 -0
  863. package/src/components/row-lease.test.ts +490 -0
  864. package/src/components/row-lease.ts +167 -0
  865. package/src/components/wave-plan-policy.test.ts +19 -0
  866. package/src/components/wave-plan.ts +96 -6
  867. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  868. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  869. package/src/control/applied.test.ts +148 -0
  870. package/src/control/applied.ts +191 -0
  871. package/src/control/consumers.test.ts +129 -0
  872. package/src/control/consumers.ts +192 -0
  873. package/src/control/control.test.ts +302 -0
  874. package/src/control/dispatch.ts +699 -0
  875. package/src/control/edges.test.ts +112 -0
  876. package/src/control/edges.ts +164 -0
  877. package/src/control/note-checkout.test.ts +91 -0
  878. package/src/control/reconcile.ts +250 -0
  879. package/src/control/records.ts +395 -0
  880. package/src/discovery/sandbox/bundle.ts +25 -1
  881. package/src/e2e-harness/__project__/chant.config.ts +4 -0
  882. package/src/e2e-harness/__project__/src/compose.ts +33 -0
  883. package/src/e2e-harness/bucket.ts +69 -0
  884. package/src/e2e-harness/claim.test.ts +150 -0
  885. package/src/e2e-harness/claim.ts +140 -0
  886. package/src/e2e-harness/driver.test.ts +304 -0
  887. package/src/e2e-harness/driver.ts +294 -0
  888. package/src/e2e-harness/forgejo.ts +267 -0
  889. package/src/e2e-harness/git.ts +96 -0
  890. package/src/e2e-harness/index.ts +50 -0
  891. package/src/e2e-harness/jobs.ts +35 -0
  892. package/src/e2e-harness/pins.ts +52 -0
  893. package/src/e2e-harness/ports.ts +130 -0
  894. package/src/e2e-harness/reports.ts +79 -0
  895. package/src/e2e-harness/safe-run-cli.test.ts +102 -0
  896. package/src/e2e-harness/safe-run-cli.ts +54 -0
  897. package/src/e2e-harness/safe-run.ts +198 -0
  898. package/src/e2e-harness/scenario.ts +89 -0
  899. package/src/e2e-harness/schemas/README.md +62 -0
  900. package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  901. package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
  902. package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  903. package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  904. package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  905. package/src/e2e-harness/schemas/index.ts +220 -0
  906. package/src/e2e-harness/schemas.test.ts +145 -0
  907. package/src/e2e-harness/stack.test.ts +124 -0
  908. package/src/e2e-harness/stack.ts +306 -0
  909. package/src/e2e-harness/steps.ts +30 -0
  910. package/src/e2e-harness.ts +2 -0
  911. package/src/engine-facts.test.ts +2 -3
  912. package/src/engine-facts.ts +1 -2
  913. package/src/exit-codes.test.ts +32 -0
  914. package/src/exit-codes.ts +61 -0
  915. package/src/forge-check/check.ts +155 -0
  916. package/src/forge-check/contract.ts +215 -0
  917. package/src/forge-check/forge-check.test.ts +427 -0
  918. package/src/forge-check/forge.ts +318 -0
  919. package/src/forge-check/index.ts +43 -0
  920. package/src/forge-check/pulumi.ts +192 -0
  921. package/src/forge-check/read-only.ts +56 -0
  922. package/src/forge-check/trust.ts +527 -0
  923. package/src/forge-check/types.ts +78 -0
  924. package/src/forge-check.ts +5 -0
  925. package/src/gate-decision-bundle.test.ts +11 -0
  926. package/src/gate-decision.ts +3 -0
  927. package/src/gate-policy.ts +92 -3
  928. package/src/gated-waves-bundle.test.ts +0 -1
  929. package/src/index.ts +2 -0
  930. package/src/lexicon.ts +143 -6
  931. package/src/lifecycle/adoption-file.ts +1 -2
  932. package/src/lifecycle/cloud-index.test.ts +2 -3
  933. package/src/lifecycle/cloud-index.ts +1 -2
  934. package/src/lifecycle/control-entries-ledger.test.ts +69 -0
  935. package/src/lifecycle/gate-applied.ts +6 -0
  936. package/src/lifecycle/gate-ledger.ts +35 -1
  937. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  938. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  939. package/src/lifecycle/gated-request-digest.ts +49 -0
  940. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  941. package/src/lifecycle/gated-request.ts +279 -0
  942. package/src/lifecycle/identity-match.ts +25 -6
  943. package/src/lifecycle/index-diff.ts +1 -2
  944. package/src/lifecycle/index-document.ts +1 -2
  945. package/src/lifecycle/index-import.test.ts +14 -0
  946. package/src/lifecycle/index-import.ts +54 -34
  947. package/src/lifecycle/ledger-read.ts +7 -3
  948. package/src/lifecycle/lock-rows.test.ts +109 -0
  949. package/src/lifecycle/lock-rows.ts +167 -0
  950. package/src/lifecycle/publish-target-context.test.ts +108 -0
  951. package/src/lifecycle/query.test.ts +2 -3
  952. package/src/lifecycle/query.ts +109 -8
  953. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  954. package/src/lifecycle/release-catalog-site.ts +291 -0
  955. package/src/lifecycle/release-catalog.test.ts +192 -0
  956. package/src/lifecycle/release-catalog.ts +353 -0
  957. package/src/lifecycle/release-changelog.test.ts +70 -0
  958. package/src/lifecycle/release-changelog.ts +71 -0
  959. package/src/lifecycle/release-cut.ts +2 -2
  960. package/src/lifecycle/release-ledger.ts +19 -0
  961. package/src/lifecycle/release-publish.ts +45 -22
  962. package/src/lifecycle/release-read.ts +2 -0
  963. package/src/lifecycle/release-status.test.ts +185 -0
  964. package/src/lifecycle/release-status.ts +175 -0
  965. package/src/lifecycle/resource-lock.test.ts +175 -0
  966. package/src/lifecycle/resource-lock.ts +354 -0
  967. package/src/lifecycle/retention.ts +2 -0
  968. package/src/lifecycle/run-ledger.ts +7 -1
  969. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  970. package/src/lifecycle/snapshot-store.ts +1 -2
  971. package/src/lifecycle/target-lock.ts +24 -9
  972. package/src/lifecycle/wave-plans.ts +33 -5
  973. package/src/mcp/types.ts +7 -0
  974. package/src/notify-product.ts +76 -0
  975. package/src/notify-relay.test.ts +213 -0
  976. package/src/notify-relay.ts +407 -0
  977. package/src/notify.ts +95 -14
  978. package/src/object-store/azure-blob.ts +374 -0
  979. package/src/object-store/common.ts +133 -0
  980. package/src/object-store/errors.ts +26 -0
  981. package/src/object-store/from-env.ts +36 -0
  982. package/src/object-store/gcs.ts +436 -0
  983. package/src/object-store/index.ts +8 -0
  984. package/src/object-store/object-store.test.ts +130 -0
  985. package/src/object-store/s3.ts +350 -0
  986. package/src/op/activities/converge.ts +2 -1
  987. package/src/op/activities/index.ts +1 -1
  988. package/src/op/activities/review-agent.open.test.ts +78 -0
  989. package/src/op/activities/review-agent.test.ts +13 -0
  990. package/src/op/activities/review-agent.ts +89 -5
  991. package/src/op/approval-status.test.ts +134 -0
  992. package/src/op/approval-status.ts +235 -0
  993. package/src/op/gate-review.test.ts +2 -1
  994. package/src/op/gate.ts +81 -22
  995. package/src/op/generate-pipeline.ts +7 -1
  996. package/src/op/index.ts +23 -0
  997. package/src/op/op-waves-after-plan.test.ts +288 -0
  998. package/src/op/op-waves-after-plan.ts +238 -0
  999. package/src/op/op-waves-capability-spec.ts +133 -0
  1000. package/src/op/op-waves-capability.test.ts +217 -0
  1001. package/src/op/op-waves-capability.ts +370 -0
  1002. package/src/op/op-waves-events.ts +135 -0
  1003. package/src/op/op-waves-notify-words.test.ts +149 -0
  1004. package/src/op/op-waves-notify.ts +41 -16
  1005. package/src/op/op-waves-parallelism.test.ts +89 -0
  1006. package/src/op/op-waves-pull-request.test.ts +219 -0
  1007. package/src/op/op-waves-release-port.ts +64 -0
  1008. package/src/op/op-waves-release.test.ts +209 -0
  1009. package/src/op/op-waves-release.ts +132 -0
  1010. package/src/op/op-waves-run-record.test.ts +32 -0
  1011. package/src/op/op-waves-run.ts +1235 -52
  1012. package/src/op/op-waves-stand-down.test.ts +240 -0
  1013. package/src/op/op-waves-stand-down.ts +107 -0
  1014. package/src/op/op-waves-trace.test.ts +205 -0
  1015. package/src/op/op-waves.test.ts +112 -0
  1016. package/src/op/op-waves.ts +320 -22
  1017. package/src/op/runtime.ts +107 -0
  1018. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  1019. package/src/op/stage-hooks.ts +91 -12
  1020. package/src/op/steward-beside.ts +2 -1
  1021. package/src/op/types.ts +3 -2
  1022. package/src/otlp-metrics.ts +96 -0
  1023. package/src/otlp.test.ts +243 -0
  1024. package/src/otlp.ts +543 -0
  1025. package/src/override-gate-bundle.test.ts +2 -0
  1026. package/src/override-gate.ts +4 -0
  1027. package/src/parallelism.test.ts +38 -0
  1028. package/src/parallelism.ts +33 -0
  1029. package/src/policy-packs.ts +230 -0
  1030. package/src/policy-source.test.ts +256 -0
  1031. package/src/policy-source.ts +111 -0
  1032. package/src/pr-forge-bundle.test.ts +1 -1
  1033. package/src/pr-forge.ts +175 -33
  1034. package/src/pr-loop-bundle.test.ts +7 -3
  1035. package/src/pr-loop-narrowed.test.ts +63 -0
  1036. package/src/pr-loop-words.test.ts +155 -0
  1037. package/src/pr-loop.ts +398 -52
  1038. package/src/pr-merge.test.ts +100 -0
  1039. package/src/pr-merge.ts +105 -0
  1040. package/src/pr-post-stale.test.ts +163 -0
  1041. package/src/pr-post.ts +190 -5
  1042. package/src/pr-report-url.ts +61 -6
  1043. package/src/pr-requires.test.ts +37 -1
  1044. package/src/pr-requires.ts +16 -2
  1045. package/src/product-subpaths-plain-node.e2e.test.ts +212 -0
  1046. package/src/release-floors.ts +1 -1
  1047. package/src/run-event.ts +28 -1
  1048. package/src/scheduled-op-cloud.ts +68 -0
  1049. package/src/sorted-json.ts +17 -0
  1050. package/src/stage-hooks-bundle.test.ts +6 -0
  1051. package/src/terraform/credentials.test.ts +77 -0
  1052. package/src/terraform/credentials.ts +162 -0
  1053. package/src/utils.ts +2 -11
  1054. package/src/wave-loop-golden.test.ts +2 -1
  1055. package/src/wave-runtime.ts +2 -2
  1056. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  1057. package/src/workspace/ci-lock-grain.test.ts +31 -0
  1058. package/src/workspace/ci-lock-grain.ts +29 -0
  1059. package/src/workspace/ci-report-url.test.ts +1 -1
  1060. package/src/workspace/ci-run.test.ts +1 -1
  1061. package/src/workspace/ci-run.ts +10 -3
  1062. package/src/workspace/declaration.schema.json +27 -3
  1063. package/src/workspace/declaration.test.ts +1 -1
  1064. package/src/workspace/declaration.ts +26 -10
  1065. package/src/workspace/drift-cli.ts +8 -3
  1066. package/src/workspace/exit-cli.ts +2 -1
  1067. package/src/workspace/import-fetch.ts +4 -2
  1068. package/src/workspace/import-init.ts +4 -2
  1069. package/src/workspace/ledger.schema.json +7 -3
  1070. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  1071. package/src/workspace/pr-report.schema.json +79 -3
  1072. package/src/workspace/promote.ts +2 -1
  1073. package/src/workspace/records-cli.ts +3 -2
  1074. package/src/workspace/release-catalog.schema.json +277 -0
  1075. package/src/workspace/run-event.schema.json +18 -1
  1076. package/src/workspace/work-cli.ts +8 -2
  1077. package/src/workspace/workspace-run.ts +2 -1
@@ -0,0 +1,44 @@
1
+ /**
2
+ * chant#4558: the shared bucket check in CI core.
3
+ *
4
+ * terragucci init (terragucci#1285) and `plywood init` (plywood#3) both
5
+ * reuse a team's existing state bucket, and the engines behind them (plunge,
6
+ * choudoufu) refuse to open one without versioning, a lifecycle rule that
7
+ * expires noncurrent versions, and a public access block. This check reads
8
+ * the same settings with the same rules, so init never passes a bucket the
9
+ * engine then refuses. It reads only: three to four GETs, no write, no
10
+ * bucket created.
11
+ *
12
+ * The products hold the words. A {@link BucketReport} carries each setting's
13
+ * verdict, what the store has, and the fix command; the product writes the
14
+ * headline around it.
15
+ *
16
+ * The shared fixture set is ./fixtures/{s3,gcs,azure}.json, published as
17
+ * `@intentius/chant/bucket-check/fixtures/<store>.json`. Each case is the
18
+ * store's API answer and the verdicts it must produce; chant's test runs
19
+ * them through the evaluators here, and an engine's test can run the same
20
+ * files through its own contract check.
21
+ */
22
+ import { checkAzureBlob } from "./azure.js";
23
+ import { checkGcsBucket } from "./gcs.js";
24
+ import { checkS3Bucket } from "./s3.js";
25
+ export * from "./types.js";
26
+ export { BucketCheckError, namespacePrefix } from "./wire.js";
27
+ export { evaluateS3, readS3, checkS3Bucket, s3LifecycleFix } from "./s3.js";
28
+ export { evaluateGcs, readGcs, checkGcsBucket, gcsLifecycleFix } from "./gcs.js";
29
+ export { evaluateAzure, readAzure, checkAzureBlob, azureLifecycleFix } from "./azure.js";
30
+ /**
31
+ * Reads the bucket's settings and reports one finding per setting. Throws
32
+ * {@link BucketCheckError} when nothing could be learned (no such bucket, an
33
+ * unexpected error); a denied read is a finding with verdict "unreadable".
34
+ */
35
+ export async function checkBucket(target, options = {}) {
36
+ switch (target.store) {
37
+ case "s3":
38
+ return checkS3Bucket(target, options);
39
+ case "gcs":
40
+ return checkGcsBucket(target, options);
41
+ case "azblob":
42
+ return checkAzureBlob(target, options);
43
+ }
44
+ }
@@ -0,0 +1,116 @@
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
+ import { type AwsStaticCredentials, type CredentialChains } from "../cloud-lister/credentials.js";
14
+ import type { TlsOptions, WireResponse } from "../cloud-lister/transport.js";
15
+ import { type BucketFinding, type BucketReport, type ReadError } from "./types.js";
16
+ import { type WireOptions } from "./wire.js";
17
+ export interface S3BucketTarget {
18
+ store: "s3";
19
+ bucket: string;
20
+ region: string;
21
+ /** An emulator's S3 base, e.g. `http://localhost:4566`. Requires `credentials`. */
22
+ endpoint?: string;
23
+ credentials?: AwsStaticCredentials;
24
+ /** Twelve-digit account that must own the bucket, sent as x-amz-expected-bucket-owner. */
25
+ expectedOwner?: string;
26
+ tls?: TlsOptions;
27
+ }
28
+ export interface S3LifecycleRule {
29
+ ID?: string;
30
+ Status?: string;
31
+ Prefix?: string;
32
+ Filter?: {
33
+ Prefix?: string;
34
+ Tag?: {
35
+ Key?: string;
36
+ Value?: string;
37
+ };
38
+ ObjectSizeGreaterThan?: number;
39
+ ObjectSizeLessThan?: number;
40
+ And?: {
41
+ Prefix?: string;
42
+ Tags?: Array<{
43
+ Key?: string;
44
+ Value?: string;
45
+ }>;
46
+ ObjectSizeGreaterThan?: number;
47
+ ObjectSizeLessThan?: number;
48
+ };
49
+ };
50
+ Expiration?: {
51
+ Days?: number;
52
+ Date?: string;
53
+ ExpiredObjectDeleteMarker?: boolean;
54
+ };
55
+ NoncurrentVersionExpiration?: {
56
+ NoncurrentDays?: number;
57
+ NewerNoncurrentVersions?: number;
58
+ };
59
+ }
60
+ export interface S3PublicAccessBlockConfiguration {
61
+ BlockPublicAcls?: boolean;
62
+ IgnorePublicAcls?: boolean;
63
+ BlockPublicPolicy?: boolean;
64
+ RestrictPublicBuckets?: boolean;
65
+ }
66
+ export interface S3Input {
67
+ versioning: {
68
+ Status?: string;
69
+ } | ReadError;
70
+ lifecycle: {
71
+ Rules?: S3LifecycleRule[];
72
+ } | ReadError;
73
+ publicAccessBlock: {
74
+ PublicAccessBlockConfiguration?: S3PublicAccessBlockConfiguration;
75
+ } | ReadError;
76
+ }
77
+ export interface S3EvaluateOptions {
78
+ bucket: string;
79
+ namespaces?: readonly string[];
80
+ expectedOwner?: string;
81
+ /** Days a noncurrent version is kept in the suggested lifecycle rule; the recovery window. Default 30. */
82
+ recoveryDays?: number;
83
+ }
84
+ /** The lifecycle configuration the fix suggests: one noncurrent-expiry rule per namespace, or one with no filter. */
85
+ export declare function s3LifecycleFix(bucket: string, namespaces: readonly string[], recoveryDays: number): string;
86
+ export declare function evaluateS3(input: S3Input, options: S3EvaluateOptions): BucketFinding[];
87
+ interface XmlNode {
88
+ name: string;
89
+ children: XmlNode[];
90
+ text: string;
91
+ }
92
+ /** A tolerant parser for the small documents S3 returns. Exported for tests. */
93
+ export declare function parseXml(xml: string): XmlNode;
94
+ export declare function parseVersioning(xml: string): {
95
+ Status?: string;
96
+ };
97
+ export declare function parsePublicAccessBlock(xml: string): {
98
+ PublicAccessBlockConfiguration?: S3PublicAccessBlockConfiguration;
99
+ };
100
+ export declare function parseLifecycle(xml: string): {
101
+ Rules: S3LifecycleRule[];
102
+ };
103
+ /** A non-2xx S3 answer as a {@link ReadError}. */
104
+ export declare function parseS3Error(res: WireResponse): ReadError;
105
+ export interface S3ReadOptions extends WireOptions {
106
+ chains?: CredentialChains;
107
+ now?: () => Date;
108
+ }
109
+ export declare function s3Url(target: S3BucketTarget, subresource: string): string;
110
+ export declare function readS3(target: S3BucketTarget, options?: S3ReadOptions): Promise<S3Input>;
111
+ export declare function checkS3Bucket(target: S3BucketTarget, options?: S3ReadOptions & {
112
+ namespaces?: readonly string[];
113
+ recoveryDays?: number;
114
+ }): Promise<BucketReport>;
115
+ export {};
116
+ //# sourceMappingURL=s3.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../src/bucket-check/s3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAA8C,KAAK,oBAAoB,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE3I,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAe,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAC7F,OAAO,EAA8C,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAEtF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,IAAI,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAMD,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,GAAG,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACvC,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,KAAK,CAAC;gBAAE,GAAG,CAAC,EAAE,MAAM,CAAC;gBAAC,KAAK,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;YAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACxI,CAAC;IACF,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,yBAAyB,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnF,2BAA2B,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7F;AAED,MAAM,WAAW,gCAAgC;IAC/C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAC5C,SAAS,EAAE;QAAE,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;KAAE,GAAG,SAAS,CAAC;IACrD,iBAAiB,EAAE;QAAE,8BAA8B,CAAC,EAAE,gCAAgC,CAAA;KAAE,GAAG,SAAS,CAAC;CACtG;AAKD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0GAA0G;IAC1G,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA8DD,qHAAqH;AACrH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAW1G;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,GAAG,aAAa,EAAE,CAKtF;AAyGD,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAWD,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAsB7C;AAsBD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAGhE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,8BAA8B,CAAC,EAAE,gCAAgC,CAAA;CAAE,CAWzH;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,eAAe,EAAE,CAAA;CAAE,CAiCxE;AAED,kDAAkD;AAClD,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,SAAS,CAGzD;AAKD,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAID,wBAAgB,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAOzE;AAED,wBAAsB,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAwBlG;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,GAAE,aAAa,GAAG;IAAE,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,YAAY,CAAC,CAS1K"}
@@ -0,0 +1,362 @@
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
+ import { createHash } from "node:crypto";
14
+ import { resolveAwsCredentials, sdkCredentialChains } from "../cloud-lister/credentials.js";
15
+ import { signV4 } from "../cloud-lister/sigv4.js";
16
+ import { isReadError } from "./types.js";
17
+ import { BucketCheckError, namespacePrefix, sendGet } from "./wire.js";
18
+ function denied(e) {
19
+ return e.error.status === 403 || e.error.code === "AccessDenied" || e.error.code === "AllAccessDisabled";
20
+ }
21
+ function readFailure(setting, permission, e, expectedOwner) {
22
+ if (!denied(e)) {
23
+ throw new BucketCheckError(`s3: reading the bucket's ${setting} setting failed: ${e.error.code ?? `HTTP ${e.error.status ?? "?"}`}`);
24
+ }
25
+ let found = `${permission} was denied`;
26
+ if (expectedOwner)
27
+ found += `, which is also what S3 answers when the bucket is owned by an account other than ${expectedOwner}`;
28
+ return { setting, verdict: "unreadable", found, unwaivable: false, fix: `Grant the identity ${permission} on the bucket, or have someone who holds it confirm the setting.` };
29
+ }
30
+ const ruleId = (r) => (r.ID ? r.ID : "(unnamed rule)");
31
+ function rulePrefix(r) {
32
+ let prefix = r.Prefix ?? "";
33
+ if (r.Filter) {
34
+ if (r.Filter.And?.Prefix)
35
+ prefix = r.Filter.And.Prefix;
36
+ if (r.Filter.Prefix)
37
+ prefix = r.Filter.Prefix;
38
+ }
39
+ return prefix;
40
+ }
41
+ function filteredBeyondPrefix(r) {
42
+ const why = "is filtered by tag or object size, which this check does not rely on";
43
+ const f = r.Filter;
44
+ if (!f)
45
+ return "";
46
+ if (f.Tag !== undefined || f.ObjectSizeGreaterThan !== undefined || f.ObjectSizeLessThan !== undefined)
47
+ return why;
48
+ if (f.And && ((f.And.Tags?.length ?? 0) > 0 || f.And.ObjectSizeGreaterThan !== undefined || f.And.ObjectSizeLessThan !== undefined))
49
+ return why;
50
+ return "";
51
+ }
52
+ function expiresCurrent(r) {
53
+ const e = r.Expiration;
54
+ if (!e)
55
+ return "";
56
+ if ((e.Days ?? 0) > 0)
57
+ return `after ${e.Days} day(s)`;
58
+ if (e.Date) {
59
+ const d = new Date(e.Date);
60
+ if (!Number.isNaN(d.getTime()) && d.getTime() > 0)
61
+ return `on ${d.toISOString().slice(0, 10)}`;
62
+ }
63
+ return "";
64
+ }
65
+ function mayReach(r, namespaces) {
66
+ const prefix = rulePrefix(r);
67
+ if (prefix === "" || namespaces.length === 0)
68
+ return true;
69
+ return namespaces.some((ns) => {
70
+ const n = namespacePrefix(ns);
71
+ return n.startsWith(prefix) || prefix.startsWith(n);
72
+ });
73
+ }
74
+ function describeNoncurrent(r) {
75
+ const nve = r.NoncurrentVersionExpiration ?? {};
76
+ let d = `rule "${ruleId(r)}" expires noncurrent versions after ${nve.NoncurrentDays ?? 0} day(s)`;
77
+ if ((nve.NewerNoncurrentVersions ?? 0) > 0)
78
+ d += `, keeping the newest ${nve.NewerNoncurrentVersions} whatever their age`;
79
+ return d;
80
+ }
81
+ /** The lifecycle configuration the fix suggests: one noncurrent-expiry rule per namespace, or one with no filter. */
82
+ export function s3LifecycleFix(bucket, namespaces, recoveryDays) {
83
+ const rules = (namespaces.length === 0 ? [""] : namespaces).map((ns, i) => ({
84
+ ID: namespaces.length <= 1 ? "expire-noncurrent" : `expire-noncurrent-${i + 1}`,
85
+ Status: "Enabled",
86
+ Filter: ns === "" ? {} : { Prefix: namespacePrefix(ns) },
87
+ NoncurrentVersionExpiration: { NoncurrentDays: recoveryDays },
88
+ }));
89
+ return (`aws s3api put-bucket-lifecycle-configuration --bucket ${bucket} --lifecycle-configuration '${JSON.stringify({ Rules: rules })}' ` +
90
+ `(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)`);
91
+ }
92
+ export function evaluateS3(input, options) {
93
+ const { bucket, expectedOwner } = options;
94
+ const namespaces = options.namespaces ?? [];
95
+ const recoveryDays = options.recoveryDays ?? 30;
96
+ return [versioning(input, bucket, expectedOwner), lifecycle(input, bucket, namespaces, expectedOwner, recoveryDays), publicAccessBlock(input, bucket, expectedOwner)];
97
+ }
98
+ function versioning(input, bucket, expectedOwner) {
99
+ const v = input.versioning;
100
+ if (isReadError(v))
101
+ return readFailure("versioning", "s3:GetBucketVersioning", v, expectedOwner);
102
+ if (v.Status === "Enabled")
103
+ return { setting: "versioning", verdict: "ok", found: "versioning is Enabled", unwaivable: false };
104
+ return {
105
+ setting: "versioning",
106
+ verdict: "fail",
107
+ found: v.Status === "Suspended" ? "versioning is Suspended" : "versioning has never been enabled",
108
+ unwaivable: false,
109
+ fix: `aws s3api put-bucket-versioning --bucket ${bucket} --versioning-configuration Status=Enabled`,
110
+ };
111
+ }
112
+ function lifecycle(input, bucket, namespaces, expectedOwner, recoveryDays) {
113
+ const fail = (found) => ({ setting: "lifecycle", verdict: "fail", found, unwaivable: false, fix: s3LifecycleFix(bucket, namespaces, recoveryDays) });
114
+ const l = input.lifecycle;
115
+ if (isReadError(l)) {
116
+ if (l.error.code === "NoSuchLifecycleConfiguration")
117
+ return fail("the bucket has no lifecycle configuration");
118
+ return readFailure("lifecycle", "s3:GetLifecycleConfiguration", l, expectedOwner);
119
+ }
120
+ const rules = l.Rules ?? [];
121
+ const deleting = [];
122
+ for (const r of rules) {
123
+ if (r.Status !== "Enabled")
124
+ continue;
125
+ const when = expiresCurrent(r);
126
+ if (when === "" || !mayReach(r, namespaces))
127
+ continue;
128
+ deleting.push(`rule "${ruleId(r)}" expires current objects ${when}, and a record is a current object`);
129
+ }
130
+ if (deleting.length > 0) {
131
+ return {
132
+ setting: "lifecycle",
133
+ verdict: "fail",
134
+ found: deleting.join("; "),
135
+ unwaivable: true,
136
+ 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.",
137
+ };
138
+ }
139
+ const near = [];
140
+ const covering = [];
141
+ for (const r of rules) {
142
+ if (!r.NoncurrentVersionExpiration || (r.NoncurrentVersionExpiration.NoncurrentDays ?? 0) <= 0)
143
+ continue;
144
+ if (r.Status !== "Enabled") {
145
+ near.push(`rule "${ruleId(r)}" expires noncurrent versions but is ${r.Status ?? ""}`);
146
+ continue;
147
+ }
148
+ const why = filteredBeyondPrefix(r);
149
+ if (why !== "") {
150
+ near.push(`rule "${ruleId(r)}" expires noncurrent versions but ${why}`);
151
+ continue;
152
+ }
153
+ covering.push(r);
154
+ }
155
+ const used = [];
156
+ const uncovered = [];
157
+ const targets = namespaces.length === 0 ? [""] : namespaces;
158
+ for (const ns of targets) {
159
+ const hit = covering.find((r) => {
160
+ const p = rulePrefix(r);
161
+ return p === "" || (ns !== "" && namespacePrefix(ns).startsWith(p));
162
+ });
163
+ if (hit) {
164
+ const d = describeNoncurrent(hit);
165
+ if (!used.includes(d))
166
+ used.push(d);
167
+ }
168
+ else {
169
+ uncovered.push(ns);
170
+ }
171
+ }
172
+ if (uncovered.length === 0 && covering.length > 0)
173
+ return { setting: "lifecycle", verdict: "ok", found: used.join("; "), unwaivable: false };
174
+ for (const r of covering) {
175
+ if (namespaces.length === 0) {
176
+ 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`);
177
+ continue;
178
+ }
179
+ for (const ns of uncovered) {
180
+ near.push(`rule "${ruleId(r)}" expires noncurrent versions but only under the prefix "${rulePrefix(r)}", which does not contain "${namespacePrefix(ns)}"`);
181
+ }
182
+ }
183
+ if (near.length > 0)
184
+ return fail(near.join("; "));
185
+ if (rules.length === 0)
186
+ return fail("the lifecycle configuration has no rules");
187
+ return fail(`none of the lifecycle configuration's ${rules.length} rule(s) expires noncurrent versions`);
188
+ }
189
+ function publicAccessBlock(input, bucket, expectedOwner) {
190
+ const fix = `aws s3api put-public-access-block --bucket ${bucket} --public-access-block-configuration BlockPublicAcls=true,IgnorePublicAcls=true,BlockPublicPolicy=true,RestrictPublicBuckets=true`;
191
+ const p = input.publicAccessBlock;
192
+ const none = { setting: "public_access_block", verdict: "fail", found: "the bucket has no public-access block configuration", unwaivable: false, fix };
193
+ if (isReadError(p)) {
194
+ if (p.error.code === "NoSuchPublicAccessBlockConfiguration")
195
+ return none;
196
+ return readFailure("public_access_block", "s3:GetBucketPublicAccessBlock", p, expectedOwner);
197
+ }
198
+ const cfg = p.PublicAccessBlockConfiguration;
199
+ if (!cfg)
200
+ return none;
201
+ const off = ["BlockPublicAcls", "IgnorePublicAcls", "BlockPublicPolicy", "RestrictPublicBuckets"].filter((k) => cfg[k] !== true);
202
+ if (off.length > 0)
203
+ return { setting: "public_access_block", verdict: "fail", found: `public-access block has ${off.join(", ")} off`, unwaivable: false, fix };
204
+ return { setting: "public_access_block", verdict: "ok", found: "all four public-access block settings are on", unwaivable: false };
205
+ }
206
+ const ENTITIES = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
207
+ function decode(s) {
208
+ return s.replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, (m, e) => {
209
+ if (e[0] === "#")
210
+ return String.fromCodePoint(e[1] === "x" || e[1] === "X" ? parseInt(e.slice(2), 16) : parseInt(e.slice(1), 10));
211
+ return ENTITIES[e] ?? m;
212
+ });
213
+ }
214
+ /** A tolerant parser for the small documents S3 returns. Exported for tests. */
215
+ export function parseXml(xml) {
216
+ const root = { name: "#root", children: [], text: "" };
217
+ const stack = [root];
218
+ const re = /<\?[\s\S]*?\?>|<!--[\s\S]*?-->|<(\/?)([A-Za-z_][\w:.-]*)[^>]*?(\/?)>|([^<]+)/g;
219
+ let m;
220
+ while ((m = re.exec(xml)) !== null) {
221
+ const top = stack[stack.length - 1];
222
+ if (m[4] !== undefined) {
223
+ top.text += decode(m[4]);
224
+ continue;
225
+ }
226
+ if (m[2] === undefined)
227
+ continue;
228
+ const name = m[2].replace(/^.*:/, "");
229
+ if (m[1] === "/") {
230
+ if (stack.length > 1)
231
+ stack.pop();
232
+ continue;
233
+ }
234
+ const node = { name, children: [], text: "" };
235
+ top.children.push(node);
236
+ if (m[3] !== "/")
237
+ stack.push(node);
238
+ }
239
+ return root;
240
+ }
241
+ const child = (n, name) => n?.children.find((c) => c.name === name);
242
+ const kids = (n, name) => n?.children.filter((c) => c.name === name) ?? [];
243
+ const text = (n, name) => {
244
+ const c = child(n, name);
245
+ return c === undefined ? undefined : c.text.trim();
246
+ };
247
+ const num = (n, name) => {
248
+ const t = text(n, name);
249
+ return t === undefined || t === "" ? undefined : Number(t);
250
+ };
251
+ const bool = (n, name) => {
252
+ const t = text(n, name);
253
+ return t === undefined ? undefined : t.toLowerCase() === "true";
254
+ };
255
+ function defined(o) {
256
+ for (const k of Object.keys(o))
257
+ if (o[k] === undefined)
258
+ delete o[k];
259
+ return o;
260
+ }
261
+ export function parseVersioning(xml) {
262
+ const doc = child(parseXml(xml), "VersioningConfiguration");
263
+ return defined({ Status: text(doc, "Status") || undefined });
264
+ }
265
+ export function parsePublicAccessBlock(xml) {
266
+ const doc = child(parseXml(xml), "PublicAccessBlockConfiguration");
267
+ if (!doc)
268
+ return {};
269
+ return {
270
+ PublicAccessBlockConfiguration: defined({
271
+ BlockPublicAcls: bool(doc, "BlockPublicAcls"),
272
+ IgnorePublicAcls: bool(doc, "IgnorePublicAcls"),
273
+ BlockPublicPolicy: bool(doc, "BlockPublicPolicy"),
274
+ RestrictPublicBuckets: bool(doc, "RestrictPublicBuckets"),
275
+ }),
276
+ };
277
+ }
278
+ export function parseLifecycle(xml) {
279
+ const doc = child(parseXml(xml), "LifecycleConfiguration");
280
+ const rules = kids(doc, "Rule").map((r) => {
281
+ const f = child(r, "Filter");
282
+ const and = child(f, "And");
283
+ const tag = (t) => defined({ Key: text(t, "Key"), Value: text(t, "Value") });
284
+ const e = child(r, "Expiration");
285
+ const nve = child(r, "NoncurrentVersionExpiration");
286
+ return defined({
287
+ ID: text(r, "ID"),
288
+ Status: text(r, "Status"),
289
+ Prefix: text(r, "Prefix"),
290
+ Filter: f
291
+ ? defined({
292
+ Prefix: text(f, "Prefix"),
293
+ Tag: child(f, "Tag") ? tag(child(f, "Tag")) : undefined,
294
+ ObjectSizeGreaterThan: num(f, "ObjectSizeGreaterThan"),
295
+ ObjectSizeLessThan: num(f, "ObjectSizeLessThan"),
296
+ And: and
297
+ ? defined({
298
+ Prefix: text(and, "Prefix"),
299
+ Tags: kids(and, "Tag").length > 0 ? kids(and, "Tag").map(tag) : undefined,
300
+ ObjectSizeGreaterThan: num(and, "ObjectSizeGreaterThan"),
301
+ ObjectSizeLessThan: num(and, "ObjectSizeLessThan"),
302
+ })
303
+ : undefined,
304
+ })
305
+ : undefined,
306
+ Expiration: e ? defined({ Days: num(e, "Days"), Date: text(e, "Date"), ExpiredObjectDeleteMarker: bool(e, "ExpiredObjectDeleteMarker") }) : undefined,
307
+ NoncurrentVersionExpiration: nve ? defined({ NoncurrentDays: num(nve, "NoncurrentDays"), NewerNoncurrentVersions: num(nve, "NewerNoncurrentVersions") }) : undefined,
308
+ });
309
+ });
310
+ return { Rules: rules };
311
+ }
312
+ /** A non-2xx S3 answer as a {@link ReadError}. */
313
+ export function parseS3Error(res) {
314
+ const code = text(child(parseXml(res.body), "Error"), "Code");
315
+ return { error: defined({ code, status: res.status }) };
316
+ }
317
+ const EMPTY_SHA256 = createHash("sha256").update("").digest("hex");
318
+ export function s3Url(target, subresource) {
319
+ if (target.endpoint !== undefined) {
320
+ return `${target.endpoint.replace(/\/+$/, "")}/${encodeURIComponent(target.bucket)}?${subresource}`;
321
+ }
322
+ // Virtual-hosted unless the name has a dot, which breaks the wildcard certificate.
323
+ if (target.bucket.includes("."))
324
+ return `https://s3.${target.region}.amazonaws.com/${encodeURIComponent(target.bucket)}?${subresource}`;
325
+ return `https://${target.bucket}.s3.${target.region}.amazonaws.com/?${subresource}`;
326
+ }
327
+ export async function readS3(target, options = {}) {
328
+ const credentials = await resolveAwsCredentials(target, options.chains ?? sdkCredentialChains);
329
+ const now = options.now ?? (() => new Date());
330
+ const wire = { ...options, ...(target.tls ? { tls: target.tls } : {}) };
331
+ const get = async (subresource) => {
332
+ const url = s3Url(target, subresource);
333
+ const base = { "x-amz-content-sha256": EMPTY_SHA256 };
334
+ if (target.expectedOwner)
335
+ base["x-amz-expected-bucket-owner"] = target.expectedOwner;
336
+ const headers = signV4({ method: "GET", url, headers: base, body: "", region: target.region, service: "s3", credentials, now: now() });
337
+ const res = await sendGet("aws", url, headers, target.endpoint, wire);
338
+ if (res.status === 404 && parseS3Error(res).error.code === "NoSuchBucket") {
339
+ throw new BucketCheckError(`s3: bucket ${target.bucket} does not exist; the check creates no bucket`);
340
+ }
341
+ return res;
342
+ };
343
+ const ok = (r) => r.status >= 200 && r.status < 300;
344
+ const v = await get("versioning");
345
+ const l = await get("lifecycle");
346
+ const p = await get("publicAccessBlock");
347
+ return {
348
+ versioning: ok(v) ? parseVersioning(v.body) : parseS3Error(v),
349
+ lifecycle: ok(l) ? parseLifecycle(l.body) : parseS3Error(l),
350
+ publicAccessBlock: ok(p) ? parsePublicAccessBlock(p.body) : parseS3Error(p),
351
+ };
352
+ }
353
+ export async function checkS3Bucket(target, options = {}) {
354
+ const input = await readS3(target, options);
355
+ const settings = evaluateS3(input, {
356
+ bucket: target.bucket,
357
+ namespaces: options.namespaces ?? [],
358
+ ...(target.expectedOwner ? { expectedOwner: target.expectedOwner } : {}),
359
+ ...(options.recoveryDays !== undefined ? { recoveryDays: options.recoveryDays } : {}),
360
+ });
361
+ return { store: "s3", bucket: target.bucket, namespaces: [...(options.namespaces ?? [])], correct: settings.every((f) => f.verdict === "ok"), settings };
362
+ }
@@ -0,0 +1,66 @@
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
+ export type BucketStore = "s3" | "gcs" | "azblob";
14
+ export type BucketVerdict = "ok" | "fail" | "unreadable";
15
+ export declare const BUCKET_SETTINGS: {
16
+ readonly s3: readonly ["versioning", "lifecycle", "public_access_block"];
17
+ readonly gcs: readonly ["object_versioning", "noncurrent_lifecycle", "public_access_prevention", "uniform_bucket_level_access"];
18
+ readonly azblob: readonly ["blob_versioning", "lifecycle_management", "public_access"];
19
+ };
20
+ export type BucketSetting = (typeof BUCKET_SETTINGS)[BucketStore][number];
21
+ export interface BucketFinding {
22
+ setting: BucketSetting;
23
+ verdict: BucketVerdict;
24
+ /** One clause quoting what the store has: "versioning is Suspended". */
25
+ found: string;
26
+ /**
27
+ * A lifecycle rule that deletes current records. No `allow_insecure`
28
+ * reaches it, in plunge or choudoufu, so a product must not offer one.
29
+ */
30
+ unwaivable: boolean;
31
+ /** The command or change that fixes this setting; absent when it passed. */
32
+ fix?: string;
33
+ }
34
+ export interface BucketReport {
35
+ store: BucketStore;
36
+ /** The bucket, or `account/container` for azblob. */
37
+ bucket: string;
38
+ /**
39
+ * The key prefixes the lifecycle rule was checked against. Empty means
40
+ * only a rule with no prefix filter is credited, the stricter answer that
41
+ * holds for every estate sharing the bucket.
42
+ */
43
+ namespaces: string[];
44
+ /** Every setting passed. */
45
+ correct: boolean;
46
+ /** One finding per setting, always all of them, in BUCKET_SETTINGS order. */
47
+ settings: BucketFinding[];
48
+ }
49
+ /** An API read that failed, recorded in the fixture shape: `{ "error": { "code": "AccessDenied", "status": 403 } }`. */
50
+ export interface ReadError {
51
+ error: {
52
+ code?: string;
53
+ status?: number;
54
+ };
55
+ }
56
+ export declare function isReadError(v: unknown): v is ReadError;
57
+ /**
58
+ * The findings a run refuses on once `waived` (the product's
59
+ * `allow_insecure` list) is applied: every finding that did not pass and is
60
+ * neither waived nor waivable. An unwaivable finding is refused whatever
61
+ * the list says. Init asks whether the bucket is correct and reads
62
+ * {@link BucketReport.correct}; this is for a product that also honours a
63
+ * waiver the way plunge and choudoufu do on open.
64
+ */
65
+ export declare function refusedFindings(report: BucketReport, waived: readonly string[]): BucketFinding[];
66
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bucket-check/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,MAAM,GAAG,YAAY,CAAC;AAEzD,eAAO,MAAM,eAAe;;;;CAI+B,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,wHAAwH;AACxH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,SAAS,CAEtD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,EAAE,CAEhG"}
@@ -0,0 +1,31 @@
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
+ export const BUCKET_SETTINGS = {
14
+ s3: ["versioning", "lifecycle", "public_access_block"],
15
+ gcs: ["object_versioning", "noncurrent_lifecycle", "public_access_prevention", "uniform_bucket_level_access"],
16
+ azblob: ["blob_versioning", "lifecycle_management", "public_access"],
17
+ };
18
+ export function isReadError(v) {
19
+ return typeof v === "object" && v !== null && "error" in v && typeof v.error === "object";
20
+ }
21
+ /**
22
+ * The findings a run refuses on once `waived` (the product's
23
+ * `allow_insecure` list) is applied: every finding that did not pass and is
24
+ * neither waived nor waivable. An unwaivable finding is refused whatever
25
+ * the list says. Init asks whether the bucket is correct and reads
26
+ * {@link BucketReport.correct}; this is for a product that also honours a
27
+ * waiver the way plunge and choudoufu do on open.
28
+ */
29
+ export function refusedFindings(report, waived) {
30
+ return report.settings.filter((f) => f.verdict !== "ok" && (f.unwaivable || !waived.includes(f.setting)));
31
+ }
@@ -0,0 +1,27 @@
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
+ import { type Fetcher, type TlsOptions, type WireResponse } from "../cloud-lister/transport.js";
12
+ import type { WireCall } from "../cloud-lister/guard.js";
13
+ export declare class BucketCheckError extends Error {
14
+ constructor(message: string);
15
+ }
16
+ export interface WireOptions {
17
+ /** Replaces node's http/https; tests answer from a route table. */
18
+ fetcher?: Fetcher;
19
+ tls?: TlsOptions;
20
+ /** Called with each call before it is sent (tests record with it). */
21
+ onSend?: (call: WireCall) => void;
22
+ }
23
+ /** One GET, refused unless it goes to `pinnedOrigin` when that is set. */
24
+ export declare function sendGet(substrate: WireCall["substrate"], url: string, headers: Record<string, string>, pinnedOrigin: string | undefined, options: WireOptions): Promise<WireResponse>;
25
+ /** `"tofu-records/prod"` as `"tofu-records/prod/"`; `""` stays `""`. Same rule as choudoufu's staterecord.NamespacePrefix. */
26
+ export declare function namespacePrefix(prefix: string): string;
27
+ //# sourceMappingURL=wire.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/bucket-check/wire.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAe,KAAK,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC1G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAC;CACnC;AAED,0EAA0E;AAC1E,wBAAsB,OAAO,CAC3B,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,EAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,YAAY,CAAC,CAOvB;AAED,8HAA8H;AAC9H,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGtD"}