@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,370 @@
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
+
56
+ import { spawnSync } from "node:child_process";
57
+ import { existsSync, mkdirSync, writeFileSync } from "node:fs";
58
+ import { dirname, join } from "node:path";
59
+ import type { Capability, CapabilityPlan, CapabilityRegistry, DeployContext } from "../components/capability";
60
+ import { isPlanMovedError } from "../components/capability";
61
+ import type { CapabilityTraceFacts } from "../otlp";
62
+ import { composeChangeSet, type ChangeSetDocument, type ChangeSetPart } from "../change-set";
63
+ import { computePlanDigest } from "../lifecycle/plan-digest";
64
+ import type { GatePolicyExec, GatePolicyRun } from "../gate-policy";
65
+ import type { ResolvedGatePolicySource } from "../policy-source";
66
+ import type { WaveMember } from "../wave-engine";
67
+ import type { OpWave, OpWaveRun, OpWavesSpec } from "./op-waves";
68
+ import { resolvePlannedLock, type LockGrain, type PlannedLock } from "../lifecycle/lock-rows";
69
+
70
+ import { OP_WAVE_COST_FORMATS, OP_WAVE_COST_MEMBER, type OpWaveCostFormat, type OpWaveCostHold, type OpWaveStep } from "./op-waves-capability-spec";
71
+
72
+ export { OP_WAVE_COST_FORMATS, OP_WAVE_COST_MEMBER, opWaveHoldsAt, opWaveHoldsProblems, opWaveStepProblems } from "./op-waves-capability-spec";
73
+ export type { OpWaveCostFormat, OpWaveCostHold, OpWaveHolds, OpWaveStep } from "./op-waves-capability-spec";
74
+
75
+ /** Fill `{target}`, `{op}` and `{wave}` in every string of `value`. */
76
+ function fill(value: unknown, vars: { target: string; op: string; wave: string }): unknown {
77
+ if (typeof value === "string") return value.replaceAll("{target}", vars.target).replaceAll("{op}", vars.op).replaceAll("{wave}", vars.wave);
78
+ if (Array.isArray(value)) return value.map((v) => fill(v, vars));
79
+ if (value !== null && typeof value === "object") return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, fill(v, vars)]));
80
+ return value;
81
+ }
82
+
83
+ /** 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. */
84
+ export function opWaveStepInput(spec: Pick<OpWavesSpec, "op" | "step">, wave: Pick<OpWave, "name">, run: OpWaveRun): Record<string, unknown> {
85
+ if (!spec.step) throw new Error("the spec names no step");
86
+ const { kind: _kind, ...rest } = spec.step;
87
+ const vars = { target: run.target, op: run.op ?? spec.op, wave: wave.name };
88
+ return { ...(fill(rest, vars) as Record<string, unknown>), ...((run.input ? fill(run.input, vars) : {}) as Record<string, unknown>) };
89
+ }
90
+
91
+ /** 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. */
92
+ export function opWaveStepContext(spec: Pick<OpWavesSpec, "labels">, wave: Pick<OpWave, "name">, run: OpWaveRun): DeployContext {
93
+ return { env: spec.labels?.Env ?? wave.name, component: run.target };
94
+ }
95
+
96
+ const registries = new WeakMap<object, Promise<CapabilityRegistry>>();
97
+
98
+ /**
99
+ * The registry a job plans and applies through: `given`, else the project's
100
+ * at `cwd`, loaded once per `key` (the job's options) behind a dynamic
101
+ * import, which the wave-job runtime bundle leaves out.
102
+ */
103
+ export function opWaveRegistry(key: object, cwd: string, given?: CapabilityRegistry): Promise<CapabilityRegistry> {
104
+ if (given) return Promise.resolve(given);
105
+ let found = registries.get(key);
106
+ if (!found) {
107
+ found = import("../components/fan-out-support").then((m) => m.fanOutRegistry(cwd));
108
+ registries.set(key, found);
109
+ }
110
+ return found;
111
+ }
112
+
113
+ /** One run's plan through its step: what the gate binds, and what the apply hands back. */
114
+ export interface OpWaveStepPlan {
115
+ target: string;
116
+ /** The capability's member, the key `run` finds its artifact under. */
117
+ member: string;
118
+ planDigest: string;
119
+ artifact?: unknown;
120
+ part?: ChangeSetPart;
121
+ empty: boolean;
122
+ destructive: boolean;
123
+ /** The run's lock grain and rows (#4552), which the apply leases on the resource grain. */
124
+ lock?: PlannedLock;
125
+ }
126
+
127
+ /** Whether a part changes nothing, and whether it destroys or replaces something. */
128
+ export function partEffects(part: ChangeSetPart | undefined): { empty: boolean; destructive: boolean } {
129
+ if (!part) return { empty: false, destructive: false };
130
+ const changing = part.entries.filter((e) => e.action !== "no-op" && e.action !== "read");
131
+ return { empty: changing.length === 0, destructive: changing.some((e) => e.action === "delete" || e.action === "replace") };
132
+ }
133
+
134
+ function resolveCapability(registry: CapabilityRegistry, kind: string): Capability<never, unknown> {
135
+ if (!registry.has(kind)) throw new Error(`no capability "${kind}" is registered; the project's lexicons and capability plugins (chant.config) contribute the kinds a step can name`);
136
+ return registry.resolve(kind);
137
+ }
138
+
139
+ /** 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. */
140
+ export async function planOpWaveStep(
141
+ at: { spec: OpWavesSpec; wave: OpWave; cwd: string; registry: CapabilityRegistry; planPath: string; lockGrain?: LockGrain | null; policyBase?: string },
142
+ run: OpWaveRun,
143
+ ): Promise<OpWaveStepPlan> {
144
+ const { spec, wave, cwd, registry } = at;
145
+ const capability = resolveCapability(registry, spec.step!.kind);
146
+ if (!capability.plan) throw new Error(`the capability "${spec.step!.kind}" cannot plan, so its runs have no plan for the wave's gate to bind`);
147
+ const input = opWaveStepInput(spec, wave, run);
148
+ let planned: CapabilityPlan;
149
+ let lock: PlannedLock;
150
+ try {
151
+ planned = await capability.plan({ ...opWaveStepContext(spec, wave, run), ...(at.lockGrain ? { lockGrain: at.lockGrain } : {}), ...(at.policyBase ? { policyBase: at.policyBase } : {}) }, input as never);
152
+ // #4552: the run's grain (declared at base, else its lexicon's) and, on the resource grain, the rows its apply leases.
153
+ lock = await resolvePlannedLock(capability, input, planned, at.lockGrain);
154
+ } catch (err) {
155
+ throw new Error(`planning ${run.target} through ${spec.step!.kind} failed: ${err instanceof Error ? err.message : String(err)}`);
156
+ }
157
+ if (typeof planned.planDigest !== "string" || planned.planDigest === "") throw new Error(`${spec.step!.kind} planned ${run.target} with no plan digest`);
158
+ const holes = planned.changeSet?.member.holes ?? [];
159
+ if (holes.length > 0 && planned.artifact === undefined) {
160
+ throw new Error(`${run.target} was not planned: ${holes.map((h) => h.reason).join("; ")}`);
161
+ }
162
+ const effects = partEffects(planned.changeSet);
163
+ // #4569: the engine's own destructive classes count too (a rewrite, a revoke), not only a delete or replace.
164
+ if ((planned.destructive?.length ?? 0) > 0) effects.destructive = true;
165
+ const plan: OpWaveStepPlan = {
166
+ target: run.target,
167
+ member: planned.member,
168
+ planDigest: planned.planDigest,
169
+ ...(planned.artifact !== undefined ? { artifact: planned.artifact } : {}),
170
+ ...(planned.changeSet ? { part: planned.changeSet } : {}),
171
+ ...effects,
172
+ lock,
173
+ };
174
+ const file = join(cwd, at.planPath);
175
+ mkdirSync(dirname(file), { recursive: true });
176
+ let artifact: unknown;
177
+ try {
178
+ artifact = planned.artifact === undefined ? undefined : JSON.parse(JSON.stringify(planned.artifact));
179
+ } catch {
180
+ artifact = undefined;
181
+ }
182
+ writeFileSync(
183
+ file,
184
+ JSON.stringify({
185
+ planDigest: plan.planDigest,
186
+ ...(plan.destructive ? { destructive: true } : {}),
187
+ ...(plan.empty ? { empty: true } : {}),
188
+ member: plan.member,
189
+ ...(artifact !== undefined ? { artifact } : {}),
190
+ ...(plan.part ? { changeSet: plan.part } : {}),
191
+ }) + "\n",
192
+ );
193
+ return plan;
194
+ }
195
+
196
+ /** How one run's apply through its step came out, with what the capability knew about it (#4555). */
197
+ export type OpWaveStepApply = ({ outcome: "applied"; output: unknown } | { outcome: "moved"; reason: string } | { outcome: "failed"; reason: string }) & { facts?: CapabilityTraceFacts };
198
+
199
+ /**
200
+ * A step's facts for its span and run record (#4555): the plan's resource
201
+ * counts by action, which core reads from the plan's change-set part, and
202
+ * whatever the capability's `traceFacts` adds. A `traceFacts` that throws
203
+ * is left out.
204
+ */
205
+ export async function opWaveStepFacts(
206
+ capability: Capability<never, unknown>,
207
+ input: unknown,
208
+ plan: OpWaveStepPlan,
209
+ outcome: { output: unknown } | { error: unknown },
210
+ ): Promise<CapabilityTraceFacts | undefined> {
211
+ const counts: Record<string, number> = {};
212
+ for (const e of plan.part?.entries ?? []) counts[`resources.${e.action}`] = (counts[`resources.${e.action}`] ?? 0) + 1;
213
+ let own: CapabilityTraceFacts | undefined;
214
+ try {
215
+ own = await capability.traceFacts?.(input as never, outcome);
216
+ } catch {
217
+ own = undefined;
218
+ }
219
+ const attributes = { member: plan.member, kind: capability.kind, ...counts, ...(own?.attributes ?? {}) };
220
+ // #4615: what the engine reported per resource goes on with the rest.
221
+ return { attributes, ...(own?.spans?.length ? { spans: own.spans } : {}), ...(own?.resources?.length ? { resources: own.resources } : {}) };
222
+ }
223
+
224
+ /** Apply one run through the spec's step (#4545), with the plan the gate decided. */
225
+ export async function applyOpWaveStep(at: { spec: OpWavesSpec; wave: OpWave; registry: CapabilityRegistry }, run: OpWaveRun, plan: OpWaveStepPlan): Promise<OpWaveStepApply> {
226
+ const { spec, wave, registry } = at;
227
+ let capability: Capability<never, unknown>;
228
+ try {
229
+ capability = resolveCapability(registry, spec.step!.kind);
230
+ } catch (err) {
231
+ return { outcome: "failed", reason: err instanceof Error ? err.message : String(err) };
232
+ }
233
+ const ctx: DeployContext = { ...opWaveStepContext(spec, wave, run), ...(plan.artifact !== undefined ? { plans: { [plan.member]: plan.artifact } } : {}) };
234
+ const input = opWaveStepInput(spec, wave, run);
235
+ try {
236
+ const output = await capability.run(ctx, input as never);
237
+ const facts = await opWaveStepFacts(capability, input, plan, { output });
238
+ return { outcome: "applied", output, ...(facts ? { facts } : {}) };
239
+ } catch (err) {
240
+ const reason = err instanceof Error ? err.message : String(err);
241
+ const facts = await opWaveStepFacts(capability, input, plan, { error: err });
242
+ return { ...(isPlanMovedError(err) ? { outcome: "moved" as const, reason } : { outcome: "failed" as const, reason }), ...(facts ? { facts } : {}) };
243
+ }
244
+ }
245
+
246
+ /** The wave's change-set document (#4551) from its runs' parts, or undefined when no run gave one. */
247
+ export function opWaveStepChangeSet(plans: readonly OpWaveStepPlan[]): ChangeSetDocument | undefined {
248
+ const parts = plans.flatMap((p) => (p.part ? [p.part] : []));
249
+ return parts.length > 0 ? composeChangeSet(parts) : undefined;
250
+ }
251
+
252
+ /** A policy verdict for one run, as the hold reads it. */
253
+ export interface OpWaveRunVerdict {
254
+ result: "passed" | "denied" | "held" | "error";
255
+ rules: string[];
256
+ holds: string[];
257
+ reason?: string;
258
+ }
259
+
260
+ /**
261
+ * Run the workspace's `ci.policy` at `base` over each run's part (#4545).
262
+ * Returns each run's verdict, or a line saying why no policy runs (the base
263
+ * names none). Throws when the policy at base cannot be read while the
264
+ * checkout names one, as the pull-request path does.
265
+ */
266
+ export async function opWavePolicyVerdicts(
267
+ at: { spec: Pick<OpWavesSpec, "name">; gate: string; env: string; base: string; head: string; cwd: string; exec?: GatePolicyExec },
268
+ parts: ReadonlyMap<string, ChangeSetPart>,
269
+ ): Promise<{ verdicts: Map<string, OpWaveRunVerdict>; source?: ResolvedGatePolicySource } | { note: string }> {
270
+ const { prLoopPolicyAt, runPrPolicy } = await import("../components/pr-policy");
271
+ const read = prLoopPolicyAt(at.cwd, at.base);
272
+ if (!read.settings) return { note: read.note ?? `holds.policy: the declaration at ${at.base.slice(0, 12)} names no ci.policy, so no policy runs` };
273
+ const verdicts = new Map<string, OpWaveRunVerdict>();
274
+ for (const [target, part] of parts) {
275
+ 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);
276
+ if (!verdict) continue;
277
+ const reason = verdict.result === "error" ? verdict.error : [...verdict.denials, ...verdict.holds].map((f) => f.message).filter(Boolean).join("; ") || undefined;
278
+ verdicts.set(target, { result: verdict.result, rules: verdict.rules, holds: [...new Set(verdict.holds.map((h) => h.rule))].sort(), ...(reason ? { reason } : {}) });
279
+ }
280
+ return { verdicts, ...(read.source ? { source: read.source } : {}) };
281
+ }
282
+
283
+ /** One run's estimate: the monthly change, or why there is none. */
284
+ export type OpWaveRunCost = { target: string; monthlyDelta: number; currency?: string } | { target: string; error: string };
285
+
286
+ /** The monthly change an estimate gives, in `format`. Throws when it gives none. */
287
+ export function readCostEstimate(format: OpWaveCostFormat, stdout: string): { monthlyDelta: number; currency?: string } {
288
+ const doc = JSON.parse(stdout) as Record<string, unknown>;
289
+ const num = (v: unknown): number | undefined => (typeof v === "number" && Number.isFinite(v) ? v : typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v)) ? Number(v) : undefined);
290
+ if (format === "chant") {
291
+ const delta = num(doc.monthlyDelta);
292
+ if (delta === undefined) throw new Error("the estimate has no monthlyDelta");
293
+ return { monthlyDelta: delta, ...(typeof doc.currency === "string" ? { currency: doc.currency } : {}) };
294
+ }
295
+ // infracost breakdown --format json: diffTotalMonthlyCost, else totalMonthlyCost less pastTotalMonthlyCost.
296
+ const diff = num(doc.diffTotalMonthlyCost);
297
+ const total = num(doc.totalMonthlyCost);
298
+ const past = num(doc.pastTotalMonthlyCost);
299
+ const delta = diff ?? (total !== undefined ? total - (past ?? 0) : undefined);
300
+ if (delta === undefined) throw new Error("the infracost document has no diffTotalMonthlyCost or totalMonthlyCost");
301
+ return { monthlyDelta: delta, ...(typeof doc.currency === "string" ? { currency: doc.currency } : {}) };
302
+ }
303
+
304
+ const defaultHoldExec: GatePolicyExec = (argv, cwd): GatePolicyRun => {
305
+ const r = spawnSync(argv[0]!, argv.slice(1), { cwd, encoding: "utf-8", maxBuffer: 64 * 1024 * 1024 });
306
+ return { status: r.error ? null : r.status, stdout: r.stdout ?? "", stderr: `${r.stderr ?? ""}${r.error ? r.error.message : ""}` };
307
+ };
308
+
309
+ /** The engine's plan document a capability's artifact names (`artifact.planJson`), when it names one that exists. */
310
+ export function planJsonOf(artifact: unknown, cwd: string): string | undefined {
311
+ const p = (artifact as { planJson?: unknown } | undefined)?.planJson;
312
+ if (typeof p !== "string" || p === "") return undefined;
313
+ const path = p.startsWith("/") ? p : join(cwd, p);
314
+ return existsSync(path) ? path : undefined;
315
+ }
316
+
317
+ /** Price each run that changes something (#4545). A run with no estimate says why. */
318
+ export function opWaveCosts(
319
+ hold: OpWaveCostHold,
320
+ runs: ReadonlyArray<{ target: string; plan: string; artifact?: unknown; empty: boolean }>,
321
+ cwd: string,
322
+ exec: GatePolicyExec = defaultHoldExec,
323
+ ): OpWaveRunCost[] {
324
+ const format = hold.format ?? "infracost";
325
+ const out: OpWaveRunCost[] = [];
326
+ for (const run of runs) {
327
+ if (run.empty) continue;
328
+ const planJson = planJsonOf(run.artifact, cwd);
329
+ if (hold.command.some((a) => a.includes("{planJson}")) && !planJson) {
330
+ out.push({ target: run.target, error: "its plan names no plan document to price" });
331
+ continue;
332
+ }
333
+ const argv = hold.command.map((a) => a.replaceAll("{target}", run.target).replaceAll("{plan}", run.plan).replaceAll("{planJson}", planJson ?? ""));
334
+ const r = exec(argv, cwd);
335
+ if (r.status !== 0) {
336
+ 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(" ")}` });
337
+ continue;
338
+ }
339
+ try {
340
+ out.push({ target: run.target, ...readCostEstimate(format, r.stdout) });
341
+ } catch (err) {
342
+ out.push({ target: run.target, error: `the estimate cannot be read: ${err instanceof Error ? err.message : String(err)}` });
343
+ }
344
+ }
345
+ return out;
346
+ }
347
+
348
+ /** What a wave's estimates come to: the sum, the digest member, and the hold line when it waits. */
349
+ export interface OpWaveCostVerdict {
350
+ monthlyDelta: number;
351
+ currency: string;
352
+ unestimated: string[];
353
+ member: WaveMember;
354
+ /** Set when the wave waits for it: over `approveAbove`, or a run with no estimate. */
355
+ hold?: string;
356
+ }
357
+
358
+ /** Sum a wave's estimates against `approveAbove` (#4545). */
359
+ export function opWaveCostVerdict(hold: OpWaveCostHold, costs: readonly OpWaveRunCost[]): OpWaveCostVerdict {
360
+ const priced = costs.filter((c): c is Extract<OpWaveRunCost, { monthlyDelta: number }> => "monthlyDelta" in c);
361
+ const unestimated = costs.filter((c) => "error" in c).map((c) => c.target).sort();
362
+ const monthlyDelta = Math.round(priced.reduce((sum, c) => sum + c.monthlyDelta, 0) * 100) / 100;
363
+ const currency = hold.currency ?? priced.find((c) => c.currency)?.currency ?? "USD";
364
+ const member: WaveMember = { member: OP_WAVE_COST_MEMBER, planDigest: computePlanDigest("op-wave-cost", { approveAbove: hold.approveAbove, currency, monthlyDelta, unestimated }) };
365
+ const signed = `${monthlyDelta >= 0 ? "+" : ""}${monthlyDelta.toFixed(2)} ${currency}`;
366
+ const reasons: string[] = [];
367
+ if (monthlyDelta > hold.approveAbove) reasons.push(`its monthly change of ${signed} is over holds.cost.approveAbove (${hold.approveAbove} ${currency})`);
368
+ if (unestimated.length > 0) reasons.push(`${unestimated.join(", ")} could not be priced`);
369
+ return { monthlyDelta, currency, unestimated, member, ...(reasons.length > 0 ? { hold: `cost: ${reasons.join(", and ")}` } : {}) };
370
+ }
@@ -0,0 +1,135 @@
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
+
23
+ import type { RunEventBody, RunEventSettleStatus } from "../run-event";
24
+ import type { RunEventSink } from "../run-event-stream";
25
+ import type { CapabilityTraceFacts, RunEventTrace } from "../otlp";
26
+ import type { OpRunRecordInput } from "./runtime";
27
+
28
+ /** How one target's apply settled, as the step says it. */
29
+ export type OpWaveTargetSettle = "ok" | "failed" | "skipped";
30
+
31
+ /** One job's stream: the emitter, and the trace built from it when the exporter is on. */
32
+ export class OpWaveRunEvents {
33
+ private readonly phases: string[] = [];
34
+ private readonly settled = new Set<string>();
35
+
36
+ constructor(
37
+ private readonly sink: RunEventSink,
38
+ readonly trace?: RunEventTrace,
39
+ ) {}
40
+
41
+ private emit(body: RunEventBody): void {
42
+ try {
43
+ this.sink(body);
44
+ } catch {
45
+ // A reader that fails never changes the job.
46
+ }
47
+ }
48
+
49
+ private phase(k: number): string {
50
+ const name = `wave-${k}`;
51
+ if (!this.phases.includes(name)) {
52
+ this.phases.push(name);
53
+ this.emit({ type: "phase-start", component: null, phase: name });
54
+ }
55
+ return name;
56
+ }
57
+
58
+ start(): void {
59
+ this.emit({ type: "run-start", waves: null });
60
+ }
61
+
62
+ /** A target's apply begins. */
63
+ stepStart(k: number, target: string): void {
64
+ const phase = this.phase(k);
65
+ this.emit({ type: "step-start", component: null, phase, step: target });
66
+ }
67
+
68
+ /** A target's apply ended, with its time and what its capability knew. */
69
+ stepSettle(k: number, target: string, status: OpWaveTargetSettle, durationMs: number | null, opts: { error?: string; message?: string; facts?: CapabilityTraceFacts } = {}): void {
70
+ const phase = this.phase(k);
71
+ this.settled.add(`${phase}\u0000${target}`);
72
+ if (opts.facts) this.trace?.annotate({ phase, step: target }, opts.facts);
73
+ this.emit({
74
+ type: "step-settle",
75
+ component: null,
76
+ phase,
77
+ step: target,
78
+ status,
79
+ ...(status === "skipped" ? { skip: null } : {}),
80
+ durationMs,
81
+ ...(opts.error !== undefined ? { error: opts.error } : {}),
82
+ ...(opts.message !== undefined ? { message: opts.message } : {}),
83
+ // #4615: what the engine reported per resource, when it reported anything.
84
+ ...(opts.facts?.resources?.length ? { resources: opts.facts.resources.map((r) => ({ ...r })) } : {}),
85
+ });
86
+ }
87
+
88
+ /**
89
+ * The job ended: settle what is still open from its run record, then the
90
+ * run. `moved` and `blocked` give the reason a skipped target says.
91
+ */
92
+ finish(record: OpRunRecordInput, why: { moved?: readonly string[]; blocked?: Readonly<Record<string, string>> } = {}): void {
93
+ const moved = new Set(why.moved ?? []);
94
+ const last = record.phases[record.phases.length - 1]?.name;
95
+ for (const p of record.phases) {
96
+ if (!this.phases.includes(p.name)) {
97
+ this.phases.push(p.name);
98
+ this.emit({ type: "phase-start", component: null, phase: p.name });
99
+ }
100
+ for (const step of p.steps) {
101
+ if (this.settled.has(`${p.name}\u0000${step.fn}`)) continue;
102
+ const status: OpWaveTargetSettle = step.status === "ok" ? "ok" : step.status === "fail" ? "failed" : "skipped";
103
+ const by = why.blocked?.[step.fn];
104
+ const message = moved.has(step.fn) ? "its plan moved since the wave was decided" : by !== undefined ? `blocked by ${by}` : undefined;
105
+ this.emit({
106
+ type: "step-settle",
107
+ component: null,
108
+ phase: p.name,
109
+ step: step.fn,
110
+ status,
111
+ ...(status === "skipped" ? { skip: moved.has(step.fn) ? "refused" : "not-run" } : {}),
112
+ durationMs: status === "skipped" ? null : step.durationMs,
113
+ ...(message ? { message } : {}),
114
+ });
115
+ }
116
+ let status: RunEventSettleStatus = p.status === "fail" ? "failed" : "ok";
117
+ if (p.name === last && (record.status === "gated" || record.status === "waiting")) {
118
+ const gate = record.gate;
119
+ const step = `gate:${gate?.name ?? record.point?.point ?? "point"}`;
120
+ this.emit({ type: "step-start", component: null, phase: p.name, step });
121
+ 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 });
122
+ this.emit({ type: "step-settle", component: null, phase: p.name, step, status: record.status, durationMs: null });
123
+ status = record.status;
124
+ }
125
+ this.emit({ type: "phase-settle", component: null, phase: p.name, status });
126
+ }
127
+ const runStatus: RunEventSettleStatus = record.status === "fail" ? "failed" : record.status;
128
+ this.emit({
129
+ type: "run-settle",
130
+ status: runStatus,
131
+ durationMs: Math.max(0, Date.parse(record.ended) - Date.parse(record.started)) || null,
132
+ ...(record.failure ? { failure: { ...record.failure } } : {}),
133
+ });
134
+ }
135
+ }
@@ -0,0 +1,149 @@
1
+ /**
2
+ * #4610: an op-wave job's notify takes its source, its summary words and
3
+ * its header prefix from the active product's words, and chant's own words
4
+ * send what they sent before.
5
+ */
6
+ import { afterEach, describe, expect, test } from "vitest";
7
+ import { assertProductWords, CHANT_WORDS, notifyWaveLabel, productWordsProblems, resolveProductWords, setActiveProductWords } from "../ci-product-words";
8
+ import { makeNotifyEvent, slackMessage, teamsMessage, verifyWebhook, type NotifyFetch, type NotifyFields } from "../notify";
9
+ import { driftNotifyFields, productSendOptions } from "../notify-product";
10
+ import type { OpWavesSpec } from "./op-waves";
11
+ import { notifyOpWave, opWaveNotifyFields, type OpWaveOutcome } from "./op-waves-notify";
12
+
13
+ const spec: OpWavesSpec = {
14
+ name: "pulumi-up",
15
+ op: "pulumi-up",
16
+ plan: ["tool", "plan", "{target}", "--out", "{plan}"],
17
+ apply: ["tool", "apply", "{target}", "--plan", "{plan}"],
18
+ waves: [{ name: "dev", runs: [{ target: "shop-dev" }], gate: "never" }, { name: "prod", runs: [{ target: "shop-prod" }, { target: "shop-eu" }] }],
19
+ notify: { webhook: "HOOK", key: "HOOK_KEY", slack: "SLACK" },
20
+ };
21
+ const env = { HOOK: "http://127.0.0.1:9/hook", HOOK_KEY: "k", SLACK: "http://127.0.0.1:9/slack" };
22
+ const digest = `sha256:${"d".repeat(64)}`;
23
+
24
+ const PLYWOOD = assertProductWords({
25
+ product: "plywood",
26
+ stages: { plan: "preview", apply: "up" },
27
+ verbs: { plan: ["preview", "previewed"], apply: ["update", "updated"] },
28
+ noun: ["stack", "stacks"],
29
+ approve: "plywood approve {gate} --plan {digest} {sign}",
30
+ op: "pulumi-up",
31
+ prGate: "up",
32
+ gateName: "wave-{k}",
33
+ });
34
+ const YODEL = assertProductWords({ product: "yodel", noun: ["environment", "environments"], notify: { source: "sql-yodeler" } });
35
+
36
+ const decision = {
37
+ wave: 2,
38
+ op: "pulumi-up",
39
+ gate: "wave-2",
40
+ policy: "always" as const,
41
+ approval: "ledger" as const,
42
+ policySource: "base" as const,
43
+ base: "b",
44
+ digest,
45
+ members: [{ member: "shop-prod" }, { member: "shop-eu" }],
46
+ status: "waiting" as const,
47
+ };
48
+
49
+ /** One outcome per event kind a wave job sends, and the drift event a product sends. */
50
+ const outcomes: Record<string, OpWaveOutcome> = {
51
+ waiting: { result: { exitCode: 3, decision, applied: [], failed: [], moved: [], hooks: [] } as never },
52
+ refused: { result: { exitCode: 4, applied: ["shop-prod"], failed: [], moved: ["shop-eu"], hooks: [] } as never },
53
+ held: { result: { exitCode: 5, decision, applied: [], failed: [], moved: [], hooks: [], outcome: { outcome: "held", holder: { run: "r9" } } } as never },
54
+ failed: { result: { exitCode: 1, applied: [], failed: ["shop-eu"], moved: [], hooks: [] } as never },
55
+ error: { error: "planning shop-dev exited 2" },
56
+ };
57
+
58
+ function recorder() {
59
+ const calls: Array<{ url: string; headers: Record<string, string>; body: string }> = [];
60
+ const fetch: NotifyFetch = async (url, init) => {
61
+ calls.push({ url, headers: init.headers, body: init.body });
62
+ return { ok: true, status: 200 };
63
+ };
64
+ return { calls, fetch };
65
+ }
66
+
67
+ afterEach(() => {
68
+ setActiveProductWords(undefined);
69
+ });
70
+
71
+ describe("notify words (#4610)", () => {
72
+ test("chant's own words send what chant sent before, for every event kind", () => {
73
+ const fields = (o: OpWaveOutcome, k = 2) => opWaveNotifyFields(spec, k, o, {}, CHANT_WORDS);
74
+ expect(fields(outcomes.waiting!)).toMatchObject({ source: "chant", summary: "wave 2 (prod) of pulumi-up waits for an approval" });
75
+ expect(fields(outcomes.waiting!)!.approve).not.toHaveProperty("chant");
76
+ expect(fields(outcomes.refused!)).toMatchObject({ source: "chant", summary: "wave 2 (prod) of pulumi-up refused 1 run whose plan moved since the wave was decided" });
77
+ expect(fields(outcomes.held!)).toMatchObject({ source: "chant", summary: "wave 2 (prod) of pulumi-up applied nothing: another run (r9) holds what it changes" });
78
+ expect(fields(outcomes.failed!)).toMatchObject({ source: "chant", summary: "wave 2 (prod) of pulumi-up failed: shop-eu did not apply", reason: "the apply command failed for shop-eu" });
79
+ expect(fields(outcomes.error!, 1)).toMatchObject({ source: "chant", summary: "wave 1 (dev) of pulumi-up failed" });
80
+ // The default argument is the active words, chant's unless a bin set them.
81
+ expect(opWaveNotifyFields(spec, 2, outcomes.failed!)).toEqual(fields(outcomes.failed!));
82
+ });
83
+
84
+ test("a product's words set the source and the summary's verbs for every event kind", () => {
85
+ const fields = (o: OpWaveOutcome, k = 2) => opWaveNotifyFields(spec, k, o, {}, PLYWOOD);
86
+ expect(fields(outcomes.waiting!)).toMatchObject({ source: "plywood", summary: "wave 2 (prod) of pulumi-up waits for an approval", approve: { chant: `chant approve pulumi-up wave-2 --plan ${digest}` } });
87
+ expect(fields(outcomes.refused!)).toMatchObject({ source: "plywood", event: "refused" });
88
+ expect(fields(outcomes.held!)).toMatchObject({ source: "plywood", summary: "wave 2 (prod) of pulumi-up updated nothing: another run (r9) holds what it changes" });
89
+ expect(fields(outcomes.failed!)).toMatchObject({ source: "plywood", summary: "wave 2 (prod) of pulumi-up failed: shop-eu did not update", reason: "the update command failed for shop-eu" });
90
+ expect(fields(outcomes.error!, 1)).toMatchObject({ source: "plywood", event: "failed", summary: "wave 1 (dev) of pulumi-up failed" });
91
+ expect(driftNotifyFields(PLYWOOD, { changed: ["shop-dev", "shop-prod"], fingerprint: "fp" })).toMatchObject({
92
+ source: "plywood",
93
+ event: "drift",
94
+ summary: "2 stacks drifted: shop-dev, shop-prod",
95
+ drift: { changed: ["shop-dev", "shop-prod"], fingerprint: "fp" },
96
+ });
97
+ expect(driftNotifyFields(CHANT_WORDS, { changed: ["net"], failed: ["db"] }).summary).toBe("1 member drifted: net; 1 member could not be refreshed: db");
98
+ });
99
+
100
+ test("sql-yodeler's words keep source sql-yodeler while its product word is yodel", () => {
101
+ expect(YODEL.notify).toEqual({ source: "sql-yodeler", wave: "wave {k} ({name}) of {spec}", headers: "x-yodel" });
102
+ expect(opWaveNotifyFields(spec, 2, outcomes.failed!, {}, YODEL)).toMatchObject({ source: "sql-yodeler" });
103
+ expect(driftNotifyFields(YODEL, { changed: ["prod"] })).toMatchObject({ source: "sql-yodeler", summary: "1 environment drifted: prod" });
104
+ });
105
+
106
+ test("the wave label is a template, and a wave with no name drops its part", () => {
107
+ const words = resolveProductWords({ product: "yodel", notify: { wave: "{product} wave {k} ({name}) of {spec}" } });
108
+ expect(notifyWaveLabel(words, { k: 1, name: "dev", spec: "migrate" })).toBe("yodel wave 1 (dev) of migrate");
109
+ expect(notifyWaveLabel(words, { k: 2, spec: "migrate" })).toBe("yodel wave 2 of migrate");
110
+ expect(notifyWaveLabel(CHANT_WORDS, { k: 2, spec: "tf-apply" })).toBe("wave 2 of tf-apply");
111
+ });
112
+
113
+ test("notify words that a receiver could not route or verify on are refused", () => {
114
+ const problems = productWordsProblems(resolveProductWords({ notify: { source: "SQL Yodeler", headers: "yodel", wave: "wave {n}\n" } }));
115
+ expect(problems.some((p) => /notify.source is "SQL Yodeler"/.test(p))).toBe(true);
116
+ expect(problems.some((p) => /notify.headers is "yodel"/.test(p))).toBe(true);
117
+ expect(problems.some((p) => /notify.wave names \{n\}/.test(p))).toBe(true);
118
+ expect(problems.some((p) => /notify.wave needs \{k\}/.test(p))).toBe(true);
119
+ expect(problems.some((p) => /notify.wave is one line/.test(p))).toBe(true);
120
+ });
121
+
122
+ test("a wave job under a product's bin signs with the product's headers, and Slack shows the same summary", async () => {
123
+ setActiveProductWords(PLYWOOD);
124
+ const { calls, fetch } = recorder();
125
+ const out = await notifyOpWave(spec, 2, outcomes.waiting!, {}, { env, fetch, sleep: async () => {}, log: () => {} });
126
+ expect(out.map((d) => d.ok)).toEqual([true, true]);
127
+ const hook = calls[0]!;
128
+ expect(hook.headers["x-plywood-signature"]).toMatch(/^sha256=/);
129
+ expect(hook.headers["user-agent"]).toBe("plywood");
130
+ expect(verifyWebhook({ body: hook.body, headers: hook.headers, key: "k", prefix: "x-plywood" }).ok).toBe(true);
131
+ const event = JSON.parse(hook.body);
132
+ expect(event).toMatchObject({ schema: "chant.notify/v1", source: "plywood", summary: "wave 2 (prod) of pulumi-up waits for an approval" });
133
+ expect(event.approve.command).toBe(`plywood approve wave-2 --plan ${digest}`);
134
+ expect(JSON.parse(calls[1]!.body).text.split("\n")[0]).toBe("*plywood: wave 2 (prod) of pulumi-up waits for an approval*");
135
+ });
136
+
137
+ test("chant's words keep x-chant, and a caller's own prefix wins", () => {
138
+ expect(productSendOptions(CHANT_WORDS, { env })).toEqual({ env });
139
+ expect(productSendOptions(PLYWOOD).prefix).toBe("x-plywood");
140
+ expect(productSendOptions(PLYWOOD, { prefix: "x-own" }).prefix).toBe("x-own");
141
+ });
142
+
143
+ test("Slack and Teams show the drift summary under the product's source", () => {
144
+ const fields: NotifyFields = driftNotifyFields(PLYWOOD, { changed: ["shop-dev"], project: "acme/shop" });
145
+ const event = makeNotifyEvent(fields, { env: {}, now: new Date(0) });
146
+ expect(slackMessage(event).text.split("\n")[0]).toBe("*plywood: 1 stack drifted: shop-dev*");
147
+ expect(JSON.stringify(teamsMessage(event))).toContain("plywood: 1 stack drifted: shop-dev");
148
+ });
149
+ });