sync: monorepo @ validator 0.1.8 / validation-types 0.1.2

Snapshot of medvertical/records monorepo state, exported via
oss:export-validator. Tracks the npm publication of:

  @records-fhir/validator@0.1.8
  @records-fhir/validation-types@0.1.2

Run npm i @records-fhir/validator@0.1.8 for the matching
distribution. The conformance evidence in conformance-results/
matches the published tarball.

Author: records-bot

README.md

@@ -45,7 +45,7 @@ jobs:
 For production CI, pin an immutable patch tag:
 
 ```yaml
-- uses: medvertical/records-fhir-validator@v0.1.7
+- uses: medvertical/records-fhir-validator@v0.1.8
   with:
     paths: resources/**/*.json
     profile-url: http://hl7.org/fhir/StructureDefinition/Patient
@@ -58,7 +58,7 @@ Action pinning:
 | Goal | Pin in `uses:` | Notes |
 |---|---|---|
 | Latest stable in current major | `medvertical/records-fhir-validator@v0` | Floating tag, force-moved on stable releases only |
-| Exact released version | `medvertical/records-fhir-validator@v0.1.7` | Immutable consumer tag |
+| Exact released version | `medvertical/records-fhir-validator@v0.1.8` | Immutable consumer tag |
 | Bit-exact reproducibility | `medvertical/records-fhir-validator@<commit-sha>` | Best for audit and forensics |
 
 The `validator-v<semver>` tag is the npm mirror/release-page tag. Use
@@ -67,7 +67,7 @@ The `validator-v<semver>` tag is the npm mirror/release-page tag. Use
 ### npm Package
 
 ```sh
-npm install @records-fhir/validator@0.1.7 @records-fhir/validation-types@0.1.2
+npm install @records-fhir/validator@0.1.8 @records-fhir/validation-types@0.1.2
 ```
 
 Validate a resource from Node.js:
@@ -88,7 +88,7 @@ artifacts until their upstream licenses and notices have been reviewed.
 
 ## What Is Included
 
-- `@records-fhir/validator` 0.1.7 - Apache-2.0 validation engine.
+- `@records-fhir/validator` 0.1.8 - Apache-2.0 validation engine.
 - `@records-fhir/validation-types` 0.1.2 - Apache-2.0 validation-domain types.
 - Composite GitHub Action at repository root.
 - Standalone examples under `packages/validator/examples/`.

packages/validation-types/src/fix-suggestions.ts

@@ -83,6 +83,26 @@ export const FixSuggestions: Record<string, FixSuggestion> = {
         why: 'Could not validate against the ValueSet (lookup failed).',
         fix: 'Check terminology server connectivity. The code may still be valid.',
     },
+    'terminology-code-invalid': {
+        why: 'The code is not valid for the declared code system. For UCUM quantities, the code must be a machine-readable UCUM expression, not just the display text.',
+        fix: 'Replace the code with a valid code from the declared system. If the issue contains a suggestedCode, use that value; for pH this is typically "[pH]".',
+        example: 'For system "http://unitsofmeasure.org", use code "[pH]" instead of "pH".',
+        specUrl: 'https://www.hl7.org/fhir/terminologies.html',
+        patch: { action: 'replace', path: '{{fieldPath}}', value: '{{suggestedCode}}' },
+    },
+    'terminology-display-mismatch': {
+        why: 'The code may be valid, but the display text does not match the terminology server display for that code.',
+        fix: 'Replace the display with an accepted display from the terminology server, or omit display and let consumers render the code.',
+        example: 'Keep system/code stable and update only Coding.display.',
+        specUrl: 'https://www.hl7.org/fhir/datatypes.html#Coding',
+    },
+    'terminology-coding-system-valueset': {
+        why: 'Coding.system must identify the CodeSystem that defines the code. A ValueSet URL describes an allowed set of codes and is not valid as Coding.system.',
+        fix: 'Replace Coding.system with the canonical CodeSystem URL for the selected code. Keep the ValueSet only in profile bindings or documentation.',
+        example: 'Use "http://terminology.hl7.org/CodeSystem/v3-MaritalStatus" instead of "http://hl7.org/fhir/ValueSet/marital-status".',
+        specUrl: 'https://www.hl7.org/fhir/datatypes.html#Coding',
+        patch: { action: 'replace', path: '{{fieldPath}}', value: '(use the code system URL for this code)' },
+    },
 
     // -------------------------------------------------------------------------
     // Structural
@@ -258,7 +278,7 @@ export const FixSuggestions: Record<string, FixSuggestion> = {
         fix: 'Include actual time if available for better precision.',
     },
     'metadata-tag-missing-code': {
-        why: 'Tags require a code to be useful for filtering and categorization.',
+        why: 'Tags are more useful for filtering and categorization when they include a code.',
         fix: 'Add a code value to the tag: { system: "...", code: "my-tag" }',
     },
     'metadata-tag-invalid-system-uri': {
@@ -540,8 +560,8 @@ export const FixSuggestions: Record<string, FixSuggestion> = {
     // Profile
     // -------------------------------------------------------------------------
     'profile-constraint-violation': {
-        why: 'Profile constraints define additional rules beyond the base FHIR specification.',
-        fix: 'Review the constraint expression and adjust your resource to satisfy it.',
+        why: 'Profile constraints define additional rules beyond the base FHIR specification. In document Bundles this can also mean a referenced child resource failed targetProfile matching.',
+        fix: 'Review the path and details. For targetProfile failures, fix the referenced resource so it conforms to one of the allowed targetProfiles, then revalidate the Bundle.',
         patch: { action: 'replace', path: '{{fieldPath}}', value: '(satisfy constraint {{key}}: {{message}})' },
     },
     'profile-mustsupport-missing': {
@@ -550,9 +570,9 @@ export const FixSuggestions: Record<string, FixSuggestion> = {
         specUrl: 'https://www.hl7.org/fhir/conformance-rules.html#mustSupport',
     },
     'profile-slice-min-cardinality': {
-        why: 'The profile requires a minimum number of items matching this slice discriminator.',
-        fix: 'Add more elements that match the slice discriminator (pattern, value, or type).',
-        example: 'For identifier slices: add identifier with matching system URL',
+        why: 'The profile requires at least one item matching this slice discriminator. For document Bundles, the missing slice may be caused by an entry that exists but does not conform to the required profile.',
+        fix: 'Add or repair the element matching the slice. For Bundle.entry:composition, fix the Composition entry and any child targetProfile errors first.',
+        example: 'For Bundle.entry:composition: include a Composition entry that conforms to the document profile.',
         patch: { action: 'add', path: '{{fieldPath}}', value: '(add entry matching slice "{{sliceName}}", min={{min}})' },
     },
     'profile-slice-max-cardinality': {

packages/validation-types/src/validation-settings.ts

@@ -87,7 +87,10 @@ export {
   // Default settings
   DEFAULT_VALIDATION_SETTINGS_R4,
   DEFAULT_VALIDATION_SETTINGS_R5,
+  createEhds2026ValidationSettings,
   createMii2026ValidationSettings,
+  HL7_EU_EHDS_2026_PACKAGE_SET,
+  HL7_EU_EHDS_2026_PACKAGE_VERSIONS,
   MII_2026_PACKAGE_SET,
   MII_2026_PACKAGE_VERSIONS,
   type FhirPackagePin,

packages/validation-types/src/validation/__tests__/mii-2026-preset.test.ts

@@ -1,6 +1,9 @@
 import { describe, expect, it } from 'vitest';
 import {
+  createEhds2026ValidationSettings,
   createMii2026ValidationSettings,
+  HL7_EU_EHDS_2026_PACKAGE_SET,
+  HL7_EU_EHDS_2026_PACKAGE_VERSIONS,
   MII_2026_PACKAGE_SET,
   MII_2026_PACKAGE_VERSIONS
 } from '../index';
@@ -32,19 +35,70 @@ describe('MII 2026 validation preset', () => {
     expect(settings.profileSources?.packageRegistry).toBe(true);
   });
 
+  it('stamps explicit MII run metadata and Ontoserver guardrails', () => {
+    const settings = createMii2026ValidationSettings();
+
+    expect(settings.mii).toEqual({
+      preset: 'mii-2026',
+      terminologyMode: 'mii-local-blaze',
+      maxOntoserverRequestsPerRun: 250,
+      allowHighVolumeOntoserver: false
+    });
+  });
+
   it('allows callers to override selected settings without losing package pins', () => {
     const settings = createMii2026ValidationSettings({
       packageDownload: {
         autoDownload: false,
         pinnedVersions: {
           'de.medizininformatikinitiative.kerndatensatz.laborbefund': '2026.0.1-local'
         }
+      },
+      mii: {
+        terminologyMode: 'mii-hybrid',
+        packageLockHash: 'sha256-demo'
       }
     });
 
     expect(settings.packageDownload?.autoDownload).toBe(false);
     expect(settings.packageDownload?.pinnedVersions['de.basisprofil.r4']).toBe('1.5.4');
     expect(settings.packageDownload?.pinnedVersions['de.medizininformatikinitiative.kerndatensatz.laborbefund'])
       .toBe('2026.0.1-local');
+    expect(settings.mii?.terminologyMode).toBe('mii-hybrid');
+    expect(settings.mii?.packageLockHash).toBe('sha256-demo');
+  });
+});
+
+describe('HL7 Europe EHDS 2026 package lane', () => {
+  it('keeps the package pin set in sync with the version map', () => {
+    expect(HL7_EU_EHDS_2026_PACKAGE_SET)
+      .toHaveLength(Object.keys(HL7_EU_EHDS_2026_PACKAGE_VERSIONS).length);
+    expect(HL7_EU_EHDS_2026_PACKAGE_SET).toContainEqual({
+      id: 'hl7.fhir.eu.laboratory',
+      version: '2.0.0'
+    });
+    expect(HL7_EU_EHDS_2026_PACKAGE_SET).toContainEqual({
+      id: 'hl7.fhir.eu.eps',
+      version: '1.0.0-alpha'
+    });
+  });
+
+  it('creates an EHDS preset on top of the MII baseline', () => {
+    const settings = createEhds2026ValidationSettings();
+
+    for (const { id, version } of MII_2026_PACKAGE_SET) {
+      expect(settings.packageDownload?.pinnedVersions[id]).toBe(version);
+      expect(settings.packageDownload?.approvedPackages).toContain(id);
+    }
+    for (const { id, version } of HL7_EU_EHDS_2026_PACKAGE_SET) {
+      expect(settings.packageDownload?.pinnedVersions[id]).toBe(version);
+      expect(settings.packageDownload?.approvedPackages).toContain(id);
+      expect(settings.hapiConfig?.igPackages).toContain(`${id}#${version}`);
+    }
+    expect(settings.hapiConfig?.igPackages).toContain(
+      'de.medizininformatikinitiative.kerndatensatz.consent#2026.0.1-rc-2'
+    );
+    expect(settings.mii?.preset).toBe('ehds-2026');
+    expect(settings.mii?.terminologyMode).toBe('mii-local-blaze');
   });
 });

packages/validation-types/src/validation/__tests__/settings-defaults.test.ts

@@ -0,0 +1,18 @@
+import { describe, expect, it } from 'vitest';
+import {
+  R4_DEFAULT_INCLUDED_RESOURCE_TYPES,
+  R5_DEFAULT_INCLUDED_RESOURCE_TYPES,
+  getDefaultValidationSettingsForVersion,
+} from '../settings-utils';
+
+describe('validation settings defaults', () => {
+  it('includes Bundle in default R4 and R5 validation resource types', () => {
+    expect(R4_DEFAULT_INCLUDED_RESOURCE_TYPES).toContain('Bundle');
+    expect(R5_DEFAULT_INCLUDED_RESOURCE_TYPES).toContain('Bundle');
+  });
+
+  it('enables Bundle validation in generated default settings', () => {
+    expect(getDefaultValidationSettingsForVersion('R4').resourceTypes.includedTypes).toContain('Bundle');
+    expect(getDefaultValidationSettingsForVersion('R5').resourceTypes.includedTypes).toContain('Bundle');
+  });
+});

packages/validation-types/src/validation/dtos.ts

@@ -144,6 +144,7 @@ export interface ValidationMessageGroupDTO {
     serverId?: number; // Server ID (for single-server queries, or first seen for multi-server)
     resourceType?: string; // Primary resource type for this issue group
     resourceTypeCounts?: Record<string, number>; // Per-type resource counts (e.g. { Patient: 5, Encounter: 3 })
+    validationEngineVersion?: string; // Engine version observed for the affected resource/aspect results
 }
 
 /**
@@ -180,6 +181,7 @@ export interface ResourceMessagesDTO {
             text: string;
             signature: string;
             createdAt: Date;
+            validationEngineVersion?: string;
         }[];
     }[];
 }

packages/validation-types/src/validation/index.ts

@@ -103,7 +103,10 @@ export type {
 export { PERFORMANCE_LIMITS } from './settings';
 
 export {
+  createEhds2026ValidationSettings,
   createMii2026ValidationSettings,
+  HL7_EU_EHDS_2026_PACKAGE_SET,
+  HL7_EU_EHDS_2026_PACKAGE_VERSIONS,
   MII_2026_PACKAGE_SET,
   MII_2026_PACKAGE_VERSIONS,
   type FhirPackagePin,

packages/validation-types/src/validation/settings-defaults.ts

@@ -94,15 +94,33 @@ export const MII_2026_PACKAGE_SET: FhirPackagePin[] = Object.entries(
   MII_2026_PACKAGE_VERSIONS
 ).map(([id, version]) => ({ id, version }));
 
+export const HL7_EU_EHDS_2026_PACKAGE_VERSIONS = {
+  'hl7.fhir.eu.extensions.r4': '1.3.0',
+  'hl7.fhir.eu.base': '2.0.0',
+  'hl7.fhir.eu.laboratory': '2.0.0',
+  'hl7.fhir.eu.eps': '1.0.0-alpha',
+  'hl7.fhir.eu.hdr': '0.1.0-ballot',
+  'hl7.fhir.eu.imaging': '1.0.0-ballot',
+  'hl7.fhir.eu.health-data-api': '1.0.0-ballot',
+} as const;
+
+export const HL7_EU_EHDS_2026_PACKAGE_SET: FhirPackagePin[] = Object.entries(
+  HL7_EU_EHDS_2026_PACKAGE_VERSIONS
+).map(([id, version]) => ({ id, version }));
+
 const MII_2026_IG_PACKAGES = MII_2026_PACKAGE_SET.map(({ id, version }) => `${id}#${version}`);
+const HL7_EU_EHDS_2026_IG_PACKAGES = HL7_EU_EHDS_2026_PACKAGE_SET.map(
+  ({ id, version }) => `${id}#${version}`
+);
 
 export type Mii2026ValidationSettingsOverrides = Omit<
   Partial<ValidationSettings>,
-  'packageDownload' | 'profileSources' | 'hapiConfig'
+  'packageDownload' | 'profileSources' | 'hapiConfig' | 'mii'
 > & {
   packageDownload?: Partial<NonNullable<ValidationSettings['packageDownload']>>;
   profileSources?: Partial<NonNullable<ValidationSettings['profileSources']>>;
   hapiConfig?: Partial<NonNullable<ValidationSettings['hapiConfig']>>;
+  mii?: Partial<NonNullable<ValidationSettings['mii']>>;
 };
 
 /**
@@ -527,7 +545,7 @@ export const DEFAULT_VALIDATION_SETTINGS_R5: ValidationSettings = {
 };
 
 /**
- * Create an R4 validation settings preset for the MII 2026 package set.
+ * Create an R4 validation settings object for the MII 2026 package set.
  *
  * The preset keeps the standard Records validator behavior but pins every
  * MII package version used by the 2026 conformance target so automatic package
@@ -568,10 +586,20 @@ export function createMii2026ValidationSettings(
     cachePath: settings.hapiConfig?.cachePath ?? '/tmp/fhir-packages',
     enableBestPractice: settings.hapiConfig?.enableBestPractice ?? true
   };
+  settings.mii = {
+    preset: 'mii-2026',
+    terminologyMode: 'mii-local-blaze',
+    maxOntoserverRequestsPerRun: 250,
+    allowHighVolumeOntoserver: false
+  };
 
   return {
     ...settings,
     ...overrides,
+    mii: {
+      ...settings.mii,
+      ...overrides.mii
+    },
     packageDownload: {
       ...settings.packageDownload,
       ...overrides.packageDownload,
@@ -591,3 +619,78 @@ export function createMii2026ValidationSettings(
     }
   };
 }
+
+/**
+ * Create an R4 validation settings object for EHDS-oriented data tests.
+ *
+ * The EHDS lane builds on the MII 2026 baseline because German EHDS pilots
+ * need the same local terminology and KDS package behavior, then adds the
+ * HL7 Europe package pins used by cross-border EHDS scenarios.
+ */
+export function createEhds2026ValidationSettings(
+  overrides: Mii2026ValidationSettingsOverrides = {}
+): ValidationSettings {
+  const settings = createMii2026ValidationSettings();
+  const approvedPackages = new Set([
+    ...(settings.packageDownload?.approvedPackages ?? []),
+    ...HL7_EU_EHDS_2026_PACKAGE_SET.map(({ id }) => id)
+  ]);
+
+  settings.packageDownload = {
+    versionPolicy: settings.packageDownload?.versionPolicy ?? 'prefer-stable',
+    pinnedVersions: {
+      ...(settings.packageDownload?.pinnedVersions ?? {}),
+      ...HL7_EU_EHDS_2026_PACKAGE_VERSIONS
+    },
+    approvedPackages: Array.from(approvedPackages),
+    requireApproval: settings.packageDownload?.requireApproval ?? false,
+    autoDownload: settings.packageDownload?.autoDownload ?? true
+  };
+
+  settings.hapiConfig = {
+    enabled: settings.hapiConfig?.enabled ?? false,
+    timeout: settings.hapiConfig?.timeout ?? 30000,
+    igPackages: [...MII_2026_IG_PACKAGES, ...HL7_EU_EHDS_2026_IG_PACKAGES],
+    useProcessPool: settings.hapiConfig?.useProcessPool ?? true,
+    poolSize: settings.hapiConfig?.poolSize ?? 3,
+    cachePath: settings.hapiConfig?.cachePath ?? '/tmp/fhir-packages',
+    enableBestPractice: settings.hapiConfig?.enableBestPractice ?? true
+  };
+
+  settings.mii = {
+    preset: 'ehds-2026',
+    terminologyMode: settings.mii?.terminologyMode ?? 'mii-local-blaze',
+    packageLockHash: settings.mii?.packageLockHash,
+    maxOntoserverRequestsPerRun: settings.mii?.maxOntoserverRequestsPerRun,
+    allowHighVolumeOntoserver: settings.mii?.allowHighVolumeOntoserver
+  };
+
+  return {
+    ...settings,
+    ...overrides,
+    mii: {
+      ...settings.mii,
+      ...overrides.mii,
+      terminologyMode: overrides.mii?.terminologyMode ?? settings.mii.terminologyMode,
+      preset: 'ehds-2026'
+    },
+    packageDownload: {
+      ...settings.packageDownload,
+      ...overrides.packageDownload,
+      pinnedVersions: {
+        ...settings.packageDownload.pinnedVersions,
+        ...overrides.packageDownload?.pinnedVersions
+      },
+      approvedPackages: overrides.packageDownload?.approvedPackages ?? settings.packageDownload.approvedPackages
+    },
+    profileSources: {
+      fhirServer: overrides.profileSources?.fhirServer ?? settings.profileSources?.fhirServer ?? true,
+      simplifier: overrides.profileSources?.simplifier ?? settings.profileSources?.simplifier ?? true,
+      packageRegistry: overrides.profileSources?.packageRegistry ?? settings.profileSources?.packageRegistry ?? true
+    },
+    hapiConfig: {
+      ...settings.hapiConfig,
+      ...overrides.hapiConfig
+    }
+  };
+}