🔍 Smart AI Detection System

• Large Insertion Analysis: Detects code blocks of 30+ characters
• Extension Monitoring: Real-time tracking of GitHub Copilot, TabNine, Kite, CodeWhisperer
• Rapid Typing Detection: Identifies superhuman typing speeds (>50 chars/sec)
• Clipboard Monitoring: Detects external pastes from ChatGPT, Claude, etc.
• Pattern Recognition: AI comment signatures and code patterns
• Multi-layered Approach: Combined detection methods for improved accuracy

📊 Comprehensive Tracking

• Language Statistics: Time breakdown by programming language
• Project Analytics: Per-project time allocation
• Session Management: Detailed records with start/end times
• Idle Detection: Configurable timeout (default: 5 minutes)
• Live Updates: Real-time dashboard refresh (2-second intervals)

📊 Dashboard Components

• Today's Overview:

  • Real-time human vs AI coding pie chart
  • Current session duration
  • Progress towards daily goal
  • Productivity score gauge

• Weekly Trends:

  • 7-day tracking comparing human/AI coding ✅
  • Daily productivity scores ✅
  • Basic session analysis ✅

• Monthly Analysis:

  • 30-day overview ✅
  • Language distribution charts ✅
  • Achievement progress tracker ✅

• Advanced Metrics:

  • Focus Score: Based on session length and consistency ✅
  • AI Dependency Index: Basic tracking of AI tool usage ✅
  • Efficiency Rating: Basic productivity metrics ✅

🎯 Achievement Categories

🎮 Achievement Notifications

• Toast notifications with simple animations ✅
• Achievement gallery in dashboard ✅
• Progress bars for upcoming achievements ✅

📊 Goal Features

• Customizable Daily Goals:

  • Set hourly targets
  • Separate goals for human vs AI coding
  • Weekend vs weekday differentiation

• Progress Tracking:

  • Real-time progress bars
  • Milestone notifications (25%, 50%, 75%, 100%)
  • Streak tracking for consecutive goal achievements

• Goal Analytics:

  • Success rate tracking ✅
  • Average achievement time ✅

📈 Export Capabilities

• Multi-format Support:

  • JSON with complete session details ✅
  • CSV for spreadsheet analysis ⚠️ (Basic)

• Integration Ready:

  • Compatible with Excel/Google Sheets ✅

{
  // 🔄 Core Functionality
  "humanai-tracker.enableTracking": true, // Master on/off switch
  "humanai-tracker.idleTimeout": 300, // Idle detection (seconds)
  "humanai-tracker.dailyGoal": 240, // Daily goal (minutes)
  "humanai-tracker.trackOnStartup": true, // Auto-start tracking

  // 🎨 Interface & Notifications
  "humanai-tracker.showStatusBar": true, // Status bar visibility
  "humanai-tracker.statusBarAlignment": "left", // Status bar position
  "humanai-tracker.showNotifications": true, // Toast notifications
  "humanai-tracker.notificationLevel": "all", // all | achievements | none
  "humanai-tracker.enableAchievements": true, // Achievement system
  "humanai-tracker.achievementNotifications": true, // Achievement popups
  "humanai-tracker.goalReminders": true, // Goal progress reminders
  "humanai-tracker.reminderInterval": 60, // Reminder frequency (minutes)

  // 📊 Dashboard & Display
  "humanai-tracker.dashboardTheme": "dark", // dark | light | auto
  "humanai-tracker.chartAnimations": true, // Enable chart animations
  "humanai-tracker.refreshInterval": 2000, // Dashboard refresh (ms)
  "humanai-tracker.dateFormat": "MM/DD/YYYY", // Date display format
  "humanai-tracker.timeFormat": "12h", // 12h | 24h
  "humanai-tracker.firstDayOfWeek": "monday" // monday | sunday
}

{
  // 🔍 Detection Patterns & Keywords
  "humanai-tracker.aiPatterns": [
    // AI Tools & Extensions
    "copilot",
    "github.copilot",
    "tabnine",
    "kite",
    "codewhisperer",
    "intellicode",
    "codota",
    "deepcode",

    // AI Services
    "chatgpt",
    "claude",
    "bard",
    "gemini",
    "bing-chat",
    "openai",
    "anthropic",
    "perplexity",
    "phind",

    // AI Comments & Markers
    "ai-generated",
    "generated by",
    "assisted by",
    "suggested by copilot",
    "autocompleted"
  ],

  // ⚡ Detection Sensitivity & Thresholds
  "humanai-tracker.minAiInsertionSize": 30, // Min chars for AI detection
  "humanai-tracker.multilineThreshold": 3, // Min lines for multi-line detection
  "humanai-tracker.detectLargePastes": true, // External paste detection
  "humanai-tracker.pasteThreshold": 50, // Min paste size (chars)
  "humanai-tracker.rapidTypingThreshold": 150, // Chars per minute threshold
  "humanai-tracker.rapidTypingWindow": 5, // Detection window (seconds)

  // 🎯 Advanced Detection
  "humanai-tracker.detectPatternMatching": true, // Code pattern analysis
  "humanai-tracker.detectSyntaxPatterns": true, // AI syntax signatures
  "humanai-tracker.confidenceThreshold": 0.7, // Min confidence (0-1)
  "humanai-tracker.mlDetection": false, // Machine learning (beta)

  // 🛠️ Manual Override
  "humanai-tracker.allowManualOverride": true, // Enable manual classification
  "humanai-tracker.overridePersistence": true, // Remember manual overrides
  "humanai-tracker.showOverrideButton": true // Quick override in status bar
}

{
  // 📈 Data Collection Scope
  "humanai-tracker.trackLanguages": true, // Language-specific tracking
  "humanai-tracker.trackProjects": true, // Project-based analytics
  "humanai-tracker.trackFiles": false, // Individual file tracking
  "humanai-tracker.trackBranches": true, // Git branch tracking
  "humanai-tracker.excludePatterns": [
    // Ignore patterns
    "**/node_modules/**",
    "**/dist/**",
    "**/*.min.js"
  ],

  // 🎯 Goals & Productivity
  "humanai-tracker.weeklyGoal": 1200, // Weekly goal (minutes)
  "humanai-tracker.monthlyGoal": 5000, // Monthly goal (minutes)
  "humanai-tracker.productivityCalculation": "balanced", // balanced | strict | relaxed
  "humanai-tracker.focusSessionMinimum": 25, // Min session for focus (minutes)
  "humanai-tracker.breakReminders": true, // Health break reminders
  "humanai-tracker.breakInterval": 50, // Break reminder interval (minutes)

  // 💾 Data Management
  "humanai-tracker.autoExport": false, // Automatic data export
  "humanai-tracker.autoExportInterval": 7, // Export frequency (days)
  "humanai-tracker.autoExportFormat": "json", // json | csv | both
  "humanai-tracker.exportPath": "~/humanai-exports", // Export directory
  "humanai-tracker.dataRetention": 365, // Data retention (days)
  "humanai-tracker.compressOldData": true // Compress data older than 30 days
}

{
  // 🎨 Visual Customization
  "humanai-tracker.accentColor": "#007ACC", // Primary accent color
  "humanai-tracker.successColor": "#4CAF50", // Success/achievement color
  "humanai-tracker.warningColor": "#FF9800", // Warning/alert color
  "humanai-tracker.chartColors": {
    // Chart color scheme
    "human": "#4CAF50",
    "ai": "#2196F3",
    "idle": "#9E9E9E"
  },

  // 🏆 Achievement Customization
  "humanai-tracker.achievementStyle": "banner", // banner | toast | subtle
  "humanai-tracker.achievementSound": true, // Play sound on unlock
  "humanai-tracker.achievementDuration": 5000, // Display duration (ms)

  // 📱 Status Bar Customization
  "humanai-tracker.statusBarFormat": "emoji", // emoji | text | minimal
  "humanai-tracker.statusBarDetails": "full", // full | simple | time-only
  "humanai-tracker.statusBarTooltip": true, // Show detailed tooltip
  "humanai-tracker.statusBarPriority": 100 // Position priority
}

🔧 Detection Confidence Levels

• Implemented: Direct API integration or clear patterns (GitHub Copilot)
• Basic: Pattern matching and heuristics (Large insertions, clipboard)
• Limited: Simple detection methods (Speed analysis)
• Manual Override: User can always correct classification

📈 Tracking Optimization

• ✅ Always On: Keep tracking enabled during all coding sessions
• ✅ Realistic Goals: Start with 2-3 hours daily, increase gradually
• ✅ Weekly Reviews: Every Friday, analyze your week's patterns
• ✅ Manual Classification: Use for external AI tools (ChatGPT, Claude)
• ✅ Regular Exports: Monthly backups for data safety
• ✅ Project Tags: Use workspace detection for accurate project tracking

🎯 Goal Setting Strategy

• 🎯 SMART Goals: Specific, Measurable, Achievable, Relevant, Time-bound
• 📈 Progressive Overload: Increase by 10-15% when consistently hitting goals
• 🔄 Seasonal Adjustments: Lower during holidays, higher during sprints
• 🏆 Achievement Targeting: Pick 1-2 achievements to focus on weekly
• 📊 Data-Driven: Use last month's average as baseline
• 🎮 Gamify Progress: Compete with yourself, not others

🤖 AI Usage Balance

• ⚖️ Balanced Approach: Aim for sustainable AI/human balance
• 🧠 AI for Boilerplate: Use AI for repetitive tasks
• 📚 Learning Sessions: Practice without AI assistance
• 🔍 Pattern Analysis: Review detected AI usage
• 🎓 Skill Building: Gradually build coding confidence
• 🚀 Productivity Mode: Use AI for time-critical tasks

🧘 Health & Wellness

• 🧘 Focus Sessions: Track concentration periods
• 👀 Eye Care: Remember to look away regularly
• 🏃 Movement: Encourage regular breaks
• 😴 Work-Life Balance: Monitor coding hours
• 🎵 Environment: Create productive workspace

❌ Extension Not Tracking Time

Diagnosis Checklist:
✓ Check status bar shows "Tracking Active"
✓ Verify icon appears in Activity Bar
✓ Ensure VS Code has file permissions
✓ Check Output panel for errors (View > Output > HumanAI Tracker)

Solutions:
1. Toggle tracking off/on via status bar
2. Restart VS Code
3. Reinstall extension
4. Check conflicting extensions

🤖 AI Detection Issues

Common Causes:
- AI tool not in pattern list
- Detection threshold too high
- Extension conflicts
- Rapid typing flagged incorrectly

Fixes:
1. Add pattern: Settings > AI Patterns > Add your tool
2. Lower threshold: minAiInsertionSize = 20
3. Use manual override: Ctrl+Shift+A/H
4. Report false positives via GitHub Issues

📊 Dashboard Not Loading

Troubleshooting Steps:
1. Check internet (Chart.js CDN required)
2. Clear VS Code cache
3. Try different browser if using external
4. Check Console: Help > Toggle Developer Tools
5. Verify no firewall blocking CDN

Quick Fix:
- Close all dashboard tabs
- Restart VS Code
- Reopen dashboard

📈 Inaccurate Metrics

Verification Process:
1. Check timezone settings
2. Verify idle timeout configuration
3. Review manual overrides log
4. Ensure single VS Code instance
5. Check for time sync issues

Calibration:
- Reset daily stats
- Adjust detection sensitivity
- Enable debug logging
- Monitor for patterns

💾 Data Export Problems

Export Checklist:
✓ Sufficient disk space
✓ Write permissions in export folder
✓ Valid export path in settings
✓ No special characters in path

Alternative Export:
1. Copy from: ~/.vscode/globalStorage/humanai-tracker/
2. Use Command Palette > Developer: Open Storage
3. Manual JSON extraction

• 🎨 Theme Sync: Dashboard adapts to VS Code theme ✅