create-byan-agent 2.7.7 → 2.7.8

package/src/byan-v2/generation/mantra-validator.js

@@ -1,416 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-
-class MantraValidator {
-  constructor(mantrasData = null) {
-    if (mantrasData) {
-      this.mantrasData = mantrasData;
-    } else {
-      const mantrasPath = path.join(__dirname, '../data/mantras.json');
-      this.mantrasData = JSON.parse(fs.readFileSync(mantrasPath, 'utf8'));
-    }
-    
-    this.mantras = this.mantrasData.mantras;
-    this.results = null;
-    this.agentContent = null;
-  }
-
-  validate(agentDefinition) {
-    if (agentDefinition === null || agentDefinition === undefined) {
-      throw new Error('Agent definition is required');
-    }
-
-    this.agentContent = typeof agentDefinition === 'string' 
-      ? agentDefinition 
-      : JSON.stringify(agentDefinition);
-
-    this.results = {
-      totalMantras: this.mantras.length,
-      compliant: [],
-      nonCompliant: [],
-      warnings: [],
-      errors: [],
-      timestamp: new Date().toISOString()
-    };
-
-    const startTime = Date.now();
-
-    for (const mantra of this.mantras) {
-      const result = this.checkMantra(mantra.id, agentDefinition);
-      
-      if (result.compliant) {
-        this.results.compliant.push({
-          id: mantra.id,
-          title: mantra.title,
-          priority: mantra.priority
-        });
-      } else {
-        this.results.nonCompliant.push({
-          id: mantra.id,
-          title: mantra.title,
-          priority: mantra.priority,
-          reason: result.reason
-        });
-
-        if (mantra.priority === 'critical') {
-          this.results.errors.push(`Critical mantra ${mantra.id} not met: ${mantra.title}`);
-        } else if (mantra.priority === 'high') {
-          this.results.warnings.push(`High priority mantra ${mantra.id} not met: ${mantra.title}`);
-        }
-      }
-    }
-
-    this.results.executionTimeMs = Date.now() - startTime;
-    this.results.score = this.calculateScore();
-
-    return this.results;
-  }
-
-  checkMantra(mantraId, agentDefinition = null) {
-    const mantra = this.mantras.find(m => m.id === mantraId);
-    
-    if (!mantra) {
-      return { compliant: false, reason: 'Mantra not found' };
-    }
-
-    const content = agentDefinition 
-      ? (typeof agentDefinition === 'string' ? agentDefinition : JSON.stringify(agentDefinition))
-      : this.agentContent;
-
-    if (!content) {
-      return { compliant: false, reason: 'No agent content to validate' };
-    }
-
-    const validation = mantra.validation;
-
-    if (validation.type === 'keyword') {
-      return this._validateKeywords(content, validation, mantra);
-    } else if (validation.type === 'pattern') {
-      return this._validatePattern(content, validation, mantra);
-    } else if (validation.type === 'coverage') {
-      return this._validateCoverage(content, validation, mantra);
-    }
-
-    return { compliant: false, reason: 'Unknown validation type' };
-  }
-
-  _validateKeywords(content, validation, mantra) {
-    const contentLower = content.toLowerCase();
-    const keywordsFound = validation.keywords.filter(keyword => 
-      contentLower.includes(keyword.toLowerCase())
-    );
-
-    const isCompliant = keywordsFound.length > 0;
-
-    if (!isCompliant && validation.required) {
-      return {
-        compliant: false,
-        reason: `Required keywords not found: ${validation.keywords.join(', ')}`
-      };
-    }
-
-    return {
-      compliant: isCompliant,
-      reason: isCompliant 
-        ? `Keywords found: ${keywordsFound.join(', ')}` 
-        : 'Optional keywords not found'
-    };
-  }
-
-  _validatePattern(content, validation, mantra) {
-    try {
-      const regex = new RegExp(validation.pattern, validation.flags || '');
-      const matches = content.match(regex);
-      const hasMatches = matches && matches.length > 0;
-
-      if (validation.mustNotMatch) {
-        const isCompliant = !hasMatches;
-        return {
-          compliant: isCompliant,
-          reason: isCompliant 
-            ? 'Pattern correctly not found' 
-            : `Forbidden pattern found: ${matches ? matches[0] : 'match'}`
-        };
-      } else {
-        return {
-          compliant: hasMatches,
-          reason: hasMatches 
-            ? `Pattern matched ${matches.length} times` 
-            : 'Required pattern not found'
-        };
-      }
-    } catch (error) {
-      return {
-        compliant: false,
-        reason: `Pattern validation error: ${error.message}`
-      };
-    }
-  }
-
-  _validateCoverage(content, validation, mantra) {
-    const coverageMatch = content.match(/coverage[:\s]+(\d+(?:\.\d+)?)%?/i);
-    
-    if (!coverageMatch) {
-      return {
-        compliant: false,
-        reason: 'No coverage information found'
-      };
-    }
-
-    const coverage = parseFloat(coverageMatch[1]);
-    const isCompliant = coverage >= validation.threshold;
-
-    return {
-      compliant: isCompliant,
-      reason: isCompliant 
-        ? `Coverage ${coverage}% meets threshold ${validation.threshold}%` 
-        : `Coverage ${coverage}% below threshold ${validation.threshold}%`
-    };
-  }
-
-  calculateScore() {
-    if (!this.results) {
-      return 0;
-    }
-
-    const compliantCount = this.results.compliant.length;
-    const totalCount = this.results.totalMantras;
-
-    return totalCount > 0 
-      ? Math.round((compliantCount / totalCount) * 100) 
-      : 0;
-  }
-
-  getMissingMantras() {
-    if (!this.results) {
-      return [];
-    }
-
-    return this.results.nonCompliant.map(nc => {
-      const mantra = this.mantras.find(m => m.id === nc.id);
-      return {
-        id: nc.id,
-        title: nc.title,
-        description: mantra ? mantra.description : '',
-        priority: nc.priority,
-        reason: nc.reason
-      };
-    });
-  }
-
-  getCompliantMantras() {
-    if (!this.results) {
-      return [];
-    }
-
-    return this.results.compliant.map(c => {
-      const mantra = this.mantras.find(m => m.id === c.id);
-      return {
-        id: c.id,
-        title: c.title,
-        description: mantra ? mantra.description : '',
-        priority: c.priority
-      };
-    });
-  }
-
-  generateReport() {
-    if (!this.results) {
-      return 'No validation results available. Run validate() first.';
-    }
-
-    const score = this.results.score;
-    const level = score >= 80 ? 'PASS' : score >= 60 ? 'WARNING' : 'FAIL';
-
-    let report = '';
-    report += '='.repeat(60) + '\n';
-    report += 'MANTRA VALIDATION REPORT\n';
-    report += '='.repeat(60) + '\n\n';
-    report += `Validation Date: ${this.results.timestamp}\n`;
-    report += `Execution Time: ${this.results.executionTimeMs}ms\n`;
-    report += `Status: ${level}\n`;
-    report += `Score: ${score}% (${this.results.compliant.length}/${this.results.totalMantras})\n\n`;
-
-    report += '-'.repeat(60) + '\n';
-    report += 'COMPLIANCE SUMMARY\n';
-    report += '-'.repeat(60) + '\n';
-    report += `Compliant Mantras: ${this.results.compliant.length}\n`;
-    report += `Non-Compliant Mantras: ${this.results.nonCompliant.length}\n`;
-    report += `Critical Errors: ${this.results.errors.length}\n`;
-    report += `Warnings: ${this.results.warnings.length}\n\n`;
-
-    if (this.results.errors.length > 0) {
-      report += '-'.repeat(60) + '\n';
-      report += 'CRITICAL ERRORS\n';
-      report += '-'.repeat(60) + '\n';
-      this.results.errors.forEach(error => {
-        report += `- ${error}\n`;
-      });
-      report += '\n';
-    }
-
-    if (this.results.warnings.length > 0) {
-      report += '-'.repeat(60) + '\n';
-      report += 'WARNINGS\n';
-      report += '-'.repeat(60) + '\n';
-      this.results.warnings.forEach(warning => {
-        report += `- ${warning}\n`;
-      });
-      report += '\n';
-    }
-
-    const missing = this.getMissingMantras();
-    if (missing.length > 0) {
-      report += '-'.repeat(60) + '\n';
-      report += 'MISSING MANTRAS\n';
-      report += '-'.repeat(60) + '\n';
-      
-      const criticalMissing = missing.filter(m => m.priority === 'critical');
-      const highMissing = missing.filter(m => m.priority === 'high');
-      const otherMissing = missing.filter(m => m.priority !== 'critical' && m.priority !== 'high');
-
-      if (criticalMissing.length > 0) {
-        report += '\nCRITICAL PRIORITY:\n';
-        criticalMissing.forEach(m => {
-          report += `  ${m.id} - ${m.title}\n`;
-          report += `    Reason: ${m.reason}\n`;
-        });
-      }
-
-      if (highMissing.length > 0) {
-        report += '\nHIGH PRIORITY:\n';
-        highMissing.forEach(m => {
-          report += `  ${m.id} - ${m.title}\n`;
-          report += `    Reason: ${m.reason}\n`;
-        });
-      }
-
-      if (otherMissing.length > 0) {
-        report += '\nOTHER:\n';
-        otherMissing.forEach(m => {
-          report += `  ${m.id} - ${m.title}\n`;
-        });
-      }
-      report += '\n';
-    }
-
-    report += '='.repeat(60) + '\n';
-
-    return report;
-  }
-
-  suggestImprovements() {
-    if (!this.results) {
-      return [];
-    }
-
-    const suggestions = [];
-    const missing = this.getMissingMantras();
-
-    const criticalMissing = missing.filter(m => m.priority === 'critical');
-    if (criticalMissing.length > 0) {
-      suggestions.push({
-        priority: 'critical',
-        category: 'Critical Improvements',
-        items: criticalMissing.map(m => ({
-          mantra: m.id,
-          title: m.title,
-          suggestion: this._getSuggestionForMantra(m)
-        }))
-      });
-    }
-
-    const highMissing = missing.filter(m => m.priority === 'high');
-    if (highMissing.length > 0) {
-      suggestions.push({
-        priority: 'high',
-        category: 'High Priority Improvements',
-        items: highMissing.map(m => ({
-          mantra: m.id,
-          title: m.title,
-          suggestion: this._getSuggestionForMantra(m)
-        }))
-      });
-    }
-
-    const mediumMissing = missing.filter(m => m.priority === 'medium');
-    if (mediumMissing.length > 0 && mediumMissing.length <= 5) {
-      suggestions.push({
-        priority: 'medium',
-        category: 'Quick Wins',
-        items: mediumMissing.slice(0, 5).map(m => ({
-          mantra: m.id,
-          title: m.title,
-          suggestion: this._getSuggestionForMantra(m)
-        }))
-      });
-    }
-
-    return suggestions;
-  }
-
-  _getSuggestionForMantra(mantra) {
-    const mantraData = this.mantras.find(m => m.id === mantra.id);
-    
-    if (!mantraData) {
-      return 'Review mantra requirements and update agent definition';
-    }
-
-    const validation = mantraData.validation;
-
-    if (validation.type === 'keyword') {
-      return `Include one or more of these keywords: ${validation.keywords.join(', ')}`;
-    } else if (validation.type === 'pattern') {
-      if (validation.mustNotMatch) {
-        return `Remove forbidden patterns matching: ${validation.pattern}`;
-      } else {
-        return `Add content matching pattern: ${validation.pattern}`;
-      }
-    } else if (validation.type === 'coverage') {
-      return `Increase test coverage to at least ${validation.threshold}%`;
-    }
-
-    return mantraData.description;
-  }
-
-  export(format = 'json') {
-    if (!this.results) {
-      throw new Error('No validation results available. Run validate() first.');
-    }
-
-    if (format === 'json') {
-      return JSON.stringify({
-        ...this.results,
-        missingMantras: this.getMissingMantras(),
-        suggestions: this.suggestImprovements()
-      }, null, 2);
-    } else if (format === 'text') {
-      return this.generateReport();
-    } else if (format === 'summary') {
-      return {
-        score: this.results.score,
-        status: this.results.score >= 80 ? 'PASS' : this.results.score >= 60 ? 'WARNING' : 'FAIL',
-        compliant: this.results.compliant.length,
-        nonCompliant: this.results.nonCompliant.length,
-        criticalErrors: this.results.errors.length,
-        executionTimeMs: this.results.executionTimeMs
-      };
-    }
-
-    throw new Error(`Unsupported export format: ${format}`);
-  }
-
-  getMantraById(mantraId) {
-    return this.mantras.find(m => m.id === mantraId);
-  }
-
-  getMantrasByCategory(category) {
-    return this.mantras.filter(m => m.category === category);
-  }
-
-  getMantrasByPriority(priority) {
-    return this.mantras.filter(m => m.priority === priority);
-  }
-}
-
-module.exports = MantraValidator;

package/src/byan-v2/integration/voice-integration.js

@@ -1,295 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-const { exec } = require('child_process');
-const { promisify } = require('util');
-
-const execAsync = promisify(exec);
-
-/**
- * VoiceIntegration - Turbo Whisper voice input integration for BYAN v2
- * 
- * Enables voice-driven agent interaction through Turbo Whisper transcription.
- * Supports GitHub Copilot CLI, Claude Code, and Codex platforms.
- * 
- * @version 2.1.0
- * @module integration/voice-integration
- */
-class VoiceIntegration {
-  constructor(sessionState, logger) {
-    this.sessionState = sessionState;
-    this.logger = logger;
-    this.enabled = false;
-    this.config = null;
-    this.serverHealthy = false;
-  }
-
-  /**
-   * Initialize voice integration
-   * Detects Turbo Whisper installation and configuration
-   * @returns {Promise<boolean>} True if initialization successful
-   */
-  async initialize() {
-    try {
-      this.logger.debug('[VoiceIntegration] Initializing...');
-      
-      const installed = await this.detectInstallation();
-      if (!installed) {
-        this.logger.info('[VoiceIntegration] Turbo Whisper not installed');
-        return false;
-      }
-
-      const configLoaded = await this.loadConfig();
-      if (!configLoaded) {
-        this.logger.warn('[VoiceIntegration] Config not found, using defaults');
-        return false;
-      }
-
-      const healthy = await this.checkHealth();
-      if (!healthy) {
-        this.logger.warn('[VoiceIntegration] Server not responding');
-        return false;
-      }
-
-      this.enabled = true;
-      this.logger.info('[VoiceIntegration] Initialized successfully');
-      this.sessionState.set('voice_integration_enabled', true);
-      
-      return true;
-    } catch (error) {
-      this.logger.error('[VoiceIntegration] Initialization failed:', error);
-      return false;
-    }
-  }
-
-  /**
-   * Detect if Turbo Whisper is installed
-   * @returns {Promise<boolean>}
-   */
-  async detectInstallation() {
-    try {
-      const { stdout } = await execAsync('which turbo-whisper');
-      const turboWhisperPath = stdout.trim();
-      
-      if (turboWhisperPath) {
-        this.logger.debug(`[VoiceIntegration] Found at: ${turboWhisperPath}`);
-        return true;
-      }
-      
-      return false;
-    } catch (error) {
-      return false;
-    }
-  }
-
-  /**
-   * Load Turbo Whisper configuration
-   * @returns {Promise<boolean>}
-   */
-  async loadConfig() {
-    try {
-      const homeDir = process.env.HOME || process.env.USERPROFILE;
-      const configPath = path.join(homeDir, '.config', 'turbo-whisper', 'config.json');
-
-      if (!fs.existsSync(configPath)) {
-        return false;
-      }
-
-      const configContent = fs.readFileSync(configPath, 'utf8');
-      this.config = JSON.parse(configContent);
-      
-      this.logger.debug('[VoiceIntegration] Config loaded:', {
-        api_url: this.config.api_url,
-        hotkey: this.config.hotkey,
-        claude_integration: this.config.claude_integration
-      });
-
-      return true;
-    } catch (error) {
-      this.logger.error('[VoiceIntegration] Config load failed:', error);
-      return false;
-    }
-  }
-
-  /**
-   * Check if Turbo Whisper server is healthy
-   * @returns {Promise<boolean>}
-   */
-  async checkHealth() {
-    if (!this.config) {
-      return false;
-    }
-
-    try {
-      const apiUrl = this.config.api_url;
-      
-      if (apiUrl.includes('localhost') || apiUrl.includes('127.0.0.1')) {
-        const port = apiUrl.match(/:(\d+)/)?.[1] || '8000';
-        const healthUrl = `http://localhost:${port}/health`;
-        
-        const { stdout } = await execAsync(`curl -s ${healthUrl}`);
-        
-        // fedirz/faster-whisper-server returns "OK" (string)
-        // Other servers may return {"status": "ok"} (object)
-        if (stdout.trim() === 'OK') {
-          this.serverHealthy = true;
-          return true;
-        }
-        
-        try {
-          const response = JSON.parse(stdout);
-          this.serverHealthy = response.status === 'ok';
-          return this.serverHealthy;
-        } catch {
-          // If not JSON and not "OK", server not ready
-          return false;
-        }
-      }
-
-      this.serverHealthy = true;
-      return true;
-    } catch (error) {
-      this.logger.debug('[VoiceIntegration] Health check failed:', error.message);
-      return false;
-    }
-  }
-
-  /**
-   * Get voice integration status
-   * @returns {Object} Status object
-   */
-  getStatus() {
-    return {
-      enabled: this.enabled,
-      installed: this.config !== null,
-      serverHealthy: this.serverHealthy,
-      config: this.config ? {
-        apiUrl: this.config.api_url,
-        hotkey: this.config.hotkey?.join('+'),
-        claudeIntegration: this.config.claude_integration,
-        language: this.config.language
-      } : null
-    };
-  }
-
-  /**
-   * Suggest voice input for long-form responses
-   * @param {string} context - Current interaction context
-   * @returns {string|null} Suggestion message or null
-   */
-  suggestVoiceInput(context) {
-    if (!this.enabled) {
-      return null;
-    }
-
-    const longFormContexts = [
-      'project_description',
-      'pain_points',
-      'requirements',
-      'use_cases',
-      'business_rules'
-    ];
-
-    if (longFormContexts.some(ctx => context.includes(ctx))) {
-      const hotkey = this.config?.hotkey?.join('+') || 'Ctrl+Shift+Space';
-      return `💡 Voice input available: Press ${hotkey} to speak your response`;
-    }
-
-    return null;
-  }
-
-  /**
-   * Guide user to install Turbo Whisper
-   * @returns {Object} Installation guidance
-   */
-  getInstallationGuide() {
-    return {
-      message: 'Turbo Whisper not detected',
-      options: [
-        {
-          title: 'Install via BMAD Agent',
-          command: '@bmad-agent-turbo-whisper-integration',
-          description: 'Guided installation with wizard'
-        },
-        {
-          title: 'Manual Installation',
-          steps: [
-            'Ubuntu/Debian: sudo add-apt-repository ppa:bengweeks/turbo-whisper && sudo apt install turbo-whisper',
-            'Arch Linux: yay -S turbo-whisper',
-            'From source: git clone https://github.com/knowall-ai/turbo-whisper.git && cd turbo-whisper && pip install -e .'
-          ]
-        },
-        {
-          title: 'Skip',
-          description: 'Continue without voice input'
-        }
-      ]
-    };
-  }
-
-  /**
-   * Validate voice transcription quality
-   * @param {string} transcription - Transcribed text
-   * @returns {Object} Quality metrics
-   */
-  validateTranscription(transcription) {
-    const metrics = {
-      length: transcription.length,
-      wordCount: transcription.split(/\s+/).length,
-      hasSpecialChars: /[^\w\s]/g.test(transcription),
-      quality: 'unknown'
-    };
-
-    if (metrics.wordCount < 3) {
-      metrics.quality = 'poor';
-      metrics.warning = 'Transcription too short, may be incomplete';
-    } else if (metrics.wordCount < 10) {
-      metrics.quality = 'fair';
-    } else {
-      metrics.quality = 'good';
-    }
-
-    return metrics;
-  }
-
-  /**
-   * Offer voice input option during interview
-   * @param {string} questionId - Current question identifier
-   * @returns {string|null} Voice prompt suggestion
-   */
-  offerVoicePrompt(questionId) {
-    if (!this.enabled) {
-      return null;
-    }
-
-    const voiceOptimalQuestions = [
-      'project_description',
-      'pain_points',
-      'goals',
-      'requirements',
-      'use_cases',
-      'business_rules'
-    ];
-
-    if (voiceOptimalQuestions.includes(questionId)) {
-      const hotkey = this.config?.hotkey?.join('+') || 'Ctrl+Shift+Space';
-      return `[Voice: ${hotkey}] You can speak your response for faster input`;
-    }
-
-    return null;
-  }
-
-  /**
-   * Log voice usage metrics
-   * @param {Object} metrics - Usage metrics
-   */
-  logUsageMetrics(metrics) {
-    const usage = this.sessionState.get('voice_usage_metrics') || [];
-    usage.push({
-      timestamp: new Date().toISOString(),
-      ...metrics
-    });
-    this.sessionState.set('voice_usage_metrics', usage);
-  }
-}
-
-module.exports = VoiceIntegration;