# 💾 Job State

**Resume interrupted tasks automatically**

---

## 💡 What Is It?

Saves progress after each completed task. If script crashes or stops, it resumes exactly where it left off.

🔁 **New:** Completed accounts are tracked per day. When you restart the bot after a failure, it skips accounts already finished and jumps directly to the remaining ones.

**Already enabled by default!**

---

## ⚡ How It Works

### Progress Tracking

```
sessions/job-state/
├── account1@email.com/
│   ├── daily-set-2025-10-16.json
│   ├── desktop-search-2025-10-16.json
│   └── mobile-search-2025-10-16.json
└── account2@email.com/
    └── ...
```

- ✅ **Per-account** — Independent progress
- ✅ **Date-specific** — Fresh start each day
- ✅ **Auto-cleanup** — Old files remain for history

---

## 🎯 Benefits

### Interrupted Runs

| Scenario | Without Job State | With Job State |
|----------|-------------------|----------------|
| **Power outage** | Start from beginning | Resume from last task |
| **Manual stop** | Lose all progress | Pick up where left off |
| **Network failure** | Redo everything | Continue remaining tasks |

---

## ⚙️ Configuration

**Already enabled:**
```jsonc
{
  "jobState": {
    "enabled": true,
    "skipCompletedAccounts": true, // Skip accounts already finished today
    "dir": ""  // Empty = use default location
  }
}
```

**Custom location:**
```jsonc
{
  "jobState": {
    "enabled": true,
    "skipCompletedAccounts": true,
    "dir": "/custom/path/job-state"
  }
}
```

> ℹ️ Set `skipCompletedAccounts` to `false` (or export `REWARDS_DISABLE_ACCOUNT_SKIP=1`/`true`) if you need to force every pass to run all accounts—for example when using `passesPerRun` > 1 or when intentionally repeating the whole rotation in the same day.

---

## 🧹 Maintenance

### Reset Progress (Fresh Start)

```powershell
# Reset all accounts
Remove-Item -Recurse -Force sessions/job-state/

# Reset one account
Remove-Item -Recurse -Force sessions/job-state/user@email.com/
```

### Cleanup Old Files

```powershell
# Keep last 7 days only
Get-ChildItem sessions/job-state -Recurse -Filter "*.json" | Where-Object {$_.LastWriteTime -lt (Get-Date).AddDays(-7)} | Remove-Item
```

---

## 🛠️ Troubleshooting

| Problem | Solution |
|---------|----------|
| **Tasks not resuming** | Check file permissions |
| **Duplicate execution** | Ensure system time is accurate |
| **Excessive files** | Implement cleanup schedule |

---

## 📚 Next Steps

**Need scheduler?**  
→ **[Scheduler Guide](./schedule.md)**

**Want diagnostics?**  
→ **[Diagnostics Guide](./diagnostics.md)**

---

**[← Back to Hub](./index.md)** | **[Config Guide](./config.md)**