agentvibes 2.5.0 → 2.7.0

package/src/installer.js

@@ -53,6 +53,13 @@ import boxen from 'boxen';
 import ora from 'ora';
 import { fileURLToPath } from 'node:url';
 import { installMCP } from './commands/install-mcp.js';
+import {
+  previewVoice,
+  listAvailableVoices,
+  listBmadAssignedVoices,
+  assignVoice,
+  resetBmadVoices,
+} from './commands/bmad-voices.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -63,6 +70,13 @@ const packageJson = JSON.parse(
 );
 const VERSION = packageJson.version;
 
+// Configure CLI
+program
+  .name('agentvibes')
+  .description('🎙️ AgentVibes - Text-to-Speech with personality for AI Assistants')
+  .version(VERSION, '-v, --version', 'Output the current version')
+  .helpOption('-h, --help', 'Display help for command');
+
 // Beautiful ASCII art
 function showWelcome() {
   console.log('');
@@ -113,31 +127,26 @@ function showReleaseInfo() {
   console.log(
     boxen(
       chalk.white.bold('═══════════════════════════════════════════════════════════════\n') +
-      chalk.cyan.bold('  📦 AgentVibes v2.5.0 - Verbosity Control System\n') +
-      chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
-      chalk.green.bold('🎙️ NEW FEATURE:\n\n') +
-      chalk.cyan('Intelligent Verbosity Control\n') +
-      chalk.gray('   • Control how much Claude speaks while working\n') +
-      chalk.gray('   • LOW: Acknowledgments + completions only (minimal)\n') +
-      chalk.gray('   • MEDIUM: + Major decisions and findings (balanced)\n') +
-      chalk.gray('   • HIGH: Full reasoning process (maximum transparency)\n') +
-      chalk.gray('   • Uses emoji markers (💭 🤔 ✓) for automatic TTS\n') +
-      chalk.gray('   • No manual Bash calls needed!\n\n') +
-      chalk.cyan('How to Use:\n') +
-      chalk.gray('   /agent-vibes:verbosity high    # Maximum transparency\n') +
-      chalk.gray('   /agent-vibes:verbosity medium  # Balanced\n') +
-      chalk.gray('   /agent-vibes:verbosity low     # Minimal (default)\n\n') +
-      chalk.cyan('Perfect For:\n') +
-      chalk.gray('   • LOW: Quiet, focused work sessions\n') +
-      chalk.gray('   • MEDIUM: Understanding major decisions\n') +
-      chalk.gray('   • HIGH: Learning mode, debugging complex tasks\n\n') +
+      chalk.cyan.bold('  📦 AgentVibes v2.6.0 - BMAD Integration & Voice Management CLI\n') +
       chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
-      chalk.green.bold('🚀 TRY LANGUAGE LEARNING MODE:\n\n') +
-      chalk.cyan('  /agent-vibes:language english\n') +
-      chalk.cyan('  /agent-vibes:target spanish\n') +
-      chalk.cyan('  /agent-vibes:learn\n\n') +
-      chalk.white('  Learn a second language while coding!\n') +
-      chalk.white('  Spanish, Italian, French, Mandarin, and more! 🌍\n\n') +
+      chalk.green.bold('🎙️ WHAT\'S NEW:\n\n') +
+      chalk.cyan('AgentVibes v2.6.0 brings comprehensive BMAD integration with unique\n') +
+      chalk.cyan('AI voices for all agents! BMAD is a revolutionary AI-driven agile\n') +
+      chalk.cyan('framework that automatically adapts from single bug fixes to\n') +
+      chalk.cyan('enterprise-scale systems. This release includes 5 new CLI commands\n') +
+      chalk.cyan('for voice management, fuzzy voice matching (use short names like\n') +
+      chalk.cyan('"ryan"), BMAD v6 support with backward compatibility, and an\n') +
+      chalk.cyan('improved help system.\n\n') +
+      chalk.green.bold('✨ KEY HIGHLIGHTS:\n\n') +
+      chalk.gray('   🎙️ BMAD TTS Integration - All BMAD agents can now speak!\n') +
+      chalk.gray('   🛠️ Voice Management CLI - 5 new commands for managing voices\n') +
+      chalk.gray('   🔍 Fuzzy Voice Matching - Use "ryan" instead of "en_US-ryan-high"\n') +
+      chalk.gray('   📚 Improved Help - Built-in help command lists all commands\n') +
+      chalk.gray('   🔧 BMAD v6 Support - Detects latest BMAD folder structure\n\n') +
+      chalk.cyan('Try the new commands:\n') +
+      chalk.gray('   npx agentvibes help\n') +
+      chalk.gray('   npx agentvibes preview-voice ryan\n') +
+      chalk.gray('   npx agentvibes list-available-voices\n\n') +
       chalk.white.bold('═══════════════════════════════════════════════════════════════\n\n') +
       chalk.gray('📖 Full Release Notes: RELEASE_NOTES.md\n') +
       chalk.gray('🌐 Website: https://agentvibes.org\n') +
@@ -182,7 +191,7 @@ function getUserShell() {
 
 /**
  * Execute a shell script using the user's default shell with environment loaded
- * @param {string} scriptPath - Path to the script to execute
+ * @param {string} scriptPath - Path to the script with optional arguments (e.g., "script.sh enable")
  * @param {object} options - execSync options
  * @returns {Buffer} - Output from the script
  */
@@ -190,7 +199,8 @@ function execScript(scriptPath, options = {}) {
   const { shell, shellConfig } = getUserShell();
 
   // Source the shell config to load environment variables, then run the script
-  const command = `source "${shellConfig}" 2>/dev/null; ${shell} "${scriptPath}"`;
+  // Don't wrap scriptPath in quotes - it may contain arguments
+  const command = `source "${shellConfig}" 2>/dev/null; ${shell} ${scriptPath}`;
 
   return execSync(command, {
     shell: shell,
@@ -766,6 +776,160 @@ async function checkAndInstallPiper(targetDir, options) {
   }
 }
 
+/**
+ * Process TTS_INJECTION markers in BMAD files
+ * Replaces markers with actual TTS instructions for both party mode and individual agents
+ * @param {string} bmadPath - Path to BMAD installation (e.g., .bmad or bmad)
+ */
+async function processBmadTtsInjections(bmadPath) {
+  const partyModeMarker = '<!-- TTS_INJECTION:party-mode -->';
+  const agentTtsMarker = '<!-- TTS_INJECTION:agent-tts -->';
+
+  const partyModeReplacement = `If AgentVibes party mode is enabled, immediately trigger TTS with agent's voice:
+         - Use Bash tool: \`.claude/hooks/bmad-speak.sh '[Agent Name]' '[dialogue]'\`
+         - This speaks the dialogue with the agent's unique voice
+         - Run in background (&) to not block next agent`;
+
+  const agentTtsReplacement = `- When responding to user messages, speak your responses using TTS:
+   Call: \`.claude/hooks/bmad-speak.sh '{agent-id}' '{response-text}'\` after each response
+   Replace {agent-id} with YOUR agent ID from <agent id="..."> tag at top of this file
+   Replace {response-text} with the text you just output to the user
+   IMPORTANT: Use single quotes as shown - do NOT escape special characters like ! or $ inside single quotes
+   Run in background (&) to avoid blocking`;
+
+  // Process party mode file
+  const partyModeFile = path.join(bmadPath, 'core/workflows/party-mode/instructions.md');
+  try {
+    let partyContent = await fs.readFile(partyModeFile, 'utf8');
+    if (partyContent.includes(partyModeMarker)) {
+      partyContent = partyContent.replaceAll(partyModeMarker, partyModeReplacement);
+      await fs.writeFile(partyModeFile, partyContent, 'utf8');
+    }
+  } catch (error) {
+    // Party mode file doesn't exist or already processed - skip
+  }
+
+  // Process all agent files
+  const agentDirs = [
+    path.join(bmadPath, 'bmm/agents'),
+    path.join(bmadPath, 'bmgd/agents'),
+    path.join(bmadPath, 'bmb/agents'),
+    path.join(bmadPath, 'cis/agents'),
+  ];
+
+  for (const agentDir of agentDirs) {
+    try {
+      const files = await fs.readdir(agentDir);
+      for (const file of files) {
+        if (file.endsWith('.md')) {
+          const agentFile = path.join(agentDir, file);
+          let content = await fs.readFile(agentFile, 'utf8');
+          if (content.includes(agentTtsMarker)) {
+            content = content.replaceAll(agentTtsMarker, agentTtsReplacement);
+            await fs.writeFile(agentFile, content, 'utf8');
+          }
+        }
+      }
+    } catch (error) {
+      // Agent directory doesn't exist - skip
+    }
+  }
+
+  // Create default voice assignments for BMAD agents
+  await createDefaultBmadVoiceAssignments(bmadPath);
+}
+
+async function createDefaultBmadVoiceAssignments(bmadPath) {
+  const configDir = path.join(bmadPath, '_cfg');
+  const voiceMapFile = path.join(configDir, 'agent-voice-map.csv');
+
+  // Skip if voice map already exists
+  try {
+    await fs.access(voiceMapFile);
+    return; // File exists, don't overwrite
+  } catch {
+    // File doesn't exist, create it
+  }
+
+  // Default voice assignments for common BMAD agents
+  const defaultVoices = `agent_id,voice_name
+pm,en_US-ryan-high
+architect,en_US-danny-low
+dev,en_US-joe-medium
+analyst,en_US-amy-medium
+ux-designer,en_US-kristin-medium
+tea,en_US-lessac-medium
+sm,en_US-bryce-medium
+tech-writer,en_US-kathleen-low
+frame-expert,en_US-kusal-medium
+bmad-master,en_US-libritts_r-high
+`;
+
+  try {
+    await fs.mkdir(configDir, { recursive: true });
+    await fs.writeFile(voiceMapFile, defaultVoices, 'utf8');
+    console.log('✓ Created default BMAD agent voice assignments');
+  } catch (error) {
+    // Non-fatal error - voice assignments are optional
+    console.log('Note: Could not create default voice assignments:', error.message);
+  }
+}
+
+/**
+ * Proactively create default BMAD voice assignments
+ * Only creates if BMAD folder already exists (doesn't create folders proactively to avoid false legacy detection)
+ * @param {string} targetDir - Target installation directory
+ */
+async function createDefaultBmadVoiceAssignmentsProactive(targetDir) {
+  const bmadPaths = [
+    path.join(targetDir, '.bmad'),
+    path.join(targetDir, 'bmad'),
+  ];
+
+  const defaultVoices = `agent_id,voice_name
+pm,en_US-ryan-high
+architect,en_US-danny-low
+dev,en_US-joe-medium
+analyst,en_US-amy-medium
+ux-designer,en_US-kristin-medium
+tea,en_US-lessac-medium
+sm,en_US-bryce-medium
+tech-writer,en_US-kathleen-low
+frame-expert,en_US-kusal-medium
+bmad-master,en_US-libritts_r-high
+`;
+
+  for (const bmadPath of bmadPaths) {
+    // Only create if BMAD folder already exists
+    // Don't create folders proactively - this triggers false legacy v4 detection in BMAD installer
+    try {
+      await fs.access(bmadPath);
+    } catch {
+      continue; // Folder doesn't exist, skip
+    }
+
+    const configDir = path.join(bmadPath, '_cfg');
+    const voiceMapFile = path.join(configDir, 'agent-voice-map.csv');
+
+    // Skip if voice map already exists
+    try {
+      await fs.access(voiceMapFile);
+      continue; // File exists, don't overwrite
+    } catch {
+      // File doesn't exist, create it
+    }
+
+    try {
+      await fs.mkdir(configDir, { recursive: true });
+      await fs.writeFile(voiceMapFile, defaultVoices, 'utf8');
+      console.log(`✓ Created default BMAD voice assignments in ${bmadPath}`);
+    } catch (error) {
+      // Non-fatal error - voice assignments are optional
+      // Silent fail
+    }
+  }
+}
+
 /**
  * Handle BMAD integration (detection and TTS injection)
  * @param {string} targetDir - Target installation directory
@@ -803,32 +967,11 @@ async function handleBmadIntegration(targetDir) {
     console.log(chalk.green('📝 Created BMAD activation instructions'));
   }
 
-  console.log(chalk.cyan('\n🎤 Injecting TTS into BMAD agents...'));
-  try {
-    const injectorScript = path.join(claudeDir, 'hooks', 'bmad-tts-injector.sh');
+  // Process TTS_INJECTION markers in BMAD files if they exist
+  // This handles the case where BMAD was installed before AgentVibes
+  await processBmadTtsInjections(bmadDetection.bmadPath);
 
-    try {
-      await fs.access(injectorScript);
-    } catch {
-      console.log(chalk.yellow('⚠️  bmad-tts-injector.sh not found, skipping automatic injection'));
-      console.log(chalk.gray('   You can manually enable it later with: .claude/hooks/bmad-tts-injector.sh enable'));
-      return bmadDetection;
-    }
-
-    await fs.chmod(injectorScript, 0o755);
-
-    const result = execScript(`${injectorScript} enable`, {
-      cwd: targetDir,
-      encoding: 'utf8',
-      stdio: 'pipe'
-    });
-
-    console.log(result);
-  } catch (error) {
-    console.log(chalk.yellow('⚠️  TTS injection encountered an issue:'));
-    console.log(chalk.gray(`   ${error.message}`));
-    console.log(chalk.gray('   You can manually enable it later with: .claude/hooks/bmad-tts-injector.sh enable'));
-  }
+  console.log(chalk.green('✅ BMAD agents will use agent-specific voices via bmad-speak.sh hook'));
 
   return bmadDetection;
 }
@@ -1357,6 +1500,9 @@ async function install(options = {}) {
       }
     ]);
 
+    // Create default BMAD voice assignments (works even if BMAD not installed yet)
+    await createDefaultBmadVoiceAssignmentsProactive(targetDir);
+
     // Handle BMAD integration
     const bmadDetection = await handleBmadIntegration(targetDir);
     const bmadDetected = bmadDetection.installed;
@@ -1567,6 +1713,52 @@ program
     }
   });
 
+// BMAD Voice Management Commands
+program
+  .command('preview-voice <voice-name>')
+  .description('Preview a voice with sample text')
+  .option('-t, --text <text>', 'Custom text to speak (default: sample text)')
+  .action(async (voiceName, options) => {
+    await previewVoice(voiceName, options);
+  });
+
+program
+  .command('list-available-voices')
+  .description('Show all available voices grouped by provider')
+  .action(async () => {
+    await listAvailableVoices();
+  });
+
+program
+  .command('list-bmad-assigned-voices')
+  .description('Show all BMAD agents with their current voice assignments')
+  .action(async () => {
+    await listBmadAssignedVoices();
+  });
+
+program
+  .command('assign-voice <agent-id> <voice-name>')
+  .description('Assign a voice to a specific BMAD agent')
+  .action(async (agentId, voiceName) => {
+    await assignVoice(agentId, voiceName);
+  });
+
+program
+  .command('reset-bmad-voices')
+  .description('Reset all BMAD agents to default voice assignments')
+  .option('-y, --yes', 'Skip confirmation prompt (auto-confirm)')
+  .action(async (options) => {
+    await resetBmadVoices(options);
+  });
+
+// Help command
+program
+  .command('help')
+  .description('Display help information')
+  .action(() => {
+    program.outputHelp();
+  });
+
 program.parse(process.argv);
 
 // Show help if no command provided

package/.claude/hooks/user-prompt-output.sh

@@ -1,111 +0,0 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/user-prompt-output.sh
-#
-# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
-# Website: https://agentvibes.org
-# Repository: https://github.com/paulpreibisch/AgentVibes
-#
-# Co-created by Paul Preibisch with Claude AI
-# Copyright (c) 2025 Paul Preibisch
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
-# express or implied, including but not limited to the warranties of
-# merchantability, fitness for a particular purpose and noninfringement.
-# In no event shall the authors or copyright holders be liable for any claim,
-# damages or other liability, whether in an action of contract, tort or
-# otherwise, arising from, out of or in connection with the software or the
-# use or other dealings in the software.
-#
-# ---
-#
-# @fileoverview Auto-detects emoji markers in Claude's output and triggers TTS
-# @context Implements verbosity system by detecting 💭 🤔 ✓ markers and speaking them
-# @architecture Stdin reader, regex matcher, async TTS trigger
-# @dependencies play-tts.sh, tts-verbosity.txt
-# @entrypoints Called by Claude Code after each assistant response (user-prompt-output hook)
-# @patterns Text stream processing, background job execution, marker-based triggers
-# @related session-start-tts.sh, verbosity-manager.sh, Issue #32
-# @aiNotes This hook enables natural emoji-based TTS without Claude needing manual Bash calls
-
-# Fix locale warnings
-export LC_ALL=C
-
-# Get script directory
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PLAY_TTS="$SCRIPT_DIR/play-tts.sh"
-
-# Get verbosity level
-VERBOSITY=$(cat .claude/tts-verbosity.txt 2>/dev/null || cat ~/.claude/tts-verbosity.txt 2>/dev/null || echo "low")
-
-# Read stdin (Claude's output) - preserve it for display
-OUTPUT=$(cat)
-
-# Always output the original text first (so user sees it)
-echo "$OUTPUT"
-
-# Exit early if play-tts.sh doesn't exist (AgentVibes not installed)
-[[ ! -f "$PLAY_TTS" ]] && exit 0
-
-#
-# @function extract_and_speak
-# @context Extracts text after emoji markers and triggers TTS asynchronously
-# @architecture Uses grep to find markers, extracts text, launches TTS in background
-# @dependencies play-tts.sh
-# @entrypoints Called based on verbosity level
-# @aiNotes Background execution (&) prevents blocking Claude's output
-#
-extract_and_speak() {
-  local pattern="$1"
-
-  # Extract lines matching the pattern
-  # Pattern format: "emoji text" or "emoji [text]"
-  while IFS= read -r line; do
-    # Try to extract text after emoji
-    # Handles formats: "💭 text", "💭 [text]", "💭text"
-    if echo "$line" | grep -qE "$pattern"; then
-      # Extract everything after the emoji (and optional space/bracket)
-      text=$(echo "$line" | sed -E "s/^.*($pattern)[[:space:]]*\[?[[:space:]]*//" | sed 's/\]$//')
-
-      # Skip if text is empty or too short
-      [[ -z "$text" || ${#text} -lt 3 ]] && continue
-
-      # Speak it in background (don't block)
-      bash "$PLAY_TTS" "$text" >/dev/null 2>&1 &
-    fi
-  done <<< "$OUTPUT"
-}
-
-# Process based on verbosity level
-case "$VERBOSITY" in
-  high)
-    # HIGH: Speak ALL markers (💭 🤔 ✓)
-    # Don't speak ✅ here - that's handled by manual TTS completion call
-    extract_and_speak "💭|🤔|✓"
-    ;;
-
-  medium)
-    # MEDIUM: Speak decisions and findings (🤔 ✓)
-    extract_and_speak "🤔|✓"
-    ;;
-
-  low)
-    # LOW: No automatic extraction (only manual ACK/COMPLETE TTS calls)
-    # Don't process any markers
-    ;;
-esac
-
-# Exit successfully
-exit 0

package/.claude/plugins/bmad-voices.md

@@ -1,51 +0,0 @@
----
-plugin: bmad-voices
-version: 2.0.0
-enabled: true
-description: Provider-aware voice mappings for BMAD agents
----
-
-# BMAD Voice Plugin
-
-This plugin automatically assigns voices to BMAD agents based on their role and active TTS provider.
-
-## Agent Voice Mappings (Provider-Aware)
-
-| Agent ID | Agent Name | ElevenLabs Voice | Piper Voice | Personality |
-|----------|------------|------------------|-------------|-------------|
-| pm | John (Product Manager) | Jessica Anne Bogart | en_US-ryan-high | professional |
-| dev | James (Developer) | Matthew Schmitz | en_US-joe-medium | normal |
-| qa | Quinn (QA) | Aria | en_US-amy-medium | professional |
-| architect | Winston (Architect) | Michael | en_GB-alan-medium | normal |
-| po | Product Owner | Aria | en_US-amy-medium | professional |
-| analyst | Analyst | Matthew Schmitz | kristin | normal |
-| sm | Scrum Master | Jessica Anne Bogart | kristin | professional |
-| ux-expert | UX Expert | Aria | jenny | normal |
-| bmad-master | BMAD Master | Michael | en_GB-alan-medium | zen |
-| bmad-orchestrator | Orchestrator | Matthew Schmitz | en_US-ryan-high | professional |
-
-## How It Works
-
-The voice manager automatically selects the appropriate voice based on your active TTS provider:
-- **ElevenLabs active**: Uses voices from the "ElevenLabs Voice" column
-- **Piper active**: Uses voices from the "Piper Voice" column
-
-This ensures BMAD agents work seamlessly regardless of which provider you're using.
-
-## How to Edit
-
-Simply edit the table above to change voice mappings. The format is:
-- **Agent ID**: Must match BMAD's `agent.id` field (pm, dev, qa, etc.)
-- **Agent Name**: Display name (for reference only)
-- **ElevenLabs Voice**: Voice name for ElevenLabs provider
-- **Piper Voice**: Voice model name for Piper provider
-- **Personality**: Optional personality to apply (or "normal" for none)
-
-## Commands
-
-- `/agent-vibes:bmad enable` - Enable BMAD voice plugin
-- `/agent-vibes:bmad disable` - Disable BMAD voice plugin
-- `/agent-vibes:bmad status` - Show plugin status
-- `/agent-vibes:bmad edit` - Open this file for editing
-- `/agent-vibes:bmad list` - List all agent voice mappings
-- `/agent-vibes:bmad set <agent-id> <elevenlabs-voice> <piper-voice> [personality]` - Set voices for specific agent