@intentius/chant 0.124.87 → 0.124.89
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/action-pins.d.ts +1 -0
- package/dist/action-pins.d.ts.map +1 -1
- package/dist/action-pins.js +2 -0
- package/dist/actor.d.ts +47 -0
- package/dist/actor.d.ts.map +1 -0
- package/dist/actor.js +56 -0
- package/dist/bundle-check.d.ts +20 -5
- package/dist/bundle-check.d.ts.map +1 -1
- package/dist/bundle-check.js +20 -5
- package/dist/chant-install.d.ts +98 -0
- package/dist/chant-install.d.ts.map +1 -1
- package/dist/chant-install.js +203 -2
- package/dist/ci-base.d.ts +30 -0
- package/dist/ci-base.d.ts.map +1 -0
- package/dist/ci-base.js +33 -0
- package/dist/ci-comment-commands.d.ts +177 -0
- package/dist/ci-comment-commands.d.ts.map +1 -0
- package/dist/ci-comment-commands.js +325 -0
- package/dist/ci-comment-replies.d.ts +40 -0
- package/dist/ci-comment-replies.d.ts.map +1 -0
- package/dist/ci-comment-replies.js +59 -0
- package/dist/ci-commit.d.ts +1 -1
- package/dist/ci-commit.d.ts.map +1 -1
- package/dist/ci-commit.js +1 -2
- package/dist/ci-control.d.ts +1 -1
- package/dist/ci-control.d.ts.map +1 -1
- package/dist/ci-control.js +1 -1
- package/dist/ci-evidence-claims.d.ts +59 -0
- package/dist/ci-evidence-claims.d.ts.map +1 -0
- package/dist/ci-evidence-claims.js +87 -0
- package/dist/ci-evidence-from-job.d.ts +128 -0
- package/dist/ci-evidence-from-job.d.ts.map +1 -0
- package/dist/ci-evidence-from-job.js +203 -0
- package/dist/ci-evidence-jobs.d.ts +68 -4
- package/dist/ci-evidence-jobs.d.ts.map +1 -1
- package/dist/ci-evidence-jobs.js +82 -5
- package/dist/ci-handover.d.ts +12 -0
- package/dist/ci-handover.d.ts.map +1 -1
- package/dist/ci-handover.js +15 -3
- package/dist/ci-identity.d.ts +32 -6
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +40 -8
- package/dist/ci-image.d.ts +65 -10
- package/dist/ci-image.d.ts.map +1 -1
- package/dist/ci-image.js +101 -22
- package/dist/ci-jobs.d.ts +1 -1
- package/dist/ci-jobs.d.ts.map +1 -1
- package/dist/ci-jobs.js +7 -2
- package/dist/ci-login.d.ts +75 -13
- package/dist/ci-login.d.ts.map +1 -1
- package/dist/ci-login.js +89 -37
- package/dist/ci-note-commands.d.ts +63 -3
- package/dist/ci-note-commands.d.ts.map +1 -1
- package/dist/ci-note-commands.js +69 -35
- package/dist/ci-product-words.d.ts +62 -1
- package/dist/ci-product-words.d.ts.map +1 -1
- package/dist/ci-product-words.js +52 -1
- package/dist/ci-product.d.ts +52 -2
- package/dist/ci-product.d.ts.map +1 -1
- package/dist/ci-product.js +51 -2
- package/dist/cli/commands/build.d.ts.map +1 -1
- package/dist/cli/commands/build.js +29 -2
- package/dist/cli/handlers/approve-confirm.d.ts +14 -0
- package/dist/cli/handlers/approve-confirm.d.ts.map +1 -1
- package/dist/cli/handlers/approve-confirm.js +46 -0
- package/dist/cli/handlers/approve.d.ts.map +1 -1
- package/dist/cli/handlers/approve.js +2 -1
- package/dist/cli/handlers/build.d.ts +1 -1
- package/dist/cli/handlers/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +22 -1
- package/dist/cli/handlers/ci-check.d.ts +1 -1
- package/dist/cli/handlers/ci-check.d.ts.map +1 -1
- package/dist/cli/handlers/ci-check.js +37 -7
- package/dist/cli/handlers/ci-evidence.d.ts.map +1 -1
- package/dist/cli/handlers/ci-evidence.js +255 -20
- package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -1
- package/dist/cli/handlers/ci-forge-check.js +34 -17
- package/dist/cli/handlers/components.d.ts.map +1 -1
- package/dist/cli/handlers/components.js +3 -1
- package/dist/cli/handlers/generated-check.d.ts +11 -0
- package/dist/cli/handlers/generated-check.d.ts.map +1 -0
- package/dist/cli/handlers/generated-check.js +71 -0
- package/dist/cli/handlers/lifecycle.d.ts.map +1 -1
- package/dist/cli/handlers/lifecycle.js +3 -0
- package/dist/cli/handlers/local-chant.d.ts +13 -0
- package/dist/cli/handlers/local-chant.d.ts.map +1 -1
- package/dist/cli/handlers/local-chant.js +42 -1
- package/dist/cli/handlers/lock.d.ts.map +1 -1
- package/dist/cli/handlers/lock.js +121 -4
- package/dist/cli/handlers/pr-comment.d.ts +21 -0
- package/dist/cli/handlers/pr-comment.d.ts.map +1 -0
- package/dist/cli/handlers/pr-comment.js +112 -0
- package/dist/cli/handlers/pr-env.d.ts.map +1 -1
- package/dist/cli/handlers/pr-env.js +6 -3
- package/dist/cli/handlers/pr.d.ts +23 -1
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +97 -14
- package/dist/cli/handlers/promote.d.ts.map +1 -1
- package/dist/cli/handlers/promote.js +2 -1
- package/dist/cli/handlers/release.d.ts.map +1 -1
- package/dist/cli/handlers/release.js +11 -2
- package/dist/cli/handlers/run-wave.d.ts.map +1 -1
- package/dist/cli/handlers/run-wave.js +36 -2
- package/dist/cli/handlers/run.d.ts.map +1 -1
- package/dist/cli/handlers/run.js +2 -1
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +60 -4
- package/dist/cli/parse-args.d.ts.map +1 -1
- package/dist/cli/parse-args.js +82 -0
- package/dist/cli/registry.d.ts +35 -0
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/components/auto-release.d.ts.map +1 -1
- package/dist/components/auto-release.js +2 -1
- package/dist/components/check-hooks.d.ts +10 -0
- package/dist/components/check-hooks.d.ts.map +1 -1
- package/dist/components/check-hooks.js +18 -0
- package/dist/components/pr-checks.d.ts +169 -0
- package/dist/components/pr-checks.d.ts.map +1 -0
- package/dist/components/pr-checks.js +180 -0
- package/dist/components/pr-pipeline.d.ts +38 -0
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +6 -1
- package/dist/components/product-pipeline.d.ts +58 -2
- package/dist/components/product-pipeline.d.ts.map +1 -1
- package/dist/components/product-pipeline.js +76 -9
- package/dist/components/product-plan.d.ts +445 -7
- package/dist/components/product-plan.d.ts.map +1 -1
- package/dist/components/product-plan.js +426 -15
- package/dist/config.d.ts +10 -6
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +11 -6
- package/dist/control/consumers.d.ts +6 -0
- package/dist/control/consumers.d.ts.map +1 -1
- package/dist/control/consumers.js +6 -0
- package/dist/dead-guards.d.ts.map +1 -1
- package/dist/dead-guards.js +9 -6
- package/dist/discovery/files.d.ts +1 -1
- package/dist/discovery/files.js +1 -1
- package/dist/drift-issue.d.ts +20 -3
- package/dist/drift-issue.d.ts.map +1 -1
- package/dist/drift-issue.js +16 -0
- package/dist/drift-record.d.ts +52 -5
- package/dist/drift-record.d.ts.map +1 -1
- package/dist/drift-record.js +46 -6
- package/dist/floor-table.d.ts +6 -6
- package/dist/floor-table.d.ts.map +1 -1
- package/dist/floor-table.data.d.ts.map +1 -1
- package/dist/floor-table.data.js +81 -21
- package/dist/floor-table.js +10 -7
- package/dist/forge-check/contract.d.ts +19 -1
- package/dist/forge-check/contract.d.ts.map +1 -1
- package/dist/forge-check/contract.js +8 -2
- package/dist/forge-check/index.d.ts +4 -0
- package/dist/forge-check/index.d.ts.map +1 -1
- package/dist/forge-check/index.js +4 -0
- package/dist/forge-flags.d.ts +10 -0
- package/dist/forge-flags.d.ts.map +1 -1
- package/dist/forge-flags.js +31 -0
- package/dist/forge-remote.d.ts +47 -0
- package/dist/forge-remote.d.ts.map +1 -0
- package/dist/forge-remote.js +69 -0
- package/dist/gate-resume-run.d.ts +9 -1
- package/dist/gate-resume-run.d.ts.map +1 -1
- package/dist/gate-resume-run.js +26 -3
- package/dist/generated-check.d.ts +88 -0
- package/dist/generated-check.d.ts.map +1 -0
- package/dist/generated-check.js +248 -0
- package/dist/image-pins.d.ts +26 -0
- package/dist/image-pins.d.ts.map +1 -0
- package/dist/image-pins.js +19 -0
- package/dist/lexicon.d.ts +27 -0
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/git.d.ts +11 -0
- package/dist/lifecycle/git.d.ts.map +1 -1
- package/dist/lifecycle/git.js +30 -3
- package/dist/lifecycle/publish-npm.d.ts +26 -0
- package/dist/lifecycle/publish-npm.d.ts.map +1 -1
- package/dist/lifecycle/publish-npm.js +76 -4
- package/dist/lifecycle/reach-locks.d.ts +131 -0
- package/dist/lifecycle/reach-locks.d.ts.map +1 -0
- package/dist/lifecycle/reach-locks.js +118 -0
- package/dist/lifecycle/release-cut.d.ts +3 -1
- package/dist/lifecycle/release-cut.d.ts.map +1 -1
- package/dist/lifecycle/release-cut.js +15 -0
- package/dist/lifecycle/release-images.d.ts +22 -1
- package/dist/lifecycle/release-images.d.ts.map +1 -1
- package/dist/lifecycle/release-images.js +26 -3
- package/dist/lifecycle/release-ledger.d.ts +4 -3
- package/dist/lifecycle/release-ledger.d.ts.map +1 -1
- package/dist/lifecycle/release-ledger.js +3 -2
- package/dist/local-chant.d.ts +57 -3
- package/dist/local-chant.d.ts.map +1 -1
- package/dist/local-chant.js +122 -13
- package/dist/notify-product.d.ts +12 -3
- package/dist/notify-product.d.ts.map +1 -1
- package/dist/notify-product.js +10 -6
- package/dist/op/activities/source-release.d.ts.map +1 -1
- package/dist/op/activities/source-release.js +2 -1
- package/dist/op/activities/source-rollback.d.ts.map +1 -1
- package/dist/op/activities/source-rollback.js +2 -1
- package/dist/op/index.d.ts +2 -0
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +1 -0
- package/dist/op/op-waves-evidence-jobs.d.ts +97 -0
- package/dist/op/op-waves-evidence-jobs.d.ts.map +1 -0
- package/dist/op/op-waves-evidence-jobs.js +118 -0
- package/dist/op/op-waves-evidence.d.ts +12 -1
- package/dist/op/op-waves-evidence.d.ts.map +1 -1
- package/dist/op/op-waves-evidence.js +23 -2
- package/dist/op/op-waves-render-spec.d.ts +100 -0
- package/dist/op/op-waves-render-spec.d.ts.map +1 -0
- package/dist/op/op-waves-render-spec.js +162 -0
- package/dist/op/op-waves-run.d.ts +14 -1
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +56 -4
- package/dist/op/op-waves.d.ts +12 -0
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +14 -1
- package/dist/op/schedule-overdue.d.ts +39 -2
- package/dist/op/schedule-overdue.d.ts.map +1 -1
- package/dist/op/schedule-overdue.js +148 -10
- package/dist/op/wave-stop.d.ts +64 -0
- package/dist/op/wave-stop.d.ts.map +1 -0
- package/dist/op/wave-stop.js +127 -0
- package/dist/planned-files.d.ts +76 -0
- package/dist/planned-files.d.ts.map +1 -0
- package/dist/planned-files.js +108 -0
- package/dist/pr-forge-job.d.ts +22 -0
- package/dist/pr-forge-job.d.ts.map +1 -0
- package/dist/pr-forge-job.js +46 -0
- package/dist/pr-forge-reads.d.ts +21 -1
- package/dist/pr-forge-reads.d.ts.map +1 -1
- package/dist/pr-forge-reads.js +19 -1
- package/dist/pr-forge.d.ts +7 -1
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +7 -2
- package/dist/pr-loop.d.ts +3 -6
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +4 -81
- package/dist/pr-plan-note.d.ts +121 -0
- package/dist/pr-plan-note.d.ts.map +1 -1
- package/dist/pr-plan-note.js +104 -1
- package/dist/pr-plan-record.d.ts +47 -0
- package/dist/pr-plan-record.d.ts.map +1 -0
- package/dist/pr-plan-record.js +89 -0
- package/dist/pr-post.d.ts +68 -3
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +218 -13
- package/dist/pr-requires.d.ts +8 -0
- package/dist/pr-requires.d.ts.map +1 -1
- package/dist/pr-requires.js +3 -1
- package/dist/pr-status.d.ts +16 -0
- package/dist/pr-status.d.ts.map +1 -0
- package/dist/pr-status.js +90 -0
- package/dist/ref-gate-init.d.ts +90 -0
- package/dist/ref-gate-init.d.ts.map +1 -0
- package/dist/ref-gate-init.js +155 -0
- package/dist/ref-gate-rules.d.ts +19 -0
- package/dist/ref-gate-rules.d.ts.map +1 -0
- package/dist/ref-gate-rules.js +17 -0
- package/dist/release-floors.d.ts +100 -16
- package/dist/release-floors.d.ts.map +1 -1
- package/dist/release-floors.js +101 -17
- package/dist/render-module.d.ts +15 -0
- package/dist/render-module.d.ts.map +1 -0
- package/dist/render-module.js +73 -0
- package/dist/state-migration.d.ts +24 -1
- package/dist/state-migration.d.ts.map +1 -1
- package/dist/state-migration.js +39 -4
- package/dist/state-unlock.d.ts +32 -1
- package/dist/state-unlock.d.ts.map +1 -1
- package/dist/state-unlock.js +31 -0
- package/dist/wave-runtime.mjs +307 -297
- package/dist/workspace/ci-green-cli.d.ts.map +1 -1
- package/dist/workspace/ci-green-cli.js +15 -8
- package/dist/workspace/drift-cli.d.ts +1 -1
- package/dist/workspace/drift-cli.d.ts.map +1 -1
- package/dist/workspace/drift-cli.js +5 -12
- package/dist/workspace/forge-work.d.ts +3 -2
- package/dist/workspace/forge-work.d.ts.map +1 -1
- package/dist/workspace/forge-work.js +7 -17
- package/dist/workspace/lexicon-outputs.js +2 -2
- package/dist/workspace/release-train.d.ts.map +1 -1
- package/dist/workspace/release-train.js +2 -1
- package/dist/workspace/release-workflow.d.ts +27 -3
- package/dist/workspace/release-workflow.d.ts.map +1 -1
- package/dist/workspace/release-workflow.js +52 -7
- package/dist/workspace/trust/check-evidence-report.d.ts +25 -2
- package/dist/workspace/trust/check-evidence-report.d.ts.map +1 -1
- package/dist/workspace/trust/check-evidence-report.js +28 -8
- package/dist/workspace/trust/check-evidence.d.ts +13 -1
- package/dist/workspace/trust/check-evidence.d.ts.map +1 -1
- package/dist/workspace/trust/check-evidence.js +8 -3
- package/dist/workspace/trust/evidence.d.ts +5 -0
- package/dist/workspace/trust/evidence.d.ts.map +1 -1
- package/dist/workspace/trust/evidence.js +5 -0
- package/dist/workspace/trust/open-evidence.d.ts +67 -0
- package/dist/workspace/trust/open-evidence.d.ts.map +1 -0
- package/dist/workspace/trust/open-evidence.js +92 -0
- package/dist/workspace/trust/ref-gate-cli.d.ts +10 -1
- package/dist/workspace/trust/ref-gate-cli.d.ts.map +1 -1
- package/dist/workspace/trust/ref-gate-cli.js +93 -11
- package/dist/workspace/trust/ref-gate.d.ts +61 -2
- package/dist/workspace/trust/ref-gate.d.ts.map +1 -1
- package/dist/workspace/trust/ref-gate.js +72 -7
- package/dist/workspace/workspace-run.d.ts.map +1 -1
- package/dist/workspace/workspace-run.js +2 -1
- package/package.json +1 -1
- package/src/action-pins.ts +2 -0
- package/src/actor.test.ts +78 -0
- package/src/actor.ts +79 -0
- package/src/bundle-check.test.ts +22 -0
- package/src/bundle-check.ts +33 -5
- package/src/chant-install.test.ts +108 -1
- package/src/chant-install.ts +242 -2
- package/src/ci-base.test.ts +41 -0
- package/src/ci-base.ts +43 -0
- package/src/ci-comment-commands.test.ts +376 -0
- package/src/ci-comment-commands.ts +389 -0
- package/src/ci-comment-replies.ts +78 -0
- package/src/ci-commit.test.ts +51 -6
- package/src/ci-commit.ts +1 -2
- package/src/ci-control.ts +1 -0
- package/src/ci-evidence-claims.ts +102 -0
- package/src/ci-evidence-from-job.test.ts +165 -0
- package/src/ci-evidence-from-job.ts +251 -0
- package/src/ci-evidence-jobs.ts +88 -6
- package/src/ci-handover.ts +16 -3
- package/src/ci-identity.test.ts +3 -3
- package/src/ci-identity.ts +51 -11
- package/src/ci-image.test.ts +187 -16
- package/src/ci-image.ts +157 -25
- package/src/ci-jobs.ts +7 -2
- package/src/ci-login.test.ts +131 -3
- package/src/ci-login.token-drop.test.ts +204 -0
- package/src/ci-login.ts +137 -39
- package/src/ci-note-commands.ts +104 -41
- package/src/ci-product-words.ts +89 -0
- package/src/ci-product.ts +62 -1
- package/src/cli/commands/__fixtures__/source-dir-root/migrations/0001-init/backfill.ts +3 -0
- package/src/cli/commands/build.test.ts +41 -0
- package/src/cli/commands/build.ts +27 -2
- package/src/cli/handlers/approve-confirm.test.ts +35 -0
- package/src/cli/handlers/approve-confirm.ts +44 -0
- package/src/cli/handlers/approve.ts +2 -1
- package/src/cli/handlers/build-source-dir.test.ts +4 -0
- package/src/cli/handlers/build.ts +20 -2
- package/src/cli/handlers/ci-check.ts +37 -7
- package/src/cli/handlers/ci-evidence-open.test.ts +164 -0
- package/src/cli/handlers/ci-evidence.ts +233 -18
- package/src/cli/handlers/ci-forge-check.ts +22 -9
- package/src/cli/handlers/components.ts +3 -1
- package/src/cli/handlers/generated-check.ts +69 -0
- package/src/cli/handlers/lifecycle.test.ts +20 -0
- package/src/cli/handlers/lifecycle.ts +4 -0
- package/src/cli/handlers/local-chant.ts +39 -1
- package/src/cli/handlers/lock-reach.test.ts +103 -0
- package/src/cli/handlers/lock.ts +100 -4
- package/src/cli/handlers/pr-comment.ts +104 -0
- package/src/cli/handlers/pr-env.ts +6 -3
- package/src/cli/handlers/pr-record.test.ts +1 -1
- package/src/cli/handlers/pr.ts +93 -15
- package/src/cli/handlers/promote.ts +2 -1
- package/src/cli/handlers/release.e2e.test.ts +35 -0
- package/src/cli/handlers/release.ts +14 -2
- package/src/cli/handlers/run-wave.ts +35 -2
- package/src/cli/handlers/run.ts +2 -1
- package/src/cli/main.ts +60 -4
- package/src/cli/parse-args.ts +58 -0
- package/src/cli/registry.ts +35 -0
- package/src/components/auto-release.ts +2 -1
- package/src/components/check-hooks.ts +22 -0
- package/src/components/check-report-summary.test.ts +78 -0
- package/src/components/pr-checks.ts +254 -0
- package/src/components/pr-pipeline.ts +43 -1
- package/src/components/product-pipeline.ts +113 -9
- package/src/components/product-plan.test.ts +140 -1
- package/src/components/product-plan.ts +707 -20
- package/src/config.ts +13 -8
- package/src/control/consumers.ts +7 -0
- package/src/dead-guards.test.ts +27 -5
- package/src/dead-guards.ts +9 -6
- package/src/discovery/files.ts +1 -1
- package/src/drift-issue.test.ts +29 -1
- package/src/drift-issue.ts +28 -3
- package/src/drift-record.test.ts +45 -0
- package/src/drift-record.ts +71 -6
- package/src/floor-table.data.ts +81 -21
- package/src/floor-table.ts +12 -9
- package/src/forge-check/contract.ts +23 -2
- package/src/forge-check/forge-check.test.ts +25 -0
- package/src/forge-check/index.ts +4 -0
- package/src/forge-flags.test.ts +25 -1
- package/src/forge-flags.ts +34 -0
- package/src/forge-remote.test.ts +37 -0
- package/src/forge-remote.ts +79 -0
- package/src/gate-resume-run.ts +27 -3
- package/src/generated-check.e2e.test.ts +118 -0
- package/src/generated-check.test.ts +170 -0
- package/src/generated-check.ts +310 -0
- package/src/image-pins.ts +31 -0
- package/src/lexicon.ts +28 -0
- package/src/lifecycle/git.test.ts +48 -0
- package/src/lifecycle/git.ts +27 -4
- package/src/lifecycle/publish-npm.ts +87 -4
- package/src/lifecycle/reach-locks.test.ts +87 -0
- package/src/lifecycle/reach-locks.ts +169 -0
- package/src/lifecycle/release-catalog.test.ts +2 -2
- package/src/lifecycle/release-cut.ts +17 -1
- package/src/lifecycle/release-images-dockerfile.test.ts +20 -0
- package/src/lifecycle/release-images.test.ts +100 -0
- package/src/lifecycle/release-images.ts +38 -3
- package/src/lifecycle/release-ledger.ts +4 -3
- package/src/local-chant.e2e.test.ts +81 -6
- package/src/local-chant.test.ts +22 -3
- package/src/local-chant.ts +130 -13
- package/src/notify-product.ts +19 -8
- package/src/op/activities/source-release.ts +2 -1
- package/src/op/activities/source-rollback.ts +2 -1
- package/src/op/gate-resume.test.ts +27 -0
- package/src/op/index.ts +10 -0
- package/src/op/op-waves-evidence-jobs.ts +140 -0
- package/src/op/op-waves-evidence.test.ts +36 -3
- package/src/op/op-waves-evidence.ts +23 -3
- package/src/op/op-waves-notify-words.test.ts +18 -0
- package/src/op/op-waves-render-spec.test.ts +160 -0
- package/src/op/op-waves-render-spec.ts +171 -0
- package/src/op/op-waves-run.ts +59 -3
- package/src/op/op-waves.ts +16 -2
- package/src/op/schedule-overdue.test.ts +126 -1
- package/src/op/schedule-overdue.ts +164 -12
- package/src/op/wave-stop.test.ts +72 -0
- package/src/op/wave-stop.ts +137 -0
- package/src/planned-files.test.ts +80 -0
- package/src/planned-files.ts +134 -0
- package/src/pr-forge-job.test.ts +53 -0
- package/src/pr-forge-job.ts +46 -0
- package/src/pr-forge-reads-compare.test.ts +2 -1
- package/src/pr-forge-reads.ts +37 -1
- package/src/pr-forge.ts +14 -3
- package/src/pr-loop-narrowed.test.ts +2 -1
- package/src/pr-loop-words.test.ts +2 -1
- package/src/pr-loop.test.ts +1 -2
- package/src/pr-loop.ts +4 -80
- package/src/pr-plan-note.ts +184 -3
- package/src/pr-plan-record.test.ts +75 -0
- package/src/pr-plan-record.ts +101 -0
- package/src/pr-post-plan-note.test.ts +60 -0
- package/src/pr-post-replan.test.ts +144 -0
- package/src/pr-post-subject.test.ts +230 -0
- package/src/pr-post.test.ts +32 -1
- package/src/pr-post.ts +254 -15
- package/src/pr-requires.test.ts +20 -0
- package/src/pr-requires.ts +10 -1
- package/src/pr-status.ts +91 -0
- package/src/ref-gate-init.ts +208 -0
- package/src/ref-gate-rules.ts +26 -0
- package/src/release-floors.ts +139 -17
- package/src/render-module.ts +73 -0
- package/src/state-migration-record.test.ts +89 -0
- package/src/state-migration.test.ts +1 -1
- package/src/state-migration.ts +52 -4
- package/src/state-unlock.test.ts +33 -1
- package/src/state-unlock.ts +49 -1
- package/src/workspace/ci-green-cli.ts +14 -7
- package/src/workspace/ci-green-workflow.test.ts +32 -1
- package/src/workspace/drift-cli.ts +6 -18
- package/src/workspace/forge-work.ts +7 -14
- package/src/workspace/lexicon-outputs.ts +2 -2
- package/src/workspace/release-train.ts +2 -1
- package/src/workspace/release-workflow.test.ts +104 -3
- package/src/workspace/release-workflow.ts +60 -9
- package/src/workspace/trust/check-evidence-report.ts +39 -8
- package/src/workspace/trust/check-evidence.test.ts +5 -0
- package/src/workspace/trust/check-evidence.ts +17 -5
- package/src/workspace/trust/evidence.ts +5 -0
- package/src/workspace/trust/open-evidence.ts +129 -0
- package/src/workspace/trust/ref-gate-cli.ts +88 -10
- package/src/workspace/trust/ref-gate-pieces.test.ts +220 -0
- package/src/workspace/trust/ref-gate.e2e.test.ts +17 -0
- package/src/workspace/trust/ref-gate.test.ts +10 -0
- package/src/workspace/trust/ref-gate.ts +87 -6
- package/src/workspace/workspace-run.ts +2 -1
package/dist/release-floors.js
CHANGED
|
@@ -19,27 +19,33 @@
|
|
|
19
19
|
* this constant to the next patch (#4501). The check fails while a floor
|
|
20
20
|
* still names this constant after its version shipped.
|
|
21
21
|
*/
|
|
22
|
-
export const NEXT_RELEASE = "0.124.
|
|
22
|
+
export const NEXT_RELEASE = "0.124.89";
|
|
23
23
|
/** The first chant with `chant dev local` and `chant dev bundle-check`, `@intentius/chant/local-chant` and `@intentius/chant/bundle-check` (`chantRuntimeTarget`, `chantExternalPlugin`, `checkBundle`): a product built against a chant checkout, and its bundle checked, without its own scripts (#4787). */
|
|
24
|
-
export const LOCAL_CHANT_FLOOR =
|
|
24
|
+
export const LOCAL_CHANT_FLOOR = "0.124.86";
|
|
25
25
|
/** The first chant with `chant workspace ref-gate` (pre-receive, pre-push, check, status, attach, install) and `refs` in `.chant/trust.json`, the checks a ref update needs evidence for (#4867). */
|
|
26
|
-
export const REF_GATE_FLOOR =
|
|
26
|
+
export const REF_GATE_FLOOR = "0.124.86";
|
|
27
27
|
/** The first chant whose overdue check finds a schedule in any pipeline file, and whose `ScheduledWatch` takes a product's `files` and GitLab `schedule` selector (#4789). */
|
|
28
|
-
export const OVERDUE_PIPELINE_FILES_FLOOR =
|
|
28
|
+
export const OVERDUE_PIPELINE_FILES_FLOOR = "0.124.86";
|
|
29
29
|
/** The first chant whose `terraformApplyCapabilityWith` takes `onCommand`, a hook around each engine command `terraform-apply` runs for a root, its reads' upstreams included (#4865). */
|
|
30
|
-
export const TERRAFORM_APPLY_COMMAND_HOOK_FLOOR =
|
|
30
|
+
export const TERRAFORM_APPLY_COMMAND_HOOK_FLOOR = "0.124.86";
|
|
31
|
+
/** The first chant whose terraform lexicon times each root's engine commands and reads its spans and lock waits (`@intentius/chant-lexicon-terraform/engine-timings`, `engineTimings()` as `terraformApplyCapabilityWith`'s `onCommand`), and runs a composed group's commands through that hook (#4887). */
|
|
32
|
+
export const TERRAFORM_ENGINE_TIMINGS_FLOOR = "0.124.88";
|
|
33
|
+
/** The first chant whose terraform lexicon finds live roots and estates (`live-roots`), places a Terragrunt unit (`terragruntUnitPlace`), reads a state migration's history and revert from its finished lines (`migration-history`), and runs the binary without the forge's tokens (`tokenlessBinaryExec`, `engineEnv`) (#4910). */
|
|
34
|
+
export const TERRAFORM_ROOT_HELPERS_FLOOR = "0.124.88";
|
|
35
|
+
/** The first chant whose terraform lexicon has one runner of the engine for a product (`engineRunner` in `engine-runner`: a hooked `exec`, `execSync`, `terragrunt` and the tokenless `script`), traces each engine command (`commandTrace`, `commandTraceEnv`), sends each Terragrunt unit's plan through `planTerragruntWave({ onCommand })`, and resolves a live root's record store (`liveRecordStore`, `writtenRecordStore`, `rootBackendAttrs` in `live-roots`) (#4954). */
|
|
36
|
+
export const TERRAFORM_ENGINE_RUNNER_FLOOR = NEXT_RELEASE;
|
|
31
37
|
/** The first chant with `@intentius/chant/forge-flags` (`forgeTargetWith`, `forgeTargetFromFlags`, `apiBaseOf`), `@intentius/chant/chant-install` (`bundledChant`, `chantArgv`, `installChantResolveFallback`) and `noteLimit` and `fitNote` in `@intentius/chant/plan-summary` (#4800). */
|
|
32
|
-
export const PRODUCT_HELPERS_FLOOR =
|
|
38
|
+
export const PRODUCT_HELPERS_FLOOR = "0.124.86";
|
|
33
39
|
/** The first chant with `@intentius/chant/ci-image`: `productImageStages`, `productImageDockerfile` and `derivedImageDockerfile` for a product's CI image, and `ciToolFetchScript`, `ciToolInstallLine` and `installCiTool`, the digest-checked engine installs, with the terraform lexicon's `choudoufuInstallLine` checked the same way (#4784). */
|
|
34
|
-
export const CI_IMAGE_FLOOR =
|
|
40
|
+
export const CI_IMAGE_FLOOR = "0.124.86";
|
|
35
41
|
/** The first chant with `@intentius/chant/drift-issue`, whose `keepDriftIssue` keeps one drift issue per environment from a product's words and the drift records (#4790). */
|
|
36
|
-
export const DRIFT_ISSUE_FLOOR =
|
|
42
|
+
export const DRIFT_ISSUE_FLOOR = "0.124.86";
|
|
37
43
|
/** The first chant whose `chant build` with no path builds the config's `sourceDir`, whose root build leaves a top-level `scripts/` out, and whose `@intentius/chant/config` exports `resolveSourceDir`, the one source-dir rule every command shares (#4794). */
|
|
38
|
-
export const SOURCE_DIR_RULE_FLOOR =
|
|
44
|
+
export const SOURCE_DIR_RULE_FLOOR = "0.124.86";
|
|
39
45
|
/** The first chant whose pulumi lexicon runs `gatedStackExport`, `gatedStackCancel` and `gatedStackMove` on core's `exportStateVersion`, `releaseStateLock` and `runStateMigration`: export by version, the live-run check before a cancel (`liveRuns`, `forge`), and the check that nothing moved between a move's plan and its write (#4808). */
|
|
40
|
-
export const PULUMI_STACK_OPS_ON_CORE_FLOOR =
|
|
46
|
+
export const PULUMI_STACK_OPS_ON_CORE_FLOOR = "0.124.86";
|
|
41
47
|
/** The first chant whose terraform lexicon's state stores read versions (`version`, `hasVersion`, `readVersion`, `isAt`, `listVersions`), with `readStateVersion` and `listStateVersions`, and lock and write a GitLab-managed http backend's state (#4793). */
|
|
42
|
-
export const TERRAFORM_STATE_VERSION_READS_FLOOR =
|
|
48
|
+
export const TERRAFORM_STATE_VERSION_READS_FLOOR = "0.124.86";
|
|
43
49
|
/** The first chant whose terraform lexicon's `terraform-apply` reads take `dir` and `workspace`, and read an upstream with `resolveRoot`'s binary and `readEnv` (terragucci issue 1303). */
|
|
44
50
|
export const TERRAFORM_APPLY_INSTANCE_READS_FLOOR = "0.124.80";
|
|
45
51
|
/** The first chant whose terraform lexicon's `terraform-apply` takes `binary`, and `terraformApplyCapabilityWith({ resolveRoot })` gives each root its own binary (terragucci issue 1303). */
|
|
@@ -67,14 +73,92 @@ export const PR_FORGE_READS_FLOOR = "0.124.78";
|
|
|
67
73
|
/** The first chant whose GitLab `scheduledRuns` takes `schedule`, the selector of an Op's `gitlab.scheduleRule` (#4813). */
|
|
68
74
|
export const SCHEDULED_RUNS_SELECTOR_FLOOR = "0.124.78";
|
|
69
75
|
/** The first chant whose Op waves pipeline takes `waveJobs` and `recordPlans`, a product's login, report, artifact and plans-job inputs, so it edits nothing chant wrote (#4791). */
|
|
70
|
-
export const OP_WAVES_JOB_INPUTS_FLOOR =
|
|
76
|
+
export const OP_WAVES_JOB_INPUTS_FLOOR = "0.124.86";
|
|
71
77
|
/** The first chant with `@intentius/chant/floor-table` (`FLOOR_TABLE`, `floorVersion`, `chantMeets`), every floor as one table, and `chant dev dead-guards` with `@intentius/chant/dead-guards` (`findDeadGuards`), which fails on a feature-detect the product's chant pin meets (#4792). */
|
|
72
|
-
export const FLOOR_TABLE_FLOOR =
|
|
78
|
+
export const FLOOR_TABLE_FLOOR = "0.124.86";
|
|
73
79
|
/** The first chant with `@intentius/chant/ci-login`: `githubCloudLogin`, `gitlabCloudLogin` and `forgejoCloudLogin` render a job's AWS, GCP and Azure login from the OIDC token file, per target too (#4788). */
|
|
74
|
-
export const CLOUD_LOGIN_FLOOR =
|
|
80
|
+
export const CLOUD_LOGIN_FLOOR = "0.124.86";
|
|
75
81
|
/** The first chant whose generated pipelines sign evidence for each named check they run, with `chant ci evidence`, `ci check` signing each hook, and an Op waves spec's `evidence.requires` (#4870). */
|
|
76
|
-
export const CHECK_EVIDENCE_FLOOR =
|
|
82
|
+
export const CHECK_EVIDENCE_FLOOR = "0.124.86";
|
|
77
83
|
/** The first chant that accepts local evidence (#4868): `local` in `.chant/trust.json`, `chant ci evidence sign --local`, and `chant ci check` skipping a hook whose current local evidence the policy at base accepts. */
|
|
78
|
-
export const LOCAL_EVIDENCE_FLOOR =
|
|
84
|
+
export const LOCAL_EVIDENCE_FLOOR = "0.124.86";
|
|
79
85
|
/** The first chant that signs runner statements keyless from the CI job's OIDC identity and verifies them against `keyless` in `.chant/trust.json`, with `evidence.identity: "oidc"` in the generators (#4869). */
|
|
80
|
-
export const KEYLESS_EVIDENCE_FLOOR =
|
|
86
|
+
export const KEYLESS_EVIDENCE_FLOOR = "0.124.87";
|
|
87
|
+
/** The first chant whose waves generators run each wave's policy as a step of its own (`chant run wave --policy-only`; on GitLab a `<wave job>-policy` job) and sign its checks in a `<wave job>-evidence` job with `chant ci evidence sign --from-job`, from the forge's record of the wave job's steps, so a wave that trades cloud credentials signs keyless with `evidence.identity: "oidc"` instead of being refused (#4926). */
|
|
88
|
+
export const WAVE_EVIDENCE_JOB_FLOOR = "0.124.88";
|
|
89
|
+
/** The first chant whose cloud login leaves the region to the job unless the spec names one, takes `sameStep` to export into the step that runs it, accepts an AWS spec with no role (the token file alone), and whose trade sets `CHANT_CLOUD_TRADED` so a login's targets file is told from a trade's (#4930). */
|
|
90
|
+
export const CLOUD_LOGIN_SAME_STEP_FLOOR = "0.124.88";
|
|
91
|
+
/** The first chant whose `chant release workflow` sets up QEMU in the cut and publish jobs for the platforms `release.images` builds that the runner can't (`docker/setup-qemu-action` at its pin on GitHub and Forgejo, a `tonistiigi/binfmt` run line on GitLab), and whose `release.images` command entries take `platforms` (#4876). */
|
|
92
|
+
export const RELEASE_WORKFLOW_QEMU_FLOOR = "0.124.88";
|
|
93
|
+
/** The first chant whose npm publish target refuses at plan time a package that would carry an image archive the release records (`publish-npm-carries-image`), naming the file and the `files` entry that leaves it out (#4934). */
|
|
94
|
+
export const NPM_CARRIES_IMAGE_FLOOR = "0.124.88";
|
|
95
|
+
/** The first chant with `driftRunFingerprint` in `@intentius/chant/drift-issue` and `lexiconDriftRecords` in `@intentius/chant/drift-record`, whose `chant lifecycle diff --live --json` writes a lexicon's `absent`, and whose sql lexicon reports a declared object the server lacks as `missing` instead of `pending` (#4896). */
|
|
96
|
+
export const LIVE_DRIFT_RECORDS_FLOOR = "0.124.88";
|
|
97
|
+
/** The first chant whose `chant sql types --path` prints where `sql-types.d.ts` is by the source-dir rule, the path `sqlTypesPath` answers (#4897). */
|
|
98
|
+
export const SQL_TYPES_PATH_FLOOR = "0.124.88";
|
|
99
|
+
/** The first chant whose forge target carries its web `origin` (`forgeTargetWith`) and whose `@intentius/chant/forge-flags` has `jobForgeTarget`, a job's target or undefined where the job cannot reach the forge, so a product keeps no target type of its own (#4888). */
|
|
100
|
+
export const FORGE_TARGET_ORIGIN_FLOOR = "0.124.88";
|
|
101
|
+
/** The first chant with `actorFromEnv` (`@intentius/chant/actor`), `forgeTargetLiveRuns` and `forgeLiveRunsOf` in `@intentius/chant/state-unlock`, and a pulumi lexicon whose stack ops take the product's `approveCommand`, with `pulumiStackLockToCancel` and `pulumiMoveDestStack`, a move naming its own `--dest` from both sides' `project` (#4911). */
|
|
102
|
+
export const STACK_OPS_PRODUCT_HELPERS_FLOOR = "0.124.88";
|
|
103
|
+
/** The first chant with `@intentius/chant/forge-remote` (`forgeOfRemote`, `forgeOfCheckout`, `forgeKindOfHost`), the forge and repository a checkout's origin remote names, and a pulumi `gatedStackCancel` that reads the forge's runs from it on a laptop (#4920). */
|
|
104
|
+
export const FORGE_REMOTE_FLOOR = "0.124.88";
|
|
105
|
+
/** The first chant with `chant dev generated-check` (`chantGenerated` in a product's root package.json, `@intentius/chant/generated-check`) and `chant dev local-image` (`localChantImage` in `@intentius/chant/local-chant`): a drift check of a product's committed generated files, and an image build with the product's chant, local or pinned, without the product's own scripts (#4909). */
|
|
106
|
+
export const GENERATED_CHECK_FLOOR = "0.124.88";
|
|
107
|
+
/** The first chant whose `chant dev local` keeps the product's peer dependencies installed and packs the checkout at its `NEXT_RELEASE`, and whose root build of a project with no `sourceDir` leaves its top-level `migrations/` out, with the sql lexicon opening no `.sql` file under a `migrations` directory (#4921). */
|
|
108
|
+
export const LOCAL_CHANT_NEXT_RELEASE_FLOOR = "0.124.88";
|
|
109
|
+
/** The first chant whose `chantExternalPlugin` keeps external only the chant packages it is given, by default the ones in the package's `dependencies`, so a product that bundles its lexicons uses it as is (#4922). */
|
|
110
|
+
export const CHANT_EXTERNAL_PACKAGES_FLOOR = "0.124.88";
|
|
111
|
+
/** The first chant whose `ciToolInstallLine` takes `sudo` and `binDir` and a root under a shell variable, for a job that is not root, whose `CI_TOOL_SHA256` records terraform 1.14.9, terragrunt 1.2.0 and the AWS CLI 2.37.9, and whose Pulumi lexicon's `ciFetchScript` and `PINNED_SHA256` are ci-image's (#4908). */
|
|
112
|
+
export const CI_IMAGE_NON_ROOT_FLOOR = "0.124.88";
|
|
113
|
+
/** The first chant whose `productImageStages` stages type as the docker lexicon's `DockerfileStage[]` under `exactOptionalPropertyTypes`, so `new Dockerfile({ stages: productImageStages(spec) })` compiles (#4932). */
|
|
114
|
+
export const CI_IMAGE_DOCKER_STAGES_FLOOR = "0.124.88";
|
|
115
|
+
/** The first chant whose setup steps (`OpSetupStep`: an Op waves spec's wave and job group `setup`, a scheduled Op's `setup`, `release.workflow.setup`) take a `name`, rendered as the step's name on GitHub and Forgejo (#4932). */
|
|
116
|
+
export const OP_SETUP_STEP_NAME_FLOOR = "0.124.88";
|
|
117
|
+
/** The first chant whose cloud login takes `restart` (log in, then start the step's script again without the token request variables, and empty the token files when the step exits), sets `CHANT_CLOUD_TOKEN_FILES` for `LOGIN_CLEAR_TOKENS`, takes a full token URL as GCP's `stsEndpoint`, and whose GitLab trade evaluates its exports without writing a file (#4912). */
|
|
118
|
+
export const CLOUD_LOGIN_RESTART_FLOOR = "0.124.88";
|
|
119
|
+
/** The first chant whose `chant build --pr-loop` takes `evidence` (`--evidence-runner-key-secret`, `--evidence-identity oidc`, `--evidence-audience`) and signs the plan job's `plan` and `policy` checks in its note job on GitHub, GitLab and Forgejo (#4935). */
|
|
120
|
+
export const PR_LOOP_EVIDENCE_FLOOR = "0.124.88";
|
|
121
|
+
/** The first chant whose pull request pipelines take `checkJob` (`--check-job`): a check job that runs `chant ci check` on the pull request's commit with no token or runner identity, and with `evidence` a `check-evidence` job that signs each passed hook from its report with `chant ci evidence sign --from-report .chant/check` (#4935). */
|
|
122
|
+
export const CHECK_JOB_FLOOR = "0.124.88";
|
|
123
|
+
/** The first chant whose GitLab pipelines sign evidence in the target branch's plan notes pipeline, in jobs that name the `chant-evidence` environment, with `chant ci evidence sign --open`, and whose `pr-post --open --evidence-dir` ends each merge request's note with the checks line; no job of a merge request pipeline holds the runner key (#4914). */
|
|
124
|
+
export const GITLAB_OPEN_EVIDENCE_FLOOR = "0.124.88";
|
|
125
|
+
/** The first chant whose `chant ci check` takes `--summary <file>` and whose `checkReportSummary` renders the check report's markdown section, so a product's check step runs chant's check stage and keeps the section in its own report (#4914). */
|
|
126
|
+
export const CHECK_SUMMARY_FLOOR = "0.124.88";
|
|
127
|
+
/** The first chant whose pull request pipelines take `refGateStatus` (`--ref-gate-status`): a `ref-gate` job that runs `chant workspace ref-gate status` for the pull request's commit, and on GitLab `ref-gate status --open` for every open merge request (#4935). */
|
|
128
|
+
export const REF_GATE_STATUS_JOB_FLOOR = "0.124.88";
|
|
129
|
+
/** The first chant with `@intentius/chant/ref-gate-rules` (`refGateRulesAt`), `require` in `checkPrRequires`, `refGateStatus` in `pipelineContract` and `ci forge-check --ref-gate-status`, `@intentius/chant/ref-gate-init` (`refGateInitPlan`, `writeRefGateInit`), and a pre-receive refusal that prints the command recording the override request (#4913). */
|
|
130
|
+
export const REF_GATE_PIECES_FLOOR = "0.124.88";
|
|
131
|
+
/** The first chant whose `chant release cut --yes` pushes `chant/lifecycle` again when the remote refuses it, and exits non-zero untagged (`release-record-not-pushed`) when the release record never lands, so the release workflow does not push the tag (#4965). */
|
|
132
|
+
export const RELEASE_CUT_RECORD_FLOOR = NEXT_RELEASE;
|
|
133
|
+
/** The first chant whose release cut refuses, before it records or tags, a release whose npm publish target would carry an image archive (`publish-npm-carries-image`), and whose GitLab release workflow runs the binfmt image by digest from `IMAGE_PINS` (#4941). */
|
|
134
|
+
export const RELEASE_CUT_CARRIES_IMAGE_FLOOR = NEXT_RELEASE;
|
|
135
|
+
/** The first chant whose `ciToolFetchScript` and `ciToolInstallLine` take `download: "node"`, a fetch and unzip with node for an image with no curl or unzip, whose `CI_TOOL_SHA256` records just 1.36.0 and act 0.2.89 and checks them against their releases' checksums files, and whose overdue check deepens a shallow checkout before it dates a pipeline file (#4952). */
|
|
136
|
+
export const CI_TOOL_NODE_DOWNLOAD_FLOOR = NEXT_RELEASE;
|
|
137
|
+
/** The first chant whose `chant build -o <dir>/` writes a build's additional files (a docker project's Dockerfiles) into the directory with no primary file, whose `chantGenerated` renders take a `module` and its `export` (a `{ path: text }` object or a function returning one) and `chant dev render <module> <export>` writes them in place, and whose `chant ci workflow` and `chant release workflow` write into `chant dev generated-check`'s render tree with no `--output` (#4950). */
|
|
138
|
+
export const RENDER_KINDS_FLOOR = NEXT_RELEASE;
|
|
139
|
+
/** The first chant whose sql lexicon's `chant lifecycle diff --live` addresses a table's columns by name (`columns[#country].default.expr`), compares a ClickHouse table's column order as `columnOrder`, and reports a column the server has and the declaration does not as pending, and whose `lexiconDriftRecords` counts a deep read's pending changes (that column, a ClickHouse or Postgres privilege granted by hand) as drift (#4944). */
|
|
140
|
+
export const SQL_LIVE_COLUMNS_FLOOR = NEXT_RELEASE;
|
|
141
|
+
/** The first chant whose `driftNotifyFields` takes `stacks`, each member's drift records, and from them names the drifted members and computes the run's fingerprint (#4944). */
|
|
142
|
+
export const DRIFT_NOTIFY_STACKS_FLOOR = NEXT_RELEASE;
|
|
143
|
+
/** The first chant whose workspace member's pull request pipeline takes `evidence`, `checkJob` and `refGateStatus` (`chant build --pr-loop` in a member), signing the member's plan job as `plan:<member>` and `policy:<member>` (`ci evidence sign --member`, `memberEvidenceCheck`) and running the check job in the member's directory (#4964). */
|
|
144
|
+
export const MEMBER_SIGNED_CHECKS_FLOOR = NEXT_RELEASE;
|
|
145
|
+
/** The first chant whose `checkJob` takes `{ services, env, before, dir, args }` (`PrCheckJobOptions`: service containers, the check step's variables and lines, the report directory, the arguments after `--base`) and whose github, forgejo and gitlab lexicons render the check, check evidence and ref gate jobs for a product's own workflow (`productCheckJobs`, `forgejoProductCheckJobs`, `gitlabProductCheckJobs`) (#4964). */
|
|
146
|
+
export const PRODUCT_CHECK_JOBS_FLOOR = NEXT_RELEASE;
|
|
147
|
+
/** The first chant whose GitLab Op waves pipeline with a runner key hands it to no wave job: each deciding wave's `<wave job>-evidence` job names the `chant-evidence` environment and signs `plan:<wave>` from the wave job (#4964). */
|
|
148
|
+
export const GITLAB_WAVE_KEY_SCOPE_FLOOR = NEXT_RELEASE;
|
|
149
|
+
/** The first chant with `actorOf` and `actorOrder` in `@intentius/chant/actor`: the actor fallback with `GITHUB_TRIGGERING_ACTOR` ahead of the forge's actor and git's `user.name` before the login, each place switched on or off by the caller (#4966). */
|
|
150
|
+
export const ACTOR_ORDER_FLOOR = NEXT_RELEASE;
|
|
151
|
+
/** The first chant with `@intentius/chant/ci-base` (`ciBaseRef`), the base a CI job measures a change from (the pull request's target branch, else the default branch for a push to another branch), and whose `chant ci check` defaults `--base` to it (#4966). */
|
|
152
|
+
export const CI_BASE_REF_FLOOR = NEXT_RELEASE;
|
|
153
|
+
/** The first chant with `@intentius/chant/planned-files` (`planFile`, `planRemoval`, `writePlannedFiles`, `staleGeneratedFiles`): an init's planned files with their modes, written or removed in one call, and the generated files a product no longer renders, found by their header (#4966). */
|
|
154
|
+
export const PLANNED_FILES_FLOOR = NEXT_RELEASE;
|
|
155
|
+
/** The first chant whose `pipelineContract` takes `jobs`, the jobs a product builds from its own config, beside or in place of `pipelines`, so a product's forge check gets the required statuses and `refGateStatus` from chant (#4966). */
|
|
156
|
+
export const FORGE_CHECK_OWN_JOBS_FLOOR = NEXT_RELEASE;
|
|
157
|
+
/** The first chant whose `chant components pr-apply --before-merge` waits for the ref gate's status: the status the policy at base sets for the target branch is passed as `require` to the `checks` require (#4966). */
|
|
158
|
+
export const BEFORE_MERGE_REF_GATE_FLOOR = NEXT_RELEASE;
|
|
159
|
+
/** The first chant whose product plan with `targets` and `evidence` signs each target's plan job as `plan:<target>` and `policy:<target>` (`ci evidence sign --member <target>`, `targetEvidenceCheck`, `productPlanEvidenceChecks`), and whose `refGateInitPlan` takes `targets` and names those checks in the `refs` rule (#4978). */
|
|
160
|
+
export const TARGET_SIGNED_CHECKS_FLOOR = NEXT_RELEASE;
|
|
161
|
+
/** The first chant whose Op waves generators take `renderSpec` (the wave jobs run `chant run wave --render-spec`, and `CHANT_WAVES_SPEC_COMMAND` names the product command that prints the spec at the commit in `CHANT_WAVES_SPEC_AT`), so a product whose spec is built from its config at base renders its wave jobs, policy step, evidence job and cloud trade through chant (#4982). */
|
|
162
|
+
export const RUNTIME_WAVES_SPEC_FLOOR = NEXT_RELEASE;
|
|
163
|
+
/** The first chant whose `chant run resume` (`resumeGateRun`) on GitLab retries a wave job's `<wave job>-evidence` with the wave job when the evidence job already ran, and whose `ci evidence sign --from-job` waits for a job it reads to finish, so a resumed wave's evidence job signs from the new try (#4978). */
|
|
164
|
+
export const GITLAB_WAVE_EVIDENCE_RETRY_FLOOR = NEXT_RELEASE;
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
/** Files by their path below the output root. */
|
|
2
|
+
export type RenderedFiles = Record<string, string>;
|
|
3
|
+
/**
|
|
4
|
+
* Import `modulePath` (resolved from `cwd`) and return the files its export
|
|
5
|
+
* `exportName` renders. Throws, naming the module and export, when the export
|
|
6
|
+
* is missing, is not files, or names a path outside the root.
|
|
7
|
+
*/
|
|
8
|
+
export declare function renderModuleFiles(modulePath: string, exportName: string, cwd?: string): Promise<RenderedFiles>;
|
|
9
|
+
/**
|
|
10
|
+
* Write each file below `root`, creating its directories. `place` maps the
|
|
11
|
+
* absolute path before the write (`renderPathOf`, under a check). Returns
|
|
12
|
+
* the paths written, in the export's order.
|
|
13
|
+
*/
|
|
14
|
+
export declare function writeRenderedFiles(root: string, files: RenderedFiles, place?: (path: string) => string): string[];
|
|
15
|
+
//# sourceMappingURL=render-module.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"render-module.d.ts","sourceRoot":"","sources":["../src/render-module.ts"],"names":[],"mappings":"AA0BA,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAQnD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,SAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAgB3H;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAiB,GAAG,MAAM,EAAE,CAS3H"}
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* #4950: render a module's file-text export.
|
|
3
|
+
*
|
|
4
|
+
* A product keeps some generated files as the text a TypeScript function
|
|
5
|
+
* returns: plywood's `dockerfiles()` in `src/images.ts` gives each image's
|
|
6
|
+
* Dockerfile by its path from the repository root, and a schema or a set of
|
|
7
|
+
* dashboards can be the same. plywood bundled each such module with esbuild
|
|
8
|
+
* (`build-images.mjs`, `build-schema.mjs`) only to call that export and write
|
|
9
|
+
* the files. Here chant imports the module itself, with the TypeScript loader
|
|
10
|
+
* and chant's own modules served as the running CLI, calls the export, and
|
|
11
|
+
* writes each file below an output root:
|
|
12
|
+
*
|
|
13
|
+
* - `chant dev render <module> <export> [--output <root>]` writes them in
|
|
14
|
+
* place (the root is the working directory unless `--output` names one);
|
|
15
|
+
* under `chant dev generated-check` they go to the render tree.
|
|
16
|
+
* - a `chantGenerated` render of the module kind (`{ "module", "export" }`)
|
|
17
|
+
* renders them into the check's render tree and compares them.
|
|
18
|
+
*
|
|
19
|
+
* The export is a `{ path: text }` object, or a function, async or not, that
|
|
20
|
+
* returns one when called with no arguments. Each path is relative, with `/`
|
|
21
|
+
* between segments and no `..`.
|
|
22
|
+
*/
|
|
23
|
+
import { mkdirSync, writeFileSync } from "node:fs";
|
|
24
|
+
import { dirname, join, resolve } from "node:path";
|
|
25
|
+
import { importModule } from "./discovery/import.js";
|
|
26
|
+
/** Whether `path` is one an export may name: relative, `/`-separated, with no `.` or `..` segment. */
|
|
27
|
+
function isRenderedPath(path) {
|
|
28
|
+
if (!path || path.startsWith("/") || path.includes("\\") || /^[A-Za-z]:/.test(path))
|
|
29
|
+
return false;
|
|
30
|
+
return path.split("/").every((s) => s !== "" && s !== "." && s !== "..");
|
|
31
|
+
}
|
|
32
|
+
/**
|
|
33
|
+
* Import `modulePath` (resolved from `cwd`) and return the files its export
|
|
34
|
+
* `exportName` renders. Throws, naming the module and export, when the export
|
|
35
|
+
* is missing, is not files, or names a path outside the root.
|
|
36
|
+
*/
|
|
37
|
+
export async function renderModuleFiles(modulePath, exportName, cwd = process.cwd()) {
|
|
38
|
+
const at = resolve(cwd, modulePath);
|
|
39
|
+
const where = `${modulePath} export ${exportName}`;
|
|
40
|
+
const mod = await importModule(at);
|
|
41
|
+
if (!(exportName in mod))
|
|
42
|
+
throw new Error(`${modulePath} has no export named ${exportName}`);
|
|
43
|
+
const exported = mod[exportName];
|
|
44
|
+
const value = typeof exported === "function" ? await exported() : exported;
|
|
45
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
46
|
+
throw new Error(`${where} must be, or return, an object of file paths to their text`);
|
|
47
|
+
const files = {};
|
|
48
|
+
for (const [path, text] of Object.entries(value)) {
|
|
49
|
+
if (!isRenderedPath(path))
|
|
50
|
+
throw new Error(`${where} names ${JSON.stringify(path)}, which is not a relative path inside the output root`);
|
|
51
|
+
if (typeof text !== "string")
|
|
52
|
+
throw new Error(`${where} gives ${path} a ${text === null ? "null" : typeof text}, not its text`);
|
|
53
|
+
files[path] = text;
|
|
54
|
+
}
|
|
55
|
+
if (Object.keys(files).length === 0)
|
|
56
|
+
throw new Error(`${where} renders no files`);
|
|
57
|
+
return files;
|
|
58
|
+
}
|
|
59
|
+
/**
|
|
60
|
+
* Write each file below `root`, creating its directories. `place` maps the
|
|
61
|
+
* absolute path before the write (`renderPathOf`, under a check). Returns
|
|
62
|
+
* the paths written, in the export's order.
|
|
63
|
+
*/
|
|
64
|
+
export function writeRenderedFiles(root, files, place = (p) => p) {
|
|
65
|
+
const written = [];
|
|
66
|
+
for (const [path, text] of Object.entries(files)) {
|
|
67
|
+
const target = place(join(root, path));
|
|
68
|
+
mkdirSync(dirname(target), { recursive: true });
|
|
69
|
+
writeFileSync(target, text);
|
|
70
|
+
written.push(target);
|
|
71
|
+
}
|
|
72
|
+
return written;
|
|
73
|
+
}
|
|
@@ -3,7 +3,15 @@ import type { GatedRequestRules } from "./lifecycle/gated-request.js";
|
|
|
3
3
|
/** The first chant with the engine-neutral state migration (#4762). */
|
|
4
4
|
export declare const STATE_MIGRATION_FLOOR = "0.124.77";
|
|
5
5
|
/** The first chant whose migration binds a root's `source` (an engine's `source` read under the locks) and answers `approval-moved`, and whose terraform lexicon plans backend moves (`planTerraformMigration`'s `backends`) and choudoufu estate migrations (`planEstateMigration`) onto it (#4806). */
|
|
6
|
-
export declare const STATE_MIGRATION_SOURCE_FLOOR = "0.124.
|
|
6
|
+
export declare const STATE_MIGRATION_SOURCE_FLOOR = "0.124.86";
|
|
7
|
+
/** The first chant whose `runStateMigration` takes a product's `record`, which the request's attachment binds beside the roots and `chant approve` shows (#4928). */
|
|
8
|
+
export declare const STATE_MIGRATION_RECORD_FLOOR = "0.124.88";
|
|
9
|
+
/** The most a product's migration `record` may take, as canonical JSON in UTF-8 (#4928): a record names moves, retags and stamps, never a state's contents. */
|
|
10
|
+
export declare const STATE_MIGRATION_RECORD_MAX_BYTES: number;
|
|
11
|
+
/** A product's migration `record` that cannot be bound: not JSON, or over {@link STATE_MIGRATION_RECORD_MAX_BYTES}. Thrown before anything is asked. */
|
|
12
|
+
export declare class StateMigrationRecordError extends Error {
|
|
13
|
+
constructor(message: string);
|
|
14
|
+
}
|
|
7
15
|
/** A state as a migration binds it: its version id, when the store keeps versions, and its digest, null for no state. */
|
|
8
16
|
export interface MigrationStateAt {
|
|
9
17
|
version_id?: string;
|
|
@@ -74,6 +82,16 @@ export interface StateMigrationInput {
|
|
|
74
82
|
words: StateMigrationWords;
|
|
75
83
|
/** The product's facts the request binds, such as the migration file's path and digest. */
|
|
76
84
|
fields?: Record<string, string>;
|
|
85
|
+
/**
|
|
86
|
+
* The product's own record of the migration, such as its moves, retags and
|
|
87
|
+
* stamps (#4928). It goes in the request's attachment beside the roots as
|
|
88
|
+
* canonical JSON (keys sorted), so the request's digest binds it and
|
|
89
|
+
* `chant approve` shows it. At most {@link STATE_MIGRATION_RECORD_MAX_BYTES};
|
|
90
|
+
* a record that is larger or is not JSON throws {@link StateMigrationRecordError}
|
|
91
|
+
* before anything is asked. Never a state's contents. Unset, the attachment
|
|
92
|
+
* is the roots alone, as before.
|
|
93
|
+
*/
|
|
94
|
+
record?: unknown;
|
|
77
95
|
/** The product's facts the finished line adds, given how it ended. */
|
|
78
96
|
detail?: (result: StateMigrationResult) => Record<string, string | number | boolean>;
|
|
79
97
|
rules: GatedRequestRules;
|
|
@@ -155,6 +173,11 @@ export type StateMigrationOutcome = {
|
|
|
155
173
|
result?: StateMigrationResult;
|
|
156
174
|
recorded: boolean;
|
|
157
175
|
};
|
|
176
|
+
/**
|
|
177
|
+
* A product's record as the attachment binds it (#4928): its canonical JSON
|
|
178
|
+
* read back, so its keys are in sorted order, once it is known to fit.
|
|
179
|
+
*/
|
|
180
|
+
export declare function boundRecord(record: unknown): unknown;
|
|
158
181
|
/** The finished line's flat facts: how it ended, and each root's location, versions and digests. */
|
|
159
182
|
export declare function migrationFacts(result: StateMigrationResult): Record<string, string | number | boolean>;
|
|
160
183
|
/**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"state-migration.d.ts","sourceRoot":"","sources":["../src/state-migration.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"state-migration.d.ts","sourceRoot":"","sources":["../src/state-migration.ts"],"names":[],"mappings":"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"}
|
package/dist/state-migration.js
CHANGED
|
@@ -36,16 +36,32 @@
|
|
|
36
36
|
* earlier request of the same migration stands, made since that request was
|
|
37
37
|
* asked, answers `approval-moved` and names the roots whose state moved
|
|
38
38
|
* between the two (#4806).
|
|
39
|
+
*
|
|
40
|
+
* A product's own record of the migration (its moves, retags and stamps)
|
|
41
|
+
* goes in the attachment beside the roots as `record` (#4928): canonical
|
|
42
|
+
* JSON, at most {@link STATE_MIGRATION_RECORD_MAX_BYTES}, so the digest binds
|
|
43
|
+
* it and `chant approve` shows it with the roots.
|
|
39
44
|
*/
|
|
45
|
+
import { canonicalJson } from "./effect-receipt.js";
|
|
40
46
|
import { CHANT_EXIT } from "./exit-codes.js";
|
|
41
47
|
import { chantGatedLedger, gatedOp } from "./lifecycle/gated-op.js";
|
|
42
48
|
import { gatedRequestAttachmentPath } from "./lifecycle/gated-request-digest.js";
|
|
43
49
|
import { samePlanDigest } from "./lifecycle/plan-digest.js";
|
|
44
|
-
import { NEXT_RELEASE } from "./release-floors.js";
|
|
45
50
|
/** The first chant with the engine-neutral state migration (#4762). */
|
|
46
51
|
export const STATE_MIGRATION_FLOOR = "0.124.77";
|
|
47
52
|
/** The first chant whose migration binds a root's `source` (an engine's `source` read under the locks) and answers `approval-moved`, and whose terraform lexicon plans backend moves (`planTerraformMigration`'s `backends`) and choudoufu estate migrations (`planEstateMigration`) onto it (#4806). */
|
|
48
|
-
export const STATE_MIGRATION_SOURCE_FLOOR =
|
|
53
|
+
export const STATE_MIGRATION_SOURCE_FLOOR = "0.124.86";
|
|
54
|
+
/** The first chant whose `runStateMigration` takes a product's `record`, which the request's attachment binds beside the roots and `chant approve` shows (#4928). */
|
|
55
|
+
export const STATE_MIGRATION_RECORD_FLOOR = "0.124.88";
|
|
56
|
+
/** The most a product's migration `record` may take, as canonical JSON in UTF-8 (#4928): a record names moves, retags and stamps, never a state's contents. */
|
|
57
|
+
export const STATE_MIGRATION_RECORD_MAX_BYTES = 64 * 1024;
|
|
58
|
+
/** A product's migration `record` that cannot be bound: not JSON, or over {@link STATE_MIGRATION_RECORD_MAX_BYTES}. Thrown before anything is asked. */
|
|
59
|
+
export class StateMigrationRecordError extends Error {
|
|
60
|
+
constructor(message) {
|
|
61
|
+
super(message);
|
|
62
|
+
this.name = "StateMigrationRecordError";
|
|
63
|
+
}
|
|
64
|
+
}
|
|
49
65
|
const same = (a, b) => (a.version_id ?? undefined) === (b.version_id ?? undefined) && a.digest === b.digest;
|
|
50
66
|
/** What a request's attachment binds of each root: its location and state before, its new state's digest, and its source when it has one. */
|
|
51
67
|
const boundRoot = (r) => ({
|
|
@@ -55,6 +71,24 @@ const boundRoot = (r) => ({
|
|
|
55
71
|
after: r.after.digest,
|
|
56
72
|
...(r.source ? { source: { location: r.source.location ?? null, version_id: r.source.version_id ?? null, digest: r.source.digest } } : {}),
|
|
57
73
|
});
|
|
74
|
+
/**
|
|
75
|
+
* A product's record as the attachment binds it (#4928): its canonical JSON
|
|
76
|
+
* read back, so its keys are in sorted order, once it is known to fit.
|
|
77
|
+
*/
|
|
78
|
+
export function boundRecord(record) {
|
|
79
|
+
let text;
|
|
80
|
+
try {
|
|
81
|
+
text = canonicalJson(record);
|
|
82
|
+
}
|
|
83
|
+
catch (e) {
|
|
84
|
+
throw new StateMigrationRecordError(`the migration's record is not JSON: ${e.message}`);
|
|
85
|
+
}
|
|
86
|
+
const bytes = Buffer.byteLength(text, "utf8");
|
|
87
|
+
if (bytes > STATE_MIGRATION_RECORD_MAX_BYTES) {
|
|
88
|
+
throw new StateMigrationRecordError(`the migration's record is ${bytes} bytes as canonical JSON, over the ${STATE_MIGRATION_RECORD_MAX_BYTES} a request binds; keep the moves, retags and stamps, and leave the rest in the product's report`);
|
|
89
|
+
}
|
|
90
|
+
return JSON.parse(text);
|
|
91
|
+
}
|
|
58
92
|
/** The finished line's flat facts: how it ended, and each root's location, versions and digests. */
|
|
59
93
|
export function migrationFacts(result) {
|
|
60
94
|
const out = {
|
|
@@ -131,8 +165,9 @@ export async function runStateMigration(input) {
|
|
|
131
165
|
if (failing.length > 0)
|
|
132
166
|
return { status: "proof-failed", exit: CHANT_EXIT.failed, roots: input.roots, failing };
|
|
133
167
|
const roots = [...input.roots].sort((a, b) => (a.root < b.root ? -1 : a.root > b.root ? 1 : 0));
|
|
134
|
-
// The attachment binds each root's state before and after; the proof's wording is the engine's, not the migration.
|
|
135
|
-
const
|
|
168
|
+
// The attachment binds each root's state before and after, and the product's record when it gives one (#4928); the proof's wording is the engine's, not the migration.
|
|
169
|
+
const record = input.record === undefined ? undefined : boundRecord(input.record);
|
|
170
|
+
const attachment = `${JSON.stringify({ name: input.name, roots: roots.map(boundRoot), ...(record !== undefined ? { record } : {}) }, null, 2)}\n`;
|
|
136
171
|
const now = input.now ?? new Date().toISOString();
|
|
137
172
|
const result = await gatedOp({
|
|
138
173
|
op: input.words.op,
|
package/dist/state-unlock.d.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { type GatedRequestLedger } from "./lifecycle/gated-op.js";
|
|
2
2
|
import type { GatedRequestRules } from "./lifecycle/gated-request.js";
|
|
3
|
-
import type {
|
|
3
|
+
import type { ForgeOverrides } from "./forge-flags.js";
|
|
4
|
+
import type { ForgeFetch, ForgeKind, ForgeTarget, ForgeTargetOptions } from "./pr-forge.js";
|
|
4
5
|
/** The first chant with the engine-neutral lock release and {@link forgeLiveRuns} (#4762). */
|
|
5
6
|
export declare const STATE_UNLOCK_FLOOR = "0.124.77";
|
|
6
7
|
/** A run of the repository that has not finished, as {@link forgeLiveRuns} reads it. */
|
|
@@ -31,6 +32,36 @@ export interface LiveRunsTarget {
|
|
|
31
32
|
* a read only a lock release makes. Throws on a forge that answers an error.
|
|
32
33
|
*/
|
|
33
34
|
export declare function forgeLiveRuns(t: LiveRunsTarget): Promise<LiveRun[]>;
|
|
35
|
+
/**
|
|
36
|
+
* The live runs of a {@link ForgeTarget} (#4911), from `forgeTargetFromEnv`,
|
|
37
|
+
* `forgeTargetWith` or `forgeTargetFromFlags`: {@link forgeLiveRuns} with
|
|
38
|
+
* the target's forge, REST base, repository, token and GitLab token header.
|
|
39
|
+
*/
|
|
40
|
+
export declare function forgeTargetLiveRuns(target: Pick<ForgeTarget, "kind" | "apiBase" | "repo" | "token" | "tokenHeader">, fetch?: ForgeFetch): Promise<LiveRun[]>;
|
|
41
|
+
/** What {@link forgeLiveRunsOf} reads the forge from besides the environment. */
|
|
42
|
+
export interface ForgeLiveRunsOptions {
|
|
43
|
+
/**
|
|
44
|
+
* A checkout whose origin remote names the forge (#4920) when the
|
|
45
|
+
* environment names no CI forge and `forge` no repository: its kind, web
|
|
46
|
+
* origin and repository, each under what `forge` gives.
|
|
47
|
+
*/
|
|
48
|
+
cwd?: string;
|
|
49
|
+
/** The remote in `cwd`. Default `origin`. */
|
|
50
|
+
remote?: string;
|
|
51
|
+
fetch?: ForgeFetch;
|
|
52
|
+
/** Reads a remote's URL. Default `git remote get-url`. For tests. */
|
|
53
|
+
remoteUrl?: (cwd: string, remote: string) => string | undefined;
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* The `liveRuns` reader of the forge `forge` names over `env` (#4911),
|
|
57
|
+
* read each time it is called: `forgeTargetWith`'s target (a product's
|
|
58
|
+
* `--forge`, `--repo` and `--url` over the job's environment), and its runs.
|
|
59
|
+
* On a laptop, with no CI variables and no repository given, the origin
|
|
60
|
+
* remote of `opts.cwd` names the forge and the repository (#4920), so a
|
|
61
|
+
* release run there needs only a token. A forge that cannot be named, or a
|
|
62
|
+
* missing token, throws, and the release it guards is refused.
|
|
63
|
+
*/
|
|
64
|
+
export declare function forgeLiveRunsOf(env: Record<string, string | undefined>, forge?: ForgeTargetOptions & ForgeOverrides, opts?: ForgeLiveRunsOptions): () => Promise<LiveRun[]>;
|
|
34
65
|
/** How far a run's start may be after the lock's and still count as a run that could hold it: the clocks of the job and the forge differ. */
|
|
35
66
|
export declare const CLOCK_SKEW_MS: number;
|
|
36
67
|
/** A lock's info, as Terraform's binary writes it and other engines can name it. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"state-unlock.d.ts","sourceRoot":"","sources":["../src/state-unlock.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAW,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"state-unlock.d.ts","sourceRoot":"","sources":["../src/state-unlock.ts"],"names":[],"mappings":"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"}
|
package/dist/state-unlock.js
CHANGED
|
@@ -82,6 +82,37 @@ export async function forgeLiveRuns(t) {
|
|
|
82
82
|
}
|
|
83
83
|
return [...out.values()];
|
|
84
84
|
}
|
|
85
|
+
/**
|
|
86
|
+
* The live runs of a {@link ForgeTarget} (#4911), from `forgeTargetFromEnv`,
|
|
87
|
+
* `forgeTargetWith` or `forgeTargetFromFlags`: {@link forgeLiveRuns} with
|
|
88
|
+
* the target's forge, REST base, repository, token and GitLab token header.
|
|
89
|
+
*/
|
|
90
|
+
export function forgeTargetLiveRuns(target, fetch) {
|
|
91
|
+
return forgeLiveRuns({ kind: target.kind, apiBase: target.apiBase, repo: target.repo, token: target.token, ...(target.tokenHeader ? { tokenHeader: target.tokenHeader } : {}), ...(fetch ? { fetch } : {}) });
|
|
92
|
+
}
|
|
93
|
+
/**
|
|
94
|
+
* The `liveRuns` reader of the forge `forge` names over `env` (#4911),
|
|
95
|
+
* read each time it is called: `forgeTargetWith`'s target (a product's
|
|
96
|
+
* `--forge`, `--repo` and `--url` over the job's environment), and its runs.
|
|
97
|
+
* On a laptop, with no CI variables and no repository given, the origin
|
|
98
|
+
* remote of `opts.cwd` names the forge and the repository (#4920), so a
|
|
99
|
+
* release run there needs only a token. A forge that cannot be named, or a
|
|
100
|
+
* missing token, throws, and the release it guards is refused.
|
|
101
|
+
*/
|
|
102
|
+
export function forgeLiveRunsOf(env, forge = {}, opts = {}) {
|
|
103
|
+
return async () => {
|
|
104
|
+
const [{ forgeTargetWith }, { detectForge }] = await Promise.all([import("./forge-flags.js"), import("./pr-forge.js")]);
|
|
105
|
+
let given = forge;
|
|
106
|
+
if (opts.cwd && !detectForge(env) && !forge.repo?.trim()) {
|
|
107
|
+
const { forgeOfCheckout } = await import("./forge-remote.js");
|
|
108
|
+
const at = forgeOfCheckout(opts.cwd, { ...(opts.remote ? { remote: opts.remote } : {}), ...(forge.kind ? { kind: forge.kind } : {}), ...(opts.remoteUrl ? { remoteUrl: opts.remoteUrl } : {}) });
|
|
109
|
+
const set = Object.fromEntries(Object.entries(forge).filter(([, v]) => v !== undefined && v !== ""));
|
|
110
|
+
if (at)
|
|
111
|
+
given = { kind: at.kind, repo: at.repo, url: at.url, ...set };
|
|
112
|
+
}
|
|
113
|
+
return forgeTargetLiveRuns(forgeTargetWith(env, given), opts.fetch);
|
|
114
|
+
};
|
|
115
|
+
}
|
|
85
116
|
/** How far a run's start may be after the lock's and still count as a run that could hold it: the clocks of the job and the forge differ. */
|
|
86
117
|
export const CLOCK_SKEW_MS = 2 * 60 * 1000;
|
|
87
118
|
/** A lock info's JSON, or undefined when it holds no lock ID. */
|