@intentius/chant 0.124.54 → 0.124.55

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (894) hide show
  1. package/dist/__fixtures__/estate-ledger.d.ts +13 -0
  2. package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
  3. package/dist/__fixtures__/estate-ledger.js +67 -0
  4. package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
  5. package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
  6. package/dist/__fixtures__/oidc-emulator.js +26 -2
  7. package/dist/__fixtures__/product-words.d.ts +78 -0
  8. package/dist/__fixtures__/product-words.d.ts.map +1 -0
  9. package/dist/__fixtures__/product-words.js +43 -0
  10. package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  11. package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  12. package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  13. package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  14. package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  15. package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  16. package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
  17. package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
  18. package/dist/__golden__/wave-loop/op-held-on.json +28 -7
  19. package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  20. package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  21. package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  22. package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
  23. package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  24. package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
  25. package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
  26. package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
  27. package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  28. package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  29. package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
  30. package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  31. package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  32. package/dist/__golden__/wave-loop/op-overridden.json +28 -7
  33. package/dist/__golden__/wave-loop/op-per-run.json +20 -4
  34. package/dist/__golden__/wave-loop/op-point.json +18 -4
  35. package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
  36. package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
  37. package/dist/__golden__/wave-loop/op-spend.json +10 -2
  38. package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
  39. package/dist/__golden__/wave-loop/op-wide.json +20 -4
  40. package/dist/bucket-check/azure.d.ts +108 -0
  41. package/dist/bucket-check/azure.d.ts.map +1 -0
  42. package/dist/bucket-check/azure.js +258 -0
  43. package/dist/bucket-check/fixtures/azure.json +153 -0
  44. package/dist/bucket-check/fixtures/gcs.json +148 -0
  45. package/dist/bucket-check/fixtures/s3.json +277 -0
  46. package/dist/bucket-check/gcs.d.ts +77 -0
  47. package/dist/bucket-check/gcs.d.ts.map +1 -0
  48. package/dist/bucket-check/gcs.js +202 -0
  49. package/dist/bucket-check/index.d.ts +48 -0
  50. package/dist/bucket-check/index.d.ts.map +1 -0
  51. package/dist/bucket-check/index.js +44 -0
  52. package/dist/bucket-check/s3.d.ts +116 -0
  53. package/dist/bucket-check/s3.d.ts.map +1 -0
  54. package/dist/bucket-check/s3.js +362 -0
  55. package/dist/bucket-check/types.d.ts +66 -0
  56. package/dist/bucket-check/types.d.ts.map +1 -0
  57. package/dist/bucket-check/types.js +31 -0
  58. package/dist/bucket-check/wire.d.ts +27 -0
  59. package/dist/bucket-check/wire.d.ts.map +1 -0
  60. package/dist/bucket-check/wire.js +32 -0
  61. package/dist/bucket-check.d.ts +6 -0
  62. package/dist/bucket-check.d.ts.map +1 -0
  63. package/dist/bucket-check.js +5 -0
  64. package/dist/capabilities/templates.d.ts.map +1 -1
  65. package/dist/capabilities/templates.js +1 -2
  66. package/dist/change-set.d.ts.map +1 -1
  67. package/dist/change-set.js +2 -3
  68. package/dist/ci-agent.d.ts +381 -0
  69. package/dist/ci-agent.d.ts.map +1 -0
  70. package/dist/ci-agent.js +833 -0
  71. package/dist/ci-control.d.ts +42 -0
  72. package/dist/ci-control.d.ts.map +1 -0
  73. package/dist/ci-control.js +42 -0
  74. package/dist/ci-estate/delivery.d.ts +137 -0
  75. package/dist/ci-estate/delivery.d.ts.map +1 -0
  76. package/dist/ci-estate/delivery.js +311 -0
  77. package/dist/ci-estate/overdue.d.ts +34 -0
  78. package/dist/ci-estate/overdue.d.ts.map +1 -0
  79. package/dist/ci-estate/overdue.js +58 -0
  80. package/dist/ci-estate/page.d.ts +134 -0
  81. package/dist/ci-estate/page.d.ts.map +1 -0
  82. package/dist/ci-estate/page.js +233 -0
  83. package/dist/ci-estate/rows.d.ts +118 -0
  84. package/dist/ci-estate/rows.d.ts.map +1 -0
  85. package/dist/ci-estate/rows.js +126 -0
  86. package/dist/ci-estate.d.ts +68 -0
  87. package/dist/ci-estate.d.ts.map +1 -0
  88. package/dist/ci-estate.js +83 -0
  89. package/dist/ci-handover.d.ts +29 -5
  90. package/dist/ci-handover.d.ts.map +1 -1
  91. package/dist/ci-handover.js +50 -16
  92. package/dist/ci-identity.d.ts +82 -7
  93. package/dist/ci-identity.d.ts.map +1 -1
  94. package/dist/ci-identity.js +87 -15
  95. package/dist/ci-product-words.d.ts +290 -0
  96. package/dist/ci-product-words.d.ts.map +1 -0
  97. package/dist/ci-product-words.js +373 -0
  98. package/dist/ci-product.d.ts +82 -0
  99. package/dist/ci-product.d.ts.map +1 -0
  100. package/dist/ci-product.js +78 -0
  101. package/dist/cli/commands/audit.d.ts +2 -2
  102. package/dist/cli/commands/audit.d.ts.map +1 -1
  103. package/dist/cli/commands/audit.js +3 -2
  104. package/dist/cli/commands/carve.js +2 -2
  105. package/dist/cli/commands/init.d.ts +2 -0
  106. package/dist/cli/commands/init.d.ts.map +1 -1
  107. package/dist/cli/commands/init.js +1 -1
  108. package/dist/cli/handlers/agent.d.ts +17 -0
  109. package/dist/cli/handlers/agent.d.ts.map +1 -0
  110. package/dist/cli/handlers/agent.js +114 -0
  111. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  112. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  113. package/dist/cli/handlers/approve-confirm.js +142 -0
  114. package/dist/cli/handlers/approve.d.ts.map +1 -1
  115. package/dist/cli/handlers/approve.js +19 -1
  116. package/dist/cli/handlers/build.d.ts.map +1 -1
  117. package/dist/cli/handlers/build.js +43 -1
  118. package/dist/cli/handlers/ci-check.d.ts +3 -0
  119. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  120. package/dist/cli/handlers/ci-check.js +34 -0
  121. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  122. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  123. package/dist/cli/handlers/ci-forge-check.js +89 -0
  124. package/dist/cli/handlers/fan-out.js +4 -0
  125. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  126. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  127. package/dist/cli/handlers/gate-pending.js +44 -0
  128. package/dist/cli/handlers/init.d.ts.map +1 -1
  129. package/dist/cli/handlers/init.js +1 -0
  130. package/dist/cli/handlers/ledger.js +1 -1
  131. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  132. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  133. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  134. package/dist/cli/handlers/lock.d.ts.map +1 -1
  135. package/dist/cli/handlers/lock.js +64 -5
  136. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  137. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  138. package/dist/cli/handlers/notify-relay.js +130 -0
  139. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  140. package/dist/cli/handlers/pr-env.js +42 -11
  141. package/dist/cli/handlers/pr.d.ts +38 -3
  142. package/dist/cli/handlers/pr.d.ts.map +1 -1
  143. package/dist/cli/handlers/pr.js +653 -205
  144. package/dist/cli/handlers/promote.d.ts.map +1 -1
  145. package/dist/cli/handlers/promote.js +21 -2
  146. package/dist/cli/handlers/release.d.ts.map +1 -1
  147. package/dist/cli/handlers/release.js +3 -0
  148. package/dist/cli/handlers/run-wave.d.ts +8 -0
  149. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  150. package/dist/cli/handlers/run-wave.js +71 -1
  151. package/dist/cli/handlers/run.d.ts +6 -1
  152. package/dist/cli/handlers/run.d.ts.map +1 -1
  153. package/dist/cli/handlers/run.js +86 -1
  154. package/dist/cli/handlers/serve.d.ts.map +1 -1
  155. package/dist/cli/handlers/serve.js +10 -1
  156. package/dist/cli/main.d.ts +11 -1
  157. package/dist/cli/main.d.ts.map +1 -1
  158. package/dist/cli/main.js +124 -13
  159. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  160. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  161. package/dist/cli/mcp/ledger-tools.js +122 -0
  162. package/dist/cli/mcp/product-tools.d.ts +78 -0
  163. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  164. package/dist/cli/mcp/product-tools.js +93 -0
  165. package/dist/cli/mcp/read-only.d.ts +34 -0
  166. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  167. package/dist/cli/mcp/read-only.js +61 -0
  168. package/dist/cli/mcp/report-tools.d.ts +48 -0
  169. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  170. package/dist/cli/mcp/report-tools.js +128 -0
  171. package/dist/cli/mcp/server.d.ts +28 -1
  172. package/dist/cli/mcp/server.d.ts.map +1 -1
  173. package/dist/cli/mcp/server.js +86 -15
  174. package/dist/cli/mcp-config.d.ts +9 -2
  175. package/dist/cli/mcp-config.d.ts.map +1 -1
  176. package/dist/cli/mcp-config.js +8 -3
  177. package/dist/cli/parse-args.d.ts.map +1 -1
  178. package/dist/cli/parse-args.js +57 -3
  179. package/dist/cli/registry.d.ts +35 -0
  180. package/dist/cli/registry.d.ts.map +1 -1
  181. package/dist/cloud-lister/sigv4.d.ts +42 -7
  182. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  183. package/dist/cloud-lister/sigv4.js +72 -22
  184. package/dist/components/adoption.d.ts +69 -0
  185. package/dist/components/adoption.d.ts.map +1 -0
  186. package/dist/components/adoption.js +93 -0
  187. package/dist/components/apply-lease.d.ts +19 -0
  188. package/dist/components/apply-lease.d.ts.map +1 -0
  189. package/dist/components/apply-lease.js +41 -0
  190. package/dist/components/capability.d.ts +122 -5
  191. package/dist/components/capability.d.ts.map +1 -1
  192. package/dist/components/capability.js +14 -6
  193. package/dist/components/check-hooks.d.ts +113 -0
  194. package/dist/components/check-hooks.d.ts.map +1 -0
  195. package/dist/components/check-hooks.js +192 -0
  196. package/dist/components/ci-services.d.ts +57 -0
  197. package/dist/components/ci-services.d.ts.map +1 -0
  198. package/dist/components/ci-services.js +61 -0
  199. package/dist/components/cli-support.d.ts +13 -0
  200. package/dist/components/cli-support.d.ts.map +1 -1
  201. package/dist/components/cli-support.js +10 -2
  202. package/dist/components/driver.d.ts +20 -3
  203. package/dist/components/driver.d.ts.map +1 -1
  204. package/dist/components/driver.js +24 -4
  205. package/dist/components/fan-out-run.d.ts +12 -0
  206. package/dist/components/fan-out-run.d.ts.map +1 -1
  207. package/dist/components/fan-out-run.js +56 -16
  208. package/dist/components/groups.d.ts.map +1 -1
  209. package/dist/components/groups.js +19 -2
  210. package/dist/components/pr-env-ledger.d.ts +32 -0
  211. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  212. package/dist/components/pr-env-ledger.js +39 -0
  213. package/dist/components/pr-env-ports.d.ts +12 -0
  214. package/dist/components/pr-env-ports.d.ts.map +1 -1
  215. package/dist/components/pr-env-ports.js +13 -3
  216. package/dist/components/pr-env-run.d.ts +6 -0
  217. package/dist/components/pr-env-run.d.ts.map +1 -1
  218. package/dist/components/pr-env-run.js +3 -2
  219. package/dist/components/pr-environment.d.ts +31 -3
  220. package/dist/components/pr-environment.d.ts.map +1 -1
  221. package/dist/components/pr-environment.js +25 -7
  222. package/dist/components/pr-pipeline.d.ts +169 -3
  223. package/dist/components/pr-pipeline.d.ts.map +1 -1
  224. package/dist/components/pr-pipeline.js +184 -9
  225. package/dist/components/pr-policy.d.ts +26 -2
  226. package/dist/components/pr-policy.d.ts.map +1 -1
  227. package/dist/components/pr-policy.js +41 -7
  228. package/dist/components/pr-run.d.ts +63 -0
  229. package/dist/components/pr-run.d.ts.map +1 -1
  230. package/dist/components/pr-run.js +82 -3
  231. package/dist/components/pr-targets.d.ts +24 -0
  232. package/dist/components/pr-targets.d.ts.map +1 -0
  233. package/dist/components/pr-targets.js +48 -0
  234. package/dist/components/product-pipeline.d.ts +217 -0
  235. package/dist/components/product-pipeline.d.ts.map +1 -0
  236. package/dist/components/product-pipeline.js +193 -0
  237. package/dist/components/promote.d.ts +6 -0
  238. package/dist/components/promote.d.ts.map +1 -1
  239. package/dist/components/promote.js +4 -1
  240. package/dist/components/release-compile.d.ts +22 -1
  241. package/dist/components/release-compile.d.ts.map +1 -1
  242. package/dist/components/release-compile.js +85 -0
  243. package/dist/components/release-promote.d.ts +15 -1
  244. package/dist/components/release-promote.d.ts.map +1 -1
  245. package/dist/components/release-promote.js +67 -2
  246. package/dist/components/repo-lock.d.ts +27 -0
  247. package/dist/components/repo-lock.d.ts.map +1 -0
  248. package/dist/components/repo-lock.js +49 -0
  249. package/dist/components/row-lease.d.ts +84 -0
  250. package/dist/components/row-lease.d.ts.map +1 -0
  251. package/dist/components/row-lease.js +110 -0
  252. package/dist/components/wave-plan.d.ts +34 -0
  253. package/dist/components/wave-plan.d.ts.map +1 -1
  254. package/dist/components/wave-plan.js +54 -2
  255. package/dist/control/applied.d.ts +89 -0
  256. package/dist/control/applied.d.ts.map +1 -0
  257. package/dist/control/applied.js +175 -0
  258. package/dist/control/consumers.d.ts +78 -0
  259. package/dist/control/consumers.d.ts.map +1 -0
  260. package/dist/control/consumers.js +172 -0
  261. package/dist/control/dispatch.d.ts +334 -0
  262. package/dist/control/dispatch.d.ts.map +1 -0
  263. package/dist/control/dispatch.js +519 -0
  264. package/dist/control/edges.d.ts +75 -0
  265. package/dist/control/edges.d.ts.map +1 -0
  266. package/dist/control/edges.js +133 -0
  267. package/dist/control/reconcile.d.ts +120 -0
  268. package/dist/control/reconcile.d.ts.map +1 -0
  269. package/dist/control/reconcile.js +178 -0
  270. package/dist/control/records.d.ts +187 -0
  271. package/dist/control/records.d.ts.map +1 -0
  272. package/dist/control/records.js +307 -0
  273. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  274. package/dist/discovery/sandbox/bundle.js +25 -1
  275. package/dist/engine-facts.d.ts.map +1 -1
  276. package/dist/engine-facts.js +1 -2
  277. package/dist/exit-codes.d.ts +48 -0
  278. package/dist/exit-codes.d.ts.map +1 -0
  279. package/dist/exit-codes.js +49 -0
  280. package/dist/forge-check/check.d.ts +63 -0
  281. package/dist/forge-check/check.d.ts.map +1 -0
  282. package/dist/forge-check/check.js +139 -0
  283. package/dist/forge-check/contract.d.ts +152 -0
  284. package/dist/forge-check/contract.d.ts.map +1 -0
  285. package/dist/forge-check/contract.js +118 -0
  286. package/dist/forge-check/forge.d.ts +42 -0
  287. package/dist/forge-check/forge.d.ts.map +1 -0
  288. package/dist/forge-check/forge.js +338 -0
  289. package/dist/forge-check/index.d.ts +24 -0
  290. package/dist/forge-check/index.d.ts.map +1 -0
  291. package/dist/forge-check/index.js +23 -0
  292. package/dist/forge-check/pulumi.d.ts +44 -0
  293. package/dist/forge-check/pulumi.d.ts.map +1 -0
  294. package/dist/forge-check/pulumi.js +184 -0
  295. package/dist/forge-check/read-only.d.ts +26 -0
  296. package/dist/forge-check/read-only.d.ts.map +1 -0
  297. package/dist/forge-check/read-only.js +53 -0
  298. package/dist/forge-check/trust.d.ts +94 -0
  299. package/dist/forge-check/trust.d.ts.map +1 -0
  300. package/dist/forge-check/trust.js +532 -0
  301. package/dist/forge-check/types.d.ts +80 -0
  302. package/dist/forge-check/types.d.ts.map +1 -0
  303. package/dist/forge-check/types.js +18 -0
  304. package/dist/forge-check.d.ts +6 -0
  305. package/dist/forge-check.d.ts.map +1 -0
  306. package/dist/forge-check.js +5 -0
  307. package/dist/gate-decision.d.ts +1 -0
  308. package/dist/gate-decision.d.ts.map +1 -1
  309. package/dist/gate-decision.js +2 -0
  310. package/dist/gate-policy.d.ts +47 -1
  311. package/dist/gate-policy.d.ts.map +1 -1
  312. package/dist/gate-policy.js +50 -2
  313. package/dist/index.d.ts +1 -0
  314. package/dist/index.d.ts.map +1 -1
  315. package/dist/index.js +2 -0
  316. package/dist/lexicon.d.ts +106 -6
  317. package/dist/lexicon.d.ts.map +1 -1
  318. package/dist/lifecycle/adoption-file.d.ts +24 -0
  319. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  320. package/dist/lifecycle/adoption-file.js +1 -2
  321. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  322. package/dist/lifecycle/cloud-index.js +1 -2
  323. package/dist/lifecycle/gate-applied.d.ts +6 -0
  324. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  325. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  326. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  327. package/dist/lifecycle/gate-ledger.js +11 -1
  328. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  329. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  330. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  331. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  332. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  333. package/dist/lifecycle/gated-request-digest.js +35 -0
  334. package/dist/lifecycle/gated-request.d.ts +126 -0
  335. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  336. package/dist/lifecycle/gated-request.js +205 -0
  337. package/dist/lifecycle/identity-match.d.ts +15 -0
  338. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  339. package/dist/lifecycle/identity-match.js +11 -6
  340. package/dist/lifecycle/index-diff.d.ts +40 -0
  341. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  342. package/dist/lifecycle/index-diff.js +1 -2
  343. package/dist/lifecycle/index-document.d.ts.map +1 -1
  344. package/dist/lifecycle/index-document.js +1 -2
  345. package/dist/lifecycle/index-import.d.ts +4 -1
  346. package/dist/lifecycle/index-import.d.ts.map +1 -1
  347. package/dist/lifecycle/index-import.js +29 -32
  348. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  349. package/dist/lifecycle/ledger-read.js +7 -3
  350. package/dist/lifecycle/lock-rows.d.ts +76 -0
  351. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  352. package/dist/lifecycle/lock-rows.js +140 -0
  353. package/dist/lifecycle/query.d.ts +50 -3
  354. package/dist/lifecycle/query.d.ts.map +1 -1
  355. package/dist/lifecycle/query.js +97 -6
  356. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  357. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  358. package/dist/lifecycle/release-catalog-site.js +232 -0
  359. package/dist/lifecycle/release-catalog.d.ts +201 -0
  360. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  361. package/dist/lifecycle/release-catalog.js +198 -0
  362. package/dist/lifecycle/release-changelog.d.ts +41 -0
  363. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  364. package/dist/lifecycle/release-changelog.js +38 -0
  365. package/dist/lifecycle/release-cut.d.ts +1 -0
  366. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  367. package/dist/lifecycle/release-cut.js +1 -1
  368. package/dist/lifecycle/release-ledger.d.ts +16 -0
  369. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  370. package/dist/lifecycle/release-ledger.js +10 -0
  371. package/dist/lifecycle/release-publish.d.ts +43 -22
  372. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  373. package/dist/lifecycle/release-read.d.ts.map +1 -1
  374. package/dist/lifecycle/release-read.js +3 -0
  375. package/dist/lifecycle/release-status.d.ts +86 -0
  376. package/dist/lifecycle/release-status.d.ts.map +1 -0
  377. package/dist/lifecycle/release-status.js +136 -0
  378. package/dist/lifecycle/resource-lock.d.ts +120 -0
  379. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  380. package/dist/lifecycle/resource-lock.js +317 -0
  381. package/dist/lifecycle/retention.d.ts.map +1 -1
  382. package/dist/lifecycle/retention.js +3 -0
  383. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  384. package/dist/lifecycle/run-ledger.js +9 -1
  385. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  386. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  387. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  388. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  389. package/dist/lifecycle/snapshot-store.js +1 -2
  390. package/dist/lifecycle/target-lock.d.ts +15 -0
  391. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  392. package/dist/lifecycle/target-lock.js +25 -10
  393. package/dist/mcp/types.d.ts +7 -0
  394. package/dist/mcp/types.d.ts.map +1 -1
  395. package/dist/notify-product.d.ts +43 -0
  396. package/dist/notify-product.d.ts.map +1 -0
  397. package/dist/notify-product.js +58 -0
  398. package/dist/notify-relay.d.ts +197 -0
  399. package/dist/notify-relay.d.ts.map +1 -0
  400. package/dist/notify-relay.js +321 -0
  401. package/dist/notify.d.ts +44 -4
  402. package/dist/notify.d.ts.map +1 -1
  403. package/dist/notify.js +77 -14
  404. package/dist/object-store/azure-blob.d.ts +129 -0
  405. package/dist/object-store/azure-blob.d.ts.map +1 -0
  406. package/dist/object-store/azure-blob.js +341 -0
  407. package/dist/object-store/common.d.ts +108 -0
  408. package/dist/object-store/common.d.ts.map +1 -0
  409. package/dist/object-store/common.js +80 -0
  410. package/dist/object-store/errors.d.ts +28 -0
  411. package/dist/object-store/errors.d.ts.map +1 -0
  412. package/dist/object-store/errors.js +21 -0
  413. package/dist/object-store/from-env.d.ts +18 -0
  414. package/dist/object-store/from-env.d.ts.map +1 -0
  415. package/dist/object-store/from-env.js +22 -0
  416. package/dist/object-store/gcs.d.ts +106 -0
  417. package/dist/object-store/gcs.d.ts.map +1 -0
  418. package/dist/object-store/gcs.js +393 -0
  419. package/dist/object-store/index.d.ts +9 -0
  420. package/dist/object-store/index.d.ts.map +1 -0
  421. package/dist/object-store/index.js +8 -0
  422. package/dist/object-store/s3.d.ts +146 -0
  423. package/dist/object-store/s3.d.ts.map +1 -0
  424. package/dist/object-store/s3.js +306 -0
  425. package/dist/op/activities/converge.d.ts.map +1 -1
  426. package/dist/op/activities/converge.js +2 -1
  427. package/dist/op/activities/index.d.ts +1 -1
  428. package/dist/op/activities/index.d.ts.map +1 -1
  429. package/dist/op/activities/index.js +1 -1
  430. package/dist/op/activities/review-agent.d.ts +55 -2
  431. package/dist/op/activities/review-agent.d.ts.map +1 -1
  432. package/dist/op/activities/review-agent.js +65 -5
  433. package/dist/op/gate.d.ts +29 -1
  434. package/dist/op/gate.d.ts.map +1 -1
  435. package/dist/op/gate.js +59 -23
  436. package/dist/op/generate-pipeline.d.ts.map +1 -1
  437. package/dist/op/generate-pipeline.js +7 -1
  438. package/dist/op/index.d.ts +12 -1
  439. package/dist/op/index.d.ts.map +1 -1
  440. package/dist/op/index.js +7 -1
  441. package/dist/op/op-waves-after-plan.d.ts +137 -0
  442. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  443. package/dist/op/op-waves-after-plan.js +163 -0
  444. package/dist/op/op-waves-capability-spec.d.ts +55 -0
  445. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  446. package/dist/op/op-waves-capability-spec.js +94 -0
  447. package/dist/op/op-waves-capability.d.ts +197 -0
  448. package/dist/op/op-waves-capability.d.ts.map +1 -0
  449. package/dist/op/op-waves-capability.js +311 -0
  450. package/dist/op/op-waves-events.d.ts +54 -0
  451. package/dist/op/op-waves-events.d.ts.map +1 -0
  452. package/dist/op/op-waves-events.js +122 -0
  453. package/dist/op/op-waves-notify.d.ts +7 -1
  454. package/dist/op/op-waves-notify.d.ts.map +1 -1
  455. package/dist/op/op-waves-notify.js +35 -16
  456. package/dist/op/op-waves-release-port.d.ts +18 -0
  457. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  458. package/dist/op/op-waves-release-port.js +61 -0
  459. package/dist/op/op-waves-release.d.ts +92 -0
  460. package/dist/op/op-waves-release.d.ts.map +1 -0
  461. package/dist/op/op-waves-release.js +97 -0
  462. package/dist/op/op-waves-run.d.ts +175 -4
  463. package/dist/op/op-waves-run.d.ts.map +1 -1
  464. package/dist/op/op-waves-run.js +981 -41
  465. package/dist/op/op-waves-stand-down.d.ts +60 -0
  466. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  467. package/dist/op/op-waves-stand-down.js +97 -0
  468. package/dist/op/op-waves.d.ts +152 -8
  469. package/dist/op/op-waves.d.ts.map +1 -1
  470. package/dist/op/op-waves.js +161 -17
  471. package/dist/op/runtime.d.ts +91 -0
  472. package/dist/op/runtime.d.ts.map +1 -1
  473. package/dist/op/runtime.js +19 -0
  474. package/dist/op/stage-hooks.d.ts +45 -7
  475. package/dist/op/stage-hooks.d.ts.map +1 -1
  476. package/dist/op/stage-hooks.js +61 -3
  477. package/dist/op/steward-beside.d.ts.map +1 -1
  478. package/dist/op/steward-beside.js +2 -1
  479. package/dist/op/types.d.ts +2 -2
  480. package/dist/op/types.d.ts.map +1 -1
  481. package/dist/op/types.js +3 -2
  482. package/dist/otlp-metrics.d.ts +38 -0
  483. package/dist/otlp-metrics.d.ts.map +1 -0
  484. package/dist/otlp-metrics.js +82 -0
  485. package/dist/otlp.d.ts +249 -0
  486. package/dist/otlp.d.ts.map +1 -0
  487. package/dist/otlp.js +426 -0
  488. package/dist/override-gate.d.ts.map +1 -1
  489. package/dist/override-gate.js +5 -0
  490. package/dist/policy-packs.d.ts +69 -0
  491. package/dist/policy-packs.d.ts.map +1 -0
  492. package/dist/policy-packs.js +205 -0
  493. package/dist/policy-source.d.ts +51 -0
  494. package/dist/policy-source.d.ts.map +1 -0
  495. package/dist/policy-source.js +103 -0
  496. package/dist/pr-forge.d.ts +40 -0
  497. package/dist/pr-forge.d.ts.map +1 -1
  498. package/dist/pr-forge.js +92 -0
  499. package/dist/pr-loop.d.ts +149 -11
  500. package/dist/pr-loop.d.ts.map +1 -1
  501. package/dist/pr-loop.js +283 -44
  502. package/dist/pr-post.d.ts +16 -0
  503. package/dist/pr-post.d.ts.map +1 -1
  504. package/dist/pr-post.js +26 -1
  505. package/dist/pr-report-url.d.ts +32 -4
  506. package/dist/pr-report-url.d.ts.map +1 -1
  507. package/dist/pr-report-url.js +46 -5
  508. package/dist/pr-requires.d.ts +13 -2
  509. package/dist/pr-requires.d.ts.map +1 -1
  510. package/dist/pr-requires.js +14 -0
  511. package/dist/release-floors.d.ts +1 -1
  512. package/dist/release-floors.js +1 -1
  513. package/dist/run-event.d.ts +26 -1
  514. package/dist/run-event.d.ts.map +1 -1
  515. package/dist/run-event.js +4 -1
  516. package/dist/sorted-json.d.ts +10 -0
  517. package/dist/sorted-json.d.ts.map +1 -0
  518. package/dist/sorted-json.js +14 -0
  519. package/dist/terraform/credentials.d.ts +59 -0
  520. package/dist/terraform/credentials.d.ts.map +1 -0
  521. package/dist/terraform/credentials.js +149 -0
  522. package/dist/utils.d.ts +1 -4
  523. package/dist/utils.d.ts.map +1 -1
  524. package/dist/utils.js +1 -9
  525. package/dist/wave-runtime.d.ts +1 -1
  526. package/dist/wave-runtime.js +2 -2
  527. package/dist/wave-runtime.mjs +390 -285
  528. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  529. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  530. package/dist/workspace/ci-lock-grain.d.ts +12 -0
  531. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  532. package/dist/workspace/ci-lock-grain.js +27 -0
  533. package/dist/workspace/ci-run.d.ts +2 -1
  534. package/dist/workspace/ci-run.d.ts.map +1 -1
  535. package/dist/workspace/ci-run.js +6 -3
  536. package/dist/workspace/declaration.d.ts +16 -4
  537. package/dist/workspace/declaration.d.ts.map +1 -1
  538. package/dist/workspace/declaration.js +5 -2
  539. package/dist/workspace/declaration.schema.json +27 -3
  540. package/dist/workspace/drift-cli.d.ts.map +1 -1
  541. package/dist/workspace/drift-cli.js +8 -3
  542. package/dist/workspace/exit-cli.d.ts +1 -1
  543. package/dist/workspace/exit-cli.d.ts.map +1 -1
  544. package/dist/workspace/exit-cli.js +2 -1
  545. package/dist/workspace/import-fetch.d.ts +4 -2
  546. package/dist/workspace/import-fetch.d.ts.map +1 -1
  547. package/dist/workspace/import-fetch.js +4 -2
  548. package/dist/workspace/import-init.d.ts.map +1 -1
  549. package/dist/workspace/import-init.js +4 -2
  550. package/dist/workspace/ledger.schema.json +7 -3
  551. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  552. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  553. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  554. package/dist/workspace/pr-report.schema.json +74 -3
  555. package/dist/workspace/promote.d.ts +1 -1
  556. package/dist/workspace/promote.d.ts.map +1 -1
  557. package/dist/workspace/promote.js +2 -1
  558. package/dist/workspace/records-cli.d.ts +2 -2
  559. package/dist/workspace/records-cli.d.ts.map +1 -1
  560. package/dist/workspace/records-cli.js +3 -2
  561. package/dist/workspace/release-catalog.schema.json +277 -0
  562. package/dist/workspace/run-event.schema.json +18 -1
  563. package/dist/workspace/work-cli.d.ts +3 -1
  564. package/dist/workspace/work-cli.d.ts.map +1 -1
  565. package/dist/workspace/work-cli.js +7 -2
  566. package/dist/workspace/workspace-run.d.ts.map +1 -1
  567. package/dist/workspace/workspace-run.js +2 -1
  568. package/package.json +21 -1
  569. package/src/__fixtures__/estate-ledger.ts +101 -0
  570. package/src/__fixtures__/oidc-emulator.ts +31 -2
  571. package/src/__fixtures__/product-words.ts +44 -0
  572. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  573. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  574. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  575. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  576. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  577. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  578. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  579. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  580. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  581. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  582. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  583. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  584. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  585. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  586. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  587. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  588. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  589. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  590. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  591. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  592. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  593. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  594. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  595. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  596. package/src/__golden__/wave-loop/op-point.json +18 -4
  597. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  598. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  599. package/src/__golden__/wave-loop/op-spend.json +10 -2
  600. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  601. package/src/__golden__/wave-loop/op-wide.json +20 -4
  602. package/src/bucket-check/azure.ts +307 -0
  603. package/src/bucket-check/bucket-check.test.ts +210 -0
  604. package/src/bucket-check/fixtures/azure.json +153 -0
  605. package/src/bucket-check/fixtures/gcs.json +148 -0
  606. package/src/bucket-check/fixtures/s3.json +277 -0
  607. package/src/bucket-check/gcs.ts +257 -0
  608. package/src/bucket-check/index.ts +61 -0
  609. package/src/bucket-check/s3.ts +433 -0
  610. package/src/bucket-check/types.ts +75 -0
  611. package/src/bucket-check/wire.ts +50 -0
  612. package/src/bucket-check.ts +5 -0
  613. package/src/capabilities/templates.test.ts +2 -3
  614. package/src/capabilities/templates.ts +1 -2
  615. package/src/cdk/advise.test.ts +1 -1
  616. package/src/change-set-bundle.test.ts +0 -1
  617. package/src/change-set.ts +2 -3
  618. package/src/ci-agent.test.ts +348 -0
  619. package/src/ci-agent.ts +1026 -0
  620. package/src/ci-control.ts +174 -0
  621. package/src/ci-estate/delivery.ts +433 -0
  622. package/src/ci-estate/overdue.ts +81 -0
  623. package/src/ci-estate/page.ts +343 -0
  624. package/src/ci-estate/rows.ts +251 -0
  625. package/src/ci-estate.test.ts +281 -0
  626. package/src/ci-estate.ts +176 -0
  627. package/src/ci-handover.ts +67 -16
  628. package/src/ci-identity-database.test.ts +55 -0
  629. package/src/ci-identity-pulumi.test.ts +163 -0
  630. package/src/ci-identity-targets.test.ts +6 -2
  631. package/src/ci-identity.ts +124 -22
  632. package/src/ci-product-words.test.ts +101 -0
  633. package/src/ci-product-words.ts +536 -0
  634. package/src/ci-product.ts +174 -0
  635. package/src/ci-shared-reads.test.ts +145 -0
  636. package/src/cli/commands/audit.test.ts +1 -1
  637. package/src/cli/commands/audit.ts +3 -2
  638. package/src/cli/commands/carve.test.ts +1 -1
  639. package/src/cli/commands/carve.ts +2 -2
  640. package/src/cli/commands/init.ts +3 -1
  641. package/src/cli/component-wave-args.test.ts +16 -0
  642. package/src/cli/handlers/agent.ts +126 -0
  643. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  644. package/src/cli/handlers/approve-confirm.ts +200 -0
  645. package/src/cli/handlers/approve.ts +18 -1
  646. package/src/cli/handlers/build.test.ts +7 -0
  647. package/src/cli/handlers/build.ts +44 -1
  648. package/src/cli/handlers/ci-check.ts +33 -0
  649. package/src/cli/handlers/ci-forge-check.ts +91 -0
  650. package/src/cli/handlers/fan-out.test.ts +10 -10
  651. package/src/cli/handlers/fan-out.ts +5 -0
  652. package/src/cli/handlers/gate-pending.ts +46 -0
  653. package/src/cli/handlers/init.ts +1 -0
  654. package/src/cli/handlers/ledger.ts +1 -1
  655. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  656. package/src/cli/handlers/lock.test.ts +29 -2
  657. package/src/cli/handlers/lock.ts +66 -6
  658. package/src/cli/handlers/notify-relay.ts +130 -0
  659. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  660. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  661. package/src/cli/handlers/pr-env.ts +48 -11
  662. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  663. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  664. package/src/cli/handlers/pr-waves.test.ts +8 -2
  665. package/src/cli/handlers/pr.test.ts +8 -8
  666. package/src/cli/handlers/pr.ts +655 -205
  667. package/src/cli/handlers/promote.test.ts +5 -5
  668. package/src/cli/handlers/promote.ts +22 -2
  669. package/src/cli/handlers/release.ts +2 -0
  670. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  671. package/src/cli/handlers/run-wave.ts +65 -1
  672. package/src/cli/handlers/run.test.ts +6 -4
  673. package/src/cli/handlers/run.ts +86 -1
  674. package/src/cli/handlers/serve.ts +10 -1
  675. package/src/cli/main.ts +126 -13
  676. package/src/cli/mcp/ledger-tools.ts +126 -0
  677. package/src/cli/mcp/product-tools.test.ts +123 -0
  678. package/src/cli/mcp/product-tools.ts +129 -0
  679. package/src/cli/mcp/read-only.test.ts +134 -0
  680. package/src/cli/mcp/read-only.ts +68 -0
  681. package/src/cli/mcp/report-tools.ts +135 -0
  682. package/src/cli/mcp/server.test.ts +5 -4
  683. package/src/cli/mcp/server.ts +90 -16
  684. package/src/cli/mcp-config.ts +8 -3
  685. package/src/cli/parse-args.ts +42 -2
  686. package/src/cli/registry.ts +35 -0
  687. package/src/cloud-lister/sigv4.ts +80 -23
  688. package/src/components/adoption.test.ts +140 -0
  689. package/src/components/adoption.ts +141 -0
  690. package/src/components/apply-lease.ts +49 -0
  691. package/src/components/capability.ts +130 -6
  692. package/src/components/check-hooks.test.ts +66 -0
  693. package/src/components/check-hooks.ts +252 -0
  694. package/src/components/ci-services.test.ts +51 -0
  695. package/src/components/ci-services.ts +83 -0
  696. package/src/components/cli-support.ts +23 -2
  697. package/src/components/driver.test.ts +3 -3
  698. package/src/components/driver.ts +38 -5
  699. package/src/components/fan-out-run.ts +68 -18
  700. package/src/components/groups.ts +17 -2
  701. package/src/components/pr-comment-preview.test.ts +54 -0
  702. package/src/components/pr-env-ledger.test.ts +9 -0
  703. package/src/components/pr-env-ledger.ts +43 -0
  704. package/src/components/pr-env-ports.ts +29 -4
  705. package/src/components/pr-env-run-bundle.test.ts +8 -0
  706. package/src/components/pr-env-run.test.ts +19 -0
  707. package/src/components/pr-env-run.ts +12 -2
  708. package/src/components/pr-environment.test.ts +29 -0
  709. package/src/components/pr-environment.ts +39 -7
  710. package/src/components/pr-pipeline.test.ts +15 -0
  711. package/src/components/pr-pipeline.ts +274 -9
  712. package/src/components/pr-policy.ts +45 -7
  713. package/src/components/pr-run.test.ts +1 -1
  714. package/src/components/pr-run.ts +121 -5
  715. package/src/components/pr-targets.test.ts +35 -0
  716. package/src/components/pr-targets.ts +45 -0
  717. package/src/components/product-pipeline.test.ts +200 -0
  718. package/src/components/product-pipeline.ts +341 -0
  719. package/src/components/promote.ts +10 -1
  720. package/src/components/release-compile.ts +87 -1
  721. package/src/components/release-promote.ts +65 -1
  722. package/src/components/repo-lock.ts +52 -0
  723. package/src/components/row-lease.test.ts +490 -0
  724. package/src/components/row-lease.ts +167 -0
  725. package/src/components/wave-plan-policy.test.ts +19 -0
  726. package/src/components/wave-plan.ts +78 -4
  727. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  728. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  729. package/src/control/applied.test.ts +148 -0
  730. package/src/control/applied.ts +191 -0
  731. package/src/control/consumers.test.ts +129 -0
  732. package/src/control/consumers.ts +192 -0
  733. package/src/control/control.test.ts +302 -0
  734. package/src/control/dispatch.ts +699 -0
  735. package/src/control/edges.test.ts +112 -0
  736. package/src/control/edges.ts +164 -0
  737. package/src/control/note-checkout.test.ts +91 -0
  738. package/src/control/reconcile.ts +250 -0
  739. package/src/control/records.ts +395 -0
  740. package/src/discovery/sandbox/bundle.ts +25 -1
  741. package/src/engine-facts.test.ts +2 -3
  742. package/src/engine-facts.ts +1 -2
  743. package/src/exit-codes.test.ts +31 -0
  744. package/src/exit-codes.ts +55 -0
  745. package/src/forge-check/check.ts +155 -0
  746. package/src/forge-check/contract.ts +215 -0
  747. package/src/forge-check/forge-check.test.ts +427 -0
  748. package/src/forge-check/forge.ts +318 -0
  749. package/src/forge-check/index.ts +43 -0
  750. package/src/forge-check/pulumi.ts +192 -0
  751. package/src/forge-check/read-only.ts +56 -0
  752. package/src/forge-check/trust.ts +527 -0
  753. package/src/forge-check/types.ts +78 -0
  754. package/src/forge-check.ts +5 -0
  755. package/src/gate-decision-bundle.test.ts +13 -0
  756. package/src/gate-decision.ts +3 -0
  757. package/src/gate-policy.ts +92 -3
  758. package/src/gated-waves-bundle.test.ts +0 -1
  759. package/src/index.ts +2 -0
  760. package/src/lexicon.ts +95 -6
  761. package/src/lifecycle/adoption-file.ts +1 -2
  762. package/src/lifecycle/cloud-index.test.ts +2 -3
  763. package/src/lifecycle/cloud-index.ts +1 -2
  764. package/src/lifecycle/control-entries-ledger.test.ts +70 -0
  765. package/src/lifecycle/gate-applied.ts +6 -0
  766. package/src/lifecycle/gate-ledger.ts +36 -1
  767. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  768. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  769. package/src/lifecycle/gated-request-digest.ts +49 -0
  770. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  771. package/src/lifecycle/gated-request.ts +280 -0
  772. package/src/lifecycle/identity-match.ts +25 -6
  773. package/src/lifecycle/index-diff.ts +1 -2
  774. package/src/lifecycle/index-document.ts +1 -2
  775. package/src/lifecycle/index-import.test.ts +14 -0
  776. package/src/lifecycle/index-import.ts +54 -34
  777. package/src/lifecycle/ledger-read.ts +7 -3
  778. package/src/lifecycle/lock-rows.test.ts +109 -0
  779. package/src/lifecycle/lock-rows.ts +167 -0
  780. package/src/lifecycle/publish-target-context.test.ts +108 -0
  781. package/src/lifecycle/query.test.ts +2 -3
  782. package/src/lifecycle/query.ts +109 -7
  783. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  784. package/src/lifecycle/release-catalog-site.ts +291 -0
  785. package/src/lifecycle/release-catalog.test.ts +193 -0
  786. package/src/lifecycle/release-catalog.ts +353 -0
  787. package/src/lifecycle/release-changelog.test.ts +70 -0
  788. package/src/lifecycle/release-changelog.ts +71 -0
  789. package/src/lifecycle/release-cut.ts +2 -2
  790. package/src/lifecycle/release-ledger.ts +20 -0
  791. package/src/lifecycle/release-publish.ts +45 -22
  792. package/src/lifecycle/release-read.ts +2 -0
  793. package/src/lifecycle/release-status.test.ts +186 -0
  794. package/src/lifecycle/release-status.ts +176 -0
  795. package/src/lifecycle/resource-lock.test.ts +175 -0
  796. package/src/lifecycle/resource-lock.ts +354 -0
  797. package/src/lifecycle/retention.ts +2 -0
  798. package/src/lifecycle/run-ledger.ts +7 -1
  799. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  800. package/src/lifecycle/snapshot-store.ts +1 -2
  801. package/src/lifecycle/target-lock.ts +24 -9
  802. package/src/mcp/types.ts +7 -0
  803. package/src/notify-product.ts +76 -0
  804. package/src/notify-relay.test.ts +213 -0
  805. package/src/notify-relay.ts +407 -0
  806. package/src/notify.ts +95 -14
  807. package/src/object-store/azure-blob.ts +374 -0
  808. package/src/object-store/common.ts +133 -0
  809. package/src/object-store/errors.ts +26 -0
  810. package/src/object-store/from-env.ts +36 -0
  811. package/src/object-store/gcs.ts +436 -0
  812. package/src/object-store/index.ts +8 -0
  813. package/src/object-store/object-store.test.ts +130 -0
  814. package/src/object-store/s3.ts +350 -0
  815. package/src/op/activities/converge.ts +2 -1
  816. package/src/op/activities/index.ts +1 -1
  817. package/src/op/activities/review-agent.open.test.ts +78 -0
  818. package/src/op/activities/review-agent.test.ts +13 -0
  819. package/src/op/activities/review-agent.ts +89 -5
  820. package/src/op/gate.ts +81 -22
  821. package/src/op/generate-pipeline.ts +7 -1
  822. package/src/op/index.ts +21 -0
  823. package/src/op/op-waves-after-plan.test.ts +276 -0
  824. package/src/op/op-waves-after-plan.ts +238 -0
  825. package/src/op/op-waves-capability-spec.ts +113 -0
  826. package/src/op/op-waves-capability.test.ts +217 -0
  827. package/src/op/op-waves-capability.ts +370 -0
  828. package/src/op/op-waves-events.ts +135 -0
  829. package/src/op/op-waves-notify-words.test.ts +149 -0
  830. package/src/op/op-waves-notify.ts +41 -16
  831. package/src/op/op-waves-pull-request.test.ts +142 -0
  832. package/src/op/op-waves-release-port.ts +64 -0
  833. package/src/op/op-waves-release.test.ts +209 -0
  834. package/src/op/op-waves-release.ts +133 -0
  835. package/src/op/op-waves-run-record.test.ts +32 -0
  836. package/src/op/op-waves-run.ts +1142 -49
  837. package/src/op/op-waves-stand-down.test.ts +240 -0
  838. package/src/op/op-waves-stand-down.ts +108 -0
  839. package/src/op/op-waves-trace.test.ts +205 -0
  840. package/src/op/op-waves.test.ts +112 -0
  841. package/src/op/op-waves.ts +261 -20
  842. package/src/op/runtime.ts +104 -0
  843. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  844. package/src/op/stage-hooks.ts +91 -12
  845. package/src/op/steward-beside.ts +2 -1
  846. package/src/op/types.ts +3 -2
  847. package/src/otlp-metrics.ts +96 -0
  848. package/src/otlp.test.ts +243 -0
  849. package/src/otlp.ts +544 -0
  850. package/src/override-gate-bundle.test.ts +2 -0
  851. package/src/override-gate.ts +4 -0
  852. package/src/policy-packs.ts +230 -0
  853. package/src/policy-source.test.ts +256 -0
  854. package/src/policy-source.ts +112 -0
  855. package/src/pr-forge.ts +123 -0
  856. package/src/pr-loop-bundle.test.ts +6 -2
  857. package/src/pr-loop-words.test.ts +155 -0
  858. package/src/pr-loop.ts +371 -52
  859. package/src/pr-post.ts +32 -1
  860. package/src/pr-report-url.ts +62 -6
  861. package/src/pr-requires.test.ts +37 -1
  862. package/src/pr-requires.ts +16 -2
  863. package/src/product-subpaths-plain-node.e2e.test.ts +211 -0
  864. package/src/release-floors.ts +1 -1
  865. package/src/run-event.ts +29 -1
  866. package/src/sorted-json.ts +17 -0
  867. package/src/stage-hooks-bundle.test.ts +8 -0
  868. package/src/terraform/credentials.test.ts +77 -0
  869. package/src/terraform/credentials.ts +162 -0
  870. package/src/utils.ts +2 -11
  871. package/src/wave-loop-golden.test.ts +2 -1
  872. package/src/wave-runtime.ts +2 -2
  873. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  874. package/src/workspace/ci-lock-grain.test.ts +31 -0
  875. package/src/workspace/ci-lock-grain.ts +30 -0
  876. package/src/workspace/ci-report-url.test.ts +1 -1
  877. package/src/workspace/ci-run.test.ts +1 -1
  878. package/src/workspace/ci-run.ts +6 -3
  879. package/src/workspace/declaration.schema.json +27 -3
  880. package/src/workspace/declaration.test.ts +1 -1
  881. package/src/workspace/declaration.ts +26 -10
  882. package/src/workspace/drift-cli.ts +8 -3
  883. package/src/workspace/exit-cli.ts +2 -1
  884. package/src/workspace/import-fetch.ts +4 -2
  885. package/src/workspace/import-init.ts +4 -2
  886. package/src/workspace/ledger.schema.json +7 -3
  887. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  888. package/src/workspace/pr-report.schema.json +74 -3
  889. package/src/workspace/promote.ts +2 -1
  890. package/src/workspace/records-cli.ts +3 -2
  891. package/src/workspace/release-catalog.schema.json +277 -0
  892. package/src/workspace/run-event.schema.json +18 -1
  893. package/src/workspace/work-cli.ts +8 -2
  894. package/src/workspace/workspace-run.ts +2 -1
package/src/pr-loop.ts CHANGED
@@ -47,11 +47,14 @@
47
47
  * `identity.gates` entry covers every member.
48
48
  */
49
49
 
50
- import type { ChangeSetAction, ChangeSetDocument } from "./change-set";
50
+ import { NEXT_RELEASE } from "./release-floors";
51
+ import type { ChangeSetAction, ChangeSetDocument, ChangeSetEntry } from "./change-set";
52
+ import { parsePulumiUrn, pulumiMayAppearParent } from "./pulumi-urn";
51
53
  import type { PrRequireOutcome } from "./pr-requires";
52
54
  import { renderMigrationLines, type PrMigrationFile } from "./pr-migrations";
53
55
  import { GITHUB_COMMENT_LIMIT, groupChangeSet, renderPlanSummaryMarkdown } from "./plan-summary";
54
- import { NEXT_RELEASE } from "./release-floors";
56
+ import { activeProductWords, approveLine, commentLine, isChantWords, overrideLine, productStatusContext, type CiProductWords } from "./ci-product-words";
57
+ import type { CrossStackEdge } from "./control/edges";
55
58
 
56
59
  /** The schema a pull-request report names in `$schema`. */
57
60
  export const PR_REPORT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/pr-report/v1/pr-report.schema.json";
@@ -93,10 +96,16 @@ export const PR_REPORT_MIGRATIONS_FLOOR = "0.124.49";
93
96
  export const PR_REPORT_READS_FLOOR = "0.124.52";
94
97
 
95
98
  /** The first chant whose report can carry the `not-started` member status (ws-107, #4440). */
96
- export const PR_REPORT_NOT_STARTED_FLOOR = NEXT_RELEASE;
99
+ export const PR_REPORT_NOT_STARTED_FLOOR = "0.124.54";
97
100
 
98
101
  /** The first chant whose report can carry `groups`, `fallbacks`, and a member's `group` and `groupOutcome` (ws-107, #4446). */
99
- export const PR_REPORT_GROUPS_FLOOR = NEXT_RELEASE;
102
+ export const PR_REPORT_GROUPS_FLOOR = "0.124.54";
103
+
104
+ /** The first chant whose report can carry `lockTargets` (#4552). */
105
+ export const PR_REPORT_LOCK_TARGETS_FLOOR = NEXT_RELEASE;
106
+
107
+ /** The first chant whose report carries {@link PrReport.crossStackEdges} (#4617). */
108
+ export const PR_REPORT_CROSS_STACK_FLOOR = NEXT_RELEASE;
100
109
 
101
110
  /** The gate a pull request's apply waits on, unless the pipeline names another. */
102
111
  export const PR_APPLY_GATE = "pr-apply";
@@ -133,8 +142,13 @@ export const PR_STATUS_CONTEXTS = { plan: "chant/plan", apply: "chant/apply", re
133
142
  /** A pull-request loop stage: plan on the pull request, then record (#4168) or, opted in, apply on merge. */
134
143
  export type PrStage = keyof typeof PR_STATUS_CONTEXTS;
135
144
 
136
- /** A stage's status context: `chant/plan`, or `chant/plan/<member>` for a workspace member's pipeline. */
137
- export function prStatusContext(stage: PrStage, member?: string): string {
145
+ /**
146
+ * A stage's status context: `chant/plan`, or `chant/plan/<member>` for a
147
+ * workspace member's pipeline. Under a product's words (#4550) the prefix and
148
+ * the stage word are the product's: `plywood/preview/shop-dev`.
149
+ */
150
+ export function prStatusContext(stage: PrStage, member?: string, words: CiProductWords = activeProductWords()): string {
151
+ if (!isChantWords(words)) return productStatusContext(words, stage, member);
138
152
  return member ? `${PR_STATUS_CONTEXTS[stage]}/${member}` : PR_STATUS_CONTEXTS[stage];
139
153
  }
140
154
 
@@ -279,9 +293,13 @@ export interface PrRound {
279
293
  /** The components planned again, in apply order. */
280
294
  components: string[];
281
295
  approval: PrApproval;
282
- /** `waiting`: no approval stands for `digest`. `plan-failed`: a member failed to plan, so the round did not apply. */
283
- status: "applied" | "failed" | "waiting" | "plan-failed";
284
- /** With `waiting`: why an approval that stands does not count (`--require-review`). */
296
+ /**
297
+ * `waiting`: no approval stands for `digest`. `plan-failed`: a member failed
298
+ * to plan, so the round did not apply. `held`: another run holds a row the
299
+ * round changes (#4594), so it did not apply; `message` names that run.
300
+ */
301
+ status: "applied" | "failed" | "waiting" | "plan-failed" | "held";
302
+ /** With `waiting`: why an approval that stands does not count (`--require-review`). With `held`: the run holding the rows. */
285
303
  message?: string;
286
304
  /**
287
305
  * The first approval covered this round's plan (#4419): no gate of its own was
@@ -436,6 +454,8 @@ export interface PrPolicyReport {
436
454
  override?: { by: string; at: string; reason: string; digest: string };
437
455
  /** While denied: the command that overrides the denial. */
438
456
  overrideCommand?: string;
457
+ /** `ci.policy.source` as fetched (#4613): the shared repository, its ref, the commit read and the Rego directory. */
458
+ source?: { repo: string; ref: string; commit: string; path: string };
439
459
  }
440
460
 
441
461
  /**
@@ -538,6 +558,20 @@ export interface PrReport {
538
558
  groups?: PrGroup[];
539
559
  /** The components that could have grouped and did not, with why (#4446), sorted. Absent when none. Since {@link PR_REPORT_GROUPS_FLOOR}. */
540
560
  fallbacks?: PrGroupFallback[];
561
+ /**
562
+ * A section per member that its lexicon rendered from its own part of the
563
+ * change set (#4573), placed under the member table: rows a resource table
564
+ * does not carry, such as a SQL member's statements and their class. Absent
565
+ * when no lexicon rendered one. Added within contract 1 by the chant that
566
+ * carries `CI_PRODUCT_FLOOR` (`@intentius/chant/ci-product`).
567
+ */
568
+ details?: PrMemberDetail[];
569
+ /**
570
+ * The policy findings capabilities' plans carried (#4550), one entry per
571
+ * member with any. Absent when none did. Added within contract 1 by the
572
+ * chant that carries `CI_PRODUCT_FLOOR`.
573
+ */
574
+ capabilityPolicy?: PrCapabilityPolicy[];
541
575
  /** Component names: which changed, which run because they depend on one, and what the change touched that no component deploys. */
542
576
  selection: {
543
577
  changed: string[];
@@ -549,6 +583,26 @@ export interface PrReport {
549
583
  };
550
584
  members: PrMember[];
551
585
  changeSet: ChangeSetDocument;
586
+ /**
587
+ * The names the pull request's target locks take under `ci.locks` (#4552,
588
+ * ruling D), sorted, when any member is on the resource lock grain: each
589
+ * such member's row keys, and the component name of every component with
590
+ * a member on another grain. `chant lock --from-report` locks these in
591
+ * place of `selection.waves`. Absent when no member is on the resource
592
+ * grain. Added within contract 1 by chant
593
+ * {@link PR_REPORT_LOCK_TARGETS_FLOOR}.
594
+ */
595
+ lockTargets?: string[];
596
+ /**
597
+ * The stacks outside the workspace a member reads (#4617, a Pulumi
598
+ * `StackReference` no step here applies, #4547), each marked stale,
599
+ * current or unknown from the control repo's entries and apply records
600
+ * (`./control/edges.ts`). The plan job marks every one unknown, since it
601
+ * reads no control repo; the job that posts the note marks them again
602
+ * from a checkout of it. Absent when no member reads one. Added within
603
+ * contract 1 by chant {@link PR_REPORT_CROSS_STACK_FLOOR}.
604
+ */
605
+ crossStackEdges?: CrossStackEdge[];
552
606
  /**
553
607
  * The stage hooks the job ran (#4288), in order. Absent when it ran none.
554
608
  * Added within contract 1 by chant {@link PR_REPORT_HOOKS_FLOOR}.
@@ -568,6 +622,29 @@ export interface PrReport {
568
622
  beforeMerge?: PrBeforeMerge;
569
623
  }
570
624
 
625
+ /**
626
+ * A policy engine's findings a capability's plan carried for one member
627
+ * (#4550, from chant#4541's `pulumi-up`: CrossGuard in the preview job).
628
+ * `denied`: the capability refused the plan (`policyDenied`), so the stage
629
+ * exits 7. Otherwise the findings are advisory and the note lists them.
630
+ */
631
+ export interface PrCapabilityPolicy {
632
+ member: string;
633
+ denied: boolean;
634
+ denials: Array<{ rule: string; message: string }>;
635
+ holds: Array<{ rule: string; message: string }>;
636
+ warnings: string[];
637
+ }
638
+
639
+ /** One member's detail section (#4573): markdown lines its lexicon rendered. */
640
+ export interface PrMemberDetail {
641
+ member: string;
642
+ /** The section's summary line. Default: the member's name. */
643
+ title?: string;
644
+ /** Markdown lines. A table, a list, or both; chant adds nothing inside. */
645
+ lines: string[];
646
+ }
647
+
571
648
  /** The counts a member's entries add up to. */
572
649
  export function memberCounts(doc: Pick<ChangeSetDocument, "summary">, member: string): PrMemberCounts {
573
650
  const by = doc.summary.byMember[member] ?? {};
@@ -586,51 +663,90 @@ export function memberHoleReasons(report: Pick<PrReport, "changeSet">, member: s
586
663
  return [...new Set((m?.holes ?? []).map((h) => h.reason))];
587
664
  }
588
665
 
589
- /** The approve command a reviewer runs for this report's digest. */
590
- export function prApproveCommand(report: Pick<PrReport, "op" | "gate" | "digest">, approver = "<you>"): string {
666
+ /**
667
+ * The approve command a reviewer runs for this report's digest: the product's
668
+ * approve line under its words (#4550). `target` fills the template's
669
+ * `{target}` (#4601): the member the line approves, such as sql-yodeler's
670
+ * environment.
671
+ */
672
+ export function prApproveCommand(report: Pick<PrReport, "op" | "gate" | "digest"> & { target?: string }, approver = "<you>", words: CiProductWords = activeProductWords()): string {
673
+ if (!isChantWords(words)) return approveLine(words, { op: report.op, gate: report.gate, digest: report.digest, approver, sign: true, ...(report.target !== undefined ? { target: report.target } : {}) });
591
674
  return `chant approve ${report.op} ${report.gate} --plan ${report.digest} --approver ${approver} --sign`;
592
675
  }
593
676
 
677
+ /**
678
+ * The targets the product's approve line names (#4601), one line each: none
679
+ * when its template has no `{target}`; else the workspace member the report
680
+ * is for, else each member in the report, else the environment.
681
+ */
682
+ export function prApproveTargets(report: Pick<PrReport, "env"> & Partial<Pick<PrReport, "member" | "members">>, words: CiProductWords = activeProductWords()): string[] {
683
+ if (!words.approve.includes("{target}")) return [];
684
+ if (report.member) return [report.member];
685
+ const names = [...new Set((report.members ?? []).map((m) => m.member))];
686
+ return names.length > 0 ? names : [report.env];
687
+ }
688
+
689
+ /** Every approve command the report asks for: one per {@link prApproveTargets}, or the one line when the template names no target. */
690
+ export function prApproveCommands(
691
+ report: Pick<PrReport, "op" | "gate" | "digest" | "env"> & Partial<Pick<PrReport, "member" | "members">>,
692
+ approver = "<you>",
693
+ words: CiProductWords = activeProductWords(),
694
+ ): string[] {
695
+ const targets = prApproveTargets(report, words);
696
+ if (targets.length === 0) return [prApproveCommand(report, approver, words)];
697
+ return targets.map((target) => prApproveCommand({ op: report.op, gate: report.gate, digest: report.digest, target }, approver, words));
698
+ }
699
+
594
700
  /**
595
701
  * The refusal when the approved digest is not the planned one: both digests,
596
702
  * that nothing applied, and how to close it.
597
703
  */
598
- export function describePlanChanged(report: Pick<PrReport, "op" | "gate" | "digest" | "approval">): string {
704
+ export function describePlanChanged(report: Pick<PrReport, "op" | "gate" | "digest" | "approval"> & Partial<Pick<PrReport, "env" | "member" | "members">>): string {
705
+ const approve = report.env !== undefined ? prApproveCommands({ ...report, env: report.env }).join("; ") : prApproveCommand(report);
599
706
  return (
600
707
  `The plan changed after review, so nothing was applied. ` +
601
708
  `approved: ${report.approval.approved ?? "(none)"}; planned now: ${report.digest}. ` +
602
- `Read the new plan, and if it is right, approve it: ${prApproveCommand(report)}; then run the apply again.`
709
+ `Read the new plan, and if it is right, approve it: ${approve}; then run the apply again.`
603
710
  );
604
711
  }
605
712
 
606
713
  const short = (sha: string): string => sha.slice(0, 12);
607
714
  const code = (s: string): string => "`" + s.replaceAll("`", "'") + "`";
608
715
 
609
- const STATUS_WORDS: Record<PrMemberStatus, string> = {
610
- planned: "planned",
611
- "plan-failed": "plan failed",
612
- applied: "applied",
613
- failed: "apply failed",
614
- blocked: "blocked",
615
- waiting: "waiting on its new plan",
616
- "not-started": "not started",
617
- };
716
+ /** A member's status in the note, in the product's verbs (#4550): chant's `planned`, plywood's `previewed`. */
717
+ function statusWords(words: CiProductWords): Record<PrMemberStatus, string> {
718
+ const [plan, planned] = words.verbs.plan;
719
+ const [apply, applied] = words.verbs.apply;
720
+ return {
721
+ planned,
722
+ "plan-failed": `${plan} failed`,
723
+ applied,
724
+ failed: `${apply} failed`,
725
+ blocked: "blocked",
726
+ waiting: "waiting on its new plan",
727
+ "not-started": "not started",
728
+ };
729
+ }
730
+
731
+ const capital = (w: string): string => w.charAt(0).toUpperCase() + w.slice(1);
618
732
 
619
- function headline(report: PrReport): string {
733
+ function headline(report: PrReport, words: CiProductWords): string {
620
734
  const n = report.members.length;
621
- const members = `${n} member${n === 1 ? "" : "s"}`;
735
+ const members = `${n} ${words.noun[n === 1 ? 0 : 1]}`;
736
+ const [plan, planned] = words.verbs.plan;
737
+ const applied = words.verbs.apply[1];
622
738
  switch (report.status) {
623
739
  case "nothing":
624
- return "Nothing to plan: no component deploys what this change touches.";
740
+ return `Nothing to ${plan}: no component deploys what this change touches.`;
625
741
  case "planned":
626
- return `Planned ${members}.`;
742
+ return `${capital(planned)} ${members}.`;
627
743
  case "recorded":
628
744
  return `Recorded the plan of ${members} on merge. Nothing applied: a release that carries this commit deploys it.`;
629
745
  case "plan-failed":
630
746
  if (report.hooks?.some((h) => h.outcome === "failed")) return "A hook failed, so nothing can apply.";
631
- return `Planning failed for ${report.members.filter((m) => m.status === "plan-failed").length} of ${members}, so nothing can apply.`;
747
+ return `${isChantWords(words) ? "Planning" : `The ${plan}`} failed for ${report.members.filter((m) => m.status === "plan-failed").length} of ${members}, so nothing can apply.`;
632
748
  case "applied":
633
- return `Applied ${members}.`;
749
+ return `${capital(applied)} ${members}.`;
634
750
  case "failed": {
635
751
  const blocked = report.members.filter((m) => m.status === "blocked").length;
636
752
  const notStarted = report.members.filter((m) => m.status === "not-started").length;
@@ -639,14 +755,14 @@ function headline(report: PrReport): string {
639
755
  case "wave-applied": {
640
756
  const applied = (report.waves ?? []).filter((w) => w.status === "applied").map((w) => w.wave);
641
757
  const total = report.selection.waves.length;
642
- return `Applied wave ${applied.at(-1) ?? "?"} of ${total}. The next wave runs in its own job.`;
758
+ return `${capital(words.verbs.apply[1])} wave ${applied.at(-1) ?? "?"} of ${total}. The next wave runs in its own job.`;
643
759
  }
644
760
  case "refused": {
645
761
  const waiting = report.waves?.find((w) => w.status === "waiting");
646
762
  return waiting ? `Wave ${waiting.wave} waits at its gate ${code(waiting.gate)}; nothing in it applied.` : "The apply refused.";
647
763
  }
648
764
  case "waiting":
649
- return `Applied ${report.members.filter((m) => m.status === "applied").length} of ${members}; ${report.members.filter((m) => m.status === "waiting").length} wait on an approval of the plan made after their upstream applied.`;
765
+ return `${capital(applied)} ${report.members.filter((m) => m.status === "applied").length} of ${members}; ${report.members.filter((m) => m.status === "waiting").length} wait on an approval of the plan made after their upstream applied.`;
650
766
  }
651
767
  }
652
768
 
@@ -655,6 +771,27 @@ function headline(report: PrReport): string {
655
771
  * component that failed, and that the rest went on. Undefined when nothing
656
772
  * is blocked.
657
773
  */
774
+ /**
775
+ * The cross-stack edges (#4617): a table of each stack outside the
776
+ * workspace a member reads, its owner and its mark, and a line naming the
777
+ * stale ones, whose reader holds outputs that may have changed since.
778
+ */
779
+ function crossStackLines(report: Pick<PrReport, "crossStackEdges">): string[] {
780
+ const edges = report.crossStackEdges ?? [];
781
+ if (edges.length === 0) return [];
782
+ const day = (iso?: string): string => (iso ? iso.replace(/\.\d+Z$/, "Z") : "never");
783
+ const out = ["", "| Reader | Reads stack | Owner | Edge | Why |", "|---|---|---|---|---|"];
784
+ for (const e of edges) {
785
+ const why = e.ownerApplied ? `${e.why} (owner applied ${day(e.ownerApplied.at)} at ${code(e.ownerApplied.sha.slice(0, 12))}, reader updated ${day(e.lastUpdate)})` : e.why;
786
+ out.push(`| ${code(e.member)} | ${code(e.stack)} | ${e.owner ? code(e.owner) : "?"} | ${e.status} | ${why} |`);
787
+ }
788
+ const stale = edges.filter((e) => e.status === "stale");
789
+ if (stale.length > 0) {
790
+ out.push("", `Stale: ${stale.map((e) => `${code(e.member)} reads ${code(e.stack)}`).join("; ")}. The owner applied since the reader last updated, so this plan reads its outputs as they are now and the reader's last update read older ones.`);
791
+ }
792
+ return out;
793
+ }
794
+
658
795
  function blockedLine(members: readonly PrMember[]): string | undefined {
659
796
  const byRoot = new Map<string, Set<string>>();
660
797
  for (const m of members) {
@@ -731,6 +868,31 @@ function policyLines(report: PrReport): string[] {
731
868
  return out;
732
869
  }
733
870
 
871
+ /**
872
+ * The findings capabilities' plans carried (#4550), in the product's words:
873
+ * a denial with the product's override line, then each advisory finding as
874
+ * a row.
875
+ */
876
+ function capabilityPolicyLines(report: PrReport, words: CiProductWords): string[] {
877
+ const all = report.capabilityPolicy ?? [];
878
+ if (all.length === 0) return [];
879
+ const out: string[] = [];
880
+ for (const p of all.filter((x) => x.denied)) {
881
+ out.push("", `The policy in ${code(p.member)}'s ${words.verbs.plan[0]} denied it, so nothing can apply:`, ...p.denials.map((d) => `- ${code(d.rule)}: ${d.message}`));
882
+ if (p.denials.length > 0) out.push("", `A person the overriders file at base lists may override it: ${code(overrideLine(words, { op: "policy-override", gate: report.gate, target: p.member, rules: p.denials.map((d) => d.rule) }))}`);
883
+ }
884
+ const rows = all.flatMap((p) => [
885
+ ...(p.denied ? [] : p.denials).map((d) => [p.member, d.rule, "denied", d.message]),
886
+ ...p.holds.map((d) => [p.member, d.rule, "advisory", d.message]),
887
+ ...p.warnings.map((w) => [p.member, "", "warning", w]),
888
+ ]);
889
+ if (rows.length > 0) {
890
+ out.push("", `| ${capital(words.noun[0])} | Rule | Finding | Message |`, "|---|---|---|---|");
891
+ for (const [m, rule, kind, message] of rows) out.push(`| ${code(m!)} | ${rule ? code(rule) : ""} | ${kind} | ${message!.replaceAll("|", "\\|").replaceAll("\n", " ")} |`);
892
+ }
893
+ return out;
894
+ }
895
+
734
896
  /** Who a wave applied or waits under, as a table cell. */
735
897
  function waveApproval(w: PrWave): string {
736
898
  const whose = w.approval === "pull-request" ? "the pull request's" : "its own";
@@ -743,7 +905,7 @@ function waveApproval(w: PrWave): string {
743
905
  * saying which approval it applied under, then for a wave that waits the
744
906
  * reason its plan moved and the approve command for its new plan.
745
907
  */
746
- function waveLines(report: PrReport, approver: string): string[] {
908
+ function waveLines(report: PrReport, approver: string, words: CiProductWords): string[] {
747
909
  const waves = report.waves ?? [];
748
910
  if (waves.length === 0) return [];
749
911
  const out = ["", "| Wave | Components | Status | Approval |", "|---:|---|---|---|"];
@@ -757,7 +919,7 @@ function waveLines(report: PrReport, approver: string): string[] {
757
919
  `Read wave ${w.wave}'s plan, ${code(w.digest)}, and approve it with:`,
758
920
  "",
759
921
  "```",
760
- prApproveCommand({ op: report.op, gate: w.gate, digest: w.digest }, approver),
922
+ ...waveApproveCommands(report, w, approver, words),
761
923
  "```",
762
924
  "",
763
925
  "Then run the wave's apply job again.",
@@ -766,7 +928,38 @@ function waveLines(report: PrReport, approver: string): string[] {
766
928
  return out;
767
929
  }
768
930
 
769
- function approvalLines(report: PrReport, approver: string): string[] {
931
+ /** A waiting wave's approve lines: one per component when the product's template names `{target}` (#4601). */
932
+ function waveApproveCommands(report: PrReport, w: PrWave, approver: string, words: CiProductWords): string[] {
933
+ const targets = words.approve.includes("{target}") ? (w.components.length > 0 ? w.components : [report.env]) : [];
934
+ if (targets.length === 0) return [prApproveCommand({ op: report.op, gate: w.gate, digest: w.digest }, approver, words)];
935
+ return targets.map((target) => prApproveCommand({ op: report.op, gate: w.gate, digest: w.digest, target }, approver, words));
936
+ }
937
+
938
+ /**
939
+ * The note's sentence on what the merge does with the plan (#4601), by the
940
+ * product's apply mode. chant's words keep chant's sentence, which covers
941
+ * the record on merge and the opt-in apply on merge alike.
942
+ */
943
+ export function prMergeSentence(report: Pick<PrReport, "gate">, words: CiProductWords = activeProductWords()): string {
944
+ const applied = words.verbs.apply[1];
945
+ switch (words.applyMode) {
946
+ case "on-merge": {
947
+ if (words.approval === "per-wave") {
948
+ return `On merge the waves are ${applied} in order, each under an approval of its own gate for its own plan. A wave whose plan moved since this note waits at its gate for a new approval.`;
949
+ }
950
+ const waveGate = words.gateName.replace("{gate}", report.gate).replace("{k}", "<k>");
951
+ return `On merge the waves are ${applied} in order under this approval, each while its plan is one this approval covers. A wave whose plan moved waits at its own gate, ${code(waveGate)}, for an approval of its own.`;
952
+ }
953
+ case "before-merge": {
954
+ const comment = commentLine(words, "apply");
955
+ return `Before merge, ${comment ? code(comment) : "the apply job"} runs this plan once the pull request is approved, mergeable and green, and only while the plan is still this one; if it moved, the apply refuses and names both digests. The merge records what was ${applied}.`;
956
+ }
957
+ case "release":
958
+ return "On merge the plan is recorded, and a release deploys it. With apply on merge it applies if the plan is still this one; if it moved, the apply refuses and names both digests.";
959
+ }
960
+ }
961
+
962
+ function approvalLines(report: PrReport, approver: string, words: CiProductWords): string[] {
770
963
  const a = report.approval;
771
964
  if (report.status === "nothing") return [];
772
965
  if (a.status === "approved") return [`Approved by ${(a.approvedBy ?? []).map(code).join(", ")} for this digest.`];
@@ -775,33 +968,129 @@ function approvalLines(report: PrReport, approver: string): string[] {
775
968
  ? [`An approval stands for ${code(a.approved ?? "(none)")}, not for this digest: the plan changed since it was approved.`]
776
969
  : [report.stage === "record" ? "No approval stands for this plan. The release gate decides before it deploys." : "Not approved yet."];
777
970
  if (report.stage === "plan" && report.status === "planned") {
971
+ const commands = prApproveCommands(report, approver, words);
778
972
  lines.push(
779
973
  "",
780
- "A reviewer who approved this pull request approves the plan with:",
974
+ commands.length > 1 ? `A reviewer who approved this pull request approves each ${words.noun[0]}'s plan with:` : "A reviewer who approved this pull request approves the plan with:",
781
975
  "",
782
976
  "```",
783
- prApproveCommand(report, approver),
977
+ ...commands,
784
978
  "```",
785
979
  "",
786
- "On merge the plan is recorded, and a release deploys it. With apply on merge it applies if the plan is still this one; if it moved, the apply refuses and names both digests.",
980
+ prMergeSentence(report, words),
787
981
  );
788
982
  }
789
983
  return lines;
790
984
  }
791
985
 
986
+ /**
987
+ * One row of the note for a change-set entry the planner marked `mayAppear`
988
+ * (#4548): a resource a component registers inside an `apply()` that the
989
+ * preview could not run, so it is known only when the apply runs.
990
+ */
991
+ export interface PrMayAppearRow {
992
+ member: string;
993
+ /**
994
+ * The component resource that registers it, as `<type> <name>`. Only the
995
+ * type when the entry names no single component (its URN carries the parent
996
+ * type chain, not the parent's name), and `the stack` when it has none.
997
+ */
998
+ component: string;
999
+ /** The resource, as `<type> <name>`; absent on the entry that stands for whatever the component may register. */
1000
+ resource?: string;
1001
+ /** The entry's action: `create` for the stand-in entry, else what the plan says about a resource the last deployment holds. */
1002
+ action: ChangeSetAction;
1003
+ }
1004
+
1005
+ const typeAndName = (urn: string): string => {
1006
+ const p = parsePulumiUrn(urn);
1007
+ return p ? `${p.type} ${p.name}` : urn;
1008
+ };
1009
+
1010
+ /**
1011
+ * The note's rows for the `mayAppear` entries of a change set, sorted by
1012
+ * member and component. A stand-in entry (`pulumiMayAppearAddress`) names its
1013
+ * component from its own address. Any other entry names the component whose
1014
+ * stand-in entry in the same member sits on its parent type chain, when one
1015
+ * does; else the type of its parent.
1016
+ */
1017
+ export function prMayAppearRows(doc: Pick<ChangeSetDocument, "entries">): PrMayAppearRow[] {
1018
+ const flagged = new Map<string, Array<{ urn: string; chain: string }>>();
1019
+ for (const e of doc.entries) {
1020
+ if (e.mayAppear !== true) continue;
1021
+ const parent = pulumiMayAppearParent(e.address);
1022
+ const parsed = parent ? parsePulumiUrn(parent) : undefined;
1023
+ if (!parent || !parsed) continue;
1024
+ flagged.set(e.member, [...(flagged.get(e.member) ?? []), { urn: parent, chain: parsed.qualifiedType }]);
1025
+ }
1026
+ const componentOf = (e: ChangeSetEntry): string => {
1027
+ const parsed = parsePulumiUrn(e.address);
1028
+ if (!parsed) return "the stack";
1029
+ const parents = parsed.parentTypes.join("$");
1030
+ const under = (flagged.get(e.member) ?? []).filter((c) => parents === c.chain || parents.startsWith(`${c.chain}$`));
1031
+ // The nearest component: the longest chain that holds the entry.
1032
+ const longest = Math.max(-1, ...under.map((c) => c.chain.length));
1033
+ const nearest = under.filter((c) => c.chain.length === longest);
1034
+ if (nearest.length === 1) return typeAndName(nearest[0].urn);
1035
+ return parsed.parentTypes.at(-1) ?? "the stack";
1036
+ };
1037
+ const rows: PrMayAppearRow[] = [];
1038
+ for (const e of doc.entries) {
1039
+ if (e.mayAppear !== true) continue;
1040
+ const parent = pulumiMayAppearParent(e.address);
1041
+ rows.push(parent ? { member: e.member, component: typeAndName(parent), action: e.action } : { member: e.member, component: componentOf(e), resource: typeAndName(e.address), action: e.action });
1042
+ }
1043
+ const key = (r: PrMayAppearRow) => `${r.member}\u0000${r.component}\u0000${r.resource === undefined ? "" : `\u0001${r.resource}`}`;
1044
+ return rows.sort((a, b) => (key(a) < key(b) ? -1 : key(a) > key(b) ? 1 : 0));
1045
+ }
1046
+
1047
+ /**
1048
+ * The words of one may-appear row's last cell. `apply` is the product's word
1049
+ * for the apply (a fixed slot, #4550): plywood's is `up`.
1050
+ */
1051
+ export function prMayAppearText(row: PrMayAppearRow, apply = "apply"): string {
1052
+ if (row.resource === undefined) return `may register at ${apply}`;
1053
+ if (row.action === "delete") return `planned to delete, and may register again at ${apply}`;
1054
+ return `missing from the preview, and may register at ${apply}`;
1055
+ }
1056
+
1057
+ /**
1058
+ * The may-appear lines of the note (#4548): a row per `mayAppear` entry,
1059
+ * naming the component resource that registers it.
1060
+ */
1061
+ function mayAppearLines(report: PrReport, apply: string): string[] {
1062
+ const rows = prMayAppearRows(report.changeSet);
1063
+ if (rows.length === 0) return [];
1064
+ const out = [
1065
+ "",
1066
+ `Registered inside an \`apply()\` the preview could not run, so known only at ${apply}:`,
1067
+ "",
1068
+ "| Member | Component resource | Resource | At " + apply + " |",
1069
+ "|---|---|---|---|",
1070
+ ];
1071
+ for (const r of rows) out.push(`| ${code(r.member)} | ${code(r.component)} | ${r.resource === undefined ? "any resource it registers" : code(r.resource)} | ${prMayAppearText(r, apply)} |`);
1072
+ return out;
1073
+ }
1074
+
792
1075
  /**
793
1076
  * The pull-request note: the stage's headline, a row per member, the digest
794
1077
  * and the approval, then the grouped plan summary (#3188) in whatever room
795
1078
  * `limit` leaves. The note starts with {@link prNoteMarker}, so the same
796
- * comment is updated by every push and by the apply.
1079
+ * comment is updated by every push and by the apply. `applyWord` is the
1080
+ * product's word for the apply in the may-appear rows (#4548), `apply` by
1081
+ * default.
797
1082
  */
798
- export function renderPrNote(report: PrReport, options: { limit?: number; approver?: string } = {}): string {
1083
+ export function renderPrNote(report: PrReport, options: { limit?: number; approver?: string; applyWord?: string; words?: CiProductWords } = {}): string {
799
1084
  const limit = options.limit ?? GITHUB_COMMENT_LIMIT;
1085
+ // #4550: the product's words in chant's sentences (ruling D: fixed slots).
1086
+ const words = options.words ?? activeProductWords();
1087
+ const STATUS_WORDS = statusWords(words);
1088
+ const noun = words.noun[0];
800
1089
  const out: string[] = [
801
1090
  prNoteMarker(report.env, report.member),
802
- `### chant ${report.stage} for ${code(report.env)}${report.member ? ` in member ${code(report.member)}` : ""}`,
1091
+ `### ${words.product} ${words.stages[report.stage]} for ${code(report.env)}${report.member ? ` in ${noun} ${code(report.member)}` : ""}`,
803
1092
  "",
804
- `${headline(report)} Head ${code(short(report.head))}, measured from ${code(short(report.base))}.`,
1093
+ `${headline(report, words)} Head ${code(short(report.head))}, measured from ${code(short(report.base))}.`,
805
1094
  ];
806
1095
  if (report.message) out.push("", `> ${report.message.split("\n").join("\n> ")}`);
807
1096
  for (const o of report.overdue ?? []) out.push("", `Warning: ${o.message}`);
@@ -809,7 +1098,7 @@ export function renderPrNote(report: PrReport, options: { limit?: number; approv
809
1098
  out.push("", `Resumed under the same approval: ${report.resumed.applied.map(code).join(", ")} applied in an earlier attempt and did not run again.`);
810
1099
  }
811
1100
  if (report.members.length > 0) {
812
- out.push("", "| Member | Component | Status | Create | Update | Replace | Delete |", "|---|---|---|---:|---:|---:|---:|");
1101
+ out.push("", `| ${capital(noun)} | Component | Status | Create | Update | Replace | Delete |`, "|---|---|---|---:|---:|---:|---:|");
813
1102
  for (const m of report.members) {
814
1103
  const holes = memberHoleReasons(report, m.member);
815
1104
  // #4463: a member planned with stand-in values says so, naming them.
@@ -828,13 +1117,15 @@ export function renderPrNote(report: PrReport, options: { limit?: number; approv
828
1117
  out.push(`| ${code(m.member)} | ${m.component} | ${status} | ${n("create")} | ${n("update")} | ${n("replace")} | ${n("delete")} |`);
829
1118
  }
830
1119
  if (report.members.some((m) => m.inputsMoved?.length)) {
831
- out.push("", "A member whose inputs moved applied the plan it was approved with. The next run plans it against the new values.");
1120
+ out.push("", `A ${noun} whose inputs moved ${words.verbs.apply[1]} the plan it was approved with. The next run plans it against the new values.`);
832
1121
  }
833
1122
  }
1123
+ out.push(...mayAppearLines(report, options.applyWord ?? words.stages.apply));
834
1124
  const blocked = blockedLine(report.members);
835
1125
  if (blocked) out.push("", blocked);
1126
+ out.push(...crossStackLines(report));
836
1127
  out.push(...groupLines(report));
837
- out.push(...waveLines(report, options.approver ?? "<you>"));
1128
+ out.push(...waveLines(report, options.approver ?? "<you>", words));
838
1129
  // #4288: the hooks that did not pass, by name; a passed hook is a count.
839
1130
  const hooks = report.hooks ?? [];
840
1131
  if (hooks.length > 0) {
@@ -843,6 +1134,7 @@ export function renderPrNote(report: PrReport, options: { limit?: number; approv
843
1134
  out.push("", `Hooks: ${passed} passed${other.length > 0 ? `; ${other.join("; ")}` : ""}.`);
844
1135
  }
845
1136
  out.push(...policyLines(report));
1137
+ out.push(...capabilityPolicyLines(report, words));
846
1138
  out.push(...renderMigrationLines(report.migrations));
847
1139
  if (report.selection.unclaimed.length > 0) {
848
1140
  out.push("", `Changed, and deployed by no component: ${report.selection.unclaimed.map(code).join(", ")}.`);
@@ -883,28 +1175,55 @@ export function renderPrNote(report: PrReport, options: { limit?: number; approv
883
1175
  if (r.notCovered) out.push("", `Round ${r.round}'s plan is not covered by the approval of ${code(report.digest)}: ${r.notCovered}.`);
884
1176
  if (r.status === "waiting") {
885
1177
  if (r.message) out.push("", `> ${r.message}`);
886
- out.push("", `${what}. Not approved yet. Approve it, then run the apply again with the same \`--resume\` record:`, "", "```", prApproveCommand({ op: report.op, gate: r.gate, digest: r.digest }, options.approver ?? "<you>"), "```");
1178
+ out.push("", `${what}. Not approved yet. Approve it, then run the apply again with the same \`--resume\` record:`, "", "```", prApproveCommand({ op: report.op, gate: r.gate, digest: r.digest }, options.approver ?? "<you>", words), "```");
887
1179
  } else {
888
1180
  out.push("", `${what}: ${r.status === "applied" ? `applied, approved by ${(r.approval.approvedBy ?? []).map(code).join(", ")}` : r.status === "plan-failed" ? "a member failed to plan" : "the apply failed"}.`);
889
1181
  }
890
1182
  }
891
1183
  if (report.status !== "nothing") {
892
- out.push("", `Plan digest: ${code(report.digest)}`, "", ...approvalLines(report, options.approver ?? "<you>"));
1184
+ out.push("", `Plan digest: ${code(report.digest)}`, "", ...approvalLines(report, options.approver ?? "<you>", words));
893
1185
  }
894
1186
  // #4003: with a gate per wave, a later wave's plan on merge may differ from this one.
895
1187
  if (report.stage === "plan" && report.status === "planned" && report.waveGate) {
896
- out.push("", `On merge each wave after the first is planned again once the waves before it apply, and a wave whose plan moved stops at its own gate, ${code(`${report.waveGate}-wave-<k>`)}, for approval.`);
1188
+ out.push("", `On merge each wave after the first is planned again once the waves before it apply, and a wave whose plan moved stops at its own gate, ${code(words.gateName.replace("{gate}", report.waveGate).replace("{k}", "<k>"))}, for approval.`);
897
1189
  }
898
- const head = out.join("\n") + "\n";
1190
+ let head = out.join("\n") + "\n";
1191
+ // #4573: each member's lexicon-rendered section, kept within the comment limit with room left for the summary.
1192
+ head += memberDetailSections(report, limit - [...head].length - 400, noun);
899
1193
  if (report.status === "nothing" || report.changeSet.members.length === 0) return head;
900
1194
  const room = limit - [...head].length - 1;
901
1195
  if (room < 400) return head;
902
1196
  return head + "\n" + renderPlanSummaryMarkdown(groupChangeSet(report.changeSet), { limit: room, command: "chant change-set summary .chant/pr/change-set.json" });
903
1197
  }
904
1198
 
1199
+ /**
1200
+ * The member detail sections (#4573), each in a `<details>` block under the
1201
+ * member it belongs to. A section that does not fit in `room` is left out
1202
+ * and named, so the note stays within the forge's comment limit.
1203
+ */
1204
+ function memberDetailSections(report: PrReport, room: number, noun: string): string {
1205
+ const out: string[] = [];
1206
+ let used = 0;
1207
+ const left: string[] = [];
1208
+ for (const d of report.details ?? []) {
1209
+ if (d.lines.length === 0) continue;
1210
+ const block = ["", `<details><summary>${d.title ?? `${capital(noun)} ${code(d.member)}`}</summary>`, "", ...d.lines, "", "</details>"].join("\n");
1211
+ const size = [...block].length;
1212
+ if (used + size > room - 200) {
1213
+ left.push(d.member);
1214
+ continue;
1215
+ }
1216
+ used += size;
1217
+ out.push(block);
1218
+ }
1219
+ if (left.length > 0) out.push("", `Left out to keep this note within the comment limit: the detail of ${left.map(code).join(", ")}. The report artifact carries it.`);
1220
+ return out.length > 0 ? out.join("\n") + "\n" : "";
1221
+ }
1222
+
905
1223
  /** A commit status's description, at most 140 characters (GitHub's limit). */
906
- export function prStatusDescription(report: PrReport): string {
1224
+ export function prStatusDescription(report: PrReport, words: CiProductWords = activeProductWords()): string {
907
1225
  const n = report.members.length;
1226
+ const many = (k: number): string => `${k} ${words.noun[k === 1 ? 0 : 1]}`;
908
1227
  const sum = report.members.reduce(
909
1228
  (acc, m) => ({ change: acc.change + m.counts.create + m.counts.update + m.counts.replace, destroy: acc.destroy + m.counts.delete + m.counts.replace }),
910
1229
  { change: 0, destroy: 0 },
@@ -917,17 +1236,17 @@ export function prStatusDescription(report: PrReport): string {
917
1236
  break;
918
1237
  case "planned": {
919
1238
  const unknown = report.members.filter((m) => memberHoleReasons(report, m.member).length > 0).length;
920
- text = `${n} member${n === 1 ? "" : "s"}: ${sum.change} to change, ${sum.destroy} to destroy or replace${unknown > 0 ? `, ${unknown} with holes` : ""}${digest}`;
1239
+ text = `${many(n)}: ${sum.change} to change, ${sum.destroy} to destroy or replace${unknown > 0 ? `, ${unknown} with holes` : ""}${digest}`;
921
1240
  break;
922
1241
  }
923
1242
  case "plan-failed":
924
- text = `a member failed to plan${digest}`;
1243
+ text = `a ${words.noun[0]} failed to ${words.verbs.plan[0]}${digest}`;
925
1244
  break;
926
1245
  case "recorded":
927
- text = `recorded ${n} member${n === 1 ? "" : "s"}: ${report.approval.status === "approved" ? "the approved plan" : report.approval.status === "changed" ? "the plan differs from the approved one" : "no approval for this plan"}${digest}`;
1246
+ text = `recorded ${many(n)}: ${report.approval.status === "approved" ? "the approved plan" : report.approval.status === "changed" ? "the plan differs from the approved one" : "no approval for this plan"}${digest}`;
928
1247
  break;
929
1248
  case "applied":
930
- text = `applied ${n} member${n === 1 ? "" : "s"}${digest}`;
1249
+ text = `${words.verbs.apply[1]} ${many(n)}${digest}`;
931
1250
  break;
932
1251
  case "wave-applied": {
933
1252
  const last = (report.waves ?? []).filter((w) => w.status === "applied").at(-1);