fix(climate): write mode-correct setpoints and stop REST reverting live state

Two independent bugs made a second change (e.g. adjusting the target
temperature right after switching cool -> heat) fail to take, and made
Home Assistant settle back on a previous state while DKN Cloud NA showed
the correct one.

Wrong setpoint key on write:

_writable_temperature_property_for_mode() ignored its hvac_mode argument
and resolved the key from real_mode/mode in the cached device payload.
That payload still describes the pre-change state, so a heat setpoint was
emitted as setpoint_air_cool: the unit switched to heat but the heat
setpoint never moved. The same defect broke AUTO in steady state, where
real_mode=cool made the write target setpoint_air_cool while the read
used setpoint_air_auto, so the value could never appear to change.

target_temperature() and writable_target_temperature_key() now accept the
mode the caller intends, and that mode takes priority over anything in the
device payload. Device-reported modes remain a fallback only for payloads
that do not expose the requested mode's setpoint.

async_set_temperature() no longer re-sends power+mode; async_set_hvac_mode()
already sent them, and the stale-cache condition guarding the resend was
always true. It now waits (bounded) for the cloud to echo the mode before
sending the setpoint, matching the ensure_mode ordering the smoke test uses.

REST snapshot reverting live state:

The coordinator merged {**existing, **device}, letting the lagging REST
/installations snapshot win over live Socket.IO pushes. Once the socket
confirmed a write, _reconcile_optimistic dropped the overlay, leaving
nothing to stop the next poll from reverting the state.

Socket-pushed values are now tracked per device and applied after the REST
payload. They are discarded when the socket session changes, since updates
may have been missed while it was down and REST becomes authoritative again.

Also report hvac_action and target_temperature against the effective
(optimistic-aware) mode so the action cannot contradict the reported mode
while a change propagates.

Co-authored-by: anthropic/claude-opus-5

custom_components/dkncloudna/coordinator.py

@@ -44,6 +44,11 @@ class DknCoordinator(DataUpdateCoordinator[dict[str, dict[str, Any]]]):
         self.client = client
         self._entry = entry
         self.entry_id = entry.entry_id
+        # Values pushed over Socket.IO during the current socket session, keyed
+        # by mac. The REST /installations snapshot can lag behind reality, so
+        # these take precedence over it until the socket reconnects.
+        self._live_state: dict[str, dict[str, Any]] = {}
+        self._live_state_session: int = 0
 
     async def _async_update_data(self) -> dict[str, dict[str, Any]]:
         """Fetch all installations and flatten into {mac: device_dict}."""
@@ -65,6 +70,7 @@ class DknCoordinator(DataUpdateCoordinator[dict[str, dict[str, Any]]]):
             raise UpdateFailed(f"Unexpected error: {type(err).__name__}") from err
 
         self._persist_tokens_if_changed()
+        self._discard_stale_live_state()
 
         devices: dict[str, dict[str, Any]] = {}
         existing = self.data or {}
@@ -77,11 +83,27 @@ class DknCoordinator(DataUpdateCoordinator[dict[str, dict[str, Any]]]):
                 devices[mac] = {
                     **existing.get(mac, {}),
                     **device,
+                    # Socket.IO pushes are the live source of truth; the REST
+                    # snapshot is frequently a few minutes behind and would
+                    # otherwise revert state the socket already reported.
+                    **self._live_state.get(mac, {}),
                     "_installation_id": inst_id,
                 }
 
         return devices
 
+    def _discard_stale_live_state(self) -> None:
+        """Drop accumulated live state when the socket session has changed.
+
+        A new socket session means updates may have been missed while it was
+        down, so the REST snapshot becomes authoritative again until fresh
+        pushes arrive.
+        """
+        session = self.client.socket_session
+        if session != self._live_state_session:
+            self._live_state_session = session
+            self._live_state = {}
+
     def _persist_tokens_if_changed(self) -> None:
         """Save refreshed tokens back to the config entry so they survive restarts."""
         opts = self._entry.options
@@ -105,6 +127,8 @@ class DknCoordinator(DataUpdateCoordinator[dict[str, dict[str, Any]]]):
         self, mac: str, data: dict[str, Any]
     ) -> None:
         """Merge live device-data from Socket.IO into coordinator state."""
+        self._discard_stale_live_state()
+        self._live_state[mac] = {**self._live_state.get(mac, {}), **data}
         current = dict(self.data or {})
         current[mac] = {**current.get(mac, {}), **data}
         self.async_set_updated_data(current)