thresholds.yaml

# LectureLens — Alert Thresholds
# Edit these values without touching any code.
# Severity logic:
#   critical  → value is far outside the acceptable range (ratio > 2x tolerance)
#   warning   → value is outside the acceptable range
#   info      → value is within range but worth noting

audio:
  integrated_loudness_lufs:
    target: -14          # ideal LUFS (ITU-R BS.1770-4 streaming standard)
    tolerance: 2         # ±2 LU band around target is acceptable
  true_peak_dbtp:
    max: -1.0            # must not exceed -1.0 dBTP
  snr_db:
    min: 20              # signal-to-noise ratio floor
  loudness_range_lu:
    min: 4               # too flat below 4 LU (dynamic compression artefact)
    max: 15              # too dynamic above 15 LU (inconsistent mic)
  silence_max_duration_sec: 3    # segments longer than this trigger a warning
  dnsmos_ovrl:
    min: 3.0             # overall speech quality score (1–5 scale)
  clipped_samples_count:
    max: 0               # any clipping is unacceptable

video:
  brightness:
    min: 80              # too dark below 80 (0–255 scale)
    max: 180             # overexposed above 180
  sharpness_laplacian:
    min: 100             # Laplacian variance — below 100 = blurry / out-of-focus
  dropped_frames_ratio:
    max: 0.01            # more than 1% dropped frames = encoding problem
  freeze_max_duration_sec: 2     # frozen video segments longer than 2s
  black_max_duration_sec: 0.5    # black frames for any meaningful duration
  compression_artifact_score:
    max: 0.3             # normalised 0–1 heuristic score