us_quality_core_test_kit 0.1.2 → 0.2.0

data/lib/us_quality_core_test_kit/igs/us.quality-core-0.5.0/ValueSet-SmokingStatusType.json

@@ -0,0 +1,74 @@
+{
+  "resourceType": "ValueSet",
+  "id": "2.16.840.1.113762.1.4.1267.6",
+  "meta": {
+    "versionId": "5",
+    "lastUpdated": "2024-02-27T16:29:13.000-05:00",
+    "profile": [
+      "http://hl7.org/fhir/StructureDefinition/shareablevalueset",
+      "http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/computable-valueset-cqfm",
+      "http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/publishable-valueset-cqfm"
+    ]
+  },
+  "extension": [
+    {
+      "url": "http://hl7.org/fhir/StructureDefinition/valueset-effectiveDate",
+      "valueDate": "2024-02-22"
+    }
+  ],
+  "url": "http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1267.6",
+  "identifier": [
+    {
+      "system": "urn:ietf:rfc:3986",
+      "value": "urn:oid:2.16.840.1.113762.1.4.1267.6"
+    }
+  ],
+  "version": "20240222",
+  "name": "SmokingStatusType",
+  "title": "Smoking Status Type",
+  "status": "active",
+  "date": "2024-02-22T01:11:38-05:00",
+  "publisher": "HL7 US Realm Program Management Steward",
+  "expansion": {
+    "identifier": "urn:uuid:4846dfb3-7d88-40a1-a541-64a4faa5fb25",
+    "timestamp": "2024-06-04T17:17:43-04:00",
+    "total": 4,
+    "offset": 0,
+    "parameter": [
+      {
+        "name": "count",
+        "valueInteger": 1000
+      },
+      {
+        "name": "offset",
+        "valueInteger": 0
+      }
+    ],
+    "contains": [
+      {
+        "system": "http://loinc.org",
+        "version": "2.77",
+        "code": "11367-0",
+        "display": "History of Tobacco use"
+      },
+      {
+        "system": "http://snomed.info/sct",
+        "version": "http://snomed.info/sct/731000124108/version/20240301",
+        "code": "401201003",
+        "display": "Cigarette pack-years (observable entity)"
+      },
+      {
+        "system": "http://loinc.org",
+        "version": "2.77",
+        "code": "72166-2",
+        "display": "Tobacco smoking status"
+      },
+      {
+        "system": "http://snomed.info/sct",
+        "version": "http://snomed.info/sct/731000124108/version/20240301",
+        "code": "782516008",
+        "display": "Number of calculated pack years for cumulative lifetime tobacco exposure (observable entity)"
+      }
+    ]
+  }
+}

data/lib/us_quality_core_test_kit/igs/us.quality-core-1.0.0-ballot/ValueSet-AdvanceHealthcareDirectiveCategoriesLOINC.json

@@ -0,0 +1,73 @@
+{
+  "resourceType": "ValueSet",
+  "id": "2.16.840.1.113883.11.20.9.69.4",
+  "meta": {
+    "versionId": "47",
+    "lastUpdated": "2025-04-02T01:08:06.000-04:00",
+    "profile": [
+      "http://hl7.org/fhir/StructureDefinition/shareablevalueset",
+      "http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/computable-valueset-cqfm",
+      "http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/publishable-valueset-cqfm"
+    ]
+  },
+  "language": "en",
+  "extension": [
+    {
+      "url": "http://hl7.org/fhir/StructureDefinition/valueset-author",
+      "valueContactDetail": {
+        "name": "ADVault Author"
+      }
+    },
+    {
+      "url": "http://hl7.org/fhir/StructureDefinition/resource-lastReviewDate",
+      "valueDate": "2025-04-02"
+    },
+    {
+      "url": "http://hl7.org/fhir/StructureDefinition/valueset-effectiveDate",
+      "valueDateTime": "2025-04-02"
+    },
+    {
+      "url": "http://hl7.org/fhir/StructureDefinition/artifact-effectivePeriod",
+      "valuePeriod": {
+        "start": "2025-04-02"
+      }
+    }
+  ],
+  "url": "http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113883.11.20.9.69.4",
+  "identifier": [
+    {
+      "system": "urn:ietf:rfc:3986",
+      "value": "urn:oid:2.16.840.1.113883.11.20.9.69.4"
+    }
+  ],
+  "version": "20250402",
+  "name": "AdvanceHealthcareDirectiveCategoriesLOINC",
+  "title": "Advance Healthcare Directive Categories LOINC",
+  "status": "active",
+  "date": "2025-04-02T01:08:06-04:00",
+  "publisher": "ADVault",
+  "jurisdiction": [
+    {
+      "extension": [
+        {
+          "url": "http://hl7.org/fhir/StructureDefinition/data-absent-reason",
+          "valueCode": "unknown"
+        }
+      ]
+    }
+  ],
+  "purpose": "(Clinical Focus: Categories of advance healthcare directive documents.),(Data Element Scope: Used for concepts that categorize advance healthcare directive documents and document reference indexes for search and retrieval.),(Inclusion Criteria: Includes high-level concepts from LOINC that indicate a advance healthcare directive document.),(Exclusion Criteria: Exclude concepts from LOINC that indicate a specific type of advance healthcare directive document.)",
+  "compose": {
+    "include": [
+      {
+        "system": "http://loinc.org",
+        "concept": [
+          {
+            "code": "42348-3",
+            "display": "Advance directives"
+          }
+        ]
+      }
+    ]
+  }
+}

data/lib/us_quality_core_test_kit/igs/us.quality-core-1.0.0-ballot/ValueSet-SmokingStatusType.json

@@ -0,0 +1,74 @@
+{
+  "resourceType": "ValueSet",
+  "id": "2.16.840.1.113762.1.4.1267.6",
+  "meta": {
+    "versionId": "5",
+    "lastUpdated": "2024-02-27T16:29:13.000-05:00",
+    "profile": [
+      "http://hl7.org/fhir/StructureDefinition/shareablevalueset",
+      "http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/computable-valueset-cqfm",
+      "http://hl7.org/fhir/us/cqfmeasures/StructureDefinition/publishable-valueset-cqfm"
+    ]
+  },
+  "extension": [
+    {
+      "url": "http://hl7.org/fhir/StructureDefinition/valueset-effectiveDate",
+      "valueDate": "2024-02-22"
+    }
+  ],
+  "url": "http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1267.6",
+  "identifier": [
+    {
+      "system": "urn:ietf:rfc:3986",
+      "value": "urn:oid:2.16.840.1.113762.1.4.1267.6"
+    }
+  ],
+  "version": "20240222",
+  "name": "SmokingStatusType",
+  "title": "Smoking Status Type",
+  "status": "active",
+  "date": "2024-02-22T01:11:38-05:00",
+  "publisher": "HL7 US Realm Program Management Steward",
+  "expansion": {
+    "identifier": "urn:uuid:4846dfb3-7d88-40a1-a541-64a4faa5fb25",
+    "timestamp": "2024-06-04T17:17:43-04:00",
+    "total": 4,
+    "offset": 0,
+    "parameter": [
+      {
+        "name": "count",
+        "valueInteger": 1000
+      },
+      {
+        "name": "offset",
+        "valueInteger": 0
+      }
+    ],
+    "contains": [
+      {
+        "system": "http://loinc.org",
+        "version": "2.77",
+        "code": "11367-0",
+        "display": "History of Tobacco use"
+      },
+      {
+        "system": "http://snomed.info/sct",
+        "version": "http://snomed.info/sct/731000124108/version/20240301",
+        "code": "401201003",
+        "display": "Cigarette pack-years (observable entity)"
+      },
+      {
+        "system": "http://loinc.org",
+        "version": "2.77",
+        "code": "72166-2",
+        "display": "Tobacco smoking status"
+      },
+      {
+        "system": "http://snomed.info/sct",
+        "version": "http://snomed.info/sct/731000124108/version/20240301",
+        "code": "782516008",
+        "display": "Number of calculated pack years for cumulative lifetime tobacco exposure (observable entity)"
+      }
+    ]
+  }
+}

data/lib/us_quality_core_test_kit/interpreter_required_extension_test.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module USQualityCoreTestKit
+  module InterpreterRequiredExtensionTest
+    def scratch_patient_resources
+      scratch[:patient_resources] ||= {}
+    end
+
+    def scratch_encounter_resources
+      scratch[:encounter_resources] ||= {}
+    end
+
+    def scratch_patient_and_encounter_resources
+      all_resources = scratch_patient_resources[:all]
+      all_resources.push(*scratch_encounter_resources[:all])
+      all_resources
+    end
+
+    def interpreter_required_extension_url
+      'http://hl7.org/fhir/us/core/StructureDefinition/us-core-interpreter-needed'
+    end
+
+    def interpreter_required_extension_exists?(resource)
+      resource.extension.present? && resource.extension.any? do |extension|
+        extension.url == interpreter_required_extension_url
+      end
+    end
+
+    def verify_interpreter_required_extension_exists
+      patient_and_encounter_resources = scratch_patient_and_encounter_resources
+
+      extension_found = patient_and_encounter_resources.any? do |resource|
+        interpreter_required_extension_exists?(resource)
+      end
+
+      assert(extension_found, %(
+        A certifying Server system SHALL support the US Core Interpreter Needed Extension on at least one of the US
+        Core Quality Patient or US Quality Core Encounter Profiles, but the extension was not found on either profile.
+      ))
+    end
+  end
+end

data/lib/us_quality_core_test_kit/metadata.rb

@@ -10,8 +10,10 @@ module USQualityCoreTestKit
 
     description <<~DESCRIPTION
       The US Quality Core Test Kit validates server and client implementations
-      against the [US Quality Core Implementation Guide
-      v0.5.0](https://fhir.org/guides/onc/us-quality-core/).
+      against the following US Quality Core versions:
+
+      * [2026 US Quality Core Implementation Guide v0.5.0](https://fhir.org/guides/onc/us-quality-core/) (USCDI+ Quality V1)
+      * [US Quality Core Implementation Guide v1.0.0-ballot](http://hl7.org/fhir/us/quality-core/1.0.0-202609-ballot/en) (Draft USCDI+ Quality V2)
 
       <!-- break -->
 
@@ -25,18 +27,21 @@ module USQualityCoreTestKit
 
       ## Status
 
-      These tests are a DRAFT intended to allow US Quality Core implementers to
-      perform preliminary checks of their implementations against the
-      [US Quality Core conformance requirements](https://fhir.org/guides/onc/us-quality-core/general-requirements.html)
-      and provide feedback on the tests. Future versions may validate
-      additional requirements or change how these requirements are tested.
+      These tests are DRAFT tests intended to allow US Quality Core
+      implementers to perform preliminary checks of their implementations
+      against the relevant conformance requirements and provide feedback on the
+      tests. Future versions may validate additional requirements or change how
+      these requirements are tested.
 
       ## Scope
 
-      The scope of this test kit is intended to match the conformance scope
-      defined by US Quality Core v0.5.0. The IG is derived from QI-Core STU 6
-      and includes inherited profiles to ease adoption, but its conformance
-      requirements are focused on USCDI+ Quality V1 data. The IG's
+      The test kit has separate suites for each supported implementation guide.
+      The v0.5.0 suites cover USCDI+ Quality V1 data, and the v1.0.0-ballot
+      suites cover Draft USCDI+ Quality V2 data.
+
+      The 2026 US Quality Core Implementation Guide v0.5.0 is derived from
+      QI-Core STU 6 and includes inherited profiles to ease adoption, but its
+      conformance requirements are focused on USCDI+ Quality V1 data. The v0.5.0 IG's
       [USCDI+ Quality mapping](https://fhir.org/guides/onc/us-quality-core/uscdiquality.html)
       identifies the in-scope V1 data elements. For conformance,
       implementations are expected to support profile types with at least one
@@ -48,7 +53,7 @@ module USQualityCoreTestKit
       The US Quality Core Server Suite verifies support for the IG's in-scope
       profile, element, and API requirements. It includes:
 
-      * Support for in-scope US Quality Core and US Core profiles that implement USCDI+ Quality V1 data elements
+      * Support for in-scope US Quality Core and US Core profiles that implement USCDI+ Quality V1 or Draft USCDI+ Quality V2 data elements, as applicable to the selected suite
       * Support for USCDI+ Quality-flagged elements and inherited US Core MustSupport elements
       * Support for FHIR read and search operations required by the [US Quality Core Server CapabilityStatement](https://fhir.org/guides/onc/us-quality-core/CapabilityStatement-us-quality-core-server.html)
       * Support for base FHIR requirements and terminology bindings, with validation performed by the HL7 FHIR Validator using tx.fhir.org
@@ -62,11 +67,14 @@ module USQualityCoreTestKit
       * The ability to request profile-conformant data from Inferno's simulated US Quality Core server
       * Support for read and search interaction requests described by the [US Quality Core CapabilityStatements](https://fhir.org/guides/onc/us-quality-core/capability-statements.html)
 
-      ## Repository
+      ## Repository and Documentation
 
       The [US Quality Core Test Kit](https://github.com/inferno-framework/us-quality-core-test-kit)
       repository contains the source code for this test kit.
 
+      For setup and test-use guidance, see the [US Quality Core Test Kit
+      documentation](https://github.com/inferno-framework/us-quality-core-test-kit/wiki),
+      including the [Preset Walkthrough](https://github.com/inferno-framework/us-quality-core-test-kit/wiki/Preset-Walkthrough).
 
       ## Providing Feedback and Reporting Issues
 
@@ -85,7 +93,9 @@ module USQualityCoreTestKit
 
     suite_ids %i[
       us_quality_core_v050
+      us_quality_core_v100_ballot
       us_quality_core_client_v050
+      us_quality_core_client_v100_ballot
     ]
 
     tags ['US Quality Core']

data/lib/us_quality_core_test_kit/practitioner_address_test.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module USQualityCoreTestKit
+  module PractitionerAddressTest
+    include SearchTest
+    include ReferenceResolutionTest
+    include MustSupportTest
+
+    MUST_SUPPORT_ELEMENTS = [
+      { path: 'address' },
+      { path: 'address.line' },
+      { path: 'address.city' },
+      { path: 'address.state' },
+      { path: 'address.postalCode' },
+      { path: 'address.country' }
+    ].freeze
+
+    def resource_type
+      'Practitioner'
+    end
+
+    def scratch_resources
+      scratch[:practitioner_resource] ||= {}
+    end
+
+    def verify_practitioner_address
+      references = scratch.dig(:references, 'Practitioner')
+      assert references&.any?, 'No Practitioner references found.'
+
+      @missing_elements = MUST_SUPPORT_ELEMENTS
+      practitioners = []
+
+      references.each do |reference_info|
+        reference = reference_info[:reference]
+        resolved_resource = resolve_reference(reference)
+
+        if resolved_resource.nil? ||
+           resolved_resource.resourceType != resource_type ||
+           resolved_resource.id != reference.reference_id
+          next
+        end
+
+        practitioners << resolved_resource
+
+        some_missing_elements = find_missing_elements([resolved_resource], MUST_SUPPORT_ELEMENTS)
+        @missing_elements &= some_missing_elements
+
+        break if @missing_elements.empty?
+      end
+
+      missing_elements_string = @missing_elements.map { |element| missing_element_string(element) }
+      support_practitioner_role = false
+
+      if @missing_elements.any?
+        resource_type = 'PractitionerRole'
+        support_practitioner_role = practitioners.any? do |practitioner|
+          search_params = { practitioner: practitioner.id }
+
+          search_and_check_response(search_params, resource_type)
+
+          practitioner_roles = fetch_all_bundled_resources(resource_type:)
+                               .select { |resource| resource.resourceType == resource_type }
+
+          next false if practitioner_roles.empty?
+          next true if config.options[:skip_practitioner_role_validation]
+
+          target_profile_with_version =
+            "http://hl7.org/fhir/us/quality-core/StructureDefinition/us-quality-core-practitionerrole|#{metadata.profile_version}"
+
+          practitioner_roles.any? { |pr| resource_is_valid_with_target_profile?(pr, target_profile_with_version) }
+        end
+      end
+
+      missing_must_support_message = 'Could not find US Quality Core PractitionerRole Profile resources and ' \
+                                     "these MustSupport elements #{missing_elements_string.join(', ')} " \
+                                     'in US Core Quality Practitioner Profile resources. ' \
+                                     'Please use patients with more information.'
+
+      assert (support_practitioner_role || @missing_elements.blank?), missing_must_support_message
+    end
+
+    def get_practitioner_ids(references)
+      references.map { |reference| reference.reference&.split('/')&.last }.compact.uniq
+    end
+  end
+end

data/lib/us_quality_core_test_kit/search_test.rb

@@ -144,8 +144,6 @@ module USQualityCoreTestKit
         resource.resourceType == resource_type
       end
 
-      filter_devices(post_search_resources) if resource_type == 'Device'
-
       get_resource_count = get_search_resources.length
       post_resource_count = post_search_resources.length
 

data/lib/us_quality_core_test_kit/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module USQualityCoreTestKit
-  VERSION = '0.1.2'
-  LAST_UPDATED = '2026-07-13'
+  VERSION = '0.2.0'
+  LAST_UPDATED = '2026-09-10'
 end

data/lib/us_quality_core_test_kit.rb

@@ -6,6 +6,8 @@ require_relative 'us_quality_core_test_kit/metadata'
 
 # Server Suites
 require_relative 'us_quality_core_test_kit/generated/v0.5.0/us_quality_core_test_suite'
+require_relative 'us_quality_core_test_kit/generated/v1.0.0-ballot/us_quality_core_test_suite'
 
 # Client Suites
 require_relative 'us_quality_core_test_kit/client/generated/v0.5.0/us_quality_core_client_test_suite'
+require_relative 'us_quality_core_test_kit/client/generated/v1.0.0-ballot/us_quality_core_client_test_suite'