Adapter SDK

Implement IKiwiAssetSwapAdapter and let KiwiAssetSwapAdapterRegistry discover it through deterministic TypeCache ordering.

An adapter provides:

• a stable namespaced Id
• a human-readable DisplayName
• deterministic Priority and scan mode
• CanInspect without mutation
• Collect that emits exact structured occurrences
• Apply that changes only the supplied selected occurrences
• Verify that proves the source is gone and exact target is present

Use KiwiAssetSwapStructuredOwnerSession for scenes, prefabs, and persistent assets. Use KiwiAssetSwapStructuredReferenceUtility for Unity object-reference properties or an explicitly recognized GUID schema.

AssetPath is the canonical NFC project-relative path used in plans, previews, occurrences, receipts, stable IDs, and structured save destinations. Use RegisteredAssetPath from scan and apply contexts for Unity lookup, inspection, open, and import APIs. In CanInspect, resolve its path with KiwiAssetSwapPathUtility.ResolveRegisteredAssetPath before calling Unity. Built-in prefab sessions retain the canonical destination while loading through the registered spelling. This preserves deterministic evidence while remaining compatible with editor versions and filesystems that register canonically equivalent Unicode paths with different normalization forms.

Every occurrence needs a stable ID, mapping ID, adapter ID, project-relative asset path, stable owner ID, property path, exact source and target, state, diagnostic, and selection default.

Throwing or returning failure is safe: Asset Swap treats third-party adapter failure as blocking and rolls back any active transaction. Never swallow a schema mismatch or silently skip a previewed occurrence.

See the Adapter SDK Example sample for a known schema containing GUID plus 64-bit local file ID.