codegraphcontext 0.1.19__tar.gz → 0.1.21__tar.gz

{codegraphcontext-0.1.19/src/codegraphcontext.egg-info → codegraphcontext-0.1.21}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegraphcontext
-Version: 0.1.19
+Version: 0.1.21
 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
@@ -33,7 +33,7 @@ Classifier: Operating System :: OS Independent
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: neo4j>=5.15.0
@@ -82,7 +82,7 @@ Dynamic: license-file
 
 
 
-An MCP server that indexes local code into a graph database to provide context to AI assistants.
+A powerful **MCP server** and **CLI tool** that indexes local code into a graph database to provide context to AI assistants and developers. Use it as a standalone CLI for code analysis or connect it to your favorite AI IDE via MCP.
 
 ### Indexing a codebase
 ![Indexing using an MCP client](https://github.com/Shashankss1205/CodeGraphContext/blob/main/images/Indexing.gif)
@@ -91,7 +91,7 @@ An MCP server that indexes local code into a graph database to provide context t
 ![Using the MCP server](https://github.com/Shashankss1205/CodeGraphContext/blob/main/images/Usecase.gif)
 
 ## Project Details
-- **Version:** 0.1.19
+- **Version:** 0.1.21
 - **Authors:** Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 - **License:** MIT License (See [LICENSE](LICENSE) for details)
 - **Website:** [CodeGraphContext](http://codegraphcontext.vercel.app/)
@@ -105,6 +105,7 @@ An MCP server that indexes local code into a graph database to provide context t
 -   **Relationship Analysis:** Query for callers, callees, class hierarchies, call chains and more.
 -   **Live Updates:** Watches local files for changes and automatically updates the graph.
 -   **Interactive Setup:** A user-friendly command-line wizard for easy setup.
+-   **Dual Mode:** Works as a standalone **CLI tool** for developers and as an **MCP server** for AI agents.
 -   **Multi-Language Support:** Full support for 11 programming languages.
 -   **Flexible Database Backend:** Choose between Neo4j or FalkorDB Lite.
 
@@ -143,8 +144,8 @@ CodeGraphContext supports two graph database backends:
 - Perfect for quick testing and development
 - Automatically installed when using Python 3.12 or higher
 
-The `cgc setup` wizard helps you configure neo4j database backend while the falkordb database is
-supported inherently.
+The `cgc neo4j setup` wizard helps you configure neo4j database backend while the falkordb database is
+supported inherently (enabled by default).
 
 ## Used By
 
@@ -173,13 +174,13 @@ If you’re using CodeGraphContext in your project, feel free to open a PR and a
 - `nbconvert>=7.16.6`
 - `pathspec>=0.12.1`
 
-**Note:** Python 3.9+ is supported, including Python 3.13 and 3.14.
+**Note:** Python 3.10-3.14 is supported.
 
 ## Getting Started
 
 1.  **Install:** `pip install codegraphcontext`
-2.  **Setup:** `cgc setup`
-    This interactive command guides you through configuring your Neo4j database connection and automatically setting up your IDE.
+2.  **Setup:** `cgc mcp setup`
+    This command configures your IDE to work with CodeGraphContext. To configure a Neo4j database, use `cgc neo4j setup`.
 
     <details>
     <summary>⚙️ Troubleshooting: In case, command <code>cgc</code> not found</summary>
@@ -217,7 +218,7 @@ If you’re using CodeGraphContext in your project, feel free to open a PR and a
     
     **Database Configuration:**
     *   **Local Setup (Docker Recommended):** Helps you set up a local Neo4j instance using Docker. Requires Docker and Docker Compose to be installed.
-    *   **Local Setup (Linux Binary):** For Debian-based Linux systems (like Ubuntu), `cgc setup` can automate the installation of Neo4j. Requires `sudo` privileges.
+    *   **Local Setup (Linux Binary):** For Debian-based Linux systems (like Ubuntu), `cgc neo4j setup` can automate the installation of Neo4j. Requires `sudo` privileges.
     *   **Hosted Setup:** Allows you to connect to an existing remote Neo4j database (e.g., Neo4j AuraDB).
 
     **IDE/CLI Configuration:**
@@ -232,12 +233,12 @@ If you’re using CodeGraphContext in your project, feel free to open a PR and a
     *   RooCode
     *   Amazon Q Developer
 
-    Upon successful configuration, `cgc setup` will generate and place the necessary configuration files:
+    Upon successful configuration, `cgc 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 Neo4j 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`).
 
-3.  **Start:** `cgc start`
+3.  **Start:** `cgc mcp start`
 
 ## Ignoring Files (`.cgcignore`)
 
@@ -259,7 +260,7 @@ You can tell CodeGraphContext to ignore specific files and directories by creati
 
 ## MCP Client Configuration
 
-The `cgc 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 `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.
 
 Add the following server configuration to your client's settings file (e.g., VS Code's `settings.json` or `.claude.json`):
 

{codegraphcontext-0.1.19 → codegraphcontext-0.1.21}/README.md

@@ -20,7 +20,7 @@
 
 
 
-An MCP server that indexes local code into a graph database to provide context to AI assistants.
+A powerful **MCP server** and **CLI tool** that indexes local code into a graph database to provide context to AI assistants and developers. Use it as a standalone CLI for code analysis or connect it to your favorite AI IDE via MCP.
 
 ### Indexing a codebase
 ![Indexing using an MCP client](https://github.com/Shashankss1205/CodeGraphContext/blob/main/images/Indexing.gif)
@@ -29,7 +29,7 @@ An MCP server that indexes local code into a graph database to provide context t
 ![Using the MCP server](https://github.com/Shashankss1205/CodeGraphContext/blob/main/images/Usecase.gif)
 
 ## Project Details
-- **Version:** 0.1.19
+- **Version:** 0.1.21
 - **Authors:** Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 - **License:** MIT License (See [LICENSE](LICENSE) for details)
 - **Website:** [CodeGraphContext](http://codegraphcontext.vercel.app/)
@@ -43,6 +43,7 @@ An MCP server that indexes local code into a graph database to provide context t
 -   **Relationship Analysis:** Query for callers, callees, class hierarchies, call chains and more.
 -   **Live Updates:** Watches local files for changes and automatically updates the graph.
 -   **Interactive Setup:** A user-friendly command-line wizard for easy setup.
+-   **Dual Mode:** Works as a standalone **CLI tool** for developers and as an **MCP server** for AI agents.
 -   **Multi-Language Support:** Full support for 11 programming languages.
 -   **Flexible Database Backend:** Choose between Neo4j or FalkorDB Lite.
 
@@ -81,8 +82,8 @@ CodeGraphContext supports two graph database backends:
 - Perfect for quick testing and development
 - Automatically installed when using Python 3.12 or higher
 
-The `cgc setup` wizard helps you configure neo4j database backend while the falkordb database is
-supported inherently.
+The `cgc neo4j setup` wizard helps you configure neo4j database backend while the falkordb database is
+supported inherently (enabled by default).
 
 ## Used By
 
@@ -111,13 +112,13 @@ If you’re using CodeGraphContext in your project, feel free to open a PR and a
 - `nbconvert>=7.16.6`
 - `pathspec>=0.12.1`
 
-**Note:** Python 3.9+ is supported, including Python 3.13 and 3.14.
+**Note:** Python 3.10-3.14 is supported.
 
 ## Getting Started
 
 1.  **Install:** `pip install codegraphcontext`
-2.  **Setup:** `cgc setup`
-    This interactive command guides you through configuring your Neo4j database connection and automatically setting up your IDE.
+2.  **Setup:** `cgc mcp setup`
+    This command configures your IDE to work with CodeGraphContext. To configure a Neo4j database, use `cgc neo4j setup`.
 
     <details>
     <summary>⚙️ Troubleshooting: In case, command <code>cgc</code> not found</summary>
@@ -155,7 +156,7 @@ If you’re using CodeGraphContext in your project, feel free to open a PR and a
     
     **Database Configuration:**
     *   **Local Setup (Docker Recommended):** Helps you set up a local Neo4j instance using Docker. Requires Docker and Docker Compose to be installed.
-    *   **Local Setup (Linux Binary):** For Debian-based Linux systems (like Ubuntu), `cgc setup` can automate the installation of Neo4j. Requires `sudo` privileges.
+    *   **Local Setup (Linux Binary):** For Debian-based Linux systems (like Ubuntu), `cgc neo4j setup` can automate the installation of Neo4j. Requires `sudo` privileges.
     *   **Hosted Setup:** Allows you to connect to an existing remote Neo4j database (e.g., Neo4j AuraDB).
 
     **IDE/CLI Configuration:**
@@ -170,12 +171,12 @@ If you’re using CodeGraphContext in your project, feel free to open a PR and a
     *   RooCode
     *   Amazon Q Developer
 
-    Upon successful configuration, `cgc setup` will generate and place the necessary configuration files:
+    Upon successful configuration, `cgc 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 Neo4j 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`).
 
-3.  **Start:** `cgc start`
+3.  **Start:** `cgc mcp start`
 
 ## Ignoring Files (`.cgcignore`)
 
@@ -197,7 +198,7 @@ You can tell CodeGraphContext to ignore specific files and directories by creati
 
 ## MCP Client Configuration
 
-The `cgc 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 `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.
 
 Add the following server configuration to your client's settings file (e.g., VS Code's `settings.json` or `.claude.json`):
 

{codegraphcontext-0.1.19 → codegraphcontext-0.1.21}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "codegraphcontext"
-version = "0.1.19"
+version = "0.1.21"
 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"
 license = { file = "LICENSE" }
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 classifiers = [
     "Programming Language :: Python :: 3",
     "License :: OSI Approved :: MIT License",

{codegraphcontext-0.1.19 → codegraphcontext-0.1.21}/src/codegraphcontext/cli/cli_helpers.py

@@ -324,3 +324,191 @@ def _visualize_falkordb(db_manager):
         db_manager.close_driver()
 
 
+def reindex_helper(path: str):
+    """Force re-index by deleting and rebuilding the repository."""
+    time_start = time.time()
+    services = _initialize_services()
+    if not all(services):
+        return
+
+    db_manager, graph_builder, code_finder = services
+    path_obj = Path(path).resolve()
+
+    if not path_obj.exists():
+        console.print(f"[red]Error: Path does not exist: {path_obj}[/red]")
+        db_manager.close_driver()
+        return
+
+    # Check if already indexed
+    indexed_repos = code_finder.list_indexed_repositories()
+    repo_exists = any(Path(repo["path"]).resolve() == path_obj for repo in indexed_repos)
+    
+    if repo_exists:
+        console.print(f"[yellow]Deleting existing index for: {path_obj}[/yellow]")
+        try:
+            graph_builder.delete_repository_from_graph(str(path_obj))
+            console.print("[green]✓[/green] Deleted old index")
+        except Exception as e:
+            console.print(f"[red]Error deleting old index: {e}[/red]")
+            db_manager.close_driver()
+            return
+    
+    console.print(f"[cyan]Re-indexing: {path_obj}[/cyan]")
+    console.print("[yellow]This may take a few minutes for large repositories...[/yellow]")
+
+    async def do_index():
+        await graph_builder.build_graph_from_path_async(path_obj, is_dependency=False)
+
+    try:
+        asyncio.run(do_index())
+        time_end = time.time()
+        elapsed = time_end - time_start
+        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}")
+    finally:
+        db_manager.close_driver()
+
+
+def update_helper(path: str):
+    """Update/refresh index for a path (alias for reindex)."""
+    console.print("[cyan]Updating repository index...[/cyan]")
+    reindex_helper(path)
+
+
+def clean_helper():
+    """Remove orphaned nodes and relationships from the database."""
+    services = _initialize_services()
+    if not all(services):
+        return
+
+    db_manager, _, _ = services
+    
+    console.print("[cyan]🧹 Cleaning database (removing orphaned nodes)...[/cyan]")
+    
+    try:
+        with db_manager.get_driver().session() as session:
+            # Find and delete orphaned nodes (nodes not connected to any repository)
+            query = """
+            MATCH (n)
+            WHERE NOT (n:Repository) AND NOT EXISTS((n)-[]-(:Repository))
+            WITH n LIMIT 1000
+            DETACH DELETE n
+            RETURN count(n) as deleted
+            """
+            result = session.run(query)
+            record = result.single()
+            deleted_count = record["deleted"] if record else 0
+            
+            if deleted_count > 0:
+                console.print(f"[green]✓[/green] Deleted {deleted_count} orphaned nodes")
+            else:
+                console.print("[green]✓[/green] No orphaned nodes found")
+            
+            # Clean up any duplicate relationships (if any)
+            console.print("[dim]Checking for duplicate relationships...[/dim]")
+            # Note: This is database-specific and might not work for all backends
+            
+        console.print("[green]✅ Database cleanup complete![/green]")
+    except Exception as e:
+        console.print(f"[bold red]An error occurred during cleanup:[/bold red] {e}")
+    finally:
+        db_manager.close_driver()
+
+
+def stats_helper(path: str = None):
+    """Show indexing statistics for a repository or overall."""
+    services = _initialize_services()
+    if not all(services):
+        return
+
+    db_manager, _, code_finder = services
+    
+    try:
+        if path:
+            # Stats for specific repository
+            path_obj = Path(path).resolve()
+            console.print(f"[cyan]📊 Statistics for: {path_obj}[/cyan]\n")
+            
+            with db_manager.get_driver().session() as session:
+                # Get repository node
+                repo_query = """
+                MATCH (r:Repository {path: $path})
+                RETURN r
+                """
+                result = session.run(repo_query, path=str(path_obj))
+                if not result.single():
+                    console.print(f"[red]Repository not found: {path_obj}[/red]")
+                    return
+                
+                # Get stats
+                stats_query = """
+                MATCH (r:Repository {path: $path})-[:CONTAINS]->(f:File)
+                WITH r, count(f) as file_count, f
+                OPTIONAL MATCH (f)-[:CONTAINS]->(func:Function)
+                OPTIONAL MATCH (f)-[:CONTAINS]->(cls:Class)
+                OPTIONAL MATCH (f)-[:IMPORTS]->(m:Module)
+                RETURN 
+                    file_count,
+                    count(DISTINCT func) as function_count,
+                    count(DISTINCT cls) as class_count,
+                    count(DISTINCT m) as module_count
+                """
+                result = session.run(stats_query, path=str(path_obj))
+                record = result.single()
+                
+                table = Table(show_header=True, header_style="bold magenta")
+                table.add_column("Metric", style="cyan")
+                table.add_column("Count", style="green", justify="right")
+                
+                table.add_row("Files", str(record["file_count"] if record else 0))
+                table.add_row("Functions", str(record["function_count"] if record else 0))
+                table.add_row("Classes", str(record["class_count"] if record else 0))
+                table.add_row("Imported Modules", str(record["module_count"] if record else 0))
+                
+                console.print(table)
+        else:
+            # Overall stats
+            console.print("[cyan]📊 Overall Database Statistics[/cyan]\n")
+            
+            with db_manager.get_driver().session() as session:
+                # Get overall counts
+                stats_query = """
+                MATCH (r:Repository)
+                WITH count(r) as repo_count
+                MATCH (f:File)
+                WITH repo_count, count(f) as file_count
+                MATCH (func:Function)
+                WITH repo_count, file_count, count(func) as function_count
+                MATCH (cls:Class)
+                WITH repo_count, file_count, function_count, count(cls) as class_count
+                MATCH (m:Module)
+                RETURN 
+                    repo_count,
+                    file_count,
+                    function_count,
+                    class_count,
+                    count(m) as module_count
+                """
+                result = session.run(stats_query)
+                record = result.single()
+                
+                if record:
+                    table = Table(show_header=True, header_style="bold magenta")
+                    table.add_column("Metric", style="cyan")
+                    table.add_column("Count", style="green", justify="right")
+                    
+                    table.add_row("Repositories", str(record["repo_count"]))
+                    table.add_row("Files", str(record["file_count"]))
+                    table.add_row("Functions", str(record["function_count"]))
+                    table.add_row("Classes", str(record["class_count"]))
+                    table.add_row("Modules", str(record["module_count"]))
+                    
+                    console.print(table)
+                else:
+                    console.print("[yellow]No data indexed yet.[/yellow]")
+                    
+    except Exception as e:
+        console.print(f"[bold red]An error occurred:[/bold red] {e}")
+    finally:
+        db_manager.close_driver()