# GenerationEvent - Event representing the generation/creation of something
#
# Created per slot_fixes.yaml migration for: chapters_generated_at
# Revision specifies: GenerationEvent with has_or_had_provenance + temporal_extent
# Updated 2026-01-19: Added has_or_had_score for confidence tracking (confidence_* migration)
# Creation date: 2026-01-19

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_or_had_provenance
  - ./Provenance
  - ../slots/temporal_extent
  - ./TimeSpan
  - ../slots/has_or_had_description
  - ../slots/has_or_had_score
  - ./ConfidenceScore

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_or_had_provenance: Who/what performed the generation (Provenance)
      - has_or_had_description: Details about the generation process
      - has_or_had_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_or_had_provenance
      - has_or_had_description
      - has_or_had_score
    
    slot_usage:
      temporal_extent:
        description: When the generation event occurred
        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"
            description: Point-in-time generation event
      
      has_or_had_provenance:
        description: Provenance information about who/what generated the entity
        range: Provenance
        required: false
        inlined: true
        examples:
          - value:
              has_or_had_agent:
                has_or_had_type: SOFTWARE
                has_or_had_name: "YouTube Auto-Chapters"
            description: AI-generated chapters
      
      has_or_had_description:
        description: Additional details about the generation process
        range: string
        required: false
        examples:
          - value: "Generated using Whisper transcript segmentation"
            description: Description of generation method
      
      has_or_had_score:
        description: >-
          Confidence score for the generation output. Uses ConfidenceScore class
          to capture structured confidence with method and explanation.
        range: ConfidenceScore
        required: false
        inlined: true
        examples:
          - value:
              has_or_had_score: 0.95
              has_or_had_method: "xpath_extraction"
              has_or_had_description: "High confidence - exact match at expected location"
            description: Confidence score for generated content
    
    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_or_had_description: "AI-generated video chapters from transcript"
          has_or_had_score:
            has_or_had_score: 0.92
            has_or_had_method: "transcript_segmentation"
        description: Video chapter generation event with confidence
    
    comments:
      - Created from slot_fixes.yaml migration (2026-01-19)
      - Updated 2026-01-19 to include has_or_had_score for confidence tracking