Release 2.3.0

[tviegut]

Release 2.3.0 [08-Jun-2026]

We're pleased to announce the release of CIMTool 2.3.0 — a significant update focused on documentation generation, real-time profile visualization, diagram customization, expanded profiling capabilities, pipeline automation, and a number of important defect fixes.

New in 2.3.0: cimtool-cli for CI/CD pipelines

The headline addition in this release is cimtool-cli, a new command-line interface that brings CIMTool's artifact generation into automated and continuous-integration workflows. The transform engine has been decoupled from the Eclipse desktop application and packaged as a self-contained executable JAR that runs profile transformations and generates artifacts headlessly — with no Eclipse workbench required. This makes it straightforward to incorporate CIMTool builders directly into CI/CD pipelines, build scripts, and SchemaOps automation.

cimtool-cli is included as a separate, distinct deliverable alongside the desktop product in this release. See Using CIMTool in CI/CD Pipelines with cimtool-cli for usage and examples.

Key release highlights

• Real-time Profile Preview and Error Visualization — a live PlantUML class diagram of the profile you're editing that updates automatically as you work, with pan and zoom. As you build, the preview automatically visualizes invalid or incomplete constructs — unresolved references, missing attribute types, and incomplete associations — giving immediate visual feedback so issues can be caught and corrected as you build your profile. See Profile Real-Time Preview for how to use the preview and interpret the error visualization.
• Modularized Documentation Authoring — a new Documentation project folder and eight new AsciiDoc builders (standalone and inline variants for RDFS, RDFS-with-mappings, XSD, and JSON Schema), backed by a bundled Asciidoctor editor and embedded Pandoc. Author narrative content and per-element documentation alongside your profiles, then assemble the generated profile documentation together with your hand-written content into a single master document. See Using CIMTool Documentation Features.
• Diagram enhancements & customization — user-configurable PlantUML diagram preferences, dedicated XSD diagram builders, per-diagram .pumlconfig overrides, and Dark Mode support.
• Expanded profiling — bulk Add/Remove operations, relaxed cardinality patterns (0..n, 1..n, and similar), compound-type profiling, XSD attribute and attribute-group generation, IEC 62361-100/104 CodeList support, stereotype-to-namespace *.namespaces mapping files (Namespaces in CIMTool), and self-healing schema import.
• Shadow Extension and Mix-In support — when profiling directly from Enterprise Architect project files, CIMTool now recognizes shadow classes (also known as "mix-ins"), a lightweight mechanism for adding attributes to existing CIM classes without modifying the originals — keeping normative and extended content cleanly separated. See Modeling CIM Extensions.
• Enterprise-ready packaging and security — Windows binaries are now signed with an Extended Validation (EV) code-signing certificate, eliminating the SmartScreen "unknown publisher" warning, and the legacy Apache Log4j 1.x library has been removed to address known CVEs — important for utility and critical-infrastructure environments with dependency-scanning requirements.

CGMES-CIM17: a complete working example

Released publicly alongside this version, the cimug-org/CGMES-CIM17 repository is a fully worked example of CIMTool's new modularized documentation features. It hosts the official CIMTool project for the IEC 61970-600-2:2021 CGMES standard profiles based on CIM17, and shows how to assemble modular AsciiDoc documentation — a master document that aggregates multiple profiles using the adoc-inline-rdfs builder for inline RDFS content fragments, together with the PlantUML RDFS diagram builders for automatically generated profile diagrams.

The repository also includes a copy of the ENTSO-E released model CIM17-2_CGMES31v01_PROF-20v02_NC23v66_MS10v01_DES10v01.qea, that has been prepped as well as configured to use the new stereotype-to-namespace mapping feature and its accompanying *.namespaces mapping file. It is a recommended starting point for anyone interested in understanding how to create their own complex project-level modularized documentation.

Roadmap and development visibility

As part of formalizing the processes around CIMTool releases, we've introduced public project boards that give the community direct visibility into planning and development:

• CIMTool Product Roadmap — public visibility into roadmap planning, including release-specific views.
• CIMTool 2.3.0 Development Board — each release now has its own public Kanban board for monitoring development status; this is the board for the 2.3.0 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.0 Release Notes

---

This discussion was created from the release Release 2.3.0.