Redesign POINTTAPI Boost controls and installation settings (#34)

* Redesign POINTTAPI Boost and installation settings

* Translate POINTTAPI Boost climate preset

* Translate Boost climate preset states

* Cover native Boost restart handling

* Address PR #34 review comments: serialize boost locks, unique_id migration, decouple platforms, and update docs

---------

Co-authored-by: Casey Romkes <mail@casey.berlin>

Author: jfhautenauven

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to this Bosch Home Assistant custom component will be documented in this file.
 
+## [Unreleased]
+
+### Added
+- **Native-first Boost controls** — Redesigned POINTTAPI Boost controls with dedicated per-zone switches (`switch.*_boost`), serialized multi-zone activation via `asyncio.Lock` to prevent race conditions on rapid toggles, and integration into climate preset modes (`boost` / `none`) across all locales (#34).
+- **Dedicated Heating Circuit (`hc1`) device partition** — Moved circuit-level heating settings away from individual room thermostat devices to a dedicated **Heating Installation** (`/heatingCircuits/hc1`) device to accurately reflect hardware topology.
+  - **Before:** Global circuit settings (e.g. supply limits, heating slope, boost duration/temperature) were incorrectly attached to the `zn1` room device (Zone 1 / Thermostat), duplicating or misattributing installation-wide properties.
+  - **After:** Supply limits (`supplyTemperatureLimitMax`, `supplyTemperatureLimitMin`), heating dynamics (`heatupCoolingSlope`, `buildingHeatup`), and global Boost settings (`boostTemperature`, `boostDuration`, `boostRemainingTime`) are properly assigned to the Heating Circuit (`/heatingCircuits/hc1`) device, ensuring clean device separation in Home Assistant (#34).
+
+### Changed
+- **Read-only number paths** — Number entities for POINTTAPI resources that are read-only (`writeable: 0` or `False`) are now hidden/unavailable, ensuring number entities only represent interactive setpoints and controls (#34).
+
 ## [1.5.1-beta.1] — 2026-08-31
 
 ### Fixed

custom_components/bosch/__init__.py

@@ -296,44 +296,63 @@ async def async_update_options(hass: HomeAssistant, entry: ConfigEntry):
 
 
 async def async_migrate_entry(hass: HomeAssistant, entry: ConfigEntry) -> bool:
-    """Migrate POINTTAPI entity_ids from v0.30.x to v0.31.0 device-partition scheme.
+    """Migrate POINTTAPI entry versions.
 
-    Idempotent: returns True immediately on already-migrated entries.
-    Fault-tolerant: per-rename try/except so one failure doesn't abort the batch.
-    Bumps entry.version 1 → 2 after all renames are attempted.
+    - v1 -> v2: entity_id renames (device-partition scheme)
+    - v2 -> v3: unique_id rename for boost switch (per-zone unique_id)
     """
-    if entry.version >= 2:
-        return True
-    if entry.data.get(CONF_PROTOCOL) != POINTTAPI:
-        hass.config_entries.async_update_entry(entry, version=2)
+    if entry.version >= 3:
         return True
 
-    from homeassistant.helpers import entity_registry as er
-    registry = er.async_get(hass)
-    renames = {
-        # solar_solar_* doubled prefix cleanup
-        "sensor.solar_solar_collector_temperature": "sensor.solar_collector_temperature",
-        "sensor.solar_solar_storage_temperature": "sensor.solar_storage_temperature",
-        "sensor.solar_solar_pump_modulation": "sensor.solar_pump_modulation",
-        "sensor.solar_total_solar_gain": "sensor.solar_total_gain",
-        # water_heater rename
-        "water_heater.water_heater": "water_heater.hot_water_tank",
-    }
-    renamed = 0
-    for old_id, new_id in renames.items():
-        try:
-            if registry.async_get(old_id) and not registry.async_get(new_id):
-                registry.async_update_entity(old_id, new_entity_id=new_id)
-                renamed += 1
-        except Exception as err:  # pylint: disable=broad-except
-            _LOGGER.warning(
-                "Migration could not rename %s -> %s: %s", old_id, new_id, err
+    if entry.version < 2:
+        if entry.data.get(CONF_PROTOCOL) == POINTTAPI:
+            from homeassistant.helpers import entity_registry as er
+            registry = er.async_get(hass)
+            renames = {
+                # solar_solar_* doubled prefix cleanup
+                "sensor.solar_solar_collector_temperature": "sensor.solar_collector_temperature",
+                "sensor.solar_solar_storage_temperature": "sensor.solar_storage_temperature",
+                "sensor.solar_solar_pump_modulation": "sensor.solar_pump_modulation",
+                "sensor.solar_total_solar_gain": "sensor.solar_total_gain",
+                # water_heater rename
+                "water_heater.water_heater": "water_heater.hot_water_tank",
+            }
+            renamed = 0
+            for old_id, new_id in renames.items():
+                try:
+                    if registry.async_get(old_id) and not registry.async_get(new_id):
+                        registry.async_update_entity(old_id, new_entity_id=new_id)
+                        renamed += 1
+                except Exception as err:  # pylint: disable=broad-except
+                    _LOGGER.warning(
+                        "Migration could not rename %s -> %s: %s", old_id, new_id, err
+                    )
+            _LOGGER.info(
+                "Migrated POINTTAPI entry from version 1 to 2 (%d entity_ids renamed)",
+                renamed,
             )
-    hass.config_entries.async_update_entry(entry, version=2)
-    _LOGGER.info(
-        "Migrated POINTTAPI entry from version 1 to 2 (%d entity_ids renamed)",
-        renamed,
-    )
+        hass.config_entries.async_update_entry(entry, version=2)
+
+    if entry.version < 3:
+        if entry.data.get(CONF_PROTOCOL) == POINTTAPI:
+            from homeassistant.helpers import entity_registry as er
+            registry = er.async_get(hass)
+            old_unique_id = f"{entry.entry_id}_pointtapi_boost"
+            new_unique_id = f"{entry.entry_id}_pointtapi_boost_zone_1"
+            try:
+                entity_id = registry.async_get_entity_id("switch", DOMAIN, old_unique_id)
+                if entity_id:
+                    registry.async_update_entity(entity_id, new_unique_id=new_unique_id)
+                    _LOGGER.info(
+                        "Migrated POINTTAPI boost switch unique_id %s -> %s for entity %s",
+                        old_unique_id, new_unique_id, entity_id,
+                    )
+            except Exception as err:  # pylint: disable=broad-except
+                _LOGGER.warning(
+                    "Migration could not update unique_id %s: %s", old_unique_id, err
+                )
+        hass.config_entries.async_update_entry(entry, version=3)
+
     return True