Struct TutorSession 

pub struct TutorSession {

    pub lesson: u32,
    pub total_lessons: u32,
    pub exercises: Vec<TutorExercise>,
    pub current: usize,
    pub attempt_count: usize,
    pub anchor_lines: Vec<usize>,
    pub initial_texts: Vec<String>,
    pub last_version: u64,
    pub lives: u8,
    pub score: u32,
    pub exercise_started_at: Option<Instant>,
    pub state: TutorGameState,
    pub high_score: u32,
}

Per-tutor-buffer state. Stored as a BufferLocal by TutorMode.

Fields

lesson: u32

total_lessons: u32

Total lesson count in this build (5 at launch).

exercises: Vec<TutorExercise>

current: usize

Index of the current exercise.

attempt_count: usize

Failed-attempt count since the last advance/retreat. Used to gate hint display (shows after ≥ 2).

anchor_lines: Vec<usize>

Resolved line index in the buffer for each exercise’s anchor. Parallel to exercises.

initial_texts: Vec<String>

Text snapshot of each anchor line as of session load. Parallel to exercises.

last_version: u64

Last buffer version seen by the post-dispatch watcher.

lives: u8

Lives remaining for the current exercise.

score: u32

Cumulative score across all passed exercises this session.

exercise_started_at: Option<Instant>

Wall-clock start time for the current exercise; used for speed bonuses.

state: TutorGameState

High-level game state.

high_score: u32

All-time high score for this lesson loaded from disk at session start. Shown in the HUD as HI:.

Implementations

impl TutorSession

pub fn load( lesson: u32, total_lessons: u32, lesson_text: &str, exercises_toml: &str, ) -> Result<Self, String>

Build a TutorSession by parsing the exercise sidecar and scanning the lesson text for each anchor.

Returns Err (human-readable) if:

• the sidecar TOML is malformed, or
• any anchor text is not found in lesson_text.

pub fn is_complete(&self) -> bool

true when all exercises in this lesson have been advanced past.

pub fn current_exercise(&self) -> Option<&TutorExercise>

The current exercise, or None if the lesson is complete.

pub fn check(&mut self, lines: &[&str]) -> bool

Auto-detect pass/fail against live buffer lines. Awards score on pass (base + first-try bonus + speed bonus). Increments attempt_count on failure. Does NOT drain lives — that only happens on explicit <CR> presses via drain_life.

Returns false when the session is not Active or the lesson is already complete.

pub fn is_condition_met(&self, lines: &[&str]) -> bool

Peek: is the success condition currently met? Pure read — no side effects. Used by do_tutor_advance to decide whether an explicit <CR> press is a valid advance or a penalised miss.

pub fn drain_life(&mut self)

Drain one life on an explicit wrong attempt (<CR> press when the condition is not met). Increments attempt_count and transitions to GameOver when lives reach zero.

pub fn advance(&mut self) -> Option<&TutorExercise>

Advance to the next exercise; resets lives, attempt_count, and restarts the exercise timer. Returns the new current exercise, or None if the lesson is now complete.

pub fn retreat(&mut self)

Return to the previous exercise; resets lives, attempt_count, and clears any GameOver state.

Trait Implementations

impl BufferLocal for TutorSession

const NAME: &'static str = "tutor-mode.session"

Public display name (:describe-buffer row label, debug logs). Convention: <owner-mode-name>.<key>, e.g. "file-tree.entries". Not a registry key — locals aren’t registered globally; the name is metadata for inspection.

const DOC: &'static str = "Active tutor session: current lesson, exercise index, \ anchor line positions, attempt count."

Doc string. Shown in :describe-buffer when the user expands a local for detail.

const OWNER_MODE: &'static str = "tutor-mode"

Mode id that owns this local. Attribution metadata for :describe-buffer; the write-time check the design calls for (a ModeContext::set_local::<T> that rejects a non-owner) is not implemented, so nothing enforces it today (see the module docs).

fn describe(&self) -> String

Single-line summary of the local’s value for :describe-buffer’s tabular display. Implementations should be cheap (no heavy formatting); detailed inspection is via the mode’s own commands.

impl Clone for TutorSession

fn clone(&self) -> TutorSession

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TutorSession

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.