@intentius/chant 0.124.54 → 0.124.56
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 +832 -0
- package/dist/ci-audit/attribution.d.ts +111 -0
- package/dist/ci-audit/attribution.d.ts.map +1 -0
- package/dist/ci-audit/attribution.js +194 -0
- package/dist/ci-audit/audit-log.d.ts +144 -0
- package/dist/ci-audit/audit-log.d.ts.map +1 -0
- package/dist/ci-audit/audit-log.js +149 -0
- package/dist/ci-audit/index.d.ts +12 -0
- package/dist/ci-audit/index.d.ts.map +1 -0
- package/dist/ci-audit/index.js +12 -0
- package/dist/ci-audit/unrecorded.d.ts +74 -0
- package/dist/ci-audit/unrecorded.d.ts.map +1 -0
- package/dist/ci-audit/unrecorded.js +95 -0
- package/dist/ci-audit.d.ts +3 -0
- package/dist/ci-audit.d.ts.map +1 -0
- package/dist/ci-audit.js +2 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +41 -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 +92 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +82 -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 +86 -15
- package/dist/ci-job-guard.d.ts +139 -0
- package/dist/ci-job-guard.d.ts.map +1 -0
- package/dist/ci-job-guard.js +287 -0
- package/dist/ci-jobs.d.ts +7 -0
- package/dist/ci-jobs.d.ts.map +1 -1
- package/dist/ci-jobs.js +7 -0
- package/dist/ci-product-words.d.ts +296 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +407 -0
- package/dist/ci-product.d.ts +117 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +113 -0
- package/dist/ci-respond-run.d.ts +73 -0
- package/dist/ci-respond-run.d.ts.map +1 -0
- package/dist/ci-respond-run.js +247 -0
- package/dist/ci-respond.d.ts +189 -0
- package/dist/ci-respond.d.ts.map +1 -0
- package/dist/ci-respond.js +285 -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/audit-log.d.ts +12 -0
- package/dist/cli/handlers/audit-log.d.ts.map +1 -0
- package/dist/cli/handlers/audit-log.js +81 -0
- package/dist/cli/handlers/build.d.ts +7 -0
- package/dist/cli/handlers/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +124 -1
- package/dist/cli/handlers/ci-check-job.d.ts +11 -0
- package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check-job.js +27 -0
- 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 +63 -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/e2e-safe-run.d.ts +12 -0
- package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
- package/dist/cli/handlers/e2e-safe-run.js +23 -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 +43 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +908 -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 +160 -2
- 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 +178 -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 +164 -3
- package/dist/cli/registry.d.ts +73 -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 +92 -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 +159 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +39 -6
- package/dist/components/check-hooks.d.ts +116 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -0
- package/dist/components/check-steps.d.ts +74 -0
- package/dist/components/check-steps.d.ts.map +1 -0
- package/dist/components/check-steps.js +102 -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 +60 -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 +32 -3
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +59 -5
- 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 +23 -5
- 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 +38 -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 +32 -4
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +26 -8
- package/dist/components/pr-pipeline.d.ts +297 -5
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +329 -18
- 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 +71 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +91 -7
- 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 +250 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +212 -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 +42 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +72 -4
- 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/e2e-harness/bucket.d.ts +21 -0
- package/dist/e2e-harness/bucket.d.ts.map +1 -0
- package/dist/e2e-harness/bucket.js +61 -0
- package/dist/e2e-harness/claim.d.ts +70 -0
- package/dist/e2e-harness/claim.d.ts.map +1 -0
- package/dist/e2e-harness/claim.js +98 -0
- package/dist/e2e-harness/driver.d.ts +64 -0
- package/dist/e2e-harness/driver.d.ts.map +1 -0
- package/dist/e2e-harness/driver.js +243 -0
- package/dist/e2e-harness/forgejo.d.ts +77 -0
- package/dist/e2e-harness/forgejo.d.ts.map +1 -0
- package/dist/e2e-harness/forgejo.js +205 -0
- package/dist/e2e-harness/git.d.ts +32 -0
- package/dist/e2e-harness/git.d.ts.map +1 -0
- package/dist/e2e-harness/git.js +67 -0
- package/dist/e2e-harness/index.d.ts +22 -0
- package/dist/e2e-harness/index.d.ts.map +1 -0
- package/dist/e2e-harness/index.js +48 -0
- package/dist/e2e-harness/jobs.d.ts +8 -0
- package/dist/e2e-harness/jobs.d.ts.map +1 -0
- package/dist/e2e-harness/jobs.js +34 -0
- package/dist/e2e-harness/pins.d.ts +45 -0
- package/dist/e2e-harness/pins.d.ts.map +1 -0
- package/dist/e2e-harness/pins.js +44 -0
- package/dist/e2e-harness/ports.d.ts +113 -0
- package/dist/e2e-harness/ports.d.ts.map +1 -0
- package/dist/e2e-harness/ports.js +4 -0
- package/dist/e2e-harness/reports.d.ts +45 -0
- package/dist/e2e-harness/reports.d.ts.map +1 -0
- package/dist/e2e-harness/reports.js +57 -0
- package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
- package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run-cli.js +43 -0
- package/dist/e2e-harness/safe-run.d.ts +61 -0
- package/dist/e2e-harness/safe-run.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run.js +172 -0
- package/dist/e2e-harness/scenario.d.ts +11 -0
- package/dist/e2e-harness/scenario.d.ts.map +1 -0
- package/dist/e2e-harness/scenario.js +89 -0
- package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/dist/e2e-harness/schemas/index.d.ts +191 -0
- package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
- package/dist/e2e-harness/schemas/index.js +62 -0
- package/dist/e2e-harness/stack.d.ts +124 -0
- package/dist/e2e-harness/stack.d.ts.map +1 -0
- package/dist/e2e-harness/stack.js +207 -0
- package/dist/e2e-harness/steps.d.ts +11 -0
- package/dist/e2e-harness/steps.d.ts.map +1 -0
- package/dist/e2e-harness/steps.js +22 -0
- package/dist/e2e-harness.d.ts +3 -0
- package/dist/e2e-harness.d.ts.map +1 -0
- package/dist/e2e-harness.js +2 -0
- package/dist/engine-facts.d.ts.map +1 -1
- package/dist/engine-facts.js +1 -2
- package/dist/exit-codes.d.ts +54 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +55 -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 +152 -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 +10 -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 +204 -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 -7
- 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 +9 -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 +106 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +115 -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/lifecycle/wave-plans.d.ts +23 -7
- package/dist/lifecycle/wave-plans.d.ts.map +1 -1
- package/dist/lifecycle/wave-plans.js +9 -2
- 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/approval-status.d.ts +103 -0
- package/dist/op/approval-status.d.ts.map +1 -0
- package/dist/op/approval-status.js +197 -0
- 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 +63 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +115 -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 +96 -0
- package/dist/op/op-waves-run.d.ts +182 -6
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +1076 -44
- 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 +96 -0
- package/dist/op/op-waves.d.ts +187 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +203 -19
- package/dist/op/runtime.d.ts +95 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +18 -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 +425 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -0
- package/dist/parallelism.d.ts +17 -0
- package/dist/parallelism.d.ts.map +1 -0
- package/dist/parallelism.js +33 -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 +102 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +146 -37
- package/dist/pr-loop.d.ts +158 -11
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +302 -44
- package/dist/pr-merge.d.ts +64 -0
- package/dist/pr-merge.d.ts.map +1 -0
- package/dist/pr-merge.js +78 -0
- package/dist/pr-post.d.ts +86 -1
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +141 -5
- 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 +45 -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 +3 -1
- package/dist/scheduled-op-cloud.d.ts +32 -0
- package/dist/scheduled-op-cloud.d.ts.map +1 -0
- package/dist/scheduled-op-cloud.js +69 -0
- 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 +405 -287
- 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 +17 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +21 -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 +10 -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 +79 -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 +1025 -0
- package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
- package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
- package/src/ci-audit/attribution.ts +260 -0
- package/src/ci-audit/audit-log.ts +220 -0
- package/src/ci-audit/ci-audit.test.ts +175 -0
- package/src/ci-audit/index.ts +15 -0
- package/src/ci-audit/unrecorded.ts +140 -0
- package/src/ci-audit.ts +2 -0
- package/src/ci-control.ts +173 -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 +175 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +54 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +3 -1
- package/src/ci-identity.ts +123 -22
- package/src/ci-job-guard.test.ts +154 -0
- package/src/ci-job-guard.ts +319 -0
- package/src/ci-jobs.ts +8 -0
- package/src/ci-product-comment-targets.test.ts +45 -0
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +565 -0
- package/src/ci-product.ts +226 -0
- package/src/ci-respond-run.ts +291 -0
- package/src/ci-respond.test.ts +264 -0
- package/src/ci-respond.ts +412 -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/audit-log.ts +74 -0
- package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
- package/src/cli/handlers/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +113 -1
- package/src/cli/handlers/ci-check-job.test.ts +114 -0
- package/src/cli/handlers/ci-check-job.ts +33 -0
- package/src/cli/handlers/ci-check.ts +63 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -0
- package/src/cli/handlers/e2e-safe-run.ts +27 -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-comment-targets.test.ts +166 -0
- package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
- 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 +879 -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 +144 -2
- 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.test.ts +1 -1
- package/src/cli/main.ts +180 -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 +119 -2
- package/src/cli/registry.ts +73 -0
- package/src/cloud-lister/sigv4.ts +80 -23
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +140 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability.ts +180 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +255 -0
- package/src/components/check-steps.test.ts +70 -0
- package/src/components/check-steps.ts +158 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +82 -0
- package/src/components/cli-support.ts +23 -2
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +73 -6
- package/src/components/fan-out-run.ts +68 -18
- package/src/components/groups.ts +21 -4
- package/src/components/plan-flags.test.ts +46 -0
- package/src/components/pr-comment-preview-targets.test.ts +34 -0
- 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 +42 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +2 -14
- 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 +40 -8
- package/src/components/pr-pipeline-runners.test.ts +80 -0
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +498 -18
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +1 -1
- package/src/components/pr-run.ts +138 -11
- package/src/components/pr-stale-job.test.ts +34 -0
- 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 +383 -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 +96 -6
- 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/e2e-harness/__project__/chant.config.ts +4 -0
- package/src/e2e-harness/__project__/src/compose.ts +33 -0
- package/src/e2e-harness/bucket.ts +69 -0
- package/src/e2e-harness/claim.test.ts +150 -0
- package/src/e2e-harness/claim.ts +140 -0
- package/src/e2e-harness/driver.test.ts +304 -0
- package/src/e2e-harness/driver.ts +294 -0
- package/src/e2e-harness/forgejo.ts +267 -0
- package/src/e2e-harness/git.ts +96 -0
- package/src/e2e-harness/index.ts +50 -0
- package/src/e2e-harness/jobs.ts +35 -0
- package/src/e2e-harness/pins.ts +52 -0
- package/src/e2e-harness/ports.ts +130 -0
- package/src/e2e-harness/reports.ts +79 -0
- package/src/e2e-harness/safe-run-cli.test.ts +102 -0
- package/src/e2e-harness/safe-run-cli.ts +54 -0
- package/src/e2e-harness/safe-run.ts +198 -0
- package/src/e2e-harness/scenario.ts +89 -0
- package/src/e2e-harness/schemas/README.md +62 -0
- package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/src/e2e-harness/schemas/index.ts +220 -0
- package/src/e2e-harness/schemas.test.ts +145 -0
- package/src/e2e-harness/stack.test.ts +124 -0
- package/src/e2e-harness/stack.ts +306 -0
- package/src/e2e-harness/steps.ts +30 -0
- package/src/e2e-harness.ts +2 -0
- package/src/engine-facts.test.ts +2 -3
- package/src/engine-facts.ts +1 -2
- package/src/exit-codes.test.ts +32 -0
- package/src/exit-codes.ts +61 -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 +11 -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 +143 -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 +69 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +35 -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 +279 -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 -8
- 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 +192 -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 +19 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +185 -0
- package/src/lifecycle/release-status.ts +175 -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/lifecycle/wave-plans.ts +33 -5
- 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/approval-status.test.ts +134 -0
- package/src/op/approval-status.ts +235 -0
- package/src/op/gate-review.test.ts +2 -1
- package/src/op/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +23 -0
- package/src/op/op-waves-after-plan.test.ts +288 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +133 -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-parallelism.test.ts +89 -0
- package/src/op/op-waves-pull-request.test.ts +219 -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 +132 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1235 -52
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +107 -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 +320 -22
- package/src/op/runtime.ts +107 -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 +543 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/parallelism.test.ts +38 -0
- package/src/parallelism.ts +33 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +111 -0
- package/src/pr-forge-bundle.test.ts +1 -1
- package/src/pr-forge.ts +175 -33
- package/src/pr-loop-bundle.test.ts +7 -3
- package/src/pr-loop-narrowed.test.ts +63 -0
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.ts +398 -52
- package/src/pr-merge.test.ts +100 -0
- package/src/pr-merge.ts +105 -0
- package/src/pr-post-stale.test.ts +163 -0
- package/src/pr-post.ts +190 -5
- package/src/pr-report-url.ts +61 -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 +212 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +28 -1
- package/src/scheduled-op-cloud.ts +68 -0
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +6 -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 +29 -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 +10 -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 +79 -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,120 @@
|
|
|
1
|
+
import { type LockRow } from "./lock-rows.js";
|
|
2
|
+
/** The directory of the row files, under {@link LOCKS_DIR}, at the ledger root. */
|
|
3
|
+
export declare const LOCK_ROWS_DIR = "_locks/rows";
|
|
4
|
+
/** A lease older than this many seconds is taken over (`CHANT_LOCK_STALE`). */
|
|
5
|
+
export declare const DEFAULT_LOCK_STALE_SECONDS = 7200;
|
|
6
|
+
/** The run holding rows: the forge's run id, or this host and process outside CI. */
|
|
7
|
+
export interface LockRowHolder {
|
|
8
|
+
run: string;
|
|
9
|
+
at: string;
|
|
10
|
+
/** The run's page, for a refusal that names it. */
|
|
11
|
+
url?: string;
|
|
12
|
+
sha?: string;
|
|
13
|
+
}
|
|
14
|
+
/** `_locks/rows/<gate>.json`. */
|
|
15
|
+
export interface LockRowsFile {
|
|
16
|
+
version: 1;
|
|
17
|
+
holders: Record<string, LockRowHolder>;
|
|
18
|
+
/** Row key to the run that holds it. */
|
|
19
|
+
rows: Record<string, string>;
|
|
20
|
+
}
|
|
21
|
+
/** A row another run holds, conflicting with `wanted`. */
|
|
22
|
+
export interface HeldLockRow {
|
|
23
|
+
/** The row as the file holds it. */
|
|
24
|
+
key: string;
|
|
25
|
+
/** The row the take asked for that meets it (the same key, or one that covers it). */
|
|
26
|
+
wanted: string;
|
|
27
|
+
holder: LockRowHolder;
|
|
28
|
+
}
|
|
29
|
+
/** Whether a holder is still running: `dead` when it is gone, `alive` when it runs or nobody can say. */
|
|
30
|
+
export type LockLiveness = (holder: LockRowHolder) => Promise<"alive" | "dead">;
|
|
31
|
+
/** The path of `gate`'s rows file on `chant/lifecycle`, at the ledger root. */
|
|
32
|
+
export declare function lockRowsPath(gate: string): string;
|
|
33
|
+
/** The lease length in seconds: `CHANT_LOCK_STALE`, else `TG_LOCK_STALE`, else {@link DEFAULT_LOCK_STALE_SECONDS}. */
|
|
34
|
+
export declare function lockStaleSeconds(env: Record<string, string | undefined>): number;
|
|
35
|
+
/** Who this apply is, as the rows name it: the forge's run, or this host and process outside CI. */
|
|
36
|
+
export declare function lockRowHolder(env: Record<string, string | undefined>, now?: Date): LockRowHolder;
|
|
37
|
+
type Fetch = (url: string, init?: {
|
|
38
|
+
headers?: Record<string, string>;
|
|
39
|
+
}) => Promise<{
|
|
40
|
+
ok: boolean;
|
|
41
|
+
json(): Promise<unknown>;
|
|
42
|
+
}>;
|
|
43
|
+
/**
|
|
44
|
+
* Ask the forge whether a holder's run is gone, with `CHANT_FORGE_TOKEN`
|
|
45
|
+
* (else terragucci's `TG_TOKEN`). A lease older than {@link lockStaleSeconds}
|
|
46
|
+
* is gone. A local holder on this host is gone when its process is. Anything
|
|
47
|
+
* nobody can answer counts as alive.
|
|
48
|
+
*/
|
|
49
|
+
export declare function forgeLockLiveness(env: Record<string, string | undefined>, fetch?: Fetch, now?: () => number): LockLiveness;
|
|
50
|
+
/** The rows file's text: anything that is not a version 1 file reads as no rows; a row naming no holder is dropped. */
|
|
51
|
+
export declare function parseLockRows(text: string | null): LockRowsFile;
|
|
52
|
+
/** The file's text, keys sorted, so two writes of the same rows are the same blob. */
|
|
53
|
+
export declare function renderLockRows(file: LockRowsFile): string;
|
|
54
|
+
/** Who else holds a row that meets any of `keys`, split into runs still going and runs that are gone. */
|
|
55
|
+
export declare function heldLockRowsIn(file: LockRowsFile, keys: readonly string[], me: string, alive: LockLiveness): Promise<{
|
|
56
|
+
live: HeldLockRow[];
|
|
57
|
+
gone: string[];
|
|
58
|
+
}>;
|
|
59
|
+
/**
|
|
60
|
+
* The rows file after `me` takes `keys`, dropping every row of the runs in
|
|
61
|
+
* `gone`. Pure, so the decision can be checked without git.
|
|
62
|
+
*/
|
|
63
|
+
export declare function withRowsTaken(file: LockRowsFile, keys: readonly string[], me: LockRowHolder, gone: readonly string[]): LockRowsFile;
|
|
64
|
+
/** The rows file after `me` lets go of `keys`; its holder entry goes once it holds no row. */
|
|
65
|
+
export declare function withRowsReleased(file: LockRowsFile, keys: readonly string[], me: string): LockRowsFile;
|
|
66
|
+
export interface LockRowsOptions {
|
|
67
|
+
cwd?: string;
|
|
68
|
+
/** Whether a holder still runs. Default {@link forgeLockLiveness} over `process.env`. */
|
|
69
|
+
alive?: LockLiveness;
|
|
70
|
+
}
|
|
71
|
+
/** The rows of `gate` as the remote holds them now, fetched first. */
|
|
72
|
+
export declare function readLockRows(gate: string, opts?: {
|
|
73
|
+
cwd?: string;
|
|
74
|
+
}): Promise<LockRowsFile>;
|
|
75
|
+
export type TakeLockRowsResult = {
|
|
76
|
+
ok: true;
|
|
77
|
+
tookOver: LockRowHolder[];
|
|
78
|
+
pushed: boolean;
|
|
79
|
+
} | {
|
|
80
|
+
ok: false;
|
|
81
|
+
held: HeldLockRow[];
|
|
82
|
+
};
|
|
83
|
+
/**
|
|
84
|
+
* Take `rows` for `me` in one commit. A row a live run holds, or one a held
|
|
85
|
+
* row covers, refuses the whole take and nothing is written. The rows of a
|
|
86
|
+
* run that is gone are dropped in the same commit.
|
|
87
|
+
*/
|
|
88
|
+
export declare function takeLockRows(gate: string, rows: readonly LockRow[], me: LockRowHolder, opts?: LockRowsOptions): Promise<TakeLockRowsResult>;
|
|
89
|
+
/** Let go of `keys` where run `me` still holds them. Never throws: a row left held is taken over once the run is gone. */
|
|
90
|
+
export declare function releaseLockRows(gate: string, keys: readonly string[], me: string, opts?: {
|
|
91
|
+
cwd?: string;
|
|
92
|
+
}): Promise<boolean>;
|
|
93
|
+
/** One line naming the runs that hold rows, and what of this apply they hold, for a log line and a refusal. */
|
|
94
|
+
export declare function describeHeldLockRows(held: readonly HeldLockRow[], rows: readonly LockRow[]): string;
|
|
95
|
+
/** A lease an apply holds: its rows and holder, and how to let go of it. */
|
|
96
|
+
export interface LockRowsLease {
|
|
97
|
+
gate: string;
|
|
98
|
+
holder: LockRowHolder;
|
|
99
|
+
keys: string[];
|
|
100
|
+
release(): Promise<boolean>;
|
|
101
|
+
}
|
|
102
|
+
/**
|
|
103
|
+
* Lease `rows` for the apply about to run (#4552): take them, or say who
|
|
104
|
+
* holds them. With no rows, a lease that holds nothing. Throws when the
|
|
105
|
+
* rows file cannot be read or written, so an apply that cannot hold its
|
|
106
|
+
* rows applies nothing.
|
|
107
|
+
*/
|
|
108
|
+
export declare function leaseLockRows(gate: string, rows: readonly LockRow[], opts?: LockRowsOptions & {
|
|
109
|
+
holder?: LockRowHolder;
|
|
110
|
+
}): Promise<{
|
|
111
|
+
ok: true;
|
|
112
|
+
lease: LockRowsLease;
|
|
113
|
+
tookOver: LockRowHolder[];
|
|
114
|
+
} | {
|
|
115
|
+
ok: false;
|
|
116
|
+
held: HeldLockRow[];
|
|
117
|
+
message: string;
|
|
118
|
+
}>;
|
|
119
|
+
export {};
|
|
120
|
+
//# sourceMappingURL=resource-lock.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resource-lock.d.ts","sourceRoot":"","sources":["../../src/lifecycle/resource-lock.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,317 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Row leases (#4552): the rows an apply on the resource lock grain holds
|
|
3
|
+
* while it applies. The grain, the row keys and the rule of cover are in
|
|
4
|
+
* ./lock-rows.ts; this module reads and writes the rows file.
|
|
5
|
+
*
|
|
6
|
+
* The format, the lease and the stale takeover are terragucci's apply rows
|
|
7
|
+
* (`packages/terragucci/src/apply-rows.ts` in INTENTIUS/terragucci at
|
|
8
|
+
* 18f6431), moved into chant so both products share them:
|
|
9
|
+
*
|
|
10
|
+
* - One file per gate for the whole workspace, `_locks/rows/<gate>.json` on
|
|
11
|
+
* `chant/lifecycle` at the ledger root, never under a member's prefix
|
|
12
|
+
* (ruling B): `object` rows and choudoufu estates span members, and a file
|
|
13
|
+
* per member would miss two members meeting on one object. A gate name has
|
|
14
|
+
* no `/`, so `rows/` never collides with a gate's target-lock file
|
|
15
|
+
* (./target-lock.ts). The gate is the pull-request loop's, `pr-apply`
|
|
16
|
+
* unless the pipeline names another, so the apply before merge and the
|
|
17
|
+
* apply on merge read one file.
|
|
18
|
+
* - `{ version: 1, holders: { <run>: { run, at, url?, sha? } }, rows: { <key>: <run> } }`.
|
|
19
|
+
* - A take is all or nothing, in one commit: a row a live run holds refuses
|
|
20
|
+
* the whole take and nothing is written. The rows of a run that is gone
|
|
21
|
+
* are dropped in the same commit, all of them. A run is gone when the forge
|
|
22
|
+
* says its run finished, when its lease is older than `CHANT_LOCK_STALE`
|
|
23
|
+
* seconds (default 7200; terragucci's `TG_LOCK_STALE` is read as an alias
|
|
24
|
+
* for one release), or, for a run on this host outside CI, when its
|
|
25
|
+
* process is. Anything nobody can answer counts as alive.
|
|
26
|
+
* - A release never throws: a row left held is taken over once its run is gone.
|
|
27
|
+
*
|
|
28
|
+
* The writes go through chant's ledger code (./git.ts) with the same
|
|
29
|
+
* read-then-CAS and push the target locks use, in place of terragucci's raw
|
|
30
|
+
* git: a push refused because another writer moved the branch drops the
|
|
31
|
+
* local commit, reads the branch again and decides again.
|
|
32
|
+
*
|
|
33
|
+
* The staleness of a plan stays the engine's: choudoufu's moved refusal and
|
|
34
|
+
* plunge's exit 40, both `moved` (#4553). A held row is the table's `held`,
|
|
35
|
+
* exit 5, and names the run that holds it.
|
|
36
|
+
*/
|
|
37
|
+
import { hostname } from "node:os";
|
|
38
|
+
import { pushLifecycleStatus, readBlobBySha, readPathSha, RefCASConflictError, writeBlobToPath } from "./git.js";
|
|
39
|
+
import { lockRowsConflict, sortedLockRows } from "./lock-rows.js";
|
|
40
|
+
import { dropRefusedWrite, fetchForLocks, localTip, LOCKS_DIR, targetLockGateProblem } from "./target-lock.js";
|
|
41
|
+
/** The directory of the row files, under {@link LOCKS_DIR}, at the ledger root. */
|
|
42
|
+
export const LOCK_ROWS_DIR = `${LOCKS_DIR}/rows`;
|
|
43
|
+
/** A lease older than this many seconds is taken over (`CHANT_LOCK_STALE`). */
|
|
44
|
+
export const DEFAULT_LOCK_STALE_SECONDS = 7200;
|
|
45
|
+
const STATE_BRANCH = "chant/lifecycle";
|
|
46
|
+
const ATTEMPTS = 30;
|
|
47
|
+
/** The path of `gate`'s rows file on `chant/lifecycle`, at the ledger root. */
|
|
48
|
+
export function lockRowsPath(gate) {
|
|
49
|
+
return `${LOCK_ROWS_DIR}/${gate}.json`;
|
|
50
|
+
}
|
|
51
|
+
/** The lease length in seconds: `CHANT_LOCK_STALE`, else `TG_LOCK_STALE`, else {@link DEFAULT_LOCK_STALE_SECONDS}. */
|
|
52
|
+
export function lockStaleSeconds(env) {
|
|
53
|
+
for (const name of ["CHANT_LOCK_STALE", "TG_LOCK_STALE"]) {
|
|
54
|
+
const n = Number(env[name]);
|
|
55
|
+
if (env[name] !== undefined && Number.isFinite(n) && n > 0)
|
|
56
|
+
return n;
|
|
57
|
+
}
|
|
58
|
+
return DEFAULT_LOCK_STALE_SECONDS;
|
|
59
|
+
}
|
|
60
|
+
/** Who this apply is, as the rows name it: the forge's run, or this host and process outside CI. */
|
|
61
|
+
export function lockRowHolder(env, now = new Date()) {
|
|
62
|
+
const gitlab = Boolean(env.CI_PIPELINE_ID);
|
|
63
|
+
const run = env.GITHUB_RUN_ID || env.CI_PIPELINE_ID || `local:${hostname()}:${process.pid}`;
|
|
64
|
+
const url = gitlab
|
|
65
|
+
? env.CI_PIPELINE_URL
|
|
66
|
+
: env.GITHUB_RUN_ID && env.GITHUB_SERVER_URL && env.GITHUB_REPOSITORY
|
|
67
|
+
? `${env.GITHUB_SERVER_URL}/${env.GITHUB_REPOSITORY}/actions/runs/${env.GITHUB_RUN_ID}`
|
|
68
|
+
: undefined;
|
|
69
|
+
const sha = env.GITHUB_SHA || env.CI_COMMIT_SHA;
|
|
70
|
+
return { run, at: now.toISOString(), ...(url ? { url } : {}), ...(sha ? { sha } : {}) };
|
|
71
|
+
}
|
|
72
|
+
/**
|
|
73
|
+
* Ask the forge whether a holder's run is gone, with `CHANT_FORGE_TOKEN`
|
|
74
|
+
* (else terragucci's `TG_TOKEN`). A lease older than {@link lockStaleSeconds}
|
|
75
|
+
* is gone. A local holder on this host is gone when its process is. Anything
|
|
76
|
+
* nobody can answer counts as alive.
|
|
77
|
+
*/
|
|
78
|
+
export function forgeLockLiveness(env, fetch = globalThis.fetch, now = Date.now) {
|
|
79
|
+
const stale = lockStaleSeconds(env);
|
|
80
|
+
return async (h) => {
|
|
81
|
+
const since = new Date(h.at).getTime();
|
|
82
|
+
if (Number.isFinite(since) && now() - since >= stale * 1000)
|
|
83
|
+
return "dead";
|
|
84
|
+
const local = /^local:(.*):(\d+)$/.exec(h.run);
|
|
85
|
+
if (local) {
|
|
86
|
+
if (local[1] !== hostname())
|
|
87
|
+
return "alive";
|
|
88
|
+
try {
|
|
89
|
+
process.kill(Number(local[2]), 0);
|
|
90
|
+
return "alive";
|
|
91
|
+
}
|
|
92
|
+
catch (e) {
|
|
93
|
+
return e.code === "ESRCH" ? "dead" : "alive";
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
const token = env.CHANT_FORGE_TOKEN || env.TG_TOKEN;
|
|
97
|
+
if (!token)
|
|
98
|
+
return "alive";
|
|
99
|
+
try {
|
|
100
|
+
if (env.CI_API_V4_URL && env.CI_PROJECT_ID) {
|
|
101
|
+
const r = await fetch(`${env.CI_API_V4_URL}/projects/${env.CI_PROJECT_ID}/pipelines/${h.run}`, { headers: { "private-token": token } });
|
|
102
|
+
if (!r.ok)
|
|
103
|
+
return "alive";
|
|
104
|
+
const status = String((await r.json()).status ?? "");
|
|
105
|
+
return ["success", "failed", "canceled", "skipped"].includes(status) ? "dead" : "alive";
|
|
106
|
+
}
|
|
107
|
+
const api = env.GITHUB_API_URL || (env.GITHUB_SERVER_URL ? `${env.GITHUB_SERVER_URL}/api/v1` : "");
|
|
108
|
+
if (!api || !env.GITHUB_REPOSITORY)
|
|
109
|
+
return "alive";
|
|
110
|
+
const r = await fetch(`${api}/repos/${env.GITHUB_REPOSITORY}/actions/runs/${h.run}`, { headers: { authorization: `token ${token}` } });
|
|
111
|
+
if (!r.ok)
|
|
112
|
+
return "alive";
|
|
113
|
+
const status = String((await r.json()).status ?? "");
|
|
114
|
+
return ["success", "failure", "cancelled", "skipped", "completed"].includes(status) ? "dead" : "alive";
|
|
115
|
+
}
|
|
116
|
+
catch {
|
|
117
|
+
return "alive";
|
|
118
|
+
}
|
|
119
|
+
};
|
|
120
|
+
}
|
|
121
|
+
/** The rows file's text: anything that is not a version 1 file reads as no rows; a row naming no holder is dropped. */
|
|
122
|
+
export function parseLockRows(text) {
|
|
123
|
+
if (!text)
|
|
124
|
+
return { version: 1, holders: {}, rows: {} };
|
|
125
|
+
try {
|
|
126
|
+
const doc = JSON.parse(text);
|
|
127
|
+
if (doc?.version === 1 && doc.rows && typeof doc.rows === "object" && doc.holders && typeof doc.holders === "object") {
|
|
128
|
+
const holders = {};
|
|
129
|
+
for (const [id, raw] of Object.entries(doc.holders)) {
|
|
130
|
+
if (typeof raw?.run !== "string" || typeof raw.at !== "string")
|
|
131
|
+
continue;
|
|
132
|
+
holders[id] = { run: raw.run, at: raw.at, ...(typeof raw.url === "string" ? { url: raw.url } : {}), ...(typeof raw.sha === "string" ? { sha: raw.sha } : {}) };
|
|
133
|
+
}
|
|
134
|
+
const rows = {};
|
|
135
|
+
for (const [k, id] of Object.entries(doc.rows))
|
|
136
|
+
if (typeof id === "string" && holders[id])
|
|
137
|
+
rows[k] = id;
|
|
138
|
+
return { version: 1, holders, rows };
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
catch {
|
|
142
|
+
// An unreadable file holds no rows.
|
|
143
|
+
}
|
|
144
|
+
return { version: 1, holders: {}, rows: {} };
|
|
145
|
+
}
|
|
146
|
+
/** The file's text, keys sorted, so two writes of the same rows are the same blob. */
|
|
147
|
+
export function renderLockRows(file) {
|
|
148
|
+
const sort = (r) => Object.fromEntries(Object.keys(r).sort().map((k) => [k, r[k]]));
|
|
149
|
+
return `${JSON.stringify({ version: 1, holders: sort(file.holders), rows: sort(file.rows) }, null, 2)}\n`;
|
|
150
|
+
}
|
|
151
|
+
/** Who else holds a row that meets any of `keys`, split into runs still going and runs that are gone. */
|
|
152
|
+
export async function heldLockRowsIn(file, keys, me, alive) {
|
|
153
|
+
const verdict = new Map();
|
|
154
|
+
const live = [];
|
|
155
|
+
const gone = new Set();
|
|
156
|
+
for (const wanted of [...new Set(keys)].sort()) {
|
|
157
|
+
for (const [key, id] of Object.entries(file.rows)) {
|
|
158
|
+
if (id === me || !lockRowsConflict(wanted, key))
|
|
159
|
+
continue;
|
|
160
|
+
const holder = file.holders[id];
|
|
161
|
+
if (!verdict.has(id))
|
|
162
|
+
verdict.set(id, await alive(holder));
|
|
163
|
+
if (verdict.get(id) === "dead")
|
|
164
|
+
gone.add(id);
|
|
165
|
+
else
|
|
166
|
+
live.push({ key, wanted, holder });
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
return { live, gone: [...gone].sort() };
|
|
170
|
+
}
|
|
171
|
+
/**
|
|
172
|
+
* The rows file after `me` takes `keys`, dropping every row of the runs in
|
|
173
|
+
* `gone`. Pure, so the decision can be checked without git.
|
|
174
|
+
*/
|
|
175
|
+
export function withRowsTaken(file, keys, me, gone) {
|
|
176
|
+
const next = { version: 1, holders: { ...file.holders }, rows: { ...file.rows } };
|
|
177
|
+
for (const id of gone) {
|
|
178
|
+
delete next.holders[id];
|
|
179
|
+
for (const [k, h] of Object.entries(next.rows))
|
|
180
|
+
if (h === id)
|
|
181
|
+
delete next.rows[k];
|
|
182
|
+
}
|
|
183
|
+
next.holders[me.run] = me;
|
|
184
|
+
for (const k of keys)
|
|
185
|
+
next.rows[k] = me.run;
|
|
186
|
+
return next;
|
|
187
|
+
}
|
|
188
|
+
/** The rows file after `me` lets go of `keys`; its holder entry goes once it holds no row. */
|
|
189
|
+
export function withRowsReleased(file, keys, me) {
|
|
190
|
+
const next = { version: 1, holders: { ...file.holders }, rows: { ...file.rows } };
|
|
191
|
+
for (const k of keys)
|
|
192
|
+
if (next.rows[k] === me)
|
|
193
|
+
delete next.rows[k];
|
|
194
|
+
if (!Object.values(next.rows).includes(me))
|
|
195
|
+
delete next.holders[me];
|
|
196
|
+
return next;
|
|
197
|
+
}
|
|
198
|
+
async function readCurrent(gate, cwd) {
|
|
199
|
+
const sha = await readPathSha(LOCK_ROWS_DIR, `${gate}.json`, { cwd, ledgerPrefix: "" });
|
|
200
|
+
return { sha, file: parseLockRows(sha ? await readBlobBySha(sha, { cwd }) : null) };
|
|
201
|
+
}
|
|
202
|
+
/** Write `next` over the file read at `sha`, then push. Null when the branch moved under the write. */
|
|
203
|
+
async function writeAndPush(gate, sha, next, message, cwd) {
|
|
204
|
+
const parent = await localTip(cwd);
|
|
205
|
+
let commit;
|
|
206
|
+
try {
|
|
207
|
+
commit = await writeBlobToPath(LOCK_ROWS_DIR, `${gate}.json`, renderLockRows(next), message, { cwd, ledgerPrefix: "", expectPriorPathSha: sha });
|
|
208
|
+
}
|
|
209
|
+
catch (err) {
|
|
210
|
+
if (err instanceof RefCASConflictError)
|
|
211
|
+
return null;
|
|
212
|
+
throw err;
|
|
213
|
+
}
|
|
214
|
+
const push = await pushLifecycleStatus({ cwd });
|
|
215
|
+
switch (push.status) {
|
|
216
|
+
case "pushed":
|
|
217
|
+
return { pushed: true };
|
|
218
|
+
case "no-remote":
|
|
219
|
+
case "not-recorded":
|
|
220
|
+
return { pushed: false };
|
|
221
|
+
case "stale":
|
|
222
|
+
await dropRefusedWrite(push.remote, commit, parent, cwd);
|
|
223
|
+
await fetchForLocks(cwd);
|
|
224
|
+
return null;
|
|
225
|
+
case "failed":
|
|
226
|
+
throw new Error(`the rows were written but the push of ${STATE_BRANCH} to ${push.remote} failed, so they are not held: ${push.stderr}`);
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
const pause = (ms) => new Promise((r) => setTimeout(r, ms));
|
|
230
|
+
function checkGate(gate) {
|
|
231
|
+
const problem = targetLockGateProblem(gate);
|
|
232
|
+
if (problem)
|
|
233
|
+
throw new Error(problem);
|
|
234
|
+
}
|
|
235
|
+
/** The rows of `gate` as the remote holds them now, fetched first. */
|
|
236
|
+
export async function readLockRows(gate, opts = {}) {
|
|
237
|
+
checkGate(gate);
|
|
238
|
+
await fetchForLocks(opts.cwd);
|
|
239
|
+
return (await readCurrent(gate, opts.cwd)).file;
|
|
240
|
+
}
|
|
241
|
+
/**
|
|
242
|
+
* Take `rows` for `me` in one commit. A row a live run holds, or one a held
|
|
243
|
+
* row covers, refuses the whole take and nothing is written. The rows of a
|
|
244
|
+
* run that is gone are dropped in the same commit.
|
|
245
|
+
*/
|
|
246
|
+
export async function takeLockRows(gate, rows, me, opts = {}) {
|
|
247
|
+
checkGate(gate);
|
|
248
|
+
const keys = sortedLockRows(rows).map((r) => r.key);
|
|
249
|
+
if (keys.length === 0)
|
|
250
|
+
return { ok: true, tookOver: [], pushed: false };
|
|
251
|
+
const alive = opts.alive ?? forgeLockLiveness(process.env);
|
|
252
|
+
await fetchForLocks(opts.cwd);
|
|
253
|
+
for (let attempt = 0; attempt < ATTEMPTS; attempt++) {
|
|
254
|
+
const { sha, file } = await readCurrent(gate, opts.cwd);
|
|
255
|
+
const { live, gone } = await heldLockRowsIn(file, keys, me.run, alive);
|
|
256
|
+
if (live.length > 0)
|
|
257
|
+
return { ok: false, held: live };
|
|
258
|
+
const tookOver = gone.map((id) => file.holders[id]);
|
|
259
|
+
const took = gone.length ? `, taken over from run ${gone.join(", ")}` : "";
|
|
260
|
+
const wrote = await writeAndPush(gate, sha, withRowsTaken(file, keys, me, gone), `Hold ${keys.length} row${keys.length === 1 ? "" : "s"} of ${gate} for run ${me.run}${took}`, opts.cwd);
|
|
261
|
+
if (wrote)
|
|
262
|
+
return { ok: true, tookOver, pushed: wrote.pushed };
|
|
263
|
+
await pause(200 + Math.floor(Math.random() * 800));
|
|
264
|
+
}
|
|
265
|
+
throw new Error(`could not hold the rows of ${gate}: ${STATE_BRANCH} kept moving; check that the job may push to it`);
|
|
266
|
+
}
|
|
267
|
+
/** Let go of `keys` where run `me` still holds them. Never throws: a row left held is taken over once the run is gone. */
|
|
268
|
+
export async function releaseLockRows(gate, keys, me, opts = {}) {
|
|
269
|
+
try {
|
|
270
|
+
checkGate(gate);
|
|
271
|
+
await fetchForLocks(opts.cwd);
|
|
272
|
+
for (let attempt = 0; attempt < ATTEMPTS; attempt++) {
|
|
273
|
+
const { sha, file } = await readCurrent(gate, opts.cwd);
|
|
274
|
+
const mine = keys.filter((k) => file.rows[k] === me);
|
|
275
|
+
if (mine.length === 0)
|
|
276
|
+
return true;
|
|
277
|
+
const wrote = await writeAndPush(gate, sha, withRowsReleased(file, mine, me), `Release ${mine.length} row${mine.length === 1 ? "" : "s"} of ${gate} held by run ${me}`, opts.cwd);
|
|
278
|
+
if (wrote)
|
|
279
|
+
return true;
|
|
280
|
+
await pause(200 + Math.floor(Math.random() * 800));
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
catch {
|
|
284
|
+
// Falls through: the rows stay until a later apply takes them over.
|
|
285
|
+
}
|
|
286
|
+
return false;
|
|
287
|
+
}
|
|
288
|
+
/** One line naming the runs that hold rows, and what of this apply they hold, for a log line and a refusal. */
|
|
289
|
+
export function describeHeldLockRows(held, rows) {
|
|
290
|
+
const address = new Map(rows.map((r) => [r.key, `${r.target}: ${r.address}`]));
|
|
291
|
+
const byRun = new Map();
|
|
292
|
+
for (const h of held) {
|
|
293
|
+
const e = byRun.get(h.holder.run) ?? { holder: h.holder, what: new Set() };
|
|
294
|
+
e.what.add(address.get(h.wanted) ?? h.wanted);
|
|
295
|
+
byRun.set(h.holder.run, e);
|
|
296
|
+
}
|
|
297
|
+
return [...byRun.values()]
|
|
298
|
+
.map(({ holder, what }) => `run ${holder.run}${holder.url ? ` (${holder.url})` : ""} is applying ${[...what].sort().join(", ")}`)
|
|
299
|
+
.join("; ");
|
|
300
|
+
}
|
|
301
|
+
/**
|
|
302
|
+
* Lease `rows` for the apply about to run (#4552): take them, or say who
|
|
303
|
+
* holds them. With no rows, a lease that holds nothing. Throws when the
|
|
304
|
+
* rows file cannot be read or written, so an apply that cannot hold its
|
|
305
|
+
* rows applies nothing.
|
|
306
|
+
*/
|
|
307
|
+
export async function leaseLockRows(gate, rows, opts = {}) {
|
|
308
|
+
const holder = opts.holder ?? lockRowHolder(process.env);
|
|
309
|
+
const keys = sortedLockRows(rows).map((r) => r.key);
|
|
310
|
+
const lease = { gate, holder, keys, release: () => (keys.length === 0 ? Promise.resolve(true) : releaseLockRows(gate, keys, holder.run, { ...(opts.cwd ? { cwd: opts.cwd } : {}) })) };
|
|
311
|
+
if (keys.length === 0)
|
|
312
|
+
return { ok: true, lease, tookOver: [] };
|
|
313
|
+
const taken = await takeLockRows(gate, rows, holder, opts);
|
|
314
|
+
if (!taken.ok)
|
|
315
|
+
return { ok: false, held: taken.held, message: describeHeldLockRows(taken.held, rows) };
|
|
316
|
+
return { ok: true, lease, tookOver: taken.tookOver };
|
|
317
|
+
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/lifecycle/retention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAYH,OAAO,EAAqC,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK1D,mDAAmD;AACnD,MAAM,MAAM,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;AAE3D,kCAAkC;AAClC,MAAM,MAAM,UAAU;AACpB,mFAAmF;AACjF,UAAU;AACZ,oDAAoD;GAClD,cAAc;AAChB,qFAAqF;GACnF,QAAQ;AACV,wEAAwE;GACtE,eAAe;AACjB,0GAA0G;GACxG,cAAc;AAChB,2FAA2F;GACzF,YAAY,CAAC;AAEjB,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,mHAAmH;IACnH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,MAAO,SAAQ,MAAM;IACpC,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,sDAAsD;IACtD,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,CAAC;IACxB,GAAG,EAAE,IAAI,CAAC;IACV,uFAAuF;IACvF,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACtC;AAiED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CASrG;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAGtD;AAkCD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,
|
|
1
|
+
{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/lifecycle/retention.ts"],"names":[],"mappings":"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"}
|
|
@@ -255,6 +255,9 @@ export function planLifecycleGc(input) {
|
|
|
255
255
|
const detail = `${p.op}/${p.gate}${p.environment ? ` in ${p.environment}` : ""}`;
|
|
256
256
|
if (p.planDigest)
|
|
257
257
|
keepFile(m.changeSets.get(digestKey(p.planDigest)), { code: "pending-gate", detail });
|
|
258
|
+
// #4551: an op wave's fact cites its change set apart from its set digest.
|
|
259
|
+
if (p.changeSet && p.changeSet !== p.planDigest)
|
|
260
|
+
keepFile(m.changeSets.get(digestKey(p.changeSet)), { code: "pending-gate", detail });
|
|
258
261
|
if (p.releaseDigest)
|
|
259
262
|
keepFile(m.releases.get(digestKey(p.releaseDigest)), { code: "pending-gate", detail });
|
|
260
263
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"run-ledger.d.ts","sourceRoot":"","sources":["../../src/lifecycle/run-ledger.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,
|
|
1
|
+
{"version":3,"file":"run-ledger.d.ts","sourceRoot":"","sources":["../../src/lifecycle/run-ledger.ts"],"names":[],"mappings":"AAsCA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAA+B,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAA+C,MAAM,eAAe,CAAC;AAClJ,OAAO,EAAsF,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAQhI,0EAA0E;AAC1E,eAAO,MAAM,eAAe,UAAU,CAAC;AAMvC,8FAA8F;AAC9F,wBAAgB,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM,CAEjE;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,EACzC,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,KAAK,EAAE;IACL,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACjC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IACrC,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,uDAAuD;IACvD,YAAY,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;CAC5C,GACA,gBAAgB,CAmDlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,gBAAgB,EACvB,IAAI,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACtB,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,CAAC,CAsBlD;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE,cAAc,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAIxD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAqC7F"}
|
|
@@ -36,7 +36,7 @@
|
|
|
36
36
|
*/
|
|
37
37
|
import { randomUUID } from "node:crypto";
|
|
38
38
|
import { sortedJsonReplacer } from "../utils.js";
|
|
39
|
-
import { opRunFailureOf } from "../op/runtime.js";
|
|
39
|
+
import { opRunFailureOf, opRunWaveOf } from "../op/runtime.js";
|
|
40
40
|
import { readBlobFromPath, readPathSha, readBlobBySha, writeBlobToPath, RefCASConflictError } from "./git.js";
|
|
41
41
|
/** Prefix folding the per-op run ledgers into one flat name under `<env>/`. See the module doc. */
|
|
42
42
|
const PREFIX = "runs__";
|
|
@@ -204,6 +204,14 @@ export function parseRunLedger(content) {
|
|
|
204
204
|
else
|
|
205
205
|
delete parsed.failure;
|
|
206
206
|
}
|
|
207
|
+
// #4551: and so is a `wave` that is not one.
|
|
208
|
+
if ("wave" in parsed) {
|
|
209
|
+
const wave = opRunWaveOf(parsed.wave);
|
|
210
|
+
if (wave)
|
|
211
|
+
parsed.wave = wave;
|
|
212
|
+
else
|
|
213
|
+
delete parsed.wave;
|
|
214
|
+
}
|
|
207
215
|
records.push(parsed);
|
|
208
216
|
}
|
|
209
217
|
catch {
|
|
@@ -1,3 +1,35 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The `s3` medium of the index store (#4519): objects in a bucket under a
|
|
3
|
+
* prefix of their own, never a record store's prefix.
|
|
4
|
+
*
|
|
5
|
+
* Transport is `fetch` with a SigV4 header signature from chant's one AWS
|
|
6
|
+
* signer (../cloud-lister/sigv4.ts, #4554), so core takes no `@aws-sdk/*`
|
|
7
|
+
* dependency. `fetch` is injectable: the conformance test runs
|
|
8
|
+
* against an in-process fake and nothing leaves the process.
|
|
9
|
+
*
|
|
10
|
+
* ## Credentials
|
|
11
|
+
*
|
|
12
|
+
* The rule is the one round 2 of the engine work set for every emulator run:
|
|
13
|
+
* a store pointed at an endpoint never reaches for the default AWS credential
|
|
14
|
+
* chain.
|
|
15
|
+
*
|
|
16
|
+
* - Explicit credentials (`credentials` in chant.config.ts, or
|
|
17
|
+
* `CHANT_SNAPSHOT_S3_ACCESS_KEY_ID` / `_SECRET_ACCESS_KEY` /
|
|
18
|
+
* `_SESSION_TOKEN`) are used as given.
|
|
19
|
+
* - With an `endpoint` and no explicit credentials the store refuses. It does
|
|
20
|
+
* not read `AWS_ACCESS_KEY_ID`, a profile file, or an instance role, so an
|
|
21
|
+
* emulator run can never sign with, or leak, a real account's keys.
|
|
22
|
+
* - With no endpoint (real S3), `AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`
|
|
23
|
+
* / `AWS_SESSION_TOKEN` answer. Profiles and instance roles are not read.
|
|
24
|
+
*
|
|
25
|
+
* ## History
|
|
26
|
+
*
|
|
27
|
+
* A snapshot keeps one key, so its history is the bucket's object versions:
|
|
28
|
+
* turn versioning on. An index version is a new key per read, so it needs no
|
|
29
|
+
* versioning. A write of an index version sends `If-None-Match: *`, and a 412
|
|
30
|
+
* means the version already exists.
|
|
31
|
+
*/
|
|
32
|
+
import { encodeRfc3986 } from "../cloud-lister/sigv4.js";
|
|
1
33
|
/** Explicit credentials. */
|
|
2
34
|
export interface S3StoreCredentials {
|
|
3
35
|
accessKeyId: string;
|
|
@@ -45,10 +77,11 @@ export interface S3ObjectVersion {
|
|
|
45
77
|
* header. Exported for the test that pins it.
|
|
46
78
|
*/
|
|
47
79
|
export declare function resolveS3Credentials(settings: S3StoreSettings, env?: Record<string, string | undefined>): S3StoreCredentials;
|
|
48
|
-
/** RFC 3986 percent-encoding, as S3 signs it. */
|
|
49
|
-
export
|
|
80
|
+
/** RFC 3986 percent-encoding, as S3 signs it: chant's one AWS signer's (../cloud-lister/sigv4.ts, #4554). */
|
|
81
|
+
export { encodeRfc3986 };
|
|
50
82
|
/**
|
|
51
|
-
* SigV4 headers for one S3 request
|
|
83
|
+
* SigV4 headers for one S3 request, signed by chant's one AWS signer
|
|
84
|
+
* (../cloud-lister/sigv4.ts, #4554). S3 signs the path encoded once, which is
|
|
52
85
|
* how {@link S3Medium} builds it, so the URL's pathname is the canonical URI
|
|
53
86
|
* as it stands.
|
|
54
87
|
*/
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"snapshot-store-s3.d.ts","sourceRoot":"","sources":["../../src/lifecycle/snapshot-store-s3.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"snapshot-store-s3.d.ts","sourceRoot":"","sources":["../../src/lifecycle/snapshot-store-s3.ts"],"names":[],"mappings":"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"}
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
* The `s3` medium of the index store (#4519): objects in a bucket under a
|
|
3
3
|
* prefix of their own, never a record store's prefix.
|
|
4
4
|
*
|
|
5
|
-
* Transport is `fetch` with a SigV4 header signature
|
|
6
|
-
*
|
|
7
|
-
*
|
|
5
|
+
* Transport is `fetch` with a SigV4 header signature from chant's one AWS
|
|
6
|
+
* signer (../cloud-lister/sigv4.ts, #4554), so core takes no `@aws-sdk/*`
|
|
7
|
+
* dependency. `fetch` is injectable: the conformance test runs
|
|
8
8
|
* against an in-process fake and nothing leaves the process.
|
|
9
9
|
*
|
|
10
10
|
* ## Credentials
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
* versioning. A write of an index version sends `If-None-Match: *`, and a 412
|
|
30
30
|
* means the version already exists.
|
|
31
31
|
*/
|
|
32
|
-
import {
|
|
32
|
+
import { encodeRfc3986, signV4 } from "../cloud-lister/sigv4.js";
|
|
33
33
|
export class S3StoreError extends Error {
|
|
34
34
|
constructor(message, status) {
|
|
35
35
|
super(message);
|
|
@@ -63,51 +63,16 @@ export function resolveS3Credentials(settings, env = process.env) {
|
|
|
63
63
|
}
|
|
64
64
|
return { accessKeyId: id, secretAccessKey: secret, ...(env.AWS_SESSION_TOKEN ? { sessionToken: env.AWS_SESSION_TOKEN } : {}) };
|
|
65
65
|
}
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
const hmac = (key, data) => createHmac("sha256", key).update(data, "utf8").digest();
|
|
69
|
-
/** RFC 3986 percent-encoding, as S3 signs it. */
|
|
70
|
-
export function encodeRfc3986(value) {
|
|
71
|
-
return encodeURIComponent(value).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
|
|
72
|
-
}
|
|
66
|
+
/** RFC 3986 percent-encoding, as S3 signs it: chant's one AWS signer's (../cloud-lister/sigv4.ts, #4554). */
|
|
67
|
+
export { encodeRfc3986 };
|
|
73
68
|
/**
|
|
74
|
-
* SigV4 headers for one S3 request
|
|
69
|
+
* SigV4 headers for one S3 request, signed by chant's one AWS signer
|
|
70
|
+
* (../cloud-lister/sigv4.ts, #4554). S3 signs the path encoded once, which is
|
|
75
71
|
* how {@link S3Medium} builds it, so the URL's pathname is the canonical URI
|
|
76
72
|
* as it stands.
|
|
77
73
|
*/
|
|
78
74
|
export function signS3Request(req) {
|
|
79
|
-
|
|
80
|
-
const timestamp = (req.now ?? new Date()).toISOString().replace(/[:-]|\.\d{3}/g, "");
|
|
81
|
-
const day = timestamp.slice(0, 8);
|
|
82
|
-
const payloadHash = req.body.length === 0 ? EMPTY_SHA256 : sha256Hex(req.body);
|
|
83
|
-
const signable = {
|
|
84
|
-
...Object.fromEntries(Object.entries(req.headers).map(([k, v]) => [k.toLowerCase(), v.trim()])),
|
|
85
|
-
host: url.host,
|
|
86
|
-
"x-amz-date": timestamp,
|
|
87
|
-
"x-amz-content-sha256": payloadHash,
|
|
88
|
-
...(req.credentials.sessionToken ? { "x-amz-security-token": req.credentials.sessionToken } : {}),
|
|
89
|
-
};
|
|
90
|
-
const names = Object.keys(signable).sort();
|
|
91
|
-
const pairs = [];
|
|
92
|
-
url.searchParams.forEach((v, k) => pairs.push([encodeRfc3986(k), encodeRfc3986(v)]));
|
|
93
|
-
pairs.sort((a, b) => (a[0] === b[0] ? (a[1] < b[1] ? -1 : 1) : a[0] < b[0] ? -1 : 1));
|
|
94
|
-
const canonical = [
|
|
95
|
-
req.method.toUpperCase(),
|
|
96
|
-
url.pathname || "/",
|
|
97
|
-
pairs.map(([k, v]) => `${k}=${v}`).join("&"),
|
|
98
|
-
names.map((n) => `${n}:${signable[n].replace(/\s+/g, " ")}\n`).join(""),
|
|
99
|
-
names.join(";"),
|
|
100
|
-
payloadHash,
|
|
101
|
-
].join("\n");
|
|
102
|
-
const scope = `${day}/${req.region}/s3/aws4_request`;
|
|
103
|
-
const toSign = ["AWS4-HMAC-SHA256", timestamp, scope, sha256Hex(canonical)].join("\n");
|
|
104
|
-
const key = hmac(hmac(hmac(hmac(`AWS4${req.credentials.secretAccessKey}`, day), req.region), "s3"), "aws4_request");
|
|
105
|
-
const signature = hmac(key, toSign).toString("hex");
|
|
106
|
-
const { host: _host, ...emitted } = signable;
|
|
107
|
-
return {
|
|
108
|
-
...emitted,
|
|
109
|
-
authorization: `AWS4-HMAC-SHA256 Credential=${req.credentials.accessKeyId}/${scope}, SignedHeaders=${names.join(";")}, Signature=${signature}`,
|
|
110
|
-
};
|
|
75
|
+
return signV4({ method: req.method, url: req.url, headers: req.headers, body: req.body, region: req.region, service: "s3", credentials: req.credentials, now: req.now ?? new Date(), contentSha256: true, omitHost: true });
|
|
111
76
|
}
|
|
112
77
|
const XML_ENTITIES = { amp: "&", lt: "<", gt: ">", quot: '"', apos: "'" };
|
|
113
78
|
const decodeXml = (s) => s.replace(/&(#x[0-9a-fA-F]+|#\d+|amp|lt|gt|quot|apos);/g, (_m, e) => e.startsWith("#x") ? String.fromCodePoint(parseInt(e.slice(2), 16)) : e.startsWith("#") ? String.fromCodePoint(parseInt(e.slice(1), 10)) : XML_ENTITIES[e]);
|