# Boss YAML Schema v1
# Authoring target for Codex-readable encounter data.

boss:
  metadata:
    boss_id: "example_boss_id"
    boss_name: "Example Boss"
    stage: 1
    expected_duration_sec: 600
    entity_type: "single"  # single | boss_plus_adds | multi_boss | swarm

  signature:
    name: "Example Signature"
    concept: >
      One-sentence summary of the signature encounter concept.
    player_problem: >
      What players must solve.
    expected_solution:
      tank: []
      support: []
      dps: []
    failure_result:
      type: "major_damage"  # major_damage | wipe | mechanic_repeat | positioning_loss | other
      description: "What happens on failure."

  roles:
    tank:
      pressure_sources: []
      failure_results: []
      required_pressure: 1.0
    support:
      pressure_sources: []
      failure_results: []
      required_pressure: 1.0
    dps:
      pressure_sources: []
      failure_results: []
      required_pressure: 1.0

  phases:
    - phase_id: 1
      name: "Learn"
      duration_estimate_sec: 120
      new_mechanics: []
      role_pressure_multiplier:
        tank: 1.0
        support: 1.0
        dps: 1.0

  pressure:
    sustained:
      sources: []
    burst:
      mechanics: []
    dodge_types_required: []

  revive:
    trigger_response:
      enabled: true
      reactions: []
    revive_risk_level: "medium"  # low | medium | high

  escalation:
    enabled: true
    escalation_interval_sec: 60
    escalation_types: []

  entities:
    total_entities: 1
    composition:
      main_boss: 1
    add_behavior:
      role: "none"
      respawn: false

  difficulty:
    expected_attempts: 3
    primary_failure_causes: []
    secondary_failure_causes: []
    design_intent: >
      Short note on what the fight is trying to test.