[WIP] Update Copilot instructions for coding agents

DEVICE_DETAILS_ENHANCEMENTS.md

@@ -0,0 +1,271 @@
+# Device Details Screen Enhancements
+
+## Overview
+The Device Details Screen has been significantly enhanced with comprehensive system monitoring capabilities, detailed memory breakdowns, and real-time I/O statistics.
+
+## New Features Added
+
+### 1. **Load Average Monitoring**
+- Displays 1-minute, 5-minute, and 15-minute load averages
+- Fetched from `/proc/loadavg`
+- Format: `0.45 / 0.52 / 0.48`
+- Icon: Equalizer (📊)
+- Color: Cyan
+
+### 2. **Total Process Count**
+- Shows the total number of running processes
+- Counts all processes via `ps aux | wc -l`
+- Icon: Apps (📱)
+- Color: Deep Purple
+
+### 3. **CPU Temperature Monitoring**
+- Reads temperature from multiple sources:
+  - `/sys/class/thermal/thermal_zone0/temp`
+  - `sensors` command output
+- Automatic unit conversion (handles millidegrees)
+- Color-coded warning: Red if >75°C, Orange otherwise
+- Icon: Thermostat (🌡️)
+
+### 4. **Hostname Display**
+- Shows the system hostname
+- Fetched via `hostname` command
+- Icon: DNS (🌐)
+- Color: Blue Grey
+
+### 5. **Kernel Version**
+- Displays the Linux kernel version
+- Fetched via `uname -r`
+- Icon: Settings System Daydream (⚙️)
+- Color: Deep Orange
+
+### 6. **Detailed Memory Breakdown**
+- **New MemoryDetails Model** with comprehensive memory statistics:
+  - **Total Memory**: Total RAM available
+  - **Used Memory**: Currently in use
+  - **Free Memory**: Completely unused
+  - **Available Memory**: Memory available for allocation
+  - **Cached Memory**: Used for disk caching
+  - **Buffers**: Kernel buffers
+  - **Swap Total**: Total swap space
+  - **Swap Used**: Used swap space
+
+- **Visual Representation**:
+  - Color-coded memory types with circular indicators
+  - GB format with 2 decimal precision
+  - Swap usage progress bar (if swap is available)
+  - Swap percentage display
+
+### 7. **Disk I/O Statistics**
+- Real-time disk read/write speeds
+- Command: `iostat -d 1 2`
+- Format: `X.X kB/s read, Y.Y kB/s write`
+- Falls back to "N/A" if iostat not available
+- Icon: Storage (💾)
+- Color: Brown
+
+### 8. **Network Traffic Statistics**
+- Total network traffic since boot
+- Monitors: `eth0`, `wlan0`, `enp*`, `wlp*` interfaces
+- Format: `↓ X.X MB ↑ Y.Y MB`
+- Shows download and upload totals
+- Icon: Swap Vertical (⬍)
+- Color: Green
+
+## UI Structure
+
+### Section Layout (Top to Bottom):
+
+1. **Gauges Grid** (2x2)
+   - CPU Usage
+   - RAM Usage
+   - Storage Usage
+   - Uptime
+
+2. **System Stats Row** (2 cards)
+   - Load Average
+   - Total Processes
+
+3. **Temperature & Hostname Row** (2 cards)
+   - CPU Temperature (color-coded)
+   - Hostname
+
+4. **Memory Breakdown** (Detailed Card)
+   - 8 memory metrics with color coding
+   - Swap statistics with progress bar
+
+5. **I/O Statistics**
+   - Disk I/O speeds
+   - Network traffic totals
+
+6. **System Information**
+   - Operating System
+   - Kernel Version
+   - Network Configuration
+   - Battery Status
+
+7. **Top Processes** (List)
+   - Top 5 CPU-consuming processes
+   - Shows PID, CPU%, MEM%, and Command
+
+## Data Model Changes
+
+### SystemInfo Class
+Added fields:
+```dart
+final String loadAverage;
+final double temperature;
+final String diskIO;
+final String networkBandwidth;
+final MemoryDetails memoryDetails;
+final int totalProcesses;
+final String kernelVersion;
+final String hostname;
+```
+
+### New MemoryDetails Class
+```dart
+class MemoryDetails {
+  final double total;
+  final double used;
+  final double free;
+  final double available;
+  final double cached;
+  final double buffers;
+  final double swapTotal;
+  final double swapUsed;
+}
+```
+
+## New Fetch Methods
+
+1. `_fetchLoadAverage()` - Reads `/proc/loadavg`
+2. `_fetchTemperature()` - Multi-source temperature reading
+3. `_fetchDiskIO()` - Uses `iostat` for real-time I/O
+4. `_fetchNetworkBandwidth()` - Parses `/proc/net/dev`
+5. `_fetchMemoryDetails()` - Detailed `free -b` parsing
+6. `_fetchTotalProcesses()` - Counts all processes
+7. `_fetchKernelVersion()` - Gets kernel version
+8. `_fetchHostname()` - Retrieves hostname
+
+## New UI Widgets
+
+1. **_buildStatCard()** - Compact stat display with icon
+   - Used for: Load Average, Process Count, Temperature, Hostname
+
+2. **_buildMemoryDetailsCard()** - Comprehensive memory breakdown
+   - Color-coded memory types
+   - Circular indicators
+   - Swap usage progress bar
+
+3. **_buildMemoryRow()** - Individual memory metric row
+   - Color circle indicator
+   - GB formatting
+   - Bold value display
+
+## Performance Considerations
+
+- All new data fetching methods run concurrently using `Future.wait()`
+- Total fetch count increased from 8 to 16 concurrent operations
+- Auto-refresh interval: 5 seconds (unchanged)
+- Pull-to-refresh available for manual updates
+- Graceful fallbacks for missing commands (iostat, sensors)
+
+## Error Handling
+
+- All fetch methods have try-catch blocks
+- Default values returned on errors:
+  - Strings: `'Unknown'` or `'N/A'`
+  - Numbers: `0`
+  - Objects: Empty/default instances
+- Temperature falls back to 0 if sensors unavailable
+- Disk I/O shows "N/A" if iostat not installed
+- Network bandwidth shows "Unknown" if no interfaces found
+
+## Color Scheme
+
+- **Load Average**: Cyan
+- **Processes**: Deep Purple
+- **Temperature**: Orange (Red if >75°C)
+- **Hostname**: Blue Grey
+- **Kernel**: Deep Orange
+- **Disk I/O**: Brown
+- **Network Traffic**: Green
+- **Memory Total**: Blue
+- **Memory Used**: Red
+- **Memory Free**: Green
+- **Memory Available**: Teal
+- **Memory Cached**: Orange
+- **Memory Buffers**: Purple
+- **Swap Total**: Indigo
+- **Swap Used**: Deep Orange
+
+## Testing Recommendations
+
+1. **Temperature Monitoring**:
+   - Test on devices with/without thermal sensors
+   - Verify temperature reading accuracy
+   - Test color change at 75°C threshold
+
+2. **Disk I/O**:
+   - Test on systems with/without iostat
+   - Verify fallback to "N/A"
+   - Monitor during heavy disk activity
+
+3. **Network Traffic**:
+   - Test with different network interfaces
+   - Verify MB calculations
+   - Test with no active network
+
+4. **Memory Details**:
+   - Verify all memory metrics sum correctly
+   - Test swap display when swap is disabled
+   - Check GB conversion accuracy
+
+5. **Load Average**:
+   - Compare with `uptime` command output
+   - Monitor under various system loads
+
+## Dependencies
+
+All features use standard Linux commands:
+- `cat /proc/loadavg` - Load average (standard)
+- `cat /sys/class/thermal/thermal_zone0/temp` - Temperature (most systems)
+- `sensors` - Alternative temperature source (requires lm-sensors package)
+- `iostat` - Disk I/O (requires sysstat package)
+- `cat /proc/net/dev` - Network stats (standard)
+- `free -b` - Memory details (standard)
+- `ps aux` - Process counting (standard)
+- `uname -r` - Kernel version (standard)
+- `hostname` - System hostname (standard)
+
+## Future Enhancement Ideas
+
+1. **Historical Graphs**: Add time-series graphs for CPU, RAM, and temperature
+2. **Alerts**: Configurable alerts for high temperature, memory, or load
+3. **Export**: Export system statistics to CSV/JSON
+4. **Comparisons**: Compare current stats with historical averages
+5. **Process Management**: Add ability to kill processes from the list
+6. **Custom Refresh**: User-configurable auto-refresh interval
+7. **Bandwidth Rate**: Show real-time network speed (MB/s) instead of totals
+8. **Disk Usage**: Add per-partition disk usage breakdown
+9. **Service Status**: Monitor systemd services status
+10. **GPU Monitoring**: Add GPU usage and temperature (if available)
+
+## Known Limitations
+
+1. Temperature reading may not work on all systems (depends on hardware sensors)
+2. Disk I/O requires `iostat` package installation
+3. Network traffic shows total since boot, not rate
+4. Some metrics may require elevated permissions on certain systems
+5. Swap statistics only show if swap is configured
+
+## File Location
+
+`lib/screens/device_details_screen.dart`
+
+## Lines of Code
+
+- Total: ~760 lines (increased from ~624 lines)
+- New methods: ~150 lines
+- New UI components: ~120 lines
+- Model updates: ~30 lines