vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(web-ui): document the /stats favorite-tools doughnut

Browse source 
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.
This commit is contained in:
iris 2026-06-06 08:03:59 +02:00 • committed by mara
commit b9aa38960e
1 changed files with 6 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

6
docs/web-ui/agent.md
View file

@ -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