Struct ShadowRepo 

pub struct ShadowRepo { /* private fields */ }

A shared shadow bare git repository for a workspace.

Per-session checkpoint chains live under refs/sessions/<sid>/HEAD.

Implementations

impl ShadowRepo

pub fn open(workspace: impl Into<PathBuf>) -> Result<Self>

Open or create the shadow repo for workspace. Idempotent. Returns an error if git is not on PATH.

pub fn open_at( workspace: impl Into<PathBuf>, shadow_dir: impl Into<PathBuf>, ) -> Result<Self>

Open or create a shadow repo with an explicit shadow_dir, bypassing paths::user_data_dir() resolution.

Used by tests so they don’t have to mutate RECURSIVE_HOME (and thus don’t need the cross-module env lock), letting checkpoint tests run in parallel. Production callers should stick to [open].

pub fn workspace(&self) -> &Path

The workspace this repo snapshots.

pub fn snapshot_for_session( &self, session_id: &str, message: &str, ) -> Result<CheckpointId>

Snapshot the current workspace state and advance refs/sessions/<session_id>/HEAD to the new commit.

Per-session temporary index files prevent concurrent snapshots from racing each other.

pub fn list_for_session(&self, session_id: &str) -> Result<Vec<CheckpointInfo>>

List checkpoints for session_id in reverse chronological order.

pub fn read_file_at( &self, checkpoint: &CheckpointId, path: &str, ) -> Result<Option<Vec<u8>>>

Read a single file’s contents at checkpoint. Returns Ok(None) if the file did not exist at that checkpoint.

pub fn restore_paths( &self, checkpoint: &CheckpointId, paths: &[String], ) -> Result<RestoreStats>

Restore only the given workspace-relative file paths to their state at checkpoint. Files not in paths remain untouched. Files present in the workspace but not in the checkpoint tree are deleted (when listed in paths).

pub fn diff( &self, a: &CheckpointId, b: Option<&CheckpointId>, paths: &[String], ) -> Result<String>

Diff between two checkpoints (or a vs current workspace if b is None), optionally limited to paths.

pub fn changed_paths( &self, a: &CheckpointId, b: &CheckpointId, ) -> Result<Vec<String>>

List file paths changed between checkpoints a and b. Used for “shell-diff” attribution after run_shell calls.

pub fn clean(&self) -> Result<()>

Drop the shadow repo entirely. Used by tests and clean UX.

Trait Implementations

impl Clone for ShadowRepo

fn clone(&self) -> ShadowRepo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ShadowRepo

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

Formats the value using the given formatter.