Module data 

TeamSnapshot — point-in-time read of the dogfood team that the UI renders against. Built by walking up to the nearest .team/, parsing team-compose.yaml, querying the supervisor for each agent’s process state, and aggregating a small set of mailbox counters (unread + pending approvals).

Read by both App::tick() (live refresh every second) and the snapshot tests (constructed manually). The snapshot is intentionally cheap to build — every field is derived from a single SQL query per agent — so refresh cadence stays well under tmux’s own capture-pane cost.

Structs

AgentInfo

Per-agent fields the UI reads to render the roster + drive selection / detail-pane streaming.

ChannelInfo

One channel exposed in team-compose.yaml. Used by PR-UI-6’s per-channel broadcast picker and by the Mailbox-first layout’s channel list. id is <project>:<name> (matches the broker’s channels.id); name is the short label rendered as #name.

TeamSnapshot

Functions

agent_label

Return the operator-facing label for agent_id: the agent’s display_name when set, otherwise agent_id itself. Read-only borrow into the snapshot — callers that need an owned String can .to_string() at the use-site. Unknown ids fall through to agent_id (the canonical id is always a valid label).

state_glyph

Single-cell glyph for an agent’s primary state — derived from the triplet (state, pending_approvals, unread_mail) in priority order: pending approval beats unread mail beats process state. Plain ASCII fallback when the caller signals a monochrome / no-symbol terminal.