mindheal 1.0.0

package/dist/esm/rag/knowledge-store.js

@@ -0,0 +1,157 @@
+import { tokenize, buildTermVector, cosineSimilarity } from './embeddings.js';
+import { logger } from '../utils/logger.js';
+import { fileExists, readJsonFile, ensureDirectory, writeJsonFile } from '../utils/file-utils.js';
+import { dirname } from 'path';
+
+/**
+ * File-backed knowledge store for RAG context.
+ *
+ * Stores healing history, page object metadata, git diffs, DOM snapshots,
+ * component docs, and test specs as searchable entries. Uses lightweight
+ * TF-IDF similarity for retrieval — no vector DB required.
+ */
+const STORE_VERSION = '1';
+const MAX_ENTRIES = 2000;
+const ENTRY_EXPIRY_MS = 90 * 24 * 60 * 60 * 1000; // 90 days
+class KnowledgeStore {
+    constructor(storePath) {
+        this.storePath = storePath;
+        this.entries = [];
+        this.loaded = false;
+    }
+    // ─── Load / Save ─────────────────────────────────────────────────────────
+    load() {
+        logger.debug(`Loading RAG knowledge store from: ${this.storePath}`);
+        if (!fileExists(this.storePath)) {
+            logger.debug('No existing knowledge store found, starting empty');
+            this.entries = [];
+            this.loaded = true;
+            return;
+        }
+        try {
+            const raw = readJsonFile(this.storePath);
+            if (raw && raw.version === STORE_VERSION && Array.isArray(raw.entries)) {
+                // Prune expired entries
+                const now = Date.now();
+                this.entries = raw.entries.filter((e) => now - e.createdAt < ENTRY_EXPIRY_MS);
+                const pruned = raw.entries.length - this.entries.length;
+                if (pruned > 0) {
+                    logger.debug(`Pruned ${pruned} expired knowledge entries`);
+                }
+            }
+            else {
+                logger.debug('Knowledge store version mismatch, starting fresh');
+                this.entries = [];
+            }
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`Failed to load knowledge store: ${msg}. Starting fresh.`);
+            this.entries = [];
+        }
+        this.loaded = true;
+    }
+    save() {
+        try {
+            ensureDirectory(dirname(this.storePath));
+            const store = {
+                version: STORE_VERSION,
+                entries: this.entries,
+            };
+            writeJsonFile(this.storePath, store);
+            logger.debug(`Knowledge store saved: ${this.entries.length} entries`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.warn(`Failed to save knowledge store: ${msg}`);
+        }
+    }
+    // ─── CRUD ─────────────────────────────────────────────────────────────────
+    add(entry) {
+        const now = Date.now();
+        const id = `rag_${now.toString(36)}_${Math.random().toString(36).substring(2, 8)}`;
+        const full = {
+            ...entry,
+            id,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.entries.push(full);
+        // Enforce max entries — evict oldest
+        if (this.entries.length > MAX_ENTRIES) {
+            this.entries.sort((a, b) => b.updatedAt - a.updatedAt);
+            this.entries = this.entries.slice(0, MAX_ENTRIES);
+        }
+        this.save();
+        return full;
+    }
+    /**
+     * Add or update an entry. If an entry with matching source + tags exists,
+     * update it instead of creating a duplicate.
+     */
+    upsert(entry) {
+        const existing = this.entries.find((e) => e.source === entry.source &&
+            e.tags.length === entry.tags.length &&
+            e.tags.every((t, i) => t === entry.tags[i]));
+        if (existing) {
+            existing.content = entry.content;
+            existing.metadata = entry.metadata;
+            existing.updatedAt = Date.now();
+            this.save();
+            return existing;
+        }
+        return this.add(entry);
+    }
+    getAll() {
+        return [...this.entries];
+    }
+    getBySource(source) {
+        return this.entries.filter((e) => e.source === source);
+    }
+    // ─── Search ───────────────────────────────────────────────────────────────
+    /**
+     * Search the knowledge store for entries relevant to the query.
+     * Returns ranked results above the similarity threshold.
+     */
+    search(query, options = {}) {
+        const { sources, maxResults = 5, similarityThreshold = 0.3, } = options;
+        const queryTokens = tokenize(query);
+        if (queryTokens.length === 0)
+            return [];
+        const queryVector = buildTermVector(queryTokens);
+        // Filter by source if specified
+        const candidates = sources
+            ? this.entries.filter((e) => sources.includes(e.source))
+            : this.entries;
+        // Score each entry
+        const scored = [];
+        for (const entry of candidates) {
+            // Build a combined text from content + tags for matching
+            const entryText = `${entry.content} ${entry.tags.join(' ')}`;
+            const entryTokens = tokenize(entryText);
+            const entryVector = buildTermVector(entryTokens);
+            const score = cosineSimilarity(queryVector, entryVector);
+            if (score >= similarityThreshold) {
+                scored.push({ entry, score });
+            }
+        }
+        // Sort by score descending
+        scored.sort((a, b) => b.score - a.score);
+        // Return top results as RAGContextChunks
+        return scored.slice(0, maxResults).map(({ entry, score }) => ({
+            source: entry.source,
+            content: entry.content,
+            relevanceScore: score,
+            metadata: entry.metadata,
+        }));
+    }
+    /**
+     * Get entry count.
+     */
+    get size() {
+        return this.entries.length;
+    }
+}
+
+export { KnowledgeStore };
+//# sourceMappingURL=knowledge-store.js.map

package/dist/esm/rag/knowledge-store.js.map

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

package/dist/esm/reporters/heal-report.js

@@ -0,0 +1,277 @@
+import { ensureDirectory, writeFileContent } from '../utils/file-utils.js';
+import { logger } from '../utils/logger.js';
+import { resolve } from 'path';
+
+/**
+ * Generates HTML and JSON healing reports summarizing all healing events
+ * from a test run.
+ */
+class HealReportGenerator {
+    /**
+     * Serialize a HealReport to a formatted JSON string.
+     */
+    generateJSON(report) {
+        return JSON.stringify(report, null, 2);
+    }
+    /**
+     * Generate a self-contained HTML report with inline styles.
+     */
+    generateHTML(report) {
+        const stats = this.computeStats(report);
+        const strategyBreakdown = this.computeStrategyBreakdown(report.events);
+        const maxStrategyCount = Math.max(...Object.values(strategyBreakdown), 1);
+        const eventsRows = report.events
+            .map((event) => this.renderEventRow(event))
+            .join('\n');
+        const strategyBars = Object.entries(strategyBreakdown)
+            .sort(([, a], [, b]) => b - a)
+            .map(([strategy, count]) => `<div style="display:flex;align-items:center;margin-bottom:6px;">
+            <span style="width:90px;font-size:13px;color:#475569;">${this.escapeHTML(strategy)}</span>
+            <div style="flex:1;background:#e2e8f0;border-radius:4px;height:22px;overflow:hidden;">
+              <div style="width:${(count / maxStrategyCount) * 100}%;background:${this.strategyColor(strategy)};height:100%;border-radius:4px;transition:width .3s;"></div>
+            </div>
+            <span style="width:40px;text-align:right;font-size:13px;font-weight:600;color:#334155;">${count}</span>
+          </div>`)
+            .join('\n');
+        return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>MindHeal Report</title>
+<style>
+  *{margin:0;padding:0;box-sizing:border-box}
+  body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,'Helvetica Neue',Arial,sans-serif;background:#f8fafc;color:#1e293b;line-height:1.6;padding:24px}
+  .container{max-width:1200px;margin:0 auto}
+  h1{font-size:28px;font-weight:700;margin-bottom:4px}
+  .subtitle{color:#64748b;font-size:14px;margin-bottom:32px}
+  .stats-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:16px;margin-bottom:32px}
+  .stat-card{background:#fff;border:1px solid #e2e8f0;border-radius:12px;padding:20px;text-align:center}
+  .stat-value{font-size:32px;font-weight:700}
+  .stat-label{font-size:13px;color:#64748b;margin-top:4px}
+  .stat-healed .stat-value{color:#16a34a}
+  .stat-failed .stat-value{color:#dc2626}
+  .stat-total .stat-value{color:#2563eb}
+  .stat-rate .stat-value{color:#7c3aed}
+  .section{background:#fff;border:1px solid #e2e8f0;border-radius:12px;padding:24px;margin-bottom:24px}
+  .section-title{font-size:18px;font-weight:600;margin-bottom:16px}
+  table{width:100%;border-collapse:collapse;font-size:13px}
+  th{background:#f1f5f9;text-align:left;padding:10px 12px;font-weight:600;color:#475569;border-bottom:2px solid #e2e8f0}
+  td{padding:10px 12px;border-bottom:1px solid #f1f5f9;vertical-align:top}
+  tr:hover td{background:#f8fafc}
+  .badge{display:inline-block;padding:2px 8px;border-radius:9999px;font-size:11px;font-weight:600;text-transform:uppercase}
+  .badge-healed{background:#dcfce7;color:#166534}
+  .badge-failed{background:#fee2e2;color:#991b1b}
+  .confidence-bar{display:inline-block;width:60px;height:8px;background:#e2e8f0;border-radius:4px;overflow:hidden;vertical-align:middle;margin-right:6px}
+  .confidence-fill{height:100%;border-radius:4px}
+  .locator-code{font-family:'SF Mono',SFMono-Regular,Consolas,'Liberation Mono',Menlo,monospace;font-size:12px;background:#f1f5f9;padding:3px 6px;border-radius:4px;word-break:break-all;display:inline-block;max-width:280px}
+  .timing{color:#64748b;font-size:12px}
+  @media print{body{background:#fff;padding:0}.stat-card,.section{break-inside:avoid}}
+  @media(max-width:768px){.stats-grid{grid-template-columns:1fr 1fr}table{font-size:12px}td,th{padding:8px 6px}}
+</style>
+</head>
+<body>
+<div class="container">
+  <h1>MindHeal Healing Report</h1>
+  <p class="subtitle">
+    Session <strong>${this.escapeHTML(report.sessionId)}</strong> &mdash;
+    ${this.formatDate(report.startTime)} to ${this.formatDate(report.endTime)}
+    (${this.formatDuration(report.endTime - report.startTime)})
+  </p>
+
+  <div class="stats-grid">
+    <div class="stat-card stat-total">
+      <div class="stat-value">${stats.totalHeals}</div>
+      <div class="stat-label">Total Healing Attempts</div>
+    </div>
+    <div class="stat-card stat-healed">
+      <div class="stat-value">${stats.successfulHeals}</div>
+      <div class="stat-label">Successfully Healed</div>
+    </div>
+    <div class="stat-card stat-failed">
+      <div class="stat-value">${stats.failedHeals}</div>
+      <div class="stat-label">Failed</div>
+    </div>
+    <div class="stat-card stat-rate">
+      <div class="stat-value">${stats.successRate}%</div>
+      <div class="stat-label">Success Rate</div>
+    </div>
+  </div>
+
+  ${Object.keys(strategyBreakdown).length > 0
+            ? `<div class="section">
+    <div class="section-title">Strategy Breakdown</div>
+    ${strategyBars}
+  </div>`
+            : ''}
+
+  <div class="section">
+    <div class="section-title">Healing Events (${report.events.length})</div>
+    ${report.events.length > 0
+            ? `<div style="overflow-x:auto;">
+      <table>
+        <thead>
+          <tr>
+            <th>Status</th>
+            <th>Test</th>
+            <th>Action</th>
+            <th>Original Locator</th>
+            <th>Healed Locator</th>
+            <th>Strategy</th>
+            <th>Confidence</th>
+            <th>Duration</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${eventsRows}
+        </tbody>
+      </table>
+    </div>`
+            : '<p style="color:#94a3b8;text-align:center;padding:32px 0;">No healing events recorded.</p>'}
+  </div>
+
+  <p style="text-align:center;color:#94a3b8;font-size:12px;margin-top:16px;">
+    Generated by MindHeal &mdash; ${this.formatDate(Date.now())}
+  </p>
+</div>
+</body>
+</html>`;
+    }
+    /**
+     * Persist the report to disk in JSON and/or HTML format.
+     */
+    async saveReport(report, outputDir, generateHTML, generateJSON) {
+        ensureDirectory(outputDir);
+        const timestamp = new Date(report.startTime)
+            .toISOString()
+            .replace(/[:.]/g, '-')
+            .replace('T', '_')
+            .slice(0, 19);
+        if (generateJSON) {
+            const jsonPath = resolve(outputDir, `heal-report-${timestamp}.json`);
+            try {
+                const jsonContent = this.generateJSON(report);
+                writeFileContent(jsonPath, jsonContent);
+                logger.info(`JSON report saved to ${jsonPath}`);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                logger.error(`Failed to save JSON report: ${message}`);
+            }
+        }
+        if (generateHTML) {
+            const htmlPath = resolve(outputDir, `heal-report-${timestamp}.html`);
+            try {
+                const htmlContent = this.generateHTML(report);
+                writeFileContent(htmlPath, htmlContent);
+                logger.info(`HTML report saved to ${htmlPath}`);
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                logger.error(`Failed to save HTML report: ${message}`);
+            }
+        }
+    }
+    // ── Private helpers ──────────────────────────────────────────────────────────
+    computeStats(report) {
+        const totalHeals = report.totalHeals;
+        const successfulHeals = report.successfulHeals;
+        const failedHeals = report.failedHeals;
+        const successRate = totalHeals > 0 ? Math.round((successfulHeals / totalHeals) * 100) : 0;
+        return { totalHeals, successfulHeals, failedHeals, successRate };
+    }
+    computeStrategyBreakdown(events) {
+        const breakdown = {};
+        for (const event of events) {
+            if (event.strategy) {
+                breakdown[event.strategy] = (breakdown[event.strategy] ?? 0) + 1;
+            }
+        }
+        return breakdown;
+    }
+    renderEventRow(event) {
+        const statusBadge = event.status === 'healed'
+            ? '<span class="badge badge-healed">Healed</span>'
+            : '<span class="badge badge-failed">Failed</span>';
+        const confidencePercent = Math.round(event.confidence * 100);
+        const confidenceColor = this.confidenceColor(event.confidence);
+        const healedLocatorDisplay = event.healedLocator
+            ? `<span class="locator-code">${this.escapeHTML(event.healedLocator.playwrightExpression)}</span>`
+            : '<span style="color:#94a3b8;">N/A</span>';
+        const sourceInfo = event.sourceLocation
+            ? `${this.escapeHTML(this.shortenPath(event.sourceLocation.filePath))}:${event.sourceLocation.line}`
+            : this.escapeHTML(event.testFile || 'unknown');
+        return `<tr>
+      <td>${statusBadge}</td>
+      <td>
+        <div style="font-weight:500;">${this.escapeHTML(event.testTitle || 'Unnamed test')}</div>
+        <div class="timing">${this.escapeHTML(sourceInfo)}</div>
+      </td>
+      <td>${this.escapeHTML(event.action)}</td>
+      <td><span class="locator-code">${this.escapeHTML(event.originalLocator.playwrightExpression)}</span></td>
+      <td>${healedLocatorDisplay}</td>
+      <td>${event.strategy ? this.escapeHTML(event.strategy) : '<span style="color:#94a3b8;">N/A</span>'}</td>
+      <td>
+        <div class="confidence-bar"><div class="confidence-fill" style="width:${confidencePercent}%;background:${confidenceColor};"></div></div>
+        <span style="font-size:12px;font-weight:600;color:${confidenceColor};">${confidencePercent}%</span>
+      </td>
+      <td class="timing">${event.duration}ms</td>
+    </tr>`;
+    }
+    confidenceColor(confidence) {
+        if (confidence >= 0.8)
+            return '#16a34a';
+        if (confidence >= 0.5)
+            return '#ca8a04';
+        return '#dc2626';
+    }
+    strategyColor(strategy) {
+        const colors = {
+            cache: '#6366f1',
+            attribute: '#2563eb',
+            text: '#0891b2',
+            role: '#059669',
+            css: '#ca8a04',
+            xpath: '#ea580c',
+            ai: '#7c3aed',
+        };
+        return colors[strategy] ?? '#64748b';
+    }
+    escapeHTML(str) {
+        return str
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;')
+            .replace(/"/g, '&quot;')
+            .replace(/'/g, '&#39;');
+    }
+    formatDate(timestamp) {
+        return new Date(timestamp).toLocaleString('en-US', {
+            year: 'numeric',
+            month: 'short',
+            day: 'numeric',
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit',
+        });
+    }
+    formatDuration(ms) {
+        if (ms < 1000)
+            return `${ms}ms`;
+        const seconds = Math.floor(ms / 1000);
+        if (seconds < 60)
+            return `${seconds}s`;
+        const minutes = Math.floor(seconds / 60);
+        const remainingSeconds = seconds % 60;
+        return `${minutes}m ${remainingSeconds}s`;
+    }
+    shortenPath(filePath) {
+        const parts = filePath.replace(/\\/g, '/').split('/');
+        if (parts.length <= 3)
+            return parts.join('/');
+        return `.../${parts.slice(-3).join('/')}`;
+    }
+}
+
+export { HealReportGenerator };
+//# sourceMappingURL=heal-report.js.map

package/dist/esm/reporters/heal-report.js.map

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