feat(forgectl): pr poll — auto-review daemon + LaunchAgent + tray

[cameronsjo]

Part of #3 (the pr sub-epic) · Epic #1 · umbrella cameronsjo/claude-configurations#206.

forgectl pr poll — auto-review daemon (+ LaunchAgent + macOS tray)

Scope

• forgectl pr poll [--tray] — on a fixed interval, discover PRs awaiting your review and pre-stage a review session per new PR. The human stays in the loop: the daemon only stages; you attach and approve.
• Stateful dedup — the reviewed store doubles as in-flight memory.
• Detached runs are no-TTY-safe: all narrative funnels to a log file.
• Optional menu-bar tray (macOS, cgo build): status + Check-now / Pause / Attach / Quit; "Attach" spawns a terminal since the GUI process has no TTY.
• forgectl pr poll install — register as a per-user macOS LaunchAgent (idempotent).

Design (two-layer launch funnel)

Every launch entry point reaches one all-paths core function (worktree prep, reviewed-marking, no-TTY routing); interactive-only UX (a post-launch navigation prompt) lives one layer up in the CLI command — because the daemon calls the core function directly and never goes through the CLI layer.

Depends on

• The clean-room reviewer + discovery surfaces (sibling pr issues), launch Absorb claunch into forgectl (forgectl launch) #2.

Reference

cameronsjo/claude-configurations#202 → "The poll daemon", "dx pr poll".

[cameronsjo]

Migrated to https://github.com/cameronsjo/claude-configurations/issues/257. Ecosystem issues now consolidate on cameronsjo/claude-configurations; forgectl is the marketplace registry only.

[cameronsjo]

Closing in favor of https://github.com/cameronsjo/claude-configurations/issues/257 (see migration note above).

[cameronsjo]

Reopened — forgectl owns its own tracker again; the claude-configurations mirror is closed.

[cameronsjo]

📋 Implementer-ready plan for this issue is up as draft PR #43 (docs/plans/2026-07-06-pr-review-suite.md). Disposition here: Phase 4 — pr poll staging daemon reusing the Phase-1 core directly (two-layer funnel), idempotent LaunchAgent install, tray behind a darwin+cgo build tag. Planned 2026-07-06 (Fable backlog sweep).

[cameronsjo]

Mechanism ruling (Cameron, 2026-07-09): SwiftBar/xbar plugin, not a native cgo tray.

forgectl stays a pure static Go CLI and gains a menu-format stdout mode (e.g. forgectl tray) that a SwiftBar plugin invokes on an interval; SwiftBar (brew install --cask swiftbar) renders it. No cgo, no macOS-only build tag, static cross-compile intact.

Design consequence for this issue: the "tray" deliverable here is (a) the stdout menu mode with the pr-poll queue as its first section, and (b) a small installable SwiftBar plugin script. #55 (general shell — projects/bench/launch sections) is parked; its sections land as future additions to the same stdout mode when wanted.

[cameronsjo]

Owner ruling, 2026-07-27

Decided item by item on a decision dashboard rather than as a batch — each roadmap item was presented on its own card with its own trade-offs.

Keep the auto-review idea, fold the tray half into #55 — owner overrode a recommendation to drop this outright. Two tray surfaces should not be built; the menu-bar item owns that half.