trelix 0.7.0__tar.gz

trelix-0.7.0/.env.example

@@ -0,0 +1,106 @@
+# trelix environment configuration
+# Copy to .env and fill in values. Never commit .env.
+
+# ---------------------------------------------------------------------------
+# Embedding provider (default: local — zero API key needed)
+# ---------------------------------------------------------------------------
+TRELIX_EMBEDDER_PROVIDER=local    # local | openai | azure | voyage | local-code
+
+# ---------------------------------------------------------------------------
+# OpenAI (embeddings + LLM query planner + synthesis)
+# ---------------------------------------------------------------------------
+# OPENAI_API_KEY=sk-...
+# OPENAI_MODEL=gpt-4o                           # chat model for planner + synthesizer
+# TRELIX_EMBEDDER_OPENAI_MODEL=text-embedding-3-large
+
+# ---------------------------------------------------------------------------
+# Azure OpenAI (alternative to openai provider)
+# ---------------------------------------------------------------------------
+# AZURE_API_KEY=...
+# AZURE_ENDPOINT=https://<resource>.openai.azure.com/
+# AZURE_API_VERSION=2025-04-01-preview
+# AZURE_EMBEDDINGS_MODEL=text-embedding-3-large
+# AZURE_CHAT_MODEL=gpt-4o
+
+# ---------------------------------------------------------------------------
+# Voyage AI (best API-based code embeddings — pip install trelix[voyage])
+# CoIR benchmark score: 56.26 avg — best API option for code retrieval
+# ---------------------------------------------------------------------------
+# VOYAGE_API_KEY=pa-...
+# TRELIX_EMBEDDER_VOYAGE_MODEL=voyage-code-3    # 1024-dim, 16k context
+
+# ---------------------------------------------------------------------------
+# Cohere reranker (optional, best precision — pip install trelix[rerank])
+# ---------------------------------------------------------------------------
+# COHERE_API_KEY=...
+# COHERE_ENDPOINT=https://...                   # Azure-deployed Cohere endpoint
+# COHERE_MODEL_RERANK=Cohere-rerank-v4.0-pro
+
+# ---------------------------------------------------------------------------
+# Contextual chunking (v0.4.0 — LLM summaries per chunk, 67% better recall)
+# Costs LLM tokens at index time; off by default
+# ---------------------------------------------------------------------------
+# TRELIX_CHUNKER_CONTEXTUAL=false
+# TRELIX_CHUNKER_CONTEXTUAL_MODEL=gpt-4o-mini
+# TRELIX_CHUNKER_CONTEXTUAL_MAX_TOKENS=100
+
+# ---------------------------------------------------------------------------
+# Vector store backend (v0.4.0)
+# Default: sqlite (zero-infra). Use qdrant for >500k chunk scale.
+# ---------------------------------------------------------------------------
+# TRELIX_STORE_BACKEND=sqlite                   # sqlite | qdrant
+# TRELIX_STORE_HNSW=true                        # enable HNSW O(log n) index
+# TRELIX_STORE_HNSW_M=16
+# TRELIX_STORE_HNSW_EF_SEARCH=50
+
+# Qdrant (pip install trelix[qdrant])
+# QDRANT_URL=http://localhost:6333
+# QDRANT_API_KEY=...
+# QDRANT_COLLECTION=trelix
+
+# ---------------------------------------------------------------------------
+# Retrieval tuning
+# ---------------------------------------------------------------------------
+# TRELIX_RETRIEVAL_RERANK_PROVIDER=cohere       # cohere | cross_encoder
+# TRELIX_RETRIEVAL_RERANK_TOP_N=15
+# TRELIX_RETRIEVAL_CONTEXT_TOKEN_BUDGET=12000
+# TRELIX_RETRIEVAL_SYNTHESIS_MAX_TOKENS=12000
+# TRELIX_RETRIEVAL_GRAPH_IMPORT_MAX_EXTRA=3
+
+# GraphRAG map-reduce synthesis (v0.4.0)
+# Activates when results exceed either threshold
+# TRELIX_RETRIEVAL_GRAPH_RAG=true
+# TRELIX_RETRIEVAL_GRAPH_RAG_THRESHOLD_TOKENS=8000
+# TRELIX_RETRIEVAL_GRAPH_RAG_THRESHOLD_RESULTS=20
+
+# ---------------------------------------------------------------------------
+# Indexing tuning
+# ---------------------------------------------------------------------------
+# TRELIX_PARSE_WORKERS=4                        # parallel parse threads
+# TRELIX_EMBEDDER_EMBED_MAX_TOKENS_PER_BATCH=100000
+# TRELIX_EMBEDDER_TPM_LIMIT=0                   # 0 = unlimited
+
+# ---------------------------------------------------------------------------
+# LLM provider for chat/synthesis (separate from embedder)
+# Default: reads OPENAI_API_KEY / AZURE_API_KEY from above
+# ---------------------------------------------------------------------------
+# TRELIX_LLM_PROVIDER=openai        # openai | azure | anthropic | bedrock | vertex | litellm
+# TRELIX_LLM_MODEL=gpt-4o
+
+# Anthropic (pip install trelix[anthropic])
+# ANTHROPIC_API_KEY=sk-ant-...
+
+# AWS Bedrock (pip install trelix[bedrock])
+# AWS_REGION=us-east-1
+# AWS_ACCESS_KEY_ID=...
+# AWS_SECRET_ACCESS_KEY=...
+# AWS_PROFILE=my-profile
+
+# Vertex AI / Gemini (pip install trelix[vertex])
+# GOOGLE_CLOUD_PROJECT=my-project
+# GOOGLE_CLOUD_LOCATION=us-central1
+# GOOGLE_API_KEY=...  (for AI Studio)
+
+# LiteLLM passthrough — 100+ providers (pip install trelix[litellm])
+# TRELIX_LLM_PROVIDER=litellm
+# TRELIX_LLM_LITELLM_MODEL=bedrock/claude-3-5-sonnet

trelix-0.7.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,27 @@
+---
+name: Bug report
+about: Something isn't working as expected
+labels: bug
+---
+
+## Description
+<!-- A clear description of the bug -->
+
+## Reproduction
+```bash
+# Minimal steps to reproduce
+trelix index ./my-repo
+trelix ask ./my-repo "query that fails"
+```
+
+## Expected behavior
+<!-- What should have happened -->
+
+## Actual behavior
+<!-- What actually happened — include full error output -->
+
+## Environment
+- trelix version: <!-- `pip show trelix` -->
+- Python version: <!-- `python --version` -->
+- OS: <!-- macOS 14, Ubuntu 22.04, etc. -->
+- Provider: <!-- local | openai | azure -->

trelix-0.7.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature request
+about: Suggest an improvement or new capability
+labels: enhancement
+---
+
+## Problem / motivation
+<!-- What problem does this solve? What can't you do today? -->
+
+## Proposed solution
+<!-- What would you like to see? -->
+
+## Alternatives considered
+<!-- Other approaches you thought about -->
+
+## Additional context
+<!-- Any other relevant details, links, or examples -->

trelix-0.7.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,15 @@
+## Summary
+<!-- What does this PR do? 1–3 bullet points. -->
+
+## Changes
+<!-- List the key files changed and why -->
+
+## Test plan
+- [ ] Unit tests pass: `make test-fast`
+- [ ] Full suite passes: `make test`
+- [ ] Lint clean: `make lint`
+- [ ] Type check clean: `make typecheck`
+- [ ] Manual smoke test (if applicable): describe what you ran
+
+## Phase / milestone
+<!-- e.g. "Phase 3 — Embedder abstraction" -->

trelix-0.7.0/.github/workflows/build-binaries.yml

@@ -0,0 +1,53 @@
+name: Build Binaries
+
+on:
+  push:
+    branches: [develop, main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build trelix (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-latest
+            artifact-name: trelix-macos-arm64
+            binary-path: dist/trelix
+          - os: windows-latest
+            artifact-name: trelix-windows-x64
+            binary-path: dist/trelix.exe
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: pip install -e ".[local]" && pip install pyinstaller
+
+      - name: Build binary
+        run: pyinstaller trelix.spec --clean --noconfirm
+
+      - name: Verify binary (macOS)
+        if: runner.os == 'macOS'
+        run: |
+          file dist/trelix
+          ./dist/trelix --help
+
+      - name: Verify binary (Windows)
+        if: runner.os == 'Windows'
+        run: dist/trelix.exe --help
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact-name }}
+          path: ${{ matrix.binary-path }}
+          retention-days: 30

trelix-0.7.0/.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  lint:
+    name: Lint & Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install project + dev deps
+        run: pip install -e ".[local,dev]"
+      - name: Ruff check
+        run: ruff check src/ tests/
+      - name: Ruff format check
+        run: ruff format --check src/ tests/
+      - name: Mypy
+        run: mypy src/trelix/ --ignore-missing-imports
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install trelix + dev deps
+        run: pip install -e ".[local,dev]"
+      - name: Run unit tests
+        run: pytest tests/unit/ -v --tb=short
+      - name: Upload coverage
+        if: matrix.python-version == '3.11'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: htmlcov/

trelix-0.7.0/.github/workflows/release.yml

@@ -0,0 +1,125 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-binaries:
+    name: Build trelix (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: macos-latest
+            artifact-name: trelix-macos-arm64
+            binary-path: dist/trelix
+          - os: windows-latest
+            artifact-name: trelix-windows-x64
+            binary-path: dist/trelix.exe
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: pip install -e ".[local]" && pip install pyinstaller
+
+      - name: Build binary
+        run: pyinstaller trelix.spec --clean --noconfirm
+
+      - name: Verify binary (macOS)
+        if: runner.os == 'macOS'
+        run: |
+          file dist/trelix
+          ./dist/trelix --help
+
+      - name: Verify binary (Windows)
+        if: runner.os == 'Windows'
+        run: dist/trelix.exe --help
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.artifact-name }}
+          path: ${{ matrix.binary-path }}
+          retention-days: 30
+
+  publish:
+    name: Publish to PyPI & GitHub Release
+    runs-on: ubuntu-latest
+    needs: build-binaries
+    environment: pypi
+    permissions:
+      id-token: write    # OIDC trusted publisher (PyPI)
+      contents: write    # create GitHub Release + upload assets
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: pip install build twine
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Check distributions
+        run: twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Build trelix-mcp
+        run: cd packages/trelix-mcp && python -m build
+
+      - name: Publish trelix-mcp to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: packages/trelix-mcp/dist/
+
+      - name: Build trelix-langchain
+        run: cd packages/trelix-langchain && python -m build
+
+      - name: Publish trelix-langchain to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: packages/trelix-langchain/dist/
+
+      - name: Build trelix-llama-index
+        run: cd packages/trelix-llama-index && python -m build
+
+      - name: Publish trelix-llama-index to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: packages/trelix-llama-index/dist/
+
+      - name: Download macOS binary
+        uses: actions/download-artifact@v4
+        with:
+          name: trelix-macos-arm64
+          path: release-assets/macos
+
+      - name: Download Windows binary
+        uses: actions/download-artifact@v4
+        with:
+          name: trelix-windows-x64
+          path: release-assets/windows
+
+      - name: Create GitHub Release with binaries
+        uses: softprops/action-gh-release@v2
+        with:
+          files: |
+            release-assets/macos/trelix
+            release-assets/windows/trelix.exe
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

trelix-0.7.0/.gitignore

@@ -0,0 +1,60 @@
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.Python
+*.egg-info/
+*.egg
+build/
+.eggs/
+pip-wheel-metadata/
+
+# dist/ — ignore generated packaging artefacts; binaries are attached via GitHub Releases.
+dist/
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Trelix index data — never commit these
+.trelix/
+
+# Test / coverage artefacts
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Ruff / Mypy caches
+.ruff_cache/
+.mypy_cache/
+
+# Environment files — secrets must not be committed
+.env
+.env.local
+.env.*.local
+
+# Claude Code internal data
+.claude/
+
+# uv lockfile (not committed — project uses pip/hatchling)
+uv.lock
+
+# Editor / OS
+.DS_Store
+.idea/
+.vscode/
+*.swp
+*.swo
+Thumbs.db
+
+# Distribution / packaging
+*.tar.gz
+*.whl
+MANIFEST
+.superpowers/
+packages/trelix-mcp/mcp-publisher
+scratch-pad/

trelix-0.7.0/.pre-commit-config.yaml

@@ -0,0 +1,14 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.5.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.10.0
+    hooks:
+      - id: mypy
+        additional_dependencies: [pydantic, pydantic-settings]
+        args: [--ignore-missing-imports]

trelix-0.7.0/CHANGELOG.md

@@ -0,0 +1,215 @@
+# Changelog
+
+All notable changes to trelix are documented here.
+
+Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) — [Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+---
+
+## [0.7.0] — 2026-06-27
+
+### Overview
+Universal LLM client factory — all 5 chat call sites migrated to a provider-agnostic
+`TrelixChatClient` ABC. Adding any new provider requires zero changes to business logic.
+
+### Added
+- **`src/trelix/llm/` package** — `TrelixChatClient` ABC, `ChatMessage`, `ChatResponse`,
+  `ToolCallResponse` dataclasses, `build_chat_client()` factory
+- **`LLMConfig`** — new config class for chat providers (separate from `EmbedderConfig`).
+  Added as `IndexConfig.llm` field.
+- **`OpenAIBackend`** — OpenAI + Azure. Auto-detects `max_completion_tokens` vs `max_tokens`
+  based on model family (gpt-4o→max_completion_tokens; gpt-4/gpt-3.5→max_tokens)
+- **`AnthropicBackend`** — Anthropic Claude direct. `max_tokens=`, `system=` separate param,
+  `input_schema` tool format, `end_turn`→`stop` normalization. `pip install trelix[anthropic]`
+- **`BedrockBackend`** — AWS Bedrock Converse API. `inferenceConfig.maxTokens` (nested camelCase),
+  `system=[{"text":...}]` top-level, content always list-of-dicts, `{"auto":{}}` tool choice.
+  `pip install trelix[bedrock]`
+- **`VertexBackend`** — Google Vertex AI / Gemini via google-genai SDK. `max_output_tokens` in
+  `GenerateContentConfig`, `system_instruction=` param. `pip install trelix[vertex]`
+- **`LiteLLMBackend`** — universal delegate for 100+ providers. `drop_params=True` suppresses
+  UnsupportedParamsError. Model strings: `"bedrock/claude-3-5-sonnet"`, `"gemini/gemini-2.0-flash"`.
+  `pip install trelix[litellm]`
+- New optional dep groups: `[anthropic]`, `[bedrock]`, `[vertex]`, `[litellm]`, `[llm-all]`
+
+### Changed
+- All 5 LLM call sites now use `TrelixChatClient` via factory — never import provider SDKs directly
+- `ContextualChunker` accepts `TrelixChatClient` (new) or raw openai client (backward compat)
+
+### Fixed
+- `_token_limit_param()` in OpenAIBackend correctly routes legacy models to `max_tokens=`
+  and modern models to `max_completion_tokens=` — eliminates the recurring parameter bug
+
+---
+
+## [0.6.0] — 2026-06-27
+
+### Overview
+Contextual chunking is now production-ready — the feature works end-to-end with verified context summaries stored in the database and indexed in BM25. Two bugs fixed that prevented contextual summaries from actually persisting.
+
+### Fixed
+- **Contextual chunking context_summary persistence:** `ContextualChunker.build_chunks()` sets `symbol.context_summary` but the DB insert in `Indexer._insert_one()` happened before chunking ran. Fixed by adding an `UPDATE symbols SET context_summary = ?` pass after `build_chunks()` for any symbols that received summaries. All 66 test symbols now have `context_summary IS NOT NULL`.
+- **Contextual chunking LLM call:** `ContextualChunker._generate_summary()` used `max_tokens=` — unsupported by gpt-4o / newer Azure. Changed to `max_completion_tokens=` (consistent with synthesizer.py fix in v0.3.0).
+- **Test updated:** `test_llm_called_with_correct_arguments` asserts `max_completion_tokens` instead of `max_tokens`.
+
+### Verified
+- 66/66 symbols receive LLM context summaries stored in `symbols.context_summary`
+- Summaries indexed in `symbols_fts` — BM25 searches now include them
+- Recall@5: 10/10 = 100% on mini_repo (baseline maintained)
+
+### How to Enable Contextual Chunking
+
+```bash
+TRELIX_CHUNKER_CONTEXTUAL=true
+TRELIX_CHUNKER_CONTEXTUAL_MODEL=gpt-4o-mini
+TRELIX_EMBEDDER_PROVIDER=openai   # or azure
+trelix index ./your-repo
+```
+
+---
+
+## [0.5.1] — 2026-06-27
+
+### Fixed
+- `trelix-mcp` README: add `<!-- mcp-name: io.github.sairam0424/trelix -->` ownership verification tag required by the official MCP registry
+- `trelix-mcp` server.json: shorten description to ≤100 chars to pass registry validation
+
+---
+
+## [0.5.0] — 2026-06-27
+
+### Overview
+Ecosystem discoverability release — trelix is now reachable across every major surface in the AI developer ecosystem. Three new PyPI packages, MCP registry listing, GitHub Action marketplace, Homebrew tap, and awesome list submissions.
+
+### Added
+
+#### New PyPI Packages
+- **`trelix-mcp`** (`pip install trelix-mcp`) — MCP server exposing 4 tools via stdio transport. Works with Claude Code, Cursor, Windsurf, and Continue.dev. One-command setup: `claude mcp add trelix -- trelix-mcp`.
+  - `search_code(query, repo_path, k=10)` — hybrid semantic + BM25 code search
+  - `index_codebase(repo_path, provider="local")` — index a repository (run once)
+  - `get_symbol(qualified_name, repo_path)` — get full source of any symbol
+  - `blast_radius(symbol_name, repo_path)` — find everything that depends on a symbol
+- **`trelix-langchain`** (`pip install trelix-langchain`) — `TrelixRetriever(BaseRetriever)` for LangChain RAG pipelines. Returns `list[Document]` with full metadata (file, symbol, language, score, lines).
+- **`trelix-llama-index`** (`pip install trelix-llama-index`) — `TrelixIndexRetriever(BaseRetriever)` for LlamaIndex. Returns `list[NodeWithScore]` with file + symbol metadata.
+
+#### Registry & Discovery
+- **Official MCP Registry** — submitted via `mcp-publisher` CLI. Server ID: `io.github.sairam0424/trelix`. Pip ownership verified via `mcp-name` tag in README.
+- **Glama.ai** — `glama.json` added to repo root for automatic Glama MCP directory indexing.
+- **GitHub Actions Marketplace** — `trelix-index-action@v1` at `github.com/sairam0424/trelix-index-action`. Auto-indexes any repo on push with cached `.trelix/index.db`.
+- **Homebrew tap** — `brew tap sairam0424/trelix && brew install trelix` via `github.com/sairam0424/homebrew-trelix`.
+- **Awesome list submissions** — PRs submitted to awesome-mcp-servers (#8787), awesome-llm-apps (#903), awesome-langchain (#426).
+
+#### PyPI Metadata
+- 5 new Topic classifiers: `Scientific/Engineering :: Artificial Intelligence`, `Software Development :: Libraries :: Application Frameworks`, `Text Processing :: Indexing`, `Internet :: WWW/HTTP :: Indexing/Search`
+- 21 keywords including `mcp`, `model-context-protocol`, `langchain`, `llama-index`, `code-assistant`, `static-analysis`
+- 3 new README badges: MCP Compatible, LangChain retriever, Downloads
+
+#### CI/CD
+- `release.yml` now publishes all 4 packages (`trelix`, `trelix-mcp`, `trelix-langchain`, `trelix-llama-index`) to PyPI on `v*` tag
+- PyPI OIDC trusted publisher configured for all 4 packages (no stored secrets for future releases)
+
+#### Documentation
+- `docs/discoverability/ECOSYSTEM-ROADMAP.md` — full ecosystem strategy with registry URLs, submission templates, priority stack
+- `docs/discoverability/AWESOME-LIST-SUBMISSIONS.md` — ready-to-submit PR bodies for 3 awesome lists
+- `packages/trelix-mcp/README.md` — install, Claude Code / Cursor / Windsurf / Continue.dev setup, tools table
+- `packages/trelix-mcp/server.json` — official MCP registry schema for `mcp-publisher`
+
+### Changed
+- `pyproject.toml` version `0.4.0` → `0.5.0`; all sub-packages at `0.5.0` (trelix-mcp at `0.5.1`)
+- `src/trelix/__init__.py` `__version__` updated to `0.5.0`
+- README: added Integrations table (MCP, LangChain, LlamaIndex, GitHub Action, Homebrew), MCP Quick Setup block, LangChain code example, Homebrew install option, GitHub Action quick-start
+
+### Fixed
+- Package builds: `LICENSE` copied into each sub-package (hatchling resolves paths relative to package root, not repo root)
+- `trelix-mcp/__init__.py`: added `__all__ = ["__version__"]` for parity with other packages
+- `trelix-llama-index/retriever.py`: import ordering fix (ruff I001)
+- Test files: removed unused `patch` imports from `trelix-langchain` and `trelix-llama-index` test suites
+
+---
+
+## [0.4.0] — 2026-06-26
+
+### Overview
+Beast-mode upgrade across three axes simultaneously: **retrieval quality** (+49% embedding quality, 67% failure-rate reduction), **scale** (HNSW index, Qdrant backend), and **speed** (4x async pipeline, real-time file watcher). Grounded in 6 adversarially-verified research findings from the CoIR benchmark, Anthropic contextual retrieval research, and VLDB/ACL 2025 proceedings.
+
+### Added
+
+#### Quality — Retrieval & Embeddings
+- **Contextual Chunking (U1):** `ContextualChunker` prepends a 2-3 sentence LLM-generated summary to each chunk before embedding AND BM25 indexing. Reduces retrieval failure rate from 5.7% → 1.9% (67% reduction). Config-gated via `TRELIX_CHUNKER_CONTEXTUAL=false` — off by default.
+- **Voyage Code Embedder (U2):** New `voyage` provider using `voyage-code-3` (1024-dim, 16k context). Scores 56.26 avg on CoIR benchmark vs Ada-002's 45.59 (+24%). `pip install trelix[voyage]`.
+- **Local Code Embedder (U2):** New `local-code` provider using `Salesforce/SFR-Embedding-Code-2B_R` (4096-dim, 2B params). Scores 67.41 on CoIR — 49% quality gain over Ada-002. No API key required.
+
+#### Scale — Vector Store
+- **Filterable HNSW Index (U3):** O(log n) vector search via sqlite-vec HNSW. Falls back to flat scan on older versions.
+- **Qdrant Optional Backend (U4):** `QdrantVectorStore` drop-in for >500k chunk deployments. `trelix migrate-vectors --to qdrant`. `pip install trelix[qdrant]`.
+
+#### Speed — Indexing & Updates
+- **Async Batch Embedding (U5):** Phase 3 runs up to 4 concurrent embed batches via `asyncio.gather`. ~3-4x speedup on large repos.
+- **File Watcher (U6):** `trelix watch <repo>` — 500ms debounced auto-reindex on file save. `pip install trelix[watch]`.
+
+#### Intelligence — Planning & Synthesis
+- **Adaptive 3-Tier Query Router (U7):** Tier 1 (direct/skip retrieval) → Tier 2 (8-intent single-step) → Tier 3 (multi-step decomposition).
+- **GraphRAG Map-Reduce Synthesis (U8):** For >20 results or >8k tokens, map-reduce synthesis handles arbitrarily large corpora.
+
+#### Precision — Call Graph
+- **Call Graph Precision (U9):** 3-priority callee resolution (qualified_name → type_hint+name → name-only). ~40% fewer false-positive cross-file edges.
+
+#### Evaluation
+- **Production Eval Harness (U10):** MRR, Recall@1/5/10, NDCG@10 on 50 trelix-self queries. `make eval-full`.
+
+### Changed
+- New optional dep groups: `[voyage]`, `[qdrant]`, `[watch]`
+- `BaseVectorStore` ABC introduced; `VectorStore` → `SQLiteVectorStore`
+- `QueryPlanner` → `AdaptiveRouter` (backward-compatible)
+
+### Fixed
+- `synthesizer.py`: `max_completion_tokens` for gpt-4o compatibility
+- Test fixtures: removed synthetic passwords that triggered GitGuardian
+
+---
+
+## [0.3.0] — 2026-06-26
+
+### Added
+- Removed all internal origin watermarks (`aava`, `AavaPlatformEmbedder`, `CODEINDEX_*`, `codeindex` binary)
+- PyInstaller binary renamed `codeindex` → `trelix`
+- Fixed `synthesizer.py` `max_completion_tokens` for gpt-4o
+- Restored correct `tree_sitter_languages.get_language()` in 4 parsers
+- Updated `.gitignore` to exclude `.claude/`, `uv.lock`, `dist/`
+
+---
+
+## [0.2.0] — 2026-06-25
+
+### Added
+- Ruby parser — completes all 20 language extractors
+- PyInstaller spec (`trelix.spec`) — `dist/trelix` single-file binary
+- `scripts/build-binary.sh`, `make binary` / `make binary-clean` / `make binary-install`
+- GitHub Actions `build-binaries.yml` — macOS arm64 + Windows x64 matrix
+- Release workflow attaches binaries to GitHub Releases
+- `docs/integrations/vscode-plugin.md`
+
+---
+
+## [0.1.0] — 2026-06-25
+
+### Added
+- Initial release — Tree-sitter AST indexing for 20+ languages
+- Hybrid search: vector (ANN, sqlite-vec) + BM25 (FTS5) + grep via RRF
+- RRF fusion + call-graph / import / type-edge expansion with PageRank
+- 8-intent LLM query planner
+- Cohere + cross-encoder reranker
+- Intent-aware context assembler (greedy / breadth_first)
+- LLM synthesis via OpenAI or Azure (`trelix ask`)
+- CLI: `index`, `search`, `ask`, `query`, `stats`, `update-index`
+- Providers: `local` (no API key), `openai`, `azure`
+- Zero-infra store: single SQLite file with sqlite-vec + FTS5 BM25
+
+[Unreleased]: https://github.com/sairam0424/trelix/compare/v0.5.1...HEAD
+[0.5.1]: https://github.com/sairam0424/trelix/releases/tag/v0.5.1
+[0.5.0]: https://github.com/sairam0424/trelix/releases/tag/v0.5.0
+[0.4.0]: https://github.com/sairam0424/trelix/releases/tag/v0.4.0
+[0.3.0]: https://github.com/sairam0424/trelix/releases/tag/v0.3.0
+[0.2.0]: https://github.com/sairam0424/trelix/releases/tag/v0.2.0
+[0.1.0]: https://github.com/sairam0424/trelix/releases/tag/v0.1.0