diff --git a/CLAUDE.md b/CLAUDE.md
index 4e967bc5..014ed05c 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -118,6 +118,17 @@ 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 %, current/peak/max
+                         memory in bytes) polled live from cgroup-v2. Backs
+                         GET /api/container-resources for the dashboard's
+                         load chips. 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