mes_skills/skills/infra/ha-log-investigator/history.md

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