Struct StateLock 

pub struct StateLock { /* private fields */ }

An acquired state lock. The underlying file descriptor holds an exclusive flock; releasing happens automatically on drop (fd close).

The lock file is intentionally never unlinked — doing so during acquisition would allow two processes to each hold flock on different inodes.

Implementations

impl StateLock

pub fn acquire(lock_path: &Path, timeout_ms: u64) -> Result<Self, WorktreeError>

Acquire the state lock with full-jitter exponential backoff.

Backoff: sleep_ms = random(0, min(2000, 10 * 2^attempt)), capped at 15 attempts (~30s worst case).

Correctness: mutual exclusion is provided by the OS flock primitive, which auto-releases when the holding process dies. The payload in the lock file is informational (helps humans see who holds the lock). We never unlink the lock file during acquisition — that would create a two-inode race where two processes each hold flock on a different inode.

pub fn path(&self) -> &Path

Return the lock file path (for diagnostics).

pub fn uuid(&self) -> &str

Return the lock’s UUID (for diagnostics).