code-analysis-client 1.0.5__tar.gz → 1.0.6__tar.gz

{code_analysis_client-1.0.5 → code_analysis_client-1.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-analysis-client
-Version: 1.0.5
+Version: 1.0.6
 Summary: Async JSON-RPC client for the code-analysis MCP server (mcp-proxy-adapter JsonRpcClient)
 Author-email: Vasiliy Zdanovskiy <vasilyvz@gmail.com>
 Requires-Python: >=3.10
@@ -75,7 +75,7 @@ async with CodeAnalysisAsyncClient(host="127.0.0.1", port=15001) as client:
 
 Use `call_unified_validated` when you need queue polling. Pass `refresh_schema=True` on a single call to bypass the in-memory schema cache.
 
-## High-level facades (aligned with server 1.0.3)
+## High-level facades (aligned with live server registry)
 
 The client does **not** wrap CST commands (`cst_load_file`, …) or legacy file I/O
 (`universal_file_read`, `read_project_text_file`, …). Those commands are removed
@@ -83,28 +83,42 @@ from the server registry. Use the facades below or generic `call` / `commands.*`
 
 | Facade | Property | Server commands |
 |--------|----------|-----------------|
-| Client DB sessions + transfer | `client.file_sessions` | `session_*`, `project_file_transfer_*`, `project_file_advisory_lock_batch` |
+| Client DB sessions + transfer | `client.file_sessions` | `session_*`, `subordinate_session_*`, `project_file_transfer_*`, `project_file_advisory_lock_batch` |
 | Universal edit sessions | `client.universal_files` | `universal_file_open`, `edit`, `write`, `close`, `preview` |
 | Any registered command | `client.call` / `client.commands.<name>` | schema from live `help()` |
 
-Canonical command lists: `code_analysis_client.server_api` (also exported as
-`REMOVED_COMMANDS`, `CLIENT_FACADE_COMMANDS`).
+Canonical command lists: `code_analysis_client.server_api` — exported as
+`FILE_SESSION_COMMANDS`, `FILE_SESSION_FACADE_METHODS`, `CLIENT_FACADE_COMMANDS`,
+`REMOVED_COMMANDS`.
 
-Sync check (in-process registry):
+Sync checks (in-process registry):
 
 ```bash
-pytest tests/test_client_server_api_sync.py
+pytest tests/test_client_server_api_sync.py tests/test_code_analysis_client.py -k session
 ```
 
-Package version matches the **code-analysis** server project (currently **1.0.4**).
+Package version is in ``client/code_analysis_client/version.txt`` (synced with the
+root ``code-analysis`` project via ``scripts/sync_code_analysis_client_version.py``).
 
 ## Examples (this repository)
 
 Runnable scripts live under `client/examples/`. **Long-form “man page” style
 documentation** is embedded in the **module docstrings** of those Python files
-(see `client/examples/README.md` for how to read them). Full API walkthrough:
-`python client/examples/run_all_examples.py` with the daemon up and
-`CODE_ANALYSIS_CONFIG` or default `config.json` at the repo root.
+(see `client/examples/README.md` for how to read them).
+
+| Script | Purpose |
+|--------|---------|
+| `run_all_examples.py` | Full API tour + runs all live sibling scripts |
+| `ex_minimal_validated.py` | Smallest validated RPC example |
+| `ex_universal_files.py` | All `UniversalFileClient` methods (open/edit/write/close/preview) |
+| `ex_session_view_subordinates.py` | `session_view` and subordinate CRUD |
+| `ex_file_sessions.py` | Sessions, locks, transfer roundtrip |
+| `ex_config_only.py` | Parse `config.json` without TCP |
+
+```bash
+casmgr --config config.json start
+python client/examples/run_all_examples.py
+```
 
 ## Development
 

{code_analysis_client-1.0.5 → code_analysis_client-1.0.6}/README.md

@@ -63,7 +63,7 @@ async with CodeAnalysisAsyncClient(host="127.0.0.1", port=15001) as client:
 
 Use `call_unified_validated` when you need queue polling. Pass `refresh_schema=True` on a single call to bypass the in-memory schema cache.
 
-## High-level facades (aligned with server 1.0.3)
+## High-level facades (aligned with live server registry)
 
 The client does **not** wrap CST commands (`cst_load_file`, …) or legacy file I/O
 (`universal_file_read`, `read_project_text_file`, …). Those commands are removed
@@ -71,28 +71,42 @@ from the server registry. Use the facades below or generic `call` / `commands.*`
 
 | Facade | Property | Server commands |
 |--------|----------|-----------------|
-| Client DB sessions + transfer | `client.file_sessions` | `session_*`, `project_file_transfer_*`, `project_file_advisory_lock_batch` |
+| Client DB sessions + transfer | `client.file_sessions` | `session_*`, `subordinate_session_*`, `project_file_transfer_*`, `project_file_advisory_lock_batch` |
 | Universal edit sessions | `client.universal_files` | `universal_file_open`, `edit`, `write`, `close`, `preview` |
 | Any registered command | `client.call` / `client.commands.<name>` | schema from live `help()` |
 
-Canonical command lists: `code_analysis_client.server_api` (also exported as
-`REMOVED_COMMANDS`, `CLIENT_FACADE_COMMANDS`).
+Canonical command lists: `code_analysis_client.server_api` — exported as
+`FILE_SESSION_COMMANDS`, `FILE_SESSION_FACADE_METHODS`, `CLIENT_FACADE_COMMANDS`,
+`REMOVED_COMMANDS`.
 
-Sync check (in-process registry):
+Sync checks (in-process registry):
 
 ```bash
-pytest tests/test_client_server_api_sync.py
+pytest tests/test_client_server_api_sync.py tests/test_code_analysis_client.py -k session
 ```
 
-Package version matches the **code-analysis** server project (currently **1.0.4**).
+Package version is in ``client/code_analysis_client/version.txt`` (synced with the
+root ``code-analysis`` project via ``scripts/sync_code_analysis_client_version.py``).
 
 ## Examples (this repository)
 
 Runnable scripts live under `client/examples/`. **Long-form “man page” style
 documentation** is embedded in the **module docstrings** of those Python files
-(see `client/examples/README.md` for how to read them). Full API walkthrough:
-`python client/examples/run_all_examples.py` with the daemon up and
-`CODE_ANALYSIS_CONFIG` or default `config.json` at the repo root.
+(see `client/examples/README.md` for how to read them).
+
+| Script | Purpose |
+|--------|---------|
+| `run_all_examples.py` | Full API tour + runs all live sibling scripts |
+| `ex_minimal_validated.py` | Smallest validated RPC example |
+| `ex_universal_files.py` | All `UniversalFileClient` methods (open/edit/write/close/preview) |
+| `ex_session_view_subordinates.py` | `session_view` and subordinate CRUD |
+| `ex_file_sessions.py` | Sessions, locks, transfer roundtrip |
+| `ex_config_only.py` | Parse `config.json` without TCP |
+
+```bash
+casmgr --config config.json start
+python client/examples/run_all_examples.py
+```
 
 ## Development
 

{code_analysis_client-1.0.5 → code_analysis_client-1.0.6}/code_analysis_client/__init__.py

@@ -21,6 +21,8 @@ from code_analysis_client.file_session import FileSessionClient, SessionNotFound
 from code_analysis_client.server_api import (
     CLIENT_FACADE_COMMANDS,
     CST_REMOVED_COMMANDS,
+    FILE_SESSION_COMMANDS,
+    FILE_SESSION_FACADE_METHODS,
     LEGACY_REMOVED_COMMANDS,
     REMOVED_COMMANDS,
     UNIVERSAL_FILE_COMMANDS,
@@ -40,6 +42,8 @@ __all__ = [
     "CST_REMOVED_COMMANDS",
     "ClientValidationError",
     "CodeAnalysisAsyncClient",
+    "FILE_SESSION_COMMANDS",
+    "FILE_SESSION_FACADE_METHODS",
     "FileSessionClient",
     "LEGACY_REMOVED_COMMANDS",
     "REMOVED_COMMANDS",

{code_analysis_client-1.0.5 → code_analysis_client-1.0.6}/code_analysis_client/client.py

@@ -123,7 +123,7 @@ class CodeAnalysisAsyncClient:
 
     @property
     def file_sessions(self) -> FileSessionClient:
-        """Session-scoped download/upload and lock workflow (``session_*``, transfer)."""
+        """Session workflow: ``session_*``, ``subordinate_session_*``, transfer, advisory locks."""
         return FileSessionClient(self)
 
     @property

{code_analysis_client-1.0.5 → code_analysis_client-1.0.6}/code_analysis_client/file_session.py

@@ -1,9 +1,8 @@
 """
 High-level file transfer and session workflow on top of CodeAnalysisAsyncClient.
 
-Hides transfer/lock command names behind a small API: create a client session,
-download a project file with an advisory lock, upload changes with unlock, and
-lock/unlock indexed files without moving bytes.
+Wraps ``session_*`` and ``subordinate_session_*`` MCP commands plus transfer and
+advisory-lock commands that accept ``session_id``.
 
 Author: Vasiliy Zdanovskiy
 email: vasilyvz@gmail.com
@@ -32,6 +31,24 @@ def _unwrap(data: Dict[str, Any]) -> Dict[str, Any]:
     )
 
 
+def _require_non_empty(value: str, *, field: str) -> str:
+    text = str(value or "").strip()
+    if not text:
+        raise ClientValidationError(f"{field} is required", field=field)
+    return text
+
+
+def _validate_download_target(*, file_id: Optional[str]) -> None:
+    """Download requires ``file_id``."""
+    fid = str(file_id or "").strip()
+    if not fid:
+        raise ClientValidationError("file_id is required", field="file_id")
+
+
+def _lock_mode_from_flag(lock: bool) -> str:
+    return "full" if lock else "none"
+
+
 def _extract_file_id(payload: Dict[str, Any], *, field: str = "file_id") -> str:
     """Return non-empty ``file_id`` from a command payload or raise."""
     fid = str(payload.get(field) or "").strip()
@@ -45,7 +62,7 @@ def _extract_file_id(payload: Dict[str, Any], *, field: str = "file_id") -> str:
 
 
 class FileSessionClient:
-    """Session-scoped file download/upload and lock helpers."""
+    """Session-scoped DB sessions, subordinate links, file locks, and transfer helpers."""
 
     __slots__ = ("_client",)
 
@@ -87,14 +104,163 @@ class FileSessionClient:
     async def delete_session(
         self, session_id: str, *, force: bool = False
     ) -> Dict[str, Any]:
-        """Delete a client session (``session_delete``)."""
+        """Delete a client session (``session_delete``).
+
+        ``force`` defaults to false (omit on the wire when false). Safe delete
+        requires no ``session_file_locks`` and no ``subordinate_sessions`` rows
+        where this session is ``parent_session_id``. When ``force`` is true,
+        linked subordinate client sessions and file locks are removed first.
+
+        Returns ``session_id``, ``deleted``, ``released_lock_count``, and
+        ``released_subordinate_count``.
+        """
+        params: Dict[str, Any] = {"session_id": session_id}
+        if force:
+            params["force"] = True
         return _unwrap(
             await self._client.call_validated(
                 "session_delete",
-                {"session_id": session_id, "force": force},
+                params,
+            )
+        )
+
+    async def view_session(self, session_id: str) -> Dict[str, Any]:
+        """Aggregated session view (``session_view``).
+
+        Returns ``locked_files_by_project`` (file_id, file_path,
+        project_presentation per project) and ``subordinate_sessions``
+        (subordinate_session_id, server_uuid, session_presentation,
+        server_presentation, link_comment).
+        """
+        sid = _require_non_empty(session_id, field="session_id")
+        return _unwrap(
+            await self._client.call_validated(
+                "session_view",
+                {"session_id": sid},
+            )
+        )
+
+    async def create_subordinate_session(
+        self,
+        parent_session_id: str,
+        subordinate_session_id: str,
+        comment: str,
+        *,
+        server_uuid: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """Link subordinate to parent (``subordinate_session_create``).
+
+        ``server_uuid`` defaults to the server's ``registration.instance_uuid``
+        when omitted.
+        """
+        params: Dict[str, Any] = {
+            "parent_session_id": _require_non_empty(
+                parent_session_id, field="parent_session_id"
+            ),
+            "subordinate_session_id": _require_non_empty(
+                subordinate_session_id, field="subordinate_session_id"
+            ),
+            "comment": comment,
+        }
+        if server_uuid is not None:
+            params["server_uuid"] = _require_non_empty(server_uuid, field="server_uuid")
+        return _unwrap(
+            await self._client.call_validated("subordinate_session_create", params)
+        )
+
+    async def get_subordinate_session(
+        self,
+        parent_session_id: str,
+        subordinate_session_id: str,
+        server_uuid: str,
+    ) -> Dict[str, Any]:
+        """Fetch one subordinate link (``subordinate_session_get``)."""
+        return _unwrap(
+            await self._client.call_validated(
+                "subordinate_session_get",
+                {
+                    "parent_session_id": _require_non_empty(
+                        parent_session_id, field="parent_session_id"
+                    ),
+                    "subordinate_session_id": _require_non_empty(
+                        subordinate_session_id, field="subordinate_session_id"
+                    ),
+                    "server_uuid": _require_non_empty(server_uuid, field="server_uuid"),
+                },
             )
         )
 
+    async def update_subordinate_session(
+        self,
+        parent_session_id: str,
+        subordinate_session_id: str,
+        server_uuid: str,
+        comment: str,
+    ) -> Dict[str, Any]:
+        """Update link comment (``subordinate_session_update``)."""
+        return _unwrap(
+            await self._client.call_validated(
+                "subordinate_session_update",
+                {
+                    "parent_session_id": _require_non_empty(
+                        parent_session_id, field="parent_session_id"
+                    ),
+                    "subordinate_session_id": _require_non_empty(
+                        subordinate_session_id, field="subordinate_session_id"
+                    ),
+                    "server_uuid": _require_non_empty(server_uuid, field="server_uuid"),
+                    "comment": comment,
+                },
+            )
+        )
+
+    async def delete_subordinate_session(
+        self,
+        parent_session_id: str,
+        subordinate_session_id: str,
+        server_uuid: str,
+    ) -> Dict[str, Any]:
+        """Remove subordinate link only (``subordinate_session_delete``).
+
+        Does not delete ``client_sessions`` rows; use :meth:`delete_session` for that.
+        """
+        return _unwrap(
+            await self._client.call_validated(
+                "subordinate_session_delete",
+                {
+                    "parent_session_id": _require_non_empty(
+                        parent_session_id, field="parent_session_id"
+                    ),
+                    "subordinate_session_id": _require_non_empty(
+                        subordinate_session_id, field="subordinate_session_id"
+                    ),
+                    "server_uuid": _require_non_empty(server_uuid, field="server_uuid"),
+                },
+            )
+        )
+
+    async def list_subordinate_sessions(
+        self,
+        *,
+        parent_session_id: Optional[str] = None,
+        subordinate_session_id: Optional[str] = None,
+        server_uuid: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """List subordinate links (``subordinate_session_list``).
+
+        Returns ``links`` and ``count``. All filter parameters are optional.
+        """
+        params: Dict[str, Any] = {}
+        if parent_session_id is not None:
+            params["parent_session_id"] = parent_session_id
+        if subordinate_session_id is not None:
+            params["subordinate_session_id"] = subordinate_session_id
+        if server_uuid is not None:
+            params["server_uuid"] = server_uuid
+        return _unwrap(
+            await self._client.call_validated("subordinate_session_list", params)
+        )
+
     async def list_sessions(
         self,
         *,
@@ -217,32 +383,27 @@ class FileSessionClient:
             )
         )
 
-    async def begin_download_locked(
+    async def _begin_download(
         self,
         session_id: str,
         *,
-        project_id: Optional[str] = None,
-        file_id: Optional[str] = None,
-        file_path: Optional[str] = None,
+        file_id: str,
         compression: str = "identity",
-        lock_mode: str = "full",
+        lock: bool = True,
         chunk_size: Optional[int] = None,
         include_backup_history: bool = False,
     ) -> Dict[str, Any]:
         """Begin chunked download; returns payload including ``file_id`` and ``transfer_id``."""
+        fid = _require_non_empty(file_id, field="file_id")
+        _validate_download_target(file_id=fid)
         await self.assert_session_exists(session_id)
         params: Dict[str, Any] = {
             "session_id": session_id,
             "compression": compression,
-            "lock_mode": lock_mode,
+            "lock_mode": _lock_mode_from_flag(lock),
             "include_backup_history": include_backup_history,
+            "file_id": fid,
         }
-        if project_id is not None:
-            params["project_id"] = project_id
-        if file_id is not None:
-            params["file_id"] = file_id
-        if file_path is not None:
-            params["file_path"] = file_path
         if chunk_size is not None:
             params["chunk_size"] = chunk_size
         payload = _unwrap(
@@ -254,36 +415,24 @@ class FileSessionClient:
         _extract_file_id(payload)
         return payload
 
-    async def download_to_path(
-        self,
-        transfer_id: str,
-        destination: Union[str, Path],
-    ) -> Any:
-        """Stream download chunks to ``destination`` via the adapter client."""
-        return await self._client.rpc.download_file(
-            str(transfer_id).strip(),
-            str(destination),
-        )
-
-    async def download_file_locked(
+    async def download(
         self,
         session_id: str,
         destination: Union[str, Path],
+        file_id: str,
         *,
-        project_id: Optional[str] = None,
-        file_id: Optional[str] = None,
-        file_path: Optional[str] = None,
         compression: str = "identity",
-        lock_mode: str = "full",
+        lock: bool = True,
+        include_backup_history: bool = False,
     ) -> Tuple[Dict[str, Any], Any]:
-        """Download + lock; returns (begin_payload with ``file_id``, download_receipt)."""
-        begin = await self.begin_download_locked(
+        """Download an indexed file by ``file_id``; returns (begin_payload, receipt)."""
+        fid = _require_non_empty(file_id, field="file_id")
+        begin = await self._begin_download(
             session_id,
-            project_id=project_id,
-            file_id=file_id,
-            file_path=file_path,
+            file_id=fid,
             compression=compression,
-            lock_mode=lock_mode,
+            lock=lock,
+            include_backup_history=include_backup_history,
         )
         transfer_id = str(begin.get("transfer_id") or "").strip()
         if not transfer_id:
@@ -295,6 +444,17 @@ class FileSessionClient:
         receipt = await self.download_to_path(transfer_id, destination)
         return begin, receipt
 
+    async def download_to_path(
+        self,
+        transfer_id: str,
+        destination: Union[str, Path],
+    ) -> Any:
+        """Stream download chunks to ``destination`` via the adapter client."""
+        return await self._client.rpc.download_file(
+            str(transfer_id).strip(),
+            str(destination),
+        )
+
     async def upload_bytes(
         self,
         payload: bytes,
@@ -315,7 +475,7 @@ class FileSessionClient:
             if dest.is_file():
                 dest.unlink(missing_ok=True)
 
-    async def save_upload_and_unlock(
+    async def _commit_upload(
         self,
         session_id: str,
         transfer_id: str,
@@ -327,7 +487,7 @@ class FileSessionClient:
         dry_run: bool = False,
         backup: bool = True,
     ) -> Dict[str, Any]:
-        """Persist uploaded buffer and release locks; response includes ``file_id``."""
+        """Persist a completed adapter upload (``project_file_transfer_upload_save``)."""
         await self.assert_session_exists(session_id)
         params: Dict[str, Any] = {
             "session_id": session_id,
@@ -342,31 +502,78 @@ class FileSessionClient:
             params["file_id"] = file_id
         if file_path is not None:
             params["file_path"] = file_path
-        payload = _unwrap(
+        return _unwrap(
             await self._client.call_validated(
                 "project_file_transfer_upload_save",
                 params,
             )
         )
-        if not dry_run:
-            _extract_file_id(payload)
-        return payload
 
-    async def upload_file_and_unlock(
+    async def upload_new(
         self,
         session_id: str,
         payload: bytes,
+        project_id: str,
+        file_path: str,
         *,
-        project_id: Optional[str] = None,
-        file_id: Optional[str] = None,
-        file_path: Optional[str] = None,
         filename: Optional[str] = None,
         compression: str = "identity",
-        unlock_after_write: bool = True,
+        unlock: bool = True,
+        dry_run: bool = False,
         backup: bool = True,
+    ) -> str:
+        """Create a new project file from uploaded bytes; returns the new ``file_id``.
+
+        ``project_id`` and project-relative ``file_path`` are required. The path must
+        not already be indexed in the database (new file). Server errors otherwise.
+        """
+        pid = _require_non_empty(project_id, field="project_id")
+        fp = _require_non_empty(file_path, field="file_path")
+        name = filename or Path(fp).name
+        receipt = await self.upload_bytes(
+            payload,
+            filename=name,
+            compression=compression,
+        )
+        if not getattr(receipt, "completed", False):
+            raise ClientValidationError(
+                "upload did not complete",
+                field="transfer_id",
+                details={"receipt": repr(receipt)},
+            )
+        saved = await self._commit_upload(
+            session_id,
+            str(receipt.transfer_id),
+            project_id=pid,
+            file_path=fp,
+            unlock_after_write=unlock,
+            backup=backup,
+            dry_run=dry_run,
+        )
+        if dry_run:
+            fid = str(saved.get("file_id") or "").strip()
+            return fid
+        return _extract_file_id(saved)
+
+    async def upload(
+        self,
+        session_id: str,
+        payload: bytes,
+        file_id: str,
+        *,
+        filename: Optional[str] = None,
+        compression: str = "identity",
+        unlock: bool = True,
+        backup: bool = True,
+        dry_run: bool = False,
     ) -> Dict[str, Any]:
-        """Upload bytes, save to project file, unlock; returns save payload with ``file_id``."""
-        name = filename or (Path(file_path).name if file_path else "payload.bin")
+        """Overwrite an existing indexed file from uploaded bytes.
+
+        Only ``file_id`` is required. Returns the server save payload on success
+        or raises :class:`ClientValidationError` on failure.
+        """
+        fid = _require_non_empty(file_id, field="file_id")
+        name = filename or "payload.bin"
         receipt = await self.upload_bytes(
             payload,
             filename=name,
@@ -378,12 +585,14 @@ class FileSessionClient:
                 field="transfer_id",
                 details={"receipt": repr(receipt)},
             )
-        return await self.save_upload_and_unlock(
+        saved = await self._commit_upload(
             session_id,
             str(receipt.transfer_id),
-            project_id=project_id,
-            file_id=file_id,
-            file_path=file_path,
-            unlock_after_write=unlock_after_write,
+            file_id=fid,
+            unlock_after_write=unlock,
             backup=backup,
+            dry_run=dry_run,
         )
+        if not dry_run:
+            _extract_file_id(saved)
+        return saved

{code_analysis_client-1.0.5 → code_analysis_client-1.0.6}/code_analysis_client/server_api.py

@@ -12,7 +12,7 @@ email: vasilyvz@gmail.com
 
 from __future__ import annotations
 
-from typing import Callable, FrozenSet
+from typing import Callable, Dict, FrozenSet
 
 # Removed from the public server surface — do not use in client facades or docs.
 LEGACY_REMOVED_COMMANDS: FrozenSet[str] = frozenset(
@@ -54,9 +54,15 @@ FILE_SESSION_COMMANDS: FrozenSet[str] = frozenset(
         "session_create",
         "session_delete",
         "session_list",
+        "session_view",
         "session_open_file",
         "session_close_file",
         "session_list_file_locks",
+        "subordinate_session_create",
+        "subordinate_session_get",
+        "subordinate_session_update",
+        "subordinate_session_delete",
+        "subordinate_session_list",
     }
 )
 
@@ -82,6 +88,41 @@ CLIENT_FACADE_COMMANDS: FrozenSet[str] = (
     FILE_SESSION_COMMANDS | TRANSFER_AND_LOCK_COMMANDS | UNIVERSAL_FILE_COMMANDS
 )
 
+# ``FileSessionClient`` method names for each ``FILE_SESSION_COMMANDS`` entry.
+# ``session_list_file_locks`` is also used by ``assert_session_exists``.
+FILE_SESSION_FACADE_METHODS: Dict[str, str] = {
+    "session_create": "create_session",
+    "session_delete": "delete_session",
+    "session_list": "list_sessions",
+    "session_view": "view_session",
+    "session_open_file": "lock_file",
+    "session_close_file": "unlock_file",
+    "session_list_file_locks": "list_file_locks",
+    "subordinate_session_create": "create_subordinate_session",
+    "subordinate_session_get": "get_subordinate_session",
+    "subordinate_session_update": "update_subordinate_session",
+    "subordinate_session_delete": "delete_subordinate_session",
+    "subordinate_session_list": "list_subordinate_sessions",
+}
+
+
+def assert_file_session_facade_complete() -> None:
+    """Raise ``AssertionError`` if ``FILE_SESSION_FACADE_METHODS`` is incomplete."""
+    missing_cmds = FILE_SESSION_COMMANDS - set(FILE_SESSION_FACADE_METHODS)
+    extra_cmds = set(FILE_SESSION_FACADE_METHODS) - FILE_SESSION_COMMANDS
+    if missing_cmds or extra_cmds:
+        raise AssertionError(
+            "FILE_SESSION_FACADE_METHODS out of sync with FILE_SESSION_COMMANDS: "
+            f"missing={sorted(missing_cmds)!r} extra={sorted(extra_cmds)!r}"
+        )
+    from code_analysis_client.file_session import FileSessionClient
+
+    for command, method_name in FILE_SESSION_FACADE_METHODS.items():
+        if not hasattr(FileSessionClient, method_name):
+            raise AssertionError(
+                f"FileSessionClient missing method {method_name!r} for command {command!r}"
+            )
+
 
 def _command_registered(get_command: Callable[[str], object], name: str) -> bool:
     try:

code_analysis_client-1.0.6/code_analysis_client/version.txt

@@ -0,0 +1 @@
+1.0.6

{code_analysis_client-1.0.5 → code_analysis_client-1.0.6}/code_analysis_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-analysis-client
-Version: 1.0.5
+Version: 1.0.6
 Summary: Async JSON-RPC client for the code-analysis MCP server (mcp-proxy-adapter JsonRpcClient)
 Author-email: Vasiliy Zdanovskiy <vasilyvz@gmail.com>
 Requires-Python: >=3.10
@@ -75,7 +75,7 @@ async with CodeAnalysisAsyncClient(host="127.0.0.1", port=15001) as client:
 
 Use `call_unified_validated` when you need queue polling. Pass `refresh_schema=True` on a single call to bypass the in-memory schema cache.
 
-## High-level facades (aligned with server 1.0.3)
+## High-level facades (aligned with live server registry)
 
 The client does **not** wrap CST commands (`cst_load_file`, …) or legacy file I/O
 (`universal_file_read`, `read_project_text_file`, …). Those commands are removed
@@ -83,28 +83,42 @@ from the server registry. Use the facades below or generic `call` / `commands.*`
 
 | Facade | Property | Server commands |
 |--------|----------|-----------------|
-| Client DB sessions + transfer | `client.file_sessions` | `session_*`, `project_file_transfer_*`, `project_file_advisory_lock_batch` |
+| Client DB sessions + transfer | `client.file_sessions` | `session_*`, `subordinate_session_*`, `project_file_transfer_*`, `project_file_advisory_lock_batch` |
 | Universal edit sessions | `client.universal_files` | `universal_file_open`, `edit`, `write`, `close`, `preview` |
 | Any registered command | `client.call` / `client.commands.<name>` | schema from live `help()` |
 
-Canonical command lists: `code_analysis_client.server_api` (also exported as
-`REMOVED_COMMANDS`, `CLIENT_FACADE_COMMANDS`).
+Canonical command lists: `code_analysis_client.server_api` — exported as
+`FILE_SESSION_COMMANDS`, `FILE_SESSION_FACADE_METHODS`, `CLIENT_FACADE_COMMANDS`,
+`REMOVED_COMMANDS`.
 
-Sync check (in-process registry):
+Sync checks (in-process registry):
 
 ```bash
-pytest tests/test_client_server_api_sync.py
+pytest tests/test_client_server_api_sync.py tests/test_code_analysis_client.py -k session
 ```
 
-Package version matches the **code-analysis** server project (currently **1.0.4**).
+Package version is in ``client/code_analysis_client/version.txt`` (synced with the
+root ``code-analysis`` project via ``scripts/sync_code_analysis_client_version.py``).
 
 ## Examples (this repository)
 
 Runnable scripts live under `client/examples/`. **Long-form “man page” style
 documentation** is embedded in the **module docstrings** of those Python files
-(see `client/examples/README.md` for how to read them). Full API walkthrough:
-`python client/examples/run_all_examples.py` with the daemon up and
-`CODE_ANALYSIS_CONFIG` or default `config.json` at the repo root.
+(see `client/examples/README.md` for how to read them).
+
+| Script | Purpose |
+|--------|---------|
+| `run_all_examples.py` | Full API tour + runs all live sibling scripts |
+| `ex_minimal_validated.py` | Smallest validated RPC example |
+| `ex_universal_files.py` | All `UniversalFileClient` methods (open/edit/write/close/preview) |
+| `ex_session_view_subordinates.py` | `session_view` and subordinate CRUD |
+| `ex_file_sessions.py` | Sessions, locks, transfer roundtrip |
+| `ex_config_only.py` | Parse `config.json` without TCP |
+
+```bash
+casmgr --config config.json start
+python client/examples/run_all_examples.py
+```
 
 ## Development
 

code_analysis_client-1.0.5/code_analysis_client/version.txt

@@ -1 +0,0 @@
-1.0.5