feat: replace SM-2 with FSRS-5, add enrich/feedback/analytics/sync, expand content rules to 14

Author: adamaiken89

.editorconfig

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{yaml,yml}]
+indent_size = 2
+
+[Makefile]
+indent_style = tab

.mimocode/plans/1783290212134-nimble-moon.md

@@ -0,0 +1,30 @@
+# Fix: Code Review Issues (5 items from diff review)
+
+## Issues
+
+1. `scripts/learn.py:137` — `n_modules = n` assigned but never used
+2. `scripts/learn.py:139` — `topic_lower = topic.lower().strip()` computed but never used
+3. `scripts/learn.py:358` — `_validate_deck_file()` defined but never called
+4. (NIT) Auto-discover test sort order — skip, cosmetic only
+5. (NIT) `cmd_epub` long signature — skip, readability only
+
+## Fix Plan
+
+### scripts/learn.py
+
+**Line 137**: Delete `n_modules = n`
+
+**Line 139**: Delete `topic_lower = topic.lower().strip()`
+
+**Line 358-365**: Delete `_validate_deck_file()` entirely (unused dead code — `cmd_validate` does its own deck loading inline)
+
+### No other changes
+
+Tests pass as-is. These are dead code removals only.
+
+## Verification
+
+```bash
+python3 scripts/learn.py --help          # still works
+python3 tests/test_learn.py              # 59/59 pass
+```

AGENTS.md

@@ -1,12 +1,12 @@
 # Learn Anything
 
-Structured learning framework for any subject — study via CLI with spaced repetition (SM-2). Three-theory pedagogy: Marva Collins, Feynman Technique, Desirable Difficulties.
+Structured learning framework for any subject — study via CLI with spaced repetition (FSRS-5). Three-theory pedagogy: Marva Collins, Feynman Technique, Desirable Difficulties.
 
 ## Features
 
 - **Interactive curriculum creation**: LLM-driven syllabus + lesson + MCQ generation
 - **CLI study system**: read lessons, Feynman explain-back, MCQ drills, spaced repetition
-- **SM-2 spaced repetition**: optimal recall intervals, mixed-module interleaving
+- **FSRS-5 spaced repetition**: optimal recall intervals, mixed-module interleaving
 - **Cost-effective**: ~$0.10 per course creation, $0 per study session
 - **Portable**: Markdown files importable into Anki, Obsidian, Notion
 
@@ -24,7 +24,7 @@ learn.sh start <subject>         Show overview + modules
 learn.sh quiz <subject> <mod>    MCQ drill
 learn.sh explain <subject> <mod> Feynman technique prompt
 learn.sh feynman <subject> <mod> Alias for explain
-learn.sh review <subject>        SM-2 spaced repetition
+learn.sh review <subject>        FSRS-5 spaced repetition
 learn.sh stats <subject>         Progress + retention
 learn.sh export <subject>        Anki CSV export
 learn.sh epub <subject> [file]   Export course to EPUB book
@@ -41,7 +41,7 @@ subjects/<topic>/
 │   │   └── quiz.yaml   # 8-10 MCQs
 │   └── ...
 └── srs/
-    ├── deck.json       # SM-2 card state
+    ├── deck.json       # FSRS-5 card state
     └── stats.json      # Study history
 ```
 
@@ -59,7 +59,7 @@ subjects/<topic>/
 |---------|----------|-------|
 | **LEARN** | 45-60 min | Read lesson, reframe, MCQ drill |
 | **EXPLAIN** | 15-20 min | Feynman explain-back, AI gap detection |
-| **REVIEW** | 10-15 min | SM-2 spaced repetition (daily) |
+| **REVIEW** | 10-15 min | FSRS-5 spaced repetition (daily) |
 | **MIXED** | 30-45 min | REVIEW + LEARN + EXPLAIN combined |
 
 ## EPUB Generation

README.md

@@ -0,0 +1,67 @@
+# Content Verification — Evidence-Based Quality Check
+
+Load after each module generation. Verify against criteria below before presenting.
+
+## Checklist (from Content Design Mod17)
+
+- [ ] Concrete problem/example first, not abstract definition?
+- [ ] ≤2 concepts per section (~WM limit, CLT Mod2)?
+- [ ] Active engagement: cloze, predict, error-spot? (Retrieval Mod7, Feedback Mod12)
+- [ ] Immediate feedback after every exercise? (Feedback Mod12)
+- [ ] Non-redundant diagram for structure/relationships? (Dual Coding Mod6, Redundancy Effect CLT Mod2)
+- [ ] No extraneous fluff? (CLT Mod2 — extraneous load)
+- [ ] Builds on previous modules? (schema building, CLT Mod2)
+- [ ] Ends with retrieval opportunity (Feynman/Drill)? (Retrieval Mod7)
+
+## Redundancy Effect Check
+
+If same info appears through verbal AND visual channel simultaneously, mark violation:
+
+| Violation | Example | Fix |
+|-----------|---------|-----|
+| Diagram repeats text paragraph | Paragraph describing flowchart + same flowchart | Remove paragraph. Diagram alone sufficient. |
+| Narration + identical on-screen text | "The heart pumps blood" written AND narrated | Use narration OR text, not both (Mayer redundancy principle). |
+| Separate legend for self-labeled diagram | "Fig 1: A=heart, B=lungs" when labels already on diagram | Remove legend. Integrate labels onto diagram (spatial contiguity). |
+
+## Syntax Validation
+
+- [ ] All code blocks opened with ``` are closed?
+- [ ] Heading hierarchy valid (no skipped levels)?
+- [ ] Mermaid blocks have valid diagram type keyword?
+- [ ] Mermaid `style` statements use valid hex colors?
+- [ ] Mermaid `subgraph`/`end` blocks paired?
+- [ ] Links `[text](url)` and images `![alt](src)` well-formed?
+- [ ] Bold `**` and italic `*` markers properly closed?
+- [ ] Table header/separator column counts match?
+
+Run `learn.sh validate-content <topic> [module]` for automated checks.
+
+## Design Strategies (use ≥2 per module)
+
+| Strategy | Usage | Science |
+|----------|-------|---------|
+| **Chunking** | Break complex topics into 2-4 sub-topics per section | CLT Mod2 — WM ~4 chunk limit |
+| **Fading worked examples** | Full worked → partial (fill blanks) → independent | CLT Mod2 — worked example effect |
+| **Self-explanation prompts** | "Why does this step work?" after each claim | Deep Proc Mod5 — elaborative interrogation |
+| **Pre-training** | Introduce key terms before complex interaction | CLT Mod2 — reduced momentary intrinsic load |
+
+## 14 Quality Rules Reference
+
+| # | Rule | Science module |
+|---|------|----------------|
+| 1 | Explain conventions | CLT Mod2 (extraneous load) |
+| 2 | Answer implicit Qs | Deep Proc Mod5 (elaboration) |
+| 3 | Pull-to-par intuition | CLT Mod2 (causal chain) |
+| 4 | Causal chain first | CLT Mod2 + Deep Proc Mod5 |
+| 5 | Practical context | Deep Proc Mod5 (elaboration) |
+| 6 | "How likely" | Feedback Mod12 (prediction calibration) |
+| 7 | Common misconceptions | Error-Driven Learning Mod12 |
+| 8 | Socratic throughout | Deep Proc Mod5 (elaborative interrogation) |
+| 9 | Dual coding (non-redundant) | Dual Coding Mod6 + CLT Mod2 (redundancy) |
+| 10 | Concrete-first ordering | CLT Mod2 (schema building) |
+| 11 | Cloze deletions | Retrieval Practice Mod7 |
+| 12 | Predict-next | Error-Driven Learning Mod12 |
+| 13 | Error-spotting | Error-Driven Learning Mod12 |
+| 14 | Graduated examples | CLT Mod2 (fading worked examples) |
+
+If any item fails, rewrite affected section. Cite violated principle.

SKILL.md

@@ -0,0 +1,151 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://learn-anything.dev/schemas/cumulative_question.json",
+  "title": "Cumulative Quiz Question",
+  "description": "Schema for a single cumulative quiz question (mcq, cloze, or tf)",
+  "oneOf": [
+    { "$ref": "#/$defs/mcq" },
+    { "$ref": "#/$defs/cloze" },
+    { "$ref": "#/$defs/tf" }
+  ],
+  "$defs": {
+    "mcq": {
+      "type": "object",
+      "required": ["id", "type", "question", "source_modules", "options", "answer", "explanation", "difficulty", "tags"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^cum\\.\\d+$",
+          "description": "Question ID: cum.N"
+        },
+        "type": {
+          "type": "string",
+          "const": "mcq"
+        },
+        "question": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Question text"
+        },
+        "source_modules": {
+          "type": "array",
+          "items": { "type": "integer" },
+          "minItems": 1,
+          "description": "Module numbers this question covers"
+        },
+        "options": {
+          "type": "object",
+          "minProperties": 4,
+          "maxProperties": 4,
+          "additionalProperties": { "type": "string" },
+          "description": "Answer options with uppercase keys: A, B, C, D"
+        },
+        "answer": {
+          "type": "string",
+          "enum": ["A", "B", "C", "D"],
+          "description": "Correct answer key"
+        },
+        "explanation": {
+          "type": "string",
+          "description": "Why this answer is correct"
+        },
+        "difficulty": {
+          "type": "integer",
+          "enum": [1, 2, 3],
+          "description": "1=recall, 2=comprehension, 3=application"
+        },
+        "tags": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Content tags"
+        }
+      }
+    },
+    "cloze": {
+      "type": "object",
+      "required": ["id", "type", "question", "source_modules", "answer", "explanation", "difficulty", "tags"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^cum\\.\\d+$",
+          "description": "Question ID: cum.N"
+        },
+        "type": {
+          "type": "string",
+          "const": "cloze"
+        },
+        "question": {
+          "type": "string",
+          "description": "Sentence with {blank} for term to fill in"
+        },
+        "source_modules": {
+          "type": "array",
+          "items": { "type": "integer" },
+          "minItems": 1,
+          "description": "Module numbers this question covers"
+        },
+        "answer": {
+          "type": "string",
+          "description": "The term that fills the blank"
+        },
+        "explanation": {
+          "type": "string",
+          "description": "Why this term is correct"
+        },
+        "difficulty": {
+          "type": "integer",
+          "enum": [1, 2, 3],
+          "description": "1=recall, 2=comprehension, 3=application"
+        },
+        "tags": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Content tags"
+        }
+      }
+    },
+    "tf": {
+      "type": "object",
+      "required": ["id", "type", "statement", "source_modules", "answer", "explanation", "difficulty", "tags"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^cum\\.\\d+$",
+          "description": "Question ID: cum.N"
+        },
+        "type": {
+          "type": "string",
+          "const": "tf"
+        },
+        "statement": {
+          "type": "string",
+          "description": "Statement to evaluate as true or false"
+        },
+        "source_modules": {
+          "type": "array",
+          "items": { "type": "integer" },
+          "minItems": 1,
+          "description": "Module numbers this question covers"
+        },
+        "answer": {
+          "type": "boolean",
+          "description": "True if statement is correct, False if incorrect"
+        },
+        "explanation": {
+          "type": "string",
+          "description": "Why true/false, referencing concepts from source modules"
+        },
+        "difficulty": {
+          "type": "integer",
+          "enum": [1, 2, 3],
+          "description": "1=recall, 2=comprehension, 3=application"
+        },
+        "tags": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Content tags"
+        }
+      }
+    }
+  }
+}

content-verify.md

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://learn-anything.dev/schemas/cumulative_quiz.json",
+  "title": "Cumulative Quiz",
+  "description": "Schema for cumulative_quiz.yaml — cross-module quiz covering 3-5 modules",
+  "type": "array",
+  "items": { "$ref": "cumulative_question.schema.json" },
+  "minItems": 8,
+  "maxItems": 10
+}

learn-anything-schema/schemas/cumulative_question.schema.json

@@ -0,0 +1,66 @@
+/**
+ * Cumulative Quiz Question — cross-module question types (mcq, cloze, tf).
+ * Schema: https://learn-anything.dev/schemas/cumulative_question.json
+ */
+
+export interface CumulativeMCQ {
+  /** Question ID: cum.N */
+  id: string;
+  type: 'mcq';
+  /** Question text */
+  question: string;
+  /** Module numbers this question covers */
+  source_modules: number[];
+  /** Answer options with uppercase keys: A, B, C, D */
+  options: Record<string, string>;
+  /** Correct answer key */
+  answer: 'A' | 'B' | 'C' | 'D';
+  /** Why this answer is correct */
+  explanation: string;
+  /** 1=recall, 2=comprehension, 3=application */
+  difficulty: 1 | 2 | 3;
+  /** Content tags */
+  tags: string[];
+}
+
+export interface CumulativeCloze {
+  /** Question ID: cum.N */
+  id: string;
+  type: 'cloze';
+  /** Sentence with {blank} for term to fill in */
+  question: string;
+  /** Module numbers this question covers */
+  source_modules: number[];
+  /** The term that fills the blank */
+  answer: string;
+  /** Why this term is correct */
+  explanation: string;
+  /** 1=recall, 2=comprehension, 3=application */
+  difficulty: 1 | 2 | 3;
+  /** Content tags */
+  tags: string[];
+}
+
+export interface CumulativeTF {
+  /** Question ID: cum.N */
+  id: string;
+  type: 'tf';
+  /** Statement to evaluate as true or false */
+  statement: string;
+  /** Module numbers this question covers */
+  source_modules: number[];
+  /** True if statement is correct, False if incorrect */
+  answer: boolean;
+  /** Why true/false, referencing concepts from source modules */
+  explanation: string;
+  /** 1=recall, 2=comprehension, 3=application */
+  difficulty: 1 | 2 | 3;
+  /** Content tags */
+  tags: string[];
+}
+
+/** Discriminated union of all cumulative question types */
+export type CumulativeQuestion = CumulativeMCQ | CumulativeCloze | CumulativeTF;
+
+/** Cumulative quiz is an array of cross-module questions */
+export type CumulativeQuiz = CumulativeQuestion[];

learn-anything-schema/schemas/cumulative_quiz.schema.json

@@ -1,6 +1,7 @@
 export type { SRSCard } from './card';
 export type { SRSDeck } from './deck';
 export type { QuizQuestion, Quiz } from './question';
+export type { CumulativeQuestion, CumulativeMCQ, CumulativeCloze, CumulativeTF, CumulativeQuiz } from './cumulative_question';
 export type { Syllabus, SyllabusModule } from './syllabus';
 export type { SessionStats, StudySession } from './stats';
 export type { Feedback, ModuleRating, ContentFlag } from './feedback';