[LingyiChen-AI]

Summary

Adds a Year in Review window on both Windows and macOS with four tabs: Activity Wall, Keyboard Personality, Active Hours and Achievements. All charts follow the heatmap color scheme from #152.

Entry points:

• Windows: a "Year in Review" button in the stats popup header, and a tray menu item
• macOS: a calendar icon in the stats popover toolbar

1. Activity Wall

• GitHub-style daily grid with columns for weeks and rows for Mon–Sun
• Range: past 12 months, or any calendar year that has data
• Metric: key presses or clicks
• Four quartile color levels that match the legend
• Summary cards: total, active days, current streak, longest streak, best day

2. Keyboard Personality

Covers today, the last 7 days, the last 30 days or all time.

Metrics: shortcut ratio, regret index (Backspace/Delete share), copy vs. paste, undo count, arrow-key share, clicks per 100 keys and top keys.

Picks one main personality from Shortcut Master, Copy-Paste Engineer, Perfectionist, Arrow Key Walker, Mouse Person, Keyboard Purist and Balanced Player. Any other personalities that also match are shown as secondary tags. The rules live in a pure analyzer that is identical on both platforms.

3. Active Hours

• 24-hour chart of the daily average per hour
• Peak hour, night share (22:00–05:00) and chronotype: Night Owl, Early Bird, Afternoon Person or Evening Person
• Windows: DailyStats gains optional hourlyKeyPresses / hourlyClicks arrays, recorded per local hour.
  • Legacy data reads as zeros
  • Import merge sums the arrays per hour
  • The arrays are not part of the sync protocol
• macOS: reuses the existing HourlyStats data, so the data layer is unchanged.

4. Achievements

16 milestones:

• Total keys: 100K / 1M / 10M
• Keys in a single day: 10K / 30K / 50K
• Total clicks: 100K / 1M
• Streaks: 7 / 30 / 100 days
• Active days: 100 / 365
• Peak speed: 10 / 15 KPS
• Mouse Marathon: 42.195 km, using the user's distance calibration

Locked cards show progress. Unlocks are evaluated every 60 s:

• On the first run, milestones that are already reached are backfilled silently.
• After that, each new unlock shows a system notification. This can be turned off in notification settings and is on by default.

New settings:

Key	Default
unlockedAchievements (id → yyyy-MM-dd)	{}
achievementsInitialized	false
achievementNotificationsEnabled	true

Screenshots

All screenshots use synthetic data.

Windows

Activity Wall	Activity Wall (custom palette)

Keyboard Personality	Active Hours

Achievements

macOS

Activity Wall	Activity Wall (custom palette)

Keyboard Personality	Active Hours

Achievements (light)	Achievements (dark)

Test plan

• Windows: dotnet build passes with 0 warnings.
• Windows: 24 new unit tests pass, covering the persona, chronotype, hourly and achievement rules.
• Windows: the full suite still has 2 failing sync tests (SingleDeviceCodeWithoutAuthoritativeCount_RemainsAConflict, ManualTransportFailure_AddsSixtySecondRetryDelay). They fail on main too, so this PR does not cause them.
• macOS: all 134 swift test tests pass.
• macOS: screenshots were rendered by an offscreen harness built from this branch. Running the app from Xcode has not been checked yet.
• Windows: an existing settings.json / daily_stats.json without the new fields still loads.
• Merged with upstream main (fix(stats): attribute activity to foreground apps  #151, feat(heatmap): configurable heatmap color schemes (Windows + macOS) #152). The diff only contains the new features.