homebridge-mynest 2.1.0 → 2.1.1

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to this project are documented here. From the first release onward, [release-please](https://github.com/googleapis/release-please) owns this file — do not hand-edit version headings after `0.1.0` ships.
 
+## [2.1.1](https://github.com/tbaur/homebridge-mynest/compare/v2.1.0...v2.1.1) (2026-10-26)
+
+
+### Bug Fixes
+
+* log raw Protect REST fields at debug, not on every arrival ([#69](https://github.com/tbaur/homebridge-mynest/issues/69)) ([44c7cd9](https://github.com/tbaur/homebridge-mynest/commit/44c7cd95c6502047eaf3b9501a861d3085af8c85))
+* stop faulting temperature sensors when the house is quiet ([#71](https://github.com/tbaur/homebridge-mynest/issues/71)) ([793601c](https://github.com/tbaur/homebridge-mynest/commit/793601c9a673d7ad5debf6eac220c473f6683387))
+
 ## [2.1.0](https://github.com/tbaur/homebridge-mynest/compare/v2.0.2...v2.1.0) (2026-10-26)
 
 

package/README.md

@@ -108,8 +108,8 @@ The [detailed documentation](docs/README-DETAILED.md#full-configuration-referenc
 1. **Authentication error:** token missing, truncated, Google JWT/`ya29.`, or revoked. Capture a fresh Nest Account token ([docs/AUTH.md](docs/AUTH.md)).
 2. **Thermostat missing:** modern thermostats are Observe-only on some accounts. Enable `debug` for stream detail.
 3. **Eco / setpoint changes snap back:** enable **Allow thermostat control**.
-4. **Protect smoke/CO shows a fault:** REST has not supplied that sensor's number, or the REST feed is stale. The tile stays. A line `REST topaz auto_away=... smoke_status=... co_status=...` is the raw reading, including when the summary sentence did not change.
-5. **No occupancy, or a room that stays Occupied:** occupancy is Nest's `auto_away` inverted (false means Occupied), not motion. It is omitted for a battery Protect, when `auto_away` is missing, or when `exposeProtectOccupancy` is off. A stuck Occupied is that boolean staying false. The `REST topaz` line shows the raw value each time a Protect object arrives.
+4. **Protect smoke/CO shows a fault:** REST has not supplied that sensor's number, or the REST feed is stale. The tile stays. With `debug` on, a `REST topaz` line shows the raw `smoke_status` and `co_status` Nest sent.
+5. **No occupancy, or a room that stays Occupied:** occupancy is Nest's `auto_away` inverted (false means Occupied), not motion. It is omitted for a battery Protect, when `auto_away` is missing, or when `exposeProtectOccupancy` is off. A stuck Occupied is that boolean staying false. The Protect's summary line, such as `Zone One Protect: Smoke ok, CO ok, Occupied`, shows the change when it happens.
 
 The [full troubleshooting list](docs/README-DETAILED.md#troubleshooting) covers more cases, including a stuck Home app tile.
 

package/dist/accessories/temperature-sensor.js

@@ -28,7 +28,7 @@ class TemperatureSensorAccessory extends base_1.NestAccessory {
         // No temperature yet is not a live 0 °C. HAP's default for this
         // characteristic is 0, and 0 is inside the legal range, so the fault is
         // what tells Home the number is not a reading. A later real 0 °C clears it.
-        this.binder.bind(this.#service, Characteristic.StatusFault, () => (this.state.isObserveStale === true || this.state.temperatureC === undefined || this.isUnreported
+        this.binder.bind(this.#service, Characteristic.StatusFault, () => (this.state.temperatureC === undefined || this.isUnreported
             ? Characteristic.StatusFault.GENERAL_FAULT
             : Characteristic.StatusFault.NO_FAULT));
         this.binder.bind(this.#service, Characteristic.CurrentTemperature, () => this.state.temperatureC);

package/dist/api/transport.d.ts

@@ -33,11 +33,6 @@ export interface NestTransportOptions {
      * on). Absent on callers that only have the merged map.
      */
     onBuckets: (buckets: BucketMap, updatedKeys?: readonly string[]) => void;
-    /**
-     * Called when decoded Observe device traits have been missing for
-     * {@link OBSERVE_DEVICE_DATA_STALE_MS}, and again when one arrives.
-     */
-    onObserveDeviceData?: (stale: boolean) => void;
     /**
      * Called when a new Observe connection is about to open.
      *
@@ -78,11 +73,6 @@ export interface NestTransportOptions {
     statusHeartbeatMs?: number;
     observeSilenceCheckMs?: number;
     forbiddenReprobeMs?: number;
-    /**
-     * How long with no decoded device trait before temperature sensors fault.
-     * Defaults to {@link OBSERVE_DEVICE_DATA_STALE_MS}. Tests set a short value.
-     */
-    observeDataStaleMs?: number;
     /** Injected REST subscribe breaker (tests); defaults to a fresh instance. */
     restCircuitBreaker?: CircuitBreaker;
     /** Injected `app_launch` breaker (tests); defaults to a fresh instance. */

package/dist/api/transport.js

@@ -74,8 +74,6 @@ class NestTransport {
     #lastObserveFrameAt = null;
     /** Decoded `DEVICE_` traits in the Observe session that is open now. */
     #decodedDeviceTraitsThisSession = 0;
-    #observeDataStale = false;
-    #observeDataStaleTimer = null;
     #loopRestartTimers = new Map();
     #observeSessionOpen = false;
     #restLoopRunning = false;
@@ -251,7 +249,6 @@ class NestTransport {
         // default `--unhandled-rejections=throw` — taking every other plugin down.
         this.#startLoop('Observe', () => this.#runObserveLoop());
         this.#startLoop('REST', () => this.#runSubscribeLoop());
-        this.#scheduleObserveDataStale();
         if (this.#options.statusHeartbeatEnabled !== false) {
             this.#startStatusHeartbeat();
         }
@@ -331,10 +328,6 @@ class NestTransport {
             this.#observeStartupWarnTimer = null;
         }
         this.#clearRestAlarmFeedStaleTimer();
-        if (this.#observeDataStaleTimer) {
-            clearTimeout(this.#observeDataStaleTimer);
-            this.#observeDataStaleTimer = null;
-        }
         for (const timer of this.#loopRestartTimers.values()) {
             clearTimeout(timer);
         }
@@ -647,45 +640,15 @@ class NestTransport {
         if (status?.code !== undefined && status.code !== 0) {
             this.#options.log.debug(`Observe stream reported status ${status.code}${status.message ? `: ${status.message}` : ''}`);
         }
+        // Observe sends device traits only on change, so a quiet house can go a
+        // long time without one. This counts them only to judge a session productive.
         if (traits.some((trait) => trait.resourceId.startsWith(classify_1.OBSERVE_DEVICE_PREFIX))) {
-            this.#noteDecodedDeviceTrait();
+            this.#decodedDeviceTraitsThisSession++;
         }
         if (traits.length > 0) {
             this.#options.onTraits(traits);
         }
     }
-    /** A decoded device trait is the only Observe event that means the house is live. */
-    #noteDecodedDeviceTrait() {
-        this.#decodedDeviceTraitsThisSession++;
-        if (this.#observeDataStale) {
-            this.#observeDataStale = false;
-            this.#options.log.info('Observe: device updates resumed');
-            this.#options.onObserveDeviceData?.(false);
-        }
-        this.#scheduleObserveDataStale();
-    }
-    /**
-     * Mark temperature sensors faulted if this long passes with no decoded
-     * device trait. Thermostats keep their last values.
-     *
-     * Catalog frames still increment `#observeFrames` and would otherwise keep
-     * the stream looking healthy.
-     */
-    #scheduleObserveDataStale() {
-        if (this.#observeDataStaleTimer) {
-            clearTimeout(this.#observeDataStaleTimer);
-        }
-        this.#observeDataStaleTimer = setTimeout(() => {
-            this.#observeDataStaleTimer = null;
-            if (this.#isStopped || this.#observeDataStale) {
-                return;
-            }
-            this.#observeDataStale = true;
-            this.#options.log.warn('Observe: no device updates for 10 min, temperature sensors marked faulted');
-            this.#options.onObserveDeviceData?.(true);
-        }, this.#options.observeDataStaleMs ?? settings_1.OBSERVE_DEVICE_DATA_STALE_MS);
-        this.#observeDataStaleTimer.unref?.();
-    }
     /**
      * Run a transport loop, and start it again if it throws.
      *

package/dist/platform.js

@@ -119,8 +119,6 @@ class MyNestPlatform {
     #pendingUpdate = null;
     #pendingChangedIds = null;
     #bucketsChanged = false;
-    /** True after 10 minutes with no decoded Observe device trait. */
-    #observeDeviceDataStale = false;
     #isShuttingDown = false;
     #hasFatal = false;
     #startedAt = 0;
@@ -264,11 +262,6 @@ class MyNestPlatform {
             log: this.#log,
             onTraits: (traits) => this.#applyTraits(traits),
             onBuckets: (buckets, updatedKeys) => this.#applyBuckets(buckets, updatedKeys),
-            onObserveDeviceData: (stale) => {
-                this.#observeDeviceDataStale = stale;
-                this.#bucketsChanged = true;
-                this.#scheduleUpdate();
-            },
             onObserveSessionStart: () => this.#beginObserveSnapshot(),
             onFatal: (error) => this.#handleFatal(error),
             onCircuitOpen: () => diagnostics?.breakerTrip(),
@@ -592,7 +585,7 @@ class MyNestPlatform {
             const topaz = value;
             const knownName = this.#lastInventory?.protects.get(id)?.identity.name;
             const description = (0, classify_1.cleanName)(topaz.description);
-            this.#log.info((0, protect_state_1.formatTopazArrival)(topaz, knownName ?? description ?? id));
+            this.#log.debug((0, protect_state_1.formatTopazArrival)(topaz, knownName ?? description ?? id));
         }
     }
     /** Collapse a burst of transport updates into one HomeKit refresh. */
@@ -633,7 +626,6 @@ class MyNestPlatform {
             buckets: this.#buckets,
             ignoredDeviceIds: this.#config.ignoredDeviceIds,
             restAlarmFeedAvailable: isFeedAvailable,
-            observeDataStale: this.#observeDeviceDataStale,
         });
         this.#lastInventory = inventory;
         // A reconnect snapshot names every device; a typical patch names one.
@@ -1146,7 +1138,6 @@ class MyNestPlatform {
                 buckets: this.#buckets,
                 ignoredDeviceIds: this.#config.ignoredDeviceIds,
                 restAlarmFeedAvailable: this.#transport?.status.isRestAlarmFeedAvailable ?? false,
-                observeDataStale: this.#observeDeviceDataStale,
             })
             : null);
         if (inventory) {

package/dist/settings.d.ts

@@ -175,15 +175,6 @@ export declare const OBSERVE_CONNECT_TIMEOUT_MS = 30000;
  * the failure mode that leaves HomeKit showing stale temperatures indefinitely.
  */
 export declare const OBSERVE_IDLE_TIMEOUT_MS: number;
-/**
- * How long Observe may go without a decoded device trait before temperature
- * sensors are marked StatusFault.
- *
- * Thermostats do not get StatusFault in this HAP build. They keep their last
- * values, and the transport logs the gap. Catalog frames and a socket that
- * stays open do not count.
- */
-export declare const OBSERVE_DEVICE_DATA_STALE_MS: number;
 /** Delay before the first reconnect attempt after a transport drops. */
 export declare const RECONNECT_BASE_MS = 5000;
 /** Upper bound on the reconnect backoff. */

package/dist/settings.js

@@ -15,8 +15,8 @@
  * nothing external will tell you when it changes.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SETPOINT_STEP_C = exports.MAX_SETPOINT_C = exports.MIN_SETPOINT_C = exports.PROTECT_OCCUPANCY_HOLD_OFF_SEC = exports.MAX_DIAGNOSTICS_INTERVAL_SEC = exports.MIN_DIAGNOSTICS_INTERVAL_SEC = exports.REDISCOVERY_INTERVAL_MS = exports.MAX_RESPONSE_BYTES = exports.MIN_RETRY_AFTER_MS = exports.MAX_RETRY_AFTER_MS = exports.OBSERVE_SILENCE_CHECK_MS = exports.FRAME_DECODE_FAILURE_RATIO = exports.FRAME_DECODE_WINDOW = exports.STATUS_HEARTBEAT_MS = exports.LOOP_FAILURE_WARN_EVERY = exports.BATCH_UPDATE_MAX_ATTEMPTS = exports.MAX_REQUEST_ATTEMPTS = exports.SESSION_EXPIRY_MARGIN_MS = exports.SESSION_REFRESH_MS = exports.FORBIDDEN_REPROBE_MS = exports.FORBIDDEN_FATAL_THRESHOLD = exports.OBSERVE_SNAPSHOT_ABANDON_MS = exports.OBSERVE_SNAPSHOT_SETTLE_MS = exports.OBSERVE_STARTUP_WARN_MS = exports.MIN_SUBSCRIBE_CYCLE_MS = exports.RECONNECT_MAX_MS = exports.RECONNECT_BASE_MS = exports.OBSERVE_DEVICE_DATA_STALE_MS = exports.OBSERVE_IDLE_TIMEOUT_MS = exports.OBSERVE_CONNECT_TIMEOUT_MS = exports.OBSERVE_PING_INTERVAL_MS = exports.OBSERVE_SESSION_MS = exports.REST_RESPONSE_STALE_MS = exports.REST_PROOF_OF_LIFE_MS = exports.REST_ALARM_FEED_STALE_MS = exports.SUBSCRIBE_IDLE_MIN_ELAPSED_RATIO = exports.SUBSCRIBE_TIMEOUT_MS = exports.THERMOSTAT_WRITE_ECHO_MAX_MS = exports.BATCH_UPDATE_TIMEOUT_MS = exports.APP_LAUNCH_TIMEOUT_MS = exports.SESSION_TIMEOUT_MS = exports.APP_LAUNCH_BUCKET_TYPES = exports.WEB_APP_VERSION = exports.USER_AGENT = exports.MANUFACTURER = exports.GLOBAL_ECO_DISPLAY_NAME = exports.GLOBAL_ECO_DEVICE_ID = exports.UUID_PREFIX = exports.PLATFORM_NAME = exports.PLUGIN_NAME = void 0;
-exports.REPORTED_TEMPERATURE_STEP_C = exports.MAX_REPORTED_TEMPERATURE_C = exports.MIN_REPORTED_TEMPERATURE_C = exports.MIN_SETPOINT_SPAN_C = exports.DEFAULT_SETPOINT_SPAN_C = exports.DEFAULT_SETPOINT_C = void 0;
+exports.DEFAULT_SETPOINT_C = exports.SETPOINT_STEP_C = exports.MAX_SETPOINT_C = exports.MIN_SETPOINT_C = exports.PROTECT_OCCUPANCY_HOLD_OFF_SEC = exports.MAX_DIAGNOSTICS_INTERVAL_SEC = exports.MIN_DIAGNOSTICS_INTERVAL_SEC = exports.REDISCOVERY_INTERVAL_MS = exports.MAX_RESPONSE_BYTES = exports.MIN_RETRY_AFTER_MS = exports.MAX_RETRY_AFTER_MS = exports.OBSERVE_SILENCE_CHECK_MS = exports.FRAME_DECODE_FAILURE_RATIO = exports.FRAME_DECODE_WINDOW = exports.STATUS_HEARTBEAT_MS = exports.LOOP_FAILURE_WARN_EVERY = exports.BATCH_UPDATE_MAX_ATTEMPTS = exports.MAX_REQUEST_ATTEMPTS = exports.SESSION_EXPIRY_MARGIN_MS = exports.SESSION_REFRESH_MS = exports.FORBIDDEN_REPROBE_MS = exports.FORBIDDEN_FATAL_THRESHOLD = exports.OBSERVE_SNAPSHOT_ABANDON_MS = exports.OBSERVE_SNAPSHOT_SETTLE_MS = exports.OBSERVE_STARTUP_WARN_MS = exports.MIN_SUBSCRIBE_CYCLE_MS = exports.RECONNECT_MAX_MS = exports.RECONNECT_BASE_MS = exports.OBSERVE_IDLE_TIMEOUT_MS = exports.OBSERVE_CONNECT_TIMEOUT_MS = exports.OBSERVE_PING_INTERVAL_MS = exports.OBSERVE_SESSION_MS = exports.REST_RESPONSE_STALE_MS = exports.REST_PROOF_OF_LIFE_MS = exports.REST_ALARM_FEED_STALE_MS = exports.SUBSCRIBE_IDLE_MIN_ELAPSED_RATIO = exports.SUBSCRIBE_TIMEOUT_MS = exports.THERMOSTAT_WRITE_ECHO_MAX_MS = exports.BATCH_UPDATE_TIMEOUT_MS = exports.APP_LAUNCH_TIMEOUT_MS = exports.SESSION_TIMEOUT_MS = exports.APP_LAUNCH_BUCKET_TYPES = exports.WEB_APP_VERSION = exports.USER_AGENT = exports.MANUFACTURER = exports.GLOBAL_ECO_DISPLAY_NAME = exports.GLOBAL_ECO_DEVICE_ID = exports.UUID_PREFIX = exports.PLATFORM_NAME = exports.PLUGIN_NAME = void 0;
+exports.REPORTED_TEMPERATURE_STEP_C = exports.MAX_REPORTED_TEMPERATURE_C = exports.MIN_REPORTED_TEMPERATURE_C = exports.MIN_SETPOINT_SPAN_C = exports.DEFAULT_SETPOINT_SPAN_C = void 0;
 exports.resolveEndpoints = resolveEndpoints;
 exports.appLaunchUrl = appLaunchUrl;
 /** Name used to register the plugin with Homebridge (must match package.json name). */
@@ -198,15 +198,6 @@ exports.OBSERVE_CONNECT_TIMEOUT_MS = 30_000;
  * the failure mode that leaves HomeKit showing stale temperatures indefinitely.
  */
 exports.OBSERVE_IDLE_TIMEOUT_MS = 10 * 60_000;
-/**
- * How long Observe may go without a decoded device trait before temperature
- * sensors are marked StatusFault.
- *
- * Thermostats do not get StatusFault in this HAP build. They keep their last
- * values, and the transport logs the gap. Catalog frames and a socket that
- * stays open do not count.
- */
-exports.OBSERVE_DEVICE_DATA_STALE_MS = exports.OBSERVE_IDLE_TIMEOUT_MS;
 /** Delay before the first reconnect attempt after a transport drops. */
 exports.RECONNECT_BASE_MS = 5_000;
 /** Upper bound on the reconnect backoff. */

package/dist/state/protect-state.d.ts

@@ -72,11 +72,10 @@ export declare function readProtectState(options: {
     restAlarmFeedAvailable?: boolean;
 }): ProtectState;
 /**
- * One info line for a REST Protect object, including when HomeKit's sentence
- * would be unchanged.
+ * One debug line with the raw REST fields behind a Protect's summary.
  *
- * `auto_away` false is Occupied. A stuck Occupied is invisible if the plugin
- * only logs the summary when that word changes.
+ * `auto_away` false is Occupied. The accessory's info summary already shows
+ * the readable state on change; this is for checking what Nest actually sent.
  */
 export declare function formatTopazArrival(topaz: TopazBucket, label: string): string;
 /** A user-facing explanation for why occupancy is or is not published. */

package/dist/state/protect-state.js

@@ -175,11 +175,10 @@ function readPlausibleRestTemperature(value) {
         : undefined;
 }
 /**
- * One info line for a REST Protect object, including when HomeKit's sentence
- * would be unchanged.
+ * One debug line with the raw REST fields behind a Protect's summary.
  *
- * `auto_away` false is Occupied. A stuck Occupied is invisible if the plugin
- * only logs the summary when that word changes.
+ * `auto_away` false is Occupied. The accessory's info summary already shows
+ * the readable state on change; this is for checking what Nest actually sent.
  */
 function formatTopazArrival(topaz, label) {
     const autoAway = typeof topaz.auto_away === 'boolean' ? String(topaz.auto_away) : 'absent';

package/dist/state/registry.d.ts

@@ -27,12 +27,6 @@ export interface BuildInventoryOptions {
      * values. Defaults to true.
      */
     restAlarmFeedAvailable?: boolean;
-    /**
-     * When true, `isObserveStale` is set on thermostats and temperature sensors.
-     * Only temperature sensors publish Status Fault. Thermostats keep their last
-     * values. Defaults to false.
-     */
-    observeDataStale?: boolean;
 }
 /**
  * Merge both transports into the device list the platform publishes.

package/dist/state/registry.js

@@ -36,7 +36,7 @@ const REST_DEVICE_BUCKETS = [
  * be exercised against fixtures without any transport.
  */
 function buildInventory(options) {
-    const { observe, buckets, ignoredDeviceIds, restAlarmFeedAvailable = true, observeDataStale = false, } = options;
+    const { observe, buckets, ignoredDeviceIds, restAlarmFeedAvailable = true, } = options;
     const kinds = collectDeviceKinds(observe, buckets);
     const roomNames = mergeRoomNames((0, classify_1.collectObserveRoomNames)(observe), readRestRoomNames(buckets));
     const comfortTemperatures = readComfortTemperatures(observe, buckets, kinds);
@@ -50,7 +50,6 @@ function buildInventory(options) {
             deviceId,
             roomNames,
             restAlarmFeedAvailable,
-            observeDataStale,
         };
         let device;
         switch (kind) {
@@ -236,10 +235,9 @@ function buildThermostat(context, comfortTemperatureC) {
         ? (0, thermostat_state_1.readThermostatFromObserve)(observe, resourceId, { comfortTemperatureC })
         : undefined;
     const fromRest = (0, thermostat_state_1.readThermostatFromRest)(buckets.shared?.[deviceId], buckets.device?.[deviceId]);
-    const state = (0, thermostat_state_1.mergeThermostatState)(fromObserve, fromRest);
     return {
         identity: buildIdentity(context, 'thermostat'),
-        state: context.observeDataStale ? { ...state, isObserveStale: true } : state,
+        state: (0, thermostat_state_1.mergeThermostatState)(fromObserve, fromRest),
     };
 }
 function buildProtect(context) {
@@ -256,14 +254,13 @@ function buildProtect(context) {
 }
 function buildTemperatureSensor(context) {
     const { observe, buckets, deviceId } = context;
-    const state = (0, sensor_state_1.readTemperatureSensorState)({
-        state: observe,
-        resourceId: (0, classify_1.toResourceId)(deviceId),
-        kryptonite: buckets.kryptonite?.[deviceId],
-    });
     return {
         identity: buildIdentity(context, 'temperature_sensor'),
-        state: context.observeDataStale ? { ...state, isObserveStale: true } : state,
+        state: (0, sensor_state_1.readTemperatureSensorState)({
+            state: observe,
+            resourceId: (0, classify_1.toResourceId)(deviceId),
+            kryptonite: buckets.kryptonite?.[deviceId],
+        }),
     };
 }
 /** Every device in an inventory, in a stable order, for logging and iteration. */

package/dist/types/device.d.ts

@@ -71,11 +71,6 @@ export interface ThermostatState {
      * Celsius. `TemperatureDisplayUnits` follows this field.
      */
     readonly displayUnit?: 'C' | 'F';
-    /**
-     * True when Observe has produced no decoded device trait for 10 minutes.
-     * Last values stay published.
-     */
-    readonly isObserveStale?: boolean;
 }
 /** Nest's three-level alarm scale, shared by the smoke and CO sensors. */
 export type AlarmLevel = 'ok' | 'warning' | 'emergency';
@@ -137,8 +132,6 @@ export interface TemperatureSensorState {
     /** Percent, when Nest reports one. */
     readonly batteryLevel?: number;
     readonly isBatteryLow?: boolean;
-    /** See {@link ThermostatState.isObserveStale}. */
-    readonly isObserveStale?: boolean;
 }
 /** One device, discriminated by {@link DeviceKind}. */
 export type NestDevice = {

package/docs/README-DETAILED.md

@@ -84,7 +84,7 @@ Unknown power is not a reason to omit occupancy when `auto_away` is already a bo
 
 If REST later goes stale, a last occupancy reading stays published but is marked inactive and faulted.
 
-Every REST object for a Protect logs one info line, `REST topaz auto_away=... smoke_status=... co_status=...`, including when the HomeKit summary sentence did not change. `absent` means Nest did not send that field.
+Each Protect logs a summary at info when its state changes, such as `Zone One Protect: Smoke ok, CO ok, Occupied`. With `debug` on, every REST object for a Protect also logs the raw fields, `REST topaz auto_away=... smoke_status=... co_status=...`. `absent` means Nest did not send that field.
 
 ## Smoke and CO honesty
 
@@ -142,8 +142,8 @@ Each signal covers the whole house. The summary does not name the Protect, so ch
 2. **Thermostat missing.** Modern thermostats are Observe-only on some accounts. With default logging the plugin warns within about a minute if Observe produced no frames, and again every five minutes if a connected stream goes quiet. Set `debug: true` for stream detail. From a git checkout you can also run `npm run verify` against the live account. See [DEVELOPMENT.md](../DEVELOPMENT.md).
 3. **Thermostat in Settings but no room tile.** Remove and re-add the **MyNest** child bridge in the Home app (or whatever you set as **Name**), then assign rooms again. Same-UUID republish does not clear Apple Home's stuck presentation.
 4. **Eco / setpoint changes snap back.** Enable **Allow thermostat control**. With control off, HomeKit can still move the UI (required for tiles), but the plugin does not send the change to Nest and moves the tile back.
-5. **Protect smoke or CO shows a fault.** REST has no number for that sensor yet, or the REST feed is stale. The tile stays. Search the log for `REST topaz` to see the raw `smoke_status` and `co_status`.
-6. **No occupancy, or Occupied in an empty room.** Occupancy is `auto_away` inverted. It is omitted for a battery Protect, a missing `auto_away`, an Observe-only Protect, or `exposeProtectOccupancy` off. A room that stays Occupied has `auto_away=false` on each later `REST topaz` line, or no later line at all. See [Protect occupancy](#protect-occupancy).
+5. **Protect smoke or CO shows a fault.** REST has no number for that sensor yet, or the REST feed is stale. The tile stays. Turn on `debug` and search the log for `REST topaz` to see the raw `smoke_status` and `co_status`.
+6. **No occupancy, or Occupied in an empty room.** Occupancy is `auto_away` inverted. It is omitted for a battery Protect, a missing `auto_away`, an Observe-only Protect, or `exposeProtectOccupancy` off. A room that stays Occupied never logs a later summary with `Unoccupied`. With `debug` on, each `REST topaz` line for it shows `auto_away=false`. See [Protect occupancy](#protect-occupancy).
 
 Restart Homebridge after any `config.json` edit.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-mynest",
   "displayName": "Homebridge My Nest",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Homebridge plugin for Nest thermostats (with Eco Mode), Nest Protect, and Nest Temperature Sensors using a Nest Account access token",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",