diff --git a/.claude/HISTORY.md b/.claude/HISTORY.md index e9ec6902..6a2e71b6 100644 --- a/.claude/HISTORY.md +++ b/.claude/HISTORY.md @@ -1,6 +1,6 @@ # SecuBox UI & Theme History -_Last updated: 2026-03-11 (Streamlit Control Phase 3, CrowdSec bugfix)_ +_Last updated: 2026-03-13 (Config Vault + System Hardware Report)_ 1. **Unified Dashboard Refresh (2025-12-20)** - Dashboard received the "sh-page-header" layout, hero stats, and SecuNav top tabs. @@ -4960,3 +4960,34 @@ git checkout HEAD -- index.html - `/usr/share/config-vault/hooks/uci-track` - Change tracking hook - `/srv/config-vault/` - Git repository with versioned configs - `/usr/libexec/rpcd/luci.config-vault` - RPCD backend + +102. **System Hardware Report (2026-03-13)** + - Extended `secubox-app-reporter` with new system hardware report type + - **Purpose**: Detailed system diagnostics, health monitoring, environmental impact awareness + - **CLI**: `secubox-reportctl generate system` + - **Features**: + - CPU/Memory/Disk/Temperature gauges with animated rings + - 24-bar CPU load histogram visualization + - Environmental impact card (power/kWh/CO₂ estimates) + - Health recommendations based on system metrics + - Top processes table with status indicators + - Network interface stats (RX/TX per interface) + - Debug log viewer with severity highlighting + - **Data Collectors** (`system-collector.sh`): + - `get_cpu_usage` - /proc/stat based CPU percentage + - `get_memory_info` - MemTotal/MemAvailable from /proc/meminfo + - `get_disk_info` - Root filesystem usage via df + - `get_temperature` - Thermal zone readings + - `get_cpu_freq/model/cores` - CPU specifications + - `estimate_power_watts` - ARM appliance power estimation + - `generate_recommendations` - Threshold-based health tips + - `get_debug_log` - Logread output with severity parsing + - **Template**: `system-status.html.tpl` with KissTheme dark styling + - **Files**: + - `/usr/share/secubox-reporter/lib/system-collector.sh` - Data collection functions + - `/usr/share/secubox-reporter/templates/system-status.html.tpl` - HTML template + - **Technical Notes**: + - BusyBox/ash compatible (no bash-specific syntax) + - Uses awk for multiline HTML substitutions (sed limitations) + - Temp files for dynamic content generation + - /proc filesystem based for OpenWrt compatibility diff --git a/.claude/WIP.md b/.claude/WIP.md index 86efddcc..3e72bdce 100644 --- a/.claude/WIP.md +++ b/.claude/WIP.md @@ -1,6 +1,6 @@ # Work In Progress (Claude) -_Last updated: 2026-03-13 (SecuBox Report Generator)_ +_Last updated: 2026-03-13 (Config Vault + System Hardware Report)_ > **Architecture Reference**: SecuBox Fanzine v3 — Les 4 Couches @@ -10,6 +10,29 @@ _Last updated: 2026-03-13 (SecuBox Report Generator)_ ### 2026-03-13 +- **Configuration Vault System (Complete)** + - New `secubox-app-config-vault` + `luci-app-config-vault` packages + - Git-based config versioning with auto-commit and auto-push + - 9 configuration modules: users, network, services, security, system, containers, reporter, dns, mesh + - CLI: `configvaultctl init|backup|restore|push|pull|status|history|diff|modules|export-clone|import-clone` + - RPCD: status, modules, history, diff, backup, restore, push, pull, init, export_clone + - Gitea integration: Private repo sync (`gandalf/secubox-config-vault`) + - LuCI Dashboard: KISS-themed with status rings, module table, commit history, quick actions + - Export/import clone tarballs for device provisioning and cloning + - Menu: SecuBox → System → Config Vault + +- **System Hardware Report (Complete)** + - Added new report type to `secubox-app-reporter` + - CLI: `secubox-reportctl generate system` + - CPU/Memory/Disk/Temperature gauges with animated rings + - Environmental impact card: Power usage (W), daily kWh, CO₂ emissions + - CPU load histogram (24-bar visualization) + - Health recommendations based on system metrics + - Top processes table and debug log viewer + - Network interface stats (RX/TX per interface) + - BusyBox-compatible collectors using /proc filesystem + - KissTheme dark styling with responsive layout + - **SecuBox Report Generator (Complete)** - New `secubox-app-reporter` + `luci-app-reporter` packages - Two report types: @@ -504,8 +527,8 @@ _Last updated: 2026-03-13 (SecuBox Report Generator)_ ### v1.0 Release Prep -1. **Session Replay** - Avatar-tap integration for session capture/replay -2. **Remote ttyd Deployment** - Auto-install ttyd on mesh nodes +1. **Remote ttyd Deployment** - Auto-install ttyd on mesh nodes +2. **Device Provisioning** - Use Config Vault export-clone for SecuBox replication ### v1.1+ Extended Mesh