agentvibes 5.1.4 → 5.2.0

package/.claude/hooks-windows/download-extra-voices.ps1

@@ -1,185 +1,243 @@
-#
-# File: .claude/hooks-windows/download-extra-voices.ps1
-#
-# AgentVibes - Download Extra Piper Voice Models (Windows)
-# Downloads custom high-quality voices from HuggingFace
-#
-
-param(
-    [switch]$yes
-)
-
-$AUTO_YES = $yes -or ($args -contains "--yes") -or ($args -contains "-y")
-
-# Configuration
-$VoiceDir = "$env:USERPROFILE\.claude\piper-voices"
-$PiperExe = "$env:LOCALAPPDATA\Programs\Piper\piper.exe"
-
-# HuggingFace repository for custom voices
-$HuggingFaceRepo = "agentvibes/piper-custom-voices"
-$HuggingFaceBaseUrl = "https://huggingface.co/$HuggingFaceRepo/resolve/main"
-
-# Extra custom voices to download
-$ExtraVoices = @(
-    @{
-        name = "kristin"
-        description = "Kristin (US English female, Public Domain, 64MB)"
-        sizeMB = 64
-    },
-    @{
-        name = "jenny"
-        description = "Jenny (UK English female with Irish accent, CC BY, 64MB)"
-        sizeMB = 64
-    },
-    @{
-        name = "16Speakers"
-        description = "Tracy/16Speakers (Multi-speaker: 12 US + 4 UK voices, Public Domain, 77MB)"
-        sizeMB = 77
-    }
-)
-
-Write-Host ""
-Write-Host "AgentVibes Extra Voice Downloader" -ForegroundColor Cyan
-Write-Host ("=" * 40) -ForegroundColor Cyan
-Write-Host ""
-Write-Host "This will download high-quality custom Piper voices from HuggingFace."
-Write-Host ""
-
-# Check if Piper is installed
-if (-not (Test-Path $PiperExe)) {
-    Write-Host "[ERROR] Piper not found at: $PiperExe" -ForegroundColor Red
-    Write-Host "Run: .\setup-windows.ps1 to install Piper" -ForegroundColor Yellow
-    exit 1
-}
-
-# Create voice directory
-if (-not (Test-Path $VoiceDir)) {
-    New-Item -ItemType Directory -Path $VoiceDir -Force | Out-Null
-}
-
-Write-Host "Voice directory: $VoiceDir" -ForegroundColor Gray
-Write-Host ""
-
-# Check status of each voice
-$alreadyDownloaded = @()
-$needDownload = @()
-
-foreach ($voice in $ExtraVoices) {
-    $modelFile = "$VoiceDir\$($voice.name).onnx"
-    $configFile = "$VoiceDir\$($voice.name).onnx.json"
-
-    if ((Test-Path $modelFile) -and (Test-Path $configFile)) {
-        $alreadyDownloaded += $voice
-    } else {
-        $needDownload += $voice
-    }
-}
-
-Write-Host "Status:" -ForegroundColor Cyan
-Write-Host "   Already downloaded: $($alreadyDownloaded.Count) voice(s)"
-Write-Host "   Need to download: $($needDownload.Count) voice(s)"
-Write-Host ""
-
-if ($alreadyDownloaded.Count -gt 0) {
-    Write-Host "Already downloaded (skipped):" -ForegroundColor Green
-    foreach ($voice in $alreadyDownloaded) {
-        Write-Host "   [OK] $($voice.description)" -ForegroundColor Green
-    }
-    Write-Host ""
-}
-
-if ($needDownload.Count -eq 0) {
-    Write-Host "All extra voices already downloaded!" -ForegroundColor Green
-    exit 0
-}
-
-# Calculate total size
-$totalSizeMB = ($needDownload | Measure-Object -Property sizeMB -Sum).Sum
-
-Write-Host "Voices to download:" -ForegroundColor Yellow
-foreach ($voice in $needDownload) {
-    Write-Host "   - $($voice.description)"
-}
-Write-Host ""
-Write-Host "Total download size: ~${totalSizeMB}MB" -ForegroundColor Yellow
-Write-Host ""
-
-# Confirm download
-if (-not $AUTO_YES) {
-    $reply = Read-Host "Download $($needDownload.Count) extra voice(s)? [Y/n]"
-    if ($reply -and $reply -notmatch '^[Yy]') {
-        Write-Host "Download cancelled" -ForegroundColor Red
-        exit 0
-    }
-} else {
-    Write-Host "Auto-downloading $($needDownload.Count) extra voice(s)..." -ForegroundColor Cyan
-    Write-Host ""
-}
-
-# Download each voice
-$downloaded = 0
-$failed = 0
-
-foreach ($voice in $needDownload) {
-    $voiceName = $voice.name
-    Write-Host ""
-    Write-Host "Downloading: $($voice.description)..." -ForegroundColor Cyan
-
-    $modelUrl = "$HuggingFaceBaseUrl/$voiceName.onnx"
-    $jsonUrl = "$HuggingFaceBaseUrl/$voiceName.onnx.json"
-    $modelFile = "$VoiceDir\$voiceName.onnx"
-    $jsonFile = "$VoiceDir\$voiceName.onnx.json"
-
-    $success = $true
-
-    try {
-        Write-Host "   Downloading model file..." -ForegroundColor Yellow
-        Invoke-WebRequest -Uri $modelUrl -OutFile $modelFile -ErrorAction Stop
-
-        Write-Host "   Downloading config file..." -ForegroundColor Yellow
-        Invoke-WebRequest -Uri $jsonUrl -OutFile $jsonFile -ErrorAction Stop
-
-        $modelSize = [math]::Round((Get-Item $modelFile).Length / 1MB, 2)
-        Write-Host "   [OK] Downloaded ($modelSize MB)" -ForegroundColor Green
-    }
-    catch {
-        Write-Host "   [ERROR] Failed to download: $_" -ForegroundColor Red
-        $success = $false
-        # Clean up partial downloads
-        Remove-Item -Path $modelFile -ErrorAction SilentlyContinue
-        Remove-Item -Path $jsonFile -ErrorAction SilentlyContinue
-    }
-
-    if ($success) {
-        $downloaded++
-        Write-Host "   Successfully downloaded: $voiceName" -ForegroundColor Green
-    } else {
-        $failed++
-    }
-}
-
-Write-Host ""
-Write-Host ("=" * 40) -ForegroundColor Cyan
-Write-Host "Download Summary:" -ForegroundColor Cyan
-Write-Host "   Successfully downloaded: $downloaded" -ForegroundColor Green
-if ($failed -gt 0) {
-    Write-Host "   Failed: $failed" -ForegroundColor Red
-}
-Write-Host "   Total extra voices available: $($alreadyDownloaded.Count + $downloaded)"
-Write-Host ""
-
-if ($downloaded -gt 0) {
-    Write-Host "Extra voices ready to use!" -ForegroundColor Green
-    Write-Host ""
-    Write-Host "Try them:"
-    Write-Host "   /agent-vibes:provider switch piper"
-    Write-Host "   /agent-vibes:switch kristin"
-    Write-Host "   /agent-vibes:switch jenny"
-    Write-Host "   /agent-vibes:switch 16Speakers"
-}
-
-if ($downloaded -gt 0 -or $alreadyDownloaded.Count -gt 0) {
-    exit 0
-} else {
-    exit 1
-}
+#
+# File: .claude/hooks-windows/download-extra-voices.ps1
+#
+# AgentVibes - Download Extra Piper Voice Models (Windows)
+# Downloads custom high-quality voices from HuggingFace
+#
+
+param(
+    [switch]$yes
+)
+
+$AUTO_YES = $yes -or ($args -contains "--yes") -or ($args -contains "-y")
+
+# Configuration
+$VoiceDir = "$env:USERPROFILE\.claude\piper-voices"
+$PiperExe = "$env:LOCALAPPDATA\Programs\Piper\piper.exe"
+
+# HuggingFace repository for custom voices
+$HuggingFaceRepo = "agentvibes/piper-custom-voices"
+$HuggingFaceBaseUrl = "https://huggingface.co/$HuggingFaceRepo/resolve/main"
+
+# Extra custom voices to download
+$ExtraVoices = @(
+    @{
+        name = "kristin"
+        description = "Kristin (US English female, Public Domain, 64MB)"
+        sizeMB = 64
+    },
+    @{
+        name = "jenny"
+        description = "Jenny (UK English female with Irish accent, CC BY, 64MB)"
+        sizeMB = 64
+    },
+    @{
+        name = "16Speakers"
+        description = "Tracy/16Speakers (Multi-speaker: 12 US + 4 UK voices, Public Domain, 77MB)"
+        sizeMB = 77
+    }
+)
+
+Write-Host ""
+Write-Host "AgentVibes Extra Voice Downloader" -ForegroundColor Cyan
+Write-Host ("=" * 40) -ForegroundColor Cyan
+Write-Host ""
+Write-Host "This will download high-quality custom Piper voices from HuggingFace."
+Write-Host ""
+
+# Check if Piper is installed
+if (-not (Test-Path $PiperExe)) {
+    Write-Host "[ERROR] Piper not found at: $PiperExe" -ForegroundColor Red
+    Write-Host "Run: .\setup-windows.ps1 to install Piper" -ForegroundColor Yellow
+    exit 1
+}
+
+# Create voice directory
+if (-not (Test-Path $VoiceDir)) {
+    New-Item -ItemType Directory -Path $VoiceDir -Force | Out-Null
+}
+
+Write-Host "Voice directory: $VoiceDir" -ForegroundColor Gray
+Write-Host ""
+
+# Check status of each voice
+$alreadyDownloaded = @()
+$needDownload = @()
+
+foreach ($voice in $ExtraVoices) {
+    $modelFile = "$VoiceDir\$($voice.name).onnx"
+    $configFile = "$VoiceDir\$($voice.name).onnx.json"
+
+    if ((Test-Path $modelFile) -and (Test-Path $configFile)) {
+        $alreadyDownloaded += $voice
+    } else {
+        $needDownload += $voice
+    }
+}
+
+Write-Host "Status:" -ForegroundColor Cyan
+Write-Host "   Already downloaded: $($alreadyDownloaded.Count) voice(s)"
+Write-Host "   Need to download: $($needDownload.Count) voice(s)"
+Write-Host ""
+
+if ($alreadyDownloaded.Count -gt 0) {
+    Write-Host "Already downloaded (skipped):" -ForegroundColor Green
+    foreach ($voice in $alreadyDownloaded) {
+        Write-Host "   [OK] $($voice.description)" -ForegroundColor Green
+    }
+    Write-Host ""
+}
+
+if ($needDownload.Count -eq 0) {
+    Write-Host "All extra voices already downloaded!" -ForegroundColor Green
+    exit 0
+}
+
+# Calculate total size
+$totalSizeMB = ($needDownload | Measure-Object -Property sizeMB -Sum).Sum
+
+Write-Host "Voices to download:" -ForegroundColor Yellow
+foreach ($voice in $needDownload) {
+    Write-Host "   - $($voice.description)"
+}
+Write-Host ""
+Write-Host "Total download size: ~${totalSizeMB}MB" -ForegroundColor Yellow
+Write-Host ""
+
+# Confirm download
+if (-not $AUTO_YES) {
+    $reply = Read-Host "Download $($needDownload.Count) extra voice(s)? [Y/n]"
+    if ($reply -and $reply -notmatch '^[Yy]') {
+        Write-Host "Download cancelled" -ForegroundColor Red
+        exit 0
+    }
+} else {
+    Write-Host "Auto-downloading $($needDownload.Count) extra voice(s)..." -ForegroundColor Cyan
+    Write-Host ""
+}
+
+# Download each voice
+$downloaded = 0
+$failed = 0
+
+foreach ($voice in $needDownload) {
+    $voiceName = $voice.name
+    Write-Host ""
+    Write-Host "Downloading: $($voice.description)..." -ForegroundColor Cyan
+
+    $modelUrl = "$HuggingFaceBaseUrl/$voiceName.onnx"
+    $jsonUrl = "$HuggingFaceBaseUrl/$voiceName.onnx.json"
+    $modelFile = "$VoiceDir\$voiceName.onnx"
+    $jsonFile = "$VoiceDir\$voiceName.onnx.json"
+
+    $success = $true
+
+    try {
+        Write-Host "   Downloading model file..." -ForegroundColor Yellow
+        Invoke-WebRequest -Uri $modelUrl -OutFile $modelFile -ErrorAction Stop
+
+        Write-Host "   Downloading config file..." -ForegroundColor Yellow
+        Invoke-WebRequest -Uri $jsonUrl -OutFile $jsonFile -ErrorAction Stop
+
+        $modelSize = [math]::Round((Get-Item $modelFile).Length / 1MB, 2)
+        Write-Host "   [OK] Downloaded ($modelSize MB)" -ForegroundColor Green
+    }
+    catch {
+        Write-Host "   [ERROR] Failed to download: $_" -ForegroundColor Red
+        $success = $false
+        # Clean up partial downloads
+        Remove-Item -Path $modelFile -ErrorAction SilentlyContinue
+        Remove-Item -Path $jsonFile -ErrorAction SilentlyContinue
+    }
+
+    if ($success) {
+        $downloaded++
+        Write-Host "   Successfully downloaded: $voiceName" -ForegroundColor Green
+    } else {
+        $failed++
+    }
+}
+
+# Patch LibriTTS speaker names for any libritts models (existing or just downloaded)
+foreach ($voice in $ExtraVoices) {
+    $voiceName = $voice.name
+    $jsonFile = "$VoiceDir\$voiceName.onnx.json"
+    if ((Test-Path $jsonFile)) {
+        try {
+            $data = Get-Content $jsonFile -Raw | ConvertFrom-Json
+            $sidMap = $data.speaker_id_map
+            if ($sidMap -and ($data.num_speakers -gt 1)) {
+                # Check if already patched (first key doesn't start with 'p' + digits)
+                $firstKey = ($sidMap.PSObject.Properties | Select-Object -First 1).Name
+                if ($firstKey -match '^p\d+$') {
+                    # Find voice-assignments.json
+                    $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+                    $ProjectRoot = Split-Path -Parent (Split-Path -Parent $ScriptDir)
+                    $CatalogPath = Join-Path $ProjectRoot "voice-assignments.json"
+                    if (-not (Test-Path $CatalogPath)) {
+                        # Try npm global install location
+                        $npmRoot = & npm root -g 2>$null
+                        if ($npmRoot) {
+                            $CatalogPath = Join-Path $npmRoot "agentvibes\voice-assignments.json"
+                        }
+                    }
+                    if (Test-Path $CatalogPath) {
+                        $catalog = Get-Content $CatalogPath -Raw | ConvertFrom-Json
+                        $speakers = $catalog.libritts_speakers
+
+                        # Build reverse map: index -> p-name
+                        $indexToP = @{}
+                        foreach ($prop in $sidMap.PSObject.Properties) {
+                            $indexToP[$prop.Value] = $prop.Name
+                        }
+
+                        # Rebuild with friendly names
+                        $newMap = [ordered]@{}
+                        foreach ($entry in $indexToP.GetEnumerator() | Sort-Object Key) {
+                            $idx = [string]$entry.Key
+                            $pname = $entry.Value
+                            $friendly = $speakers.$idx.voice_name
+                            if ($friendly) {
+                                $newMap[$friendly] = [int]$idx
+                            } else {
+                                $newMap[$pname] = [int]$idx
+                            }
+                        }
+
+                        $data.speaker_id_map = $newMap
+                        $data | ConvertTo-Json -Depth 10 | Set-Content $jsonFile -Encoding UTF8
+                        Write-Host "   Patched LibriTTS speaker names to friendly names: $voiceName" -ForegroundColor Green
+                    }
+                }
+            }
+        } catch {
+            # Non-fatal — patching is best-effort
+        }
+    }
+}
+
+Write-Host ""
+Write-Host ("=" * 40) -ForegroundColor Cyan
+Write-Host "Download Summary:" -ForegroundColor Cyan
+Write-Host "   Successfully downloaded: $downloaded" -ForegroundColor Green
+if ($failed -gt 0) {
+    Write-Host "   Failed: $failed" -ForegroundColor Red
+}
+Write-Host "   Total extra voices available: $($alreadyDownloaded.Count + $downloaded)"
+Write-Host ""
+
+if ($downloaded -gt 0) {
+    Write-Host "Extra voices ready to use!" -ForegroundColor Green
+    Write-Host ""
+    Write-Host "Try them:"
+    Write-Host "   /agent-vibes:provider switch piper"
+    Write-Host "   /agent-vibes:switch kristin"
+    Write-Host "   /agent-vibes:switch jenny"
+    Write-Host "   /agent-vibes:switch 16Speakers"
+}
+
+if ($downloaded -gt 0 -or $alreadyDownloaded.Count -gt 0) {
+    exit 0
+} else {
+    exit 1
+}

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

@@ -229,10 +229,15 @@ try {
     Write-Host "[OK] Saved to: $AudioFile" -ForegroundColor Green
     Write-Host "[VOICE] Voice used: $VoiceName (Piper)" -ForegroundColor Green
 
-    # Apply audio effects (reverb, background music) if processor script exists
+    # Apply audio effects (reverb, background music) if processor script exists.
+    # SKIP when AGENTVIBES_NO_PLAY is set — that means the parent play-tts.ps1
+    # will handle reverb/bg-music post-processing itself.  Running audio-processor
+    # here AND letting the parent do its own effects causes double-processing:
+    # this creates .effected.wav which the parent ignores, then the parent applies
+    # effects to the original wav again.
     $ProcessorScript = Join-Path (Split-Path -Parent $MyInvocation.MyCommand.Path) "audio-processor.ps1"
     $ProcessedFile = $AudioFile
-    if (Test-Path $ProcessorScript) {
+    if (-not $env:AGENTVIBES_NO_PLAY -and (Test-Path $ProcessorScript)) {
         # Lookup order: agent name → LLM key (from --llm) → default
         $AgentName = if ($env:AGENTVIBES_AGENT_NAME) { $env:AGENTVIBES_AGENT_NAME } elseif ($env:AGENTVIBES_LLM_KEY) { $env:AGENTVIBES_LLM_KEY } else { "default" }
         $EffectedFile = "$AudioFile.effected.wav"

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

@@ -553,7 +553,7 @@ if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
                     if ($parts.Length -ge 3 -and $parts[2]) {
                         $trackName = $parts[2].Trim()
                         # Validate: filename only, no path separators or traversal
-                        if ($trackName -match '^[a-zA-Z0-9_\-\.]+$') {
+                        if ($trackName -match '^[a-zA-Z0-9_\-\. ]+$') {
                             $DefaultTrack = $trackName
                         }
                     }
@@ -635,3 +635,9 @@ if (($BgEnabled -or $HasReverb) -and $HasFfmpeg) {
 } else {
     Remove-Item env:AGENTVIBES_NO_PLAY -ErrorAction SilentlyContinue
 }
+
+# Explicit exit 0 so that $LASTEXITCODE from native commands (piper.exe,
+# ffmpeg, sox, etc.) doesn't leak through as the process exit code.
+# Without this, bash/Claude Code sees whatever random exit code the last
+# native command returned (e.g. 127) and treats it as a TTS failure.
+exit 0

package/.claude/hooks-windows/session-start-tts.ps1

@@ -56,6 +56,7 @@ $VerbositySection = switch ($Verbosity) {
     "low"    { "## Verbosity: LOW`n- Acknowledgment: Action only`n- Completion: Result + errors only`n- Skip: Reasoning, decisions" }
     "medium" { "## Verbosity: MEDIUM`n- Acknowledgment: Action + key approach`n- Completion: Result + important decisions`n- Include: Major choices only" }
     "high"   { "## Verbosity: HIGH`n- Acknowledgment: Action + approach + why`n- Completion: Result + decisions + trade-offs`n- Include: Full reasoning, alternatives" }
+    "caveman" { "## Verbosity: CAVEMAN`n- Respond terse. All technical substance stays. Only fluff dies.`n- Drop: articles (a/an/the), filler (just/really/basically), pleasantries, hedging`n- Abbreviate: DB/auth/config/req/res/fn/impl. Use arrows (X -> Y). Strip conjunctions.`n- Fragments OK. Short synonyms. Technical terms exact. Code unchanged.`n- Pattern: [thing] [action] [reason]. [next step].`n- TTS: Ultra-short. Max 60 chars." }
     default  { "## Verbosity: LOW`n- Acknowledgment: Action only`n- Completion: Result + errors only" }
 }
 
@@ -86,7 +87,7 @@ $VerbositySection
 4. Keep under 150 chars
 5. Always include errors
 
-Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning
+Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning | caveman=ultra-terse fragments
 
 ## BMAD Agent Voice Routing
 If ``.bmad-agent-context`` exists, check its content: