@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,197 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Op waves through capabilities (#4545): a wave whose spec names a `step`
|
|
3
|
+
* plans and applies each run through a capability (`terraform-apply`,
|
|
4
|
+
* `pulumi-up`, any kind a lexicon's plugin contributes) in the job's own
|
|
5
|
+
* process, in place of a `plan` and an `apply` command. The gate, the
|
|
6
|
+
* approval, the spend, the hooks, the shares and the run record are the ones
|
|
7
|
+
* every op wave has; only who plans and who applies changes.
|
|
8
|
+
*
|
|
9
|
+
* ## The step
|
|
10
|
+
*
|
|
11
|
+
* `step` is `{ kind, ...input }`, the same shape a component's deploy step
|
|
12
|
+
* has. Each string in the input has `{target}`, `{op}` and `{wave}` filled
|
|
13
|
+
* per run, and a run's own `input` is laid over it, so one step covers every
|
|
14
|
+
* root of a wave and a run adds what is its own (vars, reads):
|
|
15
|
+
*
|
|
16
|
+
* ```json
|
|
17
|
+
* { "step": { "kind": "terraform-apply", "root": "{target}", "lockTimeout": "5m" },
|
|
18
|
+
* "waves": [{ "name": "dev", "runs": [{ "target": "network" }, { "target": "app", "input": { "vars": { "size": "s" } } }] }] }
|
|
19
|
+
* ```
|
|
20
|
+
*
|
|
21
|
+
* - Plan: `capability.plan` per run. The run's member digest is the plan's
|
|
22
|
+
* `planDigest`; `empty` and `destructive` come from its change-set part
|
|
23
|
+
* (no entry but `no-op` and `read`; a `delete` or `replace`), and a plan
|
|
24
|
+
* whose `destructive` names a class of the engine's own is destructive
|
|
25
|
+
* too (#4569, the sql lexicon's `sql-migrate`). A member
|
|
26
|
+
* whose part has holes and no artifact cannot apply, so planning fails
|
|
27
|
+
* with the holes' reasons. The parts compose into the wave's change-set
|
|
28
|
+
* document, which the pending fact cites (#4551).
|
|
29
|
+
* - Apply: `capability.run` with the plan's artifact in `DeployContext.plans`,
|
|
30
|
+
* so the run applies the plan the gate decided and nothing else. A run the
|
|
31
|
+
* capability refuses as moved (`isPlanMovedError`) applied nothing and the
|
|
32
|
+
* job exits 4, the table's moved code (#4553); any other error fails it.
|
|
33
|
+
*
|
|
34
|
+
* The registry is the project's (`fanOutRegistry`, the one `chant run
|
|
35
|
+
* --components` builds), loaded once per job behind a dynamic import, so the
|
|
36
|
+
* wave-job runtime bundle stays without the config loader. A product that
|
|
37
|
+
* runs chant in process passes its own (`RunOpWaveOptions.capabilities`).
|
|
38
|
+
*
|
|
39
|
+
* ## Holds (#4545)
|
|
40
|
+
*
|
|
41
|
+
* `holds` is a wave hold any product switches on, read at base with the
|
|
42
|
+
* policy, so a change cannot drop the hold its own wave is judged by:
|
|
43
|
+
*
|
|
44
|
+
* - `policy: true` runs the workspace's `ci.policy` (read at base, as the
|
|
45
|
+
* pull-request path reads it, `../components/pr-policy.ts`) over each
|
|
46
|
+
* run's change-set part. Its deny rules deny the run (an override then
|
|
47
|
+
* counts, `../override-gate.ts`), its hold rules hold it for a person, and
|
|
48
|
+
* a policy that cannot run fails the wave.
|
|
49
|
+
* - `cost` runs an estimator per run and sums the monthly change. Over
|
|
50
|
+
* `approveAbove` the wave waits for a person whatever its gate says, and
|
|
51
|
+
* the cost is a member of the set digest, so an approval at one cost does
|
|
52
|
+
* not apply at another. A run the estimator cannot price holds the wave
|
|
53
|
+
* too. The terraform lexicon's preset is `terraformCostHold` (infracost).
|
|
54
|
+
*/
|
|
55
|
+
import type { Capability, CapabilityRegistry, DeployContext } from "../components/capability.js";
|
|
56
|
+
import type { CapabilityTraceFacts } from "../otlp.js";
|
|
57
|
+
import { type ChangeSetDocument, type ChangeSetPart } from "../change-set.js";
|
|
58
|
+
import type { GatePolicyExec } from "../gate-policy.js";
|
|
59
|
+
import type { ResolvedGatePolicySource } from "../policy-source.js";
|
|
60
|
+
import type { WaveMember } from "../wave-engine.js";
|
|
61
|
+
import type { OpWave, OpWaveRun, OpWavesSpec } from "./op-waves.js";
|
|
62
|
+
import { type LockGrain, type PlannedLock } from "../lifecycle/lock-rows.js";
|
|
63
|
+
import { type OpWaveCostFormat, type OpWaveCostHold } from "./op-waves-capability-spec.js";
|
|
64
|
+
export { OP_WAVE_COST_FORMATS, OP_WAVE_COST_MEMBER, opWaveHoldsAt, opWaveHoldsProblems, opWaveStepProblems } from "./op-waves-capability-spec.js";
|
|
65
|
+
export type { OpWaveCostFormat, OpWaveCostHold, OpWaveHolds, OpWaveStep } from "./op-waves-capability-spec.js";
|
|
66
|
+
/** The input a run's step gets (#4545): the spec's step with the run's values filled in, and the run's own `input` over it. */
|
|
67
|
+
export declare function opWaveStepInput(spec: Pick<OpWavesSpec, "op" | "step">, wave: Pick<OpWave, "name">, run: OpWaveRun): Record<string, unknown>;
|
|
68
|
+
/** The context a run's step plans and applies with: the spec's `labels.Env`, else the wave's name, and the run's target as the component. */
|
|
69
|
+
export declare function opWaveStepContext(spec: Pick<OpWavesSpec, "labels">, wave: Pick<OpWave, "name">, run: OpWaveRun): DeployContext;
|
|
70
|
+
/**
|
|
71
|
+
* The registry a job plans and applies through: `given`, else the project's
|
|
72
|
+
* at `cwd`, loaded once per `key` (the job's options) behind a dynamic
|
|
73
|
+
* import, which the wave-job runtime bundle leaves out.
|
|
74
|
+
*/
|
|
75
|
+
export declare function opWaveRegistry(key: object, cwd: string, given?: CapabilityRegistry): Promise<CapabilityRegistry>;
|
|
76
|
+
/** One run's plan through its step: what the gate binds, and what the apply hands back. */
|
|
77
|
+
export interface OpWaveStepPlan {
|
|
78
|
+
target: string;
|
|
79
|
+
/** The capability's member, the key `run` finds its artifact under. */
|
|
80
|
+
member: string;
|
|
81
|
+
planDigest: string;
|
|
82
|
+
artifact?: unknown;
|
|
83
|
+
part?: ChangeSetPart;
|
|
84
|
+
empty: boolean;
|
|
85
|
+
destructive: boolean;
|
|
86
|
+
/** The run's lock grain and rows (#4552), which the apply leases on the resource grain. */
|
|
87
|
+
lock?: PlannedLock;
|
|
88
|
+
}
|
|
89
|
+
/** Whether a part changes nothing, and whether it destroys or replaces something. */
|
|
90
|
+
export declare function partEffects(part: ChangeSetPart | undefined): {
|
|
91
|
+
empty: boolean;
|
|
92
|
+
destructive: boolean;
|
|
93
|
+
};
|
|
94
|
+
/** Plan one run through the spec's step (#4545), writing its plan file at `planPath` (relative to `cwd`) as a per-run `plan` command would. */
|
|
95
|
+
export declare function planOpWaveStep(at: {
|
|
96
|
+
spec: OpWavesSpec;
|
|
97
|
+
wave: OpWave;
|
|
98
|
+
cwd: string;
|
|
99
|
+
registry: CapabilityRegistry;
|
|
100
|
+
planPath: string;
|
|
101
|
+
lockGrain?: LockGrain | null;
|
|
102
|
+
policyBase?: string;
|
|
103
|
+
}, run: OpWaveRun): Promise<OpWaveStepPlan>;
|
|
104
|
+
/** How one run's apply through its step came out, with what the capability knew about it (#4555). */
|
|
105
|
+
export type OpWaveStepApply = ({
|
|
106
|
+
outcome: "applied";
|
|
107
|
+
output: unknown;
|
|
108
|
+
} | {
|
|
109
|
+
outcome: "moved";
|
|
110
|
+
reason: string;
|
|
111
|
+
} | {
|
|
112
|
+
outcome: "failed";
|
|
113
|
+
reason: string;
|
|
114
|
+
}) & {
|
|
115
|
+
facts?: CapabilityTraceFacts;
|
|
116
|
+
};
|
|
117
|
+
/**
|
|
118
|
+
* A step's facts for its span and run record (#4555): the plan's resource
|
|
119
|
+
* counts by action, which core reads from the plan's change-set part, and
|
|
120
|
+
* whatever the capability's `traceFacts` adds. A `traceFacts` that throws
|
|
121
|
+
* is left out.
|
|
122
|
+
*/
|
|
123
|
+
export declare function opWaveStepFacts(capability: Capability<never, unknown>, input: unknown, plan: OpWaveStepPlan, outcome: {
|
|
124
|
+
output: unknown;
|
|
125
|
+
} | {
|
|
126
|
+
error: unknown;
|
|
127
|
+
}): Promise<CapabilityTraceFacts | undefined>;
|
|
128
|
+
/** Apply one run through the spec's step (#4545), with the plan the gate decided. */
|
|
129
|
+
export declare function applyOpWaveStep(at: {
|
|
130
|
+
spec: OpWavesSpec;
|
|
131
|
+
wave: OpWave;
|
|
132
|
+
registry: CapabilityRegistry;
|
|
133
|
+
}, run: OpWaveRun, plan: OpWaveStepPlan): Promise<OpWaveStepApply>;
|
|
134
|
+
/** The wave's change-set document (#4551) from its runs' parts, or undefined when no run gave one. */
|
|
135
|
+
export declare function opWaveStepChangeSet(plans: readonly OpWaveStepPlan[]): ChangeSetDocument | undefined;
|
|
136
|
+
/** A policy verdict for one run, as the hold reads it. */
|
|
137
|
+
export interface OpWaveRunVerdict {
|
|
138
|
+
result: "passed" | "denied" | "held" | "error";
|
|
139
|
+
rules: string[];
|
|
140
|
+
holds: string[];
|
|
141
|
+
reason?: string;
|
|
142
|
+
}
|
|
143
|
+
/**
|
|
144
|
+
* Run the workspace's `ci.policy` at `base` over each run's part (#4545).
|
|
145
|
+
* Returns each run's verdict, or a line saying why no policy runs (the base
|
|
146
|
+
* names none). Throws when the policy at base cannot be read while the
|
|
147
|
+
* checkout names one, as the pull-request path does.
|
|
148
|
+
*/
|
|
149
|
+
export declare function opWavePolicyVerdicts(at: {
|
|
150
|
+
spec: Pick<OpWavesSpec, "name">;
|
|
151
|
+
gate: string;
|
|
152
|
+
env: string;
|
|
153
|
+
base: string;
|
|
154
|
+
head: string;
|
|
155
|
+
cwd: string;
|
|
156
|
+
exec?: GatePolicyExec;
|
|
157
|
+
}, parts: ReadonlyMap<string, ChangeSetPart>): Promise<{
|
|
158
|
+
verdicts: Map<string, OpWaveRunVerdict>;
|
|
159
|
+
source?: ResolvedGatePolicySource;
|
|
160
|
+
} | {
|
|
161
|
+
note: string;
|
|
162
|
+
}>;
|
|
163
|
+
/** One run's estimate: the monthly change, or why there is none. */
|
|
164
|
+
export type OpWaveRunCost = {
|
|
165
|
+
target: string;
|
|
166
|
+
monthlyDelta: number;
|
|
167
|
+
currency?: string;
|
|
168
|
+
} | {
|
|
169
|
+
target: string;
|
|
170
|
+
error: string;
|
|
171
|
+
};
|
|
172
|
+
/** The monthly change an estimate gives, in `format`. Throws when it gives none. */
|
|
173
|
+
export declare function readCostEstimate(format: OpWaveCostFormat, stdout: string): {
|
|
174
|
+
monthlyDelta: number;
|
|
175
|
+
currency?: string;
|
|
176
|
+
};
|
|
177
|
+
/** The engine's plan document a capability's artifact names (`artifact.planJson`), when it names one that exists. */
|
|
178
|
+
export declare function planJsonOf(artifact: unknown, cwd: string): string | undefined;
|
|
179
|
+
/** Price each run that changes something (#4545). A run with no estimate says why. */
|
|
180
|
+
export declare function opWaveCosts(hold: OpWaveCostHold, runs: ReadonlyArray<{
|
|
181
|
+
target: string;
|
|
182
|
+
plan: string;
|
|
183
|
+
artifact?: unknown;
|
|
184
|
+
empty: boolean;
|
|
185
|
+
}>, cwd: string, exec?: GatePolicyExec): OpWaveRunCost[];
|
|
186
|
+
/** What a wave's estimates come to: the sum, the digest member, and the hold line when it waits. */
|
|
187
|
+
export interface OpWaveCostVerdict {
|
|
188
|
+
monthlyDelta: number;
|
|
189
|
+
currency: string;
|
|
190
|
+
unestimated: string[];
|
|
191
|
+
member: WaveMember;
|
|
192
|
+
/** Set when the wave waits for it: over `approveAbove`, or a run with no estimate. */
|
|
193
|
+
hold?: string;
|
|
194
|
+
}
|
|
195
|
+
/** Sum a wave's estimates against `approveAbove` (#4545). */
|
|
196
|
+
export declare function opWaveCostVerdict(hold: OpWaveCostHold, costs: readonly OpWaveRunCost[]): OpWaveCostVerdict;
|
|
197
|
+
//# sourceMappingURL=op-waves-capability.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"op-waves-capability.d.ts","sourceRoot":"","sources":["../../src/op/op-waves-capability.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,311 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Op waves through capabilities (#4545): a wave whose spec names a `step`
|
|
3
|
+
* plans and applies each run through a capability (`terraform-apply`,
|
|
4
|
+
* `pulumi-up`, any kind a lexicon's plugin contributes) in the job's own
|
|
5
|
+
* process, in place of a `plan` and an `apply` command. The gate, the
|
|
6
|
+
* approval, the spend, the hooks, the shares and the run record are the ones
|
|
7
|
+
* every op wave has; only who plans and who applies changes.
|
|
8
|
+
*
|
|
9
|
+
* ## The step
|
|
10
|
+
*
|
|
11
|
+
* `step` is `{ kind, ...input }`, the same shape a component's deploy step
|
|
12
|
+
* has. Each string in the input has `{target}`, `{op}` and `{wave}` filled
|
|
13
|
+
* per run, and a run's own `input` is laid over it, so one step covers every
|
|
14
|
+
* root of a wave and a run adds what is its own (vars, reads):
|
|
15
|
+
*
|
|
16
|
+
* ```json
|
|
17
|
+
* { "step": { "kind": "terraform-apply", "root": "{target}", "lockTimeout": "5m" },
|
|
18
|
+
* "waves": [{ "name": "dev", "runs": [{ "target": "network" }, { "target": "app", "input": { "vars": { "size": "s" } } }] }] }
|
|
19
|
+
* ```
|
|
20
|
+
*
|
|
21
|
+
* - Plan: `capability.plan` per run. The run's member digest is the plan's
|
|
22
|
+
* `planDigest`; `empty` and `destructive` come from its change-set part
|
|
23
|
+
* (no entry but `no-op` and `read`; a `delete` or `replace`), and a plan
|
|
24
|
+
* whose `destructive` names a class of the engine's own is destructive
|
|
25
|
+
* too (#4569, the sql lexicon's `sql-migrate`). A member
|
|
26
|
+
* whose part has holes and no artifact cannot apply, so planning fails
|
|
27
|
+
* with the holes' reasons. The parts compose into the wave's change-set
|
|
28
|
+
* document, which the pending fact cites (#4551).
|
|
29
|
+
* - Apply: `capability.run` with the plan's artifact in `DeployContext.plans`,
|
|
30
|
+
* so the run applies the plan the gate decided and nothing else. A run the
|
|
31
|
+
* capability refuses as moved (`isPlanMovedError`) applied nothing and the
|
|
32
|
+
* job exits 4, the table's moved code (#4553); any other error fails it.
|
|
33
|
+
*
|
|
34
|
+
* The registry is the project's (`fanOutRegistry`, the one `chant run
|
|
35
|
+
* --components` builds), loaded once per job behind a dynamic import, so the
|
|
36
|
+
* wave-job runtime bundle stays without the config loader. A product that
|
|
37
|
+
* runs chant in process passes its own (`RunOpWaveOptions.capabilities`).
|
|
38
|
+
*
|
|
39
|
+
* ## Holds (#4545)
|
|
40
|
+
*
|
|
41
|
+
* `holds` is a wave hold any product switches on, read at base with the
|
|
42
|
+
* policy, so a change cannot drop the hold its own wave is judged by:
|
|
43
|
+
*
|
|
44
|
+
* - `policy: true` runs the workspace's `ci.policy` (read at base, as the
|
|
45
|
+
* pull-request path reads it, `../components/pr-policy.ts`) over each
|
|
46
|
+
* run's change-set part. Its deny rules deny the run (an override then
|
|
47
|
+
* counts, `../override-gate.ts`), its hold rules hold it for a person, and
|
|
48
|
+
* a policy that cannot run fails the wave.
|
|
49
|
+
* - `cost` runs an estimator per run and sums the monthly change. Over
|
|
50
|
+
* `approveAbove` the wave waits for a person whatever its gate says, and
|
|
51
|
+
* the cost is a member of the set digest, so an approval at one cost does
|
|
52
|
+
* not apply at another. A run the estimator cannot price holds the wave
|
|
53
|
+
* too. The terraform lexicon's preset is `terraformCostHold` (infracost).
|
|
54
|
+
*/
|
|
55
|
+
import { spawnSync } from "node:child_process";
|
|
56
|
+
import { existsSync, mkdirSync, writeFileSync } from "node:fs";
|
|
57
|
+
import { dirname, join } from "node:path";
|
|
58
|
+
import { isPlanMovedError } from "../components/capability.js";
|
|
59
|
+
import { composeChangeSet } from "../change-set.js";
|
|
60
|
+
import { computePlanDigest } from "../lifecycle/plan-digest.js";
|
|
61
|
+
import { resolvePlannedLock } from "../lifecycle/lock-rows.js";
|
|
62
|
+
import { OP_WAVE_COST_MEMBER } from "./op-waves-capability-spec.js";
|
|
63
|
+
export { OP_WAVE_COST_FORMATS, OP_WAVE_COST_MEMBER, opWaveHoldsAt, opWaveHoldsProblems, opWaveStepProblems } from "./op-waves-capability-spec.js";
|
|
64
|
+
/** Fill `{target}`, `{op}` and `{wave}` in every string of `value`. */
|
|
65
|
+
function fill(value, vars) {
|
|
66
|
+
if (typeof value === "string")
|
|
67
|
+
return value.replaceAll("{target}", vars.target).replaceAll("{op}", vars.op).replaceAll("{wave}", vars.wave);
|
|
68
|
+
if (Array.isArray(value))
|
|
69
|
+
return value.map((v) => fill(v, vars));
|
|
70
|
+
if (value !== null && typeof value === "object")
|
|
71
|
+
return Object.fromEntries(Object.entries(value).map(([k, v]) => [k, fill(v, vars)]));
|
|
72
|
+
return value;
|
|
73
|
+
}
|
|
74
|
+
/** The input a run's step gets (#4545): the spec's step with the run's values filled in, and the run's own `input` over it. */
|
|
75
|
+
export function opWaveStepInput(spec, wave, run) {
|
|
76
|
+
if (!spec.step)
|
|
77
|
+
throw new Error("the spec names no step");
|
|
78
|
+
const { kind: _kind, ...rest } = spec.step;
|
|
79
|
+
const vars = { target: run.target, op: run.op ?? spec.op, wave: wave.name };
|
|
80
|
+
return { ...fill(rest, vars), ...(run.input ? fill(run.input, vars) : {}) };
|
|
81
|
+
}
|
|
82
|
+
/** The context a run's step plans and applies with: the spec's `labels.Env`, else the wave's name, and the run's target as the component. */
|
|
83
|
+
export function opWaveStepContext(spec, wave, run) {
|
|
84
|
+
return { env: spec.labels?.Env ?? wave.name, component: run.target };
|
|
85
|
+
}
|
|
86
|
+
const registries = new WeakMap();
|
|
87
|
+
/**
|
|
88
|
+
* The registry a job plans and applies through: `given`, else the project's
|
|
89
|
+
* at `cwd`, loaded once per `key` (the job's options) behind a dynamic
|
|
90
|
+
* import, which the wave-job runtime bundle leaves out.
|
|
91
|
+
*/
|
|
92
|
+
export function opWaveRegistry(key, cwd, given) {
|
|
93
|
+
if (given)
|
|
94
|
+
return Promise.resolve(given);
|
|
95
|
+
let found = registries.get(key);
|
|
96
|
+
if (!found) {
|
|
97
|
+
found = import("../components/fan-out-support.js").then((m) => m.fanOutRegistry(cwd));
|
|
98
|
+
registries.set(key, found);
|
|
99
|
+
}
|
|
100
|
+
return found;
|
|
101
|
+
}
|
|
102
|
+
/** Whether a part changes nothing, and whether it destroys or replaces something. */
|
|
103
|
+
export function partEffects(part) {
|
|
104
|
+
if (!part)
|
|
105
|
+
return { empty: false, destructive: false };
|
|
106
|
+
const changing = part.entries.filter((e) => e.action !== "no-op" && e.action !== "read");
|
|
107
|
+
return { empty: changing.length === 0, destructive: changing.some((e) => e.action === "delete" || e.action === "replace") };
|
|
108
|
+
}
|
|
109
|
+
function resolveCapability(registry, kind) {
|
|
110
|
+
if (!registry.has(kind))
|
|
111
|
+
throw new Error(`no capability "${kind}" is registered; the project's lexicons and capability plugins (chant.config) contribute the kinds a step can name`);
|
|
112
|
+
return registry.resolve(kind);
|
|
113
|
+
}
|
|
114
|
+
/** Plan one run through the spec's step (#4545), writing its plan file at `planPath` (relative to `cwd`) as a per-run `plan` command would. */
|
|
115
|
+
export async function planOpWaveStep(at, run) {
|
|
116
|
+
const { spec, wave, cwd, registry } = at;
|
|
117
|
+
const capability = resolveCapability(registry, spec.step.kind);
|
|
118
|
+
if (!capability.plan)
|
|
119
|
+
throw new Error(`the capability "${spec.step.kind}" cannot plan, so its runs have no plan for the wave's gate to bind`);
|
|
120
|
+
const input = opWaveStepInput(spec, wave, run);
|
|
121
|
+
let planned;
|
|
122
|
+
let lock;
|
|
123
|
+
try {
|
|
124
|
+
planned = await capability.plan({ ...opWaveStepContext(spec, wave, run), ...(at.lockGrain ? { lockGrain: at.lockGrain } : {}), ...(at.policyBase ? { policyBase: at.policyBase } : {}) }, input);
|
|
125
|
+
// #4552: the run's grain (declared at base, else its lexicon's) and, on the resource grain, the rows its apply leases.
|
|
126
|
+
lock = await resolvePlannedLock(capability, input, planned, at.lockGrain);
|
|
127
|
+
}
|
|
128
|
+
catch (err) {
|
|
129
|
+
throw new Error(`planning ${run.target} through ${spec.step.kind} failed: ${err instanceof Error ? err.message : String(err)}`);
|
|
130
|
+
}
|
|
131
|
+
if (typeof planned.planDigest !== "string" || planned.planDigest === "")
|
|
132
|
+
throw new Error(`${spec.step.kind} planned ${run.target} with no plan digest`);
|
|
133
|
+
const holes = planned.changeSet?.member.holes ?? [];
|
|
134
|
+
if (holes.length > 0 && planned.artifact === undefined) {
|
|
135
|
+
throw new Error(`${run.target} was not planned: ${holes.map((h) => h.reason).join("; ")}`);
|
|
136
|
+
}
|
|
137
|
+
const effects = partEffects(planned.changeSet);
|
|
138
|
+
// #4569: the engine's own destructive classes count too (a rewrite, a revoke), not only a delete or replace.
|
|
139
|
+
if ((planned.destructive?.length ?? 0) > 0)
|
|
140
|
+
effects.destructive = true;
|
|
141
|
+
const plan = {
|
|
142
|
+
target: run.target,
|
|
143
|
+
member: planned.member,
|
|
144
|
+
planDigest: planned.planDigest,
|
|
145
|
+
...(planned.artifact !== undefined ? { artifact: planned.artifact } : {}),
|
|
146
|
+
...(planned.changeSet ? { part: planned.changeSet } : {}),
|
|
147
|
+
...effects,
|
|
148
|
+
lock,
|
|
149
|
+
};
|
|
150
|
+
const file = join(cwd, at.planPath);
|
|
151
|
+
mkdirSync(dirname(file), { recursive: true });
|
|
152
|
+
let artifact;
|
|
153
|
+
try {
|
|
154
|
+
artifact = planned.artifact === undefined ? undefined : JSON.parse(JSON.stringify(planned.artifact));
|
|
155
|
+
}
|
|
156
|
+
catch {
|
|
157
|
+
artifact = undefined;
|
|
158
|
+
}
|
|
159
|
+
writeFileSync(file, JSON.stringify({
|
|
160
|
+
planDigest: plan.planDigest,
|
|
161
|
+
...(plan.destructive ? { destructive: true } : {}),
|
|
162
|
+
...(plan.empty ? { empty: true } : {}),
|
|
163
|
+
member: plan.member,
|
|
164
|
+
...(artifact !== undefined ? { artifact } : {}),
|
|
165
|
+
...(plan.part ? { changeSet: plan.part } : {}),
|
|
166
|
+
}) + "\n");
|
|
167
|
+
return plan;
|
|
168
|
+
}
|
|
169
|
+
/**
|
|
170
|
+
* A step's facts for its span and run record (#4555): the plan's resource
|
|
171
|
+
* counts by action, which core reads from the plan's change-set part, and
|
|
172
|
+
* whatever the capability's `traceFacts` adds. A `traceFacts` that throws
|
|
173
|
+
* is left out.
|
|
174
|
+
*/
|
|
175
|
+
export async function opWaveStepFacts(capability, input, plan, outcome) {
|
|
176
|
+
const counts = {};
|
|
177
|
+
for (const e of plan.part?.entries ?? [])
|
|
178
|
+
counts[`resources.${e.action}`] = (counts[`resources.${e.action}`] ?? 0) + 1;
|
|
179
|
+
let own;
|
|
180
|
+
try {
|
|
181
|
+
own = await capability.traceFacts?.(input, outcome);
|
|
182
|
+
}
|
|
183
|
+
catch {
|
|
184
|
+
own = undefined;
|
|
185
|
+
}
|
|
186
|
+
const attributes = { member: plan.member, kind: capability.kind, ...counts, ...(own?.attributes ?? {}) };
|
|
187
|
+
// #4615: what the engine reported per resource goes on with the rest.
|
|
188
|
+
return { attributes, ...(own?.spans?.length ? { spans: own.spans } : {}), ...(own?.resources?.length ? { resources: own.resources } : {}) };
|
|
189
|
+
}
|
|
190
|
+
/** Apply one run through the spec's step (#4545), with the plan the gate decided. */
|
|
191
|
+
export async function applyOpWaveStep(at, run, plan) {
|
|
192
|
+
const { spec, wave, registry } = at;
|
|
193
|
+
let capability;
|
|
194
|
+
try {
|
|
195
|
+
capability = resolveCapability(registry, spec.step.kind);
|
|
196
|
+
}
|
|
197
|
+
catch (err) {
|
|
198
|
+
return { outcome: "failed", reason: err instanceof Error ? err.message : String(err) };
|
|
199
|
+
}
|
|
200
|
+
const ctx = { ...opWaveStepContext(spec, wave, run), ...(plan.artifact !== undefined ? { plans: { [plan.member]: plan.artifact } } : {}) };
|
|
201
|
+
const input = opWaveStepInput(spec, wave, run);
|
|
202
|
+
try {
|
|
203
|
+
const output = await capability.run(ctx, input);
|
|
204
|
+
const facts = await opWaveStepFacts(capability, input, plan, { output });
|
|
205
|
+
return { outcome: "applied", output, ...(facts ? { facts } : {}) };
|
|
206
|
+
}
|
|
207
|
+
catch (err) {
|
|
208
|
+
const reason = err instanceof Error ? err.message : String(err);
|
|
209
|
+
const facts = await opWaveStepFacts(capability, input, plan, { error: err });
|
|
210
|
+
return { ...(isPlanMovedError(err) ? { outcome: "moved", reason } : { outcome: "failed", reason }), ...(facts ? { facts } : {}) };
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
/** The wave's change-set document (#4551) from its runs' parts, or undefined when no run gave one. */
|
|
214
|
+
export function opWaveStepChangeSet(plans) {
|
|
215
|
+
const parts = plans.flatMap((p) => (p.part ? [p.part] : []));
|
|
216
|
+
return parts.length > 0 ? composeChangeSet(parts) : undefined;
|
|
217
|
+
}
|
|
218
|
+
/**
|
|
219
|
+
* Run the workspace's `ci.policy` at `base` over each run's part (#4545).
|
|
220
|
+
* Returns each run's verdict, or a line saying why no policy runs (the base
|
|
221
|
+
* names none). Throws when the policy at base cannot be read while the
|
|
222
|
+
* checkout names one, as the pull-request path does.
|
|
223
|
+
*/
|
|
224
|
+
export async function opWavePolicyVerdicts(at, parts) {
|
|
225
|
+
const { prLoopPolicyAt, runPrPolicy } = await import("../components/pr-policy.js");
|
|
226
|
+
const read = prLoopPolicyAt(at.cwd, at.base);
|
|
227
|
+
if (!read.settings)
|
|
228
|
+
return { note: read.note ?? `holds.policy: the declaration at ${at.base.slice(0, 12)} names no ci.policy, so no policy runs` };
|
|
229
|
+
const verdicts = new Map();
|
|
230
|
+
for (const [target, part] of parts) {
|
|
231
|
+
const verdict = runPrPolicy(read, { version: 1, stage: "apply", op: at.spec.name, gate: at.gate, env: at.env, pr: null, base: at.base, head: at.head, changeSet: composeChangeSet([part]) }, at.exec);
|
|
232
|
+
if (!verdict)
|
|
233
|
+
continue;
|
|
234
|
+
const reason = verdict.result === "error" ? verdict.error : [...verdict.denials, ...verdict.holds].map((f) => f.message).filter(Boolean).join("; ") || undefined;
|
|
235
|
+
verdicts.set(target, { result: verdict.result, rules: verdict.rules, holds: [...new Set(verdict.holds.map((h) => h.rule))].sort(), ...(reason ? { reason } : {}) });
|
|
236
|
+
}
|
|
237
|
+
return { verdicts, ...(read.source ? { source: read.source } : {}) };
|
|
238
|
+
}
|
|
239
|
+
/** The monthly change an estimate gives, in `format`. Throws when it gives none. */
|
|
240
|
+
export function readCostEstimate(format, stdout) {
|
|
241
|
+
const doc = JSON.parse(stdout);
|
|
242
|
+
const num = (v) => (typeof v === "number" && Number.isFinite(v) ? v : typeof v === "string" && v.trim() !== "" && Number.isFinite(Number(v)) ? Number(v) : undefined);
|
|
243
|
+
if (format === "chant") {
|
|
244
|
+
const delta = num(doc.monthlyDelta);
|
|
245
|
+
if (delta === undefined)
|
|
246
|
+
throw new Error("the estimate has no monthlyDelta");
|
|
247
|
+
return { monthlyDelta: delta, ...(typeof doc.currency === "string" ? { currency: doc.currency } : {}) };
|
|
248
|
+
}
|
|
249
|
+
// infracost breakdown --format json: diffTotalMonthlyCost, else totalMonthlyCost less pastTotalMonthlyCost.
|
|
250
|
+
const diff = num(doc.diffTotalMonthlyCost);
|
|
251
|
+
const total = num(doc.totalMonthlyCost);
|
|
252
|
+
const past = num(doc.pastTotalMonthlyCost);
|
|
253
|
+
const delta = diff ?? (total !== undefined ? total - (past ?? 0) : undefined);
|
|
254
|
+
if (delta === undefined)
|
|
255
|
+
throw new Error("the infracost document has no diffTotalMonthlyCost or totalMonthlyCost");
|
|
256
|
+
return { monthlyDelta: delta, ...(typeof doc.currency === "string" ? { currency: doc.currency } : {}) };
|
|
257
|
+
}
|
|
258
|
+
const defaultHoldExec = (argv, cwd) => {
|
|
259
|
+
const r = spawnSync(argv[0], argv.slice(1), { cwd, encoding: "utf-8", maxBuffer: 64 * 1024 * 1024 });
|
|
260
|
+
return { status: r.error ? null : r.status, stdout: r.stdout ?? "", stderr: `${r.stderr ?? ""}${r.error ? r.error.message : ""}` };
|
|
261
|
+
};
|
|
262
|
+
/** The engine's plan document a capability's artifact names (`artifact.planJson`), when it names one that exists. */
|
|
263
|
+
export function planJsonOf(artifact, cwd) {
|
|
264
|
+
const p = artifact?.planJson;
|
|
265
|
+
if (typeof p !== "string" || p === "")
|
|
266
|
+
return undefined;
|
|
267
|
+
const path = p.startsWith("/") ? p : join(cwd, p);
|
|
268
|
+
return existsSync(path) ? path : undefined;
|
|
269
|
+
}
|
|
270
|
+
/** Price each run that changes something (#4545). A run with no estimate says why. */
|
|
271
|
+
export function opWaveCosts(hold, runs, cwd, exec = defaultHoldExec) {
|
|
272
|
+
const format = hold.format ?? "infracost";
|
|
273
|
+
const out = [];
|
|
274
|
+
for (const run of runs) {
|
|
275
|
+
if (run.empty)
|
|
276
|
+
continue;
|
|
277
|
+
const planJson = planJsonOf(run.artifact, cwd);
|
|
278
|
+
if (hold.command.some((a) => a.includes("{planJson}")) && !planJson) {
|
|
279
|
+
out.push({ target: run.target, error: "its plan names no plan document to price" });
|
|
280
|
+
continue;
|
|
281
|
+
}
|
|
282
|
+
const argv = hold.command.map((a) => a.replaceAll("{target}", run.target).replaceAll("{plan}", run.plan).replaceAll("{planJson}", planJson ?? ""));
|
|
283
|
+
const r = exec(argv, cwd);
|
|
284
|
+
if (r.status !== 0) {
|
|
285
|
+
out.push({ target: run.target, error: `${argv[0]} ${r.status === null ? "did not run" : `exited ${r.status}`}: ${(r.stderr || r.stdout).trim().split("\n").slice(-2).join(" ")}` });
|
|
286
|
+
continue;
|
|
287
|
+
}
|
|
288
|
+
try {
|
|
289
|
+
out.push({ target: run.target, ...readCostEstimate(format, r.stdout) });
|
|
290
|
+
}
|
|
291
|
+
catch (err) {
|
|
292
|
+
out.push({ target: run.target, error: `the estimate cannot be read: ${err instanceof Error ? err.message : String(err)}` });
|
|
293
|
+
}
|
|
294
|
+
}
|
|
295
|
+
return out;
|
|
296
|
+
}
|
|
297
|
+
/** Sum a wave's estimates against `approveAbove` (#4545). */
|
|
298
|
+
export function opWaveCostVerdict(hold, costs) {
|
|
299
|
+
const priced = costs.filter((c) => "monthlyDelta" in c);
|
|
300
|
+
const unestimated = costs.filter((c) => "error" in c).map((c) => c.target).sort();
|
|
301
|
+
const monthlyDelta = Math.round(priced.reduce((sum, c) => sum + c.monthlyDelta, 0) * 100) / 100;
|
|
302
|
+
const currency = hold.currency ?? priced.find((c) => c.currency)?.currency ?? "USD";
|
|
303
|
+
const member = { member: OP_WAVE_COST_MEMBER, planDigest: computePlanDigest("op-wave-cost", { approveAbove: hold.approveAbove, currency, monthlyDelta, unestimated }) };
|
|
304
|
+
const signed = `${monthlyDelta >= 0 ? "+" : ""}${monthlyDelta.toFixed(2)} ${currency}`;
|
|
305
|
+
const reasons = [];
|
|
306
|
+
if (monthlyDelta > hold.approveAbove)
|
|
307
|
+
reasons.push(`its monthly change of ${signed} is over holds.cost.approveAbove (${hold.approveAbove} ${currency})`);
|
|
308
|
+
if (unestimated.length > 0)
|
|
309
|
+
reasons.push(`${unestimated.join(", ")} could not be priced`);
|
|
310
|
+
return { monthlyDelta, currency, unestimated, member, ...(reasons.length > 0 ? { hold: `cost: ${reasons.join(", and ")}` } : {}) };
|
|
311
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Run events for one `chant run wave` job (#4555), on the run-event contract
|
|
3
|
+
* (../run-event.ts), and its trace through chant's OTLP exporter (../otlp.ts).
|
|
4
|
+
*
|
|
5
|
+
* The job is an Op run (`kind: "op"`, named for the spec). Each wave it
|
|
6
|
+
* walks is a phase `wave-<k>`, as its run record names it (#4551), and each
|
|
7
|
+
* run target is a step of that phase. A target's `step-start` and
|
|
8
|
+
* `step-settle` are written as its apply starts and ends, so a reader
|
|
9
|
+
* following the stream sees each root or stack as it applies. When the job
|
|
10
|
+
* ends, the targets it never applied (moved, blocked, waiting, or planned
|
|
11
|
+
* only) settle as `skipped`, a job that waits at a gate writes
|
|
12
|
+
* `gate-waiting` on a `gate:<name>` step of its last phase, and the phases
|
|
13
|
+
* and the run settle with the run record's verdict. The stream and the
|
|
14
|
+
* record therefore say the same thing.
|
|
15
|
+
*
|
|
16
|
+
* Under the trace, each target's span carries what its capability knew
|
|
17
|
+
* (`Capability.traceFacts`): engine facts as attributes, and a child span per
|
|
18
|
+
* resource the engine timed. When the capability reports per-resource lines
|
|
19
|
+
* (`CapabilityTraceFacts.resources`, #4615), the target's `step-settle`
|
|
20
|
+
* carries them as `resources`.
|
|
21
|
+
*/
|
|
22
|
+
import type { RunEventSink } from "../run-event-stream.js";
|
|
23
|
+
import type { CapabilityTraceFacts, RunEventTrace } from "../otlp.js";
|
|
24
|
+
import type { OpRunRecordInput } from "./runtime.js";
|
|
25
|
+
/** How one target's apply settled, as the step says it. */
|
|
26
|
+
export type OpWaveTargetSettle = "ok" | "failed" | "skipped";
|
|
27
|
+
/** One job's stream: the emitter, and the trace built from it when the exporter is on. */
|
|
28
|
+
export declare class OpWaveRunEvents {
|
|
29
|
+
private readonly sink;
|
|
30
|
+
readonly trace?: RunEventTrace | undefined;
|
|
31
|
+
private readonly phases;
|
|
32
|
+
private readonly settled;
|
|
33
|
+
constructor(sink: RunEventSink, trace?: RunEventTrace | undefined);
|
|
34
|
+
private emit;
|
|
35
|
+
private phase;
|
|
36
|
+
start(): void;
|
|
37
|
+
/** A target's apply begins. */
|
|
38
|
+
stepStart(k: number, target: string): void;
|
|
39
|
+
/** A target's apply ended, with its time and what its capability knew. */
|
|
40
|
+
stepSettle(k: number, target: string, status: OpWaveTargetSettle, durationMs: number | null, opts?: {
|
|
41
|
+
error?: string;
|
|
42
|
+
message?: string;
|
|
43
|
+
facts?: CapabilityTraceFacts;
|
|
44
|
+
}): void;
|
|
45
|
+
/**
|
|
46
|
+
* The job ended: settle what is still open from its run record, then the
|
|
47
|
+
* run. `moved` and `blocked` give the reason a skipped target says.
|
|
48
|
+
*/
|
|
49
|
+
finish(record: OpRunRecordInput, why?: {
|
|
50
|
+
moved?: readonly string[];
|
|
51
|
+
blocked?: Readonly<Record<string, string>>;
|
|
52
|
+
}): void;
|
|
53
|
+
}
|
|
54
|
+
//# sourceMappingURL=op-waves-events.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"op-waves-events.d.ts","sourceRoot":"","sources":["../../src/op/op-waves-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,2DAA2D;AAC3D,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D,0FAA0F;AAC1F,qBAAa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa;IALhC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAE7C,YACmB,IAAI,EAAE,YAAY,EAC1B,KAAK,CAAC,EAAE,aAAa,YAAA,EAC5B;IAEJ,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,KAAK;IASb,KAAK,IAAI,IAAI,CAEZ;IAED,+BAA+B;IAC/B,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGzC;IAED,0EAA0E;IAC1E,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,oBAAoB,CAAA;KAAO,GAAG,IAAI,CAiBhL;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,GAAE;QAAE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;KAAO,GAAG,IAAI,CA0C1H;CACF"}
|