@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,341 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The product pipeline (#4550): the one chant generator terragucci's and
|
|
3
|
+
* plywood's pull request jobs come from. The two differ only in the words
|
|
4
|
+
* and presets each passes.
|
|
5
|
+
*
|
|
6
|
+
* Under the 2026-10-27 ruling (A, hybrid) the plan side is the pull request
|
|
7
|
+
* loop's: the plan job (`pr-plan`), the plan-note job (`pr-post`) and the
|
|
8
|
+
* comment jobs. The apply on merge runs on op waves: one job per wave, each
|
|
9
|
+
* running `chant run wave`, whose plan and apply steps come from chant's
|
|
10
|
+
* capabilities (#4545 for Terraform, #4541 for Pulumi and plunge). The spec
|
|
11
|
+
* names the steps; this module fills the op and gate names from the words
|
|
12
|
+
* and leaves the steps as the spec gives them.
|
|
13
|
+
*
|
|
14
|
+
* Approvals (ruling B) are a preset: `per-wave` keeps each wave's own digest
|
|
15
|
+
* (terragucci), and `pull-request` lets the pull request's approval apply
|
|
16
|
+
* every wave whose plan its change set covers (plywood), through the op
|
|
17
|
+
* waves' `pull-request` approval source (../op/op-waves.ts).
|
|
18
|
+
*
|
|
19
|
+
* The jobs come back as the descriptors the forge lexicons already
|
|
20
|
+
* serialize (`PrLoopJob`, `OpWaveJob`). A product adds its own jobs to the
|
|
21
|
+
* same map before it writes the file.
|
|
22
|
+
*/
|
|
23
|
+
|
|
24
|
+
import type { ForgeKind } from "../pr-forge";
|
|
25
|
+
import { layerWaves } from "../gated-waves";
|
|
26
|
+
import { opWaveBinArgv, opWaveJobs, opWavesControlTarget, type OpWave, type OpWaveJob, type OpWavesSpec } from "../op/op-waves";
|
|
27
|
+
import { controlNoteCheckout, type ControlNoteCheckout } from "../control/dispatch";
|
|
28
|
+
import {
|
|
29
|
+
assertProductWords,
|
|
30
|
+
CHANT_WORDS,
|
|
31
|
+
commentLine,
|
|
32
|
+
type CiProductApplyMode,
|
|
33
|
+
type CiProductCommand,
|
|
34
|
+
type CiProductWords,
|
|
35
|
+
type CiProductWordsInput,
|
|
36
|
+
} from "../ci-product-words";
|
|
37
|
+
import { prCommentLockJobs, prCommentPreviewJob, prLoopJobs, prLoopPostJob, withProductBin, type PrCommentLockJob, type PrCommentPreviewJob, type PrLoopJob, type PrLoopPipelineOptions } from "./pr-pipeline";
|
|
38
|
+
import type { DriverComponent } from "./driver";
|
|
39
|
+
import type { ScheduledOpSpec } from "../lexicon";
|
|
40
|
+
import type { CiRunner } from "../ci-jobs";
|
|
41
|
+
import { resolveAgentSpec, type OpAgentSpec } from "../ci-agent";
|
|
42
|
+
|
|
43
|
+
/** Where the generator writes a product's waves spec, which chant reads at base (#4550). */
|
|
44
|
+
export const PRODUCT_WAVES_SPEC_DIR = ".chant/op-waves";
|
|
45
|
+
|
|
46
|
+
/** The waves spec file of op `name`: `.chant/op-waves/<name>.spec.json`. */
|
|
47
|
+
export function productWavesSpecFile(name: string): string {
|
|
48
|
+
return `${PRODUCT_WAVES_SPEC_DIR}/${name}.spec.json`;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** What {@link productPipelineJobs} takes: the pull request loop's options, the words, and the waves the merge applies. */
|
|
52
|
+
export interface ProductPipelineOptions extends Omit<PrLoopPipelineOptions, "words" | "waveGate" | "applyOnMerge"> {
|
|
53
|
+
words: CiProductWordsInput | CiProductWords;
|
|
54
|
+
/** The workspace member the pipeline is for. */
|
|
55
|
+
member?: string;
|
|
56
|
+
/**
|
|
57
|
+
* The waves the apply on merge runs, as the product's config maps onto
|
|
58
|
+
* them. Absent: a merge records the plan (the record job), and a release
|
|
59
|
+
* deploys it.
|
|
60
|
+
*/
|
|
61
|
+
waves?: OpWavesSpec;
|
|
62
|
+
/** Where the spec is written, from the job's directory. Default {@link productWavesSpecFile}. */
|
|
63
|
+
wavesSpecFile?: string;
|
|
64
|
+
/**
|
|
65
|
+
* The product runs an agent job that answers its agent command (#4616):
|
|
66
|
+
* `true` for the defaults, or the agent's settings. The pipeline then
|
|
67
|
+
* returns the agent's Op spec, which the product writes and generates with
|
|
68
|
+
* `chant run --generate <forge> --spec <file>` as it does its other
|
|
69
|
+
* scheduled Ops.
|
|
70
|
+
*/
|
|
71
|
+
agent?: boolean | ProductAgentOptions;
|
|
72
|
+
/**
|
|
73
|
+
* The apply on merge from the component graph (#4588), when `waves` is
|
|
74
|
+
* absent: the spec `pr-apply --wave-gate` runs, a wave per layer of
|
|
75
|
+
* `components`, each run a component planned and applied through the
|
|
76
|
+
* component plan-wave and apply-wave steps, a wave whose plan the approval
|
|
77
|
+
* does not cover waiting at `<waveGate>-wave-<k>`. `base` is what the
|
|
78
|
+
* steps measure the change from, by default `HEAD^1`, the commit before
|
|
79
|
+
* the merge.
|
|
80
|
+
*/
|
|
81
|
+
componentWaves?: { components: readonly Pick<DriverComponent, "name" | "dependsOn">[]; waveGate?: string; base?: string };
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/** The jobs of one product pipeline. */
|
|
85
|
+
export interface ProductPipelineJobs {
|
|
86
|
+
/** The words, every slot filled and checked. */
|
|
87
|
+
words: CiProductWords;
|
|
88
|
+
/** The plan job: `pr-plan` with the words. */
|
|
89
|
+
plan: PrLoopJob;
|
|
90
|
+
/**
|
|
91
|
+
* The plan-note job: `pr-post`. With a control repo named on the loop's
|
|
92
|
+
* `control` or the waves spec's (#4619), `control` is the step the note
|
|
93
|
+
* job runs before `pr-post`: a read-only fetch of the control repo's
|
|
94
|
+
* `chant/lifecycle` that sets `CHANT_CONTROL_DIR`, so the note marks the
|
|
95
|
+
* cross-stack edges.
|
|
96
|
+
*/
|
|
97
|
+
post: { command: string; env: Record<string, string>; control?: ControlNoteCheckout };
|
|
98
|
+
/** The record job, when no waves apply on merge. */
|
|
99
|
+
record?: PrLoopJob;
|
|
100
|
+
/** The apply before merge, answering the apply comment, with `applyBeforeMerge`. */
|
|
101
|
+
applyBeforeMerge?: PrLoopJob;
|
|
102
|
+
/** The comment each command answers, `/<product> <word>`, for the commands the pipeline has a job for. */
|
|
103
|
+
comments: Partial<Record<CiProductCommand, string>>;
|
|
104
|
+
/** The apply on merge: the spec with the words' names, its file, and a job per wave (per share or group). */
|
|
105
|
+
waves?: { spec: OpWavesSpec; specFile: string; jobs: OpWaveJob[] };
|
|
106
|
+
/**
|
|
107
|
+
* The comment lock and unlock jobs (#4588), under `locks: "plan"`:
|
|
108
|
+
* `/<product> lock` keeps the locks the plan took, `/<product> unlock`
|
|
109
|
+
* releases them. The forge lexicons render the same jobs.
|
|
110
|
+
*/
|
|
111
|
+
locks?: PrCommentLockJob[];
|
|
112
|
+
/**
|
|
113
|
+
* The comment preview (#4620), with `previewComment`: `/<product> <plan
|
|
114
|
+
* word>` plans the pull request's head again with a read token, and the
|
|
115
|
+
* job after it posts the note. The forge lexicons render the same jobs.
|
|
116
|
+
*/
|
|
117
|
+
preview?: PrCommentPreviewJob;
|
|
118
|
+
/**
|
|
119
|
+
* The agent (#4616), with `agent`: the comment it answers, `/<product>
|
|
120
|
+
* agent <ask>`, and the scheduled Op spec whose generated workflow runs
|
|
121
|
+
* it: the agent job with a read token and the model's key, and the push
|
|
122
|
+
* job with the write token.
|
|
123
|
+
*/
|
|
124
|
+
agent?: { comment: string; name: string; spec: ScheduledOpSpec };
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/** An agent's settings as a product passes them (#4616): {@link OpAgentSpec} without the trigger, which the pipeline names. */
|
|
128
|
+
export interface ProductAgentOptions extends Omit<OpAgentSpec, "on" | "comment" | "branch"> {
|
|
129
|
+
/** The agent's name: its workflow, its jobs and its runs on the ledger. Default `<product>-agent`. */
|
|
130
|
+
name?: string;
|
|
131
|
+
/** Where its jobs run. */
|
|
132
|
+
runner?: CiRunner;
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/** The agent's Op spec for `/<product> agent <ask>` (#4616). The settings are checked here, so a product finds a bad one when it generates. */
|
|
136
|
+
export function productAgentSpec(wordsIn: CiProductWordsInput | CiProductWords, comment: string, options: ProductAgentOptions = {}): ScheduledOpSpec {
|
|
137
|
+
const words = assertProductWords(wordsIn);
|
|
138
|
+
const { name: given, runner, ...settings } = options;
|
|
139
|
+
const name = given ?? `${words.product}-agent`;
|
|
140
|
+
const agent: OpAgentSpec = { on: "comment", comment, ...settings };
|
|
141
|
+
resolveAgentSpec(name, agent, words.product);
|
|
142
|
+
return { name, trigger: { kind: "pull_request" }, agent, ...(runner !== undefined ? { runner } : {}) };
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
/**
|
|
146
|
+
* The `agent` of a scheduled drift Op (#4616): after the Op's run exits with
|
|
147
|
+
* chant's `drift` code, the agent changes the code to say what is live and
|
|
148
|
+
* opens or updates a pull request from `<product>/agent/<op>`.
|
|
149
|
+
*/
|
|
150
|
+
export function productDriftAgent(wordsIn: CiProductWordsInput | CiProductWords, op: string, options: Omit<OpAgentSpec, "on" | "comment"> = {}): OpAgentSpec {
|
|
151
|
+
const words = assertProductWords(wordsIn);
|
|
152
|
+
const agent: OpAgentSpec = { on: "drift", ...options };
|
|
153
|
+
resolveAgentSpec(op, agent, words.product);
|
|
154
|
+
return agent;
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
/**
|
|
158
|
+
* The waves spec with the product's names (#4550): the op the gates are
|
|
159
|
+
* recorded under, the wave gate pattern, and under the `pull-request`
|
|
160
|
+
* preset each wave's approval taken from the pull request's gate. A wave
|
|
161
|
+
* that names its own approval keeps it. Nothing else changes, so the plan
|
|
162
|
+
* and apply steps stay the capability steps the spec names.
|
|
163
|
+
*/
|
|
164
|
+
export function productWavesSpec(spec: OpWavesSpec, wordsIn: CiProductWordsInput | CiProductWords): OpWavesSpec {
|
|
165
|
+
const words = assertProductWords(wordsIn);
|
|
166
|
+
const byPullRequest = words.approval === "pull-request";
|
|
167
|
+
return {
|
|
168
|
+
...spec,
|
|
169
|
+
name: words.op ?? spec.name,
|
|
170
|
+
...(words.gateName !== CHANT_WORDS.gateName ? { gateName: words.gateName } : {}),
|
|
171
|
+
waves: spec.waves.map((w): OpWave => (byPullRequest && w.approval === undefined ? { ...w, approval: "pull-request" } : w)),
|
|
172
|
+
...(byPullRequest ? { approvals: { ...(spec.approvals ?? {}), pullRequest: { gate: words.prGate } } } : {}),
|
|
173
|
+
};
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
/**
|
|
177
|
+
* The product pipeline's jobs for `forge` (#4550): the plan side from the
|
|
178
|
+
* pull request loop with the words, and the apply on merge on op waves. The
|
|
179
|
+
* words are refused when a command names a job the pipeline does not have.
|
|
180
|
+
*/
|
|
181
|
+
export function productPipelineJobs(forge: ForgeKind, env: string, options: ProductPipelineOptions): ProductPipelineJobs {
|
|
182
|
+
const jobs: CiProductCommand[] = ["plan"];
|
|
183
|
+
if (options.applyBeforeMerge || options.waves || options.componentWaves) jobs.push("apply");
|
|
184
|
+
if (options.locks === "plan") jobs.push("lock", "unlock");
|
|
185
|
+
if (options.agent) jobs.push("agent");
|
|
186
|
+
// #4601: the note's merge sentence follows the jobs built here: waves on merge, an apply before merge, else a record for a release.
|
|
187
|
+
// Words that ask for before-merge keep it when the pipeline has that job beside its waves.
|
|
188
|
+
const built: CiProductApplyMode = options.waves || options.componentWaves ? "on-merge" : options.applyBeforeMerge ? "before-merge" : "release";
|
|
189
|
+
const applyMode: CiProductApplyMode = options.words.applyMode === "before-merge" && options.applyBeforeMerge ? "before-merge" : built;
|
|
190
|
+
const words = assertProductWords({ ...options.words, applyMode }, { jobs });
|
|
191
|
+
const { waves: given, wavesSpecFile, member, agent: _agent, componentWaves, ...loop } = options;
|
|
192
|
+
const prLoop: PrLoopPipelineOptions = { ...loop, words, gate: options.gate ?? words.prGate };
|
|
193
|
+
const [plan, apply, record] = prLoopJobs(forge, env, prLoop, member);
|
|
194
|
+
const comments: Partial<Record<CiProductCommand, string>> = {};
|
|
195
|
+
for (const c of jobs) {
|
|
196
|
+
const line = commentLine(words, c);
|
|
197
|
+
if (line) comments[c] = line;
|
|
198
|
+
}
|
|
199
|
+
// #4619: the loop's control target, else the waves spec's.
|
|
200
|
+
const controlTarget = options.control?.target ?? (given?.control ? opWavesControlTarget(given.control) : undefined);
|
|
201
|
+
const out: ProductPipelineJobs = {
|
|
202
|
+
words,
|
|
203
|
+
plan: plan!,
|
|
204
|
+
post: { ...prLoopPostJob(forge, env, member, words), ...(controlTarget ? { control: controlNoteCheckout(forge, controlTarget, words) } : {}) },
|
|
205
|
+
comments,
|
|
206
|
+
...(options.applyBeforeMerge ? { applyBeforeMerge: apply! } : {}),
|
|
207
|
+
};
|
|
208
|
+
const locks = prCommentLockJobs(forge, { locks: options.locks, words });
|
|
209
|
+
if (locks.length > 0) out.locks = locks;
|
|
210
|
+
const preview = prCommentPreviewJob(forge, env, prLoop, member);
|
|
211
|
+
if (preview) out.preview = preview;
|
|
212
|
+
// #4616: the agent answers its comment from a workflow of its own, generated from this spec.
|
|
213
|
+
const agentComment = options.agent ? comments.agent : undefined;
|
|
214
|
+
if (options.agent && agentComment) {
|
|
215
|
+
const spec = productAgentSpec(words, agentComment, options.agent === true ? {} : options.agent);
|
|
216
|
+
out.agent = { comment: agentComment, name: spec.name, spec };
|
|
217
|
+
}
|
|
218
|
+
// #4588: without a spec of the product's own, the component graph's waves on op waves.
|
|
219
|
+
const op = words.op ?? componentWaves?.waveGate ?? words.prGate;
|
|
220
|
+
const spec = given ?? (componentWaves
|
|
221
|
+
? componentWavesSpec(componentWaves.components, words, componentWaveSteps({ ...(words.bin ? { bin: words.bin } : {}), env, base: componentWaves.base ?? "HEAD^1", ...(member ? { member } : {}), op, gate: prLoop.gate }), { ...(componentWaves.waveGate ? { gate: componentWaves.waveGate } : {}) })
|
|
222
|
+
: undefined);
|
|
223
|
+
if (!spec) return { ...out, record: record! };
|
|
224
|
+
const named = productWavesSpec(spec, words);
|
|
225
|
+
const specFile = wavesSpecFile ?? productWavesSpecFile(named.name);
|
|
226
|
+
return { ...out, waves: { spec: named, specFile, jobs: opWaveJobs(named, specFile, { bin: words.bin }) } };
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
/** The capability steps a component waves spec runs (#4545, #4541): argv templates over `{runs}` and `{plans}`. */
|
|
230
|
+
export interface ComponentWaveSteps {
|
|
231
|
+
/** Plan every run of a wave through the capability registry, writing `{plans}`. */
|
|
232
|
+
planWave: string[];
|
|
233
|
+
/** Apply a wave's approved set through the capability registry. */
|
|
234
|
+
applyWave: string[];
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
/** Where a component waves spec keeps the outputs each wave's components left, for the next wave's plans (#4588). */
|
|
238
|
+
export function componentWaveOutputsFile(op: string): string {
|
|
239
|
+
return `${PRODUCT_WAVES_SPEC_DIR}/${op}/outputs.json`;
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
/** What {@link componentWaveSteps} names on each step's line (#4588). */
|
|
243
|
+
export interface ComponentWaveStepOptions {
|
|
244
|
+
/** The command in place of `chant`, a product's `words.bin`. */
|
|
245
|
+
bin?: string;
|
|
246
|
+
env: string;
|
|
247
|
+
/** The commit the change is measured from: what `pr-apply` was given. */
|
|
248
|
+
base: string;
|
|
249
|
+
/** The commit applied. Absent: the job's checkout. */
|
|
250
|
+
head?: string;
|
|
251
|
+
/** The workspace member. */
|
|
252
|
+
member?: string;
|
|
253
|
+
/** The file the waves hand outputs on in. Default {@link componentWaveOutputsFile} of `op`. */
|
|
254
|
+
outputs?: string;
|
|
255
|
+
/** The op the outputs file is named by. */
|
|
256
|
+
op: string;
|
|
257
|
+
/** The pull request's gate, whose rows file the apply leases on the resource grain. */
|
|
258
|
+
gate?: string;
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
/**
|
|
262
|
+
* The component plan-wave and apply-wave steps (#4588): `chant components
|
|
263
|
+
* plan-wave` plans a wave's components through the project's capabilities
|
|
264
|
+
* and writes the op-waves plans file with the wave's change set, and
|
|
265
|
+
* `chant components apply-wave` plans the approved runs again, refuses any
|
|
266
|
+
* whose plan moved (exit 4), and applies the rest. Both read the outputs
|
|
267
|
+
* the waves before them left from the outputs file, and apply-wave adds its
|
|
268
|
+
* own.
|
|
269
|
+
*/
|
|
270
|
+
export function componentWaveSteps(options: ComponentWaveStepOptions): ComponentWaveSteps {
|
|
271
|
+
const bin = opWaveBinArgv(options.bin);
|
|
272
|
+
const common = [
|
|
273
|
+
"--env", options.env, "--base", options.base,
|
|
274
|
+
...(options.head ? ["--head", options.head] : []),
|
|
275
|
+
...(options.member ? ["--member", options.member] : []),
|
|
276
|
+
...(options.gate ? ["--gate", options.gate] : []),
|
|
277
|
+
"--wave-outputs", options.outputs ?? componentWaveOutputsFile(options.op),
|
|
278
|
+
];
|
|
279
|
+
return {
|
|
280
|
+
planWave: [...bin, "components", "plan-wave", "--runs", "{runs}", "--plans", "{plans}", ...common],
|
|
281
|
+
applyWave: [...bin, "components", "apply-wave", "--runs", "{runs}", "--plans", "{plans}", ...common],
|
|
282
|
+
};
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
/** What {@link componentWavesSpec} takes beside the graph, the words and the steps. */
|
|
286
|
+
export interface ComponentWavesSpecOptions {
|
|
287
|
+
/** The wave gate's base name: wave k waits at `<gate>-wave-<k>` (or the words' `gateName`). Default the words' `prGate`. */
|
|
288
|
+
gate?: string;
|
|
289
|
+
branches?: string[];
|
|
290
|
+
/**
|
|
291
|
+
* The op the gates are recorded under. `pr-apply --wave-gate` passes the
|
|
292
|
+
* pull request's (`pr-<n>`), and then every wave takes the pull request's
|
|
293
|
+
* approval whatever the words' preset. Default the words' `op`.
|
|
294
|
+
*/
|
|
295
|
+
op?: string;
|
|
296
|
+
/** The pull request's gate, whose approval a wave applies under when it covers the wave. Default the words' `prGate`. */
|
|
297
|
+
prGate?: string;
|
|
298
|
+
/** The layers, when the caller already has them (a derivation's `waves`). Default: layered from `dependsOn`. */
|
|
299
|
+
waves?: readonly (readonly string[])[];
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
/**
|
|
303
|
+
* A waves spec from the component graph (#4550, ruling A; #4588): a wave per
|
|
304
|
+
* layer of the graph, each run a component, planned and applied through the
|
|
305
|
+
* component plan-wave and apply-wave steps under the words' op and gate
|
|
306
|
+
* names. `pr-apply --wave-gate` runs its waves on it.
|
|
307
|
+
*/
|
|
308
|
+
export function componentWavesSpec(
|
|
309
|
+
components: readonly Pick<DriverComponent, "name" | "dependsOn">[],
|
|
310
|
+
wordsIn: CiProductWordsInput | CiProductWords,
|
|
311
|
+
steps: ComponentWaveSteps,
|
|
312
|
+
options: ComponentWavesSpecOptions = {},
|
|
313
|
+
): OpWavesSpec {
|
|
314
|
+
const words = assertProductWords(wordsIn);
|
|
315
|
+
const layers = options.waves ?? layerWaves(components.map((c) => ({ name: c.name, dependsOn: c.dependsOn ?? [] })));
|
|
316
|
+
const name = options.op ?? words.op ?? options.gate ?? words.prGate;
|
|
317
|
+
const spec: OpWavesSpec = {
|
|
318
|
+
name,
|
|
319
|
+
op: name,
|
|
320
|
+
gate: options.gate ?? words.prGate,
|
|
321
|
+
planWave: steps.planWave,
|
|
322
|
+
applyWave: steps.applyWave,
|
|
323
|
+
...(options.branches ? { branches: options.branches } : {}),
|
|
324
|
+
waves: layers.map((layer, i) => ({ name: `wave-${i + 1}`, runs: layer.map((target) => ({ target })) })),
|
|
325
|
+
};
|
|
326
|
+
const named = productWavesSpec(spec, words);
|
|
327
|
+
if (options.op === undefined) return named;
|
|
328
|
+
// The pull request's own op: every wave applies under its approval when that covers the wave's plan, else at its own gate.
|
|
329
|
+
return {
|
|
330
|
+
...named,
|
|
331
|
+
name: options.op,
|
|
332
|
+
op: options.op,
|
|
333
|
+
waves: named.waves.map((w) => ({ ...w, approval: "pull-request" as const })),
|
|
334
|
+
approvals: { ...(named.approvals ?? {}), pullRequest: { gate: options.prGate ?? words.prGate } },
|
|
335
|
+
};
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
/** A shell line with the product's bin in place of `chant`, for a product's own jobs beside these. */
|
|
339
|
+
export function productCommand(words: CiProductWords, line: string): string {
|
|
340
|
+
return withProductBin(line, words.bin);
|
|
341
|
+
}
|
|
@@ -61,6 +61,8 @@ import { planAndRunComponentGroup, runComponentGroup } from "./groups";
|
|
|
61
61
|
import type { Release } from "../lifecycle/release-store";
|
|
62
62
|
import type { RunProgressEvent } from "./run-progress";
|
|
63
63
|
import type { RunEventSink } from "../run-event-stream";
|
|
64
|
+
import type { LockGrain } from "../lifecycle/lock-rows";
|
|
65
|
+
import type { RowLeasePort } from "./row-lease";
|
|
64
66
|
|
|
65
67
|
/**
|
|
66
68
|
* Step kinds that produce an artifact at build time: the build family, and the
|
|
@@ -651,6 +653,10 @@ export interface RunPromotionOptions {
|
|
|
651
653
|
groupRuns?: readonly GroupRun[];
|
|
652
654
|
/** A promote with no release gate to bind plans each group in its wave (#4465). */
|
|
653
655
|
planGroupsAtWave?: boolean;
|
|
656
|
+
/** `ci.lockGrain` as declared (#4594), for every step's `DeployContext.lockGrain`. */
|
|
657
|
+
lockGrain?: LockGrain;
|
|
658
|
+
/** 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. */
|
|
659
|
+
rowLease?: RowLeasePort;
|
|
654
660
|
}
|
|
655
661
|
|
|
656
662
|
/** The run in `runs` that plans exactly the members of `group`. */
|
|
@@ -678,6 +684,8 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
|
|
|
678
684
|
const item = plan.items.find((i) => i.component === component);
|
|
679
685
|
return item ? { version: item.digest, revision: item.source.gitSha } : undefined;
|
|
680
686
|
};
|
|
687
|
+
// #4594: the grain and the row lease reach every step and group.
|
|
688
|
+
const leasing = { ...(options.lockGrain ? { lockGrain: options.lockGrain } : {}), ...(options.rowLease ? { rowLease: options.rowLease } : {}) };
|
|
681
689
|
// ws-107 (#4465): a group applies as one, through its approved plan.
|
|
682
690
|
const grouped = options.grouped?.groups?.length ? options.grouped : undefined;
|
|
683
691
|
const byName = new Map(targets.map((c) => [c.name, c]));
|
|
@@ -691,7 +699,7 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
|
|
|
691
699
|
components: byName,
|
|
692
700
|
registry,
|
|
693
701
|
env: plan.to,
|
|
694
|
-
ctxOf: (name: string) => deployContext({ env: plan.to, releaseIdentity }, name),
|
|
702
|
+
ctxOf: (name: string) => deployContext({ env: plan.to, releaseIdentity, ...leasing }, name),
|
|
695
703
|
componentOutputs,
|
|
696
704
|
};
|
|
697
705
|
const approved = approvedRunOf(options.groupRuns, group);
|
|
@@ -708,6 +716,7 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
|
|
|
708
716
|
releases: expected,
|
|
709
717
|
// #3061: the workload's service.version and vcs.ref.head.revision are the earlier release's own.
|
|
710
718
|
releaseIdentity,
|
|
719
|
+
...leasing,
|
|
711
720
|
...(groups ? { groups } : {}),
|
|
712
721
|
...(options.onProgress ? { onProgress: options.onProgress } : {}),
|
|
713
722
|
...(options.onRunEvent ? { onRunEvent: options.onRunEvent } : {}),
|
|
@@ -24,6 +24,12 @@
|
|
|
24
24
|
* build, as a chart named from a repository, is not recorded, and the
|
|
25
25
|
* promote leaves it as written.
|
|
26
26
|
*
|
|
27
|
+
* Since #4542 a step whose capability answers `releaseInputs` has its files
|
|
28
|
+
* recorded the same way: `terraform-apply` names a root by key, and the
|
|
29
|
+
* terraform lexicon answers the root's directory, its local modules and its
|
|
30
|
+
* var files ({@link stepReleaseInputs}). Each directory is named in `trees`.
|
|
31
|
+
* A step whose files can't be deployed from a copy is printed and left out.
|
|
32
|
+
*
|
|
27
33
|
* A project with no components (#4046) is compiled the way `chant build --env
|
|
28
34
|
* <env> -o <output>` builds it ({@link compileBuildOutput}): every file that
|
|
29
35
|
* build writes is a template with `component: null`, and the target's params
|
|
@@ -43,7 +49,7 @@ import { applyConfigDefaults } from "./config-defaults";
|
|
|
43
49
|
import { fanOutRegistry } from "./fan-out-support";
|
|
44
50
|
import { ARCHIVE_STEP_KINDS, BUILD_STEP_KINDS, PUBLISH_STEP_KINDS } from "./promote";
|
|
45
51
|
import { DriverRunFailure, runInterpretDriver, type DriverComponent, type DriverGate, type DriverPhase, type DriverStep } from "./driver";
|
|
46
|
-
import type { CapabilityRegistry } from "./capability";
|
|
52
|
+
import type { CapabilityRegistry, ReleaseInputs, ReleaseInputsUnbound } from "./capability";
|
|
47
53
|
import { memoryGateLedgerPort } from "../op/gate";
|
|
48
54
|
import type { ReleaseArtifact, ReleaseParam } from "../lifecycle/release-store";
|
|
49
55
|
|
|
@@ -170,6 +176,51 @@ export function recordedInputRefs(component: DriverComponent): RecordedInputRef[
|
|
|
170
176
|
return out;
|
|
171
177
|
}
|
|
172
178
|
|
|
179
|
+
/** A step whose capability answered `releaseInputs` (#4542), with its answer. */
|
|
180
|
+
export interface StepReleaseInputs {
|
|
181
|
+
phase: string;
|
|
182
|
+
/** The step object as it sits in the composition, so a promote can find it again. */
|
|
183
|
+
step: DriverStep;
|
|
184
|
+
answer: ReleaseInputs | ReleaseInputsUnbound;
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/**
|
|
188
|
+
* The steps of `component` whose capability answers `releaseInputs` (#4542),
|
|
189
|
+
* build and publish steps left out. Paths are normalised to `/`-separated
|
|
190
|
+
* and relative to `memberDir`; one that leaves it makes the step unbound,
|
|
191
|
+
* since its copy could not sit under the member's directory. A throw is an
|
|
192
|
+
* unbound answer naming the error.
|
|
193
|
+
*/
|
|
194
|
+
export async function stepReleaseInputs(component: DriverComponent, registry: CapabilityRegistry, memberDir: string): Promise<StepReleaseInputs[]> {
|
|
195
|
+
const out: StepReleaseInputs[] = [];
|
|
196
|
+
for (const { phase, step } of stepsOf(component.deploy)) {
|
|
197
|
+
if (BUILD_STEP_KINDS.includes(step.kind) || PUBLISH_STEP_KINDS.includes(step.kind) || !registry.has(step.kind)) continue;
|
|
198
|
+
const capability = registry.resolve(step.kind);
|
|
199
|
+
if (!capability.releaseInputs) continue;
|
|
200
|
+
const { kind: _kind, ...input } = step;
|
|
201
|
+
let answer: ReleaseInputs | ReleaseInputsUnbound | null;
|
|
202
|
+
try {
|
|
203
|
+
answer = await capability.releaseInputs(input as never, { memberDir });
|
|
204
|
+
} catch (err) {
|
|
205
|
+
answer = { unbound: err instanceof Error ? err.message : String(err) };
|
|
206
|
+
}
|
|
207
|
+
if (answer === null) continue;
|
|
208
|
+
if ("unbound" in answer) {
|
|
209
|
+
out.push({ phase, step, answer });
|
|
210
|
+
continue;
|
|
211
|
+
}
|
|
212
|
+
const norm = (p: string): string => relative(memberDir, resolve(memberDir, p)).split("\\").join("/") || ".";
|
|
213
|
+
const paths = [...new Set(answer.paths.map(norm))].sort();
|
|
214
|
+
const outside = paths.find((p) => p === ".." || p.startsWith("../") || isAbsolute(p));
|
|
215
|
+
if (outside !== undefined) {
|
|
216
|
+
out.push({ phase, step, answer: { unbound: `it reads "${outside}", outside the member's directory, so a recorded copy can't keep its place` } });
|
|
217
|
+
continue;
|
|
218
|
+
}
|
|
219
|
+
out.push({ phase, step, answer: { field: answer.field, dir: norm(answer.dir), paths } });
|
|
220
|
+
}
|
|
221
|
+
return out;
|
|
222
|
+
}
|
|
223
|
+
|
|
173
224
|
/** The fields of a step of `kind` whose paths a cut records and a promote points at the recorded copy. */
|
|
174
225
|
export function recordedFields(kind: string): string[] {
|
|
175
226
|
return [...TEMPLATE_FIELDS, ...(DEPLOY_INPUT_FIELDS[kind] ?? [])];
|
|
@@ -345,6 +396,41 @@ export async function compileEnvironment(inputs: CompileInputs, env: string): Pr
|
|
|
345
396
|
trees.push({ component: ref.component, path: dir });
|
|
346
397
|
}
|
|
347
398
|
}
|
|
399
|
+
// #4542: the files a capability names for a step that names them indirectly, as a terraform root by key.
|
|
400
|
+
let registry: CapabilityRegistry | null | undefined;
|
|
401
|
+
for (const { component } of components) {
|
|
402
|
+
const candidates = stepsOf(component.deploy).some(({ step }) => !BUILD_STEP_KINDS.includes(step.kind) && !PUBLISH_STEP_KINDS.includes(step.kind));
|
|
403
|
+
if (!candidates) continue;
|
|
404
|
+
if (registry === undefined) {
|
|
405
|
+
registry = await fanOutRegistry(inputs.projectDir, config).catch((err: unknown) => {
|
|
406
|
+
console.error(`release compile: the capability plugins did not load, so no step's own files are recorded: ${err instanceof Error ? err.message : String(err)}`);
|
|
407
|
+
return null;
|
|
408
|
+
});
|
|
409
|
+
}
|
|
410
|
+
if (registry === null) break;
|
|
411
|
+
for (const { phase, step, answer } of await stepReleaseInputs(component, registry, inputs.projectDir)) {
|
|
412
|
+
if ("unbound" in answer) {
|
|
413
|
+
console.error(`release compile: component "${component.name}": its ${step.kind} step in phase "${phase}" is not recorded for "${env}": ${answer.unbound}`);
|
|
414
|
+
continue;
|
|
415
|
+
}
|
|
416
|
+
for (const path of answer.paths) {
|
|
417
|
+
const key = `${component.name}\u0000${path}`;
|
|
418
|
+
if (seen.has(key)) continue;
|
|
419
|
+
seen.add(key);
|
|
420
|
+
const file = resolve(inputs.projectDir, path);
|
|
421
|
+
if (!existsSync(file)) continue;
|
|
422
|
+
if (statSync(file).isFile()) {
|
|
423
|
+
templates.push(templateOf(component.name, path, file));
|
|
424
|
+
continue;
|
|
425
|
+
}
|
|
426
|
+
for (const f of directoryFiles(inputs.projectDir, path)) {
|
|
427
|
+
const under = relative(resolve(inputs.projectDir, path), resolve(inputs.projectDir, f)).split("\\").join("/");
|
|
428
|
+
templates.push(templateOf(component.name, path === "." ? under : `${path}/${under}`, resolve(inputs.projectDir, f)));
|
|
429
|
+
}
|
|
430
|
+
trees.push({ component: component.name, path });
|
|
431
|
+
}
|
|
432
|
+
}
|
|
433
|
+
}
|
|
348
434
|
return {
|
|
349
435
|
env,
|
|
350
436
|
params,
|
|
@@ -21,12 +21,23 @@
|
|
|
21
21
|
* chart named from a repository, is left as written. A target cut before
|
|
22
22
|
* #4155 is pinned as it was then: template fields only, other paths read from
|
|
23
23
|
* the checkout.
|
|
24
|
+
*
|
|
25
|
+
* A step whose capability answers `releaseInputs` (#4542), as `terraform-apply`
|
|
26
|
+
* does for its root, is pointed at the component's recorded files as one
|
|
27
|
+
* layout: every file the target records for the component is written under
|
|
28
|
+
* `.chant/release-templates/<digest>/` at its path from the member's
|
|
29
|
+
* directory, so a root's `../modules/x` still resolves, and the step's field
|
|
30
|
+
* names the copy of the directory it runs in. The step then plans the
|
|
31
|
+
* release's files against the environment, and the release gate binds that
|
|
32
|
+
* plan. A step whose directory the release does not record is left as
|
|
33
|
+
* written.
|
|
24
34
|
*/
|
|
25
35
|
|
|
26
36
|
import { mkdirSync, readdirSync, rmSync, rmdirSync, writeFileSync } from "node:fs";
|
|
27
37
|
import { basename, dirname, join } from "node:path";
|
|
28
38
|
import type { DriverComponent, DriverGate, DriverPhase, DriverStep } from "./driver";
|
|
29
|
-
import { recordedFields, recordedInputRefs, TEMPLATE_FIELDS, templateRefs, type RecordedInputRef } from "./release-compile";
|
|
39
|
+
import { recordedFields, recordedInputRefs, stepReleaseInputs, TEMPLATE_FIELDS, templateRefs, type RecordedInputRef } from "./release-compile";
|
|
40
|
+
import type { CapabilityRegistry } from "./capability";
|
|
30
41
|
import { templateBytesDigest, type Release, type ReleaseTarget } from "../lifecycle/release-store";
|
|
31
42
|
import { computePlanDigest } from "../lifecycle/plan-digest";
|
|
32
43
|
import type { ReleaseRecord } from "../lifecycle/release-ledger";
|
|
@@ -96,6 +107,7 @@ export async function pinReleaseTemplates(
|
|
|
96
107
|
release: Release,
|
|
97
108
|
target: ReleaseTarget,
|
|
98
109
|
readTemplate: TemplateReader,
|
|
110
|
+
layout?: { registry: CapabilityRegistry; memberDir: string },
|
|
99
111
|
): Promise<{ components: DriverComponent[]; files: PinnedTemplate[] } | { errors: string[] }> {
|
|
100
112
|
const errors: string[] = [];
|
|
101
113
|
const files: PinnedTemplate[] = [];
|
|
@@ -104,6 +116,26 @@ export async function pinReleaseTemplates(
|
|
|
104
116
|
const full = target.trees !== undefined;
|
|
105
117
|
for (const component of components) {
|
|
106
118
|
const replace = new Map<string, string>();
|
|
119
|
+
// #4542: steps whose capability names their files, pointed at the component's recorded layout.
|
|
120
|
+
const stepPins = new Map<DriverStep, { field: string; value: string }>();
|
|
121
|
+
if (full && layout) {
|
|
122
|
+
let base: string | null | undefined;
|
|
123
|
+
for (const { step, answer } of await stepReleaseInputs(component, layout.registry, layout.memberDir)) {
|
|
124
|
+
if ("unbound" in answer) continue;
|
|
125
|
+
if (!target.trees!.some((t) => t.component === component.name && t.path === answer.dir)) continue;
|
|
126
|
+
if (base === undefined) {
|
|
127
|
+
const pinned = await pinLayout(component.name, target, readTemplate);
|
|
128
|
+
if ("errors" in pinned) {
|
|
129
|
+
errors.push(...pinned.errors);
|
|
130
|
+
base = null;
|
|
131
|
+
} else {
|
|
132
|
+
files.push(...pinned.files);
|
|
133
|
+
base = pinned.base;
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
if (base !== null) stepPins.set(step, { field: answer.field, value: answer.dir === "." ? base : join(base, answer.dir) });
|
|
137
|
+
}
|
|
138
|
+
}
|
|
107
139
|
const refs: RecordedInputRef[] = full ? recordedInputRefs(component) : templateRefs(component).map((r) => ({ ...r, required: true }));
|
|
108
140
|
for (const ref of refs) {
|
|
109
141
|
if (replace.has(ref.value)) continue;
|
|
@@ -142,6 +174,8 @@ export async function pinReleaseTemplates(
|
|
|
142
174
|
if (isPhase(step)) return rewrite(step);
|
|
143
175
|
if (isGate(step)) return step;
|
|
144
176
|
const next: DriverStep = { ...step };
|
|
177
|
+
const pin = stepPins.get(step);
|
|
178
|
+
if (pin) next[pin.field] = pin.value;
|
|
145
179
|
for (const field of full ? recordedFields(step.kind) : TEMPLATE_FIELDS) {
|
|
146
180
|
const v = next[field];
|
|
147
181
|
if (typeof v === "string" && replace.has(v)) next[field] = replace.get(v);
|
|
@@ -200,6 +234,36 @@ async function pinTree(
|
|
|
200
234
|
return { path, files: read.map((r) => ({ path: join(path, r.rel), content: r.content, ...(r.encoding ? { encoding: r.encoding } : {}) })) };
|
|
201
235
|
}
|
|
202
236
|
|
|
237
|
+
/**
|
|
238
|
+
* Every file the target records for `component`, under
|
|
239
|
+
* `.chant/release-templates/<digest>/` at its path from the member's
|
|
240
|
+
* directory (#4542). The digest is a plan digest over the paths and their
|
|
241
|
+
* digests, so the base names the layout and a gate approval bound to a plan
|
|
242
|
+
* of it still matches on a re-run.
|
|
243
|
+
*/
|
|
244
|
+
async function pinLayout(
|
|
245
|
+
component: string,
|
|
246
|
+
target: ReleaseTarget,
|
|
247
|
+
readTemplate: TemplateReader,
|
|
248
|
+
): Promise<{ base: string; files: PinnedTemplate[] } | { errors: string[] }> {
|
|
249
|
+
const errors: string[] = [];
|
|
250
|
+
const read: Array<{ path: string; content: string; encoding?: "base64"; digest: string }> = [];
|
|
251
|
+
for (const e of target.templates.filter((t) => t.component === component)) {
|
|
252
|
+
if (e.path.startsWith("/") || e.path.split("/").includes("..")) {
|
|
253
|
+
errors.push(`component "${component}": "${e.path}" is not a path inside the member's directory; refusing to write it`);
|
|
254
|
+
continue;
|
|
255
|
+
}
|
|
256
|
+
const got = await readChecked(component, e.path, e, target, readTemplate);
|
|
257
|
+
if ("error" in got) errors.push(got.error);
|
|
258
|
+
else read.push({ path: e.path, content: got.content, digest: e.digest, ...(e.encoding ? { encoding: e.encoding } : {}) });
|
|
259
|
+
}
|
|
260
|
+
if (errors.length > 0) return { errors };
|
|
261
|
+
read.sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));
|
|
262
|
+
const digest = computePlanDigest("release-layout", read.map(({ path, digest }) => ({ path, digest })));
|
|
263
|
+
const base = join(RELEASE_TEMPLATES_DIR, digest.replace(/:/g, "_"));
|
|
264
|
+
return { base, files: read.map((r) => ({ path: join(base, r.path), content: r.content, ...(r.encoding ? { encoding: r.encoding } : {}) })) };
|
|
265
|
+
}
|
|
266
|
+
|
|
203
267
|
/**
|
|
204
268
|
* The files a release's target records, read back by digest and checked, for
|
|
205
269
|
* `chant release export` (#4046). A project with no components has no deploy
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The `repo` lock grain in a generated pipeline (#4552): one apply at a time
|
|
3
|
+
* in the repository. GitHub runs the apply jobs in one concurrency group,
|
|
4
|
+
* GitLab in one resource group, and Forgejo, whose runner does not queue on
|
|
5
|
+
* a concurrency group, through a lock tag on the remote,
|
|
6
|
+
* `refs/tags/chant-apply-lock`, the way terragucci's Forgejo pipelines do
|
|
7
|
+
* (`forgejoLock` in terragucci's `render.ts` at 18f6431).
|
|
8
|
+
*
|
|
9
|
+
* The tag points at an empty commit whose subject is the holder's lease,
|
|
10
|
+
* `run <id> <epoch>`. A runner that kills a job never runs its exit trap, so
|
|
11
|
+
* a waiter takes the lock over, with a lease push, when `chant lock --alive`
|
|
12
|
+
* says the holder's run is gone or its lease is older than
|
|
13
|
+
* `CHANT_LOCK_STALE` seconds (default 7200; `TG_LOCK_STALE` is read as an
|
|
14
|
+
* alias). The step's exit trap lets go of the tag.
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
/** The concurrency or resource group every apply job of a pipeline on the repo grain shares. */
|
|
18
|
+
export const REPO_APPLY_GROUP = "chant-apply-repo";
|
|
19
|
+
|
|
20
|
+
/** The tag Forgejo applies on the repo grain hold. */
|
|
21
|
+
export const REPO_LOCK_REF = "refs/tags/chant-apply-lock";
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* The shell lines that take the repo lock tag before an apply on Forgejo,
|
|
25
|
+
* and let go of it when the step's shell exits. They run in the apply
|
|
26
|
+
* command's own step, before it, so the trap fires when the apply ends.
|
|
27
|
+
* Waits up to an hour, polling every `CHANT_LOCK_POLL` seconds (default 10).
|
|
28
|
+
*/
|
|
29
|
+
export function forgejoRepoLockLines(): string[] {
|
|
30
|
+
const id = "${GITHUB_RUN_ID:-$$}";
|
|
31
|
+
return [
|
|
32
|
+
`lock_ref="${REPO_LOCK_REF}"`,
|
|
33
|
+
'empty="$(git mktree </dev/null)"',
|
|
34
|
+
`mine="$(GIT_AUTHOR_NAME=chant GIT_AUTHOR_EMAIL=chant@localhost GIT_COMMITTER_NAME=chant GIT_COMMITTER_EMAIL=chant@localhost git commit-tree "$empty" -m "run ${id} $(date +%s)")"`,
|
|
35
|
+
'stale="${CHANT_LOCK_STALE:-${TG_LOCK_STALE:-7200}}"',
|
|
36
|
+
"tries=0",
|
|
37
|
+
'until git push -q origin "$mine:$lock_ref" 2>/dev/null; do',
|
|
38
|
+
' held="$(git ls-remote origin "$lock_ref" | cut -f1)"',
|
|
39
|
+
' if [ -n "$held" ] && git fetch -q origin "+$lock_ref:$lock_ref" 2>/dev/null; then',
|
|
40
|
+
' lease="$(git log -1 --format=%s "$lock_ref")"',
|
|
41
|
+
' holder="$(echo "$lease" | cut -d" " -f2)"; since="$(echo "$lease" | cut -d" " -f3)"',
|
|
42
|
+
' if [ "$(chant lock --alive "$holder" 2>/dev/null)" = dead ] || [ $(( $(date +%s) - ${since:-0} )) -ge "$stale" ]; then',
|
|
43
|
+
' echo "the apply lock was held by run $holder, which is gone; taking it over"',
|
|
44
|
+
' git push -q --force-with-lease="$lock_ref:$held" origin "+$mine:$lock_ref" 2>/dev/null && break',
|
|
45
|
+
" fi",
|
|
46
|
+
" fi",
|
|
47
|
+
' if [ "$tries" -ge 360 ]; then echo "another apply has held $lock_ref for an hour" >&2; exit 1; fi',
|
|
48
|
+
' sleep "${CHANT_LOCK_POLL:-10}"; tries=$((tries + 1))',
|
|
49
|
+
"done",
|
|
50
|
+
"trap 'git push -q --force-with-lease=\"$lock_ref:$mine\" origin \":$lock_ref\" || true' EXIT",
|
|
51
|
+
];
|
|
52
|
+
}
|