Reference

Changelog

User-visible release history for cargo-warm.

0.3.2 - 2026-08-29

Prefer exact-revision warm worktrees before paying for nearby-branch Git graph ranking, which makes the common new-worktree-from-main path much cheaper.
Run Cargo/rustc compatibility probes concurrently and resolve configured Cargo manifests in parallel while preserving lockfile cleanup semantics.
Resolve the destination manifest set while automatic warm-source selection runs, reducing worktree provisioning preflight without removing any compatibility or quiescence checks.
Keep parallel metadata calls safe when several configured manifests belong to the same workspace and Cargo.lock is intentionally absent.

Replace the macOS cache-tree copy loop with the native APFS clonefile() path through a safe Rust reflink wrapper, retaining the parallel metadata-preserving clone implementation as a fallback.
Clone independent Cargo cache roots concurrently and add orthogonal clone-pressure = "auto|gentle|fast|max" plus clone-workers = N project/CLI tuning.
Add cargo warm seed --timings for phase-level worktree-startup benchmarking and extend doctor with clone-root/worker diagnostics.
Pipeline cached build-script analysis alongside filesystem cloning, parallelize tracked-file byte proof, and eliminate redundant Cargo-cache traversals during freshness rebasing.
Automatic source selection now requires actual seedable warm state instead of falling back to a compatible but cold worktree.

Add built-in quick, balanced, and deep startup profiles plus project-defined inherited profiles.
Add project configuration at .agents/.cargo-warm.toml; configured manifests and stable-toolchain bootstrap settings are shared by seed, doctor, path, and check.
Expand cargo warm doctor into a project advisor: it now works before a second worktree exists, recommends profiles, reports cache pressure and Cargo build-directory shape, and prints a starter project config.
Make doctor --probe use the same ordinary or relocatable compiler family as the selected profile instead of probing a different build mode.
Avoid repeated manifest/source preflight work during automatic source selection, and keep the tracked-file byte proof on the mutating freshness path instead of reading every eligible file twice.
Pass rustc version/capability probes through the workspace wrapper unchanged; relocatable settings now apply only to actual crate compilations.
Rewrite the public README/docs around setup, profiles, diagnostics, hooks, and architecture, and replace the landing page with a workflow-focused product overview.

Strengthen opt-in priming so it can re-establish the selected direct package’s build-script fingerprint boundary before the first edit.
Keep path-dependency build scripts out of that stronger prime so unrelated native toolchains are not awakened merely because they are dependencies.
Preserve exact source timestamps around priming and keep a successfully forked private cache usable even when the optional prime fails.

Add safe freshness synchronization for clean equivalent worktree inputs.
Add relocatable incremental cargo warm check support for Rust 1.98+.
Add opt-in provisioning prime support.
Rank nearby compatible worktrees automatically instead of assuming one fixed source branch.
Discover common path-bearing native link outputs and fork final link artifacts without copying opaque compiler caches.
Add cargo warm doctor diagnostics and Cargo fingerprint probes.
Preserve repositories that intentionally do not commit Cargo.lock.

Fork warm Cargo build state into a destination worktree’s private cache.
Use APFS clone-on-write on macOS and filesystem reflinks on Linux.
Support automatic or explicit warm-source worktrees.
Support several Cargo workspaces through repeated manifests.
Refuse shared mutable cache paths, incompatible toolchains, and active compiler state.
Track cargo-warm-owned cache roots for conservative cleanup.