raise the terminal window that holds the tmux client

a jump (any click, a shortcut, search) activated the terminal app, which
raised whichever window was used last. now:

- the client: the named one (a status-line click), else one already on a
  session holding the agent's window (several terminal windows can show
  one session; it shows the agent without switching, and keeps its own
  session in a session group), else any; the focused one first, then the
  one used last (its last input or focus).
- Ghostty (1.3+, scriptable by terminal id, not by tty): dingger learns
  which terminal holds each client when it gains focus. tmux's
  client-focus-in hook runs `dingger terminal focused`, which asks Ghostty
  for its focused terminal and records it in @dingger_terminal_<tty>, but
  only if the client is still focused once Ghostty answered (a fast switch
  must not pair the wrong terminal); a terminal holds one client, so an
  older pairing with it is dropped. `focus` raises the exact terminal
  (window, tab, split) through `tmux run-shell`: Apple Events from the tmux
  server count as Ghostty's own, so no permission prompt. a terminal that
  is gone is forgotten and the app activated, as without a pairing.
- in a hook, #{client_name} can be another client (the previous event's);
  the snippet's hook uses #{hook_client}.

e2e step 20: two nested clients on one session, focused by typing focus
reports into their outer panes, a fake osascript as Ghostty, a fake open
(tests never activate a real app); it loads the snippet's own hook line.
each rule has a negative control that fails.

1 files changed, 8 insertions, 0 deletions

diff --git a/README.md b/README.md
index 9a67c2d..cbbbec6 100644
--- a/README.md
+++ b/README.md
@@ -81,6 +81,14 @@ than a poll is still a completion.
   summarizes (full report: `~/.local/state/dingger/restore.log`).
 - All shortcuts live in `~/.config/dingger/config.toml` (menu bar,
   Settings…), reloaded on save.
+- **Jumping to an agent** (any click, a shortcut, search) shows it in a
+  terminal window and raises that window. With several terminal windows,
+  one already on the agent's session wins (it shows the agent without
+  switching), then the focused one, then the one used last. In Ghostty
+  (1.3+), the exact window, tab, and split is raised: dingger learns which
+  terminal holds each tmux client when it gains focus (tmux's focus hook
+  asks Ghostty which terminal is focused; nothing visible changes).
+  Other terminals: the app is activated.
 - **tmux status line** (`packaging/tmux/dingger.tmux`): the same summary after
   the clock. Clicking it jumps to the top waiting agent (the menu's top row),
   skipping the window you already look at.