@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/dist/pr-loop.js CHANGED
@@ -46,9 +46,11 @@
46
46
  * contexts carry the member's name. The gate name stays the same, so one
47
47
  * `identity.gates` entry covers every member.
48
48
  */
49
+ import { NEXT_RELEASE } from "./release-floors.js";
50
+ import { parsePulumiUrn, pulumiMayAppearParent } from "./pulumi-urn.js";
49
51
  import { renderMigrationLines } from "./pr-migrations.js";
50
52
  import { GITHUB_COMMENT_LIMIT, groupChangeSet, renderPlanSummaryMarkdown } from "./plan-summary.js";
51
- import { NEXT_RELEASE } from "./release-floors.js";
53
+ import { activeProductWords, approveLine, commentLine, isChantWords, overrideLine, productStatusContext } from "./ci-product-words.js";
52
54
  /** The schema a pull-request report names in `$schema`. */
53
55
  export const PR_REPORT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/pr-report/v1/pr-report.schema.json";
54
56
  /** The read-contract version the report follows. */
@@ -78,9 +80,13 @@ export const PR_REPORT_MIGRATIONS_FLOOR = "0.124.49";
78
80
  /** The first chant whose report can carry a member's `reads`, known at plan or not. */
79
81
  export const PR_REPORT_READS_FLOOR = "0.124.52";
80
82
  /** The first chant whose report can carry the `not-started` member status (ws-107, #4440). */
81
- export const PR_REPORT_NOT_STARTED_FLOOR = NEXT_RELEASE;
83
+ export const PR_REPORT_NOT_STARTED_FLOOR = "0.124.54";
82
84
  /** The first chant whose report can carry `groups`, `fallbacks`, and a member's `group` and `groupOutcome` (ws-107, #4446). */
83
- export const PR_REPORT_GROUPS_FLOOR = NEXT_RELEASE;
85
+ export const PR_REPORT_GROUPS_FLOOR = "0.124.54";
86
+ /** The first chant whose report can carry `lockTargets` (#4552). */
87
+ export const PR_REPORT_LOCK_TARGETS_FLOOR = NEXT_RELEASE;
88
+ /** The first chant whose report carries {@link PrReport.crossStackEdges} (#4617). */
89
+ export const PR_REPORT_CROSS_STACK_FLOOR = NEXT_RELEASE;
84
90
  /** The gate a pull request's apply waits on, unless the pipeline names another. */
85
91
  export const PR_APPLY_GATE = "pr-apply";
86
92
  /**
@@ -107,8 +113,14 @@ export function prNoteMarker(env, member) {
107
113
  }
108
114
  /** The status contexts the stages set on the commit. */
109
115
  export const PR_STATUS_CONTEXTS = { plan: "chant/plan", apply: "chant/apply", record: "chant/record" };
110
- /** A stage's status context: `chant/plan`, or `chant/plan/<member>` for a workspace member's pipeline. */
111
- export function prStatusContext(stage, member) {
116
+ /**
117
+ * A stage's status context: `chant/plan`, or `chant/plan/<member>` for a
118
+ * workspace member's pipeline. Under a product's words (#4550) the prefix and
119
+ * the stage word are the product's: `plywood/preview/shop-dev`.
120
+ */
121
+ export function prStatusContext(stage, member, words = activeProductWords()) {
122
+ if (!isChantWords(words))
123
+ return productStatusContext(words, stage, member);
112
124
  return member ? `${PR_STATUS_CONTEXTS[stage]}/${member}` : PR_STATUS_CONTEXTS[stage];
113
125
  }
114
126
  /** The counts a member's entries add up to. */
@@ -127,46 +139,82 @@ export function memberHoleReasons(report, member) {
127
139
  const m = report.changeSet.members.find((x) => x.member === member);
128
140
  return [...new Set((m?.holes ?? []).map((h) => h.reason))];
129
141
  }
130
- /** The approve command a reviewer runs for this report's digest. */
131
- export function prApproveCommand(report, approver = "<you>") {
142
+ /**
143
+ * The approve command a reviewer runs for this report's digest: the product's
144
+ * approve line under its words (#4550). `target` fills the template's
145
+ * `{target}` (#4601): the member the line approves, such as sql-yodeler's
146
+ * environment.
147
+ */
148
+ export function prApproveCommand(report, approver = "<you>", words = activeProductWords()) {
149
+ if (!isChantWords(words))
150
+ return approveLine(words, { op: report.op, gate: report.gate, digest: report.digest, approver, sign: true, ...(report.target !== undefined ? { target: report.target } : {}) });
132
151
  return `chant approve ${report.op} ${report.gate} --plan ${report.digest} --approver ${approver} --sign`;
133
152
  }
153
+ /**
154
+ * The targets the product's approve line names (#4601), one line each: none
155
+ * when its template has no `{target}`; else the workspace member the report
156
+ * is for, else each member in the report, else the environment.
157
+ */
158
+ export function prApproveTargets(report, words = activeProductWords()) {
159
+ if (!words.approve.includes("{target}"))
160
+ return [];
161
+ if (report.member)
162
+ return [report.member];
163
+ const names = [...new Set((report.members ?? []).map((m) => m.member))];
164
+ return names.length > 0 ? names : [report.env];
165
+ }
166
+ /** Every approve command the report asks for: one per {@link prApproveTargets}, or the one line when the template names no target. */
167
+ export function prApproveCommands(report, approver = "<you>", words = activeProductWords()) {
168
+ const targets = prApproveTargets(report, words);
169
+ if (targets.length === 0)
170
+ return [prApproveCommand(report, approver, words)];
171
+ return targets.map((target) => prApproveCommand({ op: report.op, gate: report.gate, digest: report.digest, target }, approver, words));
172
+ }
134
173
  /**
135
174
  * The refusal when the approved digest is not the planned one: both digests,
136
175
  * that nothing applied, and how to close it.
137
176
  */
138
177
  export function describePlanChanged(report) {
178
+ const approve = report.env !== undefined ? prApproveCommands({ ...report, env: report.env }).join("; ") : prApproveCommand(report);
139
179
  return (`The plan changed after review, so nothing was applied. ` +
140
180
  `approved: ${report.approval.approved ?? "(none)"}; planned now: ${report.digest}. ` +
141
- `Read the new plan, and if it is right, approve it: ${prApproveCommand(report)}; then run the apply again.`);
181
+ `Read the new plan, and if it is right, approve it: ${approve}; then run the apply again.`);
142
182
  }
143
183
  const short = (sha) => sha.slice(0, 12);
144
184
  const code = (s) => "`" + s.replaceAll("`", "'") + "`";
145
- const STATUS_WORDS = {
146
- planned: "planned",
147
- "plan-failed": "plan failed",
148
- applied: "applied",
149
- failed: "apply failed",
150
- blocked: "blocked",
151
- waiting: "waiting on its new plan",
152
- "not-started": "not started",
153
- };
154
- function headline(report) {
185
+ /** A member's status in the note, in the product's verbs (#4550): chant's `planned`, plywood's `previewed`. */
186
+ function statusWords(words) {
187
+ const [plan, planned] = words.verbs.plan;
188
+ const [apply, applied] = words.verbs.apply;
189
+ return {
190
+ planned,
191
+ "plan-failed": `${plan} failed`,
192
+ applied,
193
+ failed: `${apply} failed`,
194
+ blocked: "blocked",
195
+ waiting: "waiting on its new plan",
196
+ "not-started": "not started",
197
+ };
198
+ }
199
+ const capital = (w) => w.charAt(0).toUpperCase() + w.slice(1);
200
+ function headline(report, words) {
155
201
  const n = report.members.length;
156
- const members = `${n} member${n === 1 ? "" : "s"}`;
202
+ const members = `${n} ${words.noun[n === 1 ? 0 : 1]}`;
203
+ const [plan, planned] = words.verbs.plan;
204
+ const applied = words.verbs.apply[1];
157
205
  switch (report.status) {
158
206
  case "nothing":
159
- return "Nothing to plan: no component deploys what this change touches.";
207
+ return `Nothing to ${plan}: no component deploys what this change touches.`;
160
208
  case "planned":
161
- return `Planned ${members}.`;
209
+ return `${capital(planned)} ${members}.`;
162
210
  case "recorded":
163
211
  return `Recorded the plan of ${members} on merge. Nothing applied: a release that carries this commit deploys it.`;
164
212
  case "plan-failed":
165
213
  if (report.hooks?.some((h) => h.outcome === "failed"))
166
214
  return "A hook failed, so nothing can apply.";
167
- return `Planning failed for ${report.members.filter((m) => m.status === "plan-failed").length} of ${members}, so nothing can apply.`;
215
+ return `${isChantWords(words) ? "Planning" : `The ${plan}`} failed for ${report.members.filter((m) => m.status === "plan-failed").length} of ${members}, so nothing can apply.`;
168
216
  case "applied":
169
- return `Applied ${members}.`;
217
+ return `${capital(applied)} ${members}.`;
170
218
  case "failed": {
171
219
  const blocked = report.members.filter((m) => m.status === "blocked").length;
172
220
  const notStarted = report.members.filter((m) => m.status === "not-started").length;
@@ -175,14 +223,14 @@ function headline(report) {
175
223
  case "wave-applied": {
176
224
  const applied = (report.waves ?? []).filter((w) => w.status === "applied").map((w) => w.wave);
177
225
  const total = report.selection.waves.length;
178
- return `Applied wave ${applied.at(-1) ?? "?"} of ${total}. The next wave runs in its own job.`;
226
+ return `${capital(words.verbs.apply[1])} wave ${applied.at(-1) ?? "?"} of ${total}. The next wave runs in its own job.`;
179
227
  }
180
228
  case "refused": {
181
229
  const waiting = report.waves?.find((w) => w.status === "waiting");
182
230
  return waiting ? `Wave ${waiting.wave} waits at its gate ${code(waiting.gate)}; nothing in it applied.` : "The apply refused.";
183
231
  }
184
232
  case "waiting":
185
- 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.`;
233
+ 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.`;
186
234
  }
187
235
  }
188
236
  /**
@@ -190,6 +238,27 @@ function headline(report) {
190
238
  * component that failed, and that the rest went on. Undefined when nothing
191
239
  * is blocked.
192
240
  */
241
+ /**
242
+ * The cross-stack edges (#4617): a table of each stack outside the
243
+ * workspace a member reads, its owner and its mark, and a line naming the
244
+ * stale ones, whose reader holds outputs that may have changed since.
245
+ */
246
+ function crossStackLines(report) {
247
+ const edges = report.crossStackEdges ?? [];
248
+ if (edges.length === 0)
249
+ return [];
250
+ const day = (iso) => (iso ? iso.replace(/\.\d+Z$/, "Z") : "never");
251
+ const out = ["", "| Reader | Reads stack | Owner | Edge | Why |", "|---|---|---|---|---|"];
252
+ for (const e of edges) {
253
+ 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;
254
+ out.push(`| ${code(e.member)} | ${code(e.stack)} | ${e.owner ? code(e.owner) : "?"} | ${e.status} | ${why} |`);
255
+ }
256
+ const stale = edges.filter((e) => e.status === "stale");
257
+ if (stale.length > 0) {
258
+ 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.`);
259
+ }
260
+ return out;
261
+ }
193
262
  function blockedLine(members) {
194
263
  const byRoot = new Map();
195
264
  for (const m of members) {
@@ -266,6 +335,33 @@ function policyLines(report) {
266
335
  out.push(`Policy warnings: ${p.warnings.join("; ")}`);
267
336
  return out;
268
337
  }
338
+ /**
339
+ * The findings capabilities' plans carried (#4550), in the product's words:
340
+ * a denial with the product's override line, then each advisory finding as
341
+ * a row.
342
+ */
343
+ function capabilityPolicyLines(report, words) {
344
+ const all = report.capabilityPolicy ?? [];
345
+ if (all.length === 0)
346
+ return [];
347
+ const out = [];
348
+ for (const p of all.filter((x) => x.denied)) {
349
+ 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}`));
350
+ if (p.denials.length > 0)
351
+ 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) }))}`);
352
+ }
353
+ const rows = all.flatMap((p) => [
354
+ ...(p.denied ? [] : p.denials).map((d) => [p.member, d.rule, "denied", d.message]),
355
+ ...p.holds.map((d) => [p.member, d.rule, "advisory", d.message]),
356
+ ...p.warnings.map((w) => [p.member, "", "warning", w]),
357
+ ]);
358
+ if (rows.length > 0) {
359
+ out.push("", `| ${capital(words.noun[0])} | Rule | Finding | Message |`, "|---|---|---|---|");
360
+ for (const [m, rule, kind, message] of rows)
361
+ out.push(`| ${code(m)} | ${rule ? code(rule) : ""} | ${kind} | ${message.replaceAll("|", "\\|").replaceAll("\n", " ")} |`);
362
+ }
363
+ return out;
364
+ }
269
365
  /** Who a wave applied or waits under, as a table cell. */
270
366
  function waveApproval(w) {
271
367
  const whose = w.approval === "pull-request" ? "the pull request's" : "its own";
@@ -277,7 +373,7 @@ function waveApproval(w) {
277
373
  * saying which approval it applied under, then for a wave that waits the
278
374
  * reason its plan moved and the approve command for its new plan.
279
375
  */
280
- function waveLines(report, approver) {
376
+ function waveLines(report, approver, words) {
281
377
  const waves = report.waves ?? [];
282
378
  if (waves.length === 0)
283
379
  return [];
@@ -290,11 +386,41 @@ function waveLines(report, approver) {
290
386
  out.push(`- ${why}`);
291
387
  if (w.approved)
292
388
  out.push("", `An approval of ${code(w.gate)} stands for ${code(w.approved)}, not for the plan now.`);
293
- out.push("", `Read wave ${w.wave}'s plan, ${code(w.digest)}, and approve it with:`, "", "```", prApproveCommand({ op: report.op, gate: w.gate, digest: w.digest }, approver), "```", "", "Then run the wave's apply job again.");
389
+ out.push("", `Read wave ${w.wave}'s plan, ${code(w.digest)}, and approve it with:`, "", "```", ...waveApproveCommands(report, w, approver, words), "```", "", "Then run the wave's apply job again.");
294
390
  }
295
391
  return out;
296
392
  }
297
- function approvalLines(report, approver) {
393
+ /** A waiting wave's approve lines: one per component when the product's template names `{target}` (#4601). */
394
+ function waveApproveCommands(report, w, approver, words) {
395
+ const targets = words.approve.includes("{target}") ? (w.components.length > 0 ? w.components : [report.env]) : [];
396
+ if (targets.length === 0)
397
+ return [prApproveCommand({ op: report.op, gate: w.gate, digest: w.digest }, approver, words)];
398
+ return targets.map((target) => prApproveCommand({ op: report.op, gate: w.gate, digest: w.digest, target }, approver, words));
399
+ }
400
+ /**
401
+ * The note's sentence on what the merge does with the plan (#4601), by the
402
+ * product's apply mode. chant's words keep chant's sentence, which covers
403
+ * the record on merge and the opt-in apply on merge alike.
404
+ */
405
+ export function prMergeSentence(report, words = activeProductWords()) {
406
+ const applied = words.verbs.apply[1];
407
+ switch (words.applyMode) {
408
+ case "on-merge": {
409
+ if (words.approval === "per-wave") {
410
+ 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.`;
411
+ }
412
+ const waveGate = words.gateName.replace("{gate}", report.gate).replace("{k}", "<k>");
413
+ 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.`;
414
+ }
415
+ case "before-merge": {
416
+ const comment = commentLine(words, "apply");
417
+ 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}.`;
418
+ }
419
+ case "release":
420
+ 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.";
421
+ }
422
+ }
423
+ function approvalLines(report, approver, words) {
298
424
  const a = report.approval;
299
425
  if (report.status === "nothing")
300
426
  return [];
@@ -304,23 +430,105 @@ function approvalLines(report, approver) {
304
430
  ? [`An approval stands for ${code(a.approved ?? "(none)")}, not for this digest: the plan changed since it was approved.`]
305
431
  : [report.stage === "record" ? "No approval stands for this plan. The release gate decides before it deploys." : "Not approved yet."];
306
432
  if (report.stage === "plan" && report.status === "planned") {
307
- lines.push("", "A reviewer who approved this pull request approves the plan with:", "", "```", prApproveCommand(report, approver), "```", "", "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.");
433
+ const commands = prApproveCommands(report, approver, words);
434
+ lines.push("", 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:", "", "```", ...commands, "```", "", prMergeSentence(report, words));
308
435
  }
309
436
  return lines;
310
437
  }
438
+ const typeAndName = (urn) => {
439
+ const p = parsePulumiUrn(urn);
440
+ return p ? `${p.type} ${p.name}` : urn;
441
+ };
442
+ /**
443
+ * The note's rows for the `mayAppear` entries of a change set, sorted by
444
+ * member and component. A stand-in entry (`pulumiMayAppearAddress`) names its
445
+ * component from its own address. Any other entry names the component whose
446
+ * stand-in entry in the same member sits on its parent type chain, when one
447
+ * does; else the type of its parent.
448
+ */
449
+ export function prMayAppearRows(doc) {
450
+ const flagged = new Map();
451
+ for (const e of doc.entries) {
452
+ if (e.mayAppear !== true)
453
+ continue;
454
+ const parent = pulumiMayAppearParent(e.address);
455
+ const parsed = parent ? parsePulumiUrn(parent) : undefined;
456
+ if (!parent || !parsed)
457
+ continue;
458
+ flagged.set(e.member, [...(flagged.get(e.member) ?? []), { urn: parent, chain: parsed.qualifiedType }]);
459
+ }
460
+ const componentOf = (e) => {
461
+ const parsed = parsePulumiUrn(e.address);
462
+ if (!parsed)
463
+ return "the stack";
464
+ const parents = parsed.parentTypes.join("$");
465
+ const under = (flagged.get(e.member) ?? []).filter((c) => parents === c.chain || parents.startsWith(`${c.chain}$`));
466
+ // The nearest component: the longest chain that holds the entry.
467
+ const longest = Math.max(-1, ...under.map((c) => c.chain.length));
468
+ const nearest = under.filter((c) => c.chain.length === longest);
469
+ if (nearest.length === 1)
470
+ return typeAndName(nearest[0].urn);
471
+ return parsed.parentTypes.at(-1) ?? "the stack";
472
+ };
473
+ const rows = [];
474
+ for (const e of doc.entries) {
475
+ if (e.mayAppear !== true)
476
+ continue;
477
+ const parent = pulumiMayAppearParent(e.address);
478
+ 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 });
479
+ }
480
+ const key = (r) => `${r.member}\u0000${r.component}\u0000${r.resource === undefined ? "" : `\u0001${r.resource}`}`;
481
+ return rows.sort((a, b) => (key(a) < key(b) ? -1 : key(a) > key(b) ? 1 : 0));
482
+ }
483
+ /**
484
+ * The words of one may-appear row's last cell. `apply` is the product's word
485
+ * for the apply (a fixed slot, #4550): plywood's is `up`.
486
+ */
487
+ export function prMayAppearText(row, apply = "apply") {
488
+ if (row.resource === undefined)
489
+ return `may register at ${apply}`;
490
+ if (row.action === "delete")
491
+ return `planned to delete, and may register again at ${apply}`;
492
+ return `missing from the preview, and may register at ${apply}`;
493
+ }
494
+ /**
495
+ * The may-appear lines of the note (#4548): a row per `mayAppear` entry,
496
+ * naming the component resource that registers it.
497
+ */
498
+ function mayAppearLines(report, apply) {
499
+ const rows = prMayAppearRows(report.changeSet);
500
+ if (rows.length === 0)
501
+ return [];
502
+ const out = [
503
+ "",
504
+ `Registered inside an \`apply()\` the preview could not run, so known only at ${apply}:`,
505
+ "",
506
+ "| Member | Component resource | Resource | At " + apply + " |",
507
+ "|---|---|---|---|",
508
+ ];
509
+ for (const r of rows)
510
+ out.push(`| ${code(r.member)} | ${code(r.component)} | ${r.resource === undefined ? "any resource it registers" : code(r.resource)} | ${prMayAppearText(r, apply)} |`);
511
+ return out;
512
+ }
311
513
  /**
312
514
  * The pull-request note: the stage's headline, a row per member, the digest
313
515
  * and the approval, then the grouped plan summary (#3188) in whatever room
314
516
  * `limit` leaves. The note starts with {@link prNoteMarker}, so the same
315
- * comment is updated by every push and by the apply.
517
+ * comment is updated by every push and by the apply. `applyWord` is the
518
+ * product's word for the apply in the may-appear rows (#4548), `apply` by
519
+ * default.
316
520
  */
317
521
  export function renderPrNote(report, options = {}) {
318
522
  const limit = options.limit ?? GITHUB_COMMENT_LIMIT;
523
+ // #4550: the product's words in chant's sentences (ruling D: fixed slots).
524
+ const words = options.words ?? activeProductWords();
525
+ const STATUS_WORDS = statusWords(words);
526
+ const noun = words.noun[0];
319
527
  const out = [
320
528
  prNoteMarker(report.env, report.member),
321
- `### chant ${report.stage} for ${code(report.env)}${report.member ? ` in member ${code(report.member)}` : ""}`,
529
+ `### ${words.product} ${words.stages[report.stage]} for ${code(report.env)}${report.member ? ` in ${noun} ${code(report.member)}` : ""}`,
322
530
  "",
323
- `${headline(report)} Head ${code(short(report.head))}, measured from ${code(short(report.base))}.`,
531
+ `${headline(report, words)} Head ${code(short(report.head))}, measured from ${code(short(report.base))}.`,
324
532
  ];
325
533
  if (report.message)
326
534
  out.push("", `> ${report.message.split("\n").join("\n> ")}`);
@@ -330,7 +538,7 @@ export function renderPrNote(report, options = {}) {
330
538
  out.push("", `Resumed under the same approval: ${report.resumed.applied.map(code).join(", ")} applied in an earlier attempt and did not run again.`);
331
539
  }
332
540
  if (report.members.length > 0) {
333
- out.push("", "| Member | Component | Status | Create | Update | Replace | Delete |", "|---|---|---|---:|---:|---:|---:|");
541
+ out.push("", `| ${capital(noun)} | Component | Status | Create | Update | Replace | Delete |`, "|---|---|---|---:|---:|---:|---:|");
334
542
  for (const m of report.members) {
335
543
  const holes = memberHoleReasons(report, m.member);
336
544
  // #4463: a member planned with stand-in values says so, naming them.
@@ -348,14 +556,16 @@ export function renderPrNote(report, options = {}) {
348
556
  out.push(`| ${code(m.member)} | ${m.component} | ${status} | ${n("create")} | ${n("update")} | ${n("replace")} | ${n("delete")} |`);
349
557
  }
350
558
  if (report.members.some((m) => m.inputsMoved?.length)) {
351
- out.push("", "A member whose inputs moved applied the plan it was approved with. The next run plans it against the new values.");
559
+ 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.`);
352
560
  }
353
561
  }
562
+ out.push(...mayAppearLines(report, options.applyWord ?? words.stages.apply));
354
563
  const blocked = blockedLine(report.members);
355
564
  if (blocked)
356
565
  out.push("", blocked);
566
+ out.push(...crossStackLines(report));
357
567
  out.push(...groupLines(report));
358
- out.push(...waveLines(report, options.approver ?? "<you>"));
568
+ out.push(...waveLines(report, options.approver ?? "<you>", words));
359
569
  // #4288: the hooks that did not pass, by name; a passed hook is a count.
360
570
  const hooks = report.hooks ?? [];
361
571
  if (hooks.length > 0) {
@@ -364,6 +574,7 @@ export function renderPrNote(report, options = {}) {
364
574
  out.push("", `Hooks: ${passed} passed${other.length > 0 ? `; ${other.join("; ")}` : ""}.`);
365
575
  }
366
576
  out.push(...policyLines(report));
577
+ out.push(...capabilityPolicyLines(report, words));
367
578
  out.push(...renderMigrationLines(report.migrations));
368
579
  if (report.selection.unclaimed.length > 0) {
369
580
  out.push("", `Changed, and deployed by no component: ${report.selection.unclaimed.map(code).join(", ")}.`);
@@ -400,20 +611,22 @@ export function renderPrNote(report, options = {}) {
400
611
  if (r.status === "waiting") {
401
612
  if (r.message)
402
613
  out.push("", `> ${r.message}`);
403
- 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>"), "```");
614
+ 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), "```");
404
615
  }
405
616
  else {
406
617
  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"}.`);
407
618
  }
408
619
  }
409
620
  if (report.status !== "nothing") {
410
- out.push("", `Plan digest: ${code(report.digest)}`, "", ...approvalLines(report, options.approver ?? "<you>"));
621
+ out.push("", `Plan digest: ${code(report.digest)}`, "", ...approvalLines(report, options.approver ?? "<you>", words));
411
622
  }
412
623
  // #4003: with a gate per wave, a later wave's plan on merge may differ from this one.
413
624
  if (report.stage === "plan" && report.status === "planned" && report.waveGate) {
414
- 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.`);
625
+ 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.`);
415
626
  }
416
- const head = out.join("\n") + "\n";
627
+ let head = out.join("\n") + "\n";
628
+ // #4573: each member's lexicon-rendered section, kept within the comment limit with room left for the summary.
629
+ head += memberDetailSections(report, limit - [...head].length - 400, noun);
417
630
  if (report.status === "nothing" || report.changeSet.members.length === 0)
418
631
  return head;
419
632
  const room = limit - [...head].length - 1;
@@ -421,9 +634,35 @@ export function renderPrNote(report, options = {}) {
421
634
  return head;
422
635
  return head + "\n" + renderPlanSummaryMarkdown(groupChangeSet(report.changeSet), { limit: room, command: "chant change-set summary .chant/pr/change-set.json" });
423
636
  }
637
+ /**
638
+ * The member detail sections (#4573), each in a `<details>` block under the
639
+ * member it belongs to. A section that does not fit in `room` is left out
640
+ * and named, so the note stays within the forge's comment limit.
641
+ */
642
+ function memberDetailSections(report, room, noun) {
643
+ const out = [];
644
+ let used = 0;
645
+ const left = [];
646
+ for (const d of report.details ?? []) {
647
+ if (d.lines.length === 0)
648
+ continue;
649
+ const block = ["", `<details><summary>${d.title ?? `${capital(noun)} ${code(d.member)}`}</summary>`, "", ...d.lines, "", "</details>"].join("\n");
650
+ const size = [...block].length;
651
+ if (used + size > room - 200) {
652
+ left.push(d.member);
653
+ continue;
654
+ }
655
+ used += size;
656
+ out.push(block);
657
+ }
658
+ if (left.length > 0)
659
+ out.push("", `Left out to keep this note within the comment limit: the detail of ${left.map(code).join(", ")}. The report artifact carries it.`);
660
+ return out.length > 0 ? out.join("\n") + "\n" : "";
661
+ }
424
662
  /** A commit status's description, at most 140 characters (GitHub's limit). */
425
- export function prStatusDescription(report) {
663
+ export function prStatusDescription(report, words = activeProductWords()) {
426
664
  const n = report.members.length;
665
+ const many = (k) => `${k} ${words.noun[k === 1 ? 0 : 1]}`;
427
666
  const sum = report.members.reduce((acc, m) => ({ change: acc.change + m.counts.create + m.counts.update + m.counts.replace, destroy: acc.destroy + m.counts.delete + m.counts.replace }), { change: 0, destroy: 0 });
428
667
  const digest = report.digest ? `; plan ${report.digest.replace(/^(?:jcs1-)?sha256:/, "").slice(0, 12)}` : "";
429
668
  let text;
@@ -433,17 +672,17 @@ export function prStatusDescription(report) {
433
672
  break;
434
673
  case "planned": {
435
674
  const unknown = report.members.filter((m) => memberHoleReasons(report, m.member).length > 0).length;
436
- text = `${n} member${n === 1 ? "" : "s"}: ${sum.change} to change, ${sum.destroy} to destroy or replace${unknown > 0 ? `, ${unknown} with holes` : ""}${digest}`;
675
+ text = `${many(n)}: ${sum.change} to change, ${sum.destroy} to destroy or replace${unknown > 0 ? `, ${unknown} with holes` : ""}${digest}`;
437
676
  break;
438
677
  }
439
678
  case "plan-failed":
440
- text = `a member failed to plan${digest}`;
679
+ text = `a ${words.noun[0]} failed to ${words.verbs.plan[0]}${digest}`;
441
680
  break;
442
681
  case "recorded":
443
- 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}`;
682
+ 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}`;
444
683
  break;
445
684
  case "applied":
446
- text = `applied ${n} member${n === 1 ? "" : "s"}${digest}`;
685
+ text = `${words.verbs.apply[1]} ${many(n)}${digest}`;
447
686
  break;
448
687
  case "wave-applied": {
449
688
  const last = (report.waves ?? []).filter((w) => w.status === "applied").at(-1);
package/dist/pr-post.d.ts CHANGED
@@ -23,6 +23,8 @@
23
23
  */
24
24
  import { type PrOverdue, type PrReport } from "./pr-loop.js";
25
25
  import { type PrForge } from "./pr-forge.js";
26
+ import { type CiProductWords } from "./ci-product-words.js";
27
+ import { type ControlEdgeFacts } from "./control/edges.js";
26
28
  /** The plan report's file under the report directory. */
27
29
  export declare const PR_PLAN_REPORT_FILE = "pr-plan.json";
28
30
  /** What {@link postPlanReport} posts for. */
@@ -43,6 +45,12 @@ export interface PlanPostInput {
43
45
  * job held no token to ask with. It replaces any `overdue` in the report.
44
46
  */
45
47
  overdue?: () => Promise<PrOverdue[]>;
48
+ /**
49
+ * The control repo's entries and apply records (#4617), which mark the
50
+ * report's cross-stack edges stale, current or unknown. Default: read
51
+ * from the checkout `CHANT_CONTROL_DIR` names, when it names one.
52
+ */
53
+ controlFacts?: () => Promise<ControlEdgeFacts | undefined>;
46
54
  }
47
55
  /** What {@link postPlanReport} did. */
48
56
  export interface PlanPostResult {
@@ -75,6 +83,14 @@ export declare function planNoteFor(report: PrReport, forge: Pick<PrForge, "kind
75
83
  * the caller's sets a failed status and posts no note.
76
84
  */
77
85
  export declare function postPlanReport(input: PlanPostInput): Promise<PlanPostResult>;
86
+ /**
87
+ * Post the plan note, or update it. Under a product's words that carry
88
+ * `adoptMarkers` (#4550), a pull request with no chant note yet but a note the
89
+ * product posted before it moved onto chant's pipeline gets that note
90
+ * updated, with the old marker kept at its end, so the pull request keeps one
91
+ * note across the switch.
92
+ */
93
+ export declare function upsertPlanNote(forge: Pick<PrForge, "upsertNote" | "findComment" | "upsertComment">, pr: number, marker: string, note: string, words?: CiProductWords): Promise<void>;
78
94
  /** What {@link postOpenPlanReports} posts for. */
79
95
  export interface OpenPlanPostInput {
80
96
  /** A GitLab client with {@link PrForge.mergeRequestJobs}, {@link PrForge.jobArtifact} and {@link PrForge.statusUrl}. */
@@ -1 +1 @@
1
- {"version":3,"file":"pr-post.d.ts","sourceRoot":"","sources":["../src/pr-post.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,EAAmF,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3I,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG5D,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACtC;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,KAAK,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAoB/I;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ3G;AAID;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAkDlF;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,wHAAwH;IACxH,KAAK,EAAE,OAAO,CAAC;IACf,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,8FAA8F;IAC9F,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACtC;AAED,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,0GAA0G;IAC1G,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA6C1H"}
1
+ {"version":3,"file":"pr-post.d.ts","sourceRoot":"","sources":["../src/pr-post.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,EAAmF,KAAK,SAAS,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3I,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAkD,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExG,yDAAyD;AACzD,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;CAC5D;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,KAAK,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAoB/I;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQ3G;AAID;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAuDlF;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,GAAG,eAAe,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,cAAqC,GAAG,OAAO,CAAC,IAAI,CAAC,CAShN;AAED,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,wHAAwH;IACxH,KAAK,EAAE,OAAO,CAAC;IACf,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,8FAA8F;IAC9F,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACtC;AAED,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,0GAA0G;IAC1G,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA6C1H"}
package/dist/pr-post.js CHANGED
@@ -27,6 +27,8 @@ import { join } from "node:path";
27
27
  import { prNoteMarker, prStatusContext, prStatusDescription, prStatusState, renderPrNote } from "./pr-loop.js";
28
28
  import { forgePrincipalOf } from "./pr-forge.js";
29
29
  import { GITHUB_COMMENT_LIMIT, GITLAB_NOTE_LIMIT } from "./plan-summary.js";
30
+ import { activeProductWords } from "./ci-product-words.js";
31
+ import { controlEdgeFactsFromEnv, remarkCrossStackEdges } from "./control/edges.js";
30
32
  /** The plan report's file under the report directory. */
31
33
  export const PR_PLAN_REPORT_FILE = "pr-plan.json";
32
34
  const SHA = /^[0-9a-f]{40}$/;
@@ -104,6 +106,11 @@ export async function postPlanReport(input) {
104
106
  const found = await input.overdue().catch(() => []);
105
107
  report = (found.length > 0 ? { ...rest, overdue: found } : rest);
106
108
  }
109
+ // #4617: the marks come from the control repo, read here; the plan job's never show.
110
+ if (report.crossStackEdges?.length) {
111
+ const facts = await (input.controlFacts ?? (() => controlEdgeFactsFromEnv()))().catch(() => undefined);
112
+ report = remarkCrossStackEdges(report, facts);
113
+ }
107
114
  try {
108
115
  state = prStatusState(report);
109
116
  description = prStatusDescription(report);
@@ -130,7 +137,7 @@ export async function postPlanReport(input) {
130
137
  }
131
138
  if (note !== undefined) {
132
139
  try {
133
- await input.forge.upsertNote(input.pr, prNoteMarker(input.env, input.member), note);
140
+ await upsertPlanNote(input.forge, input.pr, prNoteMarker(input.env, input.member), note);
134
141
  }
135
142
  catch (err) {
136
143
  warnings.push(`could not post the note on #${input.pr}: ${err instanceof Error ? err.message : String(err)}`);
@@ -139,6 +146,24 @@ export async function postPlanReport(input) {
139
146
  }
140
147
  return { state, description: cut(description), noted: note !== undefined, ...(refused ? { refused } : {}), warnings };
141
148
  }
149
+ /**
150
+ * Post the plan note, or update it. Under a product's words that carry
151
+ * `adoptMarkers` (#4550), a pull request with no chant note yet but a note the
152
+ * product posted before it moved onto chant's pipeline gets that note
153
+ * updated, with the old marker kept at its end, so the pull request keeps one
154
+ * note across the switch.
155
+ */
156
+ export async function upsertPlanNote(forge, pr, marker, note, words = activeProductWords()) {
157
+ if (words.adoptMarkers.length > 0 && !(await forge.findComment(pr, marker))) {
158
+ for (const old of words.adoptMarkers) {
159
+ if (!(await forge.findComment(pr, old, { match: "anywhere" })))
160
+ continue;
161
+ await forge.upsertComment(pr, old, `${note}${note.endsWith("\n") ? "" : "\n"}${old}\n`, { match: "anywhere" });
162
+ return;
163
+ }
164
+ }
165
+ await forge.upsertNote(pr, marker, note);
166
+ }
142
167
  /**
143
168
  * Post the plan note and status of every open merge request into `branch`
144
169
  * whose plan job settled (#4328), from a pipeline of `branch`. GitLab says