forgexa-cli 1.59.1__tar.gz → 1.60.0__tar.gz

{forgexa_cli-1.59.1 → forgexa_cli-1.60.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forgexa-cli
-Version: 1.59.1
+Version: 1.60.0
 Summary: Forgexa CLI — command-line client and AI agent runtime for the Forgexa platform
 Author-email: Jason Sun <dev.winds@gmail.com>
 License-Expression: MIT
@@ -35,7 +35,7 @@ Requires-Dist: socksio>=1.0.0; extra == "daemon"
 Command-line client and agent runtime for the [Forgexa](https://forgexa.net) platform.
 
 Communicates with the Forgexa server via REST API.
-Includes a built-in **daemon** that discovers twelve local AI agent integrations (Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, Kimi Code, MiMo Code, Qwen Code, CodeBuddy, Qoder CLI, TraeCode CLI, and ZCode) and executes tasks on behalf of the server. MiMo Code (`mimo`, v0.1.14+), Qwen Code (`qwen`, v0.24.1+), CodeBuddy (`codebuddy`, v2.156.0+), Qoder CLI (`qoder`, v1.1.59+), TraeCode CLI (`trae`), and ZCode (`zcode`) are selected explicitly; automatic routing and generated default fallback chains exclude all six. CodeBuddy and Qoder completed their local AgentHost start/resume acceptance gates. Authentication, endpoint, and model selection remain in each local CLI profile; Forgexa never stores or overrides them.
+Includes a built-in **daemon** with thirteen integrations: Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, Kimi Code, MiMo Code, Qwen Code, CodeBuddy, Qoder CLI, TraeCode CLI, ZCode, and DeepSeek Harness. Six standard candidates are automatically routed; seven require explicit selection. Harness (`deepseek-harness`) is a developer preview for personal Runtimes/Desktop, pinned to 0.2.0-rc.2 and Node 22.19+ within 22.x or 24+. It owns a managed runtime profile with read-only external credentials, without copying personal settings. Shared pools/native Windows are blocked. After exact-build live acceptance, `forgexa agent approve-live deepseek-harness` records an attestation; `forgexa check --agent deepseek-harness --quick` avoids model calls, while normal `check` runs a potentially billable minimal task. See [global/local installation and limits](../documentation/guide/agent-installation.md#deepseek-harness-developer-preview).
 
 ## Installation
 

{forgexa_cli-1.59.1 → forgexa_cli-1.60.0}/README.md

@@ -3,7 +3,7 @@
 Command-line client and agent runtime for the [Forgexa](https://forgexa.net) platform.
 
 Communicates with the Forgexa server via REST API.
-Includes a built-in **daemon** that discovers twelve local AI agent integrations (Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, Kimi Code, MiMo Code, Qwen Code, CodeBuddy, Qoder CLI, TraeCode CLI, and ZCode) and executes tasks on behalf of the server. MiMo Code (`mimo`, v0.1.14+), Qwen Code (`qwen`, v0.24.1+), CodeBuddy (`codebuddy`, v2.156.0+), Qoder CLI (`qoder`, v1.1.59+), TraeCode CLI (`trae`), and ZCode (`zcode`) are selected explicitly; automatic routing and generated default fallback chains exclude all six. CodeBuddy and Qoder completed their local AgentHost start/resume acceptance gates. Authentication, endpoint, and model selection remain in each local CLI profile; Forgexa never stores or overrides them.
+Includes a built-in **daemon** with thirteen integrations: Claude Code, Codex, GitHub Copilot, Gemini CLI, OpenCode, Kimi Code, MiMo Code, Qwen Code, CodeBuddy, Qoder CLI, TraeCode CLI, ZCode, and DeepSeek Harness. Six standard candidates are automatically routed; seven require explicit selection. Harness (`deepseek-harness`) is a developer preview for personal Runtimes/Desktop, pinned to 0.2.0-rc.2 and Node 22.19+ within 22.x or 24+. It owns a managed runtime profile with read-only external credentials, without copying personal settings. Shared pools/native Windows are blocked. After exact-build live acceptance, `forgexa agent approve-live deepseek-harness` records an attestation; `forgexa check --agent deepseek-harness --quick` avoids model calls, while normal `check` runs a potentially billable minimal task. See [global/local installation and limits](../documentation/guide/agent-installation.md#deepseek-harness-developer-preview).
 
 ## Installation
 

{forgexa_cli-1.59.1 → forgexa_cli-1.60.0}/forgexa_cli/__init__.py

@@ -1,2 +1,2 @@
 """forgexa-cli — Forgexa command-line client."""
-__version__ = "1.59.1"
+__version__ = "1.60.0"

{forgexa_cli-1.59.1 → forgexa_cli-1.60.0}/forgexa_cli/_local_bind.py

@@ -47,58 +47,34 @@ def save_local_workspaces_mapping(mapping: dict) -> None:
 
 
 @contextlib.contextmanager
-def local_workspaces_mapping_lock() -> Iterator[None]:
-    """Advisory cross-process lock for read-modify-write cycles on the
-    mapping file (multi-workspace parallel design §6.1/§6.3). Shares the
-    `local-workspaces.json.lock` path with the Desktop Rust writer (fd-lock
-    crate); without it, a CLI bind-local and a Desktop link running
-    concurrently could each drop the other's just-written entry. Best-effort:
-    platforms without fcntl/msvcrt degrade to lock-free (the atomic rename
-    still prevents torn files).
-    """
+def local_workspaces_mapping_lock(workspace_path: str | Path | None = None) -> Iterator[None]:
+    """Serialize mapping writes; lock or parse failures never degrade to unlocked writes."""
+    from forgexa_cli.agent_core import acquire_file_lock, release_file_lock
+
     path = local_workspaces_mapping_path()
     lock_path = path.with_name(path.name + ".lock")
+    lock_file = acquire_file_lock(lock_path, blocking=True)
+    if lock_file is None:
+        raise RuntimeError("Could not acquire the local workspace mapping write lock")
+    workspace_lock = None
     try:
-        path.parent.mkdir(parents=True, exist_ok=True)
-        lock_file = open(lock_path, "a+")
-    except OSError:
-        yield
-        return
-
-    lock_kind = None
-    try:
-        try:
-            import fcntl
-
-            fcntl.flock(lock_file.fileno(), fcntl.LOCK_EX)
-            lock_kind = "fcntl"
-        except ImportError:
+        if path.exists():
             try:
-                import msvcrt
-
-                lock_file.seek(0)
-                msvcrt.locking(lock_file.fileno(), msvcrt.LK_LOCK, 1)
-                lock_kind = "msvcrt"
-            except (ImportError, OSError):
-                pass
+                mapping = json.loads(path.read_text(encoding="utf-8"))
+                if not isinstance(mapping, dict):
+                    raise ValueError("Mapping must be a JSON object")
+            except (OSError, ValueError) as error:
+                raise RuntimeError("Local workspace mapping is unreadable; recover it before modifying bindings") from error
+        if workspace_path is not None:
+            from forgexa_cli.agent_core import acquire_workspace_write_lock
+
+            workspace_lock = acquire_workspace_write_lock(workspace_path)
+            if workspace_lock is None:
+                raise RuntimeError("A task or agent is writing this workspace; wait before changing its mapping")
         yield
     finally:
-        if lock_kind == "fcntl":
-            try:
-                import fcntl
-
-                fcntl.flock(lock_file.fileno(), fcntl.LOCK_UN)
-            except (ImportError, OSError):
-                pass
-        elif lock_kind == "msvcrt":
-            try:
-                import msvcrt
-
-                lock_file.seek(0)
-                msvcrt.locking(lock_file.fileno(), msvcrt.LK_UNLCK, 1)
-            except (ImportError, OSError):
-                pass
-        lock_file.close()
+        release_file_lock(workspace_lock)
+        release_file_lock(lock_file)
 
 
 _SSH_SCHEME_RE = re.compile(r"^ssh://(?:[^@/]+@)?([^/:]+)(?::\d+)?/(.+?)(?:\.git)?/?$")