@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
@@ -13,7 +13,15 @@
13
13
  * - the gate ledgers, `_gates/<op>.jsonl` (`./gate-ledger.ts`);
14
14
  * - the deploy records, `<env>/releases.jsonl` (`./release-read.ts`);
15
15
  * - the releases and their cuts, `_releases/<digest>.json` and
16
- * `_releases/cuts.jsonl` (`./release-store.ts`).
16
+ * `_releases/cuts.jsonl` (`./release-store.ts`);
17
+ * - the applies under an approval, `_gates/<op>/applied.jsonl`
18
+ * (`./gate-applied.ts`), each joined with its `finished` line (#4551);
19
+ * - the pull request environments, `_pr-envs/records.jsonl`
20
+ * (`../components/pr-environment.ts`, #4551);
21
+ * - the control repo's entries, `_control/entries.jsonl`
22
+ * (`../control/records.ts`, #4568, #4593);
23
+ * - the release status records, `<env>/release-status.jsonl`
24
+ * (`./release-status.ts`, #4596).
17
25
  *
18
26
  * The tables are a contract. {@link QUERY_SCHEMA_VERSION} names it, and the
19
27
  * `chant_schema` table lists every table and column with the version, so a
@@ -36,7 +44,10 @@ import { parseReleaseLedger, releaseLedgerLines } from "./release-read";
36
44
  import { CUTS_FILE, parseCuts, parseRelease, RELEASES_DIR, verifyReleaseDigest } from "./release-store";
37
45
  import { opOfRunLedgerFile, parseRunLedger } from "./run-ledger";
38
46
  import type { LifecycleSnapshot } from "./types";
39
- import { NEXT_RELEASE } from "../release-floors";
47
+ import { appliedGatePath, finishedApply, parseAppliedGateFile } from "./gate-applied";
48
+ import { PR_ENV_LEDGER_DIR, PR_ENV_LEDGER_FILE, parsePrEnvRecords } from "../components/pr-environment";
49
+ import { CONTROL_LEDGER_DIR, CONTROL_LEDGER_FILE, parseControlEntries } from "../control/records";
50
+ import { parseReleaseStatus, RELEASE_STATUS_FILE } from "./release-status";
40
51
 
41
52
  /** The version of the table schema below. */
42
53
  export const QUERY_SCHEMA_VERSION = 1;
@@ -71,15 +82,50 @@ export const QUERY_TABLES = {
71
82
  * Op names its root only by key and Init is what resolves it. A run whose
72
83
  * `terraform init` itself failed still names it (#4512).
73
84
  */
74
- runs: [["member", "TEXT"], ["id", "TEXT"], ["op", "TEXT"], ["env", "TEXT"], ["started", "TEXT"], ["ended", "TEXT"], ["status", "TEXT"], ["git_sha", "TEXT"], ["forge", "TEXT"], ["run_url", "TEXT"], ["failure_code", "TEXT"], ["failure_reason", "TEXT"], ["failed_phase", "TEXT"], ["gate", "TEXT"], ["steward", "TEXT"], ["labels", "TEXT"], ["outcomes", "TEXT"], ["root_member", "TEXT"]],
75
- /** One row per gate ledger line: `kind` is `pending` or `resolution`. `signed` is 1 for a sealed approval. */
76
- gates: [["member", "TEXT"], ["op", "TEXT"], ["gate", "TEXT"], ["kind", "TEXT"], ["timestamp", "TEXT"], ["resolved_by", "TEXT"], ["relayed_by", "TEXT"], ["approver_kind", "TEXT"], ["plan_digest", "TEXT"], ["environment", "TEXT"], ["release_digest", "TEXT"], ["git_sha", "TEXT"], ["run_id", "TEXT"], ["url", "TEXT"], ["note", "TEXT"], ["expires_at", "TEXT"], ["origin", "TEXT"], ["empty", "INTEGER"], ["signed", "INTEGER"]],
85
+ runs: [["member", "TEXT"], ["id", "TEXT"], ["op", "TEXT"], ["env", "TEXT"], ["started", "TEXT"], ["ended", "TEXT"], ["status", "TEXT"], ["git_sha", "TEXT"], ["forge", "TEXT"], ["run_url", "TEXT"], ["failure_code", "TEXT"], ["failure_reason", "TEXT"], ["failed_phase", "TEXT"], ["gate", "TEXT"], ["steward", "TEXT"], ["labels", "TEXT"], ["outcomes", "TEXT"], ["root_member", "TEXT"], ["wave", "TEXT"]],
86
+ /**
87
+ * One row per gate ledger line: `kind` is `pending` or `resolution`.
88
+ * `signed` is 1 for a sealed approval. `change_set` (#4551) is the digest
89
+ * of the stored change set the line cites; `request` (#4551) is the gated
90
+ * request a pending fact asks for, as JSON.
91
+ */
92
+ gates: [["member", "TEXT"], ["op", "TEXT"], ["gate", "TEXT"], ["kind", "TEXT"], ["timestamp", "TEXT"], ["resolved_by", "TEXT"], ["relayed_by", "TEXT"], ["approver_kind", "TEXT"], ["plan_digest", "TEXT"], ["environment", "TEXT"], ["release_digest", "TEXT"], ["git_sha", "TEXT"], ["run_id", "TEXT"], ["url", "TEXT"], ["note", "TEXT"], ["expires_at", "TEXT"], ["origin", "TEXT"], ["empty", "INTEGER"], ["signed", "INTEGER"], ["change_set", "TEXT"], ["request", "TEXT"]],
77
93
  /** One row per deploy record in `<env>/releases.jsonl`. `promoted_from`, `restores` and `redeploys` are JSON. */
78
94
  deploys: [["member", "TEXT"], ["env", "TEXT"], ["component", "TEXT"], ["digest", "TEXT"], ["git_sha", "TEXT"], ["run_id", "TEXT"], ["forge", "TEXT"], ["run_url", "TEXT"], ["timestamp", "TEXT"], ["actor", "TEXT"], ["approver", "TEXT"], ["release_digest", "TEXT"], ["digest_kind", "TEXT"], ["promoted_from", "TEXT"], ["restores", "TEXT"], ["redeploys", "TEXT"]],
79
95
  /** One row per release file whose content hashes to its digest. `envs` joins its targets' environments with commas; `artifacts` is JSON. */
80
96
  releases: [["member", "TEXT"], ["release_digest", "TEXT"], ["release_member", "TEXT"], ["git_sha", "TEXT"], ["envs", "TEXT"], ["artifacts", "TEXT"]],
81
97
  /** One row per line of `_releases/cuts.jsonl`. `signed` is 1 for a signed cut. */
82
98
  cuts: [["member", "TEXT"], ["release_digest", "TEXT"], ["label", "TEXT"], ["actor", "TEXT"], ["timestamp", "TEXT"], ["run_id", "TEXT"], ["forge", "TEXT"], ["channel", "TEXT"], ["signed", "INTEGER"], ["composed_base", "TEXT"]],
99
+ /**
100
+ * One row per `applied` or `changes` line of `_gates/<op>/applied.jsonl`
101
+ * (#4551): an apply under an approval, with the approval it spent, joined
102
+ * with the `finished` line that says how it ended. `finished_at`, `result`
103
+ * and `detail` are NULL while it has none. `wave` and `detail` are JSON.
104
+ */
105
+ applies: [["member", "TEXT"], ["op", "TEXT"], ["gate", "TEXT"], ["kind", "TEXT"], ["plan_digest", "TEXT"], ["approved_at", "TEXT"], ["approved_by", "TEXT"], ["timestamp", "TEXT"], ["run_id", "TEXT"], ["git_sha", "TEXT"], ["wave", "TEXT"], ["finished_at", "TEXT"], ["result", "TEXT"], ["detail", "TEXT"]],
106
+ /**
107
+ * One row per line of `_pr-envs/records.jsonl` (#4551): a pull request
108
+ * environment applied (`up`) or torn down (`down`). `env_member` is the
109
+ * workspace member the record names; `components` and `approvers` are JSON.
110
+ */
111
+ pr_envs: [["member", "TEXT"], ["kind", "TEXT"], ["pr", "INTEGER"], ["env", "TEXT"], ["env_member", "TEXT"], ["template", "TEXT"], ["git_sha", "TEXT"], ["components", "TEXT"], ["plan_digest", "TEXT"], ["result", "TEXT"], ["by", "TEXT"], ["timestamp", "TEXT"], ["expires_at", "TEXT"], ["approvers", "TEXT"], ["reason", "TEXT"], ["run_url", "TEXT"]],
112
+ /**
113
+ * One row per line of the control repo's `_control/entries.jsonl` (#4568,
114
+ * #4593): one version of a project's entry or of the shared defaults.
115
+ * `digest` is the version's own, `prev_digest` the digest of the version
116
+ * it replaced (NULL for an entry's first). `current` is 1 on the newest
117
+ * version of each id, which is the entry's state now (a `retired` one
118
+ * closes it). `settings` and `estates` are JSON. A line whose digest does
119
+ * not match it is counted malformed and left out.
120
+ */
121
+ control_entries: [["member", "TEXT"], ["id", "TEXT"], ["entry", "TEXT"], ["project", "TEXT"], ["state", "TEXT"], ["product", "TEXT"], ["settings", "TEXT"], ["estates", "TEXT"], ["by", "TEXT"], ["timestamp", "TEXT"], ["digest", "TEXT"], ["prev_digest", "TEXT"], ["current", "INTEGER"]],
122
+ /**
123
+ * One row per line of `<env>/release-status.jsonl` (#4596): a release
124
+ * deprecated, yanked, or restored to `active`. Every line is a row; the
125
+ * release's status is the row with the newest `timestamp` for its
126
+ * component and digest. `release_version` is NULL when the line names none.
127
+ */
128
+ release_status: [["member", "TEXT"], ["env", "TEXT"], ["component", "TEXT"], ["digest", "TEXT"], ["release_version", "TEXT"], ["status", "TEXT"], ["reason", "TEXT"], ["replacement", "TEXT"], ["actor", "TEXT"], ["timestamp", "TEXT"]],
83
129
  } as const satisfies Record<string, ReadonlyArray<readonly [string, ColumnType]>>;
84
130
 
85
131
  /**
@@ -87,7 +133,7 @@ export const QUERY_TABLES = {
87
133
  * and in `chant ledger runs --json` (#4482, #4500). A contract field added
88
134
  * within version 1: a reader treats a row from an older chant as lacking it.
89
135
  */
90
- export const LEDGER_ROOT_MEMBER_FLOOR = NEXT_RELEASE;
136
+ export const LEDGER_ROOT_MEMBER_FLOOR = "0.124.54";
91
137
 
92
138
  /**
93
139
  * The first chant that writes `marker_stack`, `marker_env`,
@@ -96,7 +142,23 @@ export const LEDGER_ROOT_MEMBER_FLOOR = NEXT_RELEASE;
96
142
  * within version 1: a reader treats a row from an older chant as lacking
97
143
  * them, which reads as unknown.
98
144
  */
99
- export const QUERY_OWNERSHIP_COLUMNS_FLOOR = NEXT_RELEASE;
145
+ export const QUERY_OWNERSHIP_COLUMNS_FLOOR = "0.124.54";
146
+
147
+ /**
148
+ * The first chant that writes `wave` on a `runs` row and `change_set` and
149
+ * `request` on a `gates` row (#4551). Columns added within version 1: a row
150
+ * from an older chant lacks them.
151
+ */
152
+ export const LEDGER_WAVE_COLUMNS_FLOOR = "0.124.55";
153
+
154
+ /** The first chant with the `applies` and `pr_envs` tables (#4551), added within version 1. */
155
+ export const LEDGER_APPLIES_FLOOR = "0.124.55";
156
+
157
+ /** The first chant with the `control_entries` table (#4593), added within version 1. */
158
+ export const LEDGER_CONTROL_ENTRIES_FLOOR = "0.124.55";
159
+
160
+ /** The first chant with the `release_status` table (#4596), added within version 1 (chant#4551's ruling C). */
161
+ export const LEDGER_RELEASE_STATUS_FLOOR = "0.124.55";
100
162
 
101
163
  export type QueryTable = keyof typeof QUERY_TABLES;
102
164
 
@@ -211,6 +273,8 @@ function gateRow(member: string | null, r: GateResolutionRecord | PendingGateRec
211
273
  origin: str(origin),
212
274
  empty: bit(res?.empty === true),
213
275
  signed: bit(res?.seal !== undefined),
276
+ change_set: str((r as { changeSet?: unknown }).changeSet),
277
+ request: pending ? json((r as PendingGateRecord).request) : null,
214
278
  };
215
279
  }
216
280
 
@@ -276,13 +340,21 @@ export async function loadQueryData(ledgers: readonly QueryLedger[]): Promise<Qu
276
340
  }
277
341
  continue;
278
342
  }
343
+ if (file === RELEASE_STATUS_FILE) {
344
+ const { records, malformed: bad } = parseReleaseStatus(await port.read(env, file));
345
+ malformed.release_status += bad;
346
+ for (const r of records) {
347
+ data.release_status.push({ member, env: r.env, component: r.component, digest: r.digest, release_version: str(r.releaseVersion), status: r.status, reason: str(r.reason), replacement: str(r.replacement), actor: r.actor, timestamp: r.timestamp });
348
+ }
349
+ continue;
350
+ }
279
351
  if (opOfRunLedgerFile(file) !== null) {
280
352
  const text = await port.read(env, file);
281
353
  if (text === null) continue;
282
354
  const { records, malformed: bad } = parseRunLedger(text);
283
355
  malformed.runs += bad;
284
356
  for (const r of records) {
285
- data.runs.push({ member, id: r.id, op: r.op, env: r.env, started: r.started, ended: r.ended, status: r.status, git_sha: str(r.gitSha), forge: str(r.runOrigin?.forge), run_url: str(r.runOrigin?.url), failure_code: str(r.failure?.code), failure_reason: str(r.failure?.reason), failed_phase: str(r.failure?.phase), gate: str(r.gate?.name), steward: str(r.steward), labels: json(r.labels ?? {}), outcomes: json(r.outcomes ?? {}), root_member: rootMemberOf(r.outcomes, ownerOfPath) });
357
+ data.runs.push({ member, id: r.id, op: r.op, env: r.env, started: r.started, ended: r.ended, status: r.status, git_sha: str(r.gitSha), forge: str(r.runOrigin?.forge), run_url: str(r.runOrigin?.url), failure_code: str(r.failure?.code), failure_reason: str(r.failure?.reason), failed_phase: str(r.failure?.phase), gate: str(r.gate?.name), steward: str(r.steward), labels: json(r.labels ?? {}), outcomes: json(r.outcomes ?? {}), root_member: rootMemberOf(r.outcomes, ownerOfPath), wave: json(r.wave) });
286
358
  }
287
359
  }
288
360
  }
@@ -298,6 +370,35 @@ export async function loadQueryData(ledgers: readonly QueryLedger[]): Promise<Qu
298
370
  const lines = [...pending, ...resolutions].sort((a, b) => a.timestamp.localeCompare(b.timestamp));
299
371
  for (const r of lines) data.gates.push(gateRow(member, r));
300
372
  }
373
+ // #4551: each op's applies, `_gates/<op>/applied.jsonl`, joined with their finished lines.
374
+ // A port lists a subdirectory by its name, or (a flat one) by its files' paths under it.
375
+ const ops = [...new Set((await port.list(GATES_DIR)).map((n) => n.split("/")[0]!).filter((n) => !n.includes(".")))].sort();
376
+ for (const name of ops) {
377
+ const { dir, file } = appliedGatePath(name);
378
+ const text = await port.read(dir, file);
379
+ if (text === null) continue;
380
+ const { applied, finished } = parseAppliedGateFile(text);
381
+ for (const a of applied) {
382
+ const done = finishedApply(finished, a);
383
+ data.applies.push({ member, op: a.op || name, gate: a.gate, kind: a.kind, plan_digest: a.planDigest, approved_at: a.approvedAt, approved_by: str(a.approvedBy), timestamp: a.timestamp, run_id: str(a.runId), git_sha: str(a.commit), wave: json(a.wave), finished_at: str(done?.timestamp), result: str(done?.result), detail: json(done?.detail) });
384
+ }
385
+ }
386
+ }
387
+ if (trees.includes(PR_ENV_LEDGER_DIR)) {
388
+ const text = await port.read(PR_ENV_LEDGER_DIR, PR_ENV_LEDGER_FILE);
389
+ for (const r of parsePrEnvRecords(text)) {
390
+ data.pr_envs.push({ member, kind: r.kind, pr: r.pr, env: r.env, env_member: str(r.member), template: str(r.template), git_sha: str(r.commit), components: json(r.components), plan_digest: str(r.planDigest), result: str(r.result), by: str(r.by), timestamp: str(r.timestamp), expires_at: str(r.expiresAt), approvers: json(r.approvedBy), reason: str(r.reason), run_url: str(r.runUrl) });
391
+ }
392
+ }
393
+ // #4593: the control repo's entries, every version, the newest of each id marked current.
394
+ if (trees.includes(CONTROL_LEDGER_DIR)) {
395
+ const { records, malformed: bad } = parseControlEntries(await port.read(CONTROL_LEDGER_DIR, CONTROL_LEDGER_FILE));
396
+ malformed.control_entries += bad.length;
397
+ const newest = new Map<string, number>();
398
+ records.forEach((r, i) => newest.set(r.id, i));
399
+ records.forEach((r, i) => {
400
+ data.control_entries.push({ member, id: r.id, entry: r.entry, project: r.project, state: r.state, product: r.product, settings: json(r.settings), estates: json(r.estates), by: str(r.by), timestamp: r.at, digest: r.digest, prev_digest: r.prev, current: bit(newest.get(r.id) === i) });
401
+ });
301
402
  }
302
403
  if (trees.includes(RELEASES_DIR)) {
303
404
  for (const file of (await port.list(RELEASES_DIR)).sort()) {
@@ -0,0 +1,142 @@
1
+ /**
2
+ * The release catalog site (#4595): two components, one a Terraform module
3
+ * and one an npm package filled with `npm` fields (so plywood can use the
4
+ * renderer as it is), a deprecated and a yanked version, engine sections,
5
+ * escaping, relative links and stable bytes.
6
+ */
7
+ import { describe, expect, test } from "vitest";
8
+ import type { ReleaseRecord } from "./release-ledger";
9
+ import { buildReleaseCatalog, parseReleaseCatalog } from "./release-catalog";
10
+ import { catalogPathSegments, renderCatalogSite, type CatalogSiteSections } from "./release-catalog-site";
11
+
12
+ const rec = (over: Partial<ReleaseRecord>): ReleaseRecord => ({
13
+ version: 1,
14
+ component: "vpc/aws",
15
+ env: "registry",
16
+ digest: "sha256:aaa",
17
+ gitSha: "1111111111111111111111111111111111111111",
18
+ runId: "run-1",
19
+ timestamp: "2026-10-01T00:00:00.000Z",
20
+ actor: "ci",
21
+ ...over,
22
+ });
23
+
24
+ const catalog = buildReleaseCatalog(
25
+ {
26
+ releases: [
27
+ rec({ releaseVersion: "1.0.0", digest: "sha256:v1" }),
28
+ rec({ releaseVersion: "1.1.0", digest: "sha256:v11", timestamp: "2026-10-02T00:00:00.000Z" }),
29
+ rec({ releaseVersion: "2.0.0", digest: "sha256:v2", timestamp: "2026-10-03T00:00:00.000Z" }),
30
+ rec({ component: "@acme/widgets", env: "npm", releaseVersion: "0.4.0", digest: "sha512:w4", timestamp: "2026-10-04T00:00:00.000Z" }),
31
+ ],
32
+ statuses: [
33
+ { component: "vpc/aws", digest: "sha256:v1", status: "deprecated", reason: "use <1.1.0> & newer", replacement: "1.1.0", actor: "ana", timestamp: "2026-10-05T00:00:00.000Z" },
34
+ { component: "vpc/aws", digest: "sha256:v2", status: "yanked", reason: "breaks routes", replacement: "1.1.0", actor: "ana", timestamp: "2026-10-05T00:00:00.000Z" },
35
+ ],
36
+ changelogs: [{ component: "vpc/aws", version: "1.1.0", bump: "minor", entries: [{ kind: "feat", sha: "abcdef0123456789", subject: "add flow logs", scope: "vpc" }, { kind: "fix", sha: "0123456789abcdef", subject: "tag subnets" }] }],
37
+ attestations: [{ component: "vpc/aws", digest: "sha256:v11", state: "verified", verify: "cosign verify-blob --bundle vpc.bundle vpc.tgz" }],
38
+ consumers: [{ component: "vpc/aws", version: "1.1.0", consumers: [{ repo: "acme/live", root: "prod", file: "prod/main.tf", address: "module.vpc" }] }],
39
+ fields: [
40
+ { component: "vpc/aws", engine: "terraform", fields: { source: "registry.acme.dev/acme/vpc/aws" } },
41
+ { component: "@acme/widgets", engine: "npm", fields: { package: "@acme/widgets", registry: "https://registry.npmjs.org" } },
42
+ { component: "@acme/widgets", version: "0.4.0", engine: "npm", fields: { exports: ["."], engines: { node: ">=20" } } },
43
+ ],
44
+ },
45
+ { generatedAt: "2026-10-27T00:00:00.000Z", chant: "0.0.0-test" },
46
+ );
47
+
48
+ /** An engine's sections, read only from its own `fields` key: the npm fixture stands in for plywood. */
49
+ const sections: CatalogSiteSections = {
50
+ component: (c) => {
51
+ const npm = c.fields.npm as { package?: string } | undefined;
52
+ if (npm?.package) return [{ title: "Install", body: { kind: "code", text: `npm install ${npm.package}` } }];
53
+ const tf = c.fields.terraform as { source?: string } | undefined;
54
+ if (tf?.source) return [{ title: "Usage", body: { kind: "code", text: `module "x" {\n source = "${tf.source}"\n}` } }];
55
+ return [];
56
+ },
57
+ version: (_c, v) => {
58
+ const npm = v.fields.npm as { engines?: { node?: string } } | undefined;
59
+ return npm?.engines?.node ? [{ title: "Engines", body: { kind: "table", columns: ["Engine", "Range"], rows: [["node", npm.engines.node]] } }] : [];
60
+ },
61
+ };
62
+
63
+ const files = renderCatalogSite(catalog, sections, { title: "Acme modules" });
64
+ const text = (path: string) => {
65
+ const f = files.find((x) => x.path === path);
66
+ if (!f) throw new Error(`no ${path} in ${files.map((x) => x.path).join(", ")}`);
67
+ return new TextDecoder().decode(f.bytes);
68
+ };
69
+
70
+ describe("renderCatalogSite", () => {
71
+ test("writes the index, the search files, and a page per component and per version", () => {
72
+ expect(files.map((f) => f.path)).toEqual([
73
+ "_acme/widgets/0.4.0/index.html",
74
+ "_acme/widgets/index.html",
75
+ "index.html",
76
+ "index.json",
77
+ "search.js",
78
+ "style.css",
79
+ "vpc/aws/1.0.0/index.html",
80
+ "vpc/aws/1.1.0/index.html",
81
+ "vpc/aws/2.0.0/index.html",
82
+ "vpc/aws/index.html",
83
+ ]);
84
+ expect(files.find((f) => f.path === "index.html")?.contentType).toBe("text/html; charset=utf-8");
85
+ expect(files.find((f) => f.path === "index.json")?.contentType).toBe("application/json");
86
+ });
87
+
88
+ test("index.json is the catalog, so a reader parses it back", () => {
89
+ expect(parseReleaseCatalog(text("index.json"))).toEqual(catalog);
90
+ });
91
+
92
+ test("the index lists both components with relative links", () => {
93
+ const index = text("index.html");
94
+ expect(index).toContain('<a href="vpc/aws/index.html">vpc/aws</a>');
95
+ expect(index).toContain('<a href="_acme/widgets/index.html">@acme/widgets</a>');
96
+ expect(index).toContain('<script src="search.js" defer></script>');
97
+ expect(index).toContain('href="style.css"');
98
+ });
99
+
100
+ test("a deprecated version says so, escapes the reason and links its replacement", () => {
101
+ const page = text("vpc/aws/1.0.0/index.html");
102
+ expect(page).toContain('<span class="status status-deprecated">deprecated</span>');
103
+ expect(page).toContain("use &lt;1.1.0&gt; &amp; newer");
104
+ expect(page).toContain('<a href="../1.1.0/index.html">1.1.0</a>');
105
+ expect(page).toContain('href="../../../style.css"');
106
+ });
107
+
108
+ test("a yanked version says so", () => {
109
+ const page = text("vpc/aws/2.0.0/index.html");
110
+ expect(page).toContain("status-yanked");
111
+ expect(page).toContain("This version is yanked: breaks routes");
112
+ });
113
+
114
+ test("an active version shows its changelog, attestation line and consumers", () => {
115
+ const page = text("vpc/aws/1.1.0/index.html");
116
+ expect(page).not.toContain('class="notice"');
117
+ expect(page).toContain("<h3>Features</h3>");
118
+ expect(page).toContain("<b>vpc</b> add flow logs");
119
+ expect(page).toContain("<h3>Fixes</h3>");
120
+ expect(page).toContain("cosign verify-blob --bundle vpc.bundle vpc.tgz");
121
+ expect(page).toContain("<td>acme/live</td><td>prod</td><td>prod/main.tf</td><td>module.vpc</td>");
122
+ });
123
+
124
+ test("the npm component renders from its own fields with no Terraform word", () => {
125
+ const comp = text("_acme/widgets/index.html");
126
+ expect(comp).toContain("npm install @acme/widgets");
127
+ expect(comp).not.toMatch(/terraform|module "/i);
128
+ const ver = text("_acme/widgets/0.4.0/index.html");
129
+ expect(ver).toContain("<td>node</td><td>&gt;=20</td>");
130
+ expect(text("vpc/aws/index.html")).toContain("source = &quot;registry.acme.dev/acme/vpc/aws&quot;");
131
+ });
132
+
133
+ test("the same catalog renders the same bytes", () => {
134
+ const again = renderCatalogSite(catalog, sections, { title: "Acme modules" });
135
+ expect(again.map((f) => [f.path, Buffer.from(f.bytes).toString("base64")])).toEqual(files.map((f) => [f.path, Buffer.from(f.bytes).toString("base64")]));
136
+ });
137
+
138
+ test("path segments stay inside the site", () => {
139
+ expect(catalogPathSegments("../etc")).toEqual(["_..", "etc"]);
140
+ expect(catalogPathSegments("sha256:abc")).toEqual(["sha256_abc"]);
141
+ });
142
+ });
@@ -0,0 +1,291 @@
1
+ /**
2
+ * The release catalog as a static site (#4595). {@link renderCatalogSite}
3
+ * turns one catalog (./release-catalog.ts) into files a product writes
4
+ * beside its registry: `index.html`, a page per component and per version,
5
+ * `index.json` (the catalog itself, which the search box and
6
+ * `terragucci modules` both read), `style.css` and `search.js`. Every link
7
+ * is relative, so the site works under any prefix and from a bucket.
8
+ *
9
+ * Core renders what every component has. An engine adds its own parts
10
+ * (Terraform inputs and outputs, an npm package's exports) through
11
+ * `sections`, called per component and per version, so no engine word
12
+ * lives here. Text and table cells are escaped; a section of `kind: "html"`
13
+ * is written as given, so only pass HTML the caller built.
14
+ */
15
+
16
+ import type { CatalogComponent, CatalogVersion, ReleaseCatalog } from "./release-catalog";
17
+ import { catalogVersionKey } from "./release-catalog";
18
+
19
+ /** The body of an engine section. */
20
+ export type CatalogSectionBody =
21
+ | { kind: "text"; text: string }
22
+ | { kind: "code"; text: string }
23
+ | { kind: "table"; columns: string[]; rows: string[][] }
24
+ | { kind: "html"; html: string };
25
+
26
+ /** One titled part of a component or version page. */
27
+ export interface CatalogSiteSection {
28
+ title: string;
29
+ body: CatalogSectionBody;
30
+ }
31
+
32
+ /** The engine's parts of each page. Either may be left out. */
33
+ export interface CatalogSiteSections {
34
+ component?(component: CatalogComponent): CatalogSiteSection[];
35
+ version?(component: CatalogComponent, version: CatalogVersion): CatalogSiteSection[];
36
+ }
37
+
38
+ /** One file of the site: its path under the site's root, its type and its bytes. */
39
+ export interface CatalogSiteFile {
40
+ path: string;
41
+ contentType: string;
42
+ bytes: Uint8Array;
43
+ }
44
+
45
+ /** Options for {@link renderCatalogSite}. */
46
+ export interface CatalogSiteOptions {
47
+ /** The site's title, on every page. Default `Release catalog`. */
48
+ title?: string;
49
+ }
50
+
51
+ const encoder = new TextEncoder();
52
+
53
+ /** HTML-escape `s`. */
54
+ export function escapeHtml(s: string): string {
55
+ return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
56
+ }
57
+
58
+ /** A path-safe directory segment for a name or version: `/` keeps the name's nesting, anything outside `[A-Za-z0-9._-]` becomes `_`. */
59
+ export function catalogPathSegments(name: string): string[] {
60
+ return name.split("/").map((seg) => {
61
+ const safe = seg.replace(/[^A-Za-z0-9._-]/g, "_");
62
+ return safe === "" || safe === "." || safe === ".." ? `_${safe}` : safe;
63
+ });
64
+ }
65
+
66
+ /** The directory of a component's page, from the site's root. */
67
+ export function componentPath(component: string): string {
68
+ return catalogPathSegments(component).join("/");
69
+ }
70
+
71
+ /** The directory of a version's page, from the site's root. */
72
+ export function versionPath(component: string, key: string): string {
73
+ return `${componentPath(component)}/${catalogPathSegments(key).join("/")}`;
74
+ }
75
+
76
+ function up(dir: string): string {
77
+ return dir === "" ? "" : "../".repeat(dir.split("/").length);
78
+ }
79
+
80
+ function page(opts: { title: string; site: string; dir: string; body: string }): string {
81
+ const root = up(opts.dir);
82
+ return [
83
+ "<!doctype html>",
84
+ '<html lang="en">',
85
+ "<head>",
86
+ '<meta charset="utf-8">',
87
+ '<meta name="viewport" content="width=device-width, initial-scale=1">',
88
+ `<title>${escapeHtml(opts.title)}</title>`,
89
+ `<link rel="stylesheet" href="${root}style.css">`,
90
+ "</head>",
91
+ "<body>",
92
+ `<header><a href="${root}index.html">${escapeHtml(opts.site)}</a></header>`,
93
+ "<main>",
94
+ opts.body,
95
+ "</main>",
96
+ "</body>",
97
+ "</html>",
98
+ "",
99
+ ].join("\n");
100
+ }
101
+
102
+ function status(v: CatalogVersion): string {
103
+ return `<span class="status status-${v.status.state}">${v.status.state}</span>`;
104
+ }
105
+
106
+ function table(columns: string[], rows: string[][], raw = false): string {
107
+ const cell = (c: string) => (raw ? c : escapeHtml(c));
108
+ return [
109
+ "<table>",
110
+ `<thead><tr>${columns.map((c) => `<th>${escapeHtml(c)}</th>`).join("")}</tr></thead>`,
111
+ `<tbody>${rows.map((r) => `<tr>${r.map((c) => `<td>${cell(c)}</td>`).join("")}</tr>`).join("")}</tbody>`,
112
+ "</table>",
113
+ ].join("\n");
114
+ }
115
+
116
+ function section(s: CatalogSiteSection): string {
117
+ const b = s.body;
118
+ const inner =
119
+ b.kind === "text"
120
+ ? `<p>${escapeHtml(b.text)}</p>`
121
+ : b.kind === "code"
122
+ ? `<pre><code>${escapeHtml(b.text)}</code></pre>`
123
+ : b.kind === "table"
124
+ ? table(b.columns, b.rows)
125
+ : b.html;
126
+ return `<section><h2>${escapeHtml(s.title)}</h2>\n${inner}\n</section>`;
127
+ }
128
+
129
+ function shortSha(sha: string): string {
130
+ return sha.length > 12 ? sha.slice(0, 12) : sha;
131
+ }
132
+
133
+ function indexPage(catalog: ReleaseCatalog, site: string): string {
134
+ const rows = catalog.components.map((c) => {
135
+ const link = `<a href="${componentPath(c.name)}/index.html">${escapeHtml(c.name)}</a>`;
136
+ const states = [...new Set(c.versions.map((v) => v.status.state))].sort().join(", ");
137
+ return [link, escapeHtml(c.latest ?? "none"), String(c.versions.length), escapeHtml(states)];
138
+ });
139
+ const body = [
140
+ `<h1>${escapeHtml(site)}</h1>`,
141
+ '<input id="search" type="search" placeholder="Search components and versions" aria-label="Search">',
142
+ '<ul id="results"></ul>',
143
+ table(["Component", "Latest", "Versions", "Status"], rows, true),
144
+ '<script src="search.js" defer></script>',
145
+ ].join("\n");
146
+ return page({ title: site, site, dir: "", body });
147
+ }
148
+
149
+ function componentPage(c: CatalogComponent, site: string, sections: CatalogSiteSections): string {
150
+ const dir = componentPath(c.name);
151
+ const rows = c.versions.map((v) => {
152
+ const key = catalogVersionKey(v);
153
+ const href = `${catalogPathSegments(key).join("/")}/index.html`;
154
+ return [`<a href="${href}">${escapeHtml(key)}</a>`, status(v), escapeHtml(v.time), escapeHtml(shortSha(v.commit)), escapeHtml(v.envs.join(", "))];
155
+ });
156
+ const body = [
157
+ `<h1>${escapeHtml(c.name)}</h1>`,
158
+ `<p>Latest: ${escapeHtml(c.latest ?? "none")}</p>`,
159
+ ...(sections.component?.(c) ?? []).map(section),
160
+ "<section><h2>Versions</h2>",
161
+ table(["Version", "Status", "Released", "Commit", "Environments"], rows, true),
162
+ "</section>",
163
+ ].join("\n");
164
+ return page({ title: `${c.name} - ${site}`, site, dir, body });
165
+ }
166
+
167
+ const CHANGE_GROUPS: { kind: CatalogVersion["changelog"]["entries"][number]["kind"]; title: string }[] = [
168
+ { kind: "breaking", title: "Breaking changes" },
169
+ { kind: "feat", title: "Features" },
170
+ { kind: "fix", title: "Fixes" },
171
+ { kind: "other", title: "Other changes" },
172
+ ];
173
+
174
+ function versionPage(c: CatalogComponent, v: CatalogVersion, site: string, sections: CatalogSiteSections): string {
175
+ const key = catalogVersionKey(v);
176
+ const dir = versionPath(c.name, key);
177
+ const parts: string[] = [`<h1>${escapeHtml(c.name)} ${escapeHtml(key)}</h1>`, `<p>${status(v)}</p>`];
178
+ if (v.status.state !== "active") {
179
+ const said = [`This version is ${v.status.state}`];
180
+ if (v.status.reason) said.push(`: ${escapeHtml(v.status.reason)}`);
181
+ if (v.status.replacement) {
182
+ const target = c.versions.find((x) => x.version === v.status.replacement || x.digest === v.status.replacement);
183
+ const name = escapeHtml(v.status.replacement);
184
+ said.push(`. Use ${target ? `<a href="../${catalogPathSegments(catalogVersionKey(target)).join("/")}/index.html">${name}</a>` : name} instead`);
185
+ }
186
+ parts.push(`<p class="notice">${said.join("")}.</p>`);
187
+ }
188
+ parts.push(
189
+ table(
190
+ ["Digest", "Commit", "Released", "By", "Environments"],
191
+ [[v.digest, v.commit, v.time, v.actor, v.envs.join(", ")]],
192
+ ),
193
+ );
194
+ const att = [`<p>Attestation: ${escapeHtml(v.attestation.state)}${v.attestation.identity ? `, signed by ${escapeHtml(v.attestation.identity)}` : ""}</p>`];
195
+ if (v.attestation.verify) att.push(`<pre><code>${escapeHtml(v.attestation.verify)}</code></pre>`);
196
+ parts.push(`<section><h2>Attestation</h2>\n${att.join("\n")}\n</section>`);
197
+ if (v.changelog.entries.length > 0) {
198
+ const groups = CHANGE_GROUPS.map((g) => {
199
+ const entries = v.changelog.entries.filter((e) => e.kind === g.kind);
200
+ if (entries.length === 0) return "";
201
+ const items = entries.map((e) => `<li><code>${escapeHtml(shortSha(e.sha))}</code> ${e.scope ? `<b>${escapeHtml(e.scope)}</b> ` : ""}${escapeHtml(e.subject)}</li>`);
202
+ return `<h3>${g.title}</h3>\n<ul>${items.join("")}</ul>`;
203
+ }).filter(Boolean);
204
+ const bump = v.changelog.bump ? `<p>Bump: ${v.changelog.bump}</p>\n` : "";
205
+ parts.push(`<section><h2>Changelog</h2>\n${bump}${groups.join("\n")}\n</section>`);
206
+ }
207
+ if (v.consumers.length > 0) {
208
+ parts.push(
209
+ `<section><h2>Used by</h2>\n${table(
210
+ ["Repository", "Root", "File", "Address"],
211
+ v.consumers.map((u) => [u.repo ?? "", u.root, u.file ?? "", u.address ?? ""]),
212
+ )}\n</section>`,
213
+ );
214
+ }
215
+ parts.push(...(sections.version?.(c, v) ?? []).map(section));
216
+ return page({ title: `${c.name} ${key} - ${site}`, site, dir, body: parts.join("\n") });
217
+ }
218
+
219
+ const STYLE = `body{font-family:system-ui,-apple-system,sans-serif;margin:0;color:#1b1b1b;background:#fff;line-height:1.5}
220
+ header{padding:12px 16px;border-bottom:1px solid #ddd}
221
+ header a{font-weight:600;text-decoration:none;color:inherit}
222
+ main{max-width:960px;margin:0 auto;padding:16px}
223
+ table{border-collapse:collapse;width:100%;margin:12px 0;display:block;overflow-x:auto}
224
+ th,td{border-bottom:1px solid #e5e5e5;padding:6px 8px;text-align:left;vertical-align:top;word-break:break-word}
225
+ pre{background:#f5f5f5;padding:8px;overflow-x:auto}
226
+ input[type=search]{width:100%;max-width:480px;padding:6px 8px;font-size:1rem}
227
+ .status{padding:1px 6px;border-radius:4px;font-size:.85em}
228
+ .status-active{background:#e3f4e6}
229
+ .status-deprecated{background:#fff3cd}
230
+ .status-yanked{background:#f8d7da}
231
+ .notice{border-left:4px solid #c08a00;padding-left:8px}
232
+ @media (prefers-color-scheme:dark){body{color:#e6e6e6;background:#141414}header{border-color:#333}th,td{border-color:#2a2a2a}pre{background:#1f1f1f}.status-active{background:#1e3a24}.status-deprecated{background:#4a3b00}.status-yanked{background:#4a1c20}}
233
+ `;
234
+
235
+ const SEARCH = `(function () {
236
+ var input = document.getElementById("search");
237
+ var out = document.getElementById("results");
238
+ if (!input || !out) return;
239
+ var seg = function (s) { return s.split("/").map(function (p) { var x = p.replace(/[^A-Za-z0-9._-]/g, "_"); return x === "" || x === "." || x === ".." ? "_" + x : x; }).join("/"); };
240
+ var entries = [];
241
+ fetch("index.json").then(function (r) { return r.json(); }).then(function (doc) {
242
+ (doc.components || []).forEach(function (c) {
243
+ entries.push({ text: c.name, href: seg(c.name) + "/index.html", label: c.name });
244
+ (c.versions || []).forEach(function (v) {
245
+ var key = v.version || v.digest;
246
+ entries.push({ text: c.name + " " + key + " " + v.status.state, href: seg(c.name) + "/" + seg(key) + "/index.html", label: c.name + " " + key + " (" + v.status.state + ")" });
247
+ });
248
+ });
249
+ });
250
+ input.addEventListener("input", function () {
251
+ var q = input.value.trim().toLowerCase();
252
+ out.textContent = "";
253
+ if (!q) return;
254
+ entries.filter(function (e) { return e.text.toLowerCase().indexOf(q) !== -1; }).slice(0, 50).forEach(function (e) {
255
+ var li = document.createElement("li");
256
+ var a = document.createElement("a");
257
+ a.href = e.href;
258
+ a.textContent = e.label;
259
+ li.appendChild(a);
260
+ out.appendChild(li);
261
+ });
262
+ });
263
+ })();
264
+ `;
265
+
266
+ /**
267
+ * Render `catalog` as a static site. Files come back sorted by path; their
268
+ * bytes depend only on the catalog and the sections, so a rerun over the
269
+ * same catalog writes the same bytes and a caller can skip unchanged files.
270
+ */
271
+ export function renderCatalogSite(catalog: ReleaseCatalog, sections: CatalogSiteSections = {}, opts: CatalogSiteOptions = {}): CatalogSiteFile[] {
272
+ const site = opts.title ?? "Release catalog";
273
+ const files = new Map<string, { contentType: string; text: string }>();
274
+ const put = (path: string, contentType: string, text: string) => {
275
+ if (files.has(path)) throw new Error(`release catalog site: two pages at ${path}`);
276
+ files.set(path, { contentType, text });
277
+ };
278
+ put("index.html", "text/html; charset=utf-8", indexPage(catalog, site));
279
+ put("index.json", "application/json", `${JSON.stringify(catalog, null, 2)}\n`);
280
+ put("style.css", "text/css; charset=utf-8", STYLE);
281
+ put("search.js", "text/javascript; charset=utf-8", SEARCH);
282
+ for (const c of catalog.components) {
283
+ put(`${componentPath(c.name)}/index.html`, "text/html; charset=utf-8", componentPage(c, site, sections));
284
+ for (const v of c.versions) {
285
+ put(`${versionPath(c.name, catalogVersionKey(v))}/index.html`, "text/html; charset=utf-8", versionPage(c, v, site, sections));
286
+ }
287
+ }
288
+ return [...files.entries()]
289
+ .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
290
+ .map(([path, f]) => ({ path, contentType: f.contentType, bytes: encoder.encode(f.text) }));
291
+ }