@rubytech/taskmaster 1.11.2 → 1.12.1

package/taskmaster-docs/USER-GUIDE.md

@@ -557,6 +557,31 @@ Your assistant can manage who has admin access — the same as using the Admins
 - "Who are my current admins?"
 - "Remove the old number ending in 789 from admins"
 
+### System Administration
+
+Your assistant can check and manage many system settings directly through chat — the same things you'd normally check in the Setup page on the control panel. Think of it as a shortcut: instead of opening the control panel and navigating to the right setting, just ask.
+
+| Capability | Description |
+|------------|-------------|
+| System status | Check gateway health, WhatsApp/iMessage connections, Claude authentication, license, software version |
+| Usage and cost | See how many tokens you've used and what it's costing, broken down by provider |
+| Channel settings | Change the AI model, thinking level, DM policy, or group chat policy for your WhatsApp accounts |
+| Branding | Update your accent or background colour |
+| Public chat | Enable or disable the public chat widget, change the greeting, set visitor verification |
+| Skills | List, create, delete, or toggle skills |
+| Logs | Review system and session logs for troubleshooting |
+
+**Try asking:**
+- "How's the system doing?"
+- "What's my usage this month?"
+- "Is WhatsApp connected?"
+- "Switch WhatsApp to a cheaper model"
+- "Change the accent colour to blue"
+- "Enable public chat"
+- "Show me the recent logs"
+
+> **Note:** Some things still need the control panel: scanning WhatsApp QR codes, uploading logos, WiFi setup, Tailscale remote access, and PIN management. Your assistant will tell you when to open the control panel and where to go.
+
 ### Web Browsing
 
 Your assistant can open and interact with websites in a built-in browser — filling in forms, clicking buttons, and navigating pages. You can watch what it's doing on the **Browser** page in real time, and take over if it needs help (for example, to complete a CAPTCHA or log in to a site).
@@ -1001,6 +1026,21 @@ If the Pi checks pass but the control panel still doesn't load from another devi
 2. **Check you're on the same subnet** — mDNS only works between devices on the same network subnet. It won't work across separate subnets, VLANs, or guest networks. A common cause: the Pi is on Ethernet while your device is on WiFi, and your router assigns them to different subnets. Check by comparing the first three groups of your IP addresses (e.g. if the Pi is `192.168.88.4` and your laptop is `192.168.10.172`, they're on different subnets).
 3. **Contact support** with: what you changed (port/hostname), the output of `hostname`, `grep 127.0.1.1 /etc/hosts`, and `taskmaster daemon status`.
 
+#### Hostname changed to `taskmaster-2.local` (or similar)
+
+If your control panel URL suddenly stops working and you notice the hostname has a `-2` (or `-3`) suffix, the Pi detected a name conflict on the network and renamed itself.
+
+**When this happens:** If you unplug the Ethernet cable while the Pi is already running on WiFi, the Pi briefly had two network connections active at the same time. Its hostname detection saw its own name coming from the Ethernet side and treated it as a conflict, adding a `-2` suffix.
+
+**Fix:**
+
+1. Power the Pi off completely (not just restart — fully power off)
+2. Wait at least 2 minutes (this lets the mDNS name cache clear on all devices on the network)
+3. Power the Pi back on
+4. Access the control panel using your normal URL
+
+**To avoid this in future:** Connect via WiFi first, then remove the Ethernet cable — don't unplug Ethernet while the Pi is running with both cables connected.
+
 ### Static IP Address
 
 You don't need to assign a static IP address — Taskmaster uses a `.local` hostname that resolves automatically via mDNS, even if the IP changes after a reboot or DHCP renewal. You'll always find your control panel at the same `.local` address.
@@ -1467,16 +1507,19 @@ By default, anyone who opens the public chat can start a conversation immediatel
 1. Go to the **Setup** page
 2. Find the **Public Chat** status card
 3. Click the settings icon to open the verification settings modal
-4. Choose a verification method:
+4. Choose an auth mode: **Anonymous** (no verification), **Verified** (must verify before chatting), or **Visitor chooses** (can chat immediately or verify for cross-device continuity)
+5. Select which verification channels to enable — three independent checkboxes:
+
+| Channel | How it works | What you need |
+|---------|-------------|---------------|
+| **WhatsApp** | Verification code sent via WhatsApp | A connected WhatsApp account |
+| **SMS** | Verification code sent by text message | Same [Brevo](https://brevo.com) API key as email, plus prepaid SMS credits in your Brevo account |
+| **Email** | Verification code sent by email | A [Brevo](https://brevo.com) API key and a verified sender (free, no credit card) |
 
-| Method | How it works | What you need |
-|--------|-------------|---------------|
-| **Anonymous** | No verification — visitors chat immediately | Nothing (default) |
-| **Email OTP** | Visitors enter their email, receive a one-time code | A [Brevo](https://brevo.com) API key and a verified sender (free, no credit card). The sender address is configured in Brevo, not in Taskmaster. |
-| **SMS OTP** | Visitors enter their phone number, receive a one-time code | Same [Brevo](https://brevo.com) API key as email, plus prepaid SMS credits in your Brevo account |
+   When both WhatsApp and SMS are enabled, phone verification tries WhatsApp first and falls back to SMS. To use SMS only, uncheck WhatsApp.
 
-5. Enter your provider credentials — add the Brevo API key in the **API Keys** section on the Setup page. The same key serves both email and SMS verification. For SMS, purchase SMS credits in your Brevo dashboard.
-6. Settings auto-save when you leave each field
+6. Enter your provider credentials — add the Brevo API key in the **API Keys** section on the Setup page. The same key serves both email and SMS verification. For SMS, purchase SMS credits in your Brevo dashboard.
+7. Settings auto-save when you change a checkbox or leave a field
 
 Once enabled, visitors must authenticate before they can send their first message. Verified contact details are stored and available to the agent via the `verify_contact` tool, so your assistant knows who it's talking to.