@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
@@ -26,10 +26,35 @@
26
26
  * plans as `undefined`. Cross-component wiring (`stackOutput()`,
27
27
  * `@<component>.publish.*`) resolves.
28
28
  */
29
+ import { resolvePlannedLock } from "../lifecycle/lock-rows.js";
29
30
  import { assertTargetsAccepted, resolveStepInput, unresolvedWiringSources } from "./driver.js";
30
31
  import { componentPlanDigest } from "./gate-plan.js";
31
32
  import { componentDeployInputs } from "./deploy-inputs.js";
32
33
  import { computePlanDigest } from "../lifecycle/plan-digest.js";
34
+ const findingList = (v) => Array.isArray(v) ? v.filter((f) => typeof f?.rule === "string" && typeof f?.message === "string").map((f) => ({ rule: f.rule, message: f.message })) : [];
35
+ /**
36
+ * The findings a capability's plan or its policy error carries (#4550), in
37
+ * the gate-policy shape (`{ denials, holds, warnings }`) that chant#4541's
38
+ * `pulumi-up` puts on its artifact as `policy` and on a
39
+ * `PulumiPolicyDeniedError` as `findings`. Undefined when there are none.
40
+ */
41
+ export function capabilityPolicyOf(member, findings, denied) {
42
+ if (findings === null || typeof findings !== "object")
43
+ return denied ? { member, denied, denials: [], holds: [], warnings: [] } : undefined;
44
+ const f = findings;
45
+ const out = {
46
+ member,
47
+ denied,
48
+ denials: findingList(f.denials),
49
+ holds: findingList(f.holds),
50
+ warnings: Array.isArray(f.warnings) ? f.warnings.filter((w) => typeof w === "string") : [],
51
+ };
52
+ return denied || out.denials.length + out.holds.length + out.warnings.length > 0 ? out : undefined;
53
+ }
54
+ /** Whether `err` is a capability's policy denial (#4550): the `policyDenied: true` mark, as `planMoved` marks a moved plan. */
55
+ export function isPolicyDeniedError(err) {
56
+ return typeof err === "object" && err !== null && err.policyDenied === true;
57
+ }
33
58
  /** A part with no entries, for a member whose planner describes no changes. `unbound` steps become its holes (#4155). */
34
59
  function emptyPart(member, unbound = []) {
35
60
  const holes = unbound.map((u) => ({ address: `${u.phase}/${u.kind}`, type: u.kind, reason: `unbound: ${u.reason}` }));
@@ -74,6 +99,9 @@ export async function planWaveComponent(component, registry, ctx, componentOutpu
74
99
  const parts = [];
75
100
  let outputs;
76
101
  const shapes = {};
102
+ const policy = [];
103
+ const locks = {};
104
+ const locations = {};
77
105
  assertTargetsAccepted(component, registry, ctx);
78
106
  for (const step of capabilitySteps(component.deploy)) {
79
107
  const capability = registry.resolve(step.kind);
@@ -87,10 +115,19 @@ export async function planWaveComponent(component, registry, ctx, componentOutpu
87
115
  parts.push(planned.changeSet ?? emptyPart(member));
88
116
  if (planned.artifact !== undefined)
89
117
  plans[planned.member] = planned.artifact;
118
+ // #4550: advisory findings the plan carried (pulumi-up's CrossGuard), for the note.
119
+ const found = capabilityPolicyOf(planned.member, planned.artifact?.policy, false);
120
+ if (found)
121
+ policy.push(found);
90
122
  if (planned.shape)
91
123
  shapes[planned.member] = { ...planned.shape, member: planned.member };
92
124
  if (planned.outputs)
93
125
  outputs = mergePlannedOutputs(outputs, planned.outputs);
126
+ // #4609: where the member's copy lives in a pull request's environment (a review stack).
127
+ if (typeof planned.location === "string" && planned.location !== "")
128
+ locations[planned.member] = planned.location;
129
+ // #4552: the member's grain (declared at base, else its lexicon's) and, on the resource grain, its rows.
130
+ locks[planned.member] = await resolvePlannedLock(capability, input, planned, ctx.lockGrain);
94
131
  }
95
132
  // #4155: the steps without a plan, which no member above covers.
96
133
  const planless = (step) => !registry.has(step.kind) || registry.resolve(step.kind).plan === undefined;
@@ -120,10 +157,25 @@ export async function planWaveComponent(component, registry, ctx, componentOutpu
120
157
  parts.push(emptyPart(member, read.unbound));
121
158
  }
122
159
  }
123
- return { component: component.name, members, plans, parts, ...(outputs ? { outputs } : {}), ...(Object.keys(shapes).length > 0 ? { shapes } : {}) };
160
+ return {
161
+ component: component.name,
162
+ members,
163
+ plans,
164
+ parts,
165
+ ...(outputs ? { outputs } : {}),
166
+ ...(Object.keys(shapes).length > 0 ? { shapes } : {}),
167
+ ...(policy.length > 0 ? { policy } : {}),
168
+ ...(Object.keys(locks).length > 0 ? { locks } : {}),
169
+ ...(Object.keys(locations).length > 0 ? { locations } : {}),
170
+ };
124
171
  }
125
172
  catch (err) {
126
- return { component: component.name, error: err instanceof Error ? err.message : String(err) };
173
+ const message = err instanceof Error ? err.message : String(err);
174
+ if (isPolicyDeniedError(err)) {
175
+ const denied = capabilityPolicyOf(typeof err.member === "string" ? err.member : component.name, err.findings, true);
176
+ return { component: component.name, error: message, policy: [denied] };
177
+ }
178
+ return { component: component.name, error: message };
127
179
  }
128
180
  }
129
181
  /**
@@ -0,0 +1,89 @@
1
+ /**
2
+ * The apply outcome a member's dispatch carries, and the control repo's
3
+ * record of it (#4617).
4
+ *
5
+ * A member that applies through op waves tells the control repo once the
6
+ * last wave ran, whatever the waves did: the dispatch carries the outcome
7
+ * the wave jobs' outcome files add up to ({@link applyOutcomeOf}). The
8
+ * control repo's pipeline appends one `control-applied` line per dispatch to
9
+ * `_control/applied.jsonl` on its `chant/lifecycle`, beside the entries
10
+ * (./records.ts), and runs the member's dependents only when something
11
+ * applied. A pull request note reads the newest apply of each member from
12
+ * there to mark a cross-stack edge stale or current (./edges.ts).
13
+ *
14
+ * This module imports `node:crypto` and the outcome rule alone; the git
15
+ * port loads on first use, so a product bundle can carry it.
16
+ */
17
+ import { type WaveMemberOutcome } from "../wave-blocked.js";
18
+ import { type ControlLedgerPort } from "./records.js";
19
+ import { CONTROL_APPLY_OUTCOMES, CONTROL_OUTCOME_VAR, CONTROL_RUNS_DEPENDENTS, type ControlApplyOutcome } from "./dispatch.js";
20
+ export { CONTROL_APPLY_OUTCOMES, CONTROL_OUTCOME_VAR, CONTROL_RUNS_DEPENDENTS, type ControlApplyOutcome };
21
+ /** The outcome, and the counts behind it. */
22
+ export interface ApplyOutcomeSummary {
23
+ outcome: ControlApplyOutcome;
24
+ /** The runs that applied, sorted. */
25
+ applied: string[];
26
+ /** Each status with how many runs ended in it. */
27
+ counts: Record<string, number>;
28
+ }
29
+ /** The outcome of a set of runs, from each one's newest outcome (`earlierWaveOutcomes` over every wave). */
30
+ export declare function applyOutcomeOf(members: ReadonlyMap<string, WaveMemberOutcome>): ApplyOutcomeSummary;
31
+ /** The file the apply records are kept in, beside the entries. */
32
+ export declare const CONTROL_APPLIED_FILE = "applied.jsonl";
33
+ export declare const CONTROL_APPLIED_KIND = "control-applied";
34
+ /** One line of `_control/applied.jsonl`: one dispatch the control repo took. */
35
+ export interface ControlAppliedRecord {
36
+ version: 1;
37
+ kind: typeof CONTROL_APPLIED_KIND;
38
+ /** The member's name in the control repo's workspace. */
39
+ member: string;
40
+ op: string;
41
+ /** The member's commit the waves ran at. */
42
+ sha: string;
43
+ outcome: ControlApplyOutcome;
44
+ /** When the control repo took the dispatch, ISO 8601. */
45
+ at: string;
46
+ /** sha256 over the canonical JSON of every other field. */
47
+ digest: string;
48
+ }
49
+ /** The problems with one parsed line, or [] when it is a record. */
50
+ export declare function controlAppliedProblems(v: unknown): string[];
51
+ /** Every line of the file that is a record; the rest are counted as malformed. */
52
+ export declare function parseControlApplied(text: string | null | undefined): {
53
+ records: ControlAppliedRecord[];
54
+ malformed: number;
55
+ };
56
+ /** Each member's newest record whose outcome applied something ({@link CONTROL_RUNS_DEPENDENTS}). */
57
+ export declare function latestControlApplies(records: readonly ControlAppliedRecord[]): Map<string, ControlAppliedRecord>;
58
+ /** The control repo's `_control/applied.jsonl` on its local `chant/lifecycle`, under the member prefix of `cwd`. */
59
+ export declare function gitControlAppliedLedger(opts?: {
60
+ cwd?: string;
61
+ }): ControlLedgerPort;
62
+ /** Appends one record of a dispatch the control repo took. Does not push. */
63
+ export declare function recordControlApplied(port: ControlLedgerPort, d: {
64
+ member: string;
65
+ op: string;
66
+ sha: string;
67
+ outcome: ControlApplyOutcome;
68
+ }, opts?: {
69
+ now?: () => Date;
70
+ }): Promise<{
71
+ record: ControlAppliedRecord;
72
+ commit: string;
73
+ }>;
74
+ /**
75
+ * The control repo's step's call (`controlDependentsScript`): records the
76
+ * dispatch the environment carries and pushes `chant/lifecycle`. Returns
77
+ * what it wrote, or why it wrote nothing. A push that fails is a warning:
78
+ * the dependents still run.
79
+ */
80
+ export declare function recordControlAppliedFromEnv(opts?: {
81
+ cwd?: string;
82
+ env?: Record<string, string | undefined>;
83
+ now?: () => Date;
84
+ }): Promise<{
85
+ recorded?: ControlAppliedRecord;
86
+ skipped?: string;
87
+ pushWarning?: string;
88
+ }>;
89
+ //# sourceMappingURL=applied.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"applied.d.ts","sourceRoot":"","sources":["../../src/control/applied.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAE5H,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,KAAK,mBAAmB,EAAE,CAAC;AAE1G,6CAA6C;AAC7C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,qCAAqC;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,4GAA4G;AAC5G,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,GAAG,mBAAmB,CAmBnG;AAED,kEAAkE;AAClE,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AACpD,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAEtD,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,CAAC,CAAC;IACX,IAAI,EAAE,OAAO,oBAAoB,CAAC;IAClC,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,mBAAmB,CAAC;IAC7B,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAUD,oEAAoE;AACpE,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAiB3D;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG;IAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAgB3H;AAED,qGAAqG;AACrG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAQhH;AAED,oHAAoH;AACpH,wBAAgB,uBAAuB,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,iBAAiB,CAWtF;AAED,6EAA6E;AAC7E,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,iBAAiB,EACvB,CAAC,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,EAC5E,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CAAO,GAC9B,OAAO,CAAC;IAAE,MAAM,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAe3D;AAED;;;;;GAKG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CAAO,GACtF,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAatF"}
@@ -0,0 +1,175 @@
1
+ /**
2
+ * The apply outcome a member's dispatch carries, and the control repo's
3
+ * record of it (#4617).
4
+ *
5
+ * A member that applies through op waves tells the control repo once the
6
+ * last wave ran, whatever the waves did: the dispatch carries the outcome
7
+ * the wave jobs' outcome files add up to ({@link applyOutcomeOf}). The
8
+ * control repo's pipeline appends one `control-applied` line per dispatch to
9
+ * `_control/applied.jsonl` on its `chant/lifecycle`, beside the entries
10
+ * (./records.ts), and runs the member's dependents only when something
11
+ * applied. A pull request note reads the newest apply of each member from
12
+ * there to mark a cross-stack edge stale or current (./edges.ts).
13
+ *
14
+ * This module imports `node:crypto` and the outcome rule alone; the git
15
+ * port loads on first use, so a product bundle can carry it.
16
+ */
17
+ import { createHash } from "node:crypto";
18
+ import { passesThrough } from "../wave-blocked.js";
19
+ import { CONTROL_LEDGER_DIR } from "./records.js";
20
+ import { CONTROL_APPLY_OUTCOMES, CONTROL_OUTCOME_VAR, CONTROL_RUNS_DEPENDENTS } from "./dispatch.js";
21
+ export { CONTROL_APPLY_OUTCOMES, CONTROL_OUTCOME_VAR, CONTROL_RUNS_DEPENDENTS };
22
+ /** The outcome of a set of runs, from each one's newest outcome (`earlierWaveOutcomes` over every wave). */
23
+ export function applyOutcomeOf(members) {
24
+ const counts = {};
25
+ const applied = [];
26
+ let through = 0;
27
+ let waiting = false;
28
+ for (const [name, o] of members) {
29
+ counts[o.status] = (counts[o.status] ?? 0) + 1;
30
+ if (o.status === "applied")
31
+ applied.push(name);
32
+ if (passesThrough(o))
33
+ through++;
34
+ if (o.status === "waiting" || (o.status === "blocked" && o.by !== undefined && members.get(o.by)?.status === "waiting"))
35
+ waiting = true;
36
+ }
37
+ applied.sort();
38
+ const all = members.size;
39
+ let outcome;
40
+ if (all === 0)
41
+ outcome = "failed";
42
+ else if (applied.length > 0)
43
+ outcome = through === all ? "applied" : "partial";
44
+ else if (through === all)
45
+ outcome = "unchanged";
46
+ else
47
+ outcome = waiting ? "waiting" : "failed";
48
+ return { outcome, applied, counts };
49
+ }
50
+ /** The file the apply records are kept in, beside the entries. */
51
+ export const CONTROL_APPLIED_FILE = "applied.jsonl";
52
+ export const CONTROL_APPLIED_KIND = "control-applied";
53
+ const NAME = /^[A-Za-z0-9][A-Za-z0-9._/-]{0,127}$/;
54
+ const SHA = /^[0-9a-f]{7,64}$/;
55
+ function digestOf(fields) {
56
+ const keys = Object.keys(fields).sort();
57
+ return `sha256:${createHash("sha256").update(JSON.stringify(Object.fromEntries(keys.map((k) => [k, fields[k]])))).digest("hex")}`;
58
+ }
59
+ /** The problems with one parsed line, or [] when it is a record. */
60
+ export function controlAppliedProblems(v) {
61
+ if (typeof v !== "object" || v === null || Array.isArray(v))
62
+ return ["not an object"];
63
+ const r = v;
64
+ const out = [];
65
+ if (r.version !== 1)
66
+ out.push("version must be 1");
67
+ if (r.kind !== CONTROL_APPLIED_KIND)
68
+ out.push(`kind must be ${CONTROL_APPLIED_KIND}`);
69
+ if (!(typeof r.member === "string" && NAME.test(r.member)))
70
+ out.push("member must be a member's name");
71
+ if (!(typeof r.op === "string" && NAME.test(r.op)))
72
+ out.push("op must be an Op's name");
73
+ if (!(typeof r.sha === "string" && SHA.test(r.sha)))
74
+ out.push("sha must be a commit sha");
75
+ if (!CONTROL_APPLY_OUTCOMES.includes(r.outcome))
76
+ out.push(`outcome must be one of ${CONTROL_APPLY_OUTCOMES.join(", ")}`);
77
+ if (!(typeof r.at === "string" && !Number.isNaN(Date.parse(r.at))))
78
+ out.push("at must be a time");
79
+ if (typeof r.digest !== "string")
80
+ out.push("digest is missing");
81
+ else if (out.length === 0) {
82
+ const { digest: _d, ...rest } = r;
83
+ if (digestOf(rest) !== r.digest)
84
+ out.push("digest does not match the record");
85
+ }
86
+ return out;
87
+ }
88
+ /** Every line of the file that is a record; the rest are counted as malformed. */
89
+ export function parseControlApplied(text) {
90
+ const records = [];
91
+ let malformed = 0;
92
+ for (const raw of (text ?? "").split("\n")) {
93
+ if (!raw.trim())
94
+ continue;
95
+ let v;
96
+ try {
97
+ v = JSON.parse(raw);
98
+ }
99
+ catch {
100
+ malformed++;
101
+ continue;
102
+ }
103
+ if (controlAppliedProblems(v).length > 0)
104
+ malformed++;
105
+ else
106
+ records.push(v);
107
+ }
108
+ return { records, malformed };
109
+ }
110
+ /** Each member's newest record whose outcome applied something ({@link CONTROL_RUNS_DEPENDENTS}). */
111
+ export function latestControlApplies(records) {
112
+ const out = new Map();
113
+ for (const r of records) {
114
+ if (!CONTROL_RUNS_DEPENDENTS.includes(r.outcome))
115
+ continue;
116
+ const had = out.get(r.member);
117
+ if (!had || Date.parse(had.at) <= Date.parse(r.at))
118
+ out.set(r.member, r);
119
+ }
120
+ return out;
121
+ }
122
+ /** The control repo's `_control/applied.jsonl` on its local `chant/lifecycle`, under the member prefix of `cwd`. */
123
+ export function gitControlAppliedLedger(opts = {}) {
124
+ return {
125
+ async read() {
126
+ const { readBlobFromPath } = await import("../lifecycle/git.js");
127
+ return readBlobFromPath(CONTROL_LEDGER_DIR, CONTROL_APPLIED_FILE, opts);
128
+ },
129
+ async append(line, message) {
130
+ const { appendLedgerLine } = await import("../lifecycle/git.js");
131
+ return appendLedgerLine(CONTROL_LEDGER_DIR, CONTROL_APPLIED_FILE, line, message, opts);
132
+ },
133
+ };
134
+ }
135
+ /** Appends one record of a dispatch the control repo took. Does not push. */
136
+ export async function recordControlApplied(port, d, opts = {}) {
137
+ const fields = {
138
+ version: 1,
139
+ kind: CONTROL_APPLIED_KIND,
140
+ member: d.member,
141
+ op: d.op,
142
+ sha: d.sha,
143
+ outcome: d.outcome,
144
+ at: (opts.now ?? (() => new Date()))().toISOString(),
145
+ };
146
+ const record = { ...fields, digest: digestOf(fields) };
147
+ const problems = controlAppliedProblems(record);
148
+ if (problems.length > 0)
149
+ throw new Error(`not a control apply record: ${problems.join(", ")}`);
150
+ const commit = await port.append(JSON.stringify(record), `Control: ${d.member} ${d.outcome} at ${d.sha.slice(0, 12)}`);
151
+ return { record, commit };
152
+ }
153
+ /**
154
+ * The control repo's step's call (`controlDependentsScript`): records the
155
+ * dispatch the environment carries and pushes `chant/lifecycle`. Returns
156
+ * what it wrote, or why it wrote nothing. A push that fails is a warning:
157
+ * the dependents still run.
158
+ */
159
+ export async function recordControlAppliedFromEnv(opts = {}) {
160
+ const env = opts.env ?? process.env;
161
+ const member = env.CHANT_CONTROL_MEMBER ?? "";
162
+ const op = env.CHANT_CONTROL_OP ?? "";
163
+ const sha = env.CHANT_CONTROL_SHA ?? "";
164
+ const outcome = env[CONTROL_OUTCOME_VAR] ?? "";
165
+ if (!outcome)
166
+ return { skipped: "the dispatch carries no outcome" };
167
+ if (!CONTROL_APPLY_OUTCOMES.includes(outcome))
168
+ return { skipped: `the dispatch's outcome "${outcome}" is not one chant knows` };
169
+ if (!SHA.test(sha))
170
+ return { skipped: "the dispatch names no commit sha" };
171
+ const { record } = await recordControlApplied(gitControlAppliedLedger({ cwd: opts.cwd }), { member, op, sha, outcome: outcome }, opts.now ? { now: opts.now } : {});
172
+ const { pushLifecycleReport } = await import("../lifecycle/git.js");
173
+ const pushed = await pushLifecycleReport({ ...(opts.cwd ? { cwd: opts.cwd } : {}) });
174
+ return { recorded: record, ...(pushed.pushWarning ? { pushWarning: pushed.pushWarning } : {}) };
175
+ }
@@ -0,0 +1,78 @@
1
+ /**
2
+ * Consumers joined across a control repo (#4600, terragucci#1289 bundle B):
3
+ * each project the control repo lists keeps a `consumers.json` beside its
4
+ * catalog, naming the release versions its roots pin and where, and this
5
+ * joins them into one consumer list per version, every consumer named by
6
+ * the project it sits in. The result is the `consumers` input of
7
+ * `buildReleaseCatalog` (../lifecycle/release-catalog.ts, #4595), so the
8
+ * catalog page of a version lists its consumers in every project.
9
+ *
10
+ * `consumers.json` is the catalog's own consumer input, written per project:
11
+ *
12
+ * { "contract": 1, "consumers": [ { "component": "vpc", "version": "1.2.0", "consumers": [ { "root": "live/prod", "file": "live/prod/main.tf", "address": "module.vpc" } ] } ] }
13
+ *
14
+ * A bare array of the same entries is read too. A product's scan fills it
15
+ * (the terraform lexicon's `moduleConsumers`, #4599, for terragucci) and the
16
+ * product decides where it is kept. Where it is read from is the product's
17
+ * too: {@link readControlConsumers} takes the control repo's entries and a
18
+ * reader for one project's file, so it reads neither git nor the network
19
+ * itself. Core carries no engine word.
20
+ */
21
+ import type { CatalogConsumersInput } from "../lifecycle/release-catalog.js";
22
+ import type { ControlEntry } from "./records.js";
23
+ /** The file each project keeps its consumers in. */
24
+ export declare const CONSUMERS_FILE = "consumers.json";
25
+ /** The contract version of {@link ConsumersDocument}. */
26
+ export declare const CONSUMERS_CONTRACT = 1;
27
+ /** One project's `consumers.json`. */
28
+ export interface ConsumersDocument {
29
+ contract: typeof CONSUMERS_CONTRACT;
30
+ consumers: CatalogConsumersInput[];
31
+ }
32
+ /** One project's consumers as the join is given them. */
33
+ export interface ProjectConsumers {
34
+ /** The project's key, `<host>/<owner>/<name>`, as the control repo's entry names it. */
35
+ project: string;
36
+ /** Its `consumers.json`: the text, or the parsed document. */
37
+ document: string | unknown;
38
+ }
39
+ /** What a join gives: one entry per version, and each project file it could not read. */
40
+ export interface JoinedConsumers {
41
+ consumers: CatalogConsumersInput[];
42
+ /** One line per problem, each naming the project. */
43
+ problems: string[];
44
+ }
45
+ /**
46
+ * A `consumers.json` read and checked: its entries, or the problems with it.
47
+ * Each entry names a component and a version or digest, and each consumer a root.
48
+ */
49
+ export declare function parseConsumersDocument(document: string | unknown): {
50
+ consumers: CatalogConsumersInput[];
51
+ problems: string[];
52
+ };
53
+ /** A `consumers.json` for one project's consumers, as a product writes it. Entries and consumers are sorted, so a rerun writes the same bytes. */
54
+ export declare function consumersDocument(consumers: readonly CatalogConsumersInput[]): string;
55
+ /**
56
+ * One consumer list per version across the projects: every project's
57
+ * entries for the same component and version (or, with no version, the same
58
+ * digest) merged into one, each consumer's `repo` set to the project it sits
59
+ * in unless the file named one, duplicates dropped, sorted by version then
60
+ * consumer. A project whose file has problems adds what it could read and
61
+ * names each problem.
62
+ */
63
+ export declare function joinControlConsumers(projects: readonly ProjectConsumers[]): JoinedConsumers;
64
+ /** Reads one project's `consumers.json`: its text, or null when the project keeps none. */
65
+ export type ProjectConsumersReader = (project: string, entry: ControlEntry) => Promise<string | null>;
66
+ /** What {@link readControlConsumers} gives: the join, and the projects that keep no file. */
67
+ export interface ControlConsumers extends JoinedConsumers {
68
+ /** Projects the control repo lists whose reader found no `consumers.json`. */
69
+ missing: string[];
70
+ }
71
+ /**
72
+ * The consumers of every project the control repo lists, joined. `entries`
73
+ * are the control repo's current entries (`readControlEntries`, ./records.ts);
74
+ * the defaults entry is passed over. A reader that throws for a project
75
+ * names it in `problems` and the join goes on with the rest.
76
+ */
77
+ export declare function readControlConsumers(entries: readonly ControlEntry[], read: ProjectConsumersReader): Promise<ControlConsumers>;
78
+ //# sourceMappingURL=consumers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"consumers.d.ts","sourceRoot":"","sources":["../../src/control/consumers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAmB,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,oDAAoD;AACpD,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,kBAAkB,CAAC;IACpC,SAAS,EAAE,qBAAqB,EAAE,CAAC;CACpC;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,OAAO,EAAE,MAAM,CAAC;IAChB,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,yFAAyF;AACzF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,qBAAqB,EAAE,CAAC;IACnC,qDAAqD;IACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAcD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG;IAAE,SAAS,EAAE,qBAAqB,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAoC7H;AAED,kJAAkJ;AAClJ,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,GAAG,MAAM,CAQrF;AAMD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,GAAG,eAAe,CA8B3F;AAED,2FAA2F;AAC3F,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAEtG,6FAA6F;AAC7F,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,8EAA8E;IAC9E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBpI"}
@@ -0,0 +1,172 @@
1
+ /**
2
+ * Consumers joined across a control repo (#4600, terragucci#1289 bundle B):
3
+ * each project the control repo lists keeps a `consumers.json` beside its
4
+ * catalog, naming the release versions its roots pin and where, and this
5
+ * joins them into one consumer list per version, every consumer named by
6
+ * the project it sits in. The result is the `consumers` input of
7
+ * `buildReleaseCatalog` (../lifecycle/release-catalog.ts, #4595), so the
8
+ * catalog page of a version lists its consumers in every project.
9
+ *
10
+ * `consumers.json` is the catalog's own consumer input, written per project:
11
+ *
12
+ * { "contract": 1, "consumers": [ { "component": "vpc", "version": "1.2.0", "consumers": [ { "root": "live/prod", "file": "live/prod/main.tf", "address": "module.vpc" } ] } ] }
13
+ *
14
+ * A bare array of the same entries is read too. A product's scan fills it
15
+ * (the terraform lexicon's `moduleConsumers`, #4599, for terragucci) and the
16
+ * product decides where it is kept. Where it is read from is the product's
17
+ * too: {@link readControlConsumers} takes the control repo's entries and a
18
+ * reader for one project's file, so it reads neither git nor the network
19
+ * itself. Core carries no engine word.
20
+ */
21
+ /** The file each project keeps its consumers in. */
22
+ export const CONSUMERS_FILE = "consumers.json";
23
+ /** The contract version of {@link ConsumersDocument}. */
24
+ export const CONSUMERS_CONTRACT = 1;
25
+ const isObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
26
+ const optionalString = (v) => v === undefined || typeof v === "string";
27
+ /** The problems with one consumer, or []. */
28
+ function consumerProblems(c, at) {
29
+ if (!isObject(c))
30
+ return [`${at}: not an object`];
31
+ const out = [];
32
+ if (typeof c.root !== "string" || c.root === "")
33
+ out.push(`${at}.root: a non-empty string`);
34
+ for (const k of ["repo", "file", "address"])
35
+ if (!optionalString(c[k]))
36
+ out.push(`${at}.${k}: a string when set`);
37
+ return out;
38
+ }
39
+ /**
40
+ * A `consumers.json` read and checked: its entries, or the problems with it.
41
+ * Each entry names a component and a version or digest, and each consumer a root.
42
+ */
43
+ export function parseConsumersDocument(document) {
44
+ let doc = document;
45
+ if (typeof document === "string") {
46
+ try {
47
+ doc = JSON.parse(document);
48
+ }
49
+ catch (e) {
50
+ return { consumers: [], problems: [`not JSON: ${e.message}`] };
51
+ }
52
+ }
53
+ let list;
54
+ if (Array.isArray(doc))
55
+ list = doc;
56
+ else if (isObject(doc)) {
57
+ if (doc.contract !== CONSUMERS_CONTRACT)
58
+ return { consumers: [], problems: [`contract ${JSON.stringify(doc.contract)}: this chant reads contract ${CONSUMERS_CONTRACT}`] };
59
+ list = doc.consumers;
60
+ }
61
+ if (!Array.isArray(list))
62
+ return { consumers: [], problems: ["no consumers list"] };
63
+ const consumers = [];
64
+ const problems = [];
65
+ list.forEach((e, i) => {
66
+ const at = `consumers[${i}]`;
67
+ if (!isObject(e))
68
+ return void problems.push(`${at}: not an object`);
69
+ const own = [];
70
+ if (typeof e.component !== "string" || e.component === "")
71
+ own.push(`${at}.component: a non-empty string`);
72
+ if (!optionalString(e.version) || !optionalString(e.digest))
73
+ own.push(`${at}: version and digest are strings when set`);
74
+ if (e.version === undefined && e.digest === undefined)
75
+ own.push(`${at}: names neither a version nor a digest`);
76
+ if (!Array.isArray(e.consumers))
77
+ own.push(`${at}.consumers: a list`);
78
+ else
79
+ e.consumers.forEach((c, j) => own.push(...consumerProblems(c, `${at}.consumers[${j}]`)));
80
+ if (own.length > 0)
81
+ return void problems.push(...own);
82
+ consumers.push({
83
+ component: e.component,
84
+ ...(e.version !== undefined ? { version: e.version } : {}),
85
+ ...(e.digest !== undefined ? { digest: e.digest } : {}),
86
+ consumers: e.consumers.map((c) => ({ ...c })),
87
+ });
88
+ });
89
+ return { consumers, problems };
90
+ }
91
+ /** A `consumers.json` for one project's consumers, as a product writes it. Entries and consumers are sorted, so a rerun writes the same bytes. */
92
+ export function consumersDocument(consumers) {
93
+ const doc = {
94
+ contract: CONSUMERS_CONTRACT,
95
+ consumers: [...consumers]
96
+ .map((c) => ({ ...c, consumers: [...c.consumers].sort((a, b) => consumerKey(a).localeCompare(consumerKey(b))) }))
97
+ .sort((a, b) => versionKey(a).localeCompare(versionKey(b))),
98
+ };
99
+ return `${JSON.stringify(doc, null, 2)}\n`;
100
+ }
101
+ const consumerKey = (c) => [c.repo ?? "", c.root, c.file ?? "", c.address ?? ""].join("\u0000");
102
+ /** One version: its component and version, else its digest. */
103
+ const versionKey = (c) => `${c.component}\u0000${c.version !== undefined ? `v:${c.version}` : `d:${c.digest}`}`;
104
+ /**
105
+ * One consumer list per version across the projects: every project's
106
+ * entries for the same component and version (or, with no version, the same
107
+ * digest) merged into one, each consumer's `repo` set to the project it sits
108
+ * in unless the file named one, duplicates dropped, sorted by version then
109
+ * consumer. A project whose file has problems adds what it could read and
110
+ * names each problem.
111
+ */
112
+ export function joinControlConsumers(projects) {
113
+ const byVersion = new Map();
114
+ const problems = [];
115
+ for (const p of [...projects].sort((a, b) => a.project.localeCompare(b.project))) {
116
+ const read = parseConsumersDocument(p.document);
117
+ for (const problem of read.problems)
118
+ problems.push(`${p.project}: ${CONSUMERS_FILE}: ${problem}`);
119
+ for (const entry of read.consumers) {
120
+ const key = versionKey(entry);
121
+ let at = byVersion.get(key);
122
+ if (!at) {
123
+ at = {
124
+ input: { component: entry.component, ...(entry.version !== undefined ? { version: entry.version } : {}), ...(entry.digest !== undefined ? { digest: entry.digest } : {}), consumers: [] },
125
+ seen: new Set(),
126
+ };
127
+ byVersion.set(key, at);
128
+ }
129
+ if (at.input.digest === undefined && entry.digest !== undefined)
130
+ at.input.digest = entry.digest;
131
+ for (const c of entry.consumers) {
132
+ const named = { ...c, repo: c.repo ?? p.project };
133
+ const k = consumerKey(named);
134
+ if (at.seen.has(k))
135
+ continue;
136
+ at.seen.add(k);
137
+ at.input.consumers.push(named);
138
+ }
139
+ }
140
+ }
141
+ const consumers = [...byVersion.entries()]
142
+ .sort(([a], [b]) => a.localeCompare(b))
143
+ .map(([, v]) => ({ ...v.input, consumers: v.input.consumers.sort((a, b) => consumerKey(a).localeCompare(consumerKey(b))) }));
144
+ return { consumers, problems };
145
+ }
146
+ /**
147
+ * The consumers of every project the control repo lists, joined. `entries`
148
+ * are the control repo's current entries (`readControlEntries`, ./records.ts);
149
+ * the defaults entry is passed over. A reader that throws for a project
150
+ * names it in `problems` and the join goes on with the rest.
151
+ */
152
+ export async function readControlConsumers(entries, read) {
153
+ const projects = [];
154
+ const missing = [];
155
+ const problems = [];
156
+ for (const e of [...entries].filter((x) => x.entry === "project" && x.project).sort((a, b) => a.project.localeCompare(b.project))) {
157
+ let text;
158
+ try {
159
+ text = await read(e.project, e);
160
+ }
161
+ catch (err) {
162
+ problems.push(`${e.project}: ${CONSUMERS_FILE} could not be read: ${err.message}`);
163
+ continue;
164
+ }
165
+ if (text === null)
166
+ missing.push(e.project);
167
+ else
168
+ projects.push({ project: e.project, document: text });
169
+ }
170
+ const joined = joinControlConsumers(projects);
171
+ return { consumers: joined.consumers, problems: [...problems, ...joined.problems], missing };
172
+ }