@theihtisham/agent-shadow-brain 2.1.0 → 4.0.0

package/dist/brain/knowledge-graph.js

@@ -0,0 +1,427 @@
+// src/brain/knowledge-graph.ts — Code Entity Graph with PageRank
+// Builds a living graph of all code entities and their relationships.
+// Scores importance using PageRank algorithm.
+// v4.0.0 — Hyper-Intelligence Edition
+import * as fs from 'fs';
+import * as path from 'path';
+const GRAPH_DIR = path.join(process.env.HOME || process.env.USERPROFILE || '~', '.shadow-brain', 'knowledge-graph');
+/**
+ * Knowledge Graph — maps your entire codebase as a living graph.
+ *
+ * Entity extraction: Parse source files for functions, classes, interfaces,
+ * modules, variables (exported only).
+ *
+ * Relations: calls, imports, extends, implements, uses, tests
+ *
+ * PageRank: Damping factor 0.85, convergence < 0.0001, max 100 iterations.
+ *   Result: normalized score 0-1 for each entity.
+ *
+ * Use cases:
+ *   - Most critical functions to test (high PageRank)
+ *   - Orphan code (zero in-degree, zero PageRank)
+ *   - Circular dependency detection (cycles)
+ *   - Impact analysis: what breaks if X changes?
+ */
+export class KnowledgeGraph {
+    constructor(projectDir) {
+        this.projectDir = projectDir;
+        this.graph = {
+            entities: new Map(),
+            relations: [],
+            lastBuilt: new Date(0),
+            fileCount: 0,
+        };
+        this.loadFromDisk();
+    }
+    // ── Graph Construction ──────────────────────────────────────────────────────
+    /** Build the knowledge graph from project source files */
+    async build() {
+        this.graph = {
+            entities: new Map(),
+            relations: [],
+            lastBuilt: new Date(),
+            fileCount: 0,
+        };
+        // Scan project for source files
+        const extensions = ['.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.rs', '.java'];
+        const sourceFiles = this.findSourceFiles(this.projectDir, extensions);
+        for (const file of sourceFiles) {
+            try {
+                const content = fs.readFileSync(file, 'utf-8');
+                this.graph.fileCount++;
+                this.extractEntities(content, file);
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+        // Extract relations between entities
+        this.extractRelations();
+        // Save to disk
+        await this.saveToDisk();
+        return this.graph;
+    }
+    /** Add a single entity */
+    addEntity(entity) {
+        this.graph.entities.set(entity.id, entity);
+    }
+    /** Add a relation */
+    addRelation(relation) {
+        this.graph.relations.push(relation);
+    }
+    // ── Entity Extraction ───────────────────────────────────────────────────────
+    /** Extract code entities from source file content */
+    extractEntities(content, filePath) {
+        const lines = content.split('\n');
+        const relativePath = path.relative(this.projectDir, filePath);
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Functions
+            const funcMatch = line.match(/(?:export\s+)?(?:async\s+)?function\s+(\w+)/);
+            if (funcMatch) {
+                this.addEntity({
+                    id: `${relativePath}:${funcMatch[1]}`,
+                    type: 'function',
+                    name: funcMatch[1],
+                    file: relativePath,
+                    line: i + 1,
+                    refs: [],
+                    pageRankScore: 0,
+                    exported: line.includes('export'),
+                    async: line.includes('async'),
+                });
+            }
+            // Arrow functions (exported)
+            const arrowMatch = line.match(/export\s+(?:const|let)\s+(\w+)\s*=\s*(?:async\s*)?\(/);
+            if (arrowMatch) {
+                this.addEntity({
+                    id: `${relativePath}:${arrowMatch[1]}`,
+                    type: 'function',
+                    name: arrowMatch[1],
+                    file: relativePath,
+                    line: i + 1,
+                    refs: [],
+                    pageRankScore: 0,
+                    exported: true,
+                    async: line.includes('async'),
+                });
+            }
+            // Classes
+            const classMatch = line.match(/(?:export\s+)?(?:abstract\s+)?class\s+(\w+)/);
+            if (classMatch) {
+                this.addEntity({
+                    id: `${relativePath}:${classMatch[1]}`,
+                    type: 'class',
+                    name: classMatch[1],
+                    file: relativePath,
+                    line: i + 1,
+                    refs: [],
+                    pageRankScore: 0,
+                    exported: line.includes('export'),
+                    async: false,
+                });
+            }
+            // Interfaces
+            const ifaceMatch = line.match(/(?:export\s+)?interface\s+(\w+)/);
+            if (ifaceMatch) {
+                this.addEntity({
+                    id: `${relativePath}:${ifaceMatch[1]}`,
+                    type: 'interface',
+                    name: ifaceMatch[1],
+                    file: relativePath,
+                    line: i + 1,
+                    refs: [],
+                    pageRankScore: 0,
+                    exported: line.includes('export'),
+                    async: false,
+                });
+            }
+            // Methods (inside classes)
+            const methodMatch = line.match(/(?:public|private|protected)?\s*(?:async\s+)?(\w+)\s*\(/);
+            if (methodMatch && !funcMatch && !classMatch) {
+                const name = methodMatch[1];
+                // Skip keywords
+                if (['if', 'for', 'while', 'switch', 'catch', 'constructor', 'return', 'throw', 'new'].includes(name))
+                    continue;
+                this.addEntity({
+                    id: `${relativePath}:${name}:${i + 1}`,
+                    type: 'method',
+                    name,
+                    file: relativePath,
+                    line: i + 1,
+                    refs: [],
+                    pageRankScore: 0,
+                    exported: false,
+                    async: line.includes('async'),
+                });
+            }
+        }
+    }
+    /** Extract relations between entities based on imports, calls, etc. */
+    extractRelations() {
+        for (const [entityId, entity] of this.graph.entities) {
+            // Find references to other entities
+            for (const [otherId, other] of this.graph.entities) {
+                if (entityId === otherId)
+                    continue;
+                // Same file references (calls/uses)
+                if (entity.file === other.file && entity.type !== 'interface') {
+                    this.addRelation({
+                        from: entityId,
+                        to: otherId,
+                        type: 'uses',
+                        weight: 1,
+                    });
+                }
+            }
+        }
+        // Parse import statements for cross-file relations
+        for (const [entityId, entity] of this.graph.entities) {
+            try {
+                const fullPath = path.join(this.projectDir, entity.file);
+                if (!fs.existsSync(fullPath))
+                    continue;
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                const lines = content.split('\n');
+                for (const line of lines) {
+                    const importMatch = line.match(/import\s+.*?\s+from\s+['"](.+?)['"]/);
+                    if (importMatch) {
+                        const importPath = importMatch[1];
+                        // Find entities in the imported file
+                        for (const [otherId, other] of this.graph.entities) {
+                            if (other.file.includes(importPath.replace('./', '').replace('../', ''))) {
+                                this.addRelation({
+                                    from: entityId,
+                                    to: otherId,
+                                    type: 'imports',
+                                    weight: 0.5,
+                                });
+                            }
+                        }
+                    }
+                }
+            }
+            catch {
+                // Skip
+            }
+        }
+    }
+    // ── PageRank ────────────────────────────────────────────────────────────────
+    /**
+     * Compute PageRank scores for all entities.
+     * Damping factor: 0.85, convergence: < 0.0001, max iterations: 100.
+     */
+    pageRank(iterations = 100) {
+        const DAMPING = 0.85;
+        const CONVERGENCE = 0.0001;
+        const entityIds = Array.from(this.graph.entities.keys());
+        const n = entityIds.length;
+        if (n === 0) {
+            return { scores: new Map(), iterations: 0, converged: true, danglingNodes: 0 };
+        }
+        // Build adjacency: out-links and in-links
+        const outLinks = new Map();
+        const inLinks = new Map();
+        for (const id of entityIds) {
+            outLinks.set(id, new Set());
+            inLinks.set(id, new Set());
+        }
+        for (const rel of this.graph.relations) {
+            outLinks.get(rel.from)?.add(rel.to);
+            inLinks.get(rel.to)?.add(rel.from);
+        }
+        // Count dangling nodes (no out-links)
+        let danglingNodes = 0;
+        for (const [_, links] of outLinks) {
+            if (links.size === 0)
+                danglingNodes++;
+        }
+        // Initialize scores uniformly
+        let scores = new Map();
+        for (const id of entityIds) {
+            scores.set(id, 1 / n);
+        }
+        let converged = false;
+        let iter = 0;
+        for (iter = 0; iter < iterations; iter++) {
+            const newScores = new Map();
+            // Dangling node contribution
+            let danglingSum = 0;
+            for (const id of entityIds) {
+                if (outLinks.get(id).size === 0) {
+                    danglingSum += scores.get(id) ?? 0;
+                }
+            }
+            // Update scores
+            for (const id of entityIds) {
+                let rank = (1 - DAMPING) / n;
+                // Contribution from in-links
+                const incoming = inLinks.get(id) ?? new Set();
+                for (const source of incoming) {
+                    const sourceScore = scores.get(source) ?? 0;
+                    const sourceOutCount = outLinks.get(source)?.size ?? 1;
+                    rank += DAMPING * (sourceScore / Math.max(sourceOutCount, 1));
+                }
+                // Dangling node redistribution
+                rank += DAMPING * (danglingSum / n);
+                newScores.set(id, rank);
+            }
+            // Check convergence
+            let maxDelta = 0;
+            for (const id of entityIds) {
+                const delta = Math.abs((newScores.get(id) ?? 0) - (scores.get(id) ?? 0));
+                if (delta > maxDelta)
+                    maxDelta = delta;
+            }
+            scores = newScores;
+            if (maxDelta < CONVERGENCE) {
+                converged = true;
+                break;
+            }
+        }
+        // Normalize scores to [0, 1]
+        const maxScore = Math.max(...Array.from(scores.values()));
+        if (maxScore > 0) {
+            for (const [id, score] of scores) {
+                scores.set(id, score / maxScore);
+            }
+        }
+        // Update entity PageRank scores
+        for (const [id, score] of scores) {
+            const entity = this.graph.entities.get(id);
+            if (entity)
+                entity.pageRankScore = score;
+        }
+        return { scores, iterations: iter, converged, danglingNodes };
+    }
+    // ── Analysis Queries ────────────────────────────────────────────────────────
+    /** Get top-N most important entities by PageRank */
+    getTopEntities(topN = 20) {
+        return Array.from(this.graph.entities.values())
+            .sort((a, b) => b.pageRankScore - a.pageRankScore)
+            .slice(0, topN);
+    }
+    /** Find entities impacted by a change to the given entity */
+    getImpactedBy(entityId) {
+        const impacted = new Set();
+        this.findDownstream(entityId, impacted, 5);
+        return Array.from(impacted)
+            .map(id => this.graph.entities.get(id))
+            .filter((e) => e !== undefined && e.id !== entityId);
+    }
+    findDownstream(entityId, visited, depth) {
+        if (depth <= 0 || visited.has(entityId))
+            return;
+        visited.add(entityId);
+        for (const rel of this.graph.relations) {
+            if (rel.from === entityId) {
+                this.findDownstream(rel.to, visited, depth - 1);
+            }
+        }
+    }
+    /** Find circular dependencies */
+    findCycles() {
+        const cycles = [];
+        const visited = new Set();
+        const stack = new Set();
+        const path = [];
+        const dfs = (node) => {
+            if (stack.has(node)) {
+                // Found cycle
+                const cycleStart = path.indexOf(node);
+                if (cycleStart >= 0) {
+                    cycles.push(path.slice(cycleStart).concat(node));
+                }
+                return;
+            }
+            if (visited.has(node))
+                return;
+            visited.add(node);
+            stack.add(node);
+            path.push(node);
+            for (const rel of this.graph.relations) {
+                if (rel.from === node) {
+                    dfs(rel.to);
+                }
+            }
+            path.pop();
+            stack.delete(node);
+        };
+        for (const id of this.graph.entities.keys()) {
+            dfs(id);
+        }
+        return cycles;
+    }
+    /** Get graph statistics */
+    getStats() {
+        const entities = this.graph.entities.size;
+        const relations = this.graph.relations.length;
+        const scores = Array.from(this.graph.entities.values()).map(e => e.pageRankScore);
+        const avgPageRank = scores.length > 0 ? scores.reduce((a, b) => a + b, 0) / scores.length : 0;
+        const orphanCount = Array.from(this.graph.entities.values())
+            .filter(e => !this.graph.relations.some(r => r.to === e.id)).length;
+        return { entities, relations, avgPageRank, orphanCount };
+    }
+    // ── File Discovery ──────────────────────────────────────────────────────────
+    findSourceFiles(dir, extensions) {
+        const results = [];
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    // Skip common non-source directories
+                    if (['node_modules', '.git', 'dist', 'build', '.next', '__pycache__', 'target', 'vendor'].includes(entry.name))
+                        continue;
+                    results.push(...this.findSourceFiles(fullPath, extensions));
+                }
+                else if (extensions.some(ext => entry.name.endsWith(ext))) {
+                    results.push(fullPath);
+                }
+            }
+        }
+        catch {
+            // Permission denied or other — skip
+        }
+        return results;
+    }
+    // ── Persistence ─────────────────────────────────────────────────────────────
+    async saveToDisk() {
+        try {
+            if (!fs.existsSync(GRAPH_DIR)) {
+                fs.mkdirSync(GRAPH_DIR, { recursive: true });
+            }
+            const serializable = {
+                entities: Array.from(this.graph.entities.entries()).map(([id, e]) => [id, {
+                        ...e,
+                        refs: e.refs,
+                    }]),
+                relations: this.graph.relations,
+                lastBuilt: this.graph.lastBuilt.toISOString(),
+                fileCount: this.graph.fileCount,
+            };
+            fs.writeFileSync(path.join(GRAPH_DIR, 'graph.json'), JSON.stringify(serializable));
+        }
+        catch {
+            // Non-blocking
+        }
+    }
+    loadFromDisk() {
+        try {
+            const graphFile = path.join(GRAPH_DIR, 'graph.json');
+            if (!fs.existsSync(graphFile))
+                return;
+            const data = JSON.parse(fs.readFileSync(graphFile, 'utf-8'));
+            this.graph = {
+                entities: new Map(data.entities.map(([id, e]) => [id, e])),
+                relations: data.relations || [],
+                lastBuilt: new Date(data.lastBuilt),
+                fileCount: data.fileCount || 0,
+            };
+        }
+        catch {
+            // Fresh start
+        }
+    }
+}
+//# sourceMappingURL=knowledge-graph.js.map

package/dist/brain/knowledge-graph.js.map

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

package/dist/brain/learning-engine.d.ts

@@ -1,11 +1,14 @@
 import type { BrainInsight, FileChange, ProjectContext, LearnedLesson, ProjectKnowledge } from '../types.js';
 import type { LLMClient } from './llm-client.js';
+import { SelfEvolution } from './self-evolution.js';
 export declare class LearningEngine {
     private store;
     private storePath;
     private saveTimer;
     private projectDir;
     private llmClient;
+    private selfEvolution;
+    private evolveCounter;
     constructor(projectDir: string, llmClient?: LLMClient);
     load(): Promise<void>;
     save(): Promise<void>;
@@ -50,5 +53,13 @@ export declare class LearningEngine {
     private extractCodePattern;
     private contentFollowsConvention;
     private generateLLMInsights;
+    /** v4.0.0: Get the self-evolution engine reference */
+    getSelfEvolution(): SelfEvolution;
+    /** v4.0.0: Get evolution stats */
+    getEvolutionStats(): {
+        generation: number;
+        populationSize: number;
+        bestFitness: number;
+    };
 }
 //# sourceMappingURL=learning-engine.d.ts.map

package/dist/brain/learning-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"learning-engine.d.ts","sourceRoot":"","sources":["../../src/brain/learning-engine.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAe,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1H,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAgBjD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAmB;gBAExB,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS;IAkB/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAmDrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,OAAO,CAAC,YAAY;IAcpB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAgFxE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAwBvD,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6DnF,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,aAAa,EAAE;IAuC1D,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAI1D,oBAAoB,CACxB,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC;IA0E1B,QAAQ,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IAexG;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiEvC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAW7G;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CzD,OAAO,IAAI,IAAI;YAqBD,SAAS;YAST,kBAAkB;IA+ChC,OAAO,CAAC,uBAAuB;YAiGjB,oBAAoB;IAiFlC,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,CAAC,wBAAwB;YAYlB,mBAAmB;CAyFlC"}
+{"version":3,"file":"learning-engine.d.ts","sourceRoot":"","sources":["../../src/brain/learning-engine.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAe,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1H,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAgBpD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAK;gBAEd,UAAU,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS;IAmB/C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkErB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,OAAO,CAAC,YAAY;IAcpB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI;IAsFxE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAkCvD,oBAAoB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA6DnF,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,aAAa,EAAE;IAgD1D,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAI1D,oBAAoB,CACxB,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,YAAY,EAAE,CAAC;IA0E1B,QAAQ,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IAexG;;;OAGG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiEvC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAW7G;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CzD,OAAO,IAAI,IAAI;YAqBD,SAAS;YAST,kBAAkB;IA+ChC,OAAO,CAAC,uBAAuB;YAiGjB,oBAAoB;IAiFlC,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,kBAAkB;IAkC1B,OAAO,CAAC,wBAAwB;YAYlB,mBAAmB;IA0FjC,sDAAsD;IACtD,gBAAgB,IAAI,aAAa;IAIjC,kCAAkC;IAClC,iBAAiB,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;CAQzF"}

package/dist/brain/learning-engine.js

@@ -1,16 +1,20 @@
 // src/brain/learning-engine.ts — Self-Improvement Learning Engine for Shadow Brain
 // Learns from past analysis sessions and gets smarter over time.
+// v4.0.0 — SelfEvolution genetic rule optimization integration
 import * as fs from 'fs/promises';
 import * as path from 'path';
 import * as os from 'os';
 import * as crypto from 'crypto';
+import { SelfEvolution } from './self-evolution.js';
 // ── Learning Engine ─────────────────────────────────────────────────────────
 export class LearningEngine {
     constructor(projectDir, llmClient) {
         this.saveTimer = null;
+        this.evolveCounter = 0;
         this.projectDir = projectDir;
         this.llmClient = llmClient ?? null;
         this.storePath = path.join(os.homedir(), '.shadow-brain', 'learning.json');
+        this.selfEvolution = new SelfEvolution();
         this.store = {
             version: 1,
             lessons: [],
@@ -70,6 +74,19 @@ export class LearningEngine {
                 lastTraining: new Date(),
             };
         }
+        // v4.0.0: Apply evolved rules to adjust lesson confidence
+        const bestRules = this.selfEvolution.getBestRules('all', 10);
+        for (const lesson of this.store.lessons) {
+            const matchingRule = bestRules.find(r => r.category === lesson.category || r.category === 'all');
+            if (matchingRule) {
+                if (matchingRule.fitness > 0.7) {
+                    lesson.confidence = Math.min(1.0, lesson.confidence + 0.1);
+                }
+                else if (matchingRule.fitness < 0.3) {
+                    lesson.confidence = Math.max(0, lesson.confidence - 0.05);
+                }
+            }
+        }
     }
     async save() {
         try {
@@ -162,6 +179,11 @@ export class LearningEngine {
             }
             this.store.lastTraining = now;
             this.scheduleSave();
+            // v4.0.0: Trigger self-evolution every 10 calls
+            this.evolveCounter++;
+            if (this.evolveCounter % 10 === 0) {
+                this.selfEvolution.evolve(insights).catch(() => { });
+            }
         }
         catch (err) {
             console.error(`[LearningEngine] learnFromInsights error: ${err.message}`);
@@ -181,6 +203,9 @@ export class LearningEngine {
                 }
                 this.store.falsePositiveRates[insightId].dismissed++;
             }
+            // v4.0.0: Feed self-evolution meta-learning
+            const category = this.store.lessons.find((l) => l.lesson.slice(0, 50) === insightId.slice(0, 50))?.category || 'general';
+            this.selfEvolution.updateMetaLearning(`feedback:${insightId.slice(0, 30)}`, accepted, category);
             this.scheduleSave();
         }
         catch (err) {
@@ -243,6 +268,8 @@ Return a JSON object with these fields:
     getRelevantLessons(changes) {
         const now = new Date();
         const relevant = [];
+        // v4.0.0: Get best evolved rules for confidence adjustment
+        const bestRules = this.selfEvolution.getBestRules('all', 10);
         for (const change of changes) {
             const pattern = this.extractPattern(change);
             if (!pattern)
@@ -255,9 +282,12 @@ Return a JSON object with these fields:
                     // Boost confidence for recently seen lessons
                     const daysSinceLastSeen = (now.getTime() - new Date(lesson.lastSeen).getTime()) / (1000 * 60 * 60 * 24);
                     const recencyBoost = Math.max(0, 1 - daysSinceLastSeen / 30) * 0.1;
+                    // v4.0.0: Apply evolved rule fitness as confidence modifier
+                    const matchingRule = bestRules.find(r => r.category === lesson.category || r.category === 'all');
+                    const fitnessBoost = matchingRule ? matchingRule.fitness * 0.2 : 0;
                     relevant.push({
                         ...lesson,
-                        confidence: Math.min(1.0, lesson.confidence + recencyBoost),
+                        confidence: Math.min(1.0, lesson.confidence + recencyBoost + fitnessBoost),
                     });
                 }
             }
@@ -851,5 +881,18 @@ Do NOT report obvious linting issues — only things that require deep understan
             return [];
         }
     }
+    /** v4.0.0: Get the self-evolution engine reference */
+    getSelfEvolution() {
+        return this.selfEvolution;
+    }
+    /** v4.0.0: Get evolution stats */
+    getEvolutionStats() {
+        const bestRules = this.selfEvolution.getBestRules('all', 1);
+        return {
+            generation: this.selfEvolution.getGeneration(),
+            populationSize: this.selfEvolution.getPopulationSize(),
+            bestFitness: bestRules.length > 0 ? bestRules[0].fitness : 0,
+        };
+    }
 }
 //# sourceMappingURL=learning-engine.js.map