crewly 1.0.0

package/dist/backend/backend/src/websocket/file-watcher.gateway.js

@@ -0,0 +1,202 @@
+import { LoggerService } from '../services/index.js';
+export class FileWatcherGateway {
+    server;
+    logger;
+    fileWatcher;
+    clientProjects = new Map(); // clientId -> Set of projectIds
+    projectClients = new Map(); // projectId -> Set of clientIds
+    constructor(server, fileWatcher) {
+        this.server = server;
+        this.logger = LoggerService.getInstance();
+        this.fileWatcher = fileWatcher;
+        // Listen to file watcher events
+        this.setupFileWatcherListeners();
+        this.setupSocketHandlers();
+    }
+    setupSocketHandlers() {
+        this.server.on('connection', (socket) => {
+            this.handleConnection(socket);
+            socket.on('disconnect', () => {
+                this.handleDisconnect(socket);
+            });
+            socket.on('subscribe-project', (data) => {
+                this.handleSubscribeProject(socket, data);
+            });
+            socket.on('unsubscribe-project', (data) => {
+                this.handleUnsubscribeProject(socket, data);
+            });
+            socket.on('get-stats', () => {
+                this.handleGetStats(socket);
+            });
+            socket.on('get-watched-projects', () => {
+                this.handleGetWatchedProjects(socket);
+            });
+            socket.on('trigger-scan', (data) => {
+                this.handleTriggerScan(socket, data);
+            });
+        });
+    }
+    handleConnection(client) {
+        this.logger.info(`File Watcher client connected: ${client.id}`);
+        this.clientProjects.set(client.id, new Set());
+    }
+    handleDisconnect(client) {
+        this.logger.info(`File Watcher client disconnected: ${client.id}`);
+        // Cleanup client subscriptions
+        const subscribedProjects = this.clientProjects.get(client.id);
+        if (subscribedProjects) {
+            for (const projectId of subscribedProjects) {
+                const projectClients = this.projectClients.get(projectId);
+                if (projectClients) {
+                    projectClients.delete(client.id);
+                    if (projectClients.size === 0) {
+                        this.projectClients.delete(projectId);
+                    }
+                }
+            }
+        }
+        this.clientProjects.delete(client.id);
+    }
+    /**
+     * Subscribe to file changes for a specific project
+     */
+    handleSubscribeProject(client, data) {
+        const { projectId } = data;
+        // Add client to project subscriptions
+        const clientProjects = this.clientProjects.get(client.id) || new Set();
+        clientProjects.add(projectId);
+        this.clientProjects.set(client.id, clientProjects);
+        // Add client to project's client list
+        const projectClients = this.projectClients.get(projectId) || new Set();
+        projectClients.add(client.id);
+        this.projectClients.set(projectId, projectClients);
+        this.logger.info(`Client ${client.id} subscribed to project ${projectId}`);
+        // Send current watcher status
+        client.emit('subscription-confirmed', {
+            projectId,
+            isWatching: this.fileWatcher.isWatching(projectId),
+            stats: this.fileWatcher.getStats()
+        });
+    }
+    /**
+     * Unsubscribe from file changes for a specific project
+     */
+    handleUnsubscribeProject(client, data) {
+        const { projectId } = data;
+        // Remove client from project subscriptions
+        const clientProjects = this.clientProjects.get(client.id);
+        if (clientProjects) {
+            clientProjects.delete(projectId);
+        }
+        // Remove client from project's client list
+        const projectClients = this.projectClients.get(projectId);
+        if (projectClients) {
+            projectClients.delete(client.id);
+            if (projectClients.size === 0) {
+                this.projectClients.delete(projectId);
+            }
+        }
+        this.logger.info(`Client ${client.id} unsubscribed from project ${projectId}`);
+        client.emit('unsubscription-confirmed', { projectId });
+    }
+    /**
+     * Get file watcher statistics
+     */
+    handleGetStats(client) {
+        const stats = this.fileWatcher.getStats();
+        client.emit('stats', stats);
+    }
+    /**
+     * Get list of watched projects
+     */
+    handleGetWatchedProjects(client) {
+        const watchedProjects = this.fileWatcher.getWatchedProjects();
+        client.emit('watched-projects', watchedProjects);
+    }
+    /**
+     * Manually trigger file scan for a project
+     */
+    async handleTriggerScan(client, data) {
+        try {
+            const { projectId, projectPath } = data;
+            // Restart watcher for this project
+            if (this.fileWatcher.isWatching(projectId)) {
+                await this.fileWatcher.stopWatchingProject(projectId);
+            }
+            await this.fileWatcher.watchProject(projectId, projectPath);
+            client.emit('scan-completed', { projectId, success: true });
+            this.logger.info(`Manual scan triggered for project ${projectId}`);
+        }
+        catch (error) {
+            client.emit('scan-error', {
+                projectId: data.projectId,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
+            this.logger.error('Manual scan failed:', { error: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    /**
+     * Setup listeners for file watcher events
+     */
+    setupFileWatcherListeners() {
+        // Listen for file change events
+        this.fileWatcher.on('fileChange', (event) => {
+            this.broadcastToProject(event.projectId, 'file-change', event);
+        });
+        // Listen for context refresh events
+        this.fileWatcher.on('contextRefresh', (data) => {
+            this.broadcastToProject(data.projectId, 'context-refresh', data);
+        });
+        // Listen for task changes
+        this.fileWatcher.on('tasksChanged', (data) => {
+            this.broadcastToProject(data.projectId, 'tasks-changed', data);
+        });
+        // Listen for memory updates
+        this.fileWatcher.on('memoryUpdated', (data) => {
+            this.broadcastToProject(data.projectId, 'memory-updated', data);
+        });
+        // Listen for prompt changes
+        this.fileWatcher.on('promptsChanged', (data) => {
+            this.broadcastToProject(data.projectId, 'prompts-changed', data);
+        });
+        // Listen for general project changes
+        this.fileWatcher.on('projectChanged', (data) => {
+            this.broadcastToProject(data.projectId, 'project-changed', data);
+        });
+    }
+    /**
+     * Broadcast message to all clients subscribed to a project
+     */
+    broadcastToProject(projectId, event, data) {
+        const projectClients = this.projectClients.get(projectId);
+        if (!projectClients || projectClients.size === 0) {
+            return;
+        }
+        for (const clientId of projectClients) {
+            const socket = this.server.sockets.sockets.get(clientId);
+            if (socket) {
+                socket.emit(event, data);
+            }
+        }
+        this.logger.debug(`Broadcasted ${event} to ${projectClients.size} clients for project ${projectId}`);
+    }
+    /**
+     * Broadcast stats update to all connected clients
+     */
+    broadcastStats() {
+        const stats = this.fileWatcher.getStats();
+        this.server.emit('stats-update', stats);
+    }
+    /**
+     * Get connection statistics
+     */
+    getConnectionStats() {
+        return {
+            totalClients: this.clientProjects.size,
+            projectSubscriptions: Array.from(this.clientProjects.values())
+                .reduce((sum, projects) => sum + projects.size, 0),
+            activeProjects: this.projectClients.size
+        };
+    }
+}
+//# sourceMappingURL=file-watcher.gateway.js.map

package/dist/backend/backend/src/websocket/file-watcher.gateway.js.map

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

package/dist/backend/backend/src/websocket/terminal.gateway.d.ts

@@ -0,0 +1,310 @@
+/**
+ * Terminal Gateway Module
+ *
+ * Provides WebSocket-based real-time terminal streaming for PTY sessions.
+ * Uses event-based streaming instead of polling for better performance.
+ *
+ * @module terminal-gateway
+ */
+import { Server as SocketIOServer, Socket } from 'socket.io';
+/**
+ * Terminal Gateway class for WebSocket-based terminal streaming.
+ *
+ * Provides:
+ * - Real-time terminal output streaming via PTY onData events
+ * - Terminal input forwarding to PTY sessions
+ * - Terminal resize handling
+ * - Session subscription management
+ */
+export declare class TerminalGateway {
+    private io;
+    private logger;
+    /** Map of session name to set of subscribed socket IDs */
+    private connectedClients;
+    /** Map of session name to unsubscribe function for PTY onData */
+    private sessionSubscriptions;
+    /** Set of sessions with persistent monitoring (not stopped on client disconnect) */
+    private persistentMonitoringSessions;
+    /** Current active chat conversation ID for orchestrator responses */
+    private activeConversationId;
+    /** Buffer to accumulate orchestrator output for [NOTIFY] / legacy marker detection */
+    private orchestratorOutputBuffer;
+    /** Maximum buffer size to prevent memory issues (100KB) */
+    private readonly MAX_BUFFER_SIZE;
+    /** Deduplicator for recently sent chat responses */
+    private responseDeduplicator;
+    /**
+     * Create a new TerminalGateway.
+     *
+     * @param io - Socket.IO server instance
+     */
+    constructor(io: SocketIOServer);
+    /**
+     * Set up WebSocket event handlers.
+     */
+    private setupEventHandlers;
+    /**
+     * Subscribe a client to a specific terminal session.
+     *
+     * @param sessionName - The session to subscribe to
+     * @param socket - The client socket
+     */
+    subscribeToSession(sessionName: string, socket: Socket): void;
+    /**
+     * Start streaming output from a PTY session.
+     * Uses event-based onData instead of polling.
+     *
+     * @param sessionName - The session to stream from
+     * @returns True if streaming started successfully, false otherwise
+     */
+    private startPtyStreaming;
+    /**
+     * Stop streaming output from a PTY session.
+     * Does not stop sessions with persistent monitoring enabled.
+     *
+     * @param sessionName - The session to stop streaming from
+     * @param force - Force stop even for persistent monitoring sessions
+     */
+    private stopPtyStreaming;
+    /**
+     * Start persistent monitoring for the orchestrator session.
+     * This ensures chat responses are captured even when no WebSocket clients are viewing the terminal.
+     *
+     * @param sessionName - The orchestrator session name to monitor
+     * @returns True if monitoring started successfully
+     */
+    startOrchestratorChatMonitoring(sessionName: string): boolean;
+    /**
+     * Stop persistent monitoring for the orchestrator session.
+     *
+     * @param sessionName - The orchestrator session name
+     */
+    stopOrchestratorChatMonitoring(sessionName: string): void;
+    /**
+     * Clean up session subscription when session ends.
+     *
+     * @param sessionName - The session to clean up
+     */
+    private cleanupSessionSubscription;
+    /**
+     * Unsubscribe a client from a terminal session.
+     *
+     * @param sessionName - The session to unsubscribe from
+     * @param socket - The client socket
+     */
+    unsubscribeFromSession(sessionName: string, socket: Socket): void;
+    /**
+     * Send input to a terminal session.
+     *
+     * @param sessionName - The session to send input to
+     * @param input - The input string
+     * @param socket - The client socket
+     */
+    sendInput(sessionName: string, input: string, socket: Socket): Promise<void>;
+    /**
+     * Handle terminal resize events.
+     *
+     * @param sessionName - The session to resize
+     * @param cols - New column count
+     * @param rows - New row count
+     */
+    private handleTerminalResize;
+    /**
+     * Handle client disconnection.
+     *
+     * @param socket - The disconnected client socket
+     */
+    private handleClientDisconnect;
+    /**
+     * Broadcast terminal output to all subscribers of a session.
+     * Also processes orchestrator output for chat responses.
+     *
+     * @param sessionName - The session name
+     * @param output - The terminal output
+     */
+    private broadcastOutput;
+    /**
+     * Process orchestrator terminal output for [NOTIFY], legacy [CHAT_RESPONSE],
+     * and legacy [SLACK_NOTIFY] markers.
+     *
+     * Buffers output, then runs the unified [NOTIFY] handler first, followed by
+     * legacy handlers for backward compatibility with orchestrators that haven't
+     * restarted yet.
+     *
+     * @param sessionName - The orchestrator session name
+     * @param content - The terminal output content
+     */
+    private processOrchestratorOutputForChat;
+    /**
+     * Build a SlackNotification from a NotifyPayload.
+     *
+     * @param payload - Parsed notify payload
+     * @returns SlackNotification with defaults applied
+     */
+    private buildSlackNotification;
+    /**
+     * Send a notification to the Slack bridge with error handling.
+     *
+     * @param notification - The Slack notification to send
+     * @param context - Description of the call site for logging
+     */
+    private sendToSlackBridge;
+    /**
+     * Process unified [NOTIFY]...[/NOTIFY] markers from the orchestrator output buffer.
+     *
+     * Parses header+body (or legacy JSON) payload via `parseNotifyContent()` and
+     * routes to chat, Slack, or both based on which fields are present:
+     * - `conversationId` present → route to chat UI
+     * - `channelId` present → route to Slack
+     * - Both → both (common case)
+     * - Neither + activeConversationId exists → fallback to chat
+     * - `type` alone (no channelId) → chat only (type is metadata, not a routing signal)
+     *
+     * @param sessionName - The orchestrator session name
+     */
+    private processNotifyMarkers;
+    /**
+     * Handle a single parsed NOTIFY payload — route to chat and/or Slack.
+     *
+     * When a channelId is present, Slack delivery metadata is stored on the chat
+     * message with `slackDeliveryStatus: 'pending'`. On successful Slack delivery,
+     * the status is updated to `'delivered'`. On failure, the error and attempt count
+     * are recorded, and the reconciliation service will retry later.
+     *
+     * @param sessionName - The orchestrator session name
+     * @param payload - Parsed NOTIFY payload
+     */
+    private handleNotifyPayload;
+    /**
+     * Trim the orchestrator output buffer if there are no pending open markers.
+     * Prevents unbounded growth when output doesn't contain any markers.
+     */
+    private trimBufferIfNoOpenMarkers;
+    /**
+     * Process legacy [CHAT_RESPONSE]...[/CHAT_RESPONSE] markers from the buffer.
+     * @deprecated Use [NOTIFY] markers instead. Kept for backward compatibility.
+     *
+     * @param sessionName - The orchestrator session name
+     */
+    private processLegacyChatResponse;
+    /**
+     * Process legacy [SLACK_NOTIFY]...[/SLACK_NOTIFY] markers from the buffer.
+     * @deprecated Use [NOTIFY] markers instead. Kept for backward compatibility.
+     */
+    private processLegacySlackNotifications;
+    /**
+     * Clear the orchestrator output buffer.
+     * Called when conversation changes or on cleanup.
+     */
+    clearOrchestratorBuffer(): void;
+    /**
+     * Set the active conversation ID for orchestrator chat responses.
+     * Clears the output buffer when conversation changes.
+     *
+     * @param conversationId - The conversation ID to set
+     */
+    setActiveConversationId(conversationId: string | null): void;
+    /**
+     * Get the active conversation ID.
+     *
+     * @returns The active conversation ID or null
+     */
+    getActiveConversationId(): string | null;
+    /**
+     * Broadcast session status changes.
+     *
+     * @param sessionName - The session name
+     * @param status - The status string
+     */
+    private broadcastSessionStatus;
+    /**
+     * Broadcast general messages to session subscribers.
+     *
+     * @param sessionName - The session name
+     * @param type - Message type
+     * @param payload - Message payload
+     */
+    private broadcastMessage;
+    /**
+     * Send current terminal state to a new subscriber.
+     *
+     * @param sessionName - The session name
+     * @param socket - The client socket
+     */
+    private sendCurrentTerminalState;
+    /**
+     * Get statistics about connected clients.
+     *
+     * @returns Connection statistics
+     */
+    getConnectionStats(): {
+        totalClients: number;
+        sessionSubscriptions: Record<string, number>;
+        totalSessions: number;
+        activeStreams: number;
+    };
+    /**
+     * Force disconnect all clients from a session.
+     *
+     * @param sessionName - The session name
+     */
+    disconnectSessionClients(sessionName: string): void;
+    /**
+     * Broadcast system-wide notifications.
+     *
+     * @param message - Notification message
+     * @param type - Notification type
+     */
+    broadcastSystemNotification(message: string, type?: 'info' | 'warning' | 'error'): void;
+    /**
+     * Broadcast orchestrator status changes.
+     *
+     * @param orchestratorData - Orchestrator data
+     */
+    broadcastOrchestratorStatus(orchestratorData: unknown): void;
+    /**
+     * Broadcast team member status changes.
+     *
+     * @param memberData - Team member data
+     */
+    broadcastTeamMemberStatus(memberData: unknown): void;
+    /**
+     * Broadcast a system resource alert to all connected clients.
+     *
+     * @param alertData - Alert details including key, message, severity, and timestamp
+     */
+    broadcastSystemResourceAlert(alertData: {
+        alertKey: string;
+        message: string;
+        severity: string;
+        timestamp: string;
+    }): void;
+    /**
+     * Broadcast comprehensive team activity updates.
+     *
+     * @param activityData - Activity data
+     */
+    broadcastTeamActivity(activityData: unknown): void;
+    /**
+     * Destroy the gateway and clean up all subscriptions.
+     */
+    destroy(): void;
+}
+/**
+ * Set the terminal gateway singleton instance.
+ * Called during server initialization.
+ *
+ * @param gateway - The TerminalGateway instance
+ */
+export declare function setTerminalGateway(gateway: TerminalGateway): void;
+/**
+ * Get the terminal gateway singleton instance.
+ *
+ * @returns The TerminalGateway instance or null if not initialized
+ */
+export declare function getTerminalGateway(): TerminalGateway | null;
+/**
+ * Reset the terminal gateway singleton instance (for testing).
+ */
+export declare function resetTerminalGateway(): void;
+//# sourceMappingURL=terminal.gateway.d.ts.map

package/dist/backend/backend/src/websocket/terminal.gateway.d.ts.map

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