orion-ecs / keen-eye / 20702724180

65%

Build Type

push

github

Committed by tyevco

Commit Message

feat: Add component version infrastructure for schema evolution

This implements the foundational infrastructure for component schema evolution
(Issue #697), enabling production games to migrate save files across component
schema changes.

Key changes:
- Add Version property to [Component] attribute (default: 1)
- Create ComponentVersionException for version mismatch detection
- Create ComponentMigrationMetadataGenerator to generate version lookup code
- Add Version property to SerializedComponent for serialized version tracking
- Update binary serialization format to v2 with component version field (int16)
- JSON serialization includes version via SerializedComponent.Version property
- Add GetVersion methods to IComponentSerializer interface
- Update generated ComponentSerializer to track component versions
- Version mismatch detection in SnapshotManager.RestoreSnapshot()

Binary format changes:
- Format version bumped to 2
- Component version (int16) written after isTag field
- Backward compatible: v1 files read with default version 1

This blocks #698 (migration attributes), #699 (migration execution),
#700 (default value injection), #701 (chain migrations), and #702 (tooling).

Coverage Stats

5370 of 6630 branches covered (81.0%)

Branch coverage included in aggregate %.

60 of 241 new or added lines in 7 files covered. (24.9%)

6 existing lines in 3 files now uncovered.

34532 of 44634 relevant lines covered (77.37%)

1.1 hits per line