BEHAVIOR-001: learn and predict actuator actions

docs/ml_api.md

@@ -178,9 +178,10 @@ Listet unterstützte Aktuatoren mit angereicherter HA-Metadatenbasis.
 
 ### `POST /v1/actuators`
 
-Registriert einen Aktuator, ermittelt passende numerische Sensoren und
-Kontext-Entities, trainiert bei ausreichender History automatisch ein Modell und
-liefert Zuordnung, Confidence, Evidenz und Lifecycle-Status zurück.
+Registriert einen Aktor. Das System ermittelt passende Messwerte und
+Kontext-Entities vollständig automatisch, trainiert bei ausreichender Historie
+ein Modell und liefert Zuordnung, Confidence, Evidenz und Lifecycle-Status zur
+Diagnose zurück.
 
 **Request**
 ```json
@@ -190,21 +191,31 @@ liefert Zuordnung, Confidence, Evidenz und Lifecycle-Status zurück.
 }
 ```
 
-### `POST /v1/actuators/{actuator_entity_id}/override`
-
-Persistiert manuelle Overrides. Diese haben Vorrang vor der automatischen
-Heuristik und überstehen Neustarts.
-
 ### `POST /v1/actuators/reconciliation/run`
 
 Führt eine sichere globale Reconciliation aus. Die periodische Add-on-Schleife
 ruft denselben idempotenten Ablauf auf, startet aber keine Services in Home
 Assistant.
 
+### `POST /v1/actuators/{actuator_entity_id}/evaluate`
+
+Erstellt aus aktuellem Kontext eine neue Shadow- oder Aktiv-Vorhersage. Im
+Shadow-Modus wird niemals geschaltet.
+
+### `POST /v1/actuators/{actuator_entity_id}/activation`
+
+```json
+{"active": true}
+```
+
+Aktiviert autonomes Schalten erst nach ausreichendem Training und nur für
+erlaubte Aktor-Domains. Mit `false` wird der Aktor sofort wieder in den
+Shadow-Modus versetzt.
+
 ## Betrieb
 
-Die produktive App lädt Artefakte aus `SILLYHOME_MODEL_STORE`. Aktuator-,
-Override- und Reconciliation-Zustände liegen atomisch in
+Die produktive App lädt Artefakte aus `SILLYHOME_MODEL_STORE`. Aktor- und
+Reconciliation-Zustände liegen atomisch in
 `SILLYHOME_ACTUATOR_STORE`. Neue Artefakte werden über `/ml/retrain`,
 `RetrainingService` oder den aktor-zentrierten Lifecycle registriert. Die API
 sollte nur in einem vertrauenswürdigen Netz oder hinter einem