@intentius/chant 0.124.54 → 0.124.55

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (894) hide show
  1. package/dist/__fixtures__/estate-ledger.d.ts +13 -0
  2. package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
  3. package/dist/__fixtures__/estate-ledger.js +67 -0
  4. package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
  5. package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
  6. package/dist/__fixtures__/oidc-emulator.js +26 -2
  7. package/dist/__fixtures__/product-words.d.ts +78 -0
  8. package/dist/__fixtures__/product-words.d.ts.map +1 -0
  9. package/dist/__fixtures__/product-words.js +43 -0
  10. package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  11. package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  12. package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  13. package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  14. package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  15. package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  16. package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
  17. package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
  18. package/dist/__golden__/wave-loop/op-held-on.json +28 -7
  19. package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  20. package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  21. package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  22. package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
  23. package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  24. package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
  25. package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
  26. package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
  27. package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  28. package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  29. package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
  30. package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  31. package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  32. package/dist/__golden__/wave-loop/op-overridden.json +28 -7
  33. package/dist/__golden__/wave-loop/op-per-run.json +20 -4
  34. package/dist/__golden__/wave-loop/op-point.json +18 -4
  35. package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
  36. package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
  37. package/dist/__golden__/wave-loop/op-spend.json +10 -2
  38. package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
  39. package/dist/__golden__/wave-loop/op-wide.json +20 -4
  40. package/dist/bucket-check/azure.d.ts +108 -0
  41. package/dist/bucket-check/azure.d.ts.map +1 -0
  42. package/dist/bucket-check/azure.js +258 -0
  43. package/dist/bucket-check/fixtures/azure.json +153 -0
  44. package/dist/bucket-check/fixtures/gcs.json +148 -0
  45. package/dist/bucket-check/fixtures/s3.json +277 -0
  46. package/dist/bucket-check/gcs.d.ts +77 -0
  47. package/dist/bucket-check/gcs.d.ts.map +1 -0
  48. package/dist/bucket-check/gcs.js +202 -0
  49. package/dist/bucket-check/index.d.ts +48 -0
  50. package/dist/bucket-check/index.d.ts.map +1 -0
  51. package/dist/bucket-check/index.js +44 -0
  52. package/dist/bucket-check/s3.d.ts +116 -0
  53. package/dist/bucket-check/s3.d.ts.map +1 -0
  54. package/dist/bucket-check/s3.js +362 -0
  55. package/dist/bucket-check/types.d.ts +66 -0
  56. package/dist/bucket-check/types.d.ts.map +1 -0
  57. package/dist/bucket-check/types.js +31 -0
  58. package/dist/bucket-check/wire.d.ts +27 -0
  59. package/dist/bucket-check/wire.d.ts.map +1 -0
  60. package/dist/bucket-check/wire.js +32 -0
  61. package/dist/bucket-check.d.ts +6 -0
  62. package/dist/bucket-check.d.ts.map +1 -0
  63. package/dist/bucket-check.js +5 -0
  64. package/dist/capabilities/templates.d.ts.map +1 -1
  65. package/dist/capabilities/templates.js +1 -2
  66. package/dist/change-set.d.ts.map +1 -1
  67. package/dist/change-set.js +2 -3
  68. package/dist/ci-agent.d.ts +381 -0
  69. package/dist/ci-agent.d.ts.map +1 -0
  70. package/dist/ci-agent.js +833 -0
  71. package/dist/ci-control.d.ts +42 -0
  72. package/dist/ci-control.d.ts.map +1 -0
  73. package/dist/ci-control.js +42 -0
  74. package/dist/ci-estate/delivery.d.ts +137 -0
  75. package/dist/ci-estate/delivery.d.ts.map +1 -0
  76. package/dist/ci-estate/delivery.js +311 -0
  77. package/dist/ci-estate/overdue.d.ts +34 -0
  78. package/dist/ci-estate/overdue.d.ts.map +1 -0
  79. package/dist/ci-estate/overdue.js +58 -0
  80. package/dist/ci-estate/page.d.ts +134 -0
  81. package/dist/ci-estate/page.d.ts.map +1 -0
  82. package/dist/ci-estate/page.js +233 -0
  83. package/dist/ci-estate/rows.d.ts +118 -0
  84. package/dist/ci-estate/rows.d.ts.map +1 -0
  85. package/dist/ci-estate/rows.js +126 -0
  86. package/dist/ci-estate.d.ts +68 -0
  87. package/dist/ci-estate.d.ts.map +1 -0
  88. package/dist/ci-estate.js +83 -0
  89. package/dist/ci-handover.d.ts +29 -5
  90. package/dist/ci-handover.d.ts.map +1 -1
  91. package/dist/ci-handover.js +50 -16
  92. package/dist/ci-identity.d.ts +82 -7
  93. package/dist/ci-identity.d.ts.map +1 -1
  94. package/dist/ci-identity.js +87 -15
  95. package/dist/ci-product-words.d.ts +290 -0
  96. package/dist/ci-product-words.d.ts.map +1 -0
  97. package/dist/ci-product-words.js +373 -0
  98. package/dist/ci-product.d.ts +82 -0
  99. package/dist/ci-product.d.ts.map +1 -0
  100. package/dist/ci-product.js +78 -0
  101. package/dist/cli/commands/audit.d.ts +2 -2
  102. package/dist/cli/commands/audit.d.ts.map +1 -1
  103. package/dist/cli/commands/audit.js +3 -2
  104. package/dist/cli/commands/carve.js +2 -2
  105. package/dist/cli/commands/init.d.ts +2 -0
  106. package/dist/cli/commands/init.d.ts.map +1 -1
  107. package/dist/cli/commands/init.js +1 -1
  108. package/dist/cli/handlers/agent.d.ts +17 -0
  109. package/dist/cli/handlers/agent.d.ts.map +1 -0
  110. package/dist/cli/handlers/agent.js +114 -0
  111. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  112. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  113. package/dist/cli/handlers/approve-confirm.js +142 -0
  114. package/dist/cli/handlers/approve.d.ts.map +1 -1
  115. package/dist/cli/handlers/approve.js +19 -1
  116. package/dist/cli/handlers/build.d.ts.map +1 -1
  117. package/dist/cli/handlers/build.js +43 -1
  118. package/dist/cli/handlers/ci-check.d.ts +3 -0
  119. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  120. package/dist/cli/handlers/ci-check.js +34 -0
  121. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  122. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  123. package/dist/cli/handlers/ci-forge-check.js +89 -0
  124. package/dist/cli/handlers/fan-out.js +4 -0
  125. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  126. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  127. package/dist/cli/handlers/gate-pending.js +44 -0
  128. package/dist/cli/handlers/init.d.ts.map +1 -1
  129. package/dist/cli/handlers/init.js +1 -0
  130. package/dist/cli/handlers/ledger.js +1 -1
  131. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  132. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  133. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  134. package/dist/cli/handlers/lock.d.ts.map +1 -1
  135. package/dist/cli/handlers/lock.js +64 -5
  136. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  137. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  138. package/dist/cli/handlers/notify-relay.js +130 -0
  139. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  140. package/dist/cli/handlers/pr-env.js +42 -11
  141. package/dist/cli/handlers/pr.d.ts +38 -3
  142. package/dist/cli/handlers/pr.d.ts.map +1 -1
  143. package/dist/cli/handlers/pr.js +653 -205
  144. package/dist/cli/handlers/promote.d.ts.map +1 -1
  145. package/dist/cli/handlers/promote.js +21 -2
  146. package/dist/cli/handlers/release.d.ts.map +1 -1
  147. package/dist/cli/handlers/release.js +3 -0
  148. package/dist/cli/handlers/run-wave.d.ts +8 -0
  149. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  150. package/dist/cli/handlers/run-wave.js +71 -1
  151. package/dist/cli/handlers/run.d.ts +6 -1
  152. package/dist/cli/handlers/run.d.ts.map +1 -1
  153. package/dist/cli/handlers/run.js +86 -1
  154. package/dist/cli/handlers/serve.d.ts.map +1 -1
  155. package/dist/cli/handlers/serve.js +10 -1
  156. package/dist/cli/main.d.ts +11 -1
  157. package/dist/cli/main.d.ts.map +1 -1
  158. package/dist/cli/main.js +124 -13
  159. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  160. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  161. package/dist/cli/mcp/ledger-tools.js +122 -0
  162. package/dist/cli/mcp/product-tools.d.ts +78 -0
  163. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  164. package/dist/cli/mcp/product-tools.js +93 -0
  165. package/dist/cli/mcp/read-only.d.ts +34 -0
  166. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  167. package/dist/cli/mcp/read-only.js +61 -0
  168. package/dist/cli/mcp/report-tools.d.ts +48 -0
  169. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  170. package/dist/cli/mcp/report-tools.js +128 -0
  171. package/dist/cli/mcp/server.d.ts +28 -1
  172. package/dist/cli/mcp/server.d.ts.map +1 -1
  173. package/dist/cli/mcp/server.js +86 -15
  174. package/dist/cli/mcp-config.d.ts +9 -2
  175. package/dist/cli/mcp-config.d.ts.map +1 -1
  176. package/dist/cli/mcp-config.js +8 -3
  177. package/dist/cli/parse-args.d.ts.map +1 -1
  178. package/dist/cli/parse-args.js +57 -3
  179. package/dist/cli/registry.d.ts +35 -0
  180. package/dist/cli/registry.d.ts.map +1 -1
  181. package/dist/cloud-lister/sigv4.d.ts +42 -7
  182. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  183. package/dist/cloud-lister/sigv4.js +72 -22
  184. package/dist/components/adoption.d.ts +69 -0
  185. package/dist/components/adoption.d.ts.map +1 -0
  186. package/dist/components/adoption.js +93 -0
  187. package/dist/components/apply-lease.d.ts +19 -0
  188. package/dist/components/apply-lease.d.ts.map +1 -0
  189. package/dist/components/apply-lease.js +41 -0
  190. package/dist/components/capability.d.ts +122 -5
  191. package/dist/components/capability.d.ts.map +1 -1
  192. package/dist/components/capability.js +14 -6
  193. package/dist/components/check-hooks.d.ts +113 -0
  194. package/dist/components/check-hooks.d.ts.map +1 -0
  195. package/dist/components/check-hooks.js +192 -0
  196. package/dist/components/ci-services.d.ts +57 -0
  197. package/dist/components/ci-services.d.ts.map +1 -0
  198. package/dist/components/ci-services.js +61 -0
  199. package/dist/components/cli-support.d.ts +13 -0
  200. package/dist/components/cli-support.d.ts.map +1 -1
  201. package/dist/components/cli-support.js +10 -2
  202. package/dist/components/driver.d.ts +20 -3
  203. package/dist/components/driver.d.ts.map +1 -1
  204. package/dist/components/driver.js +24 -4
  205. package/dist/components/fan-out-run.d.ts +12 -0
  206. package/dist/components/fan-out-run.d.ts.map +1 -1
  207. package/dist/components/fan-out-run.js +56 -16
  208. package/dist/components/groups.d.ts.map +1 -1
  209. package/dist/components/groups.js +19 -2
  210. package/dist/components/pr-env-ledger.d.ts +32 -0
  211. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  212. package/dist/components/pr-env-ledger.js +39 -0
  213. package/dist/components/pr-env-ports.d.ts +12 -0
  214. package/dist/components/pr-env-ports.d.ts.map +1 -1
  215. package/dist/components/pr-env-ports.js +13 -3
  216. package/dist/components/pr-env-run.d.ts +6 -0
  217. package/dist/components/pr-env-run.d.ts.map +1 -1
  218. package/dist/components/pr-env-run.js +3 -2
  219. package/dist/components/pr-environment.d.ts +31 -3
  220. package/dist/components/pr-environment.d.ts.map +1 -1
  221. package/dist/components/pr-environment.js +25 -7
  222. package/dist/components/pr-pipeline.d.ts +169 -3
  223. package/dist/components/pr-pipeline.d.ts.map +1 -1
  224. package/dist/components/pr-pipeline.js +184 -9
  225. package/dist/components/pr-policy.d.ts +26 -2
  226. package/dist/components/pr-policy.d.ts.map +1 -1
  227. package/dist/components/pr-policy.js +41 -7
  228. package/dist/components/pr-run.d.ts +63 -0
  229. package/dist/components/pr-run.d.ts.map +1 -1
  230. package/dist/components/pr-run.js +82 -3
  231. package/dist/components/pr-targets.d.ts +24 -0
  232. package/dist/components/pr-targets.d.ts.map +1 -0
  233. package/dist/components/pr-targets.js +48 -0
  234. package/dist/components/product-pipeline.d.ts +217 -0
  235. package/dist/components/product-pipeline.d.ts.map +1 -0
  236. package/dist/components/product-pipeline.js +193 -0
  237. package/dist/components/promote.d.ts +6 -0
  238. package/dist/components/promote.d.ts.map +1 -1
  239. package/dist/components/promote.js +4 -1
  240. package/dist/components/release-compile.d.ts +22 -1
  241. package/dist/components/release-compile.d.ts.map +1 -1
  242. package/dist/components/release-compile.js +85 -0
  243. package/dist/components/release-promote.d.ts +15 -1
  244. package/dist/components/release-promote.d.ts.map +1 -1
  245. package/dist/components/release-promote.js +67 -2
  246. package/dist/components/repo-lock.d.ts +27 -0
  247. package/dist/components/repo-lock.d.ts.map +1 -0
  248. package/dist/components/repo-lock.js +49 -0
  249. package/dist/components/row-lease.d.ts +84 -0
  250. package/dist/components/row-lease.d.ts.map +1 -0
  251. package/dist/components/row-lease.js +110 -0
  252. package/dist/components/wave-plan.d.ts +34 -0
  253. package/dist/components/wave-plan.d.ts.map +1 -1
  254. package/dist/components/wave-plan.js +54 -2
  255. package/dist/control/applied.d.ts +89 -0
  256. package/dist/control/applied.d.ts.map +1 -0
  257. package/dist/control/applied.js +175 -0
  258. package/dist/control/consumers.d.ts +78 -0
  259. package/dist/control/consumers.d.ts.map +1 -0
  260. package/dist/control/consumers.js +172 -0
  261. package/dist/control/dispatch.d.ts +334 -0
  262. package/dist/control/dispatch.d.ts.map +1 -0
  263. package/dist/control/dispatch.js +519 -0
  264. package/dist/control/edges.d.ts +75 -0
  265. package/dist/control/edges.d.ts.map +1 -0
  266. package/dist/control/edges.js +133 -0
  267. package/dist/control/reconcile.d.ts +120 -0
  268. package/dist/control/reconcile.d.ts.map +1 -0
  269. package/dist/control/reconcile.js +178 -0
  270. package/dist/control/records.d.ts +187 -0
  271. package/dist/control/records.d.ts.map +1 -0
  272. package/dist/control/records.js +307 -0
  273. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  274. package/dist/discovery/sandbox/bundle.js +25 -1
  275. package/dist/engine-facts.d.ts.map +1 -1
  276. package/dist/engine-facts.js +1 -2
  277. package/dist/exit-codes.d.ts +48 -0
  278. package/dist/exit-codes.d.ts.map +1 -0
  279. package/dist/exit-codes.js +49 -0
  280. package/dist/forge-check/check.d.ts +63 -0
  281. package/dist/forge-check/check.d.ts.map +1 -0
  282. package/dist/forge-check/check.js +139 -0
  283. package/dist/forge-check/contract.d.ts +152 -0
  284. package/dist/forge-check/contract.d.ts.map +1 -0
  285. package/dist/forge-check/contract.js +118 -0
  286. package/dist/forge-check/forge.d.ts +42 -0
  287. package/dist/forge-check/forge.d.ts.map +1 -0
  288. package/dist/forge-check/forge.js +338 -0
  289. package/dist/forge-check/index.d.ts +24 -0
  290. package/dist/forge-check/index.d.ts.map +1 -0
  291. package/dist/forge-check/index.js +23 -0
  292. package/dist/forge-check/pulumi.d.ts +44 -0
  293. package/dist/forge-check/pulumi.d.ts.map +1 -0
  294. package/dist/forge-check/pulumi.js +184 -0
  295. package/dist/forge-check/read-only.d.ts +26 -0
  296. package/dist/forge-check/read-only.d.ts.map +1 -0
  297. package/dist/forge-check/read-only.js +53 -0
  298. package/dist/forge-check/trust.d.ts +94 -0
  299. package/dist/forge-check/trust.d.ts.map +1 -0
  300. package/dist/forge-check/trust.js +532 -0
  301. package/dist/forge-check/types.d.ts +80 -0
  302. package/dist/forge-check/types.d.ts.map +1 -0
  303. package/dist/forge-check/types.js +18 -0
  304. package/dist/forge-check.d.ts +6 -0
  305. package/dist/forge-check.d.ts.map +1 -0
  306. package/dist/forge-check.js +5 -0
  307. package/dist/gate-decision.d.ts +1 -0
  308. package/dist/gate-decision.d.ts.map +1 -1
  309. package/dist/gate-decision.js +2 -0
  310. package/dist/gate-policy.d.ts +47 -1
  311. package/dist/gate-policy.d.ts.map +1 -1
  312. package/dist/gate-policy.js +50 -2
  313. package/dist/index.d.ts +1 -0
  314. package/dist/index.d.ts.map +1 -1
  315. package/dist/index.js +2 -0
  316. package/dist/lexicon.d.ts +106 -6
  317. package/dist/lexicon.d.ts.map +1 -1
  318. package/dist/lifecycle/adoption-file.d.ts +24 -0
  319. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  320. package/dist/lifecycle/adoption-file.js +1 -2
  321. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  322. package/dist/lifecycle/cloud-index.js +1 -2
  323. package/dist/lifecycle/gate-applied.d.ts +6 -0
  324. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  325. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  326. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  327. package/dist/lifecycle/gate-ledger.js +11 -1
  328. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  329. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  330. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  331. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  332. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  333. package/dist/lifecycle/gated-request-digest.js +35 -0
  334. package/dist/lifecycle/gated-request.d.ts +126 -0
  335. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  336. package/dist/lifecycle/gated-request.js +205 -0
  337. package/dist/lifecycle/identity-match.d.ts +15 -0
  338. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  339. package/dist/lifecycle/identity-match.js +11 -6
  340. package/dist/lifecycle/index-diff.d.ts +40 -0
  341. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  342. package/dist/lifecycle/index-diff.js +1 -2
  343. package/dist/lifecycle/index-document.d.ts.map +1 -1
  344. package/dist/lifecycle/index-document.js +1 -2
  345. package/dist/lifecycle/index-import.d.ts +4 -1
  346. package/dist/lifecycle/index-import.d.ts.map +1 -1
  347. package/dist/lifecycle/index-import.js +29 -32
  348. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  349. package/dist/lifecycle/ledger-read.js +7 -3
  350. package/dist/lifecycle/lock-rows.d.ts +76 -0
  351. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  352. package/dist/lifecycle/lock-rows.js +140 -0
  353. package/dist/lifecycle/query.d.ts +50 -3
  354. package/dist/lifecycle/query.d.ts.map +1 -1
  355. package/dist/lifecycle/query.js +97 -6
  356. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  357. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  358. package/dist/lifecycle/release-catalog-site.js +232 -0
  359. package/dist/lifecycle/release-catalog.d.ts +201 -0
  360. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  361. package/dist/lifecycle/release-catalog.js +198 -0
  362. package/dist/lifecycle/release-changelog.d.ts +41 -0
  363. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  364. package/dist/lifecycle/release-changelog.js +38 -0
  365. package/dist/lifecycle/release-cut.d.ts +1 -0
  366. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  367. package/dist/lifecycle/release-cut.js +1 -1
  368. package/dist/lifecycle/release-ledger.d.ts +16 -0
  369. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  370. package/dist/lifecycle/release-ledger.js +10 -0
  371. package/dist/lifecycle/release-publish.d.ts +43 -22
  372. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  373. package/dist/lifecycle/release-read.d.ts.map +1 -1
  374. package/dist/lifecycle/release-read.js +3 -0
  375. package/dist/lifecycle/release-status.d.ts +86 -0
  376. package/dist/lifecycle/release-status.d.ts.map +1 -0
  377. package/dist/lifecycle/release-status.js +136 -0
  378. package/dist/lifecycle/resource-lock.d.ts +120 -0
  379. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  380. package/dist/lifecycle/resource-lock.js +317 -0
  381. package/dist/lifecycle/retention.d.ts.map +1 -1
  382. package/dist/lifecycle/retention.js +3 -0
  383. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  384. package/dist/lifecycle/run-ledger.js +9 -1
  385. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  386. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  387. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  388. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  389. package/dist/lifecycle/snapshot-store.js +1 -2
  390. package/dist/lifecycle/target-lock.d.ts +15 -0
  391. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  392. package/dist/lifecycle/target-lock.js +25 -10
  393. package/dist/mcp/types.d.ts +7 -0
  394. package/dist/mcp/types.d.ts.map +1 -1
  395. package/dist/notify-product.d.ts +43 -0
  396. package/dist/notify-product.d.ts.map +1 -0
  397. package/dist/notify-product.js +58 -0
  398. package/dist/notify-relay.d.ts +197 -0
  399. package/dist/notify-relay.d.ts.map +1 -0
  400. package/dist/notify-relay.js +321 -0
  401. package/dist/notify.d.ts +44 -4
  402. package/dist/notify.d.ts.map +1 -1
  403. package/dist/notify.js +77 -14
  404. package/dist/object-store/azure-blob.d.ts +129 -0
  405. package/dist/object-store/azure-blob.d.ts.map +1 -0
  406. package/dist/object-store/azure-blob.js +341 -0
  407. package/dist/object-store/common.d.ts +108 -0
  408. package/dist/object-store/common.d.ts.map +1 -0
  409. package/dist/object-store/common.js +80 -0
  410. package/dist/object-store/errors.d.ts +28 -0
  411. package/dist/object-store/errors.d.ts.map +1 -0
  412. package/dist/object-store/errors.js +21 -0
  413. package/dist/object-store/from-env.d.ts +18 -0
  414. package/dist/object-store/from-env.d.ts.map +1 -0
  415. package/dist/object-store/from-env.js +22 -0
  416. package/dist/object-store/gcs.d.ts +106 -0
  417. package/dist/object-store/gcs.d.ts.map +1 -0
  418. package/dist/object-store/gcs.js +393 -0
  419. package/dist/object-store/index.d.ts +9 -0
  420. package/dist/object-store/index.d.ts.map +1 -0
  421. package/dist/object-store/index.js +8 -0
  422. package/dist/object-store/s3.d.ts +146 -0
  423. package/dist/object-store/s3.d.ts.map +1 -0
  424. package/dist/object-store/s3.js +306 -0
  425. package/dist/op/activities/converge.d.ts.map +1 -1
  426. package/dist/op/activities/converge.js +2 -1
  427. package/dist/op/activities/index.d.ts +1 -1
  428. package/dist/op/activities/index.d.ts.map +1 -1
  429. package/dist/op/activities/index.js +1 -1
  430. package/dist/op/activities/review-agent.d.ts +55 -2
  431. package/dist/op/activities/review-agent.d.ts.map +1 -1
  432. package/dist/op/activities/review-agent.js +65 -5
  433. package/dist/op/gate.d.ts +29 -1
  434. package/dist/op/gate.d.ts.map +1 -1
  435. package/dist/op/gate.js +59 -23
  436. package/dist/op/generate-pipeline.d.ts.map +1 -1
  437. package/dist/op/generate-pipeline.js +7 -1
  438. package/dist/op/index.d.ts +12 -1
  439. package/dist/op/index.d.ts.map +1 -1
  440. package/dist/op/index.js +7 -1
  441. package/dist/op/op-waves-after-plan.d.ts +137 -0
  442. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  443. package/dist/op/op-waves-after-plan.js +163 -0
  444. package/dist/op/op-waves-capability-spec.d.ts +55 -0
  445. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  446. package/dist/op/op-waves-capability-spec.js +94 -0
  447. package/dist/op/op-waves-capability.d.ts +197 -0
  448. package/dist/op/op-waves-capability.d.ts.map +1 -0
  449. package/dist/op/op-waves-capability.js +311 -0
  450. package/dist/op/op-waves-events.d.ts +54 -0
  451. package/dist/op/op-waves-events.d.ts.map +1 -0
  452. package/dist/op/op-waves-events.js +122 -0
  453. package/dist/op/op-waves-notify.d.ts +7 -1
  454. package/dist/op/op-waves-notify.d.ts.map +1 -1
  455. package/dist/op/op-waves-notify.js +35 -16
  456. package/dist/op/op-waves-release-port.d.ts +18 -0
  457. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  458. package/dist/op/op-waves-release-port.js +61 -0
  459. package/dist/op/op-waves-release.d.ts +92 -0
  460. package/dist/op/op-waves-release.d.ts.map +1 -0
  461. package/dist/op/op-waves-release.js +97 -0
  462. package/dist/op/op-waves-run.d.ts +175 -4
  463. package/dist/op/op-waves-run.d.ts.map +1 -1
  464. package/dist/op/op-waves-run.js +981 -41
  465. package/dist/op/op-waves-stand-down.d.ts +60 -0
  466. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  467. package/dist/op/op-waves-stand-down.js +97 -0
  468. package/dist/op/op-waves.d.ts +152 -8
  469. package/dist/op/op-waves.d.ts.map +1 -1
  470. package/dist/op/op-waves.js +161 -17
  471. package/dist/op/runtime.d.ts +91 -0
  472. package/dist/op/runtime.d.ts.map +1 -1
  473. package/dist/op/runtime.js +19 -0
  474. package/dist/op/stage-hooks.d.ts +45 -7
  475. package/dist/op/stage-hooks.d.ts.map +1 -1
  476. package/dist/op/stage-hooks.js +61 -3
  477. package/dist/op/steward-beside.d.ts.map +1 -1
  478. package/dist/op/steward-beside.js +2 -1
  479. package/dist/op/types.d.ts +2 -2
  480. package/dist/op/types.d.ts.map +1 -1
  481. package/dist/op/types.js +3 -2
  482. package/dist/otlp-metrics.d.ts +38 -0
  483. package/dist/otlp-metrics.d.ts.map +1 -0
  484. package/dist/otlp-metrics.js +82 -0
  485. package/dist/otlp.d.ts +249 -0
  486. package/dist/otlp.d.ts.map +1 -0
  487. package/dist/otlp.js +426 -0
  488. package/dist/override-gate.d.ts.map +1 -1
  489. package/dist/override-gate.js +5 -0
  490. package/dist/policy-packs.d.ts +69 -0
  491. package/dist/policy-packs.d.ts.map +1 -0
  492. package/dist/policy-packs.js +205 -0
  493. package/dist/policy-source.d.ts +51 -0
  494. package/dist/policy-source.d.ts.map +1 -0
  495. package/dist/policy-source.js +103 -0
  496. package/dist/pr-forge.d.ts +40 -0
  497. package/dist/pr-forge.d.ts.map +1 -1
  498. package/dist/pr-forge.js +92 -0
  499. package/dist/pr-loop.d.ts +149 -11
  500. package/dist/pr-loop.d.ts.map +1 -1
  501. package/dist/pr-loop.js +283 -44
  502. package/dist/pr-post.d.ts +16 -0
  503. package/dist/pr-post.d.ts.map +1 -1
  504. package/dist/pr-post.js +26 -1
  505. package/dist/pr-report-url.d.ts +32 -4
  506. package/dist/pr-report-url.d.ts.map +1 -1
  507. package/dist/pr-report-url.js +46 -5
  508. package/dist/pr-requires.d.ts +13 -2
  509. package/dist/pr-requires.d.ts.map +1 -1
  510. package/dist/pr-requires.js +14 -0
  511. package/dist/release-floors.d.ts +1 -1
  512. package/dist/release-floors.js +1 -1
  513. package/dist/run-event.d.ts +26 -1
  514. package/dist/run-event.d.ts.map +1 -1
  515. package/dist/run-event.js +4 -1
  516. package/dist/sorted-json.d.ts +10 -0
  517. package/dist/sorted-json.d.ts.map +1 -0
  518. package/dist/sorted-json.js +14 -0
  519. package/dist/terraform/credentials.d.ts +59 -0
  520. package/dist/terraform/credentials.d.ts.map +1 -0
  521. package/dist/terraform/credentials.js +149 -0
  522. package/dist/utils.d.ts +1 -4
  523. package/dist/utils.d.ts.map +1 -1
  524. package/dist/utils.js +1 -9
  525. package/dist/wave-runtime.d.ts +1 -1
  526. package/dist/wave-runtime.js +2 -2
  527. package/dist/wave-runtime.mjs +390 -285
  528. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  529. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  530. package/dist/workspace/ci-lock-grain.d.ts +12 -0
  531. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  532. package/dist/workspace/ci-lock-grain.js +27 -0
  533. package/dist/workspace/ci-run.d.ts +2 -1
  534. package/dist/workspace/ci-run.d.ts.map +1 -1
  535. package/dist/workspace/ci-run.js +6 -3
  536. package/dist/workspace/declaration.d.ts +16 -4
  537. package/dist/workspace/declaration.d.ts.map +1 -1
  538. package/dist/workspace/declaration.js +5 -2
  539. package/dist/workspace/declaration.schema.json +27 -3
  540. package/dist/workspace/drift-cli.d.ts.map +1 -1
  541. package/dist/workspace/drift-cli.js +8 -3
  542. package/dist/workspace/exit-cli.d.ts +1 -1
  543. package/dist/workspace/exit-cli.d.ts.map +1 -1
  544. package/dist/workspace/exit-cli.js +2 -1
  545. package/dist/workspace/import-fetch.d.ts +4 -2
  546. package/dist/workspace/import-fetch.d.ts.map +1 -1
  547. package/dist/workspace/import-fetch.js +4 -2
  548. package/dist/workspace/import-init.d.ts.map +1 -1
  549. package/dist/workspace/import-init.js +4 -2
  550. package/dist/workspace/ledger.schema.json +7 -3
  551. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  552. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  553. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  554. package/dist/workspace/pr-report.schema.json +74 -3
  555. package/dist/workspace/promote.d.ts +1 -1
  556. package/dist/workspace/promote.d.ts.map +1 -1
  557. package/dist/workspace/promote.js +2 -1
  558. package/dist/workspace/records-cli.d.ts +2 -2
  559. package/dist/workspace/records-cli.d.ts.map +1 -1
  560. package/dist/workspace/records-cli.js +3 -2
  561. package/dist/workspace/release-catalog.schema.json +277 -0
  562. package/dist/workspace/run-event.schema.json +18 -1
  563. package/dist/workspace/work-cli.d.ts +3 -1
  564. package/dist/workspace/work-cli.d.ts.map +1 -1
  565. package/dist/workspace/work-cli.js +7 -2
  566. package/dist/workspace/workspace-run.d.ts.map +1 -1
  567. package/dist/workspace/workspace-run.js +2 -1
  568. package/package.json +21 -1
  569. package/src/__fixtures__/estate-ledger.ts +101 -0
  570. package/src/__fixtures__/oidc-emulator.ts +31 -2
  571. package/src/__fixtures__/product-words.ts +44 -0
  572. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  573. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  574. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  575. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  576. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  577. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  578. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  579. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  580. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  581. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  582. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  583. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  584. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  585. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  586. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  587. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  588. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  589. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  590. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  591. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  592. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  593. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  594. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  595. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  596. package/src/__golden__/wave-loop/op-point.json +18 -4
  597. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  598. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  599. package/src/__golden__/wave-loop/op-spend.json +10 -2
  600. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  601. package/src/__golden__/wave-loop/op-wide.json +20 -4
  602. package/src/bucket-check/azure.ts +307 -0
  603. package/src/bucket-check/bucket-check.test.ts +210 -0
  604. package/src/bucket-check/fixtures/azure.json +153 -0
  605. package/src/bucket-check/fixtures/gcs.json +148 -0
  606. package/src/bucket-check/fixtures/s3.json +277 -0
  607. package/src/bucket-check/gcs.ts +257 -0
  608. package/src/bucket-check/index.ts +61 -0
  609. package/src/bucket-check/s3.ts +433 -0
  610. package/src/bucket-check/types.ts +75 -0
  611. package/src/bucket-check/wire.ts +50 -0
  612. package/src/bucket-check.ts +5 -0
  613. package/src/capabilities/templates.test.ts +2 -3
  614. package/src/capabilities/templates.ts +1 -2
  615. package/src/cdk/advise.test.ts +1 -1
  616. package/src/change-set-bundle.test.ts +0 -1
  617. package/src/change-set.ts +2 -3
  618. package/src/ci-agent.test.ts +348 -0
  619. package/src/ci-agent.ts +1026 -0
  620. package/src/ci-control.ts +174 -0
  621. package/src/ci-estate/delivery.ts +433 -0
  622. package/src/ci-estate/overdue.ts +81 -0
  623. package/src/ci-estate/page.ts +343 -0
  624. package/src/ci-estate/rows.ts +251 -0
  625. package/src/ci-estate.test.ts +281 -0
  626. package/src/ci-estate.ts +176 -0
  627. package/src/ci-handover.ts +67 -16
  628. package/src/ci-identity-database.test.ts +55 -0
  629. package/src/ci-identity-pulumi.test.ts +163 -0
  630. package/src/ci-identity-targets.test.ts +6 -2
  631. package/src/ci-identity.ts +124 -22
  632. package/src/ci-product-words.test.ts +101 -0
  633. package/src/ci-product-words.ts +536 -0
  634. package/src/ci-product.ts +174 -0
  635. package/src/ci-shared-reads.test.ts +145 -0
  636. package/src/cli/commands/audit.test.ts +1 -1
  637. package/src/cli/commands/audit.ts +3 -2
  638. package/src/cli/commands/carve.test.ts +1 -1
  639. package/src/cli/commands/carve.ts +2 -2
  640. package/src/cli/commands/init.ts +3 -1
  641. package/src/cli/component-wave-args.test.ts +16 -0
  642. package/src/cli/handlers/agent.ts +126 -0
  643. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  644. package/src/cli/handlers/approve-confirm.ts +200 -0
  645. package/src/cli/handlers/approve.ts +18 -1
  646. package/src/cli/handlers/build.test.ts +7 -0
  647. package/src/cli/handlers/build.ts +44 -1
  648. package/src/cli/handlers/ci-check.ts +33 -0
  649. package/src/cli/handlers/ci-forge-check.ts +91 -0
  650. package/src/cli/handlers/fan-out.test.ts +10 -10
  651. package/src/cli/handlers/fan-out.ts +5 -0
  652. package/src/cli/handlers/gate-pending.ts +46 -0
  653. package/src/cli/handlers/init.ts +1 -0
  654. package/src/cli/handlers/ledger.ts +1 -1
  655. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  656. package/src/cli/handlers/lock.test.ts +29 -2
  657. package/src/cli/handlers/lock.ts +66 -6
  658. package/src/cli/handlers/notify-relay.ts +130 -0
  659. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  660. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  661. package/src/cli/handlers/pr-env.ts +48 -11
  662. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  663. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  664. package/src/cli/handlers/pr-waves.test.ts +8 -2
  665. package/src/cli/handlers/pr.test.ts +8 -8
  666. package/src/cli/handlers/pr.ts +655 -205
  667. package/src/cli/handlers/promote.test.ts +5 -5
  668. package/src/cli/handlers/promote.ts +22 -2
  669. package/src/cli/handlers/release.ts +2 -0
  670. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  671. package/src/cli/handlers/run-wave.ts +65 -1
  672. package/src/cli/handlers/run.test.ts +6 -4
  673. package/src/cli/handlers/run.ts +86 -1
  674. package/src/cli/handlers/serve.ts +10 -1
  675. package/src/cli/main.ts +126 -13
  676. package/src/cli/mcp/ledger-tools.ts +126 -0
  677. package/src/cli/mcp/product-tools.test.ts +123 -0
  678. package/src/cli/mcp/product-tools.ts +129 -0
  679. package/src/cli/mcp/read-only.test.ts +134 -0
  680. package/src/cli/mcp/read-only.ts +68 -0
  681. package/src/cli/mcp/report-tools.ts +135 -0
  682. package/src/cli/mcp/server.test.ts +5 -4
  683. package/src/cli/mcp/server.ts +90 -16
  684. package/src/cli/mcp-config.ts +8 -3
  685. package/src/cli/parse-args.ts +42 -2
  686. package/src/cli/registry.ts +35 -0
  687. package/src/cloud-lister/sigv4.ts +80 -23
  688. package/src/components/adoption.test.ts +140 -0
  689. package/src/components/adoption.ts +141 -0
  690. package/src/components/apply-lease.ts +49 -0
  691. package/src/components/capability.ts +130 -6
  692. package/src/components/check-hooks.test.ts +66 -0
  693. package/src/components/check-hooks.ts +252 -0
  694. package/src/components/ci-services.test.ts +51 -0
  695. package/src/components/ci-services.ts +83 -0
  696. package/src/components/cli-support.ts +23 -2
  697. package/src/components/driver.test.ts +3 -3
  698. package/src/components/driver.ts +38 -5
  699. package/src/components/fan-out-run.ts +68 -18
  700. package/src/components/groups.ts +17 -2
  701. package/src/components/pr-comment-preview.test.ts +54 -0
  702. package/src/components/pr-env-ledger.test.ts +9 -0
  703. package/src/components/pr-env-ledger.ts +43 -0
  704. package/src/components/pr-env-ports.ts +29 -4
  705. package/src/components/pr-env-run-bundle.test.ts +8 -0
  706. package/src/components/pr-env-run.test.ts +19 -0
  707. package/src/components/pr-env-run.ts +12 -2
  708. package/src/components/pr-environment.test.ts +29 -0
  709. package/src/components/pr-environment.ts +39 -7
  710. package/src/components/pr-pipeline.test.ts +15 -0
  711. package/src/components/pr-pipeline.ts +274 -9
  712. package/src/components/pr-policy.ts +45 -7
  713. package/src/components/pr-run.test.ts +1 -1
  714. package/src/components/pr-run.ts +121 -5
  715. package/src/components/pr-targets.test.ts +35 -0
  716. package/src/components/pr-targets.ts +45 -0
  717. package/src/components/product-pipeline.test.ts +200 -0
  718. package/src/components/product-pipeline.ts +341 -0
  719. package/src/components/promote.ts +10 -1
  720. package/src/components/release-compile.ts +87 -1
  721. package/src/components/release-promote.ts +65 -1
  722. package/src/components/repo-lock.ts +52 -0
  723. package/src/components/row-lease.test.ts +490 -0
  724. package/src/components/row-lease.ts +167 -0
  725. package/src/components/wave-plan-policy.test.ts +19 -0
  726. package/src/components/wave-plan.ts +78 -4
  727. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  728. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  729. package/src/control/applied.test.ts +148 -0
  730. package/src/control/applied.ts +191 -0
  731. package/src/control/consumers.test.ts +129 -0
  732. package/src/control/consumers.ts +192 -0
  733. package/src/control/control.test.ts +302 -0
  734. package/src/control/dispatch.ts +699 -0
  735. package/src/control/edges.test.ts +112 -0
  736. package/src/control/edges.ts +164 -0
  737. package/src/control/note-checkout.test.ts +91 -0
  738. package/src/control/reconcile.ts +250 -0
  739. package/src/control/records.ts +395 -0
  740. package/src/discovery/sandbox/bundle.ts +25 -1
  741. package/src/engine-facts.test.ts +2 -3
  742. package/src/engine-facts.ts +1 -2
  743. package/src/exit-codes.test.ts +31 -0
  744. package/src/exit-codes.ts +55 -0
  745. package/src/forge-check/check.ts +155 -0
  746. package/src/forge-check/contract.ts +215 -0
  747. package/src/forge-check/forge-check.test.ts +427 -0
  748. package/src/forge-check/forge.ts +318 -0
  749. package/src/forge-check/index.ts +43 -0
  750. package/src/forge-check/pulumi.ts +192 -0
  751. package/src/forge-check/read-only.ts +56 -0
  752. package/src/forge-check/trust.ts +527 -0
  753. package/src/forge-check/types.ts +78 -0
  754. package/src/forge-check.ts +5 -0
  755. package/src/gate-decision-bundle.test.ts +13 -0
  756. package/src/gate-decision.ts +3 -0
  757. package/src/gate-policy.ts +92 -3
  758. package/src/gated-waves-bundle.test.ts +0 -1
  759. package/src/index.ts +2 -0
  760. package/src/lexicon.ts +95 -6
  761. package/src/lifecycle/adoption-file.ts +1 -2
  762. package/src/lifecycle/cloud-index.test.ts +2 -3
  763. package/src/lifecycle/cloud-index.ts +1 -2
  764. package/src/lifecycle/control-entries-ledger.test.ts +70 -0
  765. package/src/lifecycle/gate-applied.ts +6 -0
  766. package/src/lifecycle/gate-ledger.ts +36 -1
  767. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  768. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  769. package/src/lifecycle/gated-request-digest.ts +49 -0
  770. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  771. package/src/lifecycle/gated-request.ts +280 -0
  772. package/src/lifecycle/identity-match.ts +25 -6
  773. package/src/lifecycle/index-diff.ts +1 -2
  774. package/src/lifecycle/index-document.ts +1 -2
  775. package/src/lifecycle/index-import.test.ts +14 -0
  776. package/src/lifecycle/index-import.ts +54 -34
  777. package/src/lifecycle/ledger-read.ts +7 -3
  778. package/src/lifecycle/lock-rows.test.ts +109 -0
  779. package/src/lifecycle/lock-rows.ts +167 -0
  780. package/src/lifecycle/publish-target-context.test.ts +108 -0
  781. package/src/lifecycle/query.test.ts +2 -3
  782. package/src/lifecycle/query.ts +109 -7
  783. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  784. package/src/lifecycle/release-catalog-site.ts +291 -0
  785. package/src/lifecycle/release-catalog.test.ts +193 -0
  786. package/src/lifecycle/release-catalog.ts +353 -0
  787. package/src/lifecycle/release-changelog.test.ts +70 -0
  788. package/src/lifecycle/release-changelog.ts +71 -0
  789. package/src/lifecycle/release-cut.ts +2 -2
  790. package/src/lifecycle/release-ledger.ts +20 -0
  791. package/src/lifecycle/release-publish.ts +45 -22
  792. package/src/lifecycle/release-read.ts +2 -0
  793. package/src/lifecycle/release-status.test.ts +186 -0
  794. package/src/lifecycle/release-status.ts +176 -0
  795. package/src/lifecycle/resource-lock.test.ts +175 -0
  796. package/src/lifecycle/resource-lock.ts +354 -0
  797. package/src/lifecycle/retention.ts +2 -0
  798. package/src/lifecycle/run-ledger.ts +7 -1
  799. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  800. package/src/lifecycle/snapshot-store.ts +1 -2
  801. package/src/lifecycle/target-lock.ts +24 -9
  802. package/src/mcp/types.ts +7 -0
  803. package/src/notify-product.ts +76 -0
  804. package/src/notify-relay.test.ts +213 -0
  805. package/src/notify-relay.ts +407 -0
  806. package/src/notify.ts +95 -14
  807. package/src/object-store/azure-blob.ts +374 -0
  808. package/src/object-store/common.ts +133 -0
  809. package/src/object-store/errors.ts +26 -0
  810. package/src/object-store/from-env.ts +36 -0
  811. package/src/object-store/gcs.ts +436 -0
  812. package/src/object-store/index.ts +8 -0
  813. package/src/object-store/object-store.test.ts +130 -0
  814. package/src/object-store/s3.ts +350 -0
  815. package/src/op/activities/converge.ts +2 -1
  816. package/src/op/activities/index.ts +1 -1
  817. package/src/op/activities/review-agent.open.test.ts +78 -0
  818. package/src/op/activities/review-agent.test.ts +13 -0
  819. package/src/op/activities/review-agent.ts +89 -5
  820. package/src/op/gate.ts +81 -22
  821. package/src/op/generate-pipeline.ts +7 -1
  822. package/src/op/index.ts +21 -0
  823. package/src/op/op-waves-after-plan.test.ts +276 -0
  824. package/src/op/op-waves-after-plan.ts +238 -0
  825. package/src/op/op-waves-capability-spec.ts +113 -0
  826. package/src/op/op-waves-capability.test.ts +217 -0
  827. package/src/op/op-waves-capability.ts +370 -0
  828. package/src/op/op-waves-events.ts +135 -0
  829. package/src/op/op-waves-notify-words.test.ts +149 -0
  830. package/src/op/op-waves-notify.ts +41 -16
  831. package/src/op/op-waves-pull-request.test.ts +142 -0
  832. package/src/op/op-waves-release-port.ts +64 -0
  833. package/src/op/op-waves-release.test.ts +209 -0
  834. package/src/op/op-waves-release.ts +133 -0
  835. package/src/op/op-waves-run-record.test.ts +32 -0
  836. package/src/op/op-waves-run.ts +1142 -49
  837. package/src/op/op-waves-stand-down.test.ts +240 -0
  838. package/src/op/op-waves-stand-down.ts +108 -0
  839. package/src/op/op-waves-trace.test.ts +205 -0
  840. package/src/op/op-waves.test.ts +112 -0
  841. package/src/op/op-waves.ts +261 -20
  842. package/src/op/runtime.ts +104 -0
  843. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  844. package/src/op/stage-hooks.ts +91 -12
  845. package/src/op/steward-beside.ts +2 -1
  846. package/src/op/types.ts +3 -2
  847. package/src/otlp-metrics.ts +96 -0
  848. package/src/otlp.test.ts +243 -0
  849. package/src/otlp.ts +544 -0
  850. package/src/override-gate-bundle.test.ts +2 -0
  851. package/src/override-gate.ts +4 -0
  852. package/src/policy-packs.ts +230 -0
  853. package/src/policy-source.test.ts +256 -0
  854. package/src/policy-source.ts +112 -0
  855. package/src/pr-forge.ts +123 -0
  856. package/src/pr-loop-bundle.test.ts +6 -2
  857. package/src/pr-loop-words.test.ts +155 -0
  858. package/src/pr-loop.ts +371 -52
  859. package/src/pr-post.ts +32 -1
  860. package/src/pr-report-url.ts +62 -6
  861. package/src/pr-requires.test.ts +37 -1
  862. package/src/pr-requires.ts +16 -2
  863. package/src/product-subpaths-plain-node.e2e.test.ts +211 -0
  864. package/src/release-floors.ts +1 -1
  865. package/src/run-event.ts +29 -1
  866. package/src/sorted-json.ts +17 -0
  867. package/src/stage-hooks-bundle.test.ts +8 -0
  868. package/src/terraform/credentials.test.ts +77 -0
  869. package/src/terraform/credentials.ts +162 -0
  870. package/src/utils.ts +2 -11
  871. package/src/wave-loop-golden.test.ts +2 -1
  872. package/src/wave-runtime.ts +2 -2
  873. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  874. package/src/workspace/ci-lock-grain.test.ts +31 -0
  875. package/src/workspace/ci-lock-grain.ts +30 -0
  876. package/src/workspace/ci-report-url.test.ts +1 -1
  877. package/src/workspace/ci-run.test.ts +1 -1
  878. package/src/workspace/ci-run.ts +6 -3
  879. package/src/workspace/declaration.schema.json +27 -3
  880. package/src/workspace/declaration.test.ts +1 -1
  881. package/src/workspace/declaration.ts +26 -10
  882. package/src/workspace/drift-cli.ts +8 -3
  883. package/src/workspace/exit-cli.ts +2 -1
  884. package/src/workspace/import-fetch.ts +4 -2
  885. package/src/workspace/import-init.ts +4 -2
  886. package/src/workspace/ledger.schema.json +7 -3
  887. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  888. package/src/workspace/pr-report.schema.json +74 -3
  889. package/src/workspace/promote.ts +2 -1
  890. package/src/workspace/records-cli.ts +3 -2
  891. package/src/workspace/release-catalog.schema.json +277 -0
  892. package/src/workspace/run-event.schema.json +18 -1
  893. package/src/workspace/work-cli.ts +8 -2
  894. package/src/workspace/workspace-run.ts +2 -1
@@ -0,0 +1,490 @@
1
+ /**
2
+ * #4594: every apply path takes the row lease on the resource lock grain.
3
+ *
4
+ * The capabilities here are fakes. `fake-res` plans one root, says it is on
5
+ * the resource grain unless told otherwise, and names one row per root,
6
+ * `row <root>`. `fake-group` plans and applies its members as one (ws-107).
7
+ * The lease port is in memory: it records each take and release, and
8
+ * refuses a row named in `held`. The rows file itself, and the count that
9
+ * keeps a row two steps of one run share until both end, run against a
10
+ * local git repository at the end.
11
+ */
12
+ import { execFileSync } from "node:child_process";
13
+ import { mkdtempSync, realpathSync, rmSync, writeFileSync } from "node:fs";
14
+ import { tmpdir } from "node:os";
15
+ import { join } from "node:path";
16
+ import { afterAll, describe, expect, test } from "vitest";
17
+ import { CapabilityRegistry, type CapabilityGroupOutcome, type CapabilityPlan, type DeployContext, type GroupMember, type GroupRun, type PlannedOutputs } from "./capability";
18
+ import { DriverRunFailure, failedRunExitCode, runComponentDeploy, runInterpretDriver, type DriverComponent, type DriverRunResult } from "./driver";
19
+ import { planFanOut } from "./fan-out";
20
+ import { runFanOut } from "./fan-out-run";
21
+ import { componentSetFanOut, groupFanOut, planAndRunComponentGroup, planComponentGroup, runComponentGroup } from "./groups";
22
+ import { applyPrSet, approvalOf, decidePrGate, planPrSet, readOnlyLedger, type PrPlanSet } from "./pr-run";
23
+ import { ledgerRowLease, leaseCapabilityStep, LockRowsHeldError, isLockRowsHeldError, type RowLeasePort } from "./row-lease";
24
+ import { memoryGateLedgerPort } from "../op/gate";
25
+ import { computePlanDigest } from "../lifecycle/plan-digest";
26
+ import { lockGrainBeforePlan, type LockGrain, type LockRow } from "../lifecycle/lock-rows";
27
+ import { readLockRows } from "../lifecycle/resource-lock";
28
+ import type { GateResolutionRecord, PendingGateRecord } from "../lifecycle/gate-ledger";
29
+
30
+ interface RootInput {
31
+ root: string;
32
+ vars?: Record<string, unknown>;
33
+ lockGrain?: LockGrain;
34
+ }
35
+
36
+ const NOW = "2026-10-27T10:00:00Z";
37
+ const LATER = "2026-10-27T11:00:00Z";
38
+
39
+ const step = (kind: string, name: string, vars?: Record<string, unknown>) => ({ kind, root: name, ...(vars ? { vars } : {}) });
40
+ const comp = (kind: string, name: string, dependsOn: string[] = [], vars?: Record<string, unknown>): DriverComponent => ({
41
+ name,
42
+ dependsOn,
43
+ deploy: [{ phase: "Apply", steps: [step(kind, name, vars)] }],
44
+ });
45
+ const res = (name: string, dependsOn: string[] = [], vars?: Record<string, unknown>) => comp("fake-res", name, dependsOn, vars);
46
+ const so = (stack: string, name: string) => ({ stackOutput: { stack, name } });
47
+
48
+ /** An in-memory lease port: each take and release, in order, and the rows another run holds. */
49
+ function memoryPort(held: string[] = []) {
50
+ const log = { takes: [] as Array<{ label: string; keys: string[] }>, releases: [] as string[], live: new Set<string>() };
51
+ const port: RowLeasePort = {
52
+ async take(rows: readonly LockRow[], label: string) {
53
+ const keys = rows.map((r) => r.key).sort();
54
+ const hit = keys.filter((k) => held.includes(k));
55
+ if (hit.length > 0) throw new LockRowsHeldError(`${label}: run 4711 is applying ${hit.join(", ")}, so nothing of it was applied`);
56
+ log.takes.push({ label, keys });
57
+ for (const k of keys) log.live.add(k);
58
+ return {
59
+ async release() {
60
+ log.releases.push(label);
61
+ for (const k of keys) log.live.delete(k);
62
+ return true;
63
+ },
64
+ };
65
+ },
66
+ };
67
+ return { port, log };
68
+ }
69
+
70
+ function world(opts: { grain?: LockGrain; refuse?: boolean } = {}) {
71
+ const w = {
72
+ registry: new CapabilityRegistry(),
73
+ planned: [] as string[],
74
+ applied: [] as string[],
75
+ /** Whether each root applied a plan it was handed, and whether its row was held while it did. */
76
+ fromPlan: {} as Record<string, boolean>,
77
+ heldWhileApplying: {} as Record<string, boolean>,
78
+ versions: {} as Record<string, string>,
79
+ state: {} as Record<string, Record<string, unknown>>,
80
+ predict: {} as Record<string, () => PlannedOutputs | undefined>,
81
+ live: undefined as Set<string> | undefined,
82
+ };
83
+ const planOf = (input: RootInput): CapabilityPlan => {
84
+ w.planned.push(input.root);
85
+ const version = w.versions[input.root] ?? "v1";
86
+ const planDigest = computePlanDigest("fake-res", { root: input.root, version, vars: input.vars ?? null });
87
+ const outputs = w.predict[input.root]?.();
88
+ return {
89
+ member: input.root,
90
+ planDigest,
91
+ artifact: { planDigest },
92
+ ...(outputs ? { outputs } : {}),
93
+ changeSet: {
94
+ member: { member: input.root, lexicon: "terraform", planner: "choudoufu", status: "planned", planDigest, holes: [] },
95
+ entries: [{ member: input.root, lexicon: "terraform", planner: "choudoufu", address: "res.x", type: "res", action: "update", attributes: [{ path: "version", before: "v0", after: version }] }],
96
+ },
97
+ };
98
+ };
99
+ const hooks = {
100
+ defaultLockGrain: () => opts.grain ?? ("resource" as const),
101
+ lockGrainRefusal: (_input: RootInput, grain: LockGrain) => (opts.refuse && grain === "resource" ? "fake-res keeps the target grain" : undefined),
102
+ lockRows: (_input: RootInput, plan: CapabilityPlan): LockRow[] => [{ key: `row ${plan.member}`, target: plan.member, address: "res.x" }],
103
+ };
104
+ const applyOne = (ctx: DeployContext, input: RootInput) => {
105
+ w.fromPlan[input.root] = ctx.plans?.[input.root] !== undefined;
106
+ w.heldWhileApplying[input.root] = w.live?.has(`row ${input.root}`) ?? false;
107
+ w.applied.push(input.root);
108
+ w.state[input.root] = { id: `${input.root}-${w.versions[input.root] ?? "v1"}` };
109
+ return { outputs: { ...w.state[input.root] } };
110
+ };
111
+ w.registry.register({
112
+ kind: "fake-res",
113
+ ...hooks,
114
+ async plan(_ctx: DeployContext, input: RootInput) {
115
+ return planOf(input);
116
+ },
117
+ async outputs(_ctx: DeployContext, input: RootInput) {
118
+ return { ...(w.state[input.root] ?? {}) };
119
+ },
120
+ async run(ctx: DeployContext, input: RootInput) {
121
+ return applyOne(ctx, input);
122
+ },
123
+ } as never);
124
+ w.registry.register({
125
+ kind: "fake-group",
126
+ ...hooks,
127
+ async plan(_ctx: DeployContext, input: RootInput) {
128
+ return planOf(input);
129
+ },
130
+ async run(ctx: DeployContext, input: RootInput) {
131
+ return applyOne(ctx, input);
132
+ },
133
+ async planGroup(_ctx: unknown, members: readonly GroupMember<RootInput>[]) {
134
+ return { digest: computePlanDigest("fake-group", members.map((m) => m.component)), members: Object.fromEntries(members.map((m) => [m.component, planOf(m.input!)])) };
135
+ },
136
+ async runGroup(_ctx: unknown, _run: GroupRun, members: readonly GroupMember<RootInput>[]): Promise<CapabilityGroupOutcome> {
137
+ return { members: Object.fromEntries(members.map((m) => [m.component, { status: "applied" as const, outputs: applyOne(m.ctx, m.input!).outputs }])) };
138
+ },
139
+ } as never);
140
+ return w;
141
+ }
142
+
143
+ async function interpret(components: DriverComponent[], w: ReturnType<typeof world>, options: Partial<Parameters<typeof runInterpretDriver>[2]> = {}): Promise<DriverRunResult> {
144
+ try {
145
+ return await runInterpretDriver(components, w.registry, { env: "prod", gates: memoryGateLedgerPort(), ...options });
146
+ } catch (err) {
147
+ if (err instanceof DriverRunFailure) return err.result;
148
+ throw err;
149
+ }
150
+ }
151
+
152
+ describe("a step on the resource grain leases its rows (run --components, promote)", () => {
153
+ test("plans, takes the rows of that plan, applies the plan it leased for, and lets go", async () => {
154
+ const w = world();
155
+ const { port, log } = memoryPort();
156
+ w.live = log.live;
157
+ const run = await interpret([res("net"), res("dns")], w, { rowLease: port });
158
+ expect(run.status).toBe("ok");
159
+ // One wave: the two steps lease side by side, so their order is not fixed.
160
+ expect([...log.takes].sort((a, b) => a.label.localeCompare(b.label))).toEqual([
161
+ { label: "dns", keys: ["row dns"] },
162
+ { label: "net", keys: ["row net"] },
163
+ ]);
164
+ expect(w.fromPlan).toEqual({ net: true, dns: true });
165
+ expect(w.heldWhileApplying).toEqual({ net: true, dns: true });
166
+ expect([...log.releases].sort()).toEqual(["dns", "net"]);
167
+ expect(log.live.size).toBe(0);
168
+ });
169
+
170
+ test("a row another run holds fails the step before it applies, marked held, and the run exits 5", async () => {
171
+ const w = world();
172
+ const { port } = memoryPort(["row net"]);
173
+ const run = await interpret([res("net"), res("app", ["net"], { upstream: so("net", "id") })], w, { rowLease: port });
174
+ expect(run.status).toBe("fail");
175
+ expect(w.applied).toEqual([]);
176
+ const record = run.results.find((r) => r.component === "net")!.records[0]!;
177
+ expect(record).toMatchObject({ status: "fail", held: true });
178
+ expect(record.error).toContain("run 4711 is applying row net");
179
+ expect(failedRunExitCode(run.results)).toBe(5);
180
+ });
181
+
182
+ test("a declared target grain takes no lease and applies as before, without planning first", async () => {
183
+ const w = world();
184
+ const { port, log } = memoryPort();
185
+ const run = await interpret([res("net")], w, { rowLease: port, lockGrain: "target" });
186
+ expect(run.status).toBe("ok");
187
+ expect(log.takes).toEqual([]);
188
+ expect(w.planned).toEqual([]);
189
+ expect(w.fromPlan).toEqual({ net: false });
190
+ });
191
+
192
+ test("a step's own lockGrain wins over the declared grain", async () => {
193
+ const w = world({ grain: "target" });
194
+ const { port, log } = memoryPort();
195
+ const run = await interpret([{ name: "net", dependsOn: [], deploy: [{ phase: "Apply", steps: [{ kind: "fake-res", root: "net", lockGrain: "resource" }] }] }], w, { rowLease: port, lockGrain: "target" });
196
+ expect(run.status).toBe("ok");
197
+ expect(log.takes).toEqual([{ label: "net", keys: ["row net"] }]);
198
+ });
199
+
200
+ test("a grain the lexicon refuses fails the step with the lexicon's reason, and nothing applies", async () => {
201
+ const w = world({ refuse: true });
202
+ const { port } = memoryPort();
203
+ const run = await interpret([res("net")], w, { rowLease: port, lockGrain: "resource" });
204
+ expect(run.status).toBe("fail");
205
+ expect(run.results[0]!.records[0]!.error).toContain("fake-res keeps the target grain");
206
+ expect(w.applied).toEqual([]);
207
+ expect(failedRunExitCode(run.results)).toBe(1);
208
+ });
209
+
210
+ test("without a lease port nothing changes: no plan, no take", async () => {
211
+ const w = world();
212
+ const run = await interpret([res("net")], w);
213
+ expect(run.status).toBe("ok");
214
+ expect(w.planned).toEqual([]);
215
+ expect(w.fromPlan).toEqual({ net: false });
216
+ });
217
+
218
+ test("a step handed a plan leases nothing itself: its caller leased what it planned", async () => {
219
+ const w = world();
220
+ const { port, log } = memoryPort();
221
+ const ctx: DeployContext = { env: "prod", component: "net", rowLease: port, plans: { net: { planDigest: "x" } } };
222
+ const result = await runComponentDeploy(res("net"), ctx, w.registry, {}, undefined, { port: memoryGateLedgerPort() });
223
+ expect(result.status).toBe("ok");
224
+ expect(log.takes).toEqual([]);
225
+ });
226
+
227
+ test("leaseCapabilityStep and lockGrainBeforePlan read the grain by the same order as a pull request's plan", async () => {
228
+ const w = world({ grain: "target" });
229
+ const cap = w.registry.resolve("fake-res");
230
+ expect(await lockGrainBeforePlan(cap, { root: "net" }, undefined)).toBe("target");
231
+ expect(await lockGrainBeforePlan(cap, { root: "net" }, "resource")).toBe("resource");
232
+ expect(await lockGrainBeforePlan(cap, { root: "net", lockGrain: "repo" }, "resource")).toBe("repo");
233
+ const { port, log } = memoryPort();
234
+ const leased = await leaseCapabilityStep(cap, { env: "prod", component: "net", rowLease: port, lockGrain: "resource" }, { root: "net" });
235
+ expect(leased.ctx.plans).toEqual({ net: { planDigest: expect.any(String) } });
236
+ expect(log.takes).toEqual([{ label: "net", keys: ["row net"] }]);
237
+ await leased.lease.release();
238
+ expect(log.releases).toEqual(["net"]);
239
+ });
240
+
241
+ test("isLockRowsHeldError reads the mark, so a copy from another bundle counts", () => {
242
+ expect(isLockRowsHeldError(new LockRowsHeldError("x"))).toBe(true);
243
+ expect(isLockRowsHeldError({ lockRowsHeld: true })).toBe(true);
244
+ expect(isLockRowsHeldError(new Error("x"))).toBe(false);
245
+ });
246
+ });
247
+
248
+ describe("a group planned as one carries and leases its members' rows (ws-107)", () => {
249
+ const GROUP = { capability: "fake-group", components: ["a", "b"] };
250
+ const MEMBERS = [comp("fake-group", "a"), comp("fake-group", "b", ["a"], { upstream: so("a", "id") })];
251
+ const byName = new Map(MEMBERS.map((c) => [c.name, c]));
252
+
253
+ test("planComponentGroup gives each member its grain and rows, as a component planned alone has them", async () => {
254
+ const w = world();
255
+ const planned = await planComponentGroup({ group: GROUP, components: byName, registry: w.registry, env: "prod", ctxOf: (name) => ({ env: "prod", component: name }), outputs: {} });
256
+ const locks = planned.plans.map((p) => ("error" in p ? p.error : p.locks));
257
+ expect(locks).toEqual([
258
+ { a: { grain: "resource", source: "lexicon", rows: [{ key: "row a", target: "a", address: "res.x" }] } },
259
+ { b: { grain: "resource", source: "lexicon", rows: [{ key: "row b", target: "b", address: "res.x" }] } },
260
+ ]);
261
+ });
262
+
263
+ test("a pull request's plan of a group lists the members' locks, so pr-apply leases them", async () => {
264
+ const w = world();
265
+ const plan = groupFanOut(componentSetFanOut(MEMBERS), MEMBERS, { groups: [GROUP], fallbacks: [] });
266
+ const set = await planPrSet({ components: MEMBERS, plan, registry: w.registry, env: "prod" });
267
+ expect(Object.keys(set.locks ?? {}).sort()).toEqual(["a", "b"]);
268
+ expect(set.locks?.a).toMatchObject({ component: "a", grain: "resource", rows: [{ key: "row a" }] });
269
+ });
270
+
271
+ test("a group that plans in its wave takes every member's rows in one take, then lets go", async () => {
272
+ const w = world();
273
+ const { port, log } = memoryPort();
274
+ w.live = log.live;
275
+ const ran = await planAndRunComponentGroup({ group: GROUP, components: byName, registry: w.registry, env: "prod", ctxOf: (name) => ({ env: "prod", component: name, rowLease: port }), componentOutputs: {} });
276
+ expect(ran.outcomes).toEqual({ a: "applied", b: "applied" });
277
+ expect(log.takes).toEqual([{ label: "the group a, b", keys: ["row a", "row b"] }]);
278
+ expect(w.heldWhileApplying).toEqual({ a: true, b: true });
279
+ expect(log.releases).toEqual(["the group a, b"]);
280
+ });
281
+
282
+ test("a held row leaves every member not started, marked held, and the run exits 5", async () => {
283
+ const w = world();
284
+ const { port } = memoryPort(["row b"]);
285
+ const planned = await planComponentGroup({ group: GROUP, components: byName, registry: w.registry, env: "prod", ctxOf: (name) => ({ env: "prod", component: name }), outputs: {} });
286
+ const ran = await runComponentGroup({ group: GROUP, components: byName, registry: w.registry, env: "prod", ctxOf: (name) => ({ env: "prod", component: name, rowLease: port }), run: planned.run, componentOutputs: {} });
287
+ expect(ran.notStarted).toEqual(["a", "b"]);
288
+ expect(ran.outcomes).toEqual({ a: "not-started", b: "not-started" });
289
+ expect(ran.results.every((r) => r.records[0]!.held === true)).toBe(true);
290
+ expect(w.applied).toEqual([]);
291
+ expect(failedRunExitCode(ran.results)).toBe(5);
292
+ });
293
+
294
+ test("a group applied without a lease port takes none, as a pull request's apply runs it", async () => {
295
+ const w = world();
296
+ const planned = await planComponentGroup({ group: GROUP, components: byName, registry: w.registry, env: "prod", ctxOf: (name) => ({ env: "prod", component: name }), outputs: {} });
297
+ const ran = await runComponentGroup({ group: GROUP, components: byName, registry: w.registry, env: "prod", ctxOf: (name) => ({ env: "prod", component: name }), run: planned.run, componentOutputs: {} });
298
+ expect(ran.outcomes).toEqual({ a: "applied", b: "applied" });
299
+ });
300
+ });
301
+
302
+ describe("components fan-out leases on the resource grain", () => {
303
+ const ESTATE = [res("net"), res("app", ["net"], { upstream: so("net", "id") })];
304
+
305
+ test("without a wave gate each component's step leases its own rows", async () => {
306
+ const w = world();
307
+ const { port, log } = memoryPort();
308
+ const plan = planFanOut({ components: ESTATE, changed: ["net"] });
309
+ const result = await runFanOut(plan, ESTATE, w.registry, { env: "prod", gates: memoryGateLedgerPort(), rowLease: port });
310
+ expect(result.status).toBe("ok");
311
+ expect(log.takes).toEqual([
312
+ { label: "net", keys: ["row net"] },
313
+ { label: "app", keys: ["row app"] },
314
+ ]);
315
+ });
316
+
317
+ test("a held row fails its component, blocks what depends on it, and the fan-out exits 5", async () => {
318
+ const w = world();
319
+ const { port } = memoryPort(["row net"]);
320
+ const plan = planFanOut({ components: ESTATE, changed: ["net"] });
321
+ const result = await runFanOut(plan, ESTATE, w.registry, { env: "prod", gates: memoryGateLedgerPort(), rowLease: port });
322
+ expect(result.status).toBe("fail");
323
+ expect(result.failed).toEqual(["net"]);
324
+ expect(result.blocked.map((b) => b.component)).toEqual(["app"]);
325
+ expect(failedRunExitCode(result.results)).toBe(5);
326
+ });
327
+
328
+ test("under a wave gate the wave leases the rows its approved plans lock, once, and its steps take none of their own", async () => {
329
+ const w = world();
330
+ const { port, log } = memoryPort();
331
+ w.live = log.live;
332
+ const plan = planFanOut({ components: [res("net")], changed: ["net"] });
333
+ const ledgerOf = (pending: PendingGateRecord[] = [], resolutions: Array<Partial<GateResolutionRecord>> = []) =>
334
+ memoryGateLedgerPort({ pending, resolutions: resolutions.map((r) => ({ version: 1 as const, kind: "resolution" as const, op: "fan-out", gate: "release-wave-1", resolvedBy: "ana", timestamp: LATER, ...r })) });
335
+ const options = { env: "prod", now: NOW, waveGate: { op: "fan-out", gate: "release" }, rowLease: port };
336
+ const first = await runFanOut(plan, [res("net")], w.registry, { ...options, gates: ledgerOf() });
337
+ expect(first.status).toBe("gated");
338
+ expect(log.takes).toEqual([]);
339
+ const approved = await runFanOut(plan, [res("net")], w.registry, { ...options, gates: ledgerOf([first.gate!], [{ planDigest: first.gate!.planDigest! }]) });
340
+ expect(approved.status).toBe("ok");
341
+ expect(log.takes).toEqual([{ label: "wave 1", keys: ["row net"] }]);
342
+ expect(w.heldWhileApplying).toEqual({ net: true });
343
+ expect(w.fromPlan).toEqual({ net: true });
344
+ expect(log.releases).toEqual(["wave 1"]);
345
+ });
346
+
347
+ test("under a wave gate a held row fails the wave's components and exits 5", async () => {
348
+ const w = world();
349
+ const { port } = memoryPort(["row net"]);
350
+ const plan = planFanOut({ components: [res("net")], changed: ["net"] });
351
+ const resolutions = (digest: string) => [{ version: 1 as const, kind: "resolution" as const, op: "fan-out", gate: "release-wave-1", resolvedBy: "ana", timestamp: LATER, planDigest: digest }];
352
+ const first = await runFanOut(plan, [res("net")], w.registry, { env: "prod", now: NOW, waveGate: { op: "fan-out", gate: "release" }, gates: memoryGateLedgerPort() });
353
+ const held = await runFanOut(plan, [res("net")], w.registry, {
354
+ env: "prod",
355
+ now: NOW,
356
+ waveGate: { op: "fan-out", gate: "release" },
357
+ rowLease: port,
358
+ gates: memoryGateLedgerPort({ pending: [first.gate!], resolutions: resolutions(first.gate!.planDigest!) }),
359
+ });
360
+ expect(held.status).toBe("fail");
361
+ expect(held.waves?.at(-1)).toMatchObject({ wave: 1, status: "failed" });
362
+ expect(w.applied).toEqual([]);
363
+ expect(failedRunExitCode(held.results)).toBe(5);
364
+ });
365
+
366
+ test("a fan-out handed plans made beforehand refuses a lease port: its caller leases those rows", async () => {
367
+ const w = world();
368
+ const { port } = memoryPort();
369
+ const plan = planFanOut({ components: [res("net")], changed: ["net"] });
370
+ await expect(runFanOut(plan, [res("net")], w.registry, { env: "prod", plans: { net: {} }, rowLease: port })).rejects.toThrow(/takes no row lease/);
371
+ });
372
+ });
373
+
374
+ describe("a later pr-apply round is leased again", () => {
375
+ /** net, and app reading its id, which net's plan knows only after apply. */
376
+ const ESTATE = [res("net"), res("app", ["net"], { upstream: so("net", "id") })];
377
+ const plan = () => planFanOut({ components: ESTATE, changed: ["net"] });
378
+ const approveRound = async ({ gate, set }: { gate: string; set: PrPlanSet }) => {
379
+ const ledger = memoryGateLedgerPort({ resolutions: [{ version: 1, kind: "resolution", op: "pr-12", gate, resolvedBy: "github:rev", timestamp: LATER, planDigest: set.doc.digest }] });
380
+ const check = await decidePrGate(readOnlyLedger(ledger), { op: "pr-12", gate, digest: set.doc.digest, now: NOW });
381
+ return { satisfied: check.satisfied, approval: approvalOf(check) };
382
+ };
383
+
384
+ const setUp = async () => {
385
+ const w = world();
386
+ w.versions.net = "v2";
387
+ w.predict.net = () => ({ known: {}, unknown: ["id"] });
388
+ const set = await planPrSet({ components: ESTATE, plan: plan(), registry: w.registry, env: "prod" });
389
+ return { w, set };
390
+ };
391
+
392
+ test("round 2 leases the rows its own plan locks before it applies, and lets go after", async () => {
393
+ const { w, set } = await setUp();
394
+ const rounds: Array<{ round: number; keys: string[] }> = [];
395
+ let released = 0;
396
+ const applied = await applyPrSet({
397
+ components: ESTATE,
398
+ plan: plan(),
399
+ registry: w.registry,
400
+ env: "prod",
401
+ set,
402
+ decideRound: approveRound,
403
+ leaseRound: async ({ round, set: roundSet }) => {
404
+ rounds.push({ round, keys: Object.values(roundSet.locks ?? {}).flatMap((l) => l.rows.map((r) => r.key)) });
405
+ return { release: async () => ((released += 1), true) };
406
+ },
407
+ });
408
+ expect(applied.status).toBe("applied");
409
+ expect(rounds).toEqual([{ round: 2, keys: ["row app"] }]);
410
+ expect(released).toBe(1);
411
+ expect(w.applied).toEqual(["net", "app"]);
412
+ });
413
+
414
+ test("a round whose rows another run holds does not apply: the round says held and the result names the run", async () => {
415
+ const { w, set } = await setUp();
416
+ const applied = await applyPrSet({
417
+ components: ESTATE,
418
+ plan: plan(),
419
+ registry: w.registry,
420
+ env: "prod",
421
+ set,
422
+ decideRound: approveRound,
423
+ leaseRound: async () => ({ held: "run 4711 is applying app: res.x, so nothing of round 2 was applied" }),
424
+ });
425
+ expect(w.applied).toEqual(["net"]);
426
+ expect(applied.status).toBe("waiting");
427
+ expect(applied.held).toContain("run 4711");
428
+ expect(applied.rounds?.map((r) => [r.round, r.status, r.message])).toEqual([[2, "held", "run 4711 is applying app: res.x, so nothing of round 2 was applied"]]);
429
+ });
430
+
431
+ test("a round whose rows file cannot be written fails the apply with the reason", async () => {
432
+ const { w, set } = await setUp();
433
+ const applied = await applyPrSet({
434
+ components: ESTATE,
435
+ plan: plan(),
436
+ registry: w.registry,
437
+ env: "prod",
438
+ set,
439
+ decideRound: approveRound,
440
+ leaseRound: async () => ({ failed: "could not hold the rows round 2 changes in pr-apply" }),
441
+ });
442
+ expect(applied.status).toBe("failed");
443
+ expect(applied.leaseFailed).toContain("round 2");
444
+ expect(applied.rounds?.[0]?.status).toBe("failed");
445
+ });
446
+ });
447
+
448
+ describe("the ledger port", () => {
449
+ const dirs: string[] = [];
450
+ afterAll(() => {
451
+ for (const d of dirs) rmSync(d, { recursive: true, force: true });
452
+ });
453
+ const git = (cwd: string, ...args: string[]) => execFileSync("git", args, { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).trim();
454
+ const repo = (): string => {
455
+ const dir = realpathSync(mkdtempSync(join(tmpdir(), "chant-row-lease-")));
456
+ dirs.push(dir);
457
+ git(dir, "init", "-q", "-b", "main");
458
+ git(dir, "config", "user.email", "test@chant.dev");
459
+ git(dir, "config", "user.name", "Test");
460
+ git(dir, "config", "commit.gpgsign", "false");
461
+ writeFileSync(join(dir, "README.md"), "# t\n");
462
+ git(dir, "add", "README.md");
463
+ git(dir, "commit", "-q", "-m", "init");
464
+ return dir;
465
+ };
466
+ const row = (key: string): LockRow => ({ key, target: "e01", address: key });
467
+ const quiet = () => undefined;
468
+
469
+ test("two steps of one run that share a row keep it until both end", async () => {
470
+ const cwd = repo();
471
+ const port = ledgerRowLease("pr-apply", { cwd, holder: { run: "100", at: NOW }, alive: async () => "alive", log: quiet });
472
+ const one = await port.take([row("object vpc-1"), row("estate e01 a")], "net");
473
+ const two = await port.take([row("object vpc-1"), row("estate e01 b")], "app");
474
+ expect(Object.keys((await readLockRows("pr-apply", { cwd })).rows).sort()).toEqual(["estate e01 a", "estate e01 b", "object vpc-1"]);
475
+ await one.release();
476
+ expect(Object.keys((await readLockRows("pr-apply", { cwd })).rows).sort()).toEqual(["estate e01 b", "object vpc-1"]);
477
+ await two.release();
478
+ expect((await readLockRows("pr-apply", { cwd })).rows).toEqual({});
479
+ });
480
+
481
+ test("another live run's row refuses the take with a held error naming that run", async () => {
482
+ const cwd = repo();
483
+ const other = ledgerRowLease("pr-apply", { cwd, holder: { run: "200", at: NOW, url: "https://forge.example/runs/200" }, alive: async () => "alive", log: quiet });
484
+ await other.take([row("estate e01 a")], "net");
485
+ const mine = ledgerRowLease("pr-apply", { cwd, holder: { run: "300", at: NOW }, alive: async () => "alive", log: quiet });
486
+ const err = await mine.take([row("estate e01 a")], "net").catch((e: unknown) => e);
487
+ expect(isLockRowsHeldError(err)).toBe(true);
488
+ expect((err as Error).message).toContain("run 200 (https://forge.example/runs/200)");
489
+ });
490
+ });
@@ -0,0 +1,167 @@
1
+ /**
2
+ * The row lease on the apply paths that plan inside their own steps (#4594):
3
+ * `chant run --components`, `chant components fan-out`, a promote, a
4
+ * rollback and a redeploy. `chant components pr-apply` and op waves lease the
5
+ * rows their plan already knows (#4552); these paths plan only as each step
6
+ * runs, so the lease is taken there, one step or one group at a time.
7
+ *
8
+ * - A step on the resource grain (`lockGrainBeforePlan`: the step's own
9
+ * `lockGrain`, else `ci.lockGrain`, else its lexicon's default) plans
10
+ * first, asks its lexicon for the rows of that plan, leases them, and then
11
+ * applies the plan it leased for, handed back as `DeployContext.plans`. A
12
+ * step on any other grain applies as before and takes no lease.
13
+ * - A group (ws-107) leases the rows of every member's plan in one take
14
+ * before `runGroup` is called, and lets go once it returns.
15
+ * - A held row fails the step, or every member of the group, with a record
16
+ * marked `held`, so the command exits 5 (`CHANT_EXIT.held`) and nothing of
17
+ * that step applied.
18
+ *
19
+ * The port ({@link ledgerRowLease}) writes `_locks/rows/<gate>.json` through
20
+ * ../lifecycle/resource-lock.ts with one holder for the whole run, and
21
+ * counts each row within the process, so two components of one run that
22
+ * change one object let go of its row only once both have ended.
23
+ */
24
+ import type { LockGrain, LockRow } from "../lifecycle/lock-rows";
25
+ import { lockGrainBeforePlan, resolvePlannedLock, sortedLockRows } from "../lifecycle/lock-rows";
26
+ import type { LockLiveness, LockRowHolder } from "../lifecycle/resource-lock";
27
+ import type { Capability, CapabilityPlan, DeployContext } from "./capability";
28
+
29
+ /** Rows a step or a group holds while it applies. */
30
+ export interface RowLease {
31
+ /** Let go of the rows. Never throws; false when the rows file could not be written, and the rows stay until a later apply takes them over. */
32
+ release(): Promise<boolean>;
33
+ }
34
+
35
+ /** How a run takes its row leases (#4594). */
36
+ export interface RowLeasePort {
37
+ /**
38
+ * Lease `rows` for `label` (a component, or a group's components), all or
39
+ * nothing. Throws {@link LockRowsHeldError} when another live run holds
40
+ * one, and any other error when the rows file cannot be read or written.
41
+ */
42
+ take(rows: readonly LockRow[], label: string): Promise<RowLease>;
43
+ }
44
+
45
+ /** Another live run holds a row this apply changes (#4594), so nothing of it applied. Exit 5. */
46
+ export class LockRowsHeldError extends Error {
47
+ readonly lockRowsHeld = true;
48
+ constructor(message: string) {
49
+ super(message);
50
+ this.name = "LockRowsHeldError";
51
+ }
52
+ }
53
+
54
+ /** Whether `err` is a held row ({@link LockRowsHeldError}), by its mark, so a copy from another bundle counts too. */
55
+ export function isLockRowsHeldError(err: unknown): err is LockRowsHeldError {
56
+ return typeof err === "object" && err !== null && (err as { lockRowsHeld?: unknown }).lockRowsHeld === true;
57
+ }
58
+
59
+ const NO_LEASE: RowLease = { release: () => Promise.resolve(true) };
60
+
61
+ export interface LedgerRowLeaseOptions {
62
+ cwd?: string;
63
+ /** Whether a run holding rows still runs. Default: the forge's answer, with the lease's age. */
64
+ alive?: LockLiveness;
65
+ /** Who the rows name. Default: this CI run, else this host and process. */
66
+ holder?: LockRowHolder;
67
+ /** Where the lease's info lines go. Default stderr. */
68
+ log?: (line: string) => void;
69
+ }
70
+
71
+ /**
72
+ * The port over `gate`'s rows file on `chant/lifecycle` (#4594), one holder
73
+ * for every take of the run. A row this process already holds for another
74
+ * step is counted, not taken again, and is let go of when its last holder in
75
+ * the process ends.
76
+ */
77
+ export function ledgerRowLease(gate: string, opts: LedgerRowLeaseOptions = {}): RowLeasePort {
78
+ const counts = new Map<string, number>();
79
+ const log = opts.log ?? ((line: string) => console.error(line));
80
+ let holder: LockRowHolder | undefined = opts.holder;
81
+ const lock = () => import("../lifecycle/resource-lock");
82
+ return {
83
+ async take(rows, label) {
84
+ const wanted = sortedLockRows(rows);
85
+ if (wanted.length === 0) return NO_LEASE;
86
+ const { leaseLockRows, lockRowHolder, releaseLockRows } = await lock();
87
+ holder ??= lockRowHolder(process.env);
88
+ const fresh = wanted.filter((r) => (counts.get(r.key) ?? 0) === 0);
89
+ if (fresh.length > 0) {
90
+ const leased = await leaseLockRows(gate, fresh, { holder, ...(opts.cwd ? { cwd: opts.cwd } : {}), ...(opts.alive ? { alive: opts.alive } : {}) });
91
+ if (!leased.ok) {
92
+ throw new LockRowsHeldError(
93
+ `${label}: ${leased.message}, so nothing of it was applied. Apply again once that run ends; a run that is gone, or whose lease is older than CHANT_LOCK_STALE seconds, is taken over.`,
94
+ );
95
+ }
96
+ for (const h of leased.tookOver) log(`${label}: took over the rows of run ${h.run}, which is gone`);
97
+ }
98
+ for (const r of wanted) counts.set(r.key, (counts.get(r.key) ?? 0) + 1);
99
+ log(`${label}: holds ${wanted.length} row${wanted.length === 1 ? "" : "s"} of ${gate} while it applies`);
100
+ const me = holder.run;
101
+ let released = false;
102
+ return {
103
+ async release() {
104
+ if (released) return true;
105
+ released = true;
106
+ const free: string[] = [];
107
+ for (const r of wanted) {
108
+ const n = (counts.get(r.key) ?? 1) - 1;
109
+ if (n <= 0) {
110
+ counts.delete(r.key);
111
+ free.push(r.key);
112
+ } else {
113
+ counts.set(r.key, n);
114
+ }
115
+ }
116
+ if (free.length === 0) return true;
117
+ const ok = await releaseLockRows(gate, free, me, { ...(opts.cwd ? { cwd: opts.cwd } : {}) });
118
+ if (!ok) log(`${label}: could not let go of the rows it held; the next apply takes them over once this run is gone`);
119
+ return ok;
120
+ },
121
+ };
122
+ },
123
+ };
124
+ }
125
+
126
+ /**
127
+ * Lease one capability step's rows (#4594) when `ctx.rowLease` is set, the
128
+ * step was handed no plan and its grain is `resource`: plan, read the rows
129
+ * of that plan, lease them, and return the context that applies the leased
130
+ * plan. Otherwise the context as given and no lease. A grain the lexicon
131
+ * refuses throws, as it does at plan in a pull request.
132
+ */
133
+ export async function leaseCapabilityStep(
134
+ capability: Capability<never, unknown>,
135
+ ctx: DeployContext,
136
+ input: unknown,
137
+ ): Promise<{ ctx: DeployContext; lease: RowLease }> {
138
+ const port = ctx.rowLease;
139
+ if (!port || ctx.plans !== undefined || !capability.plan) return { ctx, lease: NO_LEASE };
140
+ if ((await lockGrainBeforePlan(capability, input, ctx.lockGrain)) !== "resource") return { ctx, lease: NO_LEASE };
141
+ const planned: CapabilityPlan = await capability.plan(ctx, input as never);
142
+ const lock = await resolvePlannedLock(capability, input, planned, ctx.lockGrain);
143
+ const plans = planned.artifact !== undefined ? { [planned.member]: planned.artifact } : undefined;
144
+ const applies: DeployContext = plans ? { ...ctx, plans } : ctx;
145
+ if (lock.grain !== "resource" || lock.rows.length === 0) return { ctx: applies, lease: NO_LEASE };
146
+ return { ctx: applies, lease: await port.take(lock.rows, ctx.component) };
147
+ }
148
+
149
+ /**
150
+ * The rows of a group's approved plans (#4594), each member's from its
151
+ * lexicon on its grain: what one take holds for the whole group.
152
+ */
153
+ export async function groupLockRows(
154
+ capability: Capability<never, unknown>,
155
+ members: ReadonlyArray<{ component: string; input?: unknown; ctx: DeployContext }>,
156
+ plans: Readonly<Record<string, CapabilityPlan>>,
157
+ declared: LockGrain | undefined,
158
+ ): Promise<LockRow[]> {
159
+ const rows: LockRow[] = [];
160
+ for (const m of members) {
161
+ const plan = plans[m.component];
162
+ if (!plan) continue;
163
+ const lock = await resolvePlannedLock(capability, m.input, plan, declared);
164
+ if (lock.grain === "resource") rows.push(...lock.rows);
165
+ }
166
+ return sortedLockRows(rows);
167
+ }