@intentius/chant 0.124.54 → 0.124.55

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (894) hide show
  1. package/dist/__fixtures__/estate-ledger.d.ts +13 -0
  2. package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
  3. package/dist/__fixtures__/estate-ledger.js +67 -0
  4. package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
  5. package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
  6. package/dist/__fixtures__/oidc-emulator.js +26 -2
  7. package/dist/__fixtures__/product-words.d.ts +78 -0
  8. package/dist/__fixtures__/product-words.d.ts.map +1 -0
  9. package/dist/__fixtures__/product-words.js +43 -0
  10. package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  11. package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  12. package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  13. package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  14. package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  15. package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  16. package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
  17. package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
  18. package/dist/__golden__/wave-loop/op-held-on.json +28 -7
  19. package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  20. package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  21. package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  22. package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
  23. package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  24. package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
  25. package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
  26. package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
  27. package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  28. package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  29. package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
  30. package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  31. package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  32. package/dist/__golden__/wave-loop/op-overridden.json +28 -7
  33. package/dist/__golden__/wave-loop/op-per-run.json +20 -4
  34. package/dist/__golden__/wave-loop/op-point.json +18 -4
  35. package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
  36. package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
  37. package/dist/__golden__/wave-loop/op-spend.json +10 -2
  38. package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
  39. package/dist/__golden__/wave-loop/op-wide.json +20 -4
  40. package/dist/bucket-check/azure.d.ts +108 -0
  41. package/dist/bucket-check/azure.d.ts.map +1 -0
  42. package/dist/bucket-check/azure.js +258 -0
  43. package/dist/bucket-check/fixtures/azure.json +153 -0
  44. package/dist/bucket-check/fixtures/gcs.json +148 -0
  45. package/dist/bucket-check/fixtures/s3.json +277 -0
  46. package/dist/bucket-check/gcs.d.ts +77 -0
  47. package/dist/bucket-check/gcs.d.ts.map +1 -0
  48. package/dist/bucket-check/gcs.js +202 -0
  49. package/dist/bucket-check/index.d.ts +48 -0
  50. package/dist/bucket-check/index.d.ts.map +1 -0
  51. package/dist/bucket-check/index.js +44 -0
  52. package/dist/bucket-check/s3.d.ts +116 -0
  53. package/dist/bucket-check/s3.d.ts.map +1 -0
  54. package/dist/bucket-check/s3.js +362 -0
  55. package/dist/bucket-check/types.d.ts +66 -0
  56. package/dist/bucket-check/types.d.ts.map +1 -0
  57. package/dist/bucket-check/types.js +31 -0
  58. package/dist/bucket-check/wire.d.ts +27 -0
  59. package/dist/bucket-check/wire.d.ts.map +1 -0
  60. package/dist/bucket-check/wire.js +32 -0
  61. package/dist/bucket-check.d.ts +6 -0
  62. package/dist/bucket-check.d.ts.map +1 -0
  63. package/dist/bucket-check.js +5 -0
  64. package/dist/capabilities/templates.d.ts.map +1 -1
  65. package/dist/capabilities/templates.js +1 -2
  66. package/dist/change-set.d.ts.map +1 -1
  67. package/dist/change-set.js +2 -3
  68. package/dist/ci-agent.d.ts +381 -0
  69. package/dist/ci-agent.d.ts.map +1 -0
  70. package/dist/ci-agent.js +833 -0
  71. package/dist/ci-control.d.ts +42 -0
  72. package/dist/ci-control.d.ts.map +1 -0
  73. package/dist/ci-control.js +42 -0
  74. package/dist/ci-estate/delivery.d.ts +137 -0
  75. package/dist/ci-estate/delivery.d.ts.map +1 -0
  76. package/dist/ci-estate/delivery.js +311 -0
  77. package/dist/ci-estate/overdue.d.ts +34 -0
  78. package/dist/ci-estate/overdue.d.ts.map +1 -0
  79. package/dist/ci-estate/overdue.js +58 -0
  80. package/dist/ci-estate/page.d.ts +134 -0
  81. package/dist/ci-estate/page.d.ts.map +1 -0
  82. package/dist/ci-estate/page.js +233 -0
  83. package/dist/ci-estate/rows.d.ts +118 -0
  84. package/dist/ci-estate/rows.d.ts.map +1 -0
  85. package/dist/ci-estate/rows.js +126 -0
  86. package/dist/ci-estate.d.ts +68 -0
  87. package/dist/ci-estate.d.ts.map +1 -0
  88. package/dist/ci-estate.js +83 -0
  89. package/dist/ci-handover.d.ts +29 -5
  90. package/dist/ci-handover.d.ts.map +1 -1
  91. package/dist/ci-handover.js +50 -16
  92. package/dist/ci-identity.d.ts +82 -7
  93. package/dist/ci-identity.d.ts.map +1 -1
  94. package/dist/ci-identity.js +87 -15
  95. package/dist/ci-product-words.d.ts +290 -0
  96. package/dist/ci-product-words.d.ts.map +1 -0
  97. package/dist/ci-product-words.js +373 -0
  98. package/dist/ci-product.d.ts +82 -0
  99. package/dist/ci-product.d.ts.map +1 -0
  100. package/dist/ci-product.js +78 -0
  101. package/dist/cli/commands/audit.d.ts +2 -2
  102. package/dist/cli/commands/audit.d.ts.map +1 -1
  103. package/dist/cli/commands/audit.js +3 -2
  104. package/dist/cli/commands/carve.js +2 -2
  105. package/dist/cli/commands/init.d.ts +2 -0
  106. package/dist/cli/commands/init.d.ts.map +1 -1
  107. package/dist/cli/commands/init.js +1 -1
  108. package/dist/cli/handlers/agent.d.ts +17 -0
  109. package/dist/cli/handlers/agent.d.ts.map +1 -0
  110. package/dist/cli/handlers/agent.js +114 -0
  111. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  112. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  113. package/dist/cli/handlers/approve-confirm.js +142 -0
  114. package/dist/cli/handlers/approve.d.ts.map +1 -1
  115. package/dist/cli/handlers/approve.js +19 -1
  116. package/dist/cli/handlers/build.d.ts.map +1 -1
  117. package/dist/cli/handlers/build.js +43 -1
  118. package/dist/cli/handlers/ci-check.d.ts +3 -0
  119. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  120. package/dist/cli/handlers/ci-check.js +34 -0
  121. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  122. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  123. package/dist/cli/handlers/ci-forge-check.js +89 -0
  124. package/dist/cli/handlers/fan-out.js +4 -0
  125. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  126. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  127. package/dist/cli/handlers/gate-pending.js +44 -0
  128. package/dist/cli/handlers/init.d.ts.map +1 -1
  129. package/dist/cli/handlers/init.js +1 -0
  130. package/dist/cli/handlers/ledger.js +1 -1
  131. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  132. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  133. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  134. package/dist/cli/handlers/lock.d.ts.map +1 -1
  135. package/dist/cli/handlers/lock.js +64 -5
  136. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  137. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  138. package/dist/cli/handlers/notify-relay.js +130 -0
  139. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  140. package/dist/cli/handlers/pr-env.js +42 -11
  141. package/dist/cli/handlers/pr.d.ts +38 -3
  142. package/dist/cli/handlers/pr.d.ts.map +1 -1
  143. package/dist/cli/handlers/pr.js +653 -205
  144. package/dist/cli/handlers/promote.d.ts.map +1 -1
  145. package/dist/cli/handlers/promote.js +21 -2
  146. package/dist/cli/handlers/release.d.ts.map +1 -1
  147. package/dist/cli/handlers/release.js +3 -0
  148. package/dist/cli/handlers/run-wave.d.ts +8 -0
  149. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  150. package/dist/cli/handlers/run-wave.js +71 -1
  151. package/dist/cli/handlers/run.d.ts +6 -1
  152. package/dist/cli/handlers/run.d.ts.map +1 -1
  153. package/dist/cli/handlers/run.js +86 -1
  154. package/dist/cli/handlers/serve.d.ts.map +1 -1
  155. package/dist/cli/handlers/serve.js +10 -1
  156. package/dist/cli/main.d.ts +11 -1
  157. package/dist/cli/main.d.ts.map +1 -1
  158. package/dist/cli/main.js +124 -13
  159. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  160. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  161. package/dist/cli/mcp/ledger-tools.js +122 -0
  162. package/dist/cli/mcp/product-tools.d.ts +78 -0
  163. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  164. package/dist/cli/mcp/product-tools.js +93 -0
  165. package/dist/cli/mcp/read-only.d.ts +34 -0
  166. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  167. package/dist/cli/mcp/read-only.js +61 -0
  168. package/dist/cli/mcp/report-tools.d.ts +48 -0
  169. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  170. package/dist/cli/mcp/report-tools.js +128 -0
  171. package/dist/cli/mcp/server.d.ts +28 -1
  172. package/dist/cli/mcp/server.d.ts.map +1 -1
  173. package/dist/cli/mcp/server.js +86 -15
  174. package/dist/cli/mcp-config.d.ts +9 -2
  175. package/dist/cli/mcp-config.d.ts.map +1 -1
  176. package/dist/cli/mcp-config.js +8 -3
  177. package/dist/cli/parse-args.d.ts.map +1 -1
  178. package/dist/cli/parse-args.js +57 -3
  179. package/dist/cli/registry.d.ts +35 -0
  180. package/dist/cli/registry.d.ts.map +1 -1
  181. package/dist/cloud-lister/sigv4.d.ts +42 -7
  182. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  183. package/dist/cloud-lister/sigv4.js +72 -22
  184. package/dist/components/adoption.d.ts +69 -0
  185. package/dist/components/adoption.d.ts.map +1 -0
  186. package/dist/components/adoption.js +93 -0
  187. package/dist/components/apply-lease.d.ts +19 -0
  188. package/dist/components/apply-lease.d.ts.map +1 -0
  189. package/dist/components/apply-lease.js +41 -0
  190. package/dist/components/capability.d.ts +122 -5
  191. package/dist/components/capability.d.ts.map +1 -1
  192. package/dist/components/capability.js +14 -6
  193. package/dist/components/check-hooks.d.ts +113 -0
  194. package/dist/components/check-hooks.d.ts.map +1 -0
  195. package/dist/components/check-hooks.js +192 -0
  196. package/dist/components/ci-services.d.ts +57 -0
  197. package/dist/components/ci-services.d.ts.map +1 -0
  198. package/dist/components/ci-services.js +61 -0
  199. package/dist/components/cli-support.d.ts +13 -0
  200. package/dist/components/cli-support.d.ts.map +1 -1
  201. package/dist/components/cli-support.js +10 -2
  202. package/dist/components/driver.d.ts +20 -3
  203. package/dist/components/driver.d.ts.map +1 -1
  204. package/dist/components/driver.js +24 -4
  205. package/dist/components/fan-out-run.d.ts +12 -0
  206. package/dist/components/fan-out-run.d.ts.map +1 -1
  207. package/dist/components/fan-out-run.js +56 -16
  208. package/dist/components/groups.d.ts.map +1 -1
  209. package/dist/components/groups.js +19 -2
  210. package/dist/components/pr-env-ledger.d.ts +32 -0
  211. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  212. package/dist/components/pr-env-ledger.js +39 -0
  213. package/dist/components/pr-env-ports.d.ts +12 -0
  214. package/dist/components/pr-env-ports.d.ts.map +1 -1
  215. package/dist/components/pr-env-ports.js +13 -3
  216. package/dist/components/pr-env-run.d.ts +6 -0
  217. package/dist/components/pr-env-run.d.ts.map +1 -1
  218. package/dist/components/pr-env-run.js +3 -2
  219. package/dist/components/pr-environment.d.ts +31 -3
  220. package/dist/components/pr-environment.d.ts.map +1 -1
  221. package/dist/components/pr-environment.js +25 -7
  222. package/dist/components/pr-pipeline.d.ts +169 -3
  223. package/dist/components/pr-pipeline.d.ts.map +1 -1
  224. package/dist/components/pr-pipeline.js +184 -9
  225. package/dist/components/pr-policy.d.ts +26 -2
  226. package/dist/components/pr-policy.d.ts.map +1 -1
  227. package/dist/components/pr-policy.js +41 -7
  228. package/dist/components/pr-run.d.ts +63 -0
  229. package/dist/components/pr-run.d.ts.map +1 -1
  230. package/dist/components/pr-run.js +82 -3
  231. package/dist/components/pr-targets.d.ts +24 -0
  232. package/dist/components/pr-targets.d.ts.map +1 -0
  233. package/dist/components/pr-targets.js +48 -0
  234. package/dist/components/product-pipeline.d.ts +217 -0
  235. package/dist/components/product-pipeline.d.ts.map +1 -0
  236. package/dist/components/product-pipeline.js +193 -0
  237. package/dist/components/promote.d.ts +6 -0
  238. package/dist/components/promote.d.ts.map +1 -1
  239. package/dist/components/promote.js +4 -1
  240. package/dist/components/release-compile.d.ts +22 -1
  241. package/dist/components/release-compile.d.ts.map +1 -1
  242. package/dist/components/release-compile.js +85 -0
  243. package/dist/components/release-promote.d.ts +15 -1
  244. package/dist/components/release-promote.d.ts.map +1 -1
  245. package/dist/components/release-promote.js +67 -2
  246. package/dist/components/repo-lock.d.ts +27 -0
  247. package/dist/components/repo-lock.d.ts.map +1 -0
  248. package/dist/components/repo-lock.js +49 -0
  249. package/dist/components/row-lease.d.ts +84 -0
  250. package/dist/components/row-lease.d.ts.map +1 -0
  251. package/dist/components/row-lease.js +110 -0
  252. package/dist/components/wave-plan.d.ts +34 -0
  253. package/dist/components/wave-plan.d.ts.map +1 -1
  254. package/dist/components/wave-plan.js +54 -2
  255. package/dist/control/applied.d.ts +89 -0
  256. package/dist/control/applied.d.ts.map +1 -0
  257. package/dist/control/applied.js +175 -0
  258. package/dist/control/consumers.d.ts +78 -0
  259. package/dist/control/consumers.d.ts.map +1 -0
  260. package/dist/control/consumers.js +172 -0
  261. package/dist/control/dispatch.d.ts +334 -0
  262. package/dist/control/dispatch.d.ts.map +1 -0
  263. package/dist/control/dispatch.js +519 -0
  264. package/dist/control/edges.d.ts +75 -0
  265. package/dist/control/edges.d.ts.map +1 -0
  266. package/dist/control/edges.js +133 -0
  267. package/dist/control/reconcile.d.ts +120 -0
  268. package/dist/control/reconcile.d.ts.map +1 -0
  269. package/dist/control/reconcile.js +178 -0
  270. package/dist/control/records.d.ts +187 -0
  271. package/dist/control/records.d.ts.map +1 -0
  272. package/dist/control/records.js +307 -0
  273. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  274. package/dist/discovery/sandbox/bundle.js +25 -1
  275. package/dist/engine-facts.d.ts.map +1 -1
  276. package/dist/engine-facts.js +1 -2
  277. package/dist/exit-codes.d.ts +48 -0
  278. package/dist/exit-codes.d.ts.map +1 -0
  279. package/dist/exit-codes.js +49 -0
  280. package/dist/forge-check/check.d.ts +63 -0
  281. package/dist/forge-check/check.d.ts.map +1 -0
  282. package/dist/forge-check/check.js +139 -0
  283. package/dist/forge-check/contract.d.ts +152 -0
  284. package/dist/forge-check/contract.d.ts.map +1 -0
  285. package/dist/forge-check/contract.js +118 -0
  286. package/dist/forge-check/forge.d.ts +42 -0
  287. package/dist/forge-check/forge.d.ts.map +1 -0
  288. package/dist/forge-check/forge.js +338 -0
  289. package/dist/forge-check/index.d.ts +24 -0
  290. package/dist/forge-check/index.d.ts.map +1 -0
  291. package/dist/forge-check/index.js +23 -0
  292. package/dist/forge-check/pulumi.d.ts +44 -0
  293. package/dist/forge-check/pulumi.d.ts.map +1 -0
  294. package/dist/forge-check/pulumi.js +184 -0
  295. package/dist/forge-check/read-only.d.ts +26 -0
  296. package/dist/forge-check/read-only.d.ts.map +1 -0
  297. package/dist/forge-check/read-only.js +53 -0
  298. package/dist/forge-check/trust.d.ts +94 -0
  299. package/dist/forge-check/trust.d.ts.map +1 -0
  300. package/dist/forge-check/trust.js +532 -0
  301. package/dist/forge-check/types.d.ts +80 -0
  302. package/dist/forge-check/types.d.ts.map +1 -0
  303. package/dist/forge-check/types.js +18 -0
  304. package/dist/forge-check.d.ts +6 -0
  305. package/dist/forge-check.d.ts.map +1 -0
  306. package/dist/forge-check.js +5 -0
  307. package/dist/gate-decision.d.ts +1 -0
  308. package/dist/gate-decision.d.ts.map +1 -1
  309. package/dist/gate-decision.js +2 -0
  310. package/dist/gate-policy.d.ts +47 -1
  311. package/dist/gate-policy.d.ts.map +1 -1
  312. package/dist/gate-policy.js +50 -2
  313. package/dist/index.d.ts +1 -0
  314. package/dist/index.d.ts.map +1 -1
  315. package/dist/index.js +2 -0
  316. package/dist/lexicon.d.ts +106 -6
  317. package/dist/lexicon.d.ts.map +1 -1
  318. package/dist/lifecycle/adoption-file.d.ts +24 -0
  319. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  320. package/dist/lifecycle/adoption-file.js +1 -2
  321. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  322. package/dist/lifecycle/cloud-index.js +1 -2
  323. package/dist/lifecycle/gate-applied.d.ts +6 -0
  324. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  325. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  326. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  327. package/dist/lifecycle/gate-ledger.js +11 -1
  328. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  329. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  330. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  331. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  332. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  333. package/dist/lifecycle/gated-request-digest.js +35 -0
  334. package/dist/lifecycle/gated-request.d.ts +126 -0
  335. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  336. package/dist/lifecycle/gated-request.js +205 -0
  337. package/dist/lifecycle/identity-match.d.ts +15 -0
  338. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  339. package/dist/lifecycle/identity-match.js +11 -6
  340. package/dist/lifecycle/index-diff.d.ts +40 -0
  341. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  342. package/dist/lifecycle/index-diff.js +1 -2
  343. package/dist/lifecycle/index-document.d.ts.map +1 -1
  344. package/dist/lifecycle/index-document.js +1 -2
  345. package/dist/lifecycle/index-import.d.ts +4 -1
  346. package/dist/lifecycle/index-import.d.ts.map +1 -1
  347. package/dist/lifecycle/index-import.js +29 -32
  348. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  349. package/dist/lifecycle/ledger-read.js +7 -3
  350. package/dist/lifecycle/lock-rows.d.ts +76 -0
  351. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  352. package/dist/lifecycle/lock-rows.js +140 -0
  353. package/dist/lifecycle/query.d.ts +50 -3
  354. package/dist/lifecycle/query.d.ts.map +1 -1
  355. package/dist/lifecycle/query.js +97 -6
  356. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  357. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  358. package/dist/lifecycle/release-catalog-site.js +232 -0
  359. package/dist/lifecycle/release-catalog.d.ts +201 -0
  360. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  361. package/dist/lifecycle/release-catalog.js +198 -0
  362. package/dist/lifecycle/release-changelog.d.ts +41 -0
  363. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  364. package/dist/lifecycle/release-changelog.js +38 -0
  365. package/dist/lifecycle/release-cut.d.ts +1 -0
  366. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  367. package/dist/lifecycle/release-cut.js +1 -1
  368. package/dist/lifecycle/release-ledger.d.ts +16 -0
  369. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  370. package/dist/lifecycle/release-ledger.js +10 -0
  371. package/dist/lifecycle/release-publish.d.ts +43 -22
  372. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  373. package/dist/lifecycle/release-read.d.ts.map +1 -1
  374. package/dist/lifecycle/release-read.js +3 -0
  375. package/dist/lifecycle/release-status.d.ts +86 -0
  376. package/dist/lifecycle/release-status.d.ts.map +1 -0
  377. package/dist/lifecycle/release-status.js +136 -0
  378. package/dist/lifecycle/resource-lock.d.ts +120 -0
  379. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  380. package/dist/lifecycle/resource-lock.js +317 -0
  381. package/dist/lifecycle/retention.d.ts.map +1 -1
  382. package/dist/lifecycle/retention.js +3 -0
  383. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  384. package/dist/lifecycle/run-ledger.js +9 -1
  385. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  386. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  387. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  388. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  389. package/dist/lifecycle/snapshot-store.js +1 -2
  390. package/dist/lifecycle/target-lock.d.ts +15 -0
  391. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  392. package/dist/lifecycle/target-lock.js +25 -10
  393. package/dist/mcp/types.d.ts +7 -0
  394. package/dist/mcp/types.d.ts.map +1 -1
  395. package/dist/notify-product.d.ts +43 -0
  396. package/dist/notify-product.d.ts.map +1 -0
  397. package/dist/notify-product.js +58 -0
  398. package/dist/notify-relay.d.ts +197 -0
  399. package/dist/notify-relay.d.ts.map +1 -0
  400. package/dist/notify-relay.js +321 -0
  401. package/dist/notify.d.ts +44 -4
  402. package/dist/notify.d.ts.map +1 -1
  403. package/dist/notify.js +77 -14
  404. package/dist/object-store/azure-blob.d.ts +129 -0
  405. package/dist/object-store/azure-blob.d.ts.map +1 -0
  406. package/dist/object-store/azure-blob.js +341 -0
  407. package/dist/object-store/common.d.ts +108 -0
  408. package/dist/object-store/common.d.ts.map +1 -0
  409. package/dist/object-store/common.js +80 -0
  410. package/dist/object-store/errors.d.ts +28 -0
  411. package/dist/object-store/errors.d.ts.map +1 -0
  412. package/dist/object-store/errors.js +21 -0
  413. package/dist/object-store/from-env.d.ts +18 -0
  414. package/dist/object-store/from-env.d.ts.map +1 -0
  415. package/dist/object-store/from-env.js +22 -0
  416. package/dist/object-store/gcs.d.ts +106 -0
  417. package/dist/object-store/gcs.d.ts.map +1 -0
  418. package/dist/object-store/gcs.js +393 -0
  419. package/dist/object-store/index.d.ts +9 -0
  420. package/dist/object-store/index.d.ts.map +1 -0
  421. package/dist/object-store/index.js +8 -0
  422. package/dist/object-store/s3.d.ts +146 -0
  423. package/dist/object-store/s3.d.ts.map +1 -0
  424. package/dist/object-store/s3.js +306 -0
  425. package/dist/op/activities/converge.d.ts.map +1 -1
  426. package/dist/op/activities/converge.js +2 -1
  427. package/dist/op/activities/index.d.ts +1 -1
  428. package/dist/op/activities/index.d.ts.map +1 -1
  429. package/dist/op/activities/index.js +1 -1
  430. package/dist/op/activities/review-agent.d.ts +55 -2
  431. package/dist/op/activities/review-agent.d.ts.map +1 -1
  432. package/dist/op/activities/review-agent.js +65 -5
  433. package/dist/op/gate.d.ts +29 -1
  434. package/dist/op/gate.d.ts.map +1 -1
  435. package/dist/op/gate.js +59 -23
  436. package/dist/op/generate-pipeline.d.ts.map +1 -1
  437. package/dist/op/generate-pipeline.js +7 -1
  438. package/dist/op/index.d.ts +12 -1
  439. package/dist/op/index.d.ts.map +1 -1
  440. package/dist/op/index.js +7 -1
  441. package/dist/op/op-waves-after-plan.d.ts +137 -0
  442. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  443. package/dist/op/op-waves-after-plan.js +163 -0
  444. package/dist/op/op-waves-capability-spec.d.ts +55 -0
  445. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  446. package/dist/op/op-waves-capability-spec.js +94 -0
  447. package/dist/op/op-waves-capability.d.ts +197 -0
  448. package/dist/op/op-waves-capability.d.ts.map +1 -0
  449. package/dist/op/op-waves-capability.js +311 -0
  450. package/dist/op/op-waves-events.d.ts +54 -0
  451. package/dist/op/op-waves-events.d.ts.map +1 -0
  452. package/dist/op/op-waves-events.js +122 -0
  453. package/dist/op/op-waves-notify.d.ts +7 -1
  454. package/dist/op/op-waves-notify.d.ts.map +1 -1
  455. package/dist/op/op-waves-notify.js +35 -16
  456. package/dist/op/op-waves-release-port.d.ts +18 -0
  457. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  458. package/dist/op/op-waves-release-port.js +61 -0
  459. package/dist/op/op-waves-release.d.ts +92 -0
  460. package/dist/op/op-waves-release.d.ts.map +1 -0
  461. package/dist/op/op-waves-release.js +97 -0
  462. package/dist/op/op-waves-run.d.ts +175 -4
  463. package/dist/op/op-waves-run.d.ts.map +1 -1
  464. package/dist/op/op-waves-run.js +981 -41
  465. package/dist/op/op-waves-stand-down.d.ts +60 -0
  466. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  467. package/dist/op/op-waves-stand-down.js +97 -0
  468. package/dist/op/op-waves.d.ts +152 -8
  469. package/dist/op/op-waves.d.ts.map +1 -1
  470. package/dist/op/op-waves.js +161 -17
  471. package/dist/op/runtime.d.ts +91 -0
  472. package/dist/op/runtime.d.ts.map +1 -1
  473. package/dist/op/runtime.js +19 -0
  474. package/dist/op/stage-hooks.d.ts +45 -7
  475. package/dist/op/stage-hooks.d.ts.map +1 -1
  476. package/dist/op/stage-hooks.js +61 -3
  477. package/dist/op/steward-beside.d.ts.map +1 -1
  478. package/dist/op/steward-beside.js +2 -1
  479. package/dist/op/types.d.ts +2 -2
  480. package/dist/op/types.d.ts.map +1 -1
  481. package/dist/op/types.js +3 -2
  482. package/dist/otlp-metrics.d.ts +38 -0
  483. package/dist/otlp-metrics.d.ts.map +1 -0
  484. package/dist/otlp-metrics.js +82 -0
  485. package/dist/otlp.d.ts +249 -0
  486. package/dist/otlp.d.ts.map +1 -0
  487. package/dist/otlp.js +426 -0
  488. package/dist/override-gate.d.ts.map +1 -1
  489. package/dist/override-gate.js +5 -0
  490. package/dist/policy-packs.d.ts +69 -0
  491. package/dist/policy-packs.d.ts.map +1 -0
  492. package/dist/policy-packs.js +205 -0
  493. package/dist/policy-source.d.ts +51 -0
  494. package/dist/policy-source.d.ts.map +1 -0
  495. package/dist/policy-source.js +103 -0
  496. package/dist/pr-forge.d.ts +40 -0
  497. package/dist/pr-forge.d.ts.map +1 -1
  498. package/dist/pr-forge.js +92 -0
  499. package/dist/pr-loop.d.ts +149 -11
  500. package/dist/pr-loop.d.ts.map +1 -1
  501. package/dist/pr-loop.js +283 -44
  502. package/dist/pr-post.d.ts +16 -0
  503. package/dist/pr-post.d.ts.map +1 -1
  504. package/dist/pr-post.js +26 -1
  505. package/dist/pr-report-url.d.ts +32 -4
  506. package/dist/pr-report-url.d.ts.map +1 -1
  507. package/dist/pr-report-url.js +46 -5
  508. package/dist/pr-requires.d.ts +13 -2
  509. package/dist/pr-requires.d.ts.map +1 -1
  510. package/dist/pr-requires.js +14 -0
  511. package/dist/release-floors.d.ts +1 -1
  512. package/dist/release-floors.js +1 -1
  513. package/dist/run-event.d.ts +26 -1
  514. package/dist/run-event.d.ts.map +1 -1
  515. package/dist/run-event.js +4 -1
  516. package/dist/sorted-json.d.ts +10 -0
  517. package/dist/sorted-json.d.ts.map +1 -0
  518. package/dist/sorted-json.js +14 -0
  519. package/dist/terraform/credentials.d.ts +59 -0
  520. package/dist/terraform/credentials.d.ts.map +1 -0
  521. package/dist/terraform/credentials.js +149 -0
  522. package/dist/utils.d.ts +1 -4
  523. package/dist/utils.d.ts.map +1 -1
  524. package/dist/utils.js +1 -9
  525. package/dist/wave-runtime.d.ts +1 -1
  526. package/dist/wave-runtime.js +2 -2
  527. package/dist/wave-runtime.mjs +390 -285
  528. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  529. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  530. package/dist/workspace/ci-lock-grain.d.ts +12 -0
  531. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  532. package/dist/workspace/ci-lock-grain.js +27 -0
  533. package/dist/workspace/ci-run.d.ts +2 -1
  534. package/dist/workspace/ci-run.d.ts.map +1 -1
  535. package/dist/workspace/ci-run.js +6 -3
  536. package/dist/workspace/declaration.d.ts +16 -4
  537. package/dist/workspace/declaration.d.ts.map +1 -1
  538. package/dist/workspace/declaration.js +5 -2
  539. package/dist/workspace/declaration.schema.json +27 -3
  540. package/dist/workspace/drift-cli.d.ts.map +1 -1
  541. package/dist/workspace/drift-cli.js +8 -3
  542. package/dist/workspace/exit-cli.d.ts +1 -1
  543. package/dist/workspace/exit-cli.d.ts.map +1 -1
  544. package/dist/workspace/exit-cli.js +2 -1
  545. package/dist/workspace/import-fetch.d.ts +4 -2
  546. package/dist/workspace/import-fetch.d.ts.map +1 -1
  547. package/dist/workspace/import-fetch.js +4 -2
  548. package/dist/workspace/import-init.d.ts.map +1 -1
  549. package/dist/workspace/import-init.js +4 -2
  550. package/dist/workspace/ledger.schema.json +7 -3
  551. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  552. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  553. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  554. package/dist/workspace/pr-report.schema.json +74 -3
  555. package/dist/workspace/promote.d.ts +1 -1
  556. package/dist/workspace/promote.d.ts.map +1 -1
  557. package/dist/workspace/promote.js +2 -1
  558. package/dist/workspace/records-cli.d.ts +2 -2
  559. package/dist/workspace/records-cli.d.ts.map +1 -1
  560. package/dist/workspace/records-cli.js +3 -2
  561. package/dist/workspace/release-catalog.schema.json +277 -0
  562. package/dist/workspace/run-event.schema.json +18 -1
  563. package/dist/workspace/work-cli.d.ts +3 -1
  564. package/dist/workspace/work-cli.d.ts.map +1 -1
  565. package/dist/workspace/work-cli.js +7 -2
  566. package/dist/workspace/workspace-run.d.ts.map +1 -1
  567. package/dist/workspace/workspace-run.js +2 -1
  568. package/package.json +21 -1
  569. package/src/__fixtures__/estate-ledger.ts +101 -0
  570. package/src/__fixtures__/oidc-emulator.ts +31 -2
  571. package/src/__fixtures__/product-words.ts +44 -0
  572. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  573. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  574. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  575. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  576. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  577. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  578. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  579. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  580. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  581. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  582. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  583. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  584. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  585. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  586. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  587. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  588. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  589. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  590. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  591. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  592. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  593. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  594. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  595. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  596. package/src/__golden__/wave-loop/op-point.json +18 -4
  597. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  598. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  599. package/src/__golden__/wave-loop/op-spend.json +10 -2
  600. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  601. package/src/__golden__/wave-loop/op-wide.json +20 -4
  602. package/src/bucket-check/azure.ts +307 -0
  603. package/src/bucket-check/bucket-check.test.ts +210 -0
  604. package/src/bucket-check/fixtures/azure.json +153 -0
  605. package/src/bucket-check/fixtures/gcs.json +148 -0
  606. package/src/bucket-check/fixtures/s3.json +277 -0
  607. package/src/bucket-check/gcs.ts +257 -0
  608. package/src/bucket-check/index.ts +61 -0
  609. package/src/bucket-check/s3.ts +433 -0
  610. package/src/bucket-check/types.ts +75 -0
  611. package/src/bucket-check/wire.ts +50 -0
  612. package/src/bucket-check.ts +5 -0
  613. package/src/capabilities/templates.test.ts +2 -3
  614. package/src/capabilities/templates.ts +1 -2
  615. package/src/cdk/advise.test.ts +1 -1
  616. package/src/change-set-bundle.test.ts +0 -1
  617. package/src/change-set.ts +2 -3
  618. package/src/ci-agent.test.ts +348 -0
  619. package/src/ci-agent.ts +1026 -0
  620. package/src/ci-control.ts +174 -0
  621. package/src/ci-estate/delivery.ts +433 -0
  622. package/src/ci-estate/overdue.ts +81 -0
  623. package/src/ci-estate/page.ts +343 -0
  624. package/src/ci-estate/rows.ts +251 -0
  625. package/src/ci-estate.test.ts +281 -0
  626. package/src/ci-estate.ts +176 -0
  627. package/src/ci-handover.ts +67 -16
  628. package/src/ci-identity-database.test.ts +55 -0
  629. package/src/ci-identity-pulumi.test.ts +163 -0
  630. package/src/ci-identity-targets.test.ts +6 -2
  631. package/src/ci-identity.ts +124 -22
  632. package/src/ci-product-words.test.ts +101 -0
  633. package/src/ci-product-words.ts +536 -0
  634. package/src/ci-product.ts +174 -0
  635. package/src/ci-shared-reads.test.ts +145 -0
  636. package/src/cli/commands/audit.test.ts +1 -1
  637. package/src/cli/commands/audit.ts +3 -2
  638. package/src/cli/commands/carve.test.ts +1 -1
  639. package/src/cli/commands/carve.ts +2 -2
  640. package/src/cli/commands/init.ts +3 -1
  641. package/src/cli/component-wave-args.test.ts +16 -0
  642. package/src/cli/handlers/agent.ts +126 -0
  643. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  644. package/src/cli/handlers/approve-confirm.ts +200 -0
  645. package/src/cli/handlers/approve.ts +18 -1
  646. package/src/cli/handlers/build.test.ts +7 -0
  647. package/src/cli/handlers/build.ts +44 -1
  648. package/src/cli/handlers/ci-check.ts +33 -0
  649. package/src/cli/handlers/ci-forge-check.ts +91 -0
  650. package/src/cli/handlers/fan-out.test.ts +10 -10
  651. package/src/cli/handlers/fan-out.ts +5 -0
  652. package/src/cli/handlers/gate-pending.ts +46 -0
  653. package/src/cli/handlers/init.ts +1 -0
  654. package/src/cli/handlers/ledger.ts +1 -1
  655. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  656. package/src/cli/handlers/lock.test.ts +29 -2
  657. package/src/cli/handlers/lock.ts +66 -6
  658. package/src/cli/handlers/notify-relay.ts +130 -0
  659. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  660. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  661. package/src/cli/handlers/pr-env.ts +48 -11
  662. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  663. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  664. package/src/cli/handlers/pr-waves.test.ts +8 -2
  665. package/src/cli/handlers/pr.test.ts +8 -8
  666. package/src/cli/handlers/pr.ts +655 -205
  667. package/src/cli/handlers/promote.test.ts +5 -5
  668. package/src/cli/handlers/promote.ts +22 -2
  669. package/src/cli/handlers/release.ts +2 -0
  670. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  671. package/src/cli/handlers/run-wave.ts +65 -1
  672. package/src/cli/handlers/run.test.ts +6 -4
  673. package/src/cli/handlers/run.ts +86 -1
  674. package/src/cli/handlers/serve.ts +10 -1
  675. package/src/cli/main.ts +126 -13
  676. package/src/cli/mcp/ledger-tools.ts +126 -0
  677. package/src/cli/mcp/product-tools.test.ts +123 -0
  678. package/src/cli/mcp/product-tools.ts +129 -0
  679. package/src/cli/mcp/read-only.test.ts +134 -0
  680. package/src/cli/mcp/read-only.ts +68 -0
  681. package/src/cli/mcp/report-tools.ts +135 -0
  682. package/src/cli/mcp/server.test.ts +5 -4
  683. package/src/cli/mcp/server.ts +90 -16
  684. package/src/cli/mcp-config.ts +8 -3
  685. package/src/cli/parse-args.ts +42 -2
  686. package/src/cli/registry.ts +35 -0
  687. package/src/cloud-lister/sigv4.ts +80 -23
  688. package/src/components/adoption.test.ts +140 -0
  689. package/src/components/adoption.ts +141 -0
  690. package/src/components/apply-lease.ts +49 -0
  691. package/src/components/capability.ts +130 -6
  692. package/src/components/check-hooks.test.ts +66 -0
  693. package/src/components/check-hooks.ts +252 -0
  694. package/src/components/ci-services.test.ts +51 -0
  695. package/src/components/ci-services.ts +83 -0
  696. package/src/components/cli-support.ts +23 -2
  697. package/src/components/driver.test.ts +3 -3
  698. package/src/components/driver.ts +38 -5
  699. package/src/components/fan-out-run.ts +68 -18
  700. package/src/components/groups.ts +17 -2
  701. package/src/components/pr-comment-preview.test.ts +54 -0
  702. package/src/components/pr-env-ledger.test.ts +9 -0
  703. package/src/components/pr-env-ledger.ts +43 -0
  704. package/src/components/pr-env-ports.ts +29 -4
  705. package/src/components/pr-env-run-bundle.test.ts +8 -0
  706. package/src/components/pr-env-run.test.ts +19 -0
  707. package/src/components/pr-env-run.ts +12 -2
  708. package/src/components/pr-environment.test.ts +29 -0
  709. package/src/components/pr-environment.ts +39 -7
  710. package/src/components/pr-pipeline.test.ts +15 -0
  711. package/src/components/pr-pipeline.ts +274 -9
  712. package/src/components/pr-policy.ts +45 -7
  713. package/src/components/pr-run.test.ts +1 -1
  714. package/src/components/pr-run.ts +121 -5
  715. package/src/components/pr-targets.test.ts +35 -0
  716. package/src/components/pr-targets.ts +45 -0
  717. package/src/components/product-pipeline.test.ts +200 -0
  718. package/src/components/product-pipeline.ts +341 -0
  719. package/src/components/promote.ts +10 -1
  720. package/src/components/release-compile.ts +87 -1
  721. package/src/components/release-promote.ts +65 -1
  722. package/src/components/repo-lock.ts +52 -0
  723. package/src/components/row-lease.test.ts +490 -0
  724. package/src/components/row-lease.ts +167 -0
  725. package/src/components/wave-plan-policy.test.ts +19 -0
  726. package/src/components/wave-plan.ts +78 -4
  727. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  728. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  729. package/src/control/applied.test.ts +148 -0
  730. package/src/control/applied.ts +191 -0
  731. package/src/control/consumers.test.ts +129 -0
  732. package/src/control/consumers.ts +192 -0
  733. package/src/control/control.test.ts +302 -0
  734. package/src/control/dispatch.ts +699 -0
  735. package/src/control/edges.test.ts +112 -0
  736. package/src/control/edges.ts +164 -0
  737. package/src/control/note-checkout.test.ts +91 -0
  738. package/src/control/reconcile.ts +250 -0
  739. package/src/control/records.ts +395 -0
  740. package/src/discovery/sandbox/bundle.ts +25 -1
  741. package/src/engine-facts.test.ts +2 -3
  742. package/src/engine-facts.ts +1 -2
  743. package/src/exit-codes.test.ts +31 -0
  744. package/src/exit-codes.ts +55 -0
  745. package/src/forge-check/check.ts +155 -0
  746. package/src/forge-check/contract.ts +215 -0
  747. package/src/forge-check/forge-check.test.ts +427 -0
  748. package/src/forge-check/forge.ts +318 -0
  749. package/src/forge-check/index.ts +43 -0
  750. package/src/forge-check/pulumi.ts +192 -0
  751. package/src/forge-check/read-only.ts +56 -0
  752. package/src/forge-check/trust.ts +527 -0
  753. package/src/forge-check/types.ts +78 -0
  754. package/src/forge-check.ts +5 -0
  755. package/src/gate-decision-bundle.test.ts +13 -0
  756. package/src/gate-decision.ts +3 -0
  757. package/src/gate-policy.ts +92 -3
  758. package/src/gated-waves-bundle.test.ts +0 -1
  759. package/src/index.ts +2 -0
  760. package/src/lexicon.ts +95 -6
  761. package/src/lifecycle/adoption-file.ts +1 -2
  762. package/src/lifecycle/cloud-index.test.ts +2 -3
  763. package/src/lifecycle/cloud-index.ts +1 -2
  764. package/src/lifecycle/control-entries-ledger.test.ts +70 -0
  765. package/src/lifecycle/gate-applied.ts +6 -0
  766. package/src/lifecycle/gate-ledger.ts +36 -1
  767. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  768. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  769. package/src/lifecycle/gated-request-digest.ts +49 -0
  770. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  771. package/src/lifecycle/gated-request.ts +280 -0
  772. package/src/lifecycle/identity-match.ts +25 -6
  773. package/src/lifecycle/index-diff.ts +1 -2
  774. package/src/lifecycle/index-document.ts +1 -2
  775. package/src/lifecycle/index-import.test.ts +14 -0
  776. package/src/lifecycle/index-import.ts +54 -34
  777. package/src/lifecycle/ledger-read.ts +7 -3
  778. package/src/lifecycle/lock-rows.test.ts +109 -0
  779. package/src/lifecycle/lock-rows.ts +167 -0
  780. package/src/lifecycle/publish-target-context.test.ts +108 -0
  781. package/src/lifecycle/query.test.ts +2 -3
  782. package/src/lifecycle/query.ts +109 -7
  783. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  784. package/src/lifecycle/release-catalog-site.ts +291 -0
  785. package/src/lifecycle/release-catalog.test.ts +193 -0
  786. package/src/lifecycle/release-catalog.ts +353 -0
  787. package/src/lifecycle/release-changelog.test.ts +70 -0
  788. package/src/lifecycle/release-changelog.ts +71 -0
  789. package/src/lifecycle/release-cut.ts +2 -2
  790. package/src/lifecycle/release-ledger.ts +20 -0
  791. package/src/lifecycle/release-publish.ts +45 -22
  792. package/src/lifecycle/release-read.ts +2 -0
  793. package/src/lifecycle/release-status.test.ts +186 -0
  794. package/src/lifecycle/release-status.ts +176 -0
  795. package/src/lifecycle/resource-lock.test.ts +175 -0
  796. package/src/lifecycle/resource-lock.ts +354 -0
  797. package/src/lifecycle/retention.ts +2 -0
  798. package/src/lifecycle/run-ledger.ts +7 -1
  799. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  800. package/src/lifecycle/snapshot-store.ts +1 -2
  801. package/src/lifecycle/target-lock.ts +24 -9
  802. package/src/mcp/types.ts +7 -0
  803. package/src/notify-product.ts +76 -0
  804. package/src/notify-relay.test.ts +213 -0
  805. package/src/notify-relay.ts +407 -0
  806. package/src/notify.ts +95 -14
  807. package/src/object-store/azure-blob.ts +374 -0
  808. package/src/object-store/common.ts +133 -0
  809. package/src/object-store/errors.ts +26 -0
  810. package/src/object-store/from-env.ts +36 -0
  811. package/src/object-store/gcs.ts +436 -0
  812. package/src/object-store/index.ts +8 -0
  813. package/src/object-store/object-store.test.ts +130 -0
  814. package/src/object-store/s3.ts +350 -0
  815. package/src/op/activities/converge.ts +2 -1
  816. package/src/op/activities/index.ts +1 -1
  817. package/src/op/activities/review-agent.open.test.ts +78 -0
  818. package/src/op/activities/review-agent.test.ts +13 -0
  819. package/src/op/activities/review-agent.ts +89 -5
  820. package/src/op/gate.ts +81 -22
  821. package/src/op/generate-pipeline.ts +7 -1
  822. package/src/op/index.ts +21 -0
  823. package/src/op/op-waves-after-plan.test.ts +276 -0
  824. package/src/op/op-waves-after-plan.ts +238 -0
  825. package/src/op/op-waves-capability-spec.ts +113 -0
  826. package/src/op/op-waves-capability.test.ts +217 -0
  827. package/src/op/op-waves-capability.ts +370 -0
  828. package/src/op/op-waves-events.ts +135 -0
  829. package/src/op/op-waves-notify-words.test.ts +149 -0
  830. package/src/op/op-waves-notify.ts +41 -16
  831. package/src/op/op-waves-pull-request.test.ts +142 -0
  832. package/src/op/op-waves-release-port.ts +64 -0
  833. package/src/op/op-waves-release.test.ts +209 -0
  834. package/src/op/op-waves-release.ts +133 -0
  835. package/src/op/op-waves-run-record.test.ts +32 -0
  836. package/src/op/op-waves-run.ts +1142 -49
  837. package/src/op/op-waves-stand-down.test.ts +240 -0
  838. package/src/op/op-waves-stand-down.ts +108 -0
  839. package/src/op/op-waves-trace.test.ts +205 -0
  840. package/src/op/op-waves.test.ts +112 -0
  841. package/src/op/op-waves.ts +261 -20
  842. package/src/op/runtime.ts +104 -0
  843. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  844. package/src/op/stage-hooks.ts +91 -12
  845. package/src/op/steward-beside.ts +2 -1
  846. package/src/op/types.ts +3 -2
  847. package/src/otlp-metrics.ts +96 -0
  848. package/src/otlp.test.ts +243 -0
  849. package/src/otlp.ts +544 -0
  850. package/src/override-gate-bundle.test.ts +2 -0
  851. package/src/override-gate.ts +4 -0
  852. package/src/policy-packs.ts +230 -0
  853. package/src/policy-source.test.ts +256 -0
  854. package/src/policy-source.ts +112 -0
  855. package/src/pr-forge.ts +123 -0
  856. package/src/pr-loop-bundle.test.ts +6 -2
  857. package/src/pr-loop-words.test.ts +155 -0
  858. package/src/pr-loop.ts +371 -52
  859. package/src/pr-post.ts +32 -1
  860. package/src/pr-report-url.ts +62 -6
  861. package/src/pr-requires.test.ts +37 -1
  862. package/src/pr-requires.ts +16 -2
  863. package/src/product-subpaths-plain-node.e2e.test.ts +211 -0
  864. package/src/release-floors.ts +1 -1
  865. package/src/run-event.ts +29 -1
  866. package/src/sorted-json.ts +17 -0
  867. package/src/stage-hooks-bundle.test.ts +8 -0
  868. package/src/terraform/credentials.test.ts +77 -0
  869. package/src/terraform/credentials.ts +162 -0
  870. package/src/utils.ts +2 -11
  871. package/src/wave-loop-golden.test.ts +2 -1
  872. package/src/wave-runtime.ts +2 -2
  873. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  874. package/src/workspace/ci-lock-grain.test.ts +31 -0
  875. package/src/workspace/ci-lock-grain.ts +30 -0
  876. package/src/workspace/ci-report-url.test.ts +1 -1
  877. package/src/workspace/ci-run.test.ts +1 -1
  878. package/src/workspace/ci-run.ts +6 -3
  879. package/src/workspace/declaration.schema.json +27 -3
  880. package/src/workspace/declaration.test.ts +1 -1
  881. package/src/workspace/declaration.ts +26 -10
  882. package/src/workspace/drift-cli.ts +8 -3
  883. package/src/workspace/exit-cli.ts +2 -1
  884. package/src/workspace/import-fetch.ts +4 -2
  885. package/src/workspace/import-init.ts +4 -2
  886. package/src/workspace/ledger.schema.json +7 -3
  887. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  888. package/src/workspace/pr-report.schema.json +74 -3
  889. package/src/workspace/promote.ts +2 -1
  890. package/src/workspace/records-cli.ts +3 -2
  891. package/src/workspace/release-catalog.schema.json +277 -0
  892. package/src/workspace/run-event.schema.json +18 -1
  893. package/src/workspace/work-cli.ts +8 -2
  894. package/src/workspace/workspace-run.ts +2 -1
@@ -0,0 +1,536 @@
1
+ /**
2
+ * A CI product's words (#4550): the names a product built on chant's pull
3
+ * request pipeline shows people, filled into chant's own sentences.
4
+ *
5
+ * terragucci and plywood run one chant pipeline. They differ only in the
6
+ * object they pass here: the status prefix, the stage and verb words, the
7
+ * noun for a member, the comment commands, the approve and override lines,
8
+ * and the op and gate names the waves record under. Every slot defaults to
9
+ * chant's word, so a plain chant pipeline renders as it always has.
10
+ *
11
+ * Job names, note markers, ledger paths, artifact names and GitLab variable
12
+ * names stay chant's. People never type them, and readers of the ledger and
13
+ * the artifacts key on them.
14
+ *
15
+ * The words reach a running job through the product's bin (ruling C,
16
+ * 2026-10-27): the generated jobs run the product's command, and its bin
17
+ * calls chant in process with its words (`runCommandInProcess(argv, {
18
+ * words })`, ../cli/main.ts), which sets them as the active words for the
19
+ * command's lifetime. Every renderer here reads {@link activeProductWords}
20
+ * when it is given none.
21
+ *
22
+ * This module imports nothing: the pull request loop bundle (pr-loop.ts,
23
+ * pr-loop-bundle.test.ts) carries it.
24
+ */
25
+
26
+ /** The stages a product names: the status context after the prefix, and the word in the note. */
27
+ export type CiProductStage = "plan" | "apply" | "record" | "check" | "drift" | "lock" | "approval" | "control";
28
+
29
+ /** Every stage slot, in the order {@link assertProductWords} reports them. */
30
+ export const CI_PRODUCT_STAGES: readonly CiProductStage[] = ["plan", "apply", "record", "check", "drift", "lock", "approval", "control"];
31
+
32
+ /** The commands a comment may name. Each one needs a job in the pipeline that answers it. */
33
+ export type CiProductCommand = "plan" | "apply" | "lock" | "unlock" | "agent";
34
+
35
+ export const CI_PRODUCT_COMMANDS: readonly CiProductCommand[] = ["plan", "apply", "lock", "unlock", "agent"];
36
+
37
+ /**
38
+ * What an approval of a product's waves binds to (ruling B, 2026-10-27).
39
+ * `per-wave`: each wave's own digest, as terragucci does. `pull-request`:
40
+ * the pull request's digest, covering every wave whose plan it covers, with
41
+ * a wave whose plan moved stopping at its own gate, as plywood's pages
42
+ * describe. Both live in chant; a product's preset picks one.
43
+ */
44
+ export type CiProductApproval = "per-wave" | "pull-request";
45
+
46
+ /**
47
+ * When a product's plan applies (#4601), which the note's merge sentence
48
+ * follows. `on-merge`: the merge applies the waves, as sql-yodeler,
49
+ * terragucci and plywood do. `release`: the merge records the plan and a
50
+ * release deploys it, chant's PR loop. `before-merge`: the apply job applies
51
+ * the open pull request's plan, and the merge records what applied.
52
+ */
53
+ export type CiProductApplyMode = "on-merge" | "release" | "before-merge";
54
+
55
+ export const CI_PRODUCT_APPLY_MODES: readonly CiProductApplyMode[] = ["on-merge", "release", "before-merge"];
56
+
57
+ /** An alias another tool's users type for one of the product's commands, such as `atlantis plan`. */
58
+ export interface CiProductAlias {
59
+ /** The words the comment starts with, such as `atlantis plan`. */
60
+ from: string;
61
+ /** The command it stands for. */
62
+ command: CiProductCommand;
63
+ /** The variable that turns the alias on in a job (terragucci's `TG_ATLANTIS_COMMENTS`). Absent: always on. */
64
+ when?: string;
65
+ }
66
+
67
+ /** The words a product passes. Every slot is optional; a missing one takes chant's. */
68
+ export interface CiProductWordsInput {
69
+ /** The status prefix, the note heading and the comment prefix: `chant`, `terragucci`, `plywood`. */
70
+ product?: string;
71
+ /** Each stage's word in a status context and the note. `plan` is plywood's `preview`, `apply` its `up`. */
72
+ stages?: Partial<Record<CiProductStage, string>>;
73
+ /** The verb for the plan and the apply, and its past tense: `preview`/`previewed`, `update`/`updated`. */
74
+ verbs?: { plan?: [string, string]; apply?: [string, string] };
75
+ /** The noun for one member and for several: `root`/`roots`, `stack`/`stacks`. */
76
+ noun?: [string, string];
77
+ /**
78
+ * The comment commands, by the word typed after `/<product>`. Each maps
79
+ * onto one of chant's commands: plywood's `{ preview: "plan", up: "apply",
80
+ * lock: "lock", unlock: "unlock" }`. Default `{ apply: "apply" }`.
81
+ */
82
+ commands?: Record<string, CiProductCommand>;
83
+ /** Aliases another tool's users type, parsed by the same grammar. */
84
+ aliases?: CiProductAlias[];
85
+ /**
86
+ * The approve line, an argv template over `{op}`, `{gate}`, `{digest}`,
87
+ * `{approver}`, `{sign}` and `{target}` (#4574): the wave's run target,
88
+ * an environment or tenant, empty when the gate has none.
89
+ */
90
+ approve?: string;
91
+ /** The override line, the same kind of template, with `{rule}` and `{reason}` too. */
92
+ override?: string;
93
+ /** The op the waves record under. Default: the spec's own. */
94
+ op?: string;
95
+ /** The wave gate pattern, over `{gate}` and `{k}`. Default `{gate}-wave-{k}`. */
96
+ gateName?: string;
97
+ /** The pull request's gate. Default `pr-apply`. */
98
+ prGate?: string;
99
+ /** What an approval binds to. Default `pull-request`, chant's PR loop. */
100
+ approval?: CiProductApproval;
101
+ /**
102
+ * When the plan applies (#4601). Default `on-merge` for a product that
103
+ * names its waves' op or binds approvals per wave, since its merge runs
104
+ * the waves; else `release`, as chant's PR loop has it.
105
+ */
106
+ applyMode?: CiProductApplyMode;
107
+ /**
108
+ * The command a generated job runs in place of `chant`, such as `npx
109
+ * --no-install plywood`. The product's bin passes the rest of the line to
110
+ * chant in process with these words. Absent: `chant`.
111
+ */
112
+ bin?: string;
113
+ /**
114
+ * Hidden markers of notes the product posted before it moved onto chant's
115
+ * pipeline. `pr-post` updates a note that carries one in place of posting a
116
+ * second, so an open pull request keeps one note across the switch.
117
+ */
118
+ adoptMarkers?: string[];
119
+ /** What chant's notify sends under these words (#4610). */
120
+ notify?: CiProductNotifyWordsInput;
121
+ }
122
+
123
+ /** The notify slots a product passes (#4610). */
124
+ export interface CiProductNotifyWordsInput {
125
+ /**
126
+ * The event's `source`, which receivers route on. Default: `product`.
127
+ * sql-yodeler keeps `sql-yodeler` here, the name its receivers filter on.
128
+ */
129
+ source?: string;
130
+ /**
131
+ * How a summary names a wave, over `{k}`, `{name}`, `{spec}` and
132
+ * `{product}`. A `({name})` part is dropped, with the space before it,
133
+ * for a wave with no name. Default `wave {k} ({name}) of {spec}`.
134
+ */
135
+ wave?: string;
136
+ /** The signed webhook's header prefix. Default `x-<product>`, so chant's stays `x-chant`. */
137
+ headers?: string;
138
+ }
139
+
140
+ /** The notify slots, filled. */
141
+ export interface CiProductNotifyWords {
142
+ source: string;
143
+ wave: string;
144
+ headers: string;
145
+ }
146
+
147
+ /** chant's own wave label in a notify summary. */
148
+ export const CHANT_NOTIFY_WAVE_TEMPLATE = "wave {k} ({name}) of {spec}";
149
+
150
+ /** The words with every slot filled. */
151
+ export interface CiProductWords {
152
+ product: string;
153
+ stages: Record<CiProductStage, string>;
154
+ verbs: { plan: [string, string]; apply: [string, string] };
155
+ noun: [string, string];
156
+ commands: Record<string, CiProductCommand>;
157
+ aliases: CiProductAlias[];
158
+ approve: string;
159
+ override: string;
160
+ op?: string;
161
+ gateName: string;
162
+ prGate: string;
163
+ approval: CiProductApproval;
164
+ applyMode: CiProductApplyMode;
165
+ bin?: string;
166
+ adoptMarkers: string[];
167
+ notify: CiProductNotifyWords;
168
+ }
169
+
170
+ /** chant's own approve line. */
171
+ export const CHANT_APPROVE_TEMPLATE = "chant approve {op} {gate} --plan {digest} --approver {approver} {sign}";
172
+
173
+ /** chant's own override line. */
174
+ export const CHANT_OVERRIDE_TEMPLATE = 'chant approve {op} {target} --rule {rule} --reason "<why>" {sign}';
175
+
176
+ /** chant's words: what every slot defaults to. */
177
+ export const CHANT_WORDS: CiProductWords = Object.freeze<CiProductWords>({
178
+ product: "chant",
179
+ stages: { plan: "plan", apply: "apply", record: "record", check: "check", drift: "drift", lock: "lock", approval: "approval", control: "control" },
180
+ verbs: { plan: ["plan", "planned"], apply: ["apply", "applied"] },
181
+ noun: ["member", "members"],
182
+ commands: { apply: "apply" },
183
+ aliases: [],
184
+ approve: CHANT_APPROVE_TEMPLATE,
185
+ override: CHANT_OVERRIDE_TEMPLATE,
186
+ gateName: "{gate}-wave-{k}",
187
+ prGate: "pr-apply",
188
+ approval: "pull-request",
189
+ applyMode: "release",
190
+ adoptMarkers: [],
191
+ notify: { source: "chant", wave: CHANT_NOTIFY_WAVE_TEMPLATE, headers: "x-chant" },
192
+ });
193
+
194
+ /** Fill every slot `input` leaves out with chant's word. */
195
+ export function resolveProductWords(input: CiProductWordsInput | CiProductWords = {}): CiProductWords {
196
+ const product = input.product ?? CHANT_WORDS.product;
197
+ const own = product !== CHANT_WORDS.product;
198
+ return {
199
+ product,
200
+ stages: { ...CHANT_WORDS.stages, ...(input.stages ?? {}) },
201
+ verbs: { plan: input.verbs?.plan ?? CHANT_WORDS.verbs.plan, apply: input.verbs?.apply ?? CHANT_WORDS.verbs.apply },
202
+ noun: input.noun ?? CHANT_WORDS.noun,
203
+ commands: input.commands ?? CHANT_WORDS.commands,
204
+ aliases: input.aliases ?? [],
205
+ // A product's own lines default to chant's grammar under its own name.
206
+ approve: input.approve ?? (own ? `${product} approve {op} {gate} --plan {digest} {sign}` : CHANT_APPROVE_TEMPLATE),
207
+ override: input.override ?? (own ? `${product} override {target} --rule {rule} --reason {reason} {sign}` : CHANT_OVERRIDE_TEMPLATE),
208
+ ...(input.op !== undefined ? { op: input.op } : {}),
209
+ gateName: input.gateName ?? CHANT_WORDS.gateName,
210
+ prGate: input.prGate ?? CHANT_WORDS.prGate,
211
+ approval: input.approval ?? CHANT_WORDS.approval,
212
+ applyMode: input.applyMode ?? (own && (input.op !== undefined || input.approval === "per-wave") ? "on-merge" : CHANT_WORDS.applyMode),
213
+ ...(input.bin !== undefined ? { bin: input.bin } : {}),
214
+ adoptMarkers: input.adoptMarkers ?? [],
215
+ notify: {
216
+ source: input.notify?.source ?? product,
217
+ wave: input.notify?.wave ?? CHANT_NOTIFY_WAVE_TEMPLATE,
218
+ headers: input.notify?.headers ?? `x-${product}`,
219
+ },
220
+ };
221
+ }
222
+
223
+ /** A word that may reach a shell line, an `if:` expression or a status context. */
224
+ const WORD = /^[a-z0-9][a-z0-9-]*$/;
225
+ /** An op or gate name, as the gate ledger names files. */
226
+ const NAME = /^[a-z0-9][a-z0-9_-]*$/;
227
+ /** A template's placeholders. */
228
+ const PLACEHOLDERS = new Set(["op", "gate", "digest", "approver", "sign", "target", "rule", "reason"]);
229
+
230
+ /** The notify wave label's placeholders (#4610). */
231
+ const NOTIFY_WAVE_PLACEHOLDERS = new Set(["k", "name", "spec", "product"]);
232
+
233
+ /** Thrown for words chant refuses, with every problem named. */
234
+ export class CiProductWordsError extends Error {
235
+ constructor(readonly problems: string[]) {
236
+ super(`the product's words are refused: ${problems.join("; ")}`);
237
+ this.name = "CiProductWordsError";
238
+ }
239
+ }
240
+
241
+ /**
242
+ * Every problem with `words`, one line each: a word outside `[a-z0-9-]`, one
243
+ * stage word used for two stages, a command the pipeline has no job for
244
+ * (`jobs`, when given, lists the commands it answers), and a template with
245
+ * a placeholder chant does not fill.
246
+ */
247
+ export function productWordsProblems(words: CiProductWords, options: { jobs?: readonly CiProductCommand[] } = {}): string[] {
248
+ const problems: string[] = [];
249
+ const word = (where: string, value: string) => {
250
+ if (!WORD.test(value)) problems.push(`${where} is ${JSON.stringify(value)}, and a word is lowercase letters, digits and -`);
251
+ };
252
+ word("product", words.product);
253
+ const seen = new Map<string, CiProductStage>();
254
+ for (const stage of CI_PRODUCT_STAGES) {
255
+ const w = words.stages[stage];
256
+ word(`stages.${stage}`, w);
257
+ const other = seen.get(w);
258
+ if (other) problems.push(`stages.${stage} and stages.${other} are both ${JSON.stringify(w)}, so their statuses would be one`);
259
+ seen.set(w, stage);
260
+ }
261
+ for (const [k, pair] of Object.entries(words.verbs)) pair.forEach((v, i) => word(`verbs.${k}[${i}]`, v));
262
+ words.noun.forEach((v, i) => word(`noun[${i}]`, v));
263
+ for (const [typed, command] of Object.entries(words.commands)) {
264
+ word(`commands.${typed}`, typed);
265
+ if (!CI_PRODUCT_COMMANDS.includes(command)) problems.push(`commands.${typed} maps onto ${JSON.stringify(command)}, which is not one of ${CI_PRODUCT_COMMANDS.join(", ")}`);
266
+ else if (options.jobs && !options.jobs.includes(command)) problems.push(`commands.${typed} needs a ${command} job, and the pipeline has none`);
267
+ }
268
+ for (const a of words.aliases) {
269
+ if (!/^[a-z0-9][a-z0-9 -]*$/.test(a.from)) problems.push(`the alias ${JSON.stringify(a.from)} is lowercase words`);
270
+ if (!Object.values(words.commands).includes(a.command)) problems.push(`the alias ${JSON.stringify(a.from)} stands for ${a.command}, which no command names`);
271
+ }
272
+ for (const [where, template] of [["approve", words.approve], ["override", words.override]] as const) {
273
+ for (const m of template.matchAll(/\{([^}]*)\}/g)) if (!PLACEHOLDERS.has(m[1]!)) problems.push(`${where} names {${m[1]}}, which chant does not fill`);
274
+ if (/[`$;&|<>\\\n]/.test(template.replace(/\{[^}]*\}/g, "").replace(/<[a-z-]+>/g, ""))) problems.push(`${where} carries shell syntax`);
275
+ }
276
+ if (words.op !== undefined && !NAME.test(words.op)) problems.push(`op is ${JSON.stringify(words.op)}, and an op is lowercase letters, digits, - and _`);
277
+ if (!NAME.test(words.prGate)) problems.push(`prGate is ${JSON.stringify(words.prGate)}, and a gate is lowercase letters, digits, - and _`);
278
+ if (!words.gateName.includes("{k}")) problems.push("gateName needs {k}, so each wave has its own gate");
279
+ else if (!NAME.test(words.gateName.replace("{gate}", "g").replace("{k}", "1"))) problems.push(`gateName ${JSON.stringify(words.gateName)} does not make a gate name`);
280
+ if (words.approval !== "per-wave" && words.approval !== "pull-request") problems.push(`approval is ${JSON.stringify(words.approval)}; use per-wave or pull-request`);
281
+ if (!CI_PRODUCT_APPLY_MODES.includes(words.applyMode)) problems.push(`applyMode is ${JSON.stringify(words.applyMode)}; use ${CI_PRODUCT_APPLY_MODES.join(", ")}`);
282
+ if (words.bin !== undefined && !/^[A-Za-z0-9@/._ -]+$/.test(words.bin)) problems.push(`bin ${JSON.stringify(words.bin)} carries shell syntax`);
283
+ // #4610: the notify slots. A receiver routes on the source and verifies under the header prefix.
284
+ const notify = words.notify ?? CHANT_WORDS.notify;
285
+ word("notify.source", notify.source);
286
+ if (!/^x-[a-z0-9][a-z0-9-]*$/.test(notify.headers)) problems.push(`notify.headers is ${JSON.stringify(notify.headers)}, and a header prefix is x- then lowercase letters, digits and -`);
287
+ for (const m of notify.wave.matchAll(/\{([^}]*)\}/g)) if (!NOTIFY_WAVE_PLACEHOLDERS.has(m[1]!)) problems.push(`notify.wave names {${m[1]}}, which chant does not fill`);
288
+ if (!notify.wave.includes("{k}")) problems.push("notify.wave needs {k}, so a message names its wave");
289
+ if (/[\r\n]/.test(notify.wave)) problems.push("notify.wave is one line");
290
+ return problems;
291
+ }
292
+
293
+ /** Refuse words with any problem ({@link productWordsProblems}); return them resolved. */
294
+ export function assertProductWords(input: CiProductWordsInput | CiProductWords, options: { jobs?: readonly CiProductCommand[] } = {}): CiProductWords {
295
+ const words = resolveProductWords(input);
296
+ const problems = productWordsProblems(words, options);
297
+ if (problems.length > 0) throw new CiProductWordsError(problems);
298
+ return words;
299
+ }
300
+
301
+ let active: CiProductWords = CHANT_WORDS;
302
+
303
+ /** The words the running command renders with: the product's when its bin set them, else chant's. */
304
+ export function activeProductWords(): CiProductWords {
305
+ return active;
306
+ }
307
+
308
+ /** Set the words for this process (a product's bin, once, before it calls chant). Returns the ones it replaced. */
309
+ export function setActiveProductWords(words: CiProductWordsInput | CiProductWords | undefined): CiProductWords {
310
+ const was = active;
311
+ active = words ? assertProductWords(words) : CHANT_WORDS;
312
+ return was;
313
+ }
314
+
315
+ /** Run `fn` with `words` active, and put the earlier ones back after it settles. */
316
+ export async function withProductWords<T>(words: CiProductWordsInput | CiProductWords | undefined, fn: () => Promise<T>): Promise<T> {
317
+ if (!words) return fn();
318
+ const was = setActiveProductWords(words);
319
+ try {
320
+ return await fn();
321
+ } finally {
322
+ active = was;
323
+ }
324
+ }
325
+
326
+ /** Whether `words` are chant's own, so callers can keep chant's long-standing text. */
327
+ export function isChantWords(words: CiProductWords): boolean {
328
+ return words.product === CHANT_WORDS.product;
329
+ }
330
+
331
+ /** A status context: `<product>/<stage word>`, then `/<member>` in a workspace member. */
332
+ export function productStatusContext(words: CiProductWords, stage: CiProductStage, member?: string): string {
333
+ const context = `${words.product}/${words.stages[stage]}`;
334
+ return member ? `${context}/${member}` : context;
335
+ }
336
+
337
+ /**
338
+ * How a notify summary names wave `k` of `spec` (#4610): the words'
339
+ * `notify.wave` filled. chant's words give `wave 2 (prod) of tf-apply`, and
340
+ * `wave 2 of tf-apply` for a wave with no name.
341
+ */
342
+ export function notifyWaveLabel(words: CiProductWords, input: { k: number; name?: string; spec: string }): string {
343
+ const template = (words.notify ?? CHANT_WORDS.notify).wave;
344
+ const named = input.name ? template : template.replace(/ ?\(\{name\}\)/g, "").replace(/ ?\{name\}/g, "");
345
+ return named.replace(/\{(k|name|spec|product)\}/g, (_, key: string) =>
346
+ key === "k" ? String(input.k) : key === "name" ? (input.name ?? "") : key === "spec" ? input.spec : words.product,
347
+ );
348
+ }
349
+
350
+ /** The context for a name chant uses as is, such as a run record's `pr-plan` or a gate: `<product>/<name>`. */
351
+ export function productContext(words: CiProductWords, name: string): string {
352
+ return `${words.product}/${name}`;
353
+ }
354
+
355
+ /** What {@link approveLine} fills. */
356
+ export interface ApproveLineInput {
357
+ op: string;
358
+ gate: string;
359
+ digest: string;
360
+ /** Default `<you>`. */
361
+ approver?: string;
362
+ /** The approval must be sealed: `--sign` fills `{sign}`. Default true for chant's line, as the PR loop's line always signed. */
363
+ sign?: boolean;
364
+ /** The wave's run target (#4574), an environment or tenant. Empty when absent. */
365
+ target?: string;
366
+ /** chant's line names `--env <environment>` for a component gate. */
367
+ environment?: string;
368
+ }
369
+
370
+ const fill = (template: string, values: Record<string, string>): string =>
371
+ template
372
+ .replace(/\{([a-z]+)\}/g, (_, k: string) => values[k] ?? "")
373
+ .split(/[ \t]+/)
374
+ .filter((w) => w !== "")
375
+ .join(" ");
376
+
377
+ /**
378
+ * The command a reviewer runs to approve a digest: the product's template
379
+ * filled. One function for the note, the job log and the chat message, so all
380
+ * three name the same command.
381
+ */
382
+ export function approveLine(words: CiProductWords, input: ApproveLineInput): string {
383
+ const line = fill(words.approve, {
384
+ op: input.op,
385
+ gate: input.gate,
386
+ digest: input.digest,
387
+ approver: input.approver ?? "<you>",
388
+ sign: input.sign === false ? "" : "--sign",
389
+ target: input.target ?? "",
390
+ });
391
+ // chant's own line names a component gate's environment after the gate, as `chant approve` reads it.
392
+ if (input.environment !== undefined && isChantWords(words) && words.approve === CHANT_APPROVE_TEMPLATE) {
393
+ return line.replace(` ${input.gate} `, ` ${input.gate} --env ${input.environment} `);
394
+ }
395
+ return line;
396
+ }
397
+
398
+ /** What {@link overrideLine} fills. */
399
+ export interface OverrideLineInput {
400
+ /** The op the override is recorded under (chant's `policy-override`). */
401
+ op: string;
402
+ /** The gate the denial stopped, for a product whose line names it. */
403
+ gate?: string;
404
+ /** The rules that denied the plan, each once. `{rule}` is them joined by ` --rule `, so `--rule {rule}` names each. */
405
+ rules: readonly string[];
406
+ /** Default `<text>`, for the person to write. */
407
+ reason?: string;
408
+ /** What was denied: the member, or the wave's run target (#4574). */
409
+ target?: string;
410
+ digest?: string;
411
+ sign?: boolean;
412
+ }
413
+
414
+ /** The command that overrides a policy denial: the product's template filled. */
415
+ export function overrideLine(words: CiProductWords, input: OverrideLineInput): string {
416
+ return fill(words.override, {
417
+ op: input.op,
418
+ gate: input.gate ?? "",
419
+ rule: [...new Set(input.rules)].sort().join(" --rule "),
420
+ reason: input.reason ?? "<text>",
421
+ target: input.target ?? "",
422
+ digest: input.digest ?? "",
423
+ approver: "<you>",
424
+ sign: input.sign ? "--sign" : "",
425
+ });
426
+ }
427
+
428
+ /** The typed word for one of chant's commands: the first `commands` entry that maps onto it. */
429
+ export function commandWord(words: CiProductWords, command: CiProductCommand): string | undefined {
430
+ return Object.entries(words.commands).find(([, c]) => c === command)?.[0];
431
+ }
432
+
433
+ /** The comment a job answers: `/<product> <word>`, such as `/plywood up`. Undefined when the product has no word for the command. */
434
+ export function commentLine(words: CiProductWords, command: CiProductCommand): string | undefined {
435
+ const typed = commandWord(words, command);
436
+ return typed === undefined ? undefined : `/${words.product} ${typed}`;
437
+ }
438
+
439
+ /** The wave gate pattern filled for wave `k`. */
440
+ export function productWaveGate(words: CiProductWords, gate: string, k: number): string {
441
+ return words.gateName.replace("{gate}", gate).replace("{k}", String(k));
442
+ }
443
+
444
+ /** A comment read against the product's grammar. */
445
+ export type ParsedProductComment =
446
+ /** A re-plan, of one member when the comment names it. */
447
+ | { kind: "plan"; member?: string }
448
+ /** An apply, through wave n when the comment names `wave-<n>`. */
449
+ | { kind: "apply"; wave?: number }
450
+ | { kind: "lock" }
451
+ | { kind: "unlock" }
452
+ /** An ask for the agent: data, never split or run. */
453
+ | { kind: "agent"; ask: string }
454
+ | { kind: "refused"; reason: string };
455
+
456
+ /** A member as a comment may name it: path segments, no leading dash, no shell or glob syntax. */
457
+ const MEMBER = /^[A-Za-z0-9_][A-Za-z0-9_.\/-]{0,199}$/;
458
+ /** The longest ask an agent comment may carry. */
459
+ export const PRODUCT_COMMENT_ASK_MAX = 2000;
460
+ /** Commands a comment never runs, named in the reply so nobody waits on them. */
461
+ const NEVER = new Set(["approve", "override", "force-unlock", "unlock-state", "import", "state", "destroy", "merge"]);
462
+
463
+ /**
464
+ * Read a comment against the product's grammar (moved from terragucci's
465
+ * comment.ts). Undefined when it is not addressed to the product. A comment
466
+ * that starts with `/<product>` is a command or it is refused: the whole
467
+ * comment is the command, one line, words separated by spaces or tabs. The
468
+ * comment is untrusted input: only a member path checked against a pattern
469
+ * with no shell syntax, and a wave number, leave this function.
470
+ *
471
+ * `env` turns on an alias whose `when` variable is `1` there.
472
+ */
473
+ export function parseProductComment(words: CiProductWords, body: unknown, env: Record<string, string | undefined> = {}): ParsedProductComment | undefined {
474
+ if (typeof body !== "string") return undefined;
475
+ let text = body.trim();
476
+ const prefix = `/${words.product}`;
477
+ for (const a of words.aliases) {
478
+ if (a.when !== undefined && env[a.when] !== "1") continue;
479
+ if (text !== a.from && !text.startsWith(`${a.from} `) && !text.startsWith(`${a.from}\t`)) continue;
480
+ if (/[\r\n]/.test(text)) return { kind: "refused", reason: "a command is one line, and nothing else in the comment" };
481
+ const typed = commandWord(words, a.command);
482
+ if (typed === undefined) return undefined;
483
+ const rest = text.slice(a.from.length).trim().split(/[ \t]+/).filter((w) => w !== "");
484
+ const args: string[] = [];
485
+ for (let i = 0; i < rest.length; i++) {
486
+ const w = rest[i]!;
487
+ if (w === "-d" || w === "--dir") {
488
+ const dir = rest[++i];
489
+ if (dir === undefined) return { kind: "refused", reason: `\`${w}\` names the ${words.noun[0]}'s directory` };
490
+ args.push(dir.replace(/^\.\/+/, "").replace(/\/+$/, ""));
491
+ } else if (w === "--verbose") continue;
492
+ else if (w.startsWith("-")) return { kind: "refused", reason: `\`${a.from}\` takes no flag ${w} here` };
493
+ else args.push(w);
494
+ }
495
+ text = [prefix, typed, ...args].join(" ");
496
+ break;
497
+ }
498
+ if (text !== prefix && !text.startsWith(`${prefix} `) && !text.startsWith(`${prefix}\t`)) return undefined;
499
+ if (/[\r\n]/.test(text)) return { kind: "refused", reason: "a command is one line, and nothing else in the comment" };
500
+ const parts = text.split(/[ \t]+/);
501
+ const typed = parts[1];
502
+ const known = Object.keys(words.commands).map((w) => `\`${prefix} ${w}\``).join(", ");
503
+ if (typed === undefined) return { kind: "refused", reason: `the commands are ${known}` };
504
+ const command = words.commands[typed];
505
+ if (command === undefined) {
506
+ return {
507
+ kind: "refused",
508
+ reason: NEVER.has(typed) ? `a comment never runs \`${typed}\`: ${words.product} re-plans, and runs what an approval covers, on request and nothing more` : `the commands are ${known}`,
509
+ };
510
+ }
511
+ const line = `\`${prefix} ${typed}\``;
512
+ switch (command) {
513
+ case "lock":
514
+ case "unlock":
515
+ return parts.length === 2 ? { kind: command } : { kind: "refused", reason: `${line} takes nothing after it` };
516
+ case "agent": {
517
+ const ask = text.slice(`${prefix} ${typed}`.length).trim();
518
+ if (ask === "") return { kind: "refused", reason: `${line} needs an ask after it, on the same line` };
519
+ if (ask.length > PRODUCT_COMMENT_ASK_MAX) return { kind: "refused", reason: `an ask is at most ${PRODUCT_COMMENT_ASK_MAX} characters` };
520
+ if (/[\u0000-\u0008\u000b-\u001f\u007f]/.test(ask)) return { kind: "refused", reason: "an ask is plain text, with no control characters" };
521
+ return { kind: "agent", ask };
522
+ }
523
+ case "apply": {
524
+ if (parts.length === 2) return { kind: "apply" };
525
+ const m = parts.length === 3 ? /^wave-([1-9][0-9]{0,3})$/.exec(parts[2]!) : null;
526
+ return m ? { kind: "apply", wave: Number(m[1]) } : { kind: "refused", reason: `${line} takes nothing, or a wave like \`wave-2\`` };
527
+ }
528
+ case "plan": {
529
+ if (parts.length > 3) return { kind: "refused", reason: `${line} takes one ${words.noun[0]} at most` };
530
+ const member = parts[2];
531
+ if (member === undefined) return { kind: "plan" };
532
+ if (!MEMBER.test(member) || member.split("/").some((s) => s === "" || s === "." || s === "..")) return { kind: "refused", reason: `the ${words.noun[0]} is a name or a path from the repository root` };
533
+ return { kind: "plan", member };
534
+ }
535
+ }
536
+ }