executable-stories-mcp 0.2.0

package/dist/server.js

@@ -0,0 +1,332 @@
+#!/usr/bin/env node
+
+// src/server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// src/index.ts
+import * as fs from "fs";
+import * as path from "path";
+import { spawn } from "child_process";
+import {
+  diffStoryReports,
+  scenariosCoveringPaths,
+  toBehaviorManifest,
+  toScenarioIndex
+} from "executable-stories-formatters";
+function loadStoryReport(reportPath) {
+  const absolutePath = path.resolve(reportPath);
+  const parsed = JSON.parse(fs.readFileSync(absolutePath, "utf8"));
+  assertStoryReport(parsed, absolutePath);
+  return parsed;
+}
+function listScenarios(report, filters) {
+  return toScenarioIndex(report, filters).scenarios;
+}
+function getFailingScenarios(report) {
+  return listScenarios(report, { statuses: ["failed"] });
+}
+function getScenariosForPaths(report, paths) {
+  return scenariosCoveringPaths(toScenarioIndex(report), paths);
+}
+function getBehaviorDiff(baseline, current) {
+  return diffStoryReports(baseline, current);
+}
+function getScenario(report, idOrTitle) {
+  for (const feature of report.features) {
+    const scenario = feature.scenarios.find(
+      (candidate) => candidate.id === idOrTitle || candidate.title === idOrTitle
+    );
+    if (scenario) return { feature, scenario };
+  }
+  return void 0;
+}
+function getFeatureSummary(report) {
+  return report.features.map((feature) => ({
+    id: feature.id,
+    title: feature.title,
+    sourceFile: feature.sourceFile,
+    total: feature.summary.total,
+    passed: feature.summary.passed,
+    failed: feature.summary.failed,
+    skipped: feature.summary.skipped,
+    pending: feature.summary.pending,
+    durationMs: feature.summary.durationMs
+  }));
+}
+function resolveReportPath(reportPath) {
+  return path.resolve(reportPath ?? "reports/index.story-report.json");
+}
+function getScenarioIndex(report) {
+  return toScenarioIndex(report);
+}
+function getBehaviorManifest(report) {
+  return toBehaviorManifest(report);
+}
+var readOnlyTools = [
+  {
+    name: "get_failing_scenarios",
+    title: "Get failing scenarios",
+    description: "List failing executable story scenarios from StoryReport JSON.",
+    route: "/scenarios/failing",
+    run: getFailingScenarios
+  },
+  {
+    name: "get_feature_summary",
+    title: "Get feature summary",
+    description: "Summarize features and scenario status counts from StoryReport JSON.",
+    route: "/features",
+    run: getFeatureSummary
+  },
+  {
+    name: "get_scenario_index",
+    title: "Get scenario index",
+    description: "Return the Storybook-like scenario index artifact (schema v1) derived from StoryReport JSON.",
+    route: "/scenarios-index",
+    run: getScenarioIndex
+  },
+  {
+    name: "get_behavior_manifest",
+    title: "Get behavior manifest",
+    description: "Return agent-oriented manifest metadata: source files, tags, doc coverage, debugger warnings.",
+    route: "/manifest",
+    run: getBehaviorManifest
+  }
+];
+var RUNNERS = {
+  vitest: {
+    framework: "vitest",
+    buildCommand: ({ sourceFile, scenarioTitle }) => ({
+      command: "pnpm",
+      args: ["exec", "vitest", "run", sourceFile, ...scenarioTitle ? ["-t", scenarioTitle] : []]
+    })
+  },
+  jest: {
+    framework: "jest",
+    buildCommand: ({ sourceFile, scenarioTitle }) => ({
+      command: "pnpm",
+      args: ["exec", "jest", sourceFile, ...scenarioTitle ? ["-t", scenarioTitle] : [], "--runInBand"]
+    })
+  },
+  playwright: {
+    framework: "playwright",
+    detect: (sourceFile) => sourceFile.includes(".story.spec."),
+    buildCommand: ({ sourceFile, scenarioTitle }) => ({
+      command: "pnpm",
+      args: ["exec", "playwright", "test", sourceFile, ...scenarioTitle ? ["-g", scenarioTitle] : []]
+    })
+  },
+  cypress: {
+    framework: "cypress",
+    detect: (sourceFile) => sourceFile.includes(".story.cy."),
+    buildCommand: ({ sourceFile }) => ({
+      command: "pnpm",
+      args: ["exec", "cypress", "run", "--spec", sourceFile]
+    })
+  }
+};
+function inferFrameworkFromSourceFile(sourceFile) {
+  for (const runner of Object.values(RUNNERS)) {
+    if (runner.detect?.(sourceFile)) return runner.framework;
+  }
+  return void 0;
+}
+function resolveFocusedRunFramework(args) {
+  if (args.framework) return args.framework;
+  const inferred = inferFrameworkFromSourceFile(args.sourceFile);
+  if (inferred) return inferred;
+  throw new Error(
+    `Could not infer test framework from ${args.sourceFile}. Pass framework: vitest | jest | playwright | cypress.`
+  );
+}
+function buildFocusedRunCommand(args) {
+  return RUNNERS[args.framework].buildCommand(args);
+}
+async function runFocusedScenario(args) {
+  const command = buildFocusedRunCommand(args);
+  const spawnFn = args.spawnFn ?? spawn;
+  return new Promise((resolve2) => {
+    const child = spawnFn(command.command, command.args, {
+      cwd: args.cwd,
+      env: process.env
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (chunk) => {
+      stdout += String(chunk);
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += String(chunk);
+    });
+    child.on("error", (error) => {
+      resolve2({
+        ok: false,
+        exitCode: null,
+        command: command.command,
+        args: command.args,
+        stdout,
+        stderr: stderr + error.message
+      });
+    });
+    child.on("close", (exitCode) => {
+      resolve2({
+        ok: exitCode === 0,
+        exitCode,
+        command: command.command,
+        args: command.args,
+        stdout,
+        stderr
+      });
+    });
+  });
+}
+function assertStoryReport(value, reportPath) {
+  if (!value || typeof value !== "object") {
+    throw new Error(`Invalid StoryReport JSON in ${reportPath}: expected object`);
+  }
+  const report = value;
+  if (typeof report.schemaVersion !== "string" || !report.schemaVersion.startsWith("1.")) {
+    throw new Error(
+      `Invalid StoryReport JSON in ${reportPath}: expected schemaVersion 1.x`
+    );
+  }
+  if (!Array.isArray(report.features)) {
+    throw new Error(`Invalid StoryReport JSON in ${reportPath}: expected features array`);
+  }
+}
+
+// src/server.ts
+var reportPathSchema = {
+  reportPath: z.string().optional().describe("Path to StoryReport JSON. Defaults to reports/index.story-report.json.")
+};
+var filterSchema = {
+  ...reportPathSchema,
+  statuses: z.array(z.enum(["passed", "failed", "skipped", "pending"])).optional().describe("Filter by scenario status (any match)."),
+  tags: z.array(z.string()).optional().describe("Filter by tag (any match)."),
+  sourceFiles: z.array(z.string()).optional().describe("Filter by source file substring/glob (any match).")
+};
+var frameworkSchema = z.enum(["vitest", "jest", "playwright", "cypress"]).optional().describe("Host test framework. Inferred from source file when possible.");
+var server = new McpServer({
+  name: "executable-stories",
+  version: "0.2.0"
+});
+for (const tool of readOnlyTools) {
+  server.registerTool(
+    tool.name,
+    {
+      title: tool.title,
+      description: tool.description,
+      inputSchema: reportPathSchema
+    },
+    async ({ reportPath }) => json(tool.run(loadStoryReport(resolveReportPath(reportPath))))
+  );
+}
+server.registerTool(
+  "list_scenarios",
+  {
+    title: "List scenarios",
+    description: "List executable story scenarios, optionally filtered by status, tag, or source file.",
+    inputSchema: filterSchema
+  },
+  async ({ reportPath, statuses, tags, sourceFiles }) => json(
+    listScenarios(loadStoryReport(resolveReportPath(reportPath)), {
+      statuses,
+      tags,
+      sourceFiles
+    })
+  )
+);
+server.registerTool(
+  "get_scenarios_for_paths",
+  {
+    title: "Get scenarios for paths",
+    description: "Find scenarios whose declared `covers` globs match the given product-code paths (e.g. a changed-file list).",
+    inputSchema: {
+      ...reportPathSchema,
+      paths: z.array(z.string()).min(1).describe("Product-code paths or globs to look up.")
+    }
+  },
+  async ({ reportPath, paths }) => json(getScenariosForPaths(loadStoryReport(resolveReportPath(reportPath)), paths))
+);
+server.registerTool(
+  "get_behavior_diff",
+  {
+    title: "Get behavior diff",
+    description: "Compare two StoryReports by scenario id: regressed, fixed, added, removed, changed, unchanged.",
+    inputSchema: {
+      baselineReportPath: z.string().describe("Path to the baseline StoryReport JSON."),
+      currentReportPath: z.string().optional().describe("Path to the current StoryReport JSON. Defaults to the standard report path.")
+    }
+  },
+  async ({ baselineReportPath, currentReportPath }) => json(
+    getBehaviorDiff(
+      loadStoryReport(resolveReportPath(baselineReportPath)),
+      loadStoryReport(resolveReportPath(currentReportPath))
+    )
+  )
+);
+server.registerTool(
+  "get_scenario",
+  {
+    title: "Get scenario",
+    description: "Get one scenario by StoryReport scenario id or exact title.",
+    inputSchema: {
+      ...reportPathSchema,
+      idOrTitle: z.string().describe("Scenario id or exact scenario title.")
+    }
+  },
+  async ({ reportPath, idOrTitle }) => {
+    const report = loadStoryReport(resolveReportPath(reportPath));
+    const lookup = getScenario(report, idOrTitle);
+    if (!lookup) {
+      return json({ error: `Scenario not found: ${idOrTitle}` });
+    }
+    return json(lookup);
+  }
+);
+server.registerTool(
+  "run_scenario",
+  {
+    title: "Run scenario",
+    description: "Run one scenario through the host test framework (vitest, jest, playwright, or cypress). Executes real tests.",
+    inputSchema: {
+      ...reportPathSchema,
+      idOrTitle: z.string().describe("Scenario id or exact scenario title."),
+      framework: frameworkSchema,
+      cwd: z.string().optional().describe("Working directory for the test command. Defaults to process.cwd().")
+    }
+  },
+  async ({ reportPath, idOrTitle, framework, cwd }) => {
+    const report = loadStoryReport(resolveReportPath(reportPath));
+    const lookup = getScenario(report, idOrTitle);
+    if (!lookup) {
+      return json({ error: `Scenario not found: ${idOrTitle}` });
+    }
+    const sourceFile = lookup.feature.sourceFile;
+    const resolvedFramework = resolveFocusedRunFramework({ sourceFile, framework });
+    const result = await runFocusedScenario({
+      framework: resolvedFramework,
+      sourceFile,
+      scenarioTitle: lookup.scenario.title,
+      cwd: cwd ?? process.cwd()
+    });
+    return json({
+      scenario: {
+        id: lookup.scenario.id,
+        title: lookup.scenario.title,
+        sourceFile
+      },
+      framework: resolvedFramework,
+      ...result
+    });
+  }
+);
+var transport = new StdioServerTransport();
+await server.connect(transport);
+function json(value) {
+  return {
+    content: [{ type: "text", text: JSON.stringify(value, null, 2) }]
+  };
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts","../src/index.ts"],"sourcesContent":["import { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { z } from \"zod\";\n\nimport {\n  getBehaviorDiff,\n  getScenario,\n  getScenariosForPaths,\n  listScenarios,\n  loadStoryReport,\n  readOnlyTools,\n  resolveFocusedRunFramework,\n  resolveReportPath,\n  runFocusedScenario,\n} from \"./index.js\";\n\nconst reportPathSchema = {\n  reportPath: z\n    .string()\n    .optional()\n    .describe(\"Path to StoryReport JSON. Defaults to reports/index.story-report.json.\"),\n};\n\nconst filterSchema = {\n  ...reportPathSchema,\n  statuses: z\n    .array(z.enum([\"passed\", \"failed\", \"skipped\", \"pending\"]))\n    .optional()\n    .describe(\"Filter by scenario status (any match).\"),\n  tags: z.array(z.string()).optional().describe(\"Filter by tag (any match).\"),\n  sourceFiles: z\n    .array(z.string())\n    .optional()\n    .describe(\"Filter by source file substring/glob (any match).\"),\n};\n\nconst frameworkSchema = z\n  .enum([\"vitest\", \"jest\", \"playwright\", \"cypress\"])\n  .optional()\n  .describe(\"Host test framework. Inferred from source file when possible.\");\n\nconst server = new McpServer({\n  name: \"executable-stories\",\n  version: \"0.2.0\",\n});\n\nfor (const tool of readOnlyTools) {\n  server.registerTool(\n    tool.name,\n    {\n      title: tool.title,\n      description: tool.description,\n      inputSchema: reportPathSchema,\n    },\n    async ({ reportPath }) =>\n      json(tool.run(loadStoryReport(resolveReportPath(reportPath)))),\n  );\n}\n\nserver.registerTool(\n  \"list_scenarios\",\n  {\n    title: \"List scenarios\",\n    description: \"List executable story scenarios, optionally filtered by status, tag, or source file.\",\n    inputSchema: filterSchema,\n  },\n  async ({ reportPath, statuses, tags, sourceFiles }) =>\n    json(\n      listScenarios(loadStoryReport(resolveReportPath(reportPath)), {\n        statuses,\n        tags,\n        sourceFiles,\n      }),\n    ),\n);\n\nserver.registerTool(\n  \"get_scenarios_for_paths\",\n  {\n    title: \"Get scenarios for paths\",\n    description:\n      \"Find scenarios whose declared `covers` globs match the given product-code paths (e.g. a changed-file list).\",\n    inputSchema: {\n      ...reportPathSchema,\n      paths: z.array(z.string()).min(1).describe(\"Product-code paths or globs to look up.\"),\n    },\n  },\n  async ({ reportPath, paths }) =>\n    json(getScenariosForPaths(loadStoryReport(resolveReportPath(reportPath)), paths)),\n);\n\nserver.registerTool(\n  \"get_behavior_diff\",\n  {\n    title: \"Get behavior diff\",\n    description:\n      \"Compare two StoryReports by scenario id: regressed, fixed, added, removed, changed, unchanged.\",\n    inputSchema: {\n      baselineReportPath: z.string().describe(\"Path to the baseline StoryReport JSON.\"),\n      currentReportPath: z\n        .string()\n        .optional()\n        .describe(\"Path to the current StoryReport JSON. Defaults to the standard report path.\"),\n    },\n  },\n  async ({ baselineReportPath, currentReportPath }) =>\n    json(\n      getBehaviorDiff(\n        loadStoryReport(resolveReportPath(baselineReportPath)),\n        loadStoryReport(resolveReportPath(currentReportPath)),\n      ),\n    ),\n);\n\nserver.registerTool(\n  \"get_scenario\",\n  {\n    title: \"Get scenario\",\n    description: \"Get one scenario by StoryReport scenario id or exact title.\",\n    inputSchema: {\n      ...reportPathSchema,\n      idOrTitle: z.string().describe(\"Scenario id or exact scenario title.\"),\n    },\n  },\n  async ({ reportPath, idOrTitle }) => {\n    const report = loadStoryReport(resolveReportPath(reportPath));\n    const lookup = getScenario(report, idOrTitle);\n    if (!lookup) {\n      return json({ error: `Scenario not found: ${idOrTitle}` });\n    }\n    return json(lookup);\n  },\n);\n\nserver.registerTool(\n  \"run_scenario\",\n  {\n    title: \"Run scenario\",\n    description:\n      \"Run one scenario through the host test framework (vitest, jest, playwright, or cypress). Executes real tests.\",\n    inputSchema: {\n      ...reportPathSchema,\n      idOrTitle: z.string().describe(\"Scenario id or exact scenario title.\"),\n      framework: frameworkSchema,\n      cwd: z\n        .string()\n        .optional()\n        .describe(\"Working directory for the test command. Defaults to process.cwd().\"),\n    },\n  },\n  async ({ reportPath, idOrTitle, framework, cwd }) => {\n    const report = loadStoryReport(resolveReportPath(reportPath));\n    const lookup = getScenario(report, idOrTitle);\n    if (!lookup) {\n      return json({ error: `Scenario not found: ${idOrTitle}` });\n    }\n\n    const sourceFile = lookup.feature.sourceFile;\n    const resolvedFramework = resolveFocusedRunFramework({ sourceFile, framework });\n    const result = await runFocusedScenario({\n      framework: resolvedFramework,\n      sourceFile,\n      scenarioTitle: lookup.scenario.title,\n      cwd: cwd ?? process.cwd(),\n    });\n\n    return json({\n      scenario: {\n        id: lookup.scenario.id,\n        title: lookup.scenario.title,\n        sourceFile,\n      },\n      framework: resolvedFramework,\n      ...result,\n    });\n  },\n);\n\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\n\nfunction json(value: unknown): {\n  content: Array<{ type: \"text\"; text: string }>;\n} {\n  return {\n    content: [{ type: \"text\", text: JSON.stringify(value, null, 2) }],\n  };\n}\n","import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { spawn, type ChildProcessWithoutNullStreams } from \"node:child_process\";\n\nimport type {\n  ReportFeature,\n  ReportScenario,\n  StoryReport,\n  BehaviorManifest,\n  BehaviorDiff,\n  ScenarioIndex,\n  ScenarioIndexFilters,\n  ScenarioIndexItem,\n} from \"executable-stories-formatters\";\nimport {\n  diffStoryReports,\n  scenariosCoveringPaths,\n  toBehaviorManifest,\n  toScenarioIndex,\n} from \"executable-stories-formatters\";\n\n// Scenario serialization is owned by the formatters package; re-export so MCP\n// consumers get the same shape without a parallel definition to maintain.\nexport type { ScenarioIndexItem, ScenarioIndexFilters };\n\nexport interface FeatureSummaryItem {\n  id: string;\n  title: string;\n  sourceFile: string;\n  total: number;\n  passed: number;\n  failed: number;\n  skipped: number;\n  pending: number;\n  durationMs: number;\n}\n\nexport interface ScenarioLookup {\n  feature: ReportFeature;\n  scenario: ReportScenario;\n}\n\nexport function loadStoryReport(reportPath: string): StoryReport {\n  const absolutePath = path.resolve(reportPath);\n  const parsed: unknown = JSON.parse(fs.readFileSync(absolutePath, \"utf8\"));\n  assertStoryReport(parsed, absolutePath);\n  return parsed;\n}\n\nexport function listScenarios(\n  report: StoryReport,\n  filters?: ScenarioIndexFilters,\n): ScenarioIndexItem[] {\n  return toScenarioIndex(report, filters).scenarios;\n}\n\nexport function getFailingScenarios(report: StoryReport): ScenarioIndexItem[] {\n  return listScenarios(report, { statuses: [\"failed\"] });\n}\n\nexport function getScenariosForPaths(report: StoryReport, paths: string[]): ScenarioIndexItem[] {\n  return scenariosCoveringPaths(toScenarioIndex(report), paths);\n}\n\nexport function getBehaviorDiff(baseline: StoryReport, current: StoryReport): BehaviorDiff {\n  return diffStoryReports(baseline, current);\n}\n\nexport function getScenario(report: StoryReport, idOrTitle: string): ScenarioLookup | undefined {\n  for (const feature of report.features) {\n    const scenario = feature.scenarios.find(\n      (candidate) => candidate.id === idOrTitle || candidate.title === idOrTitle,\n    );\n    if (scenario) return { feature, scenario };\n  }\n  return undefined;\n}\n\nexport function getFeatureSummary(report: StoryReport): FeatureSummaryItem[] {\n  return report.features.map((feature) => ({\n    id: feature.id,\n    title: feature.title,\n    sourceFile: feature.sourceFile,\n    total: feature.summary.total,\n    passed: feature.summary.passed,\n    failed: feature.summary.failed,\n    skipped: feature.summary.skipped,\n    pending: feature.summary.pending,\n    durationMs: feature.summary.durationMs,\n  }));\n}\n\nexport function resolveReportPath(reportPath?: string): string {\n  return path.resolve(reportPath ?? \"reports/index.story-report.json\");\n}\n\nexport function getScenarioIndex(report: StoryReport): ScenarioIndex {\n  return toScenarioIndex(report);\n}\n\nexport function getBehaviorManifest(report: StoryReport): BehaviorManifest {\n  return toBehaviorManifest(report);\n}\n\n/**\n * Single source of truth for the read-only tools, consumed by both the stdio\n * MCP server and the HTTP server so the two transports cannot drift apart.\n * Tools needing extra arguments (get_scenario, run_scenario) are wired up\n * directly in each transport.\n */\nexport interface ReadOnlyTool {\n  /** MCP tool name. */\n  name: string;\n  /** Human-readable MCP tool title. */\n  title: string;\n  /** Shared description used by both transports. */\n  description: string;\n  /** HTTP route that exposes the same data. */\n  route: string;\n  /** Pure projection from a loaded report to its JSON payload. */\n  run: (report: StoryReport) => unknown;\n}\n\nexport const readOnlyTools: ReadOnlyTool[] = [\n  {\n    name: \"get_failing_scenarios\",\n    title: \"Get failing scenarios\",\n    description: \"List failing executable story scenarios from StoryReport JSON.\",\n    route: \"/scenarios/failing\",\n    run: getFailingScenarios,\n  },\n  {\n    name: \"get_feature_summary\",\n    title: \"Get feature summary\",\n    description: \"Summarize features and scenario status counts from StoryReport JSON.\",\n    route: \"/features\",\n    run: getFeatureSummary,\n  },\n  {\n    name: \"get_scenario_index\",\n    title: \"Get scenario index\",\n    description:\n      \"Return the Storybook-like scenario index artifact (schema v1) derived from StoryReport JSON.\",\n    route: \"/scenarios-index\",\n    run: getScenarioIndex,\n  },\n  {\n    name: \"get_behavior_manifest\",\n    title: \"Get behavior manifest\",\n    description:\n      \"Return agent-oriented manifest metadata: source files, tags, doc coverage, debugger warnings.\",\n    route: \"/manifest\",\n    run: getBehaviorManifest,\n  },\n];\n\nexport type FocusedRunFramework = \"vitest\" | \"jest\" | \"playwright\" | \"cypress\";\n\nexport interface FocusedRunCommandArgs {\n  framework: FocusedRunFramework;\n  sourceFile: string;\n  scenarioTitle?: string;\n}\n\nexport interface FocusedRunCommand {\n  command: string;\n  args: string[];\n}\n\nexport interface FocusedRunResult {\n  ok: boolean;\n  exitCode: number | null;\n  command: string;\n  args: string[];\n  stdout: string;\n  stderr: string;\n}\n\n/**\n * One runner per host framework. The seam that keeps `run_scenario` extensible:\n * adding a non-JS framework (go, cargo, pytest, dotnet) later is a single new\n * entry here — no changes to inference, command building, or the transports.\n */\nexport interface RunnerDefinition {\n  framework: FocusedRunFramework;\n  /** Infer this framework from a source-file path, when unambiguous. */\n  detect?: (sourceFile: string) => boolean;\n  /** Build the focused-run command for this framework. */\n  buildCommand: (args: { sourceFile: string; scenarioTitle?: string }) => FocusedRunCommand;\n}\n\nexport const RUNNERS: Record<FocusedRunFramework, RunnerDefinition> = {\n  vitest: {\n    framework: \"vitest\",\n    buildCommand: ({ sourceFile, scenarioTitle }) => ({\n      command: \"pnpm\",\n      args: [\"exec\", \"vitest\", \"run\", sourceFile, ...(scenarioTitle ? [\"-t\", scenarioTitle] : [])],\n    }),\n  },\n  jest: {\n    framework: \"jest\",\n    buildCommand: ({ sourceFile, scenarioTitle }) => ({\n      command: \"pnpm\",\n      args: [\"exec\", \"jest\", sourceFile, ...(scenarioTitle ? [\"-t\", scenarioTitle] : []), \"--runInBand\"],\n    }),\n  },\n  playwright: {\n    framework: \"playwright\",\n    detect: (sourceFile) => sourceFile.includes(\".story.spec.\"),\n    buildCommand: ({ sourceFile, scenarioTitle }) => ({\n      command: \"pnpm\",\n      args: [\"exec\", \"playwright\", \"test\", sourceFile, ...(scenarioTitle ? [\"-g\", scenarioTitle] : [])],\n    }),\n  },\n  cypress: {\n    framework: \"cypress\",\n    detect: (sourceFile) => sourceFile.includes(\".story.cy.\"),\n    buildCommand: ({ sourceFile }) => ({\n      command: \"pnpm\",\n      args: [\"exec\", \"cypress\", \"run\", \"--spec\", sourceFile],\n    }),\n  },\n};\n\nexport function inferFrameworkFromSourceFile(\n  sourceFile: string,\n): FocusedRunFramework | undefined {\n  for (const runner of Object.values(RUNNERS)) {\n    if (runner.detect?.(sourceFile)) return runner.framework;\n  }\n  return undefined;\n}\n\nexport function resolveFocusedRunFramework(args: {\n  sourceFile: string;\n  framework?: FocusedRunFramework;\n}): FocusedRunFramework {\n  if (args.framework) return args.framework;\n  const inferred = inferFrameworkFromSourceFile(args.sourceFile);\n  if (inferred) return inferred;\n  throw new Error(\n    `Could not infer test framework from ${args.sourceFile}. Pass framework: vitest | jest | playwright | cypress.`,\n  );\n}\n\nexport function buildFocusedRunCommand(args: FocusedRunCommandArgs): FocusedRunCommand {\n  return RUNNERS[args.framework].buildCommand(args);\n}\n\nexport async function runFocusedScenario(args: FocusedRunCommandArgs & {\n  cwd?: string;\n  spawnFn?: typeof spawn;\n}): Promise<FocusedRunResult> {\n  const command = buildFocusedRunCommand(args);\n  const spawnFn = args.spawnFn ?? spawn;\n\n  return new Promise((resolve) => {\n    const child = spawnFn(command.command, command.args, {\n      cwd: args.cwd,\n      env: process.env,\n    }) as ChildProcessWithoutNullStreams;\n    let stdout = \"\";\n    let stderr = \"\";\n\n    child.stdout.on(\"data\", (chunk) => {\n      stdout += String(chunk);\n    });\n    child.stderr.on(\"data\", (chunk) => {\n      stderr += String(chunk);\n    });\n    child.on(\"error\", (error) => {\n      resolve({\n        ok: false,\n        exitCode: null,\n        command: command.command,\n        args: command.args,\n        stdout,\n        stderr: stderr + error.message,\n      });\n    });\n    child.on(\"close\", (exitCode) => {\n      resolve({\n        ok: exitCode === 0,\n        exitCode,\n        command: command.command,\n        args: command.args,\n        stdout,\n        stderr,\n      });\n    });\n  });\n}\n\nfunction assertStoryReport(\n  value: unknown,\n  reportPath: string,\n): asserts value is StoryReport {\n  if (!value || typeof value !== \"object\") {\n    throw new Error(`Invalid StoryReport JSON in ${reportPath}: expected object`);\n  }\n  const report = value as Partial<StoryReport>;\n  if (typeof report.schemaVersion !== \"string\" || !report.schemaVersion.startsWith(\"1.\")) {\n    throw new Error(\n      `Invalid StoryReport JSON in ${reportPath}: expected schemaVersion 1.x`,\n    );\n  }\n  if (!Array.isArray(report.features)) {\n    throw new Error(`Invalid StoryReport JSON in ${reportPath}: expected features array`);\n  }\n}\n"],"mappings":";;;AAAA,SAAS,iBAAiB;AAC1B,SAAS,4BAA4B;AACrC,SAAS,SAAS;;;ACFlB,YAAY,QAAQ;AACpB,YAAY,UAAU;AACtB,SAAS,aAAkD;AAY3D;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAuBA,SAAS,gBAAgB,YAAiC;AAC/D,QAAM,eAAoB,aAAQ,UAAU;AAC5C,QAAM,SAAkB,KAAK,MAAS,gBAAa,cAAc,MAAM,CAAC;AACxE,oBAAkB,QAAQ,YAAY;AACtC,SAAO;AACT;AAEO,SAAS,cACd,QACA,SACqB;AACrB,SAAO,gBAAgB,QAAQ,OAAO,EAAE;AAC1C;AAEO,SAAS,oBAAoB,QAA0C;AAC5E,SAAO,cAAc,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,CAAC;AACvD;AAEO,SAAS,qBAAqB,QAAqB,OAAsC;AAC9F,SAAO,uBAAuB,gBAAgB,MAAM,GAAG,KAAK;AAC9D;AAEO,SAAS,gBAAgB,UAAuB,SAAoC;AACzF,SAAO,iBAAiB,UAAU,OAAO;AAC3C;AAEO,SAAS,YAAY,QAAqB,WAA+C;AAC9F,aAAW,WAAW,OAAO,UAAU;AACrC,UAAM,WAAW,QAAQ,UAAU;AAAA,MACjC,CAAC,cAAc,UAAU,OAAO,aAAa,UAAU,UAAU;AAAA,IACnE;AACA,QAAI,SAAU,QAAO,EAAE,SAAS,SAAS;AAAA,EAC3C;AACA,SAAO;AACT;AAEO,SAAS,kBAAkB,QAA2C;AAC3E,SAAO,OAAO,SAAS,IAAI,CAAC,aAAa;AAAA,IACvC,IAAI,QAAQ;AAAA,IACZ,OAAO,QAAQ;AAAA,IACf,YAAY,QAAQ;AAAA,IACpB,OAAO,QAAQ,QAAQ;AAAA,IACvB,QAAQ,QAAQ,QAAQ;AAAA,IACxB,QAAQ,QAAQ,QAAQ;AAAA,IACxB,SAAS,QAAQ,QAAQ;AAAA,IACzB,SAAS,QAAQ,QAAQ;AAAA,IACzB,YAAY,QAAQ,QAAQ;AAAA,EAC9B,EAAE;AACJ;AAEO,SAAS,kBAAkB,YAA6B;AAC7D,SAAY,aAAQ,cAAc,iCAAiC;AACrE;AAEO,SAAS,iBAAiB,QAAoC;AACnE,SAAO,gBAAgB,MAAM;AAC/B;AAEO,SAAS,oBAAoB,QAAuC;AACzE,SAAO,mBAAmB,MAAM;AAClC;AAqBO,IAAM,gBAAgC;AAAA,EAC3C;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,OAAO;AAAA,IACP,KAAK;AAAA,EACP;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aAAa;AAAA,IACb,OAAO;AAAA,IACP,KAAK;AAAA,EACP;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aACE;AAAA,IACF,OAAO;AAAA,IACP,KAAK;AAAA,EACP;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,OAAO;AAAA,IACP,aACE;AAAA,IACF,OAAO;AAAA,IACP,KAAK;AAAA,EACP;AACF;AAqCO,IAAM,UAAyD;AAAA,EACpE,QAAQ;AAAA,IACN,WAAW;AAAA,IACX,cAAc,CAAC,EAAE,YAAY,cAAc,OAAO;AAAA,MAChD,SAAS;AAAA,MACT,MAAM,CAAC,QAAQ,UAAU,OAAO,YAAY,GAAI,gBAAgB,CAAC,MAAM,aAAa,IAAI,CAAC,CAAE;AAAA,IAC7F;AAAA,EACF;AAAA,EACA,MAAM;AAAA,IACJ,WAAW;AAAA,IACX,cAAc,CAAC,EAAE,YAAY,cAAc,OAAO;AAAA,MAChD,SAAS;AAAA,MACT,MAAM,CAAC,QAAQ,QAAQ,YAAY,GAAI,gBAAgB,CAAC,MAAM,aAAa,IAAI,CAAC,GAAI,aAAa;AAAA,IACnG;AAAA,EACF;AAAA,EACA,YAAY;AAAA,IACV,WAAW;AAAA,IACX,QAAQ,CAAC,eAAe,WAAW,SAAS,cAAc;AAAA,IAC1D,cAAc,CAAC,EAAE,YAAY,cAAc,OAAO;AAAA,MAChD,SAAS;AAAA,MACT,MAAM,CAAC,QAAQ,cAAc,QAAQ,YAAY,GAAI,gBAAgB,CAAC,MAAM,aAAa,IAAI,CAAC,CAAE;AAAA,IAClG;AAAA,EACF;AAAA,EACA,SAAS;AAAA,IACP,WAAW;AAAA,IACX,QAAQ,CAAC,eAAe,WAAW,SAAS,YAAY;AAAA,IACxD,cAAc,CAAC,EAAE,WAAW,OAAO;AAAA,MACjC,SAAS;AAAA,MACT,MAAM,CAAC,QAAQ,WAAW,OAAO,UAAU,UAAU;AAAA,IACvD;AAAA,EACF;AACF;AAEO,SAAS,6BACd,YACiC;AACjC,aAAW,UAAU,OAAO,OAAO,OAAO,GAAG;AAC3C,QAAI,OAAO,SAAS,UAAU,EAAG,QAAO,OAAO;AAAA,EACjD;AACA,SAAO;AACT;AAEO,SAAS,2BAA2B,MAGnB;AACtB,MAAI,KAAK,UAAW,QAAO,KAAK;AAChC,QAAM,WAAW,6BAA6B,KAAK,UAAU;AAC7D,MAAI,SAAU,QAAO;AACrB,QAAM,IAAI;AAAA,IACR,uCAAuC,KAAK,UAAU;AAAA,EACxD;AACF;AAEO,SAAS,uBAAuB,MAAgD;AACrF,SAAO,QAAQ,KAAK,SAAS,EAAE,aAAa,IAAI;AAClD;AAEA,eAAsB,mBAAmB,MAGX;AAC5B,QAAM,UAAU,uBAAuB,IAAI;AAC3C,QAAM,UAAU,KAAK,WAAW;AAEhC,SAAO,IAAI,QAAQ,CAACA,aAAY;AAC9B,UAAM,QAAQ,QAAQ,QAAQ,SAAS,QAAQ,MAAM;AAAA,MACnD,KAAK,KAAK;AAAA,MACV,KAAK,QAAQ;AAAA,IACf,CAAC;AACD,QAAI,SAAS;AACb,QAAI,SAAS;AAEb,UAAM,OAAO,GAAG,QAAQ,CAAC,UAAU;AACjC,gBAAU,OAAO,KAAK;AAAA,IACxB,CAAC;AACD,UAAM,OAAO,GAAG,QAAQ,CAAC,UAAU;AACjC,gBAAU,OAAO,KAAK;AAAA,IACxB,CAAC;AACD,UAAM,GAAG,SAAS,CAAC,UAAU;AAC3B,MAAAA,SAAQ;AAAA,QACN,IAAI;AAAA,QACJ,UAAU;AAAA,QACV,SAAS,QAAQ;AAAA,QACjB,MAAM,QAAQ;AAAA,QACd;AAAA,QACA,QAAQ,SAAS,MAAM;AAAA,MACzB,CAAC;AAAA,IACH,CAAC;AACD,UAAM,GAAG,SAAS,CAAC,aAAa;AAC9B,MAAAA,SAAQ;AAAA,QACN,IAAI,aAAa;AAAA,QACjB;AAAA,QACA,SAAS,QAAQ;AAAA,QACjB,MAAM,QAAQ;AAAA,QACd;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH,CAAC;AACH;AAEA,SAAS,kBACP,OACA,YAC8B;AAC9B,MAAI,CAAC,SAAS,OAAO,UAAU,UAAU;AACvC,UAAM,IAAI,MAAM,+BAA+B,UAAU,mBAAmB;AAAA,EAC9E;AACA,QAAM,SAAS;AACf,MAAI,OAAO,OAAO,kBAAkB,YAAY,CAAC,OAAO,cAAc,WAAW,IAAI,GAAG;AACtF,UAAM,IAAI;AAAA,MACR,+BAA+B,UAAU;AAAA,IAC3C;AAAA,EACF;AACA,MAAI,CAAC,MAAM,QAAQ,OAAO,QAAQ,GAAG;AACnC,UAAM,IAAI,MAAM,+BAA+B,UAAU,2BAA2B;AAAA,EACtF;AACF;;;ADrSA,IAAM,mBAAmB;AAAA,EACvB,YAAY,EACT,OAAO,EACP,SAAS,EACT,SAAS,wEAAwE;AACtF;AAEA,IAAM,eAAe;AAAA,EACnB,GAAG;AAAA,EACH,UAAU,EACP,MAAM,EAAE,KAAK,CAAC,UAAU,UAAU,WAAW,SAAS,CAAC,CAAC,EACxD,SAAS,EACT,SAAS,wCAAwC;AAAA,EACpD,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,EAAE,SAAS,4BAA4B;AAAA,EAC1E,aAAa,EACV,MAAM,EAAE,OAAO,CAAC,EAChB,SAAS,EACT,SAAS,mDAAmD;AACjE;AAEA,IAAM,kBAAkB,EACrB,KAAK,CAAC,UAAU,QAAQ,cAAc,SAAS,CAAC,EAChD,SAAS,EACT,SAAS,+DAA+D;AAE3E,IAAM,SAAS,IAAI,UAAU;AAAA,EAC3B,MAAM;AAAA,EACN,SAAS;AACX,CAAC;AAED,WAAW,QAAQ,eAAe;AAChC,SAAO;AAAA,IACL,KAAK;AAAA,IACL;AAAA,MACE,OAAO,KAAK;AAAA,MACZ,aAAa,KAAK;AAAA,MAClB,aAAa;AAAA,IACf;AAAA,IACA,OAAO,EAAE,WAAW,MAClB,KAAK,KAAK,IAAI,gBAAgB,kBAAkB,UAAU,CAAC,CAAC,CAAC;AAAA,EACjE;AACF;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,EACf;AAAA,EACA,OAAO,EAAE,YAAY,UAAU,MAAM,YAAY,MAC/C;AAAA,IACE,cAAc,gBAAgB,kBAAkB,UAAU,CAAC,GAAG;AAAA,MAC5D;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AACJ;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,aACE;AAAA,IACF,aAAa;AAAA,MACX,GAAG;AAAA,MACH,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,yCAAyC;AAAA,IACtF;AAAA,EACF;AAAA,EACA,OAAO,EAAE,YAAY,MAAM,MACzB,KAAK,qBAAqB,gBAAgB,kBAAkB,UAAU,CAAC,GAAG,KAAK,CAAC;AACpF;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,aACE;AAAA,IACF,aAAa;AAAA,MACX,oBAAoB,EAAE,OAAO,EAAE,SAAS,wCAAwC;AAAA,MAChF,mBAAmB,EAChB,OAAO,EACP,SAAS,EACT,SAAS,6EAA6E;AAAA,IAC3F;AAAA,EACF;AAAA,EACA,OAAO,EAAE,oBAAoB,kBAAkB,MAC7C;AAAA,IACE;AAAA,MACE,gBAAgB,kBAAkB,kBAAkB,CAAC;AAAA,MACrD,gBAAgB,kBAAkB,iBAAiB,CAAC;AAAA,IACtD;AAAA,EACF;AACJ;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,aAAa;AAAA,IACb,aAAa;AAAA,MACX,GAAG;AAAA,MACH,WAAW,EAAE,OAAO,EAAE,SAAS,sCAAsC;AAAA,IACvE;AAAA,EACF;AAAA,EACA,OAAO,EAAE,YAAY,UAAU,MAAM;AACnC,UAAM,SAAS,gBAAgB,kBAAkB,UAAU,CAAC;AAC5D,UAAM,SAAS,YAAY,QAAQ,SAAS;AAC5C,QAAI,CAAC,QAAQ;AACX,aAAO,KAAK,EAAE,OAAO,uBAAuB,SAAS,GAAG,CAAC;AAAA,IAC3D;AACA,WAAO,KAAK,MAAM;AAAA,EACpB;AACF;AAEA,OAAO;AAAA,EACL;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,aACE;AAAA,IACF,aAAa;AAAA,MACX,GAAG;AAAA,MACH,WAAW,EAAE,OAAO,EAAE,SAAS,sCAAsC;AAAA,MACrE,WAAW;AAAA,MACX,KAAK,EACF,OAAO,EACP,SAAS,EACT,SAAS,oEAAoE;AAAA,IAClF;AAAA,EACF;AAAA,EACA,OAAO,EAAE,YAAY,WAAW,WAAW,IAAI,MAAM;AACnD,UAAM,SAAS,gBAAgB,kBAAkB,UAAU,CAAC;AAC5D,UAAM,SAAS,YAAY,QAAQ,SAAS;AAC5C,QAAI,CAAC,QAAQ;AACX,aAAO,KAAK,EAAE,OAAO,uBAAuB,SAAS,GAAG,CAAC;AAAA,IAC3D;AAEA,UAAM,aAAa,OAAO,QAAQ;AAClC,UAAM,oBAAoB,2BAA2B,EAAE,YAAY,UAAU,CAAC;AAC9E,UAAM,SAAS,MAAM,mBAAmB;AAAA,MACtC,WAAW;AAAA,MACX;AAAA,MACA,eAAe,OAAO,SAAS;AAAA,MAC/B,KAAK,OAAO,QAAQ,IAAI;AAAA,IAC1B,CAAC;AAED,WAAO,KAAK;AAAA,MACV,UAAU;AAAA,QACR,IAAI,OAAO,SAAS;AAAA,QACpB,OAAO,OAAO,SAAS;AAAA,QACvB;AAAA,MACF;AAAA,MACA,WAAW;AAAA,MACX,GAAG;AAAA,IACL,CAAC;AAAA,EACH;AACF;AAEA,IAAM,YAAY,IAAI,qBAAqB;AAC3C,MAAM,OAAO,QAAQ,SAAS;AAE9B,SAAS,KAAK,OAEZ;AACA,SAAO;AAAA,IACL,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,OAAO,MAAM,CAAC,EAAE,CAAC;AAAA,EAClE;AACF;","names":["resolve"]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "executable-stories-mcp",
+  "version": "0.2.0",
+  "description": "Read-only MCP server for executable-stories StoryReport JSON behavior catalogs.",
+  "author": "Jag Reehal <jag@jagreehal.com>",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./http": {
+      "types": "./dist/http.d.ts",
+      "import": "./dist/http.js",
+      "require": "./dist/http.cjs"
+    }
+  },
+  "bin": {
+    "executable-stories-mcp": "./dist/server.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "eslint .",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "executable-stories-formatters": "workspace:*",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jagreehal/executable-stories.git",
+    "directory": "packages/executable-stories-mcp"
+  },
+  "keywords": [
+    "executable-stories",
+    "mcp",
+    "ai",
+    "bdd",
+    "living-documentation"
+  ]
+}