"""Schemas — Step 23 interview analytics."""

from typing import Any
from uuid import UUID

from pydantic import BaseModel, Field

from app.schemas.common import StubMeta


class InterviewAnalyticsSessionInput(BaseModel):
    interview_id: str | None = Field(
        default=None,
        description="Optional correlation label. Paste auto-generated id from POST /interviews/sessions/start when tying to a live session; omit for standalone Try-it-out.",
    )
    role_title: str | None = None
    status: str | None = None  # active | completed
    turn_count: int = 0
    planned_question_count: int = 0
    asked_question_count: int = 0
    scores: list[float] = Field(default_factory=list)
    question_stats: list[dict[str, Any]] = Field(
        default_factory=list,
        description="Optional [{question_id, score, kind, repeated}]",
    )
    evaluation_degraded_count: int = 0


class InterviewAnalyticsRequest(BaseModel):
    """POST /api/v1/interview-analytics/analyze"""

    correlation_id: UUID | None = None
    role_title: str | None = None
    include_persisted_sessions: bool = Field(
        default=True,
        description="Load checkpoints from interview session persist dir",
    )
    sessions: list[InterviewAnalyticsSessionInput] = Field(
        default_factory=list,
        description="Optional inline session metrics (merged with persisted)",
    )
    options: dict[str, Any] = Field(default_factory=dict)


class ScoreDistribution(BaseModel):
    count: int = 0
    mean: float | None = None
    min: float | None = None
    max: float | None = None
    p25: float | None = None
    p50: float | None = None
    p75: float | None = None
    histogram: dict[str, int] = Field(default_factory=dict)


class QuestionEffectiveness(BaseModel):
    question_id: str | None = None
    question_text: str | None = None
    times_asked: int = 0
    avg_score: float | None = None
    follow_up_rate: float | None = None
    effectiveness: str | None = None  # strong_separator | average | weak_signal


class InterviewAnalyticsResponse(StubMeta):
    correlation_id: UUID | None = None
    session_count: int = 0
    completion_rate: float | None = None
    avg_turns: float | None = None
    score_distribution: ScoreDistribution
    question_effectiveness: list[QuestionEffectiveness] = Field(default_factory=list)
    evaluation_quality: dict[str, Any] = Field(default_factory=dict)
    summary: str | None = None
