Skip to content

Implement YAML versioning and migrations

Problem

Dashboard YAML files have no schema version marker, and the compiler has no mechanism to detect or migrate documents written against an older schema. When the YAML contract evolves (new fields, renamed keys, changed semantics), existing dashboards break silently at compile time or produce incorrect normalized output with no indication that a migration is needed. Users have no way to distinguish "my YAML is wrong" from "the schema changed and my file is outdated," making every contract change a potential breaking change for all existing dashboards.

Context

Possible Solutions

Plan

Implementation Progress

  • Confirm scope and acceptance with milestone owner.

  • Milestone readiness signal is updated.

  • Track blockers and mitigation owner.

Review Feedback

  • Review cleared