# Monitor Heartbeat Instructions

Updated: 2026-03-01

## Checks to Run This Tick

1. **Disk space** — run `df -h` and flag any filesystem over 85% used
2. **Process check** — verify the VeilCLI server is running: `pgrep -fl "node cli/index.js"` or `pgrep -fl "veil"`
3. **Error scan** — look for recent errors in `.veil/` log files (if any): `grep -r "ERROR\|CRITICAL" .veil/ --include="*.log" -l`
4. **Task backlog** — check if there are tasks stuck in `processing` for more than 10 minutes (indicates a hung agent)

## Alert Thresholds

| Metric | Warn | Alert |
|--------|------|-------|
| Disk usage | 80% | 90% |
| Processing tasks (stuck) | > 5 min | > 10 min |
| Error log entries | 5 | 20 |

## Notes

- This file is re-read on every tick — update it to change monitor behaviour without restarting the daemon
- To temporarily disable a check, comment it out with a `#` prefix in the checklist above
- To add a new check, add a numbered item to the list with clear pass/fail criteria