Learn Review

Learn Review

Reviews facts in workspace/learning/facts/ whose next_review date is today or in the past. Applies SM-2 grading and rewrites frontmatter in-place. Records every grade in workspace/learning/.state/review-log.jsonl.

SM-2 Formula (implement exactly as specified)

Given current reps, interval, ease, lapses:

Again (grade 0):

• reps = 0
• interval = 1
• ease = max(1.3, ease - 0.2) (round to 2 decimal places)
• lapses = lapses + 1

Hard (grade 3):

• interval = round(interval * 1.2) (minimum 1)
• ease = max(1.3, ease - 0.15) (round to 2 decimal places)
• reps = reps + 1

Good (grade 4):

• If reps == 0: interval = 1
• Else if reps == 1: interval = 6
• Else: interval = round(interval * ease) (minimum 1)
• ease is unchanged
• reps = reps + 1

Easy (grade 5):

• Same interval as Good, then additionally: interval = round(interval * 1.3) (minimum 1)
• ease = ease + 0.15 (round to 2 decimal places)
• reps = reps + 1

For all grades: next_review = review_date + interval days

Ease floor: 1.3. Never let ease drop below 1.3 regardless of how many Again grades.

Workflow

Step 1 — Scan for due facts

1. Read all .md files in workspace/learning/facts/