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

asher_cli-0.1.1/.github/pull_request_template.md

@@ -0,0 +1,24 @@
+## Summary
+
+<!-- What does this PR change, and why? -->
+
+## Related issue
+
+Closes #
+
+## Changes
+
+-
+
+## Testing
+
+- [ ] `pytest` passes locally
+- [ ] Added/updated tests for new or changed behavior
+- [ ] Manually ran the CLI to verify the change (`asher ...`)
+
+## Checklist
+
+- [ ] Code is linted/formatted per project conventions
+- [ ] README / CLI help text updated if flags or commands changed
+- [ ] No secrets, tokens, or local paths committed
+- [ ] Version bump considered if this affects the published PyPI package

{asher_cli-0.0.5 → asher_cli-0.1.1}/.github/workflows/ci.yml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
-      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
       - run: uv sync --dev
       - run: uv run ruff check .
       - run: uv run ruff format --check .
@@ -29,6 +29,6 @@ jobs:
     runs-on: ${{ matrix.os }}
     steps:
       - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
-      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
       - run: uv sync --dev
       - run: uv run pytest tests/ -v --tb=short

{asher_cli-0.0.5 → asher_cli-0.1.1}/.github/workflows/claude-code-review.yml

@@ -33,7 +33,7 @@ jobs:
 
       - name: Run Claude Code Review
         id: claude-review
-        uses: anthropics/claude-code-action@428971d2ecd6e3a7cb0ee0da2a3a8b33fdb3678d # v1
+        uses: anthropics/claude-code-action@af0559ee4f514d1ef21826982bed13f7edc3c35e # v1
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
           plugin_marketplaces: 'https://github.com/anthropics/claude-code.git'

{asher_cli-0.0.5 → asher_cli-0.1.1}/.github/workflows/claude.yml

@@ -32,7 +32,7 @@ jobs:
 
       - name: Run Claude Code
         id: claude
-        uses: anthropics/claude-code-action@428971d2ecd6e3a7cb0ee0da2a3a8b33fdb3678d # v1
+        uses: anthropics/claude-code-action@af0559ee4f514d1ef21826982bed13f7edc3c35e # v1
         with:
           claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
 

{asher_cli-0.0.5 → asher_cli-0.1.1}/.github/workflows/coverage.yml

@@ -13,7 +13,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7
-      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
       - run: uv sync --dev
       - name: Run tests with coverage
         run: uv run pytest tests/ --cov=asher --cov-report=lcov --cov-report=term-missing

{asher_cli-0.0.5 → asher_cli-0.1.1}/.github/workflows/release.yml

@@ -20,7 +20,7 @@ jobs:
       - name: Extract version from branch name
         id: version
         run: echo "version=${GITHUB_REF_NAME#release/}" >> "$GITHUB_OUTPUT"
-      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - uses: astral-sh/setup-uv@11f9893b081a58869d3b5fccaea48c9e9e46f990 # v8.3.2
       - run: uv build
       - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
         with:
@@ -37,7 +37,7 @@ jobs:
         with:
           name: dist
           path: dist/
-      - uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # release/v1
+      - uses: pypa/gh-action-pypi-publish@ba38be9e461d3875417946c167d0b5f3d385a247 # release/v1
 
   github-release:
     name: Create GitHub Release

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

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

{asher_cli-0.0.5 → 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 |
@@ -159,6 +169,10 @@ pylitterbot auto-detects robot type. Commands that differ per model are handled
 - `robot.set_night_light_brightness(int)` or `robot.set_night_light_mode(NightLightMode)`
 - `robot.get_activity_history(limit=int)` → list of `Activity` objects with `.timestamp` and `.action` (`LitterBoxStatus` enum)
 
+## Code comments
+
+Don't add comments above functions or inline unless the WHY is genuinely non-obvious (a hidden constraint, a subtle invariant, a workaround for a specific bug). Well-named identifiers should make the WHAT self-evident. Before reaching for a comment, check whether the explanation can instead be expressed through abstraction or encapsulation — e.g. domain logic buried in a mixin or command handler should move to a self-commenting, domain-named method rather than being explained in a comment. Favor human-readable, domain-driven names and logical flow over prose explanations, while keeping code legible to agents working in this repo.
+
 ## Development notes
 
 - Textual and pylitterbot are both asyncio-native — compose cleanly with `@work` tasks

asher_cli-0.1.1/CODEOWNERS

@@ -0,0 +1 @@
+* @karanshukla

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: asher-cli
-Version: 0.0.5
+Version: 0.1.1
 Summary: Terminal dashboard for Litter Robot (LR3/LR4/LR5) via the Whisker cloud API
 License: MIT License
         
@@ -35,13 +35,13 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Home Automation
 Requires-Python: >=3.10
 Requires-Dist: keyring>=24.0.0
-Requires-Dist: pylitterbot==2025.5.0
+Requires-Dist: pylitterbot==2025.6.2
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: textual>=0.47.0
 Requires-Dist: tzlocal>=5.4
 Provides-Extra: mcp
-Requires-Dist: pylitterbot[mcp]==2025.5.0; extra == 'mcp'
+Requires-Dist: pylitterbot[mcp]==2025.6.2; extra == 'mcp'
 Description-Content-Type: text/markdown
 
 # Asher CLI
@@ -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.0.5 → 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`