@theihtisham/agent-shadow-brain 1.1.1 → 2.1.0

package/dist/brain/code-metrics.js

@@ -0,0 +1,224 @@
+// src/brain/code-metrics.ts — Code metrics: LOC, complexity, language breakdown, churn
+import * as fs from 'fs';
+import * as path from 'path';
+const LANGUAGE_MAP = {
+    '.ts': 'TypeScript', '.tsx': 'TypeScript', '.js': 'JavaScript', '.jsx': 'JavaScript',
+    '.py': 'Python', '.rb': 'Ruby', '.go': 'Go', '.rs': 'Rust', '.java': 'Java',
+    '.kt': 'Kotlin', '.swift': 'Swift', '.c': 'C', '.cpp': 'C++', '.h': 'C/C++',
+    '.cs': 'C#', '.php': 'PHP', '.scala': 'Scala', '.r': 'R', '.sql': 'SQL',
+    '.sh': 'Shell', '.bash': 'Shell', '.ps1': 'PowerShell',
+    '.html': 'HTML', '.css': 'CSS', '.scss': 'SCSS', '.less': 'LESS',
+    '.json': 'JSON', '.yaml': 'YAML', '.yml': 'YAML', '.toml': 'TOML',
+    '.md': 'Markdown', '.vue': 'Vue', '.svelte': 'Svelte',
+};
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', 'out', 'target', 'vendor',
+    '__pycache__', '.next', '.nuxt', 'coverage', '.cache', '.tox',
+    'venv', '.venv', 'env', '.env', 'bin', 'obj', 'Pods', '.gradle',
+]);
+export class CodeMetricsEngine {
+    constructor(projectDir, opts) {
+        this.projectDir = projectDir;
+        this.excludePaths = opts?.excludePaths || [];
+        this.complexityThreshold = opts?.complexityThreshold || 15;
+    }
+    compute(changes) {
+        const files = this.walkDir(this.projectDir);
+        const languages = {};
+        const fileTypes = {};
+        const largestFiles = [];
+        const complexityHotspots = [];
+        let totalLines = 0;
+        let codeLines = 0;
+        let commentLines = 0;
+        let blankLines = 0;
+        for (const filePath of files) {
+            const ext = path.extname(filePath);
+            const lang = LANGUAGE_MAP[ext] || 'Other';
+            const relPath = path.relative(this.projectDir, filePath);
+            fileTypes[ext] = (fileTypes[ext] || 0) + 1;
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                const lines = content.split('\n');
+                const lineCount = lines.length;
+                // Classify lines
+                let fileCodeLines = 0;
+                let fileCommentLines = 0;
+                let fileBlankLines = 0;
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (trimmed === '') {
+                        fileBlankLines++;
+                        continue;
+                    }
+                    if (trimmed.startsWith('//') || trimmed.startsWith('#') || trimmed.startsWith('/*') ||
+                        trimmed.startsWith('*') || trimmed.startsWith('"""') || trimmed.startsWith("'''")) {
+                        fileCommentLines++;
+                    }
+                    else {
+                        fileCodeLines++;
+                    }
+                }
+                totalLines += lineCount;
+                codeLines += fileCodeLines;
+                commentLines += fileCommentLines;
+                blankLines += fileBlankLines;
+                // Track language stats
+                if (!languages[lang])
+                    languages[lang] = { files: 0, lines: 0, percentage: 0 };
+                languages[lang].files++;
+                languages[lang].lines += lineCount;
+                // Track largest files
+                largestFiles.push({ path: relPath, lines: lineCount });
+                // Estimate complexity for code files
+                if (['.ts', '.tsx', '.js', '.jsx', '.py', '.go', '.java', '.rs'].includes(ext)) {
+                    const complexity = this.estimateComplexity(content);
+                    const functions = this.countFunctions(content);
+                    if (complexity >= this.complexityThreshold) {
+                        complexityHotspots.push({ path: relPath, complexity, functions });
+                    }
+                }
+            }
+            catch { /* binary or unreadable file */ }
+        }
+        // Calculate percentages
+        for (const lang of Object.values(languages)) {
+            lang.percentage = totalLines > 0 ? Math.round((lang.lines / totalLines) * 100) : 0;
+        }
+        // Sort largest files
+        largestFiles.sort((a, b) => b.lines - a.lines);
+        complexityHotspots.sort((a, b) => b.complexity - a.complexity);
+        return {
+            totalFiles: files.length,
+            totalLines,
+            codeLines,
+            commentLines,
+            blankLines,
+            languages,
+            largestFiles: largestFiles.slice(0, 20),
+            complexityHotspots: complexityHotspots.slice(0, 10),
+            fileTypes,
+            avgFileSize: files.length > 0 ? Math.round(totalLines / files.length) : 0,
+            timestamp: new Date(),
+        };
+    }
+    walkDir(dir, depth = 0) {
+        if (depth > 6)
+            return [];
+        const files = [];
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.name.startsWith('.') && entry.name !== '.env.example')
+                    continue;
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    if (IGNORE_DIRS.has(entry.name))
+                        continue;
+                    if (this.excludePaths.some(p => fullPath.includes(p)))
+                        continue;
+                    files.push(...this.walkDir(fullPath, depth + 1));
+                }
+                else if (entry.isFile()) {
+                    // Skip binary files
+                    const ext = path.extname(entry.name);
+                    if (['.png', '.jpg', '.jpeg', '.gif', '.ico', '.svg', '.woff', '.woff2',
+                        '.ttf', '.eot', '.mp3', '.mp4', '.zip', '.gz', '.tar', '.exe',
+                        '.dll', '.so', '.dylib', '.pyc', '.class', '.o', '.obj'].includes(ext)) {
+                        continue;
+                    }
+                    files.push(fullPath);
+                }
+            }
+        }
+        catch { /* permission error */ }
+        return files;
+    }
+    estimateComplexity(content) {
+        // Cyclomatic complexity estimation: count decision points
+        const decisionPatterns = [
+            /\bif\b/g, /\belse\b/g, /\bfor\b/g, /\bwhile\b/g,
+            /\bcase\b/g, /\bcatch\b/g, /&&/g, /\|\|/g, /\?\?/g,
+            /\?\./g, /\bawait\b/g,
+        ];
+        let complexity = 1;
+        for (const pattern of decisionPatterns) {
+            const matches = content.match(pattern);
+            if (matches)
+                complexity += matches.length;
+        }
+        return complexity;
+    }
+    countFunctions(content) {
+        const patterns = [
+            /function\s+\w+/g,
+            /const\s+\w+\s*=\s*(?:async\s+)?(?:\([^)]*\)|[^=])\s*=>/g,
+            /(?:async\s+)?\w+\s*\([^)]*\)\s*:\s*\w+/g,
+            /def\s+\w+/g,
+            /func\s+\w+/g,
+            /fn\s+\w+/g,
+            /public\s+\w+\s+\w+\s*\(/g,
+            /private\s+\w+\s+\w+\s*\(/g,
+        ];
+        let count = 0;
+        for (const pattern of patterns) {
+            const matches = content.match(pattern);
+            if (matches)
+                count += matches.length;
+        }
+        return count;
+    }
+    formatConsole(metrics) {
+        let out = `\n  Code Metrics — ${metrics.totalFiles} files, ${metrics.totalLines.toLocaleString()} lines\n`;
+        out += `  ${'─'.repeat(55)}\n\n`;
+        out += `  Code:       ${metrics.codeLines.toLocaleString().padStart(8)} lines\n`;
+        out += `  Comments:   ${metrics.commentLines.toLocaleString().padStart(8)} lines\n`;
+        out += `  Blank:      ${metrics.blankLines.toLocaleString().padStart(8)} lines\n`;
+        out += `  Avg/ file:  ${metrics.avgFileSize.toLocaleString().padStart(8)} lines\n`;
+        out += `\n  Languages:\n`;
+        const sortedLangs = Object.entries(metrics.languages)
+            .sort((a, b) => b[1].lines - a[1].lines)
+            .slice(0, 8);
+        for (const [lang, data] of sortedLangs) {
+            const bar = '█'.repeat(Math.round(data.percentage / 5)) + '░'.repeat(Math.max(0, 20 - Math.round(data.percentage / 5)));
+            out += `    ${lang.padEnd(12)} ${bar} ${data.percentage}% (${data.files} files)\n`;
+        }
+        if (metrics.largestFiles.length > 0) {
+            out += `\n  Largest files:\n`;
+            for (const f of metrics.largestFiles.slice(0, 5)) {
+                out += `    ${f.lines.toLocaleString().padStart(6)} lines  ${f.path}\n`;
+            }
+        }
+        if (metrics.complexityHotspots.length > 0) {
+            out += `\n  Complexity hotspots (>${this.complexityThreshold}):\n`;
+            for (const f of metrics.complexityHotspots.slice(0, 5)) {
+                out += `    complexity ${String(f.complexity).padStart(4)}  ${f.functions} functions  ${f.path}\n`;
+            }
+        }
+        return out;
+    }
+    formatJSON(metrics) {
+        return JSON.stringify(metrics, null, 2);
+    }
+    toMarkdown(metrics) {
+        let md = `# Code Metrics\n\n`;
+        md += `| Metric | Value |\n|---|---|\n`;
+        md += `| Total files | ${metrics.totalFiles} |\n`;
+        md += `| Total lines | ${metrics.totalLines.toLocaleString()} |\n`;
+        md += `| Code lines | ${metrics.codeLines.toLocaleString()} |\n`;
+        md += `| Comment lines | ${metrics.commentLines.toLocaleString()} |\n`;
+        md += `| Avg file size | ${metrics.avgFileSize} lines |\n\n`;
+        md += `## Languages\n\n| Language | Files | Lines | % |\n|---|---|---|---|\n`;
+        for (const [lang, data] of Object.entries(metrics.languages).sort((a, b) => b[1].lines - a[1].lines).slice(0, 10)) {
+            md += `| ${lang} | ${data.files} | ${data.lines.toLocaleString()} | ${data.percentage}% |\n`;
+        }
+        if (metrics.complexityHotspots.length > 0) {
+            md += `\n## Complexity Hotspots\n\n| File | Complexity | Functions |\n|---|---|---|\n`;
+            for (const f of metrics.complexityHotspots) {
+                md += `| ${f.path} | ${f.complexity} | ${f.functions} |\n`;
+            }
+        }
+        return md;
+    }
+}
+//# sourceMappingURL=code-metrics.js.map

package/dist/brain/code-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-metrics.js","sourceRoot":"","sources":["../../src/brain/code-metrics.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAGvF,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,YAAY,GAA2B;IAC3C,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY;IACpF,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAC3E,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO;IAC3E,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK;IACvE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY;IACtD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAChE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IACjE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ;CACtD,CAAC;AAEF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ;IAClE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;IAC7D,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS;CAChE,CAAC,CAAC;AAEH,MAAM,OAAO,iBAAiB;IAK5B,YAAY,UAAkB,EAAE,IAAgE;QAC9F,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,IAAI,EAAE,YAAY,IAAI,EAAE,CAAC;QAC7C,IAAI,CAAC,mBAAmB,GAAG,IAAI,EAAE,mBAAmB,IAAI,EAAE,CAAC;IAC7D,CAAC;IAED,OAAO,CAAC,OAAsB;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAyE,EAAE,CAAC;QAC3F,MAAM,SAAS,GAA2B,EAAE,CAAC;QAC7C,MAAM,YAAY,GAA2C,EAAE,CAAC;QAChE,MAAM,kBAAkB,GAAmE,EAAE,CAAC;QAE9F,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC;YAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YAEzD,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAE3C,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;gBAE/B,iBAAiB;gBACjB,IAAI,aAAa,GAAG,CAAC,CAAC;gBACtB,IAAI,gBAAgB,GAAG,CAAC,CAAC;gBACzB,IAAI,cAAc,GAAG,CAAC,CAAC;gBAEvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;oBAC5B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;wBAAC,cAAc,EAAE,CAAC;wBAAC,SAAS;oBAAC,CAAC;oBACnD,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;wBAC/E,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;wBACtF,gBAAgB,EAAE,CAAC;oBACrB,CAAC;yBAAM,CAAC;wBACN,aAAa,EAAE,CAAC;oBAClB,CAAC;gBACH,CAAC;gBAED,UAAU,IAAI,SAAS,CAAC;gBACxB,SAAS,IAAI,aAAa,CAAC;gBAC3B,YAAY,IAAI,gBAAgB,CAAC;gBACjC,UAAU,IAAI,cAAc,CAAC;gBAE7B,uBAAuB;gBACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAAE,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;gBAC9E,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;gBACxB,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC;gBAEnC,sBAAsB;gBACtB,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;gBAEvD,qCAAqC;gBACrC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/E,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;oBACpD,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;oBAC/C,IAAI,UAAU,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;wBAC3C,kBAAkB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;oBACpE,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,+BAA+B,CAAC,CAAC;QAC7C,CAAC;QAED,wBAAwB;QACxB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5C,IAAI,CAAC,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrF,CAAC;QAED,qBAAqB;QACrB,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC/C,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;QAE/D,OAAO;YACL,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,UAAU;YACV,SAAS;YACT,YAAY;YACZ,UAAU;YACV,SAAS;YACT,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACvC,kBAAkB,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;YACnD,SAAS;YACT,WAAW,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACzE,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;IACJ,CAAC;IAEO,OAAO,CAAC,GAAW,EAAE,KAAK,GAAG,CAAC;QACpC,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QACzB,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;oBAAE,SAAS;gBAE1E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;wBAAE,SAAS;oBAC1C,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;wBAAE,SAAS;oBAChE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;gBACnD,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC1B,oBAAoB;oBACpB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBACrC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ;wBAClE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM;wBAC7D,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC5E,SAAS;oBACX,CAAC;oBACD,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC;QAElC,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,kBAAkB,CAAC,OAAe;QACxC,0DAA0D;QAC1D,MAAM,gBAAgB,GAAG;YACvB,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY;YAChD,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO;YAClD,OAAO,EAAE,YAAY;SACtB,CAAC;QACF,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,OAAO;gBAAE,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;QAC5C,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,cAAc,CAAC,OAAe;QACpC,MAAM,QAAQ,GAAG;YACf,iBAAiB;YACjB,yDAAyD;YACzD,yCAAyC;YACzC,YAAY;YACZ,aAAa;YACb,WAAW;YACX,0BAA0B;YAC1B,2BAA2B;SAC5B,CAAC;QACF,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,OAAO;gBAAE,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;QACvC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,aAAa,CAAC,OAAoB;QAChC,IAAI,GAAG,GAAG,sBAAsB,OAAO,CAAC,UAAU,WAAW,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,UAAU,CAAC;QAC3G,GAAG,IAAI,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC;QAEjC,GAAG,IAAI,iBAAiB,OAAO,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;QACjF,GAAG,IAAI,iBAAiB,OAAO,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;QACpF,GAAG,IAAI,iBAAiB,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;QAClF,GAAG,IAAI,iBAAiB,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;QAEnF,GAAG,IAAI,kBAAkB,CAAC;QAC1B,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;aAClD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;aACvC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,WAAW,EAAE,CAAC;YACvC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACxH,GAAG,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,MAAM,IAAI,CAAC,KAAK,WAAW,CAAC;QACrF,CAAC;QAED,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,GAAG,IAAI,sBAAsB,CAAC;YAC9B,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACjD,GAAG,IAAI,OAAO,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,IAAI,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,GAAG,IAAI,6BAA6B,IAAI,CAAC,mBAAmB,MAAM,CAAC;YACnE,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACvD,GAAG,IAAI,kBAAkB,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,eAAe,CAAC,CAAC,IAAI,IAAI,CAAC;YACrG,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED,UAAU,CAAC,OAAoB;QAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,UAAU,CAAC,OAAoB;QAC7B,IAAI,EAAE,GAAG,oBAAoB,CAAC;QAC9B,EAAE,IAAI,iCAAiC,CAAC;QACxC,EAAE,IAAI,mBAAmB,OAAO,CAAC,UAAU,MAAM,CAAC;QAClD,EAAE,IAAI,mBAAmB,OAAO,CAAC,UAAU,CAAC,cAAc,EAAE,MAAM,CAAC;QACnE,EAAE,IAAI,kBAAkB,OAAO,CAAC,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC;QACjE,EAAE,IAAI,qBAAqB,OAAO,CAAC,YAAY,CAAC,cAAc,EAAE,MAAM,CAAC;QACvE,EAAE,IAAI,qBAAqB,OAAO,CAAC,WAAW,cAAc,CAAC;QAE7D,EAAE,IAAI,uEAAuE,CAAC;QAC9E,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAClH,EAAE,IAAI,KAAK,IAAI,MAAM,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,UAAU,OAAO,CAAC;QAC/F,CAAC;QAED,IAAI,OAAO,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,EAAE,IAAI,gFAAgF,CAAC;YACvF,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;gBAC3C,EAAE,IAAI,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,UAAU,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/brain/code-similarity.d.ts

@@ -0,0 +1,43 @@
+import { DuplicateGroup } from '../types.js';
+export declare class CodeSimilarityDetector {
+    private projectDir;
+    constructor(projectDir: string);
+    /**
+     * Scan all source files for duplicate code blocks.
+     * Returns groups of blocks whose pairwise similarity >= minSimilarity.
+     */
+    detectDuplicates(minSimilarity?: number): Promise<DuplicateGroup[]>;
+    /**
+     * Walk the project tree, read each source file, and extract code blocks.
+     */
+    private collectAllBlocks;
+    /**
+     * Split a single file into code blocks by tracking brace depth.
+     * Recognises the block type (function, method, class, generic block).
+     * Only returns blocks with >= 6 lines.
+     */
+    private extractBlocks;
+    /**
+     * Compute Jaccard similarity between two code blocks.
+     * Tokenises content into word tokens, then calculates |intersection| / |union|.
+     */
+    private computeSimilarity;
+    /**
+     * Split content into individual word tokens and return as a Set.
+     * Strips punctuation and normalises to lowercase for comparison.
+     */
+    private tokenize;
+    /**
+     * Generate a refactoring suggestion based on the types of the duplicate blocks.
+     */
+    private suggestRefactor;
+    /**
+     * Walk a directory tree, returning full paths of source files.
+     */
+    private walkDir;
+    /**
+     * Produce a unique key for a block (file path + line range).
+     */
+    private blockKey;
+}
+//# sourceMappingURL=code-similarity.d.ts.map

package/dist/brain/code-similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-similarity.d.ts","sourceRoot":"","sources":["../../src/brain/code-similarity.ts"],"names":[],"mappings":"AAIA,OAAO,EAAa,cAAc,EAAE,MAAM,aAAa,CAAC;AASxD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAI9B;;;OAGG;IACG,gBAAgB,CAAC,aAAa,GAAE,MAAY,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA6C9E;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAoErB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAgBzB;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACH,OAAO,CAAC,eAAe;IA6BvB;;OAEG;IACH,OAAO,CAAC,OAAO;IA2Bf;;OAEG;IACH,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/brain/code-similarity.js

@@ -0,0 +1,227 @@
+// src/brain/code-similarity.ts — Detect duplicate/near-duplicate code blocks across a project
+import * as fs from 'fs';
+import * as path from 'path';
+const SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx']);
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', 'out', 'coverage',
+    '.cache', '.next', '.nuxt', 'vendor', '__pycache__',
+]);
+export class CodeSimilarityDetector {
+    constructor(projectDir) {
+        this.projectDir = projectDir;
+    }
+    /**
+     * Scan all source files for duplicate code blocks.
+     * Returns groups of blocks whose pairwise similarity >= minSimilarity.
+     */
+    async detectDuplicates(minSimilarity = 0.8) {
+        const allBlocks = this.collectAllBlocks();
+        const groups = [];
+        // Only consider blocks with 6+ lines
+        const eligible = allBlocks.filter(b => (b.endLine - b.startLine + 1) >= 6);
+        // Track which blocks have already been grouped to avoid duplicates
+        const assigned = new Set();
+        for (let i = 0; i < eligible.length; i++) {
+            const keyA = this.blockKey(eligible[i]);
+            if (assigned.has(keyA))
+                continue;
+            const similar = [eligible[i]];
+            for (let j = i + 1; j < eligible.length; j++) {
+                const keyB = this.blockKey(eligible[j]);
+                if (assigned.has(keyB))
+                    continue;
+                // Skip self-comparison (same file + same line range)
+                if (keyA === keyB)
+                    continue;
+                const sim = this.computeSimilarity(eligible[i], eligible[j]);
+                if (sim >= minSimilarity) {
+                    similar.push(eligible[j]);
+                    assigned.add(keyB);
+                }
+            }
+            if (similar.length > 1) {
+                assigned.add(keyA);
+                groups.push({
+                    blocks: similar,
+                    similarity: minSimilarity,
+                    suggestedRefactor: this.suggestRefactor(similar),
+                });
+            }
+        }
+        return groups;
+    }
+    // ── Private Helpers ────────────────────────────────────────────────────────
+    /**
+     * Walk the project tree, read each source file, and extract code blocks.
+     */
+    collectAllBlocks() {
+        const files = this.walkDir(this.projectDir);
+        const blocks = [];
+        for (const filePath of files) {
+            try {
+                const content = fs.readFileSync(filePath, 'utf-8');
+                const extracted = this.extractBlocks(filePath, content);
+                blocks.push(...extracted);
+            }
+            catch {
+                // unreadable file — skip
+            }
+        }
+        return blocks;
+    }
+    /**
+     * Split a single file into code blocks by tracking brace depth.
+     * Recognises the block type (function, method, class, generic block).
+     * Only returns blocks with >= 6 lines.
+     */
+    extractBlocks(filePath, content) {
+        const blocks = [];
+        const lines = content.split('\n');
+        let depth = 0;
+        let blockStart = -1;
+        let blockType = 'block';
+        let pendingType = 'block';
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Detect what kind of block is about to open
+            if (depth === 0) {
+                const trimmed = line.trim();
+                if (/\bclass\b/.test(trimmed) && /\{/.test(trimmed)) {
+                    pendingType = 'class';
+                }
+                else if (/\b(function\b|=>\s*\{|async\s+function\b|\*\s*\w+\s*\()/.test(trimmed) &&
+                    /\{/.test(trimmed)) {
+                    pendingType = 'function';
+                }
+                else if (/^\s*(public|private|protected|static|async|get|set|readonly)\s.*\{/.test(trimmed) ||
+                    /^\s*\*?\s*\w+\s*\([^)]*\)\s*(?::\s*\w[^{]*)?\{/.test(trimmed)) {
+                    pendingType = 'method';
+                }
+                else if (/\{/.test(trimmed)) {
+                    pendingType = 'block';
+                }
+            }
+            // Track brace depth
+            const opens = (line.match(/\{/g) || []).length;
+            const closes = (line.match(/\}/g) || []).length;
+            const prevDepth = depth;
+            depth += opens - closes;
+            if (opens > 0 && prevDepth === 0) {
+                // Entering a top-level block
+                blockStart = i;
+                blockType = pendingType;
+            }
+            if (prevDepth > 0 && depth === 0 && blockStart >= 0) {
+                // Exiting a block
+                const endLine = i;
+                const lineCount = endLine - blockStart + 1;
+                if (lineCount >= 6) {
+                    blocks.push({
+                        file: filePath,
+                        startLine: blockStart + 1, // 1-based
+                        endLine: endLine + 1,
+                        content: lines.slice(blockStart, endLine + 1).join('\n'),
+                        type: blockType,
+                    });
+                }
+                blockStart = -1;
+                blockType = 'block';
+            }
+        }
+        return blocks;
+    }
+    /**
+     * Compute Jaccard similarity between two code blocks.
+     * Tokenises content into word tokens, then calculates |intersection| / |union|.
+     */
+    computeSimilarity(a, b) {
+        const tokensA = this.tokenize(a.content);
+        const tokensB = this.tokenize(b.content);
+        if (tokensA.size === 0 && tokensB.size === 0)
+            return 1.0;
+        if (tokensA.size === 0 || tokensB.size === 0)
+            return 0.0;
+        let intersectionSize = 0;
+        for (const token of tokensA) {
+            if (tokensB.has(token))
+                intersectionSize++;
+        }
+        const unionSize = tokensA.size + tokensB.size - intersectionSize;
+        return unionSize === 0 ? 0 : intersectionSize / unionSize;
+    }
+    /**
+     * Split content into individual word tokens and return as a Set.
+     * Strips punctuation and normalises to lowercase for comparison.
+     */
+    tokenize(content) {
+        const words = content
+            .replace(/[^\w\s]/g, ' ')
+            .split(/\s+/)
+            .filter(w => w.length > 0)
+            .map(w => w.toLowerCase());
+        return new Set(words);
+    }
+    /**
+     * Generate a refactoring suggestion based on the types of the duplicate blocks.
+     */
+    suggestRefactor(blocks) {
+        const types = new Set(blocks.map(b => b.type));
+        const files = new Set(blocks.map(b => b.file));
+        if (types.has('class')) {
+            return 'Extract a shared base class or compose common behaviour into a mixin/trait';
+        }
+        if (types.has('method')) {
+            if (files.size > 1) {
+                return 'Extract shared method logic into a utility module and import it where needed';
+            }
+            return 'Extract shared method logic into a private helper method within the same class';
+        }
+        if (types.has('function')) {
+            if (files.size > 1) {
+                return 'Extract shared logic into a utility function in a common module and import it where needed';
+            }
+            return 'Extract shared logic into a utility function within the same module';
+        }
+        // Generic block
+        if (files.size > 1) {
+            return 'Extract shared logic into a utility function in a shared module';
+        }
+        return 'Extract shared logic into a utility function to reduce duplication';
+    }
+    /**
+     * Walk a directory tree, returning full paths of source files.
+     */
+    walkDir(dir) {
+        const results = [];
+        try {
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.name.startsWith('.'))
+                    continue;
+                const fullPath = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    if (IGNORE_DIRS.has(entry.name))
+                        continue;
+                    results.push(...this.walkDir(fullPath));
+                }
+                else if (entry.isFile()) {
+                    const ext = path.extname(entry.name);
+                    if (SOURCE_EXTENSIONS.has(ext)) {
+                        results.push(fullPath);
+                    }
+                }
+            }
+        }
+        catch {
+            // permission or access error — skip
+        }
+        return results;
+    }
+    /**
+     * Produce a unique key for a block (file path + line range).
+     */
+    blockKey(block) {
+        return `${block.file}:${block.startLine}-${block.endLine}`;
+    }
+}
+//# sourceMappingURL=code-similarity.js.map

package/dist/brain/code-similarity.js.map

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

package/dist/brain/context-completion.d.ts

@@ -0,0 +1,39 @@
+import type { ProjectKnowledge, BrainInsight } from '../types.js';
+export declare class ContextCompletionEngine {
+    private projectDir;
+    constructor(projectDir: string);
+    /**
+     * Analyze the project directory to build a comprehensive ProjectKnowledge
+     * object containing name, conventions, architecture, patterns, and deps.
+     */
+    buildKnowledge(): Promise<ProjectKnowledge>;
+    /**
+     * Persist the knowledge object to `.shadow-brain/knowledge.json` inside
+     * the project directory.
+     */
+    saveKnowledge(knowledge: ProjectKnowledge): Promise<void>;
+    /**
+     * Identify missing project context items (README, .gitignore, tsconfig,
+     * CI/CD configs, etc.) and return them as prioritised BrainInsight array.
+     */
+    getContextGaps(knowledge: ProjectKnowledge): Promise<BrainInsight[]>;
+    private detectProjectName;
+    private detectConventions;
+    private summarizeEslint;
+    private summarizePrettier;
+    private summarizeEditorConfig;
+    private summarizeTsconfig;
+    private detectArchitecture;
+    private hasFileExtensionSync;
+    private detectPatterns;
+    private detectDependencies;
+    private parseCargoDeps;
+    private hasFile;
+    private hasFileExtension;
+    /**
+     * Recursively collect source files up to a limit.
+     * Skips node_modules, .git, dist, build, coverage, and hidden directories.
+     */
+    private collectSourceFiles;
+}
+//# sourceMappingURL=context-completion.d.ts.map

package/dist/brain/context-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-completion.d.ts","sourceRoot":"","sources":["../../src/brain/context-completion.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAuDlE,qBAAa,uBAAuB;IAClC,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAM9B;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAoBjD;;;OAGG;IACG,aAAa,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/D;;;OAGG;IACG,cAAc,CAAC,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAwM5D,iBAAiB;YAqBjB,iBAAiB;IA0E/B,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,qBAAqB;IAU7B,OAAO,CAAC,iBAAiB;YA6BX,kBAAkB;IA0GhC,OAAO,CAAC,oBAAoB;YAMd,cAAc;YAoId,kBAAkB;IAsChC,OAAO,CAAC,cAAc;YAyBR,OAAO;YAIP,gBAAgB;IA8B9B;;;OAGG;YACW,kBAAkB;CA8CjC"}