Skip to content

v1.2.0

Choose a tag to compare

@djeglin djeglin released this 02 Apr 09:20
· 5 commits to main since this release

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