@theihtisham/agent-shadow-brain 2.1.0 → 4.0.0

package/dist/brain/adversarial-defense.js

@@ -0,0 +1,303 @@
+// src/brain/adversarial-defense.ts — Hallucination & Threat Guard
+// Detects hallucinations, contradictions, and prompt injection in LLM outputs.
+// Ensemble verification for critical insights.
+// v4.0.0 — Hyper-Intelligence Edition
+import * as fs from 'fs';
+import * as path from 'path';
+const DEFENSE_DIR = path.join(process.env.HOME || process.env.USERPROFILE || '~', '.shadow-brain', 'defense');
+const LOG_FILE = 'adversarial-log.json';
+/**
+ * Adversarial Defense — the immune system of the brain.
+ *
+ * Hallucination Detection:
+ *   Cross-reference LLM claims against actual file content.
+ *   "function X exists in file Y" → verify with file reads.
+ *   Contradiction detection: compare against stored knowledge.
+ *
+ * Ensemble Verification:
+ *   Critical insights → send to 2+ models → majority vote.
+ *   Split verdict → flag for human review.
+ *
+ * Injection Detection:
+ *   Scan for prompt injection patterns in agent inputs.
+ *   Block and log ThreatVector when detected.
+ *   Rate limit: max 3 injections per session before alert.
+ */
+export class AdversarialDefense {
+    constructor() {
+        this.log = {
+            timestamp: new Date(),
+            flagged: 0,
+            blocked: 0,
+            accuracy: 1.0,
+            totalChecked: 0,
+            falsePositives: 0,
+        };
+        this.injectionCount = 0;
+        this.MAX_INJECTIONS_PER_SESSION = 3;
+        this.loadFromDisk();
+    }
+    // ── Hallucination Detection ─────────────────────────────────────────────────
+    /**
+     * Verify an insight against actual project state.
+     * Cross-references claims with file content.
+     */
+    async verifyInsight(insight, projectDir) {
+        this.log.totalChecked++;
+        const contradictions = [];
+        const evidence = [];
+        let verifiedCount = 0;
+        let totalClaims = 0;
+        // Check file references in the insight
+        if (insight.files && insight.files.length > 0) {
+            for (const fileRef of insight.files) {
+                totalClaims++;
+                const fullPath = path.join(projectDir, fileRef);
+                if (fs.existsSync(fullPath)) {
+                    verifiedCount++;
+                    evidence.push(`File exists: ${fileRef}`);
+                    // If insight mentions specific content, verify it
+                    if (insight.content) {
+                        try {
+                            const fileContent = fs.readFileSync(fullPath, 'utf-8').toLowerCase();
+                            const contentLower = insight.content.toLowerCase();
+                            // Extract quoted strings from insight (potential claims about file content)
+                            const quotedMatches = contentLower.match(/["'`]([^"'`]{3,50})["'`]/g) || [];
+                            for (const match of quotedMatches) {
+                                const claim = match.replace(/["'`]/g, '');
+                                if (claim.length > 5 && !fileContent.includes(claim)) {
+                                    contradictions.push(`Claim "${claim}" not found in ${fileRef}`);
+                                }
+                            }
+                        }
+                        catch {
+                            // Cannot verify content
+                        }
+                    }
+                }
+                else {
+                    contradictions.push(`Referenced file does not exist: ${fileRef}`);
+                }
+            }
+        }
+        // Check confidence calibration
+        if (insight.confidence !== undefined) {
+            totalClaims++;
+            if (insight.confidence > 0.9 && contradictions.length > 0) {
+                contradictions.push(`High confidence (${insight.confidence}) but ${contradictions.length} unverified claims`);
+            }
+            else if (insight.confidence < 0.3) {
+                evidence.push('Low confidence claim — treated with appropriate uncertainty');
+                verifiedCount++;
+            }
+            else {
+                verifiedCount++;
+            }
+        }
+        // Calculate verification score
+        const confidence = totalClaims > 0 ? verifiedCount / totalClaims : 0.5;
+        const hasContradictions = contradictions.length > 0;
+        let verdict;
+        if (hasContradictions && confidence < 0.3) {
+            verdict = 'hallucinated';
+            this.log.flagged++;
+        }
+        else if (hasContradictions) {
+            verdict = 'uncertain';
+            this.log.flagged++;
+        }
+        else {
+            verdict = 'real';
+        }
+        // Update accuracy
+        this.log.accuracy = this.log.totalChecked > 0
+            ? (this.log.totalChecked - this.log.flagged) / this.log.totalChecked
+            : 1.0;
+        await this.saveToDisk();
+        return {
+            claim: insight.title,
+            confidence,
+            verified: verdict === 'real',
+            contradictions,
+            verdict,
+            evidence,
+            checkedAt: new Date(),
+        };
+    }
+    // ── Ensemble Verification ───────────────────────────────────────────────────
+    /**
+     * Send a question to multiple models and collect votes.
+     * Majority consensus required for acceptance.
+     */
+    ensembleVerify(question, modelAnswers) {
+        if (modelAnswers.length === 0) {
+            return {
+                question,
+                votes: [],
+                consensus: 'none',
+                agreedAnswer: '',
+                confidence: 0,
+            };
+        }
+        // Find majority answer (by similarity, not exact match)
+        const answerGroups = new Map();
+        for (const vote of modelAnswers) {
+            let matched = false;
+            for (const [key, group] of answerGroups) {
+                // Simple similarity: check if answers share key words
+                const similarity = this.textSimilarity(vote.answer, key);
+                if (similarity > 0.6) {
+                    group.push(vote);
+                    matched = true;
+                    break;
+                }
+            }
+            if (!matched) {
+                answerGroups.set(vote.answer, [vote]);
+            }
+        }
+        // Find largest group
+        let largestGroup = [];
+        for (const group of answerGroups.values()) {
+            if (group.length > largestGroup.length) {
+                largestGroup = group;
+            }
+        }
+        const totalVotes = modelAnswers.length;
+        const agreeingVotes = largestGroup.length;
+        const ratio = agreeingVotes / totalVotes;
+        let consensus;
+        if (ratio === 1)
+            consensus = 'unanimous';
+        else if (ratio > 0.5)
+            consensus = 'majority';
+        else if (ratio === 0.5)
+            consensus = 'split';
+        else
+            consensus = 'none';
+        const avgConfidence = largestGroup.reduce((s, v) => s + v.confidence, 0) / largestGroup.length;
+        return {
+            question,
+            votes: modelAnswers,
+            consensus,
+            agreedAnswer: largestGroup[0]?.answer ?? '',
+            confidence: avgConfidence,
+        };
+    }
+    // ── Injection Detection ─────────────────────────────────────────────────────
+    /**
+     * Scan input for prompt injection patterns.
+     * Returns ThreatVector if detected, null otherwise.
+     */
+    scanForInjection(input) {
+        for (const { pattern, type, severity } of AdversarialDefense.INJECTION_PATTERNS) {
+            if (pattern.test(input)) {
+                return {
+                    type,
+                    severity,
+                    blocked: true,
+                    source: 'input-scan',
+                    pattern: pattern.source,
+                    timestamp: new Date(),
+                };
+            }
+        }
+        // Check for encoded injection attempts
+        const decodedInput = this.decodeCommonEncodings(input);
+        if (decodedInput !== input) {
+            for (const { pattern, type, severity } of AdversarialDefense.INJECTION_PATTERNS) {
+                if (pattern.test(decodedInput)) {
+                    return {
+                        type,
+                        severity,
+                        blocked: true,
+                        source: 'encoded-injection',
+                        pattern: `encoded:${pattern.source}`,
+                        timestamp: new Date(),
+                    };
+                }
+            }
+        }
+        return null;
+    }
+    /** Block and log a detected threat */
+    blockAndLog(threat) {
+        this.injectionCount++;
+        this.log.blocked++;
+        if (this.injectionCount >= this.MAX_INJECTIONS_PER_SESSION) {
+            threat.severity = 'critical';
+        }
+        this.saveToDisk();
+    }
+    /** Get defense statistics */
+    getDefenseStats() {
+        return { ...this.log, timestamp: new Date() };
+    }
+    /** Get injection count for current session */
+    getSessionInjectionCount() {
+        return this.injectionCount;
+    }
+    // ── Utility ─────────────────────────────────────────────────────────────────
+    /** Simple text similarity based on shared words */
+    textSimilarity(a, b) {
+        const wordsA = new Set(a.toLowerCase().split(/\s+/));
+        const wordsB = new Set(b.toLowerCase().split(/\s+/));
+        const intersection = new Set([...wordsA].filter(w => wordsB.has(w)));
+        const union = new Set([...wordsA, ...wordsB]);
+        return union.size > 0 ? intersection.size / union.size : 0;
+    }
+    /** Attempt to decode common encoding schemes */
+    decodeCommonEncodings(input) {
+        try {
+            // Base64
+            if (/^[A-Za-z0-9+/]+=*$/.test(input) && input.length > 20) {
+                return Buffer.from(input, 'base64').toString('utf-8');
+            }
+        }
+        catch { /* not base64 */ }
+        try {
+            // URL encoding
+            if (input.includes('%')) {
+                return decodeURIComponent(input);
+            }
+        }
+        catch { /* not URL encoded */ }
+        return input;
+    }
+    // ── Persistence ─────────────────────────────────────────────────────────────
+    async saveToDisk() {
+        try {
+            if (!fs.existsSync(DEFENSE_DIR)) {
+                fs.mkdirSync(DEFENSE_DIR, { recursive: true });
+            }
+            fs.writeFileSync(path.join(DEFENSE_DIR, LOG_FILE), JSON.stringify(this.log));
+        }
+        catch { /* non-blocking */ }
+    }
+    loadFromDisk() {
+        try {
+            const logFile = path.join(DEFENSE_DIR, LOG_FILE);
+            if (!fs.existsSync(logFile))
+                return;
+            const data = JSON.parse(fs.readFileSync(logFile, 'utf-8'));
+            this.log = { ...this.log, ...data, timestamp: new Date(data.timestamp) };
+        }
+        catch { /* fresh start */ }
+    }
+}
+// Common prompt injection patterns
+AdversarialDefense.INJECTION_PATTERNS = [
+    { pattern: /ignore\s+(all\s+)?previous\s+instructions/i, type: 'prompt-injection', severity: 'critical' },
+    { pattern: /forget\s+(your|all)\s+rules/i, type: 'prompt-injection', severity: 'critical' },
+    { pattern: /pretend\s+you\s+are/i, type: 'prompt-injection', severity: 'high' },
+    { pattern: /you\s+are\s+now\s+a/i, type: 'prompt-injection', severity: 'high' },
+    { pattern: /disregard\s+(your|all)\s+(training|instructions)/i, type: 'prompt-injection', severity: 'critical' },
+    { pattern: /override\s+safety/i, type: 'prompt-injection', severity: 'critical' },
+    { pattern: /system\s*:\s*/i, type: 'prompt-injection', severity: 'high' },
+    { pattern: /<\|im_start\|>/i, type: 'prompt-injection', severity: 'high' },
+    { pattern: /jailbreak/i, type: 'prompt-injection', severity: 'medium' },
+    { pattern: /DAN\s+mode/i, type: 'prompt-injection', severity: 'high' },
+    { pattern: /bypass\s+(all\s+)?filters/i, type: 'prompt-injection', severity: 'critical' },
+    { pattern: /extract\s+(the\s+)?(prompt|system|instructions)/i, type: 'data-poisoning', severity: 'high' },
+];
+//# sourceMappingURL=adversarial-defense.js.map

package/dist/brain/adversarial-defense.js.map

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

package/dist/brain/api-contract-analyzer.d.ts

@@ -0,0 +1,19 @@
+import { BrainInsight } from '../types.js';
+export declare class APIContractAnalyzer {
+    private projectDir;
+    constructor(projectDir: string);
+    analyzeProject(maxFiles?: number): Promise<BrainInsight[]>;
+    private discoverEndpoints;
+    private extractEndpoints;
+    private auditEndpoint;
+    private checkValidation;
+    private checkAuth;
+    private checkRateLimit;
+    private checkDocs;
+    private checkTests;
+    private extractStatusCodes;
+    private getBlock;
+    private endpointToInsight;
+    private collectFiles;
+}
+//# sourceMappingURL=api-contract-analyzer.d.ts.map

package/dist/brain/api-contract-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-contract-analyzer.d.ts","sourceRoot":"","sources":["../../src/brain/api-contract-analyzer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAe,MAAM,aAAa,CAAC;AAQxD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAIxB,cAAc,CAAC,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAwCrE,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,gBAAgB;IAiFxB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,YAAY;CAqBrB"}

package/dist/brain/api-contract-analyzer.js

@@ -0,0 +1,251 @@
+// src/brain/api-contract-analyzer.ts — API endpoint contract analysis
+// v3.0.0 — Detects API endpoints, checks for validation, auth, rate limiting, docs, tests
+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',
+]);
+export class APIContractAnalyzer {
+    constructor(projectDir) {
+        this.projectDir = projectDir;
+    }
+    async analyzeProject(maxFiles = 200) {
+        const endpoints = this.discoverEndpoints(maxFiles);
+        const insights = [];
+        for (const ep of endpoints) {
+            const issues = this.auditEndpoint(ep);
+            if (issues.length > 0) {
+                insights.push(this.endpointToInsight(ep, issues));
+            }
+        }
+        // Summary insight
+        if (endpoints.length > 0) {
+            const noAuth = endpoints.filter(e => !e.hasAuth).length;
+            const noValidation = endpoints.filter(e => !e.hasValidation).length;
+            const noDocs = endpoints.filter(e => !e.hasDocs).length;
+            if (noAuth > 0 || noValidation > 0) {
+                insights.push({
+                    type: 'api-contract',
+                    priority: noAuth > endpoints.length * 0.5 ? 'critical' : 'high',
+                    title: `[api-contract] API audit: ${endpoints.length} endpoints found (${noAuth} without auth, ${noValidation} without validation)`,
+                    content: `API Contract Audit Summary:\n` +
+                        `  Total endpoints: ${endpoints.length}\n` +
+                        `  Without authentication: ${noAuth}\n` +
+                        `  Without input validation: ${noValidation}\n` +
+                        `  Without documentation: ${noDocs}\n` +
+                        `  Ensure all endpoints have proper auth, validation, and documentation.`,
+                    files: endpoints.map(e => e.file).filter((v, i, a) => a.indexOf(v) === i).slice(0, 10),
+                    timestamp: new Date(),
+                    confidence: 0.85,
+                    metadata: { totalEndpoints: endpoints.length, noAuth, noValidation, noDocs },
+                });
+            }
+        }
+        return insights;
+    }
+    discoverEndpoints(maxFiles) {
+        const endpoints = [];
+        const files = this.collectFiles(this.projectDir, maxFiles);
+        for (const filePath of files) {
+            let content;
+            try {
+                content = fs.readFileSync(filePath, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const relPath = path.relative(this.projectDir, filePath);
+            endpoints.push(...this.extractEndpoints(content, relPath));
+        }
+        return endpoints;
+    }
+    extractEndpoints(content, filePath) {
+        const endpoints = [];
+        const lines = content.split('\n');
+        // Express.js patterns
+        const expressPattern = /\.(get|post|put|patch|delete)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
+        let match;
+        while ((match = expressPattern.exec(content)) !== null) {
+            const method = match[1].toUpperCase();
+            const routePath = match[2];
+            const line = content.substring(0, match.index).split('\n').length;
+            const block = this.getBlock(lines, line - 1);
+            endpoints.push({
+                path: routePath,
+                method,
+                file: filePath,
+                line,
+                hasValidation: this.checkValidation(block),
+                hasAuth: this.checkAuth(block, content),
+                hasRateLimit: this.checkRateLimit(content),
+                hasDocs: this.checkDocs(content, line),
+                hasTests: this.checkTests(filePath, routePath),
+                statusCode: this.extractStatusCodes(block),
+                issues: [],
+            });
+        }
+        // Next.js API route pattern (files in pages/api or app/api)
+        if (filePath.includes('/api/') || filePath.includes('\\api\\')) {
+            // Infer route from file path
+            const apiPath = filePath
+                .replace(/^(.*?[/\\])api([/\\])/, '/api/')
+                .replace(/\.(ts|tsx|js|jsx)$/, '')
+                .replace(/\/index$/, '')
+                .replace(/\[([^\]]+)\]/g, ':$1');
+            if (!endpoints.some(e => e.file === filePath)) {
+                const content2 = content;
+                endpoints.push({
+                    path: apiPath || '/api/unknown',
+                    method: 'GET', // default, could be POST etc.
+                    file: filePath,
+                    line: 1,
+                    hasValidation: this.checkValidation(content2),
+                    hasAuth: this.checkAuth(content2, content),
+                    hasRateLimit: this.checkRateLimit(content),
+                    hasDocs: this.checkDocs(content, 1),
+                    hasTests: this.checkTests(filePath, apiPath),
+                    statusCode: this.extractStatusCodes(content2),
+                    issues: [],
+                });
+            }
+        }
+        // Fastify pattern
+        const fastifyPattern = /\.(get|post|put|patch|delete)\s*\(\s*\{\s*url\s*:\s*['"`]([^'"`]+)['"`]/gi;
+        while ((match = fastifyPattern.exec(content)) !== null) {
+            const method = match[1].toUpperCase();
+            const routePath = match[2];
+            const line = content.substring(0, match.index).split('\n').length;
+            const block = this.getBlock(lines, line - 1);
+            endpoints.push({
+                path: routePath,
+                method,
+                file: filePath,
+                line,
+                hasValidation: this.checkValidation(block),
+                hasAuth: this.checkAuth(block, content),
+                hasRateLimit: this.checkRateLimit(content),
+                hasDocs: this.checkDocs(content, line),
+                hasTests: this.checkTests(filePath, routePath),
+                statusCode: this.extractStatusCodes(block),
+                issues: [],
+            });
+        }
+        return endpoints;
+    }
+    auditEndpoint(ep) {
+        const issues = [];
+        if (!ep.hasAuth && !ep.path.includes('public') && !ep.path.includes('health')) {
+            issues.push('No authentication detected');
+        }
+        if (!ep.hasValidation && ['POST', 'PUT', 'PATCH'].includes(ep.method)) {
+            issues.push('No input validation for write endpoint');
+        }
+        if (!ep.hasDocs) {
+            issues.push('No API documentation found');
+        }
+        if (ep.statusCode.length === 0) {
+            issues.push('No explicit status codes returned');
+        }
+        return issues;
+    }
+    checkValidation(block) {
+        return /\b(validate|schema|joi|zod|yup|ajv|validator|check|sanitize|parse)\b/i.test(block);
+    }
+    checkAuth(block, fullContent) {
+        return /\b(auth|jwt|token|session|passport|bearer|apikey|api[_-]?key|middleware)\b/i.test(block) ||
+            /\b(auth|authenticate|authorize|verifyToken|isAuthenticated)\b/i.test(fullContent.substring(0, fullContent.indexOf(block) + block.length));
+    }
+    checkRateLimit(content) {
+        return /\b(rate[_-]?limit|rateLimit|throttle|slow[_-]?down|slowDown)\b/i.test(content);
+    }
+    checkDocs(content, line) {
+        // Check for JSDoc, OpenAPI/Swagger, or comment above the route
+        const lines = content.split('\n');
+        for (let i = Math.max(0, line - 5); i < line - 1; i++) {
+            if (/\/\*\*|@route|@api|swagger|openapi/i.test(lines[i]))
+                return true;
+        }
+        return false;
+    }
+    checkTests(filePath, routePath) {
+        // Heuristic: check if a test file exists for this route handler
+        const testPatterns = [
+            filePath.replace(/\.(ts|tsx|js|jsx)$/, '.test.$1'),
+            filePath.replace(/\.(ts|tsx|js|jsx)$/, '.spec.$1'),
+            filePath.replace(/\/src\//, '/tests/').replace(/\.(ts|tsx|js|jsx)$/, '.test.ts'),
+        ];
+        for (const p of testPatterns) {
+            try {
+                fs.accessSync(p);
+                return true;
+            }
+            catch { /* continue */ }
+        }
+        return false;
+    }
+    extractStatusCodes(block) {
+        const codes = [];
+        const statusPattern = /status\s*\(\s*(\d{3})\s*\)|statusCode\s*=\s*(\d{3})|\.send\s*\(\s*\{[^}]*status\s*:\s*(\d{3})/g;
+        let m;
+        while ((m = statusPattern.exec(block)) !== null) {
+            const code = parseInt(m[1] || m[2] || m[3]);
+            if (code >= 100 && code < 600)
+                codes.push(code);
+        }
+        return [...new Set(codes)];
+    }
+    getBlock(lines, startLine) {
+        // Get ~20 lines around the endpoint definition
+        const start = Math.max(0, startLine - 2);
+        const end = Math.min(lines.length, startLine + 20);
+        return lines.slice(start, end).join('\n');
+    }
+    endpointToInsight(ep, issues) {
+        return {
+            type: 'api-contract',
+            priority: issues.some(i => i.includes('authentication')) ? 'critical' :
+                issues.some(i => i.includes('validation')) ? 'high' : 'medium',
+            title: `[api-contract] ${ep.method} ${ep.path} — ${issues.length} issues`,
+            content: `API endpoint ${ep.method} ${ep.path} in ${ep.file}:${ep.line}\n` +
+                `  Issues:\n${issues.map(i => `    - ${i}`).join('\n')}\n` +
+                `  Auth: ${ep.hasAuth ? 'yes' : 'NO'} | Validation: ${ep.hasValidation ? 'yes' : 'NO'} | Docs: ${ep.hasDocs ? 'yes' : 'NO'} | Tests: ${ep.hasTests ? 'yes' : 'NO'}\n` +
+                `  Status codes: ${ep.statusCode.length > 0 ? ep.statusCode.join(', ') : 'none detected'}`,
+            files: [ep.file],
+            timestamp: new Date(),
+            confidence: 0.8,
+            metadata: { method: ep.method, path: ep.path, issues },
+        };
+    }
+    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() && /\.(ts|tsx|js|jsx)$/.test(entry.name)) {
+                    results.push(fullPath);
+                }
+            }
+        };
+        walk(dir, 0);
+        return results;
+    }
+}
+//# sourceMappingURL=api-contract-analyzer.js.map

package/dist/brain/api-contract-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-contract-analyzer.js","sourceRoot":"","sources":["../../src/brain/api-contract-analyzer.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,0FAA0F;AAG1F,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ;CACvF,CAAC,CAAC;AAEH,MAAM,OAAO,mBAAmB;IAG9B,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,WAAmB,GAAG;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAmB,EAAE,CAAC;QAEpC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YACtC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YACxD,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC;YACpE,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YAExD,IAAI,MAAM,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;gBACnC,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,cAAc;oBACpB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM;oBAC/D,KAAK,EAAE,6BAA6B,SAAS,CAAC,MAAM,qBAAqB,MAAM,kBAAkB,YAAY,sBAAsB;oBACnI,OAAO,EACL,+BAA+B;wBAC/B,sBAAsB,SAAS,CAAC,MAAM,IAAI;wBAC1C,6BAA6B,MAAM,IAAI;wBACvC,+BAA+B,YAAY,IAAI;wBAC/C,4BAA4B,MAAM,IAAI;wBACtC,yEAAyE;oBAC3E,KAAK,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;oBACtF,SAAS,EAAE,IAAI,IAAI,EAAE;oBACrB,UAAU,EAAE,IAAI;oBAChB,QAAQ,EAAE,EAAE,cAAc,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE;iBAC7E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,iBAAiB,CAAC,QAAgB;QACxC,MAAM,SAAS,GAAkB,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAE3D,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,OAAe,CAAC;YACpB,IAAI,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,SAAS;YAAC,CAAC;YAEzE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;YACzD,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,gBAAgB,CAAC,OAAe,EAAE,QAAgB;QACxD,MAAM,SAAS,GAAkB,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAElC,sBAAsB;QACtB,MAAM,cAAc,GAAG,4DAA4D,CAAC;QACpF,IAAI,KAA6B,CAAC;QAClC,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAA2B,CAAC;YAC/D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YAClE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;YAE7C,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,SAAS;gBACf,MAAM;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI;gBACJ,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;gBAC1C,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC;gBACvC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;gBAC1C,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC;gBACtC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC9C,UAAU,EAAE,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC;gBAC1C,MAAM,EAAE,EAAE;aACX,CAAC,CAAC;QACL,CAAC;QAED,4DAA4D;QAC5D,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/D,6BAA6B;YAC7B,MAAM,OAAO,GAAG,QAAQ;iBACrB,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;iBACzC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC;iBACjC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;iBACvB,OAAO,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;YAEnC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC;gBACzB,SAAS,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE,OAAO,IAAI,cAAc;oBAC/B,MAAM,EAAE,KAAK,EAAE,8BAA8B;oBAC7C,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC;oBACP,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;oBAC7C,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC;oBAC1C,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;oBAC1C,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;oBACnC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC;oBAC5C,UAAU,EAAE,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC;oBAC7C,MAAM,EAAE,EAAE;iBACX,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,kBAAkB;QAClB,MAAM,cAAc,GAAG,2EAA2E,CAAC;QACnG,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAA2B,CAAC;YAC/D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YAClE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;YAE7C,SAAS,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,SAAS;gBACf,MAAM;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI;gBACJ,aAAa,EAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC;gBAC1C,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC;gBACvC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;gBAC1C,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC;gBACtC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;gBAC9C,UAAU,EAAE,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC;gBAC1C,MAAM,EAAE,EAAE;aACX,CAAC,CAAC;QACL,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,aAAa,CAAC,EAAe;QACnC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,EAAE,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9E,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,aAAa,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC;YACtE,MAAM,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACnD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,eAAe,CAAC,KAAa;QACnC,OAAO,uEAAuE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7F,CAAC;IAEO,SAAS,CAAC,KAAa,EAAE,WAAmB;QAClD,OAAO,6EAA6E,CAAC,IAAI,CAAC,KAAK,CAAC;YAC9F,gEAAgE,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/I,CAAC;IAEO,cAAc,CAAC,OAAe;QACpC,OAAO,iEAAiE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzF,CAAC;IAEO,SAAS,CAAC,OAAe,EAAE,IAAY;QAC7C,+DAA+D;QAC/D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACtD,IAAI,qCAAqC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QACxE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,UAAU,CAAC,QAAgB,EAAE,SAAiB;QACpD,gEAAgE;QAChE,MAAM,YAAY,GAAG;YACnB,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,UAAU,CAAC;YAClD,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,UAAU,CAAC;YAClD,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,UAAU,CAAC;SACjF,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,IAAI,CAAC;gBAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;gBAAC,OAAO,IAAI,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,kBAAkB,CAAC,KAAa;QACtC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,aAAa,GAAG,gGAAgG,CAAC;QACvH,IAAI,CAAyB,CAAC;QAC9B,OAAO,CAAC,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5C,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,GAAG,GAAG;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7B,CAAC;IAEO,QAAQ,CAAC,KAAe,EAAE,SAAiB;QACjD,+CAA+C;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,EAAE,CAAC,CAAC;QACnD,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAEO,iBAAiB,CAAC,EAAe,EAAE,MAAgB;QACzD,OAAO;YACL,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;gBACrE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;YAChE,KAAK,EAAE,kBAAkB,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,MAAM,MAAM,CAAC,MAAM,SAAS;YACzE,OAAO,EACL,gBAAgB,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,IAAI;gBACjE,cAAc,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBAC1D,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,kBAAkB,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,YAAY,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI;gBACrK,mBAAmB,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE;YAC5F,KAAK,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,UAAU,EAAE,GAAG;YACf,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE;SACvD,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,GAAW,EAAE,QAAgB;QAChD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,UAAkB,EAAE,KAAa,EAAQ,EAAE;YACvD,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ,IAAI,KAAK,GAAG,EAAE;gBAAE,OAAO;YACrD,IAAI,OAAoB,CAAC;YACzB,IAAI,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO;YAAC,CAAC;YACxF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,OAAO,CAAC,MAAM,IAAI,QAAQ;oBAAE,OAAO;gBACvC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;oBAAE,SAAS;gBACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACnD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;wBAAE,SAAS;oBAC1C,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;gBAC5B,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBACnE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACb,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/brain/ast-analyzer.d.ts

@@ -0,0 +1,23 @@
+import { BrainInsight, ASTFunctionInfo } from '../types.js';
+export declare class ASTAnalyzer {
+    private projectDir;
+    constructor(projectDir: string);
+    analyzeProject(maxFiles?: number): Promise<BrainInsight[]>;
+    extractFunctionInfo(filePath: string): ASTFunctionInfo[];
+    private extractJSFunctions;
+    private extractPythonFunctions;
+    private analyzeFunction;
+    private analyzeFileStructure;
+    private calculateCyclomaticComplexity;
+    private calculateCognitiveComplexity;
+    private calculateNestingDepth;
+    private countReturnPaths;
+    private assessPurity;
+    private findFunctionEnd;
+    private findPythonFunctionEnd;
+    private calculatePythonNesting;
+    private calculatePythonComplexity;
+    private calculatePythonCognitiveComplexity;
+    private collectFiles;
+}
+//# sourceMappingURL=ast-analyzer.d.ts.map

package/dist/brain/ast-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-analyzer.d.ts","sourceRoot":"","sources":["../../src/brain/ast-analyzer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAY5D,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAIxB,cAAc,CAAC,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAmBrE,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,EAAE;IAUxD,OAAO,CAAC,kBAAkB;IAiE1B,OAAO,CAAC,sBAAsB;IAyC9B,OAAO,CAAC,eAAe;IAsGvB,OAAO,CAAC,oBAAoB;IAsE5B,OAAO,CAAC,6BAA6B;IAerC,OAAO,CAAC,4BAA4B;IAiCpC,OAAO,CAAC,qBAAqB;IA+B7B,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,yBAAyB;IAUjC,OAAO,CAAC,kCAAkC;IAI1C,OAAO,CAAC,YAAY;CAqBrB"}