@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,134 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* #4630: `<product>/approval` on an open pull request's head, from the
|
|
3
|
+
* policy at base, the head's recorded plans and the forge's reviews, on
|
|
4
|
+
* fake GitHub, GitLab and Forgejo forges.
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { describe, expect, test } from "vitest";
|
|
8
|
+
import { assertProductWords } from "../ci-product-words";
|
|
9
|
+
import type { HeadPlans } from "../lifecycle/wave-plans";
|
|
10
|
+
import { parseHeadPlans } from "../lifecycle/wave-plans";
|
|
11
|
+
import type { ForgeStatus, PrApprovalResult } from "../pr-forge";
|
|
12
|
+
import { approvalStatusOf, headWaveHolds, postApprovalStatus, postOpenApprovalStatuses } from "./approval-status";
|
|
13
|
+
import type { OpWavesSpec } from "./op-waves";
|
|
14
|
+
import type { OpWaveShowAtBase } from "./op-waves-run";
|
|
15
|
+
|
|
16
|
+
const HEAD = "a".repeat(40);
|
|
17
|
+
const BASE = "b".repeat(40);
|
|
18
|
+
|
|
19
|
+
const SPEC: OpWavesSpec = {
|
|
20
|
+
name: "plywood-up",
|
|
21
|
+
op: "plywood-up",
|
|
22
|
+
plan: ["./bin/plan", "{target}", "{plan}"],
|
|
23
|
+
waves: [
|
|
24
|
+
{ name: "dev", runs: [{ target: "dev" }], gate: "never", approval: "pr-review" },
|
|
25
|
+
{ name: "prod", runs: [{ target: "prod" }], gate: "on-destructive", approval: "pr-review" },
|
|
26
|
+
],
|
|
27
|
+
};
|
|
28
|
+
|
|
29
|
+
/** The spec as it stands at base: what the policy is read from. */
|
|
30
|
+
const atBase = (spec: OpWavesSpec | null): OpWaveShowAtBase => () => ({ sha: BASE, text: spec ? JSON.stringify(spec) : null });
|
|
31
|
+
|
|
32
|
+
const plans = (waves: HeadPlans["waves"]): HeadPlans => ({ version: 1, name: SPEC.name, head: HEAD, timestamp: "2026-10-28T00:00:00Z", waves });
|
|
33
|
+
|
|
34
|
+
function fakeForge(kind: "github" | "gitlab" | "forgejo", approval: PrApprovalResult) {
|
|
35
|
+
const statuses: Array<{ sha: string; status: ForgeStatus }> = [];
|
|
36
|
+
const asked: Array<{ pr: number; head: string }> = [];
|
|
37
|
+
const forge = {
|
|
38
|
+
kind,
|
|
39
|
+
runUrl: "https://ci.example/run/1",
|
|
40
|
+
async prApproved(pr: number, head: string) {
|
|
41
|
+
asked.push({ pr, head });
|
|
42
|
+
return approval;
|
|
43
|
+
},
|
|
44
|
+
async setStatus(sha: string, status: ForgeStatus) {
|
|
45
|
+
statuses.push({ sha, status });
|
|
46
|
+
},
|
|
47
|
+
async openPullRequests() {
|
|
48
|
+
return [
|
|
49
|
+
{ number: 3, head: "feature", headSha: HEAD, base: "main", baseSha: BASE, fork: false },
|
|
50
|
+
{ number: 4, head: "fork-branch", headSha: "c".repeat(40), base: "main", fork: true },
|
|
51
|
+
];
|
|
52
|
+
},
|
|
53
|
+
};
|
|
54
|
+
return { forge, statuses, asked };
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
const approved: PrApprovalResult = { passed: true, reason: "approved", approvers: ["github:lee"], excluded: [] };
|
|
58
|
+
const notApproved: PrApprovalResult = { passed: false, reason: "no writer other than the author approved a1b2c3d4", approvers: [], excluded: [] };
|
|
59
|
+
|
|
60
|
+
describe("which waves the gate will hold (#4630)", () => {
|
|
61
|
+
test("never holds nothing, on-destructive holds a destructive plan, always holds a change; no facts read as a change", () => {
|
|
62
|
+
expect(headWaveHolds("never", { changes: true, destructive: true })).toBe(false);
|
|
63
|
+
expect(headWaveHolds("on-destructive", { changes: true, destructive: false })).toBe(false);
|
|
64
|
+
expect(headWaveHolds("on-destructive", { changes: true, destructive: true })).toBe(true);
|
|
65
|
+
expect(headWaveHolds("always", { changes: false })).toBe(false);
|
|
66
|
+
expect(headWaveHolds("always", {})).toBe(true);
|
|
67
|
+
});
|
|
68
|
+
|
|
69
|
+
test("the plans record keeps the facts, and an older record without them still parses", () => {
|
|
70
|
+
const text = JSON.stringify(plans([{ wave: 1, name: "dev", digest: "d1", changes: true, destructive: false }]));
|
|
71
|
+
expect(parseHeadPlans(text)?.waves[0]).toEqual({ wave: 1, name: "dev", digest: "d1", changes: true, destructive: false });
|
|
72
|
+
expect(parseHeadPlans(JSON.stringify(plans([{ wave: 1, name: "dev", digest: "d1" }])))?.waves[0]).toEqual({ wave: 1, name: "dev", digest: "d1" });
|
|
73
|
+
});
|
|
74
|
+
});
|
|
75
|
+
|
|
76
|
+
describe("<product>/approval on the head (#4630)", () => {
|
|
77
|
+
for (const kind of ["github", "gitlab", "forgejo"] as const) {
|
|
78
|
+
test(`pending while a held wave has no approving review, success once it has (${kind})`, async () => {
|
|
79
|
+
const recorded = plans([
|
|
80
|
+
{ wave: 1, name: "dev", digest: "d1", changes: true, destructive: true },
|
|
81
|
+
{ wave: 2, name: "prod", digest: "d2", changes: true, destructive: true },
|
|
82
|
+
]);
|
|
83
|
+
const words = assertProductWords({ product: "plywood" });
|
|
84
|
+
const waiting = fakeForge(kind, notApproved);
|
|
85
|
+
const status = await postApprovalStatus({ spec: SPEC, specFile: "waves.json", forge: waiting.forge, pr: 3, head: HEAD, base: BASE, show: atBase(SPEC), readPlans: async () => recorded }, words);
|
|
86
|
+
expect(status).toMatchObject({ state: "pending", waits: [2] });
|
|
87
|
+
expect(waiting.statuses).toEqual([{ sha: HEAD, status: { context: "plywood/approval", state: "pending", description: expect.stringContaining("wave 2 wait"), url: "https://ci.example/run/1" } }]);
|
|
88
|
+
expect(waiting.asked).toEqual([{ pr: 3, head: HEAD }]);
|
|
89
|
+
|
|
90
|
+
const done = fakeForge(kind, approved);
|
|
91
|
+
const ok = await postApprovalStatus({ spec: SPEC, specFile: "waves.json", forge: done.forge, pr: 3, head: HEAD, base: BASE, show: atBase(SPEC), readPlans: async () => recorded }, words);
|
|
92
|
+
expect(ok).toMatchObject({ state: "success", approvers: ["github:lee"] });
|
|
93
|
+
expect(done.statuses[0]!.status.description).toContain("by github:lee");
|
|
94
|
+
});
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
test("a plan no gate holds is success without asking for reviews", async () => {
|
|
98
|
+
const { forge, asked } = fakeForge("github", notApproved);
|
|
99
|
+
const status = await approvalStatusOf({
|
|
100
|
+
spec: SPEC,
|
|
101
|
+
specFile: "waves.json",
|
|
102
|
+
forge,
|
|
103
|
+
pr: 3,
|
|
104
|
+
head: HEAD,
|
|
105
|
+
base: BASE,
|
|
106
|
+
show: atBase(SPEC),
|
|
107
|
+
readPlans: async () => plans([{ wave: 1, name: "dev", digest: "d1", changes: true }, { wave: 2, name: "prod", digest: "d2", changes: true, destructive: false }]),
|
|
108
|
+
});
|
|
109
|
+
expect(status).toMatchObject({ state: "success", waits: [] });
|
|
110
|
+
expect(asked).toEqual([]);
|
|
111
|
+
});
|
|
112
|
+
|
|
113
|
+
test("the policy is read at base: a head that loosens it still waits", async () => {
|
|
114
|
+
const loosened: OpWavesSpec = { ...SPEC, waves: SPEC.waves.map((w) => ({ ...w, gate: "never" as const })) };
|
|
115
|
+
const strict: OpWavesSpec = { ...SPEC, waves: SPEC.waves.map((w) => ({ ...w, gate: "always" as const })) };
|
|
116
|
+
const { forge } = fakeForge("forgejo", notApproved);
|
|
117
|
+
const status = await approvalStatusOf({ spec: loosened, specFile: "waves.json", forge, pr: 3, head: HEAD, base: BASE, show: atBase(strict), readPlans: async () => plans([{ wave: 1, name: "dev", digest: "d1", changes: true }, { wave: 2, name: "prod", digest: "d2", changes: true }]) });
|
|
118
|
+
expect(status).toMatchObject({ state: "pending", waits: [1, 2] });
|
|
119
|
+
});
|
|
120
|
+
|
|
121
|
+
test("plans not recorded yet are pending; no pr-review wave at base is success", async () => {
|
|
122
|
+
const { forge } = fakeForge("github", approved);
|
|
123
|
+
expect(await approvalStatusOf({ spec: SPEC, specFile: "waves.json", forge, pr: 3, head: HEAD, base: BASE, show: atBase(SPEC), readPlans: async () => null })).toMatchObject({ state: "pending", description: expect.stringContaining("not recorded yet") });
|
|
124
|
+
const ledgerOnly: OpWavesSpec = { ...SPEC, waves: SPEC.waves.map(({ approval: _a, ...w }) => w) };
|
|
125
|
+
expect(await approvalStatusOf({ spec: SPEC, specFile: "waves.json", forge, pr: 3, head: HEAD, base: BASE, show: atBase(ledgerOnly), readPlans: async () => null })).toMatchObject({ state: "success" });
|
|
126
|
+
});
|
|
127
|
+
|
|
128
|
+
test("--open posts on every open merge request from the repository, and leaves forks out", async () => {
|
|
129
|
+
const { forge, statuses } = fakeForge("gitlab", notApproved);
|
|
130
|
+
const done = await postOpenApprovalStatuses({ spec: SPEC, specFile: "waves.json", forge, branch: "main", show: atBase(SPEC), readPlans: async () => plans([{ wave: 2, name: "prod", digest: "d2", changes: true, destructive: true }]) }, assertProductWords({ product: "plywood" }));
|
|
131
|
+
expect(done.posted.map((p) => p.pr)).toEqual([3]);
|
|
132
|
+
expect(statuses.map((s) => s.sha)).toEqual([HEAD]);
|
|
133
|
+
});
|
|
134
|
+
});
|
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The approval status before merge (#4630): `<product>/approval` on an open
|
|
3
|
+
* pull request's head says whether the waves its merge will run wait for an
|
|
4
|
+
* approval. It covers the waves whose approval at base is `pr-review` and,
|
|
5
|
+
* under the 2026-10-28 ruling, the waves whose approval is `pull-request`.
|
|
6
|
+
*
|
|
7
|
+
* - `pending` while a wave whose gate the plan will hold has no approval
|
|
8
|
+
* that would pass it: under `pr-review` an approving review of that head,
|
|
9
|
+
* by a writer other than its author; under `pull-request` the pull
|
|
10
|
+
* request's own approval (below).
|
|
11
|
+
* - `success` once every such wave has one, or when no wave's gate holds
|
|
12
|
+
* the plan.
|
|
13
|
+
*
|
|
14
|
+
* Which waves the gate holds is read the way the wave job reads it after the
|
|
15
|
+
* merge: each wave's approval mode and policy from the spec at the pull
|
|
16
|
+
* request's base (`readOpWavePolicy`), applied to the facts the head's plans
|
|
17
|
+
* record (`chant run wave --record-plans`, `../lifecycle/wave-plans.ts`):
|
|
18
|
+
* whether a run changes anything and whether a plan is destructive. A head
|
|
19
|
+
* whose plans are not recorded yet is pending, since nothing says its waves
|
|
20
|
+
* pass.
|
|
21
|
+
*
|
|
22
|
+
* The pull request's own approval, for a `pull-request` wave: an approval at
|
|
23
|
+
* the pull request's gate (`approvals.pullRequest.gate` at base) whose
|
|
24
|
+
* change set covers the wave's change set at the head, as the merged wave
|
|
25
|
+
* checks it (`planCoveredBy`). The approval is read on the pull request's
|
|
26
|
+
* op (`pr-<n>`), where the product's approve line records it, and on the
|
|
27
|
+
* spec's op, which the merged wave reads. The head's change set is the one
|
|
28
|
+
* `--record-plans` stored for the wave; a record without one is pending.
|
|
29
|
+
*
|
|
30
|
+
* The status job reads only: the pull request, its reviews and
|
|
31
|
+
* `chant/lifecycle`. It writes the one commit status. On GitHub and Forgejo
|
|
32
|
+
* it runs after the record-plans job and on every review; on GitLab, whose
|
|
33
|
+
* approvals start no pipeline, a scheduled pipeline of the target branch
|
|
34
|
+
* posts it for every open merge request (`--open`). An approval recorded on
|
|
35
|
+
* the ledger starts no run on any forge: the next push, review or `--open`
|
|
36
|
+
* run posts it. The status advises: the gate after the merge decides, from
|
|
37
|
+
* the ledger and the merged review.
|
|
38
|
+
*/
|
|
39
|
+
|
|
40
|
+
import { activeProductWords, productStatusContext, type CiProductWords } from "../ci-product-words";
|
|
41
|
+
import type { ChangeSetDocument } from "../change-set";
|
|
42
|
+
import type { GateResolutionRecord } from "../lifecycle/gate-ledger";
|
|
43
|
+
import type { HeadPlans } from "../lifecycle/wave-plans";
|
|
44
|
+
import type { PrApproverFilter, PrForge } from "../pr-forge";
|
|
45
|
+
import type { OpWaveGatePolicy, OpWavesSpec } from "./op-waves";
|
|
46
|
+
import type { OpWaveShowAtBase } from "./op-waves-run";
|
|
47
|
+
|
|
48
|
+
/** What the status says. */
|
|
49
|
+
export interface ApprovalStatus {
|
|
50
|
+
state: "pending" | "success";
|
|
51
|
+
description: string;
|
|
52
|
+
/** The waves whose gate the plan will hold, by number. */
|
|
53
|
+
waits: number[];
|
|
54
|
+
/** Who approved the head, when someone did. */
|
|
55
|
+
approvers: string[];
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export interface ApprovalStatusInput {
|
|
59
|
+
spec: OpWavesSpec;
|
|
60
|
+
/** The spec's path, which the policy is read from at `base`. */
|
|
61
|
+
specFile: string;
|
|
62
|
+
forge: Pick<PrForge, "prApproved" | "kind">;
|
|
63
|
+
pr: number;
|
|
64
|
+
/** The pull request's head commit. */
|
|
65
|
+
head: string;
|
|
66
|
+
/** The pull request's base commit, which the policy is read at. */
|
|
67
|
+
base: string;
|
|
68
|
+
cwd?: string;
|
|
69
|
+
/** The head's recorded plans. Default: `chant/lifecycle` at `cwd`. */
|
|
70
|
+
readPlans?: (name: string, head: string) => Promise<HeadPlans | null>;
|
|
71
|
+
/** How the spec is read at base. Default `git show`. */
|
|
72
|
+
show?: OpWaveShowAtBase;
|
|
73
|
+
/** Who may approve, as the forge's requires check takes it. */
|
|
74
|
+
approvers?: PrApproverFilter;
|
|
75
|
+
/** The resolutions on one op's gate ledger, for a `pull-request` wave. Default: `chant/lifecycle` at `cwd`. */
|
|
76
|
+
readResolutions?: (op: string) => Promise<GateResolutionRecord[]>;
|
|
77
|
+
/** A stored change set by digest, for a `pull-request` wave. Default: `_change-sets/` on `chant/lifecycle` at `cwd`. */
|
|
78
|
+
changeSets?: (digest: string) => Promise<ChangeSetDocument | undefined>;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/** Whether `policy` holds a wave with these facts. A record with no facts reads as changing, so it holds under `always`. */
|
|
82
|
+
export function headWaveHolds(policy: OpWaveGatePolicy, facts: { changes?: boolean; destructive?: boolean }): boolean {
|
|
83
|
+
if (policy === "never") return false;
|
|
84
|
+
if (facts.changes === false) return false;
|
|
85
|
+
if (policy === "on-destructive") return facts.destructive === true;
|
|
86
|
+
return true;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
const short = (sha: string): string => sha.slice(0, 8);
|
|
90
|
+
const cut = (text: string): string => (text.length > 135 ? `${text.slice(0, 132)}...` : text);
|
|
91
|
+
|
|
92
|
+
/** The status for one pull request's head. Throws only when the spec cannot be read at base. */
|
|
93
|
+
export async function approvalStatusOf(input: ApprovalStatusInput): Promise<ApprovalStatus> {
|
|
94
|
+
const cwd = input.cwd ?? process.cwd();
|
|
95
|
+
const { readOpWavePolicy } = await import("./op-waves-run");
|
|
96
|
+
const rulesOf = (name: string) => readOpWavePolicy(input.specFile, name, input.base, cwd, ...(input.show ? [input.show] : []));
|
|
97
|
+
const asked = input.spec.waves
|
|
98
|
+
.map((w, i) => ({ k: i + 1, wave: w, rules: rulesOf(w.name) }))
|
|
99
|
+
.filter(({ rules }) => rules.approval === "pr-review" || rules.approval === "pull-request");
|
|
100
|
+
if (asked.length === 0) return { state: "success", description: "no wave takes its approval from the pull request", waits: [], approvers: [] };
|
|
101
|
+
const plans = await (input.readPlans ?? ((name, head) => ledgerHeadPlans(name, head, cwd)))(input.spec.name, input.head);
|
|
102
|
+
if (!plans) {
|
|
103
|
+
return { state: "pending", description: cut(`the plans of ${short(input.head)} are not recorded yet, so every wave may wait`), waits: asked.map((r) => r.k), approvers: [] };
|
|
104
|
+
}
|
|
105
|
+
const factsOf = (k: number) => plans.waves.find((w) => w.wave === k);
|
|
106
|
+
const holding = asked.filter(({ k, rules }) => headWaveHolds(rules.policy, factsOf(k) ?? {}));
|
|
107
|
+
const waits = holding.map((r) => r.k);
|
|
108
|
+
if (waits.length === 0) return { state: "success", description: cut(`no wave waits for an approval at ${short(input.head)}`), waits, approvers: [] };
|
|
109
|
+
|
|
110
|
+
const unmet: string[] = [];
|
|
111
|
+
const approvers = new Set<string>();
|
|
112
|
+
// pr-review: one approving review of the head answers every such wave.
|
|
113
|
+
const byReview = holding.filter((r) => r.rules.approval === "pr-review").map((r) => r.k);
|
|
114
|
+
if (byReview.length > 0) {
|
|
115
|
+
const which = wavesLabel(byReview);
|
|
116
|
+
if (!input.forge.prApproved) unmet.push(`${which}: ${input.forge.kind} cannot say who approved the head`);
|
|
117
|
+
else {
|
|
118
|
+
const approved = await input.forge.prApproved(input.pr, input.head, input.approvers);
|
|
119
|
+
if (approved.passed && approved.approvers.length > 0) for (const a of approved.approvers) approvers.add(a);
|
|
120
|
+
else unmet.push(`${which}: ${approved.reason}`);
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
// pull-request: the pull request's own approval, whose change set must cover each wave's.
|
|
124
|
+
const byPullRequest = holding.filter((r) => r.rules.approval === "pull-request");
|
|
125
|
+
if (byPullRequest.length > 0) {
|
|
126
|
+
const read = pullRequestApprovalReader(input, cwd);
|
|
127
|
+
for (const { k, rules } of byPullRequest) {
|
|
128
|
+
const got = await read(rules.pullRequestGate, factsOf(k)?.changeSet);
|
|
129
|
+
if (got.approvedBy) approvers.add(got.approvedBy);
|
|
130
|
+
else unmet.push(`wave ${k}: ${got.reason}`);
|
|
131
|
+
}
|
|
132
|
+
}
|
|
133
|
+
const which = wavesLabel(waits);
|
|
134
|
+
if (unmet.length > 0) return { state: "pending", description: cut(`${which} wait: ${unmet.join("; ")}`), waits, approvers: [] };
|
|
135
|
+
const by = [...approvers];
|
|
136
|
+
return { state: "success", description: cut(`${which} approved at ${short(input.head)} by ${by.join(", ")}`), waits, approvers: by };
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
const wavesLabel = (ks: readonly number[]): string => `wave${ks.length === 1 ? "" : "s"} ${ks.join(", ")}`;
|
|
140
|
+
|
|
141
|
+
/**
|
|
142
|
+
* How a `pull-request` wave's approval is found before merge: the newest
|
|
143
|
+
* approval at the pull request's gate, on the pull request's op or the
|
|
144
|
+
* spec's, whose change set covers the wave's change set at the head.
|
|
145
|
+
*/
|
|
146
|
+
function pullRequestApprovalReader(input: ApprovalStatusInput, cwd: string) {
|
|
147
|
+
const resolutionsOf = input.readResolutions ?? ((op: string) => ledgerResolutions(op, cwd));
|
|
148
|
+
const changeSetOf = input.changeSets ?? ((digest: string) => ledgerChangeSet(digest, cwd));
|
|
149
|
+
let all: Promise<GateResolutionRecord[]> | undefined;
|
|
150
|
+
const resolutions = () =>
|
|
151
|
+
(all ??= (async () => {
|
|
152
|
+
// The pull request's op, as `prOp` (../pr-loop.ts) names it, and the spec's.
|
|
153
|
+
const ops = [...new Set([`pr-${input.pr}`, input.spec.name])];
|
|
154
|
+
return (await Promise.all(ops.map((op) => resolutionsOf(op)))).flat();
|
|
155
|
+
})());
|
|
156
|
+
return async (gate: string | undefined, digest: string | undefined): Promise<{ approvedBy?: string; reason: string }> => {
|
|
157
|
+
if (!gate) return { reason: "the spec at base names no approvals.pullRequest.gate" };
|
|
158
|
+
if (!digest) return { reason: `the plans of ${short(input.head)} carry no change set to check the pull request's approval against` };
|
|
159
|
+
const fresh = await changeSetOf(digest).catch(() => undefined);
|
|
160
|
+
if (!fresh) return { reason: `the change set ${digest} of ${short(input.head)} is not stored` };
|
|
161
|
+
const approvals = (await resolutions()).filter((r) => r.gate === gate && (r.changeSet ?? r.planDigest)).sort((a, b) => (a.timestamp < b.timestamp ? 1 : -1));
|
|
162
|
+
if (approvals.length === 0) return { reason: `the pull request's gate ${gate} has no approval` };
|
|
163
|
+
const { planCoveredBy } = await import("../components/pr-run");
|
|
164
|
+
let reason = `no approval at ${gate} covers its plans`;
|
|
165
|
+
for (const r of approvals) {
|
|
166
|
+
const approvedDigest = (r.changeSet ?? r.planDigest)!;
|
|
167
|
+
const approved = approvedDigest === fresh.digest ? fresh : await changeSetOf(approvedDigest).catch(() => undefined);
|
|
168
|
+
if (!approved) {
|
|
169
|
+
reason = `the change set ${approvedDigest} the approval at ${gate} names is not stored`;
|
|
170
|
+
continue;
|
|
171
|
+
}
|
|
172
|
+
const why = fresh.members.map((m) => planCoveredBy(approved, fresh, m.member)).find((w) => w !== undefined);
|
|
173
|
+
if (why === undefined) return { approvedBy: r.resolvedBy, reason: "" };
|
|
174
|
+
reason = why;
|
|
175
|
+
}
|
|
176
|
+
return { reason };
|
|
177
|
+
};
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/** Post the status on the head. Returns what was posted. */
|
|
181
|
+
export async function postApprovalStatus(
|
|
182
|
+
input: ApprovalStatusInput & { forge: Pick<PrForge, "prApproved" | "kind" | "setStatus" | "runUrl"> },
|
|
183
|
+
words: CiProductWords = activeProductWords(),
|
|
184
|
+
): Promise<ApprovalStatus> {
|
|
185
|
+
const status = await approvalStatusOf(input);
|
|
186
|
+
await input.forge.setStatus(input.head, {
|
|
187
|
+
context: productStatusContext(words, "approval"),
|
|
188
|
+
state: status.state,
|
|
189
|
+
description: status.description,
|
|
190
|
+
...(input.forge.runUrl ? { url: input.forge.runUrl } : {}),
|
|
191
|
+
});
|
|
192
|
+
return status;
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
/**
|
|
196
|
+
* Post the status on every open pull request into `branch` (#4630), for
|
|
197
|
+
* GitLab's scheduled pipeline: the forge names each head and base. One
|
|
198
|
+
* that fails is a warning, and the rest are posted.
|
|
199
|
+
*/
|
|
200
|
+
export async function postOpenApprovalStatuses(
|
|
201
|
+
input: Omit<ApprovalStatusInput, "pr" | "head" | "base"> & { forge: Pick<PrForge, "prApproved" | "kind" | "setStatus" | "runUrl" | "openPullRequests">; branch: string },
|
|
202
|
+
words: CiProductWords = activeProductWords(),
|
|
203
|
+
): Promise<{ posted: Array<{ pr: number; status: ApprovalStatus }>; warnings: string[] }> {
|
|
204
|
+
if (!input.forge.openPullRequests) throw new Error(`${input.forge.kind} cannot list its open pull requests, so --open is not for it`);
|
|
205
|
+
const posted: Array<{ pr: number; status: ApprovalStatus }> = [];
|
|
206
|
+
const warnings: string[] = [];
|
|
207
|
+
for (const open of await input.forge.openPullRequests(input.branch)) {
|
|
208
|
+
if (open.fork) continue;
|
|
209
|
+
try {
|
|
210
|
+
const status = await postApprovalStatus({ ...input, pr: open.number, head: open.headSha, base: open.baseSha ?? input.branch }, words);
|
|
211
|
+
posted.push({ pr: open.number, status });
|
|
212
|
+
} catch (err) {
|
|
213
|
+
warnings.push(`!${open.number}: ${err instanceof Error ? err.message : String(err)}`);
|
|
214
|
+
}
|
|
215
|
+
}
|
|
216
|
+
return { posted, warnings };
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
async function ledgerHeadPlans(name: string, head: string, cwd: string): Promise<HeadPlans | null> {
|
|
220
|
+
const { gitLedgerReadPort, requireLifecycleLedger } = await import("../lifecycle/git");
|
|
221
|
+
const { readHeadPlans } = await import("../lifecycle/wave-plans");
|
|
222
|
+
await requireLifecycleLedger({ cwd });
|
|
223
|
+
return readHeadPlans(gitLedgerReadPort({ cwd }), name, head);
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
async function ledgerResolutions(op: string, cwd: string): Promise<GateResolutionRecord[]> {
|
|
227
|
+
const { readGateLedger } = await import("../lifecycle/gate-ledger");
|
|
228
|
+
return (await readGateLedger(op, { cwd })).resolutions;
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
async function ledgerChangeSet(digest: string, cwd: string): Promise<ChangeSetDocument | undefined> {
|
|
232
|
+
const { readStoredChangeSet } = await import("../lifecycle/change-set-store");
|
|
233
|
+
const got = await readStoredChangeSet(digest, { cwd });
|
|
234
|
+
return got.status === "found" ? got.document : undefined;
|
|
235
|
+
}
|
|
@@ -177,7 +177,8 @@ describe("a pr-review wave (#3684)", () => {
|
|
|
177
177
|
const h = harness(digest("a"));
|
|
178
178
|
let written: unknown;
|
|
179
179
|
const recorded = await recordOpWaveHeadPlans({ spec: spec("pr-review"), cwd: h.cwd, exec: h.exec, head: HEAD, now: "t", write: async (p) => void (written = p) });
|
|
180
|
-
|
|
180
|
+
// #4630: the record keeps whether the wave changes anything and whether it is destructive.
|
|
181
|
+
expect(recorded.waves).toEqual([{ wave: 1, name: "prod", digest: set(digest("a")), changes: true, destructive: false }]);
|
|
181
182
|
expect(written).toEqual(recorded);
|
|
182
183
|
});
|
|
183
184
|
});
|
package/src/op/gate.ts
CHANGED
|
@@ -32,6 +32,9 @@
|
|
|
32
32
|
* decision without an orphan branch on disk.
|
|
33
33
|
*/
|
|
34
34
|
|
|
35
|
+
import type { ChangeSetDocument } from "../change-set";
|
|
36
|
+
import { persistChangeSet } from "../lifecycle/change-set-store";
|
|
37
|
+
import { activeProductWords, approveLine, isChantWords } from "../ci-product-words";
|
|
35
38
|
import {
|
|
36
39
|
appendGateResolution,
|
|
37
40
|
appendPendingGate,
|
|
@@ -48,7 +51,8 @@ import {
|
|
|
48
51
|
} from "../lifecycle/gate-ledger";
|
|
49
52
|
import { describePlanDigest, samePlanDigest } from "../lifecycle/plan-digest";
|
|
50
53
|
import { isModelAuthored } from "../lifecycle/gate-origin";
|
|
51
|
-
import { appliedGatePath, isApprovalSpent, parseAppliedGateLines, type AppliedGateRecord } from "../lifecycle/gate-applied";
|
|
54
|
+
import { appliedGatePath, isApprovalSpent, parseAppliedGateLines, type AppliedGateRecord, type FinishedGateRecord } from "../lifecycle/gate-applied";
|
|
55
|
+
import { gatedRequestAttachmentPath } from "../lifecycle/gated-request-digest";
|
|
52
56
|
import { sortedJsonReplacer } from "../utils";
|
|
53
57
|
import { gateContextDigest, type GateApprover, type GateBaseApproval, type ResolvedGateApproval } from "./gate-approval";
|
|
54
58
|
import {
|
|
@@ -115,6 +119,19 @@ export interface GateLedgerPort {
|
|
|
115
119
|
readApplied?(op: string): Promise<AppliedGateRecord[]>;
|
|
116
120
|
/** Record that a wave is about to apply under an approval (#3784), which spends it. */
|
|
117
121
|
appendApplied?(record: AppliedGateRecord): Promise<{ pushed: boolean; pushWarning?: string }>;
|
|
122
|
+
/**
|
|
123
|
+
* Record how an apply under an approval ended (#4623): a `finished` line in
|
|
124
|
+
* the same `_gates/<op>/applied.jsonl`, naming the applied line's time.
|
|
125
|
+
* Absent on a port that keeps none.
|
|
126
|
+
*/
|
|
127
|
+
appendFinished?(record: FinishedGateRecord): Promise<{ pushed: boolean; pushWarning?: string }>;
|
|
128
|
+
/**
|
|
129
|
+
* Store a file a held request carries, such as a migration's proof, at
|
|
130
|
+
* `_gates/<op>/requests/<digest>.json` (#4623), once, before the pending
|
|
131
|
+
* fact that asks for it. Pushed with that fact. Absent on a port that
|
|
132
|
+
* keeps none.
|
|
133
|
+
*/
|
|
134
|
+
storeRequestAttachment?(op: string, digest: string, text: string): Promise<void>;
|
|
118
135
|
/**
|
|
119
136
|
* Store the checkpoint of a run that stops at a gate that resumes (#3947),
|
|
120
137
|
* at `_gates/<op>/checkpoints/<runId>.json`. Written before the pending
|
|
@@ -124,6 +141,13 @@ export interface GateLedgerPort {
|
|
|
124
141
|
writeCheckpoint?(checkpoint: GateCheckpoint): Promise<void>;
|
|
125
142
|
/** The text of a run's checkpoint, or null when there is none (#3947). */
|
|
126
143
|
readCheckpoint?(op: string, runId: string): Promise<string | null>;
|
|
144
|
+
/**
|
|
145
|
+
* Store a change-set document under its digest in `_change-sets/`
|
|
146
|
+
* (#4551), before the pending fact that cites it as `changeSet`. Throws for
|
|
147
|
+
* a document that is not one or does not hash to its digest. Absent on a
|
|
148
|
+
* port that keeps none, and the fact then cites none.
|
|
149
|
+
*/
|
|
150
|
+
storeChangeSet?(doc: ChangeSetDocument): Promise<void>;
|
|
127
151
|
}
|
|
128
152
|
|
|
129
153
|
/** A workspace's rule for which approvals of a gate count (#3163): a signed approval, from a class when it names one. */
|
|
@@ -191,6 +215,10 @@ export function gitGateLedgerPort(opts?: { cwd?: string }): GateLedgerPort {
|
|
|
191
215
|
await requireLifecycleLedger(opts);
|
|
192
216
|
return readGateCheckpointText(op, runId, opts);
|
|
193
217
|
},
|
|
218
|
+
async storeChangeSet(doc) {
|
|
219
|
+
// Pushed with the pending fact that cites it.
|
|
220
|
+
await persistChangeSet(doc, opts);
|
|
221
|
+
},
|
|
194
222
|
async readApplied(op) {
|
|
195
223
|
await requireLifecycleLedger(opts);
|
|
196
224
|
const { dir, file } = appliedGatePath(op);
|
|
@@ -198,30 +226,43 @@ export function gitGateLedgerPort(opts?: { cwd?: string }): GateLedgerPort {
|
|
|
198
226
|
return text ? parseAppliedGateLines(text) : [];
|
|
199
227
|
},
|
|
200
228
|
async appendApplied(record) {
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
229
|
+
return appendAppliedFileLine(record.op, record as unknown as Record<string, unknown>, `Applied under ${record.gate}`);
|
|
230
|
+
},
|
|
231
|
+
async appendFinished(record) {
|
|
232
|
+
return appendAppliedFileLine(record.op, record as unknown as Record<string, unknown>, `Finished under ${record.gate}`);
|
|
233
|
+
},
|
|
234
|
+
async storeRequestAttachment(op, digest, text) {
|
|
235
|
+
const { dir, file } = gatedRequestAttachmentPath(op, digest);
|
|
205
236
|
await requireLifecycleLedger(opts);
|
|
206
|
-
|
|
207
|
-
// The same append-and-retry as a ledger line: another writer to the branch is the ordinary case.
|
|
208
|
-
for (let attempt = 1; attempt <= 5; attempt++) {
|
|
209
|
-
try {
|
|
210
|
-
const prior = await readPathSha(dir, file, opts);
|
|
211
|
-
const existing = prior ? await readBlobBySha(prior, opts) : null;
|
|
212
|
-
await writeBlobToPath(dir, file, existing ? `${existing.replace(/\n$/, "")}\n${line}\n` : `${line}\n`, `Applied under ${record.gate}`, {
|
|
213
|
-
...opts,
|
|
214
|
-
expectPriorPathSha: prior,
|
|
215
|
-
});
|
|
216
|
-
return pushLifecycleReport(opts);
|
|
217
|
-
} catch (err) {
|
|
218
|
-
if (!(err instanceof RefCASConflictError)) throw err;
|
|
219
|
-
lastErr = err;
|
|
220
|
-
}
|
|
221
|
-
}
|
|
222
|
-
throw lastErr;
|
|
237
|
+
if ((await readPathSha(dir, file, opts)) === null) await writeBlobToPath(dir, file, text, `Request on ${op}: ${digest}`, opts);
|
|
223
238
|
},
|
|
224
239
|
};
|
|
240
|
+
|
|
241
|
+
/** Append one line to `_gates/<op>/applied.jsonl` on top of the remote's ledger, retrying on a concurrent writer, and push. */
|
|
242
|
+
async function appendAppliedFileLine(op: string, record: Record<string, unknown>, message: string): Promise<{ pushed: boolean; pushWarning?: string }> {
|
|
243
|
+
const { dir, file } = appliedGatePath(op);
|
|
244
|
+
const line = JSON.stringify(record, sortedJsonReplacer);
|
|
245
|
+
// #3985: write on top of the remote's ledger, not a local copy another
|
|
246
|
+
// writer has since moved past, so the push that follows can land.
|
|
247
|
+
await requireLifecycleLedger(opts);
|
|
248
|
+
let lastErr: unknown;
|
|
249
|
+
// The same append-and-retry as a ledger line: another writer to the branch is the ordinary case.
|
|
250
|
+
for (let attempt = 1; attempt <= 5; attempt++) {
|
|
251
|
+
try {
|
|
252
|
+
const prior = await readPathSha(dir, file, opts);
|
|
253
|
+
const existing = prior ? await readBlobBySha(prior, opts) : null;
|
|
254
|
+
await writeBlobToPath(dir, file, existing ? `${existing.replace(/\n$/, "")}\n${line}\n` : `${line}\n`, message, {
|
|
255
|
+
...opts,
|
|
256
|
+
expectPriorPathSha: prior,
|
|
257
|
+
});
|
|
258
|
+
return pushLifecycleReport(opts);
|
|
259
|
+
} catch (err) {
|
|
260
|
+
if (!(err instanceof RefCASConflictError)) throw err;
|
|
261
|
+
lastErr = err;
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
throw lastErr;
|
|
265
|
+
}
|
|
225
266
|
}
|
|
226
267
|
|
|
227
268
|
/** A gate ledger held in memory — what a test, or a caller that has already read the ledger, hands {@link evaluateGate}. */
|
|
@@ -231,6 +272,10 @@ export function memoryGateLedgerPort(
|
|
|
231
272
|
appended: PendingGateRecord[];
|
|
232
273
|
resolved: GateResolutionRecord[];
|
|
233
274
|
applied: AppliedGateRecord[];
|
|
275
|
+
/** The finished lines appended (#4623). */
|
|
276
|
+
finished: FinishedGateRecord[];
|
|
277
|
+
/** Stored request attachments by `<op>/<digest>` (#4623). */
|
|
278
|
+
attachments: Map<string, string>;
|
|
234
279
|
/** Checkpoint texts by `<op>/<runId>` (#3947). */
|
|
235
280
|
checkpoints: Map<string, string>;
|
|
236
281
|
} {
|
|
@@ -240,11 +285,22 @@ export function memoryGateLedgerPort(
|
|
|
240
285
|
const resolved: GateResolutionRecord[] = [];
|
|
241
286
|
const applied: AppliedGateRecord[] = [...(seed.applied ?? [])];
|
|
242
287
|
const checkpoints = new Map<string, string>();
|
|
288
|
+
const finished: FinishedGateRecord[] = [];
|
|
289
|
+
const attachments = new Map<string, string>();
|
|
243
290
|
return {
|
|
244
291
|
appended,
|
|
245
292
|
resolved,
|
|
246
293
|
applied,
|
|
294
|
+
finished,
|
|
295
|
+
attachments,
|
|
247
296
|
checkpoints,
|
|
297
|
+
async appendFinished(record) {
|
|
298
|
+
finished.push(record);
|
|
299
|
+
return { pushed: true };
|
|
300
|
+
},
|
|
301
|
+
async storeRequestAttachment(op, digest, text) {
|
|
302
|
+
if (!attachments.has(`${op}/${digest}`)) attachments.set(`${op}/${digest}`, text);
|
|
303
|
+
},
|
|
248
304
|
async writeCheckpoint(checkpoint) {
|
|
249
305
|
checkpoints.set(`${checkpoint.op}/${checkpoint.runId}`, gateCheckpointText(checkpoint));
|
|
250
306
|
},
|
|
@@ -1040,6 +1096,9 @@ export async function evaluateGate(port: GateLedgerPort, input: GateCheckInput):
|
|
|
1040
1096
|
* it.
|
|
1041
1097
|
*/
|
|
1042
1098
|
export function approveCommand(op: string, gate: string, environment?: string, planDigest?: string, sealed = false): string {
|
|
1099
|
+
// #4550: under a product's words (its bin set them), the product's approve line.
|
|
1100
|
+
const words = activeProductWords();
|
|
1101
|
+
if (!isChantWords(words)) return approveLine(words, { op, gate, digest: planDigest ?? "", sign: sealed, ...(environment !== undefined ? { target: environment } : {}) });
|
|
1043
1102
|
return `chant approve ${op} ${gate}` +
|
|
1044
1103
|
(environment === undefined ? "" : ` --env ${environment}`) +
|
|
1045
1104
|
(planDigest === undefined ? "" : ` --plan ${planDigest}`) +
|
|
@@ -28,6 +28,7 @@ import {
|
|
|
28
28
|
type OpWavesPipelineOptions,
|
|
29
29
|
} from "../lexicon";
|
|
30
30
|
import { assertOpWavesSpec, type OpWaveJob, type OpWavesSpec } from "./op-waves";
|
|
31
|
+
import { activeProductWords } from "../ci-product-words";
|
|
31
32
|
|
|
32
33
|
/**
|
|
33
34
|
* Load a lexicon's plugin (`@intentius/chant-lexicon-<name>`) to reach its
|
|
@@ -158,7 +159,12 @@ export async function generateOpWavesPipeline(
|
|
|
158
159
|
return { success: false, error: `Unknown Op(s): ${unknown.join(", ")}.${known ? ` Known Ops: ${known}` : " No Ops discovered."}` };
|
|
159
160
|
}
|
|
160
161
|
try {
|
|
161
|
-
|
|
162
|
+
// #4607: a product's bin, when it runs the generator in process with its words, is the command in each job.
|
|
163
|
+
const active = activeProductWords();
|
|
164
|
+
const bin = options.bin ?? active.bin;
|
|
165
|
+
// #4617: the control dispatch speaks in the product's words too.
|
|
166
|
+
const words = options.words ?? (spec.control ? active : undefined);
|
|
167
|
+
const { files, jobs } = plugin.generateOpWavesPipeline(spec, { ...options, ...(bin ? { bin } : {}), ...(words ? { words } : {}) });
|
|
162
168
|
return { success: true, files, jobs };
|
|
163
169
|
} catch (err) {
|
|
164
170
|
return { success: false, error: err instanceof Error ? err.message : String(err) };
|
package/src/op/index.ts
CHANGED
|
@@ -78,7 +78,9 @@ export {
|
|
|
78
78
|
runStageHooksAsync,
|
|
79
79
|
spawnExecAsync,
|
|
80
80
|
opWaveNeedsApproval,
|
|
81
|
+
opWavePlanPath,
|
|
81
82
|
opWavePlansPath,
|
|
83
|
+
OP_WAVE_PLAN_PATH_FLOOR,
|
|
82
84
|
opWaveRunsPath,
|
|
83
85
|
opWaveSetDigest,
|
|
84
86
|
parseOpWavesSpec,
|
|
@@ -87,6 +89,7 @@ export {
|
|
|
87
89
|
readOpWavePolicy,
|
|
88
90
|
runOpWave,
|
|
89
91
|
runOpWaveApplyHooks,
|
|
92
|
+
opWaveResourceLines,
|
|
90
93
|
} from "./op-waves-run";
|
|
91
94
|
export type {
|
|
92
95
|
OpWaveBaseRules,
|
|
@@ -115,7 +118,27 @@ export type {
|
|
|
115
118
|
RunOpWaveOptions,
|
|
116
119
|
RunOpWaveResult,
|
|
117
120
|
} from "./op-waves-run";
|
|
121
|
+
export {
|
|
122
|
+
OP_WAVE_COST_FORMATS,
|
|
123
|
+
OP_WAVE_COST_MEMBER,
|
|
124
|
+
opWaveCostVerdict,
|
|
125
|
+
opWaveHoldsAt,
|
|
126
|
+
opWaveHoldsProblems,
|
|
127
|
+
opWaveStepInput,
|
|
128
|
+
opWaveStepProblems,
|
|
129
|
+
readCostEstimate,
|
|
130
|
+
} from "./op-waves-capability";
|
|
131
|
+
export type { OpWaveCostFormat, OpWaveCostHold, OpWaveCostVerdict, OpWaveHolds, OpWaveRunCost, OpWaveStep, OpWaveStepApply, OpWaveStepPlan } from "./op-waves-capability";
|
|
118
132
|
export { notifyOpWave, opWaveNotifyFields } from "./op-waves-notify";
|
|
133
|
+
export { OP_WAVE_STAND_DOWN_FLOOR, gitOpWaveNewerCommit, newerCommitOnBranch, opWaveRunBranch, opWaveStandDownReason, tipAppliesTargets } from "./op-waves-stand-down";
|
|
134
|
+
export type { OpWaveNewerCommit, OpWaveNewerCommitPort } from "./op-waves-stand-down";
|
|
135
|
+
export { OP_WAVE_RELEASE_RECORD_FLOOR, opWaveReleaseNames, opWaveReleaseProblems, releaseOfCommit } from "./op-waves-release";
|
|
136
|
+
export { gitOpWaveReleasePort } from "./op-waves-release-port";
|
|
137
|
+
export type { OpWaveReleaseNames, OpWaveReleaseOutcome, OpWaveReleasePort, OpWaveReleaseRequest } from "./op-waves-release";
|
|
138
|
+
export { foldPolicyRows, opWaveAfterPlanProblems, opWaveAfterPlanResultProblems, runOpWaveAfterPlanHooks } from "./op-waves-after-plan";
|
|
139
|
+
export type { OpWaveAfterPlanHook, OpWaveAfterPlanOutcome, OpWaveAfterPlanResult, OpWaveAfterPlanRun, OpWaveAfterPlanRunOutcome } from "./op-waves-after-plan";
|
|
140
|
+
export { OP_WAVE_AFTER_PLAN_FLOOR } from "./runtime";
|
|
141
|
+
export type { OpRunPolicyRow, OpRunWave, OpRunWavePlan, OpRunWaveTarget } from "./runtime";
|
|
119
142
|
export type { OpWaveOutcome } from "./op-waves-notify";
|
|
120
143
|
export { loadActivities, loadProfiles, resolveActivity } from "./activity-registry";
|
|
121
144
|
export type { ActivityFn } from "./activity-registry";
|