@vue-skuilder/db 0.3.1 → 0.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{contentSource-2zVmcjKA.d.ts → contentSource-CSI0pJ2D.d.ts} +10 -0
- package/dist/core/index.cjs +62 -14
- package/dist/core/index.cjs.map +1 -1
- package/dist/core/index.d.ts +3 -3
- package/dist/core/interfaces/contentSource.mjs.map +1 -1
- package/dist/core/navigators/Pipeline.mjs +7 -1
- package/dist/core/navigators/Pipeline.mjs.map +1 -1
- package/dist/core/navigators/filters/eloDistance.mjs +17 -2
- package/dist/core/navigators/filters/eloDistance.mjs.map +1 -1
- package/dist/core/navigators/generators/prescribed.mjs +20 -10
- package/dist/core/navigators/generators/prescribed.mjs.map +1 -1
- package/dist/core/navigators/index.mjs +2 -0
- package/dist/core/navigators/index.mjs.map +1 -1
- package/dist/core/versionStamps.mjs +1 -1
- package/dist/{dataLayerProvider-rGyLQ93v.d.ts → dataLayerProvider-D5n1gGc_.d.ts} +1 -1
- package/dist/diagnostics/derive.mjs.map +1 -1
- package/dist/diagnostics/index.cjs +16 -3
- package/dist/diagnostics/index.cjs.map +1 -1
- package/dist/diagnostics/index.d.ts +29 -6
- package/dist/diagnostics/tagElo.mjs +20 -4
- package/dist/diagnostics/tagElo.mjs.map +1 -1
- package/dist/impl/couch/courseDB.mjs +5 -0
- package/dist/impl/couch/courseDB.mjs.map +1 -1
- package/dist/impl/couch/index.cjs +37 -2
- package/dist/impl/couch/index.cjs.map +1 -1
- package/dist/impl/couch/index.d.ts +4 -2
- package/dist/impl/static/courseDB.mjs +5 -0
- package/dist/impl/static/courseDB.mjs.map +1 -1
- package/dist/impl/static/index.cjs +37 -2
- package/dist/impl/static/index.cjs.map +1 -1
- package/dist/impl/static/index.d.ts +4 -2
- package/dist/index.cjs +80 -16
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +3 -3
- package/dist/study/SessionController.mjs +1 -0
- package/dist/study/SessionController.mjs.map +1 -1
- package/dist/study/services/tagRecent.mjs +2 -1
- package/dist/study/services/tagRecent.mjs.map +1 -1
- package/package.json +3 -3
- package/src/core/interfaces/contentSource.ts +7 -0
- package/src/core/navigators/Pipeline.ts +7 -0
- package/src/core/navigators/filters/eloDistance.ts +31 -2
- package/src/core/navigators/generators/prescribed.ts +55 -11
- package/src/core/navigators/generators/types.ts +3 -0
- package/src/core/navigators/index.ts +5 -0
- package/src/diagnostics/derive.ts +6 -1
- package/src/diagnostics/tagElo.ts +43 -3
- package/src/impl/couch/courseDB.ts +13 -0
- package/src/impl/static/courseDB.ts +13 -0
- package/src/study/SessionController.ts +3 -0
- package/src/study/services/tagRecent.test.ts +57 -3
- package/src/study/services/tagRecent.ts +8 -1
- package/tests/core/navigators/eloDistanceFilter.test.ts +15 -0
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"derive.mjs","names":[],"sources":["../../src/diagnostics/derive.ts"],"sourcesContent":["/**\n * Derivations over a `LearnerDataset`: pure functions that views, text\n * exports, and (later) detectors share. Ported from LettersPractice's admin\n * service, with LP's domain knowledge moved behind `DiagnosticsInterpreters`.\n *\n * \"Now\" is always `dataset.asOf`, never the wall clock, so a dump reads the\n * same tomorrow as today.\n */\nimport type {\n SessionEloEvent,\n SessionStateSnapshot,\n StudySessionDoc,\n StudySessionRunSummary,\n} from '../core/types/studySession';\nimport type { CardSummary, DatasetRecord, LearnerDataset } from './dataset';\nimport type { TagBatch } from './tagElo';\n\n/**\n * Course-supplied meaning for the generic views. Every member is optional and\n * has a neutral default.\n */\nexport interface DiagnosticsInterpreters {\n /** Tags that name what a card exercises: shown inline and sorted first. Default: none. */\n isSkillTag?(tag: string): boolean;\n /** Compact display form of a tag. Default: unchanged. */\n shortTag?(tag: string): string;\n /**\n * Numbers to read off a session's state snapshot, by display label.\n * Default: every numeric field up to two levels deep, labelled by its path.\n */\n snapshotMetrics?(snapshot: SessionStateSnapshot): Record<string, number>;\n /** Which `snapshotMetrics` labels count as progress (for `stalled`). Default: none. */\n progressMetrics?: string[];\n /**\n * Named tag batches for the ELO view, offered beside the namespace × role\n * batches it finds on its own. Default: none.\n */\n tagBatches?: TagBatch[];\n}\n\nexport const isSkillTag = (i: DiagnosticsInterpreters | undefined, tag: string): boolean =>\n i?.isSkillTag?.(tag) ?? false;\n\nexport const shortTag = (i: DiagnosticsInterpreters | undefined, tag: string): string =>\n i?.shortTag?.(tag) ?? tag;\n\n/** Skill tags first, then alphabetical. */\nfunction bySkillThenName(i: DiagnosticsInterpreters | undefined) {\n return (a: string, b: string): number => {\n const d = Number(isSkillTag(i, b)) - Number(isSkillTag(i, a));\n return d !== 0 ? d : a.localeCompare(b);\n };\n}\n\nfunction defaultSnapshotMetrics(snapshot: SessionStateSnapshot): Record<string, number> {\n const out: Record<string, number> = {};\n for (const [k, v] of Object.entries(snapshot)) {\n if (typeof v === 'number') out[k] = v;\n else if (v && typeof v === 'object' && !Array.isArray(v)) {\n for (const [k2, v2] of Object.entries(v as Record<string, unknown>)) {\n if (typeof v2 === 'number') out[`${k}.${k2}`] = v2;\n }\n }\n }\n return out;\n}\n\n// ============================================================================\n// Sessions\n// ============================================================================\n\n/**\n * Ways a session failed to do its job. `out-of-content` is LP's `starved`,\n * renamed so it isn't confused with intake starvation (no new cards chosen).\n */\nexport type SessionFlag = 'churned' | 'out-of-content' | 'walked' | 'stalled' | 'grinding';\n\nexport const SESSION_FLAGS: Record<SessionFlag, { label: string; help: string }> = {\n churned: {\n label: 'Churned',\n help: 'Many pipeline runs relative to cards served: the plan kept being rebuilt rather than consumed.',\n },\n 'out-of-content': {\n label: 'Out of content',\n help: 'Ended with time left on the clock: content ran out before the session did.',\n },\n walked: {\n label: 'Walked',\n help: 'Abandoned or never closed, after real time invested. Not a mis-click.',\n },\n stalled: {\n label: 'Stalled',\n help: 'No progress metric moved and ELO was essentially flat. The sitting produced nothing measurable.',\n },\n grinding: {\n label: 'Grinding',\n help: 'Majority-incorrect, or ended with unfinished cards still in the failed queue.',\n },\n};\n\n/** First guesses, not measurements: nothing yet records whether a flag was right. */\nexport const SESSION_FLAG_THRESHOLDS = {\n /** Runs per card above which a session counts as churned. */\n churnRunsPerCard: 1 / 3,\n /** Minimum cards before churn is meaningful. */\n churnMinCards: 4,\n /** Leftover clock (s) that counts as running out of content. */\n outOfContentSeconds: 20,\n /** Cards below which an abandon reads as a mis-click, not a walk-out. */\n walkMinCards: 2,\n /** |ELO change| below which movement is flat. */\n stallEloEpsilon: 5,\n /** Accuracy below which a session is grinding. */\n grindAccuracy: 0.5,\n};\n\nexport interface SessionStateRow {\n label: string;\n from: number | null;\n to: number | null;\n delta: number | null;\n}\n\nexport interface SessionSummary {\n doc: StudySessionDoc;\n /** Null while a session is `open`. */\n durationSeconds: number | null;\n accuracy: number | null;\n /** Net learner global-ELO change over the session's ELO events. Null when it has none. */\n eloNet: number | null;\n /** Snapshot metrics at start and end. */\n state: SessionStateRow[];\n flags: SessionFlag[];\n}\n\nfunction stateRows(doc: StudySessionDoc, interp?: DiagnosticsInterpreters): SessionStateRow[] {\n const read = interp?.snapshotMetrics ?? defaultSnapshotMetrics;\n const a = doc.stateAtStart ? read(doc.stateAtStart) : {};\n const b = doc.stateAtEnd ? read(doc.stateAtEnd) : {};\n const labels = [...new Set([...Object.keys(a), ...Object.keys(b)])];\n return labels.map((label) => {\n const from = a[label] ?? null;\n const to = b[label] ?? null;\n return { label, from, to, delta: from !== null && to !== null ? to - from : null };\n });\n}\n\nfunction flagSession(\n s: Omit<SessionSummary, 'flags'>,\n interp?: DiagnosticsInterpreters\n): SessionFlag[] {\n const T = SESSION_FLAG_THRESHOLDS;\n const { doc, accuracy, eloNet } = s;\n const flags: SessionFlag[] = [];\n const cards = doc.tally?.cardsPresented ?? 0;\n const runs = doc.runs?.length ?? 0;\n\n if (cards >= T.churnMinCards && runs / cards > T.churnRunsPerCard) flags.push('churned');\n\n // Only a closed session can run out of content; an abandoned one has time left by definition.\n if (doc.status === 'closed' && (doc.tally?.secondsRemaining ?? 0) > T.outOfContentSeconds) {\n flags.push('out-of-content');\n }\n\n if (doc.status === 'open') flags.push('walked');\n else if (doc.status === 'abandoned' && cards >= T.walkMinCards) flags.push('walked');\n\n // Needs something measurable, else every session without snapshots or ELO events would flag.\n const progress = s.state.filter((r) => interp?.progressMetrics?.includes(r.label));\n const measurable = eloNet !== null || progress.some((r) => r.delta !== null);\n if (\n cards > 0 &&\n measurable &&\n progress.every((r) => (r.delta ?? 0) === 0) &&\n Math.abs(eloNet ?? 0) < T.stallEloEpsilon\n ) {\n flags.push('stalled');\n }\n\n if (\n (accuracy !== null && accuracy < T.grindAccuracy && cards > 0) ||\n (doc.tally?.failedQRemaining ?? 0) > 0\n ) {\n flags.push('grinding');\n }\n return flags;\n}\n\nexport function summarizeSession(\n doc: StudySessionDoc,\n interp?: DiagnosticsInterpreters\n): SessionSummary {\n const start = Date.parse(doc.startTime);\n const end = doc.endTime ? Date.parse(doc.endTime) : NaN;\n const durationSeconds =\n Number.isNaN(start) || Number.isNaN(end) ? null : Math.round((end - start) / 1000);\n\n const responses = doc.tally?.responses ?? 0;\n const accuracy = responses > 0 ? (doc.tally?.correct ?? 0) / responses : null;\n\n const events = doc.eloEvents ?? [];\n const eloNet = events.length\n ? events.reduce((n, e) => n + (e.global.after - e.global.before), 0)\n : null;\n\n const base = { doc, durationSeconds, accuracy, eloNet, state: stateRows(doc, interp) };\n return { ...base, flags: flagSession(base, interp) };\n}\n\n/** Every session in the dataset, newest first. */\nexport function summarizeSessions(\n ds: LearnerDataset,\n interp?: DiagnosticsInterpreters\n): SessionSummary[] {\n return ds.sessions.map((d) => summarizeSession(d, interp)).reverse();\n}\n\n// ============================================================================\n// Session timeline\n// ============================================================================\n\n/** A `SessionEloEvent` reshaped for one response row: deltas precomputed, tags as a sorted array. */\nexport interface ResponseEloDelta {\n userScore: number;\n global: { before: number; after: number; delta: number };\n card?: { before: number; after: number; delta: number };\n /** `score: null` is a count-only exposure that moves count, not ELO. */\n tags: Array<{ tag: string; before: number; after: number; delta: number; score: number | null }>;\n}\n\nexport interface TimelineResponse {\n kind: 'response';\n at: string;\n cardId: string;\n /** Absent when the dataset has no course slice. */\n card?: CardSummary;\n tags: string[];\n questionType?: string;\n isCorrect: boolean | null;\n timeSpentMs: number;\n priorAttempts: number | null;\n userAnswer: unknown;\n /**\n * The ELO exchange this response produced, joined from `eloEvents` by card\n * and nearest time. Absent on retries (only first attempts move ELO), on\n * events in flight at close, and on sessions predating ELO events.\n */\n elo?: ResponseEloDelta;\n}\n\nexport interface TimelineRun {\n kind: 'run';\n at: string;\n run: StudySessionRunSummary;\n}\n\n/**\n * Responses and pipeline runs in one time-ordered stream: a replan firing\n * between two failures is the thing worth seeing, and a per-card pivot can't\n * show sequence.\n */\nexport type TimelineEntry = TimelineResponse | TimelineRun;\n\nexport interface SessionDetail {\n summary: SessionSummary;\n timeline: TimelineEntry[];\n /** The tally claims more responses than records stamped with this session were found. */\n responsesMissing: boolean;\n}\n\nfunction toResponseEloDelta(\n ev: SessionEloEvent,\n interp?: DiagnosticsInterpreters\n): ResponseEloDelta {\n const order = bySkillThenName(interp);\n const tags = Object.entries(ev.tags ?? {})\n .map(([tag, t]) => ({\n tag,\n before: t.before,\n after: t.after,\n delta: t.after - t.before,\n score: t.score,\n }))\n .sort((a, b) => order(a.tag, b.tag));\n return {\n userScore: ev.userScore,\n global: {\n before: ev.global.before,\n after: ev.global.after,\n delta: ev.global.after - ev.global.before,\n },\n ...(ev.card\n ? {\n card: {\n before: ev.card.before,\n after: ev.card.after,\n delta: ev.card.after - ev.card.before,\n },\n }\n : {}),\n tags,\n };\n}\n\n/**\n * Attach each ELO event to its response. The event carries no record id, so\n * join by card and nearest time, using each response at most once. A record\n * is stamped when the card is shown and an event when the answer is\n * submitted, so the join is on the response's end (shown + time spent):\n * joined on the start, a long response's event lands on the next attempt.\n */\nfunction attachEloEvents(\n responses: TimelineResponse[],\n events: SessionEloEvent[],\n interp?: DiagnosticsInterpreters\n): void {\n const used = new Set<number>();\n for (const ev of events) {\n const evT = Date.parse(ev.at);\n let best = -1;\n let bestGap = Infinity;\n responses.forEach((r, i) => {\n if (used.has(i) || r.cardId !== ev.cardId) return;\n const gap = Math.abs(Date.parse(r.at) + r.timeSpentMs - evT);\n if (gap < bestGap) {\n bestGap = gap;\n best = i;\n }\n });\n if (best >= 0) {\n used.add(best);\n responses[best].elo = toResponseEloDelta(ev, interp);\n }\n }\n}\n\nfunction byTime(a: { at: string }, b: { at: string }): number {\n const ta = Date.parse(a.at);\n const tb = Date.parse(b.at);\n if (Number.isNaN(ta) || Number.isNaN(tb)) return a.at.localeCompare(b.at);\n return ta - tb;\n}\n\n/** One session's summary and interleaved timeline, or null if the dataset has no such session. */\nexport function sessionDetail(\n ds: LearnerDataset,\n sessionId: string,\n interp?: DiagnosticsInterpreters\n): SessionDetail | null {\n const doc = ds.sessions.find((s) => s.sessionId === sessionId);\n if (!doc) return null;\n\n const responses: TimelineResponse[] = [];\n for (const h of ds.cardHistories) {\n const card = ds.cards?.get(h.cardID);\n for (const r of h.records) {\n if (r.sessionId !== sessionId) continue;\n responses.push({\n kind: 'response',\n at: r.timeStamp,\n cardId: h.cardID,\n ...(card ? { card, questionType: card.questionType } : {}),\n tags: card ? [...card.tags].sort(bySkillThenName(interp)) : [],\n isCorrect: typeof r.isCorrect === 'boolean' ? r.isCorrect : null,\n timeSpentMs: r.timeSpent ?? 0,\n priorAttempts: typeof r.priorAttemps === 'number' ? r.priorAttemps : null,\n userAnswer: r.userAnswer,\n });\n }\n }\n if (doc.eloEvents?.length) attachEloEvents(responses, doc.eloEvents, interp);\n\n const runs: TimelineRun[] = (doc.runs ?? []).map((run) => ({ kind: 'run', at: run.at, run }));\n const timeline: TimelineEntry[] = [...runs, ...responses].sort(byTime);\n\n return {\n summary: summarizeSession(doc, interp),\n timeline,\n responsesMissing: (doc.tally?.responses ?? 0) > responses.length,\n };\n}\n\n/** Per-tag rollup of what a session served. */\nexport interface ServedTagStat {\n tag: string;\n /** Responses carrying this tag (a response with several tags counts toward each). */\n responses: number;\n correct: number;\n incorrect: number;\n /** correct / graded; null when nothing gradeable was served. */\n accuracy: number | null;\n totalTimeMs: number;\n /** Distinct cards carrying this tag. */\n cards: number;\n}\n\n/** Skill tags first, then most-served. */\nexport function servedTags(\n timeline: TimelineEntry[],\n interp?: DiagnosticsInterpreters\n): ServedTagStat[] {\n const byTag = new Map<\n string,\n {\n responses: number;\n correct: number;\n incorrect: number;\n totalTimeMs: number;\n cards: Set<string>;\n }\n >();\n for (const e of timeline) {\n if (e.kind !== 'response') continue;\n for (const tag of e.tags) {\n let s = byTag.get(tag);\n if (!s) {\n s = { responses: 0, correct: 0, incorrect: 0, totalTimeMs: 0, cards: new Set() };\n byTag.set(tag, s);\n }\n s.responses += 1;\n s.totalTimeMs += e.timeSpentMs;\n s.cards.add(e.cardId);\n if (e.isCorrect === true) s.correct += 1;\n else if (e.isCorrect === false) s.incorrect += 1;\n }\n }\n return [...byTag.entries()]\n .map(([tag, s]) => {\n const graded = s.correct + s.incorrect;\n return {\n tag,\n responses: s.responses,\n correct: s.correct,\n incorrect: s.incorrect,\n accuracy: graded > 0 ? s.correct / graded : null,\n totalTimeMs: s.totalTimeMs,\n cards: s.cards.size,\n };\n })\n .sort((a, b) => {\n const d = Number(isSkillTag(interp, b.tag)) - Number(isSkillTag(interp, a.tag));\n if (d !== 0) return d;\n if (b.responses !== a.responses) return b.responses - a.responses;\n return a.tag.localeCompare(b.tag);\n });\n}\n\n/**\n * A session's net global-ELO move split into wins and losses, so an\n * accuracy/ELO mismatch (many small wins, a few big losses) is legible.\n */\nexport interface EloLedger {\n count: number;\n net: number;\n gained: number;\n lost: number;\n wins: number;\n losses: number;\n}\n\nexport function eloLedger(timeline: TimelineEntry[]): EloLedger | null {\n const ledger: EloLedger = { count: 0, net: 0, gained: 0, lost: 0, wins: 0, losses: 0 };\n for (const e of timeline) {\n if (e.kind !== 'response' || !e.elo) continue;\n const g = e.elo.global.delta;\n ledger.count += 1;\n ledger.net += g;\n if (g > 0) {\n ledger.gained += g;\n ledger.wins += 1;\n } else if (g < 0) {\n ledger.lost += g;\n ledger.losses += 1;\n }\n }\n return ledger.count ? ledger : null;\n}\n\n// ============================================================================\n// Card dossiers\n// ============================================================================\n\n/** Fails at or above which an unmoved card ELO counts as frozen. */\nconst FROZEN_FAIL_THRESHOLD = 3;\n\n/** Everything recorded about one card for one learner. */\nexport interface CardDossier {\n cardId: string;\n /** Absent when the dataset has no course slice. */\n card?: CardSummary;\n records: DatasetRecord[];\n lapses: number;\n streak: number;\n bestIntervalSeconds: number;\n attempts: number;\n fails: number;\n firstSeen: string | null;\n lastSeen: string | null;\n totalTimeMs: number;\n /** Earliest pending review; `overdue` is as of `dataset.asOf`. */\n pendingReview: { reviewTime: string; overdue: boolean } | null;\n cardElo: number | null;\n cardEloCount: number | null;\n /** Failed, and holding an overdue review. */\n stuck: boolean;\n /** Failed repeatedly, yet the card's ELO has fewer updates than failures. */\n frozenElo: boolean;\n /** Time sunk × (fails + 1): grind-heavy, low-payoff cards first. For sorting only. */\n painScore: number;\n}\n\n/** One dossier per card the learner has history with, most painful first. */\nexport function cardDossiers(ds: LearnerDataset): CardDossier[] {\n const asOf = Date.parse(ds.asOf);\n const pending = new Map<string, string>();\n for (const s of ds.scheduled) {\n const t = String(s.reviewTime);\n const prev = pending.get(s.cardId);\n if (!prev || t < prev) pending.set(s.cardId, t);\n }\n\n return ds.cardHistories\n .map((h): CardDossier => {\n const card = ds.cards?.get(h.cardID);\n const fails = h.records.filter((r) => r.isCorrect === false).length;\n const totalTimeMs = h.records.reduce((n, r) => n + (r.timeSpent ?? 0), 0);\n const reviewTime = pending.get(h.cardID);\n const pendingReview = reviewTime\n ? { reviewTime, overdue: Date.parse(reviewTime) <= asOf }\n : null;\n const cardElo = card?.elo?.global?.score ?? null;\n const cardEloCount = card?.elo?.global?.count ?? null;\n return {\n cardId: h.cardID,\n ...(card ? { card } : {}),\n records: h.records,\n lapses: h.lapses ?? 0,\n streak: h.streak ?? 0,\n bestIntervalSeconds: h.bestInterval ?? 0,\n attempts: h.records.length,\n fails,\n firstSeen: h.records[0]?.timeStamp ?? null,\n lastSeen: h.records[h.records.length - 1]?.timeStamp ?? null,\n totalTimeMs,\n pendingReview,\n cardElo,\n cardEloCount,\n stuck: fails > 0 && !!pendingReview?.overdue,\n frozenElo: fails >= FROZEN_FAIL_THRESHOLD && cardEloCount !== null && cardEloCount < fails,\n painScore: totalTimeMs * (fails + 1),\n };\n })\n .sort((a, b) => b.painScore - a.painScore);\n}\n\n/** A record's global performance, whether stored as a number or a per-tag map. */\nexport function recordPerformance(r: DatasetRecord): number | null {\n const p = r.performance as unknown;\n if (typeof p === 'number') return p;\n if (p && typeof p === 'object' && typeof (p as { _global?: unknown })._global === 'number') {\n return (p as { _global: number })._global;\n }\n return null;\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"derive.mjs","names":[],"sources":["../../src/diagnostics/derive.ts"],"sourcesContent":["/**\n * Derivations over a `LearnerDataset`: pure functions that views, text\n * exports, and (later) detectors share. Ported from LettersPractice's admin\n * service, with LP's domain knowledge moved behind `DiagnosticsInterpreters`.\n *\n * \"Now\" is always `dataset.asOf`, never the wall clock, so a dump reads the\n * same tomorrow as today.\n */\nimport type {\n SessionEloEvent,\n SessionStateSnapshot,\n StudySessionDoc,\n StudySessionRunSummary,\n} from '../core/types/studySession';\nimport type { CardSummary, DatasetRecord, LearnerDataset } from './dataset';\nimport type { TagBatch, TagEloViewOptions } from './tagElo';\n\n/**\n * Course-supplied meaning for the generic views. Every member is optional and\n * has a neutral default.\n */\nexport interface DiagnosticsInterpreters {\n /** Tags that name what a card exercises: shown inline and sorted first. Default: none. */\n isSkillTag?(tag: string): boolean;\n /** Compact display form of a tag. Default: unchanged. */\n shortTag?(tag: string): string;\n /**\n * Numbers to read off a session's state snapshot, by display label.\n * Default: every numeric field up to two levels deep, labelled by its path.\n */\n snapshotMetrics?(snapshot: SessionStateSnapshot): Record<string, number>;\n /** Which `snapshotMetrics` labels count as progress (for `stalled`). Default: none. */\n progressMetrics?: string[];\n /**\n * Named tag batches for the ELO view, offered beside the namespace × role\n * batches it finds on its own. Default: none.\n */\n tagBatches?: TagBatch[];\n /**\n * How the ELO view reads skills: which tags security and need consider, and\n * their thresholds. Default: exercise-role tags, framework thresholds.\n */\n tagEloOptions?: TagEloViewOptions;\n}\n\nexport const isSkillTag = (i: DiagnosticsInterpreters | undefined, tag: string): boolean =>\n i?.isSkillTag?.(tag) ?? false;\n\nexport const shortTag = (i: DiagnosticsInterpreters | undefined, tag: string): string =>\n i?.shortTag?.(tag) ?? tag;\n\n/** Skill tags first, then alphabetical. */\nfunction bySkillThenName(i: DiagnosticsInterpreters | undefined) {\n return (a: string, b: string): number => {\n const d = Number(isSkillTag(i, b)) - Number(isSkillTag(i, a));\n return d !== 0 ? d : a.localeCompare(b);\n };\n}\n\nfunction defaultSnapshotMetrics(snapshot: SessionStateSnapshot): Record<string, number> {\n const out: Record<string, number> = {};\n for (const [k, v] of Object.entries(snapshot)) {\n if (typeof v === 'number') out[k] = v;\n else if (v && typeof v === 'object' && !Array.isArray(v)) {\n for (const [k2, v2] of Object.entries(v as Record<string, unknown>)) {\n if (typeof v2 === 'number') out[`${k}.${k2}`] = v2;\n }\n }\n }\n return out;\n}\n\n// ============================================================================\n// Sessions\n// ============================================================================\n\n/**\n * Ways a session failed to do its job. `out-of-content` is LP's `starved`,\n * renamed so it isn't confused with intake starvation (no new cards chosen).\n */\nexport type SessionFlag = 'churned' | 'out-of-content' | 'walked' | 'stalled' | 'grinding';\n\nexport const SESSION_FLAGS: Record<SessionFlag, { label: string; help: string }> = {\n churned: {\n label: 'Churned',\n help: 'Many pipeline runs relative to cards served: the plan kept being rebuilt rather than consumed.',\n },\n 'out-of-content': {\n label: 'Out of content',\n help: 'Ended with time left on the clock: content ran out before the session did.',\n },\n walked: {\n label: 'Walked',\n help: 'Abandoned or never closed, after real time invested. Not a mis-click.',\n },\n stalled: {\n label: 'Stalled',\n help: 'No progress metric moved and ELO was essentially flat. The sitting produced nothing measurable.',\n },\n grinding: {\n label: 'Grinding',\n help: 'Majority-incorrect, or ended with unfinished cards still in the failed queue.',\n },\n};\n\n/** First guesses, not measurements: nothing yet records whether a flag was right. */\nexport const SESSION_FLAG_THRESHOLDS = {\n /** Runs per card above which a session counts as churned. */\n churnRunsPerCard: 1 / 3,\n /** Minimum cards before churn is meaningful. */\n churnMinCards: 4,\n /** Leftover clock (s) that counts as running out of content. */\n outOfContentSeconds: 20,\n /** Cards below which an abandon reads as a mis-click, not a walk-out. */\n walkMinCards: 2,\n /** |ELO change| below which movement is flat. */\n stallEloEpsilon: 5,\n /** Accuracy below which a session is grinding. */\n grindAccuracy: 0.5,\n};\n\nexport interface SessionStateRow {\n label: string;\n from: number | null;\n to: number | null;\n delta: number | null;\n}\n\nexport interface SessionSummary {\n doc: StudySessionDoc;\n /** Null while a session is `open`. */\n durationSeconds: number | null;\n accuracy: number | null;\n /** Net learner global-ELO change over the session's ELO events. Null when it has none. */\n eloNet: number | null;\n /** Snapshot metrics at start and end. */\n state: SessionStateRow[];\n flags: SessionFlag[];\n}\n\nfunction stateRows(doc: StudySessionDoc, interp?: DiagnosticsInterpreters): SessionStateRow[] {\n const read = interp?.snapshotMetrics ?? defaultSnapshotMetrics;\n const a = doc.stateAtStart ? read(doc.stateAtStart) : {};\n const b = doc.stateAtEnd ? read(doc.stateAtEnd) : {};\n const labels = [...new Set([...Object.keys(a), ...Object.keys(b)])];\n return labels.map((label) => {\n const from = a[label] ?? null;\n const to = b[label] ?? null;\n return { label, from, to, delta: from !== null && to !== null ? to - from : null };\n });\n}\n\nfunction flagSession(\n s: Omit<SessionSummary, 'flags'>,\n interp?: DiagnosticsInterpreters\n): SessionFlag[] {\n const T = SESSION_FLAG_THRESHOLDS;\n const { doc, accuracy, eloNet } = s;\n const flags: SessionFlag[] = [];\n const cards = doc.tally?.cardsPresented ?? 0;\n const runs = doc.runs?.length ?? 0;\n\n if (cards >= T.churnMinCards && runs / cards > T.churnRunsPerCard) flags.push('churned');\n\n // Only a closed session can run out of content; an abandoned one has time left by definition.\n if (doc.status === 'closed' && (doc.tally?.secondsRemaining ?? 0) > T.outOfContentSeconds) {\n flags.push('out-of-content');\n }\n\n if (doc.status === 'open') flags.push('walked');\n else if (doc.status === 'abandoned' && cards >= T.walkMinCards) flags.push('walked');\n\n // Needs something measurable, else every session without snapshots or ELO events would flag.\n const progress = s.state.filter((r) => interp?.progressMetrics?.includes(r.label));\n const measurable = eloNet !== null || progress.some((r) => r.delta !== null);\n if (\n cards > 0 &&\n measurable &&\n progress.every((r) => (r.delta ?? 0) === 0) &&\n Math.abs(eloNet ?? 0) < T.stallEloEpsilon\n ) {\n flags.push('stalled');\n }\n\n if (\n (accuracy !== null && accuracy < T.grindAccuracy && cards > 0) ||\n (doc.tally?.failedQRemaining ?? 0) > 0\n ) {\n flags.push('grinding');\n }\n return flags;\n}\n\nexport function summarizeSession(\n doc: StudySessionDoc,\n interp?: DiagnosticsInterpreters\n): SessionSummary {\n const start = Date.parse(doc.startTime);\n const end = doc.endTime ? Date.parse(doc.endTime) : NaN;\n const durationSeconds =\n Number.isNaN(start) || Number.isNaN(end) ? null : Math.round((end - start) / 1000);\n\n const responses = doc.tally?.responses ?? 0;\n const accuracy = responses > 0 ? (doc.tally?.correct ?? 0) / responses : null;\n\n const events = doc.eloEvents ?? [];\n const eloNet = events.length\n ? events.reduce((n, e) => n + (e.global.after - e.global.before), 0)\n : null;\n\n const base = { doc, durationSeconds, accuracy, eloNet, state: stateRows(doc, interp) };\n return { ...base, flags: flagSession(base, interp) };\n}\n\n/** Every session in the dataset, newest first. */\nexport function summarizeSessions(\n ds: LearnerDataset,\n interp?: DiagnosticsInterpreters\n): SessionSummary[] {\n return ds.sessions.map((d) => summarizeSession(d, interp)).reverse();\n}\n\n// ============================================================================\n// Session timeline\n// ============================================================================\n\n/** A `SessionEloEvent` reshaped for one response row: deltas precomputed, tags as a sorted array. */\nexport interface ResponseEloDelta {\n userScore: number;\n global: { before: number; after: number; delta: number };\n card?: { before: number; after: number; delta: number };\n /** `score: null` is a count-only exposure that moves count, not ELO. */\n tags: Array<{ tag: string; before: number; after: number; delta: number; score: number | null }>;\n}\n\nexport interface TimelineResponse {\n kind: 'response';\n at: string;\n cardId: string;\n /** Absent when the dataset has no course slice. */\n card?: CardSummary;\n tags: string[];\n questionType?: string;\n isCorrect: boolean | null;\n timeSpentMs: number;\n priorAttempts: number | null;\n userAnswer: unknown;\n /**\n * The ELO exchange this response produced, joined from `eloEvents` by card\n * and nearest time. Absent on retries (only first attempts move ELO), on\n * events in flight at close, and on sessions predating ELO events.\n */\n elo?: ResponseEloDelta;\n}\n\nexport interface TimelineRun {\n kind: 'run';\n at: string;\n run: StudySessionRunSummary;\n}\n\n/**\n * Responses and pipeline runs in one time-ordered stream: a replan firing\n * between two failures is the thing worth seeing, and a per-card pivot can't\n * show sequence.\n */\nexport type TimelineEntry = TimelineResponse | TimelineRun;\n\nexport interface SessionDetail {\n summary: SessionSummary;\n timeline: TimelineEntry[];\n /** The tally claims more responses than records stamped with this session were found. */\n responsesMissing: boolean;\n}\n\nfunction toResponseEloDelta(\n ev: SessionEloEvent,\n interp?: DiagnosticsInterpreters\n): ResponseEloDelta {\n const order = bySkillThenName(interp);\n const tags = Object.entries(ev.tags ?? {})\n .map(([tag, t]) => ({\n tag,\n before: t.before,\n after: t.after,\n delta: t.after - t.before,\n score: t.score,\n }))\n .sort((a, b) => order(a.tag, b.tag));\n return {\n userScore: ev.userScore,\n global: {\n before: ev.global.before,\n after: ev.global.after,\n delta: ev.global.after - ev.global.before,\n },\n ...(ev.card\n ? {\n card: {\n before: ev.card.before,\n after: ev.card.after,\n delta: ev.card.after - ev.card.before,\n },\n }\n : {}),\n tags,\n };\n}\n\n/**\n * Attach each ELO event to its response. The event carries no record id, so\n * join by card and nearest time, using each response at most once. A record\n * is stamped when the card is shown and an event when the answer is\n * submitted, so the join is on the response's end (shown + time spent):\n * joined on the start, a long response's event lands on the next attempt.\n */\nfunction attachEloEvents(\n responses: TimelineResponse[],\n events: SessionEloEvent[],\n interp?: DiagnosticsInterpreters\n): void {\n const used = new Set<number>();\n for (const ev of events) {\n const evT = Date.parse(ev.at);\n let best = -1;\n let bestGap = Infinity;\n responses.forEach((r, i) => {\n if (used.has(i) || r.cardId !== ev.cardId) return;\n const gap = Math.abs(Date.parse(r.at) + r.timeSpentMs - evT);\n if (gap < bestGap) {\n bestGap = gap;\n best = i;\n }\n });\n if (best >= 0) {\n used.add(best);\n responses[best].elo = toResponseEloDelta(ev, interp);\n }\n }\n}\n\nfunction byTime(a: { at: string }, b: { at: string }): number {\n const ta = Date.parse(a.at);\n const tb = Date.parse(b.at);\n if (Number.isNaN(ta) || Number.isNaN(tb)) return a.at.localeCompare(b.at);\n return ta - tb;\n}\n\n/** One session's summary and interleaved timeline, or null if the dataset has no such session. */\nexport function sessionDetail(\n ds: LearnerDataset,\n sessionId: string,\n interp?: DiagnosticsInterpreters\n): SessionDetail | null {\n const doc = ds.sessions.find((s) => s.sessionId === sessionId);\n if (!doc) return null;\n\n const responses: TimelineResponse[] = [];\n for (const h of ds.cardHistories) {\n const card = ds.cards?.get(h.cardID);\n for (const r of h.records) {\n if (r.sessionId !== sessionId) continue;\n responses.push({\n kind: 'response',\n at: r.timeStamp,\n cardId: h.cardID,\n ...(card ? { card, questionType: card.questionType } : {}),\n tags: card ? [...card.tags].sort(bySkillThenName(interp)) : [],\n isCorrect: typeof r.isCorrect === 'boolean' ? r.isCorrect : null,\n timeSpentMs: r.timeSpent ?? 0,\n priorAttempts: typeof r.priorAttemps === 'number' ? r.priorAttemps : null,\n userAnswer: r.userAnswer,\n });\n }\n }\n if (doc.eloEvents?.length) attachEloEvents(responses, doc.eloEvents, interp);\n\n const runs: TimelineRun[] = (doc.runs ?? []).map((run) => ({ kind: 'run', at: run.at, run }));\n const timeline: TimelineEntry[] = [...runs, ...responses].sort(byTime);\n\n return {\n summary: summarizeSession(doc, interp),\n timeline,\n responsesMissing: (doc.tally?.responses ?? 0) > responses.length,\n };\n}\n\n/** Per-tag rollup of what a session served. */\nexport interface ServedTagStat {\n tag: string;\n /** Responses carrying this tag (a response with several tags counts toward each). */\n responses: number;\n correct: number;\n incorrect: number;\n /** correct / graded; null when nothing gradeable was served. */\n accuracy: number | null;\n totalTimeMs: number;\n /** Distinct cards carrying this tag. */\n cards: number;\n}\n\n/** Skill tags first, then most-served. */\nexport function servedTags(\n timeline: TimelineEntry[],\n interp?: DiagnosticsInterpreters\n): ServedTagStat[] {\n const byTag = new Map<\n string,\n {\n responses: number;\n correct: number;\n incorrect: number;\n totalTimeMs: number;\n cards: Set<string>;\n }\n >();\n for (const e of timeline) {\n if (e.kind !== 'response') continue;\n for (const tag of e.tags) {\n let s = byTag.get(tag);\n if (!s) {\n s = { responses: 0, correct: 0, incorrect: 0, totalTimeMs: 0, cards: new Set() };\n byTag.set(tag, s);\n }\n s.responses += 1;\n s.totalTimeMs += e.timeSpentMs;\n s.cards.add(e.cardId);\n if (e.isCorrect === true) s.correct += 1;\n else if (e.isCorrect === false) s.incorrect += 1;\n }\n }\n return [...byTag.entries()]\n .map(([tag, s]) => {\n const graded = s.correct + s.incorrect;\n return {\n tag,\n responses: s.responses,\n correct: s.correct,\n incorrect: s.incorrect,\n accuracy: graded > 0 ? s.correct / graded : null,\n totalTimeMs: s.totalTimeMs,\n cards: s.cards.size,\n };\n })\n .sort((a, b) => {\n const d = Number(isSkillTag(interp, b.tag)) - Number(isSkillTag(interp, a.tag));\n if (d !== 0) return d;\n if (b.responses !== a.responses) return b.responses - a.responses;\n return a.tag.localeCompare(b.tag);\n });\n}\n\n/**\n * A session's net global-ELO move split into wins and losses, so an\n * accuracy/ELO mismatch (many small wins, a few big losses) is legible.\n */\nexport interface EloLedger {\n count: number;\n net: number;\n gained: number;\n lost: number;\n wins: number;\n losses: number;\n}\n\nexport function eloLedger(timeline: TimelineEntry[]): EloLedger | null {\n const ledger: EloLedger = { count: 0, net: 0, gained: 0, lost: 0, wins: 0, losses: 0 };\n for (const e of timeline) {\n if (e.kind !== 'response' || !e.elo) continue;\n const g = e.elo.global.delta;\n ledger.count += 1;\n ledger.net += g;\n if (g > 0) {\n ledger.gained += g;\n ledger.wins += 1;\n } else if (g < 0) {\n ledger.lost += g;\n ledger.losses += 1;\n }\n }\n return ledger.count ? ledger : null;\n}\n\n// ============================================================================\n// Card dossiers\n// ============================================================================\n\n/** Fails at or above which an unmoved card ELO counts as frozen. */\nconst FROZEN_FAIL_THRESHOLD = 3;\n\n/** Everything recorded about one card for one learner. */\nexport interface CardDossier {\n cardId: string;\n /** Absent when the dataset has no course slice. */\n card?: CardSummary;\n records: DatasetRecord[];\n lapses: number;\n streak: number;\n bestIntervalSeconds: number;\n attempts: number;\n fails: number;\n firstSeen: string | null;\n lastSeen: string | null;\n totalTimeMs: number;\n /** Earliest pending review; `overdue` is as of `dataset.asOf`. */\n pendingReview: { reviewTime: string; overdue: boolean } | null;\n cardElo: number | null;\n cardEloCount: number | null;\n /** Failed, and holding an overdue review. */\n stuck: boolean;\n /** Failed repeatedly, yet the card's ELO has fewer updates than failures. */\n frozenElo: boolean;\n /** Time sunk × (fails + 1): grind-heavy, low-payoff cards first. For sorting only. */\n painScore: number;\n}\n\n/** One dossier per card the learner has history with, most painful first. */\nexport function cardDossiers(ds: LearnerDataset): CardDossier[] {\n const asOf = Date.parse(ds.asOf);\n const pending = new Map<string, string>();\n for (const s of ds.scheduled) {\n const t = String(s.reviewTime);\n const prev = pending.get(s.cardId);\n if (!prev || t < prev) pending.set(s.cardId, t);\n }\n\n return ds.cardHistories\n .map((h): CardDossier => {\n const card = ds.cards?.get(h.cardID);\n const fails = h.records.filter((r) => r.isCorrect === false).length;\n const totalTimeMs = h.records.reduce((n, r) => n + (r.timeSpent ?? 0), 0);\n const reviewTime = pending.get(h.cardID);\n const pendingReview = reviewTime\n ? { reviewTime, overdue: Date.parse(reviewTime) <= asOf }\n : null;\n const cardElo = card?.elo?.global?.score ?? null;\n const cardEloCount = card?.elo?.global?.count ?? null;\n return {\n cardId: h.cardID,\n ...(card ? { card } : {}),\n records: h.records,\n lapses: h.lapses ?? 0,\n streak: h.streak ?? 0,\n bestIntervalSeconds: h.bestInterval ?? 0,\n attempts: h.records.length,\n fails,\n firstSeen: h.records[0]?.timeStamp ?? null,\n lastSeen: h.records[h.records.length - 1]?.timeStamp ?? null,\n totalTimeMs,\n pendingReview,\n cardElo,\n cardEloCount,\n stuck: fails > 0 && !!pendingReview?.overdue,\n frozenElo: fails >= FROZEN_FAIL_THRESHOLD && cardEloCount !== null && cardEloCount < fails,\n painScore: totalTimeMs * (fails + 1),\n };\n })\n .sort((a, b) => b.painScore - a.painScore);\n}\n\n/** A record's global performance, whether stored as a number or a per-tag map. */\nexport function recordPerformance(r: DatasetRecord): number | null {\n const p = r.performance as unknown;\n if (typeof p === 'number') return p;\n if (p && typeof p === 'object' && typeof (p as { _global?: unknown })._global === 'number') {\n return (p as { _global: number })._global;\n }\n return null;\n}\n"],"mappings":"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"}
|
|
@@ -982,9 +982,13 @@ function step(line, at, before, after) {
|
|
|
982
982
|
line.push({ at, score: before });
|
|
983
983
|
line.push({ at, score: after });
|
|
984
984
|
}
|
|
985
|
-
function tagEloView(ds) {
|
|
985
|
+
function tagEloView(ds, options = {}) {
|
|
986
986
|
const elo = learnerCourseElo(ds);
|
|
987
987
|
if (!elo) return null;
|
|
988
|
+
const security = (0, import_common.courseSecurity)(elo, options.security);
|
|
989
|
+
const securityByTag = new Map(security.tags.map((s) => [s.tag, s]));
|
|
990
|
+
const need = (0, import_common.skillNeed)(elo, options.need);
|
|
991
|
+
const needByTag = new Map(need.skills.map((s) => [s.tag, s]));
|
|
988
992
|
const seen = /* @__PURE__ */ new Map();
|
|
989
993
|
for (const h of ds.cardHistories) {
|
|
990
994
|
for (const r of h.records) {
|
|
@@ -1031,7 +1035,9 @@ function tagEloView(ds) {
|
|
|
1031
1035
|
count: rank.count,
|
|
1032
1036
|
vsGlobal: score === null ? null : score - elo.global.score,
|
|
1033
1037
|
recent,
|
|
1034
|
-
recentOk: recent.filter(
|
|
1038
|
+
recentOk: recent.filter(import_common.presentationOk).length,
|
|
1039
|
+
...securityByTag.has(tag) ? { security: securityByTag.get(tag) } : {},
|
|
1040
|
+
...needByTag.has(tag) ? { need: needByTag.get(tag).need, deficit: needByTag.get(tag).deficit } : {},
|
|
1035
1041
|
firstSeen: first,
|
|
1036
1042
|
lastSeen: last,
|
|
1037
1043
|
events: eventCounts.get(tag) ?? 0
|
|
@@ -1055,7 +1061,14 @@ function tagEloView(ds) {
|
|
|
1055
1061
|
(a, b) => Number(countOnlyGroup(a)) - Number(countOnlyGroup(b)) || a.id.localeCompare(b.id)
|
|
1056
1062
|
),
|
|
1057
1063
|
series: { global: globalSeries, tags: tagSeries },
|
|
1058
|
-
seriesFrom: events[0]?.at ?? null
|
|
1064
|
+
seriesFrom: events[0]?.at ?? null,
|
|
1065
|
+
skillReference: need.reference,
|
|
1066
|
+
security: {
|
|
1067
|
+
secure: security.secure,
|
|
1068
|
+
shaky: security.shaky,
|
|
1069
|
+
unproven: security.unproven,
|
|
1070
|
+
debt: security.debt
|
|
1071
|
+
}
|
|
1059
1072
|
};
|
|
1060
1073
|
}
|
|
1061
1074
|
// Annotate the CommonJS export names for ESM import in node:
|