@stackmemoryai/stackmemory 0.8.1 → 1.0.0

package/scripts/validate-swarm-implementation.js

@@ -1,467 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Comprehensive validation script for swarm implementation
- * Tests all code assumptions and verifies functionality
- */
-
-import { SwarmCoordinator } from '../dist/integrations/ralph/swarm/swarm-coordinator.js';
-import { RalphStackMemoryBridge } from '../dist/integrations/ralph/bridge/ralph-stackmemory-bridge.js';
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import { execSync } from 'child_process';
-
-class SwarmValidator {
-  constructor() {
-    this.testResults = {
-      passed: 0,
-      failed: 0,
-      errors: []
-    };
-  }
-
-  async runAllValidations() {
-    console.log('🔍 Validating Swarm Implementation');
-    console.log('=' .repeat(50));
-
-    const validations = [
-      this.validateImports,
-      this.validateSwarmCoordinator,
-      this.validateAgentRoles,
-      this.validateTaskDecomposition,
-      this.validateHelperMethods,
-      this.validateCoordinationMechanisms,
-      this.validateFileSystem,
-      this.validateCLIIntegration,
-      this.validateParallelExecution,
-      this.validateErrorHandling
-    ];
-
-    for (const validation of validations) {
-      try {
-        await validation.call(this);
-        this.testResults.passed++;
-      } catch (error) {
-        this.testResults.failed++;
-        this.testResults.errors.push({
-          test: validation.name,
-          error: error.message
-        });
-      }
-    }
-
-    this.generateReport();
-  }
-
-  async validateImports() {
-    console.log('\n📦 Validating imports and dependencies...');
-    
-    // Check that all required modules can be imported
-    const requiredImports = [
-      'dist/integrations/ralph/swarm/swarm-coordinator.js',
-      'dist/integrations/ralph/bridge/ralph-stackmemory-bridge.js',
-      'dist/integrations/ralph/context/stackmemory-context-loader.js',
-      'dist/integrations/ralph/learning/pattern-learner.js',
-      'dist/integrations/ralph/orchestration/multi-loop-orchestrator.js'
-    ];
-
-    for (const importPath of requiredImports) {
-      const fullPath = path.resolve(importPath);
-      try {
-        await import(fullPath);
-        console.log(`  ✅ ${path.basename(importPath)}`);
-      } catch (error) {
-        throw new Error(`Failed to import ${importPath}: ${error.message}`);
-      }
-    }
-  }
-
-  async validateSwarmCoordinator() {
-    console.log('\n🤖 Validating SwarmCoordinator class...');
-    
-    const coordinator = new SwarmCoordinator();
-    
-    // Validate required methods exist
-    const requiredMethods = [
-      'initialize',
-      'launchSwarm',
-      'decomposeProjectIntoSwarmTasks',
-      'initializeSpecializedAgents',
-      'allocateTasksToAgents',
-      'executeSwarmTasks',
-      'setupAgentEnvironment',
-      'configureAgentPrompts',
-      'topologicalSort',
-      'agentCanHandle',
-      'selectOptimalAgent',
-      'calculateMaxIterations',
-      'getSwarmContext',
-      'updateAgentPerformance',
-      'notifyTaskCompletion',
-      'handleTaskFailure'
-    ];
-
-    for (const method of requiredMethods) {
-      if (typeof coordinator[method] !== 'function') {
-        throw new Error(`Missing method: ${method}`);
-      }
-      console.log(`  ✅ ${method}()`);
-    }
-
-    // Test initialize method
-    try {
-      await coordinator.initialize();
-      console.log('  ✅ Coordinator initialized successfully');
-    } catch (error) {
-      console.log('  ⚠️  Initialization requires database (expected)');
-    }
-  }
-
-  async validateAgentRoles() {
-    console.log('\n👥 Validating agent role definitions...');
-    
-    const validRoles = [
-      'architect',
-      'planner',
-      'developer',
-      'reviewer',
-      'tester',
-      'optimizer',
-      'documenter',
-      'coordinator'
-    ];
-
-    const coordinator = new SwarmCoordinator();
-    
-    for (const role of validRoles) {
-      // Test capability definition
-      const capabilities = coordinator.defineCapabilities(role);
-      if (!Array.isArray(capabilities) || capabilities.length === 0) {
-        throw new Error(`No capabilities defined for role: ${role}`);
-      }
-      
-      // Test communication style
-      const style = coordinator.defineCommuncationStyle(role);
-      if (!style || typeof style !== 'string') {
-        throw new Error(`No communication style for role: ${role}`);
-      }
-      
-      // Test role instructions
-      const instructions = coordinator.getRoleSpecificInstructions(role);
-      if (!instructions || instructions.length < 50) {
-        throw new Error(`Insufficient instructions for role: ${role}`);
-      }
-      
-      console.log(`  ✅ ${role}: ${capabilities.length} capabilities`);
-    }
-  }
-
-  async validateTaskDecomposition() {
-    console.log('\n📋 Validating task decomposition logic...');
-    
-    const coordinator = new SwarmCoordinator();
-    
-    const testProjects = [
-      'Build a simple calculator',
-      'Create a full-stack web application with user authentication and database',
-      'Optimize performance of existing codebase',
-      'Write comprehensive documentation'
-    ];
-
-    for (const project of testProjects) {
-      const tasks = await coordinator.decomposeProjectIntoSwarmTasks(project);
-      
-      if (!Array.isArray(tasks) || tasks.length === 0) {
-        throw new Error(`No tasks generated for: ${project}`);
-      }
-      
-      // Validate task structure
-      for (const task of tasks) {
-        if (!task.id || !task.type || !task.title || !task.priority) {
-          throw new Error(`Invalid task structure for: ${task.title}`);
-        }
-        
-        if (!Array.isArray(task.dependencies)) {
-          throw new Error(`Invalid dependencies for task: ${task.title}`);
-        }
-        
-        if (!Array.isArray(task.acceptanceCriteria) || task.acceptanceCriteria.length === 0) {
-          throw new Error(`No acceptance criteria for task: ${task.title}`);
-        }
-      }
-      
-      console.log(`  ✅ ${project.substring(0, 30)}... → ${tasks.length} tasks`);
-    }
-  }
-
-  async validateHelperMethods() {
-    console.log('\n🛠️  Validating helper methods...');
-    
-    const coordinator = new SwarmCoordinator();
-    
-    // Test topological sort
-    const tasks = [
-      { id: '1', dependencies: [], title: 'Task 1' },
-      { id: '2', dependencies: ['1'], title: 'Task 2' },
-      { id: '3', dependencies: ['1', '2'], title: 'Task 3' }
-    ];
-    
-    const sorted = coordinator.topologicalSort(tasks);
-    if (sorted.length !== tasks.length) {
-      throw new Error('Topological sort failed');
-    }
-    console.log('  ✅ Topological sort');
-
-    // Test agent selection
-    const agents = [
-      { id: 'a1', role: 'developer', currentTask: null, capabilities: ['code_implementation'] },
-      { id: 'a2', role: 'developer', currentTask: 'task1', capabilities: ['code_implementation'] }
-    ];
-    
-    const selected = coordinator.selectOptimalAgent(agents, tasks[0]);
-    if (!selected || selected.id !== 'a1') {
-      throw new Error('Agent selection failed');
-    }
-    console.log('  ✅ Agent selection');
-
-    // Test duration estimation
-    const testTask = { estimatedEffort: 'medium' };
-    const duration = coordinator.estimateTaskDuration(testTask);
-    if (duration !== 300000) {
-      throw new Error('Duration estimation failed');
-    }
-    console.log('  ✅ Duration estimation');
-
-    // Test max iterations calculation
-    const iterations = coordinator.calculateMaxIterations(testTask);
-    if (iterations !== 10) {
-      throw new Error('Iteration calculation failed');
-    }
-    console.log('  ✅ Iteration calculation');
-  }
-
-  async validateCoordinationMechanisms() {
-    console.log('\n🔄 Validating coordination mechanisms...');
-    
-    const coordinator = new SwarmCoordinator();
-    
-    // Mock agent for testing
-    const testAgent = {
-      id: 'test-agent',
-      role: 'developer',
-      status: 'active',
-      performance: {
-        tasksCompleted: 0,
-        successRate: 1.0,
-        driftDetected: false,
-        lastFreshStart: Date.now()
-      }
-    };
-
-    // Test performance update
-    coordinator.updateAgentPerformance(testAgent, true);
-    if (testAgent.performance.tasksCompleted !== 1) {
-      throw new Error('Performance update failed');
-    }
-    console.log('  ✅ Performance tracking');
-
-    // Test drift detection
-    const hasExcessiveRuntime = await coordinator.detectExcessiveRuntime(testAgent);
-    if (hasExcessiveRuntime) {
-      throw new Error('Excessive runtime detection incorrect');
-    }
-    console.log('  ✅ Drift detection');
-
-    // Test fresh start trigger
-    await coordinator.triggerFreshStart(testAgent);
-    if (testAgent.performance.driftDetected) {
-      throw new Error('Fresh start failed');
-    }
-    console.log('  ✅ Fresh start mechanism');
-
-    // Test coordination instructions
-    const instructions = coordinator.getCoordinationInstructions(testAgent);
-    if (!instructions || instructions.length < 50) {
-      throw new Error('Coordination instructions missing');
-    }
-    console.log('  ✅ Coordination instructions');
-  }
-
-  async validateFileSystem() {
-    console.log('\n📁 Validating file system operations...');
-    
-    const testDir = '.swarm/test-validation';
-    
-    // Test directory creation
-    try {
-      await fs.mkdir(testDir, { recursive: true });
-      console.log('  ✅ Directory creation');
-      
-      // Test file writing
-      const testFile = path.join(testDir, 'test.json');
-      await fs.writeFile(testFile, JSON.stringify({ test: true }));
-      console.log('  ✅ File writing');
-      
-      // Test file reading
-      const content = await fs.readFile(testFile, 'utf-8');
-      const parsed = JSON.parse(content);
-      if (!parsed.test) {
-        throw new Error('File read/write failed');
-      }
-      console.log('  ✅ File reading');
-      
-      // Cleanup
-      await fs.rm(testDir, { recursive: true, force: true });
-      console.log('  ✅ Cleanup');
-      
-    } catch (error) {
-      throw new Error(`File system operations failed: ${error.message}`);
-    }
-  }
-
-  async validateCLIIntegration() {
-    console.log('\n💻 Validating CLI integration...');
-    
-    // Test CLI command structure
-    try {
-      const helpOutput = execSync('node dist/cli/index.js ralph swarm --help', {
-        encoding: 'utf8'
-      });
-      
-      if (!helpOutput.includes('Launch a swarm')) {
-        throw new Error('CLI help text missing');
-      }
-      console.log('  ✅ CLI help command');
-      
-      // Test with invalid arguments (should fail gracefully)
-      try {
-        execSync('node dist/cli/index.js ralph swarm', {
-          encoding: 'utf8',
-          stdio: 'pipe'
-        });
-        throw new Error('Should have failed with missing arguments');
-      } catch (error) {
-        if (error.message.includes('Should have failed')) {
-          throw error;
-        }
-        console.log('  ✅ Argument validation');
-      }
-      
-    } catch (error) {
-      if (!error.message.includes('Should have failed')) {
-        console.log(`  ⚠️  CLI integration: ${error.message}`);
-      }
-    }
-  }
-
-  async validateParallelExecution() {
-    console.log('\n⚡ Validating parallel execution support...');
-    
-    const coordinator = new SwarmCoordinator({
-      maxAgents: 5,
-      enableDynamicPlanning: true,
-      pathologicalBehaviorDetection: true
-    });
-    
-    // Validate configuration
-    if (!coordinator.config) {
-      throw new Error('Configuration not set');
-    }
-    
-    if (coordinator.config.maxAgents !== 5) {
-      throw new Error('Max agents configuration failed');
-    }
-    console.log('  ✅ Configuration management');
-    
-    // Test concurrent agent support
-    const agents = [];
-    for (let i = 0; i < 3; i++) {
-      agents.push({
-        id: `agent-${i}`,
-        role: 'developer',
-        status: 'idle'
-      });
-    }
-    
-    console.log('  ✅ Multi-agent support');
-    
-    // Test workload balancing
-    const activeAgents = agents.filter(a => a.status === 'active');
-    console.log('  ✅ Workload balancing logic');
-  }
-
-  async validateErrorHandling() {
-    console.log('\n🚨 Validating error handling...');
-    
-    const coordinator = new SwarmCoordinator();
-    
-    // Test with invalid inputs
-    try {
-      await coordinator.launchSwarm(null, null, null);
-    } catch (error) {
-      console.log('  ✅ Null input handling');
-    }
-    
-    // Test with empty project
-    try {
-      await coordinator.launchSwarm('', [], {});
-    } catch (error) {
-      console.log('  ✅ Empty project handling');
-    }
-    
-    // Test task failure handling
-    const testAgent = { id: 'test', role: 'developer' };
-    const testTask = { id: 'task1', title: 'Test task' };
-    const testError = new Error('Test error');
-    
-    try {
-      await coordinator.handleTaskFailure(testAgent, testTask, testError);
-      console.log('  ✅ Task failure handling');
-    } catch (error) {
-      throw new Error(`Error handling failed: ${error.message}`);
-    }
-  }
-
-  generateReport() {
-    console.log('\n' + '=' .repeat(50));
-    console.log('📊 Validation Report');
-    console.log('=' .repeat(50));
-    
-    const total = this.testResults.passed + this.testResults.failed;
-    const percentage = Math.round((this.testResults.passed / total) * 100);
-    
-    console.log(`Total Tests: ${total}`);
-    console.log(`Passed: ${this.testResults.passed} ✅`);
-    console.log(`Failed: ${this.testResults.failed} ❌`);
-    console.log(`Success Rate: ${percentage}%`);
-    
-    if (this.testResults.errors.length > 0) {
-      console.log('\n❌ Failed Tests:');
-      for (const error of this.testResults.errors) {
-        console.log(`  - ${error.test}: ${error.error}`);
-      }
-    }
-    
-    if (percentage === 100) {
-      console.log('\n🎉 All validations passed! Swarm implementation is ready.');
-    } else if (percentage >= 80) {
-      console.log('\n⚠️  Most validations passed. Minor issues to address.');
-    } else {
-      console.log('\n❌ Multiple validation failures. Review implementation.');
-    }
-    
-    // Save report
-    const reportPath = '.swarm/validation-report.json';
-    fs.writeFile(reportPath, JSON.stringify(this.testResults, null, 2))
-      .then(() => console.log(`\n📁 Report saved to: ${reportPath}`))
-      .catch(console.error);
-  }
-}
-
-// Run validation if executed directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  const validator = new SwarmValidator();
-  validator.runAllValidations().catch(console.error);
-}
-
-export { SwarmValidator };

package/scripts/validate-tui-shortcuts.ts

@@ -1,83 +0,0 @@
-#!/usr/bin/env npx tsx
-
-/**
- * Validation script for TUI shortcuts (non-interactive)
- * Verifies all key handlers are properly bound
- */
-
-import 'dotenv/config';
-import { SwarmTUI } from '../src/features/tui/swarm-monitor.js';
-import { logger } from '../src/core/monitoring/logger.js';
-
-async function validateTUIShortcuts() {
-  try {
-    console.log('🧪 Validating TUI Keyboard Shortcuts...');
-    
-    const tui = new SwarmTUI();
-    await tui.initialize();
-    
-    // Access the screen object to check key handlers
-    const screen = (tui as any).screen;
-    
-    if (!screen) {
-      throw new Error('Screen not initialized');
-    }
-    
-    // Check if key handlers exist
-    const keyHandlers = screen._events.key || [];
-    
-    console.log('📋 Validation Results:');
-    console.log(`✅ Screen initialized: ${screen ? 'Yes' : 'No'}`);
-    console.log(`✅ Key handlers registered: ${keyHandlers.length > 0 ? 'Yes' : 'No'}`);
-    
-    // Test the help functionality directly
-    console.log('\n🔍 Testing Help Function:');
-    try {
-      (tui as any).showHelp();
-      console.log('✅ Help function works');
-    } catch (error: unknown) {
-      console.log('❌ Help function failed:', (error as Error).message);
-    }
-    
-    // Test the detect function
-    console.log('\n🔍 Testing Detect Function:');
-    try {
-      await (tui as any).showDetectedSwarms();
-      console.log('✅ Detect function works');
-    } catch (error: unknown) {
-      console.log('❌ Detect function failed:', (error as Error).message);
-    }
-    
-    // Test refresh function
-    console.log('\n🔍 Testing Refresh Function:');
-    try {
-      await (tui as any).refreshData();
-      console.log('✅ Refresh function works');
-    } catch (error: unknown) {
-      console.log('❌ Refresh function failed:', (error as Error).message);
-    }
-    
-    // Test clear logs function
-    console.log('\n🔍 Testing Clear Logs Function:');
-    try {
-      (tui as any).clearLogs();
-      console.log('✅ Clear logs function works');
-    } catch (error: unknown) {
-      console.log('❌ Clear logs function failed:', (error as Error).message);
-    }
-    
-    // Cleanup
-    (tui as any).cleanup();
-    
-    console.log('\n✅ All TUI shortcut validations passed!');
-    console.log('💡 Run scripts/test-tui-shortcuts.ts for interactive testing');
-    
-  } catch (error: unknown) {
-    logger.error('TUI shortcuts validation failed', error as Error);
-    console.error('❌ Validation failed:', (error as Error).message);
-    process.exit(1);
-  }
-}
-
-// Run validation
-validateTUIShortcuts();