Release 2.3.1

[tviegut]

Release 2.3.1 [09-Nov-2026]

We're pleased to announce the release of CIMTool 2.3.1, a patch release with a security fix, defect fixes for the desktop application, its builders and cimtool-cli, and small enhancements that support them.

Upgrading from 2.3.0

• Your profile artifacts are regenerated once, automatically. The first time CIMTool 2.3.1 opens a workspace last built by 2.3.0, it regenerates each project's profile artifacts in a background job, so the builder fixes in this release reach your existing projects without a manual rebuild. Only the builders enabled on each profile run, and the schema is not rebuilt. If you keep generated artifacts in source control, expect them to show as changed after the first launch.
• Review your cimtool-cli pipeline scripts. Some command lines that 2.3.0 accepted, and that produced unusable or silently incomplete output, are now reported as invalid arguments. See Changes in 2.3.1.

Key release highlights

• No network access when loading stylesheets. Builder stylesheets and custom --xslt stylesheets in cimtool-cli are now loaded without reaching out to an external URI, which matters for the air-gapped and proxy-restricted environments common at utilities.
• Installation paths with spaces. CIMTool now launches, builds its artifacts and shows the real-time preview when installed in a folder whose path contains spaces.
• Flexible AsciiDoc diagram references. The AsciiDoc builders now reference their PlantUML diagrams through the {profilesdir} attribute rather than a fixed ./Profiles/... path, so generated documentation can be included from anywhere in a project. Existing master documents keep working, since each generated document falls back to {docdir}/Profiles. See Using CIMTool Documentation Features.
• Copyright notices in SQL and HTML output. The SQL builders add your project's multi-line copyright as SQL comments, and the HTML builder adds the single-line copyright as a footer. cimtool-cli now applies a project's copyright templates automatically.
• More robust builders. The PlantUML, LinkML and Apache Avro builders handle classes with more than one parent, which is what a schema imported with the shadow/mix-in merge option unchecked produces, and the real-time preview no longer raises errors in that case.
• Cleaner generated documentation. Indentation written on the Documentation tab, such as code listings, is preserved in generated AsciiDoc, and CIMTool's internal stereotypes no longer appear beside attribute and association names.
• Builder cleanup. The beta rdfs-501ed2-beta builder has been removed.

Development visibility

• CIMTool Product Roadmap: public visibility into roadmap planning, including release-specific views.
• CIMTool 2.3.1 Development Board: the public board for this release.

Full release notes

The above is a summary of the key highlights. For the complete list of enhancements and defect fixes, see the full release notes:

CIMTool 2.3.1 Release Notes

---

This discussion was created from the release Release 2.3.1.