cocina-models 0.77.0 → 0.80.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3448513fd9c5a834a341c41dc2e532fe9196d5aafca3ed6812f4243ef952e960
-  data.tar.gz: 2c1e122cd5d903ce1d92a443f1d8ab2879aaf8cdc9550f3b27c67342ce32bdc8
+  metadata.gz: 5c78843bdc4b3ba3ec0ea9e2e8fa569fe7979de0e5d1a52fc4923103ed20de36
+  data.tar.gz: b3e317a0154e15973e9a0e57aab07d0d91702a97a31889963d4df2c26339a6d4
 SHA512:
-  metadata.gz: ca06ecb3bf3952a5190dbff8ce3510c4612a49e50f863d70511dd93f6678a184bd2f664197bc7a3ad5004b55d2bc7d66865b85796b39c5701e9eebdb71b580b7
-  data.tar.gz: 804c0deb6ec304f9e2ab44808ec7c9f9e47a4a8df15432ec66d4dd068939116f1f5a22405658a7e20651b961fba4949708b5bd28ede4f63ac0060c126416f7cc
+  metadata.gz: 2fa6986b659b6474ed9ac476237c6da8ff75487bb5c7ab61b33a0226af95c44b22f14210524f258bd75bf826ea141dcc3bb88ce31e2a85b6f4590ec1ea353eec
+  data.tar.gz: e41c8c60d4eafe62b0f4025213f73aa7629284a0e5f73e93d7b356204d075635a3ea7da3af1aaf9557de487e1eee5236c3eec23a92a04d17fc71ecec14e50c48

data/README.md

@@ -55,8 +55,37 @@ If there is a possibility that a model or validation change will conflict with s
 
 1. Create a cocina-models branch containing the proposed change and push to Github.
 2. On sdr-deploy, check out `main`, update the `Gemfile` so that cocina-models references the branch, and `bundle install`.
-3. Run `bin/validate-cocina`.
-4. Check `validate-cocina.csv` for validation errors.
+3. Select the appropriate database.
+For QA:
+```
+export DATABASE_NAME="dor_services"
+export DATABASE_USERNAME=$DOR_SERVICES_DB_USER
+export DATABASE_HOSTNAME=$DOR_SERVICES_DB_QA_HOST
+export DATABASE_PASSWORD=$DOR_SERVICES_DB_QA_PWD
+```
+
+For stage:
+```
+export DATABASE_NAME="dor_services"
+export DATABASE_USERNAME=$DOR_SERVICES_DB_USER
+export DATABASE_HOSTNAME=$DOR_SERVICES_DB_STAGE_HOST
+export DATABASE_PASSWORD=$DOR_SERVICES_DB_STAGE_PWD
+```
+
+For production:
+```
+export DATABASE_NAME="dor_services"
+export DATABASE_USERNAME=$DOR_SERVICES_DB_USER
+export DATABASE_HOSTNAME=$DOR_SERVICES_DB_PROD_HOST
+export DATABASE_PASSWORD=$DOR_SERVICES_DB_PROD_PWD
+```
+
+4. Run `bin/validate-cocina`:
+```
+export RUBYOPT='-W:no-deprecated -W:no-experimental'
+RAILS_ENV=production bin/validate-cocina -p 8
+```
+5. Check `validate-cocina.csv` for validation errors.
 
 ## Releasing
 

data/description_types.yml

@@ -391,6 +391,8 @@ identifier:
   - value: record id
   - value: Senate Number
   - value: Series
+  - value: SICI
+    code: sici
   - value: SIRSI
   - value: Source ID
   - value: sourceID

data/docs/description_types.md

@@ -385,6 +385,7 @@ _Path: identifier.type_
   * record id
   * Senate Number
   * Series
+  * SICI
   * SIRSI
   * Source ID
   * sourceID

data/lib/cocina/generator/schema.rb

@@ -13,8 +13,8 @@ module Cocina
           # frozen_string_literal: true
 
           module Cocina
-            module Models
-              class #{name} < Struct
+            module Models#{'              '}
+              #{preamble}class #{name} < Struct
 
                 #{validate}
                 #{types}

data/lib/cocina/generator/schema_base.rb

@@ -41,6 +41,12 @@ module Cocina
         "# #{schema_doc.description}\n"
       end
 
+      def deprecation
+        return '' unless schema_doc.deprecated?
+
+        "# DEPRECATED\n"
+      end
+
       def example
         return '' unless schema_doc.example
 
@@ -82,6 +88,10 @@ module Cocina
           'Strict::String'
         end
       end
+
+      def preamble
+        "#{deprecation}#{description}#{example}#{relaxed_comment}"
+      end
     end
   end
 end

data/lib/cocina/generator/schema_value.rb

@@ -19,10 +19,6 @@ module Cocina
         "Types::#{dry_datatype(schema_doc)}#{optional}#{default}#{enum}"
       end
 
-      def preamble
-        "#{description}#{example}#{relaxed_comment}"
-      end
-
       def enum
         return '' if !schema_doc.enum || relaxed
 

data/lib/cocina/models/access_role.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Access role conferred by an AdminPolicy to objects within it. (used by Argo)
     class AccessRole < Struct
       # Name of role
       attribute :name, Types::Strict::String.enum('dor-apo-depositor', 'dor-apo-manager', 'dor-apo-viewer', 'sdr-administrator', 'sdr-viewer', 'hydrus-collection-creator', 'hydrus-collection-manager', 'hydrus-collection-depositor', 'hydrus-collection-item-depositor', 'hydrus-collection-reviewer', 'hydrus-collection-viewer')

data/lib/cocina/models/access_role_member.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Represents a user or group that is a member of an AccessRole
     class AccessRoleMember < Struct
       include Checkable
 

data/lib/cocina/models/admin_policy_access_template.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Provides the template of access settings that is copied to the items goverend by an AdminPolicy. This is almost the same as DROAccess, but it provides no defaults and has no embargo.
     class AdminPolicyAccessTemplate < Struct
       attribute? :view, Types::Strict::String.enum('world', 'stanford', 'location-based', 'citation-only', 'dark')
       # Available for controlled digital lending.

data/lib/cocina/models/admin_policy_administrative.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Administrative properties for an AdminPolicy
     class AdminPolicyAdministrative < Struct
       attribute(:accessTemplate, AdminPolicyAccessTemplate.default { AdminPolicyAccessTemplate.new })
       attribute :registrationWorkflow, Types::Strict::Array.of(Types::Strict::String).default([].freeze)

data/lib/cocina/models/admin_policy_with_metadata.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Admin Policy with addition object metadata.
     class AdminPolicyWithMetadata < Struct
       include Validatable
 

data/lib/cocina/models/applies_to.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Property model for indicating the parts, aspects, or versions of the resource to which a descriptive element is applicable.
     class AppliesTo < Struct
       attribute :appliesTo, Types::Strict::Array.of(DescriptiveBasicValue).default([].freeze)
     end

data/lib/cocina/models/collection.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # A group of Digital Repository Objects that indicate some type of conceptual grouping within the domain that is worth reusing across the system.
     class Collection < Struct
       include Validatable
 

data/lib/cocina/models/collection_access.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Access metadata for collections
     class CollectionAccess < Struct
       # Access level
       attribute? :view, Types::Strict::String.default('dark').enum('world', 'dark')

data/lib/cocina/models/collection_with_metadata.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Collection with addition object metadata.
     class CollectionWithMetadata < Struct
       include Validatable
 

data/lib/cocina/models/contributor.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Property model for describing agents contributing in some way to the creation and history of the resource.
     class Contributor < Struct
       attribute :name, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
       # Entity type of the contributor (person, organization, etc.). See https://github.com/sul-dlss/cocina-models/blob/main/docs/description_types.md for valid types.

data/lib/cocina/models/descriptive_access_metadata.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Information about how to access digital and physical versions of the object.
     class DescriptiveAccessMetadata < Struct
       attribute :url, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
       attribute :physicalLocation, Types::Strict::Array.of(DescriptiveValue).default([].freeze)

data/lib/cocina/models/descriptive_admin_metadata.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Information about this resource description.
     class DescriptiveAdminMetadata < Struct
       attribute :contributor, Types::Strict::Array.of(Contributor).default([].freeze)
       attribute :event, Types::Strict::Array.of(Event).default([].freeze)

data/lib/cocina/models/descriptive_basic_value.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Basic value model for descriptive elements. Can only have one of value, parallelValue, groupedValue, or structuredValue.
     class DescriptiveBasicValue < Struct
       attribute :structuredValue, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
       attribute :parallelValue, Types::Strict::Array.of(DescriptiveValue).default([].freeze)

data/lib/cocina/models/descriptive_geographic_metadata.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Value model for mods geographic extension metadata
     class DescriptiveGeographicMetadata < Struct
       attribute :form, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
       attribute :subject, Types::Strict::Array.of(DescriptiveValue).default([].freeze)

data/lib/cocina/models/descriptive_grouped_value.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Value model for a set of descriptive elements grouped together in an unstructured way.
     class DescriptiveGroupedValue < Struct
       attribute :groupedValue, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
     end

data/lib/cocina/models/descriptive_parallel_contributor.rb

@@ -2,6 +2,8 @@
 
 module Cocina
   module Models
+    # DEPRECATED
+    # Value model for multiple representations of information about the same contributor (e.g. in different languages).
     class DescriptiveParallelContributor < Struct
       attribute :name, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
       # Entity type of the contributor (person, organization, etc.). See https://github.com/sul-dlss/cocina-models/blob/main/docs/description_types.md for valid types.

data/lib/cocina/models/descriptive_parallel_event.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Value model for multiple representations of information about the same event (e.g. in different languages).
     class DescriptiveParallelEvent < Struct
       attribute :structuredValue, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
       # Description of the event (creation, publication, etc.).

data/lib/cocina/models/descriptive_parallel_value.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Value model for multiple representations of the same information (e.g. in different languages).
     class DescriptiveParallelValue < Struct
       attribute :parallelValue, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
     end

data/lib/cocina/models/descriptive_structured_value.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Value model for descriptive elements structured as typed, ordered values.
     class DescriptiveStructuredValue < Struct
       attribute :structuredValue, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
     end

data/lib/cocina/models/descriptive_value.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Default value model for descriptive elements.
     class DescriptiveValue < Struct
       attribute :structuredValue, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
       attribute :parallelValue, Types::Strict::Array.of(DescriptiveValue).default([].freeze)

data/lib/cocina/models/descriptive_value_language.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Language of the descriptive element value
     class DescriptiveValueLanguage < Struct
       # Code representing the standard or encoding.
       attribute? :code, Types::Strict::String

data/lib/cocina/models/dro.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Domain-defined abstraction of a 'work'. Digital Repository Objects' abstraction is describable for our domain’s purposes, i.e. for management needs within our system.
     class DRO < Struct
       include Validatable
 

data/lib/cocina/models/dro_structural.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Structural metadata
     class DROStructural < Struct
       attribute :contains, Types::Strict::Array.of(FileSet).default([].freeze)
       attribute :hasMemberOrders, Types::Strict::Array.of(Sequence).default([].freeze)

data/lib/cocina/models/dro_with_metadata.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # DRO with addition object metadata.
     class DROWithMetadata < Struct
       include Validatable
 

data/lib/cocina/models/event.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Property model for describing events in the history of the resource.
     class Event < Struct
       attribute :structuredValue, Types::Strict::Array.of(DescriptiveValue).default([].freeze)
       # Description of the event (creation, publication, etc.).

data/lib/cocina/models/file.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Binaries that are the basis of what our domain manages. Binaries here do not include metadata files generated for the domain's own management purposes.
     class File < Struct
       include Checkable
 

data/lib/cocina/models/file_access.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Access metadata for files
     class FileAccess < Struct
       # Access level.
       # Validation of this property is relaxed. See the openapi for full validation.

data/lib/cocina/models/file_set.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Relevant groupings of Files. Also called a File Grouping.
     class FileSet < Struct
       include Checkable
 

data/lib/cocina/models/file_set_structural.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Structural metadata
     class FileSetStructural < Struct
       attribute :contains, Types::Strict::Array.of(File).default([].freeze)
     end

data/lib/cocina/models/geographic.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Geographic metadata
     class Geographic < Struct
       # Geographic ISO 19139 XML metadata
       attribute :iso19139, Types::Strict::String

data/lib/cocina/models/language.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Languages, scripts, symbolic systems, and notations used in all or part of a resource or its descriptive metadata.
     class Language < Struct
       attribute :appliesTo, Types::Strict::Array.of(DescriptiveBasicValue).default([].freeze)
       # Code value of the descriptive element.

data/lib/cocina/models/mapping/from_mods/name_builder.rb

@@ -41,8 +41,8 @@ module Cocina
               status: name_elements.filter_map { |name_element| name_element['usage'] }.first
             }.compact
             { name: [names] }.tap do |attrs|
-              roles = name_elements.flat_map { |name_node| build_roles(name_node) }.compact.uniq
-              attrs[:role] = roles.presence
+              attrs[:role] = name_elements.flat_map { |name_node| build_roles(name_node) }.compact.uniq.presence
+              attrs[:note] = name_elements.flat_map { |name_node| build_affiliation_notes(name_node) }.compact.uniq.presence
             end.compact
           end
 
@@ -51,7 +51,7 @@ module Cocina
               status: name_node['usage']
             }.compact.merge(common_lang_script(name_node))
 
-            name_attrs = name_attrs.merge(common_name(name_node, name_attrs[:name]))
+            name_attrs = name_attrs.merge(common_name(name_node, name_attrs[:name], is_parallel: true))
             name_parts = build_name_parts(name_node)
             notifier.warn('Missing name/namePart element') if name_parts.all?(&:empty?)
             name_parts.each { |name_part| name_attrs = name_part.merge(name_attrs) }
@@ -85,9 +85,9 @@ module Cocina
             }.compact.merge(common_name(name_node, name_parts))
           end
 
-          def common_name(name_node, name)
+          def common_name(name_node, name, is_parallel: false)
             {
-              note: build_notes(name_node),
+              note: build_notes(name_node, is_parallel: is_parallel),
               identifier: build_identifier(name_node)
             }.tap do |attrs|
               roles = build_roles(name_node)
@@ -224,12 +224,8 @@ module Cocina
             end.presence
           end
 
-          def build_notes(name_node)
+          def build_notes(name_node, is_parallel:)
             [].tap do |parts|
-              name_node.xpath('mods:affiliation', mods: Description::DESC_METADATA_NS).each do |affiliation_node|
-                parts << { value: affiliation_node.text, type: 'affiliation' }
-              end
-
               description = name_node.xpath('mods:description', mods: Description::DESC_METADATA_NS).first
               if description
                 parts << if description.text == UNCITED_DESCRIPTION
@@ -238,9 +234,18 @@ module Cocina
                            { value: description.text, type: 'description' }
                          end
               end
+              parts.concat(build_affiliation_notes(name_node)) unless is_parallel
             end.presence
           end
 
+          def build_affiliation_notes(name_node)
+            [].tap do |parts|
+              name_node.xpath('mods:affiliation', mods: Description::DESC_METADATA_NS).each do |affiliation_node|
+                parts << { value: affiliation_node.text, type: 'affiliation' }
+              end
+            end
+          end
+
           def build_roles(name_node)
             role_nodes = name_node.xpath('mods:role', mods: Description::DESC_METADATA_NS)
             role_nodes.filter_map { |role_node| role_for(role_node) }.presence

data/lib/cocina/models/mapping/normalizers/mods/name_normalizer.rb

@@ -20,6 +20,7 @@ module Cocina
 
             def normalize
               normalize_parallel_name_role
+              normalize_parallel_affiliation_note
               normalize_text_role_term
               normalize_role_term
               normalize_role # must be after normalize_role_term
@@ -35,10 +36,13 @@ module Cocina
 
             attr_reader :ng_xml
 
+            def grouped_name_nodes
+              name_nodes = ng_xml.root.xpath('//mods:name[@altRepGroup]', mods: ModsNormalizer::MODS_NS)
+              name_nodes.group_by { |name_node| name_node['altRepGroup'] }.values.reject { |name_node_group| name_node_group.size == 1 }
+            end
+
             def normalize_parallel_name_role
               # For parallel names, all should have the same roles.
-              name_nodes = ng_xml.root.xpath('//mods:name[@altRepGroup]', mods: ModsNormalizer::MODS_NS)
-              grouped_name_nodes = name_nodes.group_by { |name_node| name_node['altRepGroup'] }.values.reject { |name_node_group| name_node_group.size == 1 }
               grouped_name_nodes.each do |name_node_group|
                 name_node_with_role = name_node_group.find { |name_node| role_node_for(name_node) }
                 next unless name_node_with_role
@@ -58,6 +62,27 @@ module Cocina
               name_node.xpath('mods:role', mods: ModsNormalizer::MODS_NS).first
             end
 
+            def normalize_parallel_affiliation_note
+              # For parallel names, all should have the same affiliation.
+              grouped_name_nodes.each do |name_node_group|
+                name_node_with_affiliation = name_node_group.find { |name_node| affiliation_node_for(name_node) }
+                next unless name_node_with_affiliation
+
+                name_node_group.each do |name_node|
+                  next if name_node == name_node_with_affiliation
+
+                  existing_affiliation_node = affiliation_node_for(name_node)
+                  existing_affiliation_node&.remove
+
+                  name_node << affiliation_node_for(name_node_with_affiliation).dup
+                end
+              end
+            end
+
+            def affiliation_node_for(name_node)
+              name_node.xpath('mods:affiliation', mods: ModsNormalizer::MODS_NS).first
+            end
+
             def normalize_text_role_term
               # Add the type="text" attribute to roleTerms that don't have a type (seen in MODS 3.3 druid:yy910cj7795)
               ng_xml.root.xpath('//mods:roleTerm[not(@type)]', mods: ModsNormalizer::MODS_NS).each do |role_term_node|

data/lib/cocina/models/mapping/to_mods/name_writer.rb

@@ -199,8 +199,6 @@ module Cocina
                 xml.affiliation note.value
               when 'description'
                 xml.description note.value
-              when 'citation status'
-                xml.description UNCITED_DESCRIPTION if note.value == 'false'
               end
             end
           end

data/lib/cocina/models/mapping/to_mods/subject.rb

@@ -394,7 +394,7 @@ module Cocina
             xml.name name_attrs do
               write_name_part(subject_value)
               write_display_form(display_values)
-              write_roles(subject.note)
+              write_roles(subject_value.note)
               write_other_notes(subject.note, 'description')
               write_other_notes(subject.note, 'affiliation')
             end
@@ -410,7 +410,7 @@ module Cocina
               write_display_form(display_values)
               write_roles(subject.note)
               write_other_notes(subject.note, 'description')
-              write_other_notes(subject.note, 'affiliation')
+              write_other_notes(subject_value.note, 'affiliation')
             end
             write_genres(subject_value)
           end

data/lib/cocina/models/message_digest.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # The output of the message digest algorithm.
     class MessageDigest < Struct
       include Checkable
 

data/lib/cocina/models/object_metadata.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Metadata for a cocina object.
     class ObjectMetadata < Struct
       # When the object was created.
       attribute? :created, Types::Params::DateTime

data/lib/cocina/models/presentation.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Presentation data for the File.
     class Presentation < Struct
       # Height in pixels
       attribute? :height, Types::Strict::Integer

data/lib/cocina/models/related_resource.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Other resource associated with the described resource.
     class RelatedResource < Struct
       # The relationship of the related resource to the described resource.
       attribute? :type, Types::Strict::String

data/lib/cocina/models/release_tag.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # A tag that indicates the item or collection should be released.
     class ReleaseTag < Struct
       # Who did this release
       # example: petucket

data/lib/cocina/models/request_admin_policy.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Same as an AdminPolicy, but doesn't have an externalIdentifier as one will be created
     class RequestAdminPolicy < Struct
       include Validatable
 

data/lib/cocina/models/request_collection.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Same as a Collection, but doesn't have an externalIdentifier as one will be created
     class RequestCollection < Struct
       include Validatable
 

data/lib/cocina/models/request_description.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Description that is included in a request to create a DRO. This is the same as a Description, except excludes PURL.
     class RequestDescription < Struct
       include Validatable
 

data/lib/cocina/models/request_dro.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # A request to create a DRO.  This has the same general structure as a DRO but doesn't have externalIdentifier and doesn't require the access subschema. If no access subschema is provided, these values will be inherited from the AdminPolicy.
     class RequestDRO < Struct
       include Validatable
 

data/lib/cocina/models/request_dro_structural.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Structural metadata
     class RequestDROStructural < Struct
       attribute :contains, Types::Strict::Array.of(RequestFileSet).default([].freeze)
       attribute :hasMemberOrders, Types::Strict::Array.of(Sequence).default([].freeze)

data/lib/cocina/models/request_file_set_structural.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Structural metadata
     class RequestFileSetStructural < Struct
       attribute :contains, Types::Strict::Array.of(RequestFile).default([].freeze)
     end

data/lib/cocina/models/request_identification.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Same as a Identification, but requires a sourceId and doesn't permit a DOI.
     class RequestIdentification < Struct
       # A barcode
       attribute? :barcode, Types::Nominal::Any

data/lib/cocina/models/sequence.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # A sequence or ordering of resources within a Collection or Object.
     class Sequence < Struct
       attribute :members, Types::Strict::Array.of(Types::Strict::String).default([].freeze)
       # The direction that a sequence of canvases should be displayed to the user

data/lib/cocina/models/source.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Property model for indicating the vocabulary, authority, or other origin for a term, code, or identifier.
     class Source < Struct
       # Code representing the value source.
       attribute? :code, Types::Strict::String

data/lib/cocina/models/standard.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # Property model for indicating the encoding, standard, or syntax to which a value conforms (e.g. RDA).
     class Standard < Struct
       # Code representing the standard or encoding.
       attribute? :code, Types::Strict::String

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

@@ -11,7 +11,7 @@ module Cocina
 
         def initialize(clazz, attributes)
           @clazz = clazz
-          @attributes = attributes.deep_symbolize_keys
+          @attributes = attributes
           @error_paths = []
         end
 
@@ -29,9 +29,7 @@ module Cocina
         attr_reader :clazz, :attributes, :error_paths
 
         def meets_preconditions?
-          resources.any? do |resource|
-            titles_with_associated_name_note_for(resource).present?
-          end
+          [Cocina::Models::Description, Cocina::Models::RequestDescription].include?(clazz)
         end
 
         def valid?(resource)

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

@@ -11,7 +11,7 @@ module Cocina
 
         def initialize(clazz, attributes)
           @clazz = clazz
-          @attributes = attributes.deep_symbolize_keys
+          @attributes = attributes
           @error_paths = []
         end
 
@@ -30,8 +30,7 @@ module Cocina
         attr_reader :clazz, :attributes, :error_paths
 
         def meets_preconditions?
-          attributes.key?(:description) || [Cocina::Models::Description,
-                                            Cocina::Models::RequestDescription].include?(clazz)
+          [Cocina::Models::Description, Cocina::Models::RequestDescription].include?(clazz)
         end
 
         def validate_hash(hash, path)

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

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    module Validators
+      # Validates that there is only one of value, groupedValue, structuredValue, or parallelValue.
+      class DescriptionValuesValidator
+        def self.validate(clazz, attributes)
+          new(clazz, attributes).validate
+        end
+
+        def initialize(clazz, attributes)
+          @clazz = clazz
+          @attributes = attributes
+          @error_paths = []
+        end
+
+        def validate
+          return unless meets_preconditions?
+
+          validate_obj(attributes, [])
+
+          return if error_paths.empty?
+
+          raise ValidationError, "Multiple value, groupedValue, structuredValue, and parallelValue in description: #{error_paths.join(', ')}"
+        end
+
+        private
+
+        attr_reader :clazz, :attributes, :error_paths
+
+        def meets_preconditions?
+          [Cocina::Models::Description, Cocina::Models::RequestDescription].include?(clazz)
+        end
+
+        def validate_hash(hash, path)
+          validate_values(hash, path)
+          hash.each do |key, obj|
+            validate_obj(obj, path + [key])
+          end
+        end
+
+        def validate_array(array, path)
+          array.each_with_index do |obj, index|
+            validate_obj(obj, path + [index])
+          end
+        end
+
+        def validate_obj(obj, path)
+          validate_hash(obj, path) if obj.is_a?(Hash)
+          validate_array(obj, path) if obj.is_a?(Array)
+        end
+
+        def validate_values(hash, path)
+          return unless hash.count { |key, value| %i[value groupedValue structuredValue parallelValue].include?(key) && value.present? } > 1
+
+          error_paths << path_to_s(path)
+        end
+
+        def path_to_s(path)
+          # This matches the format used by descriptive spreadsheets
+          path_str = ''
+          path.each_with_index do |part, index|
+            if part.is_a?(Integer)
+              path_str += (part + 1).to_s
+            else
+              path_str += '.' if index.positive?
+              path_str += part.to_s
+            end
+          end
+          path_str
+        end
+      end
+    end
+  end
+end

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

@@ -11,7 +11,8 @@ module Cocina
           PurlValidator,
           CatalogLinksValidator,
           AssociatedNameValidator,
-          DescriptionTypesValidator
+          DescriptionTypesValidator,
+          DescriptionValuesValidator
         ].freeze
 
         def self.validate(clazz, attributes)
@@ -25,8 +26,7 @@ module Cocina
           # In the meantime, copying code.
           attributes_hash = deep_transform_values(attributes.to_h) do |value|
             value.class.name.starts_with?('Cocina::Models') ? value.to_h : value
-          end.with_indifferent_access
-
+          end.deep_symbolize_keys.with_indifferent_access
           VALIDATORS.each { |validator| validator.validate(clazz, attributes_hash) }
         end
 

data/lib/cocina/models/version.rb

@@ -2,6 +2,6 @@
 
 module Cocina
   module Models
-    VERSION = '0.77.0'
+    VERSION = '0.80.0'
   end
 end

data/lib/cocina/models.rb

@@ -119,7 +119,7 @@ module Cocina
     # @param [DROWithMetadata,CollectionWithMetadata,AdminPolicyWithMetadata] cocina_object
     # @return [DRO,Collection,AdminPolicy]
     def self.without_metadata(cocina_object)
-      build(cocina_object.to_h.except(:created, :modified, :lock))
+      build(cocina_object.to_h.except(:created, :modified, :lock), validate: false)
     end
 
     # Adds metadata to a DRO, Collection, AdminPolicy
@@ -144,7 +144,7 @@ module Cocina
               else
                 AdminPolicyWithMetadata
               end
-      clazz.new(props)
+      clazz.new(props, false, false)
     end
 
     def self.type_for(dyn)

data/lib/cocina/rspec/factories.rb

@@ -45,24 +45,31 @@ module Cocina
         type: Cocina::Models::ObjectType.object,
         id: 'druid:bc234fg5678',
         version: 1,
-        label: 'test object',
-        title: 'test object',
+        label: 'factory DRO label',
+        title: 'factory DRO title',
         source_id: 'sul:1234',
         admin_policy_id: 'druid:hv992ry2431'
       }.freeze
 
       REQUEST_DRO_DEFAULTS = DRO_DEFAULTS.except(:id)
 
-      COLLECTION_DEFAULTS = DRO_DEFAULTS.except(:source_id).merge(type: Cocina::Models::ObjectType.collection)
+      COLLECTION_DEFAULTS = {
+        type: Cocina::Models::ObjectType.collection,
+        id: 'druid:bb222ff5555',
+        version: 1,
+        label: 'factory collection label',
+        title: 'factory collection title',
+        admin_policy_id: 'druid:hv992ry2431'
+      }.freeze
 
       REQUEST_COLLECTION_DEFAULTS = COLLECTION_DEFAULTS.except(:id)
 
       ADMIN_POLICY_DEFAULTS = {
         type: Cocina::Models::ObjectType.admin_policy,
-        id: 'druid:bc234fg5678',
+        id: 'druid:cb432gf8765',
         version: 1,
-        label: 'test admin policy',
-        title: 'test admin policy',
+        label: 'factory APO label',
+        title: 'factory APO title',
         admin_policy_id: 'druid:hv992ry2431',
         agreement_id: 'druid:hp308wm0436'
       }.freeze

data/openapi.yml

@@ -691,7 +691,7 @@ components:
           items:
             $ref: "#/components/schemas/DescriptiveValue"
     DescriptiveBasicValue:
-      description: Basic value model for descriptive elements.
+      description: Basic value model for descriptive elements. Can only have one of value, parallelValue, groupedValue, or structuredValue.
       type: object
       # additionalProperties breaks the validator for allOf, unclear as to why.
       # additionalProperties: false
@@ -779,6 +779,7 @@ components:
             $ref: "#/components/schemas/DescriptiveValue"
     DescriptiveParallelContributor:
       description: Value model for multiple representations of information about the same contributor (e.g. in different languages).
+      deprecated: true
       type: object
       additionalProperties: false
       properties:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocina-models
 version: !ruby/object:Gem::Version
-  version: 0.77.0
+  version: 0.80.0
 platform: ruby
 authors:
 - Justin Coyne
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-05-02 00:00:00.000000000 Z
+date: 2022-05-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -462,6 +462,7 @@ files:
 - lib/cocina/models/validators/catalog_links_validator.rb
 - lib/cocina/models/validators/dark_validator.rb
 - lib/cocina/models/validators/description_types_validator.rb
+- lib/cocina/models/validators/description_values_validator.rb
 - lib/cocina/models/validators/open_api_validator.rb
 - lib/cocina/models/validators/purl_validator.rb
 - lib/cocina/models/validators/validator.rb
@@ -476,7 +477,7 @@ homepage: https://github.com/sul-dlss/cocina-models
 licenses: []
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -491,8 +492,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.32
-signing_key: 
+rubygems_version: 3.3.9
+signing_key:
 specification_version: 4
 summary: Data models for the SDR
 test_files: []