works.iterative.claude.zio.log

Copies a resolved vendor session tree into the installation's kept directory. Each file is planned by size, then copied, extended in place, refreshed, or skipped; a per-file failure is recorded rather than aborting the run. Symlinks are never followed, and the kept directories are restricted to the owner.

The kept directory is claimed for its installation before anything is kept there: its key is lossy, so a directory another installation holds is refused with ArchiveError.InstallationKeyTaken and the two are never merged.

A vendor tree can be pruned in the gap between resolving a session's path and actually reading it. The read then fails because the file no longer exists; these helpers re-resolve the session once and retry against whatever root now wins, so a live prune degrades to the mirror instead of an opaque I/O error. A second failure is surfaced as-is: one retry only.