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: truefor 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