6.5.8

Announcement

This release marks the beginning of a process of refactoring the HAPI core code.
We are trimming and refactoring the core model code to reduce dependencies. As part
of this, we will be culling all the old unmaintained code in the older versions. In
addition, we will be moving all the terminology, rendering, view definition, and
validation related code to a new partner package for R4, R4B, and R5.
This change is planned for July 2025. This release starts the process of marking the
code with annotations to indicate its proposed fate:

• @deprecated classes will be deleted in July 2025 unless users raise issues with that
• @MarkedToMoveToAdjunctPackage is code that will move the other package
• Code with no annotations will not move or be deleted

Validator Changes

• Add HL7 CodeSystem display and definition checks
• Add Matchetype validator
• Add http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version to snapshot generation
• Optimize the JSON parsing in NpmPackageIndexBuilder.seeFile (#1898) (faster loading)
• Fix stack crash when structure definitions are circular
• Fix error reporting duplicate contained IDs when contained resources are sliced by a profile
• Allow cardinality changes in obligation profiles (but not recommended)
• Fix bug with wrongly processing -ips#(v) parameter
• Add underscore to regex to be able to use underscore in Bundle URLs

Other code changes

• Refactor FileUtilities and other Utilities classes
• fix element order in Element.forceElement()
• fix NPE in patient renderer
• Resource Factory updates for loading generated resources in IG publisher
• Fix intermittent thread issue in Date rendering

6.5.7

Validator Changes

• Add check for duplicate ids on contained resources
• fix bug looking up code system
• fix bug for cross-version extension containing escaped [x]
• Look for cs on other server in missed location
• fix bug accessing code system from other terminology server if no version specified
• upgrade tx tests to make optionality dependent on mode
• upgrade tx-task in validator to handle more repackaging functionality (and fix bugs)
• Add matchetype pattern validation
• validate displaylanguage when validating codes
• policyAdvisor for CodeSystem and Valueset validation

Other code changes

• Possible fix for an NPE reported bu a user with no context
• Use BCP 47 language tag instead of Java Locale toString
• fix bug parsing script tag in xhtml - handling < characters

6.5.6

Validator Changes

• New Feature: Validating references: parameters -check-references and -resolution-context
• New Feature: Use AI Service to validate CodeableConcept.text (very experimental)
• Add AI validation tests as a command line option (-aiTests)
• Dont enforce code system property references to standard properties in R4 (R4 hack workaround)
• Correctly handle supplements when validating based on expansions
• Fix issues with version dependent resolution of correct server for implicit value sets
• Better handle failure to find imported value sets when expanding
• correct error handling for expansion failure
• Correct grammar in language about resource not being valid against a profile
• use IPS 2.0.0 for -ips, not an old copy
• Fix NPE generating snapshots with expansions
• Rework -txTests to support additional test files and improve R4/R5 logging
• Fix bugs in RulesDrivenPolicyAdvisor
• Accept property in CodeSystem without requiring it be backed by a code
• Add issue when extension is deprecated

Other code changes

• Track & report expansion source when rendering ValueSet expansions
• Render ValueSet supplement dependencies
• Add server headers to fhir-settings.json
• find places where ManagedFileAccess was missed
• Fix Actor rendering in obligations tables
• Renderer: move xml-no-order to tools ig
• Resource Factory: support for range in sheet for instance generation (#1881)

6.5.5

Validator Changes

• Do not create issue about draft dependency for example bindings
• Beef up validation of CodeSystem properties that are codes
• Make sure all validation messages have a message id
• Validator enforce version-set-specific value for Extension and Extension context
• Specific Error when ValueSet.compose.include.system refers to a ValueSet
• Fix NPE processing code system supplements

Other code changes

• Report count of tests in output from TxTester
• resolve issues with references between IGs to example resources
• Lookup compliesWithProfile target from link-only dependencies
• Update SNOMED editions related routines (add more editions)
• Accessibility - role=presentation on appropriate tables
• Add support for ADL in packages
• Support for Archetype processing in IG publisher
• Lazy load binaries for reduced memory usage

6.5.4

Validator Changes

• No changes

Other code changes

• Fix cardinality generation in Element Table

6.5.3

Validator Changes

• Validate that ConceptMap references to ValueSets are actual value sets
• Check if abstract classes have concrete subtypes in scope
• Handle tx ecosystem failure properly
• fix for CLI Should Fail with Non-Zero Exit Code on TX Test Errors

Other code changes

• Add support for multiple lines in the first cell in heirarchical tables
• Also add support for suppressing lines and inner borders
• Add support for table.rows in TestDataFactory
• Add Element View for non-technical readers of profiles
• Improved Rendering for Timing Datatype
• Fix for handling SD extensions when generating snapshots
• Dont remove bindings from types with characteristics = can-bind (Extensions in R5)
• Various minor Fixes for generating snapshots for archetypes (checking type parameters)
• Fix logback configs + update logback (#1868)
• .qos.logback-logback-core-1.5.13: Fix inclusion of logback-test in jar and fix classpath log configs
• Fix LoggingPolicy enum (use SLF4J)

6.5.2

Validator Changes

• Christmas 2025 Add new command option to validator: test instance factory
• Fix validation of invariants in profiles - check for more conflicts, and dont call conflict if the expression is the same
• Fix issues with tracking supplement usage and getting supplement version matching correct
• Fix npe loading old simplifier package

Other code changes

• Fix handling of ValueSetVersion parameter in txTests
• Test Instance Generation, and many fixes to PE model
• Fix logical model rendering to use type characteristics for can-be-target
• Only use profiled datatype information for generating snapshots for Resource and Extension
• Fix comparison template loading issue

6.5.1

Validator Changes

• Start removing R2 support- add note that its not officially supported anymore
• Add support for finding the existence of implicit value sets
• move tx tests to tx-ecosystem IG and change -txTests parameters
• Switch priority order of package servers (packages2.fhir.org is not rate limited)
• Fix issue with value set version conversion on contains.property (Check for both value and value[x])
• Fix error message validating ConceptMap when size too large

Other code changes

• Security fix: Bump ucum to 1.0.9
• Add XhtmlToMarkdown library
• Add support for THO rendering of NamingSystem information
• Add profile-based sample instance generation (WIP)
• fixes for snapshot generation test debugging
• Add support for languages to npm package and package list
• fix rendering issues - resources with no id, and urn: references shouldnt be links
• fix regex escapes in R5 Constants regex for RESTful references
• Improvements to translation file generation (better path, eliminate duplicates)

6.5.0

Validator Changes

• Add support for valueset-version
• Add support for terminology extraction
• Add support for expansion parameters when validating
• fix NPE in validator around Extension context
• Handle secondary terminology server errors properly
• Fix questionnaire response status checking
• Add versions to message about multiple matching profiles
• hide API-Key from appearing on the tx log
• Add supplements for used systems as well as for value set systems when validating on server
• fix missing port from server when doing tx-registry redirections
• Fix problem not finding current version of extensions pack for non-R5 versions
• Fix validation of displays when language is unknown
• fix issue missing idrefs validating IPS documents
• Update FHIRPath validation to handle rootResource type properly
• Fix obscure error on contentReference in profiles in FHIRPath engine
• Fix version conversion issue for validating derived questionnaires

Other code changes

• New release of pubpack
• Fix r4b liquid tests
• Refactor Liquid engine and add support for forLoop and capture
• Add support for liquid on csv files
• Add support for using Liquid on plain JSON directly and add support for markdownify filter
• Many improvements to Profile Code Generation
• Start working on using new IG infrastructure for Tx tests
• Questionnaire rendering improvements
• Merge Functionality for CapabilityStatement.import
• Do not use metadata from data type profiles on elements when generating snapshots
• Fix presentation issues and union and intersection links in previous version comparison
• Fix filter comparison logic when comparing valuesets
• Fix version issues in snapshot generation tests
• Eliminate id from snapshot generation test case comparison
• Change rules around stripping extensions when generating snapshots
• fix bug using wrong reference on uri in liquid renderer
• add translations for expansion errors
• fix issue with comparison template missing
• Apply null pointer check to all switch(Enumeration) statements in version conversion code
• Remove mysql dependency
• Fix bug in DecimalType on null Bigdecimal ()] all versions)
• Fix bad URL in inter-version extension conversion of ValueSet for ValueSet property

6.4.4

Validator Changes

• fix pattern discriminator validation rule
• fix issue with FHIRPath engine throwing exception for an invalid path

Other code changes

• fix NPE rendering reference
• fix NPE processing issue from template
• Add FeatureDefinition renderer
• Support for Custom resources in publisher