asher-cli 1.0.0__tar.gz → 1.0.1__tar.gz

asher_cli-1.0.1/.github/workflows/bandit.yml

@@ -0,0 +1,52 @@
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+# Bandit is a security linter designed to find common security issues in Python code.
+# This action will run Bandit on your codebase.
+# The results of the scan will be found under the Security tab of your repository.
+
+# https://github.com/marketplace/actions/bandit-scan is ISC licensed, by abirismyname
+# https://pypi.org/project/bandit/ is Apache v2.0 licensed, by PyCQA
+
+name: Bandit
+on:
+  push:
+    branches: [ "main", "release/*" ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ "main" ]
+  schedule:
+    - cron: '32 0 * * 1'
+
+jobs:
+  bandit:
+    permissions:
+      contents: read # for actions/checkout to fetch code
+      security-events: write # for github/codeql-action/upload-sarif to upload SARIF results
+      actions: read # only required for a private repository by github/codeql-action/upload-sarif to get the Action run status
+
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
+      - name: Bandit Scan
+        uses: shundor/python-bandit-scan@ab1d87dfccc5a0ffab88be3aaac6ffe35c10d6cd
+        with: # optional arguments
+          # exit with 0, even with results found
+          exit_zero: true # optional, default is DEFAULT
+          # Github token of the repository (automatically created by Github)
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Needed to get PR information.
+          # File or directory to run bandit on
+          # path: # optional, default is .
+          # Report only issues of a given severity level or higher. Can be LOW, MEDIUM or HIGH. Default is UNDEFINED (everything)
+          # level: # optional, default is UNDEFINED
+          # Report only issues of a given confidence level or higher. Can be LOW, MEDIUM or HIGH. Default is UNDEFINED (everything)
+          # confidence: # optional, default is UNDEFINED
+          # comma-separated list of paths (glob patterns supported) to exclude from scan (note that these are in addition to the excluded paths provided in the config file) (default: .svn,CVS,.bzr,.hg,.git,__pycache__,.tox,.eggs,*.egg)
+          # excluded_paths: # optional, default is DEFAULT
+          # comma-separated list of test IDs to skip
+          # skips: # optional, default is DEFAULT
+          # path to a .bandit file that supplies command line arguments
+          # ini_path: # optional, default is DEFAULT
+

{asher_cli-1.0.0 → asher_cli-1.0.1}/.github/workflows/coverage.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Run tests with coverage
         run: uv run pytest tests/ --cov=asher --cov-report=lcov --cov-report=term-missing
       - name: Upload to Coveralls
-        uses: coverallsapp/github-action@5cbfd81b66ca5d10c19b062c04de0199c215fb6e # v2
+        uses: coverallsapp/github-action@8d6379e14d29928660c4ba802d8e85393440b329 # v2
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           path-to-lcov: coverage.lcov

{asher_cli-1.0.0 → asher_cli-1.0.1}/CHANGELOG.md

@@ -7,7 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Generated by [git-cliff](https://git-cliff.org) from conventional commits.
 
-## [Unreleased]
+## [1.0.1] - 2026-08-04
+
+### 🚀 Features
+
+- *(history)* Copy-to-clipboard + discoverable footer hints
+
+## [1.0.0] - 2026-08-02
 
 ### 🚀 Features
 
@@ -18,6 +24,7 @@ Generated by [git-cliff](https://git-cliff.org) from conventional commits.
 
 ### 📚 Documentation
 
+- *(changelog)* Regenerate for next release, trim duplicate README list
 - *(roadmap)* Archive completed sections to docs/roadmap-archive/
 
 ### 🔧 Miscellaneous

{asher_cli-1.0.0 → asher_cli-1.0.1}/CLAUDE.md

@@ -46,7 +46,7 @@ asher/
   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 incl. LR4 USB power fault; hopper never a fault)
-  history_view.py   HistoryScreen (ModalScreen) + format_history_rows() — scrollable activity-history pager pushed by the `history` command
+  history_view.py   HistoryScreen (ModalScreen) + format_history_rows()/format_history_text() — scrollable activity-history pager pushed by the `history` command; `c` copies the full history (plain text) to the clipboard via action_copy_all()
   export.py         shared activity-history CSV core + headless export path: build_history_csv(), resolve_dest(), resolve_robot(), _run_headless_export(), ExportError — no Textual imports; both the TUI `export` command and `asher --export` call build_history_csv()
   completion.py     pure helpers for command completion: slash popup (slash_matches, enter_completes, render_completion) + inline ghost text (CommandSuggester) — fed by _registry, no Textual imports except the Suggester base class
   __main__.py       main() entry point
@@ -75,7 +75,7 @@ tests/
   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
-  test_history_view.py    format_history_rows() + HistoryScreen structure + Pilot push/dismiss
+  test_history_view.py    format_history_rows()/format_history_text() + HistoryScreen structure, copy-all + Pilot push/dismiss
   test_export.py          build_history_csv/resolve_dest/resolve_robot/parse_days (pure) + headless _run_headless_export (no Pilot, mocks _connect_headless)
   test_completion.py      slash_matches/enter_completes/render_completion (pure) + Pilot overlay visibility/navigation/accept
 

{asher_cli-1.0.0 → asher_cli-1.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: asher-cli
-Version: 1.0.0
+Version: 1.0.1
 Summary: Terminal dashboard for Litter Robot (LR3/LR4/LR5) via the Whisker cloud API
 Project-URL: Homepage, https://github.com/karanshukla/asher-cli
 Project-URL: Repository, https://github.com/karanshukla/asher-cli
@@ -70,7 +70,7 @@ A Claude Code-style terminal dashboard for monitoring and controlling Litter Rob
 - 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-history pager — `history [count|all]` opens a full-screen, paginated view (arrow keys, `Page Up`/`Page Down`, `Home`/`End`); `q`/`Esc`/`Enter` to close
+- Scrollable activity-history pager — `history [count|all]` opens a full-screen, paginated view (arrow keys, `Page Up`/`Page Down`, `Home`/`End`); `c` copies the whole history to the clipboard; `q`/`Esc`/`Enter` to close
 - Commands: `clean`, `status`, `info`, `lock`, `unlock`, `sleep`, `wake`, `night-light on|off|auto`, `night-light-brightness`, `panel-brightness <low|medium|high>` (LR4/LR5), `wait-time`, `power on|off`, `rename`, `insight`, `sleep-schedule`, plus LR5 extras (`privacy`, `volume`, `camera-audio`, `drawer-reset`), `history [count|all]`, `export [days|month]`, `help`, `quit`
 - Slash commands for app management: `/login`, `/logout`, `/robots`, `/robot <index|name>`, `/pets`, `/pet <index|name>`, `/cat on|off|colour <hex>`, `/refresh [seconds|off]`, `/config`, `/notify on|off|sound on|off|test`, `/version`, `/mcp on|off|status`, `/exit`
 - Slash-command tab completion — type `/` and a Claude Code-style overlay lists matching commands; `↑`/`↓` to move, `Tab` or `Enter` to accept, `Esc` to dismiss

{asher_cli-1.0.0 → asher_cli-1.0.1}/README.md

@@ -19,7 +19,7 @@ A Claude Code-style terminal dashboard for monitoring and controlling Litter Rob
 - 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-history pager — `history [count|all]` opens a full-screen, paginated view (arrow keys, `Page Up`/`Page Down`, `Home`/`End`); `q`/`Esc`/`Enter` to close
+- Scrollable activity-history pager — `history [count|all]` opens a full-screen, paginated view (arrow keys, `Page Up`/`Page Down`, `Home`/`End`); `c` copies the whole history to the clipboard; `q`/`Esc`/`Enter` to close
 - Commands: `clean`, `status`, `info`, `lock`, `unlock`, `sleep`, `wake`, `night-light on|off|auto`, `night-light-brightness`, `panel-brightness <low|medium|high>` (LR4/LR5), `wait-time`, `power on|off`, `rename`, `insight`, `sleep-schedule`, plus LR5 extras (`privacy`, `volume`, `camera-audio`, `drawer-reset`), `history [count|all]`, `export [days|month]`, `help`, `quit`
 - Slash commands for app management: `/login`, `/logout`, `/robots`, `/robot <index|name>`, `/pets`, `/pet <index|name>`, `/cat on|off|colour <hex>`, `/refresh [seconds|off]`, `/config`, `/notify on|off|sound on|off|test`, `/version`, `/mcp on|off|status`, `/exit`
 - Slash-command tab completion — type `/` and a Claude Code-style overlay lists matching commands; `↑`/`↓` to move, `Tab` or `Enter` to accept, `Esc` to dismiss

{asher_cli-1.0.0 → asher_cli-1.0.1}/asher/commands/__init__.py

@@ -1522,6 +1522,11 @@ class CommandsMixin:
         return False
 
     def on_key(self, event) -> None:  # type: ignore[override]
+        # A pushed modal (history pager, login modal, …) owns its keys. The base
+        # screen's `focused` still points at #cmd-input under a modal, so
+        # has_focus alone would let us hijack arrows/special keys from the overlay.
+        if len(self.screen_stack) > 1:  # type: ignore[attr-defined]
+            return
         cmd_input = self.query_one("#cmd-input", Input)  # type: ignore[attr-defined]
         if not cmd_input.has_focus:
             return

{asher_cli-1.0.0 → asher_cli-1.0.1}/asher/history_view.py

@@ -13,7 +13,7 @@ Layout (top to bottom):
 * summary line — a compact event-type breakdown (cleans, cat visits, …)
 * column header — pinned ``TIME`` / ``EVENT`` row aligned with the data
 * scroll area — one styled row per event, newest first, fixed-width timestamps
-* footer — navigation + close hints
+* footer — navigation, copy, and close hints (``c`` copies the whole history to the clipboard)
 
 Timestamps are rendered at a fixed width so the event column lines up
 vertically regardless of an event's age — every event shows its date.
@@ -47,6 +47,13 @@ _TS_WIDTH = 11
 # raw strings still fall into "other" rather than mislabeling.
 _ALERT_KEYWORDS = ("offline", "fault", "pinch", "power", "motor", "timing")
 
+# Footer hint line shown at the bottom of the pager and restored after the
+# post-copy confirmation flash.
+_FOOTER_HINT = (
+    "  \u2191/\u2193 scroll   PgUp/PgDn page   Home/End jump   "
+    "c copy   q \u00b7 Esc \u00b7 Enter close"
+)
+
 
 def _localize(ts: object) -> datetime | None:
     """Coerce an activity timestamp to a local-tz-aware datetime, or ``None``."""
@@ -85,6 +92,32 @@ def format_history_rows(acts: list[Activity], pets: list[Any] | None = None) ->
     return rows
 
 
+def format_history_text(
+    acts: list[Activity], pets: list[Any] | None = None, robot_name: str = ""
+) -> str:
+    """Plain-text rendering of the history, for clipboard copying.
+
+    Self-contained: title line, event-type summary, column header, and one row
+    per event (newest first) — mirrors what the on-screen pager shows so a pasted
+    copy reads the same as the view.
+    """
+    count = len(acts)
+    lines = [
+        f"Activity history \u2014 {robot_name}   {_plural(count, 'event')}   {_date_range(acts)}"
+    ]
+    if not count:
+        lines.append("No activity history available.")
+        return "\n".join(lines)
+    lines.append(_summarize(acts, pets))
+    lines.append("")
+    lines.append(f"  {'TIME'.ljust(_TS_WIDTH)}  EVENT")
+    for act in acts:
+        ts_str = _ts_str(_localize(getattr(act, "timestamp", None)))
+        label, _ = format_activity(act, pets)
+        lines.append(f"  {ts_str.ljust(_TS_WIDTH)}  {label}")
+    return "\n".join(lines)
+
+
 def _category(label: str) -> str:
     """Bucket a translated label into a short summary name."""
     low = label.lower()
@@ -147,7 +180,7 @@ class HistoryScreen(ModalScreen[None]):
 
     #history-meta {
         dock: top;
-        height: 1;
+        height: 2;
         background: #161b22;
         border-bottom: solid #30363d;
         padding: 0 2;
@@ -165,11 +198,11 @@ class HistoryScreen(ModalScreen[None]):
 
     #history-footer {
         dock: bottom;
-        height: 1;
+        height: 2;
         background: #161b22;
         border-top: solid #30363d;
         padding: 0 2;
-        color: #484f58;
+        color: #c9d1d9;
     }
 
     #history-scroll {
@@ -188,6 +221,7 @@ class HistoryScreen(ModalScreen[None]):
 
     BINDINGS = [
         Binding("escape,q,enter", "dismiss", "Close", show=False, priority=True),
+        Binding("c", "copy_all", "Copy all", show=False, priority=True),
     ]
 
     def __init__(self, acts: list[Activity], pets: list[Any] | None, robot_name: str) -> None:
@@ -195,6 +229,7 @@ class HistoryScreen(ModalScreen[None]):
         self._acts = acts
         self._pets = pets
         self._robot_name = robot_name
+        self._restore_timer: Any = None
 
     def compose(self) -> ComposeResult:
         count = len(self._acts)
@@ -209,13 +244,35 @@ class HistoryScreen(ModalScreen[None]):
             else:
                 yield Static("No activity history available for this robot.", id="history-empty")
         yield Static(
-            "  ↑/↓ scroll   PgUp/PgDn page   Home/End jump   q · Esc · Enter close",
+            _FOOTER_HINT,
             id="history-footer",
         )
 
     def on_mount(self) -> None:
         self.query_one("#history-scroll", ScrollableContainer).focus()
 
+    def action_copy_all(self) -> None:
+        """Copy the full history (plain text) to the OS clipboard.
+
+        Flashes the footer with a confirmation, then restores the hint line.
+        ``copy_to_clipboard`` uses OSC52 under the hood and silently no-ops on
+        terminals that don't support it, so we optimistically report success.
+        """
+        text = format_history_text(self._acts, self._pets, self._robot_name)
+        try:
+            self.app.copy_to_clipboard(text)
+        except Exception:
+            message = "  Clipboard unavailable in this terminal"
+        else:
+            message = f"  ✓ Copied {_plural(len(self._acts), 'event')} to clipboard"
+        self.query_one("#history-footer", Static).update(message)
+        if self._restore_timer is not None:
+            self._restore_timer.stop()
+        self._restore_timer = self.set_timer(1.5, self._restore_footer)
+
+    def _restore_footer(self) -> None:
+        self.query_one("#history-footer", Static).update(_FOOTER_HINT)
+
     def _title_line(self, count: int) -> str:
         return f"  Activity history — {self._robot_name}   {_plural(count, 'event')}   {_date_range(self._acts)}"
 

{asher_cli-1.0.0 → asher_cli-1.0.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "asher-cli"
-version = "1.0.0"
+version = "1.0.1"
 description = "Terminal dashboard for Litter Robot (LR3/LR4/LR5) via the Whisker cloud API"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -100,7 +100,7 @@ exclude = ["asher/slash-commands"]
 # ── bump-my-version ───────────────────────────────────────────────────────────
 
 [tool.bumpversion]
-current_version = "1.0.0"
+current_version = "1.0.1"
 commit = true
 tag = true
 tag_name = "v{new_version}"

{asher_cli-1.0.0 → asher_cli-1.0.1}/tests/test_history_view.py

@@ -21,7 +21,7 @@ from textual.app import App
 from textual.containers import ScrollableContainer
 from textual.widgets import Static
 
-from asher.history_view import HistoryScreen, format_history_rows
+from asher.history_view import HistoryScreen, format_history_rows, format_history_text
 
 
 def _act(action: Any, *, timestamp: datetime | None = None) -> SimpleNamespace:
@@ -112,6 +112,35 @@ class TestFormatHistoryRows:
         assert format_history_rows([]) == []
 
 
+# ── format_history_text (clipboard payload) ─────────────────────────────────
+
+
+class TestFormatHistoryText:
+    def test_plain_text_includes_title_summary_and_rows(self):
+        acts = [
+            _act(
+                LitterBoxStatus.CLEAN_CYCLE_COMPLETE,
+                timestamp=datetime(2026, 6, 14, 14, 0, tzinfo=timezone.utc),
+            ),
+            _act(
+                LitterBoxStatus.READY, timestamp=datetime(2026, 6, 14, 10, 0, tzinfo=timezone.utc)
+            ),
+        ]
+        text = format_history_text(acts, None, "TestBot")
+        assert "Activity history" in text
+        assert "TestBot" in text
+        assert "2 events" in text
+        assert "TIME" in text and "EVENT" in text
+        assert "Clean cycle complete" in text
+        assert "Ready" in text
+        assert "\n" in text
+
+    def test_empty_history_text(self):
+        text = format_history_text([], None, "TestBot")
+        assert "0 events" in text
+        assert "No activity history" in text
+
+
 # ── HistoryScreen ────────────────────────────────────────────────────────────
 
 
@@ -236,6 +265,44 @@ async def test_history_screen_enter_dismisses():
         assert app.screen is not screen
 
 
+@pytest.mark.asyncio
+async def test_history_screen_c_copies_all_events_to_clipboard(monkeypatch):
+    """`c` copies the full history to the clipboard and flashes the footer."""
+    captured: dict[str, str] = {}
+    monkeypatch.setattr(
+        App,
+        "copy_to_clipboard",
+        lambda self, text: captured.setdefault("text", text),
+    )
+    screen = _screen()
+    app = _ShellApp(screen)
+    async with app.run_test() as pilot:
+        await pilot.pause()
+        await pilot.press("c")
+        await pilot.pause()
+        # The whole history was sent to the clipboard.
+        assert "TestBot" in captured["text"]
+        assert "Clean cycle complete" in captured["text"]
+        # Footer flashes a confirmation.
+        assert "Copied" in str(screen.query_one("#history-footer", Static).render())
+
+
+@pytest.mark.asyncio
+async def test_history_screen_copy_footer_restores_after_flash(monkeypatch):
+    monkeypatch.setattr(App, "copy_to_clipboard", lambda self, text: None)
+    screen = _screen()
+    app = _ShellApp(screen)
+    async with app.run_test() as pilot:
+        await pilot.pause()
+        await pilot.press("c")
+        await pilot.pause()
+        # Advance past the 1.5s restore timer.
+        await pilot.pause(delay=1.6)
+        footer = str(screen.query_one("#history-footer", Static).render())
+        assert "Copied" not in footer
+        assert "scroll" in footer  # back to the hint line
+
+
 @pytest.mark.asyncio
 async def test_history_command_pushes_screen_with_default_limit():
     """End-to-end: typing `history` fetches with the default and pushes the pager."""
@@ -274,3 +341,52 @@ async def test_history_command_pushes_screen_with_default_limit():
         title = app.screen.query_one("#history-title", Static)
         assert "TestBot" in str(title.render())
         assert "1 event" in str(title.render())
+
+
+@pytest.mark.asyncio
+async def test_history_screen_arrow_keys_scroll_through_asher_app():
+    """Regression: AsherApp.on_key used to hijack ↑/↓ for command-history nav even
+    while the history pager modal was open (the base screen's `focused` still
+    pointed at #cmd-input, so a has_focus guard lied). Arrow keys must scroll the
+    pager instead.
+    """
+    from unittest.mock import AsyncMock, MagicMock
+
+    from asher.app import AsherApp
+    from asher.robot_adapters import LR3Adapter
+
+    robot = MagicMock()
+    robot.name = "TestBot"
+    robot.is_online = True
+    robot.status = MagicMock(value="Ready")
+    robot.last_seen = datetime.now(timezone.utc)
+    robot.get_activity_history = AsyncMock(
+        return_value=[
+            SimpleNamespace(
+                timestamp=datetime(2026, 7, i % 28 + 1, 12, 0, tzinfo=timezone.utc),
+                action=LitterBoxStatus.CLEAN_CYCLE_COMPLETE,
+            )
+            for i in range(40)
+        ]
+    )
+
+    app = AsherApp()
+    app._robot = robot
+    app._adapter = LR3Adapter(robot)
+    app._account = MagicMock()
+    app._account.disconnect = AsyncMock()
+    app._pets = []
+    app._connect_worker = lambda **kwargs: None  # type: ignore[method-assign]
+
+    async with app.run_test(size=(80, 24)) as pilot:
+        await pilot.pause()
+        await pilot.click("#cmd-input")
+        await pilot.press("h", "i", "s", "t", "o", "r", "y")
+        await pilot.press("enter")
+        await pilot.pause()
+        scroll = app.screen.query_one("#history-scroll", ScrollableContainer)
+        before = scroll.scroll_y
+        await pilot.press("down", "down", "down")
+        await pilot.pause()
+        # Arrow keys reached the pager, not the app's command-history nav.
+        assert scroll.scroll_y > before

{asher_cli-1.0.0 → asher_cli-1.0.1}/uv.lock

@@ -217,7 +217,7 @@ wheels = [
 
 [[package]]
 name = "asher-cli"
-version = "1.0.0"
+version = "1.0.1"
 source = { editable = "." }
 dependencies = [
     { name = "keyring" },