@intentius/chant 0.124.52 → 0.124.55

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 (1337) 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/audit/discover.d.ts.map +1 -1
  41. package/dist/audit/discover.js +3 -1
  42. package/dist/behaviour.d.ts +1 -1
  43. package/dist/behaviour.d.ts.map +1 -1
  44. package/dist/bucket-check/azure.d.ts +108 -0
  45. package/dist/bucket-check/azure.d.ts.map +1 -0
  46. package/dist/bucket-check/azure.js +258 -0
  47. package/dist/bucket-check/fixtures/azure.json +153 -0
  48. package/dist/bucket-check/fixtures/gcs.json +148 -0
  49. package/dist/bucket-check/fixtures/s3.json +277 -0
  50. package/dist/bucket-check/gcs.d.ts +77 -0
  51. package/dist/bucket-check/gcs.d.ts.map +1 -0
  52. package/dist/bucket-check/gcs.js +202 -0
  53. package/dist/bucket-check/index.d.ts +48 -0
  54. package/dist/bucket-check/index.d.ts.map +1 -0
  55. package/dist/bucket-check/index.js +44 -0
  56. package/dist/bucket-check/s3.d.ts +116 -0
  57. package/dist/bucket-check/s3.d.ts.map +1 -0
  58. package/dist/bucket-check/s3.js +362 -0
  59. package/dist/bucket-check/types.d.ts +66 -0
  60. package/dist/bucket-check/types.d.ts.map +1 -0
  61. package/dist/bucket-check/types.js +31 -0
  62. package/dist/bucket-check/wire.d.ts +27 -0
  63. package/dist/bucket-check/wire.d.ts.map +1 -0
  64. package/dist/bucket-check/wire.js +32 -0
  65. package/dist/bucket-check.d.ts +6 -0
  66. package/dist/bucket-check.d.ts.map +1 -0
  67. package/dist/bucket-check.js +5 -0
  68. package/dist/capabilities/templates.d.ts +65 -0
  69. package/dist/capabilities/templates.d.ts.map +1 -0
  70. package/dist/capabilities/templates.js +192 -0
  71. package/dist/capabilities/templates.json +145 -0
  72. package/dist/change-set-graph.d.ts +35 -3
  73. package/dist/change-set-graph.d.ts.map +1 -1
  74. package/dist/change-set-graph.js +60 -9
  75. package/dist/change-set.d.ts +65 -7
  76. package/dist/change-set.d.ts.map +1 -1
  77. package/dist/change-set.js +22 -12
  78. package/dist/ci-agent.d.ts +381 -0
  79. package/dist/ci-agent.d.ts.map +1 -0
  80. package/dist/ci-agent.js +833 -0
  81. package/dist/ci-control.d.ts +42 -0
  82. package/dist/ci-control.d.ts.map +1 -0
  83. package/dist/ci-control.js +42 -0
  84. package/dist/ci-estate/delivery.d.ts +137 -0
  85. package/dist/ci-estate/delivery.d.ts.map +1 -0
  86. package/dist/ci-estate/delivery.js +311 -0
  87. package/dist/ci-estate/overdue.d.ts +34 -0
  88. package/dist/ci-estate/overdue.d.ts.map +1 -0
  89. package/dist/ci-estate/overdue.js +58 -0
  90. package/dist/ci-estate/page.d.ts +134 -0
  91. package/dist/ci-estate/page.d.ts.map +1 -0
  92. package/dist/ci-estate/page.js +233 -0
  93. package/dist/ci-estate/rows.d.ts +118 -0
  94. package/dist/ci-estate/rows.d.ts.map +1 -0
  95. package/dist/ci-estate/rows.js +126 -0
  96. package/dist/ci-estate.d.ts +68 -0
  97. package/dist/ci-estate.d.ts.map +1 -0
  98. package/dist/ci-estate.js +83 -0
  99. package/dist/ci-handover.d.ts +29 -5
  100. package/dist/ci-handover.d.ts.map +1 -1
  101. package/dist/ci-handover.js +50 -16
  102. package/dist/ci-identity.d.ts +89 -9
  103. package/dist/ci-identity.d.ts.map +1 -1
  104. package/dist/ci-identity.js +91 -16
  105. package/dist/ci-product-words.d.ts +290 -0
  106. package/dist/ci-product-words.d.ts.map +1 -0
  107. package/dist/ci-product-words.js +373 -0
  108. package/dist/ci-product.d.ts +82 -0
  109. package/dist/ci-product.d.ts.map +1 -0
  110. package/dist/ci-product.js +78 -0
  111. package/dist/cli/commands/audit.d.ts +2 -2
  112. package/dist/cli/commands/audit.d.ts.map +1 -1
  113. package/dist/cli/commands/audit.js +3 -2
  114. package/dist/cli/commands/carve.js +2 -2
  115. package/dist/cli/commands/import-index.d.ts +52 -0
  116. package/dist/cli/commands/import-index.d.ts.map +1 -0
  117. package/dist/cli/commands/import-index.js +226 -0
  118. package/dist/cli/commands/init.d.ts +2 -0
  119. package/dist/cli/commands/init.d.ts.map +1 -1
  120. package/dist/cli/commands/init.js +1 -1
  121. package/dist/cli/commands/lint.d.ts.map +1 -1
  122. package/dist/cli/commands/lint.js +4 -2
  123. package/dist/cli/handlers/agent.d.ts +17 -0
  124. package/dist/cli/handlers/agent.d.ts.map +1 -0
  125. package/dist/cli/handlers/agent.js +114 -0
  126. package/dist/cli/handlers/approve-confirm.d.ts +84 -0
  127. package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
  128. package/dist/cli/handlers/approve-confirm.js +142 -0
  129. package/dist/cli/handlers/approve.d.ts.map +1 -1
  130. package/dist/cli/handlers/approve.js +19 -1
  131. package/dist/cli/handlers/build.d.ts.map +1 -1
  132. package/dist/cli/handlers/build.js +43 -1
  133. package/dist/cli/handlers/ci-check.d.ts +3 -0
  134. package/dist/cli/handlers/ci-check.d.ts.map +1 -0
  135. package/dist/cli/handlers/ci-check.js +34 -0
  136. package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
  137. package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
  138. package/dist/cli/handlers/ci-forge-check.js +89 -0
  139. package/dist/cli/handlers/components.d.ts.map +1 -1
  140. package/dist/cli/handlers/components.js +11 -2
  141. package/dist/cli/handlers/fan-out.d.ts.map +1 -1
  142. package/dist/cli/handlers/fan-out.js +20 -3
  143. package/dist/cli/handlers/gate-pending.d.ts +11 -0
  144. package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
  145. package/dist/cli/handlers/gate-pending.js +44 -0
  146. package/dist/cli/handlers/graph.d.ts.map +1 -1
  147. package/dist/cli/handlers/graph.js +22 -4
  148. package/dist/cli/handlers/index-cloud.d.ts +14 -0
  149. package/dist/cli/handlers/index-cloud.d.ts.map +1 -0
  150. package/dist/cli/handlers/index-cloud.js +22 -0
  151. package/dist/cli/handlers/index-diff.d.ts +18 -0
  152. package/dist/cli/handlers/index-diff.d.ts.map +1 -0
  153. package/dist/cli/handlers/index-diff.js +142 -0
  154. package/dist/cli/handlers/init.d.ts.map +1 -1
  155. package/dist/cli/handlers/init.js +1 -0
  156. package/dist/cli/handlers/ledger.js +1 -1
  157. package/dist/cli/handlers/lifecycle-drift.d.ts +29 -0
  158. package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -0
  159. package/dist/cli/handlers/lifecycle-drift.js +69 -0
  160. package/dist/cli/handlers/lifecycle.d.ts.map +1 -1
  161. package/dist/cli/handlers/lifecycle.js +188 -28
  162. package/dist/cli/handlers/lock.d.ts.map +1 -1
  163. package/dist/cli/handlers/lock.js +64 -5
  164. package/dist/cli/handlers/misc.d.ts +9 -0
  165. package/dist/cli/handlers/misc.d.ts.map +1 -1
  166. package/dist/cli/handlers/misc.js +77 -0
  167. package/dist/cli/handlers/notify-relay.d.ts +15 -0
  168. package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
  169. package/dist/cli/handlers/notify-relay.js +130 -0
  170. package/dist/cli/handlers/pr-env.d.ts.map +1 -1
  171. package/dist/cli/handlers/pr-env.js +42 -11
  172. package/dist/cli/handlers/pr.d.ts +38 -3
  173. package/dist/cli/handlers/pr.d.ts.map +1 -1
  174. package/dist/cli/handlers/pr.js +668 -207
  175. package/dist/cli/handlers/promote.d.ts.map +1 -1
  176. package/dist/cli/handlers/promote.js +110 -17
  177. package/dist/cli/handlers/query.d.ts.map +1 -1
  178. package/dist/cli/handlers/query.js +28 -4
  179. package/dist/cli/handlers/release.d.ts.map +1 -1
  180. package/dist/cli/handlers/release.js +3 -0
  181. package/dist/cli/handlers/run-wave.d.ts +8 -0
  182. package/dist/cli/handlers/run-wave.d.ts.map +1 -1
  183. package/dist/cli/handlers/run-wave.js +71 -1
  184. package/dist/cli/handlers/run.d.ts +6 -1
  185. package/dist/cli/handlers/run.d.ts.map +1 -1
  186. package/dist/cli/handlers/run.js +86 -1
  187. package/dist/cli/handlers/scenario.d.ts.map +1 -1
  188. package/dist/cli/handlers/scenario.js +8 -7
  189. package/dist/cli/handlers/search.d.ts +34 -4
  190. package/dist/cli/handlers/search.d.ts.map +1 -1
  191. package/dist/cli/handlers/search.js +216 -36
  192. package/dist/cli/handlers/serve.d.ts.map +1 -1
  193. package/dist/cli/handlers/serve.js +10 -1
  194. package/dist/cli/main.d.ts +11 -1
  195. package/dist/cli/main.d.ts.map +1 -1
  196. package/dist/cli/main.js +179 -14
  197. package/dist/cli/mcp/ledger-tools.d.ts +36 -0
  198. package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
  199. package/dist/cli/mcp/ledger-tools.js +122 -0
  200. package/dist/cli/mcp/lifecycle-tools.d.ts.map +1 -1
  201. package/dist/cli/mcp/lifecycle-tools.js +3 -2
  202. package/dist/cli/mcp/product-tools.d.ts +78 -0
  203. package/dist/cli/mcp/product-tools.d.ts.map +1 -0
  204. package/dist/cli/mcp/product-tools.js +93 -0
  205. package/dist/cli/mcp/read-only.d.ts +34 -0
  206. package/dist/cli/mcp/read-only.d.ts.map +1 -0
  207. package/dist/cli/mcp/read-only.js +61 -0
  208. package/dist/cli/mcp/report-tools.d.ts +48 -0
  209. package/dist/cli/mcp/report-tools.d.ts.map +1 -0
  210. package/dist/cli/mcp/report-tools.js +128 -0
  211. package/dist/cli/mcp/resource-handlers.d.ts.map +1 -1
  212. package/dist/cli/mcp/resource-handlers.js +4 -3
  213. package/dist/cli/mcp/server.d.ts +28 -1
  214. package/dist/cli/mcp/server.d.ts.map +1 -1
  215. package/dist/cli/mcp/server.js +86 -15
  216. package/dist/cli/mcp/workspace-tools.js +1 -1
  217. package/dist/cli/mcp-config.d.ts +9 -2
  218. package/dist/cli/mcp-config.d.ts.map +1 -1
  219. package/dist/cli/mcp-config.js +8 -3
  220. package/dist/cli/parse-args.d.ts.map +1 -1
  221. package/dist/cli/parse-args.js +112 -5
  222. package/dist/cli/registry.d.ts +54 -1
  223. package/dist/cli/registry.d.ts.map +1 -1
  224. package/dist/cloud-lister/aws.d.ts +35 -0
  225. package/dist/cloud-lister/aws.d.ts.map +1 -0
  226. package/dist/cloud-lister/aws.js +203 -0
  227. package/dist/cloud-lister/azure.d.ts +34 -0
  228. package/dist/cloud-lister/azure.d.ts.map +1 -0
  229. package/dist/cloud-lister/azure.js +129 -0
  230. package/dist/cloud-lister/common.d.ts +40 -0
  231. package/dist/cloud-lister/common.d.ts.map +1 -0
  232. package/dist/cloud-lister/common.js +83 -0
  233. package/dist/cloud-lister/credentials.d.ts +50 -0
  234. package/dist/cloud-lister/credentials.d.ts.map +1 -0
  235. package/dist/cloud-lister/credentials.js +86 -0
  236. package/dist/cloud-lister/fakes.d.ts +27 -0
  237. package/dist/cloud-lister/fakes.d.ts.map +1 -0
  238. package/dist/cloud-lister/fakes.js +50 -0
  239. package/dist/cloud-lister/gcp.d.ts +42 -0
  240. package/dist/cloud-lister/gcp.d.ts.map +1 -0
  241. package/dist/cloud-lister/gcp.js +143 -0
  242. package/dist/cloud-lister/guard.d.ts +49 -0
  243. package/dist/cloud-lister/guard.d.ts.map +1 -0
  244. package/dist/cloud-lister/guard.js +103 -0
  245. package/dist/cloud-lister/ids.d.ts +23 -0
  246. package/dist/cloud-lister/ids.d.ts.map +1 -0
  247. package/dist/cloud-lister/ids.js +42 -0
  248. package/dist/cloud-lister/index.d.ts +67 -0
  249. package/dist/cloud-lister/index.d.ts.map +1 -0
  250. package/dist/cloud-lister/index.js +102 -0
  251. package/dist/cloud-lister/kubernetes.d.ts +64 -0
  252. package/dist/cloud-lister/kubernetes.d.ts.map +1 -0
  253. package/dist/cloud-lister/kubernetes.js +276 -0
  254. package/dist/cloud-lister/markers.d.ts +31 -0
  255. package/dist/cloud-lister/markers.d.ts.map +1 -0
  256. package/dist/cloud-lister/markers.js +73 -0
  257. package/dist/cloud-lister/mask.d.ts +31 -0
  258. package/dist/cloud-lister/mask.d.ts.map +1 -0
  259. package/dist/cloud-lister/mask.js +74 -0
  260. package/dist/cloud-lister/sigv4.d.ts +64 -0
  261. package/dist/cloud-lister/sigv4.d.ts.map +1 -0
  262. package/dist/cloud-lister/sigv4.js +104 -0
  263. package/dist/cloud-lister/transport.d.ts +55 -0
  264. package/dist/cloud-lister/transport.d.ts.map +1 -0
  265. package/dist/cloud-lister/transport.js +86 -0
  266. package/dist/cloud-lister/types.d.ts +121 -0
  267. package/dist/cloud-lister/types.d.ts.map +1 -0
  268. package/dist/cloud-lister/types.js +24 -0
  269. package/dist/components/adoption.d.ts +69 -0
  270. package/dist/components/adoption.d.ts.map +1 -0
  271. package/dist/components/adoption.js +93 -0
  272. package/dist/components/apply-lease.d.ts +19 -0
  273. package/dist/components/apply-lease.d.ts.map +1 -0
  274. package/dist/components/apply-lease.js +41 -0
  275. package/dist/components/capability-plugin-loader.d.ts.map +1 -1
  276. package/dist/components/capability-plugin-loader.js +6 -0
  277. package/dist/components/capability-plugin.d.ts +9 -0
  278. package/dist/components/capability-plugin.d.ts.map +1 -1
  279. package/dist/components/capability.d.ts +337 -5
  280. package/dist/components/capability.d.ts.map +1 -1
  281. package/dist/components/capability.js +14 -6
  282. package/dist/components/check-hooks.d.ts +113 -0
  283. package/dist/components/check-hooks.d.ts.map +1 -0
  284. package/dist/components/check-hooks.js +192 -0
  285. package/dist/components/ci-services.d.ts +57 -0
  286. package/dist/components/ci-services.d.ts.map +1 -0
  287. package/dist/components/ci-services.js +61 -0
  288. package/dist/components/cli-support.d.ts +34 -0
  289. package/dist/components/cli-support.d.ts.map +1 -1
  290. package/dist/components/cli-support.js +67 -15
  291. package/dist/components/declared-reads.d.ts +38 -0
  292. package/dist/components/declared-reads.d.ts.map +1 -0
  293. package/dist/components/declared-reads.js +131 -0
  294. package/dist/components/deploy-units.d.ts.map +1 -1
  295. package/dist/components/deploy-units.js +4 -0
  296. package/dist/components/driver.d.ts +54 -4
  297. package/dist/components/driver.d.ts.map +1 -1
  298. package/dist/components/driver.js +90 -7
  299. package/dist/components/fan-out-run.d.ts +35 -1
  300. package/dist/components/fan-out-run.d.ts.map +1 -1
  301. package/dist/components/fan-out-run.js +138 -30
  302. package/dist/components/fan-out-support.d.ts +6 -0
  303. package/dist/components/fan-out-support.d.ts.map +1 -1
  304. package/dist/components/fan-out-support.js +4 -1
  305. package/dist/components/fan-out.d.ts +28 -0
  306. package/dist/components/fan-out.d.ts.map +1 -1
  307. package/dist/components/groups.d.ts +229 -0
  308. package/dist/components/groups.d.ts.map +1 -0
  309. package/dist/components/groups.js +777 -0
  310. package/dist/components/index.d.ts +6 -2
  311. package/dist/components/index.d.ts.map +1 -1
  312. package/dist/components/index.js +4 -0
  313. package/dist/components/plan-shape-conformance.d.ts +48 -0
  314. package/dist/components/plan-shape-conformance.d.ts.map +1 -0
  315. package/dist/components/plan-shape-conformance.js +122 -0
  316. package/dist/components/pr-env-ledger.d.ts +32 -0
  317. package/dist/components/pr-env-ledger.d.ts.map +1 -0
  318. package/dist/components/pr-env-ledger.js +39 -0
  319. package/dist/components/pr-env-ports.d.ts +12 -0
  320. package/dist/components/pr-env-ports.d.ts.map +1 -1
  321. package/dist/components/pr-env-ports.js +13 -3
  322. package/dist/components/pr-env-run.d.ts +6 -0
  323. package/dist/components/pr-env-run.d.ts.map +1 -1
  324. package/dist/components/pr-env-run.js +3 -2
  325. package/dist/components/pr-environment.d.ts +31 -3
  326. package/dist/components/pr-environment.d.ts.map +1 -1
  327. package/dist/components/pr-environment.js +25 -7
  328. package/dist/components/pr-pipeline.d.ts +169 -3
  329. package/dist/components/pr-pipeline.d.ts.map +1 -1
  330. package/dist/components/pr-pipeline.js +184 -9
  331. package/dist/components/pr-policy.d.ts +26 -2
  332. package/dist/components/pr-policy.d.ts.map +1 -1
  333. package/dist/components/pr-policy.js +41 -7
  334. package/dist/components/pr-run.d.ts +104 -4
  335. package/dist/components/pr-run.d.ts.map +1 -1
  336. package/dist/components/pr-run.js +290 -41
  337. package/dist/components/pr-targets.d.ts +24 -0
  338. package/dist/components/pr-targets.d.ts.map +1 -0
  339. package/dist/components/pr-targets.js +48 -0
  340. package/dist/components/product-pipeline.d.ts +217 -0
  341. package/dist/components/product-pipeline.d.ts.map +1 -0
  342. package/dist/components/product-pipeline.js +193 -0
  343. package/dist/components/promote-rounds.d.ts +9 -0
  344. package/dist/components/promote-rounds.d.ts.map +1 -1
  345. package/dist/components/promote-rounds.js +23 -2
  346. package/dist/components/promote.d.ts +23 -0
  347. package/dist/components/promote.d.ts.map +1 -1
  348. package/dist/components/promote.js +39 -6
  349. package/dist/components/release-compile.d.ts +22 -1
  350. package/dist/components/release-compile.d.ts.map +1 -1
  351. package/dist/components/release-compile.js +85 -0
  352. package/dist/components/release-gate.d.ts +23 -1
  353. package/dist/components/release-gate.d.ts.map +1 -1
  354. package/dist/components/release-gate.js +97 -33
  355. package/dist/components/release-promote.d.ts +15 -1
  356. package/dist/components/release-promote.d.ts.map +1 -1
  357. package/dist/components/release-promote.js +67 -2
  358. package/dist/components/repo-lock.d.ts +27 -0
  359. package/dist/components/repo-lock.d.ts.map +1 -0
  360. package/dist/components/repo-lock.js +49 -0
  361. package/dist/components/row-lease.d.ts +84 -0
  362. package/dist/components/row-lease.d.ts.map +1 -0
  363. package/dist/components/row-lease.js +110 -0
  364. package/dist/components/run-groups.d.ts +58 -0
  365. package/dist/components/run-groups.d.ts.map +1 -0
  366. package/dist/components/run-groups.js +78 -0
  367. package/dist/components/starter-plugin.d.ts +1 -0
  368. package/dist/components/starter-plugin.d.ts.map +1 -1
  369. package/dist/components/starter-plugin.js +6 -1
  370. package/dist/components/verbs/index.d.ts +1 -0
  371. package/dist/components/verbs/index.d.ts.map +1 -1
  372. package/dist/components/verbs/index.js +1 -0
  373. package/dist/components/verbs/member-outputs.d.ts +187 -0
  374. package/dist/components/verbs/member-outputs.d.ts.map +1 -0
  375. package/dist/components/verbs/member-outputs.js +218 -0
  376. package/dist/components/wave-plan.d.ts +34 -0
  377. package/dist/components/wave-plan.d.ts.map +1 -1
  378. package/dist/components/wave-plan.js +54 -2
  379. package/dist/config.d.ts +60 -0
  380. package/dist/config.d.ts.map +1 -1
  381. package/dist/config.js +27 -0
  382. package/dist/control/applied.d.ts +89 -0
  383. package/dist/control/applied.d.ts.map +1 -0
  384. package/dist/control/applied.js +175 -0
  385. package/dist/control/consumers.d.ts +78 -0
  386. package/dist/control/consumers.d.ts.map +1 -0
  387. package/dist/control/consumers.js +172 -0
  388. package/dist/control/dispatch.d.ts +334 -0
  389. package/dist/control/dispatch.d.ts.map +1 -0
  390. package/dist/control/dispatch.js +519 -0
  391. package/dist/control/edges.d.ts +75 -0
  392. package/dist/control/edges.d.ts.map +1 -0
  393. package/dist/control/edges.js +133 -0
  394. package/dist/control/reconcile.d.ts +120 -0
  395. package/dist/control/reconcile.d.ts.map +1 -0
  396. package/dist/control/reconcile.js +178 -0
  397. package/dist/control/records.d.ts +187 -0
  398. package/dist/control/records.d.ts.map +1 -0
  399. package/dist/control/records.js +307 -0
  400. package/dist/deep-observation.d.ts +1 -13
  401. package/dist/deep-observation.d.ts.map +1 -1
  402. package/dist/deep-observation.js +5 -22
  403. package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
  404. package/dist/discovery/sandbox/bundle.js +25 -1
  405. package/dist/drift-record.d.ts +542 -0
  406. package/dist/drift-record.d.ts.map +1 -0
  407. package/dist/drift-record.js +886 -0
  408. package/dist/engine-facts.d.ts +144 -0
  409. package/dist/engine-facts.d.ts.map +1 -0
  410. package/dist/engine-facts.js +13 -0
  411. package/dist/exit-codes.d.ts +48 -0
  412. package/dist/exit-codes.d.ts.map +1 -0
  413. package/dist/exit-codes.js +49 -0
  414. package/dist/forge-check/check.d.ts +63 -0
  415. package/dist/forge-check/check.d.ts.map +1 -0
  416. package/dist/forge-check/check.js +139 -0
  417. package/dist/forge-check/contract.d.ts +152 -0
  418. package/dist/forge-check/contract.d.ts.map +1 -0
  419. package/dist/forge-check/contract.js +118 -0
  420. package/dist/forge-check/forge.d.ts +42 -0
  421. package/dist/forge-check/forge.d.ts.map +1 -0
  422. package/dist/forge-check/forge.js +338 -0
  423. package/dist/forge-check/index.d.ts +24 -0
  424. package/dist/forge-check/index.d.ts.map +1 -0
  425. package/dist/forge-check/index.js +23 -0
  426. package/dist/forge-check/pulumi.d.ts +44 -0
  427. package/dist/forge-check/pulumi.d.ts.map +1 -0
  428. package/dist/forge-check/pulumi.js +184 -0
  429. package/dist/forge-check/read-only.d.ts +26 -0
  430. package/dist/forge-check/read-only.d.ts.map +1 -0
  431. package/dist/forge-check/read-only.js +53 -0
  432. package/dist/forge-check/trust.d.ts +94 -0
  433. package/dist/forge-check/trust.d.ts.map +1 -0
  434. package/dist/forge-check/trust.js +532 -0
  435. package/dist/forge-check/types.d.ts +80 -0
  436. package/dist/forge-check/types.d.ts.map +1 -0
  437. package/dist/forge-check/types.js +18 -0
  438. package/dist/forge-check.d.ts +6 -0
  439. package/dist/forge-check.d.ts.map +1 -0
  440. package/dist/forge-check.js +5 -0
  441. package/dist/gate-decision.d.ts +1 -0
  442. package/dist/gate-decision.d.ts.map +1 -1
  443. package/dist/gate-decision.js +2 -0
  444. package/dist/gate-policy.d.ts +47 -1
  445. package/dist/gate-policy.d.ts.map +1 -1
  446. package/dist/gate-policy.js +50 -2
  447. package/dist/graph-ir.d.ts +153 -2
  448. package/dist/graph-ir.d.ts.map +1 -1
  449. package/dist/graph-ir.js +224 -6
  450. package/dist/graph-refs.d.ts +145 -0
  451. package/dist/graph-refs.d.ts.map +1 -1
  452. package/dist/graph-refs.js +305 -0
  453. package/dist/graph-schema/fixtures/adopt.json +15 -0
  454. package/dist/graph-schema/fixtures/choudoufu.engine-graph.json +169 -0
  455. package/dist/graph-schema/fixtures/index.json +68 -0
  456. package/dist/graph-schema/fixtures/plunge.engine-graph.json +158 -0
  457. package/dist/graph-schema/fixtures.d.ts +23 -0
  458. package/dist/graph-schema/fixtures.d.ts.map +1 -0
  459. package/dist/graph-schema/fixtures.js +246 -0
  460. package/dist/graph-schema/generate.d.ts +15 -0
  461. package/dist/graph-schema/generate.d.ts.map +1 -0
  462. package/dist/graph-schema/generate.js +267 -0
  463. package/dist/graph-schema/graph.schema.json +1387 -0
  464. package/dist/health.schema.json +2 -1
  465. package/dist/identity.d.ts.map +1 -1
  466. package/dist/identity.js +2 -0
  467. package/dist/index.d.ts +2 -0
  468. package/dist/index.d.ts.map +1 -1
  469. package/dist/index.js +4 -0
  470. package/dist/instance-nodes.d.ts +159 -0
  471. package/dist/instance-nodes.d.ts.map +1 -0
  472. package/dist/instance-nodes.js +231 -0
  473. package/dist/lexicon.d.ts +178 -6
  474. package/dist/lexicon.d.ts.map +1 -1
  475. package/dist/lifecycle/adoption-file.d.ts +80 -0
  476. package/dist/lifecycle/adoption-file.d.ts.map +1 -0
  477. package/dist/lifecycle/adoption-file.js +122 -0
  478. package/dist/lifecycle/cloud-index.d.ts +186 -0
  479. package/dist/lifecycle/cloud-index.d.ts.map +1 -0
  480. package/dist/lifecycle/cloud-index.js +617 -0
  481. package/dist/lifecycle/derive-edges.d.ts +59 -0
  482. package/dist/lifecycle/derive-edges.d.ts.map +1 -0
  483. package/dist/lifecycle/derive-edges.js +126 -0
  484. package/dist/lifecycle/gate-applied.d.ts +6 -0
  485. package/dist/lifecycle/gate-applied.d.ts.map +1 -1
  486. package/dist/lifecycle/gate-ledger.d.ts +29 -0
  487. package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
  488. package/dist/lifecycle/gate-ledger.js +11 -1
  489. package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
  490. package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
  491. package/dist/lifecycle/gate-pending-by-plan.js +96 -0
  492. package/dist/lifecycle/gated-request-digest.d.ts +28 -0
  493. package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
  494. package/dist/lifecycle/gated-request-digest.js +35 -0
  495. package/dist/lifecycle/gated-request.d.ts +126 -0
  496. package/dist/lifecycle/gated-request.d.ts.map +1 -0
  497. package/dist/lifecycle/gated-request.js +205 -0
  498. package/dist/lifecycle/git.d.ts +10 -9
  499. package/dist/lifecycle/git.d.ts.map +1 -1
  500. package/dist/lifecycle/git.js +7 -1
  501. package/dist/lifecycle/identity-match.d.ts +148 -0
  502. package/dist/lifecycle/identity-match.d.ts.map +1 -0
  503. package/dist/lifecycle/identity-match.js +152 -0
  504. package/dist/lifecycle/index-diff.d.ts +264 -0
  505. package/dist/lifecycle/index-diff.d.ts.map +1 -0
  506. package/dist/lifecycle/index-diff.js +326 -0
  507. package/dist/lifecycle/index-document.d.ts +130 -0
  508. package/dist/lifecycle/index-document.d.ts.map +1 -0
  509. package/dist/lifecycle/index-document.js +188 -0
  510. package/dist/lifecycle/index-drift.d.ts +121 -0
  511. package/dist/lifecycle/index-drift.d.ts.map +1 -0
  512. package/dist/lifecycle/index-drift.js +178 -0
  513. package/dist/lifecycle/index-import.d.ts +171 -0
  514. package/dist/lifecycle/index-import.d.ts.map +1 -0
  515. package/dist/lifecycle/index-import.js +512 -0
  516. package/dist/lifecycle/index-join.d.ts +129 -0
  517. package/dist/lifecycle/index-join.d.ts.map +1 -0
  518. package/dist/lifecycle/index-join.js +248 -0
  519. package/dist/lifecycle/index.d.ts +4 -0
  520. package/dist/lifecycle/index.d.ts.map +1 -1
  521. package/dist/lifecycle/index.js +4 -0
  522. package/dist/lifecycle/ledger-read.d.ts.map +1 -1
  523. package/dist/lifecycle/ledger-read.js +7 -3
  524. package/dist/lifecycle/lock-rows.d.ts +76 -0
  525. package/dist/lifecycle/lock-rows.d.ts.map +1 -0
  526. package/dist/lifecycle/lock-rows.js +140 -0
  527. package/dist/lifecycle/observation-baseline.d.ts +61 -21
  528. package/dist/lifecycle/observation-baseline.d.ts.map +1 -1
  529. package/dist/lifecycle/observation-baseline.js +144 -19
  530. package/dist/lifecycle/observe.d.ts.map +1 -1
  531. package/dist/lifecycle/observe.js +6 -1
  532. package/dist/lifecycle/query.d.ts +94 -6
  533. package/dist/lifecycle/query.d.ts.map +1 -1
  534. package/dist/lifecycle/query.js +182 -9
  535. package/dist/lifecycle/release-catalog-site.d.ts +66 -0
  536. package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
  537. package/dist/lifecycle/release-catalog-site.js +232 -0
  538. package/dist/lifecycle/release-catalog.d.ts +201 -0
  539. package/dist/lifecycle/release-catalog.d.ts.map +1 -0
  540. package/dist/lifecycle/release-catalog.js +198 -0
  541. package/dist/lifecycle/release-changelog.d.ts +41 -0
  542. package/dist/lifecycle/release-changelog.d.ts.map +1 -0
  543. package/dist/lifecycle/release-changelog.js +38 -0
  544. package/dist/lifecycle/release-cut.d.ts +1 -0
  545. package/dist/lifecycle/release-cut.d.ts.map +1 -1
  546. package/dist/lifecycle/release-cut.js +1 -1
  547. package/dist/lifecycle/release-ledger.d.ts +16 -0
  548. package/dist/lifecycle/release-ledger.d.ts.map +1 -1
  549. package/dist/lifecycle/release-ledger.js +10 -0
  550. package/dist/lifecycle/release-publish.d.ts +43 -22
  551. package/dist/lifecycle/release-publish.d.ts.map +1 -1
  552. package/dist/lifecycle/release-read.d.ts.map +1 -1
  553. package/dist/lifecycle/release-read.js +3 -0
  554. package/dist/lifecycle/release-status.d.ts +86 -0
  555. package/dist/lifecycle/release-status.d.ts.map +1 -0
  556. package/dist/lifecycle/release-status.js +136 -0
  557. package/dist/lifecycle/replay.d.ts +10 -3
  558. package/dist/lifecycle/replay.d.ts.map +1 -1
  559. package/dist/lifecycle/replay.js +10 -6
  560. package/dist/lifecycle/resource-lock.d.ts +120 -0
  561. package/dist/lifecycle/resource-lock.d.ts.map +1 -0
  562. package/dist/lifecycle/resource-lock.js +317 -0
  563. package/dist/lifecycle/retention.d.ts.map +1 -1
  564. package/dist/lifecycle/retention.js +3 -0
  565. package/dist/lifecycle/run-ledger.d.ts.map +1 -1
  566. package/dist/lifecycle/run-ledger.js +9 -1
  567. package/dist/lifecycle/scenario.d.ts +4 -3
  568. package/dist/lifecycle/scenario.d.ts.map +1 -1
  569. package/dist/lifecycle/snapshot-store-fake.d.ts +9 -0
  570. package/dist/lifecycle/snapshot-store-fake.d.ts.map +1 -0
  571. package/dist/lifecycle/snapshot-store-fake.js +21 -0
  572. package/dist/lifecycle/snapshot-store-s3.d.ts +135 -0
  573. package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -0
  574. package/dist/lifecycle/snapshot-store-s3.js +219 -0
  575. package/dist/lifecycle/snapshot-store.d.ts +170 -0
  576. package/dist/lifecycle/snapshot-store.d.ts.map +1 -0
  577. package/dist/lifecycle/snapshot-store.js +831 -0
  578. package/dist/lifecycle/snapshot.d.ts +11 -0
  579. package/dist/lifecycle/snapshot.d.ts.map +1 -1
  580. package/dist/lifecycle/snapshot.js +18 -5
  581. package/dist/lifecycle/target-lock.d.ts +15 -0
  582. package/dist/lifecycle/target-lock.d.ts.map +1 -1
  583. package/dist/lifecycle/target-lock.js +25 -10
  584. package/dist/lifecycle/type-listing.d.ts +148 -0
  585. package/dist/lifecycle/type-listing.d.ts.map +1 -0
  586. package/dist/lifecycle/type-listing.js +166 -0
  587. package/dist/lint/component-checks.d.ts +15 -1
  588. package/dist/lint/component-checks.d.ts.map +1 -1
  589. package/dist/lint/component-checks.js +1 -0
  590. package/dist/lint/presets/relaxed.json +2 -1
  591. package/dist/lint/presets/strict.json +2 -1
  592. package/dist/lint/rules/__fixtures__/comp/comp008/fail/dns.component.d.ts +4 -0
  593. package/dist/lint/rules/__fixtures__/comp/comp008/fail/dns.component.d.ts.map +1 -0
  594. package/dist/lint/rules/__fixtures__/comp/comp008/fail/dns.component.js +13 -0
  595. package/dist/lint/rules/__fixtures__/comp/comp008/pass/dns.component.d.ts +4 -0
  596. package/dist/lint/rules/__fixtures__/comp/comp008/pass/dns.component.d.ts.map +1 -0
  597. package/dist/lint/rules/__fixtures__/comp/comp008/pass/dns.component.js +8 -0
  598. package/dist/lint/rules/comp/comp008-applies-signal-only-root.d.ts +33 -0
  599. package/dist/lint/rules/comp/comp008-applies-signal-only-root.d.ts.map +1 -0
  600. package/dist/lint/rules/comp/comp008-applies-signal-only-root.js +123 -0
  601. package/dist/lint/rules/comp/index.d.ts +2 -1
  602. package/dist/lint/rules/comp/index.d.ts.map +1 -1
  603. package/dist/lint/rules/comp/index.js +4 -1
  604. package/dist/mcp/types.d.ts +7 -0
  605. package/dist/mcp/types.d.ts.map +1 -1
  606. package/dist/notify-product.d.ts +43 -0
  607. package/dist/notify-product.d.ts.map +1 -0
  608. package/dist/notify-product.js +58 -0
  609. package/dist/notify-relay.d.ts +197 -0
  610. package/dist/notify-relay.d.ts.map +1 -0
  611. package/dist/notify-relay.js +321 -0
  612. package/dist/notify.d.ts +44 -4
  613. package/dist/notify.d.ts.map +1 -1
  614. package/dist/notify.js +77 -14
  615. package/dist/object-store/azure-blob.d.ts +129 -0
  616. package/dist/object-store/azure-blob.d.ts.map +1 -0
  617. package/dist/object-store/azure-blob.js +341 -0
  618. package/dist/object-store/common.d.ts +108 -0
  619. package/dist/object-store/common.d.ts.map +1 -0
  620. package/dist/object-store/common.js +80 -0
  621. package/dist/object-store/errors.d.ts +28 -0
  622. package/dist/object-store/errors.d.ts.map +1 -0
  623. package/dist/object-store/errors.js +21 -0
  624. package/dist/object-store/from-env.d.ts +18 -0
  625. package/dist/object-store/from-env.d.ts.map +1 -0
  626. package/dist/object-store/from-env.js +22 -0
  627. package/dist/object-store/gcs.d.ts +106 -0
  628. package/dist/object-store/gcs.d.ts.map +1 -0
  629. package/dist/object-store/gcs.js +393 -0
  630. package/dist/object-store/index.d.ts +9 -0
  631. package/dist/object-store/index.d.ts.map +1 -0
  632. package/dist/object-store/index.js +8 -0
  633. package/dist/object-store/s3.d.ts +146 -0
  634. package/dist/object-store/s3.d.ts.map +1 -0
  635. package/dist/object-store/s3.js +306 -0
  636. package/dist/observation.d.ts +19 -2
  637. package/dist/observation.d.ts.map +1 -1
  638. package/dist/observation.js +18 -1
  639. package/dist/op/activities/activity-contracts.d.ts +1 -1
  640. package/dist/op/activities/activity-contracts.js +1 -1
  641. package/dist/op/activities/change-set.d.ts +6 -4
  642. package/dist/op/activities/change-set.d.ts.map +1 -1
  643. package/dist/op/activities/change-set.js +4 -2
  644. package/dist/op/activities/converge.d.ts.map +1 -1
  645. package/dist/op/activities/converge.js +2 -1
  646. package/dist/op/activities/index.d.ts +1 -1
  647. package/dist/op/activities/index.d.ts.map +1 -1
  648. package/dist/op/activities/index.js +1 -1
  649. package/dist/op/activities/review-agent.d.ts +55 -2
  650. package/dist/op/activities/review-agent.d.ts.map +1 -1
  651. package/dist/op/activities/review-agent.js +65 -5
  652. package/dist/op/activity-failure.d.ts +27 -0
  653. package/dist/op/activity-failure.d.ts.map +1 -1
  654. package/dist/op/activity-failure.js +31 -0
  655. package/dist/op/gate.d.ts +29 -1
  656. package/dist/op/gate.d.ts.map +1 -1
  657. package/dist/op/gate.js +59 -23
  658. package/dist/op/generate-pipeline.d.ts.map +1 -1
  659. package/dist/op/generate-pipeline.js +7 -1
  660. package/dist/op/index.d.ts +14 -2
  661. package/dist/op/index.d.ts.map +1 -1
  662. package/dist/op/index.js +8 -2
  663. package/dist/op/local-executor.d.ts +5 -1
  664. package/dist/op/local-executor.d.ts.map +1 -1
  665. package/dist/op/local-executor.js +22 -8
  666. package/dist/op/op-waves-after-plan.d.ts +137 -0
  667. package/dist/op/op-waves-after-plan.d.ts.map +1 -0
  668. package/dist/op/op-waves-after-plan.js +163 -0
  669. package/dist/op/op-waves-capability-spec.d.ts +55 -0
  670. package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
  671. package/dist/op/op-waves-capability-spec.js +94 -0
  672. package/dist/op/op-waves-capability.d.ts +197 -0
  673. package/dist/op/op-waves-capability.d.ts.map +1 -0
  674. package/dist/op/op-waves-capability.js +311 -0
  675. package/dist/op/op-waves-events.d.ts +54 -0
  676. package/dist/op/op-waves-events.d.ts.map +1 -0
  677. package/dist/op/op-waves-events.js +122 -0
  678. package/dist/op/op-waves-notify.d.ts +7 -1
  679. package/dist/op/op-waves-notify.d.ts.map +1 -1
  680. package/dist/op/op-waves-notify.js +35 -16
  681. package/dist/op/op-waves-release-port.d.ts +18 -0
  682. package/dist/op/op-waves-release-port.d.ts.map +1 -0
  683. package/dist/op/op-waves-release-port.js +61 -0
  684. package/dist/op/op-waves-release.d.ts +92 -0
  685. package/dist/op/op-waves-release.d.ts.map +1 -0
  686. package/dist/op/op-waves-release.js +97 -0
  687. package/dist/op/op-waves-run.d.ts +175 -4
  688. package/dist/op/op-waves-run.d.ts.map +1 -1
  689. package/dist/op/op-waves-run.js +981 -41
  690. package/dist/op/op-waves-stand-down.d.ts +60 -0
  691. package/dist/op/op-waves-stand-down.d.ts.map +1 -0
  692. package/dist/op/op-waves-stand-down.js +97 -0
  693. package/dist/op/op-waves.d.ts +152 -8
  694. package/dist/op/op-waves.d.ts.map +1 -1
  695. package/dist/op/op-waves.js +161 -17
  696. package/dist/op/runtime.d.ts +91 -0
  697. package/dist/op/runtime.d.ts.map +1 -1
  698. package/dist/op/runtime.js +19 -0
  699. package/dist/op/stage-hooks.d.ts +45 -7
  700. package/dist/op/stage-hooks.d.ts.map +1 -1
  701. package/dist/op/stage-hooks.js +61 -3
  702. package/dist/op/steward-beside.d.ts.map +1 -1
  703. package/dist/op/steward-beside.js +2 -1
  704. package/dist/op/types.d.ts +2 -2
  705. package/dist/op/types.d.ts.map +1 -1
  706. package/dist/op/types.js +3 -2
  707. package/dist/otlp-metrics.d.ts +38 -0
  708. package/dist/otlp-metrics.d.ts.map +1 -0
  709. package/dist/otlp-metrics.js +82 -0
  710. package/dist/otlp.d.ts +249 -0
  711. package/dist/otlp.d.ts.map +1 -0
  712. package/dist/otlp.js +426 -0
  713. package/dist/override-gate.d.ts.map +1 -1
  714. package/dist/override-gate.js +5 -0
  715. package/dist/policy-packs.d.ts +69 -0
  716. package/dist/policy-packs.d.ts.map +1 -0
  717. package/dist/policy-packs.js +205 -0
  718. package/dist/policy-source.d.ts +51 -0
  719. package/dist/policy-source.d.ts.map +1 -0
  720. package/dist/policy-source.js +103 -0
  721. package/dist/pr-forge.d.ts +40 -0
  722. package/dist/pr-forge.d.ts.map +1 -1
  723. package/dist/pr-forge.js +92 -0
  724. package/dist/pr-loop.d.ts +205 -12
  725. package/dist/pr-loop.d.ts.map +1 -1
  726. package/dist/pr-loop.js +330 -41
  727. package/dist/pr-post.d.ts +16 -0
  728. package/dist/pr-post.d.ts.map +1 -1
  729. package/dist/pr-post.js +26 -1
  730. package/dist/pr-report-url.d.ts +32 -4
  731. package/dist/pr-report-url.d.ts.map +1 -1
  732. package/dist/pr-report-url.js +46 -5
  733. package/dist/pr-requires.d.ts +13 -2
  734. package/dist/pr-requires.d.ts.map +1 -1
  735. package/dist/pr-requires.js +14 -0
  736. package/dist/pulumi-urn.d.ts +101 -0
  737. package/dist/pulumi-urn.d.ts.map +1 -0
  738. package/dist/pulumi-urn.js +131 -0
  739. package/dist/release-floors.d.ts +23 -0
  740. package/dist/release-floors.d.ts.map +1 -0
  741. package/dist/release-floors.js +22 -0
  742. package/dist/run-event.d.ts +26 -1
  743. package/dist/run-event.d.ts.map +1 -1
  744. package/dist/run-event.js +4 -1
  745. package/dist/sensitive-key.d.ts +23 -0
  746. package/dist/sensitive-key.d.ts.map +1 -0
  747. package/dist/sensitive-key.js +31 -0
  748. package/dist/sorted-json.d.ts +10 -0
  749. package/dist/sorted-json.d.ts.map +1 -0
  750. package/dist/sorted-json.js +14 -0
  751. package/dist/terraform/credentials.d.ts +59 -0
  752. package/dist/terraform/credentials.d.ts.map +1 -0
  753. package/dist/terraform/credentials.js +149 -0
  754. package/dist/utils.d.ts +1 -4
  755. package/dist/utils.d.ts.map +1 -1
  756. package/dist/utils.js +1 -9
  757. package/dist/wave-runtime.d.ts +1 -1
  758. package/dist/wave-runtime.js +2 -2
  759. package/dist/wave-runtime.mjs +390 -285
  760. package/dist/workspace/adoption-report.d.ts +53 -0
  761. package/dist/workspace/adoption-report.d.ts.map +1 -0
  762. package/dist/workspace/adoption-report.js +76 -0
  763. package/dist/workspace/capabilities-contract.d.ts +7 -0
  764. package/dist/workspace/capabilities-contract.d.ts.map +1 -1
  765. package/dist/workspace/capabilities-contract.js +2 -1
  766. package/dist/workspace/capabilities.schema.json +98 -0
  767. package/dist/workspace/change-set.schema.json +42 -3
  768. package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
  769. package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
  770. package/dist/workspace/ci-cloud-identity.d.ts +13 -1
  771. package/dist/workspace/ci-cloud-identity.d.ts.map +1 -1
  772. package/dist/workspace/ci-cloud-identity.js +30 -1
  773. package/dist/workspace/ci-lock-grain.d.ts +12 -0
  774. package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
  775. package/dist/workspace/ci-lock-grain.js +27 -0
  776. package/dist/workspace/ci-run.d.ts +2 -1
  777. package/dist/workspace/ci-run.d.ts.map +1 -1
  778. package/dist/workspace/ci-run.js +6 -3
  779. package/dist/workspace/compose-graph.d.ts +10 -1
  780. package/dist/workspace/compose-graph.d.ts.map +1 -1
  781. package/dist/workspace/compose-graph.js +6 -1
  782. package/dist/workspace/conformance/index.d.ts +1 -1
  783. package/dist/workspace/conformance/index.d.ts.map +1 -1
  784. package/dist/workspace/conformance/index.js +6 -1
  785. package/dist/workspace/declaration.d.ts +16 -4
  786. package/dist/workspace/declaration.d.ts.map +1 -1
  787. package/dist/workspace/declaration.js +5 -2
  788. package/dist/workspace/declaration.schema.json +27 -3
  789. package/dist/workspace/drift-cli.d.ts +81 -0
  790. package/dist/workspace/drift-cli.d.ts.map +1 -0
  791. package/dist/workspace/drift-cli.js +322 -0
  792. package/dist/workspace/drift.schema.json +672 -0
  793. package/dist/workspace/exit-cli.d.ts +1 -1
  794. package/dist/workspace/exit-cli.d.ts.map +1 -1
  795. package/dist/workspace/exit-cli.js +2 -1
  796. package/dist/workspace/graph-cli.d.ts +2 -0
  797. package/dist/workspace/graph-cli.d.ts.map +1 -1
  798. package/dist/workspace/graph-cli.js +3 -0
  799. package/dist/workspace/graph.schema.json +72 -0
  800. package/dist/workspace/import-fetch.d.ts +4 -2
  801. package/dist/workspace/import-fetch.d.ts.map +1 -1
  802. package/dist/workspace/import-fetch.js +4 -2
  803. package/dist/workspace/import-init.d.ts.map +1 -1
  804. package/dist/workspace/import-init.js +4 -2
  805. package/dist/workspace/init.d.ts +5 -1
  806. package/dist/workspace/init.d.ts.map +1 -1
  807. package/dist/workspace/init.js +55 -9
  808. package/dist/workspace/ledger.schema.json +7 -3
  809. package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
  810. package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
  811. package/dist/workspace/lineage-upgrade-cli.js +2 -1
  812. package/dist/workspace/nested-graph.d.ts.map +1 -1
  813. package/dist/workspace/nested-graph.js +2 -0
  814. package/dist/workspace/pr-report.schema.json +125 -5
  815. package/dist/workspace/promote-waves.d.ts +112 -0
  816. package/dist/workspace/promote-waves.d.ts.map +1 -0
  817. package/dist/workspace/promote-waves.js +290 -0
  818. package/dist/workspace/promote.d.ts +85 -3
  819. package/dist/workspace/promote.d.ts.map +1 -1
  820. package/dist/workspace/promote.js +349 -62
  821. package/dist/workspace/reason-codes.d.ts +12 -0
  822. package/dist/workspace/reason-codes.d.ts.map +1 -1
  823. package/dist/workspace/reason-codes.js +14 -0
  824. package/dist/workspace/records-cli.d.ts +2 -2
  825. package/dist/workspace/records-cli.d.ts.map +1 -1
  826. package/dist/workspace/records-cli.js +3 -2
  827. package/dist/workspace/release-catalog.schema.json +277 -0
  828. package/dist/workspace/run-event.schema.json +18 -1
  829. package/dist/workspace/search-contract.d.ts +3 -3
  830. package/dist/workspace/search-contract.d.ts.map +1 -1
  831. package/dist/workspace/search-contract.js +2 -0
  832. package/dist/workspace/search.schema.json +103 -5
  833. package/dist/workspace/work-cli.d.ts +3 -1
  834. package/dist/workspace/work-cli.d.ts.map +1 -1
  835. package/dist/workspace/work-cli.js +7 -2
  836. package/dist/workspace/workspace-run.d.ts.map +1 -1
  837. package/dist/workspace/workspace-run.js +2 -1
  838. package/package.json +34 -1
  839. package/src/__fixtures__/drift-record/README.md +58 -0
  840. package/src/__fixtures__/drift-record/choudoufu-cone.ndjson +4 -0
  841. package/src/__fixtures__/drift-record/choudoufu-resource.ndjson +3 -0
  842. package/src/__fixtures__/drift-record/component-status-ledger.json +65 -0
  843. package/src/__fixtures__/drift-record/component-status.json +91 -0
  844. package/src/__fixtures__/drift-record/deep-diff.json +259 -0
  845. package/src/__fixtures__/drift-record/lifecycle-diff-live.json +825 -0
  846. package/src/__fixtures__/drift-record/live-diff.json +125 -0
  847. package/src/__fixtures__/estate-ledger.ts +101 -0
  848. package/src/__fixtures__/oidc-emulator.ts +31 -2
  849. package/src/__fixtures__/product-words.ts +44 -0
  850. package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
  851. package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
  852. package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
  853. package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
  854. package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
  855. package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
  856. package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
  857. package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
  858. package/src/__golden__/wave-loop/op-held-on.json +28 -7
  859. package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
  860. package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
  861. package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
  862. package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
  863. package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
  864. package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
  865. package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
  866. package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
  867. package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
  868. package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
  869. package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
  870. package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
  871. package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
  872. package/src/__golden__/wave-loop/op-overridden.json +28 -7
  873. package/src/__golden__/wave-loop/op-per-run.json +20 -4
  874. package/src/__golden__/wave-loop/op-point.json +18 -4
  875. package/src/__golden__/wave-loop/op-pr-review.json +10 -2
  876. package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
  877. package/src/__golden__/wave-loop/op-spend.json +10 -2
  878. package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
  879. package/src/__golden__/wave-loop/op-wide.json +20 -4
  880. package/src/audit/discover.e2e.test.ts +14 -0
  881. package/src/audit/discover.ts +3 -1
  882. package/src/behaviour.ts +1 -1
  883. package/src/bucket-check/azure.ts +307 -0
  884. package/src/bucket-check/bucket-check.test.ts +210 -0
  885. package/src/bucket-check/fixtures/azure.json +153 -0
  886. package/src/bucket-check/fixtures/gcs.json +148 -0
  887. package/src/bucket-check/fixtures/s3.json +277 -0
  888. package/src/bucket-check/gcs.ts +257 -0
  889. package/src/bucket-check/index.ts +61 -0
  890. package/src/bucket-check/s3.ts +433 -0
  891. package/src/bucket-check/types.ts +75 -0
  892. package/src/bucket-check/wire.ts +50 -0
  893. package/src/bucket-check.ts +5 -0
  894. package/src/capabilities/templates.json +145 -0
  895. package/src/capabilities/templates.test.ts +211 -0
  896. package/src/capabilities/templates.ts +203 -0
  897. package/src/cdk/advise.test.ts +1 -1
  898. package/src/change-set-bundle.test.ts +82 -0
  899. package/src/change-set-graph.ts +80 -9
  900. package/src/change-set.test.ts +24 -0
  901. package/src/change-set.ts +76 -14
  902. package/src/ci-agent.test.ts +348 -0
  903. package/src/ci-agent.ts +1026 -0
  904. package/src/ci-control.ts +174 -0
  905. package/src/ci-estate/delivery.ts +433 -0
  906. package/src/ci-estate/overdue.ts +81 -0
  907. package/src/ci-estate/page.ts +343 -0
  908. package/src/ci-estate/rows.ts +251 -0
  909. package/src/ci-estate.test.ts +281 -0
  910. package/src/ci-estate.ts +176 -0
  911. package/src/ci-handover.ts +67 -16
  912. package/src/ci-identity-database.test.ts +55 -0
  913. package/src/ci-identity-pulumi.test.ts +163 -0
  914. package/src/ci-identity-targets.test.ts +29 -2
  915. package/src/ci-identity.ts +134 -26
  916. package/src/ci-product-words.test.ts +101 -0
  917. package/src/ci-product-words.ts +536 -0
  918. package/src/ci-product.ts +174 -0
  919. package/src/ci-shared-reads.test.ts +145 -0
  920. package/src/cli/commands/audit.test.ts +1 -1
  921. package/src/cli/commands/audit.ts +3 -2
  922. package/src/cli/commands/carve.test.ts +1 -1
  923. package/src/cli/commands/carve.ts +2 -2
  924. package/src/cli/commands/import-index.test.ts +117 -0
  925. package/src/cli/commands/import-index.ts +265 -0
  926. package/src/cli/commands/init.ts +3 -1
  927. package/src/cli/commands/lint.ts +4 -2
  928. package/src/cli/component-wave-args.test.ts +16 -0
  929. package/src/cli/handlers/agent.ts +126 -0
  930. package/src/cli/handlers/approve-confirm.test.ts +276 -0
  931. package/src/cli/handlers/approve-confirm.ts +200 -0
  932. package/src/cli/handlers/approve.ts +18 -1
  933. package/src/cli/handlers/build.test.ts +7 -0
  934. package/src/cli/handlers/build.ts +44 -1
  935. package/src/cli/handlers/ci-check.ts +33 -0
  936. package/src/cli/handlers/ci-forge-check.ts +91 -0
  937. package/src/cli/handlers/components.test.ts +9 -0
  938. package/src/cli/handlers/components.ts +12 -2
  939. package/src/cli/handlers/fan-out.test.ts +10 -10
  940. package/src/cli/handlers/fan-out.ts +22 -3
  941. package/src/cli/handlers/gate-pending.ts +46 -0
  942. package/src/cli/handlers/graph.test.ts +42 -0
  943. package/src/cli/handlers/graph.ts +26 -4
  944. package/src/cli/handlers/index-cloud.ts +32 -0
  945. package/src/cli/handlers/index-diff.test.ts +68 -0
  946. package/src/cli/handlers/index-diff.ts +146 -0
  947. package/src/cli/handlers/init.ts +1 -0
  948. package/src/cli/handlers/ledger-root-member.test.ts +161 -0
  949. package/src/cli/handlers/ledger.ts +1 -1
  950. package/src/cli/handlers/lifecycle-drift.ts +73 -0
  951. package/src/cli/handlers/lifecycle.test.ts +33 -11
  952. package/src/cli/handlers/lifecycle.ts +205 -30
  953. package/src/cli/handlers/lock.test.ts +29 -2
  954. package/src/cli/handlers/lock.ts +66 -6
  955. package/src/cli/handlers/misc.ts +73 -0
  956. package/src/cli/handlers/notify-relay.ts +130 -0
  957. package/src/cli/handlers/pr-before-merge.test.ts +2 -1
  958. package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
  959. package/src/cli/handlers/pr-env.ts +48 -11
  960. package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
  961. package/src/cli/handlers/pr-waves-blocked.test.ts +42 -2
  962. package/src/cli/handlers/pr-waves.test.ts +8 -2
  963. package/src/cli/handlers/pr.test.ts +8 -8
  964. package/src/cli/handlers/pr.ts +669 -207
  965. package/src/cli/handlers/promote.test.ts +69 -5
  966. package/src/cli/handlers/promote.ts +103 -8
  967. package/src/cli/handlers/query.ts +27 -4
  968. package/src/cli/handlers/release.ts +2 -0
  969. package/src/cli/handlers/run-components-exit.test.ts +7 -7
  970. package/src/cli/handlers/run-declared-reads-cli.test.ts +187 -0
  971. package/src/cli/handlers/run-groups-cli.test.ts +229 -0
  972. package/src/cli/handlers/run-wave.ts +65 -1
  973. package/src/cli/handlers/run.test.ts +6 -4
  974. package/src/cli/handlers/run.ts +86 -1
  975. package/src/cli/handlers/scenario.test.ts +13 -0
  976. package/src/cli/handlers/scenario.ts +8 -7
  977. package/src/cli/handlers/search-index.test.ts +255 -0
  978. package/src/cli/handlers/search-json.test.ts +1 -1
  979. package/src/cli/handlers/search-ownership.test.ts +194 -0
  980. package/src/cli/handlers/search.ts +271 -38
  981. package/src/cli/handlers/serve.ts +10 -1
  982. package/src/cli/main.test.ts +7 -0
  983. package/src/cli/main.ts +182 -14
  984. package/src/cli/mcp/ledger-tools.ts +126 -0
  985. package/src/cli/mcp/lifecycle-tools.ts +3 -2
  986. package/src/cli/mcp/product-tools.test.ts +123 -0
  987. package/src/cli/mcp/product-tools.ts +129 -0
  988. package/src/cli/mcp/read-only.test.ts +134 -0
  989. package/src/cli/mcp/read-only.ts +68 -0
  990. package/src/cli/mcp/report-tools.ts +135 -0
  991. package/src/cli/mcp/resource-handlers.ts +4 -3
  992. package/src/cli/mcp/server.test.ts +5 -4
  993. package/src/cli/mcp/server.ts +90 -16
  994. package/src/cli/mcp/workspace-tools.ts +1 -1
  995. package/src/cli/mcp-config.ts +8 -3
  996. package/src/cli/parse-args.ts +82 -4
  997. package/src/cli/registry.ts +54 -1
  998. package/src/cloud-lister/aws.test.ts +202 -0
  999. package/src/cloud-lister/aws.ts +226 -0
  1000. package/src/cloud-lister/azure.test.ts +132 -0
  1001. package/src/cloud-lister/azure.ts +142 -0
  1002. package/src/cloud-lister/common.ts +115 -0
  1003. package/src/cloud-lister/credentials.ts +110 -0
  1004. package/src/cloud-lister/fakes.ts +66 -0
  1005. package/src/cloud-lister/gcp.test.ts +121 -0
  1006. package/src/cloud-lister/gcp.ts +159 -0
  1007. package/src/cloud-lister/guard.test.ts +198 -0
  1008. package/src/cloud-lister/guard.ts +111 -0
  1009. package/src/cloud-lister/ids.ts +54 -0
  1010. package/src/cloud-lister/index.ts +134 -0
  1011. package/src/cloud-lister/kubernetes.test.ts +160 -0
  1012. package/src/cloud-lister/kubernetes.ts +284 -0
  1013. package/src/cloud-lister/markers.ts +74 -0
  1014. package/src/cloud-lister/mask.ts +77 -0
  1015. package/src/cloud-lister/shape.test.ts +81 -0
  1016. package/src/cloud-lister/sigv4.ts +127 -0
  1017. package/src/cloud-lister/transport.ts +118 -0
  1018. package/src/cloud-lister/types.ts +135 -0
  1019. package/src/components/adoption.test.ts +140 -0
  1020. package/src/components/adoption.ts +141 -0
  1021. package/src/components/apply-lease.ts +49 -0
  1022. package/src/components/capability-plugin-loader.ts +4 -0
  1023. package/src/components/capability-plugin.ts +10 -0
  1024. package/src/components/capability.ts +359 -6
  1025. package/src/components/check-hooks.test.ts +66 -0
  1026. package/src/components/check-hooks.ts +252 -0
  1027. package/src/components/ci-services.test.ts +51 -0
  1028. package/src/components/ci-services.ts +83 -0
  1029. package/src/components/cli-support.ts +92 -15
  1030. package/src/components/declared-reads.test.ts +103 -0
  1031. package/src/components/declared-reads.ts +134 -0
  1032. package/src/components/deploy-units.ts +4 -0
  1033. package/src/components/driver.test.ts +3 -3
  1034. package/src/components/driver.ts +127 -9
  1035. package/src/components/fan-out-run.ts +163 -33
  1036. package/src/components/fan-out-support.ts +10 -1
  1037. package/src/components/fan-out.ts +30 -0
  1038. package/src/components/groups.test.ts +320 -0
  1039. package/src/components/groups.ts +895 -0
  1040. package/src/components/index.ts +42 -0
  1041. package/src/components/plan-shape-conformance.ts +130 -0
  1042. package/src/components/pr-comment-preview.test.ts +54 -0
  1043. package/src/components/pr-env-ledger.test.ts +9 -0
  1044. package/src/components/pr-env-ledger.ts +43 -0
  1045. package/src/components/pr-env-ports.ts +29 -4
  1046. package/src/components/pr-env-run-bundle.test.ts +10 -0
  1047. package/src/components/pr-env-run.test.ts +19 -0
  1048. package/src/components/pr-env-run.ts +12 -2
  1049. package/src/components/pr-environment.test.ts +29 -0
  1050. package/src/components/pr-environment.ts +39 -7
  1051. package/src/components/pr-pipeline.test.ts +15 -0
  1052. package/src/components/pr-pipeline.ts +274 -9
  1053. package/src/components/pr-policy.ts +45 -7
  1054. package/src/components/pr-run.test.ts +516 -3
  1055. package/src/components/pr-run.ts +350 -44
  1056. package/src/components/pr-targets.test.ts +35 -0
  1057. package/src/components/pr-targets.ts +45 -0
  1058. package/src/components/product-pipeline.test.ts +200 -0
  1059. package/src/components/product-pipeline.ts +341 -0
  1060. package/src/components/promote-rounds.ts +25 -2
  1061. package/src/components/promote.ts +64 -5
  1062. package/src/components/registry.test.ts +1 -1
  1063. package/src/components/release-compile.ts +87 -1
  1064. package/src/components/release-gate.ts +115 -30
  1065. package/src/components/release-groups.test.ts +362 -0
  1066. package/src/components/release-promote.ts +65 -1
  1067. package/src/components/repo-lock.ts +52 -0
  1068. package/src/components/row-lease.test.ts +490 -0
  1069. package/src/components/row-lease.ts +167 -0
  1070. package/src/components/run-groups.ts +113 -0
  1071. package/src/components/starter-plugin.ts +6 -0
  1072. package/src/components/verbs/index.ts +1 -0
  1073. package/src/components/verbs/member-outputs.test.ts +205 -0
  1074. package/src/components/verbs/member-outputs.ts +308 -0
  1075. package/src/components/wave-plan-policy.test.ts +19 -0
  1076. package/src/components/wave-plan.ts +78 -4
  1077. package/src/config.ts +44 -0
  1078. package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
  1079. package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
  1080. package/src/control/applied.test.ts +148 -0
  1081. package/src/control/applied.ts +191 -0
  1082. package/src/control/consumers.test.ts +129 -0
  1083. package/src/control/consumers.ts +192 -0
  1084. package/src/control/control.test.ts +302 -0
  1085. package/src/control/dispatch.ts +699 -0
  1086. package/src/control/edges.test.ts +112 -0
  1087. package/src/control/edges.ts +164 -0
  1088. package/src/control/note-checkout.test.ts +91 -0
  1089. package/src/control/reconcile.ts +250 -0
  1090. package/src/control/records.ts +395 -0
  1091. package/src/deep-observation.ts +5 -23
  1092. package/src/discovery/sandbox/bundle.ts +25 -1
  1093. package/src/drift-record.test.ts +596 -0
  1094. package/src/drift-record.ts +1206 -0
  1095. package/src/engine-facts.guard.test.ts +111 -0
  1096. package/src/engine-facts.test.ts +177 -0
  1097. package/src/engine-facts.ts +153 -0
  1098. package/src/exit-codes.test.ts +31 -0
  1099. package/src/exit-codes.ts +55 -0
  1100. package/src/forge-check/check.ts +155 -0
  1101. package/src/forge-check/contract.ts +215 -0
  1102. package/src/forge-check/forge-check.test.ts +427 -0
  1103. package/src/forge-check/forge.ts +318 -0
  1104. package/src/forge-check/index.ts +43 -0
  1105. package/src/forge-check/pulumi.ts +192 -0
  1106. package/src/forge-check/read-only.ts +56 -0
  1107. package/src/forge-check/trust.ts +527 -0
  1108. package/src/forge-check/types.ts +78 -0
  1109. package/src/forge-check.ts +5 -0
  1110. package/src/gate-decision-bundle.test.ts +13 -0
  1111. package/src/gate-decision.ts +3 -0
  1112. package/src/gate-policy.ts +92 -3
  1113. package/src/gated-waves-bundle.test.ts +1 -0
  1114. package/src/graph-ir-live.test.ts +92 -0
  1115. package/src/graph-ir.ts +317 -7
  1116. package/src/graph-refs.ts +416 -0
  1117. package/src/graph-schema/fixtures/adopt.json +15 -0
  1118. package/src/graph-schema/fixtures/choudoufu.engine-graph.json +169 -0
  1119. package/src/graph-schema/fixtures/index.json +68 -0
  1120. package/src/graph-schema/fixtures/plunge.engine-graph.json +158 -0
  1121. package/src/graph-schema/fixtures.ts +267 -0
  1122. package/src/graph-schema/generate.ts +263 -0
  1123. package/src/graph-schema/graph-schema.test.ts +153 -0
  1124. package/src/graph-schema/graph.schema.json +1387 -0
  1125. package/src/health.schema.json +2 -1
  1126. package/src/identity.ts +2 -0
  1127. package/src/index.ts +4 -0
  1128. package/src/instance-nodes.ts +288 -0
  1129. package/src/lexicon.ts +171 -6
  1130. package/src/lifecycle/__fixtures__/index-diff/20261026T120000Z-aaaaaaaaaaaa.json +149 -0
  1131. package/src/lifecycle/__fixtures__/index-diff/20261026T130000Z-bbbbbbbbbbbb.json +127 -0
  1132. package/src/lifecycle/adoption-file.test.ts +100 -0
  1133. package/src/lifecycle/adoption-file.ts +153 -0
  1134. package/src/lifecycle/cloud-index.test.ts +516 -0
  1135. package/src/lifecycle/cloud-index.ts +735 -0
  1136. package/src/lifecycle/control-entries-ledger.test.ts +70 -0
  1137. package/src/lifecycle/derive-edges.test.ts +193 -0
  1138. package/src/lifecycle/derive-edges.ts +182 -0
  1139. package/src/lifecycle/gate-applied.ts +6 -0
  1140. package/src/lifecycle/gate-ledger.ts +36 -1
  1141. package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
  1142. package/src/lifecycle/gate-pending-by-plan.ts +133 -0
  1143. package/src/lifecycle/gated-request-digest.ts +49 -0
  1144. package/src/lifecycle/gated-request-ledger.test.ts +53 -0
  1145. package/src/lifecycle/gated-request.ts +280 -0
  1146. package/src/lifecycle/git.ts +10 -4
  1147. package/src/lifecycle/identity-match.test.ts +308 -0
  1148. package/src/lifecycle/identity-match.ts +276 -0
  1149. package/src/lifecycle/index-diff.test.ts +198 -0
  1150. package/src/lifecycle/index-diff.ts +475 -0
  1151. package/src/lifecycle/index-document.test.ts +64 -0
  1152. package/src/lifecycle/index-document.ts +298 -0
  1153. package/src/lifecycle/index-drift.test.ts +191 -0
  1154. package/src/lifecycle/index-drift.ts +304 -0
  1155. package/src/lifecycle/index-import.test.ts +269 -0
  1156. package/src/lifecycle/index-import.ts +654 -0
  1157. package/src/lifecycle/index-join.test.ts +250 -0
  1158. package/src/lifecycle/index-join.ts +304 -0
  1159. package/src/lifecycle/index-store-load-bearing.test.ts +187 -0
  1160. package/src/lifecycle/index.ts +4 -0
  1161. package/src/lifecycle/ledger-read.ts +7 -3
  1162. package/src/lifecycle/lock-rows.test.ts +109 -0
  1163. package/src/lifecycle/lock-rows.ts +167 -0
  1164. package/src/lifecycle/member-ledger.test.ts +25 -7
  1165. package/src/lifecycle/observation-baseline.test.ts +72 -1
  1166. package/src/lifecycle/observation-baseline.ts +190 -27
  1167. package/src/lifecycle/observe.ts +6 -1
  1168. package/src/lifecycle/publish-target-context.test.ts +108 -0
  1169. package/src/lifecycle/query.test.ts +68 -1
  1170. package/src/lifecycle/query.ts +208 -13
  1171. package/src/lifecycle/release-catalog-site.test.ts +142 -0
  1172. package/src/lifecycle/release-catalog-site.ts +291 -0
  1173. package/src/lifecycle/release-catalog.test.ts +193 -0
  1174. package/src/lifecycle/release-catalog.ts +353 -0
  1175. package/src/lifecycle/release-changelog.test.ts +70 -0
  1176. package/src/lifecycle/release-changelog.ts +71 -0
  1177. package/src/lifecycle/release-cut.ts +2 -2
  1178. package/src/lifecycle/release-ledger.ts +20 -0
  1179. package/src/lifecycle/release-publish.ts +45 -22
  1180. package/src/lifecycle/release-read.ts +2 -0
  1181. package/src/lifecycle/release-status.test.ts +186 -0
  1182. package/src/lifecycle/release-status.ts +176 -0
  1183. package/src/lifecycle/replay.test.ts +9 -5
  1184. package/src/lifecycle/replay.ts +9 -5
  1185. package/src/lifecycle/resource-lock.test.ts +175 -0
  1186. package/src/lifecycle/resource-lock.ts +354 -0
  1187. package/src/lifecycle/retention.ts +2 -0
  1188. package/src/lifecycle/run-ledger.ts +7 -1
  1189. package/src/lifecycle/scenario.ts +4 -3
  1190. package/src/lifecycle/snapshot-store-fake.ts +29 -0
  1191. package/src/lifecycle/snapshot-store-s3.ts +280 -0
  1192. package/src/lifecycle/snapshot-store.test.ts +385 -0
  1193. package/src/lifecycle/snapshot-store.ts +980 -0
  1194. package/src/lifecycle/snapshot.test.ts +13 -0
  1195. package/src/lifecycle/snapshot.ts +23 -6
  1196. package/src/lifecycle/target-lock.ts +24 -9
  1197. package/src/lifecycle/type-listing.test.ts +166 -0
  1198. package/src/lifecycle/type-listing.ts +309 -0
  1199. package/src/lint/component-checks.ts +17 -1
  1200. package/src/lint/config.test.ts +3 -0
  1201. package/src/lint/presets/relaxed.json +2 -1
  1202. package/src/lint/presets/strict.json +2 -1
  1203. package/src/lint/rules/__fixtures__/comp/comp008/fail/dns.component.ts +15 -0
  1204. package/src/lint/rules/__fixtures__/comp/comp008/pass/dns.component.ts +10 -0
  1205. package/src/lint/rules/comp/comp.test.ts +2 -1
  1206. package/src/lint/rules/comp/comp008-applies-signal-only-root.ts +121 -0
  1207. package/src/lint/rules/comp/comp008.test.ts +77 -0
  1208. package/src/lint/rules/comp/index.ts +4 -1
  1209. package/src/mcp/types.ts +7 -0
  1210. package/src/notify-product.ts +76 -0
  1211. package/src/notify-relay.test.ts +213 -0
  1212. package/src/notify-relay.ts +407 -0
  1213. package/src/notify.ts +95 -14
  1214. package/src/object-store/azure-blob.ts +374 -0
  1215. package/src/object-store/common.ts +133 -0
  1216. package/src/object-store/errors.ts +26 -0
  1217. package/src/object-store/from-env.ts +36 -0
  1218. package/src/object-store/gcs.ts +436 -0
  1219. package/src/object-store/index.ts +8 -0
  1220. package/src/object-store/object-store.test.ts +130 -0
  1221. package/src/object-store/s3.ts +350 -0
  1222. package/src/observation-edges.test.ts +33 -0
  1223. package/src/observation.ts +36 -1
  1224. package/src/op/activities/activity-contracts.ts +1 -1
  1225. package/src/op/activities/change-set.ts +8 -5
  1226. package/src/op/activities/converge.ts +2 -1
  1227. package/src/op/activities/index.ts +1 -1
  1228. package/src/op/activities/review-agent.open.test.ts +78 -0
  1229. package/src/op/activities/review-agent.test.ts +13 -0
  1230. package/src/op/activities/review-agent.ts +89 -5
  1231. package/src/op/activity-failure.ts +36 -0
  1232. package/src/op/gate.ts +81 -22
  1233. package/src/op/generate-pipeline.ts +7 -1
  1234. package/src/op/index.ts +23 -1
  1235. package/src/op/local-executor.test.ts +80 -0
  1236. package/src/op/local-executor.ts +27 -9
  1237. package/src/op/op-waves-after-plan.test.ts +276 -0
  1238. package/src/op/op-waves-after-plan.ts +238 -0
  1239. package/src/op/op-waves-capability-spec.ts +113 -0
  1240. package/src/op/op-waves-capability.test.ts +217 -0
  1241. package/src/op/op-waves-capability.ts +370 -0
  1242. package/src/op/op-waves-events.ts +135 -0
  1243. package/src/op/op-waves-notify-words.test.ts +149 -0
  1244. package/src/op/op-waves-notify.ts +41 -16
  1245. package/src/op/op-waves-pull-request.test.ts +142 -0
  1246. package/src/op/op-waves-release-port.ts +64 -0
  1247. package/src/op/op-waves-release.test.ts +209 -0
  1248. package/src/op/op-waves-release.ts +133 -0
  1249. package/src/op/op-waves-run-record.test.ts +32 -0
  1250. package/src/op/op-waves-run.ts +1142 -49
  1251. package/src/op/op-waves-stand-down.test.ts +240 -0
  1252. package/src/op/op-waves-stand-down.ts +108 -0
  1253. package/src/op/op-waves-trace.test.ts +205 -0
  1254. package/src/op/op-waves.test.ts +112 -0
  1255. package/src/op/op-waves.ts +261 -20
  1256. package/src/op/runtime.ts +104 -0
  1257. package/src/op/stage-hooks-hold-record.test.ts +41 -0
  1258. package/src/op/stage-hooks.ts +91 -12
  1259. package/src/op/steward-beside.ts +2 -1
  1260. package/src/op/types.ts +3 -2
  1261. package/src/otlp-metrics.ts +96 -0
  1262. package/src/otlp.test.ts +243 -0
  1263. package/src/otlp.ts +544 -0
  1264. package/src/override-gate-bundle.test.ts +2 -0
  1265. package/src/override-gate.ts +4 -0
  1266. package/src/policy-packs.ts +230 -0
  1267. package/src/policy-source.test.ts +256 -0
  1268. package/src/policy-source.ts +112 -0
  1269. package/src/pr-forge.ts +123 -0
  1270. package/src/pr-loop-bundle.test.ts +9 -2
  1271. package/src/pr-loop-words.test.ts +155 -0
  1272. package/src/pr-loop.test.ts +43 -0
  1273. package/src/pr-loop.ts +478 -50
  1274. package/src/pr-post.ts +32 -1
  1275. package/src/pr-report-url.ts +62 -6
  1276. package/src/pr-requires.test.ts +37 -1
  1277. package/src/pr-requires.ts +16 -2
  1278. package/src/product-subpaths-plain-node.e2e.test.ts +211 -0
  1279. package/src/pulumi-urn.ts +151 -0
  1280. package/src/release-floors.ts +22 -0
  1281. package/src/run-event.ts +29 -1
  1282. package/src/sensitive-key.ts +34 -0
  1283. package/src/sorted-json.ts +17 -0
  1284. package/src/stage-hooks-bundle.test.ts +8 -0
  1285. package/src/terraform/credentials.test.ts +77 -0
  1286. package/src/terraform/credentials.ts +162 -0
  1287. package/src/utils.ts +2 -11
  1288. package/src/wave-loop-golden.test.ts +2 -1
  1289. package/src/wave-runtime.ts +2 -2
  1290. package/src/workspace/adoption-report.test.ts +61 -0
  1291. package/src/workspace/adoption-report.ts +103 -0
  1292. package/src/workspace/capabilities-contract.test.ts +4 -0
  1293. package/src/workspace/capabilities-contract.ts +9 -1
  1294. package/src/workspace/capabilities.schema.json +98 -0
  1295. package/src/workspace/change-set.schema.json +42 -3
  1296. package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
  1297. package/src/workspace/ci-cloud-identity.ts +31 -1
  1298. package/src/workspace/ci-lock-grain.test.ts +31 -0
  1299. package/src/workspace/ci-lock-grain.ts +30 -0
  1300. package/src/workspace/ci-report-url.test.ts +1 -1
  1301. package/src/workspace/ci-run.test.ts +1 -1
  1302. package/src/workspace/ci-run.ts +6 -3
  1303. package/src/workspace/compose-graph.test.ts +12 -0
  1304. package/src/workspace/compose-graph.ts +12 -1
  1305. package/src/workspace/conformance/conformance.e2e.test.ts +2 -1
  1306. package/src/workspace/conformance/index.ts +6 -1
  1307. package/src/workspace/declaration.schema.json +27 -3
  1308. package/src/workspace/declaration.test.ts +1 -1
  1309. package/src/workspace/declaration.ts +26 -10
  1310. package/src/workspace/drift-cli.test.ts +65 -0
  1311. package/src/workspace/drift-cli.ts +370 -0
  1312. package/src/workspace/drift.schema.json +672 -0
  1313. package/src/workspace/exit-cli.ts +2 -1
  1314. package/src/workspace/graph-cli.ts +5 -0
  1315. package/src/workspace/graph.schema.json +72 -0
  1316. package/src/workspace/import-fetch.ts +4 -2
  1317. package/src/workspace/import-init.ts +4 -2
  1318. package/src/workspace/init.test.ts +38 -1
  1319. package/src/workspace/init.ts +50 -8
  1320. package/src/workspace/intent-gaps.test.ts +18 -2
  1321. package/src/workspace/ledger.schema.json +7 -3
  1322. package/src/workspace/lineage-upgrade-cli.ts +2 -1
  1323. package/src/workspace/nested-graph.ts +1 -0
  1324. package/src/workspace/pr-report.schema.json +125 -5
  1325. package/src/workspace/promote-waves.test.ts +296 -0
  1326. package/src/workspace/promote-waves.ts +340 -0
  1327. package/src/workspace/promote.test.ts +158 -4
  1328. package/src/workspace/promote.ts +400 -58
  1329. package/src/workspace/reason-codes.test.ts +4 -1
  1330. package/src/workspace/reason-codes.ts +14 -0
  1331. package/src/workspace/records-cli.ts +3 -2
  1332. package/src/workspace/release-catalog.schema.json +277 -0
  1333. package/src/workspace/run-event.schema.json +18 -1
  1334. package/src/workspace/search-contract.ts +2 -0
  1335. package/src/workspace/search.schema.json +103 -5
  1336. package/src/workspace/work-cli.ts +8 -2
  1337. package/src/workspace/workspace-run.ts +2 -1
@@ -0,0 +1,699 @@
1
+ /**
2
+ * The control repo's dispatch (#4568), shared by terragucci and plywood.
3
+ *
4
+ * A member repo's pipeline, once its apply on the default branch succeeded,
5
+ * sends one dispatch to the control repo: a `repository_dispatch` on GitHub,
6
+ * a pipeline trigger on GitLab, a workflow dispatch on Forgejo. The control
7
+ * repo's own pipeline then runs that member's dependents with `chant
8
+ * workspace run --dependents-of <member> --op <op>`. The member holds a
9
+ * token for that one call and no other access to the control repo.
10
+ *
11
+ * Lifted from terragucci's `control-repo.ts` (INTENTIUS/terragucci
12
+ * 18f6431595, packages/terragucci/src/control-repo.ts). What changed on the
13
+ * way into chant:
14
+ *
15
+ * - The names a person sees come from the product's words (#4550): the
16
+ * dispatch's event type is `<product>-applied`, the pipeline file
17
+ * `<product>-dependents.yml`, the status `<product>/<control stage>`.
18
+ * The variables a job reads stay chant's (`CHANT_CONTROL_*`), as every
19
+ * job variable does under #4550.
20
+ * - The token never reaches a command line. The generated script feeds it
21
+ * to curl on stdin (`-H @-`, `--form token=<-`), where terragucci's put it
22
+ * in curl's argv. The step maps the product's secret into
23
+ * {@link CONTROL_TOKEN_ENV} and nothing else reads it; a plan job drops it
24
+ * with the forge tokens ({@link CONTROL_TOKEN_VARS}, ../ci-handover.ts).
25
+ * - The request is built once ({@link controlDispatchRequest}) and both the
26
+ * script and {@link dispatchControl}, the in-process sender a product's
27
+ * bin calls, send that request.
28
+ *
29
+ * This module imports types and the words alone, so a product bundle can
30
+ * carry it.
31
+ */
32
+
33
+ import type { ForgeFetch, ForgeKind } from "../pr-forge";
34
+ import { productStatusContext, resolveProductWords, type CiProductWords, type CiProductWordsInput } from "../ci-product-words";
35
+
36
+ /** A member or Op name as the control repo's workspace spells them. The dispatch carries both into a shell line and a JSON string. */
37
+ export const CONTROL_NAME = /^[A-Za-z0-9][A-Za-z0-9._/-]{0,127}$/;
38
+ /** A branch name the dispatch may carry into a URL and a shell line. */
39
+ export const CONTROL_REF = /^[A-Za-z0-9][A-Za-z0-9._/-]{0,127}$/;
40
+ /** A secret's name, as GitHub, Forgejo and GitLab allow it. */
41
+ export const CONTROL_SECRET_NAME = /^[A-Za-z_][A-Za-z0-9_]{0,127}$/;
42
+
43
+ /** The variable the dispatch step reads the dispatch token from. The step maps the product's secret into it. */
44
+ export const CONTROL_TOKEN_ENV = "CHANT_CONTROL_TOKEN";
45
+ /** The variable a job that reads the control repo (estate ownership) takes the read-only token from. Never the dispatch token. */
46
+ export const CONTROL_READ_TOKEN_ENV = "CHANT_CONTROL_READ_TOKEN";
47
+ /**
48
+ * The control repo's token variables. A job that runs a change's code starts
49
+ * without them, as it starts without the forge tokens: pass these as
50
+ * `extra` to `dropForgeTokens` (../ci-handover.ts), or unset them on GitLab,
51
+ * where a CI/CD variable reaches every job.
52
+ */
53
+ export const CONTROL_TOKEN_VARS = [CONTROL_TOKEN_ENV, CONTROL_READ_TOKEN_ENV] as const;
54
+
55
+ /** The secret a member's dispatch token is kept in when the product names none. */
56
+ export const CONTROL_TOKEN_SECRET = "CHANT_CONTROL_TOKEN";
57
+ /** The secret the read-only token is kept in when the product names none. */
58
+ export const CONTROL_READ_TOKEN_SECRET = "CHANT_CONTROL_READ_TOKEN";
59
+
60
+ /** The variables a GitLab trigger carries, and the environment of the control repo's step. */
61
+ export const CONTROL_MEMBER_VAR = "CHANT_CONTROL_MEMBER";
62
+ export const CONTROL_OP_VAR = "CHANT_CONTROL_OP";
63
+ export const CONTROL_SHA_VAR = "CHANT_CONTROL_SHA";
64
+
65
+ /** The variable the apply outcome travels in (#4617): the member's dispatch step reads it, a GitLab trigger sets it, the control repo's step reads it. */
66
+ export const CONTROL_OUTCOME_VAR = "CHANT_CONTROL_OUTCOME";
67
+
68
+ /**
69
+ * What a member's op waves did, as its dispatch says it (#4617, `applyOutcomeOf` in ./applied.ts):
70
+ * - `applied`: at least one run applied, and every other run applied or had nothing to apply.
71
+ * - `partial`: some runs applied, and others failed, were blocked, refused or wait.
72
+ * - `unchanged`: every run had nothing to apply.
73
+ * - `waiting`: nothing applied, and a wave waits for an approval.
74
+ * - `failed`: nothing applied, and a run failed, was refused or blocked, or no wave wrote an outcome.
75
+ */
76
+ export type ControlApplyOutcome = "applied" | "partial" | "unchanged" | "waiting" | "failed";
77
+ export const CONTROL_APPLY_OUTCOMES: readonly ControlApplyOutcome[] = ["applied", "partial", "unchanged", "waiting", "failed"];
78
+ /** The outcomes after which the control repo runs the member's dependents: something applied. A dispatch with no outcome (the pull request loop's, sent on green only) runs them too. */
79
+ export const CONTROL_RUNS_DEPENDENTS: readonly ControlApplyOutcome[] = ["applied", "partial"];
80
+
81
+ /** The branch a GitLab or Forgejo dispatch runs on when the settings name none. */
82
+ export const CONTROL_REF_DEFAULT = "main";
83
+
84
+ /** The `npx` line the control repo's job runs chant with: the chant its own package.json pins. */
85
+ export const CONTROL_CHANT_COMMAND = "npx --no-install chant";
86
+
87
+ /** Settings a product's config is wrong in; `problems` lists each one. */
88
+ export class ControlConfigError extends Error {
89
+ constructor(
90
+ message: string,
91
+ readonly problems: string[] = [message],
92
+ ) {
93
+ super(message);
94
+ this.name = "ControlConfigError";
95
+ }
96
+ }
97
+
98
+ /** A project key, `<host>/<owner>/<name>`, taken apart. `path` is `<owner>/<name>`, with every group on GitLab. */
99
+ export interface ProjectKey {
100
+ key: string;
101
+ host: string;
102
+ path: string;
103
+ owner: string;
104
+ name: string;
105
+ }
106
+
107
+ /** A project key taken apart. A scheme and a `.git` suffix are dropped. terragucci's `parseProjectKey` (config.ts:2445). */
108
+ export function parseProjectKey(key: string): ProjectKey {
109
+ const clean = key.replace(/^https?:\/\//, "").replace(/\.git$/, "").replace(/\/+$/, "");
110
+ const parts = clean.split("/");
111
+ if (parts.length < 3 || parts.some((p) => p === "")) {
112
+ throw new ControlConfigError(`project key "${key}" must be <host>/<owner>/<name>, such as github.com/acme/infra`);
113
+ }
114
+ const [host, ...rest] = parts;
115
+ return { key, host: host!, path: rest.join("/"), owner: rest.slice(0, -1).join("/"), name: rest[rest.length - 1]! };
116
+ }
117
+
118
+ /** The forge a host belongs to, when the host says so. terragucci's `forgeFromHost` (config.ts:2456). */
119
+ export function forgeFromHost(host: string): ForgeKind | undefined {
120
+ const h = host.toLowerCase().replace(/:\d+$/, "");
121
+ if (h === "github.com" || h.startsWith("github.")) return "github";
122
+ if (h === "gitlab.com" || h.startsWith("gitlab.") || h.includes(".gitlab.")) return "gitlab";
123
+ if (h === "codeberg.org" || h.startsWith("forgejo.") || h.startsWith("gitea.") || h.includes("forgejo")) return "forgejo";
124
+ return undefined;
125
+ }
126
+
127
+ /** The REST base of a forge at `host`. */
128
+ export function forgeApiBase(forge: ForgeKind, host: string): string {
129
+ const h = host.toLowerCase();
130
+ if (forge === "github") return h === "github.com" ? "https://api.github.com" : `https://${host}/api/v3`;
131
+ if (forge === "gitlab") return `https://${host}/api/v4`;
132
+ return `https://${host}/api/v1`;
133
+ }
134
+
135
+ /** The `control` settings a product reads from its config, in chant's spelling. */
136
+ export interface ControlSettingsInput {
137
+ /** The control repo, as a project key: `<host>/<owner>/<name>`. Its host says which forge's dispatch is sent. */
138
+ repo: string;
139
+ /** The control repo's forge, when its host does not say. */
140
+ forge?: ForgeKind;
141
+ /** The Op the control repo runs on the member's dependents (`chant workspace run --op`). */
142
+ op: string;
143
+ /** The member's name in the control repo's workspace. Default: the repo's name. */
144
+ member?: string;
145
+ /** The secret holding the dispatch token. Default {@link CONTROL_TOKEN_SECRET}. */
146
+ tokenSecret?: string;
147
+ /** The secret holding a read-only token for the control repo. Default {@link CONTROL_READ_TOKEN_SECRET}. Never the dispatch token's. */
148
+ readTokenSecret?: string;
149
+ /** The branch a GitLab or Forgejo dispatch runs on. Default {@link CONTROL_REF_DEFAULT}. */
150
+ ref?: string;
151
+ /** The REST base, when the host's usual one is not it (a loopback forge in a test). */
152
+ apiBase?: string;
153
+ }
154
+
155
+ /** The control settings with the defaults filled in and the forge settled. */
156
+ export interface ControlTarget {
157
+ repo: string;
158
+ host: string;
159
+ path: string;
160
+ forge: ForgeKind;
161
+ apiBase: string;
162
+ op: string;
163
+ member: string;
164
+ ref: string;
165
+ tokenSecret: string;
166
+ readTokenSecret: string;
167
+ }
168
+
169
+ const FORGES: readonly ForgeKind[] = ["github", "gitlab", "forgejo"];
170
+
171
+ /** The problems with `control`, each naming its key under `where`. terragucci's `controlProblems` (config.ts:494). */
172
+ export function controlSettingsProblems(input: unknown, where = "control"): string[] {
173
+ if (typeof input !== "object" || input === null || Array.isArray(input)) return [`${where} must be a mapping with repo and op`];
174
+ const v = input as Record<string, unknown>;
175
+ const out: string[] = [];
176
+ let host: string | undefined;
177
+ if (typeof v.repo !== "string") out.push(`${where}.repo must name the control repo, such as github.com/acme/control`);
178
+ else {
179
+ try {
180
+ host = parseProjectKey(v.repo).host;
181
+ } catch (e) {
182
+ out.push(`${where}.repo: ${(e as Error).message}`);
183
+ }
184
+ }
185
+ if (!(typeof v.op === "string" && CONTROL_NAME.test(v.op))) out.push(`${where}.op must name the Op the control repo runs on this repo's dependents, such as deploy`);
186
+ if (v.forge !== undefined && !FORGES.includes(v.forge as ForgeKind)) out.push(`${where}.forge must be one of ${FORGES.join(", ")}`);
187
+ if (host !== undefined && v.forge === undefined && !forgeFromHost(host)) out.push(`${where}.forge is needed: ${v.repo}'s host does not say which forge it is`);
188
+ if (v.member !== undefined && !(typeof v.member === "string" && CONTROL_NAME.test(v.member))) out.push(`${where}.member must be this repo's name in the control repo's workspace`);
189
+ if (v.tokenSecret !== undefined && !(typeof v.tokenSecret === "string" && CONTROL_SECRET_NAME.test(v.tokenSecret))) out.push(`${where}.tokenSecret must name the secret holding the dispatch token, such as ${CONTROL_TOKEN_SECRET}`);
190
+ if (v.readTokenSecret !== undefined && !(typeof v.readTokenSecret === "string" && CONTROL_SECRET_NAME.test(v.readTokenSecret))) out.push(`${where}.readTokenSecret must name the secret holding a read-only token for the control repo, such as ${CONTROL_READ_TOKEN_SECRET}`);
191
+ else if (typeof v.readTokenSecret === "string" && v.readTokenSecret === ((v.tokenSecret as string | undefined) ?? CONTROL_TOKEN_SECRET)) {
192
+ out.push(`${where}.readTokenSecret must not be the dispatch token's secret (${v.readTokenSecret}): the plan job runs the change's code`);
193
+ }
194
+ if (v.ref !== undefined && !(typeof v.ref === "string" && CONTROL_REF.test(v.ref))) out.push(`${where}.ref must be a branch name`);
195
+ if (v.apiBase !== undefined && !(typeof v.apiBase === "string" && /^https?:\/\/[^\s'"]+$/.test(v.apiBase))) out.push(`${where}.apiBase must be an http(s) URL`);
196
+ return out;
197
+ }
198
+
199
+ /** `control` with its defaults filled in. `fallbackMember` is the repo's name, used when `control.member` is unset. */
200
+ export function resolveControlTarget(input: ControlSettingsInput, fallbackMember: string): ControlTarget {
201
+ const problems = controlSettingsProblems(input);
202
+ if (problems.length > 0) throw new ControlConfigError(problems.join("; "), problems);
203
+ const pk = parseProjectKey(input.repo);
204
+ const forge = input.forge ?? forgeFromHost(pk.host)!;
205
+ const member = input.member ?? fallbackMember;
206
+ if (!CONTROL_NAME.test(member)) throw new ControlConfigError(`control.member: "${member}" is not a name the control repo's workspace can hold; set control.member`);
207
+ return {
208
+ repo: input.repo,
209
+ host: pk.host,
210
+ path: pk.path,
211
+ forge,
212
+ apiBase: (input.apiBase ?? forgeApiBase(forge, pk.host)).replace(/\/+$/, ""),
213
+ op: input.op,
214
+ member,
215
+ ref: input.ref ?? CONTROL_REF_DEFAULT,
216
+ tokenSecret: input.tokenSecret ?? CONTROL_TOKEN_SECRET,
217
+ readTokenSecret: input.readTokenSecret ?? CONTROL_READ_TOKEN_SECRET,
218
+ };
219
+ }
220
+
221
+ /** The event type of the GitHub `repository_dispatch` a member sends: `<product>-applied`. */
222
+ export function controlDispatchEvent(wordsIn: CiProductWordsInput | CiProductWords = {}): string {
223
+ return `${resolveProductWords(wordsIn).product}-applied`;
224
+ }
225
+
226
+ /** The control repo's pipeline file name: `<product>-dependents.yml`. */
227
+ export function controlPipelineFileName(wordsIn: CiProductWordsInput | CiProductWords = {}): string {
228
+ return `${resolveProductWords(wordsIn).product}-dependents.yml`;
229
+ }
230
+
231
+ /** Where the control repo's pipeline file goes, beside the repo's own, on each forge. */
232
+ export function controlPipelinePath(forge: ForgeKind, wordsIn: CiProductWordsInput | CiProductWords = {}): string {
233
+ const file = controlPipelineFileName(wordsIn);
234
+ return forge === "github" ? `.github/workflows/${file}` : forge === "forgejo" ? `.forgejo/workflows/${file}` : `.gitlab/${file}`;
235
+ }
236
+
237
+ /** The commit status that marks a commit whose apply the control repo was told about: `<product>/<control stage>`. */
238
+ export function controlStatusContext(wordsIn: CiProductWordsInput | CiProductWords = {}): string {
239
+ return productStatusContext(resolveProductWords(wordsIn), "control");
240
+ }
241
+
242
+ /** What one dispatch tells the control repo. */
243
+ export interface ControlDispatch {
244
+ member: string;
245
+ op: string;
246
+ /** The commit that applied, 7 to 64 lower-case hex digits. */
247
+ sha: string;
248
+ /** What the member's op waves did (#4617). Absent from the pull request loop's dispatch, which is sent on green only. */
249
+ outcome?: ControlApplyOutcome;
250
+ }
251
+
252
+ /** Where the token goes in a {@link ControlDispatchRequest}. */
253
+ export type ControlTokenPlace = { in: "header"; name: string; scheme: string } | { in: "form"; field: string };
254
+
255
+ /** One dispatch request, without its token. */
256
+ export interface ControlDispatchRequest {
257
+ url: string;
258
+ method: "POST";
259
+ /** Headers other than the token's. */
260
+ headers: Record<string, string>;
261
+ /** A JSON document on GitHub and Forgejo; on GitLab the form fields other than the token, in order. */
262
+ body: { json: Record<string, unknown> } | { form: Array<[string, string]> };
263
+ token: ControlTokenPlace;
264
+ }
265
+
266
+ const SHA = /^[0-9a-f]{7,64}$/;
267
+
268
+ function checkDispatch(d: ControlDispatch): void {
269
+ if (!CONTROL_NAME.test(d.member)) throw new ControlConfigError(`the dispatch's member "${d.member}" is not a name the control repo's workspace can hold`);
270
+ if (!CONTROL_NAME.test(d.op)) throw new ControlConfigError(`the dispatch's op "${d.op}" is not an Op name`);
271
+ if (!SHA.test(d.sha)) throw new ControlConfigError(`the dispatch names no commit sha ("${d.sha}")`);
272
+ if (d.outcome !== undefined && !CONTROL_APPLY_OUTCOMES.includes(d.outcome)) throw new ControlConfigError(`the dispatch's outcome "${d.outcome}" is not one of ${CONTROL_APPLY_OUTCOMES.join(", ")}`);
273
+ }
274
+
275
+ /**
276
+ * The request that tells the control repo `d.member` applied: GitHub's
277
+ * `POST /repos/<path>/dispatches`, GitLab's `POST
278
+ * /projects/<id>/trigger/pipeline`, Forgejo's `POST
279
+ * /repos/<path>/actions/workflows/<file>/dispatches`.
280
+ */
281
+ export function controlDispatchRequest(target: ControlTarget, d: ControlDispatch, wordsIn: CiProductWordsInput | CiProductWords = {}): ControlDispatchRequest {
282
+ checkDispatch(d);
283
+ if (!CONTROL_REF.test(target.ref)) throw new ControlConfigError(`control.ref "${target.ref}" is not a branch name`);
284
+ if (target.forge === "github") {
285
+ return {
286
+ url: `${target.apiBase}/repos/${target.path}/dispatches`,
287
+ method: "POST",
288
+ headers: { Accept: "application/vnd.github+json", "Content-Type": "application/json" },
289
+ body: { json: { event_type: controlDispatchEvent(wordsIn), client_payload: { member: d.member, op: d.op, sha: d.sha, ...(d.outcome ? { outcome: d.outcome } : {}) } } },
290
+ token: { in: "header", name: "Authorization", scheme: "Bearer" },
291
+ };
292
+ }
293
+ if (target.forge === "gitlab") {
294
+ return {
295
+ url: `${target.apiBase}/projects/${encodeURIComponent(target.path)}/trigger/pipeline`,
296
+ method: "POST",
297
+ headers: {},
298
+ body: {
299
+ form: [
300
+ ["ref", target.ref],
301
+ [`variables[${CONTROL_MEMBER_VAR}]`, d.member],
302
+ [`variables[${CONTROL_OP_VAR}]`, d.op],
303
+ [`variables[${CONTROL_SHA_VAR}]`, d.sha],
304
+ ...(d.outcome ? ([[`variables[${CONTROL_OUTCOME_VAR}]`, d.outcome]] as Array<[string, string]>) : []),
305
+ ],
306
+ },
307
+ token: { in: "form", field: "token" },
308
+ };
309
+ }
310
+ return {
311
+ url: `${target.apiBase}/repos/${target.path}/actions/workflows/${controlPipelineFileName(wordsIn)}/dispatches`,
312
+ method: "POST",
313
+ headers: { Accept: "application/json", "Content-Type": "application/json" },
314
+ body: { json: { ref: target.ref, inputs: { member: d.member, op: d.op, sha: d.sha, ...(d.outcome ? { outcome: d.outcome } : {}) } } },
315
+ token: { in: "header", name: "Authorization", scheme: "token" },
316
+ };
317
+ }
318
+
319
+ /** A dispatch the control repo's forge did not take. */
320
+ export class ControlDispatchError extends Error {
321
+ constructor(
322
+ message: string,
323
+ readonly status: number | undefined,
324
+ ) {
325
+ super(message);
326
+ this.name = "ControlDispatchError";
327
+ }
328
+ }
329
+
330
+ /** What {@link dispatchControl} takes. */
331
+ export interface DispatchControlOptions {
332
+ /** The dispatch token. Default: {@link CONTROL_TOKEN_ENV} in `env`. */
333
+ token?: string;
334
+ env?: Record<string, string | undefined>;
335
+ fetch?: ForgeFetch;
336
+ words?: CiProductWordsInput | CiProductWords;
337
+ }
338
+
339
+ /**
340
+ * Sends one dispatch in process, for a product's bin that tells the control
341
+ * repo from its own command (terragucci's comment apply). A status other
342
+ * than 2xx throws {@link ControlDispatchError} with the status and the
343
+ * forge's answer, the token cut out of it.
344
+ */
345
+ export async function dispatchControl(target: ControlTarget, d: ControlDispatch, opts: DispatchControlOptions = {}): Promise<{ status: number }> {
346
+ const token = opts.token ?? (opts.env ?? process.env)[CONTROL_TOKEN_ENV];
347
+ if (!token) throw new ControlDispatchError(`${CONTROL_TOKEN_ENV} is not set, so ${target.repo} was not told that ${d.member} applied`, undefined);
348
+ const req = controlDispatchRequest(target, d, opts.words);
349
+ const headers = { ...req.headers };
350
+ let body: string;
351
+ if ("json" in req.body) body = JSON.stringify(req.body.json);
352
+ else {
353
+ const form = new URLSearchParams();
354
+ if (req.token.in === "form") form.append(req.token.field, token);
355
+ for (const [k, v] of req.body.form) form.append(k, v);
356
+ body = form.toString();
357
+ headers["Content-Type"] = "application/x-www-form-urlencoded";
358
+ }
359
+ if (req.token.in === "header") headers[req.token.name] = `${req.token.scheme} ${token}`;
360
+ const fetchImpl = opts.fetch ?? (globalThis.fetch as unknown as ForgeFetch);
361
+ let res: Awaited<ReturnType<ForgeFetch>>;
362
+ try {
363
+ res = await fetchImpl(req.url, { method: req.method, headers, body });
364
+ } catch (e) {
365
+ throw new ControlDispatchError(`the dispatch to ${target.repo} could not be sent: ${String((e as Error).message ?? e).split(token).join("***")}`, undefined);
366
+ }
367
+ if (res.status < 200 || res.status > 299) {
368
+ const answer = (await res.text().catch(() => "")).slice(0, 400).split(token).join("***");
369
+ throw new ControlDispatchError(`${target.repo} refused the dispatch (HTTP ${res.status}): ${answer}`, res.status);
370
+ }
371
+ return { status: res.status };
372
+ }
373
+
374
+ /** A value that passed {@link CONTROL_NAME} or {@link CONTROL_REF} is safe in a single-quoted shell word. */
375
+ function sq(v: string, re: RegExp): string {
376
+ if (!re.test(v)) throw new ControlConfigError(`not a safe name: ${v}`);
377
+ return `'${v}'`;
378
+ }
379
+
380
+ /** A URL from the target, checked to hold nothing a single-quoted shell word can't. */
381
+ function sqUrl(url: string): string {
382
+ if (!/^https?:\/\/[A-Za-z0-9._~:/?#\[\]@!$&()*+,;=%-]+$/.test(url) || url.includes("'")) throw new ControlConfigError(`not a safe URL: ${url}`);
383
+ return `'${url}'`;
384
+ }
385
+
386
+ /** What {@link controlDispatchScript} takes besides the target. */
387
+ export interface ControlDispatchScriptOptions {
388
+ words?: CiProductWordsInput | CiProductWords;
389
+ /**
390
+ * A shell line that prints 1 when the commit was told about already, such
391
+ * as terragucci's `terragucci post sent <status>`. Several paths can
392
+ * complete an apply of one commit; the first to tell the control repo
393
+ * marks it with {@link markSent}, and the others find the mark.
394
+ */
395
+ sentCheck?: string;
396
+ /** A shell line run once the control repo took the dispatch, such as setting {@link controlStatusContext}. */
397
+ markSent?: string;
398
+ /**
399
+ * Carry the apply outcome (#4617): the step reads it from
400
+ * {@link CONTROL_OUTCOME_VAR}, which an op waves pipeline's control job
401
+ * sets from the wave jobs' outcome files, refuses one that is not in
402
+ * {@link CONTROL_APPLY_OUTCOMES}, and sends it with the member, the Op
403
+ * and the commit. The dispatch goes whatever the outcome: the control
404
+ * repo records it and runs the dependents only when something applied.
405
+ */
406
+ outcome?: boolean;
407
+ }
408
+
409
+ /**
410
+ * The member's step: one request to the control repo's forge with the
411
+ * member's name, the Op and the commit that applied, read from
412
+ * `$CHANT_CONTROL_SHA`. The token is read from {@link CONTROL_TOKEN_ENV} and
413
+ * reaches curl on its stdin, never its argv or the log. A status other than
414
+ * 2xx fails the step with the status and the forge's answer.
415
+ */
416
+ export function controlDispatchScript(target: ControlTarget, opts: ControlDispatchScriptOptions = {}): string {
417
+ const words = resolveProductWords(opts.words ?? {});
418
+ const label = words.product;
419
+ const req = controlDispatchRequest(target, { member: target.member, op: target.op, sha: "0000000" }, words);
420
+ const tok = CONTROL_TOKEN_ENV;
421
+ const lines = [
422
+ "set -u",
423
+ `member=${sq(target.member, CONTROL_NAME)}`,
424
+ `op=${sq(target.op, CONTROL_NAME)}`,
425
+ // The sha may come from another job's output: it is data, and only a commit sha goes into the request.
426
+ `sha="\${${CONTROL_SHA_VAR}:-}"`,
427
+ `case "$sha" in ""|*[!0-9a-f]*) echo "${label}: the dispatch names no commit sha, so ${target.repo} was not told" >&2; exit 1 ;; esac`,
428
+ ...(opts.outcome
429
+ ? [
430
+ `outcome="\${${CONTROL_OUTCOME_VAR}:-}"`,
431
+ `case "$outcome" in ${CONTROL_APPLY_OUTCOMES.join("|")}) ;; *) echo "${label}: the waves' outcome (\\"$outcome\\") is not one of ${CONTROL_APPLY_OUTCOMES.join(", ")}, so ${target.repo} was not told" >&2; exit 1 ;; esac`,
432
+ ]
433
+ : []),
434
+ `[ -n "\${${tok}:-}" ] || { echo "${label}: ${tok} is empty; map the ${target.tokenSecret} secret into it, so ${target.repo} can be told" >&2; exit 1; }`,
435
+ ...(opts.sentCheck ? [`if [ "$(${opts.sentCheck} 2>/dev/null)" = 1 ]; then echo "${label}: ${target.repo} was told about \${sha:0:8} already"; exit 0; fi`] : []),
436
+ 'answer="$(mktemp)"',
437
+ ];
438
+ let send: string;
439
+ if ("json" in req.body) {
440
+ const carried = opts.outcome ? `,"outcome":"'"$outcome"'"` : "";
441
+ const json =
442
+ target.forge === "github"
443
+ ? `{"event_type":"${controlDispatchEvent(words)}","client_payload":{"member":"'"$member"'","op":"'"$op"'","sha":"'"$sha"'"${carried}}}`
444
+ : `{"ref":"${target.ref}","inputs":{"member":"'"$member"'","op":"'"$op"'","sha":"'"$sha"'"${carried}}}`;
445
+ const auth = req.token.in === "header" ? `${req.token.name}: ${req.token.scheme} %s\\n` : "";
446
+ const headers = Object.entries(req.headers).map(([k, v]) => `-H '${k}: ${v}'`);
447
+ send = `code="$(printf '${auth}' "$${tok}" | curl -sS -o "$answer" -w '%{http_code}' -X POST -H @- ${headers.join(" ")} -d '${json}' ${sqUrl(req.url)})"`;
448
+ } else {
449
+ // The same fields controlDispatchRequest lists, with the shell's values in place of the placeholders.
450
+ const fields = [
451
+ `--form ${sq(`ref=${target.ref}`, /^ref=[A-Za-z0-9._/-]+$/)}`,
452
+ `--form "variables[${CONTROL_MEMBER_VAR}]=$member"`,
453
+ `--form "variables[${CONTROL_OP_VAR}]=$op"`,
454
+ `--form "variables[${CONTROL_SHA_VAR}]=$sha"`,
455
+ ...(opts.outcome ? [`--form "variables[${CONTROL_OUTCOME_VAR}]=$outcome"`] : []),
456
+ ];
457
+ send = `code="$(printf '%s' "$${tok}" | curl -sS -o "$answer" -w '%{http_code}' -X POST --form 'token=<-' ${fields.join(" ")} ${sqUrl(req.url)})"`;
458
+ }
459
+ const mark = opts.markSent ? `; ${opts.markSent}` : "";
460
+ return [
461
+ ...lines,
462
+ `${send} || { echo "${label}: the dispatch to ${target.repo} could not be sent" >&2; exit 1; }`,
463
+ `case "$code" in 2??) echo "${label}: told ${target.repo} that $member ${opts.outcome ? "ran its waves ($outcome)" : "applied"} (HTTP $code)"${mark} ;; *) echo "${label}: ${target.repo} refused the dispatch (HTTP $code): $(head -c 400 "$answer")" >&2; exit 1 ;; esac`,
464
+ ].join("\n");
465
+ }
466
+
467
+ /**
468
+ * The script line that records a dispatch carrying an outcome (#4617):
469
+ * `recordControlAppliedFromEnv` from the control repo's own install of
470
+ * `@intentius/chant/ci-control`, which appends to `_control/applied.jsonl`
471
+ * and pushes `chant/lifecycle`. An install without it says so and records
472
+ * nothing; a failed record or push is a warning, never the job's failure.
473
+ */
474
+ function recordAppliedLine(label: string): string {
475
+ const js = [
476
+ 'const m = await import("@intentius/chant/ci-control");',
477
+ `if (typeof m.recordControlAppliedFromEnv !== "function") { console.error("${label}: this chant does not record applies; pin a newer @intentius/chant to keep them"); process.exit(0); }`,
478
+ "const r = await m.recordControlAppliedFromEnv();",
479
+ `if (r.skipped) console.error("${label}: no apply recorded: " + r.skipped); else console.error("${label}: recorded " + r.recorded.member + " " + r.recorded.outcome + " at " + r.recorded.sha.slice(0, 12));`,
480
+ `if (r.pushWarning) console.error("${label}: " + r.pushWarning);`,
481
+ ].join(" ");
482
+ return `[ -z "$outcome" ] || node --input-type=module -e '${js}' || echo "${label}: the apply of $member was not recorded" >&2`;
483
+ }
484
+
485
+ /**
486
+ * The control repo's step: runs the member's dependents. The member, the Op
487
+ * and the outcome arrive in the environment (a dispatch's payload is data,
488
+ * never part of the script) and are checked against {@link CONTROL_NAME}
489
+ * and {@link CONTROL_APPLY_OUTCOMES} before they reach a command line. A
490
+ * dispatch that carries an outcome is recorded first (#4617), and its
491
+ * dependents run only when something applied ({@link CONTROL_RUNS_DEPENDENTS}).
492
+ */
493
+ export function controlDependentsScript(opts: { command?: string; label?: string } = {}): string {
494
+ const label = opts.label ?? "chant";
495
+ const chant = opts.command ?? CONTROL_CHANT_COMMAND;
496
+ return [
497
+ "set -eu",
498
+ `member="\${${CONTROL_MEMBER_VAR}:-}"`,
499
+ `op="\${${CONTROL_OP_VAR}:-}"`,
500
+ `outcome="\${${CONTROL_OUTCOME_VAR}:-}"`,
501
+ `re='${CONTROL_NAME.source}'`,
502
+ `[[ $member =~ $re && $op =~ $re ]] || { echo "${label}: the dispatch names no usable member and Op (member=\\"$member\\", op=\\"$op\\")" >&2; exit 2; }`,
503
+ `case "$outcome" in ""|${CONTROL_APPLY_OUTCOMES.join("|")}) ;; *) echo "${label}: the dispatch's outcome (\\"$outcome\\") is not one of ${CONTROL_APPLY_OUTCOMES.join(", ")}" >&2; exit 2 ;; esac`,
504
+ "npm ci",
505
+ recordAppliedLine(label),
506
+ `case "$outcome" in ""|${CONTROL_RUNS_DEPENDENTS.join("|")}) ;; *) echo "${label}: $member's waves ended $outcome and applied nothing, so its dependents do not run"; exit 0 ;; esac`,
507
+ `${chant} workspace run --dependents-of "$member" --op "$op" --json`,
508
+ ].join("\n");
509
+ }
510
+
511
+ /** The control repo's pipeline, forge-neutral: what a forge lexicon serializes (`generateControlPipeline`). */
512
+ export interface ControlPipelineSpec {
513
+ forge: ForgeKind;
514
+ /** Where the file goes in the control repo. */
515
+ path: string;
516
+ /** The file's opening comment lines, `#` included. */
517
+ header: string[];
518
+ /** GitHub: the `repository_dispatch` event type. */
519
+ event: string;
520
+ /** The manual dispatch's inputs (GitHub, Forgejo): member, op, sha. */
521
+ inputs: Record<string, { description: string; required: boolean; type: "string" }>;
522
+ /** The step's environment: each variable as the forge spells its source. */
523
+ env: Record<string, string>;
524
+ /** The step's script ({@link controlDependentsScript}). */
525
+ script: string;
526
+ /** One run per member at a time, none cancelled (GitHub, Forgejo `concurrency`; GitLab `resource_group`). */
527
+ group: string;
528
+ /** GitLab: the job's rule. */
529
+ rule: string;
530
+ /** What a person still sets up on the forge. */
531
+ notes: string[];
532
+ }
533
+
534
+ /** The first chant with `chant workspace run --dependents-of`, which the control repo's package.json pins. terragucci's `CONTROL_CHANT_FLOOR`. */
535
+ export const CONTROL_DEPENDENTS_FLOOR = "0.124.47";
536
+
537
+ /** The control repo's pipeline for `forge`, in the product's words. */
538
+ export function controlPipelineSpec(forge: ForgeKind, wordsIn: CiProductWordsInput | CiProductWords = {}, opts: { command?: string } = {}): ControlPipelineSpec {
539
+ const words = resolveProductWords(wordsIn);
540
+ const product = words.product;
541
+ const gitlab = forge === "gitlab";
542
+ const member = gitlab ? `$${CONTROL_MEMBER_VAR}` : "${{ github.event.client_payload.member || inputs.member }}";
543
+ const op = gitlab ? `$${CONTROL_OP_VAR}` : "${{ github.event.client_payload.op || inputs.op }}";
544
+ const sha = gitlab ? `$${CONTROL_SHA_VAR}` : "${{ github.event.client_payload.sha || inputs.sha }}";
545
+ const outcome = "${{ github.event.client_payload.outcome || inputs.outcome }}";
546
+ const bin = words.bin ?? product;
547
+ const notes = [
548
+ `the repo's package.json must pin @intentius/chant at ${CONTROL_DEPENDENTS_FLOOR} or later, which has \`chant workspace run --dependents-of\``,
549
+ ...(gitlab
550
+ ? [`add \`- local: ${controlPipelinePath(forge, words)}\` to the include list of .gitlab-ci.yml, and create a pipeline trigger token under Settings > CI/CD > Pipeline trigger tokens for each member's ${CONTROL_TOKEN_SECRET} variable`]
551
+ : forge === "github"
552
+ ? [`give each member a ${CONTROL_TOKEN_SECRET} secret: a token that may send a repository_dispatch to this repo and do nothing else`]
553
+ : [`give each member a ${CONTROL_TOKEN_SECRET} secret: a token that may dispatch workflows in this repo and do nothing else`]),
554
+ gitlab
555
+ ? "a dispatch that carries an outcome is recorded on chant/lifecycle; the job pushes it with its own token, so let the CI job token push to this repo or the record stays in the job"
556
+ : "a dispatch that carries an outcome is recorded on chant/lifecycle, which the job pushes with its own token (contents: write)",
557
+ ];
558
+ return {
559
+ forge,
560
+ path: controlPipelinePath(forge, words),
561
+ header: [
562
+ `# A member repo's pipeline sends a dispatch here after its apply succeeds; this`,
563
+ "# runs that member's dependents with `chant workspace run --dependents-of`.",
564
+ `# Run \`${bin} control init\` to rewrite it rather than editing it here.`,
565
+ ],
566
+ event: controlDispatchEvent(words),
567
+ inputs: {
568
+ member: { description: "The member whose dependents run", required: true, type: "string" },
569
+ op: { description: "The Op to run on them", required: true, type: "string" },
570
+ sha: { description: "The member's commit that applied", required: false, type: "string" },
571
+ outcome: { description: `What the member's waves did: ${CONTROL_APPLY_OUTCOMES.join(", ")}`, required: false, type: "string" },
572
+ },
573
+ env: gitlab ? {} : { [CONTROL_MEMBER_VAR]: member, [CONTROL_OP_VAR]: op, [CONTROL_SHA_VAR]: sha, [CONTROL_OUTCOME_VAR]: outcome },
574
+ script: controlDependentsScript({ label: product, ...(opts.command ? { command: opts.command } : {}) }),
575
+ group: `${product}-dependents-${member}`,
576
+ rule: `$CI_PIPELINE_SOURCE == "trigger" && $${CONTROL_MEMBER_VAR} && $${CONTROL_OP_VAR}`,
577
+ notes,
578
+ };
579
+ }
580
+
581
+ /** The dispatch job a member's pipeline adds after its last apply on the default branch, forge-neutral. */
582
+ export interface ControlDispatchJobSpec {
583
+ /** The job's name. */
584
+ name: string;
585
+ /** The step's name. */
586
+ stepName: string;
587
+ /**
588
+ * The step's environment: {@link CONTROL_TOKEN_ENV} from the product's
589
+ * secret (GitHub, Forgejo; on GitLab the CI/CD variable of that name is
590
+ * mapped in the script's first line), and {@link CONTROL_SHA_VAR} from
591
+ * the commit expression the generator passes.
592
+ */
593
+ env: Record<string, string>;
594
+ /** The step's script ({@link controlDispatchScript}). */
595
+ script: string;
596
+ /** The control status context, for a product that marks the commit. */
597
+ context: string;
598
+ }
599
+
600
+ /** The control dispatch job's name in a member's pipeline. */
601
+ export const CONTROL_DISPATCH_JOB = "control-dispatch";
602
+
603
+ /**
604
+ * The member's dispatch job for a pipeline on `memberForge`. `sha` is the
605
+ * expression the job reads the applied commit from, as the forge spells it:
606
+ * a wave job's `green-sha` output, `${{ github.sha }}`, `$CI_COMMIT_SHA`.
607
+ */
608
+ export function controlDispatchJob(memberForge: ForgeKind, target: ControlTarget, sha: string, opts: ControlDispatchScriptOptions = {}): ControlDispatchJobSpec {
609
+ const words = resolveProductWords(opts.words ?? {});
610
+ const gitlab = memberForge === "gitlab";
611
+ if (!CONTROL_SECRET_NAME.test(target.tokenSecret)) throw new ControlConfigError(`control.tokenSecret "${target.tokenSecret}" is not a secret's name`);
612
+ const script = controlDispatchScript(target, { ...opts, words });
613
+ return {
614
+ name: CONTROL_DISPATCH_JOB,
615
+ stepName: `Tell the control repo ${target.repo} that ${target.member} applied`,
616
+ env: gitlab ? { [CONTROL_SHA_VAR]: sha } : { [CONTROL_TOKEN_ENV]: `\${{ secrets.${target.tokenSecret} }}`, [CONTROL_SHA_VAR]: sha },
617
+ // GitLab hands every job each CI/CD variable; the token's variable is the product's secret name, read here alone.
618
+ script: gitlab && target.tokenSecret !== CONTROL_TOKEN_ENV ? `${CONTROL_TOKEN_ENV}="\${${target.tokenSecret}:-}"\n${script}` : script,
619
+ context: controlStatusContext(words),
620
+ };
621
+ }
622
+
623
+ /** The variable naming a checkout of the control repo a note job reads the facts from (#4617). */
624
+ export const CONTROL_DIR_ENV = "CHANT_CONTROL_DIR";
625
+
626
+ /** The control repo's ledger branch, which holds its entries and apply records. */
627
+ const CONTROL_LIFECYCLE_REF = "refs/heads/chant/lifecycle";
628
+
629
+ /** The note job's read of the control repo (#4619), forge-neutral. */
630
+ export interface ControlNoteCheckout {
631
+ /** The step's name. */
632
+ stepName: string;
633
+ /**
634
+ * The step's environment on GitHub and Forgejo: {@link CONTROL_READ_TOKEN_ENV}
635
+ * from the read secret, else the job token. Empty on GitLab, where the
636
+ * script's first line reads the read variable itself.
637
+ */
638
+ env: Record<string, string>;
639
+ /**
640
+ * The step's script. It fetches the control repo's `chant/lifecycle`
641
+ * alone, at depth 1, into a new repository outside the checkout, and sets
642
+ * {@link CONTROL_DIR_ENV} to it: through `$GITHUB_ENV` on GitHub and
643
+ * Forgejo, so the later steps see it, and with `export` on GitLab, whose
644
+ * script lines share one shell. A control repo that cannot be read is a
645
+ * warning: the variable stays unset and every edge stays `unknown`.
646
+ */
647
+ script: string;
648
+ }
649
+
650
+ /**
651
+ * The step a pull request note job runs before it posts, when the pipeline
652
+ * names a control repo (#4619): a read-only fetch of the control repo's
653
+ * `chant/lifecycle`, so `pr-post` marks the cross-stack edges from its
654
+ * entries and apply records ({@link CONTROL_DIR_ENV}, ./edges.ts). The token
655
+ * is the read secret, never the dispatch token's, and reaches git as a
656
+ * header through git's environment for that one fetch, never the command
657
+ * line or a config file. Nothing of the control repo is checked out, so
658
+ * none of its files run.
659
+ */
660
+ export function controlNoteCheckout(memberForge: ForgeKind, target: ControlTarget, wordsIn: CiProductWordsInput | CiProductWords = {}): ControlNoteCheckout {
661
+ const words = resolveProductWords(wordsIn);
662
+ const label = words.product;
663
+ if (!CONTROL_SECRET_NAME.test(target.readTokenSecret)) throw new ControlConfigError(`control.readTokenSecret "${target.readTokenSecret}" is not a secret's name`);
664
+ // A loopback forge in a test answers on http; every other control repo on https.
665
+ const scheme = /^http:\/\//.test(target.apiBase) ? "http" : "https";
666
+ const url = sqUrl(`${scheme}://${target.host}/${target.path}.git`);
667
+ const repo = target.repo.replace(/[^A-Za-z0-9._:\/-]/g, "");
668
+ const gitlab = memberForge === "gitlab";
669
+ // GitLab's job token authenticates as gitlab-ci-token; a token from a secret as oauth2 on GitLab and as the token alone elsewhere.
670
+ const user = target.forge === "gitlab" ? "oauth2" : "x-access-token";
671
+ const tok = CONTROL_READ_TOKEN_ENV;
672
+ const read = gitlab
673
+ ? [
674
+ `${tok}="\${${target.readTokenSecret}:-}"`,
675
+ `chant_control_user=${user}`,
676
+ `if [ -z "$${tok}" ] && [ -n "\${CI_JOB_TOKEN:-}" ]; then ${tok}="$CI_JOB_TOKEN"; chant_control_user=gitlab-ci-token; fi`,
677
+ ]
678
+ : [`chant_control_user=${user}`];
679
+ const set = gitlab ? `export ${CONTROL_DIR_ENV}="$chant_control_dir"` : `echo "${CONTROL_DIR_ENV}=$chant_control_dir" >>"$GITHUB_ENV"`;
680
+ const script = [
681
+ ...read,
682
+ 'chant_control_dir="$(mktemp -d "${RUNNER_TEMP:-${TMPDIR:-/tmp}}/chant-control.XXXXXX")"',
683
+ // No token (a public control repo): git sends no header.
684
+ 'chant_control_count=0; chant_control_header=""',
685
+ `if [ -n "\${${tok}:-}" ]; then chant_control_count=1; chant_control_header="AUTHORIZATION: basic $(printf '%s:%s' "$chant_control_user" "$${tok}" | base64 | tr -d '\\n')"; fi`,
686
+ `if git init -q "$chant_control_dir" && GIT_TERMINAL_PROMPT=0 GIT_CONFIG_COUNT="$chant_control_count" GIT_CONFIG_KEY_0=http.extraheader GIT_CONFIG_VALUE_0="$chant_control_header" git -C "$chant_control_dir" fetch --quiet --no-tags --depth 1 ${url} '+${CONTROL_LIFECYCLE_REF}:${CONTROL_LIFECYCLE_REF}'; then`,
687
+ ` ${set}`,
688
+ ` echo "${label}: read the control repo ${repo}'s chant/lifecycle, so the note marks its cross-stack edges"`,
689
+ "else",
690
+ ` echo "${label}: could not read the control repo ${repo}'s chant/lifecycle, so its cross-stack edges stay unknown" >&2`,
691
+ "fi",
692
+ `unset chant_control_header chant_control_count chant_control_user ${tok}`,
693
+ ].join("\n");
694
+ return {
695
+ stepName: `Read the control repo ${repo}'s records, read-only, for the cross-stack edges`,
696
+ env: gitlab ? {} : { [tok]: `\${{ secrets.${target.readTokenSecret} || github.token }}` },
697
+ script,
698
+ };
699
+ }