Module wrapper 

Git wrapper for blocking commits during agent phase.

This module provides safety mechanisms to prevent accidental commits while an AI agent is actively modifying files. It works through two mechanisms:

• Marker file: Creates <git-dir>/ralph/no_agent_commit during agent execution. Both the git wrapper and hooks check for this file.
• PATH wrapper: Installs a temporary git wrapper script that intercepts commit, push, and tag commands when the marker file exists.

All enforcement state files live inside the git metadata directory (<git-dir>/ralph/) so they are invisible to working-tree scans and cannot be confused with product code.

The wrapper is automatically cleaned up when the agent phase ends, even on unexpected exits (Ctrl+C, panics) via cleanup_agent_phase_silent.

Module structure

This module is split into focused submodules:

• marker — marker file creation and repair
• path_wrapper — PATH wrapper directory management
• [script] — wrapper shell script generation
• phase — agent phase lifecycle and self-healing checks
• cleanup — cleanup utilities

Re-exports

pub use super::phase::ProtectionCheckResult;

Structs

GitHelpers

Functions

capture_head_oid

cleanup_agent_phase_protections_silent_at

cleanup_agent_phase_silent

cleanup_agent_phase_silent_at

cleanup_orphaned_marker

cleanup_orphaned_marker_with_workspace

cleanup_orphaned_wrapper_at

clear_agent_phase_global_state

create_marker_with_workspace

detect_unauthorized_commit

disable_git_wrapper

end_agent_phase

end_agent_phase_in_repo

ensure_agent_phase_protections

marker_exists_with_workspace

remove_marker_with_workspace

start_agent_phase

start_agent_phase_in_repo

try_remove_ralph_dir

verify_ralph_dir_removed

verify_wrapper_cleaned