Major refactor, additional comments, performance improvements, idle performance improvements, access token, port specification

Release highlights

Introduced split client/agent architecture with a ratatui-based TUI and a lightweight WebSocket agent.
Added adaptive (idle-aware) sampler: agent samples fast only when clients are connected; sleeps when idle.
Implemented metrics JSON caching for instant ws replies; cold-start does one-off collection.
Port configuration: --port/-p, positional PORT, or SOCKTOP_PORT env (default 3000).
Optional token auth: SOCKTOP_TOKEN on agent, ws://HOST:PORT/ws?token=VALUE in client.
Logging via tracing with RUST_LOG control.
CI workflow (fmt, clippy, build) for Linux and Windows.
Systemd unit example for always-on agent.
TUI features

CPU: overall sparkline + per-core history with trend arrows and color thresholds.
Memory/Swap gauges with humanized labels.
Disks panel with per-device usage and icons.
Network download/upload sparklines (KB/s) with peak tracking.
Top processes table (PID, name, CPU%, mem, mem%).
Header with hostname and CPU temperature indicator.
Agent changes

sysinfo 0.36.1 targeted refresh: refresh_cpu_all, refresh_memory, refresh_processes_specifics(ProcessesToUpdate::All, ProcessRefreshKind::new().with_cpu().with_memory(), true).
WebSocket handler: client counting with wake notifications, cold-start handling, proper Response returns.
Sampler uses MissedTickBehavior::Skip to avoid catch-up bursts.
Docs

README updates: running instructions, port configuration, optional token auth, platform notes, example JSON.
Added socktop-agent.service systemd unit.
Platform notes

Linux (AMD/Intel) supported; tested on AMD, targeting Intel next.
Raspberry Pi supported (availability of temps varies by model).
Windows builds/run; CPU temperature may be unavailable (shows N/A).
Known/next

Roadmap includes configurable refresh interval, TUI filtering/sorting, TLS/WSS, and export to file.
Add Context...
README.md

socktop_agent/src/state.rs

@@ -0,0 +1,30 @@
+//! Shared agent state: sysinfo handles and hot JSON cache.
+
+use std::{collections::HashMap, sync::Arc};
+use std::sync::atomic::AtomicUsize;
+use sysinfo::{Components, Disks, Networks, System};
+use tokio::sync::{Mutex, RwLock, Notify};
+
+pub type SharedSystem = Arc<Mutex<System>>;
+pub type SharedNetworks = Arc<Mutex<Networks>>;
+pub type SharedTotals = Arc<Mutex<HashMap<String, (u64, u64)>>>;
+pub type SharedComponents = Arc<Mutex<Components>>;
+pub type SharedDisks = Arc<Mutex<Disks>>;
+
+#[derive(Clone)]
+pub struct AppState {
+    // Persistent sysinfo handles
+    pub sys: SharedSystem,
+    pub nets: SharedNetworks,
+    pub net_totals: SharedTotals, // iface -> (rx_total, tx_total)
+    pub components: SharedComponents,
+    pub disks: SharedDisks,
+
+    // Last serialized JSON snapshot for fast WS responses
+    pub last_json: Arc<RwLock<String>>,
+
+    // Adaptive sampling controls
+    pub client_count: Arc<AtomicUsize>,
+    pub wake_sampler: Arc<Notify>,
+    pub auth_token: Option<String>,
+}