Struct SideRepo 

pub struct SideRepo {
    pub git_dir: PathBuf,
    pub work_tree: PathBuf,
    pub root_sha: String,
}

Represents a side repository for a project.

Fields

git_dir: PathBuf

Path to the bare git repository.

work_tree: PathBuf

Path to the work tree (the main project directory).

root_sha: String

The initial commit SHA of the main repo (project identifier).

Implementations

impl SideRepo

pub fn open() -> Result<Self>

Resolve or create a side repo for the current project.

Errors

Returns an error if not in a git repository or if config files cannot be accessed.

pub fn is_initialized(&self) -> bool

Check if the side repo has been initialized.

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

Initialize the side repo if not already done.

Errors

Returns an error if the directory cannot be created or git init fails.

pub fn git(&self, args: &[&str]) -> Result<String>

Run a git command in the context of the side repo.

Errors

Returns an error if the git command fails.

pub fn tracked_file(&self) -> PathBuf

Get the path to the .side-tracked file.

pub fn stage(&self, path: &Path) -> Result<()>

Stage a path (forced, bypassing gitignore).

Errors

Returns an error if initialization or staging fails.

pub fn stage_update(&self, paths: &[PathBuf])

Stage paths with update flag (handles modifications and deletions). Errors are ignored since paths may not be in the index yet.

pub fn stage_new(&self, paths: &[PathBuf]) -> Result<()>

Stage paths (adds new files).

Errors

Returns an error if initialization or staging fails.

pub fn commit(&self, message: &str) -> Result<()>

Commit staged changes.

Errors

Returns NothingToCommit if there are no staged changes, or an error if commit fails.

pub fn status(&self) -> Result<String>

Get status output.

Errors

Returns an error if the git status command fails.

pub fn log(&self, args: &[&str]) -> Result<String>

Get log output.

Errors

Returns an error if the git log command fails.

pub fn unstage(&self, path: &Path) -> Result<()>

Remove a path from the index (unstage).

Errors

Returns an error if the git rm command fails (though failures are typically ignored).

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

Force push to origin/main.

Errors

Returns an error if the push fails (e.g. no remote configured).

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

Stage the .side-tracked file using git plumbing. Since .side-tracked lives in git_dir (not work_tree), we use hash-object + update-index.

Errors

Returns an error if the file doesn’t exist or git commands fail.