xp_nix/xp_server/ROADMAP.md

XP Productivity Monitor Enhancement Plan

Core Visual Enhancements

Cursor-Following XP Numbers

• Implementation: Create ephemeral transparent windows using Hyprland cursor position API
• Behavior: Spawn at cursor location, animate upward like RPG damage numbers, fade after 2-3 seconds
• Content: Show individual activity XP (+5, +12) and streak bonuses (+45 for 30min focus)
• Technical: Use GTK4/Qt overlay widgets with CSS animations, non-interactive windows
• Animation Style: Numbers fly upward and slightly outward, with color coding (green for regular XP, gold for bonuses)

Visual Progress Bars

Move from bottom bar to more prominent locations:

• Real-time XP bar: Center-screen or near active window
• Flow streak indicator: Shows consecutive focused minutes
• Daily mastery progress: Toward daily goals
• Consider: Game HUD positioning principles - important info near center/cursor area

Celebration System Overhaul

Level-Up Celebrations

• Major milestones (every 5 levels): Full-screen celebration using hyprlock
  • Custom image/message, dismissed with mouse/keyboard input
  • Limit to max 10 interruptions per day
• Regular levels: Enhanced cursor effects + optional sound
• Persistent stats: Continue using swaync for dismissible notifications

Dual Currency Shop System

Currency Types

1. XP Points (Cookie Clicker currency)

   • Earned through regular activity
   • Used for productivity upgrades and boosters
   • Creates meta-progression loop

2. Reward Tokens (Real-world currency)

   • Earned at slower rate from major achievements
   • Spent on actual purchases through automated system
   • Tier examples:
     • Small treats (drinks): 50-100 tokens
     • Tools/gadgets: 500-2000 tokens
     • Major purchases: 5000+ tokens

XP Shop Items (Rogue-lite/Ephemeral)

All XP shop purchases are temporary and reset daily/weekly:

• Shell History Analyzer (500 XP): +10% productivity bonus for today
• Calendar Integration (1000 XP): Meeting efficiency tracking for this week
• Code Complexity Analyzer (2000 XP): Debugging session bonuses for today
• AI Work Pattern Analyzer (5000 XP): Daily rhythm optimization for this week
• Focus Multipliers: 2x XP for next 1-3 hours
• Streak Protectors: Prevent losing streaks during breaks (single use)
• Power Hours: Enhanced XP gain and visual effects for set duration
• Deep Work Shield: Blocks distracting notifications temporarily

Real-World Shop

• One-click purchasing: Click to buy instantly orders the item
• Wishlist management: Pre-approved items with token costs
• Automatic fulfillment: Orders placed immediately upon purchase confirmation
• Purchase history: Track what you've earned and when

Environmental Feedback

Focus-Based Environmental Changes

• Progressive dimming: Gradually dim non-active windows during focus sessions
• Ambient soundscapes: Evolve with focus depth (toggleable for shared workspaces)
• Desktop enhancement: Theme changes based on current focus state, not just level

Technical Implementation Notes

Database Schema Updates

• Add tokens table for reward currency tracking
• Add shop_items table for available purchases
• Add unlocked_features table for XP shop progression
• Add purchase_history for real-world rewards

Configuration Additions

• Cursor animation settings (duration, style, frequency)
• Celebration thresholds and styles
• Shop item definitions and unlock requirements
• Sound settings with workspace-aware toggling

Integration Points

• Hyprland: Cursor position tracking, window management
• nwg-panel/waybar: Progress bar widgets (or custom solution)
• swaync: Enhanced notifications
• hyprlock: Celebration screens

Priority Implementation Order

1. Cursor-following XP animations
2. Dual currency system and database updates
3. XP shop with basic productivity upgrades
4. Enhanced celebration system
5. Environmental feedback features
6. Real-world purchase integration