pocketshell 0.3.7__tar.gz → 0.3.9__tar.gz

{pocketshell-0.3.7 → pocketshell-0.3.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pocketshell
-Version: 0.3.7
+Version: 0.3.9
 Summary: Unified server-side Python utility for the PocketShell Android client.
 Project-URL: Homepage, https://github.com/alexeygrigorev/pocketshell
 Project-URL: Issues, https://github.com/alexeygrigorev/pocketshell/issues
@@ -29,14 +29,10 @@ Description-Content-Type: text/markdown
 # pocketshell
 
 Unified server-side Python utility for the [PocketShell](https://github.com/alexeygrigorev/pocketshell)
-Android client. Replaces the separately-installed `quse` and `tmuxctl`
-utilities the app currently probes for on every remote host.
-
-This first release ships the **skeleton plus the `pocketshell usage`
-subcommand only**. Follow-up rounds will add `jobs`, `agent-log`,
-`sessions`, `repos`, and an optional daemon mode. See
-[issue #170](https://github.com/alexeygrigorev/pocketshell/issues/170) for
-the design spike and phased roll-out plan.
+Android client. The app probes for this single helper on each remote
+host and uses its subcommands for usage, tmux session/job metadata,
+agent conversations, QR host setup, repository discovery, environment
+files, hooks, logs, and daemon lifecycle checks.
 
 ## Install
 
@@ -77,18 +73,38 @@ Without the extra, every other subcommand keeps working; only
 
 ## Usage
 
+Top-level commands in the current helper:
+
+```text
+pocketshell usage [provider] [--json]       # provider quota / usage
+pocketshell sessions list [--by activity]   # tmux session summaries
+pocketshell jobs ...                        # tmux recurring jobs
+pocketshell agent-log ...                   # agent conversation logs
+pocketshell repos list ...                  # local / GitHub repositories
+pocketshell env ...                         # .env / .envrc management
+pocketshell hooks ...                       # Claude/Codex/OpenCode hooks
+pocketshell logs ...                        # server-side trace sink
+pocketshell daemon ...                      # IPC daemon lifecycle
+pocketshell qr-share ...                    # SSH host QR import payloads
+```
+
+Run `pocketshell --help` or `pocketshell <command> --help` for the live
+flag set. Some parity subcommands still proxy through the existing host
+tools internally so their output remains byte-identical to what the app
+already parses.
+
+### `pocketshell usage`
+
 ```text
 pocketshell usage           # human-readable lines, one per provider
 pocketshell usage --json    # machine-readable JSON (consumed by the app)
 pocketshell usage codex     # filter to a single provider
 ```
 
-The output shape is byte-identical to `quse [provider] [--json]` so any
-consumer that already parses `quse` output keeps working when the app
-routes through `pocketshell usage` instead. Under the hood the first
-release delegates to the `quse` CLI via subprocess; later rounds will
-fold the provider-detection logic in directly and drop the subprocess
-hop.
+The output shape is byte-identical to `quse [provider] [--json]`. When
+the IPC daemon is running, `usage --json` dispatches `usage.fetch` over
+the daemon socket and uses the daemon's short TTL cache; otherwise it
+falls through to the one-shot subprocess path.
 
 If `quse` is not installed, `pocketshell usage` exits with code 127 and
 prints an install hint to stderr.
@@ -284,7 +300,7 @@ Run it locally before tagging:
 
 ```bash
 scripts/check-pypi-version.sh                  # local match check
-scripts/check-pypi-version.sh --check-tag v0.3.0
+scripts/check-pypi-version.sh --check-tag vX.Y.Z
 ```
 
 ### Bumping a release
@@ -364,15 +380,11 @@ as a permanent fallback.
 
 ## Why a unified CLI?
 
-The PocketShell app previously probed for two binaries (`quse`,
-`tmuxctl`) on every host. That meant two installs to keep up to date,
-two probes to surface failures from, and two PATH-discovery edge cases.
-A single `pocketshell` binary collapses those into one install, one
-probe, one bootstrap row. The Android bootstrap probe now derives PATH
-from the user's shell rc and prepends `$HOME/.local/bin`, `$HOME/bin`,
-and `$HOME/.cargo/bin` before probing, so cloned-repo or venv installs
-can be discovered without a manual app-side PATH field. The app keeps
-detecting `quse` and `tmuxctl` as a parallel path while `pocketshell`
-ramps up to feature parity; once parity is reached, the legacy probes
-are removed in a hard-cut follow-up (no compat shim — see decision D22
-in `docs/decisions.md`).
+The PocketShell app previously depended on multiple host-side tools.
+That meant separate installs to keep up to date, separate probes to
+surface failures from, and multiple PATH-discovery edge cases. A single
+`pocketshell` binary collapses that app-facing contract into one install,
+one probe, and one bootstrap row. The Android bootstrap probe now derives
+PATH from the user's shell rc and prepends `$HOME/.local/bin`,
+`$HOME/bin`, and `$HOME/.cargo/bin` before probing, so cloned-repo or
+venv installs can be discovered without a manual app-side PATH field.

{pocketshell-0.3.7 → pocketshell-0.3.9}/README.md

@@ -1,14 +1,10 @@
 # pocketshell
 
 Unified server-side Python utility for the [PocketShell](https://github.com/alexeygrigorev/pocketshell)
-Android client. Replaces the separately-installed `quse` and `tmuxctl`
-utilities the app currently probes for on every remote host.
-
-This first release ships the **skeleton plus the `pocketshell usage`
-subcommand only**. Follow-up rounds will add `jobs`, `agent-log`,
-`sessions`, `repos`, and an optional daemon mode. See
-[issue #170](https://github.com/alexeygrigorev/pocketshell/issues/170) for
-the design spike and phased roll-out plan.
+Android client. The app probes for this single helper on each remote
+host and uses its subcommands for usage, tmux session/job metadata,
+agent conversations, QR host setup, repository discovery, environment
+files, hooks, logs, and daemon lifecycle checks.
 
 ## Install
 
@@ -49,18 +45,38 @@ Without the extra, every other subcommand keeps working; only
 
 ## Usage
 
+Top-level commands in the current helper:
+
+```text
+pocketshell usage [provider] [--json]       # provider quota / usage
+pocketshell sessions list [--by activity]   # tmux session summaries
+pocketshell jobs ...                        # tmux recurring jobs
+pocketshell agent-log ...                   # agent conversation logs
+pocketshell repos list ...                  # local / GitHub repositories
+pocketshell env ...                         # .env / .envrc management
+pocketshell hooks ...                       # Claude/Codex/OpenCode hooks
+pocketshell logs ...                        # server-side trace sink
+pocketshell daemon ...                      # IPC daemon lifecycle
+pocketshell qr-share ...                    # SSH host QR import payloads
+```
+
+Run `pocketshell --help` or `pocketshell <command> --help` for the live
+flag set. Some parity subcommands still proxy through the existing host
+tools internally so their output remains byte-identical to what the app
+already parses.
+
+### `pocketshell usage`
+
 ```text
 pocketshell usage           # human-readable lines, one per provider
 pocketshell usage --json    # machine-readable JSON (consumed by the app)
 pocketshell usage codex     # filter to a single provider
 ```
 
-The output shape is byte-identical to `quse [provider] [--json]` so any
-consumer that already parses `quse` output keeps working when the app
-routes through `pocketshell usage` instead. Under the hood the first
-release delegates to the `quse` CLI via subprocess; later rounds will
-fold the provider-detection logic in directly and drop the subprocess
-hop.
+The output shape is byte-identical to `quse [provider] [--json]`. When
+the IPC daemon is running, `usage --json` dispatches `usage.fetch` over
+the daemon socket and uses the daemon's short TTL cache; otherwise it
+falls through to the one-shot subprocess path.
 
 If `quse` is not installed, `pocketshell usage` exits with code 127 and
 prints an install hint to stderr.
@@ -256,7 +272,7 @@ Run it locally before tagging:
 
 ```bash
 scripts/check-pypi-version.sh                  # local match check
-scripts/check-pypi-version.sh --check-tag v0.3.0
+scripts/check-pypi-version.sh --check-tag vX.Y.Z
 ```
 
 ### Bumping a release
@@ -336,15 +352,11 @@ as a permanent fallback.
 
 ## Why a unified CLI?
 
-The PocketShell app previously probed for two binaries (`quse`,
-`tmuxctl`) on every host. That meant two installs to keep up to date,
-two probes to surface failures from, and two PATH-discovery edge cases.
-A single `pocketshell` binary collapses those into one install, one
-probe, one bootstrap row. The Android bootstrap probe now derives PATH
-from the user's shell rc and prepends `$HOME/.local/bin`, `$HOME/bin`,
-and `$HOME/.cargo/bin` before probing, so cloned-repo or venv installs
-can be discovered without a manual app-side PATH field. The app keeps
-detecting `quse` and `tmuxctl` as a parallel path while `pocketshell`
-ramps up to feature parity; once parity is reached, the legacy probes
-are removed in a hard-cut follow-up (no compat shim — see decision D22
-in `docs/decisions.md`).
+The PocketShell app previously depended on multiple host-side tools.
+That meant separate installs to keep up to date, separate probes to
+surface failures from, and multiple PATH-discovery edge cases. A single
+`pocketshell` binary collapses that app-facing contract into one install,
+one probe, and one bootstrap row. The Android bootstrap probe now derives
+PATH from the user's shell rc and prepends `$HOME/.local/bin`,
+`$HOME/bin`, and `$HOME/.cargo/bin` before probing, so cloned-repo or
+venv installs can be discovered without a manual app-side PATH field.

{pocketshell-0.3.7 → pocketshell-0.3.9}/pyproject.toml

@@ -8,7 +8,7 @@ name = "pocketshell"
 # scripts/check-pypi-version.sh enforces this; .github/workflows/build.yml
 # runs that check before publishing to PyPI. See
 # tools/pocketshell/README.md ("Release flow") for the bump procedure.
-version = "0.3.7"
+version = "0.3.9"
 description = "Unified server-side Python utility for the PocketShell Android client."
 readme = "README.md"
 requires-python = ">=3.11"

{pocketshell-0.3.7 → pocketshell-0.3.9}/src/pocketshell/__init__.py

@@ -10,5 +10,20 @@ See https://github.com/alexeygrigorev/pocketshell/issues/170.
 
 from __future__ import annotations
 
+import tomllib
+from importlib.metadata import PackageNotFoundError, version
+from pathlib import Path
+
 __all__ = ["__version__"]
-__version__ = "0.3.6"
+
+
+def _metadata_version() -> str:
+    try:
+        return version("pocketshell")
+    except PackageNotFoundError:
+        pyproject = Path(__file__).resolve().parents[2] / "pyproject.toml"
+        with pyproject.open("rb") as handle:
+            return tomllib.load(handle)["project"]["version"]
+
+
+__version__ = _metadata_version()

pocketshell-0.3.9/tests/test_cli.py

@@ -0,0 +1,27 @@
+from __future__ import annotations
+
+import tomllib
+from pathlib import Path
+
+from click.testing import CliRunner
+
+from pocketshell import __version__
+from pocketshell.cli import cli
+
+
+def _pyproject_version() -> str:
+    pyproject = Path(__file__).resolve().parents[1] / "pyproject.toml"
+    with pyproject.open("rb") as handle:
+        return tomllib.load(handle)["project"]["version"]
+
+
+def test_internal_version_matches_pyproject_metadata() -> None:
+    assert __version__ == _pyproject_version()
+
+
+def test_top_level_version_matches_pyproject_metadata() -> None:
+    runner = CliRunner()
+    result = runner.invoke(cli, ["--version"])
+
+    assert result.exit_code == 0, result.output
+    assert result.output == f"pocketshell, version {_pyproject_version()}\n"

{pocketshell-0.3.7 → pocketshell-0.3.9}/uv.lock

@@ -143,7 +143,7 @@ wheels = [
 
 [[package]]
 name = "pocketshell"
-version = "0.3.6"
+version = "0.3.9"
 source = { editable = "." }
 dependencies = [
     { name = "click" },