@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
package/src/cli/main.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  #!/usr/bin/env tsx
2
2
 
3
+ import { withProductWords, type CiProductWords, type CiProductWordsInput } from "../ci-product-words";
3
4
  import { resolve } from "node:path";
4
5
  import { isEntryPoint } from "./is-entry-point";
5
6
  import { formatSuccess, formatError } from "./format";
@@ -225,8 +226,8 @@ Commands:
225
226
  --all-projects)
226
227
  migrate <file> Translate a workflow between lexicons
227
228
  (default: --from github --to gitlab)
228
- carve advise Read-only peelability advisor: rank which resources
229
- --from <dir> are cheap to carve into native chant
229
+ carve advise Read-only advisor: ranks which resources move
230
+ --from <dir> cleanly to a native lexicon
230
231
  (--json, --report <path>). Emits nothing, changes nothing.
231
232
  --from a Terraform dir needs @cdktn/hcl2json
232
233
  (npm install -D @cdktn/hcl2json); --from a CDK cloud
@@ -258,6 +259,20 @@ Commands:
258
259
  applied) and path. Read-only.
259
260
 
260
261
  CI:
262
+ ci check --base <rev> [<target>...] [--output <dir>] [--json]
263
+ Run the ci.hooks.check hooks the workspace declaration
264
+ at --base names, once each, or once per target with
265
+ perRun, with no forge token or cloud credentials in
266
+ their environment. Writes check-hooks.json under
267
+ --output (default .chant/check); exits 1 when one failed.
268
+ ci forge-check [--env <env>] [--member <name>] [--forge <forge>] [--repo <owner/name>] [--branch <default>] [--require-clouds] [--json]
269
+ Read the forge, each cloud's trust policy and Pulumi
270
+ Cloud's OIDC policies against the pipelines
271
+ ci.identity.cloud gives --env (default production):
272
+ apply environments, branch protection, required
273
+ statuses, and each identity trusted to its own jobs.
274
+ Read-only; exits 1 on a mismatch, and with
275
+ --require-clouds on a cloud it had no credentials for.
261
276
  ci last-green [--json] [--from <rev>] The newest first-parent commit of
262
277
  ci.green's branch, or of --from, with a ci/green tag
263
278
  and no ci/revoked tag. Reads local tags only; fetch
@@ -504,7 +519,14 @@ Ops:
504
519
  --group <name> applies one job group's runs.
505
520
  --record-plans (no --wave), in a pull request's
506
521
  pipeline: plan every wave at its head and record the
507
- digests a pr-review approval mode compares
522
+ digests a pr-review approval mode compares.
523
+ --waves-outcome (no --wave), after the last wave:
524
+ print how the wave jobs' outcome files add up
525
+ (applied, partial, unchanged, waiting, failed), the
526
+ outcome a control dispatch carries (#4617)
527
+ --events-json streams the job's run events (#4555);
528
+ with OTEL_EXPORTER_OTLP_ENDPOINT set, the job sends
529
+ its trace there
508
530
  run resume [--op <name>] [--gate <name>] Start again each CI job that
509
531
  waits at a gate an approval now answers, through the
510
532
  forge's API (#3683); approves nothing. --gate resumes
@@ -513,6 +535,10 @@ Ops:
513
535
  stopped once its run is gone (#3858). --dry-run
514
536
  starts nothing; with --json it says per gate whether
515
537
  it would resume and why
538
+ run pending --plan <digest> [--op <name>] List the gates waiting on a
539
+ plan digest, newest first, with the pull request a
540
+ pr-<n> gate belongs to (#4607). --json prints
541
+ { plan, gates }
516
542
  run --generate <provider> Write one CI pipeline file per scheduled Op for
517
543
  github, gitlab or forgejo (#2533), from every Op that
518
544
  declares a schedule or from --spec <file.json>.
@@ -538,6 +564,15 @@ Ops:
538
564
  commit and runtime on every line (#4041). Also on
539
565
  run <op>, components promote|rollback|redeploy,
540
566
  fan-out, pr-plan and pr-apply
567
+ --adopt <adoption-file>: one component's cfn-deploy
568
+ step adopts the file's indexed resources into its
569
+ stack: an IMPORT change set without markers, then a
570
+ tags-only UPDATE that writes them. Each change set
571
+ is shown and asked about before it runs (--yes
572
+ approves; with no terminal and no --yes, nothing
573
+ runs). If the marker step stops after a good import,
574
+ a plain deploy of the same template writes the
575
+ markers (#4537)
541
576
  operator Run scheduled ticks for discovered ConvergeOps
542
577
  locally (#1485): acquire/renew a per-op
543
578
  lease (git ref CAS), tick on --interval, record every
@@ -581,6 +616,12 @@ Ops:
581
616
  --resume then starts the CI job that waits at the
582
617
  gate again (GitHub re-run, GitLab retry, Forgejo
583
618
  dispatch) with CHANT_FORGE_TOKEN
619
+ At a terminal it shows the stored plan and asks you
620
+ to type the target's name (the environment, else the
621
+ gate) before recording; a wrong answer exits 8, a
622
+ plan that moved while you were asked exits 4.
623
+ --yes, --json, CI and no terminal record as before
624
+ (#4575)
584
625
  On op policy-override the gate is the subject a
585
626
  policy denied: --rule <id> names each rule that
586
627
  denied it and --reason <text> says why the plan goes
@@ -588,6 +629,17 @@ Ops:
588
629
  applies it once, if .chant/overriders at base lists
589
630
  --actor
590
631
 
632
+ notify relay Serve the relay that approves a waiting gate from a
633
+ Slack button or a Teams reply (#4611): verifies the
634
+ chat signature and the button's notify reference,
635
+ maps the clicker through the signers file at base,
636
+ and records chant approve --plan <digest> --actor
637
+ <principal> --relayed-by <relay>. Settings come from
638
+ CHANT_RELAY_KEY, SLACK_SIGNING_SECRET,
639
+ TEAMS_WEBHOOK_SECRET, CHANT_RELAY_PRINCIPAL,
640
+ CHANT_RELAY_MAX_AGE, CHANT_RELAY_HOST (default
641
+ 127.0.0.1) and CHANT_RELAY_PORT (default 8787)
642
+
591
643
  lock <target>... Lock targets for a pull request on chant/lifecycle
592
644
  (--pr <n>, --stage plan|apply|lock, --head <sha>,
593
645
  --by <who>, --gate <name>, --json). --from-report
@@ -632,9 +684,9 @@ Workspace (level 1, #2524):
632
684
  the catalog-info.yaml files under dir, and shows what
633
685
  it left out (#3178)
634
686
  workspace promote <member> [--state <tfstate>] [--lexicon <name>] [--dry-run] [--output <patch>] [--json]
635
- Move a member one rung up the kind ladder (terraform to
636
- choudoufu runs live-check and the adoption report;
637
- choudoufu or other to chant runs chant import), staged
687
+ Change a member's kind (terraform to choudoufu runs
688
+ live-check and the adoption report; choudoufu or
689
+ other to chant runs chant import), staged
638
690
  in a worktree and gated on the patch digest like upgrade
639
691
  workspace promote --all [--state-dir <dir>] [--state <member>=<tfstate>]... [--canary <member>] [--wave-size <n>] [--dry-run] [--json]
640
692
  Adopt every terraform member into choudoufu in waves:
@@ -1126,7 +1178,9 @@ Component release ledger + status:
1126
1178
  the ones that depend on them, and write the
1127
1179
  report and note (--base <ref> --pr <n>
1128
1180
  [--forge github|gitlab|forgejo] posts them);
1129
- applies nothing
1181
+ --target <address> narrows every member's plan
1182
+ to the address, --target <member>:<address>
1183
+ one member's (#4620); applies nothing
1130
1184
  components pr-post Post the plan note and the chant/plan status
1131
1185
  from the report pr-plan --no-status wrote
1132
1186
  (--pr <n> --head <sha> --env <env> --forge
@@ -1139,6 +1193,12 @@ Component release ledger + status:
1139
1193
  _merges/<commit>.json; applies and refuses
1140
1194
  nothing, and a plan that differs from the
1141
1195
  approved one sets a failing chant/record status
1196
+ agent prepare|run|land The agent jobs (#4616) the Op generator writes for
1197
+ a spec's agent: prepare decides from the comment or
1198
+ the drift check and the ledger's run count, run
1199
+ runs the model command with no forge token, land
1200
+ pushes the change, opens or updates the pull
1201
+ request and records the run (--forge <kind>)
1142
1202
  components pr-env An environment per open pull request (#4298): up
1143
1203
  --base <ref> --pr <n> applies the change to pr-<n>,
1144
1204
  derived from ci.prEnvironment.template, once an
@@ -1159,10 +1219,10 @@ Component release ledger + status:
1159
1219
  member's loop, gate op pr-<n>-<member>;
1160
1220
  --resume <file> finishes an apply that failed
1161
1221
  partway under the same approval;
1162
- --wave-gate <name>: apply a wave at a time, each
1163
- planned after the one before applied, a moved
1164
- wave waiting at <name>-wave-<k>, with --wave <k>
1165
- for one wave per CI job;
1222
+ --wave-gate <name>: apply a wave at a time on op
1223
+ waves, each planned after the one before applied,
1224
+ a moved wave waiting at <name>-wave-<k>, with
1225
+ --wave <k> for one wave per CI job;
1166
1226
  --green: apply the green commit at HEAD, measured
1167
1227
  from the one last applied to --env, under the
1168
1228
  approved plans of the merges since, else at gate
@@ -1172,10 +1232,22 @@ Component release ledger + status:
1172
1232
  declaration at base sets ci.workflow to
1173
1233
  apply-before-merge and the forge says it is
1174
1234
  approved, mergeable, undiverged and green;
1235
+ --requires <list> asks only the checks it
1236
+ names (approved,mergeable,undiverged,checks);
1175
1237
  --events-json, both commands: the run-event
1176
1238
  stream on stdout; --report-url <s3 or file URL>,
1177
1239
  both commands: copy the report, the change set
1178
1240
  and the events to <url>/<pr>/<commit>/)
1241
+ components plan-wave --runs <file> --plans <file> --base <ref> --env <env>
1242
+ Plan one op wave's components through their
1243
+ capabilities and write the wave's plans file
1244
+ with its change set (#4588); --wave-outputs
1245
+ <file> seeds the outputs earlier waves left
1246
+ components apply-wave --runs <file> --plans <file> --base <ref> --env <env>
1247
+ Plan the approved runs again, exit 4 when a plan
1248
+ moved, else apply them and add their outputs to
1249
+ --wave-outputs (#4588). Both are the steps of the
1250
+ waves pr-apply --wave-gate runs on op waves
1179
1251
  components release <env> Append one immutable release record
1180
1252
  (--component <name> --digest <sha256:...>
1181
1253
  [--git-sha <sha>] [--run-id <id>] [--actor <name>]);
@@ -1242,7 +1314,8 @@ Local:
1242
1314
 
1243
1315
  Servers:
1244
1316
  serve lsp Start the LSP server (stdio)
1245
- serve mcp Start the MCP server (stdio)
1317
+ serve mcp Start the MCP server (stdio); --read-only serves only
1318
+ the tools that read (ledger, graph, runs) and run nothing
1246
1319
 
1247
1320
  Project:
1248
1321
  update (alias: sync) Sync lexicon types into .chant/types/ (does not install
@@ -1269,6 +1342,7 @@ Options:
1269
1342
  records its lineage in .chant/workspace.lock.json
1270
1343
  --skill <name> Init: install only this skill from the lexicon
1271
1344
  --skip-mcp Init: scaffold without writing the project's .mcp.json
1345
+ --mcp-read-only Init: register \`chant serve mcp --read-only\` in .mcp.json
1272
1346
  --fix Auto-fix fixable issues (lint command)
1273
1347
  --force Force overwrite existing files (import command)
1274
1348
  -w, --watch Watch for changes and rebuild/re-lint (build, lint)
@@ -1548,8 +1622,32 @@ function commandRunsNoConfig(def: CommandDef, args: ParsedArgs): boolean {
1548
1622
  * checked, plugins are loaded when the command needs them, and the handler
1549
1623
  * runs. A `process.exit` inside (loadPluginsOrExit's, say) is the caller's to
1550
1624
  * catch.
1625
+ *
1626
+ * `words` (#4550) are a CI product's words (`@intentius/chant/ci-product`):
1627
+ * the product's bin passes them, so the command renders in the product's
1628
+ * words while it runs. `mcp` (#4555) is its tool hook, which `chant serve
1629
+ * mcp` serves beside chant's own tools.
1551
1630
  */
1552
- export async function runCommandInProcess(argv: string[]): Promise<number> {
1631
+ export async function runCommandInProcess(
1632
+ argv: string[],
1633
+ options: { words?: CiProductWordsInput | CiProductWords; mcp?: import("./mcp/product-tools").ProductMcpHook; wave?: import("../op/op-waves-after-plan").ProductWaveHook } = {},
1634
+ ): Promise<number> {
1635
+ // #4614: a product's after-plan hooks and capabilities on `chant run wave`, in its own process.
1636
+ if (options.wave) {
1637
+ const { withProductWaveHook } = await import("../op/op-waves-after-plan");
1638
+ const { wave, ...rest } = options;
1639
+ return withProductWaveHook(wave, () => runCommandInProcess(argv, rest));
1640
+ }
1641
+ // #4555: a product's tools on `chant serve mcp`, through its tool hook.
1642
+ if (options.mcp) {
1643
+ const { withProductMcpHook } = await import("./mcp/product-tools");
1644
+ const { mcp, ...rest } = options;
1645
+ return withProductMcpHook(mcp, () => runCommandInProcess(argv, rest));
1646
+ }
1647
+ // #4550: a product's bin calls chant with its words; every status, note and
1648
+ // approve line the command writes takes them, and the earlier words come
1649
+ // back once it settles.
1650
+ if (options.words) return withProductWords(options.words, () => runCommandInProcess(argv));
1553
1651
  const args = parseArgs(argv);
1554
1652
  const match = resolveCommand(args, commandRegistry);
1555
1653
  if (!match) {
@@ -1629,6 +1727,10 @@ export const commandRegistry: CommandDef[] = [
1629
1727
  { name: "ci tick", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli")).runCiTick(ctx) },
1630
1728
  { name: "ci workflow", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli")).runCiWorkflow(ctx) },
1631
1729
  { name: "ci init", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-init")).runCiInit(ctx) },
1730
+ // #4556: the ci.hooks.check hooks at base, for a product's check job.
1731
+ { name: "ci check", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-check")).runCiCheck(ctx) },
1732
+ // #4608: the live forge, cloud trust policies and Pulumi Cloud's OIDC policies against ci.identity.cloud. Read-only.
1733
+ { name: "ci forge-check", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-forge-check")).runCiForgeCheck(ctx) },
1632
1734
  // #4094: one pull-request job as a pipeline Op in a fresh checkout, the chant runner's first slice.
1633
1735
  { name: "ci run", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-run")).runCiRun(ctx) },
1634
1736
  // #4098: the run index at the report URL.
@@ -1678,6 +1780,8 @@ export const commandRegistry: CommandDef[] = [
1678
1780
  { name: "run wave", handler: runOpWaveCommand },
1679
1781
  // #3683 — start the CI jobs that wait at gates whose approval arrived. Imported on first use.
1680
1782
  { name: "run resume", handler: async (ctx) => (await import("./handlers/gate-resume")).runResumeCommand(ctx) },
1783
+ // #4607 — the pending gates a plan digest waits at, with their pull request. Imported on first use.
1784
+ { name: "run pending", handler: async (ctx) => (await import("./handlers/gate-pending")).runPendingCommand(ctx) },
1681
1785
  { name: "run", handler: runOp },
1682
1786
 
1683
1787
  { name: "operator status", handler: runOperatorStatus },
@@ -1685,6 +1789,8 @@ export const commandRegistry: CommandDef[] = [
1685
1789
  { name: "operator", handler: runOperator },
1686
1790
  { name: "approve", handler: runApprove },
1687
1791
  // #4293 — target locks a pull request holds on chant/lifecycle. Imported on first use.
1792
+ // #4611 — approve a waiting gate from a chat click. Imported on first use.
1793
+ { name: "notify relay", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/notify-relay")).runNotifyRelay(ctx) },
1688
1794
  { name: "lock", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/lock")).runLock(ctx) },
1689
1795
  { name: "unlock", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/lock")).runUnlock(ctx) },
1690
1796
 
@@ -1787,9 +1893,16 @@ export const commandRegistry: CommandDef[] = [
1787
1893
  // #3183 — the pull-request loop the generated CI runs. Imported on first use.
1788
1894
  { name: "components pr-plan", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrPlan(ctx) },
1789
1895
  { name: "components pr-apply", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrApply(ctx) },
1896
+ // #4588: the component plan-wave and apply-wave steps a component waves spec runs (pr-apply --wave-gate on op waves).
1897
+ { name: "components plan-wave", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPlanWave(ctx) },
1898
+ { name: "components apply-wave", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsApplyWave(ctx) },
1790
1899
  // #4295: posts from the plan report in a job that runs none of the change's code, so it loads no plugins.
1791
1900
  { name: "components pr-post", handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrPost(ctx) },
1792
1901
  { name: "components pr-record", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrRecord(ctx) },
1902
+ // #4616: the agent jobs' three steps. Imported on first use; none loads plugins.
1903
+ { name: "agent prepare", handler: async (ctx) => (await import("./handlers/agent")).runAgentCommandLine(ctx) },
1904
+ { name: "agent run", handler: async (ctx) => (await import("./handlers/agent")).runAgentCommandLine(ctx) },
1905
+ { name: "agent land", handler: async (ctx) => (await import("./handlers/agent")).runAgentCommandLine(ctx) },
1793
1906
  { name: "components pr-env", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr-env")).runComponentsPrEnv(ctx) },
1794
1907
  { name: "components status", requiresPlugins: true, handler: runComponentsStatus },
1795
1908
  { name: "components release", handler: runComponentsReleaseRecord },
@@ -0,0 +1,126 @@
1
+ /**
2
+ * chant#4543 — the ledger reads of `chant serve mcp`: `ledger` and `query`.
3
+ *
4
+ * Served in both modes, and the reason the read-only mode is worth starting:
5
+ * an agent gets the runs, gates, deploys, releases, cuts, resources and
6
+ * snapshots on `chant/lifecycle` and the index store without a tool that can
7
+ * change any of them.
8
+ *
9
+ * Each runs the CLI with the chant this server runs as, in the server's
10
+ * directory, and returns the JSON document it printed, unchanged, the way the
11
+ * workspace reads do (./workspace-tools.ts {@link runRead}):
12
+ *
13
+ * - `ledger` runs `chant ledger <table> ... --json`, the ledger read contract
14
+ * (`../handlers/ledger.ts`, #4363).
15
+ * - `query` runs `chant query -- <sql> --json`, one read-only SQL statement
16
+ * over the same ledgers (`../handlers/query.ts`, #4297). The engine refuses
17
+ * anything but a read.
18
+ *
19
+ * Both read the local branch and never fetch.
20
+ */
21
+
22
+ import type { ToolDefinition, ToolHandler } from "./types";
23
+ import { ownChantCommand, runRead, type ChantCommand } from "./workspace-tools";
24
+
25
+ /** The tables `chant ledger` reads, in its usage order. */
26
+ export const LEDGER_TABLES = ["resources", "snapshots", "runs", "gates", "deploys", "releases", "cuts"] as const;
27
+
28
+ class ToolInputError extends Error {}
29
+
30
+ function str(params: Record<string, unknown>, key: string, required = false): string | undefined {
31
+ const v = params[key];
32
+ if (v === undefined || v === null) {
33
+ if (required) throw new ToolInputError(`${key} is required`);
34
+ return undefined;
35
+ }
36
+ if (typeof v !== "string" || v === "") throw new ToolInputError(`${key} must be a non-empty string`);
37
+ // A value is passed as one argument; one that starts with - would read as a flag.
38
+ if (v.startsWith("-")) throw new ToolInputError(`${key} may not start with -: ${JSON.stringify(v)}`);
39
+ return v;
40
+ }
41
+
42
+ function list(params: Record<string, unknown>, key: string): string[] {
43
+ const v = params[key];
44
+ if (v === undefined || v === null) return [];
45
+ const items = typeof v === "string" ? [v] : v;
46
+ if (!Array.isArray(items)) throw new ToolInputError(`${key} must be a string, or a list of them`);
47
+ return items.map((item, i) => str({ [`${key}[${i}]`]: item }, `${key}[${i}]`, true)!);
48
+ }
49
+
50
+ const memberProp = {
51
+ type: "array",
52
+ items: { type: "string" },
53
+ description: "Only these workspace members' ledgers (--member). Outside a workspace the project's own ledger is read.",
54
+ };
55
+
56
+ export const ledgerReadTools: ToolDefinition[] = [
57
+ {
58
+ name: "ledger",
59
+ description:
60
+ "One ledger's rows from the local chant/lifecycle branch: chant ledger <table> --json (#4363). Tables: " +
61
+ LEDGER_TABLES.join(", ") +
62
+ ". Inside a workspace every member's ledger is read and each row names its member. Returns the document unchanged; an error document is a document.",
63
+ inputSchema: {
64
+ type: "object",
65
+ properties: {
66
+ table: { type: "string", enum: [...LEDGER_TABLES], description: "The ledger to read." },
67
+ member: memberProp,
68
+ where: {
69
+ type: "array",
70
+ items: { type: "string" },
71
+ description: "Typed filters, each <field><op><value> such as state=failed (--where, repeatable).",
72
+ },
73
+ since: { type: "string", description: "Only rows at or after this time (--since)." },
74
+ at: { type: "string", description: "Read the ledger as this commit of chant/lifecycle held it (--at)." },
75
+ },
76
+ required: ["table"],
77
+ },
78
+ },
79
+ {
80
+ name: "query",
81
+ description:
82
+ "One read-only SQL statement over the snapshots in the index store and the Op runs, gates, deploys and releases on the local chant/lifecycle branch: chant query <sql> --json (#4297). A statement that writes is refused. Returns the document unchanged.",
83
+ inputSchema: {
84
+ type: "object",
85
+ properties: {
86
+ sql: { type: "string", description: "The SQL statement." },
87
+ member: memberProp,
88
+ },
89
+ required: ["sql"],
90
+ },
91
+ },
92
+ ];
93
+
94
+ /** The `chant` arguments each ledger tool runs, from its input. */
95
+ export function ledgerArgv(tool: string, params: Record<string, unknown>): string[] {
96
+ const members = list(params, "member").flatMap((m) => ["--member", m]);
97
+ switch (tool) {
98
+ case "ledger": {
99
+ const table = str(params, "table", true)!;
100
+ if (!(LEDGER_TABLES as readonly string[]).includes(table)) throw new ToolInputError(`table must be one of ${LEDGER_TABLES.join(", ")}`);
101
+ const where = list(params, "where").flatMap((w) => ["--where", w]);
102
+ const flags = (["since", "at"] as const).flatMap((f) => {
103
+ const v = str(params, f);
104
+ return v !== undefined ? [`--${f}`, v] : [];
105
+ });
106
+ return ["ledger", table, ...members, ...where, ...flags, "--json"];
107
+ }
108
+ case "query": {
109
+ // The statement is one argument after `--`, so text that opens with - stays SQL.
110
+ const sql = params.sql;
111
+ if (typeof sql !== "string" || sql.trim() === "") throw new ToolInputError("sql must be a non-empty string");
112
+ return ["query", ...members, "--json", "--", sql];
113
+ }
114
+ default:
115
+ throw new ToolInputError(`${tool} is not a ledger read tool`);
116
+ }
117
+ }
118
+
119
+ /** The ledger read tools, bound to the server's directory. */
120
+ export function createLedgerTools(options: { cwd: string; chantCommand?: ChantCommand }): { definition: ToolDefinition; handler: ToolHandler }[] {
121
+ const chant = options.chantCommand ?? ownChantCommand();
122
+ return ledgerReadTools.map((definition) => ({
123
+ definition,
124
+ handler: async (params) => runRead(chant, ledgerArgv(definition.name, params), options.cwd),
125
+ }));
126
+ }
@@ -0,0 +1,123 @@
1
+ /**
2
+ * chant#4555: a CI product's tools on `chant serve mcp` through the product
3
+ * tool hook, read-only by default, and the `report` tool's read of the
4
+ * report store.
5
+ */
6
+
7
+ import { describe, expect, test } from "vitest";
8
+ import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
9
+ import { join } from "node:path";
10
+ import { tmpdir } from "node:os";
11
+ import { pathToFileURL } from "node:url";
12
+ import { McpServer } from "./server";
13
+ import { productToolWriteWord, ProductToolRefusedError, type ProductMcpHook } from "./product-tools";
14
+ import { reportReader, reportToolKey, safeReportKey } from "./report-tools";
15
+ import type { ToolDefinition } from "./types";
16
+ import type { McpToolContribution } from "../../mcp/types";
17
+
18
+ const tool = (name: string, readOnly?: boolean, handler: McpToolContribution["handler"] = async () => ({ name })): McpToolContribution => ({
19
+ name,
20
+ description: name,
21
+ inputSchema: { type: "object", properties: {} },
22
+ handler,
23
+ ...(readOnly !== undefined ? { readOnly } : {}),
24
+ });
25
+
26
+ async function listed(server: McpServer): Promise<string[]> {
27
+ const res = await server.handleRequest({ jsonrpc: "2.0", id: 1, method: "tools/list" });
28
+ return (res.result as { tools: ToolDefinition[] }).tools.map((t) => t.name);
29
+ }
30
+
31
+ async function call(server: McpServer, name: string, args: Record<string, unknown> = {}): Promise<{ text: string; isError?: boolean }> {
32
+ const res = await server.handleRequest({ jsonrpc: "2.0", id: 2, method: "tools/call", params: { name, arguments: args } });
33
+ const r = res.result as { content: Array<{ text: string }>; isError?: boolean };
34
+ return { text: r.content[0]!.text, ...(r.isError ? { isError: true } : {}) };
35
+ }
36
+
37
+ describe("the product tool hook (#4555)", () => {
38
+ test("a server started through the hook is read-only, and serves only the product tools that say they read", async () => {
39
+ const hook: ProductMcpHook = { product: "terragucci", tools: () => [tool("waiting", true), tool("estate", true), tool("drift_scan")] };
40
+ const server = new McpServer([], { product: hook });
41
+ expect(server.readOnly).toBe(true);
42
+ const names = await listed(server);
43
+ expect(names).toContain("terragucci:waiting");
44
+ expect(names).toContain("terragucci:estate");
45
+ expect(names).not.toContain("terragucci:drift_scan");
46
+ // chant's mutating core tools stay out too.
47
+ expect(names).not.toContain("op-run");
48
+ expect(names).not.toContain("op-approve");
49
+ expect(names).toContain("report");
50
+ expect(JSON.parse((await call(server, "terragucci:waiting")).text)).toEqual({ name: "waiting" });
51
+ });
52
+
53
+ test("a read-only server will not start with a product tool named as a write (assertReadOnly)", () => {
54
+ for (const name of ["apply_wave", "wave_approve", "unlock", "push_branch", "terragucci:merge_pr"]) {
55
+ expect(() => new McpServer([], { product: { product: "terragucci", tools: () => [tool(name, true)] } }), name).toThrow(ProductToolRefusedError);
56
+ }
57
+ expect(productToolWriteWord("last_apply")).toBeUndefined();
58
+ expect(productToolWriteWord("audit")).toBeUndefined();
59
+ expect(productToolWriteWord("apply_wave")).toBe("apply");
60
+ expect(productToolWriteWord("wave_approve")).toBe("approve");
61
+ });
62
+
63
+ test("readOnly: false on the hook starts an ordinary server with every product tool; --read-only wins over it", async () => {
64
+ const tools = () => [tool("propose"), tool("waiting", true)];
65
+ const open = new McpServer([], { product: { product: "plywood", tools, readOnly: false } });
66
+ expect(open.readOnly).toBe(false);
67
+ expect(await listed(open)).toEqual(expect.arrayContaining(["plywood:propose", "plywood:waiting", "op-run"]));
68
+ const closed = new McpServer([], { readOnly: true, product: { product: "plywood", tools, readOnly: false } });
69
+ expect(await listed(closed)).not.toContain("plywood:propose");
70
+ });
71
+
72
+ test("a product name that is not a word is refused, and the hook's instructions reach initialize", async () => {
73
+ expect(() => new McpServer([], { product: { product: "Ply Wood", tools: () => [] } })).toThrow(/not a product name/);
74
+ const server = new McpServer([], { product: { product: "plywood", tools: () => [], instructions: "plywood reads stacks." } });
75
+ const res = await server.handleRequest({ jsonrpc: "2.0", id: 1, method: "initialize", params: {} });
76
+ expect((res.result as { instructions: string }).instructions).toMatch(/^plywood reads stacks\.\n\n.*read-only/s);
77
+ });
78
+
79
+ test("a product tool reads the report store through its context, and cannot write it", async () => {
80
+ const dir = mkdtempSync(join(tmpdir(), "product-tools-"));
81
+ mkdirSync(join(dir, "7", "c".repeat(40)), { recursive: true });
82
+ writeFileSync(join(dir, "7", "c".repeat(40), "pr-plan.json"), JSON.stringify({ status: "planned" }));
83
+ let read: string | null | undefined;
84
+ const hook: ProductMcpHook = {
85
+ product: "plywood",
86
+ reportUrl: pathToFileURL(dir).href,
87
+ tools: (ctx) => [
88
+ tool("plan_report", true, async () => {
89
+ const reports = await ctx.reports();
90
+ read = await reports!.read(`7/${"c".repeat(40)}/pr-plan.json`);
91
+ return { read };
92
+ }),
93
+ ],
94
+ };
95
+ const server = new McpServer([], { product: hook });
96
+ await call(server, "plywood:plan_report");
97
+ expect(read).toBe(JSON.stringify({ status: "planned" }));
98
+ expect("put" in reportReader(pathToFileURL(dir).href)).toBe(false);
99
+
100
+ // The core `report` tool reads the same store by pull request, commit and file.
101
+ const got = await call(server, "report", { pr: "7", commit: "c".repeat(40), file: "pr-plan.json" });
102
+ expect(JSON.parse(got.text)).toMatchObject({ key: `7/${"c".repeat(40)}/pr-plan.json`, document: { status: "planned" } });
103
+ expect((await call(server, "report", { pr: "7", commit: "c".repeat(40), file: "pr-apply.json" })).isError).toBe(true);
104
+ rmSync(dir, { recursive: true, force: true });
105
+ });
106
+ });
107
+
108
+ describe("the report tool's keys (#4555)", () => {
109
+ test("take a pull request, a commit, an optional member and one of the stage files", () => {
110
+ expect(reportToolKey({ pr: "12", commit: "a".repeat(40), file: "change-set.json" })).toBe(`12/${"a".repeat(40)}/change-set.json`);
111
+ expect(reportToolKey({ pr: 12, commit: "a".repeat(40), member: "web", file: "pr-apply.events.jsonl" })).toBe(`12/${"a".repeat(40)}/web/pr-apply.events.jsonl`);
112
+ expect(reportToolKey({ pr: "unknown", commit: "a".repeat(40), file: "pr-apply.json" })).toBe(`unknown/${"a".repeat(40)}/pr-apply.json`);
113
+ });
114
+
115
+ test("refuse anything that would leave the report URL, and any argument they do not list", () => {
116
+ expect(() => reportToolKey({ pr: "../x", commit: "a".repeat(40), file: "pr-plan.json" })).toThrow(/pull request number/);
117
+ expect(() => reportToolKey({ pr: "1", commit: "a".repeat(40), member: "..", file: "pr-plan.json" })).toThrow(/member/);
118
+ expect(() => reportToolKey({ pr: "1", commit: "a".repeat(40), file: "../../secret" })).toThrow(/file must be one of/);
119
+ expect(() => reportToolKey({ pr: "1", commit: "a".repeat(40), file: "pr-plan.json", token: "x" })).toThrow(/takes no argument token/);
120
+ expect(() => safeReportKey("a/../b")).toThrow(/not a path below/);
121
+ expect(safeReportKey("/a/b/")).toBe("a/b");
122
+ });
123
+ });