@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,294 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The harness's scenario driver (chant#4587). It runs a scenario's steps in
|
|
3
|
+
* order against the forge, the report bucket, chant, the ledger and the
|
|
4
|
+
* runner's jobs as interfaces (./ports.ts), once as the plain run and once as
|
|
5
|
+
* the BREAK run, and checks each step's outcomes against chant's own reports
|
|
6
|
+
* and run ledger, never the runner's status or logs.
|
|
7
|
+
*
|
|
8
|
+
* A run ends one of three ways. Every outcome held: the plain run passes, and
|
|
9
|
+
* a BREAK run that ends so was missed. An outcome did not hold: the run stops
|
|
10
|
+
* there, the plain run fails, and the BREAK run was caught. A step did not
|
|
11
|
+
* finish (past its limit, or an error): the run stalled, which is neither.
|
|
12
|
+
*/
|
|
13
|
+
import { reportKey } from "../pr-report-url";
|
|
14
|
+
import type { OpRunRecord } from "../op/runtime";
|
|
15
|
+
import type { Bucket, Chant, Clock, ForgeReads, Jobs, Ledger, Log, OutOfBand, PullForge } from "./ports";
|
|
16
|
+
import { componentStatuses, reportObjectKey, splitReportUrl, waitForReport, type PrReportView, type ReportStage } from "./reports";
|
|
17
|
+
import type { BreakVerdict, PlainVerdict, Scenario, ScenarioOutcome, ScenarioStep, ScenarioStepKind } from "./schemas/index";
|
|
18
|
+
import { limitsFor } from "./steps";
|
|
19
|
+
|
|
20
|
+
export type Arm = "plain" | "break";
|
|
21
|
+
|
|
22
|
+
export interface DriverPorts {
|
|
23
|
+
forge: PullForge & Partial<ForgeReads>;
|
|
24
|
+
/** The bucket the scenario's report URL names. */
|
|
25
|
+
bucket: Bucket;
|
|
26
|
+
chant: Pick<Chant, "approve">;
|
|
27
|
+
clock: Clock;
|
|
28
|
+
/** An overlay's files, repo-relative path to content. */
|
|
29
|
+
overlay(name: string): Record<string, string>;
|
|
30
|
+
ledger?: Ledger;
|
|
31
|
+
jobs?: Jobs;
|
|
32
|
+
outOfBand?: OutOfBand;
|
|
33
|
+
/** Put the repo and the stacks back to the base, before each run. */
|
|
34
|
+
reset?(): Promise<void>;
|
|
35
|
+
/** Hand the run's environment to where the pipeline reads it (the runner's secrets file). */
|
|
36
|
+
arm?(arm: Arm, env: Record<string, string>): Promise<void>;
|
|
37
|
+
log?: Log;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
export interface DriverOptions {
|
|
41
|
+
/** Who approves, as chant names reviewers: `forgejo@forgejo:3000:<login>`. */
|
|
42
|
+
approver: string;
|
|
43
|
+
/** How often reports are polled, in ms. Default 2000. */
|
|
44
|
+
pollMs?: number;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export interface StepResult {
|
|
48
|
+
id: string;
|
|
49
|
+
do: ScenarioStepKind;
|
|
50
|
+
pull?: number;
|
|
51
|
+
commit?: string;
|
|
52
|
+
/** Why the run stopped at this step. */
|
|
53
|
+
stopped?: { outcome: "broke" | "stalled"; reason: string };
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export interface ArmRun {
|
|
57
|
+
scenario: string;
|
|
58
|
+
arm: Arm;
|
|
59
|
+
outcome: "held" | "broke" | "stalled";
|
|
60
|
+
reason?: string;
|
|
61
|
+
started: string;
|
|
62
|
+
ended: string;
|
|
63
|
+
steps: StepResult[];
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/** A step past its limit or one that errored: the run stalls. */
|
|
67
|
+
class Stall extends Error {}
|
|
68
|
+
/** An outcome that did not hold: the run broke. */
|
|
69
|
+
class Broke extends Error {}
|
|
70
|
+
|
|
71
|
+
interface Opened {
|
|
72
|
+
pull: number;
|
|
73
|
+
head: string;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
const iso = (ms: number) => new Date(ms).toISOString();
|
|
77
|
+
|
|
78
|
+
/** The check of one outcome, or null when it holds. */
|
|
79
|
+
async function checkOutcome(
|
|
80
|
+
o: ScenarioOutcome,
|
|
81
|
+
ctx: { report?: PrReportView; pull?: number; exit?: number; since: string; env: string },
|
|
82
|
+
p: DriverPorts,
|
|
83
|
+
): Promise<string | null> {
|
|
84
|
+
if ("report" in o) {
|
|
85
|
+
const r = ctx.report;
|
|
86
|
+
if (!r) return "no report to read";
|
|
87
|
+
if (o.report.status !== undefined && r.status !== o.report.status) return `the ${r.stage} report ended ${r.status}, not ${o.report.status}`;
|
|
88
|
+
if (o.report.components) {
|
|
89
|
+
const s = componentStatuses(r);
|
|
90
|
+
for (const [name, want] of Object.entries(o.report.components)) {
|
|
91
|
+
if (s.get(name) !== want) return `${name} is ${s.get(name) ?? "missing"} in the ${r.stage} report, not ${want}`;
|
|
92
|
+
}
|
|
93
|
+
if (o.report.only) {
|
|
94
|
+
const extra = [...s.keys()].filter((k) => !(k in o.report.components!));
|
|
95
|
+
if (extra.length > 0) return `the ${r.stage} report reaches ${extra.join(", ")} beyond the ones named`;
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
return null;
|
|
99
|
+
}
|
|
100
|
+
if ("ledger" in o) {
|
|
101
|
+
if (!p.ledger) throw new Stall("a ledger outcome needs the ledger port");
|
|
102
|
+
const runs = (await p.ledger.runs(ctx.env, o.ledger.op)).filter((r: OpRunRecord) => r.started >= ctx.since);
|
|
103
|
+
const matching = o.ledger.status ? runs.filter((r) => r.status === o.ledger.status) : runs;
|
|
104
|
+
if (o.ledger.count !== undefined) {
|
|
105
|
+
return matching.length === o.ledger.count ? null : `${matching.length} ${o.ledger.op} runs${o.ledger.status ? ` ${o.ledger.status}` : ""} on the ledger, not ${o.ledger.count}`;
|
|
106
|
+
}
|
|
107
|
+
return matching.length > 0 ? null : `no ${o.ledger.op} run${o.ledger.status ? ` ${o.ledger.status}` : ""} on the ledger since the run started`;
|
|
108
|
+
}
|
|
109
|
+
if ("comment" in o) {
|
|
110
|
+
if (!p.forge.comments) throw new Stall("a comment outcome needs the forge's comments");
|
|
111
|
+
if (ctx.pull === undefined) return "no pull request to read comments of";
|
|
112
|
+
const bodies = await p.forge.comments(ctx.pull);
|
|
113
|
+
return bodies.some((b) => b.includes(o.comment)) ? null : `no comment on pull request ${ctx.pull} holds "${o.comment}"`;
|
|
114
|
+
}
|
|
115
|
+
if ("issue" in o) {
|
|
116
|
+
if (!p.forge.issues) throw new Stall("an issue outcome needs the forge's issues");
|
|
117
|
+
const found = (await p.forge.issues()).filter((i) => i.title.includes(o.issue.title));
|
|
118
|
+
const want = o.issue.open === undefined ? found : found.filter((i) => i.open === o.issue.open);
|
|
119
|
+
return want.length > 0 ? null : `no ${o.issue.open === false ? "closed " : o.issue.open ? "open " : ""}issue titled "${o.issue.title}"`;
|
|
120
|
+
}
|
|
121
|
+
return ctx.exit === o.exit ? null : `the command exited ${ctx.exit ?? "nothing"}, not ${o.exit}`;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/** Run one arm of a scenario. */
|
|
125
|
+
export async function runArm(s: Scenario, arm: Arm, p: DriverPorts, opts: DriverOptions): Promise<ArmRun> {
|
|
126
|
+
const limits = limitsFor(s.limits);
|
|
127
|
+
const env = s.env ?? "local";
|
|
128
|
+
const { prefix } = splitReportUrl(s.reportUrl);
|
|
129
|
+
const log = p.log ?? (() => {});
|
|
130
|
+
const startedMs = p.clock.now();
|
|
131
|
+
const since = iso(startedMs);
|
|
132
|
+
const opened = new Map<string, Opened>();
|
|
133
|
+
const merged = new Map<string, { pull: number; commit: string }>();
|
|
134
|
+
const plans = new Map<string, PrReportView>();
|
|
135
|
+
const results: StepResult[] = [];
|
|
136
|
+
const done = (outcome: ArmRun["outcome"], reason?: string): ArmRun => ({
|
|
137
|
+
scenario: s.id,
|
|
138
|
+
arm,
|
|
139
|
+
outcome,
|
|
140
|
+
...(reason ? { reason } : {}),
|
|
141
|
+
started: since,
|
|
142
|
+
ended: iso(p.clock.now()),
|
|
143
|
+
steps: results,
|
|
144
|
+
});
|
|
145
|
+
|
|
146
|
+
const files = (overlay: string): Record<string, string> => ({
|
|
147
|
+
...p.overlay(overlay),
|
|
148
|
+
...(arm === "break" && s.break.overlay ? p.overlay(s.break.overlay) : {}),
|
|
149
|
+
});
|
|
150
|
+
const branchOf = (b: string) => (arm === "break" ? `${b}-break` : b);
|
|
151
|
+
const deadlineOf = (kind: ScenarioStepKind) => p.clock.now() + limits[kind] * 1000;
|
|
152
|
+
const report = async (stage: ReportStage, pr: number, commit: string, kind: ScenarioStepKind): Promise<PrReportView> => {
|
|
153
|
+
const key = reportObjectKey(prefix, pr, commit, stage);
|
|
154
|
+
const r = await waitForReport(p.bucket, key, p.clock, deadlineOf(kind), opts.pollMs ?? 2000);
|
|
155
|
+
if (!r) throw new Stall(`no pr-${stage}.json at ${reportKey(pr, commit)} within ${limits[kind]}s`);
|
|
156
|
+
return r;
|
|
157
|
+
};
|
|
158
|
+
// Forge and chant calls carry their own timeouts; a call that came back
|
|
159
|
+
// after its step's limit stalls the run all the same.
|
|
160
|
+
const within = async <T>(kind: ScenarioStepKind, work: Promise<T>): Promise<T> => {
|
|
161
|
+
const deadline = deadlineOf(kind);
|
|
162
|
+
const out = await work;
|
|
163
|
+
if (p.clock.now() > deadline) throw new Stall(`${kind} did not finish within ${limits[kind]}s`);
|
|
164
|
+
return out;
|
|
165
|
+
};
|
|
166
|
+
const open = async (step: Extract<ScenarioStep, { do: "open" | "open-concurrent" }>): Promise<StepResult> => {
|
|
167
|
+
const head = await within(step.do, p.forge.pushBranch(branchOf(step.branch), files(step.overlay), step.title));
|
|
168
|
+
const pull = await within(step.do, p.forge.openPull(branchOf(step.branch), step.title, step.body ?? step.title));
|
|
169
|
+
opened.set(step.id, { pull, head });
|
|
170
|
+
log(`${s.id} ${arm}: ${step.id} opened pull request ${pull} at ${head.slice(0, 8)}`);
|
|
171
|
+
return { id: step.id, do: step.do, pull, commit: head };
|
|
172
|
+
};
|
|
173
|
+
const pullOf = (id: string): Opened => {
|
|
174
|
+
const o = opened.get(id);
|
|
175
|
+
if (!o) throw new Stall(`no pull request from ${id}`);
|
|
176
|
+
return o;
|
|
177
|
+
};
|
|
178
|
+
|
|
179
|
+
try {
|
|
180
|
+
await p.reset?.();
|
|
181
|
+
await p.arm?.(arm, arm === "break" ? { ...s.break.env } : {});
|
|
182
|
+
for (let i = 0; i < s.steps.length; i++) {
|
|
183
|
+
const step = s.steps[i]!;
|
|
184
|
+
let result: StepResult;
|
|
185
|
+
const ctx: { report?: PrReportView; pull?: number; exit?: number; since: string; env: string } = { since, env };
|
|
186
|
+
switch (step.do) {
|
|
187
|
+
case "open":
|
|
188
|
+
case "open-concurrent": {
|
|
189
|
+
// An open and the open-concurrent steps after it go out together.
|
|
190
|
+
const group = [step];
|
|
191
|
+
while (s.steps[i + 1]?.do === "open-concurrent") group.push(s.steps[++i] as typeof step);
|
|
192
|
+
const all = await Promise.all(group.map((g) => open(g as Extract<ScenarioStep, { do: "open" | "open-concurrent" }>)));
|
|
193
|
+
for (let g = 0; g < group.length; g++) {
|
|
194
|
+
const gs = group[g]!;
|
|
195
|
+
const r = all[g]!;
|
|
196
|
+
for (const o of gs.expect ?? []) {
|
|
197
|
+
const why = await checkOutcome(o, { ...ctx, pull: r.pull }, p);
|
|
198
|
+
if (why) {
|
|
199
|
+
results.push({ ...r, stopped: { outcome: "broke", reason: why } });
|
|
200
|
+
throw new Broke(`${gs.id}: ${why}`);
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
results.push(r);
|
|
204
|
+
}
|
|
205
|
+
continue;
|
|
206
|
+
}
|
|
207
|
+
case "plan": {
|
|
208
|
+
const o = pullOf(step.pull);
|
|
209
|
+
const r = await report("plan", o.pull, o.head, "plan");
|
|
210
|
+
plans.set(step.pull, r);
|
|
211
|
+
ctx.report = r;
|
|
212
|
+
ctx.pull = o.pull;
|
|
213
|
+
result = { id: step.id, do: step.do, pull: o.pull, commit: o.head };
|
|
214
|
+
break;
|
|
215
|
+
}
|
|
216
|
+
case "approve": {
|
|
217
|
+
const o = pullOf(step.pull);
|
|
218
|
+
const plan = plans.get(step.pull) ?? (await report("plan", o.pull, o.head, "approve"));
|
|
219
|
+
await within("approve", p.forge.approvePull(o.pull, `Approved by the e2e harness (${s.id}, ${arm}).`));
|
|
220
|
+
await within("approve", p.chant.approve({ pull: o.pull, op: plan.op, gate: plan.gate, digest: plan.digest, approver: opts.approver }));
|
|
221
|
+
ctx.pull = o.pull;
|
|
222
|
+
result = { id: step.id, do: step.do, pull: o.pull };
|
|
223
|
+
break;
|
|
224
|
+
}
|
|
225
|
+
case "merge": {
|
|
226
|
+
const o = pullOf(step.pull);
|
|
227
|
+
const commit = await within("merge", p.forge.mergePull(o.pull));
|
|
228
|
+
merged.set(step.id, { pull: o.pull, commit });
|
|
229
|
+
ctx.pull = o.pull;
|
|
230
|
+
result = { id: step.id, do: step.do, pull: o.pull, commit };
|
|
231
|
+
break;
|
|
232
|
+
}
|
|
233
|
+
case "apply": {
|
|
234
|
+
const m = merged.get(step.merge);
|
|
235
|
+
if (!m) throw new Stall(`no merge from ${step.merge}`);
|
|
236
|
+
ctx.report = await report("apply", m.pull, m.commit, "apply");
|
|
237
|
+
ctx.pull = m.pull;
|
|
238
|
+
result = { id: step.id, do: step.do, pull: m.pull, commit: m.commit };
|
|
239
|
+
break;
|
|
240
|
+
}
|
|
241
|
+
case "out-of-band": {
|
|
242
|
+
if (!p.outOfBand) throw new Stall("an out-of-band step needs the out-of-band port");
|
|
243
|
+
ctx.exit = await within("out-of-band", p.outOfBand.run(step.command));
|
|
244
|
+
result = { id: step.id, do: step.do };
|
|
245
|
+
break;
|
|
246
|
+
}
|
|
247
|
+
case "kill-job": {
|
|
248
|
+
if (!p.jobs) throw new Stall("a kill-job step needs the jobs port");
|
|
249
|
+
const killed = await within("kill-job", p.jobs.kill(step.match));
|
|
250
|
+
if (!killed) throw new Stall(`no running job${step.match ? ` matching ${step.match}` : ""} to kill`);
|
|
251
|
+
result = { id: step.id, do: step.do };
|
|
252
|
+
break;
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
for (const o of step.expect ?? []) {
|
|
256
|
+
const why = await checkOutcome(o, ctx, p);
|
|
257
|
+
if (why) {
|
|
258
|
+
results.push({ ...result, stopped: { outcome: "broke", reason: why } });
|
|
259
|
+
throw new Broke(`${step.id}: ${why}`);
|
|
260
|
+
}
|
|
261
|
+
}
|
|
262
|
+
results.push(result);
|
|
263
|
+
log(`${s.id} ${arm}: ${step.id} held`);
|
|
264
|
+
}
|
|
265
|
+
return done("held");
|
|
266
|
+
} catch (err) {
|
|
267
|
+
if (err instanceof Broke) return done("broke", err.message);
|
|
268
|
+
const reason = err instanceof Error ? err.message : String(err);
|
|
269
|
+
const at = s.steps[results.length]?.id;
|
|
270
|
+
if (at && !results.some((r) => r.stopped)) results.push({ id: at, do: s.steps[results.length]!.do, stopped: { outcome: "stalled", reason } });
|
|
271
|
+
return done("stalled", at ? `${at}: ${reason}` : reason);
|
|
272
|
+
}
|
|
273
|
+
}
|
|
274
|
+
|
|
275
|
+
/** The row's verdicts from the two runs. */
|
|
276
|
+
export function verdictsOf(plain: Pick<ArmRun, "outcome">, brk: Pick<ArmRun, "outcome">): { plain: PlainVerdict; break: BreakVerdict } {
|
|
277
|
+
return {
|
|
278
|
+
plain: plain.outcome === "held" ? "pass" : "fail",
|
|
279
|
+
break: brk.outcome === "broke" ? "caught" : brk.outcome === "held" ? "missed" : "stalled",
|
|
280
|
+
};
|
|
281
|
+
}
|
|
282
|
+
|
|
283
|
+
export interface ClaimRun {
|
|
284
|
+
plain: ArmRun;
|
|
285
|
+
break: ArmRun;
|
|
286
|
+
verdicts: { plain: PlainVerdict; break: BreakVerdict };
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
/** The plain run, then the BREAK run, and their verdicts. */
|
|
290
|
+
export async function runClaim(s: Scenario, p: DriverPorts, opts: DriverOptions): Promise<ClaimRun> {
|
|
291
|
+
const plain = await runArm(s, "plain", p, opts);
|
|
292
|
+
const brk = await runArm(s, "break", p, opts);
|
|
293
|
+
return { plain, break: brk, verdicts: verdictsOf(plain, brk) };
|
|
294
|
+
}
|
|
@@ -0,0 +1,267 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The forge, for real: the harness's Forgejo, through its REST API and git
|
|
3
|
+
* over http, as three people (chant#4587, from the fan-out demo's
|
|
4
|
+
* lib/forgejo.ts). The author pushes, opens and merges; the reviewer
|
|
5
|
+
* approves; the admin forces main back and deletes branches. Every call
|
|
6
|
+
* names one repository on the harness's own Forgejo, and nothing else.
|
|
7
|
+
*
|
|
8
|
+
* It also has sql-yodeler's verbs: a pull request's comments, the issues,
|
|
9
|
+
* and a workflow run started by hand (the apply again, the drift watch).
|
|
10
|
+
*/
|
|
11
|
+
import { mkdirSync, rmSync, writeFileSync } from "node:fs";
|
|
12
|
+
import { dirname, join } from "node:path";
|
|
13
|
+
import { guardedGit, remoteWith, type GuardedGit } from "./git";
|
|
14
|
+
import type { Clock, ForgeIssue, ForgeRun, HarnessForge } from "./ports";
|
|
15
|
+
import { forgejoRunnerConfig, type RunnerConfigOptions } from "./stack";
|
|
16
|
+
|
|
17
|
+
export interface Person {
|
|
18
|
+
login: string;
|
|
19
|
+
token: string;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export interface ForgejoOptions {
|
|
23
|
+
/** Forgejo as the driver reaches it, http://localhost:<port>. */
|
|
24
|
+
url: string;
|
|
25
|
+
/** `<org>/<repo>`. */
|
|
26
|
+
repo: string;
|
|
27
|
+
admin: Person;
|
|
28
|
+
author: Person;
|
|
29
|
+
reviewer: Person;
|
|
30
|
+
/** A git repository holding the base commit, which forceMain pushes from. */
|
|
31
|
+
baseTree: string;
|
|
32
|
+
clock: Clock;
|
|
33
|
+
/** The checkout git work must stay outside of. */
|
|
34
|
+
checkout?: string;
|
|
35
|
+
/** How long a workflow run may take, in seconds. Default 900. */
|
|
36
|
+
runLimit?: number;
|
|
37
|
+
/** The domain of the people's commit emails. Default chant-e2e.local. */
|
|
38
|
+
emailDomain?: string;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
const TIMEOUT_MS = 30_000;
|
|
42
|
+
|
|
43
|
+
/** One Forgejo API call. A 404 is null when `missingOk`; any other non-2xx throws. */
|
|
44
|
+
export async function forgejoApi<T = unknown>(
|
|
45
|
+
url: string,
|
|
46
|
+
token: string,
|
|
47
|
+
method: string,
|
|
48
|
+
path: string,
|
|
49
|
+
body?: unknown,
|
|
50
|
+
opts: { missingOk?: boolean; basic?: { login: string; password: string } } = {},
|
|
51
|
+
): Promise<T | null> {
|
|
52
|
+
const headers: Record<string, string> = { accept: "application/json" };
|
|
53
|
+
if (opts.basic) headers.authorization = `Basic ${Buffer.from(`${opts.basic.login}:${opts.basic.password}`).toString("base64")}`;
|
|
54
|
+
else if (token) headers.authorization = `token ${token}`;
|
|
55
|
+
if (body !== undefined) headers["content-type"] = "application/json";
|
|
56
|
+
const res = await fetch(`${url.replace(/\/$/, "")}/api/v1${path}`, {
|
|
57
|
+
method,
|
|
58
|
+
headers,
|
|
59
|
+
body: body === undefined ? undefined : JSON.stringify(body),
|
|
60
|
+
signal: AbortSignal.timeout(TIMEOUT_MS),
|
|
61
|
+
});
|
|
62
|
+
if (res.status === 404 && opts.missingOk) return null;
|
|
63
|
+
const text = await res.text();
|
|
64
|
+
if (!res.ok) throw new Error(`Forgejo ${method} ${path} answered ${res.status}: ${text.slice(0, 200)}`);
|
|
65
|
+
return (text ? JSON.parse(text) : {}) as T;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/** A workflow run as Forgejo's actions API lists it, the fields read here. */
|
|
69
|
+
interface ActionRun {
|
|
70
|
+
id: number;
|
|
71
|
+
status: string;
|
|
72
|
+
commit_sha?: string;
|
|
73
|
+
workflow_id?: string;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
const DONE = new Set(["success", "failure", "cancelled", "skipped"]);
|
|
77
|
+
|
|
78
|
+
export class ForgejoForge implements HarnessForge {
|
|
79
|
+
private readonly g: GuardedGit;
|
|
80
|
+
|
|
81
|
+
constructor(private readonly o: ForgejoOptions) {
|
|
82
|
+
this.g = guardedGit(o.checkout);
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
private api<T>(who: Person, method: string, path: string, body?: unknown, missingOk = false): Promise<T | null> {
|
|
86
|
+
return forgejoApi<T>(this.o.url, who.token, method, path, body, { missingOk });
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
private remote(who: Person): string {
|
|
90
|
+
return remoteWith(this.o.url, who.login, who.token, this.o.repo);
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
private get r(): string {
|
|
94
|
+
return `/repos/${this.o.repo}`;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
async pushBranch(branch: string, files: Record<string, string>, message: string): Promise<string> {
|
|
98
|
+
const a = this.o.author;
|
|
99
|
+
const dir = await this.g.clone(this.remote(a), "author", [a.token]);
|
|
100
|
+
try {
|
|
101
|
+
await this.g.git(dir, ["checkout", "-q", "-b", branch]);
|
|
102
|
+
for (const [path, content] of Object.entries(files)) {
|
|
103
|
+
const to = join(dir, ...path.split("/"));
|
|
104
|
+
mkdirSync(dirname(to), { recursive: true });
|
|
105
|
+
writeFileSync(to, content);
|
|
106
|
+
}
|
|
107
|
+
await this.g.git(dir, ["add", "-A"]);
|
|
108
|
+
await this.g.git(dir, ["-c", `user.name=${a.login}`, "-c", `user.email=${a.login}@${this.o.emailDomain ?? "chant-e2e.local"}`, "-c", "commit.gpgsign=false", "commit", "-q", "-m", message]);
|
|
109
|
+
await this.g.git(dir, ["push", "-q", "--force", "origin", `HEAD:refs/heads/${branch}`], [a.token]);
|
|
110
|
+
return await this.g.git(dir, ["rev-parse", "HEAD"]);
|
|
111
|
+
} finally {
|
|
112
|
+
rmSync(dir, { recursive: true, force: true });
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
async openPull(branch: string, title: string, body: string): Promise<number> {
|
|
117
|
+
const pull = await this.api<{ number?: number }>(this.o.author, "POST", `${this.r}/pulls`, { head: branch, base: "main", title, body });
|
|
118
|
+
if (!pull?.number) throw new Error(`no pull request opened from ${branch}`);
|
|
119
|
+
return pull.number;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
async approvePull(pull: number, body: string): Promise<void> {
|
|
123
|
+
await this.api(this.o.reviewer, "POST", `${this.r}/pulls/${pull}/reviews`, { event: "APPROVED", body });
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
async mergePull(pull: number): Promise<string> {
|
|
127
|
+
// Forgejo checks a pull request's mergeability after it opens, so the
|
|
128
|
+
// first try can be refused; it is tried again a few times.
|
|
129
|
+
let lastErr: unknown;
|
|
130
|
+
let merged = false;
|
|
131
|
+
for (let i = 0; i < 10 && !merged; i++) {
|
|
132
|
+
try {
|
|
133
|
+
await this.api(this.o.author, "POST", `${this.r}/pulls/${pull}/merge`, { Do: "merge" });
|
|
134
|
+
merged = true;
|
|
135
|
+
} catch (err) {
|
|
136
|
+
lastErr = err;
|
|
137
|
+
await this.o.clock.sleep(2000);
|
|
138
|
+
}
|
|
139
|
+
}
|
|
140
|
+
if (!merged) throw new Error(`pull request ${pull} did not merge: ${lastErr instanceof Error ? lastErr.message : String(lastErr)}`);
|
|
141
|
+
for (let i = 0; i < 30; i++) {
|
|
142
|
+
const pr = await this.api<{ merge_commit_sha?: string }>(this.o.author, "GET", `${this.r}/pulls/${pull}`);
|
|
143
|
+
if (pr?.merge_commit_sha) return pr.merge_commit_sha;
|
|
144
|
+
await this.o.clock.sleep(1000);
|
|
145
|
+
}
|
|
146
|
+
throw new Error(`pull request ${pull} merged, but Forgejo names no merge commit`);
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
async openPulls(): Promise<number[]> {
|
|
150
|
+
const pulls = await this.api<Array<{ number: number }>>(this.o.admin, "GET", `${this.r}/pulls?state=open&limit=50`);
|
|
151
|
+
return (pulls ?? []).map((p) => p.number);
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
async closePull(pull: number): Promise<void> {
|
|
155
|
+
await this.api(this.o.admin, "PATCH", `${this.r}/pulls/${pull}`, { state: "closed" });
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
async forceMain(sha: string): Promise<void> {
|
|
159
|
+
const a = this.o.admin;
|
|
160
|
+
await this.g.git(this.o.baseTree, ["push", "-q", "--force", this.remote(a), `${sha}:refs/heads/main`], [a.token]);
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
async branches(): Promise<string[]> {
|
|
164
|
+
const out: string[] = [];
|
|
165
|
+
for (let page = 1; page < 50; page++) {
|
|
166
|
+
const list = await this.api<Array<{ name: string }>>(this.o.admin, "GET", `${this.r}/branches?page=${page}&limit=50`);
|
|
167
|
+
if (!list || list.length === 0) break;
|
|
168
|
+
out.push(...list.map((b) => b.name));
|
|
169
|
+
if (list.length < 50) break;
|
|
170
|
+
}
|
|
171
|
+
return out;
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
async deleteBranch(name: string): Promise<void> {
|
|
175
|
+
await this.api(this.o.admin, "DELETE", `${this.r}/branches/${encodeURIComponent(name)}`, undefined, true);
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
async comments(pull: number): Promise<string[]> {
|
|
179
|
+
const out: string[] = [];
|
|
180
|
+
for (let page = 1; page < 50; page++) {
|
|
181
|
+
const list = await this.api<Array<{ body: string }>>(this.o.admin, "GET", `${this.r}/issues/${pull}/comments?page=${page}&limit=50`);
|
|
182
|
+
if (!list || list.length === 0) break;
|
|
183
|
+
out.push(...list.map((c) => c.body));
|
|
184
|
+
if (list.length < 50) break;
|
|
185
|
+
}
|
|
186
|
+
return out;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
async issues(): Promise<ForgeIssue[]> {
|
|
190
|
+
const out: ForgeIssue[] = [];
|
|
191
|
+
for (let page = 1; page < 50; page++) {
|
|
192
|
+
const list = await this.api<Array<{ number: number; title: string; body?: string; state: string }>>(
|
|
193
|
+
this.o.admin,
|
|
194
|
+
"GET",
|
|
195
|
+
`${this.r}/issues?state=all&type=issues&page=${page}&limit=50`,
|
|
196
|
+
);
|
|
197
|
+
if (!list || list.length === 0) break;
|
|
198
|
+
out.push(...list.map((i) => ({ number: i.number, title: i.title, body: i.body ?? "", open: i.state === "open" })));
|
|
199
|
+
if (list.length < 50) break;
|
|
200
|
+
}
|
|
201
|
+
return out;
|
|
202
|
+
}
|
|
203
|
+
|
|
204
|
+
applyAgain(sha: string, workflow: string): Promise<ForgeRun> {
|
|
205
|
+
return this.dispatch(sha, workflow);
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
watch(sha: string, workflow: string): Promise<ForgeRun> {
|
|
209
|
+
return this.dispatch(sha, workflow);
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
/** Start `workflow` on main by hand and wait for the run it started at `sha`. */
|
|
213
|
+
private async dispatch(sha: string, workflow: string): Promise<ForgeRun> {
|
|
214
|
+
const before = new Set((await this.runs()).map((r) => r.id));
|
|
215
|
+
await this.api(this.o.admin, "POST", `${this.r}/actions/workflows/${encodeURIComponent(workflow)}/dispatches`, { ref: "main" });
|
|
216
|
+
const deadline = this.o.clock.now() + (this.o.runLimit ?? 900) * 1000;
|
|
217
|
+
let id: number | undefined;
|
|
218
|
+
while (this.o.clock.now() < deadline) {
|
|
219
|
+
const runs = await this.runs();
|
|
220
|
+
const run = id === undefined ? runs.find((r) => !before.has(r.id) && (!r.commit_sha || r.commit_sha === sha)) : runs.find((r) => r.id === id);
|
|
221
|
+
if (run) {
|
|
222
|
+
id = run.id;
|
|
223
|
+
if (DONE.has(run.status)) return { ok: run.status === "success", status: run.status, id: run.id };
|
|
224
|
+
}
|
|
225
|
+
await this.o.clock.sleep(2000);
|
|
226
|
+
}
|
|
227
|
+
throw new Error(`${workflow} on ${sha.slice(0, 8)} did not finish within ${this.o.runLimit ?? 900}s`);
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
private async runs(): Promise<ActionRun[]> {
|
|
231
|
+
const page = await this.api<{ workflow_runs?: ActionRun[] }>(this.o.admin, "GET", `${this.r}/actions/runs?limit=50`);
|
|
232
|
+
return page?.workflow_runs ?? [];
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
export interface RegisterRunnerOptions extends Omit<RunnerConfigOptions, "uuid" | "token"> {
|
|
237
|
+
/** Forgejo as the driver reaches it. */
|
|
238
|
+
url: string;
|
|
239
|
+
adminToken: string;
|
|
240
|
+
/** The runner's name on the forge. */
|
|
241
|
+
name: string;
|
|
242
|
+
/** Write the config into the runner's /data/config.yml (`docker compose exec -T forgejoRunner sh -c 'cat > ...'`). */
|
|
243
|
+
writeConfig(text: string): Promise<void>;
|
|
244
|
+
/** Restart the runner so a running one reads the new credentials. */
|
|
245
|
+
restart(): Promise<void>;
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/**
|
|
249
|
+
* Register forgejo-runner the Forgejo 16 / runner 13 way (terragucci
|
|
250
|
+
* stack/bootstrap.sh): create the runner on the server, which answers with a
|
|
251
|
+
* uuid and a token, drop earlier registrations of the same name that are
|
|
252
|
+
* offline, write the config naming that pair, and restart the runner.
|
|
253
|
+
*/
|
|
254
|
+
export async function registerForgejoRunner(o: RegisterRunnerOptions): Promise<{ uuid: string }> {
|
|
255
|
+
const listed = await forgejoApi<Array<{ id: number; name: string; status: string }>>(o.url, o.adminToken, "GET", "/admin/actions/runners");
|
|
256
|
+
for (const stale of (listed ?? []).filter((r) => r.name === o.name && r.status === "offline")) {
|
|
257
|
+
await forgejoApi(o.url, o.adminToken, "DELETE", `/admin/actions/runners/${stale.id}`, undefined, { missingOk: true });
|
|
258
|
+
}
|
|
259
|
+
const reg = await forgejoApi<{ uuid?: string; token?: string }>(o.url, o.adminToken, "POST", "/admin/actions/runners", {
|
|
260
|
+
name: o.name,
|
|
261
|
+
description: "chant e2e harness, docker executor",
|
|
262
|
+
});
|
|
263
|
+
if (!reg?.uuid || !reg.token) throw new Error("Forgejo created no runner (no uuid or token in its answer)");
|
|
264
|
+
await o.writeConfig(forgejoRunnerConfig({ ...o, uuid: reg.uuid, token: reg.token }));
|
|
265
|
+
await o.restart();
|
|
266
|
+
return { uuid: reg.uuid };
|
|
267
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* git for the harness's driver, from the fan-out demo's lib/git.ts, with one
|
|
3
|
+
* guard: every git command runs in a directory whose own `.git` is the
|
|
4
|
+
* repository, outside the checkout the driver runs from. A clone that failed
|
|
5
|
+
* would otherwise leave git to find that checkout's repository above it, and
|
|
6
|
+
* the driver would push or approve there.
|
|
7
|
+
*/
|
|
8
|
+
import { execFile } from "node:child_process";
|
|
9
|
+
import { existsSync, mkdtempSync, realpathSync } from "node:fs";
|
|
10
|
+
import { tmpdir } from "node:os";
|
|
11
|
+
import { join, relative } from "node:path";
|
|
12
|
+
|
|
13
|
+
/** Whether `dir` is `checkout` or below it. */
|
|
14
|
+
export function insideCheckout(dir: string, checkout: string): boolean {
|
|
15
|
+
const rel = relative(realpathSync(checkout), realpathSync(dir));
|
|
16
|
+
return rel === "" || (!rel.startsWith("..") && !rel.startsWith("/"));
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/** Refuse a directory that is in `checkout` (when given) or has no `.git` of its own. */
|
|
20
|
+
export function assertOwnRepo(dir: string, checkout?: string): void {
|
|
21
|
+
if (checkout && insideCheckout(dir, checkout)) throw new Error(`${dir} is inside ${checkout}; the driver's git work stays outside it`);
|
|
22
|
+
if (!existsSync(join(dir, ".git"))) throw new Error(`${dir} has no .git of its own`);
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** A new empty directory under the system temp dir. */
|
|
26
|
+
export function freshDir(name: string, prefix = "chant-e2e"): string {
|
|
27
|
+
return mkdtempSync(join(tmpdir(), `${prefix}-${name}-`));
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
export interface RunResult {
|
|
31
|
+
stdout: string;
|
|
32
|
+
stderr: string;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export interface RunOptions {
|
|
36
|
+
cwd?: string;
|
|
37
|
+
env?: NodeJS.ProcessEnv;
|
|
38
|
+
input?: string;
|
|
39
|
+
timeoutMs?: number;
|
|
40
|
+
/** Secrets blanked in an error. */
|
|
41
|
+
redact?: string[];
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** Run a program, rejecting with its last stderr lines. */
|
|
45
|
+
export function run(file: string, args: string[], opts: RunOptions = {}): Promise<RunResult> {
|
|
46
|
+
return new Promise((resolveRun, reject) => {
|
|
47
|
+
const child = execFile(
|
|
48
|
+
file,
|
|
49
|
+
args,
|
|
50
|
+
{ cwd: opts.cwd, env: opts.env ?? process.env, timeout: opts.timeoutMs ?? 300_000, maxBuffer: 64 * 1024 * 1024 },
|
|
51
|
+
(err, stdout, stderr) => {
|
|
52
|
+
if (!err) return resolveRun({ stdout: String(stdout), stderr: String(stderr) });
|
|
53
|
+
let text = `${file} ${args[0] ?? ""} failed: ${String(stderr).trim().split("\n").slice(-3).join(" / ") || err.message}`;
|
|
54
|
+
for (const secret of opts.redact ?? []) if (secret) text = text.split(secret).join("***");
|
|
55
|
+
reject(new Error(text));
|
|
56
|
+
},
|
|
57
|
+
);
|
|
58
|
+
if (opts.input !== undefined) child.stdin?.end(opts.input);
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
const gitEnv = (): NodeJS.ProcessEnv => ({ ...process.env, GIT_TERMINAL_PROMPT: "0" });
|
|
63
|
+
|
|
64
|
+
/** git bound to a checkout the driver must stay out of. */
|
|
65
|
+
export interface GuardedGit {
|
|
66
|
+
/** git in `dir`, which must be its own repository outside the checkout. */
|
|
67
|
+
git(dir: string, args: string[], redact?: string[]): Promise<string>;
|
|
68
|
+
/** Clone `remote` into a fresh directory outside the checkout. */
|
|
69
|
+
clone(remote: string, name: string, redact?: string[]): Promise<string>;
|
|
70
|
+
assertOwnRepo(dir: string): void;
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
export function guardedGit(checkout?: string, prefix = "chant-e2e"): GuardedGit {
|
|
74
|
+
const own = (dir: string) => assertOwnRepo(dir, checkout);
|
|
75
|
+
return {
|
|
76
|
+
assertOwnRepo: own,
|
|
77
|
+
async git(dir, args, redact = []) {
|
|
78
|
+
own(dir);
|
|
79
|
+
return (await run("git", ["-C", dir, ...args], { env: gitEnv(), redact })).stdout.trim();
|
|
80
|
+
},
|
|
81
|
+
async clone(remote, name, redact = []) {
|
|
82
|
+
const dir = freshDir(name, prefix);
|
|
83
|
+
await run("git", ["clone", "-q", remote, dir], { env: gitEnv(), redact });
|
|
84
|
+
own(dir);
|
|
85
|
+
return dir;
|
|
86
|
+
},
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/** An http remote with a login and token in it. */
|
|
91
|
+
export function remoteWith(url: string, login: string, token: string, repo: string): string {
|
|
92
|
+
const u = new URL(url);
|
|
93
|
+
u.username = login;
|
|
94
|
+
u.password = token;
|
|
95
|
+
return `${u.toString().replace(/\/$/, "")}/${repo}.git`;
|
|
96
|
+
}
|