From b9aa38960e54ab22423ba8ac1db51021b006aa4c Mon Sep 17 00:00:00 2001 From: iris Date: Sat, 6 Jun 2026 08:03:59 +0200 Subject: [PATCH] docs(web-ui): document the /stats favorite-tools doughnut Backfills the agent.md Stats-page section for the favorite-tools doughnut (per-agent most-run bash commands) shipped by #1446 + #1448. Notes the normalised bash_commands heads, the bash_breakdown read, and the hidden-until-data behaviour (missing table degrades to empty). Part of #1450 / completes the per-agent half of #1433's docs. --- docs/web-ui/agent.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/web-ui/agent.md b/docs/web-ui/agent.md index 0d0cb11c..bb29850c 100644 --- a/docs/web-ui/agent.md +++ b/docs/web-ui/agent.md @@ -372,6 +372,12 @@ cost chart), doughnuts for tool / wake-source / result mix, and a **result-trend** stacked bar — per-bucket `result_counts` so error / rate-limit / compaction outcomes are visible over time (the doughnut shows only the window total). +A **favorite tools** doughnut shows the most-run shell commands — +normalised `bash_commands` heads (argv[0] basename) written per +bash task by the hive-bash-mcp capture, read via +`bash_breakdown`. Its card stays hidden until the agent has run a +bash command (a missing `bash_commands` table degrades to an empty +list), so it never renders an empty chart. A summary chip row carries window totals, plus two token-efficiency chips derived from the bucket sums: **cache hit-rate** (`cache_read` over all input-side tokens) and