atlas-pipeline-mcp 1.0.19 → 1.0.21

package/dist/tools/resource-manager.js

@@ -0,0 +1,352 @@
+/**
+ * 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 { logger } from '../utils.js';
+/**
+ * Git instance wrapper with lifecycle management
+ */
+export class ManagedGitInstance {
+    repoPath;
+    git;
+    id;
+    type = 'git-instance';
+    createdAt;
+    lastAccessedAt;
+    constructor(repoPath, git) {
+        this.repoPath = repoPath;
+        this.git = git;
+        this.id = `git:${repoPath}`;
+        this.createdAt = Date.now();
+        this.lastAccessedAt = Date.now();
+    }
+    /** Get the git instance and update access time */
+    getGit() {
+        this.lastAccessedAt = Date.now();
+        return this.git;
+    }
+    /** Check if instance is still valid */
+    isValid() {
+        // Git instances don't expire but can be invalidated
+        return this.git !== null;
+    }
+    /** Cleanup the git instance */
+    async cleanup() {
+        logger.debug({ repoPath: this.repoPath }, 'Cleaning up git instance');
+        // SimpleGit doesn't require explicit cleanup, but we null it out
+        this.git = null;
+    }
+}
+// ============================================================================
+// Resource Manager
+// ============================================================================
+/**
+ * Centralized resource manager for automatic cleanup
+ */
+export class ResourceManager {
+    options;
+    resources = new Map();
+    cleanupTimer = null;
+    shutdownHandlers = [];
+    isShuttingDown = false;
+    constructor(options = {}) {
+        this.options = options;
+        const { cleanupIntervalMs = 60000, // 1 minute
+        maxIdleTimeMs = 300000, // 5 minutes
+        maxResources = 100, } = options;
+        // Start periodic cleanup
+        this.cleanupTimer = setInterval(() => {
+            this.performCleanup(maxIdleTimeMs, maxResources);
+        }, cleanupIntervalMs);
+        // Register shutdown handler
+        this.registerShutdownHandlers();
+    }
+    /**
+     * Register a resource for management
+     */
+    register(resource) {
+        if (this.isShuttingDown) {
+            logger.warn('Cannot register resource during shutdown');
+            return;
+        }
+        this.resources.set(resource.id, resource);
+        logger.debug({ id: resource.id, type: resource.type, totalResources: this.resources.size }, 'Resource registered');
+    }
+    /**
+     * Unregister and cleanup a resource
+     */
+    async unregister(id) {
+        const resource = this.resources.get(id);
+        if (resource) {
+            await this.cleanupResource(resource);
+            this.resources.delete(id);
+        }
+    }
+    /**
+     * Get a resource by ID
+     */
+    get(id) {
+        const resource = this.resources.get(id);
+        if (resource) {
+            resource.lastAccessedAt = Date.now();
+            return resource;
+        }
+        return null;
+    }
+    /**
+     * Check if a resource exists
+     */
+    has(id) {
+        return this.resources.has(id);
+    }
+    /**
+     * Get all resources of a specific type
+     */
+    getByType(type) {
+        const results = [];
+        for (const resource of this.resources.values()) {
+            if (resource.type === type) {
+                results.push(resource);
+            }
+        }
+        return results;
+    }
+    /**
+     * Perform periodic cleanup of idle resources
+     */
+    async performCleanup(maxIdleTimeMs, maxResources) {
+        const now = Date.now();
+        const resourcesToCleanup = [];
+        // Find resources to cleanup
+        for (const resource of this.resources.values()) {
+            const idleTime = now - resource.lastAccessedAt;
+            // Cleanup invalid or idle resources
+            if (!resource.isValid() || idleTime > maxIdleTimeMs) {
+                resourcesToCleanup.push(resource);
+            }
+        }
+        // If still over limit after idle cleanup, cleanup LRU resources
+        if (this.resources.size > maxResources) {
+            const sorted = Array.from(this.resources.values())
+                .filter((r) => !resourcesToCleanup.includes(r))
+                .sort((a, b) => a.lastAccessedAt - b.lastAccessedAt);
+            const excess = this.resources.size - maxResources;
+            resourcesToCleanup.push(...sorted.slice(0, excess));
+        }
+        // Cleanup resources
+        if (resourcesToCleanup.length > 0) {
+            logger.debug({ count: resourcesToCleanup.length, totalResources: this.resources.size }, 'Performing resource cleanup');
+            for (const resource of resourcesToCleanup) {
+                await this.cleanupResource(resource);
+                this.resources.delete(resource.id);
+            }
+        }
+    }
+    /**
+     * Cleanup a single resource
+     */
+    async cleanupResource(resource) {
+        try {
+            await resource.cleanup();
+            logger.debug({ id: resource.id, type: resource.type }, 'Resource cleaned up');
+        }
+        catch (error) {
+            logger.error({ error, id: resource.id, type: resource.type }, 'Error cleaning up resource');
+        }
+    }
+    /**
+     * Register a custom shutdown handler
+     */
+    onShutdown(handler) {
+        this.shutdownHandlers.push(handler);
+    }
+    /**
+     * Graceful shutdown - cleanup all resources
+     */
+    async shutdown() {
+        if (this.isShuttingDown) {
+            logger.warn('Shutdown already in progress');
+            return;
+        }
+        this.isShuttingDown = true;
+        logger.info({ resourceCount: this.resources.size }, 'Starting graceful shutdown');
+        // Stop cleanup timer
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        // Run custom shutdown handlers
+        for (const handler of this.shutdownHandlers) {
+            try {
+                await handler();
+            }
+            catch (error) {
+                logger.error({ error }, 'Error in shutdown handler');
+            }
+        }
+        // Cleanup all resources
+        const cleanupPromises = Array.from(this.resources.values()).map((resource) => this.cleanupResource(resource));
+        await Promise.allSettled(cleanupPromises);
+        this.resources.clear();
+        logger.info('Graceful shutdown complete');
+    }
+    /**
+     * Register signal handlers for graceful shutdown
+     */
+    registerShutdownHandlers() {
+        const signals = ['SIGINT', 'SIGTERM', 'SIGQUIT'];
+        for (const signal of signals) {
+            process.once(signal, () => {
+                logger.info({ signal }, 'Received shutdown signal');
+                this.shutdown()
+                    .then(() => process.exit(0))
+                    .catch((error) => {
+                    logger.error({ error }, 'Error during shutdown');
+                    process.exit(1);
+                });
+            });
+        }
+        // Handle uncaught errors
+        process.once('uncaughtException', (error) => {
+            logger.error({ error }, 'Uncaught exception');
+            this.shutdown()
+                .then(() => process.exit(1))
+                .catch(() => process.exit(1));
+        });
+        process.once('unhandledRejection', (reason) => {
+            logger.error({ reason }, 'Unhandled rejection');
+            this.shutdown()
+                .then(() => process.exit(1))
+                .catch(() => process.exit(1));
+        });
+    }
+    /**
+     * Get resource statistics
+     */
+    getStats() {
+        const byType = {};
+        let oldestAge = 0;
+        const now = Date.now();
+        for (const resource of this.resources.values()) {
+            byType[resource.type] = (byType[resource.type] || 0) + 1;
+            const age = now - resource.createdAt;
+            if (age > oldestAge) {
+                oldestAge = age;
+            }
+        }
+        return {
+            total: this.resources.size,
+            byType: byType,
+            oldestResourceAge: oldestAge,
+        };
+    }
+}
+// ============================================================================
+// Global Resource Manager
+// ============================================================================
+/** Global resource manager instance */
+export const globalResourceManager = new ResourceManager({
+    cleanupIntervalMs: 60000, // 1 minute
+    maxIdleTimeMs: 300000, // 5 minutes
+    maxResources: 100,
+});
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * 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 async function withManagedResource(create, cleanup, options) {
+    const { id, type, autoRegister = true } = options;
+    const resource = await create();
+    if (autoRegister) {
+        const managedResource = {
+            id,
+            type,
+            createdAt: Date.now(),
+            lastAccessedAt: Date.now(),
+            cleanup: () => cleanup(resource),
+            isValid: () => resource !== null && resource !== undefined,
+        };
+        globalResourceManager.register(managedResource);
+    }
+    return resource;
+}
+/**
+ * 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 async function withCleanup(fn, resources) {
+    try {
+        return await fn();
+    }
+    finally {
+        // Cleanup resources in parallel
+        await Promise.allSettled(resources.map((resource) => resource.cleanup()));
+    }
+}
+/**
+ * Memory usage monitor
+ */
+export class MemoryMonitor {
+    threshold;
+    warnings = 0;
+    constructor(thresholdMB = 512) {
+        this.threshold = thresholdMB * 1024 * 1024; // Convert to bytes
+    }
+    /**
+     * Check current memory usage
+     */
+    check() {
+        const usage = process.memoryUsage();
+        const isOverThreshold = usage.heapUsed > this.threshold;
+        if (isOverThreshold) {
+            this.warnings++;
+            logger.warn({
+                heapUsedMB: Math.round(usage.heapUsed / 1024 / 1024),
+                heapTotalMB: Math.round(usage.heapTotal / 1024 / 1024),
+                thresholdMB: Math.round(this.threshold / 1024 / 1024),
+                warnings: this.warnings,
+            }, 'Memory usage exceeds threshold');
+        }
+        return {
+            heapUsed: usage.heapUsed,
+            heapTotal: usage.heapTotal,
+            external: usage.external,
+            rss: usage.rss,
+            isOverThreshold,
+        };
+    }
+    /**
+     * Force garbage collection if available
+     */
+    forceGC() {
+        if (global.gc) {
+            global.gc();
+            logger.debug('Forced garbage collection');
+            return true;
+        }
+        logger.debug('Garbage collection not available (run with --expose-gc)');
+        return false;
+    }
+}
+/** Global memory monitor */
+export const globalMemoryMonitor = new MemoryMonitor(512);
+//# sourceMappingURL=resource-manager.js.map

package/dist/tools/resource-manager.js.map

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

package/dist/tools/review.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Atlas Server - AI Code Review Assistant
+ *
+ * Comprehensive AI-powered code review capabilities:
+ * - Multi-dimensional code quality analysis
+ * - Best practices enforcement
+ * - Architectural pattern validation
+ * - Security vulnerability detection
+ * - Performance optimization suggestions
+ * - Test coverage recommendations
+ * - Documentation quality assessment
+ * - Team coding standards compliance
+ *
+ * @module review
+ * @author Nishant Unavane
+ * @version 1.0.0
+ */
+export interface CodeReviewOptions {
+    code: string;
+    language: string;
+    filePath?: string;
+    checkQuality?: boolean;
+    checkSecurity?: boolean;
+    checkPerformance?: boolean;
+    checkArchitecture?: boolean;
+    checkTests?: boolean;
+    checkDocumentation?: boolean;
+    framework?: string;
+    teamStandards?: string;
+    pullRequestContext?: string;
+    changedFiles?: string[];
+}
+export interface CodeReviewResult {
+    code: string;
+    overallScore: number;
+    grades: ReviewGrades;
+    findings: ReviewFinding[];
+    suggestions: ReviewSuggestion[];
+    metrics: QualityMetrics;
+    summary: string;
+    executionTimeMs: number;
+    warnings: string[];
+}
+export interface ReviewGrades {
+    quality: Grade;
+    security: Grade;
+    performance: Grade;
+    architecture: Grade;
+    tests: Grade;
+    documentation: Grade;
+}
+export interface Grade {
+    score: number;
+    letter: 'A+' | 'A' | 'B' | 'C' | 'D' | 'F';
+    issues: number;
+    strengths: string[];
+    weaknesses: string[];
+}
+export interface ReviewFinding {
+    severity: 'blocker' | 'critical' | 'major' | 'minor' | 'info';
+    category: ReviewCategory;
+    title: string;
+    description: string;
+    location?: CodeLocation;
+    suggestion: string;
+    autoFixable: boolean;
+    references?: string[];
+}
+export type ReviewCategory = 'correctness' | 'security' | 'performance' | 'maintainability' | 'reliability' | 'architecture' | 'testing' | 'documentation' | 'style' | 'best-practices';
+export interface CodeLocation {
+    startLine: number;
+    endLine: number;
+    snippet?: string;
+}
+export interface ReviewSuggestion {
+    priority: 'must' | 'should' | 'consider';
+    category: string;
+    description: string;
+    codeExample?: string;
+    rationale: string;
+}
+export interface QualityMetrics {
+    totalLines: number;
+    codeLines: number;
+    commentLines: number;
+    blankLines: number;
+    commentRatio: number;
+    averageComplexity: number;
+    duplicatedCodeRatio: number;
+    testCoverage?: number;
+    documentationCoverage: number;
+}
+/**
+ * Comprehensive AI-powered code review
+ */
+export declare function reviewCode(options: CodeReviewOptions): Promise<CodeReviewResult>;
+export default reviewCode;
+//# sourceMappingURL=review.d.ts.map

package/dist/tools/review.d.ts.map

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