@intentius/chant 0.124.54 → 0.124.55

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (894) hide show
  1. package/dist/__fixtures__/estate-ledger.d.ts +13 -0
  2. package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
  3. package/dist/__fixtures__/estate-ledger.js +67 -0
  4. package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
  5. package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
  6. package/dist/__fixtures__/oidc-emulator.js +26 -2
  7. package/dist/__fixtures__/product-words.d.ts +78 -0
  8. package/dist/__fixtures__/product-words.d.ts.map +1 -0
  9. package/dist/__fixtures__/product-words.js +43 -0
  10. package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  11. package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  12. package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  13. package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  14. package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  15. package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  16. package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
  17. package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
  18. package/dist/__golden__/wave-loop/op-held-on.json +28 -7
  19. package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  20. package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  21. package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  22. package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
  23. package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  24. package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
  25. package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
  26. package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
  27. package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  28. package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  29. package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
  30. package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  31. package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  32. package/dist/__golden__/wave-loop/op-overridden.json +28 -7
  33. package/dist/__golden__/wave-loop/op-per-run.json +20 -4
  34. package/dist/__golden__/wave-loop/op-point.json +18 -4
  35. package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
  36. package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
  37. package/dist/__golden__/wave-loop/op-spend.json +10 -2
  38. package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
  39. package/dist/__golden__/wave-loop/op-wide.json +20 -4
  40. package/dist/bucket-check/azure.d.ts +108 -0
  41. package/dist/bucket-check/azure.d.ts.map +1 -0
  42. package/dist/bucket-check/azure.js +258 -0
  43. package/dist/bucket-check/fixtures/azure.json +153 -0
  44. package/dist/bucket-check/fixtures/gcs.json +148 -0
  45. package/dist/bucket-check/fixtures/s3.json +277 -0
  46. package/dist/bucket-check/gcs.d.ts +77 -0
  47. package/dist/bucket-check/gcs.d.ts.map +1 -0
  48. package/dist/bucket-check/gcs.js +202 -0
  49. package/dist/bucket-check/index.d.ts +48 -0
  50. package/dist/bucket-check/index.d.ts.map +1 -0
  51. package/dist/bucket-check/index.js +44 -0
  52. package/dist/bucket-check/s3.d.ts +116 -0
  53. package/dist/bucket-check/s3.d.ts.map +1 -0
  54. package/dist/bucket-check/s3.js +362 -0
  55. package/dist/bucket-check/types.d.ts +66 -0
  56. package/dist/bucket-check/types.d.ts.map +1 -0
  57. package/dist/bucket-check/types.js +31 -0
  58. package/dist/bucket-check/wire.d.ts +27 -0
  59. package/dist/bucket-check/wire.d.ts.map +1 -0
  60. package/dist/bucket-check/wire.js +32 -0
  61. package/dist/bucket-check.d.ts +6 -0
  62. package/dist/bucket-check.d.ts.map +1 -0
  63. package/dist/bucket-check.js +5 -0
  64. package/dist/capabilities/templates.d.ts.map +1 -1
  65. package/dist/capabilities/templates.js +1 -2
  66. package/dist/change-set.d.ts.map +1 -1
  67. package/dist/change-set.js +2 -3
  68. package/dist/ci-agent.d.ts +381 -0
  69. package/dist/ci-agent.d.ts.map +1 -0
  70. package/dist/ci-agent.js +833 -0
  71. package/dist/ci-control.d.ts +42 -0
  72. package/dist/ci-control.d.ts.map +1 -0
  73. package/dist/ci-control.js +42 -0
  74. package/dist/ci-estate/delivery.d.ts +137 -0
  75. package/dist/ci-estate/delivery.d.ts.map +1 -0
  76. package/dist/ci-estate/delivery.js +311 -0
  77. package/dist/ci-estate/overdue.d.ts +34 -0
  78. package/dist/ci-estate/overdue.d.ts.map +1 -0
  79. package/dist/ci-estate/overdue.js +58 -0
  80. package/dist/ci-estate/page.d.ts +134 -0
  81. package/dist/ci-estate/page.d.ts.map +1 -0
  82. package/dist/ci-estate/page.js +233 -0
  83. package/dist/ci-estate/rows.d.ts +118 -0
  84. package/dist/ci-estate/rows.d.ts.map +1 -0
  85. package/dist/ci-estate/rows.js +126 -0
  86. package/dist/ci-estate.d.ts +68 -0
  87. package/dist/ci-estate.d.ts.map +1 -0
  88. package/dist/ci-estate.js +83 -0
  89. package/dist/ci-handover.d.ts +29 -5
  90. package/dist/ci-handover.d.ts.map +1 -1
  91. package/dist/ci-handover.js +50 -16
  92. package/dist/ci-identity.d.ts +82 -7
  93. package/dist/ci-identity.d.ts.map +1 -1
  94. package/dist/ci-identity.js +87 -15
  95. package/dist/ci-product-words.d.ts +290 -0
  96. package/dist/ci-product-words.d.ts.map +1 -0
  97. package/dist/ci-product-words.js +373 -0
  98. package/dist/ci-product.d.ts +82 -0
  99. package/dist/ci-product.d.ts.map +1 -0
  100. package/dist/ci-product.js +78 -0
  101. package/dist/cli/commands/audit.d.ts +2 -2
  102. package/dist/cli/commands/audit.d.ts.map +1 -1
  103. package/dist/cli/commands/audit.js +3 -2
  104. package/dist/cli/commands/carve.js +2 -2
  105. package/dist/cli/commands/init.d.ts +2 -0
  106. package/dist/cli/commands/init.d.ts.map +1 -1
  107. package/dist/cli/commands/init.js +1 -1
  108. package/dist/cli/handlers/agent.d.ts +17 -0
  109. package/dist/cli/handlers/agent.d.ts.map +1 -0
  110. package/dist/cli/handlers/agent.js +114 -0
  111. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  112. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  113. package/dist/cli/handlers/approve-confirm.js +142 -0
  114. package/dist/cli/handlers/approve.d.ts.map +1 -1
  115. package/dist/cli/handlers/approve.js +19 -1
  116. package/dist/cli/handlers/build.d.ts.map +1 -1
  117. package/dist/cli/handlers/build.js +43 -1
  118. package/dist/cli/handlers/ci-check.d.ts +3 -0
  119. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  120. package/dist/cli/handlers/ci-check.js +34 -0
  121. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  122. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  123. package/dist/cli/handlers/ci-forge-check.js +89 -0
  124. package/dist/cli/handlers/fan-out.js +4 -0
  125. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  126. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  127. package/dist/cli/handlers/gate-pending.js +44 -0
  128. package/dist/cli/handlers/init.d.ts.map +1 -1
  129. package/dist/cli/handlers/init.js +1 -0
  130. package/dist/cli/handlers/ledger.js +1 -1
  131. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  132. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  133. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  134. package/dist/cli/handlers/lock.d.ts.map +1 -1
  135. package/dist/cli/handlers/lock.js +64 -5
  136. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  137. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  138. package/dist/cli/handlers/notify-relay.js +130 -0
  139. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  140. package/dist/cli/handlers/pr-env.js +42 -11
  141. package/dist/cli/handlers/pr.d.ts +38 -3
  142. package/dist/cli/handlers/pr.d.ts.map +1 -1
  143. package/dist/cli/handlers/pr.js +653 -205
  144. package/dist/cli/handlers/promote.d.ts.map +1 -1
  145. package/dist/cli/handlers/promote.js +21 -2
  146. package/dist/cli/handlers/release.d.ts.map +1 -1
  147. package/dist/cli/handlers/release.js +3 -0
  148. package/dist/cli/handlers/run-wave.d.ts +8 -0
  149. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  150. package/dist/cli/handlers/run-wave.js +71 -1
  151. package/dist/cli/handlers/run.d.ts +6 -1
  152. package/dist/cli/handlers/run.d.ts.map +1 -1
  153. package/dist/cli/handlers/run.js +86 -1
  154. package/dist/cli/handlers/serve.d.ts.map +1 -1
  155. package/dist/cli/handlers/serve.js +10 -1
  156. package/dist/cli/main.d.ts +11 -1
  157. package/dist/cli/main.d.ts.map +1 -1
  158. package/dist/cli/main.js +124 -13
  159. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  160. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  161. package/dist/cli/mcp/ledger-tools.js +122 -0
  162. package/dist/cli/mcp/product-tools.d.ts +78 -0
  163. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  164. package/dist/cli/mcp/product-tools.js +93 -0
  165. package/dist/cli/mcp/read-only.d.ts +34 -0
  166. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  167. package/dist/cli/mcp/read-only.js +61 -0
  168. package/dist/cli/mcp/report-tools.d.ts +48 -0
  169. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  170. package/dist/cli/mcp/report-tools.js +128 -0
  171. package/dist/cli/mcp/server.d.ts +28 -1
  172. package/dist/cli/mcp/server.d.ts.map +1 -1
  173. package/dist/cli/mcp/server.js +86 -15
  174. package/dist/cli/mcp-config.d.ts +9 -2
  175. package/dist/cli/mcp-config.d.ts.map +1 -1
  176. package/dist/cli/mcp-config.js +8 -3
  177. package/dist/cli/parse-args.d.ts.map +1 -1
  178. package/dist/cli/parse-args.js +57 -3
  179. package/dist/cli/registry.d.ts +35 -0
  180. package/dist/cli/registry.d.ts.map +1 -1
  181. package/dist/cloud-lister/sigv4.d.ts +42 -7
  182. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  183. package/dist/cloud-lister/sigv4.js +72 -22
  184. package/dist/components/adoption.d.ts +69 -0
  185. package/dist/components/adoption.d.ts.map +1 -0
  186. package/dist/components/adoption.js +93 -0
  187. package/dist/components/apply-lease.d.ts +19 -0
  188. package/dist/components/apply-lease.d.ts.map +1 -0
  189. package/dist/components/apply-lease.js +41 -0
  190. package/dist/components/capability.d.ts +122 -5
  191. package/dist/components/capability.d.ts.map +1 -1
  192. package/dist/components/capability.js +14 -6
  193. package/dist/components/check-hooks.d.ts +113 -0
  194. package/dist/components/check-hooks.d.ts.map +1 -0
  195. package/dist/components/check-hooks.js +192 -0
  196. package/dist/components/ci-services.d.ts +57 -0
  197. package/dist/components/ci-services.d.ts.map +1 -0
  198. package/dist/components/ci-services.js +61 -0
  199. package/dist/components/cli-support.d.ts +13 -0
  200. package/dist/components/cli-support.d.ts.map +1 -1
  201. package/dist/components/cli-support.js +10 -2
  202. package/dist/components/driver.d.ts +20 -3
  203. package/dist/components/driver.d.ts.map +1 -1
  204. package/dist/components/driver.js +24 -4
  205. package/dist/components/fan-out-run.d.ts +12 -0
  206. package/dist/components/fan-out-run.d.ts.map +1 -1
  207. package/dist/components/fan-out-run.js +56 -16
  208. package/dist/components/groups.d.ts.map +1 -1
  209. package/dist/components/groups.js +19 -2
  210. package/dist/components/pr-env-ledger.d.ts +32 -0
  211. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  212. package/dist/components/pr-env-ledger.js +39 -0
  213. package/dist/components/pr-env-ports.d.ts +12 -0
  214. package/dist/components/pr-env-ports.d.ts.map +1 -1
  215. package/dist/components/pr-env-ports.js +13 -3
  216. package/dist/components/pr-env-run.d.ts +6 -0
  217. package/dist/components/pr-env-run.d.ts.map +1 -1
  218. package/dist/components/pr-env-run.js +3 -2
  219. package/dist/components/pr-environment.d.ts +31 -3
  220. package/dist/components/pr-environment.d.ts.map +1 -1
  221. package/dist/components/pr-environment.js +25 -7
  222. package/dist/components/pr-pipeline.d.ts +169 -3
  223. package/dist/components/pr-pipeline.d.ts.map +1 -1
  224. package/dist/components/pr-pipeline.js +184 -9
  225. package/dist/components/pr-policy.d.ts +26 -2
  226. package/dist/components/pr-policy.d.ts.map +1 -1
  227. package/dist/components/pr-policy.js +41 -7
  228. package/dist/components/pr-run.d.ts +63 -0
  229. package/dist/components/pr-run.d.ts.map +1 -1
  230. package/dist/components/pr-run.js +82 -3
  231. package/dist/components/pr-targets.d.ts +24 -0
  232. package/dist/components/pr-targets.d.ts.map +1 -0
  233. package/dist/components/pr-targets.js +48 -0
  234. package/dist/components/product-pipeline.d.ts +217 -0
  235. package/dist/components/product-pipeline.d.ts.map +1 -0
  236. package/dist/components/product-pipeline.js +193 -0
  237. package/dist/components/promote.d.ts +6 -0
  238. package/dist/components/promote.d.ts.map +1 -1
  239. package/dist/components/promote.js +4 -1
  240. package/dist/components/release-compile.d.ts +22 -1
  241. package/dist/components/release-compile.d.ts.map +1 -1
  242. package/dist/components/release-compile.js +85 -0
  243. package/dist/components/release-promote.d.ts +15 -1
  244. package/dist/components/release-promote.d.ts.map +1 -1
  245. package/dist/components/release-promote.js +67 -2
  246. package/dist/components/repo-lock.d.ts +27 -0
  247. package/dist/components/repo-lock.d.ts.map +1 -0
  248. package/dist/components/repo-lock.js +49 -0
  249. package/dist/components/row-lease.d.ts +84 -0
  250. package/dist/components/row-lease.d.ts.map +1 -0
  251. package/dist/components/row-lease.js +110 -0
  252. package/dist/components/wave-plan.d.ts +34 -0
  253. package/dist/components/wave-plan.d.ts.map +1 -1
  254. package/dist/components/wave-plan.js +54 -2
  255. package/dist/control/applied.d.ts +89 -0
  256. package/dist/control/applied.d.ts.map +1 -0
  257. package/dist/control/applied.js +175 -0
  258. package/dist/control/consumers.d.ts +78 -0
  259. package/dist/control/consumers.d.ts.map +1 -0
  260. package/dist/control/consumers.js +172 -0
  261. package/dist/control/dispatch.d.ts +334 -0
  262. package/dist/control/dispatch.d.ts.map +1 -0
  263. package/dist/control/dispatch.js +519 -0
  264. package/dist/control/edges.d.ts +75 -0
  265. package/dist/control/edges.d.ts.map +1 -0
  266. package/dist/control/edges.js +133 -0
  267. package/dist/control/reconcile.d.ts +120 -0
  268. package/dist/control/reconcile.d.ts.map +1 -0
  269. package/dist/control/reconcile.js +178 -0
  270. package/dist/control/records.d.ts +187 -0
  271. package/dist/control/records.d.ts.map +1 -0
  272. package/dist/control/records.js +307 -0
  273. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  274. package/dist/discovery/sandbox/bundle.js +25 -1
  275. package/dist/engine-facts.d.ts.map +1 -1
  276. package/dist/engine-facts.js +1 -2
  277. package/dist/exit-codes.d.ts +48 -0
  278. package/dist/exit-codes.d.ts.map +1 -0
  279. package/dist/exit-codes.js +49 -0
  280. package/dist/forge-check/check.d.ts +63 -0
  281. package/dist/forge-check/check.d.ts.map +1 -0
  282. package/dist/forge-check/check.js +139 -0
  283. package/dist/forge-check/contract.d.ts +152 -0
  284. package/dist/forge-check/contract.d.ts.map +1 -0
  285. package/dist/forge-check/contract.js +118 -0
  286. package/dist/forge-check/forge.d.ts +42 -0
  287. package/dist/forge-check/forge.d.ts.map +1 -0
  288. package/dist/forge-check/forge.js +338 -0
  289. package/dist/forge-check/index.d.ts +24 -0
  290. package/dist/forge-check/index.d.ts.map +1 -0
  291. package/dist/forge-check/index.js +23 -0
  292. package/dist/forge-check/pulumi.d.ts +44 -0
  293. package/dist/forge-check/pulumi.d.ts.map +1 -0
  294. package/dist/forge-check/pulumi.js +184 -0
  295. package/dist/forge-check/read-only.d.ts +26 -0
  296. package/dist/forge-check/read-only.d.ts.map +1 -0
  297. package/dist/forge-check/read-only.js +53 -0
  298. package/dist/forge-check/trust.d.ts +94 -0
  299. package/dist/forge-check/trust.d.ts.map +1 -0
  300. package/dist/forge-check/trust.js +532 -0
  301. package/dist/forge-check/types.d.ts +80 -0
  302. package/dist/forge-check/types.d.ts.map +1 -0
  303. package/dist/forge-check/types.js +18 -0
  304. package/dist/forge-check.d.ts +6 -0
  305. package/dist/forge-check.d.ts.map +1 -0
  306. package/dist/forge-check.js +5 -0
  307. package/dist/gate-decision.d.ts +1 -0
  308. package/dist/gate-decision.d.ts.map +1 -1
  309. package/dist/gate-decision.js +2 -0
  310. package/dist/gate-policy.d.ts +47 -1
  311. package/dist/gate-policy.d.ts.map +1 -1
  312. package/dist/gate-policy.js +50 -2
  313. package/dist/index.d.ts +1 -0
  314. package/dist/index.d.ts.map +1 -1
  315. package/dist/index.js +2 -0
  316. package/dist/lexicon.d.ts +106 -6
  317. package/dist/lexicon.d.ts.map +1 -1
  318. package/dist/lifecycle/adoption-file.d.ts +24 -0
  319. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  320. package/dist/lifecycle/adoption-file.js +1 -2
  321. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  322. package/dist/lifecycle/cloud-index.js +1 -2
  323. package/dist/lifecycle/gate-applied.d.ts +6 -0
  324. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  325. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  326. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  327. package/dist/lifecycle/gate-ledger.js +11 -1
  328. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  329. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  330. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  331. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  332. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  333. package/dist/lifecycle/gated-request-digest.js +35 -0
  334. package/dist/lifecycle/gated-request.d.ts +126 -0
  335. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  336. package/dist/lifecycle/gated-request.js +205 -0
  337. package/dist/lifecycle/identity-match.d.ts +15 -0
  338. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  339. package/dist/lifecycle/identity-match.js +11 -6
  340. package/dist/lifecycle/index-diff.d.ts +40 -0
  341. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  342. package/dist/lifecycle/index-diff.js +1 -2
  343. package/dist/lifecycle/index-document.d.ts.map +1 -1
  344. package/dist/lifecycle/index-document.js +1 -2
  345. package/dist/lifecycle/index-import.d.ts +4 -1
  346. package/dist/lifecycle/index-import.d.ts.map +1 -1
  347. package/dist/lifecycle/index-import.js +29 -32
  348. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  349. package/dist/lifecycle/ledger-read.js +7 -3
  350. package/dist/lifecycle/lock-rows.d.ts +76 -0
  351. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  352. package/dist/lifecycle/lock-rows.js +140 -0
  353. package/dist/lifecycle/query.d.ts +50 -3
  354. package/dist/lifecycle/query.d.ts.map +1 -1
  355. package/dist/lifecycle/query.js +97 -6
  356. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  357. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  358. package/dist/lifecycle/release-catalog-site.js +232 -0
  359. package/dist/lifecycle/release-catalog.d.ts +201 -0
  360. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  361. package/dist/lifecycle/release-catalog.js +198 -0
  362. package/dist/lifecycle/release-changelog.d.ts +41 -0
  363. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  364. package/dist/lifecycle/release-changelog.js +38 -0
  365. package/dist/lifecycle/release-cut.d.ts +1 -0
  366. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  367. package/dist/lifecycle/release-cut.js +1 -1
  368. package/dist/lifecycle/release-ledger.d.ts +16 -0
  369. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  370. package/dist/lifecycle/release-ledger.js +10 -0
  371. package/dist/lifecycle/release-publish.d.ts +43 -22
  372. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  373. package/dist/lifecycle/release-read.d.ts.map +1 -1
  374. package/dist/lifecycle/release-read.js +3 -0
  375. package/dist/lifecycle/release-status.d.ts +86 -0
  376. package/dist/lifecycle/release-status.d.ts.map +1 -0
  377. package/dist/lifecycle/release-status.js +136 -0
  378. package/dist/lifecycle/resource-lock.d.ts +120 -0
  379. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  380. package/dist/lifecycle/resource-lock.js +317 -0
  381. package/dist/lifecycle/retention.d.ts.map +1 -1
  382. package/dist/lifecycle/retention.js +3 -0
  383. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  384. package/dist/lifecycle/run-ledger.js +9 -1
  385. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  386. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  387. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  388. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  389. package/dist/lifecycle/snapshot-store.js +1 -2
  390. package/dist/lifecycle/target-lock.d.ts +15 -0
  391. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  392. package/dist/lifecycle/target-lock.js +25 -10
  393. package/dist/mcp/types.d.ts +7 -0
  394. package/dist/mcp/types.d.ts.map +1 -1
  395. package/dist/notify-product.d.ts +43 -0
  396. package/dist/notify-product.d.ts.map +1 -0
  397. package/dist/notify-product.js +58 -0
  398. package/dist/notify-relay.d.ts +197 -0
  399. package/dist/notify-relay.d.ts.map +1 -0
  400. package/dist/notify-relay.js +321 -0
  401. package/dist/notify.d.ts +44 -4
  402. package/dist/notify.d.ts.map +1 -1
  403. package/dist/notify.js +77 -14
  404. package/dist/object-store/azure-blob.d.ts +129 -0
  405. package/dist/object-store/azure-blob.d.ts.map +1 -0
  406. package/dist/object-store/azure-blob.js +341 -0
  407. package/dist/object-store/common.d.ts +108 -0
  408. package/dist/object-store/common.d.ts.map +1 -0
  409. package/dist/object-store/common.js +80 -0
  410. package/dist/object-store/errors.d.ts +28 -0
  411. package/dist/object-store/errors.d.ts.map +1 -0
  412. package/dist/object-store/errors.js +21 -0
  413. package/dist/object-store/from-env.d.ts +18 -0
  414. package/dist/object-store/from-env.d.ts.map +1 -0
  415. package/dist/object-store/from-env.js +22 -0
  416. package/dist/object-store/gcs.d.ts +106 -0
  417. package/dist/object-store/gcs.d.ts.map +1 -0
  418. package/dist/object-store/gcs.js +393 -0
  419. package/dist/object-store/index.d.ts +9 -0
  420. package/dist/object-store/index.d.ts.map +1 -0
  421. package/dist/object-store/index.js +8 -0
  422. package/dist/object-store/s3.d.ts +146 -0
  423. package/dist/object-store/s3.d.ts.map +1 -0
  424. package/dist/object-store/s3.js +306 -0
  425. package/dist/op/activities/converge.d.ts.map +1 -1
  426. package/dist/op/activities/converge.js +2 -1
  427. package/dist/op/activities/index.d.ts +1 -1
  428. package/dist/op/activities/index.d.ts.map +1 -1
  429. package/dist/op/activities/index.js +1 -1
  430. package/dist/op/activities/review-agent.d.ts +55 -2
  431. package/dist/op/activities/review-agent.d.ts.map +1 -1
  432. package/dist/op/activities/review-agent.js +65 -5
  433. package/dist/op/gate.d.ts +29 -1
  434. package/dist/op/gate.d.ts.map +1 -1
  435. package/dist/op/gate.js +59 -23
  436. package/dist/op/generate-pipeline.d.ts.map +1 -1
  437. package/dist/op/generate-pipeline.js +7 -1
  438. package/dist/op/index.d.ts +12 -1
  439. package/dist/op/index.d.ts.map +1 -1
  440. package/dist/op/index.js +7 -1
  441. package/dist/op/op-waves-after-plan.d.ts +137 -0
  442. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  443. package/dist/op/op-waves-after-plan.js +163 -0
  444. package/dist/op/op-waves-capability-spec.d.ts +55 -0
  445. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  446. package/dist/op/op-waves-capability-spec.js +94 -0
  447. package/dist/op/op-waves-capability.d.ts +197 -0
  448. package/dist/op/op-waves-capability.d.ts.map +1 -0
  449. package/dist/op/op-waves-capability.js +311 -0
  450. package/dist/op/op-waves-events.d.ts +54 -0
  451. package/dist/op/op-waves-events.d.ts.map +1 -0
  452. package/dist/op/op-waves-events.js +122 -0
  453. package/dist/op/op-waves-notify.d.ts +7 -1
  454. package/dist/op/op-waves-notify.d.ts.map +1 -1
  455. package/dist/op/op-waves-notify.js +35 -16
  456. package/dist/op/op-waves-release-port.d.ts +18 -0
  457. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  458. package/dist/op/op-waves-release-port.js +61 -0
  459. package/dist/op/op-waves-release.d.ts +92 -0
  460. package/dist/op/op-waves-release.d.ts.map +1 -0
  461. package/dist/op/op-waves-release.js +97 -0
  462. package/dist/op/op-waves-run.d.ts +175 -4
  463. package/dist/op/op-waves-run.d.ts.map +1 -1
  464. package/dist/op/op-waves-run.js +981 -41
  465. package/dist/op/op-waves-stand-down.d.ts +60 -0
  466. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  467. package/dist/op/op-waves-stand-down.js +97 -0
  468. package/dist/op/op-waves.d.ts +152 -8
  469. package/dist/op/op-waves.d.ts.map +1 -1
  470. package/dist/op/op-waves.js +161 -17
  471. package/dist/op/runtime.d.ts +91 -0
  472. package/dist/op/runtime.d.ts.map +1 -1
  473. package/dist/op/runtime.js +19 -0
  474. package/dist/op/stage-hooks.d.ts +45 -7
  475. package/dist/op/stage-hooks.d.ts.map +1 -1
  476. package/dist/op/stage-hooks.js +61 -3
  477. package/dist/op/steward-beside.d.ts.map +1 -1
  478. package/dist/op/steward-beside.js +2 -1
  479. package/dist/op/types.d.ts +2 -2
  480. package/dist/op/types.d.ts.map +1 -1
  481. package/dist/op/types.js +3 -2
  482. package/dist/otlp-metrics.d.ts +38 -0
  483. package/dist/otlp-metrics.d.ts.map +1 -0
  484. package/dist/otlp-metrics.js +82 -0
  485. package/dist/otlp.d.ts +249 -0
  486. package/dist/otlp.d.ts.map +1 -0
  487. package/dist/otlp.js +426 -0
  488. package/dist/override-gate.d.ts.map +1 -1
  489. package/dist/override-gate.js +5 -0
  490. package/dist/policy-packs.d.ts +69 -0
  491. package/dist/policy-packs.d.ts.map +1 -0
  492. package/dist/policy-packs.js +205 -0
  493. package/dist/policy-source.d.ts +51 -0
  494. package/dist/policy-source.d.ts.map +1 -0
  495. package/dist/policy-source.js +103 -0
  496. package/dist/pr-forge.d.ts +40 -0
  497. package/dist/pr-forge.d.ts.map +1 -1
  498. package/dist/pr-forge.js +92 -0
  499. package/dist/pr-loop.d.ts +149 -11
  500. package/dist/pr-loop.d.ts.map +1 -1
  501. package/dist/pr-loop.js +283 -44
  502. package/dist/pr-post.d.ts +16 -0
  503. package/dist/pr-post.d.ts.map +1 -1
  504. package/dist/pr-post.js +26 -1
  505. package/dist/pr-report-url.d.ts +32 -4
  506. package/dist/pr-report-url.d.ts.map +1 -1
  507. package/dist/pr-report-url.js +46 -5
  508. package/dist/pr-requires.d.ts +13 -2
  509. package/dist/pr-requires.d.ts.map +1 -1
  510. package/dist/pr-requires.js +14 -0
  511. package/dist/release-floors.d.ts +1 -1
  512. package/dist/release-floors.js +1 -1
  513. package/dist/run-event.d.ts +26 -1
  514. package/dist/run-event.d.ts.map +1 -1
  515. package/dist/run-event.js +4 -1
  516. package/dist/sorted-json.d.ts +10 -0
  517. package/dist/sorted-json.d.ts.map +1 -0
  518. package/dist/sorted-json.js +14 -0
  519. package/dist/terraform/credentials.d.ts +59 -0
  520. package/dist/terraform/credentials.d.ts.map +1 -0
  521. package/dist/terraform/credentials.js +149 -0
  522. package/dist/utils.d.ts +1 -4
  523. package/dist/utils.d.ts.map +1 -1
  524. package/dist/utils.js +1 -9
  525. package/dist/wave-runtime.d.ts +1 -1
  526. package/dist/wave-runtime.js +2 -2
  527. package/dist/wave-runtime.mjs +390 -285
  528. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  529. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  530. package/dist/workspace/ci-lock-grain.d.ts +12 -0
  531. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  532. package/dist/workspace/ci-lock-grain.js +27 -0
  533. package/dist/workspace/ci-run.d.ts +2 -1
  534. package/dist/workspace/ci-run.d.ts.map +1 -1
  535. package/dist/workspace/ci-run.js +6 -3
  536. package/dist/workspace/declaration.d.ts +16 -4
  537. package/dist/workspace/declaration.d.ts.map +1 -1
  538. package/dist/workspace/declaration.js +5 -2
  539. package/dist/workspace/declaration.schema.json +27 -3
  540. package/dist/workspace/drift-cli.d.ts.map +1 -1
  541. package/dist/workspace/drift-cli.js +8 -3
  542. package/dist/workspace/exit-cli.d.ts +1 -1
  543. package/dist/workspace/exit-cli.d.ts.map +1 -1
  544. package/dist/workspace/exit-cli.js +2 -1
  545. package/dist/workspace/import-fetch.d.ts +4 -2
  546. package/dist/workspace/import-fetch.d.ts.map +1 -1
  547. package/dist/workspace/import-fetch.js +4 -2
  548. package/dist/workspace/import-init.d.ts.map +1 -1
  549. package/dist/workspace/import-init.js +4 -2
  550. package/dist/workspace/ledger.schema.json +7 -3
  551. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  552. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  553. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  554. package/dist/workspace/pr-report.schema.json +74 -3
  555. package/dist/workspace/promote.d.ts +1 -1
  556. package/dist/workspace/promote.d.ts.map +1 -1
  557. package/dist/workspace/promote.js +2 -1
  558. package/dist/workspace/records-cli.d.ts +2 -2
  559. package/dist/workspace/records-cli.d.ts.map +1 -1
  560. package/dist/workspace/records-cli.js +3 -2
  561. package/dist/workspace/release-catalog.schema.json +277 -0
  562. package/dist/workspace/run-event.schema.json +18 -1
  563. package/dist/workspace/work-cli.d.ts +3 -1
  564. package/dist/workspace/work-cli.d.ts.map +1 -1
  565. package/dist/workspace/work-cli.js +7 -2
  566. package/dist/workspace/workspace-run.d.ts.map +1 -1
  567. package/dist/workspace/workspace-run.js +2 -1
  568. package/package.json +21 -1
  569. package/src/__fixtures__/estate-ledger.ts +101 -0
  570. package/src/__fixtures__/oidc-emulator.ts +31 -2
  571. package/src/__fixtures__/product-words.ts +44 -0
  572. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  573. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  574. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  575. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  576. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  577. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  578. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  579. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  580. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  581. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  582. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  583. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  584. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  585. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  586. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  587. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  588. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  589. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  590. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  591. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  592. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  593. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  594. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  595. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  596. package/src/__golden__/wave-loop/op-point.json +18 -4
  597. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  598. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  599. package/src/__golden__/wave-loop/op-spend.json +10 -2
  600. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  601. package/src/__golden__/wave-loop/op-wide.json +20 -4
  602. package/src/bucket-check/azure.ts +307 -0
  603. package/src/bucket-check/bucket-check.test.ts +210 -0
  604. package/src/bucket-check/fixtures/azure.json +153 -0
  605. package/src/bucket-check/fixtures/gcs.json +148 -0
  606. package/src/bucket-check/fixtures/s3.json +277 -0
  607. package/src/bucket-check/gcs.ts +257 -0
  608. package/src/bucket-check/index.ts +61 -0
  609. package/src/bucket-check/s3.ts +433 -0
  610. package/src/bucket-check/types.ts +75 -0
  611. package/src/bucket-check/wire.ts +50 -0
  612. package/src/bucket-check.ts +5 -0
  613. package/src/capabilities/templates.test.ts +2 -3
  614. package/src/capabilities/templates.ts +1 -2
  615. package/src/cdk/advise.test.ts +1 -1
  616. package/src/change-set-bundle.test.ts +0 -1
  617. package/src/change-set.ts +2 -3
  618. package/src/ci-agent.test.ts +348 -0
  619. package/src/ci-agent.ts +1026 -0
  620. package/src/ci-control.ts +174 -0
  621. package/src/ci-estate/delivery.ts +433 -0
  622. package/src/ci-estate/overdue.ts +81 -0
  623. package/src/ci-estate/page.ts +343 -0
  624. package/src/ci-estate/rows.ts +251 -0
  625. package/src/ci-estate.test.ts +281 -0
  626. package/src/ci-estate.ts +176 -0
  627. package/src/ci-handover.ts +67 -16
  628. package/src/ci-identity-database.test.ts +55 -0
  629. package/src/ci-identity-pulumi.test.ts +163 -0
  630. package/src/ci-identity-targets.test.ts +6 -2
  631. package/src/ci-identity.ts +124 -22
  632. package/src/ci-product-words.test.ts +101 -0
  633. package/src/ci-product-words.ts +536 -0
  634. package/src/ci-product.ts +174 -0
  635. package/src/ci-shared-reads.test.ts +145 -0
  636. package/src/cli/commands/audit.test.ts +1 -1
  637. package/src/cli/commands/audit.ts +3 -2
  638. package/src/cli/commands/carve.test.ts +1 -1
  639. package/src/cli/commands/carve.ts +2 -2
  640. package/src/cli/commands/init.ts +3 -1
  641. package/src/cli/component-wave-args.test.ts +16 -0
  642. package/src/cli/handlers/agent.ts +126 -0
  643. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  644. package/src/cli/handlers/approve-confirm.ts +200 -0
  645. package/src/cli/handlers/approve.ts +18 -1
  646. package/src/cli/handlers/build.test.ts +7 -0
  647. package/src/cli/handlers/build.ts +44 -1
  648. package/src/cli/handlers/ci-check.ts +33 -0
  649. package/src/cli/handlers/ci-forge-check.ts +91 -0
  650. package/src/cli/handlers/fan-out.test.ts +10 -10
  651. package/src/cli/handlers/fan-out.ts +5 -0
  652. package/src/cli/handlers/gate-pending.ts +46 -0
  653. package/src/cli/handlers/init.ts +1 -0
  654. package/src/cli/handlers/ledger.ts +1 -1
  655. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  656. package/src/cli/handlers/lock.test.ts +29 -2
  657. package/src/cli/handlers/lock.ts +66 -6
  658. package/src/cli/handlers/notify-relay.ts +130 -0
  659. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  660. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  661. package/src/cli/handlers/pr-env.ts +48 -11
  662. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  663. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  664. package/src/cli/handlers/pr-waves.test.ts +8 -2
  665. package/src/cli/handlers/pr.test.ts +8 -8
  666. package/src/cli/handlers/pr.ts +655 -205
  667. package/src/cli/handlers/promote.test.ts +5 -5
  668. package/src/cli/handlers/promote.ts +22 -2
  669. package/src/cli/handlers/release.ts +2 -0
  670. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  671. package/src/cli/handlers/run-wave.ts +65 -1
  672. package/src/cli/handlers/run.test.ts +6 -4
  673. package/src/cli/handlers/run.ts +86 -1
  674. package/src/cli/handlers/serve.ts +10 -1
  675. package/src/cli/main.ts +126 -13
  676. package/src/cli/mcp/ledger-tools.ts +126 -0
  677. package/src/cli/mcp/product-tools.test.ts +123 -0
  678. package/src/cli/mcp/product-tools.ts +129 -0
  679. package/src/cli/mcp/read-only.test.ts +134 -0
  680. package/src/cli/mcp/read-only.ts +68 -0
  681. package/src/cli/mcp/report-tools.ts +135 -0
  682. package/src/cli/mcp/server.test.ts +5 -4
  683. package/src/cli/mcp/server.ts +90 -16
  684. package/src/cli/mcp-config.ts +8 -3
  685. package/src/cli/parse-args.ts +42 -2
  686. package/src/cli/registry.ts +35 -0
  687. package/src/cloud-lister/sigv4.ts +80 -23
  688. package/src/components/adoption.test.ts +140 -0
  689. package/src/components/adoption.ts +141 -0
  690. package/src/components/apply-lease.ts +49 -0
  691. package/src/components/capability.ts +130 -6
  692. package/src/components/check-hooks.test.ts +66 -0
  693. package/src/components/check-hooks.ts +252 -0
  694. package/src/components/ci-services.test.ts +51 -0
  695. package/src/components/ci-services.ts +83 -0
  696. package/src/components/cli-support.ts +23 -2
  697. package/src/components/driver.test.ts +3 -3
  698. package/src/components/driver.ts +38 -5
  699. package/src/components/fan-out-run.ts +68 -18
  700. package/src/components/groups.ts +17 -2
  701. package/src/components/pr-comment-preview.test.ts +54 -0
  702. package/src/components/pr-env-ledger.test.ts +9 -0
  703. package/src/components/pr-env-ledger.ts +43 -0
  704. package/src/components/pr-env-ports.ts +29 -4
  705. package/src/components/pr-env-run-bundle.test.ts +8 -0
  706. package/src/components/pr-env-run.test.ts +19 -0
  707. package/src/components/pr-env-run.ts +12 -2
  708. package/src/components/pr-environment.test.ts +29 -0
  709. package/src/components/pr-environment.ts +39 -7
  710. package/src/components/pr-pipeline.test.ts +15 -0
  711. package/src/components/pr-pipeline.ts +274 -9
  712. package/src/components/pr-policy.ts +45 -7
  713. package/src/components/pr-run.test.ts +1 -1
  714. package/src/components/pr-run.ts +121 -5
  715. package/src/components/pr-targets.test.ts +35 -0
  716. package/src/components/pr-targets.ts +45 -0
  717. package/src/components/product-pipeline.test.ts +200 -0
  718. package/src/components/product-pipeline.ts +341 -0
  719. package/src/components/promote.ts +10 -1
  720. package/src/components/release-compile.ts +87 -1
  721. package/src/components/release-promote.ts +65 -1
  722. package/src/components/repo-lock.ts +52 -0
  723. package/src/components/row-lease.test.ts +490 -0
  724. package/src/components/row-lease.ts +167 -0
  725. package/src/components/wave-plan-policy.test.ts +19 -0
  726. package/src/components/wave-plan.ts +78 -4
  727. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  728. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  729. package/src/control/applied.test.ts +148 -0
  730. package/src/control/applied.ts +191 -0
  731. package/src/control/consumers.test.ts +129 -0
  732. package/src/control/consumers.ts +192 -0
  733. package/src/control/control.test.ts +302 -0
  734. package/src/control/dispatch.ts +699 -0
  735. package/src/control/edges.test.ts +112 -0
  736. package/src/control/edges.ts +164 -0
  737. package/src/control/note-checkout.test.ts +91 -0
  738. package/src/control/reconcile.ts +250 -0
  739. package/src/control/records.ts +395 -0
  740. package/src/discovery/sandbox/bundle.ts +25 -1
  741. package/src/engine-facts.test.ts +2 -3
  742. package/src/engine-facts.ts +1 -2
  743. package/src/exit-codes.test.ts +31 -0
  744. package/src/exit-codes.ts +55 -0
  745. package/src/forge-check/check.ts +155 -0
  746. package/src/forge-check/contract.ts +215 -0
  747. package/src/forge-check/forge-check.test.ts +427 -0
  748. package/src/forge-check/forge.ts +318 -0
  749. package/src/forge-check/index.ts +43 -0
  750. package/src/forge-check/pulumi.ts +192 -0
  751. package/src/forge-check/read-only.ts +56 -0
  752. package/src/forge-check/trust.ts +527 -0
  753. package/src/forge-check/types.ts +78 -0
  754. package/src/forge-check.ts +5 -0
  755. package/src/gate-decision-bundle.test.ts +13 -0
  756. package/src/gate-decision.ts +3 -0
  757. package/src/gate-policy.ts +92 -3
  758. package/src/gated-waves-bundle.test.ts +0 -1
  759. package/src/index.ts +2 -0
  760. package/src/lexicon.ts +95 -6
  761. package/src/lifecycle/adoption-file.ts +1 -2
  762. package/src/lifecycle/cloud-index.test.ts +2 -3
  763. package/src/lifecycle/cloud-index.ts +1 -2
  764. package/src/lifecycle/control-entries-ledger.test.ts +70 -0
  765. package/src/lifecycle/gate-applied.ts +6 -0
  766. package/src/lifecycle/gate-ledger.ts +36 -1
  767. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  768. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  769. package/src/lifecycle/gated-request-digest.ts +49 -0
  770. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  771. package/src/lifecycle/gated-request.ts +280 -0
  772. package/src/lifecycle/identity-match.ts +25 -6
  773. package/src/lifecycle/index-diff.ts +1 -2
  774. package/src/lifecycle/index-document.ts +1 -2
  775. package/src/lifecycle/index-import.test.ts +14 -0
  776. package/src/lifecycle/index-import.ts +54 -34
  777. package/src/lifecycle/ledger-read.ts +7 -3
  778. package/src/lifecycle/lock-rows.test.ts +109 -0
  779. package/src/lifecycle/lock-rows.ts +167 -0
  780. package/src/lifecycle/publish-target-context.test.ts +108 -0
  781. package/src/lifecycle/query.test.ts +2 -3
  782. package/src/lifecycle/query.ts +109 -7
  783. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  784. package/src/lifecycle/release-catalog-site.ts +291 -0
  785. package/src/lifecycle/release-catalog.test.ts +193 -0
  786. package/src/lifecycle/release-catalog.ts +353 -0
  787. package/src/lifecycle/release-changelog.test.ts +70 -0
  788. package/src/lifecycle/release-changelog.ts +71 -0
  789. package/src/lifecycle/release-cut.ts +2 -2
  790. package/src/lifecycle/release-ledger.ts +20 -0
  791. package/src/lifecycle/release-publish.ts +45 -22
  792. package/src/lifecycle/release-read.ts +2 -0
  793. package/src/lifecycle/release-status.test.ts +186 -0
  794. package/src/lifecycle/release-status.ts +176 -0
  795. package/src/lifecycle/resource-lock.test.ts +175 -0
  796. package/src/lifecycle/resource-lock.ts +354 -0
  797. package/src/lifecycle/retention.ts +2 -0
  798. package/src/lifecycle/run-ledger.ts +7 -1
  799. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  800. package/src/lifecycle/snapshot-store.ts +1 -2
  801. package/src/lifecycle/target-lock.ts +24 -9
  802. package/src/mcp/types.ts +7 -0
  803. package/src/notify-product.ts +76 -0
  804. package/src/notify-relay.test.ts +213 -0
  805. package/src/notify-relay.ts +407 -0
  806. package/src/notify.ts +95 -14
  807. package/src/object-store/azure-blob.ts +374 -0
  808. package/src/object-store/common.ts +133 -0
  809. package/src/object-store/errors.ts +26 -0
  810. package/src/object-store/from-env.ts +36 -0
  811. package/src/object-store/gcs.ts +436 -0
  812. package/src/object-store/index.ts +8 -0
  813. package/src/object-store/object-store.test.ts +130 -0
  814. package/src/object-store/s3.ts +350 -0
  815. package/src/op/activities/converge.ts +2 -1
  816. package/src/op/activities/index.ts +1 -1
  817. package/src/op/activities/review-agent.open.test.ts +78 -0
  818. package/src/op/activities/review-agent.test.ts +13 -0
  819. package/src/op/activities/review-agent.ts +89 -5
  820. package/src/op/gate.ts +81 -22
  821. package/src/op/generate-pipeline.ts +7 -1
  822. package/src/op/index.ts +21 -0
  823. package/src/op/op-waves-after-plan.test.ts +276 -0
  824. package/src/op/op-waves-after-plan.ts +238 -0
  825. package/src/op/op-waves-capability-spec.ts +113 -0
  826. package/src/op/op-waves-capability.test.ts +217 -0
  827. package/src/op/op-waves-capability.ts +370 -0
  828. package/src/op/op-waves-events.ts +135 -0
  829. package/src/op/op-waves-notify-words.test.ts +149 -0
  830. package/src/op/op-waves-notify.ts +41 -16
  831. package/src/op/op-waves-pull-request.test.ts +142 -0
  832. package/src/op/op-waves-release-port.ts +64 -0
  833. package/src/op/op-waves-release.test.ts +209 -0
  834. package/src/op/op-waves-release.ts +133 -0
  835. package/src/op/op-waves-run-record.test.ts +32 -0
  836. package/src/op/op-waves-run.ts +1142 -49
  837. package/src/op/op-waves-stand-down.test.ts +240 -0
  838. package/src/op/op-waves-stand-down.ts +108 -0
  839. package/src/op/op-waves-trace.test.ts +205 -0
  840. package/src/op/op-waves.test.ts +112 -0
  841. package/src/op/op-waves.ts +261 -20
  842. package/src/op/runtime.ts +104 -0
  843. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  844. package/src/op/stage-hooks.ts +91 -12
  845. package/src/op/steward-beside.ts +2 -1
  846. package/src/op/types.ts +3 -2
  847. package/src/otlp-metrics.ts +96 -0
  848. package/src/otlp.test.ts +243 -0
  849. package/src/otlp.ts +544 -0
  850. package/src/override-gate-bundle.test.ts +2 -0
  851. package/src/override-gate.ts +4 -0
  852. package/src/policy-packs.ts +230 -0
  853. package/src/policy-source.test.ts +256 -0
  854. package/src/policy-source.ts +112 -0
  855. package/src/pr-forge.ts +123 -0
  856. package/src/pr-loop-bundle.test.ts +6 -2
  857. package/src/pr-loop-words.test.ts +155 -0
  858. package/src/pr-loop.ts +371 -52
  859. package/src/pr-post.ts +32 -1
  860. package/src/pr-report-url.ts +62 -6
  861. package/src/pr-requires.test.ts +37 -1
  862. package/src/pr-requires.ts +16 -2
  863. package/src/product-subpaths-plain-node.e2e.test.ts +211 -0
  864. package/src/release-floors.ts +1 -1
  865. package/src/run-event.ts +29 -1
  866. package/src/sorted-json.ts +17 -0
  867. package/src/stage-hooks-bundle.test.ts +8 -0
  868. package/src/terraform/credentials.test.ts +77 -0
  869. package/src/terraform/credentials.ts +162 -0
  870. package/src/utils.ts +2 -11
  871. package/src/wave-loop-golden.test.ts +2 -1
  872. package/src/wave-runtime.ts +2 -2
  873. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  874. package/src/workspace/ci-lock-grain.test.ts +31 -0
  875. package/src/workspace/ci-lock-grain.ts +30 -0
  876. package/src/workspace/ci-report-url.test.ts +1 -1
  877. package/src/workspace/ci-run.test.ts +1 -1
  878. package/src/workspace/ci-run.ts +6 -3
  879. package/src/workspace/declaration.schema.json +27 -3
  880. package/src/workspace/declaration.test.ts +1 -1
  881. package/src/workspace/declaration.ts +26 -10
  882. package/src/workspace/drift-cli.ts +8 -3
  883. package/src/workspace/exit-cli.ts +2 -1
  884. package/src/workspace/import-fetch.ts +4 -2
  885. package/src/workspace/import-init.ts +4 -2
  886. package/src/workspace/ledger.schema.json +7 -3
  887. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  888. package/src/workspace/pr-report.schema.json +74 -3
  889. package/src/workspace/promote.ts +2 -1
  890. package/src/workspace/records-cli.ts +3 -2
  891. package/src/workspace/release-catalog.schema.json +277 -0
  892. package/src/workspace/run-event.schema.json +18 -1
  893. package/src/workspace/work-cli.ts +8 -2
  894. package/src/workspace/workspace-run.ts +2 -1
package/src/pr-post.ts CHANGED
@@ -28,6 +28,8 @@ import { join } from "node:path";
28
28
  import { prNoteMarker, prStatusContext, prStatusDescription, prStatusState, renderPrNote, type PrOverdue, type PrReport } from "./pr-loop";
29
29
  import { forgePrincipalOf, type PrForge } from "./pr-forge";
30
30
  import { GITHUB_COMMENT_LIMIT, GITLAB_NOTE_LIMIT } from "./plan-summary";
31
+ import { activeProductWords, type CiProductWords } from "./ci-product-words";
32
+ import { controlEdgeFactsFromEnv, remarkCrossStackEdges, type ControlEdgeFacts } from "./control/edges";
31
33
 
32
34
  /** The plan report's file under the report directory. */
33
35
  export const PR_PLAN_REPORT_FILE = "pr-plan.json";
@@ -50,6 +52,12 @@ export interface PlanPostInput {
50
52
  * job held no token to ask with. It replaces any `overdue` in the report.
51
53
  */
52
54
  overdue?: () => Promise<PrOverdue[]>;
55
+ /**
56
+ * The control repo's entries and apply records (#4617), which mark the
57
+ * report's cross-stack edges stale, current or unknown. Default: read
58
+ * from the checkout `CHANT_CONTROL_DIR` names, when it names one.
59
+ */
60
+ controlFacts?: () => Promise<ControlEdgeFacts | undefined>;
53
61
  }
54
62
 
55
63
  /** What {@link postPlanReport} did. */
@@ -133,6 +141,11 @@ export async function postPlanReport(input: PlanPostInput): Promise<PlanPostResu
133
141
  const found = await input.overdue().catch(() => [] as PrOverdue[]);
134
142
  report = (found.length > 0 ? { ...rest, overdue: found } : rest) as PrReport;
135
143
  }
144
+ // #4617: the marks come from the control repo, read here; the plan job's never show.
145
+ if (report.crossStackEdges?.length) {
146
+ const facts = await (input.controlFacts ?? (() => controlEdgeFactsFromEnv()))().catch(() => undefined);
147
+ report = remarkCrossStackEdges(report, facts);
148
+ }
136
149
  try {
137
150
  state = prStatusState(report);
138
151
  description = prStatusDescription(report);
@@ -156,7 +169,7 @@ export async function postPlanReport(input: PlanPostInput): Promise<PlanPostResu
156
169
  }
157
170
  if (note !== undefined) {
158
171
  try {
159
- await input.forge.upsertNote(input.pr, prNoteMarker(input.env, input.member), note);
172
+ await upsertPlanNote(input.forge, input.pr, prNoteMarker(input.env, input.member), note);
160
173
  } catch (err) {
161
174
  warnings.push(`could not post the note on #${input.pr}: ${err instanceof Error ? err.message : String(err)}`);
162
175
  note = undefined;
@@ -165,6 +178,24 @@ export async function postPlanReport(input: PlanPostInput): Promise<PlanPostResu
165
178
  return { state, description: cut(description), noted: note !== undefined, ...(refused ? { refused } : {}), warnings };
166
179
  }
167
180
 
181
+ /**
182
+ * Post the plan note, or update it. Under a product's words that carry
183
+ * `adoptMarkers` (#4550), a pull request with no chant note yet but a note the
184
+ * product posted before it moved onto chant's pipeline gets that note
185
+ * updated, with the old marker kept at its end, so the pull request keeps one
186
+ * note across the switch.
187
+ */
188
+ export async function upsertPlanNote(forge: Pick<PrForge, "upsertNote" | "findComment" | "upsertComment">, pr: number, marker: string, note: string, words: CiProductWords = activeProductWords()): Promise<void> {
189
+ if (words.adoptMarkers.length > 0 && !(await forge.findComment(pr, marker))) {
190
+ for (const old of words.adoptMarkers) {
191
+ if (!(await forge.findComment(pr, old, { match: "anywhere" }))) continue;
192
+ await forge.upsertComment(pr, old, `${note}${note.endsWith("\n") ? "" : "\n"}${old}\n`, { match: "anywhere" });
193
+ return;
194
+ }
195
+ }
196
+ await forge.upsertNote(pr, marker, note);
197
+ }
198
+
168
199
  /** What {@link postOpenPlanReports} posts for. */
169
200
  export interface OpenPlanPostInput {
170
201
  /** A GitLab client with {@link PrForge.mergeRequestJobs}, {@link PrForge.jobArtifact} and {@link PrForge.statusUrl}. */
@@ -32,17 +32,33 @@
32
32
  * environment the job gives it, the way the aws lexicon's `s3-sync` does.
33
33
  * chant passes it no credential and prints none: a failed upload prints the
34
34
  * CLI's own error line.
35
+ *
36
+ * Two more (#4554): `gs://<bucket>/<prefix>` and `az://<account>/<container>/
37
+ * <prefix>` go through chant core's object-store clients (./object-store),
38
+ * which read the job's credentials from its environment the way terragucci's
39
+ * report uploads do: GOOGLE_APPLICATION_CREDENTIALS (or a traded
40
+ * GOOGLE_OAUTH_ACCESS_TOKEN) for GCS, and AZURE_STORAGE_KEY or the ARM_
41
+ * OIDC variables for Azure Blob Storage. An older chant refuses either
42
+ * scheme, so a declaration whose `ci.reportUrl` uses one needs
43
+ * {@link REPORT_URL_CLOUDS_FLOOR} as its `minReader`.
35
44
  */
36
45
 
37
46
  import { spawn } from "node:child_process";
38
47
  import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
39
48
  import { dirname, isAbsolute, join } from "node:path";
40
49
  import { fileURLToPath } from "node:url";
50
+ import { NEXT_RELEASE } from "./release-floors";
51
+ import type { ObjectStore } from "./object-store/common";
52
+
53
+ /** The first chant that reads a `gs://` or `az://` report URL (#4554). */
54
+ export const REPORT_URL_CLOUDS_FLOOR = NEXT_RELEASE;
41
55
 
42
56
  /** Where `--report-url` points. */
43
57
  export type ReportTarget =
44
58
  | { scheme: "file"; url: string; dir: string }
45
- | { scheme: "s3"; url: string; bucket: string; prefix: string };
59
+ | { scheme: "s3"; url: string; bucket: string; prefix: string }
60
+ | { scheme: "gs"; url: string; bucket: string; prefix: string }
61
+ | { scheme: "az"; url: string; account: string; container: string; prefix: string };
46
62
 
47
63
  /** `--report-url` read, or why it can't be. `name` is what the error calls the value: the flag, or `ci.reportUrl` (#4160). */
48
64
  export function parseReportUrl(raw: string, name = "--report-url"): ReportTarget | { error: string } {
@@ -62,7 +78,18 @@ export function parseReportUrl(raw: string, name = "--report-url"): ReportTarget
62
78
  const prefix = s3[2]!.replace(/\/+$/, "");
63
79
  return { scheme: "s3", url: `s3://${s3[1]}${prefix ? `/${prefix}` : ""}`, bucket: s3[1]!, prefix };
64
80
  }
65
- return { error: `${name} ${url}: takes an s3://<bucket>/<prefix> or file://<directory> URL` };
81
+ // #4554: a GCS bucket and an Azure container, named as terragucci's reports.bucket names them.
82
+ const gs = /^gs:\/\/([a-z0-9][a-z0-9._-]{1,221}[a-z0-9])(?:\/(.*))?$/.exec(url);
83
+ if (gs) {
84
+ const prefix = (gs[2] ?? "").replace(/\/+$/, "");
85
+ return { scheme: "gs", url: `gs://${gs[1]}${prefix ? `/${prefix}` : ""}`, bucket: gs[1]!, prefix };
86
+ }
87
+ const az = /^az:\/\/([a-z0-9]{3,24})\/([a-z0-9](?:[a-z0-9]|-(?=[a-z0-9])){2,62})(?:\/(.*))?$/.exec(url);
88
+ if (az) {
89
+ const prefix = (az[3] ?? "").replace(/\/+$/, "");
90
+ return { scheme: "az", url: `az://${az[1]}/${az[2]}${prefix ? `/${prefix}` : ""}`, account: az[1]!, container: az[2]!, prefix };
91
+ }
92
+ return { error: `${name} ${url}: takes an s3://<bucket>/<prefix>, gs://<bucket>/<prefix>, az://<account>/<container>/<prefix> or file://<directory> URL` };
66
93
  }
67
94
 
68
95
  /** The key a stage's files are kept under, below the URL: `<pr>/<commit>[/<member>]`. */
@@ -103,8 +130,33 @@ export const realAwsCli: AwsCli = (args, stdin) =>
103
130
  child.stdin.end(stdin);
104
131
  });
105
132
 
106
- /** A put for `target`. `aws` replaces the AWS CLI in a test. */
107
- export function reportPut(target: ReportTarget, aws: AwsCli = realAwsCli): ReportPut {
133
+ /**
134
+ * The object-store client for a `gs://` or `az://` target (#4554), made once
135
+ * on first use from the job's environment. `store` replaces it in a test.
136
+ */
137
+ export type ReportStore = () => Promise<ObjectStore>;
138
+
139
+ function cloudStore(target: Extract<ReportTarget, { scheme: "gs" | "az" }>, env: NodeJS.ProcessEnv = process.env): ReportStore {
140
+ let made: Promise<ObjectStore> | undefined;
141
+ return () =>
142
+ (made ??= import("./object-store/index").then((m) =>
143
+ target.scheme === "gs"
144
+ ? new m.GcsClient(m.gcsFromEnv({ bucket: target.bucket, setting: "the report URL" }, env))
145
+ : new m.AzureBlobClient(m.azureFromEnv({ account: target.account, container: target.container, setting: "the report URL" }, env)),
146
+ ));
147
+ }
148
+
149
+ /** A key below a cloud target's prefix. */
150
+ const cloudKey = (target: { prefix: string }, key: string): string => `${target.prefix ? `${target.prefix}/` : ""}${key}`;
151
+
152
+ /** A put for `target`. `aws` replaces the AWS CLI in a test, and `store` a GCS or Azure client. */
153
+ export function reportPut(target: ReportTarget, aws: AwsCli = realAwsCli, store?: ReportStore): ReportPut {
154
+ if (target.scheme === "gs" || target.scheme === "az") {
155
+ const open = store ?? cloudStore(target);
156
+ return async (key, body, contentType) => {
157
+ await (await open()).put(cloudKey(target, key), body, contentType);
158
+ };
159
+ }
108
160
  if (target.scheme === "file") {
109
161
  return async (key, body) => {
110
162
  const path = join(target.dir, ...key.split("/"));
@@ -149,8 +201,12 @@ export const realAwsRead: AwsRead = (args) =>
149
201
  /** What the AWS CLI says about an object that does not exist. */
150
202
  const S3_ABSENT = /\(404\)|Not Found|NoSuchKey|does not exist/i;
151
203
 
152
- /** A get for `target`. `aws` replaces the AWS CLI in a test. */
153
- export function reportGet(target: ReportTarget, aws: AwsRead = realAwsRead): ReportGet {
204
+ /** A get for `target`. `aws` replaces the AWS CLI in a test, and `store` a GCS or Azure client. */
205
+ export function reportGet(target: ReportTarget, aws: AwsRead = realAwsRead, store?: ReportStore): ReportGet {
206
+ if (target.scheme === "gs" || target.scheme === "az") {
207
+ const open = store ?? cloudStore(target);
208
+ return async (key) => (await (await open()).get(cloudKey(target, key))) ?? null;
209
+ }
154
210
  if (target.scheme === "file") {
155
211
  return async (key) => {
156
212
  try {
@@ -6,7 +6,8 @@
6
6
 
7
7
  import { describe, expect, test } from "vitest";
8
8
  import { forgejoForge, githubForge, gitlabForge, type ForgeFetch, type PrForge } from "./pr-forge";
9
- import { checkPrRequires, PR_APPLY_REQUIRES, unmetRequires } from "./pr-requires";
9
+ import { checkPrRequires, parseRequiresList, PR_APPLY_REQUIRES, unmetRequires } from "./pr-requires";
10
+ import { parseArgs } from "./cli/parse-args";
10
11
 
11
12
  /** A fake forge: `routes` maps `METHOD path-without-query` to a body, a status, or a function of the query. */
12
13
  function fakeFetch(routes: Record<string, unknown | ((q: URLSearchParams) => unknown)>): ForgeFetch {
@@ -283,3 +284,38 @@ describe("checkPrRequires", () => {
283
284
  expect(unmetRequires(out)).toBe("approved: could not ask gitlab: 401; mergeable: this gitlab client cannot say; undiverged: this gitlab client cannot say; checks: this gitlab client cannot say");
284
285
  });
285
286
  });
287
+
288
+ describe("--requires (#4607)", () => {
289
+ test("names the checks in the four's order, comma lists and repeats folded", () => {
290
+ expect(parseRequiresList(["checks,approved"])).toEqual({ checks: ["approved", "checks"] });
291
+ expect(parseRequiresList(["mergeable", "mergeable, undiverged"])).toEqual({ checks: ["mergeable", "undiverged"] });
292
+ });
293
+
294
+ test("an unknown check, or none, is an error naming the four", () => {
295
+ const unknown = parseRequiresList(["approved,green"]);
296
+ expect("error" in unknown && unknown.error).toContain('"green" is not one of them');
297
+ expect("error" in unknown && unknown.error).toContain("approved, mergeable, undiverged, checks");
298
+ expect("error" in parseRequiresList([","])).toBe(true);
299
+ });
300
+
301
+ test("pr-apply parses the flag into args.requires", () => {
302
+ expect(parseArgs(["components", "pr-apply", "--before-merge", "--pr", "7", "--requires", "approved,checks"]).requires).toEqual(["approved", "checks"]);
303
+ expect(() => parseArgs(["components", "pr-apply", "--requires", "--json"])).toThrow(/--requires needs a list/);
304
+ });
305
+
306
+ test("a product's subset asks only those checks", async () => {
307
+ const calls: string[] = [];
308
+ const forge = {
309
+ kind: "github",
310
+ prApproved: async () => (calls.push("approved"), { passed: true, reason: "ok" }),
311
+ prMergeable: async () => (calls.push("mergeable"), { passed: false, reason: "conflict" }),
312
+ prUndiverged: async () => (calls.push("undiverged"), { passed: false, reason: "behind" }),
313
+ prChecksPassed: async () => (calls.push("checks"), { passed: true, reason: "green" }),
314
+ } as unknown as PrForge;
315
+ const parsed = parseRequiresList(["approved,checks"]);
316
+ if ("error" in parsed) throw new Error(parsed.error);
317
+ const out = await checkPrRequires(forge, 7, HEAD, { only: parsed.checks, reads: 1 });
318
+ expect(calls).toEqual(["approved", "checks"]);
319
+ expect(unmetRequires(out)).toBeNull();
320
+ });
321
+ });
@@ -5,8 +5,9 @@
5
5
  *
6
6
  * The checks are terragucci's `apply.requires` (comment-apply.ts:781-860 at
7
7
  * INTENTIUS/terragucci e6cb431). A product may leave one out with `only`
8
- * (#4336); chant's own `pr-apply --before-merge` passes no `only`, so it asks
9
- * all four, as ws-106 requires. A check the
8
+ * (#4336). `pr-apply --before-merge` asks all four, as ws-106 requires,
9
+ * unless `--requires <list>` names fewer (#4607), which is how a product's
10
+ * `apply.requires` reaches it. A check the
10
11
  * forge has not settled, such as GitHub working out whether a pull request
11
12
  * can merge, is asked again a few times before it counts as unmet.
12
13
  *
@@ -89,6 +90,19 @@ export async function checkPrRequires(forge: PrForge, pr: number, head: string,
89
90
  return out;
90
91
  }
91
92
 
93
+ /**
94
+ * The checks a `--requires` list names (#4607), in {@link PR_APPLY_REQUIRES}
95
+ * order: comma lists are split, repeats dropped. An unknown name, or a list
96
+ * that names none, is an error naming the four.
97
+ */
98
+ export function parseRequiresList(values: readonly string[]): { checks: PrApplyRequire[] } | { error: string } {
99
+ const names = values.flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
100
+ const unknown = names.filter((n) => !(PR_APPLY_REQUIRES as readonly string[]).includes(n));
101
+ if (unknown.length > 0) return { error: `--requires takes ${PR_APPLY_REQUIRES.join(", ")}; ${unknown.map((u) => JSON.stringify(u)).join(", ")} is not one of them` };
102
+ if (names.length === 0) return { error: `--requires names at least one of ${PR_APPLY_REQUIRES.join(", ")}` };
103
+ return { checks: PR_APPLY_REQUIRES.filter((n) => names.includes(n)) };
104
+ }
105
+
92
106
  /** The unmet checks as one line, or null when all four passed. */
93
107
  export function unmetRequires(outcomes: readonly PrRequireOutcome[]): string | null {
94
108
  const unmet = outcomes.filter((o) => !o.passed);
@@ -0,0 +1,211 @@
1
+ /**
2
+ * The products import the installed, pinned chant at run time (chant#4591).
3
+ * plywood and terragucci mark `@intentius/chant*` external in their CLI
4
+ * bundles, so every subpath they load must resolve, under plain Node and no
5
+ * TypeScript loader, to compiled JS. Node does not strip types under
6
+ * node_modules, so the core exports carry an `import` condition on `dist/*.js`
7
+ * beside `development` and `default`, as `./notify` did first (#3803).
8
+ *
9
+ * This packs core and the terraform lexicon the way a release does (each
10
+ * prepack builds dist/), unpacks both into a scratch project's node_modules,
11
+ * links the rest of the repository's installed dependencies beside them, and
12
+ * imports each subpath with `node` and nothing else. A compiled lexicon
13
+ * imports core too, so the lexicon rows also prove core's root and subpaths
14
+ * reach dist/.
15
+ *
16
+ * End to end because `npm pack` runs both package builds.
17
+ */
18
+
19
+ import { execFileSync } from "node:child_process";
20
+ import { mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, symlinkSync } from "node:fs";
21
+ import { tmpdir } from "node:os";
22
+ import { join, resolve } from "node:path";
23
+ import { transformSync } from "esbuild";
24
+ import { afterAll, beforeAll, describe, expect, test } from "vitest";
25
+
26
+ const coreRoot = resolve(import.meta.dirname, "..");
27
+ const repoRoot = resolve(coreRoot, "..", "..");
28
+ const terraformRoot = join(repoRoot, "lexicons", "terraform");
29
+
30
+ /**
31
+ * Every `@intentius/chant` subpath plywood or terragucci loads at run time
32
+ * (type-only imports left out), from packages/plywood/src and
33
+ * packages/terragucci/src at integration/ci-products, plus the ones chant#4591
34
+ * names. A product that starts importing another one adds it here.
35
+ */
36
+ const CORE_SUBPATHS = [
37
+ "",
38
+ "bucket-check",
39
+ "change-set",
40
+ "ci-control",
41
+ "ci-estate",
42
+ "ci-handover",
43
+ "ci-identity",
44
+ "ci-product",
45
+ "components",
46
+ "components/capability",
47
+ "components/check-hooks",
48
+ "components/component",
49
+ "components/pr-env-run",
50
+ "components/pr-environment",
51
+ "components/verbs/sign",
52
+ "exit-codes",
53
+ "forge-check",
54
+ "gate-decision",
55
+ "gate-policy",
56
+ "gate-resume-run",
57
+ "gated-waves",
58
+ "lifecycle/gate-audit",
59
+ "lifecycle/git",
60
+ "lifecycle/ledger-read",
61
+ "lifecycle/plan-digest",
62
+ "lifecycle/query",
63
+ "lifecycle/release-ledger",
64
+ "lifecycle/target-lock",
65
+ "lint/post-synth",
66
+ "notify",
67
+ "object-store",
68
+ "op",
69
+ "op/activities",
70
+ "op/activities/review-agent",
71
+ "op/gate-resume-plan",
72
+ "op/op-waves",
73
+ "op/schedule-overdue",
74
+ "op/stage-hooks",
75
+ "override-gate",
76
+ "plan-summary",
77
+ "point-decision",
78
+ "pr-forge",
79
+ "pr-requires",
80
+ "read-filter",
81
+ "terraform/credentials",
82
+ "terraform/parse",
83
+ "wave-blocked",
84
+ "workspace/ci-branches",
85
+ "workspace/declaration",
86
+ "workspace/which-chant",
87
+ "yaml",
88
+ ] as const;
89
+
90
+ /** The terraform lexicon subpaths the products load (and chant#4591 names). */
91
+ const TERRAFORM_SUBPATHS = [
92
+ "change-set",
93
+ "changed-roots",
94
+ "compose",
95
+ "compose/estate",
96
+ "compose/root",
97
+ "compose/run",
98
+ "compose/slice",
99
+ "config",
100
+ "drift-rows",
101
+ "hcl/parse",
102
+ "lint/post-synth/tf046",
103
+ "pin",
104
+ "plan-digest",
105
+ "plan-shape",
106
+ "registry",
107
+ "registry/edge",
108
+ "state",
109
+ "terragrunt/affected",
110
+ "terragrunt/mocks",
111
+ "terragrunt/run",
112
+ "terragrunt/units",
113
+ "terragrunt/wave",
114
+ ] as const;
115
+
116
+ let scratch: string;
117
+ let consumer: string;
118
+
119
+ /** Packs `dir` into `scratch` and unpacks it at `consumer/node_modules/<name>`. */
120
+ function packInto(dir: string, name: string): void {
121
+ const packed = JSON.parse(
122
+ execFileSync("npm", ["pack", "--json", "--pack-destination", scratch], { cwd: dir, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }),
123
+ ) as { filename: string }[];
124
+ const into = join(consumer, "node_modules", name);
125
+ mkdirSync(into, { recursive: true });
126
+ execFileSync("tar", ["-xzf", join(scratch, packed[0].filename), "-C", into, "--strip-components=1"]);
127
+ }
128
+
129
+ beforeAll(() => {
130
+ scratch = mkdtempSync(join(tmpdir(), "chant-product-subpaths-"));
131
+ consumer = join(scratch, "consumer");
132
+ mkdirSync(join(consumer, "node_modules", "@intentius"), { recursive: true });
133
+ packInto(coreRoot, "@intentius/chant");
134
+ packInto(terraformRoot, "@intentius/chant-lexicon-terraform");
135
+ // Third-party dependencies come from the repository's install: the
136
+ // hoisted ones beside the packages, core's nested ones under core.
137
+ for (const name of readdirSync(join(repoRoot, "node_modules"))) {
138
+ if (name === "@intentius" || name.startsWith(".")) continue;
139
+ symlinkSync(join(repoRoot, "node_modules", name), join(consumer, "node_modules", name), "dir");
140
+ }
141
+ symlinkSync(join(coreRoot, "node_modules"), join(consumer, "node_modules", "@intentius", "chant", "node_modules"), "dir");
142
+ }, 900_000);
143
+
144
+ afterAll(() => {
145
+ if (scratch) rmSync(scratch, { recursive: true, force: true });
146
+ });
147
+
148
+ /** Imports each specifier under plain node in the consumer project, with no loader. */
149
+ function importEach(specifiers: readonly string[]): { specifier: string; from?: string; exports?: number; error?: string }[] {
150
+ const env = { ...process.env };
151
+ delete env.NODE_OPTIONS;
152
+ const source = `
153
+ const out = [];
154
+ for (const specifier of ${JSON.stringify(specifiers)}) {
155
+ try {
156
+ const m = await import(specifier);
157
+ out.push({ specifier, from: import.meta.resolve(specifier), exports: Object.keys(m).length });
158
+ } catch (e) {
159
+ out.push({ specifier, error: String(e?.message ?? e).split("\\n")[0] });
160
+ }
161
+ }
162
+ console.log(JSON.stringify(out));
163
+ `;
164
+ return JSON.parse(execFileSync(process.execPath, ["--input-type=module", "-e", source], { cwd: consumer, env, encoding: "utf-8" }));
165
+ }
166
+
167
+ /** Every .js and .mjs file under `dir`. */
168
+ function compiledFiles(dir: string): string[] {
169
+ return readdirSync(dir).flatMap((name) => {
170
+ const path = join(dir, name);
171
+ if (statSync(path).isDirectory()) return name === "node_modules" ? [] : compiledFiles(path);
172
+ return /\.m?js$/.test(name) ? [path] : [];
173
+ });
174
+ }
175
+
176
+ describe("product subpaths under plain Node (chant#4591)", () => {
177
+ test("every compiled module in both tarballs parses", () => {
178
+ // A product's bundler parses every module an import reaches, dynamic ones
179
+ // too. tsc-alias once rewrote a regex shaped like an import and left a
180
+ // file Node could not parse (chud-lexicon-exit.js).
181
+ const unparsed: string[] = [];
182
+ for (const pkg of ["@intentius/chant", "@intentius/chant-lexicon-terraform"]) {
183
+ for (const file of compiledFiles(join(consumer, "node_modules", pkg, "dist"))) {
184
+ try {
185
+ transformSync(readFileSync(file, "utf-8"), { format: "esm", loader: "js", logLevel: "silent" });
186
+ } catch (e) {
187
+ unparsed.push(`${file}: ${(e as { errors?: { text: string }[] }).errors?.[0]?.text ?? String(e)}`);
188
+ }
189
+ }
190
+ }
191
+ expect(unparsed).toEqual([]);
192
+ });
193
+
194
+
195
+ test("every core subpath a product loads imports from dist/", () => {
196
+ const results = importEach(CORE_SUBPATHS.map((s) => (s ? `@intentius/chant/${s}` : "@intentius/chant")));
197
+ expect(results.filter((r) => r.error)).toEqual([]);
198
+ for (const r of results) {
199
+ expect(r.from, r.specifier).toMatch(/\/node_modules\/@intentius\/chant\/dist\/.+\.js$/);
200
+ expect(r.exports, r.specifier).toBeGreaterThan(0);
201
+ }
202
+ });
203
+
204
+ test("every terraform lexicon subpath a product loads imports from dist/, with core from dist/ under it", () => {
205
+ const results = importEach(TERRAFORM_SUBPATHS.map((s) => `@intentius/chant-lexicon-terraform/${s}`));
206
+ expect(results.filter((r) => r.error)).toEqual([]);
207
+ for (const r of results) {
208
+ expect(r.from, r.specifier).toMatch(/\/node_modules\/@intentius\/chant-lexicon-terraform\/dist\/.+\.js$/);
209
+ }
210
+ });
211
+ });
@@ -19,4 +19,4 @@
19
19
  * this constant to the next patch (#4501). The check fails while a floor
20
20
  * still names this constant after its version shipped.
21
21
  */
22
- export const NEXT_RELEASE = "0.124.54";
22
+ export const NEXT_RELEASE = "0.124.55";
package/src/run-event.ts CHANGED
@@ -19,7 +19,7 @@
19
19
  * {@link runEventOfProgress} and {@link runEventsOfStepRecord} say how each
20
20
  * maps onto this contract.
21
21
  *
22
- * This module imports no runtime code beyond the chant version (`./chant-version.ts`), so a consumer
22
+ * This module imports no runtime code beyond the chant version (`./chant-version.ts`) and the release floors (`./release-floors.ts`), so a consumer
23
23
  * can import the types and the writer without loading the rest of chant. It
24
24
  * lives outside `workspace/` so that a level-0 import of `@intentius/chant`
25
25
  * loads no workspace module (#2526).
@@ -29,6 +29,7 @@ import type { RunProgressEvent } from "./components/run-progress";
29
29
  import type { RunOrigin } from "./lifecycle/release-ledger";
30
30
  import type { StepRecord } from "./op/local-executor";
31
31
  import { CHANT_VERSION } from "./chant-version";
32
+ import { NEXT_RELEASE } from "./release-floors";
32
33
 
33
34
  /** The schema's `$id`, which every event carries as `$schema`. */
34
35
  export const RUN_EVENT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/run-event/v1/run-event.schema.json";
@@ -215,8 +216,35 @@ export interface RunEventStepSettle {
215
216
  error?: string;
216
217
  /** Why the step skipped, gated or waited, for a person. */
217
218
  message?: string;
219
+ /**
220
+ * What the step did to each resource, when its engine reported it (#4615),
221
+ * such as plunge's per-resource timings on a `pulumi-up` step. Optional,
222
+ * added within contract 1 by chant {@link RUN_EVENT_RESOURCES_FLOOR}; a
223
+ * reader that does not know it ignores it.
224
+ */
225
+ resources?: RunEventResource[];
226
+ }
227
+
228
+ /** One resource a step changed or tried to (#4615). */
229
+ export interface RunEventResource {
230
+ /** The engine's id for it: a URN, an address. */
231
+ resource: string;
232
+ /** Its type, when the engine names one. */
233
+ type?: string;
234
+ /** Its name, when the engine names one apart from the id. */
235
+ name?: string;
236
+ status: "ok" | "failed";
237
+ /** When the engine started on it, ISO-8601, when it says. */
238
+ startedAt?: string;
239
+ /** How long the engine spent on it, or null when it did not time it. */
240
+ durationMs: number | null;
241
+ /** How many engine calls it took (provider calls, record writes), when the engine counts them. */
242
+ calls?: number;
218
243
  }
219
244
 
245
+ /** The first chant that writes `resources` on `step-settle` (#4615). */
246
+ export const RUN_EVENT_RESOURCES_FLOOR = NEXT_RELEASE;
247
+
220
248
  /** The run stopped at a gate nobody has approved, or a decision point nobody has answered. */
221
249
  export interface RunEventGateWaiting {
222
250
  type: "gate-waiting";
@@ -0,0 +1,17 @@
1
+ /**
2
+ * The JSON replacer that sorts object keys, alone in a leaf module so a small
3
+ * bundle that digests JSON (the gate decision's gated-request digest, #4551)
4
+ * takes it without `./utils.ts` and its AttrRef import.
5
+ */
6
+
7
+ /**
8
+ * JSON.stringify replacer that sorts object keys for deterministic output.
9
+ */
10
+ export function sortedJsonReplacer(_key: string, value: unknown): unknown {
11
+ if (value && typeof value === "object" && !Array.isArray(value)) {
12
+ return Object.fromEntries(
13
+ Object.entries(value as Record<string, unknown>).sort(([a], [b]) => a.localeCompare(b))
14
+ );
15
+ }
16
+ return value;
17
+ }
@@ -24,13 +24,21 @@ describe("the stage-hooks bundle", () => {
24
24
  logLevel: "silent",
25
25
  });
26
26
  expect(Object.keys(result.metafile.inputs).map((i) => i.replace(/^.*?packages\//, "packages/")).sort()).toEqual([
27
+ // The product's words (#4550): gate and status names, no imports.
28
+ "packages/core/src/ci-product-words.ts",
29
+ // The control repo's settings check (#4568, #4617), which the spec checks.
30
+ "packages/core/src/control/dispatch.ts",
27
31
  "packages/core/src/lifecycle/gate-seal.ts",
28
32
  "packages/core/src/notify-verify.ts",
29
33
  "packages/core/src/notify.ts",
30
34
  "packages/core/src/op/gate-point.ts",
31
35
  "packages/core/src/op/gate-quorum.ts",
36
+ "packages/core/src/op/op-waves-capability-spec.ts",
37
+ "packages/core/src/op/op-waves-release.ts",
32
38
  "packages/core/src/op/op-waves.ts",
33
39
  "packages/core/src/op/stage-hooks.ts",
40
+ // The next-release floor constant (#4480): no imports.
41
+ "packages/core/src/release-floors.ts",
34
42
  "packages/core/src/wave-blocked.ts",
35
43
  "packages/core/src/wave-layout.ts",
36
44
  ]);
@@ -0,0 +1,77 @@
1
+ // The token lookup Terraform and OpenTofu use (chant#4563): TF_TOKEN_<host> first, then the CLI config
2
+ // file and credentials.tfrc.json.
3
+ import { describe, expect, it } from "vitest";
4
+ import { authorizationFor, credentialsHost, credentialsFilePath, terraformCredential, terraformToken, tokenVariable } from "./credentials";
5
+
6
+ const files = (map: Record<string, string>) => (path: string) => map[path];
7
+
8
+ describe("tokenVariable", () => {
9
+ it("writes dots as _ and dashes as __, lower case", () => {
10
+ expect(tokenVariable("app.terraform.io")).toBe("TF_TOKEN_app_terraform_io");
11
+ expect(tokenVariable("My-Registry.Example.com")).toBe("TF_TOKEN_my__registry_example_com");
12
+ });
13
+
14
+ it("uses punycode for an internationalised host", () => {
15
+ expect(tokenVariable("bücher.example")).toBe("TF_TOKEN_xn____bcher__kva_example");
16
+ });
17
+
18
+ it("drops port 443 and has no variable for another port", () => {
19
+ expect(credentialsHost("registry.example.com:443")).toBe("registry.example.com");
20
+ expect(tokenVariable("127.0.0.1:8443")).toBeUndefined();
21
+ expect(credentialsHost("https://Registry.Example.com/v1/modules/")).toBe("registry.example.com");
22
+ });
23
+ });
24
+
25
+ describe("terraformCredential", () => {
26
+ const home = "/home/u";
27
+ const tfrc = "/home/u/.terraform.d/credentials.tfrc.json";
28
+
29
+ it("reads TF_TOKEN_<host>", () => {
30
+ expect(terraformCredential("app.terraform.io", { env: { TF_TOKEN_app_terraform_io: "t1" }, readFile: files({}) })).toEqual({ token: "t1", from: "TF_TOKEN_app_terraform_io" });
31
+ });
32
+
33
+ it("matches a variable whose name decodes to the host in another case", () => {
34
+ expect(terraformToken("app.terraform.io", { env: { TF_TOKEN_App_Terraform_Io: "t2" }, readFile: files({}) })).toBe("t2");
35
+ });
36
+
37
+ it("reads credentials.tfrc.json under HOME", () => {
38
+ const c = terraformCredential("registry.example.com", { env: { HOME: home }, platform: "linux", readFile: files({ [tfrc]: JSON.stringify({ credentials: { "registry.example.com": { token: "f1" } } }) }) });
39
+ expect(c).toEqual({ token: "f1", from: tfrc });
40
+ });
41
+
42
+ it("reads a host with a port from the file only", () => {
43
+ const readFile = files({ [tfrc]: JSON.stringify({ credentials: { "127.0.0.1:8443": { token: "p1" } } }) });
44
+ expect(terraformToken("127.0.0.1:8443", { env: { HOME: home }, platform: "linux", readFile })).toBe("p1");
45
+ });
46
+
47
+ it("reads a credentials block from the HCL file TF_CLI_CONFIG_FILE names", () => {
48
+ const cli = "/etc/tf/cli.tfrc";
49
+ const text = `# comment\nplugin_cache_dir = "/tmp"\ncredentials "registry.example.com" {\n token = "h1"\n}\n`;
50
+ expect(terraformCredential("registry.example.com", { env: { TF_CLI_CONFIG_FILE: cli }, readFile: files({ [cli]: text }) })).toEqual({ token: "h1", from: cli });
51
+ });
52
+
53
+ it("lets the variable win over both files", () => {
54
+ const cli = "/etc/tf/cli.tfrc";
55
+ const readFile = files({
56
+ [cli]: `credentials "registry.example.com" { token = "h1" }`,
57
+ [tfrc]: JSON.stringify({ credentials: { "registry.example.com": { token: "f1" } } }),
58
+ });
59
+ expect(terraformToken("registry.example.com", { env: { HOME: home, TF_CLI_CONFIG_FILE: cli, TF_TOKEN_registry_example_com: "e1" }, platform: "linux", readFile })).toBe("e1");
60
+ expect(terraformToken("registry.example.com", { env: { HOME: home, TF_CLI_CONFIG_FILE: cli }, platform: "linux", readFile })).toBe("h1");
61
+ });
62
+
63
+ it("finds nothing without a variable, a home or a config file", () => {
64
+ expect(terraformCredential("registry.example.com", { env: {}, readFile: files({}) })).toBeUndefined();
65
+ expect(credentialsFilePath({ env: {}, platform: "linux" })).toBeUndefined();
66
+ expect(credentialsFilePath({ env: { APPDATA: "C:\\Users\\u\\AppData\\Roaming" }, platform: "win32" })).toContain("terraform.d");
67
+ });
68
+
69
+ it("skips a file that is neither JSON nor holds a block for the host", () => {
70
+ expect(terraformToken("registry.example.com", { env: { HOME: home }, platform: "linux", readFile: files({ [tfrc]: "{not json" }) })).toBeUndefined();
71
+ });
72
+
73
+ it("builds the Authorization header, or none", () => {
74
+ expect(authorizationFor("app.terraform.io", { env: { TF_TOKEN_app_terraform_io: "t1" }, readFile: files({}) })).toEqual({ Authorization: "Bearer t1" });
75
+ expect(authorizationFor("app.terraform.io", { env: {}, readFile: files({}) })).toEqual({});
76
+ });
77
+ });