diff --git a/CLAUDE.md b/CLAUDE.md
index 4e967bc5..80be910e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -118,6 +118,15 @@ hive-c0re/         host daemon + sibling operator CLI (lib + 2 bins)
                          Dashboard surfaces the log on expand. Backed by
                          `/var/lib/hyperhive/build_logs.sqlite`; hourly
                          retention sweep via the existing vacuum.
+  src/hive_stats.rs     hive-wide turn-stats aggregation: reads every
+                         agent's hyperhive-turn-stats.sqlite read-only,
+                         rolls up swarm totals + per-agent breakdowns +
+                         model mix. Backs GET /api/stats-hive for the
+                         dashboard's ST4TS tab; missing / unreadable dbs
+                         skipped (one bad db never fails the endpoint).
+  src/container_stats.rs  per-container resource metrics (cpu %, mem %, swap)
+                         polled live; aggregated for dashboard display.
+                         Skips unhealthy / stopped containers gracefully.
   src/crash_watch.rs    poll every 10s; fire HelperEvent::ContainerCrash
                          when a previously-running container disappears
                          without an operator-initiated transient (or a