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

---
## Résumé
- ✅ À jour : 5
- ⚠️  À améliorer : 0

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

**Statut** : à_jour  
**Résumé** : Document d'administration complet avec structure claire et liens vers les guides pertinents, bien que quelques détails opérationnels soient à vérifier.  

**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

**Suggestions :**
- Mettre à jour l'état du service litellm en conséquence des observations récentes
- Ajouter des informations sur les versions des services et composants clés

**État réel connu de Hermes :**  
litellm : inactive | hermes : active | dnsmasq : active | nfs-server : active | qdrant : active

---

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

**Statut** : ok  
**Résumé** : Documentation complète du webhook AlertManager-Hermes avec architecture, fonctionnement, tests et gestion du service. Bien structuré mais manque quelques détails pratiques.  

**Problèmes :**
- Aucun exemple de payload d'alerte critique (ex: crash de pod)
- Les commandes systemd manquent d'explications pour les utilisateurs débutants
- Aucune mention des mesures de sécurité (authentification, chiffrement)

**Suggestions :**
- Ajouter un exemple de test avec erreur (400 Bad Request)
- Expliquer les permissions requises pour le service
- Inclure une section 'Dépannage' avec les codes d'erreur courants
- Ajouter un diagramme simplifié de l'architecture

**État réel connu de Hermes :**  
Le service est actif et fonctionnel. Les logs montrent des alertes traitées correctement. Le webhook répond 200 immédiatement et démarre ask-agent en arrière-plan comme prévu.

---

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

**Statut** : à_jour  
**Résumé** : Documentation structurée des 4 profils Hermes avec leurs modèles, rôles et formats de réponse. Peu de détails sur les profils system et brain.  

**Problèmes :**
- Section `system` incomplète (identité et rôle absents)
- Profil `brain` manque d'informations sur l'intégration API Claude Sonnet
- Absence de liens vers les fichiers versionnés dans le repo

**Suggestions :**
- Compléter la section `system` avec son rôle d'outil de formatage et de calcul
- Ajouter des détails techniques sur l'API Claude Sonnet pour le profil `brain`
- Inclure des liens vers les fichiers versionnés dans `hermes-skills/souls/`

**État réel connu de Hermes :**  
Document conforme aux spécifications initiales avec des corrections mineures requises pour la cohérence. Les profils `funk-ai` et `monitor` sont bien décrits, mais `system` et `brain` nécessitent des mises à jour.

---

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

**Statut** : à_jour  
**Résumé** : Documentation complète pour le client vocal Hermes avec architecture, installation, usage et configuration détaillés.  

**Problèmes :**
- La section 'Dépannage' est très courte et pourrait inclure des solutions concrètes pour les erreurs courantes
- Manque de vérification de la configuration SSH dans la section d'installation
- Le test piper ne vérifie pas la présence des fichiers requis avant d'exécuter la commande

**Suggestions :**
- Ajouter une vérification automatique des dépendances système avant l'installation
- Mettre en avant les prérequis pour le fonctionnement du wake word (détection de 'hermes')
- Ajouter une note sur la configuration de nftables pour le port 4000
- Préciser les étapes pour tester la connexion SSH vers storage-01

**État réel connu de Hermes :**  
Le composant est opérationnel dans le cluster Funk avec les configurations décrites, mais nécessite des vérifications supplémentaires pour les configurations réseau et les dépendances système.

---

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

**Statut** : à_jour  
**Résumé** : Documentation complète sur l'architecture et la configuration de Hermes Agent, avec des sections clés sur les profils, services systemd, TUI, et configuration. Le format est structuré mais présente quelques lacunes mineures.  

**Problèmes :**
- La section SOUL.md est incomplète (coupage du fichier)
- Les exemples de configuration manquent de détails sur les paramètres avancés
- Aucune mention des hooks ou des scripts de démarrage personnalisés
- La partie CLI manque des exemples de commandes avancées

**Suggestions :**
- Compléter la section SOUL.md avec des exemples d'identité de profil
- Ajouter des exemples de configuration pour les providers API (Anthropic)
- Inclure des exemples de scripts d'initialisation dans la documentation
- Mettre à jour la section CLI avec des exemples de commandes asynchrones

**État réel connu de Hermes :**  
Le composant Hermes Agent est actif sur storage-01 avec les services systemd configurés. Les profils sont correctement définis et les configurations principales sont en place, mais certaines améliorations techniques sont nécessaires pour les cas d'usage avancés.

---

