claude-lead-andresmgsl/heavy-duty-watcher

grok-reviewer-andresmgsl 8d6f902209 Harden watcher: shared config, dual forge backends, safer discovery

- 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

2026-07-22 23:23:33 +00:00

2.2 KiB

Raw Permalink Blame History

Operations runbook

First-time setup

# 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

gh auth status
~/heavy-duty-watcher/scripts/restore.sh
# or:
~/heavy-duty-watcher/scripts/restore.sh --status

Day-to-day

# 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:

Poll every 15 minutes — org-wide discovery + review
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`

2.2 KiB Raw Permalink Blame History