agentvibes 5.6.9 → 5.7.1

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}"
       }
     }
   }

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**: v5.6.9
+**Author**: Paul Preibisch ([@997Fire](https://x.com/997Fire)) | **Version**: v5.7.1
 
 ---
 
@@ -40,17 +40,15 @@ Whether you're coding in Claude Code, chatting in Claude Desktop, using Warp Ter
 
 ---
 
-## 🌟 NEW IN v5.6.9 — Reverb & Background Music Silent in NPX Installs
+## 🌟 NEW IN v5.7.0 — BMAD v6.6 Support + Windows Auto-Restart Watcher
 
-**NPX users:** Reverb and background music were silently broken for all `npx`-installed users. Hook files extracted from the npm tarball lacked execute bits (644), causing `audio-processor.sh` to exit with code 126. Fixed via `bash` prefix in the caller and a postinstall `chmod 755` step.
+**BMAD v6.6.0:** AgentVibes now detects the new `.claude/skills/*/agents/` agent structure, correctly handles globally-installed BMAD at `~/_bmad`, and gracefully skips v6.6+ plain-Markdown agents during TTS injection instead of erroring. The BMAD tab now shows detection correctly for global installs.
 
-**Voice Browser:** The Preview button now applies your configured reverb and background music — it was playing raw audio with no effects.
+**Windows watcher:** `tts-watcher.ps1` is now a standalone file at `~/.agentvibes/tts-watcher.ps1`. Running `npx agentvibes update` now copies the latest watcher **and** restarts it automatically — both the file and the process are updated in one step, no manual restart needed.
 
-**MCP tool:** `text_to_speech` now returns the correct audio file path (no trailing emoji garbage) and includes the voice name in its response.
+**Windows provider:** `play-tts.ps1` now respects the `ProviderOverride` from the Linux server config when receiving remote audio.
 
-**Background music toggle:** Enabling music in the TUI now actually enables it — the flag file read by bash hooks is now kept in sync.
-
-## v5.6.8 — WSL Voice Routing Fixed + Session Lifecycle Reliability
+## v5.6.9 — Reverb & Background Music Silent in NPX Installs
 
 **WSL users:** AgentVibes was playing `en_US-lessac-medium` regardless of your configured voice. Fixed — Piper is now found in non-interactive shells by explicitly prepending `~/.local/bin` to `PATH` before the binary check.
 

package/RELEASE_NOTES.md

@@ -1,5 +1,37 @@
 # AgentVibes Release Notes
 
+## 🎭 v5.7.0 — BMAD v6.6 Support + Windows Auto-Restart Watcher
+
+**Released:** 2026-05-11
+
+### 🆕 BMAD v6.6.0 Compatibility
+
+BMAD v6.6 restructured where agents live — they moved from `_bmad/bmm/agents/` to `.claude/skills/*/agents/`. AgentVibes now detects and scans these new paths correctly.
+
+**TTS injection** gracefully skips v6.6+ agents (which use plain Markdown without XML/YAML activation sections) instead of throwing errors. The install summary now clearly reports how many agents were skipped vs. modified.
+
+**BMAD tab detection** now finds globally-installed BMAD at `~/_bmad` (home-dir install) in addition to project-local installs. Previously the BMAD tab showed "Not detected" even when BMAD was installed globally.
+
+**Security:** The installer's path validation now correctly permits BMAD paths under the user's home directory, fixing a false-positive "Invalid BMAD path" error for global installs.
+
+### 🆕 Windows TTS Watcher — Standalone File + Auto-Restart
+
+`tts-watcher.ps1` is now extracted to `~/.agentvibes/tts-watcher.ps1` as a standalone file. Running `npx agentvibes update` now copies the latest watcher to that location **and** automatically restarts it — so both the watcher script itself and its running process are updated in one step. No manual file replacement or restart needed after updates.
+
+### 🐛 Windows Provider Override Respected on Laptop
+
+`play-tts.ps1` now reads the `ProviderOverride` setting from the Linux-side config when receiving audio via SSH. Previously the laptop always used its locally-configured provider even if the server specified a different one.
+
+### 🐛 Sample Command Added to Voice Manager
+
+`voice-manager.sh sample` was missing its handler — calling it fell through to the usage/exit path silently. Fixed.
+
+### 🐛 Preview SSH Routing Detects Correct Endpoint
+
+`provider-manager.sh` now includes `detect_routing_llm()` which checks `AGENTVIBES_LLM_KEY` then `transport-config.json` for the first `mode=remote` entry, so preview audio reaches the correct SSH host.
+
+---
+
 ## 🔇 v5.6.9 — Reverb & Background Music Silent in NPX Installs
 
 **Released:** 2026-05-09

package/bin/agent-vibes

@@ -1,40 +1,40 @@
 #!/usr/bin/env node
-
-/**
- * AgentVibes - Beautiful ElevenLabs TTS voice commands for Claude Code
- * This file ensures proper execution when run via npx
- */
-
-import { execFileSync } from 'node:child_process';
-import path from 'node:path';
-import fs from 'node:fs';
-import { fileURLToPath } from 'node:url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// Check if we're running in an npx temporary directory
-const isNpxExecution = __dirname.includes('_npx') || __dirname.includes('.npm');
-
-// Get CLI arguments
-const arguments_ = process.argv.slice(2);
-
-// Route through the TUI console (agentvibes.js) which handles install/config/etc
-const installerPath = path.join(__dirname, 'agentvibes.js');
-
-if (!fs.existsSync(installerPath)) {
-  console.error('Error: Could not find installer.js at', installerPath);
-  console.error('Current directory:', __dirname);
-  process.exit(1);
-}
-
-try {
-  // Security: Use execFileSync with array args to prevent command injection
-  // Arguments are passed as array elements, not string interpolation
-  execFileSync('node', [installerPath, ...arguments_], {
-    stdio: 'inherit',
-    cwd: path.dirname(__dirname),
-  });
-} catch (error) {
-  process.exit(error.status || 1);
-}
+
+/**
+ * AgentVibes - Beautiful ElevenLabs TTS voice commands for Claude Code
+ * This file ensures proper execution when run via npx
+ */
+
+import { execFileSync } from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Check if we're running in an npx temporary directory
+const isNpxExecution = __dirname.includes('_npx') || __dirname.includes('.npm');
+
+// Get CLI arguments
+const arguments_ = process.argv.slice(2);
+
+// Route through the TUI console (agentvibes.js) which handles install/config/etc
+const installerPath = path.join(__dirname, 'agentvibes.js');
+
+if (!fs.existsSync(installerPath)) {
+  console.error('Error: Could not find installer.js at', installerPath);
+  console.error('Current directory:', __dirname);
+  process.exit(1);
+}
+
+try {
+  // Security: Use execFileSync with array args to prevent command injection
+  // Arguments are passed as array elements, not string interpolation
+  execFileSync('node', [installerPath, ...arguments_], {
+    stdio: 'inherit',
+    cwd: path.dirname(__dirname),
+  });
+} catch (error) {
+  process.exit(error.status || 1);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "agentvibes",
-  "version": "5.6.9",
+  "version": "5.7.1",
   "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/bmad-detector.js

@@ -1,71 +1,85 @@
-import path from 'node:path';
-import fs from 'node:fs/promises';
-import yaml from 'js-yaml';
-
-/**
- * Detect BMAD installation and version
- * @param {string} targetDir - Directory to check
- * @returns {Promise<Object>} Detection result with version info
- */
-export async function detectBMAD(targetDir) {
-  // Check v6 first (newer version) - support both .bmad and bmad paths
-  // Try .bmad (standard path with dot prefix) first
-  let v6Manifest = path.join(targetDir, '.bmad/_cfg/manifest.yaml');
-  let bmadPath = '.bmad';
-
-  try {
-    await fs.access(v6Manifest);
-  } catch {
-    // Try bmad (alternative path without dot prefix)
-    v6Manifest = path.join(targetDir, 'bmad/_cfg/manifest.yaml');
-    bmadPath = 'bmad';
-    try {
-      await fs.access(v6Manifest);
-    } catch {
-      // Neither path found, continue to v4 check
-      bmadPath = null;
-    }
-  }
-
-  if (bmadPath) {
-    try {
-      const manifestContent = await fs.readFile(v6Manifest, 'utf8');
-      const manifest = yaml.load(manifestContent);
-
-      return {
-        version: 6,
-        detailedVersion: manifest.installation?.version || '6.0.0-alpha.x',
-        manifestPath: v6Manifest,
-        configPath: path.join(targetDir, bmadPath, 'core/config.yaml'),
-        bmadPath: path.join(targetDir, bmadPath),
-        installed: true
-      };
-    } catch {}
-  }
-
-  // Check v4 (legacy)
-  const v4Manifest = path.join(targetDir, '.bmad-core/install-manifest.yaml');
-  try {
-    await fs.access(v4Manifest);
-    return {
-      version: 4,
-      detailedVersion: '4.x',
-      manifestPath: v4Manifest,
-      configPath: path.join(targetDir, '.bmad-core/config.yaml'),
-      bmadPath: path.join(targetDir, '.bmad-core'),
-      installed: true
-    };
-  } catch {}
-
-  // Not installed
-  return { version: null, installed: false };
-}
-
-/**
- * Get BMAD configuration file path for detected version
- * @param {Object} detection - Result from detectBMAD()
- * @returns {string|null} Path to config.yaml or null
- */
-export function getBMADConfigPath(detection) {
-  return detection.installed ? detection.configPath : null;
-}
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import yaml from 'js-yaml';
+
+/**
+ * Detect BMAD installation and version
+ * @param {string} targetDir - Directory to check
+ * @returns {Promise<Object>} Detection result with version info
+ */
+export async function detectBMAD(targetDir) {
+  // Check v6 first (newer version).
+  // Search order: project-local variants first, then home-dir (_bmad is the current BMAD installer default)
+  const homeDir = os.homedir();
+  const v6Candidates = [
+    // Project-local checks first
+    { manifest: path.join(targetDir, '.bmad/_cfg/manifest.yaml'),    bmadPath: '.bmad' },
+    { manifest: path.join(targetDir, 'bmad/_cfg/manifest.yaml'),     bmadPath: 'bmad' },
+    { manifest: path.join(targetDir, '_bmad/_cfg/manifest.yaml'),    bmadPath: '_bmad' },
+    { manifest: path.join(targetDir, '_bmad/_config/manifest.yaml'), bmadPath: '_bmad' },
+    // Home-dir installs (global BMAD not inside a project) — detected but NOT injected
+    { manifest: path.join(homeDir, '_bmad/_config/manifest.yaml'),   bmadPath: '_bmad', root: homeDir, isGlobal: true },
+    { manifest: path.join(homeDir, '_bmad/_cfg/manifest.yaml'),      bmadPath: '_bmad', root: homeDir, isGlobal: true },
+    { manifest: path.join(homeDir, '.bmad/_cfg/manifest.yaml'),      bmadPath: '.bmad', root: homeDir, isGlobal: true },
+  ];
+
+  let v6Manifest = null;
+  let bmadPath = null;
+  let bmadRoot = targetDir;
+  let isGlobal = false;
+
+  for (const candidate of v6Candidates) {
+    try {
+      await fs.access(candidate.manifest);
+      v6Manifest = candidate.manifest;
+      bmadPath = candidate.bmadPath;
+      bmadRoot = candidate.root ?? targetDir;
+      isGlobal = candidate.isGlobal ?? false;
+      break;
+    } catch { /* try next */ }
+  }
+
+  if (bmadPath) {
+    try {
+      const manifestContent = await fs.readFile(v6Manifest, 'utf8');
+      const manifest = yaml.load(manifestContent);
+
+      return {
+        version: 6,
+        detailedVersion: manifest.installation?.version || '6.0.0-alpha.x',
+        manifestPath: v6Manifest,
+        configPath: path.join(bmadRoot, bmadPath, 'core/config.yaml'),
+        bmadPath: path.join(bmadRoot, bmadPath),
+        installed: true,
+        isGlobal,
+      };
+    } catch {}
+  }
+
+  // Check v4 (legacy)
+  const v4Manifest = path.join(targetDir, '.bmad-core/install-manifest.yaml');
+  try {
+    await fs.access(v4Manifest);
+    return {
+      version: 4,
+      detailedVersion: '4.x',
+      manifestPath: v4Manifest,
+      configPath: path.join(targetDir, '.bmad-core/config.yaml'),
+      bmadPath: path.join(targetDir, '.bmad-core'),
+      installed: true
+    };
+  } catch {}
+
+  // Not installed
+  return { version: null, installed: false };
+}
+
+/**
+ * Get BMAD configuration file path for detected version
+ * @param {Object} detection - Result from detectBMAD()
+ * @returns {string|null} Path to config.yaml or null
+ */
+export function getBMADConfigPath(detection) {
+  return detection.installed ? detection.configPath : null;
+}