@intentius/chant 0.124.54 → 0.124.56

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 (1077) 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 +832 -0
  71. package/dist/ci-audit/attribution.d.ts +111 -0
  72. package/dist/ci-audit/attribution.d.ts.map +1 -0
  73. package/dist/ci-audit/attribution.js +194 -0
  74. package/dist/ci-audit/audit-log.d.ts +144 -0
  75. package/dist/ci-audit/audit-log.d.ts.map +1 -0
  76. package/dist/ci-audit/audit-log.js +149 -0
  77. package/dist/ci-audit/index.d.ts +12 -0
  78. package/dist/ci-audit/index.d.ts.map +1 -0
  79. package/dist/ci-audit/index.js +12 -0
  80. package/dist/ci-audit/unrecorded.d.ts +74 -0
  81. package/dist/ci-audit/unrecorded.d.ts.map +1 -0
  82. package/dist/ci-audit/unrecorded.js +95 -0
  83. package/dist/ci-audit.d.ts +3 -0
  84. package/dist/ci-audit.d.ts.map +1 -0
  85. package/dist/ci-audit.js +2 -0
  86. package/dist/ci-control.d.ts +42 -0
  87. package/dist/ci-control.d.ts.map +1 -0
  88. package/dist/ci-control.js +41 -0
  89. package/dist/ci-estate/delivery.d.ts +137 -0
  90. package/dist/ci-estate/delivery.d.ts.map +1 -0
  91. package/dist/ci-estate/delivery.js +311 -0
  92. package/dist/ci-estate/overdue.d.ts +34 -0
  93. package/dist/ci-estate/overdue.d.ts.map +1 -0
  94. package/dist/ci-estate/overdue.js +58 -0
  95. package/dist/ci-estate/page.d.ts +134 -0
  96. package/dist/ci-estate/page.d.ts.map +1 -0
  97. package/dist/ci-estate/page.js +233 -0
  98. package/dist/ci-estate/rows.d.ts +118 -0
  99. package/dist/ci-estate/rows.d.ts.map +1 -0
  100. package/dist/ci-estate/rows.js +126 -0
  101. package/dist/ci-estate.d.ts +92 -0
  102. package/dist/ci-estate.d.ts.map +1 -0
  103. package/dist/ci-estate.js +82 -0
  104. package/dist/ci-handover.d.ts +29 -5
  105. package/dist/ci-handover.d.ts.map +1 -1
  106. package/dist/ci-handover.js +50 -16
  107. package/dist/ci-identity.d.ts +82 -7
  108. package/dist/ci-identity.d.ts.map +1 -1
  109. package/dist/ci-identity.js +86 -15
  110. package/dist/ci-job-guard.d.ts +139 -0
  111. package/dist/ci-job-guard.d.ts.map +1 -0
  112. package/dist/ci-job-guard.js +287 -0
  113. package/dist/ci-jobs.d.ts +7 -0
  114. package/dist/ci-jobs.d.ts.map +1 -1
  115. package/dist/ci-jobs.js +7 -0
  116. package/dist/ci-product-words.d.ts +296 -0
  117. package/dist/ci-product-words.d.ts.map +1 -0
  118. package/dist/ci-product-words.js +407 -0
  119. package/dist/ci-product.d.ts +117 -0
  120. package/dist/ci-product.d.ts.map +1 -0
  121. package/dist/ci-product.js +113 -0
  122. package/dist/ci-respond-run.d.ts +73 -0
  123. package/dist/ci-respond-run.d.ts.map +1 -0
  124. package/dist/ci-respond-run.js +247 -0
  125. package/dist/ci-respond.d.ts +189 -0
  126. package/dist/ci-respond.d.ts.map +1 -0
  127. package/dist/ci-respond.js +285 -0
  128. package/dist/cli/commands/audit.d.ts +2 -2
  129. package/dist/cli/commands/audit.d.ts.map +1 -1
  130. package/dist/cli/commands/audit.js +3 -2
  131. package/dist/cli/commands/carve.js +2 -2
  132. package/dist/cli/commands/init.d.ts +2 -0
  133. package/dist/cli/commands/init.d.ts.map +1 -1
  134. package/dist/cli/commands/init.js +1 -1
  135. package/dist/cli/handlers/agent.d.ts +17 -0
  136. package/dist/cli/handlers/agent.d.ts.map +1 -0
  137. package/dist/cli/handlers/agent.js +114 -0
  138. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  139. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  140. package/dist/cli/handlers/approve-confirm.js +142 -0
  141. package/dist/cli/handlers/approve.d.ts.map +1 -1
  142. package/dist/cli/handlers/approve.js +19 -1
  143. package/dist/cli/handlers/audit-log.d.ts +12 -0
  144. package/dist/cli/handlers/audit-log.d.ts.map +1 -0
  145. package/dist/cli/handlers/audit-log.js +81 -0
  146. package/dist/cli/handlers/build.d.ts +7 -0
  147. package/dist/cli/handlers/build.d.ts.map +1 -1
  148. package/dist/cli/handlers/build.js +124 -1
  149. package/dist/cli/handlers/ci-check-job.d.ts +11 -0
  150. package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
  151. package/dist/cli/handlers/ci-check-job.js +27 -0
  152. package/dist/cli/handlers/ci-check.d.ts +3 -0
  153. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  154. package/dist/cli/handlers/ci-check.js +63 -0
  155. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  156. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  157. package/dist/cli/handlers/ci-forge-check.js +89 -0
  158. package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
  159. package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
  160. package/dist/cli/handlers/e2e-safe-run.js +23 -0
  161. package/dist/cli/handlers/fan-out.js +4 -0
  162. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  163. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  164. package/dist/cli/handlers/gate-pending.js +44 -0
  165. package/dist/cli/handlers/init.d.ts.map +1 -1
  166. package/dist/cli/handlers/init.js +1 -0
  167. package/dist/cli/handlers/ledger.js +1 -1
  168. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  169. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  170. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  171. package/dist/cli/handlers/lock.d.ts.map +1 -1
  172. package/dist/cli/handlers/lock.js +64 -5
  173. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  174. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  175. package/dist/cli/handlers/notify-relay.js +130 -0
  176. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  177. package/dist/cli/handlers/pr-env.js +42 -11
  178. package/dist/cli/handlers/pr.d.ts +43 -3
  179. package/dist/cli/handlers/pr.d.ts.map +1 -1
  180. package/dist/cli/handlers/pr.js +908 -205
  181. package/dist/cli/handlers/promote.d.ts.map +1 -1
  182. package/dist/cli/handlers/promote.js +21 -2
  183. package/dist/cli/handlers/release.d.ts.map +1 -1
  184. package/dist/cli/handlers/release.js +3 -0
  185. package/dist/cli/handlers/run-wave.d.ts +8 -0
  186. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  187. package/dist/cli/handlers/run-wave.js +160 -2
  188. package/dist/cli/handlers/run.d.ts +6 -1
  189. package/dist/cli/handlers/run.d.ts.map +1 -1
  190. package/dist/cli/handlers/run.js +86 -1
  191. package/dist/cli/handlers/serve.d.ts.map +1 -1
  192. package/dist/cli/handlers/serve.js +10 -1
  193. package/dist/cli/main.d.ts +11 -1
  194. package/dist/cli/main.d.ts.map +1 -1
  195. package/dist/cli/main.js +178 -13
  196. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  197. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  198. package/dist/cli/mcp/ledger-tools.js +122 -0
  199. package/dist/cli/mcp/product-tools.d.ts +78 -0
  200. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  201. package/dist/cli/mcp/product-tools.js +93 -0
  202. package/dist/cli/mcp/read-only.d.ts +34 -0
  203. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  204. package/dist/cli/mcp/read-only.js +61 -0
  205. package/dist/cli/mcp/report-tools.d.ts +48 -0
  206. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  207. package/dist/cli/mcp/report-tools.js +128 -0
  208. package/dist/cli/mcp/server.d.ts +28 -1
  209. package/dist/cli/mcp/server.d.ts.map +1 -1
  210. package/dist/cli/mcp/server.js +86 -15
  211. package/dist/cli/mcp-config.d.ts +9 -2
  212. package/dist/cli/mcp-config.d.ts.map +1 -1
  213. package/dist/cli/mcp-config.js +8 -3
  214. package/dist/cli/parse-args.d.ts.map +1 -1
  215. package/dist/cli/parse-args.js +164 -3
  216. package/dist/cli/registry.d.ts +73 -0
  217. package/dist/cli/registry.d.ts.map +1 -1
  218. package/dist/cloud-lister/sigv4.d.ts +42 -7
  219. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  220. package/dist/cloud-lister/sigv4.js +72 -22
  221. package/dist/components/adoption.d.ts +69 -0
  222. package/dist/components/adoption.d.ts.map +1 -0
  223. package/dist/components/adoption.js +92 -0
  224. package/dist/components/apply-lease.d.ts +19 -0
  225. package/dist/components/apply-lease.d.ts.map +1 -0
  226. package/dist/components/apply-lease.js +41 -0
  227. package/dist/components/capability.d.ts +159 -5
  228. package/dist/components/capability.d.ts.map +1 -1
  229. package/dist/components/capability.js +39 -6
  230. package/dist/components/check-hooks.d.ts +116 -0
  231. package/dist/components/check-hooks.d.ts.map +1 -0
  232. package/dist/components/check-hooks.js +192 -0
  233. package/dist/components/check-steps.d.ts +74 -0
  234. package/dist/components/check-steps.d.ts.map +1 -0
  235. package/dist/components/check-steps.js +102 -0
  236. package/dist/components/ci-services.d.ts +57 -0
  237. package/dist/components/ci-services.d.ts.map +1 -0
  238. package/dist/components/ci-services.js +60 -0
  239. package/dist/components/cli-support.d.ts +13 -0
  240. package/dist/components/cli-support.d.ts.map +1 -1
  241. package/dist/components/cli-support.js +10 -2
  242. package/dist/components/driver.d.ts +32 -3
  243. package/dist/components/driver.d.ts.map +1 -1
  244. package/dist/components/driver.js +59 -5
  245. package/dist/components/fan-out-run.d.ts +12 -0
  246. package/dist/components/fan-out-run.d.ts.map +1 -1
  247. package/dist/components/fan-out-run.js +56 -16
  248. package/dist/components/groups.d.ts.map +1 -1
  249. package/dist/components/groups.js +23 -5
  250. package/dist/components/pr-env-ledger.d.ts +32 -0
  251. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  252. package/dist/components/pr-env-ledger.js +38 -0
  253. package/dist/components/pr-env-ports.d.ts +12 -0
  254. package/dist/components/pr-env-ports.d.ts.map +1 -1
  255. package/dist/components/pr-env-ports.js +13 -3
  256. package/dist/components/pr-env-run.d.ts +6 -0
  257. package/dist/components/pr-env-run.d.ts.map +1 -1
  258. package/dist/components/pr-env-run.js +3 -2
  259. package/dist/components/pr-environment.d.ts +32 -4
  260. package/dist/components/pr-environment.d.ts.map +1 -1
  261. package/dist/components/pr-environment.js +26 -8
  262. package/dist/components/pr-pipeline.d.ts +297 -5
  263. package/dist/components/pr-pipeline.d.ts.map +1 -1
  264. package/dist/components/pr-pipeline.js +329 -18
  265. package/dist/components/pr-policy.d.ts +26 -2
  266. package/dist/components/pr-policy.d.ts.map +1 -1
  267. package/dist/components/pr-policy.js +41 -7
  268. package/dist/components/pr-run.d.ts +71 -0
  269. package/dist/components/pr-run.d.ts.map +1 -1
  270. package/dist/components/pr-run.js +91 -7
  271. package/dist/components/pr-targets.d.ts +24 -0
  272. package/dist/components/pr-targets.d.ts.map +1 -0
  273. package/dist/components/pr-targets.js +48 -0
  274. package/dist/components/product-pipeline.d.ts +250 -0
  275. package/dist/components/product-pipeline.d.ts.map +1 -0
  276. package/dist/components/product-pipeline.js +212 -0
  277. package/dist/components/promote.d.ts +6 -0
  278. package/dist/components/promote.d.ts.map +1 -1
  279. package/dist/components/promote.js +4 -1
  280. package/dist/components/release-compile.d.ts +22 -1
  281. package/dist/components/release-compile.d.ts.map +1 -1
  282. package/dist/components/release-compile.js +85 -0
  283. package/dist/components/release-promote.d.ts +15 -1
  284. package/dist/components/release-promote.d.ts.map +1 -1
  285. package/dist/components/release-promote.js +67 -2
  286. package/dist/components/repo-lock.d.ts +27 -0
  287. package/dist/components/repo-lock.d.ts.map +1 -0
  288. package/dist/components/repo-lock.js +49 -0
  289. package/dist/components/row-lease.d.ts +84 -0
  290. package/dist/components/row-lease.d.ts.map +1 -0
  291. package/dist/components/row-lease.js +110 -0
  292. package/dist/components/wave-plan.d.ts +42 -0
  293. package/dist/components/wave-plan.d.ts.map +1 -1
  294. package/dist/components/wave-plan.js +72 -4
  295. package/dist/control/applied.d.ts +89 -0
  296. package/dist/control/applied.d.ts.map +1 -0
  297. package/dist/control/applied.js +175 -0
  298. package/dist/control/consumers.d.ts +78 -0
  299. package/dist/control/consumers.d.ts.map +1 -0
  300. package/dist/control/consumers.js +172 -0
  301. package/dist/control/dispatch.d.ts +334 -0
  302. package/dist/control/dispatch.d.ts.map +1 -0
  303. package/dist/control/dispatch.js +519 -0
  304. package/dist/control/edges.d.ts +75 -0
  305. package/dist/control/edges.d.ts.map +1 -0
  306. package/dist/control/edges.js +133 -0
  307. package/dist/control/reconcile.d.ts +120 -0
  308. package/dist/control/reconcile.d.ts.map +1 -0
  309. package/dist/control/reconcile.js +178 -0
  310. package/dist/control/records.d.ts +187 -0
  311. package/dist/control/records.d.ts.map +1 -0
  312. package/dist/control/records.js +307 -0
  313. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  314. package/dist/discovery/sandbox/bundle.js +25 -1
  315. package/dist/e2e-harness/bucket.d.ts +21 -0
  316. package/dist/e2e-harness/bucket.d.ts.map +1 -0
  317. package/dist/e2e-harness/bucket.js +61 -0
  318. package/dist/e2e-harness/claim.d.ts +70 -0
  319. package/dist/e2e-harness/claim.d.ts.map +1 -0
  320. package/dist/e2e-harness/claim.js +98 -0
  321. package/dist/e2e-harness/driver.d.ts +64 -0
  322. package/dist/e2e-harness/driver.d.ts.map +1 -0
  323. package/dist/e2e-harness/driver.js +243 -0
  324. package/dist/e2e-harness/forgejo.d.ts +77 -0
  325. package/dist/e2e-harness/forgejo.d.ts.map +1 -0
  326. package/dist/e2e-harness/forgejo.js +205 -0
  327. package/dist/e2e-harness/git.d.ts +32 -0
  328. package/dist/e2e-harness/git.d.ts.map +1 -0
  329. package/dist/e2e-harness/git.js +67 -0
  330. package/dist/e2e-harness/index.d.ts +22 -0
  331. package/dist/e2e-harness/index.d.ts.map +1 -0
  332. package/dist/e2e-harness/index.js +48 -0
  333. package/dist/e2e-harness/jobs.d.ts +8 -0
  334. package/dist/e2e-harness/jobs.d.ts.map +1 -0
  335. package/dist/e2e-harness/jobs.js +34 -0
  336. package/dist/e2e-harness/pins.d.ts +45 -0
  337. package/dist/e2e-harness/pins.d.ts.map +1 -0
  338. package/dist/e2e-harness/pins.js +44 -0
  339. package/dist/e2e-harness/ports.d.ts +113 -0
  340. package/dist/e2e-harness/ports.d.ts.map +1 -0
  341. package/dist/e2e-harness/ports.js +4 -0
  342. package/dist/e2e-harness/reports.d.ts +45 -0
  343. package/dist/e2e-harness/reports.d.ts.map +1 -0
  344. package/dist/e2e-harness/reports.js +57 -0
  345. package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
  346. package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
  347. package/dist/e2e-harness/safe-run-cli.js +43 -0
  348. package/dist/e2e-harness/safe-run.d.ts +61 -0
  349. package/dist/e2e-harness/safe-run.d.ts.map +1 -0
  350. package/dist/e2e-harness/safe-run.js +172 -0
  351. package/dist/e2e-harness/scenario.d.ts +11 -0
  352. package/dist/e2e-harness/scenario.d.ts.map +1 -0
  353. package/dist/e2e-harness/scenario.js +89 -0
  354. package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  355. package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
  356. package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  357. package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  358. package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  359. package/dist/e2e-harness/schemas/index.d.ts +191 -0
  360. package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
  361. package/dist/e2e-harness/schemas/index.js +62 -0
  362. package/dist/e2e-harness/stack.d.ts +124 -0
  363. package/dist/e2e-harness/stack.d.ts.map +1 -0
  364. package/dist/e2e-harness/stack.js +207 -0
  365. package/dist/e2e-harness/steps.d.ts +11 -0
  366. package/dist/e2e-harness/steps.d.ts.map +1 -0
  367. package/dist/e2e-harness/steps.js +22 -0
  368. package/dist/e2e-harness.d.ts +3 -0
  369. package/dist/e2e-harness.d.ts.map +1 -0
  370. package/dist/e2e-harness.js +2 -0
  371. package/dist/engine-facts.d.ts.map +1 -1
  372. package/dist/engine-facts.js +1 -2
  373. package/dist/exit-codes.d.ts +54 -0
  374. package/dist/exit-codes.d.ts.map +1 -0
  375. package/dist/exit-codes.js +55 -0
  376. package/dist/forge-check/check.d.ts +63 -0
  377. package/dist/forge-check/check.d.ts.map +1 -0
  378. package/dist/forge-check/check.js +139 -0
  379. package/dist/forge-check/contract.d.ts +152 -0
  380. package/dist/forge-check/contract.d.ts.map +1 -0
  381. package/dist/forge-check/contract.js +118 -0
  382. package/dist/forge-check/forge.d.ts +42 -0
  383. package/dist/forge-check/forge.d.ts.map +1 -0
  384. package/dist/forge-check/forge.js +338 -0
  385. package/dist/forge-check/index.d.ts +24 -0
  386. package/dist/forge-check/index.d.ts.map +1 -0
  387. package/dist/forge-check/index.js +23 -0
  388. package/dist/forge-check/pulumi.d.ts +44 -0
  389. package/dist/forge-check/pulumi.d.ts.map +1 -0
  390. package/dist/forge-check/pulumi.js +184 -0
  391. package/dist/forge-check/read-only.d.ts +26 -0
  392. package/dist/forge-check/read-only.d.ts.map +1 -0
  393. package/dist/forge-check/read-only.js +53 -0
  394. package/dist/forge-check/trust.d.ts +94 -0
  395. package/dist/forge-check/trust.d.ts.map +1 -0
  396. package/dist/forge-check/trust.js +532 -0
  397. package/dist/forge-check/types.d.ts +80 -0
  398. package/dist/forge-check/types.d.ts.map +1 -0
  399. package/dist/forge-check/types.js +18 -0
  400. package/dist/forge-check.d.ts +6 -0
  401. package/dist/forge-check.d.ts.map +1 -0
  402. package/dist/forge-check.js +5 -0
  403. package/dist/gate-decision.d.ts +1 -0
  404. package/dist/gate-decision.d.ts.map +1 -1
  405. package/dist/gate-decision.js +2 -0
  406. package/dist/gate-policy.d.ts +47 -1
  407. package/dist/gate-policy.d.ts.map +1 -1
  408. package/dist/gate-policy.js +50 -2
  409. package/dist/index.d.ts +1 -0
  410. package/dist/index.d.ts.map +1 -1
  411. package/dist/index.js +2 -0
  412. package/dist/lexicon.d.ts +152 -6
  413. package/dist/lexicon.d.ts.map +1 -1
  414. package/dist/lifecycle/adoption-file.d.ts +24 -0
  415. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  416. package/dist/lifecycle/adoption-file.js +1 -2
  417. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  418. package/dist/lifecycle/cloud-index.js +1 -2
  419. package/dist/lifecycle/gate-applied.d.ts +6 -0
  420. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  421. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  422. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  423. package/dist/lifecycle/gate-ledger.js +10 -1
  424. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  425. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  426. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  427. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  428. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  429. package/dist/lifecycle/gated-request-digest.js +35 -0
  430. package/dist/lifecycle/gated-request.d.ts +126 -0
  431. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  432. package/dist/lifecycle/gated-request.js +204 -0
  433. package/dist/lifecycle/identity-match.d.ts +15 -0
  434. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  435. package/dist/lifecycle/identity-match.js +11 -6
  436. package/dist/lifecycle/index-diff.d.ts +40 -0
  437. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  438. package/dist/lifecycle/index-diff.js +1 -2
  439. package/dist/lifecycle/index-document.d.ts.map +1 -1
  440. package/dist/lifecycle/index-document.js +1 -2
  441. package/dist/lifecycle/index-import.d.ts +4 -1
  442. package/dist/lifecycle/index-import.d.ts.map +1 -1
  443. package/dist/lifecycle/index-import.js +29 -32
  444. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  445. package/dist/lifecycle/ledger-read.js +7 -3
  446. package/dist/lifecycle/lock-rows.d.ts +76 -0
  447. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  448. package/dist/lifecycle/lock-rows.js +140 -0
  449. package/dist/lifecycle/query.d.ts +50 -3
  450. package/dist/lifecycle/query.d.ts.map +1 -1
  451. package/dist/lifecycle/query.js +97 -7
  452. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  453. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  454. package/dist/lifecycle/release-catalog-site.js +232 -0
  455. package/dist/lifecycle/release-catalog.d.ts +201 -0
  456. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  457. package/dist/lifecycle/release-catalog.js +198 -0
  458. package/dist/lifecycle/release-changelog.d.ts +41 -0
  459. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  460. package/dist/lifecycle/release-changelog.js +38 -0
  461. package/dist/lifecycle/release-cut.d.ts +1 -0
  462. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  463. package/dist/lifecycle/release-cut.js +1 -1
  464. package/dist/lifecycle/release-ledger.d.ts +16 -0
  465. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  466. package/dist/lifecycle/release-ledger.js +9 -0
  467. package/dist/lifecycle/release-publish.d.ts +43 -22
  468. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  469. package/dist/lifecycle/release-read.d.ts.map +1 -1
  470. package/dist/lifecycle/release-read.js +3 -0
  471. package/dist/lifecycle/release-status.d.ts +106 -0
  472. package/dist/lifecycle/release-status.d.ts.map +1 -0
  473. package/dist/lifecycle/release-status.js +115 -0
  474. package/dist/lifecycle/resource-lock.d.ts +120 -0
  475. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  476. package/dist/lifecycle/resource-lock.js +317 -0
  477. package/dist/lifecycle/retention.d.ts.map +1 -1
  478. package/dist/lifecycle/retention.js +3 -0
  479. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  480. package/dist/lifecycle/run-ledger.js +9 -1
  481. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  482. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  483. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  484. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  485. package/dist/lifecycle/snapshot-store.js +1 -2
  486. package/dist/lifecycle/target-lock.d.ts +15 -0
  487. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  488. package/dist/lifecycle/target-lock.js +25 -10
  489. package/dist/lifecycle/wave-plans.d.ts +23 -7
  490. package/dist/lifecycle/wave-plans.d.ts.map +1 -1
  491. package/dist/lifecycle/wave-plans.js +9 -2
  492. package/dist/mcp/types.d.ts +7 -0
  493. package/dist/mcp/types.d.ts.map +1 -1
  494. package/dist/notify-product.d.ts +43 -0
  495. package/dist/notify-product.d.ts.map +1 -0
  496. package/dist/notify-product.js +58 -0
  497. package/dist/notify-relay.d.ts +197 -0
  498. package/dist/notify-relay.d.ts.map +1 -0
  499. package/dist/notify-relay.js +321 -0
  500. package/dist/notify.d.ts +44 -4
  501. package/dist/notify.d.ts.map +1 -1
  502. package/dist/notify.js +77 -14
  503. package/dist/object-store/azure-blob.d.ts +129 -0
  504. package/dist/object-store/azure-blob.d.ts.map +1 -0
  505. package/dist/object-store/azure-blob.js +341 -0
  506. package/dist/object-store/common.d.ts +108 -0
  507. package/dist/object-store/common.d.ts.map +1 -0
  508. package/dist/object-store/common.js +80 -0
  509. package/dist/object-store/errors.d.ts +28 -0
  510. package/dist/object-store/errors.d.ts.map +1 -0
  511. package/dist/object-store/errors.js +21 -0
  512. package/dist/object-store/from-env.d.ts +18 -0
  513. package/dist/object-store/from-env.d.ts.map +1 -0
  514. package/dist/object-store/from-env.js +22 -0
  515. package/dist/object-store/gcs.d.ts +106 -0
  516. package/dist/object-store/gcs.d.ts.map +1 -0
  517. package/dist/object-store/gcs.js +393 -0
  518. package/dist/object-store/index.d.ts +9 -0
  519. package/dist/object-store/index.d.ts.map +1 -0
  520. package/dist/object-store/index.js +8 -0
  521. package/dist/object-store/s3.d.ts +146 -0
  522. package/dist/object-store/s3.d.ts.map +1 -0
  523. package/dist/object-store/s3.js +306 -0
  524. package/dist/op/activities/converge.d.ts.map +1 -1
  525. package/dist/op/activities/converge.js +2 -1
  526. package/dist/op/activities/index.d.ts +1 -1
  527. package/dist/op/activities/index.d.ts.map +1 -1
  528. package/dist/op/activities/index.js +1 -1
  529. package/dist/op/activities/review-agent.d.ts +55 -2
  530. package/dist/op/activities/review-agent.d.ts.map +1 -1
  531. package/dist/op/activities/review-agent.js +65 -5
  532. package/dist/op/approval-status.d.ts +103 -0
  533. package/dist/op/approval-status.d.ts.map +1 -0
  534. package/dist/op/approval-status.js +197 -0
  535. package/dist/op/gate.d.ts +29 -1
  536. package/dist/op/gate.d.ts.map +1 -1
  537. package/dist/op/gate.js +59 -23
  538. package/dist/op/generate-pipeline.d.ts.map +1 -1
  539. package/dist/op/generate-pipeline.js +7 -1
  540. package/dist/op/index.d.ts +12 -1
  541. package/dist/op/index.d.ts.map +1 -1
  542. package/dist/op/index.js +7 -1
  543. package/dist/op/op-waves-after-plan.d.ts +137 -0
  544. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  545. package/dist/op/op-waves-after-plan.js +163 -0
  546. package/dist/op/op-waves-capability-spec.d.ts +63 -0
  547. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  548. package/dist/op/op-waves-capability-spec.js +115 -0
  549. package/dist/op/op-waves-capability.d.ts +197 -0
  550. package/dist/op/op-waves-capability.d.ts.map +1 -0
  551. package/dist/op/op-waves-capability.js +311 -0
  552. package/dist/op/op-waves-events.d.ts +54 -0
  553. package/dist/op/op-waves-events.d.ts.map +1 -0
  554. package/dist/op/op-waves-events.js +122 -0
  555. package/dist/op/op-waves-notify.d.ts +7 -1
  556. package/dist/op/op-waves-notify.d.ts.map +1 -1
  557. package/dist/op/op-waves-notify.js +35 -16
  558. package/dist/op/op-waves-release-port.d.ts +18 -0
  559. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  560. package/dist/op/op-waves-release-port.js +61 -0
  561. package/dist/op/op-waves-release.d.ts +92 -0
  562. package/dist/op/op-waves-release.d.ts.map +1 -0
  563. package/dist/op/op-waves-release.js +96 -0
  564. package/dist/op/op-waves-run.d.ts +182 -6
  565. package/dist/op/op-waves-run.d.ts.map +1 -1
  566. package/dist/op/op-waves-run.js +1076 -44
  567. package/dist/op/op-waves-stand-down.d.ts +60 -0
  568. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  569. package/dist/op/op-waves-stand-down.js +96 -0
  570. package/dist/op/op-waves.d.ts +187 -8
  571. package/dist/op/op-waves.d.ts.map +1 -1
  572. package/dist/op/op-waves.js +203 -19
  573. package/dist/op/runtime.d.ts +95 -0
  574. package/dist/op/runtime.d.ts.map +1 -1
  575. package/dist/op/runtime.js +18 -0
  576. package/dist/op/stage-hooks.d.ts +45 -7
  577. package/dist/op/stage-hooks.d.ts.map +1 -1
  578. package/dist/op/stage-hooks.js +61 -3
  579. package/dist/op/steward-beside.d.ts.map +1 -1
  580. package/dist/op/steward-beside.js +2 -1
  581. package/dist/op/types.d.ts +2 -2
  582. package/dist/op/types.d.ts.map +1 -1
  583. package/dist/op/types.js +3 -2
  584. package/dist/otlp-metrics.d.ts +38 -0
  585. package/dist/otlp-metrics.d.ts.map +1 -0
  586. package/dist/otlp-metrics.js +82 -0
  587. package/dist/otlp.d.ts +249 -0
  588. package/dist/otlp.d.ts.map +1 -0
  589. package/dist/otlp.js +425 -0
  590. package/dist/override-gate.d.ts.map +1 -1
  591. package/dist/override-gate.js +5 -0
  592. package/dist/parallelism.d.ts +17 -0
  593. package/dist/parallelism.d.ts.map +1 -0
  594. package/dist/parallelism.js +33 -0
  595. package/dist/policy-packs.d.ts +69 -0
  596. package/dist/policy-packs.d.ts.map +1 -0
  597. package/dist/policy-packs.js +205 -0
  598. package/dist/policy-source.d.ts +51 -0
  599. package/dist/policy-source.d.ts.map +1 -0
  600. package/dist/policy-source.js +102 -0
  601. package/dist/pr-forge.d.ts +40 -0
  602. package/dist/pr-forge.d.ts.map +1 -1
  603. package/dist/pr-forge.js +146 -37
  604. package/dist/pr-loop.d.ts +158 -11
  605. package/dist/pr-loop.d.ts.map +1 -1
  606. package/dist/pr-loop.js +302 -44
  607. package/dist/pr-merge.d.ts +64 -0
  608. package/dist/pr-merge.d.ts.map +1 -0
  609. package/dist/pr-merge.js +78 -0
  610. package/dist/pr-post.d.ts +86 -1
  611. package/dist/pr-post.d.ts.map +1 -1
  612. package/dist/pr-post.js +141 -5
  613. package/dist/pr-report-url.d.ts +32 -4
  614. package/dist/pr-report-url.d.ts.map +1 -1
  615. package/dist/pr-report-url.js +45 -5
  616. package/dist/pr-requires.d.ts +13 -2
  617. package/dist/pr-requires.d.ts.map +1 -1
  618. package/dist/pr-requires.js +14 -0
  619. package/dist/release-floors.d.ts +1 -1
  620. package/dist/release-floors.js +1 -1
  621. package/dist/run-event.d.ts +26 -1
  622. package/dist/run-event.d.ts.map +1 -1
  623. package/dist/run-event.js +3 -1
  624. package/dist/scheduled-op-cloud.d.ts +32 -0
  625. package/dist/scheduled-op-cloud.d.ts.map +1 -0
  626. package/dist/scheduled-op-cloud.js +69 -0
  627. package/dist/sorted-json.d.ts +10 -0
  628. package/dist/sorted-json.d.ts.map +1 -0
  629. package/dist/sorted-json.js +14 -0
  630. package/dist/terraform/credentials.d.ts +59 -0
  631. package/dist/terraform/credentials.d.ts.map +1 -0
  632. package/dist/terraform/credentials.js +149 -0
  633. package/dist/utils.d.ts +1 -4
  634. package/dist/utils.d.ts.map +1 -1
  635. package/dist/utils.js +1 -9
  636. package/dist/wave-runtime.d.ts +1 -1
  637. package/dist/wave-runtime.js +2 -2
  638. package/dist/wave-runtime.mjs +405 -287
  639. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  640. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  641. package/dist/workspace/ci-lock-grain.d.ts +17 -0
  642. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  643. package/dist/workspace/ci-lock-grain.js +21 -0
  644. package/dist/workspace/ci-run.d.ts +2 -1
  645. package/dist/workspace/ci-run.d.ts.map +1 -1
  646. package/dist/workspace/ci-run.js +10 -3
  647. package/dist/workspace/declaration.d.ts +16 -4
  648. package/dist/workspace/declaration.d.ts.map +1 -1
  649. package/dist/workspace/declaration.js +5 -2
  650. package/dist/workspace/declaration.schema.json +27 -3
  651. package/dist/workspace/drift-cli.d.ts.map +1 -1
  652. package/dist/workspace/drift-cli.js +8 -3
  653. package/dist/workspace/exit-cli.d.ts +1 -1
  654. package/dist/workspace/exit-cli.d.ts.map +1 -1
  655. package/dist/workspace/exit-cli.js +2 -1
  656. package/dist/workspace/import-fetch.d.ts +4 -2
  657. package/dist/workspace/import-fetch.d.ts.map +1 -1
  658. package/dist/workspace/import-fetch.js +4 -2
  659. package/dist/workspace/import-init.d.ts.map +1 -1
  660. package/dist/workspace/import-init.js +4 -2
  661. package/dist/workspace/ledger.schema.json +7 -3
  662. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  663. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  664. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  665. package/dist/workspace/pr-report.schema.json +79 -3
  666. package/dist/workspace/promote.d.ts +1 -1
  667. package/dist/workspace/promote.d.ts.map +1 -1
  668. package/dist/workspace/promote.js +2 -1
  669. package/dist/workspace/records-cli.d.ts +2 -2
  670. package/dist/workspace/records-cli.d.ts.map +1 -1
  671. package/dist/workspace/records-cli.js +3 -2
  672. package/dist/workspace/release-catalog.schema.json +277 -0
  673. package/dist/workspace/run-event.schema.json +18 -1
  674. package/dist/workspace/work-cli.d.ts +3 -1
  675. package/dist/workspace/work-cli.d.ts.map +1 -1
  676. package/dist/workspace/work-cli.js +7 -2
  677. package/dist/workspace/workspace-run.d.ts.map +1 -1
  678. package/dist/workspace/workspace-run.js +2 -1
  679. package/package.json +21 -1
  680. package/src/__fixtures__/estate-ledger.ts +101 -0
  681. package/src/__fixtures__/oidc-emulator.ts +31 -2
  682. package/src/__fixtures__/product-words.ts +44 -0
  683. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  684. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  685. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  686. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  687. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  688. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  689. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  690. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  691. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  692. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  693. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  694. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  695. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  696. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  697. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  698. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  699. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  700. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  701. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  702. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  703. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  704. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  705. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  706. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  707. package/src/__golden__/wave-loop/op-point.json +18 -4
  708. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  709. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  710. package/src/__golden__/wave-loop/op-spend.json +10 -2
  711. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  712. package/src/__golden__/wave-loop/op-wide.json +20 -4
  713. package/src/bucket-check/azure.ts +307 -0
  714. package/src/bucket-check/bucket-check.test.ts +210 -0
  715. package/src/bucket-check/fixtures/azure.json +153 -0
  716. package/src/bucket-check/fixtures/gcs.json +148 -0
  717. package/src/bucket-check/fixtures/s3.json +277 -0
  718. package/src/bucket-check/gcs.ts +257 -0
  719. package/src/bucket-check/index.ts +61 -0
  720. package/src/bucket-check/s3.ts +433 -0
  721. package/src/bucket-check/types.ts +75 -0
  722. package/src/bucket-check/wire.ts +50 -0
  723. package/src/bucket-check.ts +5 -0
  724. package/src/capabilities/templates.test.ts +2 -3
  725. package/src/capabilities/templates.ts +1 -2
  726. package/src/cdk/advise.test.ts +1 -1
  727. package/src/change-set-bundle.test.ts +0 -1
  728. package/src/change-set.ts +2 -3
  729. package/src/ci-agent.test.ts +348 -0
  730. package/src/ci-agent.ts +1025 -0
  731. package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
  732. package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
  733. package/src/ci-audit/attribution.ts +260 -0
  734. package/src/ci-audit/audit-log.ts +220 -0
  735. package/src/ci-audit/ci-audit.test.ts +175 -0
  736. package/src/ci-audit/index.ts +15 -0
  737. package/src/ci-audit/unrecorded.ts +140 -0
  738. package/src/ci-audit.ts +2 -0
  739. package/src/ci-control.ts +173 -0
  740. package/src/ci-estate/delivery.ts +433 -0
  741. package/src/ci-estate/overdue.ts +81 -0
  742. package/src/ci-estate/page.ts +343 -0
  743. package/src/ci-estate/rows.ts +251 -0
  744. package/src/ci-estate.test.ts +281 -0
  745. package/src/ci-estate.ts +175 -0
  746. package/src/ci-handover.ts +67 -16
  747. package/src/ci-identity-database.test.ts +54 -0
  748. package/src/ci-identity-pulumi.test.ts +163 -0
  749. package/src/ci-identity-targets.test.ts +3 -1
  750. package/src/ci-identity.ts +123 -22
  751. package/src/ci-job-guard.test.ts +154 -0
  752. package/src/ci-job-guard.ts +319 -0
  753. package/src/ci-jobs.ts +8 -0
  754. package/src/ci-product-comment-targets.test.ts +45 -0
  755. package/src/ci-product-words.test.ts +101 -0
  756. package/src/ci-product-words.ts +565 -0
  757. package/src/ci-product.ts +226 -0
  758. package/src/ci-respond-run.ts +291 -0
  759. package/src/ci-respond.test.ts +264 -0
  760. package/src/ci-respond.ts +412 -0
  761. package/src/ci-shared-reads.test.ts +145 -0
  762. package/src/cli/commands/audit.test.ts +1 -1
  763. package/src/cli/commands/audit.ts +3 -2
  764. package/src/cli/commands/carve.test.ts +1 -1
  765. package/src/cli/commands/carve.ts +2 -2
  766. package/src/cli/commands/init.ts +3 -1
  767. package/src/cli/component-wave-args.test.ts +16 -0
  768. package/src/cli/handlers/agent.ts +126 -0
  769. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  770. package/src/cli/handlers/approve-confirm.ts +200 -0
  771. package/src/cli/handlers/approve.ts +18 -1
  772. package/src/cli/handlers/audit-log.ts +74 -0
  773. package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
  774. package/src/cli/handlers/build.test.ts +7 -0
  775. package/src/cli/handlers/build.ts +113 -1
  776. package/src/cli/handlers/ci-check-job.test.ts +114 -0
  777. package/src/cli/handlers/ci-check-job.ts +33 -0
  778. package/src/cli/handlers/ci-check.ts +63 -0
  779. package/src/cli/handlers/ci-forge-check.ts +91 -0
  780. package/src/cli/handlers/e2e-safe-run.ts +27 -0
  781. package/src/cli/handlers/fan-out.test.ts +10 -10
  782. package/src/cli/handlers/fan-out.ts +5 -0
  783. package/src/cli/handlers/gate-pending.ts +46 -0
  784. package/src/cli/handlers/init.ts +1 -0
  785. package/src/cli/handlers/ledger.ts +1 -1
  786. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  787. package/src/cli/handlers/lock.test.ts +29 -2
  788. package/src/cli/handlers/lock.ts +66 -6
  789. package/src/cli/handlers/notify-relay.ts +130 -0
  790. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  791. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  792. package/src/cli/handlers/pr-env.ts +48 -11
  793. package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
  794. package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
  795. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  796. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  797. package/src/cli/handlers/pr-waves.test.ts +8 -2
  798. package/src/cli/handlers/pr.test.ts +8 -8
  799. package/src/cli/handlers/pr.ts +879 -205
  800. package/src/cli/handlers/promote.test.ts +5 -5
  801. package/src/cli/handlers/promote.ts +22 -2
  802. package/src/cli/handlers/release.ts +2 -0
  803. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  804. package/src/cli/handlers/run-wave.ts +144 -2
  805. package/src/cli/handlers/run.test.ts +6 -4
  806. package/src/cli/handlers/run.ts +86 -1
  807. package/src/cli/handlers/serve.ts +10 -1
  808. package/src/cli/main.test.ts +1 -1
  809. package/src/cli/main.ts +180 -13
  810. package/src/cli/mcp/ledger-tools.ts +126 -0
  811. package/src/cli/mcp/product-tools.test.ts +123 -0
  812. package/src/cli/mcp/product-tools.ts +129 -0
  813. package/src/cli/mcp/read-only.test.ts +134 -0
  814. package/src/cli/mcp/read-only.ts +68 -0
  815. package/src/cli/mcp/report-tools.ts +135 -0
  816. package/src/cli/mcp/server.test.ts +5 -4
  817. package/src/cli/mcp/server.ts +90 -16
  818. package/src/cli/mcp-config.ts +8 -3
  819. package/src/cli/parse-args.ts +119 -2
  820. package/src/cli/registry.ts +73 -0
  821. package/src/cloud-lister/sigv4.ts +80 -23
  822. package/src/components/adoption.test.ts +140 -0
  823. package/src/components/adoption.ts +140 -0
  824. package/src/components/apply-lease.ts +49 -0
  825. package/src/components/capability.ts +180 -6
  826. package/src/components/check-hooks.test.ts +66 -0
  827. package/src/components/check-hooks.ts +255 -0
  828. package/src/components/check-steps.test.ts +70 -0
  829. package/src/components/check-steps.ts +158 -0
  830. package/src/components/ci-services.test.ts +51 -0
  831. package/src/components/ci-services.ts +82 -0
  832. package/src/components/cli-support.ts +23 -2
  833. package/src/components/driver.test.ts +3 -3
  834. package/src/components/driver.ts +73 -6
  835. package/src/components/fan-out-run.ts +68 -18
  836. package/src/components/groups.ts +21 -4
  837. package/src/components/plan-flags.test.ts +46 -0
  838. package/src/components/pr-comment-preview-targets.test.ts +34 -0
  839. package/src/components/pr-comment-preview.test.ts +54 -0
  840. package/src/components/pr-env-ledger.test.ts +9 -0
  841. package/src/components/pr-env-ledger.ts +42 -0
  842. package/src/components/pr-env-ports.ts +29 -4
  843. package/src/components/pr-env-run-bundle.test.ts +2 -14
  844. package/src/components/pr-env-run.test.ts +19 -0
  845. package/src/components/pr-env-run.ts +12 -2
  846. package/src/components/pr-environment.test.ts +29 -0
  847. package/src/components/pr-environment.ts +40 -8
  848. package/src/components/pr-pipeline-runners.test.ts +80 -0
  849. package/src/components/pr-pipeline.test.ts +15 -0
  850. package/src/components/pr-pipeline.ts +498 -18
  851. package/src/components/pr-policy.ts +45 -7
  852. package/src/components/pr-run.test.ts +1 -1
  853. package/src/components/pr-run.ts +138 -11
  854. package/src/components/pr-stale-job.test.ts +34 -0
  855. package/src/components/pr-targets.test.ts +35 -0
  856. package/src/components/pr-targets.ts +45 -0
  857. package/src/components/product-pipeline.test.ts +200 -0
  858. package/src/components/product-pipeline.ts +383 -0
  859. package/src/components/promote.ts +10 -1
  860. package/src/components/release-compile.ts +87 -1
  861. package/src/components/release-promote.ts +65 -1
  862. package/src/components/repo-lock.ts +52 -0
  863. package/src/components/row-lease.test.ts +490 -0
  864. package/src/components/row-lease.ts +167 -0
  865. package/src/components/wave-plan-policy.test.ts +19 -0
  866. package/src/components/wave-plan.ts +96 -6
  867. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  868. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  869. package/src/control/applied.test.ts +148 -0
  870. package/src/control/applied.ts +191 -0
  871. package/src/control/consumers.test.ts +129 -0
  872. package/src/control/consumers.ts +192 -0
  873. package/src/control/control.test.ts +302 -0
  874. package/src/control/dispatch.ts +699 -0
  875. package/src/control/edges.test.ts +112 -0
  876. package/src/control/edges.ts +164 -0
  877. package/src/control/note-checkout.test.ts +91 -0
  878. package/src/control/reconcile.ts +250 -0
  879. package/src/control/records.ts +395 -0
  880. package/src/discovery/sandbox/bundle.ts +25 -1
  881. package/src/e2e-harness/__project__/chant.config.ts +4 -0
  882. package/src/e2e-harness/__project__/src/compose.ts +33 -0
  883. package/src/e2e-harness/bucket.ts +69 -0
  884. package/src/e2e-harness/claim.test.ts +150 -0
  885. package/src/e2e-harness/claim.ts +140 -0
  886. package/src/e2e-harness/driver.test.ts +304 -0
  887. package/src/e2e-harness/driver.ts +294 -0
  888. package/src/e2e-harness/forgejo.ts +267 -0
  889. package/src/e2e-harness/git.ts +96 -0
  890. package/src/e2e-harness/index.ts +50 -0
  891. package/src/e2e-harness/jobs.ts +35 -0
  892. package/src/e2e-harness/pins.ts +52 -0
  893. package/src/e2e-harness/ports.ts +130 -0
  894. package/src/e2e-harness/reports.ts +79 -0
  895. package/src/e2e-harness/safe-run-cli.test.ts +102 -0
  896. package/src/e2e-harness/safe-run-cli.ts +54 -0
  897. package/src/e2e-harness/safe-run.ts +198 -0
  898. package/src/e2e-harness/scenario.ts +89 -0
  899. package/src/e2e-harness/schemas/README.md +62 -0
  900. package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  901. package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
  902. package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  903. package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  904. package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  905. package/src/e2e-harness/schemas/index.ts +220 -0
  906. package/src/e2e-harness/schemas.test.ts +145 -0
  907. package/src/e2e-harness/stack.test.ts +124 -0
  908. package/src/e2e-harness/stack.ts +306 -0
  909. package/src/e2e-harness/steps.ts +30 -0
  910. package/src/e2e-harness.ts +2 -0
  911. package/src/engine-facts.test.ts +2 -3
  912. package/src/engine-facts.ts +1 -2
  913. package/src/exit-codes.test.ts +32 -0
  914. package/src/exit-codes.ts +61 -0
  915. package/src/forge-check/check.ts +155 -0
  916. package/src/forge-check/contract.ts +215 -0
  917. package/src/forge-check/forge-check.test.ts +427 -0
  918. package/src/forge-check/forge.ts +318 -0
  919. package/src/forge-check/index.ts +43 -0
  920. package/src/forge-check/pulumi.ts +192 -0
  921. package/src/forge-check/read-only.ts +56 -0
  922. package/src/forge-check/trust.ts +527 -0
  923. package/src/forge-check/types.ts +78 -0
  924. package/src/forge-check.ts +5 -0
  925. package/src/gate-decision-bundle.test.ts +11 -0
  926. package/src/gate-decision.ts +3 -0
  927. package/src/gate-policy.ts +92 -3
  928. package/src/gated-waves-bundle.test.ts +0 -1
  929. package/src/index.ts +2 -0
  930. package/src/lexicon.ts +143 -6
  931. package/src/lifecycle/adoption-file.ts +1 -2
  932. package/src/lifecycle/cloud-index.test.ts +2 -3
  933. package/src/lifecycle/cloud-index.ts +1 -2
  934. package/src/lifecycle/control-entries-ledger.test.ts +69 -0
  935. package/src/lifecycle/gate-applied.ts +6 -0
  936. package/src/lifecycle/gate-ledger.ts +35 -1
  937. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  938. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  939. package/src/lifecycle/gated-request-digest.ts +49 -0
  940. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  941. package/src/lifecycle/gated-request.ts +279 -0
  942. package/src/lifecycle/identity-match.ts +25 -6
  943. package/src/lifecycle/index-diff.ts +1 -2
  944. package/src/lifecycle/index-document.ts +1 -2
  945. package/src/lifecycle/index-import.test.ts +14 -0
  946. package/src/lifecycle/index-import.ts +54 -34
  947. package/src/lifecycle/ledger-read.ts +7 -3
  948. package/src/lifecycle/lock-rows.test.ts +109 -0
  949. package/src/lifecycle/lock-rows.ts +167 -0
  950. package/src/lifecycle/publish-target-context.test.ts +108 -0
  951. package/src/lifecycle/query.test.ts +2 -3
  952. package/src/lifecycle/query.ts +109 -8
  953. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  954. package/src/lifecycle/release-catalog-site.ts +291 -0
  955. package/src/lifecycle/release-catalog.test.ts +192 -0
  956. package/src/lifecycle/release-catalog.ts +353 -0
  957. package/src/lifecycle/release-changelog.test.ts +70 -0
  958. package/src/lifecycle/release-changelog.ts +71 -0
  959. package/src/lifecycle/release-cut.ts +2 -2
  960. package/src/lifecycle/release-ledger.ts +19 -0
  961. package/src/lifecycle/release-publish.ts +45 -22
  962. package/src/lifecycle/release-read.ts +2 -0
  963. package/src/lifecycle/release-status.test.ts +185 -0
  964. package/src/lifecycle/release-status.ts +175 -0
  965. package/src/lifecycle/resource-lock.test.ts +175 -0
  966. package/src/lifecycle/resource-lock.ts +354 -0
  967. package/src/lifecycle/retention.ts +2 -0
  968. package/src/lifecycle/run-ledger.ts +7 -1
  969. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  970. package/src/lifecycle/snapshot-store.ts +1 -2
  971. package/src/lifecycle/target-lock.ts +24 -9
  972. package/src/lifecycle/wave-plans.ts +33 -5
  973. package/src/mcp/types.ts +7 -0
  974. package/src/notify-product.ts +76 -0
  975. package/src/notify-relay.test.ts +213 -0
  976. package/src/notify-relay.ts +407 -0
  977. package/src/notify.ts +95 -14
  978. package/src/object-store/azure-blob.ts +374 -0
  979. package/src/object-store/common.ts +133 -0
  980. package/src/object-store/errors.ts +26 -0
  981. package/src/object-store/from-env.ts +36 -0
  982. package/src/object-store/gcs.ts +436 -0
  983. package/src/object-store/index.ts +8 -0
  984. package/src/object-store/object-store.test.ts +130 -0
  985. package/src/object-store/s3.ts +350 -0
  986. package/src/op/activities/converge.ts +2 -1
  987. package/src/op/activities/index.ts +1 -1
  988. package/src/op/activities/review-agent.open.test.ts +78 -0
  989. package/src/op/activities/review-agent.test.ts +13 -0
  990. package/src/op/activities/review-agent.ts +89 -5
  991. package/src/op/approval-status.test.ts +134 -0
  992. package/src/op/approval-status.ts +235 -0
  993. package/src/op/gate-review.test.ts +2 -1
  994. package/src/op/gate.ts +81 -22
  995. package/src/op/generate-pipeline.ts +7 -1
  996. package/src/op/index.ts +23 -0
  997. package/src/op/op-waves-after-plan.test.ts +288 -0
  998. package/src/op/op-waves-after-plan.ts +238 -0
  999. package/src/op/op-waves-capability-spec.ts +133 -0
  1000. package/src/op/op-waves-capability.test.ts +217 -0
  1001. package/src/op/op-waves-capability.ts +370 -0
  1002. package/src/op/op-waves-events.ts +135 -0
  1003. package/src/op/op-waves-notify-words.test.ts +149 -0
  1004. package/src/op/op-waves-notify.ts +41 -16
  1005. package/src/op/op-waves-parallelism.test.ts +89 -0
  1006. package/src/op/op-waves-pull-request.test.ts +219 -0
  1007. package/src/op/op-waves-release-port.ts +64 -0
  1008. package/src/op/op-waves-release.test.ts +209 -0
  1009. package/src/op/op-waves-release.ts +132 -0
  1010. package/src/op/op-waves-run-record.test.ts +32 -0
  1011. package/src/op/op-waves-run.ts +1235 -52
  1012. package/src/op/op-waves-stand-down.test.ts +240 -0
  1013. package/src/op/op-waves-stand-down.ts +107 -0
  1014. package/src/op/op-waves-trace.test.ts +205 -0
  1015. package/src/op/op-waves.test.ts +112 -0
  1016. package/src/op/op-waves.ts +320 -22
  1017. package/src/op/runtime.ts +107 -0
  1018. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  1019. package/src/op/stage-hooks.ts +91 -12
  1020. package/src/op/steward-beside.ts +2 -1
  1021. package/src/op/types.ts +3 -2
  1022. package/src/otlp-metrics.ts +96 -0
  1023. package/src/otlp.test.ts +243 -0
  1024. package/src/otlp.ts +543 -0
  1025. package/src/override-gate-bundle.test.ts +2 -0
  1026. package/src/override-gate.ts +4 -0
  1027. package/src/parallelism.test.ts +38 -0
  1028. package/src/parallelism.ts +33 -0
  1029. package/src/policy-packs.ts +230 -0
  1030. package/src/policy-source.test.ts +256 -0
  1031. package/src/policy-source.ts +111 -0
  1032. package/src/pr-forge-bundle.test.ts +1 -1
  1033. package/src/pr-forge.ts +175 -33
  1034. package/src/pr-loop-bundle.test.ts +7 -3
  1035. package/src/pr-loop-narrowed.test.ts +63 -0
  1036. package/src/pr-loop-words.test.ts +155 -0
  1037. package/src/pr-loop.ts +398 -52
  1038. package/src/pr-merge.test.ts +100 -0
  1039. package/src/pr-merge.ts +105 -0
  1040. package/src/pr-post-stale.test.ts +163 -0
  1041. package/src/pr-post.ts +190 -5
  1042. package/src/pr-report-url.ts +61 -6
  1043. package/src/pr-requires.test.ts +37 -1
  1044. package/src/pr-requires.ts +16 -2
  1045. package/src/product-subpaths-plain-node.e2e.test.ts +212 -0
  1046. package/src/release-floors.ts +1 -1
  1047. package/src/run-event.ts +28 -1
  1048. package/src/scheduled-op-cloud.ts +68 -0
  1049. package/src/sorted-json.ts +17 -0
  1050. package/src/stage-hooks-bundle.test.ts +6 -0
  1051. package/src/terraform/credentials.test.ts +77 -0
  1052. package/src/terraform/credentials.ts +162 -0
  1053. package/src/utils.ts +2 -11
  1054. package/src/wave-loop-golden.test.ts +2 -1
  1055. package/src/wave-runtime.ts +2 -2
  1056. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  1057. package/src/workspace/ci-lock-grain.test.ts +31 -0
  1058. package/src/workspace/ci-lock-grain.ts +29 -0
  1059. package/src/workspace/ci-report-url.test.ts +1 -1
  1060. package/src/workspace/ci-run.test.ts +1 -1
  1061. package/src/workspace/ci-run.ts +10 -3
  1062. package/src/workspace/declaration.schema.json +27 -3
  1063. package/src/workspace/declaration.test.ts +1 -1
  1064. package/src/workspace/declaration.ts +26 -10
  1065. package/src/workspace/drift-cli.ts +8 -3
  1066. package/src/workspace/exit-cli.ts +2 -1
  1067. package/src/workspace/import-fetch.ts +4 -2
  1068. package/src/workspace/import-init.ts +4 -2
  1069. package/src/workspace/ledger.schema.json +7 -3
  1070. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  1071. package/src/workspace/pr-report.schema.json +79 -3
  1072. package/src/workspace/promote.ts +2 -1
  1073. package/src/workspace/records-cli.ts +3 -2
  1074. package/src/workspace/release-catalog.schema.json +277 -0
  1075. package/src/workspace/run-event.schema.json +18 -1
  1076. package/src/workspace/work-cli.ts +8 -2
  1077. package/src/workspace/workspace-run.ts +2 -1
@@ -0,0 +1,200 @@
1
+ import { describe, expect, test } from "vitest";
2
+ import { componentWaveOutputsFile, componentWaveSteps, componentWavesSpec, productDriftAgent, productPipelineJobs, productWavesSpec } from "./product-pipeline";
3
+ import { prApplyComment, prLoopSetup, PR_LOOP_IMAGE, PR_LOOP_SETUP, withProductBin } from "./pr-pipeline";
4
+ import { PLYWOOD, TERRAGUCCI } from "../__fixtures__/product-words";
5
+ import type { OpWavesSpec } from "../op/op-waves";
6
+ import { resolveControlTarget } from "../control/dispatch";
7
+ import type { CiProductCommand } from "../ci-product-words";
8
+
9
+ /**
10
+ * `w` with only the commands (and aliases) a pipeline with `jobs` answers:
11
+ * #4550 refuses words naming a command the pipeline has no job for, so a
12
+ * test that builds fewer jobs passes words that name fewer commands.
13
+ */
14
+ function only<W extends { commands: Record<string, CiProductCommand>; aliases?: readonly { command: CiProductCommand }[] }>(w: W, ...jobs: CiProductCommand[]): W {
15
+ const commands = Object.fromEntries(Object.entries(w.commands).filter(([, c]) => jobs.includes(c)));
16
+ return { ...w, commands, ...(w.aliases ? { aliases: w.aliases.filter((a) => jobs.includes(a.command)) } : {}) };
17
+ }
18
+
19
+ const waves: OpWavesSpec = {
20
+ name: "apply",
21
+ op: "apply",
22
+ planWave: ["chant", "components", "plan-wave", "{runs}", "{plans}"],
23
+ applyWave: ["chant", "components", "apply-wave", "{runs}", "{plans}"],
24
+ waves: [
25
+ { name: "dev", runs: [{ target: "shop-dev" }] },
26
+ { name: "prod", runs: [{ target: "shop-prod" }] },
27
+ ],
28
+ };
29
+
30
+ describe("the product pipeline (#4550)", () => {
31
+ test("terragucci's and plywood's jobs differ only in the words each passes", () => {
32
+ const tg = productPipelineJobs("github", "production", { words: TERRAGUCCI, waves, applyBeforeMerge: false, locks: "plan", agent: true });
33
+ const pw = productPipelineJobs("github", "production", { words: PLYWOOD, waves, locks: "plan" });
34
+ const shape = (j: typeof tg) => ({ plan: Object.keys(j.plan.env).sort(), waves: j.waves!.jobs.map((w) => w.jobName) });
35
+ expect(shape(tg)).toEqual(shape(pw));
36
+ expect(tg.waves!.spec.name).toBe("tf-apply");
37
+ expect(pw.waves!.spec.name).toBe("pulumi-up");
38
+ expect(tg.waves!.spec.gateName).toBe("wave-{k}");
39
+ expect(pw.waves!.spec.gateName).toBe("wave-{k}");
40
+ });
41
+
42
+ test("the plan side runs the product's bin, and ci run passes it on", () => {
43
+ const pw = productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan") });
44
+ expect(pw.plan.command.startsWith("npx --no-install plywood components pr-plan ")).toBe(true);
45
+ expect(pw.plan.command).toContain("--gate up");
46
+ expect(pw.plan.run.command.startsWith('npx --no-install plywood ci run plan --chant "npx --no-install plywood" --in-place')).toBe(true);
47
+ expect(pw.post.command.startsWith("npx --no-install plywood components pr-post ")).toBe(true);
48
+ expect(pw.record).toBeDefined();
49
+ expect(pw.waves).toBeUndefined();
50
+ });
51
+
52
+ test("the apply on merge runs on op waves through the product's bin", () => {
53
+ const pw = productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan", "apply"), waves });
54
+ expect(pw.record).toBeUndefined();
55
+ expect(pw.waves!.specFile).toBe(".chant/op-waves/pulumi-up.spec.json");
56
+ expect(pw.waves!.jobs[0]!.command.slice(0, 6)).toEqual(["npx", "--no-install", "plywood", "run", "wave", "--spec"]);
57
+ expect(pw.comments).toEqual({ plan: "/plywood preview", apply: "/plywood up" });
58
+ });
59
+
60
+ test("the approval preset: per wave for terragucci, the pull request's digest for plywood", () => {
61
+ const tg = productWavesSpec(waves, TERRAGUCCI);
62
+ expect(tg.waves.every((w) => w.approval === undefined)).toBe(true);
63
+ expect(tg.approvals?.pullRequest).toBeUndefined();
64
+ const pw = productWavesSpec(waves, PLYWOOD);
65
+ expect(pw.waves.every((w) => w.approval === "pull-request")).toBe(true);
66
+ expect(pw.approvals?.pullRequest).toEqual({ gate: "up" });
67
+ });
68
+
69
+ test("the words the jobs carry take the apply mode the jobs build (#4601)", () => {
70
+ expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan", "apply"), waves }).words.applyMode).toBe("on-merge");
71
+ expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan") }).words.applyMode).toBe("release");
72
+ expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan", "apply"), applyBeforeMerge: true }).words.applyMode).toBe("before-merge");
73
+ expect(productPipelineJobs("github", "production", { words: { ...only(PLYWOOD, "plan", "apply"), applyMode: "before-merge" }, waves, applyBeforeMerge: true }).words.applyMode).toBe("before-merge");
74
+ expect(productPipelineJobs("github", "production", { words: { ...only(PLYWOOD, "plan", "apply"), applyMode: "before-merge" }, waves }).words.applyMode).toBe("on-merge");
75
+ });
76
+
77
+ test("a command with no job is refused", () => {
78
+ expect(() => productPipelineJobs("github", "production", { words: TERRAGUCCI })).toThrow(/needs a apply job/);
79
+ });
80
+
81
+ test("the component graph gives the waves pr-apply --wave-gate runs on op waves", () => {
82
+ const spec = componentWavesSpec(
83
+ [{ name: "net", dependsOn: [] }, { name: "app", dependsOn: ["net"] }],
84
+ PLYWOOD,
85
+ { planWave: ["chant", "components", "plan-wave", "{runs}", "{plans}"], applyWave: ["chant", "components", "apply-wave", "{runs}", "{plans}"] },
86
+ );
87
+ expect(spec.name).toBe("pulumi-up");
88
+ expect(spec.waves.map((w) => w.runs.map((r) => r.target))).toEqual([["net"], ["app"]]);
89
+ });
90
+
91
+ test("the comment, the bin and the engine lines", () => {
92
+ expect(prApplyComment()).toBe("/chant apply");
93
+ expect(prApplyComment({ words: PLYWOOD })).toBe("/plywood up");
94
+ expect(withProductBin('git fetch && GREEN_SHA="$(chant ci last-green)"', "npx plywood")).toBe('git fetch && GREEN_SHA="$(npx plywood ci last-green)"');
95
+ expect(withProductBin("chant/lifecycle stays", "npx plywood")).toBe("chant/lifecycle stays");
96
+ expect(prLoopSetup(PR_LOOP_IMAGE)).toEqual(PR_LOOP_SETUP);
97
+ expect(prLoopSetup(PR_LOOP_IMAGE, ["install pulumi"])).toEqual(["install pulumi"]);
98
+ expect(prLoopSetup("my/image", ["install pulumi"])).toEqual([]);
99
+ });
100
+ });
101
+
102
+ describe("pr-apply --wave-gate on op waves (#4588)", () => {
103
+ const graph = [{ name: "net", dependsOn: [] }, { name: "app", dependsOn: ["net"] }];
104
+
105
+ test("the component plan-wave and apply-wave steps name the runs, the plans, the base and the outputs file", () => {
106
+ const steps = componentWaveSteps({ bin: "npx --no-install plywood", env: "prod", base: "abc123", member: "infra", op: "pr-7", gate: "up" });
107
+ expect(steps.planWave).toEqual(["npx", "--no-install", "plywood", "components", "plan-wave", "--runs", "{runs}", "--plans", "{plans}", "--env", "prod", "--base", "abc123", "--member", "infra", "--gate", "up", "--wave-outputs", componentWaveOutputsFile("pr-7")]);
108
+ expect(steps.applyWave.slice(0, 5)).toEqual(["npx", "--no-install", "plywood", "components", "apply-wave"]);
109
+ expect(componentWaveSteps({ env: "prod", base: "HEAD^1", op: "x" }).planWave[0]).toBe("chant");
110
+ });
111
+
112
+ test("under the pull request's op every wave takes its approval, whatever the words' preset", () => {
113
+ const steps = componentWaveSteps({ env: "prod", base: "abc", op: "pr-7" });
114
+ const spec = componentWavesSpec(graph, TERRAGUCCI, steps, { op: "pr-7", gate: "apply", prGate: "pr-apply" });
115
+ expect(spec.name).toBe("pr-7");
116
+ expect(spec.op).toBe("pr-7");
117
+ expect(spec.waves.every((w) => w.approval === "pull-request")).toBe(true);
118
+ expect(spec.approvals?.pullRequest).toEqual({ gate: "pr-apply" });
119
+ expect(spec.planWave).toEqual(steps.planWave);
120
+ });
121
+
122
+ test("the layers a derivation already has are kept", () => {
123
+ const spec = componentWavesSpec(graph, PLYWOOD, componentWaveSteps({ env: "prod", base: "abc", op: "pr-7" }), { op: "pr-7", waves: [["net", "app"]] });
124
+ expect(spec.waves.map((w) => w.runs.map((r) => r.target))).toEqual([["net", "app"]]);
125
+ });
126
+
127
+ test("productPipelineJobs takes the component graph's waves when the product has no spec of its own", () => {
128
+ const jobs = productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan", "apply"), componentWaves: { components: graph } });
129
+ expect(jobs.waves!.spec.name).toBe("pulumi-up");
130
+ expect(jobs.waves!.spec.planWave!.slice(3, 5)).toEqual(["components", "plan-wave"]);
131
+ expect(jobs.waves!.spec.planWave).toContain("HEAD^1");
132
+ expect(jobs.waves!.jobs.map((j) => j.jobName)).toEqual(["wave-1-wave-1", "wave-2-wave-2"]);
133
+ expect(jobs.waves!.jobs[0]!.command.slice(0, 3)).toEqual(["npx", "--no-install", "plywood"]);
134
+ });
135
+ });
136
+
137
+ describe("the lock and unlock comments (#4588)", () => {
138
+ test("productPipelineJobs gives a job per comment under locks: plan, on each forge", () => {
139
+ for (const forge of ["github", "forgejo", "gitlab"] as const) {
140
+ const jobs = productPipelineJobs(forge, "production", { words: PLYWOOD, waves, locks: "plan" });
141
+ expect(jobs.locks!.map((j) => [j.jobName, j.comment])).toEqual([["comment-lock", "/plywood lock"], ["comment-unlock", "/plywood unlock"]]);
142
+ expect(jobs.locks![0]!.line).toBe(`npx --no-install plywood lock --keep --pr "$PR_NUMBER" --forge ${forge}`);
143
+ expect(jobs.locks![1]!.line).toBe('npx --no-install plywood unlock --pr "$PR_NUMBER"');
144
+ }
145
+ const gitlab = productPipelineJobs("gitlab", "production", { words: PLYWOOD, waves, locks: "plan" });
146
+ expect(gitlab.locks![0]!.env).toEqual({ PR_NUMBER: "$CHANT_LOCK_PR" });
147
+ expect(gitlab.locks![0]!.gitlabVar).toBe("CHANT_LOCK_PR");
148
+ });
149
+
150
+ test("no comment jobs without locks: plan", () => {
151
+ expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan", "apply"), waves }).locks).toBeUndefined();
152
+ });
153
+ });
154
+
155
+ describe("the agent (#4616)", () => {
156
+ const words = { ...PLYWOOD, commands: { ...PLYWOOD.commands, agent: "agent" as const } };
157
+
158
+ test("returns the agent's Op spec for its comment, with the settings checked", () => {
159
+ const pw = productPipelineJobs("github", "production", { words: only(words, "plan", "agent"), agent: { maxRuns: 5, timeout: 20, keyEnv: "MODEL_KEY", runner: "agents" } });
160
+ expect(pw.agent?.comment).toBe("/plywood agent");
161
+ expect(pw.agent?.spec).toEqual({
162
+ name: "plywood-agent",
163
+ trigger: { kind: "pull_request" },
164
+ agent: { on: "comment", comment: "/plywood agent", maxRuns: 5, timeout: 20, keyEnv: "MODEL_KEY" },
165
+ runner: "agents",
166
+ });
167
+ expect(() => productPipelineJobs("github", "production", { words: only(words, "plan", "agent"), agent: { timeout: 0 } })).toThrow(/timeout/);
168
+ });
169
+
170
+ test("a product whose words name no agent command gets no agent", () => {
171
+ expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan"), agent: true }).agent).toBeUndefined();
172
+ expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan") }).agent).toBeUndefined();
173
+ });
174
+
175
+ test("the drift agent of a scheduled drift Op", () => {
176
+ expect(productDriftAgent(words, "plywood-drift-app", { maxRuns: 2 })).toEqual({ on: "drift", maxRuns: 2 });
177
+ expect(() => productDriftAgent(words, "plywood-drift-app", { branch: "../x" })).toThrow(/branch/);
178
+ });
179
+ });
180
+
181
+ // #4619: with a control repo on the loop or on the waves spec, the note job reads it before pr-post.
182
+ describe("the note job's read of the control repo (#4619)", () => {
183
+ test("the waves spec's control gives the note job its read step", () => {
184
+ const pw = productPipelineJobs("gitlab", "production", { words: only(PLYWOOD, "plan", "apply"), waves: { ...waves, control: { repo: "gitlab.com/acme/control", op: "deploy", member: "shop" } } });
185
+ expect(pw.post.control?.script).toContain("'https://gitlab.com/acme/control.git' '+refs/heads/chant/lifecycle:refs/heads/chant/lifecycle'");
186
+ expect(pw.post.control?.script).toContain('export CHANT_CONTROL_DIR="$chant_control_dir"');
187
+ expect(pw.post.control?.script).toContain("plywood: could not read the control repo");
188
+ });
189
+
190
+ test("the loop's control does too, with the read secret it names", () => {
191
+ const target = resolveControlTarget({ repo: "github.com/acme/control", op: "deploy", readTokenSecret: "TG_CONTROL_READ" }, "network");
192
+ const tg = productPipelineJobs("github", "production", { words: only(TERRAGUCCI, "plan"), control: { target } });
193
+ expect(tg.post.control?.env).toEqual({ CHANT_CONTROL_READ_TOKEN: "${{ secrets.TG_CONTROL_READ || github.token }}" });
194
+ });
195
+
196
+ test("without a control repo the note job reads none", () => {
197
+ expect(productPipelineJobs("forgejo", "production", { words: only(PLYWOOD, "plan", "apply"), waves }).post.control).toBeUndefined();
198
+ });
199
+ });
200
+
@@ -0,0 +1,383 @@
1
+ /**
2
+ * The product pipeline (#4550): the one chant generator terragucci's and
3
+ * plywood's pull request jobs come from. The two differ only in the words
4
+ * and presets each passes.
5
+ *
6
+ * Under the 2026-10-27 ruling (A, hybrid) the plan side is the pull request
7
+ * loop's: the plan job (`pr-plan`), the plan-note job (`pr-post`) and the
8
+ * comment jobs. The apply on merge runs on op waves: one job per wave, each
9
+ * running `chant run wave`, whose plan and apply steps come from chant's
10
+ * capabilities (#4545 for Terraform, #4541 for Pulumi and plunge). The spec
11
+ * names the steps; this module fills the op and gate names from the words
12
+ * and leaves the steps as the spec gives them.
13
+ *
14
+ * Approvals (ruling B) are a preset: `per-wave` keeps each wave's own digest
15
+ * (terragucci), and `pull-request` lets the pull request's approval apply
16
+ * every wave whose plan its change set covers (plywood), through the op
17
+ * waves' `pull-request` approval source (../op/op-waves.ts).
18
+ *
19
+ * The jobs come back as the descriptors the forge lexicons already
20
+ * serialize (`PrLoopJob`, `OpWaveJob`). A product adds its own jobs to the
21
+ * same map before it writes the file.
22
+ */
23
+
24
+ import type { ForgeKind } from "../pr-forge";
25
+ import { layerWaves } from "../gated-waves";
26
+ import { opWaveBinArgv, opWaveJobs, opWavesControlTarget, type OpWave, type OpWaveJob, type OpWavesSpec } from "../op/op-waves";
27
+ import { controlNoteCheckout, type ControlNoteCheckout } from "../control/dispatch";
28
+ import {
29
+ assertProductWords,
30
+ CHANT_WORDS,
31
+ commentLine,
32
+ type CiProductApplyMode,
33
+ type CiProductCommand,
34
+ type CiProductWords,
35
+ type CiProductWordsInput,
36
+ } from "../ci-product-words";
37
+ import { prCommentLockJobs, prCommentPreviewJob, prLoopJobs, prLoopPostJob, prLoopRunner, prStaleJob, withProductBin, type PrCommentLockJob, type PrCommentPreviewJob, type PrLoopJob, type PrLoopPipelineOptions } from "./pr-pipeline";
38
+ import type { DriverComponent } from "./driver";
39
+ import type { ScheduledOpSpec } from "../lexicon";
40
+ import type { CiRunner } from "../ci-jobs";
41
+ import { resolveAgentSpec, type OpAgentSpec } from "../ci-agent";
42
+ import type { CiResponses } from "../ci-respond";
43
+
44
+ /** Where the generator writes a product's waves spec, which chant reads at base (#4550). */
45
+ export const PRODUCT_WAVES_SPEC_DIR = ".chant/op-waves";
46
+
47
+ /** The waves spec file of op `name`: `.chant/op-waves/<name>.spec.json`. */
48
+ export function productWavesSpecFile(name: string): string {
49
+ return `${PRODUCT_WAVES_SPEC_DIR}/${name}.spec.json`;
50
+ }
51
+
52
+ /** What {@link productPipelineJobs} takes: the pull request loop's options, the words, and the waves the merge applies. */
53
+ export interface ProductPipelineOptions extends Omit<PrLoopPipelineOptions, "words" | "waveGate" | "applyOnMerge"> {
54
+ words: CiProductWordsInput | CiProductWords;
55
+ /** The workspace member the pipeline is for. */
56
+ member?: string;
57
+ /**
58
+ * The waves the apply on merge runs, as the product's config maps onto
59
+ * them. Absent: a merge records the plan (the record job), and a release
60
+ * deploys it.
61
+ */
62
+ waves?: OpWavesSpec;
63
+ /** Where the spec is written, from the job's directory. Default {@link productWavesSpecFile}. */
64
+ wavesSpecFile?: string;
65
+ /**
66
+ * The product runs an agent job that answers its agent command (#4616):
67
+ * `true` for the defaults, or the agent's settings. The pipeline then
68
+ * returns the agent's Op spec, which the product writes and generates with
69
+ * `chant run --generate <forge> --spec <file>` as it does its other
70
+ * scheduled Ops.
71
+ */
72
+ agent?: boolean | ProductAgentOptions;
73
+ /**
74
+ * The apply on merge from the component graph (#4588), when `waves` is
75
+ * absent: the spec `pr-apply --wave-gate` runs, a wave per layer of
76
+ * `components`, each run a component planned and applied through the
77
+ * component plan-wave and apply-wave steps, a wave whose plan the approval
78
+ * does not cover waiting at `<waveGate>-wave-<k>`. `base` is what the
79
+ * steps measure the change from, by default `HEAD^1`, the commit before
80
+ * the merge.
81
+ */
82
+ componentWaves?: { components: readonly Pick<DriverComponent, "name" | "dependsOn">[]; waveGate?: string; base?: string };
83
+ /**
84
+ * The responses to pipeline events (#4629, `../ci-respond.ts`): a refused
85
+ * wave's diff and a failed apply's triage, on by default, and the
86
+ * description check, off by default. The apply jobs carry them as
87
+ * `CHANT_RESPOND`, the waves spec as its `respond`.
88
+ */
89
+ respond?: CiResponses;
90
+ /**
91
+ * The decide service the description check asks (#4629): a
92
+ * `decide.backends` entry of chant.config at the target branch, and the
93
+ * pinned model. Needed with `respond.description: "check"`.
94
+ */
95
+ decide?: { backend: string; model: string };
96
+ }
97
+
98
+ /** The jobs of one product pipeline. */
99
+ export interface ProductPipelineJobs {
100
+ /** The words, every slot filled and checked. */
101
+ words: CiProductWords;
102
+ /** The plan job: `pr-plan` with the words. */
103
+ plan: PrLoopJob;
104
+ /**
105
+ * The plan-note job: `pr-post`. With a control repo named on the loop's
106
+ * `control` or the waves spec's (#4619), `control` is the step the note
107
+ * job runs before `pr-post`: a read-only fetch of the control repo's
108
+ * `chant/lifecycle` that sets `CHANT_CONTROL_DIR`, so the note marks the
109
+ * cross-stack edges.
110
+ */
111
+ post: { command: string; env: Record<string, string>; control?: ControlNoteCheckout; runner?: CiRunner };
112
+ /** The record job, when no waves apply on merge. */
113
+ record?: PrLoopJob;
114
+ /** The apply before merge, answering the apply comment, with `applyBeforeMerge`. */
115
+ applyBeforeMerge?: PrLoopJob;
116
+ /** The comment each command answers, `/<product> <word>`, for the commands the pipeline has a job for. */
117
+ comments: Partial<Record<CiProductCommand, string>>;
118
+ /** The apply on merge: the spec with the words' names, its file, and a job per wave (per share or group). */
119
+ waves?: { spec: OpWavesSpec; specFile: string; jobs: OpWaveJob[] };
120
+ /**
121
+ * The comment lock and unlock jobs (#4588), under `locks: "plan"`:
122
+ * `/<product> lock` keeps the locks the plan took, `/<product> unlock`
123
+ * releases them. The forge lexicons render the same jobs.
124
+ */
125
+ locks?: Array<PrCommentLockJob & { runner?: CiRunner }>;
126
+ /**
127
+ * The comment preview (#4620), with `previewComment`: `/<product> <plan
128
+ * word>` plans the pull request's head again with a read token, and the
129
+ * job after it posts the note. The forge lexicons render the same jobs.
130
+ */
131
+ preview?: PrCommentPreviewJob & { noteRunner?: CiRunner };
132
+ /**
133
+ * The stale marking (#4628), with `staleNotes`: the command and values of
134
+ * the job that runs on a push to the target branch and marks each open
135
+ * pull request's note posted against another commit stale. The forge
136
+ * lexicons render the same job, `stale-notes`.
137
+ */
138
+ stale?: { command: string; env: Record<string, string>; runner?: CiRunner };
139
+ /**
140
+ * The agent (#4616), with `agent`: the comment it answers, `/<product>
141
+ * agent <ask>`, and the scheduled Op spec whose generated workflow runs
142
+ * it: the agent job with a read token and the model's key, and the push
143
+ * job with the write token.
144
+ */
145
+ agent?: { comment: string; name: string; spec: ScheduledOpSpec };
146
+ }
147
+
148
+ /** An agent's settings as a product passes them (#4616): {@link OpAgentSpec} without the trigger, which the pipeline names. */
149
+ export interface ProductAgentOptions extends Omit<OpAgentSpec, "on" | "comment" | "branch"> {
150
+ /** The agent's name: its workflow, its jobs and its runs on the ledger. Default `<product>-agent`. */
151
+ name?: string;
152
+ /** Where its jobs run. */
153
+ runner?: CiRunner;
154
+ }
155
+
156
+ /** The agent's Op spec for `/<product> agent <ask>` (#4616). The settings are checked here, so a product finds a bad one when it generates. */
157
+ export function productAgentSpec(wordsIn: CiProductWordsInput | CiProductWords, comment: string, options: ProductAgentOptions = {}): ScheduledOpSpec {
158
+ const words = assertProductWords(wordsIn);
159
+ const { name: given, runner, ...settings } = options;
160
+ const name = given ?? `${words.product}-agent`;
161
+ const agent: OpAgentSpec = { on: "comment", comment, ...settings };
162
+ resolveAgentSpec(name, agent, words.product);
163
+ return { name, trigger: { kind: "pull_request" }, agent, ...(runner !== undefined ? { runner } : {}) };
164
+ }
165
+
166
+ /**
167
+ * The `agent` of a scheduled drift Op (#4616): after the Op's run exits with
168
+ * chant's `drift` code, the agent changes the code to say what is live and
169
+ * opens or updates a pull request from `<product>/agent/<op>`.
170
+ */
171
+ export function productDriftAgent(wordsIn: CiProductWordsInput | CiProductWords, op: string, options: Omit<OpAgentSpec, "on" | "comment"> = {}): OpAgentSpec {
172
+ const words = assertProductWords(wordsIn);
173
+ const agent: OpAgentSpec = { on: "drift", ...options };
174
+ resolveAgentSpec(op, agent, words.product);
175
+ return agent;
176
+ }
177
+
178
+ /**
179
+ * The waves spec with the product's names (#4550): the op the gates are
180
+ * recorded under, the wave gate pattern, and under the `pull-request`
181
+ * preset each wave's approval taken from the pull request's gate. A wave
182
+ * that names its own approval keeps it. Nothing else changes, so the plan
183
+ * and apply steps stay the capability steps the spec names.
184
+ */
185
+ export function productWavesSpec(spec: OpWavesSpec, wordsIn: CiProductWordsInput | CiProductWords): OpWavesSpec {
186
+ const words = assertProductWords(wordsIn);
187
+ const byPullRequest = words.approval === "pull-request";
188
+ return {
189
+ ...spec,
190
+ name: words.op ?? spec.name,
191
+ ...(words.gateName !== CHANT_WORDS.gateName ? { gateName: words.gateName } : {}),
192
+ waves: spec.waves.map((w): OpWave => (byPullRequest && w.approval === undefined ? { ...w, approval: "pull-request" } : w)),
193
+ ...(byPullRequest ? { approvals: { ...(spec.approvals ?? {}), pullRequest: { gate: words.prGate } } } : {}),
194
+ };
195
+ }
196
+
197
+ /**
198
+ * The product pipeline's jobs for `forge` (#4550): the plan side from the
199
+ * pull request loop with the words, and the apply on merge on op waves. The
200
+ * words are refused when a command names a job the pipeline does not have.
201
+ */
202
+ export function productPipelineJobs(forge: ForgeKind, env: string, options: ProductPipelineOptions): ProductPipelineJobs {
203
+ const jobs: CiProductCommand[] = ["plan"];
204
+ if (options.applyBeforeMerge || options.waves || options.componentWaves) jobs.push("apply");
205
+ if (options.locks === "plan") jobs.push("lock", "unlock");
206
+ if (options.agent) jobs.push("agent");
207
+ // #4601: the note's merge sentence follows the jobs built here: waves on merge, an apply before merge, else a record for a release.
208
+ // Words that ask for before-merge keep it when the pipeline has that job beside its waves.
209
+ const built: CiProductApplyMode = options.waves || options.componentWaves ? "on-merge" : options.applyBeforeMerge ? "before-merge" : "release";
210
+ const applyMode: CiProductApplyMode = options.words.applyMode === "before-merge" && options.applyBeforeMerge ? "before-merge" : built;
211
+ const words = assertProductWords({ ...options.words, applyMode }, { jobs });
212
+ const { waves: given, wavesSpecFile, member, agent: _agent, componentWaves, ...loop } = options;
213
+ const { respond } = options;
214
+ // #4629: the pull request loop puts the responses on the apply and note jobs, as `chant build --pr-loop --respond` does.
215
+ const prLoop: PrLoopPipelineOptions = { ...loop, words, gate: options.gate ?? words.prGate };
216
+ const [plan, apply, record] = prLoopJobs(forge, env, prLoop, member);
217
+ // #4625: the jobs with no stage of their own run on the default runner.
218
+ const runnerOfDefault = prLoopRunner(options, "default");
219
+ const defaultRunner: { runner?: CiRunner } = runnerOfDefault !== undefined ? { runner: runnerOfDefault } : {};
220
+ const comments: Partial<Record<CiProductCommand, string>> = {};
221
+ for (const c of jobs) {
222
+ const line = commentLine(words, c);
223
+ if (line) comments[c] = line;
224
+ }
225
+ // #4619: the loop's control target, else the waves spec's.
226
+ const controlTarget = options.control?.target ?? (given?.control ? opWavesControlTarget(given.control) : undefined);
227
+ const post = prLoopPostJob(forge, env, member, words, { ...(options.staleNotes ? { staleNotes: true } : {}), ...(respond ? { respond } : {}), ...(options.decide ? { decide: options.decide } : {}) });
228
+ const out: ProductPipelineJobs = {
229
+ words,
230
+ plan: plan!,
231
+ post: { ...post, ...(controlTarget ? { control: controlNoteCheckout(forge, controlTarget, words) } : {}), ...defaultRunner },
232
+ comments,
233
+ ...(options.applyBeforeMerge ? { applyBeforeMerge: apply! } : {}),
234
+ };
235
+ const locks = prCommentLockJobs(forge, { locks: options.locks, words });
236
+ if (locks.length > 0) out.locks = locks.map((job) => ({ ...job, ...defaultRunner }));
237
+ const stale = prStaleJob(forge, env, prLoop, member);
238
+ if (stale) out.stale = { ...stale, ...defaultRunner };
239
+ const preview = prCommentPreviewJob(forge, env, prLoop, member);
240
+ if (preview) out.preview = { ...preview, ...(defaultRunner.runner !== undefined ? { noteRunner: defaultRunner.runner } : {}) };
241
+ // #4616: the agent answers its comment from a workflow of its own, generated from this spec.
242
+ const agentComment = options.agent ? comments.agent : undefined;
243
+ if (options.agent && agentComment) {
244
+ const spec = productAgentSpec(words, agentComment, options.agent === true ? {} : options.agent);
245
+ out.agent = { comment: agentComment, name: spec.name, spec };
246
+ }
247
+ // #4588: without a spec of the product's own, the component graph's waves on op waves.
248
+ const op = words.op ?? componentWaves?.waveGate ?? words.prGate;
249
+ const spec = given ?? (componentWaves
250
+ ? componentWavesSpec(componentWaves.components, words, componentWaveSteps({ ...(words.bin ? { bin: words.bin } : {}), env, base: componentWaves.base ?? "HEAD^1", ...(member ? { member } : {}), op, gate: prLoop.gate }), { ...(componentWaves.waveGate ? { gate: componentWaves.waveGate } : {}) })
251
+ : undefined);
252
+ if (!spec) return { ...out, record: record! };
253
+ const wavesRespond = respond ? Object.fromEntries(Object.entries(respond).filter(([e]) => e !== "description")) : {};
254
+ // #4625: the waves run on the apply runner and with the plan's parallelism, unless the spec names its own.
255
+ const applyRunner = prLoopRunner(options, "apply");
256
+ const named = {
257
+ ...productWavesSpec(
258
+ {
259
+ ...spec,
260
+ ...(spec.runner === undefined && applyRunner !== undefined ? { runner: applyRunner } : {}),
261
+ ...(spec.parallelism === undefined && options.parallelism !== undefined && spec.step !== undefined ? { parallelism: options.parallelism } : {}),
262
+ },
263
+ words,
264
+ ),
265
+ ...(Object.keys(wavesRespond).length > 0 ? { respond: { ...(spec.respond ?? {}), ...wavesRespond } } : {}),
266
+ };
267
+ const specFile = wavesSpecFile ?? productWavesSpecFile(named.name);
268
+ return { ...out, waves: { spec: named, specFile, jobs: opWaveJobs(named, specFile, { bin: words.bin }) } };
269
+ }
270
+
271
+ /** The capability steps a component waves spec runs (#4545, #4541): argv templates over `{runs}` and `{plans}`. */
272
+ export interface ComponentWaveSteps {
273
+ /** Plan every run of a wave through the capability registry, writing `{plans}`. */
274
+ planWave: string[];
275
+ /** Apply a wave's approved set through the capability registry. */
276
+ applyWave: string[];
277
+ }
278
+
279
+ /** Where a component waves spec keeps the outputs each wave's components left, for the next wave's plans (#4588). */
280
+ export function componentWaveOutputsFile(op: string): string {
281
+ return `${PRODUCT_WAVES_SPEC_DIR}/${op}/outputs.json`;
282
+ }
283
+
284
+ /** What {@link componentWaveSteps} names on each step's line (#4588). */
285
+ export interface ComponentWaveStepOptions {
286
+ /** The command in place of `chant`, a product's `words.bin`. */
287
+ bin?: string;
288
+ env: string;
289
+ /** The commit the change is measured from: what `pr-apply` was given. */
290
+ base: string;
291
+ /** The commit applied. Absent: the job's checkout. */
292
+ head?: string;
293
+ /** The workspace member. */
294
+ member?: string;
295
+ /** The file the waves hand outputs on in. Default {@link componentWaveOutputsFile} of `op`. */
296
+ outputs?: string;
297
+ /** The op the outputs file is named by. */
298
+ op: string;
299
+ /** The pull request's gate, whose rows file the apply leases on the resource grain. */
300
+ gate?: string;
301
+ }
302
+
303
+ /**
304
+ * The component plan-wave and apply-wave steps (#4588): `chant components
305
+ * plan-wave` plans a wave's components through the project's capabilities
306
+ * and writes the op-waves plans file with the wave's change set, and
307
+ * `chant components apply-wave` plans the approved runs again, refuses any
308
+ * whose plan moved (exit 4), and applies the rest. Both read the outputs
309
+ * the waves before them left from the outputs file, and apply-wave adds its
310
+ * own.
311
+ */
312
+ export function componentWaveSteps(options: ComponentWaveStepOptions): ComponentWaveSteps {
313
+ const bin = opWaveBinArgv(options.bin);
314
+ const common = [
315
+ "--env", options.env, "--base", options.base,
316
+ ...(options.head ? ["--head", options.head] : []),
317
+ ...(options.member ? ["--member", options.member] : []),
318
+ ...(options.gate ? ["--gate", options.gate] : []),
319
+ "--wave-outputs", options.outputs ?? componentWaveOutputsFile(options.op),
320
+ ];
321
+ return {
322
+ planWave: [...bin, "components", "plan-wave", "--runs", "{runs}", "--plans", "{plans}", ...common],
323
+ applyWave: [...bin, "components", "apply-wave", "--runs", "{runs}", "--plans", "{plans}", ...common],
324
+ };
325
+ }
326
+
327
+ /** What {@link componentWavesSpec} takes beside the graph, the words and the steps. */
328
+ export interface ComponentWavesSpecOptions {
329
+ /** The wave gate's base name: wave k waits at `<gate>-wave-<k>` (or the words' `gateName`). Default the words' `prGate`. */
330
+ gate?: string;
331
+ branches?: string[];
332
+ /**
333
+ * The op the gates are recorded under. `pr-apply --wave-gate` passes the
334
+ * pull request's (`pr-<n>`), and then every wave takes the pull request's
335
+ * approval whatever the words' preset. Default the words' `op`.
336
+ */
337
+ op?: string;
338
+ /** The pull request's gate, whose approval a wave applies under when it covers the wave. Default the words' `prGate`. */
339
+ prGate?: string;
340
+ /** The layers, when the caller already has them (a derivation's `waves`). Default: layered from `dependsOn`. */
341
+ waves?: readonly (readonly string[])[];
342
+ }
343
+
344
+ /**
345
+ * A waves spec from the component graph (#4550, ruling A; #4588): a wave per
346
+ * layer of the graph, each run a component, planned and applied through the
347
+ * component plan-wave and apply-wave steps under the words' op and gate
348
+ * names. `pr-apply --wave-gate` runs its waves on it.
349
+ */
350
+ export function componentWavesSpec(
351
+ components: readonly Pick<DriverComponent, "name" | "dependsOn">[],
352
+ wordsIn: CiProductWordsInput | CiProductWords,
353
+ steps: ComponentWaveSteps,
354
+ options: ComponentWavesSpecOptions = {},
355
+ ): OpWavesSpec {
356
+ const words = assertProductWords(wordsIn);
357
+ const layers = options.waves ?? layerWaves(components.map((c) => ({ name: c.name, dependsOn: c.dependsOn ?? [] })));
358
+ const name = options.op ?? words.op ?? options.gate ?? words.prGate;
359
+ const spec: OpWavesSpec = {
360
+ name,
361
+ op: name,
362
+ gate: options.gate ?? words.prGate,
363
+ planWave: steps.planWave,
364
+ applyWave: steps.applyWave,
365
+ ...(options.branches ? { branches: options.branches } : {}),
366
+ waves: layers.map((layer, i) => ({ name: `wave-${i + 1}`, runs: layer.map((target) => ({ target })) })),
367
+ };
368
+ const named = productWavesSpec(spec, words);
369
+ if (options.op === undefined) return named;
370
+ // The pull request's own op: every wave applies under its approval when that covers the wave's plan, else at its own gate.
371
+ return {
372
+ ...named,
373
+ name: options.op,
374
+ op: options.op,
375
+ waves: named.waves.map((w) => ({ ...w, approval: "pull-request" as const })),
376
+ approvals: { ...(named.approvals ?? {}), pullRequest: { gate: options.prGate ?? words.prGate } },
377
+ };
378
+ }
379
+
380
+ /** A shell line with the product's bin in place of `chant`, for a product's own jobs beside these. */
381
+ export function productCommand(words: CiProductWords, line: string): string {
382
+ return withProductBin(line, words.bin);
383
+ }
@@ -61,6 +61,8 @@ import { planAndRunComponentGroup, runComponentGroup } from "./groups";
61
61
  import type { Release } from "../lifecycle/release-store";
62
62
  import type { RunProgressEvent } from "./run-progress";
63
63
  import type { RunEventSink } from "../run-event-stream";
64
+ import type { LockGrain } from "../lifecycle/lock-rows";
65
+ import type { RowLeasePort } from "./row-lease";
64
66
 
65
67
  /**
66
68
  * Step kinds that produce an artifact at build time: the build family, and the
@@ -651,6 +653,10 @@ export interface RunPromotionOptions {
651
653
  groupRuns?: readonly GroupRun[];
652
654
  /** A promote with no release gate to bind plans each group in its wave (#4465). */
653
655
  planGroupsAtWave?: boolean;
656
+ /** `ci.lockGrain` as declared (#4594), for every step's `DeployContext.lockGrain`. */
657
+ lockGrain?: LockGrain;
658
+ /** The run's row lease (#4594): a step or group on the resource grain leases its rows through it before it applies. Absent: no lease. */
659
+ rowLease?: RowLeasePort;
654
660
  }
655
661
 
656
662
  /** The run in `runs` that plans exactly the members of `group`. */
@@ -678,6 +684,8 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
678
684
  const item = plan.items.find((i) => i.component === component);
679
685
  return item ? { version: item.digest, revision: item.source.gitSha } : undefined;
680
686
  };
687
+ // #4594: the grain and the row lease reach every step and group.
688
+ const leasing = { ...(options.lockGrain ? { lockGrain: options.lockGrain } : {}), ...(options.rowLease ? { rowLease: options.rowLease } : {}) };
681
689
  // ws-107 (#4465): a group applies as one, through its approved plan.
682
690
  const grouped = options.grouped?.groups?.length ? options.grouped : undefined;
683
691
  const byName = new Map(targets.map((c) => [c.name, c]));
@@ -691,7 +699,7 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
691
699
  components: byName,
692
700
  registry,
693
701
  env: plan.to,
694
- ctxOf: (name: string) => deployContext({ env: plan.to, releaseIdentity }, name),
702
+ ctxOf: (name: string) => deployContext({ env: plan.to, releaseIdentity, ...leasing }, name),
695
703
  componentOutputs,
696
704
  };
697
705
  const approved = approvedRunOf(options.groupRuns, group);
@@ -708,6 +716,7 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
708
716
  releases: expected,
709
717
  // #3061: the workload's service.version and vcs.ref.head.revision are the earlier release's own.
710
718
  releaseIdentity,
719
+ ...leasing,
711
720
  ...(groups ? { groups } : {}),
712
721
  ...(options.onProgress ? { onProgress: options.onProgress } : {}),
713
722
  ...(options.onRunEvent ? { onRunEvent: options.onRunEvent } : {}),