# Debugging

## Vorhersage korrekt, aber keine Ausführung

1. Aktor-Details öffnen.
2. `Betriebsart` prüfen.
3. `Freigabestatus` prüfen.
4. Text hinter der Vorhersage lesen. `execution_reason` nennt exakt:
   - Shadow-Modus
   - Confidence unter Schaltschwelle
   - Zielzustand bereits erreicht
   - Cooldown aktiv
   - ausgeführt
5. Live-Zustand des Aktors und Triggers in HA prüfen.
6. Add-on-Logs prüfen.

## Weder SillyHome noch HA-Automation schaltet

1. SillyHome-Modus prüfen.
2. Unter `Passende Home-Assistant-Automationen` den Zustand prüfen.
3. Bei Shadow mindestens eine gewünschte HA-Automation fortsetzen.
4. Bei Active mit Übernahme müssen die passenden HA-Automationen pausiert sein.

## Freigabe fehlt

Die UI zeigt den Grund immer als `activation_reason`.

Prüfen:

```text
behavior.status
behavior.sample_count
behavior.high_confidence_sample_count
behavior.activation_ready
behavior.activation_reason
```

## Entität fehlt in der Liste

Den vollständigen Entitätsnamen direkt eingeben. Der Server akzeptiert nur
existierende, unterstützte Aktoren. Ein unbekannter Name liefert `404`.

## Standarddiagnose lokal

```bash
.venv/bin/pytest tests/behavior/test_engine.py -q
.venv/bin/pytest tests/api/test_actuators.py -q
.venv/bin/ruff check app tests
.venv/bin/mypy app backend tests
```

## Standarddiagnose im HA-Add-on

```bash
ha apps info 58adbe1e_sillyhome_next
ha apps logs 58adbe1e_sillyhome_next
```

Health aus einem Add-on mit Zugriff auf das interne Netz:

```bash
wget -qO- http://58adbe1e-sillyhome-next:8000/health
```