Falling-Metal-Interactive/Blacksite
2
0
Fork 0
Code Issues 28 Pull Requests Actions Packages Projects Releases Wiki Activity
19c4d017dc
Blacksite/docs/adr/0006-scene-schema-versioning.md
Rbanh f29712d158
Some checks are pending
CI / Format, lint, test, build (push) Waiting to run
Details
Initial project import
2026-06-05 21:44:45 -04:00

602 B
Raw Blame History

ADR 0006: Scene Schema Versioning

Status

Accepted

Context

Levels under assets/levels/ need forward-compatible migrations as authoring components evolve (M5).

Decision

  • Track schema_version in scene files (wrapper or sidecar during transition).
  • Provide scene_schema module with migrate_scene_text and validate_level_file.
  • CI / xtask validate-levels loads all committed levels and fails on unknown versions.

Consequences

  • Breaking component changes require a migration step and version bump.
  • Editor save may wrap scenes with schema header in a follow-up change.