Struct VersionControl 

pub struct VersionControl<S: BlockStore> { /* private fields */ }

Version Control System for managing commits, branches, and tags

Implementations

impl<S: BlockStore> VersionControl<S>

pub fn new(store: Arc<S>) -> Self

Create a new version control system

pub fn list_refs(&self) -> Vec<(String, Cid)>

List all refs

pub async fn commit( &self, root: Cid, message: String, author: Author, metadata: HashMap<String, String>, ) -> Result<Cid>

Create a new commit

Arguments

• root - CID of the root block (e.g., model weights)
• message - Commit message
• author - Author information
• metadata - Optional metadata

pub async fn checkout(&self, commit_cid: &Cid) -> Result<Cid>

Checkout to a specific commit

Returns the root CID of the commit (e.g., model weights to load)

pub async fn checkout_ref(&self, ref_name: &str) -> Result<Cid>

Checkout to a branch or tag

pub async fn create_branch(&self, branch_name: &str) -> Result<()>

Create a new branch at the current HEAD

pub async fn create_tag(&self, tag_name: &str) -> Result<()>

Create a new tag at the current HEAD

pub fn head(&self) -> Option<Cid>

Get the current HEAD commit CID

pub fn current_branch(&self) -> String

Get the current branch name

pub async fn log(&self, commit_cid: &Cid, limit: usize) -> Result<Vec<Commit>>

Get commit history (walk the DAG backwards)

pub fn store(&self) -> &Arc<S>

Get the underlying store

pub async fn find_common_ancestor( &self, commit1: &Cid, commit2: &Cid, ) -> Result<Option<Cid>>

Find common ancestor between two commits

pub async fn is_ancestor( &self, ancestor: &Cid, descendant: &Cid, ) -> Result<bool>

Check if commit1 is an ancestor of commit2 (i.e., fast-forward is possible)

pub async fn merge( &self, branch_cid: &Cid, message: String, author: Author, strategy: MergeStrategy, ) -> Result<MergeResult>

Merge a branch into the current HEAD

Arguments

• branch_cid - The commit CID to merge into current HEAD
• message - Merge commit message
• author - Author of the merge commit
• strategy - Merge strategy to use

pub async fn merge_branch( &self, branch_name: &str, message: String, author: Author, strategy: MergeStrategy, ) -> Result<MergeResult>

Merge a named branch into current HEAD