repobrain 0.1.0__tar.gz

repobrain-0.1.0/.env.example

@@ -0,0 +1,13 @@
+# LLM Provider
+ANTHROPIC_API_KEY=sk-ant-...
+# OPENAI_API_KEY=sk-...
+# OLLAMA_BASE_URL=http://localhost:11434
+
+# GitHub (optional — for PR analysis and webhook)
+GITHUB_TOKEN=ghp_...
+REPOMIND_WEBHOOK_SECRET=your-hmac-secret
+
+# Overrides (all have defaults in .repomind.toml)
+# REPOMIND_LLM__MODEL=claude-sonnet-4-6
+# REPOMIND_GIT__MAX_COMMITS=10000
+# REPOMIND_GIT__DECAY_HALFLIFE_DAYS=180

repobrain-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: |
+          pytest tests/ -v --cov=repomind --cov-report=xml --cov-report=term-missing
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+      - run: pip install ruff
+      - run: ruff check repomind/

repobrain-0.1.0/.github/workflows/docs.yml

@@ -0,0 +1,31 @@
+name: Deploy Docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    name: Build and deploy docs
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # full history for git-revision-date
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install docs dependencies
+        run: pip install mkdocs-material mkdocs-autorefs
+
+      - name: Build and deploy
+        run: mkdocs gh-deploy --force

repobrain-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  publish:
+    name: Build and publish
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # for trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          cache: pip
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check package
+        run: twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

repobrain-0.1.0/.gitignore

@@ -0,0 +1,63 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+env/
+
+# Testing
+.tox/
+.coverage
+.coverage.*
+htmlcov/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# Environment
+.env
+.env.*
+!.env.example
+
+# repomind runtime data
+*.db
+*.graphml
+lancedb_data/
+repomind_data/
+
+# Docs build
+site/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# macOS
+.DS_Store
+
+# Distribution
+*.whl

repobrain-0.1.0/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+All notable changes to repomind are documented here.
+
+Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+Versioning: [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
+
+## [0.1.0] — 2026-04-06
+
+### Added
+
+- **AtomicStorageCoordinator** — context manager that buffers writes across SQL + LanceDB + NetworkX and rolls back all three on failure
+- **AsyncIndexingPipeline** — 7-stage parallel pipeline; parse stage runs in `ProcessPoolExecutor`, git analysis runs concurrently with graph building
+- **RAGAwareDocGenerator** — fetches dependency docs from LanceDB *before* every LLM call (fixes repowise's #1 flaw)
+- **TemporalMetricsCalculator** — exponential decay scoring `exp(-ln(2) * age_days / halflife)` weights recent commits higher
+- **PRBlastRadiusAnalyzer** — direct + transitive graph traversal, risk scoring 0–10, co-change warnings, reviewer recommendations
+- **Dynamic import hints** — `DjangoDynamicHints`, `PytestDynamicHints`, `NodeDynamicHints` recover 20–40% missing graph edges
+- **12 MCP tools** — 8 improved from repowise + 4 new: `get_pr_impact`, `get_knowledge_map`, `get_test_gaps`, `get_security_hotspots`
+- **6 CLI commands** — `index`, `review`, `serve`, `status`, `query`, `costs`
+- **GitHub webhook server** — HMAC-SHA256 validated, incremental re-index on push, blast radius on PR open/sync
+- **TokenspyCostAdapter** — tracks per-operation LLM spend via tokenspy
+- **Configurable git depth** — `GitConfig.max_commits = 10_000` (repowise hardcodes 500)
+- **Percentile rank refresh** — `GitMetricsRepository.upsert()` always triggers `PERCENT_RANK()` window function refresh

repobrain-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pinaki Mishra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

repobrain-0.1.0/PKG-INFO

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: repobrain
+Version: 0.1.0
+Summary: Codebase intelligence that thinks ahead — outperforms repowise on every dimension
+Project-URL: Homepage, https://pinexai.github.io/repomind
+Project-URL: Repository, https://github.com/pinexai/repomind
+Project-URL: Documentation, https://pinexai.github.io/repomind
+Project-URL: Bug Tracker, https://github.com/pinexai/repomind/issues
+Project-URL: Changelog, https://github.com/pinexai/repomind/blob/main/CHANGELOG.md
+Author-email: Pinaki Mishra <pinaki@pinexai.com>
+License: MIT License
+        
+        Copyright (c) 2026 Pinaki Mishra
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: claude,codebase,developer-tools,intelligence,mcp
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Requires-Dist: aiosqlite>=0.20
+Requires-Dist: anthropic>=0.40
+Requires-Dist: click>=8.1
+Requires-Dist: fastapi>=0.115
+Requires-Dist: fastmcp>=2.0
+Requires-Dist: gitpython>=3.1
+Requires-Dist: httpx>=0.27
+Requires-Dist: lancedb>=0.12
+Requires-Dist: networkx>=3.3
+Requires-Dist: openai>=1.50
+Requires-Dist: pyarrow>=14.0
+Requires-Dist: pydantic-settings>=2.5
+Requires-Dist: pydantic>=2.8
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: rich>=13.7
+Requires-Dist: scipy>=1.11
+Requires-Dist: structlog>=24.0
+Requires-Dist: tenacity>=9.0
+Requires-Dist: tree-sitter>=0.21
+Requires-Dist: uvicorn[standard]>=0.32
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mkdocs-autorefs>=1.0; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.5; extra == 'dev'
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Requires-Dist: types-networkx; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# repomind — Codebase Intelligence That Thinks Ahead
+
+[![PyPI version](https://img.shields.io/pypi/v/repomind.svg)](https://pypi.org/project/repomind/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![CI](https://github.com/pinexai/repomind/actions/workflows/ci.yml/badge.svg)](https://github.com/pinexai/repomind/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-pinexai.github.io%2Frepomind-blue)](https://pinexai.github.io/repomind)
+
+> **10× faster indexing. RAG-aware documentation. PR blast radius. Temporal hotspots.**
+>
+> repomind is a codebase intelligence MCP server for Claude that fixes every critical flaw in repowise — then goes further.
+
+---
+
+## What's Wrong With Repowise (and How We Fix It)
+
+| # | Repowise Flaw | repomind Fix |
+|---|---------------|--------------|
+| 1 | **RAG context never used during generation** — vector store populated but never queried | `RAGAwareDocGenerator` fetches dependency docs from LanceDB *before* every LLM call |
+| 2 | **25+ min initial indexing** — no parallelism | 7-stage async pipeline; parse runs in `ProcessPoolExecutor`, git + parse run concurrently |
+| 3 | **3 stores with no atomic transactions** — 5–15% silent consistency failures | `AtomicStorageCoordinator.transaction()` buffers + rolls back SQL, LanceDB, and NetworkX |
+| 4 | **Hardcoded 500-commit limit** | `GitConfig.max_commits = 10_000` — fully configurable |
+| 5 | **Dynamic imports invisible** (Django, pytest, importlib) — 20–40% missing graph edges | `DjangoDynamicHints`, `PytestDynamicHints`, `NodeDynamicHints` in `HintRegistry` |
+| 6 | **Incremental updates miss global percentile recalculation** | `upsert()` always triggers `PERCENT_RANK()` window function refresh |
+| 7 | **No PR blast radius analysis** | `PRBlastRadiusAnalyzer` + `repomind review <PR>` + `get_pr_impact` MCP tool |
+| 8 | **Temporal blindness** — 3-year-old commits weighted same as yesterday's | Exponential decay: `score += exp(-ln(2) * age_days / halflife) * complexity` |
+| 9 | **Zero cost visibility** | `TokenspyCostAdapter` wraps every Anthropic call; `repomind costs` CLI |
+| 10 | **Conservative dead code** misses real candidates | Dynamic hint edges recovered; configurable sensitivity threshold |
+
+---
+
+## Installation
+
+```bash
+pip install repomind
+```
+
+**Requirements:** Python 3.12+, an Anthropic API key.
+
+---
+
+## Quick Start
+
+```bash
+# 1. Configure
+cp .env.example .env
+# Edit .env — set ANTHROPIC_API_KEY
+
+# 2. Index your repo
+repomind index /path/to/your/repo
+
+# 3. Analyze a PR
+repomind review 42
+
+# 4. Start MCP server for Claude Code
+repomind serve
+```
+
+Then add to your Claude Code MCP config:
+
+```json
+{
+  "mcpServers": {
+    "repomind": {
+      "command": "repomind",
+      "args": ["serve", "--mcp-only"]
+    }
+  }
+}
+```
+
+---
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `repomind index [PATH]` | Index a repository (full or incremental) |
+| `repomind review <PR>` | Analyze PR blast radius and risk score |
+| `repomind serve` | Start MCP server (+ optional webhook) |
+| `repomind status` | Show hotspot rankings and index health |
+| `repomind query "<NL>"` | Natural language codebase search |
+| `repomind costs [--since DATE]` | Show per-operation LLM spend |
+
+**Rich progress during indexing:**
+```
+[=====>     ] 47% | Stage: Generating Docs | Files: 234/500 | Cost: $0.23 | ETA: 4m12s
+```
+
+---
+
+## MCP Tools (12 total)
+
+| Tool | New? | Description |
+|------|------|-------------|
+| `explain_file` | — | File docs with RAG-injected dependency context |
+| `explain_symbol` | — | Symbol-level explanation |
+| `get_hotspots` | — | Temporal decay–weighted churn hotspots |
+| `get_ownership` | — | Temporal-weighted file ownership |
+| `get_dependencies` | — | Import graph with dynamic hint edges |
+| `get_architectural_decisions` | — | ADR search and retrieval |
+| `search_codebase` | — | Semantic vector search |
+| `get_cochange_patterns` | — | Temporal co-change analysis |
+| `get_pr_impact` | **NEW** | Full blast radius for a PR |
+| `get_knowledge_map` | **NEW** | Knowledge silos, bus factor, onboarding targets |
+| `get_test_gaps` | **NEW** | Untested code ranked by risk score |
+| `get_security_hotspots` | **NEW** | Auth/input/SQL risk surfaces |
+
+---
+
+## Architecture
+
+```
+repomind index /repo
+      |
+      v
++-----------------------------------------------------+
+|              AsyncIndexingPipeline (7 stages)        |
+|                                                      |
+|  1. Discovery    -> file manifest to SQL             |
+|  2. Parse        -> ProcessPoolExecutor (CPU-bound)  |
+|  3. Graph Build  -+  concurrent                      |
+|  4. Git Analysis -+  (asyncio.gather)                |
+|  5. Embedding    -> ThreadPoolExecutor + semaphore   |
+|  6. RAG Doc Gen  -> LanceDB deps fetched FIRST       |
+|  7. Atomic Commit-> AtomicStorageCoordinator.txn()   |
++-----------------------------------------------------+
+      |
+      v
++----------+   +--------------+   +----------------+
+| SQLite   |   | LanceDB      |   | NetworkX Graph |
+| (files,  |   | (embeddings, |   | (dependency    |
+|  metrics)|   |  docs)       |   |  graph)        |
++----------+   +--------------+   +----------------+
+```
+
+**Atomic transactions across all three stores:**
+```python
+async with coordinator.transaction() as txn:
+    txn.pending_sql.append(...)
+    txn.pending_vectors.append(...)
+    txn.pending_edges.append(...)
+# On exception: SQL rollback + vector delete + graph node removal
+```
+
+---
+
+## Configuration
+
+```bash
+# .env
+ANTHROPIC_API_KEY=sk-ant-...
+REPOMIND_DATA_DIR=~/.repomind
+REPOMIND_MAX_COMMITS=10000
+REPOMIND_DECAY_HALFLIFE_DAYS=180
+REPOMIND_GENERATION_CONCURRENCY=5
+REPOMIND_MCP_PORT=8766
+REPOMIND_WEBHOOK_PORT=8765
+REPOMIND_WEBHOOK_SECRET=your-github-webhook-secret
+```
+
+---
+
+## Documentation
+
+Full docs at **[pinexai.github.io/repomind](https://pinexai.github.io/repomind)**
+
+- [Installation & Quick Start](https://pinexai.github.io/repomind/getting-started/quickstart/)
+- [CLI Reference](https://pinexai.github.io/repomind/cli/)
+- [MCP Tools Reference](https://pinexai.github.io/repomind/mcp/overview/)
+- [Architecture Deep Dive](https://pinexai.github.io/repomind/architecture/pipeline/)
+- [repomind vs repowise](https://pinexai.github.io/repomind/comparison/)
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Built by [pinexai](https://github.com/pinexai).

repobrain-0.1.0/README.md

@@ -0,0 +1,180 @@
+# repomind — Codebase Intelligence That Thinks Ahead
+
+[![PyPI version](https://img.shields.io/pypi/v/repomind.svg)](https://pypi.org/project/repomind/)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![CI](https://github.com/pinexai/repomind/actions/workflows/ci.yml/badge.svg)](https://github.com/pinexai/repomind/actions/workflows/ci.yml)
+[![Docs](https://img.shields.io/badge/docs-pinexai.github.io%2Frepomind-blue)](https://pinexai.github.io/repomind)
+
+> **10× faster indexing. RAG-aware documentation. PR blast radius. Temporal hotspots.**
+>
+> repomind is a codebase intelligence MCP server for Claude that fixes every critical flaw in repowise — then goes further.
+
+---
+
+## What's Wrong With Repowise (and How We Fix It)
+
+| # | Repowise Flaw | repomind Fix |
+|---|---------------|--------------|
+| 1 | **RAG context never used during generation** — vector store populated but never queried | `RAGAwareDocGenerator` fetches dependency docs from LanceDB *before* every LLM call |
+| 2 | **25+ min initial indexing** — no parallelism | 7-stage async pipeline; parse runs in `ProcessPoolExecutor`, git + parse run concurrently |
+| 3 | **3 stores with no atomic transactions** — 5–15% silent consistency failures | `AtomicStorageCoordinator.transaction()` buffers + rolls back SQL, LanceDB, and NetworkX |
+| 4 | **Hardcoded 500-commit limit** | `GitConfig.max_commits = 10_000` — fully configurable |
+| 5 | **Dynamic imports invisible** (Django, pytest, importlib) — 20–40% missing graph edges | `DjangoDynamicHints`, `PytestDynamicHints`, `NodeDynamicHints` in `HintRegistry` |
+| 6 | **Incremental updates miss global percentile recalculation** | `upsert()` always triggers `PERCENT_RANK()` window function refresh |
+| 7 | **No PR blast radius analysis** | `PRBlastRadiusAnalyzer` + `repomind review <PR>` + `get_pr_impact` MCP tool |
+| 8 | **Temporal blindness** — 3-year-old commits weighted same as yesterday's | Exponential decay: `score += exp(-ln(2) * age_days / halflife) * complexity` |
+| 9 | **Zero cost visibility** | `TokenspyCostAdapter` wraps every Anthropic call; `repomind costs` CLI |
+| 10 | **Conservative dead code** misses real candidates | Dynamic hint edges recovered; configurable sensitivity threshold |
+
+---
+
+## Installation
+
+```bash
+pip install repomind
+```
+
+**Requirements:** Python 3.12+, an Anthropic API key.
+
+---
+
+## Quick Start
+
+```bash
+# 1. Configure
+cp .env.example .env
+# Edit .env — set ANTHROPIC_API_KEY
+
+# 2. Index your repo
+repomind index /path/to/your/repo
+
+# 3. Analyze a PR
+repomind review 42
+
+# 4. Start MCP server for Claude Code
+repomind serve
+```
+
+Then add to your Claude Code MCP config:
+
+```json
+{
+  "mcpServers": {
+    "repomind": {
+      "command": "repomind",
+      "args": ["serve", "--mcp-only"]
+    }
+  }
+}
+```
+
+---
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `repomind index [PATH]` | Index a repository (full or incremental) |
+| `repomind review <PR>` | Analyze PR blast radius and risk score |
+| `repomind serve` | Start MCP server (+ optional webhook) |
+| `repomind status` | Show hotspot rankings and index health |
+| `repomind query "<NL>"` | Natural language codebase search |
+| `repomind costs [--since DATE]` | Show per-operation LLM spend |
+
+**Rich progress during indexing:**
+```
+[=====>     ] 47% | Stage: Generating Docs | Files: 234/500 | Cost: $0.23 | ETA: 4m12s
+```
+
+---
+
+## MCP Tools (12 total)
+
+| Tool | New? | Description |
+|------|------|-------------|
+| `explain_file` | — | File docs with RAG-injected dependency context |
+| `explain_symbol` | — | Symbol-level explanation |
+| `get_hotspots` | — | Temporal decay–weighted churn hotspots |
+| `get_ownership` | — | Temporal-weighted file ownership |
+| `get_dependencies` | — | Import graph with dynamic hint edges |
+| `get_architectural_decisions` | — | ADR search and retrieval |
+| `search_codebase` | — | Semantic vector search |
+| `get_cochange_patterns` | — | Temporal co-change analysis |
+| `get_pr_impact` | **NEW** | Full blast radius for a PR |
+| `get_knowledge_map` | **NEW** | Knowledge silos, bus factor, onboarding targets |
+| `get_test_gaps` | **NEW** | Untested code ranked by risk score |
+| `get_security_hotspots` | **NEW** | Auth/input/SQL risk surfaces |
+
+---
+
+## Architecture
+
+```
+repomind index /repo
+      |
+      v
++-----------------------------------------------------+
+|              AsyncIndexingPipeline (7 stages)        |
+|                                                      |
+|  1. Discovery    -> file manifest to SQL             |
+|  2. Parse        -> ProcessPoolExecutor (CPU-bound)  |
+|  3. Graph Build  -+  concurrent                      |
+|  4. Git Analysis -+  (asyncio.gather)                |
+|  5. Embedding    -> ThreadPoolExecutor + semaphore   |
+|  6. RAG Doc Gen  -> LanceDB deps fetched FIRST       |
+|  7. Atomic Commit-> AtomicStorageCoordinator.txn()   |
++-----------------------------------------------------+
+      |
+      v
++----------+   +--------------+   +----------------+
+| SQLite   |   | LanceDB      |   | NetworkX Graph |
+| (files,  |   | (embeddings, |   | (dependency    |
+|  metrics)|   |  docs)       |   |  graph)        |
++----------+   +--------------+   +----------------+
+```
+
+**Atomic transactions across all three stores:**
+```python
+async with coordinator.transaction() as txn:
+    txn.pending_sql.append(...)
+    txn.pending_vectors.append(...)
+    txn.pending_edges.append(...)
+# On exception: SQL rollback + vector delete + graph node removal
+```
+
+---
+
+## Configuration
+
+```bash
+# .env
+ANTHROPIC_API_KEY=sk-ant-...
+REPOMIND_DATA_DIR=~/.repomind
+REPOMIND_MAX_COMMITS=10000
+REPOMIND_DECAY_HALFLIFE_DAYS=180
+REPOMIND_GENERATION_CONCURRENCY=5
+REPOMIND_MCP_PORT=8766
+REPOMIND_WEBHOOK_PORT=8765
+REPOMIND_WEBHOOK_SECRET=your-github-webhook-secret
+```
+
+---
+
+## Documentation
+
+Full docs at **[pinexai.github.io/repomind](https://pinexai.github.io/repomind)**
+
+- [Installation & Quick Start](https://pinexai.github.io/repomind/getting-started/quickstart/)
+- [CLI Reference](https://pinexai.github.io/repomind/cli/)
+- [MCP Tools Reference](https://pinexai.github.io/repomind/mcp/overview/)
+- [Architecture Deep Dive](https://pinexai.github.io/repomind/architecture/pipeline/)
+- [repomind vs repowise](https://pinexai.github.io/repomind/comparison/)
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+Built by [pinexai](https://github.com/pinexai).