davinci_pas_test_kit 0.14.1 → 0.15.1

data/lib/davinci_pas_test_kit/cross_suite/pas_notification_verification.rb

@@ -0,0 +1,120 @@
+require_relative 'tags'
+
+module DaVinciPASTestKit
+  module PASNotificationVerification
+    PAS_RESPONSE_BUNDLE_PROFILE = 'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-pas-response-bundle'.freeze
+
+    def verify_pas_notification(notification_json_str, ig_version: 'v2.2.1') # rubocop:disable Lint/UnusedMethodArgument
+      assert_valid_json(notification_json_str)
+      notification_bundle = FHIR.from_contents(notification_json_str)
+
+      assert notification_bundle.present?, 'Not a FHIR resource'
+      assert_resource_type(:bundle, resource: notification_bundle)
+
+      assert notification_bundle.entry.present?,
+             'The notification Bundle must contain at least one entry'
+
+      # First entry is the SubscriptionStatus Parameters resource
+      subscription_status = notification_bundle.entry[0]&.resource
+      assert subscription_status&.resourceType == 'Parameters',
+             'The first entry in the notification Bundle must be a Parameters ' \
+             "(SubscriptionStatus) resource, but found `#{subscription_status&.resourceType}`"
+
+      # Extract focus references from notification-event parameters
+      focus_references = extract_focus_references(subscription_status)
+      assert focus_references.present?,
+             'The SubscriptionStatus must include at least one notification-event ' \
+             'parameter with a focus reference'
+
+      # Resolve each focus reference to a Bundle entry and validate PAS structure
+      bundle_entries = notification_bundle.entry.drop(1)
+      focus_references.each do |focus_ref|
+        focus_entry = resolve_focus_entry(focus_ref, bundle_entries)
+
+        if focus_entry.nil?
+          add_message('error', %(
+            Could not resolve focus reference `#{focus_ref}` to a Bundle entry.
+            The notification Bundle must include the focus resource.
+          ))
+          next
+        end
+
+        focus_resource = focus_entry.resource
+        if focus_resource.nil?
+          add_message('error', %(
+            The Bundle entry for focus reference `#{focus_ref}` does not contain
+            a resource.
+          ))
+          next
+        end
+
+        # Check PAS-specific structural requirements only.
+        # Profile validation is handled by the Subscription conformance tests
+        # (9.3.3.01 and 9.3.3.02) to avoid duplicate error messages.
+        validate_focus_as_response_bundle(focus_resource)
+      end
+
+      assert messages.none? { |msg| msg[:type] == 'error' },
+             'The notification does not conform to PAS requirements - see messages for details.'
+    end
+
+    private
+
+    def extract_focus_references(subscription_status)
+      return [] unless subscription_status.respond_to?(:parameter)
+
+      notification_events = subscription_status.parameter&.select do |p|
+        p.name == 'notification-event'
+      end
+      return [] if notification_events.blank?
+
+      notification_events.filter_map do |event|
+        focus_part = event.part&.find { |part| part.name == 'focus' }
+        focus_part&.valueReference&.reference
+      end
+    end
+
+    def resolve_focus_entry(reference, bundle_entries)
+      check_full_url = reference.start_with?('urn:')
+
+      bundle_entries.find do |entry|
+        if check_full_url
+          reference == entry.fullUrl
+        else
+          entry.fullUrl == reference ||
+            (entry.resource.present? &&
+             reference.include?("#{entry.resource.resourceType}/#{entry.resource.id}"))
+        end
+      end
+    end
+
+    # Validates PAS-specific structural requirements only:
+    # - Focus resource must be a Bundle
+    # - Bundle must be of type 'collection' (PAS Response Bundle)
+    # - Bundle must contain at least one ClaimResponse entry
+    def validate_focus_as_response_bundle(focus_resource)
+      if focus_resource.resourceType != 'Bundle'
+        add_message('error', %(
+          Expected the focus resource to be a Bundle (PAS Response Bundle),
+          but found `#{focus_resource.resourceType}`.
+        ))
+        return
+      end
+
+      if focus_resource.type != 'collection'
+        add_message('error', %(
+          Expected the focus Bundle to be of type 'collection' (PAS Response Bundle),
+          but found type '#{focus_resource.type}'.
+        ))
+      end
+
+      claim_response = focus_resource.entry&.find { |e| e.resource&.resourceType == 'ClaimResponse' }
+      return if claim_response.present?
+
+      add_message('error', %(
+        The focus Bundle (PAS Response Bundle) must contain at least one
+        ClaimResponse entry, but none was found.
+      ))
+    end
+  end
+end

data/lib/davinci_pas_test_kit/cross_suite/pas_subscription_verification.rb

@@ -0,0 +1,72 @@
+module DaVinciPASTestKit
+  module PASSubscriptionVerification
+    PAS_SUBSCRIPTION_PROFILE = 'http://hl7.org/fhir/us/davinci-pas/StructureDefinition/profile-subscription'.freeze
+    PAS_SUBSCRIPTION_TOPIC = 'http://hl7.org/fhir/us/davinci-pas/SubscriptionTopic/PASSubscriptionTopic'.freeze
+    BACKPORT_FILTER_CRITERIA_URL =
+      'http://hl7.org/fhir/uv/subscriptions-backport/StructureDefinition/backport-filter-criteria'.freeze
+
+    def verify_pas_subscription(subscription_json_str, ig_version: 'v2.0.1')
+      assert_valid_json(subscription_json_str)
+      subscription = JSON.parse(subscription_json_str)
+
+      if ig_version == 'v2.0.1'
+        verify_pas_subscription_v201(subscription)
+      else
+        verify_pas_subscription_v221(subscription)
+      end
+
+      assert messages.none? { |msg| msg[:type] == 'error' },
+             'The Subscription does not conform to PAS requirements - see messages for details.'
+    end
+
+    private
+
+    def verify_pas_subscription_v201(subscription)
+      unless subscription['criteria'] == PAS_SUBSCRIPTION_TOPIC
+        add_message('error', %(
+          The Subscription must use the PAS-defined Subscription topic
+          `#{PAS_SUBSCRIPTION_TOPIC}`
+          in the `Subscription.criteria` element.
+        ))
+      end
+
+      filter_criteria = subscription.dig('_criteria', 'extension')
+        &.select { |ext| ext['url'] == BACKPORT_FILTER_CRITERIA_URL }
+      return if filter_criteria&.length == 1
+
+      add_message('error', %(
+            The Subscription must include a single filter on the submitting organization
+            in the `Subscription.criteria.extension` element.
+          ))
+    end
+
+    def verify_pas_subscription_v221(subscription)
+      verify_v221_profile(subscription)
+      verify_v221_criteria_format(subscription)
+    end
+
+    def verify_v221_profile(subscription) # rubocop:disable Naming/PredicateMethod
+      resource = FHIR.from_contents(subscription.to_json)
+      resource_is_valid?(resource: resource, profile_url: PAS_SUBSCRIPTION_PROFILE)
+    end
+
+    def verify_v221_criteria_format(subscription)
+      filter_criteria = subscription.dig('_criteria', 'extension')
+        &.select { |ext| ext['url'] == BACKPORT_FILTER_CRITERIA_URL }
+
+      return if filter_criteria.blank?
+
+      filter_criteria.each do |fc|
+        value = fc['valueString']
+        # PAS v2.2.1 requires filter criteria in the format 'org-identifier=<identifier>'
+        # where <identifier> is a non-whitespace organization identifier string
+        next if value.present? && value.match?(/\Aorg-identifier=\S+\z/)
+
+        add_message('error', %(
+          The Subscription filter criteria value `#{value}` does not match
+          the expected format `org-identifier=<identifier>`.
+        ))
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/cross_suite/response_selection_utils.rb

@@ -0,0 +1,88 @@
+require_relative 'fhirpath_utils'
+
+module DaVinciPASTestKit
+  # Selection of a response from a tester-provided list of candidates. Each candidate
+  # is either a bare FHIR Bundle or a plain JSON wrapper object pairing the response
+  # Bundle ("bundle") with the selection criteria ("criteria") that the incoming
+  # request must meet for that Bundle to be returned. The wrapper is plain JSON
+  # rather than FHIR because Bundle resources cannot carry top-level extensions.
+  # Candidates are handled as parsed JSON hashes; the inner Bundle is a clean FHIR
+  # resource and needs no modification before use.
+  # Requires FhirpathUtils and access to `result` (Inferno::Entities::Result).
+  module ResponseSelectionUtils
+    CRITERIA_KEY = 'criteria'.freeze
+    BUNDLE_KEY = 'bundle'.freeze
+    REQUEST_RANGE_KEY = 'requestRange'.freeze
+    FHIRPATH_KEY = 'fhirpath'.freeze
+
+    # ***********************************************************************
+    # Candidate handling
+    # ***********************************************************************
+
+    def bare_bundle?(entity)
+      entity.is_a?(Hash) && entity['resourceType'] == 'Bundle'
+    end
+
+    def entity_bundle(entity)
+      bare_bundle?(entity) ? entity : entity[BUNDLE_KEY]
+    end
+
+    def entity_criteria(entity)
+      criteria = bare_bundle?(entity) ? nil : entity[CRITERIA_KEY]
+      criteria.is_a?(Hash) ? criteria : {}
+    end
+
+    def include_entity?(entity, request_fhir_obj, operation)
+      criteria = entity_criteria(entity)
+      return false if criteria[REQUEST_RANGE_KEY].present? &&
+                      !request_meets_request_range_criteria?(criteria[REQUEST_RANGE_KEY], operation)
+      return false if criteria[FHIRPATH_KEY].present? &&
+                      !request_meets_inclusion_criteria?(criteria[FHIRPATH_KEY], request_fhir_obj)
+
+      true
+    end
+
+    # ***********************************************************************
+    # FHIRPath-based selection criteria
+    # ***********************************************************************
+
+    def request_meets_inclusion_criteria?(expression, request_fhir_obj)
+      fhirpath_result = execute_fhirpath(request_fhir_obj, expression)
+      interpret_fhirpath_result_as_boolean(fhirpath_result)
+    end
+
+    # ***********************************************************************
+    # Request index-based selection criteria
+    # ***********************************************************************
+
+    def request_meets_request_range_criteria?(ranges, operation)
+      ranges_cover_value?(count_previous_successful_requests(operation) + 1, ranges.to_s)
+    end
+
+    def count_previous_successful_requests(operation)
+      requests_repo = Inferno::Repositories::Requests.new
+      previous_requests = requests_repo.requests_for_result(result.id)
+      previous_requests.count { |req| req.url.include?(operation) && req.status == 200 }
+    end
+
+    def ranges_cover_value?(value, ranges_string)
+      unless /\A(\d+(-\d+)?,)*\d+(-\d+)?\z/.match?(ranges_string)
+        raise ArgumentError,
+              "Invalid range string: #{ranges_string.inspect}"
+      end
+
+      ranges_string.split(',').any? do |part|
+        if part.include?('-')
+          low, high = part.split('-').map(&:to_i)
+          raise ArgumentError, "Inverted range in: #{part.inspect}" if low > high
+
+          (low..high).cover?(value)
+        else
+          part.to_i == value
+        end
+      end
+    rescue ArgumentError => e
+      raise Inferno::Exceptions::TestSuiteImplementationException.new('pas response range criteria', e.message)
+    end
+  end
+end

data/lib/davinci_pas_test_kit/cross_suite/tags.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module DaVinciPASTestKit
+  AUTH_TAG = 'pas_auth'
+  SUBMIT_TAG = 'pas_submit'
+  INQUIRE_TAG = 'pas_inquire'
+  APPROVAL_WORKFLOW_TAG = 'pas_approved_workflow'
+  DENIAL_WORKFLOW_TAG = 'pas_denied_workflow'
+  PENDED_WORKFLOW_TAG = 'pas_pended_workflow'
+  MODIFICATION_WORKFLOW_TAG = 'pas_modified_workflow'
+  MUST_SUPPORT_WORKFLOW_TAG = 'pas_must_support_workflow'
+  # Claim update workflow: a unique tag per submission so verification tests can
+  # reload each specific request (initial submit, then each subsequent update).
+  CLAIM_UPDATE_INITIAL_TAG = 'pas_claim_update_initial'
+  CLAIM_UPDATE_ADD_ITEM_TAG = 'pas_claim_update_add_item'
+  CLAIM_UPDATE_MODIFY_CANCEL_TAG = 'pas_claim_update_modify_cancel'
+  CLAIM_UPDATE_CANCEL_ALL_TAG = 'pas_claim_update_cancel_all'
+  NOTIFICATION_TAG = 'subscription_notification'
+  SUBSCRIPTION_CREATE_TAG = 'subscription_create'
+  SUBSCRIPTION_READ_TAG = 'subscription_read'
+  SUBSCRIPTION_STATUS_TAG = 'subscription_status'
+  REST_HOOK_HANDSHAKE_NOTIFICATION_TAG = 'rest_hook_handshake_notification'
+  REST_HOOK_EVENT_NOTIFICATION_TAG = 'rest_hook_event_notification'
+  OTHER_AUTH_TAG = 'other_auth'
+  OPERATION_FAILURE_WORKFLOW_TAG = 'pas_operation_failure_workflow'
+  PROCESSING_ERROR_WORKFLOW_TAG = 'pas_processing_error_workflow'
+
+  def self.use_case_tag(use_case)
+    const_get(:"#{use_case.upcase}_WORKFLOW_TAG")
+  end
+
+  def self.operation_tag(operation)
+    const_get(:"#{operation.upcase}_TAG")
+  end
+end

data/lib/davinci_pas_test_kit/cross_suite/validation_test.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module DaVinciPASTestKit
+  module ValidationTest
+    def perform_validation_test(resources,
+                                profile_url,
+                                profile_version,
+                                skip_if_empty: true)
+      skip_if skip_if_empty && resources.blank?,
+              "No #{resource_type} resources conforming to the #{profile_url} profile were returned"
+
+      omit_if resources.blank?,
+              "No #{resource_type} resources provided so the #{profile_url} profile does not apply"
+
+      profile_with_version = "#{profile_url}|#{profile_version}"
+      resources.each do |resource|
+        resource_is_valid?(resource:, profile_url: profile_with_version)
+      end
+
+      errors_found = messages.any? { |message| message[:type] == 'error' }
+
+      assert !errors_found, "Resource does not conform to the profile #{profile_with_version}"
+    end
+  end
+end

data/lib/davinci_pas_test_kit/{validator_suppressions.rb → cross_suite/validator_suppressions.rb}

@@ -119,6 +119,7 @@ module DaVinciPASTestKit
       'ValueSet https://valueset.x12.org/x217/005010/response/2010B/NM1/1/01/00/98 not found',
       # additional lines added beyond the errors suppressed in the IG
       'http://hl7.org/fhir/5.0/StructureDefinition/extension-Claim.encounter', # validator bug, https://github.com/hapifhir/org.hl7.fhir.core/issues/1556
+      'X12278DiagnosisCodes', # ValueSet includes full ICD-10-CM plus unavailable code systems; validator cannot fully expand
       'X12278RequestedServiceType', # X12 code system included in this PAS-defined value set
       'X12278LocationType', # X12 code system included in this PAS-defined value set
       'ValueSet https://valueset.x12.org/x217/005010/response/2010B/NM1/1/01/00/98 not found',
@@ -138,7 +139,28 @@ module DaVinciPASTestKit
       # addition validator clean-up based on Bundle sub-validations where Inferno error supression doesn't
       # work. The test kit validates these instances individually as well, so they are still checked,
       # but in a way that Inferno can supress errors
-      'Unable to find a match for profile'
+      'Unable to find a match for profile',
+      'Unable to find a profile match for',
+      # IG defect: extension context definitions for these extensions don't match where the profiles place them
+      # extension-authorizationNumber context allows Claim.item only, but profile-claim-base marks it must-support on Claim.extension
+      /extension-authorizationNumber( v\d+\.\d+\.\d+)? is not allowed to be used at this point/,
+      /extension-administrationReferenceNumber( v\d+\.\d+\.\d+)? is not allowed to be used at this point/,
+      /extension-communicatedDiagnosis( v\d+\.\d+\.\d+)? is not allowed to be used at this point/,
+      # IG defect: extension-productOrServiceCodeEnd context only lists Claim.item/ClaimResponse, but profile-servicerequest marks it must-support on ServiceRequest
+      /extension-productOrServiceCodeEnd( v\d+\.\d+\.\d+)? is not allowed to be used at this point/,
+      # IG defect: extension-infoChanged and modifierextension-infoCancelled context only lists Claim.item,
+      # but profile-claim-base marks them must-support on Claim.supportingInfo as well
+      /extension-infoChanged( v\d+\.\d+\.\d+)? is not allowed to be used at this point/,
+      /modifierextension-infoCancelled( v\d+\.\d+\.\d+)? is not allowed to be used at this point/,
+      # IG defect: extension-itemAuthorizedProvider context allows ExplanationOfBenefit/ClaimResponse.item only,
+      # but profile-claimresponse marks ClaimResponse.extension:authorizedProvider as must-support on ClaimResponse root
+      /extension-itemAuthorizedProvider( v\d+\.\d+\.\d+)? is not allowed to be used at this point/,
+      # IG defect: extension-revenueUnitRateLimit, extension-serviceItemRequestType, extension-certificationType
+      # context prohibits ClaimResponse.addItem, but profile-claimresponse marks all three as must-support there
+      /extension-revenueUnitRateLimit( v\d+\.\d+\.\d+)? is not allowed to be used at this point/,
+      /extension-serviceItemRequestType( v\d+\.\d+\.\d+)? is not allowed to be used at this point/,
+      /extension-certificationType( v\d+\.\d+\.\d+)? is not allowed to be used at this point/
+
     ]
   )
   # rubocop:enable Layout/LineLength

data/lib/davinci_pas_test_kit/ext/inferno_core/runnable.rb

@@ -0,0 +1,22 @@
+module Inferno
+  module DSL
+    module Runnable
+      PRE_FLIGHT_HANDLER = proc do
+        [
+          200,
+          {
+            'Access-Control-Allow-Origin' => '*',
+            'Access-Control-Allow-Headers' => 'Content-Type, Authorization'
+          },
+          ['']
+        ]
+      end
+
+      def allow_cors(*paths)
+        paths.each do |path|
+          route(:options, path, PRE_FLIGHT_HANDLER)
+        end
+      end
+    end
+  end
+end

data/lib/davinci_pas_test_kit/generator/client_must_support_group_generator.rb

@@ -0,0 +1,230 @@
+require_relative 'must_support_target_profiles'
+require_relative 'descriptions'
+
+module DaVinciPASTestKit
+  class Generator
+    class ClientMustSupportGroupGenerator
+      class << self
+        def generate(ig_metadata, base_client_output_dir)
+          submit_request_profiles = ig_metadata.profiles.select do |profile|
+            MustSupportTargetProfiles.submit_request_profile?(profile)
+          end
+          new(ig_metadata, 'submit', submit_request_profiles, base_client_output_dir).generate
+
+          submit_response_profiles = ig_metadata.profiles.select do |profile|
+            MustSupportTargetProfiles.submit_response_profile?(profile)
+          end
+          new(ig_metadata, 'submit', submit_response_profiles, base_client_output_dir, 'response').generate
+
+          inquire_request_profiles = ig_metadata.profiles.select do |profile|
+            MustSupportTargetProfiles.inquire_request_profile?(profile)
+          end
+          new(ig_metadata, 'inquire', inquire_request_profiles, base_client_output_dir).generate
+
+          inquire_response_profiles = ig_metadata.profiles.select do |profile|
+            MustSupportTargetProfiles.inquire_response_profile?(profile)
+          end
+          new(ig_metadata, 'inquire', inquire_response_profiles, base_client_output_dir, 'response').generate
+        end
+      end
+
+      attr_accessor :ig_metadata, :operation, :profiles, :base_output_dir, :type
+
+      def initialize(ig_metadata, operation, profiles, base_output_dir, type = 'request')
+        self.ig_metadata = ig_metadata
+        self.operation = operation
+        self.profiles = profiles
+        self.base_output_dir = base_output_dir
+        self.type = type
+      end
+
+      def template
+        @template ||= File.read(File.join(__dir__, 'templates', template_file_name))
+      end
+
+      def template_file_name
+        type == 'response' ? 'client_must_support_response_group.rb.erb' : 'client_must_support_group.rb.erb'
+      end
+
+      def output
+        @output ||= ERB.new(template, trim_mode: '-').result(binding)
+      end
+
+      def base_output_file_name
+        "#{class_name.underscore}.rb"
+      end
+
+      def class_name
+        if type == 'response'
+          "PASClient#{operation.camelize}ResponseMustSupportGroup"
+        else
+          "PASClient#{operation.camelize}MustSupportGroup"
+        end
+      end
+
+      def module_name
+        "DaVinciPAS#{ig_version_for_id.upcase}"
+      end
+
+      def title
+        if type == 'response'
+          return '$submit Response Must Support Coverage' if operation == 'submit'
+
+          '$inquire Response Must Support Coverage'
+        else
+          return '$submit Request Must Support Coverage' if operation == 'submit'
+
+          '$inquire Request Must Support Coverage'
+        end
+      end
+
+      def request_type
+        "#{operation}_#{type}"
+      end
+
+      def output_file_name
+        File.join(base_output_dir, base_output_file_name)
+      end
+
+      def profile_identifier(profile_metadata)
+        ig_metadata.snake_case_for_profile(profile_metadata)
+      end
+
+      def group_id
+        if type == 'response'
+          "pas_client_#{ig_version_for_id}_#{operation}_response_must_support"
+        else
+          "pas_client_#{ig_version_for_id}_#{operation}_must_support"
+        end
+      end
+
+      def ig_version
+        ig_metadata.ig_version
+      end
+
+      def ig_version_for_id
+        ig_metadata.reformatted_version
+      end
+
+      def generate
+        FileUtils.mkdir_p(base_output_dir)
+        File.write(output_file_name, output)
+      end
+
+      def required_profiles
+        @required_profiles = profiles.reject do |profile_metadata|
+          MustSupportTargetProfiles.request_profile?(profile_metadata)
+        end
+      end
+
+      def request_profiles
+        @request_profiles = profiles.select do |profile_metadata|
+          MustSupportTargetProfiles.request_profile?(profile_metadata)
+        end
+      end
+
+      def test_id_for_profile(profile_metadata)
+        "pas_client_#{ig_metadata.reformatted_version}_#{request_type}_" \
+          "must_support_#{profile_identifier_for_profile(profile_metadata)}"
+      end
+
+      def test_file_for_profile(profile_metadata)
+        profile_id = profile_identifier_for_profile(profile_metadata)
+        File.join(profile_id, "client_#{request_type}_must_support_#{profile_id}_test")
+      end
+
+      def profile_identifier_for_profile(profile_metadata)
+        ig_metadata.snake_case_for_profile(profile_metadata)
+      end
+
+      def profile_test_ids
+        target_profiles = type == 'response' ? profiles : required_profiles
+        target_profiles.map { |profile_metadata| test_id_for_profile(profile_metadata) }
+      end
+
+      # The collapsed attestation structure / optional response tests are only applied to v2.2.1.
+      def optional_must_support_enabled?
+        ig_version == 'v2.2.1'
+      end
+
+      # The Claim (request) / ClaimResponse (response) profiles remain mandatory standalone tests.
+      def mandatory_profile?(profile_metadata)
+        %w[Claim ClaimResponse].include?(profile_metadata.resource)
+      end
+
+      # Response groups: pairs each per-profile test id with whether it should be marked optional.
+      def profile_tests
+        profiles.map do |profile_metadata|
+          {
+            id: test_id_for_profile(profile_metadata),
+            optional: optional_must_support_enabled? && !mandatory_profile?(profile_metadata)
+          }
+        end
+      end
+
+      # Collapsed request groups: the mandatory Claim profile(s) kept as standalone tests.
+      def claim_profiles
+        required_profiles.select { |profile_metadata| profile_metadata.resource == 'Claim' }
+      end
+
+      # Collapsed request groups: every other supporting profile, assessed by the attestation test.
+      def other_profiles
+        required_profiles.reject { |profile_metadata| profile_metadata.resource == 'Claim' }
+      end
+
+      def other_profiles_title
+        'All must support elements for other profiles referenced by Claim ' \
+          "#{operation == 'submit' ? 'submissions' : 'inquiries'} are observed on $#{operation} requests"
+      end
+
+      # Formats a profiles list for an attestation test's config, one hash literal per line.
+      def attestation_profiles_block(profile_metadatas)
+        profile_metadatas.map do |profile_metadata|
+          "              { resource_type: '#{profile_metadata.resource}', " \
+            "profile_key: '#{profile_identifier(profile_metadata)}', " \
+            "title: '#{profile_metadata.profile_name}' }"
+        end.join(",\n")
+      end
+
+      def profile_test_files
+        target_profiles = type == 'response' ? profiles : required_profiles
+        target_profiles.map { |profile_metadata| test_file_for_profile(profile_metadata) }
+      end
+
+      def verifies_requirements
+        case "#{operation}_#{ig_version}"
+        when 'submit_v2.0.1'
+          return nil if type == 'response'
+
+          ['hl7.fhir.us.davinci-pas_2.0.1@58', 'hl7.fhir.us.davinci-pas_2.0.1@62',
+           'hl7.fhir.us.davinci-pas_2.0.1@70', 'hl7.fhir.us.davinci-pas_2.0.1@202']
+        end
+      end
+
+      def description
+        if type == 'response'
+          <<~DESCRIPTION
+            Check that `$#{operation}` responses provided to the client contain
+            all PAS-defined profiles and their must support elements.
+
+            **USER INPUT VALIDATION**: These tests validate responses provided by the tester,
+            not the system under test. Errors will be treated as skips instead of failures.
+
+            For `$#{operation}` responses, this includes the following profiles:
+
+            #{Descriptions.profile_links_list(profiles, ig_version)}
+          DESCRIPTION
+        else
+          <<~DESCRIPTION
+            Check that the client can demonstrate `$#{operation}` requests that contain
+            all PAS-defined profiles and their must support elements.
+
+            For `$#{operation}` requests, this includes the following profiles:
+
+            #{Descriptions.profile_links_list(required_profiles, ig_version, request_profiles: operation == 'submit' ? request_profiles : nil)}
+          DESCRIPTION
+        end
+      end
+    end
+  end
+end