docs(hermes): rapport analyse 2026-06-05_08-00 — 5 fichiers

Analysés : README.md, alertmanager-webhook.md, hermes-souls.md, hermes-voice.md, hermes.md
À améliorer : 2/5

Co-Authored-By: Hermes <hermes@funk.lab>
This commit is contained in:
Hermes Bot 2026-06-05 08:03:38 +02:00
parent 27f3397b41
commit c1cef4869c

View file

@ -0,0 +1,108 @@
# Rapport Hermes — 2026-06-05_08-00
> Branche : `hermes/daily-work` · Fichiers analysés : 5
---
## Résumé
- ✅ À jour : 3
- ⚠️ À améliorer : 2
## ✅ `admin/README.md` — 9/10
**Statut** : à_jour
**Résumé** : Document d'index complet avec liens vers les guides d'administration clés, mais présente quelques liens potentiellement obsolètes
**Problèmes :**
- Le lien vers [ia/rocm.md](ia/rocm.md) pourrait être obsolète si le support ROCm a été supprimé
- Le fichier [incidents.md](incidents.md) est mentionné mais pas décrit dans le résumé principal
- Manque de mention des nouvelles fonctionnalités du cluster Kubernetes récents
**Suggestions :**
- Vérifier la validité des liens vers les fichiers IA (rocm.md, hermes.md)
- Ajouter une section 'Mises à jour récentes' pour les changements critiques
- Mettre à jour la liste des guides d'installation pour refléter les dernières versions des composants
**État réel connu de Hermes :**
Le document reste fonctionnel comme index principal, mais des vérifications des liens et mises à jour des sections critiques sont recommandées
---
## ✅ `admin/ia/alertmanager-webhook.md` — 9/10
**Statut** : à_jour
**Résumé** : Documentation complète et structurée sur le webhook AlertManager → Hermes, avec architecture, fonctionnement, tests et gestion du service.
**Problèmes :**
- Le diagramme d'architecture manque de mention du modèle Qwen3-1.7B-monitor utilisé par ask-agent
- La commande curl de test ne spécifie pas de vérification des codes de réponse HTTP
**Suggestions :**
- Ajouter le nom du modèle (qwen3-1.7b-monitor) dans le diagramme d'architecture
- Mettre à jour le test curl pour inclure '-I' et vérifier le code de réponse (200 OK)
- Ajouter une note sur la configuration des variables d'environnement NO_COLOR=1 et TERM=dumb dans la section systemd
**État réel connu de Hermes :**
Le composant est actif et opérationnel dans Funk, avec des logs journalctl disponibles pour monitoring. Les tests curl montrent une réponse 'ok' attendue.
---
## ⚠️ `admin/ia/hermes-souls.md` — 5/10
**Statut** : erreur
**Résumé** : Le fichier `hermes-souls.md` n'existe pas dans le système de fichiers. Les fichiers SOUL.md des profils sont déployés dans `/srv/data/hermes/profiles/<profil>/SOUL.md` mais le chemin `admin/ia/hermes-souls.md` est inconnu.
**Problèmes :**
- Fichier introuvable (`admin/ia/hermes-souls.md`)
- Chemin de fichier non conforme à la structure du cluster
- Absence de documentation pour le profil `system` (identité vide)
**Suggestions :**
- Créer le fichier `SOUL.md` dans `/srv/data/hermes/profiles/funk-ai/`
- Compléter l'identité du profil `system` dans le document
- Vérifier la présence des autres fichiers SOUL.md dans les dossiers de profil
**État réel connu de Hermes :**
Le fichier est absent du système de fichiers. Les profils `funk-ai`, `monitor`, `system`, et `brain` ont des fichiers SOUL.md versionnés dans `hermes-skills/souls/` mais non déployés dans le chemin spécifié.
---
## ✅ `admin/ia/hermes-voice.md` — 8/10
**Statut** : à_jour
**Résumé** : Documentation complète pour configurer le client vocal Hermes avec architecture claire et étapes d'installation détaillées, mais manque de conseils de dépannage avancés.
**Problèmes :**
- Lien vers le téléchargement de Piper est un lien direct vers un fichier ONNX sans vérification de la validité
- Aucune mention des dépendances Python requises pour le fonctionnement de Whisper
- Le test piper manque de vérification de la sortie audio
- Aucune explication sur la configuration du wake word ou la gestion des fausses déclenches
**Suggestions :**
- Ajouter un exemple de vérification du fonctionnement de Whisper avec un fichier audio de test
- Préciser les paramètres nécessaires pour activer le mode push-to-talk
- Inclure des conseils pour optimiser le seuil de détection vocale en fonction du bruit ambiant
- Ajouter une section sur la gestion des erreurs courantes lors de l'initialisation de Whisper
**État réel connu de Hermes :**
Le composant est fonctionnel dans Funk avec les configurations décrites, mais nécessite des améliorations dans la documentation pour couvrir les cas d'usage avancés
---
## ⚠️ `admin/ia/hermes.md` — 8/10
**Statut** : incomplet
**Résumé** : Documentation structurée sur Hermes Agent avec architecture, profils et configuration, mais avec une section SOUL.md incomplète
**Problèmes :**
- La section SOUL.md est tronquée (« /srv/data/he ») et manque le contenu complet des identités des profils
- Aucune mention des nouvelles configurations post-2026-05-29 (migration NVMe bind-mount)
**Suggestions :**
- Compléter la section SOUL.md avec les descriptions des profils (funk-ai, brain, system, monitor)
- Ajouter une note explicite sur la migration NVMe bind-mount depuis 2026-05-29
- Vérifier la date de mise à jour des configurations systemd et des variables d'environnement
**État réel connu de Hermes :**
Hermes Agent est opérationnel avec les services systemd et les profils décrits, mais la configuration des identités des profils (SOUL.md) est incomplète et nécessite des ajustements
---