@intentius/chant 0.124.54 → 0.124.55
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 +833 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +42 -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 +68 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +83 -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 +87 -15
- package/dist/ci-product-words.d.ts +290 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +373 -0
- package/dist/ci-product.d.ts +82 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +78 -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/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +43 -1
- 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 +34 -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/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 +38 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +653 -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 +71 -1
- 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 +124 -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 +57 -3
- package/dist/cli/registry.d.ts +35 -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 +93 -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 +122 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +14 -6
- package/dist/components/check-hooks.d.ts +113 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -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 +61 -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 +20 -3
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +24 -4
- 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 +19 -2
- 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 +39 -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 +31 -3
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +25 -7
- package/dist/components/pr-pipeline.d.ts +169 -3
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +184 -9
- 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 +63 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +82 -3
- 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 +217 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +193 -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 +34 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +54 -2
- 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/engine-facts.d.ts.map +1 -1
- package/dist/engine-facts.js +1 -2
- package/dist/exit-codes.d.ts +48 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +49 -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 +106 -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 +11 -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 +205 -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 -6
- 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 +10 -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 +86 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +136 -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/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/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 +55 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +94 -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 +97 -0
- package/dist/op/op-waves-run.d.ts +175 -4
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +981 -41
- 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 +97 -0
- package/dist/op/op-waves.d.ts +152 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +161 -17
- package/dist/op/runtime.d.ts +91 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +19 -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 +426 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -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 +103 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +92 -0
- package/dist/pr-loop.d.ts +149 -11
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +283 -44
- package/dist/pr-post.d.ts +16 -0
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +26 -1
- 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 +46 -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 +4 -1
- 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 +390 -285
- 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 +12 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +27 -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 +6 -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 +74 -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 +1026 -0
- package/src/ci-control.ts +174 -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 +176 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +55 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +6 -2
- package/src/ci-identity.ts +124 -22
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +536 -0
- package/src/ci-product.ts +174 -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/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +44 -1
- package/src/cli/handlers/ci-check.ts +33 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -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-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 +655 -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 +65 -1
- 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.ts +126 -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 +42 -2
- package/src/cli/registry.ts +35 -0
- package/src/cloud-lister/sigv4.ts +80 -23
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +141 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability.ts +130 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +252 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +83 -0
- package/src/components/cli-support.ts +23 -2
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +38 -5
- package/src/components/fan-out-run.ts +68 -18
- package/src/components/groups.ts +17 -2
- 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 +43 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +8 -0
- 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 +39 -7
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +274 -9
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +1 -1
- package/src/components/pr-run.ts +121 -5
- 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 +341 -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 +78 -4
- 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/engine-facts.test.ts +2 -3
- package/src/engine-facts.ts +1 -2
- package/src/exit-codes.test.ts +31 -0
- package/src/exit-codes.ts +55 -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 +13 -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 +95 -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 +70 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +36 -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 +280 -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 -7
- 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 +193 -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 +20 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +186 -0
- package/src/lifecycle/release-status.ts +176 -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/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/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +21 -0
- package/src/op/op-waves-after-plan.test.ts +276 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +113 -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-pull-request.test.ts +142 -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 +133 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1142 -49
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +108 -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 +261 -20
- package/src/op/runtime.ts +104 -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 +544 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +112 -0
- package/src/pr-forge.ts +123 -0
- package/src/pr-loop-bundle.test.ts +6 -2
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.ts +371 -52
- package/src/pr-post.ts +32 -1
- package/src/pr-report-url.ts +62 -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 +211 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +29 -1
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +8 -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 +30 -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 +6 -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 +74 -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/dist/cli/main.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env tsx
|
|
2
|
+
import { withProductWords } from "../ci-product-words.js";
|
|
2
3
|
import { resolve } from "node:path";
|
|
3
4
|
import { isEntryPoint } from "./is-entry-point.js";
|
|
4
5
|
import { formatError } from "./format.js";
|
|
@@ -212,8 +213,8 @@ Commands:
|
|
|
212
213
|
--all-projects)
|
|
213
214
|
migrate <file> Translate a workflow between lexicons
|
|
214
215
|
(default: --from github --to gitlab)
|
|
215
|
-
carve advise Read-only
|
|
216
|
-
--from <dir>
|
|
216
|
+
carve advise Read-only advisor: ranks which resources move
|
|
217
|
+
--from <dir> cleanly to a native lexicon
|
|
217
218
|
(--json, --report <path>). Emits nothing, changes nothing.
|
|
218
219
|
--from a Terraform dir needs @cdktn/hcl2json
|
|
219
220
|
(npm install -D @cdktn/hcl2json); --from a CDK cloud
|
|
@@ -245,6 +246,20 @@ Commands:
|
|
|
245
246
|
applied) and path. Read-only.
|
|
246
247
|
|
|
247
248
|
CI:
|
|
249
|
+
ci check --base <rev> [<target>...] [--output <dir>] [--json]
|
|
250
|
+
Run the ci.hooks.check hooks the workspace declaration
|
|
251
|
+
at --base names, once each, or once per target with
|
|
252
|
+
perRun, with no forge token or cloud credentials in
|
|
253
|
+
their environment. Writes check-hooks.json under
|
|
254
|
+
--output (default .chant/check); exits 1 when one failed.
|
|
255
|
+
ci forge-check [--env <env>] [--member <name>] [--forge <forge>] [--repo <owner/name>] [--branch <default>] [--require-clouds] [--json]
|
|
256
|
+
Read the forge, each cloud's trust policy and Pulumi
|
|
257
|
+
Cloud's OIDC policies against the pipelines
|
|
258
|
+
ci.identity.cloud gives --env (default production):
|
|
259
|
+
apply environments, branch protection, required
|
|
260
|
+
statuses, and each identity trusted to its own jobs.
|
|
261
|
+
Read-only; exits 1 on a mismatch, and with
|
|
262
|
+
--require-clouds on a cloud it had no credentials for.
|
|
248
263
|
ci last-green [--json] [--from <rev>] The newest first-parent commit of
|
|
249
264
|
ci.green's branch, or of --from, with a ci/green tag
|
|
250
265
|
and no ci/revoked tag. Reads local tags only; fetch
|
|
@@ -491,7 +506,14 @@ Ops:
|
|
|
491
506
|
--group <name> applies one job group's runs.
|
|
492
507
|
--record-plans (no --wave), in a pull request's
|
|
493
508
|
pipeline: plan every wave at its head and record the
|
|
494
|
-
digests a pr-review approval mode compares
|
|
509
|
+
digests a pr-review approval mode compares.
|
|
510
|
+
--waves-outcome (no --wave), after the last wave:
|
|
511
|
+
print how the wave jobs' outcome files add up
|
|
512
|
+
(applied, partial, unchanged, waiting, failed), the
|
|
513
|
+
outcome a control dispatch carries (#4617)
|
|
514
|
+
--events-json streams the job's run events (#4555);
|
|
515
|
+
with OTEL_EXPORTER_OTLP_ENDPOINT set, the job sends
|
|
516
|
+
its trace there
|
|
495
517
|
run resume [--op <name>] [--gate <name>] Start again each CI job that
|
|
496
518
|
waits at a gate an approval now answers, through the
|
|
497
519
|
forge's API (#3683); approves nothing. --gate resumes
|
|
@@ -500,6 +522,10 @@ Ops:
|
|
|
500
522
|
stopped once its run is gone (#3858). --dry-run
|
|
501
523
|
starts nothing; with --json it says per gate whether
|
|
502
524
|
it would resume and why
|
|
525
|
+
run pending --plan <digest> [--op <name>] List the gates waiting on a
|
|
526
|
+
plan digest, newest first, with the pull request a
|
|
527
|
+
pr-<n> gate belongs to (#4607). --json prints
|
|
528
|
+
{ plan, gates }
|
|
503
529
|
run --generate <provider> Write one CI pipeline file per scheduled Op for
|
|
504
530
|
github, gitlab or forgejo (#2533), from every Op that
|
|
505
531
|
declares a schedule or from --spec <file.json>.
|
|
@@ -525,6 +551,15 @@ Ops:
|
|
|
525
551
|
commit and runtime on every line (#4041). Also on
|
|
526
552
|
run <op>, components promote|rollback|redeploy,
|
|
527
553
|
fan-out, pr-plan and pr-apply
|
|
554
|
+
--adopt <adoption-file>: one component's cfn-deploy
|
|
555
|
+
step adopts the file's indexed resources into its
|
|
556
|
+
stack: an IMPORT change set without markers, then a
|
|
557
|
+
tags-only UPDATE that writes them. Each change set
|
|
558
|
+
is shown and asked about before it runs (--yes
|
|
559
|
+
approves; with no terminal and no --yes, nothing
|
|
560
|
+
runs). If the marker step stops after a good import,
|
|
561
|
+
a plain deploy of the same template writes the
|
|
562
|
+
markers (#4537)
|
|
528
563
|
operator Run scheduled ticks for discovered ConvergeOps
|
|
529
564
|
locally (#1485): acquire/renew a per-op
|
|
530
565
|
lease (git ref CAS), tick on --interval, record every
|
|
@@ -568,6 +603,12 @@ Ops:
|
|
|
568
603
|
--resume then starts the CI job that waits at the
|
|
569
604
|
gate again (GitHub re-run, GitLab retry, Forgejo
|
|
570
605
|
dispatch) with CHANT_FORGE_TOKEN
|
|
606
|
+
At a terminal it shows the stored plan and asks you
|
|
607
|
+
to type the target's name (the environment, else the
|
|
608
|
+
gate) before recording; a wrong answer exits 8, a
|
|
609
|
+
plan that moved while you were asked exits 4.
|
|
610
|
+
--yes, --json, CI and no terminal record as before
|
|
611
|
+
(#4575)
|
|
571
612
|
On op policy-override the gate is the subject a
|
|
572
613
|
policy denied: --rule <id> names each rule that
|
|
573
614
|
denied it and --reason <text> says why the plan goes
|
|
@@ -575,6 +616,17 @@ Ops:
|
|
|
575
616
|
applies it once, if .chant/overriders at base lists
|
|
576
617
|
--actor
|
|
577
618
|
|
|
619
|
+
notify relay Serve the relay that approves a waiting gate from a
|
|
620
|
+
Slack button or a Teams reply (#4611): verifies the
|
|
621
|
+
chat signature and the button's notify reference,
|
|
622
|
+
maps the clicker through the signers file at base,
|
|
623
|
+
and records chant approve --plan <digest> --actor
|
|
624
|
+
<principal> --relayed-by <relay>. Settings come from
|
|
625
|
+
CHANT_RELAY_KEY, SLACK_SIGNING_SECRET,
|
|
626
|
+
TEAMS_WEBHOOK_SECRET, CHANT_RELAY_PRINCIPAL,
|
|
627
|
+
CHANT_RELAY_MAX_AGE, CHANT_RELAY_HOST (default
|
|
628
|
+
127.0.0.1) and CHANT_RELAY_PORT (default 8787)
|
|
629
|
+
|
|
578
630
|
lock <target>... Lock targets for a pull request on chant/lifecycle
|
|
579
631
|
(--pr <n>, --stage plan|apply|lock, --head <sha>,
|
|
580
632
|
--by <who>, --gate <name>, --json). --from-report
|
|
@@ -619,9 +671,9 @@ Workspace (level 1, #2524):
|
|
|
619
671
|
the catalog-info.yaml files under dir, and shows what
|
|
620
672
|
it left out (#3178)
|
|
621
673
|
workspace promote <member> [--state <tfstate>] [--lexicon <name>] [--dry-run] [--output <patch>] [--json]
|
|
622
|
-
|
|
623
|
-
|
|
624
|
-
|
|
674
|
+
Change a member's kind (terraform to choudoufu runs
|
|
675
|
+
live-check and the adoption report; choudoufu or
|
|
676
|
+
other to chant runs chant import), staged
|
|
625
677
|
in a worktree and gated on the patch digest like upgrade
|
|
626
678
|
workspace promote --all [--state-dir <dir>] [--state <member>=<tfstate>]... [--canary <member>] [--wave-size <n>] [--dry-run] [--json]
|
|
627
679
|
Adopt every terraform member into choudoufu in waves:
|
|
@@ -1113,7 +1165,9 @@ Component release ledger + status:
|
|
|
1113
1165
|
the ones that depend on them, and write the
|
|
1114
1166
|
report and note (--base <ref> --pr <n>
|
|
1115
1167
|
[--forge github|gitlab|forgejo] posts them);
|
|
1116
|
-
|
|
1168
|
+
--target <address> narrows every member's plan
|
|
1169
|
+
to the address, --target <member>:<address>
|
|
1170
|
+
one member's (#4620); applies nothing
|
|
1117
1171
|
components pr-post Post the plan note and the chant/plan status
|
|
1118
1172
|
from the report pr-plan --no-status wrote
|
|
1119
1173
|
(--pr <n> --head <sha> --env <env> --forge
|
|
@@ -1126,6 +1180,12 @@ Component release ledger + status:
|
|
|
1126
1180
|
_merges/<commit>.json; applies and refuses
|
|
1127
1181
|
nothing, and a plan that differs from the
|
|
1128
1182
|
approved one sets a failing chant/record status
|
|
1183
|
+
agent prepare|run|land The agent jobs (#4616) the Op generator writes for
|
|
1184
|
+
a spec's agent: prepare decides from the comment or
|
|
1185
|
+
the drift check and the ledger's run count, run
|
|
1186
|
+
runs the model command with no forge token, land
|
|
1187
|
+
pushes the change, opens or updates the pull
|
|
1188
|
+
request and records the run (--forge <kind>)
|
|
1129
1189
|
components pr-env An environment per open pull request (#4298): up
|
|
1130
1190
|
--base <ref> --pr <n> applies the change to pr-<n>,
|
|
1131
1191
|
derived from ci.prEnvironment.template, once an
|
|
@@ -1146,10 +1206,10 @@ Component release ledger + status:
|
|
|
1146
1206
|
member's loop, gate op pr-<n>-<member>;
|
|
1147
1207
|
--resume <file> finishes an apply that failed
|
|
1148
1208
|
partway under the same approval;
|
|
1149
|
-
--wave-gate <name>: apply a wave at a time
|
|
1150
|
-
planned after the one before applied,
|
|
1151
|
-
wave waiting at <name>-wave-<k>, with
|
|
1152
|
-
for one wave per CI job;
|
|
1209
|
+
--wave-gate <name>: apply a wave at a time on op
|
|
1210
|
+
waves, each planned after the one before applied,
|
|
1211
|
+
a moved wave waiting at <name>-wave-<k>, with
|
|
1212
|
+
--wave <k> for one wave per CI job;
|
|
1153
1213
|
--green: apply the green commit at HEAD, measured
|
|
1154
1214
|
from the one last applied to --env, under the
|
|
1155
1215
|
approved plans of the merges since, else at gate
|
|
@@ -1159,10 +1219,22 @@ Component release ledger + status:
|
|
|
1159
1219
|
declaration at base sets ci.workflow to
|
|
1160
1220
|
apply-before-merge and the forge says it is
|
|
1161
1221
|
approved, mergeable, undiverged and green;
|
|
1222
|
+
--requires <list> asks only the checks it
|
|
1223
|
+
names (approved,mergeable,undiverged,checks);
|
|
1162
1224
|
--events-json, both commands: the run-event
|
|
1163
1225
|
stream on stdout; --report-url <s3 or file URL>,
|
|
1164
1226
|
both commands: copy the report, the change set
|
|
1165
1227
|
and the events to <url>/<pr>/<commit>/)
|
|
1228
|
+
components plan-wave --runs <file> --plans <file> --base <ref> --env <env>
|
|
1229
|
+
Plan one op wave's components through their
|
|
1230
|
+
capabilities and write the wave's plans file
|
|
1231
|
+
with its change set (#4588); --wave-outputs
|
|
1232
|
+
<file> seeds the outputs earlier waves left
|
|
1233
|
+
components apply-wave --runs <file> --plans <file> --base <ref> --env <env>
|
|
1234
|
+
Plan the approved runs again, exit 4 when a plan
|
|
1235
|
+
moved, else apply them and add their outputs to
|
|
1236
|
+
--wave-outputs (#4588). Both are the steps of the
|
|
1237
|
+
waves pr-apply --wave-gate runs on op waves
|
|
1166
1238
|
components release <env> Append one immutable release record
|
|
1167
1239
|
(--component <name> --digest <sha256:...>
|
|
1168
1240
|
[--git-sha <sha>] [--run-id <id>] [--actor <name>]);
|
|
@@ -1229,7 +1301,8 @@ Local:
|
|
|
1229
1301
|
|
|
1230
1302
|
Servers:
|
|
1231
1303
|
serve lsp Start the LSP server (stdio)
|
|
1232
|
-
serve mcp Start the MCP server (stdio)
|
|
1304
|
+
serve mcp Start the MCP server (stdio); --read-only serves only
|
|
1305
|
+
the tools that read (ledger, graph, runs) and run nothing
|
|
1233
1306
|
|
|
1234
1307
|
Project:
|
|
1235
1308
|
update (alias: sync) Sync lexicon types into .chant/types/ (does not install
|
|
@@ -1256,6 +1329,7 @@ Options:
|
|
|
1256
1329
|
records its lineage in .chant/workspace.lock.json
|
|
1257
1330
|
--skill <name> Init: install only this skill from the lexicon
|
|
1258
1331
|
--skip-mcp Init: scaffold without writing the project's .mcp.json
|
|
1332
|
+
--mcp-read-only Init: register \`chant serve mcp --read-only\` in .mcp.json
|
|
1259
1333
|
--fix Auto-fix fixable issues (lint command)
|
|
1260
1334
|
--force Force overwrite existing files (import command)
|
|
1261
1335
|
-w, --watch Watch for changes and rebuild/re-lint (build, lint)
|
|
@@ -1530,8 +1604,30 @@ function commandRunsNoConfig(def, args) {
|
|
|
1530
1604
|
* checked, plugins are loaded when the command needs them, and the handler
|
|
1531
1605
|
* runs. A `process.exit` inside (loadPluginsOrExit's, say) is the caller's to
|
|
1532
1606
|
* catch.
|
|
1607
|
+
*
|
|
1608
|
+
* `words` (#4550) are a CI product's words (`@intentius/chant/ci-product`):
|
|
1609
|
+
* the product's bin passes them, so the command renders in the product's
|
|
1610
|
+
* words while it runs. `mcp` (#4555) is its tool hook, which `chant serve
|
|
1611
|
+
* mcp` serves beside chant's own tools.
|
|
1533
1612
|
*/
|
|
1534
|
-
export async function runCommandInProcess(argv) {
|
|
1613
|
+
export async function runCommandInProcess(argv, options = {}) {
|
|
1614
|
+
// #4614: a product's after-plan hooks and capabilities on `chant run wave`, in its own process.
|
|
1615
|
+
if (options.wave) {
|
|
1616
|
+
const { withProductWaveHook } = await import("../op/op-waves-after-plan.js");
|
|
1617
|
+
const { wave, ...rest } = options;
|
|
1618
|
+
return withProductWaveHook(wave, () => runCommandInProcess(argv, rest));
|
|
1619
|
+
}
|
|
1620
|
+
// #4555: a product's tools on `chant serve mcp`, through its tool hook.
|
|
1621
|
+
if (options.mcp) {
|
|
1622
|
+
const { withProductMcpHook } = await import("./mcp/product-tools.js");
|
|
1623
|
+
const { mcp, ...rest } = options;
|
|
1624
|
+
return withProductMcpHook(mcp, () => runCommandInProcess(argv, rest));
|
|
1625
|
+
}
|
|
1626
|
+
// #4550: a product's bin calls chant with its words; every status, note and
|
|
1627
|
+
// approve line the command writes takes them, and the earlier words come
|
|
1628
|
+
// back once it settles.
|
|
1629
|
+
if (options.words)
|
|
1630
|
+
return withProductWords(options.words, () => runCommandInProcess(argv));
|
|
1535
1631
|
const args = parseArgs(argv);
|
|
1536
1632
|
const match = resolveCommand(args, commandRegistry);
|
|
1537
1633
|
if (!match) {
|
|
@@ -1612,6 +1708,10 @@ export const commandRegistry = [
|
|
|
1612
1708
|
{ name: "ci tick", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli.js")).runCiTick(ctx) },
|
|
1613
1709
|
{ name: "ci workflow", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-green-cli.js")).runCiWorkflow(ctx) },
|
|
1614
1710
|
{ name: "ci init", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-init.js")).runCiInit(ctx) },
|
|
1711
|
+
// #4556: the ci.hooks.check hooks at base, for a product's check job.
|
|
1712
|
+
{ name: "ci check", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-check.js")).runCiCheck(ctx) },
|
|
1713
|
+
// #4608: the live forge, cloud trust policies and Pulumi Cloud's OIDC policies against ci.identity.cloud. Read-only.
|
|
1714
|
+
{ name: "ci forge-check", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/ci-forge-check.js")).runCiForgeCheck(ctx) },
|
|
1615
1715
|
// #4094: one pull-request job as a pipeline Op in a fresh checkout, the chant runner's first slice.
|
|
1616
1716
|
{ name: "ci run", runsNoConfig: true, handler: async (ctx) => (await import("../workspace/ci-run.js")).runCiRun(ctx) },
|
|
1617
1717
|
// #4098: the run index at the report URL.
|
|
@@ -1659,12 +1759,16 @@ export const commandRegistry = [
|
|
|
1659
1759
|
{ name: "run wave", handler: runOpWaveCommand },
|
|
1660
1760
|
// #3683 — start the CI jobs that wait at gates whose approval arrived. Imported on first use.
|
|
1661
1761
|
{ name: "run resume", handler: async (ctx) => (await import("./handlers/gate-resume.js")).runResumeCommand(ctx) },
|
|
1762
|
+
// #4607 — the pending gates a plan digest waits at, with their pull request. Imported on first use.
|
|
1763
|
+
{ name: "run pending", handler: async (ctx) => (await import("./handlers/gate-pending.js")).runPendingCommand(ctx) },
|
|
1662
1764
|
{ name: "run", handler: runOp },
|
|
1663
1765
|
{ name: "operator status", handler: runOperatorStatus },
|
|
1664
1766
|
{ name: "operator log", handler: runOperatorLog },
|
|
1665
1767
|
{ name: "operator", handler: runOperator },
|
|
1666
1768
|
{ name: "approve", handler: runApprove },
|
|
1667
1769
|
// #4293 — target locks a pull request holds on chant/lifecycle. Imported on first use.
|
|
1770
|
+
// #4611 — approve a waiting gate from a chat click. Imported on first use.
|
|
1771
|
+
{ name: "notify relay", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/notify-relay.js")).runNotifyRelay(ctx) },
|
|
1668
1772
|
{ name: "lock", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/lock.js")).runLock(ctx) },
|
|
1669
1773
|
{ name: "unlock", runsNoConfig: true, handler: async (ctx) => (await import("./handlers/lock.js")).runUnlock(ctx) },
|
|
1670
1774
|
{ name: "graph", handler: runGraph },
|
|
@@ -1762,9 +1866,16 @@ export const commandRegistry = [
|
|
|
1762
1866
|
// #3183 — the pull-request loop the generated CI runs. Imported on first use.
|
|
1763
1867
|
{ name: "components pr-plan", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsPrPlan(ctx) },
|
|
1764
1868
|
{ name: "components pr-apply", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsPrApply(ctx) },
|
|
1869
|
+
// #4588: the component plan-wave and apply-wave steps a component waves spec runs (pr-apply --wave-gate on op waves).
|
|
1870
|
+
{ name: "components plan-wave", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsPlanWave(ctx) },
|
|
1871
|
+
{ name: "components apply-wave", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsApplyWave(ctx) },
|
|
1765
1872
|
// #4295: posts from the plan report in a job that runs none of the change's code, so it loads no plugins.
|
|
1766
1873
|
{ name: "components pr-post", handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsPrPost(ctx) },
|
|
1767
1874
|
{ name: "components pr-record", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr.js")).runComponentsPrRecord(ctx) },
|
|
1875
|
+
// #4616: the agent jobs' three steps. Imported on first use; none loads plugins.
|
|
1876
|
+
{ name: "agent prepare", handler: async (ctx) => (await import("./handlers/agent.js")).runAgentCommandLine(ctx) },
|
|
1877
|
+
{ name: "agent run", handler: async (ctx) => (await import("./handlers/agent.js")).runAgentCommandLine(ctx) },
|
|
1878
|
+
{ name: "agent land", handler: async (ctx) => (await import("./handlers/agent.js")).runAgentCommandLine(ctx) },
|
|
1768
1879
|
{ name: "components pr-env", requiresPlugins: true, handler: async (ctx) => (await import("./handlers/pr-env.js")).runComponentsPrEnv(ctx) },
|
|
1769
1880
|
{ name: "components status", requiresPlugins: true, handler: runComponentsStatus },
|
|
1770
1881
|
{ name: "components release", handler: runComponentsReleaseRecord },
|
|
@@ -0,0 +1,36 @@
|
|
|
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
|
+
import type { ToolDefinition, ToolHandler } from "./types.js";
|
|
22
|
+
import { type ChantCommand } from "./workspace-tools.js";
|
|
23
|
+
/** The tables `chant ledger` reads, in its usage order. */
|
|
24
|
+
export declare const LEDGER_TABLES: readonly ["resources", "snapshots", "runs", "gates", "deploys", "releases", "cuts"];
|
|
25
|
+
export declare const ledgerReadTools: ToolDefinition[];
|
|
26
|
+
/** The `chant` arguments each ledger tool runs, from its input. */
|
|
27
|
+
export declare function ledgerArgv(tool: string, params: Record<string, unknown>): string[];
|
|
28
|
+
/** The ledger read tools, bound to the server's directory. */
|
|
29
|
+
export declare function createLedgerTools(options: {
|
|
30
|
+
cwd: string;
|
|
31
|
+
chantCommand?: ChantCommand;
|
|
32
|
+
}): {
|
|
33
|
+
definition: ToolDefinition;
|
|
34
|
+
handler: ToolHandler;
|
|
35
|
+
}[];
|
|
36
|
+
//# sourceMappingURL=ledger-tools.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ledger-tools.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/ledger-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEhF,2DAA2D;AAC3D,eAAO,MAAM,aAAa,YAAI,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,CAAU,CAAC;AA8BjH,eAAO,MAAM,eAAe,EAAE,cAAc,EAoC3C,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAsBlF;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,UAAU,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,EAAE,CAM/I"}
|
|
@@ -0,0 +1,122 @@
|
|
|
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
|
+
import { ownChantCommand, runRead } from "./workspace-tools.js";
|
|
22
|
+
/** The tables `chant ledger` reads, in its usage order. */
|
|
23
|
+
export const LEDGER_TABLES = ["resources", "snapshots", "runs", "gates", "deploys", "releases", "cuts"];
|
|
24
|
+
class ToolInputError extends Error {
|
|
25
|
+
}
|
|
26
|
+
function str(params, key, required = false) {
|
|
27
|
+
const v = params[key];
|
|
28
|
+
if (v === undefined || v === null) {
|
|
29
|
+
if (required)
|
|
30
|
+
throw new ToolInputError(`${key} is required`);
|
|
31
|
+
return undefined;
|
|
32
|
+
}
|
|
33
|
+
if (typeof v !== "string" || v === "")
|
|
34
|
+
throw new ToolInputError(`${key} must be a non-empty string`);
|
|
35
|
+
// A value is passed as one argument; one that starts with - would read as a flag.
|
|
36
|
+
if (v.startsWith("-"))
|
|
37
|
+
throw new ToolInputError(`${key} may not start with -: ${JSON.stringify(v)}`);
|
|
38
|
+
return v;
|
|
39
|
+
}
|
|
40
|
+
function list(params, key) {
|
|
41
|
+
const v = params[key];
|
|
42
|
+
if (v === undefined || v === null)
|
|
43
|
+
return [];
|
|
44
|
+
const items = typeof v === "string" ? [v] : v;
|
|
45
|
+
if (!Array.isArray(items))
|
|
46
|
+
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
|
+
const memberProp = {
|
|
50
|
+
type: "array",
|
|
51
|
+
items: { type: "string" },
|
|
52
|
+
description: "Only these workspace members' ledgers (--member). Outside a workspace the project's own ledger is read.",
|
|
53
|
+
};
|
|
54
|
+
export const ledgerReadTools = [
|
|
55
|
+
{
|
|
56
|
+
name: "ledger",
|
|
57
|
+
description: "One ledger's rows from the local chant/lifecycle branch: chant ledger <table> --json (#4363). Tables: " +
|
|
58
|
+
LEDGER_TABLES.join(", ") +
|
|
59
|
+
". 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.",
|
|
60
|
+
inputSchema: {
|
|
61
|
+
type: "object",
|
|
62
|
+
properties: {
|
|
63
|
+
table: { type: "string", enum: [...LEDGER_TABLES], description: "The ledger to read." },
|
|
64
|
+
member: memberProp,
|
|
65
|
+
where: {
|
|
66
|
+
type: "array",
|
|
67
|
+
items: { type: "string" },
|
|
68
|
+
description: "Typed filters, each <field><op><value> such as state=failed (--where, repeatable).",
|
|
69
|
+
},
|
|
70
|
+
since: { type: "string", description: "Only rows at or after this time (--since)." },
|
|
71
|
+
at: { type: "string", description: "Read the ledger as this commit of chant/lifecycle held it (--at)." },
|
|
72
|
+
},
|
|
73
|
+
required: ["table"],
|
|
74
|
+
},
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
name: "query",
|
|
78
|
+
description: "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.",
|
|
79
|
+
inputSchema: {
|
|
80
|
+
type: "object",
|
|
81
|
+
properties: {
|
|
82
|
+
sql: { type: "string", description: "The SQL statement." },
|
|
83
|
+
member: memberProp,
|
|
84
|
+
},
|
|
85
|
+
required: ["sql"],
|
|
86
|
+
},
|
|
87
|
+
},
|
|
88
|
+
];
|
|
89
|
+
/** The `chant` arguments each ledger tool runs, from its input. */
|
|
90
|
+
export function ledgerArgv(tool, params) {
|
|
91
|
+
const members = list(params, "member").flatMap((m) => ["--member", m]);
|
|
92
|
+
switch (tool) {
|
|
93
|
+
case "ledger": {
|
|
94
|
+
const table = str(params, "table", true);
|
|
95
|
+
if (!LEDGER_TABLES.includes(table))
|
|
96
|
+
throw new ToolInputError(`table must be one of ${LEDGER_TABLES.join(", ")}`);
|
|
97
|
+
const where = list(params, "where").flatMap((w) => ["--where", w]);
|
|
98
|
+
const flags = ["since", "at"].flatMap((f) => {
|
|
99
|
+
const v = str(params, f);
|
|
100
|
+
return v !== undefined ? [`--${f}`, v] : [];
|
|
101
|
+
});
|
|
102
|
+
return ["ledger", table, ...members, ...where, ...flags, "--json"];
|
|
103
|
+
}
|
|
104
|
+
case "query": {
|
|
105
|
+
// The statement is one argument after `--`, so text that opens with - stays SQL.
|
|
106
|
+
const sql = params.sql;
|
|
107
|
+
if (typeof sql !== "string" || sql.trim() === "")
|
|
108
|
+
throw new ToolInputError("sql must be a non-empty string");
|
|
109
|
+
return ["query", ...members, "--json", "--", sql];
|
|
110
|
+
}
|
|
111
|
+
default:
|
|
112
|
+
throw new ToolInputError(`${tool} is not a ledger read tool`);
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
/** The ledger read tools, bound to the server's directory. */
|
|
116
|
+
export function createLedgerTools(options) {
|
|
117
|
+
const chant = options.chantCommand ?? ownChantCommand();
|
|
118
|
+
return ledgerReadTools.map((definition) => ({
|
|
119
|
+
definition,
|
|
120
|
+
handler: async (params) => runRead(chant, ledgerArgv(definition.name, params), options.cwd),
|
|
121
|
+
}));
|
|
122
|
+
}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* chant#4555: the product tool hook on `chant serve mcp`. A CI product built
|
|
3
|
+
* on chant (terragucci, plywood) adds its own tools to chant's server rather
|
|
4
|
+
* than running a server of its own: its bin calls
|
|
5
|
+
* `runChantInProcess(["serve", "mcp"], words, { mcp: hook })`
|
|
6
|
+
* (`@intentius/chant/ci-product`), or constructs `McpServer` with
|
|
7
|
+
* `product: hook`.
|
|
8
|
+
*
|
|
9
|
+
* Read-only by default, under the rule chant#4543 set for every contributed
|
|
10
|
+
* tool:
|
|
11
|
+
*
|
|
12
|
+
* - a server started through the hook is read-only unless the hook says
|
|
13
|
+
* `readOnly: false`;
|
|
14
|
+
* - a read-only server serves a product tool only when it declares
|
|
15
|
+
* `readOnly: true` (`servesContributedTool`);
|
|
16
|
+
* - a read-only server refuses to start with a product tool whose name says
|
|
17
|
+
* it would approve, apply, override or write ({@link productToolWriteWord}),
|
|
18
|
+
* the check terragucci's own server made (`assertReadOnly`);
|
|
19
|
+
* - the tools read the report store through a reader that cannot write, with
|
|
20
|
+
* the server's own credentials, never from a tool's arguments.
|
|
21
|
+
*
|
|
22
|
+
* Tools are registered as `<product>:<name>`, as a lexicon's are.
|
|
23
|
+
*/
|
|
24
|
+
import type { McpToolContribution } from "../../mcp/types.js";
|
|
25
|
+
import { type ReportReader } from "./report-tools.js";
|
|
26
|
+
/** What a product's tools are handed. */
|
|
27
|
+
export interface ProductMcpContext {
|
|
28
|
+
/** The directory the server serves. */
|
|
29
|
+
cwd: string;
|
|
30
|
+
/** Whether the server is read-only. */
|
|
31
|
+
readOnly: boolean;
|
|
32
|
+
/**
|
|
33
|
+
* The report store, read-only: the hook's `reportUrl`, else the declared
|
|
34
|
+
* `ci.reportUrl`. Resolves undefined when neither names one.
|
|
35
|
+
*/
|
|
36
|
+
reports(): Promise<ReportReader | undefined>;
|
|
37
|
+
}
|
|
38
|
+
/** A product's tools on chant's MCP server. */
|
|
39
|
+
export interface ProductMcpHook {
|
|
40
|
+
/** The product's name, the tools' namespace: `terragucci`, `plywood`. */
|
|
41
|
+
product: string;
|
|
42
|
+
/** The product's tools. Called once, when the server starts. */
|
|
43
|
+
tools(ctx: ProductMcpContext): McpToolContribution[];
|
|
44
|
+
/** The report store the tools read. Default: the workspace's `ci.reportUrl`. */
|
|
45
|
+
reportUrl?: string;
|
|
46
|
+
/** `false` starts an ordinary server through the hook. Default: read-only. */
|
|
47
|
+
readOnly?: boolean;
|
|
48
|
+
/** Text added to the server's `initialize` instructions. */
|
|
49
|
+
instructions?: string;
|
|
50
|
+
}
|
|
51
|
+
/** Words that say a tool would change something; a read-only server will not serve a tool named with one. terragucci's list. */
|
|
52
|
+
export declare const PRODUCT_TOOL_WRITE_WORDS: readonly ["approve", "apply", "override", "revoke", "unlock", "lock", "merge", "resume", "migrate", "write", "put", "delete", "push", "commit", "publish", "reconcile", "rollout", "init", "generate", "respond", "relay", "notify", "update", "create", "exec"];
|
|
53
|
+
/** The words that refuse a name wherever they stand in it, not only first. */
|
|
54
|
+
export declare const PRODUCT_TOOL_STRONG_WORDS: readonly ["approve", "override", "revoke", "unlock", "merge", "write", "delete", "push", "commit", "publish", "exec"];
|
|
55
|
+
/**
|
|
56
|
+
* The word in `name` that says the tool would change something, or
|
|
57
|
+
* undefined. A name may not start with a write word, and may not hold a
|
|
58
|
+
* strong one anywhere: `last_apply` reads, `apply_wave` and `wave_approve`
|
|
59
|
+
* do not.
|
|
60
|
+
*/
|
|
61
|
+
export declare function productToolWriteWord(name: string): string | undefined;
|
|
62
|
+
/** A read-only server refused a product tool named as a write. */
|
|
63
|
+
export declare class ProductToolRefusedError extends Error {
|
|
64
|
+
constructor(product: string, name: string, word: string);
|
|
65
|
+
}
|
|
66
|
+
/**
|
|
67
|
+
* The product tools a server serves: on a read-only server only those that
|
|
68
|
+
* declare `readOnly: true`, and none named as a write (a throw, so the server
|
|
69
|
+
* does not start). On an ordinary server every tool.
|
|
70
|
+
*/
|
|
71
|
+
export declare function productToolsServed(hook: ProductMcpHook, ctx: ProductMcpContext): McpToolContribution[];
|
|
72
|
+
/** The context a hook's tools get on a server at `cwd`. The store is opened on first read. */
|
|
73
|
+
export declare function productMcpContext(hook: ProductMcpHook, cwd: string, readOnly: boolean): ProductMcpContext;
|
|
74
|
+
/** The hook the running command serves, set by a product's bin. */
|
|
75
|
+
export declare function activeProductMcpHook(): ProductMcpHook | undefined;
|
|
76
|
+
/** Run `fn` with `hook` active, and put the earlier one back after it settles. */
|
|
77
|
+
export declare function withProductMcpHook<T>(hook: ProductMcpHook | undefined, fn: () => Promise<T>): Promise<T>;
|
|
78
|
+
//# sourceMappingURL=product-tools.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"product-tools.d.ts","sourceRoot":"","sources":["../../../src/cli/mcp/product-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAA8B,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE/E,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;CAC9C;AAED,+CAA+C;AAC/C,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,KAAK,CAAC,GAAG,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CAAC;IACrD,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,gIAAgI;AAChI,eAAO,MAAM,wBAAwB,YAAI,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC;AAEzS,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,YAAI,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAU,CAAC;AAE/J;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIrE;AAED,kEAAkE;AAClE,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAGtD;CACF;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CAUtG;AAED,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,iBAAiB,CAQzG;AAID,mEAAmE;AACnE,wBAAgB,oBAAoB,IAAI,cAAc,GAAG,SAAS,CAEjE;AAED,kFAAkF;AAClF,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,IAAI,EAAE,cAAc,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAS9G"}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* chant#4555: the product tool hook on `chant serve mcp`. A CI product built
|
|
3
|
+
* on chant (terragucci, plywood) adds its own tools to chant's server rather
|
|
4
|
+
* than running a server of its own: its bin calls
|
|
5
|
+
* `runChantInProcess(["serve", "mcp"], words, { mcp: hook })`
|
|
6
|
+
* (`@intentius/chant/ci-product`), or constructs `McpServer` with
|
|
7
|
+
* `product: hook`.
|
|
8
|
+
*
|
|
9
|
+
* Read-only by default, under the rule chant#4543 set for every contributed
|
|
10
|
+
* tool:
|
|
11
|
+
*
|
|
12
|
+
* - a server started through the hook is read-only unless the hook says
|
|
13
|
+
* `readOnly: false`;
|
|
14
|
+
* - a read-only server serves a product tool only when it declares
|
|
15
|
+
* `readOnly: true` (`servesContributedTool`);
|
|
16
|
+
* - a read-only server refuses to start with a product tool whose name says
|
|
17
|
+
* it would approve, apply, override or write ({@link productToolWriteWord}),
|
|
18
|
+
* the check terragucci's own server made (`assertReadOnly`);
|
|
19
|
+
* - the tools read the report store through a reader that cannot write, with
|
|
20
|
+
* the server's own credentials, never from a tool's arguments.
|
|
21
|
+
*
|
|
22
|
+
* Tools are registered as `<product>:<name>`, as a lexicon's are.
|
|
23
|
+
*/
|
|
24
|
+
import { servesContributedTool } from "./read-only.js";
|
|
25
|
+
import { reportReader, reportUrlFor } from "./report-tools.js";
|
|
26
|
+
/** Words that say a tool would change something; a read-only server will not serve a tool named with one. terragucci's list. */
|
|
27
|
+
export const PRODUCT_TOOL_WRITE_WORDS = ["approve", "apply", "override", "revoke", "unlock", "lock", "merge", "resume", "migrate", "write", "put", "delete", "push", "commit", "publish", "reconcile", "rollout", "init", "generate", "respond", "relay", "notify", "update", "create", "exec"];
|
|
28
|
+
/** The words that refuse a name wherever they stand in it, not only first. */
|
|
29
|
+
export const PRODUCT_TOOL_STRONG_WORDS = ["approve", "override", "revoke", "unlock", "merge", "write", "delete", "push", "commit", "publish", "exec"];
|
|
30
|
+
/**
|
|
31
|
+
* The word in `name` that says the tool would change something, or
|
|
32
|
+
* undefined. A name may not start with a write word, and may not hold a
|
|
33
|
+
* strong one anywhere: `last_apply` reads, `apply_wave` and `wave_approve`
|
|
34
|
+
* do not.
|
|
35
|
+
*/
|
|
36
|
+
export function productToolWriteWord(name) {
|
|
37
|
+
const parts = name.toLowerCase().split(/[^a-z]+/).filter(Boolean);
|
|
38
|
+
const first = parts[0] ?? "";
|
|
39
|
+
return PRODUCT_TOOL_WRITE_WORDS.find((w) => first.startsWith(w)) ?? PRODUCT_TOOL_STRONG_WORDS.find((w) => parts.some((p) => p.startsWith(w)));
|
|
40
|
+
}
|
|
41
|
+
/** A read-only server refused a product tool named as a write. */
|
|
42
|
+
export class ProductToolRefusedError extends Error {
|
|
43
|
+
constructor(product, name, word) {
|
|
44
|
+
super(`chant serve mcp is read-only for ${product}, and the tool ${name} would ${word}; the server does not start with it`);
|
|
45
|
+
this.name = "ProductToolRefusedError";
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
const PRODUCT = /^[a-z0-9][a-z0-9-]*$/;
|
|
49
|
+
/**
|
|
50
|
+
* The product tools a server serves: on a read-only server only those that
|
|
51
|
+
* declare `readOnly: true`, and none named as a write (a throw, so the server
|
|
52
|
+
* does not start). On an ordinary server every tool.
|
|
53
|
+
*/
|
|
54
|
+
export function productToolsServed(hook, ctx) {
|
|
55
|
+
if (!PRODUCT.test(hook.product))
|
|
56
|
+
throw new Error(`the product tool hook's product ${JSON.stringify(hook.product)} is not a product name ([a-z0-9-])`);
|
|
57
|
+
const served = hook.tools(ctx).filter((t) => servesContributedTool(t, ctx.readOnly));
|
|
58
|
+
if (ctx.readOnly) {
|
|
59
|
+
for (const t of served) {
|
|
60
|
+
const word = productToolWriteWord(t.name.startsWith(`${hook.product}:`) ? t.name.slice(hook.product.length + 1) : t.name);
|
|
61
|
+
if (word)
|
|
62
|
+
throw new ProductToolRefusedError(hook.product, t.name, word);
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
return served;
|
|
66
|
+
}
|
|
67
|
+
/** The context a hook's tools get on a server at `cwd`. The store is opened on first read. */
|
|
68
|
+
export function productMcpContext(hook, cwd, readOnly) {
|
|
69
|
+
let opened;
|
|
70
|
+
return {
|
|
71
|
+
cwd,
|
|
72
|
+
readOnly,
|
|
73
|
+
reports: () => (opened ?? (opened = reportUrlFor(hook.reportUrl, cwd).then((url) => (url ? reportReader(url) : undefined)))),
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
let active;
|
|
77
|
+
/** The hook the running command serves, set by a product's bin. */
|
|
78
|
+
export function activeProductMcpHook() {
|
|
79
|
+
return active;
|
|
80
|
+
}
|
|
81
|
+
/** Run `fn` with `hook` active, and put the earlier one back after it settles. */
|
|
82
|
+
export async function withProductMcpHook(hook, fn) {
|
|
83
|
+
if (!hook)
|
|
84
|
+
return fn();
|
|
85
|
+
const was = active;
|
|
86
|
+
active = hook;
|
|
87
|
+
try {
|
|
88
|
+
return await fn();
|
|
89
|
+
}
|
|
90
|
+
finally {
|
|
91
|
+
active = was;
|
|
92
|
+
}
|
|
93
|
+
}
|