@intentius/chant 0.124.54 → 0.124.56
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/__fixtures__/estate-ledger.d.ts +13 -0
- package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
- package/dist/__fixtures__/estate-ledger.js +67 -0
- package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
- package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
- package/dist/__fixtures__/oidc-emulator.js +26 -2
- package/dist/__fixtures__/product-words.d.ts +78 -0
- package/dist/__fixtures__/product-words.d.ts.map +1 -0
- package/dist/__fixtures__/product-words.js +43 -0
- package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/dist/__golden__/wave-loop/op-held-on.json +28 -7
- package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/dist/__golden__/wave-loop/op-overridden.json +28 -7
- package/dist/__golden__/wave-loop/op-per-run.json +20 -4
- package/dist/__golden__/wave-loop/op-point.json +18 -4
- package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
- package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/dist/__golden__/wave-loop/op-spend.json +10 -2
- package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/dist/__golden__/wave-loop/op-wide.json +20 -4
- package/dist/bucket-check/azure.d.ts +108 -0
- package/dist/bucket-check/azure.d.ts.map +1 -0
- package/dist/bucket-check/azure.js +258 -0
- package/dist/bucket-check/fixtures/azure.json +153 -0
- package/dist/bucket-check/fixtures/gcs.json +148 -0
- package/dist/bucket-check/fixtures/s3.json +277 -0
- package/dist/bucket-check/gcs.d.ts +77 -0
- package/dist/bucket-check/gcs.d.ts.map +1 -0
- package/dist/bucket-check/gcs.js +202 -0
- package/dist/bucket-check/index.d.ts +48 -0
- package/dist/bucket-check/index.d.ts.map +1 -0
- package/dist/bucket-check/index.js +44 -0
- package/dist/bucket-check/s3.d.ts +116 -0
- package/dist/bucket-check/s3.d.ts.map +1 -0
- package/dist/bucket-check/s3.js +362 -0
- package/dist/bucket-check/types.d.ts +66 -0
- package/dist/bucket-check/types.d.ts.map +1 -0
- package/dist/bucket-check/types.js +31 -0
- package/dist/bucket-check/wire.d.ts +27 -0
- package/dist/bucket-check/wire.d.ts.map +1 -0
- package/dist/bucket-check/wire.js +32 -0
- package/dist/bucket-check.d.ts +6 -0
- package/dist/bucket-check.d.ts.map +1 -0
- package/dist/bucket-check.js +5 -0
- package/dist/capabilities/templates.d.ts.map +1 -1
- package/dist/capabilities/templates.js +1 -2
- package/dist/change-set.d.ts.map +1 -1
- package/dist/change-set.js +2 -3
- package/dist/ci-agent.d.ts +381 -0
- package/dist/ci-agent.d.ts.map +1 -0
- package/dist/ci-agent.js +832 -0
- package/dist/ci-audit/attribution.d.ts +111 -0
- package/dist/ci-audit/attribution.d.ts.map +1 -0
- package/dist/ci-audit/attribution.js +194 -0
- package/dist/ci-audit/audit-log.d.ts +144 -0
- package/dist/ci-audit/audit-log.d.ts.map +1 -0
- package/dist/ci-audit/audit-log.js +149 -0
- package/dist/ci-audit/index.d.ts +12 -0
- package/dist/ci-audit/index.d.ts.map +1 -0
- package/dist/ci-audit/index.js +12 -0
- package/dist/ci-audit/unrecorded.d.ts +74 -0
- package/dist/ci-audit/unrecorded.d.ts.map +1 -0
- package/dist/ci-audit/unrecorded.js +95 -0
- package/dist/ci-audit.d.ts +3 -0
- package/dist/ci-audit.d.ts.map +1 -0
- package/dist/ci-audit.js +2 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +41 -0
- package/dist/ci-estate/delivery.d.ts +137 -0
- package/dist/ci-estate/delivery.d.ts.map +1 -0
- package/dist/ci-estate/delivery.js +311 -0
- package/dist/ci-estate/overdue.d.ts +34 -0
- package/dist/ci-estate/overdue.d.ts.map +1 -0
- package/dist/ci-estate/overdue.js +58 -0
- package/dist/ci-estate/page.d.ts +134 -0
- package/dist/ci-estate/page.d.ts.map +1 -0
- package/dist/ci-estate/page.js +233 -0
- package/dist/ci-estate/rows.d.ts +118 -0
- package/dist/ci-estate/rows.d.ts.map +1 -0
- package/dist/ci-estate/rows.js +126 -0
- package/dist/ci-estate.d.ts +92 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +82 -0
- package/dist/ci-handover.d.ts +29 -5
- package/dist/ci-handover.d.ts.map +1 -1
- package/dist/ci-handover.js +50 -16
- package/dist/ci-identity.d.ts +82 -7
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +86 -15
- package/dist/ci-job-guard.d.ts +139 -0
- package/dist/ci-job-guard.d.ts.map +1 -0
- package/dist/ci-job-guard.js +287 -0
- package/dist/ci-jobs.d.ts +7 -0
- package/dist/ci-jobs.d.ts.map +1 -1
- package/dist/ci-jobs.js +7 -0
- package/dist/ci-product-words.d.ts +296 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +407 -0
- package/dist/ci-product.d.ts +117 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +113 -0
- package/dist/ci-respond-run.d.ts +73 -0
- package/dist/ci-respond-run.d.ts.map +1 -0
- package/dist/ci-respond-run.js +247 -0
- package/dist/ci-respond.d.ts +189 -0
- package/dist/ci-respond.d.ts.map +1 -0
- package/dist/ci-respond.js +285 -0
- package/dist/cli/commands/audit.d.ts +2 -2
- package/dist/cli/commands/audit.d.ts.map +1 -1
- package/dist/cli/commands/audit.js +3 -2
- package/dist/cli/commands/carve.js +2 -2
- package/dist/cli/commands/init.d.ts +2 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +1 -1
- package/dist/cli/handlers/agent.d.ts +17 -0
- package/dist/cli/handlers/agent.d.ts.map +1 -0
- package/dist/cli/handlers/agent.js +114 -0
- package/dist/cli/handlers/approve-confirm.d.ts +84 -0
- package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
- package/dist/cli/handlers/approve-confirm.js +142 -0
- package/dist/cli/handlers/approve.d.ts.map +1 -1
- package/dist/cli/handlers/approve.js +19 -1
- package/dist/cli/handlers/audit-log.d.ts +12 -0
- package/dist/cli/handlers/audit-log.d.ts.map +1 -0
- package/dist/cli/handlers/audit-log.js +81 -0
- package/dist/cli/handlers/build.d.ts +7 -0
- package/dist/cli/handlers/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +124 -1
- package/dist/cli/handlers/ci-check-job.d.ts +11 -0
- package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check-job.js +27 -0
- package/dist/cli/handlers/ci-check.d.ts +3 -0
- package/dist/cli/handlers/ci-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check.js +63 -0
- package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
- package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-forge-check.js +89 -0
- package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
- package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
- package/dist/cli/handlers/e2e-safe-run.js +23 -0
- package/dist/cli/handlers/fan-out.js +4 -0
- package/dist/cli/handlers/gate-pending.d.ts +11 -0
- package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
- package/dist/cli/handlers/gate-pending.js +44 -0
- package/dist/cli/handlers/init.d.ts.map +1 -1
- package/dist/cli/handlers/init.js +1 -0
- package/dist/cli/handlers/ledger.js +1 -1
- package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
- package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
- package/dist/cli/handlers/lifecycle-drift.js +7 -2
- package/dist/cli/handlers/lock.d.ts.map +1 -1
- package/dist/cli/handlers/lock.js +64 -5
- package/dist/cli/handlers/notify-relay.d.ts +15 -0
- package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
- package/dist/cli/handlers/notify-relay.js +130 -0
- package/dist/cli/handlers/pr-env.d.ts.map +1 -1
- package/dist/cli/handlers/pr-env.js +42 -11
- package/dist/cli/handlers/pr.d.ts +43 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +908 -205
- package/dist/cli/handlers/promote.d.ts.map +1 -1
- package/dist/cli/handlers/promote.js +21 -2
- package/dist/cli/handlers/release.d.ts.map +1 -1
- package/dist/cli/handlers/release.js +3 -0
- package/dist/cli/handlers/run-wave.d.ts +8 -0
- package/dist/cli/handlers/run-wave.d.ts.map +1 -1
- package/dist/cli/handlers/run-wave.js +160 -2
- package/dist/cli/handlers/run.d.ts +6 -1
- package/dist/cli/handlers/run.d.ts.map +1 -1
- package/dist/cli/handlers/run.js +86 -1
- package/dist/cli/handlers/serve.d.ts.map +1 -1
- package/dist/cli/handlers/serve.js +10 -1
- package/dist/cli/main.d.ts +11 -1
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +178 -13
- package/dist/cli/mcp/ledger-tools.d.ts +36 -0
- package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
- package/dist/cli/mcp/ledger-tools.js +122 -0
- package/dist/cli/mcp/product-tools.d.ts +78 -0
- package/dist/cli/mcp/product-tools.d.ts.map +1 -0
- package/dist/cli/mcp/product-tools.js +93 -0
- package/dist/cli/mcp/read-only.d.ts +34 -0
- package/dist/cli/mcp/read-only.d.ts.map +1 -0
- package/dist/cli/mcp/read-only.js +61 -0
- package/dist/cli/mcp/report-tools.d.ts +48 -0
- package/dist/cli/mcp/report-tools.d.ts.map +1 -0
- package/dist/cli/mcp/report-tools.js +128 -0
- package/dist/cli/mcp/server.d.ts +28 -1
- package/dist/cli/mcp/server.d.ts.map +1 -1
- package/dist/cli/mcp/server.js +86 -15
- package/dist/cli/mcp-config.d.ts +9 -2
- package/dist/cli/mcp-config.d.ts.map +1 -1
- package/dist/cli/mcp-config.js +8 -3
- package/dist/cli/parse-args.d.ts.map +1 -1
- package/dist/cli/parse-args.js +164 -3
- package/dist/cli/registry.d.ts +73 -0
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.d.ts +42 -7
- package/dist/cloud-lister/sigv4.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.js +72 -22
- package/dist/components/adoption.d.ts +69 -0
- package/dist/components/adoption.d.ts.map +1 -0
- package/dist/components/adoption.js +92 -0
- package/dist/components/apply-lease.d.ts +19 -0
- package/dist/components/apply-lease.d.ts.map +1 -0
- package/dist/components/apply-lease.js +41 -0
- package/dist/components/capability.d.ts +159 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +39 -6
- package/dist/components/check-hooks.d.ts +116 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -0
- package/dist/components/check-steps.d.ts +74 -0
- package/dist/components/check-steps.d.ts.map +1 -0
- package/dist/components/check-steps.js +102 -0
- package/dist/components/ci-services.d.ts +57 -0
- package/dist/components/ci-services.d.ts.map +1 -0
- package/dist/components/ci-services.js +60 -0
- package/dist/components/cli-support.d.ts +13 -0
- package/dist/components/cli-support.d.ts.map +1 -1
- package/dist/components/cli-support.js +10 -2
- package/dist/components/driver.d.ts +32 -3
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +59 -5
- package/dist/components/fan-out-run.d.ts +12 -0
- package/dist/components/fan-out-run.d.ts.map +1 -1
- package/dist/components/fan-out-run.js +56 -16
- package/dist/components/groups.d.ts.map +1 -1
- package/dist/components/groups.js +23 -5
- package/dist/components/pr-env-ledger.d.ts +32 -0
- package/dist/components/pr-env-ledger.d.ts.map +1 -0
- package/dist/components/pr-env-ledger.js +38 -0
- package/dist/components/pr-env-ports.d.ts +12 -0
- package/dist/components/pr-env-ports.d.ts.map +1 -1
- package/dist/components/pr-env-ports.js +13 -3
- package/dist/components/pr-env-run.d.ts +6 -0
- package/dist/components/pr-env-run.d.ts.map +1 -1
- package/dist/components/pr-env-run.js +3 -2
- package/dist/components/pr-environment.d.ts +32 -4
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +26 -8
- package/dist/components/pr-pipeline.d.ts +297 -5
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +329 -18
- package/dist/components/pr-policy.d.ts +26 -2
- package/dist/components/pr-policy.d.ts.map +1 -1
- package/dist/components/pr-policy.js +41 -7
- package/dist/components/pr-run.d.ts +71 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +91 -7
- package/dist/components/pr-targets.d.ts +24 -0
- package/dist/components/pr-targets.d.ts.map +1 -0
- package/dist/components/pr-targets.js +48 -0
- package/dist/components/product-pipeline.d.ts +250 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +212 -0
- package/dist/components/promote.d.ts +6 -0
- package/dist/components/promote.d.ts.map +1 -1
- package/dist/components/promote.js +4 -1
- package/dist/components/release-compile.d.ts +22 -1
- package/dist/components/release-compile.d.ts.map +1 -1
- package/dist/components/release-compile.js +85 -0
- package/dist/components/release-promote.d.ts +15 -1
- package/dist/components/release-promote.d.ts.map +1 -1
- package/dist/components/release-promote.js +67 -2
- package/dist/components/repo-lock.d.ts +27 -0
- package/dist/components/repo-lock.d.ts.map +1 -0
- package/dist/components/repo-lock.js +49 -0
- package/dist/components/row-lease.d.ts +84 -0
- package/dist/components/row-lease.d.ts.map +1 -0
- package/dist/components/row-lease.js +110 -0
- package/dist/components/wave-plan.d.ts +42 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +72 -4
- package/dist/control/applied.d.ts +89 -0
- package/dist/control/applied.d.ts.map +1 -0
- package/dist/control/applied.js +175 -0
- package/dist/control/consumers.d.ts +78 -0
- package/dist/control/consumers.d.ts.map +1 -0
- package/dist/control/consumers.js +172 -0
- package/dist/control/dispatch.d.ts +334 -0
- package/dist/control/dispatch.d.ts.map +1 -0
- package/dist/control/dispatch.js +519 -0
- package/dist/control/edges.d.ts +75 -0
- package/dist/control/edges.d.ts.map +1 -0
- package/dist/control/edges.js +133 -0
- package/dist/control/reconcile.d.ts +120 -0
- package/dist/control/reconcile.d.ts.map +1 -0
- package/dist/control/reconcile.js +178 -0
- package/dist/control/records.d.ts +187 -0
- package/dist/control/records.d.ts.map +1 -0
- package/dist/control/records.js +307 -0
- package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
- package/dist/discovery/sandbox/bundle.js +25 -1
- package/dist/e2e-harness/bucket.d.ts +21 -0
- package/dist/e2e-harness/bucket.d.ts.map +1 -0
- package/dist/e2e-harness/bucket.js +61 -0
- package/dist/e2e-harness/claim.d.ts +70 -0
- package/dist/e2e-harness/claim.d.ts.map +1 -0
- package/dist/e2e-harness/claim.js +98 -0
- package/dist/e2e-harness/driver.d.ts +64 -0
- package/dist/e2e-harness/driver.d.ts.map +1 -0
- package/dist/e2e-harness/driver.js +243 -0
- package/dist/e2e-harness/forgejo.d.ts +77 -0
- package/dist/e2e-harness/forgejo.d.ts.map +1 -0
- package/dist/e2e-harness/forgejo.js +205 -0
- package/dist/e2e-harness/git.d.ts +32 -0
- package/dist/e2e-harness/git.d.ts.map +1 -0
- package/dist/e2e-harness/git.js +67 -0
- package/dist/e2e-harness/index.d.ts +22 -0
- package/dist/e2e-harness/index.d.ts.map +1 -0
- package/dist/e2e-harness/index.js +48 -0
- package/dist/e2e-harness/jobs.d.ts +8 -0
- package/dist/e2e-harness/jobs.d.ts.map +1 -0
- package/dist/e2e-harness/jobs.js +34 -0
- package/dist/e2e-harness/pins.d.ts +45 -0
- package/dist/e2e-harness/pins.d.ts.map +1 -0
- package/dist/e2e-harness/pins.js +44 -0
- package/dist/e2e-harness/ports.d.ts +113 -0
- package/dist/e2e-harness/ports.d.ts.map +1 -0
- package/dist/e2e-harness/ports.js +4 -0
- package/dist/e2e-harness/reports.d.ts +45 -0
- package/dist/e2e-harness/reports.d.ts.map +1 -0
- package/dist/e2e-harness/reports.js +57 -0
- package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
- package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run-cli.js +43 -0
- package/dist/e2e-harness/safe-run.d.ts +61 -0
- package/dist/e2e-harness/safe-run.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run.js +172 -0
- package/dist/e2e-harness/scenario.d.ts +11 -0
- package/dist/e2e-harness/scenario.d.ts.map +1 -0
- package/dist/e2e-harness/scenario.js +89 -0
- package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/dist/e2e-harness/schemas/index.d.ts +191 -0
- package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
- package/dist/e2e-harness/schemas/index.js +62 -0
- package/dist/e2e-harness/stack.d.ts +124 -0
- package/dist/e2e-harness/stack.d.ts.map +1 -0
- package/dist/e2e-harness/stack.js +207 -0
- package/dist/e2e-harness/steps.d.ts +11 -0
- package/dist/e2e-harness/steps.d.ts.map +1 -0
- package/dist/e2e-harness/steps.js +22 -0
- package/dist/e2e-harness.d.ts +3 -0
- package/dist/e2e-harness.d.ts.map +1 -0
- package/dist/e2e-harness.js +2 -0
- package/dist/engine-facts.d.ts.map +1 -1
- package/dist/engine-facts.js +1 -2
- package/dist/exit-codes.d.ts +54 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +55 -0
- package/dist/forge-check/check.d.ts +63 -0
- package/dist/forge-check/check.d.ts.map +1 -0
- package/dist/forge-check/check.js +139 -0
- package/dist/forge-check/contract.d.ts +152 -0
- package/dist/forge-check/contract.d.ts.map +1 -0
- package/dist/forge-check/contract.js +118 -0
- package/dist/forge-check/forge.d.ts +42 -0
- package/dist/forge-check/forge.d.ts.map +1 -0
- package/dist/forge-check/forge.js +338 -0
- package/dist/forge-check/index.d.ts +24 -0
- package/dist/forge-check/index.d.ts.map +1 -0
- package/dist/forge-check/index.js +23 -0
- package/dist/forge-check/pulumi.d.ts +44 -0
- package/dist/forge-check/pulumi.d.ts.map +1 -0
- package/dist/forge-check/pulumi.js +184 -0
- package/dist/forge-check/read-only.d.ts +26 -0
- package/dist/forge-check/read-only.d.ts.map +1 -0
- package/dist/forge-check/read-only.js +53 -0
- package/dist/forge-check/trust.d.ts +94 -0
- package/dist/forge-check/trust.d.ts.map +1 -0
- package/dist/forge-check/trust.js +532 -0
- package/dist/forge-check/types.d.ts +80 -0
- package/dist/forge-check/types.d.ts.map +1 -0
- package/dist/forge-check/types.js +18 -0
- package/dist/forge-check.d.ts +6 -0
- package/dist/forge-check.d.ts.map +1 -0
- package/dist/forge-check.js +5 -0
- package/dist/gate-decision.d.ts +1 -0
- package/dist/gate-decision.d.ts.map +1 -1
- package/dist/gate-decision.js +2 -0
- package/dist/gate-policy.d.ts +47 -1
- package/dist/gate-policy.d.ts.map +1 -1
- package/dist/gate-policy.js +50 -2
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/lexicon.d.ts +152 -6
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.d.ts +24 -0
- package/dist/lifecycle/adoption-file.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.js +1 -2
- package/dist/lifecycle/cloud-index.d.ts.map +1 -1
- package/dist/lifecycle/cloud-index.js +1 -2
- package/dist/lifecycle/gate-applied.d.ts +6 -0
- package/dist/lifecycle/gate-applied.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.d.ts +29 -0
- package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.js +10 -1
- package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
- package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
- package/dist/lifecycle/gate-pending-by-plan.js +96 -0
- package/dist/lifecycle/gated-request-digest.d.ts +28 -0
- package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
- package/dist/lifecycle/gated-request-digest.js +35 -0
- package/dist/lifecycle/gated-request.d.ts +126 -0
- package/dist/lifecycle/gated-request.d.ts.map +1 -0
- package/dist/lifecycle/gated-request.js +204 -0
- package/dist/lifecycle/identity-match.d.ts +15 -0
- package/dist/lifecycle/identity-match.d.ts.map +1 -1
- package/dist/lifecycle/identity-match.js +11 -6
- package/dist/lifecycle/index-diff.d.ts +40 -0
- package/dist/lifecycle/index-diff.d.ts.map +1 -1
- package/dist/lifecycle/index-diff.js +1 -2
- package/dist/lifecycle/index-document.d.ts.map +1 -1
- package/dist/lifecycle/index-document.js +1 -2
- package/dist/lifecycle/index-import.d.ts +4 -1
- package/dist/lifecycle/index-import.d.ts.map +1 -1
- package/dist/lifecycle/index-import.js +29 -32
- package/dist/lifecycle/ledger-read.d.ts.map +1 -1
- package/dist/lifecycle/ledger-read.js +7 -3
- package/dist/lifecycle/lock-rows.d.ts +76 -0
- package/dist/lifecycle/lock-rows.d.ts.map +1 -0
- package/dist/lifecycle/lock-rows.js +140 -0
- package/dist/lifecycle/query.d.ts +50 -3
- package/dist/lifecycle/query.d.ts.map +1 -1
- package/dist/lifecycle/query.js +97 -7
- package/dist/lifecycle/release-catalog-site.d.ts +66 -0
- package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog-site.js +232 -0
- package/dist/lifecycle/release-catalog.d.ts +201 -0
- package/dist/lifecycle/release-catalog.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog.js +198 -0
- package/dist/lifecycle/release-changelog.d.ts +41 -0
- package/dist/lifecycle/release-changelog.d.ts.map +1 -0
- package/dist/lifecycle/release-changelog.js +38 -0
- package/dist/lifecycle/release-cut.d.ts +1 -0
- package/dist/lifecycle/release-cut.d.ts.map +1 -1
- package/dist/lifecycle/release-cut.js +1 -1
- package/dist/lifecycle/release-ledger.d.ts +16 -0
- package/dist/lifecycle/release-ledger.d.ts.map +1 -1
- package/dist/lifecycle/release-ledger.js +9 -0
- package/dist/lifecycle/release-publish.d.ts +43 -22
- package/dist/lifecycle/release-publish.d.ts.map +1 -1
- package/dist/lifecycle/release-read.d.ts.map +1 -1
- package/dist/lifecycle/release-read.js +3 -0
- package/dist/lifecycle/release-status.d.ts +106 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +115 -0
- package/dist/lifecycle/resource-lock.d.ts +120 -0
- package/dist/lifecycle/resource-lock.d.ts.map +1 -0
- package/dist/lifecycle/resource-lock.js +317 -0
- package/dist/lifecycle/retention.d.ts.map +1 -1
- package/dist/lifecycle/retention.js +3 -0
- package/dist/lifecycle/run-ledger.d.ts.map +1 -1
- package/dist/lifecycle/run-ledger.js +9 -1
- package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
- package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store-s3.js +9 -44
- package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store.js +1 -2
- package/dist/lifecycle/target-lock.d.ts +15 -0
- package/dist/lifecycle/target-lock.d.ts.map +1 -1
- package/dist/lifecycle/target-lock.js +25 -10
- package/dist/lifecycle/wave-plans.d.ts +23 -7
- package/dist/lifecycle/wave-plans.d.ts.map +1 -1
- package/dist/lifecycle/wave-plans.js +9 -2
- package/dist/mcp/types.d.ts +7 -0
- package/dist/mcp/types.d.ts.map +1 -1
- package/dist/notify-product.d.ts +43 -0
- package/dist/notify-product.d.ts.map +1 -0
- package/dist/notify-product.js +58 -0
- package/dist/notify-relay.d.ts +197 -0
- package/dist/notify-relay.d.ts.map +1 -0
- package/dist/notify-relay.js +321 -0
- package/dist/notify.d.ts +44 -4
- package/dist/notify.d.ts.map +1 -1
- package/dist/notify.js +77 -14
- package/dist/object-store/azure-blob.d.ts +129 -0
- package/dist/object-store/azure-blob.d.ts.map +1 -0
- package/dist/object-store/azure-blob.js +341 -0
- package/dist/object-store/common.d.ts +108 -0
- package/dist/object-store/common.d.ts.map +1 -0
- package/dist/object-store/common.js +80 -0
- package/dist/object-store/errors.d.ts +28 -0
- package/dist/object-store/errors.d.ts.map +1 -0
- package/dist/object-store/errors.js +21 -0
- package/dist/object-store/from-env.d.ts +18 -0
- package/dist/object-store/from-env.d.ts.map +1 -0
- package/dist/object-store/from-env.js +22 -0
- package/dist/object-store/gcs.d.ts +106 -0
- package/dist/object-store/gcs.d.ts.map +1 -0
- package/dist/object-store/gcs.js +393 -0
- package/dist/object-store/index.d.ts +9 -0
- package/dist/object-store/index.d.ts.map +1 -0
- package/dist/object-store/index.js +8 -0
- package/dist/object-store/s3.d.ts +146 -0
- package/dist/object-store/s3.d.ts.map +1 -0
- package/dist/object-store/s3.js +306 -0
- package/dist/op/activities/converge.d.ts.map +1 -1
- package/dist/op/activities/converge.js +2 -1
- package/dist/op/activities/index.d.ts +1 -1
- package/dist/op/activities/index.d.ts.map +1 -1
- package/dist/op/activities/index.js +1 -1
- package/dist/op/activities/review-agent.d.ts +55 -2
- package/dist/op/activities/review-agent.d.ts.map +1 -1
- package/dist/op/activities/review-agent.js +65 -5
- package/dist/op/approval-status.d.ts +103 -0
- package/dist/op/approval-status.d.ts.map +1 -0
- package/dist/op/approval-status.js +197 -0
- package/dist/op/gate.d.ts +29 -1
- package/dist/op/gate.d.ts.map +1 -1
- package/dist/op/gate.js +59 -23
- package/dist/op/generate-pipeline.d.ts.map +1 -1
- package/dist/op/generate-pipeline.js +7 -1
- package/dist/op/index.d.ts +12 -1
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +7 -1
- package/dist/op/op-waves-after-plan.d.ts +137 -0
- package/dist/op/op-waves-after-plan.d.ts.map +1 -0
- package/dist/op/op-waves-after-plan.js +163 -0
- package/dist/op/op-waves-capability-spec.d.ts +63 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +115 -0
- package/dist/op/op-waves-capability.d.ts +197 -0
- package/dist/op/op-waves-capability.d.ts.map +1 -0
- package/dist/op/op-waves-capability.js +311 -0
- package/dist/op/op-waves-events.d.ts +54 -0
- package/dist/op/op-waves-events.d.ts.map +1 -0
- package/dist/op/op-waves-events.js +122 -0
- package/dist/op/op-waves-notify.d.ts +7 -1
- package/dist/op/op-waves-notify.d.ts.map +1 -1
- package/dist/op/op-waves-notify.js +35 -16
- package/dist/op/op-waves-release-port.d.ts +18 -0
- package/dist/op/op-waves-release-port.d.ts.map +1 -0
- package/dist/op/op-waves-release-port.js +61 -0
- package/dist/op/op-waves-release.d.ts +92 -0
- package/dist/op/op-waves-release.d.ts.map +1 -0
- package/dist/op/op-waves-release.js +96 -0
- package/dist/op/op-waves-run.d.ts +182 -6
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +1076 -44
- package/dist/op/op-waves-stand-down.d.ts +60 -0
- package/dist/op/op-waves-stand-down.d.ts.map +1 -0
- package/dist/op/op-waves-stand-down.js +96 -0
- package/dist/op/op-waves.d.ts +187 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +203 -19
- package/dist/op/runtime.d.ts +95 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +18 -0
- package/dist/op/stage-hooks.d.ts +45 -7
- package/dist/op/stage-hooks.d.ts.map +1 -1
- package/dist/op/stage-hooks.js +61 -3
- package/dist/op/steward-beside.d.ts.map +1 -1
- package/dist/op/steward-beside.js +2 -1
- package/dist/op/types.d.ts +2 -2
- package/dist/op/types.d.ts.map +1 -1
- package/dist/op/types.js +3 -2
- package/dist/otlp-metrics.d.ts +38 -0
- package/dist/otlp-metrics.d.ts.map +1 -0
- package/dist/otlp-metrics.js +82 -0
- package/dist/otlp.d.ts +249 -0
- package/dist/otlp.d.ts.map +1 -0
- package/dist/otlp.js +425 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -0
- package/dist/parallelism.d.ts +17 -0
- package/dist/parallelism.d.ts.map +1 -0
- package/dist/parallelism.js +33 -0
- package/dist/policy-packs.d.ts +69 -0
- package/dist/policy-packs.d.ts.map +1 -0
- package/dist/policy-packs.js +205 -0
- package/dist/policy-source.d.ts +51 -0
- package/dist/policy-source.d.ts.map +1 -0
- package/dist/policy-source.js +102 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +146 -37
- package/dist/pr-loop.d.ts +158 -11
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +302 -44
- package/dist/pr-merge.d.ts +64 -0
- package/dist/pr-merge.d.ts.map +1 -0
- package/dist/pr-merge.js +78 -0
- package/dist/pr-post.d.ts +86 -1
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +141 -5
- package/dist/pr-report-url.d.ts +32 -4
- package/dist/pr-report-url.d.ts.map +1 -1
- package/dist/pr-report-url.js +45 -5
- package/dist/pr-requires.d.ts +13 -2
- package/dist/pr-requires.d.ts.map +1 -1
- package/dist/pr-requires.js +14 -0
- package/dist/release-floors.d.ts +1 -1
- package/dist/release-floors.js +1 -1
- package/dist/run-event.d.ts +26 -1
- package/dist/run-event.d.ts.map +1 -1
- package/dist/run-event.js +3 -1
- package/dist/scheduled-op-cloud.d.ts +32 -0
- package/dist/scheduled-op-cloud.d.ts.map +1 -0
- package/dist/scheduled-op-cloud.js +69 -0
- package/dist/sorted-json.d.ts +10 -0
- package/dist/sorted-json.d.ts.map +1 -0
- package/dist/sorted-json.js +14 -0
- package/dist/terraform/credentials.d.ts +59 -0
- package/dist/terraform/credentials.d.ts.map +1 -0
- package/dist/terraform/credentials.js +149 -0
- package/dist/utils.d.ts +1 -4
- package/dist/utils.d.ts.map +1 -1
- package/dist/utils.js +1 -9
- package/dist/wave-runtime.d.ts +1 -1
- package/dist/wave-runtime.js +2 -2
- package/dist/wave-runtime.mjs +405 -287
- package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
- package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
- package/dist/workspace/ci-lock-grain.d.ts +17 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +21 -0
- package/dist/workspace/ci-run.d.ts +2 -1
- package/dist/workspace/ci-run.d.ts.map +1 -1
- package/dist/workspace/ci-run.js +10 -3
- package/dist/workspace/declaration.d.ts +16 -4
- package/dist/workspace/declaration.d.ts.map +1 -1
- package/dist/workspace/declaration.js +5 -2
- package/dist/workspace/declaration.schema.json +27 -3
- package/dist/workspace/drift-cli.d.ts.map +1 -1
- package/dist/workspace/drift-cli.js +8 -3
- package/dist/workspace/exit-cli.d.ts +1 -1
- package/dist/workspace/exit-cli.d.ts.map +1 -1
- package/dist/workspace/exit-cli.js +2 -1
- package/dist/workspace/import-fetch.d.ts +4 -2
- package/dist/workspace/import-fetch.d.ts.map +1 -1
- package/dist/workspace/import-fetch.js +4 -2
- package/dist/workspace/import-init.d.ts.map +1 -1
- package/dist/workspace/import-init.js +4 -2
- package/dist/workspace/ledger.schema.json +7 -3
- package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
- package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
- package/dist/workspace/lineage-upgrade-cli.js +2 -1
- package/dist/workspace/pr-report.schema.json +79 -3
- package/dist/workspace/promote.d.ts +1 -1
- package/dist/workspace/promote.d.ts.map +1 -1
- package/dist/workspace/promote.js +2 -1
- package/dist/workspace/records-cli.d.ts +2 -2
- package/dist/workspace/records-cli.d.ts.map +1 -1
- package/dist/workspace/records-cli.js +3 -2
- package/dist/workspace/release-catalog.schema.json +277 -0
- package/dist/workspace/run-event.schema.json +18 -1
- package/dist/workspace/work-cli.d.ts +3 -1
- package/dist/workspace/work-cli.d.ts.map +1 -1
- package/dist/workspace/work-cli.js +7 -2
- package/dist/workspace/workspace-run.d.ts.map +1 -1
- package/dist/workspace/workspace-run.js +2 -1
- package/package.json +21 -1
- package/src/__fixtures__/estate-ledger.ts +101 -0
- package/src/__fixtures__/oidc-emulator.ts +31 -2
- package/src/__fixtures__/product-words.ts +44 -0
- package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/src/__golden__/wave-loop/op-held-on.json +28 -7
- package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/src/__golden__/wave-loop/op-overridden.json +28 -7
- package/src/__golden__/wave-loop/op-per-run.json +20 -4
- package/src/__golden__/wave-loop/op-point.json +18 -4
- package/src/__golden__/wave-loop/op-pr-review.json +10 -2
- package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/src/__golden__/wave-loop/op-spend.json +10 -2
- package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/src/__golden__/wave-loop/op-wide.json +20 -4
- package/src/bucket-check/azure.ts +307 -0
- package/src/bucket-check/bucket-check.test.ts +210 -0
- package/src/bucket-check/fixtures/azure.json +153 -0
- package/src/bucket-check/fixtures/gcs.json +148 -0
- package/src/bucket-check/fixtures/s3.json +277 -0
- package/src/bucket-check/gcs.ts +257 -0
- package/src/bucket-check/index.ts +61 -0
- package/src/bucket-check/s3.ts +433 -0
- package/src/bucket-check/types.ts +75 -0
- package/src/bucket-check/wire.ts +50 -0
- package/src/bucket-check.ts +5 -0
- package/src/capabilities/templates.test.ts +2 -3
- package/src/capabilities/templates.ts +1 -2
- package/src/cdk/advise.test.ts +1 -1
- package/src/change-set-bundle.test.ts +0 -1
- package/src/change-set.ts +2 -3
- package/src/ci-agent.test.ts +348 -0
- package/src/ci-agent.ts +1025 -0
- package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
- package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
- package/src/ci-audit/attribution.ts +260 -0
- package/src/ci-audit/audit-log.ts +220 -0
- package/src/ci-audit/ci-audit.test.ts +175 -0
- package/src/ci-audit/index.ts +15 -0
- package/src/ci-audit/unrecorded.ts +140 -0
- package/src/ci-audit.ts +2 -0
- package/src/ci-control.ts +173 -0
- package/src/ci-estate/delivery.ts +433 -0
- package/src/ci-estate/overdue.ts +81 -0
- package/src/ci-estate/page.ts +343 -0
- package/src/ci-estate/rows.ts +251 -0
- package/src/ci-estate.test.ts +281 -0
- package/src/ci-estate.ts +175 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +54 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +3 -1
- package/src/ci-identity.ts +123 -22
- package/src/ci-job-guard.test.ts +154 -0
- package/src/ci-job-guard.ts +319 -0
- package/src/ci-jobs.ts +8 -0
- package/src/ci-product-comment-targets.test.ts +45 -0
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +565 -0
- package/src/ci-product.ts +226 -0
- package/src/ci-respond-run.ts +291 -0
- package/src/ci-respond.test.ts +264 -0
- package/src/ci-respond.ts +412 -0
- package/src/ci-shared-reads.test.ts +145 -0
- package/src/cli/commands/audit.test.ts +1 -1
- package/src/cli/commands/audit.ts +3 -2
- package/src/cli/commands/carve.test.ts +1 -1
- package/src/cli/commands/carve.ts +2 -2
- package/src/cli/commands/init.ts +3 -1
- package/src/cli/component-wave-args.test.ts +16 -0
- package/src/cli/handlers/agent.ts +126 -0
- package/src/cli/handlers/approve-confirm.test.ts +276 -0
- package/src/cli/handlers/approve-confirm.ts +200 -0
- package/src/cli/handlers/approve.ts +18 -1
- package/src/cli/handlers/audit-log.ts +74 -0
- package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
- package/src/cli/handlers/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +113 -1
- package/src/cli/handlers/ci-check-job.test.ts +114 -0
- package/src/cli/handlers/ci-check-job.ts +33 -0
- package/src/cli/handlers/ci-check.ts +63 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -0
- package/src/cli/handlers/e2e-safe-run.ts +27 -0
- package/src/cli/handlers/fan-out.test.ts +10 -10
- package/src/cli/handlers/fan-out.ts +5 -0
- package/src/cli/handlers/gate-pending.ts +46 -0
- package/src/cli/handlers/init.ts +1 -0
- package/src/cli/handlers/ledger.ts +1 -1
- package/src/cli/handlers/lifecycle-drift.ts +7 -2
- package/src/cli/handlers/lock.test.ts +29 -2
- package/src/cli/handlers/lock.ts +66 -6
- package/src/cli/handlers/notify-relay.ts +130 -0
- package/src/cli/handlers/pr-before-merge.test.ts +2 -1
- package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
- package/src/cli/handlers/pr-env.ts +48 -11
- package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
- package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
- package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
- package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
- package/src/cli/handlers/pr-waves.test.ts +8 -2
- package/src/cli/handlers/pr.test.ts +8 -8
- package/src/cli/handlers/pr.ts +879 -205
- package/src/cli/handlers/promote.test.ts +5 -5
- package/src/cli/handlers/promote.ts +22 -2
- package/src/cli/handlers/release.ts +2 -0
- package/src/cli/handlers/run-components-exit.test.ts +7 -7
- package/src/cli/handlers/run-wave.ts +144 -2
- package/src/cli/handlers/run.test.ts +6 -4
- package/src/cli/handlers/run.ts +86 -1
- package/src/cli/handlers/serve.ts +10 -1
- package/src/cli/main.test.ts +1 -1
- package/src/cli/main.ts +180 -13
- package/src/cli/mcp/ledger-tools.ts +126 -0
- package/src/cli/mcp/product-tools.test.ts +123 -0
- package/src/cli/mcp/product-tools.ts +129 -0
- package/src/cli/mcp/read-only.test.ts +134 -0
- package/src/cli/mcp/read-only.ts +68 -0
- package/src/cli/mcp/report-tools.ts +135 -0
- package/src/cli/mcp/server.test.ts +5 -4
- package/src/cli/mcp/server.ts +90 -16
- package/src/cli/mcp-config.ts +8 -3
- package/src/cli/parse-args.ts +119 -2
- package/src/cli/registry.ts +73 -0
- package/src/cloud-lister/sigv4.ts +80 -23
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +140 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability.ts +180 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +255 -0
- package/src/components/check-steps.test.ts +70 -0
- package/src/components/check-steps.ts +158 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +82 -0
- package/src/components/cli-support.ts +23 -2
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +73 -6
- package/src/components/fan-out-run.ts +68 -18
- package/src/components/groups.ts +21 -4
- package/src/components/plan-flags.test.ts +46 -0
- package/src/components/pr-comment-preview-targets.test.ts +34 -0
- package/src/components/pr-comment-preview.test.ts +54 -0
- package/src/components/pr-env-ledger.test.ts +9 -0
- package/src/components/pr-env-ledger.ts +42 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +2 -14
- package/src/components/pr-env-run.test.ts +19 -0
- package/src/components/pr-env-run.ts +12 -2
- package/src/components/pr-environment.test.ts +29 -0
- package/src/components/pr-environment.ts +40 -8
- package/src/components/pr-pipeline-runners.test.ts +80 -0
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +498 -18
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +1 -1
- package/src/components/pr-run.ts +138 -11
- package/src/components/pr-stale-job.test.ts +34 -0
- package/src/components/pr-targets.test.ts +35 -0
- package/src/components/pr-targets.ts +45 -0
- package/src/components/product-pipeline.test.ts +200 -0
- package/src/components/product-pipeline.ts +383 -0
- package/src/components/promote.ts +10 -1
- package/src/components/release-compile.ts +87 -1
- package/src/components/release-promote.ts +65 -1
- package/src/components/repo-lock.ts +52 -0
- package/src/components/row-lease.test.ts +490 -0
- package/src/components/row-lease.ts +167 -0
- package/src/components/wave-plan-policy.test.ts +19 -0
- package/src/components/wave-plan.ts +96 -6
- package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
- package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
- package/src/control/applied.test.ts +148 -0
- package/src/control/applied.ts +191 -0
- package/src/control/consumers.test.ts +129 -0
- package/src/control/consumers.ts +192 -0
- package/src/control/control.test.ts +302 -0
- package/src/control/dispatch.ts +699 -0
- package/src/control/edges.test.ts +112 -0
- package/src/control/edges.ts +164 -0
- package/src/control/note-checkout.test.ts +91 -0
- package/src/control/reconcile.ts +250 -0
- package/src/control/records.ts +395 -0
- package/src/discovery/sandbox/bundle.ts +25 -1
- package/src/e2e-harness/__project__/chant.config.ts +4 -0
- package/src/e2e-harness/__project__/src/compose.ts +33 -0
- package/src/e2e-harness/bucket.ts +69 -0
- package/src/e2e-harness/claim.test.ts +150 -0
- package/src/e2e-harness/claim.ts +140 -0
- package/src/e2e-harness/driver.test.ts +304 -0
- package/src/e2e-harness/driver.ts +294 -0
- package/src/e2e-harness/forgejo.ts +267 -0
- package/src/e2e-harness/git.ts +96 -0
- package/src/e2e-harness/index.ts +50 -0
- package/src/e2e-harness/jobs.ts +35 -0
- package/src/e2e-harness/pins.ts +52 -0
- package/src/e2e-harness/ports.ts +130 -0
- package/src/e2e-harness/reports.ts +79 -0
- package/src/e2e-harness/safe-run-cli.test.ts +102 -0
- package/src/e2e-harness/safe-run-cli.ts +54 -0
- package/src/e2e-harness/safe-run.ts +198 -0
- package/src/e2e-harness/scenario.ts +89 -0
- package/src/e2e-harness/schemas/README.md +62 -0
- package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/src/e2e-harness/schemas/index.ts +220 -0
- package/src/e2e-harness/schemas.test.ts +145 -0
- package/src/e2e-harness/stack.test.ts +124 -0
- package/src/e2e-harness/stack.ts +306 -0
- package/src/e2e-harness/steps.ts +30 -0
- package/src/e2e-harness.ts +2 -0
- package/src/engine-facts.test.ts +2 -3
- package/src/engine-facts.ts +1 -2
- package/src/exit-codes.test.ts +32 -0
- package/src/exit-codes.ts +61 -0
- package/src/forge-check/check.ts +155 -0
- package/src/forge-check/contract.ts +215 -0
- package/src/forge-check/forge-check.test.ts +427 -0
- package/src/forge-check/forge.ts +318 -0
- package/src/forge-check/index.ts +43 -0
- package/src/forge-check/pulumi.ts +192 -0
- package/src/forge-check/read-only.ts +56 -0
- package/src/forge-check/trust.ts +527 -0
- package/src/forge-check/types.ts +78 -0
- package/src/forge-check.ts +5 -0
- package/src/gate-decision-bundle.test.ts +11 -0
- package/src/gate-decision.ts +3 -0
- package/src/gate-policy.ts +92 -3
- package/src/gated-waves-bundle.test.ts +0 -1
- package/src/index.ts +2 -0
- package/src/lexicon.ts +143 -6
- package/src/lifecycle/adoption-file.ts +1 -2
- package/src/lifecycle/cloud-index.test.ts +2 -3
- package/src/lifecycle/cloud-index.ts +1 -2
- package/src/lifecycle/control-entries-ledger.test.ts +69 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +35 -1
- package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
- package/src/lifecycle/gate-pending-by-plan.ts +133 -0
- package/src/lifecycle/gated-request-digest.ts +49 -0
- package/src/lifecycle/gated-request-ledger.test.ts +53 -0
- package/src/lifecycle/gated-request.ts +279 -0
- package/src/lifecycle/identity-match.ts +25 -6
- package/src/lifecycle/index-diff.ts +1 -2
- package/src/lifecycle/index-document.ts +1 -2
- package/src/lifecycle/index-import.test.ts +14 -0
- package/src/lifecycle/index-import.ts +54 -34
- package/src/lifecycle/ledger-read.ts +7 -3
- package/src/lifecycle/lock-rows.test.ts +109 -0
- package/src/lifecycle/lock-rows.ts +167 -0
- package/src/lifecycle/publish-target-context.test.ts +108 -0
- package/src/lifecycle/query.test.ts +2 -3
- package/src/lifecycle/query.ts +109 -8
- package/src/lifecycle/release-catalog-site.test.ts +142 -0
- package/src/lifecycle/release-catalog-site.ts +291 -0
- package/src/lifecycle/release-catalog.test.ts +192 -0
- package/src/lifecycle/release-catalog.ts +353 -0
- package/src/lifecycle/release-changelog.test.ts +70 -0
- package/src/lifecycle/release-changelog.ts +71 -0
- package/src/lifecycle/release-cut.ts +2 -2
- package/src/lifecycle/release-ledger.ts +19 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +185 -0
- package/src/lifecycle/release-status.ts +175 -0
- package/src/lifecycle/resource-lock.test.ts +175 -0
- package/src/lifecycle/resource-lock.ts +354 -0
- package/src/lifecycle/retention.ts +2 -0
- package/src/lifecycle/run-ledger.ts +7 -1
- package/src/lifecycle/snapshot-store-s3.ts +9 -45
- package/src/lifecycle/snapshot-store.ts +1 -2
- package/src/lifecycle/target-lock.ts +24 -9
- package/src/lifecycle/wave-plans.ts +33 -5
- package/src/mcp/types.ts +7 -0
- package/src/notify-product.ts +76 -0
- package/src/notify-relay.test.ts +213 -0
- package/src/notify-relay.ts +407 -0
- package/src/notify.ts +95 -14
- package/src/object-store/azure-blob.ts +374 -0
- package/src/object-store/common.ts +133 -0
- package/src/object-store/errors.ts +26 -0
- package/src/object-store/from-env.ts +36 -0
- package/src/object-store/gcs.ts +436 -0
- package/src/object-store/index.ts +8 -0
- package/src/object-store/object-store.test.ts +130 -0
- package/src/object-store/s3.ts +350 -0
- package/src/op/activities/converge.ts +2 -1
- package/src/op/activities/index.ts +1 -1
- package/src/op/activities/review-agent.open.test.ts +78 -0
- package/src/op/activities/review-agent.test.ts +13 -0
- package/src/op/activities/review-agent.ts +89 -5
- package/src/op/approval-status.test.ts +134 -0
- package/src/op/approval-status.ts +235 -0
- package/src/op/gate-review.test.ts +2 -1
- package/src/op/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +23 -0
- package/src/op/op-waves-after-plan.test.ts +288 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +133 -0
- package/src/op/op-waves-capability.test.ts +217 -0
- package/src/op/op-waves-capability.ts +370 -0
- package/src/op/op-waves-events.ts +135 -0
- package/src/op/op-waves-notify-words.test.ts +149 -0
- package/src/op/op-waves-notify.ts +41 -16
- package/src/op/op-waves-parallelism.test.ts +89 -0
- package/src/op/op-waves-pull-request.test.ts +219 -0
- package/src/op/op-waves-release-port.ts +64 -0
- package/src/op/op-waves-release.test.ts +209 -0
- package/src/op/op-waves-release.ts +132 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1235 -52
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +107 -0
- package/src/op/op-waves-trace.test.ts +205 -0
- package/src/op/op-waves.test.ts +112 -0
- package/src/op/op-waves.ts +320 -22
- package/src/op/runtime.ts +107 -0
- package/src/op/stage-hooks-hold-record.test.ts +41 -0
- package/src/op/stage-hooks.ts +91 -12
- package/src/op/steward-beside.ts +2 -1
- package/src/op/types.ts +3 -2
- package/src/otlp-metrics.ts +96 -0
- package/src/otlp.test.ts +243 -0
- package/src/otlp.ts +543 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/parallelism.test.ts +38 -0
- package/src/parallelism.ts +33 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +111 -0
- package/src/pr-forge-bundle.test.ts +1 -1
- package/src/pr-forge.ts +175 -33
- package/src/pr-loop-bundle.test.ts +7 -3
- package/src/pr-loop-narrowed.test.ts +63 -0
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.ts +398 -52
- package/src/pr-merge.test.ts +100 -0
- package/src/pr-merge.ts +105 -0
- package/src/pr-post-stale.test.ts +163 -0
- package/src/pr-post.ts +190 -5
- package/src/pr-report-url.ts +61 -6
- package/src/pr-requires.test.ts +37 -1
- package/src/pr-requires.ts +16 -2
- package/src/product-subpaths-plain-node.e2e.test.ts +212 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +28 -1
- package/src/scheduled-op-cloud.ts +68 -0
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +6 -0
- package/src/terraform/credentials.test.ts +77 -0
- package/src/terraform/credentials.ts +162 -0
- package/src/utils.ts +2 -11
- package/src/wave-loop-golden.test.ts +2 -1
- package/src/wave-runtime.ts +2 -2
- package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
- package/src/workspace/ci-lock-grain.test.ts +31 -0
- package/src/workspace/ci-lock-grain.ts +29 -0
- package/src/workspace/ci-report-url.test.ts +1 -1
- package/src/workspace/ci-run.test.ts +1 -1
- package/src/workspace/ci-run.ts +10 -3
- package/src/workspace/declaration.schema.json +27 -3
- package/src/workspace/declaration.test.ts +1 -1
- package/src/workspace/declaration.ts +26 -10
- package/src/workspace/drift-cli.ts +8 -3
- package/src/workspace/exit-cli.ts +2 -1
- package/src/workspace/import-fetch.ts +4 -2
- package/src/workspace/import-init.ts +4 -2
- package/src/workspace/ledger.schema.json +7 -3
- package/src/workspace/lineage-upgrade-cli.ts +2 -1
- package/src/workspace/pr-report.schema.json +79 -3
- package/src/workspace/promote.ts +2 -1
- package/src/workspace/records-cli.ts +3 -2
- package/src/workspace/release-catalog.schema.json +277 -0
- package/src/workspace/run-event.schema.json +18 -1
- package/src/workspace/work-cli.ts +8 -2
- package/src/workspace/workspace-run.ts +2 -1
|
@@ -0,0 +1,100 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* #4636: `pr-apply --before-merge --merge auto` merges the pull request once
|
|
3
|
+
* its update applied and the records are pushed, with the head checked
|
|
4
|
+
* again, on fake GitHub, GitLab and Forgejo forges. A refusal is posted and
|
|
5
|
+
* never applies again.
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import { describe, expect, test } from "vitest";
|
|
9
|
+
import { parseArgs } from "./cli/parse-args";
|
|
10
|
+
import { prLoopJobs } from "./components/pr-pipeline";
|
|
11
|
+
import { ciLoopOptions } from "./workspace/ci-run";
|
|
12
|
+
import { mergeAfterApply, mergeTokenEnv, prMergeMarker } from "./pr-merge";
|
|
13
|
+
import type { MergeOptions, MergeResult, PullRequestHead } from "./pr-forge";
|
|
14
|
+
|
|
15
|
+
const HEAD = "a".repeat(40);
|
|
16
|
+
|
|
17
|
+
function fakeForge(kind: "github" | "gitlab" | "forgejo", o: { head?: PullRequestHead; merge?: MergeResult | Error } = {}) {
|
|
18
|
+
const merges: Array<{ pr: number; opts: MergeOptions }> = [];
|
|
19
|
+
const comments: Array<{ pr: number; marker: string; body: string }> = [];
|
|
20
|
+
const forge = {
|
|
21
|
+
kind,
|
|
22
|
+
async pullRequestHead() {
|
|
23
|
+
return o.head ?? { sha: HEAD, branch: "feature", open: true, sameRepo: true };
|
|
24
|
+
},
|
|
25
|
+
async mergePullRequest(pr: number, opts: MergeOptions) {
|
|
26
|
+
merges.push({ pr, opts });
|
|
27
|
+
if (o.merge instanceof Error) throw o.merge;
|
|
28
|
+
return o.merge ?? { merged: true, sha: "b".repeat(40) };
|
|
29
|
+
},
|
|
30
|
+
async upsertComment(pr: number, marker: string, body: string) {
|
|
31
|
+
comments.push({ pr, marker, body });
|
|
32
|
+
return { action: "created" as const, id: 1 };
|
|
33
|
+
},
|
|
34
|
+
};
|
|
35
|
+
return { forge, merges, comments };
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
const pushed = { pushed: true };
|
|
39
|
+
|
|
40
|
+
describe("the merge after an update before merge (#4636)", () => {
|
|
41
|
+
for (const kind of ["github", "gitlab", "forgejo"] as const) {
|
|
42
|
+
test(`merges only the head that applied, once the records are pushed (${kind})`, async () => {
|
|
43
|
+
const { forge, merges, comments } = fakeForge(kind);
|
|
44
|
+
expect(await mergeAfterApply({ forge, pr: 7, head: HEAD, method: "squash", recorded: pushed })).toEqual({ merged: true, sha: "b".repeat(40) });
|
|
45
|
+
expect(merges).toEqual([{ pr: 7, opts: { sha: HEAD, method: "squash" } }]);
|
|
46
|
+
expect(comments).toEqual([]);
|
|
47
|
+
});
|
|
48
|
+
|
|
49
|
+
test(`a refused merge posts the reason and is never retried (${kind})`, async () => {
|
|
50
|
+
const { forge, merges, comments } = fakeForge(kind, { merge: { merged: false, reason: 'Required status check "ci" is expected' } });
|
|
51
|
+
const r = await mergeAfterApply({ forge, pr: 7, head: HEAD, recorded: pushed });
|
|
52
|
+
expect(r).toMatchObject({ merged: false, posted: true, reason: expect.stringContaining("Required status check") });
|
|
53
|
+
expect(merges).toHaveLength(1);
|
|
54
|
+
expect(comments[0]).toMatchObject({ pr: 7, marker: prMergeMarker(7) });
|
|
55
|
+
expect(comments[0]!.body).toContain("stays applied and recorded; it is never applied again to merge");
|
|
56
|
+
});
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
test("a new push since the apply, a closed pull request, or records that did not land stop the merge before it is asked", async () => {
|
|
60
|
+
const moved = fakeForge("github", { head: { sha: "c".repeat(40), branch: "feature", open: true, sameRepo: true } });
|
|
61
|
+
expect(await mergeAfterApply({ forge: moved.forge, pr: 7, head: HEAD, recorded: pushed })).toMatchObject({ merged: false, reason: expect.stringContaining("not aaaaaaaaaaaa, the commit that applied") });
|
|
62
|
+
expect(moved.merges).toEqual([]);
|
|
63
|
+
const closed = fakeForge("forgejo", { head: { sha: HEAD, branch: "feature", open: false, sameRepo: true } });
|
|
64
|
+
expect((await mergeAfterApply({ forge: closed.forge, pr: 7, head: HEAD, recorded: pushed })).reason).toBe("it is no longer open");
|
|
65
|
+
const unpushed = fakeForge("gitlab");
|
|
66
|
+
const r = await mergeAfterApply({ forge: unpushed.forge, pr: 7, head: HEAD, recorded: { pushed: false, warning: "chant/lifecycle has no remote" } });
|
|
67
|
+
expect(r.reason).toContain("records are not on the ledger's remote (chant/lifecycle has no remote)");
|
|
68
|
+
expect(unpushed.merges).toEqual([]);
|
|
69
|
+
expect(unpushed.comments[0]!.body).toContain("Merge request !7 was not merged");
|
|
70
|
+
});
|
|
71
|
+
|
|
72
|
+
test("a forge error is a refusal, posted", async () => {
|
|
73
|
+
const { forge, comments } = fakeForge("github", { merge: new Error("500 Internal Server Error") });
|
|
74
|
+
expect(await mergeAfterApply({ forge, pr: 7, head: HEAD, recorded: pushed })).toMatchObject({ merged: false, posted: true });
|
|
75
|
+
expect(comments).toHaveLength(1);
|
|
76
|
+
});
|
|
77
|
+
|
|
78
|
+
test("the merge client holds the named token and no other", () => {
|
|
79
|
+
const env = mergeTokenEnv("PLYWOOD_MERGE_TOKEN", { GITHUB_TOKEN: "job", CHANT_FORGE_TOKEN: "plan", PLYWOOD_MERGE_TOKEN: "merge", GITHUB_REPOSITORY: "acme/infra" });
|
|
80
|
+
expect(env).toEqual({ CHANT_FORGE_TOKEN: "merge", PLYWOOD_MERGE_TOKEN: "merge", GITHUB_REPOSITORY: "acme/infra" });
|
|
81
|
+
expect(mergeTokenEnv("PLYWOOD_MERGE_TOKEN", {})).toEqual({ error: expect.stringContaining("not set") });
|
|
82
|
+
});
|
|
83
|
+
});
|
|
84
|
+
|
|
85
|
+
describe("the pipeline carries --merge auto (#4636)", () => {
|
|
86
|
+
test("the apply before merge job runs with the merge flags and maps the secret on GitHub", () => {
|
|
87
|
+
const [, apply] = prLoopJobs("github", "prod", { applyBeforeMerge: true, applyMerge: { tokenEnv: "PLYWOOD_MERGE_TOKEN", method: "squash" } });
|
|
88
|
+
expect(apply!.command).toContain("pr-apply --before-merge --merge auto --merge-token-env PLYWOOD_MERGE_TOKEN --merge-method squash");
|
|
89
|
+
expect(apply!.run.command).toContain("--apply-before-merge --merge auto --merge-token-env PLYWOOD_MERGE_TOKEN --merge-method squash");
|
|
90
|
+
expect(apply!.env.PLYWOOD_MERGE_TOKEN).toBe("${{ secrets.PLYWOOD_MERGE_TOKEN }}");
|
|
91
|
+
const [, gitlab] = prLoopJobs("gitlab", "prod", { applyBeforeMerge: true, applyMerge: { tokenEnv: "PLYWOOD_MERGE_TOKEN" } });
|
|
92
|
+
expect(gitlab!.env.PLYWOOD_MERGE_TOKEN).toBeUndefined();
|
|
93
|
+
expect(() => prLoopJobs("github", "prod", { applyMerge: { tokenEnv: "X" } })).toThrow(/apply-before-merge/);
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
test("chant ci run apply passes the flags on to pr-apply", () => {
|
|
97
|
+
const args = parseArgs(["ci", "run", "apply", "--apply-before-merge", "--merge", "auto", "--merge-token-env", "PLYWOOD_MERGE_TOKEN"]);
|
|
98
|
+
expect(ciLoopOptions(args).applyMerge).toEqual({ tokenEnv: "PLYWOOD_MERGE_TOKEN" });
|
|
99
|
+
});
|
|
100
|
+
});
|
package/src/pr-merge.ts
ADDED
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Auto merge after an update before merge (#4636): `pr-apply --before-merge
|
|
3
|
+
* --merge auto --merge-token-env <VAR>` merges the pull request once every
|
|
4
|
+
* member applied and the apply's records are on the ledger's remote.
|
|
5
|
+
*
|
|
6
|
+
* The merge is a second step after the apply, and never a reason to apply
|
|
7
|
+
* again:
|
|
8
|
+
*
|
|
9
|
+
* - The records come first. The apply's release records and gate facts are
|
|
10
|
+
* pushed to `chant/lifecycle`; a push that did not land leaves the pull
|
|
11
|
+
* request open with the reason posted.
|
|
12
|
+
* - The head is checked again. The pull request must still be open at the
|
|
13
|
+
* commit that applied, and the forge's merge is asked to merge only that
|
|
14
|
+
* commit, so a push after the apply is never merged unapplied.
|
|
15
|
+
* - A refusal (branch protection, a new push, a conflict, a closed pull
|
|
16
|
+
* request) is posted on the pull request in one comment the next attempt
|
|
17
|
+
* edits, and the apply stays as it was recorded.
|
|
18
|
+
* - The merge's forge client holds the token `--merge-token-env` names and
|
|
19
|
+
* no other: never the plan job's token, nor the apply job's own. On GitLab
|
|
20
|
+
* the variable is a protected one.
|
|
21
|
+
*/
|
|
22
|
+
|
|
23
|
+
import { activeProductWords, type CiProductWords } from "./ci-product-words";
|
|
24
|
+
import type { MergeOptions, PrForge } from "./pr-forge";
|
|
25
|
+
|
|
26
|
+
/** How a pull request applied before merge gets merged. */
|
|
27
|
+
export type PrApplyMerge = "manual" | "auto";
|
|
28
|
+
|
|
29
|
+
export const PR_APPLY_MERGES: readonly PrApplyMerge[] = ["manual", "auto"];
|
|
30
|
+
|
|
31
|
+
export type PrMergeMethod = NonNullable<MergeOptions["method"]>;
|
|
32
|
+
|
|
33
|
+
export const PR_MERGE_METHODS: readonly PrMergeMethod[] = ["merge", "squash", "rebase"];
|
|
34
|
+
|
|
35
|
+
/** The marker of the comment a refused merge posts. */
|
|
36
|
+
export function prMergeMarker(pr: number): string {
|
|
37
|
+
return `<!-- chant:merge:${pr} -->`;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** What {@link mergeAfterApply} did. */
|
|
41
|
+
export interface MergeAfterApply {
|
|
42
|
+
merged: boolean;
|
|
43
|
+
/** The merge commit, when the forge says. */
|
|
44
|
+
sha?: string;
|
|
45
|
+
/** Why it was not merged. */
|
|
46
|
+
reason?: string;
|
|
47
|
+
/** The refusal was posted on the pull request. */
|
|
48
|
+
posted?: boolean;
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
export interface MergeAfterApplyInput {
|
|
52
|
+
/** The client built from the merge token alone. */
|
|
53
|
+
forge: Pick<PrForge, "kind" | "mergePullRequest" | "pullRequestHead" | "upsertComment">;
|
|
54
|
+
pr: number;
|
|
55
|
+
/** The commit that applied. */
|
|
56
|
+
head: string;
|
|
57
|
+
method?: PrMergeMethod;
|
|
58
|
+
/** Whether the apply's records reached the ledger's remote, and why not. */
|
|
59
|
+
recorded: { pushed: boolean; warning?: string };
|
|
60
|
+
words?: CiProductWords;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
const short = (sha: string): string => sha.slice(0, 12);
|
|
64
|
+
|
|
65
|
+
/** Merge the pull request after its update applied. Never throws; a refusal is posted and returned. */
|
|
66
|
+
export async function mergeAfterApply(i: MergeAfterApplyInput): Promise<MergeAfterApply> {
|
|
67
|
+
const words = i.words ?? activeProductWords();
|
|
68
|
+
const what = i.forge.kind === "gitlab" ? `Merge request !${i.pr}` : `Pull request ${i.pr}`;
|
|
69
|
+
const refuse = async (reason: string): Promise<MergeAfterApply> => {
|
|
70
|
+
const body = `${prMergeMarker(i.pr)}\n${what} was not merged: ${reason}. The ${words.verbs.apply[0]} of ${short(i.head)} stays applied and recorded; it is never applied again to merge. Merge it by hand once the reason is gone, or ${words.verbs.apply[0]} again after a new push.\n`;
|
|
71
|
+
try {
|
|
72
|
+
await i.forge.upsertComment(i.pr, prMergeMarker(i.pr), body);
|
|
73
|
+
return { merged: false, reason, posted: true };
|
|
74
|
+
} catch {
|
|
75
|
+
return { merged: false, reason, posted: false };
|
|
76
|
+
}
|
|
77
|
+
};
|
|
78
|
+
if (!i.recorded.pushed) return refuse(`the ${words.verbs.apply[0]}'s records are not on the ledger's remote${i.recorded.warning ? ` (${i.recorded.warning})` : ""}`);
|
|
79
|
+
try {
|
|
80
|
+
if (i.forge.pullRequestHead) {
|
|
81
|
+
const now = await i.forge.pullRequestHead(i.pr);
|
|
82
|
+
if (!now) return refuse("the forge could not say its head");
|
|
83
|
+
if (!now.open) return refuse("it is no longer open");
|
|
84
|
+
if (now.sha !== i.head) return refuse(`its head is ${short(now.sha)} now, not ${short(i.head)}, the commit that applied`);
|
|
85
|
+
}
|
|
86
|
+
const merged = await i.forge.mergePullRequest(i.pr, { sha: i.head, ...(i.method ? { method: i.method } : {}) });
|
|
87
|
+
if (!merged.merged) return refuse(merged.reason ?? "the forge refused the merge");
|
|
88
|
+
return { merged: true, ...(merged.sha ? { sha: merged.sha } : {}) };
|
|
89
|
+
} catch (err) {
|
|
90
|
+
return refuse(`the forge answered ${err instanceof Error ? err.message : String(err)}`);
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* The environment a merge client reads its token from: the job's, with the
|
|
96
|
+
* named variable as the only token and every other forge token left out.
|
|
97
|
+
*/
|
|
98
|
+
export function mergeTokenEnv(tokenEnv: string, env: Record<string, string | undefined> = process.env): Record<string, string | undefined> | { error: string } {
|
|
99
|
+
const token = env[tokenEnv]?.trim();
|
|
100
|
+
if (!token) return { error: `--merge-token-env names ${tokenEnv}, which is not set in this job` };
|
|
101
|
+
const out: Record<string, string | undefined> = { ...env };
|
|
102
|
+
for (const name of ["CHANT_FORGE_TOKEN", "GITHUB_TOKEN", "GH_TOKEN", "GITLAB_TOKEN", "CI_JOB_TOKEN", "FORGEJO_TOKEN", "CHANT_GITHUB_TOKEN", "CHANT_GITLAB_TOKEN", "CHANT_FORGEJO_TOKEN"]) delete out[name];
|
|
103
|
+
out.CHANT_FORGE_TOKEN = token;
|
|
104
|
+
return out;
|
|
105
|
+
}
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The job summary and stale marking (#4628), with fake forges: the note job
|
|
3
|
+
* adds the note to GITHUB_STEP_SUMMARY without its hidden lines, the note
|
|
4
|
+
* carries the target branch's commit it was posted against, and after a
|
|
5
|
+
* push `markStaleNotes` marks each open pull request's note posted against
|
|
6
|
+
* another commit stale, names the comment that previews again and sets the
|
|
7
|
+
* plan status back to pending, on GitHub, GitLab and Forgejo. Written for
|
|
8
|
+
* the ci-products post-merge pass.
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
|
|
12
|
+
import { tmpdir } from "node:os";
|
|
13
|
+
import { join } from "node:path";
|
|
14
|
+
import { afterAll, describe, expect, test } from "vitest";
|
|
15
|
+
import { markStaleNotes, planNoteSummary, postPlanReport, prNoteStaleMarker, prNoteTipMarker } from "./pr-post";
|
|
16
|
+
import { prNoteMarker, type PrReport } from "./pr-loop";
|
|
17
|
+
import { assertProductWords } from "./ci-product-words";
|
|
18
|
+
import { PLYWOOD } from "./__fixtures__/product-words";
|
|
19
|
+
import type { ForgeKind, ForgeStatus, OpenPullRequest, PrForge } from "./pr-forge";
|
|
20
|
+
|
|
21
|
+
const REPORT = JSON.parse(readFileSync(join(import.meta.dirname, "__fixtures__", "pr-loop", "pr-plan.golden.json"), "utf-8")) as PrReport;
|
|
22
|
+
const OLD = "a".repeat(40);
|
|
23
|
+
const NEW = "b".repeat(40);
|
|
24
|
+
const dirs: string[] = [];
|
|
25
|
+
afterAll(() => {
|
|
26
|
+
for (const d of dirs) rmSync(d, { recursive: true, force: true });
|
|
27
|
+
});
|
|
28
|
+
const scratch = (): string => {
|
|
29
|
+
const d = mkdtempSync(join(tmpdir(), "chant-pr-stale-"));
|
|
30
|
+
dirs.push(d);
|
|
31
|
+
return d;
|
|
32
|
+
};
|
|
33
|
+
|
|
34
|
+
/** A forge that keeps notes by marker, lists open pull requests and records statuses. */
|
|
35
|
+
function fakeForge(kind: ForgeKind, open: OpenPullRequest[] = []) {
|
|
36
|
+
const notes = new Map<string, string>();
|
|
37
|
+
const statuses: Array<{ sha: string; status: ForgeStatus }> = [];
|
|
38
|
+
const key = (pr: number, marker: string) => `${pr}\u0000${marker}`;
|
|
39
|
+
const forge = {
|
|
40
|
+
kind,
|
|
41
|
+
host: kind === "gitlab" ? "gitlab.com" : kind === "forgejo" ? "codeberg.org" : "github.com",
|
|
42
|
+
async setStatus(sha: string, status: ForgeStatus) {
|
|
43
|
+
statuses.push({ sha, status });
|
|
44
|
+
},
|
|
45
|
+
async upsertNote(pr: number, marker: string, body: string) {
|
|
46
|
+
notes.set(key(pr, marker), body);
|
|
47
|
+
return "1";
|
|
48
|
+
},
|
|
49
|
+
async findComment(pr: number, marker: string) {
|
|
50
|
+
const body = notes.get(key(pr, marker));
|
|
51
|
+
return body === undefined ? undefined : { id: 1, body };
|
|
52
|
+
},
|
|
53
|
+
async openPullRequests(base: string) {
|
|
54
|
+
return open.filter((p) => p.base === base);
|
|
55
|
+
},
|
|
56
|
+
} as unknown as PrForge;
|
|
57
|
+
return { forge, notes, statuses, key };
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
const pr = (number: number, headSha = "c".repeat(40)): OpenPullRequest => ({ number, head: `feature-${number}`, headSha, base: "main", fork: false });
|
|
61
|
+
|
|
62
|
+
describe("the job summary (#4628)", () => {
|
|
63
|
+
test("the note job adds the note, without its hidden lines, to the summary file", async () => {
|
|
64
|
+
const dir = scratch();
|
|
65
|
+
writeFileSync(join(dir, "pr-plan.json"), JSON.stringify(REPORT));
|
|
66
|
+
const summary = join(dir, "summary.md");
|
|
67
|
+
writeFileSync(summary, "earlier\n");
|
|
68
|
+
const { forge } = fakeForge("github");
|
|
69
|
+
const r = await postPlanReport({ forge, dir, pr: REPORT.pr!, head: REPORT.head, env: REPORT.env, baseTip: OLD, summaryFile: summary });
|
|
70
|
+
expect(r.warnings).toEqual([]);
|
|
71
|
+
const text = readFileSync(summary, "utf-8");
|
|
72
|
+
expect(text.startsWith("earlier\n")).toBe(true);
|
|
73
|
+
expect(text).toContain("### chant plan for `prod`");
|
|
74
|
+
expect(text).not.toContain("<!-- chant-pr");
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
test("planNoteSummary drops the marker, tip and stale lines", () => {
|
|
78
|
+
expect(planNoteSummary([prNoteMarker("prod"), "### heading", prNoteTipMarker(OLD), prNoteStaleMarker(NEW)].join("\n"))).toBe("### heading");
|
|
79
|
+
});
|
|
80
|
+
});
|
|
81
|
+
|
|
82
|
+
describe("the tip line (#4628)", () => {
|
|
83
|
+
test("the note carries the target branch's commit it was posted against, after the defusing", async () => {
|
|
84
|
+
const dir = scratch();
|
|
85
|
+
writeFileSync(join(dir, "pr-plan.json"), JSON.stringify({ ...REPORT, message: `x ${prNoteTipMarker(NEW)}` }));
|
|
86
|
+
const { forge, notes, key } = fakeForge("github");
|
|
87
|
+
await postPlanReport({ forge, dir, pr: REPORT.pr!, head: REPORT.head, env: REPORT.env, baseTip: OLD });
|
|
88
|
+
const body = notes.get(key(REPORT.pr!, prNoteMarker(REPORT.env)))!;
|
|
89
|
+
expect(body).toContain(prNoteTipMarker(OLD));
|
|
90
|
+
// The report's own copy is defused, so a change cannot name another tip.
|
|
91
|
+
expect(body).not.toContain(prNoteTipMarker(NEW));
|
|
92
|
+
});
|
|
93
|
+
|
|
94
|
+
test("no tip, no line", async () => {
|
|
95
|
+
const dir = scratch();
|
|
96
|
+
writeFileSync(join(dir, "pr-plan.json"), JSON.stringify(REPORT));
|
|
97
|
+
const { forge, notes, key } = fakeForge("github");
|
|
98
|
+
await postPlanReport({ forge, dir, pr: REPORT.pr!, head: REPORT.head, env: REPORT.env });
|
|
99
|
+
expect(notes.get(key(REPORT.pr!, prNoteMarker(REPORT.env)))).not.toContain("chant-pr-tip");
|
|
100
|
+
});
|
|
101
|
+
});
|
|
102
|
+
|
|
103
|
+
describe("markStaleNotes (#4628)", () => {
|
|
104
|
+
const marker = prNoteMarker("prod");
|
|
105
|
+
const noteAt = (tip: string) => [marker, "### plywood preview for `prod`", "", "body", prNoteTipMarker(tip), ""].join("\n");
|
|
106
|
+
|
|
107
|
+
for (const kind of ["github", "gitlab", "forgejo"] as const) {
|
|
108
|
+
test(`${kind}: a note posted against another commit is marked stale and its status goes back to pending`, async () => {
|
|
109
|
+
const { forge, notes, statuses, key } = fakeForge(kind, [pr(7, "d".repeat(40))]);
|
|
110
|
+
notes.set(key(7, marker), noteAt(OLD));
|
|
111
|
+
const words = assertProductWords(PLYWOOD);
|
|
112
|
+
const done = await markStaleNotes({ forge, branch: "main", tip: NEW, env: "prod", previewComment: true, words });
|
|
113
|
+
expect(done).toEqual({ marks: [{ pr: 7, marked: true }], warnings: [] });
|
|
114
|
+
const body = notes.get(key(7, marker))!;
|
|
115
|
+
const lines = body.split("\n");
|
|
116
|
+
expect(lines[0]).toBe(marker);
|
|
117
|
+
expect(lines[1]).toBe(`> Stale: main moved to \`${NEW.slice(0, 12)}\` since this preview was posted against \`${OLD.slice(0, 12)}\`, so it may no longer show what the merge does; comment \`/plywood preview\` to preview again.`);
|
|
118
|
+
expect(lines[2]).toBe(prNoteStaleMarker(NEW));
|
|
119
|
+
expect(body).toContain("body");
|
|
120
|
+
expect(statuses).toEqual([{ sha: "d".repeat(40), status: expect.objectContaining({ context: "plywood/preview", state: "pending" }) }]);
|
|
121
|
+
});
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
test("without the preview comment the line asks for a push", async () => {
|
|
125
|
+
const { forge, notes, key } = fakeForge("github", [pr(7)]);
|
|
126
|
+
notes.set(key(7, marker), noteAt(OLD));
|
|
127
|
+
await markStaleNotes({ forge, branch: "main", tip: NEW, env: "prod" });
|
|
128
|
+
expect(notes.get(key(7, marker))).toContain("push a commit to plan again");
|
|
129
|
+
});
|
|
130
|
+
|
|
131
|
+
test("a current note, one already marked, one with no tip line and a pull request with no note are left alone", async () => {
|
|
132
|
+
const { forge, notes, statuses, key } = fakeForge("github", [pr(1), pr(2), pr(3), pr(4)]);
|
|
133
|
+
notes.set(key(1, marker), noteAt(NEW));
|
|
134
|
+
notes.set(key(2, marker), [marker, "> Stale: x", prNoteStaleMarker(NEW), "", "body", prNoteTipMarker(OLD)].join("\n"));
|
|
135
|
+
notes.set(key(3, marker), [marker, "an old note"].join("\n"));
|
|
136
|
+
const done = await markStaleNotes({ forge, branch: "main", tip: NEW, env: "prod" });
|
|
137
|
+
expect(done.marks).toEqual([
|
|
138
|
+
{ pr: 1, skipped: "the note is current" },
|
|
139
|
+
{ pr: 2, skipped: "already marked" },
|
|
140
|
+
{ pr: 3, skipped: "the note names no target branch commit" },
|
|
141
|
+
{ pr: 4, skipped: "no note" },
|
|
142
|
+
]);
|
|
143
|
+
expect(statuses).toEqual([]);
|
|
144
|
+
});
|
|
145
|
+
|
|
146
|
+
test("marking again after another push replaces the stale line", async () => {
|
|
147
|
+
const third = "e".repeat(40);
|
|
148
|
+
const { forge, notes, key } = fakeForge("github", [pr(7)]);
|
|
149
|
+
notes.set(key(7, marker), noteAt(OLD));
|
|
150
|
+
await markStaleNotes({ forge, branch: "main", tip: NEW, env: "prod" });
|
|
151
|
+
await markStaleNotes({ forge, branch: "main", tip: third, env: "prod" });
|
|
152
|
+
const body = notes.get(key(7, marker))!;
|
|
153
|
+
expect(body.split("\n").filter((l) => l.startsWith("> Stale: "))).toHaveLength(1);
|
|
154
|
+
expect(body).toContain(prNoteStaleMarker(third));
|
|
155
|
+
expect(body).not.toContain(prNoteStaleMarker(NEW));
|
|
156
|
+
});
|
|
157
|
+
|
|
158
|
+
test("a forge that cannot list open pull requests is refused", async () => {
|
|
159
|
+
const { forge } = fakeForge("github");
|
|
160
|
+
delete (forge as { openPullRequests?: unknown }).openPullRequests;
|
|
161
|
+
await expect(markStaleNotes({ forge, branch: "main", tip: NEW, env: "prod" })).rejects.toThrow(/lists the open pull requests/);
|
|
162
|
+
});
|
|
163
|
+
});
|
package/src/pr-post.ts
CHANGED
|
@@ -20,14 +20,23 @@
|
|
|
20
20
|
* job there that holds `CHANT_FORGE_TOKEN` runs whatever the change wrote.
|
|
21
21
|
* `pr-post --open` ({@link postOpenPlanReports}) asks GitLab for each open
|
|
22
22
|
* merge request's plan job and reads the report from its artifacts.
|
|
23
|
+
*
|
|
24
|
+
* #4628: the note carries the target branch's commit it was posted against
|
|
25
|
+
* (`baseTip`) in a hidden line, and on GitHub and Forgejo the note job adds
|
|
26
|
+
* the note to the job summary (`GITHUB_STEP_SUMMARY`). When the target
|
|
27
|
+
* branch moves, {@link markStaleNotes}, from a job of the push, marks each
|
|
28
|
+
* open pull request's note stale with a line naming the comment that
|
|
29
|
+
* previews again, and sets its plan status back to pending.
|
|
23
30
|
*/
|
|
24
31
|
|
|
25
|
-
import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
|
|
32
|
+
import { appendFileSync, existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
|
|
26
33
|
import { tmpdir } from "node:os";
|
|
27
34
|
import { join } from "node:path";
|
|
28
35
|
import { prNoteMarker, prStatusContext, prStatusDescription, prStatusState, renderPrNote, type PrOverdue, type PrReport } from "./pr-loop";
|
|
29
36
|
import { forgePrincipalOf, type PrForge } from "./pr-forge";
|
|
30
37
|
import { GITHUB_COMMENT_LIMIT, GITLAB_NOTE_LIMIT } from "./plan-summary";
|
|
38
|
+
import { activeProductWords, commentLine, type CiProductWords } from "./ci-product-words";
|
|
39
|
+
import { controlEdgeFactsFromEnv, remarkCrossStackEdges, type ControlEdgeFacts } from "./control/edges";
|
|
31
40
|
|
|
32
41
|
/** The plan report's file under the report directory. */
|
|
33
42
|
export const PR_PLAN_REPORT_FILE = "pr-plan.json";
|
|
@@ -50,6 +59,29 @@ export interface PlanPostInput {
|
|
|
50
59
|
* job held no token to ask with. It replaces any `overdue` in the report.
|
|
51
60
|
*/
|
|
52
61
|
overdue?: () => Promise<PrOverdue[]>;
|
|
62
|
+
/**
|
|
63
|
+
* The control repo's entries and apply records (#4617), which mark the
|
|
64
|
+
* report's cross-stack edges stale, current or unknown. Default: read
|
|
65
|
+
* from the checkout `CHANT_CONTROL_DIR` names, when it names one.
|
|
66
|
+
*/
|
|
67
|
+
controlFacts?: () => Promise<ControlEdgeFacts | undefined>;
|
|
68
|
+
/**
|
|
69
|
+
* The description check (#4629, `../ci-respond-run.ts`), run once the
|
|
70
|
+
* note is posted, on the report's change set. Its finding is a comment of
|
|
71
|
+
* its own; it never changes the status.
|
|
72
|
+
*/
|
|
73
|
+
description?: (report: PrReport) => Promise<void>;
|
|
74
|
+
/**
|
|
75
|
+
* The target branch's commit the pull request's event names (#4628): the
|
|
76
|
+
* note carries it in a hidden line, and {@link markStaleNotes} marks the
|
|
77
|
+
* note stale once the branch has moved past it. Ignored unless a full sha.
|
|
78
|
+
*/
|
|
79
|
+
baseTip?: string;
|
|
80
|
+
/**
|
|
81
|
+
* The job summary file (#4628), `GITHUB_STEP_SUMMARY` on GitHub and
|
|
82
|
+
* Forgejo: the note, without its hidden lines, is added to it.
|
|
83
|
+
*/
|
|
84
|
+
summaryFile?: string;
|
|
53
85
|
}
|
|
54
86
|
|
|
55
87
|
/** What {@link postPlanReport} did. */
|
|
@@ -96,14 +128,39 @@ export function readPlanReport(input: Pick<PlanPostInput, "dir" | "pr" | "head"
|
|
|
96
128
|
* The note for `report`, rendered here, with every `<!--` after the marker
|
|
97
129
|
* line written as `<!--`, so the note carries no hidden marker but its own.
|
|
98
130
|
*/
|
|
99
|
-
export function planNoteFor(report: PrReport, forge: Pick<PrForge, "kind" | "host">, marker: string): string {
|
|
131
|
+
export function planNoteFor(report: PrReport, forge: Pick<PrForge, "kind" | "host">, marker: string, baseTip?: string): string {
|
|
100
132
|
const note = renderPrNote(report, {
|
|
101
133
|
limit: forge.kind === "gitlab" ? GITLAB_NOTE_LIMIT : GITHUB_COMMENT_LIMIT,
|
|
102
134
|
approver: forgePrincipalOf(forge.kind, forge.host, "<your-login>"),
|
|
103
135
|
});
|
|
104
136
|
const at = note.indexOf("\n");
|
|
105
137
|
const rest = (at < 0 ? "" : note.slice(at + 1)).split("<!--").join("<!--");
|
|
106
|
-
|
|
138
|
+
// #4628: the tip line is written after the defusing, from the caller's sha, never the report's.
|
|
139
|
+
const tip = baseTip && SHA.test(baseTip) ? `${rest.endsWith("\n") ? "" : "\n"}${prNoteTipMarker(baseTip)}\n` : "";
|
|
140
|
+
return `${marker}\n${rest}${tip}`;
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
/** The hidden line a note carries with the target branch's commit it was posted against (#4628). */
|
|
144
|
+
export function prNoteTipMarker(sha: string): string {
|
|
145
|
+
return `<!-- chant-pr-tip:${sha} -->`;
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
/** The hidden line a note marked stale carries, with the commit it was marked at (#4628). */
|
|
149
|
+
export function prNoteStaleMarker(sha: string): string {
|
|
150
|
+
return `<!-- chant-pr-stale:${sha} -->`;
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
const TIP_LINE = /<!-- chant-pr-tip:([0-9a-f]{40}) -->/;
|
|
154
|
+
const STALE_LINE = /<!-- chant-pr-stale:([0-9a-f]{40}) -->/;
|
|
155
|
+
const STALE_PREFIX = "> Stale: ";
|
|
156
|
+
|
|
157
|
+
/** The note as the job summary shows it (#4628): the hidden lines dropped. */
|
|
158
|
+
export function planNoteSummary(note: string): string {
|
|
159
|
+
return note
|
|
160
|
+
.split("\n")
|
|
161
|
+
.filter((l) => !/^<!-- chant-pr[-:]/.test(l.trim()))
|
|
162
|
+
.join("\n")
|
|
163
|
+
.replace(/^\n+/, "");
|
|
107
164
|
}
|
|
108
165
|
|
|
109
166
|
const cut = (text: string, max = 140): string => (text.length > max ? `${text.slice(0, max - 3)}...` : text);
|
|
@@ -133,11 +190,16 @@ export async function postPlanReport(input: PlanPostInput): Promise<PlanPostResu
|
|
|
133
190
|
const found = await input.overdue().catch(() => [] as PrOverdue[]);
|
|
134
191
|
report = (found.length > 0 ? { ...rest, overdue: found } : rest) as PrReport;
|
|
135
192
|
}
|
|
193
|
+
// #4617: the marks come from the control repo, read here; the plan job's never show.
|
|
194
|
+
if (report.crossStackEdges?.length) {
|
|
195
|
+
const facts = await (input.controlFacts ?? (() => controlEdgeFactsFromEnv()))().catch(() => undefined);
|
|
196
|
+
report = remarkCrossStackEdges(report, facts);
|
|
197
|
+
}
|
|
136
198
|
try {
|
|
137
199
|
state = prStatusState(report);
|
|
138
200
|
description = prStatusDescription(report);
|
|
139
201
|
// A member the change does not reach has nothing to say on the pull request (as pr-plan's own publish).
|
|
140
|
-
if (!(input.member && report.status === "nothing" && !report.overdue?.length && !report.migrations?.length)) note = planNoteFor(report, input.forge, prNoteMarker(input.env, input.member));
|
|
202
|
+
if (!(input.member && report.status === "nothing" && !report.overdue?.length && !report.migrations?.length)) note = planNoteFor(report, input.forge, prNoteMarker(input.env, input.member), input.baseTip);
|
|
141
203
|
} catch (err) {
|
|
142
204
|
refused = `the plan report does not render: ${err instanceof Error ? err.message : String(err)}`;
|
|
143
205
|
state = "failure";
|
|
@@ -156,15 +218,48 @@ export async function postPlanReport(input: PlanPostInput): Promise<PlanPostResu
|
|
|
156
218
|
}
|
|
157
219
|
if (note !== undefined) {
|
|
158
220
|
try {
|
|
159
|
-
await input.forge
|
|
221
|
+
await upsertPlanNote(input.forge, input.pr, prNoteMarker(input.env, input.member), note);
|
|
160
222
|
} catch (err) {
|
|
161
223
|
warnings.push(`could not post the note on #${input.pr}: ${err instanceof Error ? err.message : String(err)}`);
|
|
162
224
|
note = undefined;
|
|
163
225
|
}
|
|
164
226
|
}
|
|
227
|
+
// #4628: the note in the job summary, on a forge that keeps one.
|
|
228
|
+
if (input.summaryFile && (note !== undefined || refused !== undefined)) {
|
|
229
|
+
try {
|
|
230
|
+
appendFileSync(input.summaryFile, `${note !== undefined ? planNoteSummary(note) : `${context}: ${description}\n`}\n`);
|
|
231
|
+
} catch (err) {
|
|
232
|
+
warnings.push(`could not write the job summary: ${err instanceof Error ? err.message : String(err)}`);
|
|
233
|
+
}
|
|
234
|
+
}
|
|
235
|
+
if (input.description && "report" in read && !failedJob) {
|
|
236
|
+
try {
|
|
237
|
+
await input.description(read.report);
|
|
238
|
+
} catch (err) {
|
|
239
|
+
warnings.push(`the description check did not run: ${err instanceof Error ? err.message : String(err)}`);
|
|
240
|
+
}
|
|
241
|
+
}
|
|
165
242
|
return { state, description: cut(description), noted: note !== undefined, ...(refused ? { refused } : {}), warnings };
|
|
166
243
|
}
|
|
167
244
|
|
|
245
|
+
/**
|
|
246
|
+
* Post the plan note, or update it. Under a product's words that carry
|
|
247
|
+
* `adoptMarkers` (#4550), a pull request with no chant note yet but a note the
|
|
248
|
+
* product posted before it moved onto chant's pipeline gets that note
|
|
249
|
+
* updated, with the old marker kept at its end, so the pull request keeps one
|
|
250
|
+
* note across the switch.
|
|
251
|
+
*/
|
|
252
|
+
export async function upsertPlanNote(forge: Pick<PrForge, "upsertNote" | "findComment" | "upsertComment">, pr: number, marker: string, note: string, words: CiProductWords = activeProductWords()): Promise<void> {
|
|
253
|
+
if (words.adoptMarkers.length > 0 && !(await forge.findComment(pr, marker))) {
|
|
254
|
+
for (const old of words.adoptMarkers) {
|
|
255
|
+
if (!(await forge.findComment(pr, old, { match: "anywhere" }))) continue;
|
|
256
|
+
await forge.upsertComment(pr, old, `${note}${note.endsWith("\n") ? "" : "\n"}${old}\n`, { match: "anywhere" });
|
|
257
|
+
return;
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
await forge.upsertNote(pr, marker, note);
|
|
261
|
+
}
|
|
262
|
+
|
|
168
263
|
/** What {@link postOpenPlanReports} posts for. */
|
|
169
264
|
export interface OpenPlanPostInput {
|
|
170
265
|
/** A GitLab client with {@link PrForge.mergeRequestJobs}, {@link PrForge.jobArtifact} and {@link PrForge.statusUrl}. */
|
|
@@ -178,6 +273,10 @@ export interface OpenPlanPostInput {
|
|
|
178
273
|
env: string;
|
|
179
274
|
member?: string;
|
|
180
275
|
overdue?: () => Promise<PrOverdue[]>;
|
|
276
|
+
/** The description check, as {@link PlanPostInput.description}. */
|
|
277
|
+
description?: (report: PrReport) => Promise<void>;
|
|
278
|
+
/** The target branch's commit this pipeline runs at (#4628), for each note's tip line. */
|
|
279
|
+
baseTip?: string;
|
|
181
280
|
}
|
|
182
281
|
|
|
183
282
|
/** What {@link postOpenPlanReports} did for one merge request. */
|
|
@@ -234,6 +333,8 @@ export async function postOpenPlanReports(input: OpenPlanPostInput): Promise<{ p
|
|
|
234
333
|
...(input.member ? { member: input.member } : {}),
|
|
235
334
|
result: settled,
|
|
236
335
|
...(overdueOnce ? { overdue: overdueOnce } : {}),
|
|
336
|
+
...(input.description ? { description: input.description } : {}),
|
|
337
|
+
...(input.baseTip ? { baseTip: input.baseTip } : {}),
|
|
237
338
|
});
|
|
238
339
|
posts.push({ pr: job.pr, head: job.head, posted });
|
|
239
340
|
} finally {
|
|
@@ -245,3 +346,87 @@ export async function postOpenPlanReports(input: OpenPlanPostInput): Promise<{ p
|
|
|
245
346
|
}
|
|
246
347
|
return { posts, warnings };
|
|
247
348
|
}
|
|
349
|
+
|
|
350
|
+
/** What {@link markStaleNotes} marks. */
|
|
351
|
+
export interface StaleMarkInput {
|
|
352
|
+
/** A client that lists open pull requests ({@link PrForge.openPullRequests}). */
|
|
353
|
+
forge: PrForge;
|
|
354
|
+
/** The target branch that moved. */
|
|
355
|
+
branch: string;
|
|
356
|
+
/** Its commit now: the push's. */
|
|
357
|
+
tip: string;
|
|
358
|
+
env: string;
|
|
359
|
+
member?: string;
|
|
360
|
+
/** The pipeline answers the plan comment (`--preview-comment`), so the stale line names it. */
|
|
361
|
+
previewComment?: boolean;
|
|
362
|
+
words?: CiProductWords;
|
|
363
|
+
}
|
|
364
|
+
|
|
365
|
+
/** What {@link markStaleNotes} did for one pull request. */
|
|
366
|
+
export interface StaleMark {
|
|
367
|
+
pr: number;
|
|
368
|
+
/** Marked stale, and its status set back to pending. */
|
|
369
|
+
marked?: boolean;
|
|
370
|
+
/** Why it was left alone. */
|
|
371
|
+
skipped?: string;
|
|
372
|
+
}
|
|
373
|
+
|
|
374
|
+
/**
|
|
375
|
+
* Mark stale each open pull request's note into `branch` that was posted
|
|
376
|
+
* against another commit than `tip` (#4628): a line after the marker says
|
|
377
|
+
* the branch moved and names the comment that previews again (or a push,
|
|
378
|
+
* when the pipeline answers no plan comment), and the plan status on the
|
|
379
|
+
* pull request's head goes back to pending. A note with no tip line (posted
|
|
380
|
+
* before #4628), one at `tip`, or one already marked at `tip` is left alone.
|
|
381
|
+
* A forge that refuses one pull request is a warning, and the others go on.
|
|
382
|
+
*/
|
|
383
|
+
export async function markStaleNotes(input: StaleMarkInput): Promise<{ marks: StaleMark[]; warnings: string[] }> {
|
|
384
|
+
const { forge } = input;
|
|
385
|
+
if (!SHA.test(input.tip)) throw new Error(`the target branch's commit is a full sha, not ${JSON.stringify(input.tip)}`);
|
|
386
|
+
if (!forge.openPullRequests) throw new Error(`marking notes stale lists the open pull requests into ${input.branch}, which this ${forge.kind} client cannot`);
|
|
387
|
+
const words = input.words ?? activeProductWords();
|
|
388
|
+
const marker = prNoteMarker(input.env, input.member);
|
|
389
|
+
const context = prStatusContext("plan", input.member, words);
|
|
390
|
+
const comment = input.previewComment ? commentLine(words, "plan") : undefined;
|
|
391
|
+
const verb = words.verbs.plan[0];
|
|
392
|
+
const again = comment ? `comment \`${comment}\` to ${verb} again` : `push a commit to ${verb} again`;
|
|
393
|
+
const marks: StaleMark[] = [];
|
|
394
|
+
const warnings: string[] = [];
|
|
395
|
+
for (const pr of await forge.openPullRequests(input.branch)) {
|
|
396
|
+
try {
|
|
397
|
+
const found = await forge.findComment(pr.number, marker);
|
|
398
|
+
if (!found) {
|
|
399
|
+
marks.push({ pr: pr.number, skipped: "no note" });
|
|
400
|
+
continue;
|
|
401
|
+
}
|
|
402
|
+
const planned = TIP_LINE.exec(found.body)?.[1];
|
|
403
|
+
if (!planned) {
|
|
404
|
+
marks.push({ pr: pr.number, skipped: "the note names no target branch commit" });
|
|
405
|
+
continue;
|
|
406
|
+
}
|
|
407
|
+
if (planned === input.tip) {
|
|
408
|
+
marks.push({ pr: pr.number, skipped: "the note is current" });
|
|
409
|
+
continue;
|
|
410
|
+
}
|
|
411
|
+
if (STALE_LINE.exec(found.body)?.[1] === input.tip) {
|
|
412
|
+
marks.push({ pr: pr.number, skipped: "already marked" });
|
|
413
|
+
continue;
|
|
414
|
+
}
|
|
415
|
+
const lines = found.body.split("\n");
|
|
416
|
+
const head = lines[0] === marker ? 1 : 0;
|
|
417
|
+
const kept = lines.slice(head).filter((l) => !l.startsWith(STALE_PREFIX) && !STALE_LINE.test(l));
|
|
418
|
+
while (kept[0] === "") kept.shift();
|
|
419
|
+
const line = `${STALE_PREFIX}${input.branch} moved to \`${input.tip.slice(0, 12)}\` since this ${verb} was posted against \`${planned.slice(0, 12)}\`, so it may no longer show what the merge does; ${again}.`;
|
|
420
|
+
await forge.upsertNote(pr.number, marker, [marker, line, prNoteStaleMarker(input.tip), "", ...kept].join("\n"));
|
|
421
|
+
try {
|
|
422
|
+
await forge.setStatus(pr.headSha, { context, state: "pending", description: cut(`stale: ${input.branch} moved; ${again.replace(/`/g, "")}`) });
|
|
423
|
+
} catch (err) {
|
|
424
|
+
warnings.push(`#${pr.number}: could not set the ${context} status back to pending: ${err instanceof Error ? err.message : String(err)}`);
|
|
425
|
+
}
|
|
426
|
+
marks.push({ pr: pr.number, marked: true });
|
|
427
|
+
} catch (err) {
|
|
428
|
+
warnings.push(`#${pr.number}: ${err instanceof Error ? err.message : String(err)}`);
|
|
429
|
+
}
|
|
430
|
+
}
|
|
431
|
+
return { marks, warnings };
|
|
432
|
+
}
|