@intentius/chant 0.124.54 → 0.124.56
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/__fixtures__/estate-ledger.d.ts +13 -0
- package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
- package/dist/__fixtures__/estate-ledger.js +67 -0
- package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
- package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
- package/dist/__fixtures__/oidc-emulator.js +26 -2
- package/dist/__fixtures__/product-words.d.ts +78 -0
- package/dist/__fixtures__/product-words.d.ts.map +1 -0
- package/dist/__fixtures__/product-words.js +43 -0
- package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/dist/__golden__/wave-loop/op-held-on.json +28 -7
- package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/dist/__golden__/wave-loop/op-overridden.json +28 -7
- package/dist/__golden__/wave-loop/op-per-run.json +20 -4
- package/dist/__golden__/wave-loop/op-point.json +18 -4
- package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
- package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/dist/__golden__/wave-loop/op-spend.json +10 -2
- package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/dist/__golden__/wave-loop/op-wide.json +20 -4
- package/dist/bucket-check/azure.d.ts +108 -0
- package/dist/bucket-check/azure.d.ts.map +1 -0
- package/dist/bucket-check/azure.js +258 -0
- package/dist/bucket-check/fixtures/azure.json +153 -0
- package/dist/bucket-check/fixtures/gcs.json +148 -0
- package/dist/bucket-check/fixtures/s3.json +277 -0
- package/dist/bucket-check/gcs.d.ts +77 -0
- package/dist/bucket-check/gcs.d.ts.map +1 -0
- package/dist/bucket-check/gcs.js +202 -0
- package/dist/bucket-check/index.d.ts +48 -0
- package/dist/bucket-check/index.d.ts.map +1 -0
- package/dist/bucket-check/index.js +44 -0
- package/dist/bucket-check/s3.d.ts +116 -0
- package/dist/bucket-check/s3.d.ts.map +1 -0
- package/dist/bucket-check/s3.js +362 -0
- package/dist/bucket-check/types.d.ts +66 -0
- package/dist/bucket-check/types.d.ts.map +1 -0
- package/dist/bucket-check/types.js +31 -0
- package/dist/bucket-check/wire.d.ts +27 -0
- package/dist/bucket-check/wire.d.ts.map +1 -0
- package/dist/bucket-check/wire.js +32 -0
- package/dist/bucket-check.d.ts +6 -0
- package/dist/bucket-check.d.ts.map +1 -0
- package/dist/bucket-check.js +5 -0
- package/dist/capabilities/templates.d.ts.map +1 -1
- package/dist/capabilities/templates.js +1 -2
- package/dist/change-set.d.ts.map +1 -1
- package/dist/change-set.js +2 -3
- package/dist/ci-agent.d.ts +381 -0
- package/dist/ci-agent.d.ts.map +1 -0
- package/dist/ci-agent.js +832 -0
- package/dist/ci-audit/attribution.d.ts +111 -0
- package/dist/ci-audit/attribution.d.ts.map +1 -0
- package/dist/ci-audit/attribution.js +194 -0
- package/dist/ci-audit/audit-log.d.ts +144 -0
- package/dist/ci-audit/audit-log.d.ts.map +1 -0
- package/dist/ci-audit/audit-log.js +149 -0
- package/dist/ci-audit/index.d.ts +12 -0
- package/dist/ci-audit/index.d.ts.map +1 -0
- package/dist/ci-audit/index.js +12 -0
- package/dist/ci-audit/unrecorded.d.ts +74 -0
- package/dist/ci-audit/unrecorded.d.ts.map +1 -0
- package/dist/ci-audit/unrecorded.js +95 -0
- package/dist/ci-audit.d.ts +3 -0
- package/dist/ci-audit.d.ts.map +1 -0
- package/dist/ci-audit.js +2 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +41 -0
- package/dist/ci-estate/delivery.d.ts +137 -0
- package/dist/ci-estate/delivery.d.ts.map +1 -0
- package/dist/ci-estate/delivery.js +311 -0
- package/dist/ci-estate/overdue.d.ts +34 -0
- package/dist/ci-estate/overdue.d.ts.map +1 -0
- package/dist/ci-estate/overdue.js +58 -0
- package/dist/ci-estate/page.d.ts +134 -0
- package/dist/ci-estate/page.d.ts.map +1 -0
- package/dist/ci-estate/page.js +233 -0
- package/dist/ci-estate/rows.d.ts +118 -0
- package/dist/ci-estate/rows.d.ts.map +1 -0
- package/dist/ci-estate/rows.js +126 -0
- package/dist/ci-estate.d.ts +92 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +82 -0
- package/dist/ci-handover.d.ts +29 -5
- package/dist/ci-handover.d.ts.map +1 -1
- package/dist/ci-handover.js +50 -16
- package/dist/ci-identity.d.ts +82 -7
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +86 -15
- package/dist/ci-job-guard.d.ts +139 -0
- package/dist/ci-job-guard.d.ts.map +1 -0
- package/dist/ci-job-guard.js +287 -0
- package/dist/ci-jobs.d.ts +7 -0
- package/dist/ci-jobs.d.ts.map +1 -1
- package/dist/ci-jobs.js +7 -0
- package/dist/ci-product-words.d.ts +296 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +407 -0
- package/dist/ci-product.d.ts +117 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +113 -0
- package/dist/ci-respond-run.d.ts +73 -0
- package/dist/ci-respond-run.d.ts.map +1 -0
- package/dist/ci-respond-run.js +247 -0
- package/dist/ci-respond.d.ts +189 -0
- package/dist/ci-respond.d.ts.map +1 -0
- package/dist/ci-respond.js +285 -0
- package/dist/cli/commands/audit.d.ts +2 -2
- package/dist/cli/commands/audit.d.ts.map +1 -1
- package/dist/cli/commands/audit.js +3 -2
- package/dist/cli/commands/carve.js +2 -2
- package/dist/cli/commands/init.d.ts +2 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +1 -1
- package/dist/cli/handlers/agent.d.ts +17 -0
- package/dist/cli/handlers/agent.d.ts.map +1 -0
- package/dist/cli/handlers/agent.js +114 -0
- package/dist/cli/handlers/approve-confirm.d.ts +84 -0
- package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
- package/dist/cli/handlers/approve-confirm.js +142 -0
- package/dist/cli/handlers/approve.d.ts.map +1 -1
- package/dist/cli/handlers/approve.js +19 -1
- package/dist/cli/handlers/audit-log.d.ts +12 -0
- package/dist/cli/handlers/audit-log.d.ts.map +1 -0
- package/dist/cli/handlers/audit-log.js +81 -0
- package/dist/cli/handlers/build.d.ts +7 -0
- package/dist/cli/handlers/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +124 -1
- package/dist/cli/handlers/ci-check-job.d.ts +11 -0
- package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check-job.js +27 -0
- package/dist/cli/handlers/ci-check.d.ts +3 -0
- package/dist/cli/handlers/ci-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check.js +63 -0
- package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
- package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-forge-check.js +89 -0
- package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
- package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
- package/dist/cli/handlers/e2e-safe-run.js +23 -0
- package/dist/cli/handlers/fan-out.js +4 -0
- package/dist/cli/handlers/gate-pending.d.ts +11 -0
- package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
- package/dist/cli/handlers/gate-pending.js +44 -0
- package/dist/cli/handlers/init.d.ts.map +1 -1
- package/dist/cli/handlers/init.js +1 -0
- package/dist/cli/handlers/ledger.js +1 -1
- package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
- package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
- package/dist/cli/handlers/lifecycle-drift.js +7 -2
- package/dist/cli/handlers/lock.d.ts.map +1 -1
- package/dist/cli/handlers/lock.js +64 -5
- package/dist/cli/handlers/notify-relay.d.ts +15 -0
- package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
- package/dist/cli/handlers/notify-relay.js +130 -0
- package/dist/cli/handlers/pr-env.d.ts.map +1 -1
- package/dist/cli/handlers/pr-env.js +42 -11
- package/dist/cli/handlers/pr.d.ts +43 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +908 -205
- package/dist/cli/handlers/promote.d.ts.map +1 -1
- package/dist/cli/handlers/promote.js +21 -2
- package/dist/cli/handlers/release.d.ts.map +1 -1
- package/dist/cli/handlers/release.js +3 -0
- package/dist/cli/handlers/run-wave.d.ts +8 -0
- package/dist/cli/handlers/run-wave.d.ts.map +1 -1
- package/dist/cli/handlers/run-wave.js +160 -2
- package/dist/cli/handlers/run.d.ts +6 -1
- package/dist/cli/handlers/run.d.ts.map +1 -1
- package/dist/cli/handlers/run.js +86 -1
- package/dist/cli/handlers/serve.d.ts.map +1 -1
- package/dist/cli/handlers/serve.js +10 -1
- package/dist/cli/main.d.ts +11 -1
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +178 -13
- package/dist/cli/mcp/ledger-tools.d.ts +36 -0
- package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
- package/dist/cli/mcp/ledger-tools.js +122 -0
- package/dist/cli/mcp/product-tools.d.ts +78 -0
- package/dist/cli/mcp/product-tools.d.ts.map +1 -0
- package/dist/cli/mcp/product-tools.js +93 -0
- package/dist/cli/mcp/read-only.d.ts +34 -0
- package/dist/cli/mcp/read-only.d.ts.map +1 -0
- package/dist/cli/mcp/read-only.js +61 -0
- package/dist/cli/mcp/report-tools.d.ts +48 -0
- package/dist/cli/mcp/report-tools.d.ts.map +1 -0
- package/dist/cli/mcp/report-tools.js +128 -0
- package/dist/cli/mcp/server.d.ts +28 -1
- package/dist/cli/mcp/server.d.ts.map +1 -1
- package/dist/cli/mcp/server.js +86 -15
- package/dist/cli/mcp-config.d.ts +9 -2
- package/dist/cli/mcp-config.d.ts.map +1 -1
- package/dist/cli/mcp-config.js +8 -3
- package/dist/cli/parse-args.d.ts.map +1 -1
- package/dist/cli/parse-args.js +164 -3
- package/dist/cli/registry.d.ts +73 -0
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.d.ts +42 -7
- package/dist/cloud-lister/sigv4.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.js +72 -22
- package/dist/components/adoption.d.ts +69 -0
- package/dist/components/adoption.d.ts.map +1 -0
- package/dist/components/adoption.js +92 -0
- package/dist/components/apply-lease.d.ts +19 -0
- package/dist/components/apply-lease.d.ts.map +1 -0
- package/dist/components/apply-lease.js +41 -0
- package/dist/components/capability.d.ts +159 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +39 -6
- package/dist/components/check-hooks.d.ts +116 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -0
- package/dist/components/check-steps.d.ts +74 -0
- package/dist/components/check-steps.d.ts.map +1 -0
- package/dist/components/check-steps.js +102 -0
- package/dist/components/ci-services.d.ts +57 -0
- package/dist/components/ci-services.d.ts.map +1 -0
- package/dist/components/ci-services.js +60 -0
- package/dist/components/cli-support.d.ts +13 -0
- package/dist/components/cli-support.d.ts.map +1 -1
- package/dist/components/cli-support.js +10 -2
- package/dist/components/driver.d.ts +32 -3
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +59 -5
- package/dist/components/fan-out-run.d.ts +12 -0
- package/dist/components/fan-out-run.d.ts.map +1 -1
- package/dist/components/fan-out-run.js +56 -16
- package/dist/components/groups.d.ts.map +1 -1
- package/dist/components/groups.js +23 -5
- package/dist/components/pr-env-ledger.d.ts +32 -0
- package/dist/components/pr-env-ledger.d.ts.map +1 -0
- package/dist/components/pr-env-ledger.js +38 -0
- package/dist/components/pr-env-ports.d.ts +12 -0
- package/dist/components/pr-env-ports.d.ts.map +1 -1
- package/dist/components/pr-env-ports.js +13 -3
- package/dist/components/pr-env-run.d.ts +6 -0
- package/dist/components/pr-env-run.d.ts.map +1 -1
- package/dist/components/pr-env-run.js +3 -2
- package/dist/components/pr-environment.d.ts +32 -4
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +26 -8
- package/dist/components/pr-pipeline.d.ts +297 -5
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +329 -18
- package/dist/components/pr-policy.d.ts +26 -2
- package/dist/components/pr-policy.d.ts.map +1 -1
- package/dist/components/pr-policy.js +41 -7
- package/dist/components/pr-run.d.ts +71 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +91 -7
- package/dist/components/pr-targets.d.ts +24 -0
- package/dist/components/pr-targets.d.ts.map +1 -0
- package/dist/components/pr-targets.js +48 -0
- package/dist/components/product-pipeline.d.ts +250 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +212 -0
- package/dist/components/promote.d.ts +6 -0
- package/dist/components/promote.d.ts.map +1 -1
- package/dist/components/promote.js +4 -1
- package/dist/components/release-compile.d.ts +22 -1
- package/dist/components/release-compile.d.ts.map +1 -1
- package/dist/components/release-compile.js +85 -0
- package/dist/components/release-promote.d.ts +15 -1
- package/dist/components/release-promote.d.ts.map +1 -1
- package/dist/components/release-promote.js +67 -2
- package/dist/components/repo-lock.d.ts +27 -0
- package/dist/components/repo-lock.d.ts.map +1 -0
- package/dist/components/repo-lock.js +49 -0
- package/dist/components/row-lease.d.ts +84 -0
- package/dist/components/row-lease.d.ts.map +1 -0
- package/dist/components/row-lease.js +110 -0
- package/dist/components/wave-plan.d.ts +42 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +72 -4
- package/dist/control/applied.d.ts +89 -0
- package/dist/control/applied.d.ts.map +1 -0
- package/dist/control/applied.js +175 -0
- package/dist/control/consumers.d.ts +78 -0
- package/dist/control/consumers.d.ts.map +1 -0
- package/dist/control/consumers.js +172 -0
- package/dist/control/dispatch.d.ts +334 -0
- package/dist/control/dispatch.d.ts.map +1 -0
- package/dist/control/dispatch.js +519 -0
- package/dist/control/edges.d.ts +75 -0
- package/dist/control/edges.d.ts.map +1 -0
- package/dist/control/edges.js +133 -0
- package/dist/control/reconcile.d.ts +120 -0
- package/dist/control/reconcile.d.ts.map +1 -0
- package/dist/control/reconcile.js +178 -0
- package/dist/control/records.d.ts +187 -0
- package/dist/control/records.d.ts.map +1 -0
- package/dist/control/records.js +307 -0
- package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
- package/dist/discovery/sandbox/bundle.js +25 -1
- package/dist/e2e-harness/bucket.d.ts +21 -0
- package/dist/e2e-harness/bucket.d.ts.map +1 -0
- package/dist/e2e-harness/bucket.js +61 -0
- package/dist/e2e-harness/claim.d.ts +70 -0
- package/dist/e2e-harness/claim.d.ts.map +1 -0
- package/dist/e2e-harness/claim.js +98 -0
- package/dist/e2e-harness/driver.d.ts +64 -0
- package/dist/e2e-harness/driver.d.ts.map +1 -0
- package/dist/e2e-harness/driver.js +243 -0
- package/dist/e2e-harness/forgejo.d.ts +77 -0
- package/dist/e2e-harness/forgejo.d.ts.map +1 -0
- package/dist/e2e-harness/forgejo.js +205 -0
- package/dist/e2e-harness/git.d.ts +32 -0
- package/dist/e2e-harness/git.d.ts.map +1 -0
- package/dist/e2e-harness/git.js +67 -0
- package/dist/e2e-harness/index.d.ts +22 -0
- package/dist/e2e-harness/index.d.ts.map +1 -0
- package/dist/e2e-harness/index.js +48 -0
- package/dist/e2e-harness/jobs.d.ts +8 -0
- package/dist/e2e-harness/jobs.d.ts.map +1 -0
- package/dist/e2e-harness/jobs.js +34 -0
- package/dist/e2e-harness/pins.d.ts +45 -0
- package/dist/e2e-harness/pins.d.ts.map +1 -0
- package/dist/e2e-harness/pins.js +44 -0
- package/dist/e2e-harness/ports.d.ts +113 -0
- package/dist/e2e-harness/ports.d.ts.map +1 -0
- package/dist/e2e-harness/ports.js +4 -0
- package/dist/e2e-harness/reports.d.ts +45 -0
- package/dist/e2e-harness/reports.d.ts.map +1 -0
- package/dist/e2e-harness/reports.js +57 -0
- package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
- package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run-cli.js +43 -0
- package/dist/e2e-harness/safe-run.d.ts +61 -0
- package/dist/e2e-harness/safe-run.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run.js +172 -0
- package/dist/e2e-harness/scenario.d.ts +11 -0
- package/dist/e2e-harness/scenario.d.ts.map +1 -0
- package/dist/e2e-harness/scenario.js +89 -0
- package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/dist/e2e-harness/schemas/index.d.ts +191 -0
- package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
- package/dist/e2e-harness/schemas/index.js +62 -0
- package/dist/e2e-harness/stack.d.ts +124 -0
- package/dist/e2e-harness/stack.d.ts.map +1 -0
- package/dist/e2e-harness/stack.js +207 -0
- package/dist/e2e-harness/steps.d.ts +11 -0
- package/dist/e2e-harness/steps.d.ts.map +1 -0
- package/dist/e2e-harness/steps.js +22 -0
- package/dist/e2e-harness.d.ts +3 -0
- package/dist/e2e-harness.d.ts.map +1 -0
- package/dist/e2e-harness.js +2 -0
- package/dist/engine-facts.d.ts.map +1 -1
- package/dist/engine-facts.js +1 -2
- package/dist/exit-codes.d.ts +54 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +55 -0
- package/dist/forge-check/check.d.ts +63 -0
- package/dist/forge-check/check.d.ts.map +1 -0
- package/dist/forge-check/check.js +139 -0
- package/dist/forge-check/contract.d.ts +152 -0
- package/dist/forge-check/contract.d.ts.map +1 -0
- package/dist/forge-check/contract.js +118 -0
- package/dist/forge-check/forge.d.ts +42 -0
- package/dist/forge-check/forge.d.ts.map +1 -0
- package/dist/forge-check/forge.js +338 -0
- package/dist/forge-check/index.d.ts +24 -0
- package/dist/forge-check/index.d.ts.map +1 -0
- package/dist/forge-check/index.js +23 -0
- package/dist/forge-check/pulumi.d.ts +44 -0
- package/dist/forge-check/pulumi.d.ts.map +1 -0
- package/dist/forge-check/pulumi.js +184 -0
- package/dist/forge-check/read-only.d.ts +26 -0
- package/dist/forge-check/read-only.d.ts.map +1 -0
- package/dist/forge-check/read-only.js +53 -0
- package/dist/forge-check/trust.d.ts +94 -0
- package/dist/forge-check/trust.d.ts.map +1 -0
- package/dist/forge-check/trust.js +532 -0
- package/dist/forge-check/types.d.ts +80 -0
- package/dist/forge-check/types.d.ts.map +1 -0
- package/dist/forge-check/types.js +18 -0
- package/dist/forge-check.d.ts +6 -0
- package/dist/forge-check.d.ts.map +1 -0
- package/dist/forge-check.js +5 -0
- package/dist/gate-decision.d.ts +1 -0
- package/dist/gate-decision.d.ts.map +1 -1
- package/dist/gate-decision.js +2 -0
- package/dist/gate-policy.d.ts +47 -1
- package/dist/gate-policy.d.ts.map +1 -1
- package/dist/gate-policy.js +50 -2
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/lexicon.d.ts +152 -6
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.d.ts +24 -0
- package/dist/lifecycle/adoption-file.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.js +1 -2
- package/dist/lifecycle/cloud-index.d.ts.map +1 -1
- package/dist/lifecycle/cloud-index.js +1 -2
- package/dist/lifecycle/gate-applied.d.ts +6 -0
- package/dist/lifecycle/gate-applied.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.d.ts +29 -0
- package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.js +10 -1
- package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
- package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
- package/dist/lifecycle/gate-pending-by-plan.js +96 -0
- package/dist/lifecycle/gated-request-digest.d.ts +28 -0
- package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
- package/dist/lifecycle/gated-request-digest.js +35 -0
- package/dist/lifecycle/gated-request.d.ts +126 -0
- package/dist/lifecycle/gated-request.d.ts.map +1 -0
- package/dist/lifecycle/gated-request.js +204 -0
- package/dist/lifecycle/identity-match.d.ts +15 -0
- package/dist/lifecycle/identity-match.d.ts.map +1 -1
- package/dist/lifecycle/identity-match.js +11 -6
- package/dist/lifecycle/index-diff.d.ts +40 -0
- package/dist/lifecycle/index-diff.d.ts.map +1 -1
- package/dist/lifecycle/index-diff.js +1 -2
- package/dist/lifecycle/index-document.d.ts.map +1 -1
- package/dist/lifecycle/index-document.js +1 -2
- package/dist/lifecycle/index-import.d.ts +4 -1
- package/dist/lifecycle/index-import.d.ts.map +1 -1
- package/dist/lifecycle/index-import.js +29 -32
- package/dist/lifecycle/ledger-read.d.ts.map +1 -1
- package/dist/lifecycle/ledger-read.js +7 -3
- package/dist/lifecycle/lock-rows.d.ts +76 -0
- package/dist/lifecycle/lock-rows.d.ts.map +1 -0
- package/dist/lifecycle/lock-rows.js +140 -0
- package/dist/lifecycle/query.d.ts +50 -3
- package/dist/lifecycle/query.d.ts.map +1 -1
- package/dist/lifecycle/query.js +97 -7
- package/dist/lifecycle/release-catalog-site.d.ts +66 -0
- package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog-site.js +232 -0
- package/dist/lifecycle/release-catalog.d.ts +201 -0
- package/dist/lifecycle/release-catalog.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog.js +198 -0
- package/dist/lifecycle/release-changelog.d.ts +41 -0
- package/dist/lifecycle/release-changelog.d.ts.map +1 -0
- package/dist/lifecycle/release-changelog.js +38 -0
- package/dist/lifecycle/release-cut.d.ts +1 -0
- package/dist/lifecycle/release-cut.d.ts.map +1 -1
- package/dist/lifecycle/release-cut.js +1 -1
- package/dist/lifecycle/release-ledger.d.ts +16 -0
- package/dist/lifecycle/release-ledger.d.ts.map +1 -1
- package/dist/lifecycle/release-ledger.js +9 -0
- package/dist/lifecycle/release-publish.d.ts +43 -22
- package/dist/lifecycle/release-publish.d.ts.map +1 -1
- package/dist/lifecycle/release-read.d.ts.map +1 -1
- package/dist/lifecycle/release-read.js +3 -0
- package/dist/lifecycle/release-status.d.ts +106 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +115 -0
- package/dist/lifecycle/resource-lock.d.ts +120 -0
- package/dist/lifecycle/resource-lock.d.ts.map +1 -0
- package/dist/lifecycle/resource-lock.js +317 -0
- package/dist/lifecycle/retention.d.ts.map +1 -1
- package/dist/lifecycle/retention.js +3 -0
- package/dist/lifecycle/run-ledger.d.ts.map +1 -1
- package/dist/lifecycle/run-ledger.js +9 -1
- package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
- package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store-s3.js +9 -44
- package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store.js +1 -2
- package/dist/lifecycle/target-lock.d.ts +15 -0
- package/dist/lifecycle/target-lock.d.ts.map +1 -1
- package/dist/lifecycle/target-lock.js +25 -10
- package/dist/lifecycle/wave-plans.d.ts +23 -7
- package/dist/lifecycle/wave-plans.d.ts.map +1 -1
- package/dist/lifecycle/wave-plans.js +9 -2
- package/dist/mcp/types.d.ts +7 -0
- package/dist/mcp/types.d.ts.map +1 -1
- package/dist/notify-product.d.ts +43 -0
- package/dist/notify-product.d.ts.map +1 -0
- package/dist/notify-product.js +58 -0
- package/dist/notify-relay.d.ts +197 -0
- package/dist/notify-relay.d.ts.map +1 -0
- package/dist/notify-relay.js +321 -0
- package/dist/notify.d.ts +44 -4
- package/dist/notify.d.ts.map +1 -1
- package/dist/notify.js +77 -14
- package/dist/object-store/azure-blob.d.ts +129 -0
- package/dist/object-store/azure-blob.d.ts.map +1 -0
- package/dist/object-store/azure-blob.js +341 -0
- package/dist/object-store/common.d.ts +108 -0
- package/dist/object-store/common.d.ts.map +1 -0
- package/dist/object-store/common.js +80 -0
- package/dist/object-store/errors.d.ts +28 -0
- package/dist/object-store/errors.d.ts.map +1 -0
- package/dist/object-store/errors.js +21 -0
- package/dist/object-store/from-env.d.ts +18 -0
- package/dist/object-store/from-env.d.ts.map +1 -0
- package/dist/object-store/from-env.js +22 -0
- package/dist/object-store/gcs.d.ts +106 -0
- package/dist/object-store/gcs.d.ts.map +1 -0
- package/dist/object-store/gcs.js +393 -0
- package/dist/object-store/index.d.ts +9 -0
- package/dist/object-store/index.d.ts.map +1 -0
- package/dist/object-store/index.js +8 -0
- package/dist/object-store/s3.d.ts +146 -0
- package/dist/object-store/s3.d.ts.map +1 -0
- package/dist/object-store/s3.js +306 -0
- package/dist/op/activities/converge.d.ts.map +1 -1
- package/dist/op/activities/converge.js +2 -1
- package/dist/op/activities/index.d.ts +1 -1
- package/dist/op/activities/index.d.ts.map +1 -1
- package/dist/op/activities/index.js +1 -1
- package/dist/op/activities/review-agent.d.ts +55 -2
- package/dist/op/activities/review-agent.d.ts.map +1 -1
- package/dist/op/activities/review-agent.js +65 -5
- package/dist/op/approval-status.d.ts +103 -0
- package/dist/op/approval-status.d.ts.map +1 -0
- package/dist/op/approval-status.js +197 -0
- package/dist/op/gate.d.ts +29 -1
- package/dist/op/gate.d.ts.map +1 -1
- package/dist/op/gate.js +59 -23
- package/dist/op/generate-pipeline.d.ts.map +1 -1
- package/dist/op/generate-pipeline.js +7 -1
- package/dist/op/index.d.ts +12 -1
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +7 -1
- package/dist/op/op-waves-after-plan.d.ts +137 -0
- package/dist/op/op-waves-after-plan.d.ts.map +1 -0
- package/dist/op/op-waves-after-plan.js +163 -0
- package/dist/op/op-waves-capability-spec.d.ts +63 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +115 -0
- package/dist/op/op-waves-capability.d.ts +197 -0
- package/dist/op/op-waves-capability.d.ts.map +1 -0
- package/dist/op/op-waves-capability.js +311 -0
- package/dist/op/op-waves-events.d.ts +54 -0
- package/dist/op/op-waves-events.d.ts.map +1 -0
- package/dist/op/op-waves-events.js +122 -0
- package/dist/op/op-waves-notify.d.ts +7 -1
- package/dist/op/op-waves-notify.d.ts.map +1 -1
- package/dist/op/op-waves-notify.js +35 -16
- package/dist/op/op-waves-release-port.d.ts +18 -0
- package/dist/op/op-waves-release-port.d.ts.map +1 -0
- package/dist/op/op-waves-release-port.js +61 -0
- package/dist/op/op-waves-release.d.ts +92 -0
- package/dist/op/op-waves-release.d.ts.map +1 -0
- package/dist/op/op-waves-release.js +96 -0
- package/dist/op/op-waves-run.d.ts +182 -6
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +1076 -44
- package/dist/op/op-waves-stand-down.d.ts +60 -0
- package/dist/op/op-waves-stand-down.d.ts.map +1 -0
- package/dist/op/op-waves-stand-down.js +96 -0
- package/dist/op/op-waves.d.ts +187 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +203 -19
- package/dist/op/runtime.d.ts +95 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +18 -0
- package/dist/op/stage-hooks.d.ts +45 -7
- package/dist/op/stage-hooks.d.ts.map +1 -1
- package/dist/op/stage-hooks.js +61 -3
- package/dist/op/steward-beside.d.ts.map +1 -1
- package/dist/op/steward-beside.js +2 -1
- package/dist/op/types.d.ts +2 -2
- package/dist/op/types.d.ts.map +1 -1
- package/dist/op/types.js +3 -2
- package/dist/otlp-metrics.d.ts +38 -0
- package/dist/otlp-metrics.d.ts.map +1 -0
- package/dist/otlp-metrics.js +82 -0
- package/dist/otlp.d.ts +249 -0
- package/dist/otlp.d.ts.map +1 -0
- package/dist/otlp.js +425 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -0
- package/dist/parallelism.d.ts +17 -0
- package/dist/parallelism.d.ts.map +1 -0
- package/dist/parallelism.js +33 -0
- package/dist/policy-packs.d.ts +69 -0
- package/dist/policy-packs.d.ts.map +1 -0
- package/dist/policy-packs.js +205 -0
- package/dist/policy-source.d.ts +51 -0
- package/dist/policy-source.d.ts.map +1 -0
- package/dist/policy-source.js +102 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +146 -37
- package/dist/pr-loop.d.ts +158 -11
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +302 -44
- package/dist/pr-merge.d.ts +64 -0
- package/dist/pr-merge.d.ts.map +1 -0
- package/dist/pr-merge.js +78 -0
- package/dist/pr-post.d.ts +86 -1
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +141 -5
- package/dist/pr-report-url.d.ts +32 -4
- package/dist/pr-report-url.d.ts.map +1 -1
- package/dist/pr-report-url.js +45 -5
- package/dist/pr-requires.d.ts +13 -2
- package/dist/pr-requires.d.ts.map +1 -1
- package/dist/pr-requires.js +14 -0
- package/dist/release-floors.d.ts +1 -1
- package/dist/release-floors.js +1 -1
- package/dist/run-event.d.ts +26 -1
- package/dist/run-event.d.ts.map +1 -1
- package/dist/run-event.js +3 -1
- package/dist/scheduled-op-cloud.d.ts +32 -0
- package/dist/scheduled-op-cloud.d.ts.map +1 -0
- package/dist/scheduled-op-cloud.js +69 -0
- package/dist/sorted-json.d.ts +10 -0
- package/dist/sorted-json.d.ts.map +1 -0
- package/dist/sorted-json.js +14 -0
- package/dist/terraform/credentials.d.ts +59 -0
- package/dist/terraform/credentials.d.ts.map +1 -0
- package/dist/terraform/credentials.js +149 -0
- package/dist/utils.d.ts +1 -4
- package/dist/utils.d.ts.map +1 -1
- package/dist/utils.js +1 -9
- package/dist/wave-runtime.d.ts +1 -1
- package/dist/wave-runtime.js +2 -2
- package/dist/wave-runtime.mjs +405 -287
- package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
- package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
- package/dist/workspace/ci-lock-grain.d.ts +17 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +21 -0
- package/dist/workspace/ci-run.d.ts +2 -1
- package/dist/workspace/ci-run.d.ts.map +1 -1
- package/dist/workspace/ci-run.js +10 -3
- package/dist/workspace/declaration.d.ts +16 -4
- package/dist/workspace/declaration.d.ts.map +1 -1
- package/dist/workspace/declaration.js +5 -2
- package/dist/workspace/declaration.schema.json +27 -3
- package/dist/workspace/drift-cli.d.ts.map +1 -1
- package/dist/workspace/drift-cli.js +8 -3
- package/dist/workspace/exit-cli.d.ts +1 -1
- package/dist/workspace/exit-cli.d.ts.map +1 -1
- package/dist/workspace/exit-cli.js +2 -1
- package/dist/workspace/import-fetch.d.ts +4 -2
- package/dist/workspace/import-fetch.d.ts.map +1 -1
- package/dist/workspace/import-fetch.js +4 -2
- package/dist/workspace/import-init.d.ts.map +1 -1
- package/dist/workspace/import-init.js +4 -2
- package/dist/workspace/ledger.schema.json +7 -3
- package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
- package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
- package/dist/workspace/lineage-upgrade-cli.js +2 -1
- package/dist/workspace/pr-report.schema.json +79 -3
- package/dist/workspace/promote.d.ts +1 -1
- package/dist/workspace/promote.d.ts.map +1 -1
- package/dist/workspace/promote.js +2 -1
- package/dist/workspace/records-cli.d.ts +2 -2
- package/dist/workspace/records-cli.d.ts.map +1 -1
- package/dist/workspace/records-cli.js +3 -2
- package/dist/workspace/release-catalog.schema.json +277 -0
- package/dist/workspace/run-event.schema.json +18 -1
- package/dist/workspace/work-cli.d.ts +3 -1
- package/dist/workspace/work-cli.d.ts.map +1 -1
- package/dist/workspace/work-cli.js +7 -2
- package/dist/workspace/workspace-run.d.ts.map +1 -1
- package/dist/workspace/workspace-run.js +2 -1
- package/package.json +21 -1
- package/src/__fixtures__/estate-ledger.ts +101 -0
- package/src/__fixtures__/oidc-emulator.ts +31 -2
- package/src/__fixtures__/product-words.ts +44 -0
- package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/src/__golden__/wave-loop/op-held-on.json +28 -7
- package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/src/__golden__/wave-loop/op-overridden.json +28 -7
- package/src/__golden__/wave-loop/op-per-run.json +20 -4
- package/src/__golden__/wave-loop/op-point.json +18 -4
- package/src/__golden__/wave-loop/op-pr-review.json +10 -2
- package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/src/__golden__/wave-loop/op-spend.json +10 -2
- package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/src/__golden__/wave-loop/op-wide.json +20 -4
- package/src/bucket-check/azure.ts +307 -0
- package/src/bucket-check/bucket-check.test.ts +210 -0
- package/src/bucket-check/fixtures/azure.json +153 -0
- package/src/bucket-check/fixtures/gcs.json +148 -0
- package/src/bucket-check/fixtures/s3.json +277 -0
- package/src/bucket-check/gcs.ts +257 -0
- package/src/bucket-check/index.ts +61 -0
- package/src/bucket-check/s3.ts +433 -0
- package/src/bucket-check/types.ts +75 -0
- package/src/bucket-check/wire.ts +50 -0
- package/src/bucket-check.ts +5 -0
- package/src/capabilities/templates.test.ts +2 -3
- package/src/capabilities/templates.ts +1 -2
- package/src/cdk/advise.test.ts +1 -1
- package/src/change-set-bundle.test.ts +0 -1
- package/src/change-set.ts +2 -3
- package/src/ci-agent.test.ts +348 -0
- package/src/ci-agent.ts +1025 -0
- package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
- package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
- package/src/ci-audit/attribution.ts +260 -0
- package/src/ci-audit/audit-log.ts +220 -0
- package/src/ci-audit/ci-audit.test.ts +175 -0
- package/src/ci-audit/index.ts +15 -0
- package/src/ci-audit/unrecorded.ts +140 -0
- package/src/ci-audit.ts +2 -0
- package/src/ci-control.ts +173 -0
- package/src/ci-estate/delivery.ts +433 -0
- package/src/ci-estate/overdue.ts +81 -0
- package/src/ci-estate/page.ts +343 -0
- package/src/ci-estate/rows.ts +251 -0
- package/src/ci-estate.test.ts +281 -0
- package/src/ci-estate.ts +175 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +54 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +3 -1
- package/src/ci-identity.ts +123 -22
- package/src/ci-job-guard.test.ts +154 -0
- package/src/ci-job-guard.ts +319 -0
- package/src/ci-jobs.ts +8 -0
- package/src/ci-product-comment-targets.test.ts +45 -0
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +565 -0
- package/src/ci-product.ts +226 -0
- package/src/ci-respond-run.ts +291 -0
- package/src/ci-respond.test.ts +264 -0
- package/src/ci-respond.ts +412 -0
- package/src/ci-shared-reads.test.ts +145 -0
- package/src/cli/commands/audit.test.ts +1 -1
- package/src/cli/commands/audit.ts +3 -2
- package/src/cli/commands/carve.test.ts +1 -1
- package/src/cli/commands/carve.ts +2 -2
- package/src/cli/commands/init.ts +3 -1
- package/src/cli/component-wave-args.test.ts +16 -0
- package/src/cli/handlers/agent.ts +126 -0
- package/src/cli/handlers/approve-confirm.test.ts +276 -0
- package/src/cli/handlers/approve-confirm.ts +200 -0
- package/src/cli/handlers/approve.ts +18 -1
- package/src/cli/handlers/audit-log.ts +74 -0
- package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
- package/src/cli/handlers/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +113 -1
- package/src/cli/handlers/ci-check-job.test.ts +114 -0
- package/src/cli/handlers/ci-check-job.ts +33 -0
- package/src/cli/handlers/ci-check.ts +63 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -0
- package/src/cli/handlers/e2e-safe-run.ts +27 -0
- package/src/cli/handlers/fan-out.test.ts +10 -10
- package/src/cli/handlers/fan-out.ts +5 -0
- package/src/cli/handlers/gate-pending.ts +46 -0
- package/src/cli/handlers/init.ts +1 -0
- package/src/cli/handlers/ledger.ts +1 -1
- package/src/cli/handlers/lifecycle-drift.ts +7 -2
- package/src/cli/handlers/lock.test.ts +29 -2
- package/src/cli/handlers/lock.ts +66 -6
- package/src/cli/handlers/notify-relay.ts +130 -0
- package/src/cli/handlers/pr-before-merge.test.ts +2 -1
- package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
- package/src/cli/handlers/pr-env.ts +48 -11
- package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
- package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
- package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
- package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
- package/src/cli/handlers/pr-waves.test.ts +8 -2
- package/src/cli/handlers/pr.test.ts +8 -8
- package/src/cli/handlers/pr.ts +879 -205
- package/src/cli/handlers/promote.test.ts +5 -5
- package/src/cli/handlers/promote.ts +22 -2
- package/src/cli/handlers/release.ts +2 -0
- package/src/cli/handlers/run-components-exit.test.ts +7 -7
- package/src/cli/handlers/run-wave.ts +144 -2
- package/src/cli/handlers/run.test.ts +6 -4
- package/src/cli/handlers/run.ts +86 -1
- package/src/cli/handlers/serve.ts +10 -1
- package/src/cli/main.test.ts +1 -1
- package/src/cli/main.ts +180 -13
- package/src/cli/mcp/ledger-tools.ts +126 -0
- package/src/cli/mcp/product-tools.test.ts +123 -0
- package/src/cli/mcp/product-tools.ts +129 -0
- package/src/cli/mcp/read-only.test.ts +134 -0
- package/src/cli/mcp/read-only.ts +68 -0
- package/src/cli/mcp/report-tools.ts +135 -0
- package/src/cli/mcp/server.test.ts +5 -4
- package/src/cli/mcp/server.ts +90 -16
- package/src/cli/mcp-config.ts +8 -3
- package/src/cli/parse-args.ts +119 -2
- package/src/cli/registry.ts +73 -0
- package/src/cloud-lister/sigv4.ts +80 -23
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +140 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability.ts +180 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +255 -0
- package/src/components/check-steps.test.ts +70 -0
- package/src/components/check-steps.ts +158 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +82 -0
- package/src/components/cli-support.ts +23 -2
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +73 -6
- package/src/components/fan-out-run.ts +68 -18
- package/src/components/groups.ts +21 -4
- package/src/components/plan-flags.test.ts +46 -0
- package/src/components/pr-comment-preview-targets.test.ts +34 -0
- package/src/components/pr-comment-preview.test.ts +54 -0
- package/src/components/pr-env-ledger.test.ts +9 -0
- package/src/components/pr-env-ledger.ts +42 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +2 -14
- package/src/components/pr-env-run.test.ts +19 -0
- package/src/components/pr-env-run.ts +12 -2
- package/src/components/pr-environment.test.ts +29 -0
- package/src/components/pr-environment.ts +40 -8
- package/src/components/pr-pipeline-runners.test.ts +80 -0
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +498 -18
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +1 -1
- package/src/components/pr-run.ts +138 -11
- package/src/components/pr-stale-job.test.ts +34 -0
- package/src/components/pr-targets.test.ts +35 -0
- package/src/components/pr-targets.ts +45 -0
- package/src/components/product-pipeline.test.ts +200 -0
- package/src/components/product-pipeline.ts +383 -0
- package/src/components/promote.ts +10 -1
- package/src/components/release-compile.ts +87 -1
- package/src/components/release-promote.ts +65 -1
- package/src/components/repo-lock.ts +52 -0
- package/src/components/row-lease.test.ts +490 -0
- package/src/components/row-lease.ts +167 -0
- package/src/components/wave-plan-policy.test.ts +19 -0
- package/src/components/wave-plan.ts +96 -6
- package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
- package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
- package/src/control/applied.test.ts +148 -0
- package/src/control/applied.ts +191 -0
- package/src/control/consumers.test.ts +129 -0
- package/src/control/consumers.ts +192 -0
- package/src/control/control.test.ts +302 -0
- package/src/control/dispatch.ts +699 -0
- package/src/control/edges.test.ts +112 -0
- package/src/control/edges.ts +164 -0
- package/src/control/note-checkout.test.ts +91 -0
- package/src/control/reconcile.ts +250 -0
- package/src/control/records.ts +395 -0
- package/src/discovery/sandbox/bundle.ts +25 -1
- package/src/e2e-harness/__project__/chant.config.ts +4 -0
- package/src/e2e-harness/__project__/src/compose.ts +33 -0
- package/src/e2e-harness/bucket.ts +69 -0
- package/src/e2e-harness/claim.test.ts +150 -0
- package/src/e2e-harness/claim.ts +140 -0
- package/src/e2e-harness/driver.test.ts +304 -0
- package/src/e2e-harness/driver.ts +294 -0
- package/src/e2e-harness/forgejo.ts +267 -0
- package/src/e2e-harness/git.ts +96 -0
- package/src/e2e-harness/index.ts +50 -0
- package/src/e2e-harness/jobs.ts +35 -0
- package/src/e2e-harness/pins.ts +52 -0
- package/src/e2e-harness/ports.ts +130 -0
- package/src/e2e-harness/reports.ts +79 -0
- package/src/e2e-harness/safe-run-cli.test.ts +102 -0
- package/src/e2e-harness/safe-run-cli.ts +54 -0
- package/src/e2e-harness/safe-run.ts +198 -0
- package/src/e2e-harness/scenario.ts +89 -0
- package/src/e2e-harness/schemas/README.md +62 -0
- package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/src/e2e-harness/schemas/index.ts +220 -0
- package/src/e2e-harness/schemas.test.ts +145 -0
- package/src/e2e-harness/stack.test.ts +124 -0
- package/src/e2e-harness/stack.ts +306 -0
- package/src/e2e-harness/steps.ts +30 -0
- package/src/e2e-harness.ts +2 -0
- package/src/engine-facts.test.ts +2 -3
- package/src/engine-facts.ts +1 -2
- package/src/exit-codes.test.ts +32 -0
- package/src/exit-codes.ts +61 -0
- package/src/forge-check/check.ts +155 -0
- package/src/forge-check/contract.ts +215 -0
- package/src/forge-check/forge-check.test.ts +427 -0
- package/src/forge-check/forge.ts +318 -0
- package/src/forge-check/index.ts +43 -0
- package/src/forge-check/pulumi.ts +192 -0
- package/src/forge-check/read-only.ts +56 -0
- package/src/forge-check/trust.ts +527 -0
- package/src/forge-check/types.ts +78 -0
- package/src/forge-check.ts +5 -0
- package/src/gate-decision-bundle.test.ts +11 -0
- package/src/gate-decision.ts +3 -0
- package/src/gate-policy.ts +92 -3
- package/src/gated-waves-bundle.test.ts +0 -1
- package/src/index.ts +2 -0
- package/src/lexicon.ts +143 -6
- package/src/lifecycle/adoption-file.ts +1 -2
- package/src/lifecycle/cloud-index.test.ts +2 -3
- package/src/lifecycle/cloud-index.ts +1 -2
- package/src/lifecycle/control-entries-ledger.test.ts +69 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +35 -1
- package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
- package/src/lifecycle/gate-pending-by-plan.ts +133 -0
- package/src/lifecycle/gated-request-digest.ts +49 -0
- package/src/lifecycle/gated-request-ledger.test.ts +53 -0
- package/src/lifecycle/gated-request.ts +279 -0
- package/src/lifecycle/identity-match.ts +25 -6
- package/src/lifecycle/index-diff.ts +1 -2
- package/src/lifecycle/index-document.ts +1 -2
- package/src/lifecycle/index-import.test.ts +14 -0
- package/src/lifecycle/index-import.ts +54 -34
- package/src/lifecycle/ledger-read.ts +7 -3
- package/src/lifecycle/lock-rows.test.ts +109 -0
- package/src/lifecycle/lock-rows.ts +167 -0
- package/src/lifecycle/publish-target-context.test.ts +108 -0
- package/src/lifecycle/query.test.ts +2 -3
- package/src/lifecycle/query.ts +109 -8
- package/src/lifecycle/release-catalog-site.test.ts +142 -0
- package/src/lifecycle/release-catalog-site.ts +291 -0
- package/src/lifecycle/release-catalog.test.ts +192 -0
- package/src/lifecycle/release-catalog.ts +353 -0
- package/src/lifecycle/release-changelog.test.ts +70 -0
- package/src/lifecycle/release-changelog.ts +71 -0
- package/src/lifecycle/release-cut.ts +2 -2
- package/src/lifecycle/release-ledger.ts +19 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +185 -0
- package/src/lifecycle/release-status.ts +175 -0
- package/src/lifecycle/resource-lock.test.ts +175 -0
- package/src/lifecycle/resource-lock.ts +354 -0
- package/src/lifecycle/retention.ts +2 -0
- package/src/lifecycle/run-ledger.ts +7 -1
- package/src/lifecycle/snapshot-store-s3.ts +9 -45
- package/src/lifecycle/snapshot-store.ts +1 -2
- package/src/lifecycle/target-lock.ts +24 -9
- package/src/lifecycle/wave-plans.ts +33 -5
- package/src/mcp/types.ts +7 -0
- package/src/notify-product.ts +76 -0
- package/src/notify-relay.test.ts +213 -0
- package/src/notify-relay.ts +407 -0
- package/src/notify.ts +95 -14
- package/src/object-store/azure-blob.ts +374 -0
- package/src/object-store/common.ts +133 -0
- package/src/object-store/errors.ts +26 -0
- package/src/object-store/from-env.ts +36 -0
- package/src/object-store/gcs.ts +436 -0
- package/src/object-store/index.ts +8 -0
- package/src/object-store/object-store.test.ts +130 -0
- package/src/object-store/s3.ts +350 -0
- package/src/op/activities/converge.ts +2 -1
- package/src/op/activities/index.ts +1 -1
- package/src/op/activities/review-agent.open.test.ts +78 -0
- package/src/op/activities/review-agent.test.ts +13 -0
- package/src/op/activities/review-agent.ts +89 -5
- package/src/op/approval-status.test.ts +134 -0
- package/src/op/approval-status.ts +235 -0
- package/src/op/gate-review.test.ts +2 -1
- package/src/op/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +23 -0
- package/src/op/op-waves-after-plan.test.ts +288 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +133 -0
- package/src/op/op-waves-capability.test.ts +217 -0
- package/src/op/op-waves-capability.ts +370 -0
- package/src/op/op-waves-events.ts +135 -0
- package/src/op/op-waves-notify-words.test.ts +149 -0
- package/src/op/op-waves-notify.ts +41 -16
- package/src/op/op-waves-parallelism.test.ts +89 -0
- package/src/op/op-waves-pull-request.test.ts +219 -0
- package/src/op/op-waves-release-port.ts +64 -0
- package/src/op/op-waves-release.test.ts +209 -0
- package/src/op/op-waves-release.ts +132 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1235 -52
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +107 -0
- package/src/op/op-waves-trace.test.ts +205 -0
- package/src/op/op-waves.test.ts +112 -0
- package/src/op/op-waves.ts +320 -22
- package/src/op/runtime.ts +107 -0
- package/src/op/stage-hooks-hold-record.test.ts +41 -0
- package/src/op/stage-hooks.ts +91 -12
- package/src/op/steward-beside.ts +2 -1
- package/src/op/types.ts +3 -2
- package/src/otlp-metrics.ts +96 -0
- package/src/otlp.test.ts +243 -0
- package/src/otlp.ts +543 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/parallelism.test.ts +38 -0
- package/src/parallelism.ts +33 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +111 -0
- package/src/pr-forge-bundle.test.ts +1 -1
- package/src/pr-forge.ts +175 -33
- package/src/pr-loop-bundle.test.ts +7 -3
- package/src/pr-loop-narrowed.test.ts +63 -0
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.ts +398 -52
- package/src/pr-merge.test.ts +100 -0
- package/src/pr-merge.ts +105 -0
- package/src/pr-post-stale.test.ts +163 -0
- package/src/pr-post.ts +190 -5
- package/src/pr-report-url.ts +61 -6
- package/src/pr-requires.test.ts +37 -1
- package/src/pr-requires.ts +16 -2
- package/src/product-subpaths-plain-node.e2e.test.ts +212 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +28 -1
- package/src/scheduled-op-cloud.ts +68 -0
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +6 -0
- package/src/terraform/credentials.test.ts +77 -0
- package/src/terraform/credentials.ts +162 -0
- package/src/utils.ts +2 -11
- package/src/wave-loop-golden.test.ts +2 -1
- package/src/wave-runtime.ts +2 -2
- package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
- package/src/workspace/ci-lock-grain.test.ts +31 -0
- package/src/workspace/ci-lock-grain.ts +29 -0
- package/src/workspace/ci-report-url.test.ts +1 -1
- package/src/workspace/ci-run.test.ts +1 -1
- package/src/workspace/ci-run.ts +10 -3
- package/src/workspace/declaration.schema.json +27 -3
- package/src/workspace/declaration.test.ts +1 -1
- package/src/workspace/declaration.ts +26 -10
- package/src/workspace/drift-cli.ts +8 -3
- package/src/workspace/exit-cli.ts +2 -1
- package/src/workspace/import-fetch.ts +4 -2
- package/src/workspace/import-init.ts +4 -2
- package/src/workspace/ledger.schema.json +7 -3
- package/src/workspace/lineage-upgrade-cli.ts +2 -1
- package/src/workspace/pr-report.schema.json +79 -3
- package/src/workspace/promote.ts +2 -1
- package/src/workspace/records-cli.ts +3 -2
- package/src/workspace/release-catalog.schema.json +277 -0
- package/src/workspace/run-event.schema.json +18 -1
- package/src/workspace/work-cli.ts +8 -2
- package/src/workspace/workspace-run.ts +2 -1
|
@@ -0,0 +1,318 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The forge's side of the check (#4608), lifted from terragucci's
|
|
3
|
+
* `forge check` and widened to branch protection and required statuses:
|
|
4
|
+
*
|
|
5
|
+
* GitHub each apply job's forge environment exists and deploys from the
|
|
6
|
+
* default branch alone (protected branches, or one custom policy
|
|
7
|
+
* naming the default branch); each apply runner group is limited
|
|
8
|
+
* to selected workflows (org-level, so a token without
|
|
9
|
+
* Self-hosted runners: read gets `unknown`); each protected
|
|
10
|
+
* branch is protected by branch protection or a ruleset, and the
|
|
11
|
+
* default branch requires each required status
|
|
12
|
+
* GitLab each forge environment is protected (Premium: on another
|
|
13
|
+
* edition the row is `unknown`); every runner carrying an apply
|
|
14
|
+
* runner's tags takes protected refs only; each variable the apply
|
|
15
|
+
* jobs read is protected and scoped to their environment; each
|
|
16
|
+
* protected branch is protected; merge requests need a passing
|
|
17
|
+
* pipeline, which holds the required statuses
|
|
18
|
+
* Forgejo each protected branch is protected, and its rule checks each
|
|
19
|
+
* required status
|
|
20
|
+
*
|
|
21
|
+
* The default branch's head is read through chant's forge client
|
|
22
|
+
* (`branchHead` and `commitStatuses`, #4554), so a required status no job
|
|
23
|
+
* has posted yet shows as `unknown` before it blocks every merge.
|
|
24
|
+
*/
|
|
25
|
+
|
|
26
|
+
import { forgeClient, ForgeApiError, type ForgeFetch, type ForgeTarget } from "../pr-forge";
|
|
27
|
+
import type { ForgeCheckContract, ForgeCheckJob, LiveRepository } from "./contract";
|
|
28
|
+
import { ReadOnlyError } from "./read-only";
|
|
29
|
+
import { couldNot, SCOPES, unique, type CheckRow, type CheckStatus, type Read } from "./types";
|
|
30
|
+
|
|
31
|
+
const authHeaders = (t: ForgeTarget): Record<string, string> => {
|
|
32
|
+
if (t.kind === "gitlab") return t.token ? { [t.tokenHeader ?? "PRIVATE-TOKEN"]: t.token } : {};
|
|
33
|
+
if (t.kind === "github") return { ...(t.token ? { Authorization: `Bearer ${t.token}` } : {}), Accept: "application/vnd.github+json" };
|
|
34
|
+
return { ...(t.token ? { Authorization: `token ${t.token}` } : {}), Accept: "application/json" };
|
|
35
|
+
};
|
|
36
|
+
|
|
37
|
+
/** A GET of `path` under the target's REST base, parsed as JSON. */
|
|
38
|
+
export async function read<T>(fetch: ForgeFetch, t: ForgeTarget, path: string): Promise<Read<T>> {
|
|
39
|
+
const url = `${t.apiBase.replace(/\/+$/, "")}${path}`;
|
|
40
|
+
try {
|
|
41
|
+
const res = await fetch(url, { method: "GET", headers: authHeaders(t) });
|
|
42
|
+
const text = await res.text();
|
|
43
|
+
if (!res.ok) return { ok: false, status: res.status, why: text.slice(0, 300) };
|
|
44
|
+
return { ok: true, value: (text ? JSON.parse(text) : null) as T };
|
|
45
|
+
} catch (e) {
|
|
46
|
+
if (e instanceof ReadOnlyError) throw e;
|
|
47
|
+
return { ok: false, status: undefined, why: (e as Error).message };
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** The project path a GitLab call takes. */
|
|
52
|
+
const projectPath = (t: ForgeTarget): string => `/projects/${encodeURIComponent(decodeURIComponent(t.repo))}`;
|
|
53
|
+
|
|
54
|
+
/** The repository's default branch, full path and (Forgejo) numeric ids. */
|
|
55
|
+
export async function readRepository(fetch: ForgeFetch, t: ForgeTarget): Promise<Read<LiveRepository>> {
|
|
56
|
+
const r = await read<{ default_branch?: string; id?: number; full_name?: string; path_with_namespace?: string; owner?: { id?: number } }>(fetch, t, t.kind === "gitlab" ? projectPath(t) : `/repos/${t.repo}`);
|
|
57
|
+
if (!r.ok) return r;
|
|
58
|
+
const v = r.value ?? {};
|
|
59
|
+
const path = t.kind === "gitlab" ? v.path_with_namespace : v.full_name;
|
|
60
|
+
return {
|
|
61
|
+
ok: true,
|
|
62
|
+
value: {
|
|
63
|
+
...(v.default_branch ? { defaultBranch: v.default_branch } : {}),
|
|
64
|
+
...(path ? { path } : {}),
|
|
65
|
+
...(t.kind === "forgejo" && v.owner?.id !== undefined ? { ownerId: String(v.owner.id) } : {}),
|
|
66
|
+
...(t.kind === "forgejo" && v.id !== undefined ? { repoId: String(v.id) } : {}),
|
|
67
|
+
},
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
const applyJobs = (c: ForgeCheckContract): ForgeCheckJob[] => c.jobs.filter((j) => j.identity === "apply");
|
|
72
|
+
const forgeEnvironments = (c: ForgeCheckContract): string[] => unique(applyJobs(c).flatMap((j) => (j.forgeEnvironment ? [j.forgeEnvironment] : [])));
|
|
73
|
+
const protectedBranches = (c: ForgeCheckContract): string[] => unique(c.protectedBranches ?? [c.repository.defaultBranch]);
|
|
74
|
+
|
|
75
|
+
/** A branch glob as GitLab and Forgejo write them: `*` any run of characters. */
|
|
76
|
+
const branchGlob = (glob: string, branch: string): boolean => new RegExp(`^${glob.replace(/[.+^${}()|[\]\\?]/g, "\\$&").replace(/\*/g, ".*")}$`).test(branch);
|
|
77
|
+
|
|
78
|
+
/** One GitHub branch: whether branch protection or a ruleset protects it, and the status contexts either requires. */
|
|
79
|
+
async function githubBranch(fetch: ForgeFetch, t: ForgeTarget, b: string): Promise<{ found: string; status: CheckStatus; required: Read<string[]> }> {
|
|
80
|
+
type Checks = { contexts?: string[]; checks?: { context: string }[] } | null;
|
|
81
|
+
const br = await read<{ protected?: boolean; protection?: { required_status_checks?: Checks } }>(fetch, t, `/repos/${t.repo}/branches/${encodeURIComponent(b)}`);
|
|
82
|
+
if (!br.ok) return { found: br.status === 404 ? "no such branch" : couldNot(br, SCOPES.github), status: br.status === 404 ? "mismatch" : "unknown", required: br };
|
|
83
|
+
// Rulesets are readable with read access; a 404 means none applies.
|
|
84
|
+
const rules = await read<{ type: string; parameters?: { required_status_checks?: { context: string }[] } }[]>(fetch, t, `/repos/${t.repo}/rules/branches/${encodeURIComponent(b)}`);
|
|
85
|
+
const list = rules.ok && Array.isArray(rules.value) ? rules.value : [];
|
|
86
|
+
const kinds = unique(list.map((r) => r.type));
|
|
87
|
+
const byProtection = br.value?.protected === true;
|
|
88
|
+
const found = [...(byProtection ? ["branch protection"] : []), ...(kinds.length ? [`rulesets: ${kinds.join(", ")}`] : [])].join("; ") || "not protected";
|
|
89
|
+
const checks = br.value?.protection?.required_status_checks;
|
|
90
|
+
const contexts = unique([...(checks?.contexts ?? []), ...(checks?.checks ?? []).map((x) => x.context), ...list.flatMap((r) => (r.type === "required_status_checks" ? (r.parameters?.required_status_checks ?? []).map((x) => x.context) : []))]);
|
|
91
|
+
return { found, status: byProtection || kinds.length > 0 ? "match" : "mismatch", required: { ok: true, value: contexts } };
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
export async function githubRows(fetch: ForgeFetch, t: ForgeTarget, c: ForgeCheckContract): Promise<CheckRow[]> {
|
|
95
|
+
const rows: CheckRow[] = [];
|
|
96
|
+
const branch = c.repository.defaultBranch;
|
|
97
|
+
for (const env of forgeEnvironments(c)) {
|
|
98
|
+
const row = (check: string, expected: string, found: string, status: CheckStatus): number => rows.push({ where: "github", check, subject: env, expected, found, status });
|
|
99
|
+
const r = await read<{ deployment_branch_policy?: { protected_branches?: boolean; custom_branch_policies?: boolean } | null }>(fetch, t, `/repos/${t.repo}/environments/${encodeURIComponent(env)}`);
|
|
100
|
+
if (!r.ok) {
|
|
101
|
+
if (r.status === 404) row("environment", "exists", "missing", "mismatch");
|
|
102
|
+
else row("environment", "exists", couldNot(r, SCOPES.github), "unknown");
|
|
103
|
+
continue;
|
|
104
|
+
}
|
|
105
|
+
row("environment", "exists", "exists", "match");
|
|
106
|
+
const expected = `deploys from ${branch} only`;
|
|
107
|
+
const p = r.value?.deployment_branch_policy;
|
|
108
|
+
if (!p) {
|
|
109
|
+
row("deployment-branches", expected, "any branch: no deployment branch rule", "mismatch");
|
|
110
|
+
} else if (p.protected_branches) {
|
|
111
|
+
row("deployment-branches", expected, "protected branches", "match");
|
|
112
|
+
} else {
|
|
113
|
+
const b = await read<{ branch_policies?: { name: string; type?: string }[] }>(fetch, t, `/repos/${t.repo}/environments/${encodeURIComponent(env)}/deployment-branch-policies?per_page=100`);
|
|
114
|
+
if (!b.ok) {
|
|
115
|
+
row("deployment-branches", expected, couldNot(b, SCOPES.github), "unknown");
|
|
116
|
+
continue;
|
|
117
|
+
}
|
|
118
|
+
const list = b.value?.branch_policies ?? [];
|
|
119
|
+
const ok = list.length === 1 && list[0]!.name === branch && list[0]!.type !== "tag";
|
|
120
|
+
row("deployment-branches", expected, `custom: ${list.map((x) => `${x.name}${x.type === "tag" ? " (tag)" : ""}`).join(", ") || "none"}`, ok ? "match" : "mismatch");
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
const groups = unique(applyJobs(c).flatMap((j) => (j.runner?.group ? [j.runner.group] : [])));
|
|
124
|
+
if (groups.length) {
|
|
125
|
+
const owner = t.repo.split("/")[0]!;
|
|
126
|
+
const r = await read<{ runner_groups?: { name: string; restricted_to_workflows?: boolean; selected_workflows?: string[] }[] }>(fetch, t, `/orgs/${owner}/actions/runner-groups?per_page=100`);
|
|
127
|
+
for (const g of groups) {
|
|
128
|
+
const expected = "limited to selected workflows";
|
|
129
|
+
if (!r.ok) {
|
|
130
|
+
rows.push({ where: "github", check: "runner-group", subject: g, expected, found: couldNot(r, SCOPES.githubOrg), status: "unknown" });
|
|
131
|
+
continue;
|
|
132
|
+
}
|
|
133
|
+
const found = (r.value?.runner_groups ?? []).find((x) => x.name === g);
|
|
134
|
+
if (!found) rows.push({ where: "github", check: "runner-group", subject: g, expected, found: `no runner group ${g} in ${owner}`, status: "mismatch" });
|
|
135
|
+
else if (found.restricted_to_workflows) rows.push({ where: "github", check: "runner-group", subject: g, expected, found: `selected workflows: ${(found.selected_workflows ?? []).join(", ") || "none"}`, status: "match" });
|
|
136
|
+
else rows.push({ where: "github", check: "runner-group", subject: g, expected, found: "every workflow", status: "mismatch" });
|
|
137
|
+
}
|
|
138
|
+
}
|
|
139
|
+
const branches = unique([...protectedBranches(c), ...((c.requiredStatuses ?? []).length ? [branch] : [])]);
|
|
140
|
+
let def: Read<string[]> | undefined;
|
|
141
|
+
for (const b of branches) {
|
|
142
|
+
const g = await githubBranch(fetch, t, b);
|
|
143
|
+
if (b === branch) def = g.required;
|
|
144
|
+
if (!protectedBranches(c).includes(b)) continue;
|
|
145
|
+
rows.push({ where: "github", check: "protected-branch", subject: b, expected: "protected", found: g.found, status: g.status });
|
|
146
|
+
}
|
|
147
|
+
for (const ctx of c.requiredStatuses ?? []) {
|
|
148
|
+
const expected = `${branch} requires ${ctx} before a merge`;
|
|
149
|
+
if (!def || !def.ok) rows.push({ where: "github", check: "required-status", subject: ctx, expected, found: def ? couldNot(def, SCOPES.github) : "not read", status: "unknown" });
|
|
150
|
+
else rows.push({ where: "github", check: "required-status", subject: ctx, expected, found: def.value.length ? `required: ${def.value.join(", ")}` : "no required status", status: def.value.includes(ctx) ? "match" : "mismatch" });
|
|
151
|
+
}
|
|
152
|
+
return rows;
|
|
153
|
+
}
|
|
154
|
+
|
|
155
|
+
export async function gitlabRows(fetch: ForgeFetch, t: ForgeTarget, c: ForgeCheckContract): Promise<CheckRow[]> {
|
|
156
|
+
const rows: CheckRow[] = [];
|
|
157
|
+
const pid = projectPath(t);
|
|
158
|
+
const envs = forgeEnvironments(c);
|
|
159
|
+
if (envs.length) {
|
|
160
|
+
const r = await read<{ name: string }[]>(fetch, t, `${pid}/protected_environments?per_page=100`);
|
|
161
|
+
for (const env of envs) {
|
|
162
|
+
if (!r.ok) {
|
|
163
|
+
const why = r.status === 404 || r.status === 403 ? `could not read (${r.status}); ${SCOPES.gitlabEdition}` : couldNot(r, SCOPES.gitlab);
|
|
164
|
+
rows.push({ where: "gitlab", check: "protected-environment", subject: env, expected: "protected", found: why, status: "unknown" });
|
|
165
|
+
continue;
|
|
166
|
+
}
|
|
167
|
+
const ok = (r.value ?? []).some((p) => p.name === env);
|
|
168
|
+
rows.push({ where: "gitlab", check: "protected-environment", subject: env, expected: "protected", found: ok ? "protected" : "not protected", status: ok ? "match" : "mismatch" });
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
const tagSets = new Map<string, string[]>();
|
|
172
|
+
for (const j of applyJobs(c)) if (j.runner?.labels.length) tagSets.set([...j.runner.labels].sort().join(","), j.runner.labels);
|
|
173
|
+
for (const tags of tagSets.values()) {
|
|
174
|
+
const subject = `tags ${tags.join(", ")}`;
|
|
175
|
+
const expected = "every runner with these tags runs protected refs only (ref_protected)";
|
|
176
|
+
const r = await read<{ id: number; description?: string }[]>(fetch, t, `${pid}/runners?tag_list=${encodeURIComponent(tags.join(","))}&per_page=100`);
|
|
177
|
+
if (!r.ok) {
|
|
178
|
+
rows.push({ where: "gitlab", check: "protected-runners", subject, expected, found: couldNot(r, SCOPES.gitlab), status: "unknown" });
|
|
179
|
+
continue;
|
|
180
|
+
}
|
|
181
|
+
const runners = r.value ?? [];
|
|
182
|
+
if (runners.length === 0) {
|
|
183
|
+
rows.push({ where: "gitlab", check: "protected-runners", subject, expected, found: "no runner of the project carries these tags", status: "mismatch" });
|
|
184
|
+
continue;
|
|
185
|
+
}
|
|
186
|
+
const open: string[] = [];
|
|
187
|
+
let unread: string | undefined;
|
|
188
|
+
for (const runner of runners) {
|
|
189
|
+
const d = await read<{ access_level?: string }>(fetch, t, `/runners/${runner.id}`);
|
|
190
|
+
if (!d.ok) unread = couldNot(d, SCOPES.gitlab);
|
|
191
|
+
else if (d.value?.access_level !== "ref_protected") open.push(`#${runner.id}${runner.description ? ` (${runner.description})` : ""} ${d.value?.access_level ?? "no access level"}`);
|
|
192
|
+
}
|
|
193
|
+
if (open.length) rows.push({ where: "gitlab", check: "protected-runners", subject, expected, found: open.join("; "), status: "mismatch" });
|
|
194
|
+
else if (unread) rows.push({ where: "gitlab", check: "protected-runners", subject, expected, found: unread, status: "unknown" });
|
|
195
|
+
else rows.push({ where: "gitlab", check: "protected-runners", subject, expected, found: `${runners.length} runner(s), each ref_protected`, status: "match" });
|
|
196
|
+
}
|
|
197
|
+
const names = unique(c.gitlabVariables ?? []);
|
|
198
|
+
if (envs.length && names.length) {
|
|
199
|
+
const vars: { key: string; protected?: boolean; environment_scope?: string }[] = [];
|
|
200
|
+
let failed: Read<unknown> | undefined;
|
|
201
|
+
for (let page = 1; page <= 50; page++) {
|
|
202
|
+
const r = await read<typeof vars>(fetch, t, `${pid}/variables?per_page=100&page=${page}`);
|
|
203
|
+
if (!r.ok) {
|
|
204
|
+
failed = r;
|
|
205
|
+
break;
|
|
206
|
+
}
|
|
207
|
+
vars.push(...(r.value ?? []));
|
|
208
|
+
if ((r.value ?? []).length < 100) break;
|
|
209
|
+
}
|
|
210
|
+
for (const env of envs) {
|
|
211
|
+
for (const name of names) {
|
|
212
|
+
const subject = `${name} in ${env}`;
|
|
213
|
+
const expected = `scoped to ${env}, protected`;
|
|
214
|
+
if (failed && !failed.ok) {
|
|
215
|
+
rows.push({ where: "gitlab", check: "variable", subject, expected, found: couldNot(failed, SCOPES.gitlab), status: "unknown" });
|
|
216
|
+
continue;
|
|
217
|
+
}
|
|
218
|
+
const defs = vars.filter((v) => v.key === name);
|
|
219
|
+
if (defs.length === 0) {
|
|
220
|
+
rows.push({ where: "gitlab", check: "variable", subject, expected, found: "no project variable of this name (group and instance variables are not read)", status: "unknown" });
|
|
221
|
+
continue;
|
|
222
|
+
}
|
|
223
|
+
const mine = defs.find((v) => v.environment_scope === env);
|
|
224
|
+
const found = defs.map((v) => `scope ${v.environment_scope ?? "*"}, ${v.protected ? "protected" : "not protected"}`).join("; ");
|
|
225
|
+
rows.push({ where: "gitlab", check: "variable", subject, expected, found, status: mine?.protected ? "match" : "mismatch" });
|
|
226
|
+
}
|
|
227
|
+
}
|
|
228
|
+
}
|
|
229
|
+
const branches = protectedBranches(c);
|
|
230
|
+
const pb = await read<{ name: string }[]>(fetch, t, `${pid}/protected_branches?per_page=100`);
|
|
231
|
+
for (const b of branches) {
|
|
232
|
+
if (!pb.ok) {
|
|
233
|
+
rows.push({ where: "gitlab", check: "protected-branch", subject: b, expected: "protected", found: couldNot(pb, SCOPES.gitlab), status: "unknown" });
|
|
234
|
+
continue;
|
|
235
|
+
}
|
|
236
|
+
const rule = (pb.value ?? []).map((p) => p.name).find((n) => n === b || branchGlob(n, b));
|
|
237
|
+
rows.push({ where: "gitlab", check: "protected-branch", subject: b, expected: "protected", found: rule ? `protected by ${rule}` : "not protected", status: rule ? "match" : "mismatch" });
|
|
238
|
+
}
|
|
239
|
+
if ((c.requiredStatuses ?? []).length) {
|
|
240
|
+
const p = await read<{ only_allow_merge_if_pipeline_succeeds?: boolean; allow_merge_on_skipped_pipeline?: boolean }>(fetch, t, pid);
|
|
241
|
+
for (const ctx of c.requiredStatuses ?? []) {
|
|
242
|
+
const expected = `merge requests need a passing pipeline, which holds ${ctx}`;
|
|
243
|
+
if (!p.ok) {
|
|
244
|
+
rows.push({ where: "gitlab", check: "required-status", subject: ctx, expected, found: couldNot(p, SCOPES.gitlab), status: "unknown" });
|
|
245
|
+
continue;
|
|
246
|
+
}
|
|
247
|
+
const must = p.value?.only_allow_merge_if_pipeline_succeeds === true;
|
|
248
|
+
const skipped = p.value?.allow_merge_on_skipped_pipeline === true;
|
|
249
|
+
const found = must ? (skipped ? "pipelines must succeed, but a skipped pipeline may merge" : "pipelines must succeed") : "a merge request may merge with a failed pipeline";
|
|
250
|
+
rows.push({ where: "gitlab", check: "required-status", subject: ctx, expected, found, status: must && !skipped ? "match" : "mismatch" });
|
|
251
|
+
}
|
|
252
|
+
}
|
|
253
|
+
return rows;
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
export async function forgejoRows(fetch: ForgeFetch, t: ForgeTarget, c: ForgeCheckContract): Promise<CheckRow[]> {
|
|
257
|
+
const rows: CheckRow[] = [];
|
|
258
|
+
const r = await read<{ rule_name?: string; branch_name?: string; enable_status_check?: boolean; status_check_contexts?: string[] }[]>(fetch, t, `/repos/${t.repo}/branch_protections`);
|
|
259
|
+
const ruleOf = (b: string) => (r.ok ? (r.value ?? []).find((p) => { const n = p.rule_name || p.branch_name || ""; return n === b || (n !== "" && branchGlob(n, b)); }) : undefined);
|
|
260
|
+
for (const b of protectedBranches(c)) {
|
|
261
|
+
if (!r.ok) {
|
|
262
|
+
rows.push({ where: "forgejo", check: "protected-branch", subject: b, expected: "protected", found: couldNot(r, SCOPES.forgejo), status: "unknown" });
|
|
263
|
+
continue;
|
|
264
|
+
}
|
|
265
|
+
const rule = ruleOf(b);
|
|
266
|
+
const name = rule ? rule.rule_name || rule.branch_name : undefined;
|
|
267
|
+
rows.push({ where: "forgejo", check: "protected-branch", subject: b, expected: "protected", found: name ? `protected by rule ${name}` : "not protected", status: name ? "match" : "mismatch" });
|
|
268
|
+
}
|
|
269
|
+
const branch = c.repository.defaultBranch;
|
|
270
|
+
for (const ctx of c.requiredStatuses ?? []) {
|
|
271
|
+
const expected = `${branch} requires ${ctx} before a merge`;
|
|
272
|
+
if (!r.ok) {
|
|
273
|
+
rows.push({ where: "forgejo", check: "required-status", subject: ctx, expected, found: couldNot(r, SCOPES.forgejo), status: "unknown" });
|
|
274
|
+
continue;
|
|
275
|
+
}
|
|
276
|
+
const rule = ruleOf(branch);
|
|
277
|
+
const patterns = rule?.enable_status_check ? (rule.status_check_contexts ?? []) : [];
|
|
278
|
+
const ok = patterns.some((p) => p === ctx || branchGlob(p, ctx));
|
|
279
|
+
const found = !rule ? `${branch} has no protection rule` : !rule.enable_status_check ? "the rule checks no status" : `required: ${patterns.join(", ") || "none"}`;
|
|
280
|
+
rows.push({ where: "forgejo", check: "required-status", subject: ctx, expected, found, status: ok ? "match" : "mismatch" });
|
|
281
|
+
}
|
|
282
|
+
return rows;
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
/**
|
|
286
|
+
* Whether each required status has been posted on the default branch's
|
|
287
|
+
* head, read with chant's forge client (#4554). A required status no job
|
|
288
|
+
* posts blocks every merge, so its name is worth seeing next to the forge's
|
|
289
|
+
* list. One not posted yet is `unknown`: the pipeline may not have run.
|
|
290
|
+
*/
|
|
291
|
+
export async function statusReportedRows(fetch: ForgeFetch, t: ForgeTarget, c: ForgeCheckContract): Promise<CheckRow[]> {
|
|
292
|
+
const contexts = c.requiredStatuses ?? [];
|
|
293
|
+
if (!contexts.length) return [];
|
|
294
|
+
const branch = c.repository.defaultBranch;
|
|
295
|
+
const forge = forgeClient(t, fetch);
|
|
296
|
+
let head: string | undefined;
|
|
297
|
+
let posted: string[] | undefined;
|
|
298
|
+
let why: string | undefined;
|
|
299
|
+
try {
|
|
300
|
+
if (forge.branchHead) head = await forge.branchHead(branch);
|
|
301
|
+
else {
|
|
302
|
+
const b = await read<{ commit?: { id?: string } }>(fetch, t, `${projectPath(t)}/repository/branches/${encodeURIComponent(branch)}`);
|
|
303
|
+
head = b.ok ? b.value?.commit?.id : undefined;
|
|
304
|
+
}
|
|
305
|
+
if (head && forge.commitStatuses) posted = (await forge.commitStatuses(head, branch)).map((s) => s.context);
|
|
306
|
+
} catch (e) {
|
|
307
|
+
if (e instanceof ReadOnlyError) throw e;
|
|
308
|
+
why = e instanceof ForgeApiError ? `could not read (${e.status})` : `could not read: ${(e as Error).message}`;
|
|
309
|
+
}
|
|
310
|
+
return contexts.map((ctx): CheckRow => {
|
|
311
|
+
const expected = `${ctx} is posted on ${branch}`;
|
|
312
|
+
if (why) return { where: t.kind, check: "status-reported", subject: ctx, expected, found: why, status: "unknown" };
|
|
313
|
+
if (!head) return { where: t.kind, check: "status-reported", subject: ctx, expected, found: `could not read ${branch}'s head`, status: "unknown" };
|
|
314
|
+
if (!posted) return { where: t.kind, check: "status-reported", subject: ctx, expected, found: "the forge client reads no statuses", status: "unknown" };
|
|
315
|
+
const ok = posted.includes(ctx);
|
|
316
|
+
return { where: t.kind, check: "status-reported", subject: ctx, expected, found: ok ? `posted on ${head.slice(0, 12)}` : `not posted on ${head.slice(0, 12)}${posted.length ? ` (posted: ${posted.join(", ")})` : ""}`, status: ok ? "match" : "unknown" };
|
|
317
|
+
});
|
|
318
|
+
}
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* chant#4608: the forge and trust-policy check in CI core, shared by
|
|
3
|
+
* terragucci (`terragucci forge check`) and plywood (`plywood forge check`),
|
|
4
|
+
* and run as `chant ci forge-check`.
|
|
5
|
+
*
|
|
6
|
+
* It reads the live forge and cloud setup against a contract of jobs and
|
|
7
|
+
* identities (./contract.ts): each apply job's forge environment, runner
|
|
8
|
+
* groups and GitLab protected runners and variables, branch protection and
|
|
9
|
+
* required statuses, each AWS role's trust policy, each GCP workload
|
|
10
|
+
* identity provider's condition, each Azure app's federated credentials,
|
|
11
|
+
* and each Pulumi Cloud organization's OIDC issuer and its policies.
|
|
12
|
+
* Read-only: every call goes through ./read-only.ts.
|
|
13
|
+
*
|
|
14
|
+
* Lifted from terragucci's `packages/terragucci/src/forge-check.ts`, which
|
|
15
|
+
* terragucci#1282 deletes once it calls this.
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
export * from "./types";
|
|
19
|
+
export * from "./contract";
|
|
20
|
+
export { assertReadOnly, readOnly, ReadOnlyError, READ_ACTIONS } from "./read-only";
|
|
21
|
+
export { read, readRepository, githubRows, gitlabRows, forgejoRows, statusReportedRows } from "./forge";
|
|
22
|
+
export {
|
|
23
|
+
awsCredentials,
|
|
24
|
+
awsRows,
|
|
25
|
+
awsTrustPolicy,
|
|
26
|
+
trustJobs,
|
|
27
|
+
trustJob,
|
|
28
|
+
issuerKey,
|
|
29
|
+
compareTrust,
|
|
30
|
+
rolesOf,
|
|
31
|
+
gcpCondition,
|
|
32
|
+
celTerms,
|
|
33
|
+
celNarrowerOrEqual,
|
|
34
|
+
gcpRows,
|
|
35
|
+
federatedCredential,
|
|
36
|
+
azureRows,
|
|
37
|
+
AZURE_GRAPH_TOKEN_ENV,
|
|
38
|
+
type TrustJob,
|
|
39
|
+
type LiveValue,
|
|
40
|
+
type FederatedCredential,
|
|
41
|
+
} from "./trust";
|
|
42
|
+
export { pulumiRows, policyGrants, PULUMI_TOKEN_ENV } from "./pulumi";
|
|
43
|
+
export { forgeCheck, forgeCheckExit, describeForgeCheck, countRows, forgeCheckCommand, forgeCheckSchema, forgeCheckTarget, uncheckedClouds, ForgeCheckTargetError, type ForgeCheckInput } from "./check";
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pulumi Cloud's side of the check (#4608, for #4549's identities): the
|
|
3
|
+
* organization has the forge registered as an OIDC issuer, and the issuer's
|
|
4
|
+
* authorization policies give each token the contract names to its jobs
|
|
5
|
+
* and to no other subject.
|
|
6
|
+
*
|
|
7
|
+
* Two reads per organization, both GETs with `Authorization: token
|
|
8
|
+
* <PULUMI_ACCESS_TOKEN>`, as Pulumi Cloud's REST API documents them:
|
|
9
|
+
*
|
|
10
|
+
* GET <apiUrl>/api/orgs/<org>/oidc/issuers
|
|
11
|
+
* { oidcIssuers: [{ id, name, url, ... }] }
|
|
12
|
+
* GET <apiUrl>/api/orgs/<org>/auth/policies/oidcissuers/<issuer id>
|
|
13
|
+
* { policies: [{ decision, tokenType, teamName, userLogin,
|
|
14
|
+
* authorizedPermissions, rules: { sub, aud, ... } }] }
|
|
15
|
+
*
|
|
16
|
+
* A policy grants a token when its decision is `allow` and its token type
|
|
17
|
+
* (and team, user, or the organization's admin permission) is the
|
|
18
|
+
* identity's: `team:<name>`, `user:<login>`, `organization`,
|
|
19
|
+
* `organization:admin` (`pulumiTokenRequest` in ../ci-identity.ts). Its
|
|
20
|
+
* rules are claim values, where `*` stands for any text. A grant must admit
|
|
21
|
+
* each job that takes the token, and each grant's `sub` must be within some
|
|
22
|
+
* such job's subject. A grant with no `sub` rule admits any subject.
|
|
23
|
+
*
|
|
24
|
+
* The shapes follow Pulumi's documentation and are tested against a
|
|
25
|
+
* loopback fake only; no real organization has been read.
|
|
26
|
+
*/
|
|
27
|
+
|
|
28
|
+
import type { ForgeFetch } from "../pr-forge";
|
|
29
|
+
import type { ForgeCheckContract, JobToken } from "./contract";
|
|
30
|
+
import { ReadOnlyError } from "./read-only";
|
|
31
|
+
import { admits, hasWildcard, within, type LiveValue } from "./trust";
|
|
32
|
+
import { SCOPES, unique, type CheckRow, type CheckStatus, type ForgeCheckDeps } from "./types";
|
|
33
|
+
|
|
34
|
+
/** The variable holding a Pulumi access token that can read the organization's issuers. */
|
|
35
|
+
export const PULUMI_TOKEN_ENV = "PULUMI_ACCESS_TOKEN";
|
|
36
|
+
|
|
37
|
+
const DEFAULT_API = "https://api.pulumi.com";
|
|
38
|
+
|
|
39
|
+
interface PulumiIssuer {
|
|
40
|
+
id: string;
|
|
41
|
+
name?: string;
|
|
42
|
+
url?: string;
|
|
43
|
+
issuer?: string;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
interface PulumiPolicy {
|
|
47
|
+
decision?: string;
|
|
48
|
+
tokenType?: string;
|
|
49
|
+
teamName?: string;
|
|
50
|
+
userLogin?: string;
|
|
51
|
+
authorizedPermissions?: string[];
|
|
52
|
+
rules?: Record<string, unknown>;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** Whether a policy grants the token `identity` names; false for an identity Pulumi Cloud has no token for. */
|
|
56
|
+
export function policyGrants(p: PulumiPolicy, identity: string): boolean {
|
|
57
|
+
if ((p.decision ?? "").toLowerCase() !== "allow") return false;
|
|
58
|
+
const m = /^(team|user):(.+)$/.exec(identity);
|
|
59
|
+
if (m?.[1] === "team") return p.tokenType === "team" && p.teamName === m[2];
|
|
60
|
+
if (m?.[1] === "user") return p.tokenType === "personal" && p.userLogin === m[2];
|
|
61
|
+
if (identity === "organization") return p.tokenType === "organization" && !(p.authorizedPermissions ?? []).includes("admin");
|
|
62
|
+
if (identity === "organization:admin") return p.tokenType === "organization" && (p.authorizedPermissions ?? []).includes("admin");
|
|
63
|
+
return false;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
const ruleValues = (rules: Record<string, unknown> | undefined, claim: string): LiveValue[] | null => {
|
|
67
|
+
const v = rules?.[claim];
|
|
68
|
+
if (v === undefined) return null;
|
|
69
|
+
const list = typeof v === "string" ? [v] : Array.isArray(v) ? v.filter((x): x is string => typeof x === "string") : [];
|
|
70
|
+
return list.map((value) => ({ value, like: hasWildcard(value) }));
|
|
71
|
+
};
|
|
72
|
+
|
|
73
|
+
const sameIssuer = (a: string | undefined, b: string): boolean => a !== undefined && a.replace(/\/+$/, "") === b.replace(/\/+$/, "");
|
|
74
|
+
|
|
75
|
+
interface TokenJobs {
|
|
76
|
+
organization: string;
|
|
77
|
+
api: string;
|
|
78
|
+
audience: string;
|
|
79
|
+
/** Each token identity, with the tokens of the jobs that take it. */
|
|
80
|
+
tokens: Map<string, JobToken[]>;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/** Each organization the contract's jobs trade in, keyed by API and organization. */
|
|
84
|
+
function organizationsOf(c: ForgeCheckContract): TokenJobs[] {
|
|
85
|
+
const out = new Map<string, TokenJobs>();
|
|
86
|
+
for (const j of c.jobs) {
|
|
87
|
+
if (!j.pulumi) continue;
|
|
88
|
+
const api = (j.pulumi.apiUrl ?? DEFAULT_API).replace(/\/+$/, "");
|
|
89
|
+
const key = `${api} ${j.pulumi.organization}`;
|
|
90
|
+
const org = out.get(key) ?? { organization: j.pulumi.organization, api, audience: j.pulumi.audience, tokens: new Map<string, JobToken[]>() };
|
|
91
|
+
for (const t of j.pulumi.tokens) {
|
|
92
|
+
const have = org.tokens.get(t) ?? [];
|
|
93
|
+
if (!have.some((h) => h.subject === j.token.subject && h.issuer === j.token.issuer)) have.push(j.token);
|
|
94
|
+
org.tokens.set(t, have);
|
|
95
|
+
}
|
|
96
|
+
out.set(key, org);
|
|
97
|
+
}
|
|
98
|
+
return [...out.values()];
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
async function getJson<T>(fetch: ForgeFetch, url: string, token: string): Promise<{ ok: true; value: T } | { ok: false; status: number | undefined; why: string }> {
|
|
102
|
+
try {
|
|
103
|
+
const res = await fetch(url, { method: "GET", headers: { authorization: `token ${token}`, accept: "application/vnd.pulumi+8" } });
|
|
104
|
+
const text = await res.text();
|
|
105
|
+
if (!res.ok) return { ok: false, status: res.status, why: text.slice(0, 300) };
|
|
106
|
+
return { ok: true, value: JSON.parse(text) as T };
|
|
107
|
+
} catch (e) {
|
|
108
|
+
if (e instanceof ReadOnlyError) throw e;
|
|
109
|
+
return { ok: false, status: undefined, why: (e as Error).message };
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
export async function pulumiRows(c: ForgeCheckContract, fetch: ForgeFetch, deps: ForgeCheckDeps): Promise<CheckRow[]> {
|
|
114
|
+
const orgs = organizationsOf(c);
|
|
115
|
+
if (!orgs.length) return [];
|
|
116
|
+
const token = deps.env[PULUMI_TOKEN_ENV];
|
|
117
|
+
const rows: CheckRow[] = [];
|
|
118
|
+
for (const org of orgs) {
|
|
119
|
+
const issuers = unique([...org.tokens.values()].flat().map((t) => t.issuer));
|
|
120
|
+
const trustRow = (identity: string, expected: string, found: string, status: CheckStatus): number => rows.push({ where: "pulumi", check: "trust", subject: `${org.organization} ${identity}`, expected, found, status });
|
|
121
|
+
const expectedOf = (jobs: JobToken[]): string => jobs.map((t) => `sub ${t.subject}${t.pattern ? " (like)" : ""}`).join("; ");
|
|
122
|
+
if (!token) {
|
|
123
|
+
for (const issuer of issuers) rows.push({ where: "pulumi", check: "oidc-issuer", subject: `${org.organization} ${issuer}`, expected: "registered", found: `not checked: no Pulumi Cloud credentials (${PULUMI_TOKEN_ENV})`, status: "not-checked" });
|
|
124
|
+
for (const [identity, jobs] of org.tokens) trustRow(identity, expectedOf(jobs), `not checked: no Pulumi Cloud credentials (${PULUMI_TOKEN_ENV})`, "not-checked");
|
|
125
|
+
continue;
|
|
126
|
+
}
|
|
127
|
+
const base = `${org.api}/api/orgs/${encodeURIComponent(org.organization)}`;
|
|
128
|
+
const list = await getJson<{ oidcIssuers?: PulumiIssuer[] }>(fetch, `${base}/oidc/issuers`, token);
|
|
129
|
+
const registered = new Map<string, PulumiIssuer>();
|
|
130
|
+
for (const issuer of issuers) {
|
|
131
|
+
const subject = `${org.organization} ${issuer}`;
|
|
132
|
+
if (!list.ok) {
|
|
133
|
+
rows.push({ where: "pulumi", check: "oidc-issuer", subject, expected: "registered", found: `could not read (${list.status ?? "no answer"}); ${SCOPES.pulumi}`, status: "unknown" });
|
|
134
|
+
continue;
|
|
135
|
+
}
|
|
136
|
+
const found = (list.value.oidcIssuers ?? []).find((i) => sameIssuer(i.url, issuer) || sameIssuer(i.issuer, issuer));
|
|
137
|
+
if (found) registered.set(issuer, found);
|
|
138
|
+
rows.push({ where: "pulumi", check: "oidc-issuer", subject, expected: "registered", found: found ? `registered as ${found.name ?? found.id}` : "not registered", status: found ? "match" : "mismatch" });
|
|
139
|
+
}
|
|
140
|
+
const policies = new Map<string, { ok: true; value: PulumiPolicy[] } | { ok: false; why: string }>();
|
|
141
|
+
for (const [issuer, i] of registered) {
|
|
142
|
+
const r = await getJson<{ policies?: PulumiPolicy[] }>(fetch, `${base}/auth/policies/oidcissuers/${encodeURIComponent(i.id)}`, token);
|
|
143
|
+
policies.set(issuer, r.ok ? { ok: true, value: r.value.policies ?? [] } : { ok: false, why: `could not read (${r.status ?? "no answer"}); ${SCOPES.pulumi}` });
|
|
144
|
+
}
|
|
145
|
+
for (const [identity, jobs] of org.tokens) {
|
|
146
|
+
const expected = expectedOf(jobs);
|
|
147
|
+
const problems: string[] = [];
|
|
148
|
+
const seen: string[] = [];
|
|
149
|
+
let unread: string | undefined;
|
|
150
|
+
let unregistered = false;
|
|
151
|
+
for (const issuer of unique(jobs.map((t) => t.issuer))) {
|
|
152
|
+
const mine = jobs.filter((t) => t.issuer === issuer);
|
|
153
|
+
const p = policies.get(issuer);
|
|
154
|
+
if (!p) {
|
|
155
|
+
if (list.ok) unregistered = true;
|
|
156
|
+
else unread = `could not read the issuers; ${SCOPES.pulumi}`;
|
|
157
|
+
continue;
|
|
158
|
+
}
|
|
159
|
+
if (!p.ok) {
|
|
160
|
+
unread = p.why;
|
|
161
|
+
continue;
|
|
162
|
+
}
|
|
163
|
+
const grants = p.value.filter((x) => policyGrants(x, identity));
|
|
164
|
+
for (const g of grants) {
|
|
165
|
+
const subs = ruleValues(g.rules, "sub");
|
|
166
|
+
const auds = ruleValues(g.rules, "aud");
|
|
167
|
+
seen.push(`sub ${subs === null ? "any" : subs.map((s) => s.value).join(" | ")}${auds ? ` aud ${auds.map((a) => a.value).join(" | ")}` : ""}`);
|
|
168
|
+
if (subs === null) {
|
|
169
|
+
problems.push(`a policy grants ${identity} with no sub rule, so it admits any subject of the issuer`);
|
|
170
|
+
continue;
|
|
171
|
+
}
|
|
172
|
+
for (const s of subs) if (!mine.some((t) => within(s, t.subject, t.pattern))) problems.push(`grants ${identity} to sub ${s.value}${s.like ? " (like)" : ""}, which no job that takes it presents`);
|
|
173
|
+
if (auds) for (const a of auds) if (!within(a, org.audience, false)) problems.push(`grants ${identity} to aud ${a.value}, not ${org.audience}`);
|
|
174
|
+
}
|
|
175
|
+
for (const t of mine) {
|
|
176
|
+
const ok = grants.some((g) => {
|
|
177
|
+
const subs = ruleValues(g.rules, "sub");
|
|
178
|
+
const auds = ruleValues(g.rules, "aud");
|
|
179
|
+
return (subs === null || subs.some((s) => admits(s, t.subject, t.pattern))) && (auds === null || auds.some((a) => admits(a, org.audience, false)));
|
|
180
|
+
});
|
|
181
|
+
if (!ok) problems.push(`no policy grants ${identity} to sub ${t.subject}${t.pattern ? " (like)" : ""}`);
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
const found = seen.length ? seen.join("; ") : "no policy grants it";
|
|
185
|
+
if (problems.length) trustRow(identity, expected, `${found}; ${unique(problems).join("; ")}`, "mismatch");
|
|
186
|
+
else if (unregistered) trustRow(identity, expected, "the forge is not a registered issuer", "mismatch");
|
|
187
|
+
else if (unread) trustRow(identity, expected, unread, "unknown");
|
|
188
|
+
else trustRow(identity, expected, found, "match");
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
return rows;
|
|
192
|
+
}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The forge check's one way out (#4608): every request it makes passes
|
|
3
|
+
* {@link assertReadOnly} first. GET and HEAD go through, and a POST only
|
|
4
|
+
* when it is an AWS Query API read named in {@link READ_ACTIONS}. Anything
|
|
5
|
+
* else is refused before it is sent, so the check cannot write to a forge,
|
|
6
|
+
* a cloud or Pulumi Cloud.
|
|
7
|
+
*
|
|
8
|
+
* Lifted from terragucci's `forge check` (INTENTIUS/terragucci
|
|
9
|
+
* packages/terragucci/src/forge-check.ts, `assertReadOnly` and `readOnly`).
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
import type { ForgeFetch } from "../pr-forge";
|
|
13
|
+
|
|
14
|
+
/** The AWS Query API actions a request may name: reads alone. */
|
|
15
|
+
export const READ_ACTIONS: readonly string[] = ["GetRole"];
|
|
16
|
+
|
|
17
|
+
export class ReadOnlyError extends Error {
|
|
18
|
+
constructor(message: string) {
|
|
19
|
+
super(message);
|
|
20
|
+
this.name = "ReadOnlyError";
|
|
21
|
+
}
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* Refuse any request that could write: a method other than GET or HEAD, or an
|
|
26
|
+
* AWS Query action (`Action=` in the query or a form body) not in
|
|
27
|
+
* READ_ACTIONS. A POST passes only as such a read action, which the Query API
|
|
28
|
+
* takes as GET or POST alike. `command` names the command in the message.
|
|
29
|
+
*/
|
|
30
|
+
export function assertReadOnly(url: string, method: string, body?: string, command = "chant ci forge-check"): void {
|
|
31
|
+
const m = method.toUpperCase();
|
|
32
|
+
let queryAction: string | null = null;
|
|
33
|
+
try {
|
|
34
|
+
queryAction = new URL(url).searchParams.get("Action");
|
|
35
|
+
} catch {
|
|
36
|
+
throw new ReadOnlyError(`${command} refuses ${m} ${url}: not a URL`);
|
|
37
|
+
}
|
|
38
|
+
const named = (a: string | null): boolean => a === null || READ_ACTIONS.includes(a);
|
|
39
|
+
if (m === "GET" || m === "HEAD") {
|
|
40
|
+
if (named(queryAction)) return;
|
|
41
|
+
throw new ReadOnlyError(`${command} is read-only: it refuses the action ${queryAction} (${m} ${url}); it may call ${READ_ACTIONS.join(", ")}`);
|
|
42
|
+
}
|
|
43
|
+
if (m === "POST" && typeof body === "string") {
|
|
44
|
+
const bodyAction = new URLSearchParams(body).get("Action");
|
|
45
|
+
if (bodyAction !== null && READ_ACTIONS.includes(bodyAction) && named(queryAction)) return;
|
|
46
|
+
}
|
|
47
|
+
throw new ReadOnlyError(`${command} is read-only: it refuses ${m} ${url}`);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/** `fetch`, refusing every request {@link assertReadOnly} refuses before it is sent. */
|
|
51
|
+
export function readOnly(fetch: ForgeFetch, command?: string): ForgeFetch {
|
|
52
|
+
return async (url, init) => {
|
|
53
|
+
assertReadOnly(url, init.method, init.body, command);
|
|
54
|
+
return fetch(url, init);
|
|
55
|
+
};
|
|
56
|
+
}
|