@theihtisham/agent-shadow-brain 3.0.0 → 4.0.0

package/dist/brain/cognitive-load.js

@@ -0,0 +1,304 @@
+// src/brain/cognitive-load.ts — Cognitive complexity analysis
+// v3.1.0 — Measures function cognitive complexity: nesting, boolean ops, control flow
+import * as fs from 'fs';
+import * as path from 'path';
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', 'dist', 'build', 'out', 'coverage', '.next', '.nuxt', '.cache',
+]);
+const CODE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx', '.py', '.rs', '.go', '.java']);
+export class CognitiveLoadAnalyzer {
+    constructor(projectDir) {
+        this.projectDir = projectDir;
+    }
+    async analyzeProject(maxFiles = 300) {
+        const files = this.collectFiles(this.projectDir, maxFiles);
+        const insights = [];
+        const allFunctions = [];
+        for (const filePath of files) {
+            const functions = this.analyzeFile(filePath);
+            allFunctions.push(...functions);
+        }
+        // Sort by cognitive score descending
+        allFunctions.sort((a, b) => b.cognitiveScore - a.cognitiveScore);
+        // Generate insights for functions exceeding thresholds
+        for (const fn of allFunctions) {
+            if (fn.cognitiveScore > 15) {
+                insights.push(this.functionToInsight(fn));
+            }
+        }
+        // Summary insight for high-complexity hotspots
+        const highCount = allFunctions.filter(f => f.cognitiveScore > 25).length;
+        const mediumCount = allFunctions.filter(f => f.cognitiveScore > 15 && f.cognitiveScore <= 25).length;
+        const totalFunctions = allFunctions.length;
+        if ((highCount + mediumCount) > 0 && totalFunctions > 5) {
+            insights.push({
+                type: 'complexity',
+                priority: highCount > 5 ? 'high' : 'medium',
+                title: `[complexity] ${highCount + mediumCount} functions with high cognitive complexity`,
+                content: `Cognitive complexity analysis found ${highCount} high (>25) and ${mediumCount} medium (>15) complexity functions.\n` +
+                    `  Total functions analyzed: ${totalFunctions}\n` +
+                    `  High complexity makes code harder to understand, test, and maintain.\n` +
+                    `  Consider breaking complex functions into smaller, well-named helpers.\n` +
+                    `  Top offenders:\n` +
+                    allFunctions.slice(0, 5).map(f => `    - ${f.name} in ${f.file}:${f.startLine} (score: ${f.cognitiveScore})`).join('\n'),
+                files: allFunctions.filter(f => f.cognitiveScore > 15).map(f => f.file).slice(0, 20),
+                timestamp: new Date(),
+                confidence: 0.8,
+                metadata: {
+                    totalFunctions,
+                    highComplexityCount: highCount,
+                    mediumComplexityCount: mediumCount,
+                    avgComplexity: totalFunctions > 0
+                        ? Math.round(allFunctions.reduce((s, f) => s + f.cognitiveScore, 0) / totalFunctions * 10) / 10
+                        : 0,
+                },
+            });
+        }
+        return insights;
+    }
+    analyzeFile(filePath) {
+        let content;
+        try {
+            content = fs.readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            return [];
+        }
+        const relPath = path.relative(this.projectDir, filePath);
+        const ext = path.extname(filePath);
+        const functions = [];
+        // Extract function boundaries using regex
+        const functionPattern = this.getFunctionPattern(ext);
+        let match;
+        functionPattern.lastIndex = 0;
+        while ((match = functionPattern.exec(content)) !== null) {
+            const name = match[1] || match[2] || '<anonymous>';
+            const startLine = content.substring(0, match.index).split('\n').length;
+            // Find the function body by matching braces
+            const bodyResult = this.extractFunctionBody(content, match.index);
+            if (!bodyResult)
+                continue;
+            const { body, endIndex } = bodyResult;
+            const endLine = content.substring(0, endIndex).split('\n').length;
+            // Calculate cognitive complexity
+            const score = this.calculateCognitiveComplexity(body, name);
+            functions.push({
+                name,
+                file: relPath,
+                startLine,
+                endLine,
+                cognitiveScore: score.total,
+                nestingContributions: score.nesting,
+                booleanContributions: score.booleanOps,
+                controlFlowContributions: score.controlFlow,
+                recursionContributions: score.recursion,
+                linesOfCode: body.split('\n').length,
+            });
+        }
+        return functions;
+    }
+    getFunctionPattern(ext) {
+        if (ext === '.py') {
+            return /def\s+(\w+)\s*\(/g;
+        }
+        if (ext === '.rs') {
+            return /(?:fn|pub\s+fn)\s+(\w+)\s*[<(]/g;
+        }
+        if (ext === '.go') {
+            return /func\s+(?:\([^)]*\)\s+)?(\w+)\s*\(/g;
+        }
+        if (ext === '.java') {
+            return /(?:public|private|protected|static)\s+\w+(?:<[^>]+>)?\s+(\w+)\s*\(/g;
+        }
+        // TypeScript / JavaScript
+        return /(?:function\s+(\w+)|(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s+)?(?:\([^)]*\)|[^=])\s*=>)/g;
+    }
+    extractFunctionBody(content, startIndex) {
+        // Find the opening brace
+        let braceIndex = content.indexOf('{', startIndex);
+        if (braceIndex === -1)
+            return null;
+        // For arrow functions without braces, find the line end
+        const arrowMatch = content.substring(startIndex, braceIndex).match(/=>\s*[^{]/);
+        if (arrowMatch) {
+            // Arrow function with expression body (no braces)
+            const lineEnd = content.indexOf('\n', startIndex);
+            const body = content.substring(startIndex, lineEnd !== -1 ? lineEnd : content.length);
+            return { body, endIndex: lineEnd !== -1 ? lineEnd : content.length };
+        }
+        // Match braces to find the end of the function
+        let depth = 0;
+        let i = braceIndex;
+        while (i < content.length) {
+            if (content[i] === '{')
+                depth++;
+            else if (content[i] === '}') {
+                depth--;
+                if (depth === 0) {
+                    const body = content.substring(startIndex, i + 1);
+                    return { body, endIndex: i + 1 };
+                }
+            }
+            // Skip strings
+            if (content[i] === '"' || content[i] === "'" || content[i] === '`') {
+                i = this.skipString(content, i);
+                continue;
+            }
+            i++;
+        }
+        return null;
+    }
+    skipString(content, start) {
+        const quote = content[start];
+        let i = start + 1;
+        while (i < content.length) {
+            if (content[i] === '\\') {
+                i += 2;
+                continue;
+            }
+            if (content[i] === quote)
+                return i + 1;
+            if (quote !== '`' && content[i] === '\n')
+                return i;
+            i++;
+        }
+        return i;
+    }
+    calculateCognitiveComplexity(body, functionName) {
+        let nesting = 0;
+        let booleanOps = 0;
+        let controlFlow = 0;
+        let recursion = 0;
+        // Remove string literals and comments to avoid false positives
+        const cleaned = this.removeStringsAndComments(body);
+        const lines = cleaned.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (line === '' || line.startsWith('//') || line.startsWith('/*') || line.startsWith('*'))
+                continue;
+            // Nesting depth: count open braces minus close braces
+            const opens = (line.match(/\{/g) || []).length;
+            const closes = (line.match(/\}/g) || []).length;
+            const prevNesting = nesting;
+            // Count nesting contributions (only for lines that open blocks)
+            if (opens > closes) {
+                nesting += (opens - closes);
+            }
+            // Nesting complexity: +1 per nesting level for control flow
+            if (/\b(if|else|for|while|switch|try|catch|finally)\b/.test(line)) {
+                controlFlow += Math.max(0, nesting - 1);
+            }
+            // else / else if: +1 each
+            if (/\belse\s+(if\s*)?[\{(]/.test(line) || line === 'else {') {
+                controlFlow += 1;
+            }
+            // catch: +1
+            if (/\bcatch\s*\(/.test(line)) {
+                controlFlow += 1;
+            }
+            // break / continue in loops: +1
+            if (/\b(break|continue)\b/.test(line) && !line.startsWith('//')) {
+                controlFlow += 1;
+            }
+            // Boolean operators: && and || each +1
+            const andMatches = line.match(/&&/g);
+            const orMatches = line.match(/\|\|/g);
+            booleanOps += (andMatches ? andMatches.length : 0) + (orMatches ? orMatches.length : 0);
+            // Recursive calls: +2
+            const escapedName = functionName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            if (functionName !== '<anonymous>' && new RegExp(`\\b${escapedName}\\s*\\(`).test(line)) {
+                // Make sure it's not just the function declaration
+                if (!line.includes(`function ${functionName}`) && !line.includes(`${functionName} =`)) {
+                    recursion += 2;
+                }
+            }
+        }
+        return {
+            total: nesting + booleanOps + controlFlow + recursion,
+            nesting,
+            booleanOps,
+            controlFlow,
+            recursion,
+        };
+    }
+    removeStringsAndComments(code) {
+        // Remove single-line comments
+        let result = code.replace(/\/\/.*$/gm, '');
+        // Remove multi-line comments
+        result = result.replace(/\/\*[\s\S]*?\*\//g, '');
+        // Remove double-quoted strings
+        result = result.replace(/"(?:[^"\\]|\\.)*"/g, '""');
+        // Remove single-quoted strings
+        result = result.replace(/'(?:[^'\\]|\\.)*'/g, "''");
+        // Remove template literals
+        result = result.replace(/`(?:[^`\\]|\\.)*`/g, '``');
+        return result;
+    }
+    functionToInsight(fn) {
+        const priority = fn.cognitiveScore > 25 ? 'high' : 'medium';
+        const severity = fn.cognitiveScore > 25 ? 'HIGH' : 'MEDIUM';
+        return {
+            type: 'complexity',
+            priority,
+            title: `[complexity] ${severity} cognitive load in ${fn.name} (${fn.file}:${fn.startLine})`,
+            content: `Function \`${fn.name}\` in ${fn.file}:${fn.startLine}-${fn.endLine} has cognitive complexity of ${fn.cognitiveScore}.\n` +
+                `  Score breakdown:\n` +
+                `    - Nesting depth: ${fn.nestingContributions}\n` +
+                `    - Boolean operators: ${fn.booleanContributions}\n` +
+                `    - Control flow (else/catch/break): ${fn.controlFlowContributions}\n` +
+                `    - Recursion: ${fn.recursionContributions}\n` +
+                `  Lines of code: ${fn.linesOfCode}\n` +
+                `  Thresholds: medium >15, high >25\n` +
+                `  Suggestion: Break into smaller functions with single responsibilities. ` +
+                `Extract complex conditions into well-named variables.`,
+            files: [fn.file],
+            timestamp: new Date(),
+            confidence: 0.75,
+            metadata: {
+                functionName: fn.name,
+                cognitiveScore: fn.cognitiveScore,
+                startLine: fn.startLine,
+                endLine: fn.endLine,
+                linesOfCode: fn.linesOfCode,
+                breakdown: {
+                    nesting: fn.nestingContributions,
+                    booleanOps: fn.booleanContributions,
+                    controlFlow: fn.controlFlowContributions,
+                    recursion: fn.recursionContributions,
+                },
+            },
+        };
+    }
+    collectFiles(dir, maxFiles) {
+        const results = [];
+        const walk = (currentDir, depth) => {
+            if (results.length >= maxFiles || depth > 10)
+                return;
+            let entries;
+            try {
+                entries = fs.readdirSync(currentDir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                if (results.length >= maxFiles)
+                    return;
+                if (entry.name.startsWith('.'))
+                    continue;
+                const fullPath = path.join(currentDir, entry.name);
+                if (entry.isDirectory()) {
+                    if (IGNORE_DIRS.has(entry.name))
+                        continue;
+                    walk(fullPath, depth + 1);
+                }
+                else if (entry.isFile() && CODE_EXTENSIONS.has(path.extname(entry.name))) {
+                    results.push(fullPath);
+                }
+            }
+        };
+        walk(dir, 0);
+        return results;
+    }
+}
+//# sourceMappingURL=cognitive-load.js.map

package/dist/brain/cognitive-load.js.map

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

package/dist/brain/cross-agent-protocol.d.ts

@@ -0,0 +1,48 @@
+import { AgentTool, CAIPMessage, CAIPHandshake, CAIPChannel, AgentBoostPacket, CrossAgentBus } from '../types.js';
+/**
+ * Cross-Agent Intelligence Protocol — the hub that makes all coding agents talk to each other.
+ *
+ * Transport:
+ *   Primary: WebSocket on port 7344 (CAIP bus)
+ *   Fallback: Shared filesystem at ~/.shadow-brain-caip/ (polling every 2s)
+ *
+ * Protocol:
+ *   1. Handshake — each agent sends identity, version, capabilities
+ *   2. Channels — broadcast (all), pair (two agents), team (subset)
+ *   3. Boost Packet — high-value insight shared to all connected agents
+ *   4. Deduplication — message hash ring prevents infinite loops
+ */
+export declare class CrossAgentProtocol {
+    private wss;
+    private clients;
+    private bus;
+    private messageHashes;
+    private boostHandlers;
+    private filePollTimer;
+    private running;
+    constructor();
+    /** Start the CAIP WebSocket server + filesystem fallback */
+    start(): Promise<void>;
+    /** Stop the CAIP server */
+    stop(): Promise<void>;
+    /** Register an agent via handshake */
+    connect(handshake: CAIPHandshake): Promise<CAIPChannel>;
+    /** Broadcast a message to all connected agents */
+    broadcast(from: AgentTool, payload: unknown, priority?: CAIPMessage['priority']): Promise<void>;
+    /** Send a boost packet — high-value insights shared across agents */
+    sendBoostPacket(packet: AgentBoostPacket): Promise<void>;
+    /** Send targeted message to specific agent */
+    sendDirect(from: AgentTool, to: AgentTool, payload: unknown): Promise<void>;
+    /** Subscribe to boost packets from a specific agent */
+    subscribeToBoosts(agent: AgentTool, handler: (packet: AgentBoostPacket) => void): void;
+    /** Get all connected agents */
+    getConnectedAgents(): AgentTool[];
+    /** Get bus statistics */
+    getBusStats(): CrossAgentBus;
+    private handleMessage;
+    private deliverMessage;
+    private writeFileMessage;
+    private startFilePolling;
+    private hashMessage;
+}
+//# sourceMappingURL=cross-agent-protocol.d.ts.map

package/dist/brain/cross-agent-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-agent-protocol.d.ts","sourceRoot":"","sources":["../../src/brain/cross-agent-protocol.ts"],"names":[],"mappings":"AASA,OAAO,EACL,SAAS,EACT,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EACzE,MAAM,aAAa,CAAC;AAOrB;;;;;;;;;;;;GAYG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,GAAG,CAAgB;IAC3B,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,aAAa,CAAwE;IAC7F,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,OAAO,CAAS;;IAwBxB,4DAA4D;IACtD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC5B,2BAA2B;IACrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,sCAAsC;IAChC,OAAO,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAmC7D,kDAAkD;IAC5C,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,GAAE,WAAW,CAAC,UAAU,CAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/G,qEAAqE;IAC/D,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB9D,8CAA8C;IACxC,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAajF,uDAAuD;IACvD,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAOtF,+BAA+B;IAC/B,kBAAkB,IAAI,SAAS,EAAE;IAIjC,yBAAyB;IACzB,WAAW,IAAI,aAAa;IAM5B,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,gBAAgB;IAgCxB,OAAO,CAAC,WAAW;CAIpB"}