Personal Agent Circadian Chronotype MCTQ Phase Skill

Zero-dependency Munich ChronoType Questionnaire (MCTQ) mid-sleep phase modeler, social jetlag quantifier, and circadian biological phase window projector.

Architecture

flowchart TD
    SleepSchedule[Workday & Free Day Sleep/Wake Timestamps] --> MCTQEngine[MCTQ Chronobiology Engine]
    MCTQEngine --> MSFscCalc[Sleep Debt Corrected Mid-Sleep: MSFsc]
    MCTQEngine --> SJLCalc[Social Jetlag Differential: |MSF - MSW|]
    MSFscCalc --> ChronoClass[Chronotype Phenotype: Extreme Lark to Night Owl]
    SJLCalc --> HealthRisk[Cardiometabolic Risk & Entrainment Guidance]
    TargetWake[Target Wake Time] --> PhaseProjector[Circadian Window Projector]
    PhaseProjector --> Milestones[CAR Peak, Deep Focus, Caffeine Cutoff, DLMO, Sleep Gate]

Quickstart

from client import PersonalAgentCircadianChronotypeMctqPhase

agent = PersonalAgentCircadianChronotypeMctqPhase()
res = agent.calculate_mctq_chronotype_and_social_jetlag(
    sleep_onset_work_24h=23.5, sleep_wake_work_24h=7.0,
    sleep_onset_free_24h=1.5, sleep_wake_free_24h=10.0
)
print(f"Chronotype: {res['chronotype_tier']} | Social Jetlag: {res['social_jetlag_hours']} hrs")