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.

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

Commit multiple files in a single commit.

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.

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.

Git allows abbreviating commit hashes (e.g., “abc1234”) as long as they’re unique within the repository. This method uses rev_parse_single to resolve partial hashes to full commit IDs.

Arguments

• partial - A partial hash (4-40 hex characters)

Returns

The resolved ObjectId or error if the hash cannot be resolved.

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

Restore a file to its state in a specific commit.

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

Verify repository integrity.

pub fn is_enabled(&self) -> bool

Whether auto-commit is enabled.