@brutalist/mcp 0.5.1 → 0.6.1

package/dist/streaming/streaming-orchestrator.js

@@ -0,0 +1,436 @@
+import { EventEmitter } from 'events';
+import { logger } from '../logger.js';
+import { CLIAgentOrchestrator } from '../cli-agents.js';
+import { SessionManager } from './session-manager.js';
+import { EnhancedSSETransport } from './sse-transport.js';
+import { ProgressTracker } from './progress-tracker.js';
+import { CircuitBreaker, CachedResponseFallback, DegradedServiceFallback } from './circuit-breaker.js';
+/**
+ * Advanced streaming CLI orchestrator with comprehensive real-time capabilities
+ *
+ * Integrates all streaming components:
+ * - Real-time output parsing with semantic boundaries
+ * - Intelligent buffering with adaptive throttling
+ * - Session management with lifecycle tracking
+ * - SSE transport with session isolation
+ * - Progress tracking with milestone detection
+ * - Circuit breaker with fallback strategies
+ * - Comprehensive monitoring and analytics
+ */
+export class StreamingCLIOrchestrator extends EventEmitter {
+    cliOrchestrator;
+    sessionManager;
+    sseTransport;
+    circuitBreakers = new Map();
+    responseCache = new Map();
+    activeAnalyses = new Map();
+    config;
+    metrics = {
+        totalAnalyses: 0,
+        successfulAnalyses: 0,
+        failedAnalyses: 0,
+        totalEventsSent: 0,
+        totalCircuitBreakerTrips: 0,
+        totalFallbacksUsed: 0,
+        averageAnalysisDuration: 0
+    };
+    cleanupTimer;
+    constructor(config) {
+        super();
+        this.config = {
+            maxConcurrentAnalyses: 10,
+            defaultTimeout: 600000, // 10 minutes
+            circuitBreakerConfig: {
+                failureThreshold: 5,
+                recoveryTimeout: 30000,
+                successThreshold: 3,
+                timeout: 120000,
+                monitoringWindow: 300000,
+                minimumRequests: 10
+            },
+            enableMetrics: true,
+            cleanupInterval: 300000, // 5 minutes
+            ...config
+        };
+        this.cliOrchestrator = new CLIAgentOrchestrator();
+        this.sessionManager = new SessionManager();
+        this.sseTransport = new EnhancedSSETransport(this.sessionManager);
+        this.setupEventHandlers();
+        this.setupCircuitBreakers();
+        this.startCleanupTimer();
+        logger.info('🚀 Streaming CLI Orchestrator initialized', {
+            maxConcurrentAnalyses: this.config.maxConcurrentAnalyses,
+            circuitBreakerEnabled: true,
+            progressTrackingEnabled: true
+        });
+    }
+    /**
+     * Execute CLI analysis with full streaming capabilities
+     */
+    async executeWithStreaming(analysisType, cliAgents, systemPrompt, userPrompt, options = {}) {
+        const sessionId = options.sessionId || `session_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+        const startTime = Date.now();
+        // Check concurrent analysis limit
+        if (this.activeAnalyses.size >= this.config.maxConcurrentAnalyses) {
+            throw new Error(`Maximum concurrent analyses reached (${this.config.maxConcurrentAnalyses})`);
+        }
+        logger.info(`🎬 Starting streaming analysis: ${analysisType} for session ${sessionId}`, {
+            agents: cliAgents,
+            enableProgress: options.enableProgress,
+            enableCircuitBreaker: options.enableCircuitBreaker
+        });
+        // Create session and progress tracker
+        const sessionContext = this.sessionManager.createSession(sessionId, {
+            analysisType,
+            agents: cliAgents,
+            startTime
+        });
+        const progressTracker = options.enableProgress !== false
+            ? new ProgressTracker(sessionId, analysisType)
+            : undefined;
+        // Track active analysis
+        this.activeAnalyses.set(sessionId, {
+            sessionId,
+            progressTracker: progressTracker,
+            startTime,
+            options
+        });
+        // Setup progress tracking if enabled
+        if (progressTracker) {
+            progressTracker.on('progress', (progressEvent) => {
+                this.sessionManager.emitToSession(sessionId, {
+                    type: 'agent_progress',
+                    agent: 'system',
+                    content: `Progress: ${Math.round(progressEvent.progress.overall * 100)}% - ${progressEvent.phase}`,
+                    timestamp: Date.now(),
+                    sessionId,
+                    metadata: {
+                        progressEvent,
+                        milestone: progressEvent.milestone?.name,
+                        estimatedCompletion: progressEvent.estimatedCompletion
+                    }
+                });
+            });
+        }
+        const analysisResult = {
+            success: false,
+            responses: [],
+            sessionId,
+            analysis: {
+                startTime,
+                endTime: 0,
+                duration: 0,
+                eventsEmitted: 0,
+                progressMilestones: 0,
+                circuitBreakerTrips: 0,
+                fallbacksUsed: 0
+            },
+            streaming: {
+                connectedClients: 0,
+                eventsSent: 0,
+                averageLatency: 0,
+                bufferHits: 0
+            }
+        };
+        try {
+            // Enhanced CLI options with streaming callbacks
+            const enhancedOptions = {
+                ...options,
+                sessionId,
+                onStreamingEvent: this.createStreamingEventHandler(sessionId, progressTracker, analysisResult),
+                timeout: options.streamingTimeout || this.config.defaultTimeout
+            };
+            // Execute CLI agents with circuit breaker protection if enabled
+            if (options.enableCircuitBreaker !== false) {
+                analysisResult.responses = await this.executeWithCircuitBreaker(cliAgents, systemPrompt, userPrompt, enhancedOptions);
+            }
+            else {
+                // Direct execution without circuit breaker
+                analysisResult.responses = await this.cliOrchestrator.executeCLIAgents(cliAgents, systemPrompt, userPrompt, enhancedOptions);
+            }
+            analysisResult.success = analysisResult.responses.some(r => r.success);
+            // Mark progress as complete
+            if (progressTracker) {
+                progressTracker.markComplete();
+            }
+            this.metrics.successfulAnalyses++;
+        }
+        catch (error) {
+            logger.error(`💥 Streaming analysis failed for session ${sessionId}:`, error);
+            analysisResult.success = false;
+            analysisResult.errors = [error instanceof Error ? error.message : String(error)];
+            // Handle fallback if configured
+            if (options.fallbackResponse) {
+                analysisResult.responses = [{
+                        agent: 'claude', // Use a valid agent type for fallback
+                        success: true,
+                        output: typeof options.fallbackResponse === 'string'
+                            ? options.fallbackResponse
+                            : JSON.stringify(options.fallbackResponse),
+                        executionTime: Date.now() - startTime,
+                        command: 'fallback',
+                        workingDirectory: options.workingDirectory || process.cwd(),
+                        exitCode: 0
+                    }];
+                analysisResult.analysis.fallbacksUsed++;
+                this.metrics.totalFallbacksUsed++;
+            }
+            this.metrics.failedAnalyses++;
+        }
+        finally {
+            const endTime = Date.now();
+            analysisResult.analysis.endTime = endTime;
+            analysisResult.analysis.duration = endTime - startTime;
+            // Get streaming stats
+            const sessionConnections = this.sseTransport.getSessionConnections(sessionId);
+            analysisResult.streaming.connectedClients = sessionConnections.length;
+            analysisResult.streaming.eventsSent = sessionConnections.reduce((sum, conn) => sum + conn.eventsSent, 0);
+            // Get session metrics
+            const sessionStats = this.sessionManager.getSessionStats(sessionId);
+            if (sessionStats) {
+                analysisResult.analysis.eventsEmitted = sessionStats.eventsEmitted;
+                analysisResult.streaming.bufferHits = sessionStats.bufferStats.flushCount;
+            }
+            // Update global metrics
+            this.metrics.totalAnalyses++;
+            this.updateAverageAnalysisDuration(analysisResult.analysis.duration);
+            // Cleanup
+            this.activeAnalyses.delete(sessionId);
+            this.sessionManager.completeSession(sessionId);
+            // Keep SSE connections open briefly for final events
+            setTimeout(() => {
+                this.sseTransport.disconnectSession(sessionId, 'analysis_complete');
+            }, 5000);
+            logger.info(`🏁 Streaming analysis completed: ${sessionId} (${analysisResult.analysis.duration}ms)`, {
+                success: analysisResult.success,
+                eventsEmitted: analysisResult.analysis.eventsEmitted,
+                connectedClients: analysisResult.streaming.connectedClients
+            });
+        }
+        return analysisResult;
+    }
+    /**
+     * Create streaming event handler for session
+     */
+    createStreamingEventHandler(sessionId, progressTracker, result) {
+        return (event) => {
+            // Process event through progress tracker
+            if (progressTracker) {
+                progressTracker.processEvent(event);
+            }
+            // Emit to session manager (which handles SSE transport)
+            this.sessionManager.emitToSession(sessionId, event);
+            // Update metrics
+            result.analysis.eventsEmitted++;
+            this.metrics.totalEventsSent++;
+            // Emit orchestrator-level event
+            this.emit('streamingEvent', { sessionId, event });
+        };
+    }
+    /**
+     * Execute CLI agents with circuit breaker protection
+     */
+    async executeWithCircuitBreaker(cliAgents, systemPrompt, userPrompt, options) {
+        const responses = [];
+        for (const agent of cliAgents) {
+            const circuitBreaker = this.circuitBreakers.get(agent);
+            if (!circuitBreaker) {
+                throw new Error(`No circuit breaker configured for agent: ${agent}`);
+            }
+            try {
+                const response = await circuitBreaker.execute(async () => {
+                    return await this.cliOrchestrator.executeCLIAgent(agent, systemPrompt, userPrompt, options);
+                }, { id: `${agent}_${options.sessionId}` });
+                responses.push(response);
+            }
+            catch (error) {
+                logger.warn(`Circuit breaker blocked execution for ${agent}:`, error);
+                // Circuit breaker handled the error, continue with other agents
+                responses.push({
+                    agent: agent,
+                    success: false,
+                    output: '',
+                    error: `Circuit breaker: ${error instanceof Error ? error.message : String(error)}`,
+                    executionTime: 0,
+                    command: 'circuit_breaker_blocked',
+                    workingDirectory: options.workingDirectory || process.cwd(),
+                    exitCode: -1
+                });
+                this.metrics.totalCircuitBreakerTrips++;
+            }
+        }
+        return responses;
+    }
+    /**
+     * Setup event handlers for internal components
+     */
+    setupEventHandlers() {
+        // Session manager events
+        this.sessionManager.on('sessionCreated', (sessionId) => {
+            logger.debug(`📝 Session created: ${sessionId}`);
+            this.emit('sessionCreated', sessionId);
+        });
+        this.sessionManager.on('sessionCompleted', (sessionId) => {
+            logger.debug(`✅ Session completed: ${sessionId}`);
+            this.emit('sessionCompleted', sessionId);
+        });
+        // SSE transport events
+        this.sseTransport.on('connectionClosed', (data) => {
+            logger.debug(`🔌 SSE connection closed: ${data.connectionId} (${data.reason})`);
+            this.emit('connectionClosed', data);
+        });
+        // Circuit breaker events
+        this.on('circuitBreakerStateChanged', (data) => {
+            logger.info(`🔌 Circuit breaker state changed: ${data.agent} -> ${data.state}`);
+        });
+    }
+    /**
+     * Setup circuit breakers for each CLI agent
+     */
+    setupCircuitBreakers() {
+        const agents = ['claude', 'codex', 'gemini'];
+        for (const agent of agents) {
+            const circuitBreaker = new CircuitBreaker(this.config.circuitBreakerConfig, `${agent}_breaker`);
+            // Add fallback strategies
+            if (this.responseCache.size > 0) {
+                circuitBreaker.addFallbackStrategy(new CachedResponseFallback(this.responseCache));
+            }
+            circuitBreaker.addFallbackStrategy(new DegradedServiceFallback({
+                agent,
+                success: false,
+                output: `${agent.toUpperCase()} is temporarily unavailable. This is a degraded response.`,
+                error: 'Circuit breaker fallback',
+                executionTime: 0,
+                command: 'fallback',
+                workingDirectory: process.cwd(),
+                exitCode: -1
+            }));
+            // Setup event forwarding
+            circuitBreaker.on('stateChanged', (data) => {
+                this.emit('circuitBreakerStateChanged', { agent, ...data });
+            });
+            circuitBreaker.on('fallbackSuccess', (data) => {
+                this.metrics.totalFallbacksUsed++;
+                this.emit('fallbackUsed', { agent, ...data });
+            });
+            this.circuitBreakers.set(agent, circuitBreaker);
+            logger.debug(`🔌 Circuit breaker configured for ${agent}`);
+        }
+    }
+    /**
+     * Update average analysis duration metric
+     */
+    updateAverageAnalysisDuration(duration) {
+        const totalAnalyses = this.metrics.totalAnalyses;
+        const currentAverage = this.metrics.averageAnalysisDuration;
+        // Calculate new average using online algorithm
+        this.metrics.averageAnalysisDuration =
+            (currentAverage * (totalAnalyses - 1) + duration) / totalAnalyses;
+    }
+    /**
+     * Start cleanup timer for stale sessions and cache
+     */
+    startCleanupTimer() {
+        this.cleanupTimer = setInterval(() => {
+            this.performCleanup();
+        }, this.config.cleanupInterval);
+    }
+    /**
+     * Perform periodic cleanup
+     */
+    performCleanup() {
+        const now = Date.now();
+        const staleThreshold = 30 * 60 * 1000; // 30 minutes
+        // Clean up stale analyses
+        for (const [sessionId, analysis] of this.activeAnalyses) {
+            if (now - analysis.startTime > staleThreshold) {
+                logger.warn(`🧹 Cleaning up stale analysis: ${sessionId}`);
+                this.activeAnalyses.delete(sessionId);
+                this.sessionManager.completeSession(sessionId);
+                this.sseTransport.disconnectSession(sessionId, 'cleanup_stale');
+            }
+        }
+        // Clean up response cache (keep last 100 entries)
+        if (this.responseCache.size > 100) {
+            const entries = Array.from(this.responseCache.entries());
+            entries.splice(0, entries.length - 100);
+            this.responseCache.clear();
+            for (const [key, value] of entries) {
+                this.responseCache.set(key, value);
+            }
+        }
+        logger.debug(`🧹 Cleanup completed: ${this.activeAnalyses.size} active analyses, ${this.responseCache.size} cached responses`);
+    }
+    /**
+     * Get orchestrator statistics
+     */
+    getStats() {
+        const circuitBreakerStats = {};
+        for (const [agent, breaker] of this.circuitBreakers) {
+            circuitBreakerStats[agent] = breaker.getStats();
+        }
+        return {
+            metrics: { ...this.metrics },
+            activeAnalyses: this.activeAnalyses.size,
+            sessionManager: this.sessionManager.getGlobalStats(),
+            sseTransport: this.sseTransport.getStats(),
+            circuitBreakers: circuitBreakerStats
+        };
+    }
+    /**
+     * Get active session IDs
+     */
+    getActiveSessions() {
+        return Array.from(this.activeAnalyses.keys());
+    }
+    /**
+     * Force disconnect session
+     */
+    disconnectSession(sessionId, reason = 'forced_disconnect') {
+        logger.info(`🔌 Force disconnecting session: ${sessionId}`);
+        this.activeAnalyses.delete(sessionId);
+        this.sessionManager.completeSession(sessionId);
+        this.sseTransport.disconnectSession(sessionId, reason);
+    }
+    /**
+     * Reset circuit breaker for specific agent
+     */
+    resetCircuitBreaker(agent) {
+        const circuitBreaker = this.circuitBreakers.get(agent);
+        if (circuitBreaker) {
+            circuitBreaker.reset();
+            logger.info(`🔄 Circuit breaker reset for ${agent}`);
+        }
+    }
+    /**
+     * Add response to cache for fallback strategies
+     */
+    cacheResponse(key, response) {
+        this.responseCache.set(key, response);
+        logger.debug(`💾 Cached response: ${key}`);
+    }
+    /**
+     * Shutdown orchestrator and cleanup resources
+     */
+    shutdown() {
+        logger.info('🛑 Shutting down Streaming CLI Orchestrator');
+        // Stop cleanup timer
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+        }
+        // Disconnect all sessions
+        for (const sessionId of this.activeAnalyses.keys()) {
+            this.disconnectSession(sessionId, 'orchestrator_shutdown');
+        }
+        // Shutdown components
+        this.sseTransport.shutdown();
+        this.sessionManager.shutdown();
+        // Shutdown circuit breakers
+        for (const [agent, breaker] of this.circuitBreakers) {
+            breaker.shutdown();
+        }
+        this.removeAllListeners();
+        logger.info('✅ Streaming CLI Orchestrator shutdown complete');
+    }
+}
+//# sourceMappingURL=streaming-orchestrator.js.map

package/dist/streaming/streaming-orchestrator.js.map

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

package/dist/test-utils/process-manager.d.ts

@@ -0,0 +1,61 @@
+import { ChildProcess } from 'child_process';
+export interface ManagedProcess {
+    pid: number;
+    command: string;
+    args: string[];
+    process: ChildProcess;
+    stdout: string;
+    stderr: string;
+    killed: boolean;
+    startTime: number;
+}
+export interface SpawnOptions {
+    cwd?: string;
+    timeout?: number;
+    maxBuffer?: number;
+    input?: string;
+    env?: Record<string, string>;
+    onProgress?: (chunk: string, type: 'stdout' | 'stderr') => void;
+}
+/**
+ * Cross-platform process manager that tracks all spawned processes
+ * and ensures proper cleanup, preventing orphaned processes in tests
+ */
+export declare class ProcessManager {
+    private static instance;
+    private processes;
+    private readonly isWindows;
+    private cleanupRegistered;
+    private constructor();
+    static getInstance(): ProcessManager;
+    private registerCleanupHandlers;
+    /**
+     * Spawn a managed process with automatic tracking and cleanup
+     */
+    spawn(command: string, args: string[], options?: SpawnOptions): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number | null;
+    }>;
+    /**
+     * Kill a process and all its children (cross-platform)
+     */
+    killProcessTree(pid: number, signal?: NodeJS.Signals): Promise<void>;
+    /**
+     * Get all currently running managed processes
+     */
+    getRunningProcesses(): ManagedProcess[];
+    /**
+     * Clean up all tracked processes
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get diagnostic information about running processes
+     */
+    getDiagnostics(): string;
+    /**
+     * Assert no processes are leaked (for test cleanup validation)
+     */
+    assertNoLeakedProcesses(): void;
+}
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/test-utils/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/test-utils/process-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmB,MAAM,eAAe,CAAC;AAI9D,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;CACjE;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,iBAAiB,CAAS;IAElC,OAAO;IAKP,MAAM,CAAC,WAAW,IAAI,cAAc;IAOpC,OAAO,CAAC,uBAAuB;IAkB/B;;OAEG;IACG,KAAK,CACT,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IA0HvE;;OAEG;IACG,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,OAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDrF;;OAEG;IACH,mBAAmB,IAAI,cAAc,EAAE;IAIvC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB9B;;OAEG;IACH,cAAc,IAAI,MAAM;IAqBxB;;OAEG;IACH,uBAAuB,IAAI,IAAI;CAOhC"}