@contractspec/bundle.library 3.8.10 → 3.8.12

package/dist/node/application/index.js

@@ -1,2136 +1,16 @@
-// src/application/context-storage/index.ts
-import {
-  EmbeddingService,
-  VectorIndexer
-} from "@contractspec/lib.knowledge/ingestion";
-import {
-  ContextSnapshotPipeline,
-  PostgresContextStorage
-} from "@contractspec/module.context-storage";
-function createContextStorageService(options) {
-  const store = new PostgresContextStorage({
-    database: options.database,
-    schema: options.schema,
-    createTablesIfMissing: options.createTablesIfMissing
-  });
-  const embeddingService = options.embeddingProvider ? new EmbeddingService(options.embeddingProvider, options.embeddingBatchSize) : undefined;
-  const vectorIndexer = options.vectorStoreProvider && options.vectorIndex ? new VectorIndexer(options.vectorStoreProvider, options.vectorIndex) : undefined;
-  const pipeline = new ContextSnapshotPipeline({
-    store,
-    documentProcessor: options.documentProcessor,
-    embeddingService,
-    vectorIndexer
-  });
-  return { store, pipeline };
-}
-
-// src/infrastructure/elysia/logger.ts
-import { Logger, LogLevel } from "@contractspec/lib.logger";
-var createAppLogger = () => new Logger({
-  level: LogLevel.INFO,
-  environment: "production",
-  enableTracing: true,
-  enableTiming: true,
-  enableContext: true,
-  enableColors: false
-});
-var appLogger = createAppLogger();
-var dbLogger = new Logger({
-  level: LogLevel.WARN,
-  environment: "production",
-  enableTracing: true,
-  enableTiming: true,
-  enableContext: true,
-  enableColors: false
-});
-var authLogger = new Logger({
-  level: LogLevel.INFO,
-  environment: "production",
-  enableTracing: true,
-  enableTiming: true,
-  enableContext: true,
-  enableColors: false
-});
-// src/application/mcp/normalizeMcpRequest.ts
-var REQUIRED_ACCEPT_TYPES = ["application/json", "text/event-stream"];
-function canNormalizeAcceptHeader(acceptHeader) {
-  return !acceptHeader || acceptHeader.includes("*/*") || acceptHeader.includes("application/*") || REQUIRED_ACCEPT_TYPES.some((value) => acceptHeader.includes(value));
-}
-function normalizeMcpRequest(request) {
-  if (request.method !== "POST")
-    return request;
-  const acceptHeader = request.headers.get("accept");
-  if (!canNormalizeAcceptHeader(acceptHeader))
-    return request;
-  const missingTypes = REQUIRED_ACCEPT_TYPES.filter((value) => !acceptHeader?.includes(value));
-  if (missingTypes.length === 0)
-    return request;
-  const headers = new Headers(request.headers);
-  headers.set("accept", [acceptHeader, ...missingTypes].filter(Boolean).join(", "));
-  return new Request(request, { headers });
-}
-
-// src/application/mcp/common.ts
-import { createMcpServer } from "@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";
-import { PresentationRegistry } from "@contractspec/lib.contracts-spec/presentations";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
-import { randomUUID } from "crypto";
-import { Elysia } from "elysia";
-var baseCtx = {
-  actor: "anonymous",
-  decide: async () => ({ effect: "allow" })
-};
-function createJsonRpcErrorResponse(status, code, message, data) {
-  return new Response(JSON.stringify({
-    jsonrpc: "2.0",
-    error: {
-      code,
-      message,
-      ...data ? { data } : {}
-    },
-    id: null
-  }), {
-    status,
-    headers: {
-      "content-type": "application/json"
-    }
-  });
-}
-function createSessionState({
-  logger,
-  serverName,
-  ops,
-  resources,
-  prompts,
-  presentations,
-  stateful
-}) {
-  const server = new McpServer({
-    name: serverName,
-    version: "1.0.0"
-  }, {
-    capabilities: {
-      tools: {},
-      resources: {},
-      prompts: {},
-      logging: {}
-    }
-  });
-  logger.info("Setting up MCP server...");
-  createMcpServer(server, ops, resources, prompts, {
-    logger,
-    toolCtx: () => baseCtx,
-    promptCtx: () => ({ locale: "en" }),
-    resourceCtx: () => ({ locale: "en" }),
-    presentations: new PresentationRegistry(presentations)
-  });
-  const transport = new WebStandardStreamableHTTPServerTransport({
-    sessionIdGenerator: stateful ? () => randomUUID() : undefined,
-    enableJsonResponse: true
-  });
-  return server.connect(transport).then(() => ({ server, transport }));
-}
-async function closeSessionState(state) {
-  await Promise.allSettled([state.transport.close(), state.server.close()]);
-}
-function toErrorMessage(error) {
-  return error instanceof Error ? error.stack ?? error.message : String(error);
-}
-function createMcpElysiaHandler({
-  logger,
-  path,
-  serverName,
-  ops,
-  resources,
-  prompts,
-  presentations,
-  validateAuth,
-  requiredAuthMethods
-}) {
-  logger.info("Setting up MCP handler...", {
-    requiredAuthMethods: requiredAuthMethods ?? []
-  });
-  const isStateful = process.env.CONTRACTSPEC_MCP_STATEFUL === "1";
-  const sessions = new Map;
-  async function handleStateless(request) {
-    const state = await createSessionState({
-      logger,
-      path,
-      serverName,
-      ops,
-      resources,
-      prompts,
-      presentations,
-      stateful: false
-    });
-    try {
-      return await state.transport.handleRequest(normalizeMcpRequest(request));
-    } finally {
-      await closeSessionState(state);
-    }
-  }
-  async function closeSession(sessionId) {
-    const state = sessions.get(sessionId);
-    if (!state)
-      return;
-    sessions.delete(sessionId);
-    await closeSessionState(state);
-  }
-  async function handleStateful(request) {
-    const requestedSessionId = request.headers.get("mcp-session-id");
-    let state;
-    let createdState = false;
-    if (requestedSessionId) {
-      const existing = sessions.get(requestedSessionId);
-      if (!existing) {
-        return createJsonRpcErrorResponse(404, -32001, "Session not found");
-      }
-      state = existing;
-    } else {
-      state = await createSessionState({
-        logger,
-        path,
-        serverName,
-        ops,
-        resources,
-        prompts,
-        presentations,
-        stateful: true
-      });
-      createdState = true;
-    }
-    try {
-      const response = await state.transport.handleRequest(normalizeMcpRequest(request));
-      const activeSessionId = state.transport.sessionId;
-      if (activeSessionId && !sessions.has(activeSessionId)) {
-        sessions.set(activeSessionId, state);
-      }
-      if (request.method === "DELETE" && activeSessionId) {
-        await closeSession(activeSessionId);
-      } else if (!activeSessionId && createdState) {
-        await closeSessionState(state);
-      }
-      return response;
-    } catch (error) {
-      if (createdState) {
-        await closeSessionState(state);
-      }
-      throw error;
-    }
-  }
-  return new Elysia({ name: `mcp-${serverName}` }).all(path, async ({ request }) => {
-    try {
-      if (validateAuth) {
-        const authResult = await validateAuth(request);
-        if (!authResult.valid) {
-          return createJsonRpcErrorResponse(401, -32002, "Authentication failed", authResult.reason);
-        }
-      }
-      if (isStateful) {
-        return await handleStateful(request);
-      }
-      return await handleStateless(request);
-    } catch (error) {
-      logger.error("Error handling MCP request", {
-        path,
-        method: request.method,
-        error: toErrorMessage(error)
-      });
-      return createJsonRpcErrorResponse(500, -32000, "Internal error");
-    }
-  });
-}
-
-// src/application/mcp/cliMcp.ts
-import fs from "node:fs/promises";
-import {
-  defineCommand,
-  definePrompt,
-  defineResourceTemplate,
-  installOp,
-  OperationSpecRegistry,
-  PromptRegistry,
-  ResourceRegistry
-} from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-import path from "path";
-import z from "zod";
-var __dirname = "/home/runner/work/contractspec/contractspec/packages/bundles/library/src/application/mcp";
-var CLI_DOC_PATHS = {
-  quickstart: "packages/apps/cli-contractspec/QUICK_START.md",
-  reference: "packages/apps/cli-contractspec/QUICK_REFERENCE.md",
-  readme: "packages/apps/cli-contractspec/README.md"
-};
-var CLI_DOC_FALLBACK = {
-  quickstart: `# ContractSpec CLI quickstart
+import{EmbeddingService as sj,VectorIndexer as rj}from"@contractspec/lib.knowledge/ingestion";import{ContextSnapshotPipeline as ej,PostgresContextStorage as jY}from"@contractspec/module.context-storage";function xJ(j){let Y=new jY({database:j.database,schema:j.schema,createTablesIfMissing:j.createTablesIfMissing}),J=j.embeddingProvider?new sj(j.embeddingProvider,j.embeddingBatchSize):void 0,Q=j.vectorStoreProvider&&j.vectorIndex?new rj(j.vectorStoreProvider,j.vectorIndex):void 0,$=new ej({store:Y,documentProcessor:j.documentProcessor,embeddingService:J,vectorIndexer:Q});return{store:Y,pipeline:$}}import{Logger as Wj,LogLevel as xj}from"@contractspec/lib.logger";function Pj(){return"production"}var YY=()=>new Wj({level:xj.INFO,environment:Pj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),M=YY(),LJ=new Wj({level:xj.WARN,environment:Pj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1}),GJ=new Wj({level:xj.INFO,environment:Pj(),enableTracing:!0,enableTiming:!0,enableContext:!0,enableColors:!1});var Ij=["application/json","text/event-stream"];function JY(j){return!j||j.includes("*/*")||j.includes("application/*")||Ij.some((Y)=>j.includes(Y))}function qj(j){if(j.method!=="POST")return j;let Y=j.headers.get("accept");if(!JY(Y))return j;let J=Ij.filter(($)=>!Y?.includes($));if(J.length===0)return j;let Q=new Headers(j.headers);return Q.set("accept",[Y,...J].filter(Boolean).join(", ")),new Request(j,{headers:Q})}import{createMcpServer as QY}from"@contractspec/lib.contracts-runtime-server-mcp/provider-mcp";import{PresentationRegistry as ZY}from"@contractspec/lib.contracts-spec/presentations";import{McpServer as $Y}from"@modelcontextprotocol/sdk/server/mcp.js";import{WebStandardStreamableHTTPServerTransport as XY}from"@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";import{randomUUID as UY}from"crypto";import{Elysia as VY}from"elysia";var HY={actor:"anonymous",decide:async()=>({effect:"allow"})};function Lj(j,Y,J,Q){return new Response(JSON.stringify({jsonrpc:"2.0",error:{code:Y,message:J,...Q?{data:Q}:{}},id:null}),{status:j,headers:{"content-type":"application/json"}})}function Ej({logger:j,serverName:Y,ops:J,resources:Q,prompts:$,presentations:Z,stateful:X}){let U=new $Y({name:Y,version:"1.0.0"},{capabilities:{tools:{},resources:{},prompts:{},logging:{}}});j.info("Setting up MCP server..."),QY(U,J,Q,$,{logger:j,toolCtx:()=>HY,promptCtx:()=>({locale:"en"}),resourceCtx:()=>({locale:"en"}),presentations:new ZY(Z)});let K=new XY({sessionIdGenerator:X?()=>UY():void 0,enableJsonResponse:!0});return U.connect(K).then(()=>({server:U,transport:K}))}async function t(j){await Promise.allSettled([j.transport.close(),j.server.close()])}function KY(j){return j instanceof Error?j.stack??j.message:String(j)}function b({logger:j,path:Y,serverName:J,ops:Q,resources:$,prompts:Z,presentations:X,validateAuth:U,requiredAuthMethods:K}){j.info("Setting up MCP handler...",{requiredAuthMethods:K??[]});let P=process.env.CONTRACTSPEC_MCP_STATEFUL==="1",V=new Map;async function H(F){let W=await Ej({logger:j,path:Y,serverName:J,ops:Q,resources:$,prompts:Z,presentations:X,stateful:!1});try{return await W.transport.handleRequest(qj(F))}finally{await t(W)}}async function G(F){let W=V.get(F);if(!W)return;V.delete(F),await t(W)}async function Fj(F){let W=F.headers.get("mcp-session-id"),D,u=!1;if(W){let N=V.get(W);if(!N)return Lj(404,-32001,"Session not found");D=N}else D=await Ej({logger:j,path:Y,serverName:J,ops:Q,resources:$,prompts:Z,presentations:X,stateful:!0}),u=!0;try{let N=await D.transport.handleRequest(qj(F)),O=D.transport.sessionId;if(O&&!V.has(O))V.set(O,D);if(F.method==="DELETE"&&O)await G(O);else if(!O&&u)await t(D);return N}catch(N){if(u)await t(D);throw N}}return new VY({name:`mcp-${J}`}).all(Y,async({request:F})=>{try{if(U){let W=await U(F);if(!W.valid)return Lj(401,-32002,"Authentication failed",W.reason)}if(P)return await Fj(F);return await H(F)}catch(W){return j.error("Error handling MCP request",{path:Y,method:F.method,error:KY(W)}),Lj(500,-32000,"Internal error")}})}import BY from"node:fs/promises";import{defineCommand as wY,definePrompt as FY,defineResourceTemplate as zj,installOp as WY,OperationSpecRegistry as xY,PromptRegistry as PY,ResourceRegistry as qY}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as Oj,ScalarTypeEnum as d}from"@contractspec/lib.schema";import l from"path";import k from"zod";var __dirname="/home/runner/work/contractspec/contractspec/packages/bundles/library/src/application/mcp",LY={quickstart:"packages/apps/cli-contractspec/QUICK_START.md",reference:"packages/apps/cli-contractspec/QUICK_REFERENCE.md",readme:"packages/apps/cli-contractspec/README.md"},GY={quickstart:`# ContractSpec CLI quickstart
 
 contractspec create
 contractspec build <spec>
-contractspec validate <spec>`,
-  reference: `# ContractSpec CLI reference
-
-Key commands: create, build, validate. See README for full options.`,
-  readme: `# ContractSpec CLI
-
-Stabilize AI-generated code across API, DB, UI, events. Use create/build/validate commands.`
-};
-var CLI_DOC_TAGS = ["cli", "mcp"];
-var CLI_OWNERS = ["@contractspec"];
-var candidateRoots = (() => {
-  const roots = new Set([
-    process.cwd(),
-    path.resolve(process.cwd(), ".."),
-    path.resolve(process.cwd(), "../.."),
-    path.resolve(process.cwd(), "../../..")
-  ]);
-  if (typeof __dirname === "string") {
-    roots.add(path.resolve(__dirname, "../../../../.."));
-  }
-  return [...roots];
-})();
-var docCache = new Map;
-async function loadCliDoc(key) {
-  if (docCache.has(key)) {
-    return docCache.get(key);
-  }
-  const relative = CLI_DOC_PATHS[key];
-  for (const root of candidateRoots) {
-    const candidate = path.resolve(root, relative);
-    try {
-      const data = await fs.readFile(candidate, "utf8");
-      docCache.set(key, data);
-      return data;
-    } catch {}
-  }
-  const fallback = CLI_DOC_FALLBACK[key];
-  docCache.set(key, fallback);
-  return fallback;
-}
-function buildCliResources() {
-  const resources = new ResourceRegistry;
-  resources.register(defineResourceTemplate({
-    meta: {
-      uriTemplate: "cli://doc/{slug}",
-      title: "CLI documentation",
-      description: "Quickstart, reference, and README for the CLI.",
-      mimeType: "text/markdown",
-      tags: CLI_DOC_TAGS
-    },
-    input: z.object({
-      slug: z.enum(["quickstart", "reference", "readme"])
-    }),
-    resolve: async ({ slug }) => {
-      const data = await loadCliDoc(slug);
-      return {
-        uri: `cli://doc/${slug}`,
-        mimeType: "text/markdown",
-        data
-      };
-    }
-  }));
-  resources.register(defineResourceTemplate({
-    meta: {
-      uriTemplate: "cli://commands",
-      title: "CLI commands summary",
-      description: "Key ContractSpec CLI commands and when to use them.",
-      mimeType: "application/json",
-      tags: CLI_DOC_TAGS
-    },
-    input: z.object({}),
-    resolve: async () => {
-      const commands = [
-        {
-          command: "contractspec create",
-          summary: "Interactive wizard to author specs (with optional AI).",
-          doc: "cli://doc/quickstart"
-        },
-        {
-          command: "contractspec build <specPath>",
-          summary: "Generate implementation code from a ContractSpec (agents + templates).",
-          doc: "cli://doc/reference"
-        },
-        {
-          command: "contractspec validate <specPath>",
-          summary: "Validate specs and optionally check implementations against them.",
-          doc: "cli://doc/reference"
-        }
-      ];
-      return {
-        uri: "cli://commands",
-        mimeType: "application/json",
-        data: JSON.stringify(commands, null, 2)
-      };
-    }
-  }));
-  return resources;
-}
-function buildCliPrompts() {
-  const prompts = new PromptRegistry;
-  prompts.register(definePrompt({
-    meta: {
-      key: "cli.usage",
-      version: "1.0.0",
-      title: "Use ContractSpec CLI safely",
-      description: "Remind agents to read CLI docs and pick commands from the canonical list.",
-      tags: CLI_DOC_TAGS,
-      stability: "beta",
-      owners: CLI_OWNERS
-    },
-    args: [
-      {
-        name: "goal",
-        description: "Task the user wants to achieve.",
-        required: false,
-        schema: z.string().optional()
-      }
-    ],
-    input: z.object({ goal: z.string().optional() }),
-    render: async ({ goal }) => [
-      {
-        type: "text",
-        text: `Use CLI commands only from cli://commands. Prefer quickstart for newcomers and reference for options.${goal ? ` Goal: ${goal}.` : ""}`
-      },
-      { type: "resource", uri: "cli://commands", title: "Commands" },
-      {
-        type: "resource",
-        uri: "cli://doc/quickstart",
-        title: "Quickstart"
-      }
-    ]
-  }));
-  return prompts;
-}
-function buildCliOps() {
-  const registry = new OperationSpecRegistry;
-  const CliSuggestInput = defineSchemaModel({
-    name: "CliSuggestInput",
-    fields: {
-      goal: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-      prefersAi: { type: ScalarTypeEnum.Boolean(), isOptional: true }
-    }
-  });
-  const CliSuggestOutput = defineSchemaModel({
-    name: "CliSuggestOutput",
-    fields: {
-      command: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-      docUri: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-      reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }
-    }
-  });
-  const suggestSpec = defineCommand({
-    meta: {
-      key: "cli_suggestCommand",
-      version: "1.0.0",
-      stability: "stable",
-      owners: CLI_OWNERS,
-      tags: CLI_DOC_TAGS,
-      description: "Recommend a CLI command for the requested goal.",
-      goal: "Help AI agents choose the correct CLI entrypoint quickly.",
-      context: "Used inside the CLI MCP server."
-    },
-    io: {
-      input: CliSuggestInput,
-      output: CliSuggestOutput
-    },
-    policy: {
-      auth: "anonymous"
-    }
-  });
-  installOp(registry, suggestSpec, async ({ goal, prefersAi }) => {
-    const lower = goal.toLowerCase();
-    if (lower.includes("create") || lower.includes("new")) {
-      return {
-        command: prefersAi ? "contractspec create --ai" : "contractspec create",
-        docUri: "cli://doc/quickstart",
-        reason: "Creates a new ContractSpec interactively (optionally with AI)."
-      };
-    }
-    if (lower.includes("build") || lower.includes("generate")) {
-      return {
-        command: "contractspec build <path-to-spec>",
-        docUri: "cli://doc/reference",
-        reason: "Builds implementation code from a spec using agents + templates."
-      };
-    }
-    if (lower.includes("validate") || lower.includes("check")) {
-      return {
-        command: "contractspec validate <path-to-spec>",
-        docUri: "cli://doc/reference",
-        reason: "Validates a spec and optionally checks its implementation for drift."
-      };
-    }
-    return {
-      command: "contractspec --help",
-      docUri: "cli://doc/readme",
-      reason: "Fallback when the goal is unclear; read README for options."
-    };
-  });
-  return registry;
-}
-function createCliMcpHandler(path2 = "/api/mcp/cli") {
-  return createMcpElysiaHandler({
-    logger: appLogger,
-    path: path2,
-    serverName: "contractspec-cli-mcp",
-    ops: buildCliOps(),
-    resources: buildCliResources(),
-    prompts: buildCliPrompts()
-  });
-}
-
-// src/application/mcp/contractsMcpResources.ts
-import {
-  definePrompt as definePrompt2,
-  defineResourceTemplate as defineResourceTemplate2,
-  PromptRegistry as PromptRegistry2,
-  ResourceRegistry as ResourceRegistry2
-} from "@contractspec/lib.contracts-spec";
-import z2 from "zod";
-var OWNERS = ["@contractspec"];
-var TAGS = ["contracts", "mcp"];
-function buildContractsResources(services) {
-  const resources = new ResourceRegistry2;
-  resources.register(defineResourceTemplate2({
-    meta: {
-      uriTemplate: "contracts://list",
-      title: "Contract specs list",
-      description: "JSON list of all contract specs in the workspace.",
-      mimeType: "application/json",
-      tags: TAGS
-    },
-    input: z2.object({}),
-    resolve: async () => {
-      const specs = await services.listSpecs();
-      return {
-        uri: "contracts://list",
-        mimeType: "application/json",
-        data: JSON.stringify(specs, null, 2)
-      };
-    }
-  }));
-  resources.register(defineResourceTemplate2({
-    meta: {
-      uriTemplate: "contracts://spec/{path}",
-      title: "Contract spec content",
-      description: "Read a single contract spec file by path.",
-      mimeType: "text/plain",
-      tags: TAGS
-    },
-    input: z2.object({ path: z2.string() }),
-    resolve: async ({ path: path2 }) => {
-      const result = await services.getSpec(path2);
-      if (!result) {
-        return {
-          uri: `contracts://spec/${encodeURIComponent(path2)}`,
-          mimeType: "text/plain",
-          data: `Spec not found: ${path2}`
-        };
-      }
-      return {
-        uri: `contracts://spec/${encodeURIComponent(path2)}`,
-        mimeType: "text/plain",
-        data: result.content
-      };
-    }
-  }));
-  resources.register(defineResourceTemplate2({
-    meta: {
-      uriTemplate: "contracts://registry/manifest",
-      title: "Remote registry manifest",
-      description: "Contract registry manifest from the remote server.",
-      mimeType: "application/json",
-      tags: TAGS
-    },
-    input: z2.object({}),
-    resolve: async () => {
-      const manifest = await services.fetchRegistryManifest();
-      return {
-        uri: "contracts://registry/manifest",
-        mimeType: "application/json",
-        data: JSON.stringify(manifest, null, 2)
-      };
-    }
-  }));
-  return resources;
-}
-function buildContractsPrompts() {
-  const prompts = new PromptRegistry2;
-  prompts.register(definePrompt2({
-    meta: {
-      key: "contracts.editor",
-      version: "1.0.0",
-      title: "Contract editing guide",
-      description: "Guide AI agents through reading, editing, and validating contracts.",
-      tags: TAGS,
-      stability: "beta",
-      owners: OWNERS
-    },
-    args: [
-      {
-        name: "goal",
-        description: "What the agent wants to achieve with the contract.",
-        required: false,
-        schema: z2.string().optional()
-      }
-    ],
-    input: z2.object({ goal: z2.string().optional() }),
-    render: async ({ goal }) => [
-      {
-        type: "text",
-        text: [
-          "Contract editing workflow:",
-          "1. Use contracts.list to discover specs",
-          "2. Use contracts.get to read a spec",
-          "3. Edit content and call contracts.update",
-          "4. Run contracts.validate to verify changes",
-          "5. Run contracts.build to regenerate artifacts",
-          goal ? `Agent goal: ${goal}` : ""
-        ].filter(Boolean).join(`
-`)
-      },
-      {
-        type: "resource",
-        uri: "contracts://list",
-        title: "Available contracts"
-      }
-    ]
-  }));
-  return prompts;
-}
-
-// src/application/mcp/contractsMcpTools.ts
-import {
-  defineCommand as defineCommand2,
-  installOp as installOp2,
-  OperationSpecRegistry as OperationSpecRegistry2
-} from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
-var OWNERS2 = ["@contractspec"];
-var TAGS2 = ["contracts", "mcp"];
-function buildContractsOps(services) {
-  const registry = new OperationSpecRegistry2;
-  const ListInput = defineSchemaModel2({
-    name: "ContractsListInput",
-    fields: {
-      pattern: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-      type: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true }
-    }
-  });
-  const ListOutput = defineSchemaModel2({
-    name: "ContractsListOutput",
-    fields: {
-      specs: { type: ScalarTypeEnum2.JSON(), isOptional: false },
-      total: { type: ScalarTypeEnum2.Int_unsecure(), isOptional: false }
-    }
-  });
-  installOp2(registry, defineCommand2({
-    meta: {
-      key: "contracts.list",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS2,
-      tags: TAGS2,
-      description: "List contract specs in the workspace.",
-      goal: "Discover available contracts by type, pattern, or owner.",
-      context: "Contracts MCP server."
-    },
-    io: { input: ListInput, output: ListOutput },
-    policy: { auth: "anonymous" }
-  }), async ({ pattern, type }) => {
-    const specs = await services.listSpecs({ pattern, type });
-    return { specs, total: specs.length };
-  });
-  const GetInput = defineSchemaModel2({
-    name: "ContractsGetInput",
-    fields: {
-      path: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-    }
-  });
-  const GetOutput = defineSchemaModel2({
-    name: "ContractsGetOutput",
-    fields: {
-      content: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-      info: { type: ScalarTypeEnum2.JSON(), isOptional: false }
-    }
-  });
-  installOp2(registry, defineCommand2({
-    meta: {
-      key: "contracts.get",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS2,
-      tags: TAGS2,
-      description: "Read a single contract spec file.",
-      goal: "Fetch spec content and parsed metadata.",
-      context: "Contracts MCP server."
-    },
-    io: { input: GetInput, output: GetOutput },
-    policy: { auth: "anonymous" }
-  }), async ({ path: path2 }) => {
-    const result = await services.getSpec(path2);
-    if (!result)
-      throw new Error(`Spec not found: ${path2}`);
-    return result;
-  });
-  const ValidateInput = defineSchemaModel2({
-    name: "ContractsValidateInput",
-    fields: {
-      path: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false }
-    }
-  });
-  const ValidateOutput = defineSchemaModel2({
-    name: "ContractsValidateOutput",
-    fields: {
-      valid: { type: ScalarTypeEnum2.Boolean(), isOptional: false },
-      errors: { type: ScalarTypeEnum2.JSON(), isOptional: false },
-      warnings: { type: ScalarTypeEnum2.JSON(), isOptional: false }
-    }
-  });
-  installOp2(registry, defineCommand2({
-    meta: {
-      key: "contracts.validate",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS2,
-      tags: TAGS2,
-      description: "Validate a contract spec structure.",
-      goal: "Check spec for structural or policy issues.",
-      context: "Contracts MCP server."
-    },
-    io: { input: ValidateInput, output: ValidateOutput },
-    policy: { auth: "anonymous" }
-  }), async ({ path: path2 }) => services.validateSpec(path2));
-  const BuildInput = defineSchemaModel2({
-    name: "ContractsBuildInput",
-    fields: {
-      path: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-      dryRun: { type: ScalarTypeEnum2.Boolean(), isOptional: true }
-    }
-  });
-  const BuildOutput = defineSchemaModel2({
-    name: "ContractsBuildOutput",
-    fields: {
-      results: { type: ScalarTypeEnum2.JSON(), isOptional: false }
-    }
-  });
-  installOp2(registry, defineCommand2({
-    meta: {
-      key: "contracts.build",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS2,
-      tags: TAGS2,
-      description: "Generate implementation code from a contract spec.",
-      goal: "Produce handler, component, or test skeletons.",
-      context: "Contracts MCP server."
-    },
-    io: { input: BuildInput, output: BuildOutput },
-    policy: { auth: "user" }
-  }), async ({ path: path2, dryRun }) => services.buildSpec(path2, { dryRun }));
-  registerMutationTools(registry, services);
-  return registry;
-}
-function registerMutationTools(registry, services) {
-  const UpdateInput = defineSchemaModel2({
-    name: "ContractsUpdateInput",
-    fields: {
-      path: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-      content: { type: ScalarTypeEnum2.String_unsecure(), isOptional: true },
-      fields: { type: ScalarTypeEnum2.JSON(), isOptional: true }
-    }
-  });
-  const UpdateOutput = defineSchemaModel2({
-    name: "ContractsUpdateOutput",
-    fields: {
-      updated: { type: ScalarTypeEnum2.Boolean(), isOptional: false },
-      errors: { type: ScalarTypeEnum2.JSON(), isOptional: false },
-      warnings: { type: ScalarTypeEnum2.JSON(), isOptional: false }
-    }
-  });
-  installOp2(registry, defineCommand2({
-    meta: {
-      key: "contracts.update",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS2,
-      tags: TAGS2,
-      description: "Update an existing contract spec.",
-      goal: "Modify spec content or individual fields with validation.",
-      context: "Contracts MCP server."
-    },
-    io: { input: UpdateInput, output: UpdateOutput },
-    policy: { auth: "user" }
-  }), async ({ path: path2, content, fields }) => services.updateSpec(path2, {
-    content,
-    fields: Array.isArray(fields) ? fields : undefined
-  }));
-  const DeleteInput = defineSchemaModel2({
-    name: "ContractsDeleteInput",
-    fields: {
-      path: { type: ScalarTypeEnum2.String_unsecure(), isOptional: false },
-      clean: { type: ScalarTypeEnum2.Boolean(), isOptional: true }
-    }
-  });
-  const DeleteOutput = defineSchemaModel2({
-    name: "ContractsDeleteOutput",
-    fields: {
-      deleted: { type: ScalarTypeEnum2.Boolean(), isOptional: false },
-      cleanedFiles: { type: ScalarTypeEnum2.JSON(), isOptional: false },
-      errors: { type: ScalarTypeEnum2.JSON(), isOptional: false }
-    }
-  });
-  installOp2(registry, defineCommand2({
-    meta: {
-      key: "contracts.delete",
-      version: "1.0.0",
-      stability: "beta",
-      owners: OWNERS2,
-      tags: TAGS2,
-      description: "Delete a contract spec and optionally its artifacts.",
-      goal: "Remove a spec file and clean generated handlers/tests.",
-      context: "Contracts MCP server."
-    },
-    io: { input: DeleteInput, output: DeleteOutput },
-    policy: { auth: "user" }
-  }), async ({ path: path2, clean }) => services.deleteSpec(path2, { clean }));
-}
-
-// src/application/mcp/contractsMcp.ts
-function createContractsMcpHandler(path2 = "/api/mcp/contracts", services) {
-  return createMcpElysiaHandler({
-    logger: appLogger,
-    path: path2,
-    serverName: "contractspec-contracts-mcp",
-    ops: buildContractsOps(services),
-    resources: buildContractsResources(services),
-    prompts: buildContractsPrompts()
-  });
-}
-
-// src/application/mcp/docsMcp.data.ts
-import { defaultDocRegistry } from "@contractspec/lib.contracts-spec/docs";
-var DEFAULT_LIMIT = 20;
-var MAX_LIMIT = 100;
-function normalizeText(value) {
-  return value?.trim().toLowerCase() ?? "";
-}
-function normalizeRoute(route) {
-  const decoded = decodeURIComponent(route).trim();
-  if (!decoded)
-    return "/";
-  return decoded.startsWith("/") ? decoded : `/${decoded}`;
-}
-function normalizeTags(value) {
-  const tags = Array.isArray(value) ? value : value ? [value] : [];
-  return tags.map((tag) => normalizeText(tag)).filter(Boolean);
-}
-function clampLimit(limit) {
-  if (!limit || Number.isNaN(limit))
-    return DEFAULT_LIMIT;
-  return Math.min(Math.max(limit, 1), MAX_LIMIT);
-}
-function clampOffset(offset) {
-  if (!offset || Number.isNaN(offset))
-    return 0;
-  return Math.max(offset, 0);
-}
-function toDocSummary({ block, route }) {
-  return {
-    id: block.id,
-    title: block.title,
-    summary: block.summary ?? "",
-    route,
-    visibility: block.visibility ?? "public",
-    kind: block.kind ?? "reference",
-    version: block.version ?? "1.0.0",
-    tags: block.tags ?? []
-  };
-}
-function scoreDoc(route, query) {
-  if (!query)
-    return 1;
-  const tokens = query.split(/\s+/).filter(Boolean);
-  const title = normalizeText(route.block.title);
-  const id = normalizeText(route.block.id);
-  const summary = normalizeText(route.block.summary);
-  const body = normalizeText(route.block.body);
-  const path2 = normalizeText(route.route);
-  const tags = (route.block.tags ?? []).map((tag) => normalizeText(tag));
-  const haystack = [title, id, summary, body, path2, ...tags].join(" ");
-  if (tokens.some((token) => !haystack.includes(token)))
-    return 0;
-  let score = 0;
-  for (const token of tokens) {
-    if (id.includes(token))
-      score += 8;
-    if (title.includes(token))
-      score += 7;
-    if (tags.some((tag) => tag.includes(token)))
-      score += 5;
-    if (summary.includes(token))
-      score += 4;
-    if (path2.includes(token))
-      score += 3;
-    if (body.includes(token))
-      score += 2;
-  }
-  return score;
-}
-function searchDocs(routes, args) {
-  const query = normalizeText(typeof args.query === "string" ? args.query : undefined);
-  const tags = normalizeTags(args.tag);
-  const visibility = normalizeText(typeof args.visibility === "string" ? args.visibility : undefined);
-  const kind = normalizeText(typeof args.kind === "string" ? args.kind : undefined);
-  const limit = clampLimit(typeof args.limit === "number" ? args.limit : undefined);
-  const offset = clampOffset(typeof args.offset === "number" ? args.offset : undefined);
-  const ranked = routes.map((route) => ({
-    doc: toDocSummary(route),
-    score: scoreDoc(route, query)
-  })).filter(({ doc, score }) => {
-    const matchesQuery = query ? score > 0 : true;
-    const matchesTags = tags.length ? tags.every((tag) => doc.tags.some((docTag) => normalizeText(docTag).includes(tag))) : true;
-    const matchesVisibility = visibility ? normalizeText(doc.visibility) === visibility : true;
-    const matchesKind = kind ? normalizeText(doc.kind) === kind : true;
-    return matchesQuery && matchesTags && matchesVisibility && matchesKind;
-  }).sort((left, right) => {
-    if (right.score !== left.score)
-      return right.score - left.score;
-    return left.doc.title.localeCompare(right.doc.title);
-  });
-  const docs = ranked.slice(offset, offset + limit).map(({ doc }) => doc);
-  const nextOffset = offset + docs.length < ranked.length ? offset + docs.length : undefined;
-  return {
-    docs,
-    items: docs,
-    total: ranked.length,
-    ...nextOffset != null ? { nextOffset } : {}
-  };
-}
-function getDocById(id) {
-  const normalizedId = decodeURIComponent(id);
-  const found = defaultDocRegistry.get(normalizedId);
-  if (!found)
-    return;
-  return {
-    doc: toDocSummary(found),
-    content: String(found.block.body ?? "")
-  };
-}
-function getDocByRoute(routes, routePath) {
-  const normalizedPath = normalizeRoute(routePath);
-  const found = routes.find((route) => normalizeRoute(route.route) === normalizedPath);
-  if (!found)
-    return;
-  return {
-    doc: toDocSummary(found),
-    content: String(found.block.body ?? "")
-  };
-}
-function listDocFacets(routes) {
-  const tags = new Map;
-  const kinds = new Map;
-  const visibilities = new Map;
-  for (const route of routes) {
-    const kind = route.block.kind ?? "reference";
-    const visibility = route.block.visibility ?? "public";
-    kinds.set(kind, (kinds.get(kind) ?? 0) + 1);
-    visibilities.set(visibility, (visibilities.get(visibility) ?? 0) + 1);
-    for (const tag of route.block.tags ?? []) {
-      tags.set(tag, (tags.get(tag) ?? 0) + 1);
-    }
-  }
-  const toEntries = (values, key) => [...values.entries()].sort((left, right) => right[1] - left[1] || left[0].localeCompare(right[0])).map(([value, count]) => ({ [key]: value, count }));
-  return {
-    totalDocs: routes.length,
-    tags: toEntries(tags, "tag"),
-    kinds: toEntries(kinds, "kind"),
-    visibilities: toEntries(visibilities, "visibility")
-  };
-}
-
-// src/features/contracts-registry.ts
-import {
-  EventRegistry,
-  OperationSpecRegistry as OperationSpecRegistry3
-} from "@contractspec/lib.contracts-spec";
-import {
-  DataViewRegistry
-} from "@contractspec/lib.contracts-spec/data-views";
-import {
-  ContractReferenceDataView,
-  ContractReferenceQuery,
-  DocsGenerateCommand,
-  DocsGeneratedEvent,
-  DocsIndexDataView,
-  DocsIndexQuery,
-  DocsLayoutPresentation,
-  DocsPublishCommand,
-  DocsPublishedEvent,
-  DocsReferencePagePresentation,
-  DocsSearchForm,
-  ExampleCatalogDataView
-} from "@contractspec/lib.contracts-spec/docs";
-import { FormRegistry } from "@contractspec/lib.contracts-spec/forms";
-import {
-  PresentationRegistry as PresentationRegistry2
-} from "@contractspec/lib.contracts-spec/presentations";
-import {
-  serializeDataViewSpec,
-  serializeEventSpec,
-  serializeFormSpec,
-  serializeOperationSpec,
-  serializePresentationSpec
-} from "@contractspec/lib.contracts-spec/serialization";
-var operationRegistry = null;
-function createContractSpecOperationRegistry() {
-  const registry = new OperationSpecRegistry3;
-  registry.register(DocsIndexQuery).register(ContractReferenceQuery).register(DocsGenerateCommand).register(DocsPublishCommand);
-  return registry;
-}
-function getContractSpecOperationRegistry() {
-  if (!operationRegistry) {
-    operationRegistry = createContractSpecOperationRegistry();
-  }
-  return operationRegistry;
-}
-function resolveOperationSpec(key, version) {
-  return getContractSpecOperationRegistry().get(key, version);
-}
-var eventRegistry = null;
-function createContractSpecEventRegistry() {
-  const registry = new EventRegistry;
-  registry.register(DocsGeneratedEvent).register(DocsPublishedEvent);
-  return registry;
-}
-function getContractSpecEventRegistry() {
-  if (!eventRegistry) {
-    eventRegistry = createContractSpecEventRegistry();
-  }
-  return eventRegistry;
-}
-function resolveEventSpec(key, version) {
-  return getContractSpecEventRegistry().get(key, version);
-}
-var presentationRegistry = null;
-function createContractSpecPresentationRegistry() {
-  const registry = new PresentationRegistry2;
-  registry.register(DocsLayoutPresentation).register(DocsReferencePagePresentation);
-  return registry;
-}
-function getContractSpecPresentationRegistry() {
-  if (!presentationRegistry) {
-    presentationRegistry = createContractSpecPresentationRegistry();
-  }
-  return presentationRegistry;
-}
-function resolvePresentationSpec(key, version) {
-  return getContractSpecPresentationRegistry().get(key, version);
-}
-var dataViewRegistry = null;
-function createContractSpecDataViewRegistry() {
-  const registry = new DataViewRegistry;
-  registry.register(DocsIndexDataView).register(ContractReferenceDataView).register(ExampleCatalogDataView);
-  return registry;
-}
-function getContractSpecDataViewRegistry() {
-  if (!dataViewRegistry) {
-    dataViewRegistry = createContractSpecDataViewRegistry();
-  }
-  return dataViewRegistry;
-}
-function resolveDataViewSpec(key, version) {
-  return getContractSpecDataViewRegistry().get(key, version);
-}
-var formRegistry = null;
-function createContractSpecFormRegistry() {
-  const registry = new FormRegistry;
-  registry.register(DocsSearchForm);
-  return registry;
-}
-function getContractSpecFormRegistry() {
-  if (!formRegistry) {
-    formRegistry = createContractSpecFormRegistry();
-  }
-  return formRegistry;
-}
-function resolveFormSpec(key, _version) {
-  return getContractSpecFormRegistry().get(key);
-}
-function resolveSerializedOperationSpec(key, version) {
-  const spec = resolveOperationSpec(key, version);
-  return serializeOperationSpec(spec) ?? undefined;
-}
-function resolveSerializedEventSpec(key, version) {
-  const spec = resolveEventSpec(key, version);
-  return serializeEventSpec(spec) ?? undefined;
-}
-function resolveSerializedPresentationSpec(key, version) {
-  const spec = resolvePresentationSpec(key, version);
-  return serializePresentationSpec(spec) ?? undefined;
-}
-function resolveSerializedDataViewSpec(key, version) {
-  const spec = resolveDataViewSpec(key, version);
-  return serializeDataViewSpec(spec) ?? undefined;
-}
-function resolveSerializedFormSpec(key, version) {
-  const spec = resolveFormSpec(key, version);
-  return serializeFormSpec(spec) ?? undefined;
-}
-function resetContractSpecOperationRegistry() {
-  operationRegistry = null;
-}
-function resetContractSpecEventRegistry() {
-  eventRegistry = null;
-}
-function resetContractSpecPresentationRegistry() {
-  presentationRegistry = null;
-}
-function resetContractSpecDataViewRegistry() {
-  dataViewRegistry = null;
-}
-function resetContractSpecFormRegistry() {
-  formRegistry = null;
-}
-function resetAllContractSpecRegistries() {
-  resetContractSpecOperationRegistry();
-  resetContractSpecEventRegistry();
-  resetContractSpecPresentationRegistry();
-  resetContractSpecDataViewRegistry();
-  resetContractSpecFormRegistry();
-}
-
-// src/application/mcp/docsMcp.reference.ts
-import { defaultDocRegistry as defaultDocRegistry2 } from "@contractspec/lib.contracts-spec/docs";
-function normalizeText2(value) {
-  return value?.trim().toLowerCase() ?? "";
-}
-function routeFromDocIds(docIds) {
-  for (const docId of docIds ?? []) {
-    const doc = defaultDocRegistry2.get(docId);
-    if (doc)
-      return doc.route;
-  }
-  return;
-}
-function toReference(spec, type, schema, policy) {
-  const title = spec.meta.title ?? spec.meta.key;
-  const route = routeFromDocIds(spec.meta.docId);
-  const description = spec.meta.description;
-  return {
-    key: spec.meta.key,
-    version: spec.meta.version,
-    type,
-    title,
-    description,
-    markdown: [
-      `# ${title}`,
-      `- Key: ${spec.meta.key}`,
-      `- Type: ${type}`,
-      `- Version: ${spec.meta.version}`,
-      route ? `- Docs route: ${route}` : "",
-      description ? `
-${description}` : ""
-    ].filter(Boolean).join(`
-`),
-    ...route ? { route } : {},
-    ...schema ? { schema } : {},
-    ...policy ? { policy } : {},
-    tags: spec.meta.tags ?? [],
-    owners: spec.meta.owners ?? [],
-    stability: spec.meta.stability
-  };
-}
-function resolveContractReference(args) {
-  const includeSchema = args.includeSchema ?? false;
-  const requestedType = normalizeText2(args.type);
-  const operation = resolveOperationSpec(args.key, args.version);
-  if (operation && (!requestedType || requestedType === "operation" || requestedType === operation.meta.kind)) {
-    return {
-      reference: toReference(operation, operation.meta.kind, includeSchema ? resolveSerializedOperationSpec(args.key, args.version) : undefined, operation.policy)
-    };
-  }
-  const resolvers = [
-    {
-      type: "data-view",
-      spec: resolveDataViewSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedDataViewSpec(args.key, args.version) : undefined
-    },
-    {
-      type: "form",
-      spec: resolveFormSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedFormSpec(args.key, args.version) : undefined
-    },
-    {
-      type: "presentation",
-      spec: resolvePresentationSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedPresentationSpec(args.key, args.version) : undefined
-    },
-    {
-      type: "event",
-      spec: resolveEventSpec(args.key, args.version),
-      schema: includeSchema ? resolveSerializedEventSpec(args.key, args.version) : undefined
-    }
-  ];
-  for (const candidate of resolvers) {
-    if (candidate.spec && (!requestedType || requestedType === candidate.type)) {
-      return {
-        reference: toReference(candidate.spec, candidate.type, candidate.schema)
-      };
-    }
-  }
-  throw new Error(`Contract reference not found: ${args.key}`);
-}
-
-// src/application/mcp/docsMcp.prompts.ts
-import { definePrompt as definePrompt3, PromptRegistry as PromptRegistry3 } from "@contractspec/lib.contracts-spec";
-import z3 from "zod";
-var DOC_OWNERS = ["@contractspec"];
-var DOC_TAGS = ["docs", "mcp"];
-function buildDocPrompts(routes) {
-  const prompts = new PromptRegistry3;
-  prompts.register(definePrompt3({
-    meta: {
-      key: "docs.navigator",
-      version: "1.0.0",
-      title: "Find relevant ContractSpec docs",
-      description: "Guide agents to search, filter, and open the right ContractSpec docs.",
-      tags: DOC_TAGS,
-      stability: "beta",
-      owners: DOC_OWNERS
-    },
-    args: [
-      {
-        name: "topic",
-        description: "Goal or subject to search for.",
-        required: false,
-        schema: z3.string().optional()
-      },
-      {
-        name: "kind",
-        description: "Optional doc kind filter.",
-        required: false,
-        schema: z3.string().optional()
-      },
-      {
-        name: "tag",
-        description: "Optional tag filter.",
-        required: false,
-        schema: z3.string().optional()
-      }
-    ],
-    input: z3.object({
-      topic: z3.string().optional(),
-      kind: z3.string().optional(),
-      tag: z3.string().optional()
-    }),
-    render: async ({ topic, kind, tag }) => {
-      const matches = searchDocs(routes, {
-        query: topic,
-        kind,
-        tag,
-        limit: 3
-      });
-      const suggestedDocs = matches.docs.length ? matches.docs.map((doc) => `- ${doc.title} (${doc.id}) -> ${doc.route}`).join(`
-`) : "- No direct pre-match. Use docs_list_facets-v1_0_0 to browse tags and kinds.";
-      return [
-        {
-          type: "text",
-          text: [
-            "Use docs_search-v1_0_0 first, then read docs://doc/{id} for the strongest matches.",
-            "Use docs_resolve_route-v1_0_0 when the user already gives you a docs URL or route.",
-            "Use docs_list_facets-v1_0_0 or docs://facets to browse the docs taxonomy before guessing.",
-            topic ? `Topic: ${topic}` : "",
-            kind ? `Kind: ${kind}` : "",
-            tag ? `Tag: ${tag}` : "",
-            "Suggested starting docs:",
-            suggestedDocs
-          ].filter(Boolean).join(`
-`)
-        },
-        {
-          type: "resource",
-          uri: "docs://index",
-          title: "DocBlocks index"
-        },
-        {
-          type: "resource",
-          uri: "docs://facets",
-          title: "Docs facets"
-        }
-      ];
-    }
-  }));
-  prompts.register(definePrompt3({
-    meta: {
-      key: "docs.reference.guide",
-      version: "1.0.0",
-      title: "Resolve a ContractSpec reference",
-      description: "Guide agents to fetch the canonical reference payload for a ContractSpec surface.",
-      tags: DOC_TAGS,
-      stability: "beta",
-      owners: DOC_OWNERS
-    },
-    args: [
-      {
-        name: "key",
-        description: "ContractSpec key to resolve.",
-        required: true,
-        schema: z3.string()
-      },
-      {
-        name: "version",
-        description: "Optional version override.",
-        required: false,
-        schema: z3.string().optional()
-      },
-      {
-        name: "type",
-        description: "Optional surface type: command, query, form, data-view, presentation, event.",
-        required: false,
-        schema: z3.string().optional()
-      }
-    ],
-    input: z3.object({
-      key: z3.string(),
-      version: z3.string().optional(),
-      type: z3.string().optional()
-    }),
-    render: async ({ key, version, type }) => {
-      const reference = resolveContractReference({
-        key,
-        version,
-        type,
-        includeSchema: true
-      }).reference;
-      return [
-        {
-          type: "text",
-          text: [
-            "Use docs_contract_reference-v1_0_0 when you need the canonical docs payload for a ContractSpec surface.",
-            "Use docs_get-v1_0_0 only when you already know the exact DocBlock id and need raw markdown.",
-            `Resolved key: ${reference.key}`,
-            `Resolved type: ${reference.type}`,
-            reference.route ? `Docs route: ${reference.route}` : "",
-            `Resource URI: docs://contract-reference/${encodeURIComponent(key)}`
-          ].filter(Boolean).join(`
-`)
-        },
-        {
-          type: "resource",
-          uri: `docs://contract-reference/${encodeURIComponent(key)}`,
-          title: "Contract reference"
-        }
-      ];
-    }
-  }));
-  return prompts;
-}
-
-// src/application/mcp/docsMcp.resources.ts
-import {
-  defineResourceTemplate as defineResourceTemplate3,
-  ResourceRegistry as ResourceRegistry3
-} from "@contractspec/lib.contracts-spec";
-import z4 from "zod";
-var DOC_TAGS2 = ["docs", "mcp"];
-function buildDocResources(routes) {
-  const resources = new ResourceRegistry3;
-  const readDocIndex = (input) => searchDocs(routes, input);
-  resources.register(defineResourceTemplate3({
-    meta: {
-      uriTemplate: "docs://index",
-      title: "DocBlocks index",
-      description: "Default ContractSpec docs index resource.",
-      mimeType: "application/json",
-      tags: DOC_TAGS2
-    },
-    input: z4.object({}),
-    resolve: async () => ({
-      uri: "docs://index",
-      mimeType: "application/json",
-      data: JSON.stringify(readDocIndex({}), null, 2)
-    })
-  }));
-  resources.register(defineResourceTemplate3({
-    meta: {
-      uriTemplate: "docs://index{?query,tag,kind,visibility,limit,offset}",
-      title: "DocBlocks index",
-      description: "Search and paginate ContractSpec docs by query, tag, kind, or visibility.",
-      mimeType: "application/json",
-      tags: DOC_TAGS2
-    },
-    input: z4.object({
-      query: z4.string().optional(),
-      tag: z4.string().optional(),
-      kind: z4.string().optional(),
-      visibility: z4.string().optional(),
-      limit: z4.coerce.number().optional(),
-      offset: z4.coerce.number().optional()
-    }),
-    resolve: async (input) => ({
-      uri: "docs://index",
-      mimeType: "application/json",
-      data: JSON.stringify(readDocIndex(input), null, 2)
-    })
-  }));
-  resources.register(defineResourceTemplate3({
-    meta: {
-      uriTemplate: "docs://list",
-      title: "DocBlocks index (legacy alias)",
-      description: "Compatibility alias for the docs index resource.",
-      mimeType: "application/json",
-      tags: DOC_TAGS2
-    },
-    input: z4.object({}),
-    resolve: async () => ({
-      uri: "docs://list",
-      mimeType: "application/json",
-      data: JSON.stringify(readDocIndex({}), null, 2)
-    })
-  }));
-  resources.register(defineResourceTemplate3({
-    meta: {
-      uriTemplate: "docs://doc/{id}",
-      title: "Doc markdown",
-      description: "Fetch a single DocBlock body by id as markdown.",
-      mimeType: "text/markdown",
-      tags: DOC_TAGS2
-    },
-    input: z4.object({ id: z4.string() }),
-    resolve: async ({ id }) => {
-      const found = getDocById(id);
-      if (!found) {
-        return {
-          uri: `docs://doc/${encodeURIComponent(id)}`,
-          mimeType: "text/plain",
-          data: `DocBlock not found: ${id}`
-        };
-      }
-      return {
-        uri: `docs://doc/${encodeURIComponent(id)}`,
-        mimeType: "text/markdown",
-        data: found.content
-      };
-    }
-  }));
-  resources.register(defineResourceTemplate3({
-    meta: {
-      uriTemplate: "docs://route/{routePath}",
-      title: "Doc by route",
-      description: "Resolve a docs route to the matching DocBlock summary and body.",
-      mimeType: "application/json",
-      tags: DOC_TAGS2
-    },
-    input: z4.object({ routePath: z4.string() }),
-    resolve: async ({ routePath }) => ({
-      uri: `docs://route/${encodeURIComponent(routePath)}`,
-      mimeType: "application/json",
-      data: JSON.stringify(getDocByRoute(routes, routePath) ?? {
-        error: "not_found",
-        route: routePath
-      }, null, 2)
-    })
-  }));
-  resources.register(defineResourceTemplate3({
-    meta: {
-      uriTemplate: "docs://facets",
-      title: "Docs facets",
-      description: "Counts of available tags, kinds, and visibilities across docs.",
-      mimeType: "application/json",
-      tags: DOC_TAGS2
-    },
-    input: z4.object({}),
-    resolve: async () => ({
-      uri: "docs://facets",
-      mimeType: "application/json",
-      data: JSON.stringify(listDocFacets(routes), null, 2)
-    })
-  }));
-  resources.register(defineResourceTemplate3({
-    meta: {
-      uriTemplate: "docs://contract-reference/{key}{?version,type,includeSchema}",
-      title: "Contract reference",
-      description: "Resolve a ContractSpec surface into a docs-ready reference payload.",
-      mimeType: "application/json",
-      tags: DOC_TAGS2
-    },
-    input: z4.object({
-      key: z4.string(),
-      version: z4.string().optional(),
-      type: z4.string().optional(),
-      includeSchema: z4.coerce.boolean().optional()
-    }),
-    resolve: async ({ key, version, type, includeSchema }) => ({
-      uri: `docs://contract-reference/${encodeURIComponent(key)}`,
-      mimeType: "application/json",
-      data: JSON.stringify(resolveContractReference({ key, version, type, includeSchema }), null, 2)
-    })
-  }));
-  return resources;
-}
-
-// src/application/mcp/docsMcp.tools.ts
-import {
-  defineCommand as defineCommand3,
-  defineSchemaModel as defineSchemaModel3,
-  installOp as installOp3,
-  OperationSpecRegistry as OperationSpecRegistry4
-} from "@contractspec/lib.contracts-spec";
-import {
-  ContractReferenceInput,
-  ContractReferenceOutput,
-  DocsIndexInput,
-  DocsIndexOutput
-} from "@contractspec/lib.contracts-spec/docs";
-import { ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
-var DOC_OWNERS2 = ["@contractspec"];
-var DOC_TAGS3 = ["docs", "mcp"];
-var DocsGetInput = defineSchemaModel3({
-  name: "DocsGetInput",
-  fields: {
-    id: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false }
-  }
-});
-var DocsGetOutput = defineSchemaModel3({
-  name: "DocsGetOutput",
-  fields: {
-    doc: { type: ScalarTypeEnum3.JSON(), isOptional: false },
-    content: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false }
-  }
-});
-var DocsResolveRouteInput = defineSchemaModel3({
-  name: "DocsResolveRouteInput",
-  fields: {
-    route: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false }
-  }
-});
-var DocsResolveRouteOutput = defineSchemaModel3({
-  name: "DocsResolveRouteOutput",
-  fields: {
-    doc: { type: ScalarTypeEnum3.JSON(), isOptional: false },
-    content: { type: ScalarTypeEnum3.String_unsecure(), isOptional: false }
-  }
-});
-var DocsFacetsInput = defineSchemaModel3({
-  name: "DocsFacetsInput",
-  fields: {}
-});
-var DocsFacetsOutput = defineSchemaModel3({
-  name: "DocsFacetsOutput",
-  fields: {
-    facets: { type: ScalarTypeEnum3.JSON(), isOptional: false }
-  }
-});
-function buildDocOps(routes) {
-  const registry = new OperationSpecRegistry4;
-  installOp3(registry, defineCommand3({
-    meta: {
-      key: "docs.search",
-      version: "1.0.0",
-      stability: "beta",
-      owners: DOC_OWNERS2,
-      tags: DOC_TAGS3,
-      description: "Search ContractSpec docs by query, tag, kind, or visibility.",
-      goal: "Find the most relevant DocBlocks without browsing the full corpus.",
-      context: "Read-only docs MCP search surface."
-    },
-    io: { input: DocsIndexInput, output: DocsIndexOutput },
-    policy: { auth: "anonymous" },
-    transport: { mcp: { toolName: "docs_search-v1_0_0" } }
-  }), async (args) => searchDocs(routes, args));
-  installOp3(registry, defineCommand3({
-    meta: {
-      key: "docs.get",
-      version: "1.0.0",
-      stability: "beta",
-      owners: DOC_OWNERS2,
-      tags: DOC_TAGS3,
-      description: "Read a single DocBlock by id.",
-      goal: "Fetch the exact markdown content and metadata for a known doc id.",
-      context: "Read-only docs MCP surface."
-    },
-    io: { input: DocsGetInput, output: DocsGetOutput },
-    policy: { auth: "anonymous" },
-    transport: { mcp: { toolName: "docs_get-v1_0_0" } }
-  }), async ({ id }) => {
-    const found = getDocById(id);
-    if (!found)
-      throw new Error(`DocBlock not found: ${id}`);
-    return found;
-  });
-  installOp3(registry, defineCommand3({
-    meta: {
-      key: "docs.resolveRoute",
-      version: "1.0.0",
-      stability: "beta",
-      owners: DOC_OWNERS2,
-      tags: DOC_TAGS3,
-      description: "Resolve a docs route to the matching DocBlock.",
-      goal: "Turn a route or URL path into a canonical doc id and markdown body.",
-      context: "Read-only docs MCP surface."
-    },
-    io: { input: DocsResolveRouteInput, output: DocsResolveRouteOutput },
-    policy: { auth: "anonymous" },
-    transport: { mcp: { toolName: "docs_resolve_route-v1_0_0" } }
-  }), async ({ route }) => {
-    const found = getDocByRoute(routes, route);
-    if (!found)
-      throw new Error(`Doc route not found: ${route}`);
-    return found;
-  });
-  installOp3(registry, defineCommand3({
-    meta: {
-      key: "docs.contract.lookup",
-      version: "1.0.0",
-      stability: "beta",
-      owners: DOC_OWNERS2,
-      tags: DOC_TAGS3,
-      description: "Resolve a ContractSpec surface into a docs-ready reference payload.",
-      goal: "Get canonical docs metadata, route, and optional schema for a spec key.",
-      context: "Read-only docs MCP surface."
-    },
-    io: { input: ContractReferenceInput, output: ContractReferenceOutput },
-    policy: { auth: "anonymous" },
-    transport: { mcp: { toolName: "docs_contract_reference-v1_0_0" } }
-  }), async (args) => resolveContractReference(args));
-  installOp3(registry, defineCommand3({
-    meta: {
-      key: "docs.list.facets",
-      version: "1.0.0",
-      stability: "beta",
-      owners: DOC_OWNERS2,
-      tags: DOC_TAGS3,
-      description: "List docs taxonomy facets such as tags, kinds, and visibilities.",
-      goal: "Help agents browse the docs corpus before making targeted reads.",
-      context: "Read-only docs MCP surface."
-    },
-    io: { input: DocsFacetsInput, output: DocsFacetsOutput },
-    policy: { auth: "anonymous" },
-    transport: { mcp: { toolName: "docs_list_facets-v1_0_0" } }
-  }), async () => ({ facets: listDocFacets(routes) }));
-  return registry;
-}
-
-// src/application/mcp/docsMcp.ts
-import { defaultDocRegistry as defaultDocRegistry3 } from "@contractspec/lib.contracts-spec/docs";
-function createDocsMcpHandler(path2 = "/api/mcp/docs", options = {}) {
-  const routes = defaultDocRegistry3.list();
-  return createMcpElysiaHandler({
-    logger: appLogger,
-    path: path2,
-    serverName: "contractspec-docs-mcp",
-    ops: buildDocOps(routes),
-    resources: buildDocResources(routes),
-    prompts: buildDocPrompts(routes),
-    presentations: options.includePresentations ? routes.map(({ descriptor }) => descriptor) : undefined
-  });
-}
-
-// src/application/mcp/internalMcp.ts
-import {
-  defineCommand as defineCommand4,
-  definePrompt as definePrompt4,
-  defineResourceTemplate as defineResourceTemplate4,
-  installOp as installOp4,
-  OperationSpecRegistry as OperationSpecRegistry5,
-  PromptRegistry as PromptRegistry4,
-  ResourceRegistry as ResourceRegistry4
-} from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel as defineSchemaModel4, ScalarTypeEnum as ScalarTypeEnum4 } from "@contractspec/lib.schema";
-import {
-  getExample,
-  listExamples,
-  searchExamples
-} from "@contractspec/module.examples";
-import z5 from "zod";
-var INTERNAL_TAGS = ["internal", "mcp"];
-var INTERNAL_OWNERS = ["@contractspec"];
-var ENDPOINTS = {
-  docs: "/api/mcp/docs",
-  cli: "/api/mcp/cli",
-  internal: "/api/mcp/internal",
-  graphql: "/graphql",
-  health: "/health"
-};
-function buildInternalResources() {
-  const resources = new ResourceRegistry4;
-  resources.register(defineResourceTemplate4({
-    meta: {
-      uriTemplate: "examples://list{?q}",
-      title: "ContractSpec examples registry",
-      description: "List available examples (templates, integrations, knowledge, scripts). Optional query `q` filters results.",
-      mimeType: "application/json",
-      tags: ["examples", ...INTERNAL_TAGS]
-    },
-    input: z5.object({ q: z5.string().optional() }),
-    resolve: async ({ q }) => {
-      const items = q ? searchExamples(q) : [...listExamples()];
-      return {
-        uri: q ? `examples://list?q=${encodeURIComponent(q)}` : "examples://list",
-        mimeType: "application/json",
-        data: JSON.stringify(items, null, 2)
-      };
-    }
-  }));
-  resources.register(defineResourceTemplate4({
-    meta: {
-      uriTemplate: "examples://example/{id}",
-      title: "ContractSpec example (by id)",
-      description: "Fetch a single example manifest by id.",
-      mimeType: "application/json",
-      tags: ["examples", ...INTERNAL_TAGS]
-    },
-    input: z5.object({ id: z5.string().min(1) }),
-    resolve: async ({ id }) => {
-      const example = getExample(id);
-      if (!example) {
-        return {
-          uri: `examples://example/${encodeURIComponent(id)}`,
-          mimeType: "application/json",
-          data: JSON.stringify({ error: "not_found", id, message: `Unknown example id: ${id}` }, null, 2)
-        };
-      }
-      return {
-        uri: `examples://example/${encodeURIComponent(id)}`,
-        mimeType: "application/json",
-        data: JSON.stringify(example, null, 2)
-      };
-    }
-  }));
-  resources.register(defineResourceTemplate4({
-    meta: {
-      uriTemplate: "internal://endpoints",
-      title: "ContractSpec MCP endpoints",
-      description: "Endpoints for docs, CLI, internal MCP servers.",
-      mimeType: "application/json",
-      tags: INTERNAL_TAGS
-    },
-    input: z5.object({}),
-    resolve: async () => ({
-      uri: "internal://endpoints",
-      mimeType: "application/json",
-      data: JSON.stringify(ENDPOINTS, null, 2)
-    })
-  }));
-  resources.register(defineResourceTemplate4({
-    meta: {
-      uriTemplate: "internal://playbook",
-      title: "Internal MCP usage playbook",
-      description: "How internal agents should discover docs, CLI usage, and endpoints.",
-      mimeType: "text/markdown",
-      tags: INTERNAL_TAGS
-    },
-    input: z5.object({}),
-    resolve: async () => ({
-      uri: "internal://playbook",
-      mimeType: "text/markdown",
-      data: [
-        "# Internal MCP playbook",
-        "- Connect to docs MCP first for canonical specs.",
-        "- Use CLI MCP to surface quickstart/reference before running commands.",
-        "- Keep calls read-only unless explicitly approved.",
-        `- Endpoints: ${ENDPOINTS.docs}, ${ENDPOINTS.cli}, ${ENDPOINTS.internal}.`,
-        "- For API work, GraphQL at /graphql; health at /health."
-      ].join(`
-`)
-    })
-  }));
-  return resources;
-}
-function buildInternalPrompts() {
-  const prompts = new PromptRegistry4;
-  prompts.register(definePrompt4({
-    meta: {
-      key: "internal_bootstrap",
-      version: "1.0.0",
-      title: "Bootstrap internal ContractSpec agent",
-      description: "Points agents to the correct MCP endpoints and guardrails.",
-      tags: INTERNAL_TAGS,
-      owners: INTERNAL_OWNERS,
-      stability: "beta"
-    },
-    args: [],
-    input: z5.object({}),
-    render: async () => [
-      {
-        type: "text",
-        text: "Start with internal://endpoints to pick the right MCP. Use docs MCP for specifications and CLI MCP for commands. Keep actions read-only unless explicitly approved."
-      },
-      {
-        type: "resource",
-        uri: "internal://endpoints",
-        title: "Endpoints"
-      }
-    ]
-  }));
-  return prompts;
-}
-function buildInternalOps() {
-  const registry = new OperationSpecRegistry5;
-  const InternalDescribeOutput = defineSchemaModel4({
-    name: "InternalDescribeOutput",
-    fields: {
-      endpoints: {
-        type: ScalarTypeEnum4.JSONObject(),
-        isOptional: false
-      },
-      notes: { type: ScalarTypeEnum4.String_unsecure(), isOptional: false }
-    }
-  });
-  const describeSpec = defineCommand4({
-    meta: {
-      key: "internal_describe",
-      version: "1.0.0",
-      stability: "stable",
-      owners: INTERNAL_OWNERS,
-      tags: INTERNAL_TAGS,
-      description: "Return MCP endpoints and guidance for internal ContractSpec agents.",
-      goal: "Speed up internal development with the correct MCP entrypoints.",
-      context: "Used by internal MCP surface; read-only."
-    },
-    io: {
-      input: defineSchemaModel4({
-        name: "InternalDescribeInput",
-        fields: {}
-      }),
-      output: InternalDescribeOutput
-    },
-    policy: {
-      auth: "anonymous"
-    }
-  });
-  installOp4(registry, describeSpec, async () => ({
-    endpoints: ENDPOINTS,
-    notes: "Use docs MCP for canonical specs, CLI MCP for contractspec commands, and keep side-effecting actions gated behind human review."
-  }));
-  return registry;
-}
-function createInternalMcpHandler(path2 = "/api/mcp/internal") {
-  return createMcpElysiaHandler({
-    logger: appLogger,
-    path: path2,
-    serverName: "contractspec-internal-mcp",
-    ops: buildInternalOps(),
-    resources: buildInternalResources(),
-    prompts: buildInternalPrompts()
-  });
-}
-
-// src/application/mcp/providerRankingMcp.ts
-import { getModelInfo } from "@contractspec/lib.ai-providers/models";
-import {
-  definePrompt as definePrompt5,
-  defineResourceTemplate as defineResourceTemplate5,
-  installOp as installOp5,
-  OperationSpecRegistry as OperationSpecRegistry6,
-  PromptRegistry as PromptRegistry5,
-  ResourceRegistry as ResourceRegistry5
-} from "@contractspec/lib.contracts-spec";
-import {
-  BenchmarkIngestCommand,
-  BenchmarkRunCustomCommand,
-  RankingRefreshCommand
-} from "@contractspec/lib.contracts-spec/provider-ranking";
-import { InMemoryProviderRankingStore } from "@contractspec/lib.provider-ranking/in-memory-store";
-import { createDefaultIngesterRegistry } from "@contractspec/lib.provider-ranking/ingesters";
-import {
-  computeModelRankings,
-  normalizeBenchmarkResults
-} from "@contractspec/lib.provider-ranking/scoring";
-import z6 from "zod";
-var TransportFilterSchema = z6.enum(["rest", "mcp", "webhook", "sdk"]).optional();
-var AuthFilterSchema = z6.enum([
-  "api-key",
-  "oauth2",
-  "bearer",
-  "header",
-  "basic",
-  "webhook-signing",
-  "service-account"
-]).optional();
-var RANKING_TAGS = ["ranking", "mcp", "ai"];
-var RANKING_OWNERS = ["platform.ai"];
-var sharedStore = null;
-function getStore() {
-  if (!sharedStore) {
-    sharedStore = new InMemoryProviderRankingStore;
-  }
-  return sharedStore;
-}
-function buildRankingResources() {
-  const resources = new ResourceRegistry5;
-  resources.register(defineResourceTemplate5({
-    meta: {
-      uriTemplate: "ranking://leaderboard",
-      title: "AI Model Leaderboard",
-      description: "Current ranked list of AI models by composite score. Supports optional transport and authMethod query filters.",
-      mimeType: "application/json",
-      tags: RANKING_TAGS
-    },
-    input: z6.object({
-      transport: TransportFilterSchema,
-      authMethod: AuthFilterSchema
-    }),
-    resolve: async ({ transport, authMethod }) => {
-      const store = getStore();
-      const result = await store.listModelRankings({
-        limit: 100,
-        requiredTransport: transport,
-        requiredAuthMethod: authMethod
-      });
-      return {
-        uri: "ranking://leaderboard",
-        mimeType: "application/json",
-        data: JSON.stringify(result, null, 2)
-      };
-    }
-  }));
-  resources.register(defineResourceTemplate5({
-    meta: {
-      uriTemplate: "ranking://leaderboard/{dimension}",
-      title: "AI Model Leaderboard by Dimension",
-      description: "Ranked list of AI models filtered by a specific dimension. Supports optional transport and authMethod query filters.",
-      mimeType: "application/json",
-      tags: RANKING_TAGS
-    },
-    input: z6.object({
-      dimension: z6.string(),
-      transport: TransportFilterSchema,
-      authMethod: AuthFilterSchema
-    }),
-    resolve: async ({ dimension, transport, authMethod }) => {
-      const store = getStore();
-      const result = await store.listModelRankings({
-        dimension,
-        limit: 100,
-        requiredTransport: transport,
-        requiredAuthMethod: authMethod
-      });
-      return {
-        uri: `ranking://leaderboard/${encodeURIComponent(dimension)}`,
-        mimeType: "application/json",
-        data: JSON.stringify(result, null, 2)
-      };
-    }
-  }));
-  resources.register(defineResourceTemplate5({
-    meta: {
-      uriTemplate: "ranking://model/{modelId}",
-      title: "AI Model Profile",
-      description: "Detailed profile for a specific AI model including scores and benchmarks.",
-      mimeType: "application/json",
-      tags: RANKING_TAGS
-    },
-    input: z6.object({ modelId: z6.string() }),
-    resolve: async ({ modelId }) => {
-      const store = getStore();
-      const profile = await store.getModelProfile(modelId);
-      if (!profile) {
-        return {
-          uri: `ranking://model/${encodeURIComponent(modelId)}`,
-          mimeType: "application/json",
-          data: JSON.stringify({ error: "not_found", modelId })
-        };
-      }
-      const enriched = profile.costPerMillion == null ? (() => {
-        const info = getModelInfo(profile.modelId);
-        return info?.costPerMillion ? {
-          ...profile,
-          costPerMillion: info.costPerMillion,
-          displayName: info.name,
-          contextWindow: info.contextWindow,
-          capabilities: [
-            ...info.capabilities.vision ? ["vision"] : [],
-            ...info.capabilities.tools ? ["tools"] : [],
-            ...info.capabilities.reasoning ? ["reasoning"] : [],
-            ...info.capabilities.streaming ? ["streaming"] : []
-          ]
-        } : profile;
-      })() : profile;
-      return {
-        uri: `ranking://model/${encodeURIComponent(modelId)}`,
-        mimeType: "application/json",
-        data: JSON.stringify(enriched, null, 2)
-      };
-    }
-  }));
-  resources.register(defineResourceTemplate5({
-    meta: {
-      uriTemplate: "ranking://results",
-      title: "Benchmark Results",
-      description: "List of raw benchmark results from all ingested sources.",
-      mimeType: "application/json",
-      tags: RANKING_TAGS
-    },
-    input: z6.object({}),
-    resolve: async () => {
-      const store = getStore();
-      const result = await store.listBenchmarkResults({ limit: 200 });
-      return {
-        uri: "ranking://results",
-        mimeType: "application/json",
-        data: JSON.stringify(result, null, 2)
-      };
-    }
-  }));
-  return resources;
-}
-function buildRankingPrompts() {
-  const prompts = new PromptRegistry5;
-  prompts.register(definePrompt5({
-    meta: {
-      key: "ranking.advisor",
-      version: "1.0.0",
-      title: "AI Model Advisor",
-      description: "Which AI model is best for a given task? Uses the leaderboard to recommend.",
-      tags: RANKING_TAGS,
-      stability: "beta",
-      owners: RANKING_OWNERS
-    },
-    args: [
-      {
-        name: "task",
-        description: "The task or use case to recommend a model for.",
-        required: true,
-        schema: z6.string()
-      },
-      {
-        name: "priority",
-        description: "Priority dimension (coding, reasoning, cost, latency, etc.).",
-        required: false,
-        schema: z6.string().optional()
-      },
-      {
-        name: "transport",
-        description: "Required transport type (rest, mcp, webhook, sdk).",
-        required: false,
-        schema: TransportFilterSchema
-      },
-      {
-        name: "authMethod",
-        description: "Required auth method (api-key, oauth2, bearer, etc.).",
-        required: false,
-        schema: AuthFilterSchema
-      }
-    ],
-    input: z6.object({
-      task: z6.string(),
-      priority: z6.string().optional(),
-      transport: TransportFilterSchema,
-      authMethod: AuthFilterSchema
-    }),
-    render: async ({ task, priority, transport, authMethod }) => {
-      const constraints = [];
-      if (priority)
-        constraints.push(`Prioritize: ${priority}.`);
-      if (transport)
-        constraints.push(`Required transport: ${transport}.`);
-      if (authMethod)
-        constraints.push(`Required auth: ${authMethod}.`);
-      return [
-        {
-          type: "text",
-          text: `Recommend the best AI model for: "${task}".${constraints.length ? ` ${constraints.join(" ")}` : ""} Use the leaderboard data to justify your recommendation.`
-        },
-        {
-          type: "resource",
-          uri: priority ? `ranking://leaderboard/${priority}` : "ranking://leaderboard",
-          title: "Leaderboard"
-        }
-      ];
-    }
-  }));
-  return prompts;
-}
-function buildRankingOps() {
-  const registry = new OperationSpecRegistry6;
-  const ingesterRegistry = createDefaultIngesterRegistry();
-  installOp5(registry, BenchmarkIngestCommand, async (args) => {
-    const store = getStore();
-    const source = args.source;
-    const ingester = ingesterRegistry.get(source);
-    if (!ingester) {
-      throw new Error(`No ingester registered for source: ${source}`);
-    }
-    const rawResults = await ingester.ingest({
-      sourceUrl: args.sourceUrl,
-      dimensions: args.dimensions
-    });
-    const normalized = normalizeBenchmarkResults(rawResults);
-    for (const result of normalized) {
-      await store.upsertBenchmarkResult(result);
-    }
-    return {
-      ingestionId: `ingest-${source}-${Date.now()}`,
-      source,
-      resultsCount: normalized.length,
-      status: "completed",
-      ingestedAt: new Date
-    };
-  });
-  installOp5(registry, BenchmarkRunCustomCommand, async (args) => {
-    return {
-      runId: `custom-${Date.now()}`,
-      evalSuiteKey: args.evalSuiteKey,
-      modelId: args.modelId,
-      status: "started",
-      startedAt: new Date
-    };
-  });
-  installOp5(registry, RankingRefreshCommand, async (args) => {
-    const store = getStore();
-    const allResults = [];
-    let offset = 0;
-    const pageSize = 500;
-    while (true) {
-      const page = await store.listBenchmarkResults({
-        limit: pageSize,
-        offset
-      });
-      allResults.push(...page.results);
-      if (allResults.length >= page.total || page.results.length < pageSize)
-        break;
-      offset += pageSize;
-    }
-    const existingRankings = new Map((await store.listModelRankings({ limit: 1e4 })).rankings.map((r) => [
-      r.modelId,
-      r
-    ]));
-    const weightOverrides = args.weightOverrides ? Array.isArray(args.weightOverrides) ? args.weightOverrides : [args.weightOverrides] : undefined;
-    const newRankings = computeModelRankings(allResults, weightOverrides ? {
-      weightOverrides
-    } : undefined, existingRankings);
-    for (const ranking of newRankings) {
-      await store.upsertModelRanking(ranking);
-    }
-    return {
-      modelsRanked: newRankings.length,
-      updatedAt: new Date,
-      status: "completed"
-    };
-  });
-  return registry;
-}
-function createProviderRankingMcpHandler(path2 = "/api/mcp/ranking") {
-  return createMcpElysiaHandler({
-    logger: appLogger,
-    path: path2,
-    serverName: "contractspec-ranking-mcp",
-    ops: buildRankingOps(),
-    resources: buildRankingResources(),
-    prompts: buildRankingPrompts()
-  });
-}
-function setProviderRankingStore(store) {
-  sharedStore = store;
-}
-export {
-  setProviderRankingStore,
-  createProviderRankingMcpHandler,
-  createInternalMcpHandler,
-  createDocsMcpHandler,
-  createContractsMcpHandler,
-  createContextStorageService,
-  createCliMcpHandler
-};
+contractspec validate <spec>`,reference:`# ContractSpec CLI reference
+
+Key commands: create, build, validate. See README for full options.`,readme:`# ContractSpec CLI
+
+Stabilize AI-generated code across API, DB, UI, events. Use create/build/validate commands.`},r=["cli","mcp"],kj=["@contractspec"],_Y=(()=>{let j=new Set([process.cwd(),l.resolve(process.cwd(),".."),l.resolve(process.cwd(),"../.."),l.resolve(process.cwd(),"../../..")]);if(typeof __dirname==="string")j.add(l.resolve(__dirname,"../../../../.."));return[...j]})(),s=new Map;async function MY(j){if(s.has(j))return s.get(j);let Y=LY[j];for(let Q of _Y){let $=l.resolve(Q,Y);try{let Z=await BY.readFile($,"utf8");return s.set(j,Z),Z}catch{}}let J=GY[j];return s.set(j,J),J}function bY(){let j=new qY;return j.register(zj({meta:{uriTemplate:"cli://doc/{slug}",title:"CLI documentation",description:"Quickstart, reference, and README for the CLI.",mimeType:"text/markdown",tags:r},input:k.object({slug:k.enum(["quickstart","reference","readme"])}),resolve:async({slug:Y})=>{let J=await MY(Y);return{uri:`cli://doc/${Y}`,mimeType:"text/markdown",data:J}}})),j.register(zj({meta:{uriTemplate:"cli://commands",title:"CLI commands summary",description:"Key ContractSpec CLI commands and when to use them.",mimeType:"application/json",tags:r},input:k.object({}),resolve:async()=>{return{uri:"cli://commands",mimeType:"application/json",data:JSON.stringify([{command:"contractspec create",summary:"Interactive wizard to author specs (with optional AI).",doc:"cli://doc/quickstart"},{command:"contractspec build <specPath>",summary:"Generate implementation code from a ContractSpec (agents + templates).",doc:"cli://doc/reference"},{command:"contractspec validate <specPath>",summary:"Validate specs and optionally check implementations against them.",doc:"cli://doc/reference"}],null,2)}}})),j}function DY(){let j=new PY;return j.register(FY({meta:{key:"cli.usage",version:"1.0.0",title:"Use ContractSpec CLI safely",description:"Remind agents to read CLI docs and pick commands from the canonical list.",tags:r,stability:"beta",owners:kj},args:[{name:"goal",description:"Task the user wants to achieve.",required:!1,schema:k.string().optional()}],input:k.object({goal:k.string().optional()}),render:async({goal:Y})=>[{type:"text",text:`Use CLI commands only from cli://commands. Prefer quickstart for newcomers and reference for options.${Y?` Goal: ${Y}.`:""}`},{type:"resource",uri:"cli://commands",title:"Commands"},{type:"resource",uri:"cli://doc/quickstart",title:"Quickstart"}]})),j}function NY(){let j=new xY,Y=Oj({name:"CliSuggestInput",fields:{goal:{type:d.String_unsecure(),isOptional:!1},prefersAi:{type:d.Boolean(),isOptional:!0}}}),J=Oj({name:"CliSuggestOutput",fields:{command:{type:d.String_unsecure(),isOptional:!1},docUri:{type:d.String_unsecure(),isOptional:!1},reason:{type:d.String_unsecure(),isOptional:!1}}}),Q=wY({meta:{key:"cli_suggestCommand",version:"1.0.0",stability:"stable",owners:kj,tags:r,description:"Recommend a CLI command for the requested goal.",goal:"Help AI agents choose the correct CLI entrypoint quickly.",context:"Used inside the CLI MCP server."},io:{input:Y,output:J},policy:{auth:"anonymous"}});return WY(j,Q,async({goal:$,prefersAi:Z})=>{let X=$.toLowerCase();if(X.includes("create")||X.includes("new"))return{command:Z?"contractspec create --ai":"contractspec create",docUri:"cli://doc/quickstart",reason:"Creates a new ContractSpec interactively (optionally with AI)."};if(X.includes("build")||X.includes("generate"))return{command:"contractspec build <path-to-spec>",docUri:"cli://doc/reference",reason:"Builds implementation code from a spec using agents + templates."};if(X.includes("validate")||X.includes("check"))return{command:"contractspec validate <path-to-spec>",docUri:"cli://doc/reference",reason:"Validates a spec and optionally checks its implementation for drift."};return{command:"contractspec --help",docUri:"cli://doc/readme",reason:"Fallback when the goal is unclear; read README for options."}}),j}function SJ(j="/api/mcp/cli"){return b({logger:M,path:j,serverName:"contractspec-cli-mcp",ops:NY(),resources:bY(),prompts:DY()})}import{definePrompt as AY,defineResourceTemplate as Gj,PromptRegistry as CY,ResourceRegistry as IY}from"@contractspec/lib.contracts-spec";import A from"zod";var EY=["@contractspec"],e=["contracts","mcp"];function Rj(j){let Y=new IY;return Y.register(Gj({meta:{uriTemplate:"contracts://list",title:"Contract specs list",description:"JSON list of all contract specs in the workspace.",mimeType:"application/json",tags:e},input:A.object({}),resolve:async()=>{let J=await j.listSpecs();return{uri:"contracts://list",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),Y.register(Gj({meta:{uriTemplate:"contracts://spec/{path}",title:"Contract spec content",description:"Read a single contract spec file by path.",mimeType:"text/plain",tags:e},input:A.object({path:A.string()}),resolve:async({path:J})=>{let Q=await j.getSpec(J);if(!Q)return{uri:`contracts://spec/${encodeURIComponent(J)}`,mimeType:"text/plain",data:`Spec not found: ${J}`};return{uri:`contracts://spec/${encodeURIComponent(J)}`,mimeType:"text/plain",data:Q.content}}})),Y.register(Gj({meta:{uriTemplate:"contracts://registry/manifest",title:"Remote registry manifest",description:"Contract registry manifest from the remote server.",mimeType:"application/json",tags:e},input:A.object({}),resolve:async()=>{let J=await j.fetchRegistryManifest();return{uri:"contracts://registry/manifest",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),Y}function vj(){let j=new CY;return j.register(AY({meta:{key:"contracts.editor",version:"1.0.0",title:"Contract editing guide",description:"Guide AI agents through reading, editing, and validating contracts.",tags:e,stability:"beta",owners:EY},args:[{name:"goal",description:"What the agent wants to achieve with the contract.",required:!1,schema:A.string().optional()}],input:A.object({goal:A.string().optional()}),render:async({goal:Y})=>[{type:"text",text:["Contract editing workflow:","1. Use contracts.list to discover specs","2. Use contracts.get to read a spec","3. Edit content and call contracts.update","4. Run contracts.validate to verify changes","5. Run contracts.build to regenerate artifacts",Y?`Agent goal: ${Y}`:""].filter(Boolean).join(`
+`)},{type:"resource",uri:"contracts://list",title:"Available contracts"}]})),j}import{defineCommand as R,installOp as v,OperationSpecRegistry as zY}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as _,ScalarTypeEnum as B}from"@contractspec/lib.schema";var T=["@contractspec"],f=["contracts","mcp"];function Tj(j){let Y=new zY,J=_({name:"ContractsListInput",fields:{pattern:{type:B.String_unsecure(),isOptional:!0},type:{type:B.String_unsecure(),isOptional:!0}}}),Q=_({name:"ContractsListOutput",fields:{specs:{type:B.JSON(),isOptional:!1},total:{type:B.Int_unsecure(),isOptional:!1}}});v(Y,R({meta:{key:"contracts.list",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"List contract specs in the workspace.",goal:"Discover available contracts by type, pattern, or owner.",context:"Contracts MCP server."},io:{input:J,output:Q},policy:{auth:"anonymous"}}),async({pattern:V,type:H})=>{let G=await j.listSpecs({pattern:V,type:H});return{specs:G,total:G.length}});let $=_({name:"ContractsGetInput",fields:{path:{type:B.String_unsecure(),isOptional:!1}}}),Z=_({name:"ContractsGetOutput",fields:{content:{type:B.String_unsecure(),isOptional:!1},info:{type:B.JSON(),isOptional:!1}}});v(Y,R({meta:{key:"contracts.get",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"Read a single contract spec file.",goal:"Fetch spec content and parsed metadata.",context:"Contracts MCP server."},io:{input:$,output:Z},policy:{auth:"anonymous"}}),async({path:V})=>{let H=await j.getSpec(V);if(!H)throw Error(`Spec not found: ${V}`);return H});let X=_({name:"ContractsValidateInput",fields:{path:{type:B.String_unsecure(),isOptional:!1}}}),U=_({name:"ContractsValidateOutput",fields:{valid:{type:B.Boolean(),isOptional:!1},errors:{type:B.JSON(),isOptional:!1},warnings:{type:B.JSON(),isOptional:!1}}});v(Y,R({meta:{key:"contracts.validate",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"Validate a contract spec structure.",goal:"Check spec for structural or policy issues.",context:"Contracts MCP server."},io:{input:X,output:U},policy:{auth:"anonymous"}}),async({path:V})=>j.validateSpec(V));let K=_({name:"ContractsBuildInput",fields:{path:{type:B.String_unsecure(),isOptional:!1},dryRun:{type:B.Boolean(),isOptional:!0}}}),P=_({name:"ContractsBuildOutput",fields:{results:{type:B.JSON(),isOptional:!1}}});return v(Y,R({meta:{key:"contracts.build",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"Generate implementation code from a contract spec.",goal:"Produce handler, component, or test skeletons.",context:"Contracts MCP server."},io:{input:K,output:P},policy:{auth:"user"}}),async({path:V,dryRun:H})=>j.buildSpec(V,{dryRun:H})),OY(Y,j),Y}function OY(j,Y){let J=_({name:"ContractsUpdateInput",fields:{path:{type:B.String_unsecure(),isOptional:!1},content:{type:B.String_unsecure(),isOptional:!0},fields:{type:B.JSON(),isOptional:!0}}}),Q=_({name:"ContractsUpdateOutput",fields:{updated:{type:B.Boolean(),isOptional:!1},errors:{type:B.JSON(),isOptional:!1},warnings:{type:B.JSON(),isOptional:!1}}});v(j,R({meta:{key:"contracts.update",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"Update an existing contract spec.",goal:"Modify spec content or individual fields with validation.",context:"Contracts MCP server."},io:{input:J,output:Q},policy:{auth:"user"}}),async({path:X,content:U,fields:K})=>Y.updateSpec(X,{content:U,fields:Array.isArray(K)?K:void 0}));let $=_({name:"ContractsDeleteInput",fields:{path:{type:B.String_unsecure(),isOptional:!1},clean:{type:B.Boolean(),isOptional:!0}}}),Z=_({name:"ContractsDeleteOutput",fields:{deleted:{type:B.Boolean(),isOptional:!1},cleanedFiles:{type:B.JSON(),isOptional:!1},errors:{type:B.JSON(),isOptional:!1}}});v(j,R({meta:{key:"contracts.delete",version:"1.0.0",stability:"beta",owners:T,tags:f,description:"Delete a contract spec and optionally its artifacts.",goal:"Remove a spec file and clean generated handlers/tests.",context:"Contracts MCP server."},io:{input:$,output:Z},policy:{auth:"user"}}),async({path:X,clean:U})=>Y.deleteSpec(X,{clean:U}))}function oJ(j="/api/mcp/contracts",Y){return b({logger:M,path:j,serverName:"contractspec-contracts-mcp",ops:Tj(Y),resources:Rj(Y),prompts:vj()})}import{defaultDocRegistry as kY}from"@contractspec/lib.contracts-spec/docs";var RY=20,vY=100;function q(j){return j?.trim().toLowerCase()??""}function fj(j){let Y=decodeURIComponent(j).trim();if(!Y)return"/";return Y.startsWith("/")?Y:`/${Y}`}function TY(j){return(Array.isArray(j)?j:j?[j]:[]).map((J)=>q(J)).filter(Boolean)}function fY(j){if(!j||Number.isNaN(j))return RY;return Math.min(Math.max(j,1),vY)}function hY(j){if(!j||Number.isNaN(j))return 0;return Math.max(j,0)}function _j({block:j,route:Y}){return{id:j.id,title:j.title,summary:j.summary??"",route:Y,visibility:j.visibility??"public",kind:j.kind??"reference",version:j.version??"1.0.0",tags:j.tags??[]}}function SY(j,Y){if(!Y)return 1;let J=Y.split(/\s+/).filter(Boolean),Q=q(j.block.title),$=q(j.block.id),Z=q(j.block.summary),X=q(j.block.body),U=q(j.route),K=(j.block.tags??[]).map((H)=>q(H)),P=[Q,$,Z,X,U,...K].join(" ");if(J.some((H)=>!P.includes(H)))return 0;let V=0;for(let H of J){if($.includes(H))V+=8;if(Q.includes(H))V+=7;if(K.some((G)=>G.includes(H)))V+=5;if(Z.includes(H))V+=4;if(U.includes(H))V+=3;if(X.includes(H))V+=2}return V}function h(j,Y){let J=q(typeof Y.query==="string"?Y.query:void 0),Q=TY(Y.tag),$=q(typeof Y.visibility==="string"?Y.visibility:void 0),Z=q(typeof Y.kind==="string"?Y.kind:void 0),X=fY(typeof Y.limit==="number"?Y.limit:void 0),U=hY(typeof Y.offset==="number"?Y.offset:void 0),K=j.map((H)=>({doc:_j(H),score:SY(H,J)})).filter(({doc:H,score:G})=>{let Fj=J?G>0:!0,F=Q.length?Q.every((u)=>H.tags.some((N)=>q(N).includes(u))):!0,W=$?q(H.visibility)===$:!0,D=Z?q(H.kind)===Z:!0;return Fj&&F&&W&&D}).sort((H,G)=>{if(G.score!==H.score)return G.score-H.score;return H.doc.title.localeCompare(G.doc.title)}),P=K.slice(U,U+X).map(({doc:H})=>H),V=U+P.length<K.length?U+P.length:void 0;return{docs:P,items:P,total:K.length,...V!=null?{nextOffset:V}:{}}}function jj(j){let Y=decodeURIComponent(j),J=kY.get(Y);if(!J)return;return{doc:_j(J),content:String(J.block.body??"")}}function Yj(j,Y){let J=fj(Y),Q=j.find(($)=>fj($.route)===J);if(!Q)return;return{doc:_j(Q),content:String(Q.block.body??"")}}function Jj(j){let Y=new Map,J=new Map,Q=new Map;for(let Z of j){let X=Z.block.kind??"reference",U=Z.block.visibility??"public";J.set(X,(J.get(X)??0)+1),Q.set(U,(Q.get(U)??0)+1);for(let K of Z.block.tags??[])Y.set(K,(Y.get(K)??0)+1)}let $=(Z,X)=>[...Z.entries()].sort((U,K)=>K[1]-U[1]||U[0].localeCompare(K[0])).map(([U,K])=>({[X]:U,count:K}));return{totalDocs:j.length,tags:$(Y,"tag"),kinds:$(J,"kind"),visibilities:$(Q,"visibility")}}import{EventRegistry as yY,OperationSpecRegistry as mY}from"@contractspec/lib.contracts-spec";import{DataViewRegistry as gY}from"@contractspec/lib.contracts-spec/data-views";import{ContractReferenceDataView as uY,ContractReferenceQuery as dY,DocsGenerateCommand as lY,DocsGeneratedEvent as pY,DocsIndexDataView as nY,DocsIndexQuery as cY,DocsLayoutPresentation as iY,DocsPublishCommand as aY,DocsPublishedEvent as oY,DocsReferencePagePresentation as tY,DocsSearchForm as sY,ExampleCatalogDataView as rY}from"@contractspec/lib.contracts-spec/docs";import{FormRegistry as eY}from"@contractspec/lib.contracts-spec/forms";import{PresentationRegistry as j0}from"@contractspec/lib.contracts-spec/presentations";import{serializeDataViewSpec as Y0,serializeEventSpec as J0,serializeFormSpec as Q0,serializeOperationSpec as Z0,serializePresentationSpec as $0}from"@contractspec/lib.contracts-spec/serialization";var Qj=null;function X0(){let j=new mY;return j.register(cY).register(dY).register(lY).register(aY),j}function U0(){if(!Qj)Qj=X0();return Qj}function Mj(j,Y){return U0().get(j,Y)}var Zj=null;function V0(){let j=new yY;return j.register(pY).register(oY),j}function H0(){if(!Zj)Zj=V0();return Zj}function bj(j,Y){return H0().get(j,Y)}var $j=null;function K0(){let j=new j0;return j.register(iY).register(tY),j}function B0(){if(!$j)$j=K0();return $j}function Dj(j,Y){return B0().get(j,Y)}var Xj=null;function w0(){let j=new gY;return j.register(nY).register(uY).register(rY),j}function F0(){if(!Xj)Xj=w0();return Xj}function Nj(j,Y){return F0().get(j,Y)}var Uj=null;function W0(){let j=new eY;return j.register(sY),j}function x0(){if(!Uj)Uj=W0();return Uj}function Aj(j,Y){return x0().get(j)}function hj(j,Y){let J=Mj(j,Y);return Z0(J)??void 0}function Sj(j,Y){let J=bj(j,Y);return J0(J)??void 0}function yj(j,Y){let J=Dj(j,Y);return $0(J)??void 0}function mj(j,Y){let J=Nj(j,Y);return Y0(J)??void 0}function gj(j,Y){let J=Aj(j,Y);return Q0(J)??void 0}function P0(){Qj=null}function q0(){Zj=null}function L0(){$j=null}function G0(){Xj=null}function _0(){Uj=null}function $Q(){P0(),q0(),L0(),G0(),_0()}import{defaultDocRegistry as M0}from"@contractspec/lib.contracts-spec/docs";function b0(j){return j?.trim().toLowerCase()??""}function D0(j){for(let Y of j??[]){let J=M0.get(Y);if(J)return J.route}return}function uj(j,Y,J,Q){let $=j.meta.title??j.meta.key,Z=D0(j.meta.docId),X=j.meta.description;return{key:j.meta.key,version:j.meta.version,type:Y,title:$,description:X,markdown:[`# ${$}`,`- Key: ${j.meta.key}`,`- Type: ${Y}`,`- Version: ${j.meta.version}`,Z?`- Docs route: ${Z}`:"",X?`
+${X}`:""].filter(Boolean).join(`
+`),...Z?{route:Z}:{},...J?{schema:J}:{},...Q?{policy:Q}:{},tags:j.meta.tags??[],owners:j.meta.owners??[],stability:j.meta.stability}}function S(j){let Y=j.includeSchema??!1,J=b0(j.type),Q=Mj(j.key,j.version);if(Q&&(!J||J==="operation"||J===Q.meta.kind))return{reference:uj(Q,Q.meta.kind,Y?hj(j.key,j.version):void 0,Q.policy)};let $=[{type:"data-view",spec:Nj(j.key,j.version),schema:Y?mj(j.key,j.version):void 0},{type:"form",spec:Aj(j.key,j.version),schema:Y?gj(j.key,j.version):void 0},{type:"presentation",spec:Dj(j.key,j.version),schema:Y?yj(j.key,j.version):void 0},{type:"event",spec:bj(j.key,j.version),schema:Y?Sj(j.key,j.version):void 0}];for(let Z of $)if(Z.spec&&(!J||J===Z.type))return{reference:uj(Z.spec,Z.type,Z.schema)};throw Error(`Contract reference not found: ${j.key}`)}import{definePrompt as dj,PromptRegistry as N0}from"@contractspec/lib.contracts-spec";import x from"zod";var lj=["@contractspec"],pj=["docs","mcp"];function nj(j){let Y=new N0;return Y.register(dj({meta:{key:"docs.navigator",version:"1.0.0",title:"Find relevant ContractSpec docs",description:"Guide agents to search, filter, and open the right ContractSpec docs.",tags:pj,stability:"beta",owners:lj},args:[{name:"topic",description:"Goal or subject to search for.",required:!1,schema:x.string().optional()},{name:"kind",description:"Optional doc kind filter.",required:!1,schema:x.string().optional()},{name:"tag",description:"Optional tag filter.",required:!1,schema:x.string().optional()}],input:x.object({topic:x.string().optional(),kind:x.string().optional(),tag:x.string().optional()}),render:async({topic:J,kind:Q,tag:$})=>{let Z=h(j,{query:J,kind:Q,tag:$,limit:3}),X=Z.docs.length?Z.docs.map((U)=>`- ${U.title} (${U.id}) -> ${U.route}`).join(`
+`):"- No direct pre-match. Use docs_list_facets-v1_0_0 to browse tags and kinds.";return[{type:"text",text:["Use docs_search-v1_0_0 first, then read docs://doc/{id} for the strongest matches.","Use docs_resolve_route-v1_0_0 when the user already gives you a docs URL or route.","Use docs_list_facets-v1_0_0 or docs://facets to browse the docs taxonomy before guessing.",J?`Topic: ${J}`:"",Q?`Kind: ${Q}`:"",$?`Tag: ${$}`:"","Suggested starting docs:",X].filter(Boolean).join(`
+`)},{type:"resource",uri:"docs://index",title:"DocBlocks index"},{type:"resource",uri:"docs://facets",title:"Docs facets"}]}})),Y.register(dj({meta:{key:"docs.reference.guide",version:"1.0.0",title:"Resolve a ContractSpec reference",description:"Guide agents to fetch the canonical reference payload for a ContractSpec surface.",tags:pj,stability:"beta",owners:lj},args:[{name:"key",description:"ContractSpec key to resolve.",required:!0,schema:x.string()},{name:"version",description:"Optional version override.",required:!1,schema:x.string().optional()},{name:"type",description:"Optional surface type: command, query, form, data-view, presentation, event.",required:!1,schema:x.string().optional()}],input:x.object({key:x.string(),version:x.string().optional(),type:x.string().optional()}),render:async({key:J,version:Q,type:$})=>{let Z=S({key:J,version:Q,type:$,includeSchema:!0}).reference;return[{type:"text",text:["Use docs_contract_reference-v1_0_0 when you need the canonical docs payload for a ContractSpec surface.","Use docs_get-v1_0_0 only when you already know the exact DocBlock id and need raw markdown.",`Resolved key: ${Z.key}`,`Resolved type: ${Z.type}`,Z.route?`Docs route: ${Z.route}`:"",`Resource URI: docs://contract-reference/${encodeURIComponent(J)}`].filter(Boolean).join(`
+`)},{type:"resource",uri:`docs://contract-reference/${encodeURIComponent(J)}`,title:"Contract reference"}]}})),Y}import{defineResourceTemplate as C,ResourceRegistry as A0}from"@contractspec/lib.contracts-spec";import w from"zod";var I=["docs","mcp"];function cj(j){let Y=new A0,J=(Q)=>h(j,Q);return Y.register(C({meta:{uriTemplate:"docs://index",title:"DocBlocks index",description:"Default ContractSpec docs index resource.",mimeType:"application/json",tags:I},input:w.object({}),resolve:async()=>({uri:"docs://index",mimeType:"application/json",data:JSON.stringify(J({}),null,2)})})),Y.register(C({meta:{uriTemplate:"docs://index{?query,tag,kind,visibility,limit,offset}",title:"DocBlocks index",description:"Search and paginate ContractSpec docs by query, tag, kind, or visibility.",mimeType:"application/json",tags:I},input:w.object({query:w.string().optional(),tag:w.string().optional(),kind:w.string().optional(),visibility:w.string().optional(),limit:w.coerce.number().optional(),offset:w.coerce.number().optional()}),resolve:async(Q)=>({uri:"docs://index",mimeType:"application/json",data:JSON.stringify(J(Q),null,2)})})),Y.register(C({meta:{uriTemplate:"docs://list",title:"DocBlocks index (legacy alias)",description:"Compatibility alias for the docs index resource.",mimeType:"application/json",tags:I},input:w.object({}),resolve:async()=>({uri:"docs://list",mimeType:"application/json",data:JSON.stringify(J({}),null,2)})})),Y.register(C({meta:{uriTemplate:"docs://doc/{id}",title:"Doc markdown",description:"Fetch a single DocBlock body by id as markdown.",mimeType:"text/markdown",tags:I},input:w.object({id:w.string()}),resolve:async({id:Q})=>{let $=jj(Q);if(!$)return{uri:`docs://doc/${encodeURIComponent(Q)}`,mimeType:"text/plain",data:`DocBlock not found: ${Q}`};return{uri:`docs://doc/${encodeURIComponent(Q)}`,mimeType:"text/markdown",data:$.content}}})),Y.register(C({meta:{uriTemplate:"docs://route/{routePath}",title:"Doc by route",description:"Resolve a docs route to the matching DocBlock summary and body.",mimeType:"application/json",tags:I},input:w.object({routePath:w.string()}),resolve:async({routePath:Q})=>({uri:`docs://route/${encodeURIComponent(Q)}`,mimeType:"application/json",data:JSON.stringify(Yj(j,Q)??{error:"not_found",route:Q},null,2)})})),Y.register(C({meta:{uriTemplate:"docs://facets",title:"Docs facets",description:"Counts of available tags, kinds, and visibilities across docs.",mimeType:"application/json",tags:I},input:w.object({}),resolve:async()=>({uri:"docs://facets",mimeType:"application/json",data:JSON.stringify(Jj(j),null,2)})})),Y.register(C({meta:{uriTemplate:"docs://contract-reference/{key}{?version,type,includeSchema}",title:"Contract reference",description:"Resolve a ContractSpec surface into a docs-ready reference payload.",mimeType:"application/json",tags:I},input:w.object({key:w.string(),version:w.string().optional(),type:w.string().optional(),includeSchema:w.coerce.boolean().optional()}),resolve:async({key:Q,version:$,type:Z,includeSchema:X})=>({uri:`docs://contract-reference/${encodeURIComponent(Q)}`,mimeType:"application/json",data:JSON.stringify(S({key:Q,version:$,type:Z,includeSchema:X}),null,2)})})),Y}import{defineCommand as p,defineSchemaModel as y,installOp as n,OperationSpecRegistry as C0}from"@contractspec/lib.contracts-spec";import{ContractReferenceInput as I0,ContractReferenceOutput as E0,DocsIndexInput as z0,DocsIndexOutput as O0}from"@contractspec/lib.contracts-spec/docs";import{ScalarTypeEnum as E}from"@contractspec/lib.schema";var c=["@contractspec"],i=["docs","mcp"],k0=y({name:"DocsGetInput",fields:{id:{type:E.String_unsecure(),isOptional:!1}}}),R0=y({name:"DocsGetOutput",fields:{doc:{type:E.JSON(),isOptional:!1},content:{type:E.String_unsecure(),isOptional:!1}}}),v0=y({name:"DocsResolveRouteInput",fields:{route:{type:E.String_unsecure(),isOptional:!1}}}),T0=y({name:"DocsResolveRouteOutput",fields:{doc:{type:E.JSON(),isOptional:!1},content:{type:E.String_unsecure(),isOptional:!1}}}),f0=y({name:"DocsFacetsInput",fields:{}}),h0=y({name:"DocsFacetsOutput",fields:{facets:{type:E.JSON(),isOptional:!1}}});function ij(j){let Y=new C0;return n(Y,p({meta:{key:"docs.search",version:"1.0.0",stability:"beta",owners:c,tags:i,description:"Search ContractSpec docs by query, tag, kind, or visibility.",goal:"Find the most relevant DocBlocks without browsing the full corpus.",context:"Read-only docs MCP search surface."},io:{input:z0,output:O0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_search-v1_0_0"}}}),async(J)=>h(j,J)),n(Y,p({meta:{key:"docs.get",version:"1.0.0",stability:"beta",owners:c,tags:i,description:"Read a single DocBlock by id.",goal:"Fetch the exact markdown content and metadata for a known doc id.",context:"Read-only docs MCP surface."},io:{input:k0,output:R0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_get-v1_0_0"}}}),async({id:J})=>{let Q=jj(J);if(!Q)throw Error(`DocBlock not found: ${J}`);return Q}),n(Y,p({meta:{key:"docs.resolveRoute",version:"1.0.0",stability:"beta",owners:c,tags:i,description:"Resolve a docs route to the matching DocBlock.",goal:"Turn a route or URL path into a canonical doc id and markdown body.",context:"Read-only docs MCP surface."},io:{input:v0,output:T0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_resolve_route-v1_0_0"}}}),async({route:J})=>{let Q=Yj(j,J);if(!Q)throw Error(`Doc route not found: ${J}`);return Q}),n(Y,p({meta:{key:"docs.contract.lookup",version:"1.0.0",stability:"beta",owners:c,tags:i,description:"Resolve a ContractSpec surface into a docs-ready reference payload.",goal:"Get canonical docs metadata, route, and optional schema for a spec key.",context:"Read-only docs MCP surface."},io:{input:I0,output:E0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_contract_reference-v1_0_0"}}}),async(J)=>S(J)),n(Y,p({meta:{key:"docs.list.facets",version:"1.0.0",stability:"beta",owners:c,tags:i,description:"List docs taxonomy facets such as tags, kinds, and visibilities.",goal:"Help agents browse the docs corpus before making targeted reads.",context:"Read-only docs MCP surface."},io:{input:f0,output:h0},policy:{auth:"anonymous"},transport:{mcp:{toolName:"docs_list_facets-v1_0_0"}}}),async()=>({facets:Jj(j)})),Y}import{defaultDocRegistry as S0}from"@contractspec/lib.contracts-spec/docs";function RQ(j="/api/mcp/docs",Y={}){let J=S0.list();return b({logger:M,path:j,serverName:"contractspec-docs-mcp",ops:ij(J),resources:cj(J),prompts:nj(J),presentations:Y.includePresentations?J.map(({descriptor:Q})=>Q):void 0})}import{defineCommand as y0,definePrompt as m0,defineResourceTemplate as Vj,installOp as g0,OperationSpecRegistry as u0,PromptRegistry as d0,ResourceRegistry as l0}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as aj,ScalarTypeEnum as oj}from"@contractspec/lib.schema";import{getExample as p0,listExamples as n0,searchExamples as c0}from"@contractspec/module.examples";import z from"zod";var m=["internal","mcp"],tj=["@contractspec"],a={docs:"/api/mcp/docs",cli:"/api/mcp/cli",internal:"/api/mcp/internal",graphql:"/graphql",health:"/health"};function i0(){let j=new l0;return j.register(Vj({meta:{uriTemplate:"examples://list{?q}",title:"ContractSpec examples registry",description:"List available examples (templates, integrations, knowledge, scripts). Optional query `q` filters results.",mimeType:"application/json",tags:["examples",...m]},input:z.object({q:z.string().optional()}),resolve:async({q:Y})=>{let J=Y?c0(Y):[...n0()];return{uri:Y?`examples://list?q=${encodeURIComponent(Y)}`:"examples://list",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),j.register(Vj({meta:{uriTemplate:"examples://example/{id}",title:"ContractSpec example (by id)",description:"Fetch a single example manifest by id.",mimeType:"application/json",tags:["examples",...m]},input:z.object({id:z.string().min(1)}),resolve:async({id:Y})=>{let J=p0(Y);if(!J)return{uri:`examples://example/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify({error:"not_found",id:Y,message:`Unknown example id: ${Y}`},null,2)};return{uri:`examples://example/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),j.register(Vj({meta:{uriTemplate:"internal://endpoints",title:"ContractSpec MCP endpoints",description:"Endpoints for docs, CLI, internal MCP servers.",mimeType:"application/json",tags:m},input:z.object({}),resolve:async()=>({uri:"internal://endpoints",mimeType:"application/json",data:JSON.stringify(a,null,2)})})),j.register(Vj({meta:{uriTemplate:"internal://playbook",title:"Internal MCP usage playbook",description:"How internal agents should discover docs, CLI usage, and endpoints.",mimeType:"text/markdown",tags:m},input:z.object({}),resolve:async()=>({uri:"internal://playbook",mimeType:"text/markdown",data:["# Internal MCP playbook","- Connect to docs MCP first for canonical specs.","- Use CLI MCP to surface quickstart/reference before running commands.","- Keep calls read-only unless explicitly approved.",`- Endpoints: ${a.docs}, ${a.cli}, ${a.internal}.`,"- For API work, GraphQL at /graphql; health at /health."].join(`
+`)})})),j}function a0(){let j=new d0;return j.register(m0({meta:{key:"internal_bootstrap",version:"1.0.0",title:"Bootstrap internal ContractSpec agent",description:"Points agents to the correct MCP endpoints and guardrails.",tags:m,owners:tj,stability:"beta"},args:[],input:z.object({}),render:async()=>[{type:"text",text:"Start with internal://endpoints to pick the right MCP. Use docs MCP for specifications and CLI MCP for commands. Keep actions read-only unless explicitly approved."},{type:"resource",uri:"internal://endpoints",title:"Endpoints"}]})),j}function o0(){let j=new u0,Y=aj({name:"InternalDescribeOutput",fields:{endpoints:{type:oj.JSONObject(),isOptional:!1},notes:{type:oj.String_unsecure(),isOptional:!1}}}),J=y0({meta:{key:"internal_describe",version:"1.0.0",stability:"stable",owners:tj,tags:m,description:"Return MCP endpoints and guidance for internal ContractSpec agents.",goal:"Speed up internal development with the correct MCP entrypoints.",context:"Used by internal MCP surface; read-only."},io:{input:aj({name:"InternalDescribeInput",fields:{}}),output:Y},policy:{auth:"anonymous"}});return g0(j,J,async()=>({endpoints:a,notes:"Use docs MCP for canonical specs, CLI MCP for contractspec commands, and keep side-effecting actions gated behind human review."})),j}function gQ(j="/api/mcp/internal"){return b({logger:M,path:j,serverName:"contractspec-internal-mcp",ops:o0(),resources:i0(),prompts:a0()})}import{getModelInfo as t0}from"@contractspec/lib.ai-providers/models";import{definePrompt as s0,defineResourceTemplate as Hj,installOp as Cj,OperationSpecRegistry as r0,PromptRegistry as e0,ResourceRegistry as jJ}from"@contractspec/lib.contracts-spec";import{BenchmarkIngestCommand as YJ,BenchmarkRunCustomCommand as JJ,RankingRefreshCommand as QJ}from"@contractspec/lib.contracts-spec/provider-ranking";import{InMemoryProviderRankingStore as ZJ}from"@contractspec/lib.provider-ranking/in-memory-store";import{createDefaultIngesterRegistry as $J}from"@contractspec/lib.provider-ranking/ingesters";import{computeModelRankings as XJ,normalizeBenchmarkResults as UJ}from"@contractspec/lib.provider-ranking/scoring";import L from"zod";var Bj=L.enum(["rest","mcp","webhook","sdk"]).optional(),wj=L.enum(["api-key","oauth2","bearer","header","basic","webhook-signing","service-account"]).optional(),o=["ranking","mcp","ai"],VJ=["platform.ai"],Kj=null;function g(){if(!Kj)Kj=new ZJ;return Kj}function HJ(){let j=new jJ;return j.register(Hj({meta:{uriTemplate:"ranking://leaderboard",title:"AI Model Leaderboard",description:"Current ranked list of AI models by composite score. Supports optional transport and authMethod query filters.",mimeType:"application/json",tags:o},input:L.object({transport:Bj,authMethod:wj}),resolve:async({transport:Y,authMethod:J})=>{let $=await g().listModelRankings({limit:100,requiredTransport:Y,requiredAuthMethod:J});return{uri:"ranking://leaderboard",mimeType:"application/json",data:JSON.stringify($,null,2)}}})),j.register(Hj({meta:{uriTemplate:"ranking://leaderboard/{dimension}",title:"AI Model Leaderboard by Dimension",description:"Ranked list of AI models filtered by a specific dimension. Supports optional transport and authMethod query filters.",mimeType:"application/json",tags:o},input:L.object({dimension:L.string(),transport:Bj,authMethod:wj}),resolve:async({dimension:Y,transport:J,authMethod:Q})=>{let Z=await g().listModelRankings({dimension:Y,limit:100,requiredTransport:J,requiredAuthMethod:Q});return{uri:`ranking://leaderboard/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify(Z,null,2)}}})),j.register(Hj({meta:{uriTemplate:"ranking://model/{modelId}",title:"AI Model Profile",description:"Detailed profile for a specific AI model including scores and benchmarks.",mimeType:"application/json",tags:o},input:L.object({modelId:L.string()}),resolve:async({modelId:Y})=>{let Q=await g().getModelProfile(Y);if(!Q)return{uri:`ranking://model/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify({error:"not_found",modelId:Y})};let $=Q.costPerMillion==null?(()=>{let Z=t0(Q.modelId);return Z?.costPerMillion?{...Q,costPerMillion:Z.costPerMillion,displayName:Z.name,contextWindow:Z.contextWindow,capabilities:[...Z.capabilities.vision?["vision"]:[],...Z.capabilities.tools?["tools"]:[],...Z.capabilities.reasoning?["reasoning"]:[],...Z.capabilities.streaming?["streaming"]:[]]}:Q})():Q;return{uri:`ranking://model/${encodeURIComponent(Y)}`,mimeType:"application/json",data:JSON.stringify($,null,2)}}})),j.register(Hj({meta:{uriTemplate:"ranking://results",title:"Benchmark Results",description:"List of raw benchmark results from all ingested sources.",mimeType:"application/json",tags:o},input:L.object({}),resolve:async()=>{let J=await g().listBenchmarkResults({limit:200});return{uri:"ranking://results",mimeType:"application/json",data:JSON.stringify(J,null,2)}}})),j}function KJ(){let j=new e0;return j.register(s0({meta:{key:"ranking.advisor",version:"1.0.0",title:"AI Model Advisor",description:"Which AI model is best for a given task? Uses the leaderboard to recommend.",tags:o,stability:"beta",owners:VJ},args:[{name:"task",description:"The task or use case to recommend a model for.",required:!0,schema:L.string()},{name:"priority",description:"Priority dimension (coding, reasoning, cost, latency, etc.).",required:!1,schema:L.string().optional()},{name:"transport",description:"Required transport type (rest, mcp, webhook, sdk).",required:!1,schema:Bj},{name:"authMethod",description:"Required auth method (api-key, oauth2, bearer, etc.).",required:!1,schema:wj}],input:L.object({task:L.string(),priority:L.string().optional(),transport:Bj,authMethod:wj}),render:async({task:Y,priority:J,transport:Q,authMethod:$})=>{let Z=[];if(J)Z.push(`Prioritize: ${J}.`);if(Q)Z.push(`Required transport: ${Q}.`);if($)Z.push(`Required auth: ${$}.`);return[{type:"text",text:`Recommend the best AI model for: "${Y}".${Z.length?` ${Z.join(" ")}`:""} Use the leaderboard data to justify your recommendation.`},{type:"resource",uri:J?`ranking://leaderboard/${J}`:"ranking://leaderboard",title:"Leaderboard"}]}})),j}function BJ(){let j=new r0,Y=$J();return Cj(j,YJ,async(J)=>{let Q=g(),$=J.source,Z=Y.get($);if(!Z)throw Error(`No ingester registered for source: ${$}`);let X=await Z.ingest({sourceUrl:J.sourceUrl,dimensions:J.dimensions}),U=UJ(X);for(let K of U)await Q.upsertBenchmarkResult(K);return{ingestionId:`ingest-${$}-${Date.now()}`,source:$,resultsCount:U.length,status:"completed",ingestedAt:new Date}}),Cj(j,JJ,async(J)=>{return{runId:`custom-${Date.now()}`,evalSuiteKey:J.evalSuiteKey,modelId:J.modelId,status:"started",startedAt:new Date}}),Cj(j,QJ,async(J)=>{let Q=g(),$=[],Z=0,X=500;while(!0){let V=await Q.listBenchmarkResults({limit:X,offset:Z});if($.push(...V.results),$.length>=V.total||V.results.length<X)break;Z+=X}let U=new Map((await Q.listModelRankings({limit:1e4})).rankings.map((V)=>[V.modelId,V])),K=J.weightOverrides?Array.isArray(J.weightOverrides)?J.weightOverrides:[J.weightOverrides]:void 0,P=XJ($,K?{weightOverrides:K}:void 0,U);for(let V of P)await Q.upsertModelRanking(V);return{modelsRanked:P.length,updatedAt:new Date,status:"completed"}}),j}function sQ(j="/api/mcp/ranking"){return b({logger:M,path:j,serverName:"contractspec-ranking-mcp",ops:BJ(),resources:HJ(),prompts:KJ()})}function rQ(j){Kj=j}export{rQ as setProviderRankingStore,sQ as createProviderRankingMcpHandler,gQ as createInternalMcpHandler,RQ as createDocsMcpHandler,oJ as createContractsMcpHandler,xJ as createContextStorageService,SJ as createCliMcpHandler};