davinci_us_drug_formulary_test_kit 0.12.1 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5f79e24334e2b824a36557f5a1928e6512f6a9d36b36cf99698ddfad9cf62efb
-  data.tar.gz: d4540c4c4a6048c53c4f2aa5e7e946d6d1d1ebb49380637fd7023c41e0bf7af1
+  metadata.gz: 215d9603580e8b0a77e5cd1ef9095456d6d30c8876d2858a9c223128e08da49a
+  data.tar.gz: 55c52f1fc5b4e7a52624787311e22dfecf33390d85ccd5fc75cfa52a277b8831
 SHA512:
-  metadata.gz: 22e347a051dae9e27137936325d9e4f6df4f2da1dbf3d640b2a1e3c71e82c61e9f9a561adab302aa25d3ba34972e40b152c58fab033c9f5538088f6801de6dd3
-  data.tar.gz: b15c56c6119cf032bfe380f431811202a94f88f02396258d14f22500ccfa4b1119d0b605bf4c0c2c4deaa0e489e0da2a32c50c0d9a86e4a99b81cdcfd37a9023
+  metadata.gz: d0a824408e61856f04c674c65286c595693f718892fe26c7a7922f160552d56e2b43d7345a543f14687e35a11940ba139c9362d8b54db303f28fb1fb94ba1bbc
+  data.tar.gz: de7a06f843eb3f09a2ad0ed8679f956b03bccff450d89e9957353fcf2dc1105b41daaacc7cd28ce4908f64015399766e1365cb5cac54f7a358f8e120defb537d

data/lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation/authenticated_api_security.rb

@@ -0,0 +1,41 @@
+require_relative '../../../generated/v2.0.1/urls'
+
+module DaVinciUSDrugFormularyTestKit
+  module USDFV201
+    class FormularyAuthenticatedApiSecurityTest < Inferno::Test
+      include URLs
+
+      title 'Protects PHI/PII in authenticated access and prevents tracking in unauthenticated access'
+
+      description <<~DESCRIPTION
+        The Health IT Module enforces proper security and privacy handling of formulary data:
+
+        - Authenticated access to formulary services containing PHI/PII is protected using authorized, authenticated transactions in accordance with the HRex Security and Privacy framework.
+        - The system does **not** retain any information through unauthenticated API access that could associate medication queries with the consumer.
+      DESCRIPTION
+
+      id :usdf_v201_authenticated_api_security
+
+      verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@1',
+                            'hl7.fhir.us.davinci-drug-formulary_2.0.1@3'
+
+      run do
+        identifier = SecureRandom.hex(32)
+
+        wait(
+          identifier:,
+          message: <<~MESSAGE
+            The developer of the Health IT Module attests that:
+
+            - Authenticated access to formulary services containing PHI/PII is protected using authorized, authenticated transactions in accordance with the HRex Security and Privacy framework.
+            - The system does **not** retain any information through unauthenticated API access that could associate medication queries with the consumer.
+
+            [Click here](#{resume_pass_url}?token=#{identifier}) if the system **meets** these requirements.
+
+            [Click here](#{resume_fail_url}?token=#{identifier}) if the system **does not meet** these requirements.
+          MESSAGE
+        )
+      end
+    end
+  end
+end

data/lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation/drug_display_name.rb

@@ -0,0 +1,36 @@
+require_relative '../../../generated/v2.0.1/urls'
+
+module DaVinciUSDrugFormularyTestKit
+  module USDFV201
+    class FormularyDrugNameSearchDisplayTest < Inferno::Test
+      include URLs
+
+      title 'Supports drug name search using general drug form group codes and names'
+
+      description <<~DESCRIPTION
+        The Health IT Module supports searching for drugs using general drug form group codes (SCDG or SBDG)
+        and ensures that the display name associated with those codes is included in search results.
+      DESCRIPTION
+
+      id :usdf_v201_drug_display_name
+
+      verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@19'
+
+      run do
+        identifier = SecureRandom.hex(32)
+
+        wait(
+          identifier:,
+          message: <<~MESSAGE
+            I attest that the Health IT Module supports searching for drugs using general drug form
+            group codes (SCDG or SBDG) and ensures that the display name associated with those codes is included in search results.
+
+            [Click here](#{resume_pass_url}?token=#{identifier}) if the system **meets** this requirement.
+
+            [Click here](#{resume_fail_url}?token=#{identifier}) if the system **does not meet** this requirement.
+          MESSAGE
+        )
+      end
+    end
+  end
+end

data/lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation/hrex_conformance.rb

@@ -0,0 +1,40 @@
+require_relative '../../../generated/v2.0.1/urls'
+
+module DaVinciUSDrugFormularyTestKit
+  module USDFV201
+    class FormularyHRexConformanceTest < Inferno::Test
+      include URLs
+
+      title 'Conforms to HRex conformance expectations'
+
+      description <<~DESCRIPTION
+        The Health IT Module conforms
+        to the expectations described in the HRex Conformance Expectations section:
+
+        https://hl7.org/fhir/us/davinci-hrex/STU1/conformance.html
+      DESCRIPTION
+
+      id :usdf_v201_hrex_conformance
+
+      verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@52'
+
+      run do
+        identifier = SecureRandom.hex(32)
+
+        wait(
+          identifier:,
+          message: <<~MESSAGE
+            The developer of the Health IT Module attests that the system conforms
+            to the expectations described in the HRex Conformance Expectations section:
+
+            https://hl7.org/fhir/us/davinci-hrex/STU1/conformance.html
+
+            [Click here](#{resume_pass_url}?token=#{identifier}) if the system **meets** this requirement.
+
+            [Click here](#{resume_fail_url}?token=#{identifier}) if the system **does not meet** this requirement.
+          MESSAGE
+        )
+      end
+    end
+  end
+end

data/lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation/member_scoped_access.rb

@@ -0,0 +1,45 @@
+require_relative '../../../generated/v2.0.1/urls'
+
+module DaVinciUSDrugFormularyTestKit
+  module USDFV201
+    class FormularyMemberScopedAccessTest < Inferno::Test
+      include URLs
+
+      title 'Returns plan-appropriate formulary data through authenticated access'
+
+      description <<~DESCRIPTION
+        When queried through authenticated access, the Health IT Module returns:
+          - All Formularies associated with the member’s group(s), if applicable,
+          - Only generally available (non-group-restricted) Formularies if the member is not in a group.
+
+        The Health IT Module also provides access to profiled resources (FormularyItem, FormularyDrug) tied to the member’s available plans.
+      DESCRIPTION
+
+      id :usdf_v201_member_scoped_access
+
+      verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@4',
+                            'hl7.fhir.us.davinci-drug-formulary_2.0.1@5',
+                            'hl7.fhir.us.davinci-drug-formulary_2.0.1@11'
+
+      run do
+        identifier = SecureRandom.hex(32)
+
+        wait(
+          identifier:,
+          message: <<~MESSAGE
+            The developer of the Health IT Module attests that:
+
+            - When queried through authenticated access, the Health IT Module returns:
+              - All Formularies associated with the member’s group(s), if applicable,
+              - Only generally available (non-group-restricted) Formularies if the member is not in a group.
+            - The Health IT Module also provides access to profiled resources (FormularyItem, FormularyDrug) tied to the member’s available plans.
+
+            [Click here](#{resume_pass_url}?token=#{identifier}) if the system **meets** these requirements.
+
+            [Click here](#{resume_fail_url}?token=#{identifier}) if the system **does not meet** these requirements.
+          MESSAGE
+        )
+      end
+    end
+  end
+end

data/lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation/rxnorm_coding.rb

@@ -0,0 +1,36 @@
+require_relative '../../../generated/v2.0.1/urls'
+
+module DaVinciUSDrugFormularyTestKit
+  module USDFV201
+    class FormularyRxNormCodingTest < Inferno::Test
+      include URLs
+
+      title 'Includes RxNorm SCDG/SBDG codes for SCD/SBD drug types'
+
+      description <<~DESCRIPTION
+        The Health IT Module includes an additional coding repetition for each drug with
+        RxNorm Term Type of SCD or SBD, using the corresponding SCDG or SBDG code.
+      DESCRIPTION
+
+      id :usdf_v201_rxnorm_coding
+
+      verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@14'
+
+      run do
+        identifier = SecureRandom.hex(32)
+
+        wait(
+          identifier:,
+          message: <<~MESSAGE
+            The developer of the Health IT Module attests that the system includes an additional coding repetition
+            for each drug with RxNorm Term Type of SCD or SBD, using the corresponding SCDG or SBDG code.
+
+            [Click here](#{resume_pass_url}?token=#{identifier}) if the system **meets** this requirement.
+
+            [Click here](#{resume_fail_url}?token=#{identifier}) if the system **does not meet** this requirement.
+          MESSAGE
+        )
+      end
+    end
+  end
+end

data/lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation.rb

@@ -0,0 +1,27 @@
+require_relative 'visual_inspection_and_attestation/authenticated_api_security'
+require_relative 'visual_inspection_and_attestation/member_scoped_access'
+require_relative 'visual_inspection_and_attestation/drug_display_name'
+require_relative 'visual_inspection_and_attestation/hrex_conformance'
+require_relative 'visual_inspection_and_attestation/rxnorm_coding'
+
+module DaVinciUSDrugFormularyTestKit
+  module USDFV201
+    class PDexUSDFVisualInspectionAndAttestationGroup < Inferno::TestGroup
+      id :usdf_v201_visual_inspection_and_attestation
+      title 'Visual Inspection and Attestation'
+
+      description <<~DESCRIPTION
+        Perform visual inspections or attestations to ensure that the Health IT Module is conformant
+        to the Da Vinci Payer Data Exchange US Drug Formulary IG requirements.
+      DESCRIPTION
+
+      run_as_group
+
+      test from: :usdf_v201_authenticated_api_security
+      test from: :usdf_v201_member_scoped_access
+      test from: :usdf_v201_drug_display_name
+      test from: :usdf_v201_hrex_conformance
+      test from: :usdf_v201_rxnorm_coding
+    end
+  end
+end

data/lib/davinci_us_drug_formulary_test_kit/fhir_resource_navigation.rb

@@ -16,7 +16,7 @@ module DaVinciUSDrugFormularyTestKit
       end.compact
     end
 
-    def find_a_value_at(element, path, include_dar: false, &)
+    def find_a_value_at(element, path, include_dar: false, &block) # rubocop:disable Style/ArgumentsForwarding
       return nil if element.nil?
 
       elements = Array.wrap(element)
@@ -28,7 +28,7 @@ module DaVinciUSDrugFormularyTestKit
           end
         end
 
-        return elements.find(&) if block_given?
+        return elements.find(&block) if block_given? # rubocop:disable Style/ArgumentsForwarding
 
         return elements.first
       end

data/lib/davinci_us_drug_formulary_test_kit/generated/v2.0.1/urls.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module DaVinciUSDrugFormularyTestKit
+  module USDFV201
+    RESUME_PASS_PATH = '/resume_pass'
+    RESUME_FAIL_PATH = '/resume_fail'
+
+    # URLs
+    module URLs
+      def base_url
+        @base_url ||= "#{Inferno::Application['base_url']}/custom/#{suite_id}"
+      end
+
+      def resume_pass_url
+        @resume_pass_url ||= base_url + RESUME_PASS_PATH
+      end
+
+      def resume_fail_url
+        @resume_fail_url ||= base_url + RESUME_FAIL_PATH
+      end
+
+      def suite_id
+        USDFTestSuite.id
+      end
+    end
+  end
+end

data/lib/davinci_us_drug_formulary_test_kit/generated/v2.0.1/usdf_test_suite.rb

@@ -1,4 +1,5 @@
 require_relative '../../version'
+require_relative 'urls'
 require_relative '../../custom_groups/v2.0.1/capability_statement_group'
 require_relative 'payer_insurance_plan_group'
 require_relative 'formulary_group'
@@ -6,6 +7,8 @@ require_relative 'basic_group'
 require_relative 'medication_knowledge_group'
 require_relative 'location_group'
 
+require_relative '../../custom_groups/v2.0.1/visual_inspection_and_attestation'
+
 module DaVinciUSDrugFormularyTestKit
   module USDFV201
     class USDFTestSuite < Inferno::TestSuite
@@ -117,12 +120,26 @@ module DaVinciUSDrugFormularyTestKit
         auth_info :smart_auth_info
       end
 
+      resume_test_route :get, RESUME_PASS_PATH do |request|
+        request.query_parameters['token']
+      end
+      resume_test_route :get, RESUME_FAIL_PATH, result: 'fail' do |request|
+        request.query_parameters['token']
+      end
+
       group from: :usdf_v201_capability_statement do
         verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@51', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@53',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@54'
       end
   
       group from: :usdf_v201_payer_insurance_plan do
+        input :url,
+          title: 'FHIR Endpoint',
+          description: 'URL of the FHIR endpoint'
+        input :smart_auth_info,
+          title: 'OAuth Credentials',
+          type: :auth_info,
+          optional: true
         verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@20', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@21',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@22', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@23',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@24', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@25',
@@ -131,6 +148,13 @@ module DaVinciUSDrugFormularyTestKit
       end
       
       group from: :usdf_v201_formulary do
+        input :url,
+          title: 'FHIR Endpoint',
+          description: 'URL of the FHIR endpoint'
+        input :smart_auth_info,
+          title: 'OAuth Credentials',
+          type: :auth_info,
+          optional: true
         verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@20', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@21',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@22', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@23',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@24', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@25',
@@ -139,6 +163,13 @@ module DaVinciUSDrugFormularyTestKit
       end
       
       group from: :usdf_v201_basic do
+        input :url,
+          title: 'FHIR Endpoint',
+          description: 'URL of the FHIR endpoint'
+        input :smart_auth_info,
+          title: 'OAuth Credentials',
+          type: :auth_info,
+          optional: true
         verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@36', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@37',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@38', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@39',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@40', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@41',
@@ -147,6 +178,13 @@ module DaVinciUSDrugFormularyTestKit
       end
       
       group from: :usdf_v201_medication_knowledge do
+        input :url,
+          title: 'FHIR Endpoint',
+          description: 'URL of the FHIR endpoint'
+        input :smart_auth_info,
+          title: 'OAuth Credentials',
+          type: :auth_info,
+          optional: true
         verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@15', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@16',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@17', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@45',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@46', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@47',
@@ -155,11 +193,21 @@ module DaVinciUSDrugFormularyTestKit
       end
       
       group from: :usdf_v201_location do
+        input :url,
+          title: 'FHIR Endpoint',
+          description: 'URL of the FHIR endpoint'
+        input :smart_auth_info,
+          title: 'OAuth Credentials',
+          type: :auth_info,
+          optional: true
         verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@30', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@31',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@32', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@33',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@34', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@35'
       end
       
+      group from: :usdf_v201_visual_inspection_and_attestation do
+        optional
+      end
     end
   end
 end

data/lib/davinci_us_drug_formulary_test_kit/generator/templates/suite.rb.erb

@@ -1,7 +1,12 @@
 require_relative '../../version'
+require_relative 'urls'
 require_relative '<%= capability_statement_file_name %>'
 <% group_file_list.each do |file_name| %>require_relative '<%= file_name %>'
 <% end %>
+<%- if module_name.include?('USDFV201') -%>
+require_relative '../../custom_groups/v2.0.1/visual_inspection_and_attestation'
+<%- end -%>
+
 module DaVinciUSDrugFormularyTestKit
   module <%= module_name %>
     class <%= class_name %> < Inferno::TestSuite
@@ -114,12 +119,26 @@ module DaVinciUSDrugFormularyTestKit
         auth_info :smart_auth_info
       end
 
+      resume_test_route :get, RESUME_PASS_PATH do |request|
+        request.query_parameters['token']
+      end
+      resume_test_route :get, RESUME_FAIL_PATH, result: 'fail' do |request|
+        request.query_parameters['token']
+      end
+
       group from: :<%= capability_statement_group_id %> do
         verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@51', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@53',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@54'
       end
   <% group_id_list.each do |id| %>
       group from: :<%= id %> do
+        input :url,
+          title: 'FHIR Endpoint',
+          description: 'URL of the FHIR endpoint'
+        input :smart_auth_info,
+          title: 'OAuth Credentials',
+          type: :auth_info,
+          optional: true
       <%- if id.include?('usdf_v201_payer_insurance_plan') -%>
         verifies_requirements 'hl7.fhir.us.davinci-drug-formulary_2.0.1@20', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@21',
                               'hl7.fhir.us.davinci-drug-formulary_2.0.1@22', 'hl7.fhir.us.davinci-drug-formulary_2.0.1@23',
@@ -151,6 +170,11 @@ module DaVinciUSDrugFormularyTestKit
       <%- end -%>
       end
       <% end %>
+      <%- if module_name.include?('USDFV201') -%>
+      group from: :usdf_v201_visual_inspection_and_attestation do
+        optional
+      end
+      <%- end -%>
     end
   end
 end

data/lib/davinci_us_drug_formulary_test_kit/generator/templates/urls.rb.erb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module DaVinciUSDrugFormularyTestKit
+  module <%= module_name %>
+    RESUME_PASS_PATH = '/resume_pass'
+    RESUME_FAIL_PATH = '/resume_fail'
+
+    # URLs
+    module URLs
+      def base_url
+        @base_url ||= "#{Inferno::Application['base_url']}/custom/#{suite_id}"
+      end
+
+      def resume_pass_url
+        @resume_pass_url ||= base_url + RESUME_PASS_PATH
+      end
+
+      def resume_fail_url
+        @resume_fail_url ||= base_url + RESUME_FAIL_PATH
+      end
+
+      def suite_id
+        <%= suite_class_name %>.id
+      end
+    end
+  end
+end

data/lib/davinci_us_drug_formulary_test_kit/generator/urls_generator.rb

@@ -0,0 +1,46 @@
+module DaVinciUSDrugFormularyTestKit
+  class Generator
+    class UrlsGenerator
+      class << self
+        def generate(ig_metadata, base_output_dir)
+          new(ig_metadata, base_output_dir).generate
+        end
+      end
+
+      attr_accessor :ig_metadata, :base_output_dir
+
+      def initialize(ig_metadata, base_output_dir)
+        self.ig_metadata = ig_metadata
+        self.base_output_dir = base_output_dir
+      end
+
+      def template
+        @template ||= File.read(File.join(__dir__, 'templates', 'urls.rb.erb'))
+      end
+
+      def output
+        @output ||= ERB.new(template, trim_mode: '-').result(binding)
+      end
+
+      def base_output_file_name
+        'urls.rb'
+      end
+
+      def suite_class_name
+        'USDFTestSuite'
+      end
+
+      def module_name
+        "USDF#{ig_metadata.reformatted_version.upcase}"
+      end
+
+      def output_file_name
+        File.join(base_output_dir, base_output_file_name)
+      end
+
+      def generate
+        File.write(output_file_name, output)
+      end
+    end
+  end
+end

data/lib/davinci_us_drug_formulary_test_kit/generator.rb

@@ -11,6 +11,7 @@ require_relative 'generator/search_test_generator'
 require_relative 'generator/suite_generator'
 require_relative 'generator/validation_test_generator'
 require_relative 'generator/include_search_test_generator'
+require_relative 'generator/urls_generator'
 
 module DaVinciUSDrugFormularyTestKit
   class Generator
@@ -37,6 +38,7 @@ module DaVinciUSDrugFormularyTestKit
       generate_validation_tests
       generate_must_support_tests
       generate_reference_resolution_tests
+      generate_urls
 
       generate_groups
 
@@ -90,5 +92,9 @@ module DaVinciUSDrugFormularyTestKit
     def generate_suites
       SuiteGenerator.generate(ig_metadata, base_output_dir)
     end
+
+    def generate_urls
+      UrlsGenerator.generate(ig_metadata, base_output_dir)
+    end
   end
 end

data/lib/davinci_us_drug_formulary_test_kit/requirements/generated/davinci_us_drug_formulary_v201_requirements_coverage.csv

@@ -1,11 +1,11 @@
 Req Set,ID,URL,Requirement,Conformance,Actors,Conditionality,Not Tested Reason,Not Tested Details,DaVinci US Drug Formulary v2.0.1 Short ID(s),DaVinci US Drug Formulary v2.0.1 Full ID(s)
-hl7.fhir.us.davinci-drug-formulary_2.0.1,1,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#access-methods,"Authenticated API: Access to the formulary service when integrated with protected health information (PHI) or personally identifiable information (PII) as part of the Patient Access API SHALL be protected through an authorized, authenticated transaction as described in the Da Vinci Health Record Exchange (HRex) FHIR Implementation Guide Security and Privacy Section [[link](https://hl7.org/fhir/us/davinci-hrex/STU1/security.html)].",SHALL,Server,true,,,"",""
+hl7.fhir.us.davinci-drug-formulary_2.0.1,1,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#access-methods,"Authenticated API: Access to the formulary service when integrated with protected health information (PHI) or personally identifiable information (PII) as part of the Patient Access API SHALL be protected through an authorized, authenticated transaction as described in the Da Vinci Health Record Exchange (HRex) FHIR Implementation Guide Security and Privacy Section [[link](https://hl7.org/fhir/us/davinci-hrex/STU1/security.html)].",SHALL,Server,true,,,7.01,davinci_us_drug_formulary_v201-usdf_v201_visual_inspection_and_attestation-usdf_v201_authenticated_api_security
 hl7.fhir.us.davinci-drug-formulary_2.0.1,2,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#access-methods,"Unauthenticated API: When exchanging formulary data exclusively, which is public information without any PHI or PII, the formulary service MAY also be accessed through an API that does not require authentication or authorization.",MAY,Server,true,,,"",""
-hl7.fhir.us.davinci-drug-formulary_2.0.1,3,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#access-methods,The formulary server SHALL NOT maintain any records through the unauthenticated API that could associate the consumer with the medications queried.,SHALL NOT,Server,false,,,"",""
+hl7.fhir.us.davinci-drug-formulary_2.0.1,3,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#access-methods,The formulary server SHALL NOT maintain any records through the unauthenticated API that could associate the consumer with the medications queried.,SHALL NOT,Server,false,,,7.01,davinci_us_drug_formulary_v201-usdf_v201_visual_inspection_and_attestation-usdf_v201_authenticated_api_security
 hl7.fhir.us.davinci-drug-formulary_2.0.1,4,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#authenticated,"When accessing data through an authenticated API, the response for queries on InsurancePlan depends on whether the authenticated member has access to the plan in relation to their membership.
-... For Formulary, this means all Formularies that are generally available to the member. If the member is in a group, all group associated formularies are returned.",SHALL,Server,true,,,"",""
+... For Formulary, this means all Formularies that are generally available to the member. If the member is in a group, all group associated formularies are returned.",SHALL,Server,true,,,7.02,davinci_us_drug_formulary_v201-usdf_v201_visual_inspection_and_attestation-usdf_v201_member_scoped_access
 hl7.fhir.us.davinci-drug-formulary_2.0.1,5,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#authenticated,"When accessing data through an authenticated API, the response for queries on InsurancePlan depends on whether the authenticated member has access to the plan in relation to their membership.
-... For Formulary, this means all Formularies that are generally available to the member. If the member is ... not in a group, all generally available formularies (that is, those that are not restricted to only one or more groups) are returned.",SHALL,Server,true,,,"",""
+... For Formulary, this means all Formularies that are generally available to the member. If the member is ... not in a group, all generally available formularies (that is, those that are not restricted to only one or more groups) are returned.",SHALL,Server,true,,,7.02,davinci_us_drug_formulary_v201-usdf_v201_visual_inspection_and_attestation-usdf_v201_member_scoped_access
 hl7.fhir.us.davinci-drug-formulary_2.0.1,7,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#authenticated,"how the Formulary API should respond to requests…
 
 InsurancePlan specified – GET by resource ID 
@@ -26,15 +26,15 @@ hl7.fhir.us.davinci-drug-formulary_2.0.1,10,https://hl7.org/fhir/us/davinci-drug
 InsurancePlan reference not specified - Search
 
 [if no plans are] covered by insurer and included in group if member is part of a group… return 200",SHOULD,Server,true,,,"",""
-hl7.fhir.us.davinci-drug-formulary_2.0.1,11,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#authenticated,"Server implementers SHALL make other profiled resources in this IG (FormularyItem, FormularyDrug) associated to a member’s available plans available through authenticated access. This IG does not define restrictions on authenticated access to resources not associated with a member’s available plan or the Plan Location resource.",SHALL,Server,false,,,"",""
+hl7.fhir.us.davinci-drug-formulary_2.0.1,11,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#authenticated,"Server implementers SHALL make other profiled resources in this IG (FormularyItem, FormularyDrug) associated to a member’s available plans available through authenticated access. This IG does not define restrictions on authenticated access to resources not associated with a member’s available plan or the Plan Location resource.",SHALL,Server,false,,,7.02,davinci_us_drug_formulary_v201-usdf_v201_visual_inspection_and_attestation-usdf_v201_member_scoped_access
 hl7.fhir.us.davinci-drug-formulary_2.0.1,12,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#unauthenticated,"When accessing data through an unauthenticated API, the conformant payer formulary service SHALL NOT require an application to send consumer identifying information in order to query for the list of health plans provided by that payer and the medication and costs for each plan.",SHALL NOT,Server,true,,,"",""
 hl7.fhir.us.davinci-drug-formulary_2.0.1,13,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#resource-relationships,"Additionally, a more general RxNorm semantic drug form group code **SHOULD** be present for searching across drugs with the same ingredient, brand, and form (regardless of strength).",SHOULD,Server,false,,,"",""
-hl7.fhir.us.davinci-drug-formulary_2.0.1,14,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#resource-relationships,All drugs with RxNorm Term Type of SCD or SBD **SHALL** have a coding repetition and RxNorm Term Type of SCDG or SBDG respectively.,SHALL,Server,true,,,"",""
+hl7.fhir.us.davinci-drug-formulary_2.0.1,14,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#resource-relationships,All drugs with RxNorm Term Type of SCD or SBD **SHALL** have a coding repetition and RxNorm Term Type of SCDG or SBDG respectively.,SHALL,Server,true,,,7.05,davinci_us_drug_formulary_v201-usdf_v201_visual_inspection_and_attestation-usdf_v201_rxnorm_coding
 hl7.fhir.us.davinci-drug-formulary_2.0.1,15,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#searching-by-drug-code,"Servers **SHALL** support a MedicationKnowledge.code.coding repetition including the detailed drug, strength, and form, including RxNorm Term Types (TTY) of SCD (Semantic Clinical Drug), SBD Semantic Branded Drug), GPCK (Generic Pack), or BPCK (Branded Pack).",SHALL,Server,false,,,5,davinci_us_drug_formulary_v201-usdf_v201_medication_knowledge
 hl7.fhir.us.davinci-drug-formulary_2.0.1,16,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#searching-by-drug-code,"Additionally, servers **SHALL** support a MedicationKnowledge.code.coding repetition including the general RxNorm code (and name) with Term Type of SCDG (Semantic Clinical Drug Form Group) or SBDG (Semantic Branded Drug Form Group) when there is a concept matching the primary code represented by the Term Type SCD or SBD respectively. This requirement includes using the respective RxNorm name in the display of the coding repetition.",SHALL,Server,true,,,5,davinci_us_drug_formulary_v201-usdf_v201_medication_knowledge
 hl7.fhir.us.davinci-drug-formulary_2.0.1,17,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#searching-by-drug-code,Searches for drugs with the above RxNorm Term Types (SCDG and SBDG) by either code will provide the client with a way to search for drugs without a specified strength.,SHALL,Server,true,,,5,davinci_us_drug_formulary_v201-usdf_v201_medication_knowledge
 hl7.fhir.us.davinci-drug-formulary_2.0.1,18,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#searching-by-drug-name,Servers are required to support the more general drug form group code and name where one exists.,SHALL,Server,false,,,"",""
-hl7.fhir.us.davinci-drug-formulary_2.0.1,19,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#searching-by-drug-name,This display name will be included in any drug name search for which the general drug form group code exists.,SHALL,Server,false,,,"",""
+hl7.fhir.us.davinci-drug-formulary_2.0.1,19,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#searching-by-drug-name,This display name will be included in any drug name search for which the general drug form group code exists.,SHALL,Server,false,,,7.03,davinci_us_drug_formulary_v201-usdf_v201_visual_inspection_and_attestation-usdf_v201_drug_display_name
 hl7.fhir.us.davinci-drug-formulary_2.0.1,20,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/search_parameters.html#payerinsuranceplan--formulary-insuranceplan,"Search Parameters Required by This Implementation Guide…
 PayerInsurancePlan & Formulary (InsurancePlan)…
 
@@ -160,6 +160,6 @@ FormularyDrug (MedicationKnowledge)…
 
 doseform",SHOULD,Server,false,,,5,davinci_us_drug_formulary_v201-usdf_v201_medication_knowledge
 hl7.fhir.us.davinci-drug-formulary_2.0.1,51,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/CapabilityStatement-usdf-server.html,[Section 6 auto-generated from capability statement],SHALL,Server,false,,,1,davinci_us_drug_formulary_v201-usdf_v201_capability_statement
-hl7.fhir.us.davinci-drug-formulary_2.0.1,52,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#conformance-expectations,This guide inherits all conformance expectations identified in the Health Record Exchange (Hrex) Conformance Expectations section (https://hl7.org/fhir/us/davinci-hrex/STU1/conformance.html). All systems claiming conformance to this guide SHALL conform to the requirements listed in that section.,SHALL,Server,false,,,"",""
+hl7.fhir.us.davinci-drug-formulary_2.0.1,52,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#conformance-expectations,This guide inherits all conformance expectations identified in the Health Record Exchange (Hrex) Conformance Expectations section (https://hl7.org/fhir/us/davinci-hrex/STU1/conformance.html). All systems claiming conformance to this guide SHALL conform to the requirements listed in that section.,SHALL,Server,false,,,7.04,davinci_us_drug_formulary_v201-usdf_v201_visual_inspection_and_attestation-usdf_v201_hrex_conformance
 hl7.fhir.us.davinci-drug-formulary_2.0.1,53,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#conformance-expectations,Server systems claiming conformance to this guide SHALL meet the capability statement expectation requirements identified in the US Drug Formulary Server Capability Statement,SHALL,Server,false,,,1,davinci_us_drug_formulary_v201-usdf_v201_capability_statement
 hl7.fhir.us.davinci-drug-formulary_2.0.1,54,https://hl7.org/fhir/us/davinci-drug-formulary/STU2.0.1/use_cases_and_overview.html#conformance-expectations,Server systems claiming conformance to this guide… SHALL have a CapabilityStatement that has a CapabilityStatement.instantiates with a URL of http://hl7.org/fhir/us/davinci-drug-formulary/CapabilityStatement/usdf-server or a URL to the appropriate version of the CapabilityStatement.,SHALL,Server,false,,,1,davinci_us_drug_formulary_v201-usdf_v201_capability_statement

data/lib/davinci_us_drug_formulary_test_kit/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module DaVinciUSDrugFormularyTestKit
-  VERSION = '0.12.1'
-  LAST_UPDATED = '2025-07-02'
+  VERSION = '0.13.0'
+  LAST_UPDATED = '2025-07-21'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: davinci_us_drug_formulary_test_kit
 version: !ruby/object:Gem::Version
-  version: 0.12.1
+  version: 0.13.0
 platform: ruby
 authors:
 - Stephen MacVicar
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-07-02 00:00:00.000000000 Z
+date: 2025-07-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: inferno_core
@@ -18,28 +18,34 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.15
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.15
+        version: '1.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.2
 - !ruby/object:Gem::Dependency
   name: tls_test_kit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.0
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: database_cleaner-sequel
   requirement: !ruby/object:Gem::Requirement
@@ -112,7 +118,6 @@ dependencies:
         version: '3.11'
 description: DaVinci US Drug Formulary Test Kit
 email:
-- inferno@groups.mitre.org
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -126,6 +131,12 @@ files:
 - lib/davinci_us_drug_formulary_test_kit/custom_groups/capability_statement/json_support_test.rb
 - lib/davinci_us_drug_formulary_test_kit/custom_groups/capability_statement/profile_support_test.rb
 - lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/capability_statement_group.rb
+- lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation.rb
+- lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation/authenticated_api_security.rb
+- lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation/drug_display_name.rb
+- lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation/hrex_conformance.rb
+- lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation/member_scoped_access.rb
+- lib/davinci_us_drug_formulary_test_kit/custom_groups/v2.0.1/visual_inspection_and_attestation/rxnorm_coding.rb
 - lib/davinci_us_drug_formulary_test_kit/date_search_validation.rb
 - lib/davinci_us_drug_formulary_test_kit/fhir_resource_navigation.rb
 - lib/davinci_us_drug_formulary_test_kit/generated/v2.0.1/basic/basic_code_search_test.rb
@@ -200,6 +211,7 @@ files:
 - lib/davinci_us_drug_formulary_test_kit/generated/v2.0.1/payer_insurance_plan/payer_insurance_plan_type_search_test.rb
 - lib/davinci_us_drug_formulary_test_kit/generated/v2.0.1/payer_insurance_plan/payer_insurance_plan_validation_test.rb
 - lib/davinci_us_drug_formulary_test_kit/generated/v2.0.1/payer_insurance_plan_group.rb
+- lib/davinci_us_drug_formulary_test_kit/generated/v2.0.1/urls.rb
 - lib/davinci_us_drug_formulary_test_kit/generated/v2.0.1/usdf_test_suite.rb
 - lib/davinci_us_drug_formulary_test_kit/generator.rb
 - lib/davinci_us_drug_formulary_test_kit/generator/group_generator.rb
@@ -227,8 +239,10 @@ files:
 - lib/davinci_us_drug_formulary_test_kit/generator/templates/reference_resolution.rb.erb
 - lib/davinci_us_drug_formulary_test_kit/generator/templates/search.rb.erb
 - lib/davinci_us_drug_formulary_test_kit/generator/templates/suite.rb.erb
+- lib/davinci_us_drug_formulary_test_kit/generator/templates/urls.rb.erb
 - lib/davinci_us_drug_formulary_test_kit/generator/templates/validation.rb.erb
 - lib/davinci_us_drug_formulary_test_kit/generator/terminology_binding_metadata_extractor.rb
+- lib/davinci_us_drug_formulary_test_kit/generator/urls_generator.rb
 - lib/davinci_us_drug_formulary_test_kit/generator/validation_test_generator.rb
 - lib/davinci_us_drug_formulary_test_kit/generator/value_extractor.rb
 - lib/davinci_us_drug_formulary_test_kit/igs/README.md