from __future__ import annotations

from datetime import datetime
from typing import Literal

from pydantic import BaseModel


ReviewStatus = Literal["pending", "confirmed", "rejected", "deferred"]
KnowledgeDecision = Literal["pending", "ingest", "skip"]


class CandidateReviewStatus(BaseModel):
    candidate_id: str
    review_status: ReviewStatus = "pending"
    reviewed_at: datetime | None = None
    review_note: str | None = None
    knowledge_decision: KnowledgeDecision = "pending"
    knowledge_note: str | None = None