vibecodingmachine-cli 2026.2.26-1752 → 2026.3.9-1621

package/src/trui/agents/handlers/CommandHandler.js

@@ -0,0 +1,93 @@
+/**
+ * Command Handler for TRUI Agent Interface
+ * 
+ * Handles command parsing and execution.
+ * Follows constitutional requirements: <555 lines, test-first approach.
+ */
+
+/**
+ * Command Handler class
+ */
+class CommandHandler {
+  /**
+   * Create command handler instance
+   * @param {Object} options - Handler options
+   */
+  constructor(options = {}) {
+    this.agentCommands = options.agentCommands;
+    this.contextManager = options.contextManager;
+  }
+
+  /**
+   * Execute command using RUI pattern
+   * @param {string} commandString - Command string
+   * @returns {Promise<Object>} - Command result
+   */
+  async executeCommand(commandString) {
+    // Parse command
+    const parsed = this.parseCommand(commandString);
+    
+    if (!parsed.success) {
+      throw new Error(parsed.error);
+    }
+
+    // Update context
+    if (this.contextManager) {
+      this.contextManager.updateContext(parsed);
+    }
+
+    // Execute command
+    const result = await this.agentCommands.executeCommand(
+      parsed.verb,
+      parsed.resource,
+      parsed.params
+    );
+
+    return { result, parsed };
+  }
+
+  /**
+   * Parse command string
+   * @param {string} commandString - Command string
+   * @returns {Object} - Parsed command
+   */
+  parseCommand(commandString) {
+    const tokens = commandString.trim().split(/\s+/);
+    
+    if (tokens.length === 0) {
+      return { success: false, error: 'Empty command' };
+    }
+
+    // Simple command parsing for TRUI
+    const verb = tokens[0].toUpperCase();
+    const resource = tokens[1] || '';
+    const params = {};
+
+    // Parse parameters
+    for (let i = 2; i < tokens.length; i++) {
+      const token = tokens[i];
+      
+      if (token.startsWith('--')) {
+        const param = token.substring(2);
+        if (param.includes('=')) {
+          const [key, value] = param.split('=', 2);
+          params[key] = value;
+        } else {
+          params[param] = true;
+        }
+      } else if (token.startsWith('-')) {
+        const flag = token.substring(1);
+        params[flag] = true;
+      }
+    }
+
+    return {
+      success: true,
+      verb,
+      resource,
+      params
+    };
+  }
+}
+
+module.exports = CommandHandler;

package/src/trui/agents/handlers/ContextManager.js

@@ -0,0 +1,117 @@
+/**
+ * Context Manager for TRUI Agent Interface
+ * 
+ * Manages interface context and navigation state.
+ * Follows constitutional requirements: <555 lines, test-first approach.
+ */
+
+/**
+ * Context Manager class
+ */
+class ContextManager {
+  /**
+   * Create context manager instance
+   * @param {Object} options - Manager options
+   */
+  constructor(options = {}) {
+    this.context = 'agents';
+    this.currentAgent = null;
+    this.navigationHistory = [];
+    this.maxHistorySize = options.maxHistorySize || 50;
+  }
+
+  /**
+   * Update interface context
+   * @param {Object} parsedCommand - Parsed command
+   */
+  updateContext(parsedCommand) {
+    this.navigationHistory.push({
+      command: `${parsedCommand.verb} ${parsedCommand.resource}`,
+      timestamp: new Date().toISOString()
+    });
+
+    // Keep history size limited
+    if (this.navigationHistory.length > this.maxHistorySize) {
+      this.navigationHistory.shift();
+    }
+
+    // Update current context
+    if (parsedCommand.resource === 'agents' || parsedCommand.resource === 'agent') {
+      this.context = 'agents';
+    } else if (parsedCommand.resource && parsedCommand.resource !== 'agents') {
+      this.context = 'agent-details';
+      this.currentAgent = parsedCommand.resource;
+    } else {
+      this.context = 'unknown';
+    }
+  }
+
+  /**
+   * Get prompt based on current context
+   * @returns {string} - Prompt string
+   */
+  getPrompt() {
+    switch (this.context) {
+      case 'agents':
+        return 'agents> ';
+      case 'agent-details':
+        return `agents/${this.currentAgent}> `;
+      default:
+        return 'vibe> ';
+    }
+  }
+
+  /**
+   * Add command to history
+   * @param {string} command - Command to add
+   */
+  addToHistory(command) {
+    // Avoid duplicates
+    const lastCommand = this.navigationHistory[this.navigationHistory.length - 1];
+    if (lastCommand && lastCommand.command === command) {
+      return;
+    }
+
+    this.navigationHistory.push({
+      command,
+      timestamp: new Date().toISOString()
+    });
+  }
+
+  /**
+   * Show command history
+   */
+  showHistory() {
+    console.log('\n=== COMMAND HISTORY ===');
+    this.navigationHistory.forEach((entry, index) => {
+      const timestamp = new Date(entry.timestamp).toLocaleString();
+      console.log(`${(index + 1).toString().padStart(2)}. ${entry.command} (${timestamp})`);
+    });
+  }
+
+  /**
+   * Get current context
+   * @returns {string} - Current context
+   */
+  getContext() {
+    return this.context;
+  }
+
+  /**
+   * Get current agent
+   * @returns {string|null} - Current agent ID
+   */
+  getCurrentAgent() {
+    return this.currentAgent;
+  }
+
+  /**
+   * Get history size
+   * @returns {number} - History size
+   */
+  getHistorySize() {
+    return this.navigationHistory.length;
+  }
+}
+
+module.exports = ContextManager;

package/src/trui/agents/handlers/DisplayHandler.js

@@ -0,0 +1,243 @@
+/**
+ * Display Handler for TRUI Agent Interface
+ * 
+ * Handles all display operations for agent data, results, and summaries.
+ * Follows constitutional requirements: <555 lines, test-first approach.
+ */
+
+/**
+ * Display Handler class
+ */
+class DisplayHandler {
+  /**
+   * Create display handler instance
+   * @param {Object} options - Handler options
+   */
+  constructor(options = {}) {
+    this.verbose = options.verbose || false;
+  }
+
+  /**
+   * Display command result
+   * @param {Object} result - Command result
+   * @param {Object} parsedCommand - Parsed command
+   * @param {Object} responseFormatter - Response formatter
+   * @returns {Promise<void>}
+   */
+  async displayResult(result, parsedCommand, responseFormatter) {
+    const formattedResponse = responseFormatter.format(result, 'trui', {
+      verbose: parsedCommand.params.verbose
+    });
+
+    if (formattedResponse.success) {
+      await this.displaySuccessResult(formattedResponse, parsedCommand);
+    } else {
+      await this.displayErrorResult(formattedResponse, parsedCommand);
+    }
+  }
+
+  /**
+   * Display successful result
+   * @param {Object} response - Formatted response
+   * @param {Object} parsedCommand - Parsed command
+   * @returns {Promise<void>}
+   */
+  async displaySuccessResult(response, parsedCommand) {
+    if (response.data && response.data.agents) {
+      await this.displayAgentList(response.data);
+    } else if (response.data && response.data.id) {
+      await this.displayAgentDetails(response.data);
+    } else if (response.data && response.data.summary) {
+      await this.displayOperationSummary(response.data);
+    } else {
+      console.log('Command completed successfully');
+    }
+
+    // Show navigation hints
+    if (response.navigation) {
+      this.showNavigationHints(response.navigation);
+    }
+  }
+
+  /**
+   * Display error result
+   * @param {Object} response - Formatted response
+   * @param {Object} parsedCommand - Parsed command
+   * @returns {Promise<void>}
+   */
+  async displayErrorResult(response, parsedCommand) {
+    console.error(`Error: ${response.error}`);
+    
+    if (response.navigation && response.navigation.suggestions) {
+      console.log('\nSuggestions:');
+      response.navigation.suggestions.forEach(suggestion => {
+        console.log(`  ${suggestion}`);
+      });
+    }
+  }
+
+  /**
+   * Display agent list
+   * @param {Object} data - Agent data
+   * @returns {Promise<void>}
+   */
+  async displayAgentList(data) {
+    console.log('\n=== AGENTS ===');
+    
+    if (!data.agents || data.agents.length === 0) {
+      console.log('No agents found.');
+      return;
+    }
+
+    // Display agents with navigation hints
+    data.agents.forEach((agent, agentIndex) => {
+      const status = agent.status || 'UNKNOWN';
+      const statusIcon = this.getStatusIcon(status);
+      const displayIndex = (agentIndex + 1).toString().padStart(2);
+      
+      console.log(`${displayIndex}. ${statusIcon} ${agent.id.padEnd(15)} - ${agent.name}`);
+      
+      if (agent.statusDescription) {
+        console.log(`     Status: ${agent.statusDescription}`);
+      }
+    });
+
+    console.log(`\nTotal: ${data.agents.length} agents`);
+    this.showAgentListActions();
+  }
+
+  /**
+   * Display agent details
+   * @param {Object} data - Agent data
+   * @returns {Promise<void>}
+   */
+  async displayAgentDetails(data) {
+    console.log(`\n=== AGENT: ${data.id.toUpperCase()} ===`);
+    console.log(`Name: ${data.name}`);
+    console.log(`Description: ${data.description || 'No description'}`);
+    console.log(`Enabled: ${data.enabled ? 'Yes' : 'No'}`);
+    console.log(`Status: ${data.status || 'UNKNOWN'}`);
+    
+    if (data.statusDescription) {
+      console.log(`Status Description: ${data.statusDescription}`);
+    }
+    
+    if (data.lastChecked) {
+      console.log(`Last Checked: ${new Date(data.lastChecked).toLocaleString()}`);
+    }
+    
+    if (data.lastVerified) {
+      console.log(`Last Verified: ${new Date(data.lastVerified).toLocaleString()}`);
+    }
+
+    // Show sections if available
+    if (data.sections) {
+      data.sections.forEach(section => {
+        console.log(`\n--- ${section.title.toUpperCase()} ---`);
+        section.fields.forEach(field => {
+          const value = data[field];
+          if (value !== undefined && value !== null) {
+            console.log(`${field}: ${JSON.stringify(value, null, 2)}`);
+          }
+        });
+      });
+    }
+
+    this.showAgentDetailActions(data);
+  }
+
+  /**
+   * Display operation summary
+   * @param {Object} data - Summary data
+   * @returns {Promise<void>}
+   */
+  async displayOperationSummary(data) {
+    console.log('\n=== OPERATION SUMMARY ===');
+    console.log(`Success: ${data.allSuccessful ? 'Yes' : 'No'}`);
+    console.log(`Total: ${data.total || 0}`);
+    console.log(`Successful: ${data.successful || 0}`);
+    console.log(`Failed: ${data.failed || 0}`);
+    console.log(`Skipped: ${data.skipped || 0}`);
+    
+    if (data.duration) {
+      console.log(`Duration: ${(data.duration / 1000).toFixed(2)}s`);
+    }
+
+    // Show breakdown if available
+    if (data.breakdown) {
+      console.log('\n--- BREAKDOWN ---');
+      Object.entries(data.breakdown).forEach(([key, value]) => {
+        console.log(`${key}: ${JSON.stringify(value, null, 2)}`);
+      });
+    }
+  }
+
+  /**
+   * Show agent list actions
+   */
+  showAgentListActions() {
+    console.log('\nAvailable actions:');
+    console.log('  <index> - View agent details (e.g., "1")');
+    console.log('  get <agent-id> - Get specific agent');
+    console.log('  check <agent-id> - Check specific agent');
+    console.log('  check agents - Check all agents');
+    console.log('  help - Show this help');
+    console.log('  exit - Exit interface');
+  }
+
+  /**
+   * Show agent detail actions
+   * @param {Object} agent - Agent data
+   */
+  showAgentDetailActions(agent) {
+    console.log('\nAvailable actions:');
+    console.log(`  enable ${agent.id} - Enable agent`);
+    console.log(`  disable ${agent.id} - Disable agent`);
+    console.log(`  check ${agent.id} - Check agent`);
+    console.log(`  remove ${agent.id} - Remove agent`);
+    console.log(`  logs ${agent.id} - View agent logs`);
+    console.log('  back - Return to agent list');
+    console.log('  help - Show this help');
+    console.log('  exit - Exit interface');
+  }
+
+  /**
+   * Show navigation hints
+   * @param {Object} navigation - Navigation data
+   */
+  showNavigationHints(navigation) {
+    if (navigation.context) {
+      console.log(`\nContext: ${navigation.context}`);
+    }
+    
+    if (navigation.availableActions && navigation.availableActions.length > 0) {
+      console.log('Available commands:', navigation.availableActions.join(', '));
+    }
+    
+    if (navigation.shortcuts && navigation.shortcuts.length > 0) {
+      console.log('Shortcuts:', navigation.shortcuts.join(', '));
+    }
+  }
+
+  /**
+   * Get status icon
+   * @param {string} status - Agent status
+   * @returns {string} - Status icon
+   */
+  getStatusIcon(status) {
+    const icons = {
+      'VERIFIED': '✅',
+      'INSTALLED': '📦',
+      'INSTALLING': '⏳',
+      'VERIFYING': '🔍',
+      'NOT_INSTALLED': '❌',
+      'ERROR': '🚫',
+      'RATE_LIMITED': '⏱️',
+      'DISABLED': '🚫'
+    };
+
+    return icons[status] || '❓';
+  }
+}
+
+module.exports = DisplayHandler;

package/src/trui/agents/handlers/HelpHandler.js

@@ -0,0 +1,51 @@
+/**
+ * Help Handler for TRUI Agent Interface
+ * 
+ * Handles help display and command information.
+ * Follows constitutional requirements: <555 lines, test-first approach.
+ */
+
+/**
+ * Help Handler class
+ */
+class HelpHandler {
+  /**
+   * Create help handler instance
+   */
+  constructor() {
+    // Help handler is stateless
+  }
+
+  /**
+   * Show help information
+   */
+  showHelp() {
+    console.log('\n=== HELP ===');
+    console.log('Available commands:');
+    console.log('  list agents - List all agents');
+    console.log('  get <agent-id> - Get agent details');
+    console.log('  check agents - Check all agents');
+    console.log('  check <agent-id> - Check specific agent');
+    console.log('  enable <agent-id> - Enable agent');
+    console.log('  disable <agent-id> - Disable agent');
+    console.log('  remove <agent-id> - Remove agent');
+    console.log('  logs <agent-id> - View agent logs');
+    console.log('');
+    console.log('Options:');
+    console.log('  --includeDisabled - Include disabled agents in list');
+    console.log('  --format <format> - Output format (table, json, csv)');
+    console.log('  --verbose - Show detailed output');
+    console.log('  --force - Force reinstall');
+    console.log('  --skip-verification - Skip verification step');
+    console.log('');
+    console.log('Navigation:');
+    console.log('  <number> - Quick select agent from list');
+    console.log('  back - Return to agent list');
+    console.log('  history - Show command history');
+    console.log('  clear - Clear screen');
+    console.log('  help - Show this help');
+    console.log('  exit - Exit interface');
+  }
+}
+
+module.exports = HelpHandler;