# Rapport Hermes — 2026-06-06_18-30
> Branche : `hermes/daily-work` · Fichiers analysés : 5

---
## Résumé
- ✅ À jour : 4
- ⚠️  À améliorer : 1

## ✅ `admin/README.md` — 8/10

**Statut** : à_jour  
**Résumé** : Documentation structurée avec des liens vers les guides et procédures clés, mais nécessite des mises à jour sur l'état des services et l'historique des incidents  

**Problèmes :**
- Le service litellm est marqué comme inactive alors que la documentation antérieure suggérait un fonctionnement actif
- Aucune version spécifique des services n'est indiquée dans l'état brut
- Le fichier incidents.md est mentionné mais n'est pas consultable dans le contenu fourni

**Suggestions :**
- Mettre à jour l'état des services avec des versions précises et statuts réels
- Compléter le fichier incidents.md avec un historique détaillé des incidents passés
- Ajouter des notes sur les divergences observées entre la documentation et l'état réel du système

**État réel connu de Hermes :**  
litellm inactive, hermes/dnsmasq/nfs-server/qdrant actifs, aucun pod crashé signalé dans Kubernetes, export NFS fonctionne

---

## ✅ `admin/ia/alertmanager-webhook.md` — 9/10

**Statut** : à_jour  
**Résumé** : Documentation complète et structurée décrivant le fonctionnement du webhook AlertManager vers Hermes, avec exemples de payloads et instructions de test.  

**Problèmes :**
- Manque d'explication sur la gestion des erreurs/échecs de traitement
- Aucun exemple de cas d'usage réel ou de scénario d'alerte complexe

**Suggestions :**
- Ajouter une section 'Débogage' avec exemples de payloads erronés et corrections
- Inclure un tableau comparatif des statuts d'alerte (firing, resolved)
- Ajouter des notes sur la sécurité (authentification, rate limiting)

**État réel connu de Hermes :**  
Le service est actif sur storage-01, le webhook répond correctement avec traitement asynchrone et journalisation. Les tests curl fonctionnent comme attendu.

---

## ⚠️ `admin/ia/hermes-souls.md` — 1/10

**Statut** : erreur  
**Résumé** : Le fichier demandé est introuvable dans le système de fichiers, ce qui empêche l'analyse complète.  

**Problèmes :**
- Le chemin `admin/ia/hermes-souls.md` n'existe pas dans le système de fichiers.
- Aucun contenu n'a pu être lu depuis le fichier.
- Le document mentionne des fichiers comme `funk-ai.md` mais pas `hermes-souls.md` dans les sources versionnées.

**Suggestions :**
- Vérifier le chemin du fichier (ex: `admin/ia/` ou `docs/hermes-souls.md`)
- Utiliser `find /path/to/search -name "hermes-souls.md"` pour localiser le fichier
- Confirmer si le fichier a été déplacé ou supprimé

**État réel connu de Hermes :**  
Le fichier n'existe pas dans le système de fichiers actuel

---

## ✅ `admin/ia/hermes-voice.md` — 8/10

**Statut** : ok  
**Résumé** : Documentation complète pour configurer le client vocal Hermes avec architecture VAD/Whisper/SSH/Piper, incluant installation, modes d'utilisation et configuration.  

**Problèmes :**
- Section 'Dépannage' incomplète (le texte est coupé mi-mitte)
- Aucune mention des dépendances audio requises pour Piper (libsox, libatlas3, etc.)

**Suggestions :**
- Ajouter une note sur la calibration du seuil de détection vocale (VOICE_THRESH)
- Mettre en avant la sécurité des connexions SSH (utilisation de clés plutôt que mots de passe)
- Ajouter un exemple concret de requête dans le mode 'Sans TTS'

**État réel connu de Hermes :**  
Fonctionnel avec les composants requis (Whisper, Piper, SSH) mais nécessite validation des permissions audio et des dépendances système complètes

---

## ✅ `admin/ia/hermes.md` — 9/10

**Statut** : ok  
**Résumé** : Documentation complète et structurée sur l'implémentation de Hermes Agent dans le homelab Funk, avec des sections claires sur l'architecture, les profils, les services et la configuration.  

**Problèmes :**
- La section SOUL.md est incomplète (chemin de fichier tronqué)
- Aucune mention des dépendances logicielles requises (ex: lmstudio, qdrant)

**Suggestions :**
- Compléter le chemin du fichier SOUL.md
- Ajouter une section détaillant les dépendances logicielles et les prérequis d'installation

**État réel connu de Hermes :**  
Le composant est actif sur storage-01 avec les services hermes-agent et hermes-dashboard, et les profils configurés selon les specs.

---

