@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
@@ -23,11 +23,18 @@
23
23
  *
24
24
  * A policy also reads `input.review` (#4326): the risk the pull request's
25
25
  * review note names, when the review agent posted one ({@link policyReviewOf}).
26
+ *
27
+ * `ci.policy.source` (#4613) names a shared repository and ref instead of
28
+ * the workspace's own directory. The source is named at base, fetched once
29
+ * per job (`../policy-source.ts`), and the commit its ref named goes on the
30
+ * verdict and the report, so a decision names the rules it used. A source
31
+ * that cannot be fetched is an error, and nothing applies.
26
32
  */
27
33
 
28
34
  import { readDeclaration, WorkspaceReadError } from "../workspace/declaration";
29
35
  import { locateWorkspace } from "../workspace/which-chant";
30
36
  import type { WorkspaceTree } from "../workspace/tree";
37
+ import { fetchGatePolicySourceOnce, type ResolvedGatePolicySource } from "../policy-source";
31
38
  import {
32
39
  checkGatePolicy,
33
40
  DEFAULT_POLICY_PATH,
@@ -48,8 +55,16 @@ export interface PrLoopPolicy {
48
55
  settings?: GatePolicySettings;
49
56
  /** The commit it was read at. */
50
57
  base: string;
51
- /** The tree of the declaration's directory at base, where the policy directory is read. */
58
+ /**
59
+ * Where the policy directory is read: the tree of the declaration's
60
+ * directory at base, or with `ci.policy.source` the shared repository's
61
+ * tree at the commit its ref named.
62
+ */
52
63
  tree?: WorkspaceTree;
64
+ /** The shared source the tree is (#4613), with the commit fetched. */
65
+ source?: ResolvedGatePolicySource;
66
+ /** Why the source named at base could not be read. Every policy run is then an error. */
67
+ error?: string;
53
68
  /** A line for the log when no policy runs because the base has no declaration, or could not be read. */
54
69
  note?: string;
55
70
  }
@@ -72,7 +87,11 @@ export function prLoopPolicyAt(cwd: string, base: string): PrLoopPolicy {
72
87
  try {
73
88
  const located = locateWorkspace(cwd, base);
74
89
  const settings = readDeclaration(located.tree).ci?.policy;
75
- return { base, ...(settings ? { settings, tree: located.tree } : {}) };
90
+ if (!settings) return { base };
91
+ if (!settings.source) return { base, settings, tree: located.tree };
92
+ const fetched = fetchGatePolicySourceOnce(settings.source);
93
+ if ("error" in fetched) return { base, settings, error: fetched.error };
94
+ return { base, settings, tree: fetched.tree, source: fetched.source };
76
95
  } catch (err) {
77
96
  const missing = err instanceof WorkspaceReadError && (err.code === "declaration-missing" || err.code === "not-a-git-repository");
78
97
  const why = err instanceof Error ? err.message : String(err);
@@ -147,15 +166,33 @@ export async function policyReviewOf(forge: PrForge | undefined, pr: number | nu
147
166
  return { found: true, risk: result.risk, head: result.head };
148
167
  }
149
168
 
150
- /** Run the policy over `input`. Undefined when the base sets no policy. */
169
+ /** The Rego directory a read names: the source's `path`, else `ci.policy.path`, else the default, and whether one was named. */
170
+ export function prPolicyPath(read: Pick<PrLoopPolicy, "settings" | "source">): { path: string; named: boolean } {
171
+ const named = read.source ? read.settings?.source?.path : read.settings?.path;
172
+ return { path: read.source?.path ?? named ?? DEFAULT_POLICY_PATH, named: named !== undefined };
173
+ }
174
+
175
+ /**
176
+ * Run the policy over `input`. Undefined when the base sets no policy, or
177
+ * sets only `packs` (CrossGuard, run by the pulumi lexicon's preview) and
178
+ * names no Rego directory that exists.
179
+ */
151
180
  export function runPrPolicy(read: PrLoopPolicy, input: PrPolicyInput, exec?: GatePolicyExec): GatePolicyVerdict | undefined {
152
- if (!read.settings || !read.tree) return undefined;
181
+ if (!read.settings) return undefined;
153
182
  const engine = read.settings.engine ?? "conftest";
154
- const path = read.settings.path ?? DEFAULT_POLICY_PATH;
183
+ const source = read.source ? { source: read.source } : {};
184
+ if (read.error !== undefined) return { result: "error", engine, denials: [], rules: [], holds: [], warnings: [], error: read.error };
185
+ if (!read.tree) return undefined;
186
+ const { path, named } = prPolicyPath(read);
187
+ // ci.policy with only packs: no Rego runs unless its directory is there.
188
+ if (!named && read.settings.packs?.length && read.tree.stat(path) === undefined) return undefined;
155
189
  const exported = exportGatePolicy(read.tree, path);
156
- if ("error" in exported) return { result: "error", engine, denials: [], rules: [], holds: [], warnings: [], error: exported.error };
190
+ if ("error" in exported) {
191
+ const where = read.source ? `${read.source.repo}@${read.source.ref} (${read.source.commit.slice(0, 12)})` : "base";
192
+ return { result: "error", engine, denials: [], rules: [], holds: [], warnings: [], error: read.source ? `the policy directory ${path} does not exist in ${where}` : exported.error, ...source };
193
+ }
157
194
  try {
158
- return checkGatePolicy({ settings: read.settings, input, policyDir: exported.dir, cwd: process.cwd(), ...(exec ? { exec } : {}) });
195
+ return { ...checkGatePolicy({ settings: read.settings, input, policyDir: exported.dir, cwd: process.cwd(), ...(exec ? { exec } : {}) }), ...source };
159
196
  } finally {
160
197
  exported.cleanup();
161
198
  }
@@ -172,6 +209,7 @@ export function prPolicyReport(verdict: GatePolicyVerdict, base: string): PrPoli
172
209
  holds: verdict.holds,
173
210
  warnings: verdict.warnings,
174
211
  ...(verdict.error !== undefined ? { error: verdict.error } : {}),
212
+ ...(verdict.source ? { source: { ...verdict.source } } : {}),
175
213
  };
176
214
  }
177
215
 
@@ -1438,7 +1438,7 @@ describe("a group planned and applied as one (ws-107, #4440)", () => {
1438
1438
  const set = await planPrSet({ components: ABC, plan, registry: moved.registry, env: "prod" });
1439
1439
  const stopped = await applyPrSet({ components: ABC, plan, registry: moved.registry, env: "prod", set });
1440
1440
  expect(stopped.members.map((m) => m.status)).toEqual(["not-started", "not-started", "not-started"]);
1441
- expect(failedRunExitCode(stopped.run.results)).toBe(3);
1441
+ expect(failedRunExitCode(stopped.run.results)).toBe(4);
1442
1442
 
1443
1443
  const broken = groupWorld({ group: true });
1444
1444
  broken.runThrows = new Error("connection reset");
@@ -77,6 +77,7 @@
77
77
  * digest binds the group's, so the one approval binds the composition.
78
78
  */
79
79
 
80
+ import { anyResourceGrain, lockTargetsOf, type LockGrain, type PlannedLock } from "../lifecycle/lock-rows";
80
81
  import { composeChangeSet, verifyChangeSetDigest, type ChangeSetDocument, type ChangeSetEntry, type ChangeSetPart } from "../change-set";
81
82
  import { evaluateGate, type GateCheck, type GateLedgerPort } from "../op/gate";
82
83
  import {
@@ -112,8 +113,10 @@ import type { CapabilityRegistry, GroupRun, PlannedOutputs } from "./capability"
112
113
  import { groupsByComponent, narrowGroups, planComponentGroup, regroupRemaining } from "./groups";
113
114
  import type { RunProgressEvent } from "./run-progress";
114
115
  import type { RunEventSink } from "../run-event-stream";
115
- import { capabilitySteps, planWaveComponent, readDeployedOutputs, type WaveComponentPlan } from "./wave-plan";
116
+ import { capabilitySteps, planWaveComponent, readDeployedOutputs, type CapabilityPolicyFindings, type WaveComponentPlan } from "./wave-plan";
116
117
  import type { PrMigrationFile } from "../pr-migrations";
118
+ import { markCrossStackEdges, type CrossStackRead } from "../control/edges";
119
+ import { mapLimited } from "../parallelism";
117
120
 
118
121
  export interface PrPlanSetOptions {
119
122
  /** Every component in the project, not the selection: a planned member's dependency outside it is read too (#4104). */
@@ -127,6 +130,16 @@ export interface PrPlanSetOptions {
127
130
  seededOutputs?: Record<string, Record<string, unknown>>;
128
131
  /** The addresses each component narrows to (#4300), by component: its steps' `DeployContext.targets`. */
129
132
  targets?: Readonly<Record<string, readonly string[]>>;
133
+ /** How many members of a wave plan at once (#4625, `pr-plan --parallelism`); a group counts as one. Default: all of them. */
134
+ parallelism?: number;
135
+ /** `pr-plan --refresh` (#4627): every step's `DeployContext.refresh`. */
136
+ refresh?: boolean;
137
+ /** `pr-plan --target-dependents` (#4627): `DeployContext.targetDependents` for each component with targets. */
138
+ targetDependents?: boolean;
139
+ /** `ci.lockGrain` as declared at base (#4552); absent, each member takes its lexicon's default. */
140
+ lockGrain?: LockGrain;
141
+ /** The commit policy is read at (#4613), every step's `DeployContext.policyBase`: the pull request's base. */
142
+ policyBase?: string;
130
143
  /**
131
144
  * Where the planning's events go (#4041): a `plan` phase with no
132
145
  * component, and in it one `plan` step per component, started as its wave
@@ -161,12 +174,31 @@ export interface PrPlanSet {
161
174
  plannedOutputs?: Record<string, string[]>;
162
175
  /** The shapes lexicons supplied with their plans (#4419), by member. */
163
176
  shapes?: Record<string, PlanShape>;
177
+ /**
178
+ * Each planned member's lock grain and rows (#4552), by member, with the
179
+ * component it belongs to. What a pull request locks under `ci.locks`
180
+ * (`lockTargetsOf`) and what its apply leases on the resource grain.
181
+ * Absent when no step planned.
182
+ */
183
+ locks?: Record<string, PlannedLock & { component: string }>;
184
+ /**
185
+ * Where each planned member's copy lives in a pull request's environment
186
+ * (#4609), by component, then member: a review stack, as its capability
187
+ * said. Absent when no step gave one.
188
+ */
189
+ locations?: Record<string, Record<string, string>>;
164
190
  /** The groups planned as one (ws-107), in plan order of their first member. Absent when none. */
165
191
  groups?: PrPlanGroup[];
166
192
  /** The components that could have grouped and did not, with why (ws-107, ruling 1): the fan-out's `fallbacks`. */
167
193
  fallbacks?: FanOutGroupFallback[];
194
+ /** The addresses each component's plan was narrowed to (#4626, `pr-plan --target`), by component. Absent when nothing was narrowed. */
195
+ targets?: Record<string, string[]>;
168
196
  /** Whether any component failed to plan. */
169
197
  failed: boolean;
198
+ /** A capability's plan threw `policyDenied` (#4550): the stage exits 7, not 1. */
199
+ policyDenied?: boolean;
200
+ /** The policy findings capabilities' plans carried (#4550), by member. Absent when none. */
201
+ capabilityPolicy?: CapabilityPolicyFindings[];
170
202
  }
171
203
 
172
204
  /** A group a pull request planned as one (ws-107). */
@@ -211,7 +243,11 @@ export async function planPrSet(options: PrPlanSetOptions): Promise<PrPlanSet> {
211
243
  const readsBy = new Map<string, PrMemberRead[]>();
212
244
  const plans: Record<string, Record<string, unknown>> = {};
213
245
  const shapes: Record<string, PlanShape> = {};
246
+ const locks: Record<string, PlannedLock & { component: string }> = {};
247
+ const locations: Record<string, Record<string, string>> = {};
214
248
  let failed = false;
249
+ // #4550: the findings capabilities' plans carried, and a policy denial among them.
250
+ const capabilityPolicy: CapabilityPolicyFindings[] = [];
215
251
  const emit = options.onRunEvent;
216
252
  emit?.({ type: "phase-start", component: null, phase: PR_PLAN_PHASE });
217
253
  // ws-107: each group plans once, in its wave, with one call.
@@ -252,18 +288,18 @@ export async function planPrSet(options: PrPlanSetOptions): Promise<PrPlanSet> {
252
288
  });
253
289
  };
254
290
  const groupsHere = [...new Set(wave.map((name) => groupOf.get(name)).filter((g): g is FanOutGroup => g !== undefined))];
255
- const results = (
256
- await Promise.all([
291
+ // #4625: at most `parallelism` plans at once, members and groups alike.
292
+ const tasks: Array<() => Promise<WaveComponentPlan[]>> = [
257
293
  ...wave
258
294
  .filter((name) => !groupOf.has(name))
259
- .map(async (name) => {
295
+ .map((name) => async () => {
260
296
  emit?.({ type: "step-start", component: name, phase: PR_PLAN_PHASE, step: "plan" });
261
297
  const start = Date.now();
262
298
  const p = await planWaveComponent(byName.get(name)!, options.registry, deployContext(options, name), outputs);
263
299
  settle(name, start, p);
264
300
  return [p];
265
301
  }),
266
- ...groupsHere.map(async (group) => {
302
+ ...groupsHere.map((group) => async () => {
267
303
  for (const name of group.components) emit?.({ type: "step-start", component: name, phase: PR_PLAN_PHASE, step: "plan" });
268
304
  const start = Date.now();
269
305
  const g = await planComponentGroup({
@@ -280,8 +316,8 @@ export async function planPrSet(options: PrPlanSetOptions): Promise<PrPlanSet> {
280
316
  groups.push({ ...group, digest: g.digest ?? null, ...(error !== undefined ? { error } : {}), ...(g.run ? { run: g.run } : {}) });
281
317
  return g.plans;
282
318
  }),
283
- ])
284
- ).flat();
319
+ ];
320
+ const results = (await mapLimited(tasks, options.parallelism, (task) => task())).flat();
285
321
  /** What each member of a group planned to expose, for its group-mates' reads. */
286
322
  const plannedHere = new Map(results.map((p) => [p.component, "error" in p ? undefined : p.outputs?.known]));
287
323
  for (const p of results) {
@@ -294,6 +330,7 @@ export async function planPrSet(options: PrPlanSetOptions): Promise<PrPlanSet> {
294
330
  const readsView = group ? { ...outputs, ...Object.fromEntries(group.components.filter((c) => c !== p.component).map((c) => [c, { ...(plannedHere.get(c) ?? {}) }])) } : outputs;
295
331
  const reads = readsOf(component, readsView);
296
332
  if (reads.length > 0) readsBy.set(p.component, reads);
333
+ if (p.policy) capabilityPolicy.push(...p.policy);
297
334
  if ("error" in p) {
298
335
  failed = true;
299
336
  plannedBy.set(p.component, undefined);
@@ -306,6 +343,8 @@ export async function planPrSet(options: PrPlanSetOptions): Promise<PrPlanSet> {
306
343
  plannedBy.set(p.component, p.outputs);
307
344
  plans[p.component] = p.plans;
308
345
  Object.assign(shapes, p.shapes);
346
+ for (const [member, lock] of Object.entries(p.locks ?? {})) locks[member] = { ...lock, component: p.component };
347
+ if (p.locations && Object.keys(p.locations).length > 0) locations[p.component] = { ...p.locations };
309
348
  for (const part of p.parts) {
310
349
  parts.push(part);
311
350
  componentOf.set(part.member.member, p.component);
@@ -342,11 +381,16 @@ export async function planPrSet(options: PrPlanSetOptions): Promise<PrPlanSet> {
342
381
  plans,
343
382
  outputs,
344
383
  failed,
384
+ ...(capabilityPolicy.some((c) => c.denied) ? { policyDenied: true } : {}),
385
+ ...(capabilityPolicy.length > 0 ? { capabilityPolicy: [...capabilityPolicy].sort((x, y) => (x.member < y.member ? -1 : x.member > y.member ? 1 : 0)) } : {}),
345
386
  ...(groups.length > 0 ? { groups } : {}),
346
387
  ...(options.plan.fallbacks?.length ? { fallbacks: options.plan.fallbacks } : {}),
347
388
  ...(Object.keys(shapes).length > 0 ? { shapes } : {}),
389
+ ...(Object.keys(locks).length > 0 ? { locks } : {}),
390
+ ...(Object.keys(locations).length > 0 ? { locations } : {}),
348
391
  ...(Object.keys(deployedOutputs).length > 0 ? { deployedOutputs } : {}),
349
392
  ...(Object.keys(plannedOutputs).length > 0 ? { plannedOutputs } : {}),
393
+ ...(options.targets && Object.keys(options.targets).length > 0 ? { targets: Object.fromEntries(Object.entries(options.targets).map(([c, a]) => [c, [...a]])) } : {}),
350
394
  };
351
395
  }
352
396
 
@@ -461,6 +505,8 @@ export async function decidePrGate(
461
505
  op: input.op,
462
506
  gate: input.gate,
463
507
  planDigest: input.digest,
508
+ // #4551: the gate's digest is the change set's, so the fact cites it as readers expect.
509
+ fields: { changeSet: input.digest },
464
510
  ...(input.description ? { description: input.description } : {}),
465
511
  ...(input.now ? { now: input.now } : {}),
466
512
  });
@@ -499,6 +545,10 @@ export interface PrApplyOptions {
499
545
  set: PrPlanSet;
500
546
  /** The addresses each component narrows to (#4300), by component: its steps' `DeployContext.targets`. */
501
547
  targets?: Readonly<Record<string, readonly string[]>>;
548
+ /** `ci.lockGrain` as declared at base (#4552), for the plans a later round or a resume makes. */
549
+ lockGrain?: LockGrain;
550
+ /** The commit policy is read at (#4613), for the plans a later round or a resume makes. */
551
+ policyBase?: string;
502
552
  onProgress?: (event: RunProgressEvent) => void;
503
553
  /** Where the apply's events go (#4041): the fan-out's run events. */
504
554
  onRunEvent?: RunEventSink;
@@ -528,6 +578,15 @@ export interface PrApplyOptions {
528
578
  */
529
579
  approval?: PrApproval;
530
580
  decideRound?: (round: { round: number; gate: string; set: PrPlanSet; plan: FanOutPlan; notCovered?: string }) => Promise<PrRoundDecision>;
581
+ /**
582
+ * Lease the rows a later round's plan locks (#4594), once its gate lets it
583
+ * apply and before it does: the lease to let go of when the round ends,
584
+ * `held` naming the run that holds a row, or `failed` when the rows file
585
+ * could not be written. Either stops the apply with the round unapplied.
586
+ * The first round's rows are the caller's to lease, from `set.locks`.
587
+ * Absent: no round takes a lease.
588
+ */
589
+ leaseRound?: (round: { round: number; set: PrPlanSet }) => Promise<{ release(): Promise<boolean> } | { held: string } | { failed: string }>;
531
590
  }
532
591
 
533
592
  /** How a round's gate was decided: whether it applies, and where its approval stands. */
@@ -548,6 +607,10 @@ export interface PrApplyResult {
548
607
  run: FanOutRunResult;
549
608
  /** Each round after the first, in order. Absent when nothing was held back. */
550
609
  rounds?: PrRound[];
610
+ /** A later round's rows were held by another run (#4594), so it did not apply: why. The command exits 5. */
611
+ held?: string;
612
+ /** A later round's rows could not be leased (#4594), so it did not apply: why. The command exits 1. */
613
+ leaseFailed?: string;
551
614
  }
552
615
 
553
616
  /**
@@ -703,7 +766,8 @@ export async function applyPrSet(options: PrApplyOptions): Promise<PrApplyResult
703
766
  const rounds: PrRound[] = [];
704
767
  /** Per component, the round that applied it or holds it, and that round's set, after the first. */
705
768
  const roundOf = new Map<string, { round: number; set: PrPlanSet }>();
706
- let stopped: "waiting" | "plan-failed" | undefined;
769
+ let stopped: "waiting" | "plan-failed" | "held" | "lease-failed" | undefined;
770
+ let stoppedBy: string | undefined;
707
771
  while (run.held && run.held.length > 0 && run.status === "ok" && options.decideRound) {
708
772
  const round = rounds.length + 2;
709
773
  const gate = prRoundGate(options.gate ?? PR_APPLY_GATE, round);
@@ -718,6 +782,8 @@ export async function applyPrSet(options: PrApplyOptions): Promise<PrApplyResult
718
782
  ...(options.vars ? { vars: options.vars } : {}),
719
783
  seededOutputs: run.componentOutputs,
720
784
  ...(options.targets ? { targets: options.targets } : {}),
785
+ ...(options.lockGrain ? { lockGrain: options.lockGrain } : {}),
786
+ ...(options.policyBase ? { policyBase: options.policyBase } : {}),
721
787
  });
722
788
  for (const name of plan.order) roundOf.set(name, { round, set });
723
789
  const cover = roundCover(options, set, plan, run.componentOutputs, inChange, byName);
@@ -749,7 +815,26 @@ export async function applyPrSet(options: PrApplyOptions): Promise<PrApplyResult
749
815
  stopped = "waiting";
750
816
  break;
751
817
  }
752
- const next = await runRound(plan, set, set.outputs, run.componentOutputs);
818
+ // #4594: the round's own rows, leased as the first round's were, since its plan may change resources the first did not.
819
+ const lease = options.leaseRound ? await options.leaseRound({ round, set }) : undefined;
820
+ if (lease && "held" in lease) {
821
+ record("held", decision.approval, lease.held, decision.covered);
822
+ stopped = "held";
823
+ stoppedBy = lease.held;
824
+ break;
825
+ }
826
+ if (lease && "failed" in lease) {
827
+ record("failed", decision.approval, lease.failed, decision.covered);
828
+ stopped = "lease-failed";
829
+ stoppedBy = lease.failed;
830
+ break;
831
+ }
832
+ let next: FanOutRunResult;
833
+ try {
834
+ next = await runRound(plan, set, set.outputs, run.componentOutputs);
835
+ } finally {
836
+ await lease?.release();
837
+ }
753
838
  record(next.status === "fail" ? "failed" : "applied", decision.approval, undefined, decision.covered);
754
839
  run = joinRuns(run, next);
755
840
  }
@@ -787,8 +872,15 @@ export async function applyPrSet(options: PrApplyOptions): Promise<PrApplyResult
787
872
  return { ...asPlanned, status: "failed", ...(error ? { error } : {}) };
788
873
  });
789
874
  const status: PrApplyResult["status"] =
790
- run.status !== "ok" || stopped === "plan-failed" ? "failed" : held.size > 0 || stopped === "waiting" ? "waiting" : "applied";
791
- return { members, status, run, ...(rounds.length > 0 ? { rounds } : {}) };
875
+ run.status !== "ok" || stopped === "plan-failed" || stopped === "lease-failed" ? "failed" : held.size > 0 || stopped === "waiting" || stopped === "held" ? "waiting" : "applied";
876
+ return {
877
+ members,
878
+ status,
879
+ run,
880
+ ...(rounds.length > 0 ? { rounds } : {}),
881
+ ...(stopped === "held" && stoppedBy ? { held: stoppedBy } : {}),
882
+ ...(stopped === "lease-failed" && stoppedBy ? { leaseFailed: stoppedBy } : {}),
883
+ };
792
884
  }
793
885
 
794
886
  const sameJson = (a: unknown, b: unknown): boolean => JSON.stringify(a ?? null) === JSON.stringify(b ?? null);
@@ -878,6 +970,10 @@ export interface PrResumeOptions {
878
970
  seededOutputs?: Record<string, Record<string, unknown>>;
879
971
  /** The addresses each component narrows to (#4300), by component: its steps' `DeployContext.targets`. */
880
972
  targets?: Readonly<Record<string, readonly string[]>>;
973
+ /** `ci.lockGrain` as declared at base (#4552), for the plans a later round or a resume makes. */
974
+ lockGrain?: LockGrain;
975
+ /** The commit policy is read at (#4613), for the plans a later round or a resume makes. */
976
+ policyBase?: string;
881
977
  /** The approved set, from the attempt record. */
882
978
  record: PrApplyRecord;
883
979
  /** Components an earlier attempt applied. */
@@ -960,6 +1056,8 @@ export async function resumePrSet(options: PrResumeOptions): Promise<PrResume> {
960
1056
  ...(options.vars ? { vars: options.vars } : {}),
961
1057
  seededOutputs: { ...(options.seededOutputs ?? {}), ...options.record.planOutputs, ...fromGroup },
962
1058
  ...(options.targets ? { targets: options.targets } : {}),
1059
+ ...(options.lockGrain ? { lockGrain: options.lockGrain } : {}),
1060
+ ...(options.policyBase ? { policyBase: options.policyBase } : {}),
963
1061
  });
964
1062
  // #4422: decided as a round decides (`coveredRound`), by the same function a wave uses.
965
1063
  const reasons = waveNotCovered(options.record.changeSet, fresh.doc, options.record.members);
@@ -1113,9 +1211,32 @@ function reportGroups(set: PrPlanSet, waves: readonly string[][]): PrGroup[] {
1113
1211
  });
1114
1212
  }
1115
1213
 
1214
+ /**
1215
+ * The stacks outside the workspace each member's plan reads (#4617): a
1216
+ * capability's artifact that lists them under `stackReferences.outside`
1217
+ * (pulumi-up's, #4547), with the reader's last update from
1218
+ * `stackReferences.lastUpdate`.
1219
+ */
1220
+ export function crossStackReadsOf(plans: Record<string, Record<string, unknown>> | undefined): CrossStackRead[] {
1221
+ const out: CrossStackRead[] = [];
1222
+ for (const byMember of Object.values(plans ?? {})) {
1223
+ for (const [member, artifact] of Object.entries(byMember ?? {})) {
1224
+ const refs = (artifact as { stackReferences?: { outside?: unknown; lastUpdate?: unknown } } | undefined)?.stackReferences;
1225
+ if (!refs || !Array.isArray(refs.outside)) continue;
1226
+ const lastUpdate = typeof refs.lastUpdate === "string" ? refs.lastUpdate : undefined;
1227
+ for (const o of refs.outside) {
1228
+ const name = (o as { name?: unknown } | null)?.name;
1229
+ if (typeof name === "string" && name !== "" && !out.some((r) => r.member === member && r.stack === name)) out.push({ member, stack: name, ...(lastUpdate ? { lastUpdate } : {}) });
1230
+ }
1231
+ }
1232
+ }
1233
+ return out;
1234
+ }
1235
+
1116
1236
  /** The report a stage writes. */
1117
1237
  export function prReport(input: PrReportInput): PrReport {
1118
1238
  const changed = new Set(input.signal.changed);
1239
+ const crossStack = crossStackReadsOf(input.set.plans);
1119
1240
  const groups = reportGroups(input.set, input.plan.waves);
1120
1241
  const groupOf = new Map(groups.flatMap((g, i) => g.components.map((c) => [c, i] as const)));
1121
1242
  const members = (input.members ?? input.set.members).map((m) => (groupOf.has(m.component) ? { ...m, group: groupOf.get(m.component)! } : m));
@@ -1137,6 +1258,7 @@ export function prReport(input: PrReportInput): PrReport {
1137
1258
  ...(input.resumed ? { resumed: { applied: [...input.resumed].sort() } } : {}),
1138
1259
  ...(input.set.deployedOutputs ? { deployedOutputs: input.set.deployedOutputs } : {}),
1139
1260
  ...(input.set.plannedOutputs ? { plannedOutputs: input.set.plannedOutputs } : {}),
1261
+ ...(input.set.targets ? { narrowed: input.set.targets } : {}),
1140
1262
  ...(input.rounds && input.rounds.length > 0 ? { rounds: input.rounds } : {}),
1141
1263
  ...(input.migrations && input.migrations.length > 0 ? { migrations: input.migrations } : {}),
1142
1264
  approval: input.approval,
@@ -1150,8 +1272,13 @@ export function prReport(input: PrReportInput): PrReport {
1150
1272
  waves: input.plan.waves,
1151
1273
  },
1152
1274
  ...(groups.length > 0 ? { groups } : {}),
1275
+ ...(input.set.capabilityPolicy?.length ? { capabilityPolicy: input.set.capabilityPolicy.map((c) => ({ ...c })) } : {}),
1153
1276
  ...(input.set.fallbacks?.length ? { fallbacks: input.set.fallbacks.map((f) => ({ ...f })) } : {}),
1277
+ // #4617: the stacks outside the workspace a member reads, unknown until the note's job reads the control repo.
1278
+ ...(crossStack.length > 0 ? { crossStackEdges: markCrossStackEdges(crossStack, undefined) } : {}),
1154
1279
  members,
1155
1280
  changeSet: input.set.doc,
1281
+ // #4552: under the resource grain a pull request locks row keys, so `chant lock --from-report` reads them here.
1282
+ ...(anyResourceGrain(input.set.locks) ? { lockTargets: lockTargetsOf(input.plan.order, input.set.locks) } : {}),
1156
1283
  };
1157
1284
  }
@@ -0,0 +1,34 @@
1
+ /**
2
+ * The stale job's descriptor (#4628): `prStaleJob` on the three forges, the
3
+ * note job's tip, and productPipelineJobs returning both. Written for the
4
+ * ci-products post-merge pass.
5
+ */
6
+ import { describe, expect, test } from "vitest";
7
+ import { prLoopPostJob, prStaleJob } from "./pr-pipeline";
8
+ import { productPipelineJobs } from "./product-pipeline";
9
+ import { PLYWOOD } from "../__fixtures__/product-words";
10
+
11
+ describe("the stale job (#4628)", () => {
12
+ test("none without staleNotes", () => {
13
+ expect(prStaleJob("github", "prod", {})).toBeUndefined();
14
+ });
15
+
16
+ test("GitHub and Forgejo read the pushed commit; GitLab the pipeline's", () => {
17
+ expect(prStaleJob("github", "prod", { staleNotes: true })).toEqual({ command: 'chant components pr-post --stale --tip "$TIP_SHA" --env prod --forge github', env: { TIP_SHA: "${{ github.sha }}", GITHUB_TOKEN: "${{ github.token }}" } });
18
+ expect(prStaleJob("forgejo", "prod", { staleNotes: true, branch: "trunk" }, "shop")!.command).toBe('chant components pr-post --stale --tip "$TIP_SHA" --env prod --forge forgejo --branch "trunk" --member shop');
19
+ expect(prStaleJob("gitlab", "prod", { staleNotes: true })!.env).toEqual({ TIP_SHA: "$CI_COMMIT_SHA" });
20
+ });
21
+
22
+ test("the note job passes the tip only with staleNotes", () => {
23
+ expect(prLoopPostJob("github", "prod").command).not.toContain("--tip");
24
+ expect(prLoopPostJob("github", "prod", undefined, undefined, { staleNotes: true }).env.TIP_SHA).toBe("${{ github.event.pull_request.base.sha }}");
25
+ expect(prLoopPostJob("gitlab", "prod", undefined, undefined, { staleNotes: true }).command).toContain('--tip "$TIP_SHA"');
26
+ });
27
+
28
+ test("productPipelineJobs returns the stale job in the product's bin, naming the preview comment", () => {
29
+ const words = { ...PLYWOOD, commands: { preview: "plan" as const } };
30
+ const jobs = productPipelineJobs("github", "prod", { words, staleNotes: true, previewComment: true });
31
+ expect(jobs.stale!.command).toBe('npx --no-install plywood components pr-post --stale --tip "$TIP_SHA" --env prod --forge github --preview-comment');
32
+ expect(jobs.post.command).toContain('--tip "$TIP_SHA"');
33
+ });
34
+ });
@@ -0,0 +1,35 @@
1
+ /**
2
+ * `pr-plan --target` (#4620): a bare address narrows every planned member,
3
+ * `<member>:<address>` one member, and a member the pull request does not
4
+ * plan is refused.
5
+ */
6
+
7
+ import { describe, expect, test } from "vitest";
8
+ import { prPlanTargets } from "./pr-targets";
9
+
10
+ const KNOWN = new Set(["net", "app", "db"]);
11
+
12
+ describe("prPlanTargets", () => {
13
+ test("a bare address narrows every member the pull request plans", () => {
14
+ expect(prPlanTargets(["aws_s3_bucket.logs"], ["net", "app"], KNOWN)).toEqual({ targets: { app: ["aws_s3_bucket.logs"], net: ["aws_s3_bucket.logs"] } });
15
+ });
16
+
17
+ test("a member's name before the first colon narrows that member alone", () => {
18
+ expect(prPlanTargets(["net:module.vpc", "net:aws_route.a", "net:module.vpc"], ["net", "app"], KNOWN)).toEqual({ targets: { net: ["aws_route.a", "module.vpc"] } });
19
+ });
20
+
21
+ test("a Pulumi URN is a bare address, since urn names no member", () => {
22
+ const urn = "urn:pulumi:prod::app::aws:s3/bucket:Bucket::logs";
23
+ expect(prPlanTargets([urn], ["app"], KNOWN)).toEqual({ targets: { app: [urn] } });
24
+ });
25
+
26
+ test("a member the pull request does not plan is refused by name", () => {
27
+ const got = prPlanTargets(["db:aws_db_instance.main"], ["net", "app"], KNOWN);
28
+ expect(got).toEqual({ error: expect.stringContaining("does not plan db") });
29
+ });
30
+
31
+ test("an empty address is refused, and nothing planned narrows nothing", () => {
32
+ expect(prPlanTargets(["net:"], ["net"], KNOWN)).toEqual({ error: expect.stringContaining("name an address after net:") });
33
+ expect(prPlanTargets(["aws_s3_bucket.logs"], [], KNOWN)).toEqual({ targets: {} });
34
+ });
35
+ });
@@ -0,0 +1,45 @@
1
+ /**
2
+ * `chant components pr-plan --target` (#4620): the addresses each planned
3
+ * member's capability plan narrows to, from repeatable `--target` values.
4
+ *
5
+ * A value whose text before the first `:` names a component is that
6
+ * component's: `--target net:aws_s3_bucket.logs`. Any other value is a bare
7
+ * address and narrows every member the pull request plans: `--target
8
+ * aws_s3_bucket.logs`, or a Pulumi URN, `--target
9
+ * urn:pulumi:prod::app::aws:s3/bucket:Bucket::logs`, whose `urn` names no
10
+ * component. Each capability passes the addresses to its engine (terraform
11
+ * `-target`, pulumi `--target`); a capability that cannot narrow refuses by
12
+ * name before anything plans ({@link assertTargetsAccepted} in ./driver.ts).
13
+ *
14
+ * A value that names a component the pull request does not plan is refused,
15
+ * since nothing would narrow. With nothing planned, a bare address narrows
16
+ * nothing and is dropped.
17
+ */
18
+
19
+ /** The addresses by component, each list sorted and unique, or why the values are refused. */
20
+ export function prPlanTargets(values: readonly string[], planned: readonly string[], known: ReadonlySet<string>): { targets: Record<string, string[]> } | { error: string } {
21
+ const plannedSet = new Set(planned);
22
+ const out = new Map<string, Set<string>>();
23
+ const add = (component: string, address: string) => {
24
+ let set = out.get(component);
25
+ if (!set) out.set(component, (set = new Set()));
26
+ set.add(address);
27
+ };
28
+ for (const raw of values) {
29
+ const value = raw.trim();
30
+ if (value === "") return { error: "--target needs an address: --target <address> or --target <member>:<address>" };
31
+ const at = value.indexOf(":");
32
+ const named = at > 0 ? value.slice(0, at).trim() : "";
33
+ if (named !== "" && known.has(named)) {
34
+ const address = value.slice(at + 1).trim();
35
+ if (address === "") return { error: `--target ${value}: name an address after ${named}:` };
36
+ if (!plannedSet.has(named)) {
37
+ return { error: `--target ${value}: this pull request does not plan ${named} (it plans ${[...plannedSet].sort().join(", ") || "nothing"})` };
38
+ }
39
+ add(named, address);
40
+ continue;
41
+ }
42
+ for (const component of planned) add(component, value);
43
+ }
44
+ return { targets: Object.fromEntries([...out.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([c, s]) => [c, [...s].sort()])) };
45
+ }