Struct VersionControl 

pub struct VersionControl { /* private fields */ }

Version control system for model checkpoints

Features:

• Complete version history
• Parent-child relationships (branching)
• Metadata tracking
• Checksum verification
• Generation/lineage tracking

Compliance:

• CMMC AU.3.046: Alert in the event of an audit logging process failure
• CMMC AU.3.049: Protect audit information from unauthorized access

Implementations

impl VersionControl

pub fn new(vault_path: &Path) -> Result<Self>

Create new version control instance

pub fn vault_path(&self) -> &Path

Return the vault directory path

pub fn add_version( &mut self, model_name: &str, file_path: &str, format: &str, size_bytes: u64, compressed_size_bytes: u64, checksum: &str, metadata: Option<HashMap<String, String>>, parent_version: Option<u32>, ) -> Result<ModelVersion>

Add new model version

pub fn get_version( &self, model_name: &str, version: Option<u32>, ) -> Option<&ModelVersion>

Get specific model version

pub fn list_versions(&self, model_name: &str) -> Vec<&ModelVersion>

List all versions of a model

pub fn get_lineage(&self, model_name: &str, version: u32) -> Vec<&ModelVersion>

Get complete lineage/generation history for a version

pub fn delete_version(&mut self, model_name: &str, version: u32) -> Result<bool>

Delete a specific version

pub fn cleanup_old_versions( &mut self, model_name: &str, keep_count: usize, ) -> Result<Vec<u32>>

Clean up old versions, keeping only the most recent

pub fn verify_checksum( &self, model_name: &str, version: u32, data: &[u8], ) -> bool

Verify data integrity using stored checksum

pub fn update_metadata( &mut self, model_name: &str, version: u32, key: &str, value: String, ) -> Result<()>

Update metadata for a specific model version

pub fn get_metadata( &self, model_name: &str, version: u32, key: &str, ) -> Option<String>

Get metadata for a specific model version

pub fn list_models_owned(&self) -> Vec<String>

Return an owned list of model names (useful when the caller needs ownership, e.g. for export/import operations).

pub fn import_version( &mut self, model_name: &str, version: ModelVersion, ) -> Result<()>

Import a pre-built ModelVersion for a model — used during vault bundle import to transplant versions from another vault.

Trait Implementations

impl VersionRepo for VersionControl

fn add_version( &mut self, model: &str, file_path: &str, format: &str, size_bytes: u64, compressed_size_bytes: u64, checksum: &str, metadata: Option<HashMap<String, String>>, parent_version: Option<u32>, ) -> Result<ModelVersion>

Add a new version for a model.

fn get_version( &self, model: &str, version: Option<u32>, ) -> Option<&ModelVersion>

Get a specific version, or the latest if version is None.

fn list_versions(&self, model: &str) -> Vec<&ModelVersion>

List all versions of a model, sorted by version number.

fn get_lineage(&self, model: &str, version: u32) -> Vec<&ModelVersion>

Get the lineage chain for a version.

fn delete_version(&mut self, model: &str, version: u32) -> Result<bool>

Delete a specific version. Returns true if it existed.

fn cleanup_old_versions( &mut self, model: &str, keep_count: usize, ) -> Result<Vec<u32>>

Clean up old versions, keeping keep_count most recent.

fn verify_checksum(&self, model: &str, version: u32, data: &[u8]) -> bool

Verify data checksum against stored checksum.

fn update_metadata( &mut self, model: &str, version: u32, key: &str, value: String, ) -> Result<()>

Update metadata for a version.

fn get_metadata(&self, model: &str, version: u32, key: &str) -> Option<String>

Get metadata for a version.

fn list_models(&self) -> Vec<String>

List all model names.