@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
package/src/cli/main.ts
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env tsx
|
|
2
2
|
|
|
3
|
+
import { withProductWords, type CiProductWords, type CiProductWordsInput } from "../ci-product-words";
|
|
3
4
|
import { resolve } from "node:path";
|
|
4
5
|
import { isEntryPoint } from "./is-entry-point";
|
|
5
6
|
import { formatSuccess, formatError } from "./format";
|
|
@@ -225,8 +226,8 @@ Commands:
|
|
|
225
226
|
--all-projects)
|
|
226
227
|
migrate <file> Translate a workflow between lexicons
|
|
227
228
|
(default: --from github --to gitlab)
|
|
228
|
-
carve advise Read-only
|
|
229
|
-
--from <dir>
|
|
229
|
+
carve advise Read-only advisor: ranks which resources move
|
|
230
|
+
--from <dir> cleanly to a native lexicon
|
|
230
231
|
(--json, --report <path>). Emits nothing, changes nothing.
|
|
231
232
|
--from a Terraform dir needs @cdktn/hcl2json
|
|
232
233
|
(npm install -D @cdktn/hcl2json); --from a CDK cloud
|
|
@@ -257,7 +258,33 @@ Commands:
|
|
|
257
258
|
(--json) its target, stage (planned/emitted/bridged/
|
|
258
259
|
applied) and path. Read-only.
|
|
259
260
|
|
|
261
|
+
E2E harness:
|
|
262
|
+
e2e safe-run [--scan <dir>]... -- <command...>
|
|
263
|
+
Run <command> with no real cloud in reach (cloud credential
|
|
264
|
+
variables unset, empty CLOUDSDK_CONFIG, file:// Pulumi
|
|
265
|
+
backend), then scan its output and each --scan dir. Prints
|
|
266
|
+
CLEAN, or the rejecting lines and exits 3.
|
|
267
|
+
|
|
260
268
|
CI:
|
|
269
|
+
ci check --base <rev> [<target>...] [--output <dir>] [--json]
|
|
270
|
+
Run the ci.hooks.check hooks the workspace declaration
|
|
271
|
+
at --base names, once each, or once per target with
|
|
272
|
+
perRun, with no forge token or cloud credentials in
|
|
273
|
+
their environment. Writes check-hooks.json under
|
|
274
|
+
--output (default .chant/check); exits 1 when one failed.
|
|
275
|
+
ci check-job The apply-job guard: compare the forge environment,
|
|
276
|
+
ref and runner the forge gives this job with the
|
|
277
|
+
expectation in CHANT_JOB_GUARD, which a generated
|
|
278
|
+
op-wave job carries. Exits 1, one line per value
|
|
279
|
+
that differs, before any credential is taken.
|
|
280
|
+
ci forge-check [--env <env>] [--member <name>] [--forge <forge>] [--repo <owner/name>] [--branch <default>] [--require-clouds] [--json]
|
|
281
|
+
Read the forge, each cloud's trust policy and Pulumi
|
|
282
|
+
Cloud's OIDC policies against the pipelines
|
|
283
|
+
ci.identity.cloud gives --env (default production):
|
|
284
|
+
apply environments, branch protection, required
|
|
285
|
+
statuses, and each identity trusted to its own jobs.
|
|
286
|
+
Read-only; exits 1 on a mismatch, and with
|
|
287
|
+
--require-clouds on a cloud it had no credentials for.
|
|
261
288
|
ci last-green [--json] [--from <rev>] The newest first-parent commit of
|
|
262
289
|
ci.green's branch, or of --from, with a ci/green tag
|
|
263
290
|
and no ci/revoked tag. Reads local tags only; fetch
|
|
@@ -504,7 +531,21 @@ Ops:
|
|
|
504
531
|
--group <name> applies one job group's runs.
|
|
505
532
|
--record-plans (no --wave), in a pull request's
|
|
506
533
|
pipeline: plan every wave at its head and record the
|
|
507
|
-
digests a pr-review approval mode compares
|
|
534
|
+
digests a pr-review approval mode compares.
|
|
535
|
+
--approval-status (no --wave) --forge <kind>
|
|
536
|
+
--pr <n> --head <sha> --base <sha>, or --open
|
|
537
|
+
[--branch <b>]: post <product>/approval on an open
|
|
538
|
+
pull request's head, pending while a wave its gate
|
|
539
|
+
will hold has no approval: an approving review for
|
|
540
|
+
pr-review, the pull request's own approval covering
|
|
541
|
+
its change set for pull-request (#4630).
|
|
542
|
+
--waves-outcome (no --wave), after the last wave:
|
|
543
|
+
print how the wave jobs' outcome files add up
|
|
544
|
+
(applied, partial, unchanged, waiting, failed), the
|
|
545
|
+
outcome a control dispatch carries (#4617)
|
|
546
|
+
--events-json streams the job's run events (#4555);
|
|
547
|
+
with OTEL_EXPORTER_OTLP_ENDPOINT set, the job sends
|
|
548
|
+
its trace there
|
|
508
549
|
run resume [--op <name>] [--gate <name>] Start again each CI job that
|
|
509
550
|
waits at a gate an approval now answers, through the
|
|
510
551
|
forge's API (#3683); approves nothing. --gate resumes
|
|
@@ -513,6 +554,10 @@ Ops:
|
|
|
513
554
|
stopped once its run is gone (#3858). --dry-run
|
|
514
555
|
starts nothing; with --json it says per gate whether
|
|
515
556
|
it would resume and why
|
|
557
|
+
run pending --plan <digest> [--op <name>] List the gates waiting on a
|
|
558
|
+
plan digest, newest first, with the pull request a
|
|
559
|
+
pr-<n> gate belongs to (#4607). --json prints
|
|
560
|
+
{ plan, gates }
|
|
516
561
|
run --generate <provider> Write one CI pipeline file per scheduled Op for
|
|
517
562
|
github, gitlab or forgejo (#2533), from every Op that
|
|
518
563
|
declares a schedule or from --spec <file.json>.
|
|
@@ -538,6 +583,15 @@ Ops:
|
|
|
538
583
|
commit and runtime on every line (#4041). Also on
|
|
539
584
|
run <op>, components promote|rollback|redeploy,
|
|
540
585
|
fan-out, pr-plan and pr-apply
|
|
586
|
+
--adopt <adoption-file>: one component's cfn-deploy
|
|
587
|
+
step adopts the file's indexed resources into its
|
|
588
|
+
stack: an IMPORT change set without markers, then a
|
|
589
|
+
tags-only UPDATE that writes them. Each change set
|
|
590
|
+
is shown and asked about before it runs (--yes
|
|
591
|
+
approves; with no terminal and no --yes, nothing
|
|
592
|
+
runs). If the marker step stops after a good import,
|
|
593
|
+
a plain deploy of the same template writes the
|
|
594
|
+
markers (#4537)
|
|
541
595
|
operator Run scheduled ticks for discovered ConvergeOps
|
|
542
596
|
locally (#1485): acquire/renew a per-op
|
|
543
597
|
lease (git ref CAS), tick on --interval, record every
|
|
@@ -581,6 +635,12 @@ Ops:
|
|
|
581
635
|
--resume then starts the CI job that waits at the
|
|
582
636
|
gate again (GitHub re-run, GitLab retry, Forgejo
|
|
583
637
|
dispatch) with CHANT_FORGE_TOKEN
|
|
638
|
+
At a terminal it shows the stored plan and asks you
|
|
639
|
+
to type the target's name (the environment, else the
|
|
640
|
+
gate) before recording; a wrong answer exits 8, a
|
|
641
|
+
plan that moved while you were asked exits 4.
|
|
642
|
+
--yes, --json, CI and no terminal record as before
|
|
643
|
+
(#4575)
|
|
584
644
|
On op policy-override the gate is the subject a
|
|
585
645
|
policy denied: --rule <id> names each rule that
|
|
586
646
|
denied it and --reason <text> says why the plan goes
|
|
@@ -588,6 +648,25 @@ Ops:
|
|
|
588
648
|
applies it once, if .chant/overriders at base lists
|
|
589
649
|
--actor
|
|
590
650
|
|
|
651
|
+
audit-log attribute --input <drift.json> [--audit-log aws[:<region>]]
|
|
652
|
+
Name who changed each drifted attribute of a drift
|
|
653
|
+
document: a known write by design, else the cloud
|
|
654
|
+
audit log's last writer (#4632)
|
|
655
|
+
audit-log unrecorded --audit-log aws[:<region>] --op <op>[,...] --since <time>
|
|
656
|
+
Report the audit log's writes no recorded apply on
|
|
657
|
+
the run ledger made; exits 2 when there are some
|
|
658
|
+
(#4632)
|
|
659
|
+
notify relay Serve the relay that approves a waiting gate from a
|
|
660
|
+
Slack button or a Teams reply (#4611): verifies the
|
|
661
|
+
chat signature and the button's notify reference,
|
|
662
|
+
maps the clicker through the signers file at base,
|
|
663
|
+
and records chant approve --plan <digest> --actor
|
|
664
|
+
<principal> --relayed-by <relay>. Settings come from
|
|
665
|
+
CHANT_RELAY_KEY, SLACK_SIGNING_SECRET,
|
|
666
|
+
TEAMS_WEBHOOK_SECRET, CHANT_RELAY_PRINCIPAL,
|
|
667
|
+
CHANT_RELAY_MAX_AGE, CHANT_RELAY_HOST (default
|
|
668
|
+
127.0.0.1) and CHANT_RELAY_PORT (default 8787)
|
|
669
|
+
|
|
591
670
|
lock <target>... Lock targets for a pull request on chant/lifecycle
|
|
592
671
|
(--pr <n>, --stage plan|apply|lock, --head <sha>,
|
|
593
672
|
--by <who>, --gate <name>, --json). --from-report
|
|
@@ -632,9 +711,9 @@ Workspace (level 1, #2524):
|
|
|
632
711
|
the catalog-info.yaml files under dir, and shows what
|
|
633
712
|
it left out (#3178)
|
|
634
713
|
workspace promote <member> [--state <tfstate>] [--lexicon <name>] [--dry-run] [--output <patch>] [--json]
|
|
635
|
-
|
|
636
|
-
|
|
637
|
-
|
|
714
|
+
Change a member's kind (terraform to choudoufu runs
|
|
715
|
+
live-check and the adoption report; choudoufu or
|
|
716
|
+
other to chant runs chant import), staged
|
|
638
717
|
in a worktree and gated on the patch digest like upgrade
|
|
639
718
|
workspace promote --all [--state-dir <dir>] [--state <member>=<tfstate>]... [--canary <member>] [--wave-size <n>] [--dry-run] [--json]
|
|
640
719
|
Adopt every terraform member into choudoufu in waves:
|
|
@@ -1126,6 +1205,16 @@ Component release ledger + status:
|
|
|
1126
1205
|
the ones that depend on them, and write the
|
|
1127
1206
|
report and note (--base <ref> --pr <n>
|
|
1128
1207
|
[--forge github|gitlab|forgejo] posts them);
|
|
1208
|
+
--target <address> narrows every member's plan
|
|
1209
|
+
to the address, --target <member>:<address>
|
|
1210
|
+
one member's (#4620); --comment-targets adds the
|
|
1211
|
+
--target addresses of the preview comment in
|
|
1212
|
+
CHANT_PREVIEW_COMMENT (#4626); --refresh refreshes
|
|
1213
|
+
each step's state first and --target-dependents
|
|
1214
|
+
plans what depends on each target too, refused
|
|
1215
|
+
by name for a step that cannot (#4627);
|
|
1216
|
+
--parallelism <n> plans at
|
|
1217
|
+
most n members of a wave at once (#4625);
|
|
1129
1218
|
applies nothing
|
|
1130
1219
|
components pr-post Post the plan note and the chant/plan status
|
|
1131
1220
|
from the report pr-plan --no-status wrote
|
|
@@ -1133,12 +1222,22 @@ Component release ledger + status:
|
|
|
1133
1222
|
<kind>), in a job that runs none of the
|
|
1134
1223
|
change's code (#4295); --open posts every
|
|
1135
1224
|
open merge request's from a GitLab pipeline
|
|
1136
|
-
of the target branch (#4328)
|
|
1225
|
+
of the target branch (#4328); --respond
|
|
1226
|
+
description=check --decide-backend <name>
|
|
1227
|
+
--decide-model <id> asks whether the
|
|
1228
|
+
description leaves out a destroy or a
|
|
1229
|
+
replacement and posts the finding (#4629)
|
|
1137
1230
|
components pr-record On merge (#4168): plan the same members again,
|
|
1138
1231
|
store the change set and write the merge record
|
|
1139
1232
|
_merges/<commit>.json; applies and refuses
|
|
1140
1233
|
nothing, and a plan that differs from the
|
|
1141
1234
|
approved one sets a failing chant/record status
|
|
1235
|
+
agent prepare|run|land The agent jobs (#4616) the Op generator writes for
|
|
1236
|
+
a spec's agent: prepare decides from the comment or
|
|
1237
|
+
the drift check and the ledger's run count, run
|
|
1238
|
+
runs the model command with no forge token, land
|
|
1239
|
+
pushes the change, opens or updates the pull
|
|
1240
|
+
request and records the run (--forge <kind>)
|
|
1142
1241
|
components pr-env An environment per open pull request (#4298): up
|
|
1143
1242
|
--base <ref> --pr <n> applies the change to pr-<n>,
|
|
1144
1243
|
derived from ci.prEnvironment.template, once an
|
|
@@ -1159,10 +1258,10 @@ Component release ledger + status:
|
|
|
1159
1258
|
member's loop, gate op pr-<n>-<member>;
|
|
1160
1259
|
--resume <file> finishes an apply that failed
|
|
1161
1260
|
partway under the same approval;
|
|
1162
|
-
--wave-gate <name>: apply a wave at a time
|
|
1163
|
-
planned after the one before applied,
|
|
1164
|
-
wave waiting at <name>-wave-<k>, with
|
|
1165
|
-
for one wave per CI job;
|
|
1261
|
+
--wave-gate <name>: apply a wave at a time on op
|
|
1262
|
+
waves, each planned after the one before applied,
|
|
1263
|
+
a moved wave waiting at <name>-wave-<k>, with
|
|
1264
|
+
--wave <k> for one wave per CI job;
|
|
1166
1265
|
--green: apply the green commit at HEAD, measured
|
|
1167
1266
|
from the one last applied to --env, under the
|
|
1168
1267
|
approved plans of the merges since, else at gate
|
|
@@ -1172,10 +1271,30 @@ Component release ledger + status:
|
|
|
1172
1271
|
declaration at base sets ci.workflow to
|
|
1173
1272
|
apply-before-merge and the forge says it is
|
|
1174
1273
|
approved, mergeable, undiverged and green;
|
|
1274
|
+
--requires <list> asks only the checks it
|
|
1275
|
+
names (approved,mergeable,undiverged,checks);
|
|
1276
|
+
--merge auto --merge-token-env <VAR> merges the
|
|
1277
|
+
pull request once every member applied and the
|
|
1278
|
+
records are pushed, with that token alone and
|
|
1279
|
+
the applied head checked again (#4636);
|
|
1280
|
+
--respond <list> turns the failed apply's
|
|
1281
|
+
triage and the refused apply's diff on or off
|
|
1282
|
+
(wave-refused=diff|off,apply-failed=triage|off,
|
|
1283
|
+
#4629);
|
|
1175
1284
|
--events-json, both commands: the run-event
|
|
1176
1285
|
stream on stdout; --report-url <s3 or file URL>,
|
|
1177
1286
|
both commands: copy the report, the change set
|
|
1178
1287
|
and the events to <url>/<pr>/<commit>/)
|
|
1288
|
+
components plan-wave --runs <file> --plans <file> --base <ref> --env <env>
|
|
1289
|
+
Plan one op wave's components through their
|
|
1290
|
+
capabilities and write the wave's plans file
|
|
1291
|
+
with its change set (#4588); --wave-outputs
|
|
1292
|
+
<file> seeds the outputs earlier waves left
|
|
1293
|
+
components apply-wave --runs <file> --plans <file> --base <ref> --env <env>
|
|
1294
|
+
Plan the approved runs again, exit 4 when a plan
|
|
1295
|
+
moved, else apply them and add their outputs to
|
|
1296
|
+
--wave-outputs (#4588). Both are the steps of the
|
|
1297
|
+
waves pr-apply --wave-gate runs on op waves
|
|
1179
1298
|
components release <env> Append one immutable release record
|
|
1180
1299
|
(--component <name> --digest <sha256:...>
|
|
1181
1300
|
[--git-sha <sha>] [--run-id <id>] [--actor <name>]);
|
|
@@ -1242,7 +1361,8 @@ Local:
|
|
|
1242
1361
|
|
|
1243
1362
|
Servers:
|
|
1244
1363
|
serve lsp Start the LSP server (stdio)
|
|
1245
|
-
serve mcp Start the MCP server (stdio)
|
|
1364
|
+
serve mcp Start the MCP server (stdio); --read-only serves only
|
|
1365
|
+
the tools that read (ledger, graph, runs) and run nothing
|
|
1246
1366
|
|
|
1247
1367
|
Project:
|
|
1248
1368
|
update (alias: sync) Sync lexicon types into .chant/types/ (does not install
|
|
@@ -1269,6 +1389,7 @@ Options:
|
|
|
1269
1389
|
records its lineage in .chant/workspace.lock.json
|
|
1270
1390
|
--skill <name> Init: install only this skill from the lexicon
|
|
1271
1391
|
--skip-mcp Init: scaffold without writing the project's .mcp.json
|
|
1392
|
+
--mcp-read-only Init: register \`chant serve mcp --read-only\` in .mcp.json
|
|
1272
1393
|
--fix Auto-fix fixable issues (lint command)
|
|
1273
1394
|
--force Force overwrite existing files (import command)
|
|
1274
1395
|
-w, --watch Watch for changes and rebuild/re-lint (build, lint)
|
|
@@ -1548,8 +1669,32 @@ function commandRunsNoConfig(def: CommandDef, args: ParsedArgs): boolean {
|
|
|
1548
1669
|
* checked, plugins are loaded when the command needs them, and the handler
|
|
1549
1670
|
* runs. A `process.exit` inside (loadPluginsOrExit's, say) is the caller's to
|
|
1550
1671
|
* catch.
|
|
1672
|
+
*
|
|
1673
|
+
* `words` (#4550) are a CI product's words (`@intentius/chant/ci-product`):
|
|
1674
|
+
* the product's bin passes them, so the command renders in the product's
|
|
1675
|
+
* words while it runs. `mcp` (#4555) is its tool hook, which `chant serve
|
|
1676
|
+
* mcp` serves beside chant's own tools.
|
|
1551
1677
|
*/
|
|
1552
|
-
export async function runCommandInProcess(
|
|
1678
|
+
export async function runCommandInProcess(
|
|
1679
|
+
argv: string[],
|
|
1680
|
+
options: { words?: CiProductWordsInput | CiProductWords; mcp?: import("./mcp/product-tools").ProductMcpHook; wave?: import("../op/op-waves-after-plan").ProductWaveHook } = {},
|
|
1681
|
+
): Promise<number> {
|
|
1682
|
+
// #4614: a product's after-plan hooks and capabilities on `chant run wave`, in its own process.
|
|
1683
|
+
if (options.wave) {
|
|
1684
|
+
const { withProductWaveHook } = await import("../op/op-waves-after-plan");
|
|
1685
|
+
const { wave, ...rest } = options;
|
|
1686
|
+
return withProductWaveHook(wave, () => runCommandInProcess(argv, rest));
|
|
1687
|
+
}
|
|
1688
|
+
// #4555: a product's tools on `chant serve mcp`, through its tool hook.
|
|
1689
|
+
if (options.mcp) {
|
|
1690
|
+
const { withProductMcpHook } = await import("./mcp/product-tools");
|
|
1691
|
+
const { mcp, ...rest } = options;
|
|
1692
|
+
return withProductMcpHook(mcp, () => runCommandInProcess(argv, rest));
|
|
1693
|
+
}
|
|
1694
|
+
// #4550: a product's bin calls chant with its words; every status, note and
|
|
1695
|
+
// approve line the command writes takes them, and the earlier words come
|
|
1696
|
+
// back once it settles.
|
|
1697
|
+
if (options.words) return withProductWords(options.words, () => runCommandInProcess(argv));
|
|
1553
1698
|
const args = parseArgs(argv);
|
|
1554
1699
|
const match = resolveCommand(args, commandRegistry);
|
|
1555
1700
|
if (!match) {
|
|
@@ -1624,11 +1769,20 @@ export const commandRegistry: CommandDef[] = [
|
|
|
1624
1769
|
// renderer replaces its own walk-and-guess discovery with. Read-only.
|
|
1625
1770
|
{ name: "carve status", handler: runCarveStatus },
|
|
1626
1771
|
// #3573 — which commits passed CI, kept as ci/green and ci/revoked tags (ws-103). Imported on first use.
|
|
1772
|
+
// chant#4587 (C1) — the e2e harness's no-real-cloud wrapper as a command, for bash drivers. Imported on first use.
|
|
1773
|
+
{ name: "e2e safe-run", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/e2e-safe-run")).runE2eSafeRun(ctx) },
|
|
1774
|
+
{ name: "e2e", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/e2e-safe-run")).runE2eUnknown(ctx) },
|
|
1627
1775
|
{ name: "ci last-green", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli")).runCiLastGreen(ctx) },
|
|
1628
1776
|
{ name: "ci list", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli")).runCiList(ctx) },
|
|
1629
1777
|
{ name: "ci tick", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli")).runCiTick(ctx) },
|
|
1630
1778
|
{ name: "ci workflow", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli")).runCiWorkflow(ctx) },
|
|
1631
1779
|
{ name: "ci init", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-init")).runCiInit(ctx) },
|
|
1780
|
+
// #4556: the ci.hooks.check hooks at base, for a product's check job.
|
|
1781
|
+
{ name: "ci check", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-check")).runCiCheck(ctx) },
|
|
1782
|
+
// #4608: the live forge, cloud trust policies and Pulumi Cloud's OIDC policies against ci.identity.cloud. Read-only.
|
|
1783
|
+
// #4624: the apply-job guard, from the expectation the job carries.
|
|
1784
|
+
{ name: "ci check-job", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-check-job")).runCiCheckJob(ctx) },
|
|
1785
|
+
{ name: "ci forge-check", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-forge-check")).runCiForgeCheck(ctx) },
|
|
1632
1786
|
// #4094: one pull-request job as a pipeline Op in a fresh checkout, the chant runner's first slice.
|
|
1633
1787
|
{ name: "ci run", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-run")).runCiRun(ctx) },
|
|
1634
1788
|
// #4098: the run index at the report URL.
|
|
@@ -1678,6 +1832,8 @@ export const commandRegistry: CommandDef[] = [
|
|
|
1678
1832
|
{ name: "run wave", handler: runOpWaveCommand },
|
|
1679
1833
|
// #3683 — start the CI jobs that wait at gates whose approval arrived. Imported on first use.
|
|
1680
1834
|
{ name: "run resume", handler: async (ctx) => (await import("./handlers/gate-resume")).runResumeCommand(ctx) },
|
|
1835
|
+
// #4607 — the pending gates a plan digest waits at, with their pull request. Imported on first use.
|
|
1836
|
+
{ name: "run pending", handler: async (ctx) => (await import("./handlers/gate-pending")).runPendingCommand(ctx) },
|
|
1681
1837
|
{ name: "run", handler: runOp },
|
|
1682
1838
|
|
|
1683
1839
|
{ name: "operator status", handler: runOperatorStatus },
|
|
@@ -1685,6 +1841,10 @@ export const commandRegistry: CommandDef[] = [
|
|
|
1685
1841
|
{ name: "operator", handler: runOperator },
|
|
1686
1842
|
{ name: "approve", handler: runApprove },
|
|
1687
1843
|
// #4293 — target locks a pull request holds on chant/lifecycle. Imported on first use.
|
|
1844
|
+
// #4611 — approve a waiting gate from a chat click. Imported on first use.
|
|
1845
|
+
{ name: "audit-log attribute", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/audit-log")).runAuditLogAttribute(ctx) },
|
|
1846
|
+
{ name: "audit-log unrecorded", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/audit-log")).runAuditLogUnrecorded(ctx) },
|
|
1847
|
+
{ name: "notify relay", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/notify-relay")).runNotifyRelay(ctx) },
|
|
1688
1848
|
{ name: "lock", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/lock")).runLock(ctx) },
|
|
1689
1849
|
{ name: "unlock", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/lock")).runUnlock(ctx) },
|
|
1690
1850
|
|
|
@@ -1787,9 +1947,16 @@ export const commandRegistry: CommandDef[] = [
|
|
|
1787
1947
|
// #3183 — the pull-request loop the generated CI runs. Imported on first use.
|
|
1788
1948
|
{ name: "components pr-plan", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrPlan(ctx) },
|
|
1789
1949
|
{ name: "components pr-apply", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrApply(ctx) },
|
|
1950
|
+
// #4588: the component plan-wave and apply-wave steps a component waves spec runs (pr-apply --wave-gate on op waves).
|
|
1951
|
+
{ name: "components plan-wave", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPlanWave(ctx) },
|
|
1952
|
+
{ name: "components apply-wave", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsApplyWave(ctx) },
|
|
1790
1953
|
// #4295: posts from the plan report in a job that runs none of the change's code, so it loads no plugins.
|
|
1791
1954
|
{ name: "components pr-post", handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrPost(ctx) },
|
|
1792
1955
|
{ name: "components pr-record", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr")).runComponentsPrRecord(ctx) },
|
|
1956
|
+
// #4616: the agent jobs' three steps. Imported on first use; none loads plugins.
|
|
1957
|
+
{ name: "agent prepare", handler: async (ctx) => (await import("./handlers/agent")).runAgentCommandLine(ctx) },
|
|
1958
|
+
{ name: "agent run", handler: async (ctx) => (await import("./handlers/agent")).runAgentCommandLine(ctx) },
|
|
1959
|
+
{ name: "agent land", handler: async (ctx) => (await import("./handlers/agent")).runAgentCommandLine(ctx) },
|
|
1793
1960
|
{ name: "components pr-env", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr-env")).runComponentsPrEnv(ctx) },
|
|
1794
1961
|
{ name: "components status", requiresPlugins: true, handler: runComponentsStatus },
|
|
1795
1962
|
{ name: "components release", handler: runComponentsReleaseRecord },
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* chant#4543 — the ledger reads of `chant serve mcp`: `ledger` and `query`.
|
|
3
|
+
*
|
|
4
|
+
* Served in both modes, and the reason the read-only mode is worth starting:
|
|
5
|
+
* an agent gets the runs, gates, deploys, releases, cuts, resources and
|
|
6
|
+
* snapshots on `chant/lifecycle` and the index store without a tool that can
|
|
7
|
+
* change any of them.
|
|
8
|
+
*
|
|
9
|
+
* Each runs the CLI with the chant this server runs as, in the server's
|
|
10
|
+
* directory, and returns the JSON document it printed, unchanged, the way the
|
|
11
|
+
* workspace reads do (./workspace-tools.ts {@link runRead}):
|
|
12
|
+
*
|
|
13
|
+
* - `ledger` runs `chant ledger <table> ... --json`, the ledger read contract
|
|
14
|
+
* (`../handlers/ledger.ts`, #4363).
|
|
15
|
+
* - `query` runs `chant query -- <sql> --json`, one read-only SQL statement
|
|
16
|
+
* over the same ledgers (`../handlers/query.ts`, #4297). The engine refuses
|
|
17
|
+
* anything but a read.
|
|
18
|
+
*
|
|
19
|
+
* Both read the local branch and never fetch.
|
|
20
|
+
*/
|
|
21
|
+
|
|
22
|
+
import type { ToolDefinition, ToolHandler } from "./types";
|
|
23
|
+
import { ownChantCommand, runRead, type ChantCommand } from "./workspace-tools";
|
|
24
|
+
|
|
25
|
+
/** The tables `chant ledger` reads, in its usage order. */
|
|
26
|
+
export const LEDGER_TABLES = ["resources", "snapshots", "runs", "gates", "deploys", "releases", "cuts"] as const;
|
|
27
|
+
|
|
28
|
+
class ToolInputError extends Error {}
|
|
29
|
+
|
|
30
|
+
function str(params: Record<string, unknown>, key: string, required = false): string | undefined {
|
|
31
|
+
const v = params[key];
|
|
32
|
+
if (v === undefined || v === null) {
|
|
33
|
+
if (required) throw new ToolInputError(`${key} is required`);
|
|
34
|
+
return undefined;
|
|
35
|
+
}
|
|
36
|
+
if (typeof v !== "string" || v === "") throw new ToolInputError(`${key} must be a non-empty string`);
|
|
37
|
+
// A value is passed as one argument; one that starts with - would read as a flag.
|
|
38
|
+
if (v.startsWith("-")) throw new ToolInputError(`${key} may not start with -: ${JSON.stringify(v)}`);
|
|
39
|
+
return v;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
function list(params: Record<string, unknown>, key: string): string[] {
|
|
43
|
+
const v = params[key];
|
|
44
|
+
if (v === undefined || v === null) return [];
|
|
45
|
+
const items = typeof v === "string" ? [v] : v;
|
|
46
|
+
if (!Array.isArray(items)) throw new ToolInputError(`${key} must be a string, or a list of them`);
|
|
47
|
+
return items.map((item, i) => str({ [`${key}[${i}]`]: item }, `${key}[${i}]`, true)!);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
const memberProp = {
|
|
51
|
+
type: "array",
|
|
52
|
+
items: { type: "string" },
|
|
53
|
+
description: "Only these workspace members' ledgers (--member). Outside a workspace the project's own ledger is read.",
|
|
54
|
+
};
|
|
55
|
+
|
|
56
|
+
export const ledgerReadTools: ToolDefinition[] = [
|
|
57
|
+
{
|
|
58
|
+
name: "ledger",
|
|
59
|
+
description:
|
|
60
|
+
"One ledger's rows from the local chant/lifecycle branch: chant ledger <table> --json (#4363). Tables: " +
|
|
61
|
+
LEDGER_TABLES.join(", ") +
|
|
62
|
+
". Inside a workspace every member's ledger is read and each row names its member. Returns the document unchanged; an error document is a document.",
|
|
63
|
+
inputSchema: {
|
|
64
|
+
type: "object",
|
|
65
|
+
properties: {
|
|
66
|
+
table: { type: "string", enum: [...LEDGER_TABLES], description: "The ledger to read." },
|
|
67
|
+
member: memberProp,
|
|
68
|
+
where: {
|
|
69
|
+
type: "array",
|
|
70
|
+
items: { type: "string" },
|
|
71
|
+
description: "Typed filters, each <field><op><value> such as state=failed (--where, repeatable).",
|
|
72
|
+
},
|
|
73
|
+
since: { type: "string", description: "Only rows at or after this time (--since)." },
|
|
74
|
+
at: { type: "string", description: "Read the ledger as this commit of chant/lifecycle held it (--at)." },
|
|
75
|
+
},
|
|
76
|
+
required: ["table"],
|
|
77
|
+
},
|
|
78
|
+
},
|
|
79
|
+
{
|
|
80
|
+
name: "query",
|
|
81
|
+
description:
|
|
82
|
+
"One read-only SQL statement over the snapshots in the index store and the Op runs, gates, deploys and releases on the local chant/lifecycle branch: chant query <sql> --json (#4297). A statement that writes is refused. Returns the document unchanged.",
|
|
83
|
+
inputSchema: {
|
|
84
|
+
type: "object",
|
|
85
|
+
properties: {
|
|
86
|
+
sql: { type: "string", description: "The SQL statement." },
|
|
87
|
+
member: memberProp,
|
|
88
|
+
},
|
|
89
|
+
required: ["sql"],
|
|
90
|
+
},
|
|
91
|
+
},
|
|
92
|
+
];
|
|
93
|
+
|
|
94
|
+
/** The `chant` arguments each ledger tool runs, from its input. */
|
|
95
|
+
export function ledgerArgv(tool: string, params: Record<string, unknown>): string[] {
|
|
96
|
+
const members = list(params, "member").flatMap((m) => ["--member", m]);
|
|
97
|
+
switch (tool) {
|
|
98
|
+
case "ledger": {
|
|
99
|
+
const table = str(params, "table", true)!;
|
|
100
|
+
if (!(LEDGER_TABLES as readonly string[]).includes(table)) throw new ToolInputError(`table must be one of ${LEDGER_TABLES.join(", ")}`);
|
|
101
|
+
const where = list(params, "where").flatMap((w) => ["--where", w]);
|
|
102
|
+
const flags = (["since", "at"] as const).flatMap((f) => {
|
|
103
|
+
const v = str(params, f);
|
|
104
|
+
return v !== undefined ? [`--${f}`, v] : [];
|
|
105
|
+
});
|
|
106
|
+
return ["ledger", table, ...members, ...where, ...flags, "--json"];
|
|
107
|
+
}
|
|
108
|
+
case "query": {
|
|
109
|
+
// The statement is one argument after `--`, so text that opens with - stays SQL.
|
|
110
|
+
const sql = params.sql;
|
|
111
|
+
if (typeof sql !== "string" || sql.trim() === "") throw new ToolInputError("sql must be a non-empty string");
|
|
112
|
+
return ["query", ...members, "--json", "--", sql];
|
|
113
|
+
}
|
|
114
|
+
default:
|
|
115
|
+
throw new ToolInputError(`${tool} is not a ledger read tool`);
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/** The ledger read tools, bound to the server's directory. */
|
|
120
|
+
export function createLedgerTools(options: { cwd: string; chantCommand?: ChantCommand }): { definition: ToolDefinition; handler: ToolHandler }[] {
|
|
121
|
+
const chant = options.chantCommand ?? ownChantCommand();
|
|
122
|
+
return ledgerReadTools.map((definition) => ({
|
|
123
|
+
definition,
|
|
124
|
+
handler: async (params) => runRead(chant, ledgerArgv(definition.name, params), options.cwd),
|
|
125
|
+
}));
|
|
126
|
+
}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* chant#4555: a CI product's tools on `chant serve mcp` through the product
|
|
3
|
+
* tool hook, read-only by default, and the `report` tool's read of the
|
|
4
|
+
* report store.
|
|
5
|
+
*/
|
|
6
|
+
|
|
7
|
+
import { describe, expect, test } from "vitest";
|
|
8
|
+
import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
|
|
9
|
+
import { join } from "node:path";
|
|
10
|
+
import { tmpdir } from "node:os";
|
|
11
|
+
import { pathToFileURL } from "node:url";
|
|
12
|
+
import { McpServer } from "./server";
|
|
13
|
+
import { productToolWriteWord, ProductToolRefusedError, type ProductMcpHook } from "./product-tools";
|
|
14
|
+
import { reportReader, reportToolKey, safeReportKey } from "./report-tools";
|
|
15
|
+
import type { ToolDefinition } from "./types";
|
|
16
|
+
import type { McpToolContribution } from "../../mcp/types";
|
|
17
|
+
|
|
18
|
+
const tool = (name: string, readOnly?: boolean, handler: McpToolContribution["handler"] = async () => ({ name })): McpToolContribution => ({
|
|
19
|
+
name,
|
|
20
|
+
description: name,
|
|
21
|
+
inputSchema: { type: "object", properties: {} },
|
|
22
|
+
handler,
|
|
23
|
+
...(readOnly !== undefined ? { readOnly } : {}),
|
|
24
|
+
});
|
|
25
|
+
|
|
26
|
+
async function listed(server: McpServer): Promise<string[]> {
|
|
27
|
+
const res = await server.handleRequest({ jsonrpc: "2.0", id: 1, method: "tools/list" });
|
|
28
|
+
return (res.result as { tools: ToolDefinition[] }).tools.map((t) => t.name);
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
async function call(server: McpServer, name: string, args: Record<string, unknown> = {}): Promise<{ text: string; isError?: boolean }> {
|
|
32
|
+
const res = await server.handleRequest({ jsonrpc: "2.0", id: 2, method: "tools/call", params: { name, arguments: args } });
|
|
33
|
+
const r = res.result as { content: Array<{ text: string }>; isError?: boolean };
|
|
34
|
+
return { text: r.content[0]!.text, ...(r.isError ? { isError: true } : {}) };
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
describe("the product tool hook (#4555)", () => {
|
|
38
|
+
test("a server started through the hook is read-only, and serves only the product tools that say they read", async () => {
|
|
39
|
+
const hook: ProductMcpHook = { product: "terragucci", tools: () => [tool("waiting", true), tool("estate", true), tool("drift_scan")] };
|
|
40
|
+
const server = new McpServer([], { product: hook });
|
|
41
|
+
expect(server.readOnly).toBe(true);
|
|
42
|
+
const names = await listed(server);
|
|
43
|
+
expect(names).toContain("terragucci:waiting");
|
|
44
|
+
expect(names).toContain("terragucci:estate");
|
|
45
|
+
expect(names).not.toContain("terragucci:drift_scan");
|
|
46
|
+
// chant's mutating core tools stay out too.
|
|
47
|
+
expect(names).not.toContain("op-run");
|
|
48
|
+
expect(names).not.toContain("op-approve");
|
|
49
|
+
expect(names).toContain("report");
|
|
50
|
+
expect(JSON.parse((await call(server, "terragucci:waiting")).text)).toEqual({ name: "waiting" });
|
|
51
|
+
});
|
|
52
|
+
|
|
53
|
+
test("a read-only server will not start with a product tool named as a write (assertReadOnly)", () => {
|
|
54
|
+
for (const name of ["apply_wave", "wave_approve", "unlock", "push_branch", "terragucci:merge_pr"]) {
|
|
55
|
+
expect(() => new McpServer([], { product: { product: "terragucci", tools: () => [tool(name, true)] } }), name).toThrow(ProductToolRefusedError);
|
|
56
|
+
}
|
|
57
|
+
expect(productToolWriteWord("last_apply")).toBeUndefined();
|
|
58
|
+
expect(productToolWriteWord("audit")).toBeUndefined();
|
|
59
|
+
expect(productToolWriteWord("apply_wave")).toBe("apply");
|
|
60
|
+
expect(productToolWriteWord("wave_approve")).toBe("approve");
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
test("readOnly: false on the hook starts an ordinary server with every product tool; --read-only wins over it", async () => {
|
|
64
|
+
const tools = () => [tool("propose"), tool("waiting", true)];
|
|
65
|
+
const open = new McpServer([], { product: { product: "plywood", tools, readOnly: false } });
|
|
66
|
+
expect(open.readOnly).toBe(false);
|
|
67
|
+
expect(await listed(open)).toEqual(expect.arrayContaining(["plywood:propose", "plywood:waiting", "op-run"]));
|
|
68
|
+
const closed = new McpServer([], { readOnly: true, product: { product: "plywood", tools, readOnly: false } });
|
|
69
|
+
expect(await listed(closed)).not.toContain("plywood:propose");
|
|
70
|
+
});
|
|
71
|
+
|
|
72
|
+
test("a product name that is not a word is refused, and the hook's instructions reach initialize", async () => {
|
|
73
|
+
expect(() => new McpServer([], { product: { product: "Ply Wood", tools: () => [] } })).toThrow(/not a product name/);
|
|
74
|
+
const server = new McpServer([], { product: { product: "plywood", tools: () => [], instructions: "plywood reads stacks." } });
|
|
75
|
+
const res = await server.handleRequest({ jsonrpc: "2.0", id: 1, method: "initialize", params: {} });
|
|
76
|
+
expect((res.result as { instructions: string }).instructions).toMatch(/^plywood reads stacks\.\n\n.*read-only/s);
|
|
77
|
+
});
|
|
78
|
+
|
|
79
|
+
test("a product tool reads the report store through its context, and cannot write it", async () => {
|
|
80
|
+
const dir = mkdtempSync(join(tmpdir(), "product-tools-"));
|
|
81
|
+
mkdirSync(join(dir, "7", "c".repeat(40)), { recursive: true });
|
|
82
|
+
writeFileSync(join(dir, "7", "c".repeat(40), "pr-plan.json"), JSON.stringify({ status: "planned" }));
|
|
83
|
+
let read: string | null | undefined;
|
|
84
|
+
const hook: ProductMcpHook = {
|
|
85
|
+
product: "plywood",
|
|
86
|
+
reportUrl: pathToFileURL(dir).href,
|
|
87
|
+
tools: (ctx) => [
|
|
88
|
+
tool("plan_report", true, async () => {
|
|
89
|
+
const reports = await ctx.reports();
|
|
90
|
+
read = await reports!.read(`7/${"c".repeat(40)}/pr-plan.json`);
|
|
91
|
+
return { read };
|
|
92
|
+
}),
|
|
93
|
+
],
|
|
94
|
+
};
|
|
95
|
+
const server = new McpServer([], { product: hook });
|
|
96
|
+
await call(server, "plywood:plan_report");
|
|
97
|
+
expect(read).toBe(JSON.stringify({ status: "planned" }));
|
|
98
|
+
expect("put" in reportReader(pathToFileURL(dir).href)).toBe(false);
|
|
99
|
+
|
|
100
|
+
// The core `report` tool reads the same store by pull request, commit and file.
|
|
101
|
+
const got = await call(server, "report", { pr: "7", commit: "c".repeat(40), file: "pr-plan.json" });
|
|
102
|
+
expect(JSON.parse(got.text)).toMatchObject({ key: `7/${"c".repeat(40)}/pr-plan.json`, document: { status: "planned" } });
|
|
103
|
+
expect((await call(server, "report", { pr: "7", commit: "c".repeat(40), file: "pr-apply.json" })).isError).toBe(true);
|
|
104
|
+
rmSync(dir, { recursive: true, force: true });
|
|
105
|
+
});
|
|
106
|
+
});
|
|
107
|
+
|
|
108
|
+
describe("the report tool's keys (#4555)", () => {
|
|
109
|
+
test("take a pull request, a commit, an optional member and one of the stage files", () => {
|
|
110
|
+
expect(reportToolKey({ pr: "12", commit: "a".repeat(40), file: "change-set.json" })).toBe(`12/${"a".repeat(40)}/change-set.json`);
|
|
111
|
+
expect(reportToolKey({ pr: 12, commit: "a".repeat(40), member: "web", file: "pr-apply.events.jsonl" })).toBe(`12/${"a".repeat(40)}/web/pr-apply.events.jsonl`);
|
|
112
|
+
expect(reportToolKey({ pr: "unknown", commit: "a".repeat(40), file: "pr-apply.json" })).toBe(`unknown/${"a".repeat(40)}/pr-apply.json`);
|
|
113
|
+
});
|
|
114
|
+
|
|
115
|
+
test("refuse anything that would leave the report URL, and any argument they do not list", () => {
|
|
116
|
+
expect(() => reportToolKey({ pr: "../x", commit: "a".repeat(40), file: "pr-plan.json" })).toThrow(/pull request number/);
|
|
117
|
+
expect(() => reportToolKey({ pr: "1", commit: "a".repeat(40), member: "..", file: "pr-plan.json" })).toThrow(/member/);
|
|
118
|
+
expect(() => reportToolKey({ pr: "1", commit: "a".repeat(40), file: "../../secret" })).toThrow(/file must be one of/);
|
|
119
|
+
expect(() => reportToolKey({ pr: "1", commit: "a".repeat(40), file: "pr-plan.json", token: "x" })).toThrow(/takes no argument token/);
|
|
120
|
+
expect(() => safeReportKey("a/../b")).toThrow(/not a path below/);
|
|
121
|
+
expect(safeReportKey("/a/b/")).toBe("a/b");
|
|
122
|
+
});
|
|
123
|
+
});
|