@intentius/chant 0.124.54 → 0.124.56

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 (1077) 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 +832 -0
  71. package/dist/ci-audit/attribution.d.ts +111 -0
  72. package/dist/ci-audit/attribution.d.ts.map +1 -0
  73. package/dist/ci-audit/attribution.js +194 -0
  74. package/dist/ci-audit/audit-log.d.ts +144 -0
  75. package/dist/ci-audit/audit-log.d.ts.map +1 -0
  76. package/dist/ci-audit/audit-log.js +149 -0
  77. package/dist/ci-audit/index.d.ts +12 -0
  78. package/dist/ci-audit/index.d.ts.map +1 -0
  79. package/dist/ci-audit/index.js +12 -0
  80. package/dist/ci-audit/unrecorded.d.ts +74 -0
  81. package/dist/ci-audit/unrecorded.d.ts.map +1 -0
  82. package/dist/ci-audit/unrecorded.js +95 -0
  83. package/dist/ci-audit.d.ts +3 -0
  84. package/dist/ci-audit.d.ts.map +1 -0
  85. package/dist/ci-audit.js +2 -0
  86. package/dist/ci-control.d.ts +42 -0
  87. package/dist/ci-control.d.ts.map +1 -0
  88. package/dist/ci-control.js +41 -0
  89. package/dist/ci-estate/delivery.d.ts +137 -0
  90. package/dist/ci-estate/delivery.d.ts.map +1 -0
  91. package/dist/ci-estate/delivery.js +311 -0
  92. package/dist/ci-estate/overdue.d.ts +34 -0
  93. package/dist/ci-estate/overdue.d.ts.map +1 -0
  94. package/dist/ci-estate/overdue.js +58 -0
  95. package/dist/ci-estate/page.d.ts +134 -0
  96. package/dist/ci-estate/page.d.ts.map +1 -0
  97. package/dist/ci-estate/page.js +233 -0
  98. package/dist/ci-estate/rows.d.ts +118 -0
  99. package/dist/ci-estate/rows.d.ts.map +1 -0
  100. package/dist/ci-estate/rows.js +126 -0
  101. package/dist/ci-estate.d.ts +92 -0
  102. package/dist/ci-estate.d.ts.map +1 -0
  103. package/dist/ci-estate.js +82 -0
  104. package/dist/ci-handover.d.ts +29 -5
  105. package/dist/ci-handover.d.ts.map +1 -1
  106. package/dist/ci-handover.js +50 -16
  107. package/dist/ci-identity.d.ts +82 -7
  108. package/dist/ci-identity.d.ts.map +1 -1
  109. package/dist/ci-identity.js +86 -15
  110. package/dist/ci-job-guard.d.ts +139 -0
  111. package/dist/ci-job-guard.d.ts.map +1 -0
  112. package/dist/ci-job-guard.js +287 -0
  113. package/dist/ci-jobs.d.ts +7 -0
  114. package/dist/ci-jobs.d.ts.map +1 -1
  115. package/dist/ci-jobs.js +7 -0
  116. package/dist/ci-product-words.d.ts +296 -0
  117. package/dist/ci-product-words.d.ts.map +1 -0
  118. package/dist/ci-product-words.js +407 -0
  119. package/dist/ci-product.d.ts +117 -0
  120. package/dist/ci-product.d.ts.map +1 -0
  121. package/dist/ci-product.js +113 -0
  122. package/dist/ci-respond-run.d.ts +73 -0
  123. package/dist/ci-respond-run.d.ts.map +1 -0
  124. package/dist/ci-respond-run.js +247 -0
  125. package/dist/ci-respond.d.ts +189 -0
  126. package/dist/ci-respond.d.ts.map +1 -0
  127. package/dist/ci-respond.js +285 -0
  128. package/dist/cli/commands/audit.d.ts +2 -2
  129. package/dist/cli/commands/audit.d.ts.map +1 -1
  130. package/dist/cli/commands/audit.js +3 -2
  131. package/dist/cli/commands/carve.js +2 -2
  132. package/dist/cli/commands/init.d.ts +2 -0
  133. package/dist/cli/commands/init.d.ts.map +1 -1
  134. package/dist/cli/commands/init.js +1 -1
  135. package/dist/cli/handlers/agent.d.ts +17 -0
  136. package/dist/cli/handlers/agent.d.ts.map +1 -0
  137. package/dist/cli/handlers/agent.js +114 -0
  138. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  139. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  140. package/dist/cli/handlers/approve-confirm.js +142 -0
  141. package/dist/cli/handlers/approve.d.ts.map +1 -1
  142. package/dist/cli/handlers/approve.js +19 -1
  143. package/dist/cli/handlers/audit-log.d.ts +12 -0
  144. package/dist/cli/handlers/audit-log.d.ts.map +1 -0
  145. package/dist/cli/handlers/audit-log.js +81 -0
  146. package/dist/cli/handlers/build.d.ts +7 -0
  147. package/dist/cli/handlers/build.d.ts.map +1 -1
  148. package/dist/cli/handlers/build.js +124 -1
  149. package/dist/cli/handlers/ci-check-job.d.ts +11 -0
  150. package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
  151. package/dist/cli/handlers/ci-check-job.js +27 -0
  152. package/dist/cli/handlers/ci-check.d.ts +3 -0
  153. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  154. package/dist/cli/handlers/ci-check.js +63 -0
  155. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  156. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  157. package/dist/cli/handlers/ci-forge-check.js +89 -0
  158. package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
  159. package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
  160. package/dist/cli/handlers/e2e-safe-run.js +23 -0
  161. package/dist/cli/handlers/fan-out.js +4 -0
  162. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  163. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  164. package/dist/cli/handlers/gate-pending.js +44 -0
  165. package/dist/cli/handlers/init.d.ts.map +1 -1
  166. package/dist/cli/handlers/init.js +1 -0
  167. package/dist/cli/handlers/ledger.js +1 -1
  168. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  169. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  170. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  171. package/dist/cli/handlers/lock.d.ts.map +1 -1
  172. package/dist/cli/handlers/lock.js +64 -5
  173. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  174. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  175. package/dist/cli/handlers/notify-relay.js +130 -0
  176. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  177. package/dist/cli/handlers/pr-env.js +42 -11
  178. package/dist/cli/handlers/pr.d.ts +43 -3
  179. package/dist/cli/handlers/pr.d.ts.map +1 -1
  180. package/dist/cli/handlers/pr.js +908 -205
  181. package/dist/cli/handlers/promote.d.ts.map +1 -1
  182. package/dist/cli/handlers/promote.js +21 -2
  183. package/dist/cli/handlers/release.d.ts.map +1 -1
  184. package/dist/cli/handlers/release.js +3 -0
  185. package/dist/cli/handlers/run-wave.d.ts +8 -0
  186. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  187. package/dist/cli/handlers/run-wave.js +160 -2
  188. package/dist/cli/handlers/run.d.ts +6 -1
  189. package/dist/cli/handlers/run.d.ts.map +1 -1
  190. package/dist/cli/handlers/run.js +86 -1
  191. package/dist/cli/handlers/serve.d.ts.map +1 -1
  192. package/dist/cli/handlers/serve.js +10 -1
  193. package/dist/cli/main.d.ts +11 -1
  194. package/dist/cli/main.d.ts.map +1 -1
  195. package/dist/cli/main.js +178 -13
  196. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  197. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  198. package/dist/cli/mcp/ledger-tools.js +122 -0
  199. package/dist/cli/mcp/product-tools.d.ts +78 -0
  200. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  201. package/dist/cli/mcp/product-tools.js +93 -0
  202. package/dist/cli/mcp/read-only.d.ts +34 -0
  203. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  204. package/dist/cli/mcp/read-only.js +61 -0
  205. package/dist/cli/mcp/report-tools.d.ts +48 -0
  206. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  207. package/dist/cli/mcp/report-tools.js +128 -0
  208. package/dist/cli/mcp/server.d.ts +28 -1
  209. package/dist/cli/mcp/server.d.ts.map +1 -1
  210. package/dist/cli/mcp/server.js +86 -15
  211. package/dist/cli/mcp-config.d.ts +9 -2
  212. package/dist/cli/mcp-config.d.ts.map +1 -1
  213. package/dist/cli/mcp-config.js +8 -3
  214. package/dist/cli/parse-args.d.ts.map +1 -1
  215. package/dist/cli/parse-args.js +164 -3
  216. package/dist/cli/registry.d.ts +73 -0
  217. package/dist/cli/registry.d.ts.map +1 -1
  218. package/dist/cloud-lister/sigv4.d.ts +42 -7
  219. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  220. package/dist/cloud-lister/sigv4.js +72 -22
  221. package/dist/components/adoption.d.ts +69 -0
  222. package/dist/components/adoption.d.ts.map +1 -0
  223. package/dist/components/adoption.js +92 -0
  224. package/dist/components/apply-lease.d.ts +19 -0
  225. package/dist/components/apply-lease.d.ts.map +1 -0
  226. package/dist/components/apply-lease.js +41 -0
  227. package/dist/components/capability.d.ts +159 -5
  228. package/dist/components/capability.d.ts.map +1 -1
  229. package/dist/components/capability.js +39 -6
  230. package/dist/components/check-hooks.d.ts +116 -0
  231. package/dist/components/check-hooks.d.ts.map +1 -0
  232. package/dist/components/check-hooks.js +192 -0
  233. package/dist/components/check-steps.d.ts +74 -0
  234. package/dist/components/check-steps.d.ts.map +1 -0
  235. package/dist/components/check-steps.js +102 -0
  236. package/dist/components/ci-services.d.ts +57 -0
  237. package/dist/components/ci-services.d.ts.map +1 -0
  238. package/dist/components/ci-services.js +60 -0
  239. package/dist/components/cli-support.d.ts +13 -0
  240. package/dist/components/cli-support.d.ts.map +1 -1
  241. package/dist/components/cli-support.js +10 -2
  242. package/dist/components/driver.d.ts +32 -3
  243. package/dist/components/driver.d.ts.map +1 -1
  244. package/dist/components/driver.js +59 -5
  245. package/dist/components/fan-out-run.d.ts +12 -0
  246. package/dist/components/fan-out-run.d.ts.map +1 -1
  247. package/dist/components/fan-out-run.js +56 -16
  248. package/dist/components/groups.d.ts.map +1 -1
  249. package/dist/components/groups.js +23 -5
  250. package/dist/components/pr-env-ledger.d.ts +32 -0
  251. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  252. package/dist/components/pr-env-ledger.js +38 -0
  253. package/dist/components/pr-env-ports.d.ts +12 -0
  254. package/dist/components/pr-env-ports.d.ts.map +1 -1
  255. package/dist/components/pr-env-ports.js +13 -3
  256. package/dist/components/pr-env-run.d.ts +6 -0
  257. package/dist/components/pr-env-run.d.ts.map +1 -1
  258. package/dist/components/pr-env-run.js +3 -2
  259. package/dist/components/pr-environment.d.ts +32 -4
  260. package/dist/components/pr-environment.d.ts.map +1 -1
  261. package/dist/components/pr-environment.js +26 -8
  262. package/dist/components/pr-pipeline.d.ts +297 -5
  263. package/dist/components/pr-pipeline.d.ts.map +1 -1
  264. package/dist/components/pr-pipeline.js +329 -18
  265. package/dist/components/pr-policy.d.ts +26 -2
  266. package/dist/components/pr-policy.d.ts.map +1 -1
  267. package/dist/components/pr-policy.js +41 -7
  268. package/dist/components/pr-run.d.ts +71 -0
  269. package/dist/components/pr-run.d.ts.map +1 -1
  270. package/dist/components/pr-run.js +91 -7
  271. package/dist/components/pr-targets.d.ts +24 -0
  272. package/dist/components/pr-targets.d.ts.map +1 -0
  273. package/dist/components/pr-targets.js +48 -0
  274. package/dist/components/product-pipeline.d.ts +250 -0
  275. package/dist/components/product-pipeline.d.ts.map +1 -0
  276. package/dist/components/product-pipeline.js +212 -0
  277. package/dist/components/promote.d.ts +6 -0
  278. package/dist/components/promote.d.ts.map +1 -1
  279. package/dist/components/promote.js +4 -1
  280. package/dist/components/release-compile.d.ts +22 -1
  281. package/dist/components/release-compile.d.ts.map +1 -1
  282. package/dist/components/release-compile.js +85 -0
  283. package/dist/components/release-promote.d.ts +15 -1
  284. package/dist/components/release-promote.d.ts.map +1 -1
  285. package/dist/components/release-promote.js +67 -2
  286. package/dist/components/repo-lock.d.ts +27 -0
  287. package/dist/components/repo-lock.d.ts.map +1 -0
  288. package/dist/components/repo-lock.js +49 -0
  289. package/dist/components/row-lease.d.ts +84 -0
  290. package/dist/components/row-lease.d.ts.map +1 -0
  291. package/dist/components/row-lease.js +110 -0
  292. package/dist/components/wave-plan.d.ts +42 -0
  293. package/dist/components/wave-plan.d.ts.map +1 -1
  294. package/dist/components/wave-plan.js +72 -4
  295. package/dist/control/applied.d.ts +89 -0
  296. package/dist/control/applied.d.ts.map +1 -0
  297. package/dist/control/applied.js +175 -0
  298. package/dist/control/consumers.d.ts +78 -0
  299. package/dist/control/consumers.d.ts.map +1 -0
  300. package/dist/control/consumers.js +172 -0
  301. package/dist/control/dispatch.d.ts +334 -0
  302. package/dist/control/dispatch.d.ts.map +1 -0
  303. package/dist/control/dispatch.js +519 -0
  304. package/dist/control/edges.d.ts +75 -0
  305. package/dist/control/edges.d.ts.map +1 -0
  306. package/dist/control/edges.js +133 -0
  307. package/dist/control/reconcile.d.ts +120 -0
  308. package/dist/control/reconcile.d.ts.map +1 -0
  309. package/dist/control/reconcile.js +178 -0
  310. package/dist/control/records.d.ts +187 -0
  311. package/dist/control/records.d.ts.map +1 -0
  312. package/dist/control/records.js +307 -0
  313. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  314. package/dist/discovery/sandbox/bundle.js +25 -1
  315. package/dist/e2e-harness/bucket.d.ts +21 -0
  316. package/dist/e2e-harness/bucket.d.ts.map +1 -0
  317. package/dist/e2e-harness/bucket.js +61 -0
  318. package/dist/e2e-harness/claim.d.ts +70 -0
  319. package/dist/e2e-harness/claim.d.ts.map +1 -0
  320. package/dist/e2e-harness/claim.js +98 -0
  321. package/dist/e2e-harness/driver.d.ts +64 -0
  322. package/dist/e2e-harness/driver.d.ts.map +1 -0
  323. package/dist/e2e-harness/driver.js +243 -0
  324. package/dist/e2e-harness/forgejo.d.ts +77 -0
  325. package/dist/e2e-harness/forgejo.d.ts.map +1 -0
  326. package/dist/e2e-harness/forgejo.js +205 -0
  327. package/dist/e2e-harness/git.d.ts +32 -0
  328. package/dist/e2e-harness/git.d.ts.map +1 -0
  329. package/dist/e2e-harness/git.js +67 -0
  330. package/dist/e2e-harness/index.d.ts +22 -0
  331. package/dist/e2e-harness/index.d.ts.map +1 -0
  332. package/dist/e2e-harness/index.js +48 -0
  333. package/dist/e2e-harness/jobs.d.ts +8 -0
  334. package/dist/e2e-harness/jobs.d.ts.map +1 -0
  335. package/dist/e2e-harness/jobs.js +34 -0
  336. package/dist/e2e-harness/pins.d.ts +45 -0
  337. package/dist/e2e-harness/pins.d.ts.map +1 -0
  338. package/dist/e2e-harness/pins.js +44 -0
  339. package/dist/e2e-harness/ports.d.ts +113 -0
  340. package/dist/e2e-harness/ports.d.ts.map +1 -0
  341. package/dist/e2e-harness/ports.js +4 -0
  342. package/dist/e2e-harness/reports.d.ts +45 -0
  343. package/dist/e2e-harness/reports.d.ts.map +1 -0
  344. package/dist/e2e-harness/reports.js +57 -0
  345. package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
  346. package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
  347. package/dist/e2e-harness/safe-run-cli.js +43 -0
  348. package/dist/e2e-harness/safe-run.d.ts +61 -0
  349. package/dist/e2e-harness/safe-run.d.ts.map +1 -0
  350. package/dist/e2e-harness/safe-run.js +172 -0
  351. package/dist/e2e-harness/scenario.d.ts +11 -0
  352. package/dist/e2e-harness/scenario.d.ts.map +1 -0
  353. package/dist/e2e-harness/scenario.js +89 -0
  354. package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  355. package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
  356. package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  357. package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  358. package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  359. package/dist/e2e-harness/schemas/index.d.ts +191 -0
  360. package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
  361. package/dist/e2e-harness/schemas/index.js +62 -0
  362. package/dist/e2e-harness/stack.d.ts +124 -0
  363. package/dist/e2e-harness/stack.d.ts.map +1 -0
  364. package/dist/e2e-harness/stack.js +207 -0
  365. package/dist/e2e-harness/steps.d.ts +11 -0
  366. package/dist/e2e-harness/steps.d.ts.map +1 -0
  367. package/dist/e2e-harness/steps.js +22 -0
  368. package/dist/e2e-harness.d.ts +3 -0
  369. package/dist/e2e-harness.d.ts.map +1 -0
  370. package/dist/e2e-harness.js +2 -0
  371. package/dist/engine-facts.d.ts.map +1 -1
  372. package/dist/engine-facts.js +1 -2
  373. package/dist/exit-codes.d.ts +54 -0
  374. package/dist/exit-codes.d.ts.map +1 -0
  375. package/dist/exit-codes.js +55 -0
  376. package/dist/forge-check/check.d.ts +63 -0
  377. package/dist/forge-check/check.d.ts.map +1 -0
  378. package/dist/forge-check/check.js +139 -0
  379. package/dist/forge-check/contract.d.ts +152 -0
  380. package/dist/forge-check/contract.d.ts.map +1 -0
  381. package/dist/forge-check/contract.js +118 -0
  382. package/dist/forge-check/forge.d.ts +42 -0
  383. package/dist/forge-check/forge.d.ts.map +1 -0
  384. package/dist/forge-check/forge.js +338 -0
  385. package/dist/forge-check/index.d.ts +24 -0
  386. package/dist/forge-check/index.d.ts.map +1 -0
  387. package/dist/forge-check/index.js +23 -0
  388. package/dist/forge-check/pulumi.d.ts +44 -0
  389. package/dist/forge-check/pulumi.d.ts.map +1 -0
  390. package/dist/forge-check/pulumi.js +184 -0
  391. package/dist/forge-check/read-only.d.ts +26 -0
  392. package/dist/forge-check/read-only.d.ts.map +1 -0
  393. package/dist/forge-check/read-only.js +53 -0
  394. package/dist/forge-check/trust.d.ts +94 -0
  395. package/dist/forge-check/trust.d.ts.map +1 -0
  396. package/dist/forge-check/trust.js +532 -0
  397. package/dist/forge-check/types.d.ts +80 -0
  398. package/dist/forge-check/types.d.ts.map +1 -0
  399. package/dist/forge-check/types.js +18 -0
  400. package/dist/forge-check.d.ts +6 -0
  401. package/dist/forge-check.d.ts.map +1 -0
  402. package/dist/forge-check.js +5 -0
  403. package/dist/gate-decision.d.ts +1 -0
  404. package/dist/gate-decision.d.ts.map +1 -1
  405. package/dist/gate-decision.js +2 -0
  406. package/dist/gate-policy.d.ts +47 -1
  407. package/dist/gate-policy.d.ts.map +1 -1
  408. package/dist/gate-policy.js +50 -2
  409. package/dist/index.d.ts +1 -0
  410. package/dist/index.d.ts.map +1 -1
  411. package/dist/index.js +2 -0
  412. package/dist/lexicon.d.ts +152 -6
  413. package/dist/lexicon.d.ts.map +1 -1
  414. package/dist/lifecycle/adoption-file.d.ts +24 -0
  415. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  416. package/dist/lifecycle/adoption-file.js +1 -2
  417. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  418. package/dist/lifecycle/cloud-index.js +1 -2
  419. package/dist/lifecycle/gate-applied.d.ts +6 -0
  420. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  421. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  422. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  423. package/dist/lifecycle/gate-ledger.js +10 -1
  424. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  425. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  426. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  427. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  428. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  429. package/dist/lifecycle/gated-request-digest.js +35 -0
  430. package/dist/lifecycle/gated-request.d.ts +126 -0
  431. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  432. package/dist/lifecycle/gated-request.js +204 -0
  433. package/dist/lifecycle/identity-match.d.ts +15 -0
  434. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  435. package/dist/lifecycle/identity-match.js +11 -6
  436. package/dist/lifecycle/index-diff.d.ts +40 -0
  437. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  438. package/dist/lifecycle/index-diff.js +1 -2
  439. package/dist/lifecycle/index-document.d.ts.map +1 -1
  440. package/dist/lifecycle/index-document.js +1 -2
  441. package/dist/lifecycle/index-import.d.ts +4 -1
  442. package/dist/lifecycle/index-import.d.ts.map +1 -1
  443. package/dist/lifecycle/index-import.js +29 -32
  444. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  445. package/dist/lifecycle/ledger-read.js +7 -3
  446. package/dist/lifecycle/lock-rows.d.ts +76 -0
  447. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  448. package/dist/lifecycle/lock-rows.js +140 -0
  449. package/dist/lifecycle/query.d.ts +50 -3
  450. package/dist/lifecycle/query.d.ts.map +1 -1
  451. package/dist/lifecycle/query.js +97 -7
  452. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  453. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  454. package/dist/lifecycle/release-catalog-site.js +232 -0
  455. package/dist/lifecycle/release-catalog.d.ts +201 -0
  456. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  457. package/dist/lifecycle/release-catalog.js +198 -0
  458. package/dist/lifecycle/release-changelog.d.ts +41 -0
  459. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  460. package/dist/lifecycle/release-changelog.js +38 -0
  461. package/dist/lifecycle/release-cut.d.ts +1 -0
  462. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  463. package/dist/lifecycle/release-cut.js +1 -1
  464. package/dist/lifecycle/release-ledger.d.ts +16 -0
  465. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  466. package/dist/lifecycle/release-ledger.js +9 -0
  467. package/dist/lifecycle/release-publish.d.ts +43 -22
  468. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  469. package/dist/lifecycle/release-read.d.ts.map +1 -1
  470. package/dist/lifecycle/release-read.js +3 -0
  471. package/dist/lifecycle/release-status.d.ts +106 -0
  472. package/dist/lifecycle/release-status.d.ts.map +1 -0
  473. package/dist/lifecycle/release-status.js +115 -0
  474. package/dist/lifecycle/resource-lock.d.ts +120 -0
  475. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  476. package/dist/lifecycle/resource-lock.js +317 -0
  477. package/dist/lifecycle/retention.d.ts.map +1 -1
  478. package/dist/lifecycle/retention.js +3 -0
  479. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  480. package/dist/lifecycle/run-ledger.js +9 -1
  481. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  482. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  483. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  484. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  485. package/dist/lifecycle/snapshot-store.js +1 -2
  486. package/dist/lifecycle/target-lock.d.ts +15 -0
  487. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  488. package/dist/lifecycle/target-lock.js +25 -10
  489. package/dist/lifecycle/wave-plans.d.ts +23 -7
  490. package/dist/lifecycle/wave-plans.d.ts.map +1 -1
  491. package/dist/lifecycle/wave-plans.js +9 -2
  492. package/dist/mcp/types.d.ts +7 -0
  493. package/dist/mcp/types.d.ts.map +1 -1
  494. package/dist/notify-product.d.ts +43 -0
  495. package/dist/notify-product.d.ts.map +1 -0
  496. package/dist/notify-product.js +58 -0
  497. package/dist/notify-relay.d.ts +197 -0
  498. package/dist/notify-relay.d.ts.map +1 -0
  499. package/dist/notify-relay.js +321 -0
  500. package/dist/notify.d.ts +44 -4
  501. package/dist/notify.d.ts.map +1 -1
  502. package/dist/notify.js +77 -14
  503. package/dist/object-store/azure-blob.d.ts +129 -0
  504. package/dist/object-store/azure-blob.d.ts.map +1 -0
  505. package/dist/object-store/azure-blob.js +341 -0
  506. package/dist/object-store/common.d.ts +108 -0
  507. package/dist/object-store/common.d.ts.map +1 -0
  508. package/dist/object-store/common.js +80 -0
  509. package/dist/object-store/errors.d.ts +28 -0
  510. package/dist/object-store/errors.d.ts.map +1 -0
  511. package/dist/object-store/errors.js +21 -0
  512. package/dist/object-store/from-env.d.ts +18 -0
  513. package/dist/object-store/from-env.d.ts.map +1 -0
  514. package/dist/object-store/from-env.js +22 -0
  515. package/dist/object-store/gcs.d.ts +106 -0
  516. package/dist/object-store/gcs.d.ts.map +1 -0
  517. package/dist/object-store/gcs.js +393 -0
  518. package/dist/object-store/index.d.ts +9 -0
  519. package/dist/object-store/index.d.ts.map +1 -0
  520. package/dist/object-store/index.js +8 -0
  521. package/dist/object-store/s3.d.ts +146 -0
  522. package/dist/object-store/s3.d.ts.map +1 -0
  523. package/dist/object-store/s3.js +306 -0
  524. package/dist/op/activities/converge.d.ts.map +1 -1
  525. package/dist/op/activities/converge.js +2 -1
  526. package/dist/op/activities/index.d.ts +1 -1
  527. package/dist/op/activities/index.d.ts.map +1 -1
  528. package/dist/op/activities/index.js +1 -1
  529. package/dist/op/activities/review-agent.d.ts +55 -2
  530. package/dist/op/activities/review-agent.d.ts.map +1 -1
  531. package/dist/op/activities/review-agent.js +65 -5
  532. package/dist/op/approval-status.d.ts +103 -0
  533. package/dist/op/approval-status.d.ts.map +1 -0
  534. package/dist/op/approval-status.js +197 -0
  535. package/dist/op/gate.d.ts +29 -1
  536. package/dist/op/gate.d.ts.map +1 -1
  537. package/dist/op/gate.js +59 -23
  538. package/dist/op/generate-pipeline.d.ts.map +1 -1
  539. package/dist/op/generate-pipeline.js +7 -1
  540. package/dist/op/index.d.ts +12 -1
  541. package/dist/op/index.d.ts.map +1 -1
  542. package/dist/op/index.js +7 -1
  543. package/dist/op/op-waves-after-plan.d.ts +137 -0
  544. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  545. package/dist/op/op-waves-after-plan.js +163 -0
  546. package/dist/op/op-waves-capability-spec.d.ts +63 -0
  547. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  548. package/dist/op/op-waves-capability-spec.js +115 -0
  549. package/dist/op/op-waves-capability.d.ts +197 -0
  550. package/dist/op/op-waves-capability.d.ts.map +1 -0
  551. package/dist/op/op-waves-capability.js +311 -0
  552. package/dist/op/op-waves-events.d.ts +54 -0
  553. package/dist/op/op-waves-events.d.ts.map +1 -0
  554. package/dist/op/op-waves-events.js +122 -0
  555. package/dist/op/op-waves-notify.d.ts +7 -1
  556. package/dist/op/op-waves-notify.d.ts.map +1 -1
  557. package/dist/op/op-waves-notify.js +35 -16
  558. package/dist/op/op-waves-release-port.d.ts +18 -0
  559. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  560. package/dist/op/op-waves-release-port.js +61 -0
  561. package/dist/op/op-waves-release.d.ts +92 -0
  562. package/dist/op/op-waves-release.d.ts.map +1 -0
  563. package/dist/op/op-waves-release.js +96 -0
  564. package/dist/op/op-waves-run.d.ts +182 -6
  565. package/dist/op/op-waves-run.d.ts.map +1 -1
  566. package/dist/op/op-waves-run.js +1076 -44
  567. package/dist/op/op-waves-stand-down.d.ts +60 -0
  568. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  569. package/dist/op/op-waves-stand-down.js +96 -0
  570. package/dist/op/op-waves.d.ts +187 -8
  571. package/dist/op/op-waves.d.ts.map +1 -1
  572. package/dist/op/op-waves.js +203 -19
  573. package/dist/op/runtime.d.ts +95 -0
  574. package/dist/op/runtime.d.ts.map +1 -1
  575. package/dist/op/runtime.js +18 -0
  576. package/dist/op/stage-hooks.d.ts +45 -7
  577. package/dist/op/stage-hooks.d.ts.map +1 -1
  578. package/dist/op/stage-hooks.js +61 -3
  579. package/dist/op/steward-beside.d.ts.map +1 -1
  580. package/dist/op/steward-beside.js +2 -1
  581. package/dist/op/types.d.ts +2 -2
  582. package/dist/op/types.d.ts.map +1 -1
  583. package/dist/op/types.js +3 -2
  584. package/dist/otlp-metrics.d.ts +38 -0
  585. package/dist/otlp-metrics.d.ts.map +1 -0
  586. package/dist/otlp-metrics.js +82 -0
  587. package/dist/otlp.d.ts +249 -0
  588. package/dist/otlp.d.ts.map +1 -0
  589. package/dist/otlp.js +425 -0
  590. package/dist/override-gate.d.ts.map +1 -1
  591. package/dist/override-gate.js +5 -0
  592. package/dist/parallelism.d.ts +17 -0
  593. package/dist/parallelism.d.ts.map +1 -0
  594. package/dist/parallelism.js +33 -0
  595. package/dist/policy-packs.d.ts +69 -0
  596. package/dist/policy-packs.d.ts.map +1 -0
  597. package/dist/policy-packs.js +205 -0
  598. package/dist/policy-source.d.ts +51 -0
  599. package/dist/policy-source.d.ts.map +1 -0
  600. package/dist/policy-source.js +102 -0
  601. package/dist/pr-forge.d.ts +40 -0
  602. package/dist/pr-forge.d.ts.map +1 -1
  603. package/dist/pr-forge.js +146 -37
  604. package/dist/pr-loop.d.ts +158 -11
  605. package/dist/pr-loop.d.ts.map +1 -1
  606. package/dist/pr-loop.js +302 -44
  607. package/dist/pr-merge.d.ts +64 -0
  608. package/dist/pr-merge.d.ts.map +1 -0
  609. package/dist/pr-merge.js +78 -0
  610. package/dist/pr-post.d.ts +86 -1
  611. package/dist/pr-post.d.ts.map +1 -1
  612. package/dist/pr-post.js +141 -5
  613. package/dist/pr-report-url.d.ts +32 -4
  614. package/dist/pr-report-url.d.ts.map +1 -1
  615. package/dist/pr-report-url.js +45 -5
  616. package/dist/pr-requires.d.ts +13 -2
  617. package/dist/pr-requires.d.ts.map +1 -1
  618. package/dist/pr-requires.js +14 -0
  619. package/dist/release-floors.d.ts +1 -1
  620. package/dist/release-floors.js +1 -1
  621. package/dist/run-event.d.ts +26 -1
  622. package/dist/run-event.d.ts.map +1 -1
  623. package/dist/run-event.js +3 -1
  624. package/dist/scheduled-op-cloud.d.ts +32 -0
  625. package/dist/scheduled-op-cloud.d.ts.map +1 -0
  626. package/dist/scheduled-op-cloud.js +69 -0
  627. package/dist/sorted-json.d.ts +10 -0
  628. package/dist/sorted-json.d.ts.map +1 -0
  629. package/dist/sorted-json.js +14 -0
  630. package/dist/terraform/credentials.d.ts +59 -0
  631. package/dist/terraform/credentials.d.ts.map +1 -0
  632. package/dist/terraform/credentials.js +149 -0
  633. package/dist/utils.d.ts +1 -4
  634. package/dist/utils.d.ts.map +1 -1
  635. package/dist/utils.js +1 -9
  636. package/dist/wave-runtime.d.ts +1 -1
  637. package/dist/wave-runtime.js +2 -2
  638. package/dist/wave-runtime.mjs +405 -287
  639. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  640. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  641. package/dist/workspace/ci-lock-grain.d.ts +17 -0
  642. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  643. package/dist/workspace/ci-lock-grain.js +21 -0
  644. package/dist/workspace/ci-run.d.ts +2 -1
  645. package/dist/workspace/ci-run.d.ts.map +1 -1
  646. package/dist/workspace/ci-run.js +10 -3
  647. package/dist/workspace/declaration.d.ts +16 -4
  648. package/dist/workspace/declaration.d.ts.map +1 -1
  649. package/dist/workspace/declaration.js +5 -2
  650. package/dist/workspace/declaration.schema.json +27 -3
  651. package/dist/workspace/drift-cli.d.ts.map +1 -1
  652. package/dist/workspace/drift-cli.js +8 -3
  653. package/dist/workspace/exit-cli.d.ts +1 -1
  654. package/dist/workspace/exit-cli.d.ts.map +1 -1
  655. package/dist/workspace/exit-cli.js +2 -1
  656. package/dist/workspace/import-fetch.d.ts +4 -2
  657. package/dist/workspace/import-fetch.d.ts.map +1 -1
  658. package/dist/workspace/import-fetch.js +4 -2
  659. package/dist/workspace/import-init.d.ts.map +1 -1
  660. package/dist/workspace/import-init.js +4 -2
  661. package/dist/workspace/ledger.schema.json +7 -3
  662. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  663. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  664. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  665. package/dist/workspace/pr-report.schema.json +79 -3
  666. package/dist/workspace/promote.d.ts +1 -1
  667. package/dist/workspace/promote.d.ts.map +1 -1
  668. package/dist/workspace/promote.js +2 -1
  669. package/dist/workspace/records-cli.d.ts +2 -2
  670. package/dist/workspace/records-cli.d.ts.map +1 -1
  671. package/dist/workspace/records-cli.js +3 -2
  672. package/dist/workspace/release-catalog.schema.json +277 -0
  673. package/dist/workspace/run-event.schema.json +18 -1
  674. package/dist/workspace/work-cli.d.ts +3 -1
  675. package/dist/workspace/work-cli.d.ts.map +1 -1
  676. package/dist/workspace/work-cli.js +7 -2
  677. package/dist/workspace/workspace-run.d.ts.map +1 -1
  678. package/dist/workspace/workspace-run.js +2 -1
  679. package/package.json +21 -1
  680. package/src/__fixtures__/estate-ledger.ts +101 -0
  681. package/src/__fixtures__/oidc-emulator.ts +31 -2
  682. package/src/__fixtures__/product-words.ts +44 -0
  683. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  684. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  685. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  686. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  687. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  688. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  689. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  690. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  691. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  692. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  693. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  694. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  695. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  696. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  697. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  698. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  699. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  700. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  701. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  702. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  703. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  704. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  705. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  706. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  707. package/src/__golden__/wave-loop/op-point.json +18 -4
  708. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  709. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  710. package/src/__golden__/wave-loop/op-spend.json +10 -2
  711. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  712. package/src/__golden__/wave-loop/op-wide.json +20 -4
  713. package/src/bucket-check/azure.ts +307 -0
  714. package/src/bucket-check/bucket-check.test.ts +210 -0
  715. package/src/bucket-check/fixtures/azure.json +153 -0
  716. package/src/bucket-check/fixtures/gcs.json +148 -0
  717. package/src/bucket-check/fixtures/s3.json +277 -0
  718. package/src/bucket-check/gcs.ts +257 -0
  719. package/src/bucket-check/index.ts +61 -0
  720. package/src/bucket-check/s3.ts +433 -0
  721. package/src/bucket-check/types.ts +75 -0
  722. package/src/bucket-check/wire.ts +50 -0
  723. package/src/bucket-check.ts +5 -0
  724. package/src/capabilities/templates.test.ts +2 -3
  725. package/src/capabilities/templates.ts +1 -2
  726. package/src/cdk/advise.test.ts +1 -1
  727. package/src/change-set-bundle.test.ts +0 -1
  728. package/src/change-set.ts +2 -3
  729. package/src/ci-agent.test.ts +348 -0
  730. package/src/ci-agent.ts +1025 -0
  731. package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
  732. package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
  733. package/src/ci-audit/attribution.ts +260 -0
  734. package/src/ci-audit/audit-log.ts +220 -0
  735. package/src/ci-audit/ci-audit.test.ts +175 -0
  736. package/src/ci-audit/index.ts +15 -0
  737. package/src/ci-audit/unrecorded.ts +140 -0
  738. package/src/ci-audit.ts +2 -0
  739. package/src/ci-control.ts +173 -0
  740. package/src/ci-estate/delivery.ts +433 -0
  741. package/src/ci-estate/overdue.ts +81 -0
  742. package/src/ci-estate/page.ts +343 -0
  743. package/src/ci-estate/rows.ts +251 -0
  744. package/src/ci-estate.test.ts +281 -0
  745. package/src/ci-estate.ts +175 -0
  746. package/src/ci-handover.ts +67 -16
  747. package/src/ci-identity-database.test.ts +54 -0
  748. package/src/ci-identity-pulumi.test.ts +163 -0
  749. package/src/ci-identity-targets.test.ts +3 -1
  750. package/src/ci-identity.ts +123 -22
  751. package/src/ci-job-guard.test.ts +154 -0
  752. package/src/ci-job-guard.ts +319 -0
  753. package/src/ci-jobs.ts +8 -0
  754. package/src/ci-product-comment-targets.test.ts +45 -0
  755. package/src/ci-product-words.test.ts +101 -0
  756. package/src/ci-product-words.ts +565 -0
  757. package/src/ci-product.ts +226 -0
  758. package/src/ci-respond-run.ts +291 -0
  759. package/src/ci-respond.test.ts +264 -0
  760. package/src/ci-respond.ts +412 -0
  761. package/src/ci-shared-reads.test.ts +145 -0
  762. package/src/cli/commands/audit.test.ts +1 -1
  763. package/src/cli/commands/audit.ts +3 -2
  764. package/src/cli/commands/carve.test.ts +1 -1
  765. package/src/cli/commands/carve.ts +2 -2
  766. package/src/cli/commands/init.ts +3 -1
  767. package/src/cli/component-wave-args.test.ts +16 -0
  768. package/src/cli/handlers/agent.ts +126 -0
  769. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  770. package/src/cli/handlers/approve-confirm.ts +200 -0
  771. package/src/cli/handlers/approve.ts +18 -1
  772. package/src/cli/handlers/audit-log.ts +74 -0
  773. package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
  774. package/src/cli/handlers/build.test.ts +7 -0
  775. package/src/cli/handlers/build.ts +113 -1
  776. package/src/cli/handlers/ci-check-job.test.ts +114 -0
  777. package/src/cli/handlers/ci-check-job.ts +33 -0
  778. package/src/cli/handlers/ci-check.ts +63 -0
  779. package/src/cli/handlers/ci-forge-check.ts +91 -0
  780. package/src/cli/handlers/e2e-safe-run.ts +27 -0
  781. package/src/cli/handlers/fan-out.test.ts +10 -10
  782. package/src/cli/handlers/fan-out.ts +5 -0
  783. package/src/cli/handlers/gate-pending.ts +46 -0
  784. package/src/cli/handlers/init.ts +1 -0
  785. package/src/cli/handlers/ledger.ts +1 -1
  786. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  787. package/src/cli/handlers/lock.test.ts +29 -2
  788. package/src/cli/handlers/lock.ts +66 -6
  789. package/src/cli/handlers/notify-relay.ts +130 -0
  790. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  791. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  792. package/src/cli/handlers/pr-env.ts +48 -11
  793. package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
  794. package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
  795. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  796. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  797. package/src/cli/handlers/pr-waves.test.ts +8 -2
  798. package/src/cli/handlers/pr.test.ts +8 -8
  799. package/src/cli/handlers/pr.ts +879 -205
  800. package/src/cli/handlers/promote.test.ts +5 -5
  801. package/src/cli/handlers/promote.ts +22 -2
  802. package/src/cli/handlers/release.ts +2 -0
  803. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  804. package/src/cli/handlers/run-wave.ts +144 -2
  805. package/src/cli/handlers/run.test.ts +6 -4
  806. package/src/cli/handlers/run.ts +86 -1
  807. package/src/cli/handlers/serve.ts +10 -1
  808. package/src/cli/main.test.ts +1 -1
  809. package/src/cli/main.ts +180 -13
  810. package/src/cli/mcp/ledger-tools.ts +126 -0
  811. package/src/cli/mcp/product-tools.test.ts +123 -0
  812. package/src/cli/mcp/product-tools.ts +129 -0
  813. package/src/cli/mcp/read-only.test.ts +134 -0
  814. package/src/cli/mcp/read-only.ts +68 -0
  815. package/src/cli/mcp/report-tools.ts +135 -0
  816. package/src/cli/mcp/server.test.ts +5 -4
  817. package/src/cli/mcp/server.ts +90 -16
  818. package/src/cli/mcp-config.ts +8 -3
  819. package/src/cli/parse-args.ts +119 -2
  820. package/src/cli/registry.ts +73 -0
  821. package/src/cloud-lister/sigv4.ts +80 -23
  822. package/src/components/adoption.test.ts +140 -0
  823. package/src/components/adoption.ts +140 -0
  824. package/src/components/apply-lease.ts +49 -0
  825. package/src/components/capability.ts +180 -6
  826. package/src/components/check-hooks.test.ts +66 -0
  827. package/src/components/check-hooks.ts +255 -0
  828. package/src/components/check-steps.test.ts +70 -0
  829. package/src/components/check-steps.ts +158 -0
  830. package/src/components/ci-services.test.ts +51 -0
  831. package/src/components/ci-services.ts +82 -0
  832. package/src/components/cli-support.ts +23 -2
  833. package/src/components/driver.test.ts +3 -3
  834. package/src/components/driver.ts +73 -6
  835. package/src/components/fan-out-run.ts +68 -18
  836. package/src/components/groups.ts +21 -4
  837. package/src/components/plan-flags.test.ts +46 -0
  838. package/src/components/pr-comment-preview-targets.test.ts +34 -0
  839. package/src/components/pr-comment-preview.test.ts +54 -0
  840. package/src/components/pr-env-ledger.test.ts +9 -0
  841. package/src/components/pr-env-ledger.ts +42 -0
  842. package/src/components/pr-env-ports.ts +29 -4
  843. package/src/components/pr-env-run-bundle.test.ts +2 -14
  844. package/src/components/pr-env-run.test.ts +19 -0
  845. package/src/components/pr-env-run.ts +12 -2
  846. package/src/components/pr-environment.test.ts +29 -0
  847. package/src/components/pr-environment.ts +40 -8
  848. package/src/components/pr-pipeline-runners.test.ts +80 -0
  849. package/src/components/pr-pipeline.test.ts +15 -0
  850. package/src/components/pr-pipeline.ts +498 -18
  851. package/src/components/pr-policy.ts +45 -7
  852. package/src/components/pr-run.test.ts +1 -1
  853. package/src/components/pr-run.ts +138 -11
  854. package/src/components/pr-stale-job.test.ts +34 -0
  855. package/src/components/pr-targets.test.ts +35 -0
  856. package/src/components/pr-targets.ts +45 -0
  857. package/src/components/product-pipeline.test.ts +200 -0
  858. package/src/components/product-pipeline.ts +383 -0
  859. package/src/components/promote.ts +10 -1
  860. package/src/components/release-compile.ts +87 -1
  861. package/src/components/release-promote.ts +65 -1
  862. package/src/components/repo-lock.ts +52 -0
  863. package/src/components/row-lease.test.ts +490 -0
  864. package/src/components/row-lease.ts +167 -0
  865. package/src/components/wave-plan-policy.test.ts +19 -0
  866. package/src/components/wave-plan.ts +96 -6
  867. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  868. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  869. package/src/control/applied.test.ts +148 -0
  870. package/src/control/applied.ts +191 -0
  871. package/src/control/consumers.test.ts +129 -0
  872. package/src/control/consumers.ts +192 -0
  873. package/src/control/control.test.ts +302 -0
  874. package/src/control/dispatch.ts +699 -0
  875. package/src/control/edges.test.ts +112 -0
  876. package/src/control/edges.ts +164 -0
  877. package/src/control/note-checkout.test.ts +91 -0
  878. package/src/control/reconcile.ts +250 -0
  879. package/src/control/records.ts +395 -0
  880. package/src/discovery/sandbox/bundle.ts +25 -1
  881. package/src/e2e-harness/__project__/chant.config.ts +4 -0
  882. package/src/e2e-harness/__project__/src/compose.ts +33 -0
  883. package/src/e2e-harness/bucket.ts +69 -0
  884. package/src/e2e-harness/claim.test.ts +150 -0
  885. package/src/e2e-harness/claim.ts +140 -0
  886. package/src/e2e-harness/driver.test.ts +304 -0
  887. package/src/e2e-harness/driver.ts +294 -0
  888. package/src/e2e-harness/forgejo.ts +267 -0
  889. package/src/e2e-harness/git.ts +96 -0
  890. package/src/e2e-harness/index.ts +50 -0
  891. package/src/e2e-harness/jobs.ts +35 -0
  892. package/src/e2e-harness/pins.ts +52 -0
  893. package/src/e2e-harness/ports.ts +130 -0
  894. package/src/e2e-harness/reports.ts +79 -0
  895. package/src/e2e-harness/safe-run-cli.test.ts +102 -0
  896. package/src/e2e-harness/safe-run-cli.ts +54 -0
  897. package/src/e2e-harness/safe-run.ts +198 -0
  898. package/src/e2e-harness/scenario.ts +89 -0
  899. package/src/e2e-harness/schemas/README.md +62 -0
  900. package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  901. package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
  902. package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  903. package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  904. package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  905. package/src/e2e-harness/schemas/index.ts +220 -0
  906. package/src/e2e-harness/schemas.test.ts +145 -0
  907. package/src/e2e-harness/stack.test.ts +124 -0
  908. package/src/e2e-harness/stack.ts +306 -0
  909. package/src/e2e-harness/steps.ts +30 -0
  910. package/src/e2e-harness.ts +2 -0
  911. package/src/engine-facts.test.ts +2 -3
  912. package/src/engine-facts.ts +1 -2
  913. package/src/exit-codes.test.ts +32 -0
  914. package/src/exit-codes.ts +61 -0
  915. package/src/forge-check/check.ts +155 -0
  916. package/src/forge-check/contract.ts +215 -0
  917. package/src/forge-check/forge-check.test.ts +427 -0
  918. package/src/forge-check/forge.ts +318 -0
  919. package/src/forge-check/index.ts +43 -0
  920. package/src/forge-check/pulumi.ts +192 -0
  921. package/src/forge-check/read-only.ts +56 -0
  922. package/src/forge-check/trust.ts +527 -0
  923. package/src/forge-check/types.ts +78 -0
  924. package/src/forge-check.ts +5 -0
  925. package/src/gate-decision-bundle.test.ts +11 -0
  926. package/src/gate-decision.ts +3 -0
  927. package/src/gate-policy.ts +92 -3
  928. package/src/gated-waves-bundle.test.ts +0 -1
  929. package/src/index.ts +2 -0
  930. package/src/lexicon.ts +143 -6
  931. package/src/lifecycle/adoption-file.ts +1 -2
  932. package/src/lifecycle/cloud-index.test.ts +2 -3
  933. package/src/lifecycle/cloud-index.ts +1 -2
  934. package/src/lifecycle/control-entries-ledger.test.ts +69 -0
  935. package/src/lifecycle/gate-applied.ts +6 -0
  936. package/src/lifecycle/gate-ledger.ts +35 -1
  937. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  938. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  939. package/src/lifecycle/gated-request-digest.ts +49 -0
  940. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  941. package/src/lifecycle/gated-request.ts +279 -0
  942. package/src/lifecycle/identity-match.ts +25 -6
  943. package/src/lifecycle/index-diff.ts +1 -2
  944. package/src/lifecycle/index-document.ts +1 -2
  945. package/src/lifecycle/index-import.test.ts +14 -0
  946. package/src/lifecycle/index-import.ts +54 -34
  947. package/src/lifecycle/ledger-read.ts +7 -3
  948. package/src/lifecycle/lock-rows.test.ts +109 -0
  949. package/src/lifecycle/lock-rows.ts +167 -0
  950. package/src/lifecycle/publish-target-context.test.ts +108 -0
  951. package/src/lifecycle/query.test.ts +2 -3
  952. package/src/lifecycle/query.ts +109 -8
  953. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  954. package/src/lifecycle/release-catalog-site.ts +291 -0
  955. package/src/lifecycle/release-catalog.test.ts +192 -0
  956. package/src/lifecycle/release-catalog.ts +353 -0
  957. package/src/lifecycle/release-changelog.test.ts +70 -0
  958. package/src/lifecycle/release-changelog.ts +71 -0
  959. package/src/lifecycle/release-cut.ts +2 -2
  960. package/src/lifecycle/release-ledger.ts +19 -0
  961. package/src/lifecycle/release-publish.ts +45 -22
  962. package/src/lifecycle/release-read.ts +2 -0
  963. package/src/lifecycle/release-status.test.ts +185 -0
  964. package/src/lifecycle/release-status.ts +175 -0
  965. package/src/lifecycle/resource-lock.test.ts +175 -0
  966. package/src/lifecycle/resource-lock.ts +354 -0
  967. package/src/lifecycle/retention.ts +2 -0
  968. package/src/lifecycle/run-ledger.ts +7 -1
  969. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  970. package/src/lifecycle/snapshot-store.ts +1 -2
  971. package/src/lifecycle/target-lock.ts +24 -9
  972. package/src/lifecycle/wave-plans.ts +33 -5
  973. package/src/mcp/types.ts +7 -0
  974. package/src/notify-product.ts +76 -0
  975. package/src/notify-relay.test.ts +213 -0
  976. package/src/notify-relay.ts +407 -0
  977. package/src/notify.ts +95 -14
  978. package/src/object-store/azure-blob.ts +374 -0
  979. package/src/object-store/common.ts +133 -0
  980. package/src/object-store/errors.ts +26 -0
  981. package/src/object-store/from-env.ts +36 -0
  982. package/src/object-store/gcs.ts +436 -0
  983. package/src/object-store/index.ts +8 -0
  984. package/src/object-store/object-store.test.ts +130 -0
  985. package/src/object-store/s3.ts +350 -0
  986. package/src/op/activities/converge.ts +2 -1
  987. package/src/op/activities/index.ts +1 -1
  988. package/src/op/activities/review-agent.open.test.ts +78 -0
  989. package/src/op/activities/review-agent.test.ts +13 -0
  990. package/src/op/activities/review-agent.ts +89 -5
  991. package/src/op/approval-status.test.ts +134 -0
  992. package/src/op/approval-status.ts +235 -0
  993. package/src/op/gate-review.test.ts +2 -1
  994. package/src/op/gate.ts +81 -22
  995. package/src/op/generate-pipeline.ts +7 -1
  996. package/src/op/index.ts +23 -0
  997. package/src/op/op-waves-after-plan.test.ts +288 -0
  998. package/src/op/op-waves-after-plan.ts +238 -0
  999. package/src/op/op-waves-capability-spec.ts +133 -0
  1000. package/src/op/op-waves-capability.test.ts +217 -0
  1001. package/src/op/op-waves-capability.ts +370 -0
  1002. package/src/op/op-waves-events.ts +135 -0
  1003. package/src/op/op-waves-notify-words.test.ts +149 -0
  1004. package/src/op/op-waves-notify.ts +41 -16
  1005. package/src/op/op-waves-parallelism.test.ts +89 -0
  1006. package/src/op/op-waves-pull-request.test.ts +219 -0
  1007. package/src/op/op-waves-release-port.ts +64 -0
  1008. package/src/op/op-waves-release.test.ts +209 -0
  1009. package/src/op/op-waves-release.ts +132 -0
  1010. package/src/op/op-waves-run-record.test.ts +32 -0
  1011. package/src/op/op-waves-run.ts +1235 -52
  1012. package/src/op/op-waves-stand-down.test.ts +240 -0
  1013. package/src/op/op-waves-stand-down.ts +107 -0
  1014. package/src/op/op-waves-trace.test.ts +205 -0
  1015. package/src/op/op-waves.test.ts +112 -0
  1016. package/src/op/op-waves.ts +320 -22
  1017. package/src/op/runtime.ts +107 -0
  1018. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  1019. package/src/op/stage-hooks.ts +91 -12
  1020. package/src/op/steward-beside.ts +2 -1
  1021. package/src/op/types.ts +3 -2
  1022. package/src/otlp-metrics.ts +96 -0
  1023. package/src/otlp.test.ts +243 -0
  1024. package/src/otlp.ts +543 -0
  1025. package/src/override-gate-bundle.test.ts +2 -0
  1026. package/src/override-gate.ts +4 -0
  1027. package/src/parallelism.test.ts +38 -0
  1028. package/src/parallelism.ts +33 -0
  1029. package/src/policy-packs.ts +230 -0
  1030. package/src/policy-source.test.ts +256 -0
  1031. package/src/policy-source.ts +111 -0
  1032. package/src/pr-forge-bundle.test.ts +1 -1
  1033. package/src/pr-forge.ts +175 -33
  1034. package/src/pr-loop-bundle.test.ts +7 -3
  1035. package/src/pr-loop-narrowed.test.ts +63 -0
  1036. package/src/pr-loop-words.test.ts +155 -0
  1037. package/src/pr-loop.ts +398 -52
  1038. package/src/pr-merge.test.ts +100 -0
  1039. package/src/pr-merge.ts +105 -0
  1040. package/src/pr-post-stale.test.ts +163 -0
  1041. package/src/pr-post.ts +190 -5
  1042. package/src/pr-report-url.ts +61 -6
  1043. package/src/pr-requires.test.ts +37 -1
  1044. package/src/pr-requires.ts +16 -2
  1045. package/src/product-subpaths-plain-node.e2e.test.ts +212 -0
  1046. package/src/release-floors.ts +1 -1
  1047. package/src/run-event.ts +28 -1
  1048. package/src/scheduled-op-cloud.ts +68 -0
  1049. package/src/sorted-json.ts +17 -0
  1050. package/src/stage-hooks-bundle.test.ts +6 -0
  1051. package/src/terraform/credentials.test.ts +77 -0
  1052. package/src/terraform/credentials.ts +162 -0
  1053. package/src/utils.ts +2 -11
  1054. package/src/wave-loop-golden.test.ts +2 -1
  1055. package/src/wave-runtime.ts +2 -2
  1056. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  1057. package/src/workspace/ci-lock-grain.test.ts +31 -0
  1058. package/src/workspace/ci-lock-grain.ts +29 -0
  1059. package/src/workspace/ci-report-url.test.ts +1 -1
  1060. package/src/workspace/ci-run.test.ts +1 -1
  1061. package/src/workspace/ci-run.ts +10 -3
  1062. package/src/workspace/declaration.schema.json +27 -3
  1063. package/src/workspace/declaration.test.ts +1 -1
  1064. package/src/workspace/declaration.ts +26 -10
  1065. package/src/workspace/drift-cli.ts +8 -3
  1066. package/src/workspace/exit-cli.ts +2 -1
  1067. package/src/workspace/import-fetch.ts +4 -2
  1068. package/src/workspace/import-init.ts +4 -2
  1069. package/src/workspace/ledger.schema.json +7 -3
  1070. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  1071. package/src/workspace/pr-report.schema.json +79 -3
  1072. package/src/workspace/promote.ts +2 -1
  1073. package/src/workspace/records-cli.ts +3 -2
  1074. package/src/workspace/release-catalog.schema.json +277 -0
  1075. package/src/workspace/run-event.schema.json +18 -1
  1076. package/src/workspace/work-cli.ts +8 -2
  1077. 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,7 @@
1
1
  import type { InstanceObservation } from "./instance-nodes";
2
+ import type { CiRunner } from "./ci-jobs";
3
+ import type { OpAgentSpec } from "./ci-agent";
4
+ import type { CloudTradeSpec } from "./ci-identity";
2
5
  import type { EngineFacts } from "./engine-facts";
3
6
  import type { CapabilityPack } from "./capabilities/view";
4
7
  import type { Serializer } from "./serializer";
@@ -14,6 +17,7 @@ import type { ArtifactIntegrity } from "./lexicon-integrity";
14
17
  import type { GatedWavePipelineOptions } from "./components/gated-wave-pipeline";
15
18
  import type { PrLoopPipelineOptions } from "./components/pr-pipeline";
16
19
  import type { OpWaveJob, OpWavesSpec } from "./op/op-waves";
20
+ import type { ChangeSetDocument } from "./change-set";
17
21
  import type { OkfFile } from "./okf";
18
22
  import type { CompletionContext, CompletionItem, HoverContext, HoverInfo, CodeActionContext, CodeAction } from "./lsp/types";
19
23
  import type { McpToolContribution, McpResourceContribution } from "./mcp/types";
@@ -73,6 +77,7 @@ export type { ReferenceCatalog, IdentityRule, RefRule } from "./graph-refs";
73
77
  // An observation can report relationships (#1271/#1273), so a lexicon needs the
74
78
  // edge type from the same entry it imports the plugin contract from.
75
79
  export type { IREdge } from "./graph-ir";
80
+ export type { OpAgentSpec } from "./ci-agent";
76
81
 
77
82
  // The observation contract (#1089), re-exported from the same entry so a
78
83
  // lexicon's `describeResources` can report NOT-OBSERVED without a second
@@ -905,13 +910,68 @@ export interface ScheduledOpSpec {
905
910
  * token (the checkout's fetches get the job's token and nothing after
906
911
  * them does) and hands the review on as job outputs. The second checks
907
912
  * 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.
913
+ * write token (`postReviewNote`). On GitLab (#4544) the first job keeps the
914
+ * review as an artifact of the merge request pipeline, and the second runs
915
+ * in a pipeline of the default branch, started by a schedule with
916
+ * `CHANT_REVIEW_NOTES` set to `1`, which holds the protected token and posts
917
+ * every open merge request's review (`postOpenReviewNotes`). The trigger
918
+ * must be `pull_request` and the finding-mode `report`, since the first job
919
+ * posts nothing.
913
920
  */
914
921
  reviewAgent?: boolean;
922
+ /**
923
+ * Where this Op's generated jobs run (#4616): a runner label, a list of
924
+ * labels, or on GitHub a runner group, as an Op wave's `runner` (#3914).
925
+ * `runs-on` on GitHub and Forgejo, `tags` on GitLab; a runner group on
926
+ * GitLab or Forgejo is refused. Default: the forge's default runner.
927
+ */
928
+ runner?: CiRunner;
929
+ /**
930
+ * The agent jobs (#4616, ../ci-agent.ts). `on: "comment"`: this spec is the
931
+ * agent's own workflow, answering `/<product> agent <ask>` on a pull
932
+ * request, and `trigger` is not read. `on: "drift"`: the agent and push
933
+ * jobs follow this Op's job and run when its run exits with chant's
934
+ * `drift` code, opening or updating a pull request from the agent's
935
+ * branch. The model's job holds no write token; the push job does.
936
+ */
937
+ agent?: OpAgentSpec;
938
+ /**
939
+ * The job's cloud identities (#4631), as an op wave's `cloud` (#4332,
940
+ * #4549): the three generators trade the job's OIDC token for them in a
941
+ * step before the checkout, and every later step drops the variables a
942
+ * token is requested with. The job alone gets `id-token: write`; the
943
+ * finding-mode's permissions stay as they are. Build one with
944
+ * `cloudIdentityWave` from `@intentius/chant/ci-identity`.
945
+ */
946
+ cloud?: CloudTradeSpec;
947
+ /**
948
+ * An update the Op's run starts on drift (#4631): a job of its own after
949
+ * the Op's job, started only when the run exits with chant's drift code,
950
+ * which trades for `update.cloud` and runs `update.command`. The drift
951
+ * check never holds the update's identity, and the update never runs the
952
+ * check. A cron or pull_request trigger only.
953
+ */
954
+ update?: ScheduledOpUpdate;
955
+ }
956
+
957
+ /** A scheduled Op's update on drift (#4631). */
958
+ export interface ScheduledOpUpdate {
959
+ /** The shell line the update job runs, such as `npx --no-install plywood up`. */
960
+ command: string;
961
+ /** The identity only the update job holds. Absent: the update runs with no cloud identity of its own. */
962
+ cloud?: CloudTradeSpec;
963
+ /**
964
+ * Scopes the update job adds to `contents: read`, as
965
+ * {@link ScheduledOpSpec.permissions}. `contents: "write"` raises the
966
+ * update job's own contents scope (2026-10-28 ruling), so the update can
967
+ * record on `chant/lifecycle`; the Op's own job keeps its scopes. GitHub
968
+ * and Forgejo only: GitLab has no per-job token scopes.
969
+ */
970
+ permissions?: Record<string, "read" | "write">;
971
+ /** The forge environment the update job runs in. */
972
+ environment?: OpEnvironment;
973
+ /** Variables for the update job alone. */
974
+ variables?: Record<string, string>;
915
975
  }
916
976
 
917
977
  /**
@@ -976,6 +1036,19 @@ export interface OpWavesPipelineOptions
976
1036
  extends Pick<ComponentPipelineOptions, "image" | "beforeScript" | "extraScript" | "variables" | "opsStage" | "opsFileName"> {
977
1037
  /** The spec's path from the repository root. Every job runs `chant run wave --spec <specFile>`. */
978
1038
  specFile: string;
1039
+ /**
1040
+ * The command every job runs in place of `chant` (#4607): a product's
1041
+ * `words.bin`, such as `npx --no-install plywood`. `chant run --generate`
1042
+ * fills it from the active product words, so a product's bin that runs
1043
+ * the generator in process gets its own bin in the jobs. Absent: `chant`.
1044
+ */
1045
+ bin?: string;
1046
+ /**
1047
+ * The product's words (#4617), for the control dispatch a spec's
1048
+ * `control` adds: its event type and messages. `chant run --generate`
1049
+ * fills it from the active product words. Absent: chant's.
1050
+ */
1051
+ words?: import("./ci-product-words").CiProductWordsInput | import("./ci-product-words").CiProductWords;
979
1052
  }
980
1053
 
981
1054
  /** An Op waves pipeline: one file, and its jobs in order. */
@@ -1443,6 +1516,66 @@ export interface LexiconPlugin {
1443
1516
  */
1444
1517
  generateOpWavesPipeline?(spec: OpWavesSpec, options: OpWavesPipelineOptions): OpWavesPipelineResult;
1445
1518
 
1519
+ /**
1520
+ * The shell lines that install this lexicon's engine into the default CI
1521
+ * image (#4550): OpenTofu, and choudoufu where a member uses it, for
1522
+ * terraform; Pulumi, or plunge where the member's engine is plunge, for
1523
+ * pulumi. The pull request pipeline joins the lines of the lexicons its
1524
+ * project lists, in place of installing OpenTofu for everyone. A caller's
1525
+ * own image turns them off. `dir` is the project the pipeline is for.
1526
+ * Return none when the project needs nothing from this lexicon.
1527
+ */
1528
+ ciSetup?(ctx: { dir: string }): string[];
1529
+
1530
+ /**
1531
+ * The job services this lexicon's CI jobs start beside them (#4572,
1532
+ * `./components/ci-services.ts`): throwaway servers such as the sql
1533
+ * lexicon's replay server per dialect, each image pinned by the lexicon.
1534
+ * A product's job renders them for its forge. `dir` is the project the
1535
+ * pipeline is for. Return none when the project needs none.
1536
+ */
1537
+ ciServices?(ctx: { dir: string }): import("./components/ci-services").CiService[];
1538
+
1539
+ /**
1540
+ * A section of the pull request note for one member (#4573): rows a
1541
+ * resource table does not carry, rendered from the member's own part of
1542
+ * the change set, such as a SQL member's statements with their class, the
1543
+ * policy outcome per rule and its override line. chant places it under the
1544
+ * member table, in a collapsed block, and leaves it out when the note would
1545
+ * pass the forge's comment limit. Undefined for a member it has nothing for.
1546
+ */
1547
+ prNoteDetail?(input: { member: string; changeSet: ChangeSetDocument; stage: "plan" | "apply" | "record" }): { title?: string; lines: string[] } | undefined | Promise<{ title?: string; lines: string[] } | undefined>;
1548
+
1549
+ /**
1550
+ * Whether `ci.prEnvironment.template` names one of this lexicon's own
1551
+ * stacks rather than a chant.config.ts environment (#4609). The pulumi
1552
+ * lexicon takes `<project>/<stack>`, plywood's `review_stacks.template`.
1553
+ * Returns a short description of the stack when it does, for the log line,
1554
+ * and undefined when it does not, so `pr-env up` checks the template
1555
+ * against the declared environments as before.
1556
+ */
1557
+ prEnvTemplate?(template: string): string | undefined;
1558
+
1559
+ /**
1560
+ * A teardown for what this lexicon made in a pull request's environment
1561
+ * and its own `teardownOwned` does not reach (#4609): the pulumi lexicon
1562
+ * removes each review stack `pr-<n>` the environment's record names in
1563
+ * `locations`. `pr-env down` and `sweep` run it beside the lexicons'
1564
+ * teardowns, under the same marker check. `cwd` is the project root the
1565
+ * locations are relative to.
1566
+ */
1567
+ prEnvTeardown?(ctx: { cwd: string }): import("./components/pr-environment").PrEnvTeardownAdapter | undefined;
1568
+
1569
+ /**
1570
+ * This lexicon's steps in the check stage (#4633,
1571
+ * `./components/check-steps.ts`): `chant ci check` runs them after the
1572
+ * `ci.hooks.check` hooks for each workspace member of the adapter's kinds,
1573
+ * with the check job's environment (no forge token, no cloud credentials).
1574
+ * The pulumi lexicon runs `pulumi install`, a stack config check and
1575
+ * `pulumi about --json` per pulumi member. Return undefined for none.
1576
+ */
1577
+ checkSteps?(): import("./components/check-steps").CheckStepsAdapter | undefined;
1578
+
1446
1579
  /**
1447
1580
  * Host Op runs — the seam `chant run <op> --on <this lexicon>` dispatches to
1448
1581
  * (#2121, epic #2114). Core ships one provider of its own, `local`, and
@@ -1603,7 +1736,11 @@ export interface LexiconPlugin {
1603
1736
  composites?(): CompositeEntry[];
1604
1737
 
1605
1738
  // MCP
1606
- /** Return MCP tool contributions */
1739
+ /**
1740
+ * Return MCP tool contributions. A tool is served by
1741
+ * `chant serve mcp --read-only` only when it sets `readOnly: true`
1742
+ * (chant#4543); the flag is a promise that the tool changes nothing.
1743
+ */
1607
1744
  mcpTools?(): McpToolContribution[];
1608
1745
 
1609
1746
  /** 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,69 @@
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 type { LedgerReadPort } from "./ledger-port";
10
+ import { ledgerFields, LEDGER_TABLES, LEDGER_TIME_COLUMN } from "./ledger-read";
11
+ import { LEDGER_CONTROL_ENTRIES_FLOOR, loadQueryData, QUERY_TABLES, runQuery } from "./query";
12
+
13
+ function port(files: Record<string, string>): LedgerReadPort {
14
+ return {
15
+ read: async (dir, file) => files[`${dir}/${file}`] ?? null,
16
+ list: async (dir) => Object.keys(files).filter((p) => p.startsWith(`${dir}/`)).map((p) => p.slice(dir.length + 1)),
17
+ trees: async () => [...new Set(Object.keys(files).map((p) => p.slice(0, p.indexOf("/"))))],
18
+ };
19
+ }
20
+
21
+ function record(fields: Omit<ControlEntryRecord, "digest" | "version" | "kind">): ControlEntryRecord {
22
+ const body = { version: 1 as const, kind: "control-entry" as const, ...fields };
23
+ return { ...body, digest: controlEntryDigest(body) };
24
+ }
25
+
26
+ const project = "github.com/acme/network";
27
+ 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 });
28
+ 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 });
29
+ 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 });
30
+ const tampered = { ...defaults, settings: { lockGrain: "repo" } };
31
+
32
+ const FIXTURE = {
33
+ "_control/entries.jsonl": [v1, defaults, v2, tampered].map((r) => JSON.stringify(r)).join("\n") + "\nnot json\n",
34
+ };
35
+
36
+ describe("control_entries", () => {
37
+ test("one row per version, with its digest, the digest it replaced and whether it is current", async () => {
38
+ const { data, malformed } = await loadQueryData([{ member: "control", port: port(FIXTURE) }]);
39
+ expect(data.control_entries).toEqual([
40
+ { 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 },
41
+ { 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 },
42
+ { 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 },
43
+ ]);
44
+ // The tampered line (its digest no longer matches) and the line that is not JSON.
45
+ expect(malformed.control_entries).toBe(2);
46
+ });
47
+
48
+ test("chant query joins a version to the one it replaced", async () => {
49
+ const load = await loadQueryData([{ member: "control", port: port(FIXTURE) }]);
50
+ 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);
51
+ expect(result.rows).toEqual([{ id: "ctl-001", digest: v2.digest, replaced: v1.digest }]);
52
+ });
53
+
54
+ test("a ledger with no control repo entries has no rows", async () => {
55
+ const { data } = await loadQueryData([{ member: null, port: port({ "_gates/x.jsonl": "" }) }]);
56
+ expect(data.control_entries).toEqual([]);
57
+ });
58
+
59
+ test("chant ledger lists the table, with settings and estates as JSON, current as a boolean and timestamp for --since", () => {
60
+ expect(LEDGER_TABLES).toContain("control_entries");
61
+ expect(LEDGER_TIME_COLUMN.control_entries).toBe("timestamp");
62
+ expect(ledgerFields("control_entries")).toMatchObject({ settings: "json", estates: "json", current: "boolean", timestamp: "time", digest: "text", prev_digest: "text" });
63
+ expect(QUERY_TABLES.control_entries.map(([c]) => c)).toEqual(["member", "id", "entry", "project", "state", "product", "settings", "estates", "by", "timestamp", "digest", "prev_digest", "current"]);
64
+ });
65
+
66
+ test("the table's floor shipped in 0.124.55", () => {
67
+ expect(LEDGER_CONTROL_ENTRIES_FLOOR).toBe("0.124.55");
68
+ });
69
+ });
@@ -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,13 @@ 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 { gatedRequestOf, type GatedRequest } from "./gated-request-digest";
52
+
53
+ /** The first chant that writes `changeSet` on a pending fact and an approval (#4551). */
54
+ export const GATE_CHANGE_SET_FLOOR = "0.124.55";
55
+
56
+ /** The first chant that writes `request` on a pending fact and reads gated requests (#4551). */
57
+ export const GATED_REQUEST_FLOOR = "0.124.55";
51
58
 
52
59
  // The facts a pending record is written with live apart, so a bundle can import them without git (#3816).
53
60
  export { DEFAULT_GATE_EXPIRY, isApprovalUrl, resolveApprovalUrl } from "./gate-pending";
@@ -171,6 +178,13 @@ export interface GateResolutionRecord {
171
178
  * 0.124.28.
172
179
  */
173
180
  releaseDigest?: string;
181
+ /**
182
+ * The change set this approval was asked for (#4551), copied off the
183
+ * pending fact it answers when it approves that fact's plan: the digest of
184
+ * a document in `_change-sets/`. Absent on an approval of another plan,
185
+ * and on a resolution written before {@link GATE_CHANGE_SET_FLOOR}.
186
+ */
187
+ changeSet?: string;
174
188
  /**
175
189
  * The resolution passes a release gate over an empty change set (#4045,
176
190
  * ws-104 question 6): the promote wrote it itself, with the actor running
@@ -390,6 +404,15 @@ export interface PendingGateRecord {
390
404
  * Absent on every other gate, and on a fact written before 0.124.28.
391
405
  */
392
406
  releaseDigest?: string;
407
+ /**
408
+ * The change set this gate waits on (#4551): the digest of a document in
409
+ * `_change-sets/` (`./change-set-store.ts`), stored before this fact, so a
410
+ * refusal or a respond job reads the plans the approval is asked for. An op
411
+ * wave sets it from its plans file's `changeSet`; a pull-request or release
412
+ * gate, whose `planDigest` is already a change set's digest, sets it to the
413
+ * same value. Absent on a fact written before {@link GATE_CHANGE_SET_FLOOR}.
414
+ */
415
+ changeSet?: string;
393
416
  /**
394
417
  * The channel the run that reached this gate was driven from (chant#2384).
395
418
  *
@@ -433,6 +456,14 @@ export interface PendingGateRecord {
433
456
  * not `chant approve`.
434
457
  */
435
458
  answer?: GateAnswerRef;
459
+ /**
460
+ * The request this fact asks an approval of (#4551), on a gated request for
461
+ * an op that has no wave, such as a state export or a lock release
462
+ * (`./gated-request.ts`). `planDigest` is its `gatedRequestDigest`. Absent
463
+ * on every other fact, and on one written before chant
464
+ * {@link GATED_REQUEST_FLOOR}.
465
+ */
466
+ request?: GatedRequest;
436
467
  }
437
468
 
438
469
  export type PendingGateInput = Omit<PendingGateRecord, "version" | "kind">;
@@ -594,7 +625,8 @@ export function parseGateLedger(
594
625
  continue;
595
626
  }
596
627
  // #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) {
628
+ // #4551: and so is a `changeSet` that is not a digest.
629
+ for (const key of ["gitSha", "runId", "changeSet"] as const) {
598
630
  const v: unknown = (parsed as Record<string, unknown>)[key];
599
631
  if (v !== undefined && typeof v !== "string") delete (parsed as Record<string, unknown>)[key];
600
632
  }
@@ -609,6 +641,8 @@ export function parseGateLedger(
609
641
  if (w !== undefined && !(w && typeof w === "object" && typeof w.number === "number" && typeof w.name === "string")) delete rec.wave;
610
642
  const h = (parsed as { heldBy?: unknown }).heldBy as Partial<PendingGateHeldBy> | null | undefined;
611
643
  if (h !== undefined && !(h && typeof h === "object" && typeof h.hook === "string" && typeof h.moment === "string")) delete rec.heldBy;
644
+ // #4551: a `request` of the wrong shape is dropped too.
645
+ if ((parsed as { request?: unknown }).request !== undefined && !gatedRequestOf((parsed as { request?: unknown }).request)) delete rec.request;
612
646
  pending.push(rec);
613
647
  continue;
614
648
  }
@@ -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
+ });