atlas-pipeline-mcp 1.0.19 → 1.0.21

package/dist/tools/refactor.js

@@ -0,0 +1,308 @@
+/**
+ * Atlas Server - AI-Powered Code Refactoring Tool
+ *
+ * Advanced refactoring capabilities beyond simple code cleanup:
+ * - Pattern detection (design patterns, anti-patterns)
+ * - Complexity reduction (cyclomatic complexity analysis)
+ * - SOLID principles enforcement
+ * - Performance hotspot identification
+ * - Automated Extract Method/Class/Interface
+ * - Dead code elimination
+ * - Type inference and migration
+ * - Dependency injection suggestions
+ *
+ * @module refactor
+ * @author Nishant Unavane
+ * @version 1.0.0
+ */
+import { getActiveProvider, isNoLLMMode } from '../providers/index.js';
+import { logger, createTimer } from '../utils.js';
+import { validateInput } from './validation.js';
+import { z } from 'zod';
+// ============================================================================
+// Validation Schema
+// ============================================================================
+const RefactorOptionsSchema = z.object({
+    code: z.string().min(1).max(500000),
+    language: z.string().min(1),
+    filePath: z.string().optional(),
+    targets: z.array(z.enum([
+        'complexity', 'duplication', 'naming', 'structure',
+        'performance', 'solid', 'patterns', 'types',
+        'async', 'functional', 'deadcode'
+    ])).optional(),
+    maxComplexity: z.number().min(1).max(50).optional(),
+    enforceSOLID: z.boolean().optional(),
+    preserveBehavior: z.boolean().optional(),
+    addTypes: z.boolean().optional(),
+    modernize: z.boolean().optional(),
+    projectContext: z.string().optional(),
+    dependencies: z.array(z.string()).optional(),
+});
+// ============================================================================
+// Code Metrics Calculator
+// ============================================================================
+/**
+ * Calculate code metrics for before/after comparison
+ */
+function calculateMetrics(code, language) {
+    const lines = code.split('\n');
+    const nonEmptyLines = lines.filter(l => l.trim().length > 0);
+    const commentLines = lines.filter(l => {
+        const trimmed = l.trim();
+        return trimmed.startsWith('//') ||
+            trimmed.startsWith('/*') ||
+            trimmed.startsWith('*') ||
+            trimmed.startsWith('#');
+    });
+    // Simple cyclomatic complexity (count decision points)
+    const decisionPoints = (code.match(/\b(if|else|for|while|case|catch|\?|&&|\|\|)\b/g) || []).length;
+    const cyclomaticComplexity = decisionPoints + 1;
+    // Maintainability Index (simplified formula)
+    // MI = max(0, (171 - 5.2 * ln(Halstead Volume) - 0.23 * CC - 16.2 * ln(LOC)) * 100 / 171)
+    const volume = Math.log(nonEmptyLines.length + 1) * 10; // Simplified
+    const mi = Math.max(0, (171 - 5.2 * volume - 0.23 * cyclomaticComplexity - 16.2 * Math.log(nonEmptyLines.length + 1)) * 100 / 171);
+    // Count functions and classes
+    const functionCount = (code.match(/\b(function|def|fn|func)\s+\w+/g) || []).length +
+        (code.match(/=>\s*{/g) || []).length;
+    const classCount = (code.match(/\b(class|struct|interface)\s+\w+/g) || []).length;
+    return {
+        linesOfCode: nonEmptyLines.length,
+        cyclomaticComplexity,
+        maintainabilityIndex: Math.round(mi),
+        duplicatedLines: 0, // Would need more sophisticated analysis
+        functionCount,
+        classCount,
+        commentRatio: commentLines.length / (nonEmptyLines.length || 1),
+    };
+}
+// ============================================================================
+// Pattern Detection
+// ============================================================================
+/**
+ * Detect common code smells and anti-patterns
+ */
+function detectPatterns(code, language) {
+    const smells = [];
+    const patterns = [];
+    // God Class detection
+    if (code.match(/class\s+\w+\s*{[^}]{2000,}}/s)) {
+        smells.push('God Class: Class with too many responsibilities');
+    }
+    // Long Method detection
+    const methods = code.match(/(?:function|def|fn)\s+\w+[^{]*{[^}]{500,}}/gs) || [];
+    if (methods.length > 0) {
+        smells.push(`Long Method: ${methods.length} functions with 50+ lines`);
+    }
+    // Magic Numbers
+    const magicNumbers = code.match(/\b\d{3,}\b/g) || [];
+    if (magicNumbers.length > 3) {
+        smells.push(`Magic Numbers: ${magicNumbers.length} hardcoded numeric literals`);
+    }
+    // Nested Conditionals
+    if (code.match(/if\s*\([^)]+\)\s*{[^}]*if\s*\([^)]+\)\s*{[^}]*if/s)) {
+        smells.push('Deeply Nested Conditionals: Consider guard clauses');
+    }
+    // Singleton Pattern detection
+    if (code.match(/private\s+static\s+\w+\s+instance\s*[=;]/)) {
+        patterns.push('Singleton Pattern detected');
+    }
+    // Factory Pattern detection
+    if (code.match(/class\s+\w*Factory/)) {
+        patterns.push('Factory Pattern detected');
+    }
+    // Observer Pattern detection
+    if (code.match(/\b(on|addEventListener|subscribe|emit)\b/)) {
+        patterns.push('Observer Pattern detected');
+    }
+    return { smells, patterns };
+}
+// ============================================================================
+// Main Refactor Function
+// ============================================================================
+/**
+ * AI-powered code refactoring with pattern detection
+ */
+export async function refactorCode(options) {
+    const timer = createTimer();
+    // Validate input
+    const validated = validateInput(RefactorOptionsSchema, options);
+    const { code, language, filePath, targets = [], maxComplexity = 10, enforceSOLID = true } = validated;
+    logger.info({ language, targets, filePath }, 'Starting code refactoring');
+    // Calculate initial metrics
+    const beforeMetrics = calculateMetrics(code, language);
+    // Detect patterns
+    const { smells, patterns } = detectPatterns(code, language);
+    const warnings = [];
+    const changes = [];
+    // Build refactoring prompt
+    const targetsStr = targets.length > 0
+        ? targets.join(', ')
+        : 'all common refactorings';
+    const prompt = `You are a senior software architect with 50 years of experience. Refactor this ${language} code.
+
+**Original Code:**
+\`\`\`${language}
+${code}
+\`\`\`
+
+**Current Metrics:**
+- Lines of Code: ${beforeMetrics.linesOfCode}
+- Cyclomatic Complexity: ${beforeMetrics.cyclomaticComplexity}
+- Maintainability Index: ${beforeMetrics.maintainabilityIndex}/100
+- Functions: ${beforeMetrics.functionCount}
+- Classes: ${beforeMetrics.classCount}
+
+**Detected Issues:**
+${smells.length > 0 ? smells.map(s => `- ${s}`).join('\n') : '- No major code smells detected'}
+
+**Detected Patterns:**
+${patterns.length > 0 ? patterns.map(p => `- ${p}`).join('\n') : '- No design patterns detected'}
+
+**Refactoring Targets:** ${targetsStr}
+**Max Complexity Target:** ${maxComplexity}
+**Enforce SOLID Principles:** ${enforceSOLID ? 'Yes' : 'No'}
+
+**Instructions:**
+1. Refactor the code to improve:
+   - Readability and maintainability
+   - Performance where applicable
+   - Type safety (add types if missing)
+   - Follow SOLID principles ${enforceSOLID ? '(strictly)' : '(loosely)'}
+   - Reduce cyclomatic complexity to ${maxComplexity} or below
+2. Add descriptive comments for complex logic
+3. Use modern ${language} features and best practices
+4. Extract reusable functions/classes
+5. Remove code duplication
+6. Preserve original behavior exactly
+
+**Provide:**
+1. The refactored code
+2. A list of changes made (one per line, format: "TYPE: Description")
+3. Suggestions for further improvements
+
+Format your response as:
+\`\`\`${language}
+[refactored code here]
+\`\`\`
+
+CHANGES:
+- [change 1]
+- [change 2]
+...
+
+SUGGESTIONS:
+- [suggestion 1]
+- [suggestion 2]
+...`;
+    // Get LLM provider
+    let refactoredCode = code;
+    let suggestions = [];
+    if (isNoLLMMode()) {
+        warnings.push('No LLM provider available - using basic refactoring only');
+        // Basic automated refactorings without LLM
+        refactoredCode = applyBasicRefactorings(code, language, targets);
+        suggestions = [
+            'Install an LLM provider for advanced AI-powered refactoring',
+            'Consider manual code review for complex changes'
+        ];
+    }
+    else {
+        const provider = await getActiveProvider();
+        try {
+            const response = await provider.complete(prompt, {
+                maxTokens: 4000,
+                temperature: 0.3, // Lower temp for more consistent refactoring
+            });
+            const responseText = response.text;
+            // Parse response
+            const codeMatch = responseText.match(new RegExp(`\`\`\`${language}\\s*([\\s\\S]*?)\`\`\``));
+            if (codeMatch && codeMatch[1]) {
+                refactoredCode = codeMatch[1].trim();
+            }
+            else {
+                warnings.push('Could not extract refactored code from LLM response');
+                refactoredCode = code;
+            }
+            // Parse changes
+            const changesMatch = responseText.match(/CHANGES:\s*([\s\S]*?)(?:SUGGESTIONS:|$)/);
+            if (changesMatch && changesMatch[1]) {
+                const changeLines = changesMatch[1].trim().split('\n')
+                    .filter((line) => line.trim().startsWith('-'))
+                    .map((line) => line.replace(/^-\s*/, '').trim());
+                changeLines.forEach((changeLine, idx) => {
+                    const [typeStr, ...descParts] = changeLine.split(':');
+                    const type = typeStr?.toLowerCase().trim() || 'structure';
+                    const description = descParts.join(':').trim();
+                    if (description) {
+                        changes.push({
+                            type,
+                            description,
+                            lineNumber: 1, // Would need more sophisticated parsing
+                            impact: beforeMetrics.cyclomaticComplexity > 15 ? 'high' : 'medium',
+                            autoApplicable: true,
+                        });
+                    }
+                });
+            }
+            // Parse suggestions
+            const suggestionsMatch = responseText.match(/SUGGESTIONS:\s*([\s\S]*?)$/);
+            if (suggestionsMatch && suggestionsMatch[1]) {
+                suggestions = suggestionsMatch[1].trim().split('\n')
+                    .filter((line) => line.trim().startsWith('-'))
+                    .map((line) => line.replace(/^-\s*/, '').trim())
+                    .filter(Boolean);
+            }
+        }
+        catch (error) {
+            logger.error({ error }, 'Refactoring failed');
+            warnings.push(`LLM error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            refactoredCode = code;
+        }
+    }
+    // Calculate final metrics
+    const afterMetrics = calculateMetrics(refactoredCode, language);
+    // Add metrics comparison to suggestions
+    if (afterMetrics.cyclomaticComplexity < beforeMetrics.cyclomaticComplexity) {
+        suggestions.unshift(`✅ Complexity reduced from ${beforeMetrics.cyclomaticComplexity} to ${afterMetrics.cyclomaticComplexity}`);
+    }
+    if (afterMetrics.maintainabilityIndex > beforeMetrics.maintainabilityIndex) {
+        suggestions.unshift(`✅ Maintainability improved from ${beforeMetrics.maintainabilityIndex} to ${afterMetrics.maintainabilityIndex}`);
+    }
+    const executionTimeMs = timer.elapsed();
+    logger.info({
+        beforeComplexity: beforeMetrics.cyclomaticComplexity,
+        afterComplexity: afterMetrics.cyclomaticComplexity,
+        changesCount: changes.length,
+        executionTimeMs
+    }, 'Refactoring completed');
+    return {
+        originalCode: code,
+        refactoredCode,
+        changes,
+        metrics: afterMetrics,
+        suggestions,
+        executionTimeMs,
+        warnings,
+    };
+}
+/**
+ * Apply basic refactorings without LLM
+ */
+function applyBasicRefactorings(code, language, targets) {
+    let result = code;
+    // Remove trailing whitespace
+    result = result.split('\n').map(line => line.trimEnd()).join('\n');
+    // Consistent indentation
+    result = result.replace(/\t/g, '  ');
+    // Remove multiple blank lines
+    result = result.replace(/\n{3,}/g, '\n\n');
+    // Add space after keywords
+    result = result.replace(/\b(if|for|while|switch|catch)\(/g, '$1 (');
+    return result;
+}
+// ============================================================================
+// Export
+// ============================================================================
+export default refactorCode;
+//# sourceMappingURL=refactor.js.map

package/dist/tools/refactor.js.map

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

package/dist/tools/resource-manager.d.ts

@@ -0,0 +1,167 @@
+/**
+ * Atlas Server - Resource Management and Cleanup
+ *
+ * Comprehensive resource lifecycle management to prevent memory leaks:
+ * - Automatic cleanup of resources
+ * - Graceful shutdown handling
+ * - Resource pooling and recycling
+ * - Memory usage tracking
+ * - File handle management
+ *
+ * @module resource-manager
+ * @version 1.0.0
+ */
+import type { SimpleGit } from 'simple-git';
+/**
+ * Resource that requires cleanup
+ */
+export interface ManagedResource {
+    /** Unique identifier for the resource */
+    readonly id: string;
+    /** Resource type for tracking */
+    readonly type: ResourceType;
+    /** Timestamp when resource was created */
+    readonly createdAt: number;
+    /** Last access timestamp for LRU eviction */
+    lastAccessedAt: number;
+    /** Cleanup function to release the resource */
+    cleanup(): Promise<void> | void;
+    /** Check if resource is still valid */
+    isValid(): boolean;
+}
+/**
+ * Types of managed resources
+ */
+export type ResourceType = 'git-instance' | 'file-handle' | 'cache' | 'timer' | 'connection' | 'stream' | 'subprocess' | 'other';
+/**
+ * Git instance wrapper with lifecycle management
+ */
+export declare class ManagedGitInstance implements ManagedResource {
+    readonly repoPath: string;
+    private git;
+    readonly id: string;
+    readonly type: ResourceType;
+    readonly createdAt: number;
+    lastAccessedAt: number;
+    constructor(repoPath: string, git: SimpleGit);
+    /** Get the git instance and update access time */
+    getGit(): SimpleGit;
+    /** Check if instance is still valid */
+    isValid(): boolean;
+    /** Cleanup the git instance */
+    cleanup(): Promise<void>;
+}
+/**
+ * Centralized resource manager for automatic cleanup
+ */
+export declare class ResourceManager {
+    private readonly options;
+    private resources;
+    private cleanupTimer;
+    private shutdownHandlers;
+    private isShuttingDown;
+    constructor(options?: {
+        /** Cleanup interval in milliseconds */
+        cleanupIntervalMs?: number;
+        /** Maximum idle time before resource cleanup (milliseconds) */
+        maxIdleTimeMs?: number;
+        /** Maximum number of resources to keep */
+        maxResources?: number;
+    });
+    /**
+     * Register a resource for management
+     */
+    register(resource: ManagedResource): void;
+    /**
+     * Unregister and cleanup a resource
+     */
+    unregister(id: string): Promise<void>;
+    /**
+     * Get a resource by ID
+     */
+    get<T extends ManagedResource>(id: string): T | null;
+    /**
+     * Check if a resource exists
+     */
+    has(id: string): boolean;
+    /**
+     * Get all resources of a specific type
+     */
+    getByType<T extends ManagedResource>(type: ResourceType): T[];
+    /**
+     * Perform periodic cleanup of idle resources
+     */
+    private performCleanup;
+    /**
+     * Cleanup a single resource
+     */
+    private cleanupResource;
+    /**
+     * Register a custom shutdown handler
+     */
+    onShutdown(handler: () => Promise<void> | void): void;
+    /**
+     * Graceful shutdown - cleanup all resources
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Register signal handlers for graceful shutdown
+     */
+    private registerShutdownHandlers;
+    /**
+     * Get resource statistics
+     */
+    getStats(): {
+        total: number;
+        byType: Record<ResourceType, number>;
+        oldestResourceAge: number;
+    };
+}
+/** Global resource manager instance */
+export declare const globalResourceManager: ResourceManager;
+/**
+ * Create a managed resource with automatic cleanup
+ *
+ * @param create - Function to create the resource
+ * @param cleanup - Function to cleanup the resource
+ * @param options - Resource options
+ * @returns The created resource
+ */
+export declare function withManagedResource<T>(create: () => Promise<T> | T, cleanup: (resource: T) => Promise<void> | void, options: {
+    id: string;
+    type: ResourceType;
+    autoRegister?: boolean;
+}): Promise<T>;
+/**
+ * Execute a function with automatic resource cleanup
+ *
+ * @param fn - Function to execute
+ * @param resources - Resources to cleanup after execution
+ * @returns Result of the function
+ */
+export declare function withCleanup<T>(fn: () => Promise<T> | T, resources: ManagedResource[]): Promise<T>;
+/**
+ * Memory usage monitor
+ */
+export declare class MemoryMonitor {
+    private readonly threshold;
+    private warnings;
+    constructor(thresholdMB?: number);
+    /**
+     * Check current memory usage
+     */
+    check(): {
+        heapUsed: number;
+        heapTotal: number;
+        external: number;
+        rss: number;
+        isOverThreshold: boolean;
+    };
+    /**
+     * Force garbage collection if available
+     */
+    forceGC(): boolean;
+}
+/** Global memory monitor */
+export declare const globalMemoryMonitor: MemoryMonitor;
+//# sourceMappingURL=resource-manager.d.ts.map

package/dist/tools/resource-manager.d.ts.map

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