ragdrift-core 0.1.0

Five-dimensional drift detection for RAG systems. Pure Rust core: KS, PSI, MMD, sliced Wasserstein.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

//! ragdrift-core: five-dimensional drift detection for production RAG systems.
//!
//! This crate exposes detectors for **data**, **embedding**, **response**,
//! **confidence**, and **query-pattern** drift, plus the underlying statistical
//! primitives (KS, PSI, MMD, sliced Wasserstein). All numerics live here; the
//! Python `ragdrift` package is a thin PyO3 wrapper.
//!
//! # Example
//!
//! ```
//! use ndarray::Array2;
//! use ragdrift_core::detectors::EmbeddingDriftDetector;
//!
//! let baseline = Array2::<f32>::zeros((50, 16));
//! let mut current = Array2::<f32>::zeros((50, 16));
//! current += 1.0;
//!
//! let detector = EmbeddingDriftDetector::new(0.1);
//! let score = detector.detect(baseline.view(), current.view()).unwrap();
//! assert!(score.score > 0.0);
//! ```

#![deny(missing_docs)]
#![deny(unsafe_code)]

pub mod detectors;
pub mod error;
pub mod stats;
pub mod types;

pub use error::RagDriftError;
pub use types::{BaselineSnapshot, DriftDimension, DriftReport, DriftScore};

/// Result alias used across the crate.
pub type Result<T> = std::result::Result<T, RagDriftError>;