asher-cli 0.1.0__tar.gz → 0.1.1__tar.gz

{asher_cli-0.1.0 → asher_cli-0.1.1}/.gitignore

@@ -216,3 +216,6 @@ __marimo__/
 
 # Streamlit
 .streamlit/secrets.toml
+
+# ZCode editor state
+.zcode/

{asher_cli-0.1.0 → asher_cli-0.1.1}/CLAUDE.md

@@ -43,6 +43,7 @@ asher/
   robot_adapters.py RobotAdapter ABC + LR3/LR4/LR5 subclasses + make_adapter() factory
   mcp_config.py     Claude Desktop config read/write for the /mcp slash command
   mcp_bridge.py     asher-mcp-launch console script — keyring-backed pylitterbot MCP launcher
+  faults.py         check_faults(robot) — model-scoped safety/component fault detection (status enum + per-model attr allowlist; hopper never a fault)
   __main__.py       main() entry point
   commands/
     base.py         Command ABC, SlashCommand, CommandRegistry
@@ -66,6 +67,7 @@ tests/
   test_mcp_config.py      Claude Desktop config read/write
   test_mcp_bridge.py      mcp_bridge launcher credential/subprocess handling
   test_mcp_command.py     /mcp slash command dispatch
+  test_faults.py          check_faults() — safety statuses, attribute faults, graceful degradation
 
 .github/workflows/
   ci.yml            ruff + mypy + pytest on every push/PR
@@ -123,6 +125,11 @@ AsherApp (textual.App)
 ├── #main-area
 │   ├── #log             RichLog — scrollable event/command output
 │   └── #cat-panel       animated ASCII cat sidebar
+│       ├── #cat-fx      animated FX strip
+│       ├── #cat-art     the ASCII cat
+│       ├── #cat-label   mode label (connected / cycling… / fault!)
+│       ├── #cat-status  complementary badges (status, power, cycles, wait time) — no lock/night-light (those are top-row only)
+│       └── #fault-banner  hidden unless check_faults() returns active faults; `d` dismisses
 └── #bottom-dock         bottom dock
     ├── #input-bar / #input-row   command prompt ("> " label + CmdInput)
     └── #hint-bar        shortcut hints / login flow prompts
@@ -135,7 +142,10 @@ LoginScreen (ModalScreen) — available in auth.py but not the primary auth path
 | Method | Purpose |
 |---|---|
 | `_connect_worker()` | `@work` — resolve credentials (keyring → .env → inline login), authenticate |
-| `_refresh_status()` | update all header widgets from robot state |
+| `_refresh_status()` | update all header widgets + cat panel + fault banner from robot state |
+| `_update_cat_panel(robot)` | render `#cat-label` + `#cat-status` (complementary: status, power, cycles, wait); called from `_refresh_status` |
+| `_refresh_faults(robot)` | run `check_faults()`, render `#fault-banner`, log transitions; sets cat mode to `error` while faults active |
+| `_cycling_chip()` / `_start_cycle_timer()` / `_stop_cycle_timer()` / `_tick_cycle()` | `⟳ Cycling M:SS` chip + lazy 1s elapsed timer |
 | `_poll_status_interval()` | `@work` — poll fallback every 300s (5 min); WebSocket is primary |
 | `_tick_cat()` | advances multi-frame cat animation every 0.4s |
 | `_dispatch_command(command, args)` | `@work` — calls `command.run(app, args)` from the registry |

{asher_cli-0.1.0 → asher_cli-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: asher-cli
-Version: 0.1.0
+Version: 0.1.1
 Summary: Terminal dashboard for Litter Robot (LR3/LR4/LR5) via the Whisker cloud API
 License: MIT License
         
@@ -62,6 +62,9 @@ A Claude Code-style terminal dashboard for monitoring and controlling Litter Rob
 
 - Live status bar — unit name, online/offline, drawer fill level, last activity, cat weight
 - Human-readable robot status — translates raw API states into plain English (`Ready`, `Cleaning`, `Cat Detected`, `Drawer Full`, etc.)
+- Real-time cycling indicator with elapsed time (`⟳ Cycling  M:SS`)
+- Fault & safety monitoring — model-scoped in-panel alerts for cat detected, pinch, motor/position/gas faults (LR5: bonnet/laser/drawer); press `d` to dismiss
+- Cat panel with mode label + status badges (status chip, lock, night light, sleep, wait time) under the art
 - Scrollable activity log with timestamps
 - Commands: `clean`, `status`, `lock`, `unlock`, `sleep`, `wake`, `night-light on|off|auto`, `night-light-brightness`, `history`, `export [days|month]`, `help`, `quit`
 - Slash commands for app management: `/login`, `/logout`, `/robots`, `/robot <index|name>`, `/pets`, `/pet <index|name>`, `/cat on|off|color <hex>`, `/refresh [seconds|off]`, `/config`, `/exit`

{asher_cli-0.1.0 → asher_cli-0.1.1}/README.md

@@ -16,6 +16,9 @@ A Claude Code-style terminal dashboard for monitoring and controlling Litter Rob
 
 - Live status bar — unit name, online/offline, drawer fill level, last activity, cat weight
 - Human-readable robot status — translates raw API states into plain English (`Ready`, `Cleaning`, `Cat Detected`, `Drawer Full`, etc.)
+- Real-time cycling indicator with elapsed time (`⟳ Cycling  M:SS`)
+- Fault & safety monitoring — model-scoped in-panel alerts for cat detected, pinch, motor/position/gas faults (LR5: bonnet/laser/drawer); press `d` to dismiss
+- Cat panel with mode label + status badges (status chip, lock, night light, sleep, wait time) under the art
 - Scrollable activity log with timestamps
 - Commands: `clean`, `status`, `lock`, `unlock`, `sleep`, `wake`, `night-light on|off|auto`, `night-light-brightness`, `history`, `export [days|month]`, `help`, `quit`
 - Slash commands for app management: `/login`, `/logout`, `/robots`, `/robot <index|name>`, `/pets`, `/pet <index|name>`, `/cat on|off|color <hex>`, `/refresh [seconds|off]`, `/config`, `/exit`

{asher_cli-0.1.0 → asher_cli-0.1.1}/ROADMAP.md

@@ -21,6 +21,9 @@ Current state, missing functionality, and suggested additions — grounded in wh
 | `LoginScreen` modal (`auth.py`) — available for future use | ✅ |
 | Activity history (`get_activity_history`) | ✅ |
 | Cat animation panel with mode changes | ✅ |
+| Cat panel — mode label + status badges (status chip, lock, night light, sleep, wait) under the art | ✅ |
+| Fault & safety monitoring — `#fault-banner` (in cat panel) driven by `asher/faults.py`; transition-logged; `d` to dismiss | ✅ |
+| Real-time cycling indicator with elapsed time (`⟳ Cycling M:SS`) | ✅ |
 | Command history (↑/↓) | ✅ |
 | WebSocket real-time updates (LR4 primary; poll fallback every 5 min for activity history) | ✅ |
 | LR4 / LR5 / LR3 polymorphic support via `RobotAdapter` pattern | ✅ |
@@ -474,11 +477,24 @@ If weight ID misidentifies a cat, this corrects the record.
 objects (day, sleep_time, wake_time, is_enabled). This is more granular than the
 current `sleep` / `wake` toggle.
 
+### ~~`sleep-schedule` — read-only viewer~~ ✅
+
+The `sleep-schedule` (alias `sleepschedule`) command renders the per-day
+sleep/wake window read-only. Days are sorted Mon→Sun (converted from pylitterbot's
+Sun=0..Sat=6 `DayOfWeek`); enabled days show `22:00 → 07:00`, disabled days show
+`off`. If `schedule.get_window()` returns an active window covering the current
+time, the affected day(s) get a `● now` marker. When the whole schedule is
+disabled it notes that and still lists the configured windows; when
+`sleep_schedule is None` it warns that the unit is always awake and points at
+`sleep`/`wake`. `_sleep_schedule` can raise on malformed data, so the whole read
+is wrapped defensively and degrades to a `_log_err`. Works on LR3/LR4/LR5 — the
+property exists on all three.
+
 ```
-sleep-schedule            show current schedule
-sleep-schedule set        interactive wizard (or flags)
-sleep-schedule Mon 22:00 07:00   set Monday sleep window
-sleep-schedule disable    clear all days
+sleep-schedule            show current schedule ✅
+sleep-schedule set        interactive wizard (or flags) — not yet
+sleep-schedule Mon 22:00 07:00   set Monday sleep window — not yet
+sleep-schedule disable    clear all days — not yet
 ```
 
 ### Contextual sleep/wake toggle
@@ -496,7 +512,30 @@ The `sleep` / `wake` commands should detect the robot model and dispatch accordi
 
 ---
 
-## 9. Fault monitoring & alerts
+## ~~9. Fault monitoring & alerts~~ ✅
+
+Live fault detection lives in `asher/faults.py` (`check_faults(robot)`), called
+from `MonitoringMixin._refresh_faults` on every status refresh (WebSocket push
++ poll). Detection is **model-scoped** — each model only checks the component
+attributes that are genuine fault indicators for it (mirrors the adapter
+pattern in `robot_adapters.py`):
+
+- **LR4** — globe motor + retract faults only
+- **LR5** — globe motor + retract + bonnet + laser + gas sensor + drawer-removed
+- **LR3** — no component checks (pylitterbot exposes none)
+
+`is_hopper_removed` is **never** treated as a fault: on the LR4 it's `True`
+when no hopper accessory is fitted (a hardware configuration, not a fault),
+and on the LR5 it's standard hardware state. Universal safety statuses (cat
+detected, pinch, over-torque, position faults) are checked on every model.
+Enum-valued properties (`GlobeMotorFaultStatus`) are checked against their
+healthy sentinels (`NONE` / `FAULT_CLEAR`) since the enums are truthy even
+when healthy. Faults surface via a `#fault-banner` widget inside the cat panel,
+beneath the status badges — hidden by default, red for `error`, amber for
+`warn`. Transitions are logged (`_log_err` new / `_log_ok` cleared) but
+steady-state faults don't flood the log. While a fault is active the cat
+panel switches to `error` mode. Press `d` to dismiss the banner until the set
+of active faults changes.
 
 ### 9a. Safety events (highest priority — surface immediately)
 
@@ -816,11 +855,16 @@ entire visit. With real-time push the badge appears the moment the sensor trips.
 
 ---
 
-### Real-time cycling indicator (requires WebSockets)
+### ~~Real-time cycling indicator (requires WebSockets)~~ ✅
 
-`LitterBoxStatus.CLEAN_CYCLE` is already caught by the `[RDY]` status chip,
-but polling every 30 s means a full clean cycle (typically 2–4 min) can start
-and finish between polls, showing only `Ready` to the user the whole time.
+The `#online-lbl` chip now shows `⟳ Cycling  M:SS` with live elapsed time while
+a `CLEAN_CYCLE`/`EMPTY_CYCLE` is active. `_cycle_start` is stamped on the
+transition into a cycling status and a 1 s `_cycle_timer` (created lazily via
+`set_interval`, stopped/null on any non-cycling status) re-renders the chip each
+second via `_tick_cycle`. The `_cycling_chip()` helper is shared between the
+timer and the `_refresh_status` cycling branch so they stay consistent. Because
+`_refresh_status` fires on WebSocket push, the chip updates the moment the cycle
+starts — no 30 s polling gap.
 
 **What's needed:**
 - WebSocket subscription (§6) — `robot.subscribe()` fires `EVENT_UPDATE`
@@ -889,27 +933,27 @@ Helper functions in `asher/connection/__init__.py`:
 
 Keyring service name: `asher-cli`, keys `email` and `password`.
 
-### Token persistence (stretch — avoid API re-auth on every run)
+### Token persistence ✅ — avoid API re-auth on every run
 
-`Account.connect()` accepts a pre-existing `token` dict and exposes a
-`token_update_callback`. If we save the session token alongside credentials
-after first login, subsequent runs skip the username/password API call entirely
-— faster startup and more resilient to rate-limiting.
-
-```python
-def save_token(token: dict | None) -> None:
-    if token:
-        keyring.set_password("asher-cli", "token", json.dumps(token))
+`Account.__init__()` accepts a pre-existing `token` dict and a
+`token_update_callback`; `connect()` with no username/password reuses a valid
+token or silently refreshes it via the refresh token. The cached session token
+is stored as a JSON blob in the OS keyring (key `"token"` under service
+`asher-cli`), so subsequent launches skip the OAuth password login entirely —
+faster startup, less password exposure, more resilient to rate-limiting.
 
-account = Account(
-    token=json.loads(keyring.get_password("asher-cli", "token") or "null"),
-    token_update_callback=save_token,
-)
-```
+`_connect_worker` tries the token first (via `_try_token_connect`), and only
+falls back to the email/password path if the token is absent, expired, or
+rejected — in which case the stale token is wiped so a poisoned token can't
+loop. `token_update_callback=_keyring_save_token` is also wired into the
+password-login `Account()` construction, so refreshes during a session are
+captured for the next launch. Users only re-enter their password when the
+refresh token itself expires (typically months).
 
-The token is automatically refreshed by pylitterbot when it expires. This
-would mean users only re-enter their password when the refresh token itself
-expires (typically months).
+Helpers in `asher/connection/__init__.py`:
+- `_keyring_load_token() → dict | None` — returns the cached token or `None`
+- `_keyring_save_token(token: dict | None)` — persists, or clears when `None`
+- `_keyring_delete()` now also clears `"token"` (so `/logout` invalidates it)
 
 ### `subscribe_for_updates` — let pylitterbot manage WebSocket per robot
 
@@ -1314,11 +1358,24 @@ remaining item from the original suggestion that isn't yet in place.
 
 ---
 
-## 18. Cat panel — robot status badges underneath the art
+## ~~18. Cat panel — robot status badges underneath the art~~ ✅
 
-Currently the cat panel only shows the ASCII art and a single italic label
-(`connected`, `cleaning…`, etc.). The panel has room to show a compact set of
-status indicators beneath the art without touching the status bar or log.
+A `#cat-label` widget renders the mode label (`connected`, `cycling…`,
+`fault!`, …) and a `#cat-status` widget below it shows **complementary** info
+that the top status bar doesn't surface — deliberately avoiding duplication of
+the top row's lock / night-light. The panel shows:
+
+```
+status   Ready
+power    mains
+cycles   1234
+wait     7m
+```
+
+Lines use a fixed-width ASCII key column (no emoji or ambiguous-width glyphs)
+so they stay vertically aligned in every terminal. Updated from `_refresh_status`
+via `MonitoringMixin._update_cat_panel`, so it refreshes in real time on
+WebSocket push. Status colour comes from the consolidated `STATUS_COLORS` map.
 
 ### Proposed layout
 
@@ -2023,10 +2080,12 @@ chip of the status bar:
 The `_refresh_title()` method in `asher/ui/__init__.py` builds this; version
 falls back to `"dev"` when running from source without `pip install -e .`.
 
-### `/version` slash command
+### ~~`/version` slash command~~ ✅
 
-A convenience command that prints version info to the log without requiring
-the user to look at the status bar:
+`/version` (a `SlashCommand` in `asher/commands/__init__.py`) prints the
+runtime versions to the log via `importlib.metadata.version()` with a
+`PackageNotFoundError` → `"?"` fallback, so it degrades cleanly when run from
+source without `pip install -e .`:
 
 ```
   Asher CLI v1.0.0
@@ -2035,23 +2094,6 @@ the user to look at the status bar:
   textual 0.x.x
 ```
 
-```python
-async def _slash_version(self) -> None:
-    import sys
-    from importlib.metadata import version as pkg_version, PackageNotFoundError
-
-    def _v(pkg):
-        try:
-            return pkg_version(pkg)
-        except PackageNotFoundError:
-            return "?"
-
-    self._log_info(f"Asher CLI v{_v('asher-cli')}")
-    self._log_info(f"Python {sys.version.split()[0]}")
-    self._log_info(f"pylitterbot {_v('pylitterbot')}")
-    self._log_info(f"textual {_v('textual')}")
-```
-
 ### ~~Status bar title — model badge~~ ✅
 
 The `#robot-lbl` widget already shows the model type appended to the robot name:
@@ -2270,11 +2312,11 @@ Ranked by user-visible impact vs. implementation effort:
 ### High-value features (biggest user-visible wins)
 
 1. **History export to CSV** (§2) — `export [days|month]` command; writes to `~/Downloads`, opens folder in OS explorer
-2. **Cat panel status badges** (§18) — lock, sleep, night light, wait time under the art; high visibility, one-afternoon job
+2. ~~**Cat panel status badges** (§18)~~ ✅ — `#cat-label` (revived mode label) + `#cat-status` badges (status chip, lock, night light, sleep, wait) under the art; refreshed via `_update_cat_panel` on every status refresh
 3. ~~**WebSocket subscription**~~ ✅ — real-time push updates live; 5-min poll fallback for activity history
-4. **Real-time cycling indicator with elapsed time** (§11) — extend the existing `⟳ Cycling` label to show elapsed time: `⟳ Cycling 0:42`; needs a per-second tick timer active only during a cycle
-5. **Token persistence** (§13) — skip password re-entry on every run
-6. **Fault & safety monitoring** (§9) — cat detected, pinch, motor faults; banner + log transition + cat alert mode
+4. ~~**Real-time cycling indicator with elapsed time** (§11)~~ ✅ — `⟳ Cycling  M:SS` chip in the status bar; `_cycle_start` + a lazy 1 s `_cycle_timer` (created on cycle start, stopped on any other status)
+5. ~~**Token persistence** (§13)~~ ✅ — OAuth session token cached as JSON in the keyring; `_connect_worker` tries the token first and only falls back to email/password on failure (wiping the stale token). `token_update_callback` captures refreshes during a session, so launches skip the password login entirely until the refresh token itself expires
+6. ~~**Fault & safety monitoring** (§9)~~ ✅ — `asher/faults.py` + `_refresh_faults` drive an in-panel `#fault-banner` (red/amber); enum fault props checked against healthy sentinels; transitions logged, steady state quiet; cat panel flips to `error`; `d` dismisses
 7. ~~**Readable history events** (§11)~~ ✅ — `history` now renders translated, colour-coded labels via `asher/activity_labels.py` (`format_activity()`); cat-detection events append pet name + weight; shared with the `export` CSV path
 8. **History pager sub-view** (§11) — scrollable in-log display with pagination; `history 100` vs current hardcoded 25-event dump
 
@@ -2285,9 +2327,9 @@ Ranked by user-visible impact vs. implementation effort:
 3. ~~**`/pet` slash command**~~ ✅ (§1, §14) — `/pet` lists, `/pet <idx|name>` switches; `_active_pet_idx` persists for session
 4. ~~**`/cat`, `/refresh`, `/config` slash commands**~~ ✅ (§1) — cat panel toggle + colour, poll interval control, runtime config dump
 5. **Tab-completion for slash commands** (§23) — Claude Code-style overlay dropdown on `/` keypress; single-source registry drives both dispatch and completion
-6. **`/version` slash command** (§24) — print Python/package versions to log; model badge in status bar is already done
+6. ~~**`/version` slash command** (§24)~~ ✅ — prints asher-cli / Python / pylitterbot / textual versions to the log via `importlib.metadata`, with a `"?"` fallback when not installed; model badge in the status bar was already done
 7. ~~**`wait-time`, `power`, `rename`, `insight` commands** (§3)~~ ✅ — all four wired up; plus the `status`/`info` split (`status` trimmed to at-a-glance, `info` is the full property dump). `panel-brightness` skipped (not exposed by pylitterbot 2025.6.2); `reset`/`reset-settings`/`firmware`-update deliberately omitted as destructive
-8. **Sleep schedule viewer** (§8) — read-only first, config wizard later
+8. ~~**Sleep schedule viewer** (§8)~~ ✅ — `sleep-schedule` (alias `sleepschedule`) renders the per-day sleep/wake window read-only, sorted Mon→Sun, with an active-window `● now` marker; config wizard/set/disable still TODO
 9. **Headless CLI export** (§25) — `asher --export 7` for cron/Task Scheduler automation, no TUI or Claude Desktop needed
 
 ### Release pipeline

{asher_cli-0.1.0 → asher_cli-0.1.1}/asher/app.py

@@ -26,6 +26,7 @@ class AsherApp(UIMixin, ConnectionMixin, MonitoringMixin, CommandsMixin, App):
         Binding("ctrl+c", "quit", "Quit", priority=True),
         Binding("ctrl+l", "clear_log", "Clear log"),
         Binding("escape", "blur_input", "Focus log", show=False),
+        Binding("d", "dismiss_fault", "Dismiss fault banner", show=False),
     ]
 
     def __init__(self) -> None:
@@ -51,6 +52,10 @@ class AsherApp(UIMixin, ConnectionMixin, MonitoringMixin, CommandsMixin, App):
         self._cat_panel_visible: bool = True
         self._cat_color: str | None = None
         self._active_pet_idx: int = 0
+        self._prev_faults: set[str] = set()
+        self._fault_dismissed: set[str] = set()
+        self._cycle_start: Any = None
+        self._cycle_timer: Timer | None = None
 
     def on_mount(self) -> None:
         self._refresh_title()

{asher_cli-0.1.0 → asher_cli-0.1.1}/asher/commands/__init__.py

@@ -8,7 +8,9 @@ import csv
 import os
 import subprocess
 import sys
-from datetime import datetime, timedelta, timezone
+from datetime import datetime, time, timedelta, timezone
+from importlib.metadata import PackageNotFoundError
+from importlib.metadata import version as pkg_version
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, cast
 
@@ -542,6 +544,101 @@ class InsightCommand(Command):
             log.write(t)
 
 
+_DAY_NAMES = ("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun")
+
+
+def _fmt_sleep_time(t: object) -> str:
+    if t is None:
+        return "—"
+    if isinstance(t, time):
+        return t.strftime("%H:%M")
+    return str(t)
+
+
+def _dow_to_weekday(day: int) -> int:
+    """Convert a pylitterbot DayOfWeek (Sun=0..Sat=6) to Python weekday (Mon=0..Sun=6)."""
+    return (day - 1) % 7
+
+
+class SleepScheduleCommand(Command):
+    name = "sleep-schedule"
+    aliases = ("sleepschedule",)
+    description = "show the per-day sleep schedule (read-only)"
+    requires_robot = True
+
+    @property
+    def display_name(self) -> str:
+        return "sleep-schedule"
+
+    async def run(self, app: AsherApp, args: list[str]) -> None:
+        assert app._robot is not None
+        try:
+            schedule = getattr(app._robot, "sleep_schedule", None)
+        except Exception as exc:
+            app._log_err(f"Failed to read sleep schedule: {exc}")
+            return
+
+        if schedule is None:
+            app._log_warn(
+                "No sleep schedule set — the unit is always awake "
+                "(or toggle sleep/wake for an immediate nap)."
+            )
+            return
+
+        try:
+            days = sorted(
+                getattr(schedule, "days", []),
+                key=lambda d: _dow_to_weekday(int(getattr(d, "day", 0))),
+            )
+            is_enabled = bool(getattr(schedule, "is_enabled", False))
+            # Window covers [sleep_start, wake_end] as datetimes; None if disabled/expired.
+            window = None
+            with contextlib.suppress(Exception):
+                window = schedule.get_window()
+        except Exception as exc:
+            app._log_err(f"Failed to parse sleep schedule: {exc}")
+            return
+
+        if not is_enabled:
+            app._log_info("Sleep schedule is disabled. Configured windows:")
+
+        log = app.query_one("#log", RichLog)
+        active_day_indices = set()
+        if window is not None:
+            try:
+                start_dt, end_dt = window
+                # Sleep windows can wrap past midnight, so flag both the start
+                # and end day as "active now" for the user-facing marker.
+                active_day_indices.add(start_dt.weekday())
+                active_day_indices.add(end_dt.weekday())
+            except Exception:
+                pass
+
+        for day in days:
+            try:
+                idx = _dow_to_weekday(int(getattr(day, "day", 0)))
+                day_enabled = bool(getattr(day, "is_enabled", False))
+                sleep_t = getattr(day, "sleep_time", None)
+                wake_t = getattr(day, "wake_time", None)
+            except Exception:
+                continue
+
+            name = _DAY_NAMES[idx]
+            t = Text()
+            t.append(f"  {name} ", style="#484f58")
+            if day_enabled:
+                window_str = f"{_fmt_sleep_time(sleep_t)} → {_fmt_sleep_time(wake_t)}"
+                t.append(window_str, style="#c9d1d9")
+                if idx in active_day_indices:
+                    t.append("   ● now", style="bold #d29922")
+            else:
+                t.append("off", style="#484f58")
+            log.write(t)
+
+        if is_enabled and not active_day_indices:
+            app._log_info("Outside the active sleep window right now.")
+
+
 # ── LR5-only commands ─────────────────────────────────────────────────────────
 # These route through the adapter, which returns a "not supported" message on
 # LR3/LR4 rather than crashing — so the commands are safe to type on any model.
@@ -1054,6 +1151,23 @@ class McpCommand(SlashCommand):
             app._log_info(f"MCP server was already {verb}")
 
 
+class VersionCommand(SlashCommand):
+    name = "version"
+    description = "show version info (asher-cli, Python, pylitterbot, textual)"
+
+    async def run(self, app: AsherApp, args: list[str]) -> None:  # noqa: ARG002
+        def _v(pkg: str) -> str:
+            try:
+                return pkg_version(pkg)
+            except PackageNotFoundError:
+                return "?"
+
+        app._log_info(f"Asher CLI v{_v('asher-cli')}")
+        app._log_info(f"Python {sys.version.split()[0]}")
+        app._log_info(f"pylitterbot {_v('pylitterbot')}")
+        app._log_info(f"textual {_v('textual')}")
+
+
 def _open_folder(path: Path) -> None:
     if sys.platform == "win32":
         subprocess.Popen(["explorer", "/select,", str(path)])
@@ -1173,6 +1287,7 @@ _registry.register(WaitTimeCommand())
 _registry.register(PowerCommand())
 _registry.register(RenameCommand())
 _registry.register(InsightCommand())
+_registry.register(SleepScheduleCommand())
 _registry.register(PrivacyCommand())
 _registry.register(VolumeCommand())
 _registry.register(CameraAudioCommand())
@@ -1191,6 +1306,7 @@ _registry.register(CatCommand())
 _registry.register(RefreshCommand())
 _registry.register(ConfigCommand())
 _registry.register(McpCommand())
+_registry.register(VersionCommand())
 
 
 # ── mixin ───────────────────────────────────────────────────────────────────