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

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

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

**Statut** : à_jour  
**Résumé** : Document d'index administratif bien structuré avec des liens vers les guides clés, mais manque de versionning et de mise à jour régulière.  

**Problèmes :**
- Le fichier incidents.md est mentionné mais sans lien hypertexte
- Aucune indication de version ou de date de mise à jour
- Manque de mention des dernières mises à jour du cluster (ex: ROCm 5.1.2)

**Suggestions :**
- Ajouter un header avec versioning (ex: 'v1.2.0 - 2026-06-05')
- Créer un lien vers incidents.md dans la section Navigation rapide
- Mettre à jour les sections ops/ et ia/ avec les dernières configurations (ex: ROCm 5.1.2, Talos 2.2.3)
- Ajouter une note sur la politique de mise à jour du document

**État réel connu de Hermes :**  
Le document reste fonctionnel comme index, mais son statut d'obsolescence est inconnu en l'absence de versionning. Les liens sont tous actifs et les sections mentionnées existent dans le répertoire admin.

---

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

**Statut** : ok  
**Résumé** : Documentation complète du webhook AlertManager-Hermes avec architecture, flux, tests et gestion de service. Manque quelques détails opérationnels.  

**Problèmes :**
- Aucun paragraphe sur la sécurisation du webhook (authentification, SSL, rate limiting)
- Les exemples de curl ne montrent pas les headers d'authentification requis
- Pas de section dédiée aux erreurs courantes et résolutions

**Suggestions :**
- Ajouter une section 'Sécurité' avec des recommandations (OAuth2, TLS, auth API key)
- Mettre à jour les exemples de curl avec des headers d'authentification (ex: 'Authorization: Bearer <token>')
- Ajouter un paragraphe 'Débogage' avec des commandes pour vérifier les webhooks actifs

**État réel connu de Hermes :**  
Le composant est opérationnel dans Funk avec les configurations décrites. Les tests manuels montrent un flux correct d'alertes vers Hermes, mais les métriques de latence et taux de succès ne sont pas surveillés dans la documentation.

---

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

**Statut** : erreur_parse  
**Résumé** : Hermes n'a pas retourné de JSON valide  

---

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

**Statut** : à_jour  
**Résumé** : Documentation complète pour le client vocal Hermes avec architecture, installation, utilisation et configuration, mais nécessite des améliorations dans les sections dépannage et précision des étapes.  

**Problèmes :**
- Le dépannage mentionne des problèmes de transcription Whisper mais ne fournit pas de solutions concrètes
- Les étapes d'installation de Piper manquent de précision sur le placement des fichiers téléchargés
- La configuration réseau ne détaille pas la commande exacte pour ouvrir le port 4000

**Suggestions :**
- Ajouter des solutions détaillées pour les problèmes de transcription Whisper
- Clarifier les chemins d'installation pour les fichiers Piper
- Préciser la commande nftables pour ouvrir le port 4000

**État réel connu de Hermes :**  
Le composant est actif dans Funk avec les configurations décrites, mais nécessite des ajustements pour améliorer la robustesse des instructions

---

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

**Statut** : à_jour  
**Résumé** : Documentation complète sur l'implémentation Hermes Agent avec architecture, profils, services et configuration, mais avec des sections incomplètes (SOUL.md tronquée)  

**Problèmes :**
- Section SOUL.md tronquée après '/srv/data/he---'
- Manque de détails sur la configuration des profils (ex: variables spécifiques à chaque profil)
- Aucune mention des hooks ou scripts de démarrage personnalisés

**Suggestions :**
- Compléter la section SOUL.md avec l'identité complète des profils
- Ajouter des exemples de configuration pour chaque profil (brain/system/monitor)
- Inclure une section sur les hooks systemd personnalisés

**État réel connu de Hermes :**  
Le composant Hermes Agent est actif sur storage-01 avec les services systemd hermes-agent (port 8080) et hermes-dashboard (port 9119). La configuration utilise LM_BASE_URL=http://127.0.0.1:4000/v1 et LM_API_KEY=lm-studio. Les profils sont gérés via des fichiers .md dans /srv/data/hermes/profils/

---

