feat: enable image-updates & auto-heal from Telegram via /manage Features (v0.14.0)

Author: dervish666

.claude/structure/bot.yaml

@@ -42,7 +42,7 @@ files:
       - from: src.bot.ignore_command
         items: [ignore_command, ignores_command, IgnoreSelectionState, ignore_similar_callback, ignore_toggle_callback, ignore_all_callback, ignore_done_callback, ignore_cancel_callback]
       - from: src.bot.manage_command
-        items: [manage_command, manage_back_callback, manage_status_callback, manage_resources_callback, manage_server_callback, manage_disks_callback, manage_ignores_callback, manage_ignores_container_callback, manage_mutes_callback, manage_delete_ignore_callback, manage_delete_mute_callback]
+        items: [manage_command, manage_back_callback, manage_status_callback, manage_resources_callback, manage_server_callback, manage_disks_callback, manage_ignores_callback, manage_ignores_container_callback, manage_mutes_callback, manage_delete_ignore_callback, manage_delete_mute_callback, manage_features_callback, feat_image_toggle_callback, feat_heal_open_callback, feat_heal_toggle_callback, feat_heal_save_callback, AutoHealSelectionState]
       - from: src.services.container_control
         items: [ContainerController]
       - from: src.services.diagnostic
@@ -342,6 +342,29 @@ files:
         kind: function
         signature: (mute_manager: MuteManager, server_mute_manager: ServerMuteManager | None, array_mute_manager: ArrayMuteManager | None) -> Callable[[CallbackQuery], Awaitable[None]]
         description: Factory for mdm:* callback (unmutes, re-renders list)
+      - name: AutoHealSelectionState
+        kind: class
+        description: Per-user in-memory container selections while the auto-heal picker is open
+      - name: manage_features_callback
+        kind: function
+        signature: (image_update_monitor: Any = None, auto_heal_config: Any = None) -> Callable[[CallbackQuery], Awaitable[None]]
+        description: Factory for manage:features panel (explains + toggles image updates and auto-heal)
+      - name: feat_image_toggle_callback
+        kind: function
+        signature: (image_updates_config: Any, restart_cb: Callable[[], Awaitable[None]] | None = None) -> Callable[[CallbackQuery], Awaitable[None]]
+        description: Factory for feat:img:on|off (persists image-update flag, restarts to apply)
+      - name: feat_heal_open_callback
+        kind: function
+        signature: (state: ContainerStateManager, auto_heal_config: Any, selection_state: AutoHealSelectionState, protected_containers: list[str] | None = None) -> Callable[[CallbackQuery], Awaitable[None]]
+        description: Factory for feat:heal (opens auto-heal container picker, seeds selection from config)
+      - name: feat_heal_toggle_callback
+        kind: function
+        signature: (state: ContainerStateManager, selection_state: AutoHealSelectionState, protected_containers: list[str] | None = None) -> Callable[[CallbackQuery], Awaitable[None]]
+        description: Factory for fh_tog:<container> (toggles a container in the picker)
+      - name: feat_heal_save_callback
+        kind: function
+        signature: (auto_heal_config: Any, selection_state: AutoHealSelectionState, image_update_monitor: Any = None) -> Callable[[CallbackQuery], Awaitable[None]]
+        description: Factory for fh_save (live-applies auto-heal container list, re-renders features)
     imports:
       - from: src.state
         items: [ContainerStateManager]

.claude/structure/root.yaml

@@ -23,9 +23,23 @@ files:
         items: [create_bot, create_dispatcher, register_setup_wizard]
       - from: src.background
         items: [_BackgroundTasks]
+      - from: src.restart
+        items: [restart_bot]
       - from: src.startup
         items: [start_monitoring]
 
+  restart.py:
+    description: Graceful in-place process restart via os.execv (applies config changes that need a fresh startup).
+    exports:
+      - name: restart_bot
+        kind: function
+        description: Stops polling, optionally broadcasts a notice, then re-execs `python -m src.main`.
+        params: [{name: bot, type: Bot}, {name: dp, type: Dispatcher}, {name: chat_id_store, type: ChatIdStore}, {name: notice, type: "str | None"}]
+        returns: Coroutine
+    imports:
+      - from: src.alerts.manager
+        items: [ChatIdStore]
+
   alert_proxy.py:
     description: AlertManagerProxy for multi-user alert delivery with queuing.
     exports:

CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to UnraidMonitor will be documented in this file.
 
+## [0.14.0] - 2026-06-05
+
+### Added
+- **Features panel in `/manage`** — a new ⚙️ Features section explains image-update detection and auto-heal, and lets you enable them from Telegram instead of editing `config.yaml`
+- **Enable image updates from Telegram** — one tap persists `image_updates.enabled` and restarts the bot to apply it
+- **Auto-heal container picker** — choose which containers get auto-restarted when unhealthy via a tappable picker (protected containers excluded); applies live with no restart, since the running `AutoHealer` shares the config object
+- **Discoverability hint** — the startup card and `/health` now point to `/manage` → ⚙️ Features whenever image updates or auto-heal is off
+
+### Changed
+- `ImageUpdatesConfig` and `AutoHealConfig` gained runtime persistence (`set_enabled` / `set_containers`) mirroring the existing `ResourceConfig`/`UnraidConfig` pattern
+- Extracted a reusable `restart_bot()` helper (`src/restart.py`); the setup-wizard restart paths now use it
+
 ## [0.13.0] - 2026-06-04
 
 ### Added

CLAUDE.md

@@ -17,6 +17,7 @@ src/main.py - Entry point, signal handling, wizard setup (delegates to startup.p
 src/startup.py - start_monitoring() orchestrator, provider/monitor initialization
 src/alert_proxy.py - AlertManagerProxy for multi-user alert delivery with queuing
 src/background.py - _BackgroundTasks tracker for graceful shutdown of monitors
+src/restart.py - restart_bot() graceful in-place process restart via os.execv (applies config that needs a fresh start)
 src/monitor_callbacks.py - Factory functions for monitor alert/mute callbacks
 src/constants.py - Named constants for all configuration defaults and thresholds
 src/config.py - Settings, configuration loading, YAML parsing, ConfigWriter
@@ -91,7 +92,7 @@ src/utils/version_store.py - read/write data/announced_version.json for startup
 
 ## Project Overview
 
-Unraid Server Monitor Bot (v0.13.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.14.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.
 
 **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.
 
@@ -187,7 +188,9 @@ Inline keyboard buttons use `prefix:data` format, parsed with `split(":", 1)` to
 - `res_set:container_name:metric:value` (apply threshold, 0 = reset to default)
 - `mem_kill:container_name`, `mem_restart_yes:container_name`, `mem_restart_no:container_name`, `mem_cancel_kill:container_name`
 - `nl_confirm:action:container` (e.g., `nl_confirm:restart:plex`), `nl_cancel`
-- `manage:section` (e.g., `manage:status`, `manage:resources`, `manage:server`, `manage:disks`, `manage:ignores`, `manage:mutes`, `manage:back`)
+- `manage:section` (e.g., `manage:status`, `manage:resources`, `manage:server`, `manage:disks`, `manage:ignores`, `manage:mutes`, `manage:features`, `manage:back`)
+- `feat:img:on` / `feat:img:off` (enable/disable image updates from /manage → Features; persists + restarts), `feat:heal` (open auto-heal container picker)
+- `fh_tog:container_name` (toggle a container in the auto-heal picker), `fh_save` (live-apply auto-heal container list, no restart)
 - `arr_mute:minutes` (mute array alerts, e.g., `arr_mute:60`)
 - `arr_thresh:metric:current` (show array threshold options, e.g., `arr_thresh:capacity:85`)
 - `arr_set:metric:value` (apply array threshold, e.g., `arr_set:array_usage:90`, 0 = reset to default)

pyproject.toml

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

src/__init__.py

@@ -1 +1 @@
-__version__ = "0.13.0"
+__version__ = "0.14.0"

src/bot/health_command.py

@@ -75,11 +75,15 @@ def build_status_lines(
         lines.append(f"  Memory: {'✅ Running' if memory_monitor.is_running else '🔴 Stopped'}")
     else:
         lines.append("  Memory: ⚪ Disabled")
+    image_updates_off = not image_update_monitor
     if image_update_monitor:
         lines.append(f"  Image updates: {'✅ Running' if image_update_monitor.is_running else '🔴 Stopped'}")
     else:
         lines.append("  Image updates: ⚪ Disabled")
-    if auto_heal_config is not None and auto_heal_config.enabled and auto_heal_config.containers:
+    auto_heal_off = not (
+        auto_heal_config is not None and auto_heal_config.enabled and auto_heal_config.containers
+    )
+    if not auto_heal_off:
         lines.append(f"  Auto-heal: ✅ {len(auto_heal_config.containers)} container(s)")
     else:
         lines.append("  Auto-heal: ⚪ Disabled")
@@ -91,6 +95,10 @@ def build_status_lines(
             lines.append(f"    Array: {'✅' if unraid_array_monitor.is_running else '🔴'}")
     else:
         lines.append("  Unraid: ⚪ Not configured")
+
+    if image_updates_off or auto_heal_off:
+        lines.append("")
+        lines.append("💡 Turn these on in /manage → ⚙️ Features")
     return lines