playwright-e2e-mcp 0.1.0

package/dist/tools/generate-e2e-test.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Tool 6 — generate-e2e-test: scaffold a Playwright test from a natural
+ * language description, grounded in what actually exists in the repo.
+ *
+ * Blueprint behavior: look at the agent's recent file changes, identify
+ * the components involved, and generate a test that uses the *correct*
+ * selectors (data-testid / role / label…) instead of guessing. When a
+ * URL is known, selectors are cross-checked against the live DOM.
+ */
+import { z } from 'zod';
+import type { ToolContext, ToolResponse } from '../types/index.js';
+declare const generateInput: z.ZodObject<{
+    description: z.ZodString;
+    pageUrl: z.ZodOptional<z.ZodString>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+    config: z.ZodOptional<z.ZodString>;
+    testDir: z.ZodOptional<z.ZodString>;
+    file: z.ZodOptional<z.ZodString>;
+    write: z.ZodOptional<z.ZodBoolean>;
+    overwrite: z.ZodOptional<z.ZodBoolean>;
+    liveInspect: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GenerateE2ETestInput = z.infer<typeof generateInput>;
+export declare const generateE2ETestSchema: z.ZodObject<{
+    description: z.ZodString;
+    pageUrl: z.ZodOptional<z.ZodString>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+    config: z.ZodOptional<z.ZodString>;
+    testDir: z.ZodOptional<z.ZodString>;
+    file: z.ZodOptional<z.ZodString>;
+    write: z.ZodOptional<z.ZodBoolean>;
+    overwrite: z.ZodOptional<z.ZodBoolean>;
+    liveInspect: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const generateE2ETestTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        description: z.ZodString;
+        pageUrl: z.ZodOptional<z.ZodString>;
+        projectRoot: z.ZodOptional<z.ZodString>;
+        config: z.ZodOptional<z.ZodString>;
+        testDir: z.ZodOptional<z.ZodString>;
+        file: z.ZodOptional<z.ZodString>;
+        write: z.ZodOptional<z.ZodBoolean>;
+        overwrite: z.ZodOptional<z.ZodBoolean>;
+        liveInspect: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    handler: (args: GenerateE2ETestInput, ctx: ToolContext) => Promise<ToolResponse>;
+};
+export {};

package/dist/tools/generate-e2e-test.js

@@ -0,0 +1,274 @@
+/**
+ * Tool 6 — generate-e2e-test: scaffold a Playwright test from a natural
+ * language description, grounded in what actually exists in the repo.
+ *
+ * Blueprint behavior: look at the agent's recent file changes, identify
+ * the components involved, and generate a test that uses the *correct*
+ * selectors (data-testid / role / label…) instead of guessing. When a
+ * URL is known, selectors are cross-checked against the live DOM.
+ */
+import { z } from 'zod';
+import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { PlaywrightMcpError } from '../types/index.js';
+import { detectProject } from '../utils/project-detector.js';
+import { analyzeRecentChanges, detectEntryUrl } from '../utils/change-analyzer.js';
+import { normalizePath, relativeToRoot, resolvePath, sanitizeUserPath } from '../utils/path-utils.js';
+import { assertHttpUrl, clipLines, guard, resolveConfigSelection, resolveProjectRoot, runBrowserScript, toolText, } from './shared.js';
+const generateInput = z.object({
+    description: z
+        .string()
+        .min(3)
+        .describe('What the test should cover, e.g. "login with valid credentials"'),
+    pageUrl: z.string().optional().describe('Page the test starts on (default: baseURL from playwright.config)'),
+    projectRoot: z.string().optional().describe('Project directory; defaults to the server working directory'),
+    config: z.string().optional().describe('playwright.config path or 1-based index'),
+    testDir: z.string().optional().describe('Directory for the generated spec (default: detected testDir or tests/)'),
+    file: z.string().optional().describe('Exact file path inside the project instead of the default location'),
+    write: z.boolean().optional().describe('Write the file to disk (default true)'),
+    overwrite: z.boolean().optional().describe('Replace an existing file at the target path'),
+    liveInspect: z
+        .boolean()
+        .optional()
+        .describe('Verify discovered selectors against the live page (default true when a URL is known)'),
+});
+export const generateE2ETestSchema = generateInput;
+/* ------------------------------------------------------------------ */
+/* Helpers                                                             */
+/* ------------------------------------------------------------------ */
+const KIND_PRIORITY = {
+    'test-id': 0,
+    role: 1,
+    aria: 2,
+    placeholder: 3,
+    name: 4,
+    id: 5,
+    text: 6,
+};
+function jsString(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/'/g, "\\'")
+        .replace(/\r?\n/g, ' ')
+        .trim();
+}
+function slugify(description) {
+    const slug = description
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 60);
+    return slug === '' ? 'generated-test' : slug;
+}
+/** Best-effort live-DOM match for a candidate locator. */
+function verifiedLive(candidate, elements) {
+    if (!elements)
+        return false;
+    return elements.some((element) => {
+        const values = Object.values(element.attributes);
+        switch (candidate.kind) {
+            case 'test-id':
+                return (element.attributes['data-testid'] === candidate.value ||
+                    element.attributes['data-test-id'] === candidate.value ||
+                    element.attributes['data-test'] === candidate.value ||
+                    element.attributes['data-cy'] === candidate.value ||
+                    values.includes(candidate.value));
+            case 'aria':
+                return element.attributes['aria-label'] === candidate.value;
+            case 'placeholder':
+                return element.attributes['placeholder'] === candidate.value;
+            case 'id':
+                return element.id === candidate.value;
+            case 'name':
+                return element.attributes['name'] === candidate.value;
+            case 'role':
+            case 'text':
+                return (element.text ?? '').includes(candidate.value);
+            default:
+                return false;
+        }
+    });
+}
+function buildSpec(options) {
+    const title = jsString(options.description);
+    const goto = options.entryUrl
+        ? `  await page.goto('${jsString(options.entryUrl)}');`
+        : [
+            '  // No baseURL found in playwright.config — set the start URL:',
+            "  await page.goto('/');",
+        ].join('\n');
+    const steps = [];
+    if (options.selectors.length === 0) {
+        steps.push('  // No selectors could be discovered from recent changes.', '  // Add data-testid attributes to the components, then re-run', '  // generate-e2e-test — or use inspect-page to read the live DOM:', "  //   await expect(page.getByTestId('your-test-id')).toBeVisible();");
+    }
+    else {
+        for (const candidate of options.selectors) {
+            const note = `${candidate.kind} · ${candidate.file}:${candidate.line}`;
+            steps.push(`  // ${note}`);
+            steps.push(`  await expect(page.${candidate.locator}).toBeVisible();`);
+            if (candidate.kind === 'name' || candidate.kind === 'placeholder' || candidate.kind === 'aria') {
+                steps.push(`  // await page.${candidate.locator}.fill('…');`);
+            }
+            steps.push('');
+        }
+        while (steps.length > 0 && steps[steps.length - 1] === '')
+            steps.pop();
+    }
+    return [
+        "import { test, expect } from '@playwright/test';",
+        '',
+        '/**',
+        ` * Generated by playwright-e2e-mcp for: "${title}"`,
+        ' * Selectors below come from the project source (recent changes).',
+        ' * Review the flow, then run it with the run-test tool.',
+        ' */',
+        `test.describe('${title}', () => {`,
+        `  test('${title}', async ({ page }) => {`,
+        goto,
+        '',
+        ...steps,
+        '  });',
+        '});',
+        '',
+    ].join('\n');
+}
+/* ------------------------------------------------------------------ */
+/* Tool                                                                */
+/* ------------------------------------------------------------------ */
+export const generateE2ETestTool = {
+    name: 'generate-e2e-test',
+    description: "Scaffold a Playwright test from a description using the project's REAL selectors. Scans the agent's recent file changes (git working tree / last commit, mtime fallback), extracts data-testid / role / label / placeholder / id locators with their source locations, optionally cross-checks them against the live page, writes a ready-to-run spec, and returns next steps.",
+    inputSchema: generateE2ETestSchema,
+    handler: async (args, ctx) => guard('generate-e2e-test', async () => {
+        const root = await resolveProjectRoot(args.projectRoot, ctx);
+        const detection = await detectProject(root);
+        const configPath = resolveConfigSelection(detection, args.config);
+        // Entry URL: explicit pageUrl, else baseURL / webServer url from config.
+        let entryUrl;
+        let entryUrlSource = 'none';
+        if (args.pageUrl) {
+            entryUrl = assertHttpUrl(args.pageUrl);
+            entryUrlSource = 'pageUrl argument';
+        }
+        else if (configPath) {
+            const source = await readFile(configPath, 'utf8').catch(() => '');
+            const found = detectEntryUrl(source);
+            const candidate = found.baseURL ?? found.webServerUrl;
+            if (candidate) {
+                try {
+                    entryUrl = assertHttpUrl(candidate);
+                    entryUrlSource = found.baseURL ? 'baseURL from playwright.config' : 'webServer.url from playwright.config';
+                }
+                catch {
+                    entryUrl = undefined;
+                }
+            }
+        }
+        // 1. What changed recently, and which selectors do those files declare?
+        const analysis = await analyzeRecentChanges(root, { limit: 12 });
+        // 2. Optionally verify selectors against the live DOM.
+        let liveElements;
+        let liveNote;
+        const wantsLive = args.liveInspect ?? Boolean(entryUrl);
+        if (wantsLive && entryUrl) {
+            const outcome = await runBrowserScript({
+                mode: 'inspect',
+                projectRoot: root,
+                url: entryUrl,
+                includeHtml: false,
+                gotoTimeout: 15_000,
+                startedAt: Date.now(),
+            }, { timeoutMs: 35_000, signal: ctx.signal });
+            if (outcome.ok) {
+                liveElements = outcome.data?.elements;
+            }
+            else {
+                liveNote = `Live check unavailable (${outcome.kind ?? 'UNKNOWN'}): ${outcome.error ?? 'unknown error'}${outcome.hint ? ` — ${outcome.hint}` : ''}`;
+            }
+        }
+        else if (!entryUrl) {
+            liveNote = 'No URL known (pass pageUrl or set baseURL in playwright.config), so selectors were not live-verified.';
+        }
+        // 3. Rank selectors: verified-live first, then by kind priority.
+        const ranked = analysis.selectors
+            .map((candidate) => ({ candidate, live: verifiedLive(candidate, liveElements) }))
+            .sort((a, b) => {
+            if (a.live !== b.live)
+                return a.live ? -1 : 1;
+            return KIND_PRIORITY[a.candidate.kind] - KIND_PRIORITY[b.candidate.kind];
+        })
+            .slice(0, 8)
+            .map((entry) => entry.candidate);
+        const liveSet = new Set(analysis.selectors.filter((candidate) => verifiedLive(candidate, liveElements)).map((c) => `${c.kind}:${c.value}`));
+        // 4. Build and (optionally) write the spec.
+        const spec = buildSpec({ description: args.description, entryUrl, selectors: ranked });
+        let targetPath;
+        const shouldWrite = args.write !== false;
+        if (shouldWrite) {
+            if (args.file) {
+                targetPath = sanitizeUserPath(args.file, root);
+            }
+            else {
+                const dir = args.testDir
+                    ? sanitizeUserPath(args.testDir, root)
+                    : detection.testDir
+                        ? normalizePath(detection.testDir)
+                        : resolvePath(root, 'tests');
+                targetPath = resolvePath(dir, `generated/${slugify(args.description)}.spec.ts`);
+            }
+            const exists = await stat(targetPath).then((info) => info.isFile(), () => false);
+            if (exists && args.overwrite !== true) {
+                throw new PlaywrightMcpError(`A file already exists at ${relativeToRoot(root, targetPath)}`, 'INVALID_PATH', { hint: 'Pass `overwrite: true` to replace it, or set `file` / `description` to pick a different name.' });
+            }
+            await mkdir(path.dirname(targetPath), { recursive: true });
+            await writeFile(targetPath, spec, 'utf8');
+            ctx.logger.info('generated test written', { file: targetPath, selectors: ranked.length });
+        }
+        // 5. Render.
+        const lines = [`## 🧪 Generated test — "${args.description}"`, ''];
+        if (targetPath) {
+            lines.push(`**File:** \`${relativeToRoot(root, targetPath)}\` (written)`);
+        }
+        else {
+            lines.push('_Not written (`write: false`) — code below._');
+        }
+        if (entryUrl)
+            lines.push(`**Entry URL:** ${entryUrl} (${entryUrlSource})`);
+        lines.push(`**Changes analyzed:** ${analysis.files.length} file(s) via \`${analysis.changeSource === 'git-status'
+            ? 'git status'
+            : analysis.changeSource === 'git-last-commit'
+                ? 'git diff HEAD~1'
+                : 'recent mtime'}\`${analysis.truncated ? ' (truncated)' : ''}`, '');
+        if (analysis.files.length > 0) {
+            lines.push('### Recent changes', '');
+            for (const file of analysis.files.slice(0, 12)) {
+                lines.push(`- \`${file.path}\` _(${file.source})_`);
+            }
+            lines.push('');
+        }
+        if (ranked.length > 0) {
+            lines.push(`### Selectors used (${ranked.length})`, '');
+            for (const candidate of ranked) {
+                const liveMark = liveElements
+                    ? liveSet.has(`${candidate.kind}:${candidate.value}`)
+                        ? ' ✅ live'
+                        : ' ⚠️ not on page'
+                    : '';
+                lines.push(`- \`${candidate.locator}\` — ${candidate.kind} from \`${candidate.file}:${candidate.line}\`_${liveMark}_`);
+            }
+            lines.push('');
+        }
+        else {
+            lines.push('### No selectors discovered', '', 'The recent changes did not expose any `data-testid`, role, label, placeholder or id attributes. The scaffold below includes commented guidance; add `data-testid` attributes to your components (or call **inspect-page** on the running app) and regenerate.', '');
+        }
+        if (liveNote)
+            lines.push(`> ${liveNote}`, '');
+        lines.push('### Test source', '', '```ts', clipLines(spec, 200, 12_000), '```', '');
+        lines.push('### Next steps', '');
+        lines.push(targetPath
+            ? `1. Review the flow (the scaffold provides selector-accurate building blocks).`
+            : `1. Save the code above, then continue.`, `2. Run it: \`run-test\` with \`testFiles: ["${targetPath ? relativeToRoot(root, targetPath) : '<file>'}"]\`.`, '3. If a locator misses, call `inspect-page` for the live DOM or `validate-selector` to prove a replacement.');
+        return toolText(lines.join('\n'));
+    }),
+};
+//# sourceMappingURL=generate-e2e-test.js.map

package/dist/tools/generate-e2e-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-e2e-test.js","sourceRoot":"","sources":["../../src/tools/generate-e2e-test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACtG,OAAO,EACL,aAAa,EACb,SAAS,EACT,KAAK,EACL,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,iEAAiE,CAAC;IAC9E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mEAAmE,CAAC;IAC5G,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;IAC1G,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IACjF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wEAAwE,CAAC;IACjH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IAC1G,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC/E,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;IACzF,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CAAC,sFAAsF,CAAC;CACpG,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAEnD,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,MAAM,aAAa,GAA8C;IAC/D,SAAS,EAAE,CAAC;IACZ,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,WAAW,EAAE,CAAC;IACd,IAAI,EAAE,CAAC;IACP,EAAE,EAAE,CAAC;IACL,IAAI,EAAE,CAAC;CACR,CAAC;AAEF,SAAS,QAAQ,CAAC,KAAa;IAC7B,OAAO,KAAK;SACT,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,OAAO,CAAC,WAAmB;IAClC,MAAM,IAAI,GAAG,WAAW;SACrB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,0DAA0D;AAC1D,SAAS,YAAY,CAAC,SAA4B,EAAE,QAAmC;IACrF,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5B,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACjD,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;YACvB,KAAK,SAAS;gBACZ,OAAO,CACL,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,SAAS,CAAC,KAAK;oBACrD,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,SAAS,CAAC,KAAK;oBACtD,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,SAAS,CAAC,KAAK;oBACnD,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,SAAS,CAAC,KAAK;oBACjD,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CACjC,CAAC;YACJ,KAAK,MAAM;gBACT,OAAO,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC;YAC9D,KAAK,aAAa;gBAChB,OAAO,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC;YAC/D,KAAK,IAAI;gBACP,OAAO,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,KAAK,CAAC;YACxC,KAAK,MAAM;gBACT,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC;YACxD,KAAK,MAAM,CAAC;YACZ,KAAK,MAAM;gBACT,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACxD;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,OAIlB;IACC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ;QAC3B,CAAC,CAAC,sBAAsB,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK;QACvD,CAAC,CAAC;YACE,iEAAiE;YACjE,yBAAyB;SAC1B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CACR,4DAA4D,EAC5D,gEAAgE,EAChE,oEAAoE,EACpE,sEAAsE,CACvE,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAC1C,MAAM,IAAI,GAAG,GAAG,SAAS,CAAC,IAAI,MAAM,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;YACvE,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,uBAAuB,SAAS,CAAC,OAAO,kBAAkB,CAAC,CAAC;YACvE,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,IAAI,SAAS,CAAC,IAAI,KAAK,aAAa,IAAI,SAAS,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBAC/F,KAAK,CAAC,IAAI,CAAC,mBAAmB,SAAS,CAAC,OAAO,aAAa,CAAC,CAAC;YAChE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE;YAAE,KAAK,CAAC,GAAG,EAAE,CAAC;IACzE,CAAC;IAED,OAAO;QACL,kDAAkD;QAClD,EAAE;QACF,KAAK;QACL,4CAA4C,KAAK,GAAG;QACpD,mEAAmE;QACnE,yDAAyD;QACzD,KAAK;QACL,kBAAkB,KAAK,YAAY;QACnC,WAAW,KAAK,0BAA0B;QAC1C,IAAI;QACJ,EAAE;QACF,GAAG,KAAK;QACR,OAAO;QACP,KAAK;QACL,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,wEAAwE;AACxE,yEAAyE;AACzE,wEAAwE;AAExE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,gXAAgX;IAClX,WAAW,EAAE,qBAAqB;IAClC,OAAO,EAAE,KAAK,EAAE,IAA0B,EAAE,GAAgB,EAAyB,EAAE,CACrF,KAAK,CAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;QACpC,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,sBAAsB,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAElE,yEAAyE;QACzE,IAAI,QAA4B,CAAC;QACjC,IAAI,cAAc,GAAG,MAAM,CAAC;QAC5B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvC,cAAc,GAAG,kBAAkB,CAAC;QACtC,CAAC;aAAM,IAAI,UAAU,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAClE,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,YAAY,CAAC;YACtD,IAAI,SAAS,EAAE,CAAC;gBACd,IAAI,CAAC;oBACH,QAAQ,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;oBACpC,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,sCAAsC,CAAC;gBAC7G,CAAC;gBAAC,MAAM,CAAC;oBACP,QAAQ,GAAG,SAAS,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAED,wEAAwE;QACxE,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAEjE,uDAAuD;QACvD,IAAI,YAAuC,CAAC;QAC5C,IAAI,QAA4B,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,SAAS,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,MAAM,gBAAgB,CACpC;gBACE,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,IAAI;gBACjB,GAAG,EAAE,QAAQ;gBACb,WAAW,EAAE,KAAK;gBAClB,WAAW,EAAE,MAAM;gBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,EACD,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAC1C,CAAC;YACF,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;gBACf,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,2BAA2B,OAAO,CAAC,IAAI,IAAI,SAAS,MAAM,OAAO,CAAC,KAAK,IAAI,eAAe,GACnG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EACxC,EAAE,CAAC;YACL,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrB,QAAQ,GAAG,uGAAuG,CAAC;QACrH,CAAC;QAED,iEAAiE;QACjE,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS;aAC9B,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;aAChF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACb,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI;gBAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,OAAO,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC3E,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAEnC,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CACnH,CAAC;QAEF,4CAA4C;QAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAEvF,IAAI,UAA8B,CAAC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC;QACzC,IAAI,WAAW,EAAE,CAAC;YAChB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACjD,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO;oBACtB,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;oBACtC,CAAC,CAAC,SAAS,CAAC,OAAO;wBACjB,CAAC,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC;wBAClC,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACjC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,aAAa,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAClF,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,EACvB,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;YACF,IAAI,MAAM,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;gBACtC,MAAM,IAAI,kBAAkB,CAC1B,4BAA4B,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAC9D,cAAc,EACd,EAAE,IAAI,EAAE,+FAA+F,EAAE,CAC1G,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAC1C,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5F,CAAC;QAED,aAAa;QACb,MAAM,KAAK,GAAa,CAAC,2BAA2B,IAAI,CAAC,WAAW,GAAG,EAAE,EAAE,CAAC,CAAC;QAC7E,IAAI,UAAU,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,eAAe,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,KAAK,cAAc,GAAG,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CACR,yBAAyB,QAAQ,CAAC,KAAK,CAAC,MAAM,kBAC5C,QAAQ,CAAC,YAAY,KAAK,YAAY;YACpC,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,QAAQ,CAAC,YAAY,KAAK,iBAAiB;gBAC3C,CAAC,CAAC,iBAAiB;gBACnB,CAAC,CAAC,cACR,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,EAC/C,EAAE,CACH,CAAC;QAEF,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;YACrC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;gBAC/C,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;YACtD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC,CAAC;YACxD,KAAK,MAAM,SAAS,IAAI,MAAM,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,YAAY;oBAC3B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;wBACnD,CAAC,CAAC,SAAS;wBACX,CAAC,CAAC,iBAAiB;oBACrB,CAAC,CAAC,EAAE,CAAC;gBACP,KAAK,CAAC,IAAI,CACR,OAAO,SAAS,CAAC,OAAO,QAAQ,SAAS,CAAC,IAAI,WAAW,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,IAAI,MAAM,QAAQ,GAAG,CAC3G,CAAC;YACJ,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CACR,6BAA6B,EAC7B,EAAE,EACF,+PAA+P,EAC/P,EAAE,CACH,CAAC;QACJ,CAAC;QAED,IAAI,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAE9C,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAEpF,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CACR,UAAU;YACR,CAAC,CAAC,+EAA+E;YACjF,CAAC,CAAC,wCAAwC,EAC5C,+CACE,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,QAClD,OAAO,EACP,6GAA6G,CAC9G,CAAC;QACF,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC;CACL,CAAC"}

package/dist/tools/get-failure.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Tool 2 — get-failure: deep analysis of a single failure from the most
+ * recent run-test execution (message, code frame, expected/actual,
+ * stack, diagnosis and concrete next steps).
+ */
+import { z } from 'zod';
+import type { ToolContext, ToolResponse } from '../types/index.js';
+declare const getFailureInput: z.ZodObject<{
+    index: z.ZodOptional<z.ZodNumber>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type GetFailureInput = z.infer<typeof getFailureInput>;
+export declare const getFailureSchema: z.ZodObject<{
+    index: z.ZodOptional<z.ZodNumber>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const getFailureTool: {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        index: z.ZodOptional<z.ZodNumber>;
+        projectRoot: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    handler: (args: GetFailureInput, ctx: ToolContext) => Promise<ToolResponse>;
+};
+export {};

package/dist/tools/get-failure.js

@@ -0,0 +1,220 @@
+/**
+ * Tool 2 — get-failure: deep analysis of a single failure from the most
+ * recent run-test execution (message, code frame, expected/actual,
+ * stack, diagnosis and concrete next steps).
+ */
+import { readFile } from 'node:fs/promises';
+import { z } from 'zod';
+import { PlaywrightMcpError } from '../types/index.js';
+import { parseReportJson } from '../utils/report-parser.js';
+import { readFailureTrace } from '../utils/trace-reader.js';
+import { codeFence, clipLines, failureHint, formatDuration, guard, toolText, } from './shared.js';
+const getFailureInput = z.object({
+    index: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe('1-based failure index from the last run (default 1)'),
+    projectRoot: z.string().optional().describe('Only used to re-read the stored report'),
+});
+export const getFailureSchema = getFailureInput;
+function nextSteps(failure, index) {
+    const steps = [];
+    const location = failure.file ? `${failure.file}${failure.line ? `:${failure.line}` : ''}` : undefined;
+    if (location) {
+        steps.push(`Re-run only this test: \`run-test\` with \`testFiles: ["${location}"]\`, \`headed: true\` to watch it live.`);
+    }
+    if (failure.failureKind === 'assertion' || failure.failureKind === 'timeout') {
+        if (location) {
+            steps.push(`Single-step with Playwright UI mode: \`run-test\` with \`args: ["--headed", "--debug"]\` on \`${location}\`.`);
+        }
+    }
+    if (/locator|selector|resolved to|waiting for/i.test(failure.message)) {
+        const selectorMatch = /locator\((['"`])(.+?)\1\)/.exec(failure.message);
+        const selector = selectorMatch ? selectorMatch[2] : '<your-selector>';
+        steps.push(`Verify the selector against the live page: \`validate-selector\` with \`selector: "${selector}"\`, or \`inspect-page\` to see the real DOM.`);
+    }
+    if (failure.failureKind === 'server-unreachable') {
+        steps.push('Start the dev server, then re-run the same test with `run-test`.');
+    }
+    if (failure.failureKind === 'browser-crash') {
+        steps.push('Run `npx playwright install --force` and close other Chrome/automation instances, then retry.');
+    }
+    steps.push(`Ask for this failure again with \`index: ${index}\` after re-running to compare.`);
+    return steps;
+}
+async function renderTraceContext(failure) {
+    if (!failure.tracePath) {
+        return [
+            '### DOM at failure',
+            '',
+            '> No trace was captured for this attempt. `run-test` passes `--trace=retain-on-failure` automatically; you can also set `trace: "retain-on-failure"` in playwright.config.* before running tests directly.',
+            '',
+        ].join('\n');
+    }
+    const trace = await readFailureTrace(failure.tracePath).catch(() => null);
+    if (trace === null) {
+        return [
+            '### DOM at failure',
+            '',
+            `> The trace archive is missing (\`${failure.tracePath}\`). The run may have been killed before Playwright flushed it — re-run the test to capture a fresh trace.`,
+            '',
+        ].join('\n');
+    }
+    const lines = ['### DOM at failure (Playwright trace)', ''];
+    if (trace.action) {
+        const selector = trace.action.selector ? ` \`${trace.action.selector}\`` : '';
+        const at = trace.atMs !== undefined ? ` at +${(trace.atMs / 1_000).toFixed(1)}s` : '';
+        lines.push(`**Failed action:** \`${trace.action.api}\`${selector}${at}`);
+        if (trace.action.params)
+            lines.push(`**Params:** \`${clipLines(trace.action.params, 1, 300)}\``);
+        lines.push('');
+    }
+    if (trace.actionLog.length > 0) {
+        lines.push('**Action log (last steps):**', '');
+        for (const entry of trace.actionLog) {
+            const marker = entry.failed ? '✗' : '•';
+            const summary = entry.summary ? ` \`${clipLines(entry.summary, 1, 160)}\`` : '';
+            lines.push(`- ${marker} \`${entry.api}\`${summary}`);
+        }
+        lines.push('');
+    }
+    if (trace.failedRequests.length > 0) {
+        const of = trace.networkTotal > 0 ? ` of ${trace.networkTotal} requests` : '';
+        lines.push(`### Network requests that failed (${trace.failedRequests.length}${of})`, '');
+        for (const req of trace.failedRequests) {
+            const status = req.status !== undefined
+                ? `**${req.status}${req.statusText ? ` ${req.statusText}` : ''}**`
+                : `**no response** (${req.errorText ?? 'request failed'})`;
+            const kind = req.resourceType ? ` (${req.resourceType})` : '';
+            const err = req.errorText && req.status !== undefined ? ` — ${clipLines(req.errorText, 1, 160)}` : '';
+            const url = clipLines(req.url, 1, 200);
+            lines.push(`- \`${req.method} ${url}\` → ${status}${kind}${err}`);
+        }
+        lines.push('');
+    }
+    if (trace.consoleMessages.length > 0) {
+        lines.push('### Console before the failure', '');
+        for (const msg of trace.consoleMessages) {
+            const icon = msg.type === 'error' ? '❌' : '⚠️';
+            const where = msg.location ? ` — \`${clipLines(msg.location, 1, 160)}\`` : '';
+            lines.push(`- ${icon} ${clipLines(msg.text, 1, 300)}${where}`);
+        }
+        lines.push('');
+    }
+    const html = trace.snippet ?? trace.snapshotHtml;
+    if (html) {
+        const title = trace.snippet
+            ? 'Parent container at failure:'
+            : `DOM snapshot at failure${trace.snapshotTruncated ? ' (truncated)' : ''}:`;
+        lines.push(title, '', codeFence(html, 'html'), '');
+    }
+    if (trace.errorContext) {
+        lines.push('Page accessibility tree at failure (Playwright `error-context`):', '', codeFence(clipLines(trace.errorContext, 60, 5_000), 'markdown'), '');
+    }
+    for (const warning of trace.warnings)
+        lines.push(`> ⚠️ ${warning}`);
+    if (trace.warnings.length > 0)
+        lines.push('');
+    return lines.join('\n');
+}
+async function renderFailureDetail(failure, index, total) {
+    const lines = [
+        `## Failure ${index} of ${total} — ${failure.title}`,
+        '',
+    ];
+    const location = failure.file
+        ? `\`${failure.file}${failure.line ? `:${failure.line}` : ''}\``
+        : '_configuration_';
+    const meta = [
+        failure.project ? `project **${failure.project}**` : undefined,
+        failure.retry !== undefined ? `attempt ${failure.retry + 1}` : undefined,
+        failure.durationMs !== undefined ? `took ${formatDuration(failure.durationMs)}` : undefined,
+        `status **${failure.status}**`,
+    ].filter(Boolean);
+    lines.push(`**File:** ${location}  |  ${meta.join(' · ')}`, '');
+    lines.push('### Error', '', codeFence(clipLines(failure.message, 30, 5_000), 'text'), '');
+    if (failure.expected !== undefined || failure.actual !== undefined) {
+        lines.push('### Expected vs actual', '');
+        if (failure.expected !== undefined)
+            lines.push(`- **Expected:** ${codeFence(failure.expected, 'text')}`);
+        if (failure.actual !== undefined)
+            lines.push(`- **Actual:** ${codeFence(failure.actual, 'text')}`);
+        lines.push('');
+    }
+    if (failure.stack && failure.stack.trim() !== '') {
+        lines.push('### Stack', '', codeFence(clipLines(failure.stack, 30, 4_000), 'text'), '');
+    }
+    if (failure.stdout && failure.stdout.trim() !== '') {
+        lines.push('### Test console output', '', codeFence(clipLines(failure.stdout, 20, 3_000), 'text'), '');
+    }
+    lines.push(await renderTraceContext(failure));
+    lines.push('### Diagnosis', '', `- **Kind:** \`${failure.failureKind}\``, `- ${failureHint(failure.failureKind)}`, '');
+    lines.push('### Next steps', '');
+    for (const [i, step] of nextSteps(failure, index).entries()) {
+        lines.push(`${i + 1}. ${step}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+export const getFailureTool = {
+    name: 'get-failure',
+    description: 'Analyze one failure from the most recent run-test execution: full message and code frame, expected vs actual, stack trace, failed network requests (4xx/5xx and dead endpoints), console errors, failure kind (assertion/timeout/browser-crash/syntax/config/server-unreachable) and concrete next steps. Use run-test first.',
+    inputSchema: getFailureSchema,
+    handler: async (args, ctx) => guard('get-failure', async () => {
+        const record = ctx.store.lastRun;
+        if (!record) {
+            throw new PlaywrightMcpError('No test run has happened yet', 'REPORT_MISSING', {
+                hint: 'Call run-test first — get-failure analyzes the failures of the most recent run.',
+            });
+        }
+        let failures = record.result.failures;
+        // The run-level result caps failures; re-read the JSON report for
+        // the full list when more failures were recorded than shown.
+        if (record.result.reportPath && record.result.failuresTruncated) {
+            const raw = await readFile(record.result.reportPath, 'utf8').catch(() => null);
+            if (raw !== null) {
+                const parsed = parseReportJson(raw, record.projectRoot, 200);
+                if (parsed.failures.length > failures.length)
+                    failures = parsed.failures;
+            }
+        }
+        const total = failures.length;
+        if (total === 0) {
+            const stats = record.result.stats;
+            const summary = stats
+                ? `Last run: ${stats.expected} passed, ${stats.unexpected} failed, ${stats.flaky} flaky, ${stats.skipped} skipped.`
+                : 'Last run produced no failures.';
+            return toolText([
+                '## ✅ No failures to analyze',
+                '',
+                summary,
+                '',
+                record.result.errorKind
+                    ? `Note: the run reported \`${record.result.errorKind}\` — ${record.result.errorMessage ?? ''}`
+                    : '',
+            ]
+                .filter(Boolean)
+                .join('\n'));
+        }
+        const index = Math.min(args.index ?? 1, total);
+        const failure = failures[index - 1];
+        const parts = [await renderFailureDetail(failure, index, total)];
+        if (total > 1) {
+            parts.push('### All failures in this run', '');
+            for (let i = 0; i < failures.length; i += 1) {
+                const f = failures[i];
+                parts.push(`${i + 1}. ${i + 1 === index ? '**→** ' : ''}${f.title} — \`${f.failureKind}\`${f.file ? ` (${f.file}${f.line ? `:${f.line}` : ''})` : ''}`);
+            }
+            parts.push('');
+        }
+        const run = record.result;
+        parts.push('### Run context', '', `- **Command:** \`${run.command}\``, `- **Duration:** ${formatDuration(run.durationMs)} · **Exit:** ${run.exitCode ?? '—'}`, run.errorKind ? `- **Run issue:** \`${run.errorKind}\` — ${run.errorMessage ?? ''}` : undefined, run.hint ? `- **Hint:** ${run.hint.replace(/\n/g, ' ')}` : undefined, '');
+        if (run.stderrTail.trim() !== '') {
+            parts.push('<details><summary>stderr tail</summary>', '', codeFence(clipLines(run.stderrTail, 50, 5_000), 'text'), '', '</details>', '');
+        }
+        return toolText(parts.filter((part) => part !== undefined).join('\n'));
+    }),
+};
+//# sourceMappingURL=get-failure.js.map

package/dist/tools/get-failure.js.map

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