agentvibes 2.17.6 → 2.17.7

package/.claude/github-star-reminder.txt

@@ -1 +1 @@
-20251215
+20251218

package/.claude/hooks/bmad-speak-enhanced.sh

@@ -110,8 +110,8 @@ AGENT_FOR_EFFECTS="${DISPLAY_NAME:-$AGENT_NAME_OR_ID}"
 AGENT_VOICE=""
 AGENT_INTRO=""
 if [[ -n "$AGENT_ID" ]] && [[ -f "$SCRIPT_DIR/bmad-voice-manager.sh" ]]; then
-    AGENT_VOICE=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$AGENT_ID" 2>/dev/null || echo "")
-    AGENT_INTRO=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-intro "$AGENT_ID" 2>/dev/null || echo "")
+    AGENT_VOICE=$(cd "$PROJECT_ROOT" && "$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$AGENT_ID" 2>/dev/null || echo "")
+    AGENT_INTRO=$(cd "$PROJECT_ROOT" && "$SCRIPT_DIR/bmad-voice-manager.sh" get-intro "$AGENT_ID" 2>/dev/null || echo "")
 fi
 
 # Prepend intro text if configured

package/.claude/hooks/bmad-speak.sh

@@ -90,8 +90,8 @@ AGENT_ID=$(map_to_agent_id "$AGENT_NAME_OR_ID")
 AGENT_VOICE=""
 AGENT_INTRO=""
 if [[ -n "$AGENT_ID" ]] && [[ -f "$SCRIPT_DIR/bmad-voice-manager.sh" ]]; then
-  AGENT_VOICE=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$AGENT_ID" 2>/dev/null)
-  AGENT_INTRO=$("$SCRIPT_DIR/bmad-voice-manager.sh" get-intro "$AGENT_ID" 2>/dev/null)
+  AGENT_VOICE=$(cd "$PROJECT_ROOT" && "$SCRIPT_DIR/bmad-voice-manager.sh" get-voice "$AGENT_ID" 2>/dev/null)
+  AGENT_INTRO=$(cd "$PROJECT_ROOT" && "$SCRIPT_DIR/bmad-voice-manager.sh" get-intro "$AGENT_ID" 2>/dev/null)
 fi
 
 # Prepend intro text if configured (e.g., "John, Product Manager here. [dialogue]")

package/.claude/hooks/bmad-tts-injector.sh

@@ -247,18 +247,19 @@ inject_tts() {
     if [[ -n "$agent_voice" ]]; then
       tts_step="  <step n=\"4.5\" tts=\"agentvibes\">🎤 AGENTVIBES TTS INJECTION:
       - Create context: echo \"${agent_id}\" > .bmad-agent-context (Bash tool)
-      - Speak greeting: .claude/hooks/play-tts.sh \"Hello! I'm ready to help you.\" \"${agent_voice}\" (Bash tool)
+      - Speak greeting: bash .claude/hooks/play-tts.sh \"Hello! I'm ready to help you.\" \"${agent_voice}\" (Bash tool)
       - CRITICAL: Before EVERY response, scan for questions/prompts and speak them using Bash tool</step>"
     else
       tts_step="  <step n=\"4.5\" tts=\"agentvibes\">🎤 AGENTVIBES TTS INJECTION:
       - Create context: echo \"${agent_id}\" > .bmad-agent-context (Bash tool)
-      - Speak greeting: .claude/hooks/play-tts.sh \"Hello! I'm ready to help you.\" (Bash tool)
+      - Speak greeting: bash .claude/hooks/play-tts.sh \"Hello! I'm ready to help you.\" (Bash tool)
       - CRITICAL: Before EVERY response, scan for questions/prompts and speak them using Bash tool</step>"
     fi
 
-    # Insert after step 4 (greeting) - only first match
+    # Insert after step 4 - only first match
+    # Note: Greeting is in step 5, but we inject after step 4 for proper ordering
     awk -v tts="$tts_step" '
-      !done && /<step n="4">.*[Gg]reet/ {
+      !done && /<step n="4">/ {
         print
         print tts
         done=1
@@ -283,7 +284,7 @@ inject_tts() {
       # No changes - step 4 pattern didn't match
       rm "$agent_file.tmp"
       mv "$agent_file.backup-pre-tts" "$agent_file"
-      echo -e "${RED}❌ Could not find step 4 with greeting in: $(basename "$agent_file")${NC}"
+      echo -e "${RED}❌ Could not find step 4 in: $(basename "$agent_file")${NC}"
       return 1
     fi
 
@@ -293,12 +294,12 @@ inject_tts() {
     if [[ -n "$agent_voice" ]]; then
       activation_injection="  - # AGENTVIBES-TTS-INJECTION: STEP 3.5 - Announce activation with TTS
   - STEP 3.5a: Use Bash tool to create context file: echo \"${agent_id}\" > .bmad-agent-context
-  - STEP 3.5b: Use Bash tool to speak: .claude/hooks/play-tts.sh \"Agent ${agent_id} activated and ready\" \"${agent_voice}\"
+  - STEP 3.5b: Use Bash tool to speak: bash .claude/hooks/play-tts.sh \"Agent ${agent_id} activated and ready\" \"${agent_voice}\"
   - AGENTVIBES-TTS-INJECTION: Before every response, scan for questions and speak them using Bash tool"
     else
       activation_injection="  - # AGENTVIBES-TTS-INJECTION: STEP 3.5 - Announce activation with TTS
   - STEP 3.5a: Use Bash tool to create context file: echo \"${agent_id}\" > .bmad-agent-context
-  - STEP 3.5b: Use Bash tool to speak: .claude/hooks/play-tts.sh \"Agent ${agent_id} activated and ready\"
+  - STEP 3.5b: Use Bash tool to speak: bash .claude/hooks/play-tts.sh \"Agent ${agent_id} activated and ready\"
   - AGENTVIBES-TTS-INJECTION: Before every response, scan for questions and speak them using Bash tool"
     fi
 

package/.claude/hooks/session-start-tts.sh

@@ -1,11 +1,10 @@
 #!/usr/bin/env bash
+set -euo pipefail
 #
 # File: .claude/hooks/session-start-tts.sh
 #
-# AgentVibes SessionStart Hook - Injects TTS Protocol Instructions
-#
-# This hook outputs TTS protocol instructions to stdout, which Claude Code
-# adds to the conversation context at session start.
+# AgentVibes SessionStart Hook - Optimized (Issue #80, Phase 1)
+# Token target: ~250 (down from ~500)
 #
 
 # Fix locale warnings
@@ -24,50 +23,31 @@ fi
 SENTIMENT=$(cat .claude/tts-sentiment.txt 2>/dev/null || cat ~/.claude/tts-sentiment.txt 2>/dev/null || echo "")
 PERSONALITY=$(cat .claude/tts-personality.txt 2>/dev/null || cat ~/.claude/tts-personality.txt 2>/dev/null || echo "normal")
 
-# Determine which to use
+# Determine style
 if [[ -n "$SENTIMENT" ]]; then
-  STYLE_MODE="sentiment"
-  STYLE_NAME="$SENTIMENT"
+  STYLE="$SENTIMENT"
 else
-  STYLE_MODE="personality"
-  STYLE_NAME="$PERSONALITY"
+  STYLE="$PERSONALITY"
 fi
 
 # Get verbosity level (Issue #32)
 VERBOSITY=$(cat .claude/tts-verbosity.txt 2>/dev/null || cat ~/.claude/tts-verbosity.txt 2>/dev/null || echo "low")
 
-# Output TTS protocol instructions to stdout
-# Claude Code will add this to the conversation context
+# Output optimized TTS protocol
 cat <<'EOF'
 
 # AgentVibes TTS Protocol
 
 **CRITICAL: You MUST execute TTS at TWO points for EVERY user interaction:**
 
-## 1. ACKNOWLEDGMENT (Start of Every Task)
-Immediately after receiving ANY user message:
-1. Generate a brief, unique acknowledgment message
-2. Execute: `Bash: .claude/hooks/play-tts.sh "[your message]"`
-3. Then proceed with the work
-
-## 2. COMPLETION (End of Every Task)
-After finishing the task:
-1. Generate a brief, unique completion message
-2. Execute: `Bash: .claude/hooks/play-tts.sh "[your message]"`
-
-## Rules
-- Use Bash tool to execute play-tts.sh
-- Keep messages under 150 characters
-- Generate unique messages each time
-- Use relative path: .claude/hooks/play-tts.sh
-- This is NOT optional - follow for EVERY interaction
+1. **Acknowledgment** - Start of task: `Bash: .claude/hooks/play-tts.sh "[action]"`
+2. **Completion** - End of task: `Bash: .claude/hooks/play-tts.sh "[result + key details]"`
 
-## Example
+**Example:**
 ```
-User: "check git status"
-[Bash: .claude/hooks/play-tts.sh "I'll check that for you."]
-[... do work ...]
-[Bash: .claude/hooks/play-tts.sh "Done! All clean."]
+[Bash: .claude/hooks/play-tts.sh "Checking git status"]
+[work...]
+[Bash: .claude/hooks/play-tts.sh "Repository is clean, no changes"]
 ```
 
 EOF
@@ -76,66 +56,46 @@ EOF
 case "$VERBOSITY" in
   low)
     cat <<'EOF'
-## Verbosity: LOW (Minimal)
-- Speak only at acknowledgment (start) and completion (end)
-- Do NOT speak reasoning, decisions, or findings during work
-- Keep it quiet and focused
+## Verbosity: LOW
+- Acknowledgment: Action only
+- Completion: Result + errors only
+- Skip: Reasoning, decisions
 
 EOF
     ;;
 
   medium)
     cat <<'EOF'
-## Verbosity: MEDIUM (Balanced)
-- Speak at acknowledgment and completion (always)
-- Also speak major decisions and key findings during work
-- Use emoji markers for automatic TTS:
-  🤔 [decision text] - Major decisions (e.g., "🤔 I'll use grep to search all files")
-  ✓ [finding text] - Key findings (e.g., "✓ Found 12 instances at line 1323")
-
-Example:
-```
-User: "Find all TODO comments"
-[TTS: Acknowledgment]
-🤔 I'll use grep to search for TODO comments
-[Work happens...]
-✓ Found 12 TODO comments across 5 files
-[TTS: Completion]
-```
+## Verbosity: MEDIUM
+- Acknowledgment: Action + key approach
+- Completion: Result + important decisions
+- Include: Major choices only
 
 EOF
     ;;
 
   high)
     cat <<'EOF'
-## Verbosity: HIGH (Maximum Transparency)
-- Speak acknowledgment and completion (always)
-- Speak ALL reasoning, decisions, and findings as you work
-- Use emoji markers for automatic TTS:
-  💭 [reasoning text] - Thought process (e.g., "💭 Let me search for all instances")
-  🤔 [decision text] - Decisions (e.g., "🤔 I'll use grep for this")
-  ✓ [finding text] - Findings (e.g., "✓ Found it at line 1323")
-
-Example:
-```
-User: "Find all TODO comments"
-[TTS: Acknowledgment]
-💭 Let me search through the codebase for TODO comments
-🤔 I'll use the Grep tool with pattern "TODO"
-[Grep runs...]
-✓ Found 12 TODO comments across 5 files
-💭 Let me organize these results by file
-[Processing...]
-[TTS: Completion]
-```
-
-IMPORTANT: Use emoji markers naturally in your reasoning text. They trigger automatic TTS.
+## Verbosity: HIGH
+- Acknowledgment: Action + approach + why
+- Completion: Result + decisions + trade-offs
+- Include: Full reasoning, alternatives
 
 EOF
     ;;
 esac
 
-# Add current style and verbosity info
-echo "Current Style: ${STYLE_NAME} (${STYLE_MODE})"
-echo "Current Verbosity: ${VERBOSITY}"
-echo ""
+# Add style info and rules
+cat << EOF
+## Style: $STYLE
+
+## Rules
+1. Never skip acknowledgment TTS
+2. Never skip completion TTS
+3. Match verbosity level
+4. Keep under 150 chars
+5. Always include errors
+
+Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning
+
+EOF

package/README.md

@@ -11,7 +11,7 @@
 [![Publish](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml/badge.svg)](https://github.com/paulpreibisch/AgentVibes/actions/workflows/publish.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.17.5
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v2.17.7
 
 ---
 
@@ -114,15 +114,15 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
 
 ## 📰 Latest Release
 
-**[v2.17.5 - Installer UX Improvements](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.17.5)** ✨
+**[v2.17.7 - BMAD Party Mode Voice Fix](https://github.com/paulpreibisch/AgentVibes/releases/tag/v2.17.7)** 🎭
 
-AgentVibes v2.17.5 improves the installation experience with a complete installer UX overhaul. This release introduces intelligent page navigation with previews, beautiful two-column layouts for all summary screens, and optimized vertical spacing throughout.
+AgentVibes v2.17.7 fixes a critical bug preventing BMAD party mode agents from using their unique voices. All agents were incorrectly using the same default voice instead of their assigned voices (Mary/Kristin, John/Ryan, Winston/Alan, etc.). This release also includes 50% token optimization for the session-start TTS hook.
 
 **Key Highlights:**
-- 📱 **Page Navigation Previews** - See next/previous page titles in navigation menu (e.g., "Next → (Voice Selection)")
-- 🎨 **Beautiful Two-Column Layouts** - Slash commands, hooks, personalities, and music displayed in organized columns
-- ✨ **Emoji Page Titles** - Each configuration page has descriptive icons (🔧 System Dependencies, 🎤 Voice Selection, etc.)
-- 📏 **Optimized Spacing** - Eliminated excessive vertical spacing for cleaner, more compact display
+- 🎭 **Party Mode Voice Fix** - All BMAD agents now speak with their unique assigned voices
+- ⚡ **Token Optimization** - Session-start TTS hook reduced from ~500 to ~250 tokens (50% reduction)
+- 🎤 **Interactive TTS Prompt** - Installer automatically detects BMAD and offers voice injection
+- 🔧 **Hook Path Improvements** - Fixed TTS injector to use correct path resolution
 
 💡 **Tip:** If `npx agentvibes` shows an older version or missing commands, clear your npm cache: `npm cache clean --force && npx agentvibes@latest --help`
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "2.17.6",
+  "version": "2.17.7",
   "description": "Now your AI Agents can finally talk back! Professional TTS voice for Claude Code and Claude Desktop (via MCP) with multi-provider support.",
   "homepage": "https://agentvibes.org",
   "keywords": [

package/src/installer.js

@@ -823,17 +823,17 @@ function showWelcome() {
  * Shown during install and update commands
  */
 function getReleaseInfoBoxen() {
-  return chalk.cyan.bold('📦 AgentVibes v2.17.5 - Installer UX Improvements\n\n') +
+  return chalk.cyan.bold('📦 AgentVibes v2.17.7 - BMAD Party Mode Voice Fix\n\n') +
     chalk.green.bold('🎙️ WHAT\'S NEW:\n\n') +
-    chalk.cyan('AgentVibes v2.17.5 improves the installation experience with a complete installer\n') +
-    chalk.cyan('UX overhaul. This release introduces intelligent page navigation with previews,\n') +
-    chalk.cyan('beautiful two-column layouts for all summary screens, and optimized vertical\n') +
-    chalk.cyan('spacing throughout.\n\n') +
+    chalk.cyan('AgentVibes v2.17.7 fixes a critical bug preventing BMAD party mode agents from\n') +
+    chalk.cyan('using their unique voices. All agents were incorrectly using the same default voice\n') +
+    chalk.cyan('instead of their assigned voices (Mary/Kristin, John/Ryan, Winston/Alan, etc.).\n') +
+    chalk.cyan('This release also includes 50% token optimization for session-start hook.\n\n') +
     chalk.green.bold('✨ KEY HIGHLIGHTS:\n\n') +
-    chalk.gray('   📱 Page Navigation Previews - See next/previous page titles in navigation menu\n') +
-    chalk.gray('   🎨 Beautiful Two-Column Layouts - Commands, hooks, personalities displayed in organized columns\n') +
-    chalk.gray('   ✨ Emoji Page Titles - Descriptive icons for each configuration page\n') +
-    chalk.gray('   📏 Optimized Spacing - Eliminated excessive vertical spacing for cleaner display\n\n') +
+    chalk.gray('   🎭 Party Mode Voice Fix - All BMAD agents now speak with unique assigned voices\n') +
+    chalk.gray('   ⚡ Token Optimization - Session-start TTS hook reduced from ~500 to ~250 tokens\n') +
+    chalk.gray('   🎤 Interactive TTS Prompt - Installer detects BMAD and offers voice injection\n') +
+    chalk.gray('   🔧 Hook Path Improvements - Fixed TTS injector path resolution\n\n') +
     chalk.gray('📖 Full Release Notes: RELEASE_NOTES.md\n') +
     chalk.gray('🌐 Website: https://agentvibes.org\n') +
     chalk.gray('📦 Repository: https://github.com/paulpreibisch/AgentVibes\n\n') +
@@ -2444,9 +2444,10 @@ async function detectAndMigrateOldConfig(targetDir, spinner) {
 /**
  * Handle BMAD integration (detection and TTS injection)
  * @param {string} targetDir - Target installation directory
+ * @param {Object} options - Installation options (e.g., yes flag for non-interactive)
  * @returns {Promise<Object>} BMAD detection result
  */
-async function handleBmadIntegration(targetDir) {
+async function handleBmadIntegration(targetDir, options = {}) {
   const bmadDetection = await detectBMAD(targetDir);
   const bmadDetected = bmadDetection.installed;
 
@@ -2485,6 +2486,55 @@ async function handleBmadIntegration(targetDir) {
   // Create default voice assignments if they don't exist
   await createDefaultBmadVoiceAssignmentsProactive(targetDir);
 
+  // Prompt user to inject TTS into BMAD agents (or auto-inject with --yes flag)
+  let enableTtsInjection = options.yes; // Auto-enable with --yes flag
+
+  if (!options.yes) {
+    console.log(''); // Add spacing
+    console.log(chalk.cyan.bold('🎤 AgentVibes TTS Integration for BMAD Agents\n'));
+    console.log(chalk.white('AgentVibes can inject Text-to-Speech into your BMAD agents'));
+    console.log(chalk.white('so each agent speaks with their own unique voice!\n'));
+    console.log(chalk.gray('What this does:'));
+    console.log(chalk.gray('  • Modifies agent activation instructions to include TTS'));
+    console.log(chalk.gray('  • Each agent gets a unique voice (e.g., Mary, John, Winston)'));
+    console.log(chalk.gray('  • Agents will speak when activated and during responses'));
+    console.log(chalk.gray('  • Creates backups before making any changes\n'));
+    console.log(chalk.cyan('Agents that will get unique voices:'));
+    console.log(chalk.gray('  • Mary (analyst) → Female voice'));
+    console.log(chalk.gray('  • John (pm) → Male voice'));
+    console.log(chalk.gray('  • Winston (architect) → British voice'));
+    console.log(chalk.gray('  • And 6+ more agents...\n'));
+    console.log(chalk.yellow('You can disable this later with:'));
+    console.log(chalk.gray('  .claude/hooks/bmad-tts-injector.sh disable\n'));
+
+    const { enableTts } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'enableTts',
+      message: chalk.yellow('Enable TTS for BMAD agents?'),
+      default: true
+    }]);
+
+    enableTtsInjection = enableTts;
+  }
+
+  if (enableTtsInjection) {
+    const injectorScript = path.join(claudeDir, 'hooks', 'bmad-tts-injector.sh');
+    try {
+      // Run bmad-tts-injector.sh enable
+      execSync(`bash "${injectorScript}" enable`, {
+        cwd: targetDir,
+        stdio: 'inherit'
+      });
+      console.log(chalk.green('✅ TTS injection completed successfully'));
+    } catch (error) {
+      console.log(chalk.yellow('⚠️  TTS injection encountered issues'));
+      console.log(chalk.gray('   You can retry manually with: .claude/hooks/bmad-tts-injector.sh enable'));
+    }
+  } else {
+    console.log(chalk.gray('   Skipped TTS injection. You can enable it later with:'));
+    console.log(chalk.gray('   .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;
@@ -3185,7 +3235,7 @@ async function install(options = {}) {
     await createDefaultBmadVoiceAssignmentsProactive(targetDir);
 
     // Handle BMAD integration
-    const bmadDetection = await handleBmadIntegration(targetDir);
+    const bmadDetection = await handleBmadIntegration(targetDir, options);
     const bmadDetected = bmadDetection.installed;
 
     if (bmadDetected) {

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

@@ -1,272 +0,0 @@
-#!/usr/bin/env bash
-#
-# File: .claude/hooks/play-tts.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 TTS Provider Router with Translation and Language Learning Support
-# @context Routes TTS requests to active provider (Piper or macOS) with optional translation
-# @architecture Provider abstraction layer - single entry point for all TTS, handles translation and learning mode
-# @dependencies provider-manager.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-piper.sh, learn-manager.sh, translate-manager.sh
-#
-
-# Fix locale warnings
-export LC_ALL=C
-
-# Get script directory (needed for mute file check)
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-
-# Check if muted (persists across sessions)
-# Project settings always override global settings:
-# - .claude/agentvibes-unmuted = project explicitly unmuted (overrides global mute)
-# - .claude/agentvibes-muted = project muted (overrides global unmute)
-# - ~/.agentvibes-muted = global mute (only if no project-level setting)
-GLOBAL_MUTE_FILE="$HOME/.agentvibes-muted"
-PROJECT_MUTE_FILE="$PROJECT_ROOT/.claude/agentvibes-muted"
-PROJECT_UNMUTE_FILE="$PROJECT_ROOT/.claude/agentvibes-unmuted"
-
-# Check project-level settings first (project overrides global)
-if [[ -f "$PROJECT_UNMUTE_FILE" ]]; then
-  # Project explicitly unmuted - ignore global mute
-  :  # Continue (do nothing, will not exit)
-elif [[ -f "$PROJECT_MUTE_FILE" ]]; then
-  # Project explicitly muted
-  if [[ -f "$GLOBAL_MUTE_FILE" ]]; then
-    echo "🔇 TTS muted (project + global)"
-  else
-    echo "🔇 TTS muted (project)"
-  fi
-  exit 0
-elif [[ -f "$GLOBAL_MUTE_FILE" ]]; then
-  # Global mute and no project-level override
-  echo "🔇 TTS muted (global)"
-  exit 0
-fi
-
-TEXT="$1"
-VOICE_OVERRIDE="$2"  # Optional: voice name or ID
-
-# Security: Validate inputs
-if [[ -z "$TEXT" ]]; then
-  echo "Error: No text provided" >&2
-  exit 1
-fi
-
-# Security: Validate voice override doesn't contain dangerous characters
-if [[ -n "$VOICE_OVERRIDE" ]] && [[ "$VOICE_OVERRIDE" =~ [';|&$`<>(){}'] ]]; then
-  echo "Error: Invalid characters in voice parameter" >&2
-  exit 1
-fi
-
-# Remove backslash escaping that Claude might add for special chars
-# In single quotes these don't need escaping, but Claude sometimes adds backslashes
-TEXT="${TEXT//\\!/!}"        # Remove \!
-TEXT="${TEXT//\\\$/\$}"      # Remove \$
-TEXT="${TEXT//\\?/?}"        # Remove \?
-TEXT="${TEXT//\\,/,}"        # Remove \,
-TEXT="${TEXT//\\./.}"        # Remove \. (keep the period)
-TEXT="${TEXT//\\\\/\\}"      # Remove \\ (escaped backslash)
-
-# Source provider manager to get active provider
-source "$SCRIPT_DIR/provider-manager.sh"
-
-# Get active provider
-ACTIVE_PROVIDER=$(get_active_provider)
-
-# Show GitHub star reminder (once per day)
-"$SCRIPT_DIR/github-star-reminder.sh" 2>/dev/null || true
-
-# @function detect_voice_provider
-# @intent Auto-detect provider from voice name (for mixed-provider support)
-# @why Allow Piper for main language + macOS for target language
-# @param $1 voice name/ID
-# @returns Provider name (piper or macos)
-detect_voice_provider() {
-  local voice="$1"
-  # Piper voice names contain underscore and dash (e.g., es_ES-davefx-medium)
-  if [[ "$voice" == *"_"*"-"* ]]; then
-    echo "piper"
-  else
-    echo "$ACTIVE_PROVIDER"
-  fi
-}
-
-# Override provider if voice indicates different provider (mixed-provider mode)
-if [[ -n "$VOICE_OVERRIDE" ]]; then
-  DETECTED_PROVIDER=$(detect_voice_provider "$VOICE_OVERRIDE")
-  if [[ "$DETECTED_PROVIDER" != "$ACTIVE_PROVIDER" ]]; then
-    ACTIVE_PROVIDER="$DETECTED_PROVIDER"
-  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
-    piper)
-      "$SCRIPT_DIR/play-tts-piper.sh" "$text" "$voice"
-      ;;
-    macos)
-      "$SCRIPT_DIR/play-tts-macos.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
-case "$ACTIVE_PROVIDER" in
-  piper)
-    exec "$SCRIPT_DIR/play-tts-piper.sh" "$TEXT" "$VOICE_OVERRIDE"
-    ;;
-  macos)
-    exec "$SCRIPT_DIR/play-tts-macos.sh" "$TEXT" "$VOICE_OVERRIDE"
-    ;;
-  *)
-    echo "❌ Unknown provider: $ACTIVE_PROVIDER"
-    echo "   Run: /agent-vibes:provider list"
-    exit 1
-    ;;
-esac