Back to Blog

riddlg 0.6.0 Released

riddlg 0.6.0, the local RIDDL generator, is now available.

release riddlg generator cli

riddlg 0.6.0 is now available. riddlg is the local, single-binary RIDDL toolchain — documentation and API-spec generation, AI-assisted RIDDL generation, and an MCP server, installable via Homebrew. This release includes:

What’s New

Eight new model-transform generators, taking riddlg well beyond docs and API specs into schemas, catalogs, and enterprise doc formats.

What’s New

Features — new generators

  • AsyncAPI 3.0 (riddlg gen api -f asyncapi [--protocol …]) — event-driven API specs (in/out/stream channels, request/reply) for RIDDL’s message model, where OpenAPI can only express request/response.
  • JSON Schema 2020-12 (riddlg gen api -f json-schema) — standalone .json data-validation schemas ($schema/$id/$defs, per-context bundles with cross-refs), for ajv / quicktype / data-exchange contracts.
  • SQL DDL (riddlg gen sql [--dialect …]) — runnable, normalized DDL from entities + repositories; one .sql file per source, each in its own dialect (postgres/mysql/ansi/oracle/sqlserver) via option sql_dialect(...); event-sourced and FSM entities handled; first-class indexing.
  • DBML (riddlg gen dbml) — a dialect-free logical schema for dbdiagram.io (Table/Ref/Enum/TableGroup); every record is a table.
  • Backstage catalog (riddlg gen backstage) — a Software Catalog (catalog-info.yaml): Domain → System → Component / Resource / API with ownership resolution and per-domain files + a root Location.
  • EventCatalog (riddlg gen catalog) — an EventCatalog site (domains / services / messages with per-message JSON schemas).
  • Confluence storage (riddlg gen confluence, Pro) — Confluence storage-format pages + a manifest.json and a publish.sh REST importer.
  • DocBook + DITA (riddlg gen docs -f docbook|dita, Pro) — structured-XML documentation (DocBook 5 <book>; DITA topics + .ditamap) over the shared doc IR.

All new formats also exposed over the localhost server (POST /generate/…); the Pro formats are license-gated (exit 3 / HTTP 402).

Improvements

  • riddl-lib 1.31.0 — registers the generator metadata options (sql_dialect, sql_table, backstage_owner/_lifecycle/_type, confluence_space/_parent, event_catalog_version, protocol), so models that set them validate cleanly (no “not a recognized RIDDL option” warnings).

Internal

  • Release CI publishes every platform that builds (one failed leg no longer blocks all publish tasks); the blog announcement is best-effort.
  • Reconciled and pruned the AsyncAPI / EventCatalog / DocBook feature branches.

Install

  • macOS: brew install ossuminc/tap/riddlg
  • Linux (rpm/yum): download the .rpm from this release, or use the tarball. (.deb also attached.)