@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,321 @@
1
+ /**
2
+ * `chant notify relay` (#4611): approve a waiting gate from chat.
3
+ *
4
+ * With `notify.relay` set, a waiting event's Slack message carries Approve
5
+ * and Decline buttons, and its Teams card the reply `approve <token>`
6
+ * (`./notify.ts`). The token is the waiting event's id, source, time, gate
7
+ * and digest, signed with the relay key. Slack posts a click to the relay's
8
+ * `/slack`, signed with the Slack app's signing secret; a Teams outgoing
9
+ * webhook posts the reply to `/teams`, signed with its HMAC key. The relay:
10
+ *
11
+ * 1. refuses a request whose chat signature does not verify (401), and a
12
+ * Slack request more than five minutes old;
13
+ * 2. refuses a token the relay key did not sign, or one older than its
14
+ * maximum age, so only a button chant's notify posted approves anything;
15
+ * 3. maps the chat user to a principal: the signers file at base lists
16
+ * `slack:<team>/<user>` or `teams:<aad object id>` on that person's line.
17
+ * A user no line lists is refused, and so is the relay's own principal;
18
+ * 4. finds the standing pending fact at the token's gate whose plan or
19
+ * change set is the token's digest. A digest that moved, or a gate
20
+ * approved already, approves nothing;
21
+ * 5. refuses the requester of a gated request (#4551), whose own approval
22
+ * never counts;
23
+ * 6. records the approval as `chant approve <op> <gate> --plan <digest>
24
+ * --actor <principal> --relayed-by <relay>` does, with every rule that
25
+ * command applies: the decision point, `identity.gates` (the relay holds
26
+ * no key, so a sealed gate is refused), the gate policy and the push.
27
+ *
28
+ * Decline records nothing and says who declined. The type-the-name prompt
29
+ * of `chant approve` (#4575) is for a terminal; a signed click is the
30
+ * person's confirmation here. The relay starts no job: the resume job
31
+ * applies the wave once the approval stands.
32
+ */
33
+ import { createHmac, timingSafeEqual } from "node:crypto";
34
+ import { createServer } from "node:http";
35
+ import { readRelayToken, RELAY_APPROVE_ACTION, RELAY_DECLINE_ACTION } from "./notify.js";
36
+ /** The relay's settings, by environment variable. */
37
+ export const RELAY_ENV = {
38
+ /** The key the notify buttons are signed with: the variable `notify.relay` names on the sending side. */
39
+ key: "CHANT_RELAY_KEY",
40
+ slackSecret: "SLACK_SIGNING_SECRET",
41
+ teamsSecret: "TEAMS_WEBHOOK_SECRET",
42
+ /** The principal recorded as `relayedBy`. Default `<product>-relay`. */
43
+ principal: "CHANT_RELAY_PRINCIPAL",
44
+ /** How old a button may be, in seconds. */
45
+ maxAge: "CHANT_RELAY_MAX_AGE",
46
+ host: "CHANT_RELAY_HOST",
47
+ port: "CHANT_RELAY_PORT",
48
+ /** Comma-separated address prefixes a Slack response_url may have. */
49
+ slackResponse: "CHANT_RELAY_SLACK_RESPONSE",
50
+ };
51
+ /** Slack's own reply hosts: hooks.slack.com, and GovSlack's. */
52
+ export const SLACK_RESPONSE_PREFIXES = ["https://hooks.slack.com/", "https://hooks.slack-gov.com/"];
53
+ const SLACK_WINDOW_S = 5 * 60;
54
+ /** Where the relay listens by default: loopback, so it is reachable only through what the operator puts in front of it. */
55
+ export const DEFAULT_RELAY_HOST = "127.0.0.1";
56
+ export const DEFAULT_RELAY_PORT = 8787;
57
+ // ── chat signatures ──────────────────────────────────────────────────────
58
+ const header = (h, name) => h[name] ?? h[name.toLowerCase()];
59
+ const same = (a, b) => {
60
+ const x = Buffer.from(a);
61
+ const y = Buffer.from(b);
62
+ return x.length === y.length && timingSafeEqual(x, y);
63
+ };
64
+ /** `v0=<hex>`: Slack's signature, HMAC-SHA256 of `v0:<timestamp>:<raw body>` with the app's signing secret. */
65
+ export const slackSignature = (secret, timestamp, raw) => `v0=${createHmac("sha256", secret).update(`v0:${timestamp}:${raw}`).digest("hex")}`;
66
+ /** Why a Slack request is refused, or null when it verifies and is recent. */
67
+ export function verifySlackRequest(headers, raw, secret, now = Date.now()) {
68
+ if (!secret)
69
+ return `${RELAY_ENV.slackSecret} is empty, so no Slack request can be verified`;
70
+ const ts = header(headers, "x-slack-request-timestamp") ?? "";
71
+ const sig = header(headers, "x-slack-signature") ?? "";
72
+ if (!/^\d+$/.test(ts) || !sig)
73
+ return "the request is not signed";
74
+ if (Math.abs(now / 1000 - Number(ts)) > SLACK_WINDOW_S)
75
+ return "the request is more than five minutes old";
76
+ return same(sig, slackSignature(secret, ts, raw)) ? null : "the signature does not verify";
77
+ }
78
+ /** `HMAC <base64>`: a Teams outgoing webhook's signature, HMAC-SHA256 of the raw body with the key Teams gave (base64). */
79
+ export const teamsSignature = (secret, raw) => `HMAC ${createHmac("sha256", Buffer.from(secret, "base64")).update(raw).digest("base64")}`;
80
+ /** Why a Teams request is refused, or null when it verifies. */
81
+ export function verifyTeamsRequest(headers, raw, secret) {
82
+ if (!secret)
83
+ return `${RELAY_ENV.teamsSecret} is empty, so no Teams request can be verified`;
84
+ const auth = header(headers, "authorization") ?? "";
85
+ if (!auth.startsWith("HMAC "))
86
+ return "the request is not signed";
87
+ return same(auth, teamsSignature(secret, raw)) ? null : "the signature does not verify";
88
+ }
89
+ /** A Slack `block_actions` payload (the form field `payload`), or why the relay does not read it. */
90
+ export function slackRelayClick(raw) {
91
+ let p;
92
+ try {
93
+ p = JSON.parse(new URLSearchParams(raw).get("payload") ?? "");
94
+ }
95
+ catch {
96
+ return { error: "the request carries no Slack payload" };
97
+ }
98
+ if (p?.type !== "block_actions")
99
+ return { error: `a Slack ${String(p?.type)} payload is not a button click` };
100
+ const team = p.user?.team_id ?? p.team?.id;
101
+ const user = p.user?.id;
102
+ if (typeof team !== "string" || typeof user !== "string")
103
+ return { error: "the click names no Slack user" };
104
+ const a = Array.isArray(p.actions) ? p.actions[0] : undefined;
105
+ const action = a?.action_id === RELAY_APPROVE_ACTION ? "approve" : a?.action_id === RELAY_DECLINE_ACTION ? "decline" : undefined;
106
+ if (!action)
107
+ return { error: `the button ${String(a?.action_id)} is not chant's` };
108
+ if (typeof a.value !== "string" || !a.value)
109
+ return { error: "the button carries no reference" };
110
+ const thread = p.container?.message_ts ?? p.message?.ts;
111
+ return {
112
+ app: "slack",
113
+ chatUser: `slack:${team}/${user}`,
114
+ display: String(p.user?.username ?? p.user?.name ?? user),
115
+ action,
116
+ token: a.value,
117
+ ...(typeof p.response_url === "string" ? { responseUrl: p.response_url } : {}),
118
+ ...(typeof thread === "string" ? { thread } : {}),
119
+ };
120
+ }
121
+ /** A Teams message's words, with its mention and markup dropped. */
122
+ const teamsWords = (text) => text
123
+ .replace(/<at>[^<]*<\/at>/gi, " ")
124
+ .replace(/<[^>]+>/g, " ")
125
+ .replace(/&nbsp;/gi, " ")
126
+ .replace(/&amp;/gi, "&")
127
+ .trim()
128
+ .split(/\s+/)
129
+ .filter(Boolean);
130
+ /** A Teams outgoing webhook's message, `@<relay> approve|decline <token>`, or why it is not one. */
131
+ export function teamsRelayClick(raw) {
132
+ let m;
133
+ try {
134
+ m = JSON.parse(raw);
135
+ }
136
+ catch {
137
+ return { error: "the request is not a Teams message" };
138
+ }
139
+ const user = m?.from?.aadObjectId;
140
+ if (typeof user !== "string" || !user)
141
+ return { error: "the message names no Teams user" };
142
+ const [verb, token, extra] = teamsWords(String(m.text ?? ""));
143
+ if ((verb !== "approve" && verb !== "decline") || !token || extra !== undefined)
144
+ return { error: "reply approve or decline, then the reference from the message: approve <reference>" };
145
+ return { app: "teams", chatUser: `teams:${user}`, display: String(m.from?.name ?? user), action: verb, token };
146
+ }
147
+ // ── who clicked ──────────────────────────────────────────────────────────
148
+ const CHAT_ID = /^(slack|teams):/;
149
+ const norm = (s) => s.normalize("NFKC").trim().toLowerCase();
150
+ /**
151
+ * The principal a chat user maps to: the signers file line that lists the
152
+ * chat id gives the line's first principal that is not a chat id. Undefined
153
+ * when no line lists it, or lines listing it name different principals.
154
+ */
155
+ export function relayPrincipalFor(signers, chatUser) {
156
+ const id = norm(chatUser);
157
+ const lines = new Map();
158
+ for (const s of signers)
159
+ lines.set(s.line, [...(lines.get(s.line) ?? []), norm(s.principal)]);
160
+ const found = new Set();
161
+ for (const principals of lines.values()) {
162
+ if (!principals.includes(id))
163
+ continue;
164
+ const p = principals.find((x) => !CHAT_ID.test(x));
165
+ if (p)
166
+ found.add(p);
167
+ }
168
+ return found.size === 1 ? [...found][0] : undefined;
169
+ }
170
+ /** Decide a click and record what it approves. Never throws: an error is the answer's text. */
171
+ export async function decideRelayClick(click, settings, deps) {
172
+ const words = deps.words;
173
+ const checked = readRelayToken(settings.key, click.token, { ...(deps.now ? { now: deps.now() } : {}), ...(settings.maxAgeSeconds !== undefined ? { maxAgeSeconds: settings.maxAgeSeconds } : {}) });
174
+ if (!checked.ok)
175
+ return { ok: false, outcome: /old|future/.test(checked.reason) ? "stale" : "bad-reference", text: `Refused: ${checked.reason}. Nothing was ${click.action === "approve" ? "approved" : "declined"}.` };
176
+ const ref = checked.ref;
177
+ try {
178
+ const { signers, path } = await deps.signers();
179
+ const principal = relayPrincipalFor(signers, click.chatUser);
180
+ if (!principal) {
181
+ return { ok: false, outcome: "ineligible", gate: ref.gate, text: `Refused: ${click.display} (${click.chatUser}) is not mapped to a principal in ${path} at base, so nothing was recorded. A maintainer adds ${click.chatUser} to that person's line.` };
182
+ }
183
+ if (norm(principal) === norm(deps.principal)) {
184
+ return { ok: false, outcome: "ineligible", gate: ref.gate, principal, text: `Refused: ${principal} is the relay, and the relay never approves.` };
185
+ }
186
+ if (click.action === "decline") {
187
+ return { ok: true, outcome: "declined", gate: ref.gate, principal, text: `${ref.gate} declined by ${principal} for ${ref.digest}. Nothing was recorded; the gate keeps waiting.` };
188
+ }
189
+ const standing = (await deps.pending(ref.digest)).filter((p) => p.gate === ref.gate);
190
+ if (standing.length === 0) {
191
+ return { ok: false, outcome: "moved", gate: ref.gate, principal, text: `Not approved: ${ref.gate} does not wait for ${ref.digest}. The plan moved since this message, or it was approved already. Read the plan waiting now and approve its digest.` };
192
+ }
193
+ if (standing.length > 1) {
194
+ return { ok: false, outcome: "refused", gate: ref.gate, principal, text: `Not approved: ${ref.gate} waits for ${ref.digest} under ${standing.map((p) => p.op).join(", ")}, so the click names no one gate. Approve at a shell with the op named.` };
195
+ }
196
+ const pending = standing[0];
197
+ if (pending.request && norm(pending.request.by) === norm(principal)) {
198
+ return { ok: false, outcome: "ineligible", op: pending.op, gate: pending.gate, principal, text: `Refused: ${principal} made the request, and a requester's own approval does not count. Someone else approves it.` };
199
+ }
200
+ const recorded = await deps.approve({ op: pending.op, gate: pending.gate, digest: pending.digest, ...(pending.environment !== undefined ? { environment: pending.environment } : {}), actor: principal, relayedBy: deps.principal });
201
+ if (!recorded.ok)
202
+ return { ok: false, outcome: "refused", op: pending.op, gate: pending.gate, principal, text: `Not approved: ${recorded.error}` };
203
+ return {
204
+ ok: true,
205
+ outcome: "approved",
206
+ op: pending.op,
207
+ gate: pending.gate,
208
+ principal,
209
+ text: `${pending.gate} on ${pending.op} approved by ${principal}, relayed by ${deps.principal}, for ${pending.digest} and no other plan. The resume job starts the ${words.stages.apply} once the gate passes.`,
210
+ };
211
+ }
212
+ catch (e) {
213
+ return { ok: false, outcome: "refused", gate: ref.gate, text: `Not recorded: ${e.message}` };
214
+ }
215
+ }
216
+ const json = (status, body) => ({ status, headers: { "content-type": "application/json" }, body: JSON.stringify(body) });
217
+ const plain = (status, body) => ({ status, headers: { "content-type": "text/plain" }, body });
218
+ /**
219
+ * One request: `POST /slack`, `POST /teams`, `GET /healthz`. A Slack answer
220
+ * goes to the click's response_url, in the message's thread, when that is
221
+ * Slack's; a Teams answer is the reply Teams posts under the message.
222
+ */
223
+ export async function handleRelayRequest(req, settings, deps, options = {}) {
224
+ const log = options.log ?? (() => { });
225
+ const path = req.path.split("?")[0];
226
+ if (req.method === "GET" && path === "/healthz")
227
+ return plain(200, "ok");
228
+ if (req.method !== "POST" || (path !== "/slack" && path !== "/teams"))
229
+ return plain(404, "not found");
230
+ if (path === "/slack") {
231
+ const refused = verifySlackRequest(req.headers, req.body, settings.slackSecret, options.now);
232
+ if (refused) {
233
+ log(`slack: refused a request: ${refused}`);
234
+ return plain(401, refused);
235
+ }
236
+ const click = slackRelayClick(req.body);
237
+ if ("error" in click)
238
+ return plain(400, click.error);
239
+ const answer = await decideRelayClick(click, settings, deps);
240
+ log(`slack: ${click.chatUser} ${click.action}: ${answer.outcome}: ${answer.text}`);
241
+ if (click.responseUrl) {
242
+ const allowed = settings.slackResponse ?? SLACK_RESPONSE_PREFIXES;
243
+ if (!allowed.some((p) => click.responseUrl.startsWith(p)))
244
+ log(`slack: the response_url is not Slack's (${allowed.join(", ")}); no reply was posted`);
245
+ else {
246
+ try {
247
+ const post = options.post ?? ((url, init) => globalThis.fetch(url, init));
248
+ const r = await post(click.responseUrl, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ response_type: "in_channel", replace_original: false, ...(click.thread ? { thread_ts: click.thread } : {}), text: answer.text }) });
249
+ if (!r.ok)
250
+ log(`slack: the reply answered ${r.status}`);
251
+ }
252
+ catch (e) {
253
+ log(`slack: the reply did not land (${e.message})`);
254
+ }
255
+ }
256
+ }
257
+ return plain(200, "");
258
+ }
259
+ const refused = verifyTeamsRequest(req.headers, req.body, settings.teamsSecret);
260
+ if (refused) {
261
+ log(`teams: refused a request: ${refused}`);
262
+ return plain(401, refused);
263
+ }
264
+ const click = teamsRelayClick(req.body);
265
+ if ("error" in click)
266
+ return json(200, { type: "message", text: click.error });
267
+ const answer = await decideRelayClick(click, settings, deps);
268
+ log(`teams: ${click.chatUser} ${click.action}: ${answer.outcome}: ${answer.text}`);
269
+ return json(200, { type: "message", text: answer.text });
270
+ }
271
+ /** The largest request body the relay reads. Slack and Teams send a few kilobytes. */
272
+ const MAX_BODY = 256 * 1024;
273
+ function readBody(req) {
274
+ return new Promise((resolve, reject) => {
275
+ const chunks = [];
276
+ let size = 0;
277
+ req.on("data", (c) => {
278
+ size += c.length;
279
+ if (size > MAX_BODY) {
280
+ reject(new Error("the request body is too large"));
281
+ req.destroy();
282
+ }
283
+ else
284
+ chunks.push(c);
285
+ });
286
+ req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
287
+ req.on("error", reject);
288
+ });
289
+ }
290
+ /** Start the relay's HTTP server on `host:port` (port 0 picks a free one). Resolves once it listens. */
291
+ export async function startRelayServer(settings, deps, options = {}) {
292
+ const server = createServer((req, res) => {
293
+ void (async () => {
294
+ let out;
295
+ try {
296
+ const body = await readBody(req);
297
+ const headers = {};
298
+ for (const [k, v] of Object.entries(req.headers))
299
+ headers[k.toLowerCase()] = Array.isArray(v) ? v[0] : v;
300
+ out = await handleRelayRequest({ method: req.method ?? "GET", path: req.url ?? "/", headers, body }, settings, deps, { ...(options.post ? { post: options.post } : {}), ...(options.log ? { log: options.log } : {}) });
301
+ }
302
+ catch (e) {
303
+ out = plain(400, e.message);
304
+ }
305
+ res.writeHead(out.status, out.headers);
306
+ res.end(out.body);
307
+ })();
308
+ });
309
+ const host = options.host ?? DEFAULT_RELAY_HOST;
310
+ await new Promise((resolve, reject) => {
311
+ server.once("error", reject);
312
+ server.listen(options.port ?? DEFAULT_RELAY_PORT, host, () => resolve());
313
+ });
314
+ const address = server.address();
315
+ const port = typeof address === "object" && address ? address.port : options.port ?? DEFAULT_RELAY_PORT;
316
+ return {
317
+ server,
318
+ url: `http://${host.includes(":") ? `[${host}]` : host}:${port}`,
319
+ close: () => new Promise((resolve) => server.close(() => resolve())),
320
+ };
321
+ }
package/dist/notify.d.ts CHANGED
@@ -125,12 +125,46 @@ export declare function makeNotifyEvent(fields: NotifyFields, options?: {
125
125
  }): NotifyEvent;
126
126
  /** The first line of every chat message: `<source>: <summary>`, or what happened to what when there is no summary. */
127
127
  export declare function notifyHeadline(e: NotifyEvent): string;
128
- /** A Slack incoming webhook's body: one mrkdwn text, with the approve command as code and the links as links. */
129
- export declare function slackMessage(e: NotifyEvent): {
128
+ /** The Slack buttons' action ids, which `chant notify relay` reads. */
129
+ export declare const RELAY_APPROVE_ACTION = "chant-approve";
130
+ export declare const RELAY_DECLINE_ACTION = "chant-decline";
131
+ /** What a relay button carries: the waiting event it was posted for, signed with the relay key. */
132
+ export interface RelayRef {
133
+ /** The event's `id`, `source` and `at`. */
134
+ id: string;
135
+ source: string;
136
+ at: string;
137
+ gate: string;
138
+ digest: string;
139
+ }
140
+ /** The ref of a waiting event a relay can approve, or undefined for any other event. */
141
+ export declare function relayRefOf(e: NotifyEvent): RelayRef | undefined;
142
+ /** `<base64url JSON>.<hex HMAC>`: the button value, signed with `key` so the relay knows its own notify posted it. */
143
+ export declare function relayToken(key: string, ref: RelayRef): string;
144
+ /** The ref a token carries when `key` signed it, or why it is refused. A ref older than `maxAgeSeconds` is stale. */
145
+ export declare function readRelayToken(key: string | undefined, token: string, options?: {
146
+ now?: Date;
147
+ maxAgeSeconds?: number;
148
+ }): {
149
+ ok: true;
150
+ ref: RelayRef;
151
+ } | {
152
+ ok: false;
153
+ reason: string;
154
+ };
155
+ /** How old a relay button may be, in seconds: a day, a gate's default timeout. */
156
+ export declare const DEFAULT_RELAY_MAX_AGE_SECONDS: number;
157
+ /** What a chat message adds for the relay: the signed button value. */
158
+ export interface RelayButtons {
159
+ token: string;
160
+ }
161
+ /** A Slack incoming webhook's body: one mrkdwn text, with the approve command as code and the links as links. With `relay`, Approve and Decline buttons (#4611). */
162
+ export declare function slackMessage(e: NotifyEvent, relay?: RelayButtons): {
130
163
  text: string;
164
+ blocks?: unknown[];
131
165
  };
132
- /** A Teams incoming webhook's body (a Workflows webhook): one Adaptive Card, with buttons that open the review page and the run. */
133
- export declare function teamsMessage(e: NotifyEvent): Record<string, unknown>;
166
+ /** A Teams incoming webhook's body (a Workflows webhook): one Adaptive Card, with buttons that open the review page and the run. With `relay`, the reply that approves through the relay (#4611). */
167
+ export declare function teamsMessage(e: NotifyEvent, relay?: RelayButtons): Record<string, unknown>;
134
168
  /** Where events go. Each value is the NAME of an environment variable; the configuration never holds a URL or a key. */
135
169
  export interface NotifyConfig {
136
170
  /** The variable holding the generic webhook's URL. */
@@ -143,6 +177,12 @@ export interface NotifyConfig {
143
177
  teams?: string;
144
178
  /** The events to send. Default: all of them. */
145
179
  events?: NotifyEventKind[];
180
+ /**
181
+ * The variable holding the key `chant notify relay` checks buttons with
182
+ * (#4611). Set, a waiting event's Slack message carries Approve and
183
+ * Decline buttons, and its Teams card the reply that approves.
184
+ */
185
+ relay?: string;
146
186
  }
147
187
  /** The first problem with a {@link NotifyConfig}, or undefined. `where` prefixes the message. */
148
188
  export declare function notifyConfigProblem(value: unknown, where?: string): string | undefined;
@@ -1 +1 @@
1
- {"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../src/notify.ts"],"names":[],"mappings":"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"}
package/dist/notify.js CHANGED
@@ -27,7 +27,7 @@
27
27
  * Bundle-safe: this module reaches only `node:crypto` and
28
28
  * `./notify-verify.ts` (`./notify-bundle.test.ts`).
29
29
  */
30
- import { createHash, randomUUID } from "node:crypto";
30
+ import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
31
31
  import { DEFAULT_HEADER_PREFIX, signWebhook, webhookHeaderNames } from "./notify-verify.js";
32
32
  export { DEFAULT_HEADER_PREFIX, DEFAULT_TOLERANCE_SECONDS, signWebhook, verifyWebhook, webhookHeaderNames } from "./notify-verify.js";
33
33
  /** The event's `schema` value. A field is only ever added within a version. */
@@ -126,8 +126,55 @@ function facts(e) {
126
126
  out.push({ title: "Report", value: e.reportUrl, link: e.reportUrl });
127
127
  return out;
128
128
  }
129
- /** A Slack incoming webhook's body: one mrkdwn text, with the approve command as code and the links as links. */
130
- export function slackMessage(e) {
129
+ // ── relay buttons (#4611) ────────────────────────────────────────────────
130
+ /** The Slack buttons' action ids, which `chant notify relay` reads. */
131
+ export const RELAY_APPROVE_ACTION = "chant-approve";
132
+ export const RELAY_DECLINE_ACTION = "chant-decline";
133
+ const relayMac = (key, payload) => createHmac("sha256", key).update(`chant-relay.${payload}`, "utf8").digest("hex");
134
+ /** The ref of a waiting event a relay can approve, or undefined for any other event. */
135
+ export function relayRefOf(e) {
136
+ if (e.event !== "waiting" || !e.digest || !e.wave?.gate)
137
+ return undefined;
138
+ return { id: e.id, source: e.source, at: e.at, gate: e.wave.gate, digest: e.digest };
139
+ }
140
+ /** `<base64url JSON>.<hex HMAC>`: the button value, signed with `key` so the relay knows its own notify posted it. */
141
+ export function relayToken(key, ref) {
142
+ const payload = Buffer.from(JSON.stringify({ v: 1, ...ref }), "utf8").toString("base64url");
143
+ return `${payload}.${relayMac(key, payload)}`;
144
+ }
145
+ /** The ref a token carries when `key` signed it, or why it is refused. A ref older than `maxAgeSeconds` is stale. */
146
+ export function readRelayToken(key, token, options = {}) {
147
+ if (!key)
148
+ return { ok: false, reason: "the relay has no key to check the button with" };
149
+ const [payload, mac, extra] = token.split(".");
150
+ if (!payload || !mac || extra !== undefined)
151
+ return { ok: false, reason: "the button carries no chant notify reference" };
152
+ const expected = Buffer.from(relayMac(key, payload));
153
+ const given = Buffer.from(mac);
154
+ if (given.length !== expected.length || !timingSafeEqual(given, expected))
155
+ return { ok: false, reason: "the button was not signed with this relay's key" };
156
+ let ref;
157
+ try {
158
+ ref = JSON.parse(Buffer.from(payload, "base64url").toString("utf8"));
159
+ }
160
+ catch {
161
+ return { ok: false, reason: "the button's reference is not JSON" };
162
+ }
163
+ if (ref.v !== 1 || [ref.id, ref.source, ref.at, ref.gate, ref.digest].some((v) => typeof v !== "string" || v === ""))
164
+ return { ok: false, reason: "the button's reference is not a chant.notify/v1 waiting event" };
165
+ const at = Date.parse(ref.at);
166
+ const now = (options.now ?? new Date()).getTime();
167
+ const maxAge = options.maxAgeSeconds ?? DEFAULT_RELAY_MAX_AGE_SECONDS;
168
+ if (!Number.isFinite(at) || at - now > 5 * 60000)
169
+ return { ok: false, reason: "the event's time is in the future" };
170
+ if (now - at > maxAge * 1000)
171
+ return { ok: false, reason: `the event is more than ${String(maxAge)}s old; approve from the newer message, or at a shell` };
172
+ return { ok: true, ref: { id: ref.id, source: ref.source, at: ref.at, gate: ref.gate, digest: ref.digest } };
173
+ }
174
+ /** How old a relay button may be, in seconds: a day, a gate's default timeout. */
175
+ export const DEFAULT_RELAY_MAX_AGE_SECONDS = 24 * 60 * 60;
176
+ /** A Slack incoming webhook's body: one mrkdwn text, with the approve command as code and the links as links. With `relay`, Approve and Decline buttons (#4611). */
177
+ export function slackMessage(e, relay) {
131
178
  const lines = [`*${notifyHeadline(e)}*`];
132
179
  for (const f of facts(e)) {
133
180
  if (f.title === "Review and approve")
@@ -139,11 +186,21 @@ export function slackMessage(e) {
139
186
  else
140
187
  lines.push(`${f.title}: ${f.value}`);
141
188
  }
142
- return { text: lines.join("\n") };
189
+ const text = lines.join("\n");
190
+ if (!relay)
191
+ return { text };
192
+ const button = (label, action, style) => ({ type: "button", text: { type: "plain_text", text: label }, action_id: action, value: relay.token, ...(style ? { style } : {}) });
193
+ return {
194
+ text,
195
+ blocks: [
196
+ { type: "section", text: { type: "mrkdwn", text } },
197
+ { type: "actions", elements: [button("Approve", RELAY_APPROVE_ACTION, "primary"), button("Decline", RELAY_DECLINE_ACTION)] },
198
+ ],
199
+ };
143
200
  }
144
- /** A Teams incoming webhook's body (a Workflows webhook): one Adaptive Card, with buttons that open the review page and the run. */
145
- export function teamsMessage(e) {
146
- const all = facts(e);
201
+ /** A Teams incoming webhook's body (a Workflows webhook): one Adaptive Card, with buttons that open the review page and the run. With `relay`, the reply that approves through the relay (#4611). */
202
+ export function teamsMessage(e, relay) {
203
+ const all = [...facts(e), ...(relay ? [{ title: "Approve in chat", value: `mention the relay and reply: approve ${relay.token}` }] : [])];
147
204
  const actions = [
148
205
  ...(e.approve?.review ? [{ type: "Action.OpenUrl", title: "Review and approve", url: e.approve.review.url }] : []),
149
206
  ...(e.run?.url ? [{ type: "Action.OpenUrl", title: "Open the run", url: e.run.url }] : []),
@@ -169,7 +226,7 @@ export function teamsMessage(e) {
169
226
  };
170
227
  }
171
228
  const VARIABLE = /^[A-Za-z_][A-Za-z0-9_]*$/;
172
- const SETTINGS = ["webhook", "key", "slack", "teams", "events"];
229
+ const SETTINGS = ["webhook", "key", "slack", "teams", "events", "relay"];
173
230
  /** The first problem with a {@link NotifyConfig}, or undefined. `where` prefixes the message. */
174
231
  export function notifyConfigProblem(value, where = "notify") {
175
232
  if (typeof value !== "object" || value === null || Array.isArray(value))
@@ -178,13 +235,13 @@ export function notifyConfigProblem(value, where = "notify") {
178
235
  for (const k of Object.keys(v))
179
236
  if (!SETTINGS.includes(k))
180
237
  return `${where}.${k}: unknown setting (expected ${SETTINGS.join(", ")})`;
181
- for (const k of ["webhook", "key", "slack", "teams"]) {
238
+ for (const k of ["webhook", "key", "slack", "teams", "relay"]) {
182
239
  const n = v[k];
183
240
  if (n === undefined)
184
241
  continue;
185
242
  if (typeof n !== "string" || !VARIABLE.test(n)) {
186
- const what = k === "key" ? "signing key" : "URL";
187
- return `${where}.${k}: the name of the environment variable that holds the ${what}, never the ${k === "key" ? "key" : "URL"} itself`;
243
+ const what = k === "key" ? "signing key" : k === "relay" ? "relay key" : "URL";
244
+ return `${where}.${k}: the name of the environment variable that holds the ${what}, never the ${k === "key" || k === "relay" ? "key" : "URL"} itself`;
188
245
  }
189
246
  }
190
247
  if (v.webhook !== undefined && v.key === undefined)
@@ -202,7 +259,7 @@ export function notifyConfigProblem(value, where = "notify") {
202
259
  export function notifyVariables(config) {
203
260
  if (!config)
204
261
  return [];
205
- return [config.webhook, config.key, config.slack, config.teams].filter((n) => typeof n === "string" && n !== "");
262
+ return [config.webhook, config.key, config.slack, config.teams, config.relay].filter((n) => typeof n === "string" && n !== "");
206
263
  }
207
264
  /** The request {@link sendNotify} posts to the webhook: the event as JSON, signed with `key` over `<timestamp>.<body>`. */
208
265
  export function webhookRequest(event, key, options = {}) {
@@ -298,9 +355,15 @@ export async function sendNotify(config, event, options = {}) {
298
355
  return webhookRequest(event, key, { ...(options.now !== undefined ? { now: options.now } : {}), ...(options.prefix ? { prefix: options.prefix } : {}), ...(options.userAgent ? { userAgent: options.userAgent } : {}) });
299
356
  });
300
357
  }
358
+ // #4611: a waiting event's buttons, when the relay's key is set.
359
+ const ref = relayRefOf(event);
360
+ const relayKey = config.relay ? env[config.relay] : undefined;
361
+ if (config.relay && ref && !relayKey)
362
+ log(`notify: ${config.relay} is not set, so the message carries no relay buttons`);
363
+ const buttons = ref && relayKey ? { token: relayToken(relayKey, ref) } : undefined;
301
364
  if (config.slack)
302
- await deliver("slack", config.slack, () => json((options.render?.slack ?? slackMessage)(event)));
365
+ await deliver("slack", config.slack, () => json(options.render?.slack ? options.render.slack(event) : slackMessage(event, buttons)));
303
366
  if (config.teams)
304
- await deliver("teams", config.teams, () => json((options.render?.teams ?? teamsMessage)(event)));
367
+ await deliver("teams", config.teams, () => json(options.render?.teams ? options.render.teams(event) : teamsMessage(event, buttons)));
305
368
  return out;
306
369
  }