home-assistant-addons/hamh/CHANGELOG.md

2.0.19 (2026-02-14)

Bug Fixes

• #112: add auto-battery-mapping and batteryEntity support to server mode vacuum (a80c5b7), closes #112
• #164: split label filter into EntityLabel and DeviceLabel types (4a9f4fc), closes #164 #164
• broadcast bridge 'starting' status via WebSocket for all bridges (#160) (cd6f594)
• broadcast bridge status changes via WebSocket during startup (#160) (064de02)
• detect orphaned bridge state and clear resumption records for controller reconnection (f7cda0f), closes #105
• pass entityState to filter-preview for device_class support and update label docs with display name resolution (88aea83)
• prevent vacuum.send_command crash for Ecovacs/Deebot vacuums (#165) (47adc83)
• reduce MRP traffic and improve session recovery for Alexa (#105) (76aa5f6)
• resolve version 0.0.0-dev shown in UI for manual and workflow_dispatch builds (32e8f65)

Features

• add device_class filter type for entity filtering by HA device class attribute (395410f)
• add diagnostics dashboard with entity health indicators, battery levels, and auto-mapping info (11fbaa2)
• add edit/add filters button to bridge details FiltersCard (4de35e2)
• add ElectricalPowerMeasurement and ElectricalEnergyMeasurement clusters for switch/plug entities with auto-mapping (3e92cb6)
• add energy measurement clusters to light devices with auto-mapping support (cc42d56)
• add event domain support with GenericSwitch device for HA event.* entities (doorbells, buttons) (4c48365)
• add power/energy entity fields to EntityMappingDialog for manual configuration (c218f77)
• expand Filter Reference page with all filter types (7ec818b)
• resolve label display names to slugs in filter matching (0656494)

2.0.18 (2026-02-12)

Bug Fixes

• resolve version 0.0.0-dev shown in UI for manual and workflow_dispatch builds (63fa12f)

2.0.17 (2026-02-12)

Bug Fixes

• #103: remove OnOff from bridged vacuum to fix Apple Home Updating status (9fd7968)
• #105: use initiateForceClose for dead session cleanup instead of initiateClose (6394bf0)
• #108: move rockSupport/windSupport to .set() defaults - fixes Behaviors have errors (c0b547e)
• #108: set rockSupport/windSupport so controllers allow enabling oscillation and wind modes (d2235e4), closes #108
• #112: search full HA registry for battery/humidity entities, not filtered bridge entities (925b29a), closes #112
• #124: ensure onOff true->false transition for momentary scene/automation reset (3bf2c9c), closes #124
• #136: fix critical super binding bug in thermostat feature variants (1b86030)
• #136: use feature-specific thermostat bases for Alexa compatibility (59c1fca), closes #136
• #137: add debug logging to HumidityMeasurementServer for Alexa humidity diagnosis (2db6106), closes #137
• #137: set thermostat limits before setpoints to support negative temperatures (dd95a97), closes #137
• #141: limit Node.js heap to 512MB to prevent OOM kills on low-resource devices (0544a0a), closes #141
• #142: make Alexa brightness-reset workaround always active, no longer behind feature flag (21423e9), closes #142
• #143: map auto mode to heat/cool for single-capability thermostats (f9bf7e2), closes #143
• #144: responsive mobile navigation with hamburger menu drawer (f17654a), closes #144
• #144: wrap action buttons on Bridges page for mobile screens (e068985), closes #144
• #145: pass water heater min/max limits at endpoint level to prevent 50°C cap regression (cd48638), closes #145
• #146: fall back to setpoint when current_temperature unavailable (bad3338), closes #146
• #146: re-enable AutoMode for full HVAC thermostats to fix Apple Home active display (889010b)
• #146: set localTemperature to null when current_temperature unavailable - fixes Apple Home display (fe77f88)
• #146: set thermostatRunningMode for Auto mode only - reactor skips Auto (da04b2e), closes #146
• #146: stop manually setting thermostatRunningMode - let Matter.js reactor handle it to fix Auto mode (0678d35)
• #148: fix coverSwapOpenClose not affecting position display - was doing same inversion as default (b88d9a1)
• #154: map running/plug/power binary sensors to OnOffSensor instead of ContactSensor (e3ca4ba), closes #154
• #52: per-property error handling in applyPatchState, fix thermostatRunningState (0491822)
• #52: revert thermostatRunningState to systemMode-based logic for correct mode coloring (d96ffd7), closes #52
• #52: set thermostatRunningMode and controlSequenceOfOperation from HA entity (cd18e1c), closes #52
• #52: use HA min/max limits for all thermostat modes, fix local temperature fallback (ec865a4)
• add OperationCompletion event, GoHome command, remove OnOff from server-mode RVC (121c62e), closes #103
• add state deduplication and debouncing to ServerModeVacuumEndpoint (f51b19a)
• add User feature to DoorLock for Apple Home compatibility (df6b860)
• consistent property ordering in endpoint .set() for negative temperature support (307945e)
• detect and close dead sessions to recover from Alexa subscription loss (684e6e0)
• dreame vacuum multi-floor room ID collision causing auto-grouping in Apple Home (0e43473)
• improve behavior error logging to extract AggregateError details per behavior (d972762)
• improve crash resilience across bridge lifecycle (6f0daad)
• initialize thermostatRunningState in defaults so controllers subscribe from start (746cc4e)
• label filter now also matches device-level labels (dc92455)
• remove AutoMode feature to fix Apple Home active heating/cooling display (ef0c1c9), closes #3105
• remove stale minSetpointDeadBand and add NaN guards for thermostat initialization (9bc9859)
• remove unverified device limit warnings from bridge UI (725b41d)
• replace confusing API endpoint hint with clear label_id instructions (182eb80)
• sensor: don't skip humidity entities auto-assigned to temperature sensors (#133) (e76b253)
• speaker: prevent base LevelControlServer from overwriting volume (#79) (32f67ab)
• truncate FixedLabel area name to 16 chars and add detailed behavior error logging (cc09c4b)
• ui: match Startup Order icons to Bridge page style and reduce card padding (7c840e0)
• ui: network map dark mode for bridge/failed nodes, status chip readability, position persistence with undo/reset (12ee128)
• ui: network map grid layout for many devices and dark mode support for controls/minimap (f4d1b1e)
• use hvac_action for thermostatRunningState to show active heating/cooling in Apple Home (771cabd)
• use MutableEndpoint.with() API for FixedLabel instead of manual spreading (55afbd2)
• use unlatch action for unlockDoor on locks with Unbolting feature (18912f2)

Features

• add auto pressure mapping for combined temperature+pressure sensors (35f2ab1)
• add community tip about device limits to bridge config editor (48d048a)
• add Labels & Areas reference page to frontend UI (6fae7af)
• add lock unlatch/unbolt support for locks with OPEN feature (b924c11)
• automatic room assignment via HA areas using FixedLabel cluster (#77) (bfb11c7)
• enhanced device state display in EndpointCard with sensor values, light color/brightness, lock state, and more (1c0f47f)
• expose HA temperature unit via ThermostatUserInterfaceConfiguration cluster (8718708)
• frontend: add Network Map page with React Flow visualization (78927ea)
• sensor: add tvoc_sensor to entity mapping options (#134) (c142ac3)
• ui: add configurable page size selector to All Devices page (266a038)