id: https://nde.nl/ontology/hc/class/FindingAid
name: finding_aid_class
title: FindingAid Class
prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  rico: https://www.ica.org/standards/RiC/ontology#
  crm: http://www.cidoc-crm.org/cidoc-crm/
  bf: http://id.loc.gov/ontologies/bibframe/
  skos: http://www.w3.org/2004/02/skos/core#
  dcterms: http://purl.org/dc/terms/
  schema: http://schema.org/
  wd: http://www.wikidata.org/entity/
  prov: http://www.w3.org/ns/prov#
  foaf: http://xmlns.com/foaf/0.1/
  xsd: http://www.w3.org/2001/XMLSchema#
default_prefix: hc
default_range: string
imports:
  - linkml:types
  - ./FindingAidType
  - ./WebClaim
  - ./Overview
  - ./WebLink
  - ../slots/temporal_extent  # was: valid_from + valid_to - migrated per Rule 53
  - ./TimeSpan
  # REMOVED 2026-01-14: valid_from + valid_to - migrated to temporal_extent (Rule 53)
  - ../slots/id
  - ../slots/description
  - ../slots/has_or_had_content  # was: temporal_coverage - migrated per Rule 53/56 (2026-01-16)
  - ./Content
  - ../slots/has_or_had_access_restriction
  - ../slots/has_or_had_web_claim
  - ../slots/language
  - ../slots/supersedes_or_superseded  # was: supersede - migrated per Rule 53/56 (2026-01-17)
  - ../slots/is_or_was_superseded_by  # was: superseded_by - migrated per Rule 53/56 (2026-01-16)
  - ../slots/revision_date
  - ../slots/served_by
  - ../slots/retrieval_agent
  - ../slots/extraction_note
  - ../slots/extraction_method
  # REMOVED: ../slots/xpath - migrated to has_or_had_provenance_path with XPath class (2026-01-15, Rule 53)
  - ../slots/has_or_had_provenance_path
  - ./XPath
  - ../slots/css_selector
  # REMOVED 2026-01-19: ../slots/confidence - migrated to is_or_was_generated_by + GenerationEvent + ConfidenceScore (Rule 53)
  - ../slots/is_or_was_generated_by
  - ./GenerationEvent
  - ./ConfidenceScore
  - ./ConfidenceMethod
  - ../slots/html_file
  # REMOVED 2026-01-18: ../slots/claim_id - migrated to has_or_had_identifier + Identifier (Rule 53)
  - ../slots/has_or_had_identifier
  - ./Identifier
  # REMOVED 2026-01-19: ../slots/claim_type - migrated to has_or_had_type + ClaimType (Rule 53)
  # REMOVED 2026-01-18: ../slots/claim_value - migrated to has_or_had_content + Content (Rule 53) - import via WebClaim
  - ../slots/source_url
  - ../slots/has_or_had_label  # was: title - migrated per Rule 53
  - ../slots/date
  - ../slots/note
  - ../slots/creator
  # REMOVED 2026-01-17: ../slots/publisher - migrated to has_or_had_publisher + Publisher (Rule 53/56)
  - ../slots/has_or_had_publisher
  - ./Publisher
  # - ../slots/publication_date  # ARCHIVED 2026-01-17 - migrated per Rule 53/56
  - ../slots/is_or_was_published_at  # was: publication_date - migrated per Rule 53/56 (2026-01-17)
  - ./PublicationEvent  # for is_or_was_published_at range
  - ./Quantity  # for has_or_had_quantity range (was: claims_count) - added 2026-01-19
  - ../slots/isbn
  - ../slots/has_or_had_access_condition
  - ../slots/is_or_was_access_restricted
  - ../slots/has_or_had_comprehensive_overview
  # REMOVED 2026-01-22: card_description, card_description_en → has_or_had_description + Description (with language tag) per slot_fixes.yaml
  - ../slots/card_image_url
  - ../slots/card_title
  - ../slots/card_title_en
  - ../slots/card_url
  - ../slots/has_or_had_quantity  # was: claims_count - migrated per Rule 53 (2026-01-19)
  # REMOVED 2026-01-22: ../slots/colonial - migrated to includes_or_included + GeoSpatialPlace + is_or_was_categorized_as + ColonialStatus (Rule 53)
  - ../slots/includes_or_included
  - ./GeoSpatialPlace
  - ../slots/is_or_was_categorized_as
  - ./ColonialStatus
  - ../slots/content_block
  - ../slots/crawler_version
  - ../slots/custodian
  - ../slots/date_retrieved
  - ../slots/de
  - ../slots/ead_id
  - ../slots/en
  - ../slots/end
  - ../slots/has_or_had_external_resource
  - ../slots/has_or_had_featured_item
  - ../slots/finding_aid_note
  - ../slots/finding_aid_scope_note
  - ../slots/has_or_had_type
  # MIGRATED 2026-01-22: format → has_or_had_format + Format (Rule 53)
  - ../slots/has_or_had_format
  - ./Format
  # MIGRATED 2026-01-22: fr → has_or_had_language + Language (Rule 53)
  - ../slots/has_or_had_language
  - ./Language
  - ../slots/full_name
  - ../slots/geographic_coverage
  - ../slots/ghcid
  - ../slots/heading_level
  - ../slots/heading_text
  - ../slots/heading_text_en
  - ../slots/historical_region
  - ../slots/html_snapshot_path
  - ../slots/inbound_from
  - ../slots/international
  - ../slots/is_sub_guide
  - ../slots/isil
  - ../slots/has_or_had_key_archive
  - ../slots/has_or_had_key_date
  - ../slots/has_or_had_key_period
  - ../slots/link_context
  - ../slots/link_text
  - ../slots/link_type
  - ../slots/link_url
  - ../slots/list_item
  - ../slots/location
  - ../slots/major_city
  - ../slots/name
  - ../slots/nl
  - ../slots/outbound_to
  - ../slots/has_or_had_page_section
  - ../slots/period
  - ../slots/period_description
  - ../slots/period_end
  - ../slots/period_name
  - ../slots/period_start
  - ../slots/has_or_had_period
  - ../slots/permission_required
  - ../slots/primary
  - ../slots/provenance
  - ../slots/related
  - ../slots/has_or_had_related_archive
  - ../slots/has_or_had_related_guide
  - ../slots/relationship
  - ../slots/resource_description
  - ../slots/restriction_description
  - ../slots/restriction_type
  - ../slots/scope
  - ../slots/secondary
  - ../slots/section_id
  - ../slots/has_or_had_section_link
  - ../slots/slug
  - ../slots/specificity_annotation
  - ../slots/start
  - ../slots/has_or_had_description  # was: sub_guide_description - migrated per Rule 53
  - ./Description
  # REMOVED: ../slots/sub_guide_temporal_coverage - migrated to has_or_had_content (2026-01-17, Rule 53/56)
  - ./SubGuideType
  - ../slots/has_or_had_sub_guide
  - ../slots/has_or_had_sub_section
  - ../slots/has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
  # REMOVED: ../slots/title_en - migrated to has_or_had_label with Label (2026-01-14, Rule 53)
  # REMOVED: ../slots/title_nl - migrated to has_or_had_label with Label (2026-01-14, Rule 53)
  - ../slots/has_or_had_label
  - ./Label
  # REMOVED: ../slots/topic - migrated to is_or_was_categorized_as with Topic class (2026-01-15, Rule 53)
  - ../slots/is_or_was_categorized_as
  - ./Topic
  - ./TopicType
  - ./TopicTypes
  # REMOVED: ../slots/type - migrated to has_or_had_type (2026-01-15, Rule 53)
  - ../slots/has_or_had_type  # was: type - migrated per Rule 53 (2026-01-15)
  # REMOVED: ../slots/url - migrated to has_or_had_url with URL class (2025-01-15, Rule 53)
  - ../slots/has_or_had_url
  - ./URL
  # REMOVED 2026-01-14: ../slots/validation_status - migrated to has_or_had_status with ValidationStatus
  - ../slots/has_or_had_status
  - ./ValidationStatus
  - ../slots/is_or_was_instance_of  # was: ../slots/wikidata - migrated per Rule 53 (2026-01-15)
  # REMOVED: ../slots/wikidata_class - migrated to is_or_was_instance_of with WikiDataEntry (2026-01-14, Rule 53)
  - ../slots/is_or_was_instance_of
  - ./WikiDataEntry
  - ../slots/has_or_had_restriction
  - ./Restriction
  - ./FindingAid
  - ./PersonWebClaim
  - ./SpecificityAnnotation
  - ./TemplateSpecificityScore  # was: TemplateSpecificityScores - migrated per Rule 53 (2026-01-17)

  - ./TemplateSpecificityType

  - ./TemplateSpecificityTypes
  - ./TimeSpan
  - ../slots/finding_aid_description
  - ../slots/finding_aid_temporal_coverage
  - ../slots/finding_aid_access_restriction
  - ../slots/has_link
  - ../slots/event
  - ../slots/event_en
  # REMOVED 2026-01-18: ../slots/claim_source_url - unused import, slot migrated to has_or_had_url + URL (Rule 53)
  - ../enums/ExternalResourceTypeEnum
  - ../enums/SubGuideTypeEnum
  - ../enums/RelationshipTypeEnum
  - ../enums/LinkTypeEnum
classes:
  FindingAid:
    class_uri: rico:FindingAid
    description: 'A finding aid - a descriptive tool that establishes intellectual and physical

      control over heritage materials by describing them and facilitating access.


      **DEFINITION** (RiC-O):


      "A finding aid is a set of descriptions that identifies, locates, summarizes,

      and indexes materials in a record-holding organization, typically archives,

      libraries, or museums."


      This class captures the descriptive metadata for finding aids produced by

      heritage custodians to facilitate access to their collections. It supports:


      - Multilingual titles and descriptions (nl, en, etc.)

      - Classification via FindingAidType hierarchy

      - Custodian linkage via GHCID, ISIL, Wikidata

      - Topic/subject indexing

      - Temporal and geographic coverage

      - References to sub-guides and external resources

      - Key archives and related archives

      - Related guides within the repository

      - Provenance tracking for web-harvested data

      - Page structure with web claims and XPath provenance


      - RiC-O: rico:FindingAid

      - Dublin Core: dcterms:BibliographicResource

      - Schema.org: schema:CreativeWork

      - CIDOC-CRM: crm:E31_Document

      - BIBFRAME: bf:Work


      **EXAMPLE FILES**:


      See data/custodian/findingaid/NL-ZH-DHA-A-NA/guide/repository_guide/metadata/

      '
    exact_mappings:
    - rico:FindingAid
    close_mappings:
    - dcterms:BibliographicResource
    - schema:CreativeWork
    - crm:E31_Document
    - bf:Work
    slots:
    - finding_aid_access_restriction
    - has_or_had_comprehensive_overview
    - creator
    - custodian
    - finding_aid_description
    - ead_id
    - has_or_had_external_resource
    - finding_aid_note
    - has_or_had_type
    - has_or_had_format  # was: format - migrated per Rule 53 (2026-01-22)
    - geographic_coverage
    - id
    - isbn
    - has_or_had_key_archive
    - language
    - note
    - has_or_had_page_section
    - provenance
    - is_or_was_published_at  # was: publication_date - migrated per Rule 53/56 (2026-01-17)
    - has_or_had_publisher  # was: publisher - migrated per Rule 53/56 (2026-01-17)
    - has_or_had_related_archive
    - has_or_had_related_guide
    - revision_date
    - finding_aid_scope_note
    - served_by
    - slug
    - specificity_annotation
    - has_or_had_sub_guide
    - is_or_was_superseded_by  # was: superseded_by - migrated per Rule 53/56 (2026-01-16)
    - supersedes_or_superseded  # was: supersede - migrated per Rule 53/56 (2026-01-17)
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    - finding_aid_temporal_coverage
    - has_or_had_label  # was: title
    - is_or_was_categorized_as  # was: topic - migrated per Rule 53 (2026-01-15)
    - has_or_had_url  # was: url - migrated per Rule 53 (2025-01-15)
    - temporal_extent  # was: valid_from + valid_to - migrated per Rule 53
    - has_or_had_web_claim
    # REMOVED: wikidata_class - migrated to is_or_was_instance_of with WikiDataEntry (2026-01-14, Rule 53)
    - is_or_was_instance_of
    slot_usage:
      id:
        identifier: true
        required: true
      slug:
        required: true
      has_or_had_type:
        required: true
        range: FindingAidType
        description: |
          The type classification of this finding aid.
          Uses FindingAidType class hierarchy.
      has_or_had_label:  # was: title
        required: true
      has_or_had_url:
        range: URL
        inlined: true
        required: true
        description: |
          URL of the finding aid web resource.
          MIGRATED from url slot per slot_fixes.yaml (Rule 53, 2025-01-15).
      custodian:
        required: true
      finding_aid_description:
        range: MultilingualText
        inlined: true
      finding_aid_temporal_coverage:
        range: TemporalCoverage
        inlined: true
      finding_aid_access_restriction:
        range: AccessRestriction
        multivalued: true
        inlined_as_list: true
      has_or_had_web_claim:
        range: WebClaim
        multivalued: true
        inlined_as_list: true
      language:
        multivalued: true
      has_or_had_comprehensive_overview:
        range: Overview
        inlined: true
        description: |
          Comprehensive collection of all links from this finding aid.
          Replaces previous all_links slot with typed Overview class.
      is_or_was_categorized_as:
        range: Topic
        multivalued: true
        inlined_as_list: true
        description: |
          Subject topics covered by this finding aid.
          MIGRATED from topic slot per slot_fixes.yaml (Rule 53, 2026-01-15).
          
          Uses Topic class with TopicType classification.
        examples:
        - value: |
            - has_or_had_type: GenealogyTopic
              has_or_had_label:
                - label_value: "Genealogy"
                  language_code: "en"
          description: Genealogy topic assignment
      has_or_had_publisher:  # was: publisher - migrated per Rule 53/56 (2026-01-17)
        range: Publisher
        inlined: true
        multivalued: true
        required: false
        description: |
          Publisher of the finding aid publication.
          MIGRATED from publisher slot per Rule 53/56 (2026-01-17).
          
          Uses Publisher class for structured representation including:
          - Publisher name (required)
          - Publisher type (institutional, commercial, academic)
          - Location
          - Identifiers
        examples:
        - value:
            has_or_had_label: Nationaal Archief
            has_or_had_type: institutional
            has_or_had_location: Den Haag
          description: National archive as institutional publisher
        - value:
            has_or_had_label: Rijksarchiefdienst
            has_or_had_type: government
            has_or_had_location: Den Haag
          description: Government archival service publisher
    comments:
    - Root class for finding aid metadata YAML files
    - Designed for validation with linkml-validate
    - Supports Nationaal Archief zoekhulpen structure
    - Merged from FindingAidMetadata.yaml (slot names) and FindingAid.yaml (bibliographic slots)
    see_also:
    - https://www.ica.org/standards/RiC/ontology#FindingAid
    - https://www.nationaalarchief.nl/onderzoeken/zoekhulpen
    - http://www.cidoc-crm.org/html/cidoc_crm_v7.1.3.html#E31
    - http://id.loc.gov/ontologies/bibframe/
  MultilingualText:
    class_uri: skos:Concept
    description: |
      Container for multilingual text values (titles, descriptions).
      
      **MIGRATED 2026-01-22**: Language-specific slots (de, en, fr, nl) migrated to
      unified `has_or_had_language` slot with `Language` class per Rule 53.
      
      **Old Pattern** (deprecated):
      ```yaml
      nl: "Nederlandse tekst"
      en: "English text"
      fr: "Texte français"
      ```
      
      **New Pattern**:
      ```yaml
      has_or_had_language:
        - iso_639_1: "nl"
          language_name: "Dutch"
          text_content: "Nederlandse tekst"
        - iso_639_1: "en"
          language_name: "English"
          text_content: "English text"
        - iso_639_1: "fr"
          language_name: "French"
          text_content: "Texte français"
      ```
    slots:
    # MIGRATED 2026-01-22: de, en, fr, nl → has_or_had_language + Language (Rule 53)
    - has_or_had_language
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    slot_usage:
      has_or_had_language:
        range: Language
        multivalued: true
        inlined: true
        inlined_as_list: true
        description: |
          Language-tagged text content.
          MIGRATED from de/en/fr/nl slots per slot_fixes.yaml (Rule 53, 2026-01-22).
          
          Use Language class with iso_639_1, language_name, and text_content.
        examples:
          - value: |
              - iso_639_1: "nl"
                language_name: "Dutch"
                text_content: "Nederlandse tekst"
              - iso_639_1: "en"
                language_name: "English"
                text_content: "English text"
            description: Multilingual text with Dutch and English versions
    comments:
    - At least one language entry should be populated
    - nl is primary for Dutch archives
    - MIGRATED 2026-01-22 from separate de/en/fr/nl slots to unified has_or_had_language
  CustodianReference:
    class_uri: rico:Agent
    description: 'Reference to the heritage custodian that created/maintains this finding aid.


      Uses standard identifiers: GHCID, ISIL, Wikidata ID.

      '
    slots:
    - ghcid
    - isil
    - name
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    - is_or_was_instance_of  # was: wikidata - migrated per Rule 53 (2026-01-15)
    slot_usage:
      ghcid:
        required: true
        pattern: ^[A-Z]{2}-[A-Z]{2}-[A-Z]{3}-[A-Z]-[A-Z0-9]+$
      isil:
        pattern: ^[A-Z]{2}-[A-Za-z0-9]+$
      name:
        required: true
      is_or_was_instance_of:  # was: wikidata - migrated per Rule 53 (2026-01-15)
        range: WikiDataEntry
        description: |
          MIGRATED 2026-01-15: Replaces wikidata slot per Rule 53.
          Wikidata Q-number for the custodian.
        examples:
        - value:
            entity_id: Q190804
            label: Rijksmuseum
          description: Wikidata identifier for Rijksmuseum
    exact_mappings:
    - rico:Agent
    - schema:Organization
  TemporalCoverage:
    class_uri: dcterms:PeriodOfTime
    description: 'Time period covered by the finding aid''s materials.


      Supports both numeric years and special values like "present".

      Can include named periods (key_periods) and significant dates (key_dates).

      '
    slots:
    - end
    - has_or_had_key_date
    - has_or_had_key_period
    - note
    - has_or_had_period
    - specificity_annotation
    - start
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    slot_usage:
      start:
        range: TemporalValue
        required: true
      end:
        range: TemporalValue
        required: true
      has_or_had_period:
        range: TemporalPeriod
        multivalued: true
        inlined_as_list: true
      has_or_had_key_period:
        range: TemporalPeriod
        multivalued: true
        inlined_as_list: true
      has_or_had_key_date:
        range: KeyDate
        multivalued: true
        inlined_as_list: true
    exact_mappings:
    - dcterms:PeriodOfTime
    - schema:temporalCoverage
  TemporalPeriod:
    class_uri: dcterms:PeriodOfTime
    description: A named historical period with optional start/end dates and description.
    slots:
    - period
    - period_description
    - period_end
    - period_name
    - period_start
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    slot_usage:
      period_name:
        range: string
        required: true
        aliases:
        - name
      period:
        range: string
      period_start:
        range: TemporalValue
        aliases:
        - start
      period_end:
        range: TemporalValue
        aliases:
        - end
      period_description:
        range: string
        aliases:
        - description
  KeyDate:
    class_uri: schema:Event
    description: 'A significant historical date with event description.


      Used for key_dates within TemporalCoverage.

      '
    attributes:
      date_value:
        description: ISO 8601 date (YYYY-MM-DD or YYYY)
        range: string
        required: true
        aliases:
        - date
      event:
        description: Description of what happened (Dutch or original)
        range: string
        required: true
      event_en:
        description: English translation of event description
        range: string
    slots:
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
  GeographicCoverage:
    class_uri: dcterms:Location
    description: 'Geographic area covered by the finding aid''s materials.


      Supports primary areas, secondary/related areas, and migration patterns.

      '
    slots:
    # MIGRATED 2026-01-22: colonial → includes_or_included + GeoSpatialPlace + is_or_was_categorized_as + ColonialStatus (Rule 53)
    - includes_or_included
    - is_or_was_categorized_as
    - historical_region
    - inbound_from
    - international
    - major_city
    - outbound_to
    - primary
    - related
    - scope
    - secondary
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    slot_usage:
      primary:
        multivalued: true
      secondary:
        multivalued: true
      related:
        multivalued: true
      historical_region:
        multivalued: true
      # MIGRATED 2026-01-22: colonial → includes_or_included + is_or_was_categorized_as (Rule 53)
      includes_or_included:
        description: |
          MIGRATED from colonial per slot_fixes.yaml (Rule 53, 2026-01-22).
          Geographic territories included in this coverage area.
          Use GeoSpatialPlace for structured geographic data.
        range: GeoSpatialPlace
        multivalued: true
        inlined: true
        inlined_as_list: true
        examples:
          - value:
              geospatial_id: https://nde.nl/ontology/hc/geo/dutch-east-indies
              latitude: -6.2
              longitude: 106.8
              geometry_type: POLYGON
            description: Dutch East Indies territory
      is_or_was_categorized_as:
        description: |
          MIGRATED from colonial per slot_fixes.yaml (Rule 53, 2026-01-22).
          Colonial status categorization for this geographic coverage.
          Use ColonialStatus for structured colonial relationship data.
        range: ColonialStatus
        multivalued: true
        inlined: true
        inlined_as_list: true
        examples:
          - value:
              territory_name: "Dutch East Indies"
              colonizing_power: "Netherlands"
              modern_equivalent: ["ID"]
              temporal_extent:
                begin_of_the_begin: "1602-01-01"
                end_of_the_end: "1949-12-27"
            description: Dutch colonial Indonesia
      international:
        multivalued: true
      major_city:
        multivalued: true
      inbound_from:
        multivalued: true
      outbound_to:
        multivalued: true
    exact_mappings:
    - dcterms:spatial
    - schema:spatialCoverage
  SubGuideReference:
    class_uri: rico:FindingAid
    description: 'Reference to a sub-guide or related finding aid within the same repository.


      Sub-guides are more specific finding aids linked from a repository guide.

      For example, a "Family History" repository guide links to specific sub-guides

      for "Civil Registry", "Notarial Records", etc.

      '
    slots:
    - is_or_was_access_restricted
    - note
    - slug
    - specificity_annotation
    - has_or_had_description  # was: sub_guide_description - migrated per Rule 53
    - has_or_had_content  # was: sub_guide_temporal_coverage - migrated per Rule 53/56 (2026-01-17)
    - has_or_had_type
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    # REMOVED: title_en, title_nl - migrated to has_or_had_label with Label (2026-01-14, Rule 53)
    - has_or_had_label
    - has_or_had_url  # was: url - migrated per Rule 53 (2025-01-15)
    slot_usage:
      slug:
        required: true
      has_or_had_label:
        range: Label
        required: true
        multivalued: true
        inlined: true
        description: |
          Multilingual titles for this sub-guide.
          MIGRATED from title_nl/title_en slots (2026-01-14) per Rule 53.
          
          Uses Label class with language_code to support any language.
        examples:
        - value: |
            label_value: "Burgerlijke Stand"
            language_code: "nl"
          description: Dutch title
        - value: |
            label_value: "Civil Registry"
            language_code: "en"
          description: English title
      has_or_had_url:
        range: URL
        inlined: true
        required: true
        description: |
          URL of the sub-guide web resource.
          MIGRATED from url slot per slot_fixes.yaml (Rule 53, 2025-01-15).
      has_or_had_type:
        range: SubGuideType
        description: |
          The type classification of this sub-guide.
          Uses SubGuideType class hierarchy.
      is_or_was_access_restricted:
        range: boolean
      has_or_had_content:
        range: string
        description: |
          Time period covered by this sub-guide (free text).
          MIGRATED from sub_guide_temporal_coverage (2026-01-17) per Rule 53/56.
          
          Examples: "1811-1935", "before 1811", "1811-present"
        examples:
        - value: "1811-1935"
          description: Date range
        - value: "before 1811"
          description: Open-ended historical period
    exact_mappings:
    - rico:isOrWasPartOf
  ArchiveReference:
    class_uri: rico:RecordSet
    description: 'Reference to an archive collection or institution.


      Used for key_archives (main archives for a topic) and related_archives

      (external archives with related holdings).

      '
    slots:
    - has_or_had_access_condition
    - full_name
    - isil
    - location
    - name
    - resource_description
    - specificity_annotation
    - has_or_had_content  # was: sub_guide_temporal_coverage - migrated per Rule 53/56 (2026-01-17)
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    - has_or_had_url  # was: url - migrated per Rule 53 (2025-01-15)
    slot_usage:
      name:
        required: true
      has_or_had_url:
        range: URL
        inlined: true
        required: false
        description: |
          URL of the archive reference.
          MIGRATED from url slot per slot_fixes.yaml (Rule 53, 2025-01-15).
      isil:
        pattern: ^[A-Z]{2}-[A-Za-z0-9]+$
      has_or_had_content:
        range: string
        description: |
          Time period covered by this archive reference (free text).
          MIGRATED from sub_guide_temporal_coverage (2026-01-17) per Rule 53/56.
          
          Examples: "1811-1935", "before 1811", "1811-present"
    exact_mappings:
    - rico:RecordSet
    - schema:ArchiveOrganization
  RelatedGuideReference:
    class_uri: rico:FindingAid
    description: 'Reference to a related finding aid guide within the same repository.


      Different from sub_guides: these are peer-level guides on related topics,

      not hierarchically nested guides.

      '
    slots:
    - relationship
    - slug
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    # REMOVED: title_en, title_nl - migrated to has_or_had_label with Label (2026-01-14, Rule 53)
    - has_or_had_label
    slot_usage:
      slug:
        required: true
      has_or_had_label:
        range: Label
        required: true
        multivalued: true
        inlined: true
        description: |
          Multilingual titles for this related guide.
          MIGRATED from title_nl/title_en slots (2026-01-14) per Rule 53.
          
          Uses Label class with language_code to support any language.
      relationship:
        range: RelationshipTypeEnum
  AccessRestriction:
    class_uri: dcterms:RightsStatement
    description: 'Access restriction information for materials.

      '
    slots:
    - permission_required
    - restriction_description
    - restriction_type
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    - has_or_had_restriction
    slot_usage:
      restriction_type:
        required: true
      has_or_had_restriction:
        range: Restriction
        description: |
          Structured restriction with temporal extent.
          Replaces years_restricted (integer) with Restriction class.
      permission_required:
        range: boolean
  ExternalResource:
    class_uri: foaf:Document
    description: 'Reference to an external resource (database, organization, portal).


      Used to link finding aids to related external resources that complement

      the archive''s holdings (e.g., genealogical databases, historical societies).

      '
    slots:
    - name
    - resource_description
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    - has_or_had_type  # was: type - migrated per Rule 53 (2026-01-15)
    - has_or_had_url  # was: url - migrated per Rule 53 (2025-01-15)
    slot_usage:
      name:
        required: true
      has_or_had_url:
        range: URL
        inlined: true
        required: true
        description: |
          URL of the external resource.
          MIGRATED from url slot per slot_fixes.yaml (Rule 53, 2025-01-15).
      has_or_had_type:  # was: type - migrated per Rule 53 (2026-01-15)
        range: ExternalResourceTypeEnum
    exact_mappings:
    - foaf:Document
    - schema:WebPage
  FindingAidProvenance:
    class_uri: prov:Activity
    description: 'Provenance metadata for web-harvested finding aid information.


      Tracks when and how the metadata was retrieved, enabling data freshness

      assessment and re-crawling decisions.

      '
    slots:
    - has_or_had_quantity  # was: claims_count - migrated per Rule 53 (2026-01-19)
    - crawler_version
    - date_retrieved
    - extraction_method
    - extraction_note
    - html_snapshot_path
    - note
    - retrieval_agent
    - source_url
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    # REMOVED 2026-01-14: validation_status - migrated to has_or_had_status with ValidationStatus
    - has_or_had_status
    slot_usage:
      date_retrieved:
        range: date
        required: true
      retrieval_agent:
        required: true
      source_url:
        range: uri
      has_or_had_quantity:  # was: claims_count - migrated per Rule 53 (2026-01-19)
        range: Quantity
        inlined: true
        description: |
          Number of claims extracted during this retrieval.
          MIGRATED 2026-01-19: Replaces claims_count integer with structured Quantity.
          Use quantity_type: CLAIM_COUNT for claim counts.
        examples:
        - value:
            quantity_value: 47
            quantity_type: CLAIM_COUNT
            has_or_had_description: "Web claims extracted from finding aid page"
          description: Claim count with structured quantity
      has_or_had_status:
        range: ValidationStatus
        required: false
        inlined: true
        description: |
          Validation status of this finding aid retrieval.
          MIGRATED 2026-01-14: Replaces validation_status slot.
        examples:
        - value:
            status_type: VALIDATED
            status_date: "2026-01-14"
          description: Validated finding aid data
    exact_mappings:
    - prov:Activity
  PageSection:
    class_uri: schema:WebPageElement
    description: 'A section of a finding aid page with heading and content.


      Captures the hierarchical structure of web pages for preservation

      and semantic understanding.

      '
    slots:
    - content_block
    - has_or_had_featured_item
    - heading_level
    - heading_text
    - heading_text_en
    - list_item
    - section_id
    - has_or_had_section_link
    - specificity_annotation
    - has_or_had_sub_section
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    - has_or_had_provenance_path  # was: xpath - migrated per Rule 53 (2026-01-15)
    slot_usage:
      heading_level:
        range: integer
        minimum_value: 1
        maximum_value: 6
      heading_text:
        required: true
      content_block:
        multivalued: true
      has_or_had_sub_section:
        range: PageSection
        multivalued: true
        inlined_as_list: true
      has_or_had_section_link:
        range: PageLink
        multivalued: true
        inlined_as_list: true
      has_or_had_featured_item:
        range: FeaturedCard
        multivalued: true
        inlined_as_list: true
      list_item:
        multivalued: true
      has_or_had_provenance_path:
        range: XPath
        inlined: true
        description: |
          XPath provenance path documenting the exact location of the section in the source HTML.
          MIGRATED from xpath slot per slot_fixes.yaml (Rule 53, 2026-01-15).
    exact_mappings:
    - schema:WebPageElement
  PageLink:
    class_uri: schema:WebPage
    description: 'A hyperlink extracted from a page.

      '
    slots:
    - is_sub_guide
    - link_context
    - link_text
    - link_type
    - link_url
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    - has_or_had_provenance_path  # was: xpath - migrated per Rule 53 (2026-01-15)
    slot_usage:
      link_text:
        required: true
      link_url:
        range: uri
        required: true
      link_type:
        range: LinkTypeEnum
      is_sub_guide:
        range: boolean
      has_or_had_provenance_path:
        range: XPath
        inlined: true
        description: |
          XPath provenance path documenting the exact location of the link in the source HTML.
          MIGRATED from xpath slot per slot_fixes.yaml (Rule 53, 2026-01-15).
  FeaturedCard:
    class_uri: schema:CreativeWork
    description: 'A featured content card (often with image/icon).


      Common on archive websites to highlight important sub-guides or resources.

      '
    slots:
    # MIGRATED 2026-01-22: card_description, card_description_en → has_or_had_description + Description (multivalued with language tag)
    - has_or_had_description
    - card_image_url
    - card_title
    - card_title_en
    - card_url
    - specificity_annotation
    - has_or_had_score  # was: template_specificity - migrated per Rule 53 (2026-01-17)
    - has_or_had_provenance_path  # was: xpath - migrated per Rule 53 (2026-01-15)
    slot_usage:
      has_or_had_description:
        range: Description
        multivalued: true
        inlined: true
        description: |
          Card description(s) with language tagging.
          MIGRATED 2026-01-22: Replaces card_description and card_description_en.
          Use description_type: "card" and language: "nl"/"en" to distinguish.
        examples:
          - value:
              description_text: "Kaart beschrijving in het Nederlands"
              description_type: card
              language: nl
            description: Dutch card description
          - value:
              description_text: "Card description in English"
              description_type: card
              language: en
            description: English card description
      card_title:
        required: true
      card_url:
        range: uri
      card_image_url:
        range: uri
      has_or_had_provenance_path:
        range: XPath
        inlined: true
        description: |
          XPath provenance path documenting the exact location of the card in the source HTML.
          MIGRATED from xpath slot per slot_fixes.yaml (Rule 53, 2026-01-15).
types:
  TemporalValue:
    typeof: string
    uri: xsd:string
    description: 'A temporal value that can be either a year (integer) or special value like "present".

      Examples: 1572, 1811, "present", "ongoing"

      '