@theihtisham/agent-shadow-brain 1.2.0 → 3.0.0

package/dist/brain/code-age-analyzer.js.map

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

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/config-drift-detector.d.ts

@@ -0,0 +1,13 @@
+import { BrainInsight } from '../types.js';
+export declare class ConfigDriftDetector {
+    private projectDir;
+    constructor(projectDir: string);
+    analyzeProject(): Promise<BrainInsight[]>;
+    private detectMissingConfigs;
+    private detectTsconfigDrift;
+    private detectGitignoreDrift;
+    private detectPackageJsonDrift;
+    private detectEditorConfigDrift;
+    private driftToInsight;
+}
+//# sourceMappingURL=config-drift-detector.d.ts.map

package/dist/brain/config-drift-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-drift-detector.d.ts","sourceRoot":"","sources":["../../src/brain/config-drift-detector.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AA0BxD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAIxB,cAAc,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAqB/C,OAAO,CAAC,oBAAoB;IAsB5B,OAAO,CAAC,mBAAmB;IAkD3B,OAAO,CAAC,oBAAoB;IA+B5B,OAAO,CAAC,sBAAsB;IAgC9B,OAAO,CAAC,uBAAuB;IAmB/B,OAAO,CAAC,cAAc;CAkBvB"}

package/dist/brain/config-drift-detector.js

@@ -0,0 +1,198 @@
+// src/brain/config-drift-detector.ts — Configuration drift detection
+// v3.0.0 — Detects drift between expected and actual config across environments
+import * as fs from 'fs';
+import * as path from 'path';
+const TEMPLATES = [
+    { path: 'tsconfig.json', required: true },
+    { path: '.eslintrc.json', required: false },
+    { path: '.eslintrc.js', required: false },
+    { path: '.prettierrc', required: false },
+    { path: '.prettierrc.json', required: false },
+    { path: 'jest.config.js', required: false },
+    { path: 'jest.config.ts', required: false },
+    { path: '.gitignore', required: true },
+    { path: '.editorconfig', required: false },
+    { path: '.npmrc', required: false },
+    { path: '.nvmrc', required: false },
+    { path: 'docker-compose.yml', required: false },
+    { path: 'Dockerfile', required: false },
+];
+export class ConfigDriftDetector {
+    constructor(projectDir) {
+        this.projectDir = projectDir;
+    }
+    async analyzeProject() {
+        const drifts = [];
+        // Phase 1: Missing required config files
+        drifts.push(...this.detectMissingConfigs());
+        // Phase 2: tsconfig.json drift
+        drifts.push(...this.detectTsconfigDrift());
+        // Phase 3: .gitignore drift
+        drifts.push(...this.detectGitignoreDrift());
+        // Phase 4: package.json consistency
+        drifts.push(...this.detectPackageJsonDrift());
+        // Phase 5: Editor config consistency
+        drifts.push(...this.detectEditorConfigDrift());
+        return drifts.map(d => this.driftToInsight(d));
+    }
+    detectMissingConfigs() {
+        const drifts = [];
+        for (const template of TEMPLATES) {
+            const fullPath = path.join(this.projectDir, template.path);
+            const exists = fs.existsSync(fullPath);
+            if (template.required && !exists) {
+                drifts.push({
+                    file: template.path,
+                    expected: 'File should exist',
+                    actual: 'File is missing',
+                    severity: 'high',
+                    description: `Required config file ${template.path} is missing. This may cause inconsistent behavior across environments.`,
+                    autoFixable: true,
+                });
+            }
+        }
+        return drifts;
+    }
+    detectTsconfigDrift() {
+        const drifts = [];
+        const tsconfigPath = path.join(this.projectDir, 'tsconfig.json');
+        let tsconfig;
+        try {
+            tsconfig = JSON.parse(fs.readFileSync(tsconfigPath, 'utf-8'));
+        }
+        catch {
+            return drifts; // missing tsconfig handled above
+        }
+        const compilerOptions = (tsconfig.compilerOptions || {});
+        // Check for recommended settings
+        const recommended = {
+            'strict': { value: true, reason: 'Strict mode catches many common bugs' },
+            'esModuleInterop': { value: true, reason: 'Enables proper interop between CJS and ESM' },
+            'skipLibCheck': { value: true, reason: 'Speeds up compilation by skipping type checking of .d.ts files' },
+            'forceConsistentCasingInFileNames': { value: true, reason: 'Ensures consistent file references across OS' },
+            'resolveJsonModule': { value: true, reason: 'Allows importing JSON files' },
+            'declaration': { value: true, reason: 'Generates .d.ts files for library consumers' },
+            'declarationMap': { value: true, reason: 'Enables source maps for declarations' },
+            'sourceMap': { value: true, reason: 'Enables debugging with source maps' },
+        };
+        for (const [key, { value, reason }] of Object.entries(recommended)) {
+            if (compilerOptions[key] === undefined) {
+                drifts.push({
+                    file: 'tsconfig.json',
+                    expected: `compilerOptions.${key}: ${JSON.stringify(value)}`,
+                    actual: `${key} is not set`,
+                    severity: 'medium',
+                    description: `Missing recommended tsconfig option: ${key}. ${reason}.`,
+                    autoFixable: true,
+                });
+            }
+            else if (compilerOptions[key] !== value) {
+                drifts.push({
+                    file: 'tsconfig.json',
+                    expected: `compilerOptions.${key}: ${JSON.stringify(value)}`,
+                    actual: `compilerOptions.${key}: ${JSON.stringify(compilerOptions[key])}`,
+                    severity: 'low',
+                    description: `tsconfig option ${key} is ${JSON.stringify(compilerOptions[key])}, recommended: ${JSON.stringify(value)}. ${reason}.`,
+                    autoFixable: true,
+                });
+            }
+        }
+        return drifts;
+    }
+    detectGitignoreDrift() {
+        const drifts = [];
+        const gitignorePath = path.join(this.projectDir, '.gitignore');
+        let content;
+        try {
+            content = fs.readFileSync(gitignorePath, 'utf-8');
+        }
+        catch {
+            return drifts;
+        }
+        const entries = new Set(content.split('\n').map(l => l.trim()).filter(l => l && !l.startsWith('#')));
+        // Recommended gitignore entries
+        const recommended = [
+            'node_modules', 'dist', 'build', '.env', '.env.local',
+            '*.log', 'coverage', '.DS_Store', 'thumbs.db',
+        ];
+        for (const entry of recommended) {
+            if (!entries.has(entry) && !entries.has(entry.replace('*', ''))) {
+                drifts.push({
+                    file: '.gitignore',
+                    expected: `${entry} should be ignored`,
+                    actual: `${entry} is not in .gitignore`,
+                    severity: entry === '.env' || entry === '.env.local' ? 'high' : 'medium',
+                    description: `${entry} is missing from .gitignore. This may result in committing sensitive or generated files.`,
+                    autoFixable: true,
+                });
+            }
+        }
+        return drifts;
+    }
+    detectPackageJsonDrift() {
+        const drifts = [];
+        const pkgPath = path.join(this.projectDir, 'package.json');
+        let pkg;
+        try {
+            pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        }
+        catch {
+            return drifts;
+        }
+        // Check for missing recommended fields
+        const recommendedFields = {
+            'license': { expected: 'MIT or appropriate license', reason: 'Required for npm publishing and legal clarity' },
+            'repository': { expected: '{ type: "git", url: "..." }', reason: 'Helps users find the source code' },
+            'description': { expected: 'Short project description', reason: 'Improves discoverability on npm' },
+            'keywords': { expected: 'Array of keywords', reason: 'Improves npm search results' },
+            'engines': { expected: '{ node: ">=18" }', reason: 'Specifies compatible Node.js versions' },
+        };
+        for (const [field, { expected, reason }] of Object.entries(recommendedFields)) {
+            if (!pkg[field]) {
+                drifts.push({
+                    file: 'package.json',
+                    expected: `${field}: ${expected}`,
+                    actual: `${field} is missing`,
+                    severity: 'low',
+                    description: `Missing package.json field: ${field}. ${reason}.`,
+                    autoFixable: true,
+                });
+            }
+        }
+        return drifts;
+    }
+    detectEditorConfigDrift() {
+        const drifts = [];
+        const editorConfigPath = path.join(this.projectDir, '.editorconfig');
+        if (!fs.existsSync(editorConfigPath)) {
+            // Not critical, but worth noting
+            drifts.push({
+                file: '.editorconfig',
+                expected: 'Editor config file for consistent formatting',
+                actual: 'No .editorconfig file found',
+                severity: 'low',
+                description: 'Missing .editorconfig. Team members may use different editor settings (indentation, line endings, etc.).',
+                autoFixable: true,
+            });
+        }
+        return drifts;
+    }
+    driftToInsight(drift) {
+        return {
+            type: 'config-drift',
+            priority: drift.severity === 'high' ? 'high' : drift.severity === 'medium' ? 'medium' : 'low',
+            title: `[config-drift] ${drift.file}: ${drift.description.slice(0, 60)}`,
+            content: `Configuration drift in ${drift.file}\n` +
+                `  Expected: ${drift.expected}\n` +
+                `  Actual: ${drift.actual}\n` +
+                `  Severity: ${drift.severity}\n` +
+                `  ${drift.autoFixable ? 'This can be auto-fixed.' : 'Manual review required.'}\n` +
+                `  Description: ${drift.description}`,
+            files: [drift.file],
+            timestamp: new Date(),
+            confidence: 0.9,
+            metadata: { autoFixable: drift.autoFixable, severity: drift.severity },
+        };
+    }
+}
+//# sourceMappingURL=config-drift-detector.js.map

package/dist/brain/config-drift-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-drift-detector.js","sourceRoot":"","sources":["../../src/brain/config-drift-detector.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,gFAAgF;AAGhF,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAQ7B,MAAM,SAAS,GAAiB;IAC9B,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE;IACzC,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC3C,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE;IACzC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE;IACxC,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC7C,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC3C,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC3C,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE;IACtC,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC1C,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;IACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;IACnC,EAAE,IAAI,EAAE,oBAAoB,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC/C,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE;CACxC,CAAC;AAEF,MAAM,OAAO,mBAAmB;IAG9B,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,MAAM,GAAkB,EAAE,CAAC;QAEjC,yCAAyC;QACzC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;QAE5C,+BAA+B;QAC/B,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAE3C,4BAA4B;QAC5B,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;QAE5C,oCAAoC;QACpC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC;QAE9C,qCAAqC;QACrC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAAC;QAE/C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAEO,oBAAoB;QAC1B,MAAM,MAAM,GAAkB,EAAE,CAAC;QAEjC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAEvC,IAAI,QAAQ,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,QAAQ,EAAE,mBAAmB;oBAC7B,MAAM,EAAE,iBAAiB;oBACzB,QAAQ,EAAE,MAAM;oBAChB,WAAW,EAAE,wBAAwB,QAAQ,CAAC,IAAI,wEAAwE;oBAC1H,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,mBAAmB;QACzB,MAAM,MAAM,GAAkB,EAAE,CAAC;QACjC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QAEjE,IAAI,QAAiC,CAAC;QACtC,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,CAAC,iCAAiC;QAClD,CAAC;QAED,MAAM,eAAe,GAAG,CAAC,QAAQ,CAAC,eAAe,IAAI,EAAE,CAA4B,CAAC;QAEpF,iCAAiC;QACjC,MAAM,WAAW,GAAuD;YACtE,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,sCAAsC,EAAE;YACzE,iBAAiB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,4CAA4C,EAAE;YACxF,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,gEAAgE,EAAE;YACzG,kCAAkC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,8CAA8C,EAAE;YAC3G,mBAAmB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,6BAA6B,EAAE;YAC3E,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,6CAA6C,EAAE;YACrF,gBAAgB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,sCAAsC,EAAE;YACjF,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,oCAAoC,EAAE;SAC3E,CAAC;QAEF,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACnE,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBACvC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,eAAe;oBACrB,QAAQ,EAAE,mBAAmB,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;oBAC5D,MAAM,EAAE,GAAG,GAAG,aAAa;oBAC3B,QAAQ,EAAE,QAAQ;oBAClB,WAAW,EAAE,wCAAwC,GAAG,KAAK,MAAM,GAAG;oBACtE,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC1C,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,eAAe;oBACrB,QAAQ,EAAE,mBAAmB,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;oBAC5D,MAAM,EAAE,mBAAmB,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE;oBACzE,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,mBAAmB,GAAG,OAAO,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,MAAM,GAAG;oBACnI,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,oBAAoB;QAC1B,MAAM,MAAM,GAAkB,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAE/D,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,MAAM,CAAC;QAAC,CAAC;QAEnF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAErG,gCAAgC;QAChC,MAAM,WAAW,GAAG;YAClB,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY;YACrD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW;SAC9C,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;gBAChE,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,YAAY;oBAClB,QAAQ,EAAE,GAAG,KAAK,oBAAoB;oBACtC,MAAM,EAAE,GAAG,KAAK,uBAAuB;oBACvC,QAAQ,EAAE,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;oBACxE,WAAW,EAAE,GAAG,KAAK,0FAA0F;oBAC/G,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,sBAAsB;QAC5B,MAAM,MAAM,GAAkB,EAAE,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAE3D,IAAI,GAA4B,CAAC;QACjC,IAAI,CAAC;YAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,MAAM,CAAC;QAAC,CAAC;QAErF,uCAAuC;QACvC,MAAM,iBAAiB,GAAyD;YAC9E,SAAS,EAAE,EAAE,QAAQ,EAAE,4BAA4B,EAAE,MAAM,EAAE,+CAA+C,EAAE;YAC9G,YAAY,EAAE,EAAE,QAAQ,EAAE,6BAA6B,EAAE,MAAM,EAAE,kCAAkC,EAAE;YACrG,aAAa,EAAE,EAAE,QAAQ,EAAE,2BAA2B,EAAE,MAAM,EAAE,iCAAiC,EAAE;YACnG,UAAU,EAAE,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,EAAE,6BAA6B,EAAE;YACpF,SAAS,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,uCAAuC,EAAE;SAC7F,CAAC;QAEF,KAAK,MAAM,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC9E,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,cAAc;oBACpB,QAAQ,EAAE,GAAG,KAAK,KAAK,QAAQ,EAAE;oBACjC,MAAM,EAAE,GAAG,KAAK,aAAa;oBAC7B,QAAQ,EAAE,KAAK;oBACf,WAAW,EAAE,+BAA+B,KAAK,KAAK,MAAM,GAAG;oBAC/D,WAAW,EAAE,IAAI;iBAClB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,uBAAuB;QAC7B,MAAM,MAAM,GAAkB,EAAE,CAAC;QACjC,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QAErE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrC,iCAAiC;YACjC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,eAAe;gBACrB,QAAQ,EAAE,8CAA8C;gBACxD,MAAM,EAAE,6BAA6B;gBACrC,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,0GAA0G;gBACvH,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,cAAc,CAAC,KAAkB;QACvC,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;YAC7F,KAAK,EAAE,kBAAkB,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;YACxE,OAAO,EACL,0BAA0B,KAAK,CAAC,IAAI,IAAI;gBACxC,eAAe,KAAK,CAAC,QAAQ,IAAI;gBACjC,aAAa,KAAK,CAAC,MAAM,IAAI;gBAC7B,eAAe,KAAK,CAAC,QAAQ,IAAI;gBACjC,KAAK,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,yBAAyB,IAAI;gBAClF,kBAAkB,KAAK,CAAC,WAAW,EAAE;YACvC,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;YACnB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,UAAU,EAAE,GAAG;YACf,QAAQ,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;SACvE,CAAC;IACJ,CAAC;CACF"}

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