@paretools/test 0.8.5 → 0.10.0

package/dist/tools/playwright.d.ts

@@ -1,4 +1,25 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/** Build extra CLI args for the `playwright` tool. Exported for unit testing. */
+export declare function buildPlaywrightExtraArgs(opts: {
+    filter?: string;
+    project?: string;
+    grep?: string;
+    browser?: string;
+    shard?: string;
+    trace?: "on" | "off" | "retain-on-failure";
+    config?: string;
+    headed?: boolean;
+    updateSnapshots?: boolean;
+    workers?: number;
+    retries?: number;
+    maxFailures?: number;
+    timeout?: number;
+    lastFailed?: boolean;
+    onlyChanged?: boolean;
+    forbidOnly?: boolean;
+    passWithNoTests?: boolean;
+    args?: string[];
+}): string[];
 /** Registers the `playwright` tool on the given MCP server. */
 export declare function registerPlaywrightTool(server: McpServer): void;
 //# sourceMappingURL=playwright.d.ts.map

package/dist/tools/playwright.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../src/tools/playwright.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,+DAA+D;AAC/D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAqHvD"}
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../src/tools/playwright.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,iFAAiF;AACjF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,IAAI,GAAG,KAAK,GAAG,mBAAmB,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GAAG,MAAM,EAAE,CAiEX;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,QAwMvD"}

package/dist/tools/playwright.js

@@ -7,17 +7,70 @@ import { compactDualOutput, run, assertNoFlagInjection, INPUT_LIMITS } from "@pa
 import { parsePlaywrightJson } from "../lib/parsers/playwright.js";
 import { formatPlaywrightResult, compactPlaywrightResultMap, formatPlaywrightResultCompact, } from "../lib/formatters.js";
 import { PlaywrightResultSchema } from "../schemas/index.js";
+import { TEST_CLI_TIMEOUT_MS } from "../lib/timeouts.js";
+/** Build extra CLI args for the `playwright` tool. Exported for unit testing. */
+export function buildPlaywrightExtraArgs(opts) {
+    const extraArgs = [...(opts.args || [])];
+    if (opts.filter) {
+        extraArgs.push(opts.filter);
+    }
+    if (opts.project) {
+        extraArgs.push("--project", opts.project);
+    }
+    if (opts.grep) {
+        extraArgs.push("--grep", opts.grep);
+    }
+    if (opts.browser) {
+        extraArgs.push("--browser", opts.browser);
+    }
+    if (opts.shard) {
+        extraArgs.push("--shard", opts.shard);
+    }
+    if (opts.trace) {
+        extraArgs.push("--trace", opts.trace);
+    }
+    if (opts.config) {
+        extraArgs.push("--config", opts.config);
+    }
+    if (opts.headed) {
+        extraArgs.push("--headed");
+    }
+    if (opts.updateSnapshots) {
+        extraArgs.push("--update-snapshots");
+    }
+    if (opts.workers !== undefined) {
+        extraArgs.push(`--workers=${opts.workers}`);
+    }
+    if (opts.retries !== undefined) {
+        extraArgs.push(`--retries=${opts.retries}`);
+    }
+    if (opts.maxFailures !== undefined) {
+        extraArgs.push(`--max-failures=${opts.maxFailures}`);
+    }
+    if (opts.timeout !== undefined) {
+        extraArgs.push(`--timeout=${opts.timeout}`);
+    }
+    if (opts.lastFailed) {
+        extraArgs.push("--last-failed");
+    }
+    if (opts.onlyChanged) {
+        extraArgs.push("--only-changed");
+    }
+    if (opts.forbidOnly) {
+        extraArgs.push("--forbid-only");
+    }
+    if (opts.passWithNoTests) {
+        extraArgs.push("--pass-with-no-tests");
+    }
+    return extraArgs;
+}
 /** Registers the `playwright` tool on the given MCP server. */
 export function registerPlaywrightTool(server) {
     server.registerTool("playwright", {
         title: "Playwright Tests",
-        description: "Runs Playwright tests with JSON reporter and returns structured results with pass/fail status, duration, and error messages. Use instead of running `npx playwright test` in the terminal.",
+        description: "Runs Playwright tests with JSON reporter and returns structured results with pass/fail status, duration, and error messages.",
         inputSchema: {
-            path: z
-                .string()
-                .max(INPUT_LIMITS.PATH_MAX)
-                .optional()
-                .describe("Project root path (default: cwd)"),
+            path: z.string().max(INPUT_LIMITS.PATH_MAX).optional().describe("Project root path"),
             filter: z
                 .string()
                 .max(INPUT_LIMITS.SHORT_STRING_MAX)
@@ -28,52 +81,124 @@ export function registerPlaywrightTool(server) {
                 .max(INPUT_LIMITS.SHORT_STRING_MAX)
                 .optional()
                 .describe("Playwright project name (e.g., 'chromium', 'firefox', 'webkit')"),
+            grep: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .optional()
+                .describe("Regex pattern for matching tests by title (--grep)"),
+            browser: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .optional()
+                .describe('Browser to use (e.g., "chromium", "firefox", "webkit") via --browser'),
+            shard: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .optional()
+                .describe('Shard spec for distributed E2E test execution (e.g., "1/3") via --shard'),
+            trace: z
+                .enum(["on", "off", "retain-on-failure"])
+                .optional()
+                .describe("Trace recording mode (--trace)"),
+            config: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("Path to non-default Playwright config file (--config)"),
             headed: z.boolean().optional().default(false).describe("Run tests in headed browser mode"),
             updateSnapshots: z
                 .boolean()
                 .optional()
                 .default(false)
                 .describe("Update snapshots (adds --update-snapshots flag)"),
+            workers: z
+                .number()
+                .optional()
+                .describe("Number of parallel workers for test execution (maps to --workers)"),
+            retries: z
+                .number()
+                .optional()
+                .describe("Number of retries for failed tests (maps to --retries)"),
+            maxFailures: z
+                .number()
+                .optional()
+                .describe("Stop after this many test failures (maps to --max-failures)"),
+            timeout: z
+                .number()
+                .optional()
+                .describe("Per-test timeout in milliseconds (maps to --timeout)"),
+            lastFailed: z
+                .boolean()
+                .optional()
+                .describe("Re-run only previously failed tests (maps to --last-failed)"),
+            onlyChanged: z
+                .boolean()
+                .optional()
+                .describe("Run only tests affected by recent changes (maps to --only-changed)"),
+            forbidOnly: z
+                .boolean()
+                .optional()
+                .describe("Fail if test.only is found — CI safety check (maps to --forbid-only)"),
+            passWithNoTests: z
+                .boolean()
+                .optional()
+                .describe("Exit successfully when no tests are found (maps to --pass-with-no-tests)"),
             args: z
                 .array(z.string().max(INPUT_LIMITS.STRING_MAX))
                 .max(INPUT_LIMITS.ARRAY_MAX)
                 .optional()
                 .default([])
                 .describe("Additional arguments to pass to Playwright test runner"),
-            compact: z
-                .boolean()
-                .optional()
-                .default(true)
-                .describe("Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema."),
+            compact: z.boolean().optional().default(true).describe("Prefer compact output"),
         },
         outputSchema: PlaywrightResultSchema,
-    }, async ({ path, filter, project, headed, updateSnapshots, args, compact }) => {
-        for (const a of args ?? []) {
-            assertNoFlagInjection(a, "args");
-        }
-        const cwd = path || process.cwd();
-        const extraArgs = [...(args || [])];
+    }, async ({ path, filter, project, grep, browser, shard, trace, config, headed, updateSnapshots, workers, retries, maxFailures, timeout, lastFailed, onlyChanged, forbidOnly, passWithNoTests, args, compact, }) => {
         if (filter) {
             assertNoFlagInjection(filter, "filter");
-            extraArgs.push(filter);
         }
         if (project) {
             assertNoFlagInjection(project, "project");
-            extraArgs.push("--project", project);
         }
-        if (headed) {
-            extraArgs.push("--headed");
+        if (grep) {
+            assertNoFlagInjection(grep, "grep");
         }
-        if (updateSnapshots) {
-            extraArgs.push("--update-snapshots");
+        if (browser) {
+            assertNoFlagInjection(browser, "browser");
         }
+        if (shard) {
+            assertNoFlagInjection(shard, "shard");
+        }
+        if (config) {
+            assertNoFlagInjection(config, "config");
+        }
+        const cwd = path || process.cwd();
+        const extraArgs = buildPlaywrightExtraArgs({
+            filter,
+            project,
+            grep,
+            browser,
+            shard,
+            trace,
+            config,
+            headed,
+            updateSnapshots,
+            workers,
+            retries,
+            maxFailures,
+            timeout,
+            lastFailed,
+            onlyChanged,
+            forbidOnly,
+            passWithNoTests,
+            args,
+        });
         // Write JSON output to a temp file to avoid stdout parsing issues on Windows
         const tempPath = join(tmpdir(), `pare-playwright-${randomUUID()}.json`);
         const cmdArgs = ["playwright", "test", `--reporter=json`, ...extraArgs];
         // Set PLAYWRIGHT_JSON_OUTPUT_NAME env var to direct JSON to temp file
         const result = await run("npx", cmdArgs, {
             cwd,
-            timeout: 180_000,
+            timeout: TEST_CLI_TIMEOUT_MS,
             env: { PLAYWRIGHT_JSON_OUTPUT_NAME: tempPath },
         });
         let jsonStr;

package/dist/tools/playwright.js.map

@@ -1 +1 @@
-{"version":3,"file":"playwright.js","sourceRoot":"","sources":["../../src/tools/playwright.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"playwright.js","sourceRoot":"","sources":["../../src/tools/playwright.ts"],"names":[],"mappings":"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"}

package/dist/tools/run.d.ts

@@ -1,10 +1,28 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { type Framework } from "../lib/detect.js";
 /** Exported for unit testing. */
-export declare function getRunCommand(framework: Framework, args: string[]): {
+export declare function getRunCommand(framework: Framework, args: string[], opts?: {
+    coverage?: boolean;
+}): {
     cmd: string;
     cmdArgs: string[];
 };
+/** Build the extra CLI args for the `run` tool. Exported for unit testing. */
+export declare function buildRunExtraArgs(framework: Framework, opts: {
+    filter?: string;
+    shard?: string;
+    config?: string;
+    updateSnapshots?: boolean;
+    coverage?: boolean;
+    onlyChanged?: boolean;
+    exitFirst?: boolean;
+    passWithNoTests?: boolean;
+    bail?: number | boolean;
+    testNamePattern?: string;
+    workers?: number;
+    timeout?: number;
+    args?: string[];
+}): string[];
 /** Registers the `run` tool on the given MCP server. */
 export declare function registerRunTool(server: McpServer): void;
 /**

package/dist/tools/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/tools/run.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAQnE,iCAAiC;AACjC,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EAAE,GACb;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAWpC;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QA6HhD;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAatF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUlD"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/tools/run.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AASnE,iCAAiC;AACjC,wBAAgB,aAAa,CAC3B,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAwBpC;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE;IACJ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB,GACA,MAAM,EAAE,CAmLV;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,QAoMhD;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAatF;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAUlD"}

package/dist/tools/run.js

@@ -11,8 +11,9 @@ import { parseVitestJson } from "../lib/parsers/vitest.js";
 import { parseMochaJson } from "../lib/parsers/mocha.js";
 import { formatTestRun, compactTestRunMap, formatTestRunCompact } from "../lib/formatters.js";
 import { TestRunSchema } from "../schemas/index.js";
+import { TEST_CLI_TIMEOUT_MS } from "../lib/timeouts.js";
 /** Exported for unit testing. */
-export function getRunCommand(framework, args) {
+export function getRunCommand(framework, args, opts) {
     switch (framework) {
         case "pytest":
             return { cmd: "python", cmdArgs: ["-m", "pytest", "-v", ...args] };
@@ -21,20 +22,197 @@ export function getRunCommand(framework, args) {
         case "vitest":
             return { cmd: "npx", cmdArgs: ["vitest", "run", "--reporter=json", ...args] };
         case "mocha":
-            return { cmd: "npx", cmdArgs: ["mocha", "--reporter", "json", ...args] };
+            return opts?.coverage
+                ? {
+                    cmd: "npx",
+                    cmdArgs: [
+                        "nyc",
+                        "--reporter=text",
+                        "--reporter=json-summary",
+                        "mocha",
+                        "--reporter",
+                        "json",
+                        ...args,
+                    ],
+                }
+                : { cmd: "npx", cmdArgs: ["mocha", "--reporter", "json", ...args] };
     }
 }
+/** Build the extra CLI args for the `run` tool. Exported for unit testing. */
+export function buildRunExtraArgs(framework, opts) {
+    const extraArgs = [...(opts.args || [])];
+    if (opts.filter) {
+        switch (framework) {
+            case "pytest":
+                extraArgs.push("-k", opts.filter);
+                break;
+            case "jest":
+                extraArgs.push("--testPathPattern", opts.filter);
+                break;
+            case "vitest":
+                extraArgs.push(opts.filter);
+                break;
+            case "mocha":
+                extraArgs.push("--grep", opts.filter);
+                break;
+        }
+    }
+    // Shard support (jest/vitest)
+    if (opts.shard) {
+        switch (framework) {
+            case "jest":
+            case "vitest":
+                extraArgs.push("--shard", opts.shard);
+                break;
+            case "pytest":
+            case "mocha":
+                // pytest/mocha don't have native --shard; ignore silently
+                break;
+        }
+    }
+    // Config file support
+    if (opts.config) {
+        switch (framework) {
+            case "pytest":
+                extraArgs.push(`--override-ini=config=${opts.config}`);
+                break;
+            case "jest":
+                extraArgs.push("--config", opts.config);
+                break;
+            case "vitest":
+                extraArgs.push("--config", opts.config);
+                break;
+            case "mocha":
+                extraArgs.push("--config", opts.config);
+                break;
+        }
+    }
+    if (opts.updateSnapshots && (framework === "vitest" || framework === "jest")) {
+        extraArgs.push("-u");
+    }
+    if (opts.coverage) {
+        switch (framework) {
+            case "vitest":
+            case "jest":
+                extraArgs.push("--coverage");
+                break;
+            case "pytest":
+                extraArgs.push("--cov");
+                break;
+            case "mocha":
+                break;
+        }
+    }
+    if (opts.onlyChanged) {
+        switch (framework) {
+            case "pytest":
+                extraArgs.push("--lf");
+                break;
+            case "jest":
+                extraArgs.push("--onlyChanged");
+                break;
+            case "vitest":
+                extraArgs.push("--changed");
+                break;
+            case "mocha":
+                break;
+        }
+    }
+    if (opts.exitFirst) {
+        switch (framework) {
+            case "pytest":
+                extraArgs.push("-x");
+                break;
+            case "jest":
+            case "vitest":
+                extraArgs.push("--bail=1");
+                break;
+            case "mocha":
+                extraArgs.push("-b");
+                break;
+        }
+    }
+    if (opts.passWithNoTests && (framework === "jest" || framework === "vitest")) {
+        extraArgs.push("--passWithNoTests");
+    }
+    // Bail: fail-fast with optional count
+    if (opts.bail !== undefined && opts.bail !== false) {
+        const n = opts.bail === true ? 1 : opts.bail;
+        switch (framework) {
+            case "pytest":
+                extraArgs.push(`--maxfail=${n}`);
+                break;
+            case "jest":
+                extraArgs.push(`--bail=${n}`);
+                break;
+            case "vitest":
+                extraArgs.push(`--bail=${n}`);
+                break;
+            case "mocha":
+                extraArgs.push("--bail");
+                break;
+        }
+    }
+    // Test name pattern: filter tests by name
+    if (opts.testNamePattern) {
+        switch (framework) {
+            case "pytest":
+                extraArgs.push("-k", opts.testNamePattern);
+                break;
+            case "jest":
+                extraArgs.push(`--testNamePattern=${opts.testNamePattern}`);
+                break;
+            case "vitest":
+                extraArgs.push(`--grep=${opts.testNamePattern}`);
+                break;
+            case "mocha":
+                extraArgs.push("--grep", opts.testNamePattern);
+                break;
+        }
+    }
+    // Workers: parallel execution
+    if (opts.workers !== undefined) {
+        switch (framework) {
+            case "pytest":
+                extraArgs.push("-n", String(opts.workers));
+                break;
+            case "jest":
+                extraArgs.push(`--maxWorkers=${opts.workers}`);
+                break;
+            case "vitest":
+                extraArgs.push(`--pool.threads.maxThreads=${opts.workers}`);
+                break;
+            case "mocha":
+                extraArgs.push("--jobs", String(opts.workers));
+                break;
+        }
+    }
+    // Timeout: per-test timeout
+    if (opts.timeout !== undefined) {
+        switch (framework) {
+            case "pytest":
+                extraArgs.push(`--timeout=${opts.timeout}`);
+                break;
+            case "jest":
+                extraArgs.push(`--testTimeout=${opts.timeout}`);
+                break;
+            case "vitest":
+                extraArgs.push(`--testTimeout=${opts.timeout}`);
+                break;
+            case "mocha":
+                extraArgs.push("--timeout", String(opts.timeout));
+                break;
+        }
+    }
+    return extraArgs;
+}
 /** Registers the `run` tool on the given MCP server. */
 export function registerRunTool(server) {
     server.registerTool("run", {
         title: "Run Tests",
-        description: "Auto-detects test framework (pytest/jest/vitest/mocha), runs tests, returns structured results with failures. Use instead of running pytest/jest/vitest/mocha in the terminal.",
+        description: "Auto-detects test framework (pytest/jest/vitest/mocha), runs tests, returns structured results with failures.",
         inputSchema: {
-            path: z
-                .string()
-                .max(INPUT_LIMITS.PATH_MAX)
-                .optional()
-                .describe("Project root path (default: cwd)"),
+            path: z.string().max(INPUT_LIMITS.PATH_MAX).optional().describe("Project root path"),
             framework: z
                 .enum(["pytest", "jest", "vitest", "mocha"])
                 .optional()
@@ -44,63 +222,109 @@ export function registerRunTool(server) {
                 .max(INPUT_LIMITS.SHORT_STRING_MAX)
                 .optional()
                 .describe("Test filter pattern (file path or test name pattern)"),
+            shard: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .optional()
+                .describe('Shard spec for distributed test execution (e.g., "1/3") via --shard (jest/vitest)'),
+            config: z
+                .string()
+                .max(INPUT_LIMITS.PATH_MAX)
+                .optional()
+                .describe("Path to test config file (--config for all frameworks)"),
             updateSnapshots: z
                 .boolean()
                 .optional()
                 .default(false)
                 .describe("Update snapshots (vitest/jest only, adds -u flag)"),
+            coverage: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe("Run with coverage (adds --coverage for vitest/jest, --cov for pytest)"),
+            onlyChanged: z
+                .boolean()
+                .optional()
+                .describe("Run only tests affected by recent changes (maps to --lf for pytest, --onlyChanged for jest, --changed for vitest)"),
+            exitFirst: z
+                .boolean()
+                .optional()
+                .describe("Stop on first test failure (maps to -x for pytest, --bail=1 for jest/vitest, -b for mocha)"),
+            passWithNoTests: z
+                .boolean()
+                .optional()
+                .describe("Exit successfully when no tests are found (maps to --passWithNoTests for jest/vitest)"),
+            bail: z
+                .union([z.number().int().min(1), z.boolean()])
+                .optional()
+                .describe("Fail fast after N failures (maps to --maxfail=N for pytest, --bail=N for jest/vitest, --bail for mocha). Pass true for 1."),
+            testNamePattern: z
+                .string()
+                .max(INPUT_LIMITS.SHORT_STRING_MAX)
+                .optional()
+                .describe("Filter tests by name pattern (maps to -k for pytest, --testNamePattern for jest, --grep for vitest/mocha)"),
+            workers: z
+                .number()
+                .int()
+                .min(1)
+                .optional()
+                .describe("Number of parallel workers (maps to -n for pytest-xdist, --maxWorkers for jest, --pool.threads.maxThreads for vitest, --jobs for mocha)"),
+            timeout: z
+                .number()
+                .int()
+                .min(0)
+                .optional()
+                .describe("Per-test timeout in milliseconds (maps to --timeout for pytest-timeout, --testTimeout for jest/vitest, --timeout for mocha)"),
             args: z
                 .array(z.string().max(INPUT_LIMITS.STRING_MAX))
                 .max(INPUT_LIMITS.ARRAY_MAX)
                 .optional()
                 .default([])
                 .describe("Additional arguments to pass to the test runner"),
-            compact: z
-                .boolean()
-                .optional()
-                .default(true)
-                .describe("Auto-compact when structured output exceeds raw CLI tokens. Set false to always get full schema."),
+            compact: z.boolean().optional().default(true).describe("Prefer compact output"),
         },
         outputSchema: TestRunSchema,
-    }, async ({ path, framework, filter, updateSnapshots, args, compact }) => {
-        for (const a of args ?? []) {
-            assertNoFlagInjection(a, "args");
-        }
-        const cwd = path || process.cwd();
-        const detected = framework || (await detectFramework(cwd));
-        const extraArgs = [...(args || [])];
+    }, async ({ path, framework, filter, shard, config, updateSnapshots, coverage, onlyChanged, exitFirst, passWithNoTests, bail, testNamePattern, workers, timeout, args, compact, }) => {
         if (filter) {
             assertNoFlagInjection(filter, "filter");
-            switch (detected) {
-                case "pytest":
-                    extraArgs.push("-k", filter);
-                    break;
-                case "jest":
-                    extraArgs.push("--testPathPattern", filter);
-                    break;
-                case "vitest":
-                    extraArgs.push(filter);
-                    break;
-                case "mocha":
-                    extraArgs.push("--grep", filter);
-                    break;
-            }
         }
-        // Snapshot update support (vitest/jest only)
-        if (updateSnapshots && (detected === "vitest" || detected === "jest")) {
-            extraArgs.push("-u");
+        if (shard) {
+            assertNoFlagInjection(shard, "shard");
+        }
+        if (config) {
+            assertNoFlagInjection(config, "config");
         }
+        if (testNamePattern) {
+            assertNoFlagInjection(testNamePattern, "testNamePattern");
+        }
+        const cwd = path || process.cwd();
+        const detected = framework || (await detectFramework(cwd));
+        const extraArgs = buildRunExtraArgs(detected, {
+            filter,
+            shard,
+            config,
+            updateSnapshots,
+            coverage,
+            onlyChanged,
+            exitFirst,
+            passWithNoTests,
+            bail,
+            testNamePattern,
+            workers,
+            timeout,
+            args,
+        });
         // For vitest/jest, write JSON to a temp file instead of relying on
         // stdout capture. On Windows, npx.cmd can swallow or mangle stdout,
         // causing "No JSON output found" errors.
         // Mocha outputs JSON to stdout, so we don't use --outputFile for it.
         const useOutputFile = detected === "jest" || detected === "vitest";
         const tempPath = useOutputFile ? join(tmpdir(), `pare-test-${randomUUID()}.json`) : "";
-        const { cmd, cmdArgs } = getRunCommand(detected, extraArgs);
+        const { cmd, cmdArgs } = getRunCommand(detected, extraArgs, { coverage });
         if (useOutputFile) {
             cmdArgs.push(`--outputFile=${tempPath}`);
         }
-        const result = await run(cmd, cmdArgs, { cwd, timeout: 180_000 });
+        const result = await run(cmd, cmdArgs, { cwd, timeout: TEST_CLI_TIMEOUT_MS });
         // Combine stdout and stderr for parsing (some frameworks write to stderr)
         const output = result.stdout + "\n" + result.stderr;
         let testRun;