Add demo script and unit tests for collector package

- Created a demo.tape file to showcase the usage of the application with visual output.
- Implemented unit tests for the collector package, including tests for loopback interface detection, best interface selection, and interface details retrieval.
- Added tests to ensure correct behavior for both valid and invalid interface names.

Author: programmersd21

CHANGELOG.md

@@ -1,3 +1,29 @@
+## [0.1.6] - 2026-07-10
+
+### Added
+
+- Interface Details Overlay — Press `I` (capital i) to view IP addresses, MAC address, link status, and MTU for the current network interface. Uses both gopsutil and the Go standard library for cross-platform compatibility.
+- Reset Confirmation — Pressing `r` now requires a second press within 2 seconds to confirm, preventing accidental data loss. Press `esc` to cancel.
+- Interface Info Keybinding (`I`) — Documented in the help overlay alongside all other bindings.
+- Expanded test coverage — New test suites for layout utilities (centerInline, formatBytes, formatInterval, truncate), overlay rendering (help, processes, themes), collector edge cases (loopback detection, pickBest), and additional FormatBpsExt unit/edge-case tests.
+- ROADMAP.md — Published a public roadmap covering v0.2.x through v0.5.x.
+
+### Improved
+
+- Codebase modularity — views.go (729 lines) split into four focused files: views.go (dashboard layout), panels.go (download/upload panel rendering), overlays.go (help, processes, themes, interface details overlays), and layout.go (shared layout/formatting utilities). Each file has a single responsibility.
+- Help overlay — Now documents the new `I` interface info keybinding and the reset confirmation (press twice) behavior.
+- Collector testability — Added `collector_test.go` with tests for `isLoopback`, `pickBest`, constructor, and `InterfaceDetails`.
+- centerInline now handles empty strings gracefully (returns the input unchanged instead of adding whitespace padding).
+
+### Changed
+
+- Major internal restructuring — views.go decomposed into panels.go, overlays.go, and layout.go with zero behavioural changes.
+- VERSION bumped to 0.1.6 (significant architecture improvements and new features).
+
+### Fixed
+
+- `runTiny` in main.go had identical branches in the `noColor` if/else block (dead code). Removed the conditional — both branches did the same thing.
+
 ## [0.1.5] - 2026-07-08
 
 ### Added
@@ -32,9 +58,6 @@
 - Processes Panel - Redesigned with a rounded indigo border matching the help menu aesthetic, consistent padding, muted separators, and centered layout. Displays "no active network processes detected" when empty.
 - Today Stats - Deduplicated "today" label (was showing "today" twice), cleaner formatting.
 - Makefile - Cross-platform support for Linux, macOS, and Windows (automatic binary extension, platform-agnostic directory creation and cleanup).
-- Processes Panel - Redesigned with a rounded indigo border matching the help menu aesthetic, consistent padding, muted separators, and centered layout. Displays "no active network processes detected" when empty.
-- Today Stats - Deduplicated "today" label (was showing "today" twice), cleaner formatting.
-- Makefile - Cross-platform support for Linux, macOS, and Windows (automatic binary extension, platform-agnostic directory creation and cleanup).
 
 ## [0.1.2] - 2026-07-05
 
@@ -103,17 +126,12 @@
 
 ### Changed
 
-- Simplified the hero branding to a plain FLOW title for a calmer,
-  more iconic terminal identity.
-- Reworked the terminal UI into a calmer, premium dashboard with a
-  larger title hierarchy and more whitespace.
-- Replaced abrupt value easing with spring-driven interpolation for
-  smoother motion in the render loop.
+- Simplified the hero branding to a plain FLOW title for a calmer, more iconic terminal identity.
+- Reworked the terminal UI into a calmer, premium dashboard with a larger title hierarchy and more whitespace.
+- Replaced abrupt value easing with spring-driven interpolation for smoother motion in the render loop.
 - Added brief pulse and shimmer feedback for peaks and live traffic.
-- Refreshed the theme system with a restrained blue, cyan, emerald, and
-  near-white palette that degrades cleanly in low-color terminals.
-- Updated history and graph presentation to better emphasize flowing
-  movement over static dashboard chrome.
+- Refreshed the theme system with a restrained blue, cyan, emerald, and near-white palette that degrades cleanly in low-color terminals.
+- Updated history and graph presentation to better emphasize flowing movement over static dashboard chrome.
 - Theme system supports light and dark palettes simultaneously
 - Sparkline engine rewritten for block-element output
 - Default sampling interval decreased from 250ms to 100ms
@@ -125,11 +143,9 @@
 
 ### Fixed
 
-- Reset key fully clears peak tracking, daily totals, rolling maxima,
-  display values, and history ring buffers
+- Reset key fully clears peak tracking, daily totals, rolling maxima, display values, and history ring buffers
 - Interface cycling no longer stalls updates
 - Interface cycling resets all display state and ring buffers
 - Config unit field is case-insensitive
 - Various lint and typecheck violations resolved
-- Sampler uses a sliding-window average to eliminate zero reads from
-  coarse OS counter granularity
+- Sampler uses a sliding-window average to eliminate zero reads from coarse OS counter granularity

README.md

@@ -143,8 +143,10 @@ flow adjusts its display according to terminal width and height.
 ## Features
 
 - Live latency (ping) indicator with color-coded ↔ display
-- Network processes panel - press `n` to view active processes sorted by connection count
-- Theme selector with 8 built-in themes - press `t` to browse and select
+- Network processes panel — press `n` to view active processes sorted by connection count
+- Interface details overlay — press `I` (capital i) to view IP addresses, MAC, link status, MTU
+- Theme selector with 8 built-in themes — press `t` to browse and select
+- Reset confirmation — press `r` twice to confirm, preventing accidental data loss
 - Real-time download and upload throughput
 - Interpolated display values using spring-based animation
 - Braille-grid waveform rendering at 30 frames per second
@@ -163,8 +165,6 @@ flow adjusts its display according to terminal width and height.
 
 ## Usage
 
-![help](assets/cli_help.png)
-
 ```sh
 flow                        # hero view, auto interface
 flow --tiny                 # single-line mode for status bars
@@ -184,14 +184,17 @@ flow --help
 
 ![keybinds](assets/keybinds.png)
 
+| Key         | Action                      |
+|-------------|-----------------------------|
 | Key         | Action                      |
 |-------------|-----------------------------|
 | `q` / `^C`  | Quit                         |
 | `m`         | Cycle display/view modes    |
 | `n`         | Open network processes      |
 | `t`         | Choose theme                |
-| `r`         | Reset session peaks          |
+| `r`         | Reset session peaks (twice)  |
 | `i`         | Cycle network interfaces     |
+| `I`         | Show interface info          |
 | `c`         | Cycle display units          |
 | `b`         | Toggle bits/bytes mode       |
 | `+` / `-`   | Adjust refresh interval      |
@@ -280,11 +283,37 @@ flowchart LR
         Channel --> Spring["Spring interpolation"]
         Spring --> Display["Dashboard render (Bubble Tea)"]
         Theme["Theme configuration"] -.-> Display
+        InterfaceInfo["Interface details (IP, MAC)"] -.-> Display
     end
 ```
 
 - The sampling loop reads network counters from the operating system, computes a sliding-window average, and emits a sample on a channel.
 - The render loop interpolates display values toward the latest sample and renders the dashboard.
+- Interface details (IP addresses, MAC, link status) are fetched on demand via `I` using both gopsutil and the Go standard library.
+
+### Internal package structure
+
+```
+cmd/flow/main.go
+    |
+    ├── internal/config       ← TOML config management
+    ├── internal/collector    ← OS-level network I/O counters + interface details
+    ├── internal/sampler      ← Sliding-window sampling loop
+    |
+    └── internal/ui           ← Bubble Tea Model + views
+         ├── model.go         ← State, update loop, key handling
+         ├── views.go         ← Dashboard layout and mode selection
+         ├── panels.go        ← Download/upload panel rendering
+         ├── overlays.go      ← Help, processes, themes, interface info
+         ├── layout.go        ← Layout utilities (centering, formatting)
+         ├── keys.go          ← Key binding definitions
+         ├── internal/history    ← Ring buffer + tracker (peaks/totals)
+         ├── internal/sparkline  ← Braille/block graph rendering
+         ├── internal/theme      ← 8 colour themes + lipgloss styles
+         ├── internal/animate    ← Spring physics, easing, colour lerps
+         ├── internal/ping       ← TCP ping measurement
+         └── internal/processes  ← Network process enumeration
+```
 
 Separating collection from rendering keeps the interface responsive without adding load to the sampler. Idle CPU usage remains below one percent.
 

VERSION

@@ -1 +1 @@
-0.1.5
+0.1.6