id: https://nde.nl/ontology/hc/class/GenerationEvent
name: generation_event_class
title: Generation Event Class

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

imports:
  - linkml:types
  - ../slots/has_description
  - ../slots/has_provenance
  - ../slots/has_score
  - ../slots/temporal_extent
default_prefix: hc

classes:
  GenerationEvent:
    description: >-
      An event representing the generation or creation of an entity.
      
      **USAGE**:
      Used for tracking when and how something was generated, including:
      - Video chapter generation (manual, AI, imported)
      - Content extraction events
      - Automated processing activities
      - Confidence scoring for generated content
      
      **STRUCTURE**:
      - temporal_extent: When the generation occurred (TimeSpan)
      - has_provenance: Who/what performed the generation (Provenance)
      - has_description: Details about the generation process
      - has_score: Confidence score for the generated content (ConfidenceScore)
      
      **ONTOLOGY ALIGNMENT**:
      - Maps to prov:Generation (PROV-O generation event)
      - Also maps to schema:CreateAction (Schema.org action)
      
    class_uri: prov:Generation
    
    exact_mappings:
      - prov:Generation
    
    close_mappings:
      - schema:CreateAction
    
    slots:
      - temporal_extent
      - has_provenance
      - has_description
      - has_score
    
    slot_usage:
      temporal_extent:
        range: TimeSpan
        required: false
        inlined: true
        examples:
          - value:
              begin_of_the_begin: "2024-01-15T10:30:00Z"
              end_of_the_end: "2024-01-15T10:30:00Z"
      has_provenance:
        range: Provenance
        required: false
        inlined: true
        examples:
          - value:
              has_agent:
                has_type: SOFTWARE
                has_name: "YouTube Auto-Chapters"
      has_description:
#         range: string
        required: false
        examples:
          - value: "Generated using Whisper transcript segmentation"
      has_score:
        range: ConfidenceScore
        required: false
        inlined: true
        examples:
          - value:
              has_score: 0.95
              has_method: "xpath_extraction"
              has_description: "High confidence - exact match at expected location"
    annotations:
      custodian_types: '["*"]'
      custodian_types_rationale: >-
        Generation events are universal for tracking content creation.
      custodian_types_primary: "*"
      specificity_score: 0.30
      specificity_rationale: >-
        Moderately low specificity - used across many content types.
    
    examples:
      - value:
          temporal_extent:
            begin_of_the_begin: "2024-01-15T10:30:00Z"
          has_description: "AI-generated video chapters from transcript"
          has_score:
            has_score: 0.92
            has_method: "transcript_segmentation"
    comments:
      - Created from slot_fixes.yaml migration (2026-01-19)
      - Updated 2026-01-19 to include has_score for confidence tracking