@rubytech/taskmaster 1.0.41 → 1.0.42

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.41",
-  "commit": "7babefc1bdd6098274e3cea46099e0c591d430d7",
-  "builtAt": "2026-02-16T21:38:03.944Z"
+  "version": "1.0.42",
+  "commit": "0bb7245bb438755c6fcb527a5459e21f3c214692",
+  "builtAt": "2026-02-16T22:06:31.514Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/taskmaster",
-  "version": "1.0.41",
+  "version": "1.0.42",
   "description": "AI-powered business assistant for small businesses",
   "publishConfig": {
     "access": "public"

package/taskmaster-docs/USER-GUIDE.md

@@ -526,6 +526,23 @@ The setup page shows a **Status Dashboard** with status indicators for each serv
 
 Each service has a refresh button (circular arrow icon) you can tap to reconnect or restart. Tap the small **(i)** button next to any service to see detailed status information.
 
+### Refresh vs. Re-pair Buttons
+
+The status dashboard has **two different refresh mechanisms** — use the right one to avoid creating unnecessary QR codes:
+
+**Refresh Status button (top of dashboard):**
+- **What it does:** Checks all services and refreshes their connection status
+- **Use when:** WhatsApp shows yellow (linked but disconnected), or any service seems stuck
+- **Does NOT create a new QR code** — just refreshes the existing connection
+
+**Circular arrow next to each service:**
+- **What it does:** Resets that specific service and generates a new QR code (for WhatsApp)
+- **Use when:** You need to completely re-pair WhatsApp from scratch
+- **Creates a new QR code** — you'll need to scan it again
+
+**Rule of thumb:** Try the **Refresh Status** button first. Only use the circular arrow next to WhatsApp if you need to re-pair from scratch.
+
+
 ### WhatsApp Settings
 
 When WhatsApp is connected, you'll see a small gear icon next to the WhatsApp label. Tap it to open the Public Agent Settings panel, which has three options:
@@ -589,8 +606,32 @@ Both views support **auto-follow** (keeps the view scrolled to the latest entrie
 WhatsApp is linked but the connection dropped. This often resolves itself. If not:
 
 1. Go to **http://taskmaster.local:18789/setup**
-2. Tap **"Refresh Status"** — it may reconnect automatically
-3. If still yellow after a minute, tap the circular arrow next to WhatsApp to relink
+2. Tap **"Refresh Status"** (top of dashboard) — it may reconnect automatically
+3. If still yellow after a minute, **then** tap the circular arrow next to WhatsApp to generate a new QR code and re-pair
+
+> **Important:** The top Refresh Status button refreshes the existing connection without creating a new QR code. Only use the WhatsApp circular arrow button if you need to completely re-pair from scratch.
+
+
+
+### WhatsApp messages failing with "No sessions" or "Bad MAC" errors?
+
+The WhatsApp connection for one of your accounts has lost sync. This can happen after a power cut, an unclean shutdown, or when WhatsApp rotates its security keys. Other accounts on the same device are not affected — only the account with the problem stops sending or receiving.
+
+**Try a restart first:**
+
+1. Go to **http://taskmaster.local:18789/setup**
+2. Tap the circular arrow next to **Gateway** to restart it
+3. Wait 30 seconds — if WhatsApp reconnects and turns green, you're done
+
+On a Raspberry Pi, you can also just unplug the device, wait 10 seconds, and plug it back in.
+
+**If restarting doesn't fix it**, the encryption keys are permanently corrupted and need to be cleared:
+
+1. Select the **affected account** from the account dropdown at the top
+2. Tap **"Reset WhatsApp"** (red button) for that account
+3. **On your phone:** WhatsApp → Settings → Linked Devices
+4. **Remove** "Taskmaster" from the list for that number (if present)
+5. **Scan** the new QR code
 
 ### WhatsApp linking keeps failing?