code-analysis-client 1.6.302__tar.gz → 1.6.304__tar.gz

{code_analysis_client-1.6.302 → code_analysis_client-1.6.304}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-analysis-client
-Version: 1.6.302
+Version: 1.6.304
 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

{code_analysis_client-1.6.302 → code_analysis_client-1.6.304}/code_analysis_client/check_chain.py

@@ -167,7 +167,10 @@ class FileCheckAndPromoteResult:
     diagnostics: List[Diagnostic]
     degraded: Optional[Degraded]
     raw: Dict[str, Any] = field(default_factory=dict, compare=False, repr=False)
-    # Write-back state of a promoted documentation copy (None for an ordinary file).
+    # Delivered write-back of a promoted documentation copy: {document_id, file_path,
+    # status "transferred"}; None for an ordinary file. A failed write-back is not a result:
+    # the server answers an error (CheckChainError, e.g. DOCUMENTATION_SERVER_UNAVAILABLE)
+    # whose details carry promoted, commit, edit_kept and holder_session_id.
     documentation_transfer: Optional[Dict[str, Any]] = None
     # Seconds spent waiting for the path lock and the project main lock
     # ({path_waited_seconds, main_waited_seconds}); None from an older server.
@@ -323,7 +326,10 @@ class CheckChainClient:
         Raises WorktreeConflictError on WORKTREE_SYNC_CONFLICT (with
         ``conflicts`` and ``preserved_locked_files``), CheckChainConfigInvalidError
         for a malformed registry entry, and CheckChainError (``code`` from the
-        closed enum, e.g. FCP_PROMOTE_RACE) for every other server error.
+        closed enum, e.g. FCP_PROMOTE_RACE) for every other server error. A
+        documentation copy whose single write-back failed raises CheckChainError
+        too (DOCUMENTATION_SERVER_UNAVAILABLE, NOT_FOUND or INTERNAL_ERROR) although
+        the commit is promoted; the edit and the lock stay with the session.
         """
         project_id = _require_non_empty(project_id, field_name="project_id")
         editor_session_id = _require_non_empty(

{code_analysis_client-1.6.302 → code_analysis_client-1.6.304}/code_analysis_client/file_session.py

@@ -381,18 +381,26 @@ class FileSessionClient:
         session_id: str,
         project_id: str,
         file_id: str,
+        discard_documentation_edit: Optional[bool] = None,
     ) -> Dict[str, Any]:
-        """Release a DB file lock without transfer (``session_close_file``)."""
+        """Release a DB file lock without transfer (``session_close_file``).
+
+        ``discard_documentation_edit`` (sent only when not None) matters only for a fetched
+        documentation copy with an edit the documentation server did not receive: without it
+        (or False) the server refuses the close with DOCUMENTATION_EDIT_UNSENT and keeps the
+        lock; True releases the lock and deletes the copy and the edit. The result carries
+        ``documentation_edit_discarded``.
+        """
         await self.assert_session_exists(session_id)
+        params: Dict[str, Any] = {
+            "session_id": session_id,
+            "project_id": project_id,
+            "file_id": file_id,
+        }
+        if discard_documentation_edit is not None:
+            params["discard_documentation_edit"] = bool(discard_documentation_edit)
         return _unwrap(
-            await self._client.call_validated(
-                "session_close_file",
-                {
-                    "session_id": session_id,
-                    "project_id": project_id,
-                    "file_id": file_id,
-                },
-            )
+            await self._client.call_validated("session_close_file", params)
         )
 
     async def open_documentation_document(
@@ -405,9 +413,10 @@ class FileSessionClient:
 
         Returns ``session_id``, ``project_id``, ``document_id``, ``file_id``, ``file_path``
         (``<directory>/<document_id>-<name>``), ``created``, ``size_bytes``, ``sha256``,
-        ``documentation_transfer`` (``None`` or ``{document_id, file_path, status, attempts,
-        max_attempts, next_attempt_at, reason}``) and ``documentation_warning`` (``None`` or the
+        ``waited_seconds``, ``lock_file`` and ``documentation_warning`` (``None`` or the
         ``UNDELIVERED_EDITS_RECOVERED`` mapping the reader must be shown with the document).
+        The open never writes to the documentation server: saved edits are delivered by
+        ``file_check_and_promote``.
         """
         return _unwrap(
             await self._client.call_validated(

code_analysis_client-1.6.304/code_analysis_client/version.txt

@@ -0,0 +1 @@
+1.6.304

{code_analysis_client-1.6.302 → code_analysis_client-1.6.304}/code_analysis_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-analysis-client
-Version: 1.6.302
+Version: 1.6.304
 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

code_analysis_client-1.6.302/code_analysis_client/version.txt

@@ -1 +0,0 @@
-1.6.302