codegraphcontext 0.4.7__tar.gz → 0.4.9__tar.gz

{codegraphcontext-0.4.7/src/codegraphcontext.egg-info → codegraphcontext-0.4.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegraphcontext
-Version: 0.4.7
+Version: 0.4.9
 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
@@ -43,8 +43,8 @@ Requires-Dist: typer>=0.9.0
 Requires-Dist: rich>=13.7.0
 Requires-Dist: inquirerpy>=0.3.4
 Requires-Dist: python-dotenv>=1.0.0
-Requires-Dist: tree-sitter>=0.21.0; python_version != "3.13"
-Requires-Dist: tree-sitter-language-pack!=1.6.3,>=0.6.0; python_version != "3.13"
+Requires-Dist: tree-sitter<0.26.0,>=0.21.0; python_version != "3.13"
+Requires-Dist: tree-sitter-language-pack<1.0.0,>=0.6.0; python_version != "3.13"
 Requires-Dist: tree-sitter-c-sharp>=0.21.0; python_version != "3.13"
 Requires-Dist: pyyaml
 Requires-Dist: nbformat
@@ -58,8 +58,8 @@ Requires-Dist: kuzu; sys_platform == "win32" or (sys_platform != "win32" and pyt
 Requires-Dist: fastapi>=0.100.0
 Requires-Dist: uvicorn>=0.22.0
 Provides-Extra: parsing
-Requires-Dist: tree-sitter>=0.21.0; python_version != "3.13" and extra == "parsing"
-Requires-Dist: tree-sitter-language-pack!=1.6.3,>=0.6.0; python_version != "3.13" and extra == "parsing"
+Requires-Dist: tree-sitter<0.26.0,>=0.21.0; python_version != "3.13" and extra == "parsing"
+Requires-Dist: tree-sitter-language-pack<1.0.0,>=0.6.0; python_version != "3.13" and extra == "parsing"
 Requires-Dist: tree-sitter-c-sharp>=0.21.0; python_version != "3.13" and extra == "parsing"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.4.0; extra == "dev"
@@ -125,7 +125,7 @@ Dynamic: license-file
   <a href="http://codegraphcontext.vercel.app/">
     <img src="https://img.shields.io/badge/website-up-brightgreen?style=flat-square" alt="Website">
   </a>
-  <a href="https://CodeGraphContext.github.io/CodeGraphContext/">
+  <a href="https://codegraphcontext.vercel.app/">
     <img src="https://img.shields.io/badge/docs-GitHub%20Pages-blue?style=flat-square" alt="Docs">
   </a>
   <a href="https://youtu.be/KYYSdxhg1xU">
@@ -144,6 +144,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 * [🛠️ CLI Toolkit](#for-cli-toolkit-mode) 
 * [🤖 MCP Server](#-for-mcp-server-mode) 
 * [🗄️ Database Options](#database-options)
+* [🔬 SCIP indexing (optional)](#scip-indexing-optional)
 
 ---
 
@@ -166,7 +167,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 ---
 
 ## Project Details
-- **Version:** 0.4.7
+- **Version:** 0.4.9
 - **Authors:** Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 - **License:** MIT License (See [LICENSE](LICENSE) for details)
 - **Website:** [CodeGraphContext](http://codegraphcontext.vercel.app/)
@@ -180,7 +181,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 - 📧 Email: [shashankshekharsingh1205@gmail.com](mailto:shashankshekharsingh1205@gmail.com)
 - 🐙 GitHub: [@Shashankss1205](https://github.com/Shashankss1205)
 - 🔗 LinkedIn: [Shashank Shekhar Singh](https://www.linkedin.com/in/shashank-shekhar-singh-a67282228/)
-- 🌐 Website: [codegraphcontext.vercel.app](http://codegraphcontext.vercel.app/)
+- 🌐 Website: [codegraphcontext.vercel.app](https://codegraphcontext.vercel.app/)
 
 *Contributions and feedback are always welcome! Feel free to reach out for questions, suggestions, or collaboration opportunities.*
 
@@ -198,8 +199,8 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 -   **Live File Watching:** Watch directories for changes and automatically update the graph in real-time (`codegraphcontext 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 15 programming languages.
--   **Flexible Database Backend:** LadybugDB (Default), FalkorDB Lite (Typical Unix default), FalkorDB Remote, Nornic DB, or Neo4j (all platforms via Docker/native).
+-   **Multi-Language Support:** Full support for 20 programming languages.
+-   **Flexible Database Backend:** KuzuDB (Default), FalkorDB Lite (Typical Unix default), FalkorDB Remote, Nornic DB, or Neo4j (all platforms via Docker/native).
 
 
 ---
@@ -215,6 +216,8 @@ CodeGraphContext provides comprehensive parsing and analysis for the following l
 | 🐹 | **Go** | 🦀 | **Rust** | 💎 | **Ruby** |
 | 🐘 | **PHP** | 🍎 | **Swift** | 🎨 | **Kotlin** |
 | 🎯 | **Dart** | 🐪 | **Perl** | 🌙 | **Lua** |
+| 🚀 | **Scala** | λ | **Haskell** | 💧 | **Elixir** |
+| ⚛️ | **TSX** | | | | |
 
 Each language parser extracts functions, classes, methods, parameters, inheritance relationships, function calls, and imports to build a comprehensive code graph.
 
@@ -224,18 +227,30 @@ Each language parser extracts functions, classes, methods, parameters, inheritan
 
 CodeGraphContext supports multiple graph database backends to suit your environment:
 
-| Feature | LadybugDB | FalkorDB Lite | Neo4j / Nornic DB |
+| Feature | KuzuDB | FalkorDB Lite | Neo4j / Nornic DB |
 | :--- | :--- | :--- | :--- |
-| **Typical default** | **Standard Default** (embedded, when `real_ladybug` is installed) | **Unix** (Python 3.12+, when `falkordblite` works) | When explicitly configured |
+| **Typical default** | **Standard Default** (embedded, powered by KuzuDB) | **Unix** (Python 3.12+, when `falkordblite` works) | When explicitly configured |
 | **Setup** | Zero-config / Embedded | Zero-config / In-process | Docker / External |
 | **Platform** | **All (Windows Native, macOS, Linux)** | Unix-only (Linux/macOS/WSL) | All Platforms |
 | **Use Case** | Desktop, IDE, Local development | Specialized Unix development | Enterprise, Massive graphs |
-| **Requirement**| `pip install real_ladybug` | `pip install falkordblite` | Neo4j Server / Docker / Nornic Cloud |
+| **Requirement**| `pip install kuzu` | `pip install falkordblite` | Neo4j Server / Docker / Nornic Cloud |
 | **Speed** | ⚡ Extremely Fast | ⚡ Fast | 🚀 Scalable |
 | **Persistence**| Yes (to disk) | Yes (to disk) | Yes (to disk) |
 
 ---
 
+## SCIP indexing (optional)
+
+When `SCIP_INDEXER=true` in your CGC config (`~/.codegraphcontext/.env`), some languages use external **SCIP** indexers for more accurate calls and inheritance than Tree-sitter heuristics alone.
+
+**C and C++** use **scip-clang**, which requires a **`compile_commands.json`** file (a [JSON compilation database](https://clang.llvm.org/docs/JSONCompilationDatabase.html)): one entry per translation unit with the real compiler command (include paths, `-D` defines, `-std`, etc.). Without it, scip-clang cannot run; CGC logs a warning and **falls back to Tree-sitter** for that repo. Typical ways to produce the file: **CMake** with `-DCMAKE_EXPORT_COMPILE_COMMANDS=ON`, or wrap your real build with **[Bear](https://github.com/rizsotto/Bear)** (e.g. `bear -- make`). CGC also looks under `build/` and `cmake-build-*/` for that filename.
+
+**C#** uses **scip-dotnet** (Roslyn); you need a normal **`.csproj` / `.sln`** and a successful restore—no `compile_commands.json`.
+
+SCIP is **independent of which graph database** you use (Kuzu, Neo4j, etc.); the same flag applies to all backends.
+
+---
+
 ## Used By
 
 CodeGraphContext is already being explored by developers and projects for:
@@ -255,95 +270,42 @@ _If you’re using CodeGraphContext in your project, feel free to open a PR and
 - `stdlibs>=2023.11.18`
 - `typer>=0.9.0`
 - `rich>=13.7.0`
-- `inquirerpy>=0.3.7`
+- `inquirerpy>=0.3.4`
 - `python-dotenv>=1.0.0`
 - `tree-sitter>=0.21.0` (not installed on Python 3.13)
 - `tree-sitter-language-pack>=0.6.0` (not installed on Python 3.13)
 - `pyyaml`
-- `pytest`
-- `nbformat`
-- `nbconvert>=7.16.6`
 - `pathspec>=0.12.1`
+- `falkordb>=0.1.0`
+- `falkordblite>=0.1.0` (Unix only)
+- `kuzu` (KuzuDB engine)
+- `fastapi>=0.100.0`
+- `uvicorn>=0.22.0`
+- `requests>=2.28.0`
+- `protobuf>=3.20,<3.21`
 
 **Note:** Python 3.10-3.14 is supported.
 
 ---
 
-## Quick Start
-### Install the core toolkit
-```
-pip install codegraphcontext
-```
-
-### If 'codegraphcontext' command isn't found, run our one-line fix:
-```
-curl -sSL https://raw.githubusercontent.com/CodeGraphContext/CodeGraphContext/main/scripts/post_install_fix.sh | bash
-```
-
----
-
-## Getting Started
+### 🚀 Installation & Quick Start
 
-### 📋 Understanding CodeGraphContext Modes
-CodeGraphContext operates in **two modes**, and you can use either or both:
-
-#### 🛠️ Mode 1: CLI Toolkit (Standalone)
-Use CodeGraphContext as a **powerful command-line toolkit** for code analysis:
-- Index and analyze codebases directly from your terminal
-- Query code relationships, find dead code, analyze complexity
-- Visualize code graphs and dependencies
-- Perfect for developers who want direct control via CLI commands
-
-#### 🤖 Mode 2: MCP Server (AI-Powered)
-Use CodeGraphContext as an **MCP server** for AI assistants:
-- Connect to AI IDEs (VS Code, Cursor, Windsurf, Claude, Kiro, etc.)
-- Let AI agents query your codebase using natural language
-- Automatic code understanding and relationship analysis
-- Perfect for AI-assisted development workflows
-
-**You can use both modes!** Install once, then use CLI commands directly OR connect to your AI assistant.
-
-### Installation (Both Modes)
+1.  **Install the toolkit:**
+    ```bash
+    pip install codegraphcontext
+    ```
 
-1.  **Install:** `pip install codegraphcontext`
-    <details>
-    <summary>⚙️ Troubleshooting: In case, command <code>codegraphcontext</code> not found</summary>
-    <br>
-    If you encounter <i>"codegraphcontext: command not found"</i> after installation, run the PATH fix script:
-    
-    **Linux/Mac:**
+2.  **Troubleshooting (Command not found):**
+    If the `codegraphcontext` command is not found, run this one-line fix:
     ```bash
-    # Download the fix script
-    curl -O https://raw.githubusercontent.com/CodeGraphContext/CodeGraphContext/main/scripts/post_install_fix.sh
-    
-    # Make it executable
-    chmod +x post_install_fix.sh
-    
-    # Run the script
-    ./post_install_fix.sh
-    
-    # Restart your terminal or reload shell config
-    source ~/.bashrc  # or ~/.zshrc for zsh users
+    curl -sSL https://raw.githubusercontent.com/CodeGraphContext/CodeGraphContext/main/scripts/post_install_fix.sh | bash
     ```
-    
-    **Windows (PowerShell):**
-    ```powershell
-    # Download the fix script
-    curl -O https://raw.githubusercontent.com/CodeGraphContext/CodeGraphContext/main/scripts/post_install_fix.sh
-    
-    # Run with bash (requires Git Bash or WSL)
-    bash post_install_fix.sh
-    
-    # Restart PowerShell or reload profile
-    . $PROFILE
-    ``` 
-    </details>
 
-2.  **Database Setup (Automatic)**
-    
-    - **LadybugDB (Default):** Runs natively on Windows, macOS, and Linux. It is the primary embedded choice; `pip install real_ladybug` if needed.
-    - **FalkorDB Lite (High Performance Unix):** When Python 3.12+ and `falkordblite` are available on Unix/macOS/WSL, the embedded backend prefers FalkorDB Lite for speed; otherwise LadybugDB is used.
-    - **Neo4j (Alternative):** To use Neo4j instead, or if you prefer a server-based approach, run: `codegraphcontext neo4j setup`
+3.  **Database Setup (Automatic):**
+    CodeGraphContext uses an embedded graph database by default.
+    - **KuzuDB:** Default for all platforms.
+    - **FalkorDB Lite:** Preferred on Unix/macOS if available.
+    - **Neo4j:** Run `codegraphcontext neo4j setup` to use an external server.
 
 ---
 

{codegraphcontext-0.4.7 → codegraphcontext-0.4.9}/README.md

@@ -56,7 +56,7 @@
   <a href="http://codegraphcontext.vercel.app/">
     <img src="https://img.shields.io/badge/website-up-brightgreen?style=flat-square" alt="Website">
   </a>
-  <a href="https://CodeGraphContext.github.io/CodeGraphContext/">
+  <a href="https://codegraphcontext.vercel.app/">
     <img src="https://img.shields.io/badge/docs-GitHub%20Pages-blue?style=flat-square" alt="Docs">
   </a>
   <a href="https://youtu.be/KYYSdxhg1xU">
@@ -75,6 +75,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 * [🛠️ CLI Toolkit](#for-cli-toolkit-mode) 
 * [🤖 MCP Server](#-for-mcp-server-mode) 
 * [🗄️ Database Options](#database-options)
+* [🔬 SCIP indexing (optional)](#scip-indexing-optional)
 
 ---
 
@@ -97,7 +98,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 ---
 
 ## Project Details
-- **Version:** 0.4.7
+- **Version:** 0.4.9
 - **Authors:** Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 - **License:** MIT License (See [LICENSE](LICENSE) for details)
 - **Website:** [CodeGraphContext](http://codegraphcontext.vercel.app/)
@@ -111,7 +112,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 - 📧 Email: [shashankshekharsingh1205@gmail.com](mailto:shashankshekharsingh1205@gmail.com)
 - 🐙 GitHub: [@Shashankss1205](https://github.com/Shashankss1205)
 - 🔗 LinkedIn: [Shashank Shekhar Singh](https://www.linkedin.com/in/shashank-shekhar-singh-a67282228/)
-- 🌐 Website: [codegraphcontext.vercel.app](http://codegraphcontext.vercel.app/)
+- 🌐 Website: [codegraphcontext.vercel.app](https://codegraphcontext.vercel.app/)
 
 *Contributions and feedback are always welcome! Feel free to reach out for questions, suggestions, or collaboration opportunities.*
 
@@ -129,8 +130,8 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 -   **Live File Watching:** Watch directories for changes and automatically update the graph in real-time (`codegraphcontext 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 15 programming languages.
--   **Flexible Database Backend:** LadybugDB (Default), FalkorDB Lite (Typical Unix default), FalkorDB Remote, Nornic DB, or Neo4j (all platforms via Docker/native).
+-   **Multi-Language Support:** Full support for 20 programming languages.
+-   **Flexible Database Backend:** KuzuDB (Default), FalkorDB Lite (Typical Unix default), FalkorDB Remote, Nornic DB, or Neo4j (all platforms via Docker/native).
 
 
 ---
@@ -146,6 +147,8 @@ CodeGraphContext provides comprehensive parsing and analysis for the following l
 | 🐹 | **Go** | 🦀 | **Rust** | 💎 | **Ruby** |
 | 🐘 | **PHP** | 🍎 | **Swift** | 🎨 | **Kotlin** |
 | 🎯 | **Dart** | 🐪 | **Perl** | 🌙 | **Lua** |
+| 🚀 | **Scala** | λ | **Haskell** | 💧 | **Elixir** |
+| ⚛️ | **TSX** | | | | |
 
 Each language parser extracts functions, classes, methods, parameters, inheritance relationships, function calls, and imports to build a comprehensive code graph.
 
@@ -155,18 +158,30 @@ Each language parser extracts functions, classes, methods, parameters, inheritan
 
 CodeGraphContext supports multiple graph database backends to suit your environment:
 
-| Feature | LadybugDB | FalkorDB Lite | Neo4j / Nornic DB |
+| Feature | KuzuDB | FalkorDB Lite | Neo4j / Nornic DB |
 | :--- | :--- | :--- | :--- |
-| **Typical default** | **Standard Default** (embedded, when `real_ladybug` is installed) | **Unix** (Python 3.12+, when `falkordblite` works) | When explicitly configured |
+| **Typical default** | **Standard Default** (embedded, powered by KuzuDB) | **Unix** (Python 3.12+, when `falkordblite` works) | When explicitly configured |
 | **Setup** | Zero-config / Embedded | Zero-config / In-process | Docker / External |
 | **Platform** | **All (Windows Native, macOS, Linux)** | Unix-only (Linux/macOS/WSL) | All Platforms |
 | **Use Case** | Desktop, IDE, Local development | Specialized Unix development | Enterprise, Massive graphs |
-| **Requirement**| `pip install real_ladybug` | `pip install falkordblite` | Neo4j Server / Docker / Nornic Cloud |
+| **Requirement**| `pip install kuzu` | `pip install falkordblite` | Neo4j Server / Docker / Nornic Cloud |
 | **Speed** | ⚡ Extremely Fast | ⚡ Fast | 🚀 Scalable |
 | **Persistence**| Yes (to disk) | Yes (to disk) | Yes (to disk) |
 
 ---
 
+## SCIP indexing (optional)
+
+When `SCIP_INDEXER=true` in your CGC config (`~/.codegraphcontext/.env`), some languages use external **SCIP** indexers for more accurate calls and inheritance than Tree-sitter heuristics alone.
+
+**C and C++** use **scip-clang**, which requires a **`compile_commands.json`** file (a [JSON compilation database](https://clang.llvm.org/docs/JSONCompilationDatabase.html)): one entry per translation unit with the real compiler command (include paths, `-D` defines, `-std`, etc.). Without it, scip-clang cannot run; CGC logs a warning and **falls back to Tree-sitter** for that repo. Typical ways to produce the file: **CMake** with `-DCMAKE_EXPORT_COMPILE_COMMANDS=ON`, or wrap your real build with **[Bear](https://github.com/rizsotto/Bear)** (e.g. `bear -- make`). CGC also looks under `build/` and `cmake-build-*/` for that filename.
+
+**C#** uses **scip-dotnet** (Roslyn); you need a normal **`.csproj` / `.sln`** and a successful restore—no `compile_commands.json`.
+
+SCIP is **independent of which graph database** you use (Kuzu, Neo4j, etc.); the same flag applies to all backends.
+
+---
+
 ## Used By
 
 CodeGraphContext is already being explored by developers and projects for:
@@ -186,95 +201,42 @@ _If you’re using CodeGraphContext in your project, feel free to open a PR and
 - `stdlibs>=2023.11.18`
 - `typer>=0.9.0`
 - `rich>=13.7.0`
-- `inquirerpy>=0.3.7`
+- `inquirerpy>=0.3.4`
 - `python-dotenv>=1.0.0`
 - `tree-sitter>=0.21.0` (not installed on Python 3.13)
 - `tree-sitter-language-pack>=0.6.0` (not installed on Python 3.13)
 - `pyyaml`
-- `pytest`
-- `nbformat`
-- `nbconvert>=7.16.6`
 - `pathspec>=0.12.1`
+- `falkordb>=0.1.0`
+- `falkordblite>=0.1.0` (Unix only)
+- `kuzu` (KuzuDB engine)
+- `fastapi>=0.100.0`
+- `uvicorn>=0.22.0`
+- `requests>=2.28.0`
+- `protobuf>=3.20,<3.21`
 
 **Note:** Python 3.10-3.14 is supported.
 
 ---
 
-## Quick Start
-### Install the core toolkit
-```
-pip install codegraphcontext
-```
-
-### If 'codegraphcontext' command isn't found, run our one-line fix:
-```
-curl -sSL https://raw.githubusercontent.com/CodeGraphContext/CodeGraphContext/main/scripts/post_install_fix.sh | bash
-```
-
----
-
-## Getting Started
+### 🚀 Installation & Quick Start
 
-### 📋 Understanding CodeGraphContext Modes
-CodeGraphContext operates in **two modes**, and you can use either or both:
-
-#### 🛠️ Mode 1: CLI Toolkit (Standalone)
-Use CodeGraphContext as a **powerful command-line toolkit** for code analysis:
-- Index and analyze codebases directly from your terminal
-- Query code relationships, find dead code, analyze complexity
-- Visualize code graphs and dependencies
-- Perfect for developers who want direct control via CLI commands
-
-#### 🤖 Mode 2: MCP Server (AI-Powered)
-Use CodeGraphContext as an **MCP server** for AI assistants:
-- Connect to AI IDEs (VS Code, Cursor, Windsurf, Claude, Kiro, etc.)
-- Let AI agents query your codebase using natural language
-- Automatic code understanding and relationship analysis
-- Perfect for AI-assisted development workflows
-
-**You can use both modes!** Install once, then use CLI commands directly OR connect to your AI assistant.
-
-### Installation (Both Modes)
+1.  **Install the toolkit:**
+    ```bash
+    pip install codegraphcontext
+    ```
 
-1.  **Install:** `pip install codegraphcontext`
-    <details>
-    <summary>⚙️ Troubleshooting: In case, command <code>codegraphcontext</code> not found</summary>
-    <br>
-    If you encounter <i>"codegraphcontext: command not found"</i> after installation, run the PATH fix script:
-    
-    **Linux/Mac:**
+2.  **Troubleshooting (Command not found):**
+    If the `codegraphcontext` command is not found, run this one-line fix:
     ```bash
-    # Download the fix script
-    curl -O https://raw.githubusercontent.com/CodeGraphContext/CodeGraphContext/main/scripts/post_install_fix.sh
-    
-    # Make it executable
-    chmod +x post_install_fix.sh
-    
-    # Run the script
-    ./post_install_fix.sh
-    
-    # Restart your terminal or reload shell config
-    source ~/.bashrc  # or ~/.zshrc for zsh users
+    curl -sSL https://raw.githubusercontent.com/CodeGraphContext/CodeGraphContext/main/scripts/post_install_fix.sh | bash
     ```
-    
-    **Windows (PowerShell):**
-    ```powershell
-    # Download the fix script
-    curl -O https://raw.githubusercontent.com/CodeGraphContext/CodeGraphContext/main/scripts/post_install_fix.sh
-    
-    # Run with bash (requires Git Bash or WSL)
-    bash post_install_fix.sh
-    
-    # Restart PowerShell or reload profile
-    . $PROFILE
-    ``` 
-    </details>
 
-2.  **Database Setup (Automatic)**
-    
-    - **LadybugDB (Default):** Runs natively on Windows, macOS, and Linux. It is the primary embedded choice; `pip install real_ladybug` if needed.
-    - **FalkorDB Lite (High Performance Unix):** When Python 3.12+ and `falkordblite` are available on Unix/macOS/WSL, the embedded backend prefers FalkorDB Lite for speed; otherwise LadybugDB is used.
-    - **Neo4j (Alternative):** To use Neo4j instead, or if you prefer a server-based approach, run: `codegraphcontext neo4j setup`
+3.  **Database Setup (Automatic):**
+    CodeGraphContext uses an embedded graph database by default.
+    - **KuzuDB:** Default for all platforms.
+    - **FalkorDB Lite:** Preferred on Unix/macOS if available.
+    - **Neo4j:** Run `codegraphcontext neo4j setup` to use an external server.
 
 ---
 

{codegraphcontext-0.4.7 → codegraphcontext-0.4.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codegraphcontext"
-version = "0.4.7"
+version = "0.4.9"
 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"
@@ -22,8 +22,8 @@ dependencies = [
     "rich>=13.7.0",
     "inquirerpy>=0.3.4",
     "python-dotenv>=1.0.0",
-    "tree-sitter>=0.21.0; python_version != '3.13'",
-    "tree-sitter-language-pack>=0.6.0,!=1.6.3; python_version != '3.13'",
+    "tree-sitter>=0.21.0,<0.26.0; python_version != '3.13'",
+    "tree-sitter-language-pack>=0.6.0,<1.0.0; python_version != '3.13'",
     "tree-sitter-c-sharp>=0.21.0; python_version != '3.13'",
     "pyyaml",
     "nbformat",
@@ -40,8 +40,8 @@ dependencies = [
 
 [project.optional-dependencies]
 parsing = [
-    "tree-sitter>=0.21.0; python_version != '3.13'",
-    "tree-sitter-language-pack>=0.6.0,!=1.6.3; python_version != '3.13'",
+    "tree-sitter>=0.21.0,<0.26.0; python_version != '3.13'",
+    "tree-sitter-language-pack>=0.6.0,<1.0.0; python_version != '3.13'",
     "tree-sitter-c-sharp>=0.21.0; python_version != '3.13'",
 ]
 dev = [

{codegraphcontext-0.4.7 → codegraphcontext-0.4.9}/src/codegraphcontext/cli/cli_helpers.py

@@ -2,10 +2,12 @@ import asyncio
 import json
 import uuid
 import urllib.parse
+from collections import Counter
 from pathlib import Path
 import time
 import os
 from typing import Optional, List, Dict, Any
+import typer
 from rich.console import Console
 from rich.table import Table
 from rich.progress import (
@@ -31,6 +33,31 @@ from .config_manager import resolve_context, ResolvedContext, register_repo_in_c
 console = Console()
 
 
+def _print_call_resolution_diagnostics(graph_builder: GraphBuilder, limit: int = 5) -> None:
+    diagnostics = getattr(graph_builder, "last_call_resolution_diagnostics", [])
+    if not diagnostics:
+        return
+
+    reason_counts = Counter(d.get("reason", "unknown") for d in diagnostics)
+    summary = ", ".join(
+        f"{reason}={count}" for reason, count in reason_counts.most_common()
+    )
+    console.print(
+        f"[yellow]Skipped {len(diagnostics)} unresolved call relationship(s): {summary}[/yellow]"
+    )
+    table = Table(show_header=True, header_style="bold magenta")
+    table.add_column("Call", style="cyan", overflow="fold")
+    table.add_column("Reason", style="yellow")
+    table.add_column("Location", style="dim", overflow="fold")
+    for diagnostic in diagnostics[:limit]:
+        table.add_row(
+            str(diagnostic.get("full_call_name") or ""),
+            str(diagnostic.get("reason") or ""),
+            f"{diagnostic.get('caller_file_path')}:{diagnostic.get('line_number')}",
+        )
+    console.print(table)
+
+
 def _initialize_services(cli_context_flag: Optional[str] = None) -> tuple[Any, Any, Any, ResolvedContext]:
     """
     Initializes and returns core service managers based on the resolved context.
@@ -60,8 +87,9 @@ def _initialize_services(cli_context_flag: Optional[str] = None) -> tuple[Any, A
         ):
             os.environ["DEFAULT_DATABASE"] = ctx.database
         
-        # Pass the exact DB path resolved from the context
-        db_manager = get_database_manager(db_path=ctx.db_path)
+        # Pass the exact DB path resolved from the context, or the runtime override
+        runtime_path = os.getenv("CGC_RUNTIME_DB_PATH")
+        db_manager = get_database_manager(db_path=runtime_path or ctx.db_path)
     except ValueError as e:
         console.print(f"[bold red]Database Configuration Error:[/bold red] {e}")
         return None, None, None, ctx
@@ -243,6 +271,7 @@ def index_helper(path: str, context: Optional[str] = None):
         asyncio.run(_run_index_with_progress(graph_builder, path_obj, is_dependency=False, cgcignore_path=ctx.cgcignore_path))
         time_end = time.time()
         elapsed = time_end - time_start
+        _print_call_resolution_diagnostics(graph_builder)
         console.print(f"[green]Successfully finished indexing: {path} in {elapsed:.2f} seconds[/green]")
         
         # Check if auto-watch is enabled
@@ -259,6 +288,7 @@ def index_helper(path: str, context: Optional[str] = None):
             
     except Exception as e:
         console.print(f"[bold red]An error occurred during indexing:[/bold red] {e}")
+        raise typer.Exit(code=1)
     finally:
         db_manager.close_driver()
 
@@ -289,6 +319,7 @@ def add_package_helper(package_name: str, language: str, context: Optional[str]
 
     try:
         asyncio.run(_run_index_with_progress(graph_builder, package_path, is_dependency=True, cgcignore_path=ctx.cgcignore_path))
+        _print_call_resolution_diagnostics(graph_builder)
         console.print(f"[green]Successfully finished indexing package: {package_name}[/green]")
     except Exception as e:
         console.print(f"[bold red]An error occurred during package indexing:[/bold red] {e}")
@@ -354,9 +385,11 @@ def cypher_helper(query: str, context: Optional[str] = None):
 
     db_manager, _, _, ctx = services
     
-    # Replicating safety checks from MCPServer
+    # Replicating safety checks from MCPServer (using word boundaries to avoid false positives like 'createEmail')
+    import re
     forbidden_keywords = ['CREATE', 'MERGE', 'DELETE', 'SET', 'REMOVE', 'DROP', 'CALL apoc']
-    if any(keyword in query.upper() for keyword in forbidden_keywords):
+    pattern = r'\b(' + '|'.join(forbidden_keywords) + r')\b'
+    if re.search(pattern, query, re.IGNORECASE):
         console.print("[bold red]Error: This command only supports read-only queries.[/bold red]")
         db_manager.close_driver()
         return
@@ -382,9 +415,11 @@ def cypher_helper_visual(query: str, context: Optional[str] = None):
 
     db_manager, _, _, ctx = services
     
-    # Replicating safety checks from MCPServer
+    # Replicating safety checks from MCPServer (using word boundaries to avoid false positives like 'createEmail')
+    import re
     forbidden_keywords = ['CREATE', 'MERGE', 'DELETE', 'SET', 'REMOVE', 'DROP', 'CALL apoc']
-    if any(keyword in query.upper() for keyword in forbidden_keywords):
+    pattern = r'\b(' + '|'.join(forbidden_keywords) + r')\b'
+    if re.search(pattern, query, re.IGNORECASE):
         console.print("[bold red]Error: This command only supports read-only queries.[/bold red]")
         db_manager.close_driver()
         return
@@ -540,9 +575,11 @@ def reindex_helper(path: str, context: Optional[str] = None):
         asyncio.run(_run_index_with_progress(graph_builder, path_obj, is_dependency=False, cgcignore_path=ctx.cgcignore_path))
         time_end = time.time()
         elapsed = time_end - time_start
+        _print_call_resolution_diagnostics(graph_builder)
         console.print(f"[green]Successfully re-indexed: {path} in {elapsed:.2f} seconds[/green]")
     except Exception as e:
         console.print(f"[bold red]An error occurred during re-indexing:[/bold red] {e}")
+        raise typer.Exit(code=1)
     finally:
         db_manager.close_driver()
 
@@ -669,6 +706,12 @@ def stats_helper(path: str = None, context: Optional[str] = None):
                     class_count = session.run("MATCH (c:Class) RETURN count(c) as c").single()["c"]
                     module_count = session.run("MATCH (m:Module) RETURN count(m) as c").single()["c"]
                     
+                    # Extended node types (PHP, Rust, Go, etc.)
+                    interface_count = session.run("MATCH (i:Interface) RETURN count(i) as c").single()["c"]
+                    trait_count = session.run("MATCH (t:Trait) RETURN count(t) as c").single()["c"]
+                    struct_count = session.run("MATCH (s:Struct) RETURN count(s) as c").single()["c"]
+                    enum_count = session.run("MATCH (e:Enum) RETURN count(e) as c").single()["c"]
+                    
                     table = Table(show_header=True, header_style="bold magenta")
                     table.add_column("Metric", style="cyan")
                     table.add_column("Count", style="green", justify="right")
@@ -677,6 +720,14 @@ def stats_helper(path: str = None, context: Optional[str] = None):
                     table.add_row("Files", str(file_count))
                     table.add_row("Functions", str(func_count))
                     table.add_row("Classes", str(class_count))
+                    if interface_count > 0:
+                        table.add_row("Interfaces", str(interface_count))
+                    if trait_count > 0:
+                        table.add_row("Traits", str(trait_count))
+                    if struct_count > 0:
+                        table.add_row("Structs", str(struct_count))
+                    if enum_count > 0:
+                        table.add_row("Enums", str(enum_count))
                     table.add_row("Modules", str(module_count))
                     
                     console.print(table)