@theihtisham/agent-shadow-brain 1.2.0 → 2.1.0

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"}