app/core/constants.py

"""Application-wide constants.

These values define the authoritative label sets and mappings used across
inference services, schemas, and validation. They must match the data contract
exactly and should never be redefined elsewhere in the codebase.
"""

MASTERY_LABEL_MAP: dict[int, str] = {
    0: "weak",
    1: "developing",
    2: "proficient",
    3: "mastered",
}

BLOOM_LEVELS: list[str] = [
    "Remember",
    "Understand",
    "Apply",
    "Analyze",
    "Evaluate",
    "Create",
]

RISK_LABELS: list[str] = ["low", "medium", "high", "critical"]

FEEDBACK_TYPES: list[str] = ["accept", "edit", "reject"]

VALID_SUBJECTS: list[str] = ["Mathematics", "Science", "Social Science"]

VALID_GRADES: list[int] = [6, 7, 8]