@intentius/chant 0.124.55 → 0.124.57
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/ci-agent.d.ts.map +1 -1
- package/dist/ci-agent.js +1 -2
- 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 +11 -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.map +1 -1
- package/dist/ci-control.js +3 -4
- package/dist/ci-estate.d.ts +24 -0
- package/dist/ci-estate.d.ts.map +1 -1
- package/dist/ci-estate.js +1 -2
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +2 -3
- 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 +7 -1
- package/dist/ci-product-words.d.ts.map +1 -1
- package/dist/ci-product-words.js +38 -4
- package/dist/ci-product.d.ts +35 -0
- package/dist/ci-product.d.ts.map +1 -1
- package/dist/ci-product.js +38 -4
- 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/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 +81 -0
- 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.map +1 -1
- package/dist/cli/handlers/ci-check.js +38 -9
- 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/lifecycle.d.ts.map +1 -1
- package/dist/cli/handlers/lifecycle.js +14 -0
- package/dist/cli/handlers/pr.d.ts +5 -0
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +346 -36
- package/dist/cli/handlers/run-wave.js +89 -1
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +56 -2
- package/dist/cli/parse-args.d.ts.map +1 -1
- package/dist/cli/parse-args.js +107 -0
- package/dist/cli/registry.d.ts +38 -0
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/components/adoption.d.ts.map +1 -1
- package/dist/components/adoption.js +1 -2
- package/dist/components/auto-release.d.ts +5 -2
- package/dist/components/auto-release.d.ts.map +1 -1
- package/dist/components/auto-release.js +9 -4
- package/dist/components/capability.d.ts +47 -0
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +25 -0
- package/dist/components/check-hooks.d.ts +4 -1
- package/dist/components/check-hooks.d.ts.map +1 -1
- 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.map +1 -1
- package/dist/components/ci-services.js +1 -2
- package/dist/components/deploy-units.d.ts +12 -0
- package/dist/components/deploy-units.d.ts.map +1 -1
- package/dist/components/deploy-units.js +20 -1
- package/dist/components/driver.d.ts +12 -0
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +35 -1
- package/dist/components/groups.d.ts.map +1 -1
- package/dist/components/groups.js +4 -3
- package/dist/components/pr-env-ledger.d.ts.map +1 -1
- package/dist/components/pr-env-ledger.js +1 -2
- package/dist/components/pr-environment.d.ts +1 -1
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +1 -1
- package/dist/components/pr-pipeline.d.ts +137 -5
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +164 -20
- package/dist/components/pr-run.d.ts +8 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +9 -4
- package/dist/components/product-pipeline.d.ts +35 -2
- package/dist/components/product-pipeline.d.ts.map +1 -1
- package/dist/components/product-pipeline.js +24 -5
- package/dist/components/row-lease.d.ts +22 -1
- package/dist/components/row-lease.d.ts.map +1 -1
- package/dist/components/row-lease.js +32 -6
- package/dist/components/wave-plan.d.ts +8 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +18 -2
- 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 +47 -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/exit-codes.d.ts +7 -1
- package/dist/exit-codes.d.ts.map +1 -1
- package/dist/exit-codes.js +7 -1
- package/dist/lexicon.d.ts +55 -0
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.js +2 -3
- package/dist/lifecycle/gated-request.d.ts.map +1 -1
- package/dist/lifecycle/gated-request.js +1 -2
- package/dist/lifecycle/git.d.ts +39 -3
- package/dist/lifecycle/git.d.ts.map +1 -1
- package/dist/lifecycle/git.js +223 -15
- package/dist/lifecycle/lock-rows.d.ts +23 -0
- package/dist/lifecycle/lock-rows.d.ts.map +1 -1
- package/dist/lifecycle/lock-rows.js +47 -8
- package/dist/lifecycle/query.d.ts.map +1 -1
- package/dist/lifecycle/query.js +4 -5
- package/dist/lifecycle/release-catalog.d.ts.map +1 -1
- package/dist/lifecycle/release-catalog.js +1 -1
- package/dist/lifecycle/release-ledger.d.ts.map +1 -1
- package/dist/lifecycle/release-ledger.js +1 -2
- package/dist/lifecycle/release-status.d.ts +20 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -1
- package/dist/lifecycle/release-status.js +1 -22
- package/dist/lifecycle/resource-lock.d.ts +70 -0
- package/dist/lifecycle/resource-lock.d.ts.map +1 -1
- package/dist/lifecycle/resource-lock.js +241 -5
- 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/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.js +21 -4
- package/dist/op/index.d.ts +1 -1
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +1 -1
- package/dist/op/op-waves-capability-spec.d.ts +8 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -1
- package/dist/op/op-waves-capability-spec.js +21 -0
- package/dist/op/op-waves-release-port.js +1 -1
- package/dist/op/op-waves-release.d.ts +2 -1
- package/dist/op/op-waves-release.d.ts.map +1 -1
- package/dist/op/op-waves-release.js +1 -2
- package/dist/op/op-waves-run.d.ts +15 -2
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +195 -31
- package/dist/op/op-waves-stand-down.d.ts.map +1 -1
- package/dist/op/op-waves-stand-down.js +1 -2
- package/dist/op/op-waves.d.ts +53 -0
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +62 -6
- package/dist/op/runtime.d.ts +4 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +2 -3
- package/dist/otlp.d.ts.map +1 -1
- package/dist/otlp.js +1 -2
- package/dist/parallelism.d.ts +17 -0
- package/dist/parallelism.d.ts.map +1 -0
- package/dist/parallelism.js +33 -0
- package/dist/policy-source.d.ts.map +1 -1
- package/dist/policy-source.js +1 -2
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +56 -39
- package/dist/pr-loop.d.ts +9 -0
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +22 -4
- 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 +70 -1
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +116 -5
- package/dist/pr-report-url.d.ts.map +1 -1
- package/dist/pr-report-url.js +1 -2
- package/dist/release-floors.d.ts +1 -1
- package/dist/release-floors.js +1 -1
- package/dist/run-event.d.ts.map +1 -1
- package/dist/run-event.js +1 -2
- 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/wave-runtime.mjs +351 -328
- package/dist/workspace/ci-lock-grain.d.ts +5 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -1
- package/dist/workspace/ci-lock-grain.js +1 -7
- package/dist/workspace/ci-run.d.ts.map +1 -1
- package/dist/workspace/ci-run.js +5 -1
- package/dist/workspace/pr-report.schema.json +5 -0
- package/package.json +1 -1
- package/src/ci-agent.ts +1 -2
- 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 +14 -0
- package/src/ci-audit/unrecorded.ts +140 -0
- package/src/ci-audit.ts +2 -0
- package/src/ci-control.ts +3 -4
- package/src/ci-estate.ts +1 -2
- package/src/ci-identity-database.test.ts +2 -3
- package/src/ci-identity-targets.test.ts +1 -3
- package/src/ci-identity.ts +2 -3
- 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.ts +35 -6
- package/src/ci-product.ts +55 -4
- 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/cli/handlers/audit-log.ts +74 -0
- package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
- package/src/cli/handlers/build.ts +69 -0
- 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 +38 -8
- package/src/cli/handlers/e2e-safe-run.ts +27 -0
- package/src/cli/handlers/lifecycle.ts +13 -0
- package/src/cli/handlers/pr-before-merge.test.ts +1 -1
- package/src/cli/handlers/pr-deploy-inputs.test.ts +1 -1
- package/src/cli/handlers/pr-endpoint.test.ts +1 -1
- package/src/cli/handlers/pr-green.test.ts +1 -1
- 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 +1 -1
- package/src/cli/handlers/pr-record.test.ts +34 -2
- package/src/cli/handlers/pr-waves-blocked.test.ts +1 -1
- package/src/cli/handlers/pr-waves.test.ts +1 -1
- package/src/cli/handlers/pr.test.ts +1 -1
- package/src/cli/handlers/pr.ts +311 -32
- package/src/cli/handlers/run-wave.ts +79 -1
- package/src/cli/main.test.ts +1 -1
- package/src/cli/main.ts +56 -2
- package/src/cli/parse-args.ts +77 -0
- package/src/cli/registry.ts +38 -0
- package/src/components/adoption.ts +1 -2
- package/src/components/auto-release.test.ts +4 -2
- package/src/components/auto-release.ts +9 -5
- package/src/components/capability.ts +60 -0
- package/src/components/check-hooks.ts +4 -1
- package/src/components/check-steps.test.ts +70 -0
- package/src/components/check-steps.ts +158 -0
- package/src/components/ci-services.ts +1 -2
- package/src/components/deploy-units.test.ts +18 -1
- package/src/components/deploy-units.ts +26 -1
- package/src/components/driver.ts +35 -1
- package/src/components/groups.ts +4 -2
- package/src/components/plan-flags.test.ts +46 -0
- package/src/components/pr-comment-preview-targets.test.ts +34 -0
- package/src/components/pr-env-ledger.ts +1 -2
- package/src/components/pr-env-run-bundle.test.ts +0 -20
- package/src/components/pr-environment.ts +1 -1
- package/src/components/pr-pipeline-runners.test.ts +80 -0
- package/src/components/pr-pipeline.ts +244 -20
- package/src/components/pr-run.ts +17 -6
- package/src/components/pr-stale-job.test.ts +34 -0
- package/src/components/product-pipeline.ts +50 -8
- package/src/components/row-lease.test.ts +61 -1
- package/src/components/row-lease.ts +48 -7
- package/src/components/wave-plan.ts +18 -2
- 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 +49 -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/exit-codes.test.ts +3 -2
- package/src/exit-codes.ts +7 -1
- package/src/gate-decision-bundle.test.ts +0 -2
- package/src/lexicon.ts +57 -0
- package/src/lifecycle/control-entries-ledger.test.ts +2 -3
- package/src/lifecycle/gate-ledger.ts +2 -3
- package/src/lifecycle/gated-request.ts +1 -2
- package/src/lifecycle/git.test.ts +155 -0
- package/src/lifecycle/git.ts +213 -17
- package/src/lifecycle/lock-rows.test.ts +6 -1
- package/src/lifecycle/lock-rows.ts +58 -7
- package/src/lifecycle/query.ts +4 -5
- package/src/lifecycle/release-catalog.test.ts +3 -4
- package/src/lifecycle/release-catalog.ts +1 -1
- package/src/lifecycle/release-ledger.ts +1 -2
- package/src/lifecycle/release-status.test.ts +3 -4
- package/src/lifecycle/release-status.ts +1 -2
- package/src/lifecycle/resource-lock-wait.test.ts +292 -0
- package/src/lifecycle/resource-lock.ts +261 -7
- package/src/lifecycle/wave-plans.ts +33 -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.test.ts +7 -5
- package/src/op/gate.ts +20 -4
- package/src/op/index.ts +2 -0
- package/src/op/op-waves-after-plan.test.ts +11 -0
- package/src/op/op-waves-capability-spec.ts +20 -0
- package/src/op/op-waves-ledger-lock.test.ts +208 -0
- package/src/op/op-waves-parallelism.test.ts +89 -0
- package/src/op/op-waves-pull-request.test.ts +78 -1
- package/src/op/op-waves-release-port.ts +1 -1
- package/src/op/op-waves-release.ts +2 -3
- package/src/op/op-waves-run.ts +196 -31
- package/src/op/op-waves-stand-down.ts +1 -2
- package/src/op/op-waves.ts +81 -6
- package/src/op/runtime.ts +6 -3
- package/src/otlp.ts +1 -2
- package/src/parallelism.test.ts +38 -0
- package/src/parallelism.ts +33 -0
- package/src/policy-source.ts +1 -2
- package/src/pr-forge-bundle.test.ts +1 -1
- package/src/pr-forge.ts +54 -35
- package/src/pr-loop-bundle.test.ts +0 -2
- package/src/pr-loop-narrowed.test.ts +63 -0
- package/src/pr-loop.ts +30 -4
- 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 +159 -5
- package/src/pr-report-url.ts +1 -2
- package/src/product-subpaths-plain-node.e2e.test.ts +1 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +1 -2
- package/src/scheduled-op-cloud.ts +68 -0
- package/src/stage-hooks-bundle.test.ts +0 -2
- package/src/workspace/ci-lock-grain.ts +1 -2
- package/src/workspace/ci-run.ts +5 -1
- package/src/workspace/pr-report.schema.json +5 -0
|
@@ -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":"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"}
|
|
@@ -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
|
+
}
|
package/dist/ci-jobs.d.ts
CHANGED
|
@@ -37,6 +37,13 @@ export declare const CI_IMAGE = "node:22";
|
|
|
37
37
|
* default branch; a project on another one names it.
|
|
38
38
|
*/
|
|
39
39
|
export declare const DEFAULT_BRANCH = "main";
|
|
40
|
+
/**
|
|
41
|
+
* Where the pull request environment jobs (#4298) write their reports, kept
|
|
42
|
+
* as a CI artifact. It lives here, with no imports, so `pr-env` code that
|
|
43
|
+
* needs only the path (./components/pr-environment.ts and the pr-env-run
|
|
44
|
+
* bundle) does not load ./components/pr-pipeline.ts.
|
|
45
|
+
*/
|
|
46
|
+
export declare const PR_ENV_REPORT_DIR = ".chant/pr-env";
|
|
40
47
|
/**
|
|
41
48
|
* The branches a push trigger filters on: the ones given, or
|
|
42
49
|
* {@link DEFAULT_BRANCH} when none are. An empty list is none, on every
|
package/dist/ci-jobs.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ci-jobs.d.ts","sourceRoot":"","sources":["../src/ci-jobs.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"ci-jobs.d.ts","sourceRoot":"","sources":["../src/ci-jobs.ts"],"names":[],"mappings":"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"}
|
package/dist/ci-jobs.js
CHANGED
|
@@ -37,6 +37,13 @@ export const CI_IMAGE = "node:22";
|
|
|
37
37
|
* default branch; a project on another one names it.
|
|
38
38
|
*/
|
|
39
39
|
export const DEFAULT_BRANCH = "main";
|
|
40
|
+
/**
|
|
41
|
+
* Where the pull request environment jobs (#4298) write their reports, kept
|
|
42
|
+
* as a CI artifact. It lives here, with no imports, so `pr-env` code that
|
|
43
|
+
* needs only the path (./components/pr-environment.ts and the pr-env-run
|
|
44
|
+
* bundle) does not load ./components/pr-pipeline.ts.
|
|
45
|
+
*/
|
|
46
|
+
export const PR_ENV_REPORT_DIR = ".chant/pr-env";
|
|
40
47
|
/**
|
|
41
48
|
* The branches a push trigger filters on: the ones given, or
|
|
42
49
|
* {@link DEFAULT_BRANCH} when none are. An empty list is none, on every
|
|
@@ -252,10 +252,16 @@ export declare function commentLine(words: CiProductWords, command: CiProductCom
|
|
|
252
252
|
export declare function productWaveGate(words: CiProductWords, gate: string, k: number): string;
|
|
253
253
|
/** A comment read against the product's grammar. */
|
|
254
254
|
export type ParsedProductComment =
|
|
255
|
-
/**
|
|
255
|
+
/**
|
|
256
|
+
* A re-plan, of one member when the comment names it, narrowed to each
|
|
257
|
+
* `--target <address>` (or `<member>:<address>`) after the plan word (#4626).
|
|
258
|
+
*/
|
|
256
259
|
{
|
|
257
260
|
kind: "plan";
|
|
258
261
|
member?: string;
|
|
262
|
+
targets?: string[];
|
|
263
|
+
refresh?: true;
|
|
264
|
+
targetDependents?: true;
|
|
259
265
|
}
|
|
260
266
|
/** An apply, through wave n when the comment names `wave-<n>`. */
|
|
261
267
|
| {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ci-product-words.d.ts","sourceRoot":"","sources":["../src/ci-product-words.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"ci-product-words.d.ts","sourceRoot":"","sources":["../src/ci-product-words.ts"],"names":[],"mappings":"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"}
|
package/dist/ci-product-words.js
CHANGED
|
@@ -273,6 +273,13 @@ export function productWaveGate(words, gate, k) {
|
|
|
273
273
|
}
|
|
274
274
|
/** A member as a comment may name it: path segments, no leading dash, no shell or glob syntax. */
|
|
275
275
|
const MEMBER = /^[A-Za-z0-9_][A-Za-z0-9_.\/-]{0,199}$/;
|
|
276
|
+
/**
|
|
277
|
+
* A target address as a comment may give it (#4626): a Terraform address,
|
|
278
|
+
* a Pulumi URN, or `<member>:<address>`, at most 500 characters, with no
|
|
279
|
+
* leading dash and none of the characters a shell or a quote would read.
|
|
280
|
+
* It never reaches a shell: the job reads the comment from a variable.
|
|
281
|
+
*/
|
|
282
|
+
const TARGET = /^[A-Za-z0-9_][A-Za-z0-9_.:\/\[\]"*@=+$,-]{0,499}$/;
|
|
276
283
|
/** The longest ask an agent comment may carry. */
|
|
277
284
|
export const PRODUCT_COMMENT_ASK_MAX = 2000;
|
|
278
285
|
/** Commands a comment never runs, named in the reply so nobody waits on them. */
|
|
@@ -360,14 +367,41 @@ export function parseProductComment(words, body, env = {}) {
|
|
|
360
367
|
return m ? { kind: "apply", wave: Number(m[1]) } : { kind: "refused", reason: `${line} takes nothing, or a wave like \`wave-2\`` };
|
|
361
368
|
}
|
|
362
369
|
case "plan": {
|
|
363
|
-
|
|
370
|
+
// #4626: repeatable --target <address> after the plan word, and at most one member.
|
|
371
|
+
const targets = [];
|
|
372
|
+
const rest = [];
|
|
373
|
+
const flags = {};
|
|
374
|
+
for (let i = 2; i < parts.length; i++) {
|
|
375
|
+
const w = parts[i];
|
|
376
|
+
if (w === "--target") {
|
|
377
|
+
const address = parts[++i];
|
|
378
|
+
if (address === undefined)
|
|
379
|
+
return { kind: "refused", reason: `\`--target\` needs an address after it: \`${prefix} ${typed} --target <address>\`` };
|
|
380
|
+
if (!TARGET.test(address))
|
|
381
|
+
return { kind: "refused", reason: "a target is a resource address or URN, or <member>:<address>, with no spaces or shell characters" };
|
|
382
|
+
targets.push(address);
|
|
383
|
+
}
|
|
384
|
+
else if (w === "--refresh")
|
|
385
|
+
flags.refresh = true;
|
|
386
|
+
// #4627: the flags pr-plan takes beside --target.
|
|
387
|
+
else if (w === "--target-dependents")
|
|
388
|
+
flags.targetDependents = true;
|
|
389
|
+
else if (w.startsWith("-"))
|
|
390
|
+
return { kind: "refused", reason: `${line} takes \`--target <address>\`, \`--target-dependents\` and \`--refresh\`, and no other flag` };
|
|
391
|
+
else
|
|
392
|
+
rest.push(w);
|
|
393
|
+
}
|
|
394
|
+
if (rest.length > 1)
|
|
364
395
|
return { kind: "refused", reason: `${line} takes one ${words.noun[0]} at most` };
|
|
365
|
-
const member =
|
|
396
|
+
const member = rest[0];
|
|
397
|
+
if (flags.targetDependents && targets.length === 0)
|
|
398
|
+
return { kind: "refused", reason: "`--target-dependents` widens a `--target`; give one" };
|
|
399
|
+
const narrowed = { ...(targets.length > 0 ? { targets } : {}), ...flags };
|
|
366
400
|
if (member === undefined)
|
|
367
|
-
return { kind: "plan" };
|
|
401
|
+
return { kind: "plan", ...narrowed };
|
|
368
402
|
if (!MEMBER.test(member) || member.split("/").some((s) => s === "" || s === "." || s === ".."))
|
|
369
403
|
return { kind: "refused", reason: `the ${words.noun[0]} is a name or a path from the repository root` };
|
|
370
|
-
return { kind: "plan", member };
|
|
404
|
+
return { kind: "plan", member, ...narrowed };
|
|
371
405
|
}
|
|
372
406
|
}
|
|
373
407
|
}
|
package/dist/ci-product.d.ts
CHANGED
|
@@ -35,6 +35,41 @@ export { prApplyComment, prCommentLockJobs, prCommentPreviewJob, prLoopSetup, en
|
|
|
35
35
|
export { CI_SERVICES_FLOOR, engineServices, githubServices, gitlabServices, serviceWaitLine, servicesJobEnv, type CiService } from "./components/ci-services.js";
|
|
36
36
|
export { renderPrNote, prStatusContext, prApproveCommand, prApproveCommands, prApproveTargets, prMergeSentence, type PrMemberDetail } from "./pr-loop.js";
|
|
37
37
|
export { upsertPlanNote } from "./pr-post.js";
|
|
38
|
+
/**
|
|
39
|
+
* The approval status before merge (#4630): under a `pr-review` wave, the
|
|
40
|
+
* op waves generators add a job that posts `<product>/approval` on each
|
|
41
|
+
* open pull request's head. A product feature-detects on
|
|
42
|
+
* `APPROVAL_STATUS_FLOOR`.
|
|
43
|
+
*/
|
|
44
|
+
export declare const APPROVAL_STATUS_FLOOR = "0.124.56";
|
|
45
|
+
/**
|
|
46
|
+
* The approval status for `pull-request` waves too (#4630, 2026-10-28
|
|
47
|
+
* ruling): the generators add the record-plans and approval-status jobs for
|
|
48
|
+
* a spec whose waves take the pull request's own approval, and the status
|
|
49
|
+
* reads that approval's coverage of each wave's change set. A product such
|
|
50
|
+
* as plywood, whose waves all take `approval: pull-request`, feature-detects
|
|
51
|
+
* on this floor.
|
|
52
|
+
*/
|
|
53
|
+
export declare const APPROVAL_STATUS_PULL_REQUEST_FLOOR = "0.124.56";
|
|
54
|
+
export { opWavesPostsApprovalStatus } from "./op/op-waves.js";
|
|
55
|
+
export { approvalStatusOf, headWaveHolds, postApprovalStatus, postOpenApprovalStatuses, type ApprovalStatus, type ApprovalStatusInput } from "./op/approval-status.js";
|
|
56
|
+
/**
|
|
57
|
+
* Responses to pipeline events (#4629): a refused wave's diff, a failed
|
|
58
|
+
* apply's triage and the pull request description check, in the product's
|
|
59
|
+
* words. `productPipelineJobs(forge, env, { words, respond, decide })` turns
|
|
60
|
+
* them on and off; a product feature-detects on `CI_RESPOND_FLOOR`.
|
|
61
|
+
*/
|
|
62
|
+
export declare const CI_RESPOND_FLOOR = "0.124.56";
|
|
63
|
+
/**
|
|
64
|
+
* `chant build --pr-loop` carries `--merge auto --merge-token-env <VAR>
|
|
65
|
+
* [--merge-method <m>]` (#4636), `--respond <list>`, `--decide-backend` and
|
|
66
|
+
* `--decide-model` (#4629) into the generated pull request jobs. Before it
|
|
67
|
+
* the build parsed them and wrote jobs without them; a product that writes
|
|
68
|
+
* its pull request jobs with the build feature-detects on this floor.
|
|
69
|
+
*/
|
|
70
|
+
export declare const PR_LOOP_BUILD_FLAGS_FLOOR = "0.124.56";
|
|
71
|
+
export { CI_RESPOND_DEFAULTS, CI_RESPOND_ENV, CI_RESPONSES, parseRespondList, renderRefusedDiff, renderTriage, respondList, resolveResponses, type CiRespondEvent, type CiResponses, type DescriptionFinding, type FailedApply, type RefusedDiff, } from "./ci-respond.js";
|
|
72
|
+
export { respondDescription, respondOpWave, respondPrApply, triageOfOpWave, triageOfPrReport, refusedOfOpWave, refusedOfPrReport } from "./ci-respond-run.js";
|
|
38
73
|
/**
|
|
39
74
|
* Run one chant command line in this process with the product's words
|
|
40
75
|
* (ruling C): what a product's bin calls for every command its verbs map
|