@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
@@ -0,0 +1,174 @@
1
+ /**
2
+ * `@intentius/chant/ci-product` (#4550): what a CI product built on chant's
3
+ * pull request pipeline imports. terragucci and plywood pass their words
4
+ * here and get the same jobs, the same note and the same statuses, in their
5
+ * own words.
6
+ *
7
+ * A product feature-detects this entry until the chant release that carries
8
+ * {@link CI_PRODUCT_FLOOR} is its floor: `productPipelineJobs`, `approveLine`
9
+ * and `assertProductWords` present means the rest is too.
10
+ */
11
+
12
+ import { NEXT_RELEASE } from "./release-floors";
13
+ import type { CiProductWords, CiProductWordsInput } from "./ci-product-words";
14
+ import type { ProductMcpHook } from "./cli/mcp/product-tools";
15
+ import type { ProductWaveHook } from "./op/op-waves-after-plan";
16
+ import { OTLP_EXPORTER_FLOOR } from "./otlp";
17
+
18
+ /**
19
+ * The first chant with the product pipeline (#4550): the words, the
20
+ * `pull-request` op-wave approval source, `runCommandInProcess(argv, {
21
+ * words })`, the lexicons' `ciSetup`, and the member detail sections of the
22
+ * note (#4573).
23
+ */
24
+ export const CI_PRODUCT_FLOOR = NEXT_RELEASE;
25
+
26
+ export {
27
+ activeProductWords,
28
+ approveLine,
29
+ assertProductWords,
30
+ CHANT_APPROVE_TEMPLATE,
31
+ CHANT_NOTIFY_WAVE_TEMPLATE,
32
+ CHANT_OVERRIDE_TEMPLATE,
33
+ CHANT_WORDS,
34
+ CI_PRODUCT_APPLY_MODES,
35
+ CI_PRODUCT_COMMANDS,
36
+ CI_PRODUCT_STAGES,
37
+ CiProductWordsError,
38
+ commandWord,
39
+ commentLine,
40
+ isChantWords,
41
+ notifyWaveLabel,
42
+ overrideLine,
43
+ parseProductComment,
44
+ productContext,
45
+ productStatusContext,
46
+ productWaveGate,
47
+ productWordsProblems,
48
+ resolveProductWords,
49
+ setActiveProductWords,
50
+ withProductWords,
51
+ type ApproveLineInput,
52
+ type CiProductAlias,
53
+ type CiProductApplyMode,
54
+ type CiProductApproval,
55
+ type CiProductCommand,
56
+ type CiProductNotifyWords,
57
+ type CiProductNotifyWordsInput,
58
+ type CiProductStage,
59
+ type CiProductWords,
60
+ type CiProductWordsInput,
61
+ type OverrideLineInput,
62
+ type ParsedProductComment,
63
+ } from "./ci-product-words";
64
+ export { driftNotifyFields, productNotifySource, productNotifyWords, productSendOptions, type DriftNotifyInput } from "./notify-product";
65
+
66
+ /** The first chant with `chant notify relay` and the notify relay buttons (#4611). */
67
+ export const NOTIFY_RELAY_FLOOR = NEXT_RELEASE;
68
+
69
+ /**
70
+ * The first chant whose product pipeline has the comment preview
71
+ * (`previewComment`, `build --pr-loop --preview-comment`) and whose
72
+ * `components pr-plan` takes `--target` (#4620). A product feature-detects
73
+ * `prCommentPreviewJob` and this constant together.
74
+ */
75
+ export const PR_PREVIEW_FLOOR = NEXT_RELEASE;
76
+ export {
77
+ decideRelayClick,
78
+ handleRelayRequest,
79
+ relayPrincipalFor,
80
+ RELAY_ENV,
81
+ slackRelayClick,
82
+ slackSignature,
83
+ startRelayServer,
84
+ teamsRelayClick,
85
+ teamsSignature,
86
+ verifySlackRequest,
87
+ verifyTeamsRequest,
88
+ type RelayAnswer,
89
+ type RelayClick,
90
+ type RelayDeps,
91
+ type RelayPending,
92
+ type RelayRequest,
93
+ type RelayResponse,
94
+ type RelaySettings,
95
+ } from "./notify-relay";
96
+ export {
97
+ componentWaveOutputsFile,
98
+ componentWaveSteps,
99
+ componentWavesSpec,
100
+ productAgentSpec,
101
+ productCommand,
102
+ productDriftAgent,
103
+ productPipelineJobs,
104
+ productWavesSpec,
105
+ productWavesSpecFile,
106
+ PRODUCT_WAVES_SPEC_DIR,
107
+ type ComponentWaveStepOptions,
108
+ type ComponentWaveSteps,
109
+ type ComponentWavesSpecOptions,
110
+ type ProductAgentOptions,
111
+ type ProductPipelineJobs,
112
+ type ProductPipelineOptions,
113
+ } from "./components/product-pipeline";
114
+ export { prApplyComment, prCommentLockJobs, prCommentPreviewJob, prLoopSetup, engineSetupLines, withProductBin, type PrCommentLockJob, type PrCommentPreviewJob } from "./components/pr-pipeline";
115
+ export { CI_SERVICES_FLOOR, engineServices, githubServices, gitlabServices, serviceWaitLine, servicesJobEnv, type CiService } from "./components/ci-services";
116
+ export { renderPrNote, prStatusContext, prApproveCommand, prApproveCommands, prApproveTargets, prMergeSentence, type PrMemberDetail } from "./pr-loop";
117
+ export { upsertPlanNote } from "./pr-post";
118
+
119
+ /**
120
+ * Run one chant command line in this process with the product's words
121
+ * (ruling C): what a product's bin calls for every command its verbs map
122
+ * onto, and for the `chant ...` lines the generated jobs run through it. The
123
+ * CLI loads on the first call, so importing this entry stays light.
124
+ */
125
+ export async function runChantInProcess(argv: string[], words: CiProductWordsInput | CiProductWords, options: { mcp?: ProductMcpHook; wave?: ProductWaveHook } = {}): Promise<number> {
126
+ const { runCommandInProcess } = await import("./cli/main");
127
+ return runCommandInProcess(argv, { words, ...(options.mcp ? { mcp: options.mcp } : {}), ...(options.wave ? { wave: options.wave } : {}) });
128
+ }
129
+
130
+ /**
131
+ * The agent job (#4616): `productPipelineJobs(forge, env, { words, agent })`
132
+ * returns the agent's Op spec, and `productDriftAgent` the `agent` of a
133
+ * scheduled drift Op; `chant run --generate` writes both. Feature-detect on
134
+ * `CI_AGENT_FLOOR`.
135
+ */
136
+ export { CI_AGENT_FLOOR, agentForbiddenPaths, type AgentSettings, type OpAgentSpec } from "./ci-agent";
137
+
138
+ /**
139
+ * After-plan hooks in a wave job's process (#4614): `runChantInProcess(["run",
140
+ * "wave", ...], words, { wave: { afterPlan, capabilities } })`, or
141
+ * `runOpWave({ afterPlan })` from `@intentius/chant/op`. Feature-detect on
142
+ * `OP_WAVE_AFTER_PLAN_FLOOR`.
143
+ */
144
+ export { OP_WAVE_AFTER_PLAN_FLOOR } from "./op/runtime";
145
+ export type { OpWaveAfterPlanHook, OpWaveAfterPlanResult, OpWaveAfterPlanRun, ProductWaveHook } from "./op/op-waves-after-plan";
146
+
147
+ /**
148
+ * The standing pending gates waiting on a plan digest, with the pull request
149
+ * a `pr-<n>` gate belongs to (#4607): what a product's approve verb reads so
150
+ * a person types only the digest. Feature-detect on `pendingGatesByPlan`;
151
+ * the ledger's git code loads on its first call. `parseRequiresList` checks
152
+ * a product's `apply.requires` before it becomes `pr-apply --requires`.
153
+ */
154
+ export { pendingGatesByPlan, pullRequestOfOp, standingPendingByPlan, type PendingGateByPlan, type PendingGatesByPlanOptions } from "./lifecycle/gate-pending-by-plan";
155
+ export { parseRequiresList, PR_APPLY_REQUIRES, type PrApplyRequire } from "./pr-requires";
156
+
157
+ /**
158
+ * Telemetry and MCP (#4555). A product's bin configures the exporter once
159
+ * with its prefix (`configureOtlp({ prefix })`, or leaves it to its words),
160
+ * and passes its MCP tools as `runChantInProcess(["serve", "mcp"], words, {
161
+ * mcp: hook })`. Feature-detect on `configureOtlp` and
162
+ * `PRODUCT_MCP_HOOK_FLOOR`: present means both are.
163
+ */
164
+ export const PRODUCT_MCP_HOOK_FLOOR = OTLP_EXPORTER_FLOOR;
165
+ export type { ProductMcpContext, ProductMcpHook } from "./cli/mcp/product-tools";
166
+ export {
167
+ activeOtlp,
168
+ configureOtlp,
169
+ OTLP_EXPORTER_FLOOR,
170
+ RunEventTrace,
171
+ type CapabilityTraceFacts,
172
+ type CapabilityTraceSpan,
173
+ type OtlpExporter,
174
+ } from "./otlp";
@@ -0,0 +1,145 @@
1
+ /**
2
+ * #4554: the forge reads, handover parameters and report URLs products
3
+ * share. Forge reads run against a recorded-answer fake fetch; report URLs
4
+ * against an injected store. Nothing leaves the process.
5
+ */
6
+
7
+ import { describe, expect, test } from "vitest";
8
+ import { checkoutScript, handoverTrap, HANDOVER_NOTE_FILES, packJs, takeOverScript } from "./ci-handover";
9
+ import { forgejoForge, githubForge, gitlabForge, type ForgeFetch } from "./pr-forge";
10
+ import { parseReportUrl, reportGet, reportPut } from "./pr-report-url";
11
+ import type { ObjectStore } from "./object-store/common";
12
+
13
+ /** A fetch that answers each URL (without its page parameters) from `answers`, and records the URLs asked. */
14
+ function recorded(answers: Record<string, unknown>): { fetch: ForgeFetch; asked: string[] } {
15
+ const asked: string[] = [];
16
+ const fetch: ForgeFetch = async (url) => {
17
+ asked.push(url);
18
+ const u = new URL(url);
19
+ for (const p of ["page", "per_page", "limit"]) u.searchParams.delete(p);
20
+ const key = `${u.pathname}${u.search}`;
21
+ const page = Number(new URL(url).searchParams.get("page") ?? "1");
22
+ if (!(key in answers)) return { ok: false, status: 404, text: async () => "{}" };
23
+ const body = answers[key];
24
+ return { ok: true, status: 200, text: async () => JSON.stringify(Array.isArray(body) && page > 1 ? [] : body) };
25
+ };
26
+ return { fetch, asked };
27
+ }
28
+
29
+ describe("default-branch and status reads (#4554)", () => {
30
+ test("GitHub reads the repository's default branch and each context's newest status", async () => {
31
+ const { fetch } = recorded({
32
+ "/repos/o/r": { default_branch: "trunk" },
33
+ "/repos/o/r/commits/abc/statuses": [
34
+ { id: 3, context: "chant/apply", state: "success", target_url: "https://ci/run/3" },
35
+ { id: 2, context: "chant/plan", state: "failure" },
36
+ { id: 1, context: "chant/apply", state: "pending" },
37
+ ],
38
+ });
39
+ const forge = githubForge({ apiBase: "https://api.test", repo: "o/r", token: "t", fetch });
40
+ expect(await forge.defaultBranch!()).toBe("trunk");
41
+ expect(await forge.commitStatuses!("abc")).toEqual([
42
+ { context: "chant/apply", state: "success", targetUrl: "https://ci/run/3" },
43
+ { context: "chant/plan", state: "failure" },
44
+ ]);
45
+ });
46
+
47
+ test("Forgejo reads the same endpoints, and a repository with no default branch reads as main", async () => {
48
+ const { fetch } = recorded({ "/api/v1/repos/o/r": {} });
49
+ const forge = forgejoForge({ apiBase: "https://forge.test/api/v1", repo: "o/r", host: "forge.test", fetch });
50
+ expect(await forge.defaultBranch!()).toBe("main");
51
+ });
52
+
53
+ test("GitLab keeps each name's status with the highest id", async () => {
54
+ const { fetch } = recorded({
55
+ "/api/v4/projects/g%2Fp": { default_branch: "main" },
56
+ "/api/v4/projects/g%2Fp/repository/commits/abc/statuses?all=true": [
57
+ { id: 7, name: "terragucci/plan", status: "failed", allow_failure: true },
58
+ { id: 9, name: "terragucci/plan", status: "success" },
59
+ ],
60
+ });
61
+ const forge = gitlabForge({ apiBase: "https://gitlab.test/api/v4", project: "g/p", fetch });
62
+ expect(await forge.defaultBranch!()).toBe("main");
63
+ expect(await forge.commitStatuses!("abc")).toEqual([{ context: "terragucci/plan", state: "success" }]);
64
+ });
65
+
66
+ test("GitLab filters the statuses by ref when given one, and asks for none when not (#4584)", async () => {
67
+ const { fetch, asked } = recorded({
68
+ "/api/v4/projects/g%2Fp/repository/commits/abc/statuses?all=true&ref=release%2F1": [{ id: 4, name: "terragucci/apply", status: "success" }],
69
+ "/api/v4/projects/g%2Fp/repository/commits/abc/statuses?all=true": [{ id: 5, name: "terragucci/other", status: "failed" }],
70
+ });
71
+ const forge = gitlabForge({ apiBase: "https://gitlab.test/api/v4", project: "g/p", fetch });
72
+ expect(await forge.commitStatuses!("abc", "release/1")).toEqual([{ context: "terragucci/apply", state: "success" }]);
73
+ expect(asked[0]).toContain("&ref=release%2F1");
74
+ expect(await forge.commitStatuses!("abc")).toEqual([{ context: "terragucci/other", state: "failed" }]);
75
+ expect(asked[1]).not.toContain("ref=");
76
+ });
77
+
78
+ test("GitHub and Forgejo take the ref and read the commit's statuses as before (#4584)", async () => {
79
+ const statuses = [{ id: 1, context: "chant/plan", state: "success" }];
80
+ const gh = recorded({ "/repos/o/r/commits/abc/statuses": statuses });
81
+ const github = githubForge({ apiBase: "https://api.test", repo: "o/r", token: "t", fetch: gh.fetch });
82
+ expect(await github.commitStatuses!("abc", "main")).toEqual([{ context: "chant/plan", state: "success" }]);
83
+ expect(gh.asked[0]).not.toContain("ref=");
84
+ const fj = recorded({ "/api/v1/repos/o/r/commits/abc/statuses": statuses });
85
+ const forgejo = forgejoForge({ apiBase: "https://forge.test/api/v1", repo: "o/r", host: "forge.test", fetch: fj.fetch });
86
+ expect(await forgejo.commitStatuses!("abc", "main")).toEqual([{ context: "chant/plan", state: "success" }]);
87
+ });
88
+ });
89
+
90
+ describe("the handover with a product's parameters (#4554)", () => {
91
+ test("left out, the scripts are chant's own", () => {
92
+ expect(packJs("github")).toContain(`NOTE=${JSON.stringify(HANDOVER_NOTE_FILES)}`);
93
+ expect(packJs("github")).toContain('"chant: the plan report is too large to hand to the note job whole; it hands on pr-plan.json and pr-note.md"');
94
+ expect(handoverTrap("report", "github").at(-1)).toBe("trap chant_handover EXIT");
95
+ const checkout = checkoutScript(false);
96
+ expect(checkout).toContain('"${CHANT_CHECKOUT_TOKEN:-}"');
97
+ expect(checkout).toContain('ref="$GITHUB_REF"');
98
+ expect(checkout).toContain("refs/remotes/origin/chant-head");
99
+ });
100
+
101
+ test("a product's note files, label, sweep, token, ref and head name", () => {
102
+ const files = ["plan-note.md", "plan-status.json", "report.json"];
103
+ const pack = packJs("forgejo", { noteFiles: files, label: "terragucci" });
104
+ expect(pack).toContain(`NOTE=${JSON.stringify(files)}`);
105
+ expect(pack).toContain("terragucci: the report is too large to hand to the next job whole; it hands on plan-note.md, plan-status.json, report.json");
106
+ expect(handoverTrap("report", "forgejo", { label: "terragucci", before: "tg_sweep" }).at(-1)).toBe("trap 'tg_sweep; chant_handover' EXIT");
107
+ const checkout = checkoutScript(true, false, { tokenEnv: "TG_TOKEN", refEnv: "TG_REF", headName: "terragucci-head" });
108
+ expect(checkout).toContain('"${TG_TOKEN:-}"');
109
+ expect(checkout).toContain('ref="${TG_REF:-$GITHUB_REF}"');
110
+ expect(checkout).toContain('want="${TG_REF:-$GITHUB_SHA}"');
111
+ expect(checkout).toContain("refs/remotes/origin/terragucci-head");
112
+ expect(takeOverScript("replan", "report", "github")).toContain("the replan job handed on no report");
113
+ });
114
+
115
+ test("a parameter that would break out of the script is refused", () => {
116
+ expect(() => packJs("github", { noteFiles: ['a"b'] })).toThrow();
117
+ expect(() => handoverTrap("r", "github", { before: "x; rm" })).toThrow();
118
+ expect(() => checkoutScript(false, false, { tokenEnv: "A-B" })).toThrow();
119
+ });
120
+ });
121
+
122
+ describe("gs:// and az:// report URLs (#4554)", () => {
123
+ test("they parse with their prefix", () => {
124
+ expect(parseReportUrl("gs://my-bucket/pr/")).toEqual({ scheme: "gs", url: "gs://my-bucket/pr", bucket: "my-bucket", prefix: "pr" });
125
+ expect(parseReportUrl("az://account1/reports")).toEqual({ scheme: "az", url: "az://account1/reports", account: "account1", container: "reports", prefix: "" });
126
+ expect(parseReportUrl("https://example.test/x")).toHaveProperty("error");
127
+ });
128
+
129
+ test("a put and a get go through the store under the prefix, and an absent object reads as null", async () => {
130
+ const objects = new Map<string, string>();
131
+ const store = async (): Promise<ObjectStore> => ({
132
+ location: "gs://my-bucket",
133
+ put: async (key, body) => (objects.set(key, String(body)), {}),
134
+ read: async (key) => (objects.has(key) ? { body: objects.get(key)! } : {}),
135
+ get: async (key) => objects.get(key),
136
+ presign: async () => ({ url: "", expires: new Date(0) }),
137
+ });
138
+ const target = parseReportUrl("gs://my-bucket/pr");
139
+ if ("error" in target) throw new Error(target.error);
140
+ await reportPut(target, undefined, store)("7/abc/pr-plan.json", "{}", "application/json");
141
+ expect([...objects.keys()]).toEqual(["pr/7/abc/pr-plan.json"]);
142
+ expect(await reportGet(target, undefined, store)("7/abc/pr-plan.json")).toBe("{}");
143
+ expect(await reportGet(target, undefined, store)("7/abc/none.json")).toBeNull();
144
+ });
145
+ });
@@ -291,7 +291,7 @@ describe("auditCommand", () => {
291
291
  describe("lexicon coverage (#1623)", () => {
292
292
  const MIXED = fileURLToPath(new URL("./__fixtures__/audit-coverage", import.meta.url));
293
293
 
294
- test("zero lexicons: says it had nothing to look with, names each file's lexicon, prints the npx line, exits 2", async () => {
294
+ test("zero lexicons: says it had nothing to look with, names each file's lexicon, prints the npx line, exits 1", async () => {
295
295
  const result = await auditCommand({ path: MIXED, plugins: [] });
296
296
  expect(result.success).toBe(true);
297
297
  expect(result.status).toBe("no-lexicons");
@@ -26,6 +26,7 @@ import { formatWarning } from "../format";
26
26
  import { lexiconPackagesToInstall, lexiconSourceLabel, pathLexiconMap, recordedLexiconModules } from "../../lexicon-module";
27
27
  import { readConfigFieldsStatically, readLexiconDeclarationsStatically, unknownPathLexiconsNotice } from "../../config-static";
28
28
  import { findProjectConfigPastFragments } from "../../config";
29
+ import { CHANT_EXIT } from "../../exit-codes";
29
30
 
30
31
  export type AuditFormat = "stylish" | "json" | "sarif" | "markdown" | "html";
31
32
  export type AuditTier = "merge-worthy" | "all";
@@ -122,8 +123,8 @@ export interface AuditCommandResult {
122
123
  warnings?: AuditWarning[];
123
124
  }
124
125
 
125
- /** Exit code when the audit had no lexicons to look with. Distinct from 1 (findings / failure). */
126
- export const NO_LEXICONS_EXIT_CODE = 2;
126
+ /** Exit code when the audit had no lexicons to look with: a config failure, so `failed` (#4585). */
127
+ export const NO_LEXICONS_EXIT_CODE = CHANT_EXIT.failed;
127
128
 
128
129
  /**
129
130
  * What to tell the user about lexicons that did not load: an `npm i` line for
@@ -143,7 +143,7 @@ describe("carveAdvise", () => {
143
143
  const r = await carveAdvise({ from: dir });
144
144
  const text = formatCarveReport(r);
145
145
  expect(text).toContain("CLEAN LEAF");
146
- expect(text).toContain("LEAVE IN TERRAFORM");
146
+ expect(text).toContain("STAYS IN TERRAFORM");
147
147
  expect(text).toContain("Advises only");
148
148
  expect(text).not.toMatch(/terraform state rm|apply|destroy/i);
149
149
  });
@@ -271,7 +271,7 @@ export function formatCarveReport(result: CarveAdviseResult): string {
271
271
  }
272
272
 
273
273
  lines.push(
274
- `Bands: 80-100 carve now | 50-79 carve with boundary edits | 0-49 leave in ${cdk ? "CDK" : "Terraform"}`,
274
+ `Bands: 80-100 carve now | 50-79 carve with boundary edits | 0-49 stays in ${cdk ? "CDK" : "Terraform"}`,
275
275
  );
276
276
  if (cellWidth > 0) {
277
277
  lines.push(
@@ -306,7 +306,7 @@ function bandLabel(band: PeelabilityBand, cdk: boolean): string {
306
306
  case "leave in Terraform":
307
307
  // The band's name is part of the JSON contract and does not change per
308
308
  // source; only the heading a person reads does.
309
- return cdk ? "LEAVE IN CDK" : "LEAVE IN TERRAFORM";
309
+ return cdk ? "STAYS IN CDK" : "STAYS IN TERRAFORM";
310
310
  }
311
311
  }
312
312
 
@@ -32,6 +32,8 @@ export interface InitOptions {
32
32
  force?: boolean;
33
33
  /** Skip writing the project's `.mcp.json` (`--skip-mcp`) */
34
34
  skipMcp?: boolean;
35
+ /** Register `chant serve mcp --read-only` in `.mcp.json` (`--mcp-read-only`, chant#4543) */
36
+ mcpReadOnly?: boolean;
35
37
  /** Skip interactive install prompt */
36
38
  skipInstall?: boolean;
37
39
  /**
@@ -437,7 +439,7 @@ export async function initCommand(options: InitOptions): Promise<InitResult> {
437
439
  if (!options.skipMcp) {
438
440
  writeIfNotExists(
439
441
  mcpConfigPath(targetDir),
440
- generateMcpConfig(detectPackageManager(targetDir)),
442
+ generateMcpConfig(detectPackageManager(targetDir), { readOnly: options.mcpReadOnly }),
441
443
  MCP_CONFIG_FILENAME,
442
444
  createdFiles,
443
445
  warnings,
@@ -0,0 +1,16 @@
1
+ /** The flags of the component plan-wave and apply-wave steps and of `chant lock --keep` (#4588). */
2
+
3
+ import { describe, expect, test } from "vitest";
4
+ import { parseArgs } from "./parse-args";
5
+
6
+ describe("component wave steps and comment locks (#4588)", () => {
7
+ test("plan-wave and apply-wave take the runs, plans and outputs files", () => {
8
+ const args = parseArgs(["components", "apply-wave", "--runs", "r.json", "--plans", "p.json", "--wave-outputs", "o.json", "--base", "abc", "--env", "prod"]);
9
+ expect([args.runsFile, args.plansFile, args.waveOutputs]).toEqual(["r.json", "p.json", "o.json"]);
10
+ expect(() => parseArgs(["components", "plan-wave", "--runs", "--plans", "p.json"])).toThrow(/--runs needs a file/);
11
+ });
12
+
13
+ test("chant lock --keep", () => {
14
+ expect(parseArgs(["lock", "--keep", "--pr", "7"]).keepLocks).toBe(true);
15
+ });
16
+ });
@@ -0,0 +1,126 @@
1
+ /**
2
+ * `chant agent prepare|run|land` (#4616): the three steps of the agent jobs
3
+ * the Op generator writes for a scheduled Op spec's `agent`
4
+ * (../../ci-agent.ts says what each does and which token each holds).
5
+ *
6
+ * ```
7
+ * chant agent prepare --forge <kind> [--output <dir>] the agent job, read token: decide
8
+ * chant agent run --forge <kind> [--output <dir>] the agent job, the model's key and no forge token
9
+ * chant agent land --forge <kind> [--output <dir>] the push job, write token: commit, push, pull request, record
10
+ * ```
11
+ *
12
+ * The settings come from the job's `CHANT_AGENT_*` variables, which the
13
+ * generator wrote into the workflow file of the base branch.
14
+ */
15
+
16
+ import { execFileSync } from "node:child_process";
17
+ import { readFileSync } from "node:fs";
18
+ import { tmpdir } from "node:os";
19
+ import { join, resolve } from "node:path";
20
+ import {
21
+ AGENT_DIR,
22
+ AgentError,
23
+ agentSettingsFromEnv,
24
+ landAgentChange,
25
+ prepareAgentRun,
26
+ runAgent,
27
+ runAgentCommand,
28
+ type AgentGit,
29
+ } from "../../ci-agent";
30
+ import { activeProductWords } from "../../ci-product-words";
31
+ import { CHANT_EXIT } from "../../exit-codes";
32
+ import { appendRunRecord, readRunLedger } from "../../lifecycle/run-ledger";
33
+ import { pushLifecycle } from "../../lifecycle/git";
34
+ import { resolveCiRun } from "../../lifecycle/release-ledger";
35
+ import { FORGE_KINDS, forgeFromEnv, type ForgeKind, type PrForge } from "../../pr-forge";
36
+ import { formatError, formatInfo } from "../format";
37
+ import type { CommandContext } from "../registry";
38
+
39
+ const USAGE = "chant agent prepare|run|land --forge github|gitlab|forgejo [--output <dir>]";
40
+
41
+ function fail(message: string): number {
42
+ console.error(formatError({ message, hint: USAGE }));
43
+ return CHANT_EXIT.failed;
44
+ }
45
+
46
+ /** git with hooks and fsmonitor off: nothing here runs code from the repository. */
47
+ const git: AgentGit = (args, opts = {}) =>
48
+ execFileSync("git", ["-c", "core.hooksPath=/dev/null", "-c", "core.fsmonitor=false", ...args], {
49
+ cwd: opts.cwd,
50
+ input: opts.input,
51
+ encoding: "utf8",
52
+ stdio: ["pipe", "pipe", "pipe"],
53
+ env: { ...process.env, GIT_TERMINAL_PROMPT: "0" },
54
+ maxBuffer: 64 << 20,
55
+ });
56
+
57
+ function eventOf(): unknown {
58
+ const file = process.env.GITHUB_EVENT_PATH;
59
+ if (!file) return undefined;
60
+ try {
61
+ return JSON.parse(readFileSync(file, "utf8"));
62
+ } catch {
63
+ return undefined;
64
+ }
65
+ }
66
+
67
+ function workDir(name: string): string {
68
+ return join(process.env.RUNNER_TEMP || process.env.TMPDIR || tmpdir(), name);
69
+ }
70
+
71
+ export async function runAgentCommandLine(ctx: CommandContext): Promise<number> {
72
+ const action = ctx.args.path;
73
+ if (action !== "prepare" && action !== "run" && action !== "land") return fail(action ? `agent ${action} is not one of prepare, run or land` : "agent needs an action: prepare, run or land");
74
+ const kind = ctx.args.forge;
75
+ if (!kind || !(FORGE_KINDS as readonly string[]).includes(kind)) return fail(`--forge is one of ${FORGE_KINDS.join(", ")}`);
76
+ const words = activeProductWords();
77
+ const dir = resolve(ctx.args.output ?? AGENT_DIR);
78
+ let settings;
79
+ try {
80
+ settings = agentSettingsFromEnv(process.env, words.product);
81
+ } catch (e) {
82
+ return fail((e as Error).message);
83
+ }
84
+ const readRuns = async () => (await readRunLedger(settings.env, settings.name)).records;
85
+ const forge = (): PrForge => forgeFromEnv(kind as ForgeKind);
86
+
87
+ try {
88
+ if (action === "prepare") {
89
+ const d = await prepareAgentRun({ settings, words, dir, env: process.env, event: eventOf(), forge: settings.on === "comment" && kind !== "gitlab" ? forge() : undefined, readRuns, git, now: new Date() });
90
+ console.error(formatInfo(d.go ? `${words.product} agent: runs on ${d.sha?.slice(0, 12)}${d.pr ? ` for #${d.pr}` : ""}` : `${words.product} agent: does not run: ${d.reason}`));
91
+ return CHANT_EXIT.done;
92
+ }
93
+ if (action === "run") {
94
+ const r = await runAgent({ settings, dir, workDir: workDir("chant-agent-work"), env: process.env, git, runCommand: runAgentCommand });
95
+ console.error(formatInfo(`${words.product} agent: exited ${r.rc}${r.changed ? ", with a change" : ", changing nothing"}`));
96
+ // The push job says why on the pull request; this job stays green so it runs.
97
+ return CHANT_EXIT.done;
98
+ }
99
+ const ci = resolveCiRun(process.env);
100
+ const out = await landAgentChange({
101
+ settings,
102
+ words,
103
+ dir,
104
+ workDir: workDir("chant-agent-land"),
105
+ env: process.env,
106
+ event: eventOf(),
107
+ forge: forge(),
108
+ git,
109
+ push: ({ cwd, ref, lease }) => {
110
+ git(["push", "-q", ...(lease ? [`--force-with-lease=${lease}`] : []), "origin", `HEAD:${ref}`], { cwd });
111
+ },
112
+ readRuns,
113
+ record: async (input) => {
114
+ await appendRunRecord(input);
115
+ await pushLifecycle();
116
+ },
117
+ now: () => new Date(),
118
+ ...(ci ? { runOrigin: ci.runOrigin } : {}),
119
+ });
120
+ console.error(formatInfo(`${words.product} agent: ${out.result}: ${out.reason}`));
121
+ return out.code;
122
+ } catch (e) {
123
+ if (e instanceof AgentError) return fail(e.message);
124
+ return fail(`agent ${action}: ${(e as Error).message}`);
125
+ }
126
+ }