agentvibes 3.5.9 → 4.0.0

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

@@ -35,11 +35,21 @@
 # @related play-tts.sh, piper-voice-manager.sh, language-manager.sh, GitHub Issue #25
 #
 
+set -eo pipefail
+# Note: -u (nounset) omitted because sourced scripts (piper-voice-manager.sh,
+# language-manager.sh, audio-cache-utils.sh) use unset variables freely.
+# Variables in THIS script use ${VAR:-} defaults for safety.
+
+# Cleanup handler for temp files
+_CLEANUP_FILES=()
+cleanup() { rm -f "${_CLEANUP_FILES[@]+"${_CLEANUP_FILES[@]}"}"; }
+trap cleanup EXIT
+
 # Fix locale warnings
 export LC_ALL=C
 
-TEXT="$1"
-VOICE_OVERRIDE="$2"  # Optional: voice model name
+TEXT="${1:-}"
+VOICE_OVERRIDE="${2:-}"  # Optional: voice model name
 
 # Source voice manager and language manager
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
@@ -74,7 +84,7 @@ else
   # 2. Script location (for direct slash command usage)
   # 3. Global ~/.claude (fallback)
 
-  if [[ -n "$CLAUDE_PROJECT_DIR" ]] && [[ -f "$CLAUDE_PROJECT_DIR/.claude/tts-voice.txt" ]]; then
+  if [[ -n "${CLAUDE_PROJECT_DIR:-}" ]] && [[ "${CLAUDE_PROJECT_DIR:-}" != *".."* ]] && [[ -f "$CLAUDE_PROJECT_DIR/.claude/tts-voice.txt" ]]; then
     # MCP context: Use the project directory where MCP was invoked
     VOICE_FILE="$CLAUDE_PROJECT_DIR/.claude/tts-voice.txt"
   elif [[ -f "$SCRIPT_DIR/../tts-voice.txt" ]]; then
@@ -95,13 +105,32 @@ else
     SPEAKER_ID_FILE="$VOICE_DIR/tts-piper-speaker-id.txt"
 
     if [[ -f "$MODEL_FILE" ]] && [[ -f "$SPEAKER_ID_FILE" ]]; then
-      # Multi-speaker voice
+      # Multi-speaker voice config found locally
       VOICE_MODEL=$(cat "$MODEL_FILE" 2>/dev/null)
       SPEAKER_ID=$(cat "$SPEAKER_ID_FILE" 2>/dev/null)
-      echo "🎭 Using multi-speaker voice: $FILE_VOICE (Model: $VOICE_MODEL, Speaker ID: $SPEAKER_ID)"
-    # Check if it's a standard Piper model name or custom voice (just use as-is)
+      # Validate speaker ID is numeric
+      if [[ -n "$SPEAKER_ID" ]] && ! [[ "$SPEAKER_ID" =~ ^[0-9]+$ ]]; then
+        echo "Warning: Invalid speaker ID '$SPEAKER_ID', ignoring" >&2
+        SPEAKER_ID=""
+      fi
+      echo "🎭 Using multi-speaker voice: $FILE_VOICE (Model: $VOICE_MODEL, Speaker ID: ${SPEAKER_ID:-none})"
+    # Fallback: check global ~/.claude/ for multi-speaker config files
+    elif [[ -f "$HOME/.claude/tts-piper-model.txt" ]] && [[ -f "$HOME/.claude/tts-piper-speaker-id.txt" ]]; then
+      VOICE_MODEL=$(cat "$HOME/.claude/tts-piper-model.txt" 2>/dev/null)
+      SPEAKER_ID=$(cat "$HOME/.claude/tts-piper-speaker-id.txt" 2>/dev/null)
+      if [[ -n "$SPEAKER_ID" ]] && ! [[ "$SPEAKER_ID" =~ ^[0-9]+$ ]]; then
+        echo "Warning: Invalid speaker ID '$SPEAKER_ID', ignoring" >&2
+        SPEAKER_ID=""
+      fi
+      echo "🎭 Using multi-speaker voice (global): $FILE_VOICE (Model: $VOICE_MODEL, Speaker ID: ${SPEAKER_ID:-none})"
+    # Single-speaker voice or custom voice name
     elif [[ -n "$FILE_VOICE" ]]; then
-      VOICE_MODEL="$FILE_VOICE"
+      # Strip multi-speaker suffix if present (model::SpeakerName-Label)
+      if [[ "$FILE_VOICE" == *"::"* ]]; then
+        VOICE_MODEL="${FILE_VOICE%%::*}"
+      else
+        VOICE_MODEL="$FILE_VOICE"
+      fi
     fi
   fi
 
@@ -178,7 +207,7 @@ fi
 # @intent Find appropriate directory for audio file storage
 # @why Supports project-local and global storage
 # @returns Sets $AUDIO_DIR global variable
-if [[ -n "$CLAUDE_PROJECT_DIR" ]]; then
+if [[ -n "${CLAUDE_PROJECT_DIR:-}" ]]; then
   AUDIO_DIR="$CLAUDE_PROJECT_DIR/.claude/audio"
 else
   # Fallback: try to find .claude directory in current path
@@ -191,13 +220,13 @@ else
     CURRENT_DIR=$(dirname "$CURRENT_DIR")
   done
   # Final fallback to global if no project .claude found
-  if [[ -z "$AUDIO_DIR" ]]; then
+  if [[ -z "${AUDIO_DIR:-}" ]]; then
     AUDIO_DIR="$HOME/.claude/audio"
   fi
 fi
 
 mkdir -p "$AUDIO_DIR"
-TEMP_FILE="$AUDIO_DIR/tts-$(date +%s).wav"
+TEMP_FILE=$(mktemp "$AUDIO_DIR/tts-XXXXXX.wav")
 
 # @function get_speech_rate
 # @intent Determine speech rate for Piper synthesis
@@ -233,6 +262,11 @@ get_speech_rate() {
   # If this is a non-English voice and target config exists, use it
   if [[ "$CURRENT_LANGUAGE" != "english" ]] && [[ -n "$target_config" ]]; then
     local user_speed=$(cat "$target_config" 2>/dev/null)
+    # Validate speed is a positive number
+    if ! [[ "$user_speed" =~ ^[0-9]*\.?[0-9]+$ ]] || [[ "$user_speed" == "0" ]] || [[ "$user_speed" == "0.0" ]]; then
+      echo "1.0"
+      return
+    fi
     # Convert user speed to Piper length-scale (invert)
     # User: 0.5=slower, 1.0=normal, 2.0=faster
     # Piper: 2.0=slower, 1.0=normal, 0.5=faster
@@ -244,6 +278,11 @@ get_speech_rate() {
   # Otherwise use main config if available
   if [[ -n "$main_config" ]]; then
     local user_speed=$(grep -v '^#' "$main_config" 2>/dev/null | grep -v '^$' | tail -1)
+    # Validate speed is a positive number
+    if ! [[ "$user_speed" =~ ^[0-9]*\.?[0-9]+$ ]] || [[ "$user_speed" == "0" ]] || [[ "$user_speed" == "0.0" ]]; then
+      echo "1.0"
+      return
+    fi
     echo "scale=2; 1.0 / $user_speed" | bc -l 2>/dev/null || echo "1.0"
     return
   fi
@@ -266,7 +305,7 @@ SPEECH_RATE=$(get_speech_rate)
 # @exitcode 0=success, 4=synthesis error
 # @sideeffects Creates audio file
 # @edgecases Handles piper errors, invalid models, multi-speaker voices
-if [[ -n "$SPEAKER_ID" ]]; then
+if [[ -n "${SPEAKER_ID:-}" ]]; then
   # Multi-speaker voice: Pass speaker ID
   # Add 2-second pause between sentences for better pacing
   echo "$TEXT" | piper --model "$VOICE_PATH" --speaker "$SPEAKER_ID" --length-scale "$SPEECH_RATE" --sentence-silence 2.0 --output_file "$TEMP_FILE" 2>/dev/null
@@ -303,7 +342,8 @@ fi
 # @returns Updates $TEMP_FILE to compressed version
 # @sideeffects Converts to mono 22kHz for lower bandwidth
 if [[ "${AGENTVIBES_RDP_MODE:-false}" == "true" ]] && command -v ffmpeg &> /dev/null; then
-  COMPRESSED_FILE="$AUDIO_DIR/tts-compressed-$(date +%s).wav"
+  COMPRESSED_FILE=$(mktemp "$AUDIO_DIR/tts-compressed-XXXXXX.wav")
+  _CLEANUP_FILES+=("$COMPRESSED_FILE")
   # Convert to mono, 22kHz, 64kbps for remote sessions
   ffmpeg -i "$TEMP_FILE" -ac 1 -ar 22050 -b:a 64k -y "$COMPRESSED_FILE" 2>/dev/null
 
@@ -321,7 +361,8 @@ fi
 # @sideeffects Modifies audio file
 # AI NOTE: Use ffmpeg if available, otherwise skip padding (degraded experience)
 if command -v ffmpeg &> /dev/null; then
-  PADDED_FILE="$AUDIO_DIR/tts-padded-$(date +%s).wav"
+  PADDED_FILE=$(mktemp "$AUDIO_DIR/tts-padded-XXXXXX.wav")
+  _CLEANUP_FILES+=("$PADDED_FILE")
   # Add 200ms of silence at the beginning
   ffmpeg -f lavfi -i anullsrc=r=44100:cl=stereo:d=0.2 -i "$TEMP_FILE" \
     -filter_complex "[0:a][1:a]concat=n=2:v=0:a=1[out]" \
@@ -340,7 +381,8 @@ fi
 # @sideeffects Applies audio effects and background music
 BACKGROUND_MUSIC=""
 if [[ -f "$SCRIPT_DIR/audio-processor.sh" ]]; then
-  PROCESSED_FILE="$AUDIO_DIR/tts-processed-$(date +%s).wav"
+  PROCESSED_FILE=$(mktemp "$AUDIO_DIR/tts-processed-XXXXXX.wav")
+  _CLEANUP_FILES+=("$PROCESSED_FILE")
   # audio-processor.sh returns: FILE_PATH|BACKGROUND_FILE
   PROCESSOR_OUTPUT=$("$SCRIPT_DIR/audio-processor.sh" "$TEMP_FILE" "default" "$PROCESSED_FILE" 2>/dev/null) || {
     echo "Warning: Audio processing failed, using unprocessed audio" >&2
@@ -363,7 +405,10 @@ fi
 # @why Support multiple audio players and prevent overlapping audio in learning mode
 # @param Uses global: $TEMP_FILE, $CURRENT_LANGUAGE
 # @sideeffects Plays audio with lock mechanism for sequential playback
-LOCK_FILE="/tmp/agentvibes-audio.lock"
+_LOCK_DIR="${XDG_RUNTIME_DIR:-/tmp/agentvibes-$(id -u)}"
+mkdir -p "$_LOCK_DIR"
+chmod 700 "$_LOCK_DIR"
+LOCK_FILE="$_LOCK_DIR/agentvibes-audio.lock"
 
 # Wait for previous audio to finish (max 2 seconds to prevent blocking)
 for i in {1..4}; do
@@ -381,7 +426,7 @@ fi
 
 # Track last target language audio for replay command
 if [[ "$CURRENT_LANGUAGE" != "english" ]]; then
-  TARGET_AUDIO_FILE="${CLAUDE_PROJECT_DIR:-.}/.claude/last-target-audio.txt"
+  TARGET_AUDIO_FILE="${CLAUDE_PROJECT_DIR:-${HOME}}/.claude/last-target-audio.txt"
   echo "$TEMP_FILE" > "$TARGET_AUDIO_FILE"
 fi
 
@@ -389,12 +434,13 @@ fi
 touch "$LOCK_FILE"
 
 # Create write lock file in audio directory to signal file is in-use (prevents race condition in cleanup)
-AUDIO_DIR="${TEMP_FILE%/*}"
-WRITE_LOCK_FILE="$AUDIO_DIR/$(basename "$TEMP_FILE" .wav).lock"
+_TEMP_DIR="${TEMP_FILE%/*}"
+WRITE_LOCK_FILE="$_TEMP_DIR/$(basename "$TEMP_FILE" .wav).lock"
 touch "$WRITE_LOCK_FILE"
+_CLEANUP_FILES+=("$LOCK_FILE" "$WRITE_LOCK_FILE")
 
 # Get audio duration for proper lock timing
-DURATION=$(ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "$TEMP_FILE" 2>/dev/null)
+DURATION=$(ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "$TEMP_FILE" 2>/dev/null || true)
 DURATION=${DURATION%.*}  # Round to integer
 DURATION=${DURATION:-1}   # Default to 1 second if detection fails
 
@@ -473,10 +519,15 @@ 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}"
+# Show speaker name for multi-speaker voices, otherwise show model name
+if [[ -n "${SPEAKER_ID:-}" ]] && [[ -n "${FILE_VOICE:-}" ]]; then
+  echo -e "${WHITE}🎤 Voice used:${NC} ${BLUE}$FILE_VOICE${NC} ${WHITE}(Piper TTS)${NC}"
+else
+  echo -e "${WHITE}🎤 Voice used:${NC} ${BLUE}$VOICE_MODEL${NC} ${WHITE}(Piper TTS)${NC}"
+fi
 
 # 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 "")
+PERSONALITY=$(cat "${PROJECT_ROOT:-/nonexistent}/.claude/tts-personality.txt" 2>/dev/null || cat "$HOME/.claude/tts-personality.txt" 2>/dev/null || echo "")
 if [[ -n "$PERSONALITY" ]] && [[ "$PERSONALITY" != "none" ]] && [[ "$PERSONALITY" != "normal" ]]; then
   echo -e "${WHITE}💫 Personality:${NC} ${YELLOW}$PERSONALITY${NC}"
 fi
@@ -491,9 +542,10 @@ fi
 
 # Show status indicators
 GLOBAL_MUTE_FILE="$HOME/.agentvibes-muted"
-PROJECT_MUTE_FILE="$PROJECT_ROOT/.claude/agentvibes-muted"
-PROJECT_UNMUTE_FILE="$PROJECT_ROOT/.claude/agentvibes-unmuted"
-BACKGROUND_ENABLED_FILE="$PROJECT_ROOT/.claude/config/background-music-enabled.txt"
+PROJECT_MUTE_FILE="${PROJECT_ROOT:-/nonexistent}/.claude/agentvibes-muted"
+PROJECT_UNMUTE_FILE="${PROJECT_ROOT:-/nonexistent}/.claude/agentvibes-unmuted"
+BACKGROUND_ENABLED_FILE="${PROJECT_ROOT:-/nonexistent}/.claude/config/background-music-enabled.txt"
+GLOBAL_BACKGROUND_ENABLED_FILE="$HOME/.claude/config/background-music-enabled.txt"
 
 # Mute status indicator
 if [[ -f "$PROJECT_UNMUTE_FILE" ]] && [[ -f "$GLOBAL_MUTE_FILE" ]]; then
@@ -506,7 +558,13 @@ fi
 
 # Background music status indicator
 if [[ -z "$BACKGROUND_MUSIC" ]]; then
+  _bg_enabled=false
   if [[ -f "$BACKGROUND_ENABLED_FILE" ]] && grep -q "true" "$BACKGROUND_ENABLED_FILE" 2>/dev/null; then
+    _bg_enabled=true
+  elif [[ -f "$GLOBAL_BACKGROUND_ENABLED_FILE" ]] && grep -q "true" "$GLOBAL_BACKGROUND_ENABLED_FILE" 2>/dev/null; then
+    _bg_enabled=true
+  fi
+  if [[ "$_bg_enabled" == "true" ]]; then
     echo -e "${WHITE}🎵 Background music:${NC} ${PURPLE}Enabled but not playing (check config)${NC}"
   else
     echo -e "${WHITE}🎵 Background music:${NC} ${PURPLE}Disabled${NC}"

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

@@ -70,21 +70,19 @@ ENCODED_AGENT=$(printf '%s' "$AGENT_NAME" | base64 -w 0)
 # Send text to remote for local AgentVibes playback
 echo "📱 Sending to $SSH_HOST for local playback..." >&2
 
-# Determine which receiver script exists and send encoded text, voice, and agent name
+# Try receiver scripts in order — single SSH call, no separate probe
 # SECURITY: Base64-encoded values are safe to pass as arguments (no shell metacharacters)
-# The receiver auto-detects and decodes base64 input
-if ssh "$SSH_HOST" "test -f ~/.termux/agentvibes-play.sh" 2>/dev/null; then
-  ssh "$SSH_HOST" "bash ~/.termux/agentvibes-play.sh '$ENCODED_TEXT' '$VOICE' '$ENCODED_AGENT'" &
-  SSH_PID=$!
-elif ssh "$SSH_HOST" "test -f ~/.agentvibes/play-remote.sh" 2>/dev/null; then
-  ssh "$SSH_HOST" "bash ~/.agentvibes/play-remote.sh '$ENCODED_TEXT' '$VOICE' '$ENCODED_AGENT'" &
-  SSH_PID=$!
-else
-  echo "⚠️  Receiver script not found on $SSH_HOST" >&2
-  echo "💡 Install: agentvibes install --ssh-receiver" >&2
-  exit 1
-fi
+ssh "$SSH_HOST" "
+  if [ -f ~/.agentvibes/play-remote.sh ]; then
+    bash ~/.agentvibes/play-remote.sh '$ENCODED_TEXT' '$VOICE' '$ENCODED_AGENT'
+  elif [ -f ~/.termux/agentvibes-play.sh ]; then
+    bash ~/.termux/agentvibes-play.sh '$ENCODED_TEXT' '$VOICE' '$ENCODED_AGENT'
+  else
+    echo 'Error: Receiver script not found' >&2
+    exit 1
+  fi
+" &
+SSH_PID=$!
 
-# Log the background PID for debugging (non-blocking)
-echo "✓ Sent to $SSH_HOST (PID: $SSH_PID, playing remotely)" >&2
+echo "Sent to $SSH_HOST (PID: $SSH_PID)" >&2
 exit 0

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

@@ -66,14 +66,14 @@ if [[ -f "$PROJECT_UNMUTE_FILE" ]]; then
 elif [[ -f "$PROJECT_MUTE_FILE" ]]; then
   # Project explicitly muted
   if [[ -f "$GLOBAL_MUTE_FILE" ]]; then
-    echo "🔇 TTS muted (project + global)"
+    echo "🔇 TTS muted (project + global)" >&2
   else
-    echo "🔇 TTS muted (project)"
+    echo "🔇 TTS muted (project)" >&2
   fi
   exit 0
 elif [[ -f "$GLOBAL_MUTE_FILE" ]]; then
   # Global mute and no project-level override
-  echo "🔇 TTS muted (global)"
+  echo "🔇 TTS muted (global)" >&2
   exit 0
 fi
 
@@ -101,6 +101,17 @@ TEXT="${TEXT//\\,/,}"        # Remove \,
 TEXT="${TEXT//\\./.}"        # Remove \. (keep the period)
 TEXT="${TEXT//\\\\/\\}"      # Remove \\ (escaped backslash)
 
+# Prepend intro text (pretext) if configured
+# Check project-local first, then global
+_PRETEXT_FILE="$PROJECT_ROOT/.claude/config/intro-text.txt"
+[[ -f "$_PRETEXT_FILE" ]] || _PRETEXT_FILE="$HOME/.claude/config/intro-text.txt"
+if [[ -f "$_PRETEXT_FILE" ]]; then
+  _PRETEXT="$(head -1 "$_PRETEXT_FILE" 2>/dev/null || true)"
+  if [[ -n "$_PRETEXT" ]]; then
+    TEXT="${_PRETEXT} ${TEXT}"
+  fi
+fi
+
 # Source provider manager to get active provider
 source "$SCRIPT_DIR/provider-manager.sh"
 
@@ -280,8 +291,8 @@ case "$ACTIVE_PROVIDER" in
     exec "$SCRIPT_DIR/play-tts-termux-ssh.sh" "$TEXT" "$VOICE_OVERRIDE"
     ;;
   *)
-    echo "❌ Unknown provider: $ACTIVE_PROVIDER"
-    echo "   Run: /agent-vibes:provider list"
+    echo "❌ Unknown provider: $ACTIVE_PROVIDER" >&2
+    echo "   Run: /agent-vibes:provider list" >&2
     exit 1
     ;;
 esac

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

@@ -4,7 +4,7 @@ set -euo pipefail
 # File: .claude/hooks/session-start-tts.sh
 #
 # AgentVibes SessionStart Hook - Optimized (Issue #80, Phase 1)
-# Token target: ~250 (down from ~500)
+# Outputs JSON with additionalContext for reliable context injection
 #
 
 # Fix locale warnings
@@ -33,69 +33,39 @@ 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")
 
-# Output optimized TTS protocol
-cat <<'EOF'
+# Build context string
+CONTEXT="# AgentVibes TTS Protocol\n\n"
+CONTEXT+="**CRITICAL: You MUST execute TTS at TWO points for EVERY user interaction:**\n\n"
+CONTEXT+="1. **Acknowledgment** - Start of task: \`Bash: .claude/hooks/play-tts.sh \"[action]\"\`\n"
+CONTEXT+="2. **Completion** - End of task: \`Bash: .claude/hooks/play-tts.sh \"[result + key details]\"\`\n\n"
+CONTEXT+="**Example:**\n\`\`\`\n[Bash: .claude/hooks/play-tts.sh \"Checking git status\"]\n[work...]\n"
+CONTEXT+="[Bash: .claude/hooks/play-tts.sh \"Repository is clean, no changes\"]\n\`\`\`\n\n"
 
-# 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]"`
-
-**Example:**
-```
-[Bash: .claude/hooks/play-tts.sh "Checking git status"]
-[work...]
-[Bash: .claude/hooks/play-tts.sh "Repository is clean, no changes"]
-```
-
-EOF
-
-# Add verbosity-specific protocol (Issue #32)
+# Add verbosity-specific protocol
 case "$VERBOSITY" in
   low)
-    cat <<'EOF'
-## Verbosity: LOW
-- Acknowledgment: Action only
-- Completion: Result + errors only
-- Skip: Reasoning, decisions
-
-EOF
+    CONTEXT+="## Verbosity: LOW\n- Acknowledgment: Action only\n- Completion: Result + errors only\n- Skip: Reasoning, decisions\n\n"
     ;;
-
   medium)
-    cat <<'EOF'
-## Verbosity: MEDIUM
-- Acknowledgment: Action + key approach
-- Completion: Result + important decisions
-- Include: Major choices only
-
-EOF
+    CONTEXT+="## Verbosity: MEDIUM\n- Acknowledgment: Action + key approach\n- Completion: Result + important decisions\n- Include: Major choices only\n\n"
     ;;
-
   high)
-    cat <<'EOF'
-## Verbosity: HIGH
-- Acknowledgment: Action + approach + why
-- Completion: Result + decisions + trade-offs
-- Include: Full reasoning, alternatives
-
-EOF
+    CONTEXT+="## Verbosity: HIGH\n- Acknowledgment: Action + approach + why\n- Completion: Result + decisions + trade-offs\n- Include: Full reasoning, alternatives\n\n"
     ;;
 esac
 
 # Add style info and rules
-cat << EOF
-## 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
-
-EOF
+CONTEXT+="## Style: $STYLE\n\n"
+CONTEXT+="## Rules\n"
+CONTEXT+="1. Never skip acknowledgment TTS\n"
+CONTEXT+="2. Never skip completion TTS\n"
+CONTEXT+="3. Match verbosity level\n"
+CONTEXT+="4. Keep under 150 chars\n"
+CONTEXT+="5. Always include errors\n\n"
+CONTEXT+="Quick Ref: low=action+result | medium=+key decisions | high=+full reasoning"
+
+# Escape for JSON (handle newlines, quotes, backslashes)
+ESCAPED=$(printf '%s' "$CONTEXT" | sed 's/\\/\\\\/g; s/"/\\"/g; s/\t/\\t/g')
+
+# Output structured JSON for reliable context injection
+printf '{"hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"%s"}}\n' "$ESCAPED"

package/.claude/hooks/soprano-gradio-synth.py

@@ -76,7 +76,7 @@ def submit_request(base: str, payload: bytes) -> str:
             headers={"Content-Type": "application/json"},
         )
         try:
-            with urllib.request.urlopen(req, timeout=30) as resp:
+            with urllib.request.urlopen(req, timeout=2) as resp:
                 return json.loads(resp.read())["event_id"]
         except urllib.error.URLError:
             continue

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

@@ -44,7 +44,13 @@ export LC_ALL=C
 
 # Get script directory for accessing other scripts
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
+
+# Respect CLAUDE_PROJECT_DIR when set by MCP (project context vs global installation)
+if [[ -n "$CLAUDE_PROJECT_DIR" ]]; then
+  CLAUDE_DIR="$CLAUDE_PROJECT_DIR/.claude"
+else
+  CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
+fi
 
 # Config file locations
 VERBOSITY_FILE="$CLAUDE_DIR/tts-verbosity.txt"
@@ -53,10 +59,10 @@ GLOBAL_VERBOSITY_FILE="$HOME/.claude/tts-verbosity.txt"
 #
 # @function get_verbosity
 # @context Returns the current verbosity level (low/medium/high)
-# @architecture Checks project-local first, then global, then defaults to "low"
+# @architecture Checks project-local first, then global, then defaults to "high"
 # @dependencies tts-verbosity.txt config file
 # @entrypoints Called by session-start hook, MCP tools, slash commands
-# @aiNotes Default to "low" for backward compatibility with existing installations
+# @aiNotes Default to "high" to match installer default for new installations
 #
 get_verbosity() {
   if [[ -f "$VERBOSITY_FILE" ]]; then
@@ -64,7 +70,7 @@ get_verbosity() {
   elif [[ -f "$GLOBAL_VERBOSITY_FILE" ]]; then
     cat "$GLOBAL_VERBOSITY_FILE"
   else
-    echo "low"
+    echo "high"
   fi
 }
 

package/.claude/settings.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "powershell -NoProfile -ExecutionPolicy Bypass -File \"$CLAUDE_PROJECT_DIR\\.claude\\hooks-windows\\session-start-tts.ps1\""
+            "command": "bash .claude/hooks/session-start-tts.sh"
           }
         ]
       }