v0.14.4

docs/API.md

@@ -1,6 +1,6 @@
 # GREE Controller API reference
 
-HTTP and WebSocket API for GREE Controller **0.14.2**.
+HTTP and WebSocket API for GREE Controller **0.14.4**.
 
 [← Main documentation](../README.md)
 
@@ -196,7 +196,7 @@ Common statuses:
 | GET/PUT | `/api/settings/debug` | Debug overlay/GREE frame settings. |
 | GET | `/api/configuration/export` | Export full application configuration. |
 | POST | `/api/configuration/import` | Import/replace application configuration. |
-| POST | `/api/integrations/home-assistant/test` | Test HA temperature read. |
+| POST | `/api/integrations/home-assistant/test` | Test HA server/API authentication without requiring an entity. |
 | POST | `/api/integrations/home-assistant/entity` | Read raw HA entity state/attributes for shared Flow input diagnostics. |
 | POST | `/api/integrations/notifications/test` | Send a test notification. |
 
@@ -232,7 +232,7 @@ Response:
 {
   "status": "ok",
   "name": "gree-controller",
-  "version": "0.14.2",
+  "version": "0.14.4",
   "uptime_seconds": 1234,
   "control_ready": true,
   "time": "2026-08-30T06:54:00Z"
@@ -283,7 +283,7 @@ Returns the initial Web UI snapshot:
       "max_fan_speed": 1, "force_quiet": true, "use_native_sleep": true
     },
     "home_assistant": {
-      "url": "", "token_configured": false, "default_entity_id": "",
+      "url": "", "token_configured": false,
       "outdoor_entity_id": "", "sensor_stale_after_seconds": 300,
       "allow_invalid_tls": false, "sensor_aliases": {}, "flow_inputs": [],
       "outdoor_assist_enabled": true
@@ -295,7 +295,7 @@ Returns the initial Web UI snapshot:
   "control_plan": {"generated_at": "2026-09-04T08:00:00Z", "zones": [], "rules": []},
   "control_plan_revision": 42,
   "system": {
-    "version": "0.14.2",
+    "version": "0.14.4",
     "uptime_seconds": 1234,
     "auth_required": false,
     "control_ready": true,
@@ -523,6 +523,7 @@ When the physical device belongs to a disabled thermostat zone, direct web/API c
   "smart_fan": true,
   "sensor_source": "combined",
   "ha_entity_id": "sensor.living_room_temperature",
+  "ha_outdoor_entity_id": "sensor.garden_temperature",
   "external_sensor_weight": 0.4,
   "max_sensor_difference": 3.0,
   "sensor_stale_after_seconds": 300,
@@ -540,6 +541,8 @@ Important rules:
 - `separate_hysteresis`: when `true`, cooling uses `cool_hysteresis` and heating uses `heat_hysteresis`; both use the same `0.1..5.0` °C range.
 - `standby_offset_c`: bounded thermostat offset.
 - `sensor_source`: `device`, `home_assistant` or `combined`.
+- for `home_assistant`/`combined`, `ha_entity_id` is the required Home Assistant room-temperature sensor for that zone.
+- `ha_outdoor_entity_id` is optional; when empty, the zone uses global Home Assistant `outdoor_entity_id`, and when set it overrides the outdoor-temperature source only for that zone. If the override is unavailable, the global outdoor source is used.
 - `external_sensor_weight`: `0..1`.
 - `revision` is used for optimistic concurrency where supplied; stale updates can return `409`.
 
@@ -1182,7 +1185,6 @@ Times must use `HH:MM`; maximum fan speed is clamped to `1..5`.
 {
   "url": "http://homeassistant.local:8123",
   "token_configured": true,
-  "default_entity_id": "sensor.room_temperature",
   "outdoor_entity_id": "sensor.outdoor_temperature",
   "sensor_stale_after_seconds": 300,
   "allow_invalid_tls": false,
@@ -1194,7 +1196,7 @@ Times must use `HH:MM`; maximum fan speed is clamped to `1..5`.
 }
 ```
 
-`PUT` replaces `token_configured` with optional `token`. Omitted/`null` token preserves the saved token; an explicit empty string clears it. Sensor age is clamped to `30..86400` seconds. URLs, aliases, entity IDs and shared Flow inputs are normalized/validated before persistence. Shared inputs are value sources only; comparison operators and thresholds belong to Flow nodes.
+`PUT` replaces `token_configured` with optional `token`. Omitted/`null` token preserves the saved token; an explicit empty string clears it. `outdoor_entity_id` is the optional global Home Assistant outdoor-temperature sensor. Each zone can set `ha_outdoor_entity_id` to override that source only for the zone; a blank override uses the global sensor. Home Assistant room-temperature sensors remain configured per zone with `ha_entity_id` when `sensor_source` is `home_assistant` or `combined`. Sensor age is clamped to `30..86400` seconds. URLs, aliases, entity IDs and shared Flow inputs are normalized/validated before persistence. Global/per-zone outdoor sensors and per-zone room sensors are exposed through the normal alias and sensor-history/metric surfaces, and the Web UI offers them as suggestions in Flow Home Assistant entity fields. Shared inputs are value sources only; comparison operators and thresholds belong to Flow nodes. The Home Assistant connection test validates only the server/API token and requires no entity.
 
 ### `/api/settings/debug`
 
@@ -1266,19 +1268,11 @@ Response:
 
 ### `POST /api/integrations/home-assistant/test`
 
-```json
-{
-  "entity_id": "sensor.room_temperature"
-}
-```
-
-`entity_id` is optional; controller defaults/aliases are resolved. Response:
+No request body is required. The endpoint validates the configured Home Assistant URL and access token against the Home Assistant API root; it does not read or require any entity. Response:
 
 ```json
 {
-  "ok": true,
-  "temperature_c": 23.4,
-  "entity_id": "sensor.room_temperature"
+  "ok": true
 }
 ```