@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
@@ -56,6 +56,8 @@ import type { DeployContext } from "./capability";
56
56
  import { groupsByComponent, narrowGroups, planAndRunComponentGroup, runComponentGroup } from "./groups";
57
57
  import { planWaveComponent, type WaveComponentPlan } from "./wave-plan";
58
58
  import { computePlanDigest } from "../lifecycle/plan-digest";
59
+ import { leaseRowsOf, type LockGrain, type LockRow } from "../lifecycle/lock-rows";
60
+ import { isLockRowsHeldError, type RowLease, type RowLeasePort } from "./row-lease";
59
61
  import { decideWaveGate, runWaveLoop, waveGateName, waveSetDigest, type WaveMember, type WaveRecord } from "../wave-engine";
60
62
 
61
63
  /** The sink a fan-out emits to: run events, and the older stream through them. */
@@ -191,6 +193,16 @@ export interface FanOutRunOptions {
191
193
  vars?: Record<string, unknown>;
192
194
  /** The addresses each component narrows to (#4300), by component: its steps' `DeployContext.targets`. */
193
195
  targets?: Readonly<Record<string, readonly string[]>>;
196
+ /** `ci.lockGrain` as declared (#4594), for every step's `DeployContext.lockGrain`. Absent: each step takes its lexicon's default. */
197
+ lockGrain?: LockGrain;
198
+ /**
199
+ * The run's row lease (#4594). Each step on the resource grain leases its
200
+ * rows through it, a group leases its members' rows in one take, and under
201
+ * `waveGate` each wave leases the rows its plans lock before it applies.
202
+ * Not with `plans`: a caller that planned beforehand leases those rows
203
+ * itself, as pr-apply does. Absent: no lease.
204
+ */
205
+ rowLease?: RowLeasePort;
194
206
  /** Outputs of components this run is not running: the ones the plan lists in `seeds`. */
195
207
  componentOutputs?: Record<string, Record<string, unknown>>;
196
208
  onProgress?: (event: RunProgressEvent) => void;
@@ -331,6 +343,9 @@ export async function runFanOut(
331
343
  if (options.waveGate && options.plans) {
332
344
  throw new Error("a gated-wave fan-out plans each wave itself, so it takes no plans made beforehand");
333
345
  }
346
+ if (options.rowLease && options.plans) {
347
+ throw new Error("a fan-out handed plans made beforehand leases their rows where they were planned, so it takes no row lease");
348
+ }
334
349
  if (options.waveGate && plan.groups?.length) {
335
350
  throw new Error("a gated-wave fan-out plans component by component, so it takes no groups");
336
351
  }
@@ -631,6 +646,8 @@ async function runGatedWaves(
631
646
  contexts: Map<string, DeployContext>;
632
647
  members: WaveMember[];
633
648
  plansFor: Map<string, Record<string, unknown>>;
649
+ /** The rows each component's plan locks on the resource grain (#4594). */
650
+ rowsFor: Map<string, LockRow[]>;
634
651
  waveFailures: Array<{ component: string; error?: string }>;
635
652
  }
636
653
  /** `next`: go on to the next wave. `stop`: the run ends here. */
@@ -665,6 +682,7 @@ async function runGatedWaves(
665
682
 
666
683
  const members: WaveMember[] = [];
667
684
  const plansFor = new Map<string, Record<string, unknown>>();
685
+ const rowsFor = new Map<string, LockRow[]>();
668
686
  const waveFailures: Array<{ component: string; error?: string }> = [];
669
687
  for (const p of planned) {
670
688
  if ("error" in p) {
@@ -673,8 +691,9 @@ async function runGatedWaves(
673
691
  }
674
692
  members.push(...p.members);
675
693
  plansFor.set(p.component, p.plans);
694
+ rowsFor.set(p.component, leaseRowsOf(p.locks));
676
695
  }
677
- return { go: { runnable, gateName, contexts, members, plansFor, waveFailures } };
696
+ return { go: { runnable, gateName, contexts, members, plansFor, rowsFor, waveFailures } };
678
697
  },
679
698
 
680
699
  digest(_at, { members, plansFor, waveFailures }) {
@@ -741,24 +760,55 @@ async function runGatedWaves(
741
760
  return { go: { check, record, toRun } };
742
761
  },
743
762
 
744
- async apply({ k: waveNum }, { contexts, plansFor, waveFailures }, { check, record, toRun }) {
763
+ async apply({ k: waveNum }, { contexts, plansFor, rowsFor, waveFailures }, { check, record, toRun }) {
745
764
  emit?.({ type: "wave-start", wave: waveNum, components: toRun });
746
- const waveResults = await Promise.all(
747
- toRun.map(async (name) => {
748
- emit?.({ type: "component-start", wave: waveNum, component: name });
749
- const plans = plansFor.get(name)!;
750
- const ctx = { ...contexts.get(name)!, ...(Object.keys(plans).length > 0 ? { plans } : {}) };
751
- const result = await runComponentDeploy(byName.get(name)!, ctx, registry, componentOutputs, undefined, gates, emit);
752
- emit?.({
753
- type: "component-settle",
754
- wave: waveNum,
755
- component: name,
756
- status: result.status === "fail" ? "failed" : result.status,
757
- });
758
- options.onComponentSettled?.(result, componentOutputs[name]);
759
- return result;
760
- }),
761
- );
765
+ // #4594: the rows of the plans the wave's gate approved, in one take before anything of the wave applies.
766
+ const rows = toRun.flatMap((name) => rowsFor.get(name) ?? []);
767
+ let waveLease: RowLease | undefined;
768
+ if (options.rowLease && rows.length > 0) {
769
+ try {
770
+ waveLease = await options.rowLease.take(rows, `wave ${waveNum}`);
771
+ } catch (err) {
772
+ const error = err instanceof Error ? err.message : String(err);
773
+ const held = isLockRowsHeldError(err);
774
+ for (const name of toRun) {
775
+ results.push({ component: name, ok: false, status: "fail", records: [{ component: name, phase: "Apply", kind: "lock-rows", status: "fail", durationMs: 0, error, ...(held ? { held: true as const } : {}) }] });
776
+ failed.push(name);
777
+ waveFailures.push({ component: name, error });
778
+ emit?.({ type: "component-settle", wave: waveNum, component: name, status: "failed" });
779
+ markBlocked(name);
780
+ }
781
+ const settled: WaveRecord = { ...record, status: "failed", approvedBy: check.resolution.resolvedBy, failed: waveFailures };
782
+ waves.push(settled);
783
+ options.onWaveSettled?.(settled);
784
+ emit?.({ type: "wave-settle", wave: waveNum, status: "failed" });
785
+ skips.blocked(blockedBy);
786
+ return "next";
787
+ }
788
+ }
789
+ let waveResults: DriverComponentResult[];
790
+ try {
791
+ waveResults = await Promise.all(
792
+ toRun.map(async (name) => {
793
+ emit?.({ type: "component-start", wave: waveNum, component: name });
794
+ const plans = plansFor.get(name)!;
795
+ // The wave holds the rows already, so its steps take no lease of their own.
796
+ const { rowLease: _leased, ...own } = contexts.get(name)!;
797
+ const ctx = { ...own, ...(Object.keys(plans).length > 0 ? { plans } : {}) };
798
+ const result = await runComponentDeploy(byName.get(name)!, ctx, registry, componentOutputs, undefined, gates, emit);
799
+ emit?.({
800
+ type: "component-settle",
801
+ wave: waveNum,
802
+ component: name,
803
+ status: result.status === "fail" ? "failed" : result.status,
804
+ });
805
+ options.onComponentSettled?.(result, componentOutputs[name]);
806
+ return result;
807
+ }),
808
+ );
809
+ } finally {
810
+ await waveLease?.release();
811
+ }
762
812
  results.push(...waveResults);
763
813
 
764
814
  for (const result of waveResults) {
@@ -31,6 +31,7 @@ import type { ChangeSetPart } from "../change-set";
31
31
  import type { PlanShape } from "./covered-round";
32
32
  import {
33
33
  accumulateComponentOutputs,
34
+ assertPlanFlagsAccepted,
34
35
  assertTargetsAccepted,
35
36
  resolveComponentGraph,
36
37
  resolveStepInput,
@@ -59,7 +60,9 @@ import {
59
60
  type ReportedGroupRead,
60
61
  } from "./capability";
61
62
  import type { FanOutGroup, FanOutGroupFallback, FanOutPlan } from "./fan-out";
62
- import { bindTargets, type WaveComponentPlan } from "./wave-plan";
63
+ import { bindPlanFlags, bindTargets, type WaveComponentPlan } from "./wave-plan";
64
+ import { resolvePlannedLock } from "../lifecycle/lock-rows";
65
+ import { groupLockRows, isLockRowsHeldError, type RowLease } from "./row-lease";
63
66
 
64
67
  /** Whether a capability declares the pair; one with only one of the two never gets a group (ws-107). */
65
68
  function groupsCapable(capability: Capability<never, unknown>): boolean {
@@ -262,6 +265,7 @@ function groupMembers(
262
265
  const { kind: _kind, ...step } = at.step;
263
266
  const base = ctxOf(name);
264
267
  assertTargetsAccepted(component, registry, base);
268
+ assertPlanFlagsAccepted(component, registry, base);
265
269
  const reads = groupReadsOf(step, inGroup, name);
266
270
  const dependsOn = component.dependsOn?.length ? { dependsOn: [...component.dependsOn] } : {};
267
271
  if (!outside) return { component: name, step, reads, ...dependsOn, ctx: base };
@@ -663,7 +667,7 @@ export async function planComponentGroup(options: PlanComponentGroupOptions): Pr
663
667
  for (const m of members) {
664
668
  const own = planned.members[m.component];
665
669
  if (!own) throw new Error(`${group.capability} planned the group ${group.components.join(", ")} without a plan for ${m.component}`);
666
- bound.set(m.component, bindTargets(group.capability, m.ctx, own));
670
+ bound.set(m.component, bindPlanFlags(m.ctx, bindTargets(group.capability, m.ctx, own)));
667
671
  }
668
672
  const digest = groupDigest(
669
673
  group.capability,
@@ -682,6 +686,8 @@ export async function planComponentGroup(options: PlanComponentGroupOptions): Pr
682
686
  const plan = bindGroup(own, digest, unknown);
683
687
  runPlans[m.component] = plan;
684
688
  const shapes: Record<string, PlanShape> | undefined = own.shape ? { [plan.member]: { ...own.shape, member: plan.member } } : undefined;
689
+ // #4594: each member's grain and rows, as a component planned alone carries them, so a pull request locks and leases a group's rows too.
690
+ const lock = await resolvePlannedLock(capability, m.input, plan, m.ctx.lockGrain);
685
691
  plans.push({
686
692
  component: m.component,
687
693
  members: [{ member: plan.member, planDigest: plan.planDigest }],
@@ -689,6 +695,7 @@ export async function planComponentGroup(options: PlanComponentGroupOptions): Pr
689
695
  parts: [plan.changeSet!],
690
696
  ...(own.outputs ? { outputs: own.outputs } : {}),
691
697
  ...(shapes ? { shapes } : {}),
698
+ locks: { [plan.member]: lock },
692
699
  });
693
700
  }
694
701
  return { plans, digest, run: { ...(planned.artifact !== undefined ? { artifact: planned.artifact } : {}), digest, plans: runPlans } };
@@ -746,18 +753,19 @@ export async function runComponentGroup(options: RunComponentGroupOptions): Prom
746
753
  durationMs: Date.now() - start,
747
754
  ...body,
748
755
  });
749
- const everyMember = (status: "failed" | "not-started", error: string, planMoved = false): ComponentGroupRunResult => ({
756
+ const everyMember = (status: "failed" | "not-started", error: string, planMoved = false, held = false): ComponentGroupRunResult => ({
750
757
  results: group.components.map((name) => ({
751
758
  component: name,
752
759
  ok: false,
753
760
  status: "fail" as const,
754
- records: [record(name, { status: status === "failed" ? "fail" : "skipped", error, ...(planMoved ? { planMoved: true as const } : {}) })],
761
+ records: [record(name, { status: status === "failed" ? "fail" : "skipped", error, ...(planMoved ? { planMoved: true as const } : {}), ...(held ? { held: true as const } : {}) })],
755
762
  })),
756
763
  notStarted: status === "not-started" ? [...group.components] : [],
757
764
  outcomes: Object.fromEntries(group.components.map((name) => [name, status])),
758
765
  });
759
766
 
760
767
  let outcome: CapabilityGroupOutcome;
768
+ let lease: RowLease | undefined;
761
769
  try {
762
770
  if (!options.run) throw new Error(`no approved plan of the group ${group.components.join(", ")} to apply`);
763
771
  const capability = options.registry.resolve(group.capability);
@@ -768,10 +776,19 @@ export async function runComponentGroup(options: RunComponentGroupOptions): Prom
768
776
  return { ...options.ctxOf(component), ...(plan ? { plans: { [plan.member]: plan } } : {}) };
769
777
  };
770
778
  const members = groupMembers(group, options.components, options.registry, ctxOf, options.componentOutputs);
779
+ // #4594: a run that plans inside its steps leases the rows of every member's plan in one take before the group applies.
780
+ const port = options.ctxOf(group.components[0]!).rowLease;
781
+ if (port) {
782
+ const rows = await groupLockRows(capability, members, run.plans, options.ctxOf(group.components[0]!).lockGrain);
783
+ lease = await port.take(rows, `the group ${group.components.join(", ")}`);
784
+ }
771
785
  outcome = await capability.runGroup!(groupContext(group, options.env, options.vars), run, members as never);
772
786
  } catch (err) {
773
787
  const error = err instanceof Error ? err.message : String(err);
788
+ if (isLockRowsHeldError(err)) return everyMember("not-started", error, false, true);
774
789
  return isPlanMovedError(err) ? everyMember("not-started", `not started: ${error}`, true) : everyMember("failed", error);
790
+ } finally {
791
+ await lease?.release();
775
792
  }
776
793
 
777
794
  const results: DriverComponentResult[] = [];
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Plan flags through the capability contract (#4627): a capability says it
3
+ * takes `refresh` and `targetDependents`, a component is refused by name
4
+ * when one of its steps cannot, the context carries them, and the member's
5
+ * digest binds them. Written for the ci-products post-merge pass.
6
+ */
7
+ import { describe, expect, test } from "vitest";
8
+ import { CapabilityRegistry, PlanFlagRefusedError, planFlagRefusal, type Capability, type CapabilityPlan } from "./capability";
9
+ import { assertPlanFlagsAccepted, deployContext, type DriverComponent } from "./driver";
10
+ import { bindPlanFlags } from "./wave-plan";
11
+
12
+ const cap = (kind: string, planFlags?: Capability<never, unknown>["planFlags"]) =>
13
+ ({ kind, ...(planFlags ? { planFlags } : {}), async run() { return {}; } }) as unknown as Capability<never, unknown>;
14
+ const registry = new CapabilityRegistry().register(cap("both", { refresh: "accept", targetDependents: "accept" })).register(cap("refresh-only", { refresh: "accept", targetDependents: { refuse: "no flag for it" } })).register(cap("silent"));
15
+ const component = (kind: string): DriverComponent => ({ name: "c", dependsOn: [], deploy: [{ phase: "Apply", steps: [{ kind, root: "r" }] }] });
16
+
17
+ describe("plan flags (#4627)", () => {
18
+ test("a capability's refusal, its own reason or one naming the verb", () => {
19
+ expect(planFlagRefusal(cap("both", { refresh: "accept" }), "refresh")).toBeUndefined();
20
+ expect(planFlagRefusal(cap("x", { targetDependents: { refuse: "why" } }), "targetDependents")).toBe("why");
21
+ expect(planFlagRefusal(cap("silent"), "refresh")).toBe("silent does not say it can plan with --refresh");
22
+ });
23
+
24
+ test("a component is refused by name and flag", () => {
25
+ expect(() => assertPlanFlagsAccepted(component("both"), registry, { refresh: true, targetDependents: true })).not.toThrow();
26
+ expect(() => assertPlanFlagsAccepted(component("refresh-only"), registry, { targetDependents: true })).toThrow(PlanFlagRefusedError);
27
+ expect(() => assertPlanFlagsAccepted(component("refresh-only"), registry, { targetDependents: true })).toThrow('component "c": refresh-only refuses --target-dependents: no flag for it');
28
+ expect(() => assertPlanFlagsAccepted(component("silent"), registry, { refresh: true })).toThrow(/refuses --refresh/);
29
+ expect(() => assertPlanFlagsAccepted(component("silent"), registry, {})).not.toThrow();
30
+ });
31
+
32
+ test("the context carries refresh for every component, and target dependents only with targets", () => {
33
+ expect(deployContext({ env: "dev", refresh: true, targetDependents: true, targets: { a: ["x"] } }, "a")).toMatchObject({ refresh: true, targetDependents: true, targets: ["x"] });
34
+ expect(deployContext({ env: "dev", refresh: true, targetDependents: true, targets: { a: ["x"] } }, "b")).toEqual({ env: "dev", component: "b", refresh: true });
35
+ });
36
+
37
+ test("the digest binds each flag, and a plain plan keeps its own", () => {
38
+ const planned = { member: "m", planDigest: "sha256:" + "1".repeat(64), changeSet: { member: { member: "m", lexicon: "x", planner: "chant", status: "planned" as const, planDigest: "sha256:" + "1".repeat(64), holes: [] }, entries: [] } } as unknown as CapabilityPlan;
39
+ expect(bindPlanFlags({}, planned)).toBe(planned);
40
+ const refreshed = bindPlanFlags({ refresh: true }, planned);
41
+ const widened = bindPlanFlags({ targetDependents: true }, planned);
42
+ expect(refreshed.planDigest).not.toBe(planned.planDigest);
43
+ expect(widened.planDigest).not.toBe(refreshed.planDigest);
44
+ expect(refreshed.changeSet!.member.planDigest).toBe(refreshed.planDigest);
45
+ });
46
+ });
@@ -0,0 +1,34 @@
1
+ /**
2
+ * The comment preview passes the comment's --target addresses to pr-plan
3
+ * (#4626): `pr-plan --comment-targets`, with the comment in
4
+ * CHANT_PREVIEW_COMMENT on GitHub and Forgejo and from the pipeline's
5
+ * variable on GitLab. Written for the ci-products post-merge pass.
6
+ */
7
+ import { describe, expect, test } from "vitest";
8
+ import { PREVIEW_COMMENT_ENV, prCommentPreviewJob, prLoopJobs } from "./pr-pipeline";
9
+ import { PLYWOOD } from "../__fixtures__/product-words";
10
+
11
+ const words = { ...PLYWOOD, commands: { preview: "plan" as const } };
12
+
13
+ describe("the comment preview's targets (#4626)", () => {
14
+ test("GitHub and Forgejo: the plan reads the comment from a variable, never the shell line", () => {
15
+ for (const forge of ["github", "forgejo"] as const) {
16
+ const job = prCommentPreviewJob(forge, "prod", { previewComment: true, words }, undefined)!;
17
+ expect(job.plan.command).toContain("--comment-targets");
18
+ expect(job.plan.run.command).toContain("--comment-targets");
19
+ expect(job.plan.run.env[PREVIEW_COMMENT_ENV]).toBe("${{ github.event.comment.body }}");
20
+ expect(job.plan.run.command).not.toContain("comment.body");
21
+ }
22
+ });
23
+
24
+ test("GitLab: the plan reads the pipeline's own variable", () => {
25
+ const job = prCommentPreviewJob("gitlab", "prod", { previewComment: true, words }, undefined)!;
26
+ expect(job.plan.run.command).toContain("--comment-targets");
27
+ expect(job.plan.run.env).not.toHaveProperty(PREVIEW_COMMENT_ENV);
28
+ });
29
+
30
+ test("the pull request's own plan job reads no comment", () => {
31
+ const [plan] = prLoopJobs("github", "prod", { words });
32
+ expect(plan!.command).not.toContain("--comment-targets");
33
+ });
34
+ });
@@ -0,0 +1,54 @@
1
+ /**
2
+ * The comment preview (#4620): with `previewComment`, `/<product> <plan
3
+ * word>` runs pr-plan again at the pull request's head with a read token,
4
+ * and the job after it posts the note. productPipelineJobs returns the same
5
+ * jobs the forge lexicons write.
6
+ */
7
+
8
+ import { describe, expect, test } from "vitest";
9
+ import { GITLAB_PREVIEW_PR_VAR, prCommentPreviewJob } from "./pr-pipeline";
10
+ import { productPipelineJobs } from "./product-pipeline";
11
+
12
+ const WORDS = { product: "plywood", stages: { plan: "preview", apply: "up" }, commands: { preview: "plan" as const }, bin: "npx --no-install plywood" };
13
+
14
+ describe("prCommentPreviewJob", () => {
15
+ test("none without previewComment", () => {
16
+ expect(prCommentPreviewJob("github", "prod", { words: WORDS })).toBeUndefined();
17
+ });
18
+
19
+ test("GitHub: the comment from the words, the issue's number, the head ref, and the base from the target branch", () => {
20
+ const job = prCommentPreviewJob("github", "prod", { words: WORDS, previewComment: true })!;
21
+ expect(job.comment).toBe("/plywood preview");
22
+ expect(job.plan.run.env.PR_NUMBER).toBe("${{ github.event.issue.number }}");
23
+ expect(job.plan.run.env.BASE_SHA).toBeUndefined();
24
+ expect(job.plan.run.command).toContain("npx --no-install plywood ci run plan");
25
+ expect(job.plan.run.env.GITHUB_TOKEN).toBeUndefined();
26
+ expect(job.head).toEqual({ ref: "refs/pull/${{ github.event.issue.number }}/head" });
27
+ expect(job.base).toContain('refs/remotes/origin/main^{commit}');
28
+ expect(job.post.command).toBe('npx --no-install plywood components pr-post --pr "$PR_NUMBER" --head "$HEAD_SHA" --env prod --output .chant/pr --forge github --result "$PLAN_RESULT"');
29
+ expect(job.post.env.HEAD_SHA).toBe("${{ needs.comment-preview.outputs.head }}");
30
+ });
31
+
32
+ test("GitLab: the iid from CHANT_PREVIEW_PR, the head checked out in the job, and the post finds the head again", () => {
33
+ const job = prCommentPreviewJob("gitlab", "prod", { words: WORDS, previewComment: true })!;
34
+ expect(job.gitlabVar).toBe(GITLAB_PREVIEW_PR_VAR);
35
+ expect(job.plan.run.env.PR_NUMBER).toBe("$CHANT_PREVIEW_PR");
36
+ expect(job.plan.run.env.BASE_SHA).toBe("$CI_COMMIT_SHA");
37
+ expect(job.head).toEqual({ line: expect.stringContaining("refs/merge-requests/$PR_NUMBER/head") });
38
+ expect(job.post.setup?.[0]).toContain("git ls-remote origin");
39
+ expect(job.post.command).not.toContain("--result");
40
+ });
41
+
42
+ test("words with no plan command are refused", () => {
43
+ expect(() => prCommentPreviewJob("github", "prod", { words: { product: "plywood", commands: {} }, previewComment: true })).toThrow(/the words name no plan command/);
44
+ });
45
+ });
46
+
47
+ describe("productPipelineJobs with previewComment", () => {
48
+ test("returns the preview beside the plan, and nothing without it", () => {
49
+ const jobs = productPipelineJobs("github", "prod", { words: WORDS, previewComment: true });
50
+ expect(jobs.preview?.comment).toBe("/plywood preview");
51
+ expect(jobs.comments.plan).toBe("/plywood preview");
52
+ expect(productPipelineJobs("github", "prod", { words: WORDS }).preview).toBeUndefined();
53
+ });
54
+ });
@@ -0,0 +1,9 @@
1
+ import { describe, expect, test } from "vitest";
2
+ import { appendPrEnvRecord, PrEnvRecordError } from "./pr-env-ledger";
3
+ import type { PrEnvRecord } from "./pr-environment";
4
+
5
+ describe("appendPrEnvRecord (#4551)", () => {
6
+ test("refuses a record the reader would skip, before any git runs", async () => {
7
+ await expect(appendPrEnvRecord({ version: 1, kind: "up", env: "pr-1" } as unknown as PrEnvRecord, { cwd: "/nonexistent" })).rejects.toBeInstanceOf(PrEnvRecordError);
8
+ });
9
+ });
@@ -0,0 +1,42 @@
1
+ /**
2
+ * The append and read of `_pr-envs/records.jsonl` (#4551), the ledger of
3
+ * pull request environments, for a product that applies or tears one down
4
+ * itself (terragucci's ephemeral copies). It imports only the git layer and
5
+ * the record parser, so a product bundle loads no Ajv and no component
6
+ * driver.
7
+ *
8
+ * Each write goes under the member prefix of `cwd` and honours `--no-record`
9
+ * through `../lifecycle/git.ts`. Neither function pushes: call
10
+ * `pushLifecycleReport` after, the two-step shape every ledger here uses.
11
+ */
12
+ import { appendLedgerLine, readBlobFromPath, type LedgerLocation } from "../lifecycle/git";
13
+ import { PR_ENV_LEDGER_DIR, PR_ENV_LEDGER_FILE, parsePrEnvRecords, type PrEnvRecord } from "./pr-environment";
14
+
15
+ /** The first chant that exports {@link appendPrEnvRecord} and {@link readPrEnvRecords} (#4551). */
16
+ export const PR_ENV_APPEND_FLOOR = "0.124.55";
17
+
18
+ /** A record {@link parsePrEnvRecords} would skip, so it is never appended. */
19
+ export class PrEnvRecordError extends Error {
20
+ constructor(message: string) {
21
+ super(message);
22
+ this.name = "PrEnvRecordError";
23
+ }
24
+ }
25
+
26
+ /**
27
+ * Append one record to `_pr-envs/records.jsonl` under the member prefix of
28
+ * `opts.cwd`. Refuses a record the reader would skip. Does not push.
29
+ */
30
+ export async function appendPrEnvRecord(record: PrEnvRecord, opts?: { cwd?: string }): Promise<{ commit: string; record: PrEnvRecord }> {
31
+ const line = JSON.stringify(record);
32
+ if (parsePrEnvRecords(line).length !== 1) {
33
+ throw new PrEnvRecordError(`not a pull request environment record: it needs version 1, kind up or down, a numeric pr, env and marker.stack`);
34
+ }
35
+ const commit = await appendLedgerLine(PR_ENV_LEDGER_DIR, PR_ENV_LEDGER_FILE, line, `Pull request environment ${record.env} ${record.kind} (${record.result})`, opts);
36
+ return { commit, record };
37
+ }
38
+
39
+ /** Every record in `_pr-envs/records.jsonl`, oldest first. Reads the local branch and never fetches. */
40
+ export async function readPrEnvRecords(location?: LedgerLocation): Promise<PrEnvRecord[]> {
41
+ return parsePrEnvRecords(await readBlobFromPath(PR_ENV_LEDGER_DIR, PR_ENV_LEDGER_FILE, location));
42
+ }
@@ -9,6 +9,8 @@
9
9
 
10
10
  import type { PrForge } from "../pr-forge";
11
11
  import type { PrEnvPorts } from "./pr-env-run";
12
+ import type { GateApprovalSource } from "../op/op-waves";
13
+ import type { GateSigners } from "../lifecycle/gate-seal";
12
14
  import {
13
15
  PR_ENV_LEDGER_DIR,
14
16
  PR_ENV_LEDGER_FILE,
@@ -50,7 +52,21 @@ export function forgePrEnvPublisher(forge: PrForge, warn: (message: string) => v
50
52
  * ledger read without writing a pending fact. With `forge`, the note and
51
53
  * status are posted and the sweep asks it whether a pull request is open.
52
54
  */
53
- export function lifecyclePrEnvPorts(opts: { cwd?: string; forge?: PrForge; log?: (line: string) => void; warn?: (message: string) => void } = {}): PrEnvPorts {
55
+ export function lifecyclePrEnvPorts(
56
+ opts: {
57
+ cwd?: string;
58
+ forge?: PrForge;
59
+ log?: (line: string) => void;
60
+ warn?: (message: string) => void;
61
+ /**
62
+ * Which approvals of the `pr-env` gate count (#4551), for a product whose
63
+ * gate is `sealed`: decided with `decideGateApproval` under `mode`, with
64
+ * `signers` the signers at base. Absent, any approval of the digest on the
65
+ * ledger counts, as before.
66
+ */
67
+ approval?: { mode: GateApprovalSource; signers?: GateSigners };
68
+ } = {},
69
+ ): PrEnvPorts {
54
70
  const at = opts.cwd ? { cwd: opts.cwd } : undefined;
55
71
  const warn = opts.warn ?? (() => {});
56
72
  const forge = opts.forge;
@@ -61,10 +77,11 @@ export function lifecyclePrEnvPorts(opts: { cwd?: string; forge?: PrForge; log?:
61
77
  return parsePrEnvRecords(await readBlobFromPath(PR_ENV_LEDGER_DIR, PR_ENV_LEDGER_FILE, at));
62
78
  },
63
79
  async appendRecord(record) {
64
- const { appendLedgerLine, fetchLifecycle, pushLifecycleReport } = await import("../lifecycle/git");
80
+ const { fetchLifecycle, pushLifecycleReport } = await import("../lifecycle/git");
81
+ const { appendPrEnvRecord } = await import("./pr-env-ledger");
65
82
  try {
66
83
  await fetchLifecycle(at).catch(() => false);
67
- await appendLedgerLine(PR_ENV_LEDGER_DIR, PR_ENV_LEDGER_FILE, JSON.stringify(record), `Pull request environment ${record.env} ${record.kind} (${record.result})`, at);
84
+ await appendPrEnvRecord(record, at);
68
85
  const pushed = await pushLifecycleReport(at);
69
86
  if (pushed.pushWarning) warn(pushed.pushWarning);
70
87
  } catch (err) {
@@ -72,8 +89,16 @@ export function lifecyclePrEnvPorts(opts: { cwd?: string; forge?: PrForge; log?:
72
89
  }
73
90
  },
74
91
  async decideGate(input) {
75
- const { approvalOf, decidePrGate, readOnlyLedger } = await import("./pr-run");
76
92
  const { gitGateLedgerPort } = await import("../op/gate");
93
+ if (opts.approval) {
94
+ // #4551: the product's approval mode, decided as chant decides any plan-bound gate.
95
+ const { decideGateApproval } = await import("../gate-decision");
96
+ const ledger = await gitGateLedgerPort(at).read(input.op);
97
+ const decided = decideGateApproval({ ledger, gate: input.gate, planDigest: input.digest, mode: opts.approval.mode, ...(opts.approval.signers ? { signers: opts.approval.signers } : {}) });
98
+ if (decided.status === "approved") return { status: "approved", ...(decided.via === "ledger" ? { approvedBy: [decided.resolution.resolvedBy] } : {}) };
99
+ return { status: decided.mismatched ? "changed" : "pending" };
100
+ }
101
+ const { approvalOf, decidePrGate, readOnlyLedger } = await import("./pr-run");
77
102
  const approval = approvalOf(await decidePrGate(readOnlyLedger(gitGateLedgerPort(at)), input));
78
103
  return { status: approval.status, ...(approval.approvedBy ? { approvedBy: approval.approvedBy } : {}) };
79
104
  },
@@ -26,30 +26,18 @@ describe("the pr-env-run bundle", () => {
26
26
  });
27
27
  const inputs = Object.keys(result.metafile.inputs).map((i) => i.replace(/^.*?packages\//, "packages/")).sort();
28
28
  expect(inputs).toEqual([
29
- "packages/core/src/change-set.ts",
30
29
  "packages/core/src/ci-handover.ts",
31
30
  "packages/core/src/ci-jobs.ts",
32
- "packages/core/src/components/changed-files.ts",
33
31
  "packages/core/src/components/pr-env-run.ts",
34
32
  "packages/core/src/components/pr-environment.ts",
35
- "packages/core/src/components/pr-pipeline.ts",
36
33
  "packages/core/src/config-environments.ts",
37
- "packages/core/src/content-digest.ts",
38
- "packages/core/src/declarable.ts",
39
- "packages/core/src/effect-receipt.ts",
40
- "packages/core/src/gated-waves.ts",
41
- "packages/core/src/intrinsic.ts",
42
- "packages/core/src/lifecycle/plan-digest.ts",
34
+ // The exit-code table (#4553): no imports.
35
+ "packages/core/src/exit-codes.ts",
43
36
  "packages/core/src/lifecycle/teardown.ts",
44
37
  "packages/core/src/live-endpoint.ts",
45
38
  "packages/core/src/observation.ts",
46
39
  "packages/core/src/op/activity-runtime.ts",
47
40
  "packages/core/src/op/emulator-lifecycle.ts",
48
- "packages/core/src/plan-summary.ts",
49
- "packages/core/src/pr-loop.ts",
50
- "packages/core/src/pr-migrations.ts",
51
- // The next-release floor constant (#4480): no imports.
52
- "packages/core/src/release-floors.ts",
53
41
  ]);
54
42
  expect(inputs.some((i) => /node_modules\/(ajv|js-yaml)\//.test(i) || i.endsWith("/op/gate.ts") || i.endsWith("/src/config.ts") || i.endsWith("/ts-loader.ts"))).toBe(false);
55
43
  expect(result.outputFiles.reduce((n, f) => n + f.contents.byteLength, 0)).toBeLessThan(40 * 1024);
@@ -125,6 +125,25 @@ describe("up", () => {
125
125
  expect(r.exit).toBe(1);
126
126
  expect(p.records).toEqual([]);
127
127
  });
128
+
129
+ test("an apply whose rows another run holds is refused with exit 5 and keeps no record (#4594)", async () => {
130
+ const p = ports({ status: "approved" });
131
+ const message = "run 4711 (https://forge.example/runs/4711) is applying net: aws_vpc.main, so nothing of pr-12 was applied";
132
+ const adapter: PrEnvAdapter = { ...roots(), apply: async (_t, { planned }) => ({ status: "stopped", held: true, rows: planned.rows, message }) };
133
+ const r = await prEnvUp({ ...UP, adapter, ports: p });
134
+ expect(r.exit).toBe(5);
135
+ expect(r.report).toMatchObject({ status: "refused", message });
136
+ expect(p.records).toEqual([]);
137
+ });
138
+
139
+ test("a later round whose rows another run holds exits 5, and what applied before it is kept as live (#4594)", async () => {
140
+ const p = ports({ status: "approved" });
141
+ const adapter: PrEnvAdapter = { ...roots(), apply: async (_t, { planned }) => ({ status: "waiting", held: true, rows: planned.rows, message: "run 4711 is applying app: aws_lb.web" }) };
142
+ const r = await prEnvUp({ ...UP, adapter, ports: p });
143
+ expect(r.exit).toBe(5);
144
+ expect(p.records).toHaveLength(1);
145
+ expect(p.records[0]).toMatchObject({ kind: "up", result: "failed" });
146
+ });
128
147
  });
129
148
 
130
149
  /** A teardown adapter over the roots the record names: each root's copy, with the marker its key's suffix says. */
@@ -87,6 +87,12 @@ export interface PrEnvApplied {
87
87
  * failed), so no record is kept.
88
88
  */
89
89
  status: "applied" | "failed" | "waiting" | "stopped";
90
+ /**
91
+ * Another run holds a row this apply changes (#4594). With `stopped`,
92
+ * nothing applied; with `waiting`, a later round did not. `up` exits 5
93
+ * either way, and `message` names the run.
94
+ */
95
+ held?: boolean;
90
96
  /** The rows again, with each component's status after the apply. */
91
97
  rows: PrEnvReportRow[];
92
98
  /** Where each component's copy lives, kept on the record for the teardown (a suffixed state key). */
@@ -252,7 +258,11 @@ export async function prEnvUp(input: PrEnvUpInput): Promise<PrEnvRunResult> {
252
258
  applied = { status: "failed", rows: planned.rows, message: messageOf(err) };
253
259
  }
254
260
  if (applied.status === "stopped") {
255
- return settle({ ...base, digest, status: "failed", components: applied.rows, ...(approvedBy ? { approvedBy } : {}), ...(applied.message ? { message: applied.message } : {}) }, PR_ENV_EXIT.failed);
261
+ // #4594: rows another run holds refuse the apply, exit 5; nothing applied, so no record is kept.
262
+ return settle(
263
+ { ...base, digest, status: applied.held ? "refused" : "failed", components: applied.rows, ...(approvedBy ? { approvedBy } : {}), ...(applied.message ? { message: applied.message } : {}) },
264
+ applied.held ? PR_ENV_EXIT.held : PR_ENV_EXIT.failed,
265
+ );
256
266
  }
257
267
  const ok = applied.status === "applied";
258
268
  const now = (input.now ?? (() => new Date()))();
@@ -285,7 +295,7 @@ export async function prEnvUp(input: PrEnvUpInput): Promise<PrEnvRunResult> {
285
295
  ports.log?.(`pr-env up: ${env} ${ok ? "applied" : applied.status}; it expires ${expiresAt}`);
286
296
  return settle(
287
297
  { ...base, digest, status: ok ? "applied" : "failed", components: applied.rows, ...(approvedBy ? { approvedBy } : {}), expiresAt, ...(message ? { message } : {}) },
288
- ok && !applied.afterFailure ? PR_ENV_EXIT.done : PR_ENV_EXIT.failed,
298
+ ok && !applied.afterFailure ? PR_ENV_EXIT.done : applied.held ? PR_ENV_EXIT.held : PR_ENV_EXIT.failed,
289
299
  record,
290
300
  );
291
301
  }
@@ -17,6 +17,7 @@ import {
17
17
  livePrEnvironments,
18
18
  ownedEntries,
19
19
  parsePrEnvRecords,
20
+ prEnvTemplateOwner,
20
21
  prEnvStatusState,
21
22
  releaseTargetRefusal,
22
23
  renderPrEnvNote,
@@ -84,6 +85,34 @@ describe("deriving a pull request's environment", () => {
84
85
  });
85
86
  });
86
87
 
88
+ describe("a template a lexicon takes as its own stack (#4609)", () => {
89
+ const pulumiLike = { name: "pulumi", prEnvTemplate: (t: string) => (/^[^/]+\/[^/]+$/.test(t) ? `the Pulumi stack ${t}` : undefined) };
90
+
91
+ test("the first lexicon that takes the template answers, and none takes a plain environment name", () => {
92
+ expect(prEnvTemplateOwner([{ name: "aws" }, pulumiLike], "shop/dev")).toEqual({ lexicon: "pulumi", describe: "the Pulumi stack shop/dev" });
93
+ expect(prEnvTemplateOwner([{ name: "aws" }, pulumiLike], "staging")).toBeUndefined();
94
+ expect(prEnvTemplateOwner(undefined, "shop/dev")).toBeUndefined();
95
+ });
96
+
97
+ test("a stack-name template needs no chant.config.ts environment and takes no template endpoint", () => {
98
+ const owner = prEnvTemplateOwner([pulumiLike], "shop/dev")!;
99
+ const d = derivePrEnvironment(CONFIG, "shop/dev", 7, { templateOwner: owner });
100
+ expect(d).toMatchObject({ env: "pr-7", template: "shop/dev", stack: "shop", templateOwner: "pulumi" });
101
+ if ("refusal" in d) throw new Error(d.refusal);
102
+ expect(d.endpoint).toBeUndefined();
103
+ // Without the owner the same template is refused as before.
104
+ expect(derivePrEnvironment(CONFIG, "shop/dev", 7)).toMatchObject({ refusal: expect.stringContaining("do not declare") });
105
+ });
106
+
107
+ test("the other checks still hold for a stack-name template", () => {
108
+ const owner = { lexicon: "pulumi", describe: "the Pulumi stack shop/dev" };
109
+ expect(derivePrEnvironment({ ...CONFIG, environments: ["staging"] } as ChantConfig, "shop/dev", 7, { templateOwner: owner })).toMatchObject({ refusal: expect.stringContaining('add "pr-*"') });
110
+ expect(derivePrEnvironment({ ...CONFIG, ownership: undefined } as ChantConfig, "shop/dev", 7, { templateOwner: owner })).toMatchObject({ refusal: expect.stringContaining("no ownership.stack") });
111
+ const own = { ...CONFIG, environments: ["staging", { name: "pr-*", endpoint: "http://localhost:9000" }] } as ChantConfig;
112
+ expect(derivePrEnvironment(own, "shop/dev", 7, { templateOwner: owner })).toMatchObject({ endpoint: "http://localhost:9000" });
113
+ });
114
+ });
115
+
87
116
  describe("the records", () => {
88
117
  test("an up makes an environment live, a destroying down ends it, an incomplete down leaves it", () => {
89
118
  const records = [up(), up({ pr: 8, env: "pr-8", marker: { stack: "shop", env: "pr-8" } }), { ...up(), kind: "down" as const, result: "destroyed" as const }];