agentvibes 4.5.7 → 4.6.0

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

@@ -0,0 +1,175 @@
+#!/usr/bin/env bash
+#
+# File: ~/.claude/hooks/bmad-party-speak.sh
+#
+# AgentVibes PostToolUse Hook - BMAD Party Mode TTS (Linux / macOS / WSL)
+#
+# Fires after every Agent tool call. Detects BMAD party mode agents by
+# fingerprinting the prompt, extracts the agent display name, maps it to
+# the canonical agent ID via the manifest, then calls bmad-speak.sh.
+# Uses flock for cross-process audio serialization (no overlapping speech).
+#
+# Installed globally so it works in any BMAD project.
+# Uses CLAUDE_PROJECT_DIR env var to locate the project manifest at runtime.
+#
+# Input: JSON on stdin (Claude Code PostToolUse payload)
+#
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+LOCK_FILE="/tmp/agentvibes-party-queue.lock"
+
+# --- Read stdin ---
+raw="$(cat)"
+[[ -z "$raw" ]] && exit 0
+
+# --- Parse all needed fields in one python3 call (fixes M5: 3x subprocess, echo safety) ---
+# Outputs: TOOL_NAME|DISPLAY_NAME|RESPONSE_TEXT (newlines in response encoded as \n literals)
+parsed="$(printf '%s' "$raw" | python3 - <<'PYEOF'
+import sys, json, re
+
+try:
+    d = json.load(sys.stdin)
+except Exception:
+    print("|||")
+    sys.exit(0)
+
+tool_name = d.get('tool_name', '')
+prompt = d.get('tool_input', {}).get('prompt', '')
+
+# Extract display name — safe alternative to grep -oP (fixes C2: macOS BSD grep no -P)
+display_name = ''
+m = re.search(r'You are ([A-Za-z]+)\s*\(', prompt)
+if m:
+    display_name = m.group(1)
+
+# Extract response text
+response_text = ''
+for item in d.get('tool_response', {}).get('content', []):
+    if item.get('type') == 'text':
+        response_text = item['text']
+        break
+
+# Strip leading icon + bold name header (e.g. "📊 **Mary:** " or garbled prefix)
+response_text = response_text.strip()
+response_text = re.sub(r'^\S*\s*\*\*[^:]+:\*\*\s*', '', response_text).strip()
+
+# Encode newlines so we can pass multi-line text through a single shell variable (fixes m3)
+response_text = response_text.replace('\n', '\\n')
+
+print(f"{tool_name}|{display_name}|{response_text}")
+PYEOF
+)" 2>/dev/null || true
+
+[[ -z "$parsed" ]] && exit 0
+
+tool_name="${parsed%%|*}"
+rest="${parsed#*|}"
+display_name="${rest%%|*}"
+response_text="${rest#*|}"
+
+# Decode \n back to newlines for TTS
+response_text="${response_text//\\n/ }"
+
+# --- Only handle Agent tool ---
+[[ "$tool_name" != "Agent" ]] && exit 0
+
+# --- Fingerprint: only fire for BMAD party mode agents (safe string match, no pipe) ---
+[[ "$raw" == *"BMAD agent in a collaborative roundtable"* ]] || exit 0
+
+[[ -z "$display_name" ]] && exit 0
+[[ -z "$response_text" ]] && exit 0
+
+# --- Resolve project root ---
+project_root="${CLAUDE_PROJECT_DIR:-}"
+
+# --- Find bmad-speak.sh (prefer project-local, fall back to global) ---
+bmad_speak=""
+if [[ -n "$project_root" && -f "$project_root/.claude/hooks/bmad-speak.sh" ]]; then
+    bmad_speak="$project_root/.claude/hooks/bmad-speak.sh"
+elif [[ -f "$SCRIPT_DIR/bmad-speak.sh" ]]; then
+    bmad_speak="$SCRIPT_DIR/bmad-speak.sh"
+fi
+[[ -z "$bmad_speak" ]] && exit 0
+
+# --- Look up canonical agent ID from project manifest via python3 (fixes M4: awk CSV comma) ---
+agent_id="$display_name"  # fallback
+if [[ -n "$project_root" && -f "$project_root/_bmad/_config/agent-manifest.csv" ]]; then
+    manifest="$project_root/_bmad/_config/agent-manifest.csv"
+    matched="$(python3 - "$manifest" "$display_name" <<'PYEOF'
+import sys, csv
+manifest_path, target = sys.argv[1], sys.argv[2].lower()
+try:
+    with open(manifest_path, newline='', encoding='utf-8') as f:
+        for row in csv.DictReader(f):
+            if row.get('displayName', '').lower() == target:
+                print(row.get('name', ''))
+                break
+except Exception:
+    pass
+PYEOF
+)" 2>/dev/null || true
+    [[ -n "$matched" ]] && agent_id="$matched"
+fi
+
+# --- Apply verbosity truncation ---
+verbosity="medium"
+# Guard project_root empty to avoid /.claude/... path (fixes M1)
+if [[ -n "$project_root" && -f "$project_root/.claude/tts-verbosity.txt" ]]; then
+    v="$(tr -d '[:space:]' < "$project_root/.claude/tts-verbosity.txt")"
+    [[ -n "$v" ]] && verbosity="$v"
+elif [[ -f "$HOME/.claude/tts-verbosity.txt" ]]; then
+    v="$(tr -d '[:space:]' < "$HOME/.claude/tts-verbosity.txt")"
+    [[ -n "$v" ]] && verbosity="$v"
+fi
+
+case "$verbosity" in
+    low)
+        # First sentence — fall back to full text if no punctuation (fixes m1)
+        first="$(printf '%s' "$response_text" | python3 -c "
+import sys, re
+t = sys.stdin.read()
+m = re.match(r'^.*?[.!?]', t)
+print(m.group(0) if m else t)
+" 2>/dev/null || printf '%s' "$response_text")"
+        [[ -n "$first" ]] && response_text="$first"
+        ;;
+    medium)
+        # First 2 sentences — fall back to full text if no punctuation (fixes m1)
+        two="$(printf '%s' "$response_text" | python3 -c "
+import sys, re
+t = sys.stdin.read()
+parts = re.findall(r'.*?[.!?]', t)
+print(' '.join(parts[:2]) if parts else t)
+" 2>/dev/null || printf '%s' "$response_text")"
+        [[ -n "$two" ]] && response_text="$two"
+        ;;
+    # high = full text
+esac
+
+[[ -z "$response_text" ]] && exit 0
+
+# --- Acquire queue lock (flock: cross-process, auto-releases on crash) ---
+exec 9>"$LOCK_FILE"
+if command -v flock &>/dev/null; then
+    flock -w 60 9
+    "$bmad_speak" "$agent_id" "$response_text" || true
+    flock -u 9
+else
+    # macOS fallback: atomic mkdir polling lock
+    LOCK_DIR="/tmp/agentvibes-party-queue.lock.d"
+    # Register trap BEFORE acquiring lock so SIGTERM can't orphan it (fixes M3)
+    trap 'rmdir "$LOCK_DIR" 2>/dev/null || true' EXIT
+    WAITED=0
+    while ! mkdir "$LOCK_DIR" 2>/dev/null; do
+        sleep 0.5
+        WAITED=$((WAITED + 1))
+        if [[ $WAITED -ge 120 ]]; then
+            echo "[AgentVibes] Party mode TTS queue timeout for agent: $agent_id" >&2
+            exit 0
+        fi
+    done
+    "$bmad_speak" "$agent_id" "$response_text" || true
+    rmdir "$LOCK_DIR" 2>/dev/null || true
+fi

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

@@ -0,0 +1,141 @@
+#
+# File: ~/.claude/hooks-windows/bmad-party-speak.ps1
+#
+# AgentVibes PostToolUse Hook - BMAD Party Mode TTS
+#
+# Fires after every Agent tool call. Detects BMAD party mode agents by
+# fingerprinting the prompt, extracts the agent display name, maps it to
+# the canonical agent ID via the manifest, then calls bmad-speak.ps1.
+#
+# Installed globally so it works in any BMAD project.
+# Uses $env:CLAUDE_PROJECT_DIR to locate the project manifest at runtime.
+#
+
+try {
+    # --- Read stdin safely ---
+    $raw = [Console]::In.ReadToEnd()
+    if (-not $raw -or $raw.Trim() -eq "") { exit 0 }
+
+    $data = $raw | ConvertFrom-Json
+    if (-not $data) { exit 0 }
+
+    # --- Only handle Agent tool ---
+    if ($data.tool_name -ne "Agent") { exit 0 }
+
+
+    # --- Extract prompt ---
+    $prompt = $data.tool_input.prompt
+    if (-not $prompt) { exit 0 }
+
+    # --- Fingerprint: only fire for BMAD party mode agents ---
+    if ($prompt -notmatch "BMAD agent in a collaborative roundtable") { exit 0 }
+
+    # --- Extract display name from "You are {Name} (" ---
+    if ($prompt -notmatch "You are ([A-Za-z]+)\s*\(") { exit 0 }
+    $DisplayName = $Matches[1]
+
+    # --- Extract response text ---
+    $content = $data.tool_response.content
+    if (-not $content -or $content.Count -eq 0) { exit 0 }
+    $ResponseText = ($content | Where-Object { $_.type -eq "text" } | Select-Object -First 1).text
+    if (-not $ResponseText) { exit 0 }
+
+    # Strip leading icon + bold name header e.g. "📊 **Mary:**" or garbled "≡ƒôè **Mary:**"
+    # Trim first so leading newlines don't defeat the ^ anchor (fixes M7)
+    $ResponseText = $ResponseText.Trim()
+    $ResponseText = $ResponseText -replace '^\S*\s*\*\*[^:]+:\*\*\s*', ''
+    $ResponseText = $ResponseText.Trim()
+    if (-not $ResponseText) { exit 0 }
+
+    # --- Resolve paths ---
+    $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+    $ProjectRoot = $env:CLAUDE_PROJECT_DIR
+
+    # --- Find bmad-speak.ps1 (prefer project-local, fall back to global) ---
+    $BmadSpeak = $null
+    if ($ProjectRoot) {
+        $local = Join-Path $ProjectRoot ".claude\hooks-windows\bmad-speak.ps1"
+        if (Test-Path $local) { $BmadSpeak = $local }
+    }
+    if (-not $BmadSpeak) {
+        $global = Join-Path $ScriptDir "bmad-speak.ps1"
+        if (Test-Path $global) { $BmadSpeak = $global }
+    }
+    if (-not $BmadSpeak) { exit 0 }
+
+    # --- Look up canonical agent ID from project manifest (fixes m2: UTF8 encoding) ---
+    $AgentId = $DisplayName  # fallback
+    if ($ProjectRoot) {
+        $ManifestFile = Join-Path $ProjectRoot "_bmad\_config\agent-manifest.csv"
+        if (Test-Path $ManifestFile) {
+            $rows = Import-Csv $ManifestFile -Encoding UTF8
+            foreach ($row in $rows) {
+                if ($row.displayName -ieq $DisplayName) {
+                    $AgentId = $row.name
+                    break
+                }
+            }
+        }
+    }
+
+    # --- Apply verbosity truncation ---
+    $Verbosity = "medium"
+    $verbosityPaths = @(
+        (Join-Path $env:USERPROFILE ".claude\tts-verbosity.txt")
+    )
+    if ($ProjectRoot) {
+        $verbosityPaths = @((Join-Path $ProjectRoot ".claude\tts-verbosity.txt")) + $verbosityPaths
+    }
+    foreach ($p in $verbosityPaths) {
+        if (Test-Path $p) {
+            $v = (Get-Content $p -Raw -ErrorAction SilentlyContinue).Trim()
+            if ($v) { $Verbosity = $v; break }
+        }
+    }
+
+    switch ($Verbosity) {
+        "low" {
+            $sentences = [regex]::Split($ResponseText, '(?<=[.!?])\s+')
+            # Fall back to full text if no sentence-ending punctuation (fixes m1)
+            if ($sentences.Count -gt 0 -and $sentences[0]) { $ResponseText = $sentences[0] }
+        }
+        "medium" {
+            $sentences = [regex]::Split($ResponseText, '(?<=[.!?])\s+')
+            # Fall back to full text if no sentence-ending punctuation (fixes m1)
+            $truncated = ($sentences | Select-Object -First 2) -join " "
+            if ($truncated) { $ResponseText = $truncated }
+        }
+        # "high" = full text
+    }
+
+    # --- Speak with queue serialization (named mutex, cross-process) ---
+    $mutex = New-Object System.Threading.Mutex($false, "AgentVibesPartyModeTTSQueue")
+    try {
+        $acquired = $false
+        try {
+            # WaitOne throws AbandonedMutexException if prior process crashed while holding it.
+            # That exception means we DID acquire the mutex — treat it as success (fixes M2).
+            $acquired = $mutex.WaitOne(60000)
+        } catch [System.Threading.AbandonedMutexException] {
+            $acquired = $true  # abandoned = we now own it
+        }
+
+        if ($acquired) {
+            try {
+                # Pass positional args directly after -File (spaces handled by quoting via array)
+                & powershell -NoProfile -ExecutionPolicy Bypass -File $BmadSpeak $AgentId $ResponseText
+            } finally {
+                $mutex.ReleaseMutex()
+            }
+        } else {
+            # Timed out — log to stderr so it's visible in hook error output (fixes M6)
+            [Console]::Error.WriteLine("[AgentVibes] Party mode TTS queue timeout for agent: $AgentId")
+        }
+    } finally {
+        $mutex.Close()
+    }
+
+} catch {
+    # Silently exit — never block Claude
+    exit 0
+}

package/RELEASE_NOTES.md

@@ -1,5 +1,25 @@
 # AgentVibes Release Notes
 
+## ✨ v4.6.0 — Minor Release
+
+**Release Date:** April 2026
+
+### New Features
+
+- **BMAD party mode TTS auto-installs for all platforms** — The installer now automatically copies `bmad-party-speak.sh` (Linux/macOS/WSL) or `bmad-party-speak.ps1` (Windows) to `~/.claude/hooks/` and registers a `PostToolUse` hook in `~/.claude/settings.json`. Party mode agents now speak out of the box in any BMAD project without manual setup. Both scripts are included in critical hooks so `npx agentvibes update` keeps them fresh.
+
+### Bug Fixes
+
+- **Background music volume default** — All volume defaults lowered from 70% to 20% across the UI (settings tab, agents tab, music tab, track picker) and scripts (`audio-processor.sh`, `bmad-speak.sh`, `bmad-speak.ps1`). New installs and newly configured agents default to a much more reasonable level.
+- **bmad-speak volume inheritance** — `bmad-speak.sh` and `bmad-speak.ps1` now read the global `background-music-volume.txt` config file as the fallback volume instead of a hardcoded value.
+- **Installer wizard left arrow** — Pressing ← on the completion screen (screen 5) to move from Done-Quit to Done-Customize More no longer jumps back to the installation step.
+
+### Tests
+
+- 29 new tests: volume default regression guards across all affected files, `configurePartyModeHook` installer coverage (idempotency, settings.json registration, script copying, hook preservation), and a regression test for the screen 5 navigation fix.
+
+---
+
 ## 🐛 v4.5.7 — Patch Release
 
 **Release Date:** April 2026

package/bin/agent-vibes

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes - Beautiful ElevenLabs TTS voice commands for Claude Code

package/bin/agentvibes-voice-browser.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes Voice Browser

package/bin/mcp-server.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  * AgentVibes MCP Server Launcher (Cross-Platform)

package/bin/test-bmad-pr

@@ -1,4 +1,4 @@
-#!/usr/bin/env bash
+#!/usr/bin/env bash
 #
 # AgentVibes BMAD PR Testing Command
 # Quick command to test BMAD PRs with AgentVibes integration

package/package.json

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

@@ -974,6 +974,7 @@ export function createInstallTab(screen, services) {
   screen.key(['left'], () => {
     if (box.hidden || _checking) return;
     if (_screen === 4) return;
+    if (_screen === 5) return;  // Screen 5: ← handled by button nav
     if (_screen > 0) {
       _screen--;
       _showCurrentScreen();

package/src/installer.js

@@ -3822,6 +3822,76 @@ async function configureSessionStartHook(targetDir, spinner) {
   }
 }
 
+/**
+ * Configure BMAD party mode PostToolUse hook in the global ~/.claude/settings.json.
+ * Copies bmad-party-speak script to ~/.claude/hooks/ (or hooks-windows/ on Windows)
+ * and registers the PostToolUse hook so party mode TTS works in any BMAD project.
+ * @param {string} targetDir - Target installation directory (used to locate source scripts)
+ * @param {Object} spinner - Ora spinner instance
+ */
+async function configurePartyModeHook(targetDir, spinner, homeDirOverride) {
+  spinner.start('Configuring BMAD party mode TTS hook...');
+  const homeDir = homeDirOverride || os.homedir();
+  const globalClaudeDir = path.join(homeDir, '.claude');
+  const globalSettingsPath = path.join(globalClaudeDir, 'settings.json');
+
+  try {
+    // Determine platform-specific paths
+    const hooksSubdir = isNativeWindows() ? 'hooks-windows' : 'hooks';
+    const scriptName = isNativeWindows() ? 'bmad-party-speak.ps1' : 'bmad-party-speak.sh';
+    const globalHooksDir = path.join(globalClaudeDir, hooksSubdir);
+    const srcScript = path.join(__dirname, '..', '.claude', hooksSubdir, scriptName);
+    const destScript = path.join(globalHooksDir, scriptName);
+
+    // Copy script to global hooks dir (create dir if needed)
+    await fs.mkdir(globalHooksDir, { recursive: true });
+    await fs.copyFile(srcScript, destScript);
+    if (!isNativeWindows()) {
+      await fs.chmod(destScript, 0o750);
+    }
+
+    // Build the PostToolUse hook command
+    const hookCommand = isNativeWindows()
+      ? `powershell -NoProfile -ExecutionPolicy Bypass -File "$HOME\\.claude\\hooks-windows\\bmad-party-speak.ps1"`
+      : `bash "$HOME/.claude/hooks/bmad-party-speak.sh"`;
+
+    // Read/create global settings.json
+    let settings = {};
+    try {
+      const content = await fs.readFile(globalSettingsPath, 'utf8');
+      settings = JSON.parse(content);
+    } catch {
+      // File missing or invalid — start fresh
+    }
+
+    if (!settings.hooks) settings.hooks = {};
+
+    // Check if PostToolUse hook already registered
+    const existing = settings.hooks.PostToolUse;
+    const alreadyRegistered = Array.isArray(existing) &&
+      existing.some(entry =>
+        Array.isArray(entry.hooks) &&
+        entry.hooks.some(h => h.command && h.command.includes('bmad-party-speak'))
+      );
+
+    if (!alreadyRegistered) {
+      if (!Array.isArray(settings.hooks.PostToolUse)) {
+        settings.hooks.PostToolUse = [];
+      }
+      settings.hooks.PostToolUse.push({
+        hooks: [{ type: 'command', command: hookCommand }]
+      });
+      await fs.writeFile(globalSettingsPath, JSON.stringify(settings, null, 2));
+      spinner.succeed(chalk.green('BMAD party mode TTS hook configured!\n'));
+    } else {
+      // Script still updated above — just note settings unchanged
+      spinner.succeed(chalk.green('BMAD party mode TTS hook up to date\n'));
+    }
+  } catch (error) {
+    spinner.warn(chalk.yellow(`BMAD party mode hook setup skipped: ${error.message}\n`));
+  }
+}
+
 /**
  * Ensure target directory is a git repo (required for Claude Code hook context injection)
  * @param {string} targetDir - Target installation directory
@@ -4781,7 +4851,8 @@ async function updateCommandFiles(targetDir, spinner) {
  * These hooks contain bug fixes (e.g. markdown stripping) that must propagate
  * on every `npx agentvibes update` regardless of target directory.
  */
-const CRITICAL_HOOKS = ['stop-tts.sh', 'stop.sh', 'play-tts.sh', 'session-start-tts.sh'];
+const CRITICAL_HOOKS = ['stop-tts.sh', 'stop.sh', 'play-tts.sh', 'session-start-tts.sh', 'bmad-party-speak.sh'];
+const CRITICAL_HOOKS_WINDOWS = ['play-tts.ps1', 'session-start-tts.ps1', 'bmad-speak.ps1', 'bmad-party-speak.ps1'];
 
 /**
  * Update critical hooks in the global ~/.claude/hooks/ directory if it exists.
@@ -4811,6 +4882,27 @@ async function updateGlobalHooks(srcHooksDir, homeDirOverride) {
       // file not in global dir or src missing — skip silently
     }
   }
+
+  // Also update Windows global hooks-windows dir if present
+  const globalHooksWindowsDir = path.join(homeDirOverride || os.homedir(), '.claude', 'hooks-windows');
+  const srcHooksWindowsDir = path.join(path.dirname(srcHooksDir), 'hooks-windows');
+  try {
+    await fs.access(globalHooksWindowsDir);
+    for (const hook of CRITICAL_HOOKS_WINDOWS) {
+      const destPath = path.join(globalHooksWindowsDir, hook);
+      const srcPath = path.join(srcHooksWindowsDir, hook);
+      try {
+        await fs.access(destPath); // only update if already installed
+        await fs.copyFile(srcPath, destPath);
+        updated++;
+      } catch {
+        // file not in global dir or src missing — skip silently
+      }
+    }
+  } catch {
+    // hooks-windows dir not present — nothing to do
+  }
+
   return updated;
 }
 
@@ -4873,6 +4965,7 @@ async function performUpdateOperations(targetDir, spinner) {
   // Update settings.json
   spinner.text = 'Updating AgentVibes hook configuration...';
   await configureSessionStartHook(targetDir, silentSpinner);
+  await configurePartyModeHook(targetDir, silentSpinner);
   await ensureGitRepo(targetDir, silentSpinner);
 
   // Detect and migrate old configuration
@@ -5050,6 +5143,7 @@ async function install(options = {}) {
     await copyBackgroundMusicFiles(targetDir, silentSpinner);
     await copyConfigFiles(targetDir, silentSpinner);
     await configureSessionStartHook(targetDir, silentSpinner);
+    await configurePartyModeHook(targetDir, silentSpinner);
     await installPluginManifest(targetDir, silentSpinner);
     await ensureGitRepo(targetDir, silentSpinner);
 
@@ -5943,7 +6037,7 @@ export {
   isTermux, isNativeWindows, detectAndNotifyTermux,
   copyCommandFiles, copyHookFiles, copyPersonalityFiles,
   copyPluginFiles, copyBmadConfigFiles, copyBackgroundMusicFiles,
-  copyConfigFiles, configureSessionStartHook, ensureGitRepo,
+  copyConfigFiles, configureSessionStartHook, configurePartyModeHook, ensureGitRepo,
   installPluginManifest, checkAndInstallPiper,
-  updateGlobalHooks, CRITICAL_HOOKS,
+  updateGlobalHooks, CRITICAL_HOOKS, CRITICAL_HOOKS_WINDOWS,
 };