# WebArchiveFailure - Failed archive attempt record
# Extracted from custodian_source.yaml per Rule 38 (modular schema files)
# Extraction date: 2026-01-08

id: https://nde.nl/ontology/hc/classes/WebArchiveFailure
name: WebArchiveFailure
title: WebArchiveFailure

prefixes:
  linkml: https://w3id.org/linkml/
  hc: https://nde.nl/ontology/hc/
  schema: http://schema.org/
  prov: http://www.w3.org/ns/prov#
  xsd: http://www.w3.org/2001/XMLSchema#

imports:
  - linkml:types


default_range: string

classes:
  WebArchiveFailure:
      description: >-
        Record of a failed web archive attempt, documenting the URL that could
        not be archived, the failure reason, archivability status, and retry
        history. Essential for audit trails and troubleshooting extraction
        pipelines.
        
        Ontology mapping rationale:
        - class_uri is prov:Entity because this is a data record documenting
          a failed activity - the failure itself is an entity with provenance
        - close_mappings includes prov:InvalidatedEntity as the archive attempt
          was invalidated/failed
        - related_mappings includes schema:Action as the underlying archiving
          action that failed
      class_uri: prov:Entity
      close_mappings:
        - prov:InvalidatedEntity
      related_mappings:
        - schema:Action
      attributes:
        url:
          range: uri
          description: URL that failed to archive
        failure_reason:
          range: string
          description: Reason for failure
        archivable:
          range: boolean
          description: Whether URL is archivable
        attempt_timestamp:
          range: datetime
          description: When archive attempt was made
        last_retry:
          range: datetime
          description: When last retry was attempted
        retry_result:
          range: string
          description: Result of retry attempt