Struct WorktreeGuard 

pub struct WorktreeGuard { /* private fields */ }

RAII guard that manages a git worktree’s lifecycle.

On construction: creates a worktree, installs dependencies, runs tsc. On drop: removes the worktree (even on panic or early return).

Implements WorktreeAccess so it can be wrapped in Arc and shared between TD and SD pipelines via std::sync::mpsc::channel.

Implementations

impl WorktreeGuard

pub fn new( repo: &Path, git_ref: &str, build_command: Option<&str>, ) -> Result<Self, WorktreeError>

Create a new worktree for the given git ref, install dependencies, and run tsc --declaration.

This is the primary entry point. It performs the full worktree lifecycle:

1. Validate the repo and ref
2. Create the worktree via git worktree add
3. Detect and run the package manager install
4. Run tsc --declaration --emitDeclarationOnly
5. If tsc fails partially, try the project build as a fallback

An optional build_command can be provided to customize the build step. If not provided and tsc fails, the project’s build script is tried.

On any failure, the worktree is cleaned up before the error propagates.

pub fn create_only(repo: &Path, git_ref: &str) -> Result<Self, WorktreeError>

Create a worktree without installing dependencies or running tsc.

This is useful for testing the RAII cleanup behavior, and as a building block for new().

pub fn warnings(&self) -> &[ExtractionWarning]

Non-fatal issues encountered during worktree setup.

The caller should inspect these after a successful new() and record them on the DegradationTracker for the end-of-run summary.

pub fn path(&self) -> &Path

Path to the worktree directory.

pub fn git_ref(&self) -> &str

The git ref this worktree was created for.

pub fn cleanup_stale(repo: &Path) -> Result<usize, WorktreeError>

Scan for and remove stale worktrees from previous crashed runs.

Looks in <tmp>/semver-worktrees/<repo-hash>/ for any existing directories and attempts to clean them up via git worktree remove.

Trait Implementations

impl Drop for WorktreeGuard

fn drop(&mut self)

Executes the destructor for this type.

impl WorktreeAccess for WorktreeGuard

fn path(&self) -> &Path

Filesystem path to the worktree directory.