4.0.0 Migration Guide

This page outlines the changes to this repository that are included with the v4 release.

Upstream, the #1462 pull request converted the CQL (cql-to-elm) Java project and its dependencies to Kotlin Multiplatform (KMP) targeting the JVM and JavaScript. This removed the two serialization modules (jaxb and jackson) in favor of a single, cross-platform module. Corresponding changes have made to this project (see below).

See the CQL migration guide, which may also apply to projects using Clinical Reasoning that have referenced the CQL artifacts directly.

Dependency management

• Previously, you needed to add one of the cqf-fhir-(jackson|jaxb)modules as an extra dependency to your project. This is no longer required because the default multiplatform serialization functionality is now included. Any references to either cqf-fhir-jackson or cqf-fhir-jaxb should be removed.
• See this PR for the internal changes to this project to update the CQL 4.0.0.

Start with the issue text, the linked CQL v3-to-v4 migration guide, and clinical-reasoning PR #716. Confirm which v4 dependency changes apply here, especially removal of cqf-fhir-jackson and cqf-fhir-jaxb; done means the repository has accurate, usable migration guidance for those changes.