codegraphcontext 0.4.17__tar.gz → 0.4.18__tar.gz

{codegraphcontext-0.4.17/src/codegraphcontext.egg-info → codegraphcontext-0.4.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegraphcontext
-Version: 0.4.17
+Version: 0.4.18
 Summary: An MCP server that indexes local code into a graph database to provide context to AI assistants.
 Author-email: Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 License: MIT License
@@ -96,7 +96,7 @@ Dynamic: license-file
 - 🇯🇵 [日本語](docs/translations/README.ja.md)
 - 🇪🇸 Español (Soon)
 
-🌍 **Help translate CodeGraphContext to your language by raising an issue & PR on https://github.com/Shashankss1205/CodeGraphContext/issues!**
+🌍 **Help translate CodeGraphContext to your language by raising an issue & PR on [GitHub Issues](https://github.com/Shashankss1205/CodeGraphContext/issues)!**
 
 <p align="center">
   <br>
@@ -185,7 +185,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 ---
 
 ## Project Details
-- **Version:** 0.4.17
+- **Version:** 0.4.18
 - **Authors:** Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 - **License:** MIT License (See [LICENSE](LICENSE) for details)
 - **Website:** [CodeGraphContext](http://codegraphcontext.vercel.app/)
@@ -214,7 +214,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 -   **Code Indexing:** Analyzes code and builds a knowledge graph of its components.
 -   **Relationship Analysis:** Query for callers, callees, class hierarchies, call chains and more.
 -   **Pre-indexed Bundles:** Load famous repositories instantly with `.cgc` bundles - no indexing required! ([Learn more](docs/BUNDLES.md))
--   **Live File Watching:** Watch directories for changes and automatically update the graph in real-time (`codegraphcontext watch`).
+-   **Live File Watching:** Watch directories for changes and automatically update the graph in real-time (`cgc watch`).
 -   **Interactive Setup:** A user-friendly command-line wizard for easy setup.
 -   **Dual Mode:** Works as a standalone **CLI toolkit** for developers and as an **MCP server** for AI agents.
 -   **Multi-Language Support:** Full support for 22 programming languages.
@@ -248,7 +248,7 @@ CodeGraphContext supports multiple graph database backends to suit your environm
 
 | Feature | KuzuDB | LadybugDB | FalkorDB Lite | Neo4j / Nornic DB |
 | :--- | :--- | :--- | :--- | :--- |
-| **Typical default** | **Standard Default** (embedded, powered by KuzuDB) | **Specialized Embedded** (similar to Kuzu) | **Unix** (Python 3.12+, when `falkordblite` works) | When explicitly configured |
+| **Typical default** | Cross-platform fallback when FalkorDB Lite is unavailable | Optional embedded backend | **Default on Unix** (Python 3.12+, when `falkordblite` is installed) | When explicitly configured via `cgc config db` |
 | **Setup** | Zero-config / Embedded | Zero-config / Embedded | Zero-config / In-process | Docker / External |
 | **Platform** | **All (Windows Native, macOS, Linux)** | **All (Windows Native, macOS, Linux)** | Unix-only (Linux/macOS/WSL) | All Platforms |
 | **Use Case** | Desktop, IDE, Local development | Custom research projects | Specialized Unix development | Enterprise, Massive graphs |

{codegraphcontext-0.4.17 → codegraphcontext-0.4.18}/README.md

@@ -11,7 +11,7 @@
 - 🇯🇵 [日本語](docs/translations/README.ja.md)
 - 🇪🇸 Español (Soon)
 
-🌍 **Help translate CodeGraphContext to your language by raising an issue & PR on https://github.com/Shashankss1205/CodeGraphContext/issues!**
+🌍 **Help translate CodeGraphContext to your language by raising an issue & PR on [GitHub Issues](https://github.com/Shashankss1205/CodeGraphContext/issues)!**
 
 <p align="center">
   <br>
@@ -100,7 +100,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 ---
 
 ## Project Details
-- **Version:** 0.4.17
+- **Version:** 0.4.18
 - **Authors:** Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 - **License:** MIT License (See [LICENSE](LICENSE) for details)
 - **Website:** [CodeGraphContext](http://codegraphcontext.vercel.app/)
@@ -129,7 +129,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 -   **Code Indexing:** Analyzes code and builds a knowledge graph of its components.
 -   **Relationship Analysis:** Query for callers, callees, class hierarchies, call chains and more.
 -   **Pre-indexed Bundles:** Load famous repositories instantly with `.cgc` bundles - no indexing required! ([Learn more](docs/BUNDLES.md))
--   **Live File Watching:** Watch directories for changes and automatically update the graph in real-time (`codegraphcontext watch`).
+-   **Live File Watching:** Watch directories for changes and automatically update the graph in real-time (`cgc watch`).
 -   **Interactive Setup:** A user-friendly command-line wizard for easy setup.
 -   **Dual Mode:** Works as a standalone **CLI toolkit** for developers and as an **MCP server** for AI agents.
 -   **Multi-Language Support:** Full support for 22 programming languages.
@@ -163,7 +163,7 @@ CodeGraphContext supports multiple graph database backends to suit your environm
 
 | Feature | KuzuDB | LadybugDB | FalkorDB Lite | Neo4j / Nornic DB |
 | :--- | :--- | :--- | :--- | :--- |
-| **Typical default** | **Standard Default** (embedded, powered by KuzuDB) | **Specialized Embedded** (similar to Kuzu) | **Unix** (Python 3.12+, when `falkordblite` works) | When explicitly configured |
+| **Typical default** | Cross-platform fallback when FalkorDB Lite is unavailable | Optional embedded backend | **Default on Unix** (Python 3.12+, when `falkordblite` is installed) | When explicitly configured via `cgc config db` |
 | **Setup** | Zero-config / Embedded | Zero-config / Embedded | Zero-config / In-process | Docker / External |
 | **Platform** | **All (Windows Native, macOS, Linux)** | **All (Windows Native, macOS, Linux)** | Unix-only (Linux/macOS/WSL) | All Platforms |
 | **Use Case** | Desktop, IDE, Local development | Custom research projects | Specialized Unix development | Enterprise, Massive graphs |

{codegraphcontext-0.4.17 → codegraphcontext-0.4.18}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codegraphcontext"
-version = "0.4.17"
+version = "0.4.18"
 description = "An MCP server that indexes local code into a graph database to provide context to AI assistants."
 authors = [{ name = "Shashank Shekhar Singh", email = "shashankshekharsingh1205@gmail.com" }]
 readme = "README.md"

{codegraphcontext-0.4.17 → codegraphcontext-0.4.18}/src/codegraphcontext/api/app.py

@@ -24,6 +24,11 @@ def create_app() -> FastAPI:
 
     app.include_router(router, prefix="/api/v1")
 
+    @app.get("/health")
+    async def health():
+        """Liveness probe for load balancers and k8s."""
+        return {"status": "ok"}
+
     # MCP-over-SSE Endpoints
     app.add_api_route("/api/v1/mcp/sse", handle_sse, methods=["GET"])
     app.add_api_route("/api/v1/mcp/messages", handle_messages, methods=["POST"])

{codegraphcontext-0.4.17 → codegraphcontext-0.4.18}/src/codegraphcontext/cli/cli_helpers.py

@@ -260,6 +260,10 @@ def index_helper(path: str, context: Optional[str] = None):
     """Synchronously indexes a repository in a given context."""
     time_start = time.time()
     path_obj = Path(path).resolve()
+    # Normalize to forward slashes for cross-platform DB consistency.
+    # The graph DB always stores paths via Path.resolve().as_posix(),
+    # so Cypher queries must also use forward slashes on Windows.
+    repo_path_str = path_obj.as_posix()
     index_cwd = path_obj if path_obj.is_dir() else path_obj.parent
     services = _initialize_services(context, cwd=index_cwd)
     if not all(services[:3]):
@@ -283,7 +287,7 @@ def index_helper(path: str, context: Optional[str] = None):
             with db_manager.get_driver().session() as session:
                 result = session.run(
                     "MATCH (r:Repository {path: $path})-[:CONTAINS*]->(f:File) RETURN count(DISTINCT f) as file_count",
-                    path=str(path_obj)
+                    path=repo_path_str
                 )
                 record = result.single()
                 file_count = record["file_count"] if record else 0
@@ -415,6 +419,49 @@ def delete_helper(repo_path: str, context: Optional[str] = None):
     finally:
         db_manager.close_driver()
 
+def _print_query_exception(e: Exception, query: str) -> None:
+    """
+    Pretty-print a database query exception, surfacing the raw driver
+    error message so Cypher syntax problems are clearly visible.
+    """
+    import traceback
+
+    error_type = type(e).__name__
+    error_module = type(e).__module__ or ""
+
+    # Neo4j: CypherSyntaxError and other ClientError subclasses carry
+    # a .message and .code attribute with the full server-side detail.
+    if "neo4j" in error_module:
+        code = getattr(e, "code", None)
+        msg = getattr(e, "message", None) or str(e)
+        console.print(f"[bold red]Query Error ({error_type}):[/bold red]")
+        if code:
+            console.print(f"  [yellow]Code:[/yellow] {code}")
+        console.print(f"  [yellow]Message:[/yellow] {msg}")
+
+    # FalkorDB: ResponseError / exceptions in falkordb or redis packages
+    elif "falkordb" in error_module or "redis" in error_module:
+        console.print(f"[bold red]Query Error ({error_type}):[/bold red]")
+        console.print(f"  [yellow]Database message:[/yellow] {e}")
+
+    # KuzuDB: RuntimeError from the kuzu extension
+    # KuzuDB: RuntimeError from the kuzu extension or database_kuzu wrapper
+    elif "kuzu" in error_module or (
+        error_type == "RuntimeError" and "Parser exception" in str(e)
+    ):
+        console.print(f"[bold red]Query Error ({error_type}):[/bold red]")
+        console.print(f"  [yellow]Database message:[/yellow] {e}")
+
+    else:
+        # Fallback: unknown backend — print type + message + traceback
+        console.print(f"[bold red]An error occurred while executing query ({error_type}):[/bold red]")
+        console.print(f"  [yellow]Message:[/yellow] {e}")
+        console.print("[dim]--- Traceback ---[/dim]")
+        console.print(f"[dim]{traceback.format_exc()}[/dim]")
+
+    console.print(f"\n[dim]Failed query:[/dim]")
+    console.print(f"[dim]  {query}[/dim]")
+
 
 def cypher_helper(query: str, context: Optional[str] = None):
     """Executes a read-only Cypher query."""
@@ -440,7 +487,7 @@ def cypher_helper(query: str, context: Optional[str] = None):
             records = [record.data() for record in result]
             console.print(json.dumps(records, indent=2))
     except Exception as e:
-        console.print(f"[bold red]An error occurred while executing query:[/bold red] {e}")
+        _print_query_exception(e, query)
         db_manager.close_driver()
         raise typer.Exit(code=1)
     finally:
@@ -466,7 +513,7 @@ def cypher_helper_visual(query: str, context: Optional[str] = None):
     try:
         visualize_cypher_results(query)
     except Exception as e:
-        console.print(f"[bold red]An error occurred while executing query:[/bold red] {e}")
+        _print_query_exception(e, query)
         db_manager.close_driver()
         raise typer.Exit(code=1)
     finally:
@@ -844,10 +891,11 @@ def watch_helper(path: str, context: Optional[str] = None, use_polling: Optional
         
         # Add the directory to watch
         if is_indexed:
-            console.print("[green]✓[/green] Already indexed (no initial scan needed)")
+            console.print("[green]✓[/green] Already indexed. Synchronizing current files...")
             watcher.watch_directory(
                 str(path_obj),
                 perform_initial_scan=False,
+                sync_on_start=True,
                 cgcignore_path=ctx.cgcignore_path,
             )
         else:

{codegraphcontext-0.4.17 → codegraphcontext-0.4.18}/src/codegraphcontext/cli/config_manager.py

@@ -160,6 +160,14 @@ CONFIG_VALIDATORS = {
     "CGC_EMBEDDING_MODEL": ["local", "openai"],
     "FUZZY_SEARCH": ["true", "false"],
 }
+
+SUPPORTED_DATABASES: List[str] = CONFIG_VALIDATORS["DEFAULT_DATABASE"]
+DATABASE_CLI_HELP = (
+    "Database backend ("
+    + "|".join(SUPPORTED_DATABASES)
+    + "). Defaults to DEFAULT_DATABASE from config."
+)
+
 DEFAULT_CGCIGNORE_PATTERNS = """\
 # Default .cgcignore patterns
 # Lines starting with # are comments; blank lines are ignored.
@@ -279,18 +287,25 @@ def load_config() -> Dict[str, str]:
 def should_apply_project_dotenv() -> bool:
     """True when cwd-local ``.codegraphcontext/.env`` should merge with global config.
 
-    Skips project env when ``HOME`` is isolated (e.g. E2E) but ``cwd`` is an unrelated
-    checkout, unless ``CGC_LOAD_PROJECT_ENV=1``. Set ``CGC_IGNORE_PROJECT_ENV=1`` to force skip.
+    Project env is loaded only in **per-repo** context mode (or when
+    ``CGC_LOAD_PROJECT_ENV=1``). In **global** / **named** mode, ``~/.codegraphcontext/.env``
+    wins so clones with a checked-in ``.codegraphcontext/.env`` do not hijack config.
+
+    Set ``CGC_IGNORE_PROJECT_ENV=1`` to force skip; ``CGC_LOAD_PROJECT_ENV=1`` to force load.
     """
     if os.getenv("CGC_IGNORE_PROJECT_ENV", "").strip().lower() in ("1", "true", "yes"):
         return False
     if os.getenv("CGC_LOAD_PROJECT_ENV", "").strip().lower() in ("1", "true", "yes"):
         return True
+    cfg = load_context_config()
+    if cfg.mode != "per-repo":
+        return False
     try:
         Path.cwd().resolve().relative_to(Path.home().resolve())
         return True
     except ValueError:
-        return False
+        # Per-repo indexing from /tmp with an isolated HOME (common in E2E/CI).
+        return True
 
 
 def find_local_env() -> Optional[Path]:
@@ -869,23 +884,33 @@ def resolve_context(
         local_cgc = cwd / ".codegraphcontext"
         local_cgc.mkdir(parents=True, exist_ok=True)
         (local_cgc / "db").mkdir(exist_ok=True)
-        
+
+        inherited_db = load_config().get("DEFAULT_DATABASE", "falkordb")
+
         # Copy global .env into local context for easy per-repo tweaking
         import shutil
         if CONFIG_FILE.exists():
             shutil.copy2(CONFIG_FILE, local_cgc / ".env")
-            
-        console.print(f"[dim]Auto-initialized per-repo context at {local_cgc}[/dim]")
+
+        local_yaml = local_cgc / "config.yaml"
+        if not local_yaml.exists():
+            with open(local_yaml, "w", encoding="utf-8") as f:
+                yaml.safe_dump({"database": inherited_db}, f)
+
+        console.print(
+            f"[dim]Auto-initialized per-repo context at {local_cgc} "
+            f"(Database: {inherited_db})[/dim]"
+        )
 
     if local_cgc is not None:
         # Read local config.yaml if present
         local_yaml = local_cgc / "config.yaml"
-        local_db = "falkordb"
+        local_db = load_config().get("DEFAULT_DATABASE", "falkordb")
         if local_yaml.exists():
             try:
                 with open(local_yaml, encoding="utf-8") as f:
                     local_raw = yaml.safe_load(f) or {}
-                local_db = local_raw.get("database", "falkordb")
+                local_db = local_raw.get("database", local_db)
             except Exception:
                 pass
         db_path = str(local_cgc / "db" / local_db)

codegraphcontext-0.4.18/src/codegraphcontext/cli/hook_manager.py

@@ -0,0 +1,220 @@
+"""Git hook management for keeping CGC indexes in sync."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+import stat
+import subprocess
+
+
+MANAGED_MARKER = "# CGC_MANAGED_HOOK"
+HOOK_NAMES = ("post-commit", "post-checkout")
+GITATTRIBUTES_ENTRY = "*.cgc merge=cgc-bundle"
+
+
+class HookError(RuntimeError):
+    """Raised when hook installation cannot proceed safely."""
+
+
+@dataclass(frozen=True)
+class GitRepository:
+    root: Path
+    git_dir: Path
+
+
+@dataclass(frozen=True)
+class HookStatus:
+    repo_root: Path
+    git_dir: Path
+    installed_hooks: tuple[str, ...]
+    unmanaged_hooks: tuple[str, ...]
+    has_merge_driver: bool
+    has_gitattributes_entry: bool
+
+    @property
+    def installed(self) -> bool:
+        return (
+            bool(self.installed_hooks)
+            and self.has_merge_driver
+            and self.has_gitattributes_entry
+        )
+
+
+def find_git_repository(start: Path | str | None = None) -> GitRepository:
+    """Find the nearest Git repository root and git directory."""
+    current = Path(start or Path.cwd()).resolve()
+    if current.is_file():
+        current = current.parent
+
+    for candidate in (current, *current.parents):
+        git_path = candidate / ".git"
+        if git_path.is_dir():
+            return GitRepository(root=candidate, git_dir=git_path)
+        if git_path.is_file():
+            target = _read_worktree_gitdir(git_path)
+            return GitRepository(root=candidate, git_dir=target)
+
+    raise HookError("No Git repository found from the current directory.")
+
+
+def install_hooks(start: Path | str | None = None, *, force: bool = False) -> HookStatus:
+    repo = find_git_repository(start)
+    hooks_dir = repo.git_dir / "hooks"
+    hooks_dir.mkdir(parents=True, exist_ok=True)
+
+    script = _hook_script(repo.root)
+    for hook_name in HOOK_NAMES:
+        hook_path = hooks_dir / hook_name
+        if hook_path.exists() and not _is_managed_hook(hook_path) and not force:
+            raise HookError(
+                f"{hook_name} already exists and is not managed by CGC. "
+                "Re-run with --force to replace it."
+            )
+        hook_path.write_text(script, encoding="utf-8")
+        mode = hook_path.stat().st_mode
+        hook_path.chmod(mode | stat.S_IXUSR | stat.S_IXGRP | stat.S_IXOTH)
+
+    _ensure_gitattributes(repo.root)
+    _configure_merge_driver(repo.root)
+    return get_hook_status(repo.root)
+
+
+def uninstall_hooks(start: Path | str | None = None) -> HookStatus:
+    repo = find_git_repository(start)
+    hooks_dir = repo.git_dir / "hooks"
+
+    for hook_name in HOOK_NAMES:
+        hook_path = hooks_dir / hook_name
+        if hook_path.exists() and _is_managed_hook(hook_path):
+            hook_path.unlink()
+
+    _remove_gitattributes_entry(repo.root)
+    _unset_git_config(repo.root, "merge.cgc-bundle.name")
+    _unset_git_config(repo.root, "merge.cgc-bundle.driver")
+    return get_hook_status(repo.root)
+
+
+def get_hook_status(start: Path | str | None = None) -> HookStatus:
+    repo = find_git_repository(start)
+    hooks_dir = repo.git_dir / "hooks"
+    installed_hooks: list[str] = []
+    unmanaged_hooks: list[str] = []
+
+    for hook_name in HOOK_NAMES:
+        hook_path = hooks_dir / hook_name
+        if not hook_path.exists():
+            continue
+        if _is_managed_hook(hook_path):
+            installed_hooks.append(hook_name)
+        else:
+            unmanaged_hooks.append(hook_name)
+
+    return HookStatus(
+        repo_root=repo.root,
+        git_dir=repo.git_dir,
+        installed_hooks=tuple(installed_hooks),
+        unmanaged_hooks=tuple(unmanaged_hooks),
+        has_merge_driver=_has_git_config(repo.root, "merge.cgc-bundle.driver"),
+        has_gitattributes_entry=_has_gitattributes_entry(repo.root),
+    )
+
+
+def _read_worktree_gitdir(git_file: Path) -> Path:
+    content = git_file.read_text(encoding="utf-8").strip()
+    prefix = "gitdir:"
+    if not content.lower().startswith(prefix):
+        raise HookError(f"Unsupported .git file format at {git_file}")
+
+    raw_path = content[len(prefix):].strip()
+    git_dir = Path(raw_path)
+    if not git_dir.is_absolute():
+        git_dir = (git_file.parent / git_dir).resolve()
+    return git_dir
+
+
+def _hook_script(repo_root: Path) -> str:
+    repo_root_value = _sh_quote(str(repo_root))
+    return (
+        "#!/bin/sh\n"
+        f"{MANAGED_MARKER}: CodeGraphContext auto-update hook\n"
+        f"CGC_REPO_ROOT={repo_root_value}\n"
+        "if command -v cgc >/dev/null 2>&1; then\n"
+        '  cgc update "$CGC_REPO_ROOT" --quiet\n'
+        "else\n"
+        '  python -m codegraphcontext update "$CGC_REPO_ROOT" --quiet\n'
+        "fi\n"
+    )
+
+
+def _sh_quote(value: str) -> str:
+    return "'" + value.replace("'", "'\"'\"'") + "'"
+
+
+def _is_managed_hook(path: Path) -> bool:
+    try:
+        return MANAGED_MARKER in path.read_text(encoding="utf-8", errors="ignore")
+    except OSError:
+        return False
+
+
+def _ensure_gitattributes(repo_root: Path) -> None:
+    path = repo_root / ".gitattributes"
+    existing = path.read_text(encoding="utf-8") if path.exists() else ""
+    lines = existing.splitlines()
+    if any(line.strip() == GITATTRIBUTES_ENTRY for line in lines):
+        return
+
+    prefix = existing
+    if prefix and not prefix.endswith("\n"):
+        prefix += "\n"
+    path.write_text(f"{prefix}{GITATTRIBUTES_ENTRY}\n", encoding="utf-8")
+
+
+def _remove_gitattributes_entry(repo_root: Path) -> None:
+    path = repo_root / ".gitattributes"
+    if not path.exists():
+        return
+
+    lines = [
+        line
+        for line in path.read_text(encoding="utf-8").splitlines()
+        if line.strip() != GITATTRIBUTES_ENTRY
+    ]
+    if lines:
+        path.write_text("\n".join(lines) + "\n", encoding="utf-8")
+    else:
+        path.unlink()
+
+
+def _has_gitattributes_entry(repo_root: Path) -> bool:
+    path = repo_root / ".gitattributes"
+    if not path.exists():
+        return False
+    return any(
+        line.strip() == GITATTRIBUTES_ENTRY
+        for line in path.read_text(encoding="utf-8").splitlines()
+    )
+
+
+def _configure_merge_driver(repo_root: Path) -> None:
+    _git_config(repo_root, "merge.cgc-bundle.name", "CodeGraphContext bundle merge driver")
+    _git_config(repo_root, "merge.cgc-bundle.driver", "cgc bundle merge %O %A %B")
+
+
+def _git_config(repo_root: Path, key: str, value: str) -> None:
+    subprocess.run(["git", "-C", str(repo_root), "config", key, value], check=True)
+
+
+def _unset_git_config(repo_root: Path, key: str) -> None:
+    subprocess.run(["git", "-C", str(repo_root), "config", "--unset-all", key], check=False)
+
+
+def _has_git_config(repo_root: Path, key: str) -> bool:
+    result = subprocess.run(
+        ["git", "-C", str(repo_root), "config", "--get", key],
+        check=False,
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+    )
+    return result.returncode == 0