specmem-hardwicksoftware 3.5.99

package/dist/dashboard/websocket/teamMemberStream.js

@@ -0,0 +1,366 @@
+/**
+ * teamMemberStream.ts - WebSocket Handler for Real-Time TeamMember Updates
+ *
+ * Phase 2: Real-time team member status updates and communications
+ *
+ * Features:
+ * - /ws/team-members/live - Real-time team member session updates
+ * - Broadcasts team member status changes
+ * - Broadcasts new communications
+ * - Client subscription management
+ */
+import { WebSocket, WebSocketServer } from 'ws';
+import { logger } from '../../utils/logger.js';
+// ============================================================================
+// TeamMember Stream WebSocket Manager
+// ============================================================================
+export class TeamMemberStreamManager {
+    wss;
+    clients = new Map();
+    pingInterval = null;
+    messageQueue = [];
+    maxQueueSize = 100;
+    path;
+    constructor(server, path = '/ws/team-members/live') {
+        this.path = path;
+        // CRITICAL FIX: Use noServer mode to prevent duplicate upgrade handler conflicts
+        // When multiple WebSocketServers are attached to the same HTTP server with
+        // { server: xxx }, they ALL receive the 'upgrade' event and try to handle it.
+        // The one that doesn't match the path sends a 400 error AFTER another WSS
+        // has already completed the upgrade, causing the RSV1/1006 close bug.
+        this.wss = new WebSocketServer({
+            noServer: true,
+            perMessageDeflate: false // Disable compression for lower latency
+        });
+        // Manually handle upgrade events for our specific path
+        server.on('upgrade', (request, socket, head) => {
+            const url = new URL(request.url || '/', `http://${request.headers.host}`);
+            // Only handle requests for our specific path
+            if (url.pathname === this.path) {
+                this.wss.handleUpgrade(request, socket, head, (ws) => {
+                    this.wss.emit('connection', ws, request);
+                });
+            }
+            // Don't do anything for other paths - let other handlers deal with them
+        });
+        this.setupWebSocket();
+        this.startPingInterval();
+        logger.info({ path }, 'Team Member WebSocket stream initialized (noServer mode)');
+    }
+    setupWebSocket() {
+        this.wss.on('connection', (ws, request) => {
+            const clientId = this.generateClientId();
+            const client = {
+                ws,
+                id: clientId,
+                subscriptions: new Set(['*']), // Subscribe to all by default
+                connectedAt: new Date(),
+                lastPing: new Date()
+            };
+            this.clients.set(clientId, client);
+            logger.info({ clientId, totalClients: this.clients.size }, 'Team Member stream client connected');
+            // Send welcome message
+            this.sendToClient(client, {
+                type: 'heartbeat',
+                data: {
+                    clientId,
+                    message: 'Connected to team member stream',
+                    activeClients: this.clients.size
+                },
+                timestamp: new Date().toISOString()
+            });
+            // Send any queued messages
+            this.flushQueueToClient(client);
+            ws.on('message', (data) => {
+                try {
+                    const message = JSON.parse(data.toString());
+                    this.handleClientMessage(client, message);
+                }
+                catch (error) {
+                    this.sendToClient(client, {
+                        type: 'error',
+                        data: { message: 'Invalid message format' },
+                        timestamp: new Date().toISOString()
+                    });
+                }
+            });
+            ws.on('pong', () => {
+                client.lastPing = new Date();
+            });
+            ws.on('close', () => {
+                this.clients.delete(clientId);
+                logger.info({ clientId, totalClients: this.clients.size }, 'Team Member stream client disconnected');
+            });
+            ws.on('error', (error) => {
+                logger.error({ clientId, error }, 'Team Member stream client error');
+                this.clients.delete(clientId);
+            });
+        });
+        this.wss.on('error', (error) => {
+            logger.error({ error }, 'Team Member WebSocket server error');
+        });
+    }
+    handleClientMessage(client, message) {
+        const action = message.action;
+        switch (action) {
+            case 'subscribe':
+                // Subscribe to specific session updates
+                const sessionId = message.sessionId;
+                if (sessionId) {
+                    client.subscriptions.add(sessionId);
+                    this.sendToClient(client, {
+                        type: 'heartbeat',
+                        data: { message: `Subscribed to session ${sessionId}` },
+                        timestamp: new Date().toISOString()
+                    });
+                }
+                break;
+            case 'unsubscribe':
+                // Unsubscribe from specific session
+                const unsubId = message.sessionId;
+                if (unsubId) {
+                    client.subscriptions.delete(unsubId);
+                    this.sendToClient(client, {
+                        type: 'heartbeat',
+                        data: { message: `Unsubscribed from session ${unsubId}` },
+                        timestamp: new Date().toISOString()
+                    });
+                }
+                break;
+            case 'subscribe_all':
+                // Subscribe to all updates
+                client.subscriptions.add('*');
+                this.sendToClient(client, {
+                    type: 'heartbeat',
+                    data: { message: 'Subscribed to all sessions' },
+                    timestamp: new Date().toISOString()
+                });
+                break;
+            case 'ping':
+                // Respond to client ping
+                this.sendToClient(client, {
+                    type: 'heartbeat',
+                    data: { message: 'pong', serverTime: new Date().toISOString() },
+                    timestamp: new Date().toISOString()
+                });
+                break;
+            case 'get_status':
+                // Send current status
+                this.sendToClient(client, {
+                    type: 'heartbeat',
+                    data: {
+                        clientId: client.id,
+                        subscriptions: Array.from(client.subscriptions),
+                        connectedAt: client.connectedAt.toISOString(),
+                        activeClients: this.clients.size
+                    },
+                    timestamp: new Date().toISOString()
+                });
+                break;
+            default:
+                this.sendToClient(client, {
+                    type: 'error',
+                    data: { message: `Unknown action: ${action}` },
+                    timestamp: new Date().toISOString()
+                });
+        }
+    }
+    sendToClient(client, message) {
+        if (client.ws.readyState === WebSocket.OPEN) {
+            try {
+                client.ws.send(JSON.stringify(message));
+            }
+            catch (error) {
+                logger.warn({ clientId: client.id, error }, 'Failed to send message to client');
+            }
+        }
+    }
+    flushQueueToClient(client) {
+        for (const message of this.messageQueue) {
+            if (this.shouldReceiveMessage(client, message)) {
+                this.sendToClient(client, message);
+            }
+        }
+    }
+    shouldReceiveMessage(client, message) {
+        // If subscribed to all, receive everything
+        if (client.subscriptions.has('*')) {
+            return true;
+        }
+        // Otherwise, check if subscribed to the specific session
+        if (message.sessionId && client.subscriptions.has(message.sessionId)) {
+            return true;
+        }
+        return false;
+    }
+    startPingInterval() {
+        // Ping clients every 30 seconds to keep connections alive
+        this.pingInterval = setInterval(() => {
+            const now = Date.now();
+            const staleTimeout = 60000; // 60 seconds
+            for (const [clientId, client] of this.clients.entries()) {
+                // Check for stale connections
+                if (now - client.lastPing.getTime() > staleTimeout) {
+                    logger.warn({ clientId }, 'Closing stale team member stream connection');
+                    client.ws.terminate();
+                    this.clients.delete(clientId);
+                    continue;
+                }
+                // Send ping
+                if (client.ws.readyState === WebSocket.OPEN) {
+                    client.ws.ping();
+                }
+            }
+        }, 30000);
+    }
+    generateClientId() {
+        return `teamMember_ws_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+    }
+    // ============================================================================
+    // Public Methods for Broadcasting
+    // ============================================================================
+    /**
+     * Broadcast a message to all subscribed clients
+     */
+    broadcast(message) {
+        // Add to queue for new clients
+        this.messageQueue.push(message);
+        if (this.messageQueue.length > this.maxQueueSize) {
+            this.messageQueue.shift();
+        }
+        // Send to all connected clients
+        for (const client of this.clients.values()) {
+            if (this.shouldReceiveMessage(client, message)) {
+                this.sendToClient(client, message);
+            }
+        }
+    }
+    /**
+     * Broadcast team member status change
+     */
+    broadcastTeamMemberStatus(sessionId, teamMemberType, status, data) {
+        this.broadcast({
+            type: 'teamMember_status',
+            sessionId,
+            teamMemberType,
+            data: { status, ...data },
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Broadcast new communication
+     */
+    broadcastCommunication(sessionId, teamMemberType, communication) {
+        this.broadcast({
+            type: 'communication',
+            sessionId,
+            teamMemberType,
+            data: communication,
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Broadcast session creation
+     */
+    broadcastSessionCreated(sessionId, teamMemberType, task) {
+        this.broadcast({
+            type: 'session_created',
+            sessionId,
+            teamMemberType,
+            data: { task },
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Broadcast session end
+     */
+    broadcastSessionEnded(sessionId, teamMemberType, finalStatus) {
+        this.broadcast({
+            type: 'session_ended',
+            sessionId,
+            teamMemberType,
+            data: { finalStatus },
+            timestamp: new Date().toISOString()
+        });
+    }
+    /**
+     * Get number of connected clients
+     */
+    getClientCount() {
+        return this.clients.size;
+    }
+    /**
+     * Get client statistics
+     */
+    getStats() {
+        const bySubscription = {};
+        for (const client of this.clients.values()) {
+            for (const sub of client.subscriptions) {
+                bySubscription[sub] = (bySubscription[sub] || 0) + 1;
+            }
+        }
+        return {
+            totalClients: this.clients.size,
+            clientsBySubscription: bySubscription
+        };
+    }
+    /**
+     * Shutdown the WebSocket server
+     */
+    async shutdown() {
+        if (this.pingInterval) {
+            clearInterval(this.pingInterval);
+            this.pingInterval = null;
+        }
+        // Close all client connections
+        for (const client of this.clients.values()) {
+            client.ws.close(1000, 'Server shutting down');
+        }
+        this.clients.clear();
+        // Close the server
+        return new Promise((resolve) => {
+            this.wss.close(() => {
+                logger.info('Team Member WebSocket stream shut down');
+                resolve();
+            });
+        });
+    }
+}
+// ============================================================================
+// Per-Project Instance Management (Map pattern for project isolation)
+// ============================================================================
+import { getProjectPath } from '../../config.js';
+const teamMemberStreamsByProject = new Map();
+export function initializeTeamMemberStream(server, path, projectPath) {
+    const targetProject = projectPath || getProjectPath();
+    if (!teamMemberStreamsByProject.has(targetProject)) {
+        teamMemberStreamsByProject.set(targetProject, new TeamMemberStreamManager(server, path));
+    }
+    return teamMemberStreamsByProject.get(targetProject);
+}
+export function getTeamMemberStreamManager(projectPath) {
+    const targetProject = projectPath || getProjectPath();
+    return teamMemberStreamsByProject.get(targetProject) || null;
+}
+/**
+ * Shutdown and reset the TeamMemberStreamManager for a specific project
+ * MUST be called during server shutdown to prevent memory leaks
+ */
+export async function shutdownTeamMemberStream(projectPath) {
+    const targetProject = projectPath || getProjectPath();
+    const manager = teamMemberStreamsByProject.get(targetProject);
+    if (manager) {
+        await manager.shutdown();
+        teamMemberStreamsByProject.delete(targetProject);
+    }
+}
+/**
+ * Shutdown all TeamMemberStreamManagers across all projects
+ */
+export async function shutdownAllTeamMemberStreams() {
+    for (const [projectPath, manager] of teamMemberStreamsByProject.entries()) {
+        await manager.shutdown();
+        teamMemberStreamsByProject.delete(projectPath);
+    }
+}
+//# sourceMappingURL=teamMemberStream.js.map

package/dist/dashboard/websocket/teamMemberStream.js.map

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

package/dist/dashboard/websocket/terminalStream.d.ts

@@ -0,0 +1,130 @@
+/**
+ * terminalStream.ts - WebSocket Server for Terminal Output Streaming
+ *
+ * Watches the  Code output log file and broadcasts changes
+ * to connected WebSocket clients in real-time.
+ *
+ * Phase 5 Implementation - Live Terminal Output Streaming
+ */
+import { WebSocket, WebSocketServer } from 'ws';
+export interface TerminalMessage {
+    type: 'terminal_output' | 'terminal_history' | 'terminal_status' | 'terminal_error';
+    timestamp: string;
+    line?: string;
+    lines?: string[];
+    status?: string;
+    error?: string;
+}
+export interface TerminalStreamConfig {
+    logFilePath?: string;
+    maxHistoryLines?: number;
+    broadcastDebounceMs?: number;
+}
+export declare class TerminalStreamManager {
+    private logFilePath;
+    private maxHistoryLines;
+    private broadcastDebounceMs;
+    private connectedClients;
+    private lastPosition;
+    private fileWatcher;
+    private checkInterval;
+    private broadcastTimeout;
+    private pendingLines;
+    private isRunning;
+    private isRestartingWatcher;
+    private pendingRestartTimeout;
+    constructor(config?: TerminalStreamConfig);
+    /**
+     * Start the terminal stream manager
+     */
+    start(): void;
+    /**
+     * Stop the terminal stream manager
+     */
+    stop(): void;
+    /**
+     * Add a WebSocket client to the broadcast list
+     */
+    addClient(ws: WebSocket): void;
+    /**
+     * Handle incoming client messages
+     */
+    private handleClientMessage;
+    /**
+     * Ensure the log file exists
+     */
+    private ensureLogFile;
+    /**
+     * Start watching the log file for changes
+     */
+    private startFileWatching;
+    /**
+     * Restart file watching (e.g., after file rotation)
+     * MED-33 FIX: Added debounce and lock to prevent race conditions from rapid restarts
+     */
+    private restartFileWatching;
+    /**
+     * Read new content from the log file
+     */
+    private readNewContent;
+    /**
+     * Schedule a debounced broadcast
+     */
+    private scheduleBroadcast;
+    /**
+     * Sanitize a line for safe display
+     */
+    private sanitizeLine;
+    /**
+     * Broadcast a message to all connected clients
+     */
+    private broadcast;
+    /**
+     * Send history to a specific client
+     */
+    private sendHistory;
+    /**
+     * Send current status to a client
+     */
+    private sendStatus;
+    /**
+     * Get the last N lines from the log file
+     */
+    private getLastNLines;
+    /**
+     * Clear the log file
+     */
+    clearLog(): void;
+    /**
+     * Get the number of connected clients
+     */
+    getClientCount(): number;
+    /**
+     * Get the log file path
+     */
+    getLogFilePath(): string;
+}
+/**
+ * Get or create the terminal stream manager for current/specified project
+ */
+export declare function getTerminalStreamManager(config?: TerminalStreamConfig, projectPath?: string): TerminalStreamManager;
+/**
+ * Reset the terminal stream manager for current/specified project (for testing)
+ */
+export declare function resetTerminalStreamManager(projectPath?: string): void;
+/**
+ * Reset all terminal stream managers across all projects
+ */
+export declare function resetAllTerminalStreamManagers(): void;
+/**
+ * Integration function for WebSocket server
+ */
+export declare function setupTerminalWebSocket(wss: WebSocketServer, path?: string): TerminalStreamManager;
+declare const _default: {
+    TerminalStreamManager: typeof TerminalStreamManager;
+    getTerminalStreamManager: typeof getTerminalStreamManager;
+    resetTerminalStreamManager: typeof resetTerminalStreamManager;
+    setupTerminalWebSocket: typeof setupTerminalWebSocket;
+};
+export default _default;
+//# sourceMappingURL=terminalStream.d.ts.map

package/dist/dashboard/websocket/terminalStream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalStream.d.ts","sourceRoot":"","sources":["../../../src/dashboard/websocket/terminalStream.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAmBhD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;IACpF,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAMD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,SAAS,CAAkB;IAEnC,OAAO,CAAC,mBAAmB,CAAkB;IAC7C,OAAO,CAAC,qBAAqB,CAA+B;gBAEhD,MAAM,GAAE,oBAAyB;IAM7C;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,IAAI,IAAI,IAAI;IAkCZ;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI;IA0B9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkC3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAwC3B;;OAEG;IACH,OAAO,CAAC,cAAc;IA0CtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwBzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,SAAS;IAejB;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAkBhB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB;AASD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAOnH;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAQrE;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,IAAI,CAMrD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,eAAe,EAAE,IAAI,GAAE,MAAuB,GAAG,qBAAqB,CAQjH;;;;;;;AAED,wBAKE"}