Skip to content

v0.5.0

Latest

Choose a tag to compare

@github-actions github-actions released this 24 Sep 15:32
· 1 commit to main since this release

Highlights

Model across repository boundaries

Models can import another model from the same repository and reference its enums
or entities as scope.Name. Imports resolve only through the importing model's
direct imports: entries, remain confined to the repository, and never cause
lint or render to use the network. Rendered Markdown links qualified
references to the imported model's rendered document.

Vendor models from other repositories

Use modelith deps import, modelith deps check, and modelith deps update to
bring a model into a repository, verify it against its recorded origin, and
refresh it deliberately. Vendored copies carry a provenance header and content
digest. Lint verifies that digest locally, while deps check asks whether the
origin changed.

Vendored models do not make your CI fail for their completeness gaps. Render
checking also skips a vendored copy without committed rendered Markdown, while
still reporting malformed provenance and modified copies.

Express richer domains

The v1 format now supports:

  • bounded and exact relationship cardinalities, plus symmetric relationships;
  • subtype relationships through subtypeOf;
  • derived entities and attributes; and
  • shared: true for vocabulary models intended for import.

Mermaid output now distinguishes owned and referenced relationships, handles
self-relationships inside the entity box, and preserves ambiguous reciprocal
declarations rather than dropping information.

Safer automation and rendering

The GitHub Action installs a checksum-verified release binary instead of
building from source. Rendering and import diagnostics were hardened for
untrusted prose, Mermaid labels, import paths, and malformed provenance.

Documentation

The guides now cover imports, vendoring, the deps commands, the expanded
schema, and local plugin development.

Upgrade notes

This is a pre-1.0 release. Existing local models continue to validate, while
new imports and cross-model references are optional. See the
documentation for the current format and command
reference.

Full changelog: v0.4.0...v0.5.0