grok-reviewer-andresmgsl
8d6f902209
- Add scripts/lib/common.sh (ORG/BOT/FORGE_BACKEND, logging, process_running) - discover.sh: dedupe review-requested+assignee PRs; JSON+summary formats - discover.sh: FORGE_BACKEND=forgejo via Forgejo API + stoke token - Fix poll-loop process detection (basename, not install path) - health-check: jq-safe JSON; backend-aware auth (gh or stoke) - install-live: require rsync/jq/tmux; soft-warn missing gh/stoke - self-test.sh offline smoke; restore/poll-once use shared config - Docs: Forgejo table, watcher.env, OPERATIONS troubleshooting
81 lines
2.2 KiB
Markdown
81 lines
2.2 KiB
Markdown
# Operations runbook
|
|
|
|
## First-time setup
|
|
|
|
```bash
|
|
# 1. Clone
|
|
git clone https://github.com/grok-bot-andresmgsl/heavy-duty-watcher.git
|
|
# Forgejo mirror (if present):
|
|
# git clone https://forgejo.heavyduty.builders/grok-reviewer-andresmgsl/heavy-duty-watcher.git
|
|
cd heavy-duty-watcher
|
|
|
|
# 2. Auth (pick backend)
|
|
gh auth status # FORGE_BACKEND=github (default)
|
|
# stoke auth login # FORGE_BACKEND=forgejo
|
|
|
|
# 3. Optional overrides
|
|
cp config/watcher.env.example config/watcher.env
|
|
# edit ORG / BOT_LOGIN / FORGE_BACKEND as needed
|
|
|
|
# 4. Offline smoke
|
|
./scripts/self-test.sh
|
|
|
|
# 5. Install live + start tmux loops
|
|
./scripts/install-live.sh
|
|
|
|
# 6. In a Grok session: arm durable schedulers (15m poll + 1h health)
|
|
# Or restore interactive session:
|
|
./scripts/restore.sh
|
|
```
|
|
|
|
## After PC reboot / box restart
|
|
|
|
```bash
|
|
gh auth status
|
|
~/heavy-duty-watcher/scripts/restore.sh
|
|
# or:
|
|
~/heavy-duty-watcher/scripts/restore.sh --status
|
|
```
|
|
|
|
## Day-to-day
|
|
|
|
```bash
|
|
# What is waiting for us right now?
|
|
./scripts/discover.sh
|
|
|
|
# One-shot health
|
|
./scripts/health-check.sh
|
|
|
|
# Follow activity
|
|
tail -f logs/poll.log logs/health.log
|
|
|
|
# Attach tmux
|
|
tmux attach -t heavy-duty-watcher
|
|
```
|
|
|
|
## Schedulers (Grok)
|
|
|
|
When the agent is live, it should keep two durable recurring tasks:
|
|
|
|
1. **Poll every 15 minutes** — org-wide discovery + review
|
|
2. **Health every 1 hour** — `health-check.sh` + self-heal poll-loop
|
|
|
|
If either disappears, re-create from the prompts in `docs/SCHEDULER_PROMPTS.md`.
|
|
|
|
## Migration from `~/rig-watcher`
|
|
|
|
The original single-repo install lived at `~/rig-watcher`.
|
|
`install-live.sh` can symlink `~/rig-watcher` → `~/heavy-duty-watcher` for compatibility.
|
|
Item keys changed from `pr:N` to `heavy-duty/rig#pr:N`.
|
|
|
|
## Troubleshooting
|
|
|
|
| Symptom | Check |
|
|
|---------|--------|
|
|
| No reviews happening | `FORMAT=summary ./scripts/discover.sh` empty? Not requested. |
|
|
| Stale last_poll | `health-check.sh` WARN; is poll-loop alive? |
|
|
| gh 401 | `gh auth login` |
|
|
| stoke 401 | `stoke auth login` (Forgejo backend) |
|
|
| Duplicate spam | Inspect `state.json` `last_head_sha` / `last_action` |
|
|
| Scheduler missing | Re-arm via Grok; see `docs/SCHEDULER_PROMPTS.md` |
|
|
| `install-live` fails | need `rsync`, `jq`, `tmux` |
|