@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
|
@@ -11,6 +11,32 @@
|
|
|
11
11
|
* live under `./verbs/*` as typed stubs — no cloud calls, no side effects.
|
|
12
12
|
* Cloud implementations are a later phase (see epic #551, issue #554).
|
|
13
13
|
*/
|
|
14
|
+
import { CHANT_EXIT } from "../exit-codes.js";
|
|
15
|
+
/** Each plan flag as `pr-plan` spells it (#4627). */
|
|
16
|
+
export const PLAN_FLAG_ARGS = { refresh: "--refresh", targetDependents: "--target-dependents" };
|
|
17
|
+
/**
|
|
18
|
+
* A component was asked to plan with a flag (#4627) one of its steps'
|
|
19
|
+
* capabilities refuses. Nothing in the component plans.
|
|
20
|
+
*/
|
|
21
|
+
export class PlanFlagRefusedError extends Error {
|
|
22
|
+
constructor(component, kind, flag, reason) {
|
|
23
|
+
super(`component "${component}": ${kind} refuses ${PLAN_FLAG_ARGS[flag]}: ${reason}`);
|
|
24
|
+
this.component = component;
|
|
25
|
+
this.kind = kind;
|
|
26
|
+
this.flag = flag;
|
|
27
|
+
this.reason = reason;
|
|
28
|
+
this.name = "PlanFlagRefusedError";
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
/** Why `capability` refuses `flag`, or `undefined` when it accepts it (#4627). */
|
|
32
|
+
export function planFlagRefusal(capability, flag) {
|
|
33
|
+
const t = capability.planFlags?.[flag];
|
|
34
|
+
if (t === "accept")
|
|
35
|
+
return undefined;
|
|
36
|
+
if (t && typeof t === "object" && typeof t.refuse === "string")
|
|
37
|
+
return t.refuse;
|
|
38
|
+
return `${capability.kind} does not say it can plan with ${PLAN_FLAG_ARGS[flag]}`;
|
|
39
|
+
}
|
|
14
40
|
/**
|
|
15
41
|
* A component was asked to narrow to targets (#4300) and one of its steps'
|
|
16
42
|
* capabilities refuses them. Nothing in the component plans or runs.
|
|
@@ -35,16 +61,23 @@ export function targetRefusal(capability) {
|
|
|
35
61
|
}
|
|
36
62
|
/**
|
|
37
63
|
* The exit code of a command whose capability step refused a plan that moved
|
|
38
|
-
* since it was approved:
|
|
39
|
-
*
|
|
64
|
+
* since it was approved: `CHANT_EXIT.moved`, 4, the code `pr-apply` gives a
|
|
65
|
+
* moved digest (#3997, #4553). Before #4553 it was 3, a gate's code.
|
|
66
|
+
*/
|
|
67
|
+
export const PLAN_MOVED_EXIT_CODE = CHANT_EXIT.moved;
|
|
68
|
+
/**
|
|
69
|
+
* The moved-plan code before #4553. A lexicon built against an older core
|
|
70
|
+
* may still set it on the error it throws for a moved plan; read for one
|
|
71
|
+
* release, then dropped.
|
|
40
72
|
*/
|
|
41
|
-
|
|
73
|
+
const LEGACY_PLAN_MOVED_EXIT_CODE = 3;
|
|
42
74
|
/**
|
|
43
75
|
* Whether `err` is a `run`'s refusal to apply a plan from
|
|
44
76
|
* `DeployContext.plans` because the target moved since it was planned
|
|
45
77
|
* (#3997). The mark is a `planMoved: true` property, not a class, so a
|
|
46
|
-
* lexicon built against an older core can set it. An `exitCode` of
|
|
47
|
-
*
|
|
78
|
+
* lexicon built against an older core can set it. An `exitCode` of 3 on
|
|
79
|
+
* the error, the moved code before #4553, is the same mark for one more
|
|
80
|
+
* release; a lexicon sets `planMoved` and core picks the number. Any other
|
|
48
81
|
* `exitCode` is ignored: a failed step exits 1, so a capability can't pick
|
|
49
82
|
* the process's exit code.
|
|
50
83
|
*/
|
|
@@ -52,7 +85,7 @@ export function isPlanMovedError(err) {
|
|
|
52
85
|
if (typeof err !== "object" || err === null)
|
|
53
86
|
return false;
|
|
54
87
|
const e = err;
|
|
55
|
-
return e.planMoved === true || e.exitCode ===
|
|
88
|
+
return e.planMoved === true || e.exitCode === LEGACY_PLAN_MOVED_EXIT_CODE;
|
|
56
89
|
}
|
|
57
90
|
/**
|
|
58
91
|
* Thrown by a stub `run`/`rollback` — the verb is specified and typed but has
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The check moment (#4556): `ci.hooks.check` in the workspace declaration,
|
|
3
|
+
* run by a product's check job, terragucci's and plywood's alike, with the
|
|
4
|
+
* runner the other moments use (`runStageHooks`). Nothing here knows an
|
|
5
|
+
* engine: a hook is the user's own tool (tflint, checkov, trivy,
|
|
6
|
+
* pre-commit), and the product switches it on with a preset.
|
|
7
|
+
*
|
|
8
|
+
* - The hooks are read from the declaration at the base the check measures
|
|
9
|
+
* the change from, never from the change itself, so a change cannot remove
|
|
10
|
+
* a required check. The top level's run first, then the member's.
|
|
11
|
+
* - A hook runs once for the check, or once per target with `perRun`;
|
|
12
|
+
* `{target}` and `CHANT_TARGET` name it, and `targets` match the targets'
|
|
13
|
+
* names. There is no `{plan}`, and `onFailure` is `fail`.
|
|
14
|
+
* - A hook runs with no forge token, no OIDC request variables and no cloud
|
|
15
|
+
* credentials in its environment ({@link checkHookEnv}).
|
|
16
|
+
*
|
|
17
|
+
* {@link writeCiHook} is the writer a product's `init` calls to add a hook to
|
|
18
|
+
* `ci.hooks`, keeping the declaration's formatting.
|
|
19
|
+
*/
|
|
20
|
+
import { CHECK_HOOK_MOMENT, type OpWaveHook } from "../op/op-waves.js";
|
|
21
|
+
import { type OpWaveExec } from "../op/stage-hooks.js";
|
|
22
|
+
import { type Declaration } from "../workspace/declaration.js";
|
|
23
|
+
import type { CheckStepOutcome } from "./check-steps.js";
|
|
24
|
+
export { CI_CHECK_HOOK_FLOOR } from "../op/op-waves.js";
|
|
25
|
+
/** The check hooks a job runs, and where they were read. */
|
|
26
|
+
export interface CheckHooksRead {
|
|
27
|
+
hooks: OpWaveHook[];
|
|
28
|
+
/** The commit they were read at. */
|
|
29
|
+
base: string;
|
|
30
|
+
/** A line for the log when none run because the base has no declaration, or could not be read. */
|
|
31
|
+
note?: string;
|
|
32
|
+
}
|
|
33
|
+
/** The check hooks `declaration` gives a job run in a member (or at the top, `null`): the top level's, then the member's. */
|
|
34
|
+
export declare function checkHooksOf(declaration: Pick<Declaration, "ci" | "members">, member: string | null): OpWaveHook[];
|
|
35
|
+
/**
|
|
36
|
+
* The check hooks a job in `cwd` runs, read from the workspace declaration at
|
|
37
|
+
* `base`. Throws when the declaration at base cannot be read and the working
|
|
38
|
+
* tree's names check hooks, as the pull-request jobs do for their hooks.
|
|
39
|
+
*/
|
|
40
|
+
export declare function checkHooksAt(cwd: string, base: string): CheckHooksRead;
|
|
41
|
+
/**
|
|
42
|
+
* The environment a check hook runs with (#4556): `env` without a forge
|
|
43
|
+
* token, the OIDC request variables, or cloud credentials, and without any
|
|
44
|
+
* `TF_TOKEN_<host>` registry token. A check reads the change and nothing
|
|
45
|
+
* else.
|
|
46
|
+
*/
|
|
47
|
+
export declare function checkHookEnv(env?: NodeJS.ProcessEnv): Record<string, string>;
|
|
48
|
+
/** {@link OpWaveExec} with {@link checkHookEnv} in place of the job's environment. */
|
|
49
|
+
export declare const checkHookExec: OpWaveExec;
|
|
50
|
+
/** One check hook's run, as the check report lists it. */
|
|
51
|
+
export interface CheckHookOutcome {
|
|
52
|
+
name: string;
|
|
53
|
+
/** The target, for a `perRun` hook. */
|
|
54
|
+
target?: string;
|
|
55
|
+
exit: number;
|
|
56
|
+
outcome: "passed" | "failed" | "skipped";
|
|
57
|
+
reason?: string;
|
|
58
|
+
}
|
|
59
|
+
/** What the check hooks came to, for the product's check report. */
|
|
60
|
+
export interface CheckHooksReport {
|
|
61
|
+
version: 1;
|
|
62
|
+
moment: typeof CHECK_HOOK_MOMENT;
|
|
63
|
+
/** The commit the hooks were read at. */
|
|
64
|
+
base: string;
|
|
65
|
+
targets: string[];
|
|
66
|
+
/** `none`: no check hook is declared at base. */
|
|
67
|
+
status: "passed" | "failed" | "none";
|
|
68
|
+
hooks: CheckHookOutcome[];
|
|
69
|
+
/** The lexicons' check steps (#4633, `./check-steps.ts`), when any ran. */
|
|
70
|
+
steps?: CheckStepOutcome[];
|
|
71
|
+
/** The first hook that failed, and why; the hooks after it did not run. Or the check steps that failed. */
|
|
72
|
+
failed?: string;
|
|
73
|
+
note?: string;
|
|
74
|
+
}
|
|
75
|
+
/** Where {@link runCheckHooks} writes its runs file and report unless told: `.chant/check`. */
|
|
76
|
+
export declare const CHECK_HOOKS_DIR = ".chant/check";
|
|
77
|
+
/** The report file under the directory. */
|
|
78
|
+
export declare const CHECK_HOOKS_REPORT_FILE = "check-hooks.json";
|
|
79
|
+
export interface RunCheckHooksOptions {
|
|
80
|
+
/** The commit to read `ci.hooks.check` at: the base the change is measured from. */
|
|
81
|
+
base: string;
|
|
82
|
+
/** The targets the change touches (roots, stacks or components), for `perRun` hooks and `targets`. */
|
|
83
|
+
targets?: readonly string[];
|
|
84
|
+
/** Default the working directory. */
|
|
85
|
+
cwd?: string;
|
|
86
|
+
/** Where the runs file and the report go, relative to `cwd`. Default {@link CHECK_HOOKS_DIR}. */
|
|
87
|
+
dir?: string;
|
|
88
|
+
/** The hooks, when the caller read them itself. Default {@link checkHooksAt} `base`. */
|
|
89
|
+
read?: CheckHooksRead;
|
|
90
|
+
/** Added to every hook's environment, after {@link checkHookEnv}. */
|
|
91
|
+
env?: Record<string, string>;
|
|
92
|
+
/** Default {@link checkHookExec}. */
|
|
93
|
+
exec?: OpWaveExec;
|
|
94
|
+
log?: (line: string) => void;
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Run the check hooks (#4556): each once, or once per target with
|
|
98
|
+
* `perRun`, in order, stopping at the first that fails. Writes the runs file
|
|
99
|
+
* (`{runs}`, `CHANT_RUNS`) and the report under `dir`, and returns the
|
|
100
|
+
* report.
|
|
101
|
+
*/
|
|
102
|
+
export declare function runCheckHooks(options: RunCheckHooksOptions): CheckHooksReport;
|
|
103
|
+
/**
|
|
104
|
+
* Add `hook` to `ci.hooks.<moment>` of the workspace declaration at `root`
|
|
105
|
+
* (#4556), the top level's or `member`'s, keeping the file's formatting. A
|
|
106
|
+
* hook of the same `name` at that moment is replaced, so a product's `init`
|
|
107
|
+
* can run again. Refuses a check hook the check job could not run. Returns
|
|
108
|
+
* the declaration file it wrote.
|
|
109
|
+
*/
|
|
110
|
+
export declare function writeCiHook(root: string, moment: "check", hook: OpWaveHook, opts?: {
|
|
111
|
+
member?: string;
|
|
112
|
+
}): {
|
|
113
|
+
file: string;
|
|
114
|
+
replaced: boolean;
|
|
115
|
+
};
|
|
116
|
+
//# sourceMappingURL=check-hooks.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"check-hooks.d.ts","sourceRoot":"","sources":["../../src/components/check-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAE,iBAAiB,EAAkC,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAiB,KAAK,UAAU,EAAsB,MAAM,mBAAmB,CAAC;AAGvF,OAAO,EAA0D,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAKpH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6HAA6H;AAC7H,wBAAgB,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,UAAU,EAAE,CAGlH;AAaD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAiBtE;AAUD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQzF;AAED,sFAAsF;AACtF,eAAO,MAAM,aAAa,EAAE,UAI3B,CAAC;AAEF,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oEAAoE;AACpE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,OAAO,iBAAiB,CAAC;IACjC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACrC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,2EAA2E;IAC3E,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,2GAA2G;IAC3G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,+FAA+F;AAC/F,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,2CAA2C;AAC3C,eAAO,MAAM,uBAAuB,qBAAqB,CAAC;AAE1D,MAAM,WAAW,oBAAoB;IACnC,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,sGAAsG;IACtG,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iGAAiG;IACjG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wFAAwF;IACxF,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,qCAAqC;IACrC,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,gBAAgB,CAwC7E;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,EACf,IAAI,EAAE,UAAU,EAChB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CA0BrC"}
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The check moment (#4556): `ci.hooks.check` in the workspace declaration,
|
|
3
|
+
* run by a product's check job, terragucci's and plywood's alike, with the
|
|
4
|
+
* runner the other moments use (`runStageHooks`). Nothing here knows an
|
|
5
|
+
* engine: a hook is the user's own tool (tflint, checkov, trivy,
|
|
6
|
+
* pre-commit), and the product switches it on with a preset.
|
|
7
|
+
*
|
|
8
|
+
* - The hooks are read from the declaration at the base the check measures
|
|
9
|
+
* the change from, never from the change itself, so a change cannot remove
|
|
10
|
+
* a required check. The top level's run first, then the member's.
|
|
11
|
+
* - A hook runs once for the check, or once per target with `perRun`;
|
|
12
|
+
* `{target}` and `CHANT_TARGET` name it, and `targets` match the targets'
|
|
13
|
+
* names. There is no `{plan}`, and `onFailure` is `fail`.
|
|
14
|
+
* - A hook runs with no forge token, no OIDC request variables and no cloud
|
|
15
|
+
* credentials in its environment ({@link checkHookEnv}).
|
|
16
|
+
*
|
|
17
|
+
* {@link writeCiHook} is the writer a product's `init` calls to add a hook to
|
|
18
|
+
* `ci.hooks`, keeping the declaration's formatting.
|
|
19
|
+
*/
|
|
20
|
+
import { spawnSync } from "node:child_process";
|
|
21
|
+
import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
|
|
22
|
+
import { join, relative, resolve } from "node:path";
|
|
23
|
+
import { CHECK_HOOK_MOMENT, assertCheckHooks } from "../op/op-waves.js";
|
|
24
|
+
import { runStageHooks } from "../op/stage-hooks.js";
|
|
25
|
+
import { FORGE_TOKEN_VARS } from "../ci-handover.js";
|
|
26
|
+
import { OIDC_REQUEST_VARS, TRADED_VARS } from "../ci-identity.js";
|
|
27
|
+
import { DECLARATION_FILES, readDeclaration, WorkspaceReadError } from "../workspace/declaration.js";
|
|
28
|
+
import { setProperty, valueAt } from "../workspace/json-edit.js";
|
|
29
|
+
import { parseJsonText } from "../workspace/jsonc.js";
|
|
30
|
+
import { memberAtCwd } from "../workspace/security.js";
|
|
31
|
+
import { locateWorkspace } from "../workspace/which-chant.js";
|
|
32
|
+
export { CI_CHECK_HOOK_FLOOR } from "../op/op-waves.js";
|
|
33
|
+
/** The check hooks `declaration` gives a job run in a member (or at the top, `null`): the top level's, then the member's. */
|
|
34
|
+
export function checkHooksOf(declaration, member) {
|
|
35
|
+
const own = member === null ? null : (declaration.members.find((m) => m.name === member)?.ciHooks ?? null);
|
|
36
|
+
return [...(declaration.ci?.hooks?.check ?? []), ...(own?.check ?? [])];
|
|
37
|
+
}
|
|
38
|
+
/** Whether the working tree's declaration names any check hook. */
|
|
39
|
+
function checkoutNamesCheckHooks(cwd) {
|
|
40
|
+
try {
|
|
41
|
+
const located = locateWorkspace(cwd);
|
|
42
|
+
const d = readDeclaration(located.tree);
|
|
43
|
+
return checkHooksOf(d, memberAtCwd({ declaration: d, rootOnDisk: located.rootOnDisk }, cwd)).length > 0;
|
|
44
|
+
}
|
|
45
|
+
catch {
|
|
46
|
+
return false;
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* The check hooks a job in `cwd` runs, read from the workspace declaration at
|
|
51
|
+
* `base`. Throws when the declaration at base cannot be read and the working
|
|
52
|
+
* tree's names check hooks, as the pull-request jobs do for their hooks.
|
|
53
|
+
*/
|
|
54
|
+
export function checkHooksAt(cwd, base) {
|
|
55
|
+
let declaration;
|
|
56
|
+
let rootOnDisk;
|
|
57
|
+
try {
|
|
58
|
+
const located = locateWorkspace(cwd, base);
|
|
59
|
+
declaration = readDeclaration(located.tree);
|
|
60
|
+
rootOnDisk = located.rootOnDisk;
|
|
61
|
+
}
|
|
62
|
+
catch (err) {
|
|
63
|
+
const missing = err instanceof WorkspaceReadError && (err.code === "declaration-missing" || err.code === "not-a-git-repository");
|
|
64
|
+
const why = err instanceof Error ? err.message : String(err);
|
|
65
|
+
if (checkoutNamesCheckHooks(cwd)) {
|
|
66
|
+
if (missing)
|
|
67
|
+
return { hooks: [], base, note: `ci.hooks.check: the base ${base.slice(0, 12)} has no workspace declaration, so the check hooks this change declares do not run until it merges` };
|
|
68
|
+
throw new Error(`ci.hooks.check is read from the workspace declaration at ${base.slice(0, 12)}, and it could not be read (${why}), so no check hook can be trusted to run`);
|
|
69
|
+
}
|
|
70
|
+
return missing ? { hooks: [], base } : { hooks: [], base, note: `ci.hooks.check: the declaration at ${base.slice(0, 12)} could not be read (${why}); this checkout names no check hooks, so none run` };
|
|
71
|
+
}
|
|
72
|
+
return { hooks: checkHooksOf(declaration, memberAtCwd({ declaration, rootOnDisk }, cwd)), base };
|
|
73
|
+
}
|
|
74
|
+
/** Variables that hold cloud credentials beyond the ones chant's own trade sets. */
|
|
75
|
+
const CLOUD_CREDENTIAL_VARS = [
|
|
76
|
+
"AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_SESSION_TOKEN", "AWS_SECURITY_TOKEN", "AWS_WEB_IDENTITY_TOKEN_FILE", "AWS_ROLE_ARN", "AWS_PROFILE", "AWS_CONTAINER_CREDENTIALS_FULL_URI", "AWS_CONTAINER_CREDENTIALS_RELATIVE_URI", "AWS_CONTAINER_AUTHORIZATION_TOKEN",
|
|
77
|
+
"GOOGLE_APPLICATION_CREDENTIALS", "GOOGLE_CREDENTIALS", "GOOGLE_OAUTH_ACCESS_TOKEN", "CLOUDSDK_AUTH_ACCESS_TOKEN", "CLOUDSDK_AUTH_CREDENTIAL_FILE_OVERRIDE",
|
|
78
|
+
"AZURE_CLIENT_SECRET", "AZURE_CLIENT_CERTIFICATE_PATH", "AZURE_FEDERATED_TOKEN_FILE", "AZURE_ACCESS_TOKEN", "ARM_CLIENT_SECRET", "ARM_CLIENT_CERTIFICATE_PATH", "ARM_OIDC_TOKEN", "ARM_OIDC_TOKEN_FILE_PATH", "ARM_ACCESS_KEY", "ARM_SAS_TOKEN",
|
|
79
|
+
"PULUMI_ACCESS_TOKEN", "PULUMI_CONFIG_PASSPHRASE", "TFE_TOKEN", "TF_TOKEN_app_terraform_io",
|
|
80
|
+
];
|
|
81
|
+
/**
|
|
82
|
+
* The environment a check hook runs with (#4556): `env` without a forge
|
|
83
|
+
* token, the OIDC request variables, or cloud credentials, and without any
|
|
84
|
+
* `TF_TOKEN_<host>` registry token. A check reads the change and nothing
|
|
85
|
+
* else.
|
|
86
|
+
*/
|
|
87
|
+
export function checkHookEnv(env = process.env) {
|
|
88
|
+
const drop = new Set([...FORGE_TOKEN_VARS, ...OIDC_REQUEST_VARS, ...Object.values(TRADED_VARS).flat(), ...CLOUD_CREDENTIAL_VARS]);
|
|
89
|
+
const out = {};
|
|
90
|
+
for (const [name, value] of Object.entries(env)) {
|
|
91
|
+
if (value === undefined || drop.has(name) || name.startsWith("TF_TOKEN_"))
|
|
92
|
+
continue;
|
|
93
|
+
out[name] = value;
|
|
94
|
+
}
|
|
95
|
+
return out;
|
|
96
|
+
}
|
|
97
|
+
/** {@link OpWaveExec} with {@link checkHookEnv} in place of the job's environment. */
|
|
98
|
+
export const checkHookExec = (argv, cwd, env) => {
|
|
99
|
+
const result = spawnSync(argv[0], argv.slice(1), { cwd, stdio: "inherit", env: { ...checkHookEnv(), ...env } });
|
|
100
|
+
if (result.error)
|
|
101
|
+
throw result.error;
|
|
102
|
+
return result.status ?? 1;
|
|
103
|
+
};
|
|
104
|
+
/** Where {@link runCheckHooks} writes its runs file and report unless told: `.chant/check`. */
|
|
105
|
+
export const CHECK_HOOKS_DIR = ".chant/check";
|
|
106
|
+
/** The report file under the directory. */
|
|
107
|
+
export const CHECK_HOOKS_REPORT_FILE = "check-hooks.json";
|
|
108
|
+
/**
|
|
109
|
+
* Run the check hooks (#4556): each once, or once per target with
|
|
110
|
+
* `perRun`, in order, stopping at the first that fails. Writes the runs file
|
|
111
|
+
* (`{runs}`, `CHANT_RUNS`) and the report under `dir`, and returns the
|
|
112
|
+
* report.
|
|
113
|
+
*/
|
|
114
|
+
export function runCheckHooks(options) {
|
|
115
|
+
const cwd = options.cwd ?? process.cwd();
|
|
116
|
+
const log = options.log ?? ((line) => console.error(line));
|
|
117
|
+
const read = options.read ?? checkHooksAt(cwd, options.base);
|
|
118
|
+
if (read.note)
|
|
119
|
+
log(read.note);
|
|
120
|
+
const targets = [...(options.targets ?? [])];
|
|
121
|
+
const dir = relative(cwd, resolve(cwd, options.dir ?? CHECK_HOOKS_DIR)) || ".";
|
|
122
|
+
mkdirSync(join(cwd, dir), { recursive: true });
|
|
123
|
+
const report = (r) => {
|
|
124
|
+
const doc = { version: 1, moment: CHECK_HOOK_MOMENT, base: read.base, targets, ...r, ...(read.note ? { note: read.note } : {}) };
|
|
125
|
+
writeFileSync(join(cwd, dir, CHECK_HOOKS_REPORT_FILE), JSON.stringify(doc, null, 2) + "\n");
|
|
126
|
+
return doc;
|
|
127
|
+
};
|
|
128
|
+
if (read.hooks.length === 0)
|
|
129
|
+
return report({ status: "none", hooks: [] });
|
|
130
|
+
assertCheckHooks("ci.hooks at base", read.hooks);
|
|
131
|
+
const op = "check";
|
|
132
|
+
const runs = targets.map((target) => ({ target, op }));
|
|
133
|
+
const runsFile = join(dir, "runs.json");
|
|
134
|
+
writeFileSync(join(cwd, runsFile), JSON.stringify({ version: 1, op, stage: "check", base: read.base, hook: CHECK_HOOK_MOMENT, runs }, null, 2) + "\n");
|
|
135
|
+
const ran = runStageHooks(CHECK_HOOK_MOMENT, read.hooks, {
|
|
136
|
+
name: op,
|
|
137
|
+
op,
|
|
138
|
+
wave: op,
|
|
139
|
+
runs,
|
|
140
|
+
runsFile,
|
|
141
|
+
holdFile: join(dir, "hold.json"),
|
|
142
|
+
env: { CHANT_CHECK: "1", CHANT_HOOKS_BASE: read.base, ...options.env },
|
|
143
|
+
cwd,
|
|
144
|
+
exec: options.exec ?? checkHookExec,
|
|
145
|
+
log,
|
|
146
|
+
});
|
|
147
|
+
const hooks = ran.outcomes.map((o) => ({
|
|
148
|
+
name: o.name,
|
|
149
|
+
...(o.target ? { target: o.target } : {}),
|
|
150
|
+
exit: o.exit,
|
|
151
|
+
outcome: o.outcome === "skipped" ? "skipped" : o.outcome === "passed" ? "passed" : "failed",
|
|
152
|
+
...(o.reason ? { reason: o.reason } : {}),
|
|
153
|
+
}));
|
|
154
|
+
const failed = ran.failed ?? (hooks.some((h) => h.outcome === "failed") ? `a check hook failed: ${hooks.filter((h) => h.outcome === "failed").map((h) => h.name).join(", ")}` : undefined);
|
|
155
|
+
return report({ status: failed ? "failed" : "passed", hooks, ...(failed ? { failed } : {}) });
|
|
156
|
+
}
|
|
157
|
+
/**
|
|
158
|
+
* Add `hook` to `ci.hooks.<moment>` of the workspace declaration at `root`
|
|
159
|
+
* (#4556), the top level's or `member`'s, keeping the file's formatting. A
|
|
160
|
+
* hook of the same `name` at that moment is replaced, so a product's `init`
|
|
161
|
+
* can run again. Refuses a check hook the check job could not run. Returns
|
|
162
|
+
* the declaration file it wrote.
|
|
163
|
+
*/
|
|
164
|
+
export function writeCiHook(root, moment, hook, opts = {}) {
|
|
165
|
+
assertCheckHooks(`ci.hooks.${moment}`, [hook]);
|
|
166
|
+
const file = DECLARATION_FILES.map((f) => join(root, f)).find((f) => existsSync(f));
|
|
167
|
+
if (!file)
|
|
168
|
+
throw new Error(`no workspace declaration at ${root}; create one before adding ci.hooks`);
|
|
169
|
+
const jsonc = file.endsWith(".jsonc");
|
|
170
|
+
const text = readFileSync(file, "utf-8");
|
|
171
|
+
const parsed = parseJsonText(text, { jsonc });
|
|
172
|
+
if (!parsed.ok)
|
|
173
|
+
throw new Error(`${file} is not valid JSON${jsonc ? "C" : ""}: ${parsed.message}`);
|
|
174
|
+
const doc = parsed.value;
|
|
175
|
+
let owner = "";
|
|
176
|
+
if (opts.member !== undefined) {
|
|
177
|
+
const index = (doc.members ?? []).findIndex((m) => m?.name === opts.member);
|
|
178
|
+
if (index < 0)
|
|
179
|
+
throw new Error(`the workspace declaration names no member ${JSON.stringify(opts.member)}`);
|
|
180
|
+
owner = `/members/${index}`;
|
|
181
|
+
}
|
|
182
|
+
const ci = valueAt(doc, `${owner}/ci`);
|
|
183
|
+
const current = ci?.hooks?.[moment] ?? [];
|
|
184
|
+
const name = hook.name ?? hook.command.join(" ");
|
|
185
|
+
const at = current.findIndex((h) => (h.name ?? h.command.join(" ")) === name);
|
|
186
|
+
const next = at < 0 ? [...current, hook] : current.map((h, i) => (i === at ? hook : h));
|
|
187
|
+
const written = ci === undefined ? setProperty(text, jsonc, owner, "ci", { hooks: { [moment]: next } })
|
|
188
|
+
: ci.hooks === undefined ? setProperty(text, jsonc, `${owner}/ci`, "hooks", { [moment]: next })
|
|
189
|
+
: setProperty(text, jsonc, `${owner}/ci/hooks`, moment, next);
|
|
190
|
+
writeFileSync(file, written);
|
|
191
|
+
return { file, replaced: at >= 0 };
|
|
192
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
import { type CheckHooksReport, type RunCheckHooksOptions } from "./check-hooks.js";
|
|
2
|
+
/** A workspace member a lexicon's check steps run for. */
|
|
3
|
+
export interface CheckStageMember {
|
|
4
|
+
name: string;
|
|
5
|
+
/** The member's directory, absolute. */
|
|
6
|
+
dir: string;
|
|
7
|
+
kind: string;
|
|
8
|
+
/** The values the declaration sets for the kind's fields, or null. */
|
|
9
|
+
fields: Record<string, unknown> | null;
|
|
10
|
+
}
|
|
11
|
+
/** One check step's run, as the check report lists it. */
|
|
12
|
+
export interface CheckStepOutcome {
|
|
13
|
+
/** The lexicon that gave the step. */
|
|
14
|
+
lexicon: string;
|
|
15
|
+
/** The step's name, such as `pulumi-install`. */
|
|
16
|
+
step: string;
|
|
17
|
+
member: string;
|
|
18
|
+
/** The stack, for a step that runs per stack. */
|
|
19
|
+
stack?: string;
|
|
20
|
+
/** The engine's exit status, or 0 for a step that runs no command; 1 for a failure that ran none. */
|
|
21
|
+
exit: number;
|
|
22
|
+
outcome: "passed" | "failed" | "skipped";
|
|
23
|
+
/** Why it failed or was skipped, naming the member and stack. */
|
|
24
|
+
reason?: string;
|
|
25
|
+
/** What the step read, for the report (the engine, plugins and backend for `pulumi about`). */
|
|
26
|
+
detail?: unknown;
|
|
27
|
+
}
|
|
28
|
+
export interface CheckStepsContext {
|
|
29
|
+
/** The members of the adapter's kinds the check covers. */
|
|
30
|
+
members: CheckStageMember[];
|
|
31
|
+
/** The check job's working directory. */
|
|
32
|
+
cwd: string;
|
|
33
|
+
/** The environment a step runs with: {@link checkHookEnv} of the job's. */
|
|
34
|
+
env: Record<string, string>;
|
|
35
|
+
log: (line: string) => void;
|
|
36
|
+
}
|
|
37
|
+
/** What a lexicon gives the check stage. */
|
|
38
|
+
export interface CheckStepsAdapter {
|
|
39
|
+
/** The lexicon's name, for the report. */
|
|
40
|
+
lexicon: string;
|
|
41
|
+
/** The member kinds it has steps for. */
|
|
42
|
+
kinds: readonly string[];
|
|
43
|
+
/** Run the steps for each member, in order, and return every outcome. A step that fails does not stop another member's. */
|
|
44
|
+
run(ctx: CheckStepsContext): Promise<CheckStepOutcome[]>;
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* The working tree's members a check covers: every member with a directory
|
|
48
|
+
* (a `repo` member has none), or those a target names by member name or
|
|
49
|
+
* directory when there are targets. Empty when there is no declaration.
|
|
50
|
+
*/
|
|
51
|
+
export declare function checkStageMembers(cwd: string, targets?: readonly string[]): CheckStageMember[];
|
|
52
|
+
export interface RunCheckStepsOptions {
|
|
53
|
+
adapters: readonly CheckStepsAdapter[];
|
|
54
|
+
/** Default {@link checkStageMembers} of `cwd` and `targets`. */
|
|
55
|
+
members?: CheckStageMember[];
|
|
56
|
+
targets?: readonly string[];
|
|
57
|
+
cwd?: string;
|
|
58
|
+
/** Default {@link checkHookEnv} of the process's environment. */
|
|
59
|
+
env?: Record<string, string>;
|
|
60
|
+
log?: (line: string) => void;
|
|
61
|
+
}
|
|
62
|
+
/** Run every adapter's steps for the members of its kinds, adapter by adapter. */
|
|
63
|
+
export declare function runCheckSteps(options: RunCheckStepsOptions): Promise<CheckStepOutcome[]>;
|
|
64
|
+
/**
|
|
65
|
+
* The check stage (#4556, #4633): the `ci.hooks.check` hooks at base, then,
|
|
66
|
+
* unless a hook failed, the lexicons' check steps. Writes one report with
|
|
67
|
+
* both under `dir` and returns it; `status` is `none` only when no hook is
|
|
68
|
+
* declared and no step ran.
|
|
69
|
+
*/
|
|
70
|
+
export declare function runCheckStage(options: RunCheckHooksOptions & {
|
|
71
|
+
adapters: readonly CheckStepsAdapter[];
|
|
72
|
+
members?: CheckStageMember[];
|
|
73
|
+
}): Promise<CheckHooksReport>;
|
|
74
|
+
//# sourceMappingURL=check-steps.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"check-steps.d.ts","sourceRoot":"","sources":["../../src/components/check-steps.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAyE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAExJ,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACxC;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qGAAqG;IACrG,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+FAA+F;IAC/F,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,2HAA2H;IAC3H,GAAG,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CAC1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO,GAAG,gBAAgB,EAAE,CAclG;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACvC,gEAAgE;IAChE,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,kFAAkF;AAClF,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAiB9F;AASD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG;IAAE,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;CAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmBvK"}
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Engine check steps in the check stage (#4633). A lexicon gives the check
|
|
3
|
+
* stage steps of its own for the workspace members of its kinds
|
|
4
|
+
* (`LexiconPlugin.checkSteps`): the pulumi lexicon's `pulumi install`, a
|
|
5
|
+
* stack config check and `pulumi about --json` for each pulumi member. They
|
|
6
|
+
* run after the `ci.hooks.check` hooks (`./check-hooks.ts`), in the same
|
|
7
|
+
* check job, with the same environment: no forge token, no OIDC request
|
|
8
|
+
* variables, no cloud credentials ({@link checkHookEnv}).
|
|
9
|
+
*
|
|
10
|
+
* The steps are the lexicon's, so a product's check (`plywood check`,
|
|
11
|
+
* `terragucci check`) gets them through `chant ci check` with no change of
|
|
12
|
+
* its own. Each step's outcome goes in the check report beside the hooks',
|
|
13
|
+
* and a failed step fails the check with chant's `failed` code, naming the
|
|
14
|
+
* member and, where it has one, the stack.
|
|
15
|
+
*
|
|
16
|
+
* The members are read from the working tree's declaration. The hooks are
|
|
17
|
+
* read at base so a change cannot drop a required check; a step is part of
|
|
18
|
+
* the lexicon, so there is nothing for a change to remove.
|
|
19
|
+
*/
|
|
20
|
+
import { writeFileSync } from "node:fs";
|
|
21
|
+
import { join, relative, resolve } from "node:path";
|
|
22
|
+
import { readDeclaration } from "../workspace/declaration.js";
|
|
23
|
+
import { locateWorkspace } from "../workspace/which-chant.js";
|
|
24
|
+
import { CHECK_HOOKS_DIR, CHECK_HOOKS_REPORT_FILE, checkHookEnv, runCheckHooks } from "./check-hooks.js";
|
|
25
|
+
/**
|
|
26
|
+
* The working tree's members a check covers: every member with a directory
|
|
27
|
+
* (a `repo` member has none), or those a target names by member name or
|
|
28
|
+
* directory when there are targets. Empty when there is no declaration.
|
|
29
|
+
*/
|
|
30
|
+
export function checkStageMembers(cwd, targets = []) {
|
|
31
|
+
let located;
|
|
32
|
+
let members;
|
|
33
|
+
try {
|
|
34
|
+
located = locateWorkspace(cwd);
|
|
35
|
+
members = readDeclaration(located.tree).members;
|
|
36
|
+
}
|
|
37
|
+
catch {
|
|
38
|
+
return [];
|
|
39
|
+
}
|
|
40
|
+
const wanted = new Set(targets.map((t) => t.replace(/^\.\//, "").replace(/\/+$/, "")));
|
|
41
|
+
return members
|
|
42
|
+
.filter((m) => m.kind !== "repo")
|
|
43
|
+
.filter((m) => wanted.size === 0 || wanted.has(m.name) || wanted.has(m.dir.replace(/^\.\//, "").replace(/\/+$/, "")))
|
|
44
|
+
.map((m) => ({ name: m.name, dir: resolve(located.rootOnDisk, m.dir), kind: m.kind, fields: m.fields }));
|
|
45
|
+
}
|
|
46
|
+
/** Run every adapter's steps for the members of its kinds, adapter by adapter. */
|
|
47
|
+
export async function runCheckSteps(options) {
|
|
48
|
+
const cwd = options.cwd ?? process.cwd();
|
|
49
|
+
const log = options.log ?? ((line) => console.error(line));
|
|
50
|
+
const members = options.members ?? checkStageMembers(cwd, options.targets);
|
|
51
|
+
const env = options.env ?? checkHookEnv();
|
|
52
|
+
const out = [];
|
|
53
|
+
for (const adapter of options.adapters) {
|
|
54
|
+
const mine = members.filter((m) => adapter.kinds.includes(m.kind));
|
|
55
|
+
if (mine.length === 0)
|
|
56
|
+
continue;
|
|
57
|
+
try {
|
|
58
|
+
out.push(...(await adapter.run({ members: mine, cwd, env, log })));
|
|
59
|
+
}
|
|
60
|
+
catch (err) {
|
|
61
|
+
const why = err instanceof Error ? err.message : String(err);
|
|
62
|
+
for (const m of mine)
|
|
63
|
+
out.push({ lexicon: adapter.lexicon, step: "check", member: m.name, exit: 1, outcome: "failed", reason: `the ${adapter.lexicon} check steps for ${m.name} could not run: ${why}` });
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
return out;
|
|
67
|
+
}
|
|
68
|
+
/** The line a failed step gives the report's `failed`. */
|
|
69
|
+
function failedLine(steps) {
|
|
70
|
+
const failed = steps.filter((s) => s.outcome === "failed");
|
|
71
|
+
if (failed.length === 0)
|
|
72
|
+
return undefined;
|
|
73
|
+
return `a check step failed: ${failed.map((s) => s.reason ?? `${s.step} for ${s.member}${s.stack ? ` (stack ${s.stack})` : ""}`).join("; ")}`;
|
|
74
|
+
}
|
|
75
|
+
/**
|
|
76
|
+
* The check stage (#4556, #4633): the `ci.hooks.check` hooks at base, then,
|
|
77
|
+
* unless a hook failed, the lexicons' check steps. Writes one report with
|
|
78
|
+
* both under `dir` and returns it; `status` is `none` only when no hook is
|
|
79
|
+
* declared and no step ran.
|
|
80
|
+
*/
|
|
81
|
+
export async function runCheckStage(options) {
|
|
82
|
+
const cwd = options.cwd ?? process.cwd();
|
|
83
|
+
const log = options.log ?? ((line) => console.error(line));
|
|
84
|
+
const hooks = runCheckHooks(options);
|
|
85
|
+
if (hooks.status === "failed" || options.adapters.length === 0)
|
|
86
|
+
return hooks;
|
|
87
|
+
const steps = await runCheckSteps({
|
|
88
|
+
adapters: options.adapters,
|
|
89
|
+
...(options.members ? { members: options.members } : {}),
|
|
90
|
+
targets: options.targets ?? [],
|
|
91
|
+
cwd,
|
|
92
|
+
env: { ...checkHookEnv(), ...options.env },
|
|
93
|
+
log,
|
|
94
|
+
});
|
|
95
|
+
if (steps.length === 0)
|
|
96
|
+
return hooks;
|
|
97
|
+
const failed = failedLine(steps);
|
|
98
|
+
const report = { ...hooks, status: failed ? "failed" : "passed", steps, ...(failed ? { failed } : {}) };
|
|
99
|
+
const dir = relative(cwd, resolve(cwd, options.dir ?? CHECK_HOOKS_DIR)) || ".";
|
|
100
|
+
writeFileSync(join(cwd, dir, CHECK_HOOKS_REPORT_FILE), JSON.stringify(report, null, 2) + "\n");
|
|
101
|
+
return report;
|
|
102
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Job services a lexicon asks for (#4572, `LexiconPlugin.ciServices`): a
|
|
3
|
+
* throwaway server a CI job starts beside it, such as the sql lexicon's
|
|
4
|
+
* replay server per dialect. A service is forge-neutral data here; a
|
|
5
|
+
* product's job renders it for its forge with {@link githubServices} (GitHub
|
|
6
|
+
* and Forgejo) or {@link gitlabServices}, sets {@link servicesJobEnv} on the
|
|
7
|
+
* job, and runs {@link serviceWaitLine} before the step that uses it.
|
|
8
|
+
*
|
|
9
|
+
* The job runs in a container (chant's default image, or the product's), so
|
|
10
|
+
* it reaches each service by its name on the job's own network. A name is
|
|
11
|
+
* prefixed by the lexicon (`replay-postgres`), so two lexicons' services
|
|
12
|
+
* never answer for one host.
|
|
13
|
+
*/
|
|
14
|
+
/** The first chant with `LexiconPlugin.ciServices` and this module (#4572). */
|
|
15
|
+
export declare const CI_SERVICES_FLOOR = "0.124.55";
|
|
16
|
+
/** One service a job starts. */
|
|
17
|
+
export interface CiService {
|
|
18
|
+
/** The host the job reaches it at, and its alias on GitLab. */
|
|
19
|
+
name: string;
|
|
20
|
+
/** The image, pinned by the lexicon (tag, and digest where the lexicon pins one). */
|
|
21
|
+
image: string;
|
|
22
|
+
/** The port the server listens on inside its container. */
|
|
23
|
+
port: number;
|
|
24
|
+
/** The service container's environment. */
|
|
25
|
+
env: Record<string, string>;
|
|
26
|
+
/** A command run inside the service container that exits 0 once the server answers. */
|
|
27
|
+
health: string;
|
|
28
|
+
/** What the job that uses it sets: the server's URL and its throwaway credentials, by variable name. */
|
|
29
|
+
jobEnv: Record<string, string>;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Join the services each lexicon gives, each name once, in the order the
|
|
33
|
+
* lexicons come. Two services under one name with different images are
|
|
34
|
+
* refused: a host that answers for two servers would split the job.
|
|
35
|
+
*/
|
|
36
|
+
export declare function engineServices(perLexicon: ReadonlyArray<readonly CiService[] | undefined>): CiService[];
|
|
37
|
+
/** A job's `services:` on GitHub and Forgejo: each image with its environment and a health check the runner waits on. */
|
|
38
|
+
export declare function githubServices(services: readonly CiService[]): Record<string, {
|
|
39
|
+
image: string;
|
|
40
|
+
env?: Record<string, string>;
|
|
41
|
+
options: string;
|
|
42
|
+
}>;
|
|
43
|
+
/** A job's `services:` on GitLab: each image under its alias, with its variables. GitLab waits on the port itself. */
|
|
44
|
+
export declare function gitlabServices(services: readonly CiService[]): Array<{
|
|
45
|
+
name: string;
|
|
46
|
+
alias: string;
|
|
47
|
+
variables?: Record<string, string>;
|
|
48
|
+
}>;
|
|
49
|
+
/** The variables a job using `services` sets, merged in order. */
|
|
50
|
+
export declare function servicesJobEnv(services: readonly CiService[]): Record<string, string>;
|
|
51
|
+
/**
|
|
52
|
+
* A shell line that waits up to `seconds` for `host:port` to accept a
|
|
53
|
+
* connection, with `node -e`, so every forge and image with node runs it
|
|
54
|
+
* the same. It exits 1 naming the host when nothing answers.
|
|
55
|
+
*/
|
|
56
|
+
export declare function serviceWaitLine(host: string, port: number, seconds?: number): string;
|
|
57
|
+
//# sourceMappingURL=ci-services.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ci-services.d.ts","sourceRoot":"","sources":["../../src/components/ci-services.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C,gCAAgC;AAChC,MAAM,WAAW,SAAS;IACxB,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B,uFAAuF;IACvF,MAAM,EAAE,MAAM,CAAC;IACf,wGAAwG;IACxG,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,aAAa,CAAC,SAAS,SAAS,EAAE,GAAG,SAAS,CAAC,GAAG,SAAS,EAAE,CAQvG;AAED,yHAAyH;AACzH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAW/I;AAED,sHAAsH;AACtH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAEzI;AAED,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAErF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM,CAGhF"}
|