Refine Framework monitoring history and configurable tray telemetry

framework-laptop-tools/README.md

@@ -43,7 +43,16 @@ uses the left percentage axis and rate the right watts axis (positive charging,
 negative discharging). Blue-grey bands mark logind-observed sleep; faint red bands
 mark observed charger connection. Plug changes during sleep are unknown, so AC
 bands are not extended through sleep. There is no history from before app startup.
-History is bounded to 600 samples per series and kept only while the app runs.
+The Monitor history slider spans 5 minutes to 24 hours on a logarithmic scale.
+Stretch available data fits shorter recordings to the graph width until the
+selected span has been collected. These viewing controls take effect immediately
+and are remembered; the default is 24 hours with stretching enabled.
+All detected sensors retain 24 hours of readings in memory, even when hidden,
+plus one boundary sample for clipping. Quitting the app clears this history.
+Monitor and tray lines show time-weighted averages per pixel, assuming straight
+lines between readings. A faint band extends from the average to the maximum;
+brief peaks remain visible without dominating the solid line. Missing data and
+sleep remain gaps. Hover readings still report the original samples.
 
 Sampling choices are 0.5/1/2/4 seconds for frequencies and temperatures, and
 15/30/60/120 seconds for the battery graph. Tray autostart is optional.
@@ -51,17 +60,36 @@ Closing the window leaves monitoring in the tray; Quit exits the application.
 The Tray icon tab selects a normal icon, a history graph, or a number. Sources
 include CPU usage, CPU/GPU frequency, temperatures, charge level and battery rate.
 Sensor graphs share Monitor's history, including gaps, regardless of which
-sensor is selected for the tray. CPU usage also retains 600 samples. Switching
+sensor is selected for the tray. CPU usage also retains 24 hours. Switching
 readings or resuming from sleep does not clear history. Frequency numbers use
-GHz; the hover tooltip includes the full reading and unit. The tray has optional
+GHz. The tray has optional
 borders, a transparent or coloured background, line and fill colours, and optional
 area fill (including adjustable opacity). Frequency ceilings and temperature
 ranges are saved per sensor; battery rate also has adjustable bounds (initially
 −75–75 W), while percentages use 0–100.
+Tray graphs show 10, 15, 20 or 30 seconds, or 1, 2 or 5 minutes, ending at now.
+The default is one minute. History length is staged with the other tray settings.
+Older readings are clipped, and unavailable history stays blank.
 Outside readings can follow the inner edge, optionally in a different colour,
 or be hidden. The line remains inside the border when a border is enabled.
 Colour buttons show the opaque RGB swatch and label opacity separately, so a
 translucent fill is not mistaken for a darker RGB colour.
+History and out-of-range controls are nested under the History graph display
+choice. Hover information is configured separately: CPU usage; battery level
+and remaining/full energy in mWh, followed by signed power and time to the charge
+target; fan RPM and duty percentage; and the main CPU, memory, NVMe, battery and
+board temperatures. Multiple temperatures have a heading and indented lines.
+Missing sensors are unavailable in the settings page. Batteries reporting only
+charge are converted to mWh using nominal voltage.
+Choose zero to three top CPU applications, displayed below CPU usage in descending
+order. Zero disables process sampling; the previous checkbox migrates to zero or
+one. Readable CPU counters are sampled while enabled. Processes are grouped by
+application where identifiable, otherwise by executable. KDE's catalogue supplies
+friendly names; ambiguous matches use executable names. Percentages use total
+CPU capacity, matching the CPU line, rather than one core. Short-lived processes
+between samples cannot be counted. No process history is written to disk.
+Charging estimates to a reduced limit use the current charging rate and are
+marked approximate. Hover choices use the shared Save and Apply / Undo controls.
 Plasma applies its own hover highlight to tray icons; the app does not patch
 the system tray to suppress that effect.