code-graph-rag 0.0.187__tar.gz → 0.0.245__tar.gz

{code_graph_rag-0.0.187/code_graph_rag.egg-info → code_graph_rag-0.0.245}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-graph-rag
-Version: 0.0.187
+Version: 0.0.245
 Summary: The ultimate RAG for your monorepo. Query, understand, and edit multi-language codebases with the power of AI and knowledge graphs
 License-Expression: MIT
 Keywords: rag,retrieval-augmented-generation,knowledge-graph,code-analysis,tree-sitter,mcp,mcp-server,llm,graph-database,semantic-search,codebase,memgraph,developer-tools,monorepo
@@ -38,6 +38,7 @@ Requires-Dist: protobuf>=6.33.5
 Requires-Dist: defusedxml>=0.7.1
 Requires-Dist: huggingface-hub[hf-xet]>=1.7.2
 Requires-Dist: griffe<2,>=1.0
+Requires-Dist: pathspec>=1.0.4
 Provides-Extra: test
 Requires-Dist: pytest>=8.4.1; extra == "test"
 Requires-Dist: pytest-asyncio>=1.0.0; extra == "test"
@@ -99,7 +100,7 @@ The package installs a `cgr` command.
 **Start Memgraph, parse a repo, and query it:**
 
 ```bash
-docker compose up -d                       # start Memgraph
+cgr daemon up                              # start Memgraph + Qdrant
 cgr start --repo-path ./my-project \
           --update-graph --clean           # parse & launch interactive chat
 ```

{code_graph_rag-0.0.187 → code_graph_rag-0.0.245}/PYPI_README.md

@@ -34,7 +34,7 @@ The package installs a `cgr` command.
 **Start Memgraph, parse a repo, and query it:**
 
 ```bash
-docker compose up -d                       # start Memgraph
+cgr daemon up                              # start Memgraph + Qdrant
 cgr start --repo-path ./my-project \
           --update-graph --clean           # parse & launch interactive chat
 ```

{code_graph_rag-0.0.187 → code_graph_rag-0.0.245}/README.md

@@ -20,7 +20,7 @@
     <img src="https://img.shields.io/github/forks/vitali87/code-graph-rag?style=social" alt="GitHub forks" />
   </a>
   -->
-  <!-- Codecov, SonarCloud, and OpenSSF Scorecard badges were fed by GitHub-side CI. They no longer update after the move to Codeberg. Restore once equivalent CI is in place on Codeberg (Woodpecker).
+  <!-- Codecov, SonarCloud, and OpenSSF Scorecard badges are fed by GitHub-side CI. Uncomment once that CI is confirmed to publish to these services again.
   <a href="https://codecov.io/gh/vitali87/code-graph-rag">
     <img src="https://codecov.io/gh/vitali87/code-graph-rag/graph/badge.svg" alt="Codecov" />
   </a>
@@ -39,7 +39,7 @@
   <a href="https://pepy.tech/projects/code-graph-rag">
     <img src="https://static.pepy.tech/personalized-badge/code-graph-rag?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads" alt="PyPI Downloads" />
   </a>
-  <!-- OpenSSF Scorecard only tracks GitHub-hosted repos. Restore if the project is mirrored back to GitHub or scorecard.dev adds Codeberg support.
+  <!-- OpenSSF Scorecard only tracks GitHub-hosted repos. Uncomment once the Scorecard workflow is confirmed running on the authoritative GitHub repo.
   <a href="https://scorecard.dev/viewer/?uri=github.com/vitali87/code-graph-rag">
     <img src="https://api.scorecard.dev/projects/github.com/vitali87/code-graph-rag/badge" alt="OpenSSF Scorecard" />
   </a>
@@ -82,7 +82,8 @@ An accurate Retrieval-Augmented Generation (RAG) system that analyzes multi-lang
 | PHP | Fully Supported | .php | ✓ | ✓ | ✓ | - | Classes, interfaces, traits, enums, namespaces, PHP 8 attributes |
 | Python | Fully Supported | .py | ✓ | ✓ | ✓ | ✓ | Type inference, decorators, nested functions |
 | Rust | Fully Supported | .rs | ✓ | ✓ | ✓ | ✓ | impl blocks, associated functions |
-| TypeScript | Fully Supported | .ts, .tsx | ✓ | ✓ | ✓ | - | Interfaces, type aliases, enums, namespaces, ES6/CommonJS modules |
+| TypeScript (TSX) | Fully Supported | .tsx | ✓ | ✓ | ✓ | - | All TypeScript features plus JSX elements and components |
+| TypeScript | Fully Supported | .ts | ✓ | ✓ | ✓ | - | Interfaces, type aliases, enums, namespaces, ES6/CommonJS modules |
 | Go | In Development | .go | ✓ | ✓ | ✓ | - | Methods, type declarations |
 | Scala | In Development | .scala, .sc | ✓ | ✓ | ✓ | - | Case classes, objects |
 <!-- /SECTION:supported_languages -->
@@ -187,7 +188,7 @@ volumes (`memgraph_data`, `memgraph_log`, `qdrant_storage`).
 ### Local development install
 
 ```bash
-git clone https://codeberg.org/vitali87/code-graph-rag.git
+git clone https://github.com/vitali87/code-graph-rag.git
 cd code-graph-rag
 ```
 
@@ -292,7 +293,7 @@ ollama pull llama3.2
 
 4. **Start Memgraph database**:
 ```bash
-docker compose up -d
+cgr daemon up
 ```
 
 5. **Verify installation**:
@@ -331,6 +332,7 @@ Use the Makefile for common development tasks:
 | `make format` | Run ruff format |
 | `make typecheck` | Run type checking with ty |
 | `make check` | Run all checks: lint, typecheck, test |
+| `make release` | Build, verify, and publish the current pyproject version to PyPI, then tag and create a GitHub Release |
 | `make pre-commit` | Run all pre-commit checks locally (comprehensive test before commit) |
 <!-- /SECTION:makefile_commands -->
 
@@ -674,6 +676,7 @@ The knowledge graph uses the following node types and relationships:
 | ModuleInterface | `{qualified_name: string, name: string, path: string, absolute_path: string}` |
 | ModuleImplementation | `{qualified_name: string, name: string, path: string, absolute_path: string, implements_module: string}` |
 | ExternalPackage | `{name: string, version_spec: string}` |
+| ExternalModule | `{qualified_name: string, name: string, path: string}` |
 <!-- /SECTION:node_schemas -->
 
 ### Language-Specific Mappings
@@ -687,6 +690,7 @@ The knowledge graph uses the following node types and relationships:
 - **PHP**: `anonymous_function`, `arrow_function`, `class_declaration`, `enum_declaration`, `function_definition`, `interface_declaration`, `method_declaration`, `trait_declaration`
 - **Python**: `class_definition`, `function_definition`
 - **Rust**: `closure_expression`, `enum_item`, `function_item`, `function_signature_item`, `impl_item`, `struct_item`, `trait_item`, `type_item`, `union_item`
+- **TypeScript (TSX)**: `abstract_class_declaration`, `arrow_function`, `class`, `class_declaration`, `enum_declaration`, `function_declaration`, `function_expression`, `function_signature`, `generator_function_declaration`, `interface_declaration`, `internal_module`, `method_definition`, `type_alias_declaration`
 - **TypeScript**: `abstract_class_declaration`, `arrow_function`, `class`, `class_declaration`, `enum_declaration`, `function_declaration`, `function_expression`, `function_signature`, `generator_function_declaration`, `interface_declaration`, `internal_module`, `method_definition`, `type_alias_declaration`
 - **Go**: `function_declaration`, `method_declaration`, `type_alias`, `type_spec`
 - **Scala**: `class_definition`, `function_declaration`, `function_definition`, `object_definition`, `trait_definition`
@@ -703,7 +707,7 @@ The knowledge graph uses the following node types and relationships:
 | Project, Package, Folder | CONTAINS_MODULE | Module |
 | Module | DEFINES | Class, Function |
 | Class | DEFINES_METHOD | Method |
-| Module | IMPORTS | Module |
+| Module | IMPORTS | Module, ExternalModule |
 | Module | EXPORTS | Class, Function |
 | Module | EXPORTS_MODULE | ModuleInterface |
 | Module | IMPLEMENTS_MODULE | ModuleImplementation |
@@ -713,6 +717,8 @@ The knowledge graph uses the following node types and relationships:
 | ModuleImplementation | IMPLEMENTS | ModuleInterface |
 | Project | DEPENDS_ON_EXTERNAL | ExternalPackage |
 | Function, Method | CALLS | Function, Method |
+| Module, Function, Method | REFERENCES | Function, Method, Class |
+| Module, Function, Method | INSTANTIATES | Class |
 <!-- /SECTION:relationship_schemas -->
 
 ## 🔧 Configuration
@@ -754,27 +760,28 @@ Configuration is managed through environment variables in `.env` file:
 
 ### Custom Ignore Patterns
 
-You can specify additional directories to exclude by creating a `.cgrignore` file in your repository root:
+You can specify additional files and directories to exclude by creating a `.cgrignore` file in your repository root. Patterns follow `.gitignore` conventions:
 
 ```
 # Comments start with #
 vendor
-.custom_cache
-my_build_output
+*.gen.ts
+docs/*.md
+/generated
+!bin/keep.py
 ```
 
-- One directory name per line
-- Lines starting with `#` are comments
-- Blank lines are ignored
-- Patterns are exact directory name matches (not globs)
-- Patterns from `.cgrignore` are merged with `--exclude` flags and auto-detected directories
+- Gitignore syntax: `*` matches within a segment, `**` crosses segments, bare names match at any depth, slash-containing patterns are anchored to the root, trailing slash matches directories only
+- Lines starting with `!` un-ignore paths that a default exclusion would skip (explicit excludes always win)
+- Lines starting with `#` are comments; blank lines are ignored
+- Patterns from `.cgrignore` are merged with `--exclude` flags (same syntax) and auto-detected directories
 
 ### Key Dependencies
 
 <!-- SECTION:dependencies -->
 - **loguru**: Python logging made (stupidly) simple
 - **mcp**: Model Context Protocol SDK
-- **pydantic-ai**: Agent Framework / shim to use Pydantic with LLMs
+- **pydantic-ai**: AI Agent Framework, the Pydantic way
 - **pydantic-settings**: Settings management using Pydantic
 - **pymgclient**: Memgraph database adapter for Python language
 - **python-dotenv**: Read key-value pairs from a .env file and set them as environment variables
@@ -792,6 +799,7 @@ my_build_output
 - **defusedxml**: XML bomb protection for Python stdlib modules
 - **huggingface-hub**: Client library to download and publish models, datasets and other repos on the huggingface.co hub
 - **griffe**: Signatures for entire Python programs. Extract the structure, the frame, the skeleton of your project, to generate API documentation or find breaking changes in your API.
+- **pathspec**: Utility library for gitignore style pattern matching of file paths.
 <!-- /SECTION:dependencies -->
 
 ## 🤖 Agentic Workflow & Tools
@@ -835,7 +843,7 @@ Code-Graph-RAG makes it easy to add support for any language that has a Tree-sit
 
 > **⚠️ Recommendation**: While you can add languages yourself, we recommend waiting for official full support to ensure optimal parsing quality, comprehensive feature coverage, and robust integration. The languages marked as "In Development" above will receive dedicated optimization and testing.
 
-> **💡 Request Support**: If you want a specific language to be officially supported, please [submit an issue](https://codeberg.org/vitali87/code-graph-rag/issues) with your language request.
+> **💡 Request Support**: If you want a specific language to be officially supported, please [submit an issue](https://github.com/vitali87/code-graph-rag/issues) with your language request.
 
 #### Quick Start: Add a Language
 

{code_graph_rag-0.0.187 → code_graph_rag-0.0.245/code_graph_rag.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-graph-rag
-Version: 0.0.187
+Version: 0.0.245
 Summary: The ultimate RAG for your monorepo. Query, understand, and edit multi-language codebases with the power of AI and knowledge graphs
 License-Expression: MIT
 Keywords: rag,retrieval-augmented-generation,knowledge-graph,code-analysis,tree-sitter,mcp,mcp-server,llm,graph-database,semantic-search,codebase,memgraph,developer-tools,monorepo
@@ -38,6 +38,7 @@ Requires-Dist: protobuf>=6.33.5
 Requires-Dist: defusedxml>=0.7.1
 Requires-Dist: huggingface-hub[hf-xet]>=1.7.2
 Requires-Dist: griffe<2,>=1.0
+Requires-Dist: pathspec>=1.0.4
 Provides-Extra: test
 Requires-Dist: pytest>=8.4.1; extra == "test"
 Requires-Dist: pytest-asyncio>=1.0.0; extra == "test"
@@ -99,7 +100,7 @@ The package installs a `cgr` command.
 **Start Memgraph, parse a repo, and query it:**
 
 ```bash
-docker compose up -d                       # start Memgraph
+cgr daemon up                              # start Memgraph + Qdrant
 cgr start --repo-path ./my-project \
           --update-graph --clean           # parse & launch interactive chat
 ```

{code_graph_rag-0.0.187 → code_graph_rag-0.0.245}/code_graph_rag.egg-info/SOURCES.txt

@@ -44,9 +44,11 @@ codebase_rag/parsers/call_processor.py
 codebase_rag/parsers/call_resolver.py
 codebase_rag/parsers/definition_processor.py
 codebase_rag/parsers/dependency_parser.py
+codebase_rag/parsers/export_detection.py
 codebase_rag/parsers/factory.py
 codebase_rag/parsers/function_ingest.py
 codebase_rag/parsers/import_processor.py
+codebase_rag/parsers/python_source_roots.py
 codebase_rag/parsers/stdlib_extractor.py
 codebase_rag/parsers/structure_processor.py
 codebase_rag/parsers/type_inference.py
@@ -61,12 +63,15 @@ codebase_rag/parsers/class_ingest/parent_extraction.py
 codebase_rag/parsers/class_ingest/relationships.py
 codebase_rag/parsers/class_ingest/utils.py
 codebase_rag/parsers/cpp/__init__.py
+codebase_rag/parsers/cpp/type_inference.py
 codebase_rag/parsers/cpp/utils.py
 codebase_rag/parsers/cpp_frontend/__init__.py
 codebase_rag/parsers/cpp_frontend/constants.py
 codebase_rag/parsers/cpp_frontend/frontend.py
 codebase_rag/parsers/cpp_frontend/qn.py
 codebase_rag/parsers/go/__init__.py
+codebase_rag/parsers/go/module_paths.py
+codebase_rag/parsers/go/type_inference.py
 codebase_rag/parsers/go/utils.py
 codebase_rag/parsers/handlers/__init__.py
 codebase_rag/parsers/handlers/base.py
@@ -100,6 +105,7 @@ codebase_rag/parsers/py/type_inference.py
 codebase_rag/parsers/py/utils.py
 codebase_rag/parsers/py/variable_analyzer.py
 codebase_rag/parsers/rs/__init__.py
+codebase_rag/parsers/rs/type_inference.py
 codebase_rag/parsers/rs/utils.py
 codebase_rag/providers/__init__.py
 codebase_rag/providers/base.py

{code_graph_rag-0.0.187 → code_graph_rag-0.0.245}/code_graph_rag.egg-info/requires.txt

@@ -18,6 +18,7 @@ protobuf>=6.33.5
 defusedxml>=0.7.1
 huggingface-hub[hf-xet]>=1.7.2
 griffe<2,>=1.0
+pathspec>=1.0.4
 
 [semantic]
 qdrant-client>=1.9.0

{code_graph_rag-0.0.187 → code_graph_rag-0.0.245}/codebase_rag/cli.py

@@ -2,6 +2,7 @@ import asyncio
 import json
 import time
 from collections.abc import Callable
+from fnmatch import fnmatch
 from functools import partial
 from importlib.metadata import version as get_version
 from pathlib import Path
@@ -16,7 +17,7 @@ from . import cgr_state
 from . import cli_help as ch
 from . import constants as cs
 from . import logs as ls
-from .config import load_cgrignore_patterns, settings
+from .config import load_ignore_patterns, settings
 from .graph_updater import GraphUpdater
 from .main import (
     _create_configuration_table,
@@ -192,7 +193,7 @@ def _run_graph_sync(
     clean: bool = False,
     output: str | None = None,
 ) -> None:
-    cgrignore = load_cgrignore_patterns(repo)
+    cgrignore = load_ignore_patterns(repo)
     cli_excludes = frozenset(exclude) if exclude else frozenset()
     exclude_paths = cli_excludes | cgrignore.exclude or None
     unignore_paths: frozenset[str] | None
@@ -535,7 +536,7 @@ def index(
 
     _info(style(cs.CLI_MSG_OUTPUT_TO.format(path=output_proto_dir), cs.Color.CYAN))
 
-    cgrignore = load_cgrignore_patterns(repo_to_index)
+    cgrignore = load_ignore_patterns(repo_to_index)
     cli_excludes = frozenset(exclude) if exclude else frozenset()
     exclude_paths = cli_excludes | cgrignore.exclude or None
     unignore_paths: frozenset[str] | None = None
@@ -941,6 +942,22 @@ def _dead_code_params(
     }
 
 
+def _filter_excluded_rows(rows: list[ResultRow], exclude: list[str]) -> list[ResultRow]:
+    # (H) Drop candidates whose file path matches an exclude glob (generated dirs
+    # (H) like client/core or *.gen.* have no in-repo caller, so every symbol
+    # (H) reports as dead). fnmatch treats '*' as spanning '/', so '*client/core*'
+    # (H) matches at any depth.
+    if not exclude:
+        return rows
+    return [
+        row
+        for row in rows
+        if not any(
+            fnmatch(str(row.get(cs.KEY_PATH) or ""), pattern) for pattern in exclude
+        )
+    ]
+
+
 def _to_dead_code_row(row: ResultRow) -> DeadCodeRow:
     start = row.get(cs.KEY_START_LINE, 0)
     end = row.get(cs.KEY_END_LINE, 0)
@@ -1028,6 +1045,7 @@ def dead_code(
     decorator_root: list[str] = typer.Option(
         [], "--decorator-root", help=ch.HELP_DEADCODE_DECORATOR_ROOT
     ),
+    exclude: list[str] = typer.Option([], "--exclude", help=ch.HELP_DEADCODE_EXCLUDE),
     include_tests: bool = typer.Option(
         True,
         "--include-tests/--no-include-tests",
@@ -1083,7 +1101,9 @@ def dead_code(
         app_context.console.print(style(message, cs.Color.RED))
         raise typer.Exit(1)
 
-    candidates = [_to_dead_code_row(row) for row in rows]
+    candidates = [
+        _to_dead_code_row(row) for row in _filter_excluded_rows(rows, exclude)
+    ]
     _emit_dead_code(candidates, output_format, output, resolved)
 
     if fail_on_found and candidates:

{code_graph_rag-0.0.187 → code_graph_rag-0.0.245}/codebase_rag/cli_help.py

@@ -191,6 +191,11 @@ HELP_DEADCODE_DECORATOR_ROOT = (
     "Treat functions/methods carrying this decorator as reachable roots. "
     "Extends the built-in set (route, task, fixture, command, ...). Repeatable."
 )
+HELP_DEADCODE_EXCLUDE = (
+    "Glob matched against a symbol's file path to exclude from the report "
+    "(e.g. '*client/core*', '*.gen.*' for generated code). '*' spans '/'. "
+    "Repeatable."
+)
 HELP_DEADCODE_INCLUDE_TESTS = (
     "Treat test code as reachable roots so production code it exercises is "
     "not reported. On by default."

{code_graph_rag-0.0.187 → code_graph_rag-0.0.245}/codebase_rag/config.py

@@ -360,13 +360,13 @@ class AppConfig(BaseSettings):
 settings = AppConfig()
 
 CGRIGNORE_FILENAME = ".cgrignore"
+GITIGNORE_FILENAME = ".gitignore"
 
 
 EMPTY_CGRIGNORE = CgrignorePatterns(exclude=frozenset(), unignore=frozenset())
 
 
-def load_cgrignore_patterns(repo_path: Path) -> CgrignorePatterns:
-    ignore_file = repo_path / CGRIGNORE_FILENAME
+def _load_ignore_file(ignore_file: Path) -> CgrignorePatterns:
     if not ignore_file.is_file():
         return EMPTY_CGRIGNORE
 
@@ -394,11 +394,37 @@ def load_cgrignore_patterns(repo_path: Path) -> CgrignorePatterns:
             exclude=frozenset(exclude),
             unignore=frozenset(unignore),
         )
-    except OSError as e:
+    except (OSError, ValueError) as e:
         logger.warning(logs.CGRIGNORE_READ_FAILED.format(path=ignore_file, error=e))
         return EMPTY_CGRIGNORE
 
 
+def load_cgrignore_patterns(repo_path: Path) -> CgrignorePatterns:
+    return _load_ignore_file(repo_path / CGRIGNORE_FILENAME)
+
+
+def load_ignore_patterns(repo_path: Path) -> CgrignorePatterns:
+    # (H) Merged exclude/unignore set for indexing: root .gitignore (gitignored
+    # (H) paths are build artifacts / generated output whose symbols pollute the
+    # (H) graph and the dead-code report) plus .cgrignore, which stays the
+    # (H) authoritative cgr-specific channel. The runtime skip check gives
+    # (H) excludes precedence over unignores, so a negation can only override a
+    # (H) .gitignore exclude by CANCELLING the exact same pattern string here at
+    # (H) load time (`!generated/` drops `generated/`). .cgrignore excludes are
+    # (H) never cancelled by .gitignore negations.
+    # (H) ponytail: root .gitignore only, exact-string cancellation only; a
+    # (H) finer-grained negation (`!dist/keep.py` under excluded `dist/`) still
+    # (H) cannot rescue -- an ordered PathSpec soft layer in should_skip_path is
+    # (H) the upgrade path if real repos need it.
+    cgr = _load_ignore_file(repo_path / CGRIGNORE_FILENAME)
+    git = _load_ignore_file(repo_path / GITIGNORE_FILENAME)
+    negations = cgr.unignore | git.unignore
+    return CgrignorePatterns(
+        exclude=cgr.exclude | (git.exclude - negations),
+        unignore=negations,
+    )
+
+
 CGR_INSTRUCTIONS_FILENAME = ".cgr.md"
 GLOBAL_CGR_INSTRUCTIONS_PATH = Path.home() / CGR_INSTRUCTIONS_FILENAME