Roadmap: current state → origin story vision

[nickmeinhold]

The North Star

Get concept embeddings working, do a cross-source similarity pass at ingestion time, and watch the analogy edges appear on the animated graph for the first time. That moment when two unrelated documents suddenly bridge — that's the moment the app stops being a flashcard tool and becomes something new.
— docs/ORIGIN_STORY.md

Dependency Graph

FSRS Phase 2 (#89) → Phase 3 (#90) → Phase 4 (#91)
                                          │
                                          ├──→ #76 elaborative interrogation
                                          ├──→ #40 local-first (needs FSRS settled)
                                          │         └──→ #41 CRDT sync
                                          │
                   #39 embeddings ────────┼──→ confusion-based difficulty
                         │                │
                         └──→ #75 cross-source linking ──→ #74 video sync
                                    │
                              *** THE MOMENT ***

Independent: #78 interleaving, #77 dual coding, #51 incremental ingestion, #55 isolate layout

Execution Plan

Sprint	Main track	Parallel
1	FSRS Phase 2 (#89)	#78 interleaving
2	FSRS Phase 3 (#90)	Start #39 embeddings
3	FSRS Phase 4 (#91)	Finish #39 embeddings
4	#75 cross-source linking ← the moment
5	#77 dual coding	#51 incremental ingestion
6	#74 video sync
7	#76 elaborative interrogation
8+	#40 local-first → #41 CRDT sync

Current State (Feb 2026)

• ✅ FSRS Phase 1 merged (FSRS Phase 1: Add FSRS engine alongside SM-2 #59)
• ✅ Knowledge graph animation (velocity physics, viscous damping, centering gravity)
• ✅ Typed relationships with analogy type and color-coded edges
• ✅ Cooperative game complete (guardians, goals, glory board, storms, relays)
• ✅ Collection-scoped quiz sessions
• ✅ Extraction skill with difficulty prediction in schema

References

• docs/ORIGIN_STORY.md — the vision
• docs/FSRS_MIGRATION.md — scheduling migration plan
• docs/CRDT_SYNC_ARCHITECTURE.md — sync design
• docs/LOCAL_FIRST.md — storage migration plan