pocketshell 0.4.9__tar.gz → 0.4.11__tar.gz

{pocketshell-0.4.9 → pocketshell-0.4.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pocketshell
-Version: 0.4.9
+Version: 0.4.11
 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

{pocketshell-0.4.9 → pocketshell-0.4.11}/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.4.9"
+version = "0.4.11"
 description = "Unified server-side Python utility for the PocketShell Android client."
 readme = "README.md"
 requires-python = ">=3.11"

{pocketshell-0.4.9 → pocketshell-0.4.11}/src/pocketshell/cli.py

@@ -36,6 +36,7 @@ from pocketshell.push import push_group
 from pocketshell.qr_share import qr_share_command
 from pocketshell.repos import repos_group
 from pocketshell.sessions import sessions_group
+from pocketshell.tree import tree_group
 from pocketshell.usage import usage_command
 
 
@@ -60,6 +61,7 @@ cli.add_command(agents_group, name="agents")
 cli.add_command(profiles_group, name="profiles")
 cli.add_command(jobs_group, name="jobs")
 cli.add_command(sessions_group, name="sessions")
+cli.add_command(tree_group, name="tree")
 cli.add_command(agent_log_command, name="agent-log")
 cli.add_command(repos_group, name="repos")
 cli.add_command(github_group, name="github")

{pocketshell-0.4.9 → pocketshell-0.4.11}/src/pocketshell/daemon.py

@@ -92,6 +92,12 @@ METHOD_TTLS: Mapping[str, float] = {
     # not hidden for long.
     "sessions.list": 5.0,
     "jobs.list": 5.0,
+    # `tree.get` is the cold-start hydrate read. Short TTL like `sessions.list`
+    # so a `tree.upsert` mutation (which also invalidates it explicitly) is not
+    # masked for long and an external edit is not hidden. `tree.upsert` and
+    # `tree.reconcile` carry NO TTL (mutations) so their results are never
+    # cached.
+    "tree.get": 5.0,
 }
 
 # Length-prefix is a 4-byte unsigned big-endian integer. ``struct``
@@ -574,6 +580,32 @@ def _agents_kind_for_panes_handler(params: Mapping[str, Any]) -> dict[str, Any]:
     return {"results": _cgroup_agents.kind_for_panes(panes)}
 
 
+# ---------------------------------------------------------------------------
+# Methods: tree.* (epic #821 slice C / issue #837)
+# ---------------------------------------------------------------------------
+
+
+def _tree_get_handler(params: Mapping[str, Any]) -> dict[str, Any]:
+    """Delegate ``tree.get`` to the durable per-host tree registry."""
+    from pocketshell import tree as _tree
+
+    return _tree.daemon_handler_get(dict(params))
+
+
+def _tree_upsert_handler(params: Mapping[str, Any]) -> dict[str, Any]:
+    """Delegate ``tree.upsert`` to the durable per-host tree registry."""
+    from pocketshell import tree as _tree
+
+    return _tree.daemon_handler_upsert(dict(params))
+
+
+def _tree_reconcile_handler(params: Mapping[str, Any]) -> dict[str, Any]:
+    """Delegate ``tree.reconcile`` to the durable per-host tree registry."""
+    from pocketshell import tree as _tree
+
+    return _tree.daemon_handler_reconcile(dict(params))
+
+
 # Single shared registry; tests can register additional methods via
 # :meth:`Daemon.register_method` on a fresh instance without touching
 # this dict.
@@ -592,6 +624,9 @@ DEFAULT_METHODS: Mapping[str, RpcHandler] = {
     "jobs.remove": _jobs_remove_handler,
     "jobs.status": _jobs_status_handler,
     "agents.kind_for_panes": _agents_kind_for_panes_handler,
+    "tree.get": _tree_get_handler,
+    "tree.upsert": _tree_upsert_handler,
+    "tree.reconcile": _tree_reconcile_handler,
 }
 
 
@@ -612,6 +647,13 @@ METHOD_CACHE_INVALIDATIONS: Mapping[str, tuple[str, ...]] = {
     "jobs.edit": ("jobs.list",),
     "jobs.remove": ("jobs.list",),
     "jobs.trigger": ("jobs.list",),
+    # `tree.upsert` rewrites the host's persisted node list, so the cached
+    # `tree.get` cold-start read is stale the moment it lands — drop it so the
+    # very next `tree.get` reflects the just-persisted ordering/expansion.
+    # `tree.reconcile` prunes gone nodes from the registry, so it must also
+    # invalidate the `tree.get` cache.
+    "tree.upsert": ("tree.get",),
+    "tree.reconcile": ("tree.get",),
 }