code-graph-rag 0.0.148__tar.gz → 0.0.209__tar.gz

{code_graph_rag-0.0.148/code_graph_rag.egg-info → code_graph_rag-0.0.209}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-graph-rag
-Version: 0.0.148
+Version: 0.0.209
 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
@@ -14,34 +14,38 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: loguru>=0.7.3
-Requires-Dist: mcp>=1.21.1
-Requires-Dist: pydantic-ai>=1.70.0
-Requires-Dist: pydantic-settings>=2.0.0
-Requires-Dist: pymgclient>=1.4.0
-Requires-Dist: python-dotenv>=1.1.0
+Requires-Dist: mcp>=1.25.0
+Requires-Dist: pydantic-ai>=1.102.0
+Requires-Dist: pydantic-settings>=2.12.0
+Requires-Dist: pymgclient>=1.5.1
+Requires-Dist: python-dotenv>=1.2.1
 Requires-Dist: tiktoken>=0.12.0
 Requires-Dist: toml>=0.10.2
-Requires-Dist: tree-sitter-python>=0.23.6
+Requires-Dist: tree-sitter-python>=0.25.0
 Requires-Dist: tree-sitter==0.25.2
 Requires-Dist: watchdog>=6.0.0
-Requires-Dist: typer>=0.12.5
-Requires-Dist: rich>=13.7.1
-Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: typer>=0.21.1
+Requires-Dist: rich>=14.2.0
+Requires-Dist: prompt-toolkit>=3.0.52
 Requires-Dist: diff-match-patch>=20241021
-Requires-Dist: click>=8.0.0
-Requires-Dist: protobuf>=5.27.0
+Requires-Dist: click>=8.3.1
+Requires-Dist: protobuf>=6.33.5
 Requires-Dist: defusedxml>=0.7.1
-Requires-Dist: huggingface-hub[hf-xet]>=0.36.0
+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"
 Requires-Dist: pytest-cov>=4.0.0; extra == "test"
 Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
 Requires-Dist: testcontainers>=4.9.0; extra == "test"
+Requires-Dist: libclang>=18.1.1; extra == "test"
 Provides-Extra: treesitter-full
 Requires-Dist: tree-sitter-python>=0.23.6; extra == "treesitter-full"
 Requires-Dist: tree-sitter-javascript>=0.23.1; extra == "treesitter-full"
@@ -53,6 +57,7 @@ Requires-Dist: tree-sitter-java>=0.23.5; extra == "treesitter-full"
 Requires-Dist: tree-sitter-c>=0.24.1; extra == "treesitter-full"
 Requires-Dist: tree-sitter-cpp>=0.23.0; extra == "treesitter-full"
 Requires-Dist: tree-sitter-lua>=0.0.19; extra == "treesitter-full"
+Requires-Dist: tree-sitter-php>=0.24.1; extra == "treesitter-full"
 Provides-Extra: semantic
 Requires-Dist: qdrant-client>=1.9.0; extra == "semantic"
 Requires-Dist: torch>=2.6.0; extra == "semantic"
@@ -95,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.148 → code_graph_rag-0.0.209}/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.148 → code_graph_rag-0.0.209}/README.md

@@ -1,38 +1,54 @@
 <div align="center">
+  <!-- Bitbucket strips <picture>/<source> tags, so we use a single light-mode <img>. Restore the theme-aware <picture> block below when the GitHub account is reinstated:
   <picture>
     <source srcset="assets/logo-dark-any.png" media="(prefers-color-scheme: dark)">
     <source srcset="assets/logo-light-any.png" media="(prefers-color-scheme: light)">
     <img src="assets/logo-dark-any.png" alt="Code-Graph-RAG Logo" width="480">
   </picture>
+  -->
+  <img src="assets/logo-light-any.png" alt="Code-Graph-RAG Logo" width="480">
 
   <p>
+  <!-- Badges below are commented out while the GitHub account is suspended. Restore them when the account is reinstated.
+       Stars/Forks: shields.io hits GitHub's API (returns "repo not found" for suspended accounts).
+       gitcgr: indexes from GitHub (shows "not indexed" while unavailable).
+       MseeP.ai: badge PNG ignores inline height on Bitbucket and renders as a full-size tile.
   <a href="https://github.com/vitali87/code-graph-rag/stargazers">
     <img src="https://img.shields.io/github/stars/vitali87/code-graph-rag?style=social" alt="GitHub stars" />
   </a>
   <a href="https://github.com/vitali87/code-graph-rag/network/members">
     <img src="https://img.shields.io/github/forks/vitali87/code-graph-rag?style=social" alt="GitHub forks" />
   </a>
+  -->
+  <!-- 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>
   <a href="https://sonarcloud.io/summary/overall?id=vitali87_code-graph-rag">
     <img src="https://sonarcloud.io/api/project_badges/measure?project=vitali87_code-graph-rag&metric=alert_status" alt="Quality Gate Status" />
   </a>
+  -->
+  <!--
   <a href="https://mseep.ai/app/vitali87-code-graph-rag">
     <img src="https://mseep.net/pr/vitali87-code-graph-rag-badge.png" alt="MseeP.ai Security Assessment" height="20" />
   </a>
+  -->
   <a href="https://code-graph-rag.com">
     <img src="https://img.shields.io/badge/Enterprise-Support%20%26%20Services-6366f1" alt="Enterprise Support" />
   </a>
   <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. 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>
+  -->
+  <!--
   <a href="https://gitcgr.com/vitali87/code-graph-rag">
     <img src="https://gitcgr.com/badge/vitali87/code-graph-rag.svg" alt="gitcgr" />
   </a>
+  -->
 </p>
 </div>
 
@@ -47,9 +63,9 @@ An accurate Retrieval-Augmented Generation (RAG) system that analyzes multi-lang
 
 ## Latest News 🔥
 
+- **PHP Language Support**: Full PHP language support added — classes, interfaces, traits, enums, namespaces, PHP 8 attributes, and call graph analysis. Contributed by [@rs-ipps](https://github.com/rs-ipps).
 - **C Language Support**: Full C language support added — functions, structs, unions, enums, preprocessor includes, and call graph analysis. Contributed by [@dj0nes](https://github.com/dj0nes).
 - **Visualise any GitHub repo instantly!** Just change `github.com` to `gitcgr.com` in any repo URL — that's it, only 3 letters! Get an interactive graph of the entire codebase structure. Try it now: [gitcgr.com](https://gitcgr.com)
-- **MCP Server Integration**: Code-Graph-RAG now works as an MCP server with Claude Code! Query and edit your codebase using natural language directly from Claude Code. [Setup Guide](docs/claude-code-setup.md)
 
 ## 🚀 Features
 
@@ -63,12 +79,11 @@ An accurate Retrieval-Augmented Generation (RAG) system that analyzes multi-lang
 | Java | Fully Supported | .java | ✓ | ✓ | ✓ | - | Generics, annotations, modern features (records/sealed classes), concurrency, reflection |
 | JavaScript | Fully Supported | .js, .jsx | ✓ | ✓ | ✓ | - | ES6 modules, CommonJS, prototype methods, object methods, arrow functions |
 | Lua | Fully Supported | .lua | ✓ | - | ✓ | - | Local/global functions, metatables, closures, coroutines |
+| 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 |
-| C# | In Development | .cs | ✓ | ✓ | ✓ | - | Classes, interfaces, generics (planned) |
 | Go | In Development | .go | ✓ | ✓ | ✓ | - | Methods, type declarations |
-| PHP | In Development | .php | ✓ | ✓ | ✓ | - | Classes, functions, namespaces |
 | Scala | In Development | .scala, .sc | ✓ | ✓ | ✓ | - | Case classes, objects |
 <!-- /SECTION:supported_languages -->
 - **🌳 Tree-sitter Parsing**: Uses Tree-sitter for robust, language-agnostic AST parsing
@@ -125,9 +140,54 @@ sudo dnf install ripgrep
 
 ## 🛠️ Installation
 
+### System-wide install (recommended for end users)
+
+`cgr` is published to PyPI and can be installed system-wide so it works from any
+target repo without activating a project virtualenv. Install with the
+`treesitter-full` (all languages) and `semantic` (vector search) extras:
+
 ```bash
-git clone https://github.com/vitali87/code-graph-rag.git
+# with uv (recommended)
+uv tool install "code-graph-rag[treesitter-full,semantic]"
+
+# or with pipx
+pipx install "code-graph-rag[treesitter-full,semantic]"
+```
+
+For a Python-only install, omit the extras. For local development from a clone,
+use `uv tool install --editable "/path/to/code-graph-rag[treesitter-full,semantic]"`.
+
+After install, `cgr` is on PATH. From any repository, run:
+
+```bash
+cd ~/path/to/some-target-repo
+cgr daemon up        # one-time: start the shared memgraph + qdrant stack
+cgr start            # auto-sync the current repo and drop into the agent
+```
+
+`cgr start` defaults `--repo-path` to the current directory and auto-syncs the
+graph incrementally on entry. Pass `--no-sync` to skip the sync, or
+`--no-start-stack` if memgraph/qdrant already run elsewhere.
+
+Useful subcommands:
+
+| Command | Purpose |
+|---|---|
+| `cgr daemon up/down/status/restart/logs` | Manage the shared docker stack |
+| `cgr stop` | Alias for `cgr daemon down` |
+| `cgr status` | Show stack state + per-project last-sync timestamp |
+| `cgr workspace create/list/show/delete` | Manage named bundles of repos |
+| `cgr workspace add-repo / remove-repo` | Edit a workspace's repo set |
+| `cgr start --workspace mono` | Open the agent over every project in the workspace |
+| `cgr start --projects a,b,c` | Scope agent queries to the listed projects |
+
+Indexed data persists across `cgr daemon down` thanks to named memgraph + qdrant
+volumes (`memgraph_data`, `memgraph_log`, `qdrant_storage`).
+
+### Local development install
 
+```bash
+git clone https://github.com/vitali87/code-graph-rag.git
 cd code-graph-rag
 ```
 
@@ -232,9 +292,20 @@ ollama pull llama3.2
 
 4. **Start Memgraph database**:
 ```bash
-docker-compose up -d
+cgr daemon up
+```
+
+5. **Verify installation**:
+```bash
+# If installed from PyPI:
+cgr --help
+
+# If running from source:
+uv run cgr --help
 ```
 
+> **Note**: When running from source (cloned repo), prefix all `cgr` commands below with `uv run`, e.g., `uv run cgr start ...`
+
 ## 🛠️ Makefile Commands
 
 Use the Makefile for common development tasks:
@@ -260,6 +331,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 -->
 
@@ -298,12 +370,23 @@ The system automatically detects and processes files for all supported languages
 
 ### Step 2: Query the Codebase
 
+**Interactive mode:**
+
 Start the interactive RAG CLI:
 
 ```bash
 cgr start --repo-path /path/to/your/repo
 ```
 
+**Non-interactive mode (single query):**
+
+Run a single query and exit, with output sent to stdout (useful for scripting):
+
+```bash
+python -m codebase_rag.main start --repo-path /path/to/your/repo \
+  --ask-agent "What functions call UserService.create_user?"
+```
+
 ### Step 2.5: Real-Time Graph Updates (Optional)
 
 For active development, you can keep your knowledge graph automatically synchronized with code changes using the realtime updater. This is particularly useful when you're actively modifying code and want the AI assistant to always work with the latest codebase structure.
@@ -546,13 +629,16 @@ claude mcp add --transport stdio code-graph-rag \
 | `list_projects` | List all indexed projects in the knowledge graph database. Returns a list of project names that have been indexed. |
 | `delete_project` | Delete a specific project from the knowledge graph database. This removes all nodes associated with the project while preserving other projects. Use list_projects first to see available projects. |
 | `wipe_database` | WARNING: Completely wipe the entire database, removing ALL indexed projects. This cannot be undone. Use delete_project for removing individual projects. |
-| `index_repository` | Parse and ingest the repository into the Memgraph knowledge graph. This builds a comprehensive graph of functions, classes, dependencies, and relationships. Note: This preserves other projects - only the current project is re-indexed. |
-| `query_code_graph` | Query the codebase knowledge graph using natural language. Ask questions like 'What functions call UserService.create_user?' or 'Show me all classes that implement the Repository interface'. |
+| `index_repository` | WARNING: Clears all data for the current project including its embeddings. Parse and ingest the repository into the Memgraph knowledge graph. Use update_repository for incremental updates. Only use when explicitly requested. |
+| `update_repository` | Update the repository in the Memgraph knowledge graph without clearing existing data. Use this for incremental updates. |
+| `query_code_graph` | Query the codebase knowledge graph using natural language. Use semantic_search unless you know the exact names of classes/functions you are searching for. Ask questions like 'What functions call UserService.create_user?' or 'Show me all classes that implement the Repository interface'. |
 | `get_code_snippet` | Retrieve source code for a function, class, or method by its qualified name. Returns the source code, file path, line numbers, and docstring. |
 | `surgical_replace_code` | Surgically replace an exact code block in a file using diff-match-patch. Only modifies the exact target block, leaving the rest unchanged. |
 | `read_file` | Read the contents of a file from the project. Supports pagination for large files. |
 | `write_file` | Write content to a file, creating it if it doesn't exist. |
 | `list_directory` | List contents of a directory in the project. |
+| `semantic_search` | Performs a semantic search for functions based on a natural language query describing their purpose, returning a list of potential matches with similarity scores. Requires the 'semantic' extra to be installed. |
+| `ask_agent` | Ask the Code Graph RAG agent a question about the codebase. Uses the full RAG pipeline to analyze the code graph and provide a detailed answer. Use this for general questions about architecture, functionality, and code relationships. |
 <!-- /SECTION:mcp_tools -->
 
 ### Example Usage
@@ -575,36 +661,36 @@ The knowledge graph uses the following node types and relationships:
 | Label | Properties |
 |-----|----------|
 | Project | `{name: string}` |
-| Package | `{qualified_name: string, name: string, path: string}` |
-| Folder | `{path: string, name: string}` |
-| File | `{path: string, name: string, extension: string}` |
-| Module | `{qualified_name: string, name: string, path: string}` |
-| Class | `{qualified_name: string, name: string, decorators: list[string]}` |
-| Function | `{qualified_name: string, name: string, decorators: list[string]}` |
-| Method | `{qualified_name: string, name: string, decorators: list[string]}` |
-| Interface | `{qualified_name: string, name: string}` |
-| Enum | `{qualified_name: string, name: string}` |
+| Package | `{qualified_name: string, name: string, path: string, absolute_path: string}` |
+| Folder | `{path: string, name: string, absolute_path: string}` |
+| File | `{path: string, name: string, extension: string, absolute_path: string}` |
+| Module | `{qualified_name: string, name: string, path: string, absolute_path: string}` |
+| Class | `{qualified_name: string, name: string, decorators: list[string], path: string, absolute_path: string}` |
+| Function | `{qualified_name: string, name: string, decorators: list[string], path: string, absolute_path: string}` |
+| Method | `{qualified_name: string, name: string, decorators: list[string], path: string, absolute_path: string}` |
+| Interface | `{qualified_name: string, name: string, path: string, absolute_path: string}` |
+| Enum | `{qualified_name: string, name: string, path: string, absolute_path: string}` |
 | Type | `{qualified_name: string, name: string}` |
 | Union | `{qualified_name: string, name: string}` |
-| ModuleInterface | `{qualified_name: string, name: string, path: string}` |
-| ModuleImplementation | `{qualified_name: string, name: string, path: string, implements_module: string}` |
+| 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
 
 <!-- SECTION:language_mappings -->
-- **C**: `function_definition`, `struct_specifier`, `union_specifier`, `enum_specifier`, `call_expression`, `preproc_include`
+- **C**: `enum_specifier`, `function_definition`, `struct_specifier`, `union_specifier`
 - **C++**: `class_specifier`, `declaration`, `enum_specifier`, `field_declaration`, `function_definition`, `lambda_expression`, `struct_specifier`, `template_declaration`, `union_specifier`
 - **Java**: `annotation_type_declaration`, `class_declaration`, `constructor_declaration`, `enum_declaration`, `interface_declaration`, `method_declaration`, `record_declaration`
 - **JavaScript**: `arrow_function`, `class`, `class_declaration`, `function_declaration`, `function_expression`, `generator_function_declaration`, `method_definition`
 - **Lua**: `function_declaration`, `function_definition`
+- **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**: `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`
-- **C#**: `anonymous_method_expression`, `class_declaration`, `constructor_declaration`, `destructor_declaration`, `enum_declaration`, `function_pointer_type`, `interface_declaration`, `lambda_expression`, `local_function_statement`, `method_declaration`, `struct_declaration`
-- **Go**: `function_declaration`, `method_declaration`, `type_declaration`
-- **PHP**: `anonymous_function`, `arrow_function`, `class_declaration`, `enum_declaration`, `function_definition`, `function_static_declaration`, `interface_declaration`, `trait_declaration`
+- **Go**: `function_declaration`, `method_declaration`, `type_alias`, `type_spec`
 - **Scala**: `class_definition`, `function_declaration`, `function_definition`, `object_definition`, `trait_definition`
 <!-- /SECTION:language_mappings -->
 
@@ -619,7 +705,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 |
@@ -629,6 +715,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 |
+| Module, Function, Method | INSTANTIATES | Class |
 <!-- /SECTION:relationship_schemas -->
 
 ## 🔧 Configuration
@@ -670,30 +758,32 @@ 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
+- **tiktoken**: tiktoken is a fast BPE tokeniser for use with OpenAI's models
 - **toml**: Python Library for Tom's Obvious, Minimal Language
 - **tree-sitter-python**: Python grammar for tree-sitter
 - **tree-sitter**: Python bindings to the Tree-sitter parsing library
@@ -706,6 +796,8 @@ my_build_output
 - **protobuf**
 - **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
@@ -720,11 +812,10 @@ The agent has access to a suite of tools to understand and interact with the cod
 | Tool | Description |
 |----|-----------|
 | `query_graph` | Query the codebase knowledge graph using natural language questions. Ask in plain English about classes, functions, methods, dependencies, or code structure. Examples: 'Find all functions that call each other', 'What classes are in the user module', 'Show me functions with the longest call chains'. |
-| `read_file` | Reads the content of text-based files. For documents like PDFs or images, use the 'analyze_document' tool instead. |
+| `read_file` | Reads the content of text-based files. Images and PDFs the user references are attached inline; read them directly. |
 | `create_file` | Creates a new file with content. IMPORTANT: Check file existence first! Overwrites completely WITHOUT showing diff. Use only for new files, not existing file modifications. |
 | `replace_code` | Surgically replaces specific code blocks in files. Requires exact target code and replacement. Only modifies the specified block, leaving rest of file unchanged. True surgical patching. |
 | `list_directory` | Lists the contents of a directory to explore the codebase. |
-| `analyze_document` | Analyzes documents (PDFs, images) to answer questions about their content. |
 | `execute_shell` | Executes shell commands from allowlist. Read-only commands run without approval; write operations require user confirmation. |
 | `semantic_search` | Performs a semantic search for functions based on a natural language query describing their purpose, returning a list of potential matches with similarity scores. |
 | `get_function_source` | Retrieves the source code for a specific function or method using its internal node ID, typically obtained from a semantic search result. |
@@ -902,3 +993,7 @@ We also offer custom development, integration consulting, technical support cont
 ## Star History
 
 [![Star History Chart](https://api.star-history.com/svg?repos=vitali87/code-graph-rag&type=Date)](https://www.star-history.com/#vitali87/code-graph-rag&Date)
+
+## Fork History
+
+[![Fork History Chart](https://fork-history.site/svg?repos=vitali87/code-graph-rag)](https://fork-history.site/#vitali87/code-graph-rag)

{code_graph_rag-0.0.148 → code_graph_rag-0.0.209/code_graph_rag.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-graph-rag
-Version: 0.0.148
+Version: 0.0.209
 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
@@ -14,34 +14,38 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: loguru>=0.7.3
-Requires-Dist: mcp>=1.21.1
-Requires-Dist: pydantic-ai>=1.70.0
-Requires-Dist: pydantic-settings>=2.0.0
-Requires-Dist: pymgclient>=1.4.0
-Requires-Dist: python-dotenv>=1.1.0
+Requires-Dist: mcp>=1.25.0
+Requires-Dist: pydantic-ai>=1.102.0
+Requires-Dist: pydantic-settings>=2.12.0
+Requires-Dist: pymgclient>=1.5.1
+Requires-Dist: python-dotenv>=1.2.1
 Requires-Dist: tiktoken>=0.12.0
 Requires-Dist: toml>=0.10.2
-Requires-Dist: tree-sitter-python>=0.23.6
+Requires-Dist: tree-sitter-python>=0.25.0
 Requires-Dist: tree-sitter==0.25.2
 Requires-Dist: watchdog>=6.0.0
-Requires-Dist: typer>=0.12.5
-Requires-Dist: rich>=13.7.1
-Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: typer>=0.21.1
+Requires-Dist: rich>=14.2.0
+Requires-Dist: prompt-toolkit>=3.0.52
 Requires-Dist: diff-match-patch>=20241021
-Requires-Dist: click>=8.0.0
-Requires-Dist: protobuf>=5.27.0
+Requires-Dist: click>=8.3.1
+Requires-Dist: protobuf>=6.33.5
 Requires-Dist: defusedxml>=0.7.1
-Requires-Dist: huggingface-hub[hf-xet]>=0.36.0
+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"
 Requires-Dist: pytest-cov>=4.0.0; extra == "test"
 Requires-Dist: pytest-xdist>=3.8.0; extra == "test"
 Requires-Dist: testcontainers>=4.9.0; extra == "test"
+Requires-Dist: libclang>=18.1.1; extra == "test"
 Provides-Extra: treesitter-full
 Requires-Dist: tree-sitter-python>=0.23.6; extra == "treesitter-full"
 Requires-Dist: tree-sitter-javascript>=0.23.1; extra == "treesitter-full"
@@ -53,6 +57,7 @@ Requires-Dist: tree-sitter-java>=0.23.5; extra == "treesitter-full"
 Requires-Dist: tree-sitter-c>=0.24.1; extra == "treesitter-full"
 Requires-Dist: tree-sitter-cpp>=0.23.0; extra == "treesitter-full"
 Requires-Dist: tree-sitter-lua>=0.0.19; extra == "treesitter-full"
+Requires-Dist: tree-sitter-php>=0.24.1; extra == "treesitter-full"
 Provides-Extra: semantic
 Requires-Dist: qdrant-client>=1.9.0; extra == "semantic"
 Requires-Dist: torch>=2.6.0; extra == "semantic"
@@ -95,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.148 → code_graph_rag-0.0.209}/code_graph_rag.egg-info/SOURCES.txt

@@ -10,12 +10,14 @@ code_graph_rag.egg-info/entry_points.txt
 code_graph_rag.egg-info/requires.txt
 code_graph_rag.egg-info/top_level.txt
 codebase_rag/__init__.py
+codebase_rag/cgr_state.py
 codebase_rag/cli.py
 codebase_rag/cli_help.py
 codebase_rag/config.py
 codebase_rag/constants.py
 codebase_rag/cypher_queries.py
 codebase_rag/decorators.py
+codebase_rag/docker-compose.yaml
 codebase_rag/embedder.py
 codebase_rag/exceptions.py
 codebase_rag/graph_loader.py
@@ -34,6 +36,7 @@ codebase_rag/types_defs.py
 codebase_rag/unixcoder.py
 codebase_rag/vector_store.py
 codebase_rag/mcp/__init__.py
+codebase_rag/mcp/client.py
 codebase_rag/mcp/server.py
 codebase_rag/mcp/tools.py
 codebase_rag/parsers/__init__.py
@@ -41,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
@@ -58,13 +63,22 @@ 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/type_inference.py
+codebase_rag/parsers/go/utils.py
 codebase_rag/parsers/handlers/__init__.py
 codebase_rag/parsers/handlers/base.py
 codebase_rag/parsers/handlers/cpp.py
 codebase_rag/parsers/handlers/java.py
 codebase_rag/parsers/handlers/js_ts.py
 codebase_rag/parsers/handlers/lua.py
+codebase_rag/parsers/handlers/php.py
 codebase_rag/parsers/handlers/protocol.py
 codebase_rag/parsers/handlers/python.py
 codebase_rag/parsers/handlers/registry.py
@@ -93,15 +107,21 @@ codebase_rag/parsers/rs/__init__.py
 codebase_rag/parsers/rs/utils.py
 codebase_rag/providers/__init__.py
 codebase_rag/providers/base.py
+codebase_rag/providers/litellm.py
 codebase_rag/services/__init__.py
+codebase_rag/services/anthropic_token_counter.py
 codebase_rag/services/graph_service.py
 codebase_rag/services/llm.py
 codebase_rag/services/protobuf_service.py
+codebase_rag/stack/__init__.py
+codebase_rag/stack/cli.py
+codebase_rag/stack/constants.py
+codebase_rag/stack/health.py
+codebase_rag/stack/manager.py
 codebase_rag/tools/__init__.py
 codebase_rag/tools/code_retrieval.py
 codebase_rag/tools/codebase_query.py
 codebase_rag/tools/directory_lister.py
-codebase_rag/tools/document_analyzer.py
 codebase_rag/tools/file_editor.py
 codebase_rag/tools/file_reader.py
 codebase_rag/tools/file_writer.py
@@ -114,8 +134,14 @@ codebase_rag/utils/__init__.py
 codebase_rag/utils/dependencies.py
 codebase_rag/utils/fqn_resolver.py
 codebase_rag/utils/path_utils.py
+codebase_rag/utils/rich_markdown.py
 codebase_rag/utils/source_extraction.py
 codebase_rag/utils/token_utils.py
+codebase_rag/workspaces/__init__.py
+codebase_rag/workspaces/cli.py
+codebase_rag/workspaces/constants.py
+codebase_rag/workspaces/models.py
+codebase_rag/workspaces/storage.py
 codec/__init__.py
 codec/schema_pb2.py
 codec/schema_pb2.pyi