@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
@@ -0,0 +1,412 @@
1
+ /**
2
+ * Responses to pipeline events (#4629), in CI core so terragucci and plywood
3
+ * answer the same events the same way, each in its own words.
4
+ *
5
+ * - `wave-refused: diff`: a wave that applied nothing because its plan moved
6
+ * since the approval, another run held it, or its decision point declined
7
+ * it posts which members moved and what moved in them, from the approved
8
+ * change set and the current one.
9
+ * - `apply-failed: triage`: a failed apply posts the members and resources
10
+ * that failed with the engine's error, from the run record (an op wave's)
11
+ * or the apply report (`pr-apply`'s).
12
+ * - `description: check`: with a decide service set, the plan-note job asks
13
+ * whether the pull request's title and description leave out what its
14
+ * change set destroys or replaces, and posts the finding. It never
15
+ * approves, gates or blocks anything.
16
+ *
17
+ * The first two are on by default and the third is off. Each one is turned
18
+ * off (or on) with a list such as `wave-refused=off,description=check`: the
19
+ * `--respond` flag, the `CHANT_RESPOND` variable a generated job sets, or an
20
+ * op waves spec's `respond`.
21
+ *
22
+ * Every post is one comment per event and place, found again by its marker,
23
+ * so a job that runs twice edits its comment. Delivery never throws and never
24
+ * changes a job's exit code.
25
+ */
26
+
27
+ import type { ChangeSetAttribute, ChangeSetDocument, ChangeSetEntry } from "./change-set";
28
+ import { activeProductWords, type CiProductWords } from "./ci-product-words";
29
+ import type { PrForge } from "./pr-forge";
30
+
31
+ /** The events chant answers. */
32
+ export type CiRespondEvent = "wave-refused" | "apply-failed" | "description";
33
+
34
+ /** Each event's modes; the first is its default. */
35
+ export const CI_RESPONSES = {
36
+ "wave-refused": ["diff", "off"],
37
+ "apply-failed": ["triage", "off"],
38
+ description: ["off", "check"],
39
+ } as const satisfies Record<CiRespondEvent, readonly string[]>;
40
+
41
+ export type CiResponses = { [E in CiRespondEvent]?: (typeof CI_RESPONSES)[E][number] };
42
+
43
+ /** The variable a generated job carries its responses in. */
44
+ export const CI_RESPOND_ENV = "CHANT_RESPOND";
45
+
46
+ /** Every event at its default. */
47
+ export const CI_RESPOND_DEFAULTS: Required<CiResponses> = { "wave-refused": "diff", "apply-failed": "triage", description: "off" };
48
+
49
+ /** `wave-refused=off,description=check` as responses, or why it is not a list of them. */
50
+ export function parseRespondList(text: string | readonly string[]): CiResponses | { error: string } {
51
+ const parts = (typeof text === "string" ? text.split(",") : text.flatMap((t) => t.split(","))).map((p) => p.trim()).filter(Boolean);
52
+ const out: Record<string, string> = {};
53
+ for (const part of parts) {
54
+ const eq = part.indexOf("=");
55
+ const event = eq < 0 ? part : part.slice(0, eq);
56
+ const mode = eq < 0 ? "" : part.slice(eq + 1);
57
+ if (!(event in CI_RESPONSES)) return { error: `--respond names no event ${JSON.stringify(event)}; the events are ${Object.keys(CI_RESPONSES).join(", ")}` };
58
+ const modes = CI_RESPONSES[event as CiRespondEvent] as readonly string[];
59
+ if (!modes.includes(mode)) return { error: `--respond ${event} takes ${modes.join(" or ")}, not ${JSON.stringify(mode)}` };
60
+ out[event] = mode;
61
+ }
62
+ return out as CiResponses;
63
+ }
64
+
65
+ /** The list form of `responses`, for `--respond` and {@link CI_RESPOND_ENV}. Empty when every event is at its default. */
66
+ export function respondList(responses: CiResponses): string {
67
+ return (Object.keys(CI_RESPONSES) as CiRespondEvent[])
68
+ .filter((e) => responses[e] !== undefined && responses[e] !== CI_RESPOND_DEFAULTS[e])
69
+ .map((e) => `${e}=${responses[e]}`)
70
+ .join(",");
71
+ }
72
+
73
+ /**
74
+ * The responses in force: the defaults, then `CHANT_RESPOND`, then the
75
+ * spec's or the flag's. A malformed variable is ignored with a warning,
76
+ * since a response never stops a job.
77
+ */
78
+ export function resolveResponses(given: CiResponses | undefined, env: Record<string, string | undefined> = process.env, warn: (line: string) => void = () => {}): Required<CiResponses> {
79
+ let fromEnv: CiResponses = {};
80
+ const raw = env[CI_RESPOND_ENV];
81
+ if (raw) {
82
+ const parsed = parseRespondList(raw);
83
+ if ("error" in parsed) warn(`${CI_RESPOND_ENV} is ignored: ${parsed.error}`);
84
+ else fromEnv = parsed;
85
+ }
86
+ return { ...CI_RESPOND_DEFAULTS, ...fromEnv, ...(given ?? {}) } as Required<CiResponses>;
87
+ }
88
+
89
+ /** The hidden marker of one response's comment. */
90
+ export function respondMarker(event: CiRespondEvent, place: string): string {
91
+ return `<!-- chant:respond:${event}:${place.replace(/[^A-Za-z0-9._/-]/g, "_")} -->`;
92
+ }
93
+
94
+ // ---------------------------------------------------------------------------
95
+ // wave-refused: diff
96
+ // ---------------------------------------------------------------------------
97
+
98
+ /** Why a wave applied nothing. */
99
+ export type RefusedReason = "moved" | "held" | "declined";
100
+
101
+ /** One entry whose plan moved between the approved change set and the current one. */
102
+ export interface RefusedEntryDiff {
103
+ address: string;
104
+ /** Its action in the approved plan; absent when the entry is new. */
105
+ was?: string;
106
+ /** Its action now; absent when it is gone. */
107
+ now?: string;
108
+ /** Attributes whose planned value differs. */
109
+ attributes: string[];
110
+ }
111
+
112
+ /** One member whose plan moved. */
113
+ export interface RefusedMemberDiff {
114
+ member: string;
115
+ approved: string | null;
116
+ current: string | null;
117
+ /** Entry by entry, when both change sets were read; empty otherwise. */
118
+ changes: RefusedEntryDiff[];
119
+ }
120
+
121
+ export interface RefusedDiff {
122
+ /** How the post names the wave or the apply, such as `wave 2 (prod) of plywood-up`. */
123
+ label: string;
124
+ reason: RefusedReason;
125
+ approved: string | null;
126
+ current: string | null;
127
+ members: RefusedMemberDiff[];
128
+ /** The holder or the decision, for `held` and `declined`. */
129
+ detail?: string;
130
+ }
131
+
132
+ const shown = (a: ChangeSetAttribute | undefined): string | undefined =>
133
+ a === undefined ? undefined : a.sensitive ? "(sensitive)" : a.unknown ? "(known after apply)" : JSON.stringify(a.after ?? null);
134
+
135
+ function entryDiffs(was: readonly ChangeSetEntry[], now: readonly ChangeSetEntry[]): RefusedEntryDiff[] {
136
+ const key = (e: ChangeSetEntry) => `${e.address}\u0000${e.deposed ?? ""}`;
137
+ const before = new Map(was.map((e) => [key(e), e]));
138
+ const after = new Map(now.map((e) => [key(e), e]));
139
+ const out: RefusedEntryDiff[] = [];
140
+ for (const k of [...new Set([...before.keys(), ...after.keys()])].sort()) {
141
+ const b = before.get(k);
142
+ const a = after.get(k);
143
+ const paths = new Set([...(b?.attributes ?? []).map((x) => x.path), ...(a?.attributes ?? []).map((x) => x.path)]);
144
+ const moved = [...paths].filter((p) => shown(b?.attributes.find((x) => x.path === p)) !== shown(a?.attributes.find((x) => x.path === p))).sort();
145
+ if (b?.action === a?.action && moved.length === 0) continue;
146
+ out.push({ address: (a ?? b)!.address, ...(b ? { was: b.action } : {}), ...(a ? { now: a.action } : {}), attributes: moved });
147
+ }
148
+ return out;
149
+ }
150
+
151
+ /**
152
+ * The members whose plan digest differs between the approved change set and
153
+ * the current one, entry by entry. `only` narrows to the members a wave
154
+ * holds. A member that planned the same in both is left out.
155
+ */
156
+ export function changeSetDiff(approved: ChangeSetDocument | undefined, current: ChangeSetDocument | undefined, only?: readonly string[]): RefusedMemberDiff[] {
157
+ const names = new Set([...(approved?.members ?? []).map((m) => m.member), ...(current?.members ?? []).map((m) => m.member)]);
158
+ const keep = only ? new Set(only) : undefined;
159
+ const out: RefusedMemberDiff[] = [];
160
+ for (const member of [...names].sort()) {
161
+ if (keep && !keep.has(member)) continue;
162
+ const was = approved?.members.find((m) => m.member === member)?.planDigest ?? null;
163
+ const now = current?.members.find((m) => m.member === member)?.planDigest ?? null;
164
+ if (was === now && was !== null) continue;
165
+ const changes = approved && current ? entryDiffs(approved.entries.filter((e) => e.member === member), current.entries.filter((e) => e.member === member)) : [];
166
+ out.push({ member, approved: was, current: now, changes });
167
+ }
168
+ return out;
169
+ }
170
+
171
+ /** The members whose plan digest differs, when only the digests are known (an op wave's decision against its share job's plans). */
172
+ export function digestDiff(approved: Readonly<Record<string, string | null>>, current: Readonly<Record<string, string | null>>): RefusedMemberDiff[] {
173
+ return [...new Set([...Object.keys(approved), ...Object.keys(current)])]
174
+ .sort()
175
+ .filter((m) => approved[m] !== current[m] || approved[m] == null)
176
+ .map((member) => ({ member, approved: approved[member] ?? null, current: current[member] ?? null, changes: [] }));
177
+ }
178
+
179
+ /** A digest's first 12 hex characters past its scheme; `none` when there is none. */
180
+ export const shortDigest = (d: string | null | undefined): string => (d ? d.slice(d.lastIndexOf(":") + 1).slice(0, 12) : "none");
181
+
182
+ /** The post for a refused wave or apply, in the product's words. */
183
+ export function renderRefusedDiff(d: RefusedDiff, words: CiProductWords = activeProductWords()): string {
184
+ const [, applied] = words.verbs.apply;
185
+ const [nounOne, nounMany] = words.noun;
186
+ const lines: string[] = [];
187
+ if (d.reason === "moved") {
188
+ lines.push(`${capital(d.label)} ${applied} nothing: its plans changed after the approval (approved ${shortDigest(d.approved)}, now ${shortDigest(d.current)}).`);
189
+ } else if (d.reason === "held") {
190
+ lines.push(`${capital(d.label)} ${applied} nothing: another run holds what it changes${d.detail ? ` (${d.detail})` : ""}.`);
191
+ } else {
192
+ lines.push(`${capital(d.label)} ${applied} nothing: its decision point declined it${d.detail ? ` (${d.detail})` : ""}.`);
193
+ }
194
+ if (d.members.length === 0) {
195
+ if (d.reason === "moved") lines.push("", `No ${nounOne}'s plan differs from the approved change set that could be read.`);
196
+ } else {
197
+ lines.push("", `${d.members.length === 1 ? capital(nounOne) : capital(nounMany)} whose plan differs from the approved one:`, "");
198
+ for (const m of d.members) {
199
+ lines.push(`- \`${m.member}\`: plan ${shortDigest(m.approved)} -> ${shortDigest(m.current)}`);
200
+ for (const c of m.changes) {
201
+ const action = c.was === c.now ? c.now : `${c.was ?? "none"} -> ${c.now ?? "none"}`;
202
+ lines.push(` - \`${c.address}\` ${action}${c.attributes.length ? `: ${c.attributes.join(", ")}` : ""}`);
203
+ }
204
+ if (m.current === null) lines.push(` - it did not ${words.verbs.plan[0]} this time`);
205
+ }
206
+ }
207
+ if (d.reason === "moved") lines.push("", "Approve again only once the new plan is the one you want.");
208
+ else if (d.reason === "held") lines.push("", `Run it again once the other run is done; the approval still stands.`);
209
+ return lines.join("\n");
210
+ }
211
+
212
+ // ---------------------------------------------------------------------------
213
+ // apply-failed: triage
214
+ // ---------------------------------------------------------------------------
215
+
216
+ /** One member that failed to apply. */
217
+ export interface FailedMember {
218
+ member: string;
219
+ /** The engine's error, as the run record or the report has it. */
220
+ error?: string;
221
+ /** The resources the engine reported failed, when it reports per resource. */
222
+ resources?: string[];
223
+ }
224
+
225
+ export interface FailedApply {
226
+ label: string;
227
+ exitCode: number;
228
+ members: FailedMember[];
229
+ /** A failure outside any member: a hook, the job's own error. */
230
+ error?: string;
231
+ }
232
+
233
+ /** The longest error kept per member, so one engine's dump cannot fill the comment. */
234
+ const ERROR_LIMIT = 2000;
235
+
236
+ const clip = (text: string): string => (text.length > ERROR_LIMIT ? `${text.slice(0, ERROR_LIMIT)}\n... (cut at ${ERROR_LIMIT} characters; the job's log has the rest)` : text);
237
+
238
+ /** The post for a failed apply, in the product's words. */
239
+ export function renderTriage(f: FailedApply, words: CiProductWords = activeProductWords()): string {
240
+ const [apply] = words.verbs.apply;
241
+ const [nounOne, nounMany] = words.noun;
242
+ const lines = [`${capital(f.label)} failed (exit ${f.exitCode}).`];
243
+ if (f.members.length > 0) {
244
+ lines.push("", `${f.members.length === 1 ? capital(nounOne) : capital(nounMany)} that did not ${apply}:`);
245
+ for (const m of f.members) {
246
+ lines.push("", `- \`${m.member}\``);
247
+ if (m.resources?.length) lines.push(` - failed resources: ${m.resources.map((r) => `\`${r}\``).join(", ")}`);
248
+ if (m.error) lines.push("", "```", clip(m.error).replaceAll("```", "'''"), "```");
249
+ }
250
+ }
251
+ if (f.error) lines.push("", "```", clip(f.error).replaceAll("```", "'''"), "```");
252
+ lines.push("", `What applied before the failure stays applied. Fix the cause and ${apply} again; the run record keeps every ${nounOne}'s outcome.`);
253
+ return lines.join("\n");
254
+ }
255
+
256
+ // ---------------------------------------------------------------------------
257
+ // description: check
258
+ // ---------------------------------------------------------------------------
259
+
260
+ /** What the model reads: the pull request's text and the change set's summary. No planned values. */
261
+ export interface DescriptionState {
262
+ title: string;
263
+ description: string;
264
+ plan: { counts: Record<"create" | "update" | "replace" | "delete", number>; destroys: string[]; replacements: string[] };
265
+ }
266
+
267
+ const MAX_TEXT = 4000;
268
+ const MAX_LISTED = 50;
269
+
270
+ const named = (e: Pick<ChangeSetEntry, "member" | "address">): string => `${e.member}: ${e.address}`;
271
+
272
+ /** The destroys and replacements of a change set. */
273
+ export function destructiveEntries(doc: ChangeSetDocument): { destroys: ChangeSetEntry[]; replacements: ChangeSetEntry[] } {
274
+ return { destroys: doc.entries.filter((e) => e.action === "delete"), replacements: doc.entries.filter((e) => e.action === "replace") };
275
+ }
276
+
277
+ export function descriptionState(doc: ChangeSetDocument, title: string, description: string): DescriptionState {
278
+ const { destroys, replacements } = destructiveEntries(doc);
279
+ const a = doc.summary.actions;
280
+ return {
281
+ title: title.slice(0, MAX_TEXT),
282
+ description: description.slice(0, MAX_TEXT),
283
+ plan: {
284
+ counts: { create: a.create ?? 0, update: a.update ?? 0, replace: a.replace ?? 0, delete: a.delete ?? 0 },
285
+ destroys: destroys.slice(0, MAX_LISTED).map(named),
286
+ replacements: replacements.slice(0, MAX_LISTED).map(named),
287
+ },
288
+ };
289
+ }
290
+
291
+ /** Whether the text names an entry by its address, its type or its member. */
292
+ function mentions(text: string, e: ChangeSetEntry): boolean {
293
+ const hay = text.toLowerCase();
294
+ return [e.address, e.address.replace(/\[.*$/, ""), e.name, e.type].some((s) => typeof s === "string" && s.length > 2 && hay.includes(s.toLowerCase()));
295
+ }
296
+
297
+ /** The destroys and replacements the text does not mention; every one when it names them all, since the model found the text leaves something out. */
298
+ export function unmentioned(doc: ChangeSetDocument, text: string): ChangeSetEntry[] {
299
+ const { destroys, replacements } = destructiveEntries(doc);
300
+ const all = [...destroys, ...replacements];
301
+ const left = all.filter((e) => !mentions(text, e));
302
+ return left.length > 0 ? left : all;
303
+ }
304
+
305
+ /** The question asked. A Noul: the probability the answer is yes. */
306
+ export const DESCRIPTION_QUESTION = {
307
+ type: "noul",
308
+ instructions:
309
+ "Read the pull request's title and description and the summary of its plan. Answer true when the plan destroys or replaces resources that the title and description do not mention or that they contradict. Answer false when the text covers every destroy and replacement, or the plan has none.",
310
+ criteria: {
311
+ true: "the plan destroys or replaces something the text leaves out or contradicts",
312
+ false: "the text describes every destroy and replacement, or there are none",
313
+ },
314
+ } as const;
315
+
316
+ /** The default probability a yes needs before the finding is posted. */
317
+ export const DESCRIPTION_THRESHOLD = 0.8;
318
+
319
+ /** The model call: the backend's answer to {@link DESCRIPTION_QUESTION} over the state, as a probability of yes. */
320
+ export type DescriptionAsk = (state: DescriptionState) => Promise<{ model: string; probability: number; reason?: string }>;
321
+
322
+ export interface DescriptionFinding {
323
+ /** `flagged`: the finding was posted. `clear`: the model said no, or not confidently. `skipped`: nothing to check. `error`: the service did not answer. */
324
+ status: "flagged" | "clear" | "skipped" | "error";
325
+ probability?: number;
326
+ model?: string;
327
+ reason?: string;
328
+ unmentioned: string[];
329
+ /** The post, when flagged. */
330
+ body?: string;
331
+ }
332
+
333
+ /** Ask whether the description leaves out a destroy or replacement. Never throws. */
334
+ export async function checkDescription(input: {
335
+ doc: ChangeSetDocument;
336
+ title: string;
337
+ description: string;
338
+ ask: DescriptionAsk;
339
+ threshold?: number;
340
+ words?: CiProductWords;
341
+ }): Promise<DescriptionFinding> {
342
+ const { destroys, replacements } = destructiveEntries(input.doc);
343
+ if (destroys.length + replacements.length === 0) return { status: "skipped", reason: "the plan destroys and replaces nothing", unmentioned: [] };
344
+ let answer: Awaited<ReturnType<DescriptionAsk>>;
345
+ try {
346
+ answer = await input.ask(descriptionState(input.doc, input.title, input.description));
347
+ } catch (err) {
348
+ return { status: "error", reason: err instanceof Error ? err.message : String(err), unmentioned: [] };
349
+ }
350
+ const threshold = input.threshold ?? DESCRIPTION_THRESHOLD;
351
+ const base = { probability: answer.probability, model: answer.model, ...(answer.reason ? { reason: answer.reason } : {}) };
352
+ if (!(answer.probability >= threshold)) return { status: "clear", ...base, unmentioned: [] };
353
+ const left = unmentioned(input.doc, `${input.title}\n${input.description}`);
354
+ const names = left.map(named);
355
+ return { status: "flagged", ...base, unmentioned: names, body: renderDescriptionFinding(left, base, input.words ?? activeProductWords()) };
356
+ }
357
+
358
+ function renderDescriptionFinding(left: readonly ChangeSetEntry[], answer: { probability: number; model: string; reason?: string }, words: CiProductWords): string {
359
+ const list = left.slice(0, 10).map((e) => `- \`${named(e).replaceAll("`", "'")}\` (${e.action === "replace" ? "replace" : "destroy"})`);
360
+ if (left.length > 10) list.push(`- and ${left.length - 10} more in the plan note`);
361
+ return [
362
+ `Check the description of this pull request. The ${words.verbs.plan[0]} makes changes it does not mention:`,
363
+ "",
364
+ ...list,
365
+ "",
366
+ `${answer.model} answered yes with probability ${answer.probability.toFixed(2)}${answer.reason ? `: ${answer.reason}` : ""}. This finding approves nothing and never blocks a merge.`,
367
+ ].join("\n");
368
+ }
369
+
370
+ // ---------------------------------------------------------------------------
371
+ // Posting
372
+ // ---------------------------------------------------------------------------
373
+
374
+ /** Where a response goes: a pull request, or a tracking issue when the run has none. */
375
+ export type RespondPlace = { pr: number } | { issue: string };
376
+
377
+ /** What {@link postResponse} did. */
378
+ export interface RespondPost {
379
+ posted: boolean;
380
+ url?: string;
381
+ warning?: string;
382
+ }
383
+
384
+ /**
385
+ * Post one response's body, editing its earlier comment. On a pull request
386
+ * the comment carries the marker as its first line; with no pull request it
387
+ * goes to a tracking issue titled `issue`. Never throws.
388
+ */
389
+ export async function postResponse(
390
+ forge: Pick<PrForge, "upsertComment" | "trackIssue">,
391
+ event: CiRespondEvent,
392
+ place: string,
393
+ where: RespondPlace,
394
+ body: string,
395
+ ): Promise<RespondPost> {
396
+ const marker = respondMarker(event, place);
397
+ const text = `${marker}\n${body}${body.endsWith("\n") ? "" : "\n"}`;
398
+ try {
399
+ if ("pr" in where) {
400
+ const r = await forge.upsertComment(where.pr, marker, text);
401
+ return { posted: true, ...(r.url ? { url: r.url } : {}) };
402
+ }
403
+ const r = await forge.trackIssue(marker, { title: where.issue, body: text }, { match: "anywhere" });
404
+ return { posted: true, ...(r.url ? { url: r.url } : {}) };
405
+ } catch (err) {
406
+ return { posted: false, warning: `could not post the ${event} response: ${err instanceof Error ? err.message : String(err)}` };
407
+ }
408
+ }
409
+
410
+ function capital(s: string): string {
411
+ return s.length === 0 ? s : s[0]!.toUpperCase() + s.slice(1);
412
+ }
@@ -0,0 +1,145 @@
1
+ /**
2
+ * #4554: the forge reads, handover parameters and report URLs products
3
+ * share. Forge reads run against a recorded-answer fake fetch; report URLs
4
+ * against an injected store. Nothing leaves the process.
5
+ */
6
+
7
+ import { describe, expect, test } from "vitest";
8
+ import { checkoutScript, handoverTrap, HANDOVER_NOTE_FILES, packJs, takeOverScript } from "./ci-handover";
9
+ import { forgejoForge, githubForge, gitlabForge, type ForgeFetch } from "./pr-forge";
10
+ import { parseReportUrl, reportGet, reportPut } from "./pr-report-url";
11
+ import type { ObjectStore } from "./object-store/common";
12
+
13
+ /** A fetch that answers each URL (without its page parameters) from `answers`, and records the URLs asked. */
14
+ function recorded(answers: Record<string, unknown>): { fetch: ForgeFetch; asked: string[] } {
15
+ const asked: string[] = [];
16
+ const fetch: ForgeFetch = async (url) => {
17
+ asked.push(url);
18
+ const u = new URL(url);
19
+ for (const p of ["page", "per_page", "limit"]) u.searchParams.delete(p);
20
+ const key = `${u.pathname}${u.search}`;
21
+ const page = Number(new URL(url).searchParams.get("page") ?? "1");
22
+ if (!(key in answers)) return { ok: false, status: 404, text: async () => "{}" };
23
+ const body = answers[key];
24
+ return { ok: true, status: 200, text: async () => JSON.stringify(Array.isArray(body) && page > 1 ? [] : body) };
25
+ };
26
+ return { fetch, asked };
27
+ }
28
+
29
+ describe("default-branch and status reads (#4554)", () => {
30
+ test("GitHub reads the repository's default branch and each context's newest status", async () => {
31
+ const { fetch } = recorded({
32
+ "/repos/o/r": { default_branch: "trunk" },
33
+ "/repos/o/r/commits/abc/statuses": [
34
+ { id: 3, context: "chant/apply", state: "success", target_url: "https://ci/run/3" },
35
+ { id: 2, context: "chant/plan", state: "failure" },
36
+ { id: 1, context: "chant/apply", state: "pending" },
37
+ ],
38
+ });
39
+ const forge = githubForge({ apiBase: "https://api.test", repo: "o/r", token: "t", fetch });
40
+ expect(await forge.defaultBranch!()).toBe("trunk");
41
+ expect(await forge.commitStatuses!("abc")).toEqual([
42
+ { context: "chant/apply", state: "success", targetUrl: "https://ci/run/3" },
43
+ { context: "chant/plan", state: "failure" },
44
+ ]);
45
+ });
46
+
47
+ test("Forgejo reads the same endpoints, and a repository with no default branch reads as main", async () => {
48
+ const { fetch } = recorded({ "/api/v1/repos/o/r": {} });
49
+ const forge = forgejoForge({ apiBase: "https://forge.test/api/v1", repo: "o/r", host: "forge.test", fetch });
50
+ expect(await forge.defaultBranch!()).toBe("main");
51
+ });
52
+
53
+ test("GitLab keeps each name's status with the highest id", async () => {
54
+ const { fetch } = recorded({
55
+ "/api/v4/projects/g%2Fp": { default_branch: "main" },
56
+ "/api/v4/projects/g%2Fp/repository/commits/abc/statuses?all=true": [
57
+ { id: 7, name: "terragucci/plan", status: "failed", allow_failure: true },
58
+ { id: 9, name: "terragucci/plan", status: "success" },
59
+ ],
60
+ });
61
+ const forge = gitlabForge({ apiBase: "https://gitlab.test/api/v4", project: "g/p", fetch });
62
+ expect(await forge.defaultBranch!()).toBe("main");
63
+ expect(await forge.commitStatuses!("abc")).toEqual([{ context: "terragucci/plan", state: "success" }]);
64
+ });
65
+
66
+ test("GitLab filters the statuses by ref when given one, and asks for none when not (#4584)", async () => {
67
+ const { fetch, asked } = recorded({
68
+ "/api/v4/projects/g%2Fp/repository/commits/abc/statuses?all=true&ref=release%2F1": [{ id: 4, name: "terragucci/apply", status: "success" }],
69
+ "/api/v4/projects/g%2Fp/repository/commits/abc/statuses?all=true": [{ id: 5, name: "terragucci/other", status: "failed" }],
70
+ });
71
+ const forge = gitlabForge({ apiBase: "https://gitlab.test/api/v4", project: "g/p", fetch });
72
+ expect(await forge.commitStatuses!("abc", "release/1")).toEqual([{ context: "terragucci/apply", state: "success" }]);
73
+ expect(asked[0]).toContain("&ref=release%2F1");
74
+ expect(await forge.commitStatuses!("abc")).toEqual([{ context: "terragucci/other", state: "failed" }]);
75
+ expect(asked[1]).not.toContain("ref=");
76
+ });
77
+
78
+ test("GitHub and Forgejo take the ref and read the commit's statuses as before (#4584)", async () => {
79
+ const statuses = [{ id: 1, context: "chant/plan", state: "success" }];
80
+ const gh = recorded({ "/repos/o/r/commits/abc/statuses": statuses });
81
+ const github = githubForge({ apiBase: "https://api.test", repo: "o/r", token: "t", fetch: gh.fetch });
82
+ expect(await github.commitStatuses!("abc", "main")).toEqual([{ context: "chant/plan", state: "success" }]);
83
+ expect(gh.asked[0]).not.toContain("ref=");
84
+ const fj = recorded({ "/api/v1/repos/o/r/commits/abc/statuses": statuses });
85
+ const forgejo = forgejoForge({ apiBase: "https://forge.test/api/v1", repo: "o/r", host: "forge.test", fetch: fj.fetch });
86
+ expect(await forgejo.commitStatuses!("abc", "main")).toEqual([{ context: "chant/plan", state: "success" }]);
87
+ });
88
+ });
89
+
90
+ describe("the handover with a product's parameters (#4554)", () => {
91
+ test("left out, the scripts are chant's own", () => {
92
+ expect(packJs("github")).toContain(`NOTE=${JSON.stringify(HANDOVER_NOTE_FILES)}`);
93
+ expect(packJs("github")).toContain('"chant: the plan report is too large to hand to the note job whole; it hands on pr-plan.json and pr-note.md"');
94
+ expect(handoverTrap("report", "github").at(-1)).toBe("trap chant_handover EXIT");
95
+ const checkout = checkoutScript(false);
96
+ expect(checkout).toContain('"${CHANT_CHECKOUT_TOKEN:-}"');
97
+ expect(checkout).toContain('ref="$GITHUB_REF"');
98
+ expect(checkout).toContain("refs/remotes/origin/chant-head");
99
+ });
100
+
101
+ test("a product's note files, label, sweep, token, ref and head name", () => {
102
+ const files = ["plan-note.md", "plan-status.json", "report.json"];
103
+ const pack = packJs("forgejo", { noteFiles: files, label: "terragucci" });
104
+ expect(pack).toContain(`NOTE=${JSON.stringify(files)}`);
105
+ expect(pack).toContain("terragucci: the report is too large to hand to the next job whole; it hands on plan-note.md, plan-status.json, report.json");
106
+ expect(handoverTrap("report", "forgejo", { label: "terragucci", before: "tg_sweep" }).at(-1)).toBe("trap 'tg_sweep; chant_handover' EXIT");
107
+ const checkout = checkoutScript(true, false, { tokenEnv: "TG_TOKEN", refEnv: "TG_REF", headName: "terragucci-head" });
108
+ expect(checkout).toContain('"${TG_TOKEN:-}"');
109
+ expect(checkout).toContain('ref="${TG_REF:-$GITHUB_REF}"');
110
+ expect(checkout).toContain('want="${TG_REF:-$GITHUB_SHA}"');
111
+ expect(checkout).toContain("refs/remotes/origin/terragucci-head");
112
+ expect(takeOverScript("replan", "report", "github")).toContain("the replan job handed on no report");
113
+ });
114
+
115
+ test("a parameter that would break out of the script is refused", () => {
116
+ expect(() => packJs("github", { noteFiles: ['a"b'] })).toThrow();
117
+ expect(() => handoverTrap("r", "github", { before: "x; rm" })).toThrow();
118
+ expect(() => checkoutScript(false, false, { tokenEnv: "A-B" })).toThrow();
119
+ });
120
+ });
121
+
122
+ describe("gs:// and az:// report URLs (#4554)", () => {
123
+ test("they parse with their prefix", () => {
124
+ expect(parseReportUrl("gs://my-bucket/pr/")).toEqual({ scheme: "gs", url: "gs://my-bucket/pr", bucket: "my-bucket", prefix: "pr" });
125
+ expect(parseReportUrl("az://account1/reports")).toEqual({ scheme: "az", url: "az://account1/reports", account: "account1", container: "reports", prefix: "" });
126
+ expect(parseReportUrl("https://example.test/x")).toHaveProperty("error");
127
+ });
128
+
129
+ test("a put and a get go through the store under the prefix, and an absent object reads as null", async () => {
130
+ const objects = new Map<string, string>();
131
+ const store = async (): Promise<ObjectStore> => ({
132
+ location: "gs://my-bucket",
133
+ put: async (key, body) => (objects.set(key, String(body)), {}),
134
+ read: async (key) => (objects.has(key) ? { body: objects.get(key)! } : {}),
135
+ get: async (key) => objects.get(key),
136
+ presign: async () => ({ url: "", expires: new Date(0) }),
137
+ });
138
+ const target = parseReportUrl("gs://my-bucket/pr");
139
+ if ("error" in target) throw new Error(target.error);
140
+ await reportPut(target, undefined, store)("7/abc/pr-plan.json", "{}", "application/json");
141
+ expect([...objects.keys()]).toEqual(["pr/7/abc/pr-plan.json"]);
142
+ expect(await reportGet(target, undefined, store)("7/abc/pr-plan.json")).toBe("{}");
143
+ expect(await reportGet(target, undefined, store)("7/abc/none.json")).toBeNull();
144
+ });
145
+ });
@@ -291,7 +291,7 @@ describe("auditCommand", () => {
291
291
  describe("lexicon coverage (#1623)", () => {
292
292
  const MIXED = fileURLToPath(new URL("./__fixtures__/audit-coverage", import.meta.url));
293
293
 
294
- test("zero lexicons: says it had nothing to look with, names each file's lexicon, prints the npx line, exits 2", async () => {
294
+ test("zero lexicons: says it had nothing to look with, names each file's lexicon, prints the npx line, exits 1", async () => {
295
295
  const result = await auditCommand({ path: MIXED, plugins: [] });
296
296
  expect(result.success).toBe(true);
297
297
  expect(result.status).toBe("no-lexicons");
@@ -26,6 +26,7 @@ import { formatWarning } from "../format";
26
26
  import { lexiconPackagesToInstall, lexiconSourceLabel, pathLexiconMap, recordedLexiconModules } from "../../lexicon-module";
27
27
  import { readConfigFieldsStatically, readLexiconDeclarationsStatically, unknownPathLexiconsNotice } from "../../config-static";
28
28
  import { findProjectConfigPastFragments } from "../../config";
29
+ import { CHANT_EXIT } from "../../exit-codes";
29
30
 
30
31
  export type AuditFormat = "stylish" | "json" | "sarif" | "markdown" | "html";
31
32
  export type AuditTier = "merge-worthy" | "all";
@@ -122,8 +123,8 @@ export interface AuditCommandResult {
122
123
  warnings?: AuditWarning[];
123
124
  }
124
125
 
125
- /** Exit code when the audit had no lexicons to look with. Distinct from 1 (findings / failure). */
126
- export const NO_LEXICONS_EXIT_CODE = 2;
126
+ /** Exit code when the audit had no lexicons to look with: a config failure, so `failed` (#4585). */
127
+ export const NO_LEXICONS_EXIT_CODE = CHANT_EXIT.failed;
127
128
 
128
129
  /**
129
130
  * What to tell the user about lexicons that did not load: an `npm i` line for
@@ -143,7 +143,7 @@ describe("carveAdvise", () => {
143
143
  const r = await carveAdvise({ from: dir });
144
144
  const text = formatCarveReport(r);
145
145
  expect(text).toContain("CLEAN LEAF");
146
- expect(text).toContain("LEAVE IN TERRAFORM");
146
+ expect(text).toContain("STAYS IN TERRAFORM");
147
147
  expect(text).toContain("Advises only");
148
148
  expect(text).not.toMatch(/terraform state rm|apply|destroy/i);
149
149
  });
@@ -271,7 +271,7 @@ export function formatCarveReport(result: CarveAdviseResult): string {
271
271
  }
272
272
 
273
273
  lines.push(
274
- `Bands: 80-100 carve now | 50-79 carve with boundary edits | 0-49 leave in ${cdk ? "CDK" : "Terraform"}`,
274
+ `Bands: 80-100 carve now | 50-79 carve with boundary edits | 0-49 stays in ${cdk ? "CDK" : "Terraform"}`,
275
275
  );
276
276
  if (cellWidth > 0) {
277
277
  lines.push(
@@ -306,7 +306,7 @@ function bandLabel(band: PeelabilityBand, cdk: boolean): string {
306
306
  case "leave in Terraform":
307
307
  // The band's name is part of the JSON contract and does not change per
308
308
  // source; only the heading a person reads does.
309
- return cdk ? "LEAVE IN CDK" : "LEAVE IN TERRAFORM";
309
+ return cdk ? "STAYS IN CDK" : "STAYS IN TERRAFORM";
310
310
  }
311
311
  }
312
312
 
@@ -32,6 +32,8 @@ export interface InitOptions {
32
32
  force?: boolean;
33
33
  /** Skip writing the project's `.mcp.json` (`--skip-mcp`) */
34
34
  skipMcp?: boolean;
35
+ /** Register `chant serve mcp --read-only` in `.mcp.json` (`--mcp-read-only`, chant#4543) */
36
+ mcpReadOnly?: boolean;
35
37
  /** Skip interactive install prompt */
36
38
  skipInstall?: boolean;
37
39
  /**
@@ -437,7 +439,7 @@ export async function initCommand(options: InitOptions): Promise<InitResult> {
437
439
  if (!options.skipMcp) {
438
440
  writeIfNotExists(
439
441
  mcpConfigPath(targetDir),
440
- generateMcpConfig(detectPackageManager(targetDir)),
442
+ generateMcpConfig(detectPackageManager(targetDir), { readOnly: options.mcpReadOnly }),
441
443
  MCP_CONFIG_FILENAME,
442
444
  createdFiles,
443
445
  warnings,
@@ -0,0 +1,16 @@
1
+ /** The flags of the component plan-wave and apply-wave steps and of `chant lock --keep` (#4588). */
2
+
3
+ import { describe, expect, test } from "vitest";
4
+ import { parseArgs } from "./parse-args";
5
+
6
+ describe("component wave steps and comment locks (#4588)", () => {
7
+ test("plan-wave and apply-wave take the runs, plans and outputs files", () => {
8
+ const args = parseArgs(["components", "apply-wave", "--runs", "r.json", "--plans", "p.json", "--wave-outputs", "o.json", "--base", "abc", "--env", "prod"]);
9
+ expect([args.runsFile, args.plansFile, args.waveOutputs]).toEqual(["r.json", "p.json", "o.json"]);
10
+ expect(() => parseArgs(["components", "plan-wave", "--runs", "--plans", "p.json"])).toThrow(/--runs needs a file/);
11
+ });
12
+
13
+ test("chant lock --keep", () => {
14
+ expect(parseArgs(["lock", "--keep", "--pr", "7"]).keepLocks).toBe(true);
15
+ });
16
+ });