docs: synchroniser la doc avec l'état réel du cluster (revue Ansible + incident Qdrant)

- ops/ansible.md : tableau complet des rôles par playbook (15 storage-01, 6 gpu-01),
  caveat hermes_agent, note lm_studio inutilisé
- ia/hermes-auto-improve.md : NOUVEAU — doc du worker déployé (trigger :9095,
  modes du script, endpoints, PR squash, pièges connus)
- k8s/n8n.md : workflow 3 "Hermes Doc Worker" documenté (22h, /trigger/all,
  boucle de polling), clé API → vault
- incidents.md : Qdrant crash-loop depuis 2026-06-05 (segment funk-docs corrompu,
  invisible dans --state=failed) + procédure de réparation
- ia/rag.md : bandeau RAG HS
- CLAUDE.md : état 2026-06-10, rôle hermes_auto_improve, 3 workflows n8n,
  vault complet (n8n_api_key, Gmail au lieu de Brevo), section auto-improve
- README.md : lien admin/ops/cluster.md corrigé, arborescence complète
  (tools/, admin/, progress/, skills), roadmap à jour
- PROGRESS.md : entrée 2026-05-29 (migration NVMe) qui existait sans être référencée
- ansible : suppression effective des templates daily timer (cleanup b9be63c)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

admin/ia/hermes-auto-improve.md

@@ -0,0 +1,94 @@
+# hermes-auto-improve — Analyse quotidienne de la documentation
+
+Hermes analyse chaque jour la base de connaissance `admin/`, écrit ses rapports dans
+`admin/hermes/builtin/` et pousse le tout sur la branche `hermes/daily-work`.
+Une PR squash-only vers `main` est créée (ou mise à jour) automatiquement.
+
+---
+
+## Architecture
+
+```
+n8n « Hermes Doc Worker » (22h00)
+    │  POST http://192.168.10.1:9095/trigger/all
+    ▼
+trigger server  (storage-01:9095, systemd hermes-auto-improve)
+    │  lance en background thread
+    ▼
+/usr/local/bin/hermes-auto-improve --all
+    │  pour chaque .md de admin/ (sauf hermes/builtin/) :
+    │    prompt → Hermes (profil funk-ai, Qwen3-8B sur gpu-01)
+    │    → rapport JSON (statut, score, problèmes, suggestions)
+    ▼
+admin/hermes/builtin/YYYY-MM-DD_HH-MM.md   (rapport consolidé)
+    │  git commit + push → hermes/daily-work
+    ▼
+n8n poll GET :9095/status (toutes les 5 min jusqu'à running=false)
+    │
+    ▼
+Email récap + PR GitHub (POST :9095/trigger/daily-pr)
+```
+
+## Composants
+
+| Élément | Emplacement | Géré par |
+|---|---|---|
+| Script d'analyse | `/usr/local/bin/hermes-auto-improve` | rôle `hermes_auto_improve` (source `tools/hermes-auto-improve/auto-improve.py`) |
+| Trigger server | `/usr/local/bin/hermes-auto-improve-server` (`:9095`) | rôle `hermes_auto_improve` (source `tools/hermes-auto-improve/trigger-server.py`) |
+| Service systemd | `hermes-auto-improve.service` (le serveur HTTP, pas de timer) | rôle `hermes_auto_improve` |
+| Scheduling | workflow n8n `CX72UUOempE1YtNL` — Schedule 22h00 | n8n (voir `admin/k8s/n8n.md`) |
+| État de rotation | `/var/lib/hermes-auto-improve/state.json` | script |
+| Log des runs | `/var/log/hermes-auto-improve.log` | trigger server |
+| Clone de travail | `/srv/data/lab/Funk-lab` (branche `hermes/daily-work`) | script (git_sync au début de chaque run) |
+
+## Modes du script
+
+```bash
+hermes-auto-improve              # batch de 5 fichiers (rotation via state.json)
+hermes-auto-improve --all        # tous les docs en une passe (~60-90 min pour 28 fichiers)
+hermes-auto-improve --subdir ia  # un sous-dossier admin/ uniquement
+hermes-auto-improve --dry-run    # analyse sans écrire ni push
+hermes-auto-improve --daily-pr   # crée la PR GitHub (ou met à jour celle ouverte)
+```
+
+## Endpoints du trigger server (`:9095`)
+
+| Endpoint | Action |
+|---|---|
+| `POST /trigger` | run standard (batch de 5) |
+| `POST /trigger/all` | run complet `--all` |
+| `POST /trigger/subdir` | body `{"subdir": "ia"}` |
+| `POST /trigger/dry-run` | analyse sans commit |
+| `POST /trigger/daily-pr` | crée/met à jour la PR |
+| `GET /status` | `{running, last_result, state}` |
+| `GET /health` | healthcheck |
+
+Un seul run à la fois (`already_running` sinon). Timeout interne : 7200 s.
+
+## PR GitHub
+
+- Branche : `hermes/daily-work` → `main`, **squash merge uniquement** (forcé côté repo GitHub)
+- S'il existe déjà une PR ouverte pour la branche, le script **met à jour** titre + corps au lieu d'en créer une nouvelle
+- Identité des commits : `Hermes Bot <hermes@funk.lab>`
+- Le push utilise les credentials `gh` de root sur storage-01 (`HOME=/root` dans le service)
+
+## Vérifications rapides
+
+```bash
+# Le serveur tourne ?
+curl -s http://192.168.10.1:9095/health
+
+# Un run est en cours ? Dernier résultat ?
+curl -s http://192.168.10.1:9095/status | python3 -m json.tool
+
+# Suivre un run en direct (le log n'est écrit qu'en fin de run — vérifier le process)
+ssh storage-01 'ps aux | grep "hermes-auto-improve --" | grep -v grep'
+ssh storage-01 'sudo tail -50 /var/log/hermes-auto-improve.log'
+```
+
+## Pièges connus
+
+- **Le log n'est flushé qu'à la fin du run** — un run `--all` peut sembler silencieux pendant une heure. Vérifier le process ou compter les `POST /v1/chat/completions` dans `journalctl -u litellm`.
+- **`git pull --rebase` dans git_sync** : si on réécrit l'historique de `hermes/daily-work` (force push), il faut aussi reset le clone `/srv/data/lab/Funk-lab` sur storage-01, sinon le prochain run réincorpore les anciens commits.
+- **rag-ingest en fin de run** : échoue tant que Qdrant est HS (incident 2026-06-05) — le run reste valide, seule la ré-indexation est sautée.
+- Les rapports `admin/hermes/builtin/` sont indexés dans le RAG par `rag-ingest` (qui parcourt tout `admin/`) — pollution potentielle des résultats `rag-query`, exclusion à prévoir.

admin/ia/rag.md

@@ -1,5 +1,8 @@
 # RAG — Documentation Funk
 
+> ⚠️ **HS depuis 2026-06-05** — Qdrant en crash-loop (segment `funk-docs` corrompu).
+> Procédure de réparation dans `admin/incidents.md` (entrée 2026-06-05).
+
 Le RAG (Retrieval-Augmented Generation) permet à Hermes de répondre en s'appuyant
 sur la documentation du repo (`admin/`) plutôt que sur sa seule mémoire de modèle.