executable-stories-mcp 0.2.0

package/dist/index.d.cts

@@ -0,0 +1,94 @@
+import { spawn } from 'node:child_process';
+import { StoryReport, ReportFeature, ReportScenario, BehaviorDiff, BehaviorManifest, ScenarioIndexItem, ScenarioIndex, ScenarioIndexFilters } from 'executable-stories-formatters';
+export { ScenarioIndexFilters, ScenarioIndexItem } from 'executable-stories-formatters';
+
+interface FeatureSummaryItem {
+    id: string;
+    title: string;
+    sourceFile: string;
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    pending: number;
+    durationMs: number;
+}
+interface ScenarioLookup {
+    feature: ReportFeature;
+    scenario: ReportScenario;
+}
+declare function loadStoryReport(reportPath: string): StoryReport;
+declare function listScenarios(report: StoryReport, filters?: ScenarioIndexFilters): ScenarioIndexItem[];
+declare function getFailingScenarios(report: StoryReport): ScenarioIndexItem[];
+declare function getScenariosForPaths(report: StoryReport, paths: string[]): ScenarioIndexItem[];
+declare function getBehaviorDiff(baseline: StoryReport, current: StoryReport): BehaviorDiff;
+declare function getScenario(report: StoryReport, idOrTitle: string): ScenarioLookup | undefined;
+declare function getFeatureSummary(report: StoryReport): FeatureSummaryItem[];
+declare function resolveReportPath(reportPath?: string): string;
+declare function getScenarioIndex(report: StoryReport): ScenarioIndex;
+declare function getBehaviorManifest(report: StoryReport): BehaviorManifest;
+/**
+ * Single source of truth for the read-only tools, consumed by both the stdio
+ * MCP server and the HTTP server so the two transports cannot drift apart.
+ * Tools needing extra arguments (get_scenario, run_scenario) are wired up
+ * directly in each transport.
+ */
+interface ReadOnlyTool {
+    /** MCP tool name. */
+    name: string;
+    /** Human-readable MCP tool title. */
+    title: string;
+    /** Shared description used by both transports. */
+    description: string;
+    /** HTTP route that exposes the same data. */
+    route: string;
+    /** Pure projection from a loaded report to its JSON payload. */
+    run: (report: StoryReport) => unknown;
+}
+declare const readOnlyTools: ReadOnlyTool[];
+type FocusedRunFramework = "vitest" | "jest" | "playwright" | "cypress";
+interface FocusedRunCommandArgs {
+    framework: FocusedRunFramework;
+    sourceFile: string;
+    scenarioTitle?: string;
+}
+interface FocusedRunCommand {
+    command: string;
+    args: string[];
+}
+interface FocusedRunResult {
+    ok: boolean;
+    exitCode: number | null;
+    command: string;
+    args: string[];
+    stdout: string;
+    stderr: string;
+}
+/**
+ * One runner per host framework. The seam that keeps `run_scenario` extensible:
+ * adding a non-JS framework (go, cargo, pytest, dotnet) later is a single new
+ * entry here — no changes to inference, command building, or the transports.
+ */
+interface RunnerDefinition {
+    framework: FocusedRunFramework;
+    /** Infer this framework from a source-file path, when unambiguous. */
+    detect?: (sourceFile: string) => boolean;
+    /** Build the focused-run command for this framework. */
+    buildCommand: (args: {
+        sourceFile: string;
+        scenarioTitle?: string;
+    }) => FocusedRunCommand;
+}
+declare const RUNNERS: Record<FocusedRunFramework, RunnerDefinition>;
+declare function inferFrameworkFromSourceFile(sourceFile: string): FocusedRunFramework | undefined;
+declare function resolveFocusedRunFramework(args: {
+    sourceFile: string;
+    framework?: FocusedRunFramework;
+}): FocusedRunFramework;
+declare function buildFocusedRunCommand(args: FocusedRunCommandArgs): FocusedRunCommand;
+declare function runFocusedScenario(args: FocusedRunCommandArgs & {
+    cwd?: string;
+    spawnFn?: typeof spawn;
+}): Promise<FocusedRunResult>;
+
+export { type FeatureSummaryItem, type FocusedRunCommand, type FocusedRunCommandArgs, type FocusedRunFramework, type FocusedRunResult, RUNNERS, type ReadOnlyTool, type RunnerDefinition, type ScenarioLookup, buildFocusedRunCommand, getBehaviorDiff, getBehaviorManifest, getFailingScenarios, getFeatureSummary, getScenario, getScenarioIndex, getScenariosForPaths, inferFrameworkFromSourceFile, listScenarios, loadStoryReport, readOnlyTools, resolveFocusedRunFramework, resolveReportPath, runFocusedScenario };

package/dist/index.d.ts

@@ -0,0 +1,94 @@
+import { spawn } from 'node:child_process';
+import { StoryReport, ReportFeature, ReportScenario, BehaviorDiff, BehaviorManifest, ScenarioIndexItem, ScenarioIndex, ScenarioIndexFilters } from 'executable-stories-formatters';
+export { ScenarioIndexFilters, ScenarioIndexItem } from 'executable-stories-formatters';
+
+interface FeatureSummaryItem {
+    id: string;
+    title: string;
+    sourceFile: string;
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    pending: number;
+    durationMs: number;
+}
+interface ScenarioLookup {
+    feature: ReportFeature;
+    scenario: ReportScenario;
+}
+declare function loadStoryReport(reportPath: string): StoryReport;
+declare function listScenarios(report: StoryReport, filters?: ScenarioIndexFilters): ScenarioIndexItem[];
+declare function getFailingScenarios(report: StoryReport): ScenarioIndexItem[];
+declare function getScenariosForPaths(report: StoryReport, paths: string[]): ScenarioIndexItem[];
+declare function getBehaviorDiff(baseline: StoryReport, current: StoryReport): BehaviorDiff;
+declare function getScenario(report: StoryReport, idOrTitle: string): ScenarioLookup | undefined;
+declare function getFeatureSummary(report: StoryReport): FeatureSummaryItem[];
+declare function resolveReportPath(reportPath?: string): string;
+declare function getScenarioIndex(report: StoryReport): ScenarioIndex;
+declare function getBehaviorManifest(report: StoryReport): BehaviorManifest;
+/**
+ * Single source of truth for the read-only tools, consumed by both the stdio
+ * MCP server and the HTTP server so the two transports cannot drift apart.
+ * Tools needing extra arguments (get_scenario, run_scenario) are wired up
+ * directly in each transport.
+ */
+interface ReadOnlyTool {
+    /** MCP tool name. */
+    name: string;
+    /** Human-readable MCP tool title. */
+    title: string;
+    /** Shared description used by both transports. */
+    description: string;
+    /** HTTP route that exposes the same data. */
+    route: string;
+    /** Pure projection from a loaded report to its JSON payload. */
+    run: (report: StoryReport) => unknown;
+}
+declare const readOnlyTools: ReadOnlyTool[];
+type FocusedRunFramework = "vitest" | "jest" | "playwright" | "cypress";
+interface FocusedRunCommandArgs {
+    framework: FocusedRunFramework;
+    sourceFile: string;
+    scenarioTitle?: string;
+}
+interface FocusedRunCommand {
+    command: string;
+    args: string[];
+}
+interface FocusedRunResult {
+    ok: boolean;
+    exitCode: number | null;
+    command: string;
+    args: string[];
+    stdout: string;
+    stderr: string;
+}
+/**
+ * One runner per host framework. The seam that keeps `run_scenario` extensible:
+ * adding a non-JS framework (go, cargo, pytest, dotnet) later is a single new
+ * entry here — no changes to inference, command building, or the transports.
+ */
+interface RunnerDefinition {
+    framework: FocusedRunFramework;
+    /** Infer this framework from a source-file path, when unambiguous. */
+    detect?: (sourceFile: string) => boolean;
+    /** Build the focused-run command for this framework. */
+    buildCommand: (args: {
+        sourceFile: string;
+        scenarioTitle?: string;
+    }) => FocusedRunCommand;
+}
+declare const RUNNERS: Record<FocusedRunFramework, RunnerDefinition>;
+declare function inferFrameworkFromSourceFile(sourceFile: string): FocusedRunFramework | undefined;
+declare function resolveFocusedRunFramework(args: {
+    sourceFile: string;
+    framework?: FocusedRunFramework;
+}): FocusedRunFramework;
+declare function buildFocusedRunCommand(args: FocusedRunCommandArgs): FocusedRunCommand;
+declare function runFocusedScenario(args: FocusedRunCommandArgs & {
+    cwd?: string;
+    spawnFn?: typeof spawn;
+}): Promise<FocusedRunResult>;
+
+export { type FeatureSummaryItem, type FocusedRunCommand, type FocusedRunCommandArgs, type FocusedRunFramework, type FocusedRunResult, RUNNERS, type ReadOnlyTool, type RunnerDefinition, type ScenarioLookup, buildFocusedRunCommand, getBehaviorDiff, getBehaviorManifest, getFailingScenarios, getFeatureSummary, getScenario, getScenarioIndex, getScenariosForPaths, inferFrameworkFromSourceFile, listScenarios, loadStoryReport, readOnlyTools, resolveFocusedRunFramework, resolveReportPath, runFocusedScenario };

package/dist/index.js

@@ -0,0 +1,209 @@
+// 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`);
+  }
+}
+export {
+  RUNNERS,
+  buildFocusedRunCommand,
+  getBehaviorDiff,
+  getBehaviorManifest,
+  getFailingScenarios,
+  getFeatureSummary,
+  getScenario,
+  getScenarioIndex,
+  getScenariosForPaths,
+  inferFrameworkFromSourceFile,
+  listScenarios,
+  loadStoryReport,
+  readOnlyTools,
+  resolveFocusedRunFramework,
+  resolveReportPath,
+  runFocusedScenario
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["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":"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","names":["resolve"]}