atlas-pipeline-mcp 1.0.19 → 1.0.20

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":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAsCrC;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAOlB;IACD;IAPD,EAAE,CAAS;IACX,IAAI,GAAiB,cAAc,CAAC;IACpC,SAAS,CAAS;IAC3B,cAAc,CAAS;IAEvB,YACW,QAAgB,EACjB,GAAc;QADb,aAAQ,GAAR,QAAQ,CAAQ;QACjB,QAAG,GAAH,GAAG,CAAW;QAEtB,IAAI,CAAC,EAAE,GAAG,OAAO,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAED,kDAAkD;IAClD,MAAM;QACJ,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,uCAAuC;IACvC,OAAO;QACL,oDAAoD;QACpD,OAAO,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC;IAC3B,CAAC;IAED,+BAA+B;IAC/B,KAAK,CAAC,OAAO;QACX,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,0BAA0B,CAAC,CAAC;QACtE,iEAAiE;QAChE,IAAI,CAAC,GAAe,GAAG,IAAI,CAAC;IAC/B,CAAC;CACF;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,eAAe;IAOP;IANX,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC/C,YAAY,GAA0C,IAAI,CAAC;IAC3D,gBAAgB,GAAsC,EAAE,CAAC;IACzD,cAAc,GAAG,KAAK,CAAC;IAE/B,YACmB,UAOb,EAAE;QAPW,YAAO,GAAP,OAAO,CAOlB;QAEN,MAAM,EACJ,iBAAiB,GAAG,KAAK,EAAE,WAAW;QACtC,aAAa,GAAG,MAAM,EAAE,YAAY;QACpC,YAAY,GAAG,GAAG,GACnB,GAAG,OAAO,CAAC;QAEZ,yBAAyB;QACzB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;YACnC,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;QACnD,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAEtB,4BAA4B;QAC5B,IAAI,CAAC,wBAAwB,EAAE,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAAyB;QAChC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YACxD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CACV,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAC7E,qBAAqB,CACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,EAAU;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAA4B,EAAU;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAkB,CAAC;QACzD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACrC,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,SAAS,CAA4B,IAAkB;QACrD,MAAM,OAAO,GAAQ,EAAE,CAAC;QACxB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;gBAC3B,OAAO,CAAC,IAAI,CAAC,QAAa,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAAC,aAAqB,EAAE,YAAoB;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,kBAAkB,GAAsB,EAAE,CAAC;QAEjD,4BAA4B;QAC5B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,GAAG,GAAG,QAAQ,CAAC,cAAc,CAAC;YAE/C,oCAAoC;YACpC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,QAAQ,GAAG,aAAa,EAAE,CAAC;gBACpD,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAED,gEAAgE;QAChE,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,YAAY,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;iBAC/C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;iBAC9C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC;YAEvD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,YAAY,CAAC;YAClD,kBAAkB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,oBAAoB;QACpB,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,KAAK,CACV,EAAE,KAAK,EAAE,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EACzE,6BAA6B,CAC9B,CAAC;YAEF,KAAK,MAAM,QAAQ,IAAI,kBAAkB,EAAE,CAAC;gBAC1C,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;gBACrC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe,CAAC,QAAyB;QACrD,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,qBAAqB,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CACV,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAC/C,4BAA4B,CAC7B,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAmC;QAC5C,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,4BAA4B,CAAC,CAAC;QAElF,qBAAqB;QACrB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,+BAA+B;QAC/B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,OAAO,EAAE,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,2BAA2B,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,wBAAwB;QACxB,MAAM,eAAe,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC3E,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAC/B,CAAC;QAEF,MAAM,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;QAC1C,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAEvB,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACK,wBAAwB;QAC9B,MAAM,OAAO,GAAqB,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAEnE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;gBACxB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,0BAA0B,CAAC,CAAC;gBACpD,IAAI,CAAC,QAAQ,EAAE;qBACZ,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;qBAC3B,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,uBAAuB,CAAC,CAAC;oBACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAClB,CAAC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;QACL,CAAC;QAED,yBAAyB;QACzB,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1C,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,oBAAoB,CAAC,CAAC;YAC9C,IAAI,CAAC,QAAQ,EAAE;iBACZ,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;iBAC3B,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;YAC5C,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,qBAAqB,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ,EAAE;iBACZ,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;iBAC3B,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ;QAKN,MAAM,MAAM,GAA0C,EAAE,CAAC;QACzD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACzD,MAAM,GAAG,GAAG,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC;YACrC,IAAI,GAAG,GAAG,SAAS,EAAE,CAAC;gBACpB,SAAS,GAAG,GAAG,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI;YAC1B,MAAM,EAAE,MAAsC;YAC9C,iBAAiB,EAAE,SAAS;SAC7B,CAAC;IACJ,CAAC;CACF;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,uCAAuC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,eAAe,CAAC;IACvD,iBAAiB,EAAE,KAAK,EAAE,WAAW;IACrC,aAAa,EAAE,MAAM,EAAE,YAAY;IACnC,YAAY,EAAE,GAAG;CAClB,CAAC,CAAC;AAEH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAA4B,EAC5B,OAA8C,EAC9C,OAIC;IAED,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAElD,MAAM,QAAQ,GAAG,MAAM,MAAM,EAAE,CAAC;IAEhC,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,eAAe,GAAoB;YACvC,EAAE;YACF,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,cAAc,EAAE,IAAI,CAAC,GAAG,EAAE;YAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;YAChC,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS;SAC3D,CAAC;QAEF,qBAAqB,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,EAAwB,EACxB,SAA4B;IAE5B,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,gCAAgC;QAChC,MAAM,OAAO,CAAC,UAAU,CACtB,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAChD,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,aAAa;IACP,SAAS,CAAS;IAC3B,QAAQ,GAAG,CAAC,CAAC;IAErB,YAAY,cAAsB,GAAG;QACnC,IAAI,CAAC,SAAS,GAAG,WAAW,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,mBAAmB;IACjE,CAAC;IAED;;OAEG;IACH,KAAK;QAOH,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,eAAe,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAExD,IAAI,eAAe,EAAE,CAAC;YACpB,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CACT;gBACE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,IAAI,CAAC;gBACpD,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;gBACtD,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;gBACrD,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,EACD,gCAAgC,CACjC,CAAC;QACJ,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,eAAe;SAChB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,MAAM,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC"}

package/dist/tools/test-utils.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Atlas Server - Testing Utilities and Fixtures
+ *
+ * Comprehensive testing infrastructure for all tools:
+ * - Mock data generators
+ * - Test fixtures and helpers
+ * - Performance benchmarking
+ * - Integration test utilities
+ * - Assertion helpers
+ *
+ * @module test-utils
+ * @version 1.0.0
+ */
+import type { IntentAnalysis, PipelineContext, GitContext, ProjectInfo, CodeSnippet, DecompositionResult, SolutionVariant, Critique } from '../types.js';
+/**
+ * Generate mock intent analysis for testing
+ */
+export declare function mockIntentAnalysis(overrides?: Partial<IntentAnalysis>): IntentAnalysis;
+/**
+ * Generate mock project info for testing
+ */
+export declare function mockProjectInfo(overrides?: Partial<ProjectInfo>): ProjectInfo;
+/**
+ * Generate mock git context for testing
+ */
+export declare function mockGitContext(overrides?: Partial<GitContext>): GitContext;
+/**
+ * Generate mock code snippet for testing
+ */
+export declare function mockCodeSnippet(overrides?: Partial<CodeSnippet>): CodeSnippet;
+/**
+ * Generate mock pipeline context for testing
+ */
+export declare function mockPipelineContext(overrides?: Partial<PipelineContext>): PipelineContext;
+/**
+ * Generate mock decomposition result for testing
+ */
+export declare function mockDecompositionResult(overrides?: Partial<DecompositionResult>): DecompositionResult;
+/**
+ * Generate mock solution variant for testing
+ */
+export declare function mockSolutionVariant(overrides?: Partial<SolutionVariant>): SolutionVariant;
+/**
+ * Generate mock critique for testing
+ */
+export declare function mockCritique(overrides?: Partial<Critique>): Critique;
+/**
+ * Measure async function execution time
+ */
+export declare function measureTime<T>(fn: () => Promise<T>): Promise<{
+    result: T;
+    durationMs: number;
+}>;
+/**
+ * Assert that a function throws with a specific message
+ */
+export declare function assertThrows(fn: () => Promise<unknown> | unknown, expectedMessage?: string | RegExp): Promise<Error>;
+/**
+ * Wait for a condition to be true
+ */
+export declare function waitFor(condition: () => boolean | Promise<boolean>, options?: {
+    timeout?: number;
+    interval?: number;
+}): Promise<void>;
+/**
+ * Create a spy function that tracks calls
+ */
+export declare function createSpy<T extends (...args: any[]) => any>(): {
+    spy: T;
+    calls: Array<{
+        args: Parameters<T>;
+        result?: ReturnType<T>;
+        error?: Error;
+    }>;
+    reset: () => void;
+};
+export interface BenchmarkResult {
+    name: string;
+    iterations: number;
+    totalMs: number;
+    avgMs: number;
+    minMs: number;
+    maxMs: number;
+    opsPerSecond: number;
+}
+/**
+ * Benchmark a function performance
+ */
+export declare function benchmark(name: string, fn: () => Promise<void> | void, iterations?: number): Promise<BenchmarkResult>;
+/**
+ * Compare multiple function implementations
+ */
+export declare function benchmarkCompare(tests: Array<{
+    name: string;
+    fn: () => Promise<void> | void;
+}>, iterations?: number): Promise<BenchmarkResult[]>;
+/**
+ * Print benchmark results to console
+ */
+export declare function printBenchmarkResults(results: BenchmarkResult[]): void;
+/**
+ * Create a temporary directory for testing
+ */
+export declare function createTempDir(): Promise<string>;
+/**
+ * Cleanup a temporary directory
+ */
+export declare function cleanupTempDir(dir: string): Promise<void>;
+/**
+ * Write test file to a directory
+ */
+export declare function writeTestFile(dir: string, filename: string, content: string): Promise<string>;
+/**
+ * Execute test with automatic cleanup
+ */
+export declare function withTestDir<T>(fn: (dir: string) => Promise<T>): Promise<T>;
+/**
+ * Assert that two values are deeply equal
+ */
+export declare function assertEqual<T>(actual: T, expected: T, message?: string): void;
+/**
+ * Assert that a value is truthy
+ */
+export declare function assertTrue(value: unknown, message?: string): void;
+/**
+ * Assert that a value is falsy
+ */
+export declare function assertFalse(value: unknown, message?: string): void;
+/**
+ * Assert that a value is defined (not null or undefined)
+ */
+export declare function assertDefined<T>(value: T | null | undefined, message?: string): asserts value is T;
+/**
+ * Assert that an array contains a value
+ */
+export declare function assertContains<T>(array: T[], value: T, message?: string): void;
+/**
+ * Assert that a number is within a range
+ */
+export declare function assertInRange(value: number, min: number, max: number, message?: string): void;
+/**
+ * Mock LLM provider for testing without actual API calls
+ */
+export declare class MockLLMProvider {
+    private responses;
+    callCount: number;
+    /**
+     * Set a mock response for a specific prompt pattern
+     */
+    setResponse(pattern: string | RegExp, response: unknown): void;
+    /**
+     * Mock complete method
+     */
+    complete(prompt: string): Promise<string>;
+    /**
+     * Mock completeJson method
+     */
+    completeJson<T>(prompt: string): Promise<{
+        data: T | null;
+    }>;
+    /**
+     * Reset the mock provider
+     */
+    reset(): void;
+}
+/**
+ * Example test suite demonstrating usage
+ */
+export declare function exampleTestSuite(): Promise<void>;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/tools/test-utils.d.ts.map

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