@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,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The forge check (#4608): a contract (./contract.ts) next to the live
|
|
3
|
+
* forge, the clouds and Pulumi Cloud, one row per expected setting.
|
|
4
|
+
*
|
|
5
|
+
* Statuses: `match`, `mismatch`, `unknown` (the setting could not be read)
|
|
6
|
+
* and `not-checked` (no credentials for that cloud). Only a mismatch fails,
|
|
7
|
+
* and with `requireClouds` a cloud left unchecked. The exit code is chant's
|
|
8
|
+
* `failed` then, else `done` (../exit-codes.ts).
|
|
9
|
+
*
|
|
10
|
+
* The product's words name the command in messages and the result's schema
|
|
11
|
+
* (`terragucci.forge-check/v1`, `plywood.forge-check/v1`), so `terragucci
|
|
12
|
+
* forge check`, `plywood forge check` and `chant ci forge-check` call this
|
|
13
|
+
* one function.
|
|
14
|
+
*/
|
|
15
|
+
import { type IdentityCloud } from "../ci-identity.js";
|
|
16
|
+
import { type CiProductWords, type CiProductWordsInput } from "../ci-product-words.js";
|
|
17
|
+
import { type ForgeKind, type ForgeTarget } from "../pr-forge.js";
|
|
18
|
+
import type { ForgeCheckContract, LiveRepository } from "./contract.js";
|
|
19
|
+
import { type CheckRow, type CheckStatus, type ForgeCheckDeps, type ForgeCheckResult } from "./types.js";
|
|
20
|
+
/** The command a product's words name: `chant ci forge-check`, or `<product> forge check`. */
|
|
21
|
+
export declare const forgeCheckCommand: (words: CiProductWords) => string;
|
|
22
|
+
/** The result's schema for a product. */
|
|
23
|
+
export declare const forgeCheckSchema: (words: CiProductWords) => string;
|
|
24
|
+
export interface ForgeCheckInput {
|
|
25
|
+
/** The forge, its REST base and a token (`forgeCheckTarget`, or `forgeTargetFromEnv` in ../pr-forge.ts). */
|
|
26
|
+
target: ForgeTarget;
|
|
27
|
+
/**
|
|
28
|
+
* The contract, or a function that builds it once the repository's own
|
|
29
|
+
* default branch, path and (Forgejo) numeric ids are read, since the jobs'
|
|
30
|
+
* subjects hold them.
|
|
31
|
+
*/
|
|
32
|
+
contract: ForgeCheckContract | ((live: LiveRepository) => ForgeCheckContract);
|
|
33
|
+
/** Fail a cloud left unchecked for want of credentials too. */
|
|
34
|
+
requireClouds?: boolean;
|
|
35
|
+
words?: CiProductWordsInput | CiProductWords;
|
|
36
|
+
/** The config the contract came from, for the result. */
|
|
37
|
+
file?: string;
|
|
38
|
+
}
|
|
39
|
+
export declare function countRows(rows: readonly CheckRow[]): Record<CheckStatus, number>;
|
|
40
|
+
/** Run the check. Every request goes through ./read-only.ts; a write is refused before it is sent. */
|
|
41
|
+
export declare function forgeCheck(input: ForgeCheckInput, deps: ForgeCheckDeps): Promise<ForgeCheckResult>;
|
|
42
|
+
/** chant's `failed` on a mismatch, or a cloud left unchecked with `requireClouds`; `done` otherwise. */
|
|
43
|
+
export declare const forgeCheckExit: (r: ForgeCheckResult) => number;
|
|
44
|
+
/** The table the command prints without --json, and a line of counts. */
|
|
45
|
+
export declare function describeForgeCheck(r: ForgeCheckResult): string;
|
|
46
|
+
/** The clouds a result left unchecked for want of credentials. */
|
|
47
|
+
export declare const uncheckedClouds: (r: ForgeCheckResult) => IdentityCloud[];
|
|
48
|
+
export declare class ForgeCheckTargetError extends Error {
|
|
49
|
+
constructor(message: string);
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* The forge to read, from the environment a person or a job has: the forge
|
|
53
|
+
* (`kind`, else the job's own), the repository (`repo`, else the job's),
|
|
54
|
+
* the REST base and a token in {@link FORGE_TOKEN_ORDER}. Unlike
|
|
55
|
+
* `forgeTargetFromEnv` it needs no pull request and runs on a laptop with
|
|
56
|
+
* `--repo` and a token.
|
|
57
|
+
*/
|
|
58
|
+
export declare function forgeCheckTarget(env: Record<string, string | undefined>, opts?: {
|
|
59
|
+
kind?: ForgeKind;
|
|
60
|
+
repo?: string;
|
|
61
|
+
tokenEnv?: string;
|
|
62
|
+
}): ForgeTarget;
|
|
63
|
+
//# sourceMappingURL=check.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/forge-check/check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAuB,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEzG,OAAO,EAAqB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKrE,OAAO,EAAoC,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAExI,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,UAAW,cAAc,KAAG,MAA+F,CAAC;AAE1J,yCAAyC;AACzC,eAAO,MAAM,gBAAgB,UAAW,cAAc,KAAG,MAA2C,CAAC;AAErG,MAAM,WAAW,eAAe;IAC9B,4GAA4G;IAC5G,MAAM,EAAE,WAAW,CAAC;IACpB;;;;OAIG;IACH,QAAQ,EAAE,kBAAkB,GAAG,CAAC,CAAC,IAAI,EAAE,cAAc,KAAK,kBAAkB,CAAC,CAAC;IAC9E,+DAA+D;IAC/D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,mBAAmB,GAAG,cAAc,CAAC;IAC7C,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAIhF;AAED,sGAAsG;AACtG,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8BxG;AAED,wGAAwG;AACxG,eAAO,MAAM,cAAc,MAAO,gBAAgB,KAAG,MAAsD,CAAC;AAI5G,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAW9D;AAED,kEAAkE;AAClE,eAAO,MAAM,eAAe,MAAO,gBAAgB,KAAG,aAAa,EAA4G,CAAC;AAEhL,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAWD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,WAAW,CAsBxJ"}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The forge check (#4608): a contract (./contract.ts) next to the live
|
|
3
|
+
* forge, the clouds and Pulumi Cloud, one row per expected setting.
|
|
4
|
+
*
|
|
5
|
+
* Statuses: `match`, `mismatch`, `unknown` (the setting could not be read)
|
|
6
|
+
* and `not-checked` (no credentials for that cloud). Only a mismatch fails,
|
|
7
|
+
* and with `requireClouds` a cloud left unchecked. The exit code is chant's
|
|
8
|
+
* `failed` then, else `done` (../exit-codes.ts).
|
|
9
|
+
*
|
|
10
|
+
* The product's words name the command in messages and the result's schema
|
|
11
|
+
* (`terragucci.forge-check/v1`, `plywood.forge-check/v1`), so `terragucci
|
|
12
|
+
* forge check`, `plywood forge check` and `chant ci forge-check` call this
|
|
13
|
+
* one function.
|
|
14
|
+
*/
|
|
15
|
+
import { IDENTITY_CLOUDS } from "../ci-identity.js";
|
|
16
|
+
import { resolveProductWords } from "../ci-product-words.js";
|
|
17
|
+
import { CHANT_EXIT } from "../exit-codes.js";
|
|
18
|
+
import { FORGE_TOKEN_ORDER } from "../pr-forge.js";
|
|
19
|
+
import { forgejoRows, githubRows, gitlabRows, readRepository, statusReportedRows } from "./forge.js";
|
|
20
|
+
import { pulumiRows } from "./pulumi.js";
|
|
21
|
+
import { readOnly } from "./read-only.js";
|
|
22
|
+
import { awsRows, azureRows, gcpRows } from "./trust.js";
|
|
23
|
+
import { CHECK_STATUSES, couldNot, SCOPES } from "./types.js";
|
|
24
|
+
/** The command a product's words name: `chant ci forge-check`, or `<product> forge check`. */
|
|
25
|
+
export const forgeCheckCommand = (words) => (words.product === "chant" ? "chant ci forge-check" : `${words.product} forge check`);
|
|
26
|
+
/** The result's schema for a product. */
|
|
27
|
+
export const forgeCheckSchema = (words) => `${words.product}.forge-check/v1`;
|
|
28
|
+
export function countRows(rows) {
|
|
29
|
+
const counts = Object.fromEntries(CHECK_STATUSES.map((s) => [s, 0]));
|
|
30
|
+
for (const r of rows)
|
|
31
|
+
counts[r.status]++;
|
|
32
|
+
return counts;
|
|
33
|
+
}
|
|
34
|
+
/** Run the check. Every request goes through ./read-only.ts; a write is refused before it is sent. */
|
|
35
|
+
export async function forgeCheck(input, deps) {
|
|
36
|
+
const words = resolveProductWords(input.words);
|
|
37
|
+
const command = forgeCheckCommand(words);
|
|
38
|
+
const fetch = readOnly(deps.fetch, command);
|
|
39
|
+
const t = input.target;
|
|
40
|
+
const repo = await readRepository(fetch, t);
|
|
41
|
+
const live = repo.ok ? repo.value : {};
|
|
42
|
+
const contract = typeof input.contract === "function" ? input.contract(live) : input.contract;
|
|
43
|
+
const rows = [];
|
|
44
|
+
if (!repo.ok) {
|
|
45
|
+
const need = t.kind === "github" ? SCOPES.github : t.kind === "gitlab" ? SCOPES.gitlab : SCOPES.forgejo;
|
|
46
|
+
rows.push({ where: t.kind, check: "repository", subject: contract.repository.path, expected: "readable", found: couldNot(repo, `${need}, in ${t.tokenSource}`), status: "unknown" });
|
|
47
|
+
}
|
|
48
|
+
else {
|
|
49
|
+
if (t.kind === "github")
|
|
50
|
+
rows.push(...(await githubRows(fetch, t, contract)));
|
|
51
|
+
else if (t.kind === "gitlab")
|
|
52
|
+
rows.push(...(await gitlabRows(fetch, t, contract)));
|
|
53
|
+
else
|
|
54
|
+
rows.push(...(await forgejoRows(fetch, t, contract)));
|
|
55
|
+
rows.push(...(await statusReportedRows(fetch, t, contract)));
|
|
56
|
+
}
|
|
57
|
+
rows.push(...(await awsRows(contract, fetch, deps, words.product)), ...(await gcpRows(contract, fetch, deps)), ...(await azureRows(contract, fetch, deps)), ...(await pulumiRows(contract, fetch, deps)));
|
|
58
|
+
const counts = countRows(rows);
|
|
59
|
+
const unchecked = rows.some((r) => r.status === "not-checked" && IDENTITY_CLOUDS.includes(r.where));
|
|
60
|
+
return {
|
|
61
|
+
schema: forgeCheckSchema(words),
|
|
62
|
+
...(input.file ? { file: input.file } : {}),
|
|
63
|
+
forge: contract.forge,
|
|
64
|
+
repository: contract.repository,
|
|
65
|
+
rows,
|
|
66
|
+
counts,
|
|
67
|
+
ok: counts.mismatch === 0 && !(input.requireClouds && unchecked),
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
/** chant's `failed` on a mismatch, or a cloud left unchecked with `requireClouds`; `done` otherwise. */
|
|
71
|
+
export const forgeCheckExit = (r) => (r.ok ? CHANT_EXIT.done : CHANT_EXIT.failed);
|
|
72
|
+
const MATCH_WORD = { match: "yes", mismatch: "no", unknown: "unknown", "not-checked": "not checked" };
|
|
73
|
+
/** The table the command prints without --json, and a line of counts. */
|
|
74
|
+
export function describeForgeCheck(r) {
|
|
75
|
+
const head = ["WHERE", "CHECK", "SUBJECT", "EXPECTED", "FOUND", "MATCH"];
|
|
76
|
+
const body = r.rows.map((x) => [x.where, x.check, x.subject, x.expected, x.found, MATCH_WORD[x.status]]);
|
|
77
|
+
const widths = head.map((h, i) => Math.max(h.length, ...body.map((b) => b[i].length)));
|
|
78
|
+
const line = (cells) => cells.map((c, i) => (i === cells.length - 1 ? c : c.padEnd(widths[i]))).join(" ");
|
|
79
|
+
const c = r.counts;
|
|
80
|
+
const out = [`${r.file ? `${r.file}: ` : ""}${r.forge} ${r.repository.host}/${r.repository.path} (default branch ${r.repository.defaultBranch})`, ""];
|
|
81
|
+
if (body.length)
|
|
82
|
+
out.push(line(head), ...body.map(line), "");
|
|
83
|
+
else
|
|
84
|
+
out.push("nothing to check: no forge environment, apply runner, protected branch, required status or cloud identity in the contract", "");
|
|
85
|
+
out.push(`${c.match} match, ${c.mismatch} mismatch, ${c.unknown} could not be read, ${c["not-checked"]} not checked`);
|
|
86
|
+
return out.join("\n");
|
|
87
|
+
}
|
|
88
|
+
/** The clouds a result left unchecked for want of credentials. */
|
|
89
|
+
export const uncheckedClouds = (r) => IDENTITY_CLOUDS.filter((cloud) => r.rows.some((x) => x.where === cloud && x.status === "not-checked"));
|
|
90
|
+
export class ForgeCheckTargetError extends Error {
|
|
91
|
+
constructor(message) {
|
|
92
|
+
super(message);
|
|
93
|
+
this.name = "ForgeCheckTargetError";
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
const hostOf = (url) => {
|
|
97
|
+
if (!url)
|
|
98
|
+
return undefined;
|
|
99
|
+
try {
|
|
100
|
+
return new URL(url).host.toLowerCase();
|
|
101
|
+
}
|
|
102
|
+
catch {
|
|
103
|
+
return undefined;
|
|
104
|
+
}
|
|
105
|
+
};
|
|
106
|
+
/**
|
|
107
|
+
* The forge to read, from the environment a person or a job has: the forge
|
|
108
|
+
* (`kind`, else the job's own), the repository (`repo`, else the job's),
|
|
109
|
+
* the REST base and a token in {@link FORGE_TOKEN_ORDER}. Unlike
|
|
110
|
+
* `forgeTargetFromEnv` it needs no pull request and runs on a laptop with
|
|
111
|
+
* `--repo` and a token.
|
|
112
|
+
*/
|
|
113
|
+
export function forgeCheckTarget(env, opts = {}) {
|
|
114
|
+
const pick = (...names) => names.map((n) => env[n]?.trim()).find((v) => v !== undefined && v !== "");
|
|
115
|
+
const kind = opts.kind ?? (env.GITLAB_CI ? "gitlab" : env.FORGEJO_ACTIONS || env.FORGEJO_SERVER_URL ? "forgejo" : env.GITHUB_ACTIONS || env.GITHUB_REPOSITORY ? "github" : undefined);
|
|
116
|
+
if (!kind)
|
|
117
|
+
throw new ForgeCheckTargetError("cannot tell the forge: pass --forge github|gitlab|forgejo");
|
|
118
|
+
const names = opts.tokenEnv ? [opts.tokenEnv] : FORGE_TOKEN_ORDER[kind];
|
|
119
|
+
const tokenSource = names.find((n) => env[n]?.trim()) ?? names[0];
|
|
120
|
+
const token = env[tokenSource]?.trim() ?? "";
|
|
121
|
+
if (kind === "gitlab") {
|
|
122
|
+
const server = pick("CI_SERVER_URL")?.replace(/\/+$/, "") ?? "https://gitlab.com";
|
|
123
|
+
const apiBase = pick("CI_API_V4_URL")?.replace(/\/+$/, "") ?? `${server}/api/v4`;
|
|
124
|
+
const repo = opts.repo ?? pick("CI_PROJECT_PATH", "CI_PROJECT_ID");
|
|
125
|
+
if (!repo)
|
|
126
|
+
throw new ForgeCheckTargetError("cannot tell the project: pass --repo <group/project>, or run in a GitLab job");
|
|
127
|
+
return { kind, apiBase, repo, host: pick("CI_SERVER_HOST")?.toLowerCase() ?? hostOf(server) ?? "gitlab.com", token, tokenSource, tokenHeader: tokenSource === "CI_JOB_TOKEN" ? "JOB-TOKEN" : "PRIVATE-TOKEN" };
|
|
128
|
+
}
|
|
129
|
+
const fj = kind === "forgejo";
|
|
130
|
+
const read = (name) => (fj ? pick(`FORGEJO_${name}`, `GITHUB_${name}`) : pick(`GITHUB_${name}`));
|
|
131
|
+
const server = read("SERVER_URL")?.replace(/\/+$/, "");
|
|
132
|
+
const apiBase = read("API_URL")?.replace(/\/+$/, "") ?? (fj ? (server ? `${server}/api/v1` : undefined) : "https://api.github.com");
|
|
133
|
+
if (!apiBase)
|
|
134
|
+
throw new ForgeCheckTargetError("cannot tell the Forgejo instance: set FORGEJO_SERVER_URL");
|
|
135
|
+
const repo = opts.repo ?? read("REPOSITORY");
|
|
136
|
+
if (!repo)
|
|
137
|
+
throw new ForgeCheckTargetError("cannot tell the repository: pass --repo <owner/name>, or run in a forge job");
|
|
138
|
+
return { kind, apiBase, repo, host: hostOf(server) ?? (fj ? hostOf(apiBase) : "github.com"), token, tokenSource };
|
|
139
|
+
}
|
|
@@ -0,0 +1,152 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The forge check's contract (#4608): each job a pipeline runs, the OIDC
|
|
3
|
+
* token it presents, and the identities it trades that token for, with the
|
|
4
|
+
* branches and statuses the forge should protect. The check compares the
|
|
5
|
+
* live forge, the clouds and Pulumi Cloud with it.
|
|
6
|
+
*
|
|
7
|
+
* A product builds the contract from its own config, or chant builds it
|
|
8
|
+
* from `ci.identity.cloud` with {@link pipelineContract}: per pipeline, a
|
|
9
|
+
* plan job on the pull request, a record job on the default branch with the
|
|
10
|
+
* plan identities, and an apply job on the default branch (or in its forge
|
|
11
|
+
* environment) with the apply identities, as chant's generated pipelines
|
|
12
|
+
* run them (../ci-identity.ts).
|
|
13
|
+
*
|
|
14
|
+
* Subjects, by forge (terragucci's `identities.ts`, lifted here):
|
|
15
|
+
*
|
|
16
|
+
* GitHub repo:ORG/REPO:pull_request, repo:ORG/REPO:environment:NAME,
|
|
17
|
+
* repo:ORG/REPO:ref:refs/heads/BRANCH; issuer
|
|
18
|
+
* https://token.actions.githubusercontent.com, or
|
|
19
|
+
* https://<host>/_services/token on GitHub Enterprise Server
|
|
20
|
+
* GitLab project_path:GROUP/PROJECT:ref_type:branch:ref:BRANCH; a merge
|
|
21
|
+
* request pipeline's ref is its source branch, so the plan job's
|
|
22
|
+
* subject is a pattern over every branch. A job in a forge
|
|
23
|
+
* environment also carries `environment`, `environment_protected`
|
|
24
|
+
* and `ref_protected`. The issuer is the instance's URL.
|
|
25
|
+
* Forgejo repo:<owner>-<owner id>/<repo>-<repo id>:ref:refs/heads/BRANCH,
|
|
26
|
+
* and :pull_request for a pull request; the issuer is
|
|
27
|
+
* <origin>/api/actions. No claim tells environments apart.
|
|
28
|
+
*/
|
|
29
|
+
import type { PipelineCloudIdentity, CloudTradeSpec, IdentityCloud } from "../ci-identity.js";
|
|
30
|
+
import { type CiProductWords, type CiProductWordsInput } from "../ci-product-words.js";
|
|
31
|
+
import type { ForgeKind } from "../pr-forge.js";
|
|
32
|
+
/** What a job's OIDC token says about it. */
|
|
33
|
+
export interface JobToken {
|
|
34
|
+
issuer: string;
|
|
35
|
+
/** The `sub` claim. With `pattern`, `*` stands for any text. */
|
|
36
|
+
subject: string;
|
|
37
|
+
pattern: boolean;
|
|
38
|
+
/** Claims besides `sub` and `aud` a trust can check: GitLab's environment claims on a job in a forge environment. */
|
|
39
|
+
claims: Record<string, string>;
|
|
40
|
+
/** Parts of `subject` the contract could not know, written `<name>` (Forgejo's numeric ids before the repository is read). */
|
|
41
|
+
placeholders: string[];
|
|
42
|
+
}
|
|
43
|
+
export interface ForgeCheckRepository {
|
|
44
|
+
/** Lower-cased, such as `github.com`. */
|
|
45
|
+
host: string;
|
|
46
|
+
/** owner/name, or a GitLab project's full path. */
|
|
47
|
+
path: string;
|
|
48
|
+
defaultBranch: string;
|
|
49
|
+
/** Forgejo's numeric ids, which its subjects hold. */
|
|
50
|
+
ownerId?: string;
|
|
51
|
+
repoId?: string;
|
|
52
|
+
}
|
|
53
|
+
export interface JobRunner {
|
|
54
|
+
labels: string[];
|
|
55
|
+
/** A GitHub runner group. */
|
|
56
|
+
group?: string;
|
|
57
|
+
}
|
|
58
|
+
/** One job of the pipeline and the identities it trades for. */
|
|
59
|
+
export interface ForgeCheckJob {
|
|
60
|
+
/** As rows name it, such as `production plan` or `prod/web up`. */
|
|
61
|
+
name: string;
|
|
62
|
+
/** Which of the rule's two identities the job takes. */
|
|
63
|
+
identity: "plan" | "apply";
|
|
64
|
+
token: JobToken;
|
|
65
|
+
/** The forge environment the job runs in (GitHub and GitLab). */
|
|
66
|
+
forgeEnvironment?: string;
|
|
67
|
+
runner?: JobRunner;
|
|
68
|
+
aws?: {
|
|
69
|
+
roles: string[];
|
|
70
|
+
audience: string;
|
|
71
|
+
};
|
|
72
|
+
gcp?: {
|
|
73
|
+
provider: string;
|
|
74
|
+
audience: string;
|
|
75
|
+
};
|
|
76
|
+
azure?: {
|
|
77
|
+
clientIds: string[];
|
|
78
|
+
audience: string;
|
|
79
|
+
};
|
|
80
|
+
/** Pulumi Cloud (#4549): the access tokens the job trades for, such as `team:deployers`. */
|
|
81
|
+
pulumi?: {
|
|
82
|
+
organization: string;
|
|
83
|
+
tokens: string[];
|
|
84
|
+
audience: string;
|
|
85
|
+
apiUrl?: string;
|
|
86
|
+
};
|
|
87
|
+
}
|
|
88
|
+
export interface ForgeCheckContract {
|
|
89
|
+
forge: ForgeKind;
|
|
90
|
+
repository: ForgeCheckRepository;
|
|
91
|
+
jobs: ForgeCheckJob[];
|
|
92
|
+
/** Branches the forge should protect. Default: the default branch. */
|
|
93
|
+
protectedBranches?: string[];
|
|
94
|
+
/** Status contexts the default branch should require before a merge, such as `plywood/preview`. Default none. */
|
|
95
|
+
requiredStatuses?: string[];
|
|
96
|
+
/** GitLab: the variables the apply jobs read, each of which should be protected and scoped to their forge environment. */
|
|
97
|
+
gitlabVariables?: string[];
|
|
98
|
+
}
|
|
99
|
+
/** What the forge's repository read adds to a contract: its default branch, full path and Forgejo's ids. */
|
|
100
|
+
export interface LiveRepository {
|
|
101
|
+
defaultBranch?: string;
|
|
102
|
+
path?: string;
|
|
103
|
+
ownerId?: string;
|
|
104
|
+
repoId?: string;
|
|
105
|
+
}
|
|
106
|
+
/** The token's issuer: GitHub's service for github.com and Enterprise Server's own, GitLab's instance, Forgejo's /api/actions. */
|
|
107
|
+
export declare function issuerOf(forge: ForgeKind, host: string): string;
|
|
108
|
+
/** Where a job runs: on a pull request, or on a branch (with its forge environment). */
|
|
109
|
+
export type JobEvent = {
|
|
110
|
+
on: "pull-request";
|
|
111
|
+
} | {
|
|
112
|
+
on: "branch";
|
|
113
|
+
branch?: string;
|
|
114
|
+
forgeEnvironment?: string;
|
|
115
|
+
};
|
|
116
|
+
/** The token a job presents on `forge` for `repo` when it runs on `event`. */
|
|
117
|
+
export declare function jobToken(forge: ForgeKind, repo: ForgeCheckRepository, event: JobEvent): JobToken;
|
|
118
|
+
/** A job's identities, per cloud, from one side of a resolved trade. */
|
|
119
|
+
export declare function jobIdentities(spec: CloudTradeSpec): Pick<ForgeCheckJob, IdentityCloud>;
|
|
120
|
+
/** One generated pipeline: an environment, and in a workspace a member, with the trades `resolveCloudIdentity` gives it. */
|
|
121
|
+
export interface ContractPipeline {
|
|
122
|
+
/** As rows name its jobs: the environment, or `<member>/<environment>`. */
|
|
123
|
+
name: string;
|
|
124
|
+
identity: PipelineCloudIdentity;
|
|
125
|
+
/** The member, whose status contexts carry its name. */
|
|
126
|
+
member?: string;
|
|
127
|
+
/** The forge environment the apply jobs run in (GitHub and GitLab). */
|
|
128
|
+
forgeEnvironment?: string;
|
|
129
|
+
/** The apply jobs' runner. */
|
|
130
|
+
applyRunner?: JobRunner;
|
|
131
|
+
}
|
|
132
|
+
export interface PipelineContractInput {
|
|
133
|
+
forge: ForgeKind;
|
|
134
|
+
repository: ForgeCheckRepository;
|
|
135
|
+
pipelines: ContractPipeline[];
|
|
136
|
+
/** The product's words: the stage words in job names and the default required statuses. */
|
|
137
|
+
words?: CiProductWordsInput | CiProductWords;
|
|
138
|
+
/** Default: the default branch. */
|
|
139
|
+
protectedBranches?: string[];
|
|
140
|
+
/** Default: each pipeline's plan status, such as `chant/plan` or `plywood/preview/<member>`. */
|
|
141
|
+
requiredStatuses?: string[];
|
|
142
|
+
gitlabVariables?: string[];
|
|
143
|
+
}
|
|
144
|
+
/**
|
|
145
|
+
* The contract of chant's generated pull-request pipelines: per pipeline,
|
|
146
|
+
* the plan job (pull request, plan identities), the record job (default
|
|
147
|
+
* branch, plan identities) and the apply job (default branch or its forge
|
|
148
|
+
* environment, apply identities). A Forgejo forge has no environments, so
|
|
149
|
+
* `forgeEnvironment` is left out there.
|
|
150
|
+
*/
|
|
151
|
+
export declare function pipelineContract(input: PipelineContractInput): ForgeCheckContract;
|
|
152
|
+
//# sourceMappingURL=contract.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/forge-check/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAA6C,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/H,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,6CAA6C;AAC7C,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,qHAAqH;IACrH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,8HAA8H;IAC9H,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,GAAG,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,4FAA4F;IAC5F,MAAM,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxF;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,oBAAoB,CAAC;IACjC,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,iHAAiH;IACjH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,0HAA0H;IAC1H,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,4GAA4G;AAC5G,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kIAAkI;AAClI,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,wFAAwF;AACxF,MAAM,MAAM,QAAQ,GAAG;IAAE,EAAE,EAAE,cAAc,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7G,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,GAAG,QAAQ,CAuBhG;AAQD,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAStF;AAED,4HAA4H;AAC5H,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,qBAAqB,CAAC;IAChC,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8BAA8B;IAC9B,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,oBAAoB,CAAC;IACjC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,2FAA2F;IAC3F,KAAK,CAAC,EAAE,mBAAmB,GAAG,cAAc,CAAC;IAC7C,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,gGAAgG;IAChG,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,kBAAkB,CA4BjF"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The forge check's contract (#4608): each job a pipeline runs, the OIDC
|
|
3
|
+
* token it presents, and the identities it trades that token for, with the
|
|
4
|
+
* branches and statuses the forge should protect. The check compares the
|
|
5
|
+
* live forge, the clouds and Pulumi Cloud with it.
|
|
6
|
+
*
|
|
7
|
+
* A product builds the contract from its own config, or chant builds it
|
|
8
|
+
* from `ci.identity.cloud` with {@link pipelineContract}: per pipeline, a
|
|
9
|
+
* plan job on the pull request, a record job on the default branch with the
|
|
10
|
+
* plan identities, and an apply job on the default branch (or in its forge
|
|
11
|
+
* environment) with the apply identities, as chant's generated pipelines
|
|
12
|
+
* run them (../ci-identity.ts).
|
|
13
|
+
*
|
|
14
|
+
* Subjects, by forge (terragucci's `identities.ts`, lifted here):
|
|
15
|
+
*
|
|
16
|
+
* GitHub repo:ORG/REPO:pull_request, repo:ORG/REPO:environment:NAME,
|
|
17
|
+
* repo:ORG/REPO:ref:refs/heads/BRANCH; issuer
|
|
18
|
+
* https://token.actions.githubusercontent.com, or
|
|
19
|
+
* https://<host>/_services/token on GitHub Enterprise Server
|
|
20
|
+
* GitLab project_path:GROUP/PROJECT:ref_type:branch:ref:BRANCH; a merge
|
|
21
|
+
* request pipeline's ref is its source branch, so the plan job's
|
|
22
|
+
* subject is a pattern over every branch. A job in a forge
|
|
23
|
+
* environment also carries `environment`, `environment_protected`
|
|
24
|
+
* and `ref_protected`. The issuer is the instance's URL.
|
|
25
|
+
* Forgejo repo:<owner>-<owner id>/<repo>-<repo id>:ref:refs/heads/BRANCH,
|
|
26
|
+
* and :pull_request for a pull request; the issuer is
|
|
27
|
+
* <origin>/api/actions. No claim tells environments apart.
|
|
28
|
+
*/
|
|
29
|
+
import { productStatusContext, resolveProductWords } from "../ci-product-words.js";
|
|
30
|
+
/** The token's issuer: GitHub's service for github.com and Enterprise Server's own, GitLab's instance, Forgejo's /api/actions. */
|
|
31
|
+
export function issuerOf(forge, host) {
|
|
32
|
+
if (forge === "github")
|
|
33
|
+
return host.toLowerCase() === "github.com" ? "https://token.actions.githubusercontent.com" : `https://${host}/_services/token`;
|
|
34
|
+
if (forge === "gitlab")
|
|
35
|
+
return `https://${host}`;
|
|
36
|
+
return `https://${host}/api/actions`;
|
|
37
|
+
}
|
|
38
|
+
/** The token a job presents on `forge` for `repo` when it runs on `event`. */
|
|
39
|
+
export function jobToken(forge, repo, event) {
|
|
40
|
+
const issuer = issuerOf(forge, repo.host);
|
|
41
|
+
const placeholders = [...repo.path.matchAll(/<([^>]+)>/g)].map((m) => m[1]);
|
|
42
|
+
const branch = event.on === "branch" ? (event.branch ?? repo.defaultBranch) : repo.defaultBranch;
|
|
43
|
+
const env = event.on === "branch" ? event.forgeEnvironment : undefined;
|
|
44
|
+
if (forge === "github") {
|
|
45
|
+
const base = `repo:${repo.path}`;
|
|
46
|
+
const subject = event.on === "pull-request" ? `${base}:pull_request` : env ? `${base}:environment:${env}` : `${base}:ref:refs/heads/${branch}`;
|
|
47
|
+
return { issuer, subject, pattern: false, claims: {}, placeholders };
|
|
48
|
+
}
|
|
49
|
+
if (forge === "gitlab") {
|
|
50
|
+
const base = `project_path:${repo.path}:ref_type:branch:ref:`;
|
|
51
|
+
if (event.on === "pull-request")
|
|
52
|
+
return { issuer, subject: `${base}*`, pattern: true, claims: {}, placeholders };
|
|
53
|
+
const claims = env ? { environment: env, environment_protected: "true", ref_protected: "true" } : {};
|
|
54
|
+
return { issuer, subject: `${base}${branch}`, pattern: false, claims, placeholders };
|
|
55
|
+
}
|
|
56
|
+
const slash = repo.path.lastIndexOf("/");
|
|
57
|
+
const owner = repo.path.slice(0, slash);
|
|
58
|
+
const name = repo.path.slice(slash + 1);
|
|
59
|
+
const ids = [...(repo.ownerId ? [] : ["owner-id"]), ...(repo.repoId ? [] : ["repo-id"])];
|
|
60
|
+
const base = `repo:${owner}-${repo.ownerId ?? "<owner-id>"}/${name}-${repo.repoId ?? "<repo-id>"}`;
|
|
61
|
+
const subject = event.on === "pull-request" ? `${base}:pull_request` : `${base}:ref:refs/heads/${branch}`;
|
|
62
|
+
return { issuer, subject, pattern: false, claims: {}, placeholders: [...placeholders, ...ids] };
|
|
63
|
+
}
|
|
64
|
+
const own = (id, targets, key) => {
|
|
65
|
+
const out = [];
|
|
66
|
+
for (const v of [id, ...(targets ?? []).map((t) => t[key])])
|
|
67
|
+
if (v !== undefined && !out.includes(v))
|
|
68
|
+
out.push(v);
|
|
69
|
+
return out;
|
|
70
|
+
};
|
|
71
|
+
/** A job's identities, per cloud, from one side of a resolved trade. */
|
|
72
|
+
export function jobIdentities(spec) {
|
|
73
|
+
return {
|
|
74
|
+
...(spec.aws ? { aws: { roles: own(spec.aws.role, spec.aws.targets, "role"), audience: spec.aws.audience } } : {}),
|
|
75
|
+
...(spec.gcp ? { gcp: { provider: spec.gcp.provider, audience: spec.gcp.audience } } : {}),
|
|
76
|
+
...(spec.azure ? { azure: { clientIds: own(spec.azure.clientId, spec.azure.targets, "clientId"), audience: spec.azure.audience } } : {}),
|
|
77
|
+
...(spec.pulumi
|
|
78
|
+
? { pulumi: { organization: spec.pulumi.organization, tokens: own(spec.pulumi.token, spec.pulumi.targets, "token"), audience: spec.pulumi.audience, ...(spec.pulumi.apiUrl ? { apiUrl: spec.pulumi.apiUrl } : {}) } }
|
|
79
|
+
: {}),
|
|
80
|
+
};
|
|
81
|
+
}
|
|
82
|
+
/**
|
|
83
|
+
* The contract of chant's generated pull-request pipelines: per pipeline,
|
|
84
|
+
* the plan job (pull request, plan identities), the record job (default
|
|
85
|
+
* branch, plan identities) and the apply job (default branch or its forge
|
|
86
|
+
* environment, apply identities). A Forgejo forge has no environments, so
|
|
87
|
+
* `forgeEnvironment` is left out there.
|
|
88
|
+
*/
|
|
89
|
+
export function pipelineContract(input) {
|
|
90
|
+
const words = resolveProductWords(input.words);
|
|
91
|
+
const { forge, repository } = input;
|
|
92
|
+
const jobs = [];
|
|
93
|
+
const statuses = [];
|
|
94
|
+
for (const p of input.pipelines) {
|
|
95
|
+
const env = forge === "forgejo" ? undefined : p.forgeEnvironment;
|
|
96
|
+
jobs.push({ name: `${p.name} ${words.stages.plan}`, identity: "plan", token: jobToken(forge, repository, { on: "pull-request" }), ...jobIdentities(p.identity.plan) });
|
|
97
|
+
jobs.push({ name: `${p.name} ${words.stages.record}`, identity: "plan", token: jobToken(forge, repository, { on: "branch" }), ...jobIdentities(p.identity.plan) });
|
|
98
|
+
jobs.push({
|
|
99
|
+
name: `${p.name} ${words.stages.apply}`,
|
|
100
|
+
identity: "apply",
|
|
101
|
+
token: jobToken(forge, repository, { on: "branch", ...(env ? { forgeEnvironment: env } : {}) }),
|
|
102
|
+
...(env ? { forgeEnvironment: env } : {}),
|
|
103
|
+
...(p.applyRunner ? { runner: p.applyRunner } : {}),
|
|
104
|
+
...jobIdentities(p.identity.apply),
|
|
105
|
+
});
|
|
106
|
+
const ctx = productStatusContext(words, "plan", p.member);
|
|
107
|
+
if (!statuses.includes(ctx))
|
|
108
|
+
statuses.push(ctx);
|
|
109
|
+
}
|
|
110
|
+
return {
|
|
111
|
+
forge,
|
|
112
|
+
repository,
|
|
113
|
+
jobs,
|
|
114
|
+
protectedBranches: input.protectedBranches ?? [repository.defaultBranch],
|
|
115
|
+
requiredStatuses: input.requiredStatuses ?? statuses,
|
|
116
|
+
...(input.gitlabVariables ? { gitlabVariables: input.gitlabVariables } : {}),
|
|
117
|
+
};
|
|
118
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
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
|
+
import { type ForgeFetch, type ForgeTarget } from "../pr-forge.js";
|
|
26
|
+
import type { ForgeCheckContract, LiveRepository } from "./contract.js";
|
|
27
|
+
import { type CheckRow, type Read } from "./types.js";
|
|
28
|
+
/** A GET of `path` under the target's REST base, parsed as JSON. */
|
|
29
|
+
export declare function read<T>(fetch: ForgeFetch, t: ForgeTarget, path: string): Promise<Read<T>>;
|
|
30
|
+
/** The repository's default branch, full path and (Forgejo) numeric ids. */
|
|
31
|
+
export declare function readRepository(fetch: ForgeFetch, t: ForgeTarget): Promise<Read<LiveRepository>>;
|
|
32
|
+
export declare function githubRows(fetch: ForgeFetch, t: ForgeTarget, c: ForgeCheckContract): Promise<CheckRow[]>;
|
|
33
|
+
export declare function gitlabRows(fetch: ForgeFetch, t: ForgeTarget, c: ForgeCheckContract): Promise<CheckRow[]>;
|
|
34
|
+
export declare function forgejoRows(fetch: ForgeFetch, t: ForgeTarget, c: ForgeCheckContract): Promise<CheckRow[]>;
|
|
35
|
+
/**
|
|
36
|
+
* Whether each required status has been posted on the default branch's
|
|
37
|
+
* head, read with chant's forge client (#4554). A required status no job
|
|
38
|
+
* posts blocks every merge, so its name is worth seeing next to the forge's
|
|
39
|
+
* list. One not posted yet is `unknown`: the pipeline may not have run.
|
|
40
|
+
*/
|
|
41
|
+
export declare function statusReportedRows(fetch: ForgeFetch, t: ForgeTarget, c: ForgeCheckContract): Promise<CheckRow[]>;
|
|
42
|
+
//# sourceMappingURL=forge.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"forge.d.ts","sourceRoot":"","sources":["../../src/forge-check/forge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAA8B,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,KAAK,EAAE,kBAAkB,EAAiB,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpF,OAAO,EAA4B,KAAK,QAAQ,EAAoB,KAAK,IAAI,EAAE,MAAM,SAAS,CAAC;AAQ/F,oEAAoE;AACpE,wBAAsB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAW/F;AAKD,4EAA4E;AAC5E,wBAAsB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAcrG;AAyBD,wBAAsB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA2D9G;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAmG9G;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA2B/G;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CA2BtH"}
|