playwright-checkpoint 0.1.0-beta.0

package/dist/chunk-F5A6XGLJ.js

@@ -0,0 +1,104 @@
+// src/cli/mcp-args.ts
+function parseMcpCliArgs(argv) {
+  const flags = {};
+  const passthroughArgs = [];
+  let doubleDashSeen = false;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i] ?? "";
+    if (doubleDashSeen) {
+      passthroughArgs.push(arg);
+      continue;
+    }
+    if (arg === "--") {
+      doubleDashSeen = true;
+      continue;
+    }
+    if (arg === "--upstream") {
+      const value = argv[i + 1];
+      if (!value || value.startsWith("-")) {
+        throw new Error("--upstream requires a package name argument.");
+      }
+      flags.upstream = value;
+      i += 1;
+      continue;
+    }
+    if (arg.startsWith("--upstream=")) {
+      flags.upstream = arg.slice("--upstream=".length);
+      continue;
+    }
+    if (arg === "--standalone") {
+      flags.standalone = true;
+      continue;
+    }
+    if (arg === "--cdp-endpoint") {
+      const value = argv[i + 1];
+      if (!value || value.startsWith("-")) {
+        throw new Error("--cdp-endpoint requires a URL argument.");
+      }
+      flags.cdpEndpoint = value;
+      i += 1;
+      continue;
+    }
+    if (arg.startsWith("--cdp-endpoint=")) {
+      flags.cdpEndpoint = arg.slice("--cdp-endpoint=".length);
+      continue;
+    }
+    if (arg === "--output-dir") {
+      const value = argv[i + 1];
+      if (!value || value.startsWith("-")) {
+        throw new Error("--output-dir requires a path argument.");
+      }
+      flags.outputDir = value;
+      i += 1;
+      continue;
+    }
+    if (arg.startsWith("--output-dir=")) {
+      flags.outputDir = arg.slice("--output-dir=".length);
+      continue;
+    }
+    if (arg === "--help" || arg === "-h") {
+      flags.upstream = "__help__";
+      return { flags, passthroughArgs: [] };
+    }
+    passthroughArgs.push(arg, ...argv.slice(i + 1));
+    break;
+  }
+  return { flags, passthroughArgs };
+}
+function printMcpHelp(log) {
+  log(`playwright-checkpoint mcp
+
+Start the playwright-checkpoint MCP proxy server.
+
+Usage:
+  playwright-checkpoint mcp [options] [-- <upstream-args>...]
+
+Options:
+  --upstream <pkg>         Upstream MCP package to proxy (default: auto-detect)
+  --standalone             Run without an upstream MCP server
+  --cdp-endpoint <url>     Connect directly to a browser CDP endpoint
+  --output-dir <path>      Directory for checkpoint output (default: ./checkpoints)
+  -h, --help               Show this help text
+
+All arguments after -- are passed through to the upstream MCP server.
+
+Examples:
+  # Auto-detect @playwright/mcp from node_modules
+  playwright-checkpoint mcp
+
+  # Explicit upstream package
+  playwright-checkpoint mcp --upstream @playwright/mcp
+
+  # Pass headless args to upstream
+  playwright-checkpoint mcp -- --headless --browser chrome
+
+  # Standalone mode (no upstream, connect to existing browser)
+  playwright-checkpoint mcp --standalone --cdp-endpoint http://localhost:9222
+`);
+}
+
+export {
+  parseMcpCliArgs,
+  printMcpHelp
+};
+//# sourceMappingURL=chunk-F5A6XGLJ.js.map

package/dist/chunk-F5A6XGLJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/mcp-args.ts"],"sourcesContent":["/**\n * Argument parsing for the `playwright-checkpoint mcp` subcommand.\n *\n * Syntax:\n *   playwright-checkpoint mcp [--upstream <pkg>] [--standalone] [--cdp-endpoint <url>]\n *                             [--output-dir <path>] [--] [<passthrough-args>...]\n *\n * The `--` separator terminates flag parsing; everything after it is passed\n * through to the upstream MCP server unchanged.\n */\n\nexport type McpFlags = {\n  upstream?: string;\n  standalone?: boolean;\n  cdpEndpoint?: string;\n  outputDir?: string;\n};\n\nexport type ParsedMcpArgs = {\n  flags: McpFlags;\n  passthroughArgs: string[];\n};\n\n/**\n * Parse CLI arguments for the `mcp` subcommand.\n *\n * Returns the parsed flags and any remaining positional / passthrough arguments.\n */\nexport function parseMcpCliArgs(argv: string[]): ParsedMcpArgs {\n  const flags: McpFlags = {};\n  const passthroughArgs: string[] = [];\n  let doubleDashSeen = false;\n\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i] ?? '';\n\n    if (doubleDashSeen) {\n      passthroughArgs.push(arg);\n      continue;\n    }\n\n    if (arg === '--') {\n      doubleDashSeen = true;\n      continue;\n    }\n\n    if (arg === '--upstream') {\n      const value = argv[i + 1];\n      if (!value || value.startsWith('-')) {\n        throw new Error('--upstream requires a package name argument.');\n      }\n      flags.upstream = value;\n      i += 1;\n      continue;\n    }\n\n    if (arg.startsWith('--upstream=')) {\n      flags.upstream = arg.slice('--upstream='.length);\n      continue;\n    }\n\n    if (arg === '--standalone') {\n      flags.standalone = true;\n      continue;\n    }\n\n    if (arg === '--cdp-endpoint') {\n      const value = argv[i + 1];\n      if (!value || value.startsWith('-')) {\n        throw new Error('--cdp-endpoint requires a URL argument.');\n      }\n      flags.cdpEndpoint = value;\n      i += 1;\n      continue;\n    }\n\n    if (arg.startsWith('--cdp-endpoint=')) {\n      flags.cdpEndpoint = arg.slice('--cdp-endpoint='.length);\n      continue;\n    }\n\n    if (arg === '--output-dir') {\n      const value = argv[i + 1];\n      if (!value || value.startsWith('-')) {\n        throw new Error('--output-dir requires a path argument.');\n      }\n      flags.outputDir = value;\n      i += 1;\n      continue;\n    }\n\n    if (arg.startsWith('--output-dir=')) {\n      flags.outputDir = arg.slice('--output-dir='.length);\n      continue;\n    }\n\n    if (arg === '--help' || arg === '-h') {\n      flags.upstream = '__help__'; // signal to bin.ts to print help\n      return { flags, passthroughArgs: [] };\n    }\n\n    // Unknown flag — treat remaining args as passthrough\n    passthroughArgs.push(arg, ...argv.slice(i + 1));\n    break;\n  }\n\n  return { flags, passthroughArgs };\n}\n\n/**\n * Print the MCP subcommand help text.\n */\nexport function printMcpHelp(log: (msg: string) => void): void {\n  log(`playwright-checkpoint mcp\n\nStart the playwright-checkpoint MCP proxy server.\n\nUsage:\n  playwright-checkpoint mcp [options] [-- <upstream-args>...]\n\nOptions:\n  --upstream <pkg>         Upstream MCP package to proxy (default: auto-detect)\n  --standalone             Run without an upstream MCP server\n  --cdp-endpoint <url>     Connect directly to a browser CDP endpoint\n  --output-dir <path>      Directory for checkpoint output (default: ./checkpoints)\n  -h, --help               Show this help text\n\nAll arguments after -- are passed through to the upstream MCP server.\n\nExamples:\n  # Auto-detect @playwright/mcp from node_modules\n  playwright-checkpoint mcp\n\n  # Explicit upstream package\n  playwright-checkpoint mcp --upstream @playwright/mcp\n\n  # Pass headless args to upstream\n  playwright-checkpoint mcp -- --headless --browser chrome\n\n  # Standalone mode (no upstream, connect to existing browser)\n  playwright-checkpoint mcp --standalone --cdp-endpoint http://localhost:9222\n`);\n}\n"],"mappings":";AA4BO,SAAS,gBAAgB,MAA+B;AAC7D,QAAM,QAAkB,CAAC;AACzB,QAAM,kBAA4B,CAAC;AACnC,MAAI,iBAAiB;AAErB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC,KAAK;AAEvB,QAAI,gBAAgB;AAClB,sBAAgB,KAAK,GAAG;AACxB;AAAA,IACF;AAEA,QAAI,QAAQ,MAAM;AAChB,uBAAiB;AACjB;AAAA,IACF;AAEA,QAAI,QAAQ,cAAc;AACxB,YAAM,QAAQ,KAAK,IAAI,CAAC;AACxB,UAAI,CAAC,SAAS,MAAM,WAAW,GAAG,GAAG;AACnC,cAAM,IAAI,MAAM,8CAA8C;AAAA,MAChE;AACA,YAAM,WAAW;AACjB,WAAK;AACL;AAAA,IACF;AAEA,QAAI,IAAI,WAAW,aAAa,GAAG;AACjC,YAAM,WAAW,IAAI,MAAM,cAAc,MAAM;AAC/C;AAAA,IACF;AAEA,QAAI,QAAQ,gBAAgB;AAC1B,YAAM,aAAa;AACnB;AAAA,IACF;AAEA,QAAI,QAAQ,kBAAkB;AAC5B,YAAM,QAAQ,KAAK,IAAI,CAAC;AACxB,UAAI,CAAC,SAAS,MAAM,WAAW,GAAG,GAAG;AACnC,cAAM,IAAI,MAAM,yCAAyC;AAAA,MAC3D;AACA,YAAM,cAAc;AACpB,WAAK;AACL;AAAA,IACF;AAEA,QAAI,IAAI,WAAW,iBAAiB,GAAG;AACrC,YAAM,cAAc,IAAI,MAAM,kBAAkB,MAAM;AACtD;AAAA,IACF;AAEA,QAAI,QAAQ,gBAAgB;AAC1B,YAAM,QAAQ,KAAK,IAAI,CAAC;AACxB,UAAI,CAAC,SAAS,MAAM,WAAW,GAAG,GAAG;AACnC,cAAM,IAAI,MAAM,wCAAwC;AAAA,MAC1D;AACA,YAAM,YAAY;AAClB,WAAK;AACL;AAAA,IACF;AAEA,QAAI,IAAI,WAAW,eAAe,GAAG;AACnC,YAAM,YAAY,IAAI,MAAM,gBAAgB,MAAM;AAClD;AAAA,IACF;AAEA,QAAI,QAAQ,YAAY,QAAQ,MAAM;AACpC,YAAM,WAAW;AACjB,aAAO,EAAE,OAAO,iBAAiB,CAAC,EAAE;AAAA,IACtC;AAGA,oBAAgB,KAAK,KAAK,GAAG,KAAK,MAAM,IAAI,CAAC,CAAC;AAC9C;AAAA,EACF;AAEA,SAAO,EAAE,OAAO,gBAAgB;AAClC;AAKO,SAAS,aAAa,KAAkC;AAC7D,MAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CA4BL;AACD;","names":[]}

package/dist/chunk-K5DX32TO.js

@@ -0,0 +1,214 @@
+import {
+  runReporters
+} from "./chunk-X5IPL32H.js";
+
+// src/cli/index.ts
+import path from "path";
+var DEFAULT_RESULTS_DIR = "test-results";
+var DEFAULT_REPORT_OUTPUT_DIR = "report";
+var DEFAULT_DOCS_OUTPUT_DIR = "docs";
+function printHelp(log) {
+  log(`playwright-checkpoint
+
+Usage:
+  playwright-checkpoint report [--results-dir ./test-results] [--output-dir ./report] [--reporter html,markdown]
+  playwright-checkpoint docs [--results-dir ./test-results] [--output-dir ./docs] [--format markdown|mdx] [--filter @user-journey]
+
+Commands:
+  report    Generate reports from checkpoint manifests
+  docs      Generate Markdown or MDX help articles from checkpoint manifests
+
+Options:
+  --results-dir <path>   Directory containing checkpoint manifests (default: ./${DEFAULT_RESULTS_DIR})
+  --output-dir <path>    Directory where generated output is written (defaults: ./${DEFAULT_REPORT_OUTPUT_DIR} for report, ./${DEFAULT_DOCS_OUTPUT_DIR} for docs)
+  --reporter <names>     Comma-separated reporters to run with the report command (default: html)
+  --format <name>        Docs output format: markdown or mdx (default: markdown)
+  --filter <tags>        Comma-separated tag filter for docs generation
+  -h, --help             Show this help text`);
+}
+function takeFlagValue(args, index, flag) {
+  const value = args[index + 1];
+  if (!value) {
+    throw new Error(`Missing value for ${flag}.`);
+  }
+  return {
+    value,
+    nextIndex: index + 1
+  };
+}
+function parseCommaSeparated(value) {
+  return value.split(",").map((entry) => entry.trim()).filter(Boolean);
+}
+function parseCliArgs(argv) {
+  if (argv.length === 0 || argv.includes("--help") || argv.includes("-h")) {
+    return { command: "help" };
+  }
+  const [command, ...rest] = argv;
+  if (command !== "report" && command !== "docs") {
+    throw new Error(`Unknown command "${command}".`);
+  }
+  let resultsDir = DEFAULT_RESULTS_DIR;
+  let outputDir = command === "docs" ? DEFAULT_DOCS_OUTPUT_DIR : DEFAULT_REPORT_OUTPUT_DIR;
+  let reporters = null;
+  let format = "markdown";
+  let filterTags = [];
+  for (let index = 0; index < rest.length; index += 1) {
+    const argument = rest[index];
+    if (!argument) {
+      continue;
+    }
+    if (argument === "--results-dir") {
+      const { value, nextIndex } = takeFlagValue(rest, index, argument);
+      resultsDir = value;
+      index = nextIndex;
+      continue;
+    }
+    if (argument.startsWith("--results-dir=")) {
+      resultsDir = argument.slice("--results-dir=".length);
+      continue;
+    }
+    if (argument === "--output-dir") {
+      const { value, nextIndex } = takeFlagValue(rest, index, argument);
+      outputDir = value;
+      index = nextIndex;
+      continue;
+    }
+    if (argument.startsWith("--output-dir=")) {
+      outputDir = argument.slice("--output-dir=".length);
+      continue;
+    }
+    if (command === "report") {
+      if (argument === "--reporter") {
+        const { value, nextIndex } = takeFlagValue(rest, index, argument);
+        reporters = parseCommaSeparated(value);
+        index = nextIndex;
+        continue;
+      }
+      if (argument.startsWith("--reporter=")) {
+        reporters = parseCommaSeparated(argument.slice("--reporter=".length));
+        continue;
+      }
+    }
+    if (command === "docs") {
+      if (argument === "--format") {
+        const { value, nextIndex } = takeFlagValue(rest, index, argument);
+        if (value !== "markdown" && value !== "mdx") {
+          throw new Error(`Unsupported docs format "${value}".`);
+        }
+        format = value;
+        index = nextIndex;
+        continue;
+      }
+      if (argument.startsWith("--format=")) {
+        const value = argument.slice("--format=".length);
+        if (value !== "markdown" && value !== "mdx") {
+          throw new Error(`Unsupported docs format "${value}".`);
+        }
+        format = value;
+        continue;
+      }
+      if (argument === "--filter") {
+        const { value, nextIndex } = takeFlagValue(rest, index, argument);
+        filterTags = parseCommaSeparated(value);
+        index = nextIndex;
+        continue;
+      }
+      if (argument.startsWith("--filter=")) {
+        filterTags = parseCommaSeparated(argument.slice("--filter=".length));
+        continue;
+      }
+    }
+    throw new Error(`Unknown argument "${argument}".`);
+  }
+  if (command === "docs") {
+    return {
+      command,
+      resultsDir,
+      outputDir,
+      format,
+      filterTags
+    };
+  }
+  return {
+    command,
+    resultsDir,
+    outputDir,
+    reporters
+  };
+}
+function reporterConfig(reporters) {
+  if (!reporters || reporters.length === 0) {
+    return {};
+  }
+  const selected = new Set(reporters);
+  return {
+    reporters: {
+      html: selected.has("html"),
+      markdown: selected.has("markdown"),
+      mdx: selected.has("mdx"),
+      ...Object.fromEntries(reporters.map((name) => [name, true]))
+    }
+  };
+}
+function docsConfig(format, filterTags) {
+  const reporterName = format === "mdx" ? "mdx" : "markdown";
+  return {
+    reporters: {
+      html: false,
+      markdown: false,
+      mdx: false,
+      [reporterName]: {
+        ...filterTags.length > 0 ? { includeTags: filterTags } : {}
+      }
+    }
+  };
+}
+async function runCli(argv = process.argv.slice(2), deps = {}) {
+  const cwd = deps.cwd ?? process.cwd;
+  const log = deps.log ?? console.log;
+  const error = deps.error ?? console.error;
+  const runReportersImpl = deps.runReportersImpl ?? runReporters;
+  let parsed;
+  try {
+    parsed = parseCliArgs(argv);
+  } catch (caught) {
+    error(`[playwright-checkpoint] ${caught instanceof Error ? caught.message : String(caught)}`);
+    error("Run `playwright-checkpoint --help` for usage.");
+    return 1;
+  }
+  if (parsed.command === "help") {
+    printHelp(log);
+    return 0;
+  }
+  const resultsDir = path.resolve(cwd(), parsed.resultsDir);
+  const outputDir = path.resolve(cwd(), parsed.outputDir);
+  try {
+    const config = parsed.command === "docs" ? docsConfig(parsed.format, parsed.filterTags) : reporterConfig(parsed.reporters);
+    const results = await runReportersImpl(config, resultsDir, outputDir);
+    const summaryLines = Object.entries(results).map(([name, result]) => `- ${name}: ${result.summary}`);
+    log(
+      parsed.command === "docs" ? `[playwright-checkpoint] Generated ${parsed.format.toUpperCase()} docs from ${resultsDir} to ${outputDir}` : `[playwright-checkpoint] Generated reports from ${resultsDir} to ${outputDir}`
+    );
+    if (summaryLines.length > 0) {
+      for (const line of summaryLines) {
+        log(line);
+      }
+    } else {
+      log("- No reporters were enabled.");
+    }
+    return 0;
+  } catch (caught) {
+    error("[playwright-checkpoint] Failed to generate reports.");
+    error(caught instanceof Error ? caught.stack ?? caught.message : String(caught));
+    return 1;
+  }
+}
+
+export {
+  DEFAULT_RESULTS_DIR,
+  DEFAULT_REPORT_OUTPUT_DIR,
+  DEFAULT_DOCS_OUTPUT_DIR,
+  parseCliArgs,
+  runCli
+};
+//# sourceMappingURL=chunk-K5DX32TO.js.map

package/dist/chunk-K5DX32TO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/index.ts"],"sourcesContent":["import path from 'node:path';\nimport { runReporters } from '../report';\nimport type { CheckpointConfig } from '../types';\n\nexport const DEFAULT_RESULTS_DIR = 'test-results';\nexport const DEFAULT_REPORT_OUTPUT_DIR = 'report';\nexport const DEFAULT_DOCS_OUTPUT_DIR = 'docs';\n\ntype CliDeps = {\n  cwd?: () => string;\n  log?: (message: string) => void;\n  error?: (message: string) => void;\n  runReportersImpl?: typeof runReporters;\n};\n\ntype ParsedCli =\n  | {\n      command: 'help';\n    }\n  | {\n      command: 'report';\n      resultsDir: string;\n      outputDir: string;\n      reporters: string[] | null;\n    }\n  | {\n      command: 'docs';\n      resultsDir: string;\n      outputDir: string;\n      format: 'markdown' | 'mdx';\n      filterTags: string[];\n    };\n\nfunction printHelp(log: (message: string) => void): void {\n  log(`playwright-checkpoint\n\nUsage:\n  playwright-checkpoint report [--results-dir ./test-results] [--output-dir ./report] [--reporter html,markdown]\n  playwright-checkpoint docs [--results-dir ./test-results] [--output-dir ./docs] [--format markdown|mdx] [--filter @user-journey]\n\nCommands:\n  report    Generate reports from checkpoint manifests\n  docs      Generate Markdown or MDX help articles from checkpoint manifests\n\nOptions:\n  --results-dir <path>   Directory containing checkpoint manifests (default: ./${DEFAULT_RESULTS_DIR})\n  --output-dir <path>    Directory where generated output is written (defaults: ./${DEFAULT_REPORT_OUTPUT_DIR} for report, ./${DEFAULT_DOCS_OUTPUT_DIR} for docs)\n  --reporter <names>     Comma-separated reporters to run with the report command (default: html)\n  --format <name>        Docs output format: markdown or mdx (default: markdown)\n  --filter <tags>        Comma-separated tag filter for docs generation\n  -h, --help             Show this help text`);\n}\n\nfunction takeFlagValue(args: string[], index: number, flag: string): { value: string; nextIndex: number } {\n  const value = args[index + 1];\n  if (!value) {\n    throw new Error(`Missing value for ${flag}.`);\n  }\n\n  return {\n    value,\n    nextIndex: index + 1,\n  };\n}\n\nfunction parseCommaSeparated(value: string): string[] {\n  return value\n    .split(',')\n    .map((entry) => entry.trim())\n    .filter(Boolean);\n}\n\nexport function parseCliArgs(argv: string[]): ParsedCli {\n  if (argv.length === 0 || argv.includes('--help') || argv.includes('-h')) {\n    return { command: 'help' };\n  }\n\n  const [command, ...rest] = argv;\n  if (command !== 'report' && command !== 'docs') {\n    throw new Error(`Unknown command \"${command}\".`);\n  }\n\n  let resultsDir = DEFAULT_RESULTS_DIR;\n  let outputDir = command === 'docs' ? DEFAULT_DOCS_OUTPUT_DIR : DEFAULT_REPORT_OUTPUT_DIR;\n  let reporters: string[] | null = null;\n  let format: 'markdown' | 'mdx' = 'markdown';\n  let filterTags: string[] = [];\n\n  for (let index = 0; index < rest.length; index += 1) {\n    const argument = rest[index];\n    if (!argument) {\n      continue;\n    }\n\n    if (argument === '--results-dir') {\n      const { value, nextIndex } = takeFlagValue(rest, index, argument);\n      resultsDir = value;\n      index = nextIndex;\n      continue;\n    }\n\n    if (argument.startsWith('--results-dir=')) {\n      resultsDir = argument.slice('--results-dir='.length);\n      continue;\n    }\n\n    if (argument === '--output-dir') {\n      const { value, nextIndex } = takeFlagValue(rest, index, argument);\n      outputDir = value;\n      index = nextIndex;\n      continue;\n    }\n\n    if (argument.startsWith('--output-dir=')) {\n      outputDir = argument.slice('--output-dir='.length);\n      continue;\n    }\n\n    if (command === 'report') {\n      if (argument === '--reporter') {\n        const { value, nextIndex } = takeFlagValue(rest, index, argument);\n        reporters = parseCommaSeparated(value);\n        index = nextIndex;\n        continue;\n      }\n\n      if (argument.startsWith('--reporter=')) {\n        reporters = parseCommaSeparated(argument.slice('--reporter='.length));\n        continue;\n      }\n    }\n\n    if (command === 'docs') {\n      if (argument === '--format') {\n        const { value, nextIndex } = takeFlagValue(rest, index, argument);\n        if (value !== 'markdown' && value !== 'mdx') {\n          throw new Error(`Unsupported docs format \"${value}\".`);\n        }\n        format = value;\n        index = nextIndex;\n        continue;\n      }\n\n      if (argument.startsWith('--format=')) {\n        const value = argument.slice('--format='.length);\n        if (value !== 'markdown' && value !== 'mdx') {\n          throw new Error(`Unsupported docs format \"${value}\".`);\n        }\n        format = value;\n        continue;\n      }\n\n      if (argument === '--filter') {\n        const { value, nextIndex } = takeFlagValue(rest, index, argument);\n        filterTags = parseCommaSeparated(value);\n        index = nextIndex;\n        continue;\n      }\n\n      if (argument.startsWith('--filter=')) {\n        filterTags = parseCommaSeparated(argument.slice('--filter='.length));\n        continue;\n      }\n    }\n\n    throw new Error(`Unknown argument \"${argument}\".`);\n  }\n\n  if (command === 'docs') {\n    return {\n      command,\n      resultsDir,\n      outputDir,\n      format,\n      filterTags,\n    };\n  }\n\n  return {\n    command,\n    resultsDir,\n    outputDir,\n    reporters,\n  };\n}\n\nfunction reporterConfig(reporters: string[] | null): CheckpointConfig {\n  if (!reporters || reporters.length === 0) {\n    return {};\n  }\n\n  const selected = new Set(reporters);\n\n  return {\n    reporters: {\n      html: selected.has('html'),\n      markdown: selected.has('markdown'),\n      mdx: selected.has('mdx'),\n      ...Object.fromEntries(reporters.map((name) => [name, true])),\n    },\n  };\n}\n\nfunction docsConfig(format: 'markdown' | 'mdx', filterTags: string[]): CheckpointConfig {\n  const reporterName = format === 'mdx' ? 'mdx' : 'markdown';\n\n  return {\n    reporters: {\n      html: false,\n      markdown: false,\n      mdx: false,\n      [reporterName]: {\n        ...(filterTags.length > 0 ? { includeTags: filterTags } : {}),\n      },\n    },\n  };\n}\n\nexport async function runCli(argv = process.argv.slice(2), deps: CliDeps = {}): Promise<number> {\n  const cwd = deps.cwd ?? process.cwd;\n  const log = deps.log ?? console.log;\n  const error = deps.error ?? console.error;\n  const runReportersImpl = deps.runReportersImpl ?? runReporters;\n\n  let parsed: ParsedCli;\n  try {\n    parsed = parseCliArgs(argv);\n  } catch (caught) {\n    error(`[playwright-checkpoint] ${caught instanceof Error ? caught.message : String(caught)}`);\n    error('Run `playwright-checkpoint --help` for usage.');\n    return 1;\n  }\n\n  if (parsed.command === 'help') {\n    printHelp(log);\n    return 0;\n  }\n\n  const resultsDir = path.resolve(cwd(), parsed.resultsDir);\n  const outputDir = path.resolve(cwd(), parsed.outputDir);\n\n  try {\n    const config = parsed.command === 'docs' ? docsConfig(parsed.format, parsed.filterTags) : reporterConfig(parsed.reporters);\n    const results = await runReportersImpl(config, resultsDir, outputDir);\n    const summaryLines = Object.entries(results).map(([name, result]) => `- ${name}: ${result.summary}`);\n\n    log(\n      parsed.command === 'docs'\n        ? `[playwright-checkpoint] Generated ${parsed.format.toUpperCase()} docs from ${resultsDir} to ${outputDir}`\n        : `[playwright-checkpoint] Generated reports from ${resultsDir} to ${outputDir}`,\n    );\n\n    if (summaryLines.length > 0) {\n      for (const line of summaryLines) {\n        log(line);\n      }\n    } else {\n      log('- No reporters were enabled.');\n    }\n\n    return 0;\n  } catch (caught) {\n    error('[playwright-checkpoint] Failed to generate reports.');\n    error(caught instanceof Error ? caught.stack ?? caught.message : String(caught));\n    return 1;\n  }\n}\n"],"mappings":"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","names":[]}