release: v0.17.0 — Layer 1 hybrid retrieval + granite embedding

[cmeans-claude-dev]

Summary

Version stamp for v0.17.0. All code changes already merged and QA Approved via feature PRs.

Highlights

Layer 1 Hybrid Retrieval — vector + FTS + Reciprocal Rank Fusion

• Hybrid search tool fusing HNSW vector similarity and GIN full-text search via RRF (k=60)
• Per-entry language detection via lingua-py (28 stock snowball regconfigs)
• language parameter on write tools (explicit ISO 639-1 or auto-detect)
• get_knowledge language filter
• Regconfig validation cache with graceful fallback
• Unsupported-language alerts for demand signaling
• semantic_search deprecated alias for search

Granite Embedding Model — multilingual vector search

• Default swap from nomic-embed-text (English-only) to granite-embedding:278m (IBM, 12 languages)
• Cross-lingual similarity: en→fr 0.48→0.91, en→de 0.45→0.96, en→ja 0.39→0.92
• Same 768 dimensions — no schema migration

Deployment Fixes

• Alembic DSN format handling (fix: alembic env.py handles psycopg DSN format #276)
• DSN quoting docs (fix: ambiguous URL detection, DSN quoting docs #280)
• QA compose port publishing (fix: publish postgres and ollama ports in QA compose #282, closes docker-compose.qa.yaml: publish postgres and ollama ports to host #281)
• LXC permissions docs (fix: document /etc/awareness/ directory permissions #283, closes fix: LXC provisioning — /etc/awareness/ directory permissions #275)

Tooling

• scripts/benchmark_layer1.py — 23-test repeatable benchmark (FTS, vector, RRF, language detection, latency)
• scripts/backfill_language.py — RLS-aware language backfill
• compose_detection_text() shared function for consistent language detection across write tools and backfill

Closes #238. 869 tests. 30 MCP tools.

QA

Release PR — version stamp only, no code changes. All code was QA Approved in feature PRs (#276, #279, #280, #282, #283).

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[cmeans]

QA Review — PR #284 (Round 1)

CI: All green
Scope: 2 files (+5/-2) — version stamp only

Verified

• pyproject.toml: 0.16.2 → 0.17.0
• CHANGELOG: [0.17.0] - 2026-04-13 header inserted correctly after empty [Unreleased]
• Compare links: [Unreleased] rebased to v0.17.0...HEAD, new [0.17.0] link v0.16.2...v0.17.0
• Closes #238 (Layer 1 hybrid retrieval) — all feature PRs already QA Approved (#276, #279, #280, #282, #283)
• No code changes — pure version stamp

Release PR per project conventions — code was tested in feature PRs.

Zero findings

Verdict: Ready for QA Signoff

[cmeans]

Adding Ready for QA Signoff — version stamp verified, zero findings, CI green. All code QA Approved in feature PRs.

[cmeans]

LGTM