Struct RagPersistence 

pub struct RagPersistence { /* private fields */ }

RAG index persistence manager

Handles saving and loading the RAG index to/from disk.

Implementations

impl RagPersistence

pub fn new() -> Self

Create persistence manager with default cache path

Default path: ~/.cache/batuta/rag/

pub fn with_path(path: PathBuf) -> Self

Create persistence manager with custom cache path

pub fn cache_path(&self) -> &Path

Get the cache path

pub fn save( &self, index: &PersistedIndex, docs: &PersistedDocuments, sources: Vec<CorpusSource>, ) -> Result<(), PersistenceError>

Save index to disk using two-phase commit

Writes three files with crash safety:

• Prepare phase: Write all .tmp files (crash here = old cache intact)
• Commit phase: Rename all 3, manifest LAST (crash before manifest rename = old manifest still valid or checksum mismatch triggers rebuild)

Files written:

• manifest.json: Version and checksums
• index.json: Inverted index data
• documents.json: Document metadata

pub fn load( &self, ) -> Result<Option<(PersistedIndex, PersistedDocuments, RagManifest)>, PersistenceError>

Load index from disk

Returns None if no cached index exists or if the cache is corrupted (IO error, checksum mismatch, invalid JSON). Corruption triggers a warning to stderr so the caller can rebuild gracefully.

Returns Err only for VersionMismatch (incompatible format requires a code update, not just a re-index).

pub fn load_fingerprints_only( &self, ) -> Result<Option<HashMap<String, DocumentFingerprint>>, PersistenceError>

Load only fingerprints for fast is_index_current checks.

Reads ~KB fingerprints.json instead of ~600MB (index.json + documents.json). Falls back to full load() if fingerprints.json doesn’t exist (pre-upgrade cache).

pub fn save_fingerprints_only( &self, fingerprints: &HashMap<String, DocumentFingerprint>, ) -> Result<(), PersistenceError>

Save only fingerprints.json for fast is_index_current checks.

Used by the SQLite indexing path to persist fingerprints without writing the full 600MB JSON index/documents files.

pub fn clear(&self) -> Result<(), PersistenceError>

Clear cached index

pub fn stats(&self) -> Result<Option<RagManifest>, PersistenceError>

Get index statistics without full load

Trait Implementations

impl Debug for RagPersistence

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RagPersistence

fn default() -> Self

Returns the “default value” for a type.