feat: Add comprehensive TUI monitoring for Ralph swarms

Major features:
- Real-time swarm monitoring TUI with blessed interface
- Git commit tracking with lines added/deleted per agent
- SwarmRegistry for managing active swarms globally
- Agent status, iteration counts, and performance metrics
- Integration with existing SwarmDashboard and coordination systems
- CLI command: stackmemory ralph tui [--swarm-id]

TUI Features:
- Live agent status table showing role, iteration, current task
- Recent commits table with agent attribution and line changes
- Performance metrics box with throughput and efficiency
- Real-time log output for debugging swarm operations
- Auto-detection of active swarms via registry
- Keyboard controls: q=quit, r=refresh, s=start, t=stop

This provides comprehensive visibility into swarm operations for debugging and optimization.

Author: jonathanpeterwu

package-lock.json

@@ -87,6 +87,7 @@
     "@modelcontextprotocol/sdk": "^0.5.0",
     "@stackmemoryai/stackmemory": "^0.3.19",
     "@types/bcryptjs": "^2.4.6",
+    "@types/blessed": "^0.1.27",
     "@types/inquirer": "^9.0.9",
     "@types/pg": "^8.16.0",
     "bcryptjs": "^3.0.3",

package.json

@@ -0,0 +1,34 @@
+#!/usr/bin/env npx tsx
+
+/**
+ * Test script for Swarm TUI monitoring
+ * Launches the TUI with mock data for testing
+ */
+
+import 'dotenv/config';
+import { SwarmTUI } from '../src/features/tui/swarm-monitor.js';
+import { logger } from '../src/core/monitoring/logger.js';
+
+async function testSwarmTUI() {
+  try {
+    console.log('🦾 Starting Swarm TUI Test...');
+    
+    const tui = new SwarmTUI();
+    
+    // Initialize without swarm coordinator for testing
+    await tui.initialize();
+    
+    // Start the TUI
+    tui.start();
+    
+    console.log('TUI should now be running. Press q to quit.');
+    
+  } catch (error: unknown) {
+    logger.error('TUI test failed', error as Error);
+    console.error('❌ TUI test failed:', (error as Error).message);
+    process.exit(1);
+  }
+}
+
+// Run the test
+testSwarmTUI();

scripts/test-swarm-tui.ts

@@ -447,6 +447,28 @@ export function createRalphCommand(): Command {
       });
     });
 
+  // TUI command for real-time monitoring
+  ralph
+    .command('tui')
+    .description('Launch TUI monitor for active swarms')
+    .option('--swarm-id <id>', 'Monitor specific swarm ID')
+    .action(async (options) => {
+      try {
+        const { SwarmTUI } = await import('../../features/tui/swarm-monitor.js');
+        
+        const tui = new SwarmTUI();
+        
+        // Initialize with optional swarm ID
+        await tui.initialize(undefined, options.swarmId);
+        tui.start();
+        
+      } catch (error: unknown) {
+        logger.error('TUI launch failed', error as Error);
+        console.error('❌ TUI failed:', (error as Error).message);
+        process.exit(1);
+      }
+    });
+
   return ralph;
 }