📊 Reading Analytics

let tracker = ReadingSpeedTracker.shared

// Record a reading sample
tracker.recordSample(
    articleTitle: "AI in 2026",
    feedName: "TechCrunch",
    wordCount: 1200,
    readingTimeSeconds: 300
)

// Get estimated reading time for a new article
let estimate = tracker.estimatedReadingTime(wordCount: 800)  // TimeInterval
let formatted = tracker.formattedEstimate(wordCount: 800)    // "3 min read"

// Trend analysis
let trend = tracker.speedTrend(days: 30)  // .improving, .declining, .stable

// Breakdowns
let byFeed = tracker.feedBreakdown()      // [SpeedBreakdown]
let byCat = tracker.categoryBreakdown()   // [SpeedBreakdown]

// Where you stand
let percentile = tracker.populationPercentile()  // 0-100
let label = tracker.speedLabel()                  // "Fast reader"

// Full profile
let profile = tracker.buildProfile()  // SpeedProfile

let mood = ReadingMoodTracker.shared

// Log a mood entry
mood.logMood(
    level: .good,
    note: "Interesting AI article",
    feedName: "Hacker News",
    articleLink: "https://..."
)

// Query
let today = mood.todayEntries()
let current = mood.currentMood()
let avg = mood.averageMood(from: weekAgo)  // Double?
let shifts = mood.moodShifts()             // [MoodShift]

// Discover mood-boosting feeds
let impacts = mood.feedMoodImpact()          // [FeedMoodImpact]
let boosters = mood.moodBoosterFeeds()       // positive-delta feeds only
let suggestions = mood.moodBasedSuggestions() // feed suggestions by mood

// Export
let report = mood.moodReport(from: monthAgo, to: Date())
let export = mood.exportEntries()  // JSON-compatible

let streak = ReadingStreakTracker.shared

// Record reading activity (returns updated stats)
let stats = streak.recordArticleRead(goalTarget: 3)
// or record multiple at once:
let stats2 = streak.recordArticles(count: 5, goalTarget: 3)

// Current stats
let s = streak.getStats()
// s.currentStreak     — consecutive days reading
// s.bestStreak        — all-time longest streak
// s.totalArticlesRead — cumulative total
// s.todayCount        — articles read today
// s.goalMetToday      — whether today's goal is met

// Historical data
let record = streak.record(for: someDate)   // DailyReadingRecord?
let range = streak.records(from: start, to: end)

// Weekly summaries (articles per day, average, best day)
let weeks = streak.weeklySummaries(weeks: 4)

// Goal-based streak (days in a row meeting the goal)
let goalStreak = streak.goalStreakDays(last: 30)

let insights = ReadingInsightsGenerator.shared

// Generate a report
let report = insights.generateWeeklyInsight(
    from: readEvents,
    endDate: Date()
)

let monthly = insights.generateMonthlyInsight(
    from: readEvents,
    endDate: Date()
)

// Latest saved report
let last = insights.latestReport(for: .weekly)

// Export
let text = insights.exportAsText(report)
let json = insights.exportAsJSON(report)

let journal = ReadingJournalManager.shared

// Automatic recording (called by FeedReader internally)
journal.recordArticleRead(
    link: url, title: title,
    feedName: feed, timeSpent: seconds
)
journal.recordHighlight(text: excerpt, articleTitle: title)
journal.recordNote(text: note, articleTitle: title)

// Manual entries
journal.addReflection("Great deep-dive day")
journal.addMoodTag(.positive)

// Query
let today = journal.todayEntry()
let entry = journal.entry(for: someDate)
let range = journal.entries(from: start, to: end)

// Export
let md = journal.exportMarkdown(for: someDate)
let mdRange = journal.exportMarkdownRange(from: start, to: end)
let json = journal.exportJSON()

// Digests
let weekly = journal.weeklyDigest()
let monthly = journal.monthlyDigest()

// Streaks
let streak = journal.currentStreak  // consecutive days with entries

let budget = ReadingTimeBudget.shared

// Set a daily target (in minutes)
var config = budget.getConfig()
config.dailyTargetMinutes = 30
config.warningThresholdPercent = 80  // warn at 80% of budget
budget.updateConfig(config)

// Start/stop reading
budget.startSession(
    articleTitle: "AI Safety in Practice",
    feedName: "Alignment Forum",
    wordCount: 2400
)
let entry = budget.stopSession()

// Query entries
let todayEntries = budget.entries(on: Date())
let weekEntries = budget.entries(from: weekAgo, to: Date())

// Time analysis
let todayTotal = budget.todayTotal()       // TimeInterval
let remaining = budget.remainingToday()     // TimeInterval
let progress = budget.dailyProgress()       // 0.0 – 1.0+
let exceeded = budget.isOverBudget()        // Bool

// Breakdowns
let byFeed = budget.feedBreakdown(from: weekAgo, to: Date())
let byCat = budget.categoryBreakdown(from: weekAgo, to: Date())
let byHour = budget.hourlyDistribution(days: 7)
let trend = budget.dailyTrend(days: 14)

// Suggestions
let suggestions = budget.budgetSuggestions()  // personalized tips

let sessions = ReadingSessionTracker.shared

// Basic flow
let session = sessions.startSession(tag: "morning-reading")
sessions.startArticle(link: url, title: title, feedName: feed)
sessions.finishArticle()
let completed = sessions.endSession()

// Query
let recent = sessions.sessions(lastDays: 7)
let tagged = sessions.sessions(withTag: "morning-reading")
let byId = sessions.session(byId: sessionId)

// Summaries
let summary = sessions.summary(for: recent)
// summary.totalDuration, summary.activeTime, summary.totalArticles,
// summary.avgArticlesPerSession, summary.avgSessionDuration

let achievements = ReadingAchievementsManager.shared

// Check progress
let all = achievements.allProgress()
let unlocked = achievements.unlockedAchievements()
let locked = achievements.lockedAchievements(includeSecrets: true)

// Filter
let streakBadges = achievements.achievements(in: .consistency)
let epics = achievements.achievements(ofRarity: .epic)

// Leveling
let level = achievements.currentLevel()
let points = achievements.totalPoints()
let toNext = achievements.pointsToNextLevel()

// Text summary
let summary = achievements.textSummary()

let exporter = ReadingDataExporter.shared

// Export
let (data, error) = exporter.exportData(options: .all)
let (fileSize, err) = exporter.exportToFile(url: backupUrl)

// Validate before importing
let warnings = exporter.validateArchive(data)
let preview = exporter.previewArchive(data)
// preview.version, preview.exportDate, preview.itemCounts

// Import
let result = exporter.importData(data, strategy: .merge)
// result.imported, result.skipped, result.errors