agentvibes 2.13.8 → 2.14.0

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

@@ -161,20 +161,22 @@ The TTS injection works with **any configured TTS provider**:
 
 The system automatically detects your configured provider via `/agent-vibes:provider info` and uses the appropriate TTS engine. You can switch providers anytime with `/agent-vibes:provider switch` and the BMAD agents will continue speaking using the new provider.
 
-## 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 |
+## Available BMAD Agents (Provider-Aware)
+
+The voice used depends on your active TTS provider. Run `/agent-vibes:provider info` to check your provider.
+
+| Agent ID | Role | ElevenLabs Voice | Piper Voice |
+|----------|------|------------------|-------------|
+| pm | Product Manager | Matthew Schmitz | en_US-ryan-high |
+| dev | Developer | Aria | en_US-amy-medium |
+| analyst | Business Analyst | Jessica Anne Bogart | en_US-kristin-medium |
+| architect | Architect | Michael | en_GB-alan-medium |
+| sm | Scrum Master | Matthew Schmitz | en_US-joe-medium |
+| tea | Test Architect | Michael | en_US-arctic-medium |
+| tech-writer | Technical Writer | Aria | en_US-lessac-medium |
+| ux-designer | UX Designer | Jessica Anne Bogart | en_US-lessac-medium |
+| frame-expert | Visual Designer | Matthew Schmitz | en_GB-alan-medium |
+| bmad-master | BMAD Master | Michael | en_US-danny-low |
 
 ## Implementation Details
 

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

@@ -0,0 +1,68 @@
+---
+description: 'Configure automatic TTS translation to speak in your preferred language'
+---
+
+# /agent-vibes:translate - Multi-Language TTS Translation
+
+Configure AgentVibes to automatically translate English TTS text to your preferred language before speaking.
+
+**Usage:**
+- `/agent-vibes:translate` - Show current translation settings
+- `/agent-vibes:translate set <language>` - Set translation language
+- `/agent-vibes:translate auto` - Use BMAD communication_language setting
+- `/agent-vibes:translate off` - Disable translation (speak English)
+- `/agent-vibes:translate status` - Show detailed status
+
+**Arguments:** $ARGUMENTS
+
+## How It Works
+
+When translation is enabled, AgentVibes will:
+1. Take the English TTS text
+2. Translate it to your target language using Google Translate
+3. Speak the translated text using a language-appropriate voice
+
+## Priority Order
+
+1. **Manual override** (`/agent-vibes:translate set spanish`) - Highest priority
+2. **BMAD config** (`communication_language` in `.bmad/core/config.yaml`) - Auto-detected
+3. **Default** - No translation (English)
+
+## Supported Languages
+
+Spanish, French, German, Italian, Portuguese, Chinese, Japanese, Korean, Russian, Polish, Dutch, Turkish, Arabic, Hindi, Swedish, Danish, Norwegian, Finnish, Czech, Romanian, Ukrainian, Greek, Bulgarian, Croatian, Slovak
+
+## Examples
+
+```bash
+# Translate all TTS to Spanish
+/agent-vibes:translate set spanish
+
+# Use BMAD's communication_language setting
+/agent-vibes:translate auto
+
+# Disable translation (speak English)
+/agent-vibes:translate off
+
+# Check current settings
+/agent-vibes:translate status
+```
+
+## Integration with BMAD
+
+If you have BMAD installed with a `communication_language` setting:
+
+```yaml
+# .bmad/core/config.yaml
+communication_language: Spanish
+```
+
+AgentVibes will automatically detect this and translate TTS to Spanish when you run `/agent-vibes:translate auto`.
+
+---
+
+Execute the translate-manager.sh script:
+
+```bash
+.claude/hooks/translate-manager.sh $ARGUMENTS
+```

package/.claude/hooks/learn-manager.sh

@@ -34,10 +34,19 @@
 # @patterns Dual-voice orchestration, auto-configuration, greeting on activation, provider-aware voice selection
 # @related language-manager.sh, play-tts.sh, .claude/tts-learn-mode.txt, .claude/tts-target-language.txt
 
-set -e
+# Only set strict mode when executed directly, not when sourced
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    set -e
+fi
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_DIR="$SCRIPT_DIR/../.."
+
+# Use PWD for project dir when called from project context, fall back to script-relative
+if [[ -d "$PWD/.claude" ]]; then
+    PROJECT_DIR="$PWD"
+else
+    PROJECT_DIR="$SCRIPT_DIR/../.."
+fi
 
 # Configuration files (project-local first, then global fallback)
 MAIN_LANG_FILE="$PROJECT_DIR/.claude/tts-main-language.txt"
@@ -430,7 +439,8 @@ show_status() {
     echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
 }
 
-# Main command handler
+# Main command handler - only run if script is executed directly, not sourced
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
 case "${1:-}" in
     get-main-language)
         get_main_language
@@ -473,3 +483,4 @@ case "${1:-}" in
         exit 1
         ;;
 esac
+fi

package/.claude/hooks/play-tts-elevenlabs.sh

@@ -198,8 +198,10 @@ TEMP_FILE="$AUDIO_DIR/tts-$(date +%s).mp3"
 # @sideeffects Creates MP3 file in audio directory
 # @edgecases Handles network failures, API errors, rate limiting
 # Choose model based on language
+# Note: eleven_monolingual_v1 deprecated for free tier as of Nov 2025
+# Using eleven_turbo_v2_5 for English (fast, high quality, free tier compatible)
 if [[ "$LANGUAGE_CODE" == "en" ]]; then
-  MODEL_ID="eleven_monolingual_v1"
+  MODEL_ID="eleven_turbo_v2_5"
 else
   MODEL_ID="eleven_multilingual_v2"
 fi

package/.claude/hooks/play-tts.sh

@@ -31,13 +31,13 @@
 #
 # ---
 #
-# @fileoverview TTS Provider Router with Language Learning Support
-# @context Routes TTS requests to active provider (ElevenLabs or Piper)
-# @architecture Provider abstraction layer - single entry point for all TTS
-# @dependencies provider-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh, github-star-reminder.sh
+# @fileoverview TTS Provider Router with Translation and Language Learning Support
+# @context Routes TTS requests to active provider (ElevenLabs or Piper) with optional translation
+# @architecture Provider abstraction layer - single entry point for all TTS, handles translation and learning mode
+# @dependencies provider-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh, translator.py, translate-manager.sh, learn-manager.sh
 # @entrypoints Called by hooks, slash commands, personality-manager.sh, and all TTS features
 # @patterns Provider pattern - delegates to provider-specific implementations, auto-detects provider from voice name
-# @related provider-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh, learn-manager.sh
+# @related provider-manager.sh, play-tts-elevenlabs.sh, play-tts-piper.sh, learn-manager.sh, translate-manager.sh
 #
 
 # Fix locale warnings
@@ -98,10 +98,133 @@ if [[ -n "$VOICE_OVERRIDE" ]]; then
   fi
 fi
 
+# @function speak_text
+# @intent Route text to appropriate TTS provider
+# @why Reusable function for speaking, used by both single and learning modes
+# @param $1 text to speak
+# @param $2 voice override (optional)
+# @param $3 provider override (optional)
+speak_text() {
+  local text="$1"
+  local voice="${2:-}"
+  local provider="${3:-$ACTIVE_PROVIDER}"
+
+  case "$provider" in
+    elevenlabs)
+      "$SCRIPT_DIR/play-tts-elevenlabs.sh" "$text" "$voice"
+      ;;
+    piper)
+      "$SCRIPT_DIR/play-tts-piper.sh" "$text" "$voice"
+      ;;
+    *)
+      echo "❌ Unknown provider: $provider" >&2
+      return 1
+      ;;
+  esac
+}
+
+# Note: learn-manager.sh and translate-manager.sh are sourced inside their
+# respective handler functions to avoid triggering their main handlers
+
+# @function handle_learning_mode
+# @intent Speak in both main language and target language for learning
+# @why Issue #51 - Auto-translate and speak twice for immersive language learning
+# @returns 0 if learning mode handled, 1 if not in learning mode
+handle_learning_mode() {
+  # Source learn-manager for learning mode functions
+  source "$SCRIPT_DIR/learn-manager.sh" 2>/dev/null || return 1
+
+  # Check if learning mode is enabled
+  if ! is_learn_mode_enabled 2>/dev/null; then
+    return 1
+  fi
+
+  local target_lang
+  target_lang=$(get_target_language 2>/dev/null || echo "")
+  local target_voice
+  target_voice=$(get_target_voice 2>/dev/null || echo "")
+
+  # Need both target language and voice for learning mode
+  if [[ -z "$target_lang" ]] || [[ -z "$target_voice" ]]; then
+    return 1
+  fi
+
+  # 1. Speak in main language (current voice)
+  speak_text "$TEXT" "$VOICE_OVERRIDE" "$ACTIVE_PROVIDER"
+
+  # 2. Auto-translate to target language
+  local translated
+  translated=$(python3 "$SCRIPT_DIR/translator.py" "$TEXT" "$target_lang" 2>/dev/null) || translated="$TEXT"
+
+  # Small pause between languages
+  sleep 0.5
+
+  # 3. Speak translated text with target voice
+  local target_provider
+  target_provider=$(detect_voice_provider "$target_voice")
+  speak_text "$translated" "$target_voice" "$target_provider"
+
+  return 0
+}
+
+# @function handle_translation_mode
+# @intent Translate and speak in target language (non-learning mode)
+# @why Issue #50 - BMAD multi-language TTS support
+# @returns 0 if translation handled, 1 if not translating
+handle_translation_mode() {
+  # Source translate-manager to get translation settings
+  source "$SCRIPT_DIR/translate-manager.sh" 2>/dev/null || return 1
+
+  # Check if translation is enabled
+  if ! is_translation_enabled 2>/dev/null; then
+    return 1
+  fi
+
+  local translate_to
+  translate_to=$(get_translate_to 2>/dev/null || echo "")
+
+  if [[ -z "$translate_to" ]] || [[ "$translate_to" == "english" ]]; then
+    return 1
+  fi
+
+  # Translate text
+  local translated
+  translated=$(python3 "$SCRIPT_DIR/translator.py" "$TEXT" "$translate_to" 2>/dev/null) || translated="$TEXT"
+
+  # Get voice for target language if no override specified
+  local voice_to_use="$VOICE_OVERRIDE"
+  if [[ -z "$voice_to_use" ]]; then
+    source "$SCRIPT_DIR/language-manager.sh" 2>/dev/null || true
+    voice_to_use=$(get_voice_for_language "$translate_to" "$ACTIVE_PROVIDER" 2>/dev/null || echo "")
+  fi
+
+  # Update provider if voice indicates different provider
+  local provider_to_use="$ACTIVE_PROVIDER"
+  if [[ -n "$voice_to_use" ]]; then
+    provider_to_use=$(detect_voice_provider "$voice_to_use")
+  fi
+
+  # Speak translated text
+  speak_text "$translated" "$voice_to_use" "$provider_to_use"
+  return 0
+}
+
+# Mode priority:
+# 1. Learning mode (speaks twice: main + translated)
+# 2. Translation mode (speaks translated only)
+# 3. Normal mode (speaks as-is)
+
+# Try learning mode first (Issue #51)
+if handle_learning_mode; then
+  exit 0
+fi
+
+# Try translation mode (Issue #50)
+if handle_translation_mode; then
+  exit 0
+fi
+
 # Normal single-language mode - route to appropriate provider implementation
-# Note: For learning mode, the output style will call this script TWICE:
-# 1. First call with main language text and current voice
-# 2. Second call with translated text and target voice
 case "$ACTIVE_PROVIDER" in
   elevenlabs)
     exec "$SCRIPT_DIR/play-tts-elevenlabs.sh" "$TEXT" "$VOICE_OVERRIDE"

package/.claude/hooks/provider-manager.sh

@@ -141,31 +141,120 @@ set_active_provider() {
     voice_file="$HOME/.claude/tts-voice.txt"
   fi
 
-  # Set default voice for the new provider
-  local default_voice
-  case "$provider" in
-    piper)
-      # Default Piper voice
-      default_voice="en_US-lessac-medium"
-      ;;
-    elevenlabs)
-      # Default ElevenLabs voice (first in alphabetical order from voices-config.sh)
-      default_voice="Amy"
-      ;;
-    *)
-      # Unknown provider - remove voice file
-      if [[ -f "$voice_file" ]]; then
-        rm -f "$voice_file"
-      fi
-      echo "✓ Active provider set to: $provider (voice reset)"
-      return 0
-      ;;
-  esac
+  # Migrate voice to equivalent in new provider
+  local current_voice=""
+  if [[ -f "$voice_file" ]]; then
+    # Strip only leading/trailing whitespace and newlines, preserve internal spaces
+    current_voice=$(cat "$voice_file" | tr -d '\n\r' | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
+  fi
+
+  local new_voice
+  new_voice=$(migrate_voice_to_provider "$current_voice" "$provider")
+
+  # Write new voice to file
+  echo "$new_voice" > "$voice_file"
 
-  # Write default voice to file
-  echo "$default_voice" > "$voice_file"
+  if [[ -n "$current_voice" ]] && [[ "$current_voice" != "$new_voice" ]]; then
+    echo "✓ Active provider set to: $provider"
+    echo "🔄 Voice migrated: $current_voice → $new_voice"
+  else
+    echo "✓ Active provider set to: $provider (voice: $new_voice)"
+  fi
+}
+
+# @function migrate_voice_to_provider
+# @intent Migrate a voice from one provider to an equivalent in the target provider
+# @why Users shouldn't have to manually reconfigure voices when switching providers
+# @param $1 {string} current_voice - Current voice name (may be from any provider)
+# @param $2 {string} target_provider - Target provider to migrate to
+# @returns Echoes equivalent voice name for target provider
+# @exitcode 0=always succeeds (returns default if no mapping found)
+# @sideeffects None
+# @edgecases Returns provider default if voice not found in mapping table
+migrate_voice_to_provider() {
+  local current_voice="$1"
+  local target_provider="$2"
+
+  # Voice mapping table: ElevenLabs <-> Piper equivalents
+  # Format: "elevenlabs_voice:piper_voice"
+  local voice_mappings=(
+    "Amy:en_US-amy-medium"
+    "Aria:en_US-amy-medium"
+    "Matthew Schmitz:en_US-ryan-high"
+    "Michael:en_GB-alan-medium"
+    "Jessica Anne Bogart:en_US-kristin-medium"
+    "Ms. Walker:en_US-lessac-medium"
+    "Cowboy Bob:en_US-joe-medium"
+    "Ralf Eisend:en_US-arctic-medium"
+    "Northern Terry:en_GB-alan-medium"
+    "Lutz Laugh:en_US-joe-medium"
+    "Dr. Von Fusion:en_US-danny-low"
+    "Demon Monster:en_US-danny-low"
+    "Drill Sergeant:en_US-ryan-high"
+    "Grandpa Spuds Oxley:en_US-joe-medium"
+  )
+
+  # Default voices by provider
+  local elevenlabs_default="Amy"
+  local piper_default="en_US-lessac-medium"
+
+  # If no current voice, return default for target provider
+  if [[ -z "$current_voice" ]]; then
+    case "$target_provider" in
+      piper) echo "$piper_default" ;;
+      elevenlabs) echo "$elevenlabs_default" ;;
+      *) echo "$piper_default" ;;
+    esac
+    return 0
+  fi
 
-  echo "✓ Active provider set to: $provider (voice set to: $default_voice)"
+  # Convert to lowercase for case-insensitive comparison (portable)
+  local current_voice_lower
+  current_voice_lower=$(echo "$current_voice" | tr '[:upper:]' '[:lower:]')
+
+  # Search for mapping
+  for mapping in "${voice_mappings[@]}"; do
+    local el_voice="${mapping%%:*}"
+    local piper_voice="${mapping#*:}"
+    local el_voice_lower
+    local piper_voice_lower
+    el_voice_lower=$(echo "$el_voice" | tr '[:upper:]' '[:lower:]')
+    piper_voice_lower=$(echo "$piper_voice" | tr '[:upper:]' '[:lower:]')
+
+    case "$target_provider" in
+      piper)
+        # Switching to Piper: look for ElevenLabs voice match
+        if [[ "$current_voice_lower" == "$el_voice_lower" ]]; then
+          echo "$piper_voice"
+          return 0
+        fi
+        # Already a Piper voice? Keep it if valid format
+        if [[ "$current_voice" =~ ^en_ ]]; then
+          echo "$current_voice"
+          return 0
+        fi
+        ;;
+      elevenlabs)
+        # Switching to ElevenLabs: look for Piper voice match
+        if [[ "$current_voice_lower" == "$piper_voice_lower" ]]; then
+          echo "$el_voice"
+          return 0
+        fi
+        # Already an ElevenLabs voice? Keep it
+        if [[ ! "$current_voice" =~ ^en_ ]]; then
+          echo "$current_voice"
+          return 0
+        fi
+        ;;
+    esac
+  done
+
+  # No mapping found - return default for target provider
+  case "$target_provider" in
+    piper) echo "$piper_default" ;;
+    elevenlabs) echo "$elevenlabs_default" ;;
+    *) echo "$piper_default" ;;
+  esac
 }
 
 # @function list_providers

package/.claude/hooks/requirements.txt

@@ -0,0 +1,6 @@
+# AgentVibes TTS Hooks Requirements
+# Install with: pip install -r requirements.txt
+
+# Translation support for multi-language TTS and learning mode
+deep-translator>=1.11.4
+langdetect>=1.0.9