@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,200 @@
|
|
|
1
|
+
import { describe, expect, test } from "vitest";
|
|
2
|
+
import { componentWaveOutputsFile, componentWaveSteps, componentWavesSpec, productDriftAgent, productPipelineJobs, productWavesSpec } from "./product-pipeline";
|
|
3
|
+
import { prApplyComment, prLoopSetup, PR_LOOP_IMAGE, PR_LOOP_SETUP, withProductBin } from "./pr-pipeline";
|
|
4
|
+
import { PLYWOOD, TERRAGUCCI } from "../__fixtures__/product-words";
|
|
5
|
+
import type { OpWavesSpec } from "../op/op-waves";
|
|
6
|
+
import { resolveControlTarget } from "../control/dispatch";
|
|
7
|
+
import type { CiProductCommand } from "../ci-product-words";
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* `w` with only the commands (and aliases) a pipeline with `jobs` answers:
|
|
11
|
+
* #4550 refuses words naming a command the pipeline has no job for, so a
|
|
12
|
+
* test that builds fewer jobs passes words that name fewer commands.
|
|
13
|
+
*/
|
|
14
|
+
function only<W extends { commands: Record<string, CiProductCommand>; aliases?: readonly { command: CiProductCommand }[] }>(w: W, ...jobs: CiProductCommand[]): W {
|
|
15
|
+
const commands = Object.fromEntries(Object.entries(w.commands).filter(([, c]) => jobs.includes(c)));
|
|
16
|
+
return { ...w, commands, ...(w.aliases ? { aliases: w.aliases.filter((a) => jobs.includes(a.command)) } : {}) };
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
const waves: OpWavesSpec = {
|
|
20
|
+
name: "apply",
|
|
21
|
+
op: "apply",
|
|
22
|
+
planWave: ["chant", "components", "plan-wave", "{runs}", "{plans}"],
|
|
23
|
+
applyWave: ["chant", "components", "apply-wave", "{runs}", "{plans}"],
|
|
24
|
+
waves: [
|
|
25
|
+
{ name: "dev", runs: [{ target: "shop-dev" }] },
|
|
26
|
+
{ name: "prod", runs: [{ target: "shop-prod" }] },
|
|
27
|
+
],
|
|
28
|
+
};
|
|
29
|
+
|
|
30
|
+
describe("the product pipeline (#4550)", () => {
|
|
31
|
+
test("terragucci's and plywood's jobs differ only in the words each passes", () => {
|
|
32
|
+
const tg = productPipelineJobs("github", "production", { words: TERRAGUCCI, waves, applyBeforeMerge: false, locks: "plan", agent: true });
|
|
33
|
+
const pw = productPipelineJobs("github", "production", { words: PLYWOOD, waves, locks: "plan" });
|
|
34
|
+
const shape = (j: typeof tg) => ({ plan: Object.keys(j.plan.env).sort(), waves: j.waves!.jobs.map((w) => w.jobName) });
|
|
35
|
+
expect(shape(tg)).toEqual(shape(pw));
|
|
36
|
+
expect(tg.waves!.spec.name).toBe("tf-apply");
|
|
37
|
+
expect(pw.waves!.spec.name).toBe("pulumi-up");
|
|
38
|
+
expect(tg.waves!.spec.gateName).toBe("wave-{k}");
|
|
39
|
+
expect(pw.waves!.spec.gateName).toBe("wave-{k}");
|
|
40
|
+
});
|
|
41
|
+
|
|
42
|
+
test("the plan side runs the product's bin, and ci run passes it on", () => {
|
|
43
|
+
const pw = productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan") });
|
|
44
|
+
expect(pw.plan.command.startsWith("npx --no-install plywood components pr-plan ")).toBe(true);
|
|
45
|
+
expect(pw.plan.command).toContain("--gate up");
|
|
46
|
+
expect(pw.plan.run.command.startsWith('npx --no-install plywood ci run plan --chant "npx --no-install plywood" --in-place')).toBe(true);
|
|
47
|
+
expect(pw.post.command.startsWith("npx --no-install plywood components pr-post ")).toBe(true);
|
|
48
|
+
expect(pw.record).toBeDefined();
|
|
49
|
+
expect(pw.waves).toBeUndefined();
|
|
50
|
+
});
|
|
51
|
+
|
|
52
|
+
test("the apply on merge runs on op waves through the product's bin", () => {
|
|
53
|
+
const pw = productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan", "apply"), waves });
|
|
54
|
+
expect(pw.record).toBeUndefined();
|
|
55
|
+
expect(pw.waves!.specFile).toBe(".chant/op-waves/pulumi-up.spec.json");
|
|
56
|
+
expect(pw.waves!.jobs[0]!.command.slice(0, 6)).toEqual(["npx", "--no-install", "plywood", "run", "wave", "--spec"]);
|
|
57
|
+
expect(pw.comments).toEqual({ plan: "/plywood preview", apply: "/plywood up" });
|
|
58
|
+
});
|
|
59
|
+
|
|
60
|
+
test("the approval preset: per wave for terragucci, the pull request's digest for plywood", () => {
|
|
61
|
+
const tg = productWavesSpec(waves, TERRAGUCCI);
|
|
62
|
+
expect(tg.waves.every((w) => w.approval === undefined)).toBe(true);
|
|
63
|
+
expect(tg.approvals?.pullRequest).toBeUndefined();
|
|
64
|
+
const pw = productWavesSpec(waves, PLYWOOD);
|
|
65
|
+
expect(pw.waves.every((w) => w.approval === "pull-request")).toBe(true);
|
|
66
|
+
expect(pw.approvals?.pullRequest).toEqual({ gate: "up" });
|
|
67
|
+
});
|
|
68
|
+
|
|
69
|
+
test("the words the jobs carry take the apply mode the jobs build (#4601)", () => {
|
|
70
|
+
expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan", "apply"), waves }).words.applyMode).toBe("on-merge");
|
|
71
|
+
expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan") }).words.applyMode).toBe("release");
|
|
72
|
+
expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan", "apply"), applyBeforeMerge: true }).words.applyMode).toBe("before-merge");
|
|
73
|
+
expect(productPipelineJobs("github", "production", { words: { ...only(PLYWOOD, "plan", "apply"), applyMode: "before-merge" }, waves, applyBeforeMerge: true }).words.applyMode).toBe("before-merge");
|
|
74
|
+
expect(productPipelineJobs("github", "production", { words: { ...only(PLYWOOD, "plan", "apply"), applyMode: "before-merge" }, waves }).words.applyMode).toBe("on-merge");
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
test("a command with no job is refused", () => {
|
|
78
|
+
expect(() => productPipelineJobs("github", "production", { words: TERRAGUCCI })).toThrow(/needs a apply job/);
|
|
79
|
+
});
|
|
80
|
+
|
|
81
|
+
test("the component graph gives the waves pr-apply --wave-gate runs on op waves", () => {
|
|
82
|
+
const spec = componentWavesSpec(
|
|
83
|
+
[{ name: "net", dependsOn: [] }, { name: "app", dependsOn: ["net"] }],
|
|
84
|
+
PLYWOOD,
|
|
85
|
+
{ planWave: ["chant", "components", "plan-wave", "{runs}", "{plans}"], applyWave: ["chant", "components", "apply-wave", "{runs}", "{plans}"] },
|
|
86
|
+
);
|
|
87
|
+
expect(spec.name).toBe("pulumi-up");
|
|
88
|
+
expect(spec.waves.map((w) => w.runs.map((r) => r.target))).toEqual([["net"], ["app"]]);
|
|
89
|
+
});
|
|
90
|
+
|
|
91
|
+
test("the comment, the bin and the engine lines", () => {
|
|
92
|
+
expect(prApplyComment()).toBe("/chant apply");
|
|
93
|
+
expect(prApplyComment({ words: PLYWOOD })).toBe("/plywood up");
|
|
94
|
+
expect(withProductBin('git fetch && GREEN_SHA="$(chant ci last-green)"', "npx plywood")).toBe('git fetch && GREEN_SHA="$(npx plywood ci last-green)"');
|
|
95
|
+
expect(withProductBin("chant/lifecycle stays", "npx plywood")).toBe("chant/lifecycle stays");
|
|
96
|
+
expect(prLoopSetup(PR_LOOP_IMAGE)).toEqual(PR_LOOP_SETUP);
|
|
97
|
+
expect(prLoopSetup(PR_LOOP_IMAGE, ["install pulumi"])).toEqual(["install pulumi"]);
|
|
98
|
+
expect(prLoopSetup("my/image", ["install pulumi"])).toEqual([]);
|
|
99
|
+
});
|
|
100
|
+
});
|
|
101
|
+
|
|
102
|
+
describe("pr-apply --wave-gate on op waves (#4588)", () => {
|
|
103
|
+
const graph = [{ name: "net", dependsOn: [] }, { name: "app", dependsOn: ["net"] }];
|
|
104
|
+
|
|
105
|
+
test("the component plan-wave and apply-wave steps name the runs, the plans, the base and the outputs file", () => {
|
|
106
|
+
const steps = componentWaveSteps({ bin: "npx --no-install plywood", env: "prod", base: "abc123", member: "infra", op: "pr-7", gate: "up" });
|
|
107
|
+
expect(steps.planWave).toEqual(["npx", "--no-install", "plywood", "components", "plan-wave", "--runs", "{runs}", "--plans", "{plans}", "--env", "prod", "--base", "abc123", "--member", "infra", "--gate", "up", "--wave-outputs", componentWaveOutputsFile("pr-7")]);
|
|
108
|
+
expect(steps.applyWave.slice(0, 5)).toEqual(["npx", "--no-install", "plywood", "components", "apply-wave"]);
|
|
109
|
+
expect(componentWaveSteps({ env: "prod", base: "HEAD^1", op: "x" }).planWave[0]).toBe("chant");
|
|
110
|
+
});
|
|
111
|
+
|
|
112
|
+
test("under the pull request's op every wave takes its approval, whatever the words' preset", () => {
|
|
113
|
+
const steps = componentWaveSteps({ env: "prod", base: "abc", op: "pr-7" });
|
|
114
|
+
const spec = componentWavesSpec(graph, TERRAGUCCI, steps, { op: "pr-7", gate: "apply", prGate: "pr-apply" });
|
|
115
|
+
expect(spec.name).toBe("pr-7");
|
|
116
|
+
expect(spec.op).toBe("pr-7");
|
|
117
|
+
expect(spec.waves.every((w) => w.approval === "pull-request")).toBe(true);
|
|
118
|
+
expect(spec.approvals?.pullRequest).toEqual({ gate: "pr-apply" });
|
|
119
|
+
expect(spec.planWave).toEqual(steps.planWave);
|
|
120
|
+
});
|
|
121
|
+
|
|
122
|
+
test("the layers a derivation already has are kept", () => {
|
|
123
|
+
const spec = componentWavesSpec(graph, PLYWOOD, componentWaveSteps({ env: "prod", base: "abc", op: "pr-7" }), { op: "pr-7", waves: [["net", "app"]] });
|
|
124
|
+
expect(spec.waves.map((w) => w.runs.map((r) => r.target))).toEqual([["net", "app"]]);
|
|
125
|
+
});
|
|
126
|
+
|
|
127
|
+
test("productPipelineJobs takes the component graph's waves when the product has no spec of its own", () => {
|
|
128
|
+
const jobs = productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan", "apply"), componentWaves: { components: graph } });
|
|
129
|
+
expect(jobs.waves!.spec.name).toBe("pulumi-up");
|
|
130
|
+
expect(jobs.waves!.spec.planWave!.slice(3, 5)).toEqual(["components", "plan-wave"]);
|
|
131
|
+
expect(jobs.waves!.spec.planWave).toContain("HEAD^1");
|
|
132
|
+
expect(jobs.waves!.jobs.map((j) => j.jobName)).toEqual(["wave-1-wave-1", "wave-2-wave-2"]);
|
|
133
|
+
expect(jobs.waves!.jobs[0]!.command.slice(0, 3)).toEqual(["npx", "--no-install", "plywood"]);
|
|
134
|
+
});
|
|
135
|
+
});
|
|
136
|
+
|
|
137
|
+
describe("the lock and unlock comments (#4588)", () => {
|
|
138
|
+
test("productPipelineJobs gives a job per comment under locks: plan, on each forge", () => {
|
|
139
|
+
for (const forge of ["github", "forgejo", "gitlab"] as const) {
|
|
140
|
+
const jobs = productPipelineJobs(forge, "production", { words: PLYWOOD, waves, locks: "plan" });
|
|
141
|
+
expect(jobs.locks!.map((j) => [j.jobName, j.comment])).toEqual([["comment-lock", "/plywood lock"], ["comment-unlock", "/plywood unlock"]]);
|
|
142
|
+
expect(jobs.locks![0]!.line).toBe(`npx --no-install plywood lock --keep --pr "$PR_NUMBER" --forge ${forge}`);
|
|
143
|
+
expect(jobs.locks![1]!.line).toBe('npx --no-install plywood unlock --pr "$PR_NUMBER"');
|
|
144
|
+
}
|
|
145
|
+
const gitlab = productPipelineJobs("gitlab", "production", { words: PLYWOOD, waves, locks: "plan" });
|
|
146
|
+
expect(gitlab.locks![0]!.env).toEqual({ PR_NUMBER: "$CHANT_LOCK_PR" });
|
|
147
|
+
expect(gitlab.locks![0]!.gitlabVar).toBe("CHANT_LOCK_PR");
|
|
148
|
+
});
|
|
149
|
+
|
|
150
|
+
test("no comment jobs without locks: plan", () => {
|
|
151
|
+
expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan", "apply"), waves }).locks).toBeUndefined();
|
|
152
|
+
});
|
|
153
|
+
});
|
|
154
|
+
|
|
155
|
+
describe("the agent (#4616)", () => {
|
|
156
|
+
const words = { ...PLYWOOD, commands: { ...PLYWOOD.commands, agent: "agent" as const } };
|
|
157
|
+
|
|
158
|
+
test("returns the agent's Op spec for its comment, with the settings checked", () => {
|
|
159
|
+
const pw = productPipelineJobs("github", "production", { words: only(words, "plan", "agent"), agent: { maxRuns: 5, timeout: 20, keyEnv: "MODEL_KEY", runner: "agents" } });
|
|
160
|
+
expect(pw.agent?.comment).toBe("/plywood agent");
|
|
161
|
+
expect(pw.agent?.spec).toEqual({
|
|
162
|
+
name: "plywood-agent",
|
|
163
|
+
trigger: { kind: "pull_request" },
|
|
164
|
+
agent: { on: "comment", comment: "/plywood agent", maxRuns: 5, timeout: 20, keyEnv: "MODEL_KEY" },
|
|
165
|
+
runner: "agents",
|
|
166
|
+
});
|
|
167
|
+
expect(() => productPipelineJobs("github", "production", { words: only(words, "plan", "agent"), agent: { timeout: 0 } })).toThrow(/timeout/);
|
|
168
|
+
});
|
|
169
|
+
|
|
170
|
+
test("a product whose words name no agent command gets no agent", () => {
|
|
171
|
+
expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan"), agent: true }).agent).toBeUndefined();
|
|
172
|
+
expect(productPipelineJobs("github", "production", { words: only(PLYWOOD, "plan") }).agent).toBeUndefined();
|
|
173
|
+
});
|
|
174
|
+
|
|
175
|
+
test("the drift agent of a scheduled drift Op", () => {
|
|
176
|
+
expect(productDriftAgent(words, "plywood-drift-app", { maxRuns: 2 })).toEqual({ on: "drift", maxRuns: 2 });
|
|
177
|
+
expect(() => productDriftAgent(words, "plywood-drift-app", { branch: "../x" })).toThrow(/branch/);
|
|
178
|
+
});
|
|
179
|
+
});
|
|
180
|
+
|
|
181
|
+
// #4619: with a control repo on the loop or on the waves spec, the note job reads it before pr-post.
|
|
182
|
+
describe("the note job's read of the control repo (#4619)", () => {
|
|
183
|
+
test("the waves spec's control gives the note job its read step", () => {
|
|
184
|
+
const pw = productPipelineJobs("gitlab", "production", { words: only(PLYWOOD, "plan", "apply"), waves: { ...waves, control: { repo: "gitlab.com/acme/control", op: "deploy", member: "shop" } } });
|
|
185
|
+
expect(pw.post.control?.script).toContain("'https://gitlab.com/acme/control.git' '+refs/heads/chant/lifecycle:refs/heads/chant/lifecycle'");
|
|
186
|
+
expect(pw.post.control?.script).toContain('export CHANT_CONTROL_DIR="$chant_control_dir"');
|
|
187
|
+
expect(pw.post.control?.script).toContain("plywood: could not read the control repo");
|
|
188
|
+
});
|
|
189
|
+
|
|
190
|
+
test("the loop's control does too, with the read secret it names", () => {
|
|
191
|
+
const target = resolveControlTarget({ repo: "github.com/acme/control", op: "deploy", readTokenSecret: "TG_CONTROL_READ" }, "network");
|
|
192
|
+
const tg = productPipelineJobs("github", "production", { words: only(TERRAGUCCI, "plan"), control: { target } });
|
|
193
|
+
expect(tg.post.control?.env).toEqual({ CHANT_CONTROL_READ_TOKEN: "${{ secrets.TG_CONTROL_READ || github.token }}" });
|
|
194
|
+
});
|
|
195
|
+
|
|
196
|
+
test("without a control repo the note job reads none", () => {
|
|
197
|
+
expect(productPipelineJobs("forgejo", "production", { words: only(PLYWOOD, "plan", "apply"), waves }).post.control).toBeUndefined();
|
|
198
|
+
});
|
|
199
|
+
});
|
|
200
|
+
|
|
@@ -0,0 +1,383 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The product pipeline (#4550): the one chant generator terragucci's and
|
|
3
|
+
* plywood's pull request jobs come from. The two differ only in the words
|
|
4
|
+
* and presets each passes.
|
|
5
|
+
*
|
|
6
|
+
* Under the 2026-10-27 ruling (A, hybrid) the plan side is the pull request
|
|
7
|
+
* loop's: the plan job (`pr-plan`), the plan-note job (`pr-post`) and the
|
|
8
|
+
* comment jobs. The apply on merge runs on op waves: one job per wave, each
|
|
9
|
+
* running `chant run wave`, whose plan and apply steps come from chant's
|
|
10
|
+
* capabilities (#4545 for Terraform, #4541 for Pulumi and plunge). The spec
|
|
11
|
+
* names the steps; this module fills the op and gate names from the words
|
|
12
|
+
* and leaves the steps as the spec gives them.
|
|
13
|
+
*
|
|
14
|
+
* Approvals (ruling B) are a preset: `per-wave` keeps each wave's own digest
|
|
15
|
+
* (terragucci), and `pull-request` lets the pull request's approval apply
|
|
16
|
+
* every wave whose plan its change set covers (plywood), through the op
|
|
17
|
+
* waves' `pull-request` approval source (../op/op-waves.ts).
|
|
18
|
+
*
|
|
19
|
+
* The jobs come back as the descriptors the forge lexicons already
|
|
20
|
+
* serialize (`PrLoopJob`, `OpWaveJob`). A product adds its own jobs to the
|
|
21
|
+
* same map before it writes the file.
|
|
22
|
+
*/
|
|
23
|
+
|
|
24
|
+
import type { ForgeKind } from "../pr-forge";
|
|
25
|
+
import { layerWaves } from "../gated-waves";
|
|
26
|
+
import { opWaveBinArgv, opWaveJobs, opWavesControlTarget, type OpWave, type OpWaveJob, type OpWavesSpec } from "../op/op-waves";
|
|
27
|
+
import { controlNoteCheckout, type ControlNoteCheckout } from "../control/dispatch";
|
|
28
|
+
import {
|
|
29
|
+
assertProductWords,
|
|
30
|
+
CHANT_WORDS,
|
|
31
|
+
commentLine,
|
|
32
|
+
type CiProductApplyMode,
|
|
33
|
+
type CiProductCommand,
|
|
34
|
+
type CiProductWords,
|
|
35
|
+
type CiProductWordsInput,
|
|
36
|
+
} from "../ci-product-words";
|
|
37
|
+
import { prCommentLockJobs, prCommentPreviewJob, prLoopJobs, prLoopPostJob, prLoopRunner, prStaleJob, withProductBin, type PrCommentLockJob, type PrCommentPreviewJob, type PrLoopJob, type PrLoopPipelineOptions } from "./pr-pipeline";
|
|
38
|
+
import type { DriverComponent } from "./driver";
|
|
39
|
+
import type { ScheduledOpSpec } from "../lexicon";
|
|
40
|
+
import type { CiRunner } from "../ci-jobs";
|
|
41
|
+
import { resolveAgentSpec, type OpAgentSpec } from "../ci-agent";
|
|
42
|
+
import type { CiResponses } from "../ci-respond";
|
|
43
|
+
|
|
44
|
+
/** Where the generator writes a product's waves spec, which chant reads at base (#4550). */
|
|
45
|
+
export const PRODUCT_WAVES_SPEC_DIR = ".chant/op-waves";
|
|
46
|
+
|
|
47
|
+
/** The waves spec file of op `name`: `.chant/op-waves/<name>.spec.json`. */
|
|
48
|
+
export function productWavesSpecFile(name: string): string {
|
|
49
|
+
return `${PRODUCT_WAVES_SPEC_DIR}/${name}.spec.json`;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** What {@link productPipelineJobs} takes: the pull request loop's options, the words, and the waves the merge applies. */
|
|
53
|
+
export interface ProductPipelineOptions extends Omit<PrLoopPipelineOptions, "words" | "waveGate" | "applyOnMerge"> {
|
|
54
|
+
words: CiProductWordsInput | CiProductWords;
|
|
55
|
+
/** The workspace member the pipeline is for. */
|
|
56
|
+
member?: string;
|
|
57
|
+
/**
|
|
58
|
+
* The waves the apply on merge runs, as the product's config maps onto
|
|
59
|
+
* them. Absent: a merge records the plan (the record job), and a release
|
|
60
|
+
* deploys it.
|
|
61
|
+
*/
|
|
62
|
+
waves?: OpWavesSpec;
|
|
63
|
+
/** Where the spec is written, from the job's directory. Default {@link productWavesSpecFile}. */
|
|
64
|
+
wavesSpecFile?: string;
|
|
65
|
+
/**
|
|
66
|
+
* The product runs an agent job that answers its agent command (#4616):
|
|
67
|
+
* `true` for the defaults, or the agent's settings. The pipeline then
|
|
68
|
+
* returns the agent's Op spec, which the product writes and generates with
|
|
69
|
+
* `chant run --generate <forge> --spec <file>` as it does its other
|
|
70
|
+
* scheduled Ops.
|
|
71
|
+
*/
|
|
72
|
+
agent?: boolean | ProductAgentOptions;
|
|
73
|
+
/**
|
|
74
|
+
* The apply on merge from the component graph (#4588), when `waves` is
|
|
75
|
+
* absent: the spec `pr-apply --wave-gate` runs, a wave per layer of
|
|
76
|
+
* `components`, each run a component planned and applied through the
|
|
77
|
+
* component plan-wave and apply-wave steps, a wave whose plan the approval
|
|
78
|
+
* does not cover waiting at `<waveGate>-wave-<k>`. `base` is what the
|
|
79
|
+
* steps measure the change from, by default `HEAD^1`, the commit before
|
|
80
|
+
* the merge.
|
|
81
|
+
*/
|
|
82
|
+
componentWaves?: { components: readonly Pick<DriverComponent, "name" | "dependsOn">[]; waveGate?: string; base?: string };
|
|
83
|
+
/**
|
|
84
|
+
* The responses to pipeline events (#4629, `../ci-respond.ts`): a refused
|
|
85
|
+
* wave's diff and a failed apply's triage, on by default, and the
|
|
86
|
+
* description check, off by default. The apply jobs carry them as
|
|
87
|
+
* `CHANT_RESPOND`, the waves spec as its `respond`.
|
|
88
|
+
*/
|
|
89
|
+
respond?: CiResponses;
|
|
90
|
+
/**
|
|
91
|
+
* The decide service the description check asks (#4629): a
|
|
92
|
+
* `decide.backends` entry of chant.config at the target branch, and the
|
|
93
|
+
* pinned model. Needed with `respond.description: "check"`.
|
|
94
|
+
*/
|
|
95
|
+
decide?: { backend: string; model: string };
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/** The jobs of one product pipeline. */
|
|
99
|
+
export interface ProductPipelineJobs {
|
|
100
|
+
/** The words, every slot filled and checked. */
|
|
101
|
+
words: CiProductWords;
|
|
102
|
+
/** The plan job: `pr-plan` with the words. */
|
|
103
|
+
plan: PrLoopJob;
|
|
104
|
+
/**
|
|
105
|
+
* The plan-note job: `pr-post`. With a control repo named on the loop's
|
|
106
|
+
* `control` or the waves spec's (#4619), `control` is the step the note
|
|
107
|
+
* job runs before `pr-post`: a read-only fetch of the control repo's
|
|
108
|
+
* `chant/lifecycle` that sets `CHANT_CONTROL_DIR`, so the note marks the
|
|
109
|
+
* cross-stack edges.
|
|
110
|
+
*/
|
|
111
|
+
post: { command: string; env: Record<string, string>; control?: ControlNoteCheckout; runner?: CiRunner };
|
|
112
|
+
/** The record job, when no waves apply on merge. */
|
|
113
|
+
record?: PrLoopJob;
|
|
114
|
+
/** The apply before merge, answering the apply comment, with `applyBeforeMerge`. */
|
|
115
|
+
applyBeforeMerge?: PrLoopJob;
|
|
116
|
+
/** The comment each command answers, `/<product> <word>`, for the commands the pipeline has a job for. */
|
|
117
|
+
comments: Partial<Record<CiProductCommand, string>>;
|
|
118
|
+
/** The apply on merge: the spec with the words' names, its file, and a job per wave (per share or group). */
|
|
119
|
+
waves?: { spec: OpWavesSpec; specFile: string; jobs: OpWaveJob[] };
|
|
120
|
+
/**
|
|
121
|
+
* The comment lock and unlock jobs (#4588), under `locks: "plan"`:
|
|
122
|
+
* `/<product> lock` keeps the locks the plan took, `/<product> unlock`
|
|
123
|
+
* releases them. The forge lexicons render the same jobs.
|
|
124
|
+
*/
|
|
125
|
+
locks?: Array<PrCommentLockJob & { runner?: CiRunner }>;
|
|
126
|
+
/**
|
|
127
|
+
* The comment preview (#4620), with `previewComment`: `/<product> <plan
|
|
128
|
+
* word>` plans the pull request's head again with a read token, and the
|
|
129
|
+
* job after it posts the note. The forge lexicons render the same jobs.
|
|
130
|
+
*/
|
|
131
|
+
preview?: PrCommentPreviewJob & { noteRunner?: CiRunner };
|
|
132
|
+
/**
|
|
133
|
+
* The stale marking (#4628), with `staleNotes`: the command and values of
|
|
134
|
+
* the job that runs on a push to the target branch and marks each open
|
|
135
|
+
* pull request's note posted against another commit stale. The forge
|
|
136
|
+
* lexicons render the same job, `stale-notes`.
|
|
137
|
+
*/
|
|
138
|
+
stale?: { command: string; env: Record<string, string>; runner?: CiRunner };
|
|
139
|
+
/**
|
|
140
|
+
* The agent (#4616), with `agent`: the comment it answers, `/<product>
|
|
141
|
+
* agent <ask>`, and the scheduled Op spec whose generated workflow runs
|
|
142
|
+
* it: the agent job with a read token and the model's key, and the push
|
|
143
|
+
* job with the write token.
|
|
144
|
+
*/
|
|
145
|
+
agent?: { comment: string; name: string; spec: ScheduledOpSpec };
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
/** An agent's settings as a product passes them (#4616): {@link OpAgentSpec} without the trigger, which the pipeline names. */
|
|
149
|
+
export interface ProductAgentOptions extends Omit<OpAgentSpec, "on" | "comment" | "branch"> {
|
|
150
|
+
/** The agent's name: its workflow, its jobs and its runs on the ledger. Default `<product>-agent`. */
|
|
151
|
+
name?: string;
|
|
152
|
+
/** Where its jobs run. */
|
|
153
|
+
runner?: CiRunner;
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
/** The agent's Op spec for `/<product> agent <ask>` (#4616). The settings are checked here, so a product finds a bad one when it generates. */
|
|
157
|
+
export function productAgentSpec(wordsIn: CiProductWordsInput | CiProductWords, comment: string, options: ProductAgentOptions = {}): ScheduledOpSpec {
|
|
158
|
+
const words = assertProductWords(wordsIn);
|
|
159
|
+
const { name: given, runner, ...settings } = options;
|
|
160
|
+
const name = given ?? `${words.product}-agent`;
|
|
161
|
+
const agent: OpAgentSpec = { on: "comment", comment, ...settings };
|
|
162
|
+
resolveAgentSpec(name, agent, words.product);
|
|
163
|
+
return { name, trigger: { kind: "pull_request" }, agent, ...(runner !== undefined ? { runner } : {}) };
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
/**
|
|
167
|
+
* The `agent` of a scheduled drift Op (#4616): after the Op's run exits with
|
|
168
|
+
* chant's `drift` code, the agent changes the code to say what is live and
|
|
169
|
+
* opens or updates a pull request from `<product>/agent/<op>`.
|
|
170
|
+
*/
|
|
171
|
+
export function productDriftAgent(wordsIn: CiProductWordsInput | CiProductWords, op: string, options: Omit<OpAgentSpec, "on" | "comment"> = {}): OpAgentSpec {
|
|
172
|
+
const words = assertProductWords(wordsIn);
|
|
173
|
+
const agent: OpAgentSpec = { on: "drift", ...options };
|
|
174
|
+
resolveAgentSpec(op, agent, words.product);
|
|
175
|
+
return agent;
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* The waves spec with the product's names (#4550): the op the gates are
|
|
180
|
+
* recorded under, the wave gate pattern, and under the `pull-request`
|
|
181
|
+
* preset each wave's approval taken from the pull request's gate. A wave
|
|
182
|
+
* that names its own approval keeps it. Nothing else changes, so the plan
|
|
183
|
+
* and apply steps stay the capability steps the spec names.
|
|
184
|
+
*/
|
|
185
|
+
export function productWavesSpec(spec: OpWavesSpec, wordsIn: CiProductWordsInput | CiProductWords): OpWavesSpec {
|
|
186
|
+
const words = assertProductWords(wordsIn);
|
|
187
|
+
const byPullRequest = words.approval === "pull-request";
|
|
188
|
+
return {
|
|
189
|
+
...spec,
|
|
190
|
+
name: words.op ?? spec.name,
|
|
191
|
+
...(words.gateName !== CHANT_WORDS.gateName ? { gateName: words.gateName } : {}),
|
|
192
|
+
waves: spec.waves.map((w): OpWave => (byPullRequest && w.approval === undefined ? { ...w, approval: "pull-request" } : w)),
|
|
193
|
+
...(byPullRequest ? { approvals: { ...(spec.approvals ?? {}), pullRequest: { gate: words.prGate } } } : {}),
|
|
194
|
+
};
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
/**
|
|
198
|
+
* The product pipeline's jobs for `forge` (#4550): the plan side from the
|
|
199
|
+
* pull request loop with the words, and the apply on merge on op waves. The
|
|
200
|
+
* words are refused when a command names a job the pipeline does not have.
|
|
201
|
+
*/
|
|
202
|
+
export function productPipelineJobs(forge: ForgeKind, env: string, options: ProductPipelineOptions): ProductPipelineJobs {
|
|
203
|
+
const jobs: CiProductCommand[] = ["plan"];
|
|
204
|
+
if (options.applyBeforeMerge || options.waves || options.componentWaves) jobs.push("apply");
|
|
205
|
+
if (options.locks === "plan") jobs.push("lock", "unlock");
|
|
206
|
+
if (options.agent) jobs.push("agent");
|
|
207
|
+
// #4601: the note's merge sentence follows the jobs built here: waves on merge, an apply before merge, else a record for a release.
|
|
208
|
+
// Words that ask for before-merge keep it when the pipeline has that job beside its waves.
|
|
209
|
+
const built: CiProductApplyMode = options.waves || options.componentWaves ? "on-merge" : options.applyBeforeMerge ? "before-merge" : "release";
|
|
210
|
+
const applyMode: CiProductApplyMode = options.words.applyMode === "before-merge" && options.applyBeforeMerge ? "before-merge" : built;
|
|
211
|
+
const words = assertProductWords({ ...options.words, applyMode }, { jobs });
|
|
212
|
+
const { waves: given, wavesSpecFile, member, agent: _agent, componentWaves, ...loop } = options;
|
|
213
|
+
const { respond } = options;
|
|
214
|
+
// #4629: the pull request loop puts the responses on the apply and note jobs, as `chant build --pr-loop --respond` does.
|
|
215
|
+
const prLoop: PrLoopPipelineOptions = { ...loop, words, gate: options.gate ?? words.prGate };
|
|
216
|
+
const [plan, apply, record] = prLoopJobs(forge, env, prLoop, member);
|
|
217
|
+
// #4625: the jobs with no stage of their own run on the default runner.
|
|
218
|
+
const runnerOfDefault = prLoopRunner(options, "default");
|
|
219
|
+
const defaultRunner: { runner?: CiRunner } = runnerOfDefault !== undefined ? { runner: runnerOfDefault } : {};
|
|
220
|
+
const comments: Partial<Record<CiProductCommand, string>> = {};
|
|
221
|
+
for (const c of jobs) {
|
|
222
|
+
const line = commentLine(words, c);
|
|
223
|
+
if (line) comments[c] = line;
|
|
224
|
+
}
|
|
225
|
+
// #4619: the loop's control target, else the waves spec's.
|
|
226
|
+
const controlTarget = options.control?.target ?? (given?.control ? opWavesControlTarget(given.control) : undefined);
|
|
227
|
+
const post = prLoopPostJob(forge, env, member, words, { ...(options.staleNotes ? { staleNotes: true } : {}), ...(respond ? { respond } : {}), ...(options.decide ? { decide: options.decide } : {}) });
|
|
228
|
+
const out: ProductPipelineJobs = {
|
|
229
|
+
words,
|
|
230
|
+
plan: plan!,
|
|
231
|
+
post: { ...post, ...(controlTarget ? { control: controlNoteCheckout(forge, controlTarget, words) } : {}), ...defaultRunner },
|
|
232
|
+
comments,
|
|
233
|
+
...(options.applyBeforeMerge ? { applyBeforeMerge: apply! } : {}),
|
|
234
|
+
};
|
|
235
|
+
const locks = prCommentLockJobs(forge, { locks: options.locks, words });
|
|
236
|
+
if (locks.length > 0) out.locks = locks.map((job) => ({ ...job, ...defaultRunner }));
|
|
237
|
+
const stale = prStaleJob(forge, env, prLoop, member);
|
|
238
|
+
if (stale) out.stale = { ...stale, ...defaultRunner };
|
|
239
|
+
const preview = prCommentPreviewJob(forge, env, prLoop, member);
|
|
240
|
+
if (preview) out.preview = { ...preview, ...(defaultRunner.runner !== undefined ? { noteRunner: defaultRunner.runner } : {}) };
|
|
241
|
+
// #4616: the agent answers its comment from a workflow of its own, generated from this spec.
|
|
242
|
+
const agentComment = options.agent ? comments.agent : undefined;
|
|
243
|
+
if (options.agent && agentComment) {
|
|
244
|
+
const spec = productAgentSpec(words, agentComment, options.agent === true ? {} : options.agent);
|
|
245
|
+
out.agent = { comment: agentComment, name: spec.name, spec };
|
|
246
|
+
}
|
|
247
|
+
// #4588: without a spec of the product's own, the component graph's waves on op waves.
|
|
248
|
+
const op = words.op ?? componentWaves?.waveGate ?? words.prGate;
|
|
249
|
+
const spec = given ?? (componentWaves
|
|
250
|
+
? componentWavesSpec(componentWaves.components, words, componentWaveSteps({ ...(words.bin ? { bin: words.bin } : {}), env, base: componentWaves.base ?? "HEAD^1", ...(member ? { member } : {}), op, gate: prLoop.gate }), { ...(componentWaves.waveGate ? { gate: componentWaves.waveGate } : {}) })
|
|
251
|
+
: undefined);
|
|
252
|
+
if (!spec) return { ...out, record: record! };
|
|
253
|
+
const wavesRespond = respond ? Object.fromEntries(Object.entries(respond).filter(([e]) => e !== "description")) : {};
|
|
254
|
+
// #4625: the waves run on the apply runner and with the plan's parallelism, unless the spec names its own.
|
|
255
|
+
const applyRunner = prLoopRunner(options, "apply");
|
|
256
|
+
const named = {
|
|
257
|
+
...productWavesSpec(
|
|
258
|
+
{
|
|
259
|
+
...spec,
|
|
260
|
+
...(spec.runner === undefined && applyRunner !== undefined ? { runner: applyRunner } : {}),
|
|
261
|
+
...(spec.parallelism === undefined && options.parallelism !== undefined && spec.step !== undefined ? { parallelism: options.parallelism } : {}),
|
|
262
|
+
},
|
|
263
|
+
words,
|
|
264
|
+
),
|
|
265
|
+
...(Object.keys(wavesRespond).length > 0 ? { respond: { ...(spec.respond ?? {}), ...wavesRespond } } : {}),
|
|
266
|
+
};
|
|
267
|
+
const specFile = wavesSpecFile ?? productWavesSpecFile(named.name);
|
|
268
|
+
return { ...out, waves: { spec: named, specFile, jobs: opWaveJobs(named, specFile, { bin: words.bin }) } };
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
/** The capability steps a component waves spec runs (#4545, #4541): argv templates over `{runs}` and `{plans}`. */
|
|
272
|
+
export interface ComponentWaveSteps {
|
|
273
|
+
/** Plan every run of a wave through the capability registry, writing `{plans}`. */
|
|
274
|
+
planWave: string[];
|
|
275
|
+
/** Apply a wave's approved set through the capability registry. */
|
|
276
|
+
applyWave: string[];
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
/** Where a component waves spec keeps the outputs each wave's components left, for the next wave's plans (#4588). */
|
|
280
|
+
export function componentWaveOutputsFile(op: string): string {
|
|
281
|
+
return `${PRODUCT_WAVES_SPEC_DIR}/${op}/outputs.json`;
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
/** What {@link componentWaveSteps} names on each step's line (#4588). */
|
|
285
|
+
export interface ComponentWaveStepOptions {
|
|
286
|
+
/** The command in place of `chant`, a product's `words.bin`. */
|
|
287
|
+
bin?: string;
|
|
288
|
+
env: string;
|
|
289
|
+
/** The commit the change is measured from: what `pr-apply` was given. */
|
|
290
|
+
base: string;
|
|
291
|
+
/** The commit applied. Absent: the job's checkout. */
|
|
292
|
+
head?: string;
|
|
293
|
+
/** The workspace member. */
|
|
294
|
+
member?: string;
|
|
295
|
+
/** The file the waves hand outputs on in. Default {@link componentWaveOutputsFile} of `op`. */
|
|
296
|
+
outputs?: string;
|
|
297
|
+
/** The op the outputs file is named by. */
|
|
298
|
+
op: string;
|
|
299
|
+
/** The pull request's gate, whose rows file the apply leases on the resource grain. */
|
|
300
|
+
gate?: string;
|
|
301
|
+
}
|
|
302
|
+
|
|
303
|
+
/**
|
|
304
|
+
* The component plan-wave and apply-wave steps (#4588): `chant components
|
|
305
|
+
* plan-wave` plans a wave's components through the project's capabilities
|
|
306
|
+
* and writes the op-waves plans file with the wave's change set, and
|
|
307
|
+
* `chant components apply-wave` plans the approved runs again, refuses any
|
|
308
|
+
* whose plan moved (exit 4), and applies the rest. Both read the outputs
|
|
309
|
+
* the waves before them left from the outputs file, and apply-wave adds its
|
|
310
|
+
* own.
|
|
311
|
+
*/
|
|
312
|
+
export function componentWaveSteps(options: ComponentWaveStepOptions): ComponentWaveSteps {
|
|
313
|
+
const bin = opWaveBinArgv(options.bin);
|
|
314
|
+
const common = [
|
|
315
|
+
"--env", options.env, "--base", options.base,
|
|
316
|
+
...(options.head ? ["--head", options.head] : []),
|
|
317
|
+
...(options.member ? ["--member", options.member] : []),
|
|
318
|
+
...(options.gate ? ["--gate", options.gate] : []),
|
|
319
|
+
"--wave-outputs", options.outputs ?? componentWaveOutputsFile(options.op),
|
|
320
|
+
];
|
|
321
|
+
return {
|
|
322
|
+
planWave: [...bin, "components", "plan-wave", "--runs", "{runs}", "--plans", "{plans}", ...common],
|
|
323
|
+
applyWave: [...bin, "components", "apply-wave", "--runs", "{runs}", "--plans", "{plans}", ...common],
|
|
324
|
+
};
|
|
325
|
+
}
|
|
326
|
+
|
|
327
|
+
/** What {@link componentWavesSpec} takes beside the graph, the words and the steps. */
|
|
328
|
+
export interface ComponentWavesSpecOptions {
|
|
329
|
+
/** The wave gate's base name: wave k waits at `<gate>-wave-<k>` (or the words' `gateName`). Default the words' `prGate`. */
|
|
330
|
+
gate?: string;
|
|
331
|
+
branches?: string[];
|
|
332
|
+
/**
|
|
333
|
+
* The op the gates are recorded under. `pr-apply --wave-gate` passes the
|
|
334
|
+
* pull request's (`pr-<n>`), and then every wave takes the pull request's
|
|
335
|
+
* approval whatever the words' preset. Default the words' `op`.
|
|
336
|
+
*/
|
|
337
|
+
op?: string;
|
|
338
|
+
/** The pull request's gate, whose approval a wave applies under when it covers the wave. Default the words' `prGate`. */
|
|
339
|
+
prGate?: string;
|
|
340
|
+
/** The layers, when the caller already has them (a derivation's `waves`). Default: layered from `dependsOn`. */
|
|
341
|
+
waves?: readonly (readonly string[])[];
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
/**
|
|
345
|
+
* A waves spec from the component graph (#4550, ruling A; #4588): a wave per
|
|
346
|
+
* layer of the graph, each run a component, planned and applied through the
|
|
347
|
+
* component plan-wave and apply-wave steps under the words' op and gate
|
|
348
|
+
* names. `pr-apply --wave-gate` runs its waves on it.
|
|
349
|
+
*/
|
|
350
|
+
export function componentWavesSpec(
|
|
351
|
+
components: readonly Pick<DriverComponent, "name" | "dependsOn">[],
|
|
352
|
+
wordsIn: CiProductWordsInput | CiProductWords,
|
|
353
|
+
steps: ComponentWaveSteps,
|
|
354
|
+
options: ComponentWavesSpecOptions = {},
|
|
355
|
+
): OpWavesSpec {
|
|
356
|
+
const words = assertProductWords(wordsIn);
|
|
357
|
+
const layers = options.waves ?? layerWaves(components.map((c) => ({ name: c.name, dependsOn: c.dependsOn ?? [] })));
|
|
358
|
+
const name = options.op ?? words.op ?? options.gate ?? words.prGate;
|
|
359
|
+
const spec: OpWavesSpec = {
|
|
360
|
+
name,
|
|
361
|
+
op: name,
|
|
362
|
+
gate: options.gate ?? words.prGate,
|
|
363
|
+
planWave: steps.planWave,
|
|
364
|
+
applyWave: steps.applyWave,
|
|
365
|
+
...(options.branches ? { branches: options.branches } : {}),
|
|
366
|
+
waves: layers.map((layer, i) => ({ name: `wave-${i + 1}`, runs: layer.map((target) => ({ target })) })),
|
|
367
|
+
};
|
|
368
|
+
const named = productWavesSpec(spec, words);
|
|
369
|
+
if (options.op === undefined) return named;
|
|
370
|
+
// The pull request's own op: every wave applies under its approval when that covers the wave's plan, else at its own gate.
|
|
371
|
+
return {
|
|
372
|
+
...named,
|
|
373
|
+
name: options.op,
|
|
374
|
+
op: options.op,
|
|
375
|
+
waves: named.waves.map((w) => ({ ...w, approval: "pull-request" as const })),
|
|
376
|
+
approvals: { ...(named.approvals ?? {}), pullRequest: { gate: options.prGate ?? words.prGate } },
|
|
377
|
+
};
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
/** A shell line with the product's bin in place of `chant`, for a product's own jobs beside these. */
|
|
381
|
+
export function productCommand(words: CiProductWords, line: string): string {
|
|
382
|
+
return withProductBin(line, words.bin);
|
|
383
|
+
}
|
|
@@ -61,6 +61,8 @@ import { planAndRunComponentGroup, runComponentGroup } from "./groups";
|
|
|
61
61
|
import type { Release } from "../lifecycle/release-store";
|
|
62
62
|
import type { RunProgressEvent } from "./run-progress";
|
|
63
63
|
import type { RunEventSink } from "../run-event-stream";
|
|
64
|
+
import type { LockGrain } from "../lifecycle/lock-rows";
|
|
65
|
+
import type { RowLeasePort } from "./row-lease";
|
|
64
66
|
|
|
65
67
|
/**
|
|
66
68
|
* Step kinds that produce an artifact at build time: the build family, and the
|
|
@@ -651,6 +653,10 @@ export interface RunPromotionOptions {
|
|
|
651
653
|
groupRuns?: readonly GroupRun[];
|
|
652
654
|
/** A promote with no release gate to bind plans each group in its wave (#4465). */
|
|
653
655
|
planGroupsAtWave?: boolean;
|
|
656
|
+
/** `ci.lockGrain` as declared (#4594), for every step's `DeployContext.lockGrain`. */
|
|
657
|
+
lockGrain?: LockGrain;
|
|
658
|
+
/** The run's row lease (#4594): a step or group on the resource grain leases its rows through it before it applies. Absent: no lease. */
|
|
659
|
+
rowLease?: RowLeasePort;
|
|
654
660
|
}
|
|
655
661
|
|
|
656
662
|
/** The run in `runs` that plans exactly the members of `group`. */
|
|
@@ -678,6 +684,8 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
|
|
|
678
684
|
const item = plan.items.find((i) => i.component === component);
|
|
679
685
|
return item ? { version: item.digest, revision: item.source.gitSha } : undefined;
|
|
680
686
|
};
|
|
687
|
+
// #4594: the grain and the row lease reach every step and group.
|
|
688
|
+
const leasing = { ...(options.lockGrain ? { lockGrain: options.lockGrain } : {}), ...(options.rowLease ? { rowLease: options.rowLease } : {}) };
|
|
681
689
|
// ws-107 (#4465): a group applies as one, through its approved plan.
|
|
682
690
|
const grouped = options.grouped?.groups?.length ? options.grouped : undefined;
|
|
683
691
|
const byName = new Map(targets.map((c) => [c.name, c]));
|
|
@@ -691,7 +699,7 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
|
|
|
691
699
|
components: byName,
|
|
692
700
|
registry,
|
|
693
701
|
env: plan.to,
|
|
694
|
-
ctxOf: (name: string) => deployContext({ env: plan.to, releaseIdentity }, name),
|
|
702
|
+
ctxOf: (name: string) => deployContext({ env: plan.to, releaseIdentity, ...leasing }, name),
|
|
695
703
|
componentOutputs,
|
|
696
704
|
};
|
|
697
705
|
const approved = approvedRunOf(options.groupRuns, group);
|
|
@@ -708,6 +716,7 @@ export async function runPromotion(options: RunPromotionOptions): Promise<Driver
|
|
|
708
716
|
releases: expected,
|
|
709
717
|
// #3061: the workload's service.version and vcs.ref.head.revision are the earlier release's own.
|
|
710
718
|
releaseIdentity,
|
|
719
|
+
...leasing,
|
|
711
720
|
...(groups ? { groups } : {}),
|
|
712
721
|
...(options.onProgress ? { onProgress: options.onProgress } : {}),
|
|
713
722
|
...(options.onRunEvent ? { onRunEvent: options.onRunEvent } : {}),
|