@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/dist/cli/main.js CHANGED
@@ -1,4 +1,5 @@
1
1
  #!/usr/bin/env tsx
2
+ import { withProductWords } from "../ci-product-words.js";
2
3
  import { resolve } from "node:path";
3
4
  import { isEntryPoint } from "./is-entry-point.js";
4
5
  import { formatError } from "./format.js";
@@ -212,8 +213,8 @@ Commands:
212
213
  --all-projects)
213
214
  migrate <file> Translate a workflow between lexicons
214
215
  (default: --from github --to gitlab)
215
- carve advise Read-only peelability advisor: rank which resources
216
- --from <dir> are cheap to carve into native chant
216
+ carve advise Read-only advisor: ranks which resources move
217
+ --from <dir> cleanly to a native lexicon
217
218
  (--json, --report <path>). Emits nothing, changes nothing.
218
219
  --from a Terraform dir needs @cdktn/hcl2json
219
220
  (npm install -D @cdktn/hcl2json); --from a CDK cloud
@@ -245,6 +246,20 @@ Commands:
245
246
  applied) and path. Read-only.
246
247
 
247
248
  CI:
249
+ ci check --base <rev> [<target>...] [--output <dir>] [--json]
250
+ Run the ci.hooks.check hooks the workspace declaration
251
+ at --base names, once each, or once per target with
252
+ perRun, with no forge token or cloud credentials in
253
+ their environment. Writes check-hooks.json under
254
+ --output (default .chant/check); exits 1 when one failed.
255
+ ci forge-check [--env <env>] [--member <name>] [--forge <forge>] [--repo <owner/name>] [--branch <default>] [--require-clouds] [--json]
256
+ Read the forge, each cloud's trust policy and Pulumi
257
+ Cloud's OIDC policies against the pipelines
258
+ ci.identity.cloud gives --env (default production):
259
+ apply environments, branch protection, required
260
+ statuses, and each identity trusted to its own jobs.
261
+ Read-only; exits 1 on a mismatch, and with
262
+ --require-clouds on a cloud it had no credentials for.
248
263
  ci last-green [--json] [--from <rev>] The newest first-parent commit of
249
264
  ci.green's branch, or of --from, with a ci/green tag
250
265
  and no ci/revoked tag. Reads local tags only; fetch
@@ -491,7 +506,14 @@ Ops:
491
506
  --group <name> applies one job group's runs.
492
507
  --record-plans (no --wave), in a pull request's
493
508
  pipeline: plan every wave at its head and record the
494
- digests a pr-review approval mode compares
509
+ digests a pr-review approval mode compares.
510
+ --waves-outcome (no --wave), after the last wave:
511
+ print how the wave jobs' outcome files add up
512
+ (applied, partial, unchanged, waiting, failed), the
513
+ outcome a control dispatch carries (#4617)
514
+ --events-json streams the job's run events (#4555);
515
+ with OTEL_EXPORTER_OTLP_ENDPOINT set, the job sends
516
+ its trace there
495
517
  run resume [--op <name>] [--gate <name>] Start again each CI job that
496
518
  waits at a gate an approval now answers, through the
497
519
  forge's API (#3683); approves nothing. --gate resumes
@@ -500,6 +522,10 @@ Ops:
500
522
  stopped once its run is gone (#3858). --dry-run
501
523
  starts nothing; with --json it says per gate whether
502
524
  it would resume and why
525
+ run pending --plan <digest> [--op <name>] List the gates waiting on a
526
+ plan digest, newest first, with the pull request a
527
+ pr-<n> gate belongs to (#4607). --json prints
528
+ { plan, gates }
503
529
  run --generate <provider> Write one CI pipeline file per scheduled Op for
504
530
  github, gitlab or forgejo (#2533), from every Op that
505
531
  declares a schedule or from --spec <file.json>.
@@ -525,6 +551,15 @@ Ops:
525
551
  commit and runtime on every line (#4041). Also on
526
552
  run <op>, components promote|rollback|redeploy,
527
553
  fan-out, pr-plan and pr-apply
554
+ --adopt <adoption-file>: one component's cfn-deploy
555
+ step adopts the file's indexed resources into its
556
+ stack: an IMPORT change set without markers, then a
557
+ tags-only UPDATE that writes them. Each change set
558
+ is shown and asked about before it runs (--yes
559
+ approves; with no terminal and no --yes, nothing
560
+ runs). If the marker step stops after a good import,
561
+ a plain deploy of the same template writes the
562
+ markers (#4537)
528
563
  operator Run scheduled ticks for discovered ConvergeOps
529
564
  locally (#1485): acquire/renew a per-op
530
565
  lease (git ref CAS), tick on --interval, record every
@@ -568,6 +603,12 @@ Ops:
568
603
  --resume then starts the CI job that waits at the
569
604
  gate again (GitHub re-run, GitLab retry, Forgejo
570
605
  dispatch) with CHANT_FORGE_TOKEN
606
+ At a terminal it shows the stored plan and asks you
607
+ to type the target's name (the environment, else the
608
+ gate) before recording; a wrong answer exits 8, a
609
+ plan that moved while you were asked exits 4.
610
+ --yes, --json, CI and no terminal record as before
611
+ (#4575)
571
612
  On op policy-override the gate is the subject a
572
613
  policy denied: --rule <id> names each rule that
573
614
  denied it and --reason <text> says why the plan goes
@@ -575,6 +616,17 @@ Ops:
575
616
  applies it once, if .chant/overriders at base lists
576
617
  --actor
577
618
 
619
+ notify relay Serve the relay that approves a waiting gate from a
620
+ Slack button or a Teams reply (#4611): verifies the
621
+ chat signature and the button's notify reference,
622
+ maps the clicker through the signers file at base,
623
+ and records chant approve --plan <digest> --actor
624
+ <principal> --relayed-by <relay>. Settings come from
625
+ CHANT_RELAY_KEY, SLACK_SIGNING_SECRET,
626
+ TEAMS_WEBHOOK_SECRET, CHANT_RELAY_PRINCIPAL,
627
+ CHANT_RELAY_MAX_AGE, CHANT_RELAY_HOST (default
628
+ 127.0.0.1) and CHANT_RELAY_PORT (default 8787)
629
+
578
630
  lock <target>... Lock targets for a pull request on chant/lifecycle
579
631
  (--pr <n>, --stage plan|apply|lock, --head <sha>,
580
632
  --by <who>, --gate <name>, --json). --from-report
@@ -619,9 +671,9 @@ Workspace (level 1, #2524):
619
671
  the catalog-info.yaml files under dir, and shows what
620
672
  it left out (#3178)
621
673
  workspace promote <member> [--state <tfstate>] [--lexicon <name>] [--dry-run] [--output <patch>] [--json]
622
- Move a member one rung up the kind ladder (terraform to
623
- choudoufu runs live-check and the adoption report;
624
- choudoufu or other to chant runs chant import), staged
674
+ Change a member's kind (terraform to choudoufu runs
675
+ live-check and the adoption report; choudoufu or
676
+ other to chant runs chant import), staged
625
677
  in a worktree and gated on the patch digest like upgrade
626
678
  workspace promote --all [--state-dir <dir>] [--state <member>=<tfstate>]... [--canary <member>] [--wave-size <n>] [--dry-run] [--json]
627
679
  Adopt every terraform member into choudoufu in waves:
@@ -1113,7 +1165,9 @@ Component release ledger + status:
1113
1165
  the ones that depend on them, and write the
1114
1166
  report and note (--base <ref> --pr <n>
1115
1167
  [--forge github|gitlab|forgejo] posts them);
1116
- applies nothing
1168
+ --target <address> narrows every member's plan
1169
+ to the address, --target <member>:<address>
1170
+ one member's (#4620); applies nothing
1117
1171
  components pr-post Post the plan note and the chant/plan status
1118
1172
  from the report pr-plan --no-status wrote
1119
1173
  (--pr <n> --head <sha> --env <env> --forge
@@ -1126,6 +1180,12 @@ Component release ledger + status:
1126
1180
  _merges/<commit>.json; applies and refuses
1127
1181
  nothing, and a plan that differs from the
1128
1182
  approved one sets a failing chant/record status
1183
+ agent prepare|run|land The agent jobs (#4616) the Op generator writes for
1184
+ a spec's agent: prepare decides from the comment or
1185
+ the drift check and the ledger's run count, run
1186
+ runs the model command with no forge token, land
1187
+ pushes the change, opens or updates the pull
1188
+ request and records the run (--forge <kind>)
1129
1189
  components pr-env An environment per open pull request (#4298): up
1130
1190
  --base <ref> --pr <n> applies the change to pr-<n>,
1131
1191
  derived from ci.prEnvironment.template, once an
@@ -1146,10 +1206,10 @@ Component release ledger + status:
1146
1206
  member's loop, gate op pr-<n>-<member>;
1147
1207
  --resume <file> finishes an apply that failed
1148
1208
  partway under the same approval;
1149
- --wave-gate <name>: apply a wave at a time, each
1150
- planned after the one before applied, a moved
1151
- wave waiting at <name>-wave-<k>, with --wave <k>
1152
- for one wave per CI job;
1209
+ --wave-gate <name>: apply a wave at a time on op
1210
+ waves, each planned after the one before applied,
1211
+ a moved wave waiting at <name>-wave-<k>, with
1212
+ --wave <k> for one wave per CI job;
1153
1213
  --green: apply the green commit at HEAD, measured
1154
1214
  from the one last applied to --env, under the
1155
1215
  approved plans of the merges since, else at gate
@@ -1159,10 +1219,22 @@ Component release ledger + status:
1159
1219
  declaration at base sets ci.workflow to
1160
1220
  apply-before-merge and the forge says it is
1161
1221
  approved, mergeable, undiverged and green;
1222
+ --requires <list> asks only the checks it
1223
+ names (approved,mergeable,undiverged,checks);
1162
1224
  --events-json, both commands: the run-event
1163
1225
  stream on stdout; --report-url <s3 or file URL>,
1164
1226
  both commands: copy the report, the change set
1165
1227
  and the events to <url>/<pr>/<commit>/)
1228
+ components plan-wave --runs <file> --plans <file> --base <ref> --env <env>
1229
+ Plan one op wave's components through their
1230
+ capabilities and write the wave's plans file
1231
+ with its change set (#4588); --wave-outputs
1232
+ <file> seeds the outputs earlier waves left
1233
+ components apply-wave --runs <file> --plans <file> --base <ref> --env <env>
1234
+ Plan the approved runs again, exit 4 when a plan
1235
+ moved, else apply them and add their outputs to
1236
+ --wave-outputs (#4588). Both are the steps of the
1237
+ waves pr-apply --wave-gate runs on op waves
1166
1238
  components release <env> Append one immutable release record
1167
1239
  (--component <name> --digest <sha256:...>
1168
1240
  [--git-sha <sha>] [--run-id <id>] [--actor <name>]);
@@ -1229,7 +1301,8 @@ Local:
1229
1301
 
1230
1302
  Servers:
1231
1303
  serve lsp Start the LSP server (stdio)
1232
- serve mcp Start the MCP server (stdio)
1304
+ serve mcp Start the MCP server (stdio); --read-only serves only
1305
+ the tools that read (ledger, graph, runs) and run nothing
1233
1306
 
1234
1307
  Project:
1235
1308
  update (alias: sync) Sync lexicon types into .chant/types/ (does not install
@@ -1256,6 +1329,7 @@ Options:
1256
1329
  records its lineage in .chant/workspace.lock.json
1257
1330
  --skill <name> Init: install only this skill from the lexicon
1258
1331
  --skip-mcp Init: scaffold without writing the project's .mcp.json
1332
+ --mcp-read-only Init: register \`chant serve mcp --read-only\` in .mcp.json
1259
1333
  --fix Auto-fix fixable issues (lint command)
1260
1334
  --force Force overwrite existing files (import command)
1261
1335
  -w, --watch Watch for changes and rebuild/re-lint (build, lint)
@@ -1530,8 +1604,30 @@ function commandRunsNoConfig(def, args) {
1530
1604
  * checked, plugins are loaded when the command needs them, and the handler
1531
1605
  * runs. A `process.exit` inside (loadPluginsOrExit's, say) is the caller's to
1532
1606
  * catch.
1607
+ *
1608
+ * `words` (#4550) are a CI product's words (`@intentius/chant/ci-product`):
1609
+ * the product's bin passes them, so the command renders in the product's
1610
+ * words while it runs. `mcp` (#4555) is its tool hook, which `chant serve
1611
+ * mcp` serves beside chant's own tools.
1533
1612
  */
1534
- export async function runCommandInProcess(argv) {
1613
+ export async function runCommandInProcess(argv, options = {}) {
1614
+ // #4614: a product's after-plan hooks and capabilities on `chant run wave`, in its own process.
1615
+ if (options.wave) {
1616
+ const { withProductWaveHook } = await import("../op/op-waves-after-plan.js");
1617
+ const { wave, ...rest } = options;
1618
+ return withProductWaveHook(wave, () => runCommandInProcess(argv, rest));
1619
+ }
1620
+ // #4555: a product's tools on `chant serve mcp`, through its tool hook.
1621
+ if (options.mcp) {
1622
+ const { withProductMcpHook } = await import("./mcp/product-tools.js");
1623
+ const { mcp, ...rest } = options;
1624
+ return withProductMcpHook(mcp, () => runCommandInProcess(argv, rest));
1625
+ }
1626
+ // #4550: a product's bin calls chant with its words; every status, note and
1627
+ // approve line the command writes takes them, and the earlier words come
1628
+ // back once it settles.
1629
+ if (options.words)
1630
+ return withProductWords(options.words, () => runCommandInProcess(argv));
1535
1631
  const args = parseArgs(argv);
1536
1632
  const match = resolveCommand(args, commandRegistry);
1537
1633
  if (!match) {
@@ -1612,6 +1708,10 @@ export const commandRegistry = [
1612
1708
  { name: "ci tick", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli.js")).runCiTick(ctx) },
1613
1709
  { name: "ci workflow", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli.js")).runCiWorkflow(ctx) },
1614
1710
  { name: "ci init", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-init.js")).runCiInit(ctx) },
1711
+ // #4556: the ci.hooks.check hooks at base, for a product's check job.
1712
+ { name: "ci check", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-check.js")).runCiCheck(ctx) },
1713
+ // #4608: the live forge, cloud trust policies and Pulumi Cloud's OIDC policies against ci.identity.cloud. Read-only.
1714
+ { name: "ci forge-check", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-forge-check.js")).runCiForgeCheck(ctx) },
1615
1715
  // #4094: one pull-request job as a pipeline Op in a fresh checkout, the chant runner's first slice.
1616
1716
  { name: "ci run", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-run.js")).runCiRun(ctx) },
1617
1717
  // #4098: the run index at the report URL.
@@ -1659,12 +1759,16 @@ export const commandRegistry = [
1659
1759
  { name: "run wave", handler: runOpWaveCommand },
1660
1760
  // #3683 — start the CI jobs that wait at gates whose approval arrived. Imported on first use.
1661
1761
  { name: "run resume", handler: async (ctx) => (await import("./handlers/gate-resume.js")).runResumeCommand(ctx) },
1762
+ // #4607 — the pending gates a plan digest waits at, with their pull request. Imported on first use.
1763
+ { name: "run pending", handler: async (ctx) => (await import("./handlers/gate-pending.js")).runPendingCommand(ctx) },
1662
1764
  { name: "run", handler: runOp },
1663
1765
  { name: "operator status", handler: runOperatorStatus },
1664
1766
  { name: "operator log", handler: runOperatorLog },
1665
1767
  { name: "operator", handler: runOperator },
1666
1768
  { name: "approve", handler: runApprove },
1667
1769
  // #4293 — target locks a pull request holds on chant/lifecycle. Imported on first use.
1770
+ // #4611 — approve a waiting gate from a chat click. Imported on first use.
1771
+ { name: "notify relay", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/notify-relay.js")).runNotifyRelay(ctx) },
1668
1772
  { name: "lock", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/lock.js")).runLock(ctx) },
1669
1773
  { name: "unlock", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/lock.js")).runUnlock(ctx) },
1670
1774
  { name: "graph", handler: runGraph },
@@ -1762,9 +1866,16 @@ export const commandRegistry = [
1762
1866
  // #3183 — the pull-request loop the generated CI runs. Imported on first use.
1763
1867
  { name: "components pr-plan", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsPrPlan(ctx) },
1764
1868
  { name: "components pr-apply", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsPrApply(ctx) },
1869
+ // #4588: the component plan-wave and apply-wave steps a component waves spec runs (pr-apply --wave-gate on op waves).
1870
+ { name: "components plan-wave", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsPlanWave(ctx) },
1871
+ { name: "components apply-wave", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsApplyWave(ctx) },
1765
1872
  // #4295: posts from the plan report in a job that runs none of the change's code, so it loads no plugins.
1766
1873
  { name: "components pr-post", handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsPrPost(ctx) },
1767
1874
  { name: "components pr-record", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsPrRecord(ctx) },
1875
+ // #4616: the agent jobs' three steps. Imported on first use; none loads plugins.
1876
+ { name: "agent prepare", handler: async (ctx) => (await import("./handlers/agent.js")).runAgentCommandLine(ctx) },
1877
+ { name: "agent run", handler: async (ctx) => (await import("./handlers/agent.js")).runAgentCommandLine(ctx) },
1878
+ { name: "agent land", handler: async (ctx) => (await import("./handlers/agent.js")).runAgentCommandLine(ctx) },
1768
1879
  { name: "components pr-env", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr-env.js")).runComponentsPrEnv(ctx) },
1769
1880
  { name: "components status", requiresPlugins: true, handler: runComponentsStatus },
1770
1881
  { name: "components release", handler: runComponentsReleaseRecord },
@@ -0,0 +1,36 @@
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
+ import type { ToolDefinition, ToolHandler } from "./types.js";
22
+ import { type ChantCommand } from "./workspace-tools.js";
23
+ /** The tables `chant ledger` reads, in its usage order. */
24
+ export declare const LEDGER_TABLES: readonly ["resources", "snapshots", "runs", "gates", "deploys", "releases", "cuts"];
25
+ export declare const ledgerReadTools: ToolDefinition[];
26
+ /** The `chant` arguments each ledger tool runs, from its input. */
27
+ export declare function ledgerArgv(tool: string, params: Record<string, unknown>): string[];
28
+ /** The ledger read tools, bound to the server's directory. */
29
+ export declare function createLedgerTools(options: {
30
+ cwd: string;
31
+ chantCommand?: ChantCommand;
32
+ }): {
33
+ definition: ToolDefinition;
34
+ handler: ToolHandler;
35
+ }[];
36
+ //# sourceMappingURL=ledger-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ledger-tools.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/ledger-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEhF,2DAA2D;AAC3D,eAAO,MAAM,aAAa,YAAI,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC;AA8BjH,eAAO,MAAM,eAAe,EAAE,cAAc,EAoC3C,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAsBlF;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,UAAU,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,EAAE,CAM/I"}
@@ -0,0 +1,122 @@
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
+ import { ownChantCommand, runRead } from "./workspace-tools.js";
22
+ /** The tables `chant ledger` reads, in its usage order. */
23
+ export const LEDGER_TABLES = ["resources", "snapshots", "runs", "gates", "deploys", "releases", "cuts"];
24
+ class ToolInputError extends Error {
25
+ }
26
+ function str(params, key, required = false) {
27
+ const v = params[key];
28
+ if (v === undefined || v === null) {
29
+ if (required)
30
+ throw new ToolInputError(`${key} is required`);
31
+ return undefined;
32
+ }
33
+ if (typeof v !== "string" || v === "")
34
+ throw new ToolInputError(`${key} must be a non-empty string`);
35
+ // A value is passed as one argument; one that starts with - would read as a flag.
36
+ if (v.startsWith("-"))
37
+ throw new ToolInputError(`${key} may not start with -: ${JSON.stringify(v)}`);
38
+ return v;
39
+ }
40
+ function list(params, key) {
41
+ const v = params[key];
42
+ if (v === undefined || v === null)
43
+ return [];
44
+ const items = typeof v === "string" ? [v] : v;
45
+ if (!Array.isArray(items))
46
+ 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
+ const memberProp = {
50
+ type: "array",
51
+ items: { type: "string" },
52
+ description: "Only these workspace members' ledgers (--member). Outside a workspace the project's own ledger is read.",
53
+ };
54
+ export const ledgerReadTools = [
55
+ {
56
+ name: "ledger",
57
+ description: "One ledger's rows from the local chant/lifecycle branch: chant ledger <table> --json (#4363). Tables: " +
58
+ LEDGER_TABLES.join(", ") +
59
+ ". 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.",
60
+ inputSchema: {
61
+ type: "object",
62
+ properties: {
63
+ table: { type: "string", enum: [...LEDGER_TABLES], description: "The ledger to read." },
64
+ member: memberProp,
65
+ where: {
66
+ type: "array",
67
+ items: { type: "string" },
68
+ description: "Typed filters, each <field><op><value> such as state=failed (--where, repeatable).",
69
+ },
70
+ since: { type: "string", description: "Only rows at or after this time (--since)." },
71
+ at: { type: "string", description: "Read the ledger as this commit of chant/lifecycle held it (--at)." },
72
+ },
73
+ required: ["table"],
74
+ },
75
+ },
76
+ {
77
+ name: "query",
78
+ description: "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.",
79
+ inputSchema: {
80
+ type: "object",
81
+ properties: {
82
+ sql: { type: "string", description: "The SQL statement." },
83
+ member: memberProp,
84
+ },
85
+ required: ["sql"],
86
+ },
87
+ },
88
+ ];
89
+ /** The `chant` arguments each ledger tool runs, from its input. */
90
+ export function ledgerArgv(tool, params) {
91
+ const members = list(params, "member").flatMap((m) => ["--member", m]);
92
+ switch (tool) {
93
+ case "ledger": {
94
+ const table = str(params, "table", true);
95
+ if (!LEDGER_TABLES.includes(table))
96
+ throw new ToolInputError(`table must be one of ${LEDGER_TABLES.join(", ")}`);
97
+ const where = list(params, "where").flatMap((w) => ["--where", w]);
98
+ const flags = ["since", "at"].flatMap((f) => {
99
+ const v = str(params, f);
100
+ return v !== undefined ? [`--${f}`, v] : [];
101
+ });
102
+ return ["ledger", table, ...members, ...where, ...flags, "--json"];
103
+ }
104
+ case "query": {
105
+ // The statement is one argument after `--`, so text that opens with - stays SQL.
106
+ const sql = params.sql;
107
+ if (typeof sql !== "string" || sql.trim() === "")
108
+ throw new ToolInputError("sql must be a non-empty string");
109
+ return ["query", ...members, "--json", "--", sql];
110
+ }
111
+ default:
112
+ throw new ToolInputError(`${tool} is not a ledger read tool`);
113
+ }
114
+ }
115
+ /** The ledger read tools, bound to the server's directory. */
116
+ export function createLedgerTools(options) {
117
+ const chant = options.chantCommand ?? ownChantCommand();
118
+ return ledgerReadTools.map((definition) => ({
119
+ definition,
120
+ handler: async (params) => runRead(chant, ledgerArgv(definition.name, params), options.cwd),
121
+ }));
122
+ }
@@ -0,0 +1,78 @@
1
+ /**
2
+ * chant#4555: the product tool hook on `chant serve mcp`. A CI product built
3
+ * on chant (terragucci, plywood) adds its own tools to chant's server rather
4
+ * than running a server of its own: its bin calls
5
+ * `runChantInProcess(["serve", "mcp"], words, { mcp: hook })`
6
+ * (`@intentius/chant/ci-product`), or constructs `McpServer` with
7
+ * `product: hook`.
8
+ *
9
+ * Read-only by default, under the rule chant#4543 set for every contributed
10
+ * tool:
11
+ *
12
+ * - a server started through the hook is read-only unless the hook says
13
+ * `readOnly: false`;
14
+ * - a read-only server serves a product tool only when it declares
15
+ * `readOnly: true` (`servesContributedTool`);
16
+ * - a read-only server refuses to start with a product tool whose name says
17
+ * it would approve, apply, override or write ({@link productToolWriteWord}),
18
+ * the check terragucci's own server made (`assertReadOnly`);
19
+ * - the tools read the report store through a reader that cannot write, with
20
+ * the server's own credentials, never from a tool's arguments.
21
+ *
22
+ * Tools are registered as `<product>:<name>`, as a lexicon's are.
23
+ */
24
+ import type { McpToolContribution } from "../../mcp/types.js";
25
+ import { type ReportReader } from "./report-tools.js";
26
+ /** What a product's tools are handed. */
27
+ export interface ProductMcpContext {
28
+ /** The directory the server serves. */
29
+ cwd: string;
30
+ /** Whether the server is read-only. */
31
+ readOnly: boolean;
32
+ /**
33
+ * The report store, read-only: the hook's `reportUrl`, else the declared
34
+ * `ci.reportUrl`. Resolves undefined when neither names one.
35
+ */
36
+ reports(): Promise<ReportReader | undefined>;
37
+ }
38
+ /** A product's tools on chant's MCP server. */
39
+ export interface ProductMcpHook {
40
+ /** The product's name, the tools' namespace: `terragucci`, `plywood`. */
41
+ product: string;
42
+ /** The product's tools. Called once, when the server starts. */
43
+ tools(ctx: ProductMcpContext): McpToolContribution[];
44
+ /** The report store the tools read. Default: the workspace's `ci.reportUrl`. */
45
+ reportUrl?: string;
46
+ /** `false` starts an ordinary server through the hook. Default: read-only. */
47
+ readOnly?: boolean;
48
+ /** Text added to the server's `initialize` instructions. */
49
+ instructions?: string;
50
+ }
51
+ /** Words that say a tool would change something; a read-only server will not serve a tool named with one. terragucci's list. */
52
+ export declare const PRODUCT_TOOL_WRITE_WORDS: readonly ["approve", "apply", "override", "revoke", "unlock", "lock", "merge", "resume", "migrate", "write", "put", "delete", "push", "commit", "publish", "reconcile", "rollout", "init", "generate", "respond", "relay", "notify", "update", "create", "exec"];
53
+ /** The words that refuse a name wherever they stand in it, not only first. */
54
+ export declare const PRODUCT_TOOL_STRONG_WORDS: readonly ["approve", "override", "revoke", "unlock", "merge", "write", "delete", "push", "commit", "publish", "exec"];
55
+ /**
56
+ * The word in `name` that says the tool would change something, or
57
+ * undefined. A name may not start with a write word, and may not hold a
58
+ * strong one anywhere: `last_apply` reads, `apply_wave` and `wave_approve`
59
+ * do not.
60
+ */
61
+ export declare function productToolWriteWord(name: string): string | undefined;
62
+ /** A read-only server refused a product tool named as a write. */
63
+ export declare class ProductToolRefusedError extends Error {
64
+ constructor(product: string, name: string, word: string);
65
+ }
66
+ /**
67
+ * The product tools a server serves: on a read-only server only those that
68
+ * declare `readOnly: true`, and none named as a write (a throw, so the server
69
+ * does not start). On an ordinary server every tool.
70
+ */
71
+ export declare function productToolsServed(hook: ProductMcpHook, ctx: ProductMcpContext): McpToolContribution[];
72
+ /** The context a hook's tools get on a server at `cwd`. The store is opened on first read. */
73
+ export declare function productMcpContext(hook: ProductMcpHook, cwd: string, readOnly: boolean): ProductMcpContext;
74
+ /** The hook the running command serves, set by a product's bin. */
75
+ export declare function activeProductMcpHook(): ProductMcpHook | undefined;
76
+ /** Run `fn` with `hook` active, and put the earlier one back after it settles. */
77
+ export declare function withProductMcpHook<T>(hook: ProductMcpHook | undefined, fn: () => Promise<T>): Promise<T>;
78
+ //# sourceMappingURL=product-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"product-tools.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/product-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/E,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;CAC9C;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,KAAK,CAAC,GAAG,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CAAC;IACrD,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,gIAAgI;AAChI,eAAO,MAAM,wBAAwB,YAAI,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAEzS,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,YAAI,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAE/J;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIrE;AAED,kEAAkE;AAClE,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAGtD;CACF;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CAUtG;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,iBAAiB,CAQzG;AAID,mEAAmE;AACnE,wBAAgB,oBAAoB,IAAI,cAAc,GAAG,SAAS,CAEjE;AAED,kFAAkF;AAClF,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAS9G"}
@@ -0,0 +1,93 @@
1
+ /**
2
+ * chant#4555: the product tool hook on `chant serve mcp`. A CI product built
3
+ * on chant (terragucci, plywood) adds its own tools to chant's server rather
4
+ * than running a server of its own: its bin calls
5
+ * `runChantInProcess(["serve", "mcp"], words, { mcp: hook })`
6
+ * (`@intentius/chant/ci-product`), or constructs `McpServer` with
7
+ * `product: hook`.
8
+ *
9
+ * Read-only by default, under the rule chant#4543 set for every contributed
10
+ * tool:
11
+ *
12
+ * - a server started through the hook is read-only unless the hook says
13
+ * `readOnly: false`;
14
+ * - a read-only server serves a product tool only when it declares
15
+ * `readOnly: true` (`servesContributedTool`);
16
+ * - a read-only server refuses to start with a product tool whose name says
17
+ * it would approve, apply, override or write ({@link productToolWriteWord}),
18
+ * the check terragucci's own server made (`assertReadOnly`);
19
+ * - the tools read the report store through a reader that cannot write, with
20
+ * the server's own credentials, never from a tool's arguments.
21
+ *
22
+ * Tools are registered as `<product>:<name>`, as a lexicon's are.
23
+ */
24
+ import { servesContributedTool } from "./read-only.js";
25
+ import { reportReader, reportUrlFor } from "./report-tools.js";
26
+ /** Words that say a tool would change something; a read-only server will not serve a tool named with one. terragucci's list. */
27
+ export const PRODUCT_TOOL_WRITE_WORDS = ["approve", "apply", "override", "revoke", "unlock", "lock", "merge", "resume", "migrate", "write", "put", "delete", "push", "commit", "publish", "reconcile", "rollout", "init", "generate", "respond", "relay", "notify", "update", "create", "exec"];
28
+ /** The words that refuse a name wherever they stand in it, not only first. */
29
+ export const PRODUCT_TOOL_STRONG_WORDS = ["approve", "override", "revoke", "unlock", "merge", "write", "delete", "push", "commit", "publish", "exec"];
30
+ /**
31
+ * The word in `name` that says the tool would change something, or
32
+ * undefined. A name may not start with a write word, and may not hold a
33
+ * strong one anywhere: `last_apply` reads, `apply_wave` and `wave_approve`
34
+ * do not.
35
+ */
36
+ export function productToolWriteWord(name) {
37
+ const parts = name.toLowerCase().split(/[^a-z]+/).filter(Boolean);
38
+ const first = parts[0] ?? "";
39
+ return PRODUCT_TOOL_WRITE_WORDS.find((w) => first.startsWith(w)) ?? PRODUCT_TOOL_STRONG_WORDS.find((w) => parts.some((p) => p.startsWith(w)));
40
+ }
41
+ /** A read-only server refused a product tool named as a write. */
42
+ export class ProductToolRefusedError extends Error {
43
+ constructor(product, name, word) {
44
+ super(`chant serve mcp is read-only for ${product}, and the tool ${name} would ${word}; the server does not start with it`);
45
+ this.name = "ProductToolRefusedError";
46
+ }
47
+ }
48
+ const PRODUCT = /^[a-z0-9][a-z0-9-]*$/;
49
+ /**
50
+ * The product tools a server serves: on a read-only server only those that
51
+ * declare `readOnly: true`, and none named as a write (a throw, so the server
52
+ * does not start). On an ordinary server every tool.
53
+ */
54
+ export function productToolsServed(hook, ctx) {
55
+ if (!PRODUCT.test(hook.product))
56
+ throw new Error(`the product tool hook's product ${JSON.stringify(hook.product)} is not a product name ([a-z0-9-])`);
57
+ const served = hook.tools(ctx).filter((t) => servesContributedTool(t, ctx.readOnly));
58
+ if (ctx.readOnly) {
59
+ for (const t of served) {
60
+ const word = productToolWriteWord(t.name.startsWith(`${hook.product}:`) ? t.name.slice(hook.product.length + 1) : t.name);
61
+ if (word)
62
+ throw new ProductToolRefusedError(hook.product, t.name, word);
63
+ }
64
+ }
65
+ return served;
66
+ }
67
+ /** The context a hook's tools get on a server at `cwd`. The store is opened on first read. */
68
+ export function productMcpContext(hook, cwd, readOnly) {
69
+ let opened;
70
+ return {
71
+ cwd,
72
+ readOnly,
73
+ reports: () => (opened ?? (opened = reportUrlFor(hook.reportUrl, cwd).then((url) => (url ? reportReader(url) : undefined)))),
74
+ };
75
+ }
76
+ let active;
77
+ /** The hook the running command serves, set by a product's bin. */
78
+ export function activeProductMcpHook() {
79
+ return active;
80
+ }
81
+ /** Run `fn` with `hook` active, and put the earlier one back after it settles. */
82
+ export async function withProductMcpHook(hook, fn) {
83
+ if (!hook)
84
+ return fn();
85
+ const was = active;
86
+ active = hook;
87
+ try {
88
+ return await fn();
89
+ }
90
+ finally {
91
+ active = was;
92
+ }
93
+ }