agentvibes 4.6.0 → 4.6.3

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

@@ -17,7 +17,7 @@ bmad-agent-tech-writer||agent_vibes_arabic_v2_loop.mp3|0.70
 # BMAD Agents - each with unique audio personality|||
 |||
 # PM John - upbeat, driving energy|||
-John|gain -1 equalizer 3000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.30
+John|gain -1 equalizer 3000 1q +2|agentvibes_soft_flamenco_loop.mp3|0.20
 |||
 # Architect Winston - deep, authoritative|||
 Winston|reverb 40 50 90 gain -2|agentvibes_soft_flamenco_loop.mp3|0.25

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

@@ -310,7 +310,7 @@ mix_background() {
     fi
 
     ffmpeg -y -i "$voice" -ss "$start_pos" -stream_loop -1 -i "$background" \
-        -filter_complex "[1:a]volume=${volume},afade=t=in:st=0:d=0.3,afade=t=out:st=${bg_fade_out_adjusted}:d=2[bg];[0:a]adelay=${voice_delay_ms}|${voice_delay_ms}[v];[v][bg]amix=inputs=2:duration=longest[out]" \
+        -filter_complex "[1:a]volume=${volume},afade=t=in:st=0:d=0.3,afade=t=out:st=${bg_fade_out_adjusted}:d=2[bg];[0:a]adelay=${voice_delay_ms}|${voice_delay_ms},volume=1.5[v];[v][bg]amix=inputs=2:duration=longest:normalize=0[out]" \
         -map "[out]" $audio_settings -t "$total_duration" "$output" 2>/dev/null || {
         echo "Warning: Background mixing failed, using voice only" >&2
         cp "$voice" "$output"

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

@@ -108,6 +108,81 @@ try {
         # "high" = full text
     }
 
+    # --- Pre-synthesize WAV before acquiring mutex so synthesis overlaps with previous agent's playback ---
+    $PreSynthWav = $null
+    try {
+        # Resolve agent voice from voice map
+        $VoiceMapLocal  = if ($ProjectRoot) { Join-Path $ProjectRoot ".agentvibes\bmad-voice-map.json" } else { $null }
+        $VoiceMapGlobal = Join-Path $env:USERPROFILE ".agentvibes\bmad-voice-map.json"
+        $VoiceMapFile   = if ($VoiceMapLocal -and (Test-Path $VoiceMapLocal)) { $VoiceMapLocal }
+                          elseif (Test-Path $VoiceMapGlobal) { $VoiceMapGlobal }
+                          else { $null }
+
+        $AgentVoiceName = $null
+        $SpeakerId      = $null
+        if ($VoiceMapFile) {
+            $vm = Get-Content $VoiceMapFile -Raw | ConvertFrom-Json
+            $profile = $vm.agents.$AgentId
+            if ($profile -and $profile.voice) {
+                $raw = $profile.voice
+                if ($raw -match '::') {
+                    $parts = $raw -split '::'
+                    $AgentVoiceName = $parts[0]
+                    $SpeakerName = if ($parts.Length -ge 2) { $parts[1] } else { "" }
+                    # NOTE: The suffix number (e.g. "14" in "Yara-14") is a display disambiguator,
+                    # NOT the piper speaker index. Must look up real index from speaker_id_map.
+                    if ($SpeakerName) {
+                        $VoicesDir = "$env:USERPROFILE\.claude\piper-voices"
+                        $OnnxJsonPath = "$VoicesDir\$AgentVoiceName.onnx.json"
+                        if (Test-Path $OnnxJsonPath) {
+                            try {
+                                $onnxData = Get-Content $OnnxJsonPath -Raw -Encoding UTF8 | ConvertFrom-Json
+                                $speakerIdMap = $onnxData.speaker_id_map
+                                if ($speakerIdMap -and $speakerIdMap.PSObject.Properties[$SpeakerName]) {
+                                    $SpeakerId = [string]$speakerIdMap.PSObject.Properties[$SpeakerName].Value
+                                }
+                            } catch { }
+                        }
+                    }
+                } else {
+                    $AgentVoiceName = $raw
+                }
+            }
+        }
+
+        # Locate piper
+        $PiperExe = "$env:LOCALAPPDATA\Programs\Piper\piper.exe"
+        if (-not (Test-Path $PiperExe)) {
+            $found = Get-Command piper.exe -ErrorAction SilentlyContinue
+            if ($found) { $PiperExe = $found.Source }
+        }
+
+        if (Test-Path $PiperExe) {
+            $VoicesDir = "$env:USERPROFILE\.claude\piper-voices"
+            # Fall back to first available voice if agent voice not found
+            if (-not $AgentVoiceName) {
+                $first = Get-ChildItem $VoicesDir -Filter "*.onnx" -ErrorAction SilentlyContinue | Select-Object -First 1
+                if ($first) { $AgentVoiceName = $first.BaseName }
+            }
+            if ($AgentVoiceName -and ($AgentVoiceName -match '^[a-zA-Z0-9_\-\.]+$')) {
+                $VoiceModel = Join-Path $VoicesDir "$AgentVoiceName.onnx"
+                if (Test-Path $VoiceModel) {
+                    $AudioDir = "$env:USERPROFILE\.claude\audio"
+                    if (-not (Test-Path $AudioDir)) { New-Item -ItemType Directory -Path $AudioDir -Force | Out-Null }
+                    $PreSynthWav = Join-Path $AudioDir "tts-presynth-$([System.IO.Path]::GetRandomFileName() -replace '\..*').wav"
+                    $piperArgs = @("--model", $VoiceModel, "--output-file", $PreSynthWav)
+                    if ($SpeakerId) { $piperArgs += @("--speaker", $SpeakerId) }
+                    $ResponseText | & $PiperExe @piperArgs 2>$null
+                    if (-not (Test-Path $PreSynthWav) -or (Get-Item $PreSynthWav).Length -eq 0) {
+                        $PreSynthWav = $null
+                    }
+                }
+            }
+        }
+    } catch {
+        $PreSynthWav = $null  # degrade gracefully — will synthesize inside mutex instead
+    }
+
     # --- Speak with queue serialization (named mutex, cross-process) ---
     $mutex = New-Object System.Threading.Mutex($false, "AgentVibesPartyModeTTSQueue")
     try {
@@ -122,9 +197,15 @@ try {
 
         if ($acquired) {
             try {
+                # Pass pre-synthesized WAV path so play-tts.ps1 skips synthesis (reduces gap between agents)
+                if ($PreSynthWav) { $env:AGENTVIBES_PRESYNTHESIZED_WAV = $PreSynthWav }
                 # Pass positional args directly after -File (spaces handled by quoting via array)
                 & powershell -NoProfile -ExecutionPolicy Bypass -File $BmadSpeak $AgentId $ResponseText
             } finally {
+                $env:AGENTVIBES_PRESYNTHESIZED_WAV = ""
+                if ($PreSynthWav -and (Test-Path $PreSynthWav)) {
+                    Remove-Item $PreSynthWav -Force -ErrorAction SilentlyContinue
+                }
                 $mutex.ReleaseMutex()
             }
         } else {

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

@@ -50,6 +50,7 @@ $VoiceMapGlobal = Join-Path $env:USERPROFILE ".agentvibes\bmad-voice-map.json"
 $VoiceMapFile   = if (Test-Path $VoiceMapLocal) { $VoiceMapLocal } else { $VoiceMapGlobal }
 
 $AgentVoice     = ""
+$AgentPretext   = ""
 $AgentPersonality = ""
 $AgentBgEnabled = $false
 $AgentBgTrack   = ""
@@ -72,24 +73,35 @@ if (Test-Path $_BgVolFile) {
     $AgentBgVolume = "0.20"
 }
 
-if (Test-Path $VoiceMapFile) {
-    try {
-        $VoiceMap = Get-Content $VoiceMapFile -Raw | ConvertFrom-Json
+# Resolve agent ID and display name/title from manifest (needed for default pretext)
+$AgentDisplayName = ""
+$AgentTitle       = ""
 
-        # Resolve agent ID: match canonical ID or display name prefix
+if (Test-Path $ManifestFile) {
+    try {
         $ManifestRows = Import-Csv $ManifestFile -Encoding UTF8
         foreach ($row in $ManifestRows) {
             $id      = ($row.PSObject.Properties | Select-Object -First 1).Value -replace '^"|"$', ''
             $display = ($row.PSObject.Properties | Select-Object -Skip 1 -First 1).Value -replace '^"|"$', ''
+            $title   = ($row.PSObject.Properties | Select-Object -Skip 2 -First 1).Value -replace '^"|"$', ''
             if ($id -ieq $AgentNameOrId -or $display -like "$AgentNameOrId*") {
-                $AgentId = $id
+                $AgentId          = $id
+                $AgentDisplayName = $display
+                $AgentTitle       = $title
                 break
             }
         }
+    } catch { }
+}
+
+if (Test-Path $VoiceMapFile) {
+    try {
+        $VoiceMap = Get-Content $VoiceMapFile -Raw | ConvertFrom-Json
 
         if ($AgentId -and $VoiceMap.agents.$AgentId) {
             $Profile = $VoiceMap.agents.$AgentId
             if ($Profile.voice)       { $AgentVoice       = $Profile.voice }
+            if ($Profile.pretext)     { $AgentPretext     = $Profile.pretext }
             if ($Profile.personality) { $AgentPersonality = $Profile.personality }
             if ($Profile.backgroundMusic) {
                 $AgentBgEnabled = [bool]$Profile.backgroundMusic.enabled
@@ -105,6 +117,16 @@ if (Test-Path $VoiceMapFile) {
     }
 }
 
+# Fall back to default pretext if none stored: "DisplayName, Title here."
+# Matches AgentVoiceStore.getDefaultPretext() in agent-voice-store.js
+if (-not $AgentPretext -and $AgentDisplayName) {
+    if ($AgentTitle) {
+        $AgentPretext = "$AgentDisplayName, $AgentTitle here."
+    } else {
+        $AgentPretext = "$AgentDisplayName here."
+    }
+}
+
 # ---------------------------------------------------------------------------
 # Locate play-tts.ps1 — prefer project-local, fall back to global
 $PlayTtsLocal  = Join-Path $ProjectRoot ".claude\hooks-windows\play-tts.ps1"
@@ -163,11 +185,14 @@ if ($AgentBgEnabled -and $AgentBgTrack) {
 }
 
 try {
+    # Prepend pretext if configured (e.g. "As your UX designer")
+    $SpeakText = if ($AgentPretext) { "$AgentPretext. $Dialogue" } else { $Dialogue }
+
     # Speak with agent's voice (or global voice if none configured)
     if ($AgentVoice) {
-        & powershell -NoProfile -ExecutionPolicy Bypass -File $PlayTtsScript $Dialogue $AgentVoice
+        & powershell -NoProfile -ExecutionPolicy Bypass -File $PlayTtsScript $SpeakText $AgentVoice
     } else {
-        & powershell -NoProfile -ExecutionPolicy Bypass -File $PlayTtsScript $Dialogue
+        & powershell -NoProfile -ExecutionPolicy Bypass -File $PlayTtsScript $SpeakText
     }
 } finally {
     # Restore personality

package/.claude/hooks-windows/play-tts-piper.ps1

@@ -70,15 +70,52 @@ elseif (Test-Path $VoiceFile) {
     $VoiceName = (Get-Content $VoiceFile -Raw).Trim()
 }
 
-# Strip display name suffix (e.g. "en_US-libritts-high::Bella-9" -> "en_US-libritts-high")
-# and extract speaker ID if present (works for both override and file)
+# Strip display name suffix (e.g. "en_US-libritts-high::Holly-7" -> "en_US-libritts-high")
+# and resolve the real Piper speaker index.
+# IMPORTANT: The trailing number in a speaker name (e.g. "Holly-7") is a disambiguation
+# suffix, NOT the speaker index. Real index must be looked up from voice-assignments.json.
 if ($VoiceName -match '::') {
     $parts = $VoiceName -split '::'
     $VoiceName = $parts[0]
-    if ($parts.Length -ge 2 -and $parts[1] -match '-(\d+)$') {
-        $env:PIPER_SPEAKER = $Matches[1]
-    } else {
-        Remove-Item env:PIPER_SPEAKER -ErrorAction SilentlyContinue
+    $SpeakerName = if ($parts.Length -ge 2) { $parts[1] } else { "" }
+    Remove-Item env:PIPER_SPEAKER -ErrorAction SilentlyContinue
+
+    if ($SpeakerName) {
+        # Primary: look up in voice-assignments.json catalog (libritts_speakers keyed by speaker index)
+        # Derive project root from this script's location: .claude/hooks-windows/ -> project root
+        $PiperScriptRoot = Split-Path -Parent $MyInvocation.MyCommand.Path
+        $PiperProjectRoot = Split-Path -Parent (Split-Path -Parent $PiperScriptRoot)
+        $VoiceAssignmentsPath = Join-Path $PiperProjectRoot "voice-assignments.json"
+        # Fallback: global AgentVibes install if not found in project
+        if (-not (Test-Path $VoiceAssignmentsPath)) {
+            $VoiceAssignmentsPath = Join-Path $env:USERPROFILE "AgentVibes\voice-assignments.json"
+        }
+        $SpeakerResolved = $false
+        if (Test-Path $VoiceAssignmentsPath) {
+            try {
+                $vaData = Get-Content $VoiceAssignmentsPath -Raw | ConvertFrom-Json
+                foreach ($prop in $vaData.libritts_speakers.PSObject.Properties) {
+                    if ($prop.Value.voice_name -eq $SpeakerName) {
+                        $env:PIPER_SPEAKER = $prop.Name
+                        $SpeakerResolved = $true
+                        break
+                    }
+                }
+            } catch { }
+        }
+        # Fallback: check patched speaker_id_map in the .onnx.json
+        if (-not $SpeakerResolved) {
+            $OnnxJsonPath = "$VoicesDir\$VoiceName.onnx.json"
+            if (Test-Path $OnnxJsonPath) {
+                try {
+                    $onnxData = Get-Content $OnnxJsonPath -Raw | ConvertFrom-Json
+                    $speakerIdMap = $onnxData.speaker_id_map
+                    if ($speakerIdMap -and $speakerIdMap.PSObject.Properties[$SpeakerName]) {
+                        $env:PIPER_SPEAKER = [string]$speakerIdMap.PSObject.Properties[$SpeakerName].Value
+                    }
+                } catch { }
+            }
+        }
     }
 } else {
     # No multi-speaker syntax — clear any stale speaker env var

package/.claude/hooks-windows/play-tts.ps1

@@ -128,58 +128,85 @@ if ($BgEnabled -or $HasReverb) {
     }
 }
 
+# Check for pre-synthesized WAV (party mode optimization — synthesis done before mutex acquisition)
+$PreSynthWav = $env:AGENTVIBES_PRESYNTHESIZED_WAV
+$UsePreSynth = $PreSynthWav -and (Test-Path $PreSynthWav) -and
+    (Get-Item $PreSynthWav -ErrorAction SilentlyContinue).Length -gt 0
+
 # If background music or reverb enabled and ffmpeg available, tell provider to skip playback
 if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
     $env:AGENTVIBES_NO_PLAY = "1"
 }
 
-# Call the provider script
+# Call the provider script (skip if using pre-synthesized audio)
 # When post-processing (reverb/music), capture output preserving InformationRecord colors.
 # Otherwise call directly so Write-Host colors pass through to the terminal.
 $NeedsPostProcess = ($BgEnabled -or $HasReverb) -and $HasFfmpeg
-try {
-    if ($NeedsPostProcess) {
-        if ($VoiceOverride) {
-            $providerOutput = & $ProviderScript $Text $VoiceOverride 6>&1 2>&1
-        } else {
-            $providerOutput = & $ProviderScript $Text 6>&1 2>&1
+if ($UsePreSynth) {
+    Write-Host "[SYNTH] Using pre-synthesized audio..." -ForegroundColor Cyan
+    # If no post-processing needed, play the pre-synth file directly and exit
+    if (-not $NeedsPostProcess) {
+        $player = $null
+        try {
+            $player = New-Object System.Media.SoundPlayer $PreSynthWav
+            $player.PlaySync()
+        } catch {
+            Write-Host "[WARNING] Pre-synth playback failed: $_" -ForegroundColor Yellow
+        } finally {
+            if ($player) { $player.Dispose() }
         }
-        # Re-emit preserving colors from InformationRecords (Write-Host output)
-        foreach ($item in $providerOutput) {
-            if ($item -is [System.Management.Automation.InformationRecord]) {
-                $msg = $item.MessageData
-                if ($msg -is [System.Management.Automation.HostInformationMessage]) {
-                    Write-Host $msg.Message -ForegroundColor $msg.ForegroundColor -NoNewline:$msg.NoNewLine
-                    if (-not $msg.NoNewLine) { Write-Host }
+        Remove-Item env:AGENTVIBES_NO_PLAY -ErrorAction SilentlyContinue
+        exit 0
+    }
+} else {
+    try {
+        if ($NeedsPostProcess) {
+            if ($VoiceOverride) {
+                $providerOutput = & $ProviderScript $Text $VoiceOverride 6>&1 2>&1
+            } else {
+                $providerOutput = & $ProviderScript $Text 6>&1 2>&1
+            }
+            # Re-emit preserving colors from InformationRecords (Write-Host output)
+            foreach ($item in $providerOutput) {
+                if ($item -is [System.Management.Automation.InformationRecord]) {
+                    $msg = $item.MessageData
+                    if ($msg -is [System.Management.Automation.HostInformationMessage]) {
+                        Write-Host $msg.Message -ForegroundColor $msg.ForegroundColor -NoNewline:$msg.NoNewLine
+                        if (-not $msg.NoNewLine) { Write-Host }
+                    } else {
+                        Write-Host "$item"
+                    }
                 } else {
                     Write-Host "$item"
                 }
-            } else {
-                Write-Host "$item"
             }
-        }
-    } else {
-        if ($VoiceOverride) {
-            & $ProviderScript $Text $VoiceOverride
         } else {
-            & $ProviderScript $Text
+            if ($VoiceOverride) {
+                & $ProviderScript $Text $VoiceOverride
+            } else {
+                & $ProviderScript $Text
+            }
         }
     }
-}
-catch {
-    Write-Host "[ERROR] TTS Error: $_" -ForegroundColor Red
-    Remove-Item env:AGENTVIBES_NO_PLAY -ErrorAction SilentlyContinue
-    exit 1
+    catch {
+        Write-Host "[ERROR] TTS Error: $_" -ForegroundColor Red
+        Remove-Item env:AGENTVIBES_NO_PLAY -ErrorAction SilentlyContinue
+        exit 1
+    }
 }
 
 # Apply reverb and/or mix with background music
 if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
     Remove-Item env:AGENTVIBES_NO_PLAY -ErrorAction SilentlyContinue
 
-    # Find the most recent TTS wav file
+    # Find the WAV to post-process: use pre-synthesized file if available, else most recent
     $AudioDir = "$ClaudeDir\audio"
-    $RecentWav = Get-ChildItem -Path $AudioDir -Filter "tts-*.wav" -ErrorAction SilentlyContinue |
-        Sort-Object LastWriteTime -Descending | Select-Object -First 1
+    $RecentWav = if ($UsePreSynth) {
+        Get-Item $PreSynthWav -ErrorAction SilentlyContinue
+    } else {
+        Get-ChildItem -Path $AudioDir -Filter "tts-*.wav" -ErrorAction SilentlyContinue |
+            Sort-Object LastWriteTime -Descending | Select-Object -First 1
+    }
 
     if ($RecentWav -and $RecentWav.Length -gt 0) {
         $voicePath = $RecentWav.FullName
@@ -282,7 +309,7 @@ if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
                     $fadeOutStart = $totalDuration - 2
 
                     # Filter: music fades in 0.5s, voice delayed 2s, music fades out last 2s
-                    $filter = "[0:a]volume=${BgVolume},afade=t=in:d=0.5,afade=t=out:st=${fadeOutStart}:d=2[bg];[1:a]adelay=2000|2000,apad=pad_dur=2[voice];[bg][voice]amix=inputs=2:duration=longest:dropout_transition=2[out]"
+                    $filter = "[0:a]volume=${BgVolume},afade=t=in:d=0.5,afade=t=out:st=${fadeOutStart}:d=2[bg];[1:a]adelay=1000|1000,volume=1.5,apad=pad_dur=2[voice];[bg][voice]amix=inputs=2:duration=longest:dropout_transition=2:normalize=0[out]"
 
                     # Run ffmpeg - use Start-Process to avoid stderr issues with $ErrorActionPreference
                     $ffmpegArgs = "-y -stream_loop -1 -i `"$BgTrackPath`" -i `"$voicePath`" -filter_complex `"$filter`" -map `"[out]`" -t $totalDuration `"$MixedFile`""

package/.mcp.json

@@ -1,5 +1,12 @@
 {
   "mcpServers": {
+    "firecrawl-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "firecrawl-mcp"
+      ]
+    },
     "agentvibes": {
       "command": "npx",
       "args": [

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**: v4.5
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v4.6.2
 
 ---
 
@@ -40,7 +40,69 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or running Ope
 
 ---
 
-## 🌟 NEW IN v4.5 — "Speak Every Language" Release
+## 🐛 NEW IN v4.6.2 — Party Mode Voices, LibriTTS Speaker Fix, Agent Pretext
+
+- **Party mode agents now speak in their unique voices** — SKILL.md wired to `bmad-speak.ps1` per agent
+- **LibriTTS speaker IDs resolved correctly** — `Holly-7` is speaker 322, not 7
+- **Agent pretext spoken on Windows** — "Mary, Business Analyst here." before every response
+- **`parseMultiSpeaker` fallback** — works on fresh installs before `.onnx.json` is patched
+
+---
+
+## 🌟 NEW IN v4.6.1 — Party Mode Voice Clarity + Agent Config UI Polish
+
+### 🔊 Voice Volume Fixed in Party Mode
+
+- **`normalize=0`** added to ffmpeg `amix` — prevents voices being silenced to 50% when mixed with background music
+- **Voice boost `volume=1.5`** applied to every TTS stream — agents are now loud and clear
+- **Music intro reduced to 1 second** (`adelay=1000`) — less dead air before each agent speaks
+- **Pre-synthesis gap reduction** — WAV files are generated *before* acquiring the mutex, so synthesis overlaps with the previous agent's playback (gap drops from ~4–6s to ~1s)
+
+### 🎛️ BMAD Agent Config — Preview + Split Fields
+
+- **Music Track** and **Music Vol** are now separate fields in the agent editor — each opens its own dialog
+- **Preview button** plays the selected voice with full effects: personality, reverb, background music track and volume
+- **Blinking indicator** (`►█`) highlights the focused button — reuses the shared `attachBtnBlink` utility
+- **Preview spinner** animates while audio is playing
+- **Tab→Save hint** shown in the volume input dialog
+
+### 🚻 Voice Gender Auto-Assign Fixed
+
+- `inferGender` now strips the numeric suffix from LibriTTS speaker names (e.g. `anna-9` → `anna`) before looking up gender
+- Expanded `GENDER_MAP` with 60+ first names covering all bundled voices
+- `libritts` blanket-male override removed — LibriTTS voices are now inferred per-name
+
+### 🐛 Other Fixes
+
+- Volume dialog text now uses `cyan`/`white` — no more invisible-on-dark-background instructions
+- After saving agent settings, focus correctly returns to the agent list (Enter re-opens the agent)
+- Boundary navigation in agent fields no longer jumps to buttons prematurely
+
+---
+
+## 🌟 NEW IN v4.6 — Party Mode Auto-Install + Volume Fix
+
+### 🎉 BMAD Party Mode TTS — Zero Setup
+
+Every agent now speaks automatically in any BMAD project — no manual hook configuration needed:
+
+- Installer copies `bmad-party-speak.sh` (Linux/macOS/WSL) or `bmad-party-speak.ps1` (Windows) to `~/.claude/hooks/`
+- `PostToolUse` hook registered in `~/.claude/settings.json` automatically
+- `npx agentvibes update` keeps the scripts fresh across all platforms
+
+### 🔊 Background Music Volume Default: 20%
+
+All volume defaults lowered from 70% to 20% — new installs and agents start at a sensible level. `bmad-speak` scripts now inherit the global volume setting instead of ignoring it.
+
+### 🐛 Installer Navigation Fix
+
+Pressing ← on the completion screen no longer jumps back to the installation step.
+
+### 🧪 628 Tests, Zero Failures
+
+---
+
+## 🌟 v4.5 — "Speak Every Language" Release
 
 ### 🌍 Multilingual TUI — 9 Languages
 

package/RELEASE_NOTES.md

@@ -1,5 +1,46 @@
 # AgentVibes Release Notes
 
+## 🐛 v4.6.3 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fixes
+
+- **Party mode pre-synthesis uses wrong speaker for every agent** — `bmad-party-speak.ps1` extracted the trailing number from the display name suffix (e.g. `14` from `Yara-14`) and passed it directly as the piper `--speaker` index. The display suffix is a human-readable disambiguator, not the model index. `Yara-14` is speaker 860, but the bug caused piper to speak as speaker 14 ("Ivy") instead. Every configured agent was silently playing a completely different voice. The fix looks up the full speaker name in `speaker_id_map` from the `.onnx.json` file, matching what `play-tts-piper.ps1` already does correctly. Fixes [#165](https://github.com/paulpreibisch/AgentVibes/issues/165).
+
+### Testing
+
+- **New cross-platform test: `bmad-party-speak-speaker-id.test.js`** — 15 tests covering correct `speaker_id_map` lookup for all 8 configured agents, plain names without suffixes (e.g. `Evan`), missing model graceful degradation, and a regression suite that verifies the correct index disagrees with the naive suffix extraction for every agent.
+
+### User Impact
+
+- Party mode agents now speak with their correct configured voices (the voices shown in the BMAD Agents tab)
+- No configuration changes needed — the fix is automatic
+
+---
+
+## 🐛 v4.6.2 — Patch Release
+
+**Release Date:** April 2026
+
+### Bug Fixes
+
+- **BMAD party mode: agents now speak with their unique voices** — The party mode `SKILL.md` was missing TTS wiring entirely. It now creates `.bmad-agent-context` on activation, calls `bmad-speak.ps1` sequentially per agent after each round, and cleans up on exit. When BMAD and AgentVibes are both installed, AgentVibes' skill now correctly overrides the BMAD version.
+
+- **LibriTTS speaker IDs resolved correctly on Windows** — `play-tts-piper.ps1` was extracting the speaker index via a regex on the voice name suffix (e.g. `Holly-7` → `7`). That suffix is a disambiguation counter, not the Piper speaker index. `Holly-7` is actually speaker 322. The script now looks up the real index from `voice-assignments.json`, with a fallback to the patched `.onnx.json`.
+
+- **LibriTTS `parseMultiSpeaker` fallback for unpatched models** — `voices-tab.js` now falls back to `voice-assignments.json` when the `.onnx.json` speaker map hasn't been patched yet with friendly names, preventing silent fallback to speaker 0 (often male) on fresh installs.
+
+- **Agent pretext spoken on Windows** — `bmad-speak.ps1` never read or applied the agent's configured pretext. It now reads `pretext` from the voice map profile, and falls back to the default `"DisplayName, Title here."` computed from the agent manifest — matching the behaviour of `bmad-speak.sh` and `AgentVoiceStore.getDefaultPretext()`.
+
+### User Impact
+
+- Party mode agents will introduce themselves by role before speaking and use their individually configured voices throughout the conversation
+- LibriTTS multi-speaker voices now reliably map to the correct speaker on first install (no manual patching required)
+- No breaking changes — all fixes are silent fallbacks or missing behaviours being added
+
+---
+
 ## ✨ v4.6.0 — Minor Release
 
 **Release Date:** April 2026