@fasttest-ai/qa-agent 0.1.0

package/dist/healer.js

@@ -0,0 +1,258 @@
+/**
+ * Self-healing module — locator repair cascade.
+ *
+ * When a test step fails with a selector error, the healer tries:
+ *   1. data-testid  (confidence: 98%)
+ *   2. ARIA labels   (confidence: 95%)
+ *   3. Text content  (confidence: 90%)
+ *   4. Structural    (confidence: 85%)
+ *   5. AI-generated  (confidence: 75%) — via Cloud LLM call
+ *
+ * After a successful heal the pattern is stored in the Cloud DB so
+ * future failures with the same signature are fixed instantly.
+ */
+import * as actions from "./actions.js";
+// ---------------------------------------------------------------------------
+// Strategy confidence map
+// ---------------------------------------------------------------------------
+const CONFIDENCE = {
+    data_testid: 0.98,
+    aria: 0.95,
+    text: 0.90,
+    structural: 0.85,
+    ai: 0.75,
+};
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+/**
+ * Attempt to heal a broken selector by trying 5 strategies in order.
+ * Returns the first working selector with its confidence score.
+ */
+export async function healSelector(page, cloud, originalSelector, failureType, errorMessage, pageUrl) {
+    // 1. Check Cloud for a stored pattern first
+    try {
+        const classification = await cloud.post("/qa/healing/classify", {
+            failure_type: failureType,
+            selector: originalSelector,
+            page_url: pageUrl,
+            error_message: errorMessage,
+        });
+        if (classification.is_real_bug) {
+            return { healed: false, error: classification.reason ?? "Classified as real bug" };
+        }
+        if (classification.pattern) {
+            // Validate the stored pattern still works
+            const found = await testSelector(page, classification.pattern.healed_value);
+            if (found) {
+                return {
+                    healed: true,
+                    newSelector: classification.pattern.healed_value,
+                    strategy: classification.pattern.strategy,
+                    confidence: classification.pattern.confidence,
+                };
+            }
+        }
+    }
+    catch {
+        // Non-fatal — continue with local strategies
+    }
+    // 2. Try local repair strategies in order
+    const strategies = [
+        { name: "data_testid", fn: () => tryDataTestId(page, originalSelector) },
+        { name: "aria", fn: () => tryAria(page, originalSelector) },
+        { name: "text", fn: () => tryTextContent(page, originalSelector) },
+        { name: "structural", fn: () => tryStructural(page, originalSelector) },
+    ];
+    for (const strategy of strategies) {
+        const candidate = await strategy.fn();
+        if (candidate) {
+            // Report the pattern to Cloud for future reuse
+            await storePatternQuietly(cloud, failureType, originalSelector, candidate, strategy.name, CONFIDENCE[strategy.name] ?? 0.8, pageUrl);
+            return {
+                healed: true,
+                newSelector: candidate,
+                strategy: strategy.name,
+                confidence: CONFIDENCE[strategy.name],
+            };
+        }
+    }
+    // 3. AI-generated — ask the Cloud LLM
+    try {
+        const snapshot = await actions.getSnapshot(page);
+        const suggestions = await cloud.post("/qa/healing/ai-suggest", {
+            original_selector: originalSelector,
+            page_snapshot: JSON.stringify(snapshot),
+            error_message: errorMessage,
+            page_url: pageUrl,
+        });
+        for (const suggestion of suggestions.suggestions ?? []) {
+            const found = await testSelector(page, suggestion.selector);
+            if (found) {
+                await storePatternQuietly(cloud, failureType, originalSelector, suggestion.selector, "ai", suggestion.confidence, pageUrl);
+                return {
+                    healed: true,
+                    newSelector: suggestion.selector,
+                    strategy: "ai",
+                    confidence: suggestion.confidence,
+                };
+            }
+        }
+    }
+    catch {
+        // Non-fatal
+    }
+    return { healed: false, error: "All healing strategies exhausted" };
+}
+// ---------------------------------------------------------------------------
+// Strategy implementations
+// ---------------------------------------------------------------------------
+async function testSelector(page, selector) {
+    try {
+        const el = await page.$(selector);
+        return el !== null;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Strategy 1: Look for a data-testid attribute near the original selector.
+ */
+async function tryDataTestId(page, original) {
+    try {
+        // Extract a meaningful name from the original selector
+        const name = extractName(original);
+        if (!name)
+            return null;
+        const candidates = [
+            `[data-testid="${name}"]`,
+            `[data-testid*="${name}"]`,
+            `[data-test="${name}"]`,
+            `[data-test-id="${name}"]`,
+        ];
+        for (const sel of candidates) {
+            if (await testSelector(page, sel))
+                return sel;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Strategy 2: Look for ARIA labels matching the original element.
+ */
+async function tryAria(page, original) {
+    try {
+        const name = extractName(original);
+        if (!name)
+            return null;
+        const candidates = [
+            `[aria-label="${name}"]`,
+            `[aria-label*="${name}"]`,
+            `[role][aria-label*="${name}"]`,
+        ];
+        for (const sel of candidates) {
+            if (await testSelector(page, sel))
+                return sel;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Strategy 3: Use text content to find the element.
+ */
+async function tryTextContent(page, original) {
+    try {
+        const name = extractName(original);
+        if (!name)
+            return null;
+        // Try Playwright's text-based selectors
+        const candidates = [
+            `text="${name}"`,
+            `:has-text("${name}")`,
+            `button:has-text("${name}")`,
+            `a:has-text("${name}")`,
+        ];
+        for (const sel of candidates) {
+            if (await testSelector(page, sel))
+                return sel;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Strategy 4: Use structural/parent-child relationships.
+ */
+async function tryStructural(page, original) {
+    try {
+        // Try tag-based selectors derived from original
+        const tagMatch = original.match(/^([a-z]+)/i);
+        const tag = tagMatch?.[1] ?? "";
+        const name = extractName(original);
+        if (!tag && !name)
+            return null;
+        const candidates = [];
+        if (tag && name) {
+            candidates.push(`${tag}[name="${name}"]`);
+            candidates.push(`${tag}[id*="${name}"]`);
+            candidates.push(`${tag}[class*="${name}"]`);
+            candidates.push(`form ${tag}[type="submit"]`);
+        }
+        else if (tag) {
+            candidates.push(`form >> ${tag}[type="submit"]`);
+        }
+        for (const sel of candidates) {
+            if (await testSelector(page, sel))
+                return sel;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extract a meaningful name from a CSS selector.
+ * e.g. "#login-btn" → "login-btn", ".submit-button" → "submit-button"
+ */
+function extractName(selector) {
+    // Strip leading # or .
+    let name = selector.replace(/^[#.]/, "");
+    // Strip attribute selectors
+    name = name.replace(/\[.*\]/, "");
+    // Strip pseudo selectors
+    name = name.replace(/:.*/, "");
+    // Strip combinators
+    name = name.split(/\s+/)[0] ?? "";
+    // Strip tag names followed by class/id
+    name = name.replace(/^[a-z]+[#.]/, "");
+    return name || null;
+}
+async function storePatternQuietly(cloud, failureType, originalValue, healedValue, strategy, confidence, pageUrl) {
+    try {
+        await cloud.post("/qa/healing/patterns", {
+            failure_type: failureType,
+            original_value: originalValue,
+            healed_value: healedValue,
+            strategy,
+            confidence,
+            page_url: pageUrl,
+        });
+    }
+    catch {
+        // Non-fatal — pattern storage failure shouldn't block test execution
+    }
+}
+//# sourceMappingURL=healer.js.map

package/dist/healer.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * QA Agent — MCP server (stdio transport).
+ *
+ * This is the ONLY MCP server in the architecture.
+ * Flow: Claude Code → MCP → Local Skill → HTTPS → Cloud API
+ *
+ * Exposes:
+ *   - 10 browser tools (Playwright, runs locally)
+ *   - Cloud-forwarding tools (test, answer, approve, explore, run, status, cancel, etc.)
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,394 @@
+#!/usr/bin/env node
+/**
+ * QA Agent — MCP server (stdio transport).
+ *
+ * This is the ONLY MCP server in the architecture.
+ * Flow: Claude Code → MCP → Local Skill → HTTPS → Cloud API
+ *
+ * Exposes:
+ *   - 10 browser tools (Playwright, runs locally)
+ *   - Cloud-forwarding tools (test, answer, approve, explore, run, status, cancel, etc.)
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { BrowserManager } from "./browser.js";
+import { CloudClient } from "./cloud.js";
+import * as actions from "./actions.js";
+import { executeRun } from "./runner.js";
+import { healSelector } from "./healer.js";
+// ---------------------------------------------------------------------------
+// CLI arg parsing
+// ---------------------------------------------------------------------------
+function parseArgs() {
+    const args = process.argv.slice(2);
+    let apiKey = "";
+    let baseUrl = "http://localhost:9000";
+    let headless = true;
+    let browserType = "chromium";
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--api-key" && args[i + 1]) {
+            apiKey = args[++i];
+        }
+        else if (args[i] === "--base-url" && args[i + 1]) {
+            baseUrl = args[++i];
+        }
+        else if (args[i] === "--headed") {
+            headless = false;
+        }
+        else if (args[i] === "--browser" && args[i + 1]) {
+            browserType = args[++i];
+        }
+    }
+    if (!apiKey) {
+        console.error("Usage: qa-agent --api-key <key> [--base-url <url>] [--headed] [--browser chromium|firefox|webkit]");
+        process.exit(1);
+    }
+    return { apiKey, baseUrl, headless, browser: browserType };
+}
+// ---------------------------------------------------------------------------
+// Console log collector
+// ---------------------------------------------------------------------------
+const consoleLogs = [];
+const MAX_LOGS = 500;
+// ---------------------------------------------------------------------------
+// Boot
+// ---------------------------------------------------------------------------
+const config = parseArgs();
+const orgSlug = config.apiKey.split("_")[1] ?? "default";
+const browserMgr = new BrowserManager({
+    browserType: config.browser,
+    headless: config.headless,
+    orgSlug,
+});
+const cloud = new CloudClient({ apiKey: config.apiKey, baseUrl: config.baseUrl });
+const server = new McpServer({
+    name: "qa-agent",
+    version: "0.1.0",
+});
+// ---------------------------------------------------------------------------
+// Browser Tools (local Playwright)
+// ---------------------------------------------------------------------------
+server.tool("browser_navigate", "Navigate to a URL in the browser", { url: z.string().describe("URL to navigate to") }, async ({ url }) => {
+    const page = await browserMgr.ensureBrowser();
+    attachConsoleListener(page);
+    const result = await actions.navigate(page, url);
+    const snapshot = await actions.getSnapshot(page);
+    return {
+        content: [{ type: "text", text: JSON.stringify({ ...result, snapshot }, null, 2) }],
+    };
+});
+server.tool("browser_click", "Click an element on the page", { selector: z.string().describe("CSS selector of the element to click") }, async ({ selector }) => {
+    const page = await browserMgr.getPage();
+    const result = await actions.click(page, selector);
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+});
+server.tool("browser_fill", "Fill a form field with a value", {
+    selector: z.string().describe("CSS selector of the input"),
+    value: z.string().describe("Value to type"),
+}, async ({ selector, value }) => {
+    const page = await browserMgr.getPage();
+    const result = await actions.fill(page, selector, value);
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+});
+server.tool("browser_screenshot", "Capture a screenshot of the current page", { full_page: z.boolean().optional().describe("Capture full page (default false)") }, async ({ full_page }) => {
+    const page = await browserMgr.getPage();
+    const b64 = await actions.screenshot(page, full_page ?? false);
+    return {
+        content: [{ type: "image", data: b64, mimeType: "image/jpeg" }],
+    };
+});
+server.tool("browser_snapshot", "Get the accessibility tree of the current page", {}, async () => {
+    const page = await browserMgr.getPage();
+    const snapshot = await actions.getSnapshot(page);
+    return { content: [{ type: "text", text: JSON.stringify(snapshot, null, 2) }] };
+});
+server.tool("browser_assert", "Run an assertion against the live page", {
+    type: z.enum([
+        "element_visible", "element_hidden", "text_contains", "text_equals",
+        "url_contains", "url_equals", "element_count", "attribute_value",
+    ]).describe("Assertion type"),
+    selector: z.string().optional().describe("CSS selector (for element assertions)"),
+    text: z.string().optional().describe("Expected text"),
+    url: z.string().optional().describe("Expected URL"),
+    count: z.number().optional().describe("Expected element count"),
+    attribute: z.string().optional().describe("Attribute name"),
+    value: z.string().optional().describe("Expected attribute value"),
+}, async (params) => {
+    const page = await browserMgr.getPage();
+    const result = await actions.assertPage(page, params);
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+});
+server.tool("browser_wait", "Wait for an element to appear or a timeout", {
+    selector: z.string().optional().describe("CSS selector to wait for"),
+    timeout_ms: z.number().optional().describe("Timeout in milliseconds (default 10000)"),
+}, async ({ selector, timeout_ms }) => {
+    const page = await browserMgr.getPage();
+    if (selector) {
+        const result = await actions.waitFor(page, selector, timeout_ms ?? 10_000);
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    }
+    await new Promise((r) => setTimeout(r, timeout_ms ?? 1000));
+    return { content: [{ type: "text", text: JSON.stringify({ success: true }) }] };
+});
+server.tool("browser_console_logs", "Get captured console log messages from the page", {}, async () => {
+    return {
+        content: [{ type: "text", text: JSON.stringify(consoleLogs.slice(-100)) }],
+    };
+});
+server.tool("browser_save_session", "Save the current browser session (cookies, localStorage) for reuse", { name: z.string().describe("Session name (e.g. 'admin', 'user')") }, async ({ name }) => {
+    const filePath = await browserMgr.saveSession(name);
+    return { content: [{ type: "text", text: `Session saved: ${filePath}` }] };
+});
+server.tool("browser_restore_session", "Restore a previously saved browser session", { name: z.string().describe("Session name to restore") }, async ({ name }) => {
+    const page = await browserMgr.restoreSession(name);
+    attachConsoleListener(page);
+    return { content: [{ type: "text", text: `Session "${name}" restored` }] };
+});
+// ---------------------------------------------------------------------------
+// Cloud-forwarding Tools
+// ---------------------------------------------------------------------------
+server.tool("test", "Start a conversational test session. Describe what you want to test.", {
+    description: z.string().describe("What to test (natural language)"),
+    url: z.string().optional().describe("App URL to test against"),
+}, async ({ description, url }) => {
+    const result = await cloud.startConversation({ description, url });
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("answer", "Respond to the agent's clarifying questions", {
+    session_id: z.string().describe("Session ID from the test call"),
+    answers: z.string().describe("Your responses to the agent's questions"),
+}, async ({ session_id, answers }) => {
+    const result = await cloud.answerConversation(session_id, answers);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("approve", "Approve the generated test plan and start execution", {
+    session_id: z.string().describe("Session ID"),
+    exclude: z.array(z.number()).optional().describe("Test case numbers to skip"),
+}, async ({ session_id, exclude }) => {
+    const result = await cloud.approveConversation(session_id, exclude);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("explore", "Autonomously explore a web application and discover testable flows", {
+    url: z.string().describe("Starting URL"),
+    max_pages: z.number().optional().describe("Max pages to explore (default 20)"),
+    focus: z.enum(["forms", "navigation", "errors", "all"]).optional().describe("Exploration focus"),
+}, async ({ url, max_pages, focus }) => {
+    // Step 1: Navigate locally to get initial snapshot
+    const page = await browserMgr.ensureBrowser();
+    attachConsoleListener(page);
+    await actions.navigate(page, url);
+    const snapshot = await actions.getSnapshot(page);
+    const screenshotB64 = await actions.screenshot(page, false);
+    // Step 2: Send to cloud for AI analysis
+    const result = await cloud.startExploration({
+        url,
+        max_pages: max_pages ?? 20,
+        focus: focus ?? "all",
+    });
+    return {
+        content: [
+            { type: "text", text: JSON.stringify({ ...result, initial_snapshot: snapshot }, null, 2) },
+            { type: "image", data: screenshotB64, mimeType: "image/jpeg" },
+        ],
+    };
+});
+// ---------------------------------------------------------------------------
+// Execution Tools (Phase 3)
+// ---------------------------------------------------------------------------
+server.tool("run", "Run a test suite. Executes all test cases in a real browser and returns results. Optionally posts results as a GitHub PR comment.", {
+    suite_id: z.string().describe("Test suite ID to run"),
+    test_case_ids: z.array(z.string()).optional().describe("Specific test case IDs to run (default: all in suite)"),
+    pr_url: z.string().optional().describe("GitHub PR URL — if provided, posts results as a PR comment (e.g. https://github.com/owner/repo/pull/123)"),
+}, async ({ suite_id, test_case_ids, pr_url }) => {
+    const summary = await executeRun(browserMgr, cloud, {
+        suiteId: suite_id,
+        testCaseIds: test_case_ids,
+    }, consoleLogs);
+    // Format a human-readable summary
+    const lines = [
+        `# Test Run ${summary.status === "passed" ? "✅ PASSED" : "❌ FAILED"}`,
+        `Execution ID: ${summary.execution_id}`,
+        `Total: ${summary.total} | Passed: ${summary.passed} | Failed: ${summary.failed} | Skipped: ${summary.skipped}`,
+        `Duration: ${(summary.duration_ms / 1000).toFixed(1)}s`,
+        "",
+    ];
+    for (const r of summary.results) {
+        const icon = r.status === "passed" ? "✅" : r.status === "failed" ? "❌" : "⏭️";
+        lines.push(`${icon} ${r.name} (${r.duration_ms}ms)`);
+        if (r.error) {
+            lines.push(`   Error: ${r.error}`);
+        }
+    }
+    // Show healing summary if any heals occurred
+    if (summary.healed.length > 0) {
+        lines.push("");
+        lines.push(`## Self-Healed: ${summary.healed.length} selector(s)`);
+        for (const h of summary.healed) {
+            lines.push(`  🔧 "${h.test_case}" step ${h.step_index + 1}`);
+            lines.push(`     ${h.original_selector} → ${h.new_selector}`);
+            lines.push(`     Strategy: ${h.strategy} (${Math.round(h.confidence * 100)}% confidence)`);
+        }
+    }
+    // Post PR comment if pr_url was provided
+    if (pr_url) {
+        try {
+            const prResult = await cloud.postPrComment({
+                pr_url,
+                execution_id: summary.execution_id,
+                status: summary.status,
+                total: summary.total,
+                passed: summary.passed,
+                failed: summary.failed,
+                skipped: summary.skipped,
+                duration_seconds: Math.round(summary.duration_ms / 1000),
+                test_results: summary.results.map((r) => ({
+                    name: r.name,
+                    status: r.status,
+                    error: r.error,
+                })),
+                healed: summary.healed.map((h) => ({
+                    original_selector: h.original_selector,
+                    new_selector: h.new_selector,
+                    strategy: h.strategy,
+                    confidence: h.confidence,
+                })),
+            });
+            const commentUrl = prResult.comment_url;
+            lines.push("");
+            lines.push(`📝 PR comment posted: ${commentUrl ?? pr_url}`);
+        }
+        catch (err) {
+            lines.push("");
+            lines.push(`⚠️ Failed to post PR comment: ${err}`);
+        }
+    }
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+    };
+});
+server.tool("github_token", "Set the GitHub personal access token for PR integration", {
+    token: z.string().describe("GitHub personal access token (PAT) with repo scope"),
+}, async ({ token }) => {
+    await cloud.setGithubToken(token);
+    return { content: [{ type: "text", text: "GitHub token stored securely." }] };
+});
+server.tool("status", "Check the status of a test execution", {
+    execution_id: z.string().describe("Execution ID to check"),
+}, async ({ execution_id }) => {
+    const result = await cloud.getExecutionStatus(execution_id);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("cancel", "Cancel a running test execution", {
+    execution_id: z.string().describe("Execution ID to cancel"),
+}, async ({ execution_id }) => {
+    const result = await cloud.cancelExecution(execution_id);
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("list_projects", "List all QA projects in the organization", {}, async () => {
+    const result = await cloud.listProjects();
+    return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+});
+server.tool("health", "Check if the QA agent backend is reachable", {}, async () => {
+    const result = await cloud.health();
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+});
+// ---------------------------------------------------------------------------
+// Healing Tools (Phase 5)
+// ---------------------------------------------------------------------------
+server.tool("heal", "Attempt to heal a broken selector by trying alternative locator strategies", {
+    selector: z.string().describe("The broken CSS selector"),
+    page_url: z.string().optional().describe("URL where the selector broke (defaults to current page)"),
+    error_message: z.string().optional().describe("The error message from Playwright"),
+}, async ({ selector, page_url, error_message }) => {
+    const page = await browserMgr.getPage();
+    const url = page_url ?? page.url();
+    const result = await healSelector(page, cloud, selector, "ELEMENT_NOT_FOUND", error_message ?? "Element not found", url);
+    if (result.healed) {
+        return {
+            content: [{
+                    type: "text",
+                    text: [
+                        `🔧 Selector healed!`,
+                        `  Original: ${selector}`,
+                        `  New:      ${result.newSelector}`,
+                        `  Strategy: ${result.strategy} (${Math.round((result.confidence ?? 0) * 100)}% confidence)`,
+                    ].join("\n"),
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: "text",
+                text: `❌ Could not heal selector: ${selector}\n  ${result.error ?? "All strategies exhausted"}`,
+            }],
+    };
+});
+server.tool("healing_history", "View healing patterns and statistics for the organization", {
+    limit: z.number().optional().describe("Max patterns to return (default 20)"),
+}, async ({ limit }) => {
+    const [patterns, stats] = await Promise.all([
+        cloud.get(`/qa/healing/patterns?limit=${limit ?? 20}`),
+        cloud.get("/qa/healing/statistics"),
+    ]);
+    const lines = [
+        `# Healing Statistics`,
+        `Total healed: ${stats.total_healed ?? 0}`,
+        `Patterns stored: ${stats.patterns_count ?? 0}`,
+        `Avg confidence: ${Math.round((stats.avg_confidence ?? 0) * 100)}%`,
+        "",
+    ];
+    const breakdown = stats.strategy_breakdown;
+    if (breakdown && Object.keys(breakdown).length > 0) {
+        lines.push("Strategy breakdown:");
+        for (const [strategy, count] of Object.entries(breakdown)) {
+            lines.push(`  ${strategy}: ${count} heals`);
+        }
+        lines.push("");
+    }
+    if (Array.isArray(patterns) && patterns.length > 0) {
+        lines.push("Recent patterns:");
+        for (const p of patterns) {
+            lines.push(`  ${p.original_value} → ${p.healed_value} (${p.strategy}, ${p.times_applied}x)`);
+        }
+    }
+    return {
+        content: [{ type: "text", text: lines.join("\n") }],
+    };
+});
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const attachedPages = new WeakSet();
+function attachConsoleListener(page) {
+    if (attachedPages.has(page))
+        return;
+    attachedPages.add(page);
+    page.on("console", (msg) => {
+        const entry = `[${msg.type()}] ${msg.text()}`;
+        consoleLogs.push(entry);
+        if (consoleLogs.length > MAX_LOGS)
+            consoleLogs.shift();
+    });
+}
+// ---------------------------------------------------------------------------
+// Start
+// ---------------------------------------------------------------------------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Cleanup on exit
+    process.on("SIGINT", async () => {
+        await browserMgr.close();
+        process.exit(0);
+    });
+    process.on("SIGTERM", async () => {
+        await browserMgr.close();
+        process.exit(0);
+    });
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map