ContractSpecContractSpec

Start with OSS

Back to changelog index

6.7.0

May 30, 2026 · 3 packages · 4 unique changes · 1 release entry

appsbundlesBreaking changes

This release affects the solutions family.

Run contractspec connect adoption resolve --family solutions to see how it impacts your project.

Release summaries

  • cli-mcp-consumer-enablement

    Decommission the hosted ContractSpec MCP (api-library /mcp/* and /api/mcp/* docs/cli/ internal/contracts endpoints) and ship two local offline-first stdio MCP servers in the CLI: `contractspec mcp` (knowledge + author tools, fully offline, with a new contracts.create scaffold) and `contractspec mcp --runtime` (fail-closed projection of the consumer's own contracts). bundle.library's MCP builders become transport-agnostic.

    maintainer

    api-library loses its MCP handlers (mcp-handler.ts, contracts-mcp-services.ts) and their wiring — zero hosted MCP compute; GraphQL/webhooks/control-plane/channel handlers are unchanged. cli-contractspec gains a `mcp` command with a default knowledge+author server and a `--runtime` projection server under src/ai/mcp/* (runtime/* projects only OperationSpecRegistry.listBound() ops behind a fail-closed decide). bundle.library exposes buildDocsMcpRegistries/buildCliMcpRegistries/ buildInternalMcpRegistries/buildContractsMcpRegistries plus a contracts-first contracts.create defineCommand (+ createSpec on ContractsMcpServices); existing Elysia handlers are unchanged (web-landing still serves docs MCP over HTTP).

    integrator

    The hosted api.contractspec.io MCP endpoints are gone — repoint editors/agents at the local CLI MCP servers. `contractspec mcp` is offline and needs zero setup; `contractspec mcp --runtime` projects this repo's contracts as MCP tools, allowing read-only queries and denying writes/commands by default (opt in via .contractsrc.json mcp.runtime.allowWrites; override discovery via mcp.runtime.registry). The mcp.runtime keys are read raw and not yet in contractsrc.schema.json (no autocomplete — v1 limit).

Deprecations

  • - Hosted MCP endpoints `/mcp/{docs,cli,internal,contracts}` and `/api/mcp/*` on api.contractspec.io are removed with no backward-compatible shim. Use the local CLI stdio servers `contractspec mcp` and `contractspec mcp --runtime`.

Migration guide

  • Replace hosted ContractSpec MCP entries with local stdio servers

    Required

    Hosted api.contractspec.io MCP endpoints are removed; editor and agent configs must point at the local CLI MCP server entries instead.

    1. Remove the four hosted MCP entries (contractspec-docs, contractspec-cli, contractspec-internal, contractspec-contracts) from mcp.json / .claude / .cursor / .zed.
    2. Add a local stdio entry: {"command":"npx","args":["-y", "@lssm-tech/app.cli-contractspec","mcp"]}.
    3. Optionally add a "contractspec-runtime" entry with ["-y", "@lssm-tech/app.cli-contractspec", "mcp", "--runtime"]. Zed entries also add "type":"stdio".
    4. Keep unrelated MCP servers untouched.

Upgrade steps

  • Repoint MCP clients from hosted endpoints to the local CLI servers

    assisted

    Switch editor/agent MCP config from the removed hosted URLs to the local stdio CLI servers, then optionally enable runtime projection for your own contracts.

    Packages: @lssm-tech/app.cli-contractspec, @lssm-tech/app.api-library

    1. Remove the hosted contractspec-docs/cli/internal/contracts MCP entries and add "contractspec": npx -y @lssm-tech/app.cli-contractspec mcp (offline knowledge + author tools).
    2. (Optional) Add "contractspec-runtime": npx -y @lssm-tech/app.cli-contractspec mcp --runtime to project your repo's contracts; declare writable ops in .contractsrc.json mcp.runtime.allowWrites since writes are denied by default.

Unique release changes

  • - Decommission the hosted ContractSpec MCP (api-library /mcp/* and /api/mcp/* docs/cli/ internal/contracts endpoints) and ship two local offline-first stdio MCP servers in the CLI: `contractspec mcp` (knowledge + author tools, fully offline, with a new contracts.create scaffold) and `contractspec mcp --runtime` (fail-closed projection of the consumer's own contracts). bundle.library's MCP builders become transport-agnostic.

    3 packages · 3 occurrences

  • - Hosted api.contractspec.io MCP endpoints are removed; editor and agent configs must point at the local CLI MCP server entries instead.

    3 packages · 3 occurrences

  • - Hosted MCP endpoints `/mcp/{docs,cli,internal,contracts}` and `/api/mcp/*` on api.contractspec.io are removed with no backward-compatible shim. Use the local CLI stdio servers `contractspec mcp` and `contractspec mcp --runtime`.

    3 packages · 3 occurrences

  • - Switch editor/agent MCP config from the removed hosted URLs to the local stdio CLI servers, then optionally enable runtime projection for your own contracts.

    3 packages · 3 occurrences

Impacted packages

  • @lssm-tech/app.api-library

    Layer: apps · 4 changes

  • @lssm-tech/app.cli-contractspec

    Layer: apps · 4 changes

  • @lssm-tech/bundle.library

    Layer: bundles · 4 changes