Not selected does not mean not ownedA background Session, another Host, SDK process, or shared profile can still own the only safe writer.

Choose the operation by intent.

Declutter the UIArchive through the Host

Serialized domain update. The event log and workspace slot remain durable.

Reclaim physical storageRun an offline migration

Stop every writer, snapshot all coordinated roots, then publish one no-overwrite trash generation.

Know which store owns truth.

JSONL logauthority
projectionderived
workspacedomain state

Do not reverse a lossy path.

Read the header

The normalized project directory cannot reconstruct the original cwd.

Keep generations

Never overwrite an older trash entry for the same Session ID.

Refuse collisions

Restore fails when the destination ID exists. Never merge event histories.

Six proof gates.

Primary evidence.

Preserve recovery before reclaiming bytes.

The canonical guide specifies storage authority, single-writer quiescence, whole-root snapshots, crash-safe trash generations, collision-free restore, purge gates, and eighteen manager acceptance checks.

Read the complete guide