@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
@@ -16,6 +16,10 @@ import { createSnapshotTool, createDiffTool } from "./lifecycle-tools";
16
16
  import { setGateOrigin } from "../../lifecycle/gate-origin";
17
17
  import { createOpListTool, createOpRunTool, createOpStatusTool, createOpApproveTool, createOpReportTool } from "./op-tools";
18
18
  import { buildResourcesList, handleResourcesRead } from "./resource-handlers";
19
+ import { createLedgerTools } from "./ledger-tools";
20
+ import { createReportTools } from "./report-tools";
21
+ import { activeProductMcpHook, productMcpContext, productToolsServed, type ProductMcpHook } from "./product-tools";
22
+ import { MUTATING_CORE_TOOLS, READ_ONLY_CORE_TOOLS, ReadOnlyRegistrationError, servesContributedTool } from "./read-only";
19
23
  import { CHANT_VERSION } from "../version";
20
24
 
21
25
  /**
@@ -94,6 +98,22 @@ export function namespacedResourceUri(lexicon: string, uri: string): string {
94
98
  return `${base}${uri}`;
95
99
  }
96
100
 
101
+ /** What a read-only server says about itself in `initialize`'s `instructions` (chant#4543). */
102
+ export const READ_ONLY_INSTRUCTIONS =
103
+ "This chant server is read-only: it serves the ledger, the workspace graph, runs, gates and snapshots, and no tool here runs an Op, resolves a gate or writes anything.";
104
+
105
+ /** The `lint` a read-only server serves: the same tool with no `fix` (chant#4543). */
106
+ const readOnlyLintTool: ToolDefinition = {
107
+ ...lintTool,
108
+ description: `${lintTool.description}. This server is read-only: it reports issues and fixes none.`,
109
+ inputSchema: { ...lintTool.inputSchema, properties: { path: lintTool.inputSchema.properties.path } },
110
+ };
111
+
112
+ async function handleReadOnlyLint(params: Record<string, unknown>): Promise<unknown> {
113
+ if (params.fix === true) throw new Error("fix is not available on a read-only server: run chant lint --fix at a shell");
114
+ return handleLint({ ...params, fix: false });
115
+ }
116
+
97
117
  /**
98
118
  * MCP Server implementation
99
119
  */
@@ -105,6 +125,8 @@ export class McpServer {
105
125
  private instructions: string | undefined;
106
126
  /** The `clientInfo` the client gave on `initialize`, for a request that carries none in `_meta` (#2707). */
107
127
  private clientInfo: McpClientInfo | undefined;
128
+ /** `chant serve mcp --read-only` (chant#4543): only tools that change nothing are registered. */
129
+ readonly readOnly: boolean;
108
130
 
109
131
  /**
110
132
  * `options.instructions` is sent as the `initialize` result's
@@ -115,37 +137,62 @@ export class McpServer {
115
137
  * `options.workspace` names the directory the server serves (#2707). When
116
138
  * it is at or inside a declared workspace, the workspace read-contract and
117
139
  * record-write tools are served too.
140
+ *
141
+ * `options.readOnly` (`chant serve mcp --read-only`, chant#4543) serves
142
+ * only the tools that change nothing: the core tools in
143
+ * `READ_ONLY_CORE_TOOLS` (./read-only.ts), `lint` without `fix`, the
144
+ * workspace reads without the writes, and the plugin tools that declare
145
+ * `readOnly: true`.
146
+ *
147
+ * `options.product` (chant#4555) is a CI product's tool hook
148
+ * (./product-tools.ts): its tools are registered as `<product>:<name>`,
149
+ * under the same read-only rule as a plugin's, and a read-only server
150
+ * refuses to start with one named as a write. With a hook and no
151
+ * `readOnly`, the server is read-only unless the hook says otherwise.
118
152
  */
119
- constructor(plugins?: LexiconPlugin[], options: { instructions?: string; workspace?: WorkspaceToolsOptions } = {}) {
153
+ constructor(plugins?: LexiconPlugin[], options: { instructions?: string; workspace?: WorkspaceToolsOptions; readOnly?: boolean; product?: ProductMcpHook } = {}) {
120
154
  this.plugins = plugins ?? [];
121
- this.instructions = options.instructions;
155
+ const product = options.product;
156
+ this.readOnly = options.readOnly ?? (product ? product.readOnly !== false : false);
157
+ const said = [options.instructions, product?.instructions].filter((s): s is string => s !== undefined);
158
+ this.instructions = this.readOnly
159
+ ? [...said, READ_ONLY_INSTRUCTIONS].join("\n\n")
160
+ : said.length > 0 ? said.join("\n\n") : undefined;
161
+ const cwd = options.workspace?.cwd ?? process.cwd();
122
162
  // Register core tools
123
- this.registerTool(buildTool, handleBuild);
124
- this.registerTool(lintTool, handleLint);
125
- this.registerTool(importTool, handleImport);
126
- this.registerTool(explainTool, handleExplain);
127
- this.registerTool(scaffoldTool, createScaffoldHandler(plugins ?? []));
128
- this.registerTool(searchTool, createSearchHandler(plugins ?? []));
129
- this.registerTool(compositesTool, createCompositesHandler(plugins ?? []));
163
+ this.registerCoreTool(buildTool, handleBuild);
164
+ if (this.readOnly) this.registerCoreTool(readOnlyLintTool, handleReadOnlyLint);
165
+ else this.registerCoreTool(lintTool, handleLint);
166
+ this.registerCoreTool(importTool, handleImport);
167
+ this.registerCoreTool(explainTool, handleExplain);
168
+ this.registerCoreTool(scaffoldTool, createScaffoldHandler(plugins ?? []));
169
+ this.registerCoreTool(searchTool, createSearchHandler(plugins ?? []));
170
+ this.registerCoreTool(compositesTool, createCompositesHandler(plugins ?? []));
130
171
  // The capability catalog (#4375), the read contract's capabilities document.
131
- this.registerTool(capabilitiesTool, createCapabilitiesHandler(options.workspace?.cwd ?? process.cwd(), options.workspace?.chantCommand));
172
+ this.registerCoreTool(capabilitiesTool, createCapabilitiesHandler(cwd, options.workspace?.chantCommand));
132
173
 
133
174
  // Register state tools
134
175
  const snapshot = createSnapshotTool(plugins ?? []);
135
- this.registerTool(snapshot.definition, snapshot.handler);
176
+ this.registerCoreTool(snapshot.definition, snapshot.handler);
136
177
 
137
178
  const diff = createDiffTool(plugins ?? []);
138
- this.registerTool(diff.definition, diff.handler);
179
+ this.registerCoreTool(diff.definition, diff.handler);
139
180
 
140
181
  // Register Op tools
141
182
  for (const factory of [createOpListTool, createOpRunTool, createOpStatusTool, createOpApproveTool, createOpReportTool]) {
142
183
  const t = factory();
143
- this.registerTool(t.definition, t.handler);
184
+ this.registerCoreTool(t.definition, t.handler);
144
185
  }
145
186
 
187
+ // The ledger read contract and chant query (chant#4543), in both modes.
188
+ for (const t of createLedgerTools({ cwd, chantCommand: options.workspace?.chantCommand })) this.registerCoreTool(t.definition, t.handler);
189
+
190
+ // The report store (chant#4555), in both modes: the product hook's store, else ci.reportUrl.
191
+ for (const t of createReportTools({ cwd, ...(product?.reportUrl ? { reportUrl: product.reportUrl } : {}) })) this.registerCoreTool(t.definition, t.handler);
192
+
146
193
  // Workspace reads and record writes (#2707), inside a declared workspace only.
147
194
  if (options.workspace && findWorkspaceRoot(options.workspace.cwd)) {
148
- for (const t of createWorkspaceTools(options.workspace)) this.registerTool(t.definition, t.handler);
195
+ for (const t of createWorkspaceTools(options.workspace)) this.registerCoreTool(t.definition, t.handler);
149
196
  }
150
197
 
151
198
  // Register plugin contributions
@@ -155,6 +202,13 @@ export class McpServer {
155
202
  this.registerPluginResources(plugin);
156
203
  }
157
204
  }
205
+
206
+ // A CI product's tools (chant#4555), read-only by default as chant#4543 rules for contributed tools.
207
+ if (product) {
208
+ for (const tool of productToolsServed(product, productMcpContext(product, cwd, this.readOnly))) {
209
+ this.registerTool({ name: namespacedToolName(product.product, tool.name), description: tool.description, inputSchema: tool.inputSchema }, tool.handler);
210
+ }
211
+ }
158
212
  }
159
213
 
160
214
  /**
@@ -171,6 +225,8 @@ export class McpServer {
171
225
  private registerPluginTools(plugin: LexiconPlugin): void {
172
226
  const tools = plugin.mcpTools?.() ?? [];
173
227
  for (const tool of tools) {
228
+ // A read-only server serves a plugin tool only when it says it changes nothing (chant#4543).
229
+ if (!servesContributedTool(tool, this.readOnly)) continue;
174
230
  this.registerTool(
175
231
  {
176
232
  name: namespacedToolName(plugin.name, tool.name),
@@ -202,6 +258,19 @@ export class McpServer {
202
258
  }
203
259
  }
204
260
 
261
+ /**
262
+ * Register a core tool. On a read-only server a mutating core tool is
263
+ * left out, and a core tool on neither list of ./read-only.ts is refused
264
+ * with an error, so a new tool cannot reach a read-only server unsorted.
265
+ */
266
+ private registerCoreTool(definition: ToolDefinition, handler: ToolHandler): void {
267
+ if (this.readOnly && !READ_ONLY_CORE_TOOLS.has(definition.name)) {
268
+ if (MUTATING_CORE_TOOLS.has(definition.name)) return;
269
+ throw new ReadOnlyRegistrationError(definition.name);
270
+ }
271
+ this.registerTool(definition, handler);
272
+ }
273
+
205
274
  /**
206
275
  * Register a tool with its handler
207
276
  */
@@ -390,7 +459,7 @@ export class McpServer {
390
459
  /**
391
460
  * Start MCP server, loading plugins from the project
392
461
  */
393
- export async function startMcpServer(): Promise<void> {
462
+ export async function startMcpServer(options: { readOnly?: boolean } = {}): Promise<void> {
394
463
  let plugins: LexiconPlugin[] = [];
395
464
  try {
396
465
  const { resolveProjectLexicons, loadPlugins } = await import("../plugins");
@@ -400,6 +469,11 @@ export async function startMcpServer(): Promise<void> {
400
469
  // Start without plugins if resolution fails
401
470
  }
402
471
 
403
- const server = new McpServer(plugins, { workspace: { cwd: process.cwd() } });
472
+ const product = activeProductMcpHook();
473
+ const server = new McpServer(plugins, {
474
+ workspace: { cwd: process.cwd() },
475
+ ...(options.readOnly ? { readOnly: true } : {}),
476
+ ...(product ? { product } : {}),
477
+ });
404
478
  server.start();
405
479
  }
@@ -49,13 +49,18 @@ export function detectPackageManager(dir?: string): "bun" | "npm" {
49
49
  return "npm";
50
50
  }
51
51
 
52
- /** The MCP registration chant writes: one stdio server named `chant`. */
53
- export function generateMcpConfig(pm: "bun" | "npm"): string {
52
+ /**
53
+ * The MCP registration chant writes: one stdio server named `chant`. With
54
+ * `readOnly` (`chant init --mcp-read-only`, chant#4543) it registers
55
+ * `chant serve mcp --read-only`, which serves only the tools that change
56
+ * nothing.
57
+ */
58
+ export function generateMcpConfig(pm: "bun" | "npm", options: { readOnly?: boolean } = {}): string {
54
59
  const config = {
55
60
  mcpServers: {
56
61
  chant: {
57
62
  command: pm === "bun" ? "bunx" : "npx",
58
- args: ["chant", "serve", "mcp"],
63
+ args: ["chant", "serve", "mcp", ...(options.readOnly ? ["--read-only"] : [])],
59
64
  },
60
65
  },
61
66
  };
@@ -74,6 +74,7 @@ const BOOLEAN_FLAGS = new Set([
74
74
  "--unsigned",
75
75
  "--in-place",
76
76
  "--require-runner-start",
77
+ "--require-clouds",
77
78
  "--no-push",
78
79
  "--list",
79
80
  "--no-require-review",
@@ -84,6 +85,8 @@ const BOOLEAN_FLAGS = new Set([
84
85
  "--fail-on-drift",
85
86
  "--durable-requests",
86
87
  "--skip-mcp",
88
+ "--read-only",
89
+ "--mcp-read-only",
87
90
  "--current",
88
91
  "--uncommitted",
89
92
  "--allow-code",
@@ -94,6 +97,7 @@ const BOOLEAN_FLAGS = new Set([
94
97
  "--generated",
95
98
  "--decide",
96
99
  "--record-plans",
100
+ "--waves-outcome",
97
101
  "--loopback",
98
102
  "--artifacts",
99
103
  "--push",
@@ -139,6 +143,8 @@ export function parseArgs(args: string[]): ParsedArgs {
139
143
  reportFile: undefined,
140
144
  skill: undefined,
141
145
  skipMcp: undefined,
146
+ readOnly: undefined,
147
+ mcpReadOnly: undefined,
142
148
  src: undefined,
143
149
  env: undefined,
144
150
  };
@@ -325,6 +331,10 @@ export function parseArgs(args: string[]): ParsedArgs {
325
331
  result.skill = args[++i];
326
332
  } else if (arg === "--skip-mcp") {
327
333
  result.skipMcp = true;
334
+ } else if (arg === "--read-only") {
335
+ result.readOnly = true;
336
+ } else if (arg === "--mcp-read-only") {
337
+ result.mcpReadOnly = true;
328
338
  } else if (arg === "--src") {
329
339
  result.src = args[++i];
330
340
  } else if (arg === "--env") {
@@ -379,6 +389,14 @@ export function parseArgs(args: string[]): ParsedArgs {
379
389
  result.digestFile = args[++i];
380
390
  } else if (arg === "--seed-outputs") {
381
391
  (result.seedOutputs ??= []).push(args[++i]);
392
+ } else if (arg === "--keep") {
393
+ // `chant lock --keep --pr <n>` (#4588): keep the locks the pull request's plan took, as `/<product> lock` asks.
394
+ result.keepLocks = true;
395
+ } else if (arg === "--runs" || arg === "--plans" || arg === "--wave-outputs") {
396
+ // `chant components plan-wave|apply-wave` (#4588): the op-waves runs and plans files, and the outputs the waves hand on.
397
+ const value = args[++i];
398
+ if (value === undefined || value.startsWith("-")) throw new Error(`${arg} needs a file`);
399
+ result[({ "--runs": "runsFile", "--plans": "plansFile", "--wave-outputs": "waveOutputs" } as const)[arg]] = value;
382
400
  } else if (arg === "--detail") {
383
401
  result.detail = Number(args[++i]);
384
402
  } else if (arg === "--lens") {
@@ -434,6 +452,8 @@ export function parseArgs(args: string[]): ParsedArgs {
434
452
  result.decide = true;
435
453
  } else if (arg === "--record-plans") {
436
454
  result.recordPlans = true;
455
+ } else if (arg === "--waves-outcome") {
456
+ result.wavesOutcome = true;
437
457
  } else if (arg === "--group") {
438
458
  const raw = args[++i];
439
459
  if (!raw || raw.startsWith("-")) throw new Error("--group needs a job group's name: --group <name>");
@@ -445,8 +465,9 @@ export function parseArgs(args: string[]): ParsedArgs {
445
465
  result.share = share;
446
466
  } else if (arg === "--target") {
447
467
  // `chant components fan-out|run --components --target <component>:<address>` (#4300), repeatable.
468
+ // `chant components pr-plan --target <address>` (#4620) also takes a bare address; fan-out and run refuse one.
448
469
  const raw = args[++i];
449
- if (!raw || raw.startsWith("-") || !raw.includes(":")) throw new Error("--target needs a component and an address: --target <component>:<address>");
470
+ if (!raw || raw.startsWith("-")) throw new Error("--target needs an address: --target <component>:<address>, or on pr-plan --target <address>");
450
471
  (result.targets ??= []).push(raw);
451
472
  } else if (arg === "--canary") {
452
473
  const raw = args[++i];
@@ -466,6 +487,9 @@ export function parseArgs(args: string[]): ParsedArgs {
466
487
  } else if (arg === "--forge") {
467
488
  result.forge = args[++i];
468
489
  if (!result.forge || result.forge.startsWith("-")) throw new Error("--forge needs a forge: --forge github|gitlab|forgejo");
490
+ } else if (arg === "--require-clouds") {
491
+ // `chant ci forge-check --require-clouds` (#4608).
492
+ result.requireClouds = true;
469
493
  } else if (arg === "--require-review") {
470
494
  result.requireReview = true;
471
495
  } else if (arg === "--list") {
@@ -475,6 +499,10 @@ export function parseArgs(args: string[]): ParsedArgs {
475
499
  // `chant lock --stage plan|apply|lock` (#4293): how the lock was taken.
476
500
  result.lockStage = args[++i];
477
501
  if (!result.lockStage || result.lockStage.startsWith("-")) throw new Error("--stage needs plan, apply or lock: --stage <stage>");
502
+ } else if (arg === "--alive") {
503
+ // `chant lock --alive <run>` (#4552): print whether a run holding rows or the repo lock tag still runs.
504
+ result.aliveRun = args[++i];
505
+ if (!result.aliveRun || result.aliveRun.startsWith("-")) throw new Error("--alive needs a run id: --alive <run>");
478
506
  } else if (arg === "--from-report") {
479
507
  // `chant lock --from-report <pr-plan.json>` (#4293): lock the components a pull-request report lists.
480
508
  result.fromReport = args[++i];
@@ -482,7 +510,7 @@ export function parseArgs(args: string[]): ParsedArgs {
482
510
  } else if (arg === "--report-url") {
483
511
  // `chant components pr-plan|pr-apply --report-url <url>` (#4007).
484
512
  const url = args[++i];
485
- if (!url || url.startsWith("-")) throw new Error("--report-url needs a URL: --report-url s3://<bucket>/<prefix> or file://<directory>");
513
+ if (!url || url.startsWith("-")) throw new Error("--report-url needs a URL: --report-url s3://<bucket>/<prefix>, gs://<bucket>/<prefix>, az://<account>/<container>/<prefix> or file://<directory>");
486
514
  result.reportUrl = url;
487
515
  } else if (arg === "--result") {
488
516
  // `chant components pr-post --result <result>` (#4295): the plan job's own result, which fails the status when it failed.
@@ -509,12 +537,20 @@ export function parseArgs(args: string[]): ParsedArgs {
509
537
  } else if (arg === "--before-merge") {
510
538
  // `chant components pr-apply --before-merge` (#4301, ws-106): apply an open pull request's plan from its head.
511
539
  result.beforeMerge = true;
540
+ } else if (arg === "--requires") {
541
+ // `chant components pr-apply --before-merge --requires approved,checks` (#4607): the checks a product's `apply.requires` names.
542
+ const value = args[++i];
543
+ if (value === undefined || value.startsWith("-")) throw new Error("--requires needs a list of checks: --requires approved,mergeable,undiverged,checks");
544
+ result.requires = value.split(",").map((v) => v.trim()).filter(Boolean);
512
545
  } else if (arg === "--apply-before-merge") {
513
546
  // `chant build --pr-loop --apply-before-merge` and `chant ci run apply --apply-before-merge` (#4301): the job that applies before merge.
514
547
  result.applyBeforeMerge = true;
515
548
  } else if (arg === "--apply-on-merge") {
516
549
  // `chant build --pr-loop --apply-on-merge` and `chant ci serve --apply-on-merge` (#4168): opt into applying on merge.
517
550
  result.applyOnMerge = true;
551
+ } else if (arg === "--preview-comment") {
552
+ // `chant build --pr-loop --preview-comment` (#4620): the job that answers `/<product> <plan word>` with a preview.
553
+ result.previewComment = true;
518
554
  } else if (arg === "--pr-env") {
519
555
  // `chant build --pr-loop --pr-env` (#4298): add the pull request environment's jobs.
520
556
  result.prEnv = true;
@@ -1005,6 +1041,10 @@ export function parseArgs(args: string[]): ParsedArgs {
1005
1041
  // #4526 — `chant lifecycle diff <env> --index <ref>`.
1006
1042
  result.index = args[++i];
1007
1043
  if (!result.index || result.index.startsWith("-")) throw new Error("--index needs a value: --index <file> for workspace adopt-lineage, --index <scope key>[@<version>] for search and lifecycle diff");
1044
+ } else if (arg === "--adopt") {
1045
+ // #4537 — `chant run --components <name> --env <env> --adopt <file>`: adopt the adoption file's resources into the component's stack.
1046
+ result.adopt = args[++i];
1047
+ if (!result.adopt || result.adopt.startsWith("-")) throw new Error("--adopt needs an adoption file: --adopt <file>");
1008
1048
  } else if (arg === "--adopt-out") {
1009
1049
  // #4536 — `chant import --index <ref> --adopt-out <file>`: write the adoption file (`adopt: v1`) for what was imported.
1010
1050
  result.adoptOut = args[++i];
@@ -131,6 +131,10 @@ export interface ParsedArgs {
131
131
  * before anything parsed it, so there was no way to decline the write.
132
132
  */
133
133
  skipMcp?: boolean;
134
+ /** `chant serve mcp --read-only` (chant#4543): serve only the tools that change nothing. */
135
+ readOnly?: boolean;
136
+ /** `chant init --mcp-read-only` (chant#4543): write `.mcp.json` registering `chant serve mcp --read-only`. */
137
+ mcpReadOnly?: boolean;
134
138
  /** `chant import --type <ResourceType>` selector */
135
139
  selectType?: string;
136
140
  /** `chant import --name <name>` selector */
@@ -170,6 +174,8 @@ export interface ParsedArgs {
170
174
  /** `chant workspace adopt-lineage --index <file>` (#2551): a cached hash index. `chant search --index <ref>` (#4525) and `chant lifecycle diff <env> --index <ref>` (#4526): an index version. */
171
175
  /** `chant import --index <ref> --adopt-out <file>` (#4536): where to write the adoption file. */
172
176
  adoptOut?: string;
177
+ /** `chant run --components <name> --env <env> --adopt <file>` (#4537): the adoption file whose resources the component's deploy step adopts into its stack. */
178
+ adopt?: string;
173
179
  index?: string;
174
180
  /** `chant workspace versions --available` (#2551): list each git template's version tags. */
175
181
  available?: boolean;
@@ -312,6 +318,8 @@ export interface ParsedArgs {
312
318
  decide?: boolean;
313
319
  /** `chant run wave --record-plans` (#3684) — plan every wave at a pull request's head and record the digests for a `pr-review` gate. */
314
320
  recordPlans?: boolean;
321
+ /** `chant run wave --waves-outcome` (#4617) — print how every wave job's outcome file adds up: the outcome a control dispatch carries. */
322
+ wavesOutcome?: boolean;
315
323
  /** `chant run wave --share <i>` (#3679) — apply share `i` of a decided wide wave. */
316
324
  share?: number;
317
325
  /** `chant run wave --group <name>` (#3914) — apply one job group's runs of a decided wave. */
@@ -320,6 +328,9 @@ export interface ParsedArgs {
320
328
  * `chant components fan-out --target <component>:<address>` and `chant run
321
329
  * --components --target ...` (#4300), repeatable: the addresses a
322
330
  * component's steps narrow to. Raw values; `parseComponentTargets` groups them.
331
+ * `chant components pr-plan --target <address>` (#4620) takes a bare
332
+ * address too, for every member the pull request plans
333
+ * (`prPlanTargets`).
323
334
  */
324
335
  targets?: string[];
325
336
  /** `chant components fan-out --canary <component>` (#3049), repeatable — components that form wave 1. */
@@ -336,6 +347,8 @@ export interface ParsedArgs {
336
347
  lockStage?: string;
337
348
  /** `chant lock --from-report <file>` (#4293): lock the components a `pr-plan.json` lists. */
338
349
  fromReport?: string;
350
+ /** `chant lock --alive <run>` (#4552): print `alive` or `dead` for a run that holds rows or the repo lock tag. */
351
+ aliveRun?: string;
339
352
  /** Every `--pr <n>`, in order: `chant release compose` (#4168 4.3) takes several. */
340
353
  prs?: number[];
341
354
  /** `chant release cut --channel <tag>` (#4168 4.3): the tag a publish of the release moves in place of `latest`. */
@@ -346,6 +359,8 @@ export interface ParsedArgs {
346
359
  * read from the CI job's environment.
347
360
  */
348
361
  forge?: string;
362
+ /** `chant ci forge-check --require-clouds` (#4608): fail a cloud left unchecked for want of credentials too. */
363
+ requireClouds?: boolean;
349
364
  /**
350
365
  * `chant components pr-apply --require-review` (#3183) — count an approval
351
366
  * only when its approver has a standing approving review on the pull
@@ -388,12 +403,20 @@ export interface ParsedArgs {
388
403
  * mergeable, undiverged and green.
389
404
  */
390
405
  beforeMerge?: boolean;
406
+ /**
407
+ * `chant components pr-apply --before-merge --requires <list>` (#4607): the
408
+ * requires checks to ask, a comma list of approved, mergeable, undiverged
409
+ * and checks. Absent: all four. A check left out passes as "not required".
410
+ */
411
+ requires?: string[];
391
412
  /**
392
413
  * `chant build --pr-loop --apply-before-merge` and `chant ci run apply
393
414
  * --apply-before-merge` (#4301): the pipeline's apply job applies an open
394
415
  * pull request before it merges, and a merge records.
395
416
  */
396
417
  applyBeforeMerge?: boolean;
418
+ /** `chant build --pr-loop --preview-comment` (#4620): a job answers `/<product> <plan word>` by previewing the pull request's head again. */
419
+ previewComment?: boolean;
397
420
  /** `chant build --pr-loop --pr-build` (#4088) — build and lint before pr-plan and pr-apply. */
398
421
  prBuild?: boolean;
399
422
  /** `chant ci serve --build-command <line>` (#4169) — the line that builds a commit a `ci/build/<sha>` tag asks for, in a worktree of it. */
@@ -759,6 +782,18 @@ export interface ParsedArgs {
759
782
  digestFile?: string;
760
783
  /** `chant run --components <name> --seed-outputs <file>` (repeatable) — before the run, load each JSON outputs file (as written by `--dump-outputs`) and seed cross-component/cross-stack resolution with it, so a `stackOutput()`/`@<dep>.publish.*` reference to a component that ran in an earlier job resolves. */
761
784
  seedOutputs?: string[];
785
+ /**
786
+ * `chant lock --keep --pr <n>` (#4588): take again, at stage `lock`, every
787
+ * target lock the pull request holds now, so the locks its plan took stay
788
+ * until it closes or `chant unlock`. What `/<product> lock` runs.
789
+ */
790
+ keepLocks?: boolean;
791
+ /** `chant components plan-wave|apply-wave --runs <file>` (#4588): the runs file `chant run wave` writes, `{runs}`. */
792
+ runsFile?: string;
793
+ /** `chant components plan-wave|apply-wave --plans <file>` (#4588): the wave's plans file, `{plans}`. */
794
+ plansFile?: string;
795
+ /** `chant components plan-wave|apply-wave --wave-outputs <file>` (#4588): the outputs earlier waves' components left; apply-wave adds its own. */
796
+ waveOutputs?: string;
762
797
  /** `chant build --fold` (#1022/#1023, epic #1019) — opt-in: fold source modules statically instead of importing/running them; folds resource constructors and composite factory calls, falling back to run per-file for anything the folder can't represent (a cross-file-only reference, a re-export, `export default`, …). Also settable project-wide via `chant.config.ts`'s `build.fold: true`; the flag always wins when set. Default (flag omitted): the existing run path, unchanged. */
763
798
  fold?: boolean;
764
799
  /** `chant build --sandbox` (#1045 Phase 2) — opt-in: run-fallback source files (or every file, without `--fold`) execute together, isolated, in one sandboxed child process instead of in-process. Also settable project-wide via `chant.config.ts`'s `build.sandbox: true`; the flag always wins when set. Default (flag omitted): in-process execution, unchanged. */
@@ -1,70 +1,127 @@
1
1
  /**
2
- * behold#1029: AWS Signature Version 4 for the lister's one AWS call.
2
+ * AWS Signature Version 4, chant's one AWS signer (behold#1029, #4554).
3
3
  *
4
- * Signed by hand with node:crypto rather than through the AWS SDK, so the
5
- * lister builds no SDK client (no client to hold a mutating command, no
6
- * default provider chain) and adds no dependency. Only what Cloud Control's
7
- * JSON protocol needs: a POST to `/` with no query string.
4
+ * Signed by hand with node:crypto rather than through the AWS SDK, so no
5
+ * SDK client is built (no client to hold a mutating command, no default
6
+ * provider chain) and no dependency is added. The cloud lister's Cloud
7
+ * Control calls, the object-store S3 client (../object-store/s3.ts), the
8
+ * snapshot store's S3 medium (../lifecycle/snapshot-store-s3.ts), the
9
+ * terraform lexicon's state client and the aws lexicon's Cloud Control and
10
+ * CloudFormation reads (#4583) all sign through {@link signV4}, and S3's
11
+ * presigned links through {@link presignV4}.
8
12
  */
9
13
 
10
14
  import { createHash, createHmac } from "node:crypto";
11
15
  import type { AwsStaticCredentials } from "./credentials";
12
16
 
13
- function sha256Hex(data: string): string {
14
- return createHash("sha256").update(data, "utf8").digest("hex");
17
+ /** The SHA-256 of an empty body, hex. */
18
+ export const EMPTY_PAYLOAD_SHA256 = "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855";
19
+
20
+ /** A body's SHA-256, hex. */
21
+ export function sha256Hex(data: string | Uint8Array): string {
22
+ return typeof data === "string" ? createHash("sha256").update(data, "utf8").digest("hex") : createHash("sha256").update(data).digest("hex");
15
23
  }
16
24
 
17
25
  function hmac(key: Buffer | string, data: string): Buffer {
18
26
  return createHmac("sha256", key).update(data, "utf8").digest();
19
27
  }
20
28
 
29
+ /** RFC 3986 percent-encoding, as SigV4 signs a query and S3 a key. */
30
+ export function encodeRfc3986(value: string): string {
31
+ return encodeURIComponent(value).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
32
+ }
33
+
21
34
  /** `20261026T120000Z` and `20261026` for a date. */
22
35
  export function amzDates(now: Date): { amzDate: string; dateStamp: string } {
23
36
  const iso = now.toISOString().replace(/[-:]/g, "").replace(/\.\d{3}/, "");
24
37
  return { amzDate: iso, dateStamp: iso.slice(0, 8) };
25
38
  }
26
39
 
40
+ /** The key a day's signatures for one region and service are made with. */
41
+ function signingKey(secret: string, dateStamp: string, region: string, service: string): Buffer {
42
+ return hmac(hmac(hmac(hmac(`AWS4${secret}`, dateStamp), region), service), "aws4_request");
43
+ }
44
+
45
+ /** A URL's query in canonical order, each name and value RFC 3986 encoded. */
46
+ function canonicalQuery(url: URL): string {
47
+ const pairs: Array<[string, string]> = [];
48
+ url.searchParams.forEach((v, k) => pairs.push([encodeRfc3986(k), encodeRfc3986(v)]));
49
+ pairs.sort((a, b) => (a[0] === b[0] ? (a[1] < b[1] ? -1 : a[1] > b[1] ? 1 : 0) : a[0] < b[0] ? -1 : 1));
50
+ return pairs.map(([k, v]) => `${k}=${v}`).join("&");
51
+ }
52
+
27
53
  /**
28
54
  * The headers to send, `Authorization` included. `headers` must not already
29
- * hold `host` or `x-amz-date`; they are added here.
55
+ * hold `host` or `x-amz-date`; they are added here, and `host` is kept in
56
+ * the answer unless `omitHost`. The URL's pathname is the canonical URI as
57
+ * it stands, so a caller encodes a key once (S3's rule) before it signs.
58
+ * `payloadHash` stands in for hashing `body`; `contentSha256` sends it as
59
+ * `x-amz-content-sha256`, which S3 requires. A header named (any case) in
60
+ * `unsignedHeaders` is sent but left out of the signature, for headers a
61
+ * proxy or agent may rewrite in transit, such as `user-agent` (#4583).
30
62
  */
31
63
  export function signV4(input: {
32
64
  method: string;
33
65
  url: string;
34
66
  headers: Record<string, string>;
35
- body: string;
67
+ body: string | Uint8Array;
36
68
  region: string;
37
69
  service: string;
38
70
  credentials: AwsStaticCredentials;
39
71
  now: Date;
72
+ payloadHash?: string;
73
+ contentSha256?: boolean;
74
+ omitHost?: boolean;
75
+ unsignedHeaders?: Iterable<string>;
40
76
  }): Record<string, string> {
41
77
  const url = new URL(input.url);
42
78
  const { amzDate, dateStamp } = amzDates(input.now);
79
+ const payloadHash = input.payloadHash ?? (input.body.length === 0 ? EMPTY_PAYLOAD_SHA256 : sha256Hex(input.body));
43
80
  const headers: Record<string, string> = {};
44
- for (const [k, v] of Object.entries(input.headers)) headers[k.toLowerCase()] = v.trim();
81
+ for (const [k, v] of Object.entries(input.headers)) headers[k.toLowerCase()] = v.trim().replace(/\s+/g, " ");
45
82
  headers.host = url.host;
46
83
  headers["x-amz-date"] = amzDate;
84
+ if (input.contentSha256) headers["x-amz-content-sha256"] = payloadHash;
47
85
  if (input.credentials.sessionToken) headers["x-amz-security-token"] = input.credentials.sessionToken;
48
- const payloadHash = sha256Hex(input.body);
49
86
 
50
- const names = Object.keys(headers).sort();
87
+ const unsigned = new Set([...(input.unsignedHeaders ?? [])].map((n) => n.toLowerCase()));
88
+ const names = Object.keys(headers).filter((n) => !unsigned.has(n)).sort();
51
89
  const canonicalHeaders = names.map((n) => `${n}:${headers[n]}\n`).join("");
52
90
  const signedHeaders = names.join(";");
53
- const canonicalQuery = [...url.searchParams.entries()]
54
- .map(([k, v]) => [encodeURIComponent(k), encodeURIComponent(v)])
55
- .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
56
- .map(([k, v]) => `${k}=${v}`)
57
- .join("&");
58
- const canonicalRequest = [input.method, url.pathname || "/", canonicalQuery, canonicalHeaders, signedHeaders, payloadHash].join("\n");
91
+ const canonicalRequest = [input.method.toUpperCase(), url.pathname || "/", canonicalQuery(url), canonicalHeaders, signedHeaders, payloadHash].join("\n");
59
92
 
60
93
  const scope = `${dateStamp}/${input.region}/${input.service}/aws4_request`;
61
94
  const stringToSign = ["AWS4-HMAC-SHA256", amzDate, scope, sha256Hex(canonicalRequest)].join("\n");
62
- const kDate = hmac(`AWS4${input.credentials.secretAccessKey}`, dateStamp);
63
- const kRegion = hmac(kDate, input.region);
64
- const kService = hmac(kRegion, input.service);
65
- const kSigning = hmac(kService, "aws4_request");
66
- const signature = createHmac("sha256", kSigning).update(stringToSign, "utf8").digest("hex");
95
+ const signature = createHmac("sha256", signingKey(input.credentials.secretAccessKey, dateStamp, input.region, input.service)).update(stringToSign, "utf8").digest("hex");
67
96
 
68
97
  headers.authorization = `AWS4-HMAC-SHA256 Credential=${input.credentials.accessKeyId}/${scope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
98
+ if (input.omitHost) delete headers.host;
69
99
  return headers;
70
100
  }
101
+
102
+ /**
103
+ * A presigned GET (Signature Version 4 in the query string, #4554): whoever
104
+ * holds the URL reads that one object for `seconds`. Only `host` is signed,
105
+ * and the payload is UNSIGNED-PAYLOAD. A query the URL already carries is
106
+ * signed with the rest (#4572): an RDS IAM token is the presigned
107
+ * `?Action=connect&DBUser=<user>` of the database's host and port.
108
+ */
109
+ export function presignV4(input: { url: string; region: string; service: string; credentials: AwsStaticCredentials; seconds: number; now: Date }): string {
110
+ const url = new URL(input.url);
111
+ const { amzDate, dateStamp } = amzDates(input.now);
112
+ const scope = `${dateStamp}/${input.region}/${input.service}/aws4_request`;
113
+ const params: Record<string, string> = {
114
+ ...Object.fromEntries(url.searchParams),
115
+ "X-Amz-Algorithm": "AWS4-HMAC-SHA256",
116
+ "X-Amz-Credential": `${input.credentials.accessKeyId}/${scope}`,
117
+ "X-Amz-Date": amzDate,
118
+ "X-Amz-Expires": String(input.seconds),
119
+ ...(input.credentials.sessionToken ? { "X-Amz-Security-Token": input.credentials.sessionToken } : {}),
120
+ "X-Amz-SignedHeaders": "host",
121
+ };
122
+ const query = Object.keys(params).sort().map((k) => `${encodeRfc3986(k)}=${encodeRfc3986(params[k]!)}`).join("&");
123
+ const canonical = ["GET", url.pathname, query, `host:${url.host}`, "", "host", "UNSIGNED-PAYLOAD"].join("\n");
124
+ const toSign = ["AWS4-HMAC-SHA256", amzDate, scope, sha256Hex(canonical)].join("\n");
125
+ const signature = createHmac("sha256", signingKey(input.credentials.secretAccessKey, dateStamp, input.region, input.service)).update(toSign).digest("hex");
126
+ return `${url.origin}${url.pathname}?${query}&X-Amz-Signature=${signature}`;
127
+ }