atlas-pipeline-mcp 1.0.20 → 1.0.22

package/dist/tools/profiler.js

@@ -0,0 +1,385 @@
+/**
+ * Atlas Server - Performance Profiling and Analysis Tool
+ *
+ * Advanced performance profiling for code optimization:
+ * - Time complexity analysis
+ * - Space complexity analysis
+ * - Benchmark generation
+ * - Memory leak detection
+ * - CPU hotspot identification
+ * - I/O bottleneck detection
+ * - Algorithm efficiency suggestions
+ * - Big-O notation analysis
+ *
+ * @module profiler
+ * @author Nishant Unavane
+ * @version 1.0.0
+ */
+import { getActiveProvider, isNoLLMMode } from '../providers/index.js';
+import { logger, createTimer } from '../utils.js';
+import { z } from 'zod';
+// ============================================================================
+// Validation Schema
+// ============================================================================
+const ProfileOptionsSchema = z.object({
+    code: z.string().min(1).max(500000),
+    language: z.string().min(1),
+    filePath: z.string().optional(),
+    analyzeTime: z.boolean().optional(),
+    analyzeSpace: z.boolean().optional(),
+    detectLeaks: z.boolean().optional(),
+    identifyHotspots: z.boolean().optional(),
+    generateBenchmark: z.boolean().optional(),
+    inputSizes: z.array(z.number()).optional(),
+    expectedInputSize: z.enum(['small', 'medium', 'large', 'huge']).optional(),
+    constraints: z.array(z.string()).optional(),
+});
+// ============================================================================
+// Static Code Analysis
+// ============================================================================
+/**
+ * Analyze code structure for performance patterns
+ */
+function analyzeCodeStructure(code, language) {
+    // Count loops
+    const loopPatterns = /\b(for|while|forEach|map|filter|reduce|each)\b/gi;
+    const loops = (code.match(loopPatterns) || []).length;
+    // Detect nested loops (simplified)
+    const nestedLoopPattern = /\b(for|while)\b[^{]*{[^}]*(for|while)\b/gis;
+    const nestedLoops = (code.match(nestedLoopPattern) || []).length;
+    // Detect recursion
+    const functionNames = [...code.matchAll(/(?:function|def|fn)\s+(\w+)/g)].map(m => m[1]);
+    const recursiveCalls = functionNames.filter(name => new RegExp(`\\b${name}\\s*\\(`).test(code)).length;
+    // Detect I/O operations
+    const ioOperations = [];
+    // File I/O
+    if (code.match(/\b(readFile|writeFile|open|read|write|createWriteStream)\b/i)) {
+        ioOperations.push({
+            type: 'file',
+            operation: 'File I/O detected',
+            isBlocking: code.includes('Sync') || code.includes('await'),
+            isRepeated: /\b(for|while)[^{]*{[^}]*(read|write)/i.test(code),
+        });
+    }
+    // Network I/O
+    if (code.match(/\b(fetch|axios|request|http\.get|http\.post)\b/i)) {
+        ioOperations.push({
+            type: 'network',
+            operation: 'Network request detected',
+            isBlocking: code.includes('await') || code.includes('.then('),
+            isRepeated: /\b(for|while)[^{]*{[^}]*(fetch|request)/i.test(code),
+        });
+    }
+    // Database operations
+    if (code.match(/\b(query|execute|find|findOne|insert|update|delete|aggregate)\b/i)) {
+        ioOperations.push({
+            type: 'database',
+            operation: 'Database query detected',
+            isBlocking: true,
+            isRepeated: /\b(for|while)[^{]*{[^}]*(query|find)/i.test(code),
+        });
+    }
+    return { loops, nestedLoops, recursiveCalls, ioOperations };
+}
+/**
+ * Estimate Big-O complexity from code structure
+ */
+function estimateComplexity(structure) {
+    const { loops, nestedLoops, recursiveCalls, ioOperations } = structure;
+    let timeComplexity = 'O(1)';
+    let spaceComplexity = 'O(1)';
+    let confidence = 0.6;
+    // Time complexity estimation
+    if (nestedLoops >= 3) {
+        timeComplexity = 'O(n³) or worse';
+        confidence = 0.7;
+    }
+    else if (nestedLoops >= 2) {
+        timeComplexity = 'O(n²)';
+        confidence = 0.75;
+    }
+    else if (nestedLoops === 1 || loops > 1) {
+        timeComplexity = 'O(n log n) or O(n²)';
+        confidence = 0.65;
+    }
+    else if (loops === 1) {
+        timeComplexity = 'O(n)';
+        confidence = 0.8;
+    }
+    else if (recursiveCalls > 0) {
+        timeComplexity = 'O(2ⁿ) or O(n!)';
+        confidence = 0.5;
+    }
+    // Space complexity estimation
+    if (recursiveCalls > 0) {
+        spaceComplexity = 'O(n) recursion stack';
+        confidence = Math.min(confidence, 0.7);
+    }
+    else if (loops > 0) {
+        spaceComplexity = 'O(n) or O(1)';
+        confidence = Math.min(confidence, 0.6);
+    }
+    return { time: timeComplexity, space: spaceComplexity, confidence };
+}
+/**
+ * Detect memory leak patterns
+ */
+function detectMemoryLeaks(code, language) {
+    let riskScore = 0;
+    // Global variable accumulation
+    if (code.match(/\b(global|window)\.\w+\s*=\s*\[/)) {
+        riskScore += 3;
+    }
+    // Event listeners without cleanup
+    if (code.match(/addEventListener/) && !code.match(/removeEventListener/)) {
+        riskScore += 2;
+    }
+    // Timers without cleanup
+    if ((code.match(/setInterval|setTimeout/) || []).length >
+        (code.match(/clearInterval|clearTimeout/) || []).length) {
+        riskScore += 2;
+    }
+    // Circular references
+    if (code.match(/\w+\.\w+\s*=\s*\w+/) && code.match(/\w+\.\w+\s*=\s*this/)) {
+        riskScore += 1;
+    }
+    // Unbounded collections
+    if (code.match(/\[\]\.push|Map\(\)|Set\(\)/) && !code.match(/clear|delete|splice/)) {
+        riskScore += 2;
+    }
+    if (riskScore >= 6)
+        return 'high';
+    if (riskScore >= 4)
+        return 'medium';
+    if (riskScore >= 2)
+        return 'low';
+    return 'none';
+}
+// ============================================================================
+// Main Profile Function
+// ============================================================================
+/**
+ * Comprehensive performance profiling and analysis
+ */
+export async function profileCode(options) {
+    const timer = createTimer();
+    const { code, language, filePath, analyzeTime = true, analyzeSpace = true, detectLeaks = true, identifyHotspots = true, generateBenchmark = false, inputSizes = [10, 100, 1000, 10000], expectedInputSize = 'medium', constraints = [], } = ProfileOptionsSchema.parse(options);
+    logger.info({ language, filePath }, 'Starting performance profiling');
+    const warnings = [];
+    // Static analysis
+    const structure = analyzeCodeStructure(code, language);
+    const complexity = estimateComplexity(structure);
+    const memoryLeakRisk = detectLeaks ? detectMemoryLeaks(code, language) : 'none';
+    // Build analysis prompt
+    const prompt = `You are a performance optimization expert with 50 years of experience. Analyze this ${language} code for performance.
+
+**Code:**
+\`\`\`${language}
+${code}
+\`\`\`
+
+**Static Analysis:**
+- Loops detected: ${structure.loops}
+- Nested loops: ${structure.nestedLoops}
+- Recursive calls: ${structure.recursiveCalls}
+- I/O operations: ${structure.ioOperations.length}
+- Estimated time complexity: ${complexity.time}
+- Estimated space complexity: ${complexity.space}
+- Memory leak risk: ${memoryLeakRisk}
+- Expected input size: ${expectedInputSize}
+
+**I/O Operations:**
+${structure.ioOperations.map(io => `- ${io.type} (${io.isBlocking ? 'blocking' : 'non-blocking'}${io.isRepeated ? ', repeated' : ''})`).join('\n') || '- None detected'}
+
+**Constraints:**
+${constraints.length > 0 ? constraints.join('\n') : '- None specified'}
+
+**Tasks:**
+1. Analyze time complexity (Big-O notation) for best, average, and worst cases
+2. Analyze space complexity
+3. Identify performance hotspots (CPU, memory, I/O)
+4. Provide optimization suggestions ranked by impact
+5. ${generateBenchmark ? 'Generate benchmark code' : ''}
+
+**Format your response as:**
+
+TIME_COMPLEXITY:
+Best: O(...)
+Average: O(...)
+Worst: O(...)
+Explanation: [why this complexity]
+
+SPACE_COMPLEXITY:
+Best: O(...)
+Average: O(...)
+Worst: O(...)
+Explanation: [why this complexity]
+
+HOTSPOTS:
+- [location]: [type] - [description] - Impact: [X%]
+...
+
+OPTIMIZATIONS:
+Priority 1: [category] - [description] - Gain: [X%]
+Priority 2: [category] - [description] - Gain: [X%]
+...
+
+${generateBenchmark ? `BENCHMARK:
+\`\`\`${language}
+[benchmark code here]
+\`\`\`
+` : ''}`;
+    let analysis = {
+        timeComplexity: {
+            bigO: complexity.time,
+            bestCase: complexity.time,
+            averageCase: complexity.time,
+            worstCase: complexity.time,
+            explanation: 'Static analysis estimate',
+            confidence: complexity.confidence,
+        },
+        spaceComplexity: {
+            bigO: complexity.space,
+            bestCase: complexity.space,
+            averageCase: complexity.space,
+            worstCase: complexity.space,
+            explanation: 'Static analysis estimate',
+            confidence: complexity.confidence,
+        },
+        potentialBottlenecks: [],
+        memoryLeakRisk,
+        ioOperations: structure.ioOperations,
+    };
+    let hotspots = [];
+    let suggestions = [];
+    let benchmarkCode;
+    if (isNoLLMMode()) {
+        warnings.push('No LLM provider - using static analysis only');
+        // Add basic suggestions based on static analysis
+        if (structure.nestedLoops >= 2) {
+            suggestions.push({
+                priority: 9,
+                category: 'algorithm',
+                description: 'Nested loops detected - consider using hash maps or better algorithm',
+                estimatedGain: '10-100x faster',
+            });
+        }
+        if (structure.ioOperations.some(io => io.isRepeated)) {
+            suggestions.push({
+                priority: 10,
+                category: 'io',
+                description: 'Repeated I/O operations in loop - batch or cache results',
+                estimatedGain: '5-50x faster',
+            });
+        }
+        if (memoryLeakRisk === 'high' || memoryLeakRisk === 'medium') {
+            suggestions.push({
+                priority: 8,
+                category: 'memory',
+                description: 'High memory leak risk - add cleanup for timers/listeners',
+                estimatedGain: 'Prevents memory growth',
+            });
+        }
+    }
+    else {
+        const provider = await getActiveProvider();
+        try {
+            const response = await provider.complete(prompt, {
+                maxTokens: 3000,
+                temperature: 0.2,
+            });
+            const responseText = response.text;
+            // Parse time complexity
+            const timeMatch = responseText.match(/TIME_COMPLEXITY:\s*Best:\s*([^\n]+)\s*Average:\s*([^\n]+)\s*Worst:\s*([^\n]+)\s*Explanation:\s*([^\n]+)/i);
+            if (timeMatch && timeMatch[1] && timeMatch[2] && timeMatch[3] && timeMatch[4]) {
+                analysis.timeComplexity = {
+                    bigO: timeMatch[2].trim(),
+                    bestCase: timeMatch[1].trim(),
+                    averageCase: timeMatch[2].trim(),
+                    worstCase: timeMatch[3].trim(),
+                    explanation: timeMatch[4].trim(),
+                    confidence: 0.85,
+                };
+            }
+            // Parse space complexity
+            const spaceMatch = responseText.match(/SPACE_COMPLEXITY:\s*Best:\s*([^\n]+)\s*Average:\s*([^\n]+)\s*Worst:\s*([^\n]+)\s*Explanation:\s*([^\n]+)/i);
+            if (spaceMatch && spaceMatch[1] && spaceMatch[2] && spaceMatch[3] && spaceMatch[4]) {
+                analysis.spaceComplexity = {
+                    bigO: spaceMatch[2].trim(),
+                    bestCase: spaceMatch[1].trim(),
+                    averageCase: spaceMatch[2].trim(),
+                    worstCase: spaceMatch[3].trim(),
+                    explanation: spaceMatch[4].trim(),
+                    confidence: 0.85,
+                };
+            }
+            // Parse hotspots
+            const hotspotsMatch = responseText.match(/HOTSPOTS:\s*([\s\S]*?)(?:OPTIMIZATIONS:|$)/i);
+            if (hotspotsMatch && hotspotsMatch[1]) {
+                const hotspotLines = hotspotsMatch[1].trim().split('\n')
+                    .filter((line) => line.trim().startsWith('-'));
+                hotspots = hotspotLines.map((line) => {
+                    const clean = line.replace(/^-\s*/, '').trim();
+                    const parts = clean.split(' - ');
+                    return {
+                        location: parts[0] || 'Unknown',
+                        type: parts[1]?.toLowerCase() || 'cpu',
+                        severity: 'high',
+                        description: parts[2] || clean,
+                        estimatedImpact: parts[3] || 'Unknown',
+                    };
+                });
+            }
+            // Parse optimizations
+            const optsMatch = responseText.match(/OPTIMIZATIONS:\s*([\s\S]*?)(?:BENCHMARK:|$)/i);
+            if (optsMatch && optsMatch[1]) {
+                const optLines = optsMatch[1].trim().split('\n')
+                    .filter((line) => /Priority\s+\d+:/i.test(line));
+                suggestions = optLines.map((line) => {
+                    const priorityMatch = line.match(/Priority\s+(\d+):/i);
+                    const priority = priorityMatch ? parseInt(priorityMatch[1] || '5') : 5;
+                    const parts = line.split(' - ');
+                    const categoryPart = parts[0]?.split(':')[1]?.trim() || 'algorithm';
+                    return {
+                        priority,
+                        category: categoryPart.toLowerCase(),
+                        description: parts[1] || line,
+                        estimatedGain: parts[2] || 'Unknown',
+                    };
+                }).sort((a, b) => b.priority - a.priority);
+            }
+            // Parse benchmark code
+            if (generateBenchmark) {
+                const benchMatch = responseText.match(/BENCHMARK:\s*```[\w]*\s*([\s\S]*?)```/i);
+                if (benchMatch && benchMatch[1]) {
+                    benchmarkCode = benchMatch[1].trim();
+                }
+            }
+        }
+        catch (error) {
+            logger.error({ error }, 'Profiling failed');
+            warnings.push(`LLM error: ${error instanceof Error ? error.message : 'Unknown'}`);
+        }
+    }
+    const executionTimeMs = timer.elapsed();
+    logger.info({
+        timeComplexity: analysis.timeComplexity.bigO,
+        hotspots: hotspots.length,
+        suggestions: suggestions.length,
+        executionTimeMs
+    }, 'Profiling completed');
+    return {
+        code,
+        analysis,
+        hotspots,
+        suggestions,
+        benchmarkCode,
+        executionTimeMs,
+        warnings,
+    };
+}
+// ============================================================================
+// Export
+// ============================================================================
+export default profileCode;
+//# sourceMappingURL=profiler.js.map

package/dist/tools/profiler.js.map

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

package/dist/tools/rag-search.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Atlas Server - RAG-Powered Codebase Search & Understanding
+ *
+ * Semantic code search using vector embeddings and RAG:
+ * - Natural language queries to find code
+ * - Semantic similarity matching (not just keyword search)
+ * - Code understanding through embeddings
+ * - Cross-file dependency discovery
+ * - Architecture pattern detection
+ * - Similar code detection
+ * - Knowledge graph construction
+ * - Multi-modal code analysis (code + docs + comments)
+ *
+ * @module rag-search
+ * @author Nishant Unavane
+ * @version 1.0.0
+ */
+export interface RAGSearchOptions {
+    projectPath: string;
+    query: string;
+    searchType?: 'semantic' | 'keyword' | 'hybrid';
+    maxResults?: number;
+    minSimilarity?: number;
+    fileTypes?: string[];
+    excludePaths?: string[];
+    includeTests?: boolean;
+    includeDocs?: boolean;
+    chunkSize?: number;
+    overlapSize?: number;
+    useCache?: boolean;
+}
+export interface RAGSearchResult {
+    query: string;
+    results: CodeMatch[];
+    totalMatches: number;
+    searchTimeMs: number;
+    indexedFiles: number;
+    semanticSearch: boolean;
+    knowledgeGraph?: KnowledgeGraph;
+}
+export interface CodeMatch {
+    filePath: string;
+    snippet: string;
+    context: string;
+    similarity: number;
+    explanation: string;
+    lineStart: number;
+    lineEnd: number;
+    matchType: 'exact' | 'semantic' | 'partial';
+    metadata: {
+        language: string;
+        fileSize: number;
+        lastModified: Date;
+        category: CodeCategory;
+    };
+}
+export type CodeCategory = 'function' | 'class' | 'interface' | 'type' | 'variable' | 'import' | 'comment' | 'documentation';
+export interface KnowledgeGraph {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    clusters: CodeCluster[];
+}
+export interface GraphNode {
+    id: string;
+    label: string;
+    type: CodeCategory;
+    filePath: string;
+    importance: number;
+}
+export interface GraphEdge {
+    from: string;
+    to: string;
+    type: 'imports' | 'calls' | 'extends' | 'implements' | 'references';
+    weight: number;
+}
+export interface CodeCluster {
+    id: string;
+    files: string[];
+    topic: string;
+    keywords: string[];
+    cohesion: number;
+}
+/**
+ * RAG-powered semantic code search
+ */
+export declare function searchCodebase(options: RAGSearchOptions): Promise<RAGSearchResult>;
+export default searchCodebase;
+//# sourceMappingURL=rag-search.d.ts.map

package/dist/tools/rag-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-search.d.ts","sourceRoot":"","sources":["../../src/tools/rag-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IAGd,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC5C,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,IAAI,CAAC;QACnB,QAAQ,EAAE,YAAY,CAAC;KACxB,CAAC;CACH;AAED,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,OAAO,GACP,WAAW,GACX,MAAM,GACN,UAAU,GACV,QAAQ,GACR,SAAS,GACT,eAAe,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,CAAC;IACpE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA2OD;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CA6IxF;AAMD,eAAe,cAAc,CAAC"}