agentvibes 2.0.9 → 2.0.12

package/src/installer.js

@@ -47,7 +47,7 @@ function showWelcome() {
 
   console.log(
     boxen(
-      chalk.white.bold('🎤 Beautiful ElevenLabs TTS Voice Commands for Claude Code\n\n') +
+      chalk.white.bold('🎤 Now your AI Agents can finally talk back! TTS Voice for Claude Code\n\n') +
       chalk.gray('Add professional text-to-speech narration to your AI coding sessions\n\n') +
       chalk.cyan('📦 https://github.com/paulpreibisch/AgentVibes'),
       {
@@ -136,8 +136,93 @@ async function install(options = {}) {
 
     selectedProvider = provider;
 
-    // If Piper selected, ask for voice storage location
+    // If Piper selected, check if Piper is installed
     if (selectedProvider === 'piper') {
+      // Check if Piper is installed
+      let piperInstalled = false;
+      try {
+        const { execSync } = await import('node:child_process');
+        // First check if piper is in PATH
+        execSync('which piper', { stdio: 'ignore' });
+        piperInstalled = true;
+      } catch {
+        // If not in PATH, check if it exists in pipx installation directory
+        const homeDir = process.env.HOME || process.env.USERPROFILE;
+        const pipxPiperPath = path.join(homeDir, '.local', 'bin', 'piper');
+        try {
+          await fs.access(pipxPiperPath, fs.constants.X_OK);
+          piperInstalled = true;
+          console.log(chalk.yellow('\n⚠️  Piper is installed but not in PATH'));
+          console.log(chalk.gray(`   Location: ${pipxPiperPath}`));
+          console.log(chalk.gray('   Run this to add to PATH:'));
+          console.log(chalk.cyan('   export PATH="$HOME/.local/bin:$PATH"\n'));
+        } catch {
+          // Piper not found anywhere
+        }
+      }
+
+      if (!piperInstalled) {
+        console.log(chalk.yellow('\n⚠️  Piper TTS is not installed'));
+        console.log(chalk.gray('   Piper is a free, offline neural TTS system'));
+        console.log(chalk.gray('   It needs to be installed separately via pipx\n'));
+
+        const { installPiper } = await inquirer.prompt([
+          {
+            type: 'confirm',
+            name: 'installPiper',
+            message: 'Would you like to install Piper TTS now?',
+            default: true,
+          },
+        ]);
+
+        if (installPiper) {
+          console.log(chalk.cyan('\n🚀 Installing Piper TTS...\n'));
+
+          // Check if piper-installer.sh exists in the source directory
+          const piperInstallerPath = path.join(__dirname, '..', '.claude', 'hooks', 'piper-installer.sh');
+
+          try {
+            await fs.access(piperInstallerPath);
+
+            // Run the Piper installer
+            const { execSync } = await import('node:child_process');
+            try {
+              execSync(`bash "${piperInstallerPath}"`, {
+                stdio: 'inherit',
+                cwd: path.dirname(piperInstallerPath)
+              });
+
+              // Verify installation succeeded
+              try {
+                execSync('which piper', { stdio: 'ignore' });
+                console.log(chalk.green('\n✓ Piper TTS installed successfully!\n'));
+                piperInstalled = true;
+              } catch {
+                console.log(chalk.yellow('\n⚠️  Piper installed but not found in PATH'));
+                console.log(chalk.gray('   You may need to restart your terminal\n'));
+              }
+            } catch (error) {
+              console.log(chalk.red('\n✗ Piper installation failed'));
+              console.log(chalk.gray('   You can try installing manually later with:'));
+              console.log(chalk.cyan('   .claude/hooks/piper-installer.sh\n'));
+            }
+          } catch {
+            console.log(chalk.yellow('\n⚠️  Piper installer script not found'));
+            console.log(chalk.gray('   The installer will be copied during installation'));
+            console.log(chalk.gray('   You can install Piper later with:'));
+            console.log(chalk.cyan('   .claude/hooks/piper-installer.sh\n'));
+          }
+        } else {
+          console.log(chalk.yellow('\n⚠️  Skipping Piper installation'));
+          console.log(chalk.gray('   You can install it later with:'));
+          console.log(chalk.cyan('   .claude/hooks/piper-installer.sh'));
+          console.log(chalk.gray('   Or switch to ElevenLabs with:'));
+          console.log(chalk.cyan('   /agent-vibes:provider switch elevenlabs\n'));
+        }
+      } else {
+        console.log(chalk.green('\n✓ Piper TTS is already installed\n'));
+      }
+
       const homeDir = process.env.HOME || process.env.USERPROFILE;
       const defaultPiperPath = path.join(homeDir, '.claude', 'piper-voices');
 
@@ -294,6 +379,32 @@ async function install(options = {}) {
     } else {
       selectedProvider = 'piper';
       console.log(chalk.green('✓ Using Piper TTS (free option)\n'));
+
+      // Check if Piper is installed in auto mode
+      let piperInstalled = false;
+      const homeDir = process.env.HOME || process.env.USERPROFILE;
+      const pipxPiperPath = path.join(homeDir, '.local', 'bin', 'piper');
+
+      try {
+        const { execSync } = await import('node:child_process');
+        execSync('which piper', { stdio: 'ignore' });
+        piperInstalled = true;
+        console.log(chalk.green('✓ Piper TTS is already installed\n'));
+      } catch {
+        // Check if it exists in pipx installation directory
+        try {
+          await fs.access(pipxPiperPath, fs.constants.X_OK);
+          piperInstalled = true;
+          console.log(chalk.yellow('⚠️  Piper is installed but not in PATH'));
+          console.log(chalk.gray(`   Location: ${pipxPiperPath}`));
+          console.log(chalk.gray('   Add to PATH with:'));
+          console.log(chalk.cyan('   export PATH="$HOME/.local/bin:$PATH"\n'));
+        } catch {
+          console.log(chalk.yellow('⚠️  Piper TTS is not installed'));
+          console.log(chalk.gray('   Install it after setup with:'));
+          console.log(chalk.cyan('   .claude/hooks/piper-installer.sh\n'));
+        }
+      }
     }
   }
 
@@ -485,6 +596,36 @@ async function install(options = {}) {
     }
     spinner.succeed(chalk.green('Installed output styles!\n'));
 
+    // Copy plugins folder (BMAD voice mappings)
+    spinner.start('Installing BMAD plugin files...');
+    const srcPluginsDir = path.join(__dirname, '..', '.claude', 'plugins');
+    const destPluginsDir = path.join(claudeDir, 'plugins');
+
+    // Create plugins directory
+    await fs.mkdir(destPluginsDir, { recursive: true });
+
+    // Copy only .md files from plugins directory
+    let pluginFiles = [];
+    try {
+      const allPluginFiles = await fs.readdir(srcPluginsDir);
+      for (const file of allPluginFiles) {
+        const srcPath = path.join(srcPluginsDir, file);
+        const stat = await fs.stat(srcPath);
+
+        // Only copy .md files, skip .flag files (those are runtime generated)
+        if (stat.isFile() && file.endsWith('.md')) {
+          pluginFiles.push(file);
+          const destPath = path.join(destPluginsDir, file);
+          await fs.copyFile(srcPath, destPath);
+          console.log(chalk.gray(`   ✓ ${file}`));
+        }
+      }
+      spinner.succeed(chalk.green('Installed BMAD plugin files!\n'));
+    } catch (error) {
+      // Plugins directory might not exist in source - that's okay
+      spinner.info(chalk.yellow('No plugin files found (optional)\n'));
+    }
+
     // Save provider selection
     spinner.start('Saving provider configuration...');
     const providerConfigPath = path.join(claudeDir, 'tts-provider.txt');
@@ -502,8 +643,11 @@ async function install(options = {}) {
     console.log(chalk.cyan('📦 Installation Summary:'));
     console.log(chalk.white(`   • ${commandFiles.length} slash commands installed`));
     console.log(chalk.white(`   • ${hookFiles.length} TTS scripts installed`));
-    console.log(chalk.white(`   • ${personalityFiles.length} personality templates installed`));
+    console.log(chalk.white(`   • ${personalityMdFiles.length} personality templates installed`));
     console.log(chalk.white(`   • ${outputStyleFiles.length} output styles installed`));
+    if (pluginFiles.length > 0) {
+      console.log(chalk.white(`   • ${pluginFiles.length} BMAD plugin files installed`));
+    }
     console.log(chalk.white(`   • Voice manager ready`));
 
     if (selectedProvider === 'elevenlabs') {
@@ -585,7 +729,9 @@ async function install(options = {}) {
         chalk.green.bold('✨ Installation Complete! ✨\n\n') +
         chalk.yellow.bold('⚠️  IMPORTANT SETUP STEP:\n') +
         chalk.white('In Claude Code, run this command:\n') +
-        chalk.cyan.bold('/output-style agent-vibes') + '\n\n' +
+        chalk.cyan.bold('/output-style Agent Vibes') + '\n\n' +
+        chalk.magenta('💡 Optional: Enable BMAD plugin integration:\n') +
+        chalk.magenta('/agent-vibes:bmad enable') + '\n\n' +
         chalk.white('🎤 Available Commands:\n\n') +
         chalk.cyan('  /agent-vibes') + chalk.gray(' .................... Show all commands\n') +
         chalk.cyan('  /agent-vibes:list') + chalk.gray(' ............... List available voices\n') +
@@ -611,8 +757,12 @@ async function install(options = {}) {
     );
 
     console.log(chalk.yellow.bold('\n⚠️  REQUIRED SETUP:'));
-    console.log(chalk.white('   1. In Claude Code, run: ') + chalk.cyan.bold('/output-style agent-vibes'));
-    console.log(chalk.gray('      This enables TTS narration for your sessions\n'));
+    console.log(chalk.white('   1. In Claude Code, run: ') + chalk.cyan.bold('/output-style Agent Vibes'));
+    console.log(chalk.gray('      This enables TTS narration for your sessions'));
+    console.log(chalk.magenta('\n   💡 Optional: Enable BMAD plugin integration:'));
+    console.log(chalk.white('   2. In Claude Code, run: ') + chalk.magenta.bold('/agent-vibes:bmad enable'));
+    console.log(chalk.gray('      This assigns unique voices to each BMAD agent'));
+    console.log(chalk.gray('      Get BMAD: ') + chalk.cyan('https://github.com/bmad-code-org/BMAD-METHOD\n'));
     console.log(chalk.gray('💡 Then try these commands:'));
     console.log(chalk.gray('   • /agent-vibes:list - See all available voices'));
     console.log(chalk.gray('   • /agent-vibes:switch <name> - Change your voice'));
@@ -671,7 +821,7 @@ async function install(options = {}) {
 // CLI setup
 program
   .version(VERSION)
-  .description('AgentVibes - Beautiful ElevenLabs TTS Voice Commands for Claude Code');
+  .description('AgentVibes - Now your AI Agents can finally talk back! TTS Voice for Claude Code');
 
 program
   .command('install')
@@ -727,7 +877,7 @@ program
     // Welcome box
     console.log(
       boxen(
-        chalk.white('🎤 Beautiful ElevenLabs TTS Voice Commands for Claude Code\n\n') +
+        chalk.white('🎤 Now your AI Agents can finally talk back! TTS Voice for Claude Code\n\n') +
         chalk.gray('Add professional text-to-speech narration to your AI coding sessions\n\n') +
         chalk.cyan('📦 https://github.com/paulpreibisch/AgentVibes'),
         {
@@ -908,13 +1058,47 @@ program
       }
       console.log(chalk.green(`✓ Updated ${outputStyleFiles.length} output styles`));
 
+      // Update plugins folder (BMAD voice mappings)
+      spinner.text = 'Updating BMAD plugin files...';
+      const srcPluginsDir = path.join(__dirname, '..', '.claude', 'plugins');
+      const destPluginsDir = path.join(claudeDir, 'plugins');
+
+      // Create plugins directory if it doesn't exist
+      await fs.mkdir(destPluginsDir, { recursive: true });
+
+      // Copy only .md files from plugins directory
+      let pluginFiles = [];
+      try {
+        const allPluginFiles = await fs.readdir(srcPluginsDir);
+        for (const file of allPluginFiles) {
+          const srcPath = path.join(srcPluginsDir, file);
+          const stat = await fs.stat(srcPath);
+
+          // Only copy .md files, skip .flag files (those are runtime generated)
+          if (stat.isFile() && file.endsWith('.md')) {
+            pluginFiles.push(file);
+            const destPath = path.join(destPluginsDir, file);
+            await fs.copyFile(srcPath, destPath);
+          }
+        }
+        if (pluginFiles.length > 0) {
+          console.log(chalk.green(`✓ Updated ${pluginFiles.length} BMAD plugin files`));
+        }
+      } catch (error) {
+        // Plugins directory might not exist in source - that's okay
+      }
+
       spinner.succeed(chalk.green.bold('\n✨ Update complete!\n'));
 
       console.log(chalk.cyan('📦 Update Summary:'));
       console.log(chalk.white(`   • ${commandFiles.length} commands updated`));
       console.log(chalk.white(`   • ${hookFiles.length} TTS scripts updated`));
       console.log(chalk.white(`   • ${newPersonalities + updatedPersonalities} personality templates (${newPersonalities} new, ${updatedPersonalities} updated)`));
-      console.log(chalk.white(`   • ${outputStyleFiles.length} output styles updated\n`));
+      console.log(chalk.white(`   • ${outputStyleFiles.length} output styles updated`));
+      if (pluginFiles.length > 0) {
+        console.log(chalk.white(`   • ${pluginFiles.length} BMAD plugin files updated`));
+      }
+      console.log('');
 
       // Show latest release notes from RELEASE_NOTES_V2.md (v2.0+) or RELEASE_NOTES.md (legacy)
       try {

package/test/helpers/test-helper.bash

@@ -118,13 +118,15 @@ setup_agentvibes_scripts() {
 # Create a test personality file
 create_test_personality() {
   local name="$1"
-  local voice="${2:-}"
+  local elevenlabs_voice="${2:-}"
+  local piper_voice="${3:-en_US-lessac-medium}"
 
   cat > "$TEST_PERSONALITIES_DIR/${name}.md" << EOF
 ---
 name: ${name}
 description: Test personality
-voice: ${voice}
+elevenlabs_voice: ${elevenlabs_voice}
+piper_voice: ${piper_voice}
 ---
 
 # ${name} Personality

package/test/unit/personality-manager.bats

@@ -11,9 +11,9 @@ setup() {
 
   PERSONALITY_MANAGER="$TEST_CLAUDE_DIR/hooks/personality-manager.sh"
 
-  # Create test personalities
-  create_test_personality "sarcastic" "Jessica Anne Bogart"
-  create_test_personality "normal"
+  # Create test personalities with both ElevenLabs and Piper voices
+  create_test_personality "sarcastic" "Jessica Anne Bogart" "en_US-amy-medium"
+  create_test_personality "normal" "Aria" "en_US-lessac-medium"
 }
 
 teardown() {
@@ -50,7 +50,8 @@ teardown() {
 }
 
 @test "personality-manager set with assigned voice switches voice silently" {
-  # sarcastic personality has assigned voice "Jessica Anne Bogart"
+  # Set default provider (no provider file defaults to elevenlabs)
+  # sarcastic personality has assigned voice "Jessica Anne Bogart" (ElevenLabs)
   run "$PERSONALITY_MANAGER" set "sarcastic"
 
   [ "$status" -eq 0 ]
@@ -60,6 +61,17 @@ teardown() {
   # (that would indicate double audio bug)
 }
 
+@test "personality-manager set with piper provider uses piper voice" {
+  # Set Piper as active provider
+  echo "piper" > "$HOME/.claude/tts-provider.txt"
+
+  # sarcastic personality should use en_US-amy-medium (Piper voice)
+  run "$PERSONALITY_MANAGER" set "sarcastic"
+
+  [ "$status" -eq 0 ]
+  assert_output_contains "Switching to assigned voice: en_US-amy-medium"
+}
+
 @test "personality-manager reset changes to normal" {
   echo "sarcastic" > "$HOME/.claude/tts-personality.txt"
 

package/test/unit/personality-voice-mapping.bats

@@ -83,9 +83,13 @@ declare -A EXPECTED_VOICES=(
   for personality_file in "$REPO_ROOT/.claude/personalities"/*.md; do
     personality_name=$(basename "$personality_file" .md)
 
-    # Check if file has voice field
-    if ! grep -q "^voice:" "$personality_file"; then
-      errors="${errors}Personality '${personality_name}' missing voice field\n"
+    # Check if file has both elevenlabs_voice and piper_voice fields
+    if ! grep -q "^elevenlabs_voice:" "$personality_file"; then
+      errors="${errors}Personality '${personality_name}' missing elevenlabs_voice field\n"
+      failed=1
+    fi
+    if ! grep -q "^piper_voice:" "$personality_file"; then
+      errors="${errors}Personality '${personality_name}' missing piper_voice field\n"
       failed=1
     fi
   done
@@ -103,11 +107,16 @@ declare -A EXPECTED_VOICES=(
 
   for personality_file in "$REPO_ROOT/.claude/personalities"/*.md; do
     personality_name=$(basename "$personality_file" .md)
-    assigned_voice=$(grep "^voice:" "$personality_file" | cut -d: -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+    assigned_voice=$(grep "^elevenlabs_voice:" "$personality_file" | cut -d: -f2- | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+
+    # Skip if no elevenlabs_voice assigned
+    if [[ -z "$assigned_voice" ]]; then
+      continue
+    fi
 
-    # Check if voice exists in config
+    # Check if ElevenLabs voice exists in config
     if [[ -z "${VOICES[$assigned_voice]}" ]]; then
-      errors="${errors}Personality '${personality_name}' uses undefined voice: ${assigned_voice}\n"
+      errors="${errors}Personality '${personality_name}' uses undefined ElevenLabs voice: ${assigned_voice}\n"
       failed=1
     fi
   done

package/test/unit/play-tts.bats

@@ -66,15 +66,6 @@ teardown() {
   assert_output_contains "Text truncated to 500 characters"
 }
 
-@test "play-tts fails without API key" {
-  unset ELEVENLABS_API_KEY
-
-  run "$PLAY_TTS" "Test message"
-
-  [ "$status" -eq 1 ]
-  assert_output_contains "ELEVENLABS_API_KEY not set"
-}
-
 @test "play-tts fails without text argument" {
   run "$PLAY_TTS"
 

package/.claude/commands/agent-vibes-bmad.md

@@ -1,132 +0,0 @@
-# /agent-vibes:bmad Command
-
-Manage BMAD voice plugin integration for automatic voice assignment to BMAD agents.
-
-## Usage
-
-```
-/agent-vibes:bmad <subcommand> [arguments]
-```
-
-## Subcommands
-
-### `enable`
-Enables automatic voice assignment for BMAD agents.
-
-**Example:**
-```
-/agent-vibes:bmad enable
-```
-
-**Output:**
-- Creates `.claude/plugins/bmad-voices-enabled.flag`
-- Shows current agent voice mappings
-- Confirms activation
-
-### `disable`
-Disables BMAD voice plugin (reverts to default AgentVibes behavior).
-
-**Example:**
-```
-/agent-vibes:bmad disable
-```
-
-**Output:**
-- Removes activation flag
-- AgentVibes uses default voice settings
-
-### `status`
-Shows plugin status and current voice mappings.
-
-**Example:**
-```
-/agent-vibes:bmad status
-```
-
-**Output:**
-```
-✅ BMAD voice plugin: ENABLED
-
-📊 BMAD Agent Voice Mappings:
-   pm → Matthew Schmitz [professional]
-   dev → Jessica Anne Bogart [normal]
-   qa → Ralf Eisend [professional]
-   ...
-```
-
-### `list`
-Lists all BMAD agents and their assigned voices.
-
-**Example:**
-```
-/agent-vibes:bmad list
-```
-
-### `set <agent-id> <voice> [personality]`
-Quickly change voice for specific agent.
-
-**Examples:**
-```
-/agent-vibes:bmad set pm "Aria"
-/agent-vibes:bmad set dev "Cowboy Bob" sarcastic
-/agent-vibes:bmad set qa "Northern Terry" professional
-```
-
-**Arguments:**
-- `agent-id`: BMAD agent identifier (pm, dev, qa, architect, po, analyst, sm, ux-expert, bmad-master, bmad-orchestrator)
-- `voice`: Valid AgentVibes voice name
-- `personality` (optional): Personality to apply (default: normal)
-
-### `edit`
-Opens `.claude/plugins/bmad-voices.md` for manual editing.
-
-**Example:**
-```
-/agent-vibes:bmad edit
-```
-
-**Usage:**
-Edit the markdown table directly to change voice mappings.
-
-## How It Works
-
-1. **Plugin File**: `.claude/plugins/bmad-voices.md` contains voice mappings
-2. **Activation Flag**: `.claude/plugins/bmad-voices-enabled.flag` enables/disables plugin
-3. **Auto-Detection**: When a BMAD agent activates (e.g., `/BMad:agents:pm`), AgentVibes automatically:
-   - Detects the agent ID from the command
-   - Looks up voice mapping in plugin file
-   - Uses assigned voice for TTS acknowledgments/completions
-
-## Available BMAD Agents
-
-| Agent ID | Role | Default Voice |
-|----------|------|---------------|
-| pm | Product Manager | Matthew Schmitz |
-| dev | Developer | Jessica Anne Bogart |
-| qa | QA Engineer | Ralf Eisend |
-| architect | Architect | Michael |
-| po | Product Owner | Amy |
-| analyst | Analyst | Lutz Laugh |
-| sm | Scrum Master | Ms. Walker |
-| ux-expert | UX Expert | Aria |
-| bmad-master | BMAD Master | Aria |
-| bmad-orchestrator | Orchestrator | Ms. Walker |
-
-## Implementation Details
-
-**For AgentVibes Developers:**
-
-The plugin integrates with the Agent Vibes output style through bash hooks:
-
-```bash
-# Check if BMAD agent is active
-BMAD_AGENT_ID=$(echo "$COMMAND" | grep -oP '/BMad:agents:\K[a-z-]+')
-
-# Get voice from plugin if enabled
-if [[ -n "$BMAD_AGENT_ID" ]]; then
-    MAPPED_VOICE=$(.claude/hooks/bmad-voice-manager.sh get-voice "$BMAD_AGENT_ID")
-    if [[ -n "$MAPPED_VOICE" ]]; then
-        .claude/hooks/play-tts.sh "message" "$MAPPED_VOICE"
-    fi
-fi
-```