@riddix/hamh 2.1.0-alpha.562 → 2.1.0-alpha.564

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;
@@ -177891,6 +177925,18 @@ var RvcOperationalStateServerBase = class extends RvcOperationalStateServer {
     this.state.operationalError = { errorStateId: ErrorState.NoError };
     await super.initialize();
     const homeAssistant = await this.agent.load(HomeAssistantEntityBehavior);
+    try {
+      const events = this.events;
+      events.operationalError$Changed?.on(() => {
+        logger195.info(
+          `#287 diag[3]: operationalError$Changed fired for ${homeAssistant.entityId}`
+        );
+      });
+    } catch (e) {
+      logger195.warn(
+        `#287 diag[3]: failed to attach operationalError$Changed listener: ${e instanceof Error ? e.message : String(e)}`
+      );
+    }
     this.update(homeAssistant.entity);
     this.reactTo(homeAssistant.onChange, this.update);
   }
@@ -177903,6 +177949,9 @@ var RvcOperationalStateServerBase = class extends RvcOperationalStateServer {
       this.agent
     );
     const previousState = this.state.operationalState;
+    logger195.info(
+      `#287 diag[2]: update() reactor invoked for ${entity.entity_id} \u2014 prevState=${previousState} newState=${newState} nonceBefore=${this.keepaliveNonce}`
+    );
     this.keepaliveNonce = !this.keepaliveNonce;
     const errorStateId = newState === OperationalState4.Error ? ErrorState.Stuck : ErrorState.NoError;
     const operationalError = { errorStateId };
@@ -178799,7 +178848,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 +178858,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 +178868,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 +178878,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 +178893,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}`
           );
         }
@@ -181146,6 +181195,9 @@ var ServerModeVacuumEndpoint = class _ServerModeVacuumEndpoint extends EntityEnd
     this.flushUpdate = debounce6(this.flushPendingUpdate.bind(this), 50);
     this.keepaliveTimer = setInterval(() => {
       if (this.lastState) {
+        logger203.info(
+          `#287 diag[1]: keepalive tick for ${this.entityId} \u2014 scheduling flushUpdate`
+        );
         this.pendingMappedChange = true;
         this.flushUpdate(this.lastState);
       }