learning

type CardState struct {
	Stability   float64
	Difficulty  float64
	ReviewCount int
}

type ConceptForReview struct {
	ID          uuid.UUID
	Title       string
	Content     string
	ReviewCount int
	Stability   float64
}

type ConceptHistoryRow struct {
	ID              uuid.UUID  `json:"id"`
	Title           string     `json:"title"`
	Tags            []string   `json:"tags"`
	ReviewCount     int        `json:"review_count"`
	FirstReviewedAt *time.Time `json:"first_reviewed_at,omitempty"`
	LastReviewedAt  *time.Time `json:"last_reviewed_at,omitempty"`
	IntervalDays    float64    `json:"interval_days"`
	NextReviewAt    *time.Time `json:"next_review_at,omitempty"`
	Status          string     `json:"status"` // "new"|"learning"|"reviewing"|"mastered"
}

type DueReview struct {
	ConceptID   uuid.UUID `json:"concept_id"`
	ScheduleID  uuid.UUID `json:"schedule_id"`
	Title       string    `json:"title"`
	Content     string    `json:"content"`
	Stability   float64   `json:"stability"`
	Difficulty  float64   `json:"difficulty"`
	DueDate     time.Time `json:"due_date"`
	ReviewCount int       `json:"review_count"`
}

type LearningStatsResult struct {
	TotalReviews  int `json:"total_reviews"`
	Reviews7d     int `json:"reviews_7d"`
	Mastered      int `json:"mastered"`
	TotalConcepts int `json:"total_concepts"`
	StreakDays    int `json:"streak_days"`
}

type Rating int

type Store struct {
	// contains filtered or unexported fields
}

type StoreIface interface {
	CreateConcept(ctx context.Context, title, content string, tags []string) (*db.Concept, error)
	DueReviews(ctx context.Context, limit int) ([]DueReview, error)
	// GetScheduleState returns the current CardState for scheduleID, scoped
	// to the store's configured workspace. Returns ErrNotFound when no
	// review_schedule row matches. Ω7 fix (mcp-surface spec, backend-
	// security-design.md §2.1 — LLM tool input is adversarial): submit_review
	// used to accept stability/difficulty/review_count as caller-supplied
	// "current state" params instead of the MCP handler reading them from
	// here; an omitted/zero review_count silently routed a mature schedule
	// through SubmitReview's initial-review branch and overwrote it with a
	// fresh, much shorter interval. SubmitReview's own currentState
	// parameter is unchanged (still used directly by internal/handler's HTTP
	// path and internal/scheduler) — this is an additive method, not a
	// signature change to SubmitReview.
	GetScheduleState(ctx context.Context, scheduleID uuid.UUID) (CardState, error)
	SubmitReview(ctx context.Context, scheduleID uuid.UUID, currentState CardState, rating Rating) error
	CountDueReviews(ctx context.Context) (int, error)
	ListForAIReview(ctx context.Context, minReviewCount int) ([]ConceptForReview, error)
	UpdateConceptStatus(ctx context.Context, id uuid.UUID, status string) error
	// ReviewHistory returns all concepts with their review summary, sorted by
	// last_reviewed_at DESC NULLS LAST (new concepts appear last).
	ReviewHistory(ctx context.Context) ([]ConceptHistoryRow, error)
	// LearningStats returns aggregate stats across all concepts and reviews.
	LearningStats(ctx context.Context) (*LearningStatsResult, error)
	// ListConcepts returns up to limit concepts ordered by created_at DESC,
	// scoped to the configured workspace.
	ListConcepts(ctx context.Context, limit int) ([]db.Concept, error)
	// ReviewedSince returns review_schedule rows where last_review_at >= since,
	// scoped to the configured workspace. Used by the timeline aggregator.
	ReviewedSince(ctx context.Context, since time.Time, limit int) ([]DueReview, error)
}