@lisa.ai/agent 2.2.1 → 2.3.0

package/dist/services/installer.service.js

@@ -1,60 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AutoInstallerService = void 0;
-const child_process_1 = require("child_process");
-class AutoInstallerService {
-    /**
-     * Natively executes NPM installation commands if a framework is completely devoid of testing tooling.
-     */
-    static async installMissingFramework(fingerprint, projectPath = process.cwd()) {
-        if (fingerprint.testingFramework !== 'none') {
-            return fingerprint; // Already fully equipped
-        }
-        console.log(`\n[Lisa.ai Auto-Installer] 🚨 No testing framework detected for ${fingerprint.type} architecture.`);
-        console.log(`[Lisa.ai Auto-Installer] 🪄 Initiating Zero-Config Installation Protocol...`);
-        let installCmd = '';
-        let testingTarget = 'none';
-        switch (fingerprint.type) {
-            case 'angular':
-                // Angular historically uses Karma/Jasmine natively, though modern might prefer Jest. 
-                // We'll provision standard Jasmine/Karma to align with standard Angular builders.
-                console.log(`[Lisa.ai Auto-Installer] Provisioning Angular TestBed environment...`);
-                installCmd = 'npm install --save-dev karma karma-chrome-launcher karma-coverage karma-jasmine jasmine-core @types/jasmine';
-                testingTarget = 'karma';
-                fingerprint.suggestedTestCommand = 'npm run test';
-                break;
-            case 'react':
-            case 'node':
-            default:
-                // Jest is the safest, most ubiquitous generic fallback for React and Node JS.
-                console.log(`[Lisa.ai Auto-Installer] Provisioning Universal Jest environment...`);
-                installCmd = 'npm install --save-dev jest @types/jest ts-jest';
-                testingTarget = 'jest';
-                fingerprint.suggestedTestCommand = 'npx jest --coverage';
-                break;
-            case 'vue':
-                // Vitest is the modern standard for Vue 3 / Vite ecosystems
-                console.log(`[Lisa.ai Auto-Installer] Provisioning Vue Vitest environment...`);
-                installCmd = 'npm install --save-dev vitest @vue/test-utils jsdom';
-                testingTarget = 'vitest';
-                fingerprint.suggestedTestCommand = 'npx vitest run --coverage';
-                break;
-        }
-        if (installCmd) {
-            console.log(`[Lisa.ai Executing] ${installCmd}`);
-            const parts = installCmd.split(' ');
-            const childTarget = process.platform === 'win32' ? `${parts[0]}.cmd` : parts[0];
-            // Execute natively blocking so the repository is fully built before the agent tries to test it
-            const result = (0, child_process_1.spawnSync)(childTarget, parts.slice(1), { cwd: projectPath, stdio: 'inherit' });
-            if (result.status !== 0) {
-                console.error(`\n❌ [Lisa.ai Auto-Installer] Failed to construct dynamic testing environment.`);
-                process.exit(1);
-            }
-            console.log(`✅ [Lisa.ai Auto-Installer] Framework successfully injected.`);
-            fingerprint.testingFramework = testingTarget;
-            return fingerprint;
-        }
-        return fingerprint;
-    }
-}
-exports.AutoInstallerService = AutoInstallerService;

package/dist/services/llm.service.js

@@ -1,173 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.askLisaForFix = askLisaForFix;
-exports.generateTestForFile = generateTestForFile;
-exports.updateTestForFile = updateTestForFile;
-exports.askLisaGeneral = askLisaGeneral;
-const ai_1 = require("ai");
-const openai_1 = require("@ai-sdk/openai");
-const anthropic_1 = require("@ai-sdk/anthropic");
-const google_1 = require("@ai-sdk/google");
-const path = __importStar(require("path"));
-const dotenv = __importStar(require("dotenv"));
-dotenv.config({ path: path.resolve(__dirname, '../../.env'), quiet: true });
-function getProvider(provider, apiKey) {
-    if (provider === 'claude') {
-        const key = apiKey || process.env.ANTHROPIC_API_KEY;
-        if (!key)
-            throw new Error('No Anthropic API key provided by local ENV or Control Plane');
-        // Bug 2 fix: claude-3-haiku is too weak for complex DI/module fixes.
-        // claude-3-5-sonnet is significantly better at understanding Angular/React test scaffolding.
-        return (0, anthropic_1.createAnthropic)({ apiKey: key })('claude-3-5-sonnet-20241022');
-    }
-    if (provider === 'openai') {
-        const key = apiKey || process.env.OPENAI_API_KEY;
-        if (!key)
-            throw new Error('No OpenAI API key provided by local ENV or Control Plane');
-        // Bug 2 fix: gpt-3.5-turbo is deprecated and produces low-quality code fixes.
-        return (0, openai_1.createOpenAI)({ apiKey: key })('gpt-4o-mini');
-    }
-    const key = apiKey || process.env.GOOGLE_GENERATIVE_AI_API_KEY;
-    if (!key)
-        throw new Error('No Google API key provided by local ENV or Control Plane');
-    return (0, google_1.createGoogleGenerativeAI)({ apiKey: key })('gemini-1.5-pro-latest');
-}
-async function askLisaForFix(filePath, fileContent, errorLog, modelProvider, apiKey, previousFixAttempt, siblingContext) {
-    console.log(`[Lisa.ai Auto-Heal] Requesting fix from ${modelProvider} for ${filePath}...`);
-    const model = getProvider(modelProvider, apiKey);
-    let prompt = "You are Lisa.ai, an autonomous CI/CD expert platform.\n" +
-        "A build/compilation error occurred. Your task is to fix the provided file so that the error resolves.\n\n" +
-        "--- Error Log ---\n" + errorLog + "\n\n" +
-        "--- Target File Content (" + filePath + ") ---\n" + fileContent + "\n\n" +
-        "--- Constraints ---\n" +
-        "1. Do not delete business logic unless absolutely necessary to resolve a missing dependency.\n" +
-        "2. Do not suppress TypeScript errors with @ts-ignore or any type assertions unless absolutely unavoidable.\n" +
-        "3. Fix the underlying type or logic issue.\n" +
-        "4. CRITICAL AGILE RULE: If the error is 'Cannot find module' or 'Property DOES NOT EXIST' and you do NOT know the correct import path or cannot resolve it from the context, you MUST silently comment out the failing import and completely comment out/stub the code that relies on it. Your ultimate goal is to make the file compile successfully so the Agent can proceed to the next file.\n" +
-        "5. FRAMEWORK TEST RULE: If fixing a testing file ('.spec' or '.test') and an Angular error happens like 'NullInjectorError: No provider for X', you MUST add X to the 'providers' array in 'TestBed.configureTestingModule' or import the required testing module. If a React testing library error arises, fix the render context.\n" +
-        "6. CRITICAL ANGULAR RULE: If an Angular component imports 'RouterLink' or uses '[routerLink]' in its template, you MUST provide 'ActivatedRoute' in the providers array or import 'RouterTestingModule'. If it uses HTTP, import 'HttpClientTestingModule'.\n" +
-        "7. CRITICAL STANDALONE RULE: If a component has 'standalone: true' in its decorator (check the Sibling Context!), you MUST NOT add it to the 'declarations' array. Instead, you MUST add it to the 'imports' array within 'TestBed.configureTestingModule'.\n" +
-        "8. Return the code wrapped in a markdown code block (```typescript ... ```). Do not include any explanation or intro text.";
-    if (siblingContext) {
-        const isStandalone = /standalone\s*:\s*true/.test(siblingContext);
-        if (isStandalone) {
-            const classMatch = siblingContext.match(/export class (\w+)/);
-            const className = classMatch ? classMatch[1] : 'the component';
-            prompt += "\n\n--- CRITICAL ARCHITECTURAL REQUIREMENT ---\n" +
-                "The component " + className + " is marked as STANDALONE (standalone: true).\n" +
-                "You MUST add " + className + " to the 'imports' array within 'TestBed.configureTestingModule'.\n" +
-                "DO NOT add it to the 'declarations' array. If you omit " + className + " from 'imports', the test will fail.";
-        }
-        prompt += "\n\n--- Sibling Component / Service Context ---\n" +
-            "You are fixing a '.spec' test file. Here is the actual implementation code for the component you are testing.\n" +
-            "Use this to identify EXACTLY which imports, Services, and Variables need to be mocked inside your 'TestBed'.\n" +
-            siblingContext;
-    }
-    if (previousFixAttempt) {
-        console.log(`[Lisa.ai Auto-Heal] Warning! Agent is looping on ${filePath}. Injecting previous failed context...`);
-        prompt += "\n\n--- CRITICAL WARNING ---\n" +
-            "You previously attempted to fix this file but the compiler REJECTED your fix!\n" +
-            "Here is the previous analysis and failed fix you attempted:\n" +
-            previousFixAttempt + "\n\n" +
-            "DO NOT repeat the identical code changes. Try a completely different programming approach, fix syntax typos, or check for missing imports.";
-    }
-    const { text } = await (0, ai_1.generateText)({
-        model,
-        prompt,
-    });
-    // Bug 1 fix: handle javascript/js code blocks in addition to typescript/ts.
-    // Without this, JS file fixes from the LLM using ```javascript blocks are not extracted —
-    // the raw markdown (including ``` markers) gets written to disk, permanently corrupting the file.
-    const match = text.match(/```(?:typescript|ts|javascript|js)?\n([\s\S]*?)```/);
-    return match ? match[1].trim() : text.trim();
-}
-async function generateTestForFile(sourceFilePath, sourceFileContent, modelProvider, apiKey, framework) {
-    console.log(`[Lisa.ai Coverage] Requesting test generation from ${modelProvider} for ${sourceFilePath}...`);
-    const model = getProvider(modelProvider, apiKey);
-    // Bug 3 fix: include the detected testing framework in the prompt so the LLM doesn't
-    // randomly pick Jest syntax for a Karma project (or vice-versa), causing immediate
-    // compile failures that trigger an unnecessary heal loop.
-    const frameworkInstruction = framework
-        ? `3. You MUST use the '${framework}' testing framework exclusively. All imports, describe/it/test blocks, and mock utilities must follow '${framework}' conventions.\n`
-        : "3. Include all necessary imports assuming a standard testing framework (Jest/Karma/Vitest) is available.\n";
-    const prompt = "You are Lisa.ai, an autonomous CI/CD expert platform.\n" +
-        "A source file lacks 100% test coverage. Your task is to generate a comprehensive testing suite covering all branches, lines, and functions.\n\n" +
-        "--- Target File Content (" + sourceFilePath + ") ---\n" + sourceFileContent + "\n\n" +
-        "--- Constraints ---\n" +
-        "1. Return the generated test code wrapped in a markdown code block (```typescript ... ```).\n" +
-        "2. Do not include any explanation or intro text.\n" +
-        frameworkInstruction +
-        "4. Aim for 100% logic coverage.";
-    const { text } = await (0, ai_1.generateText)({
-        model,
-        prompt,
-    });
-    const match = text.match(/```(?:typescript|ts|javascript|js)?\n([\s\S]*?)```/);
-    return match ? match[1].trim() : text.trim();
-}
-async function updateTestForFile(sourceFilePath, sourceFileContent, testFilePath, existingTestContent, modelProvider, apiKey, framework) {
-    console.log(`[Lisa.ai Coverage] Requesting test update from ${modelProvider} for ${sourceFilePath}...`);
-    const model = getProvider(modelProvider, apiKey);
-    // Bug 3 fix: same as generateTestForFile — specify the framework so updates
-    // don't introduce incompatible syntax into an existing test suite.
-    const frameworkInstruction = framework
-        ? `3. You MUST use the '${framework}' testing framework exclusively. All new tests must follow '${framework}' conventions and integrate cleanly with the existing suite.\n`
-        : "3. Append missing tests to the existing suite. Do not delete existing passing tests unless they are fundamentally broken.\n";
-    const prompt = "You are Lisa.ai, an autonomous CI/CD expert platform.\n" +
-        "A source file lacks 100% test coverage. You must update its existing test suite to achieve full coverage.\n\n" +
-        "--- Target File Content (" + sourceFilePath + ") ---\n" + sourceFileContent + "\n\n" +
-        "--- Existing Test Suite (" + testFilePath + ") ---\n" + existingTestContent + "\n\n" +
-        "--- Constraints ---\n" +
-        "1. Return the updated complete test code wrapped in a markdown code block (```typescript ... ```).\n" +
-        "2. Do not include any explanation or intro text.\n" +
-        frameworkInstruction +
-        "4. Aim for 100% logic coverage across branches, lines, and functions.";
-    const { text } = await (0, ai_1.generateText)({
-        model,
-        prompt,
-    });
-    const match = text.match(/```(?:typescript|ts|javascript|js)?\n([\s\S]*?)```/);
-    return match ? match[1].trim() : text.trim();
-}
-async function askLisaGeneral(promptStr, modelProvider, apiKey) {
-    const model = getProvider(modelProvider, apiKey);
-    const { text } = await (0, ai_1.generateText)({
-        model,
-        prompt: promptStr,
-    });
-    const match = text.match(/```(?:typescript|ts|javascript|js)?\n([\s\S]*?)```/);
-    return match ? match[1].trim() : text.trim();
-}

package/dist/services/telemetry.service.js

@@ -1,60 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.reportTelemetry = reportTelemetry;
-const path = __importStar(require("path"));
-const dotenv = __importStar(require("dotenv"));
-// CP Bug 3 fix: load .env explicitly so LISA_CONTROL_PLANE_URL is always available.
-dotenv.config({ path: path.resolve(__dirname, '../../.env'), quiet: true });
-async function reportTelemetry(event) {
-    const MASTER_CONTROL_URL = process.env.LISA_CONTROL_PLANE_URL || 'http://localhost:3000';
-    const url = `${MASTER_CONTROL_URL}/api/telemetry`;
-    // Telemetry Bug 1 fix: true fire-and-forget — attach a .catch() handler and return immediately.
-    // The previous `await fetch(...)` contradicted the "don't block" comment: with 3 telemetry
-    // calls per file and 50+ files in a large project, the heal loop was silently waiting for
-    // 150+ network round-trips before doing any actual work.
-    // Keeping the function signature as async+Promise<void> means existing `await reportTelemetry()`
-    // callsites continue to compile without change — they just resolve instantly now.
-    fetch(url, {
-        method: 'POST',
-        headers: {
-            'Content-Type': 'application/json'
-        },
-        body: JSON.stringify(event)
-    }).catch((error) => {
-        // Silently fail if control plane is down so agent can still work detached
-        console.debug(`[Lisa.ai Agent Debug] Failed to report telemetry: ${error.message}`);
-    });
-}

package/dist/utils/coverage.parser.js

@@ -1,59 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseCoverageSummary = parseCoverageSummary;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-function parseCoverageSummary(coverageFilePath) {
-    const absolutePath = path.resolve(process.cwd(), coverageFilePath);
-    if (!fs.existsSync(absolutePath)) {
-        throw new Error(`[Lisa.ai Coverage Error] Coverage file not found at ${absolutePath}`);
-    }
-    const rawData = fs.readFileSync(absolutePath, 'utf-8');
-    const summary = JSON.parse(rawData);
-    const uncoveredFiles = [];
-    for (const [file, metrics] of Object.entries(summary)) {
-        if (file === 'total')
-            continue;
-        // Check if any metric is below 100%
-        if (metrics.lines.pct < 100 ||
-            metrics.statements.pct < 100 ||
-            metrics.functions.pct < 100 ||
-            metrics.branches.pct < 100) {
-            uncoveredFiles.push(file);
-        }
-    }
-    return uncoveredFiles;
-}

package/dist/utils/parser.js

@@ -1,174 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractFilePath = extractFilePath;
-const path = __importStar(require("path"));
-const fs = __importStar(require("fs"));
-function extractFilePath(errorLog, skipFiles = [], searchDir = process.cwd()) {
-    // Sanitize invisible ANSI color codes (e.g. \x1b[96m) from CLI output logs
-    const cleanLog = errorLog.replace(/\x1B\[[0-9;]*[a-zA-Z]/g, '');
-    // Normalize skip files for reliable absolute path comparison
-    const normalizedSkips = skipFiles.map(p => path.resolve(p));
-    // 1. First Pass: Try to match typical JS/TS/Vue error patterns with line numbers
-    // e.g., "src/components/Button.tsx:12:3 - error"
-    // Supporting Windows absolute paths (e.g. C:\...)
-    const exactErrorRegex = /([a-zA-Z]:[a-zA-Z0-9_.\-\/\\]+\.(?:ts|tsx|js|jsx|vue)|[a-zA-Z0-9_.\-\/\\]+\.(?:ts|tsx|js|jsx|vue))(?:\s*[:(])/g;
-    let match;
-    while ((match = exactErrorRegex.exec(cleanLog)) !== null) {
-        const foundPath = match[1];
-        if (foundPath) {
-            // Bug 4 fix: skip paths that live inside node_modules or build output directories.
-            // Without this check a non-scoped package path (e.g. node_modules/jest-config/build/index.js)
-            // satisfies the regex AND exists on disk, so Lisa would attempt to "heal" a library file.
-            if (/[/\\](node_modules|dist|build)[/\\]/.test(foundPath))
-                continue;
-            const absoluteFoundPath = path.isAbsolute(foundPath) ? foundPath : path.resolve(searchDir, foundPath);
-            if (!normalizedSkips.includes(absoluteFoundPath) && fs.existsSync(absoluteFoundPath)) {
-                return foundPath;
-            }
-        }
-    }
-    // 1.5 Special Pass for Jest Headers (FAIL src/path/to/test.js)
-    const jestFailRegex = /FAIL\s+([a-zA-Z0-9_.\-\/\\]+\.(?:ts|tsx|js|jsx|vue))/gi;
-    let jestMatch;
-    while ((jestMatch = jestFailRegex.exec(cleanLog)) !== null) {
-        const foundPath = jestMatch[1];
-        const absoluteFoundPath = path.isAbsolute(foundPath) ? foundPath : path.resolve(searchDir, foundPath);
-        if (!normalizedSkips.includes(absoluteFoundPath) && fs.existsSync(absoluteFoundPath)) {
-            return foundPath;
-        }
-    }
-    // 2. Second Pass (Fallback): Find anything that looks like a source file
-    // Loosened regex: Doesn't require trailing colon/paren
-    const fallbackRegex = /([a-zA-Z]:[a-zA-Z0-9_.\-\/\\]+\.(?:ts|tsx|js|jsx|vue)|[a-zA-Z0-9_.\-\/\\]+\.(?:ts|tsx|js|jsx|vue))/g;
-    let fallbackMatch;
-    while ((fallbackMatch = fallbackRegex.exec(cleanLog)) !== null) {
-        const foundPath = fallbackMatch[1];
-        if (foundPath) {
-            // Bug 4 fix: same node_modules/dist guard as pass 1.
-            if (/[/\\](node_modules|dist|build)[/\\]/.test(foundPath))
-                continue;
-            const absoluteFoundPath = path.isAbsolute(foundPath) ? foundPath : path.resolve(searchDir, foundPath);
-            if (!normalizedSkips.includes(absoluteFoundPath) && fs.existsSync(absoluteFoundPath)) {
-                return foundPath;
-            }
-        }
-    }
-    // 3. Third Pass (Abstract Testing Fallback): Match exported PascalCase symbols
-    // Framework-agnostic. Often testing tools say "Unexpected 'MyButton'" or "Chrome 120 MyService FAILED"
-    const symbolRegex = /\b([A-Z][a-zA-Z0-9]{3,})\b/g;
-    let symbolMatch;
-    const searchedSymbols = new Set();
-    // Filter out common JS/Browser built-ins and framework generics that are not user files
-    const ignoreList = ['Error', 'TypeError', 'SyntaxError', 'ReferenceError', 'RangeError', 'NullInjectorError', 'Object', 'Boolean', 'String', 'Number', 'Array', 'Chrome', 'Windows', 'Linux', 'Macintosh', 'UserContext', 'TestBed', 'Module', 'Unexpected', 'Expected', 'ChromeHeadless', 'Users', 'AppData', 'Local', 'Temp', 'Process', 'Component', 'Validation', 'Directory', 'Configuration', 'Documentation'];
-    while ((symbolMatch = symbolRegex.exec(cleanLog)) !== null) {
-        const symbolName = symbolMatch[1];
-        if (symbolName && !ignoreList.includes(symbolName) && !searchedSymbols.has(symbolName)) {
-            searchedSymbols.add(symbolName);
-            console.log(`[Lisa.ai Parser] Discovered abstract symbol failure: ${symbolName}. Scanning project tree...`);
-            // SEARCH ENTIRE ROOT instead of just 'src/' to support diverse project structures
-            const matchedFile = findFileBySymbolName(symbolName, searchDir, normalizedSkips);
-            if (matchedFile) {
-                // Return path relative to project root
-                return path.relative(searchDir, matchedFile);
-            }
-        }
-    }
-    // Exhausted all options and couldn't find an un-skipped file
-    return null;
-}
-/**
- * Recursively walks a directory looking for a source file that strictly exports the target symbol.
- * Designed to bypass test runners omitting absolute script paths in test exceptions.
- * We pass normalizedSkips to ensure we do not return a file that the Agent has explicitly blacklisted.
- */
-function findFileBySymbolName(symbolName, dir, skipLedgerAbs) {
-    if (!fs.existsSync(dir))
-        return null;
-    const files = fs.readdirSync(dir);
-    for (const file of files) {
-        const fullPath = path.join(dir, file);
-        if (file === 'node_modules' || file === 'dist' || file === 'build' || file === '.git' || file === '.angular')
-            continue;
-        let stat;
-        try {
-            stat = fs.statSync(fullPath);
-        }
-        catch (e) {
-            continue;
-        }
-        if (stat.isDirectory()) {
-            const found = findFileBySymbolName(symbolName, fullPath, skipLedgerAbs);
-            if (found)
-                return found;
-        }
-        else if (file.match(/\.(ts|tsx|js|jsx|vue)$/)) {
-            // We ONLY care if the file natively exports/declares the symbol.
-            // We MUST NOT match files that merely `import` the symbol.
-            const content = fs.readFileSync(fullPath, 'utf8');
-            if (content.includes(`class ${symbolName}`) ||
-                content.includes(`function ${symbolName}`) ||
-                content.includes(`const ${symbolName}`) ||
-                content.includes(`let ${symbolName}`) ||
-                content.includes(`exports.${symbolName}`) ||
-                content.includes(`module.exports.${symbolName}`)) {
-                let targetPath = fullPath;
-                // Find standard test extensions dynamically based on ecosystem
-                const ext = path.extname(fullPath);
-                const base = fullPath.slice(0, -ext.length);
-                // Check if a spec/test file already exists for this source code natively
-                if (!file.includes('.spec.') && !file.includes('.test.')) {
-                    const possibleSpecs = [
-                        `${base}.spec${ext}`,
-                        `${base}.test${ext}`,
-                        `${base}.spec.js`,
-                        `${base}.test.js`
-                    ];
-                    for (const p of possibleSpecs) {
-                        if (fs.existsSync(p)) {
-                            targetPath = p;
-                            break;
-                        }
-                    }
-                }
-                // If the decided file is NOT in the skip ledger, return it.
-                if (!skipLedgerAbs.includes(path.resolve(targetPath))) {
-                    return targetPath;
-                }
-            }
-        }
-    }
-    return null;
-}