Repository navigation
v1.2.0
CMMF 1.2.0
CMMF 1.2.0 simplifies repeatability across the format by standardising on field-level list as the canonical way to express plural fields. This replaces the previous split where most field types used list: true but references used relation.cardinality.
Highlights
- Standardised repeatability on list for all field types, including reference
- Added versioned 1.2.0 specification and translation contract documents
- Updated examples and reference docs to show repeatable references with list: true
- Updated the JSON Schema to describe relation.cardinality as a legacy compatibility alias
- Added migration guidance for translators and validators
Why This Changed
Before 1.2.0, CMMF used two different mechanisms for the same modelling question: whether a field is singular or repeatable. That added avoidable complexity for model authors, translators, validators, and tooling.
In 1.2.0, repeatability is treated as a general field concern. Relationship semantics remain in relation, while list now consistently answers whether a field holds one item or many.
Migration Notes
- Replace relation.cardinality: many with list: true on reference fields
- Omit both list and relation.cardinality for singular references
- Legacy relation.cardinality remains accepted for compatibility during migration
- Treat conflicting list and relation.cardinality values as invalid
Compatibility
CMMF 1.2.0 is designed to ease migration rather than force an immediate break. Existing translators and validators can continue accepting legacy relation.cardinality on reference fields, but new models and examples should prefer list.
Example
Before:
type: reference
targets: [article]
relation:
cardinality: many
ownership: linked
After:
type: reference
list: true
targets: [article]
relation:
ownership: linked
Included In This Release
- New 1.2.0 spec draft
- New 1.2.0 translation contract draft
- Updated docs and examples
- Updated schema validation rules for the new convention
Full Changelog: https://github.com/cmmf-project/content-model-master-format/commits/v1.2.0