Preview and Apply

Preview snapshot

Preview records the canonical plan, exact mappings, normalized scope, adapters, occurrences, candidate file hashes, source and target identities, project fingerprint, and PreviewHash. Changing a mapping, scope, selected occurrence, candidate file, identity, or relevant project state invalidates Apply.

Dependency data narrows candidate assets. An adapter must then prove each occurrence through a structured Unity API. Dependency information alone never authorizes a change.

Preview and Apply stay incremental on editor updates. The footer reports the current phase, completed and total work, elapsed time, and a cancellable progress bar; Apply cancellation transitions into verified rollback.

Blocking findings

Apply is disabled for duplicate sources, self-maps, missing targets, incompatible types, unstable identities, dirty included scenes or Prefab Stages, read-only files, missing scripts, unsupported schemas, unavailable required adapters, or adapter exceptions.

Use Save or Exclude for dirty content. Use Ping and Open to inspect a finding. Rerun Preview after resolving it.

Transaction

Apply requires explicit confirmation. It acquires an exclusive lock and writes atomic journal states: Prepared, Applying, Verifying, and Completed. Cancellation or failure moves through verified rollback states.

Every changed asset and existing .meta is copied under Library/KiwiStudios/AssetSwap/Transactions/<transaction-id> before mutation. Addressables settings are included when an integration must add a target entry.

Verification

Every selected location is reopened through its adapter. Success requires the exact target identity and rejects any remaining selected source. A partial transaction never reports success.