lattice-orchestrator 0.7.0

package/dist/services/infrastructure/logger.js

@@ -0,0 +1,215 @@
+import pino from 'pino';
+import { PassThrough } from 'stream';
+import { LogFormatter } from './log-formatter.js';
+export class CUILogger {
+    pinoLogger;
+    constructor(pinoLogger) {
+        this.pinoLogger = pinoLogger;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    debug(message, context) {
+        if (context !== undefined) {
+            this.pinoLogger.debug(context, message);
+        }
+        else {
+            this.pinoLogger.debug(message);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    info(message, context) {
+        if (context !== undefined) {
+            this.pinoLogger.info(context, message);
+        }
+        else {
+            this.pinoLogger.info(message);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    warn(message, context) {
+        if (context !== undefined) {
+            this.pinoLogger.warn(context, message);
+        }
+        else {
+            this.pinoLogger.warn(message);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    error(message, error, context) {
+        if (error instanceof Error) {
+            const logData = { err: error, ...context };
+            this.pinoLogger.error(logData, message);
+        }
+        else if (error !== undefined && context !== undefined) {
+            // error is actually context, context is extra data
+            const logData = { ...error, ...context };
+            this.pinoLogger.error(logData, message);
+        }
+        else if (error !== undefined) {
+            // error is context
+            this.pinoLogger.error(error, message);
+        }
+        else {
+            this.pinoLogger.error(message);
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    fatal(message, error, context) {
+        if (error instanceof Error) {
+            const logData = { err: error, ...context };
+            this.pinoLogger.fatal(logData, message);
+        }
+        else if (error !== undefined && context !== undefined) {
+            // error is actually context, context is extra data
+            const logData = { ...error, ...context };
+            this.pinoLogger.fatal(logData, message);
+        }
+        else if (error !== undefined) {
+            // error is context
+            this.pinoLogger.fatal(error, message);
+        }
+        else {
+            this.pinoLogger.fatal(message);
+        }
+    }
+    // Support for creating child loggers
+    child(context) {
+        return new CUILogger(this.pinoLogger.child(context));
+    }
+}
+/**
+ * Centralized logger service using Pino
+ * Provides consistent logging across all CUI components
+ * Log level is controlled by LOG_LEVEL environment variable
+ */
+class LoggerService {
+    static instance;
+    baseLogger;
+    logInterceptStream;
+    childLoggers = new Map();
+    constructor() {
+        // Get log level from environment variable, default to 'info'
+        const logLevel = process.env.LOG_LEVEL || 'info';
+        // Create a pass-through stream to intercept logs
+        this.logInterceptStream = new PassThrough();
+        // Forward logs to the log buffer (lazy loaded to avoid circular dependency)
+        this.logInterceptStream.on('data', (chunk) => {
+            const logLine = chunk.toString().trim();
+            if (logLine) {
+                // Lazy load to avoid circular dependency
+                import('../../services/infrastructure/log-stream-buffer').then(({ logStreamBuffer }) => {
+                    logStreamBuffer.addLog(logLine);
+                }).catch(() => {
+                    // Silently ignore if log buffer is not available
+                });
+            }
+        });
+        const formatter = new LogFormatter();
+        formatter.pipe(process.stdout);
+        // Create multi-stream configuration with formatter
+        const streams = [
+            { level: logLevel, stream: formatter },
+            { level: logLevel, stream: this.logInterceptStream }
+        ];
+        this.baseLogger = pino({
+            level: logLevel,
+            formatters: {
+                level: (label) => {
+                    return { level: label };
+                }
+            },
+            timestamp: pino.stdTimeFunctions.isoTime,
+            // Enable in test environment if debug level, otherwise suppress
+            enabled: process.env.NODE_ENV !== 'test' || logLevel === 'debug'
+        }, pino.multistream(streams));
+    }
+    /**
+     * Get the singleton logger instance
+     */
+    static getInstance() {
+        if (!LoggerService.instance) {
+            LoggerService.instance = new LoggerService();
+        }
+        return LoggerService.instance;
+    }
+    /**
+     * Create a child logger with context
+     */
+    child(context) {
+        const contextKey = JSON.stringify(context);
+        if (!this.childLoggers.has(contextKey)) {
+            this.childLoggers.set(contextKey, this.baseLogger.child(context));
+        }
+        return new CUILogger(this.childLoggers.get(contextKey));
+    }
+    /**
+     * Get the base logger
+     */
+    getLogger() {
+        return new CUILogger(this.baseLogger);
+    }
+    /**
+     * Log debug message
+     */
+    debug(message, context) {
+        if (context) {
+            this.baseLogger.child(context).debug(message);
+        }
+        else {
+            this.baseLogger.debug(message);
+        }
+    }
+    /**
+     * Log info message
+     */
+    info(message, context) {
+        if (context) {
+            this.baseLogger.child(context).info(message);
+        }
+        else {
+            this.baseLogger.info(message);
+        }
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, context) {
+        if (context) {
+            this.baseLogger.child(context).warn(message);
+        }
+        else {
+            this.baseLogger.warn(message);
+        }
+    }
+    /**
+     * Log error message
+     */
+    error(message, error, context) {
+        const logData = error ? { err: error } : {};
+        if (context) {
+            this.baseLogger.child({ ...context, ...logData }).error(message);
+        }
+        else {
+            this.baseLogger.error(logData, message);
+        }
+    }
+    /**
+     * Log fatal message
+     */
+    fatal(message, error, context) {
+        const logData = error ? { err: error } : {};
+        if (context) {
+            this.baseLogger.child({ ...context, ...logData }).fatal(message);
+        }
+        else {
+            this.baseLogger.fatal(logData, message);
+        }
+    }
+}
+// Export singleton instance
+export const logger = LoggerService.getInstance();
+// Export factory function for creating component loggers
+export function createLogger(component, baseContext) {
+    const context = { component, ...baseContext };
+    return logger.child(context);
+}
+//# sourceMappingURL=logger.js.map

package/dist/services/infrastructure/logger.js.map

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

package/dist/services/infrastructure/service-registry.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Service Registry - Explicit initialization tracking with dependency validation.
+ *
+ * Solves the "singleton initialization chaos" problem where:
+ * - Services depend on initialization order with no enforcement
+ * - Lazy initialization can silently fail if dependencies aren't ready
+ * - No visibility into which services are initialized
+ *
+ * USAGE:
+ *
+ * 1. Register services during startup:
+ *    serviceRegistry.register('SessionInfoService', {
+ *      dependsOn: ['ConfigService']
+ *    });
+ *
+ * 2. Mark as initialized after async init completes:
+ *    await sessionInfoService.initialize();
+ *    serviceRegistry.markInitialized('SessionInfoService');
+ *
+ * 3. Services can guard their methods:
+ *    serviceRegistry.requireInitialized('SessionInfoService');
+ *
+ * 4. Check status for debugging:
+ *    serviceRegistry.getStatus(); // Returns all services and their state
+ */
+export interface ServiceRegistration {
+    /** Services that must be initialized before this one */
+    dependsOn?: string[];
+    /** Optional description for debugging */
+    description?: string;
+}
+declare class ServiceRegistry {
+    private services;
+    /**
+     * Register a service. Call this before initialization.
+     * Validates that declared dependencies are already registered.
+     */
+    register(name: string, options?: ServiceRegistration): void;
+    /**
+     * Mark a service as initialized.
+     * Validates that all dependencies are already initialized.
+     */
+    markInitialized(name: string): void;
+    /**
+     * Check if a service is initialized.
+     */
+    isInitialized(name: string): boolean;
+    /**
+     * Require a service to be initialized, throwing if not.
+     * Use this to guard service methods.
+     */
+    requireInitialized(name: string): void;
+    /**
+     * Get status of all registered services.
+     * Useful for debugging and health checks.
+     */
+    getStatus(): Record<string, {
+        initialized: boolean;
+        dependsOn: string[];
+        initializedAt?: string;
+    }>;
+    /**
+     * Get list of services that aren't initialized yet.
+     */
+    getUninitializedServices(): string[];
+    /**
+     * Verify all registered services are initialized.
+     * Throws if any service is not initialized.
+     */
+    requireAllInitialized(): void;
+    /**
+     * Reset all services (for testing).
+     */
+    reset(): void;
+    /**
+     * Unregister a specific service (for testing).
+     */
+    unregister(name: string): void;
+}
+export declare const serviceRegistry: ServiceRegistry;
+export declare const registerService: (name: string, options?: ServiceRegistration) => void;
+export declare const markServiceInitialized: (name: string) => void;
+export declare const requireServiceInitialized: (name: string) => void;
+export declare const isServiceInitialized: (name: string) => boolean;
+export {};
+//# sourceMappingURL=service-registry.d.ts.map

package/dist/services/infrastructure/service-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-registry.d.ts","sourceRoot":"","sources":["../../../src/services/infrastructure/service-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAaD,cAAM,eAAe;IACnB,OAAO,CAAC,QAAQ,CAAmC;IAEnD;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,IAAI;IA6B/D;;;OAGG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkCnC;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAqBtC;;;OAGG;IACH,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAclG;;OAEG;IACH,wBAAwB,IAAI,MAAM,EAAE;IAMpC;;;OAGG;IACH,qBAAqB,IAAI,IAAI;IAW7B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG/B;AAGD,eAAO,MAAM,eAAe,iBAAwB,CAAC;AAGrD,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,EAAE,UAAU,mBAAmB,SAClC,CAAC;AAE1C,eAAO,MAAM,sBAAsB,GAAI,MAAM,MAAM,SACZ,CAAC;AAExC,eAAO,MAAM,yBAAyB,GAAI,MAAM,MAAM,SACZ,CAAC;AAE3C,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,YACZ,CAAC"}

package/dist/services/infrastructure/service-registry.js

@@ -0,0 +1,162 @@
+/**
+ * Service Registry - Explicit initialization tracking with dependency validation.
+ *
+ * Solves the "singleton initialization chaos" problem where:
+ * - Services depend on initialization order with no enforcement
+ * - Lazy initialization can silently fail if dependencies aren't ready
+ * - No visibility into which services are initialized
+ *
+ * USAGE:
+ *
+ * 1. Register services during startup:
+ *    serviceRegistry.register('SessionInfoService', {
+ *      dependsOn: ['ConfigService']
+ *    });
+ *
+ * 2. Mark as initialized after async init completes:
+ *    await sessionInfoService.initialize();
+ *    serviceRegistry.markInitialized('SessionInfoService');
+ *
+ * 3. Services can guard their methods:
+ *    serviceRegistry.requireInitialized('SessionInfoService');
+ *
+ * 4. Check status for debugging:
+ *    serviceRegistry.getStatus(); // Returns all services and their state
+ */
+import { createLogger } from './logger.js';
+const logger = createLogger('ServiceRegistry');
+class ServiceRegistry {
+    services = new Map();
+    /**
+     * Register a service. Call this before initialization.
+     * Validates that declared dependencies are already registered.
+     */
+    register(name, options = {}) {
+        if (this.services.has(name)) {
+            logger.warn(`Service "${name}" already registered, skipping`);
+            return;
+        }
+        const dependsOn = options.dependsOn || [];
+        // Validate dependencies are registered (but not necessarily initialized yet)
+        for (const dep of dependsOn) {
+            if (!this.services.has(dep)) {
+                throw new Error(`Service "${name}" depends on "${dep}" which is not registered. ` +
+                    `Register dependencies before dependents.`);
+            }
+        }
+        this.services.set(name, {
+            name,
+            registered: true,
+            initialized: false,
+            dependsOn,
+            description: options.description
+        });
+        logger.debug(`Registered service: ${name}`, { dependsOn });
+    }
+    /**
+     * Mark a service as initialized.
+     * Validates that all dependencies are already initialized.
+     */
+    markInitialized(name) {
+        const state = this.services.get(name);
+        if (!state) {
+            throw new Error(`Cannot mark "${name}" as initialized - not registered. ` +
+                `Call register() before markInitialized().`);
+        }
+        if (state.initialized) {
+            logger.warn(`Service "${name}" already marked as initialized`);
+            return;
+        }
+        // Validate all dependencies are initialized
+        const uninitializedDeps = state.dependsOn.filter(dep => {
+            const depState = this.services.get(dep);
+            return !depState?.initialized;
+        });
+        if (uninitializedDeps.length > 0) {
+            throw new Error(`Cannot initialize "${name}" - dependencies not initialized: ${uninitializedDeps.join(', ')}. ` +
+                `Initialize dependencies first.`);
+        }
+        state.initialized = true;
+        state.initializedAt = new Date();
+        logger.debug(`Initialized service: ${name}`);
+    }
+    /**
+     * Check if a service is initialized.
+     */
+    isInitialized(name) {
+        return this.services.get(name)?.initialized ?? false;
+    }
+    /**
+     * Require a service to be initialized, throwing if not.
+     * Use this to guard service methods.
+     */
+    requireInitialized(name) {
+        const state = this.services.get(name);
+        if (!state) {
+            throw new Error(`Service "${name}" is not registered. ` +
+                `This may indicate a missing service or a typo in the service name.`);
+        }
+        if (!state.initialized) {
+            const deps = state.dependsOn.length > 0
+                ? ` (depends on: ${state.dependsOn.join(', ')})`
+                : '';
+            throw new Error(`Service "${name}" is not initialized${deps}. ` +
+                `Ensure initialize() is called during server startup.`);
+        }
+    }
+    /**
+     * Get status of all registered services.
+     * Useful for debugging and health checks.
+     */
+    getStatus() {
+        const status = {};
+        for (const [name, state] of this.services) {
+            status[name] = {
+                initialized: state.initialized,
+                dependsOn: state.dependsOn,
+                initializedAt: state.initializedAt?.toISOString()
+            };
+        }
+        return status;
+    }
+    /**
+     * Get list of services that aren't initialized yet.
+     */
+    getUninitializedServices() {
+        return Array.from(this.services.entries())
+            .filter(([_, state]) => !state.initialized)
+            .map(([name]) => name);
+    }
+    /**
+     * Verify all registered services are initialized.
+     * Throws if any service is not initialized.
+     */
+    requireAllInitialized() {
+        const uninitialized = this.getUninitializedServices();
+        if (uninitialized.length > 0) {
+            throw new Error(`The following services are not initialized: ${uninitialized.join(', ')}. ` +
+                `Ensure all services complete initialization during startup.`);
+        }
+    }
+    /**
+     * Reset all services (for testing).
+     */
+    reset() {
+        this.services.clear();
+        logger.debug('Service registry reset');
+    }
+    /**
+     * Unregister a specific service (for testing).
+     */
+    unregister(name) {
+        this.services.delete(name);
+    }
+}
+// Singleton instance
+export const serviceRegistry = new ServiceRegistry();
+// Convenience re-exports for common operations
+export const registerService = (name, options) => serviceRegistry.register(name, options);
+export const markServiceInitialized = (name) => serviceRegistry.markInitialized(name);
+export const requireServiceInitialized = (name) => serviceRegistry.requireInitialized(name);
+export const isServiceInitialized = (name) => serviceRegistry.isInitialized(name);
+//# sourceMappingURL=service-registry.js.map

package/dist/services/infrastructure/service-registry.js.map

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

package/dist/services/infrastructure/stream-manager.d.ts

@@ -0,0 +1,87 @@
+import { Response } from 'express';
+import { StreamEvent } from '../../types/index.js';
+import { EventEmitter } from 'events';
+/**
+ * Manages streaming connections to multiple clients
+ */
+export declare class StreamManager extends EventEmitter {
+    private clients;
+    private logger;
+    private heartbeatInterval?;
+    private eventBuffers;
+    private readonly EVENT_BUFFER_WINDOW_MS;
+    private readonly MAX_BUFFERED_EVENTS;
+    private readonly HEARTBEAT_INTERVAL_MS;
+    constructor();
+    /**
+     * Start buffering events for a session.
+     * Call this when a session is created, before any clients connect.
+     * Events will be replayed when the first client connects.
+     */
+    startBuffering(streamingId: string): void;
+    /**
+     * Stop buffering events for a session and discard any buffered events.
+     * Called automatically after the buffer window expires.
+     */
+    private stopBuffering;
+    /**
+     * Replay buffered events to a client and stop buffering.
+     * Called when the first client connects.
+     */
+    private replayBufferedEvents;
+    /**
+     * Add a client to receive stream updates
+     */
+    addClient(streamingId: string, res: Response): void;
+    /**
+     * Remove a client connection
+     */
+    removeClient(streamingId: string, res: Response): void;
+    /**
+     * Broadcast an event to all clients watching a session
+     */
+    broadcast(streamingId: string, event: StreamEvent): void;
+    /**
+     * Send an SSE event to a specific client
+     */
+    private sendSSEEvent;
+    /**
+     * Send SSE heartbeat (comment) to keep connection alive
+     */
+    private sendHeartbeat;
+    /**
+     * Get number of clients connected to a session
+     */
+    getClientCount(streamingId: string): number;
+    /**
+     * Get all active sessions
+     */
+    getActiveSessions(): string[];
+    /**
+     * Close all connections for a session
+     */
+    closeSession(streamingId: string): void;
+    /**
+     * Get total number of clients across all sessions
+     */
+    getTotalClientCount(): number;
+    /**
+     * Clean up orphaned sessions that don't have an active Claude process.
+     * Call this with a set of active streamingIds to close any sessions not in that set.
+     */
+    cleanupOrphanedSessions(activeStreamingIds: Set<string>): number;
+    /**
+     * Disconnect all clients from all sessions
+     */
+    disconnectAll(): void;
+    /**
+     * Start periodic heartbeat to keep SSE connections alive
+     * Also prunes stale/dead clients that failed to disconnect properly
+     */
+    private startHeartbeat;
+    /**
+     * Stop periodic heartbeat
+     */
+    private stopHeartbeat;
+}
+//# sourceMappingURL=stream-manager.d.ts.map

package/dist/services/infrastructure/stream-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-manager.d.ts","sourceRoot":"","sources":["../../../src/services/infrastructure/stream-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAgBtC;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAAC,CAAiB;IAG3C,OAAO,CAAC,YAAY,CAAuC;IAI3D,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAQ;IAG/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAO;IAK3C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;;IAO/C;;;;OAIG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAsBzC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiBrB;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IA8B5B;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI;IA2EnD;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI;IAyBtD;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAwExD;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI3C;;OAEG;IACH,iBAAiB,IAAI,MAAM,EAAE;IAI7B;;OAEG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAwCvC;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAQ7B;;;OAGG;IACH,uBAAuB,CAAC,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM;IAuBhE;;OAEG;IACH,aAAa,IAAI,IAAI;IAYrB;;;OAGG;IACH,OAAO,CAAC,cAAc;IA2CtB;;OAEG;IACH,OAAO,CAAC,aAAa;CAOtB"}