@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,197 @@
1
+ /**
2
+ * Op waves through capabilities (#4545): a wave whose spec names a `step`
3
+ * plans and applies each run through a capability (`terraform-apply`,
4
+ * `pulumi-up`, any kind a lexicon's plugin contributes) in the job's own
5
+ * process, in place of a `plan` and an `apply` command. The gate, the
6
+ * approval, the spend, the hooks, the shares and the run record are the ones
7
+ * every op wave has; only who plans and who applies changes.
8
+ *
9
+ * ## The step
10
+ *
11
+ * `step` is `{ kind, ...input }`, the same shape a component's deploy step
12
+ * has. Each string in the input has `{target}`, `{op}` and `{wave}` filled
13
+ * per run, and a run's own `input` is laid over it, so one step covers every
14
+ * root of a wave and a run adds what is its own (vars, reads):
15
+ *
16
+ * ```json
17
+ * { "step": { "kind": "terraform-apply", "root": "{target}", "lockTimeout": "5m" },
18
+ * "waves": [{ "name": "dev", "runs": [{ "target": "network" }, { "target": "app", "input": { "vars": { "size": "s" } } }] }] }
19
+ * ```
20
+ *
21
+ * - Plan: `capability.plan` per run. The run's member digest is the plan's
22
+ * `planDigest`; `empty` and `destructive` come from its change-set part
23
+ * (no entry but `no-op` and `read`; a `delete` or `replace`), and a plan
24
+ * whose `destructive` names a class of the engine's own is destructive
25
+ * too (#4569, the sql lexicon's `sql-migrate`). A member
26
+ * whose part has holes and no artifact cannot apply, so planning fails
27
+ * with the holes' reasons. The parts compose into the wave's change-set
28
+ * document, which the pending fact cites (#4551).
29
+ * - Apply: `capability.run` with the plan's artifact in `DeployContext.plans`,
30
+ * so the run applies the plan the gate decided and nothing else. A run the
31
+ * capability refuses as moved (`isPlanMovedError`) applied nothing and the
32
+ * job exits 4, the table's moved code (#4553); any other error fails it.
33
+ *
34
+ * The registry is the project's (`fanOutRegistry`, the one `chant run
35
+ * --components` builds), loaded once per job behind a dynamic import, so the
36
+ * wave-job runtime bundle stays without the config loader. A product that
37
+ * runs chant in process passes its own (`RunOpWaveOptions.capabilities`).
38
+ *
39
+ * ## Holds (#4545)
40
+ *
41
+ * `holds` is a wave hold any product switches on, read at base with the
42
+ * policy, so a change cannot drop the hold its own wave is judged by:
43
+ *
44
+ * - `policy: true` runs the workspace's `ci.policy` (read at base, as the
45
+ * pull-request path reads it, `../components/pr-policy.ts`) over each
46
+ * run's change-set part. Its deny rules deny the run (an override then
47
+ * counts, `../override-gate.ts`), its hold rules hold it for a person, and
48
+ * a policy that cannot run fails the wave.
49
+ * - `cost` runs an estimator per run and sums the monthly change. Over
50
+ * `approveAbove` the wave waits for a person whatever its gate says, and
51
+ * the cost is a member of the set digest, so an approval at one cost does
52
+ * not apply at another. A run the estimator cannot price holds the wave
53
+ * too. The terraform lexicon's preset is `terraformCostHold` (infracost).
54
+ */
55
+ import type { Capability, CapabilityRegistry, DeployContext } from "../components/capability.js";
56
+ import type { CapabilityTraceFacts } from "../otlp.js";
57
+ import { type ChangeSetDocument, type ChangeSetPart } from "../change-set.js";
58
+ import type { GatePolicyExec } from "../gate-policy.js";
59
+ import type { ResolvedGatePolicySource } from "../policy-source.js";
60
+ import type { WaveMember } from "../wave-engine.js";
61
+ import type { OpWave, OpWaveRun, OpWavesSpec } from "./op-waves.js";
62
+ import { type LockGrain, type PlannedLock } from "../lifecycle/lock-rows.js";
63
+ import { type OpWaveCostFormat, type OpWaveCostHold } from "./op-waves-capability-spec.js";
64
+ export { OP_WAVE_COST_FORMATS, OP_WAVE_COST_MEMBER, opWaveHoldsAt, opWaveHoldsProblems, opWaveStepProblems } from "./op-waves-capability-spec.js";
65
+ export type { OpWaveCostFormat, OpWaveCostHold, OpWaveHolds, OpWaveStep } from "./op-waves-capability-spec.js";
66
+ /** The input a run's step gets (#4545): the spec's step with the run's values filled in, and the run's own `input` over it. */
67
+ export declare function opWaveStepInput(spec: Pick<OpWavesSpec, "op" | "step">, wave: Pick<OpWave, "name">, run: OpWaveRun): Record<string, unknown>;
68
+ /** The context a run's step plans and applies with: the spec's `labels.Env`, else the wave's name, and the run's target as the component. */
69
+ export declare function opWaveStepContext(spec: Pick<OpWavesSpec, "labels">, wave: Pick<OpWave, "name">, run: OpWaveRun): DeployContext;
70
+ /**
71
+ * The registry a job plans and applies through: `given`, else the project's
72
+ * at `cwd`, loaded once per `key` (the job's options) behind a dynamic
73
+ * import, which the wave-job runtime bundle leaves out.
74
+ */
75
+ export declare function opWaveRegistry(key: object, cwd: string, given?: CapabilityRegistry): Promise<CapabilityRegistry>;
76
+ /** One run's plan through its step: what the gate binds, and what the apply hands back. */
77
+ export interface OpWaveStepPlan {
78
+ target: string;
79
+ /** The capability's member, the key `run` finds its artifact under. */
80
+ member: string;
81
+ planDigest: string;
82
+ artifact?: unknown;
83
+ part?: ChangeSetPart;
84
+ empty: boolean;
85
+ destructive: boolean;
86
+ /** The run's lock grain and rows (#4552), which the apply leases on the resource grain. */
87
+ lock?: PlannedLock;
88
+ }
89
+ /** Whether a part changes nothing, and whether it destroys or replaces something. */
90
+ export declare function partEffects(part: ChangeSetPart | undefined): {
91
+ empty: boolean;
92
+ destructive: boolean;
93
+ };
94
+ /** Plan one run through the spec's step (#4545), writing its plan file at `planPath` (relative to `cwd`) as a per-run `plan` command would. */
95
+ export declare function planOpWaveStep(at: {
96
+ spec: OpWavesSpec;
97
+ wave: OpWave;
98
+ cwd: string;
99
+ registry: CapabilityRegistry;
100
+ planPath: string;
101
+ lockGrain?: LockGrain | null;
102
+ policyBase?: string;
103
+ }, run: OpWaveRun): Promise<OpWaveStepPlan>;
104
+ /** How one run's apply through its step came out, with what the capability knew about it (#4555). */
105
+ export type OpWaveStepApply = ({
106
+ outcome: "applied";
107
+ output: unknown;
108
+ } | {
109
+ outcome: "moved";
110
+ reason: string;
111
+ } | {
112
+ outcome: "failed";
113
+ reason: string;
114
+ }) & {
115
+ facts?: CapabilityTraceFacts;
116
+ };
117
+ /**
118
+ * A step's facts for its span and run record (#4555): the plan's resource
119
+ * counts by action, which core reads from the plan's change-set part, and
120
+ * whatever the capability's `traceFacts` adds. A `traceFacts` that throws
121
+ * is left out.
122
+ */
123
+ export declare function opWaveStepFacts(capability: Capability<never, unknown>, input: unknown, plan: OpWaveStepPlan, outcome: {
124
+ output: unknown;
125
+ } | {
126
+ error: unknown;
127
+ }): Promise<CapabilityTraceFacts | undefined>;
128
+ /** Apply one run through the spec's step (#4545), with the plan the gate decided. */
129
+ export declare function applyOpWaveStep(at: {
130
+ spec: OpWavesSpec;
131
+ wave: OpWave;
132
+ registry: CapabilityRegistry;
133
+ }, run: OpWaveRun, plan: OpWaveStepPlan): Promise<OpWaveStepApply>;
134
+ /** The wave's change-set document (#4551) from its runs' parts, or undefined when no run gave one. */
135
+ export declare function opWaveStepChangeSet(plans: readonly OpWaveStepPlan[]): ChangeSetDocument | undefined;
136
+ /** A policy verdict for one run, as the hold reads it. */
137
+ export interface OpWaveRunVerdict {
138
+ result: "passed" | "denied" | "held" | "error";
139
+ rules: string[];
140
+ holds: string[];
141
+ reason?: string;
142
+ }
143
+ /**
144
+ * Run the workspace's `ci.policy` at `base` over each run's part (#4545).
145
+ * Returns each run's verdict, or a line saying why no policy runs (the base
146
+ * names none). Throws when the policy at base cannot be read while the
147
+ * checkout names one, as the pull-request path does.
148
+ */
149
+ export declare function opWavePolicyVerdicts(at: {
150
+ spec: Pick<OpWavesSpec, "name">;
151
+ gate: string;
152
+ env: string;
153
+ base: string;
154
+ head: string;
155
+ cwd: string;
156
+ exec?: GatePolicyExec;
157
+ }, parts: ReadonlyMap<string, ChangeSetPart>): Promise<{
158
+ verdicts: Map<string, OpWaveRunVerdict>;
159
+ source?: ResolvedGatePolicySource;
160
+ } | {
161
+ note: string;
162
+ }>;
163
+ /** One run's estimate: the monthly change, or why there is none. */
164
+ export type OpWaveRunCost = {
165
+ target: string;
166
+ monthlyDelta: number;
167
+ currency?: string;
168
+ } | {
169
+ target: string;
170
+ error: string;
171
+ };
172
+ /** The monthly change an estimate gives, in `format`. Throws when it gives none. */
173
+ export declare function readCostEstimate(format: OpWaveCostFormat, stdout: string): {
174
+ monthlyDelta: number;
175
+ currency?: string;
176
+ };
177
+ /** The engine's plan document a capability's artifact names (`artifact.planJson`), when it names one that exists. */
178
+ export declare function planJsonOf(artifact: unknown, cwd: string): string | undefined;
179
+ /** Price each run that changes something (#4545). A run with no estimate says why. */
180
+ export declare function opWaveCosts(hold: OpWaveCostHold, runs: ReadonlyArray<{
181
+ target: string;
182
+ plan: string;
183
+ artifact?: unknown;
184
+ empty: boolean;
185
+ }>, cwd: string, exec?: GatePolicyExec): OpWaveRunCost[];
186
+ /** What a wave's estimates come to: the sum, the digest member, and the hold line when it waits. */
187
+ export interface OpWaveCostVerdict {
188
+ monthlyDelta: number;
189
+ currency: string;
190
+ unestimated: string[];
191
+ member: WaveMember;
192
+ /** Set when the wave waits for it: over `approveAbove`, or a run with no estimate. */
193
+ hold?: string;
194
+ }
195
+ /** Sum a wave's estimates against `approveAbove` (#4545). */
196
+ export declare function opWaveCostVerdict(hold: OpWaveCostHold, costs: readonly OpWaveRunCost[]): OpWaveCostVerdict;
197
+ //# sourceMappingURL=op-waves-capability.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"op-waves-capability.d.ts","sourceRoot":"","sources":["../../src/op/op-waves-capability.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,311 @@
1
+ /**
2
+ * Op waves through capabilities (#4545): a wave whose spec names a `step`
3
+ * plans and applies each run through a capability (`terraform-apply`,
4
+ * `pulumi-up`, any kind a lexicon's plugin contributes) in the job's own
5
+ * process, in place of a `plan` and an `apply` command. The gate, the
6
+ * approval, the spend, the hooks, the shares and the run record are the ones
7
+ * every op wave has; only who plans and who applies changes.
8
+ *
9
+ * ## The step
10
+ *
11
+ * `step` is `{ kind, ...input }`, the same shape a component's deploy step
12
+ * has. Each string in the input has `{target}`, `{op}` and `{wave}` filled
13
+ * per run, and a run's own `input` is laid over it, so one step covers every
14
+ * root of a wave and a run adds what is its own (vars, reads):
15
+ *
16
+ * ```json
17
+ * { "step": { "kind": "terraform-apply", "root": "{target}", "lockTimeout": "5m" },
18
+ * "waves": [{ "name": "dev", "runs": [{ "target": "network" }, { "target": "app", "input": { "vars": { "size": "s" } } }] }] }
19
+ * ```
20
+ *
21
+ * - Plan: `capability.plan` per run. The run's member digest is the plan's
22
+ * `planDigest`; `empty` and `destructive` come from its change-set part
23
+ * (no entry but `no-op` and `read`; a `delete` or `replace`), and a plan
24
+ * whose `destructive` names a class of the engine's own is destructive
25
+ * too (#4569, the sql lexicon's `sql-migrate`). A member
26
+ * whose part has holes and no artifact cannot apply, so planning fails
27
+ * with the holes' reasons. The parts compose into the wave's change-set
28
+ * document, which the pending fact cites (#4551).
29
+ * - Apply: `capability.run` with the plan's artifact in `DeployContext.plans`,
30
+ * so the run applies the plan the gate decided and nothing else. A run the
31
+ * capability refuses as moved (`isPlanMovedError`) applied nothing and the
32
+ * job exits 4, the table's moved code (#4553); any other error fails it.
33
+ *
34
+ * The registry is the project's (`fanOutRegistry`, the one `chant run
35
+ * --components` builds), loaded once per job behind a dynamic import, so the
36
+ * wave-job runtime bundle stays without the config loader. A product that
37
+ * runs chant in process passes its own (`RunOpWaveOptions.capabilities`).
38
+ *
39
+ * ## Holds (#4545)
40
+ *
41
+ * `holds` is a wave hold any product switches on, read at base with the
42
+ * policy, so a change cannot drop the hold its own wave is judged by:
43
+ *
44
+ * - `policy: true` runs the workspace's `ci.policy` (read at base, as the
45
+ * pull-request path reads it, `../components/pr-policy.ts`) over each
46
+ * run's change-set part. Its deny rules deny the run (an override then
47
+ * counts, `../override-gate.ts`), its hold rules hold it for a person, and
48
+ * a policy that cannot run fails the wave.
49
+ * - `cost` runs an estimator per run and sums the monthly change. Over
50
+ * `approveAbove` the wave waits for a person whatever its gate says, and
51
+ * the cost is a member of the set digest, so an approval at one cost does
52
+ * not apply at another. A run the estimator cannot price holds the wave
53
+ * too. The terraform lexicon's preset is `terraformCostHold` (infracost).
54
+ */
55
+ import { spawnSync } from "node:child_process";
56
+ import { existsSync, mkdirSync, writeFileSync } from "node:fs";
57
+ import { dirname, join } from "node:path";
58
+ import { isPlanMovedError } from "../components/capability.js";
59
+ import { composeChangeSet } from "../change-set.js";
60
+ import { computePlanDigest } from "../lifecycle/plan-digest.js";
61
+ import { resolvePlannedLock } from "../lifecycle/lock-rows.js";
62
+ import { OP_WAVE_COST_MEMBER } from "./op-waves-capability-spec.js";
63
+ export { OP_WAVE_COST_FORMATS, OP_WAVE_COST_MEMBER, opWaveHoldsAt, opWaveHoldsProblems, opWaveStepProblems } from "./op-waves-capability-spec.js";
64
+ /** Fill `{target}`, `{op}` and `{wave}` in every string of `value`. */
65
+ function fill(value, vars) {
66
+ if (typeof value === "string")
67
+ return value.replaceAll("{target}", vars.target).replaceAll("{op}", vars.op).replaceAll("{wave}", vars.wave);
68
+ if (Array.isArray(value))
69
+ return value.map((v) => fill(v, vars));
70
+ if (value !== null && typeof value === "object")
71
+ return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, fill(v, vars)]));
72
+ return value;
73
+ }
74
+ /** The input a run's step gets (#4545): the spec's step with the run's values filled in, and the run's own `input` over it. */
75
+ export function opWaveStepInput(spec, wave, run) {
76
+ if (!spec.step)
77
+ throw new Error("the spec names no step");
78
+ const { kind: _kind, ...rest } = spec.step;
79
+ const vars = { target: run.target, op: run.op ?? spec.op, wave: wave.name };
80
+ return { ...fill(rest, vars), ...(run.input ? fill(run.input, vars) : {}) };
81
+ }
82
+ /** The context a run's step plans and applies with: the spec's `labels.Env`, else the wave's name, and the run's target as the component. */
83
+ export function opWaveStepContext(spec, wave, run) {
84
+ return { env: spec.labels?.Env ?? wave.name, component: run.target };
85
+ }
86
+ const registries = new WeakMap();
87
+ /**
88
+ * The registry a job plans and applies through: `given`, else the project's
89
+ * at `cwd`, loaded once per `key` (the job's options) behind a dynamic
90
+ * import, which the wave-job runtime bundle leaves out.
91
+ */
92
+ export function opWaveRegistry(key, cwd, given) {
93
+ if (given)
94
+ return Promise.resolve(given);
95
+ let found = registries.get(key);
96
+ if (!found) {
97
+ found = import("../components/fan-out-support.js").then((m) => m.fanOutRegistry(cwd));
98
+ registries.set(key, found);
99
+ }
100
+ return found;
101
+ }
102
+ /** Whether a part changes nothing, and whether it destroys or replaces something. */
103
+ export function partEffects(part) {
104
+ if (!part)
105
+ return { empty: false, destructive: false };
106
+ const changing = part.entries.filter((e) => e.action !== "no-op" && e.action !== "read");
107
+ return { empty: changing.length === 0, destructive: changing.some((e) => e.action === "delete" || e.action === "replace") };
108
+ }
109
+ function resolveCapability(registry, kind) {
110
+ if (!registry.has(kind))
111
+ throw new Error(`no capability "${kind}" is registered; the project's lexicons and capability plugins (chant.config) contribute the kinds a step can name`);
112
+ return registry.resolve(kind);
113
+ }
114
+ /** Plan one run through the spec's step (#4545), writing its plan file at `planPath` (relative to `cwd`) as a per-run `plan` command would. */
115
+ export async function planOpWaveStep(at, run) {
116
+ const { spec, wave, cwd, registry } = at;
117
+ const capability = resolveCapability(registry, spec.step.kind);
118
+ if (!capability.plan)
119
+ throw new Error(`the capability "${spec.step.kind}" cannot plan, so its runs have no plan for the wave's gate to bind`);
120
+ const input = opWaveStepInput(spec, wave, run);
121
+ let planned;
122
+ let lock;
123
+ try {
124
+ planned = await capability.plan({ ...opWaveStepContext(spec, wave, run), ...(at.lockGrain ? { lockGrain: at.lockGrain } : {}), ...(at.policyBase ? { policyBase: at.policyBase } : {}) }, input);
125
+ // #4552: the run's grain (declared at base, else its lexicon's) and, on the resource grain, the rows its apply leases.
126
+ lock = await resolvePlannedLock(capability, input, planned, at.lockGrain);
127
+ }
128
+ catch (err) {
129
+ throw new Error(`planning ${run.target} through ${spec.step.kind} failed: ${err instanceof Error ? err.message : String(err)}`);
130
+ }
131
+ if (typeof planned.planDigest !== "string" || planned.planDigest === "")
132
+ throw new Error(`${spec.step.kind} planned ${run.target} with no plan digest`);
133
+ const holes = planned.changeSet?.member.holes ?? [];
134
+ if (holes.length > 0 && planned.artifact === undefined) {
135
+ throw new Error(`${run.target} was not planned: ${holes.map((h) => h.reason).join("; ")}`);
136
+ }
137
+ const effects = partEffects(planned.changeSet);
138
+ // #4569: the engine's own destructive classes count too (a rewrite, a revoke), not only a delete or replace.
139
+ if ((planned.destructive?.length ?? 0) > 0)
140
+ effects.destructive = true;
141
+ const plan = {
142
+ target: run.target,
143
+ member: planned.member,
144
+ planDigest: planned.planDigest,
145
+ ...(planned.artifact !== undefined ? { artifact: planned.artifact } : {}),
146
+ ...(planned.changeSet ? { part: planned.changeSet } : {}),
147
+ ...effects,
148
+ lock,
149
+ };
150
+ const file = join(cwd, at.planPath);
151
+ mkdirSync(dirname(file), { recursive: true });
152
+ let artifact;
153
+ try {
154
+ artifact = planned.artifact === undefined ? undefined : JSON.parse(JSON.stringify(planned.artifact));
155
+ }
156
+ catch {
157
+ artifact = undefined;
158
+ }
159
+ writeFileSync(file, JSON.stringify({
160
+ planDigest: plan.planDigest,
161
+ ...(plan.destructive ? { destructive: true } : {}),
162
+ ...(plan.empty ? { empty: true } : {}),
163
+ member: plan.member,
164
+ ...(artifact !== undefined ? { artifact } : {}),
165
+ ...(plan.part ? { changeSet: plan.part } : {}),
166
+ }) + "\n");
167
+ return plan;
168
+ }
169
+ /**
170
+ * A step's facts for its span and run record (#4555): the plan's resource
171
+ * counts by action, which core reads from the plan's change-set part, and
172
+ * whatever the capability's `traceFacts` adds. A `traceFacts` that throws
173
+ * is left out.
174
+ */
175
+ export async function opWaveStepFacts(capability, input, plan, outcome) {
176
+ const counts = {};
177
+ for (const e of plan.part?.entries ?? [])
178
+ counts[`resources.${e.action}`] = (counts[`resources.${e.action}`] ?? 0) + 1;
179
+ let own;
180
+ try {
181
+ own = await capability.traceFacts?.(input, outcome);
182
+ }
183
+ catch {
184
+ own = undefined;
185
+ }
186
+ const attributes = { member: plan.member, kind: capability.kind, ...counts, ...(own?.attributes ?? {}) };
187
+ // #4615: what the engine reported per resource goes on with the rest.
188
+ return { attributes, ...(own?.spans?.length ? { spans: own.spans } : {}), ...(own?.resources?.length ? { resources: own.resources } : {}) };
189
+ }
190
+ /** Apply one run through the spec's step (#4545), with the plan the gate decided. */
191
+ export async function applyOpWaveStep(at, run, plan) {
192
+ const { spec, wave, registry } = at;
193
+ let capability;
194
+ try {
195
+ capability = resolveCapability(registry, spec.step.kind);
196
+ }
197
+ catch (err) {
198
+ return { outcome: "failed", reason: err instanceof Error ? err.message : String(err) };
199
+ }
200
+ const ctx = { ...opWaveStepContext(spec, wave, run), ...(plan.artifact !== undefined ? { plans: { [plan.member]: plan.artifact } } : {}) };
201
+ const input = opWaveStepInput(spec, wave, run);
202
+ try {
203
+ const output = await capability.run(ctx, input);
204
+ const facts = await opWaveStepFacts(capability, input, plan, { output });
205
+ return { outcome: "applied", output, ...(facts ? { facts } : {}) };
206
+ }
207
+ catch (err) {
208
+ const reason = err instanceof Error ? err.message : String(err);
209
+ const facts = await opWaveStepFacts(capability, input, plan, { error: err });
210
+ return { ...(isPlanMovedError(err) ? { outcome: "moved", reason } : { outcome: "failed", reason }), ...(facts ? { facts } : {}) };
211
+ }
212
+ }
213
+ /** The wave's change-set document (#4551) from its runs' parts, or undefined when no run gave one. */
214
+ export function opWaveStepChangeSet(plans) {
215
+ const parts = plans.flatMap((p) => (p.part ? [p.part] : []));
216
+ return parts.length > 0 ? composeChangeSet(parts) : undefined;
217
+ }
218
+ /**
219
+ * Run the workspace's `ci.policy` at `base` over each run's part (#4545).
220
+ * Returns each run's verdict, or a line saying why no policy runs (the base
221
+ * names none). Throws when the policy at base cannot be read while the
222
+ * checkout names one, as the pull-request path does.
223
+ */
224
+ export async function opWavePolicyVerdicts(at, parts) {
225
+ const { prLoopPolicyAt, runPrPolicy } = await import("../components/pr-policy.js");
226
+ const read = prLoopPolicyAt(at.cwd, at.base);
227
+ if (!read.settings)
228
+ return { note: read.note ?? `holds.policy: the declaration at ${at.base.slice(0, 12)} names no ci.policy, so no policy runs` };
229
+ const verdicts = new Map();
230
+ for (const [target, part] of parts) {
231
+ const verdict = runPrPolicy(read, { version: 1, stage: "apply", op: at.spec.name, gate: at.gate, env: at.env, pr: null, base: at.base, head: at.head, changeSet: composeChangeSet([part]) }, at.exec);
232
+ if (!verdict)
233
+ continue;
234
+ const reason = verdict.result === "error" ? verdict.error : [...verdict.denials, ...verdict.holds].map((f) => f.message).filter(Boolean).join("; ") || undefined;
235
+ verdicts.set(target, { result: verdict.result, rules: verdict.rules, holds: [...new Set(verdict.holds.map((h) => h.rule))].sort(), ...(reason ? { reason } : {}) });
236
+ }
237
+ return { verdicts, ...(read.source ? { source: read.source } : {}) };
238
+ }
239
+ /** The monthly change an estimate gives, in `format`. Throws when it gives none. */
240
+ export function readCostEstimate(format, stdout) {
241
+ const doc = JSON.parse(stdout);
242
+ const num = (v) => (typeof v === "number" && Number.isFinite(v) ? v : typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v)) ? Number(v) : undefined);
243
+ if (format === "chant") {
244
+ const delta = num(doc.monthlyDelta);
245
+ if (delta === undefined)
246
+ throw new Error("the estimate has no monthlyDelta");
247
+ return { monthlyDelta: delta, ...(typeof doc.currency === "string" ? { currency: doc.currency } : {}) };
248
+ }
249
+ // infracost breakdown --format json: diffTotalMonthlyCost, else totalMonthlyCost less pastTotalMonthlyCost.
250
+ const diff = num(doc.diffTotalMonthlyCost);
251
+ const total = num(doc.totalMonthlyCost);
252
+ const past = num(doc.pastTotalMonthlyCost);
253
+ const delta = diff ?? (total !== undefined ? total - (past ?? 0) : undefined);
254
+ if (delta === undefined)
255
+ throw new Error("the infracost document has no diffTotalMonthlyCost or totalMonthlyCost");
256
+ return { monthlyDelta: delta, ...(typeof doc.currency === "string" ? { currency: doc.currency } : {}) };
257
+ }
258
+ const defaultHoldExec = (argv, cwd) => {
259
+ const r = spawnSync(argv[0], argv.slice(1), { cwd, encoding: "utf-8", maxBuffer: 64 * 1024 * 1024 });
260
+ return { status: r.error ? null : r.status, stdout: r.stdout ?? "", stderr: `${r.stderr ?? ""}${r.error ? r.error.message : ""}` };
261
+ };
262
+ /** The engine's plan document a capability's artifact names (`artifact.planJson`), when it names one that exists. */
263
+ export function planJsonOf(artifact, cwd) {
264
+ const p = artifact?.planJson;
265
+ if (typeof p !== "string" || p === "")
266
+ return undefined;
267
+ const path = p.startsWith("/") ? p : join(cwd, p);
268
+ return existsSync(path) ? path : undefined;
269
+ }
270
+ /** Price each run that changes something (#4545). A run with no estimate says why. */
271
+ export function opWaveCosts(hold, runs, cwd, exec = defaultHoldExec) {
272
+ const format = hold.format ?? "infracost";
273
+ const out = [];
274
+ for (const run of runs) {
275
+ if (run.empty)
276
+ continue;
277
+ const planJson = planJsonOf(run.artifact, cwd);
278
+ if (hold.command.some((a) => a.includes("{planJson}")) && !planJson) {
279
+ out.push({ target: run.target, error: "its plan names no plan document to price" });
280
+ continue;
281
+ }
282
+ const argv = hold.command.map((a) => a.replaceAll("{target}", run.target).replaceAll("{plan}", run.plan).replaceAll("{planJson}", planJson ?? ""));
283
+ const r = exec(argv, cwd);
284
+ if (r.status !== 0) {
285
+ out.push({ target: run.target, error: `${argv[0]} ${r.status === null ? "did not run" : `exited ${r.status}`}: ${(r.stderr || r.stdout).trim().split("\n").slice(-2).join(" ")}` });
286
+ continue;
287
+ }
288
+ try {
289
+ out.push({ target: run.target, ...readCostEstimate(format, r.stdout) });
290
+ }
291
+ catch (err) {
292
+ out.push({ target: run.target, error: `the estimate cannot be read: ${err instanceof Error ? err.message : String(err)}` });
293
+ }
294
+ }
295
+ return out;
296
+ }
297
+ /** Sum a wave's estimates against `approveAbove` (#4545). */
298
+ export function opWaveCostVerdict(hold, costs) {
299
+ const priced = costs.filter((c) => "monthlyDelta" in c);
300
+ const unestimated = costs.filter((c) => "error" in c).map((c) => c.target).sort();
301
+ const monthlyDelta = Math.round(priced.reduce((sum, c) => sum + c.monthlyDelta, 0) * 100) / 100;
302
+ const currency = hold.currency ?? priced.find((c) => c.currency)?.currency ?? "USD";
303
+ const member = { member: OP_WAVE_COST_MEMBER, planDigest: computePlanDigest("op-wave-cost", { approveAbove: hold.approveAbove, currency, monthlyDelta, unestimated }) };
304
+ const signed = `${monthlyDelta >= 0 ? "+" : ""}${monthlyDelta.toFixed(2)} ${currency}`;
305
+ const reasons = [];
306
+ if (monthlyDelta > hold.approveAbove)
307
+ reasons.push(`its monthly change of ${signed} is over holds.cost.approveAbove (${hold.approveAbove} ${currency})`);
308
+ if (unestimated.length > 0)
309
+ reasons.push(`${unestimated.join(", ")} could not be priced`);
310
+ return { monthlyDelta, currency, unestimated, member, ...(reasons.length > 0 ? { hold: `cost: ${reasons.join(", and ")}` } : {}) };
311
+ }
@@ -0,0 +1,54 @@
1
+ /**
2
+ * Run events for one `chant run wave` job (#4555), on the run-event contract
3
+ * (../run-event.ts), and its trace through chant's OTLP exporter (../otlp.ts).
4
+ *
5
+ * The job is an Op run (`kind: "op"`, named for the spec). Each wave it
6
+ * walks is a phase `wave-<k>`, as its run record names it (#4551), and each
7
+ * run target is a step of that phase. A target's `step-start` and
8
+ * `step-settle` are written as its apply starts and ends, so a reader
9
+ * following the stream sees each root or stack as it applies. When the job
10
+ * ends, the targets it never applied (moved, blocked, waiting, or planned
11
+ * only) settle as `skipped`, a job that waits at a gate writes
12
+ * `gate-waiting` on a `gate:<name>` step of its last phase, and the phases
13
+ * and the run settle with the run record's verdict. The stream and the
14
+ * record therefore say the same thing.
15
+ *
16
+ * Under the trace, each target's span carries what its capability knew
17
+ * (`Capability.traceFacts`): engine facts as attributes, and a child span per
18
+ * resource the engine timed. When the capability reports per-resource lines
19
+ * (`CapabilityTraceFacts.resources`, #4615), the target's `step-settle`
20
+ * carries them as `resources`.
21
+ */
22
+ import type { RunEventSink } from "../run-event-stream.js";
23
+ import type { CapabilityTraceFacts, RunEventTrace } from "../otlp.js";
24
+ import type { OpRunRecordInput } from "./runtime.js";
25
+ /** How one target's apply settled, as the step says it. */
26
+ export type OpWaveTargetSettle = "ok" | "failed" | "skipped";
27
+ /** One job's stream: the emitter, and the trace built from it when the exporter is on. */
28
+ export declare class OpWaveRunEvents {
29
+ private readonly sink;
30
+ readonly trace?: RunEventTrace | undefined;
31
+ private readonly phases;
32
+ private readonly settled;
33
+ constructor(sink: RunEventSink, trace?: RunEventTrace | undefined);
34
+ private emit;
35
+ private phase;
36
+ start(): void;
37
+ /** A target's apply begins. */
38
+ stepStart(k: number, target: string): void;
39
+ /** A target's apply ended, with its time and what its capability knew. */
40
+ stepSettle(k: number, target: string, status: OpWaveTargetSettle, durationMs: number | null, opts?: {
41
+ error?: string;
42
+ message?: string;
43
+ facts?: CapabilityTraceFacts;
44
+ }): void;
45
+ /**
46
+ * The job ended: settle what is still open from its run record, then the
47
+ * run. `moved` and `blocked` give the reason a skipped target says.
48
+ */
49
+ finish(record: OpRunRecordInput, why?: {
50
+ moved?: readonly string[];
51
+ blocked?: Readonly<Record<string, string>>;
52
+ }): void;
53
+ }
54
+ //# sourceMappingURL=op-waves-events.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"op-waves-events.d.ts","sourceRoot":"","sources":["../../src/op/op-waves-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,2DAA2D;AAC3D,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D,0FAA0F;AAC1F,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa;IALhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,YACmB,IAAI,EAAE,YAAY,EAC1B,KAAK,CAAC,EAAE,aAAa,YAAA,EAC5B;IAEJ,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,KAAK;IASb,KAAK,IAAI,IAAI,CAEZ;IAED,+BAA+B;IAC/B,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGzC;IAED,0EAA0E;IAC1E,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,oBAAoB,CAAA;KAAO,GAAG,IAAI,CAiBhL;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,GAAE;QAAE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;KAAO,GAAG,IAAI,CA0C1H;CACF"}