synapse-mcp 1.0.0 → 1.0.2

package/dist/services/container.js

@@ -1,18 +1,59 @@
-import { DockerService } from "./docker.js";
-import { SSHConnectionPoolImpl } from "./ssh-pool.js";
-import { SSHService } from "./ssh-service.js";
+import { EventEmitter } from "../events/index.js";
+import { getCurrentTimestamp } from "../utils/time.js";
 import { ComposeService } from "./compose.js";
+import { ComposeProjectCache } from "./compose-cache.js";
+import { ComposeDiscovery } from "./compose-discovery.js";
+import { ComposeProjectLister } from "./compose-project-lister.js";
+import { ComposeScanner } from "./compose-scanner.js";
+import { ContainerHostMapCache } from "./container-host-map-cache.js";
+import { DockerService } from "./docker/index.js";
 import { FileService } from "./file-service.js";
+import { HostConfigRepository } from "./host-config-repository.js";
+import { LocalExecutorService } from "./local-executor.js";
+import { SSHConnectionPoolImpl } from "./ssh-pool.js";
+import { SSHService } from "./ssh-service.js";
+/**
+ * Service lifecycle state
+ */
+export var LifecycleState;
+(function (LifecycleState) {
+    /** Container created but not initialized */
+    LifecycleState["CREATED"] = "created";
+    /** Initialization in progress */
+    LifecycleState["INITIALIZING"] = "initializing";
+    /** Fully initialized and ready */
+    LifecycleState["READY"] = "ready";
+    /** Shutdown initiated */
+    LifecycleState["SHUTTING_DOWN"] = "shutting_down";
+    /** Fully shut down */
+    LifecycleState["SHUTDOWN"] = "shutdown";
+})(LifecycleState || (LifecycleState = {}));
 /**
  * Service container for dependency injection.
  * Manages service lifecycle and dependencies.
  *
- * Dependency chain:
+ * Lifecycle phases:
+ * 1. CREATED - Container instantiated
+ * 2. INITIALIZING - Services being initialized (async setup)
+ * 3. READY - All services ready, accepting requests
+ * 4. SHUTTING_DOWN - Graceful shutdown in progress
+ * 5. SHUTDOWN - All services stopped
+ *
+ * Dependency chain (no circular dependencies):
+ * - EventEmitter (no dependencies) - application-wide event bus
+ * - LocalExecutorService (no dependencies)
  * - SSHConnectionPool (no dependencies)
+ * - HostConfigRepository (no dependencies)
  * - SSHService (requires SSHConnectionPool)
- * - ComposeService (requires SSHService)
+ * - ComposeProjectLister (requires SSHService, LocalExecutorService)
+ * - ComposeProjectCache (no dependencies)
+ * - ComposeScanner (requires SSHService, LocalExecutorService)
+ * - ComposeDiscovery (requires ComposeProjectLister, ComposeProjectCache, ComposeScanner)
+ * - ComposeService (requires SSHService, LocalExecutorService, ComposeDiscovery as IComposePathResolver)
  * - FileService (requires SSHService)
  * - DockerService (no dependencies)
+ * - HostConfigs (loaded once at startup with 60s TTL cache)
+ * - ContainerHostMapCache (no dependencies)
  */
 export class ServiceContainer {
     dockerService;
@@ -20,6 +61,18 @@ export class ServiceContainer {
     composeService;
     sshPool;
     fileService;
+    localExecutor;
+    composeProjectLister;
+    composeCache;
+    composeScanner;
+    composeDiscovery;
+    hostConfigRepository;
+    containerHostMapCache;
+    eventEmitter = new EventEmitter();
+    /** Current lifecycle state */
+    lifecycleState = LifecycleState.CREATED;
+    /** Shutdown timeout in milliseconds */
+    shutdownTimeout = 30000; // 30 seconds
     /**
      * Get Docker service instance (lazy initialization)
      */
@@ -63,11 +116,38 @@ export class ServiceContainer {
         this.sshService = service;
     }
     /**
-     * Get Compose service instance (lazy initialization with dependencies)
+     * Get Local executor service instance (lazy initialization)
+     */
+    getLocalExecutor() {
+        if (!this.localExecutor)
+            this.localExecutor = new LocalExecutorService();
+        return this.localExecutor;
+    }
+    /**
+     * Set Local executor service instance (for testing/overrides)
+     */
+    setLocalExecutor(service) {
+        this.localExecutor = service;
+    }
+    /**
+     * Get Compose project lister instance (lazy initialization).
+     * Standalone service for `docker compose ls` - used by ComposeDiscovery
+     * to break the former circular dependency.
+     */
+    getComposeProjectLister() {
+        if (!this.composeProjectLister) {
+            this.composeProjectLister = new ComposeProjectLister(this.getSSHService(), this.getLocalExecutor());
+        }
+        return this.composeProjectLister;
+    }
+    /**
+     * Get Compose service instance (lazy initialization with dependencies).
+     * ComposeDiscovery is injected as path resolver via constructor (no setter injection).
      */
     getComposeService() {
-        if (!this.composeService)
-            this.composeService = new ComposeService(this.getSSHService());
+        if (!this.composeService) {
+            this.composeService = new ComposeService(this.getSSHService(), this.getLocalExecutor(), this.getComposeDiscovery());
+        }
         return this.composeService;
     }
     /**
@@ -91,15 +171,310 @@ export class ServiceContainer {
         this.fileService = service;
     }
     /**
-     * Cleanup all services and close connections.
-     * Call during shutdown to ensure clean termination.
+     * Get Compose project cache instance (lazy initialization)
      */
-    async cleanup() {
+    getComposeCache() {
+        if (!this.composeCache) {
+            this.composeCache = new ComposeProjectCache();
+        }
+        return this.composeCache;
+    }
+    /**
+     * Get Compose scanner instance (lazy initialization with dependencies)
+     */
+    getComposeScanner() {
+        if (!this.composeScanner) {
+            this.composeScanner = new ComposeScanner(this.getSSHService(), this.getLocalExecutor());
+        }
+        return this.composeScanner;
+    }
+    /**
+     * Get Compose discovery instance (lazy initialization with dependencies).
+     * Uses ComposeProjectLister (not ComposeService) to avoid circular dependency.
+     * Dependency chain: ProjectLister -> Discovery -> ComposeService (linear, no cycle).
+     */
+    getComposeDiscovery() {
+        if (!this.composeDiscovery) {
+            this.composeDiscovery = new ComposeDiscovery(this.getComposeProjectLister(), this.getComposeCache(), this.getComposeScanner());
+        }
+        return this.composeDiscovery;
+    }
+    /**
+     * Get Host config repository instance (lazy initialization)
+     */
+    getHostConfigRepository() {
+        if (!this.hostConfigRepository) {
+            // Enable cache by default to avoid 5-50ms per-request file I/O
+            this.hostConfigRepository = new HostConfigRepository({ enableCache: true });
+        }
+        return this.hostConfigRepository;
+    }
+    /**
+     * Set Host config repository instance (for testing/overrides)
+     */
+    setHostConfigRepository(repository) {
+        this.hostConfigRepository = repository;
+    }
+    /**
+     * Get Container host map cache instance (lazy initialization)
+     */
+    getContainerHostMapCache() {
+        if (!this.containerHostMapCache)
+            this.containerHostMapCache = new ContainerHostMapCache();
+        return this.containerHostMapCache;
+    }
+    /**
+     * Set Container host map cache instance (for testing/overrides)
+     */
+    setContainerHostMapCache(cache) {
+        this.containerHostMapCache = cache;
+    }
+    /**
+     * Get EventEmitter instance (application-wide event bus).
+     * Use this to emit or subscribe to application events.
+     */
+    getEventEmitter() {
+        return this.eventEmitter;
+    }
+    /**
+     * Get current lifecycle state
+     */
+    getLifecycleState() {
+        return this.lifecycleState;
+    }
+    /**
+     * Check if container is ready to accept requests
+     */
+    isReady() {
+        return this.lifecycleState === LifecycleState.READY;
+    }
+    /**
+     * Initialize container and perform async service setup
+     *
+     * Performs:
+     * 1. Preload host configurations
+     * 2. Start SSH connection pool health checks
+     * 3. Emit lifecycle events
+     *
+     * @throws {Error} If already initialized or shutting down
+     *
+     * @example
+     * ```typescript
+     * const container = new ServiceContainer();
+     * await container.initialize();
+     * // Container is now ready to use
+     * ```
+     */
+    async initialize() {
+        if (this.lifecycleState !== LifecycleState.CREATED) {
+            throw new Error(`Cannot initialize: container is ${this.lifecycleState}. Must be in CREATED state.`);
+        }
+        this.lifecycleState = LifecycleState.INITIALIZING;
+        this.eventEmitter.emit({
+            type: "container_state_changed",
+            containerId: "service-container",
+            action: "start",
+            host: "local",
+            timestamp: getCurrentTimestamp(),
+        });
+        try {
+            // Preload host configurations (enables caching)
+            const hostRepo = this.getHostConfigRepository();
+            await hostRepo.loadHosts();
+            // SSH pool starts health checks automatically when first connection is created
+            // No explicit initialization needed
+            this.lifecycleState = LifecycleState.READY;
+            this.eventEmitter.emit({
+                type: "container_state_changed",
+                containerId: "service-container",
+                action: "start",
+                host: "local",
+                timestamp: getCurrentTimestamp(),
+            });
+        }
+        catch (error) {
+            this.lifecycleState = LifecycleState.CREATED; // Reset to created on failure
+            throw new Error(`Container initialization failed: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+        }
+    }
+    /**
+     * Perform health checks on all initialized services
+     *
+     * Returns health status for each service. Useful for monitoring
+     * and graceful degradation.
+     *
+     * @returns Array of service health statuses
+     *
+     * @example
+     * ```typescript
+     * const health = await container.healthCheck();
+     * const unhealthy = health.filter(h => !h.healthy);
+     * if (unhealthy.length > 0) {
+     *   console.error('Unhealthy services:', unhealthy);
+     * }
+     * ```
+     */
+    async healthCheck() {
+        const results = [];
+        // Check SSH connection pool
+        if (this.sshPool) {
+            const startTime = Date.now();
+            try {
+                const poolHealth = this.sshPool.getHealth();
+                results.push({
+                    name: "SSHConnectionPool",
+                    healthy: poolHealth.healthy,
+                    message: poolHealth.healthy ? undefined : "Pool unhealthy or has failed connections",
+                    responseTime: Date.now() - startTime,
+                });
+            }
+            catch (error) {
+                results.push({
+                    name: "SSHConnectionPool",
+                    healthy: false,
+                    message: error instanceof Error ? error.message : String(error),
+                    responseTime: Date.now() - startTime,
+                });
+            }
+        }
+        // Check host config repository (can it load hosts?)
+        if (this.hostConfigRepository) {
+            const startTime = Date.now();
+            try {
+                const hosts = await this.hostConfigRepository.loadHosts();
+                results.push({
+                    name: "HostConfigRepository",
+                    healthy: hosts.length > 0,
+                    message: hosts.length === 0 ? "No hosts configured" : undefined,
+                    responseTime: Date.now() - startTime,
+                });
+            }
+            catch (error) {
+                results.push({
+                    name: "HostConfigRepository",
+                    healthy: false,
+                    message: error instanceof Error ? error.message : String(error),
+                    responseTime: Date.now() - startTime,
+                });
+            }
+        }
+        // Check Docker service (is it instantiated?)
+        if (this.dockerService) {
+            results.push({
+                name: "DockerService",
+                healthy: true,
+                message: "Service instantiated",
+            });
+        }
+        // Check event emitter (listener count as health indicator)
+        const eventTypes = [
+            "cache_invalidated",
+            "container_state_changed",
+            "compose_operation",
+        ];
+        const listenerCount = eventTypes.reduce((sum, eventType) => sum + this.eventEmitter.listenerCount(eventType), 0);
+        results.push({
+            name: "EventEmitter",
+            healthy: true,
+            message: `${listenerCount} active listeners`,
+        });
+        return results;
+    }
+    /**
+     * Gracefully shut down container and all services
+     *
+     * Performs ordered shutdown:
+     * 1. Stop accepting new requests (set state to SHUTTING_DOWN)
+     * 2. Wait for in-flight operations (via timeout)
+     * 3. Close all connections
+     * 4. Clear caches
+     * 5. Emit shutdown complete event
+     *
+     * @param timeout - Maximum time to wait for graceful shutdown (ms)
+     * @throws {Error} If shutdown times out
+     *
+     * @example
+     * ```typescript
+     * // Graceful shutdown with 30s timeout
+     * await container.shutdown();
+     *
+     * // Custom timeout
+     * await container.shutdown(10000); // 10 seconds
+     * ```
+     */
+    async shutdown(timeout = this.shutdownTimeout) {
+        if (this.lifecycleState === LifecycleState.SHUTDOWN) {
+            return; // Already shut down
+        }
+        if (this.lifecycleState === LifecycleState.SHUTTING_DOWN) {
+            throw new Error("Shutdown already in progress");
+        }
+        this.lifecycleState = LifecycleState.SHUTTING_DOWN;
+        this.eventEmitter.emit({
+            type: "container_state_changed",
+            containerId: "service-container",
+            action: "stop",
+            host: "local",
+            timestamp: getCurrentTimestamp(),
+        });
+        let timeoutId;
+        try {
+            // Create timeout promise with clearable timer to prevent leaks
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutId = setTimeout(() => reject(new Error(`Shutdown timed out after ${timeout}ms`)), timeout);
+            });
+            // Perform cleanup with timeout (closes connections, clears caches)
+            await Promise.race([this.performCleanup(), timeoutPromise]);
+            this.lifecycleState = LifecycleState.SHUTDOWN;
+            // Emit final shutdown event BEFORE removing listeners so subscribers
+            // can observe the shutdown completion
+            this.eventEmitter.emit({
+                type: "container_state_changed",
+                containerId: "service-container",
+                action: "stop",
+                host: "local",
+                timestamp: getCurrentTimestamp(),
+            });
+            // Now safe to remove all listeners
+            this.eventEmitter.removeAllListeners();
+        }
+        catch (error) {
+            // Even if timeout occurs, mark as shutdown and clean up listeners
+            this.lifecycleState = LifecycleState.SHUTDOWN;
+            this.eventEmitter.removeAllListeners();
+            throw error;
+        }
+        finally {
+            // Clear the timeout timer to prevent leaks and unhandled rejections
+            if (timeoutId !== undefined)
+                clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Close connections and clear caches without removing event listeners.
+     * Used internally by shutdown() which handles listener cleanup after
+     * emitting the final shutdown event.
+     */
+    async performCleanup() {
         if (this.sshPool)
             await this.sshPool.closeAll();
         if (this.dockerService) {
             this.dockerService.clearClients();
         }
+        if (this.hostConfigRepository) {
+            this.hostConfigRepository.clearCache();
+        }
+    }
+    /**
+     * Cleanup all services and close connections.
+     * Call during shutdown to ensure clean termination.
+     *
+     * @deprecated Use shutdown() for graceful shutdown with timeout.
+     * This method is kept for backward compatibility but performs immediate cleanup.
+     */
+    async cleanup() {
+        await this.performCleanup();
+        this.eventEmitter.removeAllListeners();
     }
 }
 /**

package/dist/services/container.js.map

@@ -1 +1 @@
-{"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/services/container.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,gBAAgB;IACnB,aAAa,CAAkB;IAC/B,UAAU,CAAe;IACzB,cAAc,CAAmB;IACjC,OAAO,CAAsB;IAC7B,WAAW,CAAgB;IAEnC;;OAEG;IACH,gBAAgB;QACd,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;QAClE,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAAuB;QACtC,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,IAAI,CAAC,OAAO,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAC9D,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,oBAAoB,CAAC,IAAwB;QAC3C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;QACpF,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAoB;QAChC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,CAAC,IAAI,CAAC,cAAc;YAAE,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACzF,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAAwB;QACxC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QAChF,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,OAAqB;QAClC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAChD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,gBAAgB,EAAE,CAAC;AAChC,CAAC"}
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/services/container.ts"],"names":[],"mappings":"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"}

package/dist/services/diagnostics.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Diagnostic checks for host health monitoring
+ *
+ * Provides actionable health checks for Docker hosts:
+ * - Resources: CPU/memory/disk thresholds
+ * - Containers: Exited/unhealthy container detection
+ * - Logs: Recent error pattern scanning
+ * - Processes: Zombie/defunct process detection
+ * - Docker: Daemon health verification
+ * - Network: Connectivity testing
+ */
+import type { HostConfig } from "../types.js";
+import type { ISSHService, IDockerService } from "./interfaces.js";
+/**
+ * Diagnostic check status
+ */
+export type DiagnosticStatus = "pass" | "warn" | "fail";
+/**
+ * Result of a diagnostic check
+ */
+export interface DiagnosticCheckResult {
+    status: DiagnosticStatus;
+    message: string;
+    details?: string;
+    recommendations?: string;
+}
+/**
+ * Check host resources (CPU, memory, disk)
+ * Warns if any resource exceeds 80% usage
+ */
+export declare function checkResources(host: HostConfig, sshService: ISSHService): Promise<DiagnosticCheckResult>;
+/**
+ * Check container health
+ * Finds exited or unhealthy containers
+ */
+export declare function checkContainers(host: HostConfig, dockerService: IDockerService): Promise<DiagnosticCheckResult>;
+/**
+ * Check system logs for error patterns
+ * Scans journalctl for recent errors/warnings
+ */
+export declare function checkLogs(host: HostConfig, sshService: ISSHService): Promise<DiagnosticCheckResult>;
+/**
+ * Check for zombie or defunct processes
+ * Detects processes that failed to clean up properly
+ */
+export declare function checkProcesses(host: HostConfig, sshService: ISSHService): Promise<DiagnosticCheckResult>;
+/**
+ * Check Docker daemon health
+ * Verifies Docker API connectivity and version
+ */
+export declare function checkDocker(host: HostConfig, dockerService: IDockerService): Promise<DiagnosticCheckResult>;
+/**
+ * Check network connectivity
+ * Tests external connectivity and measures latency
+ */
+export declare function checkNetwork(host: HostConfig, sshService: ISSHService): Promise<DiagnosticCheckResult>;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/services/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/services/diagnostics.ts"],"names":[],"mappings":"AACA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGnE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,WAAW,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAoDhC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,cAAc,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAsDhC;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,WAAW,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA4ChC;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,WAAW,GACtB,OAAO,CAAC,qBAAqB,CAAC,CA0ChC;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,UAAU,EAChB,aAAa,EAAE,cAAc,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAuBhC;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,UAAU,EAChB,UAAU,EAAE,WAAW,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAqChC"}