agentvibes 5.6.7 → 5.6.9

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

@@ -1 +1 @@
-20260508
+20260509

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

@@ -0,0 +1,225 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/bmad-party-manager.sh
+#
+# AgentVibes - Finally, your AI Agents can Talk Back! Text-to-Speech WITH personality for AI Assistants!
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Co-created by Paul Preibisch with Claude AI
+# Copyright (c) 2025 Paul Preibisch
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# DISCLAIMER: This software is provided "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# express or implied, including but not limited to the warranties of
+# merchantability, fitness for a particular purpose and noninfringement.
+# In no event shall the authors or copyright holders be liable for any claim,
+# damages or other liability, whether in an action of contract, tort or
+# otherwise, arising from, out of or in connection with the software or the
+# use or other dealings in the software.
+#
+# ---
+#
+# @fileoverview BMAD Party Mode Voice Integration Manager
+# @context Controls auto-enable/disable of multi-agent voice switching during BMAD party mode
+# @architecture Opt-out flag management, auto-detection, status reporting
+# @dependencies .bmad/_cfg/agent-manifest.csv, bmad-voices-enabled.flag, user-prompt-output.sh
+# @entrypoints /agent-vibes:bmad-party slash command
+# @patterns Auto-enable with opt-out, graceful degradation, feature detection
+# @related user-prompt-output.sh, bmad-voice-manager.sh, Issue #33
+
+# Fix locale warnings
+export LC_ALL=C
+
+PLUGIN_DIR=".claude/plugins"
+DISABLE_FLAG="$PLUGIN_DIR/bmad-party-mode-disabled.flag"
+BMAD_VOICES_FLAG="$PLUGIN_DIR/bmad-voices-enabled.flag"
+BMAD_MANIFEST=".bmad/_cfg/agent-manifest.csv"
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+CYAN='\033[0;36m'
+GRAY='\033[0;90m'
+NC='\033[0m' # No Color
+
+#
+# @function is_bmad_installed
+# @context Check if BMAD v6 is installed
+# @returns 0=installed, 1=not installed
+#
+is_bmad_installed() {
+  [[ -f "$BMAD_MANIFEST" ]]
+}
+
+#
+# @function is_bmad_voices_enabled
+# @context Check if BMAD voice plugin is enabled
+# @returns 0=enabled, 1=disabled
+#
+is_bmad_voices_enabled() {
+  [[ -f "$BMAD_VOICES_FLAG" ]]
+}
+
+#
+# @function is_party_mode_enabled
+# @context Check if party mode voice integration is enabled
+# @returns 0=enabled, 1=disabled
+#
+is_party_mode_enabled() {
+  # Disabled if opt-out flag exists
+  [[ -f "$DISABLE_FLAG" ]] && return 1
+
+  # Enabled if BMAD + voice plugin active
+  is_bmad_installed && is_bmad_voices_enabled
+}
+
+#
+# @function show_status
+# @context Display current party mode voice integration status
+#
+show_status() {
+  echo -e "${CYAN}🎭 BMAD Party Mode Voice Integration${NC}"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+
+  # Check BMAD installation
+  if ! is_bmad_installed; then
+    echo -e "${RED}❌ BMAD not installed${NC}"
+    echo -e "${GRAY}   Party mode voice integration requires BMAD v6${NC}"
+    echo -e "${GRAY}   Install: https://github.com/bmad-method/bmad${NC}"
+    echo ""
+    return 1
+  fi
+
+  echo -e "${GREEN}✅ BMAD v6 detected${NC}"
+
+  # Check voice plugin
+  if ! is_bmad_voices_enabled; then
+    echo -e "${RED}❌ BMAD voice plugin disabled${NC}"
+    echo -e "${GRAY}   Enable: /agent-vibes:bmad enable${NC}"
+    echo ""
+    return 1
+  fi
+
+  echo -e "${GREEN}✅ BMAD voice plugin enabled${NC}"
+
+  # Check party mode status
+  if is_party_mode_enabled; then
+    echo -e "${GREEN}✅ Party mode voices: ENABLED${NC}"
+    echo ""
+    echo -e "${CYAN}How it works:${NC}"
+    echo "  When you run /bmad:core:workflows:party-mode,"
+    echo "  each agent speaks with their unique voice:"
+    echo ""
+    echo "  🏗️  Winston (Architect) → Michael"
+    echo "  📋 John (PM) → Jessica Anne Bogart"
+    echo "  💻 Amelia (Dev) → Matthew Schmitz"
+    echo "  📊 Mary (Analyst) → kristin"
+    echo "  ... and more!"
+    echo ""
+    echo -e "${GRAY}Disable with: /agent-vibes:bmad-party disable${NC}"
+  else
+    echo -e "${YELLOW}⚠️  Party mode voices: DISABLED (opt-out active)${NC}"
+    echo ""
+    echo -e "${GRAY}Enable with: /agent-vibes:bmad-party enable${NC}"
+  fi
+
+  echo ""
+}
+
+#
+# @function enable_party_mode
+# @context Enable party mode voice integration (remove opt-out flag)
+#
+enable_party_mode() {
+  # Verify prerequisites
+  if ! is_bmad_installed; then
+    echo -e "${RED}❌ Cannot enable: BMAD not installed${NC}"
+    echo -e "${GRAY}   Install BMAD v6 first${NC}"
+    return 1
+  fi
+
+  if ! is_bmad_voices_enabled; then
+    echo -e "${RED}❌ Cannot enable: BMAD voice plugin disabled${NC}"
+    echo -e "${GRAY}   Enable with: /agent-vibes:bmad enable${NC}"
+    return 1
+  fi
+
+  # Remove opt-out flag if it exists
+  if [[ -f "$DISABLE_FLAG" ]]; then
+    rm -f "$DISABLE_FLAG"
+    echo -e "${GREEN}✅ Party mode voices enabled${NC}"
+    echo ""
+    echo -e "${CYAN}🎭 Multi-agent voice switching activated!${NC}"
+    echo "   Run /bmad:core:workflows:party-mode to hear agents speak"
+  else
+    echo -e "${GREEN}✅ Party mode voices already enabled${NC}"
+    echo ""
+    echo -e "${GRAY}(Auto-enabled when BMAD detected)${NC}"
+  fi
+
+  echo ""
+}
+
+#
+# @function disable_party_mode
+# @context Disable party mode voice integration (create opt-out flag)
+#
+disable_party_mode() {
+  mkdir -p "$PLUGIN_DIR"
+
+  if [[ -f "$DISABLE_FLAG" ]]; then
+    echo -e "${YELLOW}⚠️  Party mode voices already disabled${NC}"
+    return 0
+  fi
+
+  # Create opt-out flag
+  touch "$DISABLE_FLAG"
+
+  echo -e "${GREEN}✅ Party mode voices disabled${NC}"
+  echo ""
+  echo -e "${GRAY}Party mode will continue to work, but agents won't speak${NC}"
+  echo -e "${GRAY}Enable again with: /agent-vibes:bmad-party enable${NC}"
+  echo ""
+}
+
+# Main command dispatcher
+case "${1:-status}" in
+  enable)
+    enable_party_mode
+    ;;
+  disable)
+    disable_party_mode
+    ;;
+  status)
+    show_status
+    ;;
+  *)
+    echo -e "${CYAN}AgentVibes BMAD Party Mode Manager${NC}"
+    echo ""
+    echo "Usage: bmad-party-manager.sh {enable|disable|status}"
+    echo ""
+    echo "Commands:"
+    echo "  enable     Enable party mode voice integration"
+    echo "  disable    Disable party mode voice integration (opt-out)"
+    echo "  status     Show current status and configuration"
+    echo ""
+    echo "Party Mode Voice Integration:"
+    echo "  • Auto-enabled when BMAD v6 detected"
+    echo "  • Each agent speaks with unique voice during party mode"
+    echo "  • Opt-out available via disable command"
+    ;;
+esac

package/.claude/hooks/play-tts-piper.sh

@@ -91,6 +91,7 @@ DEFAULT_VOICE="en_US-lessac-medium"
 # @returns Sets $VOICE_MODEL global variable
 # @sideeffects None
 VOICE_MODEL=""
+FILE_VOICE=""
 
 # Get current language setting
 CURRENT_LANGUAGE=$(get_language_code)
@@ -206,6 +207,15 @@ else
   fi
 fi
 
+# Preserve full display name (with ::SpeakerName) before any stripping for logging
+if [[ -n "$VOICE_OVERRIDE" ]]; then
+  DISPLAY_VOICE_NAME="$VOICE_OVERRIDE"
+elif [[ -n "$FILE_VOICE" ]]; then
+  DISPLAY_VOICE_NAME="$FILE_VOICE"
+else
+  DISPLAY_VOICE_NAME="$VOICE_MODEL"
+fi
+
 # @function validate_inputs
 # @intent Check required parameters
 # @why Fail fast with clear errors if inputs missing
@@ -215,6 +225,10 @@ if [[ -z "$TEXT" ]]; then
   exit 1
 fi
 
+# Augment PATH for non-interactive shells (pipx installs to ~/.local/bin which
+# interactive shells get via .bashrc/.zshrc, but Bash tool calls skip profile)
+export PATH="$HOME/.local/bin:$HOME/.local/share/pipx/venvs/piper-tts/bin:$PATH"
+
 # Check if Piper is installed
 if ! command -v piper &> /dev/null; then
   echo "❌ Error: Piper TTS not installed"
@@ -454,7 +468,7 @@ if [[ -f "$SCRIPT_DIR/audio-processor.sh" ]]; then
   # audio-processor.sh returns: FILE_PATH|BACKGROUND_FILE
   # Lookup order: LLM key (from --llm) → default
   _AGENT_KEY="${AGENTVIBES_LLM_KEY:-default}"
-  PROCESSOR_OUTPUT=$("$SCRIPT_DIR/audio-processor.sh" "$TEMP_FILE" "$_AGENT_KEY" "$PROCESSED_FILE" "$AGENT_PROFILE_FILE" 2>/dev/null) || {
+  PROCESSOR_OUTPUT=$(bash "$SCRIPT_DIR/audio-processor.sh" "$TEMP_FILE" "$_AGENT_KEY" "$PROCESSED_FILE" "$AGENT_PROFILE_FILE" 2>/dev/null) || {
     echo "Warning: Audio processing failed, using unprocessed audio" >&2
     PROCESSED_FILE="$TEMP_FILE"
     PROCESSOR_OUTPUT="$TEMP_FILE|"
@@ -614,7 +628,31 @@ if [[ -n "$BACKGROUND_MUSIC" ]]; then
   MUSIC_FILENAME=$(basename "$BACKGROUND_MUSIC")
   echo -e "${WHITE}🎵 Background music:${NC} ${PURPLE}$MUSIC_FILENAME${NC}"
 fi
-echo -e "${WHITE}🎤 Voice used:${NC} ${BLUE}$VOICE_MODEL${NC} ${WHITE}(Piper TTS)${NC}"
+# Build friendly label: "model::Mike-13 [Mike Nash]"
+_SURNAME_POOL=("Bell" "Carter" "Davis" "Ellis" "Foster" "Gray" "Hayes" "Irving" "Jones" "Knox" "Lane" "Mason" "Nash" "Owens" "Pierce" "Quinn")
+_VOICE_DISPLAY_LABEL="$DISPLAY_VOICE_NAME"
+if [[ "$DISPLAY_VOICE_NAME" == *"::"* ]]; then
+  _SP="${DISPLAY_VOICE_NAME#*::}"
+  # Skip 16Speakers names (underscore = already first_last format)
+  if [[ "$_SP" != *"_"* ]]; then
+    _FRIENDLY=""
+    if [[ "$_SP" =~ ^(.+)-([0-9]+)$ ]]; then
+      if [[ ${BASH_REMATCH[2]} -ge 2 ]]; then
+        _IDX=$(( (${BASH_REMATCH[2]} - 1) % 16 ))
+        _FRIENDLY="${BASH_REMATCH[1]} ${_SURNAME_POOL[$_IDX]}"
+      else
+        # n=1: strip suffix, use Bell — matches uniquifyVoiceName JS behaviour
+        _FRIENDLY="${BASH_REMATCH[1]} ${_SURNAME_POOL[0]}"
+      fi
+    elif [[ "$_SP" =~ [[:space:]] ]]; then
+      _FRIENDLY="$_SP"
+    else
+      _FRIENDLY="$_SP ${_SURNAME_POOL[0]}"
+    fi
+    [[ "$_FRIENDLY" != "$_SP" ]] && _VOICE_DISPLAY_LABEL="$DISPLAY_VOICE_NAME [$_FRIENDLY]"
+  fi
+fi
+echo -e "${WHITE}🎤 Voice used:${NC} ${BLUE}$_VOICE_DISPLAY_LABEL${NC} ${WHITE}(Piper TTS)${NC}"
 
 # Show personality if configured
 PERSONALITY=$(cat "$PROJECT_ROOT/.claude/tts-personality.txt" 2>/dev/null || cat "$HOME/.claude/tts-personality.txt" 2>/dev/null || echo "")

package/.claude/hooks/play-tts.sh

@@ -115,6 +115,15 @@ while [[ $# -gt 0 ]]; do
       LLM_PROVIDER="${2:-}"
       shift 2
       ;;
+    --project-dir)
+      # Always prefer the explicitly-injected project dir over any stale
+      # CLAUDE_PROJECT_DIR in the environment (fixes silent override by env).
+      # Validate the path exists before trusting it.
+      if [[ -n "${2:-}" && -d "${2}" ]]; then
+        export CLAUDE_PROJECT_DIR="${2}"
+      fi
+      shift 2
+      ;;
     *)
       _POSITIONAL_ARGS+=("$1")
       shift
@@ -194,6 +203,10 @@ if [[ -n "$LLM_PROVIDER" ]]; then
   fi
   # Export LLM key for child scripts (process-local, not system-wide)
   export AGENTVIBES_LLM_KEY="llm:${LLM_PROVIDER}"
+  # Emit routing info when verbose debugging is enabled (used by tests and diagnostics)
+  if [[ "${AGENTVIBES_VERBOSE:-0}" == "1" ]]; then
+    echo "llm=${LLM_PROVIDER}" >&2
+  fi
 fi
 
 # Prepend intro text (pretext) if configured

package/.claude/hooks/post-response.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# AgentVibes TTS Hook - Triggers on assistant responses
+# This hook is called after Claude generates a response
+
+set -euo pipefail
+
+# Get the hooks directory
+HOOKS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(dirname "$(dirname "$HOOKS_DIR")")"
+
+# Check if AgentVibes is muted for this project
+if [[ -f "$PROJECT_ROOT/.claude/agentvibes-muted" ]]; then
+    exit 0  # Silently skip TTS
+fi
+
+# Check if unmuted flag exists (overrides global mute)
+if [[ ! -f "$PROJECT_ROOT/.claude/agentvibes-unmuted" ]]; then
+    # Check global mute
+    if [[ -f "$HOME/.agentvibes-muted" ]]; then
+        exit 0  # Silently skip TTS
+    fi
+fi
+
+# Get the assistant's response text from stdin or arguments
+RESPONSE_TEXT="${1:-}"
+if [[ -z "$RESPONSE_TEXT" ]]; then
+    # Try reading from stdin if available
+    if [[ -p /dev/stdin ]]; then
+        RESPONSE_TEXT=$(cat)
+    fi
+fi
+
+# Skip if no text
+if [[ -z "$RESPONSE_TEXT" ]]; then
+    exit 0
+fi
+
+# Play TTS using the main play-tts script
+"$HOOKS_DIR/play-tts.sh" "$RESPONSE_TEXT" &
+
+exit 0

package/.claude/hooks/session-start-tts.sh

@@ -10,18 +10,49 @@ set -euo pipefail
 # Fix locale warnings
 export LC_ALL=C
 
-# Get script directory
+# Get script directory (resolve symlinks so $SCRIPT_DIR is the real hooks dir)
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
+# Resolve absolute path to play-tts.sh from this script's own location.
+# Using an absolute path in the injected protocol ensures the correct
+# play-tts.sh is called regardless of the working directory when Claude
+# runs the command — fixes "wrong voice in fresh folder" regression.
+PLAY_TTS_PATH="$SCRIPT_DIR/play-tts.sh"
+
 # Check if AgentVibes is installed
-if [[ ! -f "$SCRIPT_DIR/play-tts.sh" ]]; then
+if [[ ! -f "$PLAY_TTS_PATH" ]]; then
   # AgentVibes not installed, don't inject anything
   exit 0
 fi
 
+# Capture project dir NOW while Claude Code has set CLAUDE_PROJECT_DIR.
+# Bash tool calls (how Claude actually runs play-tts.sh) do not automatically
+# receive CLAUDE_PROJECT_DIR, so we bake it into the injected protocol command
+# via --project-dir so the correct per-project config is always found.
+CAPTURED_PROJECT_DIR=""
+if [[ -n "${CLAUDE_PROJECT_DIR:-}" && -d "$CLAUDE_PROJECT_DIR/.claude" ]]; then
+  CAPTURED_PROJECT_DIR="$CLAUDE_PROJECT_DIR"
+  _PROJECT_CLAUDE_DIR="$CLAUDE_PROJECT_DIR/.claude"
+else
+  # Fallback: script lives inside .claude/hooks/, so parent IS .claude/
+  _PROJECT_CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
+fi
+
+# Build --project-dir flag to embed in TTS commands.
+# Sanitize: strip any embedded quotes that would break shell quoting.
+PROJECT_DIR_FLAG=""
+if [[ -n "$CAPTURED_PROJECT_DIR" ]]; then
+  _SAFE_PROJECT_DIR="${CAPTURED_PROJECT_DIR//\"/}"
+  PROJECT_DIR_FLAG=" --project-dir \"$_SAFE_PROJECT_DIR\""
+fi
+
 # Check for sentiment (priority) or personality (fallback)
-SENTIMENT=$(cat .claude/tts-sentiment.txt 2>/dev/null || cat ~/.claude/tts-sentiment.txt 2>/dev/null || echo "")
-PERSONALITY=$(cat .claude/tts-personality.txt 2>/dev/null || cat ~/.claude/tts-personality.txt 2>/dev/null || echo "normal")
+SENTIMENT=$(cat "$_PROJECT_CLAUDE_DIR/tts-sentiment.txt" 2>/dev/null \
+  || cat "$HOME/.claude/tts-sentiment.txt" 2>/dev/null \
+  || echo "")
+PERSONALITY=$(cat "$_PROJECT_CLAUDE_DIR/tts-personality.txt" 2>/dev/null \
+  || cat "$HOME/.claude/tts-personality.txt" 2>/dev/null \
+  || echo "normal")
 
 # Determine style
 if [[ -n "$SENTIMENT" ]]; then
@@ -31,26 +62,30 @@ else
 fi
 
 # Get verbosity level (Issue #32)
-VERBOSITY=$(cat .claude/tts-verbosity.txt 2>/dev/null || cat ~/.claude/tts-verbosity.txt 2>/dev/null || echo "low")
+VERBOSITY=$(cat "$_PROJECT_CLAUDE_DIR/tts-verbosity.txt" 2>/dev/null \
+  || cat "$HOME/.claude/tts-verbosity.txt" 2>/dev/null \
+  || echo "low")
 
-# Output optimized TTS protocol
-cat <<'EOF'
+# Output optimized TTS protocol.
+# Note: heredoc uses double-quotes (<<EOF not <<'EOF') so $PLAY_TTS_PATH expands.
+# Backticks must be escaped (\`) to avoid command substitution.
+cat << EOF
 
 # AgentVibes TTS Protocol
 
 **CRITICAL: You MUST execute TTS at TWO points for EVERY user interaction:**
 
-1. **Acknowledgment** - Start of task: `Bash: .claude/hooks/play-tts.sh "[action]"`
-2. **Completion** - End of task: `Bash: .claude/hooks/play-tts.sh "[result + key details]"`
+1. **Acknowledgment** - Start of task: \`Bash: $PLAY_TTS_PATH "[action]" --llm claude-code$PROJECT_DIR_FLAG\`
+2. **Completion** - End of task: \`Bash: $PLAY_TTS_PATH "[result + key details]" --llm claude-code$PROJECT_DIR_FLAG\`
 
 **IMPORTANT: Run TTS commands inline (NOT in background). Wait for each TTS call to complete before continuing.**
 
 **Example:**
-```
-[Bash: .claude/hooks/play-tts.sh "Checking git status"]
+\`\`\`
+[Bash: $PLAY_TTS_PATH "Checking git status" --llm claude-code$PROJECT_DIR_FLAG]
 [work...]
-[Bash: .claude/hooks/play-tts.sh "Repository is clean, no changes"]
-```
+[Bash: $PLAY_TTS_PATH "Repository is clean, no changes" --llm claude-code$PROJECT_DIR_FLAG]
+\`\`\`
 
 EOF
 

package/.claude/hooks/stop.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/stop.sh
+#
+# AgentVibes Stop Hook - Wrapper that delegates to .agentvibes/
+# This hook runs in LITE mode to extract and speak "Audio Summary:" markers
+#
+
+# Fix locale warnings
+export LC_ALL=C
+
+# Get script directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+
+# Path to mode configuration
+MODE_FILE="$PROJECT_ROOT/.agentvibes/config/mode.txt"
+
+# Check if AgentVibes is installed
+AGENTVIBES_HOOKS="$PROJECT_ROOT/.agentvibes/hooks"
+if [[ ! -d "$AGENTVIBES_HOOKS" ]]; then
+  # AgentVibes not installed, exit silently
+  exit 0
+fi
+
+# Read current mode (default to full if not set)
+CURRENT_MODE="full"
+if [[ -f "$MODE_FILE" ]]; then
+  CURRENT_MODE=$(cat "$MODE_FILE" 2>/dev/null | tr -d '[:space:]')
+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 &
+  fi
+fi