docs: refresh README and user guide for current features (v0.15.1)

Author: dervish666

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to UnraidMonitor will be documented in this file.
 
+## [0.15.1] - 2026-06-08
+
+### Changed
+- **Documentation refreshed for current features** — the README's "What's New" was still pinned to v0.12.0; replaced it with a v0.15.0 summary, and updated the feature list and command table to reflect the `/manage` Features panel (server/disks/features sections) and per-feature `/model` overrides (`chat`/`diagnose`/`analyze`).
+- **User guide expanded** — added an Optional Features section documenting image-update detection and auto-heal (how to enable from `/manage` → ⚙️ Features and via `config.yaml`), documented per-feature model switching, and added the Features panel to the Manage Dashboard walkthrough.
+- **Data Storage docs** — listed the previously-undocumented `announced_version.json` and `announced_updates.json` files.
+
 ## [0.15.0] - 2026-06-06
 
 Audit remediation release — all 16 items from the June 6 codebase audit (`audit-reports/audit-2026-06-06-1538.md`).

CLAUDE.md

@@ -92,7 +92,7 @@ src/utils/version_store.py - read/write data/announced_version.json for startup
 
 ## Project Overview
 
-Unraid Server Monitor Bot (v0.15.0) - A Docker-based Telegram bot for monitoring Unraid servers. Monitors Docker containers (events, logs, resources) and Unraid server health (CPU, memory, disks, array, UPS). Uses multi-provider LLM support (Anthropic, OpenAI, Ollama) for AI-powered diagnostics and natural language interaction. Sends alerts via Telegram with quick-action buttons.
+Unraid Server Monitor Bot (v0.15.1) - A Docker-based Telegram bot for monitoring Unraid servers. Monitors Docker containers (events, logs, resources) and Unraid server health (CPU, memory, disks, array, UPS). Uses multi-provider LLM support (Anthropic, OpenAI, Ollama) for AI-powered diagnostics and natural language interaction. Sends alerts via Telegram with quick-action buttons.
 
 **Version string lives in TWO places** — `pyproject.toml` (`version`) and `src/__init__.py` (`__version__`). Both must be bumped together on release; `tests/test_version.py` guards against drift. `BOT_VERSION` (in `src/bot/health_command.py`) resolves from installed package metadata when available, else falls back to `src.__version__` — the package is not installed in the Docker image, so the `__version__` fallback is what runs in production.
 

README.md

@@ -18,15 +18,16 @@ A Telegram bot for monitoring Docker containers and Unraid servers. Get real-tim
 - **Memory Pressure Management** - Automatic container priority handling during high memory
 - **Mute System** - Temporarily silence alerts per container, server, or array
 - **Natural Language Chat** - Ask questions naturally instead of using commands
-- **Interactive Dashboard** - `/manage` hub for status, resources, ignores, and mutes
+- **Interactive Dashboard** - `/manage` hub for status, resources, server, disks, ignores, mutes, and a Features panel to toggle optional monitors
 - **Sectioned Help** - `/help` with navigable category buttons instead of a text wall
 
-## What's New in v0.12.0
+## What's New in v0.15.0
 
-- **Image-update detection** - Opt-in daily digest of containers with newer images available, with per-container Pull buttons (`image_updates.enabled: true`)
-- **Auto-heal** - Opt-in automatic restart of containers that fail their Docker HEALTHCHECK, with a storm guard that gives up after configurable retries (`auto_heal.containers: [...]`)
-- **Richer startup message** - On first boot after an upgrade, shows a "What's new" summary so you always know what changed
-- **CI test pipeline** - Tests, lint, and type-check now run automatically on every push and pull request
+- **Toggle optional features from Telegram** - `/manage` → ⚙️ Features enables image-update detection and picks auto-heal containers without editing `config.yaml`
+- **Alert-context-aware diagnostics** - `/diagnose` now knows which alert fired (crash / errors / restart-loop / high-usage) and gathers full container state, for far more accurate root-cause analysis
+- **Properly formatted AI replies** - Bold, italics, headings, and code blocks now render correctly in Telegram instead of showing literal `*` characters
+- **Friendlier natural-language chat** - Plays along with creative on-topic requests ("status as a captain's log", "roast my containers") while staying grounded in real stats
+- **Reliability & security hardening** - Auto-heal retries persist correctly, image-update alerts no longer repeat after a restart, and API error bodies are redacted in all paths (full June 6 audit remediation)
 
 See the [changelog](CHANGELOG.md) for full details.
 
@@ -429,9 +430,10 @@ auto_heal:
 |---------|-------------|
 | `/setup` | Re-run the setup wizard (merges with existing config) |
 | `/cancel` | Exit the setup wizard mid-flow |
-| `/manage` | Interactive dashboard — status, resources, ignores, mutes |
+| `/manage` | Interactive dashboard — status, resources, server, disks, ignores, mutes, features |
 | `/health` | Bot version, uptime, and monitor status |
-| `/model` | Switch LLM provider and model at runtime |
+| `/model` | Switch the global LLM provider and model at runtime |
+| `/model <feature> <model>` | Per-feature model override (`chat`, `diagnose`, `analyze`); `default` resets to global |
 | `/help` | Browse commands by category with navigation buttons |
 
 ### Natural Language Chat
@@ -611,12 +613,14 @@ config/
 └── .env                  # Environment variables (secrets)
 
 data/
-├── ignored_errors.json   # Ignore patterns
-├── mutes.json            # Container mutes
-├── server_mutes.json     # Server mutes
-├── array_mutes.json      # Array mutes
-├── model_selection.json  # Active LLM provider/model choice
-└── chat_ids.json         # Persistent Telegram chat IDs for alert delivery across restarts
+├── ignored_errors.json     # Ignore patterns
+├── mutes.json              # Container mutes
+├── server_mutes.json       # Server mutes
+├── array_mutes.json        # Array mutes
+├── model_selection.json    # Active LLM provider/model choice
+├── chat_ids.json           # Persistent Telegram chat IDs for alert delivery across restarts
+├── announced_version.json  # Last-announced version (gates the startup "What's new" message)
+└── announced_updates.json  # Image-update dedup map (stops restarts re-announcing the same update)
 ```
 
 ---

docs/user-guide.md

@@ -12,6 +12,7 @@ This guide walks you through everything the bot can do, from first-run setup to
 - [Unraid Server Monitoring](#unraid-server-monitoring)
 - [Alert Control](#alert-control)
 - [AI Features](#ai-features)
+- [Optional Features](#optional-features)
 - [Tips & Best Practices](#tips--best-practices)
 
 ---
@@ -293,6 +294,7 @@ You can also manage ignores through the `/manage` dashboard (see below).
 - **💾 Disks** — Disk status
 - **📝 Manage Ignores** — Browse and delete ignore patterns
 - **🔕 Manage Mutes** — Browse and remove active mutes
+- **⚙️ Features** — Turn optional monitors on or off (see [Optional Features](#optional-features))
 
 Each sub-view includes per-item **🗑** delete buttons and a **⬅️ Back** button to return to the dashboard.
 
@@ -330,7 +332,69 @@ Follow-up questions work too. After asking about a container, you can say "resta
 2. Choose a model from the list
 3. Models without tool support are marked "(no tools)" — NL chat actions may be limited
 
-Your selection is persisted across bot restarts.
+You can also type the choice directly:
+
+- **`/model sonnet`** — set the global default model (family names `sonnet`, `haiku`, `opus` resolve to the latest available release)
+- **`/model chat sonnet`** — use a different model just for natural-language chat
+- **`/model diagnose haiku`** — use a cheaper model for `/diagnose`
+- **`/model analyze haiku`** — use a cheaper model for ignore-pattern generation
+- **`/model chat default`** — reset a feature back to the global default
+
+Per-feature overrides let you spend on a capable model where it matters (chat) and a cheap one where it doesn't (pattern analysis). Your selection is persisted across bot restarts.
+
+---
+
+## Optional Features
+
+Two monitors are off by default. You can turn them on from Telegram — open **`/manage`** and tap **⚙️ Features** — or by editing `config.yaml`.
+
+### Image-Update Detection
+
+Checks once a day whether a newer image is available for your containers, then sends a single digest listing what's outdated, each with a one-tap **Pull** button.
+
+**Enable it:** `/manage` → **⚙️ Features** → **✅ Enable image updates**. Because the check only runs at startup, the bot restarts itself to apply the change.
+
+What you'll see:
+
+```
+🔄 Image updates available (3)
+
+• radarr — linuxserver/radarr:latest
+• sonarr — linuxserver/sonarr:latest
+• plex — plexinc/pms-docker:latest
+
+[⬇️ Pull radarr] [⬇️ Pull sonarr] [⬇️ Pull plex]
+```
+
+Tapping **Pull** runs the same confirm-then-recreate flow as `/pull`, preserving all container settings. The same update isn't re-announced after a restart.
+
+**In `config.yaml`:**
+
+```yaml
+image_updates:
+  enabled: true
+  poll_interval_hours: 24   # minimum 1
+```
+
+### Auto-Heal
+
+Automatically restarts a container when it reports an unhealthy Docker HEALTHCHECK — useful for apps that occasionally wedge but recover on a restart. A **storm guard** stops restart loops: after `max_restarts` attempts within `window_minutes`, it gives up and sends an escalation alert instead of restarting forever. Protected containers are never auto-healed.
+
+**Enable it:** `/manage` → **⚙️ Features** → **🩹 Configure auto-heal**, then tap to select which containers should be healed. Tap **💾 Save** — this applies live, with no restart.
+
+**In `config.yaml`:**
+
+```yaml
+auto_heal:
+  enabled: true
+  containers:
+    - radarr
+    - sonarr
+  max_restarts: 3       # give up after this many restarts in the window
+  window_minutes: 60    # rolling window for the restart count
+```
+
+When auto-heal gives up on a container, you get an alert so you can investigate manually rather than the bot silently looping.
 
 ---
 

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unraid-monitor-bot"
-version = "0.15.0"
+version = "0.15.1"
 requires-python = ">=3.11"
 dependencies = [
     "docker>=7.0.0,<8.0.0",

src/__init__.py

@@ -1 +1 @@
-__version__ = "0.15.0"
+__version__ = "0.15.1"