@canonical/pragma-cli 0.30.0 → 0.32.0

package/src/mcp/runMcpServer.test.ts

@@ -1,66 +0,0 @@
-import { spawnSync } from "node:child_process";
-import { resolve } from "node:path";
-import { afterEach, describe, expect, it, vi } from "vitest";
-
-const createMcpServerMock = vi.fn();
-
-vi.mock("./createMcpServer.js", () => ({
-  createMcpServer: createMcpServerMock,
-}));
-
-vi.mock("@modelcontextprotocol/sdk/server/stdio.js", () => ({
-  StdioServerTransport: class StdioServerTransport {},
-}));
-
-afterEach(() => {
-  vi.restoreAllMocks();
-  vi.clearAllMocks();
-});
-
-describe("runMcpServer", () => {
-  it("creates the server, connects stdio transport, and disposes on SIGINT", async () => {
-    const connect = vi.fn(async () => undefined);
-    const dispose = vi.fn();
-    createMcpServerMock.mockResolvedValue({
-      server: { connect },
-      dispose,
-    });
-
-    let sigintHandler: (() => void) | undefined;
-    vi.spyOn(process, "on").mockImplementation(((event, handler) => {
-      if (event === "SIGINT") sigintHandler = handler as () => void;
-      return process;
-    }) as typeof process.on);
-    const exitSpy = vi
-      .spyOn(process, "exit")
-      .mockImplementation((() => undefined) as never);
-
-    const { default: runMcpServer } = await import("./runMcpServer.js");
-    await runMcpServer();
-
-    expect(createMcpServerMock).toHaveBeenCalledTimes(1);
-    expect(connect).toHaveBeenCalledTimes(1);
-    expect(sigintHandler).toBeTypeOf("function");
-
-    sigintHandler?.();
-
-    expect(dispose).toHaveBeenCalledTimes(1);
-    expect(exitSpy).toHaveBeenCalledWith(0);
-  });
-
-  it("pragma mcp subcommand starts and exits on stdin close", () => {
-    const binPath = resolve(import.meta.dirname, "../bin.ts");
-    const result = spawnSync("bun", ["run", binPath, "mcp"], {
-      input: "",
-      encoding: "utf-8",
-      timeout: 20_000,
-    });
-
-    expect(result.error).toBeUndefined();
-    expect(result.signal).toBeNull();
-    if (result.status !== 0) {
-      console.error("pragma mcp stderr:", result.stderr);
-    }
-    expect(result.status).toBe(0);
-  }, 20_000);
-});

package/src/mcp/runMcpServer.ts

@@ -1,24 +0,0 @@
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createMcpServer } from "./createMcpServer.js";
-
-/**
- * Start the MCP server over stdio transport.
- *
- * Boots the pragma runtime, connects to stdin/stdout, and runs until the
- * process receives SIGINT or stdin closes.
- *
- * @returns Resolves when the transport connection is established.
- *
- * @note Impure
- */
-export default async function runMcpServer(): Promise<void> {
-  const { server, dispose } = await createMcpServer();
-  const transport = new StdioServerTransport();
-
-  process.on("SIGINT", () => {
-    dispose();
-    process.exit(0);
-  });
-
-  await server.connect(transport);
-}

package/src/mcp/tools/index.ts

@@ -1,66 +0,0 @@
-/**
- * MCP tool registration orchestrator.
- *
- * Collects declarative ToolSpec arrays from each domain and registers
- * them on the MCP server via the registerFromSpec adapter.
- *
- * @module
- */
-
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { specs as blockSpecs } from "../../domains/block/mcp/index.js";
-import { specs as configSpecs } from "../../domains/config/mcp/index.js";
-import { specs as createSpecs } from "../../domains/create/mcp/index.js";
-import { specs as diagnosticSpecs } from "../../domains/doctor/mcp/index.js";
-import { specs as graphSpecs } from "../../domains/graph/mcp/index.js";
-import { specs as infoSpecs } from "../../domains/info/mcp/index.js";
-import { specs as orientationSpecs } from "../../domains/llm/mcp/index.js";
-import { specs as modifierSpecs } from "../../domains/modifier/mcp/index.js";
-import { specs as ontologySpecs } from "../../domains/ontology/mcp/index.js";
-import type { PragmaRuntime } from "../../domains/shared/runtime.js";
-import { compilePackToolSpecs } from "../../domains/shared/stories/pack/index.js";
-import type { ToolSpec } from "../../domains/shared/ToolSpec.js";
-import { specs as skillSpecs } from "../../domains/skill/mcp/index.js";
-import { specs as standardSpecs } from "../../domains/standard/mcp/index.js";
-import { specs as tierSpecs } from "../../domains/tier/mcp/index.js";
-import { specs as tokenSpecs } from "../../domains/token/mcp/index.js";
-import registerFromSpec from "./registerFromSpec.js";
-
-const allSpecs: readonly ToolSpec[] = [
-  ...blockSpecs,
-  ...standardSpecs,
-  ...modifierSpecs,
-  ...tokenSpecs,
-  ...tierSpecs,
-  ...configSpecs,
-  ...ontologySpecs,
-  ...graphSpecs,
-  ...skillSpecs,
-  ...diagnosticSpecs,
-  ...infoSpecs,
-  ...orientationSpecs,
-  ...createSpecs,
-];
-
-/**
- * Register all MCP tools on the server.
- *
- * @param server - The MCP server to register tools on.
- * @param runtime - The pragma runtime providing store and config.
- */
-export default function registerAllTools(
-  server: McpServer,
-  runtime: PragmaRuntime,
-): void {
-  for (const spec of allSpecs) {
-    registerFromSpec(server, runtime, spec);
-  }
-
-  // Story packs project onto the same surface; built-in nouns are reserved.
-  const reservedNouns = new Set(
-    allSpecs.map((spec) => spec.name.split("_").at(0) ?? ""),
-  );
-  for (const spec of compilePackToolSpecs(runtime, reservedNouns)) {
-    registerFromSpec(server, runtime, spec);
-  }
-}

package/src/mcp/tools/registerFromSpec.ts

@@ -1,97 +0,0 @@
-/**
- * Adapter: ToolSpec → server.registerTool().
- *
- * Converts declarative domain-owned ToolSpecs into registered MCP tools.
- * This is the single point where ToolSpec meets MCP infrastructure —
- * zod schema generation, wrapTool envelope, and server registration.
- */
-
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
-import type { PragmaRuntime } from "../../domains/shared/runtime.js";
-import type { ToolParamDef, ToolSpec } from "../../domains/shared/ToolSpec.js";
-import type { ToolPayload } from "../types.js";
-import { wrapTool } from "../utils/index.js";
-
-/**
- * Convert a ToolParamDef record to a zod object schema.
- */
-function buildZodSchema(
-  params: Readonly<Record<string, ToolParamDef>>,
-): z.ZodObject<Record<string, z.ZodTypeAny>> {
-  const shape: Record<string, z.ZodTypeAny> = {};
-
-  for (const [name, def] of Object.entries(params)) {
-    let field: z.ZodTypeAny;
-
-    switch (def.type) {
-      case "boolean":
-        field = z.boolean();
-        break;
-      case "string[]":
-        field = z.array(z.string());
-        break;
-      case "string":
-        field = def.enum
-          ? z.enum(def.enum as [string, ...string[]])
-          : z.string();
-        break;
-    }
-
-    if (def.description) {
-      field = field.describe(def.description);
-    }
-    if (def.optional !== false) {
-      field = field.optional();
-    }
-
-    shape[name] = field;
-  }
-
-  return z.object(shape);
-}
-
-/**
- * Register a single ToolSpec on the MCP server.
- */
-export default function registerFromSpec(
-  server: McpServer,
-  runtime: PragmaRuntime,
-  spec: ToolSpec,
-): void {
-  const toolConfig: {
-    description: string;
-    inputSchema?: z.ZodObject<Record<string, z.ZodTypeAny>>;
-    annotations: {
-      readOnlyHint: boolean;
-      destructiveHint?: boolean;
-      openWorldHint: boolean;
-    };
-  } = {
-    description: spec.description,
-    annotations: {
-      readOnlyHint: spec.readOnly,
-      openWorldHint: false,
-    },
-  };
-
-  if (spec.params && Object.keys(spec.params).length > 0) {
-    toolConfig.inputSchema = buildZodSchema(spec.params);
-  }
-
-  if (spec.destructive !== undefined) {
-    toolConfig.annotations.destructiveHint = spec.destructive;
-  }
-
-  server.registerTool(
-    spec.name,
-    toolConfig,
-    wrapTool(
-      runtime,
-      spec.execute as (
-        rt: PragmaRuntime,
-        params: Record<string, unknown>,
-      ) => Promise<ToolPayload>,
-    ),
-  );
-}