feat(stt): HUD avancé — design Claude Design câblé au backend

Remplace le HUD minimal (cercle CSS) par le design Claude Design : avatar
portrait réactif (anneau + ping d'écoute + spinner de réflexion), transcript
à bulles (tag modèle), indicateur de connexion + reconnexion auto, et un
drawer Réglages.

- HUD (stt/hud/index.html) : HTML/CSS/JS sans dépendance externe, DEMO=false
  branché sur le websocket existant (états idle/listening/thinking/speaking,
  user/assistant/error). Portraits chargés depuis hud/avatars/ (repli « あ »
  si absent — voir avatars/README.md).
- Backend (ui/app.py) : le HUD renvoie {"type":"settings",...} ; le serveur
  applique à chaud reset / mode cerveau (modèle LiteLLM) / mot de réveil via
  _apply_settings (best-effort, non bloquant).
- engine/cli : tag du modèle courant ajouté aux réponses (events assistant).
- Docs : hud/README + avatars/README + admin/ia/stt.md (phase 4 ✅) + config.

Phase 4 de la roadmap STT. Reste : test sur poste + portraits réels.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017Qjq5jHiqNepnobJpHYpCa

stt/client/config/README.md

@@ -5,21 +5,23 @@ Tout ce qui se change **sans recompiler**. `stt --setup` copie `stt.example.toml
 
 ```
 config/
-├── stt.example.toml   # config de référence (modes cerveau, voix, thème, mémoire)
-├── themes/            # thèmes HUD : couleurs, fond, style du visualiseur (CSS/JSON)
-├── avatars/           # images / avatars affichés dans le HUD
-└── voices/            # modèles Piper .onnx (TTS) — fr_FR par défaut
+├── stt.example.toml   # config de référence (serveur/modèle, voix, ui, mémoire)
+└── README.md
 ```
 
+> Les **portraits de l'avatar** et le **thème** ne vivent plus dans `config/` : le HUD les
+> gère lui-même. Avatars → `stt/hud/avatars/` (servis par le HUD — voir son README).
+> Thème → réglé en direct dans le drawer Réglages (intensité d'accent, mémorisé en localStorage).
+
 ## Points de personnalisation
 
 | Quoi | Où | Note |
 |---|---|---|
-| Image / avatar | `avatars/` + `ui.avatar` | swappable à chaud |
-| Thème / design | `themes/` + `ui.theme` | couleurs, fond, visualiseur |
-| Voix | `voices/*.onnx` + `voice.piper_voice` | géré par `stt --setup` |
-| Wake word | `voice.wake_word` | défaut « Ok Hermès » |
-| Cerveau | `[brain]` | mode + override + endpoints |
+| Avatar (portraits) | `stt/hud/avatars/<set>-{idle,think,speak}.png` | jeu choisi dans Réglages → Avatar |
+| Thème / accent | Réglages → intensité (HUD) | rose doux → rouge, persisté en localStorage |
+| Voix TTS | `~/.local/share/piper/<voix>.onnx` + `voice.piper_voice` | Piper |
+| Mot de réveil | `voice.wake_word` (ou Réglages → mot de réveil) | défaut « hermes » |
+| Modèle (cerveau) | `server.model` · `stt --model` · Réglages → mode cerveau | alias LiteLLM |
 
-> 🔒 La clé Anthropic (mode `claude-direct`) passe par la variable d'env `ANTHROPIC_API_KEY`,
-> **jamais** dans ce fichier (qui peut finir versionné).
+> 🔒 Pas de clé API côté client : l'inférence (et donc Claude) passe par le STT-server
+> in-cluster, jamais par le poste.

stt/client/config/stt.example.toml

@@ -18,12 +18,14 @@ silence_sec = 1.2
 min_speech_sec = 0.6
 chat_timeout_sec = 60
 
+# theme / avatar sont désormais réglés dans le HUD (drawer Réglages, mémorisé en
+# localStorage) — ces deux clés sont gardées pour compat mais ignorées par le HUD.
 [ui]
 theme = "arc-reactor"
 avatar = "default"
-kiosk = true
+kiosk = true                        # ouvre le HUD en plein écran (kiosk) au lancement
 ws_host = "127.0.0.1"
-ws_port = 9300                      # websocket états → HUD (doit matcher hud/index.html)
+ws_port = 9300                      # websocket états ↔ HUD (doit matcher hud/index.html)
 http_port = 9301                    # HTTP statique qui sert le HUD
 
 [memory]