agileflow 3.4.2 → 3.4.3

package/lib/dashboard-session.js

@@ -1,136 +0,0 @@
-'use strict';
-
-/**
- * dashboard-session.js - Dashboard Session Management
- *
- * Manages individual client sessions with rate limiting,
- * message history, and state tracking.
- * Extracted from dashboard-server.js for testability.
- */
-
-const { encodeWebSocketFrame } = require('./dashboard-websocket');
-
-// Session lifecycle
-const SESSION_TIMEOUT_MS = 4 * 60 * 60 * 1000; // 4 hours
-const SESSION_CLEANUP_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
-
-// Rate limiting (token bucket)
-const RATE_LIMIT_TOKENS = 100; // max messages per second
-const RATE_LIMIT_REFILL_MS = 1000; // refill interval
-
-// Lazy-loaded protocol
-let _protocol;
-function getProtocol() {
-  if (!_protocol) _protocol = require('./dashboard-protocol');
-  return _protocol;
-}
-
-/**
- * Session state for a connected dashboard
- */
-class DashboardSession {
-  constructor(id, ws, projectRoot) {
-    this.id = id;
-    this.ws = ws;
-    this.projectRoot = projectRoot;
-    this.messages = [];
-    this.state = 'connected';
-    this.lastActivity = new Date();
-    this.createdAt = new Date();
-    this.metadata = {};
-
-    // Token bucket rate limiter
-    this._rateTokens = RATE_LIMIT_TOKENS;
-    this._rateLastRefill = Date.now();
-  }
-
-  /**
-   * Check if session has expired
-   * @returns {boolean}
-   */
-  isExpired() {
-    return Date.now() - this.lastActivity.getTime() > SESSION_TIMEOUT_MS;
-  }
-
-  /**
-   * Rate-limit incoming messages (token bucket)
-   * @returns {boolean} true if allowed, false if rate-limited
-   */
-  checkRateLimit() {
-    const now = Date.now();
-    const elapsed = now - this._rateLastRefill;
-
-    // Refill tokens based on elapsed time
-    if (elapsed >= RATE_LIMIT_REFILL_MS) {
-      this._rateTokens = RATE_LIMIT_TOKENS;
-      this._rateLastRefill = now;
-    }
-
-    if (this._rateTokens <= 0) {
-      return false;
-    }
-
-    this._rateTokens--;
-    return true;
-  }
-
-  /**
-   * Send a message to the dashboard
-   * @param {Object} message - Message object
-   */
-  send(message) {
-    if (this.ws && this.ws.writable) {
-      try {
-        const frame = encodeWebSocketFrame(getProtocol().serializeMessage(message));
-        this.ws.write(frame);
-        this.lastActivity = new Date();
-      } catch (error) {
-        console.error(`[Session ${this.id}] Send error:`, error.message);
-      }
-    }
-  }
-
-  /**
-   * Add a message to conversation history
-   * @param {string} role - 'user' or 'assistant'
-   * @param {string} content - Message content
-   */
-  addMessage(role, content) {
-    this.messages.push({
-      role,
-      content,
-      timestamp: new Date().toISOString(),
-    });
-    this.lastActivity = new Date();
-  }
-
-  /**
-   * Get conversation history
-   * @returns {Array}
-   */
-  getHistory() {
-    return this.messages;
-  }
-
-  /**
-   * Update session state
-   * @param {string} state - New state (connected, thinking, idle, error)
-   */
-  setState(state) {
-    this.state = state;
-    this.send(
-      getProtocol().createSessionState(this.id, state, {
-        messageCount: this.messages.length,
-        lastActivity: this.lastActivity.toISOString(),
-      })
-    );
-  }
-}
-
-module.exports = {
-  DashboardSession,
-  SESSION_TIMEOUT_MS,
-  SESSION_CLEANUP_INTERVAL_MS,
-  RATE_LIMIT_TOKENS,
-  RATE_LIMIT_REFILL_MS,
-};

package/lib/dashboard-status.js

@@ -1,72 +0,0 @@
-'use strict';
-
-/**
- * dashboard-status.js - Status and Team Metrics
- *
- * Reads project status (stories/epics) and team metrics from disk,
- * and formats them for dashboard display.
- * Extracted from dashboard-server.js for testability.
- */
-
-const path = require('path');
-const fs = require('fs');
-
-/**
- * Build a project status summary from status.json
- * @param {string} projectRoot - Project root directory
- * @returns {Object|null} - Status summary or null if unavailable
- */
-function buildStatusSummary(projectRoot) {
-  const statusPath = path.join(projectRoot, 'docs', '09-agents', 'status.json');
-  if (!fs.existsSync(statusPath)) return null;
-
-  try {
-    const data = JSON.parse(fs.readFileSync(statusPath, 'utf8'));
-    const stories = data.stories || {};
-    const epics = data.epics || {};
-
-    const storyValues = Object.values(stories);
-    return {
-      total: storyValues.length,
-      done: storyValues.filter(s => s.status === 'done' || s.status === 'completed').length,
-      inProgress: storyValues.filter(s => s.status === 'in-progress').length,
-      ready: storyValues.filter(s => s.status === 'ready').length,
-      blocked: storyValues.filter(s => s.status === 'blocked').length,
-      epics: Object.entries(epics).map(([id, e]) => ({
-        id,
-        title: e.title || id,
-        status: e.status || 'unknown',
-        storyCount: (e.stories || []).length,
-        doneCount: (e.stories || []).filter(
-          sid =>
-            stories[sid] && (stories[sid].status === 'done' || stories[sid].status === 'completed')
-        ).length,
-      })),
-    };
-  } catch (error) {
-    console.error('[Status Update Error]', error.message);
-    return null;
-  }
-}
-
-/**
- * Read team metrics traces from session-state.json
- * @param {string} projectRoot - Project root directory
- * @returns {Object} - Map of traceId -> metrics, or empty object
- */
-function readTeamMetrics(projectRoot) {
-  const sessionStatePath = path.join(projectRoot, 'docs', '09-agents', 'session-state.json');
-  if (!fs.existsSync(sessionStatePath)) return {};
-
-  try {
-    const state = JSON.parse(fs.readFileSync(sessionStatePath, 'utf8'));
-    return (state.team_metrics && state.team_metrics.traces) || {};
-  } catch {
-    return {};
-  }
-}
-
-module.exports = {
-  buildStatusSummary,
-  readTeamMetrics,
-};

package/lib/dashboard-terminal.js

@@ -1,354 +0,0 @@
-'use strict';
-
-/**
- * dashboard-terminal.js - Terminal Management
- *
- * Handles PTY-based terminal instances and manages multiple
- * terminals per session. Supports node-pty with basic spawn fallback.
- * Extracted from dashboard-server.js for testability.
- */
-
-// Lazy-loaded dependencies
-let _childProcess, _crypto, _protocol;
-
-function getChildProcess() {
-  if (!_childProcess) _childProcess = require('child_process');
-  return _childProcess;
-}
-function getCrypto() {
-  if (!_crypto) _crypto = require('crypto');
-  return _crypto;
-}
-function getProtocol() {
-  if (!_protocol) _protocol = require('./dashboard-protocol');
-  return _protocol;
-}
-
-// Sensitive env var patterns to strip from terminal spawn
-const SENSITIVE_ENV_PATTERNS = /SECRET|TOKEN|PASSWORD|CREDENTIAL|API_KEY|PRIVATE_KEY|AUTH/i;
-
-/**
- * Terminal instance for integrated terminal
- */
-class TerminalInstance {
-  constructor(id, session, options = {}) {
-    this.id = id;
-    this.session = session;
-    this.cwd = options.cwd || session.projectRoot;
-    this.shell = options.shell || this.getDefaultShell();
-    this.cols = options.cols || 80;
-    this.rows = options.rows || 24;
-    this.pty = null;
-    this.closed = false;
-  }
-
-  /**
-   * Get the default shell for the current OS
-   */
-  getDefaultShell() {
-    if (process.platform === 'win32') {
-      return process.env.COMSPEC || 'cmd.exe';
-    }
-    return process.env.SHELL || '/bin/bash';
-  }
-
-  /**
-   * Get a filtered copy of environment variables with secrets removed
-   */
-  _getFilteredEnv() {
-    const filtered = {};
-    for (const [key, value] of Object.entries(process.env)) {
-      if (!SENSITIVE_ENV_PATTERNS.test(key)) {
-        filtered[key] = value;
-      }
-    }
-    return filtered;
-  }
-
-  /**
-   * Start the terminal process
-   */
-  start() {
-    try {
-      // Try to use node-pty for proper PTY support
-      const pty = require('node-pty');
-      const filteredEnv = this._getFilteredEnv();
-
-      this.pty = pty.spawn(this.shell, [], {
-        name: 'xterm-256color',
-        cols: this.cols,
-        rows: this.rows,
-        cwd: this.cwd,
-        env: {
-          ...filteredEnv,
-          TERM: 'xterm-256color',
-          COLORTERM: 'truecolor',
-        },
-      });
-
-      this.pty.onData(data => {
-        if (!this.closed) {
-          this.session.send(getProtocol().createTerminalOutput(this.id, data));
-        }
-      });
-
-      this.pty.onExit(({ exitCode }) => {
-        this.closed = true;
-        this.session.send(getProtocol().createTerminalExit(this.id, exitCode));
-      });
-
-      return true;
-    } catch (error) {
-      // Fallback to basic spawn if node-pty is not available
-      console.warn('[Terminal] node-pty not available, using basic spawn:', error.message);
-      return this.startBasicShell();
-    }
-  }
-
-  /**
-   * Fallback shell using basic spawn (no PTY)
-   * Note: This provides limited functionality without node-pty
-   */
-  startBasicShell() {
-    try {
-      const filteredEnv = this._getFilteredEnv();
-
-      // Use bash with interactive flag for better compatibility
-      this.pty = getChildProcess().spawn(this.shell, ['-i'], {
-        cwd: this.cwd,
-        env: {
-          ...filteredEnv,
-          TERM: 'dumb',
-          PS1: '\\w $ ', // Simple prompt
-        },
-        shell: false,
-        stdio: ['pipe', 'pipe', 'pipe'],
-      });
-
-      // Track input buffer for local echo (since no PTY)
-      this.inputBuffer = '';
-
-      this.pty.stdout.on('data', data => {
-        if (!this.closed) {
-          this.session.send(getProtocol().createTerminalOutput(this.id, data.toString()));
-        }
-      });
-
-      this.pty.stderr.on('data', data => {
-        if (!this.closed) {
-          this.session.send(getProtocol().createTerminalOutput(this.id, data.toString()));
-        }
-      });
-
-      this.pty.on('close', exitCode => {
-        this.closed = true;
-        this.session.send(getProtocol().createTerminalExit(this.id, exitCode));
-      });
-
-      this.pty.on('error', error => {
-        console.error('[Terminal] Shell error:', error.message);
-        if (!this.closed) {
-          this.session.send(
-            getProtocol().createTerminalOutput(this.id, `\r\nError: ${error.message}\r\n`)
-          );
-        }
-      });
-
-      // Send welcome message
-      setTimeout(() => {
-        if (!this.closed) {
-          const welcomeMsg = `\x1b[32mAgileFlow Terminal\x1b[0m (basic mode - node-pty not available)\r\n`;
-          const cwdMsg = `Working directory: ${this.cwd}\r\n\r\n`;
-          this.session.send(getProtocol().createTerminalOutput(this.id, welcomeMsg + cwdMsg));
-        }
-      }, 100);
-
-      return true;
-    } catch (error) {
-      console.error('[Terminal] Failed to start basic shell:', error.message);
-      return false;
-    }
-  }
-
-  /**
-   * Write data to the terminal
-   * @param {string} data - Data to write (user input)
-   */
-  write(data) {
-    if (this.pty && !this.closed) {
-      if (this.pty.write) {
-        // node-pty style - has built-in echo
-        this.pty.write(data);
-      } else if (this.pty.stdin) {
-        // basic spawn style - need manual echo
-        // Echo the input back to the terminal (since no PTY)
-        let echoData = data;
-
-        // Handle special characters
-        if (data === '\r' || data === '\n') {
-          echoData = '\r\n';
-        } else if (data === '\x7f' || data === '\b') {
-          // Backspace - move cursor back and clear
-          echoData = '\b \b';
-        } else if (data === '\x03') {
-          // Ctrl+C
-          echoData = '^C\r\n';
-        }
-
-        // Echo to terminal
-        this.session.send(getProtocol().createTerminalOutput(this.id, echoData));
-
-        // Send to shell stdin
-        this.pty.stdin.write(data);
-      }
-    }
-  }
-
-  /**
-   * Resize the terminal
-   * @param {number} cols - New column count
-   * @param {number} rows - New row count
-   */
-  resize(cols, rows) {
-    this.cols = cols;
-    this.rows = rows;
-    if (this.pty && this.pty.resize && !this.closed) {
-      this.pty.resize(cols, rows);
-    }
-  }
-
-  /**
-   * Close the terminal
-   */
-  close() {
-    this.closed = true;
-    if (this.pty) {
-      if (this.pty.kill) {
-        this.pty.kill();
-      } else if (this.pty.destroy) {
-        this.pty.destroy();
-      }
-    }
-  }
-}
-
-/**
- * Terminal manager for handling multiple terminals per session
- */
-class TerminalManager {
-  constructor() {
-    this.terminals = new Map();
-  }
-
-  /**
-   * Create a new terminal for a session
-   * @param {DashboardSession} session - The session
-   * @param {Object} options - Terminal options
-   * @returns {string} - Terminal ID
-   */
-  createTerminal(session, options = {}) {
-    const terminalId = options.id || getCrypto().randomBytes(8).toString('hex');
-    const terminal = new TerminalInstance(terminalId, session, {
-      cwd: options.cwd || session.projectRoot,
-      cols: options.cols,
-      rows: options.rows,
-    });
-
-    if (terminal.start()) {
-      this.terminals.set(terminalId, terminal);
-      console.log(`[Terminal ${terminalId}] Created for session ${session.id}`);
-      return terminalId;
-    }
-
-    return null;
-  }
-
-  /**
-   * Get a terminal by ID
-   * @param {string} terminalId - Terminal ID
-   * @returns {TerminalInstance | undefined}
-   */
-  getTerminal(terminalId) {
-    return this.terminals.get(terminalId);
-  }
-
-  /**
-   * Write to a terminal
-   * @param {string} terminalId - Terminal ID
-   * @param {string} data - Data to write
-   */
-  writeToTerminal(terminalId, data) {
-    const terminal = this.terminals.get(terminalId);
-    if (terminal) {
-      terminal.write(data);
-    }
-  }
-
-  /**
-   * Resize a terminal
-   * @param {string} terminalId - Terminal ID
-   * @param {number} cols - New columns
-   * @param {number} rows - New rows
-   */
-  resizeTerminal(terminalId, cols, rows) {
-    const terminal = this.terminals.get(terminalId);
-    if (terminal) {
-      terminal.resize(cols, rows);
-    }
-  }
-
-  /**
-   * Close a terminal
-   * @param {string} terminalId - Terminal ID
-   */
-  closeTerminal(terminalId) {
-    const terminal = this.terminals.get(terminalId);
-    if (terminal) {
-      terminal.close();
-      this.terminals.delete(terminalId);
-      console.log(`[Terminal ${terminalId}] Closed`);
-    }
-  }
-
-  /**
-   * Close all terminals for a session
-   * @param {string} sessionId - Session ID
-   */
-  closeSessionTerminals(sessionId) {
-    // Collect IDs first to avoid mutating Map during iteration
-    const toClose = [];
-    for (const [terminalId, terminal] of this.terminals) {
-      if (terminal.session.id === sessionId) {
-        toClose.push(terminalId);
-      }
-    }
-    for (const terminalId of toClose) {
-      const terminal = this.terminals.get(terminalId);
-      if (terminal) {
-        terminal.close();
-        this.terminals.delete(terminalId);
-      }
-    }
-  }
-
-  /**
-   * Get all terminals for a session
-   * @param {string} sessionId - Session ID
-   * @returns {Array<string>} - Terminal IDs
-   */
-  getSessionTerminals(sessionId) {
-    const terminalIds = [];
-    for (const [terminalId, terminal] of this.terminals) {
-      if (terminal.session.id === sessionId) {
-        terminalIds.push(terminalId);
-      }
-    }
-    return terminalIds;
-  }
-}
-
-module.exports = {
-  TerminalInstance,
-  TerminalManager,
-  SENSITIVE_ENV_PATTERNS,
-};

package/lib/dashboard-websocket.js

@@ -1,88 +0,0 @@
-'use strict';
-
-/**
- * dashboard-websocket.js - WebSocket Frame Encoding/Decoding
- *
- * Pure functions for encoding and decoding WebSocket frames.
- * Extracted from dashboard-server.js for testability.
- */
-
-/**
- * Encode a WebSocket frame
- * @param {string|Buffer} data - Data to encode
- * @param {number} [opcode=0x1] - Frame opcode (0x1 = text, 0x2 = binary)
- * @returns {Buffer}
- */
-function encodeWebSocketFrame(data, opcode = 0x1) {
-  const payload = Buffer.isBuffer(data) ? data : Buffer.from(data);
-  const length = payload.length;
-
-  let header;
-  if (length < 126) {
-    header = Buffer.alloc(2);
-    header[0] = 0x80 | opcode; // FIN + opcode
-    header[1] = length;
-  } else if (length < 65536) {
-    header = Buffer.alloc(4);
-    header[0] = 0x80 | opcode;
-    header[1] = 126;
-    header.writeUInt16BE(length, 2);
-  } else {
-    header = Buffer.alloc(10);
-    header[0] = 0x80 | opcode;
-    header[1] = 127;
-    header.writeBigUInt64BE(BigInt(length), 2);
-  }
-
-  return Buffer.concat([header, payload]);
-}
-
-/**
- * Decode a WebSocket frame
- * @param {Buffer} buffer - Buffer containing frame data
- * @returns {{ opcode: number, payload: Buffer, totalLength: number } | null}
- */
-function decodeWebSocketFrame(buffer) {
-  if (buffer.length < 2) return null;
-
-  const firstByte = buffer[0];
-  const secondByte = buffer[1];
-
-  const opcode = firstByte & 0x0f;
-  const masked = (secondByte & 0x80) !== 0;
-  let payloadLength = secondByte & 0x7f;
-
-  let headerLength = 2;
-  if (payloadLength === 126) {
-    if (buffer.length < 4) return null;
-    payloadLength = buffer.readUInt16BE(2);
-    headerLength = 4;
-  } else if (payloadLength === 127) {
-    if (buffer.length < 10) return null;
-    payloadLength = Number(buffer.readBigUInt64BE(2));
-    headerLength = 10;
-  }
-
-  if (masked) headerLength += 4;
-
-  const totalLength = headerLength + payloadLength;
-  if (buffer.length < totalLength) return null;
-
-  let payload = buffer.slice(headerLength, totalLength);
-
-  // Unmask if needed
-  if (masked) {
-    const mask = buffer.slice(headerLength - 4, headerLength);
-    payload = Buffer.alloc(payloadLength);
-    for (let i = 0; i < payloadLength; i++) {
-      payload[i] = buffer[headerLength + i] ^ mask[i % 4];
-    }
-  }
-
-  return { opcode, payload, totalLength };
-}
-
-module.exports = {
-  encodeWebSocketFrame,
-  decodeWebSocketFrame,
-};