41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# Watchman
|
|
|
|
## Rôle
|
|
|
|
Utiliser Watchman lorsqu'il est installé pour compléter l'audit Home Assistant.
|
|
|
|
Watchman scanne les fichiers de configuration et signale les entités et actions/services référencés mais manquants ou indisponibles. Il produit un rapport texte, généralement `watchman_report.txt`, et peut aussi retourner un rapport via l'action `watchman.report`.
|
|
|
|
## Règles d'usage
|
|
|
|
- Vérifier si Watchman est installé avant l'analyse finale.
|
|
- S'il est installé, lire le rapport le plus récent et l'intégrer aux constats.
|
|
- Ne pas traiter automatiquement chaque ligne Watchman comme une vérité absolue : Watchman utilise une analyse heuristique et peut produire des faux positifs ou faux négatifs.
|
|
- Croiser ses résultats avec :
|
|
- l'état réel des entités ;
|
|
- les dashboards ;
|
|
- les automatisations ;
|
|
- les logs runtime.
|
|
|
|
## Rapport attendu
|
|
|
|
Chercher en priorité :
|
|
- `/config/watchman_report.txt`
|
|
- ou le chemin configuré dans Watchman si différent.
|
|
|
|
## Quand produire le rapport
|
|
|
|
Si nécessaire et si l'utilisateur autorise l'action, exécuter `watchman.report` depuis Home Assistant avec création de fichier afin d'obtenir un rapport actualisé avant l'analyse finale.
|
|
|
|
## Ce qu'il faut reprendre dans les livrables
|
|
|
|
Dans `repair.md` :
|
|
- nombre d'entités manquantes ;
|
|
- nombre d'actions/services manquants ;
|
|
- exemples significatifs ;
|
|
- indication que le rapport vient de Watchman.
|
|
|
|
Dans `best_entity.md` :
|
|
- pistes de nettoyage des références orphelines ;
|
|
- priorités d'amélioration si elles sont confirmées par d'autres sources.
|