v0.9.0

docs/API.md

@@ -1,6 +1,6 @@
 # GREE Controller API reference
 
-HTTP and WebSocket API for GREE Controller **0.8.24**.
+HTTP and WebSocket API for GREE Controller **0.9.0**.
 
 [← Main documentation](../README.md)
 
@@ -212,7 +212,7 @@ Response:
 {
   "status": "ok",
   "name": "gree-controller",
-  "version": "0.8.24",
+  "version": "0.9.0",
   "uptime_seconds": 1234,
   "control_ready": true,
   "time": "2026-08-30T06:54:00Z"
@@ -236,7 +236,7 @@ Returns the initial Web UI snapshot:
   "settings": {},
   "outdoor_temperature": null,
   "system": {
-    "version": "0.8.24",
+    "version": "0.9.0",
     "uptime_seconds": 1234,
     "auth_required": false,
     "control_ready": true,
@@ -1479,3 +1479,13 @@ Use that token:
 curl -H 'Authorization: Bearer gree_controller_RESTRICTED_TOKEN' \
   "$BASE/api/integrations/home-assistant/control-plan"
 ```
+
+
+## Compressor protection queue
+
+Runtime settings expose `compressor_protection_enabled` and `compressor_protection_seconds` (30–1800; default 180). While enabled, thermostat starts and Heat/Cool reversals that fall inside the protection window are represented on the owning zone by `compressor_pending_action`, `compressor_pending_since`, and `compressor_pending_until`.
+
+- `POST /api/zones/:id/compressor-queue/cancel` cancels the currently pending compressor-protection task for one thermostat.
+- `POST /api/compressor-queue/cancel-all` cancels all currently pending compressor-protection tasks.
+
+Cancellation suppresses the same pending intent until a new explicit thermostat/group/house command re-arms it, a scheduled Temporary Quick Thermostat session takes ownership, or a different mode/target creates a new intent. Safety OFF commands are not delayed by compressor protection. Direct technical device commands remain immediate manual-control operations.