synapse-mcp 1.0.0 → 1.0.2

package/dist/constants.d.ts

@@ -5,19 +5,25 @@ export declare const DEFAULT_LOG_LINES = 50;
 export declare const MAX_LOG_LINES = 500;
 export declare const API_TIMEOUT = 30000;
 export declare const STATS_TIMEOUT = 5000;
+export declare const DEFAULT_COMPOSE_SCAN_CONCURRENCY = 10;
+export declare const DEFAULT_CONTAINER_MAP_CONCURRENCY = 5;
+export declare const PROGRESS_LOG_HOST_THRESHOLD = 5;
+export declare const PROGRESS_LOG_CONTAINER_THRESHOLD = 50;
 export declare const DEFAULT_DOCKER_SOCKET = "/var/run/docker.sock";
-export declare const ENV_HOSTS_CONFIG = "HOMELAB_HOSTS_CONFIG";
-export declare const ENV_DEFAULT_HOST = "HOMELAB_DEFAULT_HOST";
+export declare const ENV_HOSTS_CONFIG = "SYNAPSE_HOSTS_CONFIG";
+export declare const ENV_DEFAULT_HOST = "SYNAPSE_DEFAULT_HOST";
 export declare const DEFAULT_MAX_FILE_SIZE = 1048576;
 export declare const MAX_FILE_SIZE_LIMIT = 10485760;
 export declare const DEFAULT_COMMAND_TIMEOUT = 30000;
 export declare const MAX_COMMAND_TIMEOUT = 300000;
+export declare const DEFAULT_EXEC_TIMEOUT = 30000;
+export declare const MAX_EXEC_TIMEOUT = 300000;
+export declare const DEFAULT_EXEC_MAX_BUFFER = 10485760;
 export declare const DEFAULT_TREE_DEPTH = 3;
 export declare const MAX_TREE_DEPTH = 10;
 export declare const DEFAULT_FIND_LIMIT = 100;
 export declare const MAX_FIND_LIMIT = 1000;
 export declare const DEFAULT_DIFF_CONTEXT_LINES = 3;
 export declare const MAX_DIFF_CONTEXT_LINES = 50;
-export declare const ALLOWED_COMMANDS: Set<string>;
-export declare const ENV_ALLOW_ANY_COMMAND = "HOMELAB_ALLOW_ANY_COMMAND";
+export declare const ALLOWED_COMMANDS: ReadonlySet<string>;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe,QAAQ,CAAC;AAGrC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,SAAS,MAAM,CAAC;AAG7B,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,aAAa,MAAM,CAAC;AAGjC,eAAO,MAAM,WAAW,QAAQ,CAAC;AACjC,eAAO,MAAM,aAAa,OAAO,CAAC;AAGlC,eAAO,MAAM,qBAAqB,yBAAyB,CAAC;AAG5D,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAKvD,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAC7C,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAG5C,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAC7C,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAG1C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,cAAc,KAAK,CAAC;AAGjC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,cAAc,OAAO,CAAC;AAGnC,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAGzC,eAAO,MAAM,gBAAgB,aAqB3B,CAAC;AAGH,eAAO,MAAM,qBAAqB,8BAA8B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,eAAe,QAAQ,CAAC;AAGrC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,SAAS,MAAM,CAAC;AAG7B,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,aAAa,MAAM,CAAC;AAGjC,eAAO,MAAM,WAAW,QAAQ,CAAC;AACjC,eAAO,MAAM,aAAa,OAAO,CAAC;AAGlC,eAAO,MAAM,gCAAgC,KAAK,CAAC;AACnD,eAAO,MAAM,iCAAiC,IAAI,CAAC;AAGnD,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAC7C,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAGnD,eAAO,MAAM,qBAAqB,yBAAyB,CAAC;AAG5D,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAKvD,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAC7C,eAAO,MAAM,mBAAmB,WAAW,CAAC;AAG5C,eAAO,MAAM,uBAAuB,QAAQ,CAAC;AAC7C,eAAO,MAAM,mBAAmB,SAAS,CAAC;AAG1C,eAAO,MAAM,oBAAoB,QAAQ,CAAC;AAC1C,eAAO,MAAM,gBAAgB,SAAS,CAAC;AAGvC,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAGhD,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,cAAc,KAAK,CAAC;AAGjC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,cAAc,OAAO,CAAC;AAGnC,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAC5C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAIzC,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAuBhD,CAAC"}

package/dist/constants.js

@@ -9,11 +9,17 @@ export const MAX_LOG_LINES = 500;
 // Timeout settings (ms)
 export const API_TIMEOUT = 30000;
 export const STATS_TIMEOUT = 5000;
+// Concurrency limits for batch operations
+export const DEFAULT_COMPOSE_SCAN_CONCURRENCY = 10; // Max concurrent compose file parsing operations
+export const DEFAULT_CONTAINER_MAP_CONCURRENCY = 5; // Max concurrent container host mapping operations
+// Progress logging thresholds
+export const PROGRESS_LOG_HOST_THRESHOLD = 5; // Log when querying >= 5 hosts
+export const PROGRESS_LOG_CONTAINER_THRESHOLD = 50; // Log when processing >= 50 containers
 // Default Docker socket path
 export const DEFAULT_DOCKER_SOCKET = "/var/run/docker.sock";
 // Environment variable names for config
-export const ENV_HOSTS_CONFIG = "HOMELAB_HOSTS_CONFIG";
-export const ENV_DEFAULT_HOST = "HOMELAB_DEFAULT_HOST";
+export const ENV_HOSTS_CONFIG = "SYNAPSE_HOSTS_CONFIG";
+export const ENV_DEFAULT_HOST = "SYNAPSE_DEFAULT_HOST";
 // ===== Scout File Operations Constants =====
 // File size limits (bytes)
 export const DEFAULT_MAX_FILE_SIZE = 1048576; // 1MB
@@ -21,6 +27,11 @@ export const MAX_FILE_SIZE_LIMIT = 10485760; // 10MB
 // Command timeout limits (milliseconds)
 export const DEFAULT_COMMAND_TIMEOUT = 30000; // 30s
 export const MAX_COMMAND_TIMEOUT = 300000; // 300s (5 min)
+// Container exec timeout limits (milliseconds)
+export const DEFAULT_EXEC_TIMEOUT = 30000; // 30s
+export const MAX_EXEC_TIMEOUT = 300000; // 300s (5 min)
+// Container exec buffer limits (bytes)
+export const DEFAULT_EXEC_MAX_BUFFER = 10485760; // 10MB per stream
 // Tree depth limits
 export const DEFAULT_TREE_DEPTH = 3;
 export const MAX_TREE_DEPTH = 10;
@@ -30,8 +41,9 @@ export const MAX_FIND_LIMIT = 1000;
 // Diff context lines limits
 export const DEFAULT_DIFF_CONTEXT_LINES = 3;
 export const MAX_DIFF_CONTEXT_LINES = 50;
-// Allowed commands for exec subaction (read-only operations)
-export const ALLOWED_COMMANDS = new Set([
+// SECURITY (CWE-284): Immutable command allowlist for exec subaction (read-only operations)
+// Object.freeze prevents runtime modification of the allowlist
+export const ALLOWED_COMMANDS = Object.freeze(new Set([
     "cat",
     "head",
     "tail",
@@ -51,8 +63,6 @@ export const ALLOWED_COMMANDS = new Set([
     "pwd",
     "hostname",
     "uptime",
-    "whoami"
-]);
-// Environment variable to disable command allowlist
-export const ENV_ALLOW_ANY_COMMAND = "HOMELAB_ALLOW_ANY_COMMAND";
+    "whoami",
+]));
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,8BAA8B;AAC9B,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAE7B,yBAAyB;AACzB,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,wBAAwB;AACxB,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AACjC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAElC,6BAA6B;AAC7B,MAAM,CAAC,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AAE5D,wCAAwC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,8CAA8C;AAE9C,2BAA2B;AAC3B,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC,CAAC,MAAM;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,CAAC,OAAO;AAEpD,wCAAwC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC,CAAC,MAAM;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,CAAC,eAAe;AAE1D,oBAAoB;AACpB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,qBAAqB;AACrB,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,4BAA4B;AAC5B,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IACtC,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,UAAU;IACV,QAAQ;IACR,QAAQ;CACT,CAAC,CAAC;AAEH,oDAAoD;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,2BAA2B,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AAErC,8BAA8B;AAC9B,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAE7B,yBAAyB;AACzB,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AAEjC,wBAAwB;AACxB,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAC;AACjC,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC;AAElC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,CAAC,CAAC,iDAAiD;AACrG,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,CAAC,mDAAmD;AAEvG,8BAA8B;AAC9B,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,CAAC,+BAA+B;AAC7E,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,CAAC,CAAC,uCAAuC;AAE3F,6BAA6B;AAC7B,MAAM,CAAC,MAAM,qBAAqB,GAAG,sBAAsB,CAAC;AAE5D,wCAAwC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AACvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,8CAA8C;AAE9C,2BAA2B;AAC3B,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC,CAAC,MAAM;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC,CAAC,OAAO;AAEpD,wCAAwC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,CAAC,CAAC,MAAM;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,CAAC,eAAe;AAE1D,+CAA+C;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC,CAAC,MAAM;AACjD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,CAAC,eAAe;AAEvD,uCAAuC;AACvC,MAAM,CAAC,MAAM,uBAAuB,GAAG,QAAQ,CAAC,CAAC,kBAAkB;AAEnE,oBAAoB;AACpB,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC,qBAAqB;AACrB,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,4BAA4B;AAC5B,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,4FAA4F;AAC5F,+DAA+D;AAC/D,MAAM,CAAC,MAAM,gBAAgB,GAAwB,MAAM,CAAC,MAAM,CAChE,IAAI,GAAG,CAAC;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,UAAU;IACV,QAAQ;IACR,QAAQ;CACT,CAAC,CACH,CAAC"}

package/dist/events/emitter.d.ts

@@ -0,0 +1,63 @@
+import type { ApplicationEvent, EventListener, EventType } from "./types.js";
+/**
+ * Lightweight type-safe event emitter for application events.
+ *
+ * Provides pub-sub pattern for cross-cutting concerns:
+ * - Cache invalidation coordination
+ * - Audit logging for destructive operations
+ * - Metrics collection
+ * - Event-driven side effects
+ *
+ * @example
+ * ```typescript
+ * const emitter = new EventEmitter();
+ *
+ * // Subscribe to specific event type
+ * emitter.on("cache_invalidated", (event) => {
+ *   console.log(`Cache ${event.cache} invalidated: ${event.reason}`);
+ * });
+ *
+ * // Emit event
+ * emitter.emit({
+ *   type: "cache_invalidated",
+ *   cache: "container_host_map",
+ *   reason: "Container state changed",
+ *   timestamp: new Date().toISOString()
+ * });
+ * ```
+ */
+export declare class EventEmitter {
+    private listeners;
+    /**
+     * Subscribe to specific event type
+     * @param eventType - Event type to listen for
+     * @param listener - Callback function to execute when event occurs
+     * @returns Unsubscribe function
+     */
+    on<T extends ApplicationEvent>(eventType: T["type"], listener: EventListener<T>): () => void;
+    /**
+     * Subscribe to event type, auto-unsubscribe after first occurrence
+     * @param eventType - Event type to listen for
+     * @param listener - Callback function to execute once
+     * @returns Unsubscribe function
+     */
+    once<T extends ApplicationEvent>(eventType: T["type"], listener: EventListener<T>): () => void;
+    /**
+     * Emit event to all registered listeners for that event type
+     * Listeners are called asynchronously but errors are caught and logged
+     * @param event - Event payload to emit
+     */
+    emit(event: ApplicationEvent): void;
+    /**
+     * Remove all listeners for specific event type, or all listeners if no type specified
+     * @param eventType - Optional event type to clear listeners for
+     */
+    removeAllListeners(eventType?: EventType): void;
+    /**
+     * Get count of listeners for specific event type
+     * @param eventType - Event type to count listeners for
+     * @returns Number of registered listeners
+     */
+    listenerCount(eventType: EventType): number;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/events/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../src/events/emitter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAiD;IAElE;;;;;OAKG;IACH,EAAE,CAAC,CAAC,SAAS,gBAAgB,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAmB5F;;;;;OAKG;IACH,IAAI,CAAC,CAAC,SAAS,gBAAgB,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAa9F;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAenC;;;OAGG;IACH,kBAAkB,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI;IAQ/C;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM;CAG5C"}

package/dist/events/emitter.js

@@ -0,0 +1,112 @@
+// src/events/emitter.ts
+import { logError } from "../utils/errors.js";
+/**
+ * Lightweight type-safe event emitter for application events.
+ *
+ * Provides pub-sub pattern for cross-cutting concerns:
+ * - Cache invalidation coordination
+ * - Audit logging for destructive operations
+ * - Metrics collection
+ * - Event-driven side effects
+ *
+ * @example
+ * ```typescript
+ * const emitter = new EventEmitter();
+ *
+ * // Subscribe to specific event type
+ * emitter.on("cache_invalidated", (event) => {
+ *   console.log(`Cache ${event.cache} invalidated: ${event.reason}`);
+ * });
+ *
+ * // Emit event
+ * emitter.emit({
+ *   type: "cache_invalidated",
+ *   cache: "container_host_map",
+ *   reason: "Container state changed",
+ *   timestamp: new Date().toISOString()
+ * });
+ * ```
+ */
+export class EventEmitter {
+    listeners = new Map();
+    /**
+     * Subscribe to specific event type
+     * @param eventType - Event type to listen for
+     * @param listener - Callback function to execute when event occurs
+     * @returns Unsubscribe function
+     */
+    on(eventType, listener) {
+        if (!this.listeners.has(eventType)) {
+            this.listeners.set(eventType, new Set());
+        }
+        const listenerSet = this.listeners.get(eventType);
+        // Cast is safe: we partition listeners by eventType, so when emitting
+        // we only call listeners registered for that specific event type.
+        const wrappedListener = (event) => listener(event);
+        if (listenerSet) {
+            listenerSet.add(wrappedListener);
+        }
+        // Return unsubscribe function
+        return () => {
+            this.listeners.get(eventType)?.delete(wrappedListener);
+        };
+    }
+    /**
+     * Subscribe to event type, auto-unsubscribe after first occurrence
+     * @param eventType - Event type to listen for
+     * @param listener - Callback function to execute once
+     * @returns Unsubscribe function
+     */
+    once(eventType, listener) {
+        let called = false;
+        const wrappedListener = (event) => {
+            if (called)
+                return;
+            called = true;
+            unsubscribe();
+            return listener(event);
+        };
+        const unsubscribe = this.on(eventType, wrappedListener);
+        return unsubscribe;
+    }
+    /**
+     * Emit event to all registered listeners for that event type
+     * Listeners are called asynchronously but errors are caught and logged
+     * @param event - Event payload to emit
+     */
+    emit(event) {
+        const listeners = this.listeners.get(event.type);
+        if (!listeners || listeners.size === 0)
+            return;
+        // Execute all listeners asynchronously
+        // Errors in listeners don't block other listeners or the emitter
+        for (const listener of listeners) {
+            Promise.resolve()
+                .then(() => listener(event))
+                .catch((error) => {
+                logError(error, { operation: `EventEmitter:${event.type}` });
+            });
+        }
+    }
+    /**
+     * Remove all listeners for specific event type, or all listeners if no type specified
+     * @param eventType - Optional event type to clear listeners for
+     */
+    removeAllListeners(eventType) {
+        if (eventType) {
+            this.listeners.delete(eventType);
+        }
+        else {
+            this.listeners.clear();
+        }
+    }
+    /**
+     * Get count of listeners for specific event type
+     * @param eventType - Event type to count listeners for
+     * @returns Number of registered listeners
+     */
+    listenerCount(eventType) {
+        return this.listeners.get(eventType)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=emitter.js.map

package/dist/events/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../../src/events/emitter.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,YAAY;IACf,SAAS,GAAuC,IAAI,GAAG,EAAE,CAAC;IAElE;;;;;OAKG;IACH,EAAE,CAA6B,SAAoB,EAAE,QAA0B;QAC7E,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAClD,sEAAsE;QACtE,kEAAkE;QAClE,MAAM,eAAe,GAAkB,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAU,CAAC,CAAC;QACvE,IAAI,WAAW,EAAE,CAAC;YAChB,WAAW,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QACnC,CAAC;QAED,8BAA8B;QAC9B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;QACzD,CAAC,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAA6B,SAAoB,EAAE,QAA0B;QAC/E,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,MAAM,eAAe,GAAqB,CAAC,KAAK,EAAE,EAAE;YAClD,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,WAAW,EAAE,CAAC;YACd,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,CAAC;QAEF,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QACxD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,KAAuB;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE/C,uCAAuC;QACvC,iEAAiE;QACjE,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,OAAO,CAAC,OAAO,EAAE;iBACd,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;iBAC3B,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACf,QAAQ,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,gBAAgB,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,kBAAkB,CAAC,SAAqB;QACtC,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,SAAoB;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/events/index.d.ts

@@ -0,0 +1,3 @@
+export { EventEmitter } from "./emitter.js";
+export type { ApplicationEvent, CacheInvalidatedEvent, ComposeOperationEvent, ContainerStateChangedEvent, DestructiveOperationEvent, EventListener, EventType, ImageOperationEvent, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,aAAa,EACb,SAAS,EACT,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,3 @@
+// src/events/index.ts
+export { EventEmitter } from "./emitter.js";
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/events/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Event payload types for application events
+ */
+export interface CacheInvalidatedEvent {
+    type: "cache_invalidated";
+    cache: "container_host_map" | "compose_project" | "host_config";
+    reason: string;
+    timestamp: string;
+}
+export interface ContainerStateChangedEvent {
+    type: "container_state_changed";
+    containerId: string;
+    action: "start" | "stop" | "restart" | "pause" | "unpause" | "remove";
+    host: string;
+    timestamp: string;
+}
+export interface ComposeOperationEvent {
+    type: "compose_operation";
+    operation: "up" | "down" | "restart" | "build" | "pull" | "recreate";
+    project: string;
+    host: string;
+    timestamp: string;
+}
+export interface DestructiveOperationEvent {
+    type: "destructive_operation";
+    operation: string;
+    target: string;
+    host: string;
+    confirmed: boolean;
+    timestamp: string;
+}
+export interface ImageOperationEvent {
+    type: "image_operation";
+    operation: "pull" | "build" | "remove" | "prune";
+    image?: string;
+    host: string;
+    timestamp: string;
+}
+/**
+ * Union type of all application events
+ */
+export type ApplicationEvent = CacheInvalidatedEvent | ContainerStateChangedEvent | ComposeOperationEvent | DestructiveOperationEvent | ImageOperationEvent;
+/**
+ * Event listener function type
+ */
+export type EventListener<T extends ApplicationEvent = ApplicationEvent> = (event: T) => void | Promise<void>;
+/**
+ * Event type discriminator for type-safe filtering
+ */
+export type EventType = ApplicationEvent["type"];
+//# sourceMappingURL=types.d.ts.map

package/dist/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,KAAK,EAAE,oBAAoB,GAAG,iBAAiB,GAAG,aAAa,CAAC;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,yBAAyB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,qBAAqB,GACrB,0BAA0B,GAC1B,qBAAqB,GACrB,yBAAyB,GACzB,mBAAmB,CAAC;AAExB;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,CACzE,KAAK,EAAE,CAAC,KACL,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC"}

package/dist/events/types.js

@@ -0,0 +1,3 @@
+// src/events/types.ts
+export {};
+//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAAA,sBAAsB"}

package/dist/formatters/compose.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Docker Compose formatting utilities
+ *
+ * Provides consistent markdown formatting for Compose project
+ * listing and status display.
+ * Follows docs/STYLE.md canonical output templates.
+ */
+import type { ComposeProject } from "../types.js";
+/**
+ * Format compose project list as markdown following STYLE.md section 7.4
+ */
+export declare function formatComposeListMarkdown(projects: ComposeProject[], host: string, total?: number, offset?: number, hasMore?: boolean, filters?: Record<string, string | number | boolean>): string;
+/**
+ * Format compose up operation result.
+ *
+ * Follows STYLE.md sections:
+ * - 3.1: Title format "Operation for project on host"
+ * - 3.2: Summary line with service count
+ * - 4.1: Canonical ● symbol for active services
+ *
+ * @example
+ * formatComposeUpMarkdown(project, "host1", { servicesStarted: 3 })
+ * // Returns:
+ * // Compose Up for myapp on host1
+ * // Services started: 3
+ * //
+ * // ● myapp (3 services)
+ */
+export declare function formatComposeUpMarkdown(projectData: ComposeProject, host: string, options: {
+    servicesStarted: number;
+}): string;
+/**
+ * Format compose project status as markdown following STYLE.md section 8.3
+ */
+export declare function formatComposeStatusMarkdown(project: ComposeProject, totalServices?: number, offset?: number, hasMore?: boolean): string;
+/**
+ * Format compose down operation result.
+ *
+ * Follows STYLE.md sections:
+ * - 3.1: Title format "Operation for project on host"
+ * - 3.2: Summary line with counts
+ * - 4.1: Canonical ○ symbol for stopped services
+ *
+ * @example
+ * formatComposeDownMarkdown(project, "host1", { servicesStopped: 3, volumesRemoved: 2 })
+ * // Returns:
+ * // Compose Down for myapp on host1
+ * // Services stopped: 3 | Volumes removed: 2
+ * //
+ * // ○ myapp (3 services stopped)
+ */
+export declare function formatComposeDownMarkdown(projectData: ComposeProject, host: string, options: {
+    servicesStopped: number;
+    volumesRemoved?: number;
+}): string;
+/**
+ * Format compose restart operation result.
+ *
+ * Follows STYLE.md sections:
+ * - 3.1: Title format "Operation for project on host"
+ * - 3.2: Summary line with count
+ * - 4.1: Canonical ◐ symbol for restarting services
+ *
+ * @example
+ * formatComposeRestartMarkdown(project, "host1", { servicesRestarted: 3 })
+ * // Returns:
+ * // Compose Restart for myapp on host1
+ * // Services restarted: 3
+ * //
+ * // ◐ myapp (3 services restarted)
+ */
+export declare function formatComposeRestartMarkdown(projectData: ComposeProject, host: string, options: {
+    servicesRestarted: number;
+}): string;
+/**
+ * Format compose recreate operation result.
+ *
+ * Follows STYLE.md sections:
+ * - 3.1: Title format "Operation for project on host"
+ * - 3.2: Summary line with count
+ * - 4.1: Canonical ● symbol (recreated = running)
+ *
+ * @example
+ * formatComposeRecreateMarkdown(project, "host1", { servicesRecreated: 3 })
+ * // Returns:
+ * // Compose Recreate for myapp on host1
+ * // Services recreated: 3
+ * //
+ * // ● myapp (3 services recreated)
+ */
+export declare function formatComposeRecreateMarkdown(projectData: ComposeProject, host: string, options: {
+    servicesRecreated: number;
+}): string;
+/**
+ * Format compose pull operation result.
+ *
+ * Follows STYLE.md sections:
+ * - 3.1: Title format "Operation for project on host"
+ * - 3.2: Summary with counts (conditional parts)
+ * - 4.1: Canonical ✓ symbol for success
+ *
+ * @example
+ * formatComposePullMarkdown(project, "host1", { imagesPulled: 2, imagesUpToDate: 1 })
+ * // Returns:
+ * // Compose Pull for myapp on host1
+ * // Images pulled: 2 | Up-to-date: 1
+ * //
+ * // ✓ myapp (2 images updated, 1 already current)
+ */
+export declare function formatComposePullMarkdown(projectData: ComposeProject, host: string, options: {
+    imagesPulled: number;
+    imagesUpToDate: number;
+}): string;
+/**
+ * Format compose build operation result.
+ *
+ * Follows STYLE.md sections:
+ * - 3.1: Title format "Operation for project on host"
+ * - 3.2: Summary with counts and optional duration
+ * - 4.1: Canonical ✓ symbol for success
+ *
+ * @example
+ * formatComposeBuildMarkdown(project, "host1", { servicesBuilt: 2, duration: 45 })
+ * // Returns:
+ * // Compose Build for myapp on host1
+ * // Services built: 2 | Duration: 45s
+ * //
+ * // ✓ myapp (2 services built in 45s)
+ */
+export declare function formatComposeBuildMarkdown(projectData: ComposeProject, host: string, options: {
+    servicesBuilt: number;
+    duration?: number;
+}): string;
+/**
+ * Format compose logs operation result.
+ *
+ * Follows STYLE.md sections:
+ * - 3.1: Title format "Container Logs for project on host"
+ * - 3.2: Summary with counts and flags
+ * - 7.5: Preview format (first 5 + last 5) for outputs >10 lines
+ * - 4.1: Stream labels [stdout]/[stderr]
+ *
+ * @example
+ * formatComposeLogsMarkdown(project, "host1", {
+ *   logs: [{ stream: 'stdout', message: 'line 1' }],
+ *   requested: 10,
+ *   truncated: false,
+ *   follow: false
+ * })
+ * // Returns:
+ * // Container Logs for myapp on host1
+ * // Lines returned: 1 (requested: 10) | truncated: no | follow: no
+ * //
+ * //   [stdout] line 1
+ */
+export declare function formatComposeLogsMarkdown(projectData: ComposeProject, host: string, options: {
+    logs: Array<{
+        stream: "stdout" | "stderr";
+        message: string;
+    }>;
+    requested: number;
+    truncated: boolean;
+    follow: boolean;
+}): string;
+/**
+ * Format compose refresh/discovery operation result.
+ *
+ * Follows STYLE.md sections:
+ * - 3.1: Title format "Operation on host"
+ * - 3.2: Summary with counts
+ * - 4.1: Canonical ✓ symbol for success
+ *
+ * @example
+ * formatComposeRefreshMarkdown("host1", { discovered: 2, updated: 1 })
+ * // Returns:
+ * // Compose Refresh on host1
+ * // Discovered: 2 | Updated: 1
+ * //
+ * // ✓ Compose projects refreshed (2 discovered, 1 updated)
+ */
+export declare function formatComposeRefreshMarkdown(host: string, options: {
+    discovered: number;
+    updated: number;
+}): string;
+//# sourceMappingURL=compose.d.ts.map

package/dist/formatters/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/formatters/compose.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAkBlD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,cAAc,EAAE,EAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAClD,MAAM,CAuFR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GACnC,MAAM,CAYR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,cAAc,EACvB,aAAa,CAAC,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,CAyER;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,MAAM,CAiBR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,iBAAiB,EAAE,MAAM,CAAA;CAAE,GACrC,MAAM,CAYR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,iBAAiB,EAAE,MAAM,CAAA;CAAE,GACrC,MAAM,CAYR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACxD,MAAM,CAoBR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,MAAM,CAqBR;AAKD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,cAAc,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,IAAI,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB,GACA,MAAM,CA2BR;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/C,MAAM,CAYR"}