Plateau Detection

plateau_signals = {
    "velocity_declining": True,
    "velocity_days": 10,
    "mastery_stagnant": True,
    "mastery_attempts": 15,
    "efficiency_dropping": True,
    "efficiency_trend": -0.15,
    "plateau_confidence": "high"
}

from cognition_engine import CognitionEngine

engine = CognitionEngine(supabase_url, supabase_key)

# Track an answer
result = await engine.track_answer(
    user_id="student_123",
    skill_id="algebra",
    is_correct=True,
    time_spent_seconds=60
)

if result['plateau_detected']:
    print("⚠️ Plateau detected!")
    print(f"Confidence: {result['plateau_confidence']}")
    print(f"Recommendation: {result['recommendation']}")

intervention = {
    "type": "difficulty_adjustment",
    "current_difficulty": "medium",
    "recommended_difficulty": "easy",
    "reasoning": "Return to fundamentals to rebuild confidence"
}

intervention = {
    "type": "topic_switch",
    "current_skill": "trigonometry",
    "recommended_skill": "algebra",
    "reasoning": "Switch to a different area to maintain engagement"
}

intervention = {
    "type": "frequency_change",
    "current_sessions": 3,
    "recommended_sessions": 5,
    "reasoning": "Increase practice to break through plateau"
}

intervention = {
    "type": "learning_mode",
    "current_mode": "practice",
    "recommended_mode": "review",
    "reasoning": "Emphasize review and reinforcement over new problems"
}

plateau_status = await engine.check_plateau_status("student_123", "algebra")

if plateau_status['is_plateauing']:
    print(f"Plateau since: {plateau_status['started_date']}")
    print(f"Current severity: {plateau_status['severity']}")
    print(f"Interventions: {plateau_status['recommendations']}")

# Week 1-2: Strong progress
{
    "velocity": 0.035,
    "efficiency": 0.82,
    "mastery": 0.65
}

# Week 3: Early warning
{
    "velocity": 0.022,      # Declining
    "efficiency": 0.75,     # Dropping
    "mastery": 0.68         # Slow growth
}

# Week 4: Plateau confirmed
{
    "velocity": 0.01,       # Minimal progress
    "efficiency": 0.68,     # Below threshold
    "mastery": 0.68,        # Stagnant
    "plateau_detected": True
}

# Intervention: Switch topics
# Result: Recovery and continued progress
{
    "velocity": 0.030,
    "efficiency": 0.80,
    "mastery": 0.72
}

async def get_student_plateau_report(user_id):
    skills = await get_all_skills(user_id)
    
    plateau_report = []
    for skill in skills:
        status = await engine.check_plateau_status(user_id, skill.id)
        if status['is_plateauing']:
            plateau_report.append({
                "skill": skill.name,
                "severity": status['severity'],
                "recommendation": status['recommendations'][0]
            })
    
    return plateau_report

recovery_metrics = {
    "pre_intervention_velocity": 0.01,
    "post_intervention_velocity": 0.025,
    "recovery_days": 3,
    "effectiveness": "good"
}