@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
@@ -33,6 +33,54 @@ import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
33
33
  import { tmpdir } from "node:os";
34
34
  import { join } from "node:path";
35
35
 
36
+ // `ci.policy.source` (#4613): its shape and check, here so this module
37
+ // bundles alone (#4294). `./policy-source.ts` fetches it.
38
+
39
+ /** `ci.policy.source`: where the shared rules live. */
40
+ export interface GatePolicySource {
41
+ /** The repository: an `https://`, `http://`, `ssh://` or `file://` URL, or `git@<host>:<path>`. */
42
+ repo: string;
43
+ /** A tag, a branch or a full commit. */
44
+ ref: string;
45
+ /** The Rego directory inside the repository. Default `policy`. */
46
+ path?: string;
47
+ }
48
+
49
+ /** The source as fetched: what a report and a decision record. */
50
+ export interface ResolvedGatePolicySource {
51
+ /** The repository, with any user and password left out. */
52
+ repo: string;
53
+ ref: string;
54
+ /** The commit the ref named when the job fetched it. */
55
+ commit: string;
56
+ /** The Rego directory inside the repository. */
57
+ path: string;
58
+ }
59
+
60
+ const REPO = /^(https?:\/\/[^\s/]+\/\S+|ssh:\/\/[^\s/]+\/\S+|file:\/\/\/?\S+|[A-Za-z0-9._-]+@[A-Za-z0-9.-]+:\S+)$/;
61
+ const REF = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;
62
+
63
+ /** `source`, checked. Throws with what is wrong. `where` names it, such as `ci.policy.source`. */
64
+ export function assertGatePolicySource(where: string, raw: unknown): asserts raw is GatePolicySource {
65
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`${where} must be { repo, ref, path? }`);
66
+ const o = raw as Record<string, unknown>;
67
+ for (const key of Object.keys(o)) {
68
+ if (key !== "repo" && key !== "ref" && key !== "path") throw new Error(`${where}.${key} is not a setting; the settings are repo, ref and path`);
69
+ }
70
+ if (typeof o.repo !== "string" || !REPO.test(o.repo) || o.repo.startsWith("-")) {
71
+ throw new Error(`${where}.repo must be a git URL (https://, ssh://, file:// or git@<host>:<path>)`);
72
+ }
73
+ if (typeof o.ref !== "string" || !REF.test(o.ref) || o.ref.includes("..") || o.ref.endsWith("/")) {
74
+ throw new Error(`${where}.ref must be a tag, a branch or a commit`);
75
+ }
76
+ if (o.path !== undefined) {
77
+ if (typeof o.path !== "string" || o.path.trim() === "") throw new Error(`${where}.path must be a non-empty string`);
78
+ if (o.path.startsWith("/") || o.path.split("/").includes("..")) throw new Error(`${where}.path must be a directory inside the source repository`);
79
+ }
80
+ }
81
+
82
+
83
+
36
84
  /** The result shapes chant reads: conftest's and OPA's. */
37
85
  export const GATE_POLICY_ENGINES = ["conftest", "opa"] as const;
38
86
  export type GatePolicyEngine = (typeof GATE_POLICY_ENGINES)[number];
@@ -44,8 +92,26 @@ export const DEFAULT_POLICY_PATH = "policy";
44
92
  export interface GatePolicySettings {
45
93
  /** The result shape, and the default command. Default `conftest`. */
46
94
  engine?: GatePolicyEngine;
47
- /** The policy directory, relative to the declaration at base. Default {@link DEFAULT_POLICY_PATH}. */
95
+ /**
96
+ * The policy directory, relative to the declaration at base. Default
97
+ * {@link DEFAULT_POLICY_PATH}. Refused beside `source`, whose own `path`
98
+ * names the directory inside the shared repository.
99
+ */
48
100
  path?: string;
101
+ /**
102
+ * A shared policy repository pinned by ref (#4613), read in place of the
103
+ * workspace's own directory. The ref is fetched by the job, never taken
104
+ * from the pull request's head.
105
+ */
106
+ source?: GatePolicySource;
107
+ /**
108
+ * CrossGuard packs every Pulumi stack's preview runs (#4613): each `dir`
109
+ * relative to the declaration at base, or to the top of `source` when it
110
+ * is set, and copied from there, so a pull request cannot drop or edit
111
+ * the packs that judge it. `config` is the pack's
112
+ * `--policy-pack-config` file, read the same way.
113
+ */
114
+ packs?: GatePolicyPack[];
49
115
  /** The package to read. conftest default: every namespace. opa default: `main`. */
50
116
  namespace?: string;
51
117
  /**
@@ -56,6 +122,12 @@ export interface GatePolicySettings {
56
122
  command?: string[];
57
123
  }
58
124
 
125
+ /** One CrossGuard pack named by `ci.policy.packs`. */
126
+ export interface GatePolicyPack {
127
+ dir: string;
128
+ config?: string;
129
+ }
130
+
59
131
  /** A rule that matched, and what it said. */
60
132
  export interface GatePolicyFinding {
61
133
  /** `<package>.<rule>`, such as `main.deny_public_bucket`. */
@@ -83,6 +155,8 @@ export interface GatePolicyVerdict {
83
155
  holds: GatePolicyFinding[];
84
156
  warnings: string[];
85
157
  error?: string;
158
+ /** The shared source the rules came from (#4613), with the commit read. Absent when they came from the workspace at base. */
159
+ source?: ResolvedGatePolicySource;
86
160
  }
87
161
 
88
162
  export const DENY_RULE = /^(deny|violation)(_[A-Za-z0-9]+)*$/;
@@ -279,20 +353,35 @@ export function exportGatePolicy(tree: GatePolicyTree, path: string): { dir: str
279
353
 
280
354
  /** The settings, checked. Throws with what is wrong. `where` names them, such as `ci.policy`. */
281
355
  export function assertGatePolicySettings(where: string, raw: unknown): asserts raw is GatePolicySettings {
282
- if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`${where} must be { engine?, path?, namespace?, command? }`);
356
+ if (raw === null || typeof raw !== "object" || Array.isArray(raw)) throw new Error(`${where} must be { engine?, path?, source?, namespace?, command?, packs? }`);
357
+ if ("path" in raw && "source" in raw) throw new Error(`${where}.path and ${where}.source cannot both be set; with a source, ${where}.source.path names the directory inside it`);
283
358
  for (const [key, value] of Object.entries(raw)) {
284
359
  if (key === "engine") {
285
360
  if (!(GATE_POLICY_ENGINES as readonly unknown[]).includes(value)) throw new Error(`${where}.engine must be ${GATE_POLICY_ENGINES.join(" or ")}, the result shape the command prints`);
286
361
  } else if (key === "path" || key === "namespace") {
287
362
  if (typeof value !== "string" || value.trim() === "") throw new Error(`${where}.${key} must be a non-empty string`);
288
363
  if (key === "path" && (value.startsWith("/") || value.split("/").includes(".."))) throw new Error(`${where}.path must be a directory inside the workspace, relative to its declaration`);
364
+ } else if (key === "source") {
365
+ assertGatePolicySource(`${where}.source`, value);
366
+ } else if (key === "packs") {
367
+ if (!Array.isArray(value) || value.length === 0) throw new Error(`${where}.packs must be a non-empty list of { dir, config? }`);
368
+ value.forEach((p: unknown, i: number) => {
369
+ const at = `${where}.packs[${i}]`;
370
+ if (p === null || typeof p !== "object" || Array.isArray(p)) throw new Error(`${at} must be { dir, config? }`);
371
+ for (const [k, v] of Object.entries(p)) {
372
+ if (k !== "dir" && k !== "config") throw new Error(`${at}.${k} is not a setting; the settings are dir and config`);
373
+ if (typeof v !== "string" || v.trim() === "") throw new Error(`${at}.${k} must be a non-empty string`);
374
+ if (v.startsWith("/") || v.split("/").includes("..")) throw new Error(`${at}.${k} must be a path inside the workspace, or inside the source when one is set`);
375
+ }
376
+ if (typeof (p as { dir?: unknown }).dir !== "string") throw new Error(`${at}.dir is required`);
377
+ });
289
378
  } else if (key === "command") {
290
379
  if (!Array.isArray(value) || value.length === 0 || !value.every((a) => typeof a === "string" && a !== "")) throw new Error(`${where}.command must be argv, a non-empty list of strings`);
291
380
  if (!value.some((a: string) => a.includes("{input}"))) throw new Error(`${where}.command must pass the input file as {input}`);
292
381
  } else if (key === "outcomes" || key === "allow_unattended" || key === "allowUnattended") {
293
382
  throw new Error(`${where}.${key}: chant's policy step denies and holds only; a non-empty plan always waits for a person (ws-104), so there is no unattended outcome`);
294
383
  } else {
295
- throw new Error(`${where}.${key} is not a setting; the settings are engine, path, namespace and command`);
384
+ throw new Error(`${where}.${key} is not a setting; the settings are engine, path, source, namespace, command and packs`);
296
385
  }
297
386
  }
298
387
  }
@@ -48,7 +48,6 @@ describe("the gated-wave bundle", () => {
48
48
  "packages/core/src/intrinsic.ts",
49
49
  "packages/core/src/lifecycle/plan-digest.ts",
50
50
  // The next-release floor constant (#4480): no imports.
51
- "packages/core/src/release-floors.ts",
52
51
  ]);
53
52
  expect(bytes).toBeLessThan(24 * 1024);
54
53
  });
package/src/index.ts CHANGED
@@ -161,3 +161,5 @@ export * from "./run-event";
161
161
  export { Op, phase, activity, gate, kubectlApply, helmInstall, waitForStack,
162
162
  gitlabPipeline, lifecycleSnapshot, shell, teardown, OpResource } from "./op/index";
163
163
  export type { OpConfig, PhaseDefinition, StepDefinition, ActivityStep, GateStep } from "./op/index";
164
+ // The exit-code table (#4553): one set of codes for every command and both products.
165
+ export { CHANT_EXIT, chantExitName, type ChantExitCode, type ChantExitName } from "./exit-codes";
package/src/lexicon.ts CHANGED
@@ -1,4 +1,6 @@
1
1
  import type { InstanceObservation } from "./instance-nodes";
2
+ import type { CiRunner } from "./ci-jobs";
3
+ import type { OpAgentSpec } from "./ci-agent";
2
4
  import type { EngineFacts } from "./engine-facts";
3
5
  import type { CapabilityPack } from "./capabilities/view";
4
6
  import type { Serializer } from "./serializer";
@@ -14,6 +16,7 @@ import type { ArtifactIntegrity } from "./lexicon-integrity";
14
16
  import type { GatedWavePipelineOptions } from "./components/gated-wave-pipeline";
15
17
  import type { PrLoopPipelineOptions } from "./components/pr-pipeline";
16
18
  import type { OpWaveJob, OpWavesSpec } from "./op/op-waves";
19
+ import type { ChangeSetDocument } from "./change-set";
17
20
  import type { OkfFile } from "./okf";
18
21
  import type { CompletionContext, CompletionItem, HoverContext, HoverInfo, CodeActionContext, CodeAction } from "./lsp/types";
19
22
  import type { McpToolContribution, McpResourceContribution } from "./mcp/types";
@@ -73,6 +76,7 @@ export type { ReferenceCatalog, IdentityRule, RefRule } from "./graph-refs";
73
76
  // An observation can report relationships (#1271/#1273), so a lexicon needs the
74
77
  // edge type from the same entry it imports the plugin contract from.
75
78
  export type { IREdge } from "./graph-ir";
79
+ export type { OpAgentSpec } from "./ci-agent";
76
80
 
77
81
  // The observation contract (#1089), re-exported from the same entry so a
78
82
  // lexicon's `describeResources` can report NOT-OBSERVED without a second
@@ -905,13 +909,31 @@ export interface ScheduledOpSpec {
905
909
  * token (the checkout's fetches get the job's token and nothing after
906
910
  * them does) and hands the review on as job outputs. The second checks
907
911
  * nothing out, takes the review as data and posts it as one note with the
908
- * write token (`postReviewNote`). GitHub and Forgejo only: a GitLab merge
909
- * request pipeline hands every job the project's unprotected variables, so
910
- * the gitlab generator refuses this by name. The trigger must be
911
- * `pull_request` and the finding-mode `report`, since the first job posts
912
- * nothing.
912
+ * write token (`postReviewNote`). On GitLab (#4544) the first job keeps the
913
+ * review as an artifact of the merge request pipeline, and the second runs
914
+ * in a pipeline of the default branch, started by a schedule with
915
+ * `CHANT_REVIEW_NOTES` set to `1`, which holds the protected token and posts
916
+ * every open merge request's review (`postOpenReviewNotes`). The trigger
917
+ * must be `pull_request` and the finding-mode `report`, since the first job
918
+ * posts nothing.
913
919
  */
914
920
  reviewAgent?: boolean;
921
+ /**
922
+ * Where this Op's generated jobs run (#4616): a runner label, a list of
923
+ * labels, or on GitHub a runner group, as an Op wave's `runner` (#3914).
924
+ * `runs-on` on GitHub and Forgejo, `tags` on GitLab; a runner group on
925
+ * GitLab or Forgejo is refused. Default: the forge's default runner.
926
+ */
927
+ runner?: CiRunner;
928
+ /**
929
+ * The agent jobs (#4616, ../ci-agent.ts). `on: "comment"`: this spec is the
930
+ * agent's own workflow, answering `/<product> agent <ask>` on a pull
931
+ * request, and `trigger` is not read. `on: "drift"`: the agent and push
932
+ * jobs follow this Op's job and run when its run exits with chant's
933
+ * `drift` code, opening or updating a pull request from the agent's
934
+ * branch. The model's job holds no write token; the push job does.
935
+ */
936
+ agent?: OpAgentSpec;
915
937
  }
916
938
 
917
939
  /**
@@ -976,6 +998,19 @@ export interface OpWavesPipelineOptions
976
998
  extends Pick<ComponentPipelineOptions, "image" | "beforeScript" | "extraScript" | "variables" | "opsStage" | "opsFileName"> {
977
999
  /** The spec's path from the repository root. Every job runs `chant run wave --spec <specFile>`. */
978
1000
  specFile: string;
1001
+ /**
1002
+ * The command every job runs in place of `chant` (#4607): a product's
1003
+ * `words.bin`, such as `npx --no-install plywood`. `chant run --generate`
1004
+ * fills it from the active product words, so a product's bin that runs
1005
+ * the generator in process gets its own bin in the jobs. Absent: `chant`.
1006
+ */
1007
+ bin?: string;
1008
+ /**
1009
+ * The product's words (#4617), for the control dispatch a spec's
1010
+ * `control` adds: its event type and messages. `chant run --generate`
1011
+ * fills it from the active product words. Absent: chant's.
1012
+ */
1013
+ words?: import("./ci-product-words").CiProductWordsInput | import("./ci-product-words").CiProductWords;
979
1014
  }
980
1015
 
981
1016
  /** An Op waves pipeline: one file, and its jobs in order. */
@@ -1443,6 +1478,56 @@ export interface LexiconPlugin {
1443
1478
  */
1444
1479
  generateOpWavesPipeline?(spec: OpWavesSpec, options: OpWavesPipelineOptions): OpWavesPipelineResult;
1445
1480
 
1481
+ /**
1482
+ * The shell lines that install this lexicon's engine into the default CI
1483
+ * image (#4550): OpenTofu, and choudoufu where a member uses it, for
1484
+ * terraform; Pulumi, or plunge where the member's engine is plunge, for
1485
+ * pulumi. The pull request pipeline joins the lines of the lexicons its
1486
+ * project lists, in place of installing OpenTofu for everyone. A caller's
1487
+ * own image turns them off. `dir` is the project the pipeline is for.
1488
+ * Return none when the project needs nothing from this lexicon.
1489
+ */
1490
+ ciSetup?(ctx: { dir: string }): string[];
1491
+
1492
+ /**
1493
+ * The job services this lexicon's CI jobs start beside them (#4572,
1494
+ * `./components/ci-services.ts`): throwaway servers such as the sql
1495
+ * lexicon's replay server per dialect, each image pinned by the lexicon.
1496
+ * A product's job renders them for its forge. `dir` is the project the
1497
+ * pipeline is for. Return none when the project needs none.
1498
+ */
1499
+ ciServices?(ctx: { dir: string }): import("./components/ci-services").CiService[];
1500
+
1501
+ /**
1502
+ * A section of the pull request note for one member (#4573): rows a
1503
+ * resource table does not carry, rendered from the member's own part of
1504
+ * the change set, such as a SQL member's statements with their class, the
1505
+ * policy outcome per rule and its override line. chant places it under the
1506
+ * member table, in a collapsed block, and leaves it out when the note would
1507
+ * pass the forge's comment limit. Undefined for a member it has nothing for.
1508
+ */
1509
+ prNoteDetail?(input: { member: string; changeSet: ChangeSetDocument; stage: "plan" | "apply" | "record" }): { title?: string; lines: string[] } | undefined | Promise<{ title?: string; lines: string[] } | undefined>;
1510
+
1511
+ /**
1512
+ * Whether `ci.prEnvironment.template` names one of this lexicon's own
1513
+ * stacks rather than a chant.config.ts environment (#4609). The pulumi
1514
+ * lexicon takes `<project>/<stack>`, plywood's `review_stacks.template`.
1515
+ * Returns a short description of the stack when it does, for the log line,
1516
+ * and undefined when it does not, so `pr-env up` checks the template
1517
+ * against the declared environments as before.
1518
+ */
1519
+ prEnvTemplate?(template: string): string | undefined;
1520
+
1521
+ /**
1522
+ * A teardown for what this lexicon made in a pull request's environment
1523
+ * and its own `teardownOwned` does not reach (#4609): the pulumi lexicon
1524
+ * removes each review stack `pr-<n>` the environment's record names in
1525
+ * `locations`. `pr-env down` and `sweep` run it beside the lexicons'
1526
+ * teardowns, under the same marker check. `cwd` is the project root the
1527
+ * locations are relative to.
1528
+ */
1529
+ prEnvTeardown?(ctx: { cwd: string }): import("./components/pr-environment").PrEnvTeardownAdapter | undefined;
1530
+
1446
1531
  /**
1447
1532
  * Host Op runs — the seam `chant run <op> --on <this lexicon>` dispatches to
1448
1533
  * (#2121, epic #2114). Core ships one provider of its own, `local`, and
@@ -1603,7 +1688,11 @@ export interface LexiconPlugin {
1603
1688
  composites?(): CompositeEntry[];
1604
1689
 
1605
1690
  // MCP
1606
- /** Return MCP tool contributions */
1691
+ /**
1692
+ * Return MCP tool contributions. A tool is served by
1693
+ * `chant serve mcp --read-only` only when it sets `readOnly: true`
1694
+ * (chant#4543); the flag is a promise that the tool changes nothing.
1695
+ */
1607
1696
  mcpTools?(): McpToolContribution[];
1608
1697
 
1609
1698
  /** Return MCP resource contributions */
@@ -22,12 +22,11 @@
22
22
  * `chant import --index ... --adopt-out <file>` writes one from the import
23
23
  * report ({@link adoptionFileFromImportReport}).
24
24
  */
25
- import { NEXT_RELEASE } from "../release-floors";
26
25
  import { indexVersionName, type IndexDocument } from "./index-document";
27
26
  import type { IndexImportReport } from "./index-import";
28
27
 
29
28
  /** The first chant that writes or reads an adoption file. */
30
- export const ADOPTION_FILE_FLOOR = NEXT_RELEASE;
29
+ export const ADOPTION_FILE_FLOOR = "0.124.54";
31
30
 
32
31
  /** The index version an adoption file reads from. */
33
32
  export interface AdoptionIndexRef {
@@ -29,7 +29,6 @@ import {
29
29
  type SubstrateTarget,
30
30
  } from "./cloud-index";
31
31
  import type { IndexDocument } from "./index-document";
32
- import { NEXT_RELEASE } from "../release-floors";
33
32
  import { createSnapshotStore } from "./snapshot-store";
34
33
 
35
34
  const ACCOUNT = "000000000000";
@@ -141,8 +140,8 @@ function capture() {
141
140
  const noLexicons: RunCloudIndexOptions["lexicons"] = async () => ({ lexicons: [] });
142
141
 
143
142
  describe("the floor", () => {
144
- it("names the next release", () => {
145
- expect(CLOUD_INDEX_FLOOR).toBe(NEXT_RELEASE);
143
+ it("names 0.124.54, where it shipped", () => {
144
+ expect(CLOUD_INDEX_FLOOR).toBe("0.124.54");
146
145
  });
147
146
  });
148
147
 
@@ -94,14 +94,13 @@ import {
94
94
  type SubstrateTarget,
95
95
  } from "../cloud-lister/index";
96
96
  import type { TlsOptions } from "../cloud-lister/transport";
97
- import { NEXT_RELEASE } from "../release-floors";
98
97
  import { deriveEdges, type EdgeLexicon } from "./derive-edges";
99
98
  import type { IndexDocument } from "./index-document";
100
99
  import { createSnapshotStore, resolveSnapshotStore, snapshotStoreConfig, type SnapshotStore, type StoreWrite } from "./snapshot-store";
101
100
  import { typeListing, type ListingLexicon } from "./type-listing";
102
101
 
103
102
  /** The first chant with `chant index` and {@link runCloudIndex} / {@link indexCloud}. */
104
- export const CLOUD_INDEX_FLOOR = NEXT_RELEASE;
103
+ export const CLOUD_INDEX_FLOOR = "0.124.54";
105
104
 
106
105
  /** What typing and edge derivation read from a lexicon. A `LexiconPlugin` is one. */
107
106
  export type IndexLexicon = ListingLexicon & EdgeLexicon;
@@ -0,0 +1,70 @@
1
+ /**
2
+ * #4593: the control repo's `_control/entries.jsonl` (#4568) as the
3
+ * `control_entries` table of read contract v1, in `chant query` and
4
+ * `chant ledger`, over a fixture ledger.
5
+ */
6
+
7
+ import { describe, expect, test } from "vitest";
8
+ import { controlEntryDigest, type ControlEntryRecord } from "../control/records";
9
+ import { NEXT_RELEASE } from "../release-floors";
10
+ import type { LedgerReadPort } from "./ledger-port";
11
+ import { ledgerFields, LEDGER_TABLES, LEDGER_TIME_COLUMN } from "./ledger-read";
12
+ import { LEDGER_CONTROL_ENTRIES_FLOOR, loadQueryData, QUERY_TABLES, runQuery } from "./query";
13
+
14
+ function port(files: Record<string, string>): LedgerReadPort {
15
+ return {
16
+ read: async (dir, file) => files[`${dir}/${file}`] ?? null,
17
+ list: async (dir) => Object.keys(files).filter((p) => p.startsWith(`${dir}/`)).map((p) => p.slice(dir.length + 1)),
18
+ trees: async () => [...new Set(Object.keys(files).map((p) => p.slice(0, p.indexOf("/"))))],
19
+ };
20
+ }
21
+
22
+ function record(fields: Omit<ControlEntryRecord, "digest" | "version" | "kind">): ControlEntryRecord {
23
+ const body = { version: 1 as const, kind: "control-entry" as const, ...fields };
24
+ return { ...body, digest: controlEntryDigest(body) };
25
+ }
26
+
27
+ const project = "github.com/acme/network";
28
+ const v1 = record({ id: "ctl-001", entry: "project", project, state: "active", settings: { waves: ["dev"] }, estates: ["net"], product: "terragucci", at: "2026-10-27T10:00:00Z", by: "github:alice", prev: null });
29
+ const v2 = record({ id: "ctl-001", entry: "project", project, state: "active", settings: { waves: ["dev", "prod"] }, estates: ["net"], product: "terragucci", at: "2026-10-27T11:00:00Z", prev: v1.digest });
30
+ const defaults = record({ id: "ctl-002", entry: "defaults", project: null, state: "active", settings: { lockGrain: "target" }, estates: [], product: "plywood", at: "2026-10-27T10:30:00Z", prev: null });
31
+ const tampered = { ...defaults, settings: { lockGrain: "repo" } };
32
+
33
+ const FIXTURE = {
34
+ "_control/entries.jsonl": [v1, defaults, v2, tampered].map((r) => JSON.stringify(r)).join("\n") + "\nnot json\n",
35
+ };
36
+
37
+ describe("control_entries", () => {
38
+ test("one row per version, with its digest, the digest it replaced and whether it is current", async () => {
39
+ const { data, malformed } = await loadQueryData([{ member: "control", port: port(FIXTURE) }]);
40
+ expect(data.control_entries).toEqual([
41
+ { member: "control", id: "ctl-001", entry: "project", project, state: "active", product: "terragucci", settings: JSON.stringify({ waves: ["dev"] }), estates: JSON.stringify(["net"]), by: "github:alice", timestamp: v1.at, digest: v1.digest, prev_digest: null, current: 0 },
42
+ { member: "control", id: "ctl-002", entry: "defaults", project: null, state: "active", product: "plywood", settings: JSON.stringify({ lockGrain: "target" }), estates: "[]", by: null, timestamp: defaults.at, digest: defaults.digest, prev_digest: null, current: 1 },
43
+ { member: "control", id: "ctl-001", entry: "project", project, state: "active", product: "terragucci", settings: JSON.stringify({ waves: ["dev", "prod"] }), estates: JSON.stringify(["net"]), by: null, timestamp: v2.at, digest: v2.digest, prev_digest: v1.digest, current: 1 },
44
+ ]);
45
+ // The tampered line (its digest no longer matches) and the line that is not JSON.
46
+ expect(malformed.control_entries).toBe(2);
47
+ });
48
+
49
+ test("chant query joins a version to the one it replaced", async () => {
50
+ const load = await loadQueryData([{ member: "control", port: port(FIXTURE) }]);
51
+ const result = await runQuery("SELECT n.id, n.digest, o.digest AS replaced FROM control_entries n JOIN control_entries o ON o.digest = n.prev_digest", load);
52
+ expect(result.rows).toEqual([{ id: "ctl-001", digest: v2.digest, replaced: v1.digest }]);
53
+ });
54
+
55
+ test("a ledger with no control repo entries has no rows", async () => {
56
+ const { data } = await loadQueryData([{ member: null, port: port({ "_gates/x.jsonl": "" }) }]);
57
+ expect(data.control_entries).toEqual([]);
58
+ });
59
+
60
+ test("chant ledger lists the table, with settings and estates as JSON, current as a boolean and timestamp for --since", () => {
61
+ expect(LEDGER_TABLES).toContain("control_entries");
62
+ expect(LEDGER_TIME_COLUMN.control_entries).toBe("timestamp");
63
+ expect(ledgerFields("control_entries")).toMatchObject({ settings: "json", estates: "json", current: "boolean", timestamp: "time", digest: "text", prev_digest: "text" });
64
+ expect(QUERY_TABLES.control_entries.map(([c]) => c)).toEqual(["member", "id", "entry", "project", "state", "product", "settings", "estates", "by", "timestamp", "digest", "prev_digest", "current"]);
65
+ });
66
+
67
+ test("the table's floor is the next release", () => {
68
+ expect(LEDGER_CONTROL_ENTRIES_FLOOR).toBe(NEXT_RELEASE);
69
+ });
70
+ });
@@ -70,6 +70,12 @@ export interface FinishedGateRecord {
70
70
  applied: string;
71
71
  result: "applied" | "failed";
72
72
  timestamp: string;
73
+ /**
74
+ * A product's flat facts about the finished apply (#4551), such as a gated
75
+ * export's content digest or the version ids before and after. Never a
76
+ * state's contents.
77
+ */
78
+ detail?: Record<string, string | number | boolean>;
73
79
  }
74
80
 
75
81
  /** Where the applied lines of `op` live on `chant/lifecycle`: the directory and the file, as `writeBlobToPath` takes them. */
@@ -48,6 +48,14 @@ import type { GateApprover, GatePolicyDecision, ResolvedGateApproval } from "../
48
48
  import type { GateApprovalSource } from "../op/op-waves";
49
49
  import type { GateRunLocator } from "../op/gate-run-locator";
50
50
  import { readBlobFromPath, readPathSha, readBlobBySha, writeBlobToPath, RefCASConflictError, type LedgerLocation } from "./git";
51
+ import { NEXT_RELEASE } from "../release-floors";
52
+ import { gatedRequestOf, type GatedRequest } from "./gated-request-digest";
53
+
54
+ /** The first chant that writes `changeSet` on a pending fact and an approval (#4551). */
55
+ export const GATE_CHANGE_SET_FLOOR = NEXT_RELEASE;
56
+
57
+ /** The first chant that writes `request` on a pending fact and reads gated requests (#4551). */
58
+ export const GATED_REQUEST_FLOOR = NEXT_RELEASE;
51
59
 
52
60
  // The facts a pending record is written with live apart, so a bundle can import them without git (#3816).
53
61
  export { DEFAULT_GATE_EXPIRY, isApprovalUrl, resolveApprovalUrl } from "./gate-pending";
@@ -171,6 +179,13 @@ export interface GateResolutionRecord {
171
179
  * 0.124.28.
172
180
  */
173
181
  releaseDigest?: string;
182
+ /**
183
+ * The change set this approval was asked for (#4551), copied off the
184
+ * pending fact it answers when it approves that fact's plan: the digest of
185
+ * a document in `_change-sets/`. Absent on an approval of another plan,
186
+ * and on a resolution written before {@link GATE_CHANGE_SET_FLOOR}.
187
+ */
188
+ changeSet?: string;
174
189
  /**
175
190
  * The resolution passes a release gate over an empty change set (#4045,
176
191
  * ws-104 question 6): the promote wrote it itself, with the actor running
@@ -390,6 +405,15 @@ export interface PendingGateRecord {
390
405
  * Absent on every other gate, and on a fact written before 0.124.28.
391
406
  */
392
407
  releaseDigest?: string;
408
+ /**
409
+ * The change set this gate waits on (#4551): the digest of a document in
410
+ * `_change-sets/` (`./change-set-store.ts`), stored before this fact, so a
411
+ * refusal or a respond job reads the plans the approval is asked for. An op
412
+ * wave sets it from its plans file's `changeSet`; a pull-request or release
413
+ * gate, whose `planDigest` is already a change set's digest, sets it to the
414
+ * same value. Absent on a fact written before {@link GATE_CHANGE_SET_FLOOR}.
415
+ */
416
+ changeSet?: string;
393
417
  /**
394
418
  * The channel the run that reached this gate was driven from (chant#2384).
395
419
  *
@@ -433,6 +457,14 @@ export interface PendingGateRecord {
433
457
  * not `chant approve`.
434
458
  */
435
459
  answer?: GateAnswerRef;
460
+ /**
461
+ * The request this fact asks an approval of (#4551), on a gated request for
462
+ * an op that has no wave, such as a state export or a lock release
463
+ * (`./gated-request.ts`). `planDigest` is its `gatedRequestDigest`. Absent
464
+ * on every other fact, and on one written before chant
465
+ * {@link GATED_REQUEST_FLOOR}.
466
+ */
467
+ request?: GatedRequest;
436
468
  }
437
469
 
438
470
  export type PendingGateInput = Omit<PendingGateRecord, "version" | "kind">;
@@ -594,7 +626,8 @@ export function parseGateLedger(
594
626
  continue;
595
627
  }
596
628
  // #4020: a commit or run id of the wrong type is dropped, so a reader can trust the type without losing the line.
597
- for (const key of ["gitSha", "runId"] as const) {
629
+ // #4551: and so is a `changeSet` that is not a digest.
630
+ for (const key of ["gitSha", "runId", "changeSet"] as const) {
598
631
  const v: unknown = (parsed as Record<string, unknown>)[key];
599
632
  if (v !== undefined && typeof v !== "string") delete (parsed as Record<string, unknown>)[key];
600
633
  }
@@ -609,6 +642,8 @@ export function parseGateLedger(
609
642
  if (w !== undefined && !(w && typeof w === "object" && typeof w.number === "number" && typeof w.name === "string")) delete rec.wave;
610
643
  const h = (parsed as { heldBy?: unknown }).heldBy as Partial<PendingGateHeldBy> | null | undefined;
611
644
  if (h !== undefined && !(h && typeof h === "object" && typeof h.hook === "string" && typeof h.moment === "string")) delete rec.heldBy;
645
+ // #4551: a `request` of the wrong shape is dropped too.
646
+ if ((parsed as { request?: unknown }).request !== undefined && !gatedRequestOf((parsed as { request?: unknown }).request)) delete rec.request;
612
647
  pending.push(rec);
613
648
  continue;
614
649
  }
@@ -0,0 +1,69 @@
1
+ /**
2
+ * Pending gates by plan digest (#4607): the standing facts a digest finds,
3
+ * and the pull request a `pr-<n>[-<member>]` op names.
4
+ */
5
+
6
+ import { describe, expect, test } from "vitest";
7
+ import { pullRequestOfOp, standingPendingByPlan } from "./gate-pending-by-plan";
8
+ import type { GateResolutionRecord, PendingGateRecord } from "./gate-ledger";
9
+
10
+ const D1 = `sha256:${"1".repeat(64)}`;
11
+ const D2 = `sha256:${"2".repeat(64)}`;
12
+ const NOW = "2026-10-27T12:00:00.000Z";
13
+
14
+ function pending(over: Partial<PendingGateRecord> = {}): PendingGateRecord {
15
+ return { version: 1, kind: "pending", op: "pr-12", gate: "up", timestamp: "2026-10-27T10:00:00.000Z", expiresAt: "2026-10-28T10:00:00.000Z", planDigest: D1, ...over } as PendingGateRecord;
16
+ }
17
+
18
+ function resolution(over: Partial<GateResolutionRecord> = {}): GateResolutionRecord {
19
+ return { version: 1, kind: "resolution", op: "pr-12", gate: "up", timestamp: "2026-10-27T11:00:00.000Z", resolution: "approved", planDigest: D1, ...over } as unknown as GateResolutionRecord;
20
+ }
21
+
22
+ describe("pullRequestOfOp", () => {
23
+ test("pr-<n> and pr-<n>-<member> name the pull request; other ops none", () => {
24
+ expect(pullRequestOfOp("pr-12")).toEqual({ pr: 12 });
25
+ expect(pullRequestOfOp("pr-12-network")).toEqual({ pr: 12, member: "network" });
26
+ expect(pullRequestOfOp("pulumi-up")).toBeUndefined();
27
+ expect(pullRequestOfOp("pr-abc")).toBeUndefined();
28
+ });
29
+ });
30
+
31
+ describe("standingPendingByPlan", () => {
32
+ test("a standing fact with the digest names its op, gate and pull request", () => {
33
+ const found = standingPendingByPlan({ pending: [pending()], resolutions: [] }, D1, NOW);
34
+ expect(found).toEqual([expect.objectContaining({ op: "pr-12", gate: "up", pr: 12, matched: "planDigest", planDigest: D1 })]);
35
+ expect(standingPendingByPlan({ pending: [pending({ op: "pr-12-network" })], resolutions: [] }, D1, NOW)[0]).toMatchObject({ pr: 12, member: "network" });
36
+ });
37
+
38
+ test("the digest matches whichever prefix it carries", () => {
39
+ expect(standingPendingByPlan({ pending: [pending()], resolutions: [] }, "1".repeat(64).replace(/^/, "sha256:"), NOW)).toHaveLength(1);
40
+ });
41
+
42
+ test("a wave fact's change set matches too", () => {
43
+ const wave = pending({ op: "pulumi-up", gate: "wave-2", planDigest: D2, changeSet: D1 });
44
+ expect(standingPendingByPlan({ pending: [wave], resolutions: [] }, D1, NOW)).toEqual([expect.objectContaining({ op: "pulumi-up", gate: "wave-2", matched: "changeSet" })]);
45
+ expect(standingPendingByPlan({ pending: [wave], resolutions: [] }, D1, NOW)[0]!.pr).toBeUndefined();
46
+ });
47
+
48
+ test("another digest, an expired fact, an answered fact, or a newer fact for another plan finds nothing", () => {
49
+ expect(standingPendingByPlan({ pending: [pending()], resolutions: [] }, D2, NOW)).toEqual([]);
50
+ expect(standingPendingByPlan({ pending: [pending({ expiresAt: "2026-10-27T11:00:00.000Z" })], resolutions: [] }, D1, NOW)).toEqual([]);
51
+ expect(standingPendingByPlan({ pending: [pending()], resolutions: [resolution()] }, D1, NOW)).toEqual([]);
52
+ const moved = pending({ timestamp: "2026-10-27T11:30:00.000Z", planDigest: D2 });
53
+ expect(standingPendingByPlan({ pending: [pending(), moved], resolutions: [] }, D1, NOW)).toEqual([]);
54
+ });
55
+
56
+ test("a resolution older than the fact, or for another environment, leaves it standing", () => {
57
+ const older = resolution({ timestamp: "2026-10-27T09:00:00.000Z" });
58
+ expect(standingPendingByPlan({ pending: [pending()], resolutions: [older] }, D1, NOW)).toHaveLength(1);
59
+ const prod = pending({ environment: "prod" });
60
+ const staging = resolution({ environment: "staging" } as Partial<GateResolutionRecord>);
61
+ expect(standingPendingByPlan({ pending: [prod], resolutions: [staging] }, D1, NOW)).toEqual([expect.objectContaining({ environment: "prod" })]);
62
+ });
63
+
64
+ test("facts per environment stand side by side, newest first", () => {
65
+ const staging = pending({ environment: "staging", timestamp: "2026-10-27T10:00:00.000Z" });
66
+ const prod = pending({ environment: "prod", timestamp: "2026-10-27T10:30:00.000Z" });
67
+ expect(standingPendingByPlan({ pending: [staging, prod], resolutions: [] }, D1, NOW).map((g) => g.environment)).toEqual(["prod", "staging"]);
68
+ });
69
+ });