Struct SnapshotRepo 

pub struct SnapshotRepo { /* private fields */ }

Wrapper around the per-workspace side-git repo.

Implementations

impl SnapshotRepo

pub fn open_or_init(workspace: &Path) -> Result<SnapshotRepo, Error>

Open or initialize the snapshot repo for workspace.

Uses DEFAULT_SNAPSHOT_MAX_WORKSPACE_GB. Prefer Self::open_or_init_with_max_gb when config supplies a limit.

pub fn open_or_init_with_max_gb( workspace: &Path, max_workspace_gb: f64, ) -> Result<SnapshotRepo, Error>

Open or initialize the snapshot repo, skipping side-git init when the workspace on-disk size exceeds max_workspace_gb.

pub fn snapshot(&self, label: &str) -> Result<SnapshotId, Error>

Take a snapshot of the current working tree.

Internally: git add -A, git write-tree, git commit-tree, then git update-ref HEAD <commit>. git add -A honours the user’s workspace ignore rules while staging into the side repo’s index.

Returns the snapshot’s commit SHA.

pub fn restore(&self, id: &SnapshotId) -> Result<(), Error>

Restore the workspace to the state at id.

Uses git checkout <sha> -- :/ which checks out every path in the snapshot tree relative to the workspace root. We do NOT touch the user’s own .git — snapshots only contain working-tree files.

pub fn list(&self, limit: usize) -> Result<Vec<Snapshot>, Error>

List up to limit most-recent snapshots, newest first.

pub fn prune_older_than(&self, max_age: Duration) -> Result<usize, Error>

Drop snapshots older than max_age, returning the count removed.

Strategy: identify keepable commits (younger than the cutoff), reset HEAD to the oldest survivor, then git reflog expire + git gc --prune=now to actually reclaim space. Cheap and avoids rewriting history when nothing has aged out.

pub fn git_dir(&self) -> &Path

Return the side-repo’s .git directory (for diagnostics).

pub fn work_tree(&self) -> &Path

Return the work tree path (for diagnostics).