Struct GitAdapter 

pub struct GitAdapter { /* private fields */ }

Git adapter implementing branch-based workflow

Features:

• Automatic feature branch creation
• Git commit with PR metadata
• Push to remote
• GitHub/GitLab PR creation via gh/glab CLI

Implementations

impl GitAdapter

pub const BUILTIN_LOCK_FILES: &'static [&'static str]

Built-in lock files that are always auto-staged when modified (v0.14.3.7).

These are deterministic outputs of the build process — when a version bump or dependency change occurs, the lock file regenerates and must be committed together with the source change to keep the tree self-consistent.

pub fn new(work_dir: impl Into<PathBuf>) -> Self

Create a new GitAdapter for the given working directory

pub fn with_config(work_dir: impl Into<PathBuf>, config: SubmitConfig) -> Self

Create a new GitAdapter with explicit configuration

pub fn with_full_config( work_dir: impl Into<PathBuf>, config: SubmitConfig, sync_config: SyncConfig, ) -> Self

Create a new GitAdapter with submit and sync configuration

pub fn with_plan_file(self, plan_file: impl Into<String>) -> Self

Set the plan file name (relative to work_dir). Default: “PLAN.md”.

pub fn current_branch(&self) -> Result<String>

Get current branch name

pub fn detect(project_root: &Path) -> bool

Auto-detect whether this is a git repository.

Trait Implementations

impl SourceAdapter for GitAdapter

fn prepare(&self, goal: &GoalRun, config: &SubmitConfig) -> Result<()>

Create a working branch/changelist/workspace for this goal

fn commit( &self, goal: &GoalRun, pr: &DraftPackage, message: &str, ) -> Result<CommitResult>

Commit the approved changes from staging

fn push(&self, goal: &GoalRun) -> Result<PushResult>

Push the committed changes

fn open_review(&self, goal: &GoalRun, pr: &DraftPackage) -> Result<ReviewResult>

Open a review request

fn name(&self) -> &str

Adapter display name (for CLI output)

fn exclude_patterns(&self) -> Vec<String>

Patterns to exclude from staging copy (VCS metadata dirs, etc.)

fn sync_upstream(&self) -> Result<SyncResult>

Sync the local workspace with upstream changes.

fn save_state(&self) -> Result<Option<SavedVcsState>>

Save working state before apply operations.

fn restore_state(&self, state: Option<SavedVcsState>) -> Result<()>

Restore working state after apply operations.

fn current_branch(&self) -> Result<String>

Get the current branch or workspace name.

fn revision_id(&self) -> Result<String>

Get the current revision identifier for the working directory.

fn protected_submit_targets(&self) -> Vec<String>

Protected submit targets for this adapter (§15 VCS Submit Invariant).

fn verify_not_on_protected_target(&self) -> Result<()>

Assert the post-prepare() invariant: the adapter must not be positioned to commit directly to a protected target (§15).

fn stage_env( &self, staging_dir: &Path, config: &VcsAgentConfig, ) -> Result<HashMap<String, String>>

Produce environment variables to inject into the agent process so it operates on the staging directory instead of the developer’s real VCS workspace (v0.13.17.3).

fn check_review(&self, review_id: &str) -> Result<Option<ReviewStatus>>

Check the status of a review/PR by its review ID (e.g., PR number).

fn merge_review(&self, review_id: &str) -> Result<MergeResult>

Merge a review/PR into the target branch and sync the local workspace.

fn detect(project_root: &Path) -> bool

where Self: Sized,

Auto-detect whether this adapter applies to the given project root.