@intentius/chant 0.124.54 → 0.124.56

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1077) hide show
  1. package/dist/__fixtures__/estate-ledger.d.ts +13 -0
  2. package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
  3. package/dist/__fixtures__/estate-ledger.js +67 -0
  4. package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
  5. package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
  6. package/dist/__fixtures__/oidc-emulator.js +26 -2
  7. package/dist/__fixtures__/product-words.d.ts +78 -0
  8. package/dist/__fixtures__/product-words.d.ts.map +1 -0
  9. package/dist/__fixtures__/product-words.js +43 -0
  10. package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  11. package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  12. package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  13. package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  14. package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  15. package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  16. package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
  17. package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
  18. package/dist/__golden__/wave-loop/op-held-on.json +28 -7
  19. package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  20. package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  21. package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  22. package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
  23. package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  24. package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
  25. package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
  26. package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
  27. package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  28. package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  29. package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
  30. package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  31. package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  32. package/dist/__golden__/wave-loop/op-overridden.json +28 -7
  33. package/dist/__golden__/wave-loop/op-per-run.json +20 -4
  34. package/dist/__golden__/wave-loop/op-point.json +18 -4
  35. package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
  36. package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
  37. package/dist/__golden__/wave-loop/op-spend.json +10 -2
  38. package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
  39. package/dist/__golden__/wave-loop/op-wide.json +20 -4
  40. package/dist/bucket-check/azure.d.ts +108 -0
  41. package/dist/bucket-check/azure.d.ts.map +1 -0
  42. package/dist/bucket-check/azure.js +258 -0
  43. package/dist/bucket-check/fixtures/azure.json +153 -0
  44. package/dist/bucket-check/fixtures/gcs.json +148 -0
  45. package/dist/bucket-check/fixtures/s3.json +277 -0
  46. package/dist/bucket-check/gcs.d.ts +77 -0
  47. package/dist/bucket-check/gcs.d.ts.map +1 -0
  48. package/dist/bucket-check/gcs.js +202 -0
  49. package/dist/bucket-check/index.d.ts +48 -0
  50. package/dist/bucket-check/index.d.ts.map +1 -0
  51. package/dist/bucket-check/index.js +44 -0
  52. package/dist/bucket-check/s3.d.ts +116 -0
  53. package/dist/bucket-check/s3.d.ts.map +1 -0
  54. package/dist/bucket-check/s3.js +362 -0
  55. package/dist/bucket-check/types.d.ts +66 -0
  56. package/dist/bucket-check/types.d.ts.map +1 -0
  57. package/dist/bucket-check/types.js +31 -0
  58. package/dist/bucket-check/wire.d.ts +27 -0
  59. package/dist/bucket-check/wire.d.ts.map +1 -0
  60. package/dist/bucket-check/wire.js +32 -0
  61. package/dist/bucket-check.d.ts +6 -0
  62. package/dist/bucket-check.d.ts.map +1 -0
  63. package/dist/bucket-check.js +5 -0
  64. package/dist/capabilities/templates.d.ts.map +1 -1
  65. package/dist/capabilities/templates.js +1 -2
  66. package/dist/change-set.d.ts.map +1 -1
  67. package/dist/change-set.js +2 -3
  68. package/dist/ci-agent.d.ts +381 -0
  69. package/dist/ci-agent.d.ts.map +1 -0
  70. package/dist/ci-agent.js +832 -0
  71. package/dist/ci-audit/attribution.d.ts +111 -0
  72. package/dist/ci-audit/attribution.d.ts.map +1 -0
  73. package/dist/ci-audit/attribution.js +194 -0
  74. package/dist/ci-audit/audit-log.d.ts +144 -0
  75. package/dist/ci-audit/audit-log.d.ts.map +1 -0
  76. package/dist/ci-audit/audit-log.js +149 -0
  77. package/dist/ci-audit/index.d.ts +12 -0
  78. package/dist/ci-audit/index.d.ts.map +1 -0
  79. package/dist/ci-audit/index.js +12 -0
  80. package/dist/ci-audit/unrecorded.d.ts +74 -0
  81. package/dist/ci-audit/unrecorded.d.ts.map +1 -0
  82. package/dist/ci-audit/unrecorded.js +95 -0
  83. package/dist/ci-audit.d.ts +3 -0
  84. package/dist/ci-audit.d.ts.map +1 -0
  85. package/dist/ci-audit.js +2 -0
  86. package/dist/ci-control.d.ts +42 -0
  87. package/dist/ci-control.d.ts.map +1 -0
  88. package/dist/ci-control.js +41 -0
  89. package/dist/ci-estate/delivery.d.ts +137 -0
  90. package/dist/ci-estate/delivery.d.ts.map +1 -0
  91. package/dist/ci-estate/delivery.js +311 -0
  92. package/dist/ci-estate/overdue.d.ts +34 -0
  93. package/dist/ci-estate/overdue.d.ts.map +1 -0
  94. package/dist/ci-estate/overdue.js +58 -0
  95. package/dist/ci-estate/page.d.ts +134 -0
  96. package/dist/ci-estate/page.d.ts.map +1 -0
  97. package/dist/ci-estate/page.js +233 -0
  98. package/dist/ci-estate/rows.d.ts +118 -0
  99. package/dist/ci-estate/rows.d.ts.map +1 -0
  100. package/dist/ci-estate/rows.js +126 -0
  101. package/dist/ci-estate.d.ts +92 -0
  102. package/dist/ci-estate.d.ts.map +1 -0
  103. package/dist/ci-estate.js +82 -0
  104. package/dist/ci-handover.d.ts +29 -5
  105. package/dist/ci-handover.d.ts.map +1 -1
  106. package/dist/ci-handover.js +50 -16
  107. package/dist/ci-identity.d.ts +82 -7
  108. package/dist/ci-identity.d.ts.map +1 -1
  109. package/dist/ci-identity.js +86 -15
  110. package/dist/ci-job-guard.d.ts +139 -0
  111. package/dist/ci-job-guard.d.ts.map +1 -0
  112. package/dist/ci-job-guard.js +287 -0
  113. package/dist/ci-jobs.d.ts +7 -0
  114. package/dist/ci-jobs.d.ts.map +1 -1
  115. package/dist/ci-jobs.js +7 -0
  116. package/dist/ci-product-words.d.ts +296 -0
  117. package/dist/ci-product-words.d.ts.map +1 -0
  118. package/dist/ci-product-words.js +407 -0
  119. package/dist/ci-product.d.ts +117 -0
  120. package/dist/ci-product.d.ts.map +1 -0
  121. package/dist/ci-product.js +113 -0
  122. package/dist/ci-respond-run.d.ts +73 -0
  123. package/dist/ci-respond-run.d.ts.map +1 -0
  124. package/dist/ci-respond-run.js +247 -0
  125. package/dist/ci-respond.d.ts +189 -0
  126. package/dist/ci-respond.d.ts.map +1 -0
  127. package/dist/ci-respond.js +285 -0
  128. package/dist/cli/commands/audit.d.ts +2 -2
  129. package/dist/cli/commands/audit.d.ts.map +1 -1
  130. package/dist/cli/commands/audit.js +3 -2
  131. package/dist/cli/commands/carve.js +2 -2
  132. package/dist/cli/commands/init.d.ts +2 -0
  133. package/dist/cli/commands/init.d.ts.map +1 -1
  134. package/dist/cli/commands/init.js +1 -1
  135. package/dist/cli/handlers/agent.d.ts +17 -0
  136. package/dist/cli/handlers/agent.d.ts.map +1 -0
  137. package/dist/cli/handlers/agent.js +114 -0
  138. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  139. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  140. package/dist/cli/handlers/approve-confirm.js +142 -0
  141. package/dist/cli/handlers/approve.d.ts.map +1 -1
  142. package/dist/cli/handlers/approve.js +19 -1
  143. package/dist/cli/handlers/audit-log.d.ts +12 -0
  144. package/dist/cli/handlers/audit-log.d.ts.map +1 -0
  145. package/dist/cli/handlers/audit-log.js +81 -0
  146. package/dist/cli/handlers/build.d.ts +7 -0
  147. package/dist/cli/handlers/build.d.ts.map +1 -1
  148. package/dist/cli/handlers/build.js +124 -1
  149. package/dist/cli/handlers/ci-check-job.d.ts +11 -0
  150. package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
  151. package/dist/cli/handlers/ci-check-job.js +27 -0
  152. package/dist/cli/handlers/ci-check.d.ts +3 -0
  153. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  154. package/dist/cli/handlers/ci-check.js +63 -0
  155. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  156. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  157. package/dist/cli/handlers/ci-forge-check.js +89 -0
  158. package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
  159. package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
  160. package/dist/cli/handlers/e2e-safe-run.js +23 -0
  161. package/dist/cli/handlers/fan-out.js +4 -0
  162. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  163. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  164. package/dist/cli/handlers/gate-pending.js +44 -0
  165. package/dist/cli/handlers/init.d.ts.map +1 -1
  166. package/dist/cli/handlers/init.js +1 -0
  167. package/dist/cli/handlers/ledger.js +1 -1
  168. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  169. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  170. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  171. package/dist/cli/handlers/lock.d.ts.map +1 -1
  172. package/dist/cli/handlers/lock.js +64 -5
  173. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  174. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  175. package/dist/cli/handlers/notify-relay.js +130 -0
  176. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  177. package/dist/cli/handlers/pr-env.js +42 -11
  178. package/dist/cli/handlers/pr.d.ts +43 -3
  179. package/dist/cli/handlers/pr.d.ts.map +1 -1
  180. package/dist/cli/handlers/pr.js +908 -205
  181. package/dist/cli/handlers/promote.d.ts.map +1 -1
  182. package/dist/cli/handlers/promote.js +21 -2
  183. package/dist/cli/handlers/release.d.ts.map +1 -1
  184. package/dist/cli/handlers/release.js +3 -0
  185. package/dist/cli/handlers/run-wave.d.ts +8 -0
  186. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  187. package/dist/cli/handlers/run-wave.js +160 -2
  188. package/dist/cli/handlers/run.d.ts +6 -1
  189. package/dist/cli/handlers/run.d.ts.map +1 -1
  190. package/dist/cli/handlers/run.js +86 -1
  191. package/dist/cli/handlers/serve.d.ts.map +1 -1
  192. package/dist/cli/handlers/serve.js +10 -1
  193. package/dist/cli/main.d.ts +11 -1
  194. package/dist/cli/main.d.ts.map +1 -1
  195. package/dist/cli/main.js +178 -13
  196. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  197. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  198. package/dist/cli/mcp/ledger-tools.js +122 -0
  199. package/dist/cli/mcp/product-tools.d.ts +78 -0
  200. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  201. package/dist/cli/mcp/product-tools.js +93 -0
  202. package/dist/cli/mcp/read-only.d.ts +34 -0
  203. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  204. package/dist/cli/mcp/read-only.js +61 -0
  205. package/dist/cli/mcp/report-tools.d.ts +48 -0
  206. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  207. package/dist/cli/mcp/report-tools.js +128 -0
  208. package/dist/cli/mcp/server.d.ts +28 -1
  209. package/dist/cli/mcp/server.d.ts.map +1 -1
  210. package/dist/cli/mcp/server.js +86 -15
  211. package/dist/cli/mcp-config.d.ts +9 -2
  212. package/dist/cli/mcp-config.d.ts.map +1 -1
  213. package/dist/cli/mcp-config.js +8 -3
  214. package/dist/cli/parse-args.d.ts.map +1 -1
  215. package/dist/cli/parse-args.js +164 -3
  216. package/dist/cli/registry.d.ts +73 -0
  217. package/dist/cli/registry.d.ts.map +1 -1
  218. package/dist/cloud-lister/sigv4.d.ts +42 -7
  219. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  220. package/dist/cloud-lister/sigv4.js +72 -22
  221. package/dist/components/adoption.d.ts +69 -0
  222. package/dist/components/adoption.d.ts.map +1 -0
  223. package/dist/components/adoption.js +92 -0
  224. package/dist/components/apply-lease.d.ts +19 -0
  225. package/dist/components/apply-lease.d.ts.map +1 -0
  226. package/dist/components/apply-lease.js +41 -0
  227. package/dist/components/capability.d.ts +159 -5
  228. package/dist/components/capability.d.ts.map +1 -1
  229. package/dist/components/capability.js +39 -6
  230. package/dist/components/check-hooks.d.ts +116 -0
  231. package/dist/components/check-hooks.d.ts.map +1 -0
  232. package/dist/components/check-hooks.js +192 -0
  233. package/dist/components/check-steps.d.ts +74 -0
  234. package/dist/components/check-steps.d.ts.map +1 -0
  235. package/dist/components/check-steps.js +102 -0
  236. package/dist/components/ci-services.d.ts +57 -0
  237. package/dist/components/ci-services.d.ts.map +1 -0
  238. package/dist/components/ci-services.js +60 -0
  239. package/dist/components/cli-support.d.ts +13 -0
  240. package/dist/components/cli-support.d.ts.map +1 -1
  241. package/dist/components/cli-support.js +10 -2
  242. package/dist/components/driver.d.ts +32 -3
  243. package/dist/components/driver.d.ts.map +1 -1
  244. package/dist/components/driver.js +59 -5
  245. package/dist/components/fan-out-run.d.ts +12 -0
  246. package/dist/components/fan-out-run.d.ts.map +1 -1
  247. package/dist/components/fan-out-run.js +56 -16
  248. package/dist/components/groups.d.ts.map +1 -1
  249. package/dist/components/groups.js +23 -5
  250. package/dist/components/pr-env-ledger.d.ts +32 -0
  251. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  252. package/dist/components/pr-env-ledger.js +38 -0
  253. package/dist/components/pr-env-ports.d.ts +12 -0
  254. package/dist/components/pr-env-ports.d.ts.map +1 -1
  255. package/dist/components/pr-env-ports.js +13 -3
  256. package/dist/components/pr-env-run.d.ts +6 -0
  257. package/dist/components/pr-env-run.d.ts.map +1 -1
  258. package/dist/components/pr-env-run.js +3 -2
  259. package/dist/components/pr-environment.d.ts +32 -4
  260. package/dist/components/pr-environment.d.ts.map +1 -1
  261. package/dist/components/pr-environment.js +26 -8
  262. package/dist/components/pr-pipeline.d.ts +297 -5
  263. package/dist/components/pr-pipeline.d.ts.map +1 -1
  264. package/dist/components/pr-pipeline.js +329 -18
  265. package/dist/components/pr-policy.d.ts +26 -2
  266. package/dist/components/pr-policy.d.ts.map +1 -1
  267. package/dist/components/pr-policy.js +41 -7
  268. package/dist/components/pr-run.d.ts +71 -0
  269. package/dist/components/pr-run.d.ts.map +1 -1
  270. package/dist/components/pr-run.js +91 -7
  271. package/dist/components/pr-targets.d.ts +24 -0
  272. package/dist/components/pr-targets.d.ts.map +1 -0
  273. package/dist/components/pr-targets.js +48 -0
  274. package/dist/components/product-pipeline.d.ts +250 -0
  275. package/dist/components/product-pipeline.d.ts.map +1 -0
  276. package/dist/components/product-pipeline.js +212 -0
  277. package/dist/components/promote.d.ts +6 -0
  278. package/dist/components/promote.d.ts.map +1 -1
  279. package/dist/components/promote.js +4 -1
  280. package/dist/components/release-compile.d.ts +22 -1
  281. package/dist/components/release-compile.d.ts.map +1 -1
  282. package/dist/components/release-compile.js +85 -0
  283. package/dist/components/release-promote.d.ts +15 -1
  284. package/dist/components/release-promote.d.ts.map +1 -1
  285. package/dist/components/release-promote.js +67 -2
  286. package/dist/components/repo-lock.d.ts +27 -0
  287. package/dist/components/repo-lock.d.ts.map +1 -0
  288. package/dist/components/repo-lock.js +49 -0
  289. package/dist/components/row-lease.d.ts +84 -0
  290. package/dist/components/row-lease.d.ts.map +1 -0
  291. package/dist/components/row-lease.js +110 -0
  292. package/dist/components/wave-plan.d.ts +42 -0
  293. package/dist/components/wave-plan.d.ts.map +1 -1
  294. package/dist/components/wave-plan.js +72 -4
  295. package/dist/control/applied.d.ts +89 -0
  296. package/dist/control/applied.d.ts.map +1 -0
  297. package/dist/control/applied.js +175 -0
  298. package/dist/control/consumers.d.ts +78 -0
  299. package/dist/control/consumers.d.ts.map +1 -0
  300. package/dist/control/consumers.js +172 -0
  301. package/dist/control/dispatch.d.ts +334 -0
  302. package/dist/control/dispatch.d.ts.map +1 -0
  303. package/dist/control/dispatch.js +519 -0
  304. package/dist/control/edges.d.ts +75 -0
  305. package/dist/control/edges.d.ts.map +1 -0
  306. package/dist/control/edges.js +133 -0
  307. package/dist/control/reconcile.d.ts +120 -0
  308. package/dist/control/reconcile.d.ts.map +1 -0
  309. package/dist/control/reconcile.js +178 -0
  310. package/dist/control/records.d.ts +187 -0
  311. package/dist/control/records.d.ts.map +1 -0
  312. package/dist/control/records.js +307 -0
  313. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  314. package/dist/discovery/sandbox/bundle.js +25 -1
  315. package/dist/e2e-harness/bucket.d.ts +21 -0
  316. package/dist/e2e-harness/bucket.d.ts.map +1 -0
  317. package/dist/e2e-harness/bucket.js +61 -0
  318. package/dist/e2e-harness/claim.d.ts +70 -0
  319. package/dist/e2e-harness/claim.d.ts.map +1 -0
  320. package/dist/e2e-harness/claim.js +98 -0
  321. package/dist/e2e-harness/driver.d.ts +64 -0
  322. package/dist/e2e-harness/driver.d.ts.map +1 -0
  323. package/dist/e2e-harness/driver.js +243 -0
  324. package/dist/e2e-harness/forgejo.d.ts +77 -0
  325. package/dist/e2e-harness/forgejo.d.ts.map +1 -0
  326. package/dist/e2e-harness/forgejo.js +205 -0
  327. package/dist/e2e-harness/git.d.ts +32 -0
  328. package/dist/e2e-harness/git.d.ts.map +1 -0
  329. package/dist/e2e-harness/git.js +67 -0
  330. package/dist/e2e-harness/index.d.ts +22 -0
  331. package/dist/e2e-harness/index.d.ts.map +1 -0
  332. package/dist/e2e-harness/index.js +48 -0
  333. package/dist/e2e-harness/jobs.d.ts +8 -0
  334. package/dist/e2e-harness/jobs.d.ts.map +1 -0
  335. package/dist/e2e-harness/jobs.js +34 -0
  336. package/dist/e2e-harness/pins.d.ts +45 -0
  337. package/dist/e2e-harness/pins.d.ts.map +1 -0
  338. package/dist/e2e-harness/pins.js +44 -0
  339. package/dist/e2e-harness/ports.d.ts +113 -0
  340. package/dist/e2e-harness/ports.d.ts.map +1 -0
  341. package/dist/e2e-harness/ports.js +4 -0
  342. package/dist/e2e-harness/reports.d.ts +45 -0
  343. package/dist/e2e-harness/reports.d.ts.map +1 -0
  344. package/dist/e2e-harness/reports.js +57 -0
  345. package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
  346. package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
  347. package/dist/e2e-harness/safe-run-cli.js +43 -0
  348. package/dist/e2e-harness/safe-run.d.ts +61 -0
  349. package/dist/e2e-harness/safe-run.d.ts.map +1 -0
  350. package/dist/e2e-harness/safe-run.js +172 -0
  351. package/dist/e2e-harness/scenario.d.ts +11 -0
  352. package/dist/e2e-harness/scenario.d.ts.map +1 -0
  353. package/dist/e2e-harness/scenario.js +89 -0
  354. package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  355. package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
  356. package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  357. package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  358. package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  359. package/dist/e2e-harness/schemas/index.d.ts +191 -0
  360. package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
  361. package/dist/e2e-harness/schemas/index.js +62 -0
  362. package/dist/e2e-harness/stack.d.ts +124 -0
  363. package/dist/e2e-harness/stack.d.ts.map +1 -0
  364. package/dist/e2e-harness/stack.js +207 -0
  365. package/dist/e2e-harness/steps.d.ts +11 -0
  366. package/dist/e2e-harness/steps.d.ts.map +1 -0
  367. package/dist/e2e-harness/steps.js +22 -0
  368. package/dist/e2e-harness.d.ts +3 -0
  369. package/dist/e2e-harness.d.ts.map +1 -0
  370. package/dist/e2e-harness.js +2 -0
  371. package/dist/engine-facts.d.ts.map +1 -1
  372. package/dist/engine-facts.js +1 -2
  373. package/dist/exit-codes.d.ts +54 -0
  374. package/dist/exit-codes.d.ts.map +1 -0
  375. package/dist/exit-codes.js +55 -0
  376. package/dist/forge-check/check.d.ts +63 -0
  377. package/dist/forge-check/check.d.ts.map +1 -0
  378. package/dist/forge-check/check.js +139 -0
  379. package/dist/forge-check/contract.d.ts +152 -0
  380. package/dist/forge-check/contract.d.ts.map +1 -0
  381. package/dist/forge-check/contract.js +118 -0
  382. package/dist/forge-check/forge.d.ts +42 -0
  383. package/dist/forge-check/forge.d.ts.map +1 -0
  384. package/dist/forge-check/forge.js +338 -0
  385. package/dist/forge-check/index.d.ts +24 -0
  386. package/dist/forge-check/index.d.ts.map +1 -0
  387. package/dist/forge-check/index.js +23 -0
  388. package/dist/forge-check/pulumi.d.ts +44 -0
  389. package/dist/forge-check/pulumi.d.ts.map +1 -0
  390. package/dist/forge-check/pulumi.js +184 -0
  391. package/dist/forge-check/read-only.d.ts +26 -0
  392. package/dist/forge-check/read-only.d.ts.map +1 -0
  393. package/dist/forge-check/read-only.js +53 -0
  394. package/dist/forge-check/trust.d.ts +94 -0
  395. package/dist/forge-check/trust.d.ts.map +1 -0
  396. package/dist/forge-check/trust.js +532 -0
  397. package/dist/forge-check/types.d.ts +80 -0
  398. package/dist/forge-check/types.d.ts.map +1 -0
  399. package/dist/forge-check/types.js +18 -0
  400. package/dist/forge-check.d.ts +6 -0
  401. package/dist/forge-check.d.ts.map +1 -0
  402. package/dist/forge-check.js +5 -0
  403. package/dist/gate-decision.d.ts +1 -0
  404. package/dist/gate-decision.d.ts.map +1 -1
  405. package/dist/gate-decision.js +2 -0
  406. package/dist/gate-policy.d.ts +47 -1
  407. package/dist/gate-policy.d.ts.map +1 -1
  408. package/dist/gate-policy.js +50 -2
  409. package/dist/index.d.ts +1 -0
  410. package/dist/index.d.ts.map +1 -1
  411. package/dist/index.js +2 -0
  412. package/dist/lexicon.d.ts +152 -6
  413. package/dist/lexicon.d.ts.map +1 -1
  414. package/dist/lifecycle/adoption-file.d.ts +24 -0
  415. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  416. package/dist/lifecycle/adoption-file.js +1 -2
  417. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  418. package/dist/lifecycle/cloud-index.js +1 -2
  419. package/dist/lifecycle/gate-applied.d.ts +6 -0
  420. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  421. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  422. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  423. package/dist/lifecycle/gate-ledger.js +10 -1
  424. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  425. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  426. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  427. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  428. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  429. package/dist/lifecycle/gated-request-digest.js +35 -0
  430. package/dist/lifecycle/gated-request.d.ts +126 -0
  431. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  432. package/dist/lifecycle/gated-request.js +204 -0
  433. package/dist/lifecycle/identity-match.d.ts +15 -0
  434. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  435. package/dist/lifecycle/identity-match.js +11 -6
  436. package/dist/lifecycle/index-diff.d.ts +40 -0
  437. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  438. package/dist/lifecycle/index-diff.js +1 -2
  439. package/dist/lifecycle/index-document.d.ts.map +1 -1
  440. package/dist/lifecycle/index-document.js +1 -2
  441. package/dist/lifecycle/index-import.d.ts +4 -1
  442. package/dist/lifecycle/index-import.d.ts.map +1 -1
  443. package/dist/lifecycle/index-import.js +29 -32
  444. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  445. package/dist/lifecycle/ledger-read.js +7 -3
  446. package/dist/lifecycle/lock-rows.d.ts +76 -0
  447. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  448. package/dist/lifecycle/lock-rows.js +140 -0
  449. package/dist/lifecycle/query.d.ts +50 -3
  450. package/dist/lifecycle/query.d.ts.map +1 -1
  451. package/dist/lifecycle/query.js +97 -7
  452. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  453. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  454. package/dist/lifecycle/release-catalog-site.js +232 -0
  455. package/dist/lifecycle/release-catalog.d.ts +201 -0
  456. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  457. package/dist/lifecycle/release-catalog.js +198 -0
  458. package/dist/lifecycle/release-changelog.d.ts +41 -0
  459. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  460. package/dist/lifecycle/release-changelog.js +38 -0
  461. package/dist/lifecycle/release-cut.d.ts +1 -0
  462. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  463. package/dist/lifecycle/release-cut.js +1 -1
  464. package/dist/lifecycle/release-ledger.d.ts +16 -0
  465. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  466. package/dist/lifecycle/release-ledger.js +9 -0
  467. package/dist/lifecycle/release-publish.d.ts +43 -22
  468. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  469. package/dist/lifecycle/release-read.d.ts.map +1 -1
  470. package/dist/lifecycle/release-read.js +3 -0
  471. package/dist/lifecycle/release-status.d.ts +106 -0
  472. package/dist/lifecycle/release-status.d.ts.map +1 -0
  473. package/dist/lifecycle/release-status.js +115 -0
  474. package/dist/lifecycle/resource-lock.d.ts +120 -0
  475. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  476. package/dist/lifecycle/resource-lock.js +317 -0
  477. package/dist/lifecycle/retention.d.ts.map +1 -1
  478. package/dist/lifecycle/retention.js +3 -0
  479. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  480. package/dist/lifecycle/run-ledger.js +9 -1
  481. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  482. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  483. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  484. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  485. package/dist/lifecycle/snapshot-store.js +1 -2
  486. package/dist/lifecycle/target-lock.d.ts +15 -0
  487. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  488. package/dist/lifecycle/target-lock.js +25 -10
  489. package/dist/lifecycle/wave-plans.d.ts +23 -7
  490. package/dist/lifecycle/wave-plans.d.ts.map +1 -1
  491. package/dist/lifecycle/wave-plans.js +9 -2
  492. package/dist/mcp/types.d.ts +7 -0
  493. package/dist/mcp/types.d.ts.map +1 -1
  494. package/dist/notify-product.d.ts +43 -0
  495. package/dist/notify-product.d.ts.map +1 -0
  496. package/dist/notify-product.js +58 -0
  497. package/dist/notify-relay.d.ts +197 -0
  498. package/dist/notify-relay.d.ts.map +1 -0
  499. package/dist/notify-relay.js +321 -0
  500. package/dist/notify.d.ts +44 -4
  501. package/dist/notify.d.ts.map +1 -1
  502. package/dist/notify.js +77 -14
  503. package/dist/object-store/azure-blob.d.ts +129 -0
  504. package/dist/object-store/azure-blob.d.ts.map +1 -0
  505. package/dist/object-store/azure-blob.js +341 -0
  506. package/dist/object-store/common.d.ts +108 -0
  507. package/dist/object-store/common.d.ts.map +1 -0
  508. package/dist/object-store/common.js +80 -0
  509. package/dist/object-store/errors.d.ts +28 -0
  510. package/dist/object-store/errors.d.ts.map +1 -0
  511. package/dist/object-store/errors.js +21 -0
  512. package/dist/object-store/from-env.d.ts +18 -0
  513. package/dist/object-store/from-env.d.ts.map +1 -0
  514. package/dist/object-store/from-env.js +22 -0
  515. package/dist/object-store/gcs.d.ts +106 -0
  516. package/dist/object-store/gcs.d.ts.map +1 -0
  517. package/dist/object-store/gcs.js +393 -0
  518. package/dist/object-store/index.d.ts +9 -0
  519. package/dist/object-store/index.d.ts.map +1 -0
  520. package/dist/object-store/index.js +8 -0
  521. package/dist/object-store/s3.d.ts +146 -0
  522. package/dist/object-store/s3.d.ts.map +1 -0
  523. package/dist/object-store/s3.js +306 -0
  524. package/dist/op/activities/converge.d.ts.map +1 -1
  525. package/dist/op/activities/converge.js +2 -1
  526. package/dist/op/activities/index.d.ts +1 -1
  527. package/dist/op/activities/index.d.ts.map +1 -1
  528. package/dist/op/activities/index.js +1 -1
  529. package/dist/op/activities/review-agent.d.ts +55 -2
  530. package/dist/op/activities/review-agent.d.ts.map +1 -1
  531. package/dist/op/activities/review-agent.js +65 -5
  532. package/dist/op/approval-status.d.ts +103 -0
  533. package/dist/op/approval-status.d.ts.map +1 -0
  534. package/dist/op/approval-status.js +197 -0
  535. package/dist/op/gate.d.ts +29 -1
  536. package/dist/op/gate.d.ts.map +1 -1
  537. package/dist/op/gate.js +59 -23
  538. package/dist/op/generate-pipeline.d.ts.map +1 -1
  539. package/dist/op/generate-pipeline.js +7 -1
  540. package/dist/op/index.d.ts +12 -1
  541. package/dist/op/index.d.ts.map +1 -1
  542. package/dist/op/index.js +7 -1
  543. package/dist/op/op-waves-after-plan.d.ts +137 -0
  544. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  545. package/dist/op/op-waves-after-plan.js +163 -0
  546. package/dist/op/op-waves-capability-spec.d.ts +63 -0
  547. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  548. package/dist/op/op-waves-capability-spec.js +115 -0
  549. package/dist/op/op-waves-capability.d.ts +197 -0
  550. package/dist/op/op-waves-capability.d.ts.map +1 -0
  551. package/dist/op/op-waves-capability.js +311 -0
  552. package/dist/op/op-waves-events.d.ts +54 -0
  553. package/dist/op/op-waves-events.d.ts.map +1 -0
  554. package/dist/op/op-waves-events.js +122 -0
  555. package/dist/op/op-waves-notify.d.ts +7 -1
  556. package/dist/op/op-waves-notify.d.ts.map +1 -1
  557. package/dist/op/op-waves-notify.js +35 -16
  558. package/dist/op/op-waves-release-port.d.ts +18 -0
  559. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  560. package/dist/op/op-waves-release-port.js +61 -0
  561. package/dist/op/op-waves-release.d.ts +92 -0
  562. package/dist/op/op-waves-release.d.ts.map +1 -0
  563. package/dist/op/op-waves-release.js +96 -0
  564. package/dist/op/op-waves-run.d.ts +182 -6
  565. package/dist/op/op-waves-run.d.ts.map +1 -1
  566. package/dist/op/op-waves-run.js +1076 -44
  567. package/dist/op/op-waves-stand-down.d.ts +60 -0
  568. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  569. package/dist/op/op-waves-stand-down.js +96 -0
  570. package/dist/op/op-waves.d.ts +187 -8
  571. package/dist/op/op-waves.d.ts.map +1 -1
  572. package/dist/op/op-waves.js +203 -19
  573. package/dist/op/runtime.d.ts +95 -0
  574. package/dist/op/runtime.d.ts.map +1 -1
  575. package/dist/op/runtime.js +18 -0
  576. package/dist/op/stage-hooks.d.ts +45 -7
  577. package/dist/op/stage-hooks.d.ts.map +1 -1
  578. package/dist/op/stage-hooks.js +61 -3
  579. package/dist/op/steward-beside.d.ts.map +1 -1
  580. package/dist/op/steward-beside.js +2 -1
  581. package/dist/op/types.d.ts +2 -2
  582. package/dist/op/types.d.ts.map +1 -1
  583. package/dist/op/types.js +3 -2
  584. package/dist/otlp-metrics.d.ts +38 -0
  585. package/dist/otlp-metrics.d.ts.map +1 -0
  586. package/dist/otlp-metrics.js +82 -0
  587. package/dist/otlp.d.ts +249 -0
  588. package/dist/otlp.d.ts.map +1 -0
  589. package/dist/otlp.js +425 -0
  590. package/dist/override-gate.d.ts.map +1 -1
  591. package/dist/override-gate.js +5 -0
  592. package/dist/parallelism.d.ts +17 -0
  593. package/dist/parallelism.d.ts.map +1 -0
  594. package/dist/parallelism.js +33 -0
  595. package/dist/policy-packs.d.ts +69 -0
  596. package/dist/policy-packs.d.ts.map +1 -0
  597. package/dist/policy-packs.js +205 -0
  598. package/dist/policy-source.d.ts +51 -0
  599. package/dist/policy-source.d.ts.map +1 -0
  600. package/dist/policy-source.js +102 -0
  601. package/dist/pr-forge.d.ts +40 -0
  602. package/dist/pr-forge.d.ts.map +1 -1
  603. package/dist/pr-forge.js +146 -37
  604. package/dist/pr-loop.d.ts +158 -11
  605. package/dist/pr-loop.d.ts.map +1 -1
  606. package/dist/pr-loop.js +302 -44
  607. package/dist/pr-merge.d.ts +64 -0
  608. package/dist/pr-merge.d.ts.map +1 -0
  609. package/dist/pr-merge.js +78 -0
  610. package/dist/pr-post.d.ts +86 -1
  611. package/dist/pr-post.d.ts.map +1 -1
  612. package/dist/pr-post.js +141 -5
  613. package/dist/pr-report-url.d.ts +32 -4
  614. package/dist/pr-report-url.d.ts.map +1 -1
  615. package/dist/pr-report-url.js +45 -5
  616. package/dist/pr-requires.d.ts +13 -2
  617. package/dist/pr-requires.d.ts.map +1 -1
  618. package/dist/pr-requires.js +14 -0
  619. package/dist/release-floors.d.ts +1 -1
  620. package/dist/release-floors.js +1 -1
  621. package/dist/run-event.d.ts +26 -1
  622. package/dist/run-event.d.ts.map +1 -1
  623. package/dist/run-event.js +3 -1
  624. package/dist/scheduled-op-cloud.d.ts +32 -0
  625. package/dist/scheduled-op-cloud.d.ts.map +1 -0
  626. package/dist/scheduled-op-cloud.js +69 -0
  627. package/dist/sorted-json.d.ts +10 -0
  628. package/dist/sorted-json.d.ts.map +1 -0
  629. package/dist/sorted-json.js +14 -0
  630. package/dist/terraform/credentials.d.ts +59 -0
  631. package/dist/terraform/credentials.d.ts.map +1 -0
  632. package/dist/terraform/credentials.js +149 -0
  633. package/dist/utils.d.ts +1 -4
  634. package/dist/utils.d.ts.map +1 -1
  635. package/dist/utils.js +1 -9
  636. package/dist/wave-runtime.d.ts +1 -1
  637. package/dist/wave-runtime.js +2 -2
  638. package/dist/wave-runtime.mjs +405 -287
  639. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  640. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  641. package/dist/workspace/ci-lock-grain.d.ts +17 -0
  642. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  643. package/dist/workspace/ci-lock-grain.js +21 -0
  644. package/dist/workspace/ci-run.d.ts +2 -1
  645. package/dist/workspace/ci-run.d.ts.map +1 -1
  646. package/dist/workspace/ci-run.js +10 -3
  647. package/dist/workspace/declaration.d.ts +16 -4
  648. package/dist/workspace/declaration.d.ts.map +1 -1
  649. package/dist/workspace/declaration.js +5 -2
  650. package/dist/workspace/declaration.schema.json +27 -3
  651. package/dist/workspace/drift-cli.d.ts.map +1 -1
  652. package/dist/workspace/drift-cli.js +8 -3
  653. package/dist/workspace/exit-cli.d.ts +1 -1
  654. package/dist/workspace/exit-cli.d.ts.map +1 -1
  655. package/dist/workspace/exit-cli.js +2 -1
  656. package/dist/workspace/import-fetch.d.ts +4 -2
  657. package/dist/workspace/import-fetch.d.ts.map +1 -1
  658. package/dist/workspace/import-fetch.js +4 -2
  659. package/dist/workspace/import-init.d.ts.map +1 -1
  660. package/dist/workspace/import-init.js +4 -2
  661. package/dist/workspace/ledger.schema.json +7 -3
  662. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  663. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  664. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  665. package/dist/workspace/pr-report.schema.json +79 -3
  666. package/dist/workspace/promote.d.ts +1 -1
  667. package/dist/workspace/promote.d.ts.map +1 -1
  668. package/dist/workspace/promote.js +2 -1
  669. package/dist/workspace/records-cli.d.ts +2 -2
  670. package/dist/workspace/records-cli.d.ts.map +1 -1
  671. package/dist/workspace/records-cli.js +3 -2
  672. package/dist/workspace/release-catalog.schema.json +277 -0
  673. package/dist/workspace/run-event.schema.json +18 -1
  674. package/dist/workspace/work-cli.d.ts +3 -1
  675. package/dist/workspace/work-cli.d.ts.map +1 -1
  676. package/dist/workspace/work-cli.js +7 -2
  677. package/dist/workspace/workspace-run.d.ts.map +1 -1
  678. package/dist/workspace/workspace-run.js +2 -1
  679. package/package.json +21 -1
  680. package/src/__fixtures__/estate-ledger.ts +101 -0
  681. package/src/__fixtures__/oidc-emulator.ts +31 -2
  682. package/src/__fixtures__/product-words.ts +44 -0
  683. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  684. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  685. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  686. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  687. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  688. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  689. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  690. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  691. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  692. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  693. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  694. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  695. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  696. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  697. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  698. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  699. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  700. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  701. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  702. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  703. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  704. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  705. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  706. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  707. package/src/__golden__/wave-loop/op-point.json +18 -4
  708. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  709. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  710. package/src/__golden__/wave-loop/op-spend.json +10 -2
  711. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  712. package/src/__golden__/wave-loop/op-wide.json +20 -4
  713. package/src/bucket-check/azure.ts +307 -0
  714. package/src/bucket-check/bucket-check.test.ts +210 -0
  715. package/src/bucket-check/fixtures/azure.json +153 -0
  716. package/src/bucket-check/fixtures/gcs.json +148 -0
  717. package/src/bucket-check/fixtures/s3.json +277 -0
  718. package/src/bucket-check/gcs.ts +257 -0
  719. package/src/bucket-check/index.ts +61 -0
  720. package/src/bucket-check/s3.ts +433 -0
  721. package/src/bucket-check/types.ts +75 -0
  722. package/src/bucket-check/wire.ts +50 -0
  723. package/src/bucket-check.ts +5 -0
  724. package/src/capabilities/templates.test.ts +2 -3
  725. package/src/capabilities/templates.ts +1 -2
  726. package/src/cdk/advise.test.ts +1 -1
  727. package/src/change-set-bundle.test.ts +0 -1
  728. package/src/change-set.ts +2 -3
  729. package/src/ci-agent.test.ts +348 -0
  730. package/src/ci-agent.ts +1025 -0
  731. package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
  732. package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
  733. package/src/ci-audit/attribution.ts +260 -0
  734. package/src/ci-audit/audit-log.ts +220 -0
  735. package/src/ci-audit/ci-audit.test.ts +175 -0
  736. package/src/ci-audit/index.ts +15 -0
  737. package/src/ci-audit/unrecorded.ts +140 -0
  738. package/src/ci-audit.ts +2 -0
  739. package/src/ci-control.ts +173 -0
  740. package/src/ci-estate/delivery.ts +433 -0
  741. package/src/ci-estate/overdue.ts +81 -0
  742. package/src/ci-estate/page.ts +343 -0
  743. package/src/ci-estate/rows.ts +251 -0
  744. package/src/ci-estate.test.ts +281 -0
  745. package/src/ci-estate.ts +175 -0
  746. package/src/ci-handover.ts +67 -16
  747. package/src/ci-identity-database.test.ts +54 -0
  748. package/src/ci-identity-pulumi.test.ts +163 -0
  749. package/src/ci-identity-targets.test.ts +3 -1
  750. package/src/ci-identity.ts +123 -22
  751. package/src/ci-job-guard.test.ts +154 -0
  752. package/src/ci-job-guard.ts +319 -0
  753. package/src/ci-jobs.ts +8 -0
  754. package/src/ci-product-comment-targets.test.ts +45 -0
  755. package/src/ci-product-words.test.ts +101 -0
  756. package/src/ci-product-words.ts +565 -0
  757. package/src/ci-product.ts +226 -0
  758. package/src/ci-respond-run.ts +291 -0
  759. package/src/ci-respond.test.ts +264 -0
  760. package/src/ci-respond.ts +412 -0
  761. package/src/ci-shared-reads.test.ts +145 -0
  762. package/src/cli/commands/audit.test.ts +1 -1
  763. package/src/cli/commands/audit.ts +3 -2
  764. package/src/cli/commands/carve.test.ts +1 -1
  765. package/src/cli/commands/carve.ts +2 -2
  766. package/src/cli/commands/init.ts +3 -1
  767. package/src/cli/component-wave-args.test.ts +16 -0
  768. package/src/cli/handlers/agent.ts +126 -0
  769. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  770. package/src/cli/handlers/approve-confirm.ts +200 -0
  771. package/src/cli/handlers/approve.ts +18 -1
  772. package/src/cli/handlers/audit-log.ts +74 -0
  773. package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
  774. package/src/cli/handlers/build.test.ts +7 -0
  775. package/src/cli/handlers/build.ts +113 -1
  776. package/src/cli/handlers/ci-check-job.test.ts +114 -0
  777. package/src/cli/handlers/ci-check-job.ts +33 -0
  778. package/src/cli/handlers/ci-check.ts +63 -0
  779. package/src/cli/handlers/ci-forge-check.ts +91 -0
  780. package/src/cli/handlers/e2e-safe-run.ts +27 -0
  781. package/src/cli/handlers/fan-out.test.ts +10 -10
  782. package/src/cli/handlers/fan-out.ts +5 -0
  783. package/src/cli/handlers/gate-pending.ts +46 -0
  784. package/src/cli/handlers/init.ts +1 -0
  785. package/src/cli/handlers/ledger.ts +1 -1
  786. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  787. package/src/cli/handlers/lock.test.ts +29 -2
  788. package/src/cli/handlers/lock.ts +66 -6
  789. package/src/cli/handlers/notify-relay.ts +130 -0
  790. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  791. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  792. package/src/cli/handlers/pr-env.ts +48 -11
  793. package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
  794. package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
  795. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  796. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  797. package/src/cli/handlers/pr-waves.test.ts +8 -2
  798. package/src/cli/handlers/pr.test.ts +8 -8
  799. package/src/cli/handlers/pr.ts +879 -205
  800. package/src/cli/handlers/promote.test.ts +5 -5
  801. package/src/cli/handlers/promote.ts +22 -2
  802. package/src/cli/handlers/release.ts +2 -0
  803. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  804. package/src/cli/handlers/run-wave.ts +144 -2
  805. package/src/cli/handlers/run.test.ts +6 -4
  806. package/src/cli/handlers/run.ts +86 -1
  807. package/src/cli/handlers/serve.ts +10 -1
  808. package/src/cli/main.test.ts +1 -1
  809. package/src/cli/main.ts +180 -13
  810. package/src/cli/mcp/ledger-tools.ts +126 -0
  811. package/src/cli/mcp/product-tools.test.ts +123 -0
  812. package/src/cli/mcp/product-tools.ts +129 -0
  813. package/src/cli/mcp/read-only.test.ts +134 -0
  814. package/src/cli/mcp/read-only.ts +68 -0
  815. package/src/cli/mcp/report-tools.ts +135 -0
  816. package/src/cli/mcp/server.test.ts +5 -4
  817. package/src/cli/mcp/server.ts +90 -16
  818. package/src/cli/mcp-config.ts +8 -3
  819. package/src/cli/parse-args.ts +119 -2
  820. package/src/cli/registry.ts +73 -0
  821. package/src/cloud-lister/sigv4.ts +80 -23
  822. package/src/components/adoption.test.ts +140 -0
  823. package/src/components/adoption.ts +140 -0
  824. package/src/components/apply-lease.ts +49 -0
  825. package/src/components/capability.ts +180 -6
  826. package/src/components/check-hooks.test.ts +66 -0
  827. package/src/components/check-hooks.ts +255 -0
  828. package/src/components/check-steps.test.ts +70 -0
  829. package/src/components/check-steps.ts +158 -0
  830. package/src/components/ci-services.test.ts +51 -0
  831. package/src/components/ci-services.ts +82 -0
  832. package/src/components/cli-support.ts +23 -2
  833. package/src/components/driver.test.ts +3 -3
  834. package/src/components/driver.ts +73 -6
  835. package/src/components/fan-out-run.ts +68 -18
  836. package/src/components/groups.ts +21 -4
  837. package/src/components/plan-flags.test.ts +46 -0
  838. package/src/components/pr-comment-preview-targets.test.ts +34 -0
  839. package/src/components/pr-comment-preview.test.ts +54 -0
  840. package/src/components/pr-env-ledger.test.ts +9 -0
  841. package/src/components/pr-env-ledger.ts +42 -0
  842. package/src/components/pr-env-ports.ts +29 -4
  843. package/src/components/pr-env-run-bundle.test.ts +2 -14
  844. package/src/components/pr-env-run.test.ts +19 -0
  845. package/src/components/pr-env-run.ts +12 -2
  846. package/src/components/pr-environment.test.ts +29 -0
  847. package/src/components/pr-environment.ts +40 -8
  848. package/src/components/pr-pipeline-runners.test.ts +80 -0
  849. package/src/components/pr-pipeline.test.ts +15 -0
  850. package/src/components/pr-pipeline.ts +498 -18
  851. package/src/components/pr-policy.ts +45 -7
  852. package/src/components/pr-run.test.ts +1 -1
  853. package/src/components/pr-run.ts +138 -11
  854. package/src/components/pr-stale-job.test.ts +34 -0
  855. package/src/components/pr-targets.test.ts +35 -0
  856. package/src/components/pr-targets.ts +45 -0
  857. package/src/components/product-pipeline.test.ts +200 -0
  858. package/src/components/product-pipeline.ts +383 -0
  859. package/src/components/promote.ts +10 -1
  860. package/src/components/release-compile.ts +87 -1
  861. package/src/components/release-promote.ts +65 -1
  862. package/src/components/repo-lock.ts +52 -0
  863. package/src/components/row-lease.test.ts +490 -0
  864. package/src/components/row-lease.ts +167 -0
  865. package/src/components/wave-plan-policy.test.ts +19 -0
  866. package/src/components/wave-plan.ts +96 -6
  867. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  868. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  869. package/src/control/applied.test.ts +148 -0
  870. package/src/control/applied.ts +191 -0
  871. package/src/control/consumers.test.ts +129 -0
  872. package/src/control/consumers.ts +192 -0
  873. package/src/control/control.test.ts +302 -0
  874. package/src/control/dispatch.ts +699 -0
  875. package/src/control/edges.test.ts +112 -0
  876. package/src/control/edges.ts +164 -0
  877. package/src/control/note-checkout.test.ts +91 -0
  878. package/src/control/reconcile.ts +250 -0
  879. package/src/control/records.ts +395 -0
  880. package/src/discovery/sandbox/bundle.ts +25 -1
  881. package/src/e2e-harness/__project__/chant.config.ts +4 -0
  882. package/src/e2e-harness/__project__/src/compose.ts +33 -0
  883. package/src/e2e-harness/bucket.ts +69 -0
  884. package/src/e2e-harness/claim.test.ts +150 -0
  885. package/src/e2e-harness/claim.ts +140 -0
  886. package/src/e2e-harness/driver.test.ts +304 -0
  887. package/src/e2e-harness/driver.ts +294 -0
  888. package/src/e2e-harness/forgejo.ts +267 -0
  889. package/src/e2e-harness/git.ts +96 -0
  890. package/src/e2e-harness/index.ts +50 -0
  891. package/src/e2e-harness/jobs.ts +35 -0
  892. package/src/e2e-harness/pins.ts +52 -0
  893. package/src/e2e-harness/ports.ts +130 -0
  894. package/src/e2e-harness/reports.ts +79 -0
  895. package/src/e2e-harness/safe-run-cli.test.ts +102 -0
  896. package/src/e2e-harness/safe-run-cli.ts +54 -0
  897. package/src/e2e-harness/safe-run.ts +198 -0
  898. package/src/e2e-harness/scenario.ts +89 -0
  899. package/src/e2e-harness/schemas/README.md +62 -0
  900. package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  901. package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
  902. package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  903. package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  904. package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  905. package/src/e2e-harness/schemas/index.ts +220 -0
  906. package/src/e2e-harness/schemas.test.ts +145 -0
  907. package/src/e2e-harness/stack.test.ts +124 -0
  908. package/src/e2e-harness/stack.ts +306 -0
  909. package/src/e2e-harness/steps.ts +30 -0
  910. package/src/e2e-harness.ts +2 -0
  911. package/src/engine-facts.test.ts +2 -3
  912. package/src/engine-facts.ts +1 -2
  913. package/src/exit-codes.test.ts +32 -0
  914. package/src/exit-codes.ts +61 -0
  915. package/src/forge-check/check.ts +155 -0
  916. package/src/forge-check/contract.ts +215 -0
  917. package/src/forge-check/forge-check.test.ts +427 -0
  918. package/src/forge-check/forge.ts +318 -0
  919. package/src/forge-check/index.ts +43 -0
  920. package/src/forge-check/pulumi.ts +192 -0
  921. package/src/forge-check/read-only.ts +56 -0
  922. package/src/forge-check/trust.ts +527 -0
  923. package/src/forge-check/types.ts +78 -0
  924. package/src/forge-check.ts +5 -0
  925. package/src/gate-decision-bundle.test.ts +11 -0
  926. package/src/gate-decision.ts +3 -0
  927. package/src/gate-policy.ts +92 -3
  928. package/src/gated-waves-bundle.test.ts +0 -1
  929. package/src/index.ts +2 -0
  930. package/src/lexicon.ts +143 -6
  931. package/src/lifecycle/adoption-file.ts +1 -2
  932. package/src/lifecycle/cloud-index.test.ts +2 -3
  933. package/src/lifecycle/cloud-index.ts +1 -2
  934. package/src/lifecycle/control-entries-ledger.test.ts +69 -0
  935. package/src/lifecycle/gate-applied.ts +6 -0
  936. package/src/lifecycle/gate-ledger.ts +35 -1
  937. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  938. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  939. package/src/lifecycle/gated-request-digest.ts +49 -0
  940. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  941. package/src/lifecycle/gated-request.ts +279 -0
  942. package/src/lifecycle/identity-match.ts +25 -6
  943. package/src/lifecycle/index-diff.ts +1 -2
  944. package/src/lifecycle/index-document.ts +1 -2
  945. package/src/lifecycle/index-import.test.ts +14 -0
  946. package/src/lifecycle/index-import.ts +54 -34
  947. package/src/lifecycle/ledger-read.ts +7 -3
  948. package/src/lifecycle/lock-rows.test.ts +109 -0
  949. package/src/lifecycle/lock-rows.ts +167 -0
  950. package/src/lifecycle/publish-target-context.test.ts +108 -0
  951. package/src/lifecycle/query.test.ts +2 -3
  952. package/src/lifecycle/query.ts +109 -8
  953. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  954. package/src/lifecycle/release-catalog-site.ts +291 -0
  955. package/src/lifecycle/release-catalog.test.ts +192 -0
  956. package/src/lifecycle/release-catalog.ts +353 -0
  957. package/src/lifecycle/release-changelog.test.ts +70 -0
  958. package/src/lifecycle/release-changelog.ts +71 -0
  959. package/src/lifecycle/release-cut.ts +2 -2
  960. package/src/lifecycle/release-ledger.ts +19 -0
  961. package/src/lifecycle/release-publish.ts +45 -22
  962. package/src/lifecycle/release-read.ts +2 -0
  963. package/src/lifecycle/release-status.test.ts +185 -0
  964. package/src/lifecycle/release-status.ts +175 -0
  965. package/src/lifecycle/resource-lock.test.ts +175 -0
  966. package/src/lifecycle/resource-lock.ts +354 -0
  967. package/src/lifecycle/retention.ts +2 -0
  968. package/src/lifecycle/run-ledger.ts +7 -1
  969. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  970. package/src/lifecycle/snapshot-store.ts +1 -2
  971. package/src/lifecycle/target-lock.ts +24 -9
  972. package/src/lifecycle/wave-plans.ts +33 -5
  973. package/src/mcp/types.ts +7 -0
  974. package/src/notify-product.ts +76 -0
  975. package/src/notify-relay.test.ts +213 -0
  976. package/src/notify-relay.ts +407 -0
  977. package/src/notify.ts +95 -14
  978. package/src/object-store/azure-blob.ts +374 -0
  979. package/src/object-store/common.ts +133 -0
  980. package/src/object-store/errors.ts +26 -0
  981. package/src/object-store/from-env.ts +36 -0
  982. package/src/object-store/gcs.ts +436 -0
  983. package/src/object-store/index.ts +8 -0
  984. package/src/object-store/object-store.test.ts +130 -0
  985. package/src/object-store/s3.ts +350 -0
  986. package/src/op/activities/converge.ts +2 -1
  987. package/src/op/activities/index.ts +1 -1
  988. package/src/op/activities/review-agent.open.test.ts +78 -0
  989. package/src/op/activities/review-agent.test.ts +13 -0
  990. package/src/op/activities/review-agent.ts +89 -5
  991. package/src/op/approval-status.test.ts +134 -0
  992. package/src/op/approval-status.ts +235 -0
  993. package/src/op/gate-review.test.ts +2 -1
  994. package/src/op/gate.ts +81 -22
  995. package/src/op/generate-pipeline.ts +7 -1
  996. package/src/op/index.ts +23 -0
  997. package/src/op/op-waves-after-plan.test.ts +288 -0
  998. package/src/op/op-waves-after-plan.ts +238 -0
  999. package/src/op/op-waves-capability-spec.ts +133 -0
  1000. package/src/op/op-waves-capability.test.ts +217 -0
  1001. package/src/op/op-waves-capability.ts +370 -0
  1002. package/src/op/op-waves-events.ts +135 -0
  1003. package/src/op/op-waves-notify-words.test.ts +149 -0
  1004. package/src/op/op-waves-notify.ts +41 -16
  1005. package/src/op/op-waves-parallelism.test.ts +89 -0
  1006. package/src/op/op-waves-pull-request.test.ts +219 -0
  1007. package/src/op/op-waves-release-port.ts +64 -0
  1008. package/src/op/op-waves-release.test.ts +209 -0
  1009. package/src/op/op-waves-release.ts +132 -0
  1010. package/src/op/op-waves-run-record.test.ts +32 -0
  1011. package/src/op/op-waves-run.ts +1235 -52
  1012. package/src/op/op-waves-stand-down.test.ts +240 -0
  1013. package/src/op/op-waves-stand-down.ts +107 -0
  1014. package/src/op/op-waves-trace.test.ts +205 -0
  1015. package/src/op/op-waves.test.ts +112 -0
  1016. package/src/op/op-waves.ts +320 -22
  1017. package/src/op/runtime.ts +107 -0
  1018. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  1019. package/src/op/stage-hooks.ts +91 -12
  1020. package/src/op/steward-beside.ts +2 -1
  1021. package/src/op/types.ts +3 -2
  1022. package/src/otlp-metrics.ts +96 -0
  1023. package/src/otlp.test.ts +243 -0
  1024. package/src/otlp.ts +543 -0
  1025. package/src/override-gate-bundle.test.ts +2 -0
  1026. package/src/override-gate.ts +4 -0
  1027. package/src/parallelism.test.ts +38 -0
  1028. package/src/parallelism.ts +33 -0
  1029. package/src/policy-packs.ts +230 -0
  1030. package/src/policy-source.test.ts +256 -0
  1031. package/src/policy-source.ts +111 -0
  1032. package/src/pr-forge-bundle.test.ts +1 -1
  1033. package/src/pr-forge.ts +175 -33
  1034. package/src/pr-loop-bundle.test.ts +7 -3
  1035. package/src/pr-loop-narrowed.test.ts +63 -0
  1036. package/src/pr-loop-words.test.ts +155 -0
  1037. package/src/pr-loop.ts +398 -52
  1038. package/src/pr-merge.test.ts +100 -0
  1039. package/src/pr-merge.ts +105 -0
  1040. package/src/pr-post-stale.test.ts +163 -0
  1041. package/src/pr-post.ts +190 -5
  1042. package/src/pr-report-url.ts +61 -6
  1043. package/src/pr-requires.test.ts +37 -1
  1044. package/src/pr-requires.ts +16 -2
  1045. package/src/product-subpaths-plain-node.e2e.test.ts +212 -0
  1046. package/src/release-floors.ts +1 -1
  1047. package/src/run-event.ts +28 -1
  1048. package/src/scheduled-op-cloud.ts +68 -0
  1049. package/src/sorted-json.ts +17 -0
  1050. package/src/stage-hooks-bundle.test.ts +6 -0
  1051. package/src/terraform/credentials.test.ts +77 -0
  1052. package/src/terraform/credentials.ts +162 -0
  1053. package/src/utils.ts +2 -11
  1054. package/src/wave-loop-golden.test.ts +2 -1
  1055. package/src/wave-runtime.ts +2 -2
  1056. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  1057. package/src/workspace/ci-lock-grain.test.ts +31 -0
  1058. package/src/workspace/ci-lock-grain.ts +29 -0
  1059. package/src/workspace/ci-report-url.test.ts +1 -1
  1060. package/src/workspace/ci-run.test.ts +1 -1
  1061. package/src/workspace/ci-run.ts +10 -3
  1062. package/src/workspace/declaration.schema.json +27 -3
  1063. package/src/workspace/declaration.test.ts +1 -1
  1064. package/src/workspace/declaration.ts +26 -10
  1065. package/src/workspace/drift-cli.ts +8 -3
  1066. package/src/workspace/exit-cli.ts +2 -1
  1067. package/src/workspace/import-fetch.ts +4 -2
  1068. package/src/workspace/import-init.ts +4 -2
  1069. package/src/workspace/ledger.schema.json +7 -3
  1070. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  1071. package/src/workspace/pr-report.schema.json +79 -3
  1072. package/src/workspace/promote.ts +2 -1
  1073. package/src/workspace/records-cli.ts +3 -2
  1074. package/src/workspace/release-catalog.schema.json +277 -0
  1075. package/src/workspace/run-event.schema.json +18 -1
  1076. package/src/workspace/work-cli.ts +8 -2
  1077. package/src/workspace/workspace-run.ts +2 -1
package/src/cli/main.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  #!/usr/bin/env tsx
2
2
 
3
+ import { withProductWords, type CiProductWords, type CiProductWordsInput } from "../ci-product-words";
3
4
  import { resolve } from "node:path";
4
5
  import { isEntryPoint } from "./is-entry-point";
5
6
  import { formatSuccess, formatError } from "./format";
@@ -225,8 +226,8 @@ Commands:
225
226
  --all-projects)
226
227
  migrate <file> Translate a workflow between lexicons
227
228
  (default: --from github --to gitlab)
228
- carve advise Read-only peelability advisor: rank which resources
229
- --from <dir> are cheap to carve into native chant
229
+ carve advise Read-only advisor: ranks which resources move
230
+ --from <dir> cleanly to a native lexicon
230
231
  (--json, --report <path>). Emits nothing, changes nothing.
231
232
  --from a Terraform dir needs @cdktn/hcl2json
232
233
  (npm install -D @cdktn/hcl2json); --from a CDK cloud
@@ -257,7 +258,33 @@ Commands:
257
258
  (--json) its target, stage (planned/emitted/bridged/
258
259
  applied) and path. Read-only.
259
260
 
261
+ E2E harness:
262
+ e2e safe-run [--scan <dir>]... -- <command...>
263
+ Run <command> with no real cloud in reach (cloud credential
264
+ variables unset, empty CLOUDSDK_CONFIG, file:// Pulumi
265
+ backend), then scan its output and each --scan dir. Prints
266
+ CLEAN, or the rejecting lines and exits 3.
267
+
260
268
  CI:
269
+ ci check --base <rev> [<target>...] [--output <dir>] [--json]
270
+ Run the ci.hooks.check hooks the workspace declaration
271
+ at --base names, once each, or once per target with
272
+ perRun, with no forge token or cloud credentials in
273
+ their environment. Writes check-hooks.json under
274
+ --output (default .chant/check); exits 1 when one failed.
275
+ ci check-job The apply-job guard: compare the forge environment,
276
+ ref and runner the forge gives this job with the
277
+ expectation in CHANT_JOB_GUARD, which a generated
278
+ op-wave job carries. Exits 1, one line per value
279
+ that differs, before any credential is taken.
280
+ ci forge-check [--env <env>] [--member <name>] [--forge <forge>] [--repo <owner/name>] [--branch <default>] [--require-clouds] [--json]
281
+ Read the forge, each cloud's trust policy and Pulumi
282
+ Cloud's OIDC policies against the pipelines
283
+ ci.identity.cloud gives --env (default production):
284
+ apply environments, branch protection, required
285
+ statuses, and each identity trusted to its own jobs.
286
+ Read-only; exits 1 on a mismatch, and with
287
+ --require-clouds on a cloud it had no credentials for.
261
288
  ci last-green [--json] [--from <rev>] The newest first-parent commit of
262
289
  ci.green's branch, or of --from, with a ci/green tag
263
290
  and no ci/revoked tag. Reads local tags only; fetch
@@ -504,7 +531,21 @@ Ops:
504
531
  --group <name> applies one job group's runs.
505
532
  --record-plans (no --wave), in a pull request's
506
533
  pipeline: plan every wave at its head and record the
507
- digests a pr-review approval mode compares
534
+ digests a pr-review approval mode compares.
535
+ --approval-status (no --wave) --forge <kind>
536
+ --pr <n> --head <sha> --base <sha>, or --open
537
+ [--branch <b>]: post <product>/approval on an open
538
+ pull request's head, pending while a wave its gate
539
+ will hold has no approval: an approving review for
540
+ pr-review, the pull request's own approval covering
541
+ its change set for pull-request (#4630).
542
+ --waves-outcome (no --wave), after the last wave:
543
+ print how the wave jobs' outcome files add up
544
+ (applied, partial, unchanged, waiting, failed), the
545
+ outcome a control dispatch carries (#4617)
546
+ --events-json streams the job's run events (#4555);
547
+ with OTEL_EXPORTER_OTLP_ENDPOINT set, the job sends
548
+ its trace there
508
549
  run resume [--op <name>] [--gate <name>] Start again each CI job that
509
550
  waits at a gate an approval now answers, through the
510
551
  forge's API (#3683); approves nothing. --gate resumes
@@ -513,6 +554,10 @@ Ops:
513
554
  stopped once its run is gone (#3858). --dry-run
514
555
  starts nothing; with --json it says per gate whether
515
556
  it would resume and why
557
+ run pending --plan <digest> [--op <name>] List the gates waiting on a
558
+ plan digest, newest first, with the pull request a
559
+ pr-<n> gate belongs to (#4607). --json prints
560
+ { plan, gates }
516
561
  run --generate <provider> Write one CI pipeline file per scheduled Op for
517
562
  github, gitlab or forgejo (#2533), from every Op that
518
563
  declares a schedule or from --spec <file.json>.
@@ -538,6 +583,15 @@ Ops:
538
583
  commit and runtime on every line (#4041). Also on
539
584
  run <op>, components promote|rollback|redeploy,
540
585
  fan-out, pr-plan and pr-apply
586
+ --adopt <adoption-file>: one component's cfn-deploy
587
+ step adopts the file's indexed resources into its
588
+ stack: an IMPORT change set without markers, then a
589
+ tags-only UPDATE that writes them. Each change set
590
+ is shown and asked about before it runs (--yes
591
+ approves; with no terminal and no --yes, nothing
592
+ runs). If the marker step stops after a good import,
593
+ a plain deploy of the same template writes the
594
+ markers (#4537)
541
595
  operator Run scheduled ticks for discovered ConvergeOps
542
596
  locally (#1485): acquire/renew a per-op
543
597
  lease (git ref CAS), tick on --interval, record every
@@ -581,6 +635,12 @@ Ops:
581
635
  --resume then starts the CI job that waits at the
582
636
  gate again (GitHub re-run, GitLab retry, Forgejo
583
637
  dispatch) with CHANT_FORGE_TOKEN
638
+ At a terminal it shows the stored plan and asks you
639
+ to type the target's name (the environment, else the
640
+ gate) before recording; a wrong answer exits 8, a
641
+ plan that moved while you were asked exits 4.
642
+ --yes, --json, CI and no terminal record as before
643
+ (#4575)
584
644
  On op policy-override the gate is the subject a
585
645
  policy denied: --rule <id> names each rule that
586
646
  denied it and --reason <text> says why the plan goes
@@ -588,6 +648,25 @@ Ops:
588
648
  applies it once, if .chant/overriders at base lists
589
649
  --actor
590
650
 
651
+ audit-log attribute --input <drift.json> [--audit-log aws[:<region>]]
652
+ Name who changed each drifted attribute of a drift
653
+ document: a known write by design, else the cloud
654
+ audit log's last writer (#4632)
655
+ audit-log unrecorded --audit-log aws[:<region>] --op <op>[,...] --since <time>
656
+ Report the audit log's writes no recorded apply on
657
+ the run ledger made; exits 2 when there are some
658
+ (#4632)
659
+ notify relay Serve the relay that approves a waiting gate from a
660
+ Slack button or a Teams reply (#4611): verifies the
661
+ chat signature and the button's notify reference,
662
+ maps the clicker through the signers file at base,
663
+ and records chant approve --plan <digest> --actor
664
+ <principal> --relayed-by <relay>. Settings come from
665
+ CHANT_RELAY_KEY, SLACK_SIGNING_SECRET,
666
+ TEAMS_WEBHOOK_SECRET, CHANT_RELAY_PRINCIPAL,
667
+ CHANT_RELAY_MAX_AGE, CHANT_RELAY_HOST (default
668
+ 127.0.0.1) and CHANT_RELAY_PORT (default 8787)
669
+
591
670
  lock <target>... Lock targets for a pull request on chant/lifecycle
592
671
  (--pr <n>, --stage plan|apply|lock, --head <sha>,
593
672
  --by <who>, --gate <name>, --json). --from-report
@@ -632,9 +711,9 @@ Workspace (level 1, #2524):
632
711
  the catalog-info.yaml files under dir, and shows what
633
712
  it left out (#3178)
634
713
  workspace promote <member> [--state <tfstate>] [--lexicon <name>] [--dry-run] [--output <patch>] [--json]
635
- Move a member one rung up the kind ladder (terraform to
636
- choudoufu runs live-check and the adoption report;
637
- choudoufu or other to chant runs chant import), staged
714
+ Change a member's kind (terraform to choudoufu runs
715
+ live-check and the adoption report; choudoufu or
716
+ other to chant runs chant import), staged
638
717
  in a worktree and gated on the patch digest like upgrade
639
718
  workspace promote --all [--state-dir <dir>] [--state <member>=<tfstate>]... [--canary <member>] [--wave-size <n>] [--dry-run] [--json]
640
719
  Adopt every terraform member into choudoufu in waves:
@@ -1126,6 +1205,16 @@ Component release ledger + status:
1126
1205
  the ones that depend on them, and write the
1127
1206
  report and note (--base <ref> --pr <n>
1128
1207
  [--forge github|gitlab|forgejo] posts them);
1208
+ --target <address> narrows every member's plan
1209
+ to the address, --target <member>:<address>
1210
+ one member's (#4620); --comment-targets adds the
1211
+ --target addresses of the preview comment in
1212
+ CHANT_PREVIEW_COMMENT (#4626); --refresh refreshes
1213
+ each step's state first and --target-dependents
1214
+ plans what depends on each target too, refused
1215
+ by name for a step that cannot (#4627);
1216
+ --parallelism <n> plans at
1217
+ most n members of a wave at once (#4625);
1129
1218
  applies nothing
1130
1219
  components pr-post Post the plan note and the chant/plan status
1131
1220
  from the report pr-plan --no-status wrote
@@ -1133,12 +1222,22 @@ Component release ledger + status:
1133
1222
  <kind>), in a job that runs none of the
1134
1223
  change's code (#4295); --open posts every
1135
1224
  open merge request's from a GitLab pipeline
1136
- of the target branch (#4328)
1225
+ of the target branch (#4328); --respond
1226
+ description=check --decide-backend <name>
1227
+ --decide-model <id> asks whether the
1228
+ description leaves out a destroy or a
1229
+ replacement and posts the finding (#4629)
1137
1230
  components pr-record On merge (#4168): plan the same members again,
1138
1231
  store the change set and write the merge record
1139
1232
  _merges/<commit>.json; applies and refuses
1140
1233
  nothing, and a plan that differs from the
1141
1234
  approved one sets a failing chant/record status
1235
+ agent prepare|run|land The agent jobs (#4616) the Op generator writes for
1236
+ a spec's agent: prepare decides from the comment or
1237
+ the drift check and the ledger's run count, run
1238
+ runs the model command with no forge token, land
1239
+ pushes the change, opens or updates the pull
1240
+ request and records the run (--forge <kind>)
1142
1241
  components pr-env An environment per open pull request (#4298): up
1143
1242
  --base <ref> --pr <n> applies the change to pr-<n>,
1144
1243
  derived from ci.prEnvironment.template, once an
@@ -1159,10 +1258,10 @@ Component release ledger + status:
1159
1258
  member's loop, gate op pr-<n>-<member>;
1160
1259
  --resume <file> finishes an apply that failed
1161
1260
  partway under the same approval;
1162
- --wave-gate <name>: apply a wave at a time, each
1163
- planned after the one before applied, a moved
1164
- wave waiting at <name>-wave-<k>, with --wave <k>
1165
- for one wave per CI job;
1261
+ --wave-gate <name>: apply a wave at a time on op
1262
+ waves, each planned after the one before applied,
1263
+ a moved wave waiting at <name>-wave-<k>, with
1264
+ --wave <k> for one wave per CI job;
1166
1265
  --green: apply the green commit at HEAD, measured
1167
1266
  from the one last applied to --env, under the
1168
1267
  approved plans of the merges since, else at gate
@@ -1172,10 +1271,30 @@ Component release ledger + status:
1172
1271
  declaration at base sets ci.workflow to
1173
1272
  apply-before-merge and the forge says it is
1174
1273
  approved, mergeable, undiverged and green;
1274
+ --requires <list> asks only the checks it
1275
+ names (approved,mergeable,undiverged,checks);
1276
+ --merge auto --merge-token-env <VAR> merges the
1277
+ pull request once every member applied and the
1278
+ records are pushed, with that token alone and
1279
+ the applied head checked again (#4636);
1280
+ --respond <list> turns the failed apply's
1281
+ triage and the refused apply's diff on or off
1282
+ (wave-refused=diff|off,apply-failed=triage|off,
1283
+ #4629);
1175
1284
  --events-json, both commands: the run-event
1176
1285
  stream on stdout; --report-url <s3 or file URL>,
1177
1286
  both commands: copy the report, the change set
1178
1287
  and the events to <url>/<pr>/<commit>/)
1288
+ components plan-wave --runs <file> --plans <file> --base <ref> --env <env>
1289
+ Plan one op wave's components through their
1290
+ capabilities and write the wave's plans file
1291
+ with its change set (#4588); --wave-outputs
1292
+ <file> seeds the outputs earlier waves left
1293
+ components apply-wave --runs <file> --plans <file> --base <ref> --env <env>
1294
+ Plan the approved runs again, exit 4 when a plan
1295
+ moved, else apply them and add their outputs to
1296
+ --wave-outputs (#4588). Both are the steps of the
1297
+ waves pr-apply --wave-gate runs on op waves
1179
1298
  components release <env> Append one immutable release record
1180
1299
  (--component <name> --digest <sha256:...>
1181
1300
  [--git-sha <sha>] [--run-id <id>] [--actor <name>]);
@@ -1242,7 +1361,8 @@ Local:
1242
1361
 
1243
1362
  Servers:
1244
1363
  serve lsp Start the LSP server (stdio)
1245
- serve mcp Start the MCP server (stdio)
1364
+ serve mcp Start the MCP server (stdio); --read-only serves only
1365
+ the tools that read (ledger, graph, runs) and run nothing
1246
1366
 
1247
1367
  Project:
1248
1368
  update (alias: sync) Sync lexicon types into .chant/types/ (does not install
@@ -1269,6 +1389,7 @@ Options:
1269
1389
  records its lineage in .chant/workspace.lock.json
1270
1390
  --skill <name> Init: install only this skill from the lexicon
1271
1391
  --skip-mcp Init: scaffold without writing the project's .mcp.json
1392
+ --mcp-read-only Init: register \`chant serve mcp --read-only\` in .mcp.json
1272
1393
  --fix Auto-fix fixable issues (lint command)
1273
1394
  --force Force overwrite existing files (import command)
1274
1395
  -w, --watch Watch for changes and rebuild/re-lint (build, lint)
@@ -1548,8 +1669,32 @@ function commandRunsNoConfig(def: CommandDef, args: ParsedArgs): boolean {
1548
1669
  * checked, plugins are loaded when the command needs them, and the handler
1549
1670
  * runs. A `process.exit` inside (loadPluginsOrExit's, say) is the caller's to
1550
1671
  * catch.
1672
+ *
1673
+ * `words` (#4550) are a CI product's words (`@intentius/chant/ci-product`):
1674
+ * the product's bin passes them, so the command renders in the product's
1675
+ * words while it runs. `mcp` (#4555) is its tool hook, which `chant serve
1676
+ * mcp` serves beside chant's own tools.
1551
1677
  */
1552
- export async function runCommandInProcess(argv: string[]): Promise<number> {
1678
+ export async function runCommandInProcess(
1679
+ argv: string[],
1680
+ options: { words?: CiProductWordsInput | CiProductWords; mcp?: import("./mcp/product-tools").ProductMcpHook; wave?: import("../op/op-waves-after-plan").ProductWaveHook } = {},
1681
+ ): Promise<number> {
1682
+ // #4614: a product's after-plan hooks and capabilities on `chant run wave`, in its own process.
1683
+ if (options.wave) {
1684
+ const { withProductWaveHook } = await import("../op/op-waves-after-plan");
1685
+ const { wave, ...rest } = options;
1686
+ return withProductWaveHook(wave, () => runCommandInProcess(argv, rest));
1687
+ }
1688
+ // #4555: a product's tools on `chant serve mcp`, through its tool hook.
1689
+ if (options.mcp) {
1690
+ const { withProductMcpHook } = await import("./mcp/product-tools");
1691
+ const { mcp, ...rest } = options;
1692
+ return withProductMcpHook(mcp, () => runCommandInProcess(argv, rest));
1693
+ }
1694
+ // #4550: a product's bin calls chant with its words; every status, note and
1695
+ // approve line the command writes takes them, and the earlier words come
1696
+ // back once it settles.
1697
+ if (options.words) return withProductWords(options.words, () => runCommandInProcess(argv));
1553
1698
  const args = parseArgs(argv);
1554
1699
  const match = resolveCommand(args, commandRegistry);
1555
1700
  if (!match) {
@@ -1624,11 +1769,20 @@ export const commandRegistry: CommandDef[] = [
1624
1769
  // renderer replaces its own walk-and-guess discovery with. Read-only.
1625
1770
  { name: "carve status", handler: runCarveStatus },
1626
1771
  // #3573 — which commits passed CI, kept as ci/green and ci/revoked tags (ws-103). Imported on first use.
1772
+ // chant#4587 (C1) — the e2e harness's no-real-cloud wrapper as a command, for bash drivers. Imported on first use.
1773
+ { name: "e2e safe-run", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/e2e-safe-run")).runE2eSafeRun(ctx) },
1774
+ { name: "e2e", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/e2e-safe-run")).runE2eUnknown(ctx) },
1627
1775
  { name: "ci last-green", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli")).runCiLastGreen(ctx) },
1628
1776
  { name: "ci list", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli")).runCiList(ctx) },
1629
1777
  { name: "ci tick", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli")).runCiTick(ctx) },
1630
1778
  { name: "ci workflow", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli")).runCiWorkflow(ctx) },
1631
1779
  { name: "ci init", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-init")).runCiInit(ctx) },
1780
+ // #4556: the ci.hooks.check hooks at base, for a product's check job.
1781
+ { name: "ci check", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-check")).runCiCheck(ctx) },
1782
+ // #4608: the live forge, cloud trust policies and Pulumi Cloud's OIDC policies against ci.identity.cloud. Read-only.
1783
+ // #4624: the apply-job guard, from the expectation the job carries.
1784
+ { name: "ci check-job", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-check-job")).runCiCheckJob(ctx) },
1785
+ { name: "ci forge-check", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-forge-check")).runCiForgeCheck(ctx) },
1632
1786
  // #4094: one pull-request job as a pipeline Op in a fresh checkout, the chant runner's first slice.
1633
1787
  { name: "ci run", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-run")).runCiRun(ctx) },
1634
1788
  // #4098: the run index at the report URL.
@@ -1678,6 +1832,8 @@ export const commandRegistry: CommandDef[] = [
1678
1832
  { name: "run wave", handler: runOpWaveCommand },
1679
1833
  // #3683 — start the CI jobs that wait at gates whose approval arrived. Imported on first use.
1680
1834
  { name: "run resume", handler: async (ctx) => (await import("./handlers/gate-resume")).runResumeCommand(ctx) },
1835
+ // #4607 — the pending gates a plan digest waits at, with their pull request. Imported on first use.
1836
+ { name: "run pending", handler: async (ctx) => (await import("./handlers/gate-pending")).runPendingCommand(ctx) },
1681
1837
  { name: "run", handler: runOp },
1682
1838
 
1683
1839
  { name: "operator status", handler: runOperatorStatus },
@@ -1685,6 +1841,10 @@ export const commandRegistry: CommandDef[] = [
1685
1841
  { name: "operator", handler: runOperator },
1686
1842
  { name: "approve", handler: runApprove },
1687
1843
  // #4293 — target locks a pull request holds on chant/lifecycle. Imported on first use.
1844
+ // #4611 — approve a waiting gate from a chat click. Imported on first use.
1845
+ { name: "audit-log attribute", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/audit-log")).runAuditLogAttribute(ctx) },
1846
+ { name: "audit-log unrecorded", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/audit-log")).runAuditLogUnrecorded(ctx) },
1847
+ { name: "notify relay", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/notify-relay")).runNotifyRelay(ctx) },
1688
1848
  { name: "lock", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/lock")).runLock(ctx) },
1689
1849
  { name: "unlock", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/lock")).runUnlock(ctx) },
1690
1850
 
@@ -1787,9 +1947,16 @@ export const commandRegistry: CommandDef[] = [
1787
1947
  // #3183 — the pull-request loop the generated CI runs. Imported on first use.
1788
1948
  { name: "components pr-plan", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrPlan(ctx) },
1789
1949
  { name: "components pr-apply", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrApply(ctx) },
1950
+ // #4588: the component plan-wave and apply-wave steps a component waves spec runs (pr-apply --wave-gate on op waves).
1951
+ { name: "components plan-wave", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPlanWave(ctx) },
1952
+ { name: "components apply-wave", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsApplyWave(ctx) },
1790
1953
  // #4295: posts from the plan report in a job that runs none of the change's code, so it loads no plugins.
1791
1954
  { name: "components pr-post", handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrPost(ctx) },
1792
1955
  { name: "components pr-record", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrRecord(ctx) },
1956
+ // #4616: the agent jobs' three steps. Imported on first use; none loads plugins.
1957
+ { name: "agent prepare", handler: async (ctx) => (await import("./handlers/agent")).runAgentCommandLine(ctx) },
1958
+ { name: "agent run", handler: async (ctx) => (await import("./handlers/agent")).runAgentCommandLine(ctx) },
1959
+ { name: "agent land", handler: async (ctx) => (await import("./handlers/agent")).runAgentCommandLine(ctx) },
1793
1960
  { name: "components pr-env", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr-env")).runComponentsPrEnv(ctx) },
1794
1961
  { name: "components status", requiresPlugins: true, handler: runComponentsStatus },
1795
1962
  { name: "components release", handler: runComponentsReleaseRecord },
@@ -0,0 +1,126 @@
1
+ /**
2
+ * chant#4543 — the ledger reads of `chant serve mcp`: `ledger` and `query`.
3
+ *
4
+ * Served in both modes, and the reason the read-only mode is worth starting:
5
+ * an agent gets the runs, gates, deploys, releases, cuts, resources and
6
+ * snapshots on `chant/lifecycle` and the index store without a tool that can
7
+ * change any of them.
8
+ *
9
+ * Each runs the CLI with the chant this server runs as, in the server's
10
+ * directory, and returns the JSON document it printed, unchanged, the way the
11
+ * workspace reads do (./workspace-tools.ts {@link runRead}):
12
+ *
13
+ * - `ledger` runs `chant ledger <table> ... --json`, the ledger read contract
14
+ * (`../handlers/ledger.ts`, #4363).
15
+ * - `query` runs `chant query -- <sql> --json`, one read-only SQL statement
16
+ * over the same ledgers (`../handlers/query.ts`, #4297). The engine refuses
17
+ * anything but a read.
18
+ *
19
+ * Both read the local branch and never fetch.
20
+ */
21
+
22
+ import type { ToolDefinition, ToolHandler } from "./types";
23
+ import { ownChantCommand, runRead, type ChantCommand } from "./workspace-tools";
24
+
25
+ /** The tables `chant ledger` reads, in its usage order. */
26
+ export const LEDGER_TABLES = ["resources", "snapshots", "runs", "gates", "deploys", "releases", "cuts"] as const;
27
+
28
+ class ToolInputError extends Error {}
29
+
30
+ function str(params: Record<string, unknown>, key: string, required = false): string | undefined {
31
+ const v = params[key];
32
+ if (v === undefined || v === null) {
33
+ if (required) throw new ToolInputError(`${key} is required`);
34
+ return undefined;
35
+ }
36
+ if (typeof v !== "string" || v === "") throw new ToolInputError(`${key} must be a non-empty string`);
37
+ // A value is passed as one argument; one that starts with - would read as a flag.
38
+ if (v.startsWith("-")) throw new ToolInputError(`${key} may not start with -: ${JSON.stringify(v)}`);
39
+ return v;
40
+ }
41
+
42
+ function list(params: Record<string, unknown>, key: string): string[] {
43
+ const v = params[key];
44
+ if (v === undefined || v === null) return [];
45
+ const items = typeof v === "string" ? [v] : v;
46
+ if (!Array.isArray(items)) throw new ToolInputError(`${key} must be a string, or a list of them`);
47
+ return items.map((item, i) => str({ [`${key}[${i}]`]: item }, `${key}[${i}]`, true)!);
48
+ }
49
+
50
+ const memberProp = {
51
+ type: "array",
52
+ items: { type: "string" },
53
+ description: "Only these workspace members' ledgers (--member). Outside a workspace the project's own ledger is read.",
54
+ };
55
+
56
+ export const ledgerReadTools: ToolDefinition[] = [
57
+ {
58
+ name: "ledger",
59
+ description:
60
+ "One ledger's rows from the local chant/lifecycle branch: chant ledger <table> --json (#4363). Tables: " +
61
+ LEDGER_TABLES.join(", ") +
62
+ ". Inside a workspace every member's ledger is read and each row names its member. Returns the document unchanged; an error document is a document.",
63
+ inputSchema: {
64
+ type: "object",
65
+ properties: {
66
+ table: { type: "string", enum: [...LEDGER_TABLES], description: "The ledger to read." },
67
+ member: memberProp,
68
+ where: {
69
+ type: "array",
70
+ items: { type: "string" },
71
+ description: "Typed filters, each <field><op><value> such as state=failed (--where, repeatable).",
72
+ },
73
+ since: { type: "string", description: "Only rows at or after this time (--since)." },
74
+ at: { type: "string", description: "Read the ledger as this commit of chant/lifecycle held it (--at)." },
75
+ },
76
+ required: ["table"],
77
+ },
78
+ },
79
+ {
80
+ name: "query",
81
+ description:
82
+ "One read-only SQL statement over the snapshots in the index store and the Op runs, gates, deploys and releases on the local chant/lifecycle branch: chant query <sql> --json (#4297). A statement that writes is refused. Returns the document unchanged.",
83
+ inputSchema: {
84
+ type: "object",
85
+ properties: {
86
+ sql: { type: "string", description: "The SQL statement." },
87
+ member: memberProp,
88
+ },
89
+ required: ["sql"],
90
+ },
91
+ },
92
+ ];
93
+
94
+ /** The `chant` arguments each ledger tool runs, from its input. */
95
+ export function ledgerArgv(tool: string, params: Record<string, unknown>): string[] {
96
+ const members = list(params, "member").flatMap((m) => ["--member", m]);
97
+ switch (tool) {
98
+ case "ledger": {
99
+ const table = str(params, "table", true)!;
100
+ if (!(LEDGER_TABLES as readonly string[]).includes(table)) throw new ToolInputError(`table must be one of ${LEDGER_TABLES.join(", ")}`);
101
+ const where = list(params, "where").flatMap((w) => ["--where", w]);
102
+ const flags = (["since", "at"] as const).flatMap((f) => {
103
+ const v = str(params, f);
104
+ return v !== undefined ? [`--${f}`, v] : [];
105
+ });
106
+ return ["ledger", table, ...members, ...where, ...flags, "--json"];
107
+ }
108
+ case "query": {
109
+ // The statement is one argument after `--`, so text that opens with - stays SQL.
110
+ const sql = params.sql;
111
+ if (typeof sql !== "string" || sql.trim() === "") throw new ToolInputError("sql must be a non-empty string");
112
+ return ["query", ...members, "--json", "--", sql];
113
+ }
114
+ default:
115
+ throw new ToolInputError(`${tool} is not a ledger read tool`);
116
+ }
117
+ }
118
+
119
+ /** The ledger read tools, bound to the server's directory. */
120
+ export function createLedgerTools(options: { cwd: string; chantCommand?: ChantCommand }): { definition: ToolDefinition; handler: ToolHandler }[] {
121
+ const chant = options.chantCommand ?? ownChantCommand();
122
+ return ledgerReadTools.map((definition) => ({
123
+ definition,
124
+ handler: async (params) => runRead(chant, ledgerArgv(definition.name, params), options.cwd),
125
+ }));
126
+ }
@@ -0,0 +1,123 @@
1
+ /**
2
+ * chant#4555: a CI product's tools on `chant serve mcp` through the product
3
+ * tool hook, read-only by default, and the `report` tool's read of the
4
+ * report store.
5
+ */
6
+
7
+ import { describe, expect, test } from "vitest";
8
+ import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
9
+ import { join } from "node:path";
10
+ import { tmpdir } from "node:os";
11
+ import { pathToFileURL } from "node:url";
12
+ import { McpServer } from "./server";
13
+ import { productToolWriteWord, ProductToolRefusedError, type ProductMcpHook } from "./product-tools";
14
+ import { reportReader, reportToolKey, safeReportKey } from "./report-tools";
15
+ import type { ToolDefinition } from "./types";
16
+ import type { McpToolContribution } from "../../mcp/types";
17
+
18
+ const tool = (name: string, readOnly?: boolean, handler: McpToolContribution["handler"] = async () => ({ name })): McpToolContribution => ({
19
+ name,
20
+ description: name,
21
+ inputSchema: { type: "object", properties: {} },
22
+ handler,
23
+ ...(readOnly !== undefined ? { readOnly } : {}),
24
+ });
25
+
26
+ async function listed(server: McpServer): Promise<string[]> {
27
+ const res = await server.handleRequest({ jsonrpc: "2.0", id: 1, method: "tools/list" });
28
+ return (res.result as { tools: ToolDefinition[] }).tools.map((t) => t.name);
29
+ }
30
+
31
+ async function call(server: McpServer, name: string, args: Record<string, unknown> = {}): Promise<{ text: string; isError?: boolean }> {
32
+ const res = await server.handleRequest({ jsonrpc: "2.0", id: 2, method: "tools/call", params: { name, arguments: args } });
33
+ const r = res.result as { content: Array<{ text: string }>; isError?: boolean };
34
+ return { text: r.content[0]!.text, ...(r.isError ? { isError: true } : {}) };
35
+ }
36
+
37
+ describe("the product tool hook (#4555)", () => {
38
+ test("a server started through the hook is read-only, and serves only the product tools that say they read", async () => {
39
+ const hook: ProductMcpHook = { product: "terragucci", tools: () => [tool("waiting", true), tool("estate", true), tool("drift_scan")] };
40
+ const server = new McpServer([], { product: hook });
41
+ expect(server.readOnly).toBe(true);
42
+ const names = await listed(server);
43
+ expect(names).toContain("terragucci:waiting");
44
+ expect(names).toContain("terragucci:estate");
45
+ expect(names).not.toContain("terragucci:drift_scan");
46
+ // chant's mutating core tools stay out too.
47
+ expect(names).not.toContain("op-run");
48
+ expect(names).not.toContain("op-approve");
49
+ expect(names).toContain("report");
50
+ expect(JSON.parse((await call(server, "terragucci:waiting")).text)).toEqual({ name: "waiting" });
51
+ });
52
+
53
+ test("a read-only server will not start with a product tool named as a write (assertReadOnly)", () => {
54
+ for (const name of ["apply_wave", "wave_approve", "unlock", "push_branch", "terragucci:merge_pr"]) {
55
+ expect(() => new McpServer([], { product: { product: "terragucci", tools: () => [tool(name, true)] } }), name).toThrow(ProductToolRefusedError);
56
+ }
57
+ expect(productToolWriteWord("last_apply")).toBeUndefined();
58
+ expect(productToolWriteWord("audit")).toBeUndefined();
59
+ expect(productToolWriteWord("apply_wave")).toBe("apply");
60
+ expect(productToolWriteWord("wave_approve")).toBe("approve");
61
+ });
62
+
63
+ test("readOnly: false on the hook starts an ordinary server with every product tool; --read-only wins over it", async () => {
64
+ const tools = () => [tool("propose"), tool("waiting", true)];
65
+ const open = new McpServer([], { product: { product: "plywood", tools, readOnly: false } });
66
+ expect(open.readOnly).toBe(false);
67
+ expect(await listed(open)).toEqual(expect.arrayContaining(["plywood:propose", "plywood:waiting", "op-run"]));
68
+ const closed = new McpServer([], { readOnly: true, product: { product: "plywood", tools, readOnly: false } });
69
+ expect(await listed(closed)).not.toContain("plywood:propose");
70
+ });
71
+
72
+ test("a product name that is not a word is refused, and the hook's instructions reach initialize", async () => {
73
+ expect(() => new McpServer([], { product: { product: "Ply Wood", tools: () => [] } })).toThrow(/not a product name/);
74
+ const server = new McpServer([], { product: { product: "plywood", tools: () => [], instructions: "plywood reads stacks." } });
75
+ const res = await server.handleRequest({ jsonrpc: "2.0", id: 1, method: "initialize", params: {} });
76
+ expect((res.result as { instructions: string }).instructions).toMatch(/^plywood reads stacks\.\n\n.*read-only/s);
77
+ });
78
+
79
+ test("a product tool reads the report store through its context, and cannot write it", async () => {
80
+ const dir = mkdtempSync(join(tmpdir(), "product-tools-"));
81
+ mkdirSync(join(dir, "7", "c".repeat(40)), { recursive: true });
82
+ writeFileSync(join(dir, "7", "c".repeat(40), "pr-plan.json"), JSON.stringify({ status: "planned" }));
83
+ let read: string | null | undefined;
84
+ const hook: ProductMcpHook = {
85
+ product: "plywood",
86
+ reportUrl: pathToFileURL(dir).href,
87
+ tools: (ctx) => [
88
+ tool("plan_report", true, async () => {
89
+ const reports = await ctx.reports();
90
+ read = await reports!.read(`7/${"c".repeat(40)}/pr-plan.json`);
91
+ return { read };
92
+ }),
93
+ ],
94
+ };
95
+ const server = new McpServer([], { product: hook });
96
+ await call(server, "plywood:plan_report");
97
+ expect(read).toBe(JSON.stringify({ status: "planned" }));
98
+ expect("put" in reportReader(pathToFileURL(dir).href)).toBe(false);
99
+
100
+ // The core `report` tool reads the same store by pull request, commit and file.
101
+ const got = await call(server, "report", { pr: "7", commit: "c".repeat(40), file: "pr-plan.json" });
102
+ expect(JSON.parse(got.text)).toMatchObject({ key: `7/${"c".repeat(40)}/pr-plan.json`, document: { status: "planned" } });
103
+ expect((await call(server, "report", { pr: "7", commit: "c".repeat(40), file: "pr-apply.json" })).isError).toBe(true);
104
+ rmSync(dir, { recursive: true, force: true });
105
+ });
106
+ });
107
+
108
+ describe("the report tool's keys (#4555)", () => {
109
+ test("take a pull request, a commit, an optional member and one of the stage files", () => {
110
+ expect(reportToolKey({ pr: "12", commit: "a".repeat(40), file: "change-set.json" })).toBe(`12/${"a".repeat(40)}/change-set.json`);
111
+ expect(reportToolKey({ pr: 12, commit: "a".repeat(40), member: "web", file: "pr-apply.events.jsonl" })).toBe(`12/${"a".repeat(40)}/web/pr-apply.events.jsonl`);
112
+ expect(reportToolKey({ pr: "unknown", commit: "a".repeat(40), file: "pr-apply.json" })).toBe(`unknown/${"a".repeat(40)}/pr-apply.json`);
113
+ });
114
+
115
+ test("refuse anything that would leave the report URL, and any argument they do not list", () => {
116
+ expect(() => reportToolKey({ pr: "../x", commit: "a".repeat(40), file: "pr-plan.json" })).toThrow(/pull request number/);
117
+ expect(() => reportToolKey({ pr: "1", commit: "a".repeat(40), member: "..", file: "pr-plan.json" })).toThrow(/member/);
118
+ expect(() => reportToolKey({ pr: "1", commit: "a".repeat(40), file: "../../secret" })).toThrow(/file must be one of/);
119
+ expect(() => reportToolKey({ pr: "1", commit: "a".repeat(40), file: "pr-plan.json", token: "x" })).toThrow(/takes no argument token/);
120
+ expect(() => safeReportKey("a/../b")).toThrow(/not a path below/);
121
+ expect(safeReportKey("/a/b/")).toBe("a/b");
122
+ });
123
+ });