| name | herdr-event-watch |
| description | Switch herdr fleet supervision from fixed-interval patrols to event-driven watching. Emits only lane done/blocked transitions, PR required-check pass/fail finalizations, and durable inbox-artifact arrivals, via the Monitor tool. Use for "watch this event-driven", "tell me when the lane/PR finishes", or when periodic patrol keeps reporting "no change". |
herdr-event-watch — event-driven lane/PR watching
English | 日本語
Canonical procedure for getting notified the moment something changes
instead of polling on a fixed interval. Fixed-interval patrol loses twice: a
lane that parks 3 minutes in goes unnoticed for up to the full interval, and
the patrol runs even when nothing happened.
When to use
- Multiple worker/review lanes are running and you want PARK (done) / blocked
picked up immediately.
- You are waiting on PR required checks (branch protection) to go green/fail
before a merge decision.
- Your periodic "worker patrol" cron has degenerated into "no change" reports.
Usage
Arm one Monitor with persistent: true (a single watcher covers lanes and CI):
Monitor({
description: "<what is being watched — e.g. api lanes + inbox + PR #109 CI>",
persistent: true,
command: "bash <skill-dir>/scripts/herdr-event-watch.sh \
--workspace <wsId> --prefix <laneLabelPrefix> \
--inbox <receiptDir> --inbox-prefix <filePrefix> \
--repo <owner/repo> --check <requiredCheckName> --pr <n> [--pr <n> ...]"
})
Arguments:
| Arg | Required | Meaning |
|---|
--workspace | ✔ | herdr workspace ID (herdr workspace list) |
