# 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.