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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-graph-rag
-Version: 0.0.148
+Version: 0.0.187
 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,37 @@ 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
 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 +56,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"

{code_graph_rag-0.0.148 → code_graph_rag-0.0.187}/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 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).
   <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. Restore if the project is mirrored back to GitHub or scorecard.dev adds Codeberg support.
   <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
+# 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
-git clone https://github.com/vitali87/code-graph-rag.git
+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://codeberg.org/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
+docker compose up -d
 ```
 
+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:
@@ -298,12 +369,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 +628,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 +660,35 @@ 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}` |
 <!-- /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 -->
 
@@ -694,6 +778,7 @@ my_build_output
 - **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 +791,7 @@ 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.
 <!-- /SECTION:dependencies -->
 
 ## 🤖 Agentic Workflow & Tools
@@ -720,11 +806,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. |
@@ -750,7 +835,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://github.com/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://codeberg.org/vitali87/code-graph-rag/issues) with your language request.
 
 #### Quick Start: Add a Language
 
@@ -902,3 +987,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.187/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.187
 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,37 @@ 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
 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 +56,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"

{code_graph_rag-0.0.148 → code_graph_rag-0.0.187}/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
@@ -59,12 +62,19 @@ codebase_rag/parsers/class_ingest/relationships.py
 codebase_rag/parsers/class_ingest/utils.py
 codebase_rag/parsers/cpp/__init__.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/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 +103,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 +130,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

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

@@ -1,22 +1,23 @@
 loguru>=0.7.3
-mcp>=1.21.1
-pydantic-ai>=1.70.0
-pydantic-settings>=2.0.0
-pymgclient>=1.4.0
-python-dotenv>=1.1.0
+mcp>=1.25.0
+pydantic-ai>=1.102.0
+pydantic-settings>=2.12.0
+pymgclient>=1.5.1
+python-dotenv>=1.2.1
 tiktoken>=0.12.0
 toml>=0.10.2
-tree-sitter-python>=0.23.6
+tree-sitter-python>=0.25.0
 tree-sitter==0.25.2
 watchdog>=6.0.0
-typer>=0.12.5
-rich>=13.7.1
-prompt-toolkit>=3.0.0
+typer>=0.21.1
+rich>=14.2.0
+prompt-toolkit>=3.0.52
 diff-match-patch>=20241021
-click>=8.0.0
-protobuf>=5.27.0
+click>=8.3.1
+protobuf>=6.33.5
 defusedxml>=0.7.1
-huggingface-hub[hf-xet]>=0.36.0
+huggingface-hub[hf-xet]>=1.7.2
+griffe<2,>=1.0
 
 [semantic]
 qdrant-client>=1.9.0
@@ -29,6 +30,7 @@ pytest-asyncio>=1.0.0
 pytest-cov>=4.0.0
 pytest-xdist>=3.8.0
 testcontainers>=4.9.0
+libclang>=18.1.1
 
 [treesitter-full]
 tree-sitter-python>=0.23.6
@@ -41,3 +43,4 @@ tree-sitter-java>=0.23.5
 tree-sitter-c>=0.24.1
 tree-sitter-cpp>=0.23.0
 tree-sitter-lua>=0.0.19
+tree-sitter-php>=0.24.1

code_graph_rag-0.0.187/codebase_rag/cgr_state.py

@@ -0,0 +1,57 @@
+from __future__ import annotations
+
+import json
+from datetime import UTC, datetime
+from pathlib import Path
+from typing import TypedDict
+
+from loguru import logger
+
+from .config import settings
+
+STATE_FILENAME = "state.json"
+
+
+class _StateShape(TypedDict, total=False):
+    last_sync: dict[str, str]
+
+
+def state_path(home: Path | None = None) -> Path:
+    base = (home or settings.CGR_HOME).expanduser()
+    return base / STATE_FILENAME
+
+
+def _load(path: Path) -> _StateShape:
+    if not path.exists():
+        return _StateShape()
+    try:
+        with path.open(encoding="utf-8") as f:
+            data = json.load(f)
+        if isinstance(data, dict):
+            return _StateShape(last_sync=data.get("last_sync", {}))
+    except (OSError, json.JSONDecodeError) as e:
+        logger.warning(f"Failed to load cgr state from {path}: {e}")
+    return _StateShape()
+
+
+def _save(path: Path, data: _StateShape) -> None:
+    try:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        with path.open("w", encoding="utf-8") as f:
+            json.dump(data, f, indent=2)
+    except OSError as e:
+        logger.warning(f"Failed to save cgr state to {path}: {e}")
+
+
+def record_sync(project_name: str, home: Path | None = None) -> None:
+    path = state_path(home)
+    state = _load(path)
+    last_sync = state.get("last_sync", {})
+    last_sync[project_name] = datetime.now(UTC).isoformat()
+    state["last_sync"] = last_sync
+    _save(path, state)
+
+
+def read_sync_timestamps(home: Path | None = None) -> dict[str, str]:
+    state = _load(state_path(home))
+    return dict(state.get("last_sync", {}))