@riddix/hamh 2.1.0-alpha.561 → 2.1.0-alpha.563

package/README.md

@@ -170,7 +170,7 @@ Matter Bridge, Multi-Fabric support, Health Monitoring, Bridge Wizard, AirQualit
 | `water_heater` | Thermostat (Heating) | |
 | `automation`, `script`, `scene` | On/Off Switch | |
 
-> 📖 See [Supported Device Types Documentation](https://riddix.github.io/home-assistant-matter-hub/Supported%20Device%20Types/) for details
+> 📖 See [Supported Device Types Documentation](https://riddix.github.io/home-assistant-matter-hub/supported-device-types) for details
 
 ---
 
@@ -209,7 +209,7 @@ This is because these platforms expect robot vacuums to be **standalone Matter d
 
 ### Documentation
 
-For more details, see the [Robot Vacuum Documentation](https://riddix.github.io/home-assistant-matter-hub/Devices/Robot%20Vacuum/).
+For more details, see the [Robot Vacuum Documentation](https://riddix.github.io/home-assistant-matter-hub/devices/robot-vacuum).
 
 </details>
 
@@ -245,7 +245,7 @@ docker run -d \
 ```
 
 > **Note:** All environment variables require the `HAMH_` prefix.
-> See the [Installation Guide](docs/Getting%20Started/Installation.md) for all available options.
+> See the [Installation Guide](https://riddix.github.io/home-assistant-matter-hub/getting-started/installation) for all available options.
 
 For alpha versions, use tag `alpha` instead of `latest`.
 

package/dist/backend/cli.js

@@ -175874,6 +175874,11 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
    *  dispatching the HA action to prevent re-dispatch, but progress
    *  tracking needs the original list for the entire cleaning session. */
   activeAreas = [];
+  /** Diagnostic short-circuit reasons already logged this session.
+   *  updateCurrentRoomFromSensor() is called on every HA state event;
+   *  without this guard a failing path would flood the log. Cleared
+   *  when the vacuum returns to Idle. */
+  loggedShortCircuits = /* @__PURE__ */ new Set();
   async initialize() {
     await super.initialize();
     const homeAssistant = await this.agent.load(HomeAssistantEntityBehavior);
@@ -175902,6 +175907,7 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
         this.trySetCurrentArea(null);
         this.completedAreas.clear();
         this.lastCurrentArea = null;
+        this.loggedShortCircuits.clear();
       } else if (newMode === 1 /* Cleaning */) {
         if (this.activeAreas.length > 0 && this.lastCurrentArea === null) {
           this.trySetCurrentArea(this.activeAreas[0]);
@@ -175912,6 +175918,16 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
       this.updateCurrentRoomFromSensor();
     }
   }
+  /**
+   * Emit a diagnostic INFO log exactly once per cleaning session for a
+   * given short-circuit reason. Prevents log flooding while still
+   * surfacing the silent paths that would otherwise be invisible.
+   */
+  logShortCircuitOnce(reason, message) {
+    if (this.loggedShortCircuits.has(reason)) return;
+    this.loggedShortCircuits.add(reason);
+    logger189.info(message);
+  }
   /**
    * Read the currentRoomEntity sensor and update currentArea + progress
    * to reflect which room the vacuum is actually in right now.
@@ -175920,11 +175936,29 @@ var RvcRunModeServerBase = class extends RvcRunModeServer {
     try {
       const homeAssistant = this.agent.get(HomeAssistantEntityBehavior);
       const currentRoomEntityId = homeAssistant.state.mapping?.currentRoomEntity;
-      if (!currentRoomEntityId) return;
+      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"
+        );
+        return;
+      }
       const stateProvider = this.agent.env.get(EntityStateProvider);
       const roomState = stateProvider.getState(currentRoomEntityId);
-      if (!roomState || !roomState.state) return;
-      if (this.activeAreas.length === 0) return;
+      if (!roomState || !roomState.state) {
+        this.logShortCircuitOnce(
+          "no-state",
+          `currentRoom sensor: no state available for ${currentRoomEntityId}`
+        );
+        return;
+      }
+      if (this.activeAreas.length === 0) {
+        this.logShortCircuitOnce(
+          "no-active-areas",
+          `currentRoom sensor: activeAreas empty while cleaning \u2014 sensor=${currentRoomEntityId} state="${roomState.state}"`
+        );
+        return;
+      }
       const serviceArea = this.agent.get(ServiceAreaBehavior);
       const sensorAttrs = roomState.attributes;
       const segmentId = sensorAttrs.segment_id ?? sensorAttrs.room_id;
@@ -178799,7 +178833,7 @@ var LegacyEndpoint = class _LegacyEndpoint extends EntityEndpoint {
             entityId: effectiveMapping?.entityId ?? entityId,
             cleaningModeEntity: vacuumEntities.cleaningModeEntity
           };
-          logger200.debug(
+          logger200.info(
             `Auto-assigned cleaningMode ${vacuumEntities.cleaningModeEntity} to ${entityId}`
           );
         }
@@ -178809,7 +178843,7 @@ var LegacyEndpoint = class _LegacyEndpoint extends EntityEndpoint {
             entityId: effectiveMapping?.entityId ?? entityId,
             suctionLevelEntity: vacuumEntities.suctionLevelEntity
           };
-          logger200.debug(
+          logger200.info(
             `Auto-assigned suctionLevel ${vacuumEntities.suctionLevelEntity} to ${entityId}`
           );
         }
@@ -178819,7 +178853,7 @@ var LegacyEndpoint = class _LegacyEndpoint extends EntityEndpoint {
             entityId: effectiveMapping?.entityId ?? entityId,
             mopIntensityEntity: vacuumEntities.mopIntensityEntity
           };
-          logger200.debug(
+          logger200.info(
             `Auto-assigned mopIntensity ${vacuumEntities.mopIntensityEntity} to ${entityId}`
           );
         }
@@ -178829,7 +178863,7 @@ var LegacyEndpoint = class _LegacyEndpoint extends EntityEndpoint {
             entityId: effectiveMapping?.entityId ?? entityId,
             currentRoomEntity: vacuumEntities.currentRoomEntity
           };
-          logger200.debug(
+          logger200.info(
             `Auto-assigned currentRoom ${vacuumEntities.currentRoomEntity} to ${entityId}`
           );
         }
@@ -178844,7 +178878,7 @@ var LegacyEndpoint = class _LegacyEndpoint extends EntityEndpoint {
             entityId: effectiveMapping?.entityId ?? entityId,
             cleanAreaRooms
           };
-          logger200.debug(
+          logger200.info(
             `Using ${cleanAreaRooms.length} HA areas via CLEAN_AREA for ${entityId}`
           );
         }