Struct VersionResolutionService 

pub struct VersionResolutionService { /* private fields */ }

Service for version resolution and worktree management.

Provides high-level orchestration for version constraint resolution, SHA resolution, and worktree preparation for Git-backed dependencies.

Implementations

impl VersionResolutionService

pub fn new(cache: Cache) -> Self

Create a new version resolution service with default concurrency.

pub fn with_concurrency(cache: Cache, max_concurrency: usize) -> Self

Create a new version resolution service with explicit concurrency limit.

pub async fn pre_sync_sources( &self, core: &ResolutionCore, deps: &[(String, ResourceDependency)], progress: Option<Arc<MultiPhaseProgress>>, ) -> Result<()>

Pre-sync all source repositories needed for dependencies.

This performs all Git network operations upfront:

1. Clone/fetch source repositories
2. Resolve version constraints to commit SHAs
3. Create worktrees for resolved commits

Arguments

• core - The resolution core with cache and source manager
• deps - All dependencies that need sources synced
• progress - Optional progress tracker for UI updates

pub fn get_prepared_version( &self, group_key: &str, ) -> Option<PreparedSourceVersion>

Get a prepared version by source and version.

Arguments

• group_key - The key in format “source::version”

Returns

The prepared version info with worktree path and resolved commit (if Ready)

pub fn prepared_versions(&self) -> &Arc<DashMap<String, PreparedVersionState>>

Get the prepared versions map (raw state).

Returns a reference to the DashMap of prepared source version states. Most callers should use prepared_versions_ready() instead.

pub fn prepared_versions_arc( &self, ) -> Arc<DashMap<String, PreparedVersionState>>

Get a clone of the prepared versions map Arc (raw state).

Returns a cloned Arc to the DashMap of prepared source version states. Most callers should use prepared_versions_ready_arc() instead.

pub fn prepared_versions_ready( &self, ) -> Arc<DashMap<String, PreparedSourceVersion>>

Get a snapshot of only the Ready prepared versions.

Creates a new DashMap containing only versions that are Ready (not Preparing). This is safe for use by other code that doesn’t need to participate in the synchronization protocol.

pub fn prepared_versions_ready_arc( &self, ) -> Arc<DashMap<String, PreparedSourceVersion>>

Get a snapshot Arc of only the Ready prepared versions.

Alias for prepared_versions_ready() for compatibility.

pub async fn get_or_prepare_version( &self, core: &ResolutionCore, source_name: &str, version: Option<&str>, ) -> Result<PreparedSourceVersion>

Get or prepare a version, coordinating concurrent requests.

This method ensures that only one task prepares a given version at a time. Other tasks requesting the same version will wait for the first task to complete. This prevents the race condition where multiple tasks simultaneously try to prepare the same version.

Arguments

• core - The resolution core with cache and source manager
• source_name - Name of the source repository
• version - Optional version constraint (None = HEAD)

Returns

The prepared version info with worktree path and resolved commit

pub async fn prepare_additional_version( &self, core: &ResolutionCore, source_name: &str, version: Option<&str>, ) -> Result<()>

Prepare an additional version on-demand without clearing existing ones.

This is a convenience wrapper around get_or_prepare_version that discards the result. Prefer using get_or_prepare_version directly when you need the prepared version info.

Arguments

• core - The resolution core with cache and source manager
• source_name - Name of the source repository
• version - Optional version constraint (None = HEAD)

pub async fn get_available_versions( _core: &ResolutionCore, repo_path: &Path, ) -> Result<Vec<String>>

Get available versions (tags/branches) for a repository.

Arguments

• core - The resolution core with cache
• repo_path - Path to bare repository

Returns

List of available version strings

pub fn get_bare_repo_path(&self, source: &str) -> Option<PathBuf>

Get the bare repository path for a source.

Returns None if the source hasn’t been synced yet.

Arguments

• source - Name of the source repository