agentvibes 5.12.0-alpha.0 → 5.13.0

package/.claude/hooks/provider-catalog.json

@@ -0,0 +1,352 @@
+{
+  "_generated": "DO NOT EDIT — generated from src/services/provider-catalog.js",
+  "_contentHash": "sha256:5e717024f1250a8f54d07291256e532606dba7b4a15ab9589305d1af6bba7f35",
+  "version": "5e717024f1250a8f",
+  "providers": [
+    {
+      "id": "soprano",
+      "engineId": "soprano",
+      "aliases": [],
+      "displayName": "Soprano TTS",
+      "voiceModel": "single",
+      "defaultVoice": "soprano-default",
+      "requires": "pip",
+      "runtime": {
+        "unix": "play-tts-soprano.sh",
+        "windows": "play-tts-soprano.ps1",
+        "darwinOnly": false
+      },
+      "voices": [
+        "soprano-default"
+      ]
+    },
+    {
+      "id": "piper",
+      "engineId": "piper",
+      "aliases": [],
+      "displayName": "Piper TTS",
+      "voiceModel": "discovered",
+      "defaultVoice": "en_US-lessac-medium",
+      "requires": "pip",
+      "runtime": {
+        "unix": "play-tts-piper.sh",
+        "windows": null,
+        "darwinOnly": false
+      },
+      "voices": null
+    },
+    {
+      "id": "kokoro",
+      "engineId": "kokoro",
+      "aliases": [],
+      "displayName": "Kokoro TTS",
+      "voiceModel": "static",
+      "defaultVoice": "af_heart",
+      "requires": "pip",
+      "runtime": {
+        "unix": "play-tts-kokoro.sh",
+        "windows": "play-tts-kokoro.ps1",
+        "darwinOnly": false
+      },
+      "voices": [
+        "af_heart",
+        "af_alloy",
+        "af_aoede",
+        "af_bella",
+        "af_jessica",
+        "af_kore",
+        "af_nicole",
+        "af_nova",
+        "af_river",
+        "af_sarah",
+        "af_sky",
+        "am_adam",
+        "am_echo",
+        "am_eric",
+        "am_fenrir",
+        "am_liam",
+        "am_michael",
+        "am_onyx",
+        "am_puck",
+        "bf_alice",
+        "bf_emma",
+        "bf_isabella",
+        "bf_lily",
+        "bm_daniel",
+        "bm_fable",
+        "bm_george",
+        "bm_lewis",
+        "jf_alpha",
+        "jf_gongitsune",
+        "jf_nezumi",
+        "jf_tebukuro",
+        "jm_kumo",
+        "zf_xiaobei",
+        "zf_xiaoni",
+        "zf_xiaoxiao",
+        "zf_xiaoyi",
+        "zm_yunxi",
+        "zm_yunxia",
+        "zm_yunyang",
+        "ef_dora",
+        "em_alex",
+        "em_santa",
+        "ff_siwis",
+        "hf_alpha",
+        "hm_omega",
+        "if_sara",
+        "im_nicola",
+        "pf_dora",
+        "pm_alex",
+        "pm_santa",
+        "kf_alpha",
+        "km_hyunsu"
+      ]
+    },
+    {
+      "id": "elevenlabs",
+      "engineId": "elevenlabs",
+      "aliases": [],
+      "displayName": "ElevenLabs",
+      "voiceModel": "name-to-id",
+      "defaultVoice": "Sarah",
+      "requires": "api-key",
+      "runtime": {
+        "unix": "play-tts-elevenlabs.sh",
+        "windows": null,
+        "darwinOnly": false
+      },
+      "voices": [
+        {
+          "id": "EXAVITQu4vr4xnSDxMaL",
+          "name": "Sarah",
+          "gender": "Female",
+          "lang": "en-US",
+          "desc": "Mature, reassuring"
+        },
+        {
+          "id": "CwhRBWXzGAHq8TQ4Fs17",
+          "name": "Roger",
+          "gender": "Male",
+          "lang": "en-US",
+          "desc": "Laid-back, casual"
+        },
+        {
+          "id": "FGY2WhTYpPnrIDTdsKH5",
+          "name": "Laura",
+          "gender": "Female",
+          "lang": "en-US",
+          "desc": "Enthusiast, quirky"
+        },
+        {
+          "id": "IKne3meq5aSn9XLyUdCD",
+          "name": "Charlie",
+          "gender": "Male",
+          "lang": "en-AU",
+          "desc": "Deep, confident"
+        },
+        {
+          "id": "JBFqnCBsd6RMkjVDRZzb",
+          "name": "George",
+          "gender": "Male",
+          "lang": "en-GB",
+          "desc": "Warm storyteller"
+        },
+        {
+          "id": "N2lVS1w4EtoT3dr4eOWO",
+          "name": "Callum",
+          "gender": "Male",
+          "lang": "en-US",
+          "desc": "Husky trickster"
+        },
+        {
+          "id": "SAz9YHcvj6GT2YYXdXww",
+          "name": "River",
+          "gender": "",
+          "lang": "en-US",
+          "desc": "Relaxed, neutral"
+        },
+        {
+          "id": "SOYHLrjzK2X1ezoPC6cr",
+          "name": "Harry",
+          "gender": "Male",
+          "lang": "en-US",
+          "desc": "Fierce warrior"
+        },
+        {
+          "id": "TX3LPaxmHKxFdv7VOQHJ",
+          "name": "Liam",
+          "gender": "Male",
+          "lang": "en-US",
+          "desc": "Energetic creator"
+        },
+        {
+          "id": "Xb7hH8MSUJpSbSDYk0k2",
+          "name": "Alice",
+          "gender": "Female",
+          "lang": "en-GB",
+          "desc": "Clear educator"
+        },
+        {
+          "id": "XrExE9yKIg1WjnnlVkGX",
+          "name": "Matilda",
+          "gender": "Female",
+          "lang": "en-US",
+          "desc": "Knowledgable, pro"
+        },
+        {
+          "id": "bIHbv24MWmeRgasZH58o",
+          "name": "Will",
+          "gender": "Male",
+          "lang": "en-US",
+          "desc": "Relaxed optimist"
+        },
+        {
+          "id": "cgSgspJ2msm6clMCkdW9",
+          "name": "Jessica",
+          "gender": "Female",
+          "lang": "en-US",
+          "desc": "Playful, bright"
+        },
+        {
+          "id": "cjVigY5qzO86Huf0OWal",
+          "name": "Eric",
+          "gender": "Male",
+          "lang": "en-US",
+          "desc": "Smooth, trustworthy"
+        },
+        {
+          "id": "hpp4J3VqNfWAUOO0d1Us",
+          "name": "Bella",
+          "gender": "Female",
+          "lang": "en-US",
+          "desc": "Professional, warm"
+        },
+        {
+          "id": "iP95p4xoKVk53GoZ742B",
+          "name": "Chris",
+          "gender": "Male",
+          "lang": "en-US",
+          "desc": "Charming, down-to-earth"
+        },
+        {
+          "id": "nPczCjzI2devNBz1zQrb",
+          "name": "Brian",
+          "gender": "Male",
+          "lang": "en-US",
+          "desc": "Deep, comforting"
+        },
+        {
+          "id": "onwK4e9ZLuTAKqWW03F9",
+          "name": "Daniel",
+          "gender": "Male",
+          "lang": "en-GB",
+          "desc": "Steady broadcaster"
+        },
+        {
+          "id": "pFZP5JQG7iQjIQuC4Bku",
+          "name": "Lily",
+          "gender": "Female",
+          "lang": "en-GB",
+          "desc": "Velvety actress"
+        },
+        {
+          "id": "pNInz6obpgDQGcFmaJgB",
+          "name": "Adam",
+          "gender": "Male",
+          "lang": "en-US",
+          "desc": "Dominant, firm"
+        },
+        {
+          "id": "pqHfZKP75CvOlQylNhV4",
+          "name": "Bill",
+          "gender": "Male",
+          "lang": "en-US",
+          "desc": "Wise, mature"
+        }
+      ]
+    },
+    {
+      "id": "macos",
+      "engineId": "macos",
+      "aliases": [
+        "macos-say",
+        "say"
+      ],
+      "displayName": "macOS Say",
+      "voiceModel": "discovered",
+      "defaultVoice": "Samantha",
+      "requires": "builtin",
+      "runtime": {
+        "unix": "play-tts-macos.sh",
+        "windows": null,
+        "darwinOnly": true
+      },
+      "voices": null
+    },
+    {
+      "id": "windows-sapi",
+      "engineId": "sapi",
+      "aliases": [
+        "sapi"
+      ],
+      "displayName": "Windows SAPI",
+      "voiceModel": "discovered",
+      "defaultVoice": "",
+      "requires": "builtin",
+      "runtime": {
+        "unix": null,
+        "windows": "play-tts-sapi.ps1",
+        "darwinOnly": false
+      },
+      "voices": null
+    },
+    {
+      "id": "windows-piper",
+      "engineId": "piper",
+      "aliases": [
+        "piper"
+      ],
+      "displayName": "Piper TTS",
+      "voiceModel": "discovered",
+      "defaultVoice": "en_US-lessac-medium",
+      "requires": "exe",
+      "runtime": {
+        "unix": null,
+        "windows": "play-tts-windows-piper.ps1",
+        "darwinOnly": false
+      },
+      "voices": null
+    }
+  ],
+  "platforms": {
+    "unix": [
+      "soprano",
+      "piper",
+      "kokoro",
+      "elevenlabs"
+    ],
+    "darwin": [
+      "soprano",
+      "piper",
+      "kokoro",
+      "elevenlabs",
+      "macos"
+    ],
+    "windows": [
+      "soprano",
+      "kokoro",
+      "windows-sapi",
+      "windows-piper"
+    ]
+  },
+  "displayNames": {
+    "soprano": "Soprano TTS",
+    "piper": "Piper TTS",
+    "kokoro": "Kokoro TTS",
+    "elevenlabs": "ElevenLabs",
+    "macos": "macOS Say",
+    "windows-sapi": "Windows SAPI",
+    "windows-piper": "Piper TTS"
+  }
+}

package/.claude/hooks/provider-catalog.sh

@@ -0,0 +1,161 @@
+#!/usr/bin/env bash
+#
+# provider-catalog.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
+#
+# Bash-3.2-safe catalog accessors (macOS ships bash 3.2 — no associative
+# arrays, no case-modifying parameter expansions). Source this file; do not execute it.
+
+AGENTVIBES_CATALOG_VERSION="5e717024f1250a8f"
+
+# Guard against double-sourcing.
+[ -n "${_AGENTVIBES_PROVIDER_CATALOG_LOADED:-}" ] && return 0
+_AGENTVIBES_PROVIDER_CATALOG_LOADED=1
+
+# Lowercase a string without case-modifying expansions (unavailable in bash 3.2).
+_catalog_lc() { printf '%s' "${1:-}" | tr '[:upper:]' '[:lower:]'; }
+
+# Resolve an id-or-alias to its canonical provider id (echoes it; 1 if unknown).
+catalog_canonical_provider() {
+  case "$(_catalog_lc "${1:-}")" in
+    soprano) printf '%s' 'soprano' ;;
+    piper) printf '%s' 'piper' ;;
+    kokoro) printf '%s' 'kokoro' ;;
+    elevenlabs) printf '%s' 'elevenlabs' ;;
+    macos|macos-say|say) printf '%s' 'macos' ;;
+    windows-sapi|sapi) printf '%s' 'windows-sapi' ;;
+    windows-piper) printf '%s' 'windows-piper' ;;
+    *) return 1 ;;
+  esac
+}
+
+# Echo the default voice for a provider (empty string is valid — system default).
+catalog_default_voice() {
+  local _p; _p="$(catalog_canonical_provider "${1:-}")" || return 1
+  case "$_p" in
+    soprano) printf '%s' 'soprano-default' ;;
+    piper) printf '%s' 'en_US-lessac-medium' ;;
+    kokoro) printf '%s' 'af_heart' ;;
+    elevenlabs) printf '%s' 'Sarah' ;;
+    macos) printf '%s' 'Samantha' ;;
+    windows-sapi) printf '%s' '' ;;
+    windows-piper) printf '%s' 'en_US-lessac-medium' ;;
+  esac
+}
+
+# Echo a human display name for a provider.
+catalog_display_name() {
+  local _p; _p="$(catalog_canonical_provider "${1:-}")" || { printf '%s' "${1:-}"; return 0; }
+  case "$_p" in
+    soprano) printf '%s' 'Soprano TTS' ;;
+    piper) printf '%s' 'Piper TTS' ;;
+    kokoro) printf '%s' 'Kokoro TTS' ;;
+    elevenlabs) printf '%s' 'ElevenLabs' ;;
+    macos) printf '%s' 'macOS Say' ;;
+    windows-sapi) printf '%s' 'Windows SAPI' ;;
+    windows-piper) printf '%s' 'Piper TTS' ;;
+  esac
+}
+
+# Print the provider ids playable on a platform (unix|darwin|windows), one per line.
+catalog_providers_for_platform() {
+  case "$(_catalog_lc "${1:-}")" in
+    unix)
+      printf '%s\n' 'soprano' 'piper' 'kokoro' 'elevenlabs'
+      ;;
+    darwin)
+      printf '%s\n' 'soprano' 'piper' 'kokoro' 'elevenlabs' 'macos'
+      ;;
+    windows)
+      printf '%s\n' 'soprano' 'kokoro' 'windows-sapi' 'windows-piper'
+      ;;
+    *) return 1 ;;
+  esac
+}
+
+# Print a provider's listable voices (ids for kokoro, names for elevenlabs), one per line.
+# Discovered providers (piper/macos/sapi) enumerate at runtime and print nothing here.
+catalog_list_voices() {
+  local _p; _p="$(catalog_canonical_provider "${1:-}")" || return 1
+  case "$_p" in
+    soprano)
+      printf '%s\n' 'soprano-default'
+      ;;
+    piper)
+      : # (none — enumerated at runtime)
+      ;;
+    kokoro)
+      printf '%s\n' 'af_heart' 'af_alloy' 'af_aoede' 'af_bella' 'af_jessica' 'af_kore' 'af_nicole' 'af_nova' 'af_river' 'af_sarah' 'af_sky' 'am_adam' 'am_echo' 'am_eric' 'am_fenrir' 'am_liam' 'am_michael' 'am_onyx' 'am_puck' 'bf_alice' 'bf_emma' 'bf_isabella' 'bf_lily' 'bm_daniel' 'bm_fable' 'bm_george' 'bm_lewis' 'jf_alpha' 'jf_gongitsune' 'jf_nezumi' 'jf_tebukuro' 'jm_kumo' 'zf_xiaobei' 'zf_xiaoni' 'zf_xiaoxiao' 'zf_xiaoyi' 'zm_yunxi' 'zm_yunxia' 'zm_yunyang' 'ef_dora' 'em_alex' 'em_santa' 'ff_siwis' 'hf_alpha' 'hm_omega' 'if_sara' 'im_nicola' 'pf_dora' 'pm_alex' 'pm_santa' 'kf_alpha' 'km_hyunsu'
+      ;;
+    elevenlabs)
+      printf '%s\n' 'Sarah' 'Roger' 'Laura' 'Charlie' 'George' 'Callum' 'River' 'Harry' 'Liam' 'Alice' 'Matilda' 'Will' 'Jessica' 'Eric' 'Bella' 'Chris' 'Brian' 'Daniel' 'Lily' 'Adam' 'Bill'
+      ;;
+    macos)
+      : # (none — enumerated at runtime)
+      ;;
+    windows-sapi)
+      : # (none — enumerated at runtime)
+      ;;
+    windows-piper)
+      : # (none — enumerated at runtime)
+      ;;
+  esac
+}
+
+# Validate a voice for a provider. Echoes the canonical voice and returns 0 on
+# success; returns 1 (no output) on rejection. Mirrors validateVoice() in the JS SSOT.
+catalog_validate_voice() {
+  local _p _v _lc; _p="$(catalog_canonical_provider "${1:-}")" || return 1
+  _v="${2:-}"; _lc="$(_catalog_lc "$_v")"
+  case "$_p" in
+    kokoro)
+      case "$_lc" in
+        'af_heart'|'af_alloy'|'af_aoede'|'af_bella'|'af_jessica'|'af_kore'|'af_nicole'|'af_nova'|'af_river'|'af_sarah'|'af_sky'|'am_adam'|'am_echo'|'am_eric'|'am_fenrir'|'am_liam'|'am_michael'|'am_onyx'|'am_puck'|'bf_alice'|'bf_emma'|'bf_isabella'|'bf_lily'|'bm_daniel'|'bm_fable'|'bm_george'|'bm_lewis'|'jf_alpha'|'jf_gongitsune'|'jf_nezumi'|'jf_tebukuro'|'jm_kumo'|'zf_xiaobei'|'zf_xiaoni'|'zf_xiaoxiao'|'zf_xiaoyi'|'zm_yunxi'|'zm_yunxia'|'zm_yunyang'|'ef_dora'|'em_alex'|'em_santa'|'ff_siwis'|'hf_alpha'|'hm_omega'|'if_sara'|'im_nicola'|'pf_dora'|'pm_alex'|'pm_santa'|'kf_alpha'|'km_hyunsu')
+          printf '%s' "$_lc"; return 0 ;;
+      esac
+      return 1 ;;
+    elevenlabs)
+      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
+      [[ "$_v" =~ ^[A-Za-z0-9]{20}$ ]] && { printf '%s' "$_v"; return 0; }
+      return 1 ;;
+    soprano)
+      case "$_lc" in
+        ''|soprano|soprano-default) printf '%s' 'soprano-default'; return 0 ;;
+      esac
+      return 1 ;;
+    piper|windows-piper)
+      if [[ "$_v" =~ ^[a-z]{2,3}_[A-Z]{2}- ]] || [[ "$_v" == *"::"* ]]; then
+        printf '%s' "$_v"; return 0
+      fi
+      return 1 ;;
+    macos|windows-sapi)
+      if [ -n "$_v" ]; then printf '%s' "$_v"; return 0; fi
+      [ "$_p" = windows-sapi ] && { printf '%s' ''; return 0; }
+      return 1 ;;
+  esac
+  return 1
+}

package/.claude/hooks/provider-commands.sh

@@ -44,6 +44,7 @@
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 source "$SCRIPT_DIR/provider-manager.sh"
 source "$SCRIPT_DIR/language-manager.sh"
+source "$SCRIPT_DIR/python-resolver.sh"
 
 COMMAND="${1:-help}"
 
@@ -101,7 +102,7 @@ provider_list() {
 
   # Check installation status of optional providers
   local kokoro_installed=false
-  python3 -c "import importlib.util,sys; sys.exit(0 if importlib.util.find_spec('kokoro') else 1)" 2>/dev/null && kokoro_installed=true
+  [[ -n "$PYTHON_BIN" ]] && "$PYTHON_BIN" -c "import importlib.util,sys; sys.exit(0 if importlib.util.find_spec('kokoro') else 1)" 2>/dev/null && kokoro_installed=true
 
   local elevenlabs_key_set=false
   if [[ -n "${ELEVENLABS_API_KEY:-}" ]]; then

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

@@ -73,6 +73,23 @@ get_provider_config_path() {
   echo "$provider_file"
 }
 
+# @function _load_provider_catalog
+# @intent Source the generated Provider Catalog (bash-3.2-safe SSOT accessors)
+# @why Single source of truth for per-provider defaults (AVI-S9.4) — mirrors the
+#      identical pattern in voice-manager.sh (AVI-S9.3). FAIL-SAFE: callers probe
+#      `type catalog_* >/dev/null 2>&1` and fall back to legacy hardcoded literals
+#      when the artifact is missing (installed-tree skew). Defaults never break.
+# @returns None (sources catalog_* functions into the current shell when present)
+# @sideeffects None (double-sourcing is guarded inside provider-catalog.sh)
+_load_provider_catalog() {
+  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
+}
+
 # @function get_active_provider
 # @intent Read currently active TTS provider from config file
 # @why Central function for determining which provider to use
@@ -187,12 +204,24 @@ migrate_voice_to_provider() {
     "en_US-danny-low:Alex"
   )
 
-  # Default voices by provider
-  local piper_default="en_US-lessac-medium"
-  local macos_default="Samantha"
-  local soprano_default="soprano-default"  # Single voice — no selection needed
-  local elevenlabs_default="Rachel"
-  local kokoro_default="af_heart"
+  # Default voices by provider — sourced from the generated Provider Catalog SSOT
+  # (AVI-S9.4, catalog_default_voice). FAIL-SAFE: legacy literals if the catalog
+  # artifact is missing (installed-tree skew) — mirrors AVI-S9.3's pattern.
+  _load_provider_catalog
+  local piper_default macos_default soprano_default elevenlabs_default kokoro_default
+  if type catalog_default_voice >/dev/null 2>&1; then
+    piper_default="$(catalog_default_voice piper)"
+    macos_default="$(catalog_default_voice macos)"
+    soprano_default="$(catalog_default_voice soprano)"  # Single voice — no selection needed
+    elevenlabs_default="$(catalog_default_voice elevenlabs)"
+    kokoro_default="$(catalog_default_voice kokoro)"
+  else
+    piper_default="en_US-lessac-medium"
+    macos_default="Samantha"
+    soprano_default="soprano-default"  # Single voice — no selection needed
+    elevenlabs_default="Sarah"
+    kokoro_default="af_heart"
+  fi
 
   # Single-voice providers: migration is straightforward
   case "$target_provider" in
@@ -214,7 +243,15 @@ migrate_voice_to_provider() {
     return 0
   fi
 
-  # If migrating FROM a single-voice provider, return default for target provider
+  # If migrating FROM a single-voice/fixed-shape provider, return default for target.
+  # NOTE ("Rachel" sentinel, AVI-S9.4): "Rachel" was ElevenLabs' hardcoded default
+  # before the 21-voice catalog trim (AVI-S8.1) — it is NOT a name-to-id match in
+  # today's catalog. This is READ-SIDE TOLERANCE ONLY (CLAUDE.md non-destructive
+  # rule): a user config that still says "Rachel" degrades gracefully to the
+  # target provider's default instead of erroring; we never rewrite the user's file.
+  if [[ "$current_voice" == "Rachel" ]]; then
+    echo "⚠️  '$current_voice' is a legacy ElevenLabs default no longer in the voice catalog; migrating to the $target_provider default." >&2
+  fi
   if [[ "$current_voice" == "soprano-default" || "$current_voice" == "Rachel" || "$current_voice" =~ ^[a-z]{2}_[a-z0-9_]+$ ]]; then
     case "$target_provider" in
       piper) echo "$piper_default" ;;
@@ -372,6 +409,7 @@ get_provider_script_path() {
 # @returns Echoes LLM name (e.g. "claude-code") or empty string if no remote routing configured
 # @exitcode 0=always
 detect_routing_llm() {
+  source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/python-resolver.sh"
   # Priority 1: AGENTVIBES_LLM_KEY env var (set during active TTS sessions)
   if [[ -n "${AGENTVIBES_LLM_KEY:-}" ]] && [[ "$AGENTVIBES_LLM_KEY" =~ ^llm:([a-zA-Z0-9][a-zA-Z0-9_-]*)$ ]]; then
     echo "${BASH_REMATCH[1]}"
@@ -380,9 +418,9 @@ detect_routing_llm() {
 
   # Priority 2: First mode=remote entry in transport-config.json
   local _transport_cfg="$HOME/.agentvibes/transport-config.json"
-  if [[ -f "$_transport_cfg" ]] && command -v python3 &>/dev/null; then
+  if [[ -f "$_transport_cfg" ]] && [[ -n "$PYTHON_BIN" ]]; then
     local _remote_llm
-    _remote_llm=$(AGENTVIBES_CFG="$_transport_cfg" python3 - <<'PYEOF'
+    _remote_llm=$(AGENTVIBES_CFG="$_transport_cfg" "$PYTHON_BIN" - <<'PYEOF'
 import json, os, sys
 try:
     d = json.load(open(os.environ['AGENTVIBES_CFG'], encoding='utf-8'))