@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,395 @@
1
+ /**
2
+ * The control repo's entries (#4568): its projects and its shared defaults,
3
+ * as `control-entry` records on the control repo's workspace ledger.
4
+ *
5
+ * terragucci kept these as `chant workspace records` files committed to the
6
+ * control repo (packages/terragucci/src/control-records.ts at 18f6431595).
7
+ * Under the ci-products ruling (records go on the ledger, never product git
8
+ * writes; #4551) they are lines of `_control/entries.jsonl` on the control
9
+ * repo's `chant/lifecycle` branch, appended through the same git layer every
10
+ * other ledger here uses, under the member prefix of the directory they are
11
+ * written from.
12
+ *
13
+ * The file is a log. Each line is one version of one entry: a project's
14
+ * (`entry: project`, `project: <host>/<owner>/<name>`) or the defaults'
15
+ * (`entry: defaults`). An entry's current version is its newest line; a
16
+ * `retired` version closes it, and a project that comes back gets a new id.
17
+ * Each line names the digest of the version it replaces (`prev`), so a write
18
+ * that raced another is refused rather than lost, as terragucci's `amend
19
+ * --expect` refused it, and a reader finds a broken chain.
20
+ *
21
+ * What an entry's `settings` hold is the product's: chant checks the shape
22
+ * of the record, and the product passes a `validate` that checks its
23
+ * settings the way its config would.
24
+ *
25
+ * Neither write pushes: call `pushLifecycleReport` after, the two-step shape
26
+ * every ledger here uses.
27
+ */
28
+
29
+ import { createHash } from "node:crypto";
30
+ import { parseProjectKey } from "./dispatch";
31
+
32
+ /** The ledger directory and file the entries are kept in. */
33
+ export const CONTROL_LEDGER_DIR = "_control";
34
+ export const CONTROL_LEDGER_FILE = "entries.jsonl";
35
+
36
+ /** The record kind, as each line names it. */
37
+ export const CONTROL_ENTRY_KIND = "control-entry";
38
+ /** The prefix of an entry's id: `ctl-001`. */
39
+ export const CONTROL_ID_PREFIX = "ctl";
40
+
41
+ export const CONTROL_ENTRY_KINDS = ["project", "defaults"] as const;
42
+ export type ControlEntryKind = (typeof CONTROL_ENTRY_KINDS)[number];
43
+ export type ControlEntryState = "active" | "retired";
44
+
45
+ /** One line of `_control/entries.jsonl`: one version of one entry. */
46
+ export interface ControlEntryRecord {
47
+ version: 1;
48
+ kind: typeof CONTROL_ENTRY_KIND;
49
+ /** `ctl-<n>`, three digits or more. */
50
+ id: string;
51
+ entry: ControlEntryKind;
52
+ /** The project's key; null for the defaults. */
53
+ project: string | null;
54
+ state: ControlEntryState;
55
+ /** The project's settings, or the defaults, as the product's config holds them. */
56
+ settings: Record<string, unknown>;
57
+ /** The estates this project owns. Empty for the defaults. */
58
+ estates: string[];
59
+ /** The product that wrote it: `terragucci`, `plywood`. */
60
+ product: string;
61
+ /** When it was written, ISO 8601. */
62
+ at: string;
63
+ /** Who wrote it, when known. */
64
+ by?: string;
65
+ /** The digest of the version this one replaces; null for an entry's first. */
66
+ prev: string | null;
67
+ /** sha256 over the canonical JSON of every other field. */
68
+ digest: string;
69
+ }
70
+
71
+ /** An entry's current version, as a product reads it. */
72
+ export interface ControlEntry {
73
+ id: string;
74
+ entry: ControlEntryKind;
75
+ /** The project's key; undefined for the defaults. */
76
+ project?: string;
77
+ settings: Record<string, unknown>;
78
+ estates: string[];
79
+ digest: string;
80
+ at: string;
81
+ by?: string;
82
+ }
83
+
84
+ /** Records the control repo's entries are wrong in; `problems` lists each one. */
85
+ export class ControlRecordsError extends Error {
86
+ constructor(
87
+ message: string,
88
+ readonly problems: string[] = [message],
89
+ ) {
90
+ super(message);
91
+ this.name = "ControlRecordsError";
92
+ }
93
+ }
94
+
95
+ /** A write refused because the entry changed since it was read. */
96
+ export class ControlEntryConflict extends ControlRecordsError {
97
+ constructor(message: string) {
98
+ super(message);
99
+ this.name = "ControlEntryConflict";
100
+ }
101
+ }
102
+
103
+ function canonical(v: unknown): unknown {
104
+ if (Array.isArray(v)) return v.map(canonical);
105
+ if (v && typeof v === "object") return Object.fromEntries(Object.keys(v).sort().map((k) => [k, canonical((v as Record<string, unknown>)[k])]));
106
+ return v;
107
+ }
108
+
109
+ /** The digest of a record: sha256 over the canonical JSON of every field but `digest`. */
110
+ export function controlEntryDigest(record: Omit<ControlEntryRecord, "digest">): string {
111
+ const { digest: _drop, ...rest } = record as ControlEntryRecord;
112
+ return `sha256:${createHash("sha256").update(JSON.stringify(canonical(rest))).digest("hex")}`;
113
+ }
114
+
115
+ const ID = new RegExp(`^${CONTROL_ID_PREFIX}-[0-9]{3,}$`);
116
+
117
+ /** The problems with one parsed line, or [] when it is a record. */
118
+ export function controlEntryRecordProblems(v: unknown): string[] {
119
+ if (typeof v !== "object" || v === null || Array.isArray(v)) return ["not an object"];
120
+ const r = v as Record<string, unknown>;
121
+ const out: string[] = [];
122
+ if (r.version !== 1) out.push("version must be 1");
123
+ if (r.kind !== CONTROL_ENTRY_KIND) out.push(`kind must be ${CONTROL_ENTRY_KIND}`);
124
+ if (!(typeof r.id === "string" && ID.test(r.id))) out.push(`id must be ${CONTROL_ID_PREFIX}-<three digits or more>`);
125
+ if (!CONTROL_ENTRY_KINDS.includes(r.entry as ControlEntryKind)) out.push("entry must be project or defaults");
126
+ if (r.entry === "project" && !(typeof r.project === "string" && r.project.length > 0)) out.push("a project entry names its project");
127
+ if (r.entry === "defaults" && r.project !== null) out.push("the defaults name no project");
128
+ if (r.state !== "active" && r.state !== "retired") out.push("state must be active or retired");
129
+ if (typeof r.settings !== "object" || r.settings === null || Array.isArray(r.settings)) out.push("settings must be an object");
130
+ if (!(Array.isArray(r.estates) && r.estates.every((e) => typeof e === "string" && e.length > 0) && new Set(r.estates).size === r.estates.length)) out.push("estates must be distinct names");
131
+ if (r.entry === "defaults" && Array.isArray(r.estates) && r.estates.length > 0) out.push("the defaults own no estates");
132
+ if (!(typeof r.product === "string" && r.product.length > 0)) out.push("product must name the product that wrote it");
133
+ if (!(typeof r.at === "string" && !Number.isNaN(Date.parse(r.at)))) out.push("at must be a time");
134
+ if (r.by !== undefined && typeof r.by !== "string") out.push("by must be a string");
135
+ if (!(r.prev === null || typeof r.prev === "string")) out.push("prev must be a digest or null");
136
+ if (typeof r.digest !== "string") out.push("digest is missing");
137
+ else if (out.length === 0 && controlEntryDigest(r as unknown as ControlEntryRecord) !== r.digest) out.push("digest does not match the record");
138
+ return out;
139
+ }
140
+
141
+ /** Every line of the file, each a record or the problems that kept it out. */
142
+ export function parseControlEntries(text: string | null | undefined): { records: ControlEntryRecord[]; malformed: Array<{ line: number; problems: string[] }> } {
143
+ const records: ControlEntryRecord[] = [];
144
+ const malformed: Array<{ line: number; problems: string[] }> = [];
145
+ (text ?? "").split("\n").forEach((raw, i) => {
146
+ if (!raw.trim()) return;
147
+ let v: unknown;
148
+ try {
149
+ v = JSON.parse(raw);
150
+ } catch {
151
+ malformed.push({ line: i + 1, problems: ["not JSON"] });
152
+ return;
153
+ }
154
+ const problems = controlEntryRecordProblems(v);
155
+ if (problems.length > 0) malformed.push({ line: i + 1, problems });
156
+ else records.push(v as ControlEntryRecord);
157
+ });
158
+ return { records, malformed };
159
+ }
160
+
161
+ /** The key an entry is one of: its project, or `defaults`. */
162
+ function keyOf(r: Pick<ControlEntryRecord, "entry" | "project">): string {
163
+ return r.entry === "defaults" ? "defaults" : r.project!;
164
+ }
165
+
166
+ /**
167
+ * Each entry's current version from the log, oldest first: the newest line
168
+ * of each id, left out when it is retired. A version whose `prev` is not the
169
+ * digest of the one before it, or two active ids for one project (or for
170
+ * the defaults), is a problem.
171
+ */
172
+ export function currentControlEntries(records: readonly ControlEntryRecord[]): { entries: ControlEntry[]; problems: string[] } {
173
+ const problems: string[] = [];
174
+ const newest = new Map<string, ControlEntryRecord>();
175
+ for (const r of records) {
176
+ const before = newest.get(r.id);
177
+ if ((before?.digest ?? null) !== r.prev) problems.push(`${r.id} at ${r.at} replaces ${r.prev ?? "nothing"}, but its version before was ${before?.digest ?? "none"}`);
178
+ if (before && keyOf(before) !== keyOf(r)) problems.push(`${r.id} moved from ${keyOf(before)} to ${keyOf(r)}; an id keeps its project`);
179
+ newest.set(r.id, r);
180
+ }
181
+ const entries: ControlEntry[] = [];
182
+ const byKey = new Map<string, string>();
183
+ for (const r of newest.values()) {
184
+ if (r.state === "retired") continue;
185
+ const key = keyOf(r);
186
+ const prior = byKey.get(key);
187
+ if (prior) problems.push(`${key} has two active entries, ${prior} and ${r.id}; retire one`);
188
+ else byKey.set(key, r.id);
189
+ if (r.entry === "project") {
190
+ try {
191
+ parseProjectKey(r.project!);
192
+ } catch (e) {
193
+ problems.push(`${r.id}: ${(e as Error).message}`);
194
+ }
195
+ }
196
+ entries.push({
197
+ id: r.id,
198
+ entry: r.entry,
199
+ ...(r.project !== null ? { project: r.project } : {}),
200
+ settings: r.settings,
201
+ estates: r.estates,
202
+ digest: r.digest,
203
+ at: r.at,
204
+ ...(r.by !== undefined ? { by: r.by } : {}),
205
+ });
206
+ }
207
+ return { entries, problems };
208
+ }
209
+
210
+ /**
211
+ * Where the entries are read from and appended to. {@link gitControlLedger}
212
+ * is the control repo's `chant/lifecycle`; a test passes one in memory.
213
+ */
214
+ export interface ControlLedgerPort {
215
+ /** The file's text, or null when the branch or the file is absent. */
216
+ read(): Promise<string | null>;
217
+ /** Append one line, committed with `message`. Returns the commit. Does not push. */
218
+ append(line: string, message: string): Promise<string>;
219
+ }
220
+
221
+ /** The control repo's `_control/entries.jsonl` on its local `chant/lifecycle`, under the member prefix of `cwd`. */
222
+ export function gitControlLedger(opts: { cwd?: string } = {}): ControlLedgerPort {
223
+ return {
224
+ async read() {
225
+ const { readBlobFromPath } = await import("../lifecycle/git");
226
+ return readBlobFromPath(CONTROL_LEDGER_DIR, CONTROL_LEDGER_FILE, opts);
227
+ },
228
+ async append(line, message) {
229
+ const { appendLedgerLine } = await import("../lifecycle/git");
230
+ return appendLedgerLine(CONTROL_LEDGER_DIR, CONTROL_LEDGER_FILE, line, message, opts);
231
+ },
232
+ };
233
+ }
234
+
235
+ /** Checks one entry's settings the way the product's config would; returns the problems. */
236
+ export type ControlSettingsValidator = (entry: ControlEntryKind, project: string | undefined, settings: Record<string, unknown>) => string[];
237
+
238
+ /** What a read takes. */
239
+ export interface ReadControlEntriesOptions {
240
+ /** The product's check of each entry's settings. */
241
+ validate?: ControlSettingsValidator;
242
+ /** Read past malformed lines rather than refuse. Default false. */
243
+ lenient?: boolean;
244
+ }
245
+
246
+ /** The control repo's current entries, each checked. A problem anywhere refuses the read, unless `lenient`. */
247
+ export async function readControlEntries(port: ControlLedgerPort, opts: ReadControlEntriesOptions = {}): Promise<ControlEntry[]> {
248
+ const { records, malformed } = parseControlEntries(await port.read());
249
+ const { entries, problems } = currentControlEntries(records);
250
+ const all = [...malformed.map((m) => `${CONTROL_LEDGER_DIR}/${CONTROL_LEDGER_FILE}:${m.line}: ${m.problems.join(", ")}`), ...problems];
251
+ if (opts.validate) for (const e of entries) for (const p of opts.validate(e.entry, e.project, e.settings)) all.push(`${e.id} (${e.project ?? "defaults"}): ${p}`);
252
+ if (all.length > 0 && !opts.lenient) throw new ControlRecordsError(`the control repo's entries have ${all.length} problem(s):\n ${all.join("\n ")}`, all);
253
+ return entries;
254
+ }
255
+
256
+ /** The entries as a product's control config holds them: the defaults, and each project's settings by key. */
257
+ export function controlConfig(entries: readonly ControlEntry[]): { defaults?: Record<string, unknown>; projects: Record<string, Record<string, unknown>> } {
258
+ const defaults = entries.find((e) => e.entry === "defaults");
259
+ const projects: Record<string, Record<string, unknown>> = {};
260
+ for (const e of entries.filter((x) => x.entry === "project").sort((a, b) => a.project!.localeCompare(b.project!))) projects[e.project!] = e.settings;
261
+ return { ...(defaults ? { defaults: defaults.settings } : {}), projects };
262
+ }
263
+
264
+ /** Who claims each estate in the entries: estate name to project keys. Read at each plan; nothing is kept between plans. */
265
+ export function estateClaims(entries: readonly ControlEntry[]): Map<string, string[]> {
266
+ const claims = new Map<string, string[]>();
267
+ for (const e of entries) {
268
+ if (e.entry !== "project") continue;
269
+ for (const estate of e.estates) claims.set(estate, [...(claims.get(estate) ?? []), e.project!]);
270
+ }
271
+ return claims;
272
+ }
273
+
274
+ /** What a write takes besides the entry. */
275
+ export interface ControlWriteOptions {
276
+ /** The product writing it. */
277
+ product: string;
278
+ by?: string;
279
+ validate?: ControlSettingsValidator;
280
+ /** The digest the caller read the entry at. A write over a different current version is refused. */
281
+ expect?: string;
282
+ /** Build the line and check it, append nothing. */
283
+ dryRun?: boolean;
284
+ /** The clock. Default now. */
285
+ now?: () => Date;
286
+ }
287
+
288
+ /** One write's outcome. */
289
+ export interface ControlPutResult {
290
+ id: string;
291
+ /** created: a new entry. updated: a new version of the active one. unchanged: it already held these settings. retired: closed. */
292
+ status: "created" | "updated" | "unchanged" | "retired";
293
+ /** The version written, or the current one when unchanged. */
294
+ record?: ControlEntryRecord;
295
+ /** The ledger commit, when one was written. */
296
+ commit?: string;
297
+ }
298
+
299
+ const same = (a: unknown, b: unknown): boolean => JSON.stringify(canonical(a)) === JSON.stringify(canonical(b));
300
+
301
+ function nextId(records: readonly ControlEntryRecord[]): string {
302
+ const n = records.reduce((max, r) => Math.max(max, Number(r.id.slice(CONTROL_ID_PREFIX.length + 1))), 0) + 1;
303
+ return `${CONTROL_ID_PREFIX}-${String(n).padStart(3, "0")}`;
304
+ }
305
+
306
+ async function writeVersion(port: ControlLedgerPort, fields: Omit<ControlEntryRecord, "digest">, opts: ControlWriteOptions, message: string): Promise<{ record: ControlEntryRecord; commit?: string }> {
307
+ const record: ControlEntryRecord = { ...fields, digest: controlEntryDigest(fields) };
308
+ const problems = controlEntryRecordProblems(record);
309
+ if (problems.length > 0) throw new ControlRecordsError(`not a control entry: ${problems.join(", ")}`, problems);
310
+ if (opts.dryRun) return { record };
311
+ return { record, commit: await port.append(JSON.stringify(record), message) };
312
+ }
313
+
314
+ /**
315
+ * Creates the project's (or the defaults') entry, or writes a new version
316
+ * of the active one. With `expect`, a current version whose digest differs
317
+ * is refused ({@link ControlEntryConflict}). `estates` left out keeps the
318
+ * entry's.
319
+ */
320
+ export async function putControlEntry(
321
+ port: ControlLedgerPort,
322
+ want: { entry: ControlEntryKind; project?: string; settings: Record<string, unknown>; estates?: string[] },
323
+ opts: ControlWriteOptions,
324
+ ): Promise<ControlPutResult> {
325
+ if (want.entry === "project" && !want.project) throw new ControlRecordsError("a project entry needs the project's key");
326
+ if (want.entry === "defaults" && (want.project || want.estates?.length)) throw new ControlRecordsError("the defaults take no project key and own no estates");
327
+ if (want.entry === "project") parseProjectKey(want.project!);
328
+ const problems = opts.validate?.(want.entry, want.project, want.settings) ?? [];
329
+ if (problems.length > 0) throw new ControlRecordsError(`${want.project ?? "defaults"}: ${problems.join("; ")}`, problems);
330
+ const { records, malformed } = parseControlEntries(await port.read());
331
+ if (malformed.length > 0) throw new ControlRecordsError(`the control repo's entries have malformed lines (${malformed.map((m) => m.line).join(", ")}); fix them before writing`);
332
+ const { entries } = currentControlEntries(records);
333
+ const key = want.entry === "defaults" ? "defaults" : want.project!;
334
+ const current = entries.find((e) => (want.entry === "defaults" ? e.entry === "defaults" : e.project === want.project));
335
+ if (opts.expect !== undefined && opts.expect !== (current?.digest ?? "")) {
336
+ throw new ControlEntryConflict(`${key} changed since it was read (now ${current?.digest ?? "absent"}, read at ${opts.expect || "absent"}); read it again`);
337
+ }
338
+ const at = (opts.now ?? (() => new Date()))().toISOString();
339
+ const base = { version: 1 as const, kind: CONTROL_ENTRY_KIND as typeof CONTROL_ENTRY_KIND, product: opts.product, at, ...(opts.by !== undefined ? { by: opts.by } : {}) };
340
+ if (!current) {
341
+ const out = await writeVersion(
342
+ port,
343
+ { ...base, id: nextId(records), entry: want.entry, project: want.project ?? null, state: "active", settings: want.settings, estates: want.estates ?? [], prev: null },
344
+ opts,
345
+ `Control entry ${key} created`,
346
+ );
347
+ return { id: out.record.id, status: "created", ...out };
348
+ }
349
+ const estates = want.estates ?? current.estates;
350
+ if (same(current.settings, want.settings) && same(current.estates, estates)) return { id: current.id, status: "unchanged" };
351
+ const out = await writeVersion(
352
+ port,
353
+ { ...base, id: current.id, entry: current.entry, project: current.project ?? null, state: "active", settings: want.settings, estates, prev: current.digest },
354
+ opts,
355
+ `Control entry ${key} updated`,
356
+ );
357
+ return { id: current.id, status: "updated", ...out };
358
+ }
359
+
360
+ /** Retires a project's active entry: the closed state, so the project is no longer read. */
361
+ export async function retireControlEntry(port: ControlLedgerPort, project: string, opts: ControlWriteOptions): Promise<ControlPutResult> {
362
+ const { records } = parseControlEntries(await port.read());
363
+ const current = currentControlEntries(records).entries.find((e) => e.project === project);
364
+ if (!current) throw new ControlRecordsError(`no active entry for ${project} in the control repo`);
365
+ if (opts.expect !== undefined && opts.expect !== current.digest) throw new ControlEntryConflict(`${project} changed since it was read; read it again`);
366
+ const at = (opts.now ?? (() => new Date()))().toISOString();
367
+ const out = await writeVersion(
368
+ port,
369
+ { version: 1, kind: CONTROL_ENTRY_KIND, id: current.id, entry: "project", project, state: "retired", settings: current.settings, estates: current.estates, product: opts.product, at, ...(opts.by !== undefined ? { by: opts.by } : {}), prev: current.digest },
370
+ opts,
371
+ `Control entry ${project} retired`,
372
+ );
373
+ return { id: current.id, status: "retired", ...out };
374
+ }
375
+
376
+ /**
377
+ * Writes a control config (the defaults and each project's settings) as
378
+ * entries: one per project and one for the defaults. Moves a control repo
379
+ * off a config file, or off terragucci's record files, onto the ledger.
380
+ */
381
+ export async function importControlConfig(
382
+ port: ControlLedgerPort,
383
+ config: { defaults?: Record<string, unknown>; projects: Record<string, Record<string, unknown>>; estates?: Record<string, string[]> },
384
+ opts: ControlWriteOptions,
385
+ ): Promise<Array<ControlPutResult & { entry: string }>> {
386
+ if (Object.keys(config.projects).length === 0) throw new ControlRecordsError("only a control repo's config, which lists projects, becomes entries");
387
+ const out: Array<ControlPutResult & { entry: string }> = [];
388
+ const { expect: _one, ...each } = opts;
389
+ if (config.defaults) out.push({ entry: "defaults", ...(await putControlEntry(port, { entry: "defaults", settings: config.defaults }, each)) });
390
+ for (const [project, settings] of Object.entries(config.projects)) {
391
+ const estates = config.estates?.[project];
392
+ out.push({ entry: project, ...(await putControlEntry(port, { entry: "project", project, settings, ...(estates ? { estates } : {}) }, each)) });
393
+ }
394
+ return out;
395
+ }
@@ -4,6 +4,7 @@ import { createRequire } from "node:module";
4
4
  import { tmpdir } from "node:os";
5
5
  import { dirname, join, resolve as resolvePath } from "node:path";
6
6
  import { SOURCE_EXPORT_CONDITIONS } from "../../module-source";
7
+ import { chantPackageSourceTarget } from "../../ts-loader";
7
8
 
8
9
  /**
9
10
  * chant #1045 Phase 2 — bundles the generated sandbox driver (`./driver.ts`)
@@ -185,6 +186,29 @@ function externalTrustedPackagesPlugin(): { plugin: esbuild.Plugin; readPaths: s
185
186
  return { plugin, readPaths };
186
187
  }
187
188
 
189
+ /**
190
+ * chant#4591: chant core's exports give an ESM import its compiled
191
+ * `dist/*.js` (the `import` condition), so a product can load the installed
192
+ * chant under plain Node. esbuild always matches `import`. The driver names
193
+ * chant's own modules by their `src/*.ts` path (`chantSourceDir`), so a
194
+ * project's or a compiled lexicon's import of `@intentius/chant` has to land
195
+ * on that same source, or the bundle carries a second copy of core with its
196
+ * own registries and classes. Lexicons are left alone: they bundle from the
197
+ * `dist/*.js` they ship, as before.
198
+ */
199
+ function chantCoreSourcePlugin(): esbuild.Plugin {
200
+ return {
201
+ name: "chant-sandbox-core-source",
202
+ setup(build) {
203
+ build.onResolve({ filter: /^@intentius\/chant(?:\/.*)?$/ }, (args) => {
204
+ if (!args.importer) return undefined;
205
+ const target = chantPackageSourceTarget(args.path, args.importer);
206
+ return target === undefined ? undefined : { path: target };
207
+ });
208
+ },
209
+ };
210
+ }
211
+
188
212
  export interface BundleResult {
189
213
  /** Absolute, REALPATH'd path to the bundled entry file — this and {@link bundleDir} are what the caller grants `--allow-fs-read` to. macOS's `/tmp` is a symlink to `/private/tmp`; an un-canonicalized path here would silently fail to match Node's own (already-canonicalized) permission check. */
190
214
  bundlePath: string;
@@ -225,7 +249,7 @@ export async function bundleDriver(driverSource: string): Promise<BundleResult>
225
249
  // Setting `conditions` replaces esbuild's default ["module"], so it is
226
250
  // kept, and compiled the option is left out as before.
227
251
  ...(SOURCE_EXPORT_CONDITIONS.length > 0 ? { conditions: ["module", ...SOURCE_EXPORT_CONDITIONS] } : {}),
228
- plugins: [plugin],
252
+ plugins: [chantCoreSourcePlugin(), plugin],
229
253
  });
230
254
  } catch (err) {
231
255
  rmSync(bundleDir, { recursive: true, force: true });
@@ -3,7 +3,6 @@ import { describe, it, expect } from "vitest";
3
3
  import { buildGraphIr, buildLiveGraphIr, entityFacts, sourceOverlayGraphs, type GraphIR, type LiveObservation } from "./graph-ir";
4
4
  import { DECLARABLE_MARKER, type Declarable } from "./declarable";
5
5
  import { ENGINE_FACTS_FLOOR, type EngineFacts } from "./engine-facts";
6
- import { NEXT_RELEASE } from "./release-floors";
7
6
 
8
7
  const facts: EngineFacts = {
9
8
  ownership: "bound",
@@ -172,7 +171,7 @@ describe("buildGraphIr: an entity's facts and reference grain (#4529)", () => {
172
171
  ]);
173
172
  });
174
173
 
175
- it("names its floor as the next release", () => {
176
- expect(ENGINE_FACTS_FLOOR).toBe(NEXT_RELEASE);
174
+ it("names its floor as 0.124.54, where it shipped", () => {
175
+ expect(ENGINE_FACTS_FLOOR).toBe("0.124.54");
177
176
  });
178
177
  });
@@ -17,7 +17,6 @@
17
17
  * types and ./lifecycle/index-document.ts (`npm run generate:graph-schema`).
18
18
  */
19
19
  import type { GraphIR } from "./graph-ir";
20
- import { NEXT_RELEASE } from "./release-floors";
21
20
 
22
21
  /** The format of {@link EngineGraphMeta}. Moves only for a change a reader could not ignore. */
23
22
  export const ENGINE_GRAPH_FORMAT = 1;
@@ -32,7 +31,7 @@ export const ENGINE_GRAPH_FORMAT = 1;
32
31
  * engine side's floor for the terraform read is that lexicon's
33
32
  * `MIN_CHOUDOUFU_GRAPH_VERSION`.
34
33
  */
35
- export const ENGINE_FACTS_FLOOR = NEXT_RELEASE;
34
+ export const ENGINE_FACTS_FLOOR = "0.124.54";
36
35
 
37
36
  /** The marker values an engine read or recorded for one node. */
38
37
  export interface EngineMarkers {
@@ -0,0 +1,31 @@
1
+ import { describe, expect, test } from "vitest";
2
+ import { CHANT_EXIT, chantExitName } from "./exit-codes";
3
+ import { PLAN_MOVED_EXIT_CODE, isPlanMovedError } from "./components/capability";
4
+ import { GATED_EXIT_CODE } from "./cli/handlers/run";
5
+ import { DRIFT_EXIT_CODE } from "./op/types";
6
+ import { PR_ENV_EXIT } from "./components/pr-environment";
7
+
8
+ describe("the exit-code table (#4553)", () => {
9
+ test("has one name per code, 0 to 8", () => {
10
+ expect(Object.values(CHANT_EXIT)).toEqual([0, 1, 2, 3, 4, 5, 6, 7, 8]);
11
+ expect(chantExitName(4)).toBe("moved");
12
+ expect(chantExitName(40)).toBeUndefined();
13
+ });
14
+
15
+ test("a moved plan exits apart from a waiting run", () => {
16
+ expect(PLAN_MOVED_EXIT_CODE).toBe(CHANT_EXIT.moved);
17
+ expect(GATED_EXIT_CODE).toBe(CHANT_EXIT.waiting);
18
+ expect(PLAN_MOVED_EXIT_CODE).not.toBe(GATED_EXIT_CODE);
19
+ });
20
+
21
+ test("the commands that kept their own constant take them from the table", () => {
22
+ expect(DRIFT_EXIT_CODE).toBe(CHANT_EXIT.drift);
23
+ expect(PR_ENV_EXIT).toEqual({ done: 0, failed: 1, waiting: 3, held: 5 });
24
+ });
25
+
26
+ test("an error marked with the old moved code still reads as moved, and 4 on its own does not", () => {
27
+ expect(isPlanMovedError({ planMoved: true })).toBe(true);
28
+ expect(isPlanMovedError({ exitCode: 3 })).toBe(true);
29
+ expect(isPlanMovedError({ exitCode: 4 })).toBe(false);
30
+ });
31
+ });
@@ -0,0 +1,55 @@
1
+ /**
2
+ * chant's one exit-code table (#4553), for every command that runs, gates or
3
+ * applies a plan, and for both products built on chant CI (terragucci and
4
+ * plywood). The terraform, pulumi and sql lexicons map their engines' own codes
5
+ * onto it (`terraformExitOf` in `@intentius/chant-lexicon-terraform/exit-codes`,
6
+ * `pulumiExitOf` in `@intentius/chant-lexicon-pulumi`, `sqlExitOf` in
7
+ * `@intentius/chant-lexicon-sql/exit-codes`), and a product passes
8
+ * the code through unchanged.
9
+ *
10
+ * The numbers are the ones op waves already used, so a pipeline reading op
11
+ * waves' 3 to 8 sees no change. A moved plan is 4 and a waiting run 3; before
12
+ * this table both were 3 outside op waves.
13
+ *
14
+ * A usage or config error has no code of its own: it is `failed`, 1.
15
+ *
16
+ * The reference page is docs/src/content/docs/reference/exit-codes.mdx.
17
+ */
18
+ export const CHANT_EXIT = {
19
+ /** Applied, or nothing to do. */
20
+ done: 0,
21
+ /** Something broke, and no approval changes it. Usage and config errors too. */
22
+ failed: 1,
23
+ /** A run asked to fail on drift found some (`--fail-on-drift`, `failOn: "drift"`). */
24
+ drift: 2,
25
+ /**
26
+ * Stopped for a person: a gate, an open decision point, a review that does
27
+ * not count yet, unmet requires, an earlier wave waiting, no pull request
28
+ * found. The only code `--gated-exit` remaps.
29
+ */
30
+ waiting: 3,
31
+ /** An approved plan no longer matches the plan that would apply now, so nothing applied. */
32
+ moved: 4,
33
+ /** Another run or open pull request holds a lock on a target or resource this changes, so nothing applied. */
34
+ held: 5,
35
+ /** A newer push applies instead. */
36
+ superseded: 6,
37
+ /** The policy denied the plan and no override counts, at plan and at apply. */
38
+ denied: 7,
39
+ /** A decision point answered with an answer the gate does not pass on. */
40
+ declined: 8,
41
+ } as const;
42
+
43
+ /** A name in {@link CHANT_EXIT}. */
44
+ export type ChantExitName = keyof typeof CHANT_EXIT;
45
+
46
+ /** A code in {@link CHANT_EXIT}. */
47
+ export type ChantExitCode = (typeof CHANT_EXIT)[ChantExitName];
48
+
49
+ /** The name of `code` in {@link CHANT_EXIT}, or `undefined` for a code outside the table. */
50
+ export function chantExitName(code: number): ChantExitName | undefined {
51
+ for (const [name, value] of Object.entries(CHANT_EXIT)) {
52
+ if (value === code) return name as ChantExitName;
53
+ }
54
+ return undefined;
55
+ }