静止時のyaw値変動に対して平滑化を行うための計測基盤を実装

src/models.py

@@ -281,6 +281,13 @@ class HeadPoseResult:
     confidence: float | None
     failure_reason: str = ""
     landmarks: tuple[FaceLandmark, ...] = field(default_factory=tuple, repr=False)
+    # Diagnostics for yaw-jitter analysis: pre-smoothing angles, PnP reprojection
+    # error [px], and outer-eye-corner distance [px] as a face-size indicator.
+    raw_pitch: float | None = None
+    raw_yaw: float | None = None
+    raw_roll: float | None = None
+    reprojection_error: float | None = None
+    interocular_px: float | None = None
 
     def __post_init__(self) -> None:
         if self.track_id < 0 or self.frame_number < 0 or self.landmarks_count < 0: