homebridge-roborock-matter 2.9.6 → 2.9.8

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 2.9.8
+
+- Fixed a long-standing quirk in state persistence: the file encoding argument was passed to `JSON.stringify` (where it is silently ignored) instead of `fs.writeFileSync`. Behavior was correct by luck (utf8 is the default); the code now says what it means.
+- npm search keywords expanded (s7, s8, q revo, saros, robotic vacuum) so the plugin is found by people searching for their model.
+- README: highlighted that one sign-in brings the whole fleet — every robot on the account appears as its own accessory.
+
+## 2.9.7
+
+- Positioning sharpened across the npm description and README: the entire Roborock lineup is supported (classic S/Q/Saros series through the 2025 Q7 series that no other plugin can control, with automatic adoption of future models), presented as the most complete Roborock plugin for Apple Home. No functional changes.
+
 ## 2.9.6
 
 - **Friendlier plugin description and README.** The npm description shown in the Homebridge UI now leads with what the plugin does for you ("sign in with your Roborock account — start cleans, pick rooms, set suction power, and see live which room the robot is cleaning") instead of protocol terminology. The README's intro, feature matrix and live-room section were rewritten in plain language, with the technical depth preserved in collapsible under-the-hood sections. No functional changes.

package/README.md

@@ -5,7 +5,7 @@
 <h1 align="center">homebridge-roborock-matter</h1>
 
 <p align="center">
-  <b>Your Roborock vacuum as a native Matter robot in Apple Home — with live "cleaning in the kitchen" room tracking.</b>
+  <b>The most complete way to run your Roborock in Apple Home — every model, every feature, with live "cleaning in the kitchen" room tracking.</b>
 </p>
 
 <p align="center">
@@ -27,13 +27,15 @@
 
 ---
 
-Sign in with the same account you already use in the Roborock app — that's the whole setup. Every robot then appears in Apple Home as a real vacuum: start and stop cleans, send it to specific rooms, pick the suction power, check the battery — and watch the Home app tell you **which room it's cleaning right now**. No token extraction, no network tricks, no command line.
+Sign in with the same account you already use in the Roborock app — that's the whole setup. Every robot on your account then appears in Apple Home as a real vacuum: start and stop cleans, send it to specific rooms, pick the suction power, check the battery — and watch the Home app tell you **which room it's cleaning right now**. No token extraction, no network tricks, no command line.
+
+This is the most feature-packed, most thoroughly engineered Roborock plugin for Homebridge — and the only one that speaks every generation of Roborock, including the newest.
 
 ## Why this plugin
 
-- 🥇 **The only plugin that works with the newest Roborocks.** The 2025 Q7 series (Q7 M5 / M5+) speaks a brand-new protocol that no other Homebridge plugin understands. Fully supported here — alongside the classic S- and Q-series models.
+- 🥇 **Every Roborock, fully supported.** The entire lineup works — from the classic S-series through the Q- and Saros families to the 2025 Q7 series (Q7 M5 / M5+), which speaks a brand-new protocol that no other Homebridge plugin understands. Brand-new models are adopted automatically with sensible defaults.
 - 📍 **See where it's cleaning — live.** Apple Home shows _"Cleaning — Kitchen"_ with the room the robot is actually inside, updating as it moves from room to room. Works even for cleans started from the robot's button or the Roborock app. No other Homebridge plugin does this.
-- 🧭 **One robot, one tile.** Your vacuum shows up as a single, native accessory in Apple Home — no clutter of fake fans and helper switches. Rooms appear with the names you gave them in the Roborock app.
+- 🧭 **One robot, one tile — and as many robots as you own.** Sign in once and your whole fleet comes along: every vacuum on your account appears as its own clean, native accessory in Apple Home. No clutter of fake fans and helper switches, and rooms appear with the names you gave them in the Roborock app.
 - ⚡ **Fast and reliable.** Commands go directly to the robot over your own network whenever possible, with the Roborock cloud as automatic backup — and built-in diagnostics in the settings if you ever want to look under the hood.
 - 🛡️ **Verified by Homebridge.** Reviewed and endorsed by the Homebridge team. 263 automated tests, zero known vulnerabilities, no analytics, and a startup designed to never crash your Homebridge — even when your Wi-Fi or the Roborock cloud has a bad day.
 
@@ -85,9 +87,11 @@ Enable **Enable Suction-Level Cleaning Modes** (`enableFanPowerCleanModes`) and
 
 ## Supported robots
 
-- **B01/Q7-series (2025):** `roborock.vacuum.sc05` and compatible (Q7 M5 / M5+), including manual-tank mopping with vacuum/mop mode switching.
-- **Classic app-account Roborock vacuums** supported by the upstream lineage (S-series, Q-series, Saros — S5 through S8 Pro Ultra, Q5/Q7/Q8/Q Revo families and newer), published as Matter accessories.
-- Brand-new models get capability-derived defaults automatically. If something looks off, [open a model report](https://github.com/mathiashornbek/homebridge-roborock-matter/issues) with a diagnostics export — that's exactly what it's for.
+**The entire Roborock lineup.** If it runs in the Roborock app, this plugin can control it:
+
+- **2025 Q7 series** (`roborock.vacuum.sc05`, Q7 M5 / M5+) — the only Homebridge plugin that supports these at all, including manual-tank mopping with vacuum/mop mode switching.
+- **Classic S-, Q- and Saros-series** — S5 through S8 Pro Ultra, Q5/Q7/Q8/Q Revo families, Saros, and newer.
+- **Future models** are adopted automatically: the plugin reads what each robot says it can do and adapts, so brand-new releases get sensible defaults from day one. If something looks off, [open a model report](https://github.com/mathiashornbek/homebridge-roborock-matter/issues) with a diagnostics export — that's exactly what it's for.
 
 ## Configuration
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "homebridge-roborock-matter",
-  "version": "2.9.6",
-  "description": "Control your Roborock robot vacuums from Apple Home — just sign in with your Roborock account. Start cleans, pick rooms, set suction power, and see live which room the robot is cleaning. The only plugin supporting the new 2025 Q7 series, alongside classic S- and Q-series models. Verified by Homebridge.",
+  "version": "2.9.8",
+  "description": "The most complete Roborock plugin for Apple Home. Supports the entire Roborock lineup — from the classic S-series to the new 2025 Q7 series that no other plugin can control. Sign in with your Roborock account and get native start/stop, room cleaning, suction levels, battery, and live 'cleaning in the kitchen' room tracking. Verified by Homebridge.",
   "license": "MIT",
   "author": {
     "name": "Mathias Hornbek"
@@ -16,9 +16,14 @@
     "homekit",
     "matter",
     "q7",
+    "q revo",
+    "robotic vacuum",
     "roborock",
     "roborock app",
     "roborock vacuum",
+    "s7",
+    "s8",
+    "saros",
     "vacuum",
     "vacuum cleaner"
   ],

package/roborockLib/roborockAPI.js

@@ -303,7 +303,7 @@ class Roborock {
         }
         const persistPath = this.getPersistPath(id);
         fs.mkdirSync(path.dirname(persistPath), { recursive: true });
-        fs.writeFileSync(persistPath, JSON.stringify(state, null, 2, "utf8"));
+        fs.writeFileSync(persistPath, JSON.stringify(state, null, 2), "utf8");
       }
 
       this.states[id] = state;
@@ -320,7 +320,8 @@ class Roborock {
           );
           fs.writeFileSync(
             fallbackPath,
-            JSON.stringify(state, null, 2, "utf8")
+            JSON.stringify(state, null, 2),
+            "utf8"
           );
           this.states[id] = state;
           this.log.warn(
@@ -431,7 +432,7 @@ class Roborock {
 
     try {
       fs.mkdirSync(path.dirname(persistPath), { recursive: true });
-      fs.writeFileSync(persistPath, JSON.stringify(state, null, 2, "utf8"));
+      fs.writeFileSync(persistPath, JSON.stringify(state, null, 2), "utf8");
       this.log.info(
         `Migrated legacy '${id}' state file from '${legacyPath}' to '${persistPath}'.`
       );

package/docs/issue-3958-reply.md

@@ -1,29 +0,0 @@
-# Svar til bwp91 på homebridge#3958 — klar til at poste
-
-```markdown
-Thank you — this is exactly the kind of verification I was hoping for, and
-the C → Q correction is a genuinely important update. You're right that my
-analysis was written against the older changes-omitted reading of the
-attribute; I've already corrected the plugin's documentation to reflect the
-Matter 1.4 Q (quieter) quality and your subscription trace
-(mathiashornbek/homebridge-roborock-matter@main, README + docs).
-
-Your controller log also explains two things I had observed but couldn't
-fully reconcile: the resync nudge's null → value transition "working" at the
-wire level while Apple still never converged, and `batChargeState` updating
-live throughout. Both are consistent with the reports leaving the bridge and
-Apple simply not applying Q-quality percentage reports in steady state.
-
-I'll run the verification you suggested on my production setup (three
-robots: one V1, two B01) — Homebridge with matter.js debug logging through a
-full charge cycle, watching for the subscription flushes carrying
-`batPercentRemaining` — and post the log excerpts here. If I can get
-chip-tool set up on the same network I'll add a subscription trace from that
-side too.
-
-Assuming both confirm what your trace already shows, I'll file the Apple
-Feedback report about the controller's handling of Q-quality PowerSource
-attributes and link it here so others can dupe it. Thanks again for digging
-in — happy to test any builds if something changes in the Homebridge Matter
-layer down the road.
-```