codegraphcontext 0.4.5__tar.gz → 0.4.7__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegraphcontext
-Version: 0.4.5
+Version: 0.4.7
 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
@@ -44,7 +44,7 @@ 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>=0.6.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-c-sharp>=0.21.0; python_version != "3.13"
 Requires-Dist: pyyaml
 Requires-Dist: nbformat
@@ -54,12 +54,12 @@ Requires-Dist: falkordb>=0.1.0
 Requires-Dist: requests>=2.28.0
 Requires-Dist: protobuf<3.21,>=3.20
 Requires-Dist: falkordblite>=0.1.0; sys_platform != "win32" and python_version >= "3.12"
-Requires-Dist: real_ladybug; sys_platform == "win32" or (sys_platform != "win32" and python_version >= "3.10")
+Requires-Dist: kuzu; sys_platform == "win32" or (sys_platform != "win32" and python_version >= "3.10")
 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>=0.6.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-c-sharp>=0.21.0; python_version != "3.13" and extra == "parsing"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.4.0; extra == "dev"
@@ -166,7 +166,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 ---
 
 ## Project Details
-- **Version:** 0.4.5
+- **Version:** 0.4.7
 - **Authors:** Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 - **License:** MIT License (See [LICENSE](LICENSE) for details)
 - **Website:** [CodeGraphContext](http://codegraphcontext.vercel.app/)
@@ -195,11 +195,12 @@ 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 (`cgc watch`).
+-   **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 14 programming languages.
--   **Flexible Database Backend:** KùzuDB (default on Windows), FalkorDB Lite (typical embedded default on Unix when installed), FalkorDB Remote, or Neo4j (all platforms via Docker/native).
+-   **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).
+
 
 ---
 
@@ -213,7 +214,7 @@ CodeGraphContext provides comprehensive parsing and analysis for the following l
 | ☕ | **Java** | 🏗️ | **C / C++** | #️⃣ | **C#** |
 | 🐹 | **Go** | 🦀 | **Rust** | 💎 | **Ruby** |
 | 🐘 | **PHP** | 🍎 | **Swift** | 🎨 | **Kotlin** |
-| 🎯 | **Dart** | 🐪 | **Perl** | | |
+| 🎯 | **Dart** | 🐪 | **Perl** | 🌙 | **Lua** |
 
 Each language parser extracts functions, classes, methods, parameters, inheritance relationships, function calls, and imports to build a comprehensive code graph.
 
@@ -223,13 +224,13 @@ Each language parser extracts functions, classes, methods, parameters, inheritan
 
 CodeGraphContext supports multiple graph database backends to suit your environment:
 
-| Feature | KùzuDB | FalkorDB Lite | Neo4j |
+| Feature | LadybugDB | FalkorDB Lite | Neo4j / Nornic DB |
 | :--- | :--- | :--- | :--- |
-| **Typical default** | **Windows** (embedded, when `kuzu` is installed) | **Unix** (Python 3.12+, when `falkordblite` works) | When explicitly configured |
+| **Typical default** | **Standard Default** (embedded, when `real_ladybug` is installed) | **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 |
+| **Requirement**| `pip install real_ladybug` | `pip install falkordblite` | Neo4j Server / Docker / Nornic Cloud |
 | **Speed** | ⚡ Extremely Fast | ⚡ Fast | 🚀 Scalable |
 | **Persistence**| Yes (to disk) | Yes (to disk) | Yes (to disk) |
 
@@ -274,7 +275,7 @@ _If you’re using CodeGraphContext in your project, feel free to open a PR and
 pip install codegraphcontext
 ```
 
-### If 'cgc' command isn't found, run our one-line fix:
+### 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
 ```
@@ -306,9 +307,9 @@ Use CodeGraphContext as an **MCP server** for AI assistants:
 
 1.  **Install:** `pip install codegraphcontext`
     <details>
-    <summary>⚙️ Troubleshooting: In case, command <code>cgc</code> not found</summary>
-
-    If you encounter <i>"cgc: command not found"</i> after installation, run the PATH fix script:
+    <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:**
     ```bash
@@ -340,9 +341,9 @@ Use CodeGraphContext as an **MCP server** for AI assistants:
 
 2.  **Database Setup (Automatic)**
     
-    - **KùzuDB (default on Windows):** Runs natively on Windows, macOS, and Linux. On Windows it is the usual embedded choice; `pip install real_ladybug` if needed.
-    - **FalkorDB Lite (typical default on Unix):** When Python 3.12+ and `falkordblite` are available on Unix/macOS/WSL, the embedded backend prefers FalkorDB Lite; otherwise KùzuDB is used.
-    - **Neo4j (Alternative):** To use Neo4j instead, or if you prefer a server-based approach, run: `cgc neo4j setup`
+    - **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`
 
 ---
 
@@ -351,25 +352,25 @@ Use CodeGraphContext as an **MCP server** for AI assistants:
 **Start using immediately with CLI commands:**
 ```bash
 # Index your current directory
-cgc index .
+codegraphcontext index .
 
 # List all indexed repositories
-cgc list
+codegraphcontext list
 
 # Analyze who calls a function
-cgc analyze callers my_function
+codegraphcontext analyze callers my_function
 
 # Find complex code
-cgc analyze complexity --threshold 10
+codegraphcontext analyze complexity --threshold 10
 
 # Find dead code
-cgc analyze dead-code
+codegraphcontext analyze dead-code
 
 # Watch for live changes (optional)
-cgc watch .
+codegraphcontext watch .
 
 # See all commands
-cgc help
+codegraphcontext help
 ```
 
   **See the full [CLI Commands Guide](docs/CLI_COMPLETE_REFERENCE.md) for all available commands and usage scenarios.**
@@ -385,13 +386,13 @@ CodeGraphContext can generate stunning, interactive knowledge graphs of your cod
 
 ```bash
 # Visualize function calls
-cgc analyze calls my_function --viz
+codegraphcontext analyze calls my_function --viz
 
 # Explore class hierarchies
-cgc analyze tree MyClass --viz
+codegraphcontext analyze tree MyClass --viz
 
 # Visualize search results
-cgc find pattern "Auth" --viz
+codegraphcontext find pattern "Auth" --viz
 ```
 
 
@@ -403,7 +404,7 @@ cgc find pattern "Auth" --viz
 1.  **Setup:** Run the MCP setup wizard to configure your IDE/AI assistant:
     
     ```bash
-    cgc mcp setup
+    codegraphcontext mcp setup
     ```
     
     The wizard can automatically detect and configure:
@@ -418,14 +419,14 @@ cgc find pattern "Auth" --viz
     *   Amazon Q Developer
     *   Kiro
 
-    Upon successful configuration, `cgc mcp setup` will generate and place the necessary configuration files:
+    Upon successful configuration, `codegraphcontext mcp setup` will generate and place the necessary configuration files:
     *   It creates an `mcp.json` file in your current directory for reference.
     *   It stores your database credentials securely in `~/.codegraphcontext/.env`.
     *   It updates the settings file of your chosen IDE/CLI (e.g., `.claude.json` or VS Code's `settings.json`).
 
 2.  **Start:** Launch the MCP server:    
     ```bash
-    cgc mcp start
+    codegraphcontext mcp start
     ```
 
 3.  **Use:** Now interact with your codebase through your AI assistant using natural language! See examples below.
@@ -454,7 +455,7 @@ You can tell CodeGraphContext to ignore specific files and directories by creati
 
 ## MCP Client Configuration
 
-The `cgc mcp setup` command attempts to automatically configure your IDE/CLI. If you choose not to use the automatic setup, or if your tool is not supported, you can configure it manually.
+The `codegraphcontext mcp setup` command attempts to automatically configure your IDE/CLI. If you choose not to use the automatic setup, or if your tool is not supported, you can configure it manually.
 
 Add the following server configuration to your client's settings file (e.g., VS Code's `settings.json` or `.claude.json`):
 
@@ -462,8 +463,34 @@ Add the following server configuration to your client's settings file (e.g., VS
 {
   "mcpServers": {
     "CodeGraphContext": {
-      "command": "cgc",
+      "command": "codegraphcontext",
+      "args": [
+        "mcp",
+        "start"
+      ],
+      "env": {
+        "NEO4J_URI": "YOUR_NEO4J_URI",
+        "NEO4J_USERNAME": "YOUR_NEO4J_USERNAME",
+        "NEO4J_PASSWORD": "YOUR_NEO4J_PASSWORD"
+      },
+      "disabled": false,
+      "alwaysAllow": []
+    }
+  }
+}
+```
+
+#### If installed via pipx
+
+If you installed CodeGraphContext using `pipx`, use the following configuration instead:
+```json
+{
+  "mcpServers": {
+    "CodeGraphContext": {
+      "command": "pipx",
       "args": [
+        "run",
+        "codegraphcontext",
         "mcp",
         "start"
       ],

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

@@ -97,7 +97,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 ---
 
 ## Project Details
-- **Version:** 0.4.5
+- **Version:** 0.4.7
 - **Authors:** Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 - **License:** MIT License (See [LICENSE](LICENSE) for details)
 - **Website:** [CodeGraphContext](http://codegraphcontext.vercel.app/)
@@ -126,11 +126,12 @@ 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 (`cgc watch`).
+-   **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 14 programming languages.
--   **Flexible Database Backend:** KùzuDB (default on Windows), FalkorDB Lite (typical embedded default on Unix when installed), FalkorDB Remote, or Neo4j (all platforms via Docker/native).
+-   **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).
+
 
 ---
 
@@ -144,7 +145,7 @@ CodeGraphContext provides comprehensive parsing and analysis for the following l
 | ☕ | **Java** | 🏗️ | **C / C++** | #️⃣ | **C#** |
 | 🐹 | **Go** | 🦀 | **Rust** | 💎 | **Ruby** |
 | 🐘 | **PHP** | 🍎 | **Swift** | 🎨 | **Kotlin** |
-| 🎯 | **Dart** | 🐪 | **Perl** | | |
+| 🎯 | **Dart** | 🐪 | **Perl** | 🌙 | **Lua** |
 
 Each language parser extracts functions, classes, methods, parameters, inheritance relationships, function calls, and imports to build a comprehensive code graph.
 
@@ -154,13 +155,13 @@ Each language parser extracts functions, classes, methods, parameters, inheritan
 
 CodeGraphContext supports multiple graph database backends to suit your environment:
 
-| Feature | KùzuDB | FalkorDB Lite | Neo4j |
+| Feature | LadybugDB | FalkorDB Lite | Neo4j / Nornic DB |
 | :--- | :--- | :--- | :--- |
-| **Typical default** | **Windows** (embedded, when `kuzu` is installed) | **Unix** (Python 3.12+, when `falkordblite` works) | When explicitly configured |
+| **Typical default** | **Standard Default** (embedded, when `real_ladybug` is installed) | **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 |
+| **Requirement**| `pip install real_ladybug` | `pip install falkordblite` | Neo4j Server / Docker / Nornic Cloud |
 | **Speed** | ⚡ Extremely Fast | ⚡ Fast | 🚀 Scalable |
 | **Persistence**| Yes (to disk) | Yes (to disk) | Yes (to disk) |
 
@@ -205,7 +206,7 @@ _If you’re using CodeGraphContext in your project, feel free to open a PR and
 pip install codegraphcontext
 ```
 
-### If 'cgc' command isn't found, run our one-line fix:
+### 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
 ```
@@ -237,9 +238,9 @@ Use CodeGraphContext as an **MCP server** for AI assistants:
 
 1.  **Install:** `pip install codegraphcontext`
     <details>
-    <summary>⚙️ Troubleshooting: In case, command <code>cgc</code> not found</summary>
-
-    If you encounter <i>"cgc: command not found"</i> after installation, run the PATH fix script:
+    <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:**
     ```bash
@@ -271,9 +272,9 @@ Use CodeGraphContext as an **MCP server** for AI assistants:
 
 2.  **Database Setup (Automatic)**
     
-    - **KùzuDB (default on Windows):** Runs natively on Windows, macOS, and Linux. On Windows it is the usual embedded choice; `pip install real_ladybug` if needed.
-    - **FalkorDB Lite (typical default on Unix):** When Python 3.12+ and `falkordblite` are available on Unix/macOS/WSL, the embedded backend prefers FalkorDB Lite; otherwise KùzuDB is used.
-    - **Neo4j (Alternative):** To use Neo4j instead, or if you prefer a server-based approach, run: `cgc neo4j setup`
+    - **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`
 
 ---
 
@@ -282,25 +283,25 @@ Use CodeGraphContext as an **MCP server** for AI assistants:
 **Start using immediately with CLI commands:**
 ```bash
 # Index your current directory
-cgc index .
+codegraphcontext index .
 
 # List all indexed repositories
-cgc list
+codegraphcontext list
 
 # Analyze who calls a function
-cgc analyze callers my_function
+codegraphcontext analyze callers my_function
 
 # Find complex code
-cgc analyze complexity --threshold 10
+codegraphcontext analyze complexity --threshold 10
 
 # Find dead code
-cgc analyze dead-code
+codegraphcontext analyze dead-code
 
 # Watch for live changes (optional)
-cgc watch .
+codegraphcontext watch .
 
 # See all commands
-cgc help
+codegraphcontext help
 ```
 
   **See the full [CLI Commands Guide](docs/CLI_COMPLETE_REFERENCE.md) for all available commands and usage scenarios.**
@@ -316,13 +317,13 @@ CodeGraphContext can generate stunning, interactive knowledge graphs of your cod
 
 ```bash
 # Visualize function calls
-cgc analyze calls my_function --viz
+codegraphcontext analyze calls my_function --viz
 
 # Explore class hierarchies
-cgc analyze tree MyClass --viz
+codegraphcontext analyze tree MyClass --viz
 
 # Visualize search results
-cgc find pattern "Auth" --viz
+codegraphcontext find pattern "Auth" --viz
 ```
 
 
@@ -334,7 +335,7 @@ cgc find pattern "Auth" --viz
 1.  **Setup:** Run the MCP setup wizard to configure your IDE/AI assistant:
     
     ```bash
-    cgc mcp setup
+    codegraphcontext mcp setup
     ```
     
     The wizard can automatically detect and configure:
@@ -349,14 +350,14 @@ cgc find pattern "Auth" --viz
     *   Amazon Q Developer
     *   Kiro
 
-    Upon successful configuration, `cgc mcp setup` will generate and place the necessary configuration files:
+    Upon successful configuration, `codegraphcontext mcp setup` will generate and place the necessary configuration files:
     *   It creates an `mcp.json` file in your current directory for reference.
     *   It stores your database credentials securely in `~/.codegraphcontext/.env`.
     *   It updates the settings file of your chosen IDE/CLI (e.g., `.claude.json` or VS Code's `settings.json`).
 
 2.  **Start:** Launch the MCP server:    
     ```bash
-    cgc mcp start
+    codegraphcontext mcp start
     ```
 
 3.  **Use:** Now interact with your codebase through your AI assistant using natural language! See examples below.
@@ -385,7 +386,7 @@ You can tell CodeGraphContext to ignore specific files and directories by creati
 
 ## MCP Client Configuration
 
-The `cgc mcp setup` command attempts to automatically configure your IDE/CLI. If you choose not to use the automatic setup, or if your tool is not supported, you can configure it manually.
+The `codegraphcontext mcp setup` command attempts to automatically configure your IDE/CLI. If you choose not to use the automatic setup, or if your tool is not supported, you can configure it manually.
 
 Add the following server configuration to your client's settings file (e.g., VS Code's `settings.json` or `.claude.json`):
 
@@ -393,8 +394,34 @@ Add the following server configuration to your client's settings file (e.g., VS
 {
   "mcpServers": {
     "CodeGraphContext": {
-      "command": "cgc",
+      "command": "codegraphcontext",
+      "args": [
+        "mcp",
+        "start"
+      ],
+      "env": {
+        "NEO4J_URI": "YOUR_NEO4J_URI",
+        "NEO4J_USERNAME": "YOUR_NEO4J_USERNAME",
+        "NEO4J_PASSWORD": "YOUR_NEO4J_PASSWORD"
+      },
+      "disabled": false,
+      "alwaysAllow": []
+    }
+  }
+}
+```
+
+#### If installed via pipx
+
+If you installed CodeGraphContext using `pipx`, use the following configuration instead:
+```json
+{
+  "mcpServers": {
+    "CodeGraphContext": {
+      "command": "pipx",
       "args": [
+        "run",
+        "codegraphcontext",
         "mcp",
         "start"
       ],

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

@@ -1,6 +1,6 @@
 [project]
 name = "codegraphcontext"
-version = "0.4.5"
+version = "0.4.7"
 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"
@@ -23,7 +23,7 @@ dependencies = [
     "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; python_version != '3.13'",
+    "tree-sitter-language-pack>=0.6.0,!=1.6.3; python_version != '3.13'",
     "tree-sitter-c-sharp>=0.21.0; python_version != '3.13'",
     "pyyaml",
     "nbformat",
@@ -33,7 +33,7 @@ dependencies = [
     "requests>=2.28.0",
     "protobuf>=3.20,<3.21",
     "falkordblite>=0.1.0; sys_platform != 'win32' and python_version >= '3.12'",
-    "real_ladybug; sys_platform == 'win32' or (sys_platform != 'win32' and python_version >= '3.10')",
+    "kuzu; sys_platform == 'win32' or (sys_platform != 'win32' and python_version >= '3.10')",
     "fastapi>=0.100.0",
     "uvicorn>=0.22.0"
 ]
@@ -41,7 +41,7 @@ dependencies = [
 [project.optional-dependencies]
 parsing = [
     "tree-sitter>=0.21.0; python_version != '3.13'",
-    "tree-sitter-language-pack>=0.6.0; python_version != '3.13'",
+    "tree-sitter-language-pack>=0.6.0,!=1.6.3; python_version != '3.13'",
     "tree-sitter-c-sharp>=0.21.0; python_version != '3.13'",
 ]
 dev = [

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

@@ -24,6 +24,7 @@ from ..tools.code_finder import CodeFinder
 from ..tools.graph_builder import GraphBuilder
 from ..tools.package_resolver import get_local_package_path
 from ..utils.debug_log import info_logger, warning_logger
+from ..core.database import Neo4jConnectionError
 from ..utils.repo_path import any_repo_matches_path
 from .config_manager import resolve_context, ResolvedContext, register_repo_in_context, ensure_first_run_bootstrap
 
@@ -50,9 +51,14 @@ def _initialize_services(cli_context_flag: Optional[str] = None) -> tuple[Any, A
 
     console.print("[dim]Initializing services and database connection...[/dim]")
     try:
-        # Override the database backend with the context's specific choice
-        if ctx.database:
-            os.environ['CGC_RUNTIME_DB_TYPE'] = ctx.database
+        # Respect runtime/backend overrides. Context DB is only a default when
+        # neither runtime override nor DEFAULT_DATABASE is already set.
+        if (
+            ctx.database
+            and not os.getenv("CGC_RUNTIME_DB_TYPE")
+            and not os.getenv("DEFAULT_DATABASE")
+        ):
+            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)
@@ -85,9 +91,35 @@ def _initialize_services(cli_context_flag: Optional[str] = None) -> tuple[Any, A
                 console.print(f"[bold red]Critical Error:[/bold red] Both FalkorDB and KùzuDB failed: {kuzu_e}")
                 return None, None, None, ctx
         else:
-            console.print(f"[bold red]Database Connection Error:[/bold red] {e}")
-            console.print("Please ensure your database is configured correctly or run 'cgc doctor'.")
-            return None, None, None, ctx
+            selected_db = (
+                os.environ.get("CGC_RUNTIME_DB_TYPE")
+                or os.environ.get("DATABASE_TYPE")
+                or os.environ.get("DEFAULT_DATABASE")
+                or ""
+            ).lower()
+
+            if isinstance(e, Neo4jConnectionError):
+                console.print(f"[bold red]{e}[/bold red]")
+                allow_fallback = os.environ.get("CGC_ALLOW_NEO4J_FALLBACK", "false").lower() in {"1", "true", "yes", "on"}
+
+                if selected_db == "neo4j" and allow_fallback:
+                    console.print("[cyan]Neo4j failed and CGC_ALLOW_NEO4J_FALLBACK=true. Falling back to KuzuDB...[/cyan]")
+                    try:
+                        from ..core.database_kuzu import KuzuDBManager
+                        db_manager = KuzuDBManager()
+                        db_manager.get_driver()
+                        console.print("[green]✓[/green] Successfully switched to KuzuDB fallback")
+                    except Exception as kuzu_e:
+                        console.print(f"[bold red]Critical Error:[/bold red] Neo4j failed and KuzuDB fallback failed: {kuzu_e}")
+                        return None, None, None, ctx
+                else:
+                    if selected_db == "neo4j":
+                        console.print("[yellow]Tip:[/yellow] To continue without Neo4j, rerun with --db kuzudb")
+                    return None, None, None, ctx
+            else:
+                console.print(f"[bold red]Database Connection Error:[/bold red] {e}")
+                console.print("Please ensure your database is configured correctly or run 'cgc doctor'.")
+                return None, None, None, ctx
     
     # The GraphBuilder requires an event loop, even for synchronous-style execution
     try:

{codegraphcontext-0.4.5 → codegraphcontext-0.4.7}/src/codegraphcontext/cli/config_manager.py

@@ -19,7 +19,10 @@ CONFIG_DIR = Path.home() / ".codegraphcontext"
 CONFIG_FILE = CONFIG_DIR / ".env"
 
 # Database credential keys (stored in same .env file but not managed as config)
-DATABASE_CREDENTIAL_KEYS = {"NEO4J_URI", "NEO4J_USERNAME", "NEO4J_PASSWORD", "NEO4J_DATABASE"}
+DATABASE_CREDENTIAL_KEYS = {
+    "NEO4J_URI", "NEO4J_USERNAME", "NEO4J_PASSWORD", "NEO4J_DATABASE",
+    "NORNIC_URI", "NORNIC_USERNAME", "NORNIC_PASSWORD", "NORNIC_DATABASE"
+}
 
 # Default configuration values
 DEFAULT_CONFIG = {
@@ -47,11 +50,21 @@ DEFAULT_CONFIG = {
     "SCIP_INDEXER": "false",
     "SCIP_LANGUAGES": "python,typescript,go,rust,java",
     "SKIP_EXTERNAL_RESOLUTION": "false",
+    # 0 = unlimited; any positive integer caps MCP tool response size.
+    "MAX_TOOL_RESPONSE_TOKENS": "0",
+    # JSON object mapping tool names to integer result-count limits.
+    # Example: {"find_code": 20, "analyze_code_relationships": 10, "find_dead_code": 30}
+    "TOOL_RESULT_LIMITS": "{}",
+    # Post-indexing resolution phases (default off)
+    "ENABLE_INHERIT_RESOLVE": "false",
+    "ENABLE_VECTOR_RESOLVE": "false",
+    "CGC_EMBEDDING_MODEL": "local",
+    "CGC_EMBEDDING_BATCH_SIZE": "256",
 }
 
 # Configuration key descriptions
 CONFIG_DESCRIPTIONS = {
-    "DEFAULT_DATABASE": "Default database backend (neo4j|falkordb|kuzudb)",
+    "DEFAULT_DATABASE": "Default database backend (neo4j|falkordb|kuzudb|nornic)",
     "FALKORDB_PATH": "Path to FalkorDB database file",
     "FALKORDB_SOCKET_PATH": "Path to FalkorDB Unix socket",
     "INDEX_VARIABLES": "Index variable nodes in the graph (lighter graph if false)",
@@ -74,11 +87,44 @@ CONFIG_DESCRIPTIONS = {
     "SCIP_INDEXER": "Use SCIP-based indexing for higher accuracy call/inheritance resolution (requires scip-<lang> tools installed)",
     "SCIP_LANGUAGES": "Comma-separated languages to index via SCIP when SCIP_INDEXER=true (python,typescript,go,rust,java)",
     "SKIP_EXTERNAL_RESOLUTION": "Skip resolution attempts for external library method calls (recommended for enterprise large Java/Spring codebases)",
+    "MAX_TOOL_RESPONSE_TOKENS": "Maximum tokens per MCP tool response (0 = unlimited). Truncates oversized payloads and appends a notice.",
+    "TOOL_RESULT_LIMITS": "JSON object mapping tool names to max result counts, e.g. {\"find_code\": 20, \"analyze_code_relationships\": 10}. Missing keys use built-in defaults.",
+    # Post-indexing resolution phases
+    "ENABLE_INHERIT_RESOLVE": (
+        "[Phase 5] Re-resolve ambiguous same-file CALLS edges using the inheritance graph (INHERITS relationships). "
+        "When enabled, methods called on an interface or abstract class are re-pointed to the correct concrete "
+        "implementation based on the class hierarchy, reducing tier-7 fallback edges. "
+        "WHEN TO ENABLE: any Java/Kotlin/C# codebase that uses inheritance or interface-based DI (e.g. Spring, OSGi). "
+        "PREREQUISITES: run 'cgc index' first so INHERITS edges exist in the graph. No extra tools needed. "
+        "COST: adds ~1-5 min per 50K functions at the end of each 'cgc index' run. Safe to toggle on/off — only adds new edges, never removes existing ones."
+    ),
+    "ENABLE_VECTOR_RESOLVE": (
+        "[Phase 4 + Phase 5 tiebreaker] Generate semantic embeddings for all Function nodes and use vector "
+        "similarity as a tiebreaker when inheritance resolution alone cannot distinguish between multiple candidates. "
+        "Phase 4 writes a 384-dim embedding to every Function node; Phase 5 queries those embeddings during re-resolution. "
+        "WHEN TO ENABLE: large codebases (>10K functions) where inheritance alone leaves many ambiguous calls "
+        "(tier-7 fallbacks still high after ENABLE_INHERIT_RESOLVE). Also useful for cross-language repos. "
+        "PREREQUISITES: (1) fastembed must be installed — run 'pip install fastembed'. "
+        "(2) Neo4j must be the active database (vector index not supported on FalkorDB/KuzuDB). "
+        "(3) ENABLE_INHERIT_RESOLVE should also be true — vector is a tiebreaker for Phase 5, not a replacement. "
+        "COST: Phase 4 takes ~15 min per 50K functions on CPU (first run only; incremental updates are fast). "
+        "Embedding model (~40 MB) is downloaded automatically on first use from HuggingFace."
+    ),
+    "CGC_EMBEDDING_MODEL": (
+        "Embedding backend for ENABLE_VECTOR_RESOLVE. "
+        "'local' uses fastembed (BAAI/bge-small-en-v1.5, 384-dim, runs on CPU, no GPU or API key needed). "
+        "'openai' uses OpenAI text-embedding-3-small (requires OPENAI_API_KEY env var, costs money per token). "
+        "Default: local"
+    ),
+    "CGC_EMBEDDING_BATCH_SIZE": (
+        "Number of function texts to embed per batch when ENABLE_VECTOR_RESOLVE=true. "
+        "Larger values are faster but use more RAM. Default: 256. Reduce to 64 if you hit memory errors."
+    ),
 }
 
 # Valid values for each config key
 CONFIG_VALIDATORS = {
-    "DEFAULT_DATABASE": ["neo4j", "falkordb", "falkordb-remote", "kuzudb"],
+    "DEFAULT_DATABASE": ["neo4j", "falkordb", "falkordb-remote", "kuzudb", "nornic"],
     "INDEX_VARIABLES": ["true", "false"],
     "ALLOW_DB_DELETION": ["true", "false"],
     "DEBUG_LOGS": ["true", "false"],
@@ -91,6 +137,9 @@ CONFIG_VALIDATORS = {
     "INDEX_SOURCE": ["true", "false"],
     "SCIP_INDEXER": ["true", "false"],
     "SKIP_EXTERNAL_RESOLUTION": ["true", "false"],
+    "ENABLE_INHERIT_RESOLVE": ["true", "false"],
+    "ENABLE_VECTOR_RESOLVE": ["true", "false"],
+    "CGC_EMBEDDING_MODEL": ["local", "openai"],
 }
 DEFAULT_CGCIGNORE_PATTERNS = """\
 # Default .cgcignore patterns
@@ -342,6 +391,26 @@ def validate_config_value(key: str, value: str) -> tuple[bool, Optional[str]]:
                 return False, "PARALLEL_WORKERS must be between 1 and 32"
         except ValueError:
             return False, "PARALLEL_WORKERS must be a number"
+
+    if key == "MAX_TOOL_RESPONSE_TOKENS":
+        try:
+            limit = int(value)
+            if limit < 0:
+                return False, "MAX_TOOL_RESPONSE_TOKENS must be 0 (unlimited) or a positive integer"
+        except ValueError:
+            return False, "MAX_TOOL_RESPONSE_TOKENS must be an integer (0 = unlimited)"
+
+    if key == "TOOL_RESULT_LIMITS":
+        import json as _json
+        try:
+            parsed = _json.loads(value)
+            if not isinstance(parsed, dict):
+                return False, "TOOL_RESULT_LIMITS must be a JSON object, e.g. {\"find_code\": 20}"
+            for k, v in parsed.items():
+                if not isinstance(v, int) or v < 1:
+                    return False, f"TOOL_RESULT_LIMITS: value for '{k}' must be a positive integer"
+        except _json.JSONDecodeError:
+            return False, "TOOL_RESULT_LIMITS must be valid JSON, e.g. {\"find_code\": 20, \"find_dead_code\": 30}"
     
     if key == "MAX_DEPTH":
         if value.lower() != "unlimited":