cocina-models 0.122.0 → 0.123.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a7ba361f4c17d3165dce9e5042739493896f798fe9a215ce20054b6f2c739c11
-  data.tar.gz: 5ca9b3f5efdd6ab255dfe1f48b19be012638986f7126af70547d701bd5059b01
+  metadata.gz: 00e220a27c041178441f3a9372469f6f4aeacd6b9cf73bec45b36d0dfc8e8f1a
+  data.tar.gz: e6b6e939d33c2bbc9e88c99bdfef996b23d40df59667cf9f7c1b63b3b2a2b6ba
 SHA512:
-  metadata.gz: cfd5524aa8e1ce0dc3510855b1c1cb9cadd875878192c71ecfb9fdd02fe74457e00a9a3766eefd3f399b2b3a539a013eb63e929b7b1a46b58fedb789ef170d6c
-  data.tar.gz: 27d345e4bd13c181165a943a696ecbfe44c36fce1fcd1db4324f13c8d97fce029b953a36030fc9a71586d95a6458622300937990069b57fcae0baeed20398be3
+  metadata.gz: 8fa102a60d4d216b439f514051d34afd07e57105afefd751d1c1b8f07411b876c5475237a0a577fb1240ac6eb564918ebf9a372d3596107f2787d041de8c9f77
+  data.tar.gz: 7eb1f0771c848747c833437e3aeb4fb616de5716bae81a8f1ba83a048ba8364953eb47332bae622b91b830807eb39395d0a186a8347605bed662ebc4ecec4807

data/.circleci/config.yml

@@ -1,6 +1,6 @@
 version: 2.1
 orbs:
-  ruby-rails: sul-dlss/ruby-rails@4.10.0
+  ruby-rails: sul-dlss/ruby-rails@4.11.0
 workflows:
   build:
     jobs:

data/Gemfile.lock

@@ -1,8 +1,9 @@
 PATH
   remote: .
   specs:
-    cocina-models (0.122.0)
+    cocina-models (0.123.0)
       activesupport
+      cocina_display
       deprecation
       dry-struct (~> 1.0)
       dry-types (~> 1.1)
@@ -36,6 +37,14 @@ GEM
     base64 (0.3.0)
     bigdecimal (4.1.2)
     builder (3.3.0)
+    cocina_display (2.6.0)
+      activesupport (>= 7)
+      edtf (~> 3.2)
+      geo_coord (~> 0.2)
+      i18n
+      iso8601 (~> 0.13.0)
+      janeway-jsonpath (>= 0.6, < 2)
+      zeitwerk (~> 2.7)
     concurrent-ruby (1.3.6)
     connection_pool (3.0.2)
     csv (3.3.5)
@@ -81,6 +90,7 @@ GEM
       logger
     faraday-net_http (3.4.4)
       net-http (~> 0.5)
+    geo_coord (0.2.0)
     i18n (1.14.8)
       concurrent-ruby (~> 1.0)
     ice_nine (0.11.2)
@@ -90,7 +100,9 @@ GEM
       prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
-    json (2.19.8)
+    iso8601 (0.13.0)
+    janeway-jsonpath (1.0.0)
+    json (2.19.9)
     jsonschema_rs (0.46.5-arm64-darwin)
       bigdecimal (>= 3.1, < 5)
     jsonschema_rs (0.46.5-x86_64-linux)
@@ -219,8 +231,9 @@ CHECKSUMS
   base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
   bigdecimal (4.1.2) sha256=53d217666027eab4280346fba98e7d5b66baaae1b9c3c1c0ffe89d48188a3fbd
   builder (3.3.0) sha256=497918d2f9dca528fdca4b88d84e4ef4387256d984b8154e9d5d3fe5a9c8835f
-  bundler (4.0.13) sha256=19f08be7f27022cf0b89f27da0b044ae075e8270a9ef44ad248a932614e1ca3b
-  cocina-models (0.122.0)
+  bundler (4.0.14) sha256=d09a0a965cf772266a7e49e83610be7c2f4e49e61134c42a56804bb383cc24b8
+  cocina-models (0.123.0)
+  cocina_display (2.6.0) sha256=a30e4bd638023371985ab641164e4dbbb12fe9a669a168c1b8e2eac2e37739f4
   concurrent-ruby (1.3.6) sha256=6b56837e1e7e5292f9864f34b69c5a2cbc75c0cf5338f1ce9903d10fa762d5ab
   connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
   csv (3.3.5) sha256=6e5134ac3383ef728b7f02725d9872934f523cb40b961479f69cf3afa6c8e73f
@@ -240,11 +253,14 @@ CHECKSUMS
   erb (6.0.4) sha256=38e3803694be357fe2bfe312487c74beaf9fb4e5beb3e22498952fe1645b95d9
   faraday (2.14.2) sha256=73ccb9994a9e8648f010e32eca2ae82e41c57860aa10932cda29418b9e0223ad
   faraday-net_http (3.4.4) sha256=0e78af151747ed1b00f33e25973b4bc220d7f16c00c39676817c8b12331eb588
+  geo_coord (0.2.0) sha256=ae4e2dc5799deafa4db9138f3d7e85cf5e7dbd00b3b8395f1e1dbd34e007d7e8
   i18n (1.14.8) sha256=285778639134865c5e0f6269e0b818256017e8cde89993fdfcbfb64d088824a5
   ice_nine (0.11.2) sha256=5d506a7d2723d5592dc121b9928e4931742730131f22a1a37649df1c1e2e63db
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
   irb (1.18.0) sha256=de9454a0703a54704b9811a5ef31a60c86949fbf4013fcf244fabc7c775248e3
-  json (2.19.8) sha256=6354310fd76ef69b87d5bd1f38b40d730613baf90b6803d2d0a48f618d32dfaa
+  iso8601 (0.13.0) sha256=298c2b15b7be5fa95a1372813d36a2257656cd8e906dfbc1f5cb409851425aa2
+  janeway-jsonpath (1.0.0) sha256=c8293f009f2aea9487ddee3067ca735a1f758eb1c8834ff4fab3ffd06c56d0a3
+  json (2.19.9) sha256=9b9025b7cdddafa38d316eca0b2358488e42d417045c1b90d216a9fefe46b79a
   jsonschema_rs (0.46.5-arm64-darwin) sha256=e80414ed67f0956d3e06474a2fa076fc4a7b722f00e5d7142b70289c016ac6f1
   jsonschema_rs (0.46.5-x86_64-linux) sha256=345c65ec7a5abf8879b9c9356752f0fdf4c9926f6480458fc32803a871b5cbb3
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
@@ -295,4 +311,4 @@ CHECKSUMS
   zeitwerk (2.8.2) sha256=7212a61311083c604184b1ea2574b9aa05cd14f855a0841c06985cabe9181d12
 
 BUNDLED WITH
-  4.0.13
+  4.0.14

data/README.md

@@ -62,7 +62,7 @@ Beyond what is necessary to test the generator, the Cocina model classes are not
 
 ## Testing validation changes
 
-If there is a possibility that a model, mapping, or validation change will conflict with some existing objects then `bin/validate-data` should be used for testing.  This operates on a sample of objects from the repository and reports any validation errors. You may get the sample by running the script [bin/export-cocina-head-versions](https://github.com/sul-dlss/dor-services-app?tab=readme-ov-file#export-data) and downloading the data file to your computer. Running a full validation takes about 2 hours.
+If there is a possibility that a model, mapping, or validation change will conflict with some existing objects then `bin/validate-data` should be used for testing.  This operates on an export of objects from the repository and reports any validation errors. You may get the file by running the script [bin/export-cocina-head-versions](https://github.com/sul-dlss/dor-services-app#export-cocina-json-data) and downloading the data file to your computer. See the [DSA README](https://github.com/sul-dlss/dor-services-app#scheduled-cocina-json-data-exports) for more info about the files and locations. Running a full validation takes about 2 hours. 
 
 
 Alternatively, you can use [validate-cocina](https://github.com/sul-dlss/dor-services-app/blob/main/bin/validate-cocina) for testing. This must be run on the `sdr-infra` VM since it requires deploying a branch of cocina-models.  It is slower than using `bin/validate-data`, but all of the data is completely up to date.

data/cocina-models.gemspec

@@ -25,6 +25,7 @@ Gem::Specification.new do |spec|
   spec.required_ruby_version = '>= 3.4'
 
   spec.add_dependency 'activesupport'
+  spec.add_dependency 'cocina_display'
   spec.add_dependency 'deprecation'
   spec.add_dependency 'dry-struct', '~> 1.0'
   spec.add_dependency 'dry-types', '~> 1.1'

data/description_types.yml

@@ -46,8 +46,6 @@ contributor:
     description: An institution or other corporate or collective body.
   - value: person
     description: An individual identity.
-  - value: unspecified others
-    description: Designator for one or more additional contributors not named individually.
 contributor.identifier:
   - value: ORCID
     description: Identifier from orcid.org.

data/docs/description_types.md

@@ -49,8 +49,6 @@ _Path: contributor.type_
     * An institution or other corporate or collective body.
   * person
     * An individual identity.
-  * unspecified others
-    * Designator for one or more additional contributors not named individually.
 ## Contributor identifier types
 _Path: contributor.identifier.type_
   * ORCID

data/identifier_source_codes.yml

@@ -0,0 +1,210 @@
+# LC Standard Identifier Source Codes
+# Source: https://www.loc.gov/standards/sourcelist/standard-identifier.html
+# Additional codes: swets, apis
+- agorha
+- agrovoc
+- allmovie
+- allmusic
+- allocine
+- amnbo
+- ansi
+- apis
+- archinl
+- archinpe
+- archinpr
+- archna
+- archns
+- ark
+- artsy
+- artukart
+- artukaw
+- atg
+- balat
+- bbcth
+- bdrc
+- bdusc
+- belvku
+- belvwrk
+- benezit
+- bew
+- bfi
+- bibbi
+- bigenc
+- bnfcg
+- bpn
+- bsi
+- cabt
+- cana
+- cantic
+- cbwpid
+- cerl
+- cgndb
+- clara
+- cnbksy
+- csfdcz
+- danacode
+- darome
+- datoses
+- discogs
+- dkfilm
+- dma
+- doi
+- dpb
+- ean
+- ecli
+- eidr
+- emlo
+- fast
+- fidecp
+- filmaff
+- filmport
+- findagr
+- fisa
+- freebase
+- fuoc
+- gacsch
+- gec
+- geogndb
+- geonames
+- geprishisp
+- gettyaat
+- gettyart
+- gettyobj
+- gettytgn
+- gettyulan
+- gnd
+- gnis
+- goodra
+- gtaa
+- gtin-14
+- hdl
+- iaafa
+- ibdb
+- iconauth
+- idref
+- imdb
+- isan
+- isbn
+- isbn-a
+- isbnre
+- isbnsbn
+- isfdbau
+- isfdbaw
+- isfdbma
+- isfdbpu
+- isil
+- ismn
+- isni
+- iso
+- isrc
+- issn
+- issn-l
+- issue-number
+- istc
+- iswc
+- it-acnp
+- itar
+- kda
+- kdw
+- kinopo
+- knpam
+- kulturnav
+- lattes
+- lccn
+- lcmd
+- lcmpt
+- lei
+- libaus
+- lmhl
+- local
+- margaz
+- matrix-number
+- mesh
+- mocofo
+- moma
+- morana
+- moviemetf
+- moviemetr
+- munzing
+- muscl
+- music-plate
+- music-publisher
+- musicb
+- nacat
+- nagb
+- natgazfid
+- nga
+- ngva
+- ngvw
+- nipo
+- nlg
+- nndb
+- npg
+- nzggn
+- odnb
+- ofdb
+- onix
+- opensm
+- orcid
+- orgnr
+- oxforddnb
+- pcadbu
+- pcadpe
+- pcadpf
+- permid
+- picnypl
+- pleiades
+- pnta
+- porthu
+- prabook
+- rbmsbt
+- rbmsgt
+- rbmspe
+- rbmsppe
+- rbmspt
+- rbmsrd
+- rbmste
+- rid
+- rkda
+- ror
+- s2a3bd
+- saam
+- scholaru
+- scope
+- scopus
+- sici
+- smgp
+- snac
+- spotify
+- sprfbsb
+- sprfbsk
+- sprfcbb
+- sprfcfb
+- sprfhoc
+- sprfoly
+- sprfpfb
+- ssaut
+- stock-number
+- strn
+- stw
+- svfilm
+- swets
+- tatearid
+- theatr
+- tpce
+- trove
+- unescot
+- upc
+- uri
+- urn
+- vd16
+- vd17
+- vd18
+- vgmdb
+- viaf
+- videorecording-identifier
+- wikidata
+- wndla
+- xgamea
+- ysopai
+- zbaut

data/lib/cocina/models/validators/composite_description_validator.rb

@@ -7,8 +7,14 @@ module Cocina
       class CompositeDescriptionValidator
         VALIDATORS = [
           DescriptionTypesVisitorValidator,
+          DescriptionIdentifierSourceCodeVisitorValidator,
+          DescriptionRoleSourceCodeVisitorValidator,
+          DescriptionFormResourceTypeVisitorValidator,
           DescriptionValuesVisitorValidator,
-          DescriptionDateTimeVisitorValidator
+          DescriptionDateTimeVisitorValidator,
+          DescriptionEventDateVisitorValidator,
+          DescriptionSubjectTemporalEncodingVisitorValidator,
+          DescriptionLocationSourceCodeVisitorValidator
         ].freeze
 
         def self.validate(clazz, attributes)

data/lib/cocina/models/validators/description_date_time_visitor_validator.rb

@@ -8,8 +8,9 @@ module Cocina
       # Validates that dates of known types are type-valid using the visitor pattern.
       class DescriptionDateTimeVisitorValidator < BaseDescriptionVisitorValidator
         VALIDATABLE_TYPES = %w[edtf iso8601 w3cdtf].freeze
+        VALID_ENCODING_CODES = %w[edtf iso8601 marc temper w3cdtf].freeze
 
-        def visit_hash(hash:, path:) # rubocop:disable Metrics/CyclomaticComplexity
+        def visit_hash(hash:, path:) # rubocop:disable Metrics/PerceivedComplexity, Metrics/CyclomaticComplexity
           # Only dates nested under a `date` key are subject to validation.
           # For example, event.date is in scope but event.note is not.
           return unless in_date_path?(path)
@@ -32,7 +33,10 @@ module Cocina
           # recursing into its children, so the encoding is always registered
           # before any child value hashes are visited.
           code = hash.dig(:encoding, :code)
-          encoding_paths[path.dup] = code if code && VALIDATABLE_TYPES.include?(code)
+          if code
+            encoding_paths[path.dup] = code if VALIDATABLE_TYPES.include?(code)
+            invalid_encoding_codes << "#{path_to_s(path)}.encoding.code (#{code})" unless VALID_ENCODING_CODES.include?(code)
+          end
 
           value = hash[:value]
           return unless value.is_a?(String)
@@ -62,17 +66,18 @@ module Cocina
         end
 
         def validate!
-          return if invalid_groups.empty?
+          errors = []
 
-          invalid_dates = invalid_groups.filter_map do |path, values|
-            next if values.empty?
+          errors << "Unrecognized date encoding codes in description: #{invalid_encoding_codes.join(', ')}" if invalid_encoding_codes.any?
 
-            [*values, encoding_paths[path]]
+          unless invalid_groups.empty?
+            invalid_dates = invalid_groups.filter_map do |path, values|
+              [*values, encoding_paths[path]] unless values.empty?
+            end
+            errors << "Invalid date(s) in description: #{invalid_dates}" if invalid_dates.any?
           end
 
-          return if invalid_dates.empty?
-
-          raise ValidationError, "Invalid date(s) in description: #{invalid_dates}"
+          raise ValidationError, errors.join('; ') if errors.any?
         end
 
         private
@@ -81,6 +86,10 @@ module Cocina
           @encoding_paths ||= {}
         end
 
+        def invalid_encoding_codes
+          @invalid_encoding_codes ||= []
+        end
+
         def invalid_groups
           @invalid_groups ||= {}
         end

data/lib/cocina/models/validators/description_event_date_visitor_validator.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Validates that event date structuredValue entries with a type also have a value.
+      class DescriptionEventDateVisitorValidator < BaseDescriptionVisitorValidator
+        def visit_hash(hash:, path:)
+          return unless hash[:type] && !hash[:value]
+          return unless event_date_structured_value?(path)
+
+          error_paths << path_to_s(path)
+        end
+
+        def validate!
+          return if error_paths.empty?
+
+          raise ValidationError,
+                "Missing value for type in description: #{error_paths.join(', ')}"
+        end
+
+        private
+
+        def error_paths
+          @error_paths ||= []
+        end
+
+        def event_date_structured_value?(path)
+          return false unless path[0] == 'event' && path[2] == 'date'
+
+          # Direct: event.date.structuredValue, e.g. ["event", 0, "date", 0, "structuredValue", 0]
+          # Via parallelValue: event.date.parallelValue.structuredValue, e.g. ["event", 0, "date", 0, "parallelValue", 0, "structuredValue", 0]
+          path[4] == 'structuredValue' || (path[4] == 'parallelValue' && path[6] == 'structuredValue')
+        end
+      end
+    end
+  end
+end

data/lib/cocina/models/validators/description_form_resource_type_visitor_validator.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Validates form.value against allowed values when form.source.value is a known controlled vocabulary.
+      class DescriptionFormResourceTypeVisitorValidator < BaseDescriptionVisitorValidator
+        def validate!
+          return if error_paths.empty?
+
+          raise ValidationError, "Unrecognized resource type values in description: #{error_paths.join(', ')}"
+        end
+
+        def visit_hash(hash:, path:)
+          return unless form_entry_path?(path)
+          return unless hash[:type].to_s == 'resource type'
+
+          source_value = hash.dig(:source, :value)
+          return unless source_value && valid_values_by_source.key?(source_value)
+
+          value = hash[:value]
+          return unless value
+          return if valid_values_by_source[source_value].include?(value)
+
+          error_paths << "#{path_to_s(path)} (#{value})"
+        end
+
+        private
+
+        def error_paths
+          @error_paths ||= []
+        end
+
+        def form_entry_path?(path)
+          path.length >= 2 && path[-1].is_a?(Integer) && path[-2].to_s == 'form'
+        end
+
+        # rubocop:disable Style/ClassVars
+        def valid_values_by_source
+          @@valid_values_by_source ||= YAML.load_file(::File.expand_path('../../../../resource_type_values.yml', __dir__))
+        end
+        # rubocop:enable Style/ClassVars
+      end
+    end
+  end
+end

data/lib/cocina/models/validators/description_identifier_source_code_visitor_validator.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Validates identifier.source.code values against identifier_source_codes.yml.
+      class DescriptionIdentifierSourceCodeVisitorValidator < BaseDescriptionVisitorValidator
+        def validate!
+          return if error_paths.empty?
+
+          raise ValidationError, "Unrecognized identifier source codes in description: #{error_paths.join(', ')}"
+        end
+
+        def visit_hash(hash:, path:)
+          return unless identifier_path?(path)
+
+          source_code = hash.dig(:source, :code)
+          return unless source_code
+
+          error_paths << "#{path_to_s(path)}.source.code (#{source_code})" unless valid_codes.include?(source_code.downcase)
+        end
+
+        private
+
+        def error_paths
+          @error_paths ||= []
+        end
+
+        def identifier_path?(path)
+          path.length >= 2 && path[-1].is_a?(Integer) && path[-2].to_s == 'identifier'
+        end
+
+        # rubocop:disable Style/ClassVars
+        def valid_codes
+          @@valid_codes ||= YAML.load_file(::File.expand_path('../../../../identifier_source_codes.yml', __dir__)).to_set(&:downcase)
+        end
+        # rubocop:enable Style/ClassVars
+      end
+    end
+  end
+end

data/lib/cocina/models/validators/description_location_source_code_visitor_validator.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Validates location.source.code values against location_source_codes.yml.
+      class DescriptionLocationSourceCodeVisitorValidator < BaseDescriptionVisitorValidator
+        def validate!
+          return if error_paths.empty?
+
+          raise ValidationError, "Unrecognized location source codes in description: #{error_paths.join(', ')}"
+        end
+
+        def visit_hash(hash:, path:)
+          return unless location_path?(path)
+
+          source_code = hash.dig(:source, :code)
+          return unless source_code
+          return if valid_codes.include?(source_code.downcase)
+
+          error_paths << "#{path_to_s(path)}.source.code (#{source_code})"
+        end
+
+        private
+
+        def error_paths
+          @error_paths ||= []
+        end
+
+        def location_path?(path)
+          # Match entries in a location array (e.g., [:location, 0] or [:relatedResource, 0, :location, 0]).
+          path.length >= 2 && path[-1].is_a?(Integer) && path[-2].to_s == 'location'
+        end
+
+        # rubocop:disable Style/ClassVars
+        def valid_codes
+          @@valid_codes ||= YAML.load_file(::File.expand_path('../../../../location_source_codes.yml', __dir__)).to_set(&:downcase)
+        end
+        # rubocop:enable Style/ClassVars
+      end
+    end
+  end
+end

data/lib/cocina/models/validators/description_role_source_code_visitor_validator.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Validates contributor.role.source.code values against role_source_codes.yml.
+      class DescriptionRoleSourceCodeVisitorValidator < BaseDescriptionVisitorValidator
+        def validate!
+          return if error_paths.empty?
+
+          raise ValidationError, "Unrecognized role source codes in description: #{error_paths.join(', ')}"
+        end
+
+        def visit_hash(hash:, path:)
+          return unless role_path?(path)
+
+          source_code = hash.dig(:source, :code)
+          return unless source_code
+          return if valid_codes.include?(source_code.downcase)
+
+          error_paths << "#{path_to_s(path)}.source.code (#{source_code})"
+        end
+
+        private
+
+        def error_paths
+          @error_paths ||= []
+        end
+
+        def role_path?(path)
+          path.length >= 2 && # ensure we have at least two elements (at minimum role and its index)
+            path[-1].is_a?(Integer) &&
+            path[-2].to_s == 'role' && # we have a nested role in the path
+            path.any? { |part| part.to_s == 'contributor' } # there is a contributor in the path (any? allows for nested roles)
+        end
+
+        # Source codes allowed for contributor.role.source.code
+        def valid_codes
+          %w[aat lcmpt marcrelator rbmsrel]
+        end
+      end
+    end
+  end
+end

data/lib/cocina/models/validators/description_subject_temporal_encoding_visitor_validator.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Validates encoding.code for subject entries with type "time" against
+      # temporal_subject_encoding_codes.yml (union of LOC date-time and temporal source lists).
+      class DescriptionSubjectTemporalEncodingVisitorValidator < BaseDescriptionVisitorValidator
+        def validate!
+          return if error_paths.empty?
+
+          raise ValidationError, "Unrecognized subject temporal encoding codes in description: #{error_paths.join(', ')}"
+        end
+
+        def visit_hash(hash:, path:)
+          return unless in_subject_path?(path)
+          return unless hash[:type].to_s == 'time'
+
+          encoding_code = hash.dig(:encoding, :code)
+          return unless encoding_code
+
+          error_paths << "#{path_to_s(path)}.encoding.code (#{encoding_code})" unless valid_codes.include?(encoding_code.downcase)
+        end
+
+        private
+
+        def error_paths
+          @error_paths ||= []
+        end
+
+        def in_subject_path?(path)
+          path.any? { |part| part.to_s == 'subject' }
+        end
+
+        # rubocop:disable Style/ClassVars
+        def valid_codes
+          @@valid_codes ||= YAML.load_file(::File.expand_path('../../../../temporal_subject_encoding_codes.yml', __dir__)).to_set(&:downcase)
+        end
+        # rubocop:enable Style/ClassVars
+      end
+    end
+  end
+end