From 4af6a4f625b1965b783c9efb857f8ac665adb8eb Mon Sep 17 00:00:00 2001
From: Igor Soarez <igor@soarez.org>
Date: Tue, 20 Oct 2026 12:43:07 +0300
Subject: rebuild the status model as herdr's state machine, event-driven and
 tested

the seen logic was inverted: first observations were marked done and real
completions idle, so the menu showed teal for agents that did nothing and
green for agents that finished, and attending changed nothing visible.

- watcher::advance is herdr's apply_pane_state_change + mark_active_tab_seen
  as a pure function, unit-tested against herdr's own cases; attendance is
  window-level like herdr's active tab
- hook reports are events applied in order, so a turn shorter than a poll is
  still a completion
- event-driven: hook reports, dingger focus, and tmux focus hooks wake the
  watcher; notifications are delivered off-thread (the macos call blocked
  ticks for 2+ seconds) after the pane options are written
- all per-pane state persists in tmux pane options, so restarts and deploys
  lose nothing, including the authoritative hook state
- every click goes through dingger focus: the menu bar shells out to it and
  the status-line binding runs it; it picks the right client, skips the
  window already shown, and activates the terminal app hosting the client
- the ready queue is ordered like the menu (blocked first, then oldest done)
- menu bar and tmux segment render herdr's symbols in herdr's palette
- tests/e2e.sh: 60 assertions against an isolated tmux server with a real
  client, a 30s poll interval, and a slow fake notifier
---
 packaging/tmux/dingger.tmux | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 packaging/tmux/dingger.tmux

(limited to 'packaging/tmux')

diff --git a/packaging/tmux/dingger.tmux b/packaging/tmux/dingger.tmux
new file mode 100644
index 0000000..64c5bff
--- /dev/null
+++ b/packaging/tmux/dingger.tmux
@@ -0,0 +1,14 @@
+# dingger: herdr-style agent summary after the clock, in herdr's colors:
+#   × blocked (red, bold)   ✓ done (teal)   ◐ working (yellow)
+# Clicking the status line jumps to the top waiting agent, like the top row
+# of the menu bar: blocked first, then the longest-done (FIFO), skipping the
+# window you are already looking at.
+#
+# Source this from your tmux config:  source-file /path/to/dingger.tmux
+set -g status-right '%d-%b %H:%M#{?#{e|>:#{@dingger_blocked},0}, #[fg=#f38ba8#,bold]×#{@dingger_blocked}#[default],}#{?#{e|>:#{@dingger_done},0}, #[fg=#94e2d5]✓#{@dingger_done}#[default],}#{?#{e|>:#{@dingger_working},0}, #[fg=#f9e2af]◐#{@dingger_working}#[default],}'
+bind -n MouseDown1StatusRight run-shell "$HOME/.local/bin/dingger focus --client '#{client_name}'"
+# Tell dingger the moment you look somewhere else (it marks what you see as
+# attended). Index 77 keeps your own hooks and makes reloading idempotent.
+set-hook -g 'client-session-changed[77]' 'run-shell -b "$HOME/.local/bin/dingger poke"'
+set-hook -g 'session-window-changed[77]' 'run-shell -b "$HOME/.local/bin/dingger poke"'
+set-hook -g 'window-pane-changed[77]' 'run-shell -b "$HOME/.local/bin/dingger poke"'
-- 
cgit v1.2.3