agentvibes 4.5.0 → 4.6.0

package/.claude/config/audio-effects.cfg

@@ -1,3 +1,4 @@
+bmad-agent-tech-writer||agent_vibes_arabic_v2_loop.mp3|0.70
 # AgentVibes Audio Effects Configuration|||
 # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|BACKGROUND_VOLUME
 #|||

package/.claude/config/background-music-enabled.txt

@@ -0,0 +1 @@
+true

package/.claude/hooks/audio-processor.sh

@@ -343,7 +343,7 @@ main() {
             if [[ "$_prof_vol" =~ ^[0-9]+$ ]]; then
                 bg_volume=$(awk "BEGIN{printf \"%.2f\", ${_prof_vol}/100}")
             else
-                bg_volume="0.70"
+                bg_volume="0.20"
             fi
         fi
     fi

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

@@ -0,0 +1,175 @@
+#!/usr/bin/env bash
+#
+# File: ~/.claude/hooks/bmad-party-speak.sh
+#
+# AgentVibes PostToolUse Hook - BMAD Party Mode TTS (Linux / macOS / WSL)
+#
+# Fires after every Agent tool call. Detects BMAD party mode agents by
+# fingerprinting the prompt, extracts the agent display name, maps it to
+# the canonical agent ID via the manifest, then calls bmad-speak.sh.
+# Uses flock for cross-process audio serialization (no overlapping speech).
+#
+# Installed globally so it works in any BMAD project.
+# Uses CLAUDE_PROJECT_DIR env var to locate the project manifest at runtime.
+#
+# Input: JSON on stdin (Claude Code PostToolUse payload)
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LOCK_FILE="/tmp/agentvibes-party-queue.lock"
+
+# --- Read stdin ---
+raw="$(cat)"
+[[ -z "$raw" ]] && exit 0
+
+# --- Parse all needed fields in one python3 call (fixes M5: 3x subprocess, echo safety) ---
+# Outputs: TOOL_NAME|DISPLAY_NAME|RESPONSE_TEXT (newlines in response encoded as \n literals)
+parsed="$(printf '%s' "$raw" | python3 - <<'PYEOF'
+import sys, json, re
+
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    print("|||")
+    sys.exit(0)
+
+tool_name = d.get('tool_name', '')
+prompt = d.get('tool_input', {}).get('prompt', '')
+
+# Extract display name — safe alternative to grep -oP (fixes C2: macOS BSD grep no -P)
+display_name = ''
+m = re.search(r'You are ([A-Za-z]+)\s*\(', prompt)
+if m:
+    display_name = m.group(1)
+
+# Extract response text
+response_text = ''
+for item in d.get('tool_response', {}).get('content', []):
+    if item.get('type') == 'text':
+        response_text = item['text']
+        break
+
+# Strip leading icon + bold name header (e.g. "📊 **Mary:** " or garbled prefix)
+response_text = response_text.strip()
+response_text = re.sub(r'^\S*\s*\*\*[^:]+:\*\*\s*', '', response_text).strip()
+
+# Encode newlines so we can pass multi-line text through a single shell variable (fixes m3)
+response_text = response_text.replace('\n', '\\n')
+
+print(f"{tool_name}|{display_name}|{response_text}")
+PYEOF
+)" 2>/dev/null || true
+
+[[ -z "$parsed" ]] && exit 0
+
+tool_name="${parsed%%|*}"
+rest="${parsed#*|}"
+display_name="${rest%%|*}"
+response_text="${rest#*|}"
+
+# Decode \n back to newlines for TTS
+response_text="${response_text//\\n/ }"
+
+# --- Only handle Agent tool ---
+[[ "$tool_name" != "Agent" ]] && exit 0
+
+# --- Fingerprint: only fire for BMAD party mode agents (safe string match, no pipe) ---
+[[ "$raw" == *"BMAD agent in a collaborative roundtable"* ]] || exit 0
+
+[[ -z "$display_name" ]] && exit 0
+[[ -z "$response_text" ]] && exit 0
+
+# --- Resolve project root ---
+project_root="${CLAUDE_PROJECT_DIR:-}"
+
+# --- Find bmad-speak.sh (prefer project-local, fall back to global) ---
+bmad_speak=""
+if [[ -n "$project_root" && -f "$project_root/.claude/hooks/bmad-speak.sh" ]]; then
+    bmad_speak="$project_root/.claude/hooks/bmad-speak.sh"
+elif [[ -f "$SCRIPT_DIR/bmad-speak.sh" ]]; then
+    bmad_speak="$SCRIPT_DIR/bmad-speak.sh"
+fi
+[[ -z "$bmad_speak" ]] && exit 0
+
+# --- Look up canonical agent ID from project manifest via python3 (fixes M4: awk CSV comma) ---
+agent_id="$display_name"  # fallback
+if [[ -n "$project_root" && -f "$project_root/_bmad/_config/agent-manifest.csv" ]]; then
+    manifest="$project_root/_bmad/_config/agent-manifest.csv"
+    matched="$(python3 - "$manifest" "$display_name" <<'PYEOF'
+import sys, csv
+manifest_path, target = sys.argv[1], sys.argv[2].lower()
+try:
+    with open(manifest_path, newline='', encoding='utf-8') as f:
+        for row in csv.DictReader(f):
+            if row.get('displayName', '').lower() == target:
+                print(row.get('name', ''))
+                break
+except Exception:
+    pass
+PYEOF
+)" 2>/dev/null || true
+    [[ -n "$matched" ]] && agent_id="$matched"
+fi
+
+# --- Apply verbosity truncation ---
+verbosity="medium"
+# Guard project_root empty to avoid /.claude/... path (fixes M1)
+if [[ -n "$project_root" && -f "$project_root/.claude/tts-verbosity.txt" ]]; then
+    v="$(tr -d '[:space:]' < "$project_root/.claude/tts-verbosity.txt")"
+    [[ -n "$v" ]] && verbosity="$v"
+elif [[ -f "$HOME/.claude/tts-verbosity.txt" ]]; then
+    v="$(tr -d '[:space:]' < "$HOME/.claude/tts-verbosity.txt")"
+    [[ -n "$v" ]] && verbosity="$v"
+fi
+
+case "$verbosity" in
+    low)
+        # First sentence — fall back to full text if no punctuation (fixes m1)
+        first="$(printf '%s' "$response_text" | python3 -c "
+import sys, re
+t = sys.stdin.read()
+m = re.match(r'^.*?[.!?]', t)
+print(m.group(0) if m else t)
+" 2>/dev/null || printf '%s' "$response_text")"
+        [[ -n "$first" ]] && response_text="$first"
+        ;;
+    medium)
+        # First 2 sentences — fall back to full text if no punctuation (fixes m1)
+        two="$(printf '%s' "$response_text" | python3 -c "
+import sys, re
+t = sys.stdin.read()
+parts = re.findall(r'.*?[.!?]', t)
+print(' '.join(parts[:2]) if parts else t)
+" 2>/dev/null || printf '%s' "$response_text")"
+        [[ -n "$two" ]] && response_text="$two"
+        ;;
+    # high = full text
+esac
+
+[[ -z "$response_text" ]] && exit 0
+
+# --- Acquire queue lock (flock: cross-process, auto-releases on crash) ---
+exec 9>"$LOCK_FILE"
+if command -v flock &>/dev/null; then
+    flock -w 60 9
+    "$bmad_speak" "$agent_id" "$response_text" || true
+    flock -u 9
+else
+    # macOS fallback: atomic mkdir polling lock
+    LOCK_DIR="/tmp/agentvibes-party-queue.lock.d"
+    # Register trap BEFORE acquiring lock so SIGTERM can't orphan it (fixes M3)
+    trap 'rmdir "$LOCK_DIR" 2>/dev/null || true' EXIT
+    WAITED=0
+    while ! mkdir "$LOCK_DIR" 2>/dev/null; do
+        sleep 0.5
+        WAITED=$((WAITED + 1))
+        if [[ $WAITED -ge 120 ]]; then
+            echo "[AgentVibes] Party mode TTS queue timeout for agent: $agent_id" >&2
+            exit 0
+        fi
+    done
+    "$bmad_speak" "$agent_id" "$response_text" || true
+    rmdir "$LOCK_DIR" 2>/dev/null || true
+fi

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

@@ -177,6 +177,20 @@ if [[ -n "$AGENT_ID" ]] && [[ -f "$VOICE_MAP_FILE" ]]; then
   IFS='|' read -r PROFILE_VOICE PROFILE_PRETEXT PROFILE_REVERB PROFILE_PERSONALITY PROFILE_MUSIC_TRACK PROFILE_MUSIC_VOLUME PROFILE_MUSIC_ENABLED <<< "$_ALL_FIELDS"
 fi
 
+# Read global background music volume as fallback (stored as 0.0-1.0, convert to 0-100 integer)
+_BG_VOL_FILE="${CLAUDE_PROJECT_DIR:-$PROJECT_ROOT}/.claude/config/background-music-volume.txt"
+if [[ ! -f "$_BG_VOL_FILE" ]]; then
+  _BG_VOL_FILE="$HOME/.claude/config/background-music-volume.txt"
+fi
+if [[ -f "$_BG_VOL_FILE" ]]; then
+  GLOBAL_BG_VOLUME=$(_BG_VOL_RAW=$(cat "$_BG_VOL_FILE") node -e "
+    const v = parseFloat(process.env._BG_VOL_RAW);
+    process.stdout.write(isNaN(v) ? '20' : String(Math.round(v * 100)));
+  " 2>/dev/null || echo "20")
+else
+  GLOBAL_BG_VOLUME=20
+fi
+
 # Fallback to bmad-voice-manager.sh if no profile voice found
 AGENT_VOICE="$PROFILE_VOICE"
 AGENT_INTRO="$PROFILE_PRETEXT"
@@ -203,7 +217,7 @@ if [[ -n "$PROFILE_REVERB" ]] || [[ -n "$PROFILE_PERSONALITY" ]] || [[ -n "$PROF
   # Write profile as JSON for reliable parsing downstream
   # SECURITY: Pass values via env vars to prevent shell injection
   _P_REVERB="$PROFILE_REVERB" _P_PERSONALITY="$PROFILE_PERSONALITY" \
-  _P_MUSIC_TRACK="$PROFILE_MUSIC_TRACK" _P_MUSIC_VOL="${PROFILE_MUSIC_VOLUME:-70}" \
+  _P_MUSIC_TRACK="$PROFILE_MUSIC_TRACK" _P_MUSIC_VOL="${PROFILE_MUSIC_VOLUME:-$GLOBAL_BG_VOLUME}" \
   _P_MUSIC_ENABLED="$PROFILE_MUSIC_ENABLED" \
   _P_OUTFILE="$TEMP_PROFILE" node -e "
     const p = {};
@@ -211,7 +225,7 @@ if [[ -n "$PROFILE_REVERB" ]] || [[ -n "$PROFILE_PERSONALITY" ]] || [[ -n "$PROF
     if (process.env._P_PERSONALITY) p.personality = process.env._P_PERSONALITY;
     if (process.env._P_MUSIC_TRACK) p.backgroundMusic = {
       track: process.env._P_MUSIC_TRACK,
-      volume: parseInt(process.env._P_MUSIC_VOL) || 70,
+      volume: parseInt(process.env._P_MUSIC_VOL) || 20,
       enabled: process.env._P_MUSIC_ENABLED === 'true'
     };
     require('fs').writeFileSync(process.env._P_OUTFILE, JSON.stringify(p), { mode: 0o600 });

package/.claude/hooks-windows/bmad-party-speak.ps1

@@ -0,0 +1,141 @@
+#
+# File: ~/.claude/hooks-windows/bmad-party-speak.ps1
+#
+# AgentVibes PostToolUse Hook - BMAD Party Mode TTS
+#
+# Fires after every Agent tool call. Detects BMAD party mode agents by
+# fingerprinting the prompt, extracts the agent display name, maps it to
+# the canonical agent ID via the manifest, then calls bmad-speak.ps1.
+#
+# Installed globally so it works in any BMAD project.
+# Uses $env:CLAUDE_PROJECT_DIR to locate the project manifest at runtime.
+#
+
+try {
+    # --- Read stdin safely ---
+    $raw = [Console]::In.ReadToEnd()
+    if (-not $raw -or $raw.Trim() -eq "") { exit 0 }
+
+    $data = $raw | ConvertFrom-Json
+    if (-not $data) { exit 0 }
+
+    # --- Only handle Agent tool ---
+    if ($data.tool_name -ne "Agent") { exit 0 }
+
+
+    # --- Extract prompt ---
+    $prompt = $data.tool_input.prompt
+    if (-not $prompt) { exit 0 }
+
+    # --- Fingerprint: only fire for BMAD party mode agents ---
+    if ($prompt -notmatch "BMAD agent in a collaborative roundtable") { exit 0 }
+
+    # --- Extract display name from "You are {Name} (" ---
+    if ($prompt -notmatch "You are ([A-Za-z]+)\s*\(") { exit 0 }
+    $DisplayName = $Matches[1]
+
+    # --- Extract response text ---
+    $content = $data.tool_response.content
+    if (-not $content -or $content.Count -eq 0) { exit 0 }
+    $ResponseText = ($content | Where-Object { $_.type -eq "text" } | Select-Object -First 1).text
+    if (-not $ResponseText) { exit 0 }
+
+    # Strip leading icon + bold name header e.g. "📊 **Mary:**" or garbled "≡ƒôè **Mary:**"
+    # Trim first so leading newlines don't defeat the ^ anchor (fixes M7)
+    $ResponseText = $ResponseText.Trim()
+    $ResponseText = $ResponseText -replace '^\S*\s*\*\*[^:]+:\*\*\s*', ''
+    $ResponseText = $ResponseText.Trim()
+    if (-not $ResponseText) { exit 0 }
+
+    # --- Resolve paths ---
+    $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+    $ProjectRoot = $env:CLAUDE_PROJECT_DIR
+
+    # --- Find bmad-speak.ps1 (prefer project-local, fall back to global) ---
+    $BmadSpeak = $null
+    if ($ProjectRoot) {
+        $local = Join-Path $ProjectRoot ".claude\hooks-windows\bmad-speak.ps1"
+        if (Test-Path $local) { $BmadSpeak = $local }
+    }
+    if (-not $BmadSpeak) {
+        $global = Join-Path $ScriptDir "bmad-speak.ps1"
+        if (Test-Path $global) { $BmadSpeak = $global }
+    }
+    if (-not $BmadSpeak) { exit 0 }
+
+    # --- Look up canonical agent ID from project manifest (fixes m2: UTF8 encoding) ---
+    $AgentId = $DisplayName  # fallback
+    if ($ProjectRoot) {
+        $ManifestFile = Join-Path $ProjectRoot "_bmad\_config\agent-manifest.csv"
+        if (Test-Path $ManifestFile) {
+            $rows = Import-Csv $ManifestFile -Encoding UTF8
+            foreach ($row in $rows) {
+                if ($row.displayName -ieq $DisplayName) {
+                    $AgentId = $row.name
+                    break
+                }
+            }
+        }
+    }
+
+    # --- Apply verbosity truncation ---
+    $Verbosity = "medium"
+    $verbosityPaths = @(
+        (Join-Path $env:USERPROFILE ".claude\tts-verbosity.txt")
+    )
+    if ($ProjectRoot) {
+        $verbosityPaths = @((Join-Path $ProjectRoot ".claude\tts-verbosity.txt")) + $verbosityPaths
+    }
+    foreach ($p in $verbosityPaths) {
+        if (Test-Path $p) {
+            $v = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
+            if ($v) { $Verbosity = $v; break }
+        }
+    }
+
+    switch ($Verbosity) {
+        "low" {
+            $sentences = [regex]::Split($ResponseText, '(?<=[.!?])\s+')
+            # Fall back to full text if no sentence-ending punctuation (fixes m1)
+            if ($sentences.Count -gt 0 -and $sentences[0]) { $ResponseText = $sentences[0] }
+        }
+        "medium" {
+            $sentences = [regex]::Split($ResponseText, '(?<=[.!?])\s+')
+            # Fall back to full text if no sentence-ending punctuation (fixes m1)
+            $truncated = ($sentences | Select-Object -First 2) -join " "
+            if ($truncated) { $ResponseText = $truncated }
+        }
+        # "high" = full text
+    }
+
+    # --- Speak with queue serialization (named mutex, cross-process) ---
+    $mutex = New-Object System.Threading.Mutex($false, "AgentVibesPartyModeTTSQueue")
+    try {
+        $acquired = $false
+        try {
+            # WaitOne throws AbandonedMutexException if prior process crashed while holding it.
+            # That exception means we DID acquire the mutex — treat it as success (fixes M2).
+            $acquired = $mutex.WaitOne(60000)
+        } catch [System.Threading.AbandonedMutexException] {
+            $acquired = $true  # abandoned = we now own it
+        }
+
+        if ($acquired) {
+            try {
+                # Pass positional args directly after -File (spaces handled by quoting via array)
+                & powershell -NoProfile -ExecutionPolicy Bypass -File $BmadSpeak $AgentId $ResponseText
+            } finally {
+                $mutex.ReleaseMutex()
+            }
+        } else {
+            # Timed out — log to stderr so it's visible in hook error output (fixes M6)
+            [Console]::Error.WriteLine("[AgentVibes] Party mode TTS queue timeout for agent: $AgentId")
+        }
+    } finally {
+        $mutex.Close()
+    }
+
+} catch {
+    # Silently exit — never block Claude
+    exit 0
+}

package/.claude/hooks-windows/bmad-speak.ps1

@@ -21,6 +21,11 @@ $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
 $ClaudeDir = Split-Path -Parent $ScriptDir
 $ProjectRoot = Split-Path -Parent $ClaudeDir
 
+# When running as global script, prefer CLAUDE_PROJECT_DIR for project root
+if ($env:CLAUDE_PROJECT_DIR -and (Test-Path "$env:CLAUDE_PROJECT_DIR\_bmad")) {
+    $ProjectRoot = $env:CLAUDE_PROJECT_DIR
+}
+
 # Strip markdown formatting — prevent SAPI/Piper from speaking asterisks literally
 $Dialogue = $Dialogue -replace '\*\*', '' -replace '\*', '' -replace '`', ''
 $Dialogue = $Dialogue -replace '\\!', '!' -replace '\\\$', '$'
@@ -39,22 +44,42 @@ if (-not (Test-Path $ManifestFile)) {
 
 # ---------------------------------------------------------------------------
 # Read bmad-voice-map.json for per-agent profile
-$VoiceMapFile = Join-Path $env:USERPROFILE ".agentvibes\bmad-voice-map.json"
+# Prefer project-local voice map, fall back to global
+$VoiceMapLocal  = Join-Path $ProjectRoot ".agentvibes\bmad-voice-map.json"
+$VoiceMapGlobal = Join-Path $env:USERPROFILE ".agentvibes\bmad-voice-map.json"
+$VoiceMapFile   = if (Test-Path $VoiceMapLocal) { $VoiceMapLocal } else { $VoiceMapGlobal }
 
-$AgentVoice = ""
+$AgentVoice     = ""
 $AgentPersonality = ""
+$AgentBgEnabled = $false
+$AgentBgTrack   = ""
+$AgentId        = $null
+
+# Read global background music volume (stored as 0.0-1.0 float)
+$_BgVolFile = Join-Path $ProjectRoot ".claude\config\background-music-volume.txt"
+if (-not (Test-Path $_BgVolFile)) {
+    $_BgVolFile = Join-Path $env:USERPROFILE ".claude\config\background-music-volume.txt"
+}
+if (Test-Path $_BgVolFile) {
+    $_BgVolRaw = (Get-Content $_BgVolFile -Raw -ErrorAction SilentlyContinue).Trim()
+    $_BgVolParsed = 0.0
+    if ([double]::TryParse($_BgVolRaw, [System.Globalization.NumberStyles]::Float, [System.Globalization.CultureInfo]::InvariantCulture, [ref]$_BgVolParsed)) {
+        $AgentBgVolume = "{0:F2}" -f $_BgVolParsed
+    } else {
+        $AgentBgVolume = "0.20"
+    }
+} else {
+    $AgentBgVolume = "0.20"
+}
 
 if (Test-Path $VoiceMapFile) {
     try {
         $VoiceMap = Get-Content $VoiceMapFile -Raw | ConvertFrom-Json
 
-        # Resolve agent ID from display name or direct ID
-        $AgentId = $null
-
-        # Check direct match against manifest column 1
-        $ManifestRows = Import-Csv $ManifestFile
+        # Resolve agent ID: match canonical ID or display name prefix
+        $ManifestRows = Import-Csv $ManifestFile -Encoding UTF8
         foreach ($row in $ManifestRows) {
-            $id = ($row.PSObject.Properties | Select-Object -First 1).Value -replace '^"|"$', ''
+            $id      = ($row.PSObject.Properties | Select-Object -First 1).Value -replace '^"|"$', ''
             $display = ($row.PSObject.Properties | Select-Object -Skip 1 -First 1).Value -replace '^"|"$', ''
             if ($id -ieq $AgentNameOrId -or $display -like "$AgentNameOrId*") {
                 $AgentId = $id
@@ -64,8 +89,16 @@ if (Test-Path $VoiceMapFile) {
 
         if ($AgentId -and $VoiceMap.agents.$AgentId) {
             $Profile = $VoiceMap.agents.$AgentId
-            if ($Profile.voice) { $AgentVoice = $Profile.voice }
+            if ($Profile.voice)       { $AgentVoice       = $Profile.voice }
             if ($Profile.personality) { $AgentPersonality = $Profile.personality }
+            if ($Profile.backgroundMusic) {
+                $AgentBgEnabled = [bool]$Profile.backgroundMusic.enabled
+                if ($Profile.backgroundMusic.track) { $AgentBgTrack = $Profile.backgroundMusic.track }
+                if ($null -ne $Profile.backgroundMusic.volume) {
+                    # Voice map stores 0-100; audio-effects.cfg uses 0.0-1.0
+                    $AgentBgVolume = "{0:F2}" -f ([double]$Profile.backgroundMusic.volume / 100.0)
+                }
+            }
         }
     } catch {
         # Silently degrade — TTS will still play with global settings
@@ -74,7 +107,7 @@ if (Test-Path $VoiceMapFile) {
 
 # ---------------------------------------------------------------------------
 # Locate play-tts.ps1 — prefer project-local, fall back to global
-$PlayTtsLocal = Join-Path $ProjectRoot ".claude\hooks-windows\play-tts.ps1"
+$PlayTtsLocal  = Join-Path $ProjectRoot ".claude\hooks-windows\play-tts.ps1"
 $PlayTtsGlobal = Join-Path $env:USERPROFILE ".claude\hooks-windows\play-tts.ps1"
 $PlayTtsScript = if (Test-Path $PlayTtsLocal) { $PlayTtsLocal } else { $PlayTtsGlobal }
 
@@ -82,10 +115,20 @@ if (-not (Test-Path $PlayTtsScript)) {
     exit 0
 }
 
+# ---------------------------------------------------------------------------
+# Determine which .claude config dir play-tts.ps1 will read.
+# play-tts.ps1 checks CLAUDE_PROJECT_DIR first — match that logic exactly.
+$TtsClaudeDir = if ($env:CLAUDE_PROJECT_DIR -and (Test-Path "$env:CLAUDE_PROJECT_DIR\.claude")) {
+    "$env:CLAUDE_PROJECT_DIR\.claude"
+} else {
+    $ClaudeDir  # ~/.claude (this script's own ClaudeDir)
+}
+$TtsConfigDir = Join-Path $TtsClaudeDir "config"
+
 # ---------------------------------------------------------------------------
 # Apply per-agent personality override if set
-$OldPersonality = ""
-$PersonalityFile = Join-Path $ClaudeDir "config\personality.txt"
+$OldPersonality  = ""
+$PersonalityFile = Join-Path $TtsClaudeDir "config\personality.txt"
 if ($AgentPersonality -and (Test-Path (Split-Path $PersonalityFile -Parent))) {
     if (Test-Path $PersonalityFile) {
         $OldPersonality = (Get-Content $PersonalityFile -Raw).Trim()
@@ -93,6 +136,32 @@ if ($AgentPersonality -and (Test-Path (Split-Path $PersonalityFile -Parent))) {
     Set-Content $PersonalityFile $AgentPersonality -NoNewline
 }
 
+# ---------------------------------------------------------------------------
+# Temporarily patch background music config for this agent.
+# The caller (bmad-party-speak.ps1) holds a named mutex so only one speak
+# call runs at a time — these file patches are safe from concurrent clobber.
+$BgEnabledFile   = Join-Path $TtsConfigDir "background-music-enabled.txt"
+$AudioEffectsCfg = Join-Path $TtsConfigDir "audio-effects.cfg"
+$OldBgEnabled    = $null
+$TempCfgLine     = ""
+
+if ($AgentBgEnabled -and $AgentBgTrack) {
+    # Save + enable background music
+    if (Test-Path $BgEnabledFile) {
+        $OldBgEnabled = (Get-Content $BgEnabledFile -Raw -ErrorAction SilentlyContinue).Trim()
+    }
+    Set-Content $BgEnabledFile "true" -NoNewline
+
+    # Prepend agent line to audio-effects.cfg so play-tts.ps1 finds it first
+    # Format: AGENT_NAME|SOX_EFFECTS|BACKGROUND_FILE|BACKGROUND_VOLUME
+    $TempCfgLine = "${AgentId}||${AgentBgTrack}|${AgentBgVolume}"
+    $env:AGENTVIBES_AGENT_NAME = $AgentId
+    $existingCfg = if (Test-Path $AudioEffectsCfg) {
+        Get-Content $AudioEffectsCfg -Raw -ErrorAction SilentlyContinue
+    } else { "" }
+    Set-Content $AudioEffectsCfg "${TempCfgLine}`n${existingCfg}" -NoNewline
+}
+
 try {
     # Speak with agent's voice (or global voice if none configured)
     if ($AgentVoice) {
@@ -101,7 +170,7 @@ try {
         & powershell -NoProfile -ExecutionPolicy Bypass -File $PlayTtsScript $Dialogue
     }
 } finally {
-    # Restore original personality
+    # Restore personality
     if ($AgentPersonality -and $PersonalityFile) {
         if ($OldPersonality) {
             Set-Content $PersonalityFile $OldPersonality -NoNewline
@@ -109,4 +178,23 @@ try {
             Remove-Item $PersonalityFile -Force -ErrorAction SilentlyContinue
         }
     }
+
+    # Restore background music config
+    if ($AgentBgEnabled -and $AgentBgTrack) {
+        if ($null -ne $OldBgEnabled) {
+            Set-Content $BgEnabledFile $OldBgEnabled -NoNewline
+        } elseif (Test-Path $BgEnabledFile) {
+            Remove-Item $BgEnabledFile -Force -ErrorAction SilentlyContinue
+        }
+
+        # Remove the prepended agent line from audio-effects.cfg
+        if (Test-Path $AudioEffectsCfg) {
+            $cfgRaw = Get-Content $AudioEffectsCfg -Raw -ErrorAction SilentlyContinue
+            $escaped = [regex]::Escape($TempCfgLine)
+            $cfgRaw  = $cfgRaw -replace "^${escaped}\r?\n?", ""
+            Set-Content $AudioEffectsCfg $cfgRaw -NoNewline
+        }
+
+        $env:AGENTVIBES_AGENT_NAME = ""
+    }
 }

package/RELEASE_NOTES.md

@@ -1,5 +1,50 @@
 # AgentVibes Release Notes
 
+## ✨ v4.6.0 — Minor Release
+
+**Release Date:** April 2026
+
+### New Features
+
+- **BMAD party mode TTS auto-installs for all platforms** — The installer now automatically copies `bmad-party-speak.sh` (Linux/macOS/WSL) or `bmad-party-speak.ps1` (Windows) to `~/.claude/hooks/` and registers a `PostToolUse` hook in `~/.claude/settings.json`. Party mode agents now speak out of the box in any BMAD project without manual setup. Both scripts are included in critical hooks so `npx agentvibes update` keeps them fresh.
+
+### Bug Fixes
+
+- **Background music volume default** — All volume defaults lowered from 70% to 20% across the UI (settings tab, agents tab, music tab, track picker) and scripts (`audio-processor.sh`, `bmad-speak.sh`, `bmad-speak.ps1`). New installs and newly configured agents default to a much more reasonable level.
+- **bmad-speak volume inheritance** — `bmad-speak.sh` and `bmad-speak.ps1` now read the global `background-music-volume.txt` config file as the fallback volume instead of a hardcoded value.
+- **Installer wizard left arrow** — Pressing ← on the completion screen (screen 5) to move from Done-Quit to Done-Customize More no longer jumps back to the installation step.
+
+### Tests
+
+- 29 new tests: volume default regression guards across all affected files, `configurePartyModeHook` installer coverage (idempotency, settings.json registration, script copying, hook preservation), and a regression test for the screen 5 navigation fix.
+
+---
+
+## 🐛 v4.5.7 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fixes
+
+- **Background music volume default** — All volume defaults lowered from 70% to 20% across the UI (settings tab, agents tab, music tab, track picker). New installs and newly configured agents will default to a much more reasonable background music level.
+- **bmad-speak volume inheritance** — `bmad-speak.sh` and `bmad-speak.ps1` now read the global `background-music-volume.txt` config file as the fallback volume instead of a hardcoded value. Per-agent background music volume now correctly inherits the global setting when no explicit per-agent override is saved.
+
+---
+
+## 🐛 v4.5.1 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fix
+
+- **Music tab preview** — Pressing Space on a track in the Music tab now plays correctly
+  when running `npx agentvibes` from a fresh directory. Previously, if `.claude/audio/tracks/`
+  didn't exist in the current working directory, the track list showed built-in tracks but
+  Space did nothing (the player was spawned against a non-existent path). Now falls back to
+  the package-bundled tracks directory automatically.
+
+---
+
 ## 🌍 v4.5.0 — "Speak Every Language" Release
 
 **Release Date:** April 2026
@@ -27,8 +72,22 @@ Every screen, tab, button, and label in the `npx agentvibes` TUI is now fully tr
 
 ### 🎙️ Cross-Platform BMAD Speak
 
-BMAD (Build More Architect Dreams) is an AI multi-agent framework where specialized agents — Architect, PM, Developer, QA, and Analyst — collaborate to build software. With this release, every agent in a BMAD party mode session now speaks aloud with their own unique voice, personality, and music on Windows — making each role instantly recognizable.
-
+BMAD (Build More Architect Dreams) is an AI multi-agent framework where specialized agents — Architect, PM, Developer, QA, and Analyst — collaborate to build software. With this release, every agent in a BMAD party mode session now speaks aloud with their own unique voice, personality, and music on Windows — making each role instantly recognizable.
+
+## 🐛 v4.5.1 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fix
+
+- **Music tab preview** — Pressing Space on a track in the Music tab now plays correctly
+  when running `npx agentvibes` from a fresh directory. Previously, if `.claude/audio/tracks/`
+  didn't exist in the current working directory, the track list showed built-in tracks but
+  Space did nothing (the player was spawned against a non-existent path). Now falls back to
+  the package-bundled tracks directory automatically.
+
+---
+
 - `bin/bmad-speak.js` — cross-platform entry point for BMAD agent speech
 - `.claude/hooks-windows/bmad-speak.ps1` — native Windows BMAD speak with per-agent personality routing
 

package/bin/agent-vibes

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes - Beautiful ElevenLabs TTS voice commands for Claude Code

package/bin/agentvibes-voice-browser.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes Voice Browser

package/bin/mcp-server.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes MCP Server Launcher (Cross-Platform)

package/bin/test-bmad-pr

@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
+#!/usr/bin/env bash
 #
 # AgentVibes BMAD PR Testing Command
 # Quick command to test BMAD PRs with AgentVibes integration

package/package.json

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

package/src/console/app.js

@@ -825,7 +825,11 @@ export class AgentVibesConsole {
     });
 
     // Register global key bindings (S/V/M/A/R/H/I/T/Esc)
-    setupNavigation(this.screen, this.navigationService);
+    setupNavigation(this.screen, this.navigationService, () => {
+      const id = this.navigationService.getActiveTab();
+      const item = this._tabItems?.[id];
+      if (item) item.focus();
+    });
   }
 
   // ---------------------------------------------------------------------------

package/src/console/navigation.js

@@ -35,8 +35,9 @@ const KEY_TO_TAB = {
  *
  * @param {object} screen - Blessed screen instance (or stub in tests)
  * @param {import('../services/navigation-service.js').NavigationService} navigationService
+ * @param {function} [focusMainTabBar] - Optional callback to return focus to the tab bar
  */
-export function setupNavigation(screen, navigationService) {
+export function setupNavigation(screen, navigationService, focusMainTabBar) {
   // Tab switching shortcuts — one handler per key (both cases)
   for (const [key, tabId] of Object.entries(KEY_TO_TAB)) {
     screen.key([key], () => {
@@ -53,10 +54,12 @@ export function setupNavigation(screen, navigationService) {
     }
   });
 
-  // Escape — close modal (story 6.4 will expand modal handling)
+  // Escape — close modal if open, otherwise return focus to tab bar
   screen.key(['escape'], () => {
     if (navigationService.isModalOpen()) {
       navigationService.closeModal();
+    } else if (typeof focusMainTabBar === 'function') {
+      focusMainTabBar();
     }
   });
 }

package/src/console/tabs/agents-tab.js

@@ -319,7 +319,7 @@ ${_tl('bmadDesc')}
   }
 
   const resetBtn = _createBtn('[X] Reset', () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) {
       voiceStore.resetAgentProfile(agent.id);
       refreshDisplay();
@@ -374,7 +374,7 @@ ${_tl('bmadDesc')}
         ? formatTrackName(profile.backgroundMusic.track)
         : '(global)')).padEnd(COL_MUSIC).slice(0, COL_MUSIC);
       const vol = profile.backgroundMusic?.enabled
-        ? ` ${profile.backgroundMusic.volume ?? 70}%`.padEnd(COL_VOL)
+        ? ` ${profile.backgroundMusic.volume ?? 20}%`.padEnd(COL_VOL)
         : '  —  ';
       const pretext = ' ' + (profile.pretext || '(default)').slice(0, COL_PRETEXT - 1);
       return ` ${icon}${name}${voice}${gender}${provider}${reverb}${music}${vol}  ${pretext}`;
@@ -513,7 +513,7 @@ ${_tl('bmadDesc')}
       personality:     profile.personality   || globalCfg.personality || 'none',
       backgroundMusic: {
         track:   profile.backgroundMusic?.track   || globalCfg.backgroundMusic?.track || '',
-        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 70,
+        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 20,
         enabled: profile.backgroundMusic?.enabled ?? globalCfg.backgroundMusic?.enabled ?? false,
       },
     });
@@ -534,7 +534,7 @@ ${_tl('bmadDesc')}
       personality:     profile.personality   || globalCfg.personality || 'none',
       backgroundMusic: {
         track:   profile.backgroundMusic?.track   || globalCfg.backgroundMusic?.track || '',
-        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 70,
+        volume:  profile.backgroundMusic?.volume  ?? globalCfg.backgroundMusic?.volume ?? 20,
         enabled: profile.backgroundMusic?.enabled ?? globalCfg.backgroundMusic?.enabled ?? false,
       },
     };
@@ -657,7 +657,7 @@ ${_tl('bmadDesc')}
       if (draft.reverbPreset !== (globalCfg.effects?.reverbPreset || 'light')) toSave.reverbPreset = draft.reverbPreset;
       if (draft.personality !== (globalCfg.personality || 'none')) toSave.personality = draft.personality;
       if (draft.backgroundMusic.track !== (globalCfg.backgroundMusic?.track || '') ||
-          draft.backgroundMusic.volume !== (globalCfg.backgroundMusic?.volume ?? 70) ||
+          draft.backgroundMusic.volume !== (globalCfg.backgroundMusic?.volume ?? 20) ||
           draft.backgroundMusic.enabled !== (globalCfg.backgroundMusic?.enabled ?? false)) {
         toSave.backgroundMusic = draft.backgroundMusic;
       }
@@ -1275,7 +1275,7 @@ ${_tl('bmadDesc')}
       const track = shuffled[i % shuffled.length];
       const existing = voiceStore.getAgentProfile(agent.id);
       voiceStore.setAgentProfile(agent.id, {
-        backgroundMusic: { track, volume: existing.backgroundMusic?.volume ?? 70, enabled: true },
+        backgroundMusic: { track, volume: existing.backgroundMusic?.volume ?? 20, enabled: true },
       });
     });
     return true;
@@ -1373,7 +1373,7 @@ ${_tl('bmadDesc')}
 
         case 'setMusic':
           _closeMenu(() => {
-            openTrackPicker(screen, '', 70, (track, volume) => {
+            openTrackPicker(screen, '', 20, (track, volume) => {
               _agents.forEach(agent => {
                 const p = voiceStore.getAgentProfile(agent.id);
                 voiceStore.setAgentProfile(agent.id, {
@@ -1389,7 +1389,7 @@ ${_tl('bmadDesc')}
 
         case 'setVolume':
           _closeMenu(() => {
-            const curVol = voiceStore.getAgentProfile(_agents[0]?.id)?.backgroundMusic?.volume ?? 70;
+            const curVol = voiceStore.getAgentProfile(_agents[0]?.id)?.backgroundMusic?.volume ?? 20;
             openVolumeInput(screen, curVol, (volume) => {
               _agents.forEach(agent => {
                 const p = voiceStore.getAgentProfile(agent.id);
@@ -1504,7 +1504,7 @@ ${_tl('bmadDesc')}
   // Key bindings
 
   agentList.key(['x', 'X'], () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) {
       voiceStore.resetAgentProfile(agent.id);
       refreshDisplay();
@@ -1513,12 +1513,12 @@ ${_tl('bmadDesc')}
 
 
   agentList.key(['enter'], () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) _openAgentDetailPanel(agent);
   });
 
   agentList.key(['space'], () => {
-    const agent = _agents[agentList.selected];
+    const agent = _agents[agentList.selected ?? 0];
     if (agent) _sampleAgent(agent);
   });
 

package/src/console/tabs/install-tab.js

@@ -443,9 +443,10 @@ export function createInstallTab(screen, services) {
 
     _renderScreen5();
 
-    // Show OK button now that install is done (success or error)
-    _s5OkBtn.show();
-    _s5OkBtn.focus();
+    // Show buttons now that install is done (success or error)
+    _s5QuitBtn.show();
+    _s5CustomizeBtn.show();
+    _s5QuitBtn.focus();
     screen.render();
 
     // Play TTS greeting on success
@@ -579,12 +580,25 @@ export function createInstallTab(screen, services) {
   // Screen 3: no Continue button — Enter/→ on the list confirms selection and advances
 
   // -------------------------------------------------------------------------
-  // Screen 5 button — OK (summary page only, config already saved on screen 4)
+  // Screen 5 buttons — Customize More (left) + Done - Quit (right, default focused)
+  // Layout: [  Customize More  ]   [  Done - Quit  ]
+  // Button width = label + 2 padding chars; gap between buttons = 3 chars
 
-  const _s5OkBtn = _createInstallBtn(_tl('okDoneBtn'), '#1565c0', () => {
+  const _s5CustomizeBtn = _createInstallBtn(_tl('doneCustomizeBtn'), '#1565c0', () => {
     _dismissCompletionModal();
   });
-  _s5OkBtn.bottom = 3; _s5OkBtn.left = 4;  // bottom-anchored: sits above hintLine (bottom:2)
+  _s5CustomizeBtn.bottom = 3; _s5CustomizeBtn.left = 4;
+
+  const _s5QuitBtn = _createInstallBtn(_tl('doneQuitBtn'), '#b71c1c', () => {
+    screen.destroy();
+    process.exit(0);
+  });
+  // left = start(4) + customizeLabel + 2 padding + 3 gap
+  _s5QuitBtn.bottom = 3; _s5QuitBtn.left = 4 + _tl('doneCustomizeBtn').length + 2 + 3;
+
+  // Arrow/Tab navigation between the two buttons
+  _s5CustomizeBtn.key(['tab', 'right'], () => { _s5QuitBtn.focus(); screen.render(); });
+  _s5QuitBtn.key(['tab', 'left', 'S-tab'], () => { _s5CustomizeBtn.focus(); screen.render(); });
 
   // -------------------------------------------------------------------------
   // Screen renderers
@@ -827,11 +841,13 @@ export function createInstallTab(screen, services) {
     // Screen 2 continue button: hidden on other screens; _renderScreen2 manages show/focus
     if (_screen !== 2) _s2ContinueBtn.hide();
 
-    // Screen 5 OK button: hidden during active install, shown by _runInstall() on completion
+    // Screen 5 buttons: hidden during active install, shown by _runInstall() on completion
     if (_screen === 5 && (_installComplete || _installError)) {
-      _s5OkBtn.show();
+      _s5QuitBtn.show();
+      _s5CustomizeBtn.show();
     } else {
-      _s5OkBtn.hide();
+      _s5QuitBtn.hide();
+      _s5CustomizeBtn.hide();
     }
 
     // Show Screen 4 action buttons only on screen 4
@@ -958,6 +974,7 @@ export function createInstallTab(screen, services) {
   screen.key(['left'], () => {
     if (box.hidden || _checking) return;
     if (_screen === 4) return;
+    if (_screen === 5) return;  // Screen 5: ← handled by button nav
     if (_screen > 0) {
       _screen--;
       _showCurrentScreen();
@@ -1047,7 +1064,7 @@ export function createInstallTab(screen, services) {
       } else if (_screen === 4) {
         _editBtn.focus();
       } else if (_screen === 5 && (_installComplete || _installError)) {
-        _s5OkBtn.focus();
+        _s5QuitBtn.focus();
       } else {
         box.focus();
       }

package/src/console/tabs/music-tab.js

@@ -12,10 +12,17 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
+import { fileURLToPath } from 'node:url';
 import { spawn } from 'node:child_process';
 import { buildAudioEnv, detectMp3Player } from '../audio-env.js';
 import { t } from '../../i18n/strings.js';
 
+// Package-relative tracks dir — used as fallback when cwd has no .claude/audio/tracks/
+const _PKG_TRACKS_DIR = path.resolve(
+  path.dirname(fileURLToPath(import.meta.url)),
+  '..', '..', '..', '.claude', 'audio', 'tracks'
+);
+
 const IS_TEST = process.env.AGENTVIBES_TEST_MODE === 'true';
 
 let blessed;
@@ -157,7 +164,9 @@ function createTestStub() {
  * @returns {string}
  */
 function _getTracksDir() {
-  return path.join(process.cwd(), '.claude', 'audio', 'tracks');
+  const cwdTracks = path.join(process.cwd(), '.claude', 'audio', 'tracks');
+  // Fall back to package-bundled tracks if cwd doesn't have any
+  return fs.existsSync(cwdTracks) ? cwdTracks : _PKG_TRACKS_DIR;
 }
 
 /**
@@ -191,7 +200,7 @@ function _getMusic(configService) {
   return {
     enabled: music.enabled ?? false,
     track:   music.track ?? BUILT_IN_TRACK_CATALOG[0].id,
-    volume:  music.volume ?? 70,
+    volume:  music.volume ?? 20,
   };
 }
 

package/src/console/tabs/settings-tab.js

@@ -108,7 +108,7 @@ const FOOTER_TEXT =
 const EFFECTS_DEFAULTS = Object.freeze({ reverbPreset: 'light' });
 
 // Default background music config
-const MUSIC_DEFAULTS = Object.freeze({ enabled: false, track: 'agentvibes_soft_flamenco_loop.mp3', volume: 70 });
+const MUSIC_DEFAULTS = Object.freeze({ enabled: false, track: 'agentvibes_soft_flamenco_loop.mp3', volume: 20 });
 
 // Verbosity display labels
 const VERBOSITY_LABELS = Object.freeze({ high: 'High', medium: 'Medium', low: 'Low', minimal: 'Minimal', custom: 'Custom' });

package/src/console/widgets/track-picker.js

@@ -279,7 +279,7 @@ export function openTrackPicker(screen, currentTrack, currentVolume, onSelect, o
     _killPreview();
     if (list._label2) list._label2.destroy();
     destroyList(list, screen, null);
-    openVolumeInput(screen, currentVolume ?? 70, (volume) => {
+    openVolumeInput(screen, currentVolume ?? 20, (volume) => {
       onSelect(selected.file, volume);
     }, onClose);
   });

package/src/i18n/de.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "Weiter →",
   acceptInstallBtn: "✓ Akzeptieren & Installieren",
   okDoneBtn: "✓  OK — Fertig",
+  doneCustomizeBtn: "✓  Fertig - Mehr anpassen",
+  doneQuitBtn: "✕  Fertig - Beenden",
   editInstallBtn: "Bearbeiten",
   musicDisabledMsg: "Musik deaktiviert. Jetzt aktivieren?",
   settingsFooter: "[↑↓] Gruppe  [←→] Geschwister/Sub-Tab  [Enter/Space] Aktivieren  [Tab] Tab Wechseln  [Q] Beenden",

package/src/i18n/en.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "Continue →",
   acceptInstallBtn: "✓ Accept & Install",
   okDoneBtn: "✓  OK — Done",
+  doneCustomizeBtn: "✓  Done - Customize More",
+  doneQuitBtn: "✕  Done - Quit",
   editInstallBtn: "Edit",
   musicDisabledMsg: "Music is disabled. Enable it now?",
   settingsFooter: "[↑↓] Group  [←→] Sibling/Sub-tab  [Enter/Space] Activate  [Tab] Switch Tab  [Q] Quit",

package/src/i18n/es.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "Continuar →",
   acceptInstallBtn: "✓ Aceptar e Instalar",
   okDoneBtn: "✓  OK — Listo",
+  doneCustomizeBtn: "✓  Listo - Personalizar más",
+  doneQuitBtn: "✕  Listo - Salir",
   editInstallBtn: "Editar",
   musicDisabledMsg: "Música desactivada. ¿Activar ahora?",
   settingsFooter: "[↑↓] Grupo  [←→] Hermano/Sub-tab  [Enter/Space] Activar  [Tab] Cambiar Tab  [Q] Salir",

package/src/i18n/fr.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "Continuer →",
   acceptInstallBtn: "✓ Accepter et Installer",
   okDoneBtn: "✓  OK — Terminé",
+  doneCustomizeBtn: "✓  Terminé - Personnaliser plus",
+  doneQuitBtn: "✕  Terminé - Quitter",
   editInstallBtn: "Modifier",
   musicDisabledMsg: "Musique désactivée. L'activer maintenant ?",
   settingsFooter: "[↑↓] Groupe  [←→] Sibling/Sub-tab  [Enter/Space] Activer  [Tab] Changer Tab  [Q] Quitter",

package/src/i18n/hi.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "जारी रखें →",
   acceptInstallBtn: "✓ स्वीकार करें और स्थापित करें",
   okDoneBtn: "✓  OK — हो गया",
+  doneCustomizeBtn: "✓  हो गया - और अनुकूलित करें",
+  doneQuitBtn: "✕  हो गया - बाहर निकलें",
   editInstallBtn: "संपादित करें",
   musicDisabledMsg: "संगीत अक्षम है। अभी सक्षम करें?",
   settingsFooter: "[↑↓] समूह  [←→] सहोदर/उप-टैब  [Enter/Space] सक्रिय करें  [Tab] टैब बदलें  [Q] बाहर",

package/src/i18n/ja.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "続ける →",
   acceptInstallBtn: "✓ 承認してインストール",
   okDoneBtn: "✓  OK — 終了",
+  doneCustomizeBtn: "✓  終了 - さらにカスタマイズ",
+  doneQuitBtn: "✕  終了 - 終了する",
   editInstallBtn: "編集",
   musicDisabledMsg: "音楽が無効です。今すぐ有効にしますか？",
   settingsFooter: "[↑↓] グループ  [←→] 兄弟/サブタブ  [Enter/Space] 実行  [Tab] タブ切替  [Q] 終了",

package/src/i18n/ko.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "계속 →",
   acceptInstallBtn: "✓ 수락 및 설치",
   okDoneBtn: "✓  OK — 완료",
+  doneCustomizeBtn: "✓  완료 - 더 맞춤 설정",
+  doneQuitBtn: "✕  완료 - 종료",
   editInstallBtn: "편집",
   musicDisabledMsg: "음악이 비활성화되어 있습니다. 지금 활성화하겠습니까?",
   settingsFooter: "[↑↓] 그룹  [←→] 형제/서브탭  [Enter/Space] 활성화  [Tab] 탭 전환  [Q] 나가기",

package/src/i18n/pt.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "Continuar →",
   acceptInstallBtn: "✓ Aceitar e Instalar",
   okDoneBtn: "✓  OK — Concluído",
+  doneCustomizeBtn: "✓  Concluído - Personalizar mais",
+  doneQuitBtn: "✕  Concluído - Sair",
   editInstallBtn: "Editar",
   musicDisabledMsg: "Música desativada. Ativar agora?",
   settingsFooter: "[↑↓] Grupo  [←→] Irmão/Sub-tab  [Enter/Space] Ativar  [Tab] Trocar Tab  [Q] Sair",

package/src/i18n/zh-CN.js

@@ -113,6 +113,8 @@ export default {
   continueArrowBtn: "继续 →",
   acceptInstallBtn: "✓ 接受并安装",
   okDoneBtn: "✓  OK — 完成",
+  doneCustomizeBtn: "✓  完成 - 更多自定义",
+  doneQuitBtn: "✕  完成 - 退出",
   editInstallBtn: "编辑",
   musicDisabledMsg: "音乐已禁用。现在启用？",
   settingsFooter: "[↑↓] 组  [←→] 兄弟/子标签  [Enter/Space] 激活  [Tab] 切换标签  [Q] 退出",

package/src/installer.js

@@ -3822,6 +3822,76 @@ async function configureSessionStartHook(targetDir, spinner) {
   }
 }
 
+/**
+ * Configure BMAD party mode PostToolUse hook in the global ~/.claude/settings.json.
+ * Copies bmad-party-speak script to ~/.claude/hooks/ (or hooks-windows/ on Windows)
+ * and registers the PostToolUse hook so party mode TTS works in any BMAD project.
+ * @param {string} targetDir - Target installation directory (used to locate source scripts)
+ * @param {Object} spinner - Ora spinner instance
+ */
+async function configurePartyModeHook(targetDir, spinner, homeDirOverride) {
+  spinner.start('Configuring BMAD party mode TTS hook...');
+  const homeDir = homeDirOverride || os.homedir();
+  const globalClaudeDir = path.join(homeDir, '.claude');
+  const globalSettingsPath = path.join(globalClaudeDir, 'settings.json');
+
+  try {
+    // Determine platform-specific paths
+    const hooksSubdir = isNativeWindows() ? 'hooks-windows' : 'hooks';
+    const scriptName = isNativeWindows() ? 'bmad-party-speak.ps1' : 'bmad-party-speak.sh';
+    const globalHooksDir = path.join(globalClaudeDir, hooksSubdir);
+    const srcScript = path.join(__dirname, '..', '.claude', hooksSubdir, scriptName);
+    const destScript = path.join(globalHooksDir, scriptName);
+
+    // Copy script to global hooks dir (create dir if needed)
+    await fs.mkdir(globalHooksDir, { recursive: true });
+    await fs.copyFile(srcScript, destScript);
+    if (!isNativeWindows()) {
+      await fs.chmod(destScript, 0o750);
+    }
+
+    // Build the PostToolUse hook command
+    const hookCommand = isNativeWindows()
+      ? `powershell -NoProfile -ExecutionPolicy Bypass -File "$HOME\\.claude\\hooks-windows\\bmad-party-speak.ps1"`
+      : `bash "$HOME/.claude/hooks/bmad-party-speak.sh"`;
+
+    // Read/create global settings.json
+    let settings = {};
+    try {
+      const content = await fs.readFile(globalSettingsPath, 'utf8');
+      settings = JSON.parse(content);
+    } catch {
+      // File missing or invalid — start fresh
+    }
+
+    if (!settings.hooks) settings.hooks = {};
+
+    // Check if PostToolUse hook already registered
+    const existing = settings.hooks.PostToolUse;
+    const alreadyRegistered = Array.isArray(existing) &&
+      existing.some(entry =>
+        Array.isArray(entry.hooks) &&
+        entry.hooks.some(h => h.command && h.command.includes('bmad-party-speak'))
+      );
+
+    if (!alreadyRegistered) {
+      if (!Array.isArray(settings.hooks.PostToolUse)) {
+        settings.hooks.PostToolUse = [];
+      }
+      settings.hooks.PostToolUse.push({
+        hooks: [{ type: 'command', command: hookCommand }]
+      });
+      await fs.writeFile(globalSettingsPath, JSON.stringify(settings, null, 2));
+      spinner.succeed(chalk.green('BMAD party mode TTS hook configured!\n'));
+    } else {
+      // Script still updated above — just note settings unchanged
+      spinner.succeed(chalk.green('BMAD party mode TTS hook up to date\n'));
+    }
+  } catch (error) {
+    spinner.warn(chalk.yellow(`BMAD party mode hook setup skipped: ${error.message}\n`));
+  }
+}
+
 /**
  * Ensure target directory is a git repo (required for Claude Code hook context injection)
  * @param {string} targetDir - Target installation directory
@@ -4781,7 +4851,8 @@ async function updateCommandFiles(targetDir, spinner) {
  * These hooks contain bug fixes (e.g. markdown stripping) that must propagate
  * on every `npx agentvibes update` regardless of target directory.
  */
-const CRITICAL_HOOKS = ['stop-tts.sh', 'stop.sh', 'play-tts.sh', 'session-start-tts.sh'];
+const CRITICAL_HOOKS = ['stop-tts.sh', 'stop.sh', 'play-tts.sh', 'session-start-tts.sh', 'bmad-party-speak.sh'];
+const CRITICAL_HOOKS_WINDOWS = ['play-tts.ps1', 'session-start-tts.ps1', 'bmad-speak.ps1', 'bmad-party-speak.ps1'];
 
 /**
  * Update critical hooks in the global ~/.claude/hooks/ directory if it exists.
@@ -4811,6 +4882,27 @@ async function updateGlobalHooks(srcHooksDir, homeDirOverride) {
       // file not in global dir or src missing — skip silently
     }
   }
+
+  // Also update Windows global hooks-windows dir if present
+  const globalHooksWindowsDir = path.join(homeDirOverride || os.homedir(), '.claude', 'hooks-windows');
+  const srcHooksWindowsDir = path.join(path.dirname(srcHooksDir), 'hooks-windows');
+  try {
+    await fs.access(globalHooksWindowsDir);
+    for (const hook of CRITICAL_HOOKS_WINDOWS) {
+      const destPath = path.join(globalHooksWindowsDir, hook);
+      const srcPath = path.join(srcHooksWindowsDir, hook);
+      try {
+        await fs.access(destPath); // only update if already installed
+        await fs.copyFile(srcPath, destPath);
+        updated++;
+      } catch {
+        // file not in global dir or src missing — skip silently
+      }
+    }
+  } catch {
+    // hooks-windows dir not present — nothing to do
+  }
+
   return updated;
 }
 
@@ -4873,6 +4965,7 @@ async function performUpdateOperations(targetDir, spinner) {
   // Update settings.json
   spinner.text = 'Updating AgentVibes hook configuration...';
   await configureSessionStartHook(targetDir, silentSpinner);
+  await configurePartyModeHook(targetDir, silentSpinner);
   await ensureGitRepo(targetDir, silentSpinner);
 
   // Detect and migrate old configuration
@@ -5050,6 +5143,7 @@ async function install(options = {}) {
     await copyBackgroundMusicFiles(targetDir, silentSpinner);
     await copyConfigFiles(targetDir, silentSpinner);
     await configureSessionStartHook(targetDir, silentSpinner);
+    await configurePartyModeHook(targetDir, silentSpinner);
     await installPluginManifest(targetDir, silentSpinner);
     await ensureGitRepo(targetDir, silentSpinner);
 
@@ -5943,7 +6037,7 @@ export {
   isTermux, isNativeWindows, detectAndNotifyTermux,
   copyCommandFiles, copyHookFiles, copyPersonalityFiles,
   copyPluginFiles, copyBmadConfigFiles, copyBackgroundMusicFiles,
-  copyConfigFiles, configureSessionStartHook, ensureGitRepo,
+  copyConfigFiles, configureSessionStartHook, configurePartyModeHook, ensureGitRepo,
   installPluginManifest, checkAndInstallPiper,
-  updateGlobalHooks, CRITICAL_HOOKS,
+  updateGlobalHooks, CRITICAL_HOOKS, CRITICAL_HOOKS_WINDOWS,
 };