xp_nix/xp_server/ROADMAP.md

95 lines
4.0 KiB
Markdown

# 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