"""Step 24 — Prompt version registry for AI evaluation monitoring."""

from __future__ import annotations

from dataclasses import dataclass
from datetime import datetime, timezone


@dataclass(frozen=True)
class PromptVersion:
    name: str
    version: str
    purpose: str
    template: str
    updated_at: str
    changelog: str = ""


def _now() -> str:
    return datetime.now(timezone.utc).isoformat()


PROMPT_REGISTRY: dict[str, PromptVersion] = {
    "evaluate_answer": PromptVersion(
        name="evaluate_answer",
        version="v3.0.0",
        purpose="Independent evidence-only rubric scoring for one answer",
        template=(
            "Evaluate using only question, answer, JD, required skills, and rubric. "
            "Return score 0-1, score_band strong|good|fair|needs_improvement, "
            "1-3 strengths/weaknesses, 1-2 improvements, one-sentence explanation, "
            "skill_tags evidenced in Q+A. Never invent facts or accept precomputed feedback."
        ),
        updated_at="2026-10-28T00:00:00+00:00",
        changelog="Recruiter bands + skill_tags + evidence-only feedback limits",
    ),
    "behavioral_analysis": PromptVersion(
        name="behavioral_analysis",
        version="v1.1.0",
        purpose="Structure, examples, ownership, competencies",
        template=(
            "Assess STAR-like structure, concrete examples, ownership language, "
            "and behavioral competencies from candidate answers only."
        ),
        updated_at="2026-10-09T00:00:00+00:00",
        changelog="Expanded beyond tone/confidence cues",
    ),
    "communication_analysis": PromptVersion(
        name="communication_analysis",
        version="v1.0.0",
        purpose="Text clarity/relevance/organization/conciseness",
        template=(
            "Analyze TEXT only. Score clarity, relevance, organization, "
            "conciseness. Do not score audio delivery."
        ),
        updated_at="2026-10-09T00:00:00+00:00",
        changelog="Initial text-only communication analysis",
    ),
    "semantic_skill_match": PromptVersion(
        name="semantic_skill_match",
        version="v1.0.0",
        purpose="Embedding similarity JD/skills vs answers",
        template="Embed JD, skills, answers; report cosine similarities.",
        updated_at="2026-10-09T00:00:00+00:00",
        changelog="OpenAI embeddings with local hash fallback",
    ),
}


def list_prompt_versions() -> list[dict]:
    return [
        {
            "name": p.name,
            "version": p.version,
            "purpose": p.purpose,
            "template": p.template,
            "updated_at": p.updated_at,
            "changelog": p.changelog,
        }
        for p in PROMPT_REGISTRY.values()
    ]


def get_prompt_version(name: str) -> PromptVersion | None:
    return PROMPT_REGISTRY.get(name)
