@intentius/chant 0.124.54 → 0.124.56
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/__fixtures__/estate-ledger.d.ts +13 -0
- package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
- package/dist/__fixtures__/estate-ledger.js +67 -0
- package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
- package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
- package/dist/__fixtures__/oidc-emulator.js +26 -2
- package/dist/__fixtures__/product-words.d.ts +78 -0
- package/dist/__fixtures__/product-words.d.ts.map +1 -0
- package/dist/__fixtures__/product-words.js +43 -0
- package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/dist/__golden__/wave-loop/op-held-on.json +28 -7
- package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/dist/__golden__/wave-loop/op-overridden.json +28 -7
- package/dist/__golden__/wave-loop/op-per-run.json +20 -4
- package/dist/__golden__/wave-loop/op-point.json +18 -4
- package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
- package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/dist/__golden__/wave-loop/op-spend.json +10 -2
- package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/dist/__golden__/wave-loop/op-wide.json +20 -4
- package/dist/bucket-check/azure.d.ts +108 -0
- package/dist/bucket-check/azure.d.ts.map +1 -0
- package/dist/bucket-check/azure.js +258 -0
- package/dist/bucket-check/fixtures/azure.json +153 -0
- package/dist/bucket-check/fixtures/gcs.json +148 -0
- package/dist/bucket-check/fixtures/s3.json +277 -0
- package/dist/bucket-check/gcs.d.ts +77 -0
- package/dist/bucket-check/gcs.d.ts.map +1 -0
- package/dist/bucket-check/gcs.js +202 -0
- package/dist/bucket-check/index.d.ts +48 -0
- package/dist/bucket-check/index.d.ts.map +1 -0
- package/dist/bucket-check/index.js +44 -0
- package/dist/bucket-check/s3.d.ts +116 -0
- package/dist/bucket-check/s3.d.ts.map +1 -0
- package/dist/bucket-check/s3.js +362 -0
- package/dist/bucket-check/types.d.ts +66 -0
- package/dist/bucket-check/types.d.ts.map +1 -0
- package/dist/bucket-check/types.js +31 -0
- package/dist/bucket-check/wire.d.ts +27 -0
- package/dist/bucket-check/wire.d.ts.map +1 -0
- package/dist/bucket-check/wire.js +32 -0
- package/dist/bucket-check.d.ts +6 -0
- package/dist/bucket-check.d.ts.map +1 -0
- package/dist/bucket-check.js +5 -0
- package/dist/capabilities/templates.d.ts.map +1 -1
- package/dist/capabilities/templates.js +1 -2
- package/dist/change-set.d.ts.map +1 -1
- package/dist/change-set.js +2 -3
- package/dist/ci-agent.d.ts +381 -0
- package/dist/ci-agent.d.ts.map +1 -0
- package/dist/ci-agent.js +832 -0
- package/dist/ci-audit/attribution.d.ts +111 -0
- package/dist/ci-audit/attribution.d.ts.map +1 -0
- package/dist/ci-audit/attribution.js +194 -0
- package/dist/ci-audit/audit-log.d.ts +144 -0
- package/dist/ci-audit/audit-log.d.ts.map +1 -0
- package/dist/ci-audit/audit-log.js +149 -0
- package/dist/ci-audit/index.d.ts +12 -0
- package/dist/ci-audit/index.d.ts.map +1 -0
- package/dist/ci-audit/index.js +12 -0
- package/dist/ci-audit/unrecorded.d.ts +74 -0
- package/dist/ci-audit/unrecorded.d.ts.map +1 -0
- package/dist/ci-audit/unrecorded.js +95 -0
- package/dist/ci-audit.d.ts +3 -0
- package/dist/ci-audit.d.ts.map +1 -0
- package/dist/ci-audit.js +2 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +41 -0
- package/dist/ci-estate/delivery.d.ts +137 -0
- package/dist/ci-estate/delivery.d.ts.map +1 -0
- package/dist/ci-estate/delivery.js +311 -0
- package/dist/ci-estate/overdue.d.ts +34 -0
- package/dist/ci-estate/overdue.d.ts.map +1 -0
- package/dist/ci-estate/overdue.js +58 -0
- package/dist/ci-estate/page.d.ts +134 -0
- package/dist/ci-estate/page.d.ts.map +1 -0
- package/dist/ci-estate/page.js +233 -0
- package/dist/ci-estate/rows.d.ts +118 -0
- package/dist/ci-estate/rows.d.ts.map +1 -0
- package/dist/ci-estate/rows.js +126 -0
- package/dist/ci-estate.d.ts +92 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +82 -0
- package/dist/ci-handover.d.ts +29 -5
- package/dist/ci-handover.d.ts.map +1 -1
- package/dist/ci-handover.js +50 -16
- package/dist/ci-identity.d.ts +82 -7
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +86 -15
- package/dist/ci-job-guard.d.ts +139 -0
- package/dist/ci-job-guard.d.ts.map +1 -0
- package/dist/ci-job-guard.js +287 -0
- package/dist/ci-jobs.d.ts +7 -0
- package/dist/ci-jobs.d.ts.map +1 -1
- package/dist/ci-jobs.js +7 -0
- package/dist/ci-product-words.d.ts +296 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +407 -0
- package/dist/ci-product.d.ts +117 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +113 -0
- package/dist/ci-respond-run.d.ts +73 -0
- package/dist/ci-respond-run.d.ts.map +1 -0
- package/dist/ci-respond-run.js +247 -0
- package/dist/ci-respond.d.ts +189 -0
- package/dist/ci-respond.d.ts.map +1 -0
- package/dist/ci-respond.js +285 -0
- package/dist/cli/commands/audit.d.ts +2 -2
- package/dist/cli/commands/audit.d.ts.map +1 -1
- package/dist/cli/commands/audit.js +3 -2
- package/dist/cli/commands/carve.js +2 -2
- package/dist/cli/commands/init.d.ts +2 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +1 -1
- package/dist/cli/handlers/agent.d.ts +17 -0
- package/dist/cli/handlers/agent.d.ts.map +1 -0
- package/dist/cli/handlers/agent.js +114 -0
- package/dist/cli/handlers/approve-confirm.d.ts +84 -0
- package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
- package/dist/cli/handlers/approve-confirm.js +142 -0
- package/dist/cli/handlers/approve.d.ts.map +1 -1
- package/dist/cli/handlers/approve.js +19 -1
- package/dist/cli/handlers/audit-log.d.ts +12 -0
- package/dist/cli/handlers/audit-log.d.ts.map +1 -0
- package/dist/cli/handlers/audit-log.js +81 -0
- package/dist/cli/handlers/build.d.ts +7 -0
- package/dist/cli/handlers/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +124 -1
- package/dist/cli/handlers/ci-check-job.d.ts +11 -0
- package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check-job.js +27 -0
- package/dist/cli/handlers/ci-check.d.ts +3 -0
- package/dist/cli/handlers/ci-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check.js +63 -0
- package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
- package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-forge-check.js +89 -0
- package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
- package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
- package/dist/cli/handlers/e2e-safe-run.js +23 -0
- package/dist/cli/handlers/fan-out.js +4 -0
- package/dist/cli/handlers/gate-pending.d.ts +11 -0
- package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
- package/dist/cli/handlers/gate-pending.js +44 -0
- package/dist/cli/handlers/init.d.ts.map +1 -1
- package/dist/cli/handlers/init.js +1 -0
- package/dist/cli/handlers/ledger.js +1 -1
- package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
- package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
- package/dist/cli/handlers/lifecycle-drift.js +7 -2
- package/dist/cli/handlers/lock.d.ts.map +1 -1
- package/dist/cli/handlers/lock.js +64 -5
- package/dist/cli/handlers/notify-relay.d.ts +15 -0
- package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
- package/dist/cli/handlers/notify-relay.js +130 -0
- package/dist/cli/handlers/pr-env.d.ts.map +1 -1
- package/dist/cli/handlers/pr-env.js +42 -11
- package/dist/cli/handlers/pr.d.ts +43 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +908 -205
- package/dist/cli/handlers/promote.d.ts.map +1 -1
- package/dist/cli/handlers/promote.js +21 -2
- package/dist/cli/handlers/release.d.ts.map +1 -1
- package/dist/cli/handlers/release.js +3 -0
- package/dist/cli/handlers/run-wave.d.ts +8 -0
- package/dist/cli/handlers/run-wave.d.ts.map +1 -1
- package/dist/cli/handlers/run-wave.js +160 -2
- package/dist/cli/handlers/run.d.ts +6 -1
- package/dist/cli/handlers/run.d.ts.map +1 -1
- package/dist/cli/handlers/run.js +86 -1
- package/dist/cli/handlers/serve.d.ts.map +1 -1
- package/dist/cli/handlers/serve.js +10 -1
- package/dist/cli/main.d.ts +11 -1
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +178 -13
- package/dist/cli/mcp/ledger-tools.d.ts +36 -0
- package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
- package/dist/cli/mcp/ledger-tools.js +122 -0
- package/dist/cli/mcp/product-tools.d.ts +78 -0
- package/dist/cli/mcp/product-tools.d.ts.map +1 -0
- package/dist/cli/mcp/product-tools.js +93 -0
- package/dist/cli/mcp/read-only.d.ts +34 -0
- package/dist/cli/mcp/read-only.d.ts.map +1 -0
- package/dist/cli/mcp/read-only.js +61 -0
- package/dist/cli/mcp/report-tools.d.ts +48 -0
- package/dist/cli/mcp/report-tools.d.ts.map +1 -0
- package/dist/cli/mcp/report-tools.js +128 -0
- package/dist/cli/mcp/server.d.ts +28 -1
- package/dist/cli/mcp/server.d.ts.map +1 -1
- package/dist/cli/mcp/server.js +86 -15
- package/dist/cli/mcp-config.d.ts +9 -2
- package/dist/cli/mcp-config.d.ts.map +1 -1
- package/dist/cli/mcp-config.js +8 -3
- package/dist/cli/parse-args.d.ts.map +1 -1
- package/dist/cli/parse-args.js +164 -3
- package/dist/cli/registry.d.ts +73 -0
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.d.ts +42 -7
- package/dist/cloud-lister/sigv4.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.js +72 -22
- package/dist/components/adoption.d.ts +69 -0
- package/dist/components/adoption.d.ts.map +1 -0
- package/dist/components/adoption.js +92 -0
- package/dist/components/apply-lease.d.ts +19 -0
- package/dist/components/apply-lease.d.ts.map +1 -0
- package/dist/components/apply-lease.js +41 -0
- package/dist/components/capability.d.ts +159 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +39 -6
- package/dist/components/check-hooks.d.ts +116 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -0
- package/dist/components/check-steps.d.ts +74 -0
- package/dist/components/check-steps.d.ts.map +1 -0
- package/dist/components/check-steps.js +102 -0
- package/dist/components/ci-services.d.ts +57 -0
- package/dist/components/ci-services.d.ts.map +1 -0
- package/dist/components/ci-services.js +60 -0
- package/dist/components/cli-support.d.ts +13 -0
- package/dist/components/cli-support.d.ts.map +1 -1
- package/dist/components/cli-support.js +10 -2
- package/dist/components/driver.d.ts +32 -3
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +59 -5
- package/dist/components/fan-out-run.d.ts +12 -0
- package/dist/components/fan-out-run.d.ts.map +1 -1
- package/dist/components/fan-out-run.js +56 -16
- package/dist/components/groups.d.ts.map +1 -1
- package/dist/components/groups.js +23 -5
- package/dist/components/pr-env-ledger.d.ts +32 -0
- package/dist/components/pr-env-ledger.d.ts.map +1 -0
- package/dist/components/pr-env-ledger.js +38 -0
- package/dist/components/pr-env-ports.d.ts +12 -0
- package/dist/components/pr-env-ports.d.ts.map +1 -1
- package/dist/components/pr-env-ports.js +13 -3
- package/dist/components/pr-env-run.d.ts +6 -0
- package/dist/components/pr-env-run.d.ts.map +1 -1
- package/dist/components/pr-env-run.js +3 -2
- package/dist/components/pr-environment.d.ts +32 -4
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +26 -8
- package/dist/components/pr-pipeline.d.ts +297 -5
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +329 -18
- package/dist/components/pr-policy.d.ts +26 -2
- package/dist/components/pr-policy.d.ts.map +1 -1
- package/dist/components/pr-policy.js +41 -7
- package/dist/components/pr-run.d.ts +71 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +91 -7
- package/dist/components/pr-targets.d.ts +24 -0
- package/dist/components/pr-targets.d.ts.map +1 -0
- package/dist/components/pr-targets.js +48 -0
- package/dist/components/product-pipeline.d.ts +250 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +212 -0
- package/dist/components/promote.d.ts +6 -0
- package/dist/components/promote.d.ts.map +1 -1
- package/dist/components/promote.js +4 -1
- package/dist/components/release-compile.d.ts +22 -1
- package/dist/components/release-compile.d.ts.map +1 -1
- package/dist/components/release-compile.js +85 -0
- package/dist/components/release-promote.d.ts +15 -1
- package/dist/components/release-promote.d.ts.map +1 -1
- package/dist/components/release-promote.js +67 -2
- package/dist/components/repo-lock.d.ts +27 -0
- package/dist/components/repo-lock.d.ts.map +1 -0
- package/dist/components/repo-lock.js +49 -0
- package/dist/components/row-lease.d.ts +84 -0
- package/dist/components/row-lease.d.ts.map +1 -0
- package/dist/components/row-lease.js +110 -0
- package/dist/components/wave-plan.d.ts +42 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +72 -4
- package/dist/control/applied.d.ts +89 -0
- package/dist/control/applied.d.ts.map +1 -0
- package/dist/control/applied.js +175 -0
- package/dist/control/consumers.d.ts +78 -0
- package/dist/control/consumers.d.ts.map +1 -0
- package/dist/control/consumers.js +172 -0
- package/dist/control/dispatch.d.ts +334 -0
- package/dist/control/dispatch.d.ts.map +1 -0
- package/dist/control/dispatch.js +519 -0
- package/dist/control/edges.d.ts +75 -0
- package/dist/control/edges.d.ts.map +1 -0
- package/dist/control/edges.js +133 -0
- package/dist/control/reconcile.d.ts +120 -0
- package/dist/control/reconcile.d.ts.map +1 -0
- package/dist/control/reconcile.js +178 -0
- package/dist/control/records.d.ts +187 -0
- package/dist/control/records.d.ts.map +1 -0
- package/dist/control/records.js +307 -0
- package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
- package/dist/discovery/sandbox/bundle.js +25 -1
- package/dist/e2e-harness/bucket.d.ts +21 -0
- package/dist/e2e-harness/bucket.d.ts.map +1 -0
- package/dist/e2e-harness/bucket.js +61 -0
- package/dist/e2e-harness/claim.d.ts +70 -0
- package/dist/e2e-harness/claim.d.ts.map +1 -0
- package/dist/e2e-harness/claim.js +98 -0
- package/dist/e2e-harness/driver.d.ts +64 -0
- package/dist/e2e-harness/driver.d.ts.map +1 -0
- package/dist/e2e-harness/driver.js +243 -0
- package/dist/e2e-harness/forgejo.d.ts +77 -0
- package/dist/e2e-harness/forgejo.d.ts.map +1 -0
- package/dist/e2e-harness/forgejo.js +205 -0
- package/dist/e2e-harness/git.d.ts +32 -0
- package/dist/e2e-harness/git.d.ts.map +1 -0
- package/dist/e2e-harness/git.js +67 -0
- package/dist/e2e-harness/index.d.ts +22 -0
- package/dist/e2e-harness/index.d.ts.map +1 -0
- package/dist/e2e-harness/index.js +48 -0
- package/dist/e2e-harness/jobs.d.ts +8 -0
- package/dist/e2e-harness/jobs.d.ts.map +1 -0
- package/dist/e2e-harness/jobs.js +34 -0
- package/dist/e2e-harness/pins.d.ts +45 -0
- package/dist/e2e-harness/pins.d.ts.map +1 -0
- package/dist/e2e-harness/pins.js +44 -0
- package/dist/e2e-harness/ports.d.ts +113 -0
- package/dist/e2e-harness/ports.d.ts.map +1 -0
- package/dist/e2e-harness/ports.js +4 -0
- package/dist/e2e-harness/reports.d.ts +45 -0
- package/dist/e2e-harness/reports.d.ts.map +1 -0
- package/dist/e2e-harness/reports.js +57 -0
- package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
- package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run-cli.js +43 -0
- package/dist/e2e-harness/safe-run.d.ts +61 -0
- package/dist/e2e-harness/safe-run.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run.js +172 -0
- package/dist/e2e-harness/scenario.d.ts +11 -0
- package/dist/e2e-harness/scenario.d.ts.map +1 -0
- package/dist/e2e-harness/scenario.js +89 -0
- package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/dist/e2e-harness/schemas/index.d.ts +191 -0
- package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
- package/dist/e2e-harness/schemas/index.js +62 -0
- package/dist/e2e-harness/stack.d.ts +124 -0
- package/dist/e2e-harness/stack.d.ts.map +1 -0
- package/dist/e2e-harness/stack.js +207 -0
- package/dist/e2e-harness/steps.d.ts +11 -0
- package/dist/e2e-harness/steps.d.ts.map +1 -0
- package/dist/e2e-harness/steps.js +22 -0
- package/dist/e2e-harness.d.ts +3 -0
- package/dist/e2e-harness.d.ts.map +1 -0
- package/dist/e2e-harness.js +2 -0
- package/dist/engine-facts.d.ts.map +1 -1
- package/dist/engine-facts.js +1 -2
- package/dist/exit-codes.d.ts +54 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +55 -0
- package/dist/forge-check/check.d.ts +63 -0
- package/dist/forge-check/check.d.ts.map +1 -0
- package/dist/forge-check/check.js +139 -0
- package/dist/forge-check/contract.d.ts +152 -0
- package/dist/forge-check/contract.d.ts.map +1 -0
- package/dist/forge-check/contract.js +118 -0
- package/dist/forge-check/forge.d.ts +42 -0
- package/dist/forge-check/forge.d.ts.map +1 -0
- package/dist/forge-check/forge.js +338 -0
- package/dist/forge-check/index.d.ts +24 -0
- package/dist/forge-check/index.d.ts.map +1 -0
- package/dist/forge-check/index.js +23 -0
- package/dist/forge-check/pulumi.d.ts +44 -0
- package/dist/forge-check/pulumi.d.ts.map +1 -0
- package/dist/forge-check/pulumi.js +184 -0
- package/dist/forge-check/read-only.d.ts +26 -0
- package/dist/forge-check/read-only.d.ts.map +1 -0
- package/dist/forge-check/read-only.js +53 -0
- package/dist/forge-check/trust.d.ts +94 -0
- package/dist/forge-check/trust.d.ts.map +1 -0
- package/dist/forge-check/trust.js +532 -0
- package/dist/forge-check/types.d.ts +80 -0
- package/dist/forge-check/types.d.ts.map +1 -0
- package/dist/forge-check/types.js +18 -0
- package/dist/forge-check.d.ts +6 -0
- package/dist/forge-check.d.ts.map +1 -0
- package/dist/forge-check.js +5 -0
- package/dist/gate-decision.d.ts +1 -0
- package/dist/gate-decision.d.ts.map +1 -1
- package/dist/gate-decision.js +2 -0
- package/dist/gate-policy.d.ts +47 -1
- package/dist/gate-policy.d.ts.map +1 -1
- package/dist/gate-policy.js +50 -2
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/lexicon.d.ts +152 -6
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.d.ts +24 -0
- package/dist/lifecycle/adoption-file.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.js +1 -2
- package/dist/lifecycle/cloud-index.d.ts.map +1 -1
- package/dist/lifecycle/cloud-index.js +1 -2
- package/dist/lifecycle/gate-applied.d.ts +6 -0
- package/dist/lifecycle/gate-applied.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.d.ts +29 -0
- package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.js +10 -1
- package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
- package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
- package/dist/lifecycle/gate-pending-by-plan.js +96 -0
- package/dist/lifecycle/gated-request-digest.d.ts +28 -0
- package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
- package/dist/lifecycle/gated-request-digest.js +35 -0
- package/dist/lifecycle/gated-request.d.ts +126 -0
- package/dist/lifecycle/gated-request.d.ts.map +1 -0
- package/dist/lifecycle/gated-request.js +204 -0
- package/dist/lifecycle/identity-match.d.ts +15 -0
- package/dist/lifecycle/identity-match.d.ts.map +1 -1
- package/dist/lifecycle/identity-match.js +11 -6
- package/dist/lifecycle/index-diff.d.ts +40 -0
- package/dist/lifecycle/index-diff.d.ts.map +1 -1
- package/dist/lifecycle/index-diff.js +1 -2
- package/dist/lifecycle/index-document.d.ts.map +1 -1
- package/dist/lifecycle/index-document.js +1 -2
- package/dist/lifecycle/index-import.d.ts +4 -1
- package/dist/lifecycle/index-import.d.ts.map +1 -1
- package/dist/lifecycle/index-import.js +29 -32
- package/dist/lifecycle/ledger-read.d.ts.map +1 -1
- package/dist/lifecycle/ledger-read.js +7 -3
- package/dist/lifecycle/lock-rows.d.ts +76 -0
- package/dist/lifecycle/lock-rows.d.ts.map +1 -0
- package/dist/lifecycle/lock-rows.js +140 -0
- package/dist/lifecycle/query.d.ts +50 -3
- package/dist/lifecycle/query.d.ts.map +1 -1
- package/dist/lifecycle/query.js +97 -7
- package/dist/lifecycle/release-catalog-site.d.ts +66 -0
- package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog-site.js +232 -0
- package/dist/lifecycle/release-catalog.d.ts +201 -0
- package/dist/lifecycle/release-catalog.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog.js +198 -0
- package/dist/lifecycle/release-changelog.d.ts +41 -0
- package/dist/lifecycle/release-changelog.d.ts.map +1 -0
- package/dist/lifecycle/release-changelog.js +38 -0
- package/dist/lifecycle/release-cut.d.ts +1 -0
- package/dist/lifecycle/release-cut.d.ts.map +1 -1
- package/dist/lifecycle/release-cut.js +1 -1
- package/dist/lifecycle/release-ledger.d.ts +16 -0
- package/dist/lifecycle/release-ledger.d.ts.map +1 -1
- package/dist/lifecycle/release-ledger.js +9 -0
- package/dist/lifecycle/release-publish.d.ts +43 -22
- package/dist/lifecycle/release-publish.d.ts.map +1 -1
- package/dist/lifecycle/release-read.d.ts.map +1 -1
- package/dist/lifecycle/release-read.js +3 -0
- package/dist/lifecycle/release-status.d.ts +106 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +115 -0
- package/dist/lifecycle/resource-lock.d.ts +120 -0
- package/dist/lifecycle/resource-lock.d.ts.map +1 -0
- package/dist/lifecycle/resource-lock.js +317 -0
- package/dist/lifecycle/retention.d.ts.map +1 -1
- package/dist/lifecycle/retention.js +3 -0
- package/dist/lifecycle/run-ledger.d.ts.map +1 -1
- package/dist/lifecycle/run-ledger.js +9 -1
- package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
- package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store-s3.js +9 -44
- package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store.js +1 -2
- package/dist/lifecycle/target-lock.d.ts +15 -0
- package/dist/lifecycle/target-lock.d.ts.map +1 -1
- package/dist/lifecycle/target-lock.js +25 -10
- package/dist/lifecycle/wave-plans.d.ts +23 -7
- package/dist/lifecycle/wave-plans.d.ts.map +1 -1
- package/dist/lifecycle/wave-plans.js +9 -2
- package/dist/mcp/types.d.ts +7 -0
- package/dist/mcp/types.d.ts.map +1 -1
- package/dist/notify-product.d.ts +43 -0
- package/dist/notify-product.d.ts.map +1 -0
- package/dist/notify-product.js +58 -0
- package/dist/notify-relay.d.ts +197 -0
- package/dist/notify-relay.d.ts.map +1 -0
- package/dist/notify-relay.js +321 -0
- package/dist/notify.d.ts +44 -4
- package/dist/notify.d.ts.map +1 -1
- package/dist/notify.js +77 -14
- package/dist/object-store/azure-blob.d.ts +129 -0
- package/dist/object-store/azure-blob.d.ts.map +1 -0
- package/dist/object-store/azure-blob.js +341 -0
- package/dist/object-store/common.d.ts +108 -0
- package/dist/object-store/common.d.ts.map +1 -0
- package/dist/object-store/common.js +80 -0
- package/dist/object-store/errors.d.ts +28 -0
- package/dist/object-store/errors.d.ts.map +1 -0
- package/dist/object-store/errors.js +21 -0
- package/dist/object-store/from-env.d.ts +18 -0
- package/dist/object-store/from-env.d.ts.map +1 -0
- package/dist/object-store/from-env.js +22 -0
- package/dist/object-store/gcs.d.ts +106 -0
- package/dist/object-store/gcs.d.ts.map +1 -0
- package/dist/object-store/gcs.js +393 -0
- package/dist/object-store/index.d.ts +9 -0
- package/dist/object-store/index.d.ts.map +1 -0
- package/dist/object-store/index.js +8 -0
- package/dist/object-store/s3.d.ts +146 -0
- package/dist/object-store/s3.d.ts.map +1 -0
- package/dist/object-store/s3.js +306 -0
- package/dist/op/activities/converge.d.ts.map +1 -1
- package/dist/op/activities/converge.js +2 -1
- package/dist/op/activities/index.d.ts +1 -1
- package/dist/op/activities/index.d.ts.map +1 -1
- package/dist/op/activities/index.js +1 -1
- package/dist/op/activities/review-agent.d.ts +55 -2
- package/dist/op/activities/review-agent.d.ts.map +1 -1
- package/dist/op/activities/review-agent.js +65 -5
- package/dist/op/approval-status.d.ts +103 -0
- package/dist/op/approval-status.d.ts.map +1 -0
- package/dist/op/approval-status.js +197 -0
- package/dist/op/gate.d.ts +29 -1
- package/dist/op/gate.d.ts.map +1 -1
- package/dist/op/gate.js +59 -23
- package/dist/op/generate-pipeline.d.ts.map +1 -1
- package/dist/op/generate-pipeline.js +7 -1
- package/dist/op/index.d.ts +12 -1
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +7 -1
- package/dist/op/op-waves-after-plan.d.ts +137 -0
- package/dist/op/op-waves-after-plan.d.ts.map +1 -0
- package/dist/op/op-waves-after-plan.js +163 -0
- package/dist/op/op-waves-capability-spec.d.ts +63 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +115 -0
- package/dist/op/op-waves-capability.d.ts +197 -0
- package/dist/op/op-waves-capability.d.ts.map +1 -0
- package/dist/op/op-waves-capability.js +311 -0
- package/dist/op/op-waves-events.d.ts +54 -0
- package/dist/op/op-waves-events.d.ts.map +1 -0
- package/dist/op/op-waves-events.js +122 -0
- package/dist/op/op-waves-notify.d.ts +7 -1
- package/dist/op/op-waves-notify.d.ts.map +1 -1
- package/dist/op/op-waves-notify.js +35 -16
- package/dist/op/op-waves-release-port.d.ts +18 -0
- package/dist/op/op-waves-release-port.d.ts.map +1 -0
- package/dist/op/op-waves-release-port.js +61 -0
- package/dist/op/op-waves-release.d.ts +92 -0
- package/dist/op/op-waves-release.d.ts.map +1 -0
- package/dist/op/op-waves-release.js +96 -0
- package/dist/op/op-waves-run.d.ts +182 -6
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +1076 -44
- package/dist/op/op-waves-stand-down.d.ts +60 -0
- package/dist/op/op-waves-stand-down.d.ts.map +1 -0
- package/dist/op/op-waves-stand-down.js +96 -0
- package/dist/op/op-waves.d.ts +187 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +203 -19
- package/dist/op/runtime.d.ts +95 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +18 -0
- package/dist/op/stage-hooks.d.ts +45 -7
- package/dist/op/stage-hooks.d.ts.map +1 -1
- package/dist/op/stage-hooks.js +61 -3
- package/dist/op/steward-beside.d.ts.map +1 -1
- package/dist/op/steward-beside.js +2 -1
- package/dist/op/types.d.ts +2 -2
- package/dist/op/types.d.ts.map +1 -1
- package/dist/op/types.js +3 -2
- package/dist/otlp-metrics.d.ts +38 -0
- package/dist/otlp-metrics.d.ts.map +1 -0
- package/dist/otlp-metrics.js +82 -0
- package/dist/otlp.d.ts +249 -0
- package/dist/otlp.d.ts.map +1 -0
- package/dist/otlp.js +425 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -0
- package/dist/parallelism.d.ts +17 -0
- package/dist/parallelism.d.ts.map +1 -0
- package/dist/parallelism.js +33 -0
- package/dist/policy-packs.d.ts +69 -0
- package/dist/policy-packs.d.ts.map +1 -0
- package/dist/policy-packs.js +205 -0
- package/dist/policy-source.d.ts +51 -0
- package/dist/policy-source.d.ts.map +1 -0
- package/dist/policy-source.js +102 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +146 -37
- package/dist/pr-loop.d.ts +158 -11
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +302 -44
- package/dist/pr-merge.d.ts +64 -0
- package/dist/pr-merge.d.ts.map +1 -0
- package/dist/pr-merge.js +78 -0
- package/dist/pr-post.d.ts +86 -1
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +141 -5
- package/dist/pr-report-url.d.ts +32 -4
- package/dist/pr-report-url.d.ts.map +1 -1
- package/dist/pr-report-url.js +45 -5
- package/dist/pr-requires.d.ts +13 -2
- package/dist/pr-requires.d.ts.map +1 -1
- package/dist/pr-requires.js +14 -0
- package/dist/release-floors.d.ts +1 -1
- package/dist/release-floors.js +1 -1
- package/dist/run-event.d.ts +26 -1
- package/dist/run-event.d.ts.map +1 -1
- package/dist/run-event.js +3 -1
- package/dist/scheduled-op-cloud.d.ts +32 -0
- package/dist/scheduled-op-cloud.d.ts.map +1 -0
- package/dist/scheduled-op-cloud.js +69 -0
- package/dist/sorted-json.d.ts +10 -0
- package/dist/sorted-json.d.ts.map +1 -0
- package/dist/sorted-json.js +14 -0
- package/dist/terraform/credentials.d.ts +59 -0
- package/dist/terraform/credentials.d.ts.map +1 -0
- package/dist/terraform/credentials.js +149 -0
- package/dist/utils.d.ts +1 -4
- package/dist/utils.d.ts.map +1 -1
- package/dist/utils.js +1 -9
- package/dist/wave-runtime.d.ts +1 -1
- package/dist/wave-runtime.js +2 -2
- package/dist/wave-runtime.mjs +405 -287
- package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
- package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
- package/dist/workspace/ci-lock-grain.d.ts +17 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +21 -0
- package/dist/workspace/ci-run.d.ts +2 -1
- package/dist/workspace/ci-run.d.ts.map +1 -1
- package/dist/workspace/ci-run.js +10 -3
- package/dist/workspace/declaration.d.ts +16 -4
- package/dist/workspace/declaration.d.ts.map +1 -1
- package/dist/workspace/declaration.js +5 -2
- package/dist/workspace/declaration.schema.json +27 -3
- package/dist/workspace/drift-cli.d.ts.map +1 -1
- package/dist/workspace/drift-cli.js +8 -3
- package/dist/workspace/exit-cli.d.ts +1 -1
- package/dist/workspace/exit-cli.d.ts.map +1 -1
- package/dist/workspace/exit-cli.js +2 -1
- package/dist/workspace/import-fetch.d.ts +4 -2
- package/dist/workspace/import-fetch.d.ts.map +1 -1
- package/dist/workspace/import-fetch.js +4 -2
- package/dist/workspace/import-init.d.ts.map +1 -1
- package/dist/workspace/import-init.js +4 -2
- package/dist/workspace/ledger.schema.json +7 -3
- package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
- package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
- package/dist/workspace/lineage-upgrade-cli.js +2 -1
- package/dist/workspace/pr-report.schema.json +79 -3
- package/dist/workspace/promote.d.ts +1 -1
- package/dist/workspace/promote.d.ts.map +1 -1
- package/dist/workspace/promote.js +2 -1
- package/dist/workspace/records-cli.d.ts +2 -2
- package/dist/workspace/records-cli.d.ts.map +1 -1
- package/dist/workspace/records-cli.js +3 -2
- package/dist/workspace/release-catalog.schema.json +277 -0
- package/dist/workspace/run-event.schema.json +18 -1
- package/dist/workspace/work-cli.d.ts +3 -1
- package/dist/workspace/work-cli.d.ts.map +1 -1
- package/dist/workspace/work-cli.js +7 -2
- package/dist/workspace/workspace-run.d.ts.map +1 -1
- package/dist/workspace/workspace-run.js +2 -1
- package/package.json +21 -1
- package/src/__fixtures__/estate-ledger.ts +101 -0
- package/src/__fixtures__/oidc-emulator.ts +31 -2
- package/src/__fixtures__/product-words.ts +44 -0
- package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/src/__golden__/wave-loop/op-held-on.json +28 -7
- package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/src/__golden__/wave-loop/op-overridden.json +28 -7
- package/src/__golden__/wave-loop/op-per-run.json +20 -4
- package/src/__golden__/wave-loop/op-point.json +18 -4
- package/src/__golden__/wave-loop/op-pr-review.json +10 -2
- package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/src/__golden__/wave-loop/op-spend.json +10 -2
- package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/src/__golden__/wave-loop/op-wide.json +20 -4
- package/src/bucket-check/azure.ts +307 -0
- package/src/bucket-check/bucket-check.test.ts +210 -0
- package/src/bucket-check/fixtures/azure.json +153 -0
- package/src/bucket-check/fixtures/gcs.json +148 -0
- package/src/bucket-check/fixtures/s3.json +277 -0
- package/src/bucket-check/gcs.ts +257 -0
- package/src/bucket-check/index.ts +61 -0
- package/src/bucket-check/s3.ts +433 -0
- package/src/bucket-check/types.ts +75 -0
- package/src/bucket-check/wire.ts +50 -0
- package/src/bucket-check.ts +5 -0
- package/src/capabilities/templates.test.ts +2 -3
- package/src/capabilities/templates.ts +1 -2
- package/src/cdk/advise.test.ts +1 -1
- package/src/change-set-bundle.test.ts +0 -1
- package/src/change-set.ts +2 -3
- package/src/ci-agent.test.ts +348 -0
- package/src/ci-agent.ts +1025 -0
- package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
- package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
- package/src/ci-audit/attribution.ts +260 -0
- package/src/ci-audit/audit-log.ts +220 -0
- package/src/ci-audit/ci-audit.test.ts +175 -0
- package/src/ci-audit/index.ts +15 -0
- package/src/ci-audit/unrecorded.ts +140 -0
- package/src/ci-audit.ts +2 -0
- package/src/ci-control.ts +173 -0
- package/src/ci-estate/delivery.ts +433 -0
- package/src/ci-estate/overdue.ts +81 -0
- package/src/ci-estate/page.ts +343 -0
- package/src/ci-estate/rows.ts +251 -0
- package/src/ci-estate.test.ts +281 -0
- package/src/ci-estate.ts +175 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +54 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +3 -1
- package/src/ci-identity.ts +123 -22
- package/src/ci-job-guard.test.ts +154 -0
- package/src/ci-job-guard.ts +319 -0
- package/src/ci-jobs.ts +8 -0
- package/src/ci-product-comment-targets.test.ts +45 -0
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +565 -0
- package/src/ci-product.ts +226 -0
- package/src/ci-respond-run.ts +291 -0
- package/src/ci-respond.test.ts +264 -0
- package/src/ci-respond.ts +412 -0
- package/src/ci-shared-reads.test.ts +145 -0
- package/src/cli/commands/audit.test.ts +1 -1
- package/src/cli/commands/audit.ts +3 -2
- package/src/cli/commands/carve.test.ts +1 -1
- package/src/cli/commands/carve.ts +2 -2
- package/src/cli/commands/init.ts +3 -1
- package/src/cli/component-wave-args.test.ts +16 -0
- package/src/cli/handlers/agent.ts +126 -0
- package/src/cli/handlers/approve-confirm.test.ts +276 -0
- package/src/cli/handlers/approve-confirm.ts +200 -0
- package/src/cli/handlers/approve.ts +18 -1
- package/src/cli/handlers/audit-log.ts +74 -0
- package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
- package/src/cli/handlers/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +113 -1
- package/src/cli/handlers/ci-check-job.test.ts +114 -0
- package/src/cli/handlers/ci-check-job.ts +33 -0
- package/src/cli/handlers/ci-check.ts +63 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -0
- package/src/cli/handlers/e2e-safe-run.ts +27 -0
- package/src/cli/handlers/fan-out.test.ts +10 -10
- package/src/cli/handlers/fan-out.ts +5 -0
- package/src/cli/handlers/gate-pending.ts +46 -0
- package/src/cli/handlers/init.ts +1 -0
- package/src/cli/handlers/ledger.ts +1 -1
- package/src/cli/handlers/lifecycle-drift.ts +7 -2
- package/src/cli/handlers/lock.test.ts +29 -2
- package/src/cli/handlers/lock.ts +66 -6
- package/src/cli/handlers/notify-relay.ts +130 -0
- package/src/cli/handlers/pr-before-merge.test.ts +2 -1
- package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
- package/src/cli/handlers/pr-env.ts +48 -11
- package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
- package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
- package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
- package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
- package/src/cli/handlers/pr-waves.test.ts +8 -2
- package/src/cli/handlers/pr.test.ts +8 -8
- package/src/cli/handlers/pr.ts +879 -205
- package/src/cli/handlers/promote.test.ts +5 -5
- package/src/cli/handlers/promote.ts +22 -2
- package/src/cli/handlers/release.ts +2 -0
- package/src/cli/handlers/run-components-exit.test.ts +7 -7
- package/src/cli/handlers/run-wave.ts +144 -2
- package/src/cli/handlers/run.test.ts +6 -4
- package/src/cli/handlers/run.ts +86 -1
- package/src/cli/handlers/serve.ts +10 -1
- package/src/cli/main.test.ts +1 -1
- package/src/cli/main.ts +180 -13
- package/src/cli/mcp/ledger-tools.ts +126 -0
- package/src/cli/mcp/product-tools.test.ts +123 -0
- package/src/cli/mcp/product-tools.ts +129 -0
- package/src/cli/mcp/read-only.test.ts +134 -0
- package/src/cli/mcp/read-only.ts +68 -0
- package/src/cli/mcp/report-tools.ts +135 -0
- package/src/cli/mcp/server.test.ts +5 -4
- package/src/cli/mcp/server.ts +90 -16
- package/src/cli/mcp-config.ts +8 -3
- package/src/cli/parse-args.ts +119 -2
- package/src/cli/registry.ts +73 -0
- package/src/cloud-lister/sigv4.ts +80 -23
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +140 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability.ts +180 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +255 -0
- package/src/components/check-steps.test.ts +70 -0
- package/src/components/check-steps.ts +158 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +82 -0
- package/src/components/cli-support.ts +23 -2
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +73 -6
- package/src/components/fan-out-run.ts +68 -18
- package/src/components/groups.ts +21 -4
- package/src/components/plan-flags.test.ts +46 -0
- package/src/components/pr-comment-preview-targets.test.ts +34 -0
- package/src/components/pr-comment-preview.test.ts +54 -0
- package/src/components/pr-env-ledger.test.ts +9 -0
- package/src/components/pr-env-ledger.ts +42 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +2 -14
- package/src/components/pr-env-run.test.ts +19 -0
- package/src/components/pr-env-run.ts +12 -2
- package/src/components/pr-environment.test.ts +29 -0
- package/src/components/pr-environment.ts +40 -8
- package/src/components/pr-pipeline-runners.test.ts +80 -0
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +498 -18
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +1 -1
- package/src/components/pr-run.ts +138 -11
- package/src/components/pr-stale-job.test.ts +34 -0
- package/src/components/pr-targets.test.ts +35 -0
- package/src/components/pr-targets.ts +45 -0
- package/src/components/product-pipeline.test.ts +200 -0
- package/src/components/product-pipeline.ts +383 -0
- package/src/components/promote.ts +10 -1
- package/src/components/release-compile.ts +87 -1
- package/src/components/release-promote.ts +65 -1
- package/src/components/repo-lock.ts +52 -0
- package/src/components/row-lease.test.ts +490 -0
- package/src/components/row-lease.ts +167 -0
- package/src/components/wave-plan-policy.test.ts +19 -0
- package/src/components/wave-plan.ts +96 -6
- package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
- package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
- package/src/control/applied.test.ts +148 -0
- package/src/control/applied.ts +191 -0
- package/src/control/consumers.test.ts +129 -0
- package/src/control/consumers.ts +192 -0
- package/src/control/control.test.ts +302 -0
- package/src/control/dispatch.ts +699 -0
- package/src/control/edges.test.ts +112 -0
- package/src/control/edges.ts +164 -0
- package/src/control/note-checkout.test.ts +91 -0
- package/src/control/reconcile.ts +250 -0
- package/src/control/records.ts +395 -0
- package/src/discovery/sandbox/bundle.ts +25 -1
- package/src/e2e-harness/__project__/chant.config.ts +4 -0
- package/src/e2e-harness/__project__/src/compose.ts +33 -0
- package/src/e2e-harness/bucket.ts +69 -0
- package/src/e2e-harness/claim.test.ts +150 -0
- package/src/e2e-harness/claim.ts +140 -0
- package/src/e2e-harness/driver.test.ts +304 -0
- package/src/e2e-harness/driver.ts +294 -0
- package/src/e2e-harness/forgejo.ts +267 -0
- package/src/e2e-harness/git.ts +96 -0
- package/src/e2e-harness/index.ts +50 -0
- package/src/e2e-harness/jobs.ts +35 -0
- package/src/e2e-harness/pins.ts +52 -0
- package/src/e2e-harness/ports.ts +130 -0
- package/src/e2e-harness/reports.ts +79 -0
- package/src/e2e-harness/safe-run-cli.test.ts +102 -0
- package/src/e2e-harness/safe-run-cli.ts +54 -0
- package/src/e2e-harness/safe-run.ts +198 -0
- package/src/e2e-harness/scenario.ts +89 -0
- package/src/e2e-harness/schemas/README.md +62 -0
- package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/src/e2e-harness/schemas/index.ts +220 -0
- package/src/e2e-harness/schemas.test.ts +145 -0
- package/src/e2e-harness/stack.test.ts +124 -0
- package/src/e2e-harness/stack.ts +306 -0
- package/src/e2e-harness/steps.ts +30 -0
- package/src/e2e-harness.ts +2 -0
- package/src/engine-facts.test.ts +2 -3
- package/src/engine-facts.ts +1 -2
- package/src/exit-codes.test.ts +32 -0
- package/src/exit-codes.ts +61 -0
- package/src/forge-check/check.ts +155 -0
- package/src/forge-check/contract.ts +215 -0
- package/src/forge-check/forge-check.test.ts +427 -0
- package/src/forge-check/forge.ts +318 -0
- package/src/forge-check/index.ts +43 -0
- package/src/forge-check/pulumi.ts +192 -0
- package/src/forge-check/read-only.ts +56 -0
- package/src/forge-check/trust.ts +527 -0
- package/src/forge-check/types.ts +78 -0
- package/src/forge-check.ts +5 -0
- package/src/gate-decision-bundle.test.ts +11 -0
- package/src/gate-decision.ts +3 -0
- package/src/gate-policy.ts +92 -3
- package/src/gated-waves-bundle.test.ts +0 -1
- package/src/index.ts +2 -0
- package/src/lexicon.ts +143 -6
- package/src/lifecycle/adoption-file.ts +1 -2
- package/src/lifecycle/cloud-index.test.ts +2 -3
- package/src/lifecycle/cloud-index.ts +1 -2
- package/src/lifecycle/control-entries-ledger.test.ts +69 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +35 -1
- package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
- package/src/lifecycle/gate-pending-by-plan.ts +133 -0
- package/src/lifecycle/gated-request-digest.ts +49 -0
- package/src/lifecycle/gated-request-ledger.test.ts +53 -0
- package/src/lifecycle/gated-request.ts +279 -0
- package/src/lifecycle/identity-match.ts +25 -6
- package/src/lifecycle/index-diff.ts +1 -2
- package/src/lifecycle/index-document.ts +1 -2
- package/src/lifecycle/index-import.test.ts +14 -0
- package/src/lifecycle/index-import.ts +54 -34
- package/src/lifecycle/ledger-read.ts +7 -3
- package/src/lifecycle/lock-rows.test.ts +109 -0
- package/src/lifecycle/lock-rows.ts +167 -0
- package/src/lifecycle/publish-target-context.test.ts +108 -0
- package/src/lifecycle/query.test.ts +2 -3
- package/src/lifecycle/query.ts +109 -8
- package/src/lifecycle/release-catalog-site.test.ts +142 -0
- package/src/lifecycle/release-catalog-site.ts +291 -0
- package/src/lifecycle/release-catalog.test.ts +192 -0
- package/src/lifecycle/release-catalog.ts +353 -0
- package/src/lifecycle/release-changelog.test.ts +70 -0
- package/src/lifecycle/release-changelog.ts +71 -0
- package/src/lifecycle/release-cut.ts +2 -2
- package/src/lifecycle/release-ledger.ts +19 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +185 -0
- package/src/lifecycle/release-status.ts +175 -0
- package/src/lifecycle/resource-lock.test.ts +175 -0
- package/src/lifecycle/resource-lock.ts +354 -0
- package/src/lifecycle/retention.ts +2 -0
- package/src/lifecycle/run-ledger.ts +7 -1
- package/src/lifecycle/snapshot-store-s3.ts +9 -45
- package/src/lifecycle/snapshot-store.ts +1 -2
- package/src/lifecycle/target-lock.ts +24 -9
- package/src/lifecycle/wave-plans.ts +33 -5
- package/src/mcp/types.ts +7 -0
- package/src/notify-product.ts +76 -0
- package/src/notify-relay.test.ts +213 -0
- package/src/notify-relay.ts +407 -0
- package/src/notify.ts +95 -14
- package/src/object-store/azure-blob.ts +374 -0
- package/src/object-store/common.ts +133 -0
- package/src/object-store/errors.ts +26 -0
- package/src/object-store/from-env.ts +36 -0
- package/src/object-store/gcs.ts +436 -0
- package/src/object-store/index.ts +8 -0
- package/src/object-store/object-store.test.ts +130 -0
- package/src/object-store/s3.ts +350 -0
- package/src/op/activities/converge.ts +2 -1
- package/src/op/activities/index.ts +1 -1
- package/src/op/activities/review-agent.open.test.ts +78 -0
- package/src/op/activities/review-agent.test.ts +13 -0
- package/src/op/activities/review-agent.ts +89 -5
- package/src/op/approval-status.test.ts +134 -0
- package/src/op/approval-status.ts +235 -0
- package/src/op/gate-review.test.ts +2 -1
- package/src/op/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +23 -0
- package/src/op/op-waves-after-plan.test.ts +288 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +133 -0
- package/src/op/op-waves-capability.test.ts +217 -0
- package/src/op/op-waves-capability.ts +370 -0
- package/src/op/op-waves-events.ts +135 -0
- package/src/op/op-waves-notify-words.test.ts +149 -0
- package/src/op/op-waves-notify.ts +41 -16
- package/src/op/op-waves-parallelism.test.ts +89 -0
- package/src/op/op-waves-pull-request.test.ts +219 -0
- package/src/op/op-waves-release-port.ts +64 -0
- package/src/op/op-waves-release.test.ts +209 -0
- package/src/op/op-waves-release.ts +132 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1235 -52
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +107 -0
- package/src/op/op-waves-trace.test.ts +205 -0
- package/src/op/op-waves.test.ts +112 -0
- package/src/op/op-waves.ts +320 -22
- package/src/op/runtime.ts +107 -0
- package/src/op/stage-hooks-hold-record.test.ts +41 -0
- package/src/op/stage-hooks.ts +91 -12
- package/src/op/steward-beside.ts +2 -1
- package/src/op/types.ts +3 -2
- package/src/otlp-metrics.ts +96 -0
- package/src/otlp.test.ts +243 -0
- package/src/otlp.ts +543 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/parallelism.test.ts +38 -0
- package/src/parallelism.ts +33 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +111 -0
- package/src/pr-forge-bundle.test.ts +1 -1
- package/src/pr-forge.ts +175 -33
- package/src/pr-loop-bundle.test.ts +7 -3
- package/src/pr-loop-narrowed.test.ts +63 -0
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.ts +398 -52
- package/src/pr-merge.test.ts +100 -0
- package/src/pr-merge.ts +105 -0
- package/src/pr-post-stale.test.ts +163 -0
- package/src/pr-post.ts +190 -5
- package/src/pr-report-url.ts +61 -6
- package/src/pr-requires.test.ts +37 -1
- package/src/pr-requires.ts +16 -2
- package/src/product-subpaths-plain-node.e2e.test.ts +212 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +28 -1
- package/src/scheduled-op-cloud.ts +68 -0
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +6 -0
- package/src/terraform/credentials.test.ts +77 -0
- package/src/terraform/credentials.ts +162 -0
- package/src/utils.ts +2 -11
- package/src/wave-loop-golden.test.ts +2 -1
- package/src/wave-runtime.ts +2 -2
- package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
- package/src/workspace/ci-lock-grain.test.ts +31 -0
- package/src/workspace/ci-lock-grain.ts +29 -0
- package/src/workspace/ci-report-url.test.ts +1 -1
- package/src/workspace/ci-run.test.ts +1 -1
- package/src/workspace/ci-run.ts +10 -3
- package/src/workspace/declaration.schema.json +27 -3
- package/src/workspace/declaration.test.ts +1 -1
- package/src/workspace/declaration.ts +26 -10
- package/src/workspace/drift-cli.ts +8 -3
- package/src/workspace/exit-cli.ts +2 -1
- package/src/workspace/import-fetch.ts +4 -2
- package/src/workspace/import-init.ts +4 -2
- package/src/workspace/ledger.schema.json +7 -3
- package/src/workspace/lineage-upgrade-cli.ts +2 -1
- package/src/workspace/pr-report.schema.json +79 -3
- package/src/workspace/promote.ts +2 -1
- package/src/workspace/records-cli.ts +3 -2
- package/src/workspace/release-catalog.schema.json +277 -0
- package/src/workspace/run-event.schema.json +18 -1
- package/src/workspace/work-cli.ts +8 -2
- package/src/workspace/workspace-run.ts +2 -1
|
@@ -0,0 +1,288 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* After-plan hooks in the wave job's process (#4614): a product builds its
|
|
3
|
+
* report, policy rows and plan files from chant's per-run plans.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { describe, expect, test } from "vitest";
|
|
7
|
+
import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
|
|
8
|
+
import { join } from "node:path";
|
|
9
|
+
import { tmpdir } from "node:os";
|
|
10
|
+
import type { OpWavesSpec } from "./op-waves";
|
|
11
|
+
import { assertOpWavesSpec } from "./op-waves";
|
|
12
|
+
import { runOpWave, opWavePlanPath, type OpWaveShowAtBase } from "./op-waves-run";
|
|
13
|
+
import { memoryGateLedgerPort } from "./gate";
|
|
14
|
+
import { NEXT_RELEASE } from "../release-floors";
|
|
15
|
+
import { CapabilityRegistry, type Capability } from "../components/capability";
|
|
16
|
+
import type { ChangeSetPart } from "../change-set";
|
|
17
|
+
import type { OpRunRecordInput } from "./runtime";
|
|
18
|
+
import { opWaveStepProblems } from "./op-waves-capability";
|
|
19
|
+
import {
|
|
20
|
+
activeProductWaveHook,
|
|
21
|
+
foldPolicyRows,
|
|
22
|
+
opWaveAfterPlanProblems,
|
|
23
|
+
opWaveAfterPlanResultProblems,
|
|
24
|
+
withProductWaveHook,
|
|
25
|
+
type OpWaveAfterPlanHook,
|
|
26
|
+
type OpWaveAfterPlanRun,
|
|
27
|
+
} from "./op-waves-after-plan";
|
|
28
|
+
import { opWaveArgv } from "./stage-hooks";
|
|
29
|
+
|
|
30
|
+
const digest = (n: string) => `sha256:${n.repeat(64)}`;
|
|
31
|
+
|
|
32
|
+
const part = (member: string): ChangeSetPart => ({
|
|
33
|
+
member: { member, lexicon: "terraform", planner: "chant", status: "planned", planDigest: digest("9"), holes: [] },
|
|
34
|
+
entries: [{ member, address: `aws_s3_bucket.${member}`, type: "aws_s3_bucket", action: "create" } as ChangeSetPart["entries"][number]],
|
|
35
|
+
});
|
|
36
|
+
|
|
37
|
+
/** A capability whose plans name a plan document under `cwd`, as terraform-apply's `show -json` does. */
|
|
38
|
+
function capability(cwd: string, digests: Record<string, string>): { registry: CapabilityRegistry; ran: string[] } {
|
|
39
|
+
const ran: string[] = [];
|
|
40
|
+
const cap: Capability<Record<string, unknown>, unknown> = {
|
|
41
|
+
kind: "fake-apply",
|
|
42
|
+
async plan(_ctx, input) {
|
|
43
|
+
const root = String(input.root);
|
|
44
|
+
writeFileSync(join(cwd, `${root}.tfplan.json`), JSON.stringify({ resource_changes: [{ address: `aws_s3_bucket.${root}` }] }));
|
|
45
|
+
return { member: root, planDigest: digests[root]!, artifact: { planFile: `${root}.tfplan`, planJson: `${root}.tfplan.json` }, changeSet: part(root) };
|
|
46
|
+
},
|
|
47
|
+
async run(_ctx, input) {
|
|
48
|
+
ran.push(String(input.root));
|
|
49
|
+
return { applied: input.root };
|
|
50
|
+
},
|
|
51
|
+
};
|
|
52
|
+
return { registry: new CapabilityRegistry().register(cap), ran };
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
function harness(spec: OpWavesSpec) {
|
|
56
|
+
const cwd = mkdtempSync(join(tmpdir(), "op-waves-after-plan-"));
|
|
57
|
+
const show: OpWaveShowAtBase = () => ({ sha: "b".repeat(40), text: JSON.stringify(spec) });
|
|
58
|
+
return { cwd, show, done: () => rmSync(cwd, { recursive: true, force: true }) };
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
const spec: OpWavesSpec = {
|
|
62
|
+
name: "tf-apply",
|
|
63
|
+
op: "tf-apply",
|
|
64
|
+
step: { kind: "fake-apply", root: "{target}" },
|
|
65
|
+
waves: [{ name: "wave-1", runs: [{ target: "network" }, { target: "app" }, { target: "db" }], gate: "never" }],
|
|
66
|
+
};
|
|
67
|
+
|
|
68
|
+
const digests = { network: digest("1"), app: digest("2"), db: digest("3") };
|
|
69
|
+
|
|
70
|
+
describe("after-plan hooks in the job's process (#4614)", () => {
|
|
71
|
+
test("a hook sees each run's plan once, in order, in a wave split into shares", async () => {
|
|
72
|
+
const shared: OpWavesSpec = { ...spec, waves: [{ ...spec.waves[0]!, shares: 2 }] };
|
|
73
|
+
const h = harness(shared);
|
|
74
|
+
const { registry, ran } = capability(h.cwd, digests);
|
|
75
|
+
const seen: OpWaveAfterPlanRun[] = [];
|
|
76
|
+
const hook: OpWaveAfterPlanHook = { name: "report", run: (r) => void seen.push(r) };
|
|
77
|
+
const result = await runOpWave({ spec: shared, specFile: "waves.json", wave: 1, decide: true, cwd: h.cwd, show: h.show, gates: memoryGateLedgerPort(), capabilities: registry, afterPlan: hook });
|
|
78
|
+
expect(result.exitCode).toBe(0);
|
|
79
|
+
expect(seen.map((r) => r.target)).toEqual(["network", "app", "db"]);
|
|
80
|
+
expect(seen[0]).toMatchObject({
|
|
81
|
+
spec: "tf-apply",
|
|
82
|
+
wave: 1,
|
|
83
|
+
waveName: "wave-1",
|
|
84
|
+
job: "decide",
|
|
85
|
+
planDigest: digest("1"),
|
|
86
|
+
plan: opWavePlanPath(shared, 1, "network"),
|
|
87
|
+
planJson: join(h.cwd, "network.tfplan.json"),
|
|
88
|
+
artifact: { planFile: "network.tfplan" },
|
|
89
|
+
changeSet: { member: { member: "network" } },
|
|
90
|
+
empty: false,
|
|
91
|
+
destructive: false,
|
|
92
|
+
policy: [],
|
|
93
|
+
});
|
|
94
|
+
expect(result.hooks.filter((o) => o.moment === "after-plan").map((o) => [o.name, o.target, o.outcome])).toEqual([
|
|
95
|
+
["report", "network", "passed"],
|
|
96
|
+
["report", "app", "passed"],
|
|
97
|
+
["report", "db", "passed"],
|
|
98
|
+
]);
|
|
99
|
+
// The deciding job applies nothing; its shares do.
|
|
100
|
+
expect(ran).toEqual([]);
|
|
101
|
+
h.done();
|
|
102
|
+
});
|
|
103
|
+
|
|
104
|
+
test("a hook that fails under onFailure fail stops the wave before the approval", async () => {
|
|
105
|
+
const gated: OpWavesSpec = { ...spec, waves: [{ ...spec.waves[0]!, gate: "always" }] };
|
|
106
|
+
const h = harness(gated);
|
|
107
|
+
const { registry, ran } = capability(h.cwd, digests);
|
|
108
|
+
const seen: string[] = [];
|
|
109
|
+
const gates = memoryGateLedgerPort();
|
|
110
|
+
const result = await runOpWave({
|
|
111
|
+
spec: gated,
|
|
112
|
+
specFile: "waves.json",
|
|
113
|
+
wave: 1,
|
|
114
|
+
cwd: h.cwd,
|
|
115
|
+
show: h.show,
|
|
116
|
+
gates,
|
|
117
|
+
capabilities: registry,
|
|
118
|
+
log: () => {},
|
|
119
|
+
afterPlan: {
|
|
120
|
+
name: "report",
|
|
121
|
+
run: (r) => {
|
|
122
|
+
seen.push(r.target);
|
|
123
|
+
if (r.target === "app") throw new Error("the plan view cannot be written");
|
|
124
|
+
},
|
|
125
|
+
},
|
|
126
|
+
});
|
|
127
|
+
expect(result.exitCode).toBe(1);
|
|
128
|
+
expect(seen).toEqual(["network", "app"]);
|
|
129
|
+
expect(result.hooks.filter((o) => o.moment === "after-plan").map((o) => [o.target, o.outcome])).toEqual([["network", "passed"], ["app", "failed"]]);
|
|
130
|
+
// No pending fact was recorded and nothing applied: the gate was never asked.
|
|
131
|
+
expect(result.decision).toBeUndefined();
|
|
132
|
+
expect(ran).toEqual([]);
|
|
133
|
+
h.done();
|
|
134
|
+
});
|
|
135
|
+
|
|
136
|
+
test("a hook that fails under onFailure approve holds the wave for an approval", async () => {
|
|
137
|
+
const h = harness(spec);
|
|
138
|
+
const { registry, ran } = capability(h.cwd, digests);
|
|
139
|
+
const result = await runOpWave({
|
|
140
|
+
spec,
|
|
141
|
+
specFile: "waves.json",
|
|
142
|
+
wave: 1,
|
|
143
|
+
cwd: h.cwd,
|
|
144
|
+
show: h.show,
|
|
145
|
+
gates: memoryGateLedgerPort(),
|
|
146
|
+
capabilities: registry,
|
|
147
|
+
log: () => {},
|
|
148
|
+
afterPlan: { name: "steps", onFailure: "approve", targets: ["db"], run: () => { throw new Error("a step asks for a person"); } },
|
|
149
|
+
});
|
|
150
|
+
expect(result.exitCode).toBe(3);
|
|
151
|
+
expect(result.decision?.heldBy).toEqual(["after-plan hook steps (db)"]);
|
|
152
|
+
expect(ran).toEqual([]);
|
|
153
|
+
h.done();
|
|
154
|
+
});
|
|
155
|
+
|
|
156
|
+
test("a product's denied row denies the run, and its rows and files go on the run record", async () => {
|
|
157
|
+
const h = harness(spec);
|
|
158
|
+
const { registry, ran } = capability(h.cwd, digests);
|
|
159
|
+
const records: OpRunRecordInput[] = [];
|
|
160
|
+
const result = await runOpWave({
|
|
161
|
+
spec,
|
|
162
|
+
specFile: "waves.json",
|
|
163
|
+
wave: 1,
|
|
164
|
+
cwd: h.cwd,
|
|
165
|
+
show: h.show,
|
|
166
|
+
gates: memoryGateLedgerPort(),
|
|
167
|
+
runs: { append: async (r) => void records.push(r) },
|
|
168
|
+
capabilities: registry,
|
|
169
|
+
log: () => {},
|
|
170
|
+
afterPlan: {
|
|
171
|
+
name: "terragucci",
|
|
172
|
+
run: (r) => ({
|
|
173
|
+
policy: [{ source: "terragucci", result: r.target === "db" ? "denied" : "passed", rules: r.target === "db" ? ["main.deny_public"] : [] }],
|
|
174
|
+
files: [`plans/${r.target}.json`],
|
|
175
|
+
}),
|
|
176
|
+
},
|
|
177
|
+
});
|
|
178
|
+
expect(result.exitCode).toBe(7);
|
|
179
|
+
expect(result.decision?.refused?.runs).toEqual(["db"]);
|
|
180
|
+
expect(result.decision?.members.find((m) => m.member === "db")?.denied).toEqual({ rules: ["main.deny_public"] });
|
|
181
|
+
expect(ran).toEqual([]);
|
|
182
|
+
expect(records[0]!.wave!.plans).toEqual({
|
|
183
|
+
network: { planDigest: digest("1"), policy: [{ source: "terragucci", result: "passed", rules: [] }], files: ["plans/network.json"] },
|
|
184
|
+
app: { planDigest: digest("2"), policy: [{ source: "terragucci", result: "passed", rules: [] }], files: ["plans/app.json"] },
|
|
185
|
+
db: { planDigest: digest("3"), policy: [{ source: "terragucci", result: "denied", rules: ["main.deny_public"] }], files: ["plans/db.json"] },
|
|
186
|
+
});
|
|
187
|
+
h.done();
|
|
188
|
+
});
|
|
189
|
+
|
|
190
|
+
test("a command after.plan hook gets {planJson} and the plan's digest", async () => {
|
|
191
|
+
const withHook: OpWavesSpec = { ...spec, hooks: { after: { plan: [{ name: "view", command: ["view", "{target}", "{plan}", "{planJson}"], perRun: true }] } } };
|
|
192
|
+
expect(opWaveStepProblems(withHook)).toEqual([]);
|
|
193
|
+
expect(() => assertOpWavesSpec(withHook)).not.toThrow();
|
|
194
|
+
const h = harness(withHook);
|
|
195
|
+
const { registry } = capability(h.cwd, digests);
|
|
196
|
+
const calls: Array<{ argv: string[]; env?: Record<string, string> }> = [];
|
|
197
|
+
const result = await runOpWave({
|
|
198
|
+
spec: withHook,
|
|
199
|
+
specFile: "waves.json",
|
|
200
|
+
wave: 1,
|
|
201
|
+
cwd: h.cwd,
|
|
202
|
+
show: h.show,
|
|
203
|
+
gates: memoryGateLedgerPort(),
|
|
204
|
+
capabilities: registry,
|
|
205
|
+
exec: (argv, _cwd, env) => (calls.push({ argv, ...(env ? { env } : {}) }), 0),
|
|
206
|
+
});
|
|
207
|
+
expect(result.exitCode).toBe(0);
|
|
208
|
+
expect(calls.map((c) => c.argv)).toEqual(
|
|
209
|
+
["network", "app", "db"].map((t) => ["view", t, opWavePlanPath(withHook, 1, t), join(h.cwd, `${t}.tfplan.json`)]),
|
|
210
|
+
);
|
|
211
|
+
expect(calls[1]!.env).toMatchObject({ CHANT_TARGET: "app", CHANT_PLAN_DIGEST: digest("2"), CHANT_PLAN_JSON: join(h.cwd, "app.tfplan.json") });
|
|
212
|
+
h.done();
|
|
213
|
+
});
|
|
214
|
+
|
|
215
|
+
test("hookExec runs the command hooks with the event loop free", async () => {
|
|
216
|
+
const withHook: OpWavesSpec = { ...spec, hooks: { after: { plan: [{ name: "view", command: ["view", "{target}"], perRun: true }] } } };
|
|
217
|
+
const h = harness(withHook);
|
|
218
|
+
const { registry } = capability(h.cwd, digests);
|
|
219
|
+
const sync: string[][] = [];
|
|
220
|
+
const async: string[][] = [];
|
|
221
|
+
const result = await runOpWave({
|
|
222
|
+
spec: withHook,
|
|
223
|
+
specFile: "waves.json",
|
|
224
|
+
wave: 1,
|
|
225
|
+
cwd: h.cwd,
|
|
226
|
+
show: h.show,
|
|
227
|
+
gates: memoryGateLedgerPort(),
|
|
228
|
+
capabilities: registry,
|
|
229
|
+
exec: (argv) => (sync.push(argv), 0),
|
|
230
|
+
hookExec: async (argv) => {
|
|
231
|
+
await new Promise((r) => setImmediate(r));
|
|
232
|
+
async.push(argv);
|
|
233
|
+
return 0;
|
|
234
|
+
},
|
|
235
|
+
});
|
|
236
|
+
expect(result.exitCode).toBe(0);
|
|
237
|
+
expect(sync).toEqual([]);
|
|
238
|
+
expect(async.map((a) => a[1])).toEqual(["network", "app", "db"]);
|
|
239
|
+
h.done();
|
|
240
|
+
});
|
|
241
|
+
|
|
242
|
+
test("a hook that runs once for the wave cannot name {planJson}", () => {
|
|
243
|
+
expect(() => assertOpWavesSpec({ ...spec, hooks: { after: { plan: [{ command: ["view", "{planJson}"] }] } } })).toThrow(/runs once for the wave/);
|
|
244
|
+
expect(() => assertOpWavesSpec({ ...spec, hooks: { before: { plan: [{ command: ["view", "{planJson}"], perRun: true }] } } })).toThrow(/before the plan/);
|
|
245
|
+
});
|
|
246
|
+
|
|
247
|
+
test("{plan} and {planJson} fill apart", () => {
|
|
248
|
+
expect(opWaveArgv(["x", "{plan}", "{planJson}"], { op: "o", wave: "w", plan: "p.json", planJson: "p.tfplan.json" })).toEqual(["x", "p.json", "p.tfplan.json"]);
|
|
249
|
+
});
|
|
250
|
+
|
|
251
|
+
test("the hook list and its answers are checked", () => {
|
|
252
|
+
expect(opWaveAfterPlanProblems({ name: "", run: 1, onFailure: "stop" })).toEqual([
|
|
253
|
+
"afterPlan[0] needs a name",
|
|
254
|
+
"afterPlan[0] needs a run function",
|
|
255
|
+
'afterPlan[0] has onFailure "stop"; use fail or approve',
|
|
256
|
+
]);
|
|
257
|
+
expect(opWaveAfterPlanResultProblems({ policy: [{ source: "x", result: "held", rules: [] }], files: ["../out"] })).toEqual([
|
|
258
|
+
"policy[0] is held and names no rule, which an override or an approval would have to name",
|
|
259
|
+
"`files` must be paths inside the job's directory, relative to it",
|
|
260
|
+
]);
|
|
261
|
+
expect(opWaveAfterPlanResultProblems(undefined)).toEqual([]);
|
|
262
|
+
});
|
|
263
|
+
|
|
264
|
+
test("rows fold into the run's denial and hold", () => {
|
|
265
|
+
expect(foldPolicyRows(
|
|
266
|
+
[{ source: "p", result: "denied", rules: ["b"], reason: "public" }, { source: "p", result: "held", rules: ["h"] }, { source: "p", result: "passed", rules: [] }],
|
|
267
|
+
{ denied: { rules: ["a"] } },
|
|
268
|
+
)).toEqual({ denied: { rules: ["a", "b"], reason: "public" }, held: { rules: ["h"] } });
|
|
269
|
+
});
|
|
270
|
+
|
|
271
|
+
test("a product's wave hook is active only while its command runs", async () => {
|
|
272
|
+
const hook = { afterPlan: { name: "x", run: () => {} } };
|
|
273
|
+
expect(activeProductWaveHook()).toBeUndefined();
|
|
274
|
+
await withProductWaveHook(hook, async () => expect(activeProductWaveHook()).toBe(hook));
|
|
275
|
+
expect(activeProductWaveHook()).toBeUndefined();
|
|
276
|
+
});
|
|
277
|
+
});
|
|
278
|
+
|
|
279
|
+
describe("opWavePlanPath", () => {
|
|
280
|
+
test("is exported from the op entry beside opWavePlansPath, and names one target's plan file", async () => {
|
|
281
|
+
const entry = await import("./index");
|
|
282
|
+
expect(entry.opWavePlanPath).toBe(opWavePlanPath);
|
|
283
|
+
expect(entry.OP_WAVE_PLAN_PATH_FLOOR).toBe(NEXT_RELEASE);
|
|
284
|
+
const spec = { name: "demo" };
|
|
285
|
+
expect(entry.opWavePlanPath(spec, 2, "stacks/a b")).toBe(".chant/op-waves/demo/wave-2/stacks_a_b.plan.json");
|
|
286
|
+
expect(entry.opWavePlanPath(spec, 2, "x")).not.toBe(entry.opWavePlansPath(spec, 2));
|
|
287
|
+
});
|
|
288
|
+
});
|
|
@@ -0,0 +1,238 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* After-plan hooks in the wave job's process (#4614). A product that runs
|
|
3
|
+
* chant in process (`runOpWave`, or a bin built on `runChantInProcess`)
|
|
4
|
+
* passes `afterPlan` to build what it builds from each run's plan: its wave
|
|
5
|
+
* report, its own policy rows, the plan files its other jobs read. Each hook
|
|
6
|
+
* is called once per planned run, in the order the wave lists its runs,
|
|
7
|
+
* after chant's wave holds ran and before the set digest and the gate. It
|
|
8
|
+
* gets the run's plan digest, its `{plan}` file and, when the plan names
|
|
9
|
+
* one, the engine's plan document (`{planJson}`), with the rows chant's
|
|
10
|
+
* `holds.policy` gave the run.
|
|
11
|
+
*
|
|
12
|
+
* A hook may answer with policy rows and files. A `denied` row denies the
|
|
13
|
+
* run as a policy denial does (an override of its rules then counts), a
|
|
14
|
+
* `held` row holds the wave for a person, and every row and file goes on the
|
|
15
|
+
* job's run record (`wave.plans`). A hook that throws follows its
|
|
16
|
+
* `onFailure`: `fail` (the default) fails the wave before the gate, so
|
|
17
|
+
* nothing is approved or applied; `approve` holds the wave for an approval
|
|
18
|
+
* of its set digest, as a command hook's does.
|
|
19
|
+
*
|
|
20
|
+
* The spec's command hooks at `hooks.after.plan` keep running where they
|
|
21
|
+
* ran: after the set digest, before the gate settles. A `perRun` one gets
|
|
22
|
+
* `{planJson}`, `CHANT_PLAN_DIGEST` and `CHANT_PLAN_JSON` the same way.
|
|
23
|
+
*/
|
|
24
|
+
|
|
25
|
+
import { isAbsolute } from "node:path";
|
|
26
|
+
import type { ChangeSetPart } from "../change-set";
|
|
27
|
+
import type { OpRunPolicyRow } from "./runtime";
|
|
28
|
+
import { OP_WAVE_HOOK_FAILURES, opWaveHookRuns, type OpWaveHookFailure } from "./op-waves";
|
|
29
|
+
import type { OpWaveHookOutcome } from "./stage-hooks";
|
|
30
|
+
|
|
31
|
+
/** One planned run, as an after-plan hook in the job's process sees it (#4614). */
|
|
32
|
+
export interface OpWaveAfterPlanRun {
|
|
33
|
+
/** The spec's name and `op`. */
|
|
34
|
+
spec: string;
|
|
35
|
+
op: string;
|
|
36
|
+
/** The wave, 1-based, and its name. */
|
|
37
|
+
wave: number;
|
|
38
|
+
waveName: string;
|
|
39
|
+
/** The job planning it: `wave` for a whole wave, `decide` for a wide wave's deciding job, `share` or `group` for its apply jobs. */
|
|
40
|
+
job: "wave" | "decide" | "share" | "group";
|
|
41
|
+
target: string;
|
|
42
|
+
/** The run's own op. */
|
|
43
|
+
runOp: string;
|
|
44
|
+
planDigest: string;
|
|
45
|
+
/** The run's plan file, relative to the job's directory: `{plan}`. */
|
|
46
|
+
plan: string;
|
|
47
|
+
/** The engine's plan document, when the plan names one (`artifact.planJson`): `{planJson}`. */
|
|
48
|
+
planJson?: string;
|
|
49
|
+
/** The capability's artifact, for a run planned through a `step`. */
|
|
50
|
+
artifact?: unknown;
|
|
51
|
+
/** The run's change-set part, when its plan gave one. */
|
|
52
|
+
changeSet?: ChangeSetPart;
|
|
53
|
+
empty: boolean;
|
|
54
|
+
destructive: boolean;
|
|
55
|
+
/** The rows chant's `holds.policy` gave the run (source `ci.policy`), empty when no policy ran. */
|
|
56
|
+
policy: OpRunPolicyRow[];
|
|
57
|
+
/** The job's directory. */
|
|
58
|
+
cwd: string;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** What an after-plan hook adds to its run (#4614). */
|
|
62
|
+
export interface OpWaveAfterPlanResult {
|
|
63
|
+
/** The product's own policy rows. `denied` denies the run and `held` holds the wave. */
|
|
64
|
+
policy?: OpRunPolicyRow[];
|
|
65
|
+
/** Files the hook wrote for the run, relative to the job's directory. */
|
|
66
|
+
files?: string[];
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
/** An after-plan hook in the wave job's process (#4614). */
|
|
70
|
+
export interface OpWaveAfterPlanHook {
|
|
71
|
+
/** The hook's name in the log, the result's hooks and the run record. */
|
|
72
|
+
name: string;
|
|
73
|
+
/** Default `fail`. */
|
|
74
|
+
onFailure?: OpWaveHookFailure;
|
|
75
|
+
/** The runs it is for, as a command hook's `targets`. Default: every run. */
|
|
76
|
+
targets?: string[];
|
|
77
|
+
run(planned: OpWaveAfterPlanRun): OpWaveAfterPlanResult | void | Promise<OpWaveAfterPlanResult | void>;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
const ROW_RESULTS: ReadonlyArray<OpRunPolicyRow["result"]> = ["passed", "warned", "denied", "held"];
|
|
81
|
+
|
|
82
|
+
/** What is wrong with `afterPlan`, empty when nothing is. */
|
|
83
|
+
export function opWaveAfterPlanProblems(hooks: unknown): string[] {
|
|
84
|
+
if (hooks === undefined) return [];
|
|
85
|
+
const list = Array.isArray(hooks) ? hooks : [hooks];
|
|
86
|
+
const problems: string[] = [];
|
|
87
|
+
list.forEach((h: unknown, i) => {
|
|
88
|
+
const at = `afterPlan[${i}]`;
|
|
89
|
+
const hook = h as Partial<OpWaveAfterPlanHook> | null;
|
|
90
|
+
if (!hook || typeof hook !== "object") return void problems.push(`${at} must be { name, run, onFailure?, targets? }`);
|
|
91
|
+
if (typeof hook.name !== "string" || hook.name.trim() === "") problems.push(`${at} needs a name`);
|
|
92
|
+
if (typeof hook.run !== "function") problems.push(`${at} needs a run function`);
|
|
93
|
+
if (hook.onFailure !== undefined && !OP_WAVE_HOOK_FAILURES.includes(hook.onFailure)) problems.push(`${at} has onFailure "${String(hook.onFailure)}"; use ${OP_WAVE_HOOK_FAILURES.join(" or ")}`);
|
|
94
|
+
if (hook.targets !== undefined && (!Array.isArray(hook.targets) || hook.targets.length === 0 || !hook.targets.every((t) => typeof t === "string" && t !== ""))) problems.push(`${at}.targets must be a non-empty list of targets or patterns`);
|
|
95
|
+
});
|
|
96
|
+
return problems;
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/** What is wrong with one answer of a hook, empty when nothing is. */
|
|
100
|
+
export function opWaveAfterPlanResultProblems(value: unknown): string[] {
|
|
101
|
+
if (value === undefined || value === null) return [];
|
|
102
|
+
if (typeof value !== "object" || Array.isArray(value)) return ["the answer must be { policy?, files? }"];
|
|
103
|
+
const r = value as { policy?: unknown; files?: unknown };
|
|
104
|
+
const problems: string[] = [];
|
|
105
|
+
if (r.policy !== undefined) {
|
|
106
|
+
if (!Array.isArray(r.policy)) problems.push("`policy` must be a list of rows");
|
|
107
|
+
else r.policy.forEach((row: unknown, i) => {
|
|
108
|
+
const x = row as Partial<OpRunPolicyRow> | null;
|
|
109
|
+
if (!x || typeof x !== "object") return void problems.push(`policy[${i}] must be { source, result, rules, reason? }`);
|
|
110
|
+
if (typeof x.source !== "string" || x.source === "") problems.push(`policy[${i}] needs a source`);
|
|
111
|
+
if (!ROW_RESULTS.includes(x.result as OpRunPolicyRow["result"])) problems.push(`policy[${i}] has result ${JSON.stringify(x.result)}; use ${ROW_RESULTS.join(", ")}`);
|
|
112
|
+
if (!Array.isArray(x.rules) || !x.rules.every((t) => typeof t === "string" && t.trim() !== "")) problems.push(`policy[${i}].rules must be a list of rule ids`);
|
|
113
|
+
else if ((x.result === "denied" || x.result === "held") && x.rules.length === 0) problems.push(`policy[${i}] is ${x.result} and names no rule, which an override or an approval would have to name`);
|
|
114
|
+
if (x.reason !== undefined && typeof x.reason !== "string") problems.push(`policy[${i}].reason must be a string`);
|
|
115
|
+
});
|
|
116
|
+
}
|
|
117
|
+
if (r.files !== undefined && (!Array.isArray(r.files) || !r.files.every((f) => typeof f === "string" && f !== "" && !isAbsolute(f) && !f.split("/").includes("..")))) {
|
|
118
|
+
problems.push("`files` must be paths inside the job's directory, relative to it");
|
|
119
|
+
}
|
|
120
|
+
return problems;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
/** What one run's hooks came to. */
|
|
124
|
+
export interface OpWaveAfterPlanRunOutcome {
|
|
125
|
+
/** The hooks' rows, in order. */
|
|
126
|
+
policy: OpRunPolicyRow[];
|
|
127
|
+
files: string[];
|
|
128
|
+
}
|
|
129
|
+
|
|
130
|
+
/** What the after-plan hooks in the job's process came to (#4614). */
|
|
131
|
+
export interface OpWaveAfterPlanOutcome {
|
|
132
|
+
/** Set when a hook with `onFailure: fail` failed; nothing after it ran. */
|
|
133
|
+
failed?: string;
|
|
134
|
+
/** The `onFailure: approve` hooks that failed, each with its run. */
|
|
135
|
+
holds: string[];
|
|
136
|
+
outcomes: OpWaveHookOutcome[];
|
|
137
|
+
/** Each run's rows and files, by target, for the runs a hook answered. */
|
|
138
|
+
runs: Map<string, OpWaveAfterPlanRunOutcome>;
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/**
|
|
142
|
+
* Call each hook once per run it is for, hook by hook, each over the runs
|
|
143
|
+
* in the wave's order (#4614). A hook that throws, or answers with a shape
|
|
144
|
+
* chant cannot read, failed: under `fail` nothing after it runs, under
|
|
145
|
+
* `approve` it holds the wave and the rest go on.
|
|
146
|
+
*/
|
|
147
|
+
export async function runOpWaveAfterPlanHooks(
|
|
148
|
+
hooks: readonly OpWaveAfterPlanHook[],
|
|
149
|
+
runs: readonly OpWaveAfterPlanRun[],
|
|
150
|
+
log: (line: string) => void,
|
|
151
|
+
): Promise<OpWaveAfterPlanOutcome> {
|
|
152
|
+
const out: OpWaveAfterPlanOutcome = { holds: [], outcomes: [], runs: new Map() };
|
|
153
|
+
for (const hook of hooks) {
|
|
154
|
+
for (const run of opWaveHookRuns(hook, runs)) {
|
|
155
|
+
const label = `after-plan hook ${hook.name} (${run.target})`;
|
|
156
|
+
let problem: string | undefined;
|
|
157
|
+
let answer: OpWaveAfterPlanResult | void = undefined;
|
|
158
|
+
try {
|
|
159
|
+
answer = await hook.run(run);
|
|
160
|
+
const wrong = opWaveAfterPlanResultProblems(answer);
|
|
161
|
+
if (wrong.length > 0) problem = `${label} answered with ${wrong.join("; ")}`;
|
|
162
|
+
} catch (err) {
|
|
163
|
+
problem = `${label} failed: ${err instanceof Error ? err.message : String(err)}`;
|
|
164
|
+
}
|
|
165
|
+
const base = { moment: "after-plan" as const, name: hook.name, target: run.target };
|
|
166
|
+
if (problem === undefined) {
|
|
167
|
+
out.outcomes.push({ ...base, exit: 0, outcome: "passed" });
|
|
168
|
+
if (answer && (answer.policy?.length || answer.files?.length)) {
|
|
169
|
+
const got = out.runs.get(run.target) ?? { policy: [], files: [] };
|
|
170
|
+
for (const row of answer.policy ?? []) got.policy.push({ source: row.source, result: row.result, rules: [...new Set(row.rules)].sort(), ...(row.reason ? { reason: row.reason } : {}) });
|
|
171
|
+
for (const f of answer.files ?? []) if (!got.files.includes(f)) got.files.push(f);
|
|
172
|
+
out.runs.set(run.target, got);
|
|
173
|
+
}
|
|
174
|
+
continue;
|
|
175
|
+
}
|
|
176
|
+
if (hook.onFailure === "approve") {
|
|
177
|
+
out.outcomes.push({ ...base, exit: 1, outcome: "held" });
|
|
178
|
+
out.holds.push(label);
|
|
179
|
+
log(`${problem}, so wave ${run.wave} (${run.waveName}) waits for an approval of its set digest`);
|
|
180
|
+
continue;
|
|
181
|
+
}
|
|
182
|
+
out.outcomes.push({ ...base, exit: 1, outcome: "failed" });
|
|
183
|
+
out.failed = problem;
|
|
184
|
+
log(problem);
|
|
185
|
+
return out;
|
|
186
|
+
}
|
|
187
|
+
}
|
|
188
|
+
return out;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/** Fold policy rows into a run's denial and hold: the rules of every `denied` row, and of every `held` row. */
|
|
192
|
+
export function foldPolicyRows(
|
|
193
|
+
rows: readonly OpRunPolicyRow[],
|
|
194
|
+
now: { denied?: { rules: string[]; reason?: string }; held?: { rules: string[]; reason?: string } },
|
|
195
|
+
): { denied?: { rules: string[]; reason?: string }; held?: { rules: string[]; reason?: string } } {
|
|
196
|
+
const fold = (kind: "denied" | "held", was?: { rules: string[]; reason?: string }) => {
|
|
197
|
+
const mine = rows.filter((r) => r.result === kind);
|
|
198
|
+
if (mine.length === 0) return was;
|
|
199
|
+
const rules = [...new Set([...(was?.rules ?? []), ...mine.flatMap((r) => r.rules)])].sort();
|
|
200
|
+
const reason = [was?.reason, ...mine.map((r) => r.reason)].filter((x): x is string => !!x).join("; ");
|
|
201
|
+
return { rules, ...(reason ? { reason } : {}) };
|
|
202
|
+
};
|
|
203
|
+
const denied = fold("denied", now.denied);
|
|
204
|
+
const held = fold("held", now.held);
|
|
205
|
+
return { ...(denied ? { denied } : {}), ...(held ? { held } : {}) };
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
/**
|
|
209
|
+
* What a product's bin hands `chant run wave` when it runs chant in process
|
|
210
|
+
* (#4614): `runChantInProcess(["run", "wave", ...], words, { wave })`. The
|
|
211
|
+
* job then calls the product's after-plan hooks, and plans and applies a
|
|
212
|
+
* `step` through the product's own capability registry when it gives one.
|
|
213
|
+
*/
|
|
214
|
+
export interface ProductWaveHook {
|
|
215
|
+
afterPlan?: OpWaveAfterPlanHook | readonly OpWaveAfterPlanHook[];
|
|
216
|
+
capabilities?: import("../components/capability").CapabilityRegistry;
|
|
217
|
+
/** How the spec's command hooks run, when they call back into the product's process (`RunOpWaveOptions.hookExec`). */
|
|
218
|
+
hookExec?: import("./stage-hooks").OpWaveAsyncExec;
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
let activeWave: ProductWaveHook | undefined;
|
|
222
|
+
|
|
223
|
+
/** The product's wave hook while a command it runs in process runs, else undefined. */
|
|
224
|
+
export function activeProductWaveHook(): ProductWaveHook | undefined {
|
|
225
|
+
return activeWave;
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
/** Run `fn` with `hook` active, and put the earlier one back after it settles. */
|
|
229
|
+
export async function withProductWaveHook<T>(hook: ProductWaveHook | undefined, fn: () => Promise<T>): Promise<T> {
|
|
230
|
+
if (!hook) return fn();
|
|
231
|
+
const was = activeWave;
|
|
232
|
+
activeWave = hook;
|
|
233
|
+
try {
|
|
234
|
+
return await fn();
|
|
235
|
+
} finally {
|
|
236
|
+
activeWave = was;
|
|
237
|
+
}
|
|
238
|
+
}
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The settings half of op waves through capabilities (#4545): the `step` and
|
|
3
|
+
* `holds` shapes and their checks. `./op-waves.ts` checks a spec with these,
|
|
4
|
+
* and this file imports nothing at run time, so the spec module (and every
|
|
5
|
+
* bundle that holds it: the gate decision, the stage hooks) stays without the
|
|
6
|
+
* capability registry, the config loader and the policy runner that
|
|
7
|
+
* `./op-waves-capability.ts` loads. See that file for the step and the holds.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import type { OpWavesSpec } from "./op-waves";
|
|
11
|
+
|
|
12
|
+
/** A capability step a wave plans and applies each run through (#4545): `{ kind, ...input }`. */
|
|
13
|
+
export interface OpWaveStep {
|
|
14
|
+
/** The capability's kind, such as `terraform-apply` or `pulumi-up`. */
|
|
15
|
+
kind: string;
|
|
16
|
+
/** The step's input. Each string has `{target}`, `{op}` and `{wave}` filled per run. */
|
|
17
|
+
[field: string]: unknown;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
/** The estimate's shape a cost hold reads. */
|
|
21
|
+
export const OP_WAVE_COST_FORMATS = ["infracost", "chant"] as const;
|
|
22
|
+
export type OpWaveCostFormat = (typeof OP_WAVE_COST_FORMATS)[number];
|
|
23
|
+
|
|
24
|
+
/** A cost hold (#4545): an estimator per run, and the monthly change over which the wave waits. */
|
|
25
|
+
export interface OpWaveCostHold {
|
|
26
|
+
/**
|
|
27
|
+
* Argv, run once per run that changes something. `{target}` and `{plan}`
|
|
28
|
+
* (the run's plan file, as hooks get it) are filled in, and `{planJson}`
|
|
29
|
+
* with the engine's plan document when the capability's plan names one
|
|
30
|
+
* (`artifact.planJson`). It prints the estimate on standard output.
|
|
31
|
+
*/
|
|
32
|
+
command: string[];
|
|
33
|
+
/** The monthly change, summed over the wave's runs, above which the wave waits for a person. */
|
|
34
|
+
approveAbove: number;
|
|
35
|
+
/** `infracost`: `infracost breakdown --format json`'s document. `chant`: `{ "monthlyDelta": <number>, "currency"?: "<code>" }`. Default `infracost`. */
|
|
36
|
+
format?: OpWaveCostFormat;
|
|
37
|
+
/** The currency `approveAbove` is in, for the log and the digest. Default the estimate's, else `USD`. */
|
|
38
|
+
currency?: string;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** Holds a wave runs over its plans (#4545), read at base. */
|
|
42
|
+
export interface OpWaveHolds {
|
|
43
|
+
/** Run the workspace's `ci.policy` at base over each run's change set: deny rules deny the run, hold rules hold it. */
|
|
44
|
+
policy?: boolean;
|
|
45
|
+
/** Price each run and hold the wave over a monthly change. */
|
|
46
|
+
cost?: OpWaveCostHold;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** The digest member a cost hold adds (#4545): no run has this name. */
|
|
50
|
+
export const OP_WAVE_COST_MEMBER = "(monthly cost)";
|
|
51
|
+
|
|
52
|
+
/** What is wrong with a spec's `step`, empty when nothing is. */
|
|
53
|
+
export function opWaveStepProblems(spec: Pick<OpWavesSpec, "step" | "plan" | "apply" | "planWave" | "applyWave" | "hooks" | "waves">): string[] {
|
|
54
|
+
const step = spec.step as unknown;
|
|
55
|
+
if (step === undefined) return [];
|
|
56
|
+
if (step === null || typeof step !== "object" || Array.isArray(step)) return ["`step` must be { \"kind\": \"<capability>\", ...input }"];
|
|
57
|
+
const problems: string[] = [];
|
|
58
|
+
const kind = (step as { kind?: unknown }).kind;
|
|
59
|
+
if (typeof kind !== "string" || kind.trim() === "") problems.push("`step.kind` must name a capability, such as \"terraform-apply\"");
|
|
60
|
+
for (const key of ["plan", "apply", "planWave", "applyWave"] as const) {
|
|
61
|
+
if (spec[key] !== undefined) problems.push(`\`step\` and \`${key}\` are both set; a wave plans and applies through its capability or through commands, so give one`);
|
|
62
|
+
}
|
|
63
|
+
if (spec.hooks?.apply?.runBy === "apply") problems.push("`hooks.apply.runBy: \"apply\"` hands the apply-stage hooks to an apply command, and a `step` has none; leave runBy as chant");
|
|
64
|
+
for (const wave of spec.waves) {
|
|
65
|
+
if (wave.discover) problems.push(`wave "${wave.name}" discovers its runs, which only \`planWave\` can report; a \`step\` plans the runs the spec lists`);
|
|
66
|
+
if (wave.hooks?.apply?.runBy === "apply") problems.push(`wave "${wave.name}" hands its apply-stage hooks to an apply command, and a \`step\` has none`);
|
|
67
|
+
for (const run of wave.runs ?? []) {
|
|
68
|
+
const input = run.input as unknown;
|
|
69
|
+
if (input !== undefined && (input === null || typeof input !== "object" || Array.isArray(input))) problems.push(`wave "${wave.name}" run "${run.target}": \`input\` must be an object laid over the step's input`);
|
|
70
|
+
if (input && typeof input === "object" && "kind" in input) problems.push(`wave "${wave.name}" run "${run.target}": \`input\` cannot change the step's kind`);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
return problems;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* What is wrong with the spec's and each wave's `parallelism` (#4625), empty
|
|
78
|
+
* when nothing is. Runs applied at once need the capability step, whose
|
|
79
|
+
* apply is one call per run with no gate in it. The whole-number check
|
|
80
|
+
* matches ../parallelism.ts's parallelismProblem, kept here so the spec
|
|
81
|
+
* module (and the bundles that hold it) do not load that file's run loop.
|
|
82
|
+
*/
|
|
83
|
+
export function opWaveParallelismProblems(spec: Pick<OpWavesSpec, "parallelism" | "step" | "waves">): string[] {
|
|
84
|
+
const problems: string[] = [];
|
|
85
|
+
for (const [field, value] of [["parallelism", spec.parallelism] as const, ...spec.waves.map((w) => [`wave "${w.name}" parallelism`, w.parallelism] as const)]) {
|
|
86
|
+
if (value === undefined) continue;
|
|
87
|
+
if (typeof value !== "number" || !Number.isInteger(value) || value < 1) {
|
|
88
|
+
problems.push(`${field} is ${JSON.stringify(value)}; give a whole number of 1 or more, the most that run at once`);
|
|
89
|
+
} else if (value > 1 && spec.step === undefined) {
|
|
90
|
+
problems.push(`${field} is ${value}, and runs apply at once only through \`step\`; drop it or give step`);
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
return problems;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/** What is wrong with a spec's `holds`, empty when nothing is. */
|
|
97
|
+
export function opWaveHoldsProblems(holds: unknown): string[] {
|
|
98
|
+
if (holds === undefined) return [];
|
|
99
|
+
if (holds === null || typeof holds !== "object" || Array.isArray(holds)) return ["`holds` must be { \"policy\"?: true, \"cost\"?: {...} }"];
|
|
100
|
+
const problems: string[] = [];
|
|
101
|
+
for (const [key, value] of Object.entries(holds as Record<string, unknown>)) {
|
|
102
|
+
if (key === "policy") {
|
|
103
|
+
if (typeof value !== "boolean") problems.push("`holds.policy` must be true or false");
|
|
104
|
+
} else if (key === "cost") {
|
|
105
|
+
problems.push(...costHoldProblems(value));
|
|
106
|
+
} else problems.push(`\`holds.${key}\` is not a setting; the ones there are holds.policy and holds.cost`);
|
|
107
|
+
}
|
|
108
|
+
return problems;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
function costHoldProblems(value: unknown): string[] {
|
|
112
|
+
if (value === null || typeof value !== "object" || Array.isArray(value)) return ["`holds.cost` must be { \"command\": [...], \"approveAbove\": <number>, \"format\"?, \"currency\"? }"];
|
|
113
|
+
const c = value as Record<string, unknown>;
|
|
114
|
+
const problems: string[] = [];
|
|
115
|
+
if (!Array.isArray(c.command) || c.command.length === 0 || !c.command.every((a) => typeof a === "string" && a !== "")) problems.push("`holds.cost.command` must be argv, a non-empty list of strings");
|
|
116
|
+
if (typeof c.approveAbove !== "number" || !Number.isFinite(c.approveAbove) || c.approveAbove < 0) problems.push("`holds.cost.approveAbove` must be a monthly amount of 0 or more");
|
|
117
|
+
if (c.format !== undefined && !(OP_WAVE_COST_FORMATS as readonly unknown[]).includes(c.format)) problems.push(`\`holds.cost.format\` must be ${OP_WAVE_COST_FORMATS.join(" or ")}`);
|
|
118
|
+
if (c.currency !== undefined && (typeof c.currency !== "string" || !/^[A-Z]{3}$/.test(c.currency))) problems.push("`holds.cost.currency` must be a three-letter currency code, such as \"USD\"");
|
|
119
|
+
for (const key of Object.keys(c)) if (!["command", "approveAbove", "format", "currency"].includes(key)) problems.push(`\`holds.cost.${key}\` is not a setting`);
|
|
120
|
+
return problems;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
/**
|
|
124
|
+
* The holds wave rules take (#4545): the spec's at base, else the change's
|
|
125
|
+
* when the base has none. `policy` is on when either one sets it, so a
|
|
126
|
+
* change can add the hold and never drop it. Undefined when neither sets any.
|
|
127
|
+
*/
|
|
128
|
+
export function opWaveHoldsAt(atBase: OpWaveHolds | undefined, change: OpWaveHolds | undefined): OpWaveHolds | undefined {
|
|
129
|
+
const policy = atBase?.policy === true || change?.policy === true;
|
|
130
|
+
const cost = atBase !== undefined ? atBase.cost : change?.cost;
|
|
131
|
+
if (!policy && !cost) return undefined;
|
|
132
|
+
return { ...(policy ? { policy: true } : {}), ...(cost ? { cost } : {}) };
|
|
133
|
+
}
|