@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
package/dist/ci-identity.js
CHANGED
|
@@ -48,12 +48,38 @@
|
|
|
48
48
|
* the OIDC token. chant trades it, so the change's code never holds a token
|
|
49
49
|
* another client could be traded for; a tool that needs the OIDC token
|
|
50
50
|
* itself cannot plan under this block.
|
|
51
|
+
*
|
|
52
|
+
* Pulumi Cloud (#4549) is traded the same way, through its OAuth token
|
|
53
|
+
* exchange (`POST <apiUrl>/api/oauth/token`, RFC 8693), for a Pulumi access
|
|
54
|
+
* token in PULUMI_ACCESS_TOKEN. Its identities name the token asked for:
|
|
55
|
+
* `team:<name>`, `user:<login>`, `organization` or `organization:admin`. So
|
|
56
|
+
* the plan and record jobs preview with one token, the apply jobs run `up`
|
|
57
|
+
* with another, and the pull request's program never sees the `up` token.
|
|
58
|
+
* No long-lived Pulumi token sits in the forge's secrets.
|
|
51
59
|
*/
|
|
52
60
|
import { readFileSync } from "node:fs";
|
|
53
|
-
/** The
|
|
61
|
+
/** The cloud providers `ci.identity.cloud` names. */
|
|
54
62
|
export const CLOUDS = ["aws", "gcp", "azure"];
|
|
63
|
+
/**
|
|
64
|
+
* Every key of `ci.identity.cloud`: the cloud providers and Pulumi Cloud
|
|
65
|
+
* (#4549), whose access tokens are traded the same way. {@link CLOUDS}
|
|
66
|
+
* keeps the providers alone, as a Terraform product reads them.
|
|
67
|
+
*/
|
|
68
|
+
export const IDENTITY_CLOUDS = [...CLOUDS, "pulumi"];
|
|
69
|
+
/** The first chant that reads `ci.identity.cloud.pulumi` (#4549): a declaration that sets it needs this `minReader`. */
|
|
70
|
+
export const PULUMI_CLOUD_IDENTITY_FLOOR = "0.124.55";
|
|
71
|
+
/**
|
|
72
|
+
* The first chant that reads `ci.identity.cloud.azure.database` (#4572): the
|
|
73
|
+
* trade also asks Entra for a token Azure Database for PostgreSQL accepts.
|
|
74
|
+
* A declaration that sets it needs this `minReader`.
|
|
75
|
+
*/
|
|
76
|
+
export const AZURE_DATABASE_TOKEN_FLOOR = "0.124.55";
|
|
77
|
+
/** The Entra scope of Azure Database for PostgreSQL's sign-in tokens (#4572). */
|
|
78
|
+
export const AZURE_DATABASE_SCOPE = "https://ossrdbms-aad.database.windows.net/.default";
|
|
79
|
+
/** The variable the trade sets to the database token with `azure.database` (#4572); the sql lexicon's `entra` token source reads it. */
|
|
80
|
+
export const AZURE_DATABASE_TOKEN_ENV = "AZURE_DATABASE_ACCESS_TOKEN";
|
|
55
81
|
/** The key a cloud's trade names its identity under. */
|
|
56
|
-
export const IDENTITY_KEY = { aws: "role", gcp: "serviceAccount", azure: "clientId" };
|
|
82
|
+
export const IDENTITY_KEY = { aws: "role", gcp: "serviceAccount", azure: "clientId", pulumi: "token" };
|
|
57
83
|
/**
|
|
58
84
|
* A glob over a name (#4296): `*` and `?` within the name, `[...]` classes,
|
|
59
85
|
* `{a,b}` alternatives, a leading `!` negates. The grammar `ciMemberGlobs`
|
|
@@ -158,12 +184,17 @@ function cloudPlace(decl, cloud) {
|
|
|
158
184
|
...(g.iamEndpoint ? { iamEndpoint: g.iamEndpoint } : {}),
|
|
159
185
|
};
|
|
160
186
|
}
|
|
187
|
+
if (cloud === "pulumi") {
|
|
188
|
+
const p = decl.pulumi;
|
|
189
|
+
return { organization: p.organization, audience: p.audience ?? pulumiAudience(p.organization), ...(p.apiUrl ? { apiUrl: p.apiUrl } : {}) };
|
|
190
|
+
}
|
|
161
191
|
const z = decl.azure;
|
|
162
192
|
return {
|
|
163
193
|
tenantId: z.tenantId,
|
|
164
194
|
audience: z.audience ?? "api://AzureADTokenExchange",
|
|
165
195
|
...(z.subscriptionId ? { subscriptionId: z.subscriptionId } : {}),
|
|
166
196
|
...(z.authority ? { authority: z.authority } : {}),
|
|
197
|
+
...(z.database ? { database: true } : {}),
|
|
167
198
|
};
|
|
168
199
|
}
|
|
169
200
|
/** One cloud's trade: its own identity, the targets that take another, and where it trades. */
|
|
@@ -189,7 +220,7 @@ export function resolveCloudIdentity(decl, env, member) {
|
|
|
189
220
|
return undefined;
|
|
190
221
|
const plan = {};
|
|
191
222
|
const apply = {};
|
|
192
|
-
for (const cloud of
|
|
223
|
+
for (const cloud of IDENTITY_CLOUDS) {
|
|
193
224
|
const rules = decl[cloud]?.rules;
|
|
194
225
|
if (!rules)
|
|
195
226
|
continue;
|
|
@@ -215,7 +246,7 @@ export function resolveTargetCloudIdentity(decl, env, member, target) {
|
|
|
215
246
|
return undefined;
|
|
216
247
|
const plan = {};
|
|
217
248
|
const apply = {};
|
|
218
|
-
for (const cloud of
|
|
249
|
+
for (const cloud of IDENTITY_CLOUDS) {
|
|
219
250
|
const rule = decl[cloud] && ruleFor(decl[cloud].rules, env, member, target);
|
|
220
251
|
if (!rule)
|
|
221
252
|
continue;
|
|
@@ -240,7 +271,7 @@ export function resolvePrEnvCloudIdentity(decl, member) {
|
|
|
240
271
|
if (!decl)
|
|
241
272
|
return undefined;
|
|
242
273
|
const named = {};
|
|
243
|
-
for (const cloud of
|
|
274
|
+
for (const cloud of IDENTITY_CLOUDS) {
|
|
244
275
|
const c = decl[cloud];
|
|
245
276
|
if (c)
|
|
246
277
|
named[cloud] = { ...c, rules: c.rules.filter((r) => r.environments !== undefined) };
|
|
@@ -263,13 +294,13 @@ export function cloudIdentityGroups(decl, env, member, targets) {
|
|
|
263
294
|
const byKey = new Map();
|
|
264
295
|
for (const target of targets) {
|
|
265
296
|
const identity = resolveTargetCloudIdentity(decl, env, member, target);
|
|
266
|
-
const key = JSON.stringify(identity ?
|
|
297
|
+
const key = JSON.stringify(identity ? IDENTITY_CLOUDS.map((c) => [identity.plan[c] ? tradeIdentities({ [c]: identity.plan[c] }) : [], identity.apply[c] ? tradeIdentities({ [c]: identity.apply[c] }) : []]) : null);
|
|
267
298
|
const at = byKey.get(key);
|
|
268
299
|
if (at) {
|
|
269
300
|
at.group.targets.push(target);
|
|
270
301
|
continue;
|
|
271
302
|
}
|
|
272
|
-
const rule =
|
|
303
|
+
const rule = IDENTITY_CLOUDS.map((c) => decl?.[c] && ruleFor(decl[c].rules, env, member, target)).find((r) => r?.targets !== undefined);
|
|
273
304
|
const named = rule ? (rule.name ?? (nameFrom(rule.targets[0]) || "group")) : DEFAULT_IDENTITY_GROUP;
|
|
274
305
|
// An Op wave's own jobs are `decide` and `share-<i>` (./op/op-waves.ts), so a group takes neither name.
|
|
275
306
|
const base = named === "decide" || /^share-\d+$/.test(named) ? `${named}-targets` : named;
|
|
@@ -320,9 +351,9 @@ export function oneApplyIdentityProblem(spec) {
|
|
|
320
351
|
}
|
|
321
352
|
return undefined;
|
|
322
353
|
}
|
|
323
|
-
/** The clouds a trade covers, in {@link
|
|
354
|
+
/** The clouds a trade covers, in {@link IDENTITY_CLOUDS} order. */
|
|
324
355
|
export function tradedClouds(spec) {
|
|
325
|
-
return
|
|
356
|
+
return IDENTITY_CLOUDS.filter((c) => spec[c] !== undefined);
|
|
326
357
|
}
|
|
327
358
|
/** Every identity a trade names, once each: the roles, the service accounts, the client ids, its targets' too (#4332). */
|
|
328
359
|
export function tradeIdentities(spec) {
|
|
@@ -344,7 +375,7 @@ export function tradeIdentities(spec) {
|
|
|
344
375
|
*/
|
|
345
376
|
export function cloudIdentityProblems(decl) {
|
|
346
377
|
const out = [];
|
|
347
|
-
for (const cloud of
|
|
378
|
+
for (const cloud of IDENTITY_CLOUDS) {
|
|
348
379
|
const rules = decl[cloud]?.rules ?? [];
|
|
349
380
|
const applies = new Set(rules.map((r) => r.apply));
|
|
350
381
|
rules.forEach((r, i) => {
|
|
@@ -353,13 +384,39 @@ export function cloudIdentityProblems(decl) {
|
|
|
353
384
|
out.push({ pointer, message: `ci.identity.cloud.${cloud}.rules[${i}] plans and applies as ${r.plan}; the plan runs the pull request's code, so give it an identity of its own` });
|
|
354
385
|
else if (applies.has(r.plan))
|
|
355
386
|
out.push({ pointer, message: `ci.identity.cloud.${cloud}.rules[${i}] plans as ${r.plan}, which another rule applies as; the plan runs the pull request's code, so give it an identity no rule applies as` });
|
|
387
|
+
if (cloud === "pulumi") {
|
|
388
|
+
for (const side of ["plan", "apply"]) {
|
|
389
|
+
if (!pulumiTokenRequest(r[side]))
|
|
390
|
+
out.push({ pointer: `${pointer}/${side}`, message: `ci.identity.cloud.pulumi.rules[${i}].${side} is ${JSON.stringify(r[side])}; a Pulumi Cloud identity is team:<name>, user:<login>, organization or organization:admin` });
|
|
391
|
+
}
|
|
392
|
+
}
|
|
356
393
|
});
|
|
357
394
|
}
|
|
358
395
|
return out;
|
|
359
396
|
}
|
|
397
|
+
/** The OIDC audience Pulumi Cloud's token exchange takes for `organization` (#4549). */
|
|
398
|
+
export function pulumiAudience(organization) {
|
|
399
|
+
return `urn:pulumi:org:${organization}`;
|
|
400
|
+
}
|
|
401
|
+
/**
|
|
402
|
+
* The token a Pulumi Cloud identity asks the exchange for (#4549): its
|
|
403
|
+
* `requested_token_type` and `scope`, or undefined when `identity` is none
|
|
404
|
+
* of `team:<name>`, `user:<login>`, `organization`, `organization:admin`.
|
|
405
|
+
* The trade script reads identities the same way.
|
|
406
|
+
*/
|
|
407
|
+
export function pulumiTokenRequest(identity) {
|
|
408
|
+
const m = /^(team|user):([^\s:]+)$/.exec(identity);
|
|
409
|
+
if (m)
|
|
410
|
+
return { tokenType: `urn:pulumi:token-type:access_token:${m[1] === "team" ? "team" : "personal"}`, scope: identity };
|
|
411
|
+
if (identity === "organization")
|
|
412
|
+
return { tokenType: "urn:pulumi:token-type:access_token:organization" };
|
|
413
|
+
if (identity === "organization:admin")
|
|
414
|
+
return { tokenType: "urn:pulumi:token-type:access_token:organization", scope: "admin" };
|
|
415
|
+
return undefined;
|
|
416
|
+
}
|
|
360
417
|
/** The variable the trade step reads its {@link CloudTradeSpec} from, as JSON. */
|
|
361
418
|
export const TRADE_SPEC_ENV = "CHANT_CLOUD_TRADE";
|
|
362
|
-
/** The GitLab `id_tokens` variable a cloud's token comes in: `CHANT_ID_TOKEN_AWS`, `_GCP`, `_AZURE`. */
|
|
419
|
+
/** The GitLab `id_tokens` variable a cloud's token comes in: `CHANT_ID_TOKEN_AWS`, `_GCP`, `_AZURE`, `_PULUMI`. */
|
|
363
420
|
export function idTokenVar(cloud) {
|
|
364
421
|
return `CHANT_ID_TOKEN_${cloud.toUpperCase()}`;
|
|
365
422
|
}
|
|
@@ -368,12 +425,13 @@ export function idTokenVar(cloud) {
|
|
|
368
425
|
* the GitLab `id_tokens` variables the trade reads. A step that runs the
|
|
369
426
|
* change's code starts without them, once the trade is done.
|
|
370
427
|
*/
|
|
371
|
-
export const OIDC_REQUEST_VARS = ["ACTIONS_ID_TOKEN_REQUEST_TOKEN", "ACTIONS_ID_TOKEN_REQUEST_URL", ...
|
|
428
|
+
export const OIDC_REQUEST_VARS = ["ACTIONS_ID_TOKEN_REQUEST_TOKEN", "ACTIONS_ID_TOKEN_REQUEST_URL", ...IDENTITY_CLOUDS.map(idTokenVar), TRADE_SPEC_ENV];
|
|
372
429
|
/** The variables the trade sets, per cloud. */
|
|
373
430
|
export const TRADED_VARS = {
|
|
374
431
|
aws: ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_SESSION_TOKEN", "AWS_REGION", "AWS_DEFAULT_REGION"],
|
|
375
432
|
gcp: ["GOOGLE_OAUTH_ACCESS_TOKEN", "CLOUDSDK_AUTH_ACCESS_TOKEN"],
|
|
376
|
-
azure: ["AZURE_ACCESS_TOKEN", "AZURE_CLIENT_ID", "AZURE_TENANT_ID", "ARM_CLIENT_ID", "ARM_TENANT_ID", "AZURE_SUBSCRIPTION_ID", "ARM_SUBSCRIPTION_ID"],
|
|
433
|
+
azure: ["AZURE_ACCESS_TOKEN", "AZURE_CLIENT_ID", "AZURE_TENANT_ID", "ARM_CLIENT_ID", "ARM_TENANT_ID", "AZURE_SUBSCRIPTION_ID", "ARM_SUBSCRIPTION_ID", AZURE_DATABASE_TOKEN_ENV],
|
|
434
|
+
pulumi: ["PULUMI_ACCESS_TOKEN", "PULUMI_BACKEND_URL"],
|
|
377
435
|
};
|
|
378
436
|
/**
|
|
379
437
|
* The variable the trade sets when a cloud names `targets` (#4332): the
|
|
@@ -439,8 +497,21 @@ export const TRADE_JS = [
|
|
|
439
497
|
'for(const cid of ids("azure")){',
|
|
440
498
|
'const at=json(await post(host+"/"+encodeURIComponent(z.tenantId)+"/oauth2/v2.0/token",{"content-type":"application/x-www-form-urlencoded"},new URLSearchParams({client_id:cid,scope:"https://management.azure.com/.default",grant_type:"client_credentials",client_assertion_type:"urn:ietf:params:oauth:client-assertion-type:jwt-bearer",client_assertion:tok}).toString()),"Entra").access_token;',
|
|
441
499
|
'if(!clean(at))throw new Error("Entra gave no token for "+cid);',
|
|
442
|
-
|
|
500
|
+
// #4572: with azure.database, a second grant for Azure Database for PostgreSQL's scope.
|
|
501
|
+
`let db;if(z.database){db=json(await post(host+"/"+encodeURIComponent(z.tenantId)+"/oauth2/v2.0/token",{"content-type":"application/x-www-form-urlencoded"},new URLSearchParams({client_id:cid,scope:${JSON.stringify(AZURE_DATABASE_SCOPE)},grant_type:"client_credentials",client_assertion_type:"urn:ietf:params:oauth:client-assertion-type:jwt-bearer",client_assertion:tok}).toString()),"Entra").access_token;if(!clean(db))throw new Error("Entra gave no database token for "+cid);secrets.push(db)}`,
|
|
502
|
+
`by.azure[cid]={AZURE_ACCESS_TOKEN:at,AZURE_CLIENT_ID:cid,AZURE_TENANT_ID:z.tenantId,ARM_CLIENT_ID:cid,ARM_TENANT_ID:z.tenantId,...(z.subscriptionId?{AZURE_SUBSCRIPTION_ID:z.subscriptionId,ARM_SUBSCRIPTION_ID:z.subscriptionId}:{}),...(db?{${AZURE_DATABASE_TOKEN_ENV}:db}:{})};secrets.push(at);said.push(cid)}`,
|
|
443
503
|
"if(z.clientId)Object.assign(vars,by.azure[z.clientId])}",
|
|
504
|
+
// #4549: Pulumi Cloud's OAuth token exchange, one access token per identity (pulumiTokenRequest).
|
|
505
|
+
'if(spec.pulumi){const p=spec.pulumi;const tok=await idToken("pulumi",p.audience);by.pulumi={};',
|
|
506
|
+
'const api=trim(p.apiUrl||"https://api.pulumi.com");',
|
|
507
|
+
'for(const id of ids("pulumi")){',
|
|
508
|
+
'const m=/^(team|user):([^\\s:]+)$/.exec(id),org=id==="organization"||id==="organization:admin";if(!m&&!org)throw new Error("Pulumi Cloud has no token for "+id);',
|
|
509
|
+
'const f={audience:"urn:pulumi:org:"+p.organization,grant_type:"urn:ietf:params:oauth:grant-type:token-exchange",subject_token_type:"urn:ietf:params:oauth:token-type:id_token",requested_token_type:"urn:pulumi:token-type:access_token:"+(m?(m[1]==="team"?"team":"personal"):"organization"),subject_token:tok};',
|
|
510
|
+
'if(m)f.scope=id;else if(id==="organization:admin")f.scope="admin";',
|
|
511
|
+
'const at=json(await post(api+"/api/oauth/token",{"content-type":"application/x-www-form-urlencoded",accept:"application/json"},new URLSearchParams(f).toString()),"Pulumi Cloud").access_token;',
|
|
512
|
+
'if(!clean(at))throw new Error("Pulumi Cloud gave no token for "+id);',
|
|
513
|
+
'by.pulumi[id]={PULUMI_ACCESS_TOKEN:at,...(p.apiUrl?{PULUMI_BACKEND_URL:api}:{})};secrets.push(at);said.push("Pulumi Cloud "+id)}',
|
|
514
|
+
"if(p.token)Object.assign(vars,by.pulumi[p.token])}",
|
|
444
515
|
// #4332: with targets, every identity's variables go in a file of their own, outside the checkout.
|
|
445
516
|
'const clouds=Object.keys(by);if(clouds.some((c)=>(spec[c].targets||[]).length>0)){',
|
|
446
517
|
'const doc={version:1,clouds:{}};for(const c of clouds){const s=spec[c];doc.clouds[c]={...(s[KEY[c]]?{default:s[KEY[c]]}:{}),targets:(s.targets||[]).map((t)=>({targets:t.targets,identity:t[KEY[c]]})),vars:by[c]}}',
|
|
@@ -492,7 +563,7 @@ export function targetCloudEnv(env, target, read = (p) => readFileSync(p, "utf-8
|
|
|
492
563
|
if (!path)
|
|
493
564
|
return out;
|
|
494
565
|
const file = readTargetsFile(path, read);
|
|
495
|
-
for (const cloud of
|
|
566
|
+
for (const cloud of IDENTITY_CLOUDS) {
|
|
496
567
|
const c = file.clouds[cloud];
|
|
497
568
|
if (!c)
|
|
498
569
|
continue;
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The apply-job guard (#4624): the first step of each op-wave job checks
|
|
3
|
+
* that the job runs where the spec set it to run, and stops it otherwise,
|
|
4
|
+
* before any token is traded and before the checkout.
|
|
5
|
+
*
|
|
6
|
+
* What the job is expected to see is written into the job when the pipeline
|
|
7
|
+
* is rendered, as JSON in {@link JOB_GUARD_ENV}: the guard reads no file of
|
|
8
|
+
* the commit it runs on. What it sees comes from the forge:
|
|
9
|
+
*
|
|
10
|
+
* forge environment GitHub: the `environment` claim of an OIDC token the
|
|
11
|
+
* guard requests for its own audience
|
|
12
|
+
* ({@link JOB_GUARD_AUDIENCE}), decodes and drops. GitHub
|
|
13
|
+
* sets no variable with the job's environment, so a job
|
|
14
|
+
* that may request no token is not checked for it.
|
|
15
|
+
* GitLab: CI_ENVIRONMENT_NAME. Forgejo has no
|
|
16
|
+
* environments: not checked.
|
|
17
|
+
* ref GitHub and Forgejo: GITHUB_REF is refs/heads/<branch>
|
|
18
|
+
* for one of the branches the waves apply from. GitLab:
|
|
19
|
+
* CI_COMMIT_REF_NAME is one of them, and
|
|
20
|
+
* CI_COMMIT_REF_PROTECTED is "true".
|
|
21
|
+
* runner GitLab: CI_RUNNER_TAGS holds each of the job's tags.
|
|
22
|
+
* GitHub and Forgejo expose no labels, only whether the
|
|
23
|
+
* runner is self-hosted: when the job's labels include
|
|
24
|
+
* `self-hosted`, the token's runner_environment claim,
|
|
25
|
+
* else RUNNER_ENVIRONMENT, is `self-hosted`. Neither
|
|
26
|
+
* set: not checked.
|
|
27
|
+
*
|
|
28
|
+
* The generated step runs {@link jobGuardLine}: `node -e` from `/`, as the
|
|
29
|
+
* cloud trade does, so no file of the checkout is in reach and the guard
|
|
30
|
+
* needs nothing installed. `chant ci check-job` (and so a product's bin,
|
|
31
|
+
* `plywood ci check-job`, `terragucci ci check-job`) runs the same check
|
|
32
|
+
* from the same variable, through {@link checkJob}, for a product that
|
|
33
|
+
* renders its own jobs. The lines name the product from its words.
|
|
34
|
+
*
|
|
35
|
+
* A refusal exits chant's `misplaced` (9), as does a variable the guard
|
|
36
|
+
* cannot read. GitLab's op-wave jobs allow exit 1 as a failure the next wave
|
|
37
|
+
* runs after, and 9 is outside that set, so a refused job fails and the
|
|
38
|
+
* waves after it stop.
|
|
39
|
+
*
|
|
40
|
+
* The guard catches a hand edit, a dropped `environment:` or a mistyped
|
|
41
|
+
* label. Someone who can edit the workflow can delete it too: the forge's
|
|
42
|
+
* environment and runner settings and the cloud role's trust are what keep
|
|
43
|
+
* a job out.
|
|
44
|
+
*/
|
|
45
|
+
import { type CiRunner } from "./ci-jobs.js";
|
|
46
|
+
/** The variable the generated step carries its expectation in. */
|
|
47
|
+
export declare const JOB_GUARD_ENV = "CHANT_JOB_GUARD";
|
|
48
|
+
/** The audience of the token the guard requests on GitHub, which no cloud role should trust. */
|
|
49
|
+
export declare const JOB_GUARD_AUDIENCE = "chant-check-job";
|
|
50
|
+
export type JobGuardForge = "github" | "gitlab" | "forgejo";
|
|
51
|
+
/** Where a job is expected to run, as the step carries it. */
|
|
52
|
+
export interface JobGuardSpec {
|
|
53
|
+
forge: JobGuardForge;
|
|
54
|
+
/** The job, as the lines name it: `wave 2 (prod) of deploy`. */
|
|
55
|
+
job: string;
|
|
56
|
+
/** The product the lines speak for (`chant`, `plywood`). Default `chant`. */
|
|
57
|
+
product?: string;
|
|
58
|
+
/** The forge environment the job runs in. Unset: not checked. */
|
|
59
|
+
forgeEnvironment?: string;
|
|
60
|
+
/** The branches the job may run from. */
|
|
61
|
+
branches: string[];
|
|
62
|
+
/** GitLab: the tags the job's runner must carry. */
|
|
63
|
+
runnerTags?: string[];
|
|
64
|
+
/** GitHub and Forgejo: the runner must be self-hosted. */
|
|
65
|
+
selfHosted?: boolean;
|
|
66
|
+
}
|
|
67
|
+
/** What the job sees. Undefined: the forge did not say. */
|
|
68
|
+
export interface JobSeen {
|
|
69
|
+
/** The job's forge environment; null when the job runs in none. */
|
|
70
|
+
forgeEnvironment?: string | null;
|
|
71
|
+
/** Why the forge environment could not be read, when it could not. */
|
|
72
|
+
forgeEnvironmentError?: string;
|
|
73
|
+
ref?: string;
|
|
74
|
+
refProtected?: string;
|
|
75
|
+
runnerTags?: string[];
|
|
76
|
+
runnerEnvironment?: string;
|
|
77
|
+
}
|
|
78
|
+
export interface JobGuardResult {
|
|
79
|
+
/** One line per value that does not match, naming the expected and found values. */
|
|
80
|
+
problems: string[];
|
|
81
|
+
/** What was checked and matched. */
|
|
82
|
+
checked: string[];
|
|
83
|
+
/** What the forge does not expose, so was not checked. */
|
|
84
|
+
skipped: string[];
|
|
85
|
+
}
|
|
86
|
+
/** What a generator knows about one job. */
|
|
87
|
+
export interface JobGuardInput {
|
|
88
|
+
forge: JobGuardForge;
|
|
89
|
+
job: string;
|
|
90
|
+
product?: string;
|
|
91
|
+
/** The forge environment's name, when the job has one. */
|
|
92
|
+
environment?: string;
|
|
93
|
+
/** The branches the job runs from. */
|
|
94
|
+
branches: readonly string[];
|
|
95
|
+
/** The job's runner, as the spec gives it. */
|
|
96
|
+
runner?: CiRunner;
|
|
97
|
+
/** GitHub: the job may request an OIDC token (`id-token: write`), so the guard can read its environment. */
|
|
98
|
+
idToken?: boolean;
|
|
99
|
+
}
|
|
100
|
+
/**
|
|
101
|
+
* The expectation a generator writes into a job. GitHub checks the forge
|
|
102
|
+
* environment only in a job that may request a token; Forgejo never does.
|
|
103
|
+
*/
|
|
104
|
+
export declare function jobGuardSpec(input: JobGuardInput): JobGuardSpec;
|
|
105
|
+
/** Read {@link JOB_GUARD_ENV}'s JSON, refusing one that is not a guard spec. */
|
|
106
|
+
export declare function parseJobGuardSpec(raw: string | undefined): JobGuardSpec;
|
|
107
|
+
/** The tags CI_RUNNER_TAGS lists: a JSON array, or a comma-separated list. */
|
|
108
|
+
export declare function runnerTagsOf(raw: string | undefined): string[] | undefined;
|
|
109
|
+
/** A JWT's claims, without checking its signature: the token came from the forge a moment ago and is used for nothing else. */
|
|
110
|
+
export declare function tokenClaims(token: string): Record<string, unknown>;
|
|
111
|
+
/** Compare what the job sees with what the spec expects. */
|
|
112
|
+
export declare function checkJob(expect: JobGuardSpec, seen: JobSeen): JobGuardResult;
|
|
113
|
+
/** What the job sees, from the forge's variables, and on GitHub from its token's claims when the forge environment is to be checked. */
|
|
114
|
+
export declare function jobSeen(expect: JobGuardSpec, env?: NodeJS.ProcessEnv, fetchFn?: typeof fetch): Promise<JobSeen>;
|
|
115
|
+
/** The lines the guard prints, and whether the job may go on. */
|
|
116
|
+
export declare function describeJobGuard(expect: JobGuardSpec, result: JobGuardResult): {
|
|
117
|
+
ok: boolean;
|
|
118
|
+
out: string[];
|
|
119
|
+
err: string[];
|
|
120
|
+
};
|
|
121
|
+
/**
|
|
122
|
+
* The guard as one `node -e` program: the same checks as {@link checkJob},
|
|
123
|
+
* {@link jobSeen} and {@link describeJobGuard}, reading {@link JOB_GUARD_ENV}.
|
|
124
|
+
* Exits chant's `misplaced` (9) with one line per value that differs, and
|
|
125
|
+
* when the variable holds no spec it can read. A test runs it against
|
|
126
|
+
* {@link checkJob} so the two stay the same.
|
|
127
|
+
*/
|
|
128
|
+
export declare const JOB_GUARD_JS: string;
|
|
129
|
+
/** The shell line of the guard step: `node -e` from `/`, so no file of the checkout is in reach. */
|
|
130
|
+
export declare function jobGuardLine(): string;
|
|
131
|
+
/** How the guard's lines name an op-wave job: `wave 2 (prod) of deploy`, `share 1 of job group eu of wave 2 (prod) of deploy`. */
|
|
132
|
+
export declare function opWaveJobLabel(spec: string, job: {
|
|
133
|
+
kind: "wave" | "decide" | "share";
|
|
134
|
+
wave: number;
|
|
135
|
+
waveName: string;
|
|
136
|
+
share?: number;
|
|
137
|
+
group?: string;
|
|
138
|
+
}): string;
|
|
139
|
+
//# sourceMappingURL=ci-job-guard.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ci-job-guard.d.ts","sourceRoot":"","sources":["../src/ci-job-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGzD,kEAAkE;AAClE,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAE/C,gGAAgG;AAChG,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AAEpD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE5D,8DAA8D;AAC9D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,2DAA2D;AAC3D,MAAM,WAAW,OAAO;IACtB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,sEAAsE;IACtE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oCAAoC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,4GAA4G;IAC5G,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,CAY/D;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAgBvE;AAID,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,GAAG,SAAS,CAY1E;AAED,+HAA+H;AAC/H,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOlE;AAED,4DAA4D;AAC5D,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,GAAG,cAAc,CAsC5E;AAcD,wIAAwI;AACxI,wBAAsB,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,OAAO,GAAE,OAAO,KAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAsBzI;AAED,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,cAAc,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAA;CAAE,CAW5H;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,QAiCf,CAAC;AAEX,oGAAoG;AACpG,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED,kIAAkI;AAClI,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAM/J"}
|
|
@@ -0,0 +1,287 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The apply-job guard (#4624): the first step of each op-wave job checks
|
|
3
|
+
* that the job runs where the spec set it to run, and stops it otherwise,
|
|
4
|
+
* before any token is traded and before the checkout.
|
|
5
|
+
*
|
|
6
|
+
* What the job is expected to see is written into the job when the pipeline
|
|
7
|
+
* is rendered, as JSON in {@link JOB_GUARD_ENV}: the guard reads no file of
|
|
8
|
+
* the commit it runs on. What it sees comes from the forge:
|
|
9
|
+
*
|
|
10
|
+
* forge environment GitHub: the `environment` claim of an OIDC token the
|
|
11
|
+
* guard requests for its own audience
|
|
12
|
+
* ({@link JOB_GUARD_AUDIENCE}), decodes and drops. GitHub
|
|
13
|
+
* sets no variable with the job's environment, so a job
|
|
14
|
+
* that may request no token is not checked for it.
|
|
15
|
+
* GitLab: CI_ENVIRONMENT_NAME. Forgejo has no
|
|
16
|
+
* environments: not checked.
|
|
17
|
+
* ref GitHub and Forgejo: GITHUB_REF is refs/heads/<branch>
|
|
18
|
+
* for one of the branches the waves apply from. GitLab:
|
|
19
|
+
* CI_COMMIT_REF_NAME is one of them, and
|
|
20
|
+
* CI_COMMIT_REF_PROTECTED is "true".
|
|
21
|
+
* runner GitLab: CI_RUNNER_TAGS holds each of the job's tags.
|
|
22
|
+
* GitHub and Forgejo expose no labels, only whether the
|
|
23
|
+
* runner is self-hosted: when the job's labels include
|
|
24
|
+
* `self-hosted`, the token's runner_environment claim,
|
|
25
|
+
* else RUNNER_ENVIRONMENT, is `self-hosted`. Neither
|
|
26
|
+
* set: not checked.
|
|
27
|
+
*
|
|
28
|
+
* The generated step runs {@link jobGuardLine}: `node -e` from `/`, as the
|
|
29
|
+
* cloud trade does, so no file of the checkout is in reach and the guard
|
|
30
|
+
* needs nothing installed. `chant ci check-job` (and so a product's bin,
|
|
31
|
+
* `plywood ci check-job`, `terragucci ci check-job`) runs the same check
|
|
32
|
+
* from the same variable, through {@link checkJob}, for a product that
|
|
33
|
+
* renders its own jobs. The lines name the product from its words.
|
|
34
|
+
*
|
|
35
|
+
* A refusal exits chant's `misplaced` (9), as does a variable the guard
|
|
36
|
+
* cannot read. GitLab's op-wave jobs allow exit 1 as a failure the next wave
|
|
37
|
+
* runs after, and 9 is outside that set, so a refused job fails and the
|
|
38
|
+
* waves after it stop.
|
|
39
|
+
*
|
|
40
|
+
* The guard catches a hand edit, a dropped `environment:` or a mistyped
|
|
41
|
+
* label. Someone who can edit the workflow can delete it too: the forge's
|
|
42
|
+
* environment and runner settings and the cloud role's trust are what keep
|
|
43
|
+
* a job out.
|
|
44
|
+
*/
|
|
45
|
+
import { isRunnerGroup } from "./ci-jobs.js";
|
|
46
|
+
import { CHANT_EXIT } from "./exit-codes.js";
|
|
47
|
+
/** The variable the generated step carries its expectation in. */
|
|
48
|
+
export const JOB_GUARD_ENV = "CHANT_JOB_GUARD";
|
|
49
|
+
/** The audience of the token the guard requests on GitHub, which no cloud role should trust. */
|
|
50
|
+
export const JOB_GUARD_AUDIENCE = "chant-check-job";
|
|
51
|
+
/**
|
|
52
|
+
* The expectation a generator writes into a job. GitHub checks the forge
|
|
53
|
+
* environment only in a job that may request a token; Forgejo never does.
|
|
54
|
+
*/
|
|
55
|
+
export function jobGuardSpec(input) {
|
|
56
|
+
const labels = input.runner === undefined ? [] : typeof input.runner === "string" ? [input.runner] : isRunnerGroup(input.runner) ? [...(input.runner.labels ?? [])] : [...input.runner];
|
|
57
|
+
const readsEnvironment = input.forge === "gitlab" || (input.forge === "github" && input.idToken === true);
|
|
58
|
+
return {
|
|
59
|
+
forge: input.forge,
|
|
60
|
+
job: input.job,
|
|
61
|
+
...(input.product && input.product !== "chant" ? { product: input.product } : {}),
|
|
62
|
+
...(input.environment !== undefined && readsEnvironment ? { forgeEnvironment: input.environment } : {}),
|
|
63
|
+
branches: [...input.branches],
|
|
64
|
+
...(input.forge === "gitlab" && labels.length > 0 ? { runnerTags: labels } : {}),
|
|
65
|
+
...(input.forge !== "gitlab" && labels.includes("self-hosted") ? { selfHosted: true } : {}),
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
/** Read {@link JOB_GUARD_ENV}'s JSON, refusing one that is not a guard spec. */
|
|
69
|
+
export function parseJobGuardSpec(raw) {
|
|
70
|
+
if (raw === undefined || raw.trim() === "")
|
|
71
|
+
throw new Error(`${JOB_GUARD_ENV} is not set; the generated step carries the job's expectation in it`);
|
|
72
|
+
let v;
|
|
73
|
+
try {
|
|
74
|
+
v = JSON.parse(raw);
|
|
75
|
+
}
|
|
76
|
+
catch {
|
|
77
|
+
throw new Error(`${JOB_GUARD_ENV} is not JSON`);
|
|
78
|
+
}
|
|
79
|
+
const o = v;
|
|
80
|
+
if (!o || typeof o !== "object")
|
|
81
|
+
throw new Error(`${JOB_GUARD_ENV} is not an object`);
|
|
82
|
+
if (o.forge !== "github" && o.forge !== "gitlab" && o.forge !== "forgejo")
|
|
83
|
+
throw new Error(`${JOB_GUARD_ENV}.forge is ${JSON.stringify(o.forge)}; give github, gitlab or forgejo`);
|
|
84
|
+
if (typeof o.job !== "string" || o.job === "")
|
|
85
|
+
throw new Error(`${JOB_GUARD_ENV}.job names no job`);
|
|
86
|
+
if (!Array.isArray(o.branches) || o.branches.some((b) => typeof b !== "string"))
|
|
87
|
+
throw new Error(`${JOB_GUARD_ENV}.branches is not a list of branches`);
|
|
88
|
+
if (o.forgeEnvironment !== undefined && typeof o.forgeEnvironment !== "string")
|
|
89
|
+
throw new Error(`${JOB_GUARD_ENV}.forgeEnvironment is not a name`);
|
|
90
|
+
if (o.runnerTags !== undefined && (!Array.isArray(o.runnerTags) || o.runnerTags.some((t) => typeof t !== "string")))
|
|
91
|
+
throw new Error(`${JOB_GUARD_ENV}.runnerTags is not a list of tags`);
|
|
92
|
+
return o;
|
|
93
|
+
}
|
|
94
|
+
const shown = (v) => (v === undefined || v === null || v === "" ? "none" : v);
|
|
95
|
+
/** The tags CI_RUNNER_TAGS lists: a JSON array, or a comma-separated list. */
|
|
96
|
+
export function runnerTagsOf(raw) {
|
|
97
|
+
if (raw === undefined)
|
|
98
|
+
return undefined;
|
|
99
|
+
const t = raw.trim();
|
|
100
|
+
if (t.startsWith("[")) {
|
|
101
|
+
try {
|
|
102
|
+
const v = JSON.parse(t);
|
|
103
|
+
if (Array.isArray(v))
|
|
104
|
+
return v.map(String);
|
|
105
|
+
}
|
|
106
|
+
catch {
|
|
107
|
+
// fall through to the plain list
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
return t === "" ? [] : t.split(",").map((s) => s.trim()).filter((s) => s !== "");
|
|
111
|
+
}
|
|
112
|
+
/** A JWT's claims, without checking its signature: the token came from the forge a moment ago and is used for nothing else. */
|
|
113
|
+
export function tokenClaims(token) {
|
|
114
|
+
const part = token.split(".")[1];
|
|
115
|
+
if (!part)
|
|
116
|
+
throw new Error("the forge's OIDC token is not a JWT");
|
|
117
|
+
const json = Buffer.from(part.replace(/-/g, "+").replace(/_/g, "/"), "base64").toString("utf-8");
|
|
118
|
+
const claims = JSON.parse(json);
|
|
119
|
+
if (!claims || typeof claims !== "object")
|
|
120
|
+
throw new Error("the forge's OIDC token has no claims");
|
|
121
|
+
return claims;
|
|
122
|
+
}
|
|
123
|
+
/** Compare what the job sees with what the spec expects. */
|
|
124
|
+
export function checkJob(expect, seen) {
|
|
125
|
+
const out = { problems: [], checked: [], skipped: [] };
|
|
126
|
+
const fe = expect.forgeEnvironment;
|
|
127
|
+
if (expect.forge === "forgejo")
|
|
128
|
+
out.skipped.push("forge environment (Forgejo has none)");
|
|
129
|
+
else if (fe !== undefined) {
|
|
130
|
+
if (seen.forgeEnvironmentError !== undefined)
|
|
131
|
+
out.problems.push(`forge environment: expected ${fe}, and it could not be read: ${seen.forgeEnvironmentError}`);
|
|
132
|
+
else if (seen.forgeEnvironment !== fe)
|
|
133
|
+
out.problems.push(`forge environment: expected ${fe}, found ${shown(seen.forgeEnvironment)}`);
|
|
134
|
+
else
|
|
135
|
+
out.checked.push(`forge environment ${fe}`);
|
|
136
|
+
}
|
|
137
|
+
const branches = expect.branches.filter((b) => b !== "");
|
|
138
|
+
if (branches.length === 0)
|
|
139
|
+
out.problems.push("ref: the job names no branch to run from");
|
|
140
|
+
else if (expect.forge === "gitlab") {
|
|
141
|
+
if (!seen.ref || !branches.includes(seen.ref))
|
|
142
|
+
out.problems.push(`ref: expected ${branches.join(" or ")}, found ${shown(seen.ref)}`);
|
|
143
|
+
else
|
|
144
|
+
out.checked.push(`ref ${seen.ref}`);
|
|
145
|
+
if (seen.refProtected !== "true")
|
|
146
|
+
out.problems.push(`ref: expected a protected ref (CI_COMMIT_REF_PROTECTED true), found ${shown(seen.refProtected)}`);
|
|
147
|
+
else
|
|
148
|
+
out.checked.push("protected ref");
|
|
149
|
+
}
|
|
150
|
+
else {
|
|
151
|
+
const refs = branches.map((b) => `refs/heads/${b}`);
|
|
152
|
+
if (!seen.ref || !refs.includes(seen.ref))
|
|
153
|
+
out.problems.push(`ref: expected ${refs.join(" or ")}, found ${shown(seen.ref)}`);
|
|
154
|
+
else
|
|
155
|
+
out.checked.push(`ref ${seen.ref}`);
|
|
156
|
+
}
|
|
157
|
+
if (expect.forge === "gitlab") {
|
|
158
|
+
const want = expect.runnerTags ?? [];
|
|
159
|
+
if (want.length > 0) {
|
|
160
|
+
const have = seen.runnerTags;
|
|
161
|
+
const missing = want.filter((t) => !(have ?? []).includes(t));
|
|
162
|
+
if (have === undefined)
|
|
163
|
+
out.problems.push(`runner: expected tags ${want.join(", ")}, and the job has no CI_RUNNER_TAGS`);
|
|
164
|
+
else if (missing.length > 0)
|
|
165
|
+
out.problems.push(`runner: expected tags ${want.join(", ")}, found ${have.length ? have.join(", ") : "none"}`);
|
|
166
|
+
else
|
|
167
|
+
out.checked.push(`runner tags ${want.join(", ")}`);
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
else if (expect.selfHosted) {
|
|
171
|
+
if (seen.runnerEnvironment === undefined)
|
|
172
|
+
out.skipped.push("runner (the runner says nothing about itself: no RUNNER_ENVIRONMENT)");
|
|
173
|
+
else if (seen.runnerEnvironment !== "self-hosted")
|
|
174
|
+
out.problems.push(`runner: expected self-hosted, found ${seen.runnerEnvironment}`);
|
|
175
|
+
else
|
|
176
|
+
out.checked.push("self-hosted runner");
|
|
177
|
+
}
|
|
178
|
+
return out;
|
|
179
|
+
}
|
|
180
|
+
/** Ask GitHub for an OIDC token for {@link JOB_GUARD_AUDIENCE} and return its claims; the token itself is dropped. */
|
|
181
|
+
async function githubClaims(env, fetchFn) {
|
|
182
|
+
const url = env.ACTIONS_ID_TOKEN_REQUEST_URL;
|
|
183
|
+
const bearer = env.ACTIONS_ID_TOKEN_REQUEST_TOKEN;
|
|
184
|
+
if (!url || !bearer)
|
|
185
|
+
throw new Error("the job may request no OIDC token (no ACTIONS_ID_TOKEN_REQUEST_URL); it needs the id-token: write permission");
|
|
186
|
+
const r = await fetchFn(`${url}&audience=${encodeURIComponent(JOB_GUARD_AUDIENCE)}`, { headers: { authorization: `bearer ${bearer}` } });
|
|
187
|
+
if (!r.ok)
|
|
188
|
+
throw new Error(`the OIDC token request answered ${r.status}`);
|
|
189
|
+
const value = (await r.json()).value;
|
|
190
|
+
if (typeof value !== "string")
|
|
191
|
+
throw new Error("the OIDC token request answered no token");
|
|
192
|
+
return tokenClaims(value);
|
|
193
|
+
}
|
|
194
|
+
/** What the job sees, from the forge's variables, and on GitHub from its token's claims when the forge environment is to be checked. */
|
|
195
|
+
export async function jobSeen(expect, env = process.env, fetchFn = fetch) {
|
|
196
|
+
if (expect.forge === "gitlab") {
|
|
197
|
+
return {
|
|
198
|
+
forgeEnvironment: env.CI_ENVIRONMENT_NAME || null,
|
|
199
|
+
...(env.CI_COMMIT_REF_NAME !== undefined ? { ref: env.CI_COMMIT_REF_NAME } : {}),
|
|
200
|
+
...(env.CI_COMMIT_REF_PROTECTED !== undefined ? { refProtected: env.CI_COMMIT_REF_PROTECTED } : {}),
|
|
201
|
+
...(env.CI_RUNNER_TAGS !== undefined ? { runnerTags: runnerTagsOf(env.CI_RUNNER_TAGS) } : {}),
|
|
202
|
+
};
|
|
203
|
+
}
|
|
204
|
+
const seen = { ...(env.GITHUB_REF !== undefined ? { ref: env.GITHUB_REF } : {}) };
|
|
205
|
+
let claims;
|
|
206
|
+
if (expect.forge === "github" && expect.forgeEnvironment !== undefined) {
|
|
207
|
+
try {
|
|
208
|
+
claims = await githubClaims(env, fetchFn);
|
|
209
|
+
seen.forgeEnvironment = typeof claims.environment === "string" && claims.environment !== "" ? claims.environment : null;
|
|
210
|
+
}
|
|
211
|
+
catch (e) {
|
|
212
|
+
seen.forgeEnvironmentError = e.message;
|
|
213
|
+
}
|
|
214
|
+
}
|
|
215
|
+
const runner = typeof claims?.runner_environment === "string" ? claims.runner_environment : env.RUNNER_ENVIRONMENT;
|
|
216
|
+
if (runner)
|
|
217
|
+
seen.runnerEnvironment = runner;
|
|
218
|
+
return seen;
|
|
219
|
+
}
|
|
220
|
+
/** The lines the guard prints, and whether the job may go on. */
|
|
221
|
+
export function describeJobGuard(expect, result) {
|
|
222
|
+
const at = `${expect.product ?? "chant"} check-job: ${expect.job}`;
|
|
223
|
+
if (result.problems.length > 0) {
|
|
224
|
+
return {
|
|
225
|
+
ok: false,
|
|
226
|
+
out: [],
|
|
227
|
+
err: [...result.problems.map((p) => `${at}: ${p}`), `${at}: this job does not run where the spec set it to run, so it stops before any credential is taken or code checked out`],
|
|
228
|
+
};
|
|
229
|
+
}
|
|
230
|
+
const skipped = result.skipped.length ? `; not checked: ${result.skipped.join(", ")}` : "";
|
|
231
|
+
return { ok: true, out: [`${at}: ${result.checked.length ? result.checked.join(", ") : "nothing to check"}${skipped}`], err: [] };
|
|
232
|
+
}
|
|
233
|
+
/**
|
|
234
|
+
* The guard as one `node -e` program: the same checks as {@link checkJob},
|
|
235
|
+
* {@link jobSeen} and {@link describeJobGuard}, reading {@link JOB_GUARD_ENV}.
|
|
236
|
+
* Exits chant's `misplaced` (9) with one line per value that differs, and
|
|
237
|
+
* when the variable holds no spec it can read. A test runs it against
|
|
238
|
+
* {@link checkJob} so the two stay the same.
|
|
239
|
+
*/
|
|
240
|
+
export const JOB_GUARD_JS = [
|
|
241
|
+
'"use strict";',
|
|
242
|
+
`const E=process.env,A=${JSON.stringify(JOB_GUARD_AUDIENCE)};`,
|
|
243
|
+
"const shown=(v)=>v===undefined||v===null||v===\"\"?\"none\":v;",
|
|
244
|
+
`const fail=(m)=>{console.error("check-job: "+m);process.exit(${CHANT_EXIT.misplaced})};`,
|
|
245
|
+
"let x;try{x=JSON.parse(E." + JOB_GUARD_ENV + "||\"\")}catch(e){fail(\"" + JOB_GUARD_ENV + " is not JSON\")}",
|
|
246
|
+
"if(!x||![\"github\",\"gitlab\",\"forgejo\"].includes(x.forge)||!Array.isArray(x.branches))fail(\"" + JOB_GUARD_ENV + " is not a guard spec\");",
|
|
247
|
+
'const tags=(r)=>{if(r===undefined)return undefined;const t=r.trim();if(t.startsWith("[")){try{const v=JSON.parse(t);if(Array.isArray(v))return v.map(String)}catch(e){}}return t===""?[]:t.split(",").map((s)=>s.trim()).filter((s)=>s!=="")};',
|
|
248
|
+
'const claimsOf=(tok)=>{const p=tok.split(".")[1];if(!p)throw new Error("the forge\\u0027s OIDC token is not a JWT");const c=JSON.parse(Buffer.from(p.replace(/-/g,"+").replace(/_/g,"/"),"base64").toString("utf-8"));if(!c||typeof c!=="object")throw new Error("the forge\\u0027s OIDC token has no claims");return c};',
|
|
249
|
+
"async function seenOf(){",
|
|
250
|
+
'if(x.forge==="gitlab")return{forgeEnvironment:E.CI_ENVIRONMENT_NAME||null,ref:E.CI_COMMIT_REF_NAME,refProtected:E.CI_COMMIT_REF_PROTECTED,runnerTags:tags(E.CI_RUNNER_TAGS)};',
|
|
251
|
+
"const s={ref:E.GITHUB_REF};let c;",
|
|
252
|
+
'if(x.forge==="github"&&x.forgeEnvironment!==undefined){try{',
|
|
253
|
+
'if(!E.ACTIONS_ID_TOKEN_REQUEST_URL||!E.ACTIONS_ID_TOKEN_REQUEST_TOKEN)throw new Error("the job may request no OIDC token (no ACTIONS_ID_TOKEN_REQUEST_URL); it needs the id-token: write permission");',
|
|
254
|
+
'const r=await fetch(E.ACTIONS_ID_TOKEN_REQUEST_URL+"&audience="+encodeURIComponent(A),{headers:{authorization:"bearer "+E.ACTIONS_ID_TOKEN_REQUEST_TOKEN}});',
|
|
255
|
+
'if(!r.ok)throw new Error("the OIDC token request answered "+r.status);const v=(await r.json()).value;if(typeof v!=="string")throw new Error("the OIDC token request answered no token");',
|
|
256
|
+
'c=claimsOf(v);s.forgeEnvironment=typeof c.environment==="string"&&c.environment!==""?c.environment:null}catch(e){s.forgeEnvironmentError=e&&e.message?e.message:String(e)}}',
|
|
257
|
+
'const run=c&&typeof c.runner_environment==="string"?c.runner_environment:E.RUNNER_ENVIRONMENT;if(run)s.runnerEnvironment=run;return s}',
|
|
258
|
+
"seenOf().then((s)=>{const P=[],C=[],S=[];const fe=x.forgeEnvironment;",
|
|
259
|
+
'if(x.forge==="forgejo")S.push("forge environment (Forgejo has none)");',
|
|
260
|
+
'else if(fe!==undefined){if(s.forgeEnvironmentError!==undefined)P.push("forge environment: expected "+fe+", and it could not be read: "+s.forgeEnvironmentError);else if(s.forgeEnvironment!==fe)P.push("forge environment: expected "+fe+", found "+shown(s.forgeEnvironment));else C.push("forge environment "+fe)}',
|
|
261
|
+
'const b=x.branches.filter((v)=>v!=="");',
|
|
262
|
+
'if(b.length===0)P.push("ref: the job names no branch to run from");',
|
|
263
|
+
'else if(x.forge==="gitlab"){if(!s.ref||!b.includes(s.ref))P.push("ref: expected "+b.join(" or ")+", found "+shown(s.ref));else C.push("ref "+s.ref);',
|
|
264
|
+
'if(s.refProtected!=="true")P.push("ref: expected a protected ref (CI_COMMIT_REF_PROTECTED true), found "+shown(s.refProtected));else C.push("protected ref")}',
|
|
265
|
+
'else{const refs=b.map((v)=>"refs/heads/"+v);if(!s.ref||!refs.includes(s.ref))P.push("ref: expected "+refs.join(" or ")+", found "+shown(s.ref));else C.push("ref "+s.ref)}',
|
|
266
|
+
'if(x.forge==="gitlab"){const w=x.runnerTags||[];if(w.length>0){const h=s.runnerTags;const miss=w.filter((t)=>!(h||[]).includes(t));',
|
|
267
|
+
'if(h===undefined)P.push("runner: expected tags "+w.join(", ")+", and the job has no CI_RUNNER_TAGS");else if(miss.length>0)P.push("runner: expected tags "+w.join(", ")+", found "+(h.length?h.join(", "):"none"));else C.push("runner tags "+w.join(", "))}}',
|
|
268
|
+
'else if(x.selfHosted){if(s.runnerEnvironment===undefined)S.push("runner (the runner says nothing about itself: no RUNNER_ENVIRONMENT)");else if(s.runnerEnvironment!=="self-hosted")P.push("runner: expected self-hosted, found "+s.runnerEnvironment);else C.push("self-hosted runner")}',
|
|
269
|
+
'const at=(x.product||"chant")+" check-job: "+x.job;',
|
|
270
|
+
'if(P.length>0){for(const p of P)console.error(at+": "+p);console.error(at+": this job does not run where the spec set it to run, so it stops before any credential is taken or code checked out");process.exit(' + CHANT_EXIT.misplaced + ")}",
|
|
271
|
+
'console.log(at+": "+(C.length?C.join(", "):"nothing to check")+(S.length?"; not checked: "+S.join(", "):""))',
|
|
272
|
+
"}).catch((e)=>fail(e&&e.message?e.message:String(e)));",
|
|
273
|
+
].join("");
|
|
274
|
+
/** The shell line of the guard step: `node -e` from `/`, so no file of the checkout is in reach. */
|
|
275
|
+
export function jobGuardLine() {
|
|
276
|
+
return `(cd / && node -e '${JOB_GUARD_JS}')`;
|
|
277
|
+
}
|
|
278
|
+
/** How the guard's lines name an op-wave job: `wave 2 (prod) of deploy`, `share 1 of job group eu of wave 2 (prod) of deploy`. */
|
|
279
|
+
export function opWaveJobLabel(spec, job) {
|
|
280
|
+
const wave = `wave ${job.wave} (${job.waveName}) of ${spec}`;
|
|
281
|
+
const share = job.share !== undefined ? `share ${job.share} of ` : "";
|
|
282
|
+
if (job.kind === "decide")
|
|
283
|
+
return `the deciding job of ${wave}`;
|
|
284
|
+
if (job.group !== undefined)
|
|
285
|
+
return `${share}job group ${job.group} of ${wave}`;
|
|
286
|
+
return `${share}${wave}`;
|
|
287
|
+
}
|