# 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
