agentvibes 5.6.9 → 5.7.0

package/.agentvibes/config.json

@@ -1,40 +1,5 @@
 {
-  "defaultVoice": "libritts-speaker-925",
-  "ttsProvider": "piper",
-  "provider": "soprano",
-  "backgroundMusic": {
-    "enabled": false,
-    "track": "agent_vibes_japanese_city_pop_v1_loop.mp3",
-    "volume": 20
-  },
-  "music": {
-    "enabled": true,
-    "track": "agentvibes_nature_sounds_rain.mp3"
-  },
-  "musicFavorites": [
-    "agentvibes_blues_smooth_guitar.mp3",
-    "agentvibes_lofi_beats_coding.mp3",
-    "agentvibes_nature_sounds_rain.mp3",
-    "agent_vibes_ganawa_ambient_v2_loop.mp3"
-  ],
-  "effects": {
-    "reverb": true,
-    "reverbAmount": 0.6,
-    "pitch": 2,
-    "reverbPreset": "medium"
-  },
-  "verbosity": "high",
-  "personality": "grandpa",
-  "voice": "16Speakers::Cori_Samuel",
-  "pretext": "Agent Vibes Here",
-  "setupCompleted": true,
-  "ttsEngine": "piper",
-  "thumbsUp": [
-    "en_US-libritts-high::Adam",
-    "en_US-libritts_r-medium::Adam-2"
-  ],
-  "favorites": [
-    "en_US-libritts-high::Adam",
-    "en_US-libritts_r-medium::Adam-2"
-  ]
+  "audio_destination": "remote",
+  "audio_ssh_alias": "laptop-win",
+  "setupCompleted": true
 }

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

@@ -1,6 +1,6 @@
 
 llm:default|light||0.15|en_US-lessac-high||piper
-llm:claude-code|light|agent_vibes_chillwave_v2_loop.mp3|0.15|en_US-lessac-high|Claude Code here|piper
+llm:claude-code|light|agent_vibes_cumbia_v1_loop.mp3|0.05|en_US-libritts-high::Mike-3|Ubuntu RDP Agentvibes|piper
 llm:copilot|light|agent_vibes_bossa_nova_v2_loop.mp3|0.15|en_US-libritts-high::Anna-11|Copilot here|piper
 llm:codex|light|agent_vibes_chillwave_v2_loop.mp3|0.15|en_US-lessac-high|Codex here|piper
 llm:hermes|light|agent_vibes_bachata_v1_loop.mp3|0.15|en_US-libritts-high::Leo-8|Hermes here|piper

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

@@ -16,14 +16,12 @@ Agent Vibes Ganawa Ambient v2-loop.mp3:.00000000000000000002815996
 Agent Vibes Tabla Dream Pop v1-loop.mp3:.00000000000000000009067943
 Agent Vibes ChillWave v2-loop.mp3:.00000000000000000007080511
 Agent Vibes Harpsichord v2-loop.mp3:.00000000000000000013140818
-agent_vibes_japanese_city_pop_v1_loop.mp3:6.054512
 agent_vibes_bossa_nova_v2_loop.mp3:5.369524
 agent_vibes_salsa_v2_loop.mp3:9.972790
 agent_vibes_arabic_v2_loop.mp3:.00000000000000000006132724
-agent_vibes_chillwave_v2_loop.mp3:14.628390
-agent_vibes_bachata_v1_loop.mp3:.00000000000000000005344000
-agent_vibes_goa_trance_v2_loop.mp3:.00000000000000000002499918
-agentvibes_soft_flamenco_loop.mp3:.00000000000000000014899091
-agent_vibes_celtic_harp_v1_loop.mp3:5.891973
-agent_vibes_dark_chill_step_loop.mp3:5.717823
-agent_vibes_cumbia_v1_loop.mp3:10.472018
+agent_vibes_cumbia_v1_loop.mp3:.00000000000000000010256000
+agent_vibes_bachata_v1_loop.mp3:5.125714
+agent_vibes_chillwave_v2_loop.mp3:.00000000000000000003308191
+Midnight Charleston Stomp.mp3:.00000000000000000010960000
+agent_vibes_japanese_city_pop_v1_loop.mp3:11.702675
+agentvibes_soft_flamenco_loop.mp3:9.589660

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

@@ -1 +1 @@
-20260509
+20260511

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

@@ -49,7 +49,7 @@ GRAY='\033[0;90m'
 NC='\033[0m' # No Color
 
 # Detect BMAD installation and version
-# Supports both v4 (.bmad-core/) and v6-alpha (.bmad/) installations
+# Supports both v4 (.bmad-core/) and v6-alpha (.bmad/, _bmad/) installations
 detect_bmad() {
   local bmad_core_dir=""
 
@@ -58,6 +58,11 @@ detect_bmad() {
     bmad_core_dir=".bmad"
   elif [[ -d "../.bmad" ]]; then
     bmad_core_dir="../.bmad"
+  # Check for _bmad (current BMAD installer default — underscore prefix, project-local)
+  elif [[ -d "_bmad" ]]; then
+    bmad_core_dir="_bmad"
+  elif [[ -d "../_bmad" ]]; then
+    bmad_core_dir="../_bmad"
   # Check for v6-alpha without dot (legacy naming)
   elif [[ -d "bmad" ]]; then
     bmad_core_dir="bmad"
@@ -73,6 +78,11 @@ detect_bmad() {
     bmad_core_dir="bmad-core"
   elif [[ -d "../bmad-core" ]]; then
     bmad_core_dir="../bmad-core"
+  # Check home-dir global BMAD install (~/_bmad is the default for standalone BMAD installs)
+  elif [[ -d "$HOME/_bmad" ]]; then
+    bmad_core_dir="$HOME/_bmad"
+  elif [[ -d "$HOME/.bmad" ]]; then
+    bmad_core_dir="$HOME/.bmad"
   else
     echo -e "${RED}❌ BMAD installation not found${NC}" >&2
     echo -e "${GRAY}   Looked for bmad/, .bmad-core/, or bmad-core/ directory${NC}" >&2
@@ -85,21 +95,34 @@ detect_bmad() {
 # Find all BMAD agents
 find_agents() {
   local bmad_core="$1"
-  local agents_dir=""
+  local found=0
+
+  # v6.6+: agents under .claude/skills/*/agents/ (new BMAD structure)
+  local skills_dir=".claude/skills"
+  if [[ -d "$skills_dir" ]]; then
+    while IFS= read -r -d '' agent_file; do
+      echo "$agent_file"
+      found=1
+    done < <(find "$skills_dir" -path "*/agents/*.md" -type f -print0 2>/dev/null)
+  fi
 
-  # Check for v6-alpha structure (bmad/bmm/agents/)
+  # v6.x: bmad/bmm/agents/
   if [[ -d "$bmad_core/bmm/agents" ]]; then
-    agents_dir="$bmad_core/bmm/agents"
-  # Check for v4 structure (.bmad-core/agents/)
-  elif [[ -d "$bmad_core/agents" ]]; then
-    agents_dir="$bmad_core/agents"
-  else
+    find "$bmad_core/bmm/agents" -name "*.md" -type f
+    found=1
+  fi
+
+  # v4: .bmad-core/agents/
+  if [[ -d "$bmad_core/agents" ]]; then
+    find "$bmad_core/agents" -name "*.md" -type f
+    found=1
+  fi
+
+  if [[ $found -eq 0 ]]; then
     echo -e "${RED}❌ Agents directory not found in $bmad_core${NC}" >&2
-    echo -e "${GRAY}   Tried: $bmad_core/bmm/agents/ and $bmad_core/agents/${NC}" >&2
+    echo -e "${GRAY}   Tried: $bmad_core/bmm/agents/, $bmad_core/agents/, .claude/skills/*/agents/${NC}" >&2
     return 1
   fi
-
-  find "$agents_dir" -name "*.md" -type f
 }
 
 # Check if agent has TTS injection
@@ -217,6 +240,15 @@ inject_tts() {
     return 0
   fi
 
+  # Detect format BEFORE creating backups — skip v6.6+ plain Markdown agents (no activation section)
+  local is_v6=false
+  if grep -q "<activation" "$agent_file"; then
+    is_v6=true
+  elif ! grep -q "activation-instructions:" "$agent_file"; then
+    echo -e "${GRAY}   ℹ️  Skipped (v6.6+ format): $(basename "$agent_file")${NC}"
+    return 2
+  fi
+
   # Create backup directory for centralized timestamped backups
   local backup_dir=".agentvibes/backups/agents"
   mkdir -p "$backup_dir"
@@ -231,15 +263,6 @@ inject_tts() {
 
   echo -e "${GRAY}   📦 Backup saved: $backup_dir/$backup_name${NC}"
 
-  # Detect v4 vs v6 structure
-  local is_v6=false
-  if grep -q "<activation" "$agent_file"; then
-    is_v6=true
-  elif ! grep -q "activation-instructions:" "$agent_file"; then
-    echo -e "${RED}❌ No activation section found in: $(basename "$agent_file")${NC}"
-    return 1
-  fi
-
   # Create TTS injection script based on version
   if [[ "$is_v6" == "true" ]]; then
     # v6 format: XML-style with <step n="4.5">
@@ -411,6 +434,7 @@ enable_all() {
   local agents=$(find_agents "$bmad_core")
   local success_count=0
   local skip_count=0
+  local format_skip_count=0
   local fail_count=0
 
   # Track modified files and backups for summary
@@ -423,7 +447,10 @@ enable_all() {
       continue
     fi
 
-    if inject_tts "$agent_file"; then
+    inject_tts "$agent_file" && local inject_result=0 || local inject_result=$?
+    if [[ $inject_result -eq 2 ]]; then
+      format_skip_count=$((format_skip_count + 1))
+    elif [[ $inject_result -eq 0 ]]; then
       success_count=$((success_count + 1))
       modified_files+=("$agent_file")
       # Track the backup file that was created
@@ -444,6 +471,7 @@ enable_all() {
   # Show results
   echo -e "${GREEN}✅ Successfully modified: $success_count agents${NC}"
   [[ $skip_count -gt 0 ]] && echo -e "${YELLOW}⏭️  Skipped (already enabled): $skip_count agents${NC}"
+  [[ $format_skip_count -gt 0 ]] && echo -e "${GRAY}   ℹ️  Skipped (v6.6+ format, not supported): $format_skip_count agents${NC}"
   [[ $fail_count -gt 0 ]] && echo -e "${RED}❌ Failed: $fail_count agents${NC}"
   echo ""
 

package/.claude/hooks/provider-commands.sh

@@ -449,6 +449,14 @@ provider_preview() {
   echo "🎤 Voice Preview ($current_provider)"
   echo ""
 
+  # Detect routing LLM so preview audio reaches SSH/remote receivers
+  # (without --llm, play-tts.sh plays locally on headless servers instead of
+  # forwarding to the configured Windows/remote receiver)
+  local _preview_llm _preview_llm_args
+  _preview_llm=$(detect_routing_llm 2>/dev/null || echo "")
+  _preview_llm_args=()
+  [[ -n "$_preview_llm" ]] && _preview_llm_args=(--llm "$_preview_llm")
+
   case "$current_provider" in
     piper)
       # Use the Piper voice manager's list functionality
@@ -468,7 +476,8 @@ provider_preview() {
           if verify_voice "$voice_arg"; then
             echo "🎤 Previewing Piper voice: $voice_arg"
             echo ""
-            "$SCRIPT_DIR/play-tts.sh" "Hello, this is the $voice_arg voice. How do you like it?" "$voice_arg"
+            "$SCRIPT_DIR/play-tts.sh" "Hello, this is the $voice_arg voice. How do you like it?" \
+              "$voice_arg" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
           else
             echo "❌ Voice model not found: $voice_arg"
             echo ""
@@ -506,7 +515,8 @@ provider_preview() {
         local display_name="${voice_entry##*:}"
 
         echo "🔊 ${display_name}..."
-        "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${display_name}" "$voice_name"
+        "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${display_name}" \
+          "$voice_name" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
 
         # Wait for the voice to finish playing before starting next one
         sleep 3
@@ -532,7 +542,8 @@ provider_preview() {
         if say -v ? 2>/dev/null | grep -qi "^${voice_arg} "; then
           echo "🎤 Previewing macOS voice: $voice_arg"
           echo ""
-          "$SCRIPT_DIR/play-tts.sh" "Hello, this is ${voice_arg}. How do you like my voice?" "$voice_arg"
+          "$SCRIPT_DIR/play-tts.sh" "Hello, this is ${voice_arg}. How do you like my voice?" \
+            "$voice_arg" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
         else
           echo "❌ Voice not found: $voice_arg"
           echo ""
@@ -554,7 +565,8 @@ provider_preview() {
       for voice in "${sample_voices[@]}"; do
         if say -v ? 2>/dev/null | grep -qi "^${voice} "; then
           echo "🔊 ${voice}..."
-          "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${voice}" "$voice"
+          "$SCRIPT_DIR/play-tts.sh" "Hi, my name is ${voice}" \
+            "$voice" "${_preview_llm_args[@]+"${_preview_llm_args[@]}"}"
           sleep 3
         fi
       done

package/.claude/hooks/provider-manager.sh

@@ -356,6 +356,44 @@ get_provider_script_path() {
   echo "$provider_script"
 }
 
+# @function detect_routing_llm
+# @intent Detect the LLM name to use for SSH/remote routing in preview and sample commands
+# @why preview/sample call play-tts.sh without --llm, so SSH routing is skipped and audio
+#      plays locally (no sound on headless servers). Detecting the remote LLM and passing
+#      --llm mirrors normal hook behaviour so audio reaches the configured receiver.
+# @returns Echoes LLM name (e.g. "claude-code") or empty string if no remote routing configured
+# @exitcode 0=always
+detect_routing_llm() {
+  # Priority 1: AGENTVIBES_LLM_KEY env var (set during active TTS sessions)
+  if [[ -n "${AGENTVIBES_LLM_KEY:-}" ]] && [[ "$AGENTVIBES_LLM_KEY" =~ ^llm:([a-zA-Z0-9][a-zA-Z0-9_-]*)$ ]]; then
+    echo "${BASH_REMATCH[1]}"
+    return 0
+  fi
+
+  # Priority 2: First mode=remote entry in transport-config.json
+  local _transport_cfg="$HOME/.agentvibes/transport-config.json"
+  if [[ -f "$_transport_cfg" ]] && command -v python3 &>/dev/null; then
+    local _remote_llm
+    _remote_llm=$(AGENTVIBES_CFG="$_transport_cfg" python3 - <<'PYEOF'
+import json, os, sys
+try:
+    d = json.load(open(os.environ['AGENTVIBES_CFG'], encoding='utf-8'))
+    hits = [k for k, v in d.items() if isinstance(v, dict) and v.get('mode') == 'remote']
+    print(hits[0] if hits else '')
+except Exception:
+    print('')
+PYEOF
+)
+    # Validate the key is a safe LLM name before returning
+    if [[ -n "$_remote_llm" ]] && [[ "$_remote_llm" =~ ^[a-zA-Z0-9][a-zA-Z0-9_-]*$ ]]; then
+      echo "$_remote_llm"
+      return 0
+    fi
+  fi
+
+  echo ""
+}
+
 # AI NOTE: This file provides the core abstraction layer for multi-provider TTS.
 # All provider state is managed through simple text files for simplicity and reliability.
 # Project-local configuration takes precedence over global to support per-project providers.

package/.claude/hooks/stop.sh

@@ -32,32 +32,7 @@ fi
 # Only run stop hook in LITE mode
 # (Full mode uses tool calls for TTS, not stop hooks)
 if [[ "$CURRENT_MODE" == "lite" ]]; then
-  # Claude Code sends JSON on stdin: {"transcript_path": "..."}
-  HOOK_INPUT=$(cat)
-  TRANSCRIPT_PATH=$(echo "$HOOK_INPUT" | jq -r '.transcript_path // empty' 2>/dev/null || true)
-
-  [[ -z "$TRANSCRIPT_PATH" ]] && exit 0
-  [[ ! -f "$TRANSCRIPT_PATH" ]] && exit 0
-
-  # Extract Audio Summary ONLY from the most recent assistant response.
-  # Key insight: we must NOT search earlier responses — if the latest response
-  # has no Audio Summary: marker, we stay silent (no stale replay).
-  SUMMARY=$(jq --slurp -r '
-    [.[] | try select(.message.role == "assistant")] | last // null
-    | if . == null then "" else
-        [.message.content[]? | select(.type == "text") | .text] | join("\n")
-      end
-    | if test("[Aa]udio [Ss]ummary:") then . else "" end
-  ' "$TRANSCRIPT_PATH" 2>/dev/null \
-    | sed -n 's/.*[Aa]udio [Ss]ummary:[[:space:]]*\(.*\)/\1/p' \
-    | head -1 \
-    | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-
-  [[ -z "$SUMMARY" ]] && exit 0
-
-  # Speak via AgentVibes play-tts.sh
-  if [[ -f "$PROJECT_ROOT/.claude/hooks/play-tts.sh" ]]; then
-    AGENTVIBES_MIN_TOKENS=3 AGENTVIBES_SHORT_TOKENS=50 \
-      bash "$PROJECT_ROOT/.claude/hooks/play-tts.sh" "$SUMMARY" >/dev/null 2>&1 &
+  if [[ -f "$AGENTVIBES_HOOKS/stop-lite.sh" ]]; then
+    bash "$AGENTVIBES_HOOKS/stop-lite.sh" "$@"
   fi
 fi

package/.claude/hooks/voice-manager.sh

@@ -561,8 +561,55 @@ case "$1" in
     fi
     ;;
 
+  sample)
+    # Play a sample phrase with the specified voice (used by /agent-vibes:sample)
+    SAMPLE_VOICE="${2:-}"
+    if [[ -z "$SAMPLE_VOICE" ]]; then
+      echo "❌ Usage: /agent-vibes:sample <voice-name>"
+      echo ""
+      echo "Examples:"
+      echo "  /agent-vibes:sample en_US-amy-medium"
+      echo "  /agent-vibes:sample Ryan"
+      exit 1
+    fi
+
+    # Source provider-manager.sh first — get_active_provider and detect_routing_llm
+    # are both defined there; sourcing after calling them silently produces empty values.
+    source "$SCRIPT_DIR/provider-manager.sh" 2>/dev/null || true
+
+    ACTIVE_PROVIDER=$(get_active_provider)
+
+    # Friendly name resolution for Piper and transport providers
+    case "$ACTIVE_PROVIDER" in
+      piper|ssh-remote|agentvibes-receiver|termux-ssh)
+        source "$SCRIPT_DIR/piper-voice-manager.sh" 2>/dev/null || true
+        SAMPLE_META="$(realpath "$SCRIPT_DIR/../../.agentvibes/config/voice-metadata.json" 2>/dev/null || echo "")"
+        if [[ -f "$SAMPLE_META" ]] && command -v jq >/dev/null 2>&1; then
+          SAMPLE_RESOLVED=$(jq -r --arg n "$(to_lower "$SAMPLE_VOICE")" '
+            .voices | to_entries[] |
+            select(.key == $n or (.value.displayName | ascii_downcase) == $n) |
+            .value.id
+          ' "$SAMPLE_META" 2>/dev/null | head -1)
+          if [[ -n "$SAMPLE_RESOLVED" ]] && [[ "$SAMPLE_RESOLVED" =~ ^[a-zA-Z0-9_.:+-]+$ ]]; then
+            echo "🔍 Resolved '${SAMPLE_VOICE}' → '${SAMPLE_RESOLVED}'"
+            SAMPLE_VOICE="$SAMPLE_RESOLVED"
+          fi
+        fi
+        ;;
+    esac
+
+    # Detect routing LLM so SSH-remote setups forward audio to the receiver
+    SAMPLE_LLM=$(detect_routing_llm 2>/dev/null || echo "")
+    SAMPLE_LLM_ARG=()
+    [[ -n "$SAMPLE_LLM" ]] && SAMPLE_LLM_ARG=(--llm "$SAMPLE_LLM")
+
+    echo "🎤 Sampling voice: $SAMPLE_VOICE"
+    "$SCRIPT_DIR/play-tts.sh" "Hi, I'm ${SAMPLE_VOICE}. How does my voice sound?" \
+      "$SAMPLE_VOICE" "${SAMPLE_LLM_ARG[@]+"${SAMPLE_LLM_ARG[@]}"}"
+    ;;
+
   *)
-    echo "Usage: voice-manager.sh [list|switch|get|replay|whoami] [voice_name]"
+    echo "Usage: voice-manager.sh [list|switch|get|replay|whoami|sample] [voice_name]"
     echo ""
     echo "Commands:"
     echo "  list                    - List all available voices"
@@ -570,6 +617,7 @@ case "$1" in
     echo "  get                     - Get current voice name"
     echo "  replay [N]              - Replay Nth most recent audio (default: 1)"
     echo "  whoami                  - Show current voice and personality"
+    echo "  sample <voice_name>     - Play sample audio with the given voice"
     exit 1
     ;;
-esac
+esac

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

@@ -22,7 +22,17 @@ param(
     # CLAUDE_PROJECT_DIR value here so per-project config is found even when
     # Bash tool calls do not propagate CLAUDE_PROJECT_DIR to child processes.
     [Parameter(Mandatory = $false)]
-    [string]$ProjectDir = ""
+    [string]$ProjectDir = "",
+
+    # Provider override from the remote sender (set by the watcher from the
+    # JSON payload's "provider" field).  Overrides the local tts-provider.txt
+    # default so the Linux-side config fully controls which engine the Windows
+    # receiver uses — no Windows-side provider config needed.
+    # Per-LLM engine rows in audio-effects.cfg still take final priority for
+    # explicit Windows overrides (e.g. llm:copilot → windows-sapi).
+    # Accepts cross-platform aliases: "piper" = windows-piper, "sapi" = windows-sapi.
+    [Parameter(Mandatory = $false)]
+    [string]$ProviderOverride = ""
 )
 
 # Text-file handoff: the SSH receiver watcher writes long/special-char text to
@@ -99,6 +109,29 @@ switch ($ActiveProvider) {
     }
 }
 
+# Apply remote provider override (from the JSON payload's "provider" field, passed
+# by the SSH-receiver watcher via -ProviderOverride).  This lets the Linux-side
+# audio-effects.cfg row for llm:claude-code specify "piper" and have it honoured
+# on Windows without requiring the Windows tts-provider.txt to be reconfigured.
+# Priority: lower than per-LLM $_LlmEngine (audio-effects.cfg row, set later), higher
+# than the global tts-provider.txt default set above.
+if ($ProviderOverride) {
+    switch ($ProviderOverride) {
+        { $_ -in "windows-piper", "piper" } {
+            $ProviderScript = "$HooksDir\play-tts-piper.ps1"
+            if (-not (Test-Path $ProviderScript)) { $ProviderScript = "$HooksDir\play-tts-windows-piper.ps1" }
+        }
+        { $_ -in "windows-sapi", "sapi" } {
+            $ProviderScript = "$HooksDir\play-tts-sapi.ps1"
+            if (-not (Test-Path $ProviderScript)) { $ProviderScript = "$HooksDir\play-tts-windows-sapi.ps1" }
+        }
+        "soprano" { $ProviderScript = "$HooksDir\play-tts-soprano.ps1" }
+        default {
+            Write-Host "[WARNING] play-tts.ps1: Unknown ProviderOverride '$ProviderOverride' ignored" -ForegroundColor Yellow
+        }
+    }
+}
+
 # Check if provider script exists
 if (-not (Test-Path $ProviderScript)) {
     Write-Host "[ERROR] Provider script not found: $ProviderScript" -ForegroundColor Red

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

@@ -0,0 +1,122 @@
+#
+# File: .claude/hooks-windows/tts-watcher.ps1
+#
+# AgentVibes TTS Queue Watcher — runs in the user's interactive session for audio access.
+# The SSH receiver (session 0, no audio) writes JSON request files to the queue; this
+# watcher picks them up and calls play-tts.ps1 in the user's desktop session.
+#
+# Single-instance guard: exit immediately if another watcher instance is already running.
+$mutex = New-Object System.Threading.Mutex($false, 'Global\AgentVibesTtsWatcher')
+if (-not $mutex.WaitOne(0)) { $mutex.Dispose(); exit 0 }
+
+$QueueDir = "$env:USERPROFILE\.agentvibes\tts-queue"
+$LogFile  = "$env:USERPROFILE\.agentvibes\watcher.log"
+$PlayTts  = "$env:USERPROFILE\.claude\hooks-windows\play-tts.ps1"
+if (-not (Test-Path $QueueDir)) { New-Item -ItemType Directory -Path $QueueDir -Force | Out-Null }
+
+function Write-WatcherLog {
+    param([string]$Level, [string]$Msg)
+    $ts = Get-Date -Format 'yyyy-MM-ddTHH:mm:ss'
+    Add-Content -Path $LogFile -Value "$ts [$Level] $Msg" -ErrorAction SilentlyContinue
+}
+
+Write-WatcherLog "INFO" "Watcher started. PlayTts=$PlayTts exists=$(Test-Path $PlayTts)"
+
+try {
+    while ($true) {
+        $files = Get-ChildItem "$QueueDir\req-*.json" -ErrorAction SilentlyContinue | Sort-Object CreationTime
+        foreach ($f in $files) {
+            # Rename to proc-* before processing — crash recovery on restart
+            $procFile = $f.FullName -replace '\\req-', '\proc-'
+            try { Rename-Item $f.FullName $procFile -ErrorAction Stop } catch { continue }
+            try {
+                $req = Get-Content $procFile -Raw | ConvertFrom-Json
+                # Validate voice before passing to command line
+                $safeVoice = if ($req.voice -and $req.voice -match '^[a-zA-Z0-9_\-\. :]+$') { $req.voice } else { "" }
+                $env:CLAUDE_PROJECT_DIR = $env:USERPROFILE
+                $env:AGENTVIBES_NO_PRETEXT = "1"
+                # Use SetEnvironmentVariable to truly unset (assignment to $null leaves empty string)
+                if ($req.music)   { $env:AGENTVIBES_OVERRIDE_MUSIC   = $req.music }
+                else { [System.Environment]::SetEnvironmentVariable("AGENTVIBES_OVERRIDE_MUSIC",   $null, "Process") }
+                if ($req.volume)  { $env:AGENTVIBES_OVERRIDE_VOLUME  = $req.volume }
+                else { [System.Environment]::SetEnvironmentVariable("AGENTVIBES_OVERRIDE_VOLUME",  $null, "Process") }
+                if ($req.effects) { $env:AGENTVIBES_OVERRIDE_EFFECTS = $req.effects }
+                else { [System.Environment]::SetEnvironmentVariable("AGENTVIBES_OVERRIDE_EFFECTS", $null, "Process") }
+
+                if (Test-Path $PlayTts) {
+                    # Play remote arrival prefix sound if configured
+                    $prefixSoundFile = "$env:USERPROFILE\.agentvibes\remote-prefix-sound.txt"
+                    if (Test-Path $prefixSoundFile) {
+                        $prefixSound = (Get-Content $prefixSoundFile -Raw).Trim()
+                        if ($prefixSound -and (Test-Path $prefixSound)) {
+                            $ffplay = Get-Command ffplay -ErrorAction SilentlyContinue
+                            if ($ffplay) {
+                                & $ffplay.Source -autoexit -nodisp -loglevel quiet $prefixSound 2>$null
+                            }
+                        }
+                    }
+
+                    $tempText = Join-Path $env:TEMP "agentvibes-tts-$($req.id).txt"
+                    try {
+                        [System.IO.File]::WriteAllText($tempText, $req.text, [System.Text.UTF8Encoding]::new($false))
+                        $env:AGENTVIBES_TEXT_FILE = $tempText
+
+                        $llmArg = @()
+                        if ($req.llm) {
+                            if ($req.llm -match '^[a-zA-Z0-9][a-zA-Z0-9_-]*$') {
+                                $llmArg = @('-llm', $req.llm)
+                            } else {
+                                Write-WatcherLog "WARN" "Invalid LLM name '$($req.llm)' - using default"
+                            }
+                        }
+
+                        # Provider override: the Linux sender embeds its configured provider
+                        # (from receiver-provider.txt / audio-effects.cfg ENGINE column) in the
+                        # JSON payload so the Windows receiver uses the Linux-side engine choice.
+                        $providerArg = @()
+                        if ($req.provider) {
+                            $safeProvider = $req.provider.Trim()
+                            if ($safeProvider -match '^[a-zA-Z0-9][a-zA-Z0-9_-]*$') {
+                                $providerArg = @('-ProviderOverride', $safeProvider)
+                            } else {
+                                Write-WatcherLog "WARN" "Invalid provider '$safeProvider' in payload - ignored"
+                            }
+                        }
+
+                        Write-WatcherLog "INFO" "play-tts id=$($req.id) voice=$safeVoice llm=$($req.llm) provider=$safeProvider"
+                        $playOutput = & powershell.exe -NoProfile -ExecutionPolicy Bypass -File $PlayTts "__from_file__" $safeVoice @llmArg @providerArg 2>&1
+                        if ($LASTEXITCODE -ne 0) {
+                            Write-WatcherLog "ERROR" "play-tts exit=$LASTEXITCODE id=$($req.id) output=$($playOutput -join ' | ')"
+                        } else {
+                            Write-WatcherLog "INFO" "play-tts ok exit=0 id=$($req.id)"
+                        }
+                    } finally {
+                        [System.Environment]::SetEnvironmentVariable("AGENTVIBES_TEXT_FILE", $null, "Process")
+                        Remove-Item $tempText -Force -ErrorAction SilentlyContinue
+                    }
+                } else {
+                    # Fallback: Windows SAPI (built-in, no installation required)
+                    Write-WatcherLog "WARN" "play-tts.ps1 not found - using SAPI fallback for id=$($req.id)"
+                    Add-Type -AssemblyName System.Speech
+                    $synth = New-Object System.Speech.Synthesis.SpeechSynthesizer
+                    $synth.Speak($req.text)
+                    $synth.Dispose()
+                }
+                Remove-Item $procFile -Force -ErrorAction SilentlyContinue
+            } catch {
+                Write-WatcherLog "ERROR" "id=$($req.id) err=$_"
+                Remove-Item $procFile -Force -ErrorAction SilentlyContinue
+            }
+        }
+        # Crash recovery: re-queue any proc-* files left from a previous watcher crash
+        $stale = Get-ChildItem "$QueueDir\proc-*.json" -ErrorAction SilentlyContinue
+        foreach ($s in $stale) {
+            $recovered = $s.FullName -replace '\\proc-', '\req-'
+            try { Rename-Item $s.FullName $recovered -ErrorAction SilentlyContinue } catch {}
+        }
+        Start-Sleep -Milliseconds 200
+    }
+} finally {
+    $mutex.ReleaseMutex()
+    $mutex.Dispose()
+}

package/.claude/piper-voices-dir.txt

@@ -1 +1 @@
-/home/fire/.claude/piper-voices
+/home/administrator/.claude/piper-voices

package/.mcp.json

@@ -1,50 +1,30 @@
 {
   "mcpServers": {
-    "context7": {
+    "agentvibes": {
       "command": "npx",
       "args": [
-        "@upstash/context7-mcp"
-      ]
-    },
-    "sonarqube": {
-      "command": "docker",
-      "args": [
-        "run",
-        "-i",
-        "--name",
-        "sonarqube-mcp-server-agentvibes",
-        "--rm",
-        "--dns",
-        "8.8.8.8",
-        "--dns",
-        "8.8.4.4",
-        "-e",
-        "SONARQUBE_TOKEN",
-        "-e",
-        "SONARQUBE_ORG",
-        "-e",
-        "STORAGE_PATH",
-        "mcp/sonarqube"
+        "-y",
+        "--package=agentvibes",
+        "agentvibes-mcp-server"
       ],
       "env": {
-        "SONARQUBE_TOKEN": "${SONARQUBE_TOKEN}",
-        "SONARQUBE_ORG": "${SONARQUBE_ORG}",
-        "STORAGE_PATH": "${STORAGE_PATH}"
+        "AGENTVIBES_MCP_FALLBACK": "copilot"
       }
     },
-    "vercel": {
-      "type": "sse",
-      "url": "https://mcp.vercel.com"
+    "firecrawl": {
+      "command": "npx",
+      "args": [
+        "firecrawl-mcp"
+      ]
     },
-    "agentvibes": {
+    "context7": {
       "command": "npx",
       "args": [
         "-y",
-        "--package=agentvibes",
-        "agentvibes-mcp-server"
+        "@upstash/context7-mcp"
       ],
       "env": {
-        "AGENTVIBES_MCP_FALLBACK": "copilot"
+        "CONTEXT7_API_KEY": "${CONTEXT7_API_KEY}"
       }
     }
   }