forgexa-cli 1.24.5__tar.gz → 1.25.0__tar.gz

{forgexa_cli-1.24.5 → forgexa_cli-1.25.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forgexa-cli
-Version: 1.24.5
+Version: 1.25.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

{forgexa_cli-1.24.5 → forgexa_cli-1.25.0}/forgexa_cli/__init__.py

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

forgexa_cli-1.25.0/forgexa_cli/_local_bind.py

@@ -0,0 +1,83 @@
+"""Forgexa IDE local-bind: CLI-side mapping file + git identity helpers.
+
+Deliberately duplicates (does not import) the same logic already vendored
+in backend/app/daemon.py (which itself duplicates
+backend/app/services/git_url_normalize.py) — the CLI package and the
+standalone daemon module are each meant to run independently, and importing
+the full daemon.py module here would pull in its heavier import-time
+environment checks for no benefit. Keep this file's mapping format and
+normalize_repo_identity() in sync with daemon.py's versions if either ever
+changes. See docs/designs/forgexa-ide-design.md §6.1/§6.2/§6.4.
+"""
+from __future__ import annotations
+
+import json
+import os
+import re
+import subprocess
+from pathlib import Path
+
+
+def local_workspaces_mapping_path() -> Path:
+    return Path.home() / ".forgexa" / "local-workspaces.json"
+
+
+def load_local_workspaces_mapping() -> dict:
+    path = local_workspaces_mapping_path()
+    if not path.exists():
+        return {}
+    try:
+        data = json.loads(path.read_text(encoding="utf-8"))
+        return data if isinstance(data, dict) else {}
+    except (OSError, ValueError):
+        return {}
+
+
+def save_local_workspaces_mapping(mapping: dict) -> None:
+    """Write the mapping atomically with OS-user-private permissions."""
+    path = local_workspaces_mapping_path()
+    path.parent.mkdir(parents=True, exist_ok=True)
+    tmp_path = path.with_name(path.name + ".tmp")
+    tmp_path.write_text(json.dumps(mapping, indent=2, sort_keys=True), encoding="utf-8")
+    if os.name != "nt":
+        os.chmod(tmp_path, 0o600)
+    tmp_path.replace(path)
+
+
+_SSH_SCHEME_RE = re.compile(r"^ssh://(?:[^@/]+@)?([^/:]+)(?::\d+)?/(.+?)(?:\.git)?/?$")
+_HTTP_SCHEME_RE = re.compile(r"^https?://(?:[^@/]+@)?([^/:]+)(?::\d+)?/(.+?)(?:\.git)?/?$")
+_SCP_LIKE_RE = re.compile(r"^[^@/]+@([^:/]+):(.+?)(?:\.git)?/?$")
+
+
+def normalize_repo_identity(repo_url: str) -> str | None:
+    """Canonical host-inclusive git remote identity (see module docstring)."""
+    repo_url_clean = (repo_url or "").strip()
+    if not repo_url_clean:
+        return None
+
+    match = _SSH_SCHEME_RE.match(repo_url_clean) or _HTTP_SCHEME_RE.match(repo_url_clean)
+    if not match and "@" in repo_url_clean and "://" not in repo_url_clean:
+        match = _SCP_LIKE_RE.match(repo_url_clean)
+    if not match:
+        return None
+
+    host = match.group(1).lower()
+    path = match.group(2).strip("/").lower()
+    path = re.sub(r"^scm/", "", path)
+    if not path:
+        return None
+    return f"{host}/{path}"
+
+
+def local_git_remote_identity(path: Path) -> str | None:
+    """Best-effort `git remote get-url origin` + normalize, or None on any failure."""
+    try:
+        result = subprocess.run(
+            ["git", "remote", "get-url", "origin"],
+            cwd=str(path), capture_output=True, text=True, timeout=10,
+        )
+    except (OSError, subprocess.TimeoutExpired):
+        return None
+    if result.returncode != 0:
+        return None
+    return normalize_repo_identity(result.stdout.strip())