Struct GitLayer 

pub struct GitLayer { /* private fields */ }

Git-based version control layer.

Uses gix for in-process git operations — no subprocess spawning, no performance overhead of forking git CLI commands.

Implementations

impl GitLayer

pub fn new(root: PathBuf, enabled: bool) -> Result<Self>

Create a new GitLayer, initializing a repo if needed.

pub fn commit_file(&self, rel_path: &str, message: &str) -> Result<CommitInfo>

Commit a single file with a message (backward-compatible).

pub fn commit_file_with( &self, rel_path: &str, message: &str, ctx: CommitContext, ) -> Result<CommitInfo>

Commit a single file with a message and explicit commit context.

pub fn commit_files( &self, rel_paths: &[&str], message: &str, ) -> Result<CommitInfo>

Commit multiple files in a single commit (backward-compatible).

pub fn commit_files_with( &self, rel_paths: &[&str], message: &str, ctx: CommitContext, ) -> Result<CommitInfo>

Commit multiple files with a message and explicit commit context.

pub fn remove_file(&self, rel_path: &str, message: &str) -> Result<CommitInfo>

Remove a file from the repo and commit.

pub fn log_action( &self, agent: &str, action: &str, target: &str, allowed: bool, detail: Option<&str>, ) -> Result<()>

Append an audit entry to a monthly audit log file and commit it.

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

Create an annotated tag at the current HEAD.

pub fn list_tags(&self) -> Result<Vec<String>>

List all tags in the repository.

Uses Category::Tag to correctly filter only tag refs.

pub fn log(&self, max_count: usize) -> Result<Vec<LogEntry>>

Return commit log entries, most recent first.

pub fn resolve_partial_hash(&self, partial: &str) -> Result<ObjectId>

Resolve a partial commit hash to full ObjectId.

pub fn restore_file(&self, rel_path: &str, hash: &str) -> Result<()>

Restore a file to its state in a specific commit.

Supports nested paths like audit/2024-05.audit by traversing each path component through sub-trees.

pub fn diff_commits(&self, from_hash: &str, to_hash: &str) -> Result<CommitDiff>

Compute the diff between two commits.

pub fn file_at_commit(&self, rel_path: &str, hash: &str) -> Result<Vec<u8>>

Retrieve file content as it was at a specific commit.

pub fn verify(&self) -> Result<bool>

Verify repository integrity.

pub fn is_enabled(&self) -> bool

Whether auto-commit is enabled.

pub fn root(&self) -> &Path

Get the root path of this git repository.

Trait Implementations

impl MemoryGit for GitLayer

fn commit_file<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, path: &'life1 str, message: &'life2 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Commit a file to git.

fn is_enabled(&self) -> bool

Whether git integration is enabled.