docs(core): define compatibility retention policy

This commit is contained in:
2026-07-30 01:03:39 +02:00
parent 0beb9ffea9
commit 51d4032b86
5 changed files with 85 additions and 0 deletions

View File

@@ -69,6 +69,11 @@ Required package metadata:
- migration or transformation rules for older package versions
- provenance, export source metadata, and signature metadata
Portable configuration schemas follow `COMPATIBILITY_POLICY.md`: providers
write only their current schema version and read that version plus the previous
two versions. Older input must produce a version-specific staged-upgrade
diagnostic.
Configuration fragments are interpreted only by the module that owns them. For
example, workflow imports workflow definitions; forms imports form schemas;
mail imports mail templates and delivery defaults; payments imports payment