Canon Migration

• migrated_files: List of files that were transformed
• migration_log: Detailed log of changes made
• warnings: Any compatibility warnings

Migration Process

1. Version Detection: Read meta/PACK_INFO.json for source version
2. Migration Chain: Apply migrations in sequence (0.1 → 0.2 → 0.3 → ...)
3. Validation: Run fixtures to verify migrated pack
4. Manifest Update: Regenerate manifests with new hashes

Example Migrations

0.1.x → 0.2.x

• No structural changes required
• Update manifest version field

Future: 0.x → 1.0

• Evaluate invariant changes
• Apply file structure transformations
• Update token grammar if deprecated

Constraints

• Must not lose data during migration
• Must maintain referential integrity
• Must log all transformations

Fixtures

• fixtures/basic/ - Test migration from previous version
• fixtures/roundtrip/ - Verify data survives migration cycle

required_canon_version: >=3.0.0