# SillyHome Next v1.7.0 Operating Guide

v1.7.0 erweitert den Produktivbetrieb um Diagnose, Backup, Dry-run und
Planungshilfen.

## Diagnose

- Jede Auswertung speichert eine kompakte `decision_timeline` am Aktor.
- Event-basierte Auswertungen speichern zusaetzlich `latency_measurements`.
- Die Timeline beantwortet: was war der Ausloeser, welches Ziel wurde
  vorhergesagt, wurde geschaltet oder blockiert, und warum.

## Backup und Restore

- `GET /v1/actuators/backup/export` exportiert Aktoren, Reconciliation-Status
  und Job-Historie als JSON.
- `POST /v1/actuators/backup/restore` spielt diesen Stand wieder ein.
- Ohne `replace_existing=true` werden vorhandene Aktoren nicht ueberschrieben.

## Dry-run

- `POST /v1/actuators/{entity_id}/dry-run` aktiviert oder beendet den Testmodus.
- Im Dry-run werden freigegebene Aktionen bewertet und protokolliert, aber nicht
  an Home Assistant gesendet.

## Feedback

Feedback akzeptiert neben `correct`/`expected_state` nun optionale Typen:

- `correct`
- `wrong`
- `too_early`
- `too_late`
- `never_automate`

`never_automate` setzt eine manuelle Sicherheitssperre am Aktor.

## Planung

`POST /v1/actuators/planning/refresh` berechnet lokale Hinweise:

- Aktorgruppen aus gemeinsamen Raum-/Kontextdaten
- einfache Szenenvorschlaege aus gemeinsamem Kontextverhalten
- Agent-Insights fuer Konflikte, Latenz und auffaelliges Feedback