davinci_pas_test_kit 0.15.1 → 0.16.0

data/lib/davinci_pas_test_kit/generator/pas_must_support_metadata_extractor.rb

@@ -39,7 +39,7 @@ module DaVinciPASTestKit
       target_element
     end
 
-    # rubocop:disable Metrics/CyclomaticComplexity
+    # rubocop:disable-next Metrics/CyclomaticComplexity
     def take_discriminator_step(current_element, path)
       if path.start_with?('extension(')
         ext_url, remaining_path = path.delete_prefix("extension('").split("')", 2)
@@ -74,7 +74,6 @@ module DaVinciPASTestKit
 
       [next_element, remaining_path&.delete_prefix('.')]
     end
-    # rubocop:enable Metrics/CyclomaticComplexity
 
     def value_slices
       must_support_value_slice_elements.map do |current_element|

data/lib/davinci_pas_test_kit/generator/profile_metadata.rb

@@ -42,7 +42,7 @@ module DaVinciPASTestKit
 
       # A sorted, bulleted markdown list of this profile's must support elements (slices, elements,
       # extensions, and choices), each line prefixed with `indent` spaces. Shared by the per-profile
-      # must support tests and the collapsed attestation tests so both stay in sync with the metadata.
+      # must support tests and the collapsed tests so both stay in sync with the metadata.
       def must_support_list_string(indent: 8)
         slice_names = must_supports[:slices].map { |slice| slice[:slice_id] }
         element_names = must_supports[:elements].map { |element| "#{resource}.#{element[:path]}" }

data/lib/davinci_pas_test_kit/generator/server_must_support_group_generator.rb

@@ -110,6 +110,20 @@ module DaVinciPASTestKit
         ig_metadata.profiles.select { |profile_metadata| MustSupportTargetProfiles.request_profile?(profile_metadata) }
       end
 
+      # Additional Claim Inquiry Response checks are v2.2.x-specific, so they are only included
+      # in the v2.2+ server element support group.
+      def additional_claim_inquiry_response_requirements_supported?
+        ig_metadata.ig_version.start_with?('v2.2')
+      end
+
+      def additional_submit_request_requirements_supported?
+        ig_metadata.ig_version == 'v2.2.1'
+      end
+
+      def additional_claim_inquiry_response_requirements_group_id
+        "pas_server_#{ig_version_for_id}_claim_inquiry_responses"
+      end
+
       def verifies_requirements
         case ig_metadata.ig_version
         when 'v2.0.1'
@@ -123,9 +137,18 @@ module DaVinciPASTestKit
           ['hl7.fhir.us.davinci-pas_2.0.1@35']
         when 'inquire_request_v2.0.1'
           ['hl7.fhir.us.davinci-pas_2.0.1@36']
+        when 'submit_request_v2.2.1', 'inquire_request_v2.2.1'
+          [
+            'hl7.fhir.us.davinci-pas_2.2.1@conf-4',
+            'hl7.fhir.us.davinci-pas_2.2.1@conf-5'
+          ]
         end
       end
 
+      def replaced_pa_inquire_reference_test?
+        ig_version == 'v2.2.1'
+      end
+
       def description
         <<~DESCRIPTION
           Demonstrate the ability of the server to support all PAS-defined profiles

data/lib/davinci_pas_test_kit/generator/server_suite_generator.rb

@@ -46,15 +46,16 @@ module DaVinciPASTestKit
         "Da Vinci PAS Server Suite #{ig_metadata.ig_version}"
       end
 
-      def ig_identifier
-        version = ig_metadata.ig_version[1..] # Remove leading 'v'
-        "hl7.fhir.us.davinci-pas##{version}"
+      # The validator_configuration.rb constant listing the IGs for this version, e.g. V221_VALIDATOR_IGS.
+      # A version without one fails when the generated suite loads.
+      def validator_igs_constant
+        "V#{ig_metadata.ig_version.delete('v.')}_VALIDATOR_IGS"
       end
 
-      def validator_igs_expression
-        identifiers = [ig_identifier]
-        identifiers << 'hl7.fhir.us.core#6.1.0' if ig_metadata.ig_version.start_with?('v2.2')
-        identifiers.map(&:inspect).join(', ')
+      # v2.2+ suites use the targeted suppression list; v2.0.1 keeps the legacy list plus the
+      # targeted entries.
+      def suppressed_messages_constant
+        ig_metadata.ig_version.start_with?('v2.2') ? 'V221_SUPPRESSED_MESSAGES' : 'V201_SUPPRESSED_MESSAGES'
       end
 
       def ig_link

data/lib/davinci_pas_test_kit/generator/templates/client_must_support_group.rb.erb

@@ -24,8 +24,13 @@ module DaVinciPASTestKit
       
 <%- if optional_must_support_enabled? -%>
 <%- if operation == 'submit' -%>
+<%- if enable_lax_checks? -%>
       # At least one of the PAS request profiles must be present; unobserved must support
       # elements on the request profiles that are present may be attested as not collected.
+<%- else -%>
+      # At least one of the PAS request profiles must be present, with all of its must support
+      # elements observed.
+<%- end -%>
       test from: :pas_client_<%= ig_version_for_id %>_must_support_with_attestation_option do
         id :pas_client_<%= ig_version_for_id %>_submit_request_profiles_must_support_with_attestation_option
         title 'At least one instance of a request profile (PAS Medication Request, PAS Service Request, PAS Device Request, or PAS Nutrition Order) is observed with all of its must support elements'
@@ -37,20 +42,30 @@ module DaVinciPASTestKit
             ],
             ig_version: '<%= ig_version %>',
             type: 'request',
-            operation: '<%= operation %>'
+            operation: '<%= operation %>',
+            disable_attestation: <%= !enable_lax_checks? %>
           }
         )
         description MustSupportWithAttestationOption.build_description(config.options)
+        <%- if verifies_requirements -%>
+        verifies_requirements(*verifies_requirements, <%= verifies_requirements.map { |r| "'#{r}'" }.join(', ') %>)
+        <%- end -%>
       end
 
 <%- end -%>
 <%- claim_profiles.each do |profile_metadata| -%>
       # Mandatory - the <%= profile_metadata.profile_name %> profile must always be demonstrated.
-      test from: :<%= test_id_for_profile(profile_metadata) %>
+      test from: :<%= test_id_for_profile(profile_metadata) %> <%- if verifies_requirements -%> do
+        verifies_requirements(*verifies_requirements, <%= verifies_requirements.map { |r| "'#{r}'" }.join(', ') %>)
+      end<%- end -%>
 
 <%- end -%>
+<%- if enable_lax_checks? -%>
       # All other <%= operation %> request profiles - unobserved must support elements may be
       # attested as not collected by the client system.
+<%- else -%>
+      # All other <%= operation %> request profiles - all must support elements must be observed.
+<%- end -%>
       test from: :pas_client_<%= ig_version_for_id %>_must_support_with_attestation_option do
         id :pas_client_<%= ig_version_for_id %>_<%= operation %>_request_other_must_support_with_attestation_option
         title '<%= other_profiles_title %>'
@@ -62,10 +77,14 @@ module DaVinciPASTestKit
             ],
             ig_version: '<%= ig_version %>',
             type: 'request',
-            operation: '<%= operation %>'
+            operation: '<%= operation %>',
+            disable_attestation: <%= !enable_lax_checks? %>
           }
         )
         description MustSupportWithAttestationOption.build_description(config.options)
+        <%- if verifies_requirements -%>
+        verifies_requirements(*verifies_requirements, <%= verifies_requirements.map { |r| "'#{r}'" }.join(', ') %>)
+        <%- end -%>
       end
 <%- else -%>
       <%- if operation == 'submit' -%>

data/lib/davinci_pas_test_kit/generator/templates/client_must_support_response_group.rb.erb

@@ -1,7 +1,6 @@
 <%- profile_test_files.each do |file_name| -%>
 require_relative '<%= file_name %>'
 <%- end -%>
-require_relative '../../<%= ig_version %>/workflows/pas_client_response_attest'
 
 module DaVinciPASTestKit
   module <%= module_name %>
@@ -17,27 +16,19 @@ module DaVinciPASTestKit
       <%- if profile_test[:optional] -%>
       test from: :<%= profile_test[:id] %> do
         optional
+        simulation_verification
+      end
+      <%- elsif profile_test[:verifies_response_requirement] -%>
+      test from: :<%= profile_test[:id] %> do
+        verifies_requirements(*verifies_requirements, '<%= response_verifies_requirement %>')
+        simulation_verification
       end
       <%- else -%>
       test from: :<%= profile_test[:id] %> do
-        verifies_requirements 'hl7.fhir.us.davinci-pas_2.2.1@conf-7'
+        simulation_verification
       end
       <%- end -%>
       <%- end -%>
-      test from: :pas_client_<%= ig_version_for_id %>_response_attest,
-           title: 'PAS client handled the $<%= operation %> response must support elements',
-           description: %(
-             This test provides the tester an opportunity to verify that their client
-             correctly processed and used the must support elements present in the
-             $<%= operation %> responses received from Inferno during these tests.
-           ),
-           config: { options: {
-             workflow_tag: MUST_SUPPORT_WORKFLOW_TAG,
-             attest_message: "I attest that the client system correctly processed the must support elements " \
-                             "contained in the $<%= operation %> responses received from Inferno and did not error."
-           } } do
-        verifies_requirements 'hl7.fhir.us.davinci-pas_2.2.1@conf-8'
-      end
     end
   end
 end

data/lib/davinci_pas_test_kit/generator/templates/must_support.rb.erb

@@ -7,28 +7,28 @@ module DaVinciPASTestKit
       title 'All must support elements for profile <%= profile_name %> are observed on $<%= operation %> <%= request_type.include?('request') ? 'requests' : 'responses' %>'
       description %(
         <% if system == 'client' && request_type.include?('request') %>
-        PAS client systems are required to be able to populate all
-        must support elements on instances of all profiles included in <% request_type.include?('submit') ? 'Submit' : 'Inquiry' %>
+        PAS clients are required to be able to populate all
+        must support elements on instances of all profiles included in <%= request_type.include?('submit') ? '`$submit`' : '`$inquire`' %>
         requests, including instances of the <%= profile_name %> Profile.
         This test checks all identified instances of the <%= profile_name %>
-        Profile on requests sent by the client to ensure that the following
+        Profile on requests sent by the PAS client to ensure that the following
         must support elements are observed: <% end %><% if system == 'client' && request_type.include?('response') %>
-        PAS client systems are required to be able to receive all
-        must support elements on instances of all profiles included in <% request_type.include?('submit') ? 'Submit' : 'Inquiry' %>
+        PAS clients are required to be able to receive all
+        must support elements on instances of all profiles included in <%= request_type.include?('submit') ? '`$submit`' : '`$inquire`' %>
         responses, including instances of the <%= profile_name %> Profile.
         This test checks all identified instances of the <%= profile_name %>
-        Profile on responses sent to the client to ensure that the following
+        Profile on responses sent to the PAS client to ensure that the following
         must support elements are observed:<% end %><% if system == 'server' && request_type.include?('request') %>
         **USER INPUT VALIDATION**: This test validates input provided by the user instead of the system under test. Errors encountered will be treated as a skip instead of a failure.
 
         PAS server systems are required to be able to receive all
-        must support elements on instances of all profiles included in <% request_type.include?('submit') ? 'Submit' : 'Inquiry' %>
+        must support elements on instances of all profiles included in <%= request_type.include?('submit') ? '`$submit`' : '`$inquire`' %>
         requests, including instances of the <%= profile_name %> Profile.
         This test checks all identified instances of the <%= profile_name %>
         Profile on requests sent to the server to ensure that the following
         must support elements are observed:<% end %><% if system == 'server' && request_type.include?('response') %>
         PAS server systems are required to be able to populate all
-        must support elements on instances of all profiles included in <% request_type.include?('submit') ? 'Submit' : 'Inquiry' %>
+        must support elements on instances of all profiles included in <%= request_type.include?('submit') ? '`$submit`' : '`$inquire`' %>
         responses, including instances of the <%= profile_name %> Profile.
         This test checks all identified instances of the <%= profile_name %>
         Profile on responses returned by the server to ensure that the following
@@ -38,8 +38,9 @@ module DaVinciPASTestKit
       )
       <%- if verifies_requirements -%>
       verifies_requirements <%= verifies_requirements.map { |r| "'#{r}'" }.join(', ') %>
-      <%- end -%>
-
+      <%- end -%><%- if tests_conf_6?  %>
+      verifies_requirements 'hl7.fhir.us.davinci-pas_2.2.1@conf-6'
+      <%- end %>
       config(
         options: {
           resource_type: '<%= resource_type %>',

data/lib/davinci_pas_test_kit/generator/templates/server_must_support_group.rb.erb

@@ -3,6 +3,16 @@ require_relative '../../claim_submit_operation_test'
 require_relative '../../server_response_bundle_validation_test'
 require_relative '../../claim_inquire_operation_test'
 require_relative '../../<%= ig_version %>/must_support/pas_server_must_support_request_profiles_test'
+<%- if additional_submit_request_requirements_supported? -%>
+require_relative '../../<%= ig_version %>/pas_server_no_custom_extensions_test'
+<%- end -%>
+<%- if additional_claim_inquiry_response_requirements_supported? -%>
+require_relative '../../<%= ig_version %>/pas_server_claim_inquiry_responses_group'
+<%- end -%>
+<% if replaced_pa_inquire_reference_test? -%>
+require_relative '../../<%= ig_version %>/server_replaced_pa_inquire_reference_input_test'
+require_relative '../../<%= ig_version %>/server_replaced_pa_inquire_reference_test'
+<% end -%>
 <%- profile_test_files('submit', 'request').each do |file_name| -%>
 require_relative '<%= file_name %>'
 <%- end -%>
@@ -92,6 +102,14 @@ module DaVinciPASTestKit
               }
             )
           end
+          <%- if operation == 'submit' && additional_submit_request_requirements_supported? -%>
+
+          test from: :pas_server_<%= ig_version_for_id %>_no_custom_extensions_test
+          <%- end -%>
+          <%- if operation == 'inquire' && replaced_pa_inquire_reference_test? -%>
+          test from: :pas_server_<%= ig_version_for_id %>_replaced_pa_inquire_reference_input_test
+          test from: :pas_server_<%= ig_version_for_id %>_replaced_pa_inquire_reference_test
+          <%- end -%>
         end
 
         group do
@@ -115,6 +133,10 @@ module DaVinciPASTestKit
           test from: :<%= id %>
           <%- end -%>
         end
+        <%- if operation == 'inquire' && additional_claim_inquiry_response_requirements_supported? -%>
+
+        group from: :<%= additional_claim_inquiry_response_requirements_group_id %>
+        <%- end -%>
       end<%end%>
     end
   end

data/lib/davinci_pas_test_kit/generator/templates/server_suite.rb.erb

@@ -1,3 +1,4 @@
+require_relative '../../../cross_suite/validator_configuration'
 require_relative '../../../cross_suite/validator_suppressions'
 require_relative '<%= error_group_file_name %>'
 require_relative '../../<%= ig_metadata.ig_version %>/pas_server_subscription_setup'
@@ -22,8 +23,7 @@ module DaVinciPASTestKit
 
         The best place to get started is the [Server Testing
         Instructions](https://github.com/inferno-framework/davinci-pas-test-kit/wiki/Server-Instructions-<%= ig_metadata.ig_version %>),
-        which provides a step-by-step guide for running the tests against a client and provides
-        an example client implemented in Postman.  Visit the [Server Testing
+        which provides a step-by-step guide for running the tests. Visit the [Server Testing
         Details](https://github.com/inferno-framework/davinci-pas-test-kit/wiki/Server-Details)
         documentation for information about technical implementation and known limitations of these tests.
 
@@ -34,6 +34,7 @@ module DaVinciPASTestKit
             - Approval of a prior authorization request
             - Denial of a prior authorization request
             - Pending of a prior authorization request and a subsequent final decision
+            - Claim updates (except in v2.0.1)
             - Inability to process a prior authorization request
         - The ability of the server to handle the full scope of data required by PAS, including
             - Ability to process prior auth requests and inquiries with all PAS profiles and all must support elements on those profiles
@@ -48,7 +49,7 @@ module DaVinciPASTestKit
         required features and functionality are present. HL7® FHIR® resources are 
         validated with the Java validator using `tx.fhir.org` as the terminology server.
       
-      %)
+      )
 
       links [
         {
@@ -83,17 +84,14 @@ module DaVinciPASTestKit
       )
 
       fhir_resource_validator do
-        igs <%= validator_igs_expression %>
+        igs(*<%= validator_igs_constant %>)
         
         exclude_message do |message|
-          # Messages expected of the form `<ResourceType>: <FHIRPath>: <message>`
-          # We strip `<ResourceType>: <FHIRPath>: ` for the sake of matching
-          SUPPRESSED_MESSAGES.match?(message.message.sub(/\A\S+: \S+: /, '')) ||
-            message.message.downcase.include?('x12')
+          <%= suppressed_messages_constant %>.match?(message.message.sub(VALIDATOR_MESSAGE_LOCATION_PREFIX, ''))
         end
 
         validation_context do
-          snomedCT '731000124108'
+          snomedCT SNOMED_CT_US_EDITION
         end
       end
 
@@ -126,9 +124,9 @@ module DaVinciPASTestKit
 
       group from: :pas_server_<%= ig_metadata.reformatted_version %>_subscription_setup
 
-      group 'Demonstrate Workflow Support' do
+      group 'Demonstrate Scenario Support' do
         description %(
-          The workflow tests validate that the server can participate in complete
+          The scenario tests validate that the server can participate in complete
           end-to-end prior authorization interactions, returning responses that are
           conformant and also contain the correct codes.
         )

data/lib/davinci_pas_test_kit/generator/templates/use_case_group.rb.erb

@@ -72,6 +72,7 @@ module DaVinciPASTestKit
           description %(
             <%= bundle_validation_test_description('submit', 'response').gsub("\n", "\n" + " "*12) %>
           )
+
           config(
             options: {
               use_case: '<%= use_case %>',
@@ -114,6 +115,8 @@ module DaVinciPASTestKit
         end
         test from: :pas_notification_pas_conformance_test do
           id :pas_server_<%= ig_version_for_id %>_notification_pas_conformance_<%= use_case %>
+          verifies_requirements 'hl7.fhir.us.davinci-pas_2.2.1@spec-61',
+                                'hl7.fhir.us.davinci-pas_2.2.1@spec-62'
         end
 <% else -%>
         test from: :subscriptions_r4_server_id_only_conformance do

data/lib/davinci_pas_test_kit/generator/use_case_group_generator.rb

@@ -1,4 +1,5 @@
 require_relative '../cross_suite/pas_constants'
+require_relative 'descriptions'
 
 module DaVinciPASTestKit
   class Generator
@@ -46,7 +47,7 @@ module DaVinciPASTestKit
       end
 
       def title
-        "Successful #{use_case.capitalize} Workflow"
+        "Successful #{use_case.capitalize} Scenario"
       end
 
       def output_file_name
@@ -100,6 +101,8 @@ module DaVinciPASTestKit
         case ig_version
         when 'v2.0.1'
           ['hl7.fhir.us.davinci-pas_2.0.1@141']
+        when 'v2.2.1'
+          ['hl7.fhir.us.davinci-pas_2.2.1@spec-51', 'hl7.fhir.us.davinci-pas_2.2.1@spec-60']
         end
       end
 
@@ -111,14 +114,18 @@ module DaVinciPASTestKit
       end
 
       def bundle_response_conformance_requirements_verified(operation)
-        case "#{operation}_#{ig_version}"
-        when 'submit_v2.0.1'
-          ['hl7.fhir.us.davinci-pas_2.0.1@64', 'hl7.fhir.us.davinci-pas_2.0.1@100',
-           'hl7.fhir.us.davinci-pas_2.0.1@101', 'hl7.fhir.us.davinci-pas_2.0.1@102',
-           'hl7.fhir.us.davinci-pas_2.0.1@103', 'hl7.fhir.us.davinci-pas_2.0.1@107']
-        when 'inquire_v2.0.1'
-          ['hl7.fhir.us.davinci-pas_2.0.1@131']
-        end
+        {
+          ['submit', 'v2.0.1'] => [
+            'hl7.fhir.us.davinci-pas_2.0.1@64', 'hl7.fhir.us.davinci-pas_2.0.1@100',
+            'hl7.fhir.us.davinci-pas_2.0.1@101', 'hl7.fhir.us.davinci-pas_2.0.1@102',
+            'hl7.fhir.us.davinci-pas_2.0.1@103', 'hl7.fhir.us.davinci-pas_2.0.1@107'
+          ],
+          ['submit', 'v2.2.1'] => [
+            'hl7.fhir.us.davinci-pas_2.2.1@spec-30', 'hl7.fhir.us.davinci-pas_2.2.1@spec-31',
+            'hl7.fhir.us.davinci-pas_2.2.1@spec-33'
+          ],
+          ['inquire', 'v2.0.1'] => ['hl7.fhir.us.davinci-pas_2.0.1@131']
+        }[[operation, ig_version]]
       end
 
       def description
@@ -138,7 +145,7 @@ module DaVinciPASTestKit
           when 'pended'
             if ig_version == 'v2.2.1'
               <<~DESCRIPTION
-                Demonstrate a complete prior authorization workflow including a period
+                Demonstrate a complete prior authorization scenario including a period
                 during which the final decision is pending. This includes demonstrating
                 the ability of the server to
 
@@ -148,7 +155,7 @@ module DaVinciPASTestKit
               DESCRIPTION
             else
               <<~DESCRIPTION
-                Demonstrate a complete prior authorization workflow including a period
+                Demonstrate a complete prior authorization scenario including a period
                 during which the final decision is pending. This includes demonstrating
                 the ability of the server to
 
@@ -175,8 +182,7 @@ module DaVinciPASTestKit
       end
 
       def profile_link(operation, type)
-        "[#{PASConstants.bundle_profile_name_for_operation_and_type(operation, type)}]" \
-          "(#{PASConstants.bundle_profile_url_for_operation_and_type(operation, type)}|#{ig_version})"
+        Descriptions.bundle_profile_link(operation, type, ig_version)
       end
 
       def bundle_validation_test_description(operation, type)

data/lib/davinci_pas_test_kit/parameters_helper.rb

@@ -2,15 +2,23 @@ module DaVinciPASTestKit
   # Helper module for working with FHIR Parameters resources in v2.2.1
   # Provides utilities to extract Bundles from Parameters.parameter entries
   module ParametersHelper
-    # Extracts Bundles from a PAS Inquiry Response Parameters resource
+    # Extracts the resources from a Parameters resource's entries matching a given parameter name.
     # @param parameters [FHIR::Parameters] The Parameters resource
-    # @return [Array<FHIR::Bundle>] Array of Bundles from return parameters
-    def extract_bundles_from_pas_inquiry_response_parameters(parameters)
+    # @param parameter_name [String] The Parameters.parameter.name to match, e.g. 'return' or 'resource'
+    # @return [Array] Resources (one per matching entry, in order; nil for an entry with no resource)
+    def extract_resources_from_parameters(parameters, parameter_name)
       return [] unless parameters.is_a?(FHIR::Parameters)
 
-      parameters.parameter # rubocop:disable Style/SelectByKind
-        .select { |param| param.name == 'return' }
+      parameters.parameter
+        .select { |param| param.name == parameter_name }
         .map(&:resource)
+    end
+
+    # Extracts Bundles from a PAS Inquiry Response Parameters resource
+    # @param parameters [FHIR::Parameters] The Parameters resource
+    # @return [Array<FHIR::Bundle>] Array of Bundles from return parameters
+    def extract_bundles_from_pas_inquiry_response_parameters(parameters)
+      extract_resources_from_parameters(parameters, 'return') # rubocop:disable Style/SelectByKind
         .compact
         .select { |resource| resource.is_a?(FHIR::Bundle) }
     end

data/lib/davinci_pas_test_kit/pas_notification_conformance_test.rb

@@ -8,8 +8,8 @@ module DaVinciPASTestKit
     id :pas_notification_pas_conformance_test
     title 'Notification conforms to PAS-specific requirements'
     description %(
-      This test verifies that the notification sent to the client under test
-      for a pended claim update (or sent by the server under test) conforms
+      This test verifies that the notification sent to the client system
+      for a pended claim update conforms
       to PAS-specific requirements beyond the base Subscription Backport IG
       notification requirements. In particular, the focus resource in the
       notification should be the updated ClaimResponse conformant to the

data/lib/davinci_pas_test_kit/requirements/davinci_pas_test_kit_requirements.csv

@@ -250,12 +250,15 @@ hl7.fhir.us.davinci-pas_2.2.1,conf-12,https://hl7.org/fhir/us/davinci-pas/2.2.1/
 hl7.fhir.us.davinci-pas_2.2.1,conf-13,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/conformance.html#ci-c-conf-13,"If the proposed change is adopted and published in the PAS continuous integration build or the CI build of one of its dependencies (e.g. US Core), implementations **MAY**, by mutual agreement, pre-adopt the use of those additional profiles and/or mustSupport data elements and not be considered in violation of #1 above.",MAY,"PAS Client, PAS Payer",,false,,
 hl7.fhir.us.davinci-pas_2.2.1,conf-14,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/conformance.html#ci-c-conf-14,"Where cardinality and other constraints present in profiles allow data elements to be omitted, PAS compliant systems **SHALL NOT** treat the omission of those elements as a conformance error.",SHALL NOT,"PAS Client, PAS Payer",,false,,
 hl7.fhir.us.davinci-pas_2.2.1,conf-15,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/conformance.html#ci-c-conf-15,PAS clients and services **SHALL** use standard PAS data elements (i.e. elements found within PAS-defined or inherited profiles and marked as mandatory or mustSupport) to communicate needed data if such elements are intended to convey such information.,SHALL,"PAS Client, PAS Payer",,false,,
-hl7.fhir.us.davinci-pas_2.2.1,conf-16,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/conformance.html#ci-c-conf-16,"PAS implementing organizations **SHALL NOT** publish guidance setting expectations for where certain data elements are conveyed within PAS and inherited data structures, but **MAY** submit change requests to PAS, HRex, or US Core requesting that additional guidance be provided to implementers on data structure usage to increase consistency across implementations.",SHALL NOT / MAY,"PAS Client, PAS Payer",,false,,
-hl7.fhir.us.davinci-pas_2.2.1,metric-1,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/metrics.html#ci-c-metric-1,"Each of these IGs recommends a set of metrics that **SHOULD** or **MAY** be collected by their respective implementations to facilitate the evaluation of adoption, functionality, processes, and improved outcomes.",SHOULD / MAY,"PAS Client, PAS Payer",,false,,
+hl7.fhir.us.davinci-pas_2.2.1,conf-16-A,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/conformance.html#ci-c-conf-16,PAS implementing organizations **SHALL NOT** publish guidance setting expectations for where certain data elements are conveyed within PAS and inherited data structures,SHALL NOT,"PAS Client, PAS Payer",,false,,
+hl7.fhir.us.davinci-pas_2.2.1,conf-16-B,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/conformance.html#ci-c-conf-16,"PAS implementing organizations ... **MAY** submit change requests to PAS, HRex, or US Core requesting that additional guidance be provided to implementers on data structure usage to increase consistency across implementations.",MAY,"PAS Client, PAS Payer",,false,,
+hl7.fhir.us.davinci-pas_2.2.1,metric-1,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/metrics.html#ci-c-metric-1,"Each of these IGs recommends a set of metrics that **SHOULD** or **MAY** be collected by their respective implementations to facilitate the evaluation of adoption, functionality, processes, and improved outcomes.",SHOULD,"PAS Client, PAS Payer",,false,,
 hl7.fhir.us.davinci-pas_2.2.1,metric-2,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/metrics.html#ci-c-metric-2,PAS implementers **SHOULD** store information for each PAS call in a manner that would allow them to respond to measures based on this logical model.,SHOULD,"PAS Client, PAS Payer",,false,,
-hl7.fhir.us.davinci-pas_2.2.1,priv-1,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/privacy.html#ci-c-priv-1,"Implementations **SHALL** permit provider review of data prior to transmission, but **SHALL NOT** require such review.",SHALL NOT / SHALL,PAS Client,,false,,
+hl7.fhir.us.davinci-pas_2.2.1,priv-1-A,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/privacy.html#ci-c-priv-1,Implementations **SHALL** permit provider review of data prior to transmission,SHALL,PAS Client,,false,,
+hl7.fhir.us.davinci-pas_2.2.1,priv-1-B,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/privacy.html#ci-c-priv-1,Implementations ... **SHALL NOT** require [provider review of data prior to transmission],SHALL NOT,PAS Client,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,priv-2,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/privacy.html#ci-c-priv-2,Payers who do not view the FHIR version of the transmitted information **SHOULD** be aware of the possibility of these limitations and ensure they have policies that enforce appropriate sharing constraints on data.,SHOULD,PAS Payer,,false,,
-hl7.fhir.us.davinci-pas_2.2.1,priv-3,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/privacy.html#ci-c-priv-3,PAS Servers **SHOULD** support server-server OAuth and **MAY** support mutually authenticated TLS.,SHOULD / MAY,PAS Payer,,false,,
+hl7.fhir.us.davinci-pas_2.2.1,priv-3-A,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/privacy.html#ci-c-priv-3,PAS Servers **SHOULD** support server-server Oauth,SHOULD,PAS Payer,,false,,
+hl7.fhir.us.davinci-pas_2.2.1,priv-3-B,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/privacy.html#ci-c-priv-3,PAS Servers ... **MAY** support mutually authenticated TLS.,MAY,PAS Payer,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,prof-1,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/StructureDefinition-profile-datatype-timing.html#ci-c-prof-1,"Timings **SHALL** have at least one of: a count, a frequency and period and periodUnit (with optional frequencyMax and periodMax), a calendarPattern, or a deliveryPattern.",SHALL,PAS Client,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,prof-2,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/StructureDefinition-profile-quantity.html#ci-c-prof-2,Quantities **SHALL** have a value and either a unit or a code,SHALL,"PAS Client, PAS Payer",,false,,
 hl7.fhir.us.davinci-pas_2.2.1,prof-3,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/StructureDefinition-profile-quantity.html#ci-c-prof-3,"If a quantity code is present, it **SHALL** use the X12 quantity units.",SHALL,"PAS Client, PAS Payer",,false,,
@@ -293,8 +296,10 @@ hl7.fhir.us.davinci-pas_2.2.1,spec-20,https://hl7.org/fhir/us/davinci-pas/2.2.1/
 hl7.fhir.us.davinci-pas_2.2.1,spec-21,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-21,"To attach non-FHIR instance data such as PDFs, CDAs, JPGs, a DocumentReference instance **SHOULD** be used.",SHOULD,PAS Payer,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,spec-22,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-22,The Claim.supportingInfo.sequence for each entry **SHALL** be unique within the Claim.,SHALL,PAS Payer,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,spec-23,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-23,All resources **SHALL** comply with their respective profiles.,SHALL,PAS Payer,,false,,
-hl7.fhir.us.davinci-pas_2.2.1,spec-24,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-24,"FHIR elements not marked as 'must support' **MAY** be included in resources within the Bundle, but client systems **SHOULD** have no expectation of such elements being processed by the payer unless prior arrangements have been made.",SHOULD / MAY,"PAS Client, PAS Payer",,false,,
-hl7.fhir.us.davinci-pas_2.2.1,spec-25,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-25,"Systems that do not process such elements **SHALL** ignore unsupported elements unless they are 'modifier' elements, in which case the system **MAY** treat the presence of the element as an error.",SHALL / MAY,PAS Payer,,false,,
+hl7.fhir.us.davinci-pas_2.2.1,spec-24-A,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-24,FHIR elements not marked as 'must support' **MAY** be included in resources within the Bundle,MAY,"PAS Client, PAS Payer",,false,,
+hl7.fhir.us.davinci-pas_2.2.1,spec-24-B,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-24,[C]lient systems **SHOULD** have no expectation of such [non 'must support'] elements being processed by the payer unless prior arrangements have been made.,SHOULD,"PAS Client, PAS Payer",,false,,
+hl7.fhir.us.davinci-pas_2.2.1,spec-25-A,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-25,Systems that do not process such elements **SHALL** ignore unsupported elements unless they are 'modifier' elements,SHALL,PAS Payer,,false,,
+hl7.fhir.us.davinci-pas_2.2.1,spec-25-B,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-25,[T]the system **MAY** treat the presence of the [unsupported 'modifier'] element as an error.,MAY,PAS Payer,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,spec-26,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-26,"In addition, the system **SHALL** make the entire PAS FHIR Bundle available to the intended payer.",SHALL,PAS Payer,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,spec-27,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-27,The method **MAY** be based on the X12 275 or another method that trading partners have agreed to use.,MAY,PAS Payer,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,spec-28,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-28,"If the X12 275 is used for this purpose, the 275 BDS01 Filter ID Code element **SHALL** be set to ""B64"" and the CAT02 Attachment Information Format Code element **SHALL** be sent to ""HL"".",SHALL,PAS Payer,,false,,
@@ -316,7 +321,7 @@ hl7.fhir.us.davinci-pas_2.2.1,spec-43,https://hl7.org/fhir/us/davinci-pas/2.2.1/
 hl7.fhir.us.davinci-pas_2.2.1,spec-44,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-44,This Claim Inquiry Response **SHALL** either reference a Claim or have a Data Absent Reason indicating why the Claim can not be referenced (eg. original claim received by fax).,SHALL,PAS Payer,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,spec-45,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-45,The referenced Claim instance **SHOULD** be returned if there is information in the Response that needs to be present can not be returned in the Claim Response instance.,SHOULD,PAS Payer,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,spec-46,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-46,"the returned ClaimResponse **SHALL** include the current results for all submitted items, including any items changed or canceled since the original authoriation request.",SHALL,PAS Payer,,false,,
-hl7.fhir.us.davinci-pas_2.2.1,spec-47,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-47,"if a specific reference number (either the REF-NT or REF-BB) is submitted and is not the 'current' number (because subsequent additions/changes/cancellations have been made to the prior authorization request), the returned record **SHALL** be the current authorization response - even though it no longer has the same identifier.",SHALL,"PAS Client, PAS Payer",,false,,
+hl7.fhir.us.davinci-pas_2.2.1,spec-47,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-47,"if a specific reference number (either the REF-NT or REF-BB) is submitted and is not the 'current' number (because subsequent additions/changes/cancellations have been made to the prior authorization request), the returned record **SHALL** be the current authorization response - even though it no longer has the same identifier.",SHALL,PAS Payer,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,spec-48,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-48,"I.e. If a search is for a 'replaced' prior authorization, the search result **SHALL** include the 'current' prior authorization response for the most recent replacing prior authorization request.",SHALL,PAS Payer,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,spec-49,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-49,systems **MAY** withhold information about prior authorizations that are 'open' but are deemed to be not relevant to the provider (eg. prior authorization requests for sensitive care where the requesting provider is neither the ordering nor rendering provider) who is checking for the prior authorization status if not searching by a specific Claim identifier.,MAY,PAS Payer,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,spec-50,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/specification.html#ci-c-spec-50,In such situations the response **SHOULD** include an OperationOutcome warning that some prior authorizations have been suppressed and provide an alternative mechanism (e.g. telephone number) to provide further information if needed.,SHOULD,PAS Payer,,false,,
@@ -349,3 +354,5 @@ hl7.fhir.us.davinci-pas_2.2.1,use-3,https://hl7.org/fhir/us/davinci-pas/2.2.1/en
 hl7.fhir.us.davinci-pas_2.2.1,use-4,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/usecases.html#ci-c-use-4,"As well, EHRs **SHOULD** annotate their orders with the decisions contained in the PAS Response.",SHOULD,PAS Client,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,use-5,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/usecases.html#ci-c-use-5,"Prior to sending clinical data as part of the PAS exchange, the provider (or their designated agent) **SHALL** have the ability, but not an obligation, to review patient information and where appropriate amend or withhold the submission to comply with current regulations and relevant provider policies. The provider can choose to turn off the ability to review documentation. The vendor must allow them this option.",SHALL,PAS Client,,false,,
 hl7.fhir.us.davinci-pas_2.2.1,use-6,https://hl7.org/fhir/us/davinci-pas/2.2.1/en/usecases.html#ci-c-use-6,"All exchanges **SHOULD** meet Federal and state regulations, including any HIPAA restrictions and restrictions on sensitive data.",SHOULD,"PAS Client, PAS Payer",,false,,
+hl7.fhir.us.davinci-pas_2.2.1,hrex-conf-1,https://hl7.org/fhir/us/davinci-hrex/1.2.0/en/conformance.html#ci-c-conf-1,Data Sources **SHALL** be capable of populating the data element when sharing resources compliant with the profile.,SHALL,"PAS Client, PAS Payer",,false,,
+hl7.fhir.us.davinci-pas_2.2.1,hrex-conf-2,https://hl7.org/fhir/us/davinci-hrex/1.2.0/en/conformance.html#ci-c-conf-2,Data Consumers **SHALL** be capable of processing resource instances containing the data elements without generating an error or causing the application to fail.,SHALL,"PAS Client, PAS Payer",,false,,