How bvazrala/recall works
Recall is an early scaffold for text-message spaced repetition: the intended loop is study material intake, question/review delivery, answer grading, and FSRS rescheduling, with a dashboard and database supporting it. Currently, the visible working pieces are the dashboard’s example API request, server routes, student schema, and core FSRS scheduling; README explicitly says grading, inbound handling, and agent behavior are not built. The database and Photon schemas show planned capabilities, not a verified runtime pipeline. Edges are limited to README or indexed-source evidence.
Main entry points: students.ts Student records · index.ts Mastra server · src Core domain stubs · cards.ts Cards and questions
Components 19
Student experience
- Dashboard
apps/web/src/app/dashboard/page.tsx - API client
apps/web/src/lib/api.ts
API and agent
- Mastra server
apps/server/src/mastra/index.ts - Example route
apps/server/src/mastra/routes/example.ts - Status route
apps/server/src/mastra/routes/status.ts - LLM agent
apps/server/src/mastra/agents/agent.ts
Study logic
- Core domain stubs
packages/core/src - Demo clock
packages/core/src/clock.ts - Answer rating
packages/core/src/fsrs/rating.ts - FSRS scheduler
packages/core/src/fsrs/scheduler.ts
Persistence
- Database client
packages/db/src/client.ts - Student records
packages/db/src/schema/students.ts - Files and passages
packages/db/src/schema/notes.ts - Cards and questions
packages/db/src/schema/cards.ts - Quiz sessions and reviews
packages/db/src/schema/quiz.ts - Message records
packages/db/src/schema/messages.ts
Messaging
- Photon app card
photon/src/app-card.ts - Text messaging
Other components
- Student
Connections 18
- Student → Dashboard: views
- Dashboard → API client: requests data
- API client → Example route: calls endpoint
- Mastra server → Example route: registers
apps/server/src/mastra/index.ts - Mastra server → Status route: registers
apps/server/src/mastra/index.ts - Mastra server → LLM agent: configures
apps/server/src/mastra/index.ts - Core domain stubs → Demo clock: exports
packages/core/src/index.ts - Core domain stubs → FSRS scheduler: exports
packages/core/src/index.ts - FSRS scheduler → Answer rating: uses rating type
packages/core/src/fsrs/scheduler.ts - Database client → Student records: loads schema
packages/db/src/client.ts - Cards and questions → Student records: references
packages/db/src/schema/cards.ts - Cards and questions → Files and passages: references passages
packages/db/src/schema/cards.ts - Quiz sessions and reviews → Cards and questions: references
packages/db/src/schema/quiz.ts - Quiz sessions and reviews → Student records: references
packages/db/src/schema/quiz.ts - Message records → Student records: references
packages/db/src/schema/messages.ts - Text messaging → Photon app card: may use app card
- Student → Text messaging: texts answers
- Core domain stubs → Answer rating: exports
packages/core/src/index.ts