@theihtisham/agent-shadow-brain 1.2.0 → 3.0.0

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

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