mindheal 1.0.0

package/dist/cjs/core/visual-verification.js

@@ -0,0 +1,262 @@
+'use strict';
+
+var logger = require('../utils/logger.js');
+var fileUtils = require('../utils/file-utils.js');
+
+/**
+ * Visual Verification
+ *
+ * After healing a locator, captures a screenshot of the healed element and
+ * verifies it's visually the correct element. This prevents "wrong element"
+ * heals where the selector matches something in a different part of the page.
+ *
+ * Checks:
+ * 1. Element is visible on the page
+ * 2. Element is within the viewport (not scrolled off-screen)
+ * 3. Element has a reasonable bounding box (not 0x0)
+ * 4. Screenshot capture succeeds (element is rendered)
+ */
+/**
+ * Visual Verification engine for healed locators.
+ */
+class VisualVerifier {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Verify that a healed locator points to a visually valid element.
+     *
+     * Returns a VisualVerificationResult with:
+     * - `verified`: true if the element passes all visual checks
+     * - `elementScreenshotPath`: path to element screenshot (if captured)
+     * - `boundingBox`: element's position and size on page
+     * - `elementVisible`: whether the element is visible
+     * - `elementInViewport`: whether the element is within the viewport
+     */
+    async verify(page, healedLocator, eventId) {
+        if (!this.config.enabled) {
+            return {
+                verified: true, // Skip verification, assume valid
+                elementScreenshotPath: null,
+                fullPageScreenshotPath: null,
+                boundingBox: null,
+                elementVisible: true,
+                elementInViewport: true,
+                timestamp: Date.now(),
+            };
+        }
+        const result = {
+            verified: false,
+            elementScreenshotPath: null,
+            fullPageScreenshotPath: null,
+            boundingBox: null,
+            elementVisible: false,
+            elementInViewport: false,
+            timestamp: Date.now(),
+        };
+        try {
+            const locator = page.locator(healedLocator.selector);
+            // 1. Check element count
+            const count = await locator.count();
+            if (count === 0) {
+                logger.logger.warn(`[Visual] Healed locator resolved to 0 elements: ${healedLocator.selector}`);
+                return result;
+            }
+            const element = locator.first();
+            // 2. Check visibility
+            try {
+                result.elementVisible = await element.isVisible();
+            }
+            catch {
+                result.elementVisible = false;
+            }
+            if (!result.elementVisible) {
+                logger.logger.warn(`[Visual] Healed element is not visible: ${healedLocator.selector}`);
+                // Still partially verified — element exists but not visible
+            }
+            // 3. Get bounding box
+            try {
+                const box = await element.boundingBox();
+                if (box) {
+                    result.boundingBox = {
+                        x: box.x,
+                        y: box.y,
+                        width: box.width,
+                        height: box.height,
+                    };
+                    // Check for zero-size elements
+                    if (box.width === 0 || box.height === 0) {
+                        logger.logger.warn(`[Visual] Healed element has zero dimensions: ${box.width}x${box.height}`);
+                        return result;
+                    }
+                    // Check if element is in viewport
+                    const viewport = page.viewportSize();
+                    if (viewport) {
+                        result.elementInViewport =
+                            box.x >= -box.width &&
+                                box.y >= -box.height &&
+                                box.x < viewport.width + box.width &&
+                                box.y < viewport.height + box.height;
+                    }
+                    else {
+                        result.elementInViewport = true; // Can't check, assume true
+                    }
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logger.logger.debug(`[Visual] Could not get bounding box: ${msg}`);
+            }
+            // 4. Capture element screenshot
+            if (this.config.captureElement) {
+                try {
+                    fileUtils.ensureDirectory(this.config.screenshotDir);
+                    const sanitizedId = eventId.replace(/[^a-zA-Z0-9_-]/g, '_');
+                    const elementPath = `${this.config.screenshotDir}/${sanitizedId}_element.png`;
+                    await element.screenshot({
+                        path: elementPath,
+                        timeout: 5000,
+                    });
+                    result.elementScreenshotPath = elementPath;
+                    logger.logger.debug(`[Visual] Element screenshot saved: ${elementPath}`);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    logger.logger.debug(`[Visual] Element screenshot failed: ${msg}`);
+                }
+            }
+            // 5. Capture full page screenshot for context
+            if (this.config.captureFullPage) {
+                try {
+                    fileUtils.ensureDirectory(this.config.screenshotDir);
+                    const sanitizedId = eventId.replace(/[^a-zA-Z0-9_-]/g, '_');
+                    const pagePath = `${this.config.screenshotDir}/${sanitizedId}_page.png`;
+                    await page.screenshot({
+                        path: pagePath,
+                        fullPage: false,
+                        timeout: 10000,
+                    });
+                    result.fullPageScreenshotPath = pagePath;
+                    logger.logger.debug(`[Visual] Full page screenshot saved: ${pagePath}`);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    logger.logger.debug(`[Visual] Full page screenshot failed: ${msg}`);
+                }
+            }
+            // 6. Final verification decision
+            result.verified = result.elementVisible && result.boundingBox !== null;
+            if (result.verified) {
+                logger.logger.info(`[Visual] Verification passed for "${healedLocator.selector}" ` +
+                    `(${result.boundingBox.width}x${result.boundingBox.height} at ${result.boundingBox.x},${result.boundingBox.y})`);
+            }
+            else {
+                logger.logger.warn(`[Visual] Verification failed for "${healedLocator.selector}" ` +
+                    `(visible=${result.elementVisible}, box=${result.boundingBox !== null})`);
+            }
+            return result;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.logger.warn(`[Visual] Verification error: ${msg}`);
+            return result;
+        }
+    }
+    /**
+     * Compare two screenshots at the pixel level.
+     * Returns a similarity score (0-1).
+     *
+     * This is a lightweight comparison using a sampling approach
+     * (no external image processing libraries required).
+     */
+    async compareScreenshots(page, screenshotA, screenshotB) {
+        // Use page.evaluate to leverage canvas API for comparison
+        try {
+            const similarity = await page.evaluate(async ({ a, b }) => {
+                // Create images from buffers
+                const loadImage = (data) => {
+                    return new Promise((resolve, reject) => {
+                        const blob = new Blob([new Uint8Array(data)], { type: 'image/png' });
+                        const url = URL.createObjectURL(blob);
+                        const img = new Image();
+                        img.onload = () => {
+                            URL.revokeObjectURL(url);
+                            resolve(img);
+                        };
+                        img.onerror = reject;
+                        img.src = url;
+                    });
+                };
+                const imgA = await loadImage(a);
+                const imgB = await loadImage(b);
+                // Create canvas for comparison
+                const canvas = document.createElement('canvas');
+                const ctx = canvas.getContext('2d');
+                if (!ctx)
+                    return 0;
+                const width = Math.min(imgA.width, imgB.width);
+                const height = Math.min(imgA.height, imgB.height);
+                canvas.width = width;
+                canvas.height = height;
+                // Draw and get pixel data for A
+                ctx.drawImage(imgA, 0, 0);
+                const dataA = ctx.getImageData(0, 0, width, height).data;
+                // Draw and get pixel data for B
+                ctx.clearRect(0, 0, width, height);
+                ctx.drawImage(imgB, 0, 0);
+                const dataB = ctx.getImageData(0, 0, width, height).data;
+                // Sample pixels for comparison (every 4th pixel for speed)
+                let matchCount = 0;
+                let sampleCount = 0;
+                const step = 16; // Sample every 16 bytes (4 RGBA channels × 4 pixels)
+                for (let i = 0; i < dataA.length; i += step) {
+                    const diffR = Math.abs(dataA[i] - dataB[i]);
+                    const diffG = Math.abs(dataA[i + 1] - dataB[i + 1]);
+                    const diffB = Math.abs(dataA[i + 2] - dataB[i + 2]);
+                    const avgDiff = (diffR + diffG + diffB) / (3 * 255);
+                    if (avgDiff < 0.1)
+                        matchCount++;
+                    sampleCount++;
+                }
+                return sampleCount > 0 ? matchCount / sampleCount : 0;
+            }, { a: Array.from(screenshotA), b: Array.from(screenshotB) });
+            return similarity;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.logger.debug(`[Visual] Screenshot comparison failed: ${msg}`);
+            return 0;
+        }
+    }
+    /**
+     * Cleanup old screenshots if keepScreenshots is false.
+     */
+    cleanup() {
+        if (this.config.keepScreenshots)
+            return;
+        try {
+            const { readdirSync, unlinkSync } = require('fs');
+            const { join } = require('path');
+            if (!require('fs').existsSync(this.config.screenshotDir))
+                return;
+            const files = readdirSync(this.config.screenshotDir);
+            for (const file of files) {
+                if (file.endsWith('.png')) {
+                    try {
+                        unlinkSync(join(this.config.screenshotDir, file));
+                    }
+                    catch {
+                        // Ignore cleanup errors
+                    }
+                }
+            }
+            logger.logger.debug('[Visual] Cleaned up verification screenshots');
+        }
+        catch {
+            // Ignore
+        }
+    }
+}
+
+exports.VisualVerifier = VisualVerifier;
+//# sourceMappingURL=visual-verification.js.map

package/dist/cjs/core/visual-verification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-verification.js","sources":["../../../../src/core/visual-verification.ts"],"sourcesContent":[null],"names":["logger","ensureDirectory"],"mappings":"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"}

package/dist/cjs/git/code-modifier.js

@@ -0,0 +1,184 @@
+'use strict';
+
+var tsMorph = require('ts-morph');
+var logger = require('../utils/logger.js');
+
+/**
+ * AST-based source code modifier that updates Playwright locators in test files.
+ * Uses ts-morph to parse and manipulate TypeScript ASTs so that only the target
+ * locator expression is replaced while surrounding code is fully preserved.
+ */
+class CodeModifier {
+    constructor() {
+        this.project = new tsMorph.Project({
+            compilerOptions: { strict: true },
+            useInMemoryFileSystem: false,
+        });
+    }
+    // ── Public API ──────────────────────────────────────────────────────────────
+    /**
+     * Modify a single locator in the source file described by `modification`.
+     */
+    async modifyLocator(modification) {
+        const { filePath, line, originalCode, modifiedCode } = modification;
+        logger.logger.info(`Modifying locator in ${filePath}:${line}`);
+        logger.logger.debug('Original locator', originalCode);
+        logger.logger.debug('New locator', modifiedCode);
+        try {
+            const sourceFile = this.getOrAddSourceFile(filePath);
+            const text = sourceFile.getFullText();
+            // Strategy 1: Try AST-based replacement for known Playwright patterns.
+            const replaced = this.tryASTReplace(text, line, originalCode, modifiedCode);
+            if (replaced !== null) {
+                sourceFile.replaceWithText(replaced);
+            }
+            else {
+                // Strategy 2: Fall back to direct text replacement scoped to the target line.
+                const lineReplaced = this.replaceAtLine(text, line, originalCode, modifiedCode);
+                sourceFile.replaceWithText(lineReplaced);
+            }
+            await sourceFile.save();
+            logger.logger.info(`Locator updated in ${filePath}:${line}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.logger.error(`[MindHeal] Failed to modify locator in ${filePath}:${line}: ${message}`);
+            throw new Error(`[MindHeal] Failed to modify locator in ${filePath}:${line}: ${message}`);
+        }
+    }
+    /**
+     * Generate a human-readable unified-diff-style string for a single modification.
+     */
+    generateDiff(modification) {
+        const { filePath, line, originalCode, modifiedCode } = modification;
+        const header = `--- a/${filePath}\n+++ b/${filePath}`;
+        const hunk = `@@ -${line},1 +${line},1 @@`;
+        const removal = `- ${originalCode}`;
+        const addition = `+ ${modifiedCode}`;
+        return [header, hunk, removal, addition].join('\n');
+    }
+    /**
+     * Apply multiple modifications, grouping them by file to minimize I/O.
+     * Modifications within the same file are applied from bottom to top
+     * (descending line number) so that earlier line numbers stay valid.
+     */
+    async applyAllModifications(modifications) {
+        if (modifications.length === 0) {
+            logger.logger.warn('[MindHeal] No modifications to apply');
+            return;
+        }
+        // Group by file path.
+        const grouped = new Map();
+        for (const mod of modifications) {
+            const existing = grouped.get(mod.filePath) ?? [];
+            existing.push(mod);
+            grouped.set(mod.filePath, existing);
+        }
+        logger.logger.info(`Applying ${modifications.length} modification(s) across ${grouped.size} file(s)`);
+        for (const [filePath, fileMods] of grouped) {
+            // Sort descending by line so replacements don't shift earlier positions.
+            const sorted = [...fileMods].sort((a, b) => b.line - a.line);
+            for (const mod of sorted) {
+                try {
+                    await this.modifyLocator(mod);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    logger.logger.error(`[MindHeal] Skipping failed modification in ${filePath}:${mod.line}: ${message}`);
+                    // Continue with remaining modifications in the same file.
+                }
+            }
+        }
+        logger.logger.info('All modifications applied');
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────────
+    /**
+     * Add (or retrieve) a ts-morph SourceFile for the given path.
+     */
+    getOrAddSourceFile(filePath) {
+        const existing = this.project.getSourceFile(filePath);
+        if (existing) {
+            // Refresh from disk in case a prior modification changed it.
+            existing.refreshFromFileSystemSync();
+            return existing;
+        }
+        return this.project.addSourceFileAtPath(filePath);
+    }
+    /**
+     * Attempt to locate the original locator expression in the AST at the given
+     * line and replace it.  Returns the new full text on success or `null` if the
+     * expression could not be found via AST traversal.
+     *
+     * Supports Playwright patterns:
+     *   page.locator('selector')
+     *   page.getByRole('role', { name: 'value' })
+     *   page.getByText('text')
+     *   page.getByTestId('id')
+     *   Chained: page.locator('parent').locator('child')
+     */
+    tryASTReplace(fullText, targetLine, originalCode, modifiedCode) {
+        // Create a temporary in-memory source for AST analysis without side-effects.
+        const tempFile = this.project.createSourceFile('__temp_analysis__.ts', fullText, {
+            overwrite: true,
+        });
+        try {
+            const calls = tempFile.getDescendantsOfKind(tsMorph.SyntaxKind.CallExpression);
+            for (const call of calls) {
+                const startLine = call.getStartLineNumber();
+                if (startLine !== targetLine)
+                    continue;
+                const callText = call.getText();
+                // Check if this call (or its ancestor chain) matches the original code.
+                if (this.normalizeWhitespace(callText) === this.normalizeWhitespace(originalCode)) {
+                    const start = call.getStart();
+                    const end = call.getEnd();
+                    return fullText.substring(0, start) + modifiedCode + fullText.substring(end);
+                }
+                // The original code might be a parent expression that contains this call
+                // (e.g., chained locators).  Walk upward.
+                let ancestor = call.getParent();
+                while (ancestor) {
+                    if (ancestor.getStartLineNumber() === targetLine &&
+                        this.normalizeWhitespace(ancestor.getText()) ===
+                            this.normalizeWhitespace(originalCode)) {
+                        const start = ancestor.getStart();
+                        const end = ancestor.getEnd();
+                        return fullText.substring(0, start) + modifiedCode + fullText.substring(end);
+                    }
+                    ancestor = ancestor.getParent();
+                }
+            }
+            return null;
+        }
+        finally {
+            this.project.removeSourceFile(tempFile);
+        }
+    }
+    /**
+     * Fallback: perform a direct string replacement on the specific line of `fullText`.
+     * Only the first occurrence on the target line is replaced to avoid unintended changes.
+     */
+    replaceAtLine(fullText, targetLine, originalCode, modifiedCode) {
+        const lines = fullText.split('\n');
+        const lineIndex = targetLine - 1; // lines are 1-based
+        if (lineIndex < 0 || lineIndex >= lines.length) {
+            throw new Error(`[MindHeal] Line ${targetLine} is out of range (file has ${lines.length} lines)`);
+        }
+        const lineText = lines[lineIndex];
+        if (!lineText.includes(originalCode)) {
+            throw new Error(`[MindHeal] Original locator not found on line ${targetLine}. ` +
+                `Expected to find: ${originalCode}`);
+        }
+        lines[lineIndex] = lineText.replace(originalCode, modifiedCode);
+        return lines.join('\n');
+    }
+    /**
+     * Collapse all whitespace to single spaces for comparison purposes.
+     */
+    normalizeWhitespace(str) {
+        return str.replace(/\s+/g, ' ').trim();
+    }
+}
+
+exports.CodeModifier = CodeModifier;
+//# sourceMappingURL=code-modifier.js.map

package/dist/cjs/git/code-modifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-modifier.js","sources":["../../../../src/git/code-modifier.ts"],"sourcesContent":[null],"names":["Project","logger","SyntaxKind"],"mappings":"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"}

package/dist/cjs/git/git-operations.js

@@ -0,0 +1,145 @@
+'use strict';
+
+var simpleGit = require('simple-git');
+var logger = require('../utils/logger.js');
+
+class GitOperations {
+    constructor(config) {
+        this.config = config;
+        this.git = simpleGit();
+    }
+    /**
+     * Generate a branch name using the configured prefix and current timestamp.
+     * Format: {prefix}-{YYYYMMDD}-{HHmmss}
+     */
+    generateBranchName() {
+        const prefix = this.config.branchPrefix ?? 'mindheal/auto-fix';
+        const now = new Date();
+        const pad = (n) => String(n).padStart(2, '0');
+        const timestamp = [
+            now.getFullYear(),
+            pad(now.getMonth() + 1),
+            pad(now.getDate()),
+            '-',
+            pad(now.getHours()),
+            pad(now.getMinutes()),
+            pad(now.getSeconds()),
+        ].join('');
+        return `${prefix}-${timestamp}`;
+    }
+    /**
+     * Create a new branch and check it out.
+     */
+    async createBranch(branchName) {
+        try {
+            logger.logger.info(`Creating and checking out branch: ${branchName}`);
+            await this.git.checkoutLocalBranch(branchName);
+            logger.logger.info(`Branch created: ${branchName}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.logger.error(`[MindHeal] Failed to create branch "${branchName}": ${message}`);
+            throw new Error(`[MindHeal] Failed to create branch "${branchName}": ${message}`);
+        }
+    }
+    /**
+     * Stage specified files and create a commit.
+     */
+    async commitChanges(files, message) {
+        if (files.length === 0) {
+            logger.logger.warn('[MindHeal] No files provided for commit, skipping');
+            return;
+        }
+        try {
+            const prefix = this.config.commitMessagePrefix ?? '[MindHeal]';
+            const fullMessage = `${prefix} ${message}`;
+            logger.logger.info(`Staging ${files.length} file(s) for commit`);
+            await this.git.add(files);
+            logger.logger.info(`Committing with message: ${fullMessage}`);
+            await this.git.commit(fullMessage);
+            logger.logger.info('Commit successful');
+        }
+        catch (error) {
+            const message_ = error instanceof Error ? error.message : String(error);
+            logger.logger.error(`[MindHeal] Failed to commit changes: ${message_}`);
+            throw new Error(`[MindHeal] Failed to commit changes: ${message_}`);
+        }
+    }
+    /**
+     * Push a branch to the remote origin.
+     */
+    async pushBranch(branchName) {
+        try {
+            logger.logger.info(`Pushing branch "${branchName}" to origin`);
+            await this.git.push('origin', branchName, ['--set-upstream']);
+            logger.logger.info(`Branch "${branchName}" pushed successfully`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.logger.error(`[MindHeal] Failed to push branch "${branchName}": ${message}`);
+            throw new Error(`[MindHeal] Failed to push branch "${branchName}": ${message}`);
+        }
+    }
+    /**
+     * Get the name of the currently checked-out branch.
+     */
+    async getCurrentBranch() {
+        try {
+            const branchSummary = await this.git.branchLocal();
+            return branchSummary.current;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.logger.error(`[MindHeal] Failed to get current branch: ${message}`);
+            throw new Error(`[MindHeal] Failed to get current branch: ${message}`);
+        }
+    }
+    /**
+     * Switch to an existing branch.
+     */
+    async switchBranch(branchName) {
+        try {
+            logger.logger.info(`Switching to branch: ${branchName}`);
+            await this.git.checkout(branchName);
+            logger.logger.info(`Switched to branch: ${branchName}`);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.logger.error(`[MindHeal] Failed to switch to branch "${branchName}": ${message}`);
+            throw new Error(`[MindHeal] Failed to switch to branch "${branchName}": ${message}`);
+        }
+    }
+    /**
+     * Stash all uncommitted changes (tracked and untracked).
+     */
+    async stashChanges() {
+        try {
+            logger.logger.info('Stashing uncommitted changes');
+            await this.git.stash(['push', '--include-untracked']);
+            logger.logger.info('Changes stashed');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.logger.error(`[MindHeal] Failed to stash changes: ${message}`);
+            throw new Error(`[MindHeal] Failed to stash changes: ${message}`);
+        }
+    }
+    /**
+     * Pop the most recent stash entry.
+     */
+    async popStash() {
+        try {
+            logger.logger.info('Popping stashed changes');
+            await this.git.stash(['pop']);
+            logger.logger.info('Stash applied and dropped');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.logger.error(`[MindHeal] Failed to pop stash: ${message}`);
+            throw new Error(`[MindHeal] Failed to pop stash: ${message}`);
+        }
+    }
+}
+
+exports.GitOperations = GitOperations;
+//# sourceMappingURL=git-operations.js.map

package/dist/cjs/git/git-operations.js.map

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