@intentius/chant 0.124.54 → 0.124.56

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1077) hide show
  1. package/dist/__fixtures__/estate-ledger.d.ts +13 -0
  2. package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
  3. package/dist/__fixtures__/estate-ledger.js +67 -0
  4. package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
  5. package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
  6. package/dist/__fixtures__/oidc-emulator.js +26 -2
  7. package/dist/__fixtures__/product-words.d.ts +78 -0
  8. package/dist/__fixtures__/product-words.d.ts.map +1 -0
  9. package/dist/__fixtures__/product-words.js +43 -0
  10. package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  11. package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  12. package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  13. package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  14. package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  15. package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  16. package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
  17. package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
  18. package/dist/__golden__/wave-loop/op-held-on.json +28 -7
  19. package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  20. package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  21. package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  22. package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
  23. package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  24. package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
  25. package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
  26. package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
  27. package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  28. package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  29. package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
  30. package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  31. package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  32. package/dist/__golden__/wave-loop/op-overridden.json +28 -7
  33. package/dist/__golden__/wave-loop/op-per-run.json +20 -4
  34. package/dist/__golden__/wave-loop/op-point.json +18 -4
  35. package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
  36. package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
  37. package/dist/__golden__/wave-loop/op-spend.json +10 -2
  38. package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
  39. package/dist/__golden__/wave-loop/op-wide.json +20 -4
  40. package/dist/bucket-check/azure.d.ts +108 -0
  41. package/dist/bucket-check/azure.d.ts.map +1 -0
  42. package/dist/bucket-check/azure.js +258 -0
  43. package/dist/bucket-check/fixtures/azure.json +153 -0
  44. package/dist/bucket-check/fixtures/gcs.json +148 -0
  45. package/dist/bucket-check/fixtures/s3.json +277 -0
  46. package/dist/bucket-check/gcs.d.ts +77 -0
  47. package/dist/bucket-check/gcs.d.ts.map +1 -0
  48. package/dist/bucket-check/gcs.js +202 -0
  49. package/dist/bucket-check/index.d.ts +48 -0
  50. package/dist/bucket-check/index.d.ts.map +1 -0
  51. package/dist/bucket-check/index.js +44 -0
  52. package/dist/bucket-check/s3.d.ts +116 -0
  53. package/dist/bucket-check/s3.d.ts.map +1 -0
  54. package/dist/bucket-check/s3.js +362 -0
  55. package/dist/bucket-check/types.d.ts +66 -0
  56. package/dist/bucket-check/types.d.ts.map +1 -0
  57. package/dist/bucket-check/types.js +31 -0
  58. package/dist/bucket-check/wire.d.ts +27 -0
  59. package/dist/bucket-check/wire.d.ts.map +1 -0
  60. package/dist/bucket-check/wire.js +32 -0
  61. package/dist/bucket-check.d.ts +6 -0
  62. package/dist/bucket-check.d.ts.map +1 -0
  63. package/dist/bucket-check.js +5 -0
  64. package/dist/capabilities/templates.d.ts.map +1 -1
  65. package/dist/capabilities/templates.js +1 -2
  66. package/dist/change-set.d.ts.map +1 -1
  67. package/dist/change-set.js +2 -3
  68. package/dist/ci-agent.d.ts +381 -0
  69. package/dist/ci-agent.d.ts.map +1 -0
  70. package/dist/ci-agent.js +832 -0
  71. package/dist/ci-audit/attribution.d.ts +111 -0
  72. package/dist/ci-audit/attribution.d.ts.map +1 -0
  73. package/dist/ci-audit/attribution.js +194 -0
  74. package/dist/ci-audit/audit-log.d.ts +144 -0
  75. package/dist/ci-audit/audit-log.d.ts.map +1 -0
  76. package/dist/ci-audit/audit-log.js +149 -0
  77. package/dist/ci-audit/index.d.ts +12 -0
  78. package/dist/ci-audit/index.d.ts.map +1 -0
  79. package/dist/ci-audit/index.js +12 -0
  80. package/dist/ci-audit/unrecorded.d.ts +74 -0
  81. package/dist/ci-audit/unrecorded.d.ts.map +1 -0
  82. package/dist/ci-audit/unrecorded.js +95 -0
  83. package/dist/ci-audit.d.ts +3 -0
  84. package/dist/ci-audit.d.ts.map +1 -0
  85. package/dist/ci-audit.js +2 -0
  86. package/dist/ci-control.d.ts +42 -0
  87. package/dist/ci-control.d.ts.map +1 -0
  88. package/dist/ci-control.js +41 -0
  89. package/dist/ci-estate/delivery.d.ts +137 -0
  90. package/dist/ci-estate/delivery.d.ts.map +1 -0
  91. package/dist/ci-estate/delivery.js +311 -0
  92. package/dist/ci-estate/overdue.d.ts +34 -0
  93. package/dist/ci-estate/overdue.d.ts.map +1 -0
  94. package/dist/ci-estate/overdue.js +58 -0
  95. package/dist/ci-estate/page.d.ts +134 -0
  96. package/dist/ci-estate/page.d.ts.map +1 -0
  97. package/dist/ci-estate/page.js +233 -0
  98. package/dist/ci-estate/rows.d.ts +118 -0
  99. package/dist/ci-estate/rows.d.ts.map +1 -0
  100. package/dist/ci-estate/rows.js +126 -0
  101. package/dist/ci-estate.d.ts +92 -0
  102. package/dist/ci-estate.d.ts.map +1 -0
  103. package/dist/ci-estate.js +82 -0
  104. package/dist/ci-handover.d.ts +29 -5
  105. package/dist/ci-handover.d.ts.map +1 -1
  106. package/dist/ci-handover.js +50 -16
  107. package/dist/ci-identity.d.ts +82 -7
  108. package/dist/ci-identity.d.ts.map +1 -1
  109. package/dist/ci-identity.js +86 -15
  110. package/dist/ci-job-guard.d.ts +139 -0
  111. package/dist/ci-job-guard.d.ts.map +1 -0
  112. package/dist/ci-job-guard.js +287 -0
  113. package/dist/ci-jobs.d.ts +7 -0
  114. package/dist/ci-jobs.d.ts.map +1 -1
  115. package/dist/ci-jobs.js +7 -0
  116. package/dist/ci-product-words.d.ts +296 -0
  117. package/dist/ci-product-words.d.ts.map +1 -0
  118. package/dist/ci-product-words.js +407 -0
  119. package/dist/ci-product.d.ts +117 -0
  120. package/dist/ci-product.d.ts.map +1 -0
  121. package/dist/ci-product.js +113 -0
  122. package/dist/ci-respond-run.d.ts +73 -0
  123. package/dist/ci-respond-run.d.ts.map +1 -0
  124. package/dist/ci-respond-run.js +247 -0
  125. package/dist/ci-respond.d.ts +189 -0
  126. package/dist/ci-respond.d.ts.map +1 -0
  127. package/dist/ci-respond.js +285 -0
  128. package/dist/cli/commands/audit.d.ts +2 -2
  129. package/dist/cli/commands/audit.d.ts.map +1 -1
  130. package/dist/cli/commands/audit.js +3 -2
  131. package/dist/cli/commands/carve.js +2 -2
  132. package/dist/cli/commands/init.d.ts +2 -0
  133. package/dist/cli/commands/init.d.ts.map +1 -1
  134. package/dist/cli/commands/init.js +1 -1
  135. package/dist/cli/handlers/agent.d.ts +17 -0
  136. package/dist/cli/handlers/agent.d.ts.map +1 -0
  137. package/dist/cli/handlers/agent.js +114 -0
  138. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  139. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  140. package/dist/cli/handlers/approve-confirm.js +142 -0
  141. package/dist/cli/handlers/approve.d.ts.map +1 -1
  142. package/dist/cli/handlers/approve.js +19 -1
  143. package/dist/cli/handlers/audit-log.d.ts +12 -0
  144. package/dist/cli/handlers/audit-log.d.ts.map +1 -0
  145. package/dist/cli/handlers/audit-log.js +81 -0
  146. package/dist/cli/handlers/build.d.ts +7 -0
  147. package/dist/cli/handlers/build.d.ts.map +1 -1
  148. package/dist/cli/handlers/build.js +124 -1
  149. package/dist/cli/handlers/ci-check-job.d.ts +11 -0
  150. package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
  151. package/dist/cli/handlers/ci-check-job.js +27 -0
  152. package/dist/cli/handlers/ci-check.d.ts +3 -0
  153. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  154. package/dist/cli/handlers/ci-check.js +63 -0
  155. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  156. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  157. package/dist/cli/handlers/ci-forge-check.js +89 -0
  158. package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
  159. package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
  160. package/dist/cli/handlers/e2e-safe-run.js +23 -0
  161. package/dist/cli/handlers/fan-out.js +4 -0
  162. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  163. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  164. package/dist/cli/handlers/gate-pending.js +44 -0
  165. package/dist/cli/handlers/init.d.ts.map +1 -1
  166. package/dist/cli/handlers/init.js +1 -0
  167. package/dist/cli/handlers/ledger.js +1 -1
  168. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  169. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  170. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  171. package/dist/cli/handlers/lock.d.ts.map +1 -1
  172. package/dist/cli/handlers/lock.js +64 -5
  173. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  174. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  175. package/dist/cli/handlers/notify-relay.js +130 -0
  176. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  177. package/dist/cli/handlers/pr-env.js +42 -11
  178. package/dist/cli/handlers/pr.d.ts +43 -3
  179. package/dist/cli/handlers/pr.d.ts.map +1 -1
  180. package/dist/cli/handlers/pr.js +908 -205
  181. package/dist/cli/handlers/promote.d.ts.map +1 -1
  182. package/dist/cli/handlers/promote.js +21 -2
  183. package/dist/cli/handlers/release.d.ts.map +1 -1
  184. package/dist/cli/handlers/release.js +3 -0
  185. package/dist/cli/handlers/run-wave.d.ts +8 -0
  186. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  187. package/dist/cli/handlers/run-wave.js +160 -2
  188. package/dist/cli/handlers/run.d.ts +6 -1
  189. package/dist/cli/handlers/run.d.ts.map +1 -1
  190. package/dist/cli/handlers/run.js +86 -1
  191. package/dist/cli/handlers/serve.d.ts.map +1 -1
  192. package/dist/cli/handlers/serve.js +10 -1
  193. package/dist/cli/main.d.ts +11 -1
  194. package/dist/cli/main.d.ts.map +1 -1
  195. package/dist/cli/main.js +178 -13
  196. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  197. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  198. package/dist/cli/mcp/ledger-tools.js +122 -0
  199. package/dist/cli/mcp/product-tools.d.ts +78 -0
  200. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  201. package/dist/cli/mcp/product-tools.js +93 -0
  202. package/dist/cli/mcp/read-only.d.ts +34 -0
  203. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  204. package/dist/cli/mcp/read-only.js +61 -0
  205. package/dist/cli/mcp/report-tools.d.ts +48 -0
  206. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  207. package/dist/cli/mcp/report-tools.js +128 -0
  208. package/dist/cli/mcp/server.d.ts +28 -1
  209. package/dist/cli/mcp/server.d.ts.map +1 -1
  210. package/dist/cli/mcp/server.js +86 -15
  211. package/dist/cli/mcp-config.d.ts +9 -2
  212. package/dist/cli/mcp-config.d.ts.map +1 -1
  213. package/dist/cli/mcp-config.js +8 -3
  214. package/dist/cli/parse-args.d.ts.map +1 -1
  215. package/dist/cli/parse-args.js +164 -3
  216. package/dist/cli/registry.d.ts +73 -0
  217. package/dist/cli/registry.d.ts.map +1 -1
  218. package/dist/cloud-lister/sigv4.d.ts +42 -7
  219. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  220. package/dist/cloud-lister/sigv4.js +72 -22
  221. package/dist/components/adoption.d.ts +69 -0
  222. package/dist/components/adoption.d.ts.map +1 -0
  223. package/dist/components/adoption.js +92 -0
  224. package/dist/components/apply-lease.d.ts +19 -0
  225. package/dist/components/apply-lease.d.ts.map +1 -0
  226. package/dist/components/apply-lease.js +41 -0
  227. package/dist/components/capability.d.ts +159 -5
  228. package/dist/components/capability.d.ts.map +1 -1
  229. package/dist/components/capability.js +39 -6
  230. package/dist/components/check-hooks.d.ts +116 -0
  231. package/dist/components/check-hooks.d.ts.map +1 -0
  232. package/dist/components/check-hooks.js +192 -0
  233. package/dist/components/check-steps.d.ts +74 -0
  234. package/dist/components/check-steps.d.ts.map +1 -0
  235. package/dist/components/check-steps.js +102 -0
  236. package/dist/components/ci-services.d.ts +57 -0
  237. package/dist/components/ci-services.d.ts.map +1 -0
  238. package/dist/components/ci-services.js +60 -0
  239. package/dist/components/cli-support.d.ts +13 -0
  240. package/dist/components/cli-support.d.ts.map +1 -1
  241. package/dist/components/cli-support.js +10 -2
  242. package/dist/components/driver.d.ts +32 -3
  243. package/dist/components/driver.d.ts.map +1 -1
  244. package/dist/components/driver.js +59 -5
  245. package/dist/components/fan-out-run.d.ts +12 -0
  246. package/dist/components/fan-out-run.d.ts.map +1 -1
  247. package/dist/components/fan-out-run.js +56 -16
  248. package/dist/components/groups.d.ts.map +1 -1
  249. package/dist/components/groups.js +23 -5
  250. package/dist/components/pr-env-ledger.d.ts +32 -0
  251. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  252. package/dist/components/pr-env-ledger.js +38 -0
  253. package/dist/components/pr-env-ports.d.ts +12 -0
  254. package/dist/components/pr-env-ports.d.ts.map +1 -1
  255. package/dist/components/pr-env-ports.js +13 -3
  256. package/dist/components/pr-env-run.d.ts +6 -0
  257. package/dist/components/pr-env-run.d.ts.map +1 -1
  258. package/dist/components/pr-env-run.js +3 -2
  259. package/dist/components/pr-environment.d.ts +32 -4
  260. package/dist/components/pr-environment.d.ts.map +1 -1
  261. package/dist/components/pr-environment.js +26 -8
  262. package/dist/components/pr-pipeline.d.ts +297 -5
  263. package/dist/components/pr-pipeline.d.ts.map +1 -1
  264. package/dist/components/pr-pipeline.js +329 -18
  265. package/dist/components/pr-policy.d.ts +26 -2
  266. package/dist/components/pr-policy.d.ts.map +1 -1
  267. package/dist/components/pr-policy.js +41 -7
  268. package/dist/components/pr-run.d.ts +71 -0
  269. package/dist/components/pr-run.d.ts.map +1 -1
  270. package/dist/components/pr-run.js +91 -7
  271. package/dist/components/pr-targets.d.ts +24 -0
  272. package/dist/components/pr-targets.d.ts.map +1 -0
  273. package/dist/components/pr-targets.js +48 -0
  274. package/dist/components/product-pipeline.d.ts +250 -0
  275. package/dist/components/product-pipeline.d.ts.map +1 -0
  276. package/dist/components/product-pipeline.js +212 -0
  277. package/dist/components/promote.d.ts +6 -0
  278. package/dist/components/promote.d.ts.map +1 -1
  279. package/dist/components/promote.js +4 -1
  280. package/dist/components/release-compile.d.ts +22 -1
  281. package/dist/components/release-compile.d.ts.map +1 -1
  282. package/dist/components/release-compile.js +85 -0
  283. package/dist/components/release-promote.d.ts +15 -1
  284. package/dist/components/release-promote.d.ts.map +1 -1
  285. package/dist/components/release-promote.js +67 -2
  286. package/dist/components/repo-lock.d.ts +27 -0
  287. package/dist/components/repo-lock.d.ts.map +1 -0
  288. package/dist/components/repo-lock.js +49 -0
  289. package/dist/components/row-lease.d.ts +84 -0
  290. package/dist/components/row-lease.d.ts.map +1 -0
  291. package/dist/components/row-lease.js +110 -0
  292. package/dist/components/wave-plan.d.ts +42 -0
  293. package/dist/components/wave-plan.d.ts.map +1 -1
  294. package/dist/components/wave-plan.js +72 -4
  295. package/dist/control/applied.d.ts +89 -0
  296. package/dist/control/applied.d.ts.map +1 -0
  297. package/dist/control/applied.js +175 -0
  298. package/dist/control/consumers.d.ts +78 -0
  299. package/dist/control/consumers.d.ts.map +1 -0
  300. package/dist/control/consumers.js +172 -0
  301. package/dist/control/dispatch.d.ts +334 -0
  302. package/dist/control/dispatch.d.ts.map +1 -0
  303. package/dist/control/dispatch.js +519 -0
  304. package/dist/control/edges.d.ts +75 -0
  305. package/dist/control/edges.d.ts.map +1 -0
  306. package/dist/control/edges.js +133 -0
  307. package/dist/control/reconcile.d.ts +120 -0
  308. package/dist/control/reconcile.d.ts.map +1 -0
  309. package/dist/control/reconcile.js +178 -0
  310. package/dist/control/records.d.ts +187 -0
  311. package/dist/control/records.d.ts.map +1 -0
  312. package/dist/control/records.js +307 -0
  313. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  314. package/dist/discovery/sandbox/bundle.js +25 -1
  315. package/dist/e2e-harness/bucket.d.ts +21 -0
  316. package/dist/e2e-harness/bucket.d.ts.map +1 -0
  317. package/dist/e2e-harness/bucket.js +61 -0
  318. package/dist/e2e-harness/claim.d.ts +70 -0
  319. package/dist/e2e-harness/claim.d.ts.map +1 -0
  320. package/dist/e2e-harness/claim.js +98 -0
  321. package/dist/e2e-harness/driver.d.ts +64 -0
  322. package/dist/e2e-harness/driver.d.ts.map +1 -0
  323. package/dist/e2e-harness/driver.js +243 -0
  324. package/dist/e2e-harness/forgejo.d.ts +77 -0
  325. package/dist/e2e-harness/forgejo.d.ts.map +1 -0
  326. package/dist/e2e-harness/forgejo.js +205 -0
  327. package/dist/e2e-harness/git.d.ts +32 -0
  328. package/dist/e2e-harness/git.d.ts.map +1 -0
  329. package/dist/e2e-harness/git.js +67 -0
  330. package/dist/e2e-harness/index.d.ts +22 -0
  331. package/dist/e2e-harness/index.d.ts.map +1 -0
  332. package/dist/e2e-harness/index.js +48 -0
  333. package/dist/e2e-harness/jobs.d.ts +8 -0
  334. package/dist/e2e-harness/jobs.d.ts.map +1 -0
  335. package/dist/e2e-harness/jobs.js +34 -0
  336. package/dist/e2e-harness/pins.d.ts +45 -0
  337. package/dist/e2e-harness/pins.d.ts.map +1 -0
  338. package/dist/e2e-harness/pins.js +44 -0
  339. package/dist/e2e-harness/ports.d.ts +113 -0
  340. package/dist/e2e-harness/ports.d.ts.map +1 -0
  341. package/dist/e2e-harness/ports.js +4 -0
  342. package/dist/e2e-harness/reports.d.ts +45 -0
  343. package/dist/e2e-harness/reports.d.ts.map +1 -0
  344. package/dist/e2e-harness/reports.js +57 -0
  345. package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
  346. package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
  347. package/dist/e2e-harness/safe-run-cli.js +43 -0
  348. package/dist/e2e-harness/safe-run.d.ts +61 -0
  349. package/dist/e2e-harness/safe-run.d.ts.map +1 -0
  350. package/dist/e2e-harness/safe-run.js +172 -0
  351. package/dist/e2e-harness/scenario.d.ts +11 -0
  352. package/dist/e2e-harness/scenario.d.ts.map +1 -0
  353. package/dist/e2e-harness/scenario.js +89 -0
  354. package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  355. package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
  356. package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  357. package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  358. package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  359. package/dist/e2e-harness/schemas/index.d.ts +191 -0
  360. package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
  361. package/dist/e2e-harness/schemas/index.js +62 -0
  362. package/dist/e2e-harness/stack.d.ts +124 -0
  363. package/dist/e2e-harness/stack.d.ts.map +1 -0
  364. package/dist/e2e-harness/stack.js +207 -0
  365. package/dist/e2e-harness/steps.d.ts +11 -0
  366. package/dist/e2e-harness/steps.d.ts.map +1 -0
  367. package/dist/e2e-harness/steps.js +22 -0
  368. package/dist/e2e-harness.d.ts +3 -0
  369. package/dist/e2e-harness.d.ts.map +1 -0
  370. package/dist/e2e-harness.js +2 -0
  371. package/dist/engine-facts.d.ts.map +1 -1
  372. package/dist/engine-facts.js +1 -2
  373. package/dist/exit-codes.d.ts +54 -0
  374. package/dist/exit-codes.d.ts.map +1 -0
  375. package/dist/exit-codes.js +55 -0
  376. package/dist/forge-check/check.d.ts +63 -0
  377. package/dist/forge-check/check.d.ts.map +1 -0
  378. package/dist/forge-check/check.js +139 -0
  379. package/dist/forge-check/contract.d.ts +152 -0
  380. package/dist/forge-check/contract.d.ts.map +1 -0
  381. package/dist/forge-check/contract.js +118 -0
  382. package/dist/forge-check/forge.d.ts +42 -0
  383. package/dist/forge-check/forge.d.ts.map +1 -0
  384. package/dist/forge-check/forge.js +338 -0
  385. package/dist/forge-check/index.d.ts +24 -0
  386. package/dist/forge-check/index.d.ts.map +1 -0
  387. package/dist/forge-check/index.js +23 -0
  388. package/dist/forge-check/pulumi.d.ts +44 -0
  389. package/dist/forge-check/pulumi.d.ts.map +1 -0
  390. package/dist/forge-check/pulumi.js +184 -0
  391. package/dist/forge-check/read-only.d.ts +26 -0
  392. package/dist/forge-check/read-only.d.ts.map +1 -0
  393. package/dist/forge-check/read-only.js +53 -0
  394. package/dist/forge-check/trust.d.ts +94 -0
  395. package/dist/forge-check/trust.d.ts.map +1 -0
  396. package/dist/forge-check/trust.js +532 -0
  397. package/dist/forge-check/types.d.ts +80 -0
  398. package/dist/forge-check/types.d.ts.map +1 -0
  399. package/dist/forge-check/types.js +18 -0
  400. package/dist/forge-check.d.ts +6 -0
  401. package/dist/forge-check.d.ts.map +1 -0
  402. package/dist/forge-check.js +5 -0
  403. package/dist/gate-decision.d.ts +1 -0
  404. package/dist/gate-decision.d.ts.map +1 -1
  405. package/dist/gate-decision.js +2 -0
  406. package/dist/gate-policy.d.ts +47 -1
  407. package/dist/gate-policy.d.ts.map +1 -1
  408. package/dist/gate-policy.js +50 -2
  409. package/dist/index.d.ts +1 -0
  410. package/dist/index.d.ts.map +1 -1
  411. package/dist/index.js +2 -0
  412. package/dist/lexicon.d.ts +152 -6
  413. package/dist/lexicon.d.ts.map +1 -1
  414. package/dist/lifecycle/adoption-file.d.ts +24 -0
  415. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  416. package/dist/lifecycle/adoption-file.js +1 -2
  417. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  418. package/dist/lifecycle/cloud-index.js +1 -2
  419. package/dist/lifecycle/gate-applied.d.ts +6 -0
  420. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  421. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  422. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  423. package/dist/lifecycle/gate-ledger.js +10 -1
  424. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  425. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  426. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  427. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  428. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  429. package/dist/lifecycle/gated-request-digest.js +35 -0
  430. package/dist/lifecycle/gated-request.d.ts +126 -0
  431. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  432. package/dist/lifecycle/gated-request.js +204 -0
  433. package/dist/lifecycle/identity-match.d.ts +15 -0
  434. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  435. package/dist/lifecycle/identity-match.js +11 -6
  436. package/dist/lifecycle/index-diff.d.ts +40 -0
  437. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  438. package/dist/lifecycle/index-diff.js +1 -2
  439. package/dist/lifecycle/index-document.d.ts.map +1 -1
  440. package/dist/lifecycle/index-document.js +1 -2
  441. package/dist/lifecycle/index-import.d.ts +4 -1
  442. package/dist/lifecycle/index-import.d.ts.map +1 -1
  443. package/dist/lifecycle/index-import.js +29 -32
  444. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  445. package/dist/lifecycle/ledger-read.js +7 -3
  446. package/dist/lifecycle/lock-rows.d.ts +76 -0
  447. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  448. package/dist/lifecycle/lock-rows.js +140 -0
  449. package/dist/lifecycle/query.d.ts +50 -3
  450. package/dist/lifecycle/query.d.ts.map +1 -1
  451. package/dist/lifecycle/query.js +97 -7
  452. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  453. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  454. package/dist/lifecycle/release-catalog-site.js +232 -0
  455. package/dist/lifecycle/release-catalog.d.ts +201 -0
  456. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  457. package/dist/lifecycle/release-catalog.js +198 -0
  458. package/dist/lifecycle/release-changelog.d.ts +41 -0
  459. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  460. package/dist/lifecycle/release-changelog.js +38 -0
  461. package/dist/lifecycle/release-cut.d.ts +1 -0
  462. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  463. package/dist/lifecycle/release-cut.js +1 -1
  464. package/dist/lifecycle/release-ledger.d.ts +16 -0
  465. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  466. package/dist/lifecycle/release-ledger.js +9 -0
  467. package/dist/lifecycle/release-publish.d.ts +43 -22
  468. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  469. package/dist/lifecycle/release-read.d.ts.map +1 -1
  470. package/dist/lifecycle/release-read.js +3 -0
  471. package/dist/lifecycle/release-status.d.ts +106 -0
  472. package/dist/lifecycle/release-status.d.ts.map +1 -0
  473. package/dist/lifecycle/release-status.js +115 -0
  474. package/dist/lifecycle/resource-lock.d.ts +120 -0
  475. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  476. package/dist/lifecycle/resource-lock.js +317 -0
  477. package/dist/lifecycle/retention.d.ts.map +1 -1
  478. package/dist/lifecycle/retention.js +3 -0
  479. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  480. package/dist/lifecycle/run-ledger.js +9 -1
  481. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  482. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  483. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  484. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  485. package/dist/lifecycle/snapshot-store.js +1 -2
  486. package/dist/lifecycle/target-lock.d.ts +15 -0
  487. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  488. package/dist/lifecycle/target-lock.js +25 -10
  489. package/dist/lifecycle/wave-plans.d.ts +23 -7
  490. package/dist/lifecycle/wave-plans.d.ts.map +1 -1
  491. package/dist/lifecycle/wave-plans.js +9 -2
  492. package/dist/mcp/types.d.ts +7 -0
  493. package/dist/mcp/types.d.ts.map +1 -1
  494. package/dist/notify-product.d.ts +43 -0
  495. package/dist/notify-product.d.ts.map +1 -0
  496. package/dist/notify-product.js +58 -0
  497. package/dist/notify-relay.d.ts +197 -0
  498. package/dist/notify-relay.d.ts.map +1 -0
  499. package/dist/notify-relay.js +321 -0
  500. package/dist/notify.d.ts +44 -4
  501. package/dist/notify.d.ts.map +1 -1
  502. package/dist/notify.js +77 -14
  503. package/dist/object-store/azure-blob.d.ts +129 -0
  504. package/dist/object-store/azure-blob.d.ts.map +1 -0
  505. package/dist/object-store/azure-blob.js +341 -0
  506. package/dist/object-store/common.d.ts +108 -0
  507. package/dist/object-store/common.d.ts.map +1 -0
  508. package/dist/object-store/common.js +80 -0
  509. package/dist/object-store/errors.d.ts +28 -0
  510. package/dist/object-store/errors.d.ts.map +1 -0
  511. package/dist/object-store/errors.js +21 -0
  512. package/dist/object-store/from-env.d.ts +18 -0
  513. package/dist/object-store/from-env.d.ts.map +1 -0
  514. package/dist/object-store/from-env.js +22 -0
  515. package/dist/object-store/gcs.d.ts +106 -0
  516. package/dist/object-store/gcs.d.ts.map +1 -0
  517. package/dist/object-store/gcs.js +393 -0
  518. package/dist/object-store/index.d.ts +9 -0
  519. package/dist/object-store/index.d.ts.map +1 -0
  520. package/dist/object-store/index.js +8 -0
  521. package/dist/object-store/s3.d.ts +146 -0
  522. package/dist/object-store/s3.d.ts.map +1 -0
  523. package/dist/object-store/s3.js +306 -0
  524. package/dist/op/activities/converge.d.ts.map +1 -1
  525. package/dist/op/activities/converge.js +2 -1
  526. package/dist/op/activities/index.d.ts +1 -1
  527. package/dist/op/activities/index.d.ts.map +1 -1
  528. package/dist/op/activities/index.js +1 -1
  529. package/dist/op/activities/review-agent.d.ts +55 -2
  530. package/dist/op/activities/review-agent.d.ts.map +1 -1
  531. package/dist/op/activities/review-agent.js +65 -5
  532. package/dist/op/approval-status.d.ts +103 -0
  533. package/dist/op/approval-status.d.ts.map +1 -0
  534. package/dist/op/approval-status.js +197 -0
  535. package/dist/op/gate.d.ts +29 -1
  536. package/dist/op/gate.d.ts.map +1 -1
  537. package/dist/op/gate.js +59 -23
  538. package/dist/op/generate-pipeline.d.ts.map +1 -1
  539. package/dist/op/generate-pipeline.js +7 -1
  540. package/dist/op/index.d.ts +12 -1
  541. package/dist/op/index.d.ts.map +1 -1
  542. package/dist/op/index.js +7 -1
  543. package/dist/op/op-waves-after-plan.d.ts +137 -0
  544. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  545. package/dist/op/op-waves-after-plan.js +163 -0
  546. package/dist/op/op-waves-capability-spec.d.ts +63 -0
  547. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  548. package/dist/op/op-waves-capability-spec.js +115 -0
  549. package/dist/op/op-waves-capability.d.ts +197 -0
  550. package/dist/op/op-waves-capability.d.ts.map +1 -0
  551. package/dist/op/op-waves-capability.js +311 -0
  552. package/dist/op/op-waves-events.d.ts +54 -0
  553. package/dist/op/op-waves-events.d.ts.map +1 -0
  554. package/dist/op/op-waves-events.js +122 -0
  555. package/dist/op/op-waves-notify.d.ts +7 -1
  556. package/dist/op/op-waves-notify.d.ts.map +1 -1
  557. package/dist/op/op-waves-notify.js +35 -16
  558. package/dist/op/op-waves-release-port.d.ts +18 -0
  559. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  560. package/dist/op/op-waves-release-port.js +61 -0
  561. package/dist/op/op-waves-release.d.ts +92 -0
  562. package/dist/op/op-waves-release.d.ts.map +1 -0
  563. package/dist/op/op-waves-release.js +96 -0
  564. package/dist/op/op-waves-run.d.ts +182 -6
  565. package/dist/op/op-waves-run.d.ts.map +1 -1
  566. package/dist/op/op-waves-run.js +1076 -44
  567. package/dist/op/op-waves-stand-down.d.ts +60 -0
  568. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  569. package/dist/op/op-waves-stand-down.js +96 -0
  570. package/dist/op/op-waves.d.ts +187 -8
  571. package/dist/op/op-waves.d.ts.map +1 -1
  572. package/dist/op/op-waves.js +203 -19
  573. package/dist/op/runtime.d.ts +95 -0
  574. package/dist/op/runtime.d.ts.map +1 -1
  575. package/dist/op/runtime.js +18 -0
  576. package/dist/op/stage-hooks.d.ts +45 -7
  577. package/dist/op/stage-hooks.d.ts.map +1 -1
  578. package/dist/op/stage-hooks.js +61 -3
  579. package/dist/op/steward-beside.d.ts.map +1 -1
  580. package/dist/op/steward-beside.js +2 -1
  581. package/dist/op/types.d.ts +2 -2
  582. package/dist/op/types.d.ts.map +1 -1
  583. package/dist/op/types.js +3 -2
  584. package/dist/otlp-metrics.d.ts +38 -0
  585. package/dist/otlp-metrics.d.ts.map +1 -0
  586. package/dist/otlp-metrics.js +82 -0
  587. package/dist/otlp.d.ts +249 -0
  588. package/dist/otlp.d.ts.map +1 -0
  589. package/dist/otlp.js +425 -0
  590. package/dist/override-gate.d.ts.map +1 -1
  591. package/dist/override-gate.js +5 -0
  592. package/dist/parallelism.d.ts +17 -0
  593. package/dist/parallelism.d.ts.map +1 -0
  594. package/dist/parallelism.js +33 -0
  595. package/dist/policy-packs.d.ts +69 -0
  596. package/dist/policy-packs.d.ts.map +1 -0
  597. package/dist/policy-packs.js +205 -0
  598. package/dist/policy-source.d.ts +51 -0
  599. package/dist/policy-source.d.ts.map +1 -0
  600. package/dist/policy-source.js +102 -0
  601. package/dist/pr-forge.d.ts +40 -0
  602. package/dist/pr-forge.d.ts.map +1 -1
  603. package/dist/pr-forge.js +146 -37
  604. package/dist/pr-loop.d.ts +158 -11
  605. package/dist/pr-loop.d.ts.map +1 -1
  606. package/dist/pr-loop.js +302 -44
  607. package/dist/pr-merge.d.ts +64 -0
  608. package/dist/pr-merge.d.ts.map +1 -0
  609. package/dist/pr-merge.js +78 -0
  610. package/dist/pr-post.d.ts +86 -1
  611. package/dist/pr-post.d.ts.map +1 -1
  612. package/dist/pr-post.js +141 -5
  613. package/dist/pr-report-url.d.ts +32 -4
  614. package/dist/pr-report-url.d.ts.map +1 -1
  615. package/dist/pr-report-url.js +45 -5
  616. package/dist/pr-requires.d.ts +13 -2
  617. package/dist/pr-requires.d.ts.map +1 -1
  618. package/dist/pr-requires.js +14 -0
  619. package/dist/release-floors.d.ts +1 -1
  620. package/dist/release-floors.js +1 -1
  621. package/dist/run-event.d.ts +26 -1
  622. package/dist/run-event.d.ts.map +1 -1
  623. package/dist/run-event.js +3 -1
  624. package/dist/scheduled-op-cloud.d.ts +32 -0
  625. package/dist/scheduled-op-cloud.d.ts.map +1 -0
  626. package/dist/scheduled-op-cloud.js +69 -0
  627. package/dist/sorted-json.d.ts +10 -0
  628. package/dist/sorted-json.d.ts.map +1 -0
  629. package/dist/sorted-json.js +14 -0
  630. package/dist/terraform/credentials.d.ts +59 -0
  631. package/dist/terraform/credentials.d.ts.map +1 -0
  632. package/dist/terraform/credentials.js +149 -0
  633. package/dist/utils.d.ts +1 -4
  634. package/dist/utils.d.ts.map +1 -1
  635. package/dist/utils.js +1 -9
  636. package/dist/wave-runtime.d.ts +1 -1
  637. package/dist/wave-runtime.js +2 -2
  638. package/dist/wave-runtime.mjs +405 -287
  639. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  640. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  641. package/dist/workspace/ci-lock-grain.d.ts +17 -0
  642. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  643. package/dist/workspace/ci-lock-grain.js +21 -0
  644. package/dist/workspace/ci-run.d.ts +2 -1
  645. package/dist/workspace/ci-run.d.ts.map +1 -1
  646. package/dist/workspace/ci-run.js +10 -3
  647. package/dist/workspace/declaration.d.ts +16 -4
  648. package/dist/workspace/declaration.d.ts.map +1 -1
  649. package/dist/workspace/declaration.js +5 -2
  650. package/dist/workspace/declaration.schema.json +27 -3
  651. package/dist/workspace/drift-cli.d.ts.map +1 -1
  652. package/dist/workspace/drift-cli.js +8 -3
  653. package/dist/workspace/exit-cli.d.ts +1 -1
  654. package/dist/workspace/exit-cli.d.ts.map +1 -1
  655. package/dist/workspace/exit-cli.js +2 -1
  656. package/dist/workspace/import-fetch.d.ts +4 -2
  657. package/dist/workspace/import-fetch.d.ts.map +1 -1
  658. package/dist/workspace/import-fetch.js +4 -2
  659. package/dist/workspace/import-init.d.ts.map +1 -1
  660. package/dist/workspace/import-init.js +4 -2
  661. package/dist/workspace/ledger.schema.json +7 -3
  662. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  663. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  664. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  665. package/dist/workspace/pr-report.schema.json +79 -3
  666. package/dist/workspace/promote.d.ts +1 -1
  667. package/dist/workspace/promote.d.ts.map +1 -1
  668. package/dist/workspace/promote.js +2 -1
  669. package/dist/workspace/records-cli.d.ts +2 -2
  670. package/dist/workspace/records-cli.d.ts.map +1 -1
  671. package/dist/workspace/records-cli.js +3 -2
  672. package/dist/workspace/release-catalog.schema.json +277 -0
  673. package/dist/workspace/run-event.schema.json +18 -1
  674. package/dist/workspace/work-cli.d.ts +3 -1
  675. package/dist/workspace/work-cli.d.ts.map +1 -1
  676. package/dist/workspace/work-cli.js +7 -2
  677. package/dist/workspace/workspace-run.d.ts.map +1 -1
  678. package/dist/workspace/workspace-run.js +2 -1
  679. package/package.json +21 -1
  680. package/src/__fixtures__/estate-ledger.ts +101 -0
  681. package/src/__fixtures__/oidc-emulator.ts +31 -2
  682. package/src/__fixtures__/product-words.ts +44 -0
  683. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  684. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  685. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  686. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  687. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  688. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  689. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  690. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  691. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  692. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  693. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  694. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  695. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  696. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  697. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  698. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  699. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  700. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  701. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  702. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  703. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  704. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  705. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  706. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  707. package/src/__golden__/wave-loop/op-point.json +18 -4
  708. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  709. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  710. package/src/__golden__/wave-loop/op-spend.json +10 -2
  711. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  712. package/src/__golden__/wave-loop/op-wide.json +20 -4
  713. package/src/bucket-check/azure.ts +307 -0
  714. package/src/bucket-check/bucket-check.test.ts +210 -0
  715. package/src/bucket-check/fixtures/azure.json +153 -0
  716. package/src/bucket-check/fixtures/gcs.json +148 -0
  717. package/src/bucket-check/fixtures/s3.json +277 -0
  718. package/src/bucket-check/gcs.ts +257 -0
  719. package/src/bucket-check/index.ts +61 -0
  720. package/src/bucket-check/s3.ts +433 -0
  721. package/src/bucket-check/types.ts +75 -0
  722. package/src/bucket-check/wire.ts +50 -0
  723. package/src/bucket-check.ts +5 -0
  724. package/src/capabilities/templates.test.ts +2 -3
  725. package/src/capabilities/templates.ts +1 -2
  726. package/src/cdk/advise.test.ts +1 -1
  727. package/src/change-set-bundle.test.ts +0 -1
  728. package/src/change-set.ts +2 -3
  729. package/src/ci-agent.test.ts +348 -0
  730. package/src/ci-agent.ts +1025 -0
  731. package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
  732. package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
  733. package/src/ci-audit/attribution.ts +260 -0
  734. package/src/ci-audit/audit-log.ts +220 -0
  735. package/src/ci-audit/ci-audit.test.ts +175 -0
  736. package/src/ci-audit/index.ts +15 -0
  737. package/src/ci-audit/unrecorded.ts +140 -0
  738. package/src/ci-audit.ts +2 -0
  739. package/src/ci-control.ts +173 -0
  740. package/src/ci-estate/delivery.ts +433 -0
  741. package/src/ci-estate/overdue.ts +81 -0
  742. package/src/ci-estate/page.ts +343 -0
  743. package/src/ci-estate/rows.ts +251 -0
  744. package/src/ci-estate.test.ts +281 -0
  745. package/src/ci-estate.ts +175 -0
  746. package/src/ci-handover.ts +67 -16
  747. package/src/ci-identity-database.test.ts +54 -0
  748. package/src/ci-identity-pulumi.test.ts +163 -0
  749. package/src/ci-identity-targets.test.ts +3 -1
  750. package/src/ci-identity.ts +123 -22
  751. package/src/ci-job-guard.test.ts +154 -0
  752. package/src/ci-job-guard.ts +319 -0
  753. package/src/ci-jobs.ts +8 -0
  754. package/src/ci-product-comment-targets.test.ts +45 -0
  755. package/src/ci-product-words.test.ts +101 -0
  756. package/src/ci-product-words.ts +565 -0
  757. package/src/ci-product.ts +226 -0
  758. package/src/ci-respond-run.ts +291 -0
  759. package/src/ci-respond.test.ts +264 -0
  760. package/src/ci-respond.ts +412 -0
  761. package/src/ci-shared-reads.test.ts +145 -0
  762. package/src/cli/commands/audit.test.ts +1 -1
  763. package/src/cli/commands/audit.ts +3 -2
  764. package/src/cli/commands/carve.test.ts +1 -1
  765. package/src/cli/commands/carve.ts +2 -2
  766. package/src/cli/commands/init.ts +3 -1
  767. package/src/cli/component-wave-args.test.ts +16 -0
  768. package/src/cli/handlers/agent.ts +126 -0
  769. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  770. package/src/cli/handlers/approve-confirm.ts +200 -0
  771. package/src/cli/handlers/approve.ts +18 -1
  772. package/src/cli/handlers/audit-log.ts +74 -0
  773. package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
  774. package/src/cli/handlers/build.test.ts +7 -0
  775. package/src/cli/handlers/build.ts +113 -1
  776. package/src/cli/handlers/ci-check-job.test.ts +114 -0
  777. package/src/cli/handlers/ci-check-job.ts +33 -0
  778. package/src/cli/handlers/ci-check.ts +63 -0
  779. package/src/cli/handlers/ci-forge-check.ts +91 -0
  780. package/src/cli/handlers/e2e-safe-run.ts +27 -0
  781. package/src/cli/handlers/fan-out.test.ts +10 -10
  782. package/src/cli/handlers/fan-out.ts +5 -0
  783. package/src/cli/handlers/gate-pending.ts +46 -0
  784. package/src/cli/handlers/init.ts +1 -0
  785. package/src/cli/handlers/ledger.ts +1 -1
  786. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  787. package/src/cli/handlers/lock.test.ts +29 -2
  788. package/src/cli/handlers/lock.ts +66 -6
  789. package/src/cli/handlers/notify-relay.ts +130 -0
  790. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  791. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  792. package/src/cli/handlers/pr-env.ts +48 -11
  793. package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
  794. package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
  795. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  796. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  797. package/src/cli/handlers/pr-waves.test.ts +8 -2
  798. package/src/cli/handlers/pr.test.ts +8 -8
  799. package/src/cli/handlers/pr.ts +879 -205
  800. package/src/cli/handlers/promote.test.ts +5 -5
  801. package/src/cli/handlers/promote.ts +22 -2
  802. package/src/cli/handlers/release.ts +2 -0
  803. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  804. package/src/cli/handlers/run-wave.ts +144 -2
  805. package/src/cli/handlers/run.test.ts +6 -4
  806. package/src/cli/handlers/run.ts +86 -1
  807. package/src/cli/handlers/serve.ts +10 -1
  808. package/src/cli/main.test.ts +1 -1
  809. package/src/cli/main.ts +180 -13
  810. package/src/cli/mcp/ledger-tools.ts +126 -0
  811. package/src/cli/mcp/product-tools.test.ts +123 -0
  812. package/src/cli/mcp/product-tools.ts +129 -0
  813. package/src/cli/mcp/read-only.test.ts +134 -0
  814. package/src/cli/mcp/read-only.ts +68 -0
  815. package/src/cli/mcp/report-tools.ts +135 -0
  816. package/src/cli/mcp/server.test.ts +5 -4
  817. package/src/cli/mcp/server.ts +90 -16
  818. package/src/cli/mcp-config.ts +8 -3
  819. package/src/cli/parse-args.ts +119 -2
  820. package/src/cli/registry.ts +73 -0
  821. package/src/cloud-lister/sigv4.ts +80 -23
  822. package/src/components/adoption.test.ts +140 -0
  823. package/src/components/adoption.ts +140 -0
  824. package/src/components/apply-lease.ts +49 -0
  825. package/src/components/capability.ts +180 -6
  826. package/src/components/check-hooks.test.ts +66 -0
  827. package/src/components/check-hooks.ts +255 -0
  828. package/src/components/check-steps.test.ts +70 -0
  829. package/src/components/check-steps.ts +158 -0
  830. package/src/components/ci-services.test.ts +51 -0
  831. package/src/components/ci-services.ts +82 -0
  832. package/src/components/cli-support.ts +23 -2
  833. package/src/components/driver.test.ts +3 -3
  834. package/src/components/driver.ts +73 -6
  835. package/src/components/fan-out-run.ts +68 -18
  836. package/src/components/groups.ts +21 -4
  837. package/src/components/plan-flags.test.ts +46 -0
  838. package/src/components/pr-comment-preview-targets.test.ts +34 -0
  839. package/src/components/pr-comment-preview.test.ts +54 -0
  840. package/src/components/pr-env-ledger.test.ts +9 -0
  841. package/src/components/pr-env-ledger.ts +42 -0
  842. package/src/components/pr-env-ports.ts +29 -4
  843. package/src/components/pr-env-run-bundle.test.ts +2 -14
  844. package/src/components/pr-env-run.test.ts +19 -0
  845. package/src/components/pr-env-run.ts +12 -2
  846. package/src/components/pr-environment.test.ts +29 -0
  847. package/src/components/pr-environment.ts +40 -8
  848. package/src/components/pr-pipeline-runners.test.ts +80 -0
  849. package/src/components/pr-pipeline.test.ts +15 -0
  850. package/src/components/pr-pipeline.ts +498 -18
  851. package/src/components/pr-policy.ts +45 -7
  852. package/src/components/pr-run.test.ts +1 -1
  853. package/src/components/pr-run.ts +138 -11
  854. package/src/components/pr-stale-job.test.ts +34 -0
  855. package/src/components/pr-targets.test.ts +35 -0
  856. package/src/components/pr-targets.ts +45 -0
  857. package/src/components/product-pipeline.test.ts +200 -0
  858. package/src/components/product-pipeline.ts +383 -0
  859. package/src/components/promote.ts +10 -1
  860. package/src/components/release-compile.ts +87 -1
  861. package/src/components/release-promote.ts +65 -1
  862. package/src/components/repo-lock.ts +52 -0
  863. package/src/components/row-lease.test.ts +490 -0
  864. package/src/components/row-lease.ts +167 -0
  865. package/src/components/wave-plan-policy.test.ts +19 -0
  866. package/src/components/wave-plan.ts +96 -6
  867. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  868. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  869. package/src/control/applied.test.ts +148 -0
  870. package/src/control/applied.ts +191 -0
  871. package/src/control/consumers.test.ts +129 -0
  872. package/src/control/consumers.ts +192 -0
  873. package/src/control/control.test.ts +302 -0
  874. package/src/control/dispatch.ts +699 -0
  875. package/src/control/edges.test.ts +112 -0
  876. package/src/control/edges.ts +164 -0
  877. package/src/control/note-checkout.test.ts +91 -0
  878. package/src/control/reconcile.ts +250 -0
  879. package/src/control/records.ts +395 -0
  880. package/src/discovery/sandbox/bundle.ts +25 -1
  881. package/src/e2e-harness/__project__/chant.config.ts +4 -0
  882. package/src/e2e-harness/__project__/src/compose.ts +33 -0
  883. package/src/e2e-harness/bucket.ts +69 -0
  884. package/src/e2e-harness/claim.test.ts +150 -0
  885. package/src/e2e-harness/claim.ts +140 -0
  886. package/src/e2e-harness/driver.test.ts +304 -0
  887. package/src/e2e-harness/driver.ts +294 -0
  888. package/src/e2e-harness/forgejo.ts +267 -0
  889. package/src/e2e-harness/git.ts +96 -0
  890. package/src/e2e-harness/index.ts +50 -0
  891. package/src/e2e-harness/jobs.ts +35 -0
  892. package/src/e2e-harness/pins.ts +52 -0
  893. package/src/e2e-harness/ports.ts +130 -0
  894. package/src/e2e-harness/reports.ts +79 -0
  895. package/src/e2e-harness/safe-run-cli.test.ts +102 -0
  896. package/src/e2e-harness/safe-run-cli.ts +54 -0
  897. package/src/e2e-harness/safe-run.ts +198 -0
  898. package/src/e2e-harness/scenario.ts +89 -0
  899. package/src/e2e-harness/schemas/README.md +62 -0
  900. package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  901. package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
  902. package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  903. package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  904. package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  905. package/src/e2e-harness/schemas/index.ts +220 -0
  906. package/src/e2e-harness/schemas.test.ts +145 -0
  907. package/src/e2e-harness/stack.test.ts +124 -0
  908. package/src/e2e-harness/stack.ts +306 -0
  909. package/src/e2e-harness/steps.ts +30 -0
  910. package/src/e2e-harness.ts +2 -0
  911. package/src/engine-facts.test.ts +2 -3
  912. package/src/engine-facts.ts +1 -2
  913. package/src/exit-codes.test.ts +32 -0
  914. package/src/exit-codes.ts +61 -0
  915. package/src/forge-check/check.ts +155 -0
  916. package/src/forge-check/contract.ts +215 -0
  917. package/src/forge-check/forge-check.test.ts +427 -0
  918. package/src/forge-check/forge.ts +318 -0
  919. package/src/forge-check/index.ts +43 -0
  920. package/src/forge-check/pulumi.ts +192 -0
  921. package/src/forge-check/read-only.ts +56 -0
  922. package/src/forge-check/trust.ts +527 -0
  923. package/src/forge-check/types.ts +78 -0
  924. package/src/forge-check.ts +5 -0
  925. package/src/gate-decision-bundle.test.ts +11 -0
  926. package/src/gate-decision.ts +3 -0
  927. package/src/gate-policy.ts +92 -3
  928. package/src/gated-waves-bundle.test.ts +0 -1
  929. package/src/index.ts +2 -0
  930. package/src/lexicon.ts +143 -6
  931. package/src/lifecycle/adoption-file.ts +1 -2
  932. package/src/lifecycle/cloud-index.test.ts +2 -3
  933. package/src/lifecycle/cloud-index.ts +1 -2
  934. package/src/lifecycle/control-entries-ledger.test.ts +69 -0
  935. package/src/lifecycle/gate-applied.ts +6 -0
  936. package/src/lifecycle/gate-ledger.ts +35 -1
  937. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  938. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  939. package/src/lifecycle/gated-request-digest.ts +49 -0
  940. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  941. package/src/lifecycle/gated-request.ts +279 -0
  942. package/src/lifecycle/identity-match.ts +25 -6
  943. package/src/lifecycle/index-diff.ts +1 -2
  944. package/src/lifecycle/index-document.ts +1 -2
  945. package/src/lifecycle/index-import.test.ts +14 -0
  946. package/src/lifecycle/index-import.ts +54 -34
  947. package/src/lifecycle/ledger-read.ts +7 -3
  948. package/src/lifecycle/lock-rows.test.ts +109 -0
  949. package/src/lifecycle/lock-rows.ts +167 -0
  950. package/src/lifecycle/publish-target-context.test.ts +108 -0
  951. package/src/lifecycle/query.test.ts +2 -3
  952. package/src/lifecycle/query.ts +109 -8
  953. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  954. package/src/lifecycle/release-catalog-site.ts +291 -0
  955. package/src/lifecycle/release-catalog.test.ts +192 -0
  956. package/src/lifecycle/release-catalog.ts +353 -0
  957. package/src/lifecycle/release-changelog.test.ts +70 -0
  958. package/src/lifecycle/release-changelog.ts +71 -0
  959. package/src/lifecycle/release-cut.ts +2 -2
  960. package/src/lifecycle/release-ledger.ts +19 -0
  961. package/src/lifecycle/release-publish.ts +45 -22
  962. package/src/lifecycle/release-read.ts +2 -0
  963. package/src/lifecycle/release-status.test.ts +185 -0
  964. package/src/lifecycle/release-status.ts +175 -0
  965. package/src/lifecycle/resource-lock.test.ts +175 -0
  966. package/src/lifecycle/resource-lock.ts +354 -0
  967. package/src/lifecycle/retention.ts +2 -0
  968. package/src/lifecycle/run-ledger.ts +7 -1
  969. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  970. package/src/lifecycle/snapshot-store.ts +1 -2
  971. package/src/lifecycle/target-lock.ts +24 -9
  972. package/src/lifecycle/wave-plans.ts +33 -5
  973. package/src/mcp/types.ts +7 -0
  974. package/src/notify-product.ts +76 -0
  975. package/src/notify-relay.test.ts +213 -0
  976. package/src/notify-relay.ts +407 -0
  977. package/src/notify.ts +95 -14
  978. package/src/object-store/azure-blob.ts +374 -0
  979. package/src/object-store/common.ts +133 -0
  980. package/src/object-store/errors.ts +26 -0
  981. package/src/object-store/from-env.ts +36 -0
  982. package/src/object-store/gcs.ts +436 -0
  983. package/src/object-store/index.ts +8 -0
  984. package/src/object-store/object-store.test.ts +130 -0
  985. package/src/object-store/s3.ts +350 -0
  986. package/src/op/activities/converge.ts +2 -1
  987. package/src/op/activities/index.ts +1 -1
  988. package/src/op/activities/review-agent.open.test.ts +78 -0
  989. package/src/op/activities/review-agent.test.ts +13 -0
  990. package/src/op/activities/review-agent.ts +89 -5
  991. package/src/op/approval-status.test.ts +134 -0
  992. package/src/op/approval-status.ts +235 -0
  993. package/src/op/gate-review.test.ts +2 -1
  994. package/src/op/gate.ts +81 -22
  995. package/src/op/generate-pipeline.ts +7 -1
  996. package/src/op/index.ts +23 -0
  997. package/src/op/op-waves-after-plan.test.ts +288 -0
  998. package/src/op/op-waves-after-plan.ts +238 -0
  999. package/src/op/op-waves-capability-spec.ts +133 -0
  1000. package/src/op/op-waves-capability.test.ts +217 -0
  1001. package/src/op/op-waves-capability.ts +370 -0
  1002. package/src/op/op-waves-events.ts +135 -0
  1003. package/src/op/op-waves-notify-words.test.ts +149 -0
  1004. package/src/op/op-waves-notify.ts +41 -16
  1005. package/src/op/op-waves-parallelism.test.ts +89 -0
  1006. package/src/op/op-waves-pull-request.test.ts +219 -0
  1007. package/src/op/op-waves-release-port.ts +64 -0
  1008. package/src/op/op-waves-release.test.ts +209 -0
  1009. package/src/op/op-waves-release.ts +132 -0
  1010. package/src/op/op-waves-run-record.test.ts +32 -0
  1011. package/src/op/op-waves-run.ts +1235 -52
  1012. package/src/op/op-waves-stand-down.test.ts +240 -0
  1013. package/src/op/op-waves-stand-down.ts +107 -0
  1014. package/src/op/op-waves-trace.test.ts +205 -0
  1015. package/src/op/op-waves.test.ts +112 -0
  1016. package/src/op/op-waves.ts +320 -22
  1017. package/src/op/runtime.ts +107 -0
  1018. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  1019. package/src/op/stage-hooks.ts +91 -12
  1020. package/src/op/steward-beside.ts +2 -1
  1021. package/src/op/types.ts +3 -2
  1022. package/src/otlp-metrics.ts +96 -0
  1023. package/src/otlp.test.ts +243 -0
  1024. package/src/otlp.ts +543 -0
  1025. package/src/override-gate-bundle.test.ts +2 -0
  1026. package/src/override-gate.ts +4 -0
  1027. package/src/parallelism.test.ts +38 -0
  1028. package/src/parallelism.ts +33 -0
  1029. package/src/policy-packs.ts +230 -0
  1030. package/src/policy-source.test.ts +256 -0
  1031. package/src/policy-source.ts +111 -0
  1032. package/src/pr-forge-bundle.test.ts +1 -1
  1033. package/src/pr-forge.ts +175 -33
  1034. package/src/pr-loop-bundle.test.ts +7 -3
  1035. package/src/pr-loop-narrowed.test.ts +63 -0
  1036. package/src/pr-loop-words.test.ts +155 -0
  1037. package/src/pr-loop.ts +398 -52
  1038. package/src/pr-merge.test.ts +100 -0
  1039. package/src/pr-merge.ts +105 -0
  1040. package/src/pr-post-stale.test.ts +163 -0
  1041. package/src/pr-post.ts +190 -5
  1042. package/src/pr-report-url.ts +61 -6
  1043. package/src/pr-requires.test.ts +37 -1
  1044. package/src/pr-requires.ts +16 -2
  1045. package/src/product-subpaths-plain-node.e2e.test.ts +212 -0
  1046. package/src/release-floors.ts +1 -1
  1047. package/src/run-event.ts +28 -1
  1048. package/src/scheduled-op-cloud.ts +68 -0
  1049. package/src/sorted-json.ts +17 -0
  1050. package/src/stage-hooks-bundle.test.ts +6 -0
  1051. package/src/terraform/credentials.test.ts +77 -0
  1052. package/src/terraform/credentials.ts +162 -0
  1053. package/src/utils.ts +2 -11
  1054. package/src/wave-loop-golden.test.ts +2 -1
  1055. package/src/wave-runtime.ts +2 -2
  1056. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  1057. package/src/workspace/ci-lock-grain.test.ts +31 -0
  1058. package/src/workspace/ci-lock-grain.ts +29 -0
  1059. package/src/workspace/ci-report-url.test.ts +1 -1
  1060. package/src/workspace/ci-run.test.ts +1 -1
  1061. package/src/workspace/ci-run.ts +10 -3
  1062. package/src/workspace/declaration.schema.json +27 -3
  1063. package/src/workspace/declaration.test.ts +1 -1
  1064. package/src/workspace/declaration.ts +26 -10
  1065. package/src/workspace/drift-cli.ts +8 -3
  1066. package/src/workspace/exit-cli.ts +2 -1
  1067. package/src/workspace/import-fetch.ts +4 -2
  1068. package/src/workspace/import-init.ts +4 -2
  1069. package/src/workspace/ledger.schema.json +7 -3
  1070. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  1071. package/src/workspace/pr-report.schema.json +79 -3
  1072. package/src/workspace/promote.ts +2 -1
  1073. package/src/workspace/records-cli.ts +3 -2
  1074. package/src/workspace/release-catalog.schema.json +277 -0
  1075. package/src/workspace/run-event.schema.json +18 -1
  1076. package/src/workspace/work-cli.ts +8 -2
  1077. package/src/workspace/workspace-run.ts +2 -1
@@ -0,0 +1,122 @@
1
+ /**
2
+ * Run events for one `chant run wave` job (#4555), on the run-event contract
3
+ * (../run-event.ts), and its trace through chant's OTLP exporter (../otlp.ts).
4
+ *
5
+ * The job is an Op run (`kind: "op"`, named for the spec). Each wave it
6
+ * walks is a phase `wave-<k>`, as its run record names it (#4551), and each
7
+ * run target is a step of that phase. A target's `step-start` and
8
+ * `step-settle` are written as its apply starts and ends, so a reader
9
+ * following the stream sees each root or stack as it applies. When the job
10
+ * ends, the targets it never applied (moved, blocked, waiting, or planned
11
+ * only) settle as `skipped`, a job that waits at a gate writes
12
+ * `gate-waiting` on a `gate:<name>` step of its last phase, and the phases
13
+ * and the run settle with the run record's verdict. The stream and the
14
+ * record therefore say the same thing.
15
+ *
16
+ * Under the trace, each target's span carries what its capability knew
17
+ * (`Capability.traceFacts`): engine facts as attributes, and a child span per
18
+ * resource the engine timed. When the capability reports per-resource lines
19
+ * (`CapabilityTraceFacts.resources`, #4615), the target's `step-settle`
20
+ * carries them as `resources`.
21
+ */
22
+ /** One job's stream: the emitter, and the trace built from it when the exporter is on. */
23
+ export class OpWaveRunEvents {
24
+ constructor(sink, trace) {
25
+ this.sink = sink;
26
+ this.trace = trace;
27
+ this.phases = [];
28
+ this.settled = new Set();
29
+ }
30
+ emit(body) {
31
+ try {
32
+ this.sink(body);
33
+ }
34
+ catch {
35
+ // A reader that fails never changes the job.
36
+ }
37
+ }
38
+ phase(k) {
39
+ const name = `wave-${k}`;
40
+ if (!this.phases.includes(name)) {
41
+ this.phases.push(name);
42
+ this.emit({ type: "phase-start", component: null, phase: name });
43
+ }
44
+ return name;
45
+ }
46
+ start() {
47
+ this.emit({ type: "run-start", waves: null });
48
+ }
49
+ /** A target's apply begins. */
50
+ stepStart(k, target) {
51
+ const phase = this.phase(k);
52
+ this.emit({ type: "step-start", component: null, phase, step: target });
53
+ }
54
+ /** A target's apply ended, with its time and what its capability knew. */
55
+ stepSettle(k, target, status, durationMs, opts = {}) {
56
+ const phase = this.phase(k);
57
+ this.settled.add(`${phase}\u0000${target}`);
58
+ if (opts.facts)
59
+ this.trace?.annotate({ phase, step: target }, opts.facts);
60
+ this.emit({
61
+ type: "step-settle",
62
+ component: null,
63
+ phase,
64
+ step: target,
65
+ status,
66
+ ...(status === "skipped" ? { skip: null } : {}),
67
+ durationMs,
68
+ ...(opts.error !== undefined ? { error: opts.error } : {}),
69
+ ...(opts.message !== undefined ? { message: opts.message } : {}),
70
+ // #4615: what the engine reported per resource, when it reported anything.
71
+ ...(opts.facts?.resources?.length ? { resources: opts.facts.resources.map((r) => ({ ...r })) } : {}),
72
+ });
73
+ }
74
+ /**
75
+ * The job ended: settle what is still open from its run record, then the
76
+ * run. `moved` and `blocked` give the reason a skipped target says.
77
+ */
78
+ finish(record, why = {}) {
79
+ const moved = new Set(why.moved ?? []);
80
+ const last = record.phases[record.phases.length - 1]?.name;
81
+ for (const p of record.phases) {
82
+ if (!this.phases.includes(p.name)) {
83
+ this.phases.push(p.name);
84
+ this.emit({ type: "phase-start", component: null, phase: p.name });
85
+ }
86
+ for (const step of p.steps) {
87
+ if (this.settled.has(`${p.name}\u0000${step.fn}`))
88
+ continue;
89
+ const status = step.status === "ok" ? "ok" : step.status === "fail" ? "failed" : "skipped";
90
+ const by = why.blocked?.[step.fn];
91
+ const message = moved.has(step.fn) ? "its plan moved since the wave was decided" : by !== undefined ? `blocked by ${by}` : undefined;
92
+ this.emit({
93
+ type: "step-settle",
94
+ component: null,
95
+ phase: p.name,
96
+ step: step.fn,
97
+ status,
98
+ ...(status === "skipped" ? { skip: moved.has(step.fn) ? "refused" : "not-run" } : {}),
99
+ durationMs: status === "skipped" ? null : step.durationMs,
100
+ ...(message ? { message } : {}),
101
+ });
102
+ }
103
+ let status = p.status === "fail" ? "failed" : "ok";
104
+ if (p.name === last && (record.status === "gated" || record.status === "waiting")) {
105
+ const gate = record.gate;
106
+ const step = `gate:${gate?.name ?? record.point?.point ?? "point"}`;
107
+ this.emit({ type: "step-start", component: null, phase: p.name, step });
108
+ this.emit({ type: "gate-waiting", component: null, phase: p.name, step, op: gate?.op ?? record.op, gate: gate?.name ?? null, point: record.point?.id ?? null });
109
+ this.emit({ type: "step-settle", component: null, phase: p.name, step, status: record.status, durationMs: null });
110
+ status = record.status;
111
+ }
112
+ this.emit({ type: "phase-settle", component: null, phase: p.name, status });
113
+ }
114
+ const runStatus = record.status === "fail" ? "failed" : record.status;
115
+ this.emit({
116
+ type: "run-settle",
117
+ status: runStatus,
118
+ durationMs: Math.max(0, Date.parse(record.ended) - Date.parse(record.started)) || null,
119
+ ...(record.failure ? { failure: { ...record.failure } } : {}),
120
+ });
121
+ }
122
+ }
@@ -12,8 +12,14 @@
12
12
  * newer run (exit 6) sends nothing. A share job of a waiting wave sends nothing, since its deciding
13
13
  * job already did, unless a hook in the share job itself held it (#3762). Delivery is `../notify.ts`: it never throws, and the job's exit code
14
14
  * is what the wave decided.
15
+ *
16
+ * The event's `source`, the summary's wave label and verbs, and the
17
+ * webhook's header prefix come from the active product's words (#4610):
18
+ * plywood's job sends `source: plywood` with `x-plywood-*` headers, and
19
+ * chant's own words send what they always sent.
15
20
  */
16
21
  import { type NotifyDelivery, type NotifyFields, type SendNotifyOptions } from "../notify.js";
22
+ import { type CiProductWords } from "../ci-product-words.js";
17
23
  import type { OpWavesSpec } from "./op-waves.js";
18
24
  import type { RunOpWaveResult } from "./op-waves-run.js";
19
25
  /** How the job ended: the wave's result, or the error that stopped it. */
@@ -28,7 +34,7 @@ export type OpWaveOutcome = {
28
34
  export declare function opWaveNotifyFields(spec: OpWavesSpec, k: number, outcome: OpWaveOutcome, job?: {
29
35
  share?: number;
30
36
  group?: string;
31
- }): NotifyFields | undefined;
37
+ }, words?: CiProductWords): NotifyFields | undefined;
32
38
  /** Send what the job's outcome calls for to what `spec.notify` names. Never throws. */
33
39
  export declare function notifyOpWave(spec: OpWavesSpec, k: number, outcome: OpWaveOutcome, job?: {
34
40
  share?: number;
@@ -1 +1 @@
1
- {"version":3,"file":"op-waves-notify.d.ts","sourceRoot":"","sources":["../../src/op/op-waves-notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAoD,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC7I,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnH,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,YAAY,GAAG,SAAS,CAoG/J;AAQD,uFAAuF;AACvF,wBAAsB,YAAY,CAChC,IAAI,EAAE,WAAW,EACjB,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,aAAa,EACtB,GAAG,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,EAC5C,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,cAAc,EAAE,CAAC,CAW3B"}
1
+ {"version":3,"file":"op-waves-notify.d.ts","sourceRoot":"","sources":["../../src/op/op-waves-notify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAoD,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC7I,OAAO,EAAqD,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,MAAM,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnH,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EACjB,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,aAAa,EACtB,GAAG,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,EAC5C,KAAK,GAAE,cAAqC,GAC3C,YAAY,GAAG,SAAS,CAsG1B;AAcD,uFAAuF;AACvF,wBAAsB,YAAY,CAChC,IAAI,EAAE,WAAW,EACjB,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,aAAa,EACtB,GAAG,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,EAC5C,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,cAAc,EAAE,CAAC,CAa3B"}
@@ -12,25 +12,36 @@
12
12
  * newer run (exit 6) sends nothing. A share job of a waiting wave sends nothing, since its deciding
13
13
  * job already did, unless a hook in the share job itself held it (#3762). Delivery is `../notify.ts`: it never throws, and the job's exit code
14
14
  * is what the wave decided.
15
+ *
16
+ * The event's `source`, the summary's wave label and verbs, and the
17
+ * webhook's header prefix come from the active product's words (#4610):
18
+ * plywood's job sends `source: plywood` with `x-plywood-*` headers, and
19
+ * chant's own words send what they always sent.
15
20
  */
16
21
  import { makeNotifyEvent, notifyConfigProblem, sendNotify } from "../notify.js";
22
+ import { activeProductWords, isChantWords, notifyWaveLabel } from "../ci-product-words.js";
23
+ import { productNotifySource, productSendOptions } from "../notify-product.js";
24
+ import { CHANT_EXIT } from "../exit-codes.js";
25
+ import { approveCommand } from "./gate.js";
17
26
  /** The event a wave job sends, or undefined when it sends none. */
18
- export function opWaveNotifyFields(spec, k, outcome, job = {}) {
27
+ export function opWaveNotifyFields(spec, k, outcome, job = {}, words = activeProductWords()) {
19
28
  const wave = spec.waves[k - 1];
20
29
  const name = wave?.name;
21
- const label = `wave ${k}${name ? ` (${name})` : ""} of ${spec.name}`;
30
+ const label = notifyWaveLabel(words, { k, ...(name ? { name } : {}), spec: spec.name });
31
+ const source = productNotifySource(words);
32
+ const [applyVerb, appliedVerb] = words.verbs.apply;
22
33
  if (outcome.error !== undefined) {
23
- return { source: "chant", event: "failed", summary: `${label} failed`, wave: { number: k, ...(name ? { name } : {}) }, targets: [], reason: outcome.error, exitCode: 1 };
34
+ return { source, event: "failed", summary: `${label} failed`, wave: { number: k, ...(name ? { name } : {}) }, targets: [], reason: outcome.error, exitCode: 1 };
24
35
  }
25
36
  const { result } = outcome;
26
37
  const decision = result.decision;
27
38
  const base = {
28
- source: "chant",
39
+ source,
29
40
  wave: { number: k, ...(name ? { name } : {}), ...(decision?.gate ? { gate: decision.gate } : {}) },
30
41
  ...(decision?.digest ? { digest: decision.digest } : {}),
31
42
  exitCode: result.exitCode,
32
43
  };
33
- if (result.exitCode === 3) {
44
+ if (result.exitCode === CHANT_EXIT.waiting) {
34
45
  if (!decision)
35
46
  return undefined;
36
47
  // A share job's wait (or a job group's, #3914) was announced by its deciding job, unless a hook in this job held it (#3762).
@@ -44,7 +55,7 @@ export function opWaveNotifyFields(spec, k, outcome, job = {}) {
44
55
  status: "waiting",
45
56
  summary: `${label} waits for an approval`,
46
57
  targets: decision.members.map((m) => m.member),
47
- approve: { command: decision.approve ?? `chant approve ${decision.op} ${decision.gate} --plan ${decision.digest}`, ...review },
58
+ approve: { command: decision.approve ?? approveCommand(decision.op, decision.gate, undefined, decision.digest), ...chantApprove(words, decision), ...review },
48
59
  ...(decision.heldOn
49
60
  ? { reason: `held on ${decision.heldOn.op} / ${decision.heldOn.gate} by ${decision.heldOn.hook}` }
50
61
  : decision.heldBy?.length
@@ -54,7 +65,7 @@ export function opWaveNotifyFields(spec, k, outcome, job = {}) {
54
65
  : {}),
55
66
  };
56
67
  }
57
- if (result.exitCode === 8 && decision?.refused?.reason === "point") {
68
+ if (result.exitCode === CHANT_EXIT.declined && decision?.refused?.reason === "point") {
58
69
  // #3836: the gate's decision point was answered with an answer it does not pass on.
59
70
  return {
60
71
  ...base,
@@ -65,7 +76,7 @@ export function opWaveNotifyFields(spec, k, outcome, job = {}) {
65
76
  ...(decision.refused.message ? { reason: decision.refused.message } : {}),
66
77
  };
67
78
  }
68
- if (result.exitCode === 7 && decision?.refused) {
79
+ if (result.exitCode === CHANT_EXIT.denied && decision?.refused) {
69
80
  // #3821: the product's policy denied a run, and no override counts for it.
70
81
  return {
71
82
  ...base,
@@ -79,20 +90,20 @@ export function opWaveNotifyFields(spec, k, outcome, job = {}) {
79
90
  };
80
91
  }
81
92
  // #3821: an apply that stood down for a newer run is no news; one held by another run is refused.
82
- if (result.exitCode === 6 && result.outcome?.outcome === "stood-down")
93
+ if (result.exitCode === CHANT_EXIT.superseded && result.outcome?.outcome === "stood-down")
83
94
  return undefined;
84
- if (result.exitCode === 5 && result.outcome?.outcome === "held") {
95
+ if (result.exitCode === CHANT_EXIT.held && result.outcome?.outcome === "held") {
85
96
  const holder = result.outcome.holder;
86
97
  return {
87
98
  ...base,
88
99
  event: "refused",
89
100
  status: "held",
90
- summary: `${label} applied nothing: another run${holder ? ` (${holder.run})` : ""} holds what it changes`,
101
+ summary: `${label} ${appliedVerb} nothing: another run${holder ? ` (${holder.run})` : ""} holds what it changes`,
91
102
  targets: decision?.members.map((m) => m.member) ?? [],
92
103
  reason: result.outcome.reason ?? `another run${holder ? `, ${holder.run},` : ""} holds what the apply changes; apply again once it is done`,
93
104
  };
94
105
  }
95
- if (result.exitCode === 4) {
106
+ if (result.exitCode === CHANT_EXIT.moved) {
96
107
  return {
97
108
  ...base,
98
109
  event: "refused",
@@ -111,13 +122,19 @@ export function opWaveNotifyFields(spec, k, outcome, job = {}) {
111
122
  ...base,
112
123
  event: "failed",
113
124
  status: "failed",
114
- summary: `${label} failed: ${result.failed.length > 0 ? `${result.failed.join(", ")} did not apply` : `exit ${result.exitCode}`}`,
125
+ summary: `${label} failed: ${result.failed.length > 0 ? `${result.failed.join(", ")} did not ${applyVerb}` : `exit ${result.exitCode}`}`,
115
126
  targets: result.failed,
116
- ...(result.failed.length > 0 ? { reason: `the apply command failed for ${result.failed.join(", ")}` } : {}),
127
+ ...(result.failed.length > 0 ? { reason: `the ${applyVerb} command failed for ${result.failed.join(", ")}` } : {}),
117
128
  };
118
129
  }
119
130
  return undefined;
120
131
  }
132
+ /** chant's own approve line beside a product's (`approve.chant` in the event), so a receiver that runs chant can approve too. */
133
+ function chantApprove(words, decision) {
134
+ if (isChantWords(words) || !decision.digest)
135
+ return {};
136
+ return { chant: `chant approve ${decision.op} ${decision.gate} --plan ${decision.digest}` };
137
+ }
121
138
  /** `, share 2,`, `, job group prod,` or `, share 2 of job group prod,`; empty for a wave's own job. */
122
139
  function jobPart(job) {
123
140
  if (job.group !== undefined)
@@ -130,10 +147,12 @@ export async function notifyOpWave(spec, k, outcome, job = {}, options = {}) {
130
147
  if (!spec.notify || notifyConfigProblem(spec.notify) !== undefined)
131
148
  return [];
132
149
  try {
133
- const fields = opWaveNotifyFields(spec, k, outcome, job);
150
+ const words = activeProductWords();
151
+ const fields = opWaveNotifyFields(spec, k, outcome, job, words);
134
152
  if (!fields)
135
153
  return [];
136
- return await sendNotify(spec.notify, makeNotifyEvent(fields, { ...(options.env ? { env: options.env } : {}) }), options);
154
+ // #4610: the product's header prefix, unless the caller names one.
155
+ return await sendNotify(spec.notify, makeNotifyEvent(fields, { ...(options.env ? { env: options.env } : {}) }), productSendOptions(words, options));
137
156
  }
138
157
  catch (e) {
139
158
  (options.log ?? ((line) => process.stderr.write(line + "\n")))(`notify: nothing was sent: ${e instanceof Error ? e.message : String(e)}`);
@@ -0,0 +1,18 @@
1
+ /**
2
+ * The git-backed release port for op waves (#4615), apart from
3
+ * `./op-waves-release.ts` so the spec checks `./op-waves.ts` imports reach no
4
+ * release ledger, store or compile module. Only the wave loop
5
+ * (`./op-waves-run.ts`) and the package index load this file.
6
+ */
7
+ import { type OpWaveReleasePort } from "./op-waves-release.js";
8
+ /**
9
+ * The release ledger on `chant/lifecycle` (#4615): each request through
10
+ * `maybeRecordAutoRelease`, which appends and pushes, with the release a cut
11
+ * from the commit names when there is one. Loaded behind dynamic imports, so
12
+ * the wave-job runtime bundle stays without them until a step applied.
13
+ */
14
+ export declare function gitOpWaveReleasePort(opts?: {
15
+ cwd?: string;
16
+ actor?: string;
17
+ }): OpWaveReleasePort;
18
+ //# sourceMappingURL=op-waves-release-port.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"op-waves-release-port.d.ts","sourceRoot":"","sources":["../../src/op/op-waves-release-port.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAA8C,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAExG;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,iBAAiB,CA+CnG"}
@@ -0,0 +1,61 @@
1
+ /**
2
+ * The git-backed release port for op waves (#4615), apart from
3
+ * `./op-waves-release.ts` so the spec checks `./op-waves.ts` imports reach no
4
+ * release ledger, store or compile module. Only the wave loop
5
+ * (`./op-waves-run.ts`) and the package index load this file.
6
+ */
7
+ import { releaseOfCommit } from "./op-waves-release.js";
8
+ /**
9
+ * The release ledger on `chant/lifecycle` (#4615): each request through
10
+ * `maybeRecordAutoRelease`, which appends and pushes, with the release a cut
11
+ * from the commit names when there is one. Loaded behind dynamic imports, so
12
+ * the wave-job runtime bundle stays without them until a step applied.
13
+ */
14
+ export function gitOpWaveReleasePort(opts = {}) {
15
+ return {
16
+ async record(requests) {
17
+ if (requests.length === 0)
18
+ return [];
19
+ const { maybeRecordAutoRelease } = await import("../components/auto-release.js");
20
+ const { resolveRunId } = await import("../lifecycle/release-ledger.js");
21
+ const { readAllReleases, readCuts } = await import("../lifecycle/release-store.js");
22
+ const { releaseTemplatesDigest } = await import("../components/release-promote.js");
23
+ const location = opts.cwd ? { cwd: opts.cwd } : undefined;
24
+ let releases = [];
25
+ let cuts = [];
26
+ try {
27
+ releases = (await readAllReleases(location)).releases;
28
+ cuts = (await readCuts(location)).cuts;
29
+ }
30
+ catch {
31
+ // No release could be read: every record is an apply record.
32
+ }
33
+ const templates = (release, env, component) => {
34
+ const target = release.targets.find((t) => t.env === env);
35
+ return target ? releaseTemplatesDigest(target, component) : null;
36
+ };
37
+ const { runId, runOrigin } = resolveRunId();
38
+ const out = [];
39
+ for (const req of requests) {
40
+ const joined = req.gitSha ? releaseOfCommit(releases, cuts, { commit: req.gitSha, env: req.env, component: req.component }, templates) : null;
41
+ const got = await maybeRecordAutoRelease({
42
+ component: req.component,
43
+ env: req.env,
44
+ success: true,
45
+ runId,
46
+ ...(runOrigin ? { runOrigin } : {}),
47
+ ...(req.approver ? { approver: req.approver } : {}),
48
+ ...(joined ? { releaseDigest: joined.releaseDigest, templatesDigest: joined.templatesDigest } : {}),
49
+ appliedDigest: { digest: req.planDigest, kind: "plan" },
50
+ }, { ...(opts.cwd ? { cwd: opts.cwd } : {}), ...(req.gitSha ? { gitSha: req.gitSha } : {}), ...(opts.actor ? { actor: opts.actor } : {}) });
51
+ if (got.recorded) {
52
+ out.push({ recorded: true, env: req.env, component: req.component, digest: got.record.digest, ...(got.record.releaseDigest ? { releaseDigest: got.record.releaseDigest } : {}) });
53
+ }
54
+ else {
55
+ out.push({ recorded: false, reason: got.reason === "error" ? got.error : got.detail ?? got.reason });
56
+ }
57
+ }
58
+ return out;
59
+ },
60
+ };
61
+ }
@@ -0,0 +1,92 @@
1
+ /**
2
+ * Release records from op-wave applies (#4615): a wave whose spec names a
3
+ * `step` records each run it applied on the environment's release ledger,
4
+ * as `chant components promote` records each component it deployed. So
5
+ * `chant components rollback <env> --component <name>` reads a stack or a
6
+ * root applied through op waves the way it reads a promoted one.
7
+ *
8
+ * Each run applied through its step gets one record, written once the
9
+ * wave's apply loop ends, whatever happened to the other runs:
10
+ *
11
+ * - `env` is the run's `release.env`, else the spec's, else `labels.Env`,
12
+ * else the wave's name, the environment the step planned and applied in
13
+ * (`opWaveStepContext`). `component` is the run's `release.component`,
14
+ * else the spec's, else the run's target. Strings have `{target}`, `{op}`
15
+ * and `{wave}` filled, as the step's input does.
16
+ * - When a release cut from the applied commit records the component's
17
+ * templates for that environment, the record names the release
18
+ * (`releaseDigest`) and carries its templates digest with `digestKind:
19
+ * "templates"`, the record `promote --release` writes. A rollback then
20
+ * runs under that release (#4542). With several such cuts the newest wins.
21
+ * - Otherwise the record is an apply record: the step's plan digest with
22
+ * `digestKind: "plan"`, the record `pr-apply` writes (#4274). It shows on
23
+ * `workspace status` and `release list`, and rollback skips it, since no
24
+ * recorded files can be applied again.
25
+ *
26
+ * `"release": false` on the spec writes none. A spec without a `step`
27
+ * writes none either, since its apply command records what it applies.
28
+ * A failed write is a line in the log and never changes the job's exit code,
29
+ * as `maybeRecordAutoRelease` treats an auto-recorded release.
30
+ */
31
+ import type { OpWave, OpWaveRun, OpWavesSpec } from "./op-waves.js";
32
+ import type { Release, ReleaseCut } from "../lifecycle/release-store.js";
33
+ /** The first chant whose op-wave applies write release records (#4615). */
34
+ export declare const OP_WAVE_RELEASE_RECORD_FLOOR = "0.124.55";
35
+ /** Where an op-wave apply's release record goes (#4615), and under which names. */
36
+ export interface OpWaveReleaseNames {
37
+ /** The environment ledger the record goes on. Default `labels.Env`, else the wave's name. */
38
+ env?: string;
39
+ /** The component the record names, which `rollback --component` takes. Default the run's target. */
40
+ component?: string;
41
+ }
42
+ /** One record an op-wave apply asks for (#4615). */
43
+ export interface OpWaveReleaseRequest {
44
+ env: string;
45
+ component: string;
46
+ target: string;
47
+ /** The step's plan digest, which the record carries when no release covers the commit. */
48
+ planDigest: string;
49
+ /** The applied commit. */
50
+ gitSha?: string;
51
+ /** Who approved the wave, when a person did. */
52
+ approver?: string;
53
+ }
54
+ /** How one record came out. */
55
+ export type OpWaveReleaseOutcome = {
56
+ recorded: true;
57
+ env: string;
58
+ component: string;
59
+ digest: string;
60
+ releaseDigest?: string;
61
+ } | {
62
+ recorded: false;
63
+ reason: string;
64
+ };
65
+ /** Where an op wave job's release records go (#4615). */
66
+ export interface OpWaveReleasePort {
67
+ record(requests: readonly OpWaveReleaseRequest[]): Promise<OpWaveReleaseOutcome[]>;
68
+ }
69
+ /** What is wrong with a spec's or a run's `release`, empty when nothing is. */
70
+ export declare function opWaveReleaseProblems(spec: Pick<OpWavesSpec, "release" | "waves">): string[];
71
+ /**
72
+ * The environment and component a run's release record goes under (#4615),
73
+ * or null when the spec writes none (no `step`, or `"release": false`).
74
+ */
75
+ export declare function opWaveReleaseNames(spec: Pick<OpWavesSpec, "op" | "step" | "labels" | "release">, wave: Pick<OpWave, "name">, run: OpWaveRun): {
76
+ env: string;
77
+ component: string;
78
+ } | null;
79
+ /**
80
+ * The release a record of `component` in `env` applied at `commit` joins
81
+ * (#4615): a release cut from that commit whose target for `env` records the
82
+ * component's templates, the newest cut first. Null when none does.
83
+ */
84
+ export declare function releaseOfCommit(releases: readonly Release[], cuts: readonly ReleaseCut[], at: {
85
+ commit: string;
86
+ env: string;
87
+ component: string;
88
+ }, templatesDigest: (release: Release, env: string, component: string) => string | null): {
89
+ releaseDigest: string;
90
+ templatesDigest: string;
91
+ } | null;
92
+ //# sourceMappingURL=op-waves-release.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"op-waves-release.d.ts","sourceRoot":"","sources":["../../src/op/op-waves-release.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAEtE,2EAA2E;AAC3E,eAAO,MAAM,4BAA4B,aAAa,CAAC;AAEvD,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,6FAA6F;IAC7F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+BAA+B;AAC/B,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1F;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExC,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;CACpF;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,MAAM,EAAE,CAiB5F;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,SAAS,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUvL;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,EAAE,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EACtD,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GACnF;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAa3D"}
@@ -0,0 +1,96 @@
1
+ /**
2
+ * Release records from op-wave applies (#4615): a wave whose spec names a
3
+ * `step` records each run it applied on the environment's release ledger,
4
+ * as `chant components promote` records each component it deployed. So
5
+ * `chant components rollback <env> --component <name>` reads a stack or a
6
+ * root applied through op waves the way it reads a promoted one.
7
+ *
8
+ * Each run applied through its step gets one record, written once the
9
+ * wave's apply loop ends, whatever happened to the other runs:
10
+ *
11
+ * - `env` is the run's `release.env`, else the spec's, else `labels.Env`,
12
+ * else the wave's name, the environment the step planned and applied in
13
+ * (`opWaveStepContext`). `component` is the run's `release.component`,
14
+ * else the spec's, else the run's target. Strings have `{target}`, `{op}`
15
+ * and `{wave}` filled, as the step's input does.
16
+ * - When a release cut from the applied commit records the component's
17
+ * templates for that environment, the record names the release
18
+ * (`releaseDigest`) and carries its templates digest with `digestKind:
19
+ * "templates"`, the record `promote --release` writes. A rollback then
20
+ * runs under that release (#4542). With several such cuts the newest wins.
21
+ * - Otherwise the record is an apply record: the step's plan digest with
22
+ * `digestKind: "plan"`, the record `pr-apply` writes (#4274). It shows on
23
+ * `workspace status` and `release list`, and rollback skips it, since no
24
+ * recorded files can be applied again.
25
+ *
26
+ * `"release": false` on the spec writes none. A spec without a `step`
27
+ * writes none either, since its apply command records what it applies.
28
+ * A failed write is a line in the log and never changes the job's exit code,
29
+ * as `maybeRecordAutoRelease` treats an auto-recorded release.
30
+ */
31
+ /** The first chant whose op-wave applies write release records (#4615). */
32
+ export const OP_WAVE_RELEASE_RECORD_FLOOR = "0.124.55";
33
+ /** What is wrong with a spec's or a run's `release`, empty when nothing is. */
34
+ export function opWaveReleaseProblems(spec) {
35
+ const problems = [];
36
+ const check = (value, where, allowFalse) => {
37
+ if (value === undefined)
38
+ return;
39
+ if (value === false && allowFalse)
40
+ return;
41
+ if (value === null || typeof value !== "object" || Array.isArray(value)) {
42
+ problems.push(`${where} must be { "env"?: "<env>", "component"?: "<name>" }${allowFalse ? " or false" : ""}`);
43
+ return;
44
+ }
45
+ for (const [key, v] of Object.entries(value)) {
46
+ if (key !== "env" && key !== "component")
47
+ problems.push(`${where} has an unknown key "${key}"; it takes env and component`);
48
+ else if (typeof v !== "string" || v.trim() === "")
49
+ problems.push(`${where}.${key} must be a non-empty string`);
50
+ }
51
+ };
52
+ check(spec.release, "`release`", true);
53
+ for (const wave of spec.waves)
54
+ for (const run of wave.runs ?? [])
55
+ check(run.release, `wave "${wave.name}" run "${run.target}": \`release\``, false);
56
+ return problems;
57
+ }
58
+ function fill(text, vars) {
59
+ return text.replaceAll("{target}", vars.target).replaceAll("{op}", vars.op).replaceAll("{wave}", vars.wave);
60
+ }
61
+ /**
62
+ * The environment and component a run's release record goes under (#4615),
63
+ * or null when the spec writes none (no `step`, or `"release": false`).
64
+ */
65
+ export function opWaveReleaseNames(spec, wave, run) {
66
+ if (!spec.step || spec.release === false)
67
+ return null;
68
+ const vars = { target: run.target, op: run.op ?? spec.op, wave: wave.name };
69
+ const own = spec.release ?? {};
70
+ const env = run.release?.env ?? own.env;
71
+ const component = run.release?.component ?? own.component;
72
+ return {
73
+ env: env !== undefined ? fill(env, vars) : spec.labels?.Env ?? wave.name,
74
+ component: component !== undefined ? fill(component, vars) : run.target,
75
+ };
76
+ }
77
+ /**
78
+ * The release a record of `component` in `env` applied at `commit` joins
79
+ * (#4615): a release cut from that commit whose target for `env` records the
80
+ * component's templates, the newest cut first. Null when none does.
81
+ */
82
+ export function releaseOfCommit(releases, cuts, at, templatesDigest) {
83
+ const cutAt = new Map();
84
+ for (const c of cuts) {
85
+ const prior = cutAt.get(c.releaseDigest);
86
+ if (prior === undefined || c.timestamp > prior)
87
+ cutAt.set(c.releaseDigest, c.timestamp);
88
+ }
89
+ const matching = releases
90
+ .filter((r) => r.commit === at.commit)
91
+ .map((r) => ({ r, digest: templatesDigest(r, at.env, at.component) }))
92
+ .filter((x) => x.digest !== null)
93
+ .sort((a, b) => (cutAt.get(b.r.releaseDigest) ?? "").localeCompare(cutAt.get(a.r.releaseDigest) ?? "") || a.r.releaseDigest.localeCompare(b.r.releaseDigest));
94
+ const first = matching[0];
95
+ return first ? { releaseDigest: first.r.releaseDigest, templatesDigest: first.digest } : null;
96
+ }