Phase Promotion

Phase promotion

Spiritual phase advances when a mentee completes their assigned track and passes a phase promotion checkup study (mentorship_plan_kind = checkup, checkup_context = phase_promotion).

Flow

intro study (optional) → track studies → checkup study → promote_phase step

Typical checkup template steps (Milk → Transition seed: mentorship-checkup-milk-promotion):

Step	Mode	Actor
Knowledge check	answer_quiz	Mentee
Outcome attestation	attest_outcomes	Mentor
Promotion conversation	meet	Pair
Confirm promotion	promote_phase	Mentor

Promotion gates

PhasePromotionService runs on promote_phase step completion:

1. Mentee is in the configured fromPhase.
2. Track is complete (all required modules satisfied, no open track study).
3. Required phase outcomes (from_phase / to_phase on learning_outcomes) have met evaluations on the mentee’s studies.
4. On success: users.spiritual_phase → toPhase, users.phase_source → mentor.

Mentor UX

When track progress shows complete and no open checkup study exists, Mentorship.checkupStudyPromotion surfaces the phase checkup template. Mentor assigns via assignMentorshipCheckupStudy.

Periodic checkups (checkup_context = periodic) use the same plan kind but are not wired in v1 UI.

See Learning outcomes and Mentorship.