@gonzih/exam-prep-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maksim Soltan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,287 @@
+# exam-prep-mcp
+
+> AI-powered exam preparation MCP server with FSRS-5 spaced repetition
+
+[![npm version](https://badge.fury.io/js/@gonzih%2Fexam-prep-mcp.svg)](https://www.npmjs.com/package/@gonzih/exam-prep-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Overview
+
+`exam-prep-mcp` is a Model Context Protocol (MCP) server that brings adaptive, science-backed exam preparation into your AI assistant workflow. It uses the **FSRS-5 spaced repetition algorithm** to schedule reviews at optimal intervals — you study smarter, not harder.
+
+### Features
+
+- **FSRS-5 Spaced Repetition** — Cards are scheduled based on your performance and forgetting curves
+- **50+ Real Practice Questions** — Accurate questions with detailed explanations across AP and SAT subjects
+- **Study Plan Generator** — Personalized day-by-day schedule based on your exam date and level
+- **Mock Exams** — Full-length timed practice exams with grade estimates
+- **Readiness Score** — Track your preparation progress with a 0-100 readiness score
+- **Weak Area Detection** — Automatically identifies topics that need more focus
+- **Multiple Exam Types** — AP Biology, AP Chemistry, AP US History, SAT Math, MCAT, LSAT, GRE, and more
+
+## Installation
+
+### Global install (recommended)
+
+```bash
+npm install -g @gonzih/exam-prep-mcp
+```
+
+### Run without installing
+
+```bash
+npx @gonzih/exam-prep-mcp
+```
+
+## MCP Configuration
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "exam-prep": {
+      "command": "exam-prep-mcp"
+    }
+  }
+}
+```
+
+Or with npx:
+
+```json
+{
+  "mcpServers": {
+    "exam-prep": {
+      "command": "npx",
+      "args": ["-y", "@gonzih/exam-prep-mcp"]
+    }
+  }
+}
+```
+
+### Custom database path
+
+```json
+{
+  "mcpServers": {
+    "exam-prep": {
+      "command": "exam-prep-mcp",
+      "env": {
+        "EXAM_PREP_DB": "/path/to/your/study.sqlite"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `EXAM_PREP_DB` | `~/.exam-prep/study.sqlite` | Path to SQLite database file |
+
+## Tools
+
+### 1. `set_exam`
+
+Configure an exam for a student profile. Seeds question cards and generates a personalized study plan.
+
+**Parameters:**
+- `profileId` (string, required) — Unique student identifier (e.g., `"alice"`, `"student-001"`)
+- `examType` (string, required) — Exam to prepare for (see Supported Exams below)
+- `examDate` (string, required) — Exam date in `YYYY-MM-DD` format
+- `currentLevel` (string, required) — `"beginner"`, `"intermediate"`, or `"advanced"`
+
+**Returns:** Study plan, topics identified, days remaining, seeded card count
+
+---
+
+### 2. `get_daily_session`
+
+Get today's personalized practice questions based on FSRS spaced repetition scheduling.
+
+**Parameters:**
+- `profileId` (string, required) — Student profile ID
+
+**Returns:** 10-15 questions with card IDs, topics, question text, choices (for MC), estimated time, focus areas
+
+---
+
+### 3. `answer_question`
+
+Submit an answer to a practice question. Evaluates correctness, applies FSRS scheduling, and detects weak areas.
+
+**Parameters:**
+- `profileId` (string, required) — Student profile ID
+- `cardId` (string, required) — Card ID from `get_daily_session` or `start_mock_exam`
+- `answer` (string, required) — Student's answer (`"A"`, `"B"`, `"C"`, `"D"` for multiple choice; text for others)
+- `rating` (1-4, optional) — Manual difficulty rating: 1=Again, 2=Hard, 3=Good, 4=Easy
+
+**Returns:** Correct/incorrect, correct answer, explanation, next review date, weak area alert if applicable
+
+---
+
+### 4. `start_mock_exam`
+
+Begin a timed full-length practice exam simulating real exam conditions.
+
+**Parameters:**
+- `profileId` (string, required) — Student profile ID
+
+**Returns:** Session ID, all exam questions, time limit in minutes, instructions
+
+---
+
+### 5. `submit_mock_exam`
+
+Submit all answers for a completed mock exam and receive detailed scoring and analysis.
+
+**Parameters:**
+- `sessionId` (string, required) — Session ID from `start_mock_exam`
+- `answers` (array, required) — Array of `{ cardId, answer }` objects
+
+**Returns:** Score, grade estimate, topic breakdown, weak/strong topics, readiness score update, recommendation
+
+---
+
+### 6. `get_readiness`
+
+Get a comprehensive readiness report with your current score, grade estimate, performance trend, and recommendation.
+
+**Parameters:**
+- `profileId` (string, required) — Student profile ID
+
+**Returns:** 0-100 readiness score, strong/weak topics, coverage percent, trend (improving/declining/stable), grade estimate, recommendation
+
+---
+
+### 7. `get_weak_areas`
+
+Identify topics with accuracy below 60% that need focused study.
+
+**Parameters:**
+- `profileId` (string, required) — Student profile ID
+
+**Returns:** Ranked list of weak topics with accuracy and attempt counts, suggested focus plan
+
+## Supported Exam Types
+
+| Exam Type | Description | Questions | Time Limit |
+|-----------|-------------|-----------|------------|
+| `AP_Biology` | AP Biology | 60 | 170 min |
+| `AP_Chemistry` | AP Chemistry | 60 | 190 min |
+| `AP_US_History` | AP US History | 55 | 205 min |
+| `AP_World_History` | AP World History | 55 | 205 min |
+| `AP_Physics` | AP Physics | 50 | 180 min |
+| `AP_Calculus` | AP Calculus AB/BC | 45 | 195 min |
+| `AP_Statistics` | AP Statistics | 40 | 180 min |
+| `AP_English` | AP English Language | 45 | 215 min |
+| `AP_Economics` | AP Micro/Macro Economics | 60 | 130 min |
+| `SAT_Math` | SAT Math section | 44 | 70 min |
+| `SAT_Reading` | SAT Reading section | 52 | 65 min |
+| `SAT_Writing` | SAT Writing section | 44 | 35 min |
+| `MCAT` | Medical College Admissions | 230 | 375 min |
+| `LSAT` | Law School Admissions | 100 | 175 min |
+| `GRE` | Graduate Record Examination | 80 | 225 min |
+
+## Example Conversation
+
+**Scenario:** Student has AP Chemistry exam in 3 weeks
+
+---
+
+**Student:** I have my AP Chemistry exam on May 15th. I'm currently at an intermediate level. Can you set me up?
+
+**Claude:** I'll set up your AP Chemistry exam prep right away!
+
+*[calls `set_exam` with profileId="student", examType="AP_Chemistry", examDate="2025-05-15", currentLevel="intermediate"]*
+
+Great! I've configured your AP Chemistry prep:
+- **21 days** until your exam
+- **10 topics** identified: Atomic Structure, Chemical Bonding, Stoichiometry, Gas Laws, Thermodynamics, Chemical Equilibrium, Acids and Bases, Electrochemistry, Kinetics, Nuclear Chemistry
+- **48 practice cards** seeded into your study queue
+- Weekly goal: Master 3-4 topics per week
+
+---
+
+**Student:** What should I study today?
+
+**Claude:** *[calls `get_daily_session`]*
+
+Today's session (12 questions, ~30 min):
+
+**Focus areas:** Stoichiometry, Gas Laws, Acids and Bases
+
+1. **[Stoichiometry]** How many grams of H₂O are produced when 4.0g of H₂ reacts completely with excess O₂?
+2. **[Gas Laws]** A gas occupies 2.0 L at 300K and 1.0 atm. What volume at 600K and 2.0 atm?
+...
+
+---
+
+**Student:** For question 1, I think it's 36 grams.
+
+**Claude:** *[calls `answer_question` with answer="36 g"]*
+
+**Correct!** Well done.
+
+36 g is right. 2H₂ + O₂ → 2H₂O. Moles H₂ = 4.0g / 2.0g/mol = 2.0 mol. From stoichiometry, 2.0 mol H₂O × 18 g/mol = **36 g**.
+
+Next review: in 3 days
+
+---
+
+**Student:** Let's do a mock exam!
+
+**Claude:** *[calls `start_mock_exam`]*
+
+Starting your AP Chemistry mock exam:
+- **60 questions**
+- **190 minutes** time limit
+- Answer all questions, then use `submit_mock_exam` when done.
+
+---
+
+**Student:** How ready am I overall?
+
+**Claude:** *[calls `get_readiness`]*
+
+**Readiness Score: 67/100**
+
+- Estimated AP Score: **4/5** (Well Qualified)
+- Topics mastered: Chemical Bonding, Atomic Structure
+- Weak areas: Electrochemistry (40%), Thermodynamics (50%)
+- Trend: **Improving**
+- 21 days remaining — excellent time to close the gaps!
+
+**Recommendation:** Focus on Electrochemistry and Thermodynamics this week. You're on track for a 4!
+
+## How FSRS Works
+
+FSRS-5 (Free Spaced Repetition Scheduler) is a state-of-the-art algorithm that models human memory:
+
+- **Stability (S):** How long you'll remember something (in days)
+- **Difficulty (D):** How hard the material is for you (1-10 scale)
+- **Retrievability (R):** Probability you can recall it right now (0-1)
+
+After each answer, the algorithm calculates your next optimal review date. Cards you find easy get longer intervals; cards you struggle with come back sooner. This minimizes total study time while maximizing retention.
+
+## Development
+
+```bash
+git clone https://github.com/gonzih/exam-prep-mcp
+cd exam-prep-mcp
+npm install
+npm run dev     # Run with tsx (no build needed)
+npm run build   # Compile TypeScript
+npm start       # Run compiled version
+```
+
+## License
+
+MIT © Gonzih

package/SKILL.md

@@ -0,0 +1,79 @@
+# exam-prep-mcp
+
+Trigger: when user mentions studying for AP exams, SAT, MCAT, LSAT, GRE, finals, or any exam preparation.
+
+## What This Does
+
+`exam-prep-mcp` is an MCP server that provides AI-powered exam preparation with FSRS-5 spaced repetition. It maintains a SQLite database of practice questions, tracks student performance, schedules reviews at optimal intervals, runs mock exams, and generates readiness reports.
+
+Key capabilities:
+- Personalized spaced repetition scheduling (FSRS-5 algorithm)
+- 50+ real practice questions across AP Biology, AP Chemistry, AP US History, SAT Math
+- Adaptive study plans based on exam date and student level
+- Full-length timed mock exams
+- Topic-level performance tracking and weak area detection
+- Readiness scores with grade estimates (AP 1-5, SAT scores, etc.)
+
+## Available MCP Tools
+
+### 1. `set_exam`
+Configure exam prep for a student. Seeds practice cards and generates a daily study plan.
+- Required: `profileId`, `examType`, `examDate` (YYYY-MM-DD), `currentLevel` (beginner/intermediate/advanced)
+
+### 2. `get_daily_session`
+Fetch today's practice questions, selected by FSRS scheduling (due cards + new cards to hit 10-15 questions).
+- Required: `profileId`
+
+### 3. `answer_question`
+Submit a student answer, evaluate correctness, apply FSRS scheduling, and check for weak area alerts.
+- Required: `profileId`, `cardId`, `answer`
+- Optional: `rating` (1=Again, 2=Hard, 3=Good, 4=Easy)
+
+### 4. `start_mock_exam`
+Begin a full-length timed mock exam. Returns all questions and a session ID.
+- Required: `profileId`
+
+### 5. `submit_mock_exam`
+Grade a completed mock exam. Returns score, grade estimate, topic breakdown, readiness update.
+- Required: `sessionId`, `answers` (array of `{cardId, answer}`)
+
+### 6. `get_readiness`
+Get overall readiness score (0-100), strong/weak topics, performance trend, and grade estimate.
+- Required: `profileId`
+
+### 7. `get_weak_areas`
+List topics with accuracy below 60%, ranked by most urgent, with a suggested focus plan.
+- Required: `profileId`
+
+## Supported Exam Types
+
+- `AP_Biology`, `AP_Chemistry`, `AP_US_History`, `AP_World_History`
+- `AP_Physics`, `AP_Calculus`, `AP_Statistics`, `AP_English`, `AP_Economics`
+- `SAT_Math`, `SAT_Reading`, `SAT_Writing`
+- `MCAT`, `LSAT`, `GRE`
+
+## Quick Start
+
+When a user asks to prepare for an exam:
+
+1. **Set up** with `set_exam`:
+   ```
+   profileId: "student" (or their name)
+   examType: "AP_Chemistry"
+   examDate: "2025-05-15"
+   currentLevel: "intermediate"
+   ```
+
+2. **Daily practice** with `get_daily_session` → present questions → `answer_question` for each response
+
+3. **Check progress** with `get_readiness` and `get_weak_areas`
+
+4. **Mock exams** with `start_mock_exam` → collect all answers → `submit_mock_exam`
+
+## Usage Pattern
+
+- Use `profileId` consistently to track one student's progress across sessions
+- Always call `set_exam` first before any other tool
+- For multiple choice questions, accept "A", "B", "C", or "D" as the answer
+- For free response, keyword matching is used — encourage complete sentences
+- The FSRS algorithm handles scheduling automatically; just answer questions consistently

package/dist/db.d.ts

@@ -0,0 +1,66 @@
+import Database from 'better-sqlite3';
+export interface Card {
+    id: string;
+    profile_id: string;
+    subject: string;
+    topic: string;
+    question: string;
+    answer: string;
+    difficulty: number;
+    stability: number;
+    retrievability: number;
+    next_review: string | null;
+    review_count: number;
+    last_rating: number | null;
+    created_at: string;
+}
+export interface Session {
+    id: string;
+    profile_id: string;
+    exam_type: string;
+    started_at: string;
+    ended_at: string | null;
+    questions_answered: number;
+    correct: number;
+    readiness_score: number | null;
+}
+export interface ExamConfig {
+    profile_id: string;
+    exam_type: string;
+    exam_date: string;
+    current_level: string;
+    created_at: string;
+}
+export interface TopicStats {
+    profile_id: string;
+    topic: string;
+    subject: string;
+    total_attempts: number;
+    correct_attempts: number;
+    last_attempt: string | null;
+}
+export declare function getDb(): Database.Database;
+export declare function initDb(): Database.Database;
+export declare function insertCard(card: Card): void;
+export declare function getCard(id: string): Card | undefined;
+export declare function updateCard(card: Partial<Card> & {
+    id: string;
+}): void;
+export declare function getDueCards(profileId: string, now: string, limit: number): Card[];
+export declare function getNewCards(profileId: string, limit: number): Card[];
+export declare function getCardsByProfile(profileId: string): Card[];
+export declare function countCardsByQuestion(profileId: string, question: string): number;
+export declare function getCardsByTopic(profileId: string, topic: string, limit: number): Card[];
+export declare function getAllCardsForExam(profileId: string, subject: string, limit: number): Card[];
+export declare function insertSession(session: Session): void;
+export declare function updateSession(session: Partial<Session> & {
+    id: string;
+}): void;
+export declare function getSession(id: string): Session | undefined;
+export declare function getRecentSessions(profileId: string, limit: number): Session[];
+export declare function upsertExamConfig(config: ExamConfig): void;
+export declare function getExamConfig(profileId: string): ExamConfig | undefined;
+export declare function upsertTopicStats(stats: TopicStats): void;
+export declare function getTopicStats(profileId: string): TopicStats[];
+export declare function getTopicStat(profileId: string, topic: string): TopicStats | undefined;
+export declare function getWeakTopics(profileId: string, threshold: number): TopicStats[];

package/dist/db.js

@@ -0,0 +1,188 @@
+import Database from 'better-sqlite3';
+import { homedir } from 'os';
+import { join } from 'path';
+import { mkdirSync } from 'fs';
+let db = null;
+export function getDb() {
+    if (!db) {
+        db = initDb();
+    }
+    return db;
+}
+export function initDb() {
+    const dbPath = process.env.EXAM_PREP_DB || join(homedir(), '.exam-prep', 'study.sqlite');
+    const dir = dbPath.substring(0, dbPath.lastIndexOf('/'));
+    mkdirSync(dir, { recursive: true });
+    const database = new Database(dbPath);
+    database.pragma('journal_mode = WAL');
+    database.exec(`
+    CREATE TABLE IF NOT EXISTS cards (
+      id TEXT PRIMARY KEY,
+      profile_id TEXT NOT NULL,
+      subject TEXT NOT NULL,
+      topic TEXT NOT NULL,
+      question TEXT NOT NULL,
+      answer TEXT NOT NULL,
+      difficulty REAL DEFAULT 0.3,
+      stability REAL DEFAULT 1.0,
+      retrievability REAL DEFAULT 1.0,
+      next_review TEXT,
+      review_count INTEGER DEFAULT 0,
+      last_rating INTEGER,
+      created_at TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS sessions (
+      id TEXT PRIMARY KEY,
+      profile_id TEXT NOT NULL,
+      exam_type TEXT NOT NULL,
+      started_at TEXT NOT NULL,
+      ended_at TEXT,
+      questions_answered INTEGER DEFAULT 0,
+      correct INTEGER DEFAULT 0,
+      readiness_score REAL
+    );
+
+    CREATE TABLE IF NOT EXISTS exam_config (
+      profile_id TEXT PRIMARY KEY,
+      exam_type TEXT NOT NULL,
+      exam_date TEXT NOT NULL,
+      current_level TEXT NOT NULL,
+      created_at TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS topic_stats (
+      profile_id TEXT NOT NULL,
+      topic TEXT NOT NULL,
+      subject TEXT NOT NULL,
+      total_attempts INTEGER DEFAULT 0,
+      correct_attempts INTEGER DEFAULT 0,
+      last_attempt TEXT,
+      PRIMARY KEY (profile_id, topic)
+    );
+  `);
+    db = database;
+    return database;
+}
+// Card CRUD
+export function insertCard(card) {
+    const database = getDb();
+    database.prepare(`
+    INSERT OR IGNORE INTO cards
+      (id, profile_id, subject, topic, question, answer, difficulty, stability, retrievability, next_review, review_count, last_rating, created_at)
+    VALUES
+      (@id, @profile_id, @subject, @topic, @question, @answer, @difficulty, @stability, @retrievability, @next_review, @review_count, @last_rating, @created_at)
+  `).run(card);
+}
+export function getCard(id) {
+    return getDb().prepare('SELECT * FROM cards WHERE id = ?').get(id);
+}
+export function updateCard(card) {
+    const database = getDb();
+    database.prepare(`
+    UPDATE cards SET
+      difficulty = @difficulty,
+      stability = @stability,
+      retrievability = @retrievability,
+      next_review = @next_review,
+      review_count = @review_count,
+      last_rating = @last_rating
+    WHERE id = @id
+  `).run(card);
+}
+export function getDueCards(profileId, now, limit) {
+    return getDb().prepare(`
+    SELECT * FROM cards
+    WHERE profile_id = ? AND (next_review IS NULL OR next_review <= ?)
+    ORDER BY next_review ASC NULLS FIRST
+    LIMIT ?
+  `).all(profileId, now, limit);
+}
+export function getNewCards(profileId, limit) {
+    return getDb().prepare(`
+    SELECT * FROM cards
+    WHERE profile_id = ? AND review_count = 0
+    ORDER BY created_at ASC
+    LIMIT ?
+  `).all(profileId, limit);
+}
+export function getCardsByProfile(profileId) {
+    return getDb().prepare('SELECT * FROM cards WHERE profile_id = ?').all(profileId);
+}
+export function countCardsByQuestion(profileId, question) {
+    const row = getDb().prepare('SELECT COUNT(*) as cnt FROM cards WHERE profile_id = ? AND question = ?').get(profileId, question);
+    return row.cnt;
+}
+export function getCardsByTopic(profileId, topic, limit) {
+    return getDb().prepare(`
+    SELECT * FROM cards WHERE profile_id = ? AND topic = ?
+    ORDER BY RANDOM() LIMIT ?
+  `).all(profileId, topic, limit);
+}
+export function getAllCardsForExam(profileId, subject, limit) {
+    return getDb().prepare(`
+    SELECT * FROM cards WHERE profile_id = ? AND subject = ?
+    ORDER BY RANDOM() LIMIT ?
+  `).all(profileId, subject, limit);
+}
+// Session CRUD
+export function insertSession(session) {
+    getDb().prepare(`
+    INSERT INTO sessions (id, profile_id, exam_type, started_at, ended_at, questions_answered, correct, readiness_score)
+    VALUES (@id, @profile_id, @exam_type, @started_at, @ended_at, @questions_answered, @correct, @readiness_score)
+  `).run(session);
+}
+export function updateSession(session) {
+    getDb().prepare(`
+    UPDATE sessions SET
+      ended_at = @ended_at,
+      questions_answered = @questions_answered,
+      correct = @correct,
+      readiness_score = @readiness_score
+    WHERE id = @id
+  `).run(session);
+}
+export function getSession(id) {
+    return getDb().prepare('SELECT * FROM sessions WHERE id = ?').get(id);
+}
+export function getRecentSessions(profileId, limit) {
+    return getDb().prepare(`
+    SELECT * FROM sessions WHERE profile_id = ? ORDER BY started_at DESC LIMIT ?
+  `).all(profileId, limit);
+}
+// Exam Config CRUD
+export function upsertExamConfig(config) {
+    getDb().prepare(`
+    INSERT OR REPLACE INTO exam_config (profile_id, exam_type, exam_date, current_level, created_at)
+    VALUES (@profile_id, @exam_type, @exam_date, @current_level, @created_at)
+  `).run(config);
+}
+export function getExamConfig(profileId) {
+    return getDb().prepare('SELECT * FROM exam_config WHERE profile_id = ?').get(profileId);
+}
+// Topic Stats CRUD
+export function upsertTopicStats(stats) {
+    getDb().prepare(`
+    INSERT INTO topic_stats (profile_id, topic, subject, total_attempts, correct_attempts, last_attempt)
+    VALUES (@profile_id, @topic, @subject, @total_attempts, @correct_attempts, @last_attempt)
+    ON CONFLICT(profile_id, topic) DO UPDATE SET
+      total_attempts = topic_stats.total_attempts + @total_attempts,
+      correct_attempts = topic_stats.correct_attempts + @correct_attempts,
+      last_attempt = @last_attempt,
+      subject = @subject
+  `).run(stats);
+}
+export function getTopicStats(profileId) {
+    return getDb().prepare('SELECT * FROM topic_stats WHERE profile_id = ?').all(profileId);
+}
+export function getTopicStat(profileId, topic) {
+    return getDb().prepare('SELECT * FROM topic_stats WHERE profile_id = ? AND topic = ?').get(profileId, topic);
+}
+export function getWeakTopics(profileId, threshold) {
+    return getDb().prepare(`
+    SELECT * FROM topic_stats
+    WHERE profile_id = ? AND total_attempts >= 3
+      AND CAST(correct_attempts AS REAL) / total_attempts < ?
+    ORDER BY CAST(correct_attempts AS REAL) / total_attempts ASC
+  `).all(profileId, threshold);
+}

package/dist/fsrs.d.ts

@@ -0,0 +1,10 @@
+export interface FSRSResult {
+    stability: number;
+    difficulty: number;
+    retrievability: number;
+    nextReview: Date;
+    intervalDays: number;
+}
+export declare function scheduleReview(rating: 1 | 2 | 3 | 4, currentStability: number, currentDifficulty: number, reviewCount: number, lastReview?: Date): FSRSResult;
+export declare function calculateRetrievability(stability: number, daysSinceReview: number): number;
+export declare function accuracyToRating(correct: boolean, responseTime?: number): 1 | 2 | 3 | 4;