@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
@@ -87,13 +87,19 @@
87
87
 
88
88
  import type { ForgeKind } from "../pr-forge";
89
89
  import { PR_APPLY_GATE } from "../pr-loop";
90
- import { CI_IMAGE, GITHUB_JOB_TOKEN } from "../ci-jobs";
91
- import { withoutForgeTokens } from "../ci-handover";
90
+ import { parseRequiresList } from "../pr-requires";
91
+ import { CI_IMAGE, GITHUB_JOB_TOKEN, githubSecret, PR_ENV_REPORT_DIR, type CiRunner } from "../ci-jobs";
92
+ import { FORGE_TOKEN_VARS, withoutForgeTokens } from "../ci-handover";
93
+ import { OIDC_REQUEST_VARS } from "../ci-identity";
94
+ import { parallelismProblem } from "../parallelism";
92
95
  import { EMPTY_TREE_SHA } from "./changed-files";
93
96
  import { layerWaves } from "../gated-waves";
94
97
  import type { DriverComponent } from "./driver";
95
98
  import type { GatedWavePipelineOptions } from "./gated-wave-pipeline";
96
99
  import type { CloudTradeSpec, PipelineCloudIdentity } from "../ci-identity";
100
+ import { commentLine, resolveProductWords, type CiProductWords, type CiProductWordsInput } from "../ci-product-words";
101
+ import type { ControlTarget } from "../control/dispatch";
102
+ import { CI_RESPOND_ENV, respondList, type CiResponses } from "../ci-respond";
97
103
 
98
104
  /** The variable `chant ci run` reads its runner key from (`RUNNER_KEY_ENV` in ../workspace/ci-green.ts). */
99
105
  const RUNNER_KEY_ENV = "CHANT_RUNNER_KEY";
@@ -121,9 +127,25 @@ export const PR_LOOP_SETUP = [
121
127
  "command -v tofu >/dev/null 2>&1 || (curl -fsSL https://get.opentofu.org/install-opentofu.sh -o /tmp/install-opentofu.sh && sh /tmp/install-opentofu.sh --install-method standalone)",
122
128
  ];
123
129
 
124
- /** The setup lines for a pipeline running in `image`: the install when it is the default image, none otherwise. */
125
- export function prLoopSetup(image: string): string[] {
126
- return image === PR_LOOP_IMAGE ? PR_LOOP_SETUP : [];
130
+ /**
131
+ * The setup lines for a pipeline running in `image`: the install when it is
132
+ * the default image, none otherwise. `engine` is the lines the project's
133
+ * lexicons give (#4550, `LexiconPlugin.ciSetup`, {@link engineSetupLines}):
134
+ * Pulumi or plunge for a Pulumi member, OpenTofu for a Terraform one. Absent,
135
+ * OpenTofu, as before.
136
+ */
137
+ export function prLoopSetup(image: string, engine?: readonly string[]): string[] {
138
+ if (image !== PR_LOOP_IMAGE) return [];
139
+ return engine && engine.length > 0 ? [...engine] : PR_LOOP_SETUP;
140
+ }
141
+
142
+ /**
143
+ * Join the setup lines each lexicon gives (#4550), each line once, in the
144
+ * order the lexicons come. A project whose lexicons give none gets none, and
145
+ * {@link prLoopSetup} then falls back to OpenTofu.
146
+ */
147
+ export function engineSetupLines(perLexicon: ReadonlyArray<readonly string[] | undefined>): string[] {
148
+ return [...new Set(perLexicon.flatMap((lines) => lines ?? []))];
127
149
  }
128
150
 
129
151
  /**
@@ -162,6 +184,20 @@ export interface PrLoopPipelineOptions {
162
184
  * `waveGate` nor `build`.
163
185
  */
164
186
  applyBeforeMerge?: boolean;
187
+ /**
188
+ * The requires checks the apply before merge asks (#4607): a product's
189
+ * `apply.requires`, passed as `pr-apply --requires <list>`. Absent: all
190
+ * four. Only with `applyBeforeMerge`.
191
+ */
192
+ applyRequires?: readonly string[];
193
+ /**
194
+ * Merge the pull request once its update before merge applied (#4636):
195
+ * `pr-apply --merge auto --merge-token-env <tokenEnv>`. The token is the
196
+ * merge's alone: on GitHub and Forgejo the job maps it from the secret of
197
+ * that name, on GitLab it is a protected variable the project sets. Only
198
+ * with `applyBeforeMerge`.
199
+ */
200
+ applyMerge?: { tokenEnv: string; method?: "merge" | "squash" | "rebase" };
165
201
  /**
166
202
  * Stream each job's run events (#4007): `--events-json` on both commands,
167
203
  * and `CHANT_RUN_EVENTS_DIR` set to {@link PR_LOOP_EVENTS_DIR}. Default false.
@@ -223,6 +259,14 @@ export interface PrLoopPipelineOptions {
223
259
  * base; GitHub and Forgejo only. Absent: neither job.
224
260
  */
225
261
  locks?: "plan";
262
+ /**
263
+ * `ci.lockGrain: repo` (#4552): one apply at a time in the repository.
264
+ * GitHub's apply jobs share the concurrency group `chant-apply-repo`,
265
+ * GitLab's the resource group of that name, and Forgejo's take the lock
266
+ * tag `refs/tags/chant-apply-lock` in the apply step (./repo-lock.ts). Set
267
+ * from the declaration at base. Absent: per environment and member.
268
+ */
269
+ lockGrain?: "repo";
226
270
  /**
227
271
  * The cloud identity a pull request environment's jobs take (#4330), from
228
272
  * `ci.identity.cloud` (`resolvePrEnvCloudIdentity` in ../ci-identity.ts):
@@ -232,6 +276,166 @@ export interface PrLoopPipelineOptions {
232
276
  * Absent: they request no OIDC token.
233
277
  */
234
278
  prEnvIdentity?: CloudTradeSpec;
279
+ /**
280
+ * The product's words (#4550, `@intentius/chant/ci-product`): the comment
281
+ * a job answers, and with `bin` the command every job runs in place of
282
+ * `chant`, whose bin passes the rest to chant in process with the words.
283
+ * The statuses and the note take the words in the running job, from the
284
+ * bin. Absent: chant's.
285
+ */
286
+ words?: CiProductWordsInput | CiProductWords;
287
+ /** The engine install lines of the project's lexicons (#4550), for {@link prLoopSetup}. */
288
+ engineSetup?: string[];
289
+ /**
290
+ * The control repo (#4568, `@intentius/chant/ci-control`): after the last
291
+ * apply on merge succeeds, a `control-dispatch` job tells the control
292
+ * repo this member applied, and the control repo runs its dependents.
293
+ * The job maps the target's secret into `CHANT_CONTROL_TOKEN` for its one
294
+ * step; on GitLab, where a CI/CD variable reaches every job, the plan job
295
+ * unsets it with the forge tokens. `sentCheck` and `markSent` are the
296
+ * product's shell lines that find and set the commit's control status.
297
+ * Needs `applyOnMerge` or `waveGate`; ignored under `applyBeforeMerge`,
298
+ * which applies no default branch.
299
+ */
300
+ control?: { target: ControlTarget; sentCheck?: string; markSent?: string };
301
+ /**
302
+ * A comment preview (#4620): `/<product> <plan word>` on a pull request
303
+ * plans its head again in a job that holds only a read token, and a job
304
+ * after it posts the note ({@link prCommentPreviewJob}). The words must
305
+ * name a `plan` command. Set from `--preview-comment` beside `--pr-loop`.
306
+ * Default false.
307
+ */
308
+ previewComment?: boolean;
309
+ /**
310
+ * Where the pull request loop's jobs run (#4625), by stage: `plan` for the
311
+ * plan and the comment preview, `apply` for the apply jobs, the record
312
+ * job and a pull request environment's up, down and sweep, and `default`
313
+ * for every other job (the note jobs, the lock jobs, the control
314
+ * dispatch) and for a stage left out. A plywood `runners` key maps
315
+ * `preview` onto `plan` and `up` onto `apply`. Absent: the forge's
316
+ * default runner.
317
+ */
318
+ runners?: PrLoopRunners;
319
+ /**
320
+ * Variables for the jobs that plan or apply (#4625): the plan, the
321
+ * comment preview, the apply and the record. Values as the forge reads
322
+ * them; a name of a forge token or a token request variable is refused.
323
+ */
324
+ variables?: Record<string, string>;
325
+ /**
326
+ * Secrets passed to the same jobs (#4625), as `{ <variable>: <secret> }`:
327
+ * the repository secret named `<secret>` as `<variable>`. GitHub and
328
+ * Forgejo map `secrets.<secret>`; GitLab, where every job has the CI/CD
329
+ * variables, maps `$<secret>` when the names differ. The plan job still
330
+ * drops the forge tokens before the change's code runs, and a passed name
331
+ * of a forge token is refused.
332
+ */
333
+ secrets?: Record<string, string>;
334
+ /**
335
+ * How many members of a wave the plan job plans at once (#4625): `pr-plan
336
+ * --parallelism <n>`, on the plan and the comment preview. Absent: all of
337
+ * a wave's members at once.
338
+ */
339
+ parallelism?: number;
340
+ /**
341
+ * The plan narrows to the `--target` addresses of the preview comment
342
+ * (#4626): `pr-plan --comment-targets`, which reads the comment from
343
+ * {@link PREVIEW_COMMENT_ENV}. {@link prCommentPreviewJob} sets it on its
344
+ * own plan; a caller never needs to.
345
+ */
346
+ commentTargets?: boolean;
347
+ /**
348
+ * The plan and the comment preview refresh each step's state first
349
+ * (#4627): `pr-plan --refresh`, pulumi/actions' `refresh`. A member whose
350
+ * capability cannot is refused by name. Default false.
351
+ */
352
+ refresh?: boolean;
353
+ /**
354
+ * Stale marking (#4628): the plan note carries the target branch's commit
355
+ * it was posted against, and a `stale-notes` job on each push to the
356
+ * target branch marks every open pull request's note posted against
357
+ * another commit stale, naming the plan comment under `previewComment`,
358
+ * and sets its plan status back to pending ({@link prStaleJob}). Set
359
+ * from `--stale-notes` beside `--pr-loop`. Default false.
360
+ */
361
+ staleNotes?: boolean;
362
+ /**
363
+ * The responses to pipeline events (#4629, ../ci-respond.ts), from
364
+ * `chant build --pr-loop --respond <list>`: the apply job and the
365
+ * plan-note job carry the list as `CHANT_RESPOND`. Absent, or every event
366
+ * at its default: neither job sets it.
367
+ */
368
+ respond?: CiResponses;
369
+ /**
370
+ * The decide service the description check asks (#4629), from
371
+ * `--decide-backend` and `--decide-model`: the plan-note job passes both
372
+ * to `pr-post`. Needed with `respond.description: "check"`.
373
+ */
374
+ decide?: { backend: string; model: string };
375
+ }
376
+
377
+ /** The `CHANT_RESPOND` value of `respond` (#4629), or undefined when every event is at its default. Throws on a description check with no decide service. */
378
+ export function prLoopRespondEnv(options: Pick<PrLoopPipelineOptions, "respond" | "decide">): Record<string, string> {
379
+ if (options.respond?.description === "check" && !options.decide) throw new Error("respond.description: check asks a decide service, so the pipeline needs decide: { backend, model }");
380
+ const list = options.respond ? respondList(options.respond) : "";
381
+ return list ? { [CI_RESPOND_ENV]: list } : {};
382
+ }
383
+
384
+ /** The variable the comment preview's plan reads the comment from (#4626); never a shell argument. */
385
+ export const PREVIEW_COMMENT_ENV = "CHANT_PREVIEW_COMMENT";
386
+
387
+ /** Where the pull request loop's jobs run, by stage (#4625). */
388
+ export interface PrLoopRunners {
389
+ plan?: CiRunner;
390
+ apply?: CiRunner;
391
+ default?: CiRunner;
392
+ }
393
+
394
+ /** A pull request loop job's stage for its runner (#4625). */
395
+ export type PrLoopRunnerStage = keyof PrLoopRunners;
396
+
397
+ /** The runner of `stage` (#4625): the stage's own, else `default`, else undefined for the forge's default. */
398
+ export function prLoopRunner(options: Pick<PrLoopPipelineOptions, "runners">, stage: PrLoopRunnerStage): CiRunner | undefined {
399
+ return options.runners?.[stage] ?? options.runners?.default;
400
+ }
401
+
402
+ /**
403
+ * The runner stage of a pull request loop job by its name (#4625), with a
404
+ * workspace member's `<member>-` prefix taken off first: the plan and the
405
+ * comment preview plan; the apply jobs, the record job and a pull request
406
+ * environment's up, down and sweep apply; every other job runs on the
407
+ * default.
408
+ */
409
+ export function prLoopJobStage(name: string, member?: string): PrLoopRunnerStage {
410
+ const bare = member && name.startsWith(`${member}-`) ? name.slice(member.length + 1) : name;
411
+ if (bare === "plan" || bare === PR_COMMENT_PREVIEW_JOB) return "plan";
412
+ if (bare === "apply" || bare === "record" || /^apply-wave-\d+$/.test(bare) || bare === "env-up" || bare === "env-down" || bare === "env-sweep") return "apply";
413
+ return "default";
414
+ }
415
+
416
+ /**
417
+ * The variables and passed secrets of the jobs that plan or apply (#4625),
418
+ * as the forge spells them. Throws on a name the loop sets itself or a
419
+ * forge token, which the plan must be able to drop.
420
+ */
421
+ export function prLoopPassedEnv(forge: ForgeKind, options: Pick<PrLoopPipelineOptions, "variables" | "secrets">): Record<string, string> {
422
+ const reserved = new Set<string>([...FORGE_TOKEN_VARS, ...OIDC_REQUEST_VARS, "BASE_SHA", "PR_NUMBER", "HEAD_SHA", "GREEN_SHA", "CHANT_RUN_EVENTS_DIR", "CHANT_RUNNER_KEY"]);
423
+ const out: Record<string, string> = {};
424
+ const name = /^[A-Za-z_][A-Za-z0-9_]*$/;
425
+ for (const [key, value] of Object.entries(options.variables ?? {})) {
426
+ if (!name.test(key)) throw new Error(`the pull request jobs' variable ${JSON.stringify(key)} is not a variable name`);
427
+ if (reserved.has(key)) throw new Error(`the pull request jobs' variable ${key} is one the jobs set or drop themselves; give it another name`);
428
+ out[key] = value;
429
+ }
430
+ for (const [key, secret] of Object.entries(options.secrets ?? {})) {
431
+ if (!name.test(key) || !name.test(secret)) throw new Error(`the passed secret ${JSON.stringify(key)}: ${JSON.stringify(secret)} must map a variable name to a secret name`);
432
+ if (reserved.has(key)) throw new Error(`the passed secret ${key} is a name the jobs set or drop themselves, and the plan job drops the forge tokens before the change's code runs; pass it under another name`);
433
+ if (key in out) throw new Error(`${key} is both a variable and a passed secret of the pull request jobs; give one`);
434
+ if (forge === "gitlab") {
435
+ if (key !== secret) out[key] = `$${secret}`;
436
+ } else out[key] = githubSecret(secret);
437
+ }
438
+ return out;
235
439
  }
236
440
 
237
441
  /** The lock job's step names and commands (#4327), shared by the GitHub-shaped generators. */
@@ -246,6 +450,178 @@ export function prLockCommand(forge: ForgeKind): string {
246
450
  /** `chant unlock` for the pull request that closed; reads `PR_NUMBER`. */
247
451
  export const PR_UNLOCK_COMMAND = 'chant unlock --pr "$PR_NUMBER"';
248
452
 
453
+ /** The job answering `/<product> lock` (#4588). */
454
+ export const PR_COMMENT_LOCK_JOB = "comment-lock";
455
+ /** The job answering `/<product> unlock` (#4588). */
456
+ export const PR_COMMENT_UNLOCK_JOB = "comment-unlock";
457
+
458
+ /** The GitLab variables a pipeline of the target branch is started with to lock or unlock a merge request (#4588), as `CHANT_APPLY_PR` applies one. */
459
+ export const GITLAB_LOCK_PR_VAR = "CHANT_LOCK_PR";
460
+ export const GITLAB_UNLOCK_PR_VAR = "CHANT_UNLOCK_PR";
461
+
462
+ /** A comment lock or unlock job (#4588): the comment it answers, its command, and the values the command reads. */
463
+ export interface PrCommentLockJob {
464
+ jobName: typeof PR_COMMENT_LOCK_JOB | typeof PR_COMMENT_UNLOCK_JOB;
465
+ /** Which comment command it answers. */
466
+ command: "lock" | "unlock";
467
+ /** The comment, `/<product> <word>`. */
468
+ comment: string;
469
+ /** The command line. Reads `$PR_NUMBER`. */
470
+ line: string;
471
+ /** The values it reads, as the forge spells them. On GitLab `PR_NUMBER` comes from {@link GITLAB_LOCK_PR_VAR} or {@link GITLAB_UNLOCK_PR_VAR}. */
472
+ env: Record<string, string>;
473
+ /** On GitLab, the variable a pipeline of the target branch is started with. */
474
+ gitlabVar?: string;
475
+ }
476
+
477
+ /**
478
+ * The comment lock and unlock jobs (#4588), under `ci.locks: plan` when the
479
+ * words name the `lock` and `unlock` commands. `/<product> lock` runs `chant
480
+ * lock --keep`, which keeps the locks the pull request's plan took until it
481
+ * closes; `/<product> unlock` runs `chant unlock`, which releases them. Both
482
+ * run at the target branch's commit, so no code of the change runs, and
483
+ * GitHub asks for a commenter who can write as it does for the apply
484
+ * comment. GitLab starts no pipeline on a note, so there each job runs in a
485
+ * pipeline of the target branch started with {@link GITLAB_LOCK_PR_VAR} or
486
+ * {@link GITLAB_UNLOCK_PR_VAR} set to the merge request's iid.
487
+ */
488
+ export function prCommentLockJobs(forge: ForgeKind, options: Pick<PrLoopPipelineOptions, "locks" | "words"> = {}): PrCommentLockJob[] {
489
+ if (options.locks !== "plan") return [];
490
+ const words = resolveProductWords(options.words);
491
+ const github = forge !== "gitlab";
492
+ const out: PrCommentLockJob[] = [];
493
+ for (const command of ["lock", "unlock"] as const) {
494
+ const comment = commentLine(words, command);
495
+ if (!comment) continue;
496
+ const gitlabVar = command === "lock" ? GITLAB_LOCK_PR_VAR : GITLAB_UNLOCK_PR_VAR;
497
+ const line = command === "lock" ? ["chant", "lock", "--keep", "--pr", '"$PR_NUMBER"', "--forge", forge].join(" ") : PR_UNLOCK_COMMAND;
498
+ out.push({
499
+ jobName: command === "lock" ? PR_COMMENT_LOCK_JOB : PR_COMMENT_UNLOCK_JOB,
500
+ command,
501
+ comment,
502
+ line: withProductBin(line, words.bin),
503
+ env: github ? { PR_NUMBER: "${{ github.event.issue.number }}", GITHUB_TOKEN: GITHUB_JOB_TOKEN } : { PR_NUMBER: `$${gitlabVar}` },
504
+ ...(github ? {} : { gitlabVar }),
505
+ });
506
+ }
507
+ return out;
508
+ }
509
+
510
+ /** The job answering `/<product> <plan word>` (#4620). */
511
+ export const PR_COMMENT_PREVIEW_JOB = "comment-preview";
512
+ /** The job that posts the comment preview's note and status (#4620). */
513
+ export const PR_COMMENT_PREVIEW_NOTE_JOB = "comment-preview-note";
514
+ /** The GitLab variable a pipeline of the target branch is started with to preview a merge request again (#4620). */
515
+ export const GITLAB_PREVIEW_PR_VAR = "CHANT_PREVIEW_PR";
516
+ /** The variable the GitHub-shaped preview job's checkout script reads the pull request's head ref from (#4620). */
517
+ export const PREVIEW_REF_ENV = "CHANT_PREVIEW_REF";
518
+ /** The preview job's output that carries the commit it checked out, set before any of the change's code runs (#4620). */
519
+ export const PREVIEW_HEAD_OUTPUT = "head";
520
+
521
+ /** The comment preview's two jobs (#4620): the plan at the pull request's head, and the post after it. */
522
+ export interface PrCommentPreviewJob {
523
+ jobName: typeof PR_COMMENT_PREVIEW_JOB;
524
+ noteJobName: typeof PR_COMMENT_PREVIEW_NOTE_JOB;
525
+ /** The comment it answers, `/<product> <plan word>`. */
526
+ comment: string;
527
+ /**
528
+ * The plan job's command, as the pull request's plan job runs it, with
529
+ * `PR_NUMBER` from the comment (or {@link GITLAB_PREVIEW_PR_VAR}) and
530
+ * `BASE_SHA` left to {@link base}.
531
+ */
532
+ plan: PrLoopJob;
533
+ /** The shell line that sets `BASE_SHA` to the target branch's commit, run after the checkout. */
534
+ base: string;
535
+ /**
536
+ * GitHub and Forgejo: the ref the checkout script fetches through
537
+ * {@link PREVIEW_REF_ENV}. GitLab: the line that checks out the merge
538
+ * request's head, in the job's own clone.
539
+ */
540
+ head: { ref: string } | { line: string };
541
+ /** The post job's command, the values it reads, and on GitLab the line that finds the head it posts for. */
542
+ post: { command: string; env: Record<string, string>; setup?: string[] };
543
+ /** On GitLab, the variable a pipeline of the target branch is started with. */
544
+ gitlabVar?: string;
545
+ }
546
+
547
+ /**
548
+ * The comment preview (#4620), with `previewComment`: `/<product> <plan
549
+ * word>` on an open pull request runs the plan job's `pr-plan` again at the
550
+ * pull request's head, in a job that holds only a read token and drops it
551
+ * before the change's code runs, as the plan job does (#4295). The job after
552
+ * it checks out the target branch's commit, takes the report back and posts
553
+ * the note and the plan status with `pr-post`, as `plan-note` does.
554
+ *
555
+ * On GitHub the commenter must be able to write, as for the lock and unlock
556
+ * comments (#4588); Forgejo's payload says nothing of the commenter. GitLab
557
+ * starts no pipeline on a note, so there both jobs run in a pipeline of the
558
+ * target branch started with {@link GITLAB_PREVIEW_PR_VAR} set to the merge
559
+ * request's iid. The plan job unsets the forge tokens before it checks out
560
+ * the merge request's head, and the post job finds that head again with `git
561
+ * ls-remote`; a report for another head is refused by `pr-post`.
562
+ *
563
+ * Undefined without `previewComment`. Throws when the words name no `plan`
564
+ * command, since no comment would start the job.
565
+ */
566
+ export function prCommentPreviewJob(forge: ForgeKind, env: string, options: PrLoopPipelineOptions = {}, member?: string): PrCommentPreviewJob | undefined {
567
+ if (!options.previewComment) return undefined;
568
+ const words = resolveProductWords(options.words);
569
+ const comment = commentLine(words, "plan");
570
+ if (!comment) throw new Error(`--preview-comment answers /${words.product} <plan command>, and the words name no plan command; name one in the words' commands, or drop --preview-comment`);
571
+ // The plan job's own command: the apply side's options never reach it, so they are left out here.
572
+ const { applyBeforeMerge: _early, applyRequires: _requires, applyMerge: _merge, applyOnMerge: _onMerge, respond: _respond, decide: _decide, ...planSide } = options;
573
+ // #4626: the comment's --target addresses narrow the preview, read from the comment in a variable.
574
+ const [plan] = prLoopJobs(forge, env, { ...planSide, commentTargets: true }, member);
575
+ const github = forge !== "gitlab";
576
+ const prNumber = github ? "${{ github.event.issue.number }}" : `$${GITLAB_PREVIEW_PR_VAR}`;
577
+ // GitLab: whoever starts the target-branch pipeline passes the comment as CHANT_PREVIEW_COMMENT, a pipeline variable every job has.
578
+ const fromComment = (jobEnv: Record<string, string>): Record<string, string> => {
579
+ const { BASE_SHA: _base, ...rest } = jobEnv;
580
+ return github ? { ...rest, PR_NUMBER: prNumber, [PREVIEW_COMMENT_ENV]: "${{ github.event.comment.body }}" } : { ...rest, PR_NUMBER: prNumber, BASE_SHA: "$CI_COMMIT_SHA" };
581
+ };
582
+ const branch = options.branch ?? "main";
583
+ const base = github
584
+ ? `BASE_SHA="$(git rev-parse --verify "refs/remotes/origin/${branch.replace(/"/g, "")}^{commit}")" && export BASE_SHA`
585
+ : 'BASE_SHA="$CI_COMMIT_SHA" && export BASE_SHA';
586
+ const postCommand = withProductBin(
587
+ [
588
+ "chant", "components", "pr-post", "--pr", '"$PR_NUMBER"', "--head", '"$HEAD_SHA"',
589
+ "--env", env, "--output", PR_LOOP_REPORT_DIR, "--forge", forge,
590
+ ...(member ? ["--member", member] : []),
591
+ ...(github ? ["--result", '"$PLAN_RESULT"'] : []),
592
+ // #4628: the target branch's commit the preview measured from, for the note's tip line.
593
+ ...(options.staleNotes ? ["--tip", '"$TIP_SHA"'] : []),
594
+ ].join(" "),
595
+ words.bin,
596
+ );
597
+ const tipEnv: Record<string, string> = options.staleNotes ? { TIP_SHA: github ? "${{ github.sha }}" : "$CI_COMMIT_SHA" } : {};
598
+ return {
599
+ jobName: PR_COMMENT_PREVIEW_JOB,
600
+ noteJobName: PR_COMMENT_PREVIEW_NOTE_JOB,
601
+ comment,
602
+ plan: { ...plan!, env: fromComment(plan!.env), run: { ...plan!.run, env: fromComment(plan!.run.env) } },
603
+ base,
604
+ head: github ? { ref: `refs/pull/${prNumber}/head` } : { line: pullRequestCheckout("gitlab") },
605
+ post: github
606
+ ? {
607
+ command: postCommand,
608
+ env: {
609
+ PR_NUMBER: prNumber,
610
+ HEAD_SHA: `\${{ needs.${PR_COMMENT_PREVIEW_JOB}.outputs.${PREVIEW_HEAD_OUTPUT} }}`,
611
+ PLAN_RESULT: `\${{ needs.${PR_COMMENT_PREVIEW_JOB}.result }}`,
612
+ ...tipEnv,
613
+ GITHUB_TOKEN: GITHUB_JOB_TOKEN,
614
+ },
615
+ }
616
+ : {
617
+ command: postCommand,
618
+ env: { PR_NUMBER: prNumber, ...tipEnv },
619
+ setup: ['HEAD_SHA="$(git ls-remote origin "refs/merge-requests/$PR_NUMBER/head" | cut -f1)" && export HEAD_SHA'],
620
+ },
621
+ ...(github ? {} : { gitlabVar: GITLAB_PREVIEW_PR_VAR }),
622
+ };
623
+ }
624
+
249
625
  /** One job's command and the forge values it reads, as environment variables for its step. */
250
626
  export interface PrLoopJob {
251
627
  /** `plan`, `apply` or `record` (#4168). */
@@ -288,6 +664,8 @@ export interface PrLoopJob {
288
664
  * pipeline never gets.
289
665
  */
290
666
  run: { command: string; env: Record<string, string> };
667
+ /** Where the job runs (#4625), from the loop's `runners`: the plan's or the apply's, else `default`. Absent: the forge's default. */
668
+ runner?: CiRunner;
291
669
  }
292
670
 
293
671
  /** The lines `build` (#4088) runs before a job's command: the build, then the lint. Empty without the option. */
@@ -308,6 +686,14 @@ export function prLoopJobs(forge: ForgeKind, env: string, options: PrLoopPipelin
308
686
  if (early && options.applyOnMerge) throw new Error("--apply-before-merge applies an open pull request and a merge records, so it takes no --apply-on-merge; pass one of them");
309
687
  if (early && options.waveGate) throw new Error("--apply-before-merge applies the pull request's plan in one job, so it takes no --wave-gate");
310
688
  if (early && (options.build || options.buildCommand)) throw new Error("--apply-before-merge runs no build before its requires checks, so it takes no --pr-build or --pr-build-command yet");
689
+ if (options.applyRequires && !early) throw new Error("--requires names the checks of an apply before merge, so it needs --apply-before-merge");
690
+ const asked = options.applyRequires ? parseRequiresList(options.applyRequires) : undefined;
691
+ if (asked && "error" in asked) throw new Error(asked.error);
692
+ const requires = early && asked ? ["--requires", asked.checks.join(",")] : [];
693
+ if (options.applyMerge && !early) throw new Error("--merge auto merges a pull request after its update before merge, so it needs --apply-before-merge");
694
+ if (options.applyMerge && !/^[A-Za-z_][A-Za-z0-9_]*$/.test(options.applyMerge.tokenEnv)) throw new Error(`the merge token variable ${JSON.stringify(options.applyMerge.tokenEnv)} is not a variable name`);
695
+ // #4636: the merge after the update, with its own token.
696
+ const merge = early && options.applyMerge ? ["--merge", "auto", "--merge-token-env", options.applyMerge.tokenEnv, ...(options.applyMerge.method ? ["--merge-method", options.applyMerge.method] : [])] : [];
311
697
  const common = [
312
698
  "--env", env, "--gate", gate, "--output", PR_LOOP_REPORT_DIR, "--forge", forge,
313
699
  ...(member ? ["--member", member] : []),
@@ -317,15 +703,27 @@ export function prLoopJobs(forge: ForgeKind, env: string, options: PrLoopPipelin
317
703
  const github = forge !== "gitlab";
318
704
  const buildLines = prLoopBuildLines(env, options);
319
705
  const build = buildLines.length > 0 ? { build: buildLines } : {};
706
+ // #4625: the caller's variables and passed secrets, in every job that plans or applies.
320
707
  const jobEnv: Record<string, string> = {
708
+ ...prLoopPassedEnv(forge, options),
321
709
  ...(github ? { GITHUB_TOKEN: GITHUB_JOB_TOKEN } : {}),
322
710
  ...(options.events ? { CHANT_RUN_EVENTS_DIR: PR_LOOP_EVENTS_DIR } : {}),
323
711
  };
712
+ const planRunner = prLoopRunner(options, "plan");
713
+ if (options.parallelism !== undefined) {
714
+ const problem = parallelismProblem("parallelism", options.parallelism);
715
+ if (problem) throw new Error(`the pull request plan's ${problem}`);
716
+ }
717
+ const parallelism = options.parallelism !== undefined ? ["--parallelism", String(options.parallelism)] : [];
718
+ const applyRunner = prLoopRunner(options, "apply");
324
719
  // #4156: the flags `chant ci run` rebuilds `command` from. It finds the member from the directory it runs in.
325
720
  const ciRun = (job: PrLoopJob["jobName"]): string[] => [
326
721
  "chant", "ci", "run", job, "--in-place", ...(job === "plan" ? ["--no-push"] : []),
327
722
  ...(job === "apply" && !early ? [] : ["--base", '"$BASE_SHA"']), ...(job === "plan" || (job === "apply" && early) ? ["--pr", '"$PR_NUMBER"'] : []),
328
- ...(job === "apply" && early ? ["--apply-before-merge"] : []),
723
+ ...(job === "apply" && early ? ["--apply-before-merge", ...requires, ...merge] : []),
724
+ ...(job === "plan" ? parallelism : []),
725
+ ...(job === "plan" && options.commentTargets ? ["--comment-targets"] : []),
726
+ ...(job === "plan" && options.refresh ? ["--refresh"] : []),
329
727
  "--env", env, "--gate", gate, "--forge", forge,
330
728
  ...(job !== "record" && options.waveGate ? ["--wave-gate", options.waveGate] : []),
331
729
  ...(job !== "plan" && options.branch ? ["--branch", JSON.stringify(options.branch)] : []),
@@ -343,8 +741,9 @@ export function prLoopJobs(forge: ForgeKind, env: string, options: PrLoopPipelin
343
741
  const greenBranch = github ? JSON.stringify(options.branch ?? "main") : options.branch ? JSON.stringify(options.branch) : "$CI_DEFAULT_BRANCH";
344
742
  const applyEnv = github ? { BASE_SHA: "${{ github.event.before }}", ...jobEnv } : { BASE_SHA: "$CI_COMMIT_BEFORE_SHA", ...jobEnv };
345
743
  // #4301: the apply before merge runs in a job of the target branch, whose commit is the base, at the pull request's head.
744
+ const mergeSecret = github && options.applyMerge ? { [options.applyMerge.tokenEnv]: `\${{ secrets.${options.applyMerge.tokenEnv} }}` } : {};
346
745
  const earlyEnv = github
347
- ? { BASE_SHA: "${{ github.sha }}", PR_NUMBER: "${{ github.event.issue.number }}", ...jobEnv }
746
+ ? { BASE_SHA: "${{ github.sha }}", PR_NUMBER: "${{ github.event.issue.number }}", ...jobEnv, ...mergeSecret }
348
747
  : { BASE_SHA: "$CI_COMMIT_SHA", PR_NUMBER: `$${GITLAB_APPLY_PR_VAR}`, ...jobEnv };
349
748
  const greenApply: PrLoopJob = {
350
749
  // #4168 step 9: the apply applies the newest green commit, measured from the one applied before it.
@@ -358,6 +757,7 @@ export function prLoopJobs(forge: ForgeKind, env: string, options: PrLoopPipelin
358
757
  env: jobEnv,
359
758
  checkout: [greenCheckout(greenBranch)],
360
759
  greenBranch,
760
+ ...(applyRunner !== undefined ? { runner: applyRunner } : {}),
361
761
  ...build,
362
762
  run: { command: ciRun("apply").join(" "), env: runEnv(jobEnv) },
363
763
  };
@@ -365,34 +765,42 @@ export function prLoopJobs(forge: ForgeKind, env: string, options: PrLoopPipelin
365
765
  // #4301: the requires checks run inside pr-apply, before any of the head's code loads.
366
766
  jobName: "apply",
367
767
  command: [
368
- "chant", "components", "pr-apply", "--before-merge", "--base", '"$BASE_SHA"', "--pr", '"$PR_NUMBER"', ...common,
768
+ "chant", "components", "pr-apply", "--before-merge", ...requires, ...merge, "--base", '"$BASE_SHA"', "--pr", '"$PR_NUMBER"', ...common,
369
769
  ...(options.requireReview === true ? ["--require-review"] : []),
370
770
  "--resume", PR_APPLY_RECORD,
371
771
  ].join(" "),
372
772
  env: earlyEnv,
373
773
  checkout: [pullRequestCheckout(forge)],
774
+ ...(applyRunner !== undefined ? { runner: applyRunner } : {}),
374
775
  run: { command: ciRun("apply").join(" "), env: runEnv(earlyEnv) },
375
776
  };
777
+ const bin = options.words?.bin;
778
+ // #4629: the apply posts a failed apply's triage and a refused one's diff as CHANT_RESPOND says.
779
+ const respondEnv = prLoopRespondEnv(options);
780
+ const withRespond = (job: PrLoopJob): PrLoopJob => (Object.keys(respondEnv).length > 0 ? { ...job, env: { ...job.env, ...respondEnv }, run: { ...job.run, env: { ...job.run.env, ...respondEnv } } } : job);
376
781
  return [
377
782
  {
378
783
  jobName: "plan",
379
784
  // With `waveGate` the plan's note says the later waves may stop at their own gates (#4003).
380
- command: ["chant", "components", "pr-plan", "--base", '"$BASE_SHA"', "--pr", '"$PR_NUMBER"', ...common, ...(options.waveGate ? ["--wave-gate", options.waveGate] : []), "--no-status"].join(" "),
785
+ command: ["chant", "components", "pr-plan", "--base", '"$BASE_SHA"', "--pr", '"$PR_NUMBER"', ...common, ...(options.waveGate ? ["--wave-gate", options.waveGate] : []), ...parallelism, ...(options.commentTargets ? ["--comment-targets"] : []), ...(options.refresh ? ["--refresh"] : []), "--no-status"].join(" "),
381
786
  env: planEnv,
382
787
  ...build,
788
+ ...(planRunner !== undefined ? { runner: planRunner } : {}),
383
789
  // #4328: no runner key either. The step drops it, but the job's environment is the pull request's code's too.
384
790
  run: { command: ciRun("plan").join(" "), env: planEnv },
385
791
  },
386
- early ? earlyApply : greenApply,
792
+ withRespond(early ? earlyApply : greenApply),
387
793
  {
388
794
  jobName: "record",
389
795
  command: ["chant", "components", "pr-record", "--base", '"$BASE_SHA"', ...common].join(" "),
390
796
  env: applyEnv,
391
797
  setup: [github ? githubBaseFallback(options.branch) : gitlabBaseFallback(options.branch)],
392
798
  ...build,
799
+ // The record runs on merge, where the apply would.
800
+ ...(applyRunner !== undefined ? { runner: applyRunner } : {}),
393
801
  run: { command: ciRun("record").join(" "), env: runEnv(applyEnv) },
394
802
  },
395
- ];
803
+ ].map((job) => jobWithBin(job as PrLoopJob, bin));
396
804
  }
397
805
 
398
806
  /** The name of the job that posts the plan's note and status (#4295). */
@@ -414,11 +822,21 @@ export const PR_PLAN_NOTE_JOB = "plan-note";
414
822
  * asks GitLab for each open merge request's plan job and reads its report
415
823
  * from the job's artifacts.
416
824
  */
417
- export function prLoopPostJob(forge: ForgeKind, env: string, member?: string): { command: string; env: Record<string, string> } {
825
+ export function prLoopPostJob(forge: ForgeKind, env: string, member?: string, words?: Pick<CiProductWordsInput, "bin">, opts: { staleNotes?: boolean } & Pick<PrLoopPipelineOptions, "respond" | "decide"> = {}): { command: string; env: Record<string, string> } {
826
+ // #4629: the responses as CHANT_RESPOND, and with the description check its decide service on the line.
827
+ const respondEnv = prLoopRespondEnv(opts);
828
+ const decide = opts.respond?.description === "check" && opts.decide ? ` --decide-backend ${JSON.stringify(opts.decide.backend)} --decide-model ${JSON.stringify(opts.decide.model)}` : "";
829
+ const job = prLoopPostJobBase(forge, env, member, words, opts);
830
+ return decide || Object.keys(respondEnv).length > 0 ? { command: `${job.command}${decide}`, env: { ...job.env, ...respondEnv } } : job;
831
+ }
832
+
833
+ function prLoopPostJobBase(forge: ForgeKind, env: string, member: string | undefined, words: Pick<CiProductWordsInput, "bin"> | undefined, opts: { staleNotes?: boolean }): { command: string; env: Record<string, string> } {
834
+ // #4628: with staleNotes the note carries the target branch's commit, so a later push can mark it stale.
835
+ const tip = opts.staleNotes ? ["--tip", '"$TIP_SHA"'] : [];
418
836
  if (forge === "gitlab") {
419
837
  return {
420
- command: ["chant", "components", "pr-post", "--open", "--env", env, "--output", PR_LOOP_REPORT_DIR, "--forge", forge, ...(member ? ["--member", member] : [])].join(" "),
421
- env: {},
838
+ command: withProductBin(["chant", "components", "pr-post", "--open", "--env", env, "--output", PR_LOOP_REPORT_DIR, "--forge", forge, ...(member ? ["--member", member] : []), ...tip].join(" "), words?.bin),
839
+ env: opts.staleNotes ? { TIP_SHA: "$CI_COMMIT_SHA" } : {},
422
840
  };
423
841
  }
424
842
  const command = [
@@ -426,10 +844,42 @@ export function prLoopPostJob(forge: ForgeKind, env: string, member?: string): {
426
844
  "--env", env, "--output", PR_LOOP_REPORT_DIR, "--forge", forge,
427
845
  ...(member ? ["--member", member] : []),
428
846
  "--result", '"$PLAN_RESULT"',
847
+ ...tip,
429
848
  ].join(" ");
430
849
  return {
431
- command,
432
- env: { PR_NUMBER: "${{ github.event.pull_request.number }}", HEAD_SHA: "${{ github.sha }}", PLAN_RESULT: "${{ needs.plan.result }}", GITHUB_TOKEN: GITHUB_JOB_TOKEN },
850
+ command: withProductBin(command, words?.bin),
851
+ env: {
852
+ PR_NUMBER: "${{ github.event.pull_request.number }}",
853
+ HEAD_SHA: "${{ github.sha }}",
854
+ PLAN_RESULT: "${{ needs.plan.result }}",
855
+ ...(opts.staleNotes ? { TIP_SHA: "${{ github.event.pull_request.base.sha }}" } : {}),
856
+ GITHUB_TOKEN: GITHUB_JOB_TOKEN,
857
+ },
858
+ };
859
+ }
860
+
861
+ /** The job that marks the open pull requests' notes stale after a push to the target branch (#4628). */
862
+ export const PR_STALE_JOB = "stale-notes";
863
+
864
+ /**
865
+ * The stale job's command and the values it reads (#4628), with
866
+ * `staleNotes`: on a push to the target branch, at its commit, `pr-post
867
+ * --stale` marks each open pull request's note posted against another
868
+ * commit stale and sets its plan status back to pending. It names the plan
869
+ * comment with `previewComment`. Undefined without `staleNotes`.
870
+ */
871
+ export function prStaleJob(forge: ForgeKind, env: string, options: Pick<PrLoopPipelineOptions, "staleNotes" | "previewComment" | "branch" | "words"> = {}, member?: string): { command: string; env: Record<string, string> } | undefined {
872
+ if (!options.staleNotes) return undefined;
873
+ const words = resolveProductWords(options.words);
874
+ const command = [
875
+ "chant", "components", "pr-post", "--stale", "--tip", '"$TIP_SHA"', "--env", env, "--forge", forge,
876
+ ...(options.branch ? ["--branch", JSON.stringify(options.branch)] : []),
877
+ ...(member ? ["--member", member] : []),
878
+ ...(options.previewComment ? ["--preview-comment"] : []),
879
+ ].join(" ");
880
+ return {
881
+ command: withProductBin(command, words.bin),
882
+ env: forge === "gitlab" ? { TIP_SHA: "$CI_COMMIT_SHA" } : { TIP_SHA: "${{ github.sha }}", GITHUB_TOKEN: GITHUB_JOB_TOKEN },
433
883
  };
434
884
  }
435
885
 
@@ -555,6 +1005,37 @@ export const GITLAB_APPLY_PR_VAR = "CHANT_APPLY_PR";
555
1005
  /** The comment that starts the apply before merge on GitHub and Forgejo (#4301). */
556
1006
  export const APPLY_COMMENT = "/chant apply";
557
1007
 
1008
+ /** The comment that starts the apply before merge under the pipeline's words (#4550): `/plywood up`, else {@link APPLY_COMMENT}. */
1009
+ export function prApplyComment(options: Pick<PrLoopPipelineOptions, "words"> = {}): string {
1010
+ return commentLine(resolveProductWords(options.words), "apply") ?? APPLY_COMMENT;
1011
+ }
1012
+
1013
+ /** `chant` at the start of a command, or after a shell `$(`, `(`, `&&` or space. */
1014
+ const CHANT_WORD = /(^|[\s"(]|\$\()chant (?=[a-z])/g;
1015
+
1016
+ /**
1017
+ * A command line with the product's bin in place of `chant` (#4550): `npx
1018
+ * --no-install plywood components pr-plan ...`. A `chant ci run` line also
1019
+ * passes `--chant <bin>`, so the command it runs goes through the bin too.
1020
+ */
1021
+ export function withProductBin(line: string, bin: string | undefined): string {
1022
+ if (!bin) return line;
1023
+ const swapped = line.replace(CHANT_WORD, (_m, before: string) => `${before}${bin} `);
1024
+ return swapped.replace(new RegExp(`^${bin.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")} ci run ([a-z-]+) `), (m) => `${m}--chant ${JSON.stringify(bin)} `);
1025
+ }
1026
+
1027
+ /** Every command of `job` through {@link withProductBin}. */
1028
+ function jobWithBin<T extends Pick<PrLoopJob, "command" | "run"> & Partial<Pick<PrLoopJob, "build" | "checkout" | "setup">>>(job: T, bin: string | undefined): T {
1029
+ if (!bin) return job;
1030
+ return {
1031
+ ...job,
1032
+ command: withProductBin(job.command, bin),
1033
+ run: { ...job.run, command: withProductBin(job.run.command, bin) },
1034
+ ...(job.build ? { build: job.build.map((l) => withProductBin(l, bin)) } : {}),
1035
+ ...(job.checkout ? { checkout: job.checkout.map((l) => withProductBin(l, bin)) } : {}),
1036
+ };
1037
+ }
1038
+
558
1039
  /**
559
1040
  * The line that checks out pull request `$PR_NUMBER`'s head (#4301) in a job
560
1041
  * of the target branch: the forge's `refs/pull/<n>/head`, or GitLab's
@@ -608,8 +1089,7 @@ export function githubBaseFallback(branch?: string): string {
608
1089
  return pushBaseFallback(JSON.stringify(branch ?? "main"), "$GITHUB_SHA");
609
1090
  }
610
1091
 
611
- /** Where the pull request environment jobs (#4298) write their reports, kept as a CI artifact. */
612
- export const PR_ENV_REPORT_DIR = ".chant/pr-env";
1092
+ export { PR_ENV_REPORT_DIR } from "../ci-jobs";
613
1093
 
614
1094
  /** The cron the generated `env-sweep` job runs on (#4298): hourly, at a minute off the hour. */
615
1095
  export const PR_ENV_SWEEP_CRON = "17 * * * *";