agentvibes 4.6.6 → 4.6.8

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

@@ -30,7 +30,14 @@ DIALOGUE="${DIALOGUE//\\\$/\$}"
 
 # Strip markdown formatting — prevent Piper from speaking "asterisk asterisk" literally.
 # play-tts-piper.sh also strips via perl, but do it here early as defense-in-depth.
-DIALOGUE=$(printf '%s' "$DIALOGUE" | sed 's/\*\*//g; s/\*//g; s/`//g; s/^[[:space:]]*#\+[[:space:]]*//')
+DIALOGUE=$(printf '%s' "$DIALOGUE" | sed \
+  -e 's/\*\{1,3\}//g' \
+  -e 's/`\{1,3\}[^`]*`\{1,3\}//g' \
+  -e 's/^[[:space:]]*#\{1,6\}[[:space:]]*//g' \
+  -e 's/__//g' -e 's/_//g' \
+  -e 's/\[([^]]*)\]([^)]*)//g' \
+  -e 's/^[[:space:]]*[-*+] //g' \
+  -e 's/^[[:space:]]*[0-9]\+\. //g')
 
 # Check if party mode is enabled
 if [[ -f "$PROJECT_ROOT/.agentvibes/bmad/bmad-party-mode-disabled.flag" ]]; then

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

@@ -47,6 +47,19 @@ try {
     $ResponseText = $ResponseText.Trim()
     if (-not $ResponseText) { exit 0 }
 
+    # Strip markdown so TTS doesn't speak asterisks, hashes, backticks, etc.
+    $ResponseText = $ResponseText -replace '\*{1,3}', ''                    # bold, italic, bold-italic
+    $ResponseText = $ResponseText -replace '`{1,3}[^`]*`{1,3}', ''         # inline code / code blocks
+    $ResponseText = $ResponseText -replace '#{1,6}\s*', ''                  # headings
+    $ResponseText = $ResponseText -replace '_{1,2}', ''                     # underline/italic alt
+    $ResponseText = $ResponseText -replace '\[([^\]]+)\]\([^)]+\)', '$1'    # links → label only
+    $ResponseText = $ResponseText -replace '!\[[^\]]*\]\([^)]+\)', ''       # images
+    $ResponseText = $ResponseText -replace '(?m)^\s*[-*+]\s+', ''           # bullet list markers (multiline)
+    $ResponseText = $ResponseText -replace '(?m)^\s*\d+\.\s+', ''           # numbered list markers
+    $ResponseText = $ResponseText -replace '\\([!$*_`\\])', '$1'            # escaped markdown chars
+    $ResponseText = $ResponseText.Trim()
+    if (-not $ResponseText) { exit 0 }
+
     # --- Resolve paths ---
     $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
     $ProjectRoot = $env:CLAUDE_PROJECT_DIR
@@ -118,11 +131,13 @@ try {
                           elseif (Test-Path $VoiceMapGlobal) { $VoiceMapGlobal }
                           else { $null }
 
-        $AgentVoiceName = $null
-        $SpeakerId      = $null
+        $AgentVoiceName  = $null
+        $SpeakerId       = $null
+        $AgentPretext    = $null
         if ($VoiceMapFile) {
             $vm = Get-Content $VoiceMapFile -Raw | ConvertFrom-Json
             $profile = $vm.agents.$AgentId
+            if ($profile -and $profile.pretext) { $AgentPretext = $profile.pretext }
             if ($profile -and $profile.voice) {
                 $raw = $profile.voice
                 if ($raw -match '::') {
@@ -150,6 +165,40 @@ try {
             }
         }
 
+        # Fallback: parse bmad-voices.md markdown table if no JSON voice map found
+        if (-not $AgentPretext -and $ProjectRoot) {
+            $VoicesMdPaths = @(
+                (Join-Path $ProjectRoot ".agentvibes\bmad\bmad-voices.md"),
+                (Join-Path $env:USERPROFILE ".agentvibes\bmad\bmad-voices.md")
+            )
+            foreach ($mdPath in $VoicesMdPaths) {
+                if (-not (Test-Path $mdPath)) { continue }
+                $mdLines = Get-Content $mdPath -Encoding UTF8
+                # Strip bmad-agent- prefix for matching (manifest uses bmad-agent-pm, table uses pm)
+                $shortId = $AgentId -replace '^bmad-agent-', ''
+                foreach ($mdLine in $mdLines) {
+                    if ($mdLine -notmatch '^\|') { continue }
+                    if ($mdLine -match '^\|-') { continue }  # separator row
+                    if ($mdLine -match 'Agent ID') { continue }  # header row
+                    $cols = $mdLine -split '\|' | ForEach-Object { $_.Trim() }
+                    # cols: [0]=empty, [1]=Agent ID, [2]=Agent Name, [3]=Intro, [4]=Piper TTS Voice, [5]=Piper Voice, [6]=Personality
+                    if ($cols.Count -lt 6) { continue }
+                    $tableId = $cols[1]
+                    $tableName = $cols[2]
+                    if ($tableId -ieq $shortId -or $tableId -ieq $AgentId -or $tableName -like "*$DisplayName*") {
+                        if ($cols[3]) { $AgentPretext = $cols[3] }
+                        # Use Piper Voice column (index 5) for piper provider
+                        if (-not $AgentVoiceName -and $cols[5]) { $AgentVoiceName = $cols[5] }
+                        if ($cols.Count -ge 7 -and $cols[6] -and $cols[6] -ine 'normal') {
+                            # personality available for bmad-speak.ps1 downstream
+                        }
+                        break
+                    }
+                }
+                if ($AgentPretext) { break }
+            }
+        }
+
         # Locate piper
         $PiperExe = "$env:LOCALAPPDATA\Programs\Piper\piper.exe"
         if (-not (Test-Path $PiperExe)) {
@@ -172,7 +221,10 @@ try {
                     $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
+                    # Include pretext in pre-synthesis so it's spoken — bmad-speak.ps1 will
+                    # skip synthesis (AGENTVIBES_PRESYNTHESIZED_WAV set) so pretext must be here.
+                    $PreSynthText = if ($AgentPretext) { "$AgentPretext. $ResponseText" } else { $ResponseText }
+                    $PreSynthText | & $PiperExe @piperArgs 2>$null
                     if (-not (Test-Path $PreSynthWav) -or (Get-Item $PreSynthWav).Length -eq 0) {
                         $PreSynthWav = $null
                     }

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

@@ -27,8 +27,15 @@ if ($env:CLAUDE_PROJECT_DIR -and (Test-Path "$env:CLAUDE_PROJECT_DIR\_bmad")) {
 }
 
 # Strip markdown formatting — prevent SAPI/Piper from speaking asterisks literally
-$Dialogue = $Dialogue -replace '\*\*', '' -replace '\*', '' -replace '`', ''
-$Dialogue = $Dialogue -replace '\\!', '!' -replace '\\\$', '$'
+$Dialogue = $Dialogue -replace '\*{1,3}', ''                              # bold, italic, bold-italic
+$Dialogue = $Dialogue -replace '`{1,3}[^`]*`{1,3}', ''                    # inline code / code blocks
+$Dialogue = $Dialogue -replace '#{1,6}\s*', ''                             # headings
+$Dialogue = $Dialogue -replace '_{1,2}', ''                                # underline/italic alt
+$Dialogue = $Dialogue -replace '\[([^\]]+)\]\([^)]+\)', '$1'               # links → label only
+$Dialogue = $Dialogue -replace '!\[[^\]]*\]\([^)]+\)', ''                  # images
+$Dialogue = $Dialogue -replace '(?m)^\s*[-*+]\s+', ''                      # bullet list markers (multiline)
+$Dialogue = $Dialogue -replace '(?m)^\s*\d+\.\s+', ''                      # numbered list markers
+$Dialogue = $Dialogue -replace '\\([!$*_`\\])', '$1'                       # escaped markdown chars
 
 # Check if party mode is disabled
 $PartyModeDisabledFlag = Join-Path $ProjectRoot ".agentvibes\bmad\bmad-party-mode-disabled.flag"
@@ -117,13 +124,45 @@ if (Test-Path $VoiceMapFile) {
     }
 }
 
+# Fallback: parse bmad-voices.md markdown table if JSON voice map had no data
+if ((-not $AgentPretext -or -not $AgentVoice) -and $AgentId) {
+    $VoicesMdPaths = @(
+        (Join-Path $ProjectRoot ".agentvibes\bmad\bmad-voices.md"),
+        (Join-Path $env:USERPROFILE ".agentvibes\bmad\bmad-voices.md")
+    )
+    $shortId = $AgentId -replace '^bmad-agent-', ''
+    foreach ($mdPath in $VoicesMdPaths) {
+        if (-not (Test-Path $mdPath)) { continue }
+        $mdLines = Get-Content $mdPath -Encoding UTF8
+        foreach ($mdLine in $mdLines) {
+            if ($mdLine -notmatch '^\|') { continue }
+            if ($mdLine -match '^\|-') { continue }
+            if ($mdLine -match 'Agent ID') { continue }
+            $cols = $mdLine -split '\|' | ForEach-Object { $_.Trim() }
+            if ($cols.Count -lt 6) { continue }
+            $tableId = $cols[1]
+            if ($tableId -ieq $shortId -or $tableId -ieq $AgentId -or $tableId -ieq $AgentNameOrId) {
+                if (-not $AgentPretext -and $cols[3]) { $AgentPretext = $cols[3] }
+                if (-not $AgentVoice -and $cols[5]) { $AgentVoice = $cols[5] }
+                if (-not $AgentPersonality -and $cols.Count -ge 7 -and $cols[6] -and $cols[6] -ine 'normal') {
+                    $AgentPersonality = $cols[6]
+                }
+                break
+            }
+        }
+        if ($AgentPretext) { break }
+    }
+}
+
 # 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) {
+if (-not $AgentPretext) {
+    if ($AgentDisplayName -and $AgentTitle) {
         $AgentPretext = "$AgentDisplayName, $AgentTitle here."
-    } else {
+    } elseif ($AgentDisplayName) {
         $AgentPretext = "$AgentDisplayName here."
+    } elseif ($AgentNameOrId) {
+        $AgentPretext = "$AgentNameOrId here."
     }
 }
 

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

@@ -1,124 +1,114 @@
-#
-# File: .claude/hooks-windows/session-start-tts.ps1
-#
-# AgentVibes SessionStart Hook for Windows - Optimized (Issue #80, Phase 1)
-# Token target: ~250 (down from ~500)
-#
-# Prints TTS protocol instructions to stdout so Claude knows to use TTS.
-#
-
-$ErrorActionPreference = "Stop"
-
-# Get script directory
-$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
-
-# Check if AgentVibes is installed
-if (-not (Test-Path (Join-Path $ScriptDir "play-tts.ps1"))) {
-    # AgentVibes not installed, don't inject anything
-    exit 0
-}
-
-# Resolve project .claude dir from script location (avoids CWD-relative path issues)
-$ProjectClaudeDir = Split-Path -Parent (Split-Path -Parent $ScriptDir)
-$ProjectClaudeDir = Join-Path $ProjectClaudeDir ".claude"
-
-# Check for sentiment (priority) or personality (fallback)
-$Sentiment = ""
-$sentimentPaths = @("$ProjectClaudeDir\tts-sentiment.txt", "$env:USERPROFILE\.claude\tts-sentiment.txt")
-foreach ($p in $sentimentPaths) {
-    if (Test-Path $p) {
-        $Sentiment = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
-        if ($Sentiment) { break }
-    }
-}
-
-$Personality = "normal"
-$personalityPaths = @("$ProjectClaudeDir\tts-personality.txt", "$env:USERPROFILE\.claude\tts-personality.txt")
-foreach ($p in $personalityPaths) {
-    if (Test-Path $p) {
-        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
-        if ($val) { $Personality = $val; break }
-    }
-}
-
-# Determine style
-if ($Sentiment) {
-    $Style = $Sentiment
-} else {
-    $Style = $Personality
-}
-
-# Get verbosity level (Issue #32)
-$Verbosity = "low"
-$verbosityPaths = @("$ProjectClaudeDir\tts-verbosity.txt", "$env:USERPROFILE\.claude\tts-verbosity.txt")
-foreach ($p in $verbosityPaths) {
-    if (Test-Path $p) {
-        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
-        if ($val) { $Verbosity = $val; break }
-    }
-}
-
-# Output optimized TTS protocol
-Write-Output @"
-
-# AgentVibes TTS Protocol
-
-**CRITICAL: You MUST execute TTS at TWO points for EVERY user interaction:**
-
-1. **Acknowledgment** - Start of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[action]"``
-2. **Completion** - End of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[result + key details]"``
-
-**Example:**
-``````
-[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Checking git status"]
-[work...]
-[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Repository is clean, no changes"]
-``````
-
-"@
-
-# Add verbosity-specific protocol (Issue #32)
-switch ($Verbosity) {
-    "low" {
-        Write-Output @"
-## Verbosity: LOW
-- Acknowledgment: Action only
-- Completion: Result + errors only
-- Skip: Reasoning, decisions
-
-"@
-    }
-    "medium" {
-        Write-Output @"
-## Verbosity: MEDIUM
-- Acknowledgment: Action + key approach
-- Completion: Result + important decisions
-- Include: Major choices only
-
-"@
-    }
-    "high" {
-        Write-Output @"
-## Verbosity: HIGH
-- Acknowledgment: Action + approach + why
-- Completion: Result + decisions + trade-offs
-- Include: Full reasoning, alternatives
-
-"@
-    }
-}
-
-# Add style info and rules
-Write-Output @"
-## Style: $Style
-
-## Rules
-1. Never skip acknowledgment TTS
-2. Never skip completion TTS
-3. Match verbosity level
-4. Keep under 150 chars
-5. Always include errors
-
-Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning
-
-"@
+#
+# File: .claude/hooks-windows/session-start-tts.ps1
+#
+# AgentVibes SessionStart Hook for Windows
+# Outputs JSON with hookSpecificOutput.additionalContext for reliable context injection.
+# Mirrors session-start-tts.sh — keep both in sync.
+#
+
+$ErrorActionPreference = "Stop"
+
+# Get script directory
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+# Check if AgentVibes is installed
+if (-not (Test-Path (Join-Path $ScriptDir "play-tts.ps1"))) {
+    exit 0
+}
+
+# Resolve project .claude dir from script location (avoids CWD-relative path issues)
+$ProjectClaudeDir = Split-Path -Parent (Split-Path -Parent $ScriptDir)
+$ProjectClaudeDir = Join-Path $ProjectClaudeDir ".claude"
+
+# Check for sentiment (priority) or personality (fallback)
+$Sentiment = ""
+$sentimentPaths = @("$ProjectClaudeDir\tts-sentiment.txt", "$env:USERPROFILE\.claude\tts-sentiment.txt")
+foreach ($p in $sentimentPaths) {
+    if (Test-Path $p) {
+        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
+        if ($val) { $Sentiment = $val; break }
+    }
+}
+
+$Personality = "normal"
+$personalityPaths = @("$ProjectClaudeDir\tts-personality.txt", "$env:USERPROFILE\.claude\tts-personality.txt")
+foreach ($p in $personalityPaths) {
+    if (Test-Path $p) {
+        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
+        if ($val) { $Personality = $val; break }
+    }
+}
+
+$Style = if ($Sentiment) { $Sentiment } else { $Personality }
+
+# Get verbosity level
+$Verbosity = "low"
+$verbosityPaths = @("$ProjectClaudeDir\tts-verbosity.txt", "$env:USERPROFILE\.claude\tts-verbosity.txt")
+foreach ($p in $verbosityPaths) {
+    if (Test-Path $p) {
+        $val = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
+        if ($val) { $Verbosity = $val; break }
+    }
+}
+
+# Build verbosity section
+$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" }
+    default  { "## Verbosity: LOW`n- Acknowledgment: Action only`n- Completion: Result + errors only" }
+}
+
+# Build full context string
+$Context = @"
+# AgentVibes TTS Protocol
+
+**CRITICAL: You MUST execute TTS at TWO points for EVERY user interaction:**
+
+1. **Acknowledgment** - Start of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[action]"``
+2. **Completion** - End of task: ``Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "[result + key details]"``
+
+**Example:**
+``````
+[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Checking git status"]
+[work...]
+[Bash: powershell -NoProfile -ExecutionPolicy Bypass -File ".claude\hooks-windows\play-tts.ps1" "Repository is clean, no changes"]
+``````
+
+$VerbositySection
+
+## Style: $Style
+
+## Rules
+1. Never skip acknowledgment TTS
+2. Never skip completion TTS
+3. Match verbosity level
+4. Keep under 150 chars
+5. Always include errors
+
+Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning
+
+## BMAD Agent Voice Routing
+If ``.bmad-agent-context`` exists, check its content:
+
+**Single agent mode** (content is an agent ID like "analyst"):
+Use ``bmad-speak.ps1`` instead of ``play-tts.ps1``:
+
+
+**Party mode** (content is "party-mode"):
+Each agent speaks via ``bmad-speak.ps1`` with their display name. The queue system ensures sequential playback — agents speak one at a time, not overlapping:
+
+IMPORTANT: In party mode, do NOT use ``play-tts.ps1``. Always use ``bmad-speak.ps1`` with the agent's display name. Do NOT call multiple bmad-speak.ps1 in parallel — call them sequentially so the queue processes them in order.
+
+If ``.bmad-agent-context`` does NOT exist, use ``play-tts.ps1`` as normal.
+"@
+
+# Build JSON via hashtable so ConvertTo-Json handles all escaping (Unicode, backslashes, quotes)
+$Output = @{
+    hookSpecificOutput = @{
+        hookEventName   = "SessionStart"
+        additionalContext = $Context
+    }
+}
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
+Write-Output ($Output | ConvertTo-Json -Compress -Depth 5)

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.6.6
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v4.6.8
 
 ---
 
@@ -41,7 +41,24 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, or running Ope
 
 ---
 
-## 🧭 NEW IN v4.6.6 — Natural TUI Navigation
+## 🐛 NEW IN v4.6.8 — Fresh Install Crash Fix
+
+- **Settings tab crash fixed** — no longer crashes when navigating to Settings on a fresh install with no voice configured
+- **macOS test fix** — replay path assertion handles `/var` → `/private/var` symlink
+- **BMAD pretext parsing improved** — voices pretext extracted correctly from `bmad-voices.md`
+
+---
+
+## 🎙️ v4.6.7 — Party Mode TTS Fixes
+
+- **Agent pretexts now spoken in party mode** — "John, Product Manager here" was being silently dropped due to a pre-synthesis timing bug. Fixed.
+- **No more spoken asterisks** — markdown stripped before TTS in party mode
+- **Windows session start TTS fixed** — hook now outputs proper JSON so TTS activates reliably on session start
+- **PreToolUse hook no longer errors** on grep/regex commands
+
+---
+
+## 🧭 v4.6.6 — Natural TUI Navigation
 
 The Settings TUI now flows the way you'd expect. Down moves top-to-bottom through header → sub-tabs → content → footer. Left/Right switches sub-tabs and moves between footer buttons. Up from content returns to the active sub-tab — not always Voice. The Language tab has a proper scrollable list. Readme falls back to the AgentVibes package README when no local one exists. Escape from the installer no longer gets stuck.
 
@@ -458,7 +475,7 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
   - [🖥️ SSH Receiver](#️-agentvibes-receiver--remote-audio-streaming) - Stream audio from headless servers
   - [💬 Intro Text](#-intro-text-pretext---your-personal-ai-branding) - Custom TTS prefixes
   - [🎵 Custom Background Music](#-custom-background-music---complete-audio-control) - Upload your own tracks
-- [📰 Latest Release](#-latest-release) - v4.6.6 — TUI navigation & UX polish
+- [📰 Latest Release](#-latest-release) - v4.6.7 — Party mode TTS fixes
 - [🪟 Windows Setup Guide for Claude Desktop](mcp-server/WINDOWS_SETUP.md) - Complete Windows installation with WSL & Python
 
 ### AgentVibes MCP (Natural Language Control)
@@ -504,9 +521,9 @@ All 50+ Piper voices AgentVibes provides are sourced from Hugging Face's open-so
 
 ## 📰 Latest Release
 
-**[v4.6.6 - Natural TUI Navigation](https://github.com/paulpreibisch/AgentVibes/releases/tag/v4.6.6)**
+**[v4.6.7 - Party Mode TTS Fixes](https://github.com/paulpreibisch/AgentVibes/releases/tag/v4.6.7)**
 
-The Settings TUI now navigates the way you'd expect — arrow keys flow naturally through the interface, the Language tab has a proper scrollable list, and the Readme tab always has something useful to show.
+Agent pretexts now spoken in party mode, markdown stripped before TTS, Windows session-start hook fixed to inject context reliably, and PreToolUse hook no longer errors on grep commands.
 
 ### 🐛 Recent Fixes (v4.6.3 / v4.6.4)
 

package/RELEASE_NOTES.md

@@ -1,5 +1,46 @@
 # AgentVibes Release Notes
 
+## 🐛 v4.6.8 — Fresh Install Crash Fix
+
+**Release Date:** April 2026
+
+### Bug Fixes
+
+- **Settings tab no longer crashes on fresh install** — `parseMultiSpeaker()` called `.includes()` on a null voice ID when no voice was configured yet. Added a null guard that returns a safe default object. Reported by a user hitting this immediately after the install wizard completed.
+
+- **macOS /var symlink in replay test** — Fixed test assertion that failed on macOS where `/var` is a symlink to `/private/var`, causing replay path comparisons to break.
+
+- **BMAD voices pretext parsing** — `bmad-voices.md` pretext lines are now correctly parsed and markdown is stripped more thoroughly before TTS synthesis.
+
+### User Impact
+
+- New users no longer crash when navigating to Settings after a fresh install
+- Test suite passes reliably on macOS
+
+---
+
+## 🎙️ v4.6.7 — Party Mode TTS Fixes
+
+**Release Date:** April 2026
+
+### Bug Fixes
+
+- **Party mode pretext now spoken** — Agent pretexts (e.g. "John, Product Manager here") were silently dropped. The pre-synthesis step ran on the response text only; when `bmad-speak.ps1` later prepended the pretext, `play-tts.ps1` skipped synthesis because a pre-synthesized WAV was already set. Pre-synthesis now includes the pretext so it's always spoken.
+
+- **Markdown stripped in party mode** — Agents were speaking asterisks, hashes, and backticks literally. `bmad-party-speak.ps1` now strips bold, italic, headings, inline code, links, and bullet markers before TTS — consistent with `bmad-speak.ps1`.
+
+- **Session start hook outputs proper JSON + BMAD routing (Windows)** — `session-start-tts.ps1` was using plain `Write-Output` text which isn't reliably injected as `additionalContext`. Now outputs `hookSpecificOutput` JSON (matching the bash version) and includes BMAD agent voice routing instructions so party mode / single agent mode TTS works correctly on Windows.
+
+- **PreToolUse hook no longer errors on grep/regex commands** — The git-push guard hook used `-match` (regex) which crashed on commands containing `\*`, `\|`, etc. Switched to `-like` wildcard and wrapped in `try/catch` so it exits silently on any non-matching command.
+
+### User Impact
+
+- Party mode agents speak their configured pretext introductions
+- No more spoken asterisks or markdown syntax in party mode
+- Windows TTS now reliably activates on session start
+
+---
+
 ## 🧭 v4.6.6 — Natural TUI Navigation
 
 **Release Date:** April 2026

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "4.6.6",
+  "version": "4.6.8",
   "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/tabs/voices-tab.js

@@ -338,6 +338,7 @@ export const MS_SEP = '::';
  * @returns {{ model: string, speakerId: number|null, speakerName: string|null, isMultiSpeaker: boolean }}
  */
 export function parseMultiSpeaker(voiceId) {
+  if (!voiceId) return { model: voiceId ?? '', speakerId: null, speakerName: null, isMultiSpeaker: false };
   if (voiceId.includes(MS_SEP)) {
     const [model, speakerName] = voiceId.split(MS_SEP, 2);
     const jsonPath = path.join(PIPER_VOICES_DIR, model + '.onnx.json');