agentvibes 5.12.0 → 5.13.0

package/.claude/commands/agent-vibes/commands.json

@@ -49,22 +49,6 @@
       "name": "get",
       "description": "Get personality details"
     },
-    {
-      "name": "language",
-      "description": "Set main/native language"
-    },
-    {
-      "name": "learn",
-      "description": "Enable/disable language learning mode"
-    },
-    {
-      "name": "target",
-      "description": "Set target language to learn"
-    },
-    {
-      "name": "target-voice",
-      "description": "Set voice for target language"
-    },
     {
       "name": "set-speed",
       "description": "Set speech speed for Piper TTS voices"
@@ -93,10 +77,6 @@
       "name": "unmute",
       "description": "Unmute AgentVibes TTS output"
     },
-    {
-      "name": "replay-target",
-      "description": "Replay the last target language audio"
-    },
     {
       "name": "translate",
       "description": "Configure automatic TTS translation"

package/.claude/commands/agent-vibes/unmute.md

@@ -37,9 +37,13 @@ fi
 
 **Advanced Options:**
 
-To unmute globally (removes global mute AND project mute):
+To unmute globally — this deliberately opts EVERY session into the TTS protocol
+(removes global mute AND drops a global opt-in marker the session-start hook
+checks). Use with care: with a global install this makes all open sessions speak.
 ```bash
 rm -f "$HOME/.agentvibes-muted"
 rm -f "$(pwd)/.claude/agentvibes-muted" 2>/dev/null || true
-echo "🔊 **AgentVibes TTS unmuted globally.** Voice output restored for all projects."
+mkdir -p "$HOME/.claude"
+touch "$HOME/.claude/agentvibes-unmuted"   # global opt-in for the injection gate
+echo "🔊 **AgentVibes TTS unmuted globally.** Every session will now announce. Run /agent-vibes:mute to stop."
 ```

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

@@ -1,7 +1,7 @@
+default||agent_vibes_arabic_v2_loop.mp3|0.30
 
-llm:default|light||0.15|en_US-lessac-high||piper
-llm:claude-code|light|agent_vibes_chillwave_v2_loop.mp3|0.05|en_US-amy-medium|Agent Vibes local here|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
-default||agent_vibes_arabic_v2_loop.mp3|0.30
+llm:default|light||0.20|en_US-lessac-high||piper
+llm:claude-code|light|agent_vibes_chillwave_v2_loop.mp3|0.20|en_US-lessac-high||piper
+llm:copilot|light|agent_vibes_bossa_nova_v2_loop.mp3|0.20|en_US-libritts-high::Anna-11||piper
+llm:codex|light|agent_vibes_chillwave_v2_loop.mp3|0.20|en_US-lessac-high||piper
+llm:hermes|light|agent_vibes_bachata_v1_loop.mp3|0.20|en_US-libritts-high::Leo-8||piper

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

@@ -1 +1 @@
-20260703
+20260716

package/.claude/hooks/agentvibes-session-id.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+#
+# File: .claude/hooks/agentvibes-session-id.sh
+#
+# AgentVibes - Text-to-Speech WITH personality for AI Assistants
+# Website: https://agentvibes.org
+# Repository: https://github.com/paulpreibisch/AgentVibes
+#
+# Licensed under the Apache License, Version 2.0
+#
+# @fileoverview Print a short spoken self-identifier for THIS session, e.g.
+#   "Claude on AgentVibes in Ghostty"
+# @why With several agent sessions open at once, every one saying the same thing
+#   makes it impossible to tell which tab just spoke. Prefixing each session's
+#   speech with who+where answers "which one is that?" (community request).
+# @usage agentvibes-session-id.sh <llm-key> <project-dir>
+#   Also used via the {{session}} token in a per-LLM PRETEXT (see play-tts.sh).
+#
+set -uo pipefail
+export LC_ALL=C
+
+LLM_KEY="${1:-claude-code}"
+PROJ_DIR="${2:-$PWD}"
+
+# LLM display name
+case "$LLM_KEY" in
+  claude-code|claude*) LLM_NAME="Claude" ;;
+  gemini*)             LLM_NAME="Gemini" ;;
+  codex|openai*|gpt*)  LLM_NAME="Codex" ;;
+  cursor*)             LLM_NAME="Cursor" ;;
+  default)             LLM_NAME="Agent" ;;
+  *)                   LLM_NAME="$LLM_KEY" ;;
+esac
+
+# Project name = basename of the project dir
+PROJ_NAME="$(basename "$PROJ_DIR" 2>/dev/null || true)"
+[[ -z "$PROJ_NAME" || "$PROJ_NAME" == "/" || "$PROJ_NAME" == "." ]] && PROJ_NAME="this project"
+
+# Terminal detection — prefer the most specific signal available.
+TERM_NAME=""
+if [[ -n "${WT_SESSION:-}" ]]; then
+  TERM_NAME="Windows Terminal"
+elif [[ -n "${TERM_PROGRAM:-}" ]]; then
+  case "$TERM_PROGRAM" in
+    vscode)         TERM_NAME="VS Code" ;;
+    iTerm.app)      TERM_NAME="iTerm" ;;
+    Apple_Terminal) TERM_NAME="Terminal" ;;
+    ghostty|Ghostty) TERM_NAME="Ghostty" ;;
+    WezTerm)        TERM_NAME="WezTerm" ;;
+    Hyper)          TERM_NAME="Hyper" ;;
+    tmux)           TERM_NAME="tmux" ;;
+    Tabby)          TERM_NAME="Tabby" ;;
+    *)              TERM_NAME="$TERM_PROGRAM" ;;
+  esac
+elif [[ -n "${TERMINAL_EMULATOR:-}" ]]; then
+  TERM_NAME="$TERMINAL_EMULATOR"
+elif [[ -n "${KITTY_WINDOW_ID:-}" ]]; then
+  TERM_NAME="kitty"
+elif [[ -n "${ALACRITTY_WINDOW_ID:-}" ]]; then
+  TERM_NAME="Alacritty"
+elif [[ -n "${TMUX:-}" ]]; then
+  TERM_NAME="tmux"
+fi
+
+if [[ -n "$TERM_NAME" ]]; then
+  printf '%s on %s in %s' "$LLM_NAME" "$PROJ_NAME" "$TERM_NAME"
+else
+  printf '%s on %s' "$LLM_NAME" "$PROJ_NAME"
+fi

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

@@ -18,6 +18,11 @@
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/python-resolver.sh"
+# Party speech is best-effort and this hook runs under `set -e`; with no Python
+# the `"$PYTHON_BIN" …` calls below would be `: command not found` (127) and abort
+# the hook, surfacing an error on every Agent call. Degrade silently instead.
+[[ -n "$PYTHON_BIN" ]] || exit 0
 LOCK_FILE="/tmp/agentvibes-party-queue.lock"
 DEBUG_LOG="/tmp/agentvibes-party-debug.log"
 
@@ -33,7 +38,7 @@ _dbg "fired (stdin ${#raw} bytes)"
 
 # --- 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'
+parsed="$(printf '%s' "$raw" | "$PYTHON_BIN" - <<'PYEOF'
 import sys, json, re
 
 try:
@@ -92,6 +97,12 @@ if [[ "$raw" != *"BMAD agent in a collaborative roundtable"* ]]; then
 fi
 _dbg "fingerprint HIT: display='$display_name' text_len=${#response_text}"
 
+# Party marker (Phase 2): this hook alone knows -- from the roundtable
+# fingerprint -- that we are in party mode. Export the marker so the child
+# bmad-speak.sh can stage the cast on the first party line (stage-on-first-speak)
+# without having to re-derive party context. Additive + harmless outside party.
+export AGENTVIBES_PARTY_MODE=1
+
 if [[ -z "$display_name" ]]; then
     _dbg "skip: empty display_name"
     exit 0
@@ -104,6 +115,11 @@ fi
 # --- Resolve project root ---
 project_root="${CLAUDE_PROJECT_DIR:-}"
 
+# Thread the real project dir to the child speak path so its forwarded messages
+# carry the correct routing session id (not the install/HOME basename). Export
+# only when known so the no-project case is unchanged.
+[[ -n "$project_root" ]] && export CLAUDE_PROJECT_DIR="$project_root"
+
 # --- 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
@@ -117,7 +133,7 @@ fi
 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'
+    matched="$("$PYTHON_BIN" - "$manifest" "$display_name" <<'PYEOF'
 import sys, csv
 manifest_path, target = sys.argv[1], sys.argv[2].lower()
 try:
@@ -147,7 +163,7 @@ fi
 case "$verbosity" in
     low)
         # First sentence — fall back to full text if no punctuation (fixes m1)
-        first="$(printf '%s' "$response_text" | python3 -c "
+        first="$(printf '%s' "$response_text" | "$PYTHON_BIN" -c "
 import sys, re
 t = sys.stdin.read()
 m = re.match(r'^.*?[.!?]', t)
@@ -157,7 +173,7 @@ print(m.group(0) if m else t)
         ;;
     medium)
         # First 2 sentences — fall back to full text if no punctuation (fixes m1)
-        two="$(printf '%s' "$response_text" | python3 -c "
+        two="$(printf '%s' "$response_text" | "$PYTHON_BIN" -c "
 import sys, re
 t = sys.stdin.read()
 parts = re.findall(r'.*?[.!?]', t)

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

@@ -49,6 +49,56 @@ if [[ ! -f "$PROJECT_ROOT/_bmad/_config/agent-manifest.csv" ]]; then
   exit 0
 fi
 
+# ---------------------------------------------------------------------------
+# Stage-on-first-speak: the FIRST party line for a session notifies a compatible
+# receiver of the full party roster up front, rather than letting it learn the
+# cast one line at a time. Everything here is additive + fail-safe: if python is
+# missing or the notification errors, the line still speaks.
+#
+# Party context is detected via either signal:
+#   * AGENTVIBES_PARTY_MODE=1 -- the "party marker" bmad-party-speak.sh exports
+#     before it invokes this script (it alone knows the roundtable fingerprint).
+#   * the routing session id ends in "-bmad-party-mode" (the suffix the party
+#     stages under), for any flow that runs under that session directly.
+#
+# Idempotency: a per-session flag ~/.agentvibes/staged-<sessionid>.flag makes the
+# doorbell fire ONCE per party, not once per line.
+#
+# Clearing the flag: there is no per-line clear (that would re-fire every line).
+# `party-set-room.sh --clear` removes it (manual reset / room change), and a
+# party-end / clear hook should remove it too. TODO: wire an automatic clear to
+# a party-teardown hook if/when BMAD exposes one -- until then the flag persists
+# for the life of the session, which is the correct once-per-party behavior.
+if [[ "${AGENTVIBES_STAGE_ROSTER_DISABLED:-}" != "1" ]]; then
+  _sr_session=""
+  if [[ -f "$SCRIPT_DIR/session-id.sh" ]]; then
+    # shellcheck source=./session-id.sh
+    source "$SCRIPT_DIR/session-id.sh"
+    _sr_session="$(av_session_id "${CLAUDE_PROJECT_DIR:-$PROJECT_ROOT}")"
+  fi
+  if [[ "${AGENTVIBES_PARTY_MODE:-}" == "1" || "$_sr_session" == *-bmad-party-mode ]]; then
+    _sr_flag="$HOME/.agentvibes/staged-${_sr_session:-unknown}.flag"
+    if [[ -n "$_sr_session" && ! -f "$_sr_flag" ]]; then
+      # Claim the flag FIRST (atomic-ish) so parallel party lines don't each fire.
+      mkdir -p "$HOME/.agentvibes" 2>/dev/null || true
+      if ( set -o noclobber; : > "$_sr_flag" ) 2>/dev/null; then
+        _sr_python=""
+        if [[ -f "$SCRIPT_DIR/python-resolver.sh" ]]; then
+          # shellcheck source=./python-resolver.sh
+          source "$SCRIPT_DIR/python-resolver.sh"
+          _sr_python="${PYTHON_BIN:-}"
+        fi
+        if [[ -n "$_sr_python" && -f "$SCRIPT_DIR/party-stage-roster.py" ]]; then
+          # Fire-and-forget in the background; NEVER block or fail the line.
+          ( "$_sr_python" "$SCRIPT_DIR/party-stage-roster.py" \
+              --project-root "${CLAUDE_PROJECT_DIR:-$PROJECT_ROOT}" \
+              --session-suffix bmad-party-mode >/dev/null 2>&1 || true ) &
+        fi
+      fi
+    fi
+  fi
+fi
+
 # ---------------------------------------------------------------------------
 # Per-agent profile reader — reads from project .agentvibes/bmad-voice-map.json (falls back to global)
 # Uses node for reliable JSON parsing (jq may not be installed)
@@ -289,10 +339,18 @@ trap 'rmdir "$SPEECH_LOCK" 2>/dev/null' EXIT
 # has an empty TEMP_PROFILE, so the arg-3 heuristic in play-tts.sh alone would
 # miss it. AGENT_VOICE is an agent-profile voice, always.
 export AGENTVIBES_VOICE_SOURCE="agent-profile"
+# Thread the real project dir through to play-tts.sh so any downstream forward
+# (SSH-remote / avatar) derives the correct routing session id from the user's
+# project — NOT the install/HOME basename. Only add the flag when the var is
+# non-empty so the no-project case is unchanged. Mirrors session-start-tts.sh.
+_PT_PROJECT_FLAG=()
+if [[ -n "${CLAUDE_PROJECT_DIR:-}" ]]; then
+  _PT_PROJECT_FLAG=(--project-dir "$CLAUDE_PROJECT_DIR")
+fi
 if [[ -n "$AGENT_VOICE" ]]; then
-  bash "$SCRIPT_DIR/play-tts.sh" "$FULL_TEXT" "$AGENT_VOICE" "$TEMP_PROFILE"
+  bash "$SCRIPT_DIR/play-tts.sh" "$FULL_TEXT" "$AGENT_VOICE" "$TEMP_PROFILE" "${_PT_PROJECT_FLAG[@]+"${_PT_PROJECT_FLAG[@]}"}"
 else
-  bash "$SCRIPT_DIR/play-tts.sh" "$FULL_TEXT" "" "$TEMP_PROFILE"
+  bash "$SCRIPT_DIR/play-tts.sh" "$FULL_TEXT" "" "$TEMP_PROFILE" "${_PT_PROJECT_FLAG[@]+"${_PT_PROJECT_FLAG[@]}"}"
 fi
 
 # Release lock

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

@@ -40,6 +40,25 @@ set -e  # Exit on error
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 CLAUDE_DIR="$(dirname "$SCRIPT_DIR")"
 
+# @function _piper_default_voice
+# @intent Return the Provider Catalog's piper default voice (AVI-S9.6 AC2,
+#         design row 22), falling back to the legacy hardcoded literal when the
+#         generated .claude/hooks/provider-catalog.sh artifact is missing
+#         (installed-tree skew — mirrors the fail-safe probe pattern already
+#         used by voice-manager.sh / provider-manager.sh).
+# @returns Echoes the default Piper voice id.
+_piper_default_voice() {
+  if [[ -f "$SCRIPT_DIR/provider-catalog.sh" ]]; then
+    # shellcheck source=/dev/null
+    source "$SCRIPT_DIR/provider-catalog.sh" 2>/dev/null || true
+  fi
+  if type catalog_default_voice >/dev/null 2>&1; then
+    catalog_default_voice piper
+  else
+    echo "en_US-lessac-medium"  # legacy fallback if the catalog artifact is missing
+  fi
+}
+
 # Colors for output
 GREEN='\033[0;32m'
 YELLOW='\033[1;33m'
@@ -193,7 +212,7 @@ map_voice_to_provider() {
   # Map legacy voice names to Piper equivalents
   case "$voice" in
     "Jessica Anne Bogart"|"Aria")
-      echo "en_US-lessac-medium"
+      _piper_default_voice
       ;;
     "Matthew Schmitz"|"Archer"|"Michael")
       echo "en_US-danny-low"

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

@@ -43,6 +43,27 @@ CONFIG_DIR=".agentvibes/bmad"
 VOICE_CONFIG_FILE="$CONFIG_DIR/bmad-voices.md"
 ENABLED_FLAG="$CONFIG_DIR/bmad-voices-enabled.flag"
 
+# @function _piper_default_voice
+# @intent Return the Provider Catalog's piper default voice (AVI-S9.6 AC2,
+#         design row 22), falling back to the legacy hardcoded literal when the
+#         generated .claude/hooks/provider-catalog.sh artifact is missing
+#         (installed-tree skew — mirrors the fail-safe probe pattern already
+#         used by voice-manager.sh / provider-manager.sh).
+# @returns Echoes the default Piper voice id.
+_piper_default_voice() {
+  local _script_dir
+  _script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  if [[ -f "$_script_dir/provider-catalog.sh" ]]; then
+    # shellcheck source=/dev/null
+    source "$_script_dir/provider-catalog.sh" 2>/dev/null || true
+  fi
+  if type catalog_default_voice >/dev/null 2>&1; then
+    catalog_default_voice piper
+  else
+    echo "en_US-lessac-medium"  # legacy fallback if the catalog artifact is missing
+  fi
+}
+
 # AI NOTE: Auto-enable pattern - When BMAD is detected via install-manifest.yaml,
 # automatically enable the voice plugin to provide seamless multi-agent voice support.
 # This avoids requiring manual plugin activation after BMAD installation.
@@ -160,8 +181,9 @@ get_agent_voice() {
         # CSV format: agent_id,voice_name
         local voice=$(grep "^$agent_id," "$bmad_voice_map" | cut -d',' -f2)
 
-        # If voice is empty or generic (same for all), use defaults
-        if [[ -n "$voice" ]] && [[ "$voice" != "en_US-lessac-medium" ]]; then
+        # If voice is empty or generic (same for all), use defaults. "Generic"
+        # means the CSV still carries the catalog's piper default (AVI-S9.6 AC2).
+        if [[ -n "$voice" ]] && [[ "$voice" != "$(_piper_default_voice)" ]]; then
             echo "$voice"
             return
         fi
@@ -172,7 +194,7 @@ get_agent_voice() {
     # These match the BMAD-METHOD defaults for consistency
     case "$agent_id" in
         bmad-master)
-            echo "en_US-lessac-medium"
+            _piper_default_voice
             return
             ;;
         analyst)

package/.claude/hooks/clawdbot-receiver-SECURE.sh

@@ -22,11 +22,30 @@
 set -euo pipefail
 
 ENCODED_TEXT="${1:-}"
-VOICE="${2:-en_US-lessac-medium}"
+
+# Default voice: prefer the Provider Catalog's piper default (AVI-S9.6 AC3,
+# design row 23), falling back to the legacy literal if the generated catalog
+# artifact is missing (installed-tree skew).
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [[ -f "$SCRIPT_DIR/provider-catalog.sh" ]]; then
+  # shellcheck source=/dev/null
+  source "$SCRIPT_DIR/provider-catalog.sh" 2>/dev/null || true
+fi
+if type catalog_default_voice >/dev/null 2>&1; then
+  _CATALOG_PIPER_DEFAULT="$(catalog_default_voice piper)"
+else
+  _CATALOG_PIPER_DEFAULT="en_US-lessac-medium"  # legacy fallback
+fi
+VOICE="${2:-$_CATALOG_PIPER_DEFAULT}"
 ENCODED_AGENT="${3:-}"
 ENCODED_INTRO="${4:-}"
 
-# SECURITY: Whitelist of allowed voice names
+# SECURITY: Whitelist of allowed voice names.
+# DO NOT UNIFY with the Provider Catalog — this is a SECURITY control, not an
+# inventory list. It is deliberately narrower than (and independent of) the
+# catalog's piper voice set; syncing it to the catalog would silently widen
+# what an untrusted remote SSH sender can request (design §8, provider-catalog.js
+# module header).
 ALLOWED_VOICES="en_US-amy-medium|en_US-lessac-medium|es_ES-mls_9972-low|es_ES-davefx-medium|en_US-joe-medium"
 
 # Validate inputs

package/.claude/hooks/clawdbot-receiver.sh

@@ -24,7 +24,25 @@
 set -euo pipefail
 
 ENCODED_TEXT="${1:-}"
-VOICE="${2:-en_US-lessac-medium}"
+
+# Default voice: prefer the Provider Catalog's piper default (AVI-S9.6 AC3,
+# design row 23), falling back to the legacy literal if the generated catalog
+# artifact is missing (installed-tree skew). NOTE: this receiver has no voice
+# allowlist of its own — see clawdbot-receiver-SECURE.sh for the hardened
+# variant, whose ALLOWED_VOICES security allowlist is intentionally NOT
+# migrated to (or synced with) the catalog (a security allowlist must stay
+# independently narrow — see provider-catalog.js module header).
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+if [[ -f "$SCRIPT_DIR/provider-catalog.sh" ]]; then
+  # shellcheck source=/dev/null
+  source "$SCRIPT_DIR/provider-catalog.sh" 2>/dev/null || true
+fi
+if type catalog_default_voice >/dev/null 2>&1; then
+  _CATALOG_PIPER_DEFAULT="$(catalog_default_voice piper)"
+else
+  _CATALOG_PIPER_DEFAULT="en_US-lessac-medium"  # legacy fallback
+fi
+VOICE="${2:-$_CATALOG_PIPER_DEFAULT}"
 ENCODED_AGENT="${3:-}"
 ENCODED_INTRO="${4:-}"
 

package/.claude/hooks/elevenlabs-voices.sh

@@ -0,0 +1,62 @@
+#!/usr/bin/env bash
+#
+# elevenlabs-voices.sh — GENERATED FILE. DO NOT EDIT.
+# DO NOT EDIT — generated from src/services/provider-catalog.js
+# Regenerate with: node scripts/generate-provider-catalog.mjs
+# content-hash: sha256:5e717024f1250a8f54d07291256e532606dba7b4a15ab9589305d1af6bba7f35
+#
+# SINGLE SOURCE OF TRUTH for the ElevenLabs voice catalog on the shell side.
+# Source it, do not execute it. Consumed by play-tts-elevenlabs.sh and
+# voice-manager.sh. These are the ElevenLabs DEFAULT-LIBRARY voices — available to
+# every API key (community/library voices that must be added to an account first are
+# intentionally excluded so a switch can't fail at synth time).
+
+# Guard against double-sourcing.
+[ -n "${_AGENTVIBES_ELEVENLABS_VOICES_LOADED:-}" ] && return 0
+_AGENTVIBES_ELEVENLABS_VOICES_LOADED=1
+
+# Default voice used when none is configured.
+ELEVENLABS_DEFAULT_VOICE="Sarah"
+
+# Print the catalog voice names, one per line (bash-3.2-safe replacement for the
+# old associative-array key expansion "${!ELEVENLABS_VOICE_IDS[@]}").
+elevenlabs_voice_names() {
+  printf '%s\n' 'Sarah' 'Roger' 'Laura' 'Charlie' 'George' 'Callum' 'River' 'Harry' 'Liam' 'Alice' 'Matilda' 'Will' 'Jessica' 'Eric' 'Bella' 'Chris' 'Brian' 'Daniel' 'Lily' 'Adam' 'Bill'
+}
+
+# Resolve a user-supplied name (case-insensitive) OR a raw voice_id to a canonical
+# voice_id. Echoes the id and returns 0 on success; returns 1 if the input matches
+# no catalog name and is not a raw-id shape. bash-3.2-safe: case statement + tr fold
+# (no associative arrays, no case-modifying expansions).
+elevenlabs_resolve_voice() {
+  local query lc
+  query="${1:-}"
+  [ -z "$query" ] && return 1
+  lc="$(printf '%s' "$query" | tr '[:upper:]' '[:lower:]')"
+  case "$lc" in
+    'sarah') printf '%s' 'EXAVITQu4vr4xnSDxMaL'; return 0 ;;
+    'roger') printf '%s' 'CwhRBWXzGAHq8TQ4Fs17'; return 0 ;;
+    'laura') printf '%s' 'FGY2WhTYpPnrIDTdsKH5'; return 0 ;;
+    'charlie') printf '%s' 'IKne3meq5aSn9XLyUdCD'; return 0 ;;
+    'george') printf '%s' 'JBFqnCBsd6RMkjVDRZzb'; return 0 ;;
+    'callum') printf '%s' 'N2lVS1w4EtoT3dr4eOWO'; return 0 ;;
+    'river') printf '%s' 'SAz9YHcvj6GT2YYXdXww'; return 0 ;;
+    'harry') printf '%s' 'SOYHLrjzK2X1ezoPC6cr'; return 0 ;;
+    'liam') printf '%s' 'TX3LPaxmHKxFdv7VOQHJ'; return 0 ;;
+    'alice') printf '%s' 'Xb7hH8MSUJpSbSDYk0k2'; return 0 ;;
+    'matilda') printf '%s' 'XrExE9yKIg1WjnnlVkGX'; return 0 ;;
+    'will') printf '%s' 'bIHbv24MWmeRgasZH58o'; return 0 ;;
+    'jessica') printf '%s' 'cgSgspJ2msm6clMCkdW9'; return 0 ;;
+    'eric') printf '%s' 'cjVigY5qzO86Huf0OWal'; return 0 ;;
+    'bella') printf '%s' 'hpp4J3VqNfWAUOO0d1Us'; return 0 ;;
+    'chris') printf '%s' 'iP95p4xoKVk53GoZ742B'; return 0 ;;
+    'brian') printf '%s' 'nPczCjzI2devNBz1zQrb'; return 0 ;;
+    'daniel') printf '%s' 'onwK4e9ZLuTAKqWW03F9'; return 0 ;;
+    'lily') printf '%s' 'pFZP5JQG7iQjIQuC4Bku'; return 0 ;;
+    'adam') printf '%s' 'pNInz6obpgDQGcFmaJgB'; return 0 ;;
+    'bill') printf '%s' 'pqHfZKP75CvOlQylNhV4'; return 0 ;;
+  esac
+  # Already a raw ElevenLabs voice_id.
+  [[ "$query" =~ ^[A-Za-z0-9]{20}$ ]] && { printf '%s' "$query"; return 0; }
+  return 1
+}

package/.claude/hooks/kokoro-installer.sh

@@ -17,6 +17,10 @@
 set -euo pipefail
 export LC_ALL=C
 
+# Resolve a working Python interpreter (Windows git-bash often has none on PATH).
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/python-resolver.sh"
+
 NON_INTERACTIVE=false
 CHECK_ONLY=false
 
@@ -32,9 +36,10 @@ REQUIRED_PACKAGES=("kokoro" "soundfile" "numpy")
 # ---------------------------------------------------------------------------
 # Check current installation state (use find_spec to avoid slow torch import)
 check_kokoro() {
-  python3 -c "import importlib.util; exit(0 if importlib.util.find_spec('kokoro') else 1)" 2>/dev/null && \
-  python3 -c "import importlib.util; exit(0 if importlib.util.find_spec('soundfile') else 1)" 2>/dev/null && \
-  python3 -c "import importlib.util; exit(0 if importlib.util.find_spec('numpy') else 1)" 2>/dev/null
+  [[ -n "$PYTHON_BIN" ]] || return 1
+  "$PYTHON_BIN" -c "import importlib.util; exit(0 if importlib.util.find_spec('kokoro') else 1)" 2>/dev/null && \
+  "$PYTHON_BIN" -c "import importlib.util; exit(0 if importlib.util.find_spec('soundfile') else 1)" 2>/dev/null && \
+  "$PYTHON_BIN" -c "import importlib.util; exit(0 if importlib.util.find_spec('numpy') else 1)" 2>/dev/null
 }
 
 if check_kokoro; then
@@ -70,10 +75,13 @@ if [[ "$NON_INTERACTIVE" != true ]]; then
   fi
 fi
 
-# Check Python is available
-if ! command -v python3 &>/dev/null; then
-  echo "❌ Python 3 is required but not found in PATH" >&2
-  echo "   Install with: sudo apt install python3 python3-pip" >&2
+# Check Python is available (resolver handles Windows/no-PATH cases)
+if [[ -z "$PYTHON_BIN" ]]; then
+  echo "❌ Python 3 is required but no interpreter was found" >&2
+  echo "   Linux:   sudo apt install python3 python3-pip" >&2
+  echo "   macOS:   brew install python3" >&2
+  echo "   Windows: install from https://python.org (tick 'Add to PATH')" >&2
+  echo "   Or set AGENTVIBES_PYTHON=/path/to/python if installed elsewhere." >&2
   exit 1
 fi
 
@@ -84,12 +92,14 @@ echo ""
 # Try pip install with PEP 668 fallback to pipx/user install
 _install_pkgs() {
   local pkgs=("$@")
+  # Prefer the resolved interpreter's own pip so packages land where the check
+  # (and the synth) will actually import them from.
+  if "$PYTHON_BIN" -m pip install "${pkgs[@]}" 2>/dev/null; then return 0; fi
+  if "$PYTHON_BIN" -m pip install --user "${pkgs[@]}" 2>/dev/null; then return 0; fi
   if pip install "${pkgs[@]}" 2>/dev/null; then return 0; fi
   if pip install --user "${pkgs[@]}" 2>/dev/null; then return 0; fi
   if pip3 install "${pkgs[@]}" 2>/dev/null; then return 0; fi
   if pip3 install --user "${pkgs[@]}" 2>/dev/null; then return 0; fi
-  if python3 -m pip install "${pkgs[@]}" 2>/dev/null; then return 0; fi
-  if python3 -m pip install --user "${pkgs[@]}" 2>/dev/null; then return 0; fi
   return 1
 }
 
@@ -107,7 +117,7 @@ if _install_pkgs "${REQUIRED_PACKAGES[@]}"; then
     echo "Switch to Kokoro:  /agent-vibes:provider switch kokoro"
   else
     echo "⚠️  Packages installed but import check failed." >&2
-    echo "   Try: python3 -c 'import kokoro'" >&2
+    echo "   Try: \"$PYTHON_BIN\" -c 'import kokoro'" >&2
     exit 1
   fi
 else

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

@@ -32,7 +32,7 @@
 # @dependencies provider-manager.sh for active provider detection, .claude/tts-language.txt for state
 # @entrypoints Called by /agent-vibes:language commands, play-tts-*.sh for voice resolution
 # @patterns Provider abstraction, language-to-voice mapping, backward compatibility with legacy LANGUAGE_VOICES
-# @related play-tts-piper.sh, provider-manager.sh, learn-manager.sh
+# @related play-tts-piper.sh, provider-manager.sh
 
 # Determine target .claude directory based on context
 # Priority:
@@ -215,11 +215,18 @@ get_language_code() {
 }
 
 # Function to check if current voice supports language
+# AVI-S9.6 AC1: this list previously included "Antoni", "Rachel", "Domi",
+# "Charlotte" — none of which exist in the 21-voice ElevenLabs catalog
+# (src/services/provider-catalog.js ELEVENLABS_VOICES), the same class of bug
+# design row 21 flagged in the now-deleted learn-manager.sh. Trimmed to names
+# that ARE in the catalog; test/unit/provider-catalog-conformance.test.js
+# parity-asserts every entry here against the catalog so a future addition of
+# a non-existent name fails the suite instead of shipping silently.
 is_voice_multilingual() {
     local voice="$1"
 
-    # List of multilingual voices
-    local multilingual_voices=("Antoni" "Rachel" "Domi" "Bella" "Charlotte" "Matilda")
+    # List of multilingual voices (must all exist in the ElevenLabs catalog)
+    local multilingual_voices=("Bella" "Matilda")
 
     for mv in "${multilingual_voices[@]}"; do
         if [[ "$voice" == "$mv" ]]; then