v0.13.5

Cargo.lock

@@ -700,7 +700,7 @@ dependencies = [
 
 [[package]]
 name = "gree-controller"
-version = "0.13.4"
+version = "0.13.5"
 dependencies = [
  "aes",
  "aes-gcm",

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "gree-controller"
-version = "0.13.4"
+version = "0.13.5"
 edition = "2021"
 authors = ["GREE Controller contributors"]
 description = "Standalone local GREE HVAC controller with Web UI, SQLite and Home Assistant sensor support"

FILE_MANIFEST.sha256

@@ -1,13 +1,13 @@
 d67af429e4da9ce08e9d2f2a8472849ffbd70d135b1c5da535a076026794d04c  ./.env.example
 a4ec3874a2e3ab1bad28fb40bb620f7b01f64d01ad9b699306bf70ada31227db  ./.gitignore
-5827ea491858a5148407964f10d6570c3e9a7edfcf46d92053fc881b5bb87cc1  ./Cargo.lock
+b0270ac12ff6e0a9c8ab4325065ddd36eb7d432dc8f59293dd86591d4fa02015  ./Cargo.lock
-80b75728418ff0b6089b5eb46ad1acaf7a9bb20ca000a8027aeed5b56e11078f  ./Cargo.toml
+d6ba6362369bfa0fedab8e95bf0fe2839270dbb8a9f4c13a78bddb5450262a55  ./Cargo.toml
 19b2943504acb8f8de280f873a8dbec4bb6ebbe3870b158f5655d4fb8c298f5f  ./LICENSE
-43b365c82085970f78e8bce11cdfc8e12802b04e0ab5bb69116c38f49c41e025  ./README.md
+4c529802f159c34cab82585a537d6c193940d8ddbd14a07076bd13ba2d9fcf54  ./README.md
 d56cfff4179a6511aa764a91c6ddebe21fcd35f36b7298e62d012e11f62bfeb9  ./build.rs
-714f6a2e2ef8fb9e7541334ee3709983e0b7db736dfb8be10d40fa65e59275ef  ./docs/API.md
+237eab440e33eb7f88173a143112b90c4343d9272720068640e289d63220d415  ./docs/API.md
 2e1e18fd8167dabfe2469c26e85cce62486c7cb6a502c63c6f6b0cd74d5885e0  ./docs/FLOW.md
-304267d029ba6df73d1877be3c390709f35028a63c56e7265871df93b1889a4c  ./docs/openapi.json
+4e747f2e3e2cbe7d20b0da76556035d7bc4bd80f789f61522e1a214c56f5c35c  ./docs/openapi.json
 b11e581dd916676e24402112fe6896bc681abf3c94cafc85c4d3ded3f3a272a3  ./home-assistant/README.md
 f8e8559fe10fe523ac5bc9aac25c6e26e862f679d502e8f3c39f38a0a8e40911  ./home-assistant/custom_components/gree_controller/__init__.py
 3f6ef15ef58456376ac53fde7cace1ef359d6a6f7a64c5b575ad77ea6e55ccc4  ./home-assistant/custom_components/gree_controller/api.py
@@ -18,7 +18,7 @@ b7f0873109c52be9d7f09bea3dffc416103c50085e1f0680d11661a969479898  ./home-assista
 5a96fe8f5c035c34f1339370270cd078056202d09e236dec75735be11de92a7d  ./home-assistant/custom_components/gree_controller/entity_map.py
 c4fb75c246db651087900ebfc2291ff41ac87652cd6194fc0b776b0005c1cbcf  ./home-assistant/custom_components/gree_controller/icon.png
 c4fb75c246db651087900ebfc2291ff41ac87652cd6194fc0b776b0005c1cbcf  ./home-assistant/custom_components/gree_controller/logo.png
-5006c0d96baf0760780861ead24125579b6cef719dc217ffd51e60bde06da9a9  ./home-assistant/custom_components/gree_controller/manifest.json
+aa1384a3152f133bd2d4f9cabe0118820d68936d43c05b2ef8af9e51e955d000  ./home-assistant/custom_components/gree_controller/manifest.json
 38d659d0273c0d1428679e44574a2666c605d1b3796d323b626baa40560788cf  ./home-assistant/custom_components/gree_controller/number.py
 39c4309001b75abb56234f05662bc06e077054986876f1927937edbce528ec95  ./home-assistant/custom_components/gree_controller/select.py
 cca65482e36d48035aca178121a378fe7d578d600acff267ae81a6399c0da653  ./home-assistant/custom_components/gree_controller/sensor.py
@@ -27,8 +27,8 @@ cca65482e36d48035aca178121a378fe7d578d600acff267ae81a6399c0da653  ./home-assista
 13f30e2dcdcedbd1b6c3f99c2335e0487108fd72c8e86922368b84f2fa2038ae  ./home-assistant/custom_components/gree_controller/translations/pl.json
 c5fc5c87273d82d2834a0a5a365c821a416413ed509613441e24e4dc3507c4d2  ./home-assistant/generated/gree_controller_entities.example.json
 253a0bc912786e67ea7fc92a64e4a510ad973bec343a88ccfb1f28fca3e8cf01  ./lang/README.md
-48660321f53b5ff4f1fefef1423dde85ba43e1ea33421b9dad24d487df73c03a  ./lang/en.json
+3aab93e8f7a6d082c0739d2cd9d3ffed4c9706933576e63e18387f7f336eaa7b  ./lang/en.json
-b0773fb211fccb037b170c70b1f655a3852dc582050dc1f726d79e132a277199  ./lang/pl.json
+468cc1dc4bbb7b98cb91d2bfe1d72e39d2e3aa57aef8ba3477d4718cd3ce9ec8  ./lang/pl.json
 d8459024f04ca514bd8e9d6bd3af872fb942fd85a7cdd5583f4a9d28aab6faba  ./make_zip.py
 b14233a8987e53bbbdd6770386ba10fa166ec25c1e098275c173c544b37846fc  ./presets/bedroom_window_night.json
 1960841119c0b673fb2f03621b32237552fd828045304cd221401214b997c910  ./presets/device_resilience.json
@@ -69,7 +69,7 @@ fdcd9a5055d08037278b842e7ab69265345c5811f0a06867136c511d140bb191  ./presets/wind
 804f22123cd3e8db0fac791826c8dd9f758fb866c8e3b5655fb6d25d259dccf1  ./presets/workday_comfort.json
 01952aa92b217f8eae2493b88870e2dec595100cd15c4d561ff11ae2b936c46f  ./regenerate-sha.sh
 c64b1c6deeb24f20af662bfce7fa3683703914987241107ce664fa2f6d1a9dcb  ./scripts/README.md
-a2424afcc056255a85769086ddbf1b8038b58015c2e4b9bef862ed8a7ede5340  ./scripts/api_dev_test.py
+a937b937c8ac39d9b01e791b405f9c996314f5a563946bae94c3cbbefecc3411  ./scripts/api_dev_test.py
 5bc736c7bc76ca80aaa406bb171d2aa91baf4c3aa8695dce0e09b888b6ab3146  ./scripts/common.sh
 6403786610ee6d2f628193c25aee0dd058d62e904aa1a31d5f62fdaae0e94b4f  ./scripts/configure-gree-network.sh
 1d6e14e26e49aa9d3527f30a23668bf8d9c48b67e6628ef686c3155c012155de  ./scripts/dev.sh
@@ -176,7 +176,7 @@ f13f1be3d5789539eba3fc1b59c14835f8c681eca7634e118fa3763a53aeee2b  ./src/queries/
 b92a6cb158b494fe145b43c7641e65f6fafff47201d7d76edbec2cfd8b94835c  ./systemd/gree-controller.service
 544a31cb2e5374227026afd6abd0d910381f3fca1638154ebd74e3c3d96a35d1  ./web/404.html
 e98bdd7204349cce1ec6f57283509697af0bbc72280622a6c3efa6fed242db4f  ./web/favicon.svg
-6be28fadaae2eacce9e6826a8b37e258dc48d8d101ae784ee332630614cb58cc  ./web/index.html
+07452e9323d68ffa706cfe29d070c9bca25f9dc61c6b23ac65ac2ac226cebede  ./web/index.html
 9ba3f6fa05b72aa989139b2a909982571b2a02055052e4c40104f1e81a9aa7eb  ./web/js/README.md
 45fb54541a117a8ee0dc484cd263b6af4aafab75d94d269b126bb603b5f0392c  ./web/js/bootstrap.js
 badde8a5214a0322b2c45803c02a1cb723d53b25e57c687369cd804f509d9744  ./web/js/charts.js

README.md

@@ -2,9 +2,9 @@
 
 Self-hosted controller for GREE-compatible air conditioners with a local Web UI, thermostat zones, schedules, Home Assistant integration, history, notifications and a documented HTTP/WebSocket API.
 
-**Current release: 0.13.4**
+**Current release: 0.13.5**
 
-Release 0.13.4 keeps the 0.13.x HTTP/WS contracts and clarifies disabled-zone manual control in the Web UI: thermostat controls remain visually active when zone automation is disabled, while an explicit notice explains that temporary/manual thermostat and direct manual control remain available. The 0.1 °C logical thermostat precision introduced in 0.13.3 is unchanged.
+Release 0.13.5 keeps the 0.13.x HTTP/WS contracts and makes disabled-zone semantics explicit in both thermostat controls and zone settings. Disabling a zone stops automation, while manual thermostat, temporary thermostat and direct manual control remain available. The 0.1 °C logical thermostat precision introduced in 0.13.3 is unchanged.
 
 > [Full API reference](docs/API.md) — authentication, every endpoint, request bodies, response models, WebSocket events and examples.
 

docs/API.md

@@ -1,6 +1,6 @@
 # GREE Controller API reference
 
-HTTP and WebSocket API for GREE Controller **0.13.4**.
+HTTP and WebSocket API for GREE Controller **0.13.5**.
 
 [← Main documentation](../README.md)
 
@@ -231,7 +231,7 @@ Response:
 {
   "status": "ok",
   "name": "gree-controller",
-  "version": "0.13.4",
+  "version": "0.13.5",
   "uptime_seconds": 1234,
   "control_ready": true,
   "time": "2026-08-30T06:54:00Z"
@@ -257,7 +257,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.13.4",
+    "version": "0.13.5",
     "uptime_seconds": 1234,
     "auth_required": false,
     "control_ready": true,
@@ -1465,6 +1465,8 @@ In `0.13.3`, logical thermostat targets use `0.1 °C` precision consistently. Te
 
 In `0.13.4`, disabled-zone thermostat controls remain visually active because explicit temporary/manual thermostat actions are still allowed while zone automation is disabled. The UI shows this distinction directly on the thermostat card; HTTP and WebSocket contracts are unchanged.
 
+In `0.13.5`, the same disabled-zone behavior is explained directly beside the zone enabled/disabled setting, so users see before changing it that disabling a zone stops automation but does not block manual thermostat, temporary thermostat or direct manual control. HTTP and WebSocket contracts remain unchanged.
+
 Additional engine/integration events may be introduced without changing the envelope.
 
 `api.request` data:

docs/openapi.json

@@ -2,9 +2,9 @@
   "openapi": "3.1.0",
   "info": {
     "title": "GREE Controller API",
-    "version": "0.13.4",
+    "version": "0.13.5",
     "summary": "Local HTTP/WebSocket API for GREE HVAC control",
-    "description": "Self-hosted API used by the GREE Controller Web UI and Home Assistant integration.\n\n### Authentication\nNormal administrator endpoints accept `Authorization: Bearer <APP_TOKEN>` or `x-api-token: <APP_TOKEN>` when `GREE_CONTROLLER_APP_TOKEN` is configured. If the app token is empty, those endpoints intentionally run in trusted-LAN mode without authentication.\n\nThe restricted `/api/integrations/home-assistant/*` control surface always requires either a generated access token or the administrator app token. Generated tokens do **not** grant normal administrator API access.\n\nIn Swagger UI use **Authorize** and enter the token in either the bearer field or `x-api-token` field.\n\n### Control ownership\nThermostat zones, groups, house rules, direct device control, schedules and visual Flows share an ownership/arbitration model. Prefer zone/group/house endpoints for thermostat intent; direct device commands are technical/manual control and can deliberately take ownership.\n\n### 0.12.0 breaking API\nRuntime settings are split into functional `/api/settings/*` resources. The former `/api/settings`, `/api/debug`, `/api/events/retention`, `/api/settings/export` and `/api/settings/import` endpoints were removed without compatibility aliases.\n\n### 0.13.0\n`control-plan` keeps its existing HTTP response shape but is materialized in memory and pushed to WebSocket clients as `control_plan.updated`; HTTP remains the fallback/resync path. A restricted Home Assistant snapshot endpoint combines devices, groups and the control plan.\n\n### 0.13.1\nRuntime WebSocket churn is reduced without changing contracts: no-op zone regulator heartbeats are deduplicated and device heartbeat polls only invalidate the materialized control plan when plan-relevant device state changes.\n\n### 0.13.2\nCompletes live WebSocket synchronization for entity creation, schedules, automations, configuration imports and runtime device/automation state while preserving the existing HTTP API contracts and control-plan fallback behavior.\n\n### 0.13.3\nLogical thermostat targets are normalized to 0.1 C consistently, including Temporary Quick Thermostat and thermostat-managed automation/Flow actions. The bundled Web UI accepts comma or dot decimal input for the temporary thermostat target; physical GREE setpoint rounding is unchanged.\n\n### 0.13.4\nDisabled-zone thermostat controls remain visually active in the bundled Web UI because explicit temporary/manual thermostat and direct manual control remain available while zone automation is disabled. HTTP and WebSocket contracts are unchanged.",
+    "description": "Self-hosted API used by the GREE Controller Web UI and Home Assistant integration.\n\n### Authentication\nNormal administrator endpoints accept `Authorization: Bearer <APP_TOKEN>` or `x-api-token: <APP_TOKEN>` when `GREE_CONTROLLER_APP_TOKEN` is configured. If the app token is empty, those endpoints intentionally run in trusted-LAN mode without authentication.\n\nThe restricted `/api/integrations/home-assistant/*` control surface always requires either a generated access token or the administrator app token. Generated tokens do **not** grant normal administrator API access.\n\nIn Swagger UI use **Authorize** and enter the token in either the bearer field or `x-api-token` field.\n\n### Control ownership\nThermostat zones, groups, house rules, direct device control, schedules and visual Flows share an ownership/arbitration model. Prefer zone/group/house endpoints for thermostat intent; direct device commands are technical/manual control and can deliberately take ownership.\n\n### 0.12.0 breaking API\nRuntime settings are split into functional `/api/settings/*` resources. The former `/api/settings`, `/api/debug`, `/api/events/retention`, `/api/settings/export` and `/api/settings/import` endpoints were removed without compatibility aliases.\n\n### 0.13.0\n`control-plan` keeps its existing HTTP response shape but is materialized in memory and pushed to WebSocket clients as `control_plan.updated`; HTTP remains the fallback/resync path. A restricted Home Assistant snapshot endpoint combines devices, groups and the control plan.\n\n### 0.13.1\nRuntime WebSocket churn is reduced without changing contracts: no-op zone regulator heartbeats are deduplicated and device heartbeat polls only invalidate the materialized control plan when plan-relevant device state changes.\n\n### 0.13.2\nCompletes live WebSocket synchronization for entity creation, schedules, automations, configuration imports and runtime device/automation state while preserving the existing HTTP API contracts and control-plan fallback behavior.\n\n### 0.13.3\nLogical thermostat targets are normalized to 0.1 C consistently, including Temporary Quick Thermostat and thermostat-managed automation/Flow actions. The bundled Web UI accepts comma or dot decimal input for the temporary thermostat target; physical GREE setpoint rounding is unchanged.\n\n### 0.13.4\nDisabled-zone thermostat controls remain visually active in the bundled Web UI because explicit temporary/manual thermostat and direct manual control remain available while zone automation is disabled. HTTP and WebSocket contracts are unchanged.\n\n### 0.13.5\nThe zone settings dialog now explains directly beside the enabled/disabled option that disabling a zone stops automation but does not block manual thermostat, temporary thermostat or direct manual control. HTTP and WebSocket contracts remain unchanged.",
     "license": {
       "name": "MIT"
     }
@@ -4891,7 +4891,7 @@
           },
           "version": {
             "type": "string",
-            "example": "0.13.4"
+            "example": "0.13.5"
           },
           "uptime_seconds": {
             "type": "integer",

home-assistant/custom_components/gree_controller/manifest.json

@@ -1,7 +1,7 @@
 {
   "domain": "gree_controller",
   "name": "GREE Controller",
-  "version": "0.13.4",
+  "version": "0.13.5",
   "config_flow": true,
   "integration_type": "hub",
   "iot_class": "local_polling",

lang/en.json

@@ -721,6 +721,7 @@
     "zones.temporaryInvalidUntil": "Enter a valid finish date and time",
     "zones.temporaryEndAfterStart": "The finish time must be after Quick Thermostat starts",
     "zones.automationToggleHint": "Enables or disables thermostat automation for this zone. This is not temporary control.",
+    "zones.enabledAutomationDescription": "Disabling the zone stops automation. Manual thermostat, temporary thermostat and direct manual control remain available.",
     "zones.disabledManualControlTitle": "Zone is disabled",
     "zones.disabledManualControlHint": "Zone automation is disabled. Temporary thermostat, manual thermostat and direct manual control remain available.",
     "dashboard.sections": "Dashboard sections",

lang/pl.json

@@ -721,6 +721,7 @@
     "zones.temporaryInvalidUntil": "Podaj prawidłową datę i godzinę zakończenia",
     "zones.temporaryEndAfterStart": "Czas zakończenia musi przypadać po uruchomieniu szybkiego termostatu",
     "zones.automationToggleHint": "Włącza lub wyłącza automatykę termostatu tej strefy. Nie jest to chwilowe sterowanie.",
+    "zones.enabledAutomationDescription": "Wyłączenie strefy zatrzymuje automatykę. Termostat ręczny, termostat czasowy i bezpośrednie sterowanie ręczne nadal działają.",
     "zones.disabledManualControlTitle": "Strefa jest wyłączona",
     "zones.disabledManualControlHint": "Automatyka strefy jest wyłączona. Termostat czasowy, termostat ręczny i bezpośrednie sterowanie ręczne nadal działają.",
     "dashboard.sections": "Sekcje pulpitu",

scripts/api_dev_test.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""Developer smoke/integration tests for GREE Controller API 0.13.4.
+"""Developer smoke/integration tests for GREE Controller API 0.13.5.
 
 Default mode is read-only and safe to run against a real controller.
 Use --settings-write to additionally round-trip all split settings resources and
@@ -26,7 +26,7 @@ from typing import Any, Callable, Iterable, Optional
 
 DEFAULT_BASE_URL = os.environ.get("GREE_API_URL", "http://127.0.0.1:8787")
 DEFAULT_TOKEN = os.environ.get("GREE_API_TOKEN", "")
-DEFAULT_EXPECTED_VERSION = "0.13.4"
+DEFAULT_EXPECTED_VERSION = "0.13.5"
 
 SETTINGS_PATHS: dict[str, set[str]] = {
     "/api/settings/application": {"simulator_enabled"},
@@ -519,7 +519,7 @@ def run_suite(args: argparse.Namespace) -> int:
     print(f"Settings write tests: {'ENABLED' if args.settings_write else 'disabled'}\n")
 
     runner.run("public health", lambda: test_health(client, args.expected_version))
-    runner.run("OpenAPI 0.13.4 contract", lambda: test_openapi(client, args.expected_version))
+    runner.run("OpenAPI 0.13.5 contract", lambda: test_openapi(client, args.expected_version))
     runner.run("protected API requires auth", lambda: test_protected_auth(client))
 
     for path in SAFE_GET_PATHS:
@@ -587,7 +587,7 @@ def run_suite(args: argparse.Namespace) -> int:
 
 def parse_args(argv: Optional[Iterable[str]] = None) -> argparse.Namespace:
     parser = argparse.ArgumentParser(
-        description="Developer smoke/integration tests for GREE Controller API 0.13.4.",
+        description="Developer smoke/integration tests for GREE Controller API 0.13.5.",
         formatter_class=argparse.RawDescriptionHelpFormatter,
         epilog="""Examples:
   python3 scripts/api_dev_test.py

web/index.html

@@ -1240,6 +1240,7 @@
         name="revision" value="">
       <label class="check"><input type="checkbox" name="enabled" checked> <span
           data-i18n="common.enabled">Enabled</span></label>
+      <p class="field-note" data-i18n="zones.enabledAutomationDescription">Disabling the zone stops automation. Manual thermostat, temporary thermostat and direct manual control remain available.</p>
       <div class="form-actions"><button type="button" class="secondary" data-close
           data-i18n="actions.cancel">Cancel</button><button class="primary" type="submit"
           data-i18n="actions.save">Save</button></div>