@intentius/chant 0.124.54 → 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.
- package/dist/__fixtures__/estate-ledger.d.ts +13 -0
- package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
- package/dist/__fixtures__/estate-ledger.js +67 -0
- package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
- package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
- package/dist/__fixtures__/oidc-emulator.js +26 -2
- package/dist/__fixtures__/product-words.d.ts +78 -0
- package/dist/__fixtures__/product-words.d.ts.map +1 -0
- package/dist/__fixtures__/product-words.js +43 -0
- package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/dist/__golden__/wave-loop/op-held-on.json +28 -7
- package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/dist/__golden__/wave-loop/op-overridden.json +28 -7
- package/dist/__golden__/wave-loop/op-per-run.json +20 -4
- package/dist/__golden__/wave-loop/op-point.json +18 -4
- package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
- package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/dist/__golden__/wave-loop/op-spend.json +10 -2
- package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/dist/__golden__/wave-loop/op-wide.json +20 -4
- package/dist/bucket-check/azure.d.ts +108 -0
- package/dist/bucket-check/azure.d.ts.map +1 -0
- package/dist/bucket-check/azure.js +258 -0
- package/dist/bucket-check/fixtures/azure.json +153 -0
- package/dist/bucket-check/fixtures/gcs.json +148 -0
- package/dist/bucket-check/fixtures/s3.json +277 -0
- package/dist/bucket-check/gcs.d.ts +77 -0
- package/dist/bucket-check/gcs.d.ts.map +1 -0
- package/dist/bucket-check/gcs.js +202 -0
- package/dist/bucket-check/index.d.ts +48 -0
- package/dist/bucket-check/index.d.ts.map +1 -0
- package/dist/bucket-check/index.js +44 -0
- package/dist/bucket-check/s3.d.ts +116 -0
- package/dist/bucket-check/s3.d.ts.map +1 -0
- package/dist/bucket-check/s3.js +362 -0
- package/dist/bucket-check/types.d.ts +66 -0
- package/dist/bucket-check/types.d.ts.map +1 -0
- package/dist/bucket-check/types.js +31 -0
- package/dist/bucket-check/wire.d.ts +27 -0
- package/dist/bucket-check/wire.d.ts.map +1 -0
- package/dist/bucket-check/wire.js +32 -0
- package/dist/bucket-check.d.ts +6 -0
- package/dist/bucket-check.d.ts.map +1 -0
- package/dist/bucket-check.js +5 -0
- package/dist/capabilities/templates.d.ts.map +1 -1
- package/dist/capabilities/templates.js +1 -2
- package/dist/change-set.d.ts.map +1 -1
- package/dist/change-set.js +2 -3
- package/dist/ci-agent.d.ts +381 -0
- package/dist/ci-agent.d.ts.map +1 -0
- package/dist/ci-agent.js +833 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +42 -0
- package/dist/ci-estate/delivery.d.ts +137 -0
- package/dist/ci-estate/delivery.d.ts.map +1 -0
- package/dist/ci-estate/delivery.js +311 -0
- package/dist/ci-estate/overdue.d.ts +34 -0
- package/dist/ci-estate/overdue.d.ts.map +1 -0
- package/dist/ci-estate/overdue.js +58 -0
- package/dist/ci-estate/page.d.ts +134 -0
- package/dist/ci-estate/page.d.ts.map +1 -0
- package/dist/ci-estate/page.js +233 -0
- package/dist/ci-estate/rows.d.ts +118 -0
- package/dist/ci-estate/rows.d.ts.map +1 -0
- package/dist/ci-estate/rows.js +126 -0
- package/dist/ci-estate.d.ts +68 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +83 -0
- package/dist/ci-handover.d.ts +29 -5
- package/dist/ci-handover.d.ts.map +1 -1
- package/dist/ci-handover.js +50 -16
- package/dist/ci-identity.d.ts +82 -7
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +87 -15
- package/dist/ci-product-words.d.ts +290 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +373 -0
- package/dist/ci-product.d.ts +82 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +78 -0
- package/dist/cli/commands/audit.d.ts +2 -2
- package/dist/cli/commands/audit.d.ts.map +1 -1
- package/dist/cli/commands/audit.js +3 -2
- package/dist/cli/commands/carve.js +2 -2
- package/dist/cli/commands/init.d.ts +2 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +1 -1
- package/dist/cli/handlers/agent.d.ts +17 -0
- package/dist/cli/handlers/agent.d.ts.map +1 -0
- package/dist/cli/handlers/agent.js +114 -0
- package/dist/cli/handlers/approve-confirm.d.ts +84 -0
- package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
- package/dist/cli/handlers/approve-confirm.js +142 -0
- package/dist/cli/handlers/approve.d.ts.map +1 -1
- package/dist/cli/handlers/approve.js +19 -1
- package/dist/cli/handlers/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +43 -1
- package/dist/cli/handlers/ci-check.d.ts +3 -0
- package/dist/cli/handlers/ci-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check.js +34 -0
- package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
- package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-forge-check.js +89 -0
- package/dist/cli/handlers/fan-out.js +4 -0
- package/dist/cli/handlers/gate-pending.d.ts +11 -0
- package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
- package/dist/cli/handlers/gate-pending.js +44 -0
- package/dist/cli/handlers/init.d.ts.map +1 -1
- package/dist/cli/handlers/init.js +1 -0
- package/dist/cli/handlers/ledger.js +1 -1
- package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
- package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
- package/dist/cli/handlers/lifecycle-drift.js +7 -2
- package/dist/cli/handlers/lock.d.ts.map +1 -1
- package/dist/cli/handlers/lock.js +64 -5
- package/dist/cli/handlers/notify-relay.d.ts +15 -0
- package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
- package/dist/cli/handlers/notify-relay.js +130 -0
- package/dist/cli/handlers/pr-env.d.ts.map +1 -1
- package/dist/cli/handlers/pr-env.js +42 -11
- package/dist/cli/handlers/pr.d.ts +38 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +653 -205
- package/dist/cli/handlers/promote.d.ts.map +1 -1
- package/dist/cli/handlers/promote.js +21 -2
- package/dist/cli/handlers/release.d.ts.map +1 -1
- package/dist/cli/handlers/release.js +3 -0
- package/dist/cli/handlers/run-wave.d.ts +8 -0
- package/dist/cli/handlers/run-wave.d.ts.map +1 -1
- package/dist/cli/handlers/run-wave.js +71 -1
- package/dist/cli/handlers/run.d.ts +6 -1
- package/dist/cli/handlers/run.d.ts.map +1 -1
- package/dist/cli/handlers/run.js +86 -1
- package/dist/cli/handlers/serve.d.ts.map +1 -1
- package/dist/cli/handlers/serve.js +10 -1
- package/dist/cli/main.d.ts +11 -1
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +124 -13
- package/dist/cli/mcp/ledger-tools.d.ts +36 -0
- package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
- package/dist/cli/mcp/ledger-tools.js +122 -0
- package/dist/cli/mcp/product-tools.d.ts +78 -0
- package/dist/cli/mcp/product-tools.d.ts.map +1 -0
- package/dist/cli/mcp/product-tools.js +93 -0
- package/dist/cli/mcp/read-only.d.ts +34 -0
- package/dist/cli/mcp/read-only.d.ts.map +1 -0
- package/dist/cli/mcp/read-only.js +61 -0
- package/dist/cli/mcp/report-tools.d.ts +48 -0
- package/dist/cli/mcp/report-tools.d.ts.map +1 -0
- package/dist/cli/mcp/report-tools.js +128 -0
- package/dist/cli/mcp/server.d.ts +28 -1
- package/dist/cli/mcp/server.d.ts.map +1 -1
- package/dist/cli/mcp/server.js +86 -15
- package/dist/cli/mcp-config.d.ts +9 -2
- package/dist/cli/mcp-config.d.ts.map +1 -1
- package/dist/cli/mcp-config.js +8 -3
- package/dist/cli/parse-args.d.ts.map +1 -1
- package/dist/cli/parse-args.js +57 -3
- package/dist/cli/registry.d.ts +35 -0
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.d.ts +42 -7
- package/dist/cloud-lister/sigv4.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.js +72 -22
- package/dist/components/adoption.d.ts +69 -0
- package/dist/components/adoption.d.ts.map +1 -0
- package/dist/components/adoption.js +93 -0
- package/dist/components/apply-lease.d.ts +19 -0
- package/dist/components/apply-lease.d.ts.map +1 -0
- package/dist/components/apply-lease.js +41 -0
- package/dist/components/capability.d.ts +122 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +14 -6
- package/dist/components/check-hooks.d.ts +113 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -0
- package/dist/components/ci-services.d.ts +57 -0
- package/dist/components/ci-services.d.ts.map +1 -0
- package/dist/components/ci-services.js +61 -0
- package/dist/components/cli-support.d.ts +13 -0
- package/dist/components/cli-support.d.ts.map +1 -1
- package/dist/components/cli-support.js +10 -2
- package/dist/components/driver.d.ts +20 -3
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +24 -4
- package/dist/components/fan-out-run.d.ts +12 -0
- package/dist/components/fan-out-run.d.ts.map +1 -1
- package/dist/components/fan-out-run.js +56 -16
- package/dist/components/groups.d.ts.map +1 -1
- package/dist/components/groups.js +19 -2
- package/dist/components/pr-env-ledger.d.ts +32 -0
- package/dist/components/pr-env-ledger.d.ts.map +1 -0
- package/dist/components/pr-env-ledger.js +39 -0
- package/dist/components/pr-env-ports.d.ts +12 -0
- package/dist/components/pr-env-ports.d.ts.map +1 -1
- package/dist/components/pr-env-ports.js +13 -3
- package/dist/components/pr-env-run.d.ts +6 -0
- package/dist/components/pr-env-run.d.ts.map +1 -1
- package/dist/components/pr-env-run.js +3 -2
- package/dist/components/pr-environment.d.ts +31 -3
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +25 -7
- package/dist/components/pr-pipeline.d.ts +169 -3
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +184 -9
- package/dist/components/pr-policy.d.ts +26 -2
- package/dist/components/pr-policy.d.ts.map +1 -1
- package/dist/components/pr-policy.js +41 -7
- package/dist/components/pr-run.d.ts +63 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +82 -3
- package/dist/components/pr-targets.d.ts +24 -0
- package/dist/components/pr-targets.d.ts.map +1 -0
- package/dist/components/pr-targets.js +48 -0
- package/dist/components/product-pipeline.d.ts +217 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +193 -0
- package/dist/components/promote.d.ts +6 -0
- package/dist/components/promote.d.ts.map +1 -1
- package/dist/components/promote.js +4 -1
- package/dist/components/release-compile.d.ts +22 -1
- package/dist/components/release-compile.d.ts.map +1 -1
- package/dist/components/release-compile.js +85 -0
- package/dist/components/release-promote.d.ts +15 -1
- package/dist/components/release-promote.d.ts.map +1 -1
- package/dist/components/release-promote.js +67 -2
- package/dist/components/repo-lock.d.ts +27 -0
- package/dist/components/repo-lock.d.ts.map +1 -0
- package/dist/components/repo-lock.js +49 -0
- package/dist/components/row-lease.d.ts +84 -0
- package/dist/components/row-lease.d.ts.map +1 -0
- package/dist/components/row-lease.js +110 -0
- package/dist/components/wave-plan.d.ts +34 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +54 -2
- package/dist/control/applied.d.ts +89 -0
- package/dist/control/applied.d.ts.map +1 -0
- package/dist/control/applied.js +175 -0
- package/dist/control/consumers.d.ts +78 -0
- package/dist/control/consumers.d.ts.map +1 -0
- package/dist/control/consumers.js +172 -0
- package/dist/control/dispatch.d.ts +334 -0
- package/dist/control/dispatch.d.ts.map +1 -0
- package/dist/control/dispatch.js +519 -0
- package/dist/control/edges.d.ts +75 -0
- package/dist/control/edges.d.ts.map +1 -0
- package/dist/control/edges.js +133 -0
- package/dist/control/reconcile.d.ts +120 -0
- package/dist/control/reconcile.d.ts.map +1 -0
- package/dist/control/reconcile.js +178 -0
- package/dist/control/records.d.ts +187 -0
- package/dist/control/records.d.ts.map +1 -0
- package/dist/control/records.js +307 -0
- package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
- package/dist/discovery/sandbox/bundle.js +25 -1
- package/dist/engine-facts.d.ts.map +1 -1
- package/dist/engine-facts.js +1 -2
- package/dist/exit-codes.d.ts +48 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +49 -0
- package/dist/forge-check/check.d.ts +63 -0
- package/dist/forge-check/check.d.ts.map +1 -0
- package/dist/forge-check/check.js +139 -0
- package/dist/forge-check/contract.d.ts +152 -0
- package/dist/forge-check/contract.d.ts.map +1 -0
- package/dist/forge-check/contract.js +118 -0
- package/dist/forge-check/forge.d.ts +42 -0
- package/dist/forge-check/forge.d.ts.map +1 -0
- package/dist/forge-check/forge.js +338 -0
- package/dist/forge-check/index.d.ts +24 -0
- package/dist/forge-check/index.d.ts.map +1 -0
- package/dist/forge-check/index.js +23 -0
- package/dist/forge-check/pulumi.d.ts +44 -0
- package/dist/forge-check/pulumi.d.ts.map +1 -0
- package/dist/forge-check/pulumi.js +184 -0
- package/dist/forge-check/read-only.d.ts +26 -0
- package/dist/forge-check/read-only.d.ts.map +1 -0
- package/dist/forge-check/read-only.js +53 -0
- package/dist/forge-check/trust.d.ts +94 -0
- package/dist/forge-check/trust.d.ts.map +1 -0
- package/dist/forge-check/trust.js +532 -0
- package/dist/forge-check/types.d.ts +80 -0
- package/dist/forge-check/types.d.ts.map +1 -0
- package/dist/forge-check/types.js +18 -0
- package/dist/forge-check.d.ts +6 -0
- package/dist/forge-check.d.ts.map +1 -0
- package/dist/forge-check.js +5 -0
- package/dist/gate-decision.d.ts +1 -0
- package/dist/gate-decision.d.ts.map +1 -1
- package/dist/gate-decision.js +2 -0
- package/dist/gate-policy.d.ts +47 -1
- package/dist/gate-policy.d.ts.map +1 -1
- package/dist/gate-policy.js +50 -2
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/lexicon.d.ts +106 -6
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.d.ts +24 -0
- package/dist/lifecycle/adoption-file.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.js +1 -2
- package/dist/lifecycle/cloud-index.d.ts.map +1 -1
- package/dist/lifecycle/cloud-index.js +1 -2
- package/dist/lifecycle/gate-applied.d.ts +6 -0
- package/dist/lifecycle/gate-applied.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.d.ts +29 -0
- package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.js +11 -1
- package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
- package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
- package/dist/lifecycle/gate-pending-by-plan.js +96 -0
- package/dist/lifecycle/gated-request-digest.d.ts +28 -0
- package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
- package/dist/lifecycle/gated-request-digest.js +35 -0
- package/dist/lifecycle/gated-request.d.ts +126 -0
- package/dist/lifecycle/gated-request.d.ts.map +1 -0
- package/dist/lifecycle/gated-request.js +205 -0
- package/dist/lifecycle/identity-match.d.ts +15 -0
- package/dist/lifecycle/identity-match.d.ts.map +1 -1
- package/dist/lifecycle/identity-match.js +11 -6
- package/dist/lifecycle/index-diff.d.ts +40 -0
- package/dist/lifecycle/index-diff.d.ts.map +1 -1
- package/dist/lifecycle/index-diff.js +1 -2
- package/dist/lifecycle/index-document.d.ts.map +1 -1
- package/dist/lifecycle/index-document.js +1 -2
- package/dist/lifecycle/index-import.d.ts +4 -1
- package/dist/lifecycle/index-import.d.ts.map +1 -1
- package/dist/lifecycle/index-import.js +29 -32
- package/dist/lifecycle/ledger-read.d.ts.map +1 -1
- package/dist/lifecycle/ledger-read.js +7 -3
- package/dist/lifecycle/lock-rows.d.ts +76 -0
- package/dist/lifecycle/lock-rows.d.ts.map +1 -0
- package/dist/lifecycle/lock-rows.js +140 -0
- package/dist/lifecycle/query.d.ts +50 -3
- package/dist/lifecycle/query.d.ts.map +1 -1
- package/dist/lifecycle/query.js +97 -6
- package/dist/lifecycle/release-catalog-site.d.ts +66 -0
- package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog-site.js +232 -0
- package/dist/lifecycle/release-catalog.d.ts +201 -0
- package/dist/lifecycle/release-catalog.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog.js +198 -0
- package/dist/lifecycle/release-changelog.d.ts +41 -0
- package/dist/lifecycle/release-changelog.d.ts.map +1 -0
- package/dist/lifecycle/release-changelog.js +38 -0
- package/dist/lifecycle/release-cut.d.ts +1 -0
- package/dist/lifecycle/release-cut.d.ts.map +1 -1
- package/dist/lifecycle/release-cut.js +1 -1
- package/dist/lifecycle/release-ledger.d.ts +16 -0
- package/dist/lifecycle/release-ledger.d.ts.map +1 -1
- package/dist/lifecycle/release-ledger.js +10 -0
- package/dist/lifecycle/release-publish.d.ts +43 -22
- package/dist/lifecycle/release-publish.d.ts.map +1 -1
- package/dist/lifecycle/release-read.d.ts.map +1 -1
- package/dist/lifecycle/release-read.js +3 -0
- package/dist/lifecycle/release-status.d.ts +86 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +136 -0
- package/dist/lifecycle/resource-lock.d.ts +120 -0
- package/dist/lifecycle/resource-lock.d.ts.map +1 -0
- package/dist/lifecycle/resource-lock.js +317 -0
- package/dist/lifecycle/retention.d.ts.map +1 -1
- package/dist/lifecycle/retention.js +3 -0
- package/dist/lifecycle/run-ledger.d.ts.map +1 -1
- package/dist/lifecycle/run-ledger.js +9 -1
- package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
- package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store-s3.js +9 -44
- package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store.js +1 -2
- package/dist/lifecycle/target-lock.d.ts +15 -0
- package/dist/lifecycle/target-lock.d.ts.map +1 -1
- package/dist/lifecycle/target-lock.js +25 -10
- package/dist/mcp/types.d.ts +7 -0
- package/dist/mcp/types.d.ts.map +1 -1
- package/dist/notify-product.d.ts +43 -0
- package/dist/notify-product.d.ts.map +1 -0
- package/dist/notify-product.js +58 -0
- package/dist/notify-relay.d.ts +197 -0
- package/dist/notify-relay.d.ts.map +1 -0
- package/dist/notify-relay.js +321 -0
- package/dist/notify.d.ts +44 -4
- package/dist/notify.d.ts.map +1 -1
- package/dist/notify.js +77 -14
- package/dist/object-store/azure-blob.d.ts +129 -0
- package/dist/object-store/azure-blob.d.ts.map +1 -0
- package/dist/object-store/azure-blob.js +341 -0
- package/dist/object-store/common.d.ts +108 -0
- package/dist/object-store/common.d.ts.map +1 -0
- package/dist/object-store/common.js +80 -0
- package/dist/object-store/errors.d.ts +28 -0
- package/dist/object-store/errors.d.ts.map +1 -0
- package/dist/object-store/errors.js +21 -0
- package/dist/object-store/from-env.d.ts +18 -0
- package/dist/object-store/from-env.d.ts.map +1 -0
- package/dist/object-store/from-env.js +22 -0
- package/dist/object-store/gcs.d.ts +106 -0
- package/dist/object-store/gcs.d.ts.map +1 -0
- package/dist/object-store/gcs.js +393 -0
- package/dist/object-store/index.d.ts +9 -0
- package/dist/object-store/index.d.ts.map +1 -0
- package/dist/object-store/index.js +8 -0
- package/dist/object-store/s3.d.ts +146 -0
- package/dist/object-store/s3.d.ts.map +1 -0
- package/dist/object-store/s3.js +306 -0
- package/dist/op/activities/converge.d.ts.map +1 -1
- package/dist/op/activities/converge.js +2 -1
- package/dist/op/activities/index.d.ts +1 -1
- package/dist/op/activities/index.d.ts.map +1 -1
- package/dist/op/activities/index.js +1 -1
- package/dist/op/activities/review-agent.d.ts +55 -2
- package/dist/op/activities/review-agent.d.ts.map +1 -1
- package/dist/op/activities/review-agent.js +65 -5
- package/dist/op/gate.d.ts +29 -1
- package/dist/op/gate.d.ts.map +1 -1
- package/dist/op/gate.js +59 -23
- package/dist/op/generate-pipeline.d.ts.map +1 -1
- package/dist/op/generate-pipeline.js +7 -1
- package/dist/op/index.d.ts +12 -1
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +7 -1
- package/dist/op/op-waves-after-plan.d.ts +137 -0
- package/dist/op/op-waves-after-plan.d.ts.map +1 -0
- package/dist/op/op-waves-after-plan.js +163 -0
- package/dist/op/op-waves-capability-spec.d.ts +55 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +94 -0
- package/dist/op/op-waves-capability.d.ts +197 -0
- package/dist/op/op-waves-capability.d.ts.map +1 -0
- package/dist/op/op-waves-capability.js +311 -0
- package/dist/op/op-waves-events.d.ts +54 -0
- package/dist/op/op-waves-events.d.ts.map +1 -0
- package/dist/op/op-waves-events.js +122 -0
- package/dist/op/op-waves-notify.d.ts +7 -1
- package/dist/op/op-waves-notify.d.ts.map +1 -1
- package/dist/op/op-waves-notify.js +35 -16
- package/dist/op/op-waves-release-port.d.ts +18 -0
- package/dist/op/op-waves-release-port.d.ts.map +1 -0
- package/dist/op/op-waves-release-port.js +61 -0
- package/dist/op/op-waves-release.d.ts +92 -0
- package/dist/op/op-waves-release.d.ts.map +1 -0
- package/dist/op/op-waves-release.js +97 -0
- package/dist/op/op-waves-run.d.ts +175 -4
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +981 -41
- package/dist/op/op-waves-stand-down.d.ts +60 -0
- package/dist/op/op-waves-stand-down.d.ts.map +1 -0
- package/dist/op/op-waves-stand-down.js +97 -0
- package/dist/op/op-waves.d.ts +152 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +161 -17
- package/dist/op/runtime.d.ts +91 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +19 -0
- package/dist/op/stage-hooks.d.ts +45 -7
- package/dist/op/stage-hooks.d.ts.map +1 -1
- package/dist/op/stage-hooks.js +61 -3
- package/dist/op/steward-beside.d.ts.map +1 -1
- package/dist/op/steward-beside.js +2 -1
- package/dist/op/types.d.ts +2 -2
- package/dist/op/types.d.ts.map +1 -1
- package/dist/op/types.js +3 -2
- package/dist/otlp-metrics.d.ts +38 -0
- package/dist/otlp-metrics.d.ts.map +1 -0
- package/dist/otlp-metrics.js +82 -0
- package/dist/otlp.d.ts +249 -0
- package/dist/otlp.d.ts.map +1 -0
- package/dist/otlp.js +426 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -0
- package/dist/policy-packs.d.ts +69 -0
- package/dist/policy-packs.d.ts.map +1 -0
- package/dist/policy-packs.js +205 -0
- package/dist/policy-source.d.ts +51 -0
- package/dist/policy-source.d.ts.map +1 -0
- package/dist/policy-source.js +103 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +92 -0
- package/dist/pr-loop.d.ts +149 -11
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +283 -44
- package/dist/pr-post.d.ts +16 -0
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +26 -1
- package/dist/pr-report-url.d.ts +32 -4
- package/dist/pr-report-url.d.ts.map +1 -1
- package/dist/pr-report-url.js +46 -5
- package/dist/pr-requires.d.ts +13 -2
- package/dist/pr-requires.d.ts.map +1 -1
- package/dist/pr-requires.js +14 -0
- package/dist/release-floors.d.ts +1 -1
- package/dist/release-floors.js +1 -1
- package/dist/run-event.d.ts +26 -1
- package/dist/run-event.d.ts.map +1 -1
- package/dist/run-event.js +4 -1
- package/dist/sorted-json.d.ts +10 -0
- package/dist/sorted-json.d.ts.map +1 -0
- package/dist/sorted-json.js +14 -0
- package/dist/terraform/credentials.d.ts +59 -0
- package/dist/terraform/credentials.d.ts.map +1 -0
- package/dist/terraform/credentials.js +149 -0
- package/dist/utils.d.ts +1 -4
- package/dist/utils.d.ts.map +1 -1
- package/dist/utils.js +1 -9
- package/dist/wave-runtime.d.ts +1 -1
- package/dist/wave-runtime.js +2 -2
- package/dist/wave-runtime.mjs +390 -285
- package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
- package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
- package/dist/workspace/ci-lock-grain.d.ts +12 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +27 -0
- package/dist/workspace/ci-run.d.ts +2 -1
- package/dist/workspace/ci-run.d.ts.map +1 -1
- package/dist/workspace/ci-run.js +6 -3
- package/dist/workspace/declaration.d.ts +16 -4
- package/dist/workspace/declaration.d.ts.map +1 -1
- package/dist/workspace/declaration.js +5 -2
- package/dist/workspace/declaration.schema.json +27 -3
- package/dist/workspace/drift-cli.d.ts.map +1 -1
- package/dist/workspace/drift-cli.js +8 -3
- package/dist/workspace/exit-cli.d.ts +1 -1
- package/dist/workspace/exit-cli.d.ts.map +1 -1
- package/dist/workspace/exit-cli.js +2 -1
- package/dist/workspace/import-fetch.d.ts +4 -2
- package/dist/workspace/import-fetch.d.ts.map +1 -1
- package/dist/workspace/import-fetch.js +4 -2
- package/dist/workspace/import-init.d.ts.map +1 -1
- package/dist/workspace/import-init.js +4 -2
- package/dist/workspace/ledger.schema.json +7 -3
- package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
- package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
- package/dist/workspace/lineage-upgrade-cli.js +2 -1
- package/dist/workspace/pr-report.schema.json +74 -3
- package/dist/workspace/promote.d.ts +1 -1
- package/dist/workspace/promote.d.ts.map +1 -1
- package/dist/workspace/promote.js +2 -1
- package/dist/workspace/records-cli.d.ts +2 -2
- package/dist/workspace/records-cli.d.ts.map +1 -1
- package/dist/workspace/records-cli.js +3 -2
- package/dist/workspace/release-catalog.schema.json +277 -0
- package/dist/workspace/run-event.schema.json +18 -1
- package/dist/workspace/work-cli.d.ts +3 -1
- package/dist/workspace/work-cli.d.ts.map +1 -1
- package/dist/workspace/work-cli.js +7 -2
- package/dist/workspace/workspace-run.d.ts.map +1 -1
- package/dist/workspace/workspace-run.js +2 -1
- package/package.json +21 -1
- package/src/__fixtures__/estate-ledger.ts +101 -0
- package/src/__fixtures__/oidc-emulator.ts +31 -2
- package/src/__fixtures__/product-words.ts +44 -0
- package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/src/__golden__/wave-loop/op-held-on.json +28 -7
- package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/src/__golden__/wave-loop/op-overridden.json +28 -7
- package/src/__golden__/wave-loop/op-per-run.json +20 -4
- package/src/__golden__/wave-loop/op-point.json +18 -4
- package/src/__golden__/wave-loop/op-pr-review.json +10 -2
- package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/src/__golden__/wave-loop/op-spend.json +10 -2
- package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/src/__golden__/wave-loop/op-wide.json +20 -4
- package/src/bucket-check/azure.ts +307 -0
- package/src/bucket-check/bucket-check.test.ts +210 -0
- package/src/bucket-check/fixtures/azure.json +153 -0
- package/src/bucket-check/fixtures/gcs.json +148 -0
- package/src/bucket-check/fixtures/s3.json +277 -0
- package/src/bucket-check/gcs.ts +257 -0
- package/src/bucket-check/index.ts +61 -0
- package/src/bucket-check/s3.ts +433 -0
- package/src/bucket-check/types.ts +75 -0
- package/src/bucket-check/wire.ts +50 -0
- package/src/bucket-check.ts +5 -0
- package/src/capabilities/templates.test.ts +2 -3
- package/src/capabilities/templates.ts +1 -2
- package/src/cdk/advise.test.ts +1 -1
- package/src/change-set-bundle.test.ts +0 -1
- package/src/change-set.ts +2 -3
- package/src/ci-agent.test.ts +348 -0
- package/src/ci-agent.ts +1026 -0
- package/src/ci-control.ts +174 -0
- package/src/ci-estate/delivery.ts +433 -0
- package/src/ci-estate/overdue.ts +81 -0
- package/src/ci-estate/page.ts +343 -0
- package/src/ci-estate/rows.ts +251 -0
- package/src/ci-estate.test.ts +281 -0
- package/src/ci-estate.ts +176 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +55 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +6 -2
- package/src/ci-identity.ts +124 -22
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +536 -0
- package/src/ci-product.ts +174 -0
- package/src/ci-shared-reads.test.ts +145 -0
- package/src/cli/commands/audit.test.ts +1 -1
- package/src/cli/commands/audit.ts +3 -2
- package/src/cli/commands/carve.test.ts +1 -1
- package/src/cli/commands/carve.ts +2 -2
- package/src/cli/commands/init.ts +3 -1
- package/src/cli/component-wave-args.test.ts +16 -0
- package/src/cli/handlers/agent.ts +126 -0
- package/src/cli/handlers/approve-confirm.test.ts +276 -0
- package/src/cli/handlers/approve-confirm.ts +200 -0
- package/src/cli/handlers/approve.ts +18 -1
- package/src/cli/handlers/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +44 -1
- package/src/cli/handlers/ci-check.ts +33 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -0
- package/src/cli/handlers/fan-out.test.ts +10 -10
- package/src/cli/handlers/fan-out.ts +5 -0
- package/src/cli/handlers/gate-pending.ts +46 -0
- package/src/cli/handlers/init.ts +1 -0
- package/src/cli/handlers/ledger.ts +1 -1
- package/src/cli/handlers/lifecycle-drift.ts +7 -2
- package/src/cli/handlers/lock.test.ts +29 -2
- package/src/cli/handlers/lock.ts +66 -6
- package/src/cli/handlers/notify-relay.ts +130 -0
- package/src/cli/handlers/pr-before-merge.test.ts +2 -1
- package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
- package/src/cli/handlers/pr-env.ts +48 -11
- package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
- package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
- package/src/cli/handlers/pr-waves.test.ts +8 -2
- package/src/cli/handlers/pr.test.ts +8 -8
- package/src/cli/handlers/pr.ts +655 -205
- package/src/cli/handlers/promote.test.ts +5 -5
- package/src/cli/handlers/promote.ts +22 -2
- package/src/cli/handlers/release.ts +2 -0
- package/src/cli/handlers/run-components-exit.test.ts +7 -7
- package/src/cli/handlers/run-wave.ts +65 -1
- package/src/cli/handlers/run.test.ts +6 -4
- package/src/cli/handlers/run.ts +86 -1
- package/src/cli/handlers/serve.ts +10 -1
- package/src/cli/main.ts +126 -13
- package/src/cli/mcp/ledger-tools.ts +126 -0
- package/src/cli/mcp/product-tools.test.ts +123 -0
- package/src/cli/mcp/product-tools.ts +129 -0
- package/src/cli/mcp/read-only.test.ts +134 -0
- package/src/cli/mcp/read-only.ts +68 -0
- package/src/cli/mcp/report-tools.ts +135 -0
- package/src/cli/mcp/server.test.ts +5 -4
- package/src/cli/mcp/server.ts +90 -16
- package/src/cli/mcp-config.ts +8 -3
- package/src/cli/parse-args.ts +42 -2
- package/src/cli/registry.ts +35 -0
- package/src/cloud-lister/sigv4.ts +80 -23
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +141 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability.ts +130 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +252 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +83 -0
- package/src/components/cli-support.ts +23 -2
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +38 -5
- package/src/components/fan-out-run.ts +68 -18
- package/src/components/groups.ts +17 -2
- package/src/components/pr-comment-preview.test.ts +54 -0
- package/src/components/pr-env-ledger.test.ts +9 -0
- package/src/components/pr-env-ledger.ts +43 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +8 -0
- package/src/components/pr-env-run.test.ts +19 -0
- package/src/components/pr-env-run.ts +12 -2
- package/src/components/pr-environment.test.ts +29 -0
- package/src/components/pr-environment.ts +39 -7
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +274 -9
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +1 -1
- package/src/components/pr-run.ts +121 -5
- package/src/components/pr-targets.test.ts +35 -0
- package/src/components/pr-targets.ts +45 -0
- package/src/components/product-pipeline.test.ts +200 -0
- package/src/components/product-pipeline.ts +341 -0
- package/src/components/promote.ts +10 -1
- package/src/components/release-compile.ts +87 -1
- package/src/components/release-promote.ts +65 -1
- package/src/components/repo-lock.ts +52 -0
- package/src/components/row-lease.test.ts +490 -0
- package/src/components/row-lease.ts +167 -0
- package/src/components/wave-plan-policy.test.ts +19 -0
- package/src/components/wave-plan.ts +78 -4
- package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
- package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
- package/src/control/applied.test.ts +148 -0
- package/src/control/applied.ts +191 -0
- package/src/control/consumers.test.ts +129 -0
- package/src/control/consumers.ts +192 -0
- package/src/control/control.test.ts +302 -0
- package/src/control/dispatch.ts +699 -0
- package/src/control/edges.test.ts +112 -0
- package/src/control/edges.ts +164 -0
- package/src/control/note-checkout.test.ts +91 -0
- package/src/control/reconcile.ts +250 -0
- package/src/control/records.ts +395 -0
- package/src/discovery/sandbox/bundle.ts +25 -1
- package/src/engine-facts.test.ts +2 -3
- package/src/engine-facts.ts +1 -2
- package/src/exit-codes.test.ts +31 -0
- package/src/exit-codes.ts +55 -0
- package/src/forge-check/check.ts +155 -0
- package/src/forge-check/contract.ts +215 -0
- package/src/forge-check/forge-check.test.ts +427 -0
- package/src/forge-check/forge.ts +318 -0
- package/src/forge-check/index.ts +43 -0
- package/src/forge-check/pulumi.ts +192 -0
- package/src/forge-check/read-only.ts +56 -0
- package/src/forge-check/trust.ts +527 -0
- package/src/forge-check/types.ts +78 -0
- package/src/forge-check.ts +5 -0
- package/src/gate-decision-bundle.test.ts +13 -0
- package/src/gate-decision.ts +3 -0
- package/src/gate-policy.ts +92 -3
- package/src/gated-waves-bundle.test.ts +0 -1
- package/src/index.ts +2 -0
- package/src/lexicon.ts +95 -6
- package/src/lifecycle/adoption-file.ts +1 -2
- package/src/lifecycle/cloud-index.test.ts +2 -3
- package/src/lifecycle/cloud-index.ts +1 -2
- package/src/lifecycle/control-entries-ledger.test.ts +70 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +36 -1
- package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
- package/src/lifecycle/gate-pending-by-plan.ts +133 -0
- package/src/lifecycle/gated-request-digest.ts +49 -0
- package/src/lifecycle/gated-request-ledger.test.ts +53 -0
- package/src/lifecycle/gated-request.ts +280 -0
- package/src/lifecycle/identity-match.ts +25 -6
- package/src/lifecycle/index-diff.ts +1 -2
- package/src/lifecycle/index-document.ts +1 -2
- package/src/lifecycle/index-import.test.ts +14 -0
- package/src/lifecycle/index-import.ts +54 -34
- package/src/lifecycle/ledger-read.ts +7 -3
- package/src/lifecycle/lock-rows.test.ts +109 -0
- package/src/lifecycle/lock-rows.ts +167 -0
- package/src/lifecycle/publish-target-context.test.ts +108 -0
- package/src/lifecycle/query.test.ts +2 -3
- package/src/lifecycle/query.ts +109 -7
- package/src/lifecycle/release-catalog-site.test.ts +142 -0
- package/src/lifecycle/release-catalog-site.ts +291 -0
- package/src/lifecycle/release-catalog.test.ts +193 -0
- package/src/lifecycle/release-catalog.ts +353 -0
- package/src/lifecycle/release-changelog.test.ts +70 -0
- package/src/lifecycle/release-changelog.ts +71 -0
- package/src/lifecycle/release-cut.ts +2 -2
- package/src/lifecycle/release-ledger.ts +20 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +186 -0
- package/src/lifecycle/release-status.ts +176 -0
- package/src/lifecycle/resource-lock.test.ts +175 -0
- package/src/lifecycle/resource-lock.ts +354 -0
- package/src/lifecycle/retention.ts +2 -0
- package/src/lifecycle/run-ledger.ts +7 -1
- package/src/lifecycle/snapshot-store-s3.ts +9 -45
- package/src/lifecycle/snapshot-store.ts +1 -2
- package/src/lifecycle/target-lock.ts +24 -9
- package/src/mcp/types.ts +7 -0
- package/src/notify-product.ts +76 -0
- package/src/notify-relay.test.ts +213 -0
- package/src/notify-relay.ts +407 -0
- package/src/notify.ts +95 -14
- package/src/object-store/azure-blob.ts +374 -0
- package/src/object-store/common.ts +133 -0
- package/src/object-store/errors.ts +26 -0
- package/src/object-store/from-env.ts +36 -0
- package/src/object-store/gcs.ts +436 -0
- package/src/object-store/index.ts +8 -0
- package/src/object-store/object-store.test.ts +130 -0
- package/src/object-store/s3.ts +350 -0
- package/src/op/activities/converge.ts +2 -1
- package/src/op/activities/index.ts +1 -1
- package/src/op/activities/review-agent.open.test.ts +78 -0
- package/src/op/activities/review-agent.test.ts +13 -0
- package/src/op/activities/review-agent.ts +89 -5
- package/src/op/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +21 -0
- package/src/op/op-waves-after-plan.test.ts +276 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +113 -0
- package/src/op/op-waves-capability.test.ts +217 -0
- package/src/op/op-waves-capability.ts +370 -0
- package/src/op/op-waves-events.ts +135 -0
- package/src/op/op-waves-notify-words.test.ts +149 -0
- package/src/op/op-waves-notify.ts +41 -16
- package/src/op/op-waves-pull-request.test.ts +142 -0
- package/src/op/op-waves-release-port.ts +64 -0
- package/src/op/op-waves-release.test.ts +209 -0
- package/src/op/op-waves-release.ts +133 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1142 -49
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +108 -0
- package/src/op/op-waves-trace.test.ts +205 -0
- package/src/op/op-waves.test.ts +112 -0
- package/src/op/op-waves.ts +261 -20
- package/src/op/runtime.ts +104 -0
- package/src/op/stage-hooks-hold-record.test.ts +41 -0
- package/src/op/stage-hooks.ts +91 -12
- package/src/op/steward-beside.ts +2 -1
- package/src/op/types.ts +3 -2
- package/src/otlp-metrics.ts +96 -0
- package/src/otlp.test.ts +243 -0
- package/src/otlp.ts +544 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +112 -0
- package/src/pr-forge.ts +123 -0
- package/src/pr-loop-bundle.test.ts +6 -2
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.ts +371 -52
- package/src/pr-post.ts +32 -1
- package/src/pr-report-url.ts +62 -6
- package/src/pr-requires.test.ts +37 -1
- package/src/pr-requires.ts +16 -2
- package/src/product-subpaths-plain-node.e2e.test.ts +211 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +29 -1
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +8 -0
- package/src/terraform/credentials.test.ts +77 -0
- package/src/terraform/credentials.ts +162 -0
- package/src/utils.ts +2 -11
- package/src/wave-loop-golden.test.ts +2 -1
- package/src/wave-runtime.ts +2 -2
- package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
- package/src/workspace/ci-lock-grain.test.ts +31 -0
- package/src/workspace/ci-lock-grain.ts +30 -0
- package/src/workspace/ci-report-url.test.ts +1 -1
- package/src/workspace/ci-run.test.ts +1 -1
- package/src/workspace/ci-run.ts +6 -3
- package/src/workspace/declaration.schema.json +27 -3
- package/src/workspace/declaration.test.ts +1 -1
- package/src/workspace/declaration.ts +26 -10
- package/src/workspace/drift-cli.ts +8 -3
- package/src/workspace/exit-cli.ts +2 -1
- package/src/workspace/import-fetch.ts +4 -2
- package/src/workspace/import-init.ts +4 -2
- package/src/workspace/ledger.schema.json +7 -3
- package/src/workspace/lineage-upgrade-cli.ts +2 -1
- package/src/workspace/pr-report.schema.json +74 -3
- package/src/workspace/promote.ts +2 -1
- package/src/workspace/records-cli.ts +3 -2
- package/src/workspace/release-catalog.schema.json +277 -0
- package/src/workspace/run-event.schema.json +18 -1
- package/src/workspace/work-cli.ts +8 -2
- package/src/workspace/workspace-run.ts +2 -1
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* After-plan hooks in the wave job's process (#4614). A product that runs
|
|
3
|
+
* chant in process (`runOpWave`, or a bin built on `runChantInProcess`)
|
|
4
|
+
* passes `afterPlan` to build what it builds from each run's plan: its wave
|
|
5
|
+
* report, its own policy rows, the plan files its other jobs read. Each hook
|
|
6
|
+
* is called once per planned run, in the order the wave lists its runs,
|
|
7
|
+
* after chant's wave holds ran and before the set digest and the gate. It
|
|
8
|
+
* gets the run's plan digest, its `{plan}` file and, when the plan names
|
|
9
|
+
* one, the engine's plan document (`{planJson}`), with the rows chant's
|
|
10
|
+
* `holds.policy` gave the run.
|
|
11
|
+
*
|
|
12
|
+
* A hook may answer with policy rows and files. A `denied` row denies the
|
|
13
|
+
* run as a policy denial does (an override of its rules then counts), a
|
|
14
|
+
* `held` row holds the wave for a person, and every row and file goes on the
|
|
15
|
+
* job's run record (`wave.plans`). A hook that throws follows its
|
|
16
|
+
* `onFailure`: `fail` (the default) fails the wave before the gate, so
|
|
17
|
+
* nothing is approved or applied; `approve` holds the wave for an approval
|
|
18
|
+
* of its set digest, as a command hook's does.
|
|
19
|
+
*
|
|
20
|
+
* The spec's command hooks at `hooks.after.plan` keep running where they
|
|
21
|
+
* ran: after the set digest, before the gate settles. A `perRun` one gets
|
|
22
|
+
* `{planJson}`, `CHANT_PLAN_DIGEST` and `CHANT_PLAN_JSON` the same way.
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
import { isAbsolute } from "node:path";
|
|
26
|
+
import type { ChangeSetPart } from "../change-set";
|
|
27
|
+
import type { OpRunPolicyRow } from "./runtime";
|
|
28
|
+
import { OP_WAVE_HOOK_FAILURES, opWaveHookRuns, type OpWaveHookFailure } from "./op-waves";
|
|
29
|
+
import type { OpWaveHookOutcome } from "./stage-hooks";
|
|
30
|
+
|
|
31
|
+
/** One planned run, as an after-plan hook in the job's process sees it (#4614). */
|
|
32
|
+
export interface OpWaveAfterPlanRun {
|
|
33
|
+
/** The spec's name and `op`. */
|
|
34
|
+
spec: string;
|
|
35
|
+
op: string;
|
|
36
|
+
/** The wave, 1-based, and its name. */
|
|
37
|
+
wave: number;
|
|
38
|
+
waveName: string;
|
|
39
|
+
/** The job planning it: `wave` for a whole wave, `decide` for a wide wave's deciding job, `share` or `group` for its apply jobs. */
|
|
40
|
+
job: "wave" | "decide" | "share" | "group";
|
|
41
|
+
target: string;
|
|
42
|
+
/** The run's own op. */
|
|
43
|
+
runOp: string;
|
|
44
|
+
planDigest: string;
|
|
45
|
+
/** The run's plan file, relative to the job's directory: `{plan}`. */
|
|
46
|
+
plan: string;
|
|
47
|
+
/** The engine's plan document, when the plan names one (`artifact.planJson`): `{planJson}`. */
|
|
48
|
+
planJson?: string;
|
|
49
|
+
/** The capability's artifact, for a run planned through a `step`. */
|
|
50
|
+
artifact?: unknown;
|
|
51
|
+
/** The run's change-set part, when its plan gave one. */
|
|
52
|
+
changeSet?: ChangeSetPart;
|
|
53
|
+
empty: boolean;
|
|
54
|
+
destructive: boolean;
|
|
55
|
+
/** The rows chant's `holds.policy` gave the run (source `ci.policy`), empty when no policy ran. */
|
|
56
|
+
policy: OpRunPolicyRow[];
|
|
57
|
+
/** The job's directory. */
|
|
58
|
+
cwd: string;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** What an after-plan hook adds to its run (#4614). */
|
|
62
|
+
export interface OpWaveAfterPlanResult {
|
|
63
|
+
/** The product's own policy rows. `denied` denies the run and `held` holds the wave. */
|
|
64
|
+
policy?: OpRunPolicyRow[];
|
|
65
|
+
/** Files the hook wrote for the run, relative to the job's directory. */
|
|
66
|
+
files?: string[];
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** An after-plan hook in the wave job's process (#4614). */
|
|
70
|
+
export interface OpWaveAfterPlanHook {
|
|
71
|
+
/** The hook's name in the log, the result's hooks and the run record. */
|
|
72
|
+
name: string;
|
|
73
|
+
/** Default `fail`. */
|
|
74
|
+
onFailure?: OpWaveHookFailure;
|
|
75
|
+
/** The runs it is for, as a command hook's `targets`. Default: every run. */
|
|
76
|
+
targets?: string[];
|
|
77
|
+
run(planned: OpWaveAfterPlanRun): OpWaveAfterPlanResult | void | Promise<OpWaveAfterPlanResult | void>;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
const ROW_RESULTS: ReadonlyArray<OpRunPolicyRow["result"]> = ["passed", "warned", "denied", "held"];
|
|
81
|
+
|
|
82
|
+
/** What is wrong with `afterPlan`, empty when nothing is. */
|
|
83
|
+
export function opWaveAfterPlanProblems(hooks: unknown): string[] {
|
|
84
|
+
if (hooks === undefined) return [];
|
|
85
|
+
const list = Array.isArray(hooks) ? hooks : [hooks];
|
|
86
|
+
const problems: string[] = [];
|
|
87
|
+
list.forEach((h: unknown, i) => {
|
|
88
|
+
const at = `afterPlan[${i}]`;
|
|
89
|
+
const hook = h as Partial<OpWaveAfterPlanHook> | null;
|
|
90
|
+
if (!hook || typeof hook !== "object") return void problems.push(`${at} must be { name, run, onFailure?, targets? }`);
|
|
91
|
+
if (typeof hook.name !== "string" || hook.name.trim() === "") problems.push(`${at} needs a name`);
|
|
92
|
+
if (typeof hook.run !== "function") problems.push(`${at} needs a run function`);
|
|
93
|
+
if (hook.onFailure !== undefined && !OP_WAVE_HOOK_FAILURES.includes(hook.onFailure)) problems.push(`${at} has onFailure "${String(hook.onFailure)}"; use ${OP_WAVE_HOOK_FAILURES.join(" or ")}`);
|
|
94
|
+
if (hook.targets !== undefined && (!Array.isArray(hook.targets) || hook.targets.length === 0 || !hook.targets.every((t) => typeof t === "string" && t !== ""))) problems.push(`${at}.targets must be a non-empty list of targets or patterns`);
|
|
95
|
+
});
|
|
96
|
+
return problems;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** What is wrong with one answer of a hook, empty when nothing is. */
|
|
100
|
+
export function opWaveAfterPlanResultProblems(value: unknown): string[] {
|
|
101
|
+
if (value === undefined || value === null) return [];
|
|
102
|
+
if (typeof value !== "object" || Array.isArray(value)) return ["the answer must be { policy?, files? }"];
|
|
103
|
+
const r = value as { policy?: unknown; files?: unknown };
|
|
104
|
+
const problems: string[] = [];
|
|
105
|
+
if (r.policy !== undefined) {
|
|
106
|
+
if (!Array.isArray(r.policy)) problems.push("`policy` must be a list of rows");
|
|
107
|
+
else r.policy.forEach((row: unknown, i) => {
|
|
108
|
+
const x = row as Partial<OpRunPolicyRow> | null;
|
|
109
|
+
if (!x || typeof x !== "object") return void problems.push(`policy[${i}] must be { source, result, rules, reason? }`);
|
|
110
|
+
if (typeof x.source !== "string" || x.source === "") problems.push(`policy[${i}] needs a source`);
|
|
111
|
+
if (!ROW_RESULTS.includes(x.result as OpRunPolicyRow["result"])) problems.push(`policy[${i}] has result ${JSON.stringify(x.result)}; use ${ROW_RESULTS.join(", ")}`);
|
|
112
|
+
if (!Array.isArray(x.rules) || !x.rules.every((t) => typeof t === "string" && t.trim() !== "")) problems.push(`policy[${i}].rules must be a list of rule ids`);
|
|
113
|
+
else if ((x.result === "denied" || x.result === "held") && x.rules.length === 0) problems.push(`policy[${i}] is ${x.result} and names no rule, which an override or an approval would have to name`);
|
|
114
|
+
if (x.reason !== undefined && typeof x.reason !== "string") problems.push(`policy[${i}].reason must be a string`);
|
|
115
|
+
});
|
|
116
|
+
}
|
|
117
|
+
if (r.files !== undefined && (!Array.isArray(r.files) || !r.files.every((f) => typeof f === "string" && f !== "" && !isAbsolute(f) && !f.split("/").includes("..")))) {
|
|
118
|
+
problems.push("`files` must be paths inside the job's directory, relative to it");
|
|
119
|
+
}
|
|
120
|
+
return problems;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
/** What one run's hooks came to. */
|
|
124
|
+
export interface OpWaveAfterPlanRunOutcome {
|
|
125
|
+
/** The hooks' rows, in order. */
|
|
126
|
+
policy: OpRunPolicyRow[];
|
|
127
|
+
files: string[];
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/** What the after-plan hooks in the job's process came to (#4614). */
|
|
131
|
+
export interface OpWaveAfterPlanOutcome {
|
|
132
|
+
/** Set when a hook with `onFailure: fail` failed; nothing after it ran. */
|
|
133
|
+
failed?: string;
|
|
134
|
+
/** The `onFailure: approve` hooks that failed, each with its run. */
|
|
135
|
+
holds: string[];
|
|
136
|
+
outcomes: OpWaveHookOutcome[];
|
|
137
|
+
/** Each run's rows and files, by target, for the runs a hook answered. */
|
|
138
|
+
runs: Map<string, OpWaveAfterPlanRunOutcome>;
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/**
|
|
142
|
+
* Call each hook once per run it is for, hook by hook, each over the runs
|
|
143
|
+
* in the wave's order (#4614). A hook that throws, or answers with a shape
|
|
144
|
+
* chant cannot read, failed: under `fail` nothing after it runs, under
|
|
145
|
+
* `approve` it holds the wave and the rest go on.
|
|
146
|
+
*/
|
|
147
|
+
export async function runOpWaveAfterPlanHooks(
|
|
148
|
+
hooks: readonly OpWaveAfterPlanHook[],
|
|
149
|
+
runs: readonly OpWaveAfterPlanRun[],
|
|
150
|
+
log: (line: string) => void,
|
|
151
|
+
): Promise<OpWaveAfterPlanOutcome> {
|
|
152
|
+
const out: OpWaveAfterPlanOutcome = { holds: [], outcomes: [], runs: new Map() };
|
|
153
|
+
for (const hook of hooks) {
|
|
154
|
+
for (const run of opWaveHookRuns(hook, runs)) {
|
|
155
|
+
const label = `after-plan hook ${hook.name} (${run.target})`;
|
|
156
|
+
let problem: string | undefined;
|
|
157
|
+
let answer: OpWaveAfterPlanResult | void = undefined;
|
|
158
|
+
try {
|
|
159
|
+
answer = await hook.run(run);
|
|
160
|
+
const wrong = opWaveAfterPlanResultProblems(answer);
|
|
161
|
+
if (wrong.length > 0) problem = `${label} answered with ${wrong.join("; ")}`;
|
|
162
|
+
} catch (err) {
|
|
163
|
+
problem = `${label} failed: ${err instanceof Error ? err.message : String(err)}`;
|
|
164
|
+
}
|
|
165
|
+
const base = { moment: "after-plan" as const, name: hook.name, target: run.target };
|
|
166
|
+
if (problem === undefined) {
|
|
167
|
+
out.outcomes.push({ ...base, exit: 0, outcome: "passed" });
|
|
168
|
+
if (answer && (answer.policy?.length || answer.files?.length)) {
|
|
169
|
+
const got = out.runs.get(run.target) ?? { policy: [], files: [] };
|
|
170
|
+
for (const row of answer.policy ?? []) got.policy.push({ source: row.source, result: row.result, rules: [...new Set(row.rules)].sort(), ...(row.reason ? { reason: row.reason } : {}) });
|
|
171
|
+
for (const f of answer.files ?? []) if (!got.files.includes(f)) got.files.push(f);
|
|
172
|
+
out.runs.set(run.target, got);
|
|
173
|
+
}
|
|
174
|
+
continue;
|
|
175
|
+
}
|
|
176
|
+
if (hook.onFailure === "approve") {
|
|
177
|
+
out.outcomes.push({ ...base, exit: 1, outcome: "held" });
|
|
178
|
+
out.holds.push(label);
|
|
179
|
+
log(`${problem}, so wave ${run.wave} (${run.waveName}) waits for an approval of its set digest`);
|
|
180
|
+
continue;
|
|
181
|
+
}
|
|
182
|
+
out.outcomes.push({ ...base, exit: 1, outcome: "failed" });
|
|
183
|
+
out.failed = problem;
|
|
184
|
+
log(problem);
|
|
185
|
+
return out;
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
return out;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/** Fold policy rows into a run's denial and hold: the rules of every `denied` row, and of every `held` row. */
|
|
192
|
+
export function foldPolicyRows(
|
|
193
|
+
rows: readonly OpRunPolicyRow[],
|
|
194
|
+
now: { denied?: { rules: string[]; reason?: string }; held?: { rules: string[]; reason?: string } },
|
|
195
|
+
): { denied?: { rules: string[]; reason?: string }; held?: { rules: string[]; reason?: string } } {
|
|
196
|
+
const fold = (kind: "denied" | "held", was?: { rules: string[]; reason?: string }) => {
|
|
197
|
+
const mine = rows.filter((r) => r.result === kind);
|
|
198
|
+
if (mine.length === 0) return was;
|
|
199
|
+
const rules = [...new Set([...(was?.rules ?? []), ...mine.flatMap((r) => r.rules)])].sort();
|
|
200
|
+
const reason = [was?.reason, ...mine.map((r) => r.reason)].filter((x): x is string => !!x).join("; ");
|
|
201
|
+
return { rules, ...(reason ? { reason } : {}) };
|
|
202
|
+
};
|
|
203
|
+
const denied = fold("denied", now.denied);
|
|
204
|
+
const held = fold("held", now.held);
|
|
205
|
+
return { ...(denied ? { denied } : {}), ...(held ? { held } : {}) };
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
/**
|
|
209
|
+
* What a product's bin hands `chant run wave` when it runs chant in process
|
|
210
|
+
* (#4614): `runChantInProcess(["run", "wave", ...], words, { wave })`. The
|
|
211
|
+
* job then calls the product's after-plan hooks, and plans and applies a
|
|
212
|
+
* `step` through the product's own capability registry when it gives one.
|
|
213
|
+
*/
|
|
214
|
+
export interface ProductWaveHook {
|
|
215
|
+
afterPlan?: OpWaveAfterPlanHook | readonly OpWaveAfterPlanHook[];
|
|
216
|
+
capabilities?: import("../components/capability").CapabilityRegistry;
|
|
217
|
+
/** How the spec's command hooks run, when they call back into the product's process (`RunOpWaveOptions.hookExec`). */
|
|
218
|
+
hookExec?: import("./stage-hooks").OpWaveAsyncExec;
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
let activeWave: ProductWaveHook | undefined;
|
|
222
|
+
|
|
223
|
+
/** The product's wave hook while a command it runs in process runs, else undefined. */
|
|
224
|
+
export function activeProductWaveHook(): ProductWaveHook | undefined {
|
|
225
|
+
return activeWave;
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
/** Run `fn` with `hook` active, and put the earlier one back after it settles. */
|
|
229
|
+
export async function withProductWaveHook<T>(hook: ProductWaveHook | undefined, fn: () => Promise<T>): Promise<T> {
|
|
230
|
+
if (!hook) return fn();
|
|
231
|
+
const was = activeWave;
|
|
232
|
+
activeWave = hook;
|
|
233
|
+
try {
|
|
234
|
+
return await fn();
|
|
235
|
+
} finally {
|
|
236
|
+
activeWave = was;
|
|
237
|
+
}
|
|
238
|
+
}
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The settings half of op waves through capabilities (#4545): the `step` and
|
|
3
|
+
* `holds` shapes and their checks. `./op-waves.ts` checks a spec with these,
|
|
4
|
+
* and this file imports nothing at run time, so the spec module (and every
|
|
5
|
+
* bundle that holds it: the gate decision, the stage hooks) stays without the
|
|
6
|
+
* capability registry, the config loader and the policy runner that
|
|
7
|
+
* `./op-waves-capability.ts` loads. See that file for the step and the holds.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import type { OpWavesSpec } from "./op-waves";
|
|
11
|
+
|
|
12
|
+
/** A capability step a wave plans and applies each run through (#4545): `{ kind, ...input }`. */
|
|
13
|
+
export interface OpWaveStep {
|
|
14
|
+
/** The capability's kind, such as `terraform-apply` or `pulumi-up`. */
|
|
15
|
+
kind: string;
|
|
16
|
+
/** The step's input. Each string has `{target}`, `{op}` and `{wave}` filled per run. */
|
|
17
|
+
[field: string]: unknown;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/** The estimate's shape a cost hold reads. */
|
|
21
|
+
export const OP_WAVE_COST_FORMATS = ["infracost", "chant"] as const;
|
|
22
|
+
export type OpWaveCostFormat = (typeof OP_WAVE_COST_FORMATS)[number];
|
|
23
|
+
|
|
24
|
+
/** A cost hold (#4545): an estimator per run, and the monthly change over which the wave waits. */
|
|
25
|
+
export interface OpWaveCostHold {
|
|
26
|
+
/**
|
|
27
|
+
* Argv, run once per run that changes something. `{target}` and `{plan}`
|
|
28
|
+
* (the run's plan file, as hooks get it) are filled in, and `{planJson}`
|
|
29
|
+
* with the engine's plan document when the capability's plan names one
|
|
30
|
+
* (`artifact.planJson`). It prints the estimate on standard output.
|
|
31
|
+
*/
|
|
32
|
+
command: string[];
|
|
33
|
+
/** The monthly change, summed over the wave's runs, above which the wave waits for a person. */
|
|
34
|
+
approveAbove: number;
|
|
35
|
+
/** `infracost`: `infracost breakdown --format json`'s document. `chant`: `{ "monthlyDelta": <number>, "currency"?: "<code>" }`. Default `infracost`. */
|
|
36
|
+
format?: OpWaveCostFormat;
|
|
37
|
+
/** The currency `approveAbove` is in, for the log and the digest. Default the estimate's, else `USD`. */
|
|
38
|
+
currency?: string;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** Holds a wave runs over its plans (#4545), read at base. */
|
|
42
|
+
export interface OpWaveHolds {
|
|
43
|
+
/** Run the workspace's `ci.policy` at base over each run's change set: deny rules deny the run, hold rules hold it. */
|
|
44
|
+
policy?: boolean;
|
|
45
|
+
/** Price each run and hold the wave over a monthly change. */
|
|
46
|
+
cost?: OpWaveCostHold;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** The digest member a cost hold adds (#4545): no run has this name. */
|
|
50
|
+
export const OP_WAVE_COST_MEMBER = "(monthly cost)";
|
|
51
|
+
|
|
52
|
+
/** What is wrong with a spec's `step`, empty when nothing is. */
|
|
53
|
+
export function opWaveStepProblems(spec: Pick<OpWavesSpec, "step" | "plan" | "apply" | "planWave" | "applyWave" | "hooks" | "waves">): string[] {
|
|
54
|
+
const step = spec.step as unknown;
|
|
55
|
+
if (step === undefined) return [];
|
|
56
|
+
if (step === null || typeof step !== "object" || Array.isArray(step)) return ["`step` must be { \"kind\": \"<capability>\", ...input }"];
|
|
57
|
+
const problems: string[] = [];
|
|
58
|
+
const kind = (step as { kind?: unknown }).kind;
|
|
59
|
+
if (typeof kind !== "string" || kind.trim() === "") problems.push("`step.kind` must name a capability, such as \"terraform-apply\"");
|
|
60
|
+
for (const key of ["plan", "apply", "planWave", "applyWave"] as const) {
|
|
61
|
+
if (spec[key] !== undefined) problems.push(`\`step\` and \`${key}\` are both set; a wave plans and applies through its capability or through commands, so give one`);
|
|
62
|
+
}
|
|
63
|
+
if (spec.hooks?.apply?.runBy === "apply") problems.push("`hooks.apply.runBy: \"apply\"` hands the apply-stage hooks to an apply command, and a `step` has none; leave runBy as chant");
|
|
64
|
+
for (const wave of spec.waves) {
|
|
65
|
+
if (wave.discover) problems.push(`wave "${wave.name}" discovers its runs, which only \`planWave\` can report; a \`step\` plans the runs the spec lists`);
|
|
66
|
+
if (wave.hooks?.apply?.runBy === "apply") problems.push(`wave "${wave.name}" hands its apply-stage hooks to an apply command, and a \`step\` has none`);
|
|
67
|
+
for (const run of wave.runs ?? []) {
|
|
68
|
+
const input = run.input as unknown;
|
|
69
|
+
if (input !== undefined && (input === null || typeof input !== "object" || Array.isArray(input))) problems.push(`wave "${wave.name}" run "${run.target}": \`input\` must be an object laid over the step's input`);
|
|
70
|
+
if (input && typeof input === "object" && "kind" in input) problems.push(`wave "${wave.name}" run "${run.target}": \`input\` cannot change the step's kind`);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
return problems;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/** What is wrong with a spec's `holds`, empty when nothing is. */
|
|
77
|
+
export function opWaveHoldsProblems(holds: unknown): string[] {
|
|
78
|
+
if (holds === undefined) return [];
|
|
79
|
+
if (holds === null || typeof holds !== "object" || Array.isArray(holds)) return ["`holds` must be { \"policy\"?: true, \"cost\"?: {...} }"];
|
|
80
|
+
const problems: string[] = [];
|
|
81
|
+
for (const [key, value] of Object.entries(holds as Record<string, unknown>)) {
|
|
82
|
+
if (key === "policy") {
|
|
83
|
+
if (typeof value !== "boolean") problems.push("`holds.policy` must be true or false");
|
|
84
|
+
} else if (key === "cost") {
|
|
85
|
+
problems.push(...costHoldProblems(value));
|
|
86
|
+
} else problems.push(`\`holds.${key}\` is not a setting; the ones there are holds.policy and holds.cost`);
|
|
87
|
+
}
|
|
88
|
+
return problems;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
function costHoldProblems(value: unknown): string[] {
|
|
92
|
+
if (value === null || typeof value !== "object" || Array.isArray(value)) return ["`holds.cost` must be { \"command\": [...], \"approveAbove\": <number>, \"format\"?, \"currency\"? }"];
|
|
93
|
+
const c = value as Record<string, unknown>;
|
|
94
|
+
const problems: string[] = [];
|
|
95
|
+
if (!Array.isArray(c.command) || c.command.length === 0 || !c.command.every((a) => typeof a === "string" && a !== "")) problems.push("`holds.cost.command` must be argv, a non-empty list of strings");
|
|
96
|
+
if (typeof c.approveAbove !== "number" || !Number.isFinite(c.approveAbove) || c.approveAbove < 0) problems.push("`holds.cost.approveAbove` must be a monthly amount of 0 or more");
|
|
97
|
+
if (c.format !== undefined && !(OP_WAVE_COST_FORMATS as readonly unknown[]).includes(c.format)) problems.push(`\`holds.cost.format\` must be ${OP_WAVE_COST_FORMATS.join(" or ")}`);
|
|
98
|
+
if (c.currency !== undefined && (typeof c.currency !== "string" || !/^[A-Z]{3}$/.test(c.currency))) problems.push("`holds.cost.currency` must be a three-letter currency code, such as \"USD\"");
|
|
99
|
+
for (const key of Object.keys(c)) if (!["command", "approveAbove", "format", "currency"].includes(key)) problems.push(`\`holds.cost.${key}\` is not a setting`);
|
|
100
|
+
return problems;
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/**
|
|
104
|
+
* The holds wave rules take (#4545): the spec's at base, else the change's
|
|
105
|
+
* when the base has none. `policy` is on when either one sets it, so a
|
|
106
|
+
* change can add the hold and never drop it. Undefined when neither sets any.
|
|
107
|
+
*/
|
|
108
|
+
export function opWaveHoldsAt(atBase: OpWaveHolds | undefined, change: OpWaveHolds | undefined): OpWaveHolds | undefined {
|
|
109
|
+
const policy = atBase?.policy === true || change?.policy === true;
|
|
110
|
+
const cost = atBase !== undefined ? atBase.cost : change?.cost;
|
|
111
|
+
if (!policy && !cost) return undefined;
|
|
112
|
+
return { ...(policy ? { policy: true } : {}), ...(cost ? { cost } : {}) };
|
|
113
|
+
}
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Op waves through capabilities (#4545): a spec's `step` plans and applies
|
|
3
|
+
* each run through a capability in the job's process, and `holds` holds the
|
|
4
|
+
* wave on a policy or a cost.
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { describe, expect, test } from "vitest";
|
|
8
|
+
import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
|
|
9
|
+
import { join } from "node:path";
|
|
10
|
+
import { tmpdir } from "node:os";
|
|
11
|
+
import type { OpWavesSpec } from "./op-waves";
|
|
12
|
+
import { assertOpWavesSpec } from "./op-waves";
|
|
13
|
+
import { runOpWave, opWavePlanPath, type OpWaveShowAtBase } from "./op-waves-run";
|
|
14
|
+
import { memoryGateLedgerPort } from "./gate";
|
|
15
|
+
import { waveSetDigest } from "../gated-waves";
|
|
16
|
+
import { CapabilityRegistry, type Capability, type DeployContext } from "../components/capability";
|
|
17
|
+
import type { ChangeSetPart } from "../change-set";
|
|
18
|
+
import {
|
|
19
|
+
OP_WAVE_COST_MEMBER,
|
|
20
|
+
opWaveCostVerdict,
|
|
21
|
+
opWaveHoldsAt,
|
|
22
|
+
opWaveHoldsProblems,
|
|
23
|
+
opWaveStepInput,
|
|
24
|
+
opWaveStepProblems,
|
|
25
|
+
partEffects,
|
|
26
|
+
readCostEstimate,
|
|
27
|
+
} from "./op-waves-capability";
|
|
28
|
+
|
|
29
|
+
const digest = (n: string) => `sha256:${n.repeat(64)}`;
|
|
30
|
+
|
|
31
|
+
const part = (member: string, action: "create" | "delete" | "no-op"): ChangeSetPart => ({
|
|
32
|
+
member: { member, lexicon: "terraform", planner: "chant", status: "planned", planDigest: digest("9"), holes: [] },
|
|
33
|
+
entries: [{ member, address: `aws_s3_bucket.${member}`, type: "aws_s3_bucket", action } as ChangeSetPart["entries"][number]],
|
|
34
|
+
});
|
|
35
|
+
|
|
36
|
+
interface Calls {
|
|
37
|
+
planned: Array<{ ctx: DeployContext; input: Record<string, unknown> }>;
|
|
38
|
+
ran: Array<{ ctx: DeployContext; input: Record<string, unknown> }>;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** A capability that plans each root to `digests[root]` and applies whatever plan it is handed, or refuses as moved. */
|
|
42
|
+
function fakeCapability(digests: Record<string, string>, opts: { moved?: string[]; action?: "create" | "delete" | "no-op" } = {}): { registry: CapabilityRegistry; calls: Calls } {
|
|
43
|
+
const calls: Calls = { planned: [], ran: [] };
|
|
44
|
+
const cap: Capability<Record<string, unknown>, unknown> = {
|
|
45
|
+
kind: "fake-apply",
|
|
46
|
+
async plan(ctx, input) {
|
|
47
|
+
calls.planned.push({ ctx, input });
|
|
48
|
+
const root = String(input.root);
|
|
49
|
+
return { member: root, planDigest: digests[root]!, artifact: { planFile: `${root}.tfplan`, planJson: `${root}.tfplan.json` }, changeSet: part(root, opts.action ?? "create") };
|
|
50
|
+
},
|
|
51
|
+
async run(ctx, input) {
|
|
52
|
+
calls.ran.push({ ctx, input });
|
|
53
|
+
if (opts.moved?.includes(String(input.root))) throw Object.assign(new Error("the live system moved"), { planMoved: true });
|
|
54
|
+
return { applied: input.root };
|
|
55
|
+
},
|
|
56
|
+
};
|
|
57
|
+
return { registry: new CapabilityRegistry().register(cap), calls };
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
function harness(spec: OpWavesSpec) {
|
|
61
|
+
const cwd = mkdtempSync(join(tmpdir(), "op-waves-step-"));
|
|
62
|
+
const show: OpWaveShowAtBase = () => ({ sha: "b".repeat(40), text: JSON.stringify(spec) });
|
|
63
|
+
return { cwd, show, done: () => rmSync(cwd, { recursive: true, force: true }) };
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
const base: OpWavesSpec = {
|
|
67
|
+
name: "roots",
|
|
68
|
+
op: "tf-apply",
|
|
69
|
+
step: { kind: "fake-apply", root: "{target}", lockTimeout: "5m" },
|
|
70
|
+
waves: [{ name: "dev", runs: [{ target: "network" }, { target: "app", input: { vars: { size: "s" } } }], gate: "never" }],
|
|
71
|
+
};
|
|
72
|
+
|
|
73
|
+
describe("op waves through a capability step (#4545)", () => {
|
|
74
|
+
test("each run plans through the step, and applies the plan it was given", async () => {
|
|
75
|
+
const { registry, calls } = fakeCapability({ network: digest("1"), app: digest("2") });
|
|
76
|
+
const h = harness(base);
|
|
77
|
+
const result = await runOpWave({ spec: base, specFile: "waves.json", wave: 1, cwd: h.cwd, show: h.show, gates: memoryGateLedgerPort(), capabilities: registry });
|
|
78
|
+
expect(result).toMatchObject({ exitCode: 0, applied: ["network", "app"], failed: [], moved: [] });
|
|
79
|
+
expect(calls.planned.map((c) => c.input)).toEqual([
|
|
80
|
+
{ root: "network", lockTimeout: "5m" },
|
|
81
|
+
{ root: "app", lockTimeout: "5m", vars: { size: "s" } },
|
|
82
|
+
]);
|
|
83
|
+
// #4613: the plan reads its policy packs at the wave's base.
|
|
84
|
+
expect(calls.planned[0]!.ctx).toEqual({ env: "dev", component: "network", policyBase: "b".repeat(40) });
|
|
85
|
+
// The apply gets the plan's artifact under the capability's member.
|
|
86
|
+
expect(calls.ran[0]!.ctx.plans).toEqual({ network: { planFile: "network.tfplan", planJson: "network.tfplan.json" } });
|
|
87
|
+
// The plan file hooks read carries the digest, the artifact and the part.
|
|
88
|
+
const file = JSON.parse(readFileSync(join(h.cwd, opWavePlanPath(base, 1, "app")), "utf-8"));
|
|
89
|
+
expect(file).toMatchObject({ planDigest: digest("2"), member: "app", artifact: { planFile: "app.tfplan" }, changeSet: { member: { member: "app" } } });
|
|
90
|
+
h.done();
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
test("the wave's gate binds the step's digests, and the pending fact cites the composed change set", async () => {
|
|
94
|
+
const spec: OpWavesSpec = { ...base, waves: [{ ...base.waves[0]!, gate: "always" }] };
|
|
95
|
+
const { registry, calls } = fakeCapability({ network: digest("1"), app: digest("2") });
|
|
96
|
+
const h = harness(spec);
|
|
97
|
+
const stored: Array<{ digest: string; members: Array<{ member: string }> }> = [];
|
|
98
|
+
const gates = Object.assign(memoryGateLedgerPort(), { storeChangeSet: async (doc: { digest: string; members: Array<{ member: string }> }) => void stored.push(doc) });
|
|
99
|
+
const waiting = await runOpWave({ spec, specFile: "waves.json", wave: 1, cwd: h.cwd, show: h.show, gates, capabilities: registry });
|
|
100
|
+
expect(waiting.exitCode).toBe(3);
|
|
101
|
+
expect(waiting.decision!.digest).toBe(waveSetDigest([{ member: "network", planDigest: digest("1") }, { member: "app", planDigest: digest("2") }]));
|
|
102
|
+
expect(stored.map((d) => d.members.map((m) => m.member))).toEqual([["app", "network"]]);
|
|
103
|
+
expect(waiting.decision!.changeSet).toBe(stored[0]!.digest);
|
|
104
|
+
expect(calls.ran).toHaveLength(0);
|
|
105
|
+
h.done();
|
|
106
|
+
});
|
|
107
|
+
|
|
108
|
+
test("a run the capability refuses as moved applies nothing and the job exits 4", async () => {
|
|
109
|
+
const { registry } = fakeCapability({ network: digest("1"), app: digest("2") }, { moved: ["app"] });
|
|
110
|
+
const h = harness(base);
|
|
111
|
+
const result = await runOpWave({ spec: base, specFile: "waves.json", wave: 1, cwd: h.cwd, show: h.show, gates: memoryGateLedgerPort(), capabilities: registry });
|
|
112
|
+
expect(result).toMatchObject({ exitCode: 4, applied: ["network"], moved: ["app"], failed: [] });
|
|
113
|
+
h.done();
|
|
114
|
+
});
|
|
115
|
+
|
|
116
|
+
test("a destructive part makes the run destructive, which on-destructive waits on", async () => {
|
|
117
|
+
const spec: OpWavesSpec = { ...base, waves: [{ ...base.waves[0]!, gate: "on-destructive" }] };
|
|
118
|
+
const { registry } = fakeCapability({ network: digest("1"), app: digest("2") }, { action: "delete" });
|
|
119
|
+
const h = harness(spec);
|
|
120
|
+
const result = await runOpWave({ spec, specFile: "waves.json", wave: 1, cwd: h.cwd, show: h.show, gates: memoryGateLedgerPort(), capabilities: registry });
|
|
121
|
+
expect(result.exitCode).toBe(3);
|
|
122
|
+
expect(result.decision!.members.every((m) => m.destructive)).toBe(true);
|
|
123
|
+
h.done();
|
|
124
|
+
});
|
|
125
|
+
|
|
126
|
+
test("a cost over approveAbove holds a gate: never wave, and the cost is a member of the digest", async () => {
|
|
127
|
+
const spec: OpWavesSpec = { ...base, holds: { cost: { command: ["infracost", "breakdown", "--path", "{planJson}"], approveAbove: 50, format: "chant" } } };
|
|
128
|
+
const { registry } = fakeCapability({ network: digest("1"), app: digest("2") });
|
|
129
|
+
const h = harness(spec);
|
|
130
|
+
// planJson is relative to cwd and must exist; the fake's files do not, so the runs cannot be priced and the wave holds.
|
|
131
|
+
const unpriced = await runOpWave({ spec, specFile: "waves.json", wave: 1, cwd: h.cwd, show: h.show, gates: memoryGateLedgerPort(), capabilities: registry, holdExec: () => ({ status: 0, stdout: "{\"monthlyDelta\": 10}", stderr: "" }) });
|
|
132
|
+
expect(unpriced.exitCode).toBe(3);
|
|
133
|
+
expect(unpriced.decision!.heldBy!.join(" ")).toMatch(/could not be priced/);
|
|
134
|
+
expect(unpriced.decision!.extras?.map((m) => m.member)).toEqual([OP_WAVE_COST_MEMBER]);
|
|
135
|
+
h.done();
|
|
136
|
+
});
|
|
137
|
+
|
|
138
|
+
test("a cost under approveAbove lets a gate: never wave through", async () => {
|
|
139
|
+
const spec: OpWavesSpec = { ...base, holds: { cost: { command: ["estimate", "{target}"], approveAbove: 50, format: "chant" } } };
|
|
140
|
+
const { registry } = fakeCapability({ network: digest("1"), app: digest("2") });
|
|
141
|
+
const h = harness(spec);
|
|
142
|
+
const result = await runOpWave({ spec, specFile: "waves.json", wave: 1, cwd: h.cwd, show: h.show, gates: memoryGateLedgerPort(), capabilities: registry, holdExec: () => ({ status: 0, stdout: "{\"monthlyDelta\": 10}", stderr: "" }) });
|
|
143
|
+
expect(result).toMatchObject({ exitCode: 0, applied: ["network", "app"] });
|
|
144
|
+
h.done();
|
|
145
|
+
});
|
|
146
|
+
|
|
147
|
+
test("a cost over approveAbove waits, whatever the gate", async () => {
|
|
148
|
+
const spec: OpWavesSpec = { ...base, holds: { cost: { command: ["estimate", "{target}"], approveAbove: 15, format: "chant" } } };
|
|
149
|
+
const { registry } = fakeCapability({ network: digest("1"), app: digest("2") });
|
|
150
|
+
const h = harness(spec);
|
|
151
|
+
const result = await runOpWave({ spec, specFile: "waves.json", wave: 1, cwd: h.cwd, show: h.show, gates: memoryGateLedgerPort(), capabilities: registry, holdExec: () => ({ status: 0, stdout: "{\"monthlyDelta\": 10}", stderr: "" }) });
|
|
152
|
+
expect(result.exitCode).toBe(3);
|
|
153
|
+
expect(result.decision!.heldBy).toEqual(["cost: its monthly change of +20.00 USD is over holds.cost.approveAbove (15 USD)"]);
|
|
154
|
+
h.done();
|
|
155
|
+
});
|
|
156
|
+
});
|
|
157
|
+
|
|
158
|
+
describe("a policy hold over command plans (#4545)", () => {
|
|
159
|
+
test("a plan file that gives no change set fails the wave, since the policy has nothing to read", async () => {
|
|
160
|
+
const spec: OpWavesSpec = {
|
|
161
|
+
name: "roots",
|
|
162
|
+
op: "tf",
|
|
163
|
+
plan: ["tool", "plan", "{target}", "--out", "{plan}"],
|
|
164
|
+
apply: ["tool", "apply", "{target}"],
|
|
165
|
+
holds: { policy: true },
|
|
166
|
+
waves: [{ name: "dev", runs: [{ target: "vpc" }], gate: "never" }],
|
|
167
|
+
};
|
|
168
|
+
const h = harness(spec);
|
|
169
|
+
const calls: string[] = [];
|
|
170
|
+
const exec = (argv: string[], dir: string) => {
|
|
171
|
+
calls.push(argv.join(" "));
|
|
172
|
+
if (argv[1] === "plan") writeFileSync(join(dir, argv[4]!), JSON.stringify({ planDigest: digest("1") }));
|
|
173
|
+
return 0;
|
|
174
|
+
};
|
|
175
|
+
const result = await runOpWave({ spec, specFile: "waves.json", wave: 1, cwd: h.cwd, exec, show: h.show, gates: memoryGateLedgerPort() });
|
|
176
|
+
expect(result.exitCode).toBe(1);
|
|
177
|
+
expect(calls.some((c) => c.startsWith("tool apply"))).toBe(false);
|
|
178
|
+
h.done();
|
|
179
|
+
});
|
|
180
|
+
});
|
|
181
|
+
|
|
182
|
+
describe("the step and holds settings (#4545)", () => {
|
|
183
|
+
test("a step beside a plan command is refused", () => {
|
|
184
|
+
expect(() => assertOpWavesSpec({ ...base, plan: ["tool", "plan", "{plan}"] })).toThrow(/`step` and `plan` are both set/);
|
|
185
|
+
expect(opWaveStepProblems({ ...base, step: { kind: "" } })).toContain("`step.kind` must name a capability, such as \"terraform-apply\"");
|
|
186
|
+
});
|
|
187
|
+
|
|
188
|
+
test("a run's input fills its placeholders and lies over the step's", () => {
|
|
189
|
+
const spec: OpWavesSpec = { ...base, step: { kind: "fake-apply", root: "{target}", cwd: "roots/{wave}", vars: { a: 1 } } };
|
|
190
|
+
expect(opWaveStepInput(spec, { name: "prod" }, { target: "db", input: { vars: { b: "{op}" } } })).toEqual({ root: "db", cwd: "roots/prod", vars: { b: "tf-apply" } });
|
|
191
|
+
});
|
|
192
|
+
|
|
193
|
+
test("holds read at base win, and a policy hold is never dropped by a change", () => {
|
|
194
|
+
expect(opWaveHoldsAt({ policy: true }, {})).toEqual({ policy: true });
|
|
195
|
+
expect(opWaveHoldsAt(undefined, { policy: true })).toEqual({ policy: true });
|
|
196
|
+
const cost = { command: ["x"], approveAbove: 10 };
|
|
197
|
+
expect(opWaveHoldsAt({ cost }, { cost: { command: ["y"], approveAbove: 1e9 } })).toEqual({ cost });
|
|
198
|
+
expect(opWaveHoldsAt(undefined, undefined)).toBeUndefined();
|
|
199
|
+
expect(opWaveHoldsProblems({ cost: { command: [], approveAbove: -1 } })).toHaveLength(2);
|
|
200
|
+
expect(opWaveHoldsProblems({ budget: 1 })).toEqual(["`holds.budget` is not a setting; the ones there are holds.policy and holds.cost"]);
|
|
201
|
+
});
|
|
202
|
+
|
|
203
|
+
test("estimates read in both formats, and the cost verdict sums them", () => {
|
|
204
|
+
expect(readCostEstimate("infracost", JSON.stringify({ currency: "EUR", diffTotalMonthlyCost: "12.5" }))).toEqual({ monthlyDelta: 12.5, currency: "EUR" });
|
|
205
|
+
expect(readCostEstimate("infracost", JSON.stringify({ totalMonthlyCost: "30", pastTotalMonthlyCost: "10" }))).toEqual({ monthlyDelta: 20 });
|
|
206
|
+
expect(() => readCostEstimate("chant", "{}")).toThrow(/monthlyDelta/);
|
|
207
|
+
const v = opWaveCostVerdict({ command: ["x"], approveAbove: 100 }, [{ target: "a", monthlyDelta: 40 }, { target: "b", monthlyDelta: 70 }]);
|
|
208
|
+
expect(v).toMatchObject({ monthlyDelta: 110, currency: "USD", unestimated: [], hold: "cost: its monthly change of +110.00 USD is over holds.cost.approveAbove (100 USD)" });
|
|
209
|
+
expect(opWaveCostVerdict({ command: ["x"], approveAbove: 100 }, [{ target: "a", monthlyDelta: 40 }]).hold).toBeUndefined();
|
|
210
|
+
});
|
|
211
|
+
|
|
212
|
+
test("a part's effects", () => {
|
|
213
|
+
expect(partEffects(part("a", "no-op"))).toEqual({ empty: true, destructive: false });
|
|
214
|
+
expect(partEffects(part("a", "delete"))).toEqual({ empty: false, destructive: true });
|
|
215
|
+
expect(partEffects(undefined)).toEqual({ empty: false, destructive: false });
|
|
216
|
+
});
|
|
217
|
+
});
|