Struct ProvenanceStore 

pub struct ProvenanceStore { /* private fields */ }

Project-scoped JSONL persistence for edit provenance and checkpoints.

Implementations

impl ProvenanceStore

pub fn new(project_hash: impl Into<String>) -> Result<Self, String>

Opens the default <data>/provenance/<project-hash>/provenance.jsonl store.

pub fn with_data_dir( data_dir: impl AsRef<Path>, project_hash: impl Into<String>, ) -> Result<Self, String>

Opens a store below an explicit data directory, primarily for isolated callers and tests.

pub fn project_hash(&self) -> &str

pub fn storage_path(&self) -> &Path

pub fn record_file_touch( &self, record: ProvenanceRecord, ) -> Result<ProvenanceId, String>

Persists a file observation, returning an existing record ID for a duplicate operation.

pub fn record_checkpoint( &self, record: CheckpointRecord, ) -> Result<CheckpointId, String>

pub fn query_by_path(&self, path: &str) -> Vec<ProvenanceRecord>

pub fn query_by_session(&self, session_id: &str) -> Vec<ProvenanceRecord>

pub fn query_recent_file_touches(&self, limit: usize) -> Vec<ProvenanceRecord>

Returns the most recently observed file touches, newest first.

pub fn query_checkpoints( &self, session_id: Option<&str>, ) -> Vec<CheckpointRecord>

Trait Implementations

impl Clone for ProvenanceStore

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ProvenanceStore

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

Formats the value using the given formatter.