playwright-e2e-mcp 0.1.0

package/dist/tools/compare-visual-state.js

@@ -0,0 +1,223 @@
+/**
+ * Tool 7 — compare-visual-state: the blueprint's visual regression tool.
+ *
+ * Capture a screenshot of a page (or one element), compare it against a
+ * stored baseline, and report *what* changed: how many pixels, where
+ * (merged regions), and the average color shift — e.g. "the changed
+ * area went from blue rgb(37,99,235) to red rgb(220,38,38)".
+ */
+import { z } from 'zod';
+import { mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { PlaywrightMcpError } from '../types/index.js';
+import { decodePng, diffImages, encodePng } from '../utils/image-diff.js';
+import { relativeToRoot, resolvePath, tempFilePath } from '../utils/path-utils.js';
+import { diagnoseOutput } from '../utils/report-parser.js';
+import { assertHttpUrl, guard, resolveProjectRoot, runBrowserScript, toolError, toolText, } from './shared.js';
+const compareInput = z.object({
+    url: z.string().describe('Full URL of the page (or element target) to capture'),
+    name: z
+        .string()
+        .min(1)
+        .max(64)
+        .regex(/^[A-Za-z0-9._-]+$/, 'letters, digits, dot, underscore, dash only')
+        .describe('Baseline id, e.g. "checkout-page" or "submit-button"'),
+    projectRoot: z.string().optional().describe('Project directory; defaults to the server working directory'),
+    selector: z.string().optional().describe('Capture only this element instead of the whole page'),
+    fullPage: z.boolean().optional().describe('Capture the full scrollable page (default false)'),
+    waitUntil: z.enum(['load', 'domcontentloaded', 'networkidle']).optional(),
+    waitFor: z.string().optional().describe('Wait for this selector before capturing'),
+    timeoutMs: z.number().int().min(1_000).max(300_000).optional(),
+    action: z
+        .enum(['compare', 'baseline'])
+        .optional()
+        .describe("'baseline' overwrites the stored baseline; 'compare' (default) compares against it"),
+    tolerance: z
+        .number()
+        .min(0)
+        .max(100)
+        .optional()
+        .describe('Percent of pixels that may differ before reporting a change (default 0.1)'),
+    pixelThreshold: z
+        .number()
+        .int()
+        .min(1)
+        .max(765)
+        .optional()
+        .describe('Combined per-pixel channel delta considered different (default 60)'),
+});
+export const compareVisualStateSchema = compareInput;
+const COLOR_NAMES = [
+    { name: 'white', rgb: { r: 255, g: 255, b: 255 } },
+    { name: 'black', rgb: { r: 0, g: 0, b: 0 } },
+    { name: 'red', rgb: { r: 220, g: 38, b: 38 } },
+    { name: 'orange', rgb: { r: 234, g: 88, b: 12 } },
+    { name: 'yellow', rgb: { r: 234, g: 179, b: 8 } },
+    { name: 'green', rgb: { r: 22, g: 163, b: 74 } },
+    { name: 'cyan', rgb: { r: 8, g: 145, b: 178 } },
+    { name: 'blue', rgb: { r: 37, g: 99, b: 235 } },
+    { name: 'purple', rgb: { r: 126, g: 34, b: 206 } },
+    { name: 'pink', rgb: { r: 219, g: 39, b: 119 } },
+    { name: 'brown', rgb: { r: 120, g: 53, b: 15 } },
+    { name: 'gray', rgb: { r: 120, g: 113, b: 108 } },
+];
+function colorName(rgb) {
+    let best = COLOR_NAMES[0];
+    let bestDistance = Number.POSITIVE_INFINITY;
+    for (const candidate of COLOR_NAMES) {
+        const distance = (rgb.r - candidate.rgb.r) ** 2 + (rgb.g - candidate.rgb.g) ** 2 + (rgb.b - candidate.rgb.b) ** 2;
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            best = candidate;
+        }
+    }
+    return best.name;
+}
+function rgbText(rgb) {
+    return `rgb(${rgb.r}, ${rgb.g}, ${rgb.b})`;
+}
+async function exists(p) {
+    return stat(p).then((info) => info.isFile(), () => false);
+}
+function decodeScreenshot(buf) {
+    try {
+        return decodePng(buf);
+    }
+    catch (err) {
+        throw new PlaywrightMcpError(`The screenshot could not be decoded: ${err instanceof Error ? err.message : String(err)}`, 'UNKNOWN', { hint: 'Playwright produced an unexpected image format; re-run the capture.' });
+    }
+}
+export const compareVisualStateTool = {
+    name: 'compare-visual-state',
+    description: 'Visual regression check: screenshot a live page (or element), compare it to a stored baseline, and report how many pixels changed, WHERE they changed (bounding regions), and the average color shift ("blue → red"). First call saves the baseline; later calls compare. Writes a red-highlighted diff image for review.',
+    inputSchema: compareVisualStateSchema,
+    handler: async (args, ctx) => guard('compare-visual-state', async () => {
+        const root = await resolveProjectRoot(args.projectRoot, ctx);
+        const url = assertHttpUrl(args.url);
+        const tolerance = args.tolerance ?? 0.1;
+        const timeoutMs = args.timeoutMs ?? 45_000;
+        const visualDir = resolvePath(root, '.pw-mcp/visual');
+        const baselinePath = resolvePath(visualDir, `${args.name}.png`);
+        const metaPath = resolvePath(visualDir, `${args.name}.json`);
+        // 1. Capture a fresh screenshot.
+        const shotPath = tempFilePath('pw-shot', '.png');
+        try {
+            const outcome = await runBrowserScript({
+                mode: 'screenshot',
+                projectRoot: root,
+                url,
+                selector: args.selector,
+                waitFor: args.waitFor,
+                waitUntil: args.waitUntil,
+                includeHtml: false,
+                fullPage: args.fullPage,
+                screenshotPath: shotPath,
+                gotoTimeout: Math.max(5_000, timeoutMs - 8_000),
+                waitTimeout: Math.min(10_000, Math.max(3_000, timeoutMs - 8_000)),
+                startedAt: Date.now(),
+            }, { timeoutMs, signal: ctx.signal });
+            if (!outcome.ok) {
+                const diagnosis = outcome.stderrTail ? diagnoseOutput(outcome.stderrTail) : null;
+                return toolError(outcome.kind ?? 'UNKNOWN', `Could not capture ${url}: ${outcome.error ?? 'unknown error'}`, outcome.hint ?? diagnosis?.hint, outcome.stderrTail);
+            }
+            const shot = await readFile(shotPath);
+            const current = decodeScreenshot(shot);
+            const meta = {
+                url,
+                savedAt: new Date().toISOString(),
+                width: current.width,
+                height: current.height,
+                selector: args.selector,
+            };
+            // 2. First call (or action: 'baseline') stores the baseline.
+            const hasBaseline = await exists(baselinePath);
+            if (args.action === 'baseline' || !hasBaseline) {
+                try {
+                    await mkdir(dirname(baselinePath), { recursive: true });
+                    await writeFile(baselinePath, shot);
+                    await writeFile(metaPath, JSON.stringify(meta, null, 2), 'utf8');
+                }
+                catch (err) {
+                    const code = err.code;
+                    const kind = code === 'ENOSPC' ? 'DISK_FULL' : 'UNKNOWN';
+                    const diagnosis = diagnoseOutput(`${code ?? ''} ${err instanceof Error ? err.message : ''}`);
+                    throw new PlaywrightMcpError(`Could not save the baseline at ${relativeToRoot(root, baselinePath)}`, kind, {
+                        hint: diagnosis?.hint ??
+                            'Check that the project directory is writable and has free space.',
+                    });
+                }
+                const verb = args.action === 'baseline' ? 'overwritten' : 'created';
+                return toolText([
+                    `## 📸 Baseline ${verb} — "${args.name}"`,
+                    '',
+                    `**URL:** ${url}`,
+                    `**Size:** ${current.width}×${current.height}${args.selector ? ` (element: \`${args.selector}\`)` : ''}`,
+                    `**Saved:** \`${relativeToRoot(root, baselinePath)}\``,
+                    '',
+                    hasBaseline && args.action === 'baseline'
+                        ? '_Future `compare` calls will diff against this new baseline._'
+                        : '_Make your UI change, then call compare-visual-state again with the same `name` (and `action: "compare"` or omitted)._',
+                ].join('\n'));
+            }
+            // 3. Compare against the baseline.
+            const baselinePng = await readFile(baselinePath);
+            const baseline = decodeScreenshot(baselinePng);
+            const baselineMeta = await readFile(metaPath, 'utf8')
+                .then((text) => JSON.parse(text))
+                .catch(() => null);
+            const result = diffImages(baseline, current, { pixelThreshold: args.pixelThreshold });
+            const lines = [];
+            if (result.diffPixels === 0 || result.percent <= tolerance) {
+                lines.push(`## ✅ No visual change — "${args.name}"`, '', `**Changed:** 0 pixel(s)${result.diffPixels > 0 ? ` (${result.percent}% — within tolerance ${tolerance}%)` : ''}`, `**Size:** ${result.width}×${result.height} · **Baseline:** ${baselineMeta?.savedAt ?? 'unknown date'}`, '', '_Nothing worth flagging — the render matches the baseline._');
+                return toolText(lines.join('\n'));
+            }
+            // Write the annotated diff image for review.
+            const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+            const diffPath = resolvePath(visualDir, `diffs/${args.name}-${stamp}.png`);
+            try {
+                await mkdir(dirname(diffPath), { recursive: true });
+                await writeFile(diffPath, encodePng(result.diffImage));
+            }
+            catch {
+                // Diff image is a nice-to-have; the numbers below still stand.
+            }
+            lines.push(`## ⚠️ Visual change detected — "${args.name}"`, '');
+            lines.push(`**URL:** ${url}`);
+            lines.push(`**Changed:** ${result.percent}% of pixels (${result.diffPixels.toLocaleString('en-US')} px) — tolerance ${tolerance}%`);
+            lines.push(`**Size:** baseline ${baseline.width}×${baseline.height} → now ${current.width}×${current.height}`);
+            if (result.dimensionsChanged) {
+                lines.push('> ⚠️ Dimensions changed between baseline and capture — layout shifted.');
+            }
+            if (baselineMeta && baselineMeta.url !== url) {
+                lines.push(`> ⚠️ This baseline was captured for a different URL (${baselineMeta.url}) on ${baselineMeta.savedAt}.`);
+            }
+            lines.push('');
+            if (result.regions.length > 0) {
+                lines.push('### Changed regions (largest first)', '');
+                for (const region of result.regions) {
+                    lines.push(`- (${region.x}, ${region.y}) ${region.width}×${region.height} — ${region.pixels.toLocaleString('en-US')} px`);
+                }
+                lines.push('');
+            }
+            if (result.beforeAvg && result.afterAvg) {
+                const beforeName = colorName(result.beforeAvg);
+                const afterName = colorName(result.afterAvg);
+                const shift = beforeName === afterName
+                    ? `stayed ${afterName} but shifted in shade`
+                    : `${beforeName} → ${afterName}`;
+                lines.push('### Color shift in changed area', '');
+                lines.push(`- Average: ${rgbText(result.beforeAvg)} (${beforeName}) → ${rgbText(result.afterAvg)} (${afterName})`);
+                lines.push(`- **${shift}**`);
+                lines.push('');
+            }
+            lines.push(`**Diff image:** \`${relativeToRoot(root, diffPath)}\` (gray = unchanged, red = changed)`, '');
+            lines.push('### Next steps', '');
+            lines.push('1. If the change is intentional, re-baseline: `compare-visual-state` with `action: "baseline"`.', '2. If not, review the CSS/markdown files you touched — the regions above point at the affected area.', '3. Re-run the affected E2E tests with `run-test` to confirm behavior still matches.');
+            return toolText(lines.join('\n'));
+        }
+        finally {
+            await rm(shotPath, { force: true }).catch(() => undefined);
+        }
+    }),
+};
+//# sourceMappingURL=compare-visual-state.js.map

package/dist/tools/compare-visual-state.js.map

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

package/dist/tools/diagnose-flaky.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Tool 8 — diagnose-flaky: run a failing test several times with
+ * retries disabled and decide — from evidence — whether it is
+ * genuinely flaky, consistently broken, or no longer reproducible.
+ *
+ * The verdict logic is a pure function (exported for unit tests).
+ */
+import { z } from 'zod';
+import type { TestFailure, ToolContext, ToolResponse } from '../types/index.js';
+declare const diagnoseFlakyInput: z.ZodObject<{
+    projectRoot: z.ZodOptional<z.ZodString>;
+    testFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runs: z.ZodOptional<z.ZodNumber>;
+    browser: z.ZodOptional<z.ZodEnum<{
+        chromium: "chromium";
+        firefox: "firefox";
+        webkit: "webkit";
+    }>>;
+    headed: z.ZodOptional<z.ZodBoolean>;
+    workers: z.ZodOptional<z.ZodNumber>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    config: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DiagnoseFlakyInput = z.infer<typeof diagnoseFlakyInput>;
+export declare const diagnoseFlakySchema: z.ZodObject<{
+    projectRoot: z.ZodOptional<z.ZodString>;
+    testFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    runs: z.ZodOptional<z.ZodNumber>;
+    browser: z.ZodOptional<z.ZodEnum<{
+        chromium: "chromium";
+        firefox: "firefox";
+        webkit: "webkit";
+    }>>;
+    headed: z.ZodOptional<z.ZodBoolean>;
+    workers: z.ZodOptional<z.ZodNumber>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    config: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export interface FlakyRunOutcome {
+    ok: boolean;
+    durationMs: number;
+    /** Normalized error signature of the first failure, when one occurred. */
+    signature?: string;
+    /** First line of the failure message, for display. */
+    headline?: string;
+    /** No tests executed (bad filter, empty suite, crashed reporter). */
+    noTests?: boolean;
+    /** Run-level error (timeout, spawn failure…) rather than a test failure. */
+    errorKind?: string;
+}
+export type FlakyVerdict = 'NOT REPRODUCING' | 'FLAKY' | 'CONSISTENTLY FAILING' | 'NO TESTS RAN';
+export interface FlakySummary {
+    verdict: FlakyVerdict;
+    passed: number;
+    failed: number;
+    /** Number of distinct normalized error signatures across failed runs. */
+    distinctSignatures: number;
+    /** True when every failed run failed with the same signature. */
+    sameError: boolean;
+}
+/**
+ * Normalize a failure message into a comparable signature: first line,
+ * lowercased, digits folded, whitespace collapsed.
+ */
+export declare function failureSignature(failure: TestFailure | undefined): string | undefined;
+/** Decide the verdict from the per-run outcomes. */
+export declare function summarizeFlaky(runs: FlakyRunOutcome[]): FlakySummary;
+export declare const diagnoseFlakyTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        projectRoot: z.ZodOptional<z.ZodString>;
+        testFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        runs: z.ZodOptional<z.ZodNumber>;
+        browser: z.ZodOptional<z.ZodEnum<{
+            chromium: "chromium";
+            firefox: "firefox";
+            webkit: "webkit";
+        }>>;
+        headed: z.ZodOptional<z.ZodBoolean>;
+        workers: z.ZodOptional<z.ZodNumber>;
+        timeoutMs: z.ZodOptional<z.ZodNumber>;
+        config: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    handler: (args: DiagnoseFlakyInput, ctx: ToolContext) => Promise<ToolResponse>;
+};
+export {};

package/dist/tools/diagnose-flaky.js

@@ -0,0 +1,258 @@
+/**
+ * Tool 8 — diagnose-flaky: run a failing test several times with
+ * retries disabled and decide — from evidence — whether it is
+ * genuinely flaky, consistently broken, or no longer reproducible.
+ *
+ * The verdict logic is a pure function (exported for unit tests).
+ */
+import { z } from 'zod';
+import { PlaywrightMcpError } from '../types/index.js';
+import { detectProject, missingPlaywrightMessage } from '../utils/project-detector.js';
+import { runTests } from '../utils/playwright-runner.js';
+import { relativeToRoot } from '../utils/path-utils.js';
+import { clipLines, formatDuration, guard, resolveConfigSelection, resolveProjectRoot, sanitizeTestPathArgument, testPathExists, toolText, } from './shared.js';
+const diagnoseFlakyInput = z.object({
+    projectRoot: z.string().optional().describe('Project directory; defaults to the server working directory'),
+    testFiles: z
+        .array(z.string())
+        .optional()
+        .describe('Tests to diagnose ("file:line" supported). Defaults to the tests that failed in the most recent run.'),
+    runs: z
+        .number()
+        .int()
+        .min(2)
+        .max(10)
+        .optional()
+        .describe('How many times to run the tests (default 3)'),
+    browser: z
+        .enum(['chromium', 'firefox', 'webkit'])
+        .optional()
+        .describe('Playwright project name to run'),
+    headed: z.boolean().optional().describe('Run with a visible browser window'),
+    workers: z.number().int().min(1).max(64).optional(),
+    timeoutMs: z
+        .number()
+        .int()
+        .min(1_000)
+        .max(3_600_000)
+        .optional()
+        .describe('Hard wall-clock limit per run (default 120000)'),
+    config: z
+        .string()
+        .optional()
+        .describe('playwright.config path or 1-based index when the project has several configs'),
+});
+export const diagnoseFlakySchema = diagnoseFlakyInput;
+/**
+ * Normalize a failure message into a comparable signature: first line,
+ * lowercased, digits folded, whitespace collapsed.
+ */
+export function failureSignature(failure) {
+    if (!failure)
+        return undefined;
+    const firstLine = (failure.message ?? '').split('\n')[0] ?? '';
+    const normalized = firstLine
+        .toLowerCase()
+        .replace(/\d+/g, '#')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 200);
+    return normalized === '' ? undefined : normalized;
+}
+/** Decide the verdict from the per-run outcomes. */
+export function summarizeFlaky(runs) {
+    const ranAnything = runs.some((r) => !r.noTests);
+    const passed = runs.filter((r) => r.ok && !r.noTests).length;
+    const failed = runs.filter((r) => !r.ok && !r.noTests).length;
+    const signatures = new Set(runs.map((r) => r.signature).filter((s) => s !== undefined));
+    let verdict;
+    if (!ranAnything)
+        verdict = 'NO TESTS RAN';
+    else if (failed === 0)
+        verdict = 'NOT REPRODUCING';
+    else if (passed === 0)
+        verdict = 'CONSISTENTLY FAILING';
+    else
+        verdict = 'FLAKY';
+    return {
+        verdict,
+        passed,
+        failed,
+        distinctSignatures: signatures.size,
+        sameError: signatures.size <= 1,
+    };
+}
+/* ------------------------------------------------------------------ */
+/* Rendering                                                           */
+/* ------------------------------------------------------------------ */
+function verdictBlock(summary) {
+    const { verdict } = summary;
+    const total = summary.passed + summary.failed;
+    switch (verdict) {
+        case 'CONSISTENTLY FAILING':
+            return [
+                `> ❌ **CONSISTENTLY FAILING** — failed all ${total} run(s)${summary.sameError ? ' with the same error' : `, but the errors differ (${summary.distinctSignatures} distinct signatures)`}. This is **not flaky**: there is a real, reproducible bug. Use \`get-failure\` for the full trace and fix it.`,
+            ].join('\n');
+        case 'FLAKY':
+            return [
+                `> ⚠️ **FLAKY** — ${summary.passed} of ${total} run(s) passed${summary.sameError
+                    ? ' and the failures share one signature (a real intermittent bug, not random noise)'
+                    : ` and failures vary (${summary.distinctSignatures} distinct signatures — often timing/environment instability)`}. Quarantine or stabilize it: re-run under load, check for missing \`await\`s, race conditions and shared state.`,
+            ].join('\n');
+        case 'NOT REPRODUCING':
+            return [
+                `> ✅ **NOT REPRODUCING** — passed all ${total} run(s). The failure you saw was one-off (transient environment, network, or a change already fixed it). Re-run the full suite with \`run-test\` to confirm.`,
+            ].join('\n');
+        case 'NO TESTS RAN':
+        default:
+            return [
+                '> ⚠️ **NO TESTS RAN** — the filter matched nothing (or the run crashed before executing). Check `testFiles` with `list-tests`.',
+            ].join('\n');
+    }
+}
+function renderDiagnosis(target, runs, summary, runsRequested) {
+    const lines = [
+        `## Flaky diagnosis — ${target.map((t) => `\`${t}\``).join(', ')} × ${runsRequested} runs`,
+        '',
+        '**Mode:** Playwright retries disabled (`--retries=0`, no auto-retry) so each run is honest evidence.',
+        '',
+        '| run | status | duration | first failure |',
+        '| ---: | --- | --- | --- |',
+    ];
+    runs.forEach((run, i) => {
+        const status = run.noTests
+            ? '∅ no tests'
+            : run.ok
+                ? '✅ passed'
+                : run.errorKind
+                    ? `🛑 ${run.errorKind}`
+                    : '❌ failed';
+        const failure = run.headline ? clipLines(run.headline, 1, 160).replace(/\|/g, '\\|') : '—';
+        lines.push(`| ${i + 1} | ${status} | ${formatDuration(run.durationMs)} | ${failure} |`);
+    });
+    lines.push('', verdictBlock(summary), '');
+    if (summary.verdict === 'FLAKY' || summary.verdict === 'CONSISTENTLY FAILING') {
+        lines.push('**Next steps:**', '');
+        lines.push('1. `get-failure` for the full error, DOM snapshot and failed requests of the last run.');
+        lines.push('2. Re-run only these tests after your fix: `run-test` with `testFiles` and `lastFailed: true`.');
+        if (summary.verdict === 'FLAKY') {
+            lines.push('3. Diagnose again with `runs: 5` for stronger evidence before quarantining the test.');
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/* ------------------------------------------------------------------ */
+/* Tool                                                                */
+/* ------------------------------------------------------------------ */
+function ranNoTests(result) {
+    const s = result.stats;
+    return (s !== null &&
+        s.expected === 0 &&
+        s.unexpected === 0 &&
+        s.flaky === 0 &&
+        s.skipped === 0);
+}
+export const diagnoseFlakyTool = {
+    name: 'diagnose-flaky',
+    description: 'Run a failing test multiple times with retries disabled and return an evidence-based verdict: CONSISTENTLY FAILING (real bug), FLAKY (intermittent — includes pass/fail counts and error-signature variance) or NOT REPRODUCING (one-off). Defaults to the tests that failed in the most recent run.',
+    inputSchema: diagnoseFlakySchema,
+    handler: async (args, ctx) => guard('diagnose-flaky', async () => {
+        const root = await resolveProjectRoot(args.projectRoot, ctx);
+        const detection = await detectProject(root);
+        if (!detection.hasPlaywright) {
+            const { message, hint } = missingPlaywrightMessage(detection);
+            return toolText([`## Flaky diagnosis unavailable`, '', `**Error:** ${message}`, '', `> ${hint}`].join('\n'));
+        }
+        const configPath = resolveConfigSelection(detection, args.config);
+        // Target set: explicit, or the failures of the most recent run.
+        let target = args.testFiles ?? [];
+        if (target.length === 0) {
+            const last = ctx.store.lastRun;
+            const failedFiles = [
+                ...new Set((last?.result.failures ?? [])
+                    .map((f) => f.file)
+                    .filter((f) => typeof f === 'string' && f !== '')),
+            ];
+            if (failedFiles.length === 0) {
+                throw new PlaywrightMcpError('No tests to diagnose', 'INVALID_PATH', {
+                    hint: 'Pass `testFiles`, or call `run-test` first so the previously failed tests can be reused as the target set.',
+                });
+            }
+            target = failedFiles;
+        }
+        const sanitized = [];
+        const missing = [];
+        for (const raw of target) {
+            const absolute = sanitizeTestPathArgument(raw, root);
+            sanitized.push(absolute);
+            if (!(await testPathExists(absolute, root)))
+                missing.push(raw);
+        }
+        if (missing.length > 0) {
+            throw new PlaywrightMcpError(`Test path(s) not found: ${missing.join(', ')}`, 'INVALID_PATH', {
+                hint: `Paths resolve inside ${root}. Call list-tests to see the available tests.`,
+            });
+        }
+        const runsRequested = args.runs ?? 3;
+        const outcomeList = [];
+        let lastResult;
+        for (let i = 0; i < runsRequested; i += 1) {
+            if (ctx.signal?.aborted)
+                break;
+            ctx.logger.info('diagnose-flaky run', { run: i + 1, of: runsRequested, target: sanitized });
+            const result = await runTests({
+                projectRoot: root,
+                configPath,
+                testFiles: sanitized,
+                browser: args.browser,
+                headed: args.headed,
+                workers: args.workers,
+                timeoutMs: args.timeoutMs,
+                retries: 0,
+                retryOnFailure: false,
+                signal: ctx.signal,
+            });
+            lastResult = result;
+            const first = result.failures[0];
+            const noTests = ranNoTests(result);
+            outcomeList.push({
+                ok: result.ok && !noTests,
+                durationMs: result.durationMs,
+                signature: failureSignature(first),
+                headline: first ? first.message.split('\n')[0] : undefined,
+                noTests,
+                errorKind: !result.ok && result.failures.length === 0 ? result.errorKind : undefined,
+            });
+            // A run-level hard error (spawn/timeout) will repeat — stop early.
+            if (!result.ok && result.failures.length === 0 && result.errorKind && result.errorKind !== 'REPORT_MISSING') {
+                break;
+            }
+        }
+        const summary = summarizeFlaky(outcomeList);
+        if (lastResult) {
+            ctx.store.setLastRun({ projectRoot: root, result: lastResult, at: Date.now() });
+        }
+        ctx.logger.info('diagnose-flaky finished', {
+            verdict: summary.verdict,
+            runs: outcomeList.length,
+            passed: summary.passed,
+            failed: summary.failed,
+        });
+        if (outcomeList.every((r) => r.errorKind)) {
+            const kinds = [...new Set(outcomeList.map((r) => r.errorKind))].join(', ');
+            return toolText([
+                '## Flaky diagnosis could not run',
+                '',
+                `Every attempt failed at the run level (\`${kinds}\`) before any test executed.`,
+                '',
+                lastResult?.errorMessage ? clipLines(lastResult.errorMessage, 4, 600) : '',
+                lastResult?.hint ? `> ${lastResult.hint}` : '',
+            ]
+                .filter(Boolean)
+                .join('\n'));
+        }
+        return toolText(renderDiagnosis(sanitized.map((file) => relativeToRoot(root, file)), outcomeList, summary, runsRequested));
+    }),
+};
+//# sourceMappingURL=diagnose-flaky.js.map

package/dist/tools/diagnose-flaky.js.map

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