feat: add automatic task scheduling configuration for Windows and Linux

docs/schedule.md

@@ -1,10 +1,155 @@
-# External Scheduling
+# Automatic Task Scheduling
 
-The built-in scheduler has been removed. Use your operating system or orchestrator to trigger runs with full control over timing, retries, and monitoring.
+The bot can **automatically configure** your system's task scheduler when you run it for the first time. This works on:
+- ✅ **Windows** → Windows Task Scheduler
+- ✅ **Linux/Raspberry Pi** → cron
+- ✅ **macOS** → cron
 
 ---
 
-## Windows Task Scheduler
+## Quick Setup (Recommended)
+
+### 1. Edit your configuration
+
+Open `src/config.jsonc` and find the `scheduling` section:
+
+```jsonc
+{
+  "scheduling": {
+    "enabled": true,  // ← Change this to true
+    "type": "auto",   // ← Leave as "auto" for automatic detection
+    
+    // For Linux/Raspberry Pi/macOS:
+    "cron": {
+      "schedule": "0 9 * * *"  // ← Daily at 9 AM (customize if needed)
+    },
+    
+    // For Windows:
+    "taskScheduler": {
+      "schedule": "09:00",     // ← Daily at 9:00 AM (customize if needed)
+      "frequency": "daily"
+    }
+  }
+}
+```
+
+### 2. Run the bot once
+
+```bash
+npm run start
+```
+
+**That's it!** The bot will automatically:
+- Detect your operating system
+- Configure the appropriate scheduler (cron or Task Scheduler)
+- Set it up to run at your specified time
+- Show you a confirmation message
+
+### 3. Verify it worked
+
+**Linux/Raspberry Pi/macOS:**
+```bash
+crontab -l
+```
+You should see a line with `# Microsoft-Rewards-Bot`
+
+**Windows:**
+- Open Task Scheduler
+- Look for "Microsoft-Rewards-Bot" in the task list
+
+---
+
+## Configuration Examples
+
+### Example 1: Raspberry Pi - Run daily at 9 AM
+
+```jsonc
+{
+  "scheduling": {
+    "enabled": true,
+    "type": "auto",
+    "cron": {
+      "schedule": "0 9 * * *",
+      "logFile": "/home/pi/rewards.log"  // Optional: save logs here
+    }
+  }
+}
+```
+
+### Example 2: Windows - Run twice daily
+
+```jsonc
+{
+  "scheduling": {
+    "enabled": true,
+    "type": "auto",
+    "taskScheduler": {
+      "schedule": "09:00",    // First run at 9 AM
+      "frequency": "daily"
+    }
+  }
+}
+```
+
+For multiple times per day on Windows, you'll need to manually create additional tasks.
+
+### Example 3: Linux - Run on weekdays only at 2:30 PM
+
+```jsonc
+{
+  "scheduling": {
+    "enabled": true,
+    "type": "cron",
+    "cron": {
+      "schedule": "30 14 * * 1-5"  // 2:30 PM, Monday-Friday
+    }
+  }
+}
+```
+
+### Cron Schedule Examples
+
+Use [crontab.guru](https://crontab.guru) to create custom schedules:
+
+| Schedule | Description |
+|----------|-------------|
+| `0 9 * * *` | Every day at 9:00 AM |
+| `30 14 * * *` | Every day at 2:30 PM |
+| `0 9,21 * * *` | Every day at 9:00 AM and 9:00 PM |
+| `0 9 * * 1-5` | Weekdays at 9:00 AM (Monday-Friday) |
+| `0 */6 * * *` | Every 6 hours |
+| `0 8 * * 0` | Every Sunday at 8:00 AM |
+
+---
+
+## Disabling Automatic Scheduling
+
+To remove the scheduled task:
+
+1. Set `"enabled": false` in your config
+2. Run the bot once: `npm run start`
+3. The scheduler will be automatically removed
+
+Or manually remove it:
+
+**Linux/Raspberry Pi/macOS:**
+```bash
+crontab -e
+# Delete the line with "# Microsoft-Rewards-Bot"
+```
+
+**Windows:**
+- Open Task Scheduler
+- Find "Microsoft-Rewards-Bot"
+- Right-click → Delete
+
+---
+
+## Manual Configuration (Advanced)
+
+If you prefer manual setup or need more control, follow these platform-specific guides:
+
+### Windows Task Scheduler (Manual)
 
 1. Open Task Scheduler, choose **Create Basic Task...**, and name it `Microsoft Rewards Bot`.
 2. Pick a trigger (daily, weekly, at startup, etc.).
@@ -19,7 +164,7 @@ The built-in scheduler has been removed. Use your operating system or orchestrat
 
 ---
 
-## Linux / macOS (cron)
+## Linux / macOS (cron - Manual)
 
 1. Run `npm run start` once to confirm the project completes successfully.
 2. Edit the crontab: `crontab -e`.
@@ -33,7 +178,7 @@ Need multiple runs? Add more cron lines with different times (for example `0 9 *
 
 ---
 
-## Systemd Timer (Linux alternative)
+## Systemd Timer (Linux alternative - Manual)
 
 1. Create `/etc/systemd/system/rewards-bot.service`:
    ```ini
@@ -83,10 +228,38 @@ Need multiple runs? Add more cron lines with different times (for example `0 9 *
 
 ## Troubleshooting
 
-- Run `npm install` and `npm run build` after pulling updates.
-- Use absolute paths in scheduler commands.
-- Redirect output to a log file for easier debugging.
-- Execute `npm run start` manually after configuration changes to trigger the startup validator.
+**"cron is not installed"** (Linux/Raspberry Pi)
+```bash
+sudo apt-get update
+sudo apt-get install cron
+```
+
+**"Permission denied"** (Linux/Raspberry Pi)
+- The bot needs write access to crontab
+- Make sure you're running as the correct user
+
+**"Access denied"** (Windows)
+- Right-click PowerShell or Command Prompt
+- Choose "Run as Administrator"
+- Run `npm run start` again
+
+**Task not running at scheduled time:**
+1. Check your system's time and timezone
+2. Verify the schedule format is correct
+3. For cron: use [crontab.guru](https://crontab.guru) to validate
+4. Check logs to see if there are any errors
+
+**Manually check if scheduler is active:**
+
+**Linux/Raspberry Pi:**
+```bash
+crontab -l | grep "Microsoft-Rewards"
+```
+
+**Windows:**
+```powershell
+schtasks /Query /TN "Microsoft-Rewards-Bot" /FO LIST
+```
 
 ---