@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,252 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The check moment (#4556): `ci.hooks.check` in the workspace declaration,
|
|
3
|
+
* run by a product's check job, terragucci's and plywood's alike, with the
|
|
4
|
+
* runner the other moments use (`runStageHooks`). Nothing here knows an
|
|
5
|
+
* engine: a hook is the user's own tool (tflint, checkov, trivy,
|
|
6
|
+
* pre-commit), and the product switches it on with a preset.
|
|
7
|
+
*
|
|
8
|
+
* - The hooks are read from the declaration at the base the check measures
|
|
9
|
+
* the change from, never from the change itself, so a change cannot remove
|
|
10
|
+
* a required check. The top level's run first, then the member's.
|
|
11
|
+
* - A hook runs once for the check, or once per target with `perRun`;
|
|
12
|
+
* `{target}` and `CHANT_TARGET` name it, and `targets` match the targets'
|
|
13
|
+
* names. There is no `{plan}`, and `onFailure` is `fail`.
|
|
14
|
+
* - A hook runs with no forge token, no OIDC request variables and no cloud
|
|
15
|
+
* credentials in its environment ({@link checkHookEnv}).
|
|
16
|
+
*
|
|
17
|
+
* {@link writeCiHook} is the writer a product's `init` calls to add a hook to
|
|
18
|
+
* `ci.hooks`, keeping the declaration's formatting.
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
import { spawnSync } from "node:child_process";
|
|
22
|
+
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
23
|
+
import { join, relative, resolve } from "node:path";
|
|
24
|
+
import { CHECK_HOOK_MOMENT, assertCheckHooks, type CiHooks, type OpWaveHook } from "../op/op-waves";
|
|
25
|
+
import { runStageHooks, type OpWaveExec, type OpWaveHookRun } from "../op/stage-hooks";
|
|
26
|
+
import { FORGE_TOKEN_VARS } from "../ci-handover";
|
|
27
|
+
import { OIDC_REQUEST_VARS, TRADED_VARS } from "../ci-identity";
|
|
28
|
+
import { DECLARATION_FILES, readDeclaration, WorkspaceReadError, type Declaration } from "../workspace/declaration";
|
|
29
|
+
import { setProperty, valueAt } from "../workspace/json-edit";
|
|
30
|
+
import { parseJsonText } from "../workspace/jsonc";
|
|
31
|
+
import { memberAtCwd } from "../workspace/security";
|
|
32
|
+
import { locateWorkspace } from "../workspace/which-chant";
|
|
33
|
+
|
|
34
|
+
export { CI_CHECK_HOOK_FLOOR } from "../op/op-waves";
|
|
35
|
+
|
|
36
|
+
/** The check hooks a job runs, and where they were read. */
|
|
37
|
+
export interface CheckHooksRead {
|
|
38
|
+
hooks: OpWaveHook[];
|
|
39
|
+
/** The commit they were read at. */
|
|
40
|
+
base: string;
|
|
41
|
+
/** A line for the log when none run because the base has no declaration, or could not be read. */
|
|
42
|
+
note?: string;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/** The check hooks `declaration` gives a job run in a member (or at the top, `null`): the top level's, then the member's. */
|
|
46
|
+
export function checkHooksOf(declaration: Pick<Declaration, "ci" | "members">, member: string | null): OpWaveHook[] {
|
|
47
|
+
const own = member === null ? null : (declaration.members.find((m) => m.name === member)?.ciHooks ?? null);
|
|
48
|
+
return [...(declaration.ci?.hooks?.check ?? []), ...(own?.check ?? [])];
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** Whether the working tree's declaration names any check hook. */
|
|
52
|
+
function checkoutNamesCheckHooks(cwd: string): boolean {
|
|
53
|
+
try {
|
|
54
|
+
const located = locateWorkspace(cwd);
|
|
55
|
+
const d = readDeclaration(located.tree);
|
|
56
|
+
return checkHooksOf(d, memberAtCwd({ declaration: d, rootOnDisk: located.rootOnDisk }, cwd)).length > 0;
|
|
57
|
+
} catch {
|
|
58
|
+
return false;
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* The check hooks a job in `cwd` runs, read from the workspace declaration at
|
|
64
|
+
* `base`. Throws when the declaration at base cannot be read and the working
|
|
65
|
+
* tree's names check hooks, as the pull-request jobs do for their hooks.
|
|
66
|
+
*/
|
|
67
|
+
export function checkHooksAt(cwd: string, base: string): CheckHooksRead {
|
|
68
|
+
let declaration: Declaration;
|
|
69
|
+
let rootOnDisk: string;
|
|
70
|
+
try {
|
|
71
|
+
const located = locateWorkspace(cwd, base);
|
|
72
|
+
declaration = readDeclaration(located.tree);
|
|
73
|
+
rootOnDisk = located.rootOnDisk;
|
|
74
|
+
} catch (err) {
|
|
75
|
+
const missing = err instanceof WorkspaceReadError && (err.code === "declaration-missing" || err.code === "not-a-git-repository");
|
|
76
|
+
const why = err instanceof Error ? err.message : String(err);
|
|
77
|
+
if (checkoutNamesCheckHooks(cwd)) {
|
|
78
|
+
if (missing) return { hooks: [], base, note: `ci.hooks.check: the base ${base.slice(0, 12)} has no workspace declaration, so the check hooks this change declares do not run until it merges` };
|
|
79
|
+
throw new Error(`ci.hooks.check is read from the workspace declaration at ${base.slice(0, 12)}, and it could not be read (${why}), so no check hook can be trusted to run`);
|
|
80
|
+
}
|
|
81
|
+
return missing ? { hooks: [], base } : { hooks: [], base, note: `ci.hooks.check: the declaration at ${base.slice(0, 12)} could not be read (${why}); this checkout names no check hooks, so none run` };
|
|
82
|
+
}
|
|
83
|
+
return { hooks: checkHooksOf(declaration, memberAtCwd({ declaration, rootOnDisk }, cwd)), base };
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** Variables that hold cloud credentials beyond the ones chant's own trade sets. */
|
|
87
|
+
const CLOUD_CREDENTIAL_VARS = [
|
|
88
|
+
"AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_SESSION_TOKEN", "AWS_SECURITY_TOKEN", "AWS_WEB_IDENTITY_TOKEN_FILE", "AWS_ROLE_ARN", "AWS_PROFILE", "AWS_CONTAINER_CREDENTIALS_FULL_URI", "AWS_CONTAINER_CREDENTIALS_RELATIVE_URI", "AWS_CONTAINER_AUTHORIZATION_TOKEN",
|
|
89
|
+
"GOOGLE_APPLICATION_CREDENTIALS", "GOOGLE_CREDENTIALS", "GOOGLE_OAUTH_ACCESS_TOKEN", "CLOUDSDK_AUTH_ACCESS_TOKEN", "CLOUDSDK_AUTH_CREDENTIAL_FILE_OVERRIDE",
|
|
90
|
+
"AZURE_CLIENT_SECRET", "AZURE_CLIENT_CERTIFICATE_PATH", "AZURE_FEDERATED_TOKEN_FILE", "AZURE_ACCESS_TOKEN", "ARM_CLIENT_SECRET", "ARM_CLIENT_CERTIFICATE_PATH", "ARM_OIDC_TOKEN", "ARM_OIDC_TOKEN_FILE_PATH", "ARM_ACCESS_KEY", "ARM_SAS_TOKEN",
|
|
91
|
+
"PULUMI_ACCESS_TOKEN", "PULUMI_CONFIG_PASSPHRASE", "TFE_TOKEN", "TF_TOKEN_app_terraform_io",
|
|
92
|
+
];
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* The environment a check hook runs with (#4556): `env` without a forge
|
|
96
|
+
* token, the OIDC request variables, or cloud credentials, and without any
|
|
97
|
+
* `TF_TOKEN_<host>` registry token. A check reads the change and nothing
|
|
98
|
+
* else.
|
|
99
|
+
*/
|
|
100
|
+
export function checkHookEnv(env: NodeJS.ProcessEnv = process.env): Record<string, string> {
|
|
101
|
+
const drop = new Set<string>([...FORGE_TOKEN_VARS, ...OIDC_REQUEST_VARS, ...Object.values(TRADED_VARS).flat(), ...CLOUD_CREDENTIAL_VARS]);
|
|
102
|
+
const out: Record<string, string> = {};
|
|
103
|
+
for (const [name, value] of Object.entries(env)) {
|
|
104
|
+
if (value === undefined || drop.has(name) || name.startsWith("TF_TOKEN_")) continue;
|
|
105
|
+
out[name] = value;
|
|
106
|
+
}
|
|
107
|
+
return out;
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/** {@link OpWaveExec} with {@link checkHookEnv} in place of the job's environment. */
|
|
111
|
+
export const checkHookExec: OpWaveExec = (argv, cwd, env) => {
|
|
112
|
+
const result = spawnSync(argv[0]!, argv.slice(1), { cwd, stdio: "inherit", env: { ...checkHookEnv(), ...env } });
|
|
113
|
+
if (result.error) throw result.error;
|
|
114
|
+
return result.status ?? 1;
|
|
115
|
+
};
|
|
116
|
+
|
|
117
|
+
/** One check hook's run, as the check report lists it. */
|
|
118
|
+
export interface CheckHookOutcome {
|
|
119
|
+
name: string;
|
|
120
|
+
/** The target, for a `perRun` hook. */
|
|
121
|
+
target?: string;
|
|
122
|
+
exit: number;
|
|
123
|
+
outcome: "passed" | "failed" | "skipped";
|
|
124
|
+
reason?: string;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/** What the check hooks came to, for the product's check report. */
|
|
128
|
+
export interface CheckHooksReport {
|
|
129
|
+
version: 1;
|
|
130
|
+
moment: typeof CHECK_HOOK_MOMENT;
|
|
131
|
+
/** The commit the hooks were read at. */
|
|
132
|
+
base: string;
|
|
133
|
+
targets: string[];
|
|
134
|
+
/** `none`: no check hook is declared at base. */
|
|
135
|
+
status: "passed" | "failed" | "none";
|
|
136
|
+
hooks: CheckHookOutcome[];
|
|
137
|
+
/** The first hook that failed, and why; the hooks after it did not run. */
|
|
138
|
+
failed?: string;
|
|
139
|
+
note?: string;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
/** Where {@link runCheckHooks} writes its runs file and report unless told: `.chant/check`. */
|
|
143
|
+
export const CHECK_HOOKS_DIR = ".chant/check";
|
|
144
|
+
|
|
145
|
+
/** The report file under the directory. */
|
|
146
|
+
export const CHECK_HOOKS_REPORT_FILE = "check-hooks.json";
|
|
147
|
+
|
|
148
|
+
export interface RunCheckHooksOptions {
|
|
149
|
+
/** The commit to read `ci.hooks.check` at: the base the change is measured from. */
|
|
150
|
+
base: string;
|
|
151
|
+
/** The targets the change touches (roots, stacks or components), for `perRun` hooks and `targets`. */
|
|
152
|
+
targets?: readonly string[];
|
|
153
|
+
/** Default the working directory. */
|
|
154
|
+
cwd?: string;
|
|
155
|
+
/** Where the runs file and the report go, relative to `cwd`. Default {@link CHECK_HOOKS_DIR}. */
|
|
156
|
+
dir?: string;
|
|
157
|
+
/** The hooks, when the caller read them itself. Default {@link checkHooksAt} `base`. */
|
|
158
|
+
read?: CheckHooksRead;
|
|
159
|
+
/** Added to every hook's environment, after {@link checkHookEnv}. */
|
|
160
|
+
env?: Record<string, string>;
|
|
161
|
+
/** Default {@link checkHookExec}. */
|
|
162
|
+
exec?: OpWaveExec;
|
|
163
|
+
log?: (line: string) => void;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
/**
|
|
167
|
+
* Run the check hooks (#4556): each once, or once per target with
|
|
168
|
+
* `perRun`, in order, stopping at the first that fails. Writes the runs file
|
|
169
|
+
* (`{runs}`, `CHANT_RUNS`) and the report under `dir`, and returns the
|
|
170
|
+
* report.
|
|
171
|
+
*/
|
|
172
|
+
export function runCheckHooks(options: RunCheckHooksOptions): CheckHooksReport {
|
|
173
|
+
const cwd = options.cwd ?? process.cwd();
|
|
174
|
+
const log = options.log ?? ((line: string) => console.error(line));
|
|
175
|
+
const read = options.read ?? checkHooksAt(cwd, options.base);
|
|
176
|
+
if (read.note) log(read.note);
|
|
177
|
+
const targets = [...(options.targets ?? [])];
|
|
178
|
+
const dir = relative(cwd, resolve(cwd, options.dir ?? CHECK_HOOKS_DIR)) || ".";
|
|
179
|
+
mkdirSync(join(cwd, dir), { recursive: true });
|
|
180
|
+
const report = (r: Omit<CheckHooksReport, "version" | "moment" | "base" | "targets">): CheckHooksReport => {
|
|
181
|
+
const doc: CheckHooksReport = { version: 1, moment: CHECK_HOOK_MOMENT, base: read.base, targets, ...r, ...(read.note ? { note: read.note } : {}) };
|
|
182
|
+
writeFileSync(join(cwd, dir, CHECK_HOOKS_REPORT_FILE), JSON.stringify(doc, null, 2) + "\n");
|
|
183
|
+
return doc;
|
|
184
|
+
};
|
|
185
|
+
if (read.hooks.length === 0) return report({ status: "none", hooks: [] });
|
|
186
|
+
assertCheckHooks("ci.hooks at base", read.hooks);
|
|
187
|
+
const op = "check";
|
|
188
|
+
const runs: OpWaveHookRun[] = targets.map((target) => ({ target, op }));
|
|
189
|
+
const runsFile = join(dir, "runs.json");
|
|
190
|
+
writeFileSync(join(cwd, runsFile), JSON.stringify({ version: 1, op, stage: "check", base: read.base, hook: CHECK_HOOK_MOMENT, runs }, null, 2) + "\n");
|
|
191
|
+
const ran = runStageHooks(CHECK_HOOK_MOMENT, read.hooks, {
|
|
192
|
+
name: op,
|
|
193
|
+
op,
|
|
194
|
+
wave: op,
|
|
195
|
+
runs,
|
|
196
|
+
runsFile,
|
|
197
|
+
holdFile: join(dir, "hold.json"),
|
|
198
|
+
env: { CHANT_CHECK: "1", CHANT_HOOKS_BASE: read.base, ...options.env },
|
|
199
|
+
cwd,
|
|
200
|
+
exec: options.exec ?? checkHookExec,
|
|
201
|
+
log,
|
|
202
|
+
});
|
|
203
|
+
const hooks = ran.outcomes.map((o): CheckHookOutcome => ({
|
|
204
|
+
name: o.name,
|
|
205
|
+
...(o.target ? { target: o.target } : {}),
|
|
206
|
+
exit: o.exit,
|
|
207
|
+
outcome: o.outcome === "skipped" ? "skipped" : o.outcome === "passed" ? "passed" : "failed",
|
|
208
|
+
...(o.reason ? { reason: o.reason } : {}),
|
|
209
|
+
}));
|
|
210
|
+
const failed = ran.failed ?? (hooks.some((h) => h.outcome === "failed") ? `a check hook failed: ${hooks.filter((h) => h.outcome === "failed").map((h) => h.name).join(", ")}` : undefined);
|
|
211
|
+
return report({ status: failed ? "failed" : "passed", hooks, ...(failed ? { failed } : {}) });
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
/**
|
|
215
|
+
* Add `hook` to `ci.hooks.<moment>` of the workspace declaration at `root`
|
|
216
|
+
* (#4556), the top level's or `member`'s, keeping the file's formatting. A
|
|
217
|
+
* hook of the same `name` at that moment is replaced, so a product's `init`
|
|
218
|
+
* can run again. Refuses a check hook the check job could not run. Returns
|
|
219
|
+
* the declaration file it wrote.
|
|
220
|
+
*/
|
|
221
|
+
export function writeCiHook(
|
|
222
|
+
root: string,
|
|
223
|
+
moment: "check",
|
|
224
|
+
hook: OpWaveHook,
|
|
225
|
+
opts: { member?: string } = {},
|
|
226
|
+
): { file: string; replaced: boolean } {
|
|
227
|
+
assertCheckHooks(`ci.hooks.${moment}`, [hook]);
|
|
228
|
+
const file = DECLARATION_FILES.map((f) => join(root, f)).find((f) => existsSync(f));
|
|
229
|
+
if (!file) throw new Error(`no workspace declaration at ${root}; create one before adding ci.hooks`);
|
|
230
|
+
const jsonc = file.endsWith(".jsonc");
|
|
231
|
+
const text = readFileSync(file, "utf-8");
|
|
232
|
+
const parsed = parseJsonText(text, { jsonc });
|
|
233
|
+
if (!parsed.ok) throw new Error(`${file} is not valid JSON${jsonc ? "C" : ""}: ${parsed.message}`);
|
|
234
|
+
const doc = parsed.value as { members?: Array<{ name?: string }> };
|
|
235
|
+
let owner = "";
|
|
236
|
+
if (opts.member !== undefined) {
|
|
237
|
+
const index = (doc.members ?? []).findIndex((m) => m?.name === opts.member);
|
|
238
|
+
if (index < 0) throw new Error(`the workspace declaration names no member ${JSON.stringify(opts.member)}`);
|
|
239
|
+
owner = `/members/${index}`;
|
|
240
|
+
}
|
|
241
|
+
const ci = valueAt(doc, `${owner}/ci`) as { hooks?: CiHooks } | undefined;
|
|
242
|
+
const current: OpWaveHook[] = ci?.hooks?.[moment] ?? [];
|
|
243
|
+
const name = hook.name ?? hook.command.join(" ");
|
|
244
|
+
const at = current.findIndex((h) => (h.name ?? h.command.join(" ")) === name);
|
|
245
|
+
const next = at < 0 ? [...current, hook] : current.map((h, i) => (i === at ? hook : h));
|
|
246
|
+
const written =
|
|
247
|
+
ci === undefined ? setProperty(text, jsonc, owner, "ci", { hooks: { [moment]: next } })
|
|
248
|
+
: ci.hooks === undefined ? setProperty(text, jsonc, `${owner}/ci`, "hooks", { [moment]: next })
|
|
249
|
+
: setProperty(text, jsonc, `${owner}/ci/hooks`, moment, next);
|
|
250
|
+
writeFileSync(file, written);
|
|
251
|
+
return { file, replaced: at >= 0 };
|
|
252
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
/** #4572: forge-neutral job services, rendered per forge. */
|
|
2
|
+
|
|
3
|
+
import { describe, expect, test } from "vitest";
|
|
4
|
+
import { engineServices, githubServices, gitlabServices, serviceWaitLine, servicesJobEnv, type CiService } from "./ci-services";
|
|
5
|
+
|
|
6
|
+
const PG: CiService = {
|
|
7
|
+
name: "replay-postgres",
|
|
8
|
+
image: "postgres:18.6@sha256:abc",
|
|
9
|
+
port: 5432,
|
|
10
|
+
env: { POSTGRES_PASSWORD: "replay" },
|
|
11
|
+
health: "pg_isready -h 127.0.0.1 -U postgres",
|
|
12
|
+
jobEnv: { REPLAY_POSTGRES_URL: "postgres://replay-postgres:5432/postgres" },
|
|
13
|
+
};
|
|
14
|
+
const CH: CiService = { name: "replay-clickhouse", image: "clickhouse/clickhouse-server:26.8.15.10", port: 8123, env: {}, health: "clickhouse-client --query 'SELECT 1'", jobEnv: { REPLAY_CLICKHOUSE_URL: "http://replay-clickhouse:8123" } };
|
|
15
|
+
|
|
16
|
+
describe("engineServices", () => {
|
|
17
|
+
test("joins each name once, in lexicon order", () => {
|
|
18
|
+
expect(engineServices([[PG], undefined, [CH, PG]]).map((s) => s.name)).toEqual(["replay-postgres", "replay-clickhouse"]);
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
test("refuses one name with two images", () => {
|
|
22
|
+
expect(() => engineServices([[PG], [{ ...PG, image: "postgres:17" }]])).toThrow(/replay-postgres/);
|
|
23
|
+
});
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
describe("rendering", () => {
|
|
27
|
+
test("GitHub and Forgejo: image, env and a health check per service", () => {
|
|
28
|
+
expect(githubServices([PG, CH])).toEqual({
|
|
29
|
+
"replay-postgres": { image: PG.image, env: { POSTGRES_PASSWORD: "replay" }, options: '--health-cmd "pg_isready -h 127.0.0.1 -U postgres" --health-interval 2s --health-timeout 5s --health-retries 45' },
|
|
30
|
+
"replay-clickhouse": { image: CH.image, options: `--health-cmd "clickhouse-client --query 'SELECT 1'" --health-interval 2s --health-timeout 5s --health-retries 45` },
|
|
31
|
+
});
|
|
32
|
+
});
|
|
33
|
+
|
|
34
|
+
test("GitLab: the image under its alias", () => {
|
|
35
|
+
expect(gitlabServices([PG, CH])).toEqual([
|
|
36
|
+
{ name: PG.image, alias: "replay-postgres", variables: { POSTGRES_PASSWORD: "replay" } },
|
|
37
|
+
{ name: CH.image, alias: "replay-clickhouse" },
|
|
38
|
+
]);
|
|
39
|
+
});
|
|
40
|
+
|
|
41
|
+
test("the job's variables merge", () => {
|
|
42
|
+
expect(servicesJobEnv([PG, CH])).toEqual({ ...PG.jobEnv, ...CH.jobEnv });
|
|
43
|
+
});
|
|
44
|
+
|
|
45
|
+
test("the wait line names the host and port, and refuses a host a shell would read as more", () => {
|
|
46
|
+
const line = serviceWaitLine("replay-postgres", 5432);
|
|
47
|
+
expect(line).toContain('net.connect(5432, "replay-postgres"');
|
|
48
|
+
expect(line).toContain("n > 90");
|
|
49
|
+
expect(() => serviceWaitLine("a'; rm -rf /", 1)).toThrow();
|
|
50
|
+
});
|
|
51
|
+
});
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Job services a lexicon asks for (#4572, `LexiconPlugin.ciServices`): a
|
|
3
|
+
* throwaway server a CI job starts beside it, such as the sql lexicon's
|
|
4
|
+
* replay server per dialect. A service is forge-neutral data here; a
|
|
5
|
+
* product's job renders it for its forge with {@link githubServices} (GitHub
|
|
6
|
+
* and Forgejo) or {@link gitlabServices}, sets {@link servicesJobEnv} on the
|
|
7
|
+
* job, and runs {@link serviceWaitLine} before the step that uses it.
|
|
8
|
+
*
|
|
9
|
+
* The job runs in a container (chant's default image, or the product's), so
|
|
10
|
+
* it reaches each service by its name on the job's own network. A name is
|
|
11
|
+
* prefixed by the lexicon (`replay-postgres`), so two lexicons' services
|
|
12
|
+
* never answer for one host.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
import { NEXT_RELEASE } from "../release-floors";
|
|
16
|
+
|
|
17
|
+
/** The first chant with `LexiconPlugin.ciServices` and this module (#4572). */
|
|
18
|
+
export const CI_SERVICES_FLOOR = NEXT_RELEASE;
|
|
19
|
+
|
|
20
|
+
/** One service a job starts. */
|
|
21
|
+
export interface CiService {
|
|
22
|
+
/** The host the job reaches it at, and its alias on GitLab. */
|
|
23
|
+
name: string;
|
|
24
|
+
/** The image, pinned by the lexicon (tag, and digest where the lexicon pins one). */
|
|
25
|
+
image: string;
|
|
26
|
+
/** The port the server listens on inside its container. */
|
|
27
|
+
port: number;
|
|
28
|
+
/** The service container's environment. */
|
|
29
|
+
env: Record<string, string>;
|
|
30
|
+
/** A command run inside the service container that exits 0 once the server answers. */
|
|
31
|
+
health: string;
|
|
32
|
+
/** What the job that uses it sets: the server's URL and its throwaway credentials, by variable name. */
|
|
33
|
+
jobEnv: Record<string, string>;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* Join the services each lexicon gives, each name once, in the order the
|
|
38
|
+
* lexicons come. Two services under one name with different images are
|
|
39
|
+
* refused: a host that answers for two servers would split the job.
|
|
40
|
+
*/
|
|
41
|
+
export function engineServices(perLexicon: ReadonlyArray<readonly CiService[] | undefined>): CiService[] {
|
|
42
|
+
const out = new Map<string, CiService>();
|
|
43
|
+
for (const svc of perLexicon.flatMap((list) => list ?? [])) {
|
|
44
|
+
const seen = out.get(svc.name);
|
|
45
|
+
if (seen && seen.image !== svc.image) throw new Error(`two lexicons give a CI service named ${svc.name}, ${seen.image} and ${svc.image}; a job reaches one server per name`);
|
|
46
|
+
if (!seen) out.set(svc.name, svc);
|
|
47
|
+
}
|
|
48
|
+
return [...out.values()];
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** A job's `services:` on GitHub and Forgejo: each image with its environment and a health check the runner waits on. */
|
|
52
|
+
export function githubServices(services: readonly CiService[]): Record<string, { image: string; env?: Record<string, string>; options: string }> {
|
|
53
|
+
return Object.fromEntries(
|
|
54
|
+
services.map((s) => [
|
|
55
|
+
s.name,
|
|
56
|
+
{
|
|
57
|
+
image: s.image,
|
|
58
|
+
...(Object.keys(s.env).length > 0 ? { env: { ...s.env } } : {}),
|
|
59
|
+
options: `--health-cmd "${s.health}" --health-interval 2s --health-timeout 5s --health-retries 45`,
|
|
60
|
+
},
|
|
61
|
+
]),
|
|
62
|
+
);
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/** A job's `services:` on GitLab: each image under its alias, with its variables. GitLab waits on the port itself. */
|
|
66
|
+
export function gitlabServices(services: readonly CiService[]): Array<{ name: string; alias: string; variables?: Record<string, string> }> {
|
|
67
|
+
return services.map((s) => ({ name: s.image, alias: s.name, ...(Object.keys(s.env).length > 0 ? { variables: { ...s.env } } : {}) }));
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/** The variables a job using `services` sets, merged in order. */
|
|
71
|
+
export function servicesJobEnv(services: readonly CiService[]): Record<string, string> {
|
|
72
|
+
return Object.assign({}, ...services.map((s) => s.jobEnv)) as Record<string, string>;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* A shell line that waits up to `seconds` for `host:port` to accept a
|
|
77
|
+
* connection, with `node -e`, so every forge and image with node runs it
|
|
78
|
+
* the same. It exits 1 naming the host when nothing answers.
|
|
79
|
+
*/
|
|
80
|
+
export function serviceWaitLine(host: string, port: number, seconds = 90): string {
|
|
81
|
+
if (!/^[A-Za-z0-9.-]+$/.test(host)) throw new Error(`a service host is letters, digits, dots and hyphens, not ${JSON.stringify(host)}`);
|
|
82
|
+
return `node -e 'const net = require("net"); let n = 0; (function t() { const s = net.connect(${String(port)}, "${host}", () => { s.end(); process.exit(0); }); s.on("error", () => { if (++n > ${String(seconds)}) { console.error("${host}:${String(port)} did not answer"); process.exit(1); } setTimeout(t, 1000); }); })()'`;
|
|
83
|
+
}
|
|
@@ -52,6 +52,9 @@ import { existsSync, statSync } from "node:fs";
|
|
|
52
52
|
import { getHeadCommit } from "../lifecycle/git";
|
|
53
53
|
import { buildCapabilityRegistry } from "./capability-plugin-loader";
|
|
54
54
|
import type { CapabilityRegistry } from "./capability";
|
|
55
|
+
import type { DeployAdoption } from "./adoption";
|
|
56
|
+
import type { LockGrain } from "../lifecycle/lock-rows";
|
|
57
|
+
import type { RowLeasePort } from "./row-lease";
|
|
55
58
|
import type { FanOutPlan } from "./fan-out";
|
|
56
59
|
import { componentSetFanOut, formRunGroups, planAndRunComponentGroup } from "./groups";
|
|
57
60
|
import { applyConfigDefaults } from "./config-defaults";
|
|
@@ -394,12 +397,22 @@ export function findComponentGate(component: DriverComponent): { gate: string }
|
|
|
394
397
|
export interface RunComponentsOptions {
|
|
395
398
|
/** Target environment name, threaded into every capability's `DeployContext.env` (default: "local"). */
|
|
396
399
|
env?: string;
|
|
400
|
+
/** `ci.lockGrain` as declared (#4594), for every step's `DeployContext.lockGrain`. Absent: each step takes its lexicon's default. */
|
|
401
|
+
lockGrain?: LockGrain;
|
|
402
|
+
/** The run's row lease (#4594): a step or group on the resource grain leases its rows through it before it applies. Absent: no lease. */
|
|
403
|
+
rowLease?: RowLeasePort;
|
|
397
404
|
/**
|
|
398
405
|
* The addresses each component's steps narrow to (#4300), by component
|
|
399
406
|
* (`--target <component>:<address>`). A name the run does not run refuses
|
|
400
407
|
* the run before anything starts.
|
|
401
408
|
*/
|
|
402
409
|
targets?: Readonly<Record<string, readonly string[]>>;
|
|
410
|
+
/**
|
|
411
|
+
* `--adopt <adoption-file>` (#4537): adopt the file's resources into the
|
|
412
|
+
* one component this run names, through its deploy step's
|
|
413
|
+
* `DeployContext.adoption`. Refused with `all` or a list.
|
|
414
|
+
*/
|
|
415
|
+
adoption?: DeployAdoption;
|
|
403
416
|
/**
|
|
404
417
|
* chant #1051 — opt-in: discover `*.component.ts` files in a sandboxed
|
|
405
418
|
* child process (`chant run --components <name|all> --sandbox`) instead of
|
|
@@ -734,7 +747,15 @@ export async function runComponents(
|
|
|
734
747
|
if (outside.length > 0) {
|
|
735
748
|
return { success: false, selected: [], error: `--target names ${outside.join(", ")}, which this run does not run` };
|
|
736
749
|
}
|
|
737
|
-
const targeted =
|
|
750
|
+
const targeted = {
|
|
751
|
+
...(Object.keys(narrowed).length > 0 ? { targets: narrowed } : {}),
|
|
752
|
+
// #4594: the grain and the lease reach every step through its DeployContext.
|
|
753
|
+
...(options.lockGrain ? { lockGrain: options.lockGrain } : {}),
|
|
754
|
+
...(options.rowLease ? { rowLease: options.rowLease } : {}),
|
|
755
|
+
};
|
|
756
|
+
if (options.adoption && (selector === "all" || isComponentList(selector))) {
|
|
757
|
+
return { success: false, selected: [], error: `--adopt adopts into one component's stack; name one component, not ${selector === "all" ? "all" : "a list"}` };
|
|
758
|
+
}
|
|
738
759
|
// Cross-component/cross-stack outputs to resolve references against. Seeded
|
|
739
760
|
// from a caller (a downstream CI job passing an upstream job's dumped
|
|
740
761
|
// outputs via `--seed-outputs`); grows as this run's components complete.
|
|
@@ -829,7 +850,7 @@ export async function runComponents(
|
|
|
829
850
|
emit?.({ type: "component-start", wave: 1, component: componentName });
|
|
830
851
|
const componentResult = await runComponentDeploy(
|
|
831
852
|
resolvedTargets[0],
|
|
832
|
-
deployContext({ env, releaseIdentity, ...targeted }, componentName),
|
|
853
|
+
{ ...deployContext({ env, releaseIdentity, ...targeted }, componentName), ...(options.adoption ? { adoption: options.adoption } : {}) },
|
|
833
854
|
registry,
|
|
834
855
|
componentOutputs,
|
|
835
856
|
undefined,
|
|
@@ -1192,7 +1192,7 @@ describe("a step that refuses a moved plan (#3997)", () => {
|
|
|
1192
1192
|
expect(isPlanMovedError("planMoved")).toBe(false);
|
|
1193
1193
|
});
|
|
1194
1194
|
|
|
1195
|
-
it("marks the failed step's record, and failedRunExitCode answers
|
|
1195
|
+
it("marks the failed step's record, and failedRunExitCode answers 4 for it and 1 for any other failure", async () => {
|
|
1196
1196
|
const run = async (mark: object) => {
|
|
1197
1197
|
const registry = new CapabilityRegistry();
|
|
1198
1198
|
registry.register(fakeCapability("apply", { run: () => { throw Object.assign(new Error("refused"), mark); } }).capability);
|
|
@@ -1201,10 +1201,10 @@ describe("a step that refuses a moved plan (#3997)", () => {
|
|
|
1201
1201
|
};
|
|
1202
1202
|
const moved = await run({ exitCode: 3 });
|
|
1203
1203
|
expect(moved.records[0]).toMatchObject({ status: "fail", planMoved: true });
|
|
1204
|
-
expect(failedRunExitCode([moved])).toBe(
|
|
1204
|
+
expect(failedRunExitCode([moved])).toBe(4);
|
|
1205
1205
|
const other = await run({ exitCode: 7 });
|
|
1206
1206
|
expect(other.records[0]).not.toHaveProperty("planMoved");
|
|
1207
1207
|
expect(failedRunExitCode([other])).toBe(1);
|
|
1208
|
-
expect(failedRunExitCode([other, moved])).toBe(
|
|
1208
|
+
expect(failedRunExitCode([other, moved])).toBe(4);
|
|
1209
1209
|
});
|
|
1210
1210
|
});
|
package/src/components/driver.ts
CHANGED
|
@@ -46,7 +46,10 @@
|
|
|
46
46
|
* `CapabilityRegistry` the caller supplies.
|
|
47
47
|
*/
|
|
48
48
|
|
|
49
|
+
import type { LockGrain } from "../lifecycle/lock-rows";
|
|
50
|
+
import { isLockRowsHeldError, leaseCapabilityStep, type RowLease, type RowLeasePort } from "./row-lease";
|
|
49
51
|
import { topoSort } from "../codegen/topo-sort";
|
|
52
|
+
import { CHANT_EXIT } from "../exit-codes";
|
|
50
53
|
import { kahnLayers } from "./layers";
|
|
51
54
|
import { evaluateGate, gitGateLedgerPort, type GateDigestMismatch, type GateLedgerPort } from "../op/gate";
|
|
52
55
|
import { gateName } from "../op/gate-name";
|
|
@@ -159,6 +162,8 @@ export interface DriverStepRecord {
|
|
|
159
162
|
error?: string;
|
|
160
163
|
/** Set on a failed step whose capability refused a plan that moved since it was approved (`isPlanMovedError`, #3997). */
|
|
161
164
|
planMoved?: true;
|
|
165
|
+
/** Set on a failed step or group member whose rows another live run holds (#4594): nothing of it applied, and the command exits 5. */
|
|
166
|
+
held?: true;
|
|
162
167
|
/** Set on a `gate` step that passed (#2119): who resolved it, when, and at what address. */
|
|
163
168
|
approval?: {
|
|
164
169
|
gate: string;
|
|
@@ -586,9 +591,13 @@ async function runCapabilityStep(
|
|
|
586
591
|
const { kind, ...rest } = step;
|
|
587
592
|
const resolvedInput = resolveStepInput(rest, phaseOutputs, componentOutputs);
|
|
588
593
|
const start = Date.now();
|
|
594
|
+
let lease: RowLease | undefined;
|
|
589
595
|
try {
|
|
590
596
|
const capability = registry.resolve(kind);
|
|
591
|
-
|
|
597
|
+
// #4594: on the resource grain, a run that plans inside its steps leases the step's rows first and applies the plan it leased for.
|
|
598
|
+
const leased = await leaseCapabilityStep(capability, ctx, resolvedInput);
|
|
599
|
+
lease = leased.lease;
|
|
600
|
+
const output = await capability.run(leased.ctx, resolvedInput as never);
|
|
592
601
|
return {
|
|
593
602
|
record: {
|
|
594
603
|
component: ctx.component,
|
|
@@ -611,9 +620,12 @@ async function runCapabilityStep(
|
|
|
611
620
|
durationMs: Date.now() - start,
|
|
612
621
|
error: errMessage(err),
|
|
613
622
|
...(isPlanMovedError(err) ? { planMoved: true as const } : {}),
|
|
623
|
+
...(isLockRowsHeldError(err) ? { held: true as const } : {}),
|
|
614
624
|
},
|
|
615
625
|
resolvedInput,
|
|
616
626
|
};
|
|
627
|
+
} finally {
|
|
628
|
+
await lease?.release();
|
|
617
629
|
}
|
|
618
630
|
}
|
|
619
631
|
|
|
@@ -674,6 +686,8 @@ async function runPhase(
|
|
|
674
686
|
...(gates.planDigest !== undefined ? { planDigest: gates.planDigest } : {}),
|
|
675
687
|
// #4045: and under a release, only for that release.
|
|
676
688
|
...(gates.releaseGate ? { releaseDigest: gates.releaseGate.releaseDigest } : {}),
|
|
689
|
+
// #4551: a release gate's plan digest is its change set's, so the fact cites it.
|
|
690
|
+
...(gates.releaseGate && gates.planDigest !== undefined ? { fields: { changeSet: gates.planDigest } } : {}),
|
|
677
691
|
...(gates.releaseGate?.verifyEmpty ? { verifyEmpty: gates.releaseGate.verifyEmpty } : {}),
|
|
678
692
|
...(gate.description ? { description: gate.description } : {}),
|
|
679
693
|
...(gate.timeout ? { timeout: gate.timeout } : {}),
|
|
@@ -1133,13 +1147,19 @@ export function planMovedIn(results: readonly DriverComponentResult[]): boolean
|
|
|
1133
1147
|
return results.some((r) => r.records.some((s) => s.planMoved === true));
|
|
1134
1148
|
}
|
|
1135
1149
|
|
|
1150
|
+
/** Whether a step or group member in `results` found its rows held by another live run (#4594). */
|
|
1151
|
+
export function rowsHeldIn(results: readonly DriverComponentResult[]): boolean {
|
|
1152
|
+
return results.some((r) => r.records.some((s) => s.held === true));
|
|
1153
|
+
}
|
|
1154
|
+
|
|
1136
1155
|
/**
|
|
1137
1156
|
* The exit code of a run that failed: {@link PLAN_MOVED_EXIT_CODE} when a
|
|
1138
|
-
* step refused a plan that moved since it was approved,
|
|
1139
|
-
*
|
|
1157
|
+
* step refused a plan that moved since it was approved, 5 (`held`) when a
|
|
1158
|
+
* step's rows were held by another run (#4594), 1 otherwise. Every command
|
|
1159
|
+
* that runs capability steps ends a failed run with it.
|
|
1140
1160
|
*/
|
|
1141
1161
|
export function failedRunExitCode(results: readonly DriverComponentResult[]): number {
|
|
1142
|
-
return planMovedIn(results) ? PLAN_MOVED_EXIT_CODE :
|
|
1162
|
+
return planMovedIn(results) ? PLAN_MOVED_EXIT_CODE : rowsHeldIn(results) ? CHANT_EXIT.held : CHANT_EXIT.failed;
|
|
1143
1163
|
}
|
|
1144
1164
|
|
|
1145
1165
|
function errMessage(err: unknown): string {
|
|
@@ -1189,6 +1209,10 @@ export interface InterpretRunOptions {
|
|
|
1189
1209
|
targets?: Readonly<Record<string, readonly string[]>>;
|
|
1190
1210
|
/** Groups applied as one (ws-107, #4465). See {@link InterpretGroups}. Absent: every component runs its own deploy. */
|
|
1191
1211
|
groups?: InterpretGroups;
|
|
1212
|
+
/** `ci.lockGrain` as declared (#4594), for every step's `DeployContext.lockGrain`. Absent: each step takes its lexicon's default. */
|
|
1213
|
+
lockGrain?: LockGrain;
|
|
1214
|
+
/** The run's row lease (#4594): each step on the resource grain leases its rows through it (./row-lease.ts). Absent: no lease. */
|
|
1215
|
+
rowLease?: RowLeasePort;
|
|
1192
1216
|
}
|
|
1193
1217
|
|
|
1194
1218
|
/**
|
|
@@ -1236,6 +1260,12 @@ export function deployContext(
|
|
|
1236
1260
|
vars?: Record<string, unknown>;
|
|
1237
1261
|
releaseIdentity?: (component: string) => ReleaseIdentity | undefined;
|
|
1238
1262
|
targets?: Readonly<Record<string, readonly string[]>>;
|
|
1263
|
+
/** `ci.lockGrain` as declared at base (#4552), for every step's `DeployContext.lockGrain`. */
|
|
1264
|
+
lockGrain?: LockGrain;
|
|
1265
|
+
/** The commit policy is read at (#4613), for every step's `DeployContext.policyBase`. */
|
|
1266
|
+
policyBase?: string;
|
|
1267
|
+
/** The run's row lease (#4594), for every step's `DeployContext.rowLease`. */
|
|
1268
|
+
rowLease?: RowLeasePort;
|
|
1239
1269
|
},
|
|
1240
1270
|
component: string,
|
|
1241
1271
|
): DeployContext {
|
|
@@ -1245,6 +1275,9 @@ export function deployContext(
|
|
|
1245
1275
|
env: options.env,
|
|
1246
1276
|
component,
|
|
1247
1277
|
...(options.vars ? { vars: options.vars } : {}),
|
|
1278
|
+
...(options.lockGrain ? { lockGrain: options.lockGrain } : {}),
|
|
1279
|
+
...(options.policyBase ? { policyBase: options.policyBase } : {}),
|
|
1280
|
+
...(options.rowLease ? { rowLease: options.rowLease } : {}),
|
|
1248
1281
|
...(release ? { release: { ...release } } : {}),
|
|
1249
1282
|
...(targets && targets.length > 0 ? { targets: [...new Set(targets)].sort() } : {}),
|
|
1250
1283
|
};
|
|
@@ -1256,7 +1289,7 @@ export function deployContext(
|
|
|
1256
1289
|
* such verb, in composition order. A step whose kind is not registered
|
|
1257
1290
|
* refuses too. Does nothing when `ctx.targets` is absent.
|
|
1258
1291
|
*/
|
|
1259
|
-
export function assertTargetsAccepted(component: DriverComponent, registry: CapabilityRegistry, ctx: DeployContext): void {
|
|
1292
|
+
export function assertTargetsAccepted(component: DriverComponent, registry: CapabilityRegistry, ctx: Pick<DeployContext, "targets">): void {
|
|
1260
1293
|
if (!ctx.targets || ctx.targets.length === 0) return;
|
|
1261
1294
|
const walk = (steps: DriverPhase["steps"]): void => {
|
|
1262
1295
|
for (const step of steps) {
|