# Historique de ha-log-investigator

## 2026-05-16 — Création initiale
- Création du skill `ha-log-investigator`.
- Ajout des livrables `repair.md`, `best_entity.md`, `memory.md`.
- Ajout des règles de preuve officielle, d'accès minimal et de non-invention.

## 2026-05-16 — Ajout de l'accès SSH
- Ajout des champs SSH dans le modèle d'identifiants.
- Ajout d'un collecteur SSH en lecture seule.
- Ajout de la préférence pour clé SSH, avec compatibilité mot de passe.

## 2026-05-16 — Ajout de la mémoire durable
- Ajout du livrable `memory.md` pour conserver les éléments pérennes de l'installation.

## 2026-05-16 — Amélioration après test réel
- Correction du collecteur pour Home Assistant OS / BusyBox.
- Remplacement de la collecte `scp` par une lecture distante plus robuste.
- Ajout de la collecte des fichiers Lovelace, réparations et registres utiles.

## 2026-05-16 — Gestion moderne des logs HAOS
- Évolution constatée : sur Home Assistant OS, `/config/home-assistant.log` n'est plus une source attendue par défaut.
- Source officielle : documentation Home Assistant `logger`.
- Mise à jour du skill pour privilégier `Settings > System > Logs`, `ha core logs` si autorisé, ou le fichier dupliqué seulement si activé.
- Ajout de la détection explicite de l'absence de fichier log sans la traiter comme anomalie.

## 2026-05-16 — Sécurité et réversibilité
- Ajout du compactage optionnel avec `rtk log` côté machine de travail.
- Ajout des URLs officielles dans les recommandations.
- Ajout d'une trace de retour arrière obligatoire avant suppression demandée.

## À surveiller
- Évolutions futures des APIs ou commandes officielles de collecte des logs.
- Changements de structure des registres `.storage`.
- Évolutions des mécanismes de réparations Home Assistant.

## 2026-05-16 — Distinction des add-ons SSH pour les logs HAOS
- Évolution constatée pendant le test réel : `ha core logs` fonctionne depuis l'add-on officiel `Terminal & SSH`, alors qu'un autre accès SSH a renvoyé `401 Unauthorized`.
- Source officielle : documentation `Common tasks - Operating System` et documentation de l'add-on officiel `Terminal & SSH`.
- Mise à jour prévue : préférer explicitement `Terminal & SSH` pour les logs Home Assistant OS et tracer l'add-on utilisé pour chaque collecte.


## 2026-05-16 — Collecte de logs via session SSH interactive
- Évolution constatée pendant le test réel : `ha core logs` renvoie `401 Unauthorized` en commande SSH distante directe, mais fonctionne dans une vraie session interactive avec TTY.
- Conséquence : le skill doit tester le mode interactif avant de conclure que les logs Core sont inaccessibles.
- Mise à jour : ajout d'une règle spécifique dans l'analyse des logs et la collecte SSH.


## 2026-05-16 — Priorité au fichier log dupliqué quand présent
- Évolution constatée pendant le test réel : après activation du mode de compatibilité, `/config/home-assistant.log` est de nouveau disponible et exploitable.
- Mise à jour : le collecteur préfère désormais le fichier dupliqué non vide avant de tenter `ha core logs` ou le mode interactif.


## 2026-05-16 — Intégration de Watchman dans l'audit
- Ajout de Watchman comme source complémentaire obligatoire lorsqu'il est installé.
- Ajout de la lecture du rapport final `watchman_report.txt`.
- Ajout d'une règle de croisement avec les logs, les dashboards et l'état réel des entités afin de tenir compte des limites heuristiques de Watchman.

## 2026-05-16 — Intégration de Spook dans l'audit
- Ajout de Spook comme complément pour le suivi des réparations et la gestion d'issues visibles dans le dashboard Repairs.
- Ajout d'une règle de croisement avec les logs, Watchman et l'état réel des entités.
- Spook est utilisé pour suivre et matérialiser les problèmes, pas comme source unique de vérité.