Hybrid RAG: BM25+Dense (sqlite-vec/BGE-M3) + cross-encoder reranker (bge-reranker-v2-m3)

src/kpaa/embeddings/__init__.py

@@ -0,0 +1,15 @@
+"""KPAA hybrid retrieval — dense embeddings + cross-encoder reranker.
+
+BM25(FTS5) 인덱스(`kpaa.guides.index`, `kpaa.cases.index`)와 별개로 dense 인덱스를
+`data/embeddings.sqlite` (sqlite-vec) 에 둠. retriever 단에서 BM25 + dense 결과를
+RRF 로 결합 → reranker 로 재정렬.
+
+모델 기본값:
+- 임베딩: BAAI/bge-m3 (1024 dim, multilingual)
+- 리랭커: BAAI/bge-reranker-v2-m3
+
+환경변수:
+- KPAA_EMBEDDER          기본 BAAI/bge-m3
+- KPAA_RERANKER          기본 BAAI/bge-reranker-v2-m3, "off" 면 비활성
+- KPAA_EMBED_DEVICE      "auto"(기본) | "cuda" | "mps" | "cpu"
+"""