"""混合检索：硬过滤 → 向量召回 → 关键词召回 → RRF 重排 + 缺口埋点（架构 §8.3）.

进程内包，被 agent / report 的 service 调用，没有 HTTP 路由。
硬过滤零漏（FR-KB-06）与向量化可重跑（T-P2-03）的保证都在
``repo.py`` 顶部注释里，改代码前先读。
"""

from __future__ import annotations

from packages.retrieval.embedding import (
    DETERMINISTIC_MODEL_NAME,
    DeterministicEmbedder,
    EmbeddingProvider,
    build_embedding_provider,
)
from packages.retrieval.repo import ChunkInput, hybrid_search, record_gap, upsert_chunks
from packages.retrieval.rerank import RecallRow, ScoredChunk
from packages.retrieval.service import RetrievalService, SearchOutcome, UserContext

__all__ = [
    "DETERMINISTIC_MODEL_NAME",
    "ChunkInput",
    "DeterministicEmbedder",
    "EmbeddingProvider",
    "RecallRow",
    "RetrievalService",
    "ScoredChunk",
    "SearchOutcome",
    "UserContext",
    "build_embedding_provider",
    "hybrid_search",
    "record_gap",
    "upsert_chunks",
]