SRS (Spaced Repitation System)

Create a new subject (a course/grouping that topics can belong to).

Create a topic. Provide lesson material as Markdown in content_markdown (and optional notes_markdown). Set learned:false for "to learn" topics (kept out of the review queue until marked learned); learned:true (default) drops it straight into spaced-repetition using confidence (1-10, default 5). If parent_id is set, the topic inherits the parent's subject.

Fetch a single topic in full, including summary, notes and lesson content (HTML).

List topics due for revision today or earlier (only learned topics), optionally filtered to a subject.

List all of the user's subjects (course-level groupings of topics).

List topics, optionally filtered to one subject. Returns compact summaries (no bodies).

Mark a "to learn" topic as learned, seeding its spaced-repetition schedule from an initial confidence (1-10).

Record a spaced-repetition review for a learned topic that YOU (the model) quizzed and graded. The backend generates NO questions here — you write the questions, ask the user, judge their answers, then call this to log the result and advance the SM-2 schedule. Pass the user's self-rated confidence (1-10) and optionally quiz_score (0-1) plus the graded questions. The topic must already be learned (use mark_learned first). Use list_due_reviews to find topics that are due.

Update an existing topic. Only the fields you pass are changed. Markdown fields replace the stored body. Changing parent_id re-files the topic (and inherits the parent's subject).