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 delete_tag(&self, name: &str) -> Result<()>

Delete a tag by name. Fails if the tag does not exist.

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 file_at_commit(&self, rel_path: &str, hash: &str) -> Result<Vec<u8>>

Read a file’s content at a specific commit without writing to disk.

Unlike [restore_file], this does NOT touch the filesystem — it returns the blob data directly. Callers that need to write the content should pass it through KnowledgeBase::note_restore, which acquires the VirtualFs write lock. This avoids a race where restore_file’s direct std::fs::write bypasses the lock and clobbers a concurrent note_write (I-4).

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

Return commit log entries for a specific file, most recent first.

Walks the commit graph and includes only commits where the file’s blob OID actually changed (tree diff, not message string matching). Replaces the old approach of filtering log(N) by commit message substring, which was inaccurate and limited to N entries.

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

Compute the diff between two commits.

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.