nova-rag 0.1.0__tar.gz

nova_rag-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug Report
+about: Something isn't working as expected
+title: "[Bug] "
+labels: bug
+---
+
+## What happened?
+
+A clear description of the bug.
+
+## What did you expect?
+
+What should have happened instead.
+
+## Steps to reproduce
+
+1. ...
+2. ...
+3. ...
+
+## Environment
+
+- OS:
+- Python version:
+- nova-rag version:
+- MCP client (Claude Code / Cursor / other):
+
+## Error output
+
+```
+Paste any error messages here
+```

nova_rag-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,22 @@
+---
+name: Feature Request
+about: Suggest a new feature or improvement
+title: "[Feature] "
+labels: enhancement
+---
+
+## Problem
+
+What problem does this solve? Why is it needed?
+
+## Proposed solution
+
+How do you imagine it working?
+
+## Alternatives considered
+
+Any other approaches you've thought about?
+
+## Additional context
+
+Screenshots, code examples, links to similar features in other tools.

nova_rag-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,19 @@
+## What does this PR do?
+
+Brief description of changes.
+
+## Why?
+
+What problem does it solve or what feature does it add?
+
+## How to test
+
+1. ...
+2. ...
+
+## Checklist
+
+- [ ] Tests added/updated
+- [ ] All 99+ tests pass (`pytest tests/ -v`)
+- [ ] Documentation updated (if needed)
+- [ ] No new dependencies added (or justified why)

nova_rag-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,31 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.11", "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 }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/ -v

nova_rag-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.eggs/
+.venv/
+venv/
+.mypy_cache/
+.pytest_cache/
+.tox/
+*.so

nova_rag-0.1.0/CLAUDE.md

@@ -0,0 +1,48 @@
+# nova-rag — Code Intelligence MCP Server
+
+## For users: add to your project's CLAUDE.md
+
+```markdown
+## Code Search (nova-rag)
+
+This project has a local code intelligence index. Use `code_search` — it auto-detects what you need:
+
+- "where is payment processing?" → semantic search with graph context
+- "who calls handleAuth?" → call graph: all callers
+- "what does processData call?" → call graph: all callees
+- "who imports psycopg2?" → import graph
+- "dead code in src/auth" → unused function detection
+- "class hierarchy of UserService" → inheritance tree
+- "impact of changing validate" → blast radius analysis
+- "what changed this week?" → git change intelligence
+
+Search results include `callers`/`callees` — use them for full context.
+For exact string matches (TODOs, error messages), use Grep.
+```
+
+## For nova-rag developers
+
+### Build and test
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v   # 99 tests
+```
+
+### Architecture
+- `server.py` — MCP entry point, 11 tools (code_search = smart router)
+- `searcher.py` — smart router + hybrid search + graph queries + deadcode + impact
+- `indexer.py` — multithreaded: ThreadPoolExecutor for chunking/graph, sequential embedding
+- `chunker.py` — tree-sitter AST parsing (7 languages) + sliding window fallback
+- `graph.py` — symbols, calls, imports, inheritance extraction from tree-sitter AST
+- `git_intel.py` — git change intelligence mapped to code graph
+- `store.py` — FAISS vectors + SQLite (FTS5 + graph tables + inheritance)
+- `watcher.py` — watchdog file watcher for auto-reindex
+- `config.py` — env var configuration
+
+### Key decisions
+- Smart router detects intent from query via regex patterns
+- Hybrid search via RRF (Reciprocal Rank Fusion) from FAISS + FTS5
+- Code graph stored in SQLite (symbols, calls, imports, inheritance tables)
+- Impact analysis: recursive transitive caller graph traversal
+- Multithreading: file processing in parallel, embedding/store sequential
+- Embedding model pre-loaded in background thread at startup

nova_rag-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,28 @@
+# Code of Conduct
+
+## Our Pledge
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+**Positive behavior:**
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+
+**Unacceptable behavior:**
+- Trolling, insulting comments, and personal attacks
+- Harassment in any form
+- Publishing others' private information without permission
+
+## Enforcement
+
+Project maintainers are responsible for clarifying standards of acceptable behavior and will take appropriate action in response to unacceptable behavior.
+
+Instances of abusive behavior may be reported by opening an issue or contacting the maintainers directly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.1.

nova_rag-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,89 @@
+# Contributing to nova-rag
+
+Thanks for your interest in contributing! nova-rag is a community-driven project and every contribution matters.
+
+## Quick Start
+
+```bash
+git clone https://github.com/Miro96/nova-rag.git
+cd nova-rag
+pip install -e ".[dev]"
+pytest tests/ -v   # 99 tests should pass
+```
+
+## How to Contribute
+
+### Reporting Bugs
+
+Open an [issue](https://github.com/Miro96/nova-rag/issues/new?template=bug_report.md) with:
+- What you expected to happen
+- What actually happened
+- Steps to reproduce
+- Your environment (OS, Python version, nova-rag version)
+
+### Suggesting Features
+
+Open an [issue](https://github.com/Miro96/nova-rag/issues/new?template=feature_request.md) with:
+- What problem it solves
+- How you imagine it working
+- Why it belongs in nova-rag (not a separate tool)
+
+### Submitting Code
+
+1. Fork the repo
+2. Create a feature branch from `main`:
+   ```bash
+   git checkout -b feature/my-feature
+   ```
+3. Make your changes
+4. Write tests for new functionality
+5. Ensure all tests pass:
+   ```bash
+   pytest tests/ -v
+   ```
+6. Commit with a clear message:
+   ```bash
+   git commit -m "Add: description of what you added"
+   ```
+7. Push and open a Pull Request
+
+### What We're Looking For
+
+High-impact contributions:
+- **New languages** — add tree-sitter grammars + call/import/inheritance extraction in `graph.py`
+- **Smart router intents** — new query patterns in `searcher.py`
+- **Better graph analysis** — deeper impact analysis, cycle detection, etc.
+- **Performance** — faster indexing, lower memory usage
+- **Tests** — more edge cases, integration tests
+
+### Adding a New Language
+
+Each language needs changes in 3 files:
+
+1. **`chunker.py`** — add to `_LANGUAGE_CONFIGS` (tree-sitter grammar + node types)
+2. **`graph.py`** — add to `_CALL_TYPES`, `_IMPORT_TYPES`, `_DEFINITION_TYPES`, `_CLASS_TYPES`
+3. **`pyproject.toml`** — add `tree-sitter-<language>` dependency
+
+See existing languages as examples. Each new language should include tests in `tests/fixtures/`.
+
+## Code Style
+
+- Python 3.11+ type hints
+- No external linter enforced — just keep it consistent with existing code
+- Tests for every new feature
+- Docstrings for public functions
+
+## Commit Messages
+
+```
+Add: new feature description
+Fix: bug description
+Update: existing feature change
+Remove: removed feature
+Docs: documentation change
+Test: test addition/change
+```
+
+## Questions?
+
+Open a [discussion](https://github.com/Miro96/nova-rag/discussions) or ask in an issue. No question is too small.

nova_rag-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vladimir Pronevic
+
+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.