Struct GitEngine 

pub struct GitEngine { /* private fields */ }

An embedded git engine bound to one repository.

Implementations

impl GitEngine

pub fn open(root: &Path) -> Result<Self, GitError>

Discover and open the repository containing root (walks up for .git).

pub fn status(&self, caps: &GitCaveats) -> Result<StatusReport, GitError>

git status — requires the read capability.

pub fn log( &self, caps: &GitCaveats, limit: usize, ) -> Result<Vec<CommitInfo>, GitError>

git log — a first-parent walk from HEAD, up to limit commits. Requires read.

pub fn diff( &self, caps: &GitCaveats, spec: DiffSpec, ) -> Result<DiffReport, GitError>

git diff for the given spec. Requires read.

pub fn add( &self, caps: &GitCaveats, paths: &[String], ) -> Result<Vec<String>, GitError>

git add — stage worktree files into the index. Requires stage. Each path is repository-relative. Returns the paths actually staged.

pub fn commit( &self, caps: &GitCaveats, message: &str, author: &Author, ) -> Result<CommitInfo, GitError>

git commit — build a tree from the index, write the commit, and advance the current branch. Requires commit_local. Errors on detached HEAD.

pub fn amend( &self, caps: &GitCaveats, message: Option<&str>, author: &Author, ) -> Result<CommitInfo, GitError>

git commit --amend — replace HEAD with a new commit carrying the current index tree, keeping HEAD’s PARENTS (not HEAD itself). message None reuses HEAD’s existing message (amend-to-add-files); Some rewords it. Requires commit_local. Errors on an unborn / detached HEAD.

pub fn rebase( &self, caps: &GitCaveats, onto: &str, steps: &[RebaseStep], author: &Author, ) -> Result<RebaseReport, GitError>

Structured-plan rebase: replay steps (in order) onto onto, applying pick / reword / squash / fixup / drop. All new trees and commits are written to the ODB; the branch ref is advanced only at the very end, so a conflict (or any error) aborts with the branch unchanged — no working-tree, index, or ref side effects. Requires commit_local.

Cherry-pick per step is a 3-way tree merge with MergeFavor::None so real conflicts are reported (not silently resolved). Authorship on the produced commits is the agent’s (the typical case: rewriting its own recent history). Root commits (no parent) cannot be replayed.

pub fn branch(&self, caps: &GitCaveats, name: &str) -> Result<String, GitError>

git branch <name> — create refs/heads/<name> at the current HEAD commit. Requires refs to permit that ref name. Returns the full ref name.

pub fn checkout( &self, caps: &GitCaveats, name: &str, create: bool, ) -> Result<String, GitError>

git checkout [-b] <name> — point HEAD at branch <name>, creating it at the current commit first when create is set (the -b case the model reaches for). Requires refs to permit the branch ref.

newt is local-only and has no working-tree updater, so this only moves HEAD when the target branch is at the SAME commit as the current HEAD (always true for a freshly-created branch). Switching to a branch at a different commit is refused rather than silently leaving the worktree stale — no side effects on refusal.

pub fn branch_delete( &self, caps: &GitCaveats, name: &str, ) -> Result<String, GitError>

git branch -d <name> — delete refs/heads/<name>. Requires refs to permit the ref. Refuses to delete the branch HEAD is currently on, or a branch that does not exist (no side effects on refusal).