codegraphcontext 0.4.9__tar.gz → 0.4.10__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegraphcontext
-Version: 0.4.9
+Version: 0.4.10
 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
@@ -55,6 +55,7 @@ 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: kuzu; sys_platform == "win32" or (sys_platform != "win32" and python_version >= "3.10")
+Requires-Dist: ladybug; 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
@@ -167,7 +168,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 ---
 
 ## Project Details
-- **Version:** 0.4.9
+- **Version:** 0.4.10
 - **Authors:** Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 - **License:** MIT License (See [LICENSE](LICENSE) for details)
 - **Website:** [CodeGraphContext](http://codegraphcontext.vercel.app/)
@@ -200,7 +201,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 -   **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 20 programming languages.
--   **Flexible Database Backend:** KuzuDB (Default), FalkorDB Lite (Typical Unix default), FalkorDB Remote, Nornic DB, or Neo4j (all platforms via Docker/native).
+-   **Flexible Database Backend:** KuzuDB (Default), LadybugDB, FalkorDB Lite (Typical Unix default), FalkorDB Remote, Nornic DB, or Neo4j (all platforms via Docker/native).
 
 
 ---
@@ -227,13 +228,13 @@ Each language parser extracts functions, classes, methods, parameters, inheritan
 
 CodeGraphContext supports multiple graph database backends to suit your environment:
 
-| Feature | KuzuDB | FalkorDB Lite | Neo4j / Nornic DB |
-| :--- | :--- | :--- | :--- |
-| **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 kuzu` | `pip install falkordblite` | Neo4j Server / Docker / Nornic Cloud |
+| 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 |
+| **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 |
+| **Requirement**| `pip install kuzu` | `pip install ladybug` | `pip install falkordblite` | Neo4j Server / Docker / Nornic Cloud |
 | **Speed** | ⚡ Extremely Fast | ⚡ Fast | 🚀 Scalable |
 | **Persistence**| Yes (to disk) | Yes (to disk) | Yes (to disk) |
 

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

@@ -98,7 +98,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 ---
 
 ## Project Details
-- **Version:** 0.4.9
+- **Version:** 0.4.10
 - **Authors:** Shashank Shekhar Singh <shashankshekharsingh1205@gmail.com>
 - **License:** MIT License (See [LICENSE](LICENSE) for details)
 - **Website:** [CodeGraphContext](http://codegraphcontext.vercel.app/)
@@ -131,7 +131,7 @@ A powerful **MCP server** and **CLI toolkit** that indexes local code into a gra
 -   **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 20 programming languages.
--   **Flexible Database Backend:** KuzuDB (Default), FalkorDB Lite (Typical Unix default), FalkorDB Remote, Nornic DB, or Neo4j (all platforms via Docker/native).
+-   **Flexible Database Backend:** KuzuDB (Default), LadybugDB, FalkorDB Lite (Typical Unix default), FalkorDB Remote, Nornic DB, or Neo4j (all platforms via Docker/native).
 
 
 ---
@@ -158,13 +158,13 @@ Each language parser extracts functions, classes, methods, parameters, inheritan
 
 CodeGraphContext supports multiple graph database backends to suit your environment:
 
-| Feature | KuzuDB | FalkorDB Lite | Neo4j / Nornic DB |
-| :--- | :--- | :--- | :--- |
-| **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 kuzu` | `pip install falkordblite` | Neo4j Server / Docker / Nornic Cloud |
+| 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 |
+| **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 |
+| **Requirement**| `pip install kuzu` | `pip install ladybug` | `pip install falkordblite` | Neo4j Server / Docker / Nornic Cloud |
 | **Speed** | ⚡ Extremely Fast | ⚡ Fast | 🚀 Scalable |
 | **Persistence**| Yes (to disk) | Yes (to disk) | Yes (to disk) |
 

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

@@ -1,6 +1,6 @@
 [project]
 name = "codegraphcontext"
-version = "0.4.9"
+version = "0.4.10"
 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"
@@ -34,6 +34,7 @@ dependencies = [
     "protobuf>=3.20,<3.21",
     "falkordblite>=0.1.0; sys_platform != 'win32' and python_version >= '3.12'",
     "kuzu; sys_platform == 'win32' or (sys_platform != 'win32' and python_version >= '3.10')",
+    "ladybug; sys_platform == 'win32' or (sys_platform != 'win32' and python_version >= '3.10')",
     "fastapi>=0.100.0",
     "uvicorn>=0.22.0"
 ]

codegraphcontext-0.4.10/src/codegraphcontext/api/app.py

@@ -0,0 +1,65 @@
+# src/codegraphcontext/api/app.py
+import os
+from fastapi import FastAPI
+from fastapi.responses import HTMLResponse
+from fastapi.middleware.cors import CORSMiddleware
+from .router import router
+from .mcp_sse import handle_sse, handle_messages
+
+def create_app() -> FastAPI:
+    app = FastAPI(
+        title="CodeGraphContext Gateway",
+        description="HTTP API gateway for CodeGraphContext MCP server. Enables integration with ChatGPT Actions, Claude, and web frontends.",
+        version="0.1.0"
+    )
+
+    # Enable CORS for the website/frontend
+    app.add_middleware(
+        CORSMiddleware,
+        allow_origins=["*"], # In production, restrict this
+        allow_credentials=True,
+        allow_methods=["*"],
+        allow_headers=["*"],
+    )
+
+    app.include_router(router, prefix="/api/v1")
+
+    # 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"])
+
+    @app.get("/", response_class=HTMLResponse)
+    async def root():
+        return """
+        <!DOCTYPE html>
+        <html>
+            <head>
+                <title>CGC Gateway</title>
+                <style>
+                    body { font-family: sans-serif; display: flex; justify-content: center; align-items: center; height: 100vh; background: #0f172a; color: white; margin: 0; }
+                    .card { background: #1e293b; padding: 2rem; border-radius: 1rem; box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1); text-align: center; max-width: 400px; border: 1px solid #334155; }
+                    h1 { color: #38bdf8; margin-top: 0; }
+                    p { color: #94a3b8; line-height: 1.6; }
+                    .btn { display: inline-block; background: #38bdf8; color: #0f172a; padding: 0.75rem 1.5rem; border-radius: 0.5rem; text-decoration: none; font-weight: bold; margin-top: 1rem; transition: background 0.2s; }
+                    .btn:hover { background: #7dd3fc; }
+                    .links { margin-top: 1.5rem; font-size: 0.9rem; }
+                    .links a { color: #38bdf8; text-decoration: none; margin: 0 0.5rem; }
+                </style>
+            </head>
+            <body>
+                <div class="card">
+                    <h1>CGC Gateway</h1>
+                    <p>CodeGraphContext HTTP API is running. This gateway allows ChatGPT and Claude to interact with your code graph.</p>
+                    <a href="/docs" class="btn">View API Docs</a>
+                    <div class="links">
+                        <a href="/openapi.json">OpenAPI Spec</a>
+                        <a href="https://github.com/Shashankss1205/CodeGraphContext" target="_blank">GitHub</a>
+                    </div>
+                </div>
+            </body>
+        </html>
+        """
+
+    return app
+
+app = create_app()

codegraphcontext-0.4.10/src/codegraphcontext/api/mcp_sse.py

@@ -0,0 +1,64 @@
+# src/codegraphcontext/api/mcp_sse.py
+import json
+import asyncio
+from fastapi import Request
+from mcp.server import Server
+from mcp.server.models import InitializationOptions
+from mcp.types import Tool, TextContent, ServerCapabilities, ToolsCapability
+from mcp.server.sse import SseServerTransport
+
+from codegraphcontext.api.router import get_server
+from codegraphcontext.tool_definitions import TOOLS
+
+# Create the MCP Server instance using the SDK
+mcp_server = Server("CodeGraphContext")
+
+@mcp_server.list_tools()
+async def handle_list_tools() -> list[Tool]:
+    """List available tools."""
+    tools = []
+    for name, defn in TOOLS.items():
+        tools.append(Tool(
+            name=name,
+            description=defn["description"],
+            inputSchema=defn["inputSchema"]
+        ))
+    return tools
+
+@mcp_server.call_tool()
+async def handle_call_tool(name: str, arguments: dict | None) -> list[TextContent]:
+    """Handle tool execution."""
+    server = get_server()
+    args = arguments or {}
+    
+    # Execute via the existing handler logic
+    result = await server.handle_tool_call(name, args)
+    
+    if "error" in result:
+        return [TextContent(type="text", text=f"Error: {result['error']}")]
+    
+    # Format result as JSON string for the AI
+    return [TextContent(type="text", text=json.dumps(result, indent=2))]
+
+# Create the SSE transport. 
+# The messages_url is where the client will POST JSON-RPC messages.
+sse = SseServerTransport("/api/v1/mcp/messages")
+
+async def handle_sse(request: Request):
+    """Entry point for the SSE connection."""
+    async with sse.connect_sse(request.scope, request.receive, request._send) as (read_stream, write_stream):
+        await mcp_server.run(
+            read_stream,
+            write_stream,
+            InitializationOptions(
+                server_name="CodeGraphContext",
+                server_version="0.1.0",
+                capabilities=ServerCapabilities(
+                    tools=ToolsCapability(listChanged=False)
+                )
+            )
+        )
+
+async def handle_messages(request: Request):
+    """Endpoint for receiving messages from the client."""
+    await sse.handle_post_message(request.scope, request.receive, request._send)

codegraphcontext-0.4.10/src/codegraphcontext/api/router.py

@@ -0,0 +1,102 @@
+# src/codegraphcontext/api/router.py
+import asyncio
+from fastapi import APIRouter, Depends, HTTPException, BackgroundTasks
+from typing import Dict, Any, List
+from pathlib import Path
+
+from .schemas import (
+    IndexRequest, 
+    QueryRequest, 
+    SearchRequest, 
+    ToolCallRequest, 
+    ApiResponse
+)
+from codegraphcontext.server import MCPServer
+
+router = APIRouter()
+
+# Global server instance (initialized on startup)
+_server_instance: MCPServer = None
+
+def get_server() -> MCPServer:
+    global _server_instance
+    if _server_instance is None:
+        # Note: In a real production app, we'd handle initialization better
+        _server_instance = MCPServer(cwd=Path.cwd())
+    return _server_instance
+
+@router.get("/status", response_model=ApiResponse)
+async def get_status(server: MCPServer = Depends(get_server)):
+    status = server.db_manager.is_connected()
+    return ApiResponse(
+        status="ok",
+        message="Connected" if status else "Disconnected",
+        data={"database": server.resolved_context.database}
+    )
+
+@router.get("/tools", response_model=ApiResponse)
+async def list_tools(server: MCPServer = Depends(get_server)):
+    return ApiResponse(
+        status="ok",
+        data={"tools": list(server.tools.values())}
+    )
+
+@router.post("/tools/call", response_model=ApiResponse)
+async def call_tool(
+    request: ToolCallRequest, 
+    server: MCPServer = Depends(get_server)
+):
+    try:
+        result = await server.handle_tool_call(request.name, request.arguments)
+        if "error" in result:
+            return ApiResponse(status="error", error=result["error"])
+        return ApiResponse(status="ok", data=result)
+    except Exception as e:
+        return ApiResponse(status="error", error=str(e))
+
+@router.post("/index", response_model=ApiResponse)
+async def index_repository(
+    request: IndexRequest,
+    background_tasks: BackgroundTasks,
+    server: MCPServer = Depends(get_server)
+):
+    # Map to add_code_to_graph tool
+    args = {
+        "path": request.path,
+        "repo_name": request.repo_name,
+        "branch": request.branch,
+        "force": request.force
+    }
+    
+    # We call handle_tool_call which is async
+    # But add_code_to_graph starts a background job anyway
+    result = await server.handle_tool_call("add_code_to_graph", args)
+    
+    if "error" in result:
+        raise HTTPException(status_code=400, detail=result["error"])
+        
+    return ApiResponse(
+        status="ok",
+        message="Indexing job started",
+        data=result
+    )
+
+@router.post("/query", response_model=ApiResponse)
+async def execute_query(
+    request: QueryRequest,
+    server: MCPServer = Depends(get_server)
+):
+    result = await server.handle_tool_call("execute_cypher_query", {
+        "query": request.query,
+        "params": request.params
+    })
+    
+    if "error" in result:
+        return ApiResponse(status="error", error=result["error"])
+        
+    return ApiResponse(status="ok", data=result)
+
+@router.get("/repositories", response_model=ApiResponse)
+async def list_repositories(server: MCPServer = Depends(get_server)):
+    result = await server.handle_tool_call("list_indexed_repositories", {})
+    return ApiResponse(status="ok", data=result)

codegraphcontext-0.4.10/src/codegraphcontext/api/schemas.py

@@ -0,0 +1,27 @@
+# src/codegraphcontext/api/schemas.py
+from pydantic import BaseModel, Field
+from typing import Dict, Any, List, Optional
+
+class IndexRequest(BaseModel):
+    path: str = Field(..., description="Local path to the repository or file to index")
+    repo_name: Optional[str] = Field(None, description="Optional name for the repository")
+    branch: str = "main"
+    force: bool = False
+
+class QueryRequest(BaseModel):
+    query: str = Field(..., description="Cypher query to execute")
+    params: Dict[str, Any] = Field(default_factory=dict, description="Parameters for the query")
+
+class SearchRequest(BaseModel):
+    query: str = Field(..., description="Search query")
+    top_k: int = 10
+
+class ToolCallRequest(BaseModel):
+    name: str = Field(..., description="Name of the MCP tool to call")
+    arguments: Dict[str, Any] = Field(default_factory=dict, description="Arguments for the tool")
+
+class ApiResponse(BaseModel):
+    status: str
+    message: Optional[str] = None
+    data: Optional[Any] = None
+    error: Optional[str] = None

codegraphcontext-0.4.10/src/codegraphcontext/cli/__init__.py

@@ -0,0 +1 @@
+# src/codegraphcontext/cli/__init__.py

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

@@ -1,3 +1,4 @@
+# src/codegraphcontext/cli/cli_helpers.py
 import asyncio
 import json
 import uuid
@@ -867,3 +868,39 @@ def list_watching_helper():
     console.print(f"\n[cyan]To see watched directories in MCP mode:[/cyan]")
     console.print(f"  1. Start the MCP server: cgc mcp start")
     console.print(f"  2. Use the 'list_watched_paths' MCP tool from your IDE")
+
+
+def setup_scip_helper() -> None:
+    """Diagnostic and setup helper for SCIP indexers."""
+    from ..tools.scip_indexer import EXTENSION_TO_SCIP
+    import shutil
+    
+    console.print("[bold cyan]🔍 Checking SCIP Indexer Availability...[/bold cyan]\n")
+    
+    table = Table(show_header=True, header_style="bold magenta")
+    table.add_column("Language", style="cyan")
+    table.add_column("Binary", style="yellow")
+    table.add_column("Status", style="green")
+    table.add_column("Install Hint", style="dim")
+    
+    langs = {}
+    for ext, (lang, binary, hint, docker) in EXTENSION_TO_SCIP.items():
+        if lang not in langs:
+            langs[lang] = (binary, hint, docker)
+            
+    for lang, (binary, hint, docker) in sorted(langs.items()):
+        is_installed = shutil.which(binary) is not None
+        status = "[green]✓ Installed[/green]" if is_installed else "[red]✗ Not Found[/red]"
+        table.add_row(lang, binary, status, hint)
+        
+    console.print(table)
+    
+    # Check Docker
+    has_docker = shutil.which("docker") is not None
+    if has_docker:
+        console.print("\n[green]✓ Docker is available (Auto-fallback enabled)[/green]")
+    else:
+        console.print("\n[yellow]⚠ Docker not found. Local binaries are required for SCIP.[/yellow]")
+
+    console.print("\n[dim]To enable SCIP indexing, run:[/dim]")
+    console.print("[bold white]cgc config set SCIP_INDEXER true[/bold white]")

{codegraphcontext-0.4.9 → codegraphcontext-0.4.10}/src/codegraphcontext/cli/config_manager.py

@@ -1,3 +1,4 @@
+# src/codegraphcontext/cli/config_manager.py
 """
 Configuration management for CodeGraphContext.
 Handles reading, writing, and validating configuration settings.
@@ -170,6 +171,21 @@ coverage/
 """
 
 
+def normalize_config_path(value: str, *, absolute: bool = False, base_dir: Optional[Path] = None) -> str:
+    """Normalize config path values.
+
+    - Expands ``~`` and environment variables.
+    - Optionally resolves to an absolute path.
+    """
+    expanded = os.path.expandvars(os.path.expanduser(str(value)))
+    path_obj = Path(expanded)
+    if absolute and not path_obj.is_absolute():
+        path_obj = (base_dir or Path.cwd()) / path_obj
+    if absolute:
+        return str(path_obj.resolve())
+    return str(path_obj)
+
+
 def ensure_config_dir(path: Path = CONFIG_DIR):
     """
     Ensure that the configuration directory exists.
@@ -423,7 +439,7 @@ def validate_config_value(key: str, value: str) -> tuple[bool, Optional[str]]:
     
     if key in ("LOG_FILE_PATH", "DEBUG_LOG_PATH"):
         # Validate path is writable
-        log_path = Path(value)
+        log_path = Path(normalize_config_path(value, absolute=True))
         try:
             log_path.parent.mkdir(parents=True, exist_ok=True)
         except Exception as e:
@@ -431,7 +447,7 @@ def validate_config_value(key: str, value: str) -> tuple[bool, Optional[str]]:
     
     if key in ("FALKORDB_PATH", "FALKORDB_SOCKET_PATH"):
         # Validate path is writable
-        db_path = Path(value)
+        db_path = Path(normalize_config_path(value, absolute=True))
         try:
             db_path.parent.mkdir(parents=True, exist_ok=True)
         except Exception as e:

{codegraphcontext-0.4.9 → codegraphcontext-0.4.10}/src/codegraphcontext/cli/main.py

@@ -41,6 +41,7 @@ from .cli_helpers import (
     watch_helper,
     unwatch_helper,
     list_watching_helper,
+    setup_scip_helper,
 )
 
 # Set the log level for the noisy neo4j, asyncio, and urllib3 loggers to keep the output clean.
@@ -77,7 +78,7 @@ from .visualizer import (
 # Initialize the Typer app and Rich console for formatted output.
 app = typer.Typer(
     name="cgc",
-    help="CodeGraphContext: An MCP server for AI-powered code analysis.\n\n[DEPRECATED] 'cgc start' is deprecated. Use 'cgc mcp start' instead.",
+    help="CodeGraphContext: An MCP server for AI-powered code analysis.",
     add_completion=True,
 )
 console = Console(stderr=True)
@@ -304,6 +305,7 @@ def _load_credentials():
     from codegraphcontext.cli.config_manager import (
         ensure_config_dir,
         codegraphcontext_dotenv_at_cwd,
+        normalize_config_path,
     )
     
     # Ensure config directory exists (lazy initialization)
@@ -337,6 +339,14 @@ def _load_credentials():
             with open(mcp_file_path, "r") as f:
                 mcp_config = json.load(f)
             server_env = mcp_config.get("mcpServers", {}).get("CodeGraphContext", {}).get("env", {})
+            if isinstance(server_env, dict):
+                normalized_env = {}
+                for env_key, env_value in server_env.items():
+                    if env_value is not None and "PATH" in env_key:
+                        normalized_env[env_key] = normalize_config_path(str(env_value), absolute=True)
+                    else:
+                        normalized_env[env_key] = env_value
+                server_env = normalized_env
             _append_source("mcp.json", server_env)
         except Exception as e:
             console.print(f"[yellow]Warning: Could not load mcp.json: {e}[/yellow]")
@@ -383,6 +393,8 @@ def _load_credentials():
         if value is not None:  # Only set non-None values
             if key in runtime_env:
                 continue
+            if "PATH" in key:
+                value = normalize_config_path(str(value), absolute=True)
             os.environ[key] = str(value)
     
     # Report what was loaded
@@ -543,9 +555,9 @@ def config_db(backend: str = typer.Argument(..., help="Database backend: 'neo4j'
         cgc config db kuzudb
     """
     backend = backend.lower()
-    if backend not in ['falkordb', 'falkordb-remote', 'neo4j', 'kuzudb']:
+    if backend not in ['falkordb', 'falkordb-remote', 'neo4j', 'kuzudb', 'ladybugdb']:
         console.print(f"[bold red]Invalid backend: {backend}[/bold red]")
-        console.print("Must be 'falkordb', 'falkordb-remote', 'neo4j', or 'kuzudb'")
+        console.print("Must be 'falkordb', 'falkordb-remote', 'neo4j', 'kuzudb', or 'ladybugdb'")
         raise typer.Exit(code=1)
     
     updated = config_manager.set_config_value("DEFAULT_DATABASE", backend)
@@ -760,6 +772,29 @@ registry_app = typer.Typer(
 app.add_typer(registry_app, name="registry")
 
 
+# Create API command group
+api_app = typer.Typer(help="CGC Gateway (HTTP API) commands")
+app.add_typer(api_app, name="api")
+
+@api_app.command("start")
+def api_start(
+    host: str = typer.Option("0.0.0.0", help="Host to bind the server to"),
+    port: int = typer.Option(8000, help="Port to bind the server to"),
+    reload: bool = typer.Option(False, help="Enable auto-reload (development only)"),
+):
+    """
+    Start the CGC Gateway HTTP API server.
+    
+    This server provides a REST API that can be used by ChatGPT Actions,
+    Claude, or web frontends to interact with the CodeGraphContext graph.
+    """
+    import uvicorn
+    console.print(f"[bold green]Starting CGC Gateway on {host}:{port}...[/bold green]")
+    _load_credentials()
+    uvicorn.run("codegraphcontext.api.app:app", host=host, port=port, reload=reload)
+
+
+
 @registry_app.callback()
 def registry_callback(ctx: typer.Context):
     """Browse and download bundles from the registry."""
@@ -956,6 +991,15 @@ def doctor():
                 console.print(f"   [red]✗[/red] KuzuDB is not installed")
                 console.print(f"       Run: pip install kuzu")
                 all_checks_passed = False
+        elif default_db == "ladybugdb":
+            from importlib.util import find_spec
+
+            if find_spec("ladybug") is not None:
+                console.print(f"   [green]✓[/green] LadybugDB core (ladybug) is installed")
+            else:
+                console.print(f"   [red]✗[/red] LadybugDB core (ladybug) is not installed")
+                console.print(f"       Run: pip install ladybug")
+                all_checks_passed = False
         else:
             # FalkorDB
             try:
@@ -1046,13 +1090,6 @@ def doctor():
 
 
 
-@app.command()
-def start():
-    """
-    [DEPRECATED] Use 'cgc mcp start' instead. This command will be removed in a future version.
-    """
-    console.print("[yellow]⚠️  'cgc start' is deprecated. Use 'cgc mcp start' instead.[/yellow]")
-    mcp_start()
 
 
 @app.command()
@@ -1106,6 +1143,16 @@ def stats(
         path = str(Path(path).resolve())
     stats_helper(path, context)
 
+@app.command("setup-scip")
+def setup_scip():
+    """
+    Check availability of SCIP indexers and provide installation hints.
+    
+    This command audits your system for SCIP binaries (like scip-python, scip-go)
+    and checks if Docker is available for fallback indexing.
+    """
+    setup_scip_helper()
+
 @app.command()
 def delete(
     path: Optional[str] = typer.Argument(None, help="Path of the repository to delete from the code graph."),
@@ -2581,6 +2628,10 @@ def main(
     if version_:
         console.print(f"CodeGraphContext [bold cyan]{get_version()}[/bold cyan]")
         raise typer.Exit()
+    
+    if help_:
+        typer.echo(ctx.get_help())
+        raise typer.Exit()
 
     if ctx.invoked_subcommand is None:
         console.print("[bold green]👋 Welcome to CodeGraphContext (cgc)![/bold green]\n")

{codegraphcontext-0.4.9 → codegraphcontext-0.4.10}/src/codegraphcontext/cli/setup_wizard.py

@@ -1,3 +1,4 @@
+# src/codegraphcontext/cli/setup_wizard.py
 from InquirerPy import prompt
 from rich.console import Console
 import subprocess
@@ -10,6 +11,7 @@ import sys
 import shutil
 import yaml 
 from codegraphcontext.core.database import DatabaseManager
+from codegraphcontext.cli.config_manager import normalize_config_path
 
 console = Console()
 
@@ -513,17 +515,15 @@ def configure_mcp_client():
         except Exception:
             pass
     
-    # Add all configuration values, converting relative paths to absolute
+    # Add all configuration values, normalizing path-related settings
     for key, value in config.items():
         # Skip database credentials (already added above)
         if key in ["NEO4J_URI", "NEO4J_USERNAME", "NEO4J_PASSWORD"]:
             continue
         
-        # Convert relative paths to absolute for path-related configs
+        # Expand ~/$VARS and convert relative paths to absolute for MCP env
         if "PATH" in key and value:
-            path_obj = Path(value)
-            if not path_obj.is_absolute():
-                value = str(path_obj.resolve())
+            value = normalize_config_path(value, absolute=True)
         
         env_vars[key] = value
     

{codegraphcontext-0.4.9 → codegraphcontext-0.4.10}/src/codegraphcontext/cli/visualizer.py

@@ -1,3 +1,4 @@
+# src/codegraphcontext/cli/visualizer.py
 import urllib.parse
 from typing import Optional, List, Dict, Any, Set
 from pathlib import Path