codegraphcontext 0.5.3__tar.gz → 0.5.4__tar.gz

{codegraphcontext-0.5.3/src/codegraphcontext.egg-info → codegraphcontext-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegraphcontext
-Version: 0.5.3
+Version: 0.5.4
 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
@@ -62,7 +62,7 @@ Requires-Dist: requests>=2.28.0
 Requires-Dist: protobuf<3.21,>=3.20
 Requires-Dist: kuzu; python_version < "3.14" or sys_platform == "linux"
 Requires-Dist: ladybug; sys_platform == "win32" or (sys_platform != "win32" and python_version >= "3.10")
-Requires-Dist: mcp>=1.0.0
+Requires-Dist: mcp<2,>=1.0.0
 Requires-Dist: fastapi>=0.100.0
 Requires-Dist: uvicorn>=0.22.0
 Provides-Extra: parsing
@@ -107,6 +107,7 @@ Dynamic: license-file
 - 🇺🇦 [Українська](docs/translations/README.uk.md)
 - 🇷🇺 [Русский](docs/translations/README.ru-RU.md)
 - 🇯🇵 [日本語](docs/translations/README.ja.md)
+- 🇮🇳 [தமிழ்](docs/translations/README.ta.md)
 - 🇪🇸 Español (Soon)
 
 🌍 **Help translate CodeGraphContext to your language by raising an issue & PR on [GitHub Issues](https://github.com/CodeGraphContext/CodeGraphContext/issues)!**
@@ -316,6 +317,29 @@ flowchart TD
 
 ---
 
+## 🏗️ Architecture & Workflow
+
+CodeGraphContext parses your source code and builds a comprehensive knowledge graph. This graph can be queried directly via the CLI toolkit or exposed to AI assistants through the MCP server.
+
+```mermaid
+flowchart TD
+    A[Code Repository] -->|Parsed by| B[Tree-sitter / SCIP Indexing]
+    B -->|Generates| C[Knowledge Graph]
+    C -->|Stored in| D[(Graph Database)]
+    D -->|Queried via| E[CLI Toolkit]
+    D -->|Served by| F[MCP Server]
+    F -->|Provides context to| G[🤖 AI Assistant]
+
+    classDef default fill:#1f2937,stroke:#8b5cf6,stroke-width:2px,color:#fff;
+    classDef db fill:#0f172a,stroke:#3b82f6,stroke-width:2px,color:#fff;
+    classDef ai fill:#312e81,stroke:#a855f7,stroke-width:2px,color:#fff;
+    
+    D:::db
+    G:::ai
+```
+
+---
+
 ## Supported Programming Languages
 
 CodeGraphContext provides comprehensive parsing and analysis for the following languages:
@@ -329,10 +353,12 @@ CodeGraphContext provides comprehensive parsing and analysis for the following l
 | 🎨 | **Kotlin** | 🎯 | **Dart** | 🐪 | **Perl** |
 | 🌙 | **Lua** | 🚀 | **Scala** | λ | **Haskell** |
 | 💧 | **Elixir** | 📜 | **Emacs Lisp (elisp)** | 🌐 | **HTML** |
-| 🎨 | **CSS** | ⚛️ | **TSX** | | |
+| 🎨 | **CSS** | ⚛️ | **TSX** | ⛓️ | **Solidity** |
 
 Each language parser extracts functions, classes, methods, parameters, inheritance relationships, function calls, and imports to build a comprehensive code graph.
 
+**Solidity notes:** `.sol` uses Tree-sitter via `tree-sitter-language-pack` (no SCIP). Supports Foundry remappings, modifier invocations, `using Lib for T`, and `emit` / custom-error `revert` as CALLS. See `docs/docs/contributing_languages.md` § Solidity.
+
 ---
 
 ## Database Options

{codegraphcontext-0.5.3 → codegraphcontext-0.5.4}/README.md

@@ -9,6 +9,7 @@
 - 🇺🇦 [Українська](docs/translations/README.uk.md)
 - 🇷🇺 [Русский](docs/translations/README.ru-RU.md)
 - 🇯🇵 [日本語](docs/translations/README.ja.md)
+- 🇮🇳 [தமிழ்](docs/translations/README.ta.md)
 - 🇪🇸 Español (Soon)
 
 🌍 **Help translate CodeGraphContext to your language by raising an issue & PR on [GitHub Issues](https://github.com/CodeGraphContext/CodeGraphContext/issues)!**
@@ -218,6 +219,29 @@ flowchart TD
 
 ---
 
+## 🏗️ Architecture & Workflow
+
+CodeGraphContext parses your source code and builds a comprehensive knowledge graph. This graph can be queried directly via the CLI toolkit or exposed to AI assistants through the MCP server.
+
+```mermaid
+flowchart TD
+    A[Code Repository] -->|Parsed by| B[Tree-sitter / SCIP Indexing]
+    B -->|Generates| C[Knowledge Graph]
+    C -->|Stored in| D[(Graph Database)]
+    D -->|Queried via| E[CLI Toolkit]
+    D -->|Served by| F[MCP Server]
+    F -->|Provides context to| G[🤖 AI Assistant]
+
+    classDef default fill:#1f2937,stroke:#8b5cf6,stroke-width:2px,color:#fff;
+    classDef db fill:#0f172a,stroke:#3b82f6,stroke-width:2px,color:#fff;
+    classDef ai fill:#312e81,stroke:#a855f7,stroke-width:2px,color:#fff;
+    
+    D:::db
+    G:::ai
+```
+
+---
+
 ## Supported Programming Languages
 
 CodeGraphContext provides comprehensive parsing and analysis for the following languages:
@@ -231,10 +255,12 @@ CodeGraphContext provides comprehensive parsing and analysis for the following l
 | 🎨 | **Kotlin** | 🎯 | **Dart** | 🐪 | **Perl** |
 | 🌙 | **Lua** | 🚀 | **Scala** | λ | **Haskell** |
 | 💧 | **Elixir** | 📜 | **Emacs Lisp (elisp)** | 🌐 | **HTML** |
-| 🎨 | **CSS** | ⚛️ | **TSX** | | |
+| 🎨 | **CSS** | ⚛️ | **TSX** | ⛓️ | **Solidity** |
 
 Each language parser extracts functions, classes, methods, parameters, inheritance relationships, function calls, and imports to build a comprehensive code graph.
 
+**Solidity notes:** `.sol` uses Tree-sitter via `tree-sitter-language-pack` (no SCIP). Supports Foundry remappings, modifier invocations, `using Lib for T`, and `emit` / custom-error `revert` as CALLS. See `docs/docs/contributing_languages.md` § Solidity.
+
 ---
 
 ## Database Options

{codegraphcontext-0.5.3 → codegraphcontext-0.5.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codegraphcontext"
-version = "0.5.3"
+version = "0.5.4"
 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"
@@ -73,7 +73,13 @@ dependencies = [
     # ------------------------------------------------------------------
     "kuzu; python_version < '3.14' or sys_platform == 'linux'",
     "ladybug; sys_platform == 'win32' or (sys_platform != 'win32' and python_version >= '3.10')",
-    "mcp>=1.0.0",
+    # Cap below 2.0: the low-level `mcp.server.Server` dropped its `list_tools`
+    # and `call_tool` decorators in 2.0.0, which api/mcp_sse.py registers its
+    # handlers with. With an unbounded pin, CI resolved 2.0.0 on release day and
+    # every job failed at import with
+    # "AttributeError: 'Server' object has no attribute 'list_tools'".
+    # Lift this once mcp_sse.py is ported to the 2.x server API.
+    "mcp>=1.0.0,<2",
     "fastapi>=0.100.0",
     "uvicorn>=0.22.0"
 ]

{codegraphcontext-0.5.3 → codegraphcontext-0.5.4}/src/codegraphcontext/api/app.py

@@ -1,10 +1,10 @@
 # src/codegraphcontext/api/app.py
 import os
-from fastapi import FastAPI
+from fastapi import Depends, FastAPI
 from fastapi.responses import HTMLResponse
 from fastapi.middleware.cors import CORSMiddleware
 from .router import router
-from .auth import log_auth_status
+from .auth import log_auth_status, require_api_key
 from .mcp_sse import handle_sse, handle_messages
 
 def create_app() -> FastAPI:
@@ -37,9 +37,23 @@ def create_app() -> FastAPI:
         """Liveness probe for load balancers and k8s."""
         return {"status": "ok"}
 
-    # MCP-over-SSE Endpoints
-    app.add_api_route("/api/v1/mcp/sse", handle_sse, methods=["GET"])
-    app.add_api_route("/api/v1/mcp/messages", handle_messages, methods=["POST"])
+    # MCP-over-SSE Endpoints. These dispatch to the same tools as the REST
+    # router (execute_cypher_query, add_code_to_graph, delete_repository), so
+    # they need the same API-key dependency the router applies — without it,
+    # setting CGC_API_KEY left the SSE transport as an unauthenticated path to
+    # every tool.
+    app.add_api_route(
+        "/api/v1/mcp/sse",
+        handle_sse,
+        methods=["GET"],
+        dependencies=[Depends(require_api_key)],
+    )
+    app.add_api_route(
+        "/api/v1/mcp/messages",
+        handle_messages,
+        methods=["POST"],
+        dependencies=[Depends(require_api_key)],
+    )
 
     @app.get("/", response_class=HTMLResponse)
     async def root():

{codegraphcontext-0.5.3 → codegraphcontext-0.5.4}/src/codegraphcontext/api/mcp_sse.py

@@ -48,11 +48,41 @@ async def handle_call_tool(name: str, arguments: dict | None) -> list[TextConten
 # Create the SSE transport.
 sse = SseServerTransport("/api/v1/mcp/messages")
 
+
+class _AlreadySentResponse(Response):
+    """Placeholder for a response the MCP transport wrote itself.
+
+    Both handlers below hand the raw ASGI ``send`` to the SDK, which emits the
+    complete response. FastAPI still does ``await endpoint(request)`` followed
+    by ``await response(...)``, so returning ``None`` raises ``TypeError:
+    'NoneType' object is not callable`` and returning a real ``Response`` starts
+    a second response on a finished ASGI cycle. This satisfies FastAPI while
+    putting nothing on the wire.
+    """
+
+    async def __call__(self, scope, receive, send) -> None:
+        return
+
+
+class _SendTracker:
+    """ASGI ``send`` wrapper that records whether a response was started."""
+
+    def __init__(self, send):
+        self._send = send
+        self.response_started = False
+
+    async def __call__(self, message) -> None:
+        if message.get("type") == "http.response.start":
+            self.response_started = True
+        await self._send(message)
+
+
 async def handle_sse(request: Request):
     """Entry point for the SSE connection."""
     logger.info("SSE client connected")
+    sender = _SendTracker(request._send)
     try:
-        async with sse.connect_sse(request.scope, request.receive, request._send) as (read_stream, write_stream):
+        async with sse.connect_sse(request.scope, request.receive, sender) as (read_stream, write_stream):
             await mcp_server.run(
                 read_stream,
                 write_stream,
@@ -70,6 +100,10 @@ async def handle_sse(request: Request):
         logger.debug("SSE connection closed: %s", type(exc).__name__)
     finally:
         logger.info("SSE client disconnected — handler exited, resources freed")
+    if sender.response_started:
+        return _AlreadySentResponse()
+    # connect_sse bailed out before writing anything (e.g. rejected origin).
+    return Response(status_code=500, content="SSE connection could not be established")
 
 
 async def handle_messages(request: Request):
@@ -99,7 +133,20 @@ async def handle_messages(request: Request):
             media_type="application/json"
         )
 
+    # `handle_post_message` builds its own Request and awaits `.body()` again.
+    # Starlette caches a body on the Request instance, not in the scope, so
+    # handing it the raw `receive` would make it wait for a body that has
+    # already been drained above — the POST hangs until the client gives up and
+    # the message never reaches the session. Replay the buffered bytes instead.
+    async def replay_receive() -> dict:
+        return {"type": "http.request", "body": raw_body, "more_body": False}
+
+    sender = _SendTracker(request._send)
     try:
-        await sse.handle_post_message(request.scope, request.receive, request._send)
+        await sse.handle_post_message(request.scope, replay_receive, sender)
     except Exception as exc:
         logger.debug("Message handler closed: %s", type(exc).__name__)
+
+    if sender.response_started:
+        return _AlreadySentResponse()
+    return Response(status_code=202, content="Accepted")

{codegraphcontext-0.5.3 → codegraphcontext-0.5.4}/src/codegraphcontext/cli/cli_helpers.py

@@ -239,65 +239,78 @@ def _initialize_services(
     return db_manager, graph_builder, code_finder, ctx
 
 
-async def _run_index_with_progress(graph_builder: GraphBuilder, path_obj: Path, is_dependency: bool = False, cgcignore_path: str = None):
+async def _run_index_with_progress(graph_builder: GraphBuilder, path_obj: Path, is_dependency: bool = False, cgcignore_path: str = None, disable_progress: bool = False):
     """Internal helper to run indexing with a Live progress bar."""
     job_id = graph_builder.job_manager.create_job(str(path_obj), is_dependency=is_dependency)
     
-    # Create the progress bar
-    with Progress(
-        SpinnerColumn(),
-        TextColumn("[progress.description]{task.description}"),
-        BarColumn(),
-        TaskProgressColumn(),
-        MofNCompleteColumn(),
-        TimeRemainingColumn(),
-        TextColumn("[dim]{task.fields[filename]}"),
-        console=console,
-        transient=True,
-    ) as progress:
-        
-        task_id = progress.add_task(
-            "Indexing...", 
-            total=None,  # Will be updated once file discovery is done
-            filename=""
-        )
+    disable_progress = (
+        disable_progress
+        or not console.is_terminal
+        or os.environ.get("CI", "").lower() == "true"
+    )
 
-        indexing_task = asyncio.create_task(
-            graph_builder.build_graph_from_path_async(path_obj, is_dependency=is_dependency, job_id=job_id, cgcignore_path=cgcignore_path)
-        )
+    if not disable_progress:
+        os.environ["CGC_ACTIVE_PROGRESS_BAR"] = "1"
 
-        from ..core.jobs import JobStatus
+    try:
+        # Create the progress bar
+        with Progress(
+            SpinnerColumn(),
+            TextColumn("[progress.description]{task.description}"),
+            BarColumn(),
+            TaskProgressColumn(),
+            MofNCompleteColumn(),
+            TimeRemainingColumn(),
+            TextColumn("[dim]{task.fields[filename]}"),
+            console=console,
+            transient=True,
+            disable=disable_progress,
+        ) as progress:
         
-        # Poll for updates
-        while not indexing_task.done():
-            job = graph_builder.job_manager.get_job(job_id)
-            if job:
-                if job.total_files > 0:
-                    progress.update(task_id, total=job.total_files, completed=job.processed_files)
-                
-                # Prefer post-processing status over the last parsed file path
-                current_file = job.status_message or job.current_file or ""
-                if len(current_file) > 40:
-                    current_file = "..." + current_file[-37:]
-                progress.update(task_id, filename=current_file)
+            task_id = progress.add_task(
+                "Indexing...", 
+                total=None,  # Will be updated once file discovery is done
+                filename=""
+            )
 
-                if job.status in [JobStatus.COMPLETED, JobStatus.FAILED, JobStatus.CANCELLED]:
-                    break
+            indexing_task = asyncio.create_task(
+                graph_builder.build_graph_from_path_async(path_obj, is_dependency=is_dependency, job_id=job_id, cgcignore_path=cgcignore_path)
+            )
+
+            from ..core.jobs import JobStatus
             
-            await asyncio.sleep(0.1)
+            # Poll for updates
+            while not indexing_task.done():
+                job = graph_builder.job_manager.get_job(job_id)
+                if job:
+                    if job.total_files > 0:
+                        progress.update(task_id, total=job.total_files, completed=job.processed_files)
+                    
+                    # Prefer post-processing status over the last parsed file path
+                    current_file = job.status_message or job.current_file or ""
+                    if len(current_file) > 40:
+                        current_file = "..." + current_file[-37:]
+                    progress.update(task_id, filename=current_file)
+
+                    if job.status in [JobStatus.COMPLETED, JobStatus.FAILED, JobStatus.CANCELLED]:
+                        break
+                
+                await asyncio.sleep(0.1)
 
-        # Wait for actual completion and handle final state
-        try:
-            await indexing_task
-            job = graph_builder.job_manager.get_job(job_id)
-            if job and job.status == JobStatus.FAILED:
-                error_msg = job.errors[0] if job.errors else "Unknown error"
-                raise RuntimeError(error_msg)
-        except Exception as e:
-            raise e
+            # Wait for actual completion and handle final state
+            try:
+                await indexing_task
+                job = graph_builder.job_manager.get_job(job_id)
+                if job and job.status == JobStatus.FAILED:
+                    error_msg = job.errors[0] if job.errors else "Unknown error"
+                    raise RuntimeError(error_msg)
+            except Exception as e:
+                raise e
+    finally:
+        os.environ.pop("CGC_ACTIVE_PROGRESS_BAR", None)
 
 
-def index_helper(path: str, context: Optional[str] = None):
+def index_helper(path: str, context: Optional[str] = None, no_progress: bool = False):
     """Synchronously indexes a repository in a given context."""
     time_start = time.time()
     path_obj = Path(path).resolve()
@@ -334,10 +347,16 @@ def index_helper(path: str, context: Optional[str] = None):
                 file_count = record["file_count"] if record else 0
                 
                 if file_count > 0:
-                    console.print(f"[yellow]Repository '{path}' is already indexed with {file_count} files. Skipping.[/yellow]")
-                    console.print("[dim]💡 Tip: Use 'cgc index --force' to re-index[/dim]")
-                    db_manager.close_driver()
-                    return
+                    expected = graph_builder.estimate_processing_time(path_obj) if path_obj.is_dir() else None
+                    expected_file_count = expected[0] if expected else None
+                    if expected_file_count is None or file_count >= expected_file_count:
+                        console.print(f"[yellow]Repository '{path}' is already indexed with {file_count} files. Skipping.[/yellow]")
+                        console.print("[dim]💡 Tip: Use 'cgc index --force' to re-index[/dim]")
+                        db_manager.close_driver()
+                        return
+                    console.print(
+                        f"[yellow]Repository '{path}' has only {file_count} of {expected_file_count} files indexed. Continuing.[/yellow]"
+                    )
                 else:
                     console.print(f"[yellow]Repository '{path}' exists but has no files (likely interrupted). Re-indexing...[/yellow]")
         except Exception as e:
@@ -351,7 +370,7 @@ def index_helper(path: str, context: Optional[str] = None):
     console.print(f"Starting indexing for: {path_obj}")
 
     try:
-        asyncio.run(_run_index_with_progress(graph_builder, path_obj, is_dependency=False, cgcignore_path=ctx.cgcignore_path))
+        asyncio.run(_run_index_with_progress(graph_builder, path_obj, is_dependency=False, cgcignore_path=ctx.cgcignore_path, disable_progress=no_progress))
         time_end = time.time()
         elapsed = time_end - time_start
         _print_call_resolution_diagnostics(graph_builder)
@@ -608,34 +627,56 @@ def _render_offline_visualization(
     def _ident(value) -> Optional[str]:
         return None if value is None else str(value)
 
-    # Neo4j/Falkor return driver objects carrying .labels / .type; Kùzu and
-    # Ladybug return plain dicts carrying _label plus _src/_dst. Check the
-    # driver attributes first — a driver object may also be dict-like.
+    # Kùzu spells the internal record keys in lowercase (_label/_src/_dst/_id);
+    # Ladybug returns the same fields uppercased (_LABEL/_SRC/_DST/_ID). Look
+    # up both spellings so either backend reaches the offline renderer (#1458).
+    def _meta(d: dict, key: str, default=None):
+        if key in d:
+            return d[key]
+        return d.get(key.upper(), default)
+
+    def _has_meta(d: dict, key: str) -> bool:
+        return key in d or key.upper() in d
+
+    # Neo4j returns driver objects carrying .labels / .type that support
+    # dict()/Mapping access. FalkorDB's own driver objects also carry
+    # .labels on nodes, but are NOT dict-convertible — their properties live
+    # in a plain `.properties` dict, and its Edge exposes `.relation` /
+    # `.src_node` / `.dest_node` instead of `.type` / `.start_node` /
+    # `.end_node`. Kùzu and Ladybug return plain dicts carrying _label plus
+    # _src/_dst. Check the driver attributes first — a driver object may
+    # also be dict-like.
     def _is_relationship(value) -> bool:
         if hasattr(value, "labels"):
             return False
         if hasattr(value, "type"):
             return True
-        return isinstance(value, dict) and "_src" in value and "_dst" in value
+        if hasattr(value, "relation") and hasattr(value, "src_node"):
+            return True
+        return isinstance(value, dict) and _has_meta(value, "_src") and _has_meta(value, "_dst")
 
     def _is_node(value) -> bool:
         if hasattr(value, "labels"):
             return True
         if hasattr(value, "type"):
             return False
+        if hasattr(value, "relation") and hasattr(value, "src_node"):
+            return False
         # Kùzu relationships also carry _label, so _src/_dst is what
         # distinguishes them from nodes.
-        return isinstance(value, dict) and "_label" in value and "_src" not in value
+        return isinstance(value, dict) and _has_meta(value, "_label") and not _has_meta(value, "_src")
 
     def _node_payload(value) -> Dict[str, Any]:
         if hasattr(value, "labels"):
-            props = dict(value)
+            # FalkorDB's Node keeps properties in `.properties` and is not
+            # itself iterable; Neo4j's Node supports dict() via Mapping.
+            props = dict(value.properties) if hasattr(value, "properties") else dict(value)
             labels = list(getattr(value, "labels", []) or [])
             label = labels[0] if labels else "Node"
             node_id = getattr(value, "element_id", None) or getattr(value, "id", None)
         else:
-            props, label = dict(value), value.get("_label", "Node")
-            node_id = value.get("_id")
+            props, label = dict(value), _meta(value, "_label", "Node")
+            node_id = _meta(value, "_id")
         if node_id is None:
             node_id = props.get("path") or props.get("name")
         return {
@@ -646,20 +687,33 @@ def _render_offline_visualization(
             "line_number": props.get("line_number"),
         }
 
+    def _node_ref_id(ref) -> Any:
+        # Neo4j's start_node/end_node are full Node objects; FalkorDB's
+        # src_node/dest_node are already the bare node id (an int).
+        if isinstance(ref, (int, str)):
+            return ref
+        return getattr(ref, "element_id", None) or getattr(ref, "id", None)
+
     def _edge_payload(value) -> Optional[Dict[str, Any]]:
+        # Neo4j: .start_node/.end_node/.type. FalkorDB: .src_node/.dest_node/
+        # .relation.
         start = getattr(value, "start_node", None)
+        if start is None:
+            start = getattr(value, "src_node", None)
         end = getattr(value, "end_node", None)
+        if end is None:
+            end = getattr(value, "dest_node", None)
         if start is not None and end is not None:
             return {
-                "source": _ident(getattr(start, "element_id", None) or getattr(start, "id", None)),
-                "target": _ident(getattr(end, "element_id", None) or getattr(end, "id", None)),
-                "type": getattr(value, "type", "RELATED"),
+                "source": _ident(_node_ref_id(start)),
+                "target": _ident(_node_ref_id(end)),
+                "type": getattr(value, "type", None) or getattr(value, "relation", "RELATED"),
             }
         if isinstance(value, dict):
             return {
-                "source": _ident(value.get("_src")),
-                "target": _ident(value.get("_dst")),
-                "type": value.get("_label", "RELATED"),
+                "source": _ident(_meta(value, "_src")),
+                "target": _ident(_meta(value, "_dst")),
+                "type": _meta(value, "_label", "RELATED"),
             }
         return None
 
@@ -803,7 +857,7 @@ def visualize_helper(
         db_manager.close_driver()
 
 
-def reindex_helper(path: str, context: Optional[str] = None):
+def reindex_helper(path: str, context: Optional[str] = None, no_progress: bool = False):
     """Force re-index by deleting and rebuilding the repository."""
     time_start = time.time()
     path_obj = Path(path).resolve()
@@ -836,7 +890,7 @@ def reindex_helper(path: str, context: Optional[str] = None):
     console.print(f"[cyan]Re-indexing: {path_obj}[/cyan]")
     
     try:
-        asyncio.run(_run_index_with_progress(graph_builder, path_obj, is_dependency=False, cgcignore_path=ctx.cgcignore_path))
+        asyncio.run(_run_index_with_progress(graph_builder, path_obj, is_dependency=False, cgcignore_path=ctx.cgcignore_path, disable_progress=no_progress))
         time_end = time.time()
         elapsed = time_end - time_start
         _print_call_resolution_diagnostics(graph_builder)

{codegraphcontext-0.5.3 → codegraphcontext-0.5.4}/src/codegraphcontext/cli/config_manager.py

@@ -87,6 +87,8 @@ DEFAULT_CONFIG = {
     "DEFAULT_DATABASE": "falkordb",
     "FALKORDB_PATH": str(CONFIG_DIR / "global" / "db" / "falkordb"),
     "FALKORDB_SOCKET_PATH": str(CONFIG_DIR / "global" / "db" / "falkordb.sock"),
+    # Empty selects a deterministic port derived from each embedded DB socket.
+    "FALKORDB_PORT": "",
     "LADYBUGDB_PATH": str(CONFIG_DIR / "global" / "db" / "ladybugdb"),
     "KUZUDB_PATH": str(CONFIG_DIR / "global" / "db" / "kuzudb"),
     "INDEX_VARIABLES": "true",
@@ -142,6 +144,7 @@ CONFIG_DESCRIPTIONS = {
     "DEFAULT_DATABASE": "Default database backend (neo4j|falkordb|falkordb-remote|kuzudb|nornic|ladybugdb)",
     "FALKORDB_PATH": "Path to FalkorDB database file",
     "FALKORDB_SOCKET_PATH": "Path to FalkorDB Unix socket",
+    "FALKORDB_PORT": "Optional FalkorDB port override (empty = per-database port)",
     "LADYBUGDB_PATH": "Path to LadybugDB database directory",
     "KUZUDB_PATH": "Path to KuzuDB database directory",
     "INDEX_VARIABLES": "Index variable nodes in the graph (lighter graph if false)",

{codegraphcontext-0.5.3 → codegraphcontext-0.5.4}/src/codegraphcontext/cli/main.py

@@ -1440,6 +1440,7 @@ def index(
     force: bool = typer.Option(False, "--force", "-f", help="Force re-index (delete existing and rebuild)"),
     context: Optional[str] = typer.Option(None, "--context", "-c", help="Specific context to use (overrides mode/default)"),
     summarize: bool = typer.Option(False, "--summarize", "-s", help="Show a summary of the indexed codebase after indexing"),
+    no_progress: bool = typer.Option(False, "--no-progress", help="Disable live progress rendering during indexing."),
 ):
     """
     Indexes a directory or file by adding it to the code graph.
@@ -1455,9 +1456,9 @@ def index(
     try:
         if force:
             console.print("[yellow]Force re-indexing (--force flag detected)[/yellow]")
-            reindex_helper(path, context)
+            reindex_helper(path, context, no_progress=no_progress)
         else:
-            index_helper(path, context)
+            index_helper(path, context, no_progress=no_progress)
     except typer.Exit:
         # typer.Exit subclasses RuntimeError and str() is empty, so the handler
         # below caught it, printed nothing, and returned 0 — every helper that
@@ -3050,12 +3051,13 @@ def index_abbrev(
     path: Optional[str] = typer.Argument(None, help="Path to index"),
     force: bool = typer.Option(False, "--force", "-f", help="Force re-index (delete existing and rebuild)"),
     summarize: bool = typer.Option(False, "--summarize", "-s", help="Display a codebase summary after indexing"),
-    context: Optional[str] = typer.Option(None, "--context", "-c", help="Specific context to use")
+    context: Optional[str] = typer.Option(None, "--context", "-c", help="Specific context to use"),
+    no_progress: bool = typer.Option(False, "--no-progress", help="Disable live progress rendering during indexing.")
 ):
     """Shortcut for 'cgc index'"""
     # `summarize` must be passed explicitly: omitted, it keeps its OptionInfo
     # sentinel, which is truthy — so `cgc i` always printed the summary.
-    index(path, force=force, summarize=summarize, context=context)
+    index(path, force=force, summarize=summarize, context=context, no_progress=no_progress)
 
 @app.command("ls", rich_help_panel="Shortcuts")
 def list_abbrev(
@@ -3084,7 +3086,10 @@ def visualize_abbrev(
 ):
     """Shortcut for 'cgc visualize'"""
     _load_credentials()
-    visualize_helper(repo, port, context=context)
+    # `port` must be passed by keyword: visualize_helper's second positional
+    # parameter is `host`, so the int landed there and the server tried to bind
+    # to host=8000 while ignoring --port entirely.
+    visualize_helper(repo, port=port, context=context)
 
 @app.command("w", rich_help_panel="Shortcuts")
 def watch_abbrev(

{codegraphcontext-0.5.3 → codegraphcontext-0.5.4}/src/codegraphcontext/cli/setup_wizard.py

@@ -184,6 +184,11 @@ def find_jetbrains_mcp_config():
                     configs.append(mcp_file)
                     print(mcp_file)
                     return configs
+    # Always return a list: callers store this directly in the config_paths
+    # mapping and iterate it, so returning None (no JetBrains install, or no
+    # mcpServer.xml yet) raised a TypeError instead of falling through to the
+    # "configure manually" path.
+    return configs
 
 
 def convert_mcp_json_to_yaml():