__init__.py

"""
Savant Engine SDK
=================

Deterministic geometric governance layer for embedding models.

This package provides:
- SavantWrapper: Geometry-owned embedding stabilizer
- GeometryAudit: Audit logging and forensic traceability
- rrf_safe_similarity: Numerically safe similarity functions for RRF pipelines

Design principles:
- Silent Math (zero-bias under nominal conditions)
- Deterministic manifold control
- Auditability for safety-critical systems
"""

# Versioning
__version__ = "0.1.0"

# Core wrapper
from .savant_wrapper import SavantWrapper

# Geometry audit & logging
from .geometry_audit import GeometryAudit, AuditEvent

# RRF-safe similarity primitives
from .rrf_safe_similarity import (
    safe_cosine_similarity,
    safe_euclidean_distance,
    rrf_score_safe,
)

__all__ = [
    "__version__",
    # Core
    "SavantWrapper",
    # Audit
    "GeometryAudit",
    "AuditEvent",
    # RRF-safe math
    "safe_cosine_similarity",
    "safe_euclidean_distance",
    "rrf_score_safe",
]