@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,311 @@
1
+ /**
2
+ * Op waves through capabilities (#4545): a wave whose spec names a `step`
3
+ * plans and applies each run through a capability (`terraform-apply`,
4
+ * `pulumi-up`, any kind a lexicon's plugin contributes) in the job's own
5
+ * process, in place of a `plan` and an `apply` command. The gate, the
6
+ * approval, the spend, the hooks, the shares and the run record are the ones
7
+ * every op wave has; only who plans and who applies changes.
8
+ *
9
+ * ## The step
10
+ *
11
+ * `step` is `{ kind, ...input }`, the same shape a component's deploy step
12
+ * has. Each string in the input has `{target}`, `{op}` and `{wave}` filled
13
+ * per run, and a run's own `input` is laid over it, so one step covers every
14
+ * root of a wave and a run adds what is its own (vars, reads):
15
+ *
16
+ * ```json
17
+ * { "step": { "kind": "terraform-apply", "root": "{target}", "lockTimeout": "5m" },
18
+ * "waves": [{ "name": "dev", "runs": [{ "target": "network" }, { "target": "app", "input": { "vars": { "size": "s" } } }] }] }
19
+ * ```
20
+ *
21
+ * - Plan: `capability.plan` per run. The run's member digest is the plan's
22
+ * `planDigest`; `empty` and `destructive` come from its change-set part
23
+ * (no entry but `no-op` and `read`; a `delete` or `replace`), and a plan
24
+ * whose `destructive` names a class of the engine's own is destructive
25
+ * too (#4569, the sql lexicon's `sql-migrate`). A member
26
+ * whose part has holes and no artifact cannot apply, so planning fails
27
+ * with the holes' reasons. The parts compose into the wave's change-set
28
+ * document, which the pending fact cites (#4551).
29
+ * - Apply: `capability.run` with the plan's artifact in `DeployContext.plans`,
30
+ * so the run applies the plan the gate decided and nothing else. A run the
31
+ * capability refuses as moved (`isPlanMovedError`) applied nothing and the
32
+ * job exits 4, the table's moved code (#4553); any other error fails it.
33
+ *
34
+ * The registry is the project's (`fanOutRegistry`, the one `chant run
35
+ * --components` builds), loaded once per job behind a dynamic import, so the
36
+ * wave-job runtime bundle stays without the config loader. A product that
37
+ * runs chant in process passes its own (`RunOpWaveOptions.capabilities`).
38
+ *
39
+ * ## Holds (#4545)
40
+ *
41
+ * `holds` is a wave hold any product switches on, read at base with the
42
+ * policy, so a change cannot drop the hold its own wave is judged by:
43
+ *
44
+ * - `policy: true` runs the workspace's `ci.policy` (read at base, as the
45
+ * pull-request path reads it, `../components/pr-policy.ts`) over each
46
+ * run's change-set part. Its deny rules deny the run (an override then
47
+ * counts, `../override-gate.ts`), its hold rules hold it for a person, and
48
+ * a policy that cannot run fails the wave.
49
+ * - `cost` runs an estimator per run and sums the monthly change. Over
50
+ * `approveAbove` the wave waits for a person whatever its gate says, and
51
+ * the cost is a member of the set digest, so an approval at one cost does
52
+ * not apply at another. A run the estimator cannot price holds the wave
53
+ * too. The terraform lexicon's preset is `terraformCostHold` (infracost).
54
+ */
55
+ import { spawnSync } from "node:child_process";
56
+ import { existsSync, mkdirSync, writeFileSync } from "node:fs";
57
+ import { dirname, join } from "node:path";
58
+ import { isPlanMovedError } from "../components/capability.js";
59
+ import { composeChangeSet } from "../change-set.js";
60
+ import { computePlanDigest } from "../lifecycle/plan-digest.js";
61
+ import { resolvePlannedLock } from "../lifecycle/lock-rows.js";
62
+ import { OP_WAVE_COST_MEMBER } from "./op-waves-capability-spec.js";
63
+ export { OP_WAVE_COST_FORMATS, OP_WAVE_COST_MEMBER, opWaveHoldsAt, opWaveHoldsProblems, opWaveStepProblems } from "./op-waves-capability-spec.js";
64
+ /** Fill `{target}`, `{op}` and `{wave}` in every string of `value`. */
65
+ function fill(value, vars) {
66
+ if (typeof value === "string")
67
+ return value.replaceAll("{target}", vars.target).replaceAll("{op}", vars.op).replaceAll("{wave}", vars.wave);
68
+ if (Array.isArray(value))
69
+ return value.map((v) => fill(v, vars));
70
+ if (value !== null && typeof value === "object")
71
+ return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, fill(v, vars)]));
72
+ return value;
73
+ }
74
+ /** The input a run's step gets (#4545): the spec's step with the run's values filled in, and the run's own `input` over it. */
75
+ export function opWaveStepInput(spec, wave, run) {
76
+ if (!spec.step)
77
+ throw new Error("the spec names no step");
78
+ const { kind: _kind, ...rest } = spec.step;
79
+ const vars = { target: run.target, op: run.op ?? spec.op, wave: wave.name };
80
+ return { ...fill(rest, vars), ...(run.input ? fill(run.input, vars) : {}) };
81
+ }
82
+ /** The context a run's step plans and applies with: the spec's `labels.Env`, else the wave's name, and the run's target as the component. */
83
+ export function opWaveStepContext(spec, wave, run) {
84
+ return { env: spec.labels?.Env ?? wave.name, component: run.target };
85
+ }
86
+ const registries = new WeakMap();
87
+ /**
88
+ * The registry a job plans and applies through: `given`, else the project's
89
+ * at `cwd`, loaded once per `key` (the job's options) behind a dynamic
90
+ * import, which the wave-job runtime bundle leaves out.
91
+ */
92
+ export function opWaveRegistry(key, cwd, given) {
93
+ if (given)
94
+ return Promise.resolve(given);
95
+ let found = registries.get(key);
96
+ if (!found) {
97
+ found = import("../components/fan-out-support.js").then((m) => m.fanOutRegistry(cwd));
98
+ registries.set(key, found);
99
+ }
100
+ return found;
101
+ }
102
+ /** Whether a part changes nothing, and whether it destroys or replaces something. */
103
+ export function partEffects(part) {
104
+ if (!part)
105
+ return { empty: false, destructive: false };
106
+ const changing = part.entries.filter((e) => e.action !== "no-op" && e.action !== "read");
107
+ return { empty: changing.length === 0, destructive: changing.some((e) => e.action === "delete" || e.action === "replace") };
108
+ }
109
+ function resolveCapability(registry, kind) {
110
+ if (!registry.has(kind))
111
+ throw new Error(`no capability "${kind}" is registered; the project's lexicons and capability plugins (chant.config) contribute the kinds a step can name`);
112
+ return registry.resolve(kind);
113
+ }
114
+ /** Plan one run through the spec's step (#4545), writing its plan file at `planPath` (relative to `cwd`) as a per-run `plan` command would. */
115
+ export async function planOpWaveStep(at, run) {
116
+ const { spec, wave, cwd, registry } = at;
117
+ const capability = resolveCapability(registry, spec.step.kind);
118
+ if (!capability.plan)
119
+ throw new Error(`the capability "${spec.step.kind}" cannot plan, so its runs have no plan for the wave's gate to bind`);
120
+ const input = opWaveStepInput(spec, wave, run);
121
+ let planned;
122
+ let lock;
123
+ try {
124
+ planned = await capability.plan({ ...opWaveStepContext(spec, wave, run), ...(at.lockGrain ? { lockGrain: at.lockGrain } : {}), ...(at.policyBase ? { policyBase: at.policyBase } : {}) }, input);
125
+ // #4552: the run's grain (declared at base, else its lexicon's) and, on the resource grain, the rows its apply leases.
126
+ lock = await resolvePlannedLock(capability, input, planned, at.lockGrain);
127
+ }
128
+ catch (err) {
129
+ throw new Error(`planning ${run.target} through ${spec.step.kind} failed: ${err instanceof Error ? err.message : String(err)}`);
130
+ }
131
+ if (typeof planned.planDigest !== "string" || planned.planDigest === "")
132
+ throw new Error(`${spec.step.kind} planned ${run.target} with no plan digest`);
133
+ const holes = planned.changeSet?.member.holes ?? [];
134
+ if (holes.length > 0 && planned.artifact === undefined) {
135
+ throw new Error(`${run.target} was not planned: ${holes.map((h) => h.reason).join("; ")}`);
136
+ }
137
+ const effects = partEffects(planned.changeSet);
138
+ // #4569: the engine's own destructive classes count too (a rewrite, a revoke), not only a delete or replace.
139
+ if ((planned.destructive?.length ?? 0) > 0)
140
+ effects.destructive = true;
141
+ const plan = {
142
+ target: run.target,
143
+ member: planned.member,
144
+ planDigest: planned.planDigest,
145
+ ...(planned.artifact !== undefined ? { artifact: planned.artifact } : {}),
146
+ ...(planned.changeSet ? { part: planned.changeSet } : {}),
147
+ ...effects,
148
+ lock,
149
+ };
150
+ const file = join(cwd, at.planPath);
151
+ mkdirSync(dirname(file), { recursive: true });
152
+ let artifact;
153
+ try {
154
+ artifact = planned.artifact === undefined ? undefined : JSON.parse(JSON.stringify(planned.artifact));
155
+ }
156
+ catch {
157
+ artifact = undefined;
158
+ }
159
+ writeFileSync(file, JSON.stringify({
160
+ planDigest: plan.planDigest,
161
+ ...(plan.destructive ? { destructive: true } : {}),
162
+ ...(plan.empty ? { empty: true } : {}),
163
+ member: plan.member,
164
+ ...(artifact !== undefined ? { artifact } : {}),
165
+ ...(plan.part ? { changeSet: plan.part } : {}),
166
+ }) + "\n");
167
+ return plan;
168
+ }
169
+ /**
170
+ * A step's facts for its span and run record (#4555): the plan's resource
171
+ * counts by action, which core reads from the plan's change-set part, and
172
+ * whatever the capability's `traceFacts` adds. A `traceFacts` that throws
173
+ * is left out.
174
+ */
175
+ export async function opWaveStepFacts(capability, input, plan, outcome) {
176
+ const counts = {};
177
+ for (const e of plan.part?.entries ?? [])
178
+ counts[`resources.${e.action}`] = (counts[`resources.${e.action}`] ?? 0) + 1;
179
+ let own;
180
+ try {
181
+ own = await capability.traceFacts?.(input, outcome);
182
+ }
183
+ catch {
184
+ own = undefined;
185
+ }
186
+ const attributes = { member: plan.member, kind: capability.kind, ...counts, ...(own?.attributes ?? {}) };
187
+ // #4615: what the engine reported per resource goes on with the rest.
188
+ return { attributes, ...(own?.spans?.length ? { spans: own.spans } : {}), ...(own?.resources?.length ? { resources: own.resources } : {}) };
189
+ }
190
+ /** Apply one run through the spec's step (#4545), with the plan the gate decided. */
191
+ export async function applyOpWaveStep(at, run, plan) {
192
+ const { spec, wave, registry } = at;
193
+ let capability;
194
+ try {
195
+ capability = resolveCapability(registry, spec.step.kind);
196
+ }
197
+ catch (err) {
198
+ return { outcome: "failed", reason: err instanceof Error ? err.message : String(err) };
199
+ }
200
+ const ctx = { ...opWaveStepContext(spec, wave, run), ...(plan.artifact !== undefined ? { plans: { [plan.member]: plan.artifact } } : {}) };
201
+ const input = opWaveStepInput(spec, wave, run);
202
+ try {
203
+ const output = await capability.run(ctx, input);
204
+ const facts = await opWaveStepFacts(capability, input, plan, { output });
205
+ return { outcome: "applied", output, ...(facts ? { facts } : {}) };
206
+ }
207
+ catch (err) {
208
+ const reason = err instanceof Error ? err.message : String(err);
209
+ const facts = await opWaveStepFacts(capability, input, plan, { error: err });
210
+ return { ...(isPlanMovedError(err) ? { outcome: "moved", reason } : { outcome: "failed", reason }), ...(facts ? { facts } : {}) };
211
+ }
212
+ }
213
+ /** The wave's change-set document (#4551) from its runs' parts, or undefined when no run gave one. */
214
+ export function opWaveStepChangeSet(plans) {
215
+ const parts = plans.flatMap((p) => (p.part ? [p.part] : []));
216
+ return parts.length > 0 ? composeChangeSet(parts) : undefined;
217
+ }
218
+ /**
219
+ * Run the workspace's `ci.policy` at `base` over each run's part (#4545).
220
+ * Returns each run's verdict, or a line saying why no policy runs (the base
221
+ * names none). Throws when the policy at base cannot be read while the
222
+ * checkout names one, as the pull-request path does.
223
+ */
224
+ export async function opWavePolicyVerdicts(at, parts) {
225
+ const { prLoopPolicyAt, runPrPolicy } = await import("../components/pr-policy.js");
226
+ const read = prLoopPolicyAt(at.cwd, at.base);
227
+ if (!read.settings)
228
+ return { note: read.note ?? `holds.policy: the declaration at ${at.base.slice(0, 12)} names no ci.policy, so no policy runs` };
229
+ const verdicts = new Map();
230
+ for (const [target, part] of parts) {
231
+ const verdict = runPrPolicy(read, { version: 1, stage: "apply", op: at.spec.name, gate: at.gate, env: at.env, pr: null, base: at.base, head: at.head, changeSet: composeChangeSet([part]) }, at.exec);
232
+ if (!verdict)
233
+ continue;
234
+ const reason = verdict.result === "error" ? verdict.error : [...verdict.denials, ...verdict.holds].map((f) => f.message).filter(Boolean).join("; ") || undefined;
235
+ verdicts.set(target, { result: verdict.result, rules: verdict.rules, holds: [...new Set(verdict.holds.map((h) => h.rule))].sort(), ...(reason ? { reason } : {}) });
236
+ }
237
+ return { verdicts, ...(read.source ? { source: read.source } : {}) };
238
+ }
239
+ /** The monthly change an estimate gives, in `format`. Throws when it gives none. */
240
+ export function readCostEstimate(format, stdout) {
241
+ const doc = JSON.parse(stdout);
242
+ const num = (v) => (typeof v === "number" && Number.isFinite(v) ? v : typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v)) ? Number(v) : undefined);
243
+ if (format === "chant") {
244
+ const delta = num(doc.monthlyDelta);
245
+ if (delta === undefined)
246
+ throw new Error("the estimate has no monthlyDelta");
247
+ return { monthlyDelta: delta, ...(typeof doc.currency === "string" ? { currency: doc.currency } : {}) };
248
+ }
249
+ // infracost breakdown --format json: diffTotalMonthlyCost, else totalMonthlyCost less pastTotalMonthlyCost.
250
+ const diff = num(doc.diffTotalMonthlyCost);
251
+ const total = num(doc.totalMonthlyCost);
252
+ const past = num(doc.pastTotalMonthlyCost);
253
+ const delta = diff ?? (total !== undefined ? total - (past ?? 0) : undefined);
254
+ if (delta === undefined)
255
+ throw new Error("the infracost document has no diffTotalMonthlyCost or totalMonthlyCost");
256
+ return { monthlyDelta: delta, ...(typeof doc.currency === "string" ? { currency: doc.currency } : {}) };
257
+ }
258
+ const defaultHoldExec = (argv, cwd) => {
259
+ const r = spawnSync(argv[0], argv.slice(1), { cwd, encoding: "utf-8", maxBuffer: 64 * 1024 * 1024 });
260
+ return { status: r.error ? null : r.status, stdout: r.stdout ?? "", stderr: `${r.stderr ?? ""}${r.error ? r.error.message : ""}` };
261
+ };
262
+ /** The engine's plan document a capability's artifact names (`artifact.planJson`), when it names one that exists. */
263
+ export function planJsonOf(artifact, cwd) {
264
+ const p = artifact?.planJson;
265
+ if (typeof p !== "string" || p === "")
266
+ return undefined;
267
+ const path = p.startsWith("/") ? p : join(cwd, p);
268
+ return existsSync(path) ? path : undefined;
269
+ }
270
+ /** Price each run that changes something (#4545). A run with no estimate says why. */
271
+ export function opWaveCosts(hold, runs, cwd, exec = defaultHoldExec) {
272
+ const format = hold.format ?? "infracost";
273
+ const out = [];
274
+ for (const run of runs) {
275
+ if (run.empty)
276
+ continue;
277
+ const planJson = planJsonOf(run.artifact, cwd);
278
+ if (hold.command.some((a) => a.includes("{planJson}")) && !planJson) {
279
+ out.push({ target: run.target, error: "its plan names no plan document to price" });
280
+ continue;
281
+ }
282
+ const argv = hold.command.map((a) => a.replaceAll("{target}", run.target).replaceAll("{plan}", run.plan).replaceAll("{planJson}", planJson ?? ""));
283
+ const r = exec(argv, cwd);
284
+ if (r.status !== 0) {
285
+ out.push({ target: run.target, error: `${argv[0]} ${r.status === null ? "did not run" : `exited ${r.status}`}: ${(r.stderr || r.stdout).trim().split("\n").slice(-2).join(" ")}` });
286
+ continue;
287
+ }
288
+ try {
289
+ out.push({ target: run.target, ...readCostEstimate(format, r.stdout) });
290
+ }
291
+ catch (err) {
292
+ out.push({ target: run.target, error: `the estimate cannot be read: ${err instanceof Error ? err.message : String(err)}` });
293
+ }
294
+ }
295
+ return out;
296
+ }
297
+ /** Sum a wave's estimates against `approveAbove` (#4545). */
298
+ export function opWaveCostVerdict(hold, costs) {
299
+ const priced = costs.filter((c) => "monthlyDelta" in c);
300
+ const unestimated = costs.filter((c) => "error" in c).map((c) => c.target).sort();
301
+ const monthlyDelta = Math.round(priced.reduce((sum, c) => sum + c.monthlyDelta, 0) * 100) / 100;
302
+ const currency = hold.currency ?? priced.find((c) => c.currency)?.currency ?? "USD";
303
+ const member = { member: OP_WAVE_COST_MEMBER, planDigest: computePlanDigest("op-wave-cost", { approveAbove: hold.approveAbove, currency, monthlyDelta, unestimated }) };
304
+ const signed = `${monthlyDelta >= 0 ? "+" : ""}${monthlyDelta.toFixed(2)} ${currency}`;
305
+ const reasons = [];
306
+ if (monthlyDelta > hold.approveAbove)
307
+ reasons.push(`its monthly change of ${signed} is over holds.cost.approveAbove (${hold.approveAbove} ${currency})`);
308
+ if (unestimated.length > 0)
309
+ reasons.push(`${unestimated.join(", ")} could not be priced`);
310
+ return { monthlyDelta, currency, unestimated, member, ...(reasons.length > 0 ? { hold: `cost: ${reasons.join(", and ")}` } : {}) };
311
+ }
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Run events for one `chant run wave` job (#4555), on the run-event contract
3
+ * (../run-event.ts), and its trace through chant's OTLP exporter (../otlp.ts).
4
+ *
5
+ * The job is an Op run (`kind: "op"`, named for the spec). Each wave it
6
+ * walks is a phase `wave-<k>`, as its run record names it (#4551), and each
7
+ * run target is a step of that phase. A target's `step-start` and
8
+ * `step-settle` are written as its apply starts and ends, so a reader
9
+ * following the stream sees each root or stack as it applies. When the job
10
+ * ends, the targets it never applied (moved, blocked, waiting, or planned
11
+ * only) settle as `skipped`, a job that waits at a gate writes
12
+ * `gate-waiting` on a `gate:<name>` step of its last phase, and the phases
13
+ * and the run settle with the run record's verdict. The stream and the
14
+ * record therefore say the same thing.
15
+ *
16
+ * Under the trace, each target's span carries what its capability knew
17
+ * (`Capability.traceFacts`): engine facts as attributes, and a child span per
18
+ * resource the engine timed. When the capability reports per-resource lines
19
+ * (`CapabilityTraceFacts.resources`, #4615), the target's `step-settle`
20
+ * carries them as `resources`.
21
+ */
22
+ import type { RunEventSink } from "../run-event-stream.js";
23
+ import type { CapabilityTraceFacts, RunEventTrace } from "../otlp.js";
24
+ import type { OpRunRecordInput } from "./runtime.js";
25
+ /** How one target's apply settled, as the step says it. */
26
+ export type OpWaveTargetSettle = "ok" | "failed" | "skipped";
27
+ /** One job's stream: the emitter, and the trace built from it when the exporter is on. */
28
+ export declare class OpWaveRunEvents {
29
+ private readonly sink;
30
+ readonly trace?: RunEventTrace | undefined;
31
+ private readonly phases;
32
+ private readonly settled;
33
+ constructor(sink: RunEventSink, trace?: RunEventTrace | undefined);
34
+ private emit;
35
+ private phase;
36
+ start(): void;
37
+ /** A target's apply begins. */
38
+ stepStart(k: number, target: string): void;
39
+ /** A target's apply ended, with its time and what its capability knew. */
40
+ stepSettle(k: number, target: string, status: OpWaveTargetSettle, durationMs: number | null, opts?: {
41
+ error?: string;
42
+ message?: string;
43
+ facts?: CapabilityTraceFacts;
44
+ }): void;
45
+ /**
46
+ * The job ended: settle what is still open from its run record, then the
47
+ * run. `moved` and `blocked` give the reason a skipped target says.
48
+ */
49
+ finish(record: OpRunRecordInput, why?: {
50
+ moved?: readonly string[];
51
+ blocked?: Readonly<Record<string, string>>;
52
+ }): void;
53
+ }
54
+ //# sourceMappingURL=op-waves-events.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"op-waves-events.d.ts","sourceRoot":"","sources":["../../src/op/op-waves-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,2DAA2D;AAC3D,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D,0FAA0F;AAC1F,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa;IALhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,YACmB,IAAI,EAAE,YAAY,EAC1B,KAAK,CAAC,EAAE,aAAa,YAAA,EAC5B;IAEJ,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,KAAK;IASb,KAAK,IAAI,IAAI,CAEZ;IAED,+BAA+B;IAC/B,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGzC;IAED,0EAA0E;IAC1E,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,oBAAoB,CAAA;KAAO,GAAG,IAAI,CAiBhL;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,GAAE;QAAE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;KAAO,GAAG,IAAI,CA0C1H;CACF"}
@@ -0,0 +1,122 @@
1
+ /**
2
+ * Run events for one `chant run wave` job (#4555), on the run-event contract
3
+ * (../run-event.ts), and its trace through chant's OTLP exporter (../otlp.ts).
4
+ *
5
+ * The job is an Op run (`kind: "op"`, named for the spec). Each wave it
6
+ * walks is a phase `wave-<k>`, as its run record names it (#4551), and each
7
+ * run target is a step of that phase. A target's `step-start` and
8
+ * `step-settle` are written as its apply starts and ends, so a reader
9
+ * following the stream sees each root or stack as it applies. When the job
10
+ * ends, the targets it never applied (moved, blocked, waiting, or planned
11
+ * only) settle as `skipped`, a job that waits at a gate writes
12
+ * `gate-waiting` on a `gate:<name>` step of its last phase, and the phases
13
+ * and the run settle with the run record's verdict. The stream and the
14
+ * record therefore say the same thing.
15
+ *
16
+ * Under the trace, each target's span carries what its capability knew
17
+ * (`Capability.traceFacts`): engine facts as attributes, and a child span per
18
+ * resource the engine timed. When the capability reports per-resource lines
19
+ * (`CapabilityTraceFacts.resources`, #4615), the target's `step-settle`
20
+ * carries them as `resources`.
21
+ */
22
+ /** One job's stream: the emitter, and the trace built from it when the exporter is on. */
23
+ export class OpWaveRunEvents {
24
+ constructor(sink, trace) {
25
+ this.sink = sink;
26
+ this.trace = trace;
27
+ this.phases = [];
28
+ this.settled = new Set();
29
+ }
30
+ emit(body) {
31
+ try {
32
+ this.sink(body);
33
+ }
34
+ catch {
35
+ // A reader that fails never changes the job.
36
+ }
37
+ }
38
+ phase(k) {
39
+ const name = `wave-${k}`;
40
+ if (!this.phases.includes(name)) {
41
+ this.phases.push(name);
42
+ this.emit({ type: "phase-start", component: null, phase: name });
43
+ }
44
+ return name;
45
+ }
46
+ start() {
47
+ this.emit({ type: "run-start", waves: null });
48
+ }
49
+ /** A target's apply begins. */
50
+ stepStart(k, target) {
51
+ const phase = this.phase(k);
52
+ this.emit({ type: "step-start", component: null, phase, step: target });
53
+ }
54
+ /** A target's apply ended, with its time and what its capability knew. */
55
+ stepSettle(k, target, status, durationMs, opts = {}) {
56
+ const phase = this.phase(k);
57
+ this.settled.add(`${phase}\u0000${target}`);
58
+ if (opts.facts)
59
+ this.trace?.annotate({ phase, step: target }, opts.facts);
60
+ this.emit({
61
+ type: "step-settle",
62
+ component: null,
63
+ phase,
64
+ step: target,
65
+ status,
66
+ ...(status === "skipped" ? { skip: null } : {}),
67
+ durationMs,
68
+ ...(opts.error !== undefined ? { error: opts.error } : {}),
69
+ ...(opts.message !== undefined ? { message: opts.message } : {}),
70
+ // #4615: what the engine reported per resource, when it reported anything.
71
+ ...(opts.facts?.resources?.length ? { resources: opts.facts.resources.map((r) => ({ ...r })) } : {}),
72
+ });
73
+ }
74
+ /**
75
+ * The job ended: settle what is still open from its run record, then the
76
+ * run. `moved` and `blocked` give the reason a skipped target says.
77
+ */
78
+ finish(record, why = {}) {
79
+ const moved = new Set(why.moved ?? []);
80
+ const last = record.phases[record.phases.length - 1]?.name;
81
+ for (const p of record.phases) {
82
+ if (!this.phases.includes(p.name)) {
83
+ this.phases.push(p.name);
84
+ this.emit({ type: "phase-start", component: null, phase: p.name });
85
+ }
86
+ for (const step of p.steps) {
87
+ if (this.settled.has(`${p.name}\u0000${step.fn}`))
88
+ continue;
89
+ const status = step.status === "ok" ? "ok" : step.status === "fail" ? "failed" : "skipped";
90
+ const by = why.blocked?.[step.fn];
91
+ const message = moved.has(step.fn) ? "its plan moved since the wave was decided" : by !== undefined ? `blocked by ${by}` : undefined;
92
+ this.emit({
93
+ type: "step-settle",
94
+ component: null,
95
+ phase: p.name,
96
+ step: step.fn,
97
+ status,
98
+ ...(status === "skipped" ? { skip: moved.has(step.fn) ? "refused" : "not-run" } : {}),
99
+ durationMs: status === "skipped" ? null : step.durationMs,
100
+ ...(message ? { message } : {}),
101
+ });
102
+ }
103
+ let status = p.status === "fail" ? "failed" : "ok";
104
+ if (p.name === last && (record.status === "gated" || record.status === "waiting")) {
105
+ const gate = record.gate;
106
+ const step = `gate:${gate?.name ?? record.point?.point ?? "point"}`;
107
+ this.emit({ type: "step-start", component: null, phase: p.name, step });
108
+ this.emit({ type: "gate-waiting", component: null, phase: p.name, step, op: gate?.op ?? record.op, gate: gate?.name ?? null, point: record.point?.id ?? null });
109
+ this.emit({ type: "step-settle", component: null, phase: p.name, step, status: record.status, durationMs: null });
110
+ status = record.status;
111
+ }
112
+ this.emit({ type: "phase-settle", component: null, phase: p.name, status });
113
+ }
114
+ const runStatus = record.status === "fail" ? "failed" : record.status;
115
+ this.emit({
116
+ type: "run-settle",
117
+ status: runStatus,
118
+ durationMs: Math.max(0, Date.parse(record.ended) - Date.parse(record.started)) || null,
119
+ ...(record.failure ? { failure: { ...record.failure } } : {}),
120
+ });
121
+ }
122
+ }
@@ -12,8 +12,14 @@
12
12
  * newer run (exit 6) sends nothing. A share job of a waiting wave sends nothing, since its deciding
13
13
  * job already did, unless a hook in the share job itself held it (#3762). Delivery is `../notify.ts`: it never throws, and the job's exit code
14
14
  * is what the wave decided.
15
+ *
16
+ * The event's `source`, the summary's wave label and verbs, and the
17
+ * webhook's header prefix come from the active product's words (#4610):
18
+ * plywood's job sends `source: plywood` with `x-plywood-*` headers, and
19
+ * chant's own words send what they always sent.
15
20
  */
16
21
  import { type NotifyDelivery, type NotifyFields, type SendNotifyOptions } from "../notify.js";
22
+ import { type CiProductWords } from "../ci-product-words.js";
17
23
  import type { OpWavesSpec } from "./op-waves.js";
18
24
  import type { RunOpWaveResult } from "./op-waves-run.js";
19
25
  /** How the job ended: the wave's result, or the error that stopped it. */
@@ -28,7 +34,7 @@ export type OpWaveOutcome = {
28
34
  export declare function opWaveNotifyFields(spec: OpWavesSpec, k: number, outcome: OpWaveOutcome, job?: {
29
35
  share?: number;
30
36
  group?: string;
31
- }): NotifyFields | undefined;
37
+ }, words?: CiProductWords): NotifyFields | undefined;
32
38
  /** Send what the job's outcome calls for to what `spec.notify` names. Never throws. */
33
39
  export declare function notifyOpWave(spec: OpWavesSpec, k: number, outcome: OpWaveOutcome, job?: {
34
40
  share?: number;
@@ -1 +1 @@
1
- {"version":3,"file":"op-waves-notify.d.ts","sourceRoot":"","sources":["../../src/op/op-waves-notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAoD,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC7I,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnH,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,GAAG,SAAS,CAoG/J;AAQD,uFAAuF;AACvF,wBAAsB,YAAY,CAChC,IAAI,EAAE,WAAW,EACjB,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,aAAa,EACtB,GAAG,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,EAC5C,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,cAAc,EAAE,CAAC,CAW3B"}
1
+ {"version":3,"file":"op-waves-notify.d.ts","sourceRoot":"","sources":["../../src/op/op-waves-notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAoD,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC7I,OAAO,EAAqD,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnH,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EACjB,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,aAAa,EACtB,GAAG,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,EAC5C,KAAK,GAAE,cAAqC,GAC3C,YAAY,GAAG,SAAS,CAsG1B;AAcD,uFAAuF;AACvF,wBAAsB,YAAY,CAChC,IAAI,EAAE,WAAW,EACjB,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,aAAa,EACtB,GAAG,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,EAC5C,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,cAAc,EAAE,CAAC,CAa3B"}
@@ -12,25 +12,36 @@
12
12
  * newer run (exit 6) sends nothing. A share job of a waiting wave sends nothing, since its deciding
13
13
  * job already did, unless a hook in the share job itself held it (#3762). Delivery is `../notify.ts`: it never throws, and the job's exit code
14
14
  * is what the wave decided.
15
+ *
16
+ * The event's `source`, the summary's wave label and verbs, and the
17
+ * webhook's header prefix come from the active product's words (#4610):
18
+ * plywood's job sends `source: plywood` with `x-plywood-*` headers, and
19
+ * chant's own words send what they always sent.
15
20
  */
16
21
  import { makeNotifyEvent, notifyConfigProblem, sendNotify } from "../notify.js";
22
+ import { activeProductWords, isChantWords, notifyWaveLabel } from "../ci-product-words.js";
23
+ import { productNotifySource, productSendOptions } from "../notify-product.js";
24
+ import { CHANT_EXIT } from "../exit-codes.js";
25
+ import { approveCommand } from "./gate.js";
17
26
  /** The event a wave job sends, or undefined when it sends none. */
18
- export function opWaveNotifyFields(spec, k, outcome, job = {}) {
27
+ export function opWaveNotifyFields(spec, k, outcome, job = {}, words = activeProductWords()) {
19
28
  const wave = spec.waves[k - 1];
20
29
  const name = wave?.name;
21
- const label = `wave ${k}${name ? ` (${name})` : ""} of ${spec.name}`;
30
+ const label = notifyWaveLabel(words, { k, ...(name ? { name } : {}), spec: spec.name });
31
+ const source = productNotifySource(words);
32
+ const [applyVerb, appliedVerb] = words.verbs.apply;
22
33
  if (outcome.error !== undefined) {
23
- return { source: "chant", event: "failed", summary: `${label} failed`, wave: { number: k, ...(name ? { name } : {}) }, targets: [], reason: outcome.error, exitCode: 1 };
34
+ return { source, event: "failed", summary: `${label} failed`, wave: { number: k, ...(name ? { name } : {}) }, targets: [], reason: outcome.error, exitCode: 1 };
24
35
  }
25
36
  const { result } = outcome;
26
37
  const decision = result.decision;
27
38
  const base = {
28
- source: "chant",
39
+ source,
29
40
  wave: { number: k, ...(name ? { name } : {}), ...(decision?.gate ? { gate: decision.gate } : {}) },
30
41
  ...(decision?.digest ? { digest: decision.digest } : {}),
31
42
  exitCode: result.exitCode,
32
43
  };
33
- if (result.exitCode === 3) {
44
+ if (result.exitCode === CHANT_EXIT.waiting) {
34
45
  if (!decision)
35
46
  return undefined;
36
47
  // A share job's wait (or a job group's, #3914) was announced by its deciding job, unless a hook in this job held it (#3762).
@@ -44,7 +55,7 @@ export function opWaveNotifyFields(spec, k, outcome, job = {}) {
44
55
  status: "waiting",
45
56
  summary: `${label} waits for an approval`,
46
57
  targets: decision.members.map((m) => m.member),
47
- approve: { command: decision.approve ?? `chant approve ${decision.op} ${decision.gate} --plan ${decision.digest}`, ...review },
58
+ approve: { command: decision.approve ?? approveCommand(decision.op, decision.gate, undefined, decision.digest), ...chantApprove(words, decision), ...review },
48
59
  ...(decision.heldOn
49
60
  ? { reason: `held on ${decision.heldOn.op} / ${decision.heldOn.gate} by ${decision.heldOn.hook}` }
50
61
  : decision.heldBy?.length
@@ -54,7 +65,7 @@ export function opWaveNotifyFields(spec, k, outcome, job = {}) {
54
65
  : {}),
55
66
  };
56
67
  }
57
- if (result.exitCode === 8 && decision?.refused?.reason === "point") {
68
+ if (result.exitCode === CHANT_EXIT.declined && decision?.refused?.reason === "point") {
58
69
  // #3836: the gate's decision point was answered with an answer it does not pass on.
59
70
  return {
60
71
  ...base,
@@ -65,7 +76,7 @@ export function opWaveNotifyFields(spec, k, outcome, job = {}) {
65
76
  ...(decision.refused.message ? { reason: decision.refused.message } : {}),
66
77
  };
67
78
  }
68
- if (result.exitCode === 7 && decision?.refused) {
79
+ if (result.exitCode === CHANT_EXIT.denied && decision?.refused) {
69
80
  // #3821: the product's policy denied a run, and no override counts for it.
70
81
  return {
71
82
  ...base,
@@ -79,20 +90,20 @@ export function opWaveNotifyFields(spec, k, outcome, job = {}) {
79
90
  };
80
91
  }
81
92
  // #3821: an apply that stood down for a newer run is no news; one held by another run is refused.
82
- if (result.exitCode === 6 && result.outcome?.outcome === "stood-down")
93
+ if (result.exitCode === CHANT_EXIT.superseded && result.outcome?.outcome === "stood-down")
83
94
  return undefined;
84
- if (result.exitCode === 5 && result.outcome?.outcome === "held") {
95
+ if (result.exitCode === CHANT_EXIT.held && result.outcome?.outcome === "held") {
85
96
  const holder = result.outcome.holder;
86
97
  return {
87
98
  ...base,
88
99
  event: "refused",
89
100
  status: "held",
90
- summary: `${label} applied nothing: another run${holder ? ` (${holder.run})` : ""} holds what it changes`,
101
+ summary: `${label} ${appliedVerb} nothing: another run${holder ? ` (${holder.run})` : ""} holds what it changes`,
91
102
  targets: decision?.members.map((m) => m.member) ?? [],
92
103
  reason: result.outcome.reason ?? `another run${holder ? `, ${holder.run},` : ""} holds what the apply changes; apply again once it is done`,
93
104
  };
94
105
  }
95
- if (result.exitCode === 4) {
106
+ if (result.exitCode === CHANT_EXIT.moved) {
96
107
  return {
97
108
  ...base,
98
109
  event: "refused",
@@ -111,13 +122,19 @@ export function opWaveNotifyFields(spec, k, outcome, job = {}) {
111
122
  ...base,
112
123
  event: "failed",
113
124
  status: "failed",
114
- summary: `${label} failed: ${result.failed.length > 0 ? `${result.failed.join(", ")} did not apply` : `exit ${result.exitCode}`}`,
125
+ summary: `${label} failed: ${result.failed.length > 0 ? `${result.failed.join(", ")} did not ${applyVerb}` : `exit ${result.exitCode}`}`,
115
126
  targets: result.failed,
116
- ...(result.failed.length > 0 ? { reason: `the apply command failed for ${result.failed.join(", ")}` } : {}),
127
+ ...(result.failed.length > 0 ? { reason: `the ${applyVerb} command failed for ${result.failed.join(", ")}` } : {}),
117
128
  };
118
129
  }
119
130
  return undefined;
120
131
  }
132
+ /** chant's own approve line beside a product's (`approve.chant` in the event), so a receiver that runs chant can approve too. */
133
+ function chantApprove(words, decision) {
134
+ if (isChantWords(words) || !decision.digest)
135
+ return {};
136
+ return { chant: `chant approve ${decision.op} ${decision.gate} --plan ${decision.digest}` };
137
+ }
121
138
  /** `, share 2,`, `, job group prod,` or `, share 2 of job group prod,`; empty for a wave's own job. */
122
139
  function jobPart(job) {
123
140
  if (job.group !== undefined)
@@ -130,10 +147,12 @@ export async function notifyOpWave(spec, k, outcome, job = {}, options = {}) {
130
147
  if (!spec.notify || notifyConfigProblem(spec.notify) !== undefined)
131
148
  return [];
132
149
  try {
133
- const fields = opWaveNotifyFields(spec, k, outcome, job);
150
+ const words = activeProductWords();
151
+ const fields = opWaveNotifyFields(spec, k, outcome, job, words);
134
152
  if (!fields)
135
153
  return [];
136
- return await sendNotify(spec.notify, makeNotifyEvent(fields, { ...(options.env ? { env: options.env } : {}) }), options);
154
+ // #4610: the product's header prefix, unless the caller names one.
155
+ return await sendNotify(spec.notify, makeNotifyEvent(fields, { ...(options.env ? { env: options.env } : {}) }), productSendOptions(words, options));
137
156
  }
138
157
  catch (e) {
139
158
  (options.log ?? ((line) => process.stderr.write(line + "\n")))(`notify: nothing was sent: ${e instanceof Error ? e.message : String(e)}`);