Module git_helpers 

Git Helper Functions

Provides git hooks management, a git wrapper for blocking commits during the agent phase, and basic repository utilities.

All git operations use libgit2 directly - no git CLI required.

Module Structure

• hooks - Git hooks installation and removal
• identity - Git identity resolution with comprehensive fallback chain
• repo - Basic git repository operations (add, commit, snapshot)
• start_commit - Starting commit tracking for incremental diffs
• review_baseline - Per-review-cycle baseline tracking
• wrapper - Agent phase git wrapper for safe concurrent execution
• branch - Branch detection and default branch resolution
• rebase - Rebase operations with fault tolerance

Re-exports

pub use branch::get_default_branch;

pub use branch::is_main_or_master_branch;

Modules

branch

Git branch detection and default branch resolution.

identity

Git identity resolution with fallback chain.

Structs

DiffReviewContent

The result of diff truncation for review purposes.

GitHelpers

Git helper state.

Enums

CommitResultFallback

Result of commit operation with fallback.

DiffTruncationLevel

The level of truncation applied to a diff for review.

RebaseErrorKind

Detailed classification of rebase failure modes.

RebaseResult

Result of a rebase operation.

ReviewBaseline

StartPoint

Functions

abort_rebase

Abort the current rebase operation.

cleanup_agent_phase_silent

Best-effort cleanup for unexpected exits (Ctrl+C, early-return, panics).

cleanup_orphaned_marker

Clean up orphaned .no_agent_commit marker.

cleanup_orphaned_marker_with_workspace

Clean up orphaned marker file using workspace abstraction.

continue_rebase

Continue a rebase after conflict resolution.

create_marker_with_workspace

Create the agent phase marker file using workspace abstraction.

disable_git_wrapper

Disable git wrapper.

end_agent_phase

End agent phase (removes marker file).

get_baseline_summary

Get a summary of the baseline state for display.

get_conflict_markers_for_file

Extract conflict markers from a file.

get_conflicted_files

Get a list of files that have merge conflicts.

get_current_head_oid

Get the current HEAD commit OID.

get_git_diff_for_review_with_workspace

Get the diff content that should be shown to reviewers.

get_git_diff_from_start

Get the git diff from the starting commit.

get_git_diff_from_start_with_workspace

Get the git diff from the starting commit (workspace-aware).

get_repo_root

Get the git repository root.

get_review_baseline_info

Get review baseline info: (baseline_oid, commits_since, is_stale).

get_start_commit_summary

Get a summary of the start commit state for display.

git_add_all

Stage all changes.

git_add_all_in_repo

Stage all changes in the repository discovered from repo_root.

git_commit

Create a commit.

git_commit_in_repo

Create a commit in the repository discovered from repo_root.

git_diff

Get the diff of all changes (unstaged and staged).

git_diff_from

Generate a diff from a specific starting commit.

git_snapshot

Get a snapshot of the current git status.

load_review_baseline

Load the review baseline from the working directory.

load_start_point

Load the starting commit OID from the file.

marker_exists_with_workspace

Check if the agent phase marker file exists using workspace abstraction.

rebase_in_progress

Check if a rebase is currently in progress.

rebase_onto

Perform a rebase onto the specified upstream branch.

remove_marker_with_workspace

Remove the agent phase marker file using workspace abstraction.

require_git_repo

Check if we’re in a git repository.

reset_start_commit

Reset the starting commit to merge-base with the default branch.

save_start_commit

Save the current HEAD commit as the starting commit.

save_start_commit_with_workspace

Save start commit using workspace abstraction.

start_agent_phase

Start agent phase (creates marker file, installs hooks, enables wrapper).

uninstall_hooks

Uninstall all Ralph-managed hooks.

update_review_baseline

Update the review baseline to the current HEAD.

update_review_baseline_with_workspace

Update the review baseline using the workspace abstraction.