@riddix/hamh 2.1.0-alpha.639 → 2.1.0-alpha.641

package/README.md

@@ -56,9 +56,9 @@ of port forwarding etc.
 
 **New in v2.0.42 (hotfix release):**
 
-- 🇯🇵 Aqara bridge registration no longer stalls — root `softwareVersionString` now matches the numeric `softwareVersion` ([#316](https://github.com/RiDDiX/home-assistant-matter-hub/issues/316))
+- 🇯🇵 Aqara bridge registration no longer stalls, root `softwareVersionString` now matches the numeric `softwareVersion` ([#316](https://github.com/RiDDiX/home-assistant-matter-hub/issues/316))
 - ❄️ Climate `auto` mode is clamped to `heat`/`cool` on devices without an `AutoMode` base ([#319](https://github.com/RiDDiX/home-assistant-matter-hub/issues/319))
-- 🌀 Per-entity `disableClimateFanControl` mapping flag — falls back to `ThermostatDevice` when controllers like Aqara don't recognise `RoomAirConditioner` (`0x0072`) ([#318](https://github.com/RiDDiX/home-assistant-matter-hub/issues/318))
+- 🌀 Per-entity `disableClimateFanControl` mapping flag, falls back to `ThermostatDevice` when controllers like Aqara don't recognise `RoomAirConditioner` (`0x0072`) ([#318](https://github.com/RiDDiX/home-assistant-matter-hub/issues/318))
 - 🗺️ Vacuum service area `selectedAreas` is kept after dispatch instead of being cleared
 
 **Previously in v2.0.41:**
@@ -68,13 +68,13 @@ of port forwarding etc.
 | 🌡️ Google Home AC offline fix | `DeadFrontBehavior` on climate OnOff cluster so RoomAirConditioner stops showing offline on Google Home ([#302](https://github.com/RiDDiX/home-assistant-matter-hub/issues/302)) |
 | 🪟 Cover device_class mapping | Map HA `garage`/`gate`/`window`/`awning`/etc. to the matching Matter WindowCovering type so voice commands hit the right device type ([#304](https://github.com/RiDDiX/home-assistant-matter-hub/issues/304)) |
 | 📺 LG TV commissioning patch | Local patch on matter.js 0.16.11 to accept long NOC operational cert serials ([#305](https://github.com/RiDDiX/home-assistant-matter-hub/issues/305)) |
-| 💡 Alexa brightness-reset behind flag | Old Alexa brightness-reset heuristic moved behind `alexaPreserveBrightnessOnTurnOn`, default off — Apple Home "set room to 100%" works again ([#306](https://github.com/RiDDiX/home-assistant-matter-hub/issues/306)) |
+| 💡 Alexa brightness-reset behind flag | Old Alexa brightness-reset heuristic moved behind `alexaPreserveBrightnessOnTurnOn`, default off, Apple Home "set room to 100%" works again ([#306](https://github.com/RiDDiX/home-assistant-matter-hub/issues/306)) |
 | 🌀 Google Home fan speed | Uses `fan.set_percentage` so already-on fans pick up speed changes from Google Home ([#308](https://github.com/RiDDiX/home-assistant-matter-hub/issues/308)) |
 | ❄️ Climate auto mode | Expose Matter Auto mode when HA reports `auto` in `hvac_modes` ([#309](https://github.com/RiDDiX/home-assistant-matter-hub/issues/309)) |
 | 🆔 Server-mode root identity | Root identity now applies as a single transaction, so controllers don't drop devices mid-swap ([#311](https://github.com/RiDDiX/home-assistant-matter-hub/issues/311)) |
-| 🪟 Lift-only blinds | No more `TiltBlindTiltOnly` on covers without tilt — fixes Alexa routines for roller blinds ([#312](https://github.com/RiDDiX/home-assistant-matter-hub/issues/312)) |
+| 🪟 Lift-only blinds | No more `TiltBlindTiltOnly` on covers without tilt, fixes Alexa routines for roller blinds ([#312](https://github.com/RiDDiX/home-assistant-matter-hub/issues/312)) |
 | 🏷️ Per-entity `disableClimateOnOff` | Turn off the OnOff cluster on climate endpoints per entity for controllers that prefer mode-only control |
-| 🔢 `serialNumberSuffix` per bridge | Append a suffix to every entity serial — useful if controllers like Aqara cache stale device data |
+| 🔢 `serialNumberSuffix` per bridge | Append a suffix to every entity serial, useful if controllers like Aqara cache stale device data |
 | 📝 `protocolLogLevel` option | Quiet matter.js logs independently from the app log level |
 | 🖥️ Bridge HW/SW version strings | HA device-registry `hw_version`/`sw_version` now show up in Matter BasicInformation on server-mode endpoints |
 | 🎨 Extended color light: XY + enhancedColorMode | XY feature added as mandatory, `enhancedColorMode` mirrors `colorMode` |
@@ -87,7 +87,7 @@ of port forwarding etc.
 **Reliability & resilience:** parallel bridge stop in `stopAll`/`restartAll`, parallel HA registry fetches, serialized bridge start/stop lifecycle, serialized `updateStates` with plugin listener detach, HA reconnect retry on transient network errors, 30s timeout on `sendMessagePromise`, port-conflict reject on web-api start, graceful shutdown on `/api/backup/restart`, `AppEnvironment` disposal on SIGINT, stale optimistic state sweep, pending debouncer clear, healthcheck 401 fix under basic auth, deep-equal entity attribute comparison, overlap guard for auto-refresh, safer mireds conversion, aligned `colorMode` publishing, surfaced bridge import errors, corrected thermostat running state for unknown modes + drying, unified Node version across Dockerfiles, sourcemaps excluded from npm tarball, unused deps dropped (rxjs, strip-color, lodash), unused `config-validator` utility removed.
 
 **Previously in v2.0.39 & v2.0.40 (hotfix releases):**
-- Fixed crash loop on startup caused by Node 22 native WebSocket dropping connections ([#297](https://github.com/RiDDiX/home-assistant-matter-hub/issues/297), [#299](https://github.com/RiDDiX/home-assistant-matter-hub/issues/299)) — affects both aarch64 (RPi) and amd64
+- Fixed crash loop on startup caused by Node 22 native WebSocket dropping connections ([#297](https://github.com/RiDDiX/home-assistant-matter-hub/issues/297), [#299](https://github.com/RiDDiX/home-assistant-matter-hub/issues/299)), affects both aarch64 (RPi) and amd64
 - Fixed service initialization errors being silently swallowed, causing the process to hang instead of exiting
 - Registry fetch now waits for WebSocket reconnect between retries and has increased retry tolerance
 - Fixed `select`, `input_select`, `siren` domains showing as unsupported in filter preview ([#298](https://github.com/RiDDiX/home-assistant-matter-hub/issues/298))
@@ -161,7 +161,7 @@ of port forwarding etc.
 <summary><strong>📜 Previous Stable Versions</strong> - Click to expand</summary>
 
 ### v2.0.40
-Filter preview domain fix — `select`, `input_select`, `siren` now show as supported ([#298](https://github.com/RiDDiX/home-assistant-matter-hub/issues/298))
+Filter preview domain fix, `select`, `input_select`, `siren` now show as supported ([#298](https://github.com/RiDDiX/home-assistant-matter-hub/issues/298))
 
 ### v2.0.39
 Node 22 WebSocket crash loop fix ([#297](https://github.com/RiDDiX/home-assistant-matter-hub/issues/297), [#299](https://github.com/RiDDiX/home-assistant-matter-hub/issues/299)), service init error surfacing, registry retry hardening, support link added
@@ -205,7 +205,7 @@ Vacuum mop intensity, vacuum auto-detection, Roborock room auto-detect, live ent
 ### v2.0.24
 Dashboard landing page, composed devices, bridge wizard feature flags, entity autocomplete, light transitions, live diagnostics, vacuum suction level, thermostat auto-resume, vacuum docked state, memory leak fix
 
-### v2.0.19–v2.0.23
+### v2.0.19-v2.0.23
 Bridge templates, live filter preview, entity diagnostics, multi-bridge bulk operations, entity health indicators, diagnostic export, EntityLabel/DeviceLabel filters, Power & Energy Measurement, Event domain (GenericSwitch)
 
 ### v2.0.17 / v2.0.18
@@ -347,26 +347,26 @@ configuration options, known issues, limitations and guides.
 ## 🔧 Network Troubleshooting
 
 <details>
-<summary><strong>⚠️ "No Response" / Connection Drops — Common Network Causes</strong> (click to expand)</summary>
+<summary><strong>⚠️ "No Response" / Connection Drops, Common Network Causes</strong> (click to expand)</summary>
 
 ### The Problem
 
-Your Matter devices suddenly show **"No Response"** (Apple Home), **"Unavailable"** (Google Home), or become **unresponsive** after some time — even though the bridge is still running and other controllers (e.g., Alexa) continue to work fine.
+Your Matter devices suddenly show **"No Response"** (Apple Home), **"Unavailable"** (Google Home), or become **unresponsive** after some time, even though the bridge is still running and other controllers (e.g., Alexa) continue to work fine.
 
 ### Root Cause: Network Equipment Blocking mDNS/Multicast
 
-Matter relies heavily on **mDNS (multicast DNS)** for device discovery and reachability. Many routers, access points, and managed switches have features that **filter, throttle, or block multicast traffic** — which breaks Matter communication silently.
+Matter relies heavily on **mDNS (multicast DNS)** for device discovery and reachability. Many routers, access points, and managed switches have features that **filter, throttle, or block multicast traffic**, which breaks Matter communication silently.
 
-> **💡 This was confirmed and documented thanks to the excellent systematic testing by [@omerfaruk-aran](https://github.com/omerfaruk-aran) in [#129](https://github.com/RiDDiX/home-assistant-matter-hub/issues/129).** The issue was traced to a TP-Link Archer AX50 (in AP mode) sitting between the Apple TV and the network — its default settings were blocking/limiting mDNS/Bonjour traffic over time.
+> **💡 This was confirmed and documented thanks to the excellent systematic testing by [@omerfaruk-aran](https://github.com/omerfaruk-aran) in [#129](https://github.com/RiDDiX/home-assistant-matter-hub/issues/129).** The issue was traced to a TP-Link Archer AX50 (in AP mode) sitting between the Apple TV and the network, its default settings were blocking/limiting mDNS/Bonjour traffic over time.
 
 ### What to Check on Your Network Equipment
 
-1. **IGMP Snooping** — Disable or configure it to allow mDNS (`224.0.0.251` / `ff02::fb`)
-2. **Multicast Optimization / Multicast Enhancement** — Disable (often called "Airtime Fairness" or "Multicast to Unicast")
-3. **AP Isolation / Client Isolation** — Must be **disabled** so devices on the same network can communicate
-4. **mDNS / Bonjour Forwarding** — Enable if available (some enterprise APs have this)
-5. **DHCP Server on secondary devices** — Disable DHCP on access points / switches that are NOT your main router (multiple DHCP servers cause IP conflicts)
-6. **Firmware Updates** — Update your router/AP firmware, as multicast handling is frequently improved
+1. **IGMP Snooping**, Disable or configure it to allow mDNS (`224.0.0.251` / `ff02::fb`)
+2. **Multicast Optimization / Multicast Enhancement**, Disable (often called "Airtime Fairness" or "Multicast to Unicast")
+3. **AP Isolation / Client Isolation**, Must be **disabled** so devices on the same network can communicate
+4. **mDNS / Bonjour Forwarding**, Enable if available (some enterprise APs have this)
+5. **DHCP Server on secondary devices**, Disable DHCP on access points / switches that are NOT your main router (multiple DHCP servers cause IP conflicts)
+6. **Firmware Updates**, Update your router/AP firmware, as multicast handling is frequently improved
 
 ### Affected Equipment (Known Cases)
 
@@ -390,14 +390,14 @@ Matter relies heavily on **mDNS (multicast DNS)** for device discovery and reach
    ```
    --mdns-network-interface eth0
    ```
-   (or `end0`, `enp0s18`, etc. — check your system)
+   (or `end0`, `enp0s18`, etc., check your system)
 
 ### Network Topology Tips
 
 - **Keep the path simple**: Avoid placing access points or managed switches between your Matter bridge (Home Assistant) and your Home Hub (HomePod/Apple TV)
 - **Use wired connections** where possible for Home Hubs and the Home Assistant host
 - **Same subnet**: All Matter devices, controllers, and the bridge must be on the same Layer 2 network / subnet
-- **IPv6**: Matter requires IPv6 — do not disable it. For VLAN setups, configure **ULA addresses** (`fd00::/8`), not just link-local (`fe80::`). See [Troubleshooting](https://home-assistant-matter-hub.riddix.dev/guides/connectivity-issues#ipv6) and [Discussion #39](https://github.com/RiDDiX/home-assistant-matter-hub/discussions/39)
+- **IPv6**: Matter requires IPv6, do not disable it. For VLAN setups, configure **ULA addresses** (`fd00::/8`), not just link-local (`fe80::`). See [Troubleshooting](https://home-assistant-matter-hub.riddix.dev/guides/connectivity-issues#ipv6) and [Discussion #39](https://github.com/RiDDiX/home-assistant-matter-hub/discussions/39)
 
 </details>
 
@@ -405,7 +405,7 @@ Matter relies heavily on **mDNS (multicast DNS)** for device discovery and reach
 
 ## Migration from t0bst4r
 
-Migrating from the original `t0bst4r/home-assistant-matter-hub` is straightforward. **Your Matter fabric connections and paired devices will be preserved!**
+Migrating from the original `t0bst4r/home-assistant-matter-hub` is easy. **Your Matter fabric connections and paired devices will be preserved!**
 
 ### Home Assistant Add-on
 
@@ -457,22 +457,29 @@ Your volume mounts stay the same - no data migration needed.
 
 This project thrives thanks to the amazing community! Special thanks to everyone who contributes by reporting bugs, suggesting features, and helping others.
 
+> Note: GitHub doesn't surface contributors on this repo because it's still a fork of the original. The list below is maintained by hand.
+
 ### 🏆 Top Contributors
 
+Newest first.
+
 | Contributor | Contributions |
 |-------------|---------------|
-| [@codyc1515](https://github.com/codyc1515) | 🥇 **Top Reporter** - Climate/thermostat bugs (#52, #24, #21, #20), extensive testing feedback |
+| [@Yllelder](https://github.com/Yllelder) | 🌐 **Translator** - Spanish translation ([#314](https://github.com/RiDDiX/home-assistant-matter-hub/pull/314)) |
+| [@MStankiewiczOfficial](https://github.com/MStankiewiczOfficial) | 🌐 **Translator** - Polish translation ([#288](https://github.com/RiDDiX/home-assistant-matter-hub/pull/288)) |
+| [@aetasoul](https://github.com/aetasoul) | 🤖 **Code Contributor** - Immediate force sync on startup to beat stale Alexa queues ([#282](https://github.com/RiDDiX/home-assistant-matter-hub/pull/282)) |
+| [@omerfaruk-aran](https://github.com/omerfaruk-aran) | 🌐 Turkish translation ([#260](https://github.com/RiDDiX/home-assistant-matter-hub/pull/260)) + 🔧 Network debugging for "No Response" issues ([#129](https://github.com/RiDDiX/home-assistant-matter-hub/issues/129)) |
+| [@gustavakerstrom](https://github.com/gustavakerstrom) | 🤖 **Code Contributor** - Custom fan speed mapping ([#226](https://github.com/RiDDiX/home-assistant-matter-hub/pull/226)), template description fix ([#215](https://github.com/RiDDiX/home-assistant-matter-hub/pull/215)) |
+| [@AmineDjeghri](https://github.com/AmineDjeghri) | 📝 Migration instructions for the addon data folder ([#171](https://github.com/RiDDiX/home-assistant-matter-hub/pull/171)) |
+| [@markgaze](https://github.com/markgaze) | 🤖 **Code Contributor** - Ecovacs Deebot room support ([#118](https://github.com/RiDDiX/home-assistant-matter-hub/pull/118)) |
+| [@codyc1515](https://github.com/codyc1515) | 🥇 **Top Reporter** - Climate/thermostat bugs (#52, #24, #21, #20), README badge & install steps ([#285](https://github.com/RiDDiX/home-assistant-matter-hub/pull/285)), binary sensor classes ([#66](https://github.com/RiDDiX/home-assistant-matter-hub/pull/66)), fan control init ([#10](https://github.com/RiDDiX/home-assistant-matter-hub/pull/10)) |
+| [@AymericLeFeyer](https://github.com/AymericLeFeyer) | 📝 README YouTube video link |
+| [@depahk](https://github.com/depahk) | 📝 Migration docs ([#32](https://github.com/RiDDiX/home-assistant-matter-hub/pull/32)) |
 | [@Hatton920](https://github.com/Hatton920) | 🤖 **Vacuum Expert** - Intensive testing of Robot Vacuum Server Mode, Apple Home & Siri validation |
-| [@Chrulf](https://github.com/Chrulf) | 🔍 Google Home brightness debugging (#41), detailed logs & testing |
+| [@razzietheman](https://github.com/razzietheman) | 🥈 **Active Tester** - Bridge icons (#101), sorting (#80), feature requests (#31, #30), extensive UI/UX feedback |
 | [@SH1FT-W](https://github.com/SH1FT-W) | 💎 **Sponsor** + Vacuum room selection feature request (#49) |
-| [@depahk](https://github.com/depahk) | 📝 Migration documentation fix ([#32](https://github.com/RiDDiX/home-assistant-matter-hub/pull/32)) |
+| [@Chrulf](https://github.com/Chrulf) | 🔍 Google Home brightness debugging (#41), detailed logs & testing |
 | [@Fettkeewl](https://github.com/Fettkeewl) | 🐛 Script import bug (#26), Alias feature request (#25) |
-| [@razzietheman](https://github.com/razzietheman) | 🥈 **Active Tester** - Bridge icons (#101), sorting (#80), feature requests (#31, #30), extensive UI/UX feedback |
-| [@markgaze](https://github.com/markgaze) | 🤖 **Code Contributor** - Ecovacs Deebot room support ([#118](https://github.com/RiDDiX/home-assistant-matter-hub/pull/118)) |
-| [@omerfaruk-aran](https://github.com/omerfaruk-aran) | 🔧 **Network Debugging Expert** - Systematic mDNS/multicast root cause analysis for "No Response" issues ([#129](https://github.com/RiDDiX/home-assistant-matter-hub/issues/129)) |
-| [@gustavakerstrom](https://github.com/gustavakerstrom) | 🤖 **Code Contributor** - Template description display fix ([#215](https://github.com/RiDDiX/home-assistant-matter-hub/pull/215)) |
-| [@aetasoul](https://github.com/aetasoul) | 🤖 **Code Contributor** - Immediate force sync on startup to beat stale Alexa queues ([#282](https://github.com/RiDDiX/home-assistant-matter-hub/pull/282)) |
-| [@Yllelder](https://github.com/Yllelder) | 🌐 **Translator** - Spanish translation ([#314](https://github.com/RiDDiX/home-assistant-matter-hub/pull/314)) |
 
 <details>
 <summary><strong>📋 Issue Tracker - All Contributors</strong> (click to expand)</summary>
@@ -516,7 +523,7 @@ Thank you to everyone who helps improve this project by reporting issues!
 
 ### 💖 Sponsors
 
-> **Donations are completely voluntary!** This project exists because of passion for open source, not money. Thank you to everyone who has supported it — it truly means a lot! ❤️
+> **Donations are completely voluntary!** This project exists because of passion for open source, not money. Thank you to everyone who has supported it, it truly means a lot! ❤️
 
 🥇 **First Sponsor:** [@thorsten-gehrig](https://github.com/thorsten-gehrig)
 
@@ -568,3 +575,4 @@ Your support helps cover hosting costs and motivates continued development. Than
 </div>
 
 ---
+

package/dist/backend/cli.js

@@ -146781,7 +146781,7 @@ var init_bridge_config_schema = __esm({
         },
         autoComposedDevices: {
           title: "Auto Composed Devices",
-          description: "Master toggle: combine related entities from the same Home Assistant device into a single Matter endpoint. Turns on battery, humidity, pressure, power, and energy auto-mapping at once \u2014 a Shelly Plug shows up as one device with power monitoring instead of several siblings.",
+          description: "Master toggle: combine related entities from the same Home Assistant device into a single Matter endpoint. Turns on battery, humidity, pressure, power, and energy auto-mapping at once, a Shelly Plug shows up as one device with power monitoring instead of several siblings.",
           type: "boolean",
           default: false
         },
@@ -146799,13 +146799,13 @@ var init_bridge_config_schema = __esm({
         },
         preferEntityRegistryName: {
           title: "Prefer Entity Registry Name (HA 2026.4 workaround)",
-          description: "Use the entity registry name (or original_name) as nodeLabel instead of the composed friendly_name. Since Home Assistant 2026.4, friendly_name is prefixed with the device name, which breaks voice commands that relied on the short entity name. Resolution order: customName \u2192 registry name \u2192 registry original_name \u2192 friendly_name \u2192 entity_id. Matter has no alias concept \u2014 this only changes which single name is reported.",
+          description: "Use the entity registry name (or original_name) as nodeLabel instead of the composed friendly_name. Since Home Assistant 2026.4, friendly_name is prefixed with the device name, which breaks voice commands that relied on the short entity name. Resolution order: customName \u2192 registry name \u2192 registry original_name \u2192 friendly_name \u2192 entity_id. Matter has no alias concept, this only changes which single name is reported.",
           type: "boolean",
           default: false
         },
         vacuumOnOff: {
           title: "Vacuum: Include OnOff Cluster (Alexa)",
-          description: "Add an OnOff cluster to robot vacuum endpoints. Alexa REQUIRES this (PowerController) to show robotic vacuums in the app. Without it, Alexa commissions the device but never displays it. In Server Mode this is enabled automatically \u2014 only check this for bridge mode. WARNING: OnOff is NOT part of the Matter RVC device type specification. Enabling this may break Apple Home (shows 'Updating') and Google Home.",
+          description: "Add an OnOff cluster to robot vacuum endpoints. Alexa REQUIRES this (PowerController) to show robotic vacuums in the app. Without it, Alexa commissions the device but never displays it. In Server Mode this is enabled automatically, only check this for bridge mode. WARNING: OnOff is NOT part of the Matter RVC device type specification. Enabling this may break Apple Home (shows 'Updating') and Google Home.",
           type: "boolean"
         },
         alexaPreserveBrightnessOnTurnOn: {
@@ -152748,7 +152748,7 @@ var HomeAssistantRegistry = class extends Service {
     let refreshing = false;
     this.autoRefresh = setInterval(async () => {
       if (refreshing) {
-        logger146.debug("Skipping registry refresh \u2014 previous tick still running");
+        logger146.debug("Skipping registry refresh, previous tick still running");
         return;
       }
       refreshing = true;
@@ -165337,7 +165337,7 @@ var ServerModeServerNode = class extends ServerNode {
   /**
    * Update root-level BasicInformation with entity-specific data.
    * In server mode, controllers (Apple Home, Alexa) read the root node's
-   * BasicInformation — not the device endpoint's BridgedDeviceBasicInformation.
+   * BasicInformation, not the device endpoint's BridgedDeviceBasicInformation.
    * Without this, server-mode devices show bridge defaults (e.g. "riddix" / "MatterHub").
    */
   async updateDeviceIdentity(entityId, device, mapping, friendlyName) {
@@ -167848,7 +167848,7 @@ ${e?.toString()}`);
         );
         if (totalSubs === 0 && sessions.length > 0) {
           this.log.warn(
-            `All subscriptions lost \u2014 ${sessions.length} session(s) still active, waiting for controller to re-subscribe`
+            `All subscriptions lost, ${sessions.length} session(s) still active, waiting for controller to re-subscribe`
           );
           if (!this.deadSessionTimer) {
             this.deadSessionTimer = setTimeout(() => {
@@ -167896,7 +167896,7 @@ ${e?.toString()}`);
         for (const s of [...sessionManager.sessions]) {
           if (s !== newSession && !s.isClosing && s.peerNodeId === newSession.peerNodeId && s.fabric?.fabricIndex === newSession.fabric?.fabricIndex && s.subscriptions.size === 0) {
             this.log.info(
-              `Closing stale session ${s.id} (peer ${s.peerNodeId}, 0 subs) \u2014 replaced by session ${newSession.id}`
+              `Closing stale session ${s.id} (peer ${s.peerNodeId}, 0 subs), replaced by session ${newSession.id}`
             );
             s.initiateForceClose().catch(() => {
             });
@@ -169200,7 +169200,7 @@ var FeaturedBase5 = FanControlServer.with(
   "Rocking",
   "Wind"
 ).set({
-  // rockSupport / windSupport are Fixed quality attributes — they MUST be set
+  // rockSupport / windSupport are Fixed quality attributes, they MUST be set
   // via .set() at behavior creation time, NOT in initialize().
   // Without these, controllers reject attempts to enable rocking/wind.
   rockSupport: { rockUpDown: true },
@@ -171304,7 +171304,7 @@ var ThermostatServerBase = class extends FullFeaturedBase {
       // Heat/Cool/Off but SKIPS Auto (see #handleSystemModeChange in Matter.js).
       // Without this, switching Heat→Auto leaves runningMode stale at Heat.
       // 889010b set for ALL modes (conflicted with reactor), 0678d35 set for NONE
-      // (stale in Auto). da04b2e's Auto-only approach is correct — the issues
+      // (stale in Auto). da04b2e's Auto-only approach is correct, the issues
       // reported after it were caused by localTemperature fallback, not runningMode.
       ...this.features.heating && this.features.cooling && systemMode === Thermostat3.SystemMode.Auto ? { thermostatRunningMode: runningMode } : {}
     });
@@ -171589,7 +171589,7 @@ var CoolingOnlyThermostatServerBase = class extends CoolingOnlyFeaturedBase {
   static State = class extends CoolingOnlyFeaturedBase.State {
     config;
   };
-  // Each variant MUST define its own initialize() — see HeatingOnly comment above.
+  // Each variant MUST define its own initialize(), see HeatingOnly comment above.
   async initialize() {
     thermostatPreInitialize(this);
     await super.initialize();
@@ -171611,7 +171611,7 @@ var HeatingAndCoolingThermostatServerBase = class extends HeatingAndCoolingFeatu
   static State = class extends HeatingAndCoolingFeaturedBase.State {
     config;
   };
-  // Each variant MUST define its own initialize() — see HeatingOnly comment above.
+  // Each variant MUST define its own initialize(), see HeatingOnly comment above.
   async initialize() {
     thermostatPreInitialize(this);
     await super.initialize();
@@ -172239,7 +172239,7 @@ var WindowCoveringServerBase = class _WindowCoveringServerBase extends FeaturedB
     } else if (type === MovementType.Tilt) {
       if (targetPercent100ths == null && this.lastLiftMovementDirection === direction && Date.now() - this.lastLiftMovementMs < 50) {
         logger179.info(
-          `Skipping tilt ${MovementDirection[direction]} \u2014 lift already moving in same direction`
+          `Skipping tilt ${MovementDirection[direction]}, lift already moving in same direction`
         );
         return;
       }
@@ -174674,7 +174674,7 @@ var SpeakerLevelControlServerBase = class extends FeaturedBase8 {
    *
    * The base class registers a reactor on onOff$Changed that sets
    * currentLevel = onLevel. This is designed for lights (restore brightness
-   * on power-on) but is wrong for speakers — it overwrites the correct
+   * on power-on) but is wrong for speakers, it overwrites the correct
    * volume (e.g. 191 for 75%) with a stale onLevel value, causing Google
    * Home to display the wrong percentage (Issue #79).
    */
@@ -176679,7 +176679,7 @@ function SensorDevice(homeAssistantEntity) {
   if (deviceClass) {
     diagnosticEventBus.emit(
       "entity_warning",
-      `Sensor "${homeAssistantEntity.entity.entity_id}" has unsupported device_class "${deviceClass}" \u2014 skipped`,
+      `Sensor "${homeAssistantEntity.entity.entity_id}" has unsupported device_class "${deviceClass}", skipped`,
       {
         entityId: homeAssistantEntity.entity.entity_id,
         details: { device_class: deviceClass }
@@ -176795,7 +176795,7 @@ var VacuumIdentifyServer = class extends IdentifyServer2 {
       return;
     }
     logger190.warn(
-      `${source} for ${homeAssistant.entityId} \u2014 LOCATE not in supported_features (${features2}), trying vacuum.locate anyway`
+      `${source} for ${homeAssistant.entityId}, LOCATE not in supported_features (${features2}), trying vacuum.locate anyway`
     );
     homeAssistant.callAction({ action: "vacuum.locate" });
   }
@@ -176925,7 +176925,7 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
       if (!currentRoomEntityId) {
         this.logShortCircuitOnce(
           "no-mapping",
-          "currentRoom sensor: no currentRoomEntity in mapping \u2014 auto-detect did not run or sensor not on same HA device"
+          "currentRoom sensor: no currentRoomEntity in mapping, auto-detect did not run or sensor not on same HA device"
         );
         return;
       }
@@ -176941,7 +176941,7 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
       if (s.activeAreas.length === 0) {
         this.logShortCircuitOnce(
           "no-active-areas",
-          `currentRoom sensor: activeAreas empty while cleaning \u2014 sensor=${currentRoomEntityId} state="${roomState.state}"`
+          `currentRoom sensor: activeAreas empty while cleaning, sensor=${currentRoomEntityId} state="${roomState.state}"`
         );
         return;
       }
@@ -178306,42 +178306,24 @@ function buildSupportedModes3(fanSpeedList, mopIntensityList, cleaningModeOption
   }
   return modes;
 }
-var CLEANING_MODE_ALIASES = {
-  [0 /* Sweeping */]: [
-    "Sweeping",
-    "Vacuum",
-    "Vacuuming",
-    "Sweep",
-    "vacuum",
-    "sweeping",
-    "sweep"
-  ],
-  [1 /* Mopping */]: ["Mopping", "Mop", "mopping", "mop", "wet_mop"],
-  [2 /* SweepingAndMopping */]: [
-    "Sweeping and mopping",
-    "Vacuum and mop",
-    "Vacuum & Mop",
-    "Vacuum & mop",
-    "vacuum_and_mop",
-    "sweeping_and_mopping",
-    "Sweep Mop",
-    "Sweep & Mop",
-    "Sweep and Mop",
-    "sweep_mop"
-  ],
-  [3 /* MoppingAfterSweeping */]: [
-    "Mopping after sweeping",
-    "mopping_after_sweeping",
-    "Vacuum then mop",
-    "Mop after vacuum",
-    "vacuum_then_mop",
-    "mop_after_vacuum",
-    "Sweep Before Mopping",
-    "Sweep before Mop",
-    "sweep_before_mopping",
-    "sweep_then_mop"
-  ]
+var CLEAN_TOKENS = {
+  vacuum: /\b(vacuum|vacuuming|sweep|sweeping|suction)\b/i,
+  mop: /\b(mop|mopping|wipe|wet)\b/i,
+  sequential: /\b(then|after|before|followed|following)\b/i
 };
+function normalizeCleanLabel(s) {
+  return s.toLowerCase().replace(/[_\-+&/]+/g, " ").replace(/\band\b/g, " ").trim();
+}
+function classifyCleanOption(option) {
+  const s = normalizeCleanLabel(option);
+  const hasVac = CLEAN_TOKENS.vacuum.test(s);
+  const hasMop = CLEAN_TOKENS.mop.test(s);
+  const hasSeq = CLEAN_TOKENS.sequential.test(s);
+  if (hasVac && hasMop && hasSeq) return 3 /* MoppingAfterSweeping */;
+  if (hasVac && hasMop) return 2 /* SweepingAndMopping */;
+  if (hasMop) return 1 /* Mopping */;
+  return 0 /* Sweeping */;
+}
 var CLEAN_TYPE_LABELS = {
   [0 /* Sweeping */]: "Sweeping",
   [1 /* Mopping */]: "Mopping",
@@ -178474,19 +178456,7 @@ function matchMopIntensityOption(name, availableOptions) {
 }
 function parseCleanType(modeString) {
   if (!modeString) return 0 /* Sweeping */;
-  const s = modeString.toLowerCase().replace(/[_-]+/g, " ");
-  if (s.includes("after sweeping") || s.includes("after sweep") || s.includes("after vacuum") || s.includes("then mop") || s.includes("before mop")) {
-    return 3 /* MoppingAfterSweeping */;
-  }
-  const mentionsSweep = s.includes("sweep") || s.includes("vacuum");
-  const mentionsMop = s.includes("mop");
-  if (mentionsSweep && mentionsMop) {
-    return 2 /* SweepingAndMopping */;
-  }
-  if (mentionsMop) {
-    return 1 /* Mopping */;
-  }
-  return 0 /* Sweeping */;
+  return classifyCleanOption(modeString);
 }
 function cleanTypeToModeId(ct) {
   switch (ct) {
@@ -178527,30 +178497,20 @@ var CLEAN_TYPE_FALLBACK = {
   [3 /* MoppingAfterSweeping */]: 2 /* SweepingAndMopping */
 };
 function findMatchingCleanOption(ct, availableOptions) {
-  const aliases = CLEANING_MODE_ALIASES[ct];
-  if (!availableOptions || availableOptions.length === 0) return aliases[0];
+  if (!availableOptions || availableOptions.length === 0) {
+    return CLEAN_TYPE_LABELS[ct];
+  }
   const typesToTry = [ct];
   const fallback = CLEAN_TYPE_FALLBACK[ct];
   if (fallback !== void 0) typesToTry.push(fallback);
   for (const type of typesToTry) {
-    const typeAliases = CLEANING_MODE_ALIASES[type];
-    for (const alias of typeAliases) {
-      const match = availableOptions.find(
-        (o) => o.toLowerCase() === alias.toLowerCase()
-      );
-      if (match) return match;
-    }
-    for (const alias of typeAliases) {
-      const match = availableOptions.find(
-        (o) => o.toLowerCase().includes(alias.toLowerCase())
-      );
-      if (match) return match;
-    }
+    const match = availableOptions.find((o) => classifyCleanOption(o) === type);
+    if (match) return match;
   }
   logger196.warn(
     `No match for ${CLEAN_TYPE_LABELS[ct]} in [${availableOptions.join(", ")}]`
   );
-  return aliases[0];
+  return availableOptions[0];
 }
 function buildCleaningModeAction(targetCleanType, agent) {
   const selectEntityId = getCleaningModeSelectEntity(agent);
@@ -178685,7 +178645,7 @@ function createCleanModeConfig(fanSpeedList, mopIntensityList, cleaningModeOptio
       const vacuumEntityId = homeAssistant.entityId;
       const mapping = homeAssistant.state.mapping;
       logger196.info(
-        `setCleanMode(${mode}) for ${vacuumEntityId} \u2014 suctionEntity=${mapping?.suctionLevelEntity ?? "none"}, mopEntity=${mapping?.mopIntensityEntity ?? "none"}, fanSpeedList=${JSON.stringify(fanSpeedList ?? [])}, mopIntensityList=${JSON.stringify(mopIntensityList ?? [])}, customTags=${JSON.stringify(customFanSpeedTags ?? {})}`
+        `setCleanMode(${mode}) for ${vacuumEntityId}, suctionEntity=${mapping?.suctionLevelEntity ?? "none"}, mopEntity=${mapping?.mopIntensityEntity ?? "none"}, fanSpeedList=${JSON.stringify(fanSpeedList ?? [])}, mopIntensityList=${JSON.stringify(mopIntensityList ?? [])}, customTags=${JSON.stringify(customFanSpeedTags ?? {})}`
       );
       if (mopIntensityList && mopIntensityList.length > 0 && isMopIntensityMode(mode)) {
         const mopIndex = mode - MOP_INTENSITY_MODE_BASE;
@@ -180652,7 +180612,7 @@ var BridgeEndpointManager = class extends Service {
         this.mappingFingerprints.delete(endpoint.entityId);
       } else if (this.registry.isAutoComposedDevicesEnabled() && this.registry.isComposedSubEntityUsed(endpoint.entityId)) {
         this.log.info(
-          `Deleting standalone endpoint ${endpoint.entityId} \u2014 consumed by composed device`
+          `Deleting standalone endpoint ${endpoint.entityId}, consumed by composed device`
         );
         try {
           await endpoint.delete();
@@ -180690,14 +180650,14 @@ var BridgeEndpointManager = class extends Service {
       if (!memoryLimitReached && isHeapUnderPressure()) {
         memoryLimitReached = true;
         this.log.error(
-          "Memory pressure detected \u2014 skipping remaining entities to prevent OOM crash. Reduce the number of entities in this bridge or increase the Node.js heap size (NODE_OPTIONS=--max-old-space-size=1024)."
+          "Memory pressure detected, skipping remaining entities to prevent OOM crash. Reduce the number of entities in this bridge or increase the Node.js heap size (NODE_OPTIONS=--max-old-space-size=1024)."
         );
       }
       if (memoryLimitReached) {
         if (!existingEndpoints.some((e) => e.entityId === entityId)) {
           this._failedEntities.push({
             entityId,
-            reason: "Skipped due to memory pressure \u2014 reduce entities or increase heap size"
+            reason: "Skipped due to memory pressure, reduce entities or increase heap size"
           });
         }
         continue;
@@ -180709,7 +180669,7 @@ var BridgeEndpointManager = class extends Service {
       }
       if (this.registry.isAutoComposedDevicesEnabled() && this.registry.isComposedSubEntityUsed(entityId)) {
         this.log.debug(
-          `Skipping ${entityId} \u2014 already part of a composed device`
+          `Skipping ${entityId}, already part of a composed device`
         );
         continue;
       }
@@ -180809,7 +180769,7 @@ var BridgeEndpointManager = class extends Service {
   }
   /**
    * Log detailed behavior error information for debugging "Behaviors have errors".
-   * Matter.js EndpointBehaviorsError extends AggregateError — the `errors` array
+   * Matter.js EndpointBehaviorsError extends AggregateError, the `errors` array
    * contains individual behavior crash errors (one per failed behavior).
    */
   logDetailedError(entityId, error) {
@@ -180958,7 +180918,7 @@ var BridgeRegistry = class _BridgeRegistry {
    * Check if auto composed devices mode is enabled.
    * When enabled, temperature sensors with auto-mapped humidity/pressure/battery
    * build real Matter Composed Devices (BridgedNodeEndpoint with sub-endpoints)
-   * rather than stacking extra clusters onto a flat TemperatureSensor —
+   * rather than stacking extra clusters onto a flat TemperatureSensor.
    * Apple Home, Google Home, and Alexa render each sub-endpoint using its
    * own device type.
    */
@@ -181263,14 +181223,14 @@ var BridgeRegistry = class _BridgeRegistry {
         const segments = areaMapping[haAreaId];
         if (!segments || segments.length === 0) {
           _BridgeRegistry.cleanAreaLogger.debug(
-            `${entityId}: Skipping HA area ${haAreaId} \u2014 no segments mapped`
+            `${entityId}: Skipping HA area ${haAreaId}, no segments mapped`
           );
           continue;
         }
         if (validSegmentIds && !segments.some((sid) => validSegmentIds.has(sid))) {
           const areaName2 = this.registry.areas.get(haAreaId) ?? haAreaId;
           _BridgeRegistry.cleanAreaLogger.info(
-            `${entityId}: Skipping stale HA area "${areaName2}" (${haAreaId}) \u2014 segments [${segments.join(", ")}] no longer exist on vacuum`
+            `${entityId}: Skipping stale HA area "${areaName2}" (${haAreaId}), segments [${segments.join(", ")}] no longer exist on vacuum`
           );
           continue;
         }
@@ -181746,7 +181706,7 @@ ${e?.toString()}`);
         );
         if (totalSubs === 0 && sessions.length > 0) {
           this.log.warn(
-            `All subscriptions lost \u2014 ${sessions.length} session(s) still active, waiting for controller to re-subscribe`
+            `All subscriptions lost, ${sessions.length} session(s) still active, waiting for controller to re-subscribe`
           );
           if (!this.deadSessionTimer) {
             this.deadSessionTimer = setTimeout(() => {
@@ -181785,7 +181745,7 @@ ${e?.toString()}`);
         for (const s of [...sessionManager.sessions]) {
           if (s !== newSession && !s.isClosing && s.peerNodeId === newSession.peerNodeId && s.fabric?.fabricIndex === newSession.fabric?.fabricIndex && s.subscriptions.size === 0) {
             this.log.info(
-              `Closing stale session ${s.id} (peer ${s.peerNodeId}, 0 subs) \u2014 replaced by session ${newSession.id}`
+              `Closing stale session ${s.id} (peer ${s.peerNodeId}, 0 subs), replaced by session ${newSession.id}`
             );
             s.initiateForceClose().catch(() => {
             });
@@ -182206,7 +182166,7 @@ var ServerModeVacuumEndpoint = class _ServerModeVacuumEndpoint extends EntityEnd
         }
       }
     } else {
-      logger205.warn(`${entityId}: No device_id \u2014 cannot auto-assign battery`);
+      logger205.warn(`${entityId}: No device_id, cannot auto-assign battery`);
     }
     const payload = {
       entity_id: entityId,
@@ -182262,7 +182222,7 @@ var ServerModeVacuumEndpoint = class _ServerModeVacuumEndpoint extends EntityEnd
    *  Previous approaches that pushed state through
    *  HomeAssistantEntityBehavior failed because the reactor writes
    *  (RvcOperationalStateServer.update()) run inside the postCommit
-   *  phase of the HAEntityBehavior transaction — those writes are
+   *  phase of the HAEntityBehavior transaction, those writes are
    *  buffered but never committed, so no attrsChanged event reaches
    *  the ServerSubscription.
    *
@@ -182508,11 +182468,11 @@ var ServerModeEndpointManager = class extends Service {
     }
     if (isHeapUnderPressure()) {
       this.log.error(
-        "Memory pressure detected \u2014 cannot create device endpoint. Reduce entities on other bridges or increase the Node.js heap size (NODE_OPTIONS=--max-old-space-size=1024)."
+        "Memory pressure detected, cannot create device endpoint. Reduce entities on other bridges or increase the Node.js heap size (NODE_OPTIONS=--max-old-space-size=1024)."
       );
       this._failedEntities.push({
         entityId,
-        reason: "Skipped due to memory pressure \u2014 reduce entities or increase heap size"
+        reason: "Skipped due to memory pressure, reduce entities or increase heap size"
       });
       return;
     }
@@ -182902,7 +182862,7 @@ function patchLevelControlTlv() {
     );
   } else {
     logger206.warn(
-      "Failed to patch LevelControl TLV schemas \u2014 field definitions not found. Google Home brightness adjustment may not work."
+      "Failed to patch LevelControl TLV schemas, field definitions not found. Google Home brightness adjustment may not work."
     );
   }
 }