All files / web/src/lib/curriculum session-mode-comfort.ts

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
/**
 * Session Mode Comfort Level
 *
 * Computes the comfort level for a student alongside their session mode.
 * This is used by the session-mode API to return comfort data without
 * requiring a separate API call.
 */

import { computeBktFromHistory, DEFAULT_BKT_OPTIONS } from '@/lib/curriculum/bkt'
import { BKT_THRESHOLDS } from '@/lib/curriculum/config/bkt-integration'
import { computeComfortLevel, computeComfortLevelByMode } from './comfort-level'
import { getPracticingSkills } from './progress-manager'
import { getRecentSessionResults } from './session-planner'
import type { SessionMode } from './session-mode'

export interface SessionModeComfortResult {
  overall: number
  byMode: Record<string, number>
}

/**
 * Compute the comfort level for a student given their session mode.
 *
 * Loads BKT data and practicing skills, then delegates to computeComfortLevel().
 * This mirrors the same data loading done by getSessionMode() and generateSessionPlan().
 *
 * Returns both overall comfort and per-mode comfort levels.
 */
export async function getSessionModeComfortLevel(
  playerId: string,
  sessionMode: SessionMode
): Promise<SessionModeComfortResult> {
  const [history, practicing] = await Promise.all([
    getRecentSessionResults(playerId, 100),
    getPracticingSkills(playerId),
  ])

  const bktResults = computeBktFromHistory(history, {
    ...DEFAULT_BKT_OPTIONS,
    confidenceThreshold: BKT_THRESHOLDS.confidence,
  })

  const bktMap = new Map(bktResults.skills.map((s) => [s.skillId, s]))
  const practicingIds = practicing.map((s) => s.skillId)

  const overallResult = computeComfortLevel(bktMap, practicingIds, sessionMode)
  const byModeResults = computeComfortLevelByMode(bktResults.byMode, practicingIds, sessionMode)

  return {
    overall: overallResult.comfortLevel,
    byMode: Object.fromEntries(
      Object.entries(byModeResults).map(([mode, result]) => [mode, result.comfortLevel])
    ),
  }
}