Struct ProvenanceTracker 

pub struct ProvenanceTracker { /* private fields */ }

High-level provenance operations for a single project root.

Implementations

impl ProvenanceTracker

pub fn new(project_root: impl AsRef<Path>) -> Result<Self, String>

Creates a tracker keyed like every other per-project store (project_hash::hash_project_root: normalized path plus project identity).

pub fn open_in( data_dir: &Path, project_root: impl AsRef<Path>, ) -> Result<Self, String>

Self::new below an explicit data directory. Releases up to 3.12.0 keyed the store by a SHA-256 of the raw path; such a store is moved to the new key on first open, and read in place if the move fails.

pub fn with_store( store: ProvenanceStore, project_root: impl AsRef<Path>, ) -> Self

Creates a tracker with explicit storage, useful when a caller isolates its data directory.

pub fn store(&self) -> &ProvenanceStore

pub fn observe_edit( &self, path: impl Into<String>, tool: impl Into<String>, before_sha256: impl Into<String>, after_sha256: impl Into<String>, lines_added: u64, lines_removed: u64, session_id: impl Into<String>, agent_id: impl Into<String>, ) -> Result<ProvenanceId, String>

pub fn link_decisions( &self, provenance_id: &str, decision_ids: Vec<DecisionId>, ) -> Result<(), String>

Associates an existing observation with SolutionDecisionMeta identifiers.

pub fn observe_commit( &self, commit_sha: &str, session_id: &str, ) -> Result<CheckpointId, String>

Scans a commit’s changed paths and records a checkpoint linked to matching observations.

pub fn reconcile_rebase( &self, old_sha: &str, new_sha: &str, ) -> Result<usize, String>

Repoints checkpoints after a rebase and marks them as linked again.

Trait Implementations

impl Clone for ProvenanceTracker

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 ProvenanceTracker

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

Formats the value using the given formatter.