v0.9.11

docs/API.md

@@ -1,6 +1,6 @@
 # GREE Controller API reference
 
-HTTP and WebSocket API for GREE Controller **0.9.9**.
+HTTP and WebSocket API for GREE Controller **0.9.11**.
 
 [← Main documentation](../README.md)
 
@@ -179,6 +179,7 @@ Common statuses:
 | GET | `/api/debug` | Read debug overlay settings. |
 | PUT | `/api/debug` | Update debug overlay settings. |
 | POST | `/api/integrations/home-assistant/test` | Test HA temperature read. |
+| 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. |
 
 ### Access tokens and restricted Home Assistant API
@@ -212,7 +213,7 @@ Response:
 {
   "status": "ok",
   "name": "gree-controller",
-  "version": "0.9.9",
+  "version": "0.9.11",
   "uptime_seconds": 1234,
   "control_ready": true,
   "time": "2026-08-30T06:54:00Z"
@@ -236,7 +237,7 @@ Returns the initial Web UI snapshot:
   "settings": {},
   "outdoor_temperature": null,
   "system": {
-    "version": "0.9.9",
+    "version": "0.9.11",
     "uptime_seconds": 1234,
     "auth_required": false,
     "control_ready": true,
@@ -1201,6 +1202,30 @@ The Web UI can display **All**, **Requests** or **GREE** subsets.
 }
 ```
 
+### `POST /api/integrations/home-assistant/entity`
+
+Reads the current raw Home Assistant entity document used by the shared-Flow-input diagnostics UI.
+
+```json
+{
+  "entity_id": "climate.gas_boiler"
+}
+```
+
+Response includes the raw state, availability, attributes and timestamps:
+
+```json
+{
+  "ok": true,
+  "entity_id": "climate.gas_boiler",
+  "state": "heat",
+  "available": true,
+  "attributes": { "hvac_action": "heating" },
+  "last_changed": "2026-09-02T06:30:00Z",
+  "last_updated": "2026-09-02T06:30:05Z"
+}
+```
+
 ### `POST /api/integrations/notifications/test`
 
 Accepts a `NotificationSettings` object. Blank secret/webhook fields reuse saved secrets for the test.
@@ -1512,4 +1537,4 @@ Cancellation suppresses the same pending intent until a new explicit thermostat/
 
 Existing Flow updates require `expected_revision`. A mismatched revision returns HTTP 409 to prevent stale editor tabs from overwriting newer graphs. Source Flow plus generated outputs are replaced atomically in one database transaction while configuration/automation/schedule/thermostat-cycle operations are serialized.
 
-Additional Flow condition blocks are `house_mode`, `device_state`, `zone_state`, `group_state`, `night_mode`, `ha_attribute`, `ha_available`, `constant` and `shared_input`, alongside weekday/time/date, temperature, Home Assistant state/numeric and AND/OR/NOT blocks. `device_state` can inspect enabled/online/power/mode/fan/swing/quiet/turbo/light/air/xfan/health/sleep state. The editor ships 37 categorized editable templates covering comfort, energy, safety, night, reliability, Home Assistant heat-source coordination and advanced multi-branch logic.
+Additional Flow condition blocks are `house_mode`, `device_state`, `zone_state`, `group_state`, `night_mode`, `ha_attribute`, `ha_available`, `constant` and `shared_input`, alongside weekday/time/date, temperature, Home Assistant state/numeric and AND/OR/NOT blocks. `device_state` can inspect enabled/online/power/mode/fan/swing/quiet/turbo/light/air/xfan/health/sleep state. The editor ships 37 categorized editable templates covering comfort, energy, safety, night, reliability, Home Assistant heat-source coordination and advanced multi-branch logic. The template UI adds search, favorites/recent history, a graph preview and runtime requirement checks; shared inputs expose usage links and HA-backed inputs can be tested against live entity state.

docs/FLOW.md

@@ -63,7 +63,9 @@ Actions include thermostat zone, GREE device and climate group. Direct GREE acti
 
 ## Built-in presets
 
-The editor ships 37 editable presets grouped into seven categories: Comfort, Energy & cost, Protection & safety, Night, Reliability, Home Assistant / heat sources and Advanced. The library includes workday/weekend comfort, weather-aware demand, morning boost, presence and energy-price eco modes, peak-power limiting, open-window/humidity/overheat/frost guards, night profiles, sensor/device resilience, dual heating/cooling thresholds, multi-room group control, nested AND/OR/NOT Home Assistant scenarios, and gas-boiler/external-heat-source coordination including off, reduced-target, boost and fallback heating patterns.
+The editor ships 37 editable presets grouped into seven categories: Comfort, Energy & cost, Protection & safety, Night, Reliability, Home Assistant / heat sources and Advanced. The library UI also provides search, Favorites, Recent, a mini graph preview and requirement checks before applying a preset. The library includes workday/weekend comfort, weather-aware demand, morning boost, presence and energy-price eco modes, peak-power limiting, open-window/humidity/overheat/frost guards, night profiles, sensor/device resilience, dual heating/cooling thresholds, multi-room group control, nested AND/OR/NOT Home Assistant scenarios, and gas-boiler/external-heat-source coordination including off, reduced-target, boost and fallback heating patterns.
+
+Shared Flow inputs show the Flows that reference them and link directly to those editors. Home Assistant-backed shared inputs can be tested live in the input modal, including the current raw value/attribute and the resulting TRUE/FALSE condition.
 
 Presets are data files, not JavaScript definitions. Every preset lives in `presets/<id>.json` and contains `id`, `category`, localized `name`, localized `description`, and the complete `flow` graph (`nodes` + `edges`). `build.rs` validates and embeds the directory, exposes `/presets/index.json` plus `/presets/<file>.json`, and the Flow editor loads that library dynamically. Device/zone/group placeholders such as `$zone1`, `$zone2`, `$device1` and `$group1` are resolved when a preset is applied. Adding a preset therefore does not require adding graph-building code to `web/js/flows.js`.