codexa 0.4.2__tar.gz → 0.5.0__tar.gz

{codexa-0.4.2/codexa.egg-info → codexa-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codexa
-Version: 0.4.2
+Version: 0.5.0
 Summary: Developer intelligence CLI — semantic code search, AI-assisted understanding, and agent tooling for codebases
 License: MIT
 Project-URL: Homepage, https://codex-a.dev
@@ -30,6 +30,16 @@ Requires-Dist: pydantic>=2.0.0
 Requires-Dist: rich>=13.0.0
 Requires-Dist: numpy>=1.24.0
 Requires-Dist: tree-sitter>=0.21.0
+Requires-Dist: tree-sitter-python>=0.21.0
+Requires-Dist: tree-sitter-javascript>=0.21.0
+Requires-Dist: tree-sitter-typescript>=0.21.0
+Requires-Dist: tree-sitter-java>=0.21.0
+Requires-Dist: tree-sitter-go>=0.21.0
+Requires-Dist: tree-sitter-rust>=0.21.0
+Requires-Dist: tree-sitter-cpp>=0.21.0
+Requires-Dist: tree-sitter-c-sharp>=0.21.0
+Requires-Dist: tree-sitter-ruby>=0.21.0
+Requires-Dist: tree-sitter-php>=0.22.0
 Requires-Dist: radon>=6.0.0
 Requires-Dist: bandit>=1.7.0
 Requires-Dist: mcp>=1.0.0
@@ -55,9 +65,11 @@ Dynamic: license-file
 
 <p align="center">
   <a href="https://github.com/M9nx/CodexA/actions"><img src="https://github.com/M9nx/CodexA/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/codexa/"><img src="https://img.shields.io/pypi/v/codexa?color=blue&label=PyPI" alt="PyPI"></a>
+  <a href="https://pepy.tech/project/codexa"><img src="https://img.shields.io/pepy/dt/codexa?color=blue&label=Downloads" alt="Downloads"></a>
   <img src="https://img.shields.io/badge/python-3.11%2B-blue" alt="Python 3.11+">
-  <img src="https://img.shields.io/badge/version-0.4.0-green" alt="Version">
-  <img src="https://img.shields.io/badge/tests-2595-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/version-0.5.0-green" alt="Version">
+  <img src="https://img.shields.io/badge/tests-2657-brightgreen" alt="Tests">
   <img src="https://img.shields.io/badge/coverage-79%25-brightgreen" alt="Coverage">
   <img src="https://img.shields.io/badge/mypy-strict-blue" alt="mypy strict">
   <img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
@@ -74,17 +86,22 @@ structured tool protocol that any AI agent can call over HTTP or CLI.
 
 | Area | What you get |
 |------|-------------|
-| **Code Indexing** | Scan repos, extract functions/classes, generate vector embeddings (sentence-transformers + FAISS), ONNX runtime option, parallel indexing, `--watch` live re-indexing, `.codexaignore` support |
-| **Multi-Mode Search** | Semantic, keyword (BM25), regex, hybrid (RRF), and raw filesystem grep (ripgrep backend) with full `-A/-B/-C/-w/-v/-c` flags |
+| **Code Indexing** | Scan repos, extract functions/classes, generate vector embeddings (sentence-transformers + FAISS), ONNX runtime option, parallel indexing, `--watch` live re-indexing, `.codexaignore` support, `--add`/`--inspect` per-file control, model-consistency guard, Ctrl+C partial-save |
+| **Rust Search Engine** | Native `codexa-core` Rust crate via PyO3 — HNSW approximate nearest-neighbour search, BM25 keyword index, tree-sitter AST chunker (10 languages), memory-mapped vector persistence, parallel file scanner, optional ONNX embedding inference, optional Tantivy full-text search |
+| **Multi-Mode Search** | Semantic, keyword (BM25), regex, hybrid (RRF), and raw filesystem grep (ripgrep backend) with full `-A/-B/-C/-w/-v/-c/-l/-L/--exclude/--no-ignore` flags, `--hybrid`/`--sem` shorthands, `--scores`, `--snippet-length`, `--no-snippet`, JSONL streaming |
+| **RAG Pipeline** | 4-stage Retrieval-Augmented Generation — Retrieve → Deduplicate → Re-rank → Assemble with token budget, cross-encoder re-ranking, source citations |
 | **Code Context** | Rich context windows — imports, dependencies, AST-based call graphs, surrounding code |
 | **Repository Analysis** | Language breakdown (`codexa languages`), module summaries, component detection |
-| **AI Agent Protocol** | 13 built-in tools exposed via HTTP bridge, MCP server (13 tools), MCP-over-SSE (`--mcp`), or CLI for any AI agent to invoke |
+| **AI Agent Protocol** | 13 built-in tools exposed via HTTP bridge, MCP server (13 tools with pagination/cursors), MCP-over-SSE (`--mcp`), `codexa --serve` shorthand, Claude Desktop auto-config (`--claude-config`), or CLI for any AI agent to invoke |
 | **Quality & Metrics** | Complexity analysis, maintainability scoring, quality gates for CI |
 | **Multi-Repo Workspaces** | Link multiple repos under one workspace for cross-repo search & refactoring |
 | **Interactive TUI** | Terminal REPL with mode switching for interactive exploration |
 | **Streaming Responses** | Token-by-token streaming for chat and investigation commands |
 | **Plugin System** | 22 hooks for extending every layer — from indexing to tool invocation |
 | **VS Code Extension** | 4-panel sidebar (Search, Symbols, Quality, Tools), 8 commands, CodeLens, context menus, status bar |
+| **Editor Plugins** | Zed, JetBrains (IntelliJ/PyCharm), Neovim (telescope.nvim), Vim, Sublime Text, Emacs, Helix, Eclipse -- all sharing the same MCP/bridge protocol |
+| **Cross-Language Intelligence** | FFI pattern detection, polyglot dependency graphs, language-aware search boosting, universal multi-language call graph |
+| **Multi-Agent Sessions** | Concurrent AI agent sessions with shared discovery, semantic diff (rename/move/signature/body detection), RAG code generation |
 
 ---
 
@@ -96,6 +113,12 @@ structured tool protocol that any AI agent can call over HTTP or CLI.
 pip install codexa
 ```
 
+For semantic indexing and vector search, install the ML extras:
+
+```bash
+pip install "codexa[ml]"
+```
+
 Or install from source:
 
 ```bash
@@ -124,6 +147,15 @@ cd /path/to/your-project
 codexa init
 ```
 
+CodexA auto-detects your available RAM and picks the best embedding model.
+Or choose a model profile explicitly:
+
+```bash
+codexa init --profile fast       # mxbai-embed-xsmall — low RAM (<1 GB)
+codexa init --profile balanced   # MiniLM — good balance (~2 GB)
+codexa init --profile precise    # jina-code — best quality (~4 GB)
+```
+
 This creates a `.codexa/` directory with configuration, index storage, and session data.
 
 ### 3. Index the Codebase
@@ -134,6 +166,23 @@ codexa index .
 
 This parses all source files (Python, JS/TS, Java, Go, Rust, C#, Ruby, C++),
 extracts symbols, generates embeddings, and stores them in a local FAISS index.
+Semantic indexing requires `codexa[ml]`.
+
+If you need to keep secrets, generated files, or local config files out of the
+index, add patterns to `.codexaignore` at the project root or configure
+`index.exclude_files` in `.codexa/config.json`.
+
+Typical `.codexaignore` example:
+
+```text
+.env*
+secrets/*.json
+config/local-*.yml
+vendor/*
+```
+
+The default embedding model is small, but the PyTorch backend still needs about
+2 GB of available RAM. On lower-memory machines, prefer the ONNX backend.
 
 ### 4. Semantic Search
 
@@ -251,7 +300,7 @@ cd CodexA
 pip install -e ".[dev]"
 
 # Verify
-codexa --version    # → codexa, version 0.4.0
+codexa --version    # → codexa, version 0.5.0
 ```
 
 ### Step 2 — Initialize your target project
@@ -493,7 +542,7 @@ CodexA provides **39 commands** (plus subcommands) organized by capability:
 | `codexa plugin list\|scaffold\|discover` | Plugin management |
 | `codexa tui` | Interactive terminal REPL |
 | `codexa mcp` | Start MCP (Model Context Protocol) server |
-| `codexa models list\|info\|download\|switch` | Manage embedding models |
+| `codexa models list\|info\|download\|switch\|profiles\|benchmark` | Manage and benchmark embedding models |
 
 ### VS Code Extension
 
@@ -550,8 +599,13 @@ Additional tools can be registered via the plugin system using the
 │  /tools/invoke · /tools/list · /request · SSE stream │
 ├──────────────┬──────────────┬───────────────────────┤
 │ Parsing      │ Embedding    │ Search                │
-│ tree-sitter  │ sent-trans   │ FAISS                 │
+│ tree-sitter  │ sent-trans   │ FAISS / Rust HNSW     │
 ├──────────────┼──────────────┴───────────────────────┤
+│ Rust Engine  │  codexa-core (PyO3)                   │
+│ (optional)   │  HNSW · BM25 · AST chunk · mmap · RRF│
+├──────────────┼──────────────────────────────────────┤
+│ RAG Pipeline │  Retrieve → Dedup → Re-rank → Assemble│
+├──────────────┼──────────────────────────────────────┤
 │ Evolution    │  Self-improving dev loop              │
 │ engine       │  budget · task · patch · test · commit│
 ├──────────────┴──────────────────────────────────────┤
@@ -592,6 +646,9 @@ After `codexa init`, your project has `.codexa/config.json`:
 }
 ```
 
+> **Tip:** Instead of editing `model_name` manually, use `codexa init --profile fast|balanced|precise`
+> or run `codexa models profiles` to see recommended models for your hardware.
+
 ---
 
 ## Documentation
@@ -622,7 +679,7 @@ Browse the docs at **http://localhost:5173** after running `npm run docs:dev`.
 # Install dev dependencies
 pip install -e ".[dev]"
 
-# Run all 2595 tests
+# Run all 2657 tests
 pytest
 
 # Run with coverage (gate: 70% minimum)
@@ -641,10 +698,11 @@ codexa --verbose search "query"
 ## Tech Stack
 
 - **Python 3.11+** — No heavy frameworks, stdlib-first design
+- **Rust (codexa-core)** — Native search engine via PyO3 — HNSW (instant-distance), BM25, tree-sitter AST chunking, mmap persistence, parallel scanning (rayon)
 - **click** — CLI framework
 - **sentence-transformers** — Embedding generation (`all-MiniLM-L6-v2`)
-- **faiss-cpu** — Vector similarity search (O(1) file-level index, batch reconstruction)
-- **tree-sitter** — Multi-language code parsing
+- **faiss-cpu** — Vector similarity search (with Rust HNSW acceleration)
+- **tree-sitter** — Multi-language code parsing (Python + Rust)
 - **watchfiles** — Rust-backed native file watching (inotify/FSEvents/ReadDirectoryChanges)
 - **pydantic** — Configuration & data models
 - **rich** — Terminal UI and formatting

codexa-0.4.2/PKG-INFO → codexa-0.5.0/README.md

@@ -1,53 +1,3 @@
-Metadata-Version: 2.4
-Name: codexa
-Version: 0.4.2
-Summary: Developer intelligence CLI — semantic code search, AI-assisted understanding, and agent tooling for codebases
-License: MIT
-Project-URL: Homepage, https://codex-a.dev
-Project-URL: Documentation, https://codex-a.dev
-Project-URL: Repository, https://github.com/M9nx/CodexA
-Project-URL: Issues, https://github.com/M9nx/CodexA/issues
-Project-URL: Changelog, https://github.com/M9nx/CodexA/blob/main/CHANGELOG.md
-Keywords: code-search,semantic-search,developer-tools,code-intelligence,ai-assistant,cli,tree-sitter,faiss,embeddings,mcp
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Topic :: Software Development :: Libraries
-Classifier: Topic :: Software Development :: Quality Assurance
-Classifier: Topic :: Text Processing :: Indexing
-Classifier: Typing :: Typed
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: click>=8.1.0
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: numpy>=1.24.0
-Requires-Dist: tree-sitter>=0.21.0
-Requires-Dist: radon>=6.0.0
-Requires-Dist: bandit>=1.7.0
-Requires-Dist: mcp>=1.0.0
-Requires-Dist: watchfiles>=1.0.0
-Provides-Extra: ml
-Requires-Dist: sentence-transformers>=2.2.0; extra == "ml"
-Requires-Dist: faiss-cpu>=1.7.4; extra == "ml"
-Provides-Extra: dev
-Requires-Dist: pytest>=7.4.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: sentence-transformers>=2.2.0; extra == "dev"
-Requires-Dist: faiss-cpu>=1.7.4; extra == "dev"
-Provides-Extra: tui
-Requires-Dist: textual>=0.40.0; extra == "tui"
-Provides-Extra: build
-Requires-Dist: pyinstaller>=6.0.0; extra == "build"
-Dynamic: license-file
-
 <p align="center">
   <strong>CodexA — Developer Intelligence Engine</strong><br>
   <em>Semantic code search · AI-assisted understanding · Agent tooling protocol</em>
@@ -55,9 +5,11 @@ Dynamic: license-file
 
 <p align="center">
   <a href="https://github.com/M9nx/CodexA/actions"><img src="https://github.com/M9nx/CodexA/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/codexa/"><img src="https://img.shields.io/pypi/v/codexa?color=blue&label=PyPI" alt="PyPI"></a>
+  <a href="https://pepy.tech/project/codexa"><img src="https://img.shields.io/pepy/dt/codexa?color=blue&label=Downloads" alt="Downloads"></a>
   <img src="https://img.shields.io/badge/python-3.11%2B-blue" alt="Python 3.11+">
-  <img src="https://img.shields.io/badge/version-0.4.0-green" alt="Version">
-  <img src="https://img.shields.io/badge/tests-2595-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/version-0.5.0-green" alt="Version">
+  <img src="https://img.shields.io/badge/tests-2657-brightgreen" alt="Tests">
   <img src="https://img.shields.io/badge/coverage-79%25-brightgreen" alt="Coverage">
   <img src="https://img.shields.io/badge/mypy-strict-blue" alt="mypy strict">
   <img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
@@ -74,17 +26,22 @@ structured tool protocol that any AI agent can call over HTTP or CLI.
 
 | Area | What you get |
 |------|-------------|
-| **Code Indexing** | Scan repos, extract functions/classes, generate vector embeddings (sentence-transformers + FAISS), ONNX runtime option, parallel indexing, `--watch` live re-indexing, `.codexaignore` support |
-| **Multi-Mode Search** | Semantic, keyword (BM25), regex, hybrid (RRF), and raw filesystem grep (ripgrep backend) with full `-A/-B/-C/-w/-v/-c` flags |
+| **Code Indexing** | Scan repos, extract functions/classes, generate vector embeddings (sentence-transformers + FAISS), ONNX runtime option, parallel indexing, `--watch` live re-indexing, `.codexaignore` support, `--add`/`--inspect` per-file control, model-consistency guard, Ctrl+C partial-save |
+| **Rust Search Engine** | Native `codexa-core` Rust crate via PyO3 — HNSW approximate nearest-neighbour search, BM25 keyword index, tree-sitter AST chunker (10 languages), memory-mapped vector persistence, parallel file scanner, optional ONNX embedding inference, optional Tantivy full-text search |
+| **Multi-Mode Search** | Semantic, keyword (BM25), regex, hybrid (RRF), and raw filesystem grep (ripgrep backend) with full `-A/-B/-C/-w/-v/-c/-l/-L/--exclude/--no-ignore` flags, `--hybrid`/`--sem` shorthands, `--scores`, `--snippet-length`, `--no-snippet`, JSONL streaming |
+| **RAG Pipeline** | 4-stage Retrieval-Augmented Generation — Retrieve → Deduplicate → Re-rank → Assemble with token budget, cross-encoder re-ranking, source citations |
 | **Code Context** | Rich context windows — imports, dependencies, AST-based call graphs, surrounding code |
 | **Repository Analysis** | Language breakdown (`codexa languages`), module summaries, component detection |
-| **AI Agent Protocol** | 13 built-in tools exposed via HTTP bridge, MCP server (13 tools), MCP-over-SSE (`--mcp`), or CLI for any AI agent to invoke |
+| **AI Agent Protocol** | 13 built-in tools exposed via HTTP bridge, MCP server (13 tools with pagination/cursors), MCP-over-SSE (`--mcp`), `codexa --serve` shorthand, Claude Desktop auto-config (`--claude-config`), or CLI for any AI agent to invoke |
 | **Quality & Metrics** | Complexity analysis, maintainability scoring, quality gates for CI |
 | **Multi-Repo Workspaces** | Link multiple repos under one workspace for cross-repo search & refactoring |
 | **Interactive TUI** | Terminal REPL with mode switching for interactive exploration |
 | **Streaming Responses** | Token-by-token streaming for chat and investigation commands |
 | **Plugin System** | 22 hooks for extending every layer — from indexing to tool invocation |
 | **VS Code Extension** | 4-panel sidebar (Search, Symbols, Quality, Tools), 8 commands, CodeLens, context menus, status bar |
+| **Editor Plugins** | Zed, JetBrains (IntelliJ/PyCharm), Neovim (telescope.nvim), Vim, Sublime Text, Emacs, Helix, Eclipse -- all sharing the same MCP/bridge protocol |
+| **Cross-Language Intelligence** | FFI pattern detection, polyglot dependency graphs, language-aware search boosting, universal multi-language call graph |
+| **Multi-Agent Sessions** | Concurrent AI agent sessions with shared discovery, semantic diff (rename/move/signature/body detection), RAG code generation |
 
 ---
 
@@ -96,6 +53,12 @@ structured tool protocol that any AI agent can call over HTTP or CLI.
 pip install codexa
 ```
 
+For semantic indexing and vector search, install the ML extras:
+
+```bash
+pip install "codexa[ml]"
+```
+
 Or install from source:
 
 ```bash
@@ -124,6 +87,15 @@ cd /path/to/your-project
 codexa init
 ```
 
+CodexA auto-detects your available RAM and picks the best embedding model.
+Or choose a model profile explicitly:
+
+```bash
+codexa init --profile fast       # mxbai-embed-xsmall — low RAM (<1 GB)
+codexa init --profile balanced   # MiniLM — good balance (~2 GB)
+codexa init --profile precise    # jina-code — best quality (~4 GB)
+```
+
 This creates a `.codexa/` directory with configuration, index storage, and session data.
 
 ### 3. Index the Codebase
@@ -134,6 +106,23 @@ codexa index .
 
 This parses all source files (Python, JS/TS, Java, Go, Rust, C#, Ruby, C++),
 extracts symbols, generates embeddings, and stores them in a local FAISS index.
+Semantic indexing requires `codexa[ml]`.
+
+If you need to keep secrets, generated files, or local config files out of the
+index, add patterns to `.codexaignore` at the project root or configure
+`index.exclude_files` in `.codexa/config.json`.
+
+Typical `.codexaignore` example:
+
+```text
+.env*
+secrets/*.json
+config/local-*.yml
+vendor/*
+```
+
+The default embedding model is small, but the PyTorch backend still needs about
+2 GB of available RAM. On lower-memory machines, prefer the ONNX backend.
 
 ### 4. Semantic Search
 
@@ -251,7 +240,7 @@ cd CodexA
 pip install -e ".[dev]"
 
 # Verify
-codexa --version    # → codexa, version 0.4.0
+codexa --version    # → codexa, version 0.5.0
 ```
 
 ### Step 2 — Initialize your target project
@@ -493,7 +482,7 @@ CodexA provides **39 commands** (plus subcommands) organized by capability:
 | `codexa plugin list\|scaffold\|discover` | Plugin management |
 | `codexa tui` | Interactive terminal REPL |
 | `codexa mcp` | Start MCP (Model Context Protocol) server |
-| `codexa models list\|info\|download\|switch` | Manage embedding models |
+| `codexa models list\|info\|download\|switch\|profiles\|benchmark` | Manage and benchmark embedding models |
 
 ### VS Code Extension
 
@@ -550,8 +539,13 @@ Additional tools can be registered via the plugin system using the
 │  /tools/invoke · /tools/list · /request · SSE stream │
 ├──────────────┬──────────────┬───────────────────────┤
 │ Parsing      │ Embedding    │ Search                │
-│ tree-sitter  │ sent-trans   │ FAISS                 │
+│ tree-sitter  │ sent-trans   │ FAISS / Rust HNSW     │
 ├──────────────┼──────────────┴───────────────────────┤
+│ Rust Engine  │  codexa-core (PyO3)                   │
+│ (optional)   │  HNSW · BM25 · AST chunk · mmap · RRF│
+├──────────────┼──────────────────────────────────────┤
+│ RAG Pipeline │  Retrieve → Dedup → Re-rank → Assemble│
+├──────────────┼──────────────────────────────────────┤
 │ Evolution    │  Self-improving dev loop              │
 │ engine       │  budget · task · patch · test · commit│
 ├──────────────┴──────────────────────────────────────┤
@@ -592,6 +586,9 @@ After `codexa init`, your project has `.codexa/config.json`:
 }
 ```
 
+> **Tip:** Instead of editing `model_name` manually, use `codexa init --profile fast|balanced|precise`
+> or run `codexa models profiles` to see recommended models for your hardware.
+
 ---
 
 ## Documentation
@@ -622,7 +619,7 @@ Browse the docs at **http://localhost:5173** after running `npm run docs:dev`.
 # Install dev dependencies
 pip install -e ".[dev]"
 
-# Run all 2595 tests
+# Run all 2657 tests
 pytest
 
 # Run with coverage (gate: 70% minimum)
@@ -641,10 +638,11 @@ codexa --verbose search "query"
 ## Tech Stack
 
 - **Python 3.11+** — No heavy frameworks, stdlib-first design
+- **Rust (codexa-core)** — Native search engine via PyO3 — HNSW (instant-distance), BM25, tree-sitter AST chunking, mmap persistence, parallel scanning (rayon)
 - **click** — CLI framework
 - **sentence-transformers** — Embedding generation (`all-MiniLM-L6-v2`)
-- **faiss-cpu** — Vector similarity search (O(1) file-level index, batch reconstruction)
-- **tree-sitter** — Multi-language code parsing
+- **faiss-cpu** — Vector similarity search (with Rust HNSW acceleration)
+- **tree-sitter** — Multi-language code parsing (Python + Rust)
 - **watchfiles** — Rust-backed native file watching (inotify/FSEvents/ReadDirectoryChanges)
 - **pydantic** — Configuration & data models
 - **rich** — Terminal UI and formatting

codexa-0.4.2/README.md → codexa-0.5.0/codexa.egg-info/PKG-INFO

@@ -1,3 +1,63 @@
+Metadata-Version: 2.4
+Name: codexa
+Version: 0.5.0
+Summary: Developer intelligence CLI — semantic code search, AI-assisted understanding, and agent tooling for codebases
+License: MIT
+Project-URL: Homepage, https://codex-a.dev
+Project-URL: Documentation, https://codex-a.dev
+Project-URL: Repository, https://github.com/M9nx/CodexA
+Project-URL: Issues, https://github.com/M9nx/CodexA/issues
+Project-URL: Changelog, https://github.com/M9nx/CodexA/blob/main/CHANGELOG.md
+Keywords: code-search,semantic-search,developer-tools,code-intelligence,ai-assistant,cli,tree-sitter,faiss,embeddings,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Text Processing :: Indexing
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: tree-sitter>=0.21.0
+Requires-Dist: tree-sitter-python>=0.21.0
+Requires-Dist: tree-sitter-javascript>=0.21.0
+Requires-Dist: tree-sitter-typescript>=0.21.0
+Requires-Dist: tree-sitter-java>=0.21.0
+Requires-Dist: tree-sitter-go>=0.21.0
+Requires-Dist: tree-sitter-rust>=0.21.0
+Requires-Dist: tree-sitter-cpp>=0.21.0
+Requires-Dist: tree-sitter-c-sharp>=0.21.0
+Requires-Dist: tree-sitter-ruby>=0.21.0
+Requires-Dist: tree-sitter-php>=0.22.0
+Requires-Dist: radon>=6.0.0
+Requires-Dist: bandit>=1.7.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: watchfiles>=1.0.0
+Provides-Extra: ml
+Requires-Dist: sentence-transformers>=2.2.0; extra == "ml"
+Requires-Dist: faiss-cpu>=1.7.4; extra == "ml"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: sentence-transformers>=2.2.0; extra == "dev"
+Requires-Dist: faiss-cpu>=1.7.4; extra == "dev"
+Provides-Extra: tui
+Requires-Dist: textual>=0.40.0; extra == "tui"
+Provides-Extra: build
+Requires-Dist: pyinstaller>=6.0.0; extra == "build"
+Dynamic: license-file
+
 <p align="center">
   <strong>CodexA — Developer Intelligence Engine</strong><br>
   <em>Semantic code search · AI-assisted understanding · Agent tooling protocol</em>
@@ -5,9 +65,11 @@
 
 <p align="center">
   <a href="https://github.com/M9nx/CodexA/actions"><img src="https://github.com/M9nx/CodexA/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://pypi.org/project/codexa/"><img src="https://img.shields.io/pypi/v/codexa?color=blue&label=PyPI" alt="PyPI"></a>
+  <a href="https://pepy.tech/project/codexa"><img src="https://img.shields.io/pepy/dt/codexa?color=blue&label=Downloads" alt="Downloads"></a>
   <img src="https://img.shields.io/badge/python-3.11%2B-blue" alt="Python 3.11+">
-  <img src="https://img.shields.io/badge/version-0.4.0-green" alt="Version">
-  <img src="https://img.shields.io/badge/tests-2595-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/version-0.5.0-green" alt="Version">
+  <img src="https://img.shields.io/badge/tests-2657-brightgreen" alt="Tests">
   <img src="https://img.shields.io/badge/coverage-79%25-brightgreen" alt="Coverage">
   <img src="https://img.shields.io/badge/mypy-strict-blue" alt="mypy strict">
   <img src="https://img.shields.io/badge/license-MIT-blue" alt="License">
@@ -24,17 +86,22 @@ structured tool protocol that any AI agent can call over HTTP or CLI.
 
 | Area | What you get |
 |------|-------------|
-| **Code Indexing** | Scan repos, extract functions/classes, generate vector embeddings (sentence-transformers + FAISS), ONNX runtime option, parallel indexing, `--watch` live re-indexing, `.codexaignore` support |
-| **Multi-Mode Search** | Semantic, keyword (BM25), regex, hybrid (RRF), and raw filesystem grep (ripgrep backend) with full `-A/-B/-C/-w/-v/-c` flags |
+| **Code Indexing** | Scan repos, extract functions/classes, generate vector embeddings (sentence-transformers + FAISS), ONNX runtime option, parallel indexing, `--watch` live re-indexing, `.codexaignore` support, `--add`/`--inspect` per-file control, model-consistency guard, Ctrl+C partial-save |
+| **Rust Search Engine** | Native `codexa-core` Rust crate via PyO3 — HNSW approximate nearest-neighbour search, BM25 keyword index, tree-sitter AST chunker (10 languages), memory-mapped vector persistence, parallel file scanner, optional ONNX embedding inference, optional Tantivy full-text search |
+| **Multi-Mode Search** | Semantic, keyword (BM25), regex, hybrid (RRF), and raw filesystem grep (ripgrep backend) with full `-A/-B/-C/-w/-v/-c/-l/-L/--exclude/--no-ignore` flags, `--hybrid`/`--sem` shorthands, `--scores`, `--snippet-length`, `--no-snippet`, JSONL streaming |
+| **RAG Pipeline** | 4-stage Retrieval-Augmented Generation — Retrieve → Deduplicate → Re-rank → Assemble with token budget, cross-encoder re-ranking, source citations |
 | **Code Context** | Rich context windows — imports, dependencies, AST-based call graphs, surrounding code |
 | **Repository Analysis** | Language breakdown (`codexa languages`), module summaries, component detection |
-| **AI Agent Protocol** | 13 built-in tools exposed via HTTP bridge, MCP server (13 tools), MCP-over-SSE (`--mcp`), or CLI for any AI agent to invoke |
+| **AI Agent Protocol** | 13 built-in tools exposed via HTTP bridge, MCP server (13 tools with pagination/cursors), MCP-over-SSE (`--mcp`), `codexa --serve` shorthand, Claude Desktop auto-config (`--claude-config`), or CLI for any AI agent to invoke |
 | **Quality & Metrics** | Complexity analysis, maintainability scoring, quality gates for CI |
 | **Multi-Repo Workspaces** | Link multiple repos under one workspace for cross-repo search & refactoring |
 | **Interactive TUI** | Terminal REPL with mode switching for interactive exploration |
 | **Streaming Responses** | Token-by-token streaming for chat and investigation commands |
 | **Plugin System** | 22 hooks for extending every layer — from indexing to tool invocation |
 | **VS Code Extension** | 4-panel sidebar (Search, Symbols, Quality, Tools), 8 commands, CodeLens, context menus, status bar |
+| **Editor Plugins** | Zed, JetBrains (IntelliJ/PyCharm), Neovim (telescope.nvim), Vim, Sublime Text, Emacs, Helix, Eclipse -- all sharing the same MCP/bridge protocol |
+| **Cross-Language Intelligence** | FFI pattern detection, polyglot dependency graphs, language-aware search boosting, universal multi-language call graph |
+| **Multi-Agent Sessions** | Concurrent AI agent sessions with shared discovery, semantic diff (rename/move/signature/body detection), RAG code generation |
 
 ---
 
@@ -46,6 +113,12 @@ structured tool protocol that any AI agent can call over HTTP or CLI.
 pip install codexa
 ```
 
+For semantic indexing and vector search, install the ML extras:
+
+```bash
+pip install "codexa[ml]"
+```
+
 Or install from source:
 
 ```bash
@@ -74,6 +147,15 @@ cd /path/to/your-project
 codexa init
 ```
 
+CodexA auto-detects your available RAM and picks the best embedding model.
+Or choose a model profile explicitly:
+
+```bash
+codexa init --profile fast       # mxbai-embed-xsmall — low RAM (<1 GB)
+codexa init --profile balanced   # MiniLM — good balance (~2 GB)
+codexa init --profile precise    # jina-code — best quality (~4 GB)
+```
+
 This creates a `.codexa/` directory with configuration, index storage, and session data.
 
 ### 3. Index the Codebase
@@ -84,6 +166,23 @@ codexa index .
 
 This parses all source files (Python, JS/TS, Java, Go, Rust, C#, Ruby, C++),
 extracts symbols, generates embeddings, and stores them in a local FAISS index.
+Semantic indexing requires `codexa[ml]`.
+
+If you need to keep secrets, generated files, or local config files out of the
+index, add patterns to `.codexaignore` at the project root or configure
+`index.exclude_files` in `.codexa/config.json`.
+
+Typical `.codexaignore` example:
+
+```text
+.env*
+secrets/*.json
+config/local-*.yml
+vendor/*
+```
+
+The default embedding model is small, but the PyTorch backend still needs about
+2 GB of available RAM. On lower-memory machines, prefer the ONNX backend.
 
 ### 4. Semantic Search
 
@@ -201,7 +300,7 @@ cd CodexA
 pip install -e ".[dev]"
 
 # Verify
-codexa --version    # → codexa, version 0.4.0
+codexa --version    # → codexa, version 0.5.0
 ```
 
 ### Step 2 — Initialize your target project
@@ -443,7 +542,7 @@ CodexA provides **39 commands** (plus subcommands) organized by capability:
 | `codexa plugin list\|scaffold\|discover` | Plugin management |
 | `codexa tui` | Interactive terminal REPL |
 | `codexa mcp` | Start MCP (Model Context Protocol) server |
-| `codexa models list\|info\|download\|switch` | Manage embedding models |
+| `codexa models list\|info\|download\|switch\|profiles\|benchmark` | Manage and benchmark embedding models |
 
 ### VS Code Extension
 
@@ -500,8 +599,13 @@ Additional tools can be registered via the plugin system using the
 │  /tools/invoke · /tools/list · /request · SSE stream │
 ├──────────────┬──────────────┬───────────────────────┤
 │ Parsing      │ Embedding    │ Search                │
-│ tree-sitter  │ sent-trans   │ FAISS                 │
+│ tree-sitter  │ sent-trans   │ FAISS / Rust HNSW     │
 ├──────────────┼──────────────┴───────────────────────┤
+│ Rust Engine  │  codexa-core (PyO3)                   │
+│ (optional)   │  HNSW · BM25 · AST chunk · mmap · RRF│
+├──────────────┼──────────────────────────────────────┤
+│ RAG Pipeline │  Retrieve → Dedup → Re-rank → Assemble│
+├──────────────┼──────────────────────────────────────┤
 │ Evolution    │  Self-improving dev loop              │
 │ engine       │  budget · task · patch · test · commit│
 ├──────────────┴──────────────────────────────────────┤
@@ -542,6 +646,9 @@ After `codexa init`, your project has `.codexa/config.json`:
 }
 ```
 
+> **Tip:** Instead of editing `model_name` manually, use `codexa init --profile fast|balanced|precise`
+> or run `codexa models profiles` to see recommended models for your hardware.
+
 ---
 
 ## Documentation
@@ -572,7 +679,7 @@ Browse the docs at **http://localhost:5173** after running `npm run docs:dev`.
 # Install dev dependencies
 pip install -e ".[dev]"
 
-# Run all 2595 tests
+# Run all 2657 tests
 pytest
 
 # Run with coverage (gate: 70% minimum)
@@ -591,10 +698,11 @@ codexa --verbose search "query"
 ## Tech Stack
 
 - **Python 3.11+** — No heavy frameworks, stdlib-first design
+- **Rust (codexa-core)** — Native search engine via PyO3 — HNSW (instant-distance), BM25, tree-sitter AST chunking, mmap persistence, parallel scanning (rayon)
 - **click** — CLI framework
 - **sentence-transformers** — Embedding generation (`all-MiniLM-L6-v2`)
-- **faiss-cpu** — Vector similarity search (O(1) file-level index, batch reconstruction)
-- **tree-sitter** — Multi-language code parsing
+- **faiss-cpu** — Vector similarity search (with Rust HNSW acceleration)
+- **tree-sitter** — Multi-language code parsing (Python + Rust)
 - **watchfiles** — Rust-backed native file watching (inotify/FSEvents/ReadDirectoryChanges)
 - **pydantic** — Configuration & data models
 - **rich** — Terminal UI and formatting

{codexa-0.4.2 → codexa-0.5.0}/codexa.egg-info/SOURCES.txt

@@ -8,9 +8,13 @@ codexa.egg-info/entry_points.txt
 codexa.egg-info/requires.txt
 codexa.egg-info/top_level.txt
 semantic_code_intelligence/__init__.py
+semantic_code_intelligence/rust_backend.py
 semantic_code_intelligence/version.py
 semantic_code_intelligence/analysis/__init__.py
 semantic_code_intelligence/analysis/ai_features.py
+semantic_code_intelligence/analysis/codegen.py
+semantic_code_intelligence/analysis/cross_language.py
+semantic_code_intelligence/analysis/semantic_diff.py
 semantic_code_intelligence/bridge/__init__.py
 semantic_code_intelligence/bridge/context_provider.py
 semantic_code_intelligence/bridge/protocol.py
@@ -103,12 +107,14 @@ semantic_code_intelligence/llm/mock_provider.py
 semantic_code_intelligence/llm/ollama_provider.py
 semantic_code_intelligence/llm/openai_provider.py
 semantic_code_intelligence/llm/provider.py
+semantic_code_intelligence/llm/rag.py
 semantic_code_intelligence/llm/rate_limiter.py
 semantic_code_intelligence/llm/reasoning.py
 semantic_code_intelligence/llm/safety.py
 semantic_code_intelligence/llm/streaming.py
 semantic_code_intelligence/lsp/__init__.py
 semantic_code_intelligence/mcp/__init__.py
+semantic_code_intelligence/mcp/claude_config.py
 semantic_code_intelligence/parsing/__init__.py
 semantic_code_intelligence/parsing/parser.py
 semantic_code_intelligence/plugins/__init__.py
@@ -125,6 +131,7 @@ semantic_code_intelligence/search/section_expander.py
 semantic_code_intelligence/services/__init__.py
 semantic_code_intelligence/services/indexing_service.py
 semantic_code_intelligence/services/search_service.py
+semantic_code_intelligence/sessions/__init__.py
 semantic_code_intelligence/storage/__init__.py
 semantic_code_intelligence/storage/chunk_hash_store.py
 semantic_code_intelligence/storage/hash_store.py
@@ -166,6 +173,7 @@ semantic_code_intelligence/tests/test_phase24.py
 semantic_code_intelligence/tests/test_phase25.py
 semantic_code_intelligence/tests/test_phase26.py
 semantic_code_intelligence/tests/test_phase27.py
+semantic_code_intelligence/tests/test_phase38_42.py
 semantic_code_intelligence/tests/test_phase8.py
 semantic_code_intelligence/tests/test_phase9.py
 semantic_code_intelligence/tests/test_plugins.py