Struct WorktreeManager 

pub struct WorktreeManager { /* private fields */ }

Worktree manager for parallel execution

Implementations

impl WorktreeManager

pub fn new_with_discovery( worktree_base_name: Option<&str>, max_concurrency: usize, ) -> Result<Self>

Create a new WorktreeManager with automatic Git repository discovery

This is the recommended constructor. It automatically discovers the Git repository root from the current directory, even if running from a subdirectory.

Arguments

• worktree_base_name - Name of the worktree base directory (default: “.worktrees”)
• max_concurrency - Maximum number of concurrent worktrees

Examples

use miyabi_worktree::WorktreeManager;

// Works from any subdirectory within a Git repository
let manager = WorktreeManager::new_with_discovery(Some(".worktrees"), 3)?;

pub fn new( repo_path: impl AsRef<Path>, worktree_base: impl AsRef<Path>, max_concurrency: usize, ) -> Result<Self>

Create a new WorktreeManager

Arguments

• repo_path - Path to the main repository
• worktree_base - Base directory for worktrees
• max_concurrency - Maximum number of concurrent worktrees

Note

Consider using new_with_discovery() instead, which automatically finds the Git repository root even when running from a subdirectory.

pub async fn create_worktree(&self, issue_number: u64) -> Result<WorktreeInfo>

Create a new worktree for an issue

Returns the path to the created worktree

pub async fn remove_worktree(&self, worktree_id: &str) -> Result<()>

Remove worktree after task completion with safety checks

This method implements the safe worktree deletion protocol:

1. Check if current directory is inside the worktree to be deleted
2. If yes, change to repository root first
3. Verify worktree exists
4. Execute git worktree remove
5. Run git worktree prune

This prevents “Unable to read current working directory” errors that occur when deleting a worktree while the shell is inside it.

pub async fn push_worktree(&self, worktree_id: &str) -> Result<()>

Push worktree changes to remote

pub async fn merge_worktree(&self, worktree_id: &str) -> Result<()>

Merge worktree branch into main

pub async fn update_status( &self, worktree_id: &str, status: WorktreeStatus, ) -> Result<()>

Update worktree status

pub async fn get_worktree(&self, worktree_id: &str) -> Result<WorktreeInfo>

Get worktree information

pub async fn list_worktrees(&self) -> Vec<WorktreeInfo>

List all worktrees

pub async fn stats(&self) -> WorktreeStats

Get worktree statistics

pub async fn cleanup_all(&self) -> Result<()>

Cleanup all worktrees

pub async fn telemetry_report(&self) -> String

Get telemetry report (human-readable)

pub async fn telemetry_stats(&self) -> TelemetryStats

Get telemetry statistics

Trait Implementations

impl Clone for WorktreeManager

fn clone(&self) -> WorktreeManager

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.