refactor(stt): pivot client-serveur — STT-server in-cluster + client pipx

Sépare STT en deux :
- stt/client/ : commande `stt` (pipx), voix locale (Whisper/Piper) + HUD ; envoie
  le texte au serveur via api.py (ServerClient → POST /v1/ask). URL serveur paramétrable,
  pas de cerveau local (suppression du routeur 3 modes).
- stt/server/ : STT-server FastAPI (conteneur), /healthz + /v1/ask → LiteLLM (Qwen3/Claude).

Déploiement cluster :
- k8s/apps/stt/ : Deployment, Service, IngressRoute (stt.lab.local), litellm-ext
  (Service + Endpoints → 192.168.10.1:4000 pour joindre LiteLLM hors cluster)
- k8s/apps-of-apps/apps/stt.yaml : Application ArgoCD (depuis main)
- .github/workflows/build-stt-server.yml : build/push image → ghcr.io/alkatrazz24/funk-stt-server

Inférence/chat seulement (outils Hermes 'agir sur Funk' = phase ultérieure, API :8080 à spécifier).
Vérifié : py_compile client+serveur, YAML manifests, ServerClient.

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

stt/README.md

@@ -1,59 +1,56 @@
 # STT — Assistant vocal "Jarvis" de Funk
 
-Assistant vocal + HUD pour le poste perso, branché sur le homelab Funk.
-Écoute (wake word « Ok Hermès »), parle (Piper), affiche un HUD animé, et **agit sur Funk**
-via Hermes Agent — ou discute avec Claude directement en déplacement.
+Assistant vocal type *Jarvis* pour le homelab Funk, en **architecture client-serveur** :
 
-> 📐 **Conception complète** : `admin/ia/stt.md`. Ce dossier est le squelette du projet ;
-> l'implémentation se fait par phases (voir la Roadmap dans le doc de conception).
+- **`server/`** — STT-server : orchestrateur AI **dans le cluster k8s**. Reçoit les requêtes
+  des clients et route l'inférence vers LiteLLM (Qwen3 / Claude). Mémoire centralisée (futur).
+- **`client/`** — commande `stt` installable sur le poste : capture micro, STT (Whisper),
+  TTS (Piper), **HUD graphique**. Envoie le texte au serveur (URL paramétrable).
 
-## Installation (cible : poste perso)
+> 📐 Conception complète : `admin/ia/stt.md`.
 
-```bash
-pipx install "git+https://github.com/Alkatrazz24/Funk-lab.git#subdirectory=stt"
-stt --setup     # télécharge le modèle Whisper, Piper et la voix fr_FR
-stt             # lance le backend + ouvre le HUD
+```
+                 LAN / *.lab.local
+   ┌─ POSTE ──────────┐        ┌─ CLUSTER k8s (ns ai) ──────────────┐
+   │  client `stt`     │  HTTP  │  STT-server (Deployment)            │
+   │  • micro + Whisper│ ─────▶ │  POST /v1/ask → LiteLLM             │
+   │  • Piper (TTS)    │ ◀───── │       (litellm-ext → s01:4000)       │
+   │  • HUD web        │  reply  │  Ingress: stt.lab.local             │
+   └───────────────────┘        └──────────────┬──────────────────────┘
+                                                ▼
+                                       LiteLLM :4000 (s01)
+                                       → Qwen3 (g01) / Claude
 ```
 
-## Commandes prévues
+## Client — installation (poste)
 
-| Commande | Effet |
-|---|---|
-| `stt` | Lance le backend vocal + ouvre le HUD en kiosk |
-| `stt --setup` | Première install : Whisper, Piper, voix, config par défaut |
-| `stt --mode hermes\|local\|claude` | Force le mode cerveau (sinon auto-détection LAN) |
-| `stt --no-tts` | Réponses texte seulement (debug) |
-| `stt --stop` | Arrête le service |
+```bash
+pipx install "git+ssh://git@github.com/Alkatrazz24/Funk-lab.git@<branche>#subdirectory=stt/client"
+stt --setup            # génère ~/.config/stt/stt.toml (dont [server] url)
+stt                    # lance la voix + ouvre le HUD ; dis "Ok Hermès …"
+```
+Prérequis poste : micro, Piper + voix dans `~/.local/share/piper/`, `aplay` (alsa-utils).
+
+## Serveur — déploiement (cluster)
+
+1. **Image** : poussée sur `ghcr.io/alkatrazz24/funk-stt-server` par le workflow
+   `.github/workflows/build-stt-server.yml` (sur push touchant `stt/server/`).
+2. **ArgoCD** : `k8s/apps-of-apps/apps/stt.yaml` → déploie `k8s/apps/stt/` **depuis `main`**.
+   Tant que ce n'est pas mergé sur `main`, le cluster ne le prend pas.
+3. Le serveur joint LiteLLM (s01, hors cluster) via le Service `litellm-ext`
+   (Endpoints manuel → `192.168.10.1:4000`).
 
 ## Structure
 
 ```
 stt/
-├── pyproject.toml       # définit la commande `stt` (entrypoint pipx)
-├── stt/                 # package Python — backend
-│   ├── cli.py           # entrypoint `stt`
-│   ├── config.py        # défauts + ~/.config/stt/stt.toml
-│   ├── voice/           # wake word, STT (faster-whisper), TTS (Piper)
-│   ├── brain/           # routeur 3 modes : hermes / local-direct / claude-direct
-│   ├── memory/          # mémoire 3 tiers (local SQLite ✅, s01/GitHub phase 4)
-│   ├── server/          # HTTP statique (HUD) + websocket (états → HUD)
-│   └── hud/             # front web embarqué dans le package (livré par pipx)
-├── config/              # stt.example.toml + thèmes / avatars / voix
-├── memory/              # distilled/ (versionné) + raw local (gitignoré)
-└── install-service.sh   # systemd --user (démarrage auto) — phase 6
+├── client/          # commande `stt` (pipx) — voix + HUD
+│   ├── pyproject.toml
+│   ├── config/      # stt.example.toml + thèmes/avatars/voix
+│   └── stt/         # cli, config, voice/, api.py (→ serveur), ui/ (HUD), hud/
+└── server/          # STT-server (conteneur) — API + orchestration AI
+    ├── pyproject.toml
+    ├── Dockerfile
+    ├── memory/      # mémoire distillée GitHub (futur, server-side)
+    └── stt_server/  # app.py (FastAPI), brain.py (→ LiteLLM), config.py
 ```
-
-## Cerveau — 3 modes
-
-Auto-détection au démarrage (ping s01 `192.168.1.200`) :
-- **`hermes`** (LAN) → Hermes `:8080`, agit sur Funk.
-- **`local-direct`** (LAN) → LiteLLM `:4000`, chat Qwen3 sur g01.
-- **`claude-direct`** (hors-LAN) → API Anthropic, chat seul.
-
-## Mémoire — 3 tiers
-
-- **Local** : SQLite, historique brut, offline (gitignoré).
-- **s01** : Qdrant `:6333`, sémantique long-terme (partagée RAG Funk, sur LAN).
-- **GitHub** : `memory/distilled/`, mémoire distillée versionnée, portable.
-
-> ⚠️ Seule la mémoire distillée est committée. Transcripts bruts gitignorés. Repo privé.