jackin-isolation

Mount isolation subsystem. Materializes per-workspace isolated git worktree mounts from the host repository into a container, inspects git state, and cleans up on teardown — the mechanism behind per-mount isolation.

What this crate owns

Mount materialization (materialize) from host repo into isolated worktrees, with branch/state tracking (branch, state).
Git inspection (git_inspect) for dirty/worktree state.
Finalization and cleanup (finalize, cleanup) on session teardown.

Architecture tier and allowed dependencies

Application/integration crate sitting between orchestration and the Docker/git substrate. Allowed production dependencies (inward only): jackin-core, jackin-config, jackin-diagnostics, jackin-protocol, jackin-docker, jackin-runtime. Must NOT depend on jackin-launch-tui or jackin-tui (presentation).

Structure

Module	Owns	Tests
`lib.rs`	crate root, re-exports	—
`materialize.rs` · `materialize/`	mount materialization	`tests.rs`
`branch.rs` · `branch/`	branch tracking	`tests.rs`
`state.rs` · `state/`	isolation-state tracking	`tests.rs`
`git_inspect.rs` · `git_inspect/`	git/worktree inspection	`tests.rs`
`finalize.rs` · `finalize/`	finalize	`tests.rs`
`cleanup.rs` · `cleanup/`	teardown/cleanup	`tests.rs`

Public API

Materialize/finalize/cleanup entry points consumed by jackin-runtime. Parallel materialization must partition by dependency/order group and host repo to avoid .git lock contention (tracked as a performance item in the code-health roadmap).

How to verify

cargo nextest run -p jackin-isolation
cargo clippy -p jackin-isolation --all-targets -- -D warnings