feat(supervision): GitHub events watcher (comments/CI/reviews) with CLI filter knobs

AGENTS.md

@@ -75,6 +75,8 @@ state/               volatile runtime signals; gitignored
   .watch.lock .wake-queue.lock watcher singleton and queue serialization locks
   .hash-* .count-* .stale-* .seen-* .last-* .heartbeat-streak   watcher internals; never touch
   .last-watcher-beat watcher liveness beacon, touched every poll; fm-guard.sh reads it
+  .github-watch-config  fm-github-watch.sh filter/contributor config (key=value); never touch unless driving that tool
+  .github-watch-seen/   fm-github-watch.sh per-PR seen state (high-water marks); owned by that script
 .no-mistakes/        local validation state and evidence; gitignored
 ```
 

README.md

@@ -140,6 +140,7 @@ The first mate drives these; you rarely need to, but they work by hand too.
 | `fm-merge-local.sh`      | Fast-forward a `local-only` project's local default branch after approval                                           |
 | `fm-review-diff.sh`      | Review a crewmate branch against the authoritative base, with optional `--stat` output                              |
 | `fm-watch.sh`            | Singleton-safe one-shot watcher; blocks until supervision work is due, queues it durably, then exits with one reason line |
+| `fm-github-watch.sh`     | Poll the contributor's open PRs for new comments/CI/reviews/merges; toggle filters via `filter <name> on\|off`        |
 | `fm-wake-drain.sh`       | Atomically drain queued watcher wakes before handling supervision work                                              |
 | `fm-send.sh`             | Send one literal line (or `--key Escape`) to a crewmate window                                                      |
 | `fm-peek.sh`             | Print a bounded tail of a crewmate pane                                                                             |
@@ -168,6 +169,9 @@ FM_SIGNAL_GRACE=30      # seconds to coalesce nearby status and turn-end signals
 FM_FLEET_SYNC_BOOTSTRAP_TIMEOUT=20   # seconds allowed for bootstrap's best-effort clone refresh
 FM_FLEET_PRUNE=1        # set to 0 to skip pruning local branches whose upstream is gone
 FM_BUSY_REGEX='esc (to )?interrupt|Working\.\.\.'   # busy-pane signatures, extend per harness
+FM_GH_CONTRIBUTOR=       # GitHub user whose open PRs fm-github-watch.sh polls; unset = derive from `gh auth`
+FM_GH_POLL_SECS=300      # seconds between polls when fm-github-watch.sh runs as --daemon
+FM_GH_CLOSE_REPROBE_SECS=7200   # seconds after a PR closes to keep re-probing for a reopen->merge; bounds API cost
 ```
 
 ## Development