agileflow 3.4.2 → 3.4.3

package/scripts/dashboard-serve.js

@@ -1,336 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * dashboard-serve.js - AgileFlow Dashboard WebSocket Server CLI
- *
- * Starts a WebSocket server that the AgileFlow Dashboard can connect to
- * for real-time communication with Claude Code.
- *
- * Usage:
- *   agileflow serve [options]
- *   node scripts/dashboard-serve.js [options]
- *
- * Options:
- *   --port, -p     Port to listen on (default: 8765)
- *   --host, -h     Host to bind to (default: 0.0.0.0)
- *   --api-key, -k  API key for authentication
- *   --require-auth Require API key for connections
- *   --tunnel, -t   Start ngrok tunnel (if installed)
- */
-
-'use strict';
-
-const path = require('path');
-const {
-  createDashboardServer,
-  startDashboardServer,
-  stopDashboardServer,
-} = require('../lib/dashboard-server');
-const {
-  createNotification,
-  createTextDelta,
-  createToolStart,
-  createToolResult,
-  createAskUserQuestion,
-} = require('../lib/dashboard-protocol');
-const { createClaudeBridge } = require('../lib/claude-cli-bridge');
-
-// Parse command line arguments
-function parseArgs() {
-  const args = process.argv.slice(2);
-  const options = {
-    port: 8765,
-    host: '0.0.0.0',
-    apiKey: null,
-    requireAuth: false,
-    tunnel: false,
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    const next = args[i + 1];
-
-    switch (arg) {
-      case '--port':
-      case '-p':
-        options.port = parseInt(next, 10);
-        i++;
-        break;
-      case '--host':
-      case '-h':
-        options.host = next;
-        i++;
-        break;
-      case '--api-key':
-      case '-k':
-        options.apiKey = next;
-        options.requireAuth = true;
-        i++;
-        break;
-      case '--require-auth':
-        options.requireAuth = true;
-        break;
-      case '--tunnel':
-      case '-t':
-        options.tunnel = true;
-        break;
-      case '--help':
-        printHelp();
-        process.exit(0);
-    }
-  }
-
-  return options;
-}
-
-function printHelp() {
-  console.log(`
-AgileFlow Dashboard Server
-
-Starts a WebSocket server for the AgileFlow Dashboard to connect to.
-
-Usage:
-  agileflow serve [options]
-  node scripts/dashboard-serve.js [options]
-
-Options:
-  --port, -p <port>    Port to listen on (default: 8765)
-  --host, -h <host>    Host to bind to (default: 0.0.0.0)
-  --api-key, -k <key>  API key for authentication
-  --require-auth       Require API key for connections
-  --tunnel, -t         Start ngrok tunnel (requires ngrok)
-  --help               Show this help message
-
-Examples:
-  # Start with default settings
-  agileflow serve
-
-  # Start on custom port with API key
-  agileflow serve --port 9000 --api-key agf_secret123
-
-  # Start with ngrok tunnel
-  agileflow serve --tunnel
-
-Dashboard Connection:
-  The dashboard should connect to ws://localhost:<port>
-  Or use the tunnel URL if --tunnel is enabled.
-`);
-}
-
-function printBanner() {
-  console.log(`
-╔═══════════════════════════════════════════════════════════╗
-║                                                           ║
-║   █████╗  ██████╗ ██╗██╗     ███████╗███████╗██╗      ║
-║  ██╔══██╗██╔════╝ ██║██║     ██╔════╝██╔════╝██║      ║
-║  ███████║██║  ███╗██║██║     █████╗  █████╗  ██║      ║
-║  ██╔══██║██║   ██║██║██║     ██╔══╝  ██╔══╝  ██║      ║
-║  ██║  ██║╚██████╔╝██║███████╗███████╗██║     ███████╗ ║
-║  ╚═╝  ╚═╝ ╚═════╝ ╚═╝╚══════╝╚══════╝╚═╝     ╚══════╝ ║
-║                                                           ║
-║              Dashboard WebSocket Server                   ║
-║                                                           ║
-╚═══════════════════════════════════════════════════════════╝
-`);
-}
-
-async function startTunnel(port) {
-  try {
-    const { exec } = require('child_process');
-
-    return new Promise((resolve, reject) => {
-      // Check if ngrok is installed
-      exec('which ngrok', error => {
-        if (error) {
-          console.log('  Tunnel: ngrok not found. Install with: npm install -g ngrok');
-          resolve(null);
-          return;
-        }
-
-        // Start ngrok tunnel
-        const ngrok = exec(`ngrok http ${port} --log stdout`, { encoding: 'utf8' });
-
-        ngrok.stdout.on('data', data => {
-          // Parse ngrok output for public URL
-          const urlMatch = data.match(/url=(https?:\/\/[^\s]+)/);
-          if (urlMatch) {
-            const tunnelUrl = urlMatch[1].replace('https://', 'wss://').replace('http://', 'ws://');
-            console.log(`  Tunnel: ${tunnelUrl}`);
-            resolve(tunnelUrl);
-          }
-        });
-
-        ngrok.stderr.on('data', data => {
-          console.error('  Tunnel error:', data);
-        });
-
-        // Give ngrok a moment to start
-        setTimeout(() => {
-          if (!ngrok.killed) {
-            console.log('  Tunnel: Starting... check ngrok dashboard');
-            resolve(null);
-          }
-        }, 5000);
-      });
-    });
-  } catch (error) {
-    console.log('  Tunnel: Failed to start -', error.message);
-    return null;
-  }
-}
-
-async function main() {
-  const options = parseArgs();
-
-  printBanner();
-
-  console.log('Starting server...\n');
-
-  try {
-    // Create server
-    const server = createDashboardServer({
-      port: options.port,
-      host: options.host,
-      apiKey: options.apiKey,
-      requireAuth: options.requireAuth,
-    });
-
-    // Set up event handlers
-    setupEventHandlers(server);
-
-    // Start server
-    const { wsUrl } = await startDashboardServer(server);
-
-    // Start tunnel if requested
-    if (options.tunnel) {
-      await startTunnel(options.port);
-    }
-
-    console.log('─────────────────────────────────────────────────────────────');
-    console.log('');
-    console.log('  Ready! Connect your dashboard to:');
-    console.log(`  ${wsUrl}`);
-    console.log('');
-    if (options.apiKey) {
-      console.log(`  API Key: ${options.apiKey.slice(0, 8)}...`);
-      console.log('');
-    }
-    console.log('  Press Ctrl+C to stop.');
-    console.log('');
-    console.log('─────────────────────────────────────────────────────────────');
-    console.log('');
-
-    // Handle shutdown
-    const shutdown = async () => {
-      console.log('\nShutting down...');
-      await stopDashboardServer(server);
-      process.exit(0);
-    };
-
-    process.on('SIGINT', shutdown);
-    process.on('SIGTERM', shutdown);
-  } catch (error) {
-    console.error('Failed to start server:', error.message);
-    process.exit(1);
-  }
-}
-
-/**
- * Set up event handlers for the dashboard server
- */
-function setupEventHandlers(server) {
-  // Session events
-  server.on('session:connected', (sessionId, session) => {
-    console.log(`[${new Date().toISOString()}] Session connected: ${sessionId}`);
-  });
-
-  server.on('session:disconnected', sessionId => {
-    console.log(`[${new Date().toISOString()}] Session disconnected: ${sessionId}`);
-  });
-
-  // User message handler - use Claude CLI bridge
-  server.on('user:message', async (session, content) => {
-    console.log(
-      `[${new Date().toISOString()}] Message from ${session.id}: ${content.slice(0, 50)}...`
-    );
-
-    try {
-      await handleClaudeMessage(session, content, server.projectRoot);
-    } catch (error) {
-      console.error(`[${new Date().toISOString()}] Claude error:`, error.message);
-      session.send(createNotification('error', 'Error', error.message));
-      session.setState('error');
-    }
-  });
-
-  // Cancel handler
-  server.on('user:cancel', session => {
-    console.log(`[${new Date().toISOString()}] Cancel from ${session.id}`);
-  });
-
-  // Refresh handlers
-  server.on('refresh:tasks', session => {
-    // Send task list update
-    console.log(`[${new Date().toISOString()}] Task refresh for ${session.id}`);
-  });
-
-  server.on('refresh:status', session => {
-    // Send status update
-    console.log(`[${new Date().toISOString()}] Status refresh for ${session.id}`);
-  });
-}
-
-/**
- * Handle message by calling Claude CLI
- */
-async function handleClaudeMessage(session, content, projectRoot) {
-  let fullResponse = '';
-
-  const bridge = createClaudeBridge({
-    cwd: projectRoot,
-    onInit: info => {
-      console.log(
-        `[${new Date().toISOString()}] Claude session: ${info.sessionId}, model: ${info.model}`
-      );
-    },
-    onText: (text, done) => {
-      if (text) {
-        fullResponse += text;
-        session.send(createTextDelta(text, done));
-      }
-      if (done) {
-        session.addMessage('assistant', fullResponse);
-        session.setState('idle');
-        console.log(`[${new Date().toISOString()}] Response complete`);
-      }
-    },
-    onToolStart: (id, name, input) => {
-      // Special handling for AskUserQuestion - send to dashboard for UI
-      if (name === 'AskUserQuestion' && input?.questions) {
-        session.send(createAskUserQuestion(id, input.questions));
-      }
-      session.send(createToolStart(id, name, input));
-    },
-    onToolResult: (id, output, isError, toolName) => {
-      session.send(createToolResult(id, { content: output, error: isError }, toolName));
-    },
-    onError: error => {
-      console.error(`[${new Date().toISOString()}] Claude error:`, error);
-      session.send(createNotification('error', 'Claude Error', error));
-    },
-    onComplete: response => {
-      // Already handled in onText with done=true
-    },
-  });
-
-  try {
-    await bridge.sendMessage(content);
-  } catch (error) {
-    session.send(createNotification('error', 'Error', error.message));
-    session.setState('error');
-    throw error;
-  }
-}
-
-// Run main
-main().catch(console.error);

package/src/core/commands/serve.md

@@ -1,127 +0,0 @@
----
-description: Start Dashboard WebSocket server for real-time UI communication
-argument-hint: "[OPTIONS: --port 8765 --api-key KEY --tunnel]"
-compact_context:
-  priority: medium
-  preserve_rules:
-    - "ACTIVE COMMAND: /agileflow:serve - Dashboard WebSocket server"
-    - "Server provides real-time communication for Cloud Dashboard"
-    - "Default port: 8765, binds to 0.0.0.0"
-  state_fields:
-    - server_running
-    - server_port
-    - tunnel_url
----
-
-# serve
-
-Start the AgileFlow Dashboard WebSocket server for real-time communication with the Cloud Dashboard UI.
-
----
-
-## Overview
-
-The serve command starts a WebSocket server that the AgileFlow Dashboard connects to for real-time features: chat streaming, git operations, terminal access, and automation management.
-
-**Key Features**:
-- **WebSocket protocol**: Real-time bidirectional communication with dashboard
-- **Claude CLI bridge**: Streaming text deltas and tool call forwarding
-- **Git integration**: Status, diff, commit, branch operations via WebSocket
-- **Terminal channels**: Remote terminal sessions scoped to project directory
-- **Automation runner**: Trigger and monitor automations from the dashboard
-- **Auth support**: Optional API key authentication for secure connections
-- **Tunnel support**: ngrok integration for remote access
-
----
-
-## Usage
-
-### Start with Default Settings
-
-```
-/agileflow:serve
-```
-
-Starts the WebSocket server on port 8765, binding to 0.0.0.0.
-
-### Start with Custom Port and Auth
-
-```
-/agileflow:serve --port 9000 --api-key agf_secret123
-```
-
-### Start with Tunnel for Remote Access
-
-```
-/agileflow:serve --tunnel
-```
-
-Starts ngrok tunnel for remote dashboard connections (requires ngrok installed).
-
----
-
-## Options
-
-| Option | Short | Default | Description |
-|--------|-------|---------|-------------|
-| `--port` | `-p` | `8765` | Port to listen on |
-| `--host` | `-h` | `0.0.0.0` | Host to bind to |
-| `--api-key` | `-k` | none | API key for authentication |
-| `--require-auth` | | `false` | Require API key for connections |
-| `--tunnel` | `-t` | `false` | Start ngrok tunnel |
-
----
-
-## Prompt
-
-ROLE: Dashboard Server Manager
-
-Run the dashboard WebSocket server using the installed script:
-
-```bash
-node .agileflow/scripts/dashboard-serve.js [OPTIONS]
-```
-
-**Pass through any user-provided options** (--port, --api-key, --tunnel, etc.) directly to the script.
-
-WORKFLOW:
-
-1. **Start the server**:
-   ```bash
-   node .agileflow/scripts/dashboard-serve.js --port 8765
-   ```
-
-2. **Report the connection URL** to the user:
-   - Local: `ws://localhost:<port>`
-   - If tunnel enabled: the ngrok URL
-
-3. **Keep the server running** - it runs in the foreground. The user can stop it with Ctrl+C.
-
-4. If the user specifies `--api-key`, pass it through:
-   ```bash
-   node .agileflow/scripts/dashboard-serve.js --port 8765 --api-key agf_secret123
-   ```
-
-5. If the user specifies `--tunnel`, pass it through:
-   ```bash
-   node .agileflow/scripts/dashboard-serve.js --tunnel
-   ```
-
----
-
-## Dashboard Connection
-
-Once the server is running, the Cloud Dashboard connects via WebSocket:
-
-1. Open the AgileFlow Dashboard
-2. Enter the connection URL: `ws://localhost:8765` (or tunnel URL)
-3. If auth is enabled, provide the API key
-4. Dashboard receives real-time updates for chat, git, terminal, and automations
-
----
-
-## Related Commands
-
-- `/agileflow:api` - REST API server (read-only state exposure)
-- `/agileflow:session:status` - View current session state
-- `/agileflow:board` - Visual kanban board