@intentius/chant 0.124.54 → 0.124.56

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1077) hide show
  1. package/dist/__fixtures__/estate-ledger.d.ts +13 -0
  2. package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
  3. package/dist/__fixtures__/estate-ledger.js +67 -0
  4. package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
  5. package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
  6. package/dist/__fixtures__/oidc-emulator.js +26 -2
  7. package/dist/__fixtures__/product-words.d.ts +78 -0
  8. package/dist/__fixtures__/product-words.d.ts.map +1 -0
  9. package/dist/__fixtures__/product-words.js +43 -0
  10. package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  11. package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  12. package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  13. package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  14. package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  15. package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  16. package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
  17. package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
  18. package/dist/__golden__/wave-loop/op-held-on.json +28 -7
  19. package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  20. package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  21. package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  22. package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
  23. package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  24. package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
  25. package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
  26. package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
  27. package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  28. package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  29. package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
  30. package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  31. package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  32. package/dist/__golden__/wave-loop/op-overridden.json +28 -7
  33. package/dist/__golden__/wave-loop/op-per-run.json +20 -4
  34. package/dist/__golden__/wave-loop/op-point.json +18 -4
  35. package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
  36. package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
  37. package/dist/__golden__/wave-loop/op-spend.json +10 -2
  38. package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
  39. package/dist/__golden__/wave-loop/op-wide.json +20 -4
  40. package/dist/bucket-check/azure.d.ts +108 -0
  41. package/dist/bucket-check/azure.d.ts.map +1 -0
  42. package/dist/bucket-check/azure.js +258 -0
  43. package/dist/bucket-check/fixtures/azure.json +153 -0
  44. package/dist/bucket-check/fixtures/gcs.json +148 -0
  45. package/dist/bucket-check/fixtures/s3.json +277 -0
  46. package/dist/bucket-check/gcs.d.ts +77 -0
  47. package/dist/bucket-check/gcs.d.ts.map +1 -0
  48. package/dist/bucket-check/gcs.js +202 -0
  49. package/dist/bucket-check/index.d.ts +48 -0
  50. package/dist/bucket-check/index.d.ts.map +1 -0
  51. package/dist/bucket-check/index.js +44 -0
  52. package/dist/bucket-check/s3.d.ts +116 -0
  53. package/dist/bucket-check/s3.d.ts.map +1 -0
  54. package/dist/bucket-check/s3.js +362 -0
  55. package/dist/bucket-check/types.d.ts +66 -0
  56. package/dist/bucket-check/types.d.ts.map +1 -0
  57. package/dist/bucket-check/types.js +31 -0
  58. package/dist/bucket-check/wire.d.ts +27 -0
  59. package/dist/bucket-check/wire.d.ts.map +1 -0
  60. package/dist/bucket-check/wire.js +32 -0
  61. package/dist/bucket-check.d.ts +6 -0
  62. package/dist/bucket-check.d.ts.map +1 -0
  63. package/dist/bucket-check.js +5 -0
  64. package/dist/capabilities/templates.d.ts.map +1 -1
  65. package/dist/capabilities/templates.js +1 -2
  66. package/dist/change-set.d.ts.map +1 -1
  67. package/dist/change-set.js +2 -3
  68. package/dist/ci-agent.d.ts +381 -0
  69. package/dist/ci-agent.d.ts.map +1 -0
  70. package/dist/ci-agent.js +832 -0
  71. package/dist/ci-audit/attribution.d.ts +111 -0
  72. package/dist/ci-audit/attribution.d.ts.map +1 -0
  73. package/dist/ci-audit/attribution.js +194 -0
  74. package/dist/ci-audit/audit-log.d.ts +144 -0
  75. package/dist/ci-audit/audit-log.d.ts.map +1 -0
  76. package/dist/ci-audit/audit-log.js +149 -0
  77. package/dist/ci-audit/index.d.ts +12 -0
  78. package/dist/ci-audit/index.d.ts.map +1 -0
  79. package/dist/ci-audit/index.js +12 -0
  80. package/dist/ci-audit/unrecorded.d.ts +74 -0
  81. package/dist/ci-audit/unrecorded.d.ts.map +1 -0
  82. package/dist/ci-audit/unrecorded.js +95 -0
  83. package/dist/ci-audit.d.ts +3 -0
  84. package/dist/ci-audit.d.ts.map +1 -0
  85. package/dist/ci-audit.js +2 -0
  86. package/dist/ci-control.d.ts +42 -0
  87. package/dist/ci-control.d.ts.map +1 -0
  88. package/dist/ci-control.js +41 -0
  89. package/dist/ci-estate/delivery.d.ts +137 -0
  90. package/dist/ci-estate/delivery.d.ts.map +1 -0
  91. package/dist/ci-estate/delivery.js +311 -0
  92. package/dist/ci-estate/overdue.d.ts +34 -0
  93. package/dist/ci-estate/overdue.d.ts.map +1 -0
  94. package/dist/ci-estate/overdue.js +58 -0
  95. package/dist/ci-estate/page.d.ts +134 -0
  96. package/dist/ci-estate/page.d.ts.map +1 -0
  97. package/dist/ci-estate/page.js +233 -0
  98. package/dist/ci-estate/rows.d.ts +118 -0
  99. package/dist/ci-estate/rows.d.ts.map +1 -0
  100. package/dist/ci-estate/rows.js +126 -0
  101. package/dist/ci-estate.d.ts +92 -0
  102. package/dist/ci-estate.d.ts.map +1 -0
  103. package/dist/ci-estate.js +82 -0
  104. package/dist/ci-handover.d.ts +29 -5
  105. package/dist/ci-handover.d.ts.map +1 -1
  106. package/dist/ci-handover.js +50 -16
  107. package/dist/ci-identity.d.ts +82 -7
  108. package/dist/ci-identity.d.ts.map +1 -1
  109. package/dist/ci-identity.js +86 -15
  110. package/dist/ci-job-guard.d.ts +139 -0
  111. package/dist/ci-job-guard.d.ts.map +1 -0
  112. package/dist/ci-job-guard.js +287 -0
  113. package/dist/ci-jobs.d.ts +7 -0
  114. package/dist/ci-jobs.d.ts.map +1 -1
  115. package/dist/ci-jobs.js +7 -0
  116. package/dist/ci-product-words.d.ts +296 -0
  117. package/dist/ci-product-words.d.ts.map +1 -0
  118. package/dist/ci-product-words.js +407 -0
  119. package/dist/ci-product.d.ts +117 -0
  120. package/dist/ci-product.d.ts.map +1 -0
  121. package/dist/ci-product.js +113 -0
  122. package/dist/ci-respond-run.d.ts +73 -0
  123. package/dist/ci-respond-run.d.ts.map +1 -0
  124. package/dist/ci-respond-run.js +247 -0
  125. package/dist/ci-respond.d.ts +189 -0
  126. package/dist/ci-respond.d.ts.map +1 -0
  127. package/dist/ci-respond.js +285 -0
  128. package/dist/cli/commands/audit.d.ts +2 -2
  129. package/dist/cli/commands/audit.d.ts.map +1 -1
  130. package/dist/cli/commands/audit.js +3 -2
  131. package/dist/cli/commands/carve.js +2 -2
  132. package/dist/cli/commands/init.d.ts +2 -0
  133. package/dist/cli/commands/init.d.ts.map +1 -1
  134. package/dist/cli/commands/init.js +1 -1
  135. package/dist/cli/handlers/agent.d.ts +17 -0
  136. package/dist/cli/handlers/agent.d.ts.map +1 -0
  137. package/dist/cli/handlers/agent.js +114 -0
  138. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  139. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  140. package/dist/cli/handlers/approve-confirm.js +142 -0
  141. package/dist/cli/handlers/approve.d.ts.map +1 -1
  142. package/dist/cli/handlers/approve.js +19 -1
  143. package/dist/cli/handlers/audit-log.d.ts +12 -0
  144. package/dist/cli/handlers/audit-log.d.ts.map +1 -0
  145. package/dist/cli/handlers/audit-log.js +81 -0
  146. package/dist/cli/handlers/build.d.ts +7 -0
  147. package/dist/cli/handlers/build.d.ts.map +1 -1
  148. package/dist/cli/handlers/build.js +124 -1
  149. package/dist/cli/handlers/ci-check-job.d.ts +11 -0
  150. package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
  151. package/dist/cli/handlers/ci-check-job.js +27 -0
  152. package/dist/cli/handlers/ci-check.d.ts +3 -0
  153. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  154. package/dist/cli/handlers/ci-check.js +63 -0
  155. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  156. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  157. package/dist/cli/handlers/ci-forge-check.js +89 -0
  158. package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
  159. package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
  160. package/dist/cli/handlers/e2e-safe-run.js +23 -0
  161. package/dist/cli/handlers/fan-out.js +4 -0
  162. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  163. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  164. package/dist/cli/handlers/gate-pending.js +44 -0
  165. package/dist/cli/handlers/init.d.ts.map +1 -1
  166. package/dist/cli/handlers/init.js +1 -0
  167. package/dist/cli/handlers/ledger.js +1 -1
  168. package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
  169. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
  170. package/dist/cli/handlers/lifecycle-drift.js +7 -2
  171. package/dist/cli/handlers/lock.d.ts.map +1 -1
  172. package/dist/cli/handlers/lock.js +64 -5
  173. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  174. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  175. package/dist/cli/handlers/notify-relay.js +130 -0
  176. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  177. package/dist/cli/handlers/pr-env.js +42 -11
  178. package/dist/cli/handlers/pr.d.ts +43 -3
  179. package/dist/cli/handlers/pr.d.ts.map +1 -1
  180. package/dist/cli/handlers/pr.js +908 -205
  181. package/dist/cli/handlers/promote.d.ts.map +1 -1
  182. package/dist/cli/handlers/promote.js +21 -2
  183. package/dist/cli/handlers/release.d.ts.map +1 -1
  184. package/dist/cli/handlers/release.js +3 -0
  185. package/dist/cli/handlers/run-wave.d.ts +8 -0
  186. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  187. package/dist/cli/handlers/run-wave.js +160 -2
  188. package/dist/cli/handlers/run.d.ts +6 -1
  189. package/dist/cli/handlers/run.d.ts.map +1 -1
  190. package/dist/cli/handlers/run.js +86 -1
  191. package/dist/cli/handlers/serve.d.ts.map +1 -1
  192. package/dist/cli/handlers/serve.js +10 -1
  193. package/dist/cli/main.d.ts +11 -1
  194. package/dist/cli/main.d.ts.map +1 -1
  195. package/dist/cli/main.js +178 -13
  196. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  197. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  198. package/dist/cli/mcp/ledger-tools.js +122 -0
  199. package/dist/cli/mcp/product-tools.d.ts +78 -0
  200. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  201. package/dist/cli/mcp/product-tools.js +93 -0
  202. package/dist/cli/mcp/read-only.d.ts +34 -0
  203. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  204. package/dist/cli/mcp/read-only.js +61 -0
  205. package/dist/cli/mcp/report-tools.d.ts +48 -0
  206. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  207. package/dist/cli/mcp/report-tools.js +128 -0
  208. package/dist/cli/mcp/server.d.ts +28 -1
  209. package/dist/cli/mcp/server.d.ts.map +1 -1
  210. package/dist/cli/mcp/server.js +86 -15
  211. package/dist/cli/mcp-config.d.ts +9 -2
  212. package/dist/cli/mcp-config.d.ts.map +1 -1
  213. package/dist/cli/mcp-config.js +8 -3
  214. package/dist/cli/parse-args.d.ts.map +1 -1
  215. package/dist/cli/parse-args.js +164 -3
  216. package/dist/cli/registry.d.ts +73 -0
  217. package/dist/cli/registry.d.ts.map +1 -1
  218. package/dist/cloud-lister/sigv4.d.ts +42 -7
  219. package/dist/cloud-lister/sigv4.d.ts.map +1 -1
  220. package/dist/cloud-lister/sigv4.js +72 -22
  221. package/dist/components/adoption.d.ts +69 -0
  222. package/dist/components/adoption.d.ts.map +1 -0
  223. package/dist/components/adoption.js +92 -0
  224. package/dist/components/apply-lease.d.ts +19 -0
  225. package/dist/components/apply-lease.d.ts.map +1 -0
  226. package/dist/components/apply-lease.js +41 -0
  227. package/dist/components/capability.d.ts +159 -5
  228. package/dist/components/capability.d.ts.map +1 -1
  229. package/dist/components/capability.js +39 -6
  230. package/dist/components/check-hooks.d.ts +116 -0
  231. package/dist/components/check-hooks.d.ts.map +1 -0
  232. package/dist/components/check-hooks.js +192 -0
  233. package/dist/components/check-steps.d.ts +74 -0
  234. package/dist/components/check-steps.d.ts.map +1 -0
  235. package/dist/components/check-steps.js +102 -0
  236. package/dist/components/ci-services.d.ts +57 -0
  237. package/dist/components/ci-services.d.ts.map +1 -0
  238. package/dist/components/ci-services.js +60 -0
  239. package/dist/components/cli-support.d.ts +13 -0
  240. package/dist/components/cli-support.d.ts.map +1 -1
  241. package/dist/components/cli-support.js +10 -2
  242. package/dist/components/driver.d.ts +32 -3
  243. package/dist/components/driver.d.ts.map +1 -1
  244. package/dist/components/driver.js +59 -5
  245. package/dist/components/fan-out-run.d.ts +12 -0
  246. package/dist/components/fan-out-run.d.ts.map +1 -1
  247. package/dist/components/fan-out-run.js +56 -16
  248. package/dist/components/groups.d.ts.map +1 -1
  249. package/dist/components/groups.js +23 -5
  250. package/dist/components/pr-env-ledger.d.ts +32 -0
  251. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  252. package/dist/components/pr-env-ledger.js +38 -0
  253. package/dist/components/pr-env-ports.d.ts +12 -0
  254. package/dist/components/pr-env-ports.d.ts.map +1 -1
  255. package/dist/components/pr-env-ports.js +13 -3
  256. package/dist/components/pr-env-run.d.ts +6 -0
  257. package/dist/components/pr-env-run.d.ts.map +1 -1
  258. package/dist/components/pr-env-run.js +3 -2
  259. package/dist/components/pr-environment.d.ts +32 -4
  260. package/dist/components/pr-environment.d.ts.map +1 -1
  261. package/dist/components/pr-environment.js +26 -8
  262. package/dist/components/pr-pipeline.d.ts +297 -5
  263. package/dist/components/pr-pipeline.d.ts.map +1 -1
  264. package/dist/components/pr-pipeline.js +329 -18
  265. package/dist/components/pr-policy.d.ts +26 -2
  266. package/dist/components/pr-policy.d.ts.map +1 -1
  267. package/dist/components/pr-policy.js +41 -7
  268. package/dist/components/pr-run.d.ts +71 -0
  269. package/dist/components/pr-run.d.ts.map +1 -1
  270. package/dist/components/pr-run.js +91 -7
  271. package/dist/components/pr-targets.d.ts +24 -0
  272. package/dist/components/pr-targets.d.ts.map +1 -0
  273. package/dist/components/pr-targets.js +48 -0
  274. package/dist/components/product-pipeline.d.ts +250 -0
  275. package/dist/components/product-pipeline.d.ts.map +1 -0
  276. package/dist/components/product-pipeline.js +212 -0
  277. package/dist/components/promote.d.ts +6 -0
  278. package/dist/components/promote.d.ts.map +1 -1
  279. package/dist/components/promote.js +4 -1
  280. package/dist/components/release-compile.d.ts +22 -1
  281. package/dist/components/release-compile.d.ts.map +1 -1
  282. package/dist/components/release-compile.js +85 -0
  283. package/dist/components/release-promote.d.ts +15 -1
  284. package/dist/components/release-promote.d.ts.map +1 -1
  285. package/dist/components/release-promote.js +67 -2
  286. package/dist/components/repo-lock.d.ts +27 -0
  287. package/dist/components/repo-lock.d.ts.map +1 -0
  288. package/dist/components/repo-lock.js +49 -0
  289. package/dist/components/row-lease.d.ts +84 -0
  290. package/dist/components/row-lease.d.ts.map +1 -0
  291. package/dist/components/row-lease.js +110 -0
  292. package/dist/components/wave-plan.d.ts +42 -0
  293. package/dist/components/wave-plan.d.ts.map +1 -1
  294. package/dist/components/wave-plan.js +72 -4
  295. package/dist/control/applied.d.ts +89 -0
  296. package/dist/control/applied.d.ts.map +1 -0
  297. package/dist/control/applied.js +175 -0
  298. package/dist/control/consumers.d.ts +78 -0
  299. package/dist/control/consumers.d.ts.map +1 -0
  300. package/dist/control/consumers.js +172 -0
  301. package/dist/control/dispatch.d.ts +334 -0
  302. package/dist/control/dispatch.d.ts.map +1 -0
  303. package/dist/control/dispatch.js +519 -0
  304. package/dist/control/edges.d.ts +75 -0
  305. package/dist/control/edges.d.ts.map +1 -0
  306. package/dist/control/edges.js +133 -0
  307. package/dist/control/reconcile.d.ts +120 -0
  308. package/dist/control/reconcile.d.ts.map +1 -0
  309. package/dist/control/reconcile.js +178 -0
  310. package/dist/control/records.d.ts +187 -0
  311. package/dist/control/records.d.ts.map +1 -0
  312. package/dist/control/records.js +307 -0
  313. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  314. package/dist/discovery/sandbox/bundle.js +25 -1
  315. package/dist/e2e-harness/bucket.d.ts +21 -0
  316. package/dist/e2e-harness/bucket.d.ts.map +1 -0
  317. package/dist/e2e-harness/bucket.js +61 -0
  318. package/dist/e2e-harness/claim.d.ts +70 -0
  319. package/dist/e2e-harness/claim.d.ts.map +1 -0
  320. package/dist/e2e-harness/claim.js +98 -0
  321. package/dist/e2e-harness/driver.d.ts +64 -0
  322. package/dist/e2e-harness/driver.d.ts.map +1 -0
  323. package/dist/e2e-harness/driver.js +243 -0
  324. package/dist/e2e-harness/forgejo.d.ts +77 -0
  325. package/dist/e2e-harness/forgejo.d.ts.map +1 -0
  326. package/dist/e2e-harness/forgejo.js +205 -0
  327. package/dist/e2e-harness/git.d.ts +32 -0
  328. package/dist/e2e-harness/git.d.ts.map +1 -0
  329. package/dist/e2e-harness/git.js +67 -0
  330. package/dist/e2e-harness/index.d.ts +22 -0
  331. package/dist/e2e-harness/index.d.ts.map +1 -0
  332. package/dist/e2e-harness/index.js +48 -0
  333. package/dist/e2e-harness/jobs.d.ts +8 -0
  334. package/dist/e2e-harness/jobs.d.ts.map +1 -0
  335. package/dist/e2e-harness/jobs.js +34 -0
  336. package/dist/e2e-harness/pins.d.ts +45 -0
  337. package/dist/e2e-harness/pins.d.ts.map +1 -0
  338. package/dist/e2e-harness/pins.js +44 -0
  339. package/dist/e2e-harness/ports.d.ts +113 -0
  340. package/dist/e2e-harness/ports.d.ts.map +1 -0
  341. package/dist/e2e-harness/ports.js +4 -0
  342. package/dist/e2e-harness/reports.d.ts +45 -0
  343. package/dist/e2e-harness/reports.d.ts.map +1 -0
  344. package/dist/e2e-harness/reports.js +57 -0
  345. package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
  346. package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
  347. package/dist/e2e-harness/safe-run-cli.js +43 -0
  348. package/dist/e2e-harness/safe-run.d.ts +61 -0
  349. package/dist/e2e-harness/safe-run.d.ts.map +1 -0
  350. package/dist/e2e-harness/safe-run.js +172 -0
  351. package/dist/e2e-harness/scenario.d.ts +11 -0
  352. package/dist/e2e-harness/scenario.d.ts.map +1 -0
  353. package/dist/e2e-harness/scenario.js +89 -0
  354. package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  355. package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
  356. package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  357. package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  358. package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  359. package/dist/e2e-harness/schemas/index.d.ts +191 -0
  360. package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
  361. package/dist/e2e-harness/schemas/index.js +62 -0
  362. package/dist/e2e-harness/stack.d.ts +124 -0
  363. package/dist/e2e-harness/stack.d.ts.map +1 -0
  364. package/dist/e2e-harness/stack.js +207 -0
  365. package/dist/e2e-harness/steps.d.ts +11 -0
  366. package/dist/e2e-harness/steps.d.ts.map +1 -0
  367. package/dist/e2e-harness/steps.js +22 -0
  368. package/dist/e2e-harness.d.ts +3 -0
  369. package/dist/e2e-harness.d.ts.map +1 -0
  370. package/dist/e2e-harness.js +2 -0
  371. package/dist/engine-facts.d.ts.map +1 -1
  372. package/dist/engine-facts.js +1 -2
  373. package/dist/exit-codes.d.ts +54 -0
  374. package/dist/exit-codes.d.ts.map +1 -0
  375. package/dist/exit-codes.js +55 -0
  376. package/dist/forge-check/check.d.ts +63 -0
  377. package/dist/forge-check/check.d.ts.map +1 -0
  378. package/dist/forge-check/check.js +139 -0
  379. package/dist/forge-check/contract.d.ts +152 -0
  380. package/dist/forge-check/contract.d.ts.map +1 -0
  381. package/dist/forge-check/contract.js +118 -0
  382. package/dist/forge-check/forge.d.ts +42 -0
  383. package/dist/forge-check/forge.d.ts.map +1 -0
  384. package/dist/forge-check/forge.js +338 -0
  385. package/dist/forge-check/index.d.ts +24 -0
  386. package/dist/forge-check/index.d.ts.map +1 -0
  387. package/dist/forge-check/index.js +23 -0
  388. package/dist/forge-check/pulumi.d.ts +44 -0
  389. package/dist/forge-check/pulumi.d.ts.map +1 -0
  390. package/dist/forge-check/pulumi.js +184 -0
  391. package/dist/forge-check/read-only.d.ts +26 -0
  392. package/dist/forge-check/read-only.d.ts.map +1 -0
  393. package/dist/forge-check/read-only.js +53 -0
  394. package/dist/forge-check/trust.d.ts +94 -0
  395. package/dist/forge-check/trust.d.ts.map +1 -0
  396. package/dist/forge-check/trust.js +532 -0
  397. package/dist/forge-check/types.d.ts +80 -0
  398. package/dist/forge-check/types.d.ts.map +1 -0
  399. package/dist/forge-check/types.js +18 -0
  400. package/dist/forge-check.d.ts +6 -0
  401. package/dist/forge-check.d.ts.map +1 -0
  402. package/dist/forge-check.js +5 -0
  403. package/dist/gate-decision.d.ts +1 -0
  404. package/dist/gate-decision.d.ts.map +1 -1
  405. package/dist/gate-decision.js +2 -0
  406. package/dist/gate-policy.d.ts +47 -1
  407. package/dist/gate-policy.d.ts.map +1 -1
  408. package/dist/gate-policy.js +50 -2
  409. package/dist/index.d.ts +1 -0
  410. package/dist/index.d.ts.map +1 -1
  411. package/dist/index.js +2 -0
  412. package/dist/lexicon.d.ts +152 -6
  413. package/dist/lexicon.d.ts.map +1 -1
  414. package/dist/lifecycle/adoption-file.d.ts +24 -0
  415. package/dist/lifecycle/adoption-file.d.ts.map +1 -1
  416. package/dist/lifecycle/adoption-file.js +1 -2
  417. package/dist/lifecycle/cloud-index.d.ts.map +1 -1
  418. package/dist/lifecycle/cloud-index.js +1 -2
  419. package/dist/lifecycle/gate-applied.d.ts +6 -0
  420. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  421. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  422. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  423. package/dist/lifecycle/gate-ledger.js +10 -1
  424. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  425. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  426. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  427. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  428. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  429. package/dist/lifecycle/gated-request-digest.js +35 -0
  430. package/dist/lifecycle/gated-request.d.ts +126 -0
  431. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  432. package/dist/lifecycle/gated-request.js +204 -0
  433. package/dist/lifecycle/identity-match.d.ts +15 -0
  434. package/dist/lifecycle/identity-match.d.ts.map +1 -1
  435. package/dist/lifecycle/identity-match.js +11 -6
  436. package/dist/lifecycle/index-diff.d.ts +40 -0
  437. package/dist/lifecycle/index-diff.d.ts.map +1 -1
  438. package/dist/lifecycle/index-diff.js +1 -2
  439. package/dist/lifecycle/index-document.d.ts.map +1 -1
  440. package/dist/lifecycle/index-document.js +1 -2
  441. package/dist/lifecycle/index-import.d.ts +4 -1
  442. package/dist/lifecycle/index-import.d.ts.map +1 -1
  443. package/dist/lifecycle/index-import.js +29 -32
  444. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  445. package/dist/lifecycle/ledger-read.js +7 -3
  446. package/dist/lifecycle/lock-rows.d.ts +76 -0
  447. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  448. package/dist/lifecycle/lock-rows.js +140 -0
  449. package/dist/lifecycle/query.d.ts +50 -3
  450. package/dist/lifecycle/query.d.ts.map +1 -1
  451. package/dist/lifecycle/query.js +97 -7
  452. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  453. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  454. package/dist/lifecycle/release-catalog-site.js +232 -0
  455. package/dist/lifecycle/release-catalog.d.ts +201 -0
  456. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  457. package/dist/lifecycle/release-catalog.js +198 -0
  458. package/dist/lifecycle/release-changelog.d.ts +41 -0
  459. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  460. package/dist/lifecycle/release-changelog.js +38 -0
  461. package/dist/lifecycle/release-cut.d.ts +1 -0
  462. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  463. package/dist/lifecycle/release-cut.js +1 -1
  464. package/dist/lifecycle/release-ledger.d.ts +16 -0
  465. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  466. package/dist/lifecycle/release-ledger.js +9 -0
  467. package/dist/lifecycle/release-publish.d.ts +43 -22
  468. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  469. package/dist/lifecycle/release-read.d.ts.map +1 -1
  470. package/dist/lifecycle/release-read.js +3 -0
  471. package/dist/lifecycle/release-status.d.ts +106 -0
  472. package/dist/lifecycle/release-status.d.ts.map +1 -0
  473. package/dist/lifecycle/release-status.js +115 -0
  474. package/dist/lifecycle/resource-lock.d.ts +120 -0
  475. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  476. package/dist/lifecycle/resource-lock.js +317 -0
  477. package/dist/lifecycle/retention.d.ts.map +1 -1
  478. package/dist/lifecycle/retention.js +3 -0
  479. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  480. package/dist/lifecycle/run-ledger.js +9 -1
  481. package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
  482. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
  483. package/dist/lifecycle/snapshot-store-s3.js +9 -44
  484. package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
  485. package/dist/lifecycle/snapshot-store.js +1 -2
  486. package/dist/lifecycle/target-lock.d.ts +15 -0
  487. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  488. package/dist/lifecycle/target-lock.js +25 -10
  489. package/dist/lifecycle/wave-plans.d.ts +23 -7
  490. package/dist/lifecycle/wave-plans.d.ts.map +1 -1
  491. package/dist/lifecycle/wave-plans.js +9 -2
  492. package/dist/mcp/types.d.ts +7 -0
  493. package/dist/mcp/types.d.ts.map +1 -1
  494. package/dist/notify-product.d.ts +43 -0
  495. package/dist/notify-product.d.ts.map +1 -0
  496. package/dist/notify-product.js +58 -0
  497. package/dist/notify-relay.d.ts +197 -0
  498. package/dist/notify-relay.d.ts.map +1 -0
  499. package/dist/notify-relay.js +321 -0
  500. package/dist/notify.d.ts +44 -4
  501. package/dist/notify.d.ts.map +1 -1
  502. package/dist/notify.js +77 -14
  503. package/dist/object-store/azure-blob.d.ts +129 -0
  504. package/dist/object-store/azure-blob.d.ts.map +1 -0
  505. package/dist/object-store/azure-blob.js +341 -0
  506. package/dist/object-store/common.d.ts +108 -0
  507. package/dist/object-store/common.d.ts.map +1 -0
  508. package/dist/object-store/common.js +80 -0
  509. package/dist/object-store/errors.d.ts +28 -0
  510. package/dist/object-store/errors.d.ts.map +1 -0
  511. package/dist/object-store/errors.js +21 -0
  512. package/dist/object-store/from-env.d.ts +18 -0
  513. package/dist/object-store/from-env.d.ts.map +1 -0
  514. package/dist/object-store/from-env.js +22 -0
  515. package/dist/object-store/gcs.d.ts +106 -0
  516. package/dist/object-store/gcs.d.ts.map +1 -0
  517. package/dist/object-store/gcs.js +393 -0
  518. package/dist/object-store/index.d.ts +9 -0
  519. package/dist/object-store/index.d.ts.map +1 -0
  520. package/dist/object-store/index.js +8 -0
  521. package/dist/object-store/s3.d.ts +146 -0
  522. package/dist/object-store/s3.d.ts.map +1 -0
  523. package/dist/object-store/s3.js +306 -0
  524. package/dist/op/activities/converge.d.ts.map +1 -1
  525. package/dist/op/activities/converge.js +2 -1
  526. package/dist/op/activities/index.d.ts +1 -1
  527. package/dist/op/activities/index.d.ts.map +1 -1
  528. package/dist/op/activities/index.js +1 -1
  529. package/dist/op/activities/review-agent.d.ts +55 -2
  530. package/dist/op/activities/review-agent.d.ts.map +1 -1
  531. package/dist/op/activities/review-agent.js +65 -5
  532. package/dist/op/approval-status.d.ts +103 -0
  533. package/dist/op/approval-status.d.ts.map +1 -0
  534. package/dist/op/approval-status.js +197 -0
  535. package/dist/op/gate.d.ts +29 -1
  536. package/dist/op/gate.d.ts.map +1 -1
  537. package/dist/op/gate.js +59 -23
  538. package/dist/op/generate-pipeline.d.ts.map +1 -1
  539. package/dist/op/generate-pipeline.js +7 -1
  540. package/dist/op/index.d.ts +12 -1
  541. package/dist/op/index.d.ts.map +1 -1
  542. package/dist/op/index.js +7 -1
  543. package/dist/op/op-waves-after-plan.d.ts +137 -0
  544. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  545. package/dist/op/op-waves-after-plan.js +163 -0
  546. package/dist/op/op-waves-capability-spec.d.ts +63 -0
  547. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  548. package/dist/op/op-waves-capability-spec.js +115 -0
  549. package/dist/op/op-waves-capability.d.ts +197 -0
  550. package/dist/op/op-waves-capability.d.ts.map +1 -0
  551. package/dist/op/op-waves-capability.js +311 -0
  552. package/dist/op/op-waves-events.d.ts +54 -0
  553. package/dist/op/op-waves-events.d.ts.map +1 -0
  554. package/dist/op/op-waves-events.js +122 -0
  555. package/dist/op/op-waves-notify.d.ts +7 -1
  556. package/dist/op/op-waves-notify.d.ts.map +1 -1
  557. package/dist/op/op-waves-notify.js +35 -16
  558. package/dist/op/op-waves-release-port.d.ts +18 -0
  559. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  560. package/dist/op/op-waves-release-port.js +61 -0
  561. package/dist/op/op-waves-release.d.ts +92 -0
  562. package/dist/op/op-waves-release.d.ts.map +1 -0
  563. package/dist/op/op-waves-release.js +96 -0
  564. package/dist/op/op-waves-run.d.ts +182 -6
  565. package/dist/op/op-waves-run.d.ts.map +1 -1
  566. package/dist/op/op-waves-run.js +1076 -44
  567. package/dist/op/op-waves-stand-down.d.ts +60 -0
  568. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  569. package/dist/op/op-waves-stand-down.js +96 -0
  570. package/dist/op/op-waves.d.ts +187 -8
  571. package/dist/op/op-waves.d.ts.map +1 -1
  572. package/dist/op/op-waves.js +203 -19
  573. package/dist/op/runtime.d.ts +95 -0
  574. package/dist/op/runtime.d.ts.map +1 -1
  575. package/dist/op/runtime.js +18 -0
  576. package/dist/op/stage-hooks.d.ts +45 -7
  577. package/dist/op/stage-hooks.d.ts.map +1 -1
  578. package/dist/op/stage-hooks.js +61 -3
  579. package/dist/op/steward-beside.d.ts.map +1 -1
  580. package/dist/op/steward-beside.js +2 -1
  581. package/dist/op/types.d.ts +2 -2
  582. package/dist/op/types.d.ts.map +1 -1
  583. package/dist/op/types.js +3 -2
  584. package/dist/otlp-metrics.d.ts +38 -0
  585. package/dist/otlp-metrics.d.ts.map +1 -0
  586. package/dist/otlp-metrics.js +82 -0
  587. package/dist/otlp.d.ts +249 -0
  588. package/dist/otlp.d.ts.map +1 -0
  589. package/dist/otlp.js +425 -0
  590. package/dist/override-gate.d.ts.map +1 -1
  591. package/dist/override-gate.js +5 -0
  592. package/dist/parallelism.d.ts +17 -0
  593. package/dist/parallelism.d.ts.map +1 -0
  594. package/dist/parallelism.js +33 -0
  595. package/dist/policy-packs.d.ts +69 -0
  596. package/dist/policy-packs.d.ts.map +1 -0
  597. package/dist/policy-packs.js +205 -0
  598. package/dist/policy-source.d.ts +51 -0
  599. package/dist/policy-source.d.ts.map +1 -0
  600. package/dist/policy-source.js +102 -0
  601. package/dist/pr-forge.d.ts +40 -0
  602. package/dist/pr-forge.d.ts.map +1 -1
  603. package/dist/pr-forge.js +146 -37
  604. package/dist/pr-loop.d.ts +158 -11
  605. package/dist/pr-loop.d.ts.map +1 -1
  606. package/dist/pr-loop.js +302 -44
  607. package/dist/pr-merge.d.ts +64 -0
  608. package/dist/pr-merge.d.ts.map +1 -0
  609. package/dist/pr-merge.js +78 -0
  610. package/dist/pr-post.d.ts +86 -1
  611. package/dist/pr-post.d.ts.map +1 -1
  612. package/dist/pr-post.js +141 -5
  613. package/dist/pr-report-url.d.ts +32 -4
  614. package/dist/pr-report-url.d.ts.map +1 -1
  615. package/dist/pr-report-url.js +45 -5
  616. package/dist/pr-requires.d.ts +13 -2
  617. package/dist/pr-requires.d.ts.map +1 -1
  618. package/dist/pr-requires.js +14 -0
  619. package/dist/release-floors.d.ts +1 -1
  620. package/dist/release-floors.js +1 -1
  621. package/dist/run-event.d.ts +26 -1
  622. package/dist/run-event.d.ts.map +1 -1
  623. package/dist/run-event.js +3 -1
  624. package/dist/scheduled-op-cloud.d.ts +32 -0
  625. package/dist/scheduled-op-cloud.d.ts.map +1 -0
  626. package/dist/scheduled-op-cloud.js +69 -0
  627. package/dist/sorted-json.d.ts +10 -0
  628. package/dist/sorted-json.d.ts.map +1 -0
  629. package/dist/sorted-json.js +14 -0
  630. package/dist/terraform/credentials.d.ts +59 -0
  631. package/dist/terraform/credentials.d.ts.map +1 -0
  632. package/dist/terraform/credentials.js +149 -0
  633. package/dist/utils.d.ts +1 -4
  634. package/dist/utils.d.ts.map +1 -1
  635. package/dist/utils.js +1 -9
  636. package/dist/wave-runtime.d.ts +1 -1
  637. package/dist/wave-runtime.js +2 -2
  638. package/dist/wave-runtime.mjs +405 -287
  639. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  640. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  641. package/dist/workspace/ci-lock-grain.d.ts +17 -0
  642. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  643. package/dist/workspace/ci-lock-grain.js +21 -0
  644. package/dist/workspace/ci-run.d.ts +2 -1
  645. package/dist/workspace/ci-run.d.ts.map +1 -1
  646. package/dist/workspace/ci-run.js +10 -3
  647. package/dist/workspace/declaration.d.ts +16 -4
  648. package/dist/workspace/declaration.d.ts.map +1 -1
  649. package/dist/workspace/declaration.js +5 -2
  650. package/dist/workspace/declaration.schema.json +27 -3
  651. package/dist/workspace/drift-cli.d.ts.map +1 -1
  652. package/dist/workspace/drift-cli.js +8 -3
  653. package/dist/workspace/exit-cli.d.ts +1 -1
  654. package/dist/workspace/exit-cli.d.ts.map +1 -1
  655. package/dist/workspace/exit-cli.js +2 -1
  656. package/dist/workspace/import-fetch.d.ts +4 -2
  657. package/dist/workspace/import-fetch.d.ts.map +1 -1
  658. package/dist/workspace/import-fetch.js +4 -2
  659. package/dist/workspace/import-init.d.ts.map +1 -1
  660. package/dist/workspace/import-init.js +4 -2
  661. package/dist/workspace/ledger.schema.json +7 -3
  662. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  663. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  664. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  665. package/dist/workspace/pr-report.schema.json +79 -3
  666. package/dist/workspace/promote.d.ts +1 -1
  667. package/dist/workspace/promote.d.ts.map +1 -1
  668. package/dist/workspace/promote.js +2 -1
  669. package/dist/workspace/records-cli.d.ts +2 -2
  670. package/dist/workspace/records-cli.d.ts.map +1 -1
  671. package/dist/workspace/records-cli.js +3 -2
  672. package/dist/workspace/release-catalog.schema.json +277 -0
  673. package/dist/workspace/run-event.schema.json +18 -1
  674. package/dist/workspace/work-cli.d.ts +3 -1
  675. package/dist/workspace/work-cli.d.ts.map +1 -1
  676. package/dist/workspace/work-cli.js +7 -2
  677. package/dist/workspace/workspace-run.d.ts.map +1 -1
  678. package/dist/workspace/workspace-run.js +2 -1
  679. package/package.json +21 -1
  680. package/src/__fixtures__/estate-ledger.ts +101 -0
  681. package/src/__fixtures__/oidc-emulator.ts +31 -2
  682. package/src/__fixtures__/product-words.ts +44 -0
  683. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  684. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  685. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  686. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  687. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  688. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  689. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  690. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  691. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  692. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  693. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  694. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  695. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  696. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  697. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  698. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  699. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  700. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  701. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  702. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  703. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  704. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  705. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  706. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  707. package/src/__golden__/wave-loop/op-point.json +18 -4
  708. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  709. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  710. package/src/__golden__/wave-loop/op-spend.json +10 -2
  711. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  712. package/src/__golden__/wave-loop/op-wide.json +20 -4
  713. package/src/bucket-check/azure.ts +307 -0
  714. package/src/bucket-check/bucket-check.test.ts +210 -0
  715. package/src/bucket-check/fixtures/azure.json +153 -0
  716. package/src/bucket-check/fixtures/gcs.json +148 -0
  717. package/src/bucket-check/fixtures/s3.json +277 -0
  718. package/src/bucket-check/gcs.ts +257 -0
  719. package/src/bucket-check/index.ts +61 -0
  720. package/src/bucket-check/s3.ts +433 -0
  721. package/src/bucket-check/types.ts +75 -0
  722. package/src/bucket-check/wire.ts +50 -0
  723. package/src/bucket-check.ts +5 -0
  724. package/src/capabilities/templates.test.ts +2 -3
  725. package/src/capabilities/templates.ts +1 -2
  726. package/src/cdk/advise.test.ts +1 -1
  727. package/src/change-set-bundle.test.ts +0 -1
  728. package/src/change-set.ts +2 -3
  729. package/src/ci-agent.test.ts +348 -0
  730. package/src/ci-agent.ts +1025 -0
  731. package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
  732. package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
  733. package/src/ci-audit/attribution.ts +260 -0
  734. package/src/ci-audit/audit-log.ts +220 -0
  735. package/src/ci-audit/ci-audit.test.ts +175 -0
  736. package/src/ci-audit/index.ts +15 -0
  737. package/src/ci-audit/unrecorded.ts +140 -0
  738. package/src/ci-audit.ts +2 -0
  739. package/src/ci-control.ts +173 -0
  740. package/src/ci-estate/delivery.ts +433 -0
  741. package/src/ci-estate/overdue.ts +81 -0
  742. package/src/ci-estate/page.ts +343 -0
  743. package/src/ci-estate/rows.ts +251 -0
  744. package/src/ci-estate.test.ts +281 -0
  745. package/src/ci-estate.ts +175 -0
  746. package/src/ci-handover.ts +67 -16
  747. package/src/ci-identity-database.test.ts +54 -0
  748. package/src/ci-identity-pulumi.test.ts +163 -0
  749. package/src/ci-identity-targets.test.ts +3 -1
  750. package/src/ci-identity.ts +123 -22
  751. package/src/ci-job-guard.test.ts +154 -0
  752. package/src/ci-job-guard.ts +319 -0
  753. package/src/ci-jobs.ts +8 -0
  754. package/src/ci-product-comment-targets.test.ts +45 -0
  755. package/src/ci-product-words.test.ts +101 -0
  756. package/src/ci-product-words.ts +565 -0
  757. package/src/ci-product.ts +226 -0
  758. package/src/ci-respond-run.ts +291 -0
  759. package/src/ci-respond.test.ts +264 -0
  760. package/src/ci-respond.ts +412 -0
  761. package/src/ci-shared-reads.test.ts +145 -0
  762. package/src/cli/commands/audit.test.ts +1 -1
  763. package/src/cli/commands/audit.ts +3 -2
  764. package/src/cli/commands/carve.test.ts +1 -1
  765. package/src/cli/commands/carve.ts +2 -2
  766. package/src/cli/commands/init.ts +3 -1
  767. package/src/cli/component-wave-args.test.ts +16 -0
  768. package/src/cli/handlers/agent.ts +126 -0
  769. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  770. package/src/cli/handlers/approve-confirm.ts +200 -0
  771. package/src/cli/handlers/approve.ts +18 -1
  772. package/src/cli/handlers/audit-log.ts +74 -0
  773. package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
  774. package/src/cli/handlers/build.test.ts +7 -0
  775. package/src/cli/handlers/build.ts +113 -1
  776. package/src/cli/handlers/ci-check-job.test.ts +114 -0
  777. package/src/cli/handlers/ci-check-job.ts +33 -0
  778. package/src/cli/handlers/ci-check.ts +63 -0
  779. package/src/cli/handlers/ci-forge-check.ts +91 -0
  780. package/src/cli/handlers/e2e-safe-run.ts +27 -0
  781. package/src/cli/handlers/fan-out.test.ts +10 -10
  782. package/src/cli/handlers/fan-out.ts +5 -0
  783. package/src/cli/handlers/gate-pending.ts +46 -0
  784. package/src/cli/handlers/init.ts +1 -0
  785. package/src/cli/handlers/ledger.ts +1 -1
  786. package/src/cli/handlers/lifecycle-drift.ts +7 -2
  787. package/src/cli/handlers/lock.test.ts +29 -2
  788. package/src/cli/handlers/lock.ts +66 -6
  789. package/src/cli/handlers/notify-relay.ts +130 -0
  790. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  791. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  792. package/src/cli/handlers/pr-env.ts +48 -11
  793. package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
  794. package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
  795. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  796. package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
  797. package/src/cli/handlers/pr-waves.test.ts +8 -2
  798. package/src/cli/handlers/pr.test.ts +8 -8
  799. package/src/cli/handlers/pr.ts +879 -205
  800. package/src/cli/handlers/promote.test.ts +5 -5
  801. package/src/cli/handlers/promote.ts +22 -2
  802. package/src/cli/handlers/release.ts +2 -0
  803. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  804. package/src/cli/handlers/run-wave.ts +144 -2
  805. package/src/cli/handlers/run.test.ts +6 -4
  806. package/src/cli/handlers/run.ts +86 -1
  807. package/src/cli/handlers/serve.ts +10 -1
  808. package/src/cli/main.test.ts +1 -1
  809. package/src/cli/main.ts +180 -13
  810. package/src/cli/mcp/ledger-tools.ts +126 -0
  811. package/src/cli/mcp/product-tools.test.ts +123 -0
  812. package/src/cli/mcp/product-tools.ts +129 -0
  813. package/src/cli/mcp/read-only.test.ts +134 -0
  814. package/src/cli/mcp/read-only.ts +68 -0
  815. package/src/cli/mcp/report-tools.ts +135 -0
  816. package/src/cli/mcp/server.test.ts +5 -4
  817. package/src/cli/mcp/server.ts +90 -16
  818. package/src/cli/mcp-config.ts +8 -3
  819. package/src/cli/parse-args.ts +119 -2
  820. package/src/cli/registry.ts +73 -0
  821. package/src/cloud-lister/sigv4.ts +80 -23
  822. package/src/components/adoption.test.ts +140 -0
  823. package/src/components/adoption.ts +140 -0
  824. package/src/components/apply-lease.ts +49 -0
  825. package/src/components/capability.ts +180 -6
  826. package/src/components/check-hooks.test.ts +66 -0
  827. package/src/components/check-hooks.ts +255 -0
  828. package/src/components/check-steps.test.ts +70 -0
  829. package/src/components/check-steps.ts +158 -0
  830. package/src/components/ci-services.test.ts +51 -0
  831. package/src/components/ci-services.ts +82 -0
  832. package/src/components/cli-support.ts +23 -2
  833. package/src/components/driver.test.ts +3 -3
  834. package/src/components/driver.ts +73 -6
  835. package/src/components/fan-out-run.ts +68 -18
  836. package/src/components/groups.ts +21 -4
  837. package/src/components/plan-flags.test.ts +46 -0
  838. package/src/components/pr-comment-preview-targets.test.ts +34 -0
  839. package/src/components/pr-comment-preview.test.ts +54 -0
  840. package/src/components/pr-env-ledger.test.ts +9 -0
  841. package/src/components/pr-env-ledger.ts +42 -0
  842. package/src/components/pr-env-ports.ts +29 -4
  843. package/src/components/pr-env-run-bundle.test.ts +2 -14
  844. package/src/components/pr-env-run.test.ts +19 -0
  845. package/src/components/pr-env-run.ts +12 -2
  846. package/src/components/pr-environment.test.ts +29 -0
  847. package/src/components/pr-environment.ts +40 -8
  848. package/src/components/pr-pipeline-runners.test.ts +80 -0
  849. package/src/components/pr-pipeline.test.ts +15 -0
  850. package/src/components/pr-pipeline.ts +498 -18
  851. package/src/components/pr-policy.ts +45 -7
  852. package/src/components/pr-run.test.ts +1 -1
  853. package/src/components/pr-run.ts +138 -11
  854. package/src/components/pr-stale-job.test.ts +34 -0
  855. package/src/components/pr-targets.test.ts +35 -0
  856. package/src/components/pr-targets.ts +45 -0
  857. package/src/components/product-pipeline.test.ts +200 -0
  858. package/src/components/product-pipeline.ts +383 -0
  859. package/src/components/promote.ts +10 -1
  860. package/src/components/release-compile.ts +87 -1
  861. package/src/components/release-promote.ts +65 -1
  862. package/src/components/repo-lock.ts +52 -0
  863. package/src/components/row-lease.test.ts +490 -0
  864. package/src/components/row-lease.ts +167 -0
  865. package/src/components/wave-plan-policy.test.ts +19 -0
  866. package/src/components/wave-plan.ts +96 -6
  867. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  868. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  869. package/src/control/applied.test.ts +148 -0
  870. package/src/control/applied.ts +191 -0
  871. package/src/control/consumers.test.ts +129 -0
  872. package/src/control/consumers.ts +192 -0
  873. package/src/control/control.test.ts +302 -0
  874. package/src/control/dispatch.ts +699 -0
  875. package/src/control/edges.test.ts +112 -0
  876. package/src/control/edges.ts +164 -0
  877. package/src/control/note-checkout.test.ts +91 -0
  878. package/src/control/reconcile.ts +250 -0
  879. package/src/control/records.ts +395 -0
  880. package/src/discovery/sandbox/bundle.ts +25 -1
  881. package/src/e2e-harness/__project__/chant.config.ts +4 -0
  882. package/src/e2e-harness/__project__/src/compose.ts +33 -0
  883. package/src/e2e-harness/bucket.ts +69 -0
  884. package/src/e2e-harness/claim.test.ts +150 -0
  885. package/src/e2e-harness/claim.ts +140 -0
  886. package/src/e2e-harness/driver.test.ts +304 -0
  887. package/src/e2e-harness/driver.ts +294 -0
  888. package/src/e2e-harness/forgejo.ts +267 -0
  889. package/src/e2e-harness/git.ts +96 -0
  890. package/src/e2e-harness/index.ts +50 -0
  891. package/src/e2e-harness/jobs.ts +35 -0
  892. package/src/e2e-harness/pins.ts +52 -0
  893. package/src/e2e-harness/ports.ts +130 -0
  894. package/src/e2e-harness/reports.ts +79 -0
  895. package/src/e2e-harness/safe-run-cli.test.ts +102 -0
  896. package/src/e2e-harness/safe-run-cli.ts +54 -0
  897. package/src/e2e-harness/safe-run.ts +198 -0
  898. package/src/e2e-harness/scenario.ts +89 -0
  899. package/src/e2e-harness/schemas/README.md +62 -0
  900. package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
  901. package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
  902. package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
  903. package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
  904. package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
  905. package/src/e2e-harness/schemas/index.ts +220 -0
  906. package/src/e2e-harness/schemas.test.ts +145 -0
  907. package/src/e2e-harness/stack.test.ts +124 -0
  908. package/src/e2e-harness/stack.ts +306 -0
  909. package/src/e2e-harness/steps.ts +30 -0
  910. package/src/e2e-harness.ts +2 -0
  911. package/src/engine-facts.test.ts +2 -3
  912. package/src/engine-facts.ts +1 -2
  913. package/src/exit-codes.test.ts +32 -0
  914. package/src/exit-codes.ts +61 -0
  915. package/src/forge-check/check.ts +155 -0
  916. package/src/forge-check/contract.ts +215 -0
  917. package/src/forge-check/forge-check.test.ts +427 -0
  918. package/src/forge-check/forge.ts +318 -0
  919. package/src/forge-check/index.ts +43 -0
  920. package/src/forge-check/pulumi.ts +192 -0
  921. package/src/forge-check/read-only.ts +56 -0
  922. package/src/forge-check/trust.ts +527 -0
  923. package/src/forge-check/types.ts +78 -0
  924. package/src/forge-check.ts +5 -0
  925. package/src/gate-decision-bundle.test.ts +11 -0
  926. package/src/gate-decision.ts +3 -0
  927. package/src/gate-policy.ts +92 -3
  928. package/src/gated-waves-bundle.test.ts +0 -1
  929. package/src/index.ts +2 -0
  930. package/src/lexicon.ts +143 -6
  931. package/src/lifecycle/adoption-file.ts +1 -2
  932. package/src/lifecycle/cloud-index.test.ts +2 -3
  933. package/src/lifecycle/cloud-index.ts +1 -2
  934. package/src/lifecycle/control-entries-ledger.test.ts +69 -0
  935. package/src/lifecycle/gate-applied.ts +6 -0
  936. package/src/lifecycle/gate-ledger.ts +35 -1
  937. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  938. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  939. package/src/lifecycle/gated-request-digest.ts +49 -0
  940. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  941. package/src/lifecycle/gated-request.ts +279 -0
  942. package/src/lifecycle/identity-match.ts +25 -6
  943. package/src/lifecycle/index-diff.ts +1 -2
  944. package/src/lifecycle/index-document.ts +1 -2
  945. package/src/lifecycle/index-import.test.ts +14 -0
  946. package/src/lifecycle/index-import.ts +54 -34
  947. package/src/lifecycle/ledger-read.ts +7 -3
  948. package/src/lifecycle/lock-rows.test.ts +109 -0
  949. package/src/lifecycle/lock-rows.ts +167 -0
  950. package/src/lifecycle/publish-target-context.test.ts +108 -0
  951. package/src/lifecycle/query.test.ts +2 -3
  952. package/src/lifecycle/query.ts +109 -8
  953. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  954. package/src/lifecycle/release-catalog-site.ts +291 -0
  955. package/src/lifecycle/release-catalog.test.ts +192 -0
  956. package/src/lifecycle/release-catalog.ts +353 -0
  957. package/src/lifecycle/release-changelog.test.ts +70 -0
  958. package/src/lifecycle/release-changelog.ts +71 -0
  959. package/src/lifecycle/release-cut.ts +2 -2
  960. package/src/lifecycle/release-ledger.ts +19 -0
  961. package/src/lifecycle/release-publish.ts +45 -22
  962. package/src/lifecycle/release-read.ts +2 -0
  963. package/src/lifecycle/release-status.test.ts +185 -0
  964. package/src/lifecycle/release-status.ts +175 -0
  965. package/src/lifecycle/resource-lock.test.ts +175 -0
  966. package/src/lifecycle/resource-lock.ts +354 -0
  967. package/src/lifecycle/retention.ts +2 -0
  968. package/src/lifecycle/run-ledger.ts +7 -1
  969. package/src/lifecycle/snapshot-store-s3.ts +9 -45
  970. package/src/lifecycle/snapshot-store.ts +1 -2
  971. package/src/lifecycle/target-lock.ts +24 -9
  972. package/src/lifecycle/wave-plans.ts +33 -5
  973. package/src/mcp/types.ts +7 -0
  974. package/src/notify-product.ts +76 -0
  975. package/src/notify-relay.test.ts +213 -0
  976. package/src/notify-relay.ts +407 -0
  977. package/src/notify.ts +95 -14
  978. package/src/object-store/azure-blob.ts +374 -0
  979. package/src/object-store/common.ts +133 -0
  980. package/src/object-store/errors.ts +26 -0
  981. package/src/object-store/from-env.ts +36 -0
  982. package/src/object-store/gcs.ts +436 -0
  983. package/src/object-store/index.ts +8 -0
  984. package/src/object-store/object-store.test.ts +130 -0
  985. package/src/object-store/s3.ts +350 -0
  986. package/src/op/activities/converge.ts +2 -1
  987. package/src/op/activities/index.ts +1 -1
  988. package/src/op/activities/review-agent.open.test.ts +78 -0
  989. package/src/op/activities/review-agent.test.ts +13 -0
  990. package/src/op/activities/review-agent.ts +89 -5
  991. package/src/op/approval-status.test.ts +134 -0
  992. package/src/op/approval-status.ts +235 -0
  993. package/src/op/gate-review.test.ts +2 -1
  994. package/src/op/gate.ts +81 -22
  995. package/src/op/generate-pipeline.ts +7 -1
  996. package/src/op/index.ts +23 -0
  997. package/src/op/op-waves-after-plan.test.ts +288 -0
  998. package/src/op/op-waves-after-plan.ts +238 -0
  999. package/src/op/op-waves-capability-spec.ts +133 -0
  1000. package/src/op/op-waves-capability.test.ts +217 -0
  1001. package/src/op/op-waves-capability.ts +370 -0
  1002. package/src/op/op-waves-events.ts +135 -0
  1003. package/src/op/op-waves-notify-words.test.ts +149 -0
  1004. package/src/op/op-waves-notify.ts +41 -16
  1005. package/src/op/op-waves-parallelism.test.ts +89 -0
  1006. package/src/op/op-waves-pull-request.test.ts +219 -0
  1007. package/src/op/op-waves-release-port.ts +64 -0
  1008. package/src/op/op-waves-release.test.ts +209 -0
  1009. package/src/op/op-waves-release.ts +132 -0
  1010. package/src/op/op-waves-run-record.test.ts +32 -0
  1011. package/src/op/op-waves-run.ts +1235 -52
  1012. package/src/op/op-waves-stand-down.test.ts +240 -0
  1013. package/src/op/op-waves-stand-down.ts +107 -0
  1014. package/src/op/op-waves-trace.test.ts +205 -0
  1015. package/src/op/op-waves.test.ts +112 -0
  1016. package/src/op/op-waves.ts +320 -22
  1017. package/src/op/runtime.ts +107 -0
  1018. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  1019. package/src/op/stage-hooks.ts +91 -12
  1020. package/src/op/steward-beside.ts +2 -1
  1021. package/src/op/types.ts +3 -2
  1022. package/src/otlp-metrics.ts +96 -0
  1023. package/src/otlp.test.ts +243 -0
  1024. package/src/otlp.ts +543 -0
  1025. package/src/override-gate-bundle.test.ts +2 -0
  1026. package/src/override-gate.ts +4 -0
  1027. package/src/parallelism.test.ts +38 -0
  1028. package/src/parallelism.ts +33 -0
  1029. package/src/policy-packs.ts +230 -0
  1030. package/src/policy-source.test.ts +256 -0
  1031. package/src/policy-source.ts +111 -0
  1032. package/src/pr-forge-bundle.test.ts +1 -1
  1033. package/src/pr-forge.ts +175 -33
  1034. package/src/pr-loop-bundle.test.ts +7 -3
  1035. package/src/pr-loop-narrowed.test.ts +63 -0
  1036. package/src/pr-loop-words.test.ts +155 -0
  1037. package/src/pr-loop.ts +398 -52
  1038. package/src/pr-merge.test.ts +100 -0
  1039. package/src/pr-merge.ts +105 -0
  1040. package/src/pr-post-stale.test.ts +163 -0
  1041. package/src/pr-post.ts +190 -5
  1042. package/src/pr-report-url.ts +61 -6
  1043. package/src/pr-requires.test.ts +37 -1
  1044. package/src/pr-requires.ts +16 -2
  1045. package/src/product-subpaths-plain-node.e2e.test.ts +212 -0
  1046. package/src/release-floors.ts +1 -1
  1047. package/src/run-event.ts +28 -1
  1048. package/src/scheduled-op-cloud.ts +68 -0
  1049. package/src/sorted-json.ts +17 -0
  1050. package/src/stage-hooks-bundle.test.ts +6 -0
  1051. package/src/terraform/credentials.test.ts +77 -0
  1052. package/src/terraform/credentials.ts +162 -0
  1053. package/src/utils.ts +2 -11
  1054. package/src/wave-loop-golden.test.ts +2 -1
  1055. package/src/wave-runtime.ts +2 -2
  1056. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  1057. package/src/workspace/ci-lock-grain.test.ts +31 -0
  1058. package/src/workspace/ci-lock-grain.ts +29 -0
  1059. package/src/workspace/ci-report-url.test.ts +1 -1
  1060. package/src/workspace/ci-run.test.ts +1 -1
  1061. package/src/workspace/ci-run.ts +10 -3
  1062. package/src/workspace/declaration.schema.json +27 -3
  1063. package/src/workspace/declaration.test.ts +1 -1
  1064. package/src/workspace/declaration.ts +26 -10
  1065. package/src/workspace/drift-cli.ts +8 -3
  1066. package/src/workspace/exit-cli.ts +2 -1
  1067. package/src/workspace/import-fetch.ts +4 -2
  1068. package/src/workspace/import-init.ts +4 -2
  1069. package/src/workspace/ledger.schema.json +7 -3
  1070. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  1071. package/src/workspace/pr-report.schema.json +79 -3
  1072. package/src/workspace/promote.ts +2 -1
  1073. package/src/workspace/records-cli.ts +3 -2
  1074. package/src/workspace/release-catalog.schema.json +277 -0
  1075. package/src/workspace/run-event.schema.json +18 -1
  1076. package/src/workspace/work-cli.ts +8 -2
  1077. package/src/workspace/workspace-run.ts +2 -1
package/src/otlp.ts ADDED
@@ -0,0 +1,543 @@
1
+ /**
2
+ * `@intentius/chant/otlp` (#4555): chant's OTLP trace exporter, shared by
3
+ * every CI product built on chant. A run's events (the run-event contract,
4
+ * ./run-event.ts) become one trace: a span for the run, one per wave,
5
+ * component and phase, one per step, and one per resource a lexicon timed.
6
+ * The trace goes out as OTLP/JSON over HTTP with Node's `fetch`, in one batch
7
+ * when the run settles. No OpenTelemetry SDK is loaded.
8
+ *
9
+ * Off unless an endpoint is set. It reads the standard variables:
10
+ *
11
+ * OTEL_EXPORTER_OTLP_ENDPOINT base URL; /v1/traces is added
12
+ * OTEL_EXPORTER_OTLP_TRACES_ENDPOINT the traces URL, used as given
13
+ * OTEL_EXPORTER_OTLP_HEADERS k=v,k2=v2 on every request (and the traces one)
14
+ * OTEL_TRACES_EXPORTER `none` turns traces off
15
+ * OTEL_SDK_DISABLED=true turns them off
16
+ * OTEL_SERVICE_NAME, OTEL_RESOURCE_ATTRIBUTES
17
+ * TRACEPARENT the run's trace joins it
18
+ *
19
+ * The product prefix. Span attributes chant writes carry the product's name
20
+ * as their namespace (`chant.*`, `terragucci.*`, `plywood.*`), from the
21
+ * product's words (`@intentius/chant/ci-product`, #4550): a product's bin
22
+ * sets its words, and the exporter names attributes with them. A product
23
+ * may also pass `prefix` to {@link configureOtlp} once, before it calls
24
+ * chant. Keys that already carry a namespace chant does not own (OpenTelemetry
25
+ * semantic conventions such as `vcs.ref.head.revision`) are written as given.
26
+ *
27
+ * Engine facts. A capability can say what it knows about one apply
28
+ * ({@link CapabilityTraceFacts}, `Capability.traceFacts`): attributes such
29
+ * as the root or stack, the binary and resource counts, and spans for the
30
+ * resources it timed. They join the step's span under the same prefix.
31
+ *
32
+ * This module imports only the product words and the run-event types, so a
33
+ * product bundle that loads it pulls in no CLI.
34
+ */
35
+
36
+ import { randomBytes } from "node:crypto";
37
+ import { activeProductWords } from "./ci-product-words";
38
+ import { CHANT_VERSION } from "./chant-version";
39
+ import type { RunEventBody, RunEventRun } from "./run-event";
40
+
41
+ /** The first chant with the OTLP exporter, op-wave run events and the product tool hook (#4555). */
42
+ export const OTLP_EXPORTER_FLOOR = "0.124.55";
43
+
44
+ export type OtlpAttrValue = string | number | boolean;
45
+ export type OtlpAttrs = Record<string, OtlpAttrValue | undefined>;
46
+
47
+ /** Where one signal goes. */
48
+ export interface OtlpTarget {
49
+ url: string;
50
+ headers: Record<string, string>;
51
+ }
52
+
53
+ /** The exporter's settings, from the environment. */
54
+ export interface OtlpConfig {
55
+ /** Absent when traces are off although the environment named an endpoint; `skipped` says why. */
56
+ traces?: OtlpTarget;
57
+ /** Resource attributes: `service.name` and OTEL_RESOURCE_ATTRIBUTES. */
58
+ resource: OtlpAttrs;
59
+ /** The attribute namespace: the product's name. */
60
+ prefix: string;
61
+ /** Why traces are off although an endpoint is set. */
62
+ skipped: string[];
63
+ /** TRACEPARENT, when the environment gave one. */
64
+ traceparent?: string;
65
+ }
66
+
67
+ /** `fetch`, as the exporter calls it. A test passes its own. */
68
+ export type OtlpFetch = (url: string, init: { method: string; headers: Record<string, string>; body: string; signal?: AbortSignal }) => Promise<{ ok: boolean; status: number; text(): Promise<string> }>;
69
+
70
+ /** A product name as an attribute namespace: the words' `product` is already `[a-z0-9-]`. */
71
+ const PREFIX = /^[a-z0-9][a-z0-9_-]*$/;
72
+
73
+ /** `k=v,k2=v2`, values percent-decoded, as OTEL_*_HEADERS and OTEL_RESOURCE_ATTRIBUTES write them. */
74
+ export function parseOtlpPairs(text: string | undefined): Record<string, string> {
75
+ const out: Record<string, string> = {};
76
+ for (const part of (text ?? "").split(",")) {
77
+ const i = part.indexOf("=");
78
+ if (i <= 0) continue;
79
+ const k = part.slice(0, i).trim();
80
+ let v = part.slice(i + 1).trim();
81
+ try {
82
+ v = decodeURIComponent(v);
83
+ } catch {
84
+ // kept as written
85
+ }
86
+ if (k) out[k] = v;
87
+ }
88
+ return out;
89
+ }
90
+
91
+ /** `k=v,k2=v2`, values percent-encoded. */
92
+ export function formatOtlpPairs(pairs: Record<string, string>): string {
93
+ return Object.entries(pairs).map(([k, v]) => `${k}=${encodeURIComponent(v)}`).join(",");
94
+ }
95
+
96
+ function tracesTarget(env: NodeJS.ProcessEnv, skipped: string[]): OtlpTarget | undefined {
97
+ const exporter = env.OTEL_TRACES_EXPORTER;
98
+ if (exporter !== undefined && exporter.trim() !== "" && !exporter.split(",").map((s) => s.trim()).includes("otlp")) return undefined;
99
+ const own = env.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT?.trim();
100
+ const base = env.OTEL_EXPORTER_OTLP_ENDPOINT?.trim();
101
+ const url = own || (base ? `${base.replace(/\/+$/, "")}/v1/traces` : undefined);
102
+ if (!url) return undefined;
103
+ const protocol = env.OTEL_EXPORTER_OTLP_TRACES_PROTOCOL ?? env.OTEL_EXPORTER_OTLP_PROTOCOL;
104
+ if (protocol === "grpc") {
105
+ skipped.push("traces: chant sends OTLP over HTTP and the protocol is grpc; point it at the collector's HTTP port");
106
+ return undefined;
107
+ }
108
+ if (!/^https?:\/\//.test(url)) {
109
+ skipped.push(`traces: ${url} is not an http or https URL`);
110
+ return undefined;
111
+ }
112
+ return { url, headers: { ...parseOtlpPairs(env.OTEL_EXPORTER_OTLP_HEADERS), ...parseOtlpPairs(env.OTEL_EXPORTER_OTLP_TRACES_HEADERS) } };
113
+ }
114
+
115
+ /**
116
+ * The exporter's settings from `env`, or undefined when no endpoint is set
117
+ * or the SDK is disabled. `prefix` defaults to the active product's name,
118
+ * and `service.name` to OTEL_SERVICE_NAME, then OTEL_RESOURCE_ATTRIBUTES,
119
+ * then the prefix.
120
+ */
121
+ export function otlpFromEnv(env: NodeJS.ProcessEnv = process.env, opts: { prefix?: string } = {}): OtlpConfig | undefined {
122
+ if (env.OTEL_SDK_DISABLED?.trim().toLowerCase() === "true") return undefined;
123
+ const skipped: string[] = [];
124
+ const traces = tracesTarget(env, skipped);
125
+ if (!traces && skipped.length === 0) return undefined;
126
+ const prefix = opts.prefix ?? activeProductWords().product;
127
+ if (!PREFIX.test(prefix)) throw new Error(`the OTLP attribute prefix ${JSON.stringify(prefix)} is not a product name ([a-z0-9][a-z0-9_-]*)`);
128
+ const resource: OtlpAttrs = { ...parseOtlpPairs(env.OTEL_RESOURCE_ATTRIBUTES) };
129
+ resource["service.name"] = env.OTEL_SERVICE_NAME?.trim() || resource["service.name"] || prefix;
130
+ const traceparent = env.TRACEPARENT?.trim();
131
+ return { ...(traces ? { traces } : {}), resource, prefix, skipped, ...(traceparent ? { traceparent } : {}) };
132
+ }
133
+
134
+ /**
135
+ * `attrs` under `prefix`: a key is written as `<prefix>.<key>` unless it
136
+ * already starts with `<prefix>.` or with a namespace from
137
+ * {@link OTLP_PASS_THROUGH}. Undefined values are dropped.
138
+ */
139
+ export function prefixedAttrs(prefix: string, attrs: OtlpAttrs | undefined): OtlpAttrs {
140
+ const out: OtlpAttrs = {};
141
+ for (const [k, v] of Object.entries(attrs ?? {})) {
142
+ if (v === undefined) continue;
143
+ const kept = k.startsWith(`${prefix}.`) || OTLP_PASS_THROUGH.some((ns) => k.startsWith(ns));
144
+ out[kept ? k : `${prefix}.${k}`] = v;
145
+ }
146
+ return out;
147
+ }
148
+
149
+ /** OpenTelemetry semantic-convention namespaces written as given, never under the product's prefix. */
150
+ export const OTLP_PASS_THROUGH: readonly string[] = ["service.", "deployment.", "vcs.", "cicd.", "error.", "code.", "process.", "cloud."];
151
+
152
+ // ── spans ────────────────────────────────────────────────────────────────────
153
+
154
+ /** A time in Unix nanoseconds, from milliseconds. */
155
+ export const nanosOf = (ms: number): bigint => BigInt(Math.round(ms)) * 1_000_000n;
156
+
157
+ export interface OtlpSpanEvent {
158
+ name: string;
159
+ /** Unix nanoseconds. */
160
+ time: bigint;
161
+ attributes: OtlpAttrs;
162
+ }
163
+
164
+ export interface OtlpSpan {
165
+ traceId: string;
166
+ spanId: string;
167
+ parentSpanId?: string;
168
+ name: string;
169
+ /** 1 internal, 3 client (a process or provider call the run made). */
170
+ kind: 1 | 3;
171
+ /** Unix nanoseconds. */
172
+ start: bigint;
173
+ end?: bigint;
174
+ attributes: OtlpAttrs;
175
+ error?: string;
176
+ events?: OtlpSpanEvent[];
177
+ }
178
+
179
+ const hex = (bytes: number): string => randomBytes(bytes).toString("hex");
180
+
181
+ /** `00-<trace>-<span>-<flags>`, or undefined when it is not one. */
182
+ export function parseTraceparent(text: string | undefined): { traceId: string; spanId: string } | undefined {
183
+ const m = /^[\da-f]{2}-([\da-f]{32})-([\da-f]{16})-[\da-f]{2}$/.exec((text ?? "").trim().toLowerCase());
184
+ if (!m || /^0+$/.test(m[1]!) || /^0+$/.test(m[2]!)) return undefined;
185
+ return { traceId: m[1]!, spanId: m[2]! };
186
+ }
187
+
188
+ /** One run's trace. Spans are kept in memory and sent once. */
189
+ export class OtlpTrace {
190
+ readonly traceId: string;
191
+ /** The span TRACEPARENT named, which the run's first span hangs under. */
192
+ readonly parent?: string;
193
+ readonly spans: OtlpSpan[] = [];
194
+ private readonly now: () => number;
195
+
196
+ constructor(traceparent?: string, opts: { now?: () => number } = {}) {
197
+ const p = parseTraceparent(traceparent);
198
+ this.traceId = p?.traceId ?? hex(16);
199
+ if (p) this.parent = p.spanId;
200
+ this.now = opts.now ?? (() => Date.now());
201
+ }
202
+
203
+ /** Open a span under `parent` (or the TRACEPARENT span), at `atMs` or now. */
204
+ start(name: string, parent?: OtlpSpan, attributes: OtlpAttrs = {}, opts: { kind?: 1 | 3; atMs?: number } = {}): OtlpSpan {
205
+ const span: OtlpSpan = { traceId: this.traceId, spanId: hex(8), name, kind: opts.kind ?? 1, start: nanosOf(opts.atMs ?? this.now()), attributes: { ...attributes } };
206
+ const parentId = parent?.spanId ?? this.parent;
207
+ if (parentId) span.parentSpanId = parentId;
208
+ this.spans.push(span);
209
+ return span;
210
+ }
211
+
212
+ /** Close `span` at `atMs` or now. A closed span stays as it was. */
213
+ end(span: OtlpSpan, attributes: OtlpAttrs = {}, error?: string, atMs?: number): void {
214
+ if (span.end !== undefined) return;
215
+ span.end = nanosOf(atMs ?? this.now());
216
+ if (span.end < span.start) span.end = span.start;
217
+ Object.assign(span.attributes, attributes);
218
+ if (error) span.error = error;
219
+ }
220
+
221
+ /** An event inside `span`, at `at` (an ISO time) or now. */
222
+ event(span: OtlpSpan, name: string, attributes: OtlpAttrs = {}, at?: string): void {
223
+ const ms = at ? Date.parse(at) : NaN;
224
+ (span.events ??= []).push({ name, time: nanosOf(Number.isFinite(ms) ? ms : this.now()), attributes: { ...attributes } });
225
+ }
226
+
227
+ /** The W3C header that makes `span` the parent of what a process sends. */
228
+ traceparent(span: OtlpSpan): string {
229
+ return `00-${this.traceId}-${span.spanId}-01`;
230
+ }
231
+ }
232
+
233
+ function attrList(attrs: OtlpAttrs): { key: string; value: Record<string, unknown> }[] {
234
+ return Object.entries(attrs)
235
+ .filter((e): e is [string, OtlpAttrValue] => e[1] !== undefined)
236
+ .map(([key, v]) => ({
237
+ key,
238
+ value: typeof v === "boolean" ? { boolValue: v } : typeof v === "number" ? (Number.isInteger(v) ? { intValue: String(v) } : { doubleValue: v }) : { stringValue: v },
239
+ }));
240
+ }
241
+
242
+ /** The OTLP/JSON body for a trace's spans. The scope is chant's, whichever product prefixes the attributes. */
243
+ export function otlpTracesBody(spans: readonly OtlpSpan[], resource: OtlpAttrs, version: string = CHANT_VERSION): unknown {
244
+ return {
245
+ resourceSpans: [{
246
+ resource: { attributes: attrList(resource) },
247
+ scopeSpans: [{
248
+ scope: { name: "chant", version },
249
+ spans: spans.map((s) => ({
250
+ traceId: s.traceId,
251
+ spanId: s.spanId,
252
+ ...(s.parentSpanId ? { parentSpanId: s.parentSpanId } : {}),
253
+ name: s.name,
254
+ kind: s.kind,
255
+ startTimeUnixNano: String(s.start),
256
+ endTimeUnixNano: String(s.end ?? s.start),
257
+ attributes: attrList(s.attributes),
258
+ ...(s.events?.length ? { events: s.events.map((e) => ({ timeUnixNano: String(e.time), name: e.name, attributes: attrList(e.attributes) })) } : {}),
259
+ status: s.error ? { code: 2, message: s.error } : { code: 1 },
260
+ })),
261
+ }],
262
+ }],
263
+ };
264
+ }
265
+
266
+ /** POST one OTLP/JSON body. Returns the problem, or undefined when the collector took it. Never throws. */
267
+ export async function sendOtlp(target: OtlpTarget, body: unknown, fetchFn: OtlpFetch = fetch as unknown as OtlpFetch): Promise<string | undefined> {
268
+ try {
269
+ const res = await fetchFn(target.url, {
270
+ method: "POST",
271
+ headers: { ...target.headers, "content-type": "application/json" },
272
+ body: JSON.stringify(body),
273
+ signal: AbortSignal.timeout(10_000),
274
+ });
275
+ if (!res.ok) return `${target.url} answered ${res.status}: ${(await res.text()).slice(0, 200)}`;
276
+ return undefined;
277
+ } catch (e) {
278
+ return `${target.url}: ${e instanceof Error ? e.message : String(e)}`;
279
+ }
280
+ }
281
+
282
+ // ── engine facts ─────────────────────────────────────────────────────────────
283
+
284
+ /** One timed piece of an apply, such as one resource's provider call or record write. */
285
+ export interface CapabilityTraceSpan {
286
+ /** The span's name, such as the resource's URN or address. */
287
+ name: string;
288
+ /** When it started, ISO-8601. */
289
+ startedAt: string;
290
+ durationMs: number;
291
+ /** Written under the product's prefix. */
292
+ attributes?: Record<string, OtlpAttrValue>;
293
+ failed?: boolean;
294
+ /** Spans inside this one, such as each call one resource made. */
295
+ children?: CapabilityTraceSpan[];
296
+ }
297
+
298
+ /**
299
+ * What a capability knows about one apply, for its step's span and run
300
+ * record (#4555): engine facts as attributes (the root or stack, the
301
+ * binary, resource counts) and the resources it timed. Keys are written
302
+ * under the product's prefix.
303
+ */
304
+ export interface CapabilityTraceFacts {
305
+ attributes?: Record<string, OtlpAttrValue>;
306
+ spans?: CapabilityTraceSpan[];
307
+ /**
308
+ * One line per resource the engine reported (#4615), in the order it
309
+ * reported them: the step's `step-settle` event carries them as
310
+ * `resources`, and the job's log prints one line each. Optional; an engine
311
+ * that reports nothing per resource leaves it out.
312
+ */
313
+ resources?: RunEventResource[];
314
+ }
315
+
316
+ import type { RunEventResource } from "./run-event";
317
+
318
+ // ── the exporter, configured once ────────────────────────────────────────────
319
+
320
+ /** The exporter a process uses: its settings and how it sends. */
321
+ export interface OtlpExporter {
322
+ readonly config: OtlpConfig;
323
+ /** A new trace, under TRACEPARENT when the environment gave one. */
324
+ trace(): OtlpTrace;
325
+ /** Send a trace's spans. Returns the problem, or undefined. Never throws. */
326
+ send(trace: OtlpTrace): Promise<string | undefined>;
327
+ }
328
+
329
+ let configured: { exporter: OtlpExporter | undefined } | undefined;
330
+
331
+ /** An exporter over `config`. */
332
+ export function createOtlpExporter(config: OtlpConfig, fetchFn?: OtlpFetch): OtlpExporter {
333
+ return {
334
+ config,
335
+ trace: () => new OtlpTrace(config.traceparent),
336
+ async send(trace) {
337
+ if (!config.traces) return config.skipped.join("; ") || undefined;
338
+ if (trace.spans.length === 0) return undefined;
339
+ return sendOtlp(config.traces, otlpTracesBody(trace.spans, config.resource), fetchFn);
340
+ },
341
+ };
342
+ }
343
+
344
+ /**
345
+ * Configure the process's exporter once: a product's bin calls this before
346
+ * it calls chant, with its prefix when its words are not set yet. Returns
347
+ * the exporter, or undefined when the environment names no endpoint. A
348
+ * later call replaces the earlier one.
349
+ */
350
+ export function configureOtlp(opts: { prefix?: string; env?: NodeJS.ProcessEnv; fetch?: OtlpFetch } = {}): OtlpExporter | undefined {
351
+ const config = otlpFromEnv(opts.env ?? process.env, opts.prefix !== undefined ? { prefix: opts.prefix } : {});
352
+ configured = { exporter: config ? createOtlpExporter(config, opts.fetch) : undefined };
353
+ return configured.exporter;
354
+ }
355
+
356
+ /** The process's exporter: the configured one, else one from the environment with the active product's prefix. */
357
+ export function activeOtlp(): OtlpExporter | undefined {
358
+ if (configured) return configured.exporter;
359
+ const config = otlpFromEnv(process.env);
360
+ return config ? createOtlpExporter(config) : undefined;
361
+ }
362
+
363
+ /** Forget the configured exporter, so the next {@link activeOtlp} reads the environment again. For tests. */
364
+ export function resetOtlp(): void {
365
+ configured = undefined;
366
+ }
367
+
368
+ // ── run events as a trace ────────────────────────────────────────────────────
369
+
370
+ type SettleStatus = "ok" | "failed" | "gated" | "waiting" | "skipped" | "cached" | "blocked" | "already-applied";
371
+
372
+ /**
373
+ * A run's trace, built from its run events as they are emitted (#4555). Hand
374
+ * {@link sink} to the run's stream; {@link annotate} a step with what its
375
+ * capability knew; {@link flush} once the run settles.
376
+ *
377
+ * The run is the root span (under TRACEPARENT when set). A component run's
378
+ * waves and components, and every run's phases, are spans below it, and each
379
+ * step is a span in its phase. A gate a step waits at, or was resolved by, is
380
+ * an event on the step's span. Every attribute chant writes is under the
381
+ * product's prefix.
382
+ */
383
+ export class RunEventTrace {
384
+ readonly trace: OtlpTrace;
385
+ readonly prefix: string;
386
+ private root?: OtlpSpan;
387
+ private readonly waves = new Map<number, OtlpSpan>();
388
+ private readonly components = new Map<string, OtlpSpan>();
389
+ private readonly phases = new Map<string, OtlpSpan>();
390
+ private readonly steps = new Map<string, OtlpSpan>();
391
+ private readonly now: () => number;
392
+ private readonly exporter?: OtlpExporter;
393
+
394
+ constructor(
395
+ readonly run: RunEventRun,
396
+ opts: { exporter?: OtlpExporter; trace?: OtlpTrace; prefix?: string; now?: () => number } = {},
397
+ ) {
398
+ this.now = opts.now ?? (() => Date.now());
399
+ this.trace = opts.trace ?? opts.exporter?.trace() ?? new OtlpTrace(undefined, { now: this.now });
400
+ this.prefix = opts.prefix ?? opts.exporter?.config.prefix ?? activeProductWords().product;
401
+ this.exporter = opts.exporter;
402
+ }
403
+
404
+ private attrs(a: OtlpAttrs): OtlpAttrs {
405
+ return prefixedAttrs(this.prefix, a);
406
+ }
407
+
408
+ private rootSpan(): OtlpSpan {
409
+ if (!this.root) {
410
+ const { runId, kind, name, gitSha, runtime, runOrigin } = this.run;
411
+ this.root = this.trace.start(`${kind} ${name}`, undefined, {
412
+ ...this.attrs({ "run.id": runId, "run.kind": kind, "run.name": name, "run.runtime": runtime, "run.forge": runOrigin.forge }),
413
+ ...(gitSha ? { "vcs.ref.head.revision": gitSha } : {}),
414
+ }, { atMs: this.now() });
415
+ }
416
+ return this.root;
417
+ }
418
+
419
+ private phaseKey(component: string | null, phase: string): string {
420
+ return `${component ?? ""}\u0000${phase}`;
421
+ }
422
+
423
+ private stepKey(component: string | null, phase: string, step: string, index?: number): string {
424
+ return `${component ?? ""}\u0000${phase}\u0000${step}\u0000${index ?? ""}`;
425
+ }
426
+
427
+ private phaseSpan(component: string | null, phase: string): OtlpSpan {
428
+ const key = this.phaseKey(component, phase);
429
+ let span = this.phases.get(key);
430
+ if (!span) {
431
+ const parent = (component !== null ? this.components.get(component) : undefined) ?? this.rootSpan();
432
+ span = this.trace.start(phase, parent, this.attrs({ phase, ...(component !== null ? { component } : {}) }));
433
+ this.phases.set(key, span);
434
+ }
435
+ return span;
436
+ }
437
+
438
+ private status(span: OtlpSpan, status: SettleStatus, error?: string, atMs?: number): void {
439
+ this.trace.end(span, this.attrs({ status }), status === "failed" ? error ?? "failed" : undefined, atMs);
440
+ }
441
+
442
+ /** Take one run event. Hand this to the run's stream as a sink. */
443
+ readonly sink = (body: RunEventBody): void => {
444
+ switch (body.type) {
445
+ case "run-start":
446
+ this.rootSpan();
447
+ return;
448
+ case "wave-start":
449
+ this.waves.set(body.wave, this.trace.start(`wave ${body.wave}`, this.rootSpan(), this.attrs({ wave: body.wave, components: body.components.join(",") })));
450
+ return;
451
+ case "wave-settle": {
452
+ const span = this.waves.get(body.wave);
453
+ if (span) this.status(span, body.status);
454
+ return;
455
+ }
456
+ case "component-start":
457
+ this.components.set(body.component, this.trace.start(body.component, this.waves.get(body.wave) ?? this.rootSpan(), this.attrs({ component: body.component, wave: body.wave })));
458
+ return;
459
+ case "component-settle": {
460
+ let span = this.components.get(body.component);
461
+ // A blocked or already-applied component never started: a zero-length span says it was there.
462
+ if (!span) span = this.trace.start(body.component, this.waves.get(body.wave) ?? this.rootSpan(), this.attrs({ component: body.component, wave: body.wave }));
463
+ this.status(span, body.status);
464
+ if (body.blockedBy) span.attributes[`${this.prefix}.blocked_by`] = body.blockedBy;
465
+ return;
466
+ }
467
+ case "phase-start":
468
+ this.phaseSpan(body.component, body.phase);
469
+ return;
470
+ case "phase-settle":
471
+ this.status(this.phaseSpan(body.component, body.phase), body.status);
472
+ return;
473
+ case "step-start": {
474
+ const key = this.stepKey(body.component, body.phase, body.step, body.index);
475
+ this.steps.set(key, this.trace.start(body.step, this.phaseSpan(body.component, body.phase), this.attrs({ step: body.step, phase: body.phase })));
476
+ return;
477
+ }
478
+ case "step-settle": {
479
+ const key = this.stepKey(body.component, body.phase, body.step, body.index);
480
+ let span = this.steps.get(key);
481
+ const end = this.now();
482
+ if (!span) {
483
+ // A step settled with no start (skipped, or timed elsewhere): it ran for its duration, up to now.
484
+ span = this.trace.start(body.step, this.phaseSpan(body.component, body.phase), this.attrs({ step: body.step, phase: body.phase }), { atMs: end - (body.durationMs ?? 0) });
485
+ this.steps.set(key, span);
486
+ }
487
+ if (body.skip) span.attributes[`${this.prefix}.skip`] = body.skip;
488
+ if (body.message) span.attributes[`${this.prefix}.message`] = body.message;
489
+ this.status(span, body.status, body.error, end);
490
+ return;
491
+ }
492
+ case "gate-waiting": {
493
+ const span = this.steps.get(this.stepKey(body.component, body.phase, body.step, body.index)) ?? this.phaseSpan(body.component, body.phase);
494
+ this.trace.event(span, "gate-waiting", this.attrs({ "gate.op": body.op, ...(body.gate ? { gate: body.gate } : {}), ...(body.point ? { "gate.point": body.point } : {}) }));
495
+ return;
496
+ }
497
+ case "gate-resolved": {
498
+ const span = this.steps.get(this.stepKey(body.component, body.phase, body.step, body.index)) ?? this.phaseSpan(body.component, body.phase);
499
+ this.trace.event(span, "gate-resolved", this.attrs({ "gate.op": body.op, gate: body.gate, "gate.resolved_by": body.resolvedBy, ...(body.via ? { "gate.via": body.via } : {}) }), body.resolvedAt);
500
+ return;
501
+ }
502
+ case "run-settle": {
503
+ const root = this.rootSpan();
504
+ const end = this.now();
505
+ // Anything still open closes with the run.
506
+ for (const span of this.trace.spans) if (span !== root && span.end === undefined) this.trace.end(span, {}, undefined, end);
507
+ this.status(root, body.status, body.failure?.reason ?? body.error, end);
508
+ if (body.failure) Object.assign(root.attributes, this.attrs({ "failure.code": body.failure.code, ...(body.failure.exitCode !== undefined ? { "failure.exit_code": body.failure.exitCode } : {}) }));
509
+ return;
510
+ }
511
+ }
512
+ };
513
+
514
+ /**
515
+ * Add a capability's facts to a step's span: its attributes, and a child
516
+ * span per timed piece. A step not seen yet gets a span in its phase.
517
+ */
518
+ annotate(at: { component?: string | null; phase: string; step: string; index?: number }, facts: CapabilityTraceFacts): void {
519
+ const component = at.component ?? null;
520
+ const key = this.stepKey(component, at.phase, at.step, at.index);
521
+ let span = this.steps.get(key);
522
+ if (!span) {
523
+ span = this.trace.start(at.step, this.phaseSpan(component, at.phase), this.attrs({ step: at.step, phase: at.phase }));
524
+ this.steps.set(key, span);
525
+ }
526
+ Object.assign(span.attributes, this.attrs(facts.attributes ?? {}));
527
+ for (const s of facts.spans ?? []) this.timed(s, span);
528
+ }
529
+
530
+ private timed(s: CapabilityTraceSpan, parent: OtlpSpan): void {
531
+ const started = Date.parse(s.startedAt);
532
+ if (!Number.isFinite(started) || !Number.isFinite(s.durationMs) || s.durationMs < 0) return;
533
+ const span = this.trace.start(s.name, parent, this.attrs(s.attributes ?? {}), { kind: 3, atMs: started });
534
+ this.trace.end(span, {}, s.failed ? "failed" : undefined, started + s.durationMs);
535
+ for (const c of s.children ?? []) this.timed(c, span);
536
+ }
537
+
538
+ /** Send the trace through the exporter it was made with. Returns the problem, or undefined. Never throws. */
539
+ async flush(): Promise<string | undefined> {
540
+ if (!this.exporter) return undefined;
541
+ return this.exporter.send(this.trace);
542
+ }
543
+ }
@@ -29,6 +29,8 @@ describe("the override-gate bundle", () => {
29
29
  expect(inputs.filter((i) => pattern.test(i)), String(pattern)).toEqual([]);
30
30
  }
31
31
  expect(inputs.map((i) => i.replace(/^.*?packages\//, "packages/")).sort()).toEqual([
32
+ // The product's override line (#4550): no imports.
33
+ "packages/core/src/ci-product-words.ts",
32
34
  "packages/core/src/content-digest.ts",
33
35
  "packages/core/src/declarable.ts",
34
36
  "packages/core/src/effect-receipt.ts",
@@ -38,6 +38,7 @@ import { spawnSync } from "node:child_process";
38
38
  import { OVERRIDE_GATE_OP } from "./op/gate-name";
39
39
  import { latestPendingGate } from "./lifecycle/gate-ledger-select";
40
40
  import { samePlanDigest } from "./lifecycle/plan-digest";
41
+ import { activeProductWords, isChantWords, overrideLine } from "./ci-product-words";
41
42
  import { gateSealRefusal, type GateSigners } from "./lifecycle/gate-seal";
42
43
  import { DEFAULT_SIGNERS_PATH } from "./workspace/trust/trust-files";
43
44
  import type { GateResolutionRecord, PendingGateRecord } from "./lifecycle/gate-ledger";
@@ -76,6 +77,9 @@ export function overrideDigest(subject: string, planDigest: string, rules: reado
76
77
 
77
78
  /** The command that overrides a denial. */
78
79
  export function overrideCommand(subject: string, rules: readonly string[], sealed = false): string {
80
+ // #4550: under a product's words, the product's override line, with the denied member as {target}.
81
+ const words = activeProductWords();
82
+ if (!isChantWords(words)) return overrideLine(words, { op: OVERRIDE_OP, target: subject, rules: sortedRules(rules), sign: sealed });
79
83
  return `chant approve ${OVERRIDE_OP} ${subject} ${sortedRules(rules).map((r) => `--rule ${r}`).join(" ")} --reason "<why>"${sealed ? " --sign" : ""}`;
80
84
  }
81
85
 
@@ -0,0 +1,38 @@
1
+ /** The parallelism limit (#4625). Written for the ci-products post-merge pass. */
2
+
3
+ import { describe, expect, test } from "vitest";
4
+ import { mapLimited, parallelismProblem } from "./parallelism";
5
+
6
+ describe("mapLimited", () => {
7
+ test("never runs more than the limit at once, and keeps the order", async () => {
8
+ let running = 0;
9
+ let most = 0;
10
+ const out = await mapLimited([5, 1, 4, 2, 3], 2, async (n) => {
11
+ running++;
12
+ most = Math.max(most, running);
13
+ await new Promise((r) => setTimeout(r, n));
14
+ running--;
15
+ return n * 10;
16
+ });
17
+ expect(out).toEqual([50, 10, 40, 20, 30]);
18
+ expect(most).toBe(2);
19
+ });
20
+
21
+ test("no limit runs them all at once", async () => {
22
+ let most = 0;
23
+ let running = 0;
24
+ await mapLimited([1, 2, 3], undefined, async () => {
25
+ running++;
26
+ most = Math.max(most, running);
27
+ await Promise.resolve();
28
+ running--;
29
+ });
30
+ expect(most).toBe(3);
31
+ });
32
+ });
33
+
34
+ test("parallelismProblem", () => {
35
+ expect(parallelismProblem("parallelism", 4)).toBeUndefined();
36
+ expect(parallelismProblem("parallelism", 0)).toMatch(/whole number of 1 or more/);
37
+ expect(parallelismProblem("parallelism", 1.5)).toMatch(/whole number/);
38
+ });
@@ -0,0 +1,33 @@
1
+ /**
2
+ * A limit on how many things run at once (#4625): members a pull request
3
+ * plans at once (`pr-plan --parallelism`), and runs an op wave applies at
4
+ * once (`parallelism` on the spec or a wave). A product's `parallelism`
5
+ * maps onto both.
6
+ */
7
+
8
+ /** Why `value` is not a parallelism, or undefined when it is one: a whole number of 1 or more. */
9
+ export function parallelismProblem(field: string, value: unknown): string | undefined {
10
+ if (typeof value === "number" && Number.isInteger(value) && value >= 1) return undefined;
11
+ return `${field} is ${JSON.stringify(value)}; give a whole number of 1 or more, the most that run at once`;
12
+ }
13
+
14
+ /**
15
+ * Run `fn` over `items` with at most `limit` in flight, results in the
16
+ * items' order. Items start in order, and `fn` is called synchronously when
17
+ * an item starts, so an item that awaits an earlier one's promise never
18
+ * waits on one that has not started. No limit, or one at least the number
19
+ * of items: all at once.
20
+ */
21
+ export async function mapLimited<T, R>(items: readonly T[], limit: number | undefined, fn: (item: T, index: number) => Promise<R>): Promise<R[]> {
22
+ if (limit === undefined || limit >= items.length) return Promise.all(items.map((item, i) => fn(item, i)));
23
+ const out: R[] = new Array(items.length);
24
+ let next = 0;
25
+ const worker = async (): Promise<void> => {
26
+ while (next < items.length) {
27
+ const i = next++;
28
+ out[i] = await fn(items[i]!, i);
29
+ }
30
+ };
31
+ await Promise.all(Array.from({ length: Math.max(1, limit) }, worker));
32
+ return out;
33
+ }