@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
package/src/op/op-waves.test.ts
CHANGED
|
@@ -976,6 +976,118 @@ describe("gates and holds a product's wave needs (#3821)", () => {
|
|
|
976
976
|
again.done();
|
|
977
977
|
});
|
|
978
978
|
|
|
979
|
+
test("a hold with record: chant spends the held gate before the re-run and writes its finished line with the hook's detail (#4623)", async () => {
|
|
980
|
+
const migrate = { name: "migrate", command: ["migrate", "{runs}"], onFailure: "approve" as const };
|
|
981
|
+
const spec: OpWavesSpec = { ...tg, hooks: { before: { plan: [migrate] }, after: tg.hooks!.after } };
|
|
982
|
+
const proof = JSON.stringify({ name: "split-queues", roots: ["queues"] });
|
|
983
|
+
const seen: { applied: number; finishedEnv?: string }[] = [];
|
|
984
|
+
let gatesRef: ReturnType<typeof memoryGateLedgerPort> | undefined;
|
|
985
|
+
const hook = (argv: string[], env: Record<string, string>, dir: string) => {
|
|
986
|
+
if (argv[0] !== "migrate") return 0;
|
|
987
|
+
if (env.CHANT_HOLD_APPROVED) {
|
|
988
|
+
seen.push({ applied: gatesRef!.applied.filter((a) => a.op === "tf-migrate").length, ...(env.CHANT_HOLD_FINISHED ? { finishedEnv: env.CHANT_HOLD_FINISHED } : {}) });
|
|
989
|
+
writeFileSync(join(dir, env.CHANT_HOLD_FINISHED!), JSON.stringify({ result: "applied", detail: { result: "applied", roots: "queues", "queues.after": "v2", nested: { no: 1 } } }));
|
|
990
|
+
return 0;
|
|
991
|
+
}
|
|
992
|
+
writeFileSync(join(dir, env.CHANT_HOLD!), JSON.stringify({ op: "tf-migrate", gate: "split-queues", digest: digest("m"), record: true, attachment: proof, pending: { commit: "abc123", members: [] } }));
|
|
993
|
+
return 3;
|
|
994
|
+
};
|
|
995
|
+
|
|
996
|
+
// Waiting: the attachment is stored once, and the pending fact names its digest.
|
|
997
|
+
const h = harness({ vpc: { planDigest: digest("1") }, dns: { planDigest: digest("2") } }, { hook, atBase: spec });
|
|
998
|
+
const gates = memoryGateLedgerPort();
|
|
999
|
+
gatesRef = gates;
|
|
1000
|
+
const waiting = await run(h, gates, spec);
|
|
1001
|
+
expect(waiting.exitCode).toBe(3);
|
|
1002
|
+
expect(gates.attachments.get(`tf-migrate/${digest("m")}`)).toBe(proof);
|
|
1003
|
+
expect(gates.appended[0]).toMatchObject({ op: "tf-migrate", gate: "split-queues", proof: expect.stringMatching(/^sha256:[0-9a-f]{64}$/) });
|
|
1004
|
+
expect(gates.applied).toEqual([]);
|
|
1005
|
+
h.done();
|
|
1006
|
+
|
|
1007
|
+
// Approved: the applied line is on the ledger before the re-run, and the finished line after it carries the flat detail.
|
|
1008
|
+
const again = harness({ vpc: { planDigest: digest("1"), empty: true }, dns: { planDigest: digest("2"), empty: true } }, { hook, atBase: spec });
|
|
1009
|
+
const approved = memoryGateLedgerPort({ resolutions: [{ version: 1, op: "tf-migrate", gate: "split-queues", resolvedBy: "alice", timestamp: "2026-10-10T00:00:00Z", planDigest: digest("m") }] });
|
|
1010
|
+
gatesRef = approved;
|
|
1011
|
+
const result = await run(again, approved, spec);
|
|
1012
|
+
expect(result.exitCode).toBe(0);
|
|
1013
|
+
expect(seen).toEqual([{ applied: 1, finishedEnv: ".chant/op-waves/" + spec.name + "/wave-1/hold-finished.json" }]);
|
|
1014
|
+
const spent = approved.applied.find((a) => a.op === "tf-migrate")!;
|
|
1015
|
+
expect(spent).toMatchObject({ kind: "applied", gate: "split-queues", planDigest: digest("m"), approvedBy: "alice", approvedAt: "2026-10-10T00:00:00Z", commit: "abc123", wave: { number: 1 } });
|
|
1016
|
+
expect(approved.finished).toEqual([
|
|
1017
|
+
expect.objectContaining({ kind: "finished", op: "tf-migrate", gate: "split-queues", planDigest: digest("m"), applied: spent.timestamp, result: "applied", detail: { result: "applied", roots: "queues", "queues.after": "v2" } }),
|
|
1018
|
+
]);
|
|
1019
|
+
again.done();
|
|
1020
|
+
});
|
|
1021
|
+
|
|
1022
|
+
test("a recorded hold whose digest applied already does not run again, and one whose spend is not pushed does not run (#4623)", async () => {
|
|
1023
|
+
const migrate = { name: "migrate", command: ["migrate", "{runs}"], onFailure: "approve" as const };
|
|
1024
|
+
const spec: OpWavesSpec = { ...tg, hooks: { before: { plan: [migrate] }, after: tg.hooks!.after } };
|
|
1025
|
+
let reruns = 0;
|
|
1026
|
+
const hook = (argv: string[], env: Record<string, string>, dir: string) => {
|
|
1027
|
+
if (argv[0] !== "migrate") return 0;
|
|
1028
|
+
if (env.CHANT_HOLD_APPROVED) {
|
|
1029
|
+
reruns++;
|
|
1030
|
+
return 0;
|
|
1031
|
+
}
|
|
1032
|
+
writeFileSync(join(dir, env.CHANT_HOLD!), JSON.stringify({ op: "tf-migrate", gate: "split-queues", digest: digest("m"), record: true }));
|
|
1033
|
+
return 3;
|
|
1034
|
+
};
|
|
1035
|
+
const approval = { version: 1 as const, op: "tf-migrate", gate: "split-queues", resolvedBy: "alice", timestamp: "2026-10-10T00:00:00Z", planDigest: digest("m") };
|
|
1036
|
+
const plans = { vpc: { planDigest: digest("1"), empty: true }, dns: { planDigest: digest("2"), empty: true } };
|
|
1037
|
+
|
|
1038
|
+
const spentAlready = harness(plans, { hook, atBase: spec });
|
|
1039
|
+
const gates = memoryGateLedgerPort({
|
|
1040
|
+
resolutions: [approval],
|
|
1041
|
+
applied: [{ version: 1, kind: "applied", op: "tf-migrate", gate: "split-queues", planDigest: digest("m"), approvedAt: approval.timestamp, approvedBy: "alice", timestamp: "2026-10-11T00:00:00Z" }],
|
|
1042
|
+
});
|
|
1043
|
+
const logs: string[] = [];
|
|
1044
|
+
const result = await run(spentAlready, gates, spec, (m) => logs.push(m));
|
|
1045
|
+
expect(result.exitCode).not.toBe(0);
|
|
1046
|
+
expect(reruns).toBe(0);
|
|
1047
|
+
expect(logs.join("\n")).toContain("applied already under the approval by alice");
|
|
1048
|
+
expect(gates.finished).toEqual([]);
|
|
1049
|
+
spentAlready.done();
|
|
1050
|
+
|
|
1051
|
+
const unpushed = harness(plans, { hook, atBase: spec });
|
|
1052
|
+
const memory = memoryGateLedgerPort({ resolutions: [approval] });
|
|
1053
|
+
const result2 = await run(unpushed, { ...memory, appendApplied: async () => ({ pushed: false, pushWarning: 'the push of chant/lifecycle to "origin" failed' }) }, spec);
|
|
1054
|
+
expect(result2.exitCode).not.toBe(0);
|
|
1055
|
+
expect(reruns).toBe(0);
|
|
1056
|
+
unpushed.done();
|
|
1057
|
+
});
|
|
1058
|
+
|
|
1059
|
+
test("a recorded hold's re-run that writes no finished file is finished by its exit code; a hold without record gets no CHANT_HOLD_FINISHED (#4623)", async () => {
|
|
1060
|
+
const migrate = { name: "migrate", command: ["migrate", "{runs}"], onFailure: "approve" as const };
|
|
1061
|
+
const spec: OpWavesSpec = { ...tg, hooks: { before: { plan: [migrate] }, after: tg.hooks!.after } };
|
|
1062
|
+
const approval = { version: 1 as const, op: "tf-migrate", gate: "split-queues", resolvedBy: "alice", timestamp: "2026-10-10T00:00:00Z", planDigest: digest("m") };
|
|
1063
|
+
const plans = { vpc: { planDigest: digest("1"), empty: true }, dns: { planDigest: digest("2"), empty: true } };
|
|
1064
|
+
const envs: Record<string, string>[] = [];
|
|
1065
|
+
const hookWith = (record: boolean) => (argv: string[], env: Record<string, string>, dir: string) => {
|
|
1066
|
+
if (argv[0] !== "migrate") return 0;
|
|
1067
|
+
if (env.CHANT_HOLD_APPROVED) {
|
|
1068
|
+
envs.push(env);
|
|
1069
|
+
return 0;
|
|
1070
|
+
}
|
|
1071
|
+
writeFileSync(join(dir, env.CHANT_HOLD!), JSON.stringify({ op: "tf-migrate", gate: "split-queues", digest: digest("m"), ...(record ? { record: true } : {}) }));
|
|
1072
|
+
return 3;
|
|
1073
|
+
};
|
|
1074
|
+
|
|
1075
|
+
const recorded = harness(plans, { hook: hookWith(true), atBase: spec });
|
|
1076
|
+
const gates = memoryGateLedgerPort({ resolutions: [approval] });
|
|
1077
|
+
expect((await run(recorded, gates, spec)).exitCode).toBe(0);
|
|
1078
|
+
expect(gates.finished).toEqual([expect.objectContaining({ gate: "split-queues", result: "applied" })]);
|
|
1079
|
+
expect(gates.finished[0]).not.toHaveProperty("detail");
|
|
1080
|
+
recorded.done();
|
|
1081
|
+
|
|
1082
|
+
const plain = harness(plans, { hook: hookWith(false), atBase: spec });
|
|
1083
|
+
const other = memoryGateLedgerPort({ resolutions: [approval] });
|
|
1084
|
+
expect((await run(plain, other, spec)).exitCode).toBe(0);
|
|
1085
|
+
expect(envs[1]).not.toHaveProperty("CHANT_HOLD_FINISHED");
|
|
1086
|
+
expect(other.applied.filter((a) => a.op === "tf-migrate")).toEqual([]);
|
|
1087
|
+
expect(other.finished).toEqual([]);
|
|
1088
|
+
plain.done();
|
|
1089
|
+
});
|
|
1090
|
+
|
|
979
1091
|
test("an approved re-run holds the wave on a further gate: two migrations wait, then apply in turn (#3847)", async () => {
|
|
980
1092
|
const migrate = { name: "migrate", command: ["migrate", "{runs}"], onFailure: "approve" as const };
|
|
981
1093
|
const spec: OpWavesSpec = { ...tg, hooks: { before: { plan: [migrate] }, after: tg.hooks!.after } };
|
package/src/op/op-waves.ts
CHANGED
|
@@ -95,8 +95,15 @@ import type { CloudTradeSpec } from "../ci-identity";
|
|
|
95
95
|
import { gatePointProblems, type GatePoint } from "./gate-point";
|
|
96
96
|
import { quorumProblems, type GateQuorumRule } from "./gate-quorum";
|
|
97
97
|
import { notifyConfigProblem, type NotifyConfig } from "../notify";
|
|
98
|
+
// Types only: the small bundles that carry this module stay without ../ci-respond.ts (#4629).
|
|
99
|
+
import type { CiResponses } from "../ci-respond";
|
|
98
100
|
import { WAVE_GATE_NAME_PATTERN, waveGateNameFrom, waveShare } from "../wave-layout";
|
|
99
101
|
import { waveOutcomeFileName } from "../wave-blocked";
|
|
102
|
+
import { opWaveHoldsProblems, opWaveParallelismProblems, opWaveStepProblems, type OpWaveHolds, type OpWaveStep } from "./op-waves-capability-spec";
|
|
103
|
+
import { opWaveReleaseProblems, type OpWaveReleaseNames } from "./op-waves-release";
|
|
104
|
+
import { CONTROL_DISPATCH_JOB, CONTROL_NAME, controlSettingsProblems, resolveControlTarget, type ControlSettingsInput, type ControlTarget } from "../control/dispatch";
|
|
105
|
+
|
|
106
|
+
export type { OpWaveCostFormat, OpWaveCostHold, OpWaveHolds, OpWaveStep } from "./op-waves-capability-spec";
|
|
100
107
|
|
|
101
108
|
/**
|
|
102
109
|
* The variables a wave job reads its notify secrets from, for the lexicons
|
|
@@ -125,9 +132,17 @@ export type GateApprovalSource =
|
|
|
125
132
|
/** As `ledger`, and the merged pull request's review of its head, by a writer other than its author. */
|
|
126
133
|
| "pr-review"
|
|
127
134
|
/** Only a resolution sealed by a key the signers file at base lists for its approver. */
|
|
128
|
-
| "sealed"
|
|
135
|
+
| "sealed"
|
|
136
|
+
/**
|
|
137
|
+
* As `ledger`, and the pull request's approval (#4550, ruling B): an
|
|
138
|
+
* approval of the pull request's gate (`approvals.pullRequest.gate` at
|
|
139
|
+
* base) whose change set covers every run of the wave's plan applies the
|
|
140
|
+
* wave without a second approval. A wave whose plan moved waits at its own
|
|
141
|
+
* gate. plywood's preset.
|
|
142
|
+
*/
|
|
143
|
+
| "pull-request";
|
|
129
144
|
|
|
130
|
-
export const GATE_APPROVAL_SOURCES: readonly GateApprovalSource[] = ["ledger", "pr-review", "sealed"];
|
|
145
|
+
export const GATE_APPROVAL_SOURCES: readonly GateApprovalSource[] = ["ledger", "pr-review", "sealed", "pull-request"];
|
|
131
146
|
|
|
132
147
|
/** What a failing hook does: fail the wave, or hold it for an approval of its set digest. */
|
|
133
148
|
export type OpWaveHookFailure = "fail" | "approve";
|
|
@@ -175,7 +190,8 @@ export interface OpWaveHook {
|
|
|
175
190
|
/**
|
|
176
191
|
* Argv template. `{op}`, `{wave}` and `{runs}` (the runs file, see
|
|
177
192
|
* `opWaveRunsPath`) are filled in; a `perRun` hook also gets `{target}`
|
|
178
|
-
* and, once the run is planned, `{plan}
|
|
193
|
+
* and, once the run is planned, `{plan}`, and `{planJson}` when the run's
|
|
194
|
+
* plan names the engine's plan document (`artifact.planJson`, #4614).
|
|
179
195
|
*/
|
|
180
196
|
command: string[];
|
|
181
197
|
/** Default `"fail"`. `"approve"` holds the wave for an approval of its set digest whatever its policy says. Not allowed after apply. */
|
|
@@ -207,6 +223,20 @@ export type OpWaveHookMoment = "before-observe" | "before-plan" | "after-plan" |
|
|
|
207
223
|
*/
|
|
208
224
|
export const OP_WAVE_HOOK_MOMENTS: readonly OpWaveHookMoment[] = ["before-observe", "before-plan", "after-plan", "after-gate", "before-apply", "after-apply"];
|
|
209
225
|
|
|
226
|
+
/**
|
|
227
|
+
* The check moment (#4556): `ci.hooks.check`, run in a product's check job,
|
|
228
|
+
* once, or once per target with `perRun`. It comes before any plan, so a
|
|
229
|
+
* hook has no `{plan}` and cannot hold for an approval. It is a `ci.hooks`
|
|
230
|
+
* moment only; an Op waves spec has no check job.
|
|
231
|
+
*/
|
|
232
|
+
export const CHECK_HOOK_MOMENT = "check";
|
|
233
|
+
|
|
234
|
+
/** A moment a hook runs at: an Op waves or pull-request moment, or `check` (#4556). */
|
|
235
|
+
export type CiHookMoment = OpWaveHookMoment | typeof CHECK_HOOK_MOMENT;
|
|
236
|
+
|
|
237
|
+
/** The first chant that reads and runs `ci.hooks.check` (#4556). A declaration that uses it sets `minReader` to it. */
|
|
238
|
+
export const CI_CHECK_HOOK_FLOOR = "0.124.55";
|
|
239
|
+
|
|
210
240
|
/**
|
|
211
241
|
* Who runs the `before.apply` and `after.apply` hooks (#3804). `chant`: the
|
|
212
242
|
* wave job, around the apply command. `apply`: the apply command itself,
|
|
@@ -242,6 +272,18 @@ export interface OpWaveRun {
|
|
|
242
272
|
* one job applies the wave (no `shares`, no `jobs`).
|
|
243
273
|
*/
|
|
244
274
|
dependsOn?: string[];
|
|
275
|
+
/**
|
|
276
|
+
* With the spec's `step` (#4545): this run's own input, laid over the
|
|
277
|
+
* step's (its vars, the outputs it reads). Strings have `{target}`, `{op}`
|
|
278
|
+
* and `{wave}` filled, as the step's do.
|
|
279
|
+
*/
|
|
280
|
+
input?: Record<string, unknown>;
|
|
281
|
+
/**
|
|
282
|
+
* With the spec's `step` (#4615): the environment and component this run's
|
|
283
|
+
* release record goes under, over the spec's `release`. Strings have
|
|
284
|
+
* `{target}`, `{op}` and `{wave}` filled. See `./op-waves-release.ts`.
|
|
285
|
+
*/
|
|
286
|
+
release?: OpWaveReleaseNames;
|
|
245
287
|
}
|
|
246
288
|
|
|
247
289
|
/**
|
|
@@ -348,6 +390,8 @@ export interface OpWave {
|
|
|
348
390
|
hooks?: OpWaveHooks;
|
|
349
391
|
/** Where this wave's jobs run (#3914). Default: the spec's `runner`. */
|
|
350
392
|
runner?: OpWaveRunner;
|
|
393
|
+
/** How many of the wave's runs apply at once (#4625), over the spec's `parallelism`. */
|
|
394
|
+
parallelism?: number;
|
|
351
395
|
/**
|
|
352
396
|
* The OIDC tokens this wave's jobs get (#3914), as `{ <variable>: <audience> }`;
|
|
353
397
|
* see {@link OpWaveJobGroup.idTokens}. With `jobs`, these are the deciding
|
|
@@ -384,6 +428,13 @@ export interface OpWavesSpec {
|
|
|
384
428
|
op: string;
|
|
385
429
|
/** The base gate name. Default: `name`. */
|
|
386
430
|
gate?: string;
|
|
431
|
+
/**
|
|
432
|
+
* Labels copied onto each job's run record (#4551), as an Op's `labels`
|
|
433
|
+
* are. `Env` names the environment the record goes under,
|
|
434
|
+
* `<Env>/runs__<name>.jsonl`; without it the record goes under `local`, as
|
|
435
|
+
* an Op's does.
|
|
436
|
+
*/
|
|
437
|
+
labels?: Record<string, string>;
|
|
387
438
|
/**
|
|
388
439
|
* The name of wave k's gate (#3821): `{gate}` is the base gate name and
|
|
389
440
|
* `{k}` the wave's number. Default `"{gate}-wave-{k}"`. A product moving
|
|
@@ -402,6 +453,14 @@ export interface OpWavesSpec {
|
|
|
402
453
|
neverOverMcp?: boolean;
|
|
403
454
|
/** Branches whose pushes run the waves. Default `["main"]`. */
|
|
404
455
|
branches?: string[];
|
|
456
|
+
/**
|
|
457
|
+
* An apply stands down when a newer commit on the branch will apply the
|
|
458
|
+
* same targets (#4581): its wave applies nothing, the job exits 6
|
|
459
|
+
* (`superseded`), and its run record says so. Checked once the wave's
|
|
460
|
+
* holds are settled and its lock grain's lease is taken, before the
|
|
461
|
+
* approval is spent. See `./op-waves-stand-down.ts`. Default false.
|
|
462
|
+
*/
|
|
463
|
+
standDown?: boolean;
|
|
405
464
|
/**
|
|
406
465
|
* Where every job the spec renders runs unless a wave or a job group names
|
|
407
466
|
* another (#3914). Default: the forge's default runner (`ubuntu-latest` on
|
|
@@ -422,6 +481,37 @@ export interface OpWavesSpec {
|
|
|
422
481
|
plan?: string[];
|
|
423
482
|
/** Apply one run whose plan is at `{plan}`. Default `chant run {op} --env {target}`. */
|
|
424
483
|
apply?: string[];
|
|
484
|
+
/**
|
|
485
|
+
* Plan and apply each run through a capability (#4545), in place of
|
|
486
|
+
* `plan` and `apply`: `{ kind, ...input }`, as a component's deploy step,
|
|
487
|
+
* with `{target}`, `{op}` and `{wave}` filled in each string and a run's
|
|
488
|
+
* `input` laid over it. `capability.plan` gives the run's plan digest and
|
|
489
|
+
* change set; `capability.run` applies that plan, and a plan it refuses as
|
|
490
|
+
* moved exits 4. See `./op-waves-capability.ts`.
|
|
491
|
+
*/
|
|
492
|
+
step?: OpWaveStep;
|
|
493
|
+
/**
|
|
494
|
+
* How many runs of a wave apply at once (#4625), a wave's own
|
|
495
|
+
* `parallelism` winning. Default 1, one at a time. Over 1 it needs `step`:
|
|
496
|
+
* a run whose wave lists one of its `dependsOn` before it waits for that
|
|
497
|
+
* one, and is blocked when it failed, as one at a time.
|
|
498
|
+
*/
|
|
499
|
+
parallelism?: number;
|
|
500
|
+
/**
|
|
501
|
+
* Holds the wave runs over its plans (#4545), read at the base commit
|
|
502
|
+
* with the policy: `policy` runs the workspace's `ci.policy` over each
|
|
503
|
+
* run's change set, `cost` prices the runs and holds the wave over a
|
|
504
|
+
* monthly change. See `./op-waves-capability.ts`.
|
|
505
|
+
*/
|
|
506
|
+
holds?: OpWaveHolds;
|
|
507
|
+
/**
|
|
508
|
+
* With a `step` (#4615): each run it applied gets a release record on its
|
|
509
|
+
* environment's ledger, so `chant components rollback` reads it. `env`
|
|
510
|
+
* and `component` name the ledger and the component (default `labels.Env`,
|
|
511
|
+
* else the wave's name, and the run's target); a run's own `release` wins.
|
|
512
|
+
* `false` writes none. See `./op-waves-release.ts`.
|
|
513
|
+
*/
|
|
514
|
+
release?: OpWaveReleaseNames | false;
|
|
425
515
|
/**
|
|
426
516
|
* Plan every run of a wave in one call (#3762), in place of `plan`. `{runs}`
|
|
427
517
|
* is a file chant writes, `{ "wave", "number", "runs": [{ "target", "op" }] }`;
|
|
@@ -474,6 +564,79 @@ export interface OpWavesSpec {
|
|
|
474
564
|
* `../notify.ts`.
|
|
475
565
|
*/
|
|
476
566
|
notify?: NotifyConfig;
|
|
567
|
+
/**
|
|
568
|
+
* The responses a wave job posts (#4629, `../ci-respond.ts`): a refused
|
|
569
|
+
* wave's diff (`wave-refused: diff`, on by default) and a failed apply's
|
|
570
|
+
* triage (`apply-failed: triage`, on by default), on the pull request the
|
|
571
|
+
* wave applies or a tracking issue. `off` turns one off. A job's
|
|
572
|
+
* `CHANT_RESPOND` sits under these.
|
|
573
|
+
*/
|
|
574
|
+
respond?: CiResponses;
|
|
575
|
+
/**
|
|
576
|
+
* The control repo (#4617, `@intentius/chant/ci-control`): once the last
|
|
577
|
+
* wave ran, a `control-dispatch` job tells the control repo how the waves
|
|
578
|
+
* ended (`applied`, `partial`, `unchanged`, `waiting` or `failed`, from
|
|
579
|
+
* the wave jobs' outcome files), and the control repo records it and runs
|
|
580
|
+
* this member's dependents when something applied. See
|
|
581
|
+
* {@link OpWavesControl}.
|
|
582
|
+
*/
|
|
583
|
+
control?: OpWavesControl;
|
|
584
|
+
}
|
|
585
|
+
|
|
586
|
+
/**
|
|
587
|
+
* An Op waves spec's `control` (#4617): the control settings a product
|
|
588
|
+
* reads from its config, in chant's spelling (`ControlSettingsInput`), with
|
|
589
|
+
* `member` named, since a spec has no repository name to default it to.
|
|
590
|
+
* The job maps the `tokenSecret` secret into `CHANT_CONTROL_TOKEN` for its
|
|
591
|
+
* one step, as the pull request loop's `control` does (#4568).
|
|
592
|
+
*/
|
|
593
|
+
export interface OpWavesControl extends ControlSettingsInput {
|
|
594
|
+
/** The member's name in the control repo's workspace. */
|
|
595
|
+
member: string;
|
|
596
|
+
/** A shell line that prints 1 when the commit was told about already (`controlDispatchScript`'s `sentCheck`). */
|
|
597
|
+
sentCheck?: string;
|
|
598
|
+
/** A shell line run once the control repo took the dispatch (`controlDispatchScript`'s `markSent`). */
|
|
599
|
+
markSent?: string;
|
|
600
|
+
}
|
|
601
|
+
|
|
602
|
+
/** The first chant whose Op waves specs take `control` (#4617). A product feature-detects this name. */
|
|
603
|
+
export const OP_WAVES_CONTROL_FLOOR = "0.124.55";
|
|
604
|
+
|
|
605
|
+
/** The control dispatch job's name in an Op waves pipeline (#4617). */
|
|
606
|
+
export const OP_WAVES_CONTROL_JOB = CONTROL_DISPATCH_JOB;
|
|
607
|
+
|
|
608
|
+
/** The problems with a spec's `control` (#4617), each naming its key. */
|
|
609
|
+
export function opWavesControlProblems(control: unknown): string[] {
|
|
610
|
+
const problems = controlSettingsProblems(control, "control");
|
|
611
|
+
if (problems.length > 0) return problems;
|
|
612
|
+
const c = control as Record<string, unknown>;
|
|
613
|
+
const out: string[] = [];
|
|
614
|
+
if (!(typeof c.member === "string" && CONTROL_NAME.test(c.member))) out.push("control.member must name this repo in the control repo's workspace: an Op waves spec has no repository name to default it to");
|
|
615
|
+
for (const key of ["sentCheck", "markSent"] as const) {
|
|
616
|
+
if (c[key] !== undefined && !(typeof c[key] === "string" && c[key] !== "" && !(c[key] as string).includes("\n"))) out.push(`control.${key} must be one shell line`);
|
|
617
|
+
}
|
|
618
|
+
return out;
|
|
619
|
+
}
|
|
620
|
+
|
|
621
|
+
/** The control target of a spec's `control` (#4617), its defaults filled in. */
|
|
622
|
+
export function opWavesControlTarget(control: OpWavesControl): ControlTarget {
|
|
623
|
+
const { sentCheck: _s, markSent: _m, ...settings } = control;
|
|
624
|
+
return resolveControlTarget(settings, control.member);
|
|
625
|
+
}
|
|
626
|
+
|
|
627
|
+
/**
|
|
628
|
+
* The command the control job runs before its dispatch (#4617): reads every
|
|
629
|
+
* wave job's outcome file and prints the outcome word, through the
|
|
630
|
+
* product's bin when it has one.
|
|
631
|
+
*/
|
|
632
|
+
export function opWavesOutcomeCommand(specFile: string, bin?: string): string[] {
|
|
633
|
+
return [...opWaveBinArgv(bin), "run", "wave", "--spec", specFile, "--waves-outcome"];
|
|
634
|
+
}
|
|
635
|
+
|
|
636
|
+
/** The jobs the control job needs (#4617): the last wave's applying jobs, as a next wave would need them. */
|
|
637
|
+
export function opWavesLastJobs(jobs: readonly OpWaveJob[]): string[] {
|
|
638
|
+
const last = jobs.reduce((max, j) => Math.max(max, j.wave), 0);
|
|
639
|
+
return jobs.filter((j) => j.wave === last && j.kind !== "decide").map((j) => j.jobName);
|
|
477
640
|
}
|
|
478
641
|
|
|
479
642
|
/** Which runs a wave's set digest covers (#3821). */
|
|
@@ -542,6 +705,14 @@ export interface OpWavesApprovals {
|
|
|
542
705
|
reviewLedger?: string;
|
|
543
706
|
/** Who else was involved in a change, for `quorum` (#4333). Read at the base commit. */
|
|
544
707
|
involved?: OpWavesInvolved;
|
|
708
|
+
/**
|
|
709
|
+
* The pull request's gate a wave under `approval: "pull-request"` takes
|
|
710
|
+
* its approval from (#4550): `{ "gate": "up" }`, recorded under the spec's
|
|
711
|
+
* op. Read at the base commit, so a change cannot name the gate its own
|
|
712
|
+
* waves are judged by. Needs the plans file's `changeSet`, which the
|
|
713
|
+
* approval's change set must cover.
|
|
714
|
+
*/
|
|
715
|
+
pullRequest?: { gate: string };
|
|
545
716
|
}
|
|
546
717
|
|
|
547
718
|
/**
|
|
@@ -584,9 +755,47 @@ export interface OpWavesResume {
|
|
|
584
755
|
schedule: string;
|
|
585
756
|
}
|
|
586
757
|
|
|
587
|
-
/**
|
|
588
|
-
|
|
589
|
-
|
|
758
|
+
/**
|
|
759
|
+
* The words a generated job runs in place of `chant` (#4607): a product's
|
|
760
|
+
* `words.bin`, such as `npx --no-install plywood`, split on spaces. Absent
|
|
761
|
+
* or blank: `chant`.
|
|
762
|
+
*/
|
|
763
|
+
export function opWaveBinArgv(bin?: string): string[] {
|
|
764
|
+
const words = (bin ?? "").split(/\s+/).filter(Boolean);
|
|
765
|
+
return words.length > 0 ? words : ["chant"];
|
|
766
|
+
}
|
|
767
|
+
|
|
768
|
+
/** The command a resume job runs, through the product's bin when it has one (#4607). */
|
|
769
|
+
export function opWavesResumeCommand(spec: Pick<OpWavesSpec, "name">, bin?: string): string[] {
|
|
770
|
+
return [...opWaveBinArgv(bin), "run", "resume", "--op", spec.name];
|
|
771
|
+
}
|
|
772
|
+
|
|
773
|
+
/** The command a `pr-review` spec's plans job runs on a pull request (#3684), through the product's bin (#4607). */
|
|
774
|
+
export function opWavesRecordPlansCommand(specFile: string, bin?: string): string[] {
|
|
775
|
+
return [...opWaveBinArgv(bin), "run", "wave", "--spec", specFile, "--record-plans"];
|
|
776
|
+
}
|
|
777
|
+
|
|
778
|
+
/** The GitLab variable a pipeline schedule sets to `1` to post every open merge request's approval status (#4630). */
|
|
779
|
+
export const OP_WAVES_APPROVAL_STATUS_VAR = "CHANT_APPROVAL_STATUS";
|
|
780
|
+
|
|
781
|
+
/**
|
|
782
|
+
* Whether a spec's pipeline records each head's plans and posts
|
|
783
|
+
* `<product>/approval` before merge (#4630): some wave takes its approval
|
|
784
|
+
* from the pull request, by its review (`pr-review`) or by its own approval
|
|
785
|
+
* (`pull-request`, under the 2026-10-28 ruling).
|
|
786
|
+
*/
|
|
787
|
+
export function opWavesPostsApprovalStatus(spec: Pick<OpWavesSpec, "waves">): boolean {
|
|
788
|
+
return spec.waves.some((w) => w.approval === "pr-review" || w.approval === "pull-request");
|
|
789
|
+
}
|
|
790
|
+
|
|
791
|
+
/**
|
|
792
|
+
* The command the approval status job runs (#4630), through the product's
|
|
793
|
+
* bin: `--pr`, `--head` and `--base` from the pull request event on GitHub
|
|
794
|
+
* and Forgejo, `--open` on GitLab.
|
|
795
|
+
*/
|
|
796
|
+
export function opWavesApprovalStatusCommand(specFile: string, forge: "github" | "gitlab" | "forgejo", bin?: string): string[] {
|
|
797
|
+
const at = forge === "gitlab" ? ["--open"] : ["--pr", '"$PR_NUMBER"', "--head", '"$HEAD_SHA"', "--base", '"$BASE_SHA"'];
|
|
798
|
+
return [...opWaveBinArgv(bin), "run", "wave", "--spec", specFile, "--approval-status", ...at, "--forge", forge];
|
|
590
799
|
}
|
|
591
800
|
|
|
592
801
|
/** The default apply command. */
|
|
@@ -641,6 +850,11 @@ const NAME = /^[a-z0-9][a-z0-9_-]*$/;
|
|
|
641
850
|
export function assertOpWavesSpec(spec: OpWavesSpec): void {
|
|
642
851
|
const where = `Op waves "${spec.name}"`;
|
|
643
852
|
if (!NAME.test(spec.name)) throw new Error(`${where}: the name must be lowercase letters, digits, "-" and "_"`);
|
|
853
|
+
if (spec.control !== undefined) {
|
|
854
|
+
// #4617: the control repo's settings, checked as the pull request loop's are.
|
|
855
|
+
const problems = opWavesControlProblems(spec.control);
|
|
856
|
+
if (problems.length > 0) throw new Error(`${where}: ${problems.join("; ")}.`);
|
|
857
|
+
}
|
|
644
858
|
if (!spec.op) throw new Error(`${where} names no \`op\`. Name the Op a run runs when it names none.`);
|
|
645
859
|
if (spec.plan !== undefined && spec.planWave !== undefined) {
|
|
646
860
|
throw new Error(`${where} has both \`plan\` and \`planWave\`. A wave is planned one run at a time or all at once; give one.`);
|
|
@@ -648,7 +862,11 @@ export function assertOpWavesSpec(spec: OpWavesSpec): void {
|
|
|
648
862
|
if (spec.apply !== undefined && spec.applyWave !== undefined) {
|
|
649
863
|
throw new Error(`${where} has both \`apply\` and \`applyWave\`. A wave is applied one run at a time or all at once; give one.`);
|
|
650
864
|
}
|
|
651
|
-
if (spec.
|
|
865
|
+
if (spec.step !== undefined) {
|
|
866
|
+
// #4545: a step plans and applies; its problems include a command set beside it.
|
|
867
|
+
const problems = opWaveStepProblems(spec);
|
|
868
|
+
if (problems.length > 0) throw new Error(`${where}: ${problems.join("; ")}.`);
|
|
869
|
+
} else if (spec.planWave !== undefined) {
|
|
652
870
|
assertArgv(where, "planWave", spec.planWave);
|
|
653
871
|
if (!spec.planWave.some((part) => part.includes("{plans}"))) {
|
|
654
872
|
throw new Error(`${where}: the \`planWave\` command never names {plans}, the file it writes each run's plan digest to.`);
|
|
@@ -670,7 +888,22 @@ export function assertOpWavesSpec(spec: OpWavesSpec): void {
|
|
|
670
888
|
}
|
|
671
889
|
}
|
|
672
890
|
assertOpWaveHooks(where, spec.hooks);
|
|
891
|
+
if (spec.standDown !== undefined && typeof spec.standDown !== "boolean") throw new Error(`${where}: \`standDown\` must be true or false.`);
|
|
892
|
+
{
|
|
893
|
+
const problems = opWaveReleaseProblems(spec);
|
|
894
|
+
if (problems.length > 0) throw new Error(`${where}: ${problems.join("; ")}.`);
|
|
895
|
+
}
|
|
673
896
|
if (spec.waves.length === 0) throw new Error(`${where} has no waves.`);
|
|
897
|
+
{
|
|
898
|
+
const problems = opWaveHoldsProblems(spec.holds);
|
|
899
|
+
if (problems.length > 0) throw new Error(`${where}: ${problems.join("; ")}.`);
|
|
900
|
+
}
|
|
901
|
+
if (spec.labels !== undefined) {
|
|
902
|
+
const l = spec.labels as unknown;
|
|
903
|
+
if (l === null || typeof l !== "object" || Array.isArray(l) || !Object.values(l as Record<string, unknown>).every((v) => typeof v === "string")) {
|
|
904
|
+
throw new Error(`${where}: \`labels\` must map names to strings, such as { "Env": "prod" }.`);
|
|
905
|
+
}
|
|
906
|
+
}
|
|
674
907
|
if (spec.resume !== undefined && (typeof spec.resume.schedule !== "string" || spec.resume.schedule.trim().split(/\s+/).length !== 5)) {
|
|
675
908
|
throw new Error(`${where}: resume.schedule must be a five-field cron expression, such as "*/10 * * * *".`);
|
|
676
909
|
}
|
|
@@ -695,13 +928,25 @@ export function assertOpWavesSpec(spec: OpWavesSpec): void {
|
|
|
695
928
|
if (problems.length > 0) throw new Error(`${where}: ${problems.join("; ")}.`);
|
|
696
929
|
continue;
|
|
697
930
|
}
|
|
698
|
-
if (key
|
|
931
|
+
if (key === "pullRequest") {
|
|
932
|
+
// #4550: the pull request's gate a pull-request wave takes its approval from, read at base.
|
|
933
|
+
const gate = (value as { gate?: unknown } | null)?.gate;
|
|
934
|
+
if (value === null || typeof value !== "object" || Array.isArray(value) || Object.keys(value).some((k) => k !== "gate") || typeof gate !== "string" || !OP_LEDGER_NAME.test(gate)) {
|
|
935
|
+
throw new Error(`${where}: approvals.pullRequest must be { "gate": "<gate>" }, the pull request's gate, such as "up".`);
|
|
936
|
+
}
|
|
937
|
+
continue;
|
|
938
|
+
}
|
|
939
|
+
if (key !== "spend") throw new Error(`${where}: approvals.${key} is not a setting; the ones there are approvals.spend, approvals.quorum, approvals.reviewLedger, approvals.involved and approvals.pullRequest.`);
|
|
699
940
|
if (typeof value !== "boolean") throw new Error(`${where}: approvals.spend must be true or false.`);
|
|
700
941
|
}
|
|
701
942
|
if ((a as OpWavesApprovals).quorum?.length && (spec.point !== undefined || spec.waves.some((w) => w.point !== undefined))) {
|
|
702
943
|
throw new Error(`${where}: approvals.quorum and a decision point are both set; a gate that asks a point takes its deciders and quorum from the point, so drop one of them.`);
|
|
703
944
|
}
|
|
704
945
|
}
|
|
946
|
+
// #4550: a wave that takes the pull request's approval needs to know its gate.
|
|
947
|
+
if (spec.waves.some((w) => w.approval === "pull-request") && !spec.approvals?.pullRequest) {
|
|
948
|
+
throw new Error(`${where}: a wave with approval "pull-request" takes the pull request's approval, so the spec needs approvals.pullRequest: { "gate": "<gate>" }.`);
|
|
949
|
+
}
|
|
705
950
|
if (spec.gateName !== undefined) {
|
|
706
951
|
if (typeof spec.gateName !== "string" || !spec.gateName.includes("{k}") || /\s/.test(spec.gateName)) {
|
|
707
952
|
throw new Error(`${where}: gateName must be a pattern with {k}, the wave's number, and no spaces, such as "${OP_WAVE_DEFAULT_GATE_NAME}" or "wave-{k}".`);
|
|
@@ -731,10 +976,26 @@ export function assertOpWavesSpec(spec: OpWavesSpec): void {
|
|
|
731
976
|
}
|
|
732
977
|
if (spec.neverOverMcp !== undefined && typeof spec.neverOverMcp !== "boolean") throw new Error(`${where}: neverOverMcp must be true or false.`);
|
|
733
978
|
if (spec.runner !== undefined) assertOpWaveRunner(where, "runner", spec.runner);
|
|
979
|
+
{
|
|
980
|
+
const problems = opWaveParallelismProblems(spec);
|
|
981
|
+
if (problems.length > 0) throw new Error(`${where}: ${problems[0]}.`);
|
|
982
|
+
}
|
|
734
983
|
if (spec.notify !== undefined) {
|
|
735
984
|
const problem = notifyConfigProblem(spec.notify, "notify");
|
|
736
985
|
if (problem) throw new Error(`${where}: ${problem}`);
|
|
737
986
|
}
|
|
987
|
+
if (spec.respond !== undefined) {
|
|
988
|
+
const respond = spec.respond as unknown;
|
|
989
|
+
if (respond === null || typeof respond !== "object" || Array.isArray(respond)) throw new Error(`${where}: respond must be an object of event to mode, such as { "wave-refused": "off" }.`);
|
|
990
|
+
// The wave events and their modes, as ../ci-respond.ts's CI_RESPONSES has them.
|
|
991
|
+
const modes: Record<string, readonly string[]> = { "wave-refused": ["diff", "off"], "apply-failed": ["triage", "off"] };
|
|
992
|
+
for (const [event, mode] of Object.entries(respond as Record<string, unknown>)) {
|
|
993
|
+
if (event === "description") throw new Error(`${where}: respond: the description check runs in the plan-note job, so an op waves spec takes only wave-refused and apply-failed.`);
|
|
994
|
+
const allowed = modes[event];
|
|
995
|
+
if (!allowed) throw new Error(`${where}: respond names no event ${JSON.stringify(event)}; the events are wave-refused and apply-failed.`);
|
|
996
|
+
if (typeof mode !== "string" || !allowed.includes(mode)) throw new Error(`${where}: respond: ${event} takes ${allowed.join(" or ")}, not ${JSON.stringify(mode)}.`);
|
|
997
|
+
}
|
|
998
|
+
}
|
|
738
999
|
const names = new Set<string>();
|
|
739
1000
|
for (const wave of spec.waves) {
|
|
740
1001
|
if (!NAME.test(wave.name)) {
|
|
@@ -832,14 +1093,14 @@ function assertOpWaveDependsOn(where: string, spec: OpWavesSpec): void {
|
|
|
832
1093
|
const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
833
1094
|
|
|
834
1095
|
/** The key each cloud of a `cloud` trade names its identity under (`IDENTITY_KEY` in ../ci-identity.ts, kept here so this module imports none of it). */
|
|
835
|
-
const CLOUD_IDENTITY_KEY: Record<string, string> = { aws: "role", gcp: "serviceAccount", azure: "clientId" };
|
|
1096
|
+
const CLOUD_IDENTITY_KEY: Record<string, string> = { aws: "role", gcp: "serviceAccount", azure: "clientId", pulumi: "token" };
|
|
836
1097
|
|
|
837
|
-
/** Refuse a `cloud` (#4332) the trade could not run: an unknown cloud, one that names no identity, or no audience. */
|
|
838
|
-
function assertOpWaveCloud(where: string, field: string, cloud: unknown): void {
|
|
839
|
-
if (cloud === null || typeof cloud !== "object" || Array.isArray(cloud) || Object.keys(cloud).length === 0) throw new Error(`${where}: ${field} must name one or more of aws, gcp and
|
|
1098
|
+
/** Refuse a `cloud` (#4332) the trade could not run: an unknown cloud, one that names no identity, or no audience. Scheduled Ops check theirs with it too (#4631). */
|
|
1099
|
+
export function assertOpWaveCloud(where: string, field: string, cloud: unknown): void {
|
|
1100
|
+
if (cloud === null || typeof cloud !== "object" || Array.isArray(cloud) || Object.keys(cloud).length === 0) throw new Error(`${where}: ${field} must name one or more of aws, gcp, azure and pulumi.`);
|
|
840
1101
|
for (const [name, c] of Object.entries(cloud as Record<string, unknown>)) {
|
|
841
1102
|
const key = CLOUD_IDENTITY_KEY[name];
|
|
842
|
-
if (!key) throw new Error(`${where}: ${field}.${name} is not a cloud; use aws, gcp or
|
|
1103
|
+
if (!key) throw new Error(`${where}: ${field}.${name} is not a cloud; use aws, gcp, azure or pulumi.`);
|
|
843
1104
|
const t = c as Record<string, unknown> | null;
|
|
844
1105
|
const targets = t?.targets;
|
|
845
1106
|
const targetsOk = targets === undefined || (Array.isArray(targets) && targets.every((e) => e && Array.isArray((e as { targets?: unknown }).targets) && typeof (e as Record<string, unknown>)[key] === "string"));
|
|
@@ -978,6 +1239,7 @@ export function assertOpWaveHooks(where: string, hooks: OpWaveHooks | undefined)
|
|
|
978
1239
|
}
|
|
979
1240
|
continue;
|
|
980
1241
|
}
|
|
1242
|
+
if (side === "check") throw new Error(`${where}: hooks.check runs in a product's check job, so it belongs in ci.hooks of the workspace declaration, not in an Op waves spec.`);
|
|
981
1243
|
if (side !== "before" && side !== "after") throw new Error(`${where}: hooks.${side} is not a moment; use hooks.before or hooks.after (or hooks.apply.runBy).`);
|
|
982
1244
|
if (stages === null || typeof stages !== "object" || Array.isArray(stages)) throw new Error(`${where}: hooks.${side} must be { "plan"?: [...], "apply"?: [...] }.`);
|
|
983
1245
|
for (const [stage, list] of Object.entries(stages as Record<string, unknown>)) {
|
|
@@ -1004,9 +1266,9 @@ export function assertOpWaveHooks(where: string, hooks: OpWaveHooks | undefined)
|
|
|
1004
1266
|
throw new Error(`${where}: ${which}.targets must be a non-empty list of targets or patterns, such as ["prod/*"].`);
|
|
1005
1267
|
}
|
|
1006
1268
|
if (!hook.perRun) {
|
|
1007
|
-
const named = hook.command.find((part) => part.includes("{target}") || part.includes("{plan}"));
|
|
1008
|
-
if (named) throw new Error(`${where}: ${which} runs once for the wave, so it has no {target} or {
|
|
1009
|
-
} else if (side === "before" && (stage === "plan" || stage === "observe") && hook.command.some((part) => part.includes("{plan}"))) {
|
|
1269
|
+
const named = hook.command.find((part) => part.includes("{target}") || part.includes("{plan}") || part.includes("{planJson}"));
|
|
1270
|
+
if (named) throw new Error(`${where}: ${which} runs once for the wave, so it has no {target}, {plan} or {planJson} ("${named}"). Set "perRun": true, or read the runs from {runs}.`);
|
|
1271
|
+
} else if (side === "before" && (stage === "plan" || stage === "observe") && hook.command.some((part) => part.includes("{plan}") || part.includes("{planJson}"))) {
|
|
1010
1272
|
throw new Error(`${where}: ${which} runs before the plan, so it has no {plan} yet.`);
|
|
1011
1273
|
}
|
|
1012
1274
|
});
|
|
@@ -1022,16 +1284,51 @@ export function assertOpWaveHooks(where: string, hooks: OpWaveHooks | undefined)
|
|
|
1022
1284
|
*/
|
|
1023
1285
|
export const PR_LOOP_HOOK_MOMENTS: readonly OpWaveHookMoment[] = ["before-observe", "before-plan", "after-plan", "after-gate", "before-apply", "after-apply"];
|
|
1024
1286
|
|
|
1287
|
+
/** `ci.hooks` in the workspace declaration: the Op waves moments, and `check` (#4556). */
|
|
1288
|
+
export interface CiHooks extends OpWaveHooks {
|
|
1289
|
+
/** Run in the check job (#4556), once, or once per target with `perRun`. Read at base like every moment. */
|
|
1290
|
+
check?: OpWaveHook[];
|
|
1291
|
+
}
|
|
1292
|
+
|
|
1025
1293
|
/**
|
|
1026
1294
|
* Refuse `ci.hooks` a pull-request job could not run (#4288): what
|
|
1027
1295
|
* {@link assertOpWaveHooks} refuses, plus `apply.runBy`, since chant itself
|
|
1028
|
-
* runs a pull request's apply
|
|
1296
|
+
* runs a pull request's apply, and a `check` hook that names a plan or asks
|
|
1297
|
+
* for an approval (#4556).
|
|
1029
1298
|
*/
|
|
1030
|
-
export function assertPrLoopHooks(where: string, hooks:
|
|
1031
|
-
|
|
1299
|
+
export function assertPrLoopHooks(where: string, hooks: CiHooks | undefined): void {
|
|
1300
|
+
if (hooks !== undefined && hooks !== null && typeof hooks === "object" && !Array.isArray(hooks) && "check" in hooks) {
|
|
1301
|
+
const { check, ...rest } = hooks;
|
|
1302
|
+
assertCheckHooks(where, check);
|
|
1303
|
+
assertOpWaveHooks(where, rest);
|
|
1304
|
+
} else {
|
|
1305
|
+
assertOpWaveHooks(where, hooks);
|
|
1306
|
+
}
|
|
1032
1307
|
if (hooks?.apply !== undefined) throw new Error(`${where}: hooks.apply.runBy is for an Op waves spec; chant runs a pull request's apply, so it runs the apply-stage hooks itself.`);
|
|
1033
1308
|
}
|
|
1034
1309
|
|
|
1310
|
+
/** Refuse `ci.hooks.check` hooks the check job could not run (#4556). */
|
|
1311
|
+
export function assertCheckHooks(where: string, list: unknown): void {
|
|
1312
|
+
if (!Array.isArray(list)) throw new Error(`${where}: hooks.check must be a list of hooks.`);
|
|
1313
|
+
list.forEach((hook: OpWaveHook, i: number) => {
|
|
1314
|
+
const which = `hooks.check[${i}]${hook && typeof hook === "object" && typeof hook.name === "string" ? ` (${hook.name})` : ""}`;
|
|
1315
|
+
if (!hook || typeof hook !== "object") throw new Error(`${where}: ${which} must be { "command": [...], "name"?, "onFailure"?, "perRun"?, "targets"? }.`);
|
|
1316
|
+
assertArgv(where, `${which}.command`, hook.command);
|
|
1317
|
+
if (hook.onFailure === "approve") throw new Error(`${where}: ${which} has onFailure "approve", but the check runs before any plan, so there is nothing to approve. Use "fail".`);
|
|
1318
|
+
if (hook.onFailure !== undefined && hook.onFailure !== "fail") throw new Error(`${where}: ${which} has onFailure "${hook.onFailure}"; use "fail".`);
|
|
1319
|
+
if (hook.perRun !== undefined && typeof hook.perRun !== "boolean") throw new Error(`${where}: ${which}.perRun must be true or false.`);
|
|
1320
|
+
if (hook.targets !== undefined && (!Array.isArray(hook.targets) || hook.targets.length === 0 || !hook.targets.every((t) => typeof t === "string" && t !== ""))) {
|
|
1321
|
+
throw new Error(`${where}: ${which}.targets must be a non-empty list of targets or patterns, such as ["prod/*"].`);
|
|
1322
|
+
}
|
|
1323
|
+
const plan = hook.command.find((part) => part.includes("{plan}"));
|
|
1324
|
+
if (plan) throw new Error(`${where}: ${which} runs before any plan, so it has no {plan} ("${plan}").`);
|
|
1325
|
+
if (!hook.perRun) {
|
|
1326
|
+
const target = hook.command.find((part) => part.includes("{target}"));
|
|
1327
|
+
if (target) throw new Error(`${where}: ${which} runs once for the check, so it has no {target} ("${target}"). Set "perRun": true.`);
|
|
1328
|
+
}
|
|
1329
|
+
});
|
|
1330
|
+
}
|
|
1331
|
+
|
|
1035
1332
|
/** The hooks of each moment for wave `name`: the spec's, then the wave's own. */
|
|
1036
1333
|
export function opWaveHooksAt(spec: Pick<OpWavesSpec, "hooks" | "waves">, name: string): Record<OpWaveHookMoment, OpWaveHook[]> {
|
|
1037
1334
|
const wave = spec.waves.find((w) => w.name === name);
|
|
@@ -1058,15 +1355,16 @@ export function opWaveShare<T extends { target: string }>(runs: readonly T[], sh
|
|
|
1058
1355
|
|
|
1059
1356
|
/**
|
|
1060
1357
|
* The jobs of an Op waves pipeline, in order. `specFile` is the spec's path
|
|
1061
|
-
* from the job's working directory, which every command names.
|
|
1358
|
+
* from the job's working directory, which every command names. `bin` is the
|
|
1359
|
+
* product's command in place of `chant` (#4607, {@link opWaveBinArgv}).
|
|
1062
1360
|
*/
|
|
1063
|
-
export function opWaveJobs(spec: OpWavesSpec, specFile: string): OpWaveJob[] {
|
|
1361
|
+
export function opWaveJobs(spec: OpWavesSpec, specFile: string, options: { bin?: string } = {}): OpWaveJob[] {
|
|
1064
1362
|
assertOpWavesSpec(spec);
|
|
1065
1363
|
const jobs: OpWaveJob[] = [];
|
|
1066
1364
|
let previous: string[] = [];
|
|
1067
1365
|
spec.waves.forEach((wave, index) => {
|
|
1068
1366
|
const k = index + 1;
|
|
1069
|
-
const command = [
|
|
1367
|
+
const command = [...opWaveBinArgv(options.bin), "run", "wave", "--spec", specFile, "--wave", String(k), ...(spec.base ? ["--base", spec.base] : [])];
|
|
1070
1368
|
const prefix = `wave-${k}-${wave.name}`;
|
|
1071
1369
|
const shares = wave.shares ?? 1;
|
|
1072
1370
|
if (shares === 1 && wave.jobs === undefined) {
|