@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,71 @@
1
+ /**
2
+ * A release's changelog from its conventional commits (#4597, terragucci#1289
3
+ * bundle B). {@link releaseChangelog} groups the commits a version shipped
4
+ * into breaking changes, features, fixes and the rest, each with its sha and
5
+ * subject, and names the bump they imply, in the shape the release catalog
6
+ * takes (`CatalogChangelogInput`, ./release-catalog.ts).
7
+ *
8
+ * The bump follows terragucci's `bumpFor` (`publish/semver.ts`): a `type!:`
9
+ * subject or a `BREAKING CHANGE` (or `BREAKING-CHANGE`) footer is a major,
10
+ * `feat` a minor, and anything else a patch, since a changed component is
11
+ * always published at a new version. terragucci can call this behind its
12
+ * feature-detect once chant ships it.
13
+ *
14
+ * Pure: the caller reads the commits (`git log`) and passes them in.
15
+ */
16
+ import type { CatalogChangelogEntry, ChangelogKind, ReleaseBump } from "./release-catalog";
17
+
18
+ /** One commit: its sha and its full message, subject first. */
19
+ export interface ChangelogCommit {
20
+ sha: string;
21
+ message: string;
22
+ }
23
+
24
+ /** The changelog of one release. */
25
+ export interface ReleaseChangelog {
26
+ /** The bump the commits imply. */
27
+ bump: ReleaseBump;
28
+ /** Every commit, in the order given, with its group. */
29
+ entries: CatalogChangelogEntry[];
30
+ /** The entries of each group, in the order given. */
31
+ groups: Record<ChangelogKind, CatalogChangelogEntry[]>;
32
+ }
33
+
34
+ const HEADER = /^(\w+)(?:\(([^)]*)\))?(!)?:\s*(.*)$/;
35
+ const BREAKING_FOOTER = /^BREAKING[ -]CHANGE:/m;
36
+
37
+ /** The group, scope and description of one commit message. A subject that is not conventional is `other`, kept whole. */
38
+ export function classifyCommit(message: string): { kind: ChangelogKind; scope?: string; subject: string } {
39
+ const subject = message.split("\n", 1)[0]!.trim();
40
+ const m = HEADER.exec(subject);
41
+ const breaking = BREAKING_FOOTER.test(message) || (m !== null && m[3] === "!");
42
+ if (!m) return { kind: breaking ? "breaking" : "other", subject };
43
+ const type = m[1]!;
44
+ const scope = m[2] ? m[2].trim() : undefined;
45
+ const kind: ChangelogKind = breaking ? "breaking" : type === "feat" ? "feat" : type === "fix" ? "fix" : "other";
46
+ return { kind, ...(scope ? { scope } : {}), subject: m[4]!.trim() || subject };
47
+ }
48
+
49
+ /** The bump a set of commit messages implies, as terragucci's `bumpFor` decides it. */
50
+ export function changelogBump(messages: readonly string[]): ReleaseBump {
51
+ let bump: ReleaseBump = "patch";
52
+ for (const message of messages) {
53
+ const subject = message.split("\n", 1)[0]!;
54
+ if (/^\w+(\([^)]*\))?!:/.test(subject) || BREAKING_FOOTER.test(message)) return "major";
55
+ if (/^feat(\([^)]*\))?:/.test(subject)) bump = "minor";
56
+ }
57
+ return bump;
58
+ }
59
+
60
+ /** Group `commits` and name their bump. */
61
+ export function releaseChangelog(commits: readonly ChangelogCommit[]): ReleaseChangelog {
62
+ const groups: Record<ChangelogKind, CatalogChangelogEntry[]> = { breaking: [], feat: [], fix: [], other: [] };
63
+ const entries: CatalogChangelogEntry[] = [];
64
+ for (const c of commits) {
65
+ const { kind, scope, subject } = classifyCommit(c.message);
66
+ const entry: CatalogChangelogEntry = { kind, sha: c.sha, subject, ...(scope ? { scope } : {}) };
67
+ entries.push(entry);
68
+ groups[kind].push(entry);
69
+ }
70
+ return { bump: changelogBump(commits.map((c) => c.message)), entries, groups };
71
+ }
@@ -362,7 +362,7 @@ export interface CutPlan {
362
362
  /** The digest already cut under `label`, or this digest when it is already cut: the cut would then write no new release. */
363
363
  alreadyCut: string | null;
364
364
  /** Each environment's target: its params, and its templates by component and path. */
365
- targets: Array<{ env: string; params: ReleaseTarget["params"]; templates: Array<{ component: string | null; path: string }> }>;
365
+ targets: Array<{ env: string; params: ReleaseTarget["params"]; templates: Array<{ component: string | null; path: string }>; trees?: ReleaseTarget["trees"] }>;
366
366
  /** The components whose artifacts would be built, and the environment each is built in. */
367
367
  build: Array<{ component: string; env: string }>;
368
368
  /** The components whose artifacts would be carried from an earlier release. */
@@ -434,7 +434,7 @@ export async function planRelease(req: CutRequest): Promise<CutPlan> {
434
434
  label: req.label,
435
435
  releaseDigest,
436
436
  alreadyCut,
437
- targets: targets.map((t) => ({ env: t.env, params: t.params, templates: t.templates.map(({ component, path }) => ({ component, path })) })),
437
+ targets: targets.map((t) => ({ env: t.env, params: t.params, templates: t.templates.map(({ component, path }) => ({ component, path })), ...(t.trees ? { trees: t.trees } : {}) })),
438
438
  build,
439
439
  reused: p.reused,
440
440
  publishSteps: [...steps.values()],
@@ -33,6 +33,7 @@ import { warnOnLegacyDigests, withoutReadFlags, type LegacyDigestFlag } from "./
33
33
  import { appendReleaseRecordLine, readReleaseLedgerLines, listLedgerEnvironments as gitListLedgerEnvironments, type LedgerLocation } from "./git";
34
34
  import { parseReleaseLedger, validateReleaseRecord } from "./release-read";
35
35
  import type { GateResolutionRecord } from "./gate-ledger";
36
+ import { NEXT_RELEASE } from "../release-floors";
36
37
 
37
38
  // The pure readers live apart, so a bundle can import them without git (#3865).
38
39
  export { validateReleaseRecord, parseReleaseLedger, releaseLedgerLines, readReleaseRecords, listReleaseEnvironmentsOn } from "./release-read";
@@ -75,6 +76,13 @@ export const RUN_ORIGIN_CHANT_FLOOR = "0.124.30";
75
76
  /** The first chant that writes `runOrigin.jobId` and `runOrigin.attempt`, for a forge job that ran `chant ci run` (#4156). */
76
77
  export const RUN_ORIGIN_JOB_FLOOR = "0.124.32";
77
78
 
79
+ /**
80
+ * The first chant that writes and reads `releaseVersion` on a release record
81
+ * (#4595). A record from an older chant has none, and a reader lists it by
82
+ * digest.
83
+ */
84
+ export const RELEASE_VERSION_FLOOR = NEXT_RELEASE;
85
+
78
86
  /**
79
87
  * The gate resolution that admitted a deploy (#4020): the gate's address in the
80
88
  * gate ledger (`_gates/<op>.jsonl`, `op` and `gate`) and when the resolution
@@ -260,6 +268,16 @@ export interface ReleaseRecord {
260
268
  * ({@link isApplyRecord}).
261
269
  */
262
270
  digestKind?: ReleaseDigestKind;
271
+ /**
272
+ * Optional: the version the publish gave this release (#4595), such as a
273
+ * module's `1.4.0` or a package's `2.0.0-rc.1`, when the component has
274
+ * versions of its own. `version` is taken by the record's schema version,
275
+ * so the field has this name. Written from {@link RELEASE_VERSION_FLOOR};
276
+ * absent on older records and on deploys that name no version. The
277
+ * release catalog (./release-catalog.ts) lists a version by it, and a
278
+ * record without one by its digest.
279
+ */
280
+ releaseVersion?: string;
263
281
  }
264
282
 
265
283
  /** What a release record's `digest` names when it is not an artifact digest (#4274). */
@@ -400,6 +418,8 @@ export async function appendReleaseRecord(
400
418
  opts?: { cwd?: string },
401
419
  ): Promise<{ commit: string; record: ReleaseRecord }> {
402
420
  const missing = validateReleaseRecord(input);
421
+ // #4595: a version, when given, is a non-empty string, so a reader never sees `""` or a number.
422
+ if (input.releaseVersion !== undefined && (typeof input.releaseVersion !== "string" || input.releaseVersion.length === 0)) missing.push("releaseVersion");
403
423
  if (missing.length > 0) throw new InvalidReleaseRecordError(missing);
404
424
 
405
425
  // `flags` are read-side only (#2514); a record passed back in never persists them.
@@ -141,17 +141,25 @@ export type PublishFetch = (
141
141
  init: { method: string; headers: Record<string, string>; body?: Uint8Array | string; redirect?: "follow" | "manual" },
142
142
  ) => Promise<{ ok: boolean; status: number; headers: { get(name: string): string | null }; text(): Promise<string> }>;
143
143
 
144
- /** What a target is given to plan and to publish. */
145
- export interface PublishContext {
146
- release: Release;
147
- label: string | null;
148
- /** The tag the cut made for the release, `release/<label>` or `release/<member>/<label>`, or null for a release with no label. */
149
- releaseTag: string | null;
150
- provenance: ProvenanceCheck;
151
- /** The cut whose signature the provenance statement carries (#4049), or null when none is known. */
152
- cut?: PublishCut | null;
153
- /** The member's directory, which the declaration's paths are relative to. */
144
+ /**
145
+ * The part of a target's context every kind of target is given, whatever it
146
+ * publishes (#4602). A release target gets {@link PublishContext}, which adds
147
+ * the release; a target outside `release.publish`, such as the terraform
148
+ * lexicon's module targets, extends this with its own fields (a module
149
+ * version, its archive) and implements `PublishTarget<ItsContext, string>`,
150
+ * reusing {@link PublishTargetError}, {@link PublishFetch}, {@link PublishDeps}
151
+ * and the credential helpers in ./publish-credentials.ts.
152
+ */
153
+ export interface PublishContextBase {
154
+ /** The directory the declaration's paths are relative to. */
154
155
  cwd: string;
156
+ /** The environment credentials are read from. */
157
+ env: NodeJS.ProcessEnv;
158
+ /** Masks credentials; every line a target logs and every error it throws goes through it. */
159
+ redactor: Redactor;
160
+ /** Print one line of progress. The line is redacted. */
161
+ log(line: string): void;
162
+ provenance: ProvenanceCheck;
155
163
  /**
156
164
  * The tag a reveal points at what was staged, in place of the target's
157
165
  * own: npm's dist-tag (default `latest`) and the OCI tags. Null for the
@@ -159,12 +167,18 @@ export interface PublishContext {
159
167
  * ({@link NPM_STAGE_TAG}) and OCI by digest.
160
168
  */
161
169
  tag: string | null;
162
- /** The environment credentials are read from. */
163
- env: NodeJS.ProcessEnv;
164
- /** Masks credentials; every line a target logs and every error it throws goes through it. */
165
- redactor: Redactor;
166
- /** Print one line of progress. The line is redacted. */
167
- log(line: string): void;
170
+ }
171
+
172
+ /** What a release target is given to plan and to publish. */
173
+ export interface PublishContext extends PublishContextBase {
174
+ release: Release;
175
+ label: string | null;
176
+ /** The tag the cut made for the release, `release/<label>` or `release/<member>/<label>`, or null for a release with no label. */
177
+ releaseTag: string | null;
178
+ /** The cut whose signature the provenance statement carries (#4049), or null when none is known. */
179
+ cut?: PublishCut | null;
180
+ /** The member's directory, which the declaration's paths are relative to. */
181
+ cwd: string;
168
182
  /**
169
183
  * Whether a target with no SBOM source refuses (`publish-sbom-missing`),
170
184
  * as under the `supply-chain` group (#4168). False or absent: it publishes
@@ -185,6 +199,9 @@ export class PublishTargetError extends Error {
185
199
  }
186
200
  }
187
201
 
202
+ /** The kinds `release.publish` declares and `createPublishTargets` makes. */
203
+ export type ReleasePublishKind = "npm" | "oci" | "forge";
204
+
188
205
  /** The npm dist-tag a set of packages is staged under before `latest` moves (#4048), as chant's own releases do (#3903). */
189
206
  export const NPM_STAGE_TAG = "next";
190
207
 
@@ -196,10 +213,16 @@ export const NPM_STAGE_TAG = "next";
196
213
  * (./publish-declaration.ts) and made by `createPublishTargets`
197
214
  * (./publish-targets.ts). A new kind of target is a new member of the
198
215
  * declaration's union and a factory that returns this interface.
216
+ *
217
+ * The context is a type parameter (#4602): a target that publishes something
218
+ * other than a cut release, such as a module version, implements
219
+ * `PublishTarget<C, K>` over its own context `C`, which extends
220
+ * {@link PublishContextBase}, with its own `kind` names `K`. Such targets are
221
+ * made by their own code, never by `createPublishTargets`.
199
222
  */
200
- export interface PublishTarget {
201
- /** The declaration's `type`. */
202
- kind: "npm" | "oci" | "forge";
223
+ export interface PublishTarget<C extends PublishContextBase = PublishContext, K extends string = ReleasePublishKind> {
224
+ /** The declaration's `type`: one of {@link ReleasePublishKind} under `release.publish`, any name for a target outside it. */
225
+ kind: K;
203
226
  /** A name for messages, such as `npm (2 packages)`. */
204
227
  name: string;
205
228
  /** Where it publishes, for the line printed before it runs. */
@@ -219,7 +242,7 @@ export interface PublishTarget {
219
242
  * {@link PublishTargetError}. The dry run prints what it returns, and a
220
243
  * publish plans every target before any of them publishes.
221
244
  */
222
- plan(ctx: PublishContext): Promise<PublishItem[]>;
245
+ plan(ctx: C): Promise<PublishItem[]>;
223
246
  /**
224
247
  * Put every item where the target publishes, where no consumer resolves it
225
248
  * yet (#4048): npm under the `next` dist-tag, OCI by digest with no tag
@@ -228,7 +251,7 @@ export interface PublishTarget {
228
251
  * again and comes back `present`, so a stage run again after a failure
229
252
  * sends only what is missing. Throws {@link PublishTargetError}.
230
253
  */
231
- stage(ctx: PublishContext): Promise<StagedTarget>;
254
+ stage(ctx: C): Promise<StagedTarget>;
232
255
  /**
233
256
  * The one last step that makes what {@link stage} put out visible: npm
234
257
  * moves `latest` (or `ctx.tag`) package by package in the declared order,
@@ -236,7 +259,7 @@ export interface PublishTarget {
236
259
  * publishes the draft (GitLab: creates the release with its links). Run
237
260
  * again, it moves nothing that already moved. Throws {@link PublishTargetError}.
238
261
  */
239
- reveal(ctx: PublishContext, staged: StagedTarget): Promise<PublishedTarget>;
262
+ reveal(ctx: C, staged: StagedTarget): Promise<PublishedTarget>;
240
263
  }
241
264
 
242
265
  /** The targets the member at `cwd` declares under `release.publish` in its `chant.config.ts`. */
@@ -46,6 +46,8 @@ export function parseReleaseLedger(lines: readonly string[]): { records: Release
46
46
  malformed++;
47
47
  continue;
48
48
  }
49
+ // #4595: a `releaseVersion` that is not a non-empty string is dropped; the record still reads, listed by digest.
50
+ if ("releaseVersion" in parsed && (typeof parsed.releaseVersion !== "string" || parsed.releaseVersion.length === 0)) delete (parsed as { releaseVersion?: unknown }).releaseVersion;
49
51
  records.push(flagLegacyDigest(parsed, [parsed.digest, parsed.manifestDigest, parsed.inputDigest]));
50
52
  } catch {
51
53
  malformed++;
@@ -0,0 +1,186 @@
1
+ /**
2
+ * Release status records (#4596): append, the latest line per digest wins,
3
+ * the member prefix, `--no-record`, and `chant ledger release_status`
4
+ * listing the table.
5
+ */
6
+ import { afterEach, describe, expect, test } from "vitest";
7
+ import { execFileSync } from "node:child_process";
8
+ import { mkdirSync, mkdtempSync, realpathSync, rmSync, writeFileSync } from "node:fs";
9
+ import { tmpdir } from "node:os";
10
+ import { dirname, join } from "node:path";
11
+ import { NEXT_RELEASE } from "../release-floors";
12
+ import { gitLedgerReadPort } from "./git";
13
+ import { readLedgerTable } from "./ledger-read";
14
+ import { clearMemberLedgerCache } from "./member-ledger";
15
+ import { resetNoRecordLedger } from "./no-record";
16
+ import { LEDGER_RELEASE_STATUS_FLOOR, loadQueryData, QUERY_TABLES } from "./query";
17
+ import { buildReleaseCatalog } from "./release-catalog";
18
+ import type { ReleaseRecord } from "./release-ledger";
19
+ import {
20
+ appendReleaseStatus,
21
+ catalogStatusInputs,
22
+ parseReleaseStatus,
23
+ readReleaseStatus,
24
+ readReleaseStatusOn,
25
+ RELEASE_STATUS_FLOOR,
26
+ ReleaseStatusError,
27
+ statusOf,
28
+ type ReleaseStatusInput,
29
+ } from "./release-status";
30
+
31
+ const scratch: string[] = [];
32
+ afterEach(() => {
33
+ delete process.env.CHANT_NO_RECORD;
34
+ resetNoRecordLedger();
35
+ clearMemberLedgerCache();
36
+ for (const d of scratch.splice(0)) rmSync(d, { recursive: true, force: true });
37
+ });
38
+
39
+ function git(args: string[], cwd: string): string {
40
+ return execFileSync("git", ["-c", "commit.gpgsign=false", ...args], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).trim();
41
+ }
42
+
43
+ function repo(files: Record<string, string> = { "README.md": "fixture\n" }): string {
44
+ const root = realpathSync(mkdtempSync(join(tmpdir(), "chant-release-status-")));
45
+ scratch.push(root);
46
+ for (const [path, text] of Object.entries(files)) {
47
+ mkdirSync(dirname(join(root, path)), { recursive: true });
48
+ writeFileSync(join(root, path), text);
49
+ }
50
+ git(["init", "-q", "-b", "main"], root);
51
+ git(["config", "user.email", "test@chant.dev"], root);
52
+ git(["config", "user.name", "Test"], root);
53
+ git(["add", "-A"], root);
54
+ git(["commit", "-q", "-m", "init"], root);
55
+ return root;
56
+ }
57
+
58
+ function branchFiles(root: string): string[] {
59
+ try {
60
+ return git(["ls-tree", "-r", "--name-only", "chant/lifecycle"], root).split("\n").filter(Boolean).sort();
61
+ } catch {
62
+ return [];
63
+ }
64
+ }
65
+
66
+ const status = (over: Partial<ReleaseStatusInput> = {}): ReleaseStatusInput => ({
67
+ component: "vpc/aws",
68
+ env: "registry",
69
+ digest: "sha256:v2",
70
+ releaseVersion: "2.0.0",
71
+ status: "deprecated",
72
+ reason: "use 2.1.0",
73
+ replacement: "2.1.0",
74
+ actor: "ana",
75
+ timestamp: "2026-10-20T00:00:00.000Z",
76
+ ...over,
77
+ });
78
+
79
+ describe("release status floors", () => {
80
+ test("are the next release", () => {
81
+ expect(RELEASE_STATUS_FLOOR).toBe(NEXT_RELEASE);
82
+ expect(LEDGER_RELEASE_STATUS_FLOOR).toBe(NEXT_RELEASE);
83
+ });
84
+ });
85
+
86
+ describe("appendReleaseStatus (#4596)", () => {
87
+ test("refuses a record the reader would skip, before any git runs", async () => {
88
+ await expect(appendReleaseStatus(status({ status: "gone" as never }), { cwd: "/nonexistent" })).rejects.toBeInstanceOf(ReleaseStatusError);
89
+ await expect(appendReleaseStatus(status({ actor: "" }), { cwd: "/nonexistent" })).rejects.toBeInstanceOf(ReleaseStatusError);
90
+ await expect(appendReleaseStatus(status({ reason: "" }), { cwd: "/nonexistent" })).rejects.toBeInstanceOf(ReleaseStatusError);
91
+ });
92
+
93
+ test("appends one line beside releases.jsonl and reads it back", async () => {
94
+ const root = repo();
95
+ const { record } = await appendReleaseStatus(status(), { cwd: root });
96
+ expect(record.version).toBe(1);
97
+ expect(branchFiles(root)).toEqual(["registry/release-status.jsonl"]);
98
+ const { records, malformed } = await readReleaseStatus("registry", { cwd: root });
99
+ expect(malformed).toBe(0);
100
+ expect(records).toEqual([record]);
101
+ });
102
+
103
+ test("the latest line per digest wins, and a restore is one more line", async () => {
104
+ const root = repo();
105
+ await appendReleaseStatus(status({ status: "yanked", timestamp: "2026-10-20T00:00:00.000Z" }), { cwd: root });
106
+ await appendReleaseStatus(status({ status: "active", reason: "fixed upstream", replacement: undefined, actor: "bo", timestamp: "2026-10-21T00:00:00.000Z" }), { cwd: root });
107
+ await appendReleaseStatus(status({ digest: "sha256:v1", releaseVersion: "1.0.0", status: "deprecated", timestamp: "2026-10-21T00:00:00.000Z" }), { cwd: root });
108
+ const { records } = await readReleaseStatus("registry", { cwd: root });
109
+ expect(records).toHaveLength(3);
110
+ expect(statusOf(records, "vpc/aws", "sha256:v2")).toMatchObject({ status: "active", record: { actor: "bo" } });
111
+ expect(statusOf(records, "vpc/aws", "sha256:v1").status).toBe("deprecated");
112
+ expect(statusOf(records, "vpc/aws", "sha256:never")).toEqual({ status: "active" });
113
+ expect(statusOf(records, "other", "sha256:v2")).toEqual({ status: "active" });
114
+ });
115
+
116
+ test("a tie in time goes to the later line", () => {
117
+ const lines = [status({ status: "yanked" }), status({ status: "deprecated" })].map((s) => JSON.stringify({ version: 1, ...s })).join("\n");
118
+ expect(statusOf(parseReleaseStatus(lines).records, "vpc/aws", "sha256:v2").status).toBe("deprecated");
119
+ });
120
+
121
+ test("a malformed line is counted and skipped", () => {
122
+ const good = JSON.stringify({ version: 1, ...status() });
123
+ const { records, malformed } = parseReleaseStatus(`${good}\n{\n${JSON.stringify({ version: 2, ...status() })}\n${JSON.stringify({ version: 1, ...status({ status: "gone" as never }) })}\n`);
124
+ expect(records).toHaveLength(1);
125
+ expect(malformed).toBe(3);
126
+ });
127
+
128
+ test("writes under the member prefix of cwd", async () => {
129
+ const CONFIG = JSON.stringify({ lexicons: ["terraform"] });
130
+ const root = repo({
131
+ "chant.workspace.json": JSON.stringify({ name: "acme", schema: 1, members: [{ name: "modules", dir: "modules", kind: "chant" }] }),
132
+ "modules/chant.config.json": CONFIG,
133
+ });
134
+ await appendReleaseStatus(status(), { cwd: join(root, "modules") });
135
+ expect(branchFiles(root)).toEqual(["_members/modules/registry/release-status.jsonl"]);
136
+ expect((await readReleaseStatus("registry", { cwd: join(root, "modules") })).records).toHaveLength(1);
137
+ expect((await readReleaseStatus("registry", { cwd: root, member: "modules" })).records).toHaveLength(1);
138
+ expect((await readReleaseStatus("registry", { cwd: root })).records).toEqual([]);
139
+ });
140
+
141
+ test("with --no-record the line reads back in process and the branch is unchanged", async () => {
142
+ const root = repo();
143
+ process.env.CHANT_NO_RECORD = "1";
144
+ await appendReleaseStatus(status(), { cwd: root });
145
+ expect((await readReleaseStatus("registry", { cwd: root })).records).toHaveLength(1);
146
+ expect(branchFiles(root)).toEqual([]);
147
+ });
148
+ });
149
+
150
+ describe("the release_status table (#4596)", () => {
151
+ test("chant query loads every line", async () => {
152
+ const root = repo();
153
+ await appendReleaseStatus(status({ status: "yanked" }), { cwd: root });
154
+ await appendReleaseStatus(status({ status: "active", reason: undefined, replacement: undefined, releaseVersion: undefined, timestamp: "2026-10-22T00:00:00.000Z" }), { cwd: root });
155
+ const { data, malformed } = await loadQueryData([{ member: null, port: gitLedgerReadPort({ cwd: root }) }]);
156
+ expect(malformed.release_status).toBe(0);
157
+ expect(QUERY_TABLES.release_status.map(([c]) => c)).toEqual(["member", "env", "component", "digest", "release_version", "status", "reason", "replacement", "actor", "timestamp"]);
158
+ expect(data.release_status).toEqual([
159
+ { member: null, env: "registry", component: "vpc/aws", digest: "sha256:v2", release_version: "2.0.0", status: "yanked", reason: "use 2.1.0", replacement: "2.1.0", actor: "ana", timestamp: "2026-10-20T00:00:00.000Z" },
160
+ { member: null, env: "registry", component: "vpc/aws", digest: "sha256:v2", release_version: null, status: "active", reason: null, replacement: null, actor: "ana", timestamp: "2026-10-22T00:00:00.000Z" },
161
+ ]);
162
+ });
163
+
164
+ test("chant ledger release_status lists it, filtered", async () => {
165
+ const root = repo();
166
+ await appendReleaseStatus(status({ status: "yanked" }), { cwd: root });
167
+ await appendReleaseStatus(status({ digest: "sha256:v1", releaseVersion: "1.0.0" }), { cwd: root });
168
+ const doc = await readLedgerTable("release_status", [{ member: null, port: gitLedgerReadPort({ cwd: root }) }], { where: ["status=yanked"] });
169
+ if (!("rows" in doc)) throw new Error(JSON.stringify(doc));
170
+ expect(doc.table).toBe("release_status");
171
+ expect(doc.total).toBe(2);
172
+ expect(doc.rows.map((r) => r.digest)).toEqual(["sha256:v2"]);
173
+ });
174
+ });
175
+
176
+ describe("catalogStatusInputs", () => {
177
+ test("feeds the release catalog", async () => {
178
+ const root = repo();
179
+ await appendReleaseStatus(status({ status: "yanked", reason: "breaks routes" }), { cwd: root });
180
+ const { records } = await readReleaseStatusOn(gitLedgerReadPort({ cwd: root }), "registry");
181
+ const release: ReleaseRecord = { version: 1, component: "vpc/aws", env: "registry", digest: "sha256:v2", releaseVersion: "2.0.0", gitSha: "a".repeat(40), runId: "r1", timestamp: "2026-10-01T00:00:00.000Z", actor: "ci" };
182
+ const catalog = buildReleaseCatalog({ releases: [release], statuses: catalogStatusInputs(records) }, { generatedAt: "2026-10-27T00:00:00.000Z" });
183
+ expect(catalog.components[0].versions[0].status).toMatchObject({ state: "yanked", reason: "breaks routes", replacement: "2.1.0" });
184
+ expect(catalog.components[0].latest).toBeNull();
185
+ });
186
+ });
@@ -0,0 +1,176 @@
1
+ /**
2
+ * Release status records (#4596, terragucci#1289 bundle B): deprecate, yank
3
+ * and restore a release, one line per change at
4
+ * `<env>/release-status.jsonl`, beside the `releases.jsonl` it speaks about.
5
+ *
6
+ * The latest line per digest wins, so a restore is one more line with
7
+ * `status: "active"` and nothing is ever rewritten. Any identity that may
8
+ * publish may append one (ruling C, 2026-10-27): there is no approval gate,
9
+ * and the record carries the actor and the reason instead.
10
+ *
11
+ * Writes go through `appendLedgerLine` (./git.ts), so they land under the
12
+ * member prefix of `cwd` and honour `--no-record` (`CHANT_NO_RECORD`), as the
13
+ * writers of #4551 do. Nothing here pushes: the caller runs
14
+ * `pushLifecycleReport` after, the two-step shape every ledger here uses.
15
+ *
16
+ * The parse and the reads over a {@link LedgerReadPort} are pure. git is
17
+ * loaded only by {@link appendReleaseStatus} and {@link readReleaseStatus},
18
+ * so `chant query` (./query.ts) and a product bundle read the table without
19
+ * it.
20
+ */
21
+ import { NEXT_RELEASE } from "../release-floors";
22
+ import type { LedgerReadPort } from "./ledger-port";
23
+ import type { LedgerLocation } from "./git";
24
+ import type { CatalogStatusInput, ReleaseStatusValue } from "./release-catalog";
25
+
26
+ /** The first chant that writes and reads `<env>/release-status.jsonl`, and lists the `release_status` table (#4596). */
27
+ export const RELEASE_STATUS_FLOOR = NEXT_RELEASE;
28
+
29
+ /** The file a status record is appended to, in its environment's directory. */
30
+ export const RELEASE_STATUS_FILE = "release-status.jsonl";
31
+
32
+ /** The statuses a record may set. */
33
+ export const RELEASE_STATUSES = ["active", "deprecated", "yanked"] as const satisfies readonly ReleaseStatusValue[];
34
+
35
+ /** One status change for one release. */
36
+ export interface ReleaseStatusRecord {
37
+ /** Schema version of the line. */
38
+ version: 1;
39
+ /** The component the release belongs to (`ReleaseRecord.component`). */
40
+ component: string;
41
+ /** The environment whose ledger holds the release, and this line. */
42
+ env: string;
43
+ /** The release's digest, the key the latest line is taken by. */
44
+ digest: string;
45
+ /** The release's version (`ReleaseRecord.releaseVersion`), when known. */
46
+ releaseVersion?: string;
47
+ /** `deprecated` and `yanked` mark the release; `active` restores it. */
48
+ status: ReleaseStatusValue;
49
+ /** Why, in the actor's words. */
50
+ reason?: string;
51
+ /** The version to move to instead. */
52
+ replacement?: string;
53
+ /** Who set it. */
54
+ actor: string;
55
+ /** ISO-8601 time it was set, given by the caller. */
56
+ timestamp: string;
57
+ }
58
+
59
+ /** The fields a caller gives; `version` is filled in. */
60
+ export type ReleaseStatusInput = Omit<ReleaseStatusRecord, "version">;
61
+
62
+ /** A status record the reader would skip, so it is never appended. */
63
+ export class ReleaseStatusError extends Error {
64
+ constructor(message: string) {
65
+ super(message);
66
+ this.name = "ReleaseStatusError";
67
+ }
68
+ }
69
+
70
+ const REQUIRED = ["component", "env", "digest", "actor", "timestamp"] as const;
71
+ const OPTIONAL = ["releaseVersion", "reason", "replacement"] as const;
72
+
73
+ /** Why `value` is not a status record, one line per problem; empty when it is one. */
74
+ export function releaseStatusProblems(value: unknown): string[] {
75
+ if (value === null || typeof value !== "object" || Array.isArray(value)) return ["not an object"];
76
+ const r = value as Record<string, unknown>;
77
+ const problems: string[] = [];
78
+ if (r.version !== 1) problems.push("version is not 1");
79
+ for (const k of REQUIRED) if (typeof r[k] !== "string" || (r[k] as string).length === 0) problems.push(`${k} is missing`);
80
+ for (const k of OPTIONAL) if (r[k] !== undefined && (typeof r[k] !== "string" || (r[k] as string).length === 0)) problems.push(`${k} is not a non-empty string`);
81
+ if (!(RELEASE_STATUSES as readonly unknown[]).includes(r.status)) problems.push(`status is not one of ${RELEASE_STATUSES.join(", ")}`);
82
+ return problems;
83
+ }
84
+
85
+ /** Parse a `release-status.jsonl` text, oldest first. A line that is not a record is counted and skipped. */
86
+ export function parseReleaseStatus(text: string | null): { records: ReleaseStatusRecord[]; malformed: number } {
87
+ const records: ReleaseStatusRecord[] = [];
88
+ let malformed = 0;
89
+ for (const line of (text ?? "").split("\n").map((l) => l.trim()).filter(Boolean)) {
90
+ try {
91
+ const parsed = JSON.parse(line) as unknown;
92
+ if (releaseStatusProblems(parsed).length > 0) {
93
+ malformed++;
94
+ continue;
95
+ }
96
+ records.push(parsed as ReleaseStatusRecord);
97
+ } catch {
98
+ malformed++;
99
+ }
100
+ }
101
+ return { records, malformed };
102
+ }
103
+
104
+ /**
105
+ * The latest record per component and digest: the newest `timestamp`, ties
106
+ * going to the later line. Keyed `<component>\0<digest>`; use
107
+ * {@link statusOf} to look one up.
108
+ */
109
+ export function latestReleaseStatus(records: readonly ReleaseStatusRecord[]): Map<string, ReleaseStatusRecord> {
110
+ const latest = new Map<string, ReleaseStatusRecord>();
111
+ for (const r of records) {
112
+ const key = `${r.component}\u0000${r.digest}`;
113
+ const cur = latest.get(key);
114
+ if (!cur || r.timestamp >= cur.timestamp) latest.set(key, r);
115
+ }
116
+ return latest;
117
+ }
118
+
119
+ /**
120
+ * The status of one release: the latest record for its component and
121
+ * digest, or `active` with no record when none was ever set.
122
+ */
123
+ export function statusOf(
124
+ records: readonly ReleaseStatusRecord[],
125
+ component: string,
126
+ digest: string,
127
+ ): { status: ReleaseStatusValue; record?: ReleaseStatusRecord } {
128
+ const record = latestReleaseStatus(records).get(`${component}\u0000${digest}`);
129
+ return record ? { status: record.status, record } : { status: "active" };
130
+ }
131
+
132
+ /** The records as the release catalog's status input (./release-catalog.ts). */
133
+ export function catalogStatusInputs(records: readonly ReleaseStatusRecord[]): CatalogStatusInput[] {
134
+ return records.map((r) => ({
135
+ component: r.component,
136
+ digest: r.digest,
137
+ ...(r.releaseVersion ? { version: r.releaseVersion } : {}),
138
+ status: r.status,
139
+ ...(r.reason ? { reason: r.reason } : {}),
140
+ ...(r.replacement ? { replacement: r.replacement } : {}),
141
+ actor: r.actor,
142
+ timestamp: r.timestamp,
143
+ }));
144
+ }
145
+
146
+ /** Every status record of `environment` the port holds, oldest first. */
147
+ export async function readReleaseStatusOn(port: LedgerReadPort, environment: string): Promise<{ records: ReleaseStatusRecord[]; malformed: number }> {
148
+ return parseReleaseStatus(await port.read(environment, RELEASE_STATUS_FILE));
149
+ }
150
+
151
+ /**
152
+ * Append one status record to `<env>/release-status.jsonl` under the member
153
+ * prefix of `opts.cwd`. Refuses a record the reader would skip, before any
154
+ * git runs. Does not push.
155
+ */
156
+ export async function appendReleaseStatus(input: ReleaseStatusInput, opts?: { cwd?: string }): Promise<{ commit: string; record: ReleaseStatusRecord }> {
157
+ const record: ReleaseStatusRecord = { version: 1, ...input };
158
+ const problems = releaseStatusProblems(record);
159
+ if (problems.length > 0) throw new ReleaseStatusError(`not a release status record: ${problems.join("; ")}`);
160
+ const { appendLedgerLine } = await import("./git");
161
+ const label = record.releaseVersion ?? record.digest;
162
+ const commit = await appendLedgerLine(record.env, RELEASE_STATUS_FILE, JSON.stringify(record), `Release status: ${record.component} ${label} ${record.status}`, opts);
163
+ return { commit, record };
164
+ }
165
+
166
+ /**
167
+ * Every status record of `environment` on the local `chant/lifecycle`,
168
+ * oldest first, for the member `location` resolves to. Never fetches.
169
+ */
170
+ export async function readReleaseStatus(
171
+ environment: string,
172
+ location?: LedgerLocation,
173
+ ): Promise<{ records: ReleaseStatusRecord[]; malformed: number }> {
174
+ const { readBlobFromPath } = await import("./git");
175
+ return parseReleaseStatus(await readBlobFromPath(environment, RELEASE_STATUS_FILE, location));
176
+ }