Struct ExternalVcsAdapter 

pub struct ExternalVcsAdapter { /* private fields */ }

SourceAdapter that delegates all operations to an external plugin process.

Implementations

impl ExternalVcsAdapter

pub fn new( manifest: &VcsPluginManifest, work_dir: impl Into<PathBuf>, ta_version: &str, ) -> Result<Self>

Create a new adapter and perform the initial handshake.

Returns SubmitError::ConfigError if the plugin is not found, the handshake fails, or protocol versions are incompatible.

pub fn detect_with_plugin( manifest: &VcsPluginManifest, project_root: &Path, ta_version: &str, ) -> bool

Auto-detect using the plugin’s detect method.

Trait Implementations

impl Debug for ExternalVcsAdapter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl SourceAdapter for ExternalVcsAdapter

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 sync_upstream(&self) -> Result<SyncResult>

Sync the local workspace with upstream changes.

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 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 revision_id(&self) -> Result<String>

Get the current revision identifier for the working directory.

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 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 current_branch(&self) -> Result<String>

Get the current branch or workspace name.

fn detect(project_root: &Path) -> bool

where Self: Sized,

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