@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
@@ -13,8 +13,13 @@
13
13
  */
14
14
 
15
15
  import type { PlanShape } from "./covered-round";
16
+ import { CHANT_EXIT } from "../exit-codes";
16
17
  import type { ReleaseIdentity } from "../telemetry-attribution";
17
18
  import type { ChangeSetPart } from "../change-set";
19
+ import type { DeployAdoption } from "./adoption";
20
+ import type { LockGrain, LockRow } from "../lifecycle/lock-rows";
21
+ import type { RowLeasePort } from "./row-lease";
22
+ import type { CapabilityTraceFacts } from "../otlp";
18
23
 
19
24
  /**
20
25
  * Ambient information a capability's `run`/`rollback` receives, independent of
@@ -81,6 +86,53 @@ export interface DeployContext {
81
86
  * component refuses before anything plans or runs. Absent: the whole step.
82
87
  */
83
88
  targets?: string[];
89
+ /**
90
+ * `pr-plan --refresh` (#4627): refresh the step's state from the live
91
+ * system before it plans, as `pulumi preview --refresh` does. A step's
92
+ * capability must accept it ({@link Capability.planFlags}), or the
93
+ * component refuses before anything plans. Bound into the member's digest.
94
+ */
95
+ refresh?: boolean;
96
+ /**
97
+ * `pr-plan --target-dependents` (#4627): with `targets`, plan the
98
+ * resources that depend on them too, as `pulumi preview
99
+ * --target-dependents` does. Accepted or refused as `refresh` is. Bound
100
+ * into the member's digest.
101
+ */
102
+ targetDependents?: boolean;
103
+ /**
104
+ * `--adopt <adoption-file>` (#4537): the resources to adopt into this
105
+ * component's stack, the index version they come from, and the review
106
+ * every change set the adoption makes goes through before it executes. A
107
+ * deploy step that can adopt takes it by setting `outcome`; a step that
108
+ * cannot ignores it, and the command refuses a run no step took it in.
109
+ * Absent: a plain deploy. See ./adoption.ts.
110
+ */
111
+ adoption?: DeployAdoption;
112
+ /**
113
+ * The member's `ci.lockGrain` (#4552), read from the declaration at base
114
+ * by the caller: the member's own, else the workspace's. Absent when
115
+ * neither sets one, and then the capability's `defaultLockGrain` holds. A
116
+ * step input's own grain (`pulumi-up`'s `lockGrain`) wins over it.
117
+ */
118
+ lockGrain?: LockGrain;
119
+ /**
120
+ * The commit the caller reads policy at (#4613): the base a pull request
121
+ * or an op wave is measured from. A step that runs a policy engine of its
122
+ * own, such as `pulumi-up`'s CrossGuard packs, reads the packs and
123
+ * `ci.policy.packs` at this commit (`../policy-packs.ts`), so a change
124
+ * cannot loosen what judges it. Absent outside those jobs: the step reads
125
+ * its packs where they stand.
126
+ */
127
+ policyBase?: string;
128
+ /**
129
+ * The run's row lease (#4594), set by an apply path that plans inside its
130
+ * steps (`run --components`, `components fan-out`, a promote). The driver
131
+ * takes it around a step on the resource grain (./row-lease.ts); a
132
+ * capability never calls it. Absent where the caller leases the rows its
133
+ * plan knows (pr-apply, op waves) or takes no lease.
134
+ */
135
+ rowLease?: RowLeasePort;
84
136
  }
85
137
 
86
138
  /**
@@ -126,6 +178,22 @@ export interface CapabilityPlan {
126
178
  * approval covers it. Absent, core derives the shape from `changeSet`.
127
179
  */
128
180
  shape?: PlanShape;
181
+ /**
182
+ * The engine's own reasons the plan is destructive (#4569), sorted, when it
183
+ * classes more as destructive than a delete or replace in the change set
184
+ * (a Postgres table rewrite, a revoke, a ClickHouse mutation). An op wave
185
+ * counts a plan that names any as destructive, which `on-destructive`
186
+ * waits on. Absent or empty: the change set alone decides.
187
+ */
188
+ destructive?: string[];
189
+ /**
190
+ * Where this member's copy lives in a pull request's environment (#4609),
191
+ * as the capability says: `pulumi-up` answers `<engine>:<dir>#<stack>` for
192
+ * the review stack `pr-<n>` it planned. `pr-env up` keeps it on the
193
+ * environment's record under `locations`, where the lexicon's teardown
194
+ * reads it back. Absent outside a pull request's environment.
195
+ */
196
+ location?: string;
129
197
  }
130
198
 
131
199
  /**
@@ -181,6 +249,25 @@ export interface Capability<In = unknown, Out = unknown> {
181
249
  * is covered by its component's composition digest instead.
182
250
  */
183
251
  plan?(ctx: DeployContext, input: In): Promise<CapabilityPlan>;
252
+ /**
253
+ * Optional (#4552): the lock grain a member of this kind takes when
254
+ * `ci.lockGrain` sets none. `plan`, when given, is the member's plan. Absent:
255
+ * `target`. The terraform lexicon answers `resource` for choudoufu and
256
+ * `target` for Terraform, tofu and Terragrunt; the pulumi lexicon
257
+ * `resource` for plunge and `target` for stock Pulumi.
258
+ */
259
+ defaultLockGrain?(input: In, plan?: CapabilityPlan): LockGrain | Promise<LockGrain>;
260
+ /**
261
+ * Optional (#4552): why this member cannot take `grain`, or undefined when
262
+ * it can. A refusal names the engine, and stops the plan.
263
+ */
264
+ lockGrainRefusal?(input: In, grain: LockGrain, plan?: CapabilityPlan): string | undefined | Promise<string | undefined>;
265
+ /**
266
+ * Optional (#4552): the rows an apply of `plan` holds on the resource
267
+ * grain, one per changed resource, keyed as the lexicon keys them (see
268
+ * ../lifecycle/lock-rows.ts). Absent: the resource grain is refused.
269
+ */
270
+ lockRows?(input: In, plan: CapabilityPlan): LockRow[] | Promise<LockRow[]>;
184
271
  /**
185
272
  * Optional: the outputs `run` exposed when it last ran, read without
186
273
  * changing anything (#3183). A pull request's plan reads them for each
@@ -208,6 +295,12 @@ export interface Capability<In = unknown, Out = unknown> {
208
295
  * why. Unset refuses too, with a reason that names the verb.
209
296
  */
210
297
  readonly targets?: TargetSupport;
298
+ /**
299
+ * Whether this verb's plan takes `DeployContext.refresh` and
300
+ * `DeployContext.targetDependents` (#4627), each `"accept"` or `{ refuse
301
+ * }` with why, as {@link targets} is. Unset refuses, naming the verb.
302
+ */
303
+ readonly planFlags?: Partial<Record<PlanFlag, TargetSupport>>;
211
304
  /**
212
305
  * Optional (#4435, ws-107): why this capability will not plan and apply
213
306
  * `members` as one group, or `undefined` when it will. Core asks before
@@ -246,6 +339,28 @@ export interface Capability<In = unknown, Out = unknown> {
246
339
  * throw counts as no reads.
247
340
  */
248
341
  declaredReads?(ctx: DeclaredReadsContext, members: readonly DeclaredReadMember[]): Promise<DeclaredRead[]> | DeclaredRead[];
342
+ /**
343
+ * Optional (#4542): the local files a step deploys from when its input
344
+ * names them indirectly, as `terraform-apply` names a root by key. A
345
+ * release cut records them for the step's component, with their paths
346
+ * from the member's directory kept, and a promote or rollback under that
347
+ * release writes them under `.chant/release-templates/<digest>/` and sets
348
+ * the step's {@link ReleaseInputs.field} to the recorded copy of
349
+ * {@link ReleaseInputs.dir}, so the step plans the release's files. Null
350
+ * when the step deploys nothing local; {@link ReleaseInputsUnbound} when
351
+ * its files can't be deployed from a copy, which the cut prints.
352
+ */
353
+ releaseInputs?(input: In, ctx: ReleaseInputsContext): Promise<ReleaseInputs | ReleaseInputsUnbound | null> | ReleaseInputs | ReleaseInputsUnbound | null;
354
+ /**
355
+ * Optional (#4555): what this capability knows about one `run`, for the
356
+ * step's span and its op-wave run record. Engine facts go in `attributes`
357
+ * (the root or stack, the binary, resource counts), and the pieces the
358
+ * engine timed, such as each resource's provider call, in `spans`. Core
359
+ * writes every key under the CI product's prefix. Called after `run`
360
+ * returned (`output`) or threw (`error`); a throw here, or undefined,
361
+ * leaves the step with core's own facts.
362
+ */
363
+ traceFacts?(input: In, outcome: { output: Out } | { error: unknown }): Promise<CapabilityTraceFacts | undefined> | CapabilityTraceFacts | undefined;
249
364
  /**
250
365
  * Optional (#4435, ws-107): plan `members` as one, in one call. Declared
251
366
  * together with `runGroup`; a capability with only one of the two never
@@ -307,6 +422,27 @@ export interface ReportedGroupRead {
307
422
  output?: string;
308
423
  }
309
424
 
425
+ /** What `releaseInputs` is asked with (#4542). */
426
+ export interface ReleaseInputsContext {
427
+ /** The member's directory, which the answer's paths are relative to. */
428
+ memberDir: string;
429
+ }
430
+
431
+ /** The files a step deploys from (#4542), each relative to the member's directory. */
432
+ export interface ReleaseInputs {
433
+ /** The step field a promote under a release sets to the recorded copy of {@link dir}. */
434
+ field: string;
435
+ /** The directory the step runs in. One of {@link paths}. */
436
+ dir: string;
437
+ /** Every directory and file the step reads, {@link dir} included. */
438
+ paths: string[];
439
+ }
440
+
441
+ /** A step whose files a release can't deploy from a copy (#4542), and why. */
442
+ export interface ReleaseInputsUnbound {
443
+ unbound: string;
444
+ }
445
+
310
446
  /** What `declaredReads` is asked with (#4466). */
311
447
  export interface DeclaredReadsContext {
312
448
  /** The project root, which a step's relative file paths are read against. */
@@ -445,6 +581,36 @@ export type RollbackPolicy = "native" | "none-by-design" | "needs-opt-out";
445
581
  /** Whether a capability accepts `DeployContext.targets` (#4300). See `Capability.targets`. */
446
582
  export type TargetSupport = "accept" | { refuse: string };
447
583
 
584
+ /** A plan flag a capability accepts or refuses (#4627): `refresh` and `targetDependents`. */
585
+ export type PlanFlag = "refresh" | "targetDependents";
586
+
587
+ /** Each plan flag as `pr-plan` spells it (#4627). */
588
+ export const PLAN_FLAG_ARGS: Record<PlanFlag, string> = { refresh: "--refresh", targetDependents: "--target-dependents" };
589
+
590
+ /**
591
+ * A component was asked to plan with a flag (#4627) one of its steps'
592
+ * capabilities refuses. Nothing in the component plans.
593
+ */
594
+ export class PlanFlagRefusedError extends Error {
595
+ constructor(
596
+ readonly component: string,
597
+ readonly kind: string,
598
+ readonly flag: PlanFlag,
599
+ readonly reason: string,
600
+ ) {
601
+ super(`component "${component}": ${kind} refuses ${PLAN_FLAG_ARGS[flag]}: ${reason}`);
602
+ this.name = "PlanFlagRefusedError";
603
+ }
604
+ }
605
+
606
+ /** Why `capability` refuses `flag`, or `undefined` when it accepts it (#4627). */
607
+ export function planFlagRefusal(capability: Pick<Capability<never, unknown>, "kind" | "planFlags">, flag: PlanFlag): string | undefined {
608
+ const t = capability.planFlags?.[flag];
609
+ if (t === "accept") return undefined;
610
+ if (t && typeof t === "object" && typeof t.refuse === "string") return t.refuse;
611
+ return `${capability.kind} does not say it can plan with ${PLAN_FLAG_ARGS[flag]}`;
612
+ }
613
+
448
614
  /**
449
615
  * A component was asked to narrow to targets (#4300) and one of its steps'
450
616
  * capabilities refuses them. Nothing in the component plans or runs.
@@ -475,24 +641,32 @@ export type CapabilityOutput<C> = C extends Capability<unknown, infer Out> ? Out
475
641
 
476
642
  /**
477
643
  * The exit code of a command whose capability step refused a plan that moved
478
- * since it was approved: 3, the code `pr-apply` gives a moved digest and a
479
- * run gives a gate (#3997).
644
+ * since it was approved: `CHANT_EXIT.moved`, 4, the code `pr-apply` gives a
645
+ * moved digest (#3997, #4553). Before #4553 it was 3, a gate's code.
646
+ */
647
+ export const PLAN_MOVED_EXIT_CODE = CHANT_EXIT.moved;
648
+
649
+ /**
650
+ * The moved-plan code before #4553. A lexicon built against an older core
651
+ * may still set it on the error it throws for a moved plan; read for one
652
+ * release, then dropped.
480
653
  */
481
- export const PLAN_MOVED_EXIT_CODE = 3;
654
+ const LEGACY_PLAN_MOVED_EXIT_CODE = 3;
482
655
 
483
656
  /**
484
657
  * Whether `err` is a `run`'s refusal to apply a plan from
485
658
  * `DeployContext.plans` because the target moved since it was planned
486
659
  * (#3997). The mark is a `planMoved: true` property, not a class, so a
487
- * lexicon built against an older core can set it. An `exitCode` of
488
- * {@link PLAN_MOVED_EXIT_CODE} on the error is the same mark. Any other
660
+ * lexicon built against an older core can set it. An `exitCode` of 3 on
661
+ * the error, the moved code before #4553, is the same mark for one more
662
+ * release; a lexicon sets `planMoved` and core picks the number. Any other
489
663
  * `exitCode` is ignored: a failed step exits 1, so a capability can't pick
490
664
  * the process's exit code.
491
665
  */
492
666
  export function isPlanMovedError(err: unknown): boolean {
493
667
  if (typeof err !== "object" || err === null) return false;
494
668
  const e = err as { planMoved?: unknown; exitCode?: unknown };
495
- return e.planMoved === true || e.exitCode === PLAN_MOVED_EXIT_CODE;
669
+ return e.planMoved === true || e.exitCode === LEGACY_PLAN_MOVED_EXIT_CODE;
496
670
  }
497
671
 
498
672
  /**
@@ -0,0 +1,66 @@
1
+ import { mkdtempSync, readFileSync, writeFileSync } from "node:fs";
2
+ import { tmpdir } from "node:os";
3
+ import { join } from "node:path";
4
+ import { describe, expect, test } from "vitest";
5
+ import { assertOpWaveHooks, assertPrLoopHooks } from "../op/op-waves";
6
+ import { checkHookEnv, checkHooksOf, runCheckHooks, writeCiHook } from "./check-hooks";
7
+
8
+ describe("the check moment (#4556)", () => {
9
+ test("ci.hooks takes check hooks, and refuses approve and {plan} there", () => {
10
+ expect(() => assertPrLoopHooks("ci.hooks", { check: [{ name: "tflint", command: ["tflint", "--chdir", "{target}"], perRun: true }] })).not.toThrow();
11
+ expect(() => assertPrLoopHooks("ci.hooks", { check: [{ command: ["lint"], onFailure: "approve" }] })).toThrow(/nothing to approve/);
12
+ expect(() => assertPrLoopHooks("ci.hooks", { check: [{ command: ["lint", "{plan}"], perRun: true }] })).toThrow(/no \{plan\}/);
13
+ expect(() => assertPrLoopHooks("ci.hooks", { check: [{ command: ["lint", "{target}"] }] })).toThrow(/perRun/);
14
+ });
15
+
16
+ test("an Op waves spec has no check moment", () => {
17
+ expect(() => assertOpWaveHooks("Op waves", { check: [{ command: ["lint"] }] } as never)).toThrow(/check job/);
18
+ });
19
+
20
+ test("a check hook's environment has no forge token or cloud credentials", () => {
21
+ const env = checkHookEnv({ PATH: "/bin", GITHUB_TOKEN: "t", AWS_SECRET_ACCESS_KEY: "s", ACTIONS_ID_TOKEN_REQUEST_URL: "u", TF_TOKEN_app_terraform_io: "x", TF_TOKEN_registry_example_com: "y", PULUMI_ACCESS_TOKEN: "p" });
22
+ expect(env).toEqual({ PATH: "/bin" });
23
+ });
24
+
25
+ test("the top level's check hooks run before the member's", () => {
26
+ const declaration = { ci: { hooks: { check: [{ name: "a", command: ["a"] }] } }, members: [{ name: "net", ciHooks: { check: [{ name: "b", command: ["b"] }] } }] } as never;
27
+ expect(checkHooksOf(declaration, "net").map((h) => h.name)).toEqual(["a", "b"]);
28
+ });
29
+
30
+ test("runs each hook once, or once per target, and reports each call", () => {
31
+ const cwd = mkdtempSync(join(tmpdir(), "chant-check-"));
32
+ const calls: string[][] = [];
33
+ const report = runCheckHooks({
34
+ base: "abc123",
35
+ targets: ["roots/a", "roots/b"],
36
+ cwd,
37
+ read: { base: "abc123", hooks: [{ name: "fmt", command: ["fmt"] }, { name: "tflint", command: ["tflint", "{target}"], perRun: true, targets: ["roots/b"] }] },
38
+ exec: (argv, _cwd, env) => {
39
+ calls.push([...argv, env?.CHANT_HOOK ?? ""]);
40
+ return argv[1] === "roots/b" ? 2 : 0;
41
+ },
42
+ log: () => {},
43
+ });
44
+ expect(calls).toEqual([["fmt", "check"], ["tflint", "roots/b", "check"]]);
45
+ expect(report).toMatchObject({ status: "failed", base: "abc123", hooks: [{ name: "fmt", outcome: "passed", exit: 0 }, { name: "tflint", target: "roots/b", outcome: "failed", exit: 2 }] });
46
+ expect(JSON.parse(readFileSync(join(cwd, ".chant/check/check-hooks.json"), "utf8")).status).toBe("failed");
47
+ });
48
+
49
+ test("no check hook at base is status none", () => {
50
+ const cwd = mkdtempSync(join(tmpdir(), "chant-check-"));
51
+ expect(runCheckHooks({ base: "abc", cwd, read: { base: "abc", hooks: [] }, log: () => {} }).status).toBe("none");
52
+ });
53
+
54
+ test("writeCiHook adds a check hook, keeps the file's other keys, and replaces one of the same name", () => {
55
+ const root = mkdtempSync(join(tmpdir(), "chant-check-"));
56
+ writeFileSync(join(root, "chant.workspace.json"), JSON.stringify({ version: 1, members: [{ name: "net", path: "net" }] }, null, 2) + "\n");
57
+ expect(writeCiHook(root, "check", { name: "pre-commit", command: ["pre-commit", "run", "--all-files"] }).replaced).toBe(false);
58
+ expect(writeCiHook(root, "check", { name: "pre-commit", command: ["pre-commit", "run", "-a"] }).replaced).toBe(true);
59
+ writeCiHook(root, "check", { name: "tflint", command: ["tflint"] }, { member: "net" });
60
+ const doc = JSON.parse(readFileSync(join(root, "chant.workspace.json"), "utf8"));
61
+ expect(doc.ci.hooks.check).toEqual([{ name: "pre-commit", command: ["pre-commit", "run", "-a"] }]);
62
+ expect(doc.members[0].ci.hooks.check).toEqual([{ name: "tflint", command: ["tflint"] }]);
63
+ expect(doc.version).toBe(1);
64
+ expect(() => writeCiHook(root, "check", { command: ["x"], onFailure: "approve" })).toThrow(/nothing to approve/);
65
+ });
66
+ });
@@ -0,0 +1,255 @@
1
+ /**
2
+ * The check moment (#4556): `ci.hooks.check` in the workspace declaration,
3
+ * run by a product's check job, terragucci's and plywood's alike, with the
4
+ * runner the other moments use (`runStageHooks`). Nothing here knows an
5
+ * engine: a hook is the user's own tool (tflint, checkov, trivy,
6
+ * pre-commit), and the product switches it on with a preset.
7
+ *
8
+ * - The hooks are read from the declaration at the base the check measures
9
+ * the change from, never from the change itself, so a change cannot remove
10
+ * a required check. The top level's run first, then the member's.
11
+ * - A hook runs once for the check, or once per target with `perRun`;
12
+ * `{target}` and `CHANT_TARGET` name it, and `targets` match the targets'
13
+ * names. There is no `{plan}`, and `onFailure` is `fail`.
14
+ * - A hook runs with no forge token, no OIDC request variables and no cloud
15
+ * credentials in its environment ({@link checkHookEnv}).
16
+ *
17
+ * {@link writeCiHook} is the writer a product's `init` calls to add a hook to
18
+ * `ci.hooks`, keeping the declaration's formatting.
19
+ */
20
+
21
+ import { spawnSync } from "node:child_process";
22
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
23
+ import { join, relative, resolve } from "node:path";
24
+ import { CHECK_HOOK_MOMENT, assertCheckHooks, type CiHooks, type OpWaveHook } from "../op/op-waves";
25
+ import { runStageHooks, type OpWaveExec, type OpWaveHookRun } from "../op/stage-hooks";
26
+ import { FORGE_TOKEN_VARS } from "../ci-handover";
27
+ import { OIDC_REQUEST_VARS, TRADED_VARS } from "../ci-identity";
28
+ import { DECLARATION_FILES, readDeclaration, WorkspaceReadError, type Declaration } from "../workspace/declaration";
29
+ import { setProperty, valueAt } from "../workspace/json-edit";
30
+ import { parseJsonText } from "../workspace/jsonc";
31
+ import { memberAtCwd } from "../workspace/security";
32
+ import { locateWorkspace } from "../workspace/which-chant";
33
+ import type { CheckStepOutcome } from "./check-steps";
34
+
35
+ export { CI_CHECK_HOOK_FLOOR } from "../op/op-waves";
36
+
37
+ /** The check hooks a job runs, and where they were read. */
38
+ export interface CheckHooksRead {
39
+ hooks: OpWaveHook[];
40
+ /** The commit they were read at. */
41
+ base: string;
42
+ /** A line for the log when none run because the base has no declaration, or could not be read. */
43
+ note?: string;
44
+ }
45
+
46
+ /** The check hooks `declaration` gives a job run in a member (or at the top, `null`): the top level's, then the member's. */
47
+ export function checkHooksOf(declaration: Pick<Declaration, "ci" | "members">, member: string | null): OpWaveHook[] {
48
+ const own = member === null ? null : (declaration.members.find((m) => m.name === member)?.ciHooks ?? null);
49
+ return [...(declaration.ci?.hooks?.check ?? []), ...(own?.check ?? [])];
50
+ }
51
+
52
+ /** Whether the working tree's declaration names any check hook. */
53
+ function checkoutNamesCheckHooks(cwd: string): boolean {
54
+ try {
55
+ const located = locateWorkspace(cwd);
56
+ const d = readDeclaration(located.tree);
57
+ return checkHooksOf(d, memberAtCwd({ declaration: d, rootOnDisk: located.rootOnDisk }, cwd)).length > 0;
58
+ } catch {
59
+ return false;
60
+ }
61
+ }
62
+
63
+ /**
64
+ * The check hooks a job in `cwd` runs, read from the workspace declaration at
65
+ * `base`. Throws when the declaration at base cannot be read and the working
66
+ * tree's names check hooks, as the pull-request jobs do for their hooks.
67
+ */
68
+ export function checkHooksAt(cwd: string, base: string): CheckHooksRead {
69
+ let declaration: Declaration;
70
+ let rootOnDisk: string;
71
+ try {
72
+ const located = locateWorkspace(cwd, base);
73
+ declaration = readDeclaration(located.tree);
74
+ rootOnDisk = located.rootOnDisk;
75
+ } catch (err) {
76
+ const missing = err instanceof WorkspaceReadError && (err.code === "declaration-missing" || err.code === "not-a-git-repository");
77
+ const why = err instanceof Error ? err.message : String(err);
78
+ if (checkoutNamesCheckHooks(cwd)) {
79
+ if (missing) return { hooks: [], base, note: `ci.hooks.check: the base ${base.slice(0, 12)} has no workspace declaration, so the check hooks this change declares do not run until it merges` };
80
+ throw new Error(`ci.hooks.check is read from the workspace declaration at ${base.slice(0, 12)}, and it could not be read (${why}), so no check hook can be trusted to run`);
81
+ }
82
+ return missing ? { hooks: [], base } : { hooks: [], base, note: `ci.hooks.check: the declaration at ${base.slice(0, 12)} could not be read (${why}); this checkout names no check hooks, so none run` };
83
+ }
84
+ return { hooks: checkHooksOf(declaration, memberAtCwd({ declaration, rootOnDisk }, cwd)), base };
85
+ }
86
+
87
+ /** Variables that hold cloud credentials beyond the ones chant's own trade sets. */
88
+ const CLOUD_CREDENTIAL_VARS = [
89
+ "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_SESSION_TOKEN", "AWS_SECURITY_TOKEN", "AWS_WEB_IDENTITY_TOKEN_FILE", "AWS_ROLE_ARN", "AWS_PROFILE", "AWS_CONTAINER_CREDENTIALS_FULL_URI", "AWS_CONTAINER_CREDENTIALS_RELATIVE_URI", "AWS_CONTAINER_AUTHORIZATION_TOKEN",
90
+ "GOOGLE_APPLICATION_CREDENTIALS", "GOOGLE_CREDENTIALS", "GOOGLE_OAUTH_ACCESS_TOKEN", "CLOUDSDK_AUTH_ACCESS_TOKEN", "CLOUDSDK_AUTH_CREDENTIAL_FILE_OVERRIDE",
91
+ "AZURE_CLIENT_SECRET", "AZURE_CLIENT_CERTIFICATE_PATH", "AZURE_FEDERATED_TOKEN_FILE", "AZURE_ACCESS_TOKEN", "ARM_CLIENT_SECRET", "ARM_CLIENT_CERTIFICATE_PATH", "ARM_OIDC_TOKEN", "ARM_OIDC_TOKEN_FILE_PATH", "ARM_ACCESS_KEY", "ARM_SAS_TOKEN",
92
+ "PULUMI_ACCESS_TOKEN", "PULUMI_CONFIG_PASSPHRASE", "TFE_TOKEN", "TF_TOKEN_app_terraform_io",
93
+ ];
94
+
95
+ /**
96
+ * The environment a check hook runs with (#4556): `env` without a forge
97
+ * token, the OIDC request variables, or cloud credentials, and without any
98
+ * `TF_TOKEN_<host>` registry token. A check reads the change and nothing
99
+ * else.
100
+ */
101
+ export function checkHookEnv(env: NodeJS.ProcessEnv = process.env): Record<string, string> {
102
+ const drop = new Set<string>([...FORGE_TOKEN_VARS, ...OIDC_REQUEST_VARS, ...Object.values(TRADED_VARS).flat(), ...CLOUD_CREDENTIAL_VARS]);
103
+ const out: Record<string, string> = {};
104
+ for (const [name, value] of Object.entries(env)) {
105
+ if (value === undefined || drop.has(name) || name.startsWith("TF_TOKEN_")) continue;
106
+ out[name] = value;
107
+ }
108
+ return out;
109
+ }
110
+
111
+ /** {@link OpWaveExec} with {@link checkHookEnv} in place of the job's environment. */
112
+ export const checkHookExec: OpWaveExec = (argv, cwd, env) => {
113
+ const result = spawnSync(argv[0]!, argv.slice(1), { cwd, stdio: "inherit", env: { ...checkHookEnv(), ...env } });
114
+ if (result.error) throw result.error;
115
+ return result.status ?? 1;
116
+ };
117
+
118
+ /** One check hook's run, as the check report lists it. */
119
+ export interface CheckHookOutcome {
120
+ name: string;
121
+ /** The target, for a `perRun` hook. */
122
+ target?: string;
123
+ exit: number;
124
+ outcome: "passed" | "failed" | "skipped";
125
+ reason?: string;
126
+ }
127
+
128
+ /** What the check hooks came to, for the product's check report. */
129
+ export interface CheckHooksReport {
130
+ version: 1;
131
+ moment: typeof CHECK_HOOK_MOMENT;
132
+ /** The commit the hooks were read at. */
133
+ base: string;
134
+ targets: string[];
135
+ /** `none`: no check hook is declared at base. */
136
+ status: "passed" | "failed" | "none";
137
+ hooks: CheckHookOutcome[];
138
+ /** The lexicons' check steps (#4633, `./check-steps.ts`), when any ran. */
139
+ steps?: CheckStepOutcome[];
140
+ /** The first hook that failed, and why; the hooks after it did not run. Or the check steps that failed. */
141
+ failed?: string;
142
+ note?: string;
143
+ }
144
+
145
+ /** Where {@link runCheckHooks} writes its runs file and report unless told: `.chant/check`. */
146
+ export const CHECK_HOOKS_DIR = ".chant/check";
147
+
148
+ /** The report file under the directory. */
149
+ export const CHECK_HOOKS_REPORT_FILE = "check-hooks.json";
150
+
151
+ export interface RunCheckHooksOptions {
152
+ /** The commit to read `ci.hooks.check` at: the base the change is measured from. */
153
+ base: string;
154
+ /** The targets the change touches (roots, stacks or components), for `perRun` hooks and `targets`. */
155
+ targets?: readonly string[];
156
+ /** Default the working directory. */
157
+ cwd?: string;
158
+ /** Where the runs file and the report go, relative to `cwd`. Default {@link CHECK_HOOKS_DIR}. */
159
+ dir?: string;
160
+ /** The hooks, when the caller read them itself. Default {@link checkHooksAt} `base`. */
161
+ read?: CheckHooksRead;
162
+ /** Added to every hook's environment, after {@link checkHookEnv}. */
163
+ env?: Record<string, string>;
164
+ /** Default {@link checkHookExec}. */
165
+ exec?: OpWaveExec;
166
+ log?: (line: string) => void;
167
+ }
168
+
169
+ /**
170
+ * Run the check hooks (#4556): each once, or once per target with
171
+ * `perRun`, in order, stopping at the first that fails. Writes the runs file
172
+ * (`{runs}`, `CHANT_RUNS`) and the report under `dir`, and returns the
173
+ * report.
174
+ */
175
+ export function runCheckHooks(options: RunCheckHooksOptions): CheckHooksReport {
176
+ const cwd = options.cwd ?? process.cwd();
177
+ const log = options.log ?? ((line: string) => console.error(line));
178
+ const read = options.read ?? checkHooksAt(cwd, options.base);
179
+ if (read.note) log(read.note);
180
+ const targets = [...(options.targets ?? [])];
181
+ const dir = relative(cwd, resolve(cwd, options.dir ?? CHECK_HOOKS_DIR)) || ".";
182
+ mkdirSync(join(cwd, dir), { recursive: true });
183
+ const report = (r: Omit<CheckHooksReport, "version" | "moment" | "base" | "targets">): CheckHooksReport => {
184
+ const doc: CheckHooksReport = { version: 1, moment: CHECK_HOOK_MOMENT, base: read.base, targets, ...r, ...(read.note ? { note: read.note } : {}) };
185
+ writeFileSync(join(cwd, dir, CHECK_HOOKS_REPORT_FILE), JSON.stringify(doc, null, 2) + "\n");
186
+ return doc;
187
+ };
188
+ if (read.hooks.length === 0) return report({ status: "none", hooks: [] });
189
+ assertCheckHooks("ci.hooks at base", read.hooks);
190
+ const op = "check";
191
+ const runs: OpWaveHookRun[] = targets.map((target) => ({ target, op }));
192
+ const runsFile = join(dir, "runs.json");
193
+ writeFileSync(join(cwd, runsFile), JSON.stringify({ version: 1, op, stage: "check", base: read.base, hook: CHECK_HOOK_MOMENT, runs }, null, 2) + "\n");
194
+ const ran = runStageHooks(CHECK_HOOK_MOMENT, read.hooks, {
195
+ name: op,
196
+ op,
197
+ wave: op,
198
+ runs,
199
+ runsFile,
200
+ holdFile: join(dir, "hold.json"),
201
+ env: { CHANT_CHECK: "1", CHANT_HOOKS_BASE: read.base, ...options.env },
202
+ cwd,
203
+ exec: options.exec ?? checkHookExec,
204
+ log,
205
+ });
206
+ const hooks = ran.outcomes.map((o): CheckHookOutcome => ({
207
+ name: o.name,
208
+ ...(o.target ? { target: o.target } : {}),
209
+ exit: o.exit,
210
+ outcome: o.outcome === "skipped" ? "skipped" : o.outcome === "passed" ? "passed" : "failed",
211
+ ...(o.reason ? { reason: o.reason } : {}),
212
+ }));
213
+ const failed = ran.failed ?? (hooks.some((h) => h.outcome === "failed") ? `a check hook failed: ${hooks.filter((h) => h.outcome === "failed").map((h) => h.name).join(", ")}` : undefined);
214
+ return report({ status: failed ? "failed" : "passed", hooks, ...(failed ? { failed } : {}) });
215
+ }
216
+
217
+ /**
218
+ * Add `hook` to `ci.hooks.<moment>` of the workspace declaration at `root`
219
+ * (#4556), the top level's or `member`'s, keeping the file's formatting. A
220
+ * hook of the same `name` at that moment is replaced, so a product's `init`
221
+ * can run again. Refuses a check hook the check job could not run. Returns
222
+ * the declaration file it wrote.
223
+ */
224
+ export function writeCiHook(
225
+ root: string,
226
+ moment: "check",
227
+ hook: OpWaveHook,
228
+ opts: { member?: string } = {},
229
+ ): { file: string; replaced: boolean } {
230
+ assertCheckHooks(`ci.hooks.${moment}`, [hook]);
231
+ const file = DECLARATION_FILES.map((f) => join(root, f)).find((f) => existsSync(f));
232
+ if (!file) throw new Error(`no workspace declaration at ${root}; create one before adding ci.hooks`);
233
+ const jsonc = file.endsWith(".jsonc");
234
+ const text = readFileSync(file, "utf-8");
235
+ const parsed = parseJsonText(text, { jsonc });
236
+ if (!parsed.ok) throw new Error(`${file} is not valid JSON${jsonc ? "C" : ""}: ${parsed.message}`);
237
+ const doc = parsed.value as { members?: Array<{ name?: string }> };
238
+ let owner = "";
239
+ if (opts.member !== undefined) {
240
+ const index = (doc.members ?? []).findIndex((m) => m?.name === opts.member);
241
+ if (index < 0) throw new Error(`the workspace declaration names no member ${JSON.stringify(opts.member)}`);
242
+ owner = `/members/${index}`;
243
+ }
244
+ const ci = valueAt(doc, `${owner}/ci`) as { hooks?: CiHooks } | undefined;
245
+ const current: OpWaveHook[] = ci?.hooks?.[moment] ?? [];
246
+ const name = hook.name ?? hook.command.join(" ");
247
+ const at = current.findIndex((h) => (h.name ?? h.command.join(" ")) === name);
248
+ const next = at < 0 ? [...current, hook] : current.map((h, i) => (i === at ? hook : h));
249
+ const written =
250
+ ci === undefined ? setProperty(text, jsonc, owner, "ci", { hooks: { [moment]: next } })
251
+ : ci.hooks === undefined ? setProperty(text, jsonc, `${owner}/ci`, "hooks", { [moment]: next })
252
+ : setProperty(text, jsonc, `${owner}/ci/hooks`, moment, next);
253
+ writeFileSync(file, written);
254
+ return { file, replaced: at >= 0 };
255
+ }
@@ -0,0 +1,70 @@
1
+ import { mkdtempSync, readFileSync } from "node:fs";
2
+ import { tmpdir } from "node:os";
3
+ import { join } from "node:path";
4
+ import { describe, expect, test } from "vitest";
5
+ import { runCheckStage, runCheckSteps, type CheckStepsAdapter } from "./check-steps";
6
+
7
+ const members = [
8
+ { name: "web", dir: "/w/web", kind: "pulumi", fields: null },
9
+ { name: "net", dir: "/w/net", kind: "choudoufu", fields: null },
10
+ ];
11
+
12
+ function adapter(outcome: "passed" | "failed", seen: string[] = []): CheckStepsAdapter {
13
+ return {
14
+ lexicon: "fake",
15
+ kinds: ["pulumi"],
16
+ async run(ctx) {
17
+ seen.push(...ctx.members.map((m) => m.name), `env:${Object.keys(ctx.env).sort().join(",")}`);
18
+ return ctx.members.map((m) => ({ lexicon: "fake", step: "install", member: m.name, stack: "dev", exit: outcome === "passed" ? 0 : 2, outcome, ...(outcome === "failed" ? { reason: `install failed for member ${m.name}, stack dev` } : {}) }));
19
+ },
20
+ };
21
+ }
22
+
23
+ describe("lexicon check steps (#4633)", () => {
24
+ test("an adapter runs for the members of its kinds only", async () => {
25
+ const seen: string[] = [];
26
+ const out = await runCheckSteps({ adapters: [adapter("passed", seen)], members, env: { PATH: "/bin" }, log: () => {} });
27
+ expect(seen).toEqual(["web", "env:PATH"]);
28
+ expect(out).toEqual([expect.objectContaining({ member: "web", outcome: "passed" })]);
29
+ });
30
+
31
+ test("an adapter that throws fails each of its members, naming the lexicon", async () => {
32
+ const broken: CheckStepsAdapter = { lexicon: "fake", kinds: ["pulumi"], run: async () => { throw new Error("boom"); } };
33
+ const out = await runCheckSteps({ adapters: [broken], members, env: {}, log: () => {} });
34
+ expect(out).toEqual([expect.objectContaining({ member: "web", outcome: "failed", reason: "the fake check steps for web could not run: boom" })]);
35
+ });
36
+
37
+ test("the stage runs the steps after passing hooks, and the report carries both", async () => {
38
+ const cwd = mkdtempSync(join(tmpdir(), "chant-check-steps-"));
39
+ const report = await runCheckStage({
40
+ base: "abc123",
41
+ cwd,
42
+ read: { base: "abc123", hooks: [{ name: "fmt", command: ["fmt"] }] },
43
+ exec: () => 0,
44
+ adapters: [adapter("failed")],
45
+ members,
46
+ env: { GITHUB_TOKEN: "t" },
47
+ log: () => {},
48
+ });
49
+ expect(report.status).toBe("failed");
50
+ expect(report.hooks.map((h) => h.outcome)).toEqual(["passed"]);
51
+ expect(report.failed).toBe("a check step failed: install failed for member web, stack dev");
52
+ const written = JSON.parse(readFileSync(join(cwd, ".chant/check/check-hooks.json"), "utf8"));
53
+ expect(written.steps).toHaveLength(1);
54
+ });
55
+
56
+ test("a failed hook stops the stage before the steps", async () => {
57
+ const seen: string[] = [];
58
+ const cwd = mkdtempSync(join(tmpdir(), "chant-check-steps-"));
59
+ const report = await runCheckStage({ base: "abc", cwd, read: { base: "abc", hooks: [{ name: "lint", command: ["lint"] }] }, exec: () => 1, adapters: [adapter("passed", seen)], members, log: () => {} });
60
+ expect(report.status).toBe("failed");
61
+ expect(report.steps).toBeUndefined();
62
+ expect(seen).toEqual([]);
63
+ });
64
+
65
+ test("with no hooks and no members of the adapter's kinds, nothing ran", async () => {
66
+ const cwd = mkdtempSync(join(tmpdir(), "chant-check-steps-"));
67
+ const report = await runCheckStage({ base: "abc", cwd, read: { base: "abc", hooks: [] }, adapters: [adapter("passed")], members: [members[1]!], log: () => {} });
68
+ expect(report.status).toBe("none");
69
+ });
70
+ });