@theihtisham/agent-shadow-brain 2.1.0 → 4.0.0

package/dist/brain/influence-map.js

@@ -0,0 +1,375 @@
+// src/brain/influence-map.ts — Code change influence mapping
+// v3.1.0 — Predicts which files are affected by changes using import graph analysis
+import * as fs from 'fs';
+import * as path from 'path';
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', 'out', 'coverage', '.next', '.nuxt', '.cache',
+]);
+const CODE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.py', '.rs', '.go', '.java']);
+export class InfluenceMapper {
+    constructor(projectDir) {
+        this.graph = new Map();
+        this.projectDir = projectDir;
+    }
+    async analyzeProject(maxFiles = 300) {
+        const files = this.collectFiles(this.projectDir, maxFiles);
+        const insights = [];
+        // Build the import graph
+        this.buildGraph(files);
+        // Find high-influence files (files imported by many others)
+        const influenceMap = this.calculateInfluenceScores();
+        // Generate insights for high-influence files
+        const highInfluence = influenceMap
+            .filter(f => f.score >= 5)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, 20);
+        if (highInfluence.length > 0) {
+            insights.push({
+                type: 'architecture',
+                priority: 'medium',
+                title: `[architecture] ${highInfluence.length} high-influence files detected (change impact analysis)`,
+                content: `Import graph analysis found ${highInfluence.length} files with high change influence.\n` +
+                    `  Total files in graph: ${this.graph.size}\n` +
+                    `  These files affect many others when changed:\n` +
+                    highInfluence.map(f => `    - ${f.file} (influence: ${f.score}, imported by ${this.graph.get(f.file)?.importedBy.size || 0} files)`).join('\n') +
+                    `\n  Changes to these files require thorough testing of dependent modules.`,
+                files: highInfluence.map(f => f.file),
+                timestamp: new Date(),
+                confidence: 0.8,
+                metadata: {
+                    totalFiles: this.graph.size,
+                    highInfluenceFiles: highInfluence.map(f => ({
+                        file: f.file,
+                        score: f.score,
+                        dependents: this.graph.get(f.file)?.importedBy.size || 0,
+                    })),
+                },
+            });
+        }
+        // Detect potential orphan files
+        const orphans = [...this.graph.values()].filter(node => node.imports.size === 0 && node.importedBy.size === 0);
+        if (orphans.length > 0 && orphans.length < this.graph.size * 0.5) {
+            insights.push({
+                type: 'architecture',
+                priority: 'low',
+                title: `[architecture] ${orphans.length} orphan files (no import relationships)`,
+                content: `${orphans.length} files have no detected import relationships.\n` +
+                    `  These may be: entry points, standalone scripts, or dead code.\n` +
+                    `  Files: ${orphans.slice(0, 10).map(o => o.path).join(', ')}${orphans.length > 10 ? ' ...' : ''}`,
+                files: orphans.map(o => o.path).slice(0, 20),
+                timestamp: new Date(),
+                confidence: 0.6,
+                metadata: { orphanCount: orphans.length },
+            });
+        }
+        return insights;
+    }
+    analyzeInfluence(changedFiles) {
+        const affectedMap = new Map();
+        for (const changedFile of changedFiles) {
+            const relPath = this.toRelative(changedFile);
+            // 1. Direct reverse dependencies (weight 3)
+            const directDeps = this.getReverseDependencies(relPath);
+            for (const dep of directDeps) {
+                if (!affectedMap.has(dep)) {
+                    affectedMap.set(dep, { score: 0, reasons: new Set() });
+                }
+                const entry = affectedMap.get(dep);
+                entry.score += 3;
+                entry.reasons.add(`directly imports ${relPath}`);
+            }
+            // 2. Transitive (indirect) dependencies (weight 1)
+            const transitiveDeps = this.getTransitiveReverseDependencies(relPath, new Set(), 0, 3);
+            for (const dep of transitiveDeps) {
+                if (directDeps.has(dep))
+                    continue; // already counted as direct
+                if (!affectedMap.has(dep)) {
+                    affectedMap.set(dep, { score: 0, reasons: new Set() });
+                }
+                const entry = affectedMap.get(dep);
+                entry.score += 1;
+                entry.reasons.add(`indirectly depends on ${relPath}`);
+            }
+            // 3. Test file correlation (weight 2)
+            const testFile = this.findTestCorrelation(relPath);
+            if (testFile && this.graph.has(testFile)) {
+                if (!affectedMap.has(testFile)) {
+                    affectedMap.set(testFile, { score: 0, reasons: new Set() });
+                }
+                const entry = affectedMap.get(testFile);
+                entry.score += 2;
+                entry.reasons.add(`test file for ${relPath}`);
+            }
+            // Also check if the changed file IS a test file — mark the source
+            const sourceFile = this.findSourceForTest(relPath);
+            if (sourceFile && this.graph.has(sourceFile)) {
+                if (!affectedMap.has(sourceFile)) {
+                    affectedMap.set(sourceFile, { score: 0, reasons: new Set() });
+                }
+                const entry = affectedMap.get(sourceFile);
+                entry.score += 2;
+                entry.reasons.add(`source file tested by ${relPath}`);
+            }
+        }
+        // Sort by score descending, take top 20
+        const affected = [...affectedMap.entries()]
+            .map(([file, data]) => ({
+            file,
+            score: data.score,
+            reasons: [...data.reasons],
+        }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, 20);
+        const maxScore = affected.length > 0 ? affected[0].score : 0;
+        const riskLevel = maxScore >= 15 ? 'high' : maxScore >= 8 ? 'medium' : 'low';
+        return {
+            changedFiles: changedFiles.map(f => this.toRelative(f)),
+            affectedFiles: affected,
+            totalReachable: affectedMap.size,
+            riskLevel,
+        };
+    }
+    buildGraph(files) {
+        this.graph.clear();
+        // Phase 1: Create nodes
+        for (const filePath of files) {
+            const relPath = path.relative(this.projectDir, filePath).replace(/\\/g, '/');
+            this.graph.set(relPath, {
+                path: relPath,
+                imports: new Set(),
+                importedBy: new Set(),
+                testCorrelation: this.inferTestFile(relPath),
+            });
+        }
+        // Phase 2: Extract imports and build edges
+        for (const filePath of files) {
+            const relPath = path.relative(this.projectDir, filePath).replace(/\\/g, '/');
+            const imports = this.extractImports(filePath, relPath);
+            const node = this.graph.get(relPath);
+            if (!node)
+                continue;
+            for (const importPath of imports) {
+                node.imports.add(importPath);
+                const targetNode = this.graph.get(importPath);
+                if (targetNode) {
+                    targetNode.importedBy.add(relPath);
+                }
+            }
+        }
+    }
+    extractImports(filePath, relPath) {
+        let content;
+        try {
+            content = fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            return [];
+        }
+        const ext = path.extname(filePath);
+        const dir = path.dirname(relPath);
+        const imports = [];
+        if (['.ts', '.tsx', '.js', '.jsx'].includes(ext)) {
+            // ESM: import ... from './foo'
+            const esmPattern = /import\s+(?:type\s+)?(?:[\w{},\s*]*\s+from\s+)?['"]([^'"]+)['"]/g;
+            let match;
+            while ((match = esmPattern.exec(content)) !== null) {
+                const resolved = this.resolveImport(match[1], dir, ext);
+                if (resolved)
+                    imports.push(resolved);
+            }
+            // Dynamic imports: import('./foo')
+            const dynamicPattern = /import\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+            while ((match = dynamicPattern.exec(content)) !== null) {
+                const resolved = this.resolveImport(match[1], dir, ext);
+                if (resolved)
+                    imports.push(resolved);
+            }
+            // CJS: require('./foo')
+            const cjsPattern = /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+            while ((match = cjsPattern.exec(content)) !== null) {
+                const resolved = this.resolveImport(match[1], dir, ext);
+                if (resolved)
+                    imports.push(resolved);
+            }
+        }
+        else if (ext === '.py') {
+            const pyPattern = /(?:from|import)\s+([.\w]+)/g;
+            let match;
+            while ((match = pyPattern.exec(content)) !== null) {
+                const resolved = this.resolvePythonImport(match[1], dir);
+                if (resolved)
+                    imports.push(resolved);
+            }
+        }
+        else if (ext === '.go') {
+            // Go imports are in import blocks
+            const goPattern = /"([^"]+)"/g;
+            const importBlock = content.match(/import\s*\([\s\S]*?\)/);
+            let match;
+            if (importBlock) {
+                while ((match = goPattern.exec(importBlock[0])) !== null) {
+                    // Go uses module paths, limited local resolution
+                    const localPath = match[1].replace(/\/.*$/, '');
+                    if (this.graph.has(localPath))
+                        imports.push(localPath);
+                }
+            }
+        }
+        return [...new Set(imports)];
+    }
+    resolveImport(importPath, fromDir, ext) {
+        // Only resolve relative imports (not node_modules or packages)
+        if (!importPath.startsWith('.'))
+            return null;
+        const extensions = ['.ts', '.tsx', '.js', '.jsx', '/index.ts', '/index.tsx', '/index.js', '/index.jsx'];
+        // Normalize the path
+        let resolved = path.normalize(path.join(fromDir, importPath)).replace(/\\/g, '/');
+        // Try exact path first
+        if (this.graph.has(resolved))
+            return resolved;
+        // Try with extensions
+        for (const tryExt of extensions) {
+            const candidate = resolved + tryExt;
+            if (this.graph.has(candidate))
+                return candidate;
+        }
+        return null;
+    }
+    resolvePythonImport(importPath, fromDir) {
+        const parts = importPath.split('.');
+        const candidates = [
+            parts.join('/') + '.py',
+            path.join(...parts.slice(0, -1), '__init__.py'),
+        ];
+        for (const candidate of candidates) {
+            if (this.graph.has(candidate))
+                return candidate;
+        }
+        return null;
+    }
+    getReverseDependencies(filePath) {
+        const node = this.graph.get(filePath);
+        if (!node)
+            return new Set();
+        return new Set(node.importedBy);
+    }
+    getTransitiveReverseDependencies(filePath, visited, depth, maxDepth) {
+        const result = new Set();
+        if (depth >= maxDepth)
+            return result;
+        const node = this.graph.get(filePath);
+        if (!node)
+            return result;
+        for (const dep of node.importedBy) {
+            if (visited.has(dep))
+                continue;
+            visited.add(dep);
+            result.add(dep);
+            // Recurse to find transitive deps
+            const transitive = this.getTransitiveReverseDependencies(dep, visited, depth + 1, maxDepth);
+            for (const t of transitive) {
+                result.add(t);
+            }
+        }
+        return result;
+    }
+    inferTestFile(relPath) {
+        const ext = path.extname(relPath);
+        const base = relPath.replace(ext, '');
+        const testPatterns = [
+            `${base}.test${ext}`,
+            `${base}.spec${ext}`,
+            `${base}.test.ts`,
+            `${base}.spec.ts`,
+            `tests/${base}.test${ext}`,
+            `test/${base}.test${ext}`,
+            `__tests__/${base}.test${ext}`,
+        ];
+        for (const pattern of testPatterns) {
+            if (this.graph.has(pattern))
+                return pattern;
+        }
+        return null;
+    }
+    findTestCorrelation(relPath) {
+        const node = this.graph.get(relPath);
+        if (node?.testCorrelation)
+            return node.testCorrelation;
+        // Try inferring
+        return this.inferTestFile(relPath);
+    }
+    findSourceForTest(testPath) {
+        // Reverse: given a test file, find the source
+        const testMatch = testPath.match(/^(.+?)(?:\.test|\.spec|_test|Test)(\.\w+)$/);
+        if (!testMatch)
+            return null;
+        const sourcePath = testMatch[1] + testMatch[2];
+        if (this.graph.has(sourcePath))
+            return sourcePath;
+        // Try common extensions
+        const ext = testMatch[2];
+        const base = testMatch[1];
+        const candidates = [base + ext, base + '.ts', base + '.tsx', base + '.js'];
+        for (const candidate of candidates) {
+            if (this.graph.has(candidate))
+                return candidate;
+        }
+        return null;
+    }
+    calculateInfluenceScores() {
+        const scores = [];
+        for (const [file, node] of this.graph) {
+            let score = 0;
+            // Direct dependents
+            score += node.importedBy.size * 3;
+            // Transitive reach
+            const transitive = this.getTransitiveReverseDependencies(file, new Set([file]), 0, 2);
+            score += transitive.size * 1;
+            // Is imported by many = higher influence
+            // Is a hub (imports many + imported by many) = higher influence
+            if (node.imports.size > 3 && node.importedBy.size > 3) {
+                score += 5;
+            }
+            scores.push({ file, score });
+        }
+        return scores;
+    }
+    toRelative(filePath) {
+        if (path.isAbsolute(filePath)) {
+            return path.relative(this.projectDir, filePath).replace(/\\/g, '/');
+        }
+        return filePath.replace(/\\/g, '/');
+    }
+    collectFiles(dir, maxFiles) {
+        const results = [];
+        const walk = (currentDir, depth) => {
+            if (results.length >= maxFiles || depth > 10)
+                return;
+            let entries;
+            try {
+                entries = fs.readdirSync(currentDir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                if (results.length >= maxFiles)
+                    return;
+                if (entry.name.startsWith('.'))
+                    continue;
+                const fullPath = path.join(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    if (IGNORE_DIRS.has(entry.name))
+                        continue;
+                    walk(fullPath, depth + 1);
+                }
+                else if (entry.isFile() && CODE_EXTENSIONS.has(path.extname(entry.name))) {
+                    results.push(fullPath);
+                }
+            }
+        };
+        walk(dir, 0);
+        return results;
+    }
+}
+//# sourceMappingURL=influence-map.js.map

package/dist/brain/influence-map.js.map

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

package/dist/brain/knowledge-graph.d.ts

@@ -0,0 +1,56 @@
+import { KGEntity, KGRelation, KGGraph, PageRankResult } from '../types.js';
+/**
+ * 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 declare class KnowledgeGraph {
+    private graph;
+    private projectDir;
+    constructor(projectDir: string);
+    /** Build the knowledge graph from project source files */
+    build(): Promise<KGGraph>;
+    /** Add a single entity */
+    addEntity(entity: KGEntity): void;
+    /** Add a relation */
+    addRelation(relation: KGRelation): void;
+    /** Extract code entities from source file content */
+    private extractEntities;
+    /** Extract relations between entities based on imports, calls, etc. */
+    private extractRelations;
+    /**
+     * Compute PageRank scores for all entities.
+     * Damping factor: 0.85, convergence: < 0.0001, max iterations: 100.
+     */
+    pageRank(iterations?: number): PageRankResult;
+    /** Get top-N most important entities by PageRank */
+    getTopEntities(topN?: number): KGEntity[];
+    /** Find entities impacted by a change to the given entity */
+    getImpactedBy(entityId: string): KGEntity[];
+    private findDownstream;
+    /** Find circular dependencies */
+    findCycles(): string[][];
+    /** Get graph statistics */
+    getStats(): {
+        entities: number;
+        relations: number;
+        avgPageRank: number;
+        orphanCount: number;
+    };
+    private findSourceFiles;
+    private saveToDisk;
+    private loadFromDisk;
+}
+//# sourceMappingURL=knowledge-graph.d.ts.map

package/dist/brain/knowledge-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph.d.ts","sourceRoot":"","sources":["../../src/brain/knowledge-graph.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAI5E;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAa9B,0DAA0D;IACpD,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IA+B/B,0BAA0B;IAC1B,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAIjC,qBAAqB;IACrB,WAAW,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;IAMvC,qDAAqD;IACrD,OAAO,CAAC,eAAe;IA4FvB,uEAAuE;IACvE,OAAO,CAAC,gBAAgB;IAmDxB;;;OAGG;IACH,QAAQ,CAAC,UAAU,GAAE,MAAY,GAAG,cAAc;IAsGlD,oDAAoD;IACpD,cAAc,CAAC,IAAI,GAAE,MAAW,GAAG,QAAQ,EAAE;IAM7C,6DAA6D;IAC7D,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE;IAS3C,OAAO,CAAC,cAAc;IAWtB,iCAAiC;IACjC,UAAU,IAAI,MAAM,EAAE,EAAE;IAsCxB,2BAA2B;IAC3B,QAAQ,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAa7F,OAAO,CAAC,eAAe;YAsBT,UAAU;IAyBxB,OAAO,CAAC,YAAY;CAgBrB"}