Forge owns your open PRs. A singleton daemon converges every open PR toward merge-readiness; you read its verdicts and only step in on escalations. Never merges, never resolves review threads.

Shepherd

shepherd is the PR-ownership utility, not a workflow stage. It has two modes over the single forge shepherd verb:

• Daemon (default ownership): forge shepherd daemon is a machine-wide singleton for this repo. It heartbeats and converges the whole PR world every ~60s — self-registering hand-opened PRs, restarting killed watchers, reaping verified orphans, converging CI check state into kernel verdicts, retiring merged/closed PRs — then self-retires (releases the lease, kills its children, exits) once no PRs remain open. You do NOT poll by hand; the daemon does.
• One-shot convergence: forge shepherd <pr> runs the local review preflight, reads one PR's current-head state, takes at most one idempotent Tier-A action, persists bounded deltas/receipts, and exits. Use it for a point-in-time question or one bounded convergence attempt on a single PR.

Which mode? (decision rule)

• User asks about one PR, right now ("is #212 ready?", "why is this blocked?") → one-shot (forge shepherd <pr> --pull).
• Anything ongoing — "keep", "until it merges", "watch", "babysit", multiple PRs, or a session that starts with PRs already open → ensure the daemon is running.

Automatic attachment