@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,252 @@
1
+ /**
2
+ * The check moment (#4556): `ci.hooks.check` in the workspace declaration,
3
+ * run by a product's check job, terragucci's and plywood's alike, with the
4
+ * runner the other moments use (`runStageHooks`). Nothing here knows an
5
+ * engine: a hook is the user's own tool (tflint, checkov, trivy,
6
+ * pre-commit), and the product switches it on with a preset.
7
+ *
8
+ * - The hooks are read from the declaration at the base the check measures
9
+ * the change from, never from the change itself, so a change cannot remove
10
+ * a required check. The top level's run first, then the member's.
11
+ * - A hook runs once for the check, or once per target with `perRun`;
12
+ * `{target}` and `CHANT_TARGET` name it, and `targets` match the targets'
13
+ * names. There is no `{plan}`, and `onFailure` is `fail`.
14
+ * - A hook runs with no forge token, no OIDC request variables and no cloud
15
+ * credentials in its environment ({@link checkHookEnv}).
16
+ *
17
+ * {@link writeCiHook} is the writer a product's `init` calls to add a hook to
18
+ * `ci.hooks`, keeping the declaration's formatting.
19
+ */
20
+
21
+ import { spawnSync } from "node:child_process";
22
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
23
+ import { join, relative, resolve } from "node:path";
24
+ import { CHECK_HOOK_MOMENT, assertCheckHooks, type CiHooks, type OpWaveHook } from "../op/op-waves";
25
+ import { runStageHooks, type OpWaveExec, type OpWaveHookRun } from "../op/stage-hooks";
26
+ import { FORGE_TOKEN_VARS } from "../ci-handover";
27
+ import { OIDC_REQUEST_VARS, TRADED_VARS } from "../ci-identity";
28
+ import { DECLARATION_FILES, readDeclaration, WorkspaceReadError, type Declaration } from "../workspace/declaration";
29
+ import { setProperty, valueAt } from "../workspace/json-edit";
30
+ import { parseJsonText } from "../workspace/jsonc";
31
+ import { memberAtCwd } from "../workspace/security";
32
+ import { locateWorkspace } from "../workspace/which-chant";
33
+
34
+ export { CI_CHECK_HOOK_FLOOR } from "../op/op-waves";
35
+
36
+ /** The check hooks a job runs, and where they were read. */
37
+ export interface CheckHooksRead {
38
+ hooks: OpWaveHook[];
39
+ /** The commit they were read at. */
40
+ base: string;
41
+ /** A line for the log when none run because the base has no declaration, or could not be read. */
42
+ note?: string;
43
+ }
44
+
45
+ /** The check hooks `declaration` gives a job run in a member (or at the top, `null`): the top level's, then the member's. */
46
+ export function checkHooksOf(declaration: Pick<Declaration, "ci" | "members">, member: string | null): OpWaveHook[] {
47
+ const own = member === null ? null : (declaration.members.find((m) => m.name === member)?.ciHooks ?? null);
48
+ return [...(declaration.ci?.hooks?.check ?? []), ...(own?.check ?? [])];
49
+ }
50
+
51
+ /** Whether the working tree's declaration names any check hook. */
52
+ function checkoutNamesCheckHooks(cwd: string): boolean {
53
+ try {
54
+ const located = locateWorkspace(cwd);
55
+ const d = readDeclaration(located.tree);
56
+ return checkHooksOf(d, memberAtCwd({ declaration: d, rootOnDisk: located.rootOnDisk }, cwd)).length > 0;
57
+ } catch {
58
+ return false;
59
+ }
60
+ }
61
+
62
+ /**
63
+ * The check hooks a job in `cwd` runs, read from the workspace declaration at
64
+ * `base`. Throws when the declaration at base cannot be read and the working
65
+ * tree's names check hooks, as the pull-request jobs do for their hooks.
66
+ */
67
+ export function checkHooksAt(cwd: string, base: string): CheckHooksRead {
68
+ let declaration: Declaration;
69
+ let rootOnDisk: string;
70
+ try {
71
+ const located = locateWorkspace(cwd, base);
72
+ declaration = readDeclaration(located.tree);
73
+ rootOnDisk = located.rootOnDisk;
74
+ } catch (err) {
75
+ const missing = err instanceof WorkspaceReadError && (err.code === "declaration-missing" || err.code === "not-a-git-repository");
76
+ const why = err instanceof Error ? err.message : String(err);
77
+ if (checkoutNamesCheckHooks(cwd)) {
78
+ if (missing) return { hooks: [], base, note: `ci.hooks.check: the base ${base.slice(0, 12)} has no workspace declaration, so the check hooks this change declares do not run until it merges` };
79
+ throw new Error(`ci.hooks.check is read from the workspace declaration at ${base.slice(0, 12)}, and it could not be read (${why}), so no check hook can be trusted to run`);
80
+ }
81
+ return missing ? { hooks: [], base } : { hooks: [], base, note: `ci.hooks.check: the declaration at ${base.slice(0, 12)} could not be read (${why}); this checkout names no check hooks, so none run` };
82
+ }
83
+ return { hooks: checkHooksOf(declaration, memberAtCwd({ declaration, rootOnDisk }, cwd)), base };
84
+ }
85
+
86
+ /** Variables that hold cloud credentials beyond the ones chant's own trade sets. */
87
+ const CLOUD_CREDENTIAL_VARS = [
88
+ "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_SESSION_TOKEN", "AWS_SECURITY_TOKEN", "AWS_WEB_IDENTITY_TOKEN_FILE", "AWS_ROLE_ARN", "AWS_PROFILE", "AWS_CONTAINER_CREDENTIALS_FULL_URI", "AWS_CONTAINER_CREDENTIALS_RELATIVE_URI", "AWS_CONTAINER_AUTHORIZATION_TOKEN",
89
+ "GOOGLE_APPLICATION_CREDENTIALS", "GOOGLE_CREDENTIALS", "GOOGLE_OAUTH_ACCESS_TOKEN", "CLOUDSDK_AUTH_ACCESS_TOKEN", "CLOUDSDK_AUTH_CREDENTIAL_FILE_OVERRIDE",
90
+ "AZURE_CLIENT_SECRET", "AZURE_CLIENT_CERTIFICATE_PATH", "AZURE_FEDERATED_TOKEN_FILE", "AZURE_ACCESS_TOKEN", "ARM_CLIENT_SECRET", "ARM_CLIENT_CERTIFICATE_PATH", "ARM_OIDC_TOKEN", "ARM_OIDC_TOKEN_FILE_PATH", "ARM_ACCESS_KEY", "ARM_SAS_TOKEN",
91
+ "PULUMI_ACCESS_TOKEN", "PULUMI_CONFIG_PASSPHRASE", "TFE_TOKEN", "TF_TOKEN_app_terraform_io",
92
+ ];
93
+
94
+ /**
95
+ * The environment a check hook runs with (#4556): `env` without a forge
96
+ * token, the OIDC request variables, or cloud credentials, and without any
97
+ * `TF_TOKEN_<host>` registry token. A check reads the change and nothing
98
+ * else.
99
+ */
100
+ export function checkHookEnv(env: NodeJS.ProcessEnv = process.env): Record<string, string> {
101
+ const drop = new Set<string>([...FORGE_TOKEN_VARS, ...OIDC_REQUEST_VARS, ...Object.values(TRADED_VARS).flat(), ...CLOUD_CREDENTIAL_VARS]);
102
+ const out: Record<string, string> = {};
103
+ for (const [name, value] of Object.entries(env)) {
104
+ if (value === undefined || drop.has(name) || name.startsWith("TF_TOKEN_")) continue;
105
+ out[name] = value;
106
+ }
107
+ return out;
108
+ }
109
+
110
+ /** {@link OpWaveExec} with {@link checkHookEnv} in place of the job's environment. */
111
+ export const checkHookExec: OpWaveExec = (argv, cwd, env) => {
112
+ const result = spawnSync(argv[0]!, argv.slice(1), { cwd, stdio: "inherit", env: { ...checkHookEnv(), ...env } });
113
+ if (result.error) throw result.error;
114
+ return result.status ?? 1;
115
+ };
116
+
117
+ /** One check hook's run, as the check report lists it. */
118
+ export interface CheckHookOutcome {
119
+ name: string;
120
+ /** The target, for a `perRun` hook. */
121
+ target?: string;
122
+ exit: number;
123
+ outcome: "passed" | "failed" | "skipped";
124
+ reason?: string;
125
+ }
126
+
127
+ /** What the check hooks came to, for the product's check report. */
128
+ export interface CheckHooksReport {
129
+ version: 1;
130
+ moment: typeof CHECK_HOOK_MOMENT;
131
+ /** The commit the hooks were read at. */
132
+ base: string;
133
+ targets: string[];
134
+ /** `none`: no check hook is declared at base. */
135
+ status: "passed" | "failed" | "none";
136
+ hooks: CheckHookOutcome[];
137
+ /** The first hook that failed, and why; the hooks after it did not run. */
138
+ failed?: string;
139
+ note?: string;
140
+ }
141
+
142
+ /** Where {@link runCheckHooks} writes its runs file and report unless told: `.chant/check`. */
143
+ export const CHECK_HOOKS_DIR = ".chant/check";
144
+
145
+ /** The report file under the directory. */
146
+ export const CHECK_HOOKS_REPORT_FILE = "check-hooks.json";
147
+
148
+ export interface RunCheckHooksOptions {
149
+ /** The commit to read `ci.hooks.check` at: the base the change is measured from. */
150
+ base: string;
151
+ /** The targets the change touches (roots, stacks or components), for `perRun` hooks and `targets`. */
152
+ targets?: readonly string[];
153
+ /** Default the working directory. */
154
+ cwd?: string;
155
+ /** Where the runs file and the report go, relative to `cwd`. Default {@link CHECK_HOOKS_DIR}. */
156
+ dir?: string;
157
+ /** The hooks, when the caller read them itself. Default {@link checkHooksAt} `base`. */
158
+ read?: CheckHooksRead;
159
+ /** Added to every hook's environment, after {@link checkHookEnv}. */
160
+ env?: Record<string, string>;
161
+ /** Default {@link checkHookExec}. */
162
+ exec?: OpWaveExec;
163
+ log?: (line: string) => void;
164
+ }
165
+
166
+ /**
167
+ * Run the check hooks (#4556): each once, or once per target with
168
+ * `perRun`, in order, stopping at the first that fails. Writes the runs file
169
+ * (`{runs}`, `CHANT_RUNS`) and the report under `dir`, and returns the
170
+ * report.
171
+ */
172
+ export function runCheckHooks(options: RunCheckHooksOptions): CheckHooksReport {
173
+ const cwd = options.cwd ?? process.cwd();
174
+ const log = options.log ?? ((line: string) => console.error(line));
175
+ const read = options.read ?? checkHooksAt(cwd, options.base);
176
+ if (read.note) log(read.note);
177
+ const targets = [...(options.targets ?? [])];
178
+ const dir = relative(cwd, resolve(cwd, options.dir ?? CHECK_HOOKS_DIR)) || ".";
179
+ mkdirSync(join(cwd, dir), { recursive: true });
180
+ const report = (r: Omit<CheckHooksReport, "version" | "moment" | "base" | "targets">): CheckHooksReport => {
181
+ const doc: CheckHooksReport = { version: 1, moment: CHECK_HOOK_MOMENT, base: read.base, targets, ...r, ...(read.note ? { note: read.note } : {}) };
182
+ writeFileSync(join(cwd, dir, CHECK_HOOKS_REPORT_FILE), JSON.stringify(doc, null, 2) + "\n");
183
+ return doc;
184
+ };
185
+ if (read.hooks.length === 0) return report({ status: "none", hooks: [] });
186
+ assertCheckHooks("ci.hooks at base", read.hooks);
187
+ const op = "check";
188
+ const runs: OpWaveHookRun[] = targets.map((target) => ({ target, op }));
189
+ const runsFile = join(dir, "runs.json");
190
+ writeFileSync(join(cwd, runsFile), JSON.stringify({ version: 1, op, stage: "check", base: read.base, hook: CHECK_HOOK_MOMENT, runs }, null, 2) + "\n");
191
+ const ran = runStageHooks(CHECK_HOOK_MOMENT, read.hooks, {
192
+ name: op,
193
+ op,
194
+ wave: op,
195
+ runs,
196
+ runsFile,
197
+ holdFile: join(dir, "hold.json"),
198
+ env: { CHANT_CHECK: "1", CHANT_HOOKS_BASE: read.base, ...options.env },
199
+ cwd,
200
+ exec: options.exec ?? checkHookExec,
201
+ log,
202
+ });
203
+ const hooks = ran.outcomes.map((o): CheckHookOutcome => ({
204
+ name: o.name,
205
+ ...(o.target ? { target: o.target } : {}),
206
+ exit: o.exit,
207
+ outcome: o.outcome === "skipped" ? "skipped" : o.outcome === "passed" ? "passed" : "failed",
208
+ ...(o.reason ? { reason: o.reason } : {}),
209
+ }));
210
+ const failed = ran.failed ?? (hooks.some((h) => h.outcome === "failed") ? `a check hook failed: ${hooks.filter((h) => h.outcome === "failed").map((h) => h.name).join(", ")}` : undefined);
211
+ return report({ status: failed ? "failed" : "passed", hooks, ...(failed ? { failed } : {}) });
212
+ }
213
+
214
+ /**
215
+ * Add `hook` to `ci.hooks.<moment>` of the workspace declaration at `root`
216
+ * (#4556), the top level's or `member`'s, keeping the file's formatting. A
217
+ * hook of the same `name` at that moment is replaced, so a product's `init`
218
+ * can run again. Refuses a check hook the check job could not run. Returns
219
+ * the declaration file it wrote.
220
+ */
221
+ export function writeCiHook(
222
+ root: string,
223
+ moment: "check",
224
+ hook: OpWaveHook,
225
+ opts: { member?: string } = {},
226
+ ): { file: string; replaced: boolean } {
227
+ assertCheckHooks(`ci.hooks.${moment}`, [hook]);
228
+ const file = DECLARATION_FILES.map((f) => join(root, f)).find((f) => existsSync(f));
229
+ if (!file) throw new Error(`no workspace declaration at ${root}; create one before adding ci.hooks`);
230
+ const jsonc = file.endsWith(".jsonc");
231
+ const text = readFileSync(file, "utf-8");
232
+ const parsed = parseJsonText(text, { jsonc });
233
+ if (!parsed.ok) throw new Error(`${file} is not valid JSON${jsonc ? "C" : ""}: ${parsed.message}`);
234
+ const doc = parsed.value as { members?: Array<{ name?: string }> };
235
+ let owner = "";
236
+ if (opts.member !== undefined) {
237
+ const index = (doc.members ?? []).findIndex((m) => m?.name === opts.member);
238
+ if (index < 0) throw new Error(`the workspace declaration names no member ${JSON.stringify(opts.member)}`);
239
+ owner = `/members/${index}`;
240
+ }
241
+ const ci = valueAt(doc, `${owner}/ci`) as { hooks?: CiHooks } | undefined;
242
+ const current: OpWaveHook[] = ci?.hooks?.[moment] ?? [];
243
+ const name = hook.name ?? hook.command.join(" ");
244
+ const at = current.findIndex((h) => (h.name ?? h.command.join(" ")) === name);
245
+ const next = at < 0 ? [...current, hook] : current.map((h, i) => (i === at ? hook : h));
246
+ const written =
247
+ ci === undefined ? setProperty(text, jsonc, owner, "ci", { hooks: { [moment]: next } })
248
+ : ci.hooks === undefined ? setProperty(text, jsonc, `${owner}/ci`, "hooks", { [moment]: next })
249
+ : setProperty(text, jsonc, `${owner}/ci/hooks`, moment, next);
250
+ writeFileSync(file, written);
251
+ return { file, replaced: at >= 0 };
252
+ }
@@ -0,0 +1,51 @@
1
+ /** #4572: forge-neutral job services, rendered per forge. */
2
+
3
+ import { describe, expect, test } from "vitest";
4
+ import { engineServices, githubServices, gitlabServices, serviceWaitLine, servicesJobEnv, type CiService } from "./ci-services";
5
+
6
+ const PG: CiService = {
7
+ name: "replay-postgres",
8
+ image: "postgres:18.6@sha256:abc",
9
+ port: 5432,
10
+ env: { POSTGRES_PASSWORD: "replay" },
11
+ health: "pg_isready -h 127.0.0.1 -U postgres",
12
+ jobEnv: { REPLAY_POSTGRES_URL: "postgres://replay-postgres:5432/postgres" },
13
+ };
14
+ const CH: CiService = { name: "replay-clickhouse", image: "clickhouse/clickhouse-server:26.8.15.10", port: 8123, env: {}, health: "clickhouse-client --query 'SELECT 1'", jobEnv: { REPLAY_CLICKHOUSE_URL: "http://replay-clickhouse:8123" } };
15
+
16
+ describe("engineServices", () => {
17
+ test("joins each name once, in lexicon order", () => {
18
+ expect(engineServices([[PG], undefined, [CH, PG]]).map((s) => s.name)).toEqual(["replay-postgres", "replay-clickhouse"]);
19
+ });
20
+
21
+ test("refuses one name with two images", () => {
22
+ expect(() => engineServices([[PG], [{ ...PG, image: "postgres:17" }]])).toThrow(/replay-postgres/);
23
+ });
24
+ });
25
+
26
+ describe("rendering", () => {
27
+ test("GitHub and Forgejo: image, env and a health check per service", () => {
28
+ expect(githubServices([PG, CH])).toEqual({
29
+ "replay-postgres": { image: PG.image, env: { POSTGRES_PASSWORD: "replay" }, options: '--health-cmd "pg_isready -h 127.0.0.1 -U postgres" --health-interval 2s --health-timeout 5s --health-retries 45' },
30
+ "replay-clickhouse": { image: CH.image, options: `--health-cmd "clickhouse-client --query 'SELECT 1'" --health-interval 2s --health-timeout 5s --health-retries 45` },
31
+ });
32
+ });
33
+
34
+ test("GitLab: the image under its alias", () => {
35
+ expect(gitlabServices([PG, CH])).toEqual([
36
+ { name: PG.image, alias: "replay-postgres", variables: { POSTGRES_PASSWORD: "replay" } },
37
+ { name: CH.image, alias: "replay-clickhouse" },
38
+ ]);
39
+ });
40
+
41
+ test("the job's variables merge", () => {
42
+ expect(servicesJobEnv([PG, CH])).toEqual({ ...PG.jobEnv, ...CH.jobEnv });
43
+ });
44
+
45
+ test("the wait line names the host and port, and refuses a host a shell would read as more", () => {
46
+ const line = serviceWaitLine("replay-postgres", 5432);
47
+ expect(line).toContain('net.connect(5432, "replay-postgres"');
48
+ expect(line).toContain("n > 90");
49
+ expect(() => serviceWaitLine("a'; rm -rf /", 1)).toThrow();
50
+ });
51
+ });
@@ -0,0 +1,83 @@
1
+ /**
2
+ * Job services a lexicon asks for (#4572, `LexiconPlugin.ciServices`): a
3
+ * throwaway server a CI job starts beside it, such as the sql lexicon's
4
+ * replay server per dialect. A service is forge-neutral data here; a
5
+ * product's job renders it for its forge with {@link githubServices} (GitHub
6
+ * and Forgejo) or {@link gitlabServices}, sets {@link servicesJobEnv} on the
7
+ * job, and runs {@link serviceWaitLine} before the step that uses it.
8
+ *
9
+ * The job runs in a container (chant's default image, or the product's), so
10
+ * it reaches each service by its name on the job's own network. A name is
11
+ * prefixed by the lexicon (`replay-postgres`), so two lexicons' services
12
+ * never answer for one host.
13
+ */
14
+
15
+ import { NEXT_RELEASE } from "../release-floors";
16
+
17
+ /** The first chant with `LexiconPlugin.ciServices` and this module (#4572). */
18
+ export const CI_SERVICES_FLOOR = NEXT_RELEASE;
19
+
20
+ /** One service a job starts. */
21
+ export interface CiService {
22
+ /** The host the job reaches it at, and its alias on GitLab. */
23
+ name: string;
24
+ /** The image, pinned by the lexicon (tag, and digest where the lexicon pins one). */
25
+ image: string;
26
+ /** The port the server listens on inside its container. */
27
+ port: number;
28
+ /** The service container's environment. */
29
+ env: Record<string, string>;
30
+ /** A command run inside the service container that exits 0 once the server answers. */
31
+ health: string;
32
+ /** What the job that uses it sets: the server's URL and its throwaway credentials, by variable name. */
33
+ jobEnv: Record<string, string>;
34
+ }
35
+
36
+ /**
37
+ * Join the services each lexicon gives, each name once, in the order the
38
+ * lexicons come. Two services under one name with different images are
39
+ * refused: a host that answers for two servers would split the job.
40
+ */
41
+ export function engineServices(perLexicon: ReadonlyArray<readonly CiService[] | undefined>): CiService[] {
42
+ const out = new Map<string, CiService>();
43
+ for (const svc of perLexicon.flatMap((list) => list ?? [])) {
44
+ const seen = out.get(svc.name);
45
+ if (seen && seen.image !== svc.image) throw new Error(`two lexicons give a CI service named ${svc.name}, ${seen.image} and ${svc.image}; a job reaches one server per name`);
46
+ if (!seen) out.set(svc.name, svc);
47
+ }
48
+ return [...out.values()];
49
+ }
50
+
51
+ /** A job's `services:` on GitHub and Forgejo: each image with its environment and a health check the runner waits on. */
52
+ export function githubServices(services: readonly CiService[]): Record<string, { image: string; env?: Record<string, string>; options: string }> {
53
+ return Object.fromEntries(
54
+ services.map((s) => [
55
+ s.name,
56
+ {
57
+ image: s.image,
58
+ ...(Object.keys(s.env).length > 0 ? { env: { ...s.env } } : {}),
59
+ options: `--health-cmd "${s.health}" --health-interval 2s --health-timeout 5s --health-retries 45`,
60
+ },
61
+ ]),
62
+ );
63
+ }
64
+
65
+ /** A job's `services:` on GitLab: each image under its alias, with its variables. GitLab waits on the port itself. */
66
+ export function gitlabServices(services: readonly CiService[]): Array<{ name: string; alias: string; variables?: Record<string, string> }> {
67
+ return services.map((s) => ({ name: s.image, alias: s.name, ...(Object.keys(s.env).length > 0 ? { variables: { ...s.env } } : {}) }));
68
+ }
69
+
70
+ /** The variables a job using `services` sets, merged in order. */
71
+ export function servicesJobEnv(services: readonly CiService[]): Record<string, string> {
72
+ return Object.assign({}, ...services.map((s) => s.jobEnv)) as Record<string, string>;
73
+ }
74
+
75
+ /**
76
+ * A shell line that waits up to `seconds` for `host:port` to accept a
77
+ * connection, with `node -e`, so every forge and image with node runs it
78
+ * the same. It exits 1 naming the host when nothing answers.
79
+ */
80
+ export function serviceWaitLine(host: string, port: number, seconds = 90): string {
81
+ if (!/^[A-Za-z0-9.-]+$/.test(host)) throw new Error(`a service host is letters, digits, dots and hyphens, not ${JSON.stringify(host)}`);
82
+ return `node -e 'const net = require("net"); let n = 0; (function t() { const s = net.connect(${String(port)}, "${host}", () => { s.end(); process.exit(0); }); s.on("error", () => { if (++n > ${String(seconds)}) { console.error("${host}:${String(port)} did not answer"); process.exit(1); } setTimeout(t, 1000); }); })()'`;
83
+ }
@@ -52,6 +52,9 @@ import { existsSync, statSync } from "node:fs";
52
52
  import { getHeadCommit } from "../lifecycle/git";
53
53
  import { buildCapabilityRegistry } from "./capability-plugin-loader";
54
54
  import type { CapabilityRegistry } from "./capability";
55
+ import type { DeployAdoption } from "./adoption";
56
+ import type { LockGrain } from "../lifecycle/lock-rows";
57
+ import type { RowLeasePort } from "./row-lease";
55
58
  import type { FanOutPlan } from "./fan-out";
56
59
  import { componentSetFanOut, formRunGroups, planAndRunComponentGroup } from "./groups";
57
60
  import { applyConfigDefaults } from "./config-defaults";
@@ -394,12 +397,22 @@ export function findComponentGate(component: DriverComponent): { gate: string }
394
397
  export interface RunComponentsOptions {
395
398
  /** Target environment name, threaded into every capability's `DeployContext.env` (default: "local"). */
396
399
  env?: string;
400
+ /** `ci.lockGrain` as declared (#4594), for every step's `DeployContext.lockGrain`. Absent: each step takes its lexicon's default. */
401
+ lockGrain?: LockGrain;
402
+ /** The run's row lease (#4594): a step or group on the resource grain leases its rows through it before it applies. Absent: no lease. */
403
+ rowLease?: RowLeasePort;
397
404
  /**
398
405
  * The addresses each component's steps narrow to (#4300), by component
399
406
  * (`--target <component>:<address>`). A name the run does not run refuses
400
407
  * the run before anything starts.
401
408
  */
402
409
  targets?: Readonly<Record<string, readonly string[]>>;
410
+ /**
411
+ * `--adopt <adoption-file>` (#4537): adopt the file's resources into the
412
+ * one component this run names, through its deploy step's
413
+ * `DeployContext.adoption`. Refused with `all` or a list.
414
+ */
415
+ adoption?: DeployAdoption;
403
416
  /**
404
417
  * chant #1051 — opt-in: discover `*.component.ts` files in a sandboxed
405
418
  * child process (`chant run --components <name|all> --sandbox`) instead of
@@ -734,7 +747,15 @@ export async function runComponents(
734
747
  if (outside.length > 0) {
735
748
  return { success: false, selected: [], error: `--target names ${outside.join(", ")}, which this run does not run` };
736
749
  }
737
- const targeted = Object.keys(narrowed).length > 0 ? { targets: narrowed } : {};
750
+ const targeted = {
751
+ ...(Object.keys(narrowed).length > 0 ? { targets: narrowed } : {}),
752
+ // #4594: the grain and the lease reach every step through its DeployContext.
753
+ ...(options.lockGrain ? { lockGrain: options.lockGrain } : {}),
754
+ ...(options.rowLease ? { rowLease: options.rowLease } : {}),
755
+ };
756
+ if (options.adoption && (selector === "all" || isComponentList(selector))) {
757
+ return { success: false, selected: [], error: `--adopt adopts into one component's stack; name one component, not ${selector === "all" ? "all" : "a list"}` };
758
+ }
738
759
  // Cross-component/cross-stack outputs to resolve references against. Seeded
739
760
  // from a caller (a downstream CI job passing an upstream job's dumped
740
761
  // outputs via `--seed-outputs`); grows as this run's components complete.
@@ -829,7 +850,7 @@ export async function runComponents(
829
850
  emit?.({ type: "component-start", wave: 1, component: componentName });
830
851
  const componentResult = await runComponentDeploy(
831
852
  resolvedTargets[0],
832
- deployContext({ env, releaseIdentity, ...targeted }, componentName),
853
+ { ...deployContext({ env, releaseIdentity, ...targeted }, componentName), ...(options.adoption ? { adoption: options.adoption } : {}) },
833
854
  registry,
834
855
  componentOutputs,
835
856
  undefined,
@@ -1192,7 +1192,7 @@ describe("a step that refuses a moved plan (#3997)", () => {
1192
1192
  expect(isPlanMovedError("planMoved")).toBe(false);
1193
1193
  });
1194
1194
 
1195
- it("marks the failed step's record, and failedRunExitCode answers 3 for it and 1 for any other failure", async () => {
1195
+ it("marks the failed step's record, and failedRunExitCode answers 4 for it and 1 for any other failure", async () => {
1196
1196
  const run = async (mark: object) => {
1197
1197
  const registry = new CapabilityRegistry();
1198
1198
  registry.register(fakeCapability("apply", { run: () => { throw Object.assign(new Error("refused"), mark); } }).capability);
@@ -1201,10 +1201,10 @@ describe("a step that refuses a moved plan (#3997)", () => {
1201
1201
  };
1202
1202
  const moved = await run({ exitCode: 3 });
1203
1203
  expect(moved.records[0]).toMatchObject({ status: "fail", planMoved: true });
1204
- expect(failedRunExitCode([moved])).toBe(3);
1204
+ expect(failedRunExitCode([moved])).toBe(4);
1205
1205
  const other = await run({ exitCode: 7 });
1206
1206
  expect(other.records[0]).not.toHaveProperty("planMoved");
1207
1207
  expect(failedRunExitCode([other])).toBe(1);
1208
- expect(failedRunExitCode([other, moved])).toBe(3);
1208
+ expect(failedRunExitCode([other, moved])).toBe(4);
1209
1209
  });
1210
1210
  });
@@ -46,7 +46,10 @@
46
46
  * `CapabilityRegistry` the caller supplies.
47
47
  */
48
48
 
49
+ import type { LockGrain } from "../lifecycle/lock-rows";
50
+ import { isLockRowsHeldError, leaseCapabilityStep, type RowLease, type RowLeasePort } from "./row-lease";
49
51
  import { topoSort } from "../codegen/topo-sort";
52
+ import { CHANT_EXIT } from "../exit-codes";
50
53
  import { kahnLayers } from "./layers";
51
54
  import { evaluateGate, gitGateLedgerPort, type GateDigestMismatch, type GateLedgerPort } from "../op/gate";
52
55
  import { gateName } from "../op/gate-name";
@@ -159,6 +162,8 @@ export interface DriverStepRecord {
159
162
  error?: string;
160
163
  /** Set on a failed step whose capability refused a plan that moved since it was approved (`isPlanMovedError`, #3997). */
161
164
  planMoved?: true;
165
+ /** Set on a failed step or group member whose rows another live run holds (#4594): nothing of it applied, and the command exits 5. */
166
+ held?: true;
162
167
  /** Set on a `gate` step that passed (#2119): who resolved it, when, and at what address. */
163
168
  approval?: {
164
169
  gate: string;
@@ -586,9 +591,13 @@ async function runCapabilityStep(
586
591
  const { kind, ...rest } = step;
587
592
  const resolvedInput = resolveStepInput(rest, phaseOutputs, componentOutputs);
588
593
  const start = Date.now();
594
+ let lease: RowLease | undefined;
589
595
  try {
590
596
  const capability = registry.resolve(kind);
591
- const output = await capability.run(ctx, resolvedInput as never);
597
+ // #4594: on the resource grain, a run that plans inside its steps leases the step's rows first and applies the plan it leased for.
598
+ const leased = await leaseCapabilityStep(capability, ctx, resolvedInput);
599
+ lease = leased.lease;
600
+ const output = await capability.run(leased.ctx, resolvedInput as never);
592
601
  return {
593
602
  record: {
594
603
  component: ctx.component,
@@ -611,9 +620,12 @@ async function runCapabilityStep(
611
620
  durationMs: Date.now() - start,
612
621
  error: errMessage(err),
613
622
  ...(isPlanMovedError(err) ? { planMoved: true as const } : {}),
623
+ ...(isLockRowsHeldError(err) ? { held: true as const } : {}),
614
624
  },
615
625
  resolvedInput,
616
626
  };
627
+ } finally {
628
+ await lease?.release();
617
629
  }
618
630
  }
619
631
 
@@ -674,6 +686,8 @@ async function runPhase(
674
686
  ...(gates.planDigest !== undefined ? { planDigest: gates.planDigest } : {}),
675
687
  // #4045: and under a release, only for that release.
676
688
  ...(gates.releaseGate ? { releaseDigest: gates.releaseGate.releaseDigest } : {}),
689
+ // #4551: a release gate's plan digest is its change set's, so the fact cites it.
690
+ ...(gates.releaseGate && gates.planDigest !== undefined ? { fields: { changeSet: gates.planDigest } } : {}),
677
691
  ...(gates.releaseGate?.verifyEmpty ? { verifyEmpty: gates.releaseGate.verifyEmpty } : {}),
678
692
  ...(gate.description ? { description: gate.description } : {}),
679
693
  ...(gate.timeout ? { timeout: gate.timeout } : {}),
@@ -1133,13 +1147,19 @@ export function planMovedIn(results: readonly DriverComponentResult[]): boolean
1133
1147
  return results.some((r) => r.records.some((s) => s.planMoved === true));
1134
1148
  }
1135
1149
 
1150
+ /** Whether a step or group member in `results` found its rows held by another live run (#4594). */
1151
+ export function rowsHeldIn(results: readonly DriverComponentResult[]): boolean {
1152
+ return results.some((r) => r.records.some((s) => s.held === true));
1153
+ }
1154
+
1136
1155
  /**
1137
1156
  * The exit code of a run that failed: {@link PLAN_MOVED_EXIT_CODE} when a
1138
- * step refused a plan that moved since it was approved, 1 otherwise. Every
1139
- * command that runs capability steps ends a failed run with it.
1157
+ * step refused a plan that moved since it was approved, 5 (`held`) when a
1158
+ * step's rows were held by another run (#4594), 1 otherwise. Every command
1159
+ * that runs capability steps ends a failed run with it.
1140
1160
  */
1141
1161
  export function failedRunExitCode(results: readonly DriverComponentResult[]): number {
1142
- return planMovedIn(results) ? PLAN_MOVED_EXIT_CODE : 1;
1162
+ return planMovedIn(results) ? PLAN_MOVED_EXIT_CODE : rowsHeldIn(results) ? CHANT_EXIT.held : CHANT_EXIT.failed;
1143
1163
  }
1144
1164
 
1145
1165
  function errMessage(err: unknown): string {
@@ -1189,6 +1209,10 @@ export interface InterpretRunOptions {
1189
1209
  targets?: Readonly<Record<string, readonly string[]>>;
1190
1210
  /** Groups applied as one (ws-107, #4465). See {@link InterpretGroups}. Absent: every component runs its own deploy. */
1191
1211
  groups?: InterpretGroups;
1212
+ /** `ci.lockGrain` as declared (#4594), for every step's `DeployContext.lockGrain`. Absent: each step takes its lexicon's default. */
1213
+ lockGrain?: LockGrain;
1214
+ /** The run's row lease (#4594): each step on the resource grain leases its rows through it (./row-lease.ts). Absent: no lease. */
1215
+ rowLease?: RowLeasePort;
1192
1216
  }
1193
1217
 
1194
1218
  /**
@@ -1236,6 +1260,12 @@ export function deployContext(
1236
1260
  vars?: Record<string, unknown>;
1237
1261
  releaseIdentity?: (component: string) => ReleaseIdentity | undefined;
1238
1262
  targets?: Readonly<Record<string, readonly string[]>>;
1263
+ /** `ci.lockGrain` as declared at base (#4552), for every step's `DeployContext.lockGrain`. */
1264
+ lockGrain?: LockGrain;
1265
+ /** The commit policy is read at (#4613), for every step's `DeployContext.policyBase`. */
1266
+ policyBase?: string;
1267
+ /** The run's row lease (#4594), for every step's `DeployContext.rowLease`. */
1268
+ rowLease?: RowLeasePort;
1239
1269
  },
1240
1270
  component: string,
1241
1271
  ): DeployContext {
@@ -1245,6 +1275,9 @@ export function deployContext(
1245
1275
  env: options.env,
1246
1276
  component,
1247
1277
  ...(options.vars ? { vars: options.vars } : {}),
1278
+ ...(options.lockGrain ? { lockGrain: options.lockGrain } : {}),
1279
+ ...(options.policyBase ? { policyBase: options.policyBase } : {}),
1280
+ ...(options.rowLease ? { rowLease: options.rowLease } : {}),
1248
1281
  ...(release ? { release: { ...release } } : {}),
1249
1282
  ...(targets && targets.length > 0 ? { targets: [...new Set(targets)].sort() } : {}),
1250
1283
  };
@@ -1256,7 +1289,7 @@ export function deployContext(
1256
1289
  * such verb, in composition order. A step whose kind is not registered
1257
1290
  * refuses too. Does nothing when `ctx.targets` is absent.
1258
1291
  */
1259
- export function assertTargetsAccepted(component: DriverComponent, registry: CapabilityRegistry, ctx: DeployContext): void {
1292
+ export function assertTargetsAccepted(component: DriverComponent, registry: CapabilityRegistry, ctx: Pick<DeployContext, "targets">): void {
1260
1293
  if (!ctx.targets || ctx.targets.length === 0) return;
1261
1294
  const walk = (steps: DriverPhase["steps"]): void => {
1262
1295
  for (const step of steps) {