network-performance-monitor/RELEASE_NOTES_1.2.0.md

A comprehensive network performance monitoring tool that continuously tests and tracks your network's performance over time

# Release Notes - Version 1.2.0

## Overview
This release focuses on fixing critical issues with scheduled speed tests and improving WiFi network detection on macOS. It also introduces a test mode for easier development and regression testing.

## Key Improvements

### 1. Fixed Scheduled Speed Tests
- **Issue**: Scheduled speed tests were failing with "No output from speedtest-cli" errors
- **Cause**: Python deprecation warnings in stderr were interfering with JSON parsing
- **Solution**: 
  - Added `PYTHONWARNINGS='ignore::DeprecationWarning'` environment variable
  - Switched to consistent spawn method for all speed test executions
  - Now properly ignores stderr output and only processes stdout

### 2. Enhanced WiFi Detection on macOS
- **Issue**: WiFi networks were showing as "en0 (gateway)" instead of the actual SSID
- **Solution**: 
  - Replaced complex detection methods with reliable `ipconfig getsummary` command
  - Fixed SSID parsing to avoid matching BSSID "<redacted>"
  - Simplified code by removing networksetup, airport, and system_profiler methods

### 3. Test Mode for Development
- **New Feature**: `--test-mode` flag for immediate and configurable speed test intervals
- **Usage**: `network-performance-monitor start --test-mode --speed-test-interval 10000`
- **Benefits**:
  - No need to wait for hourly scheduled tests
  - Immediate speed test on startup
  - Configurable intervals for rapid testing
  - Custom database path support via `DB_PATH` environment variable

## Breaking Changes
None - all changes are backward compatible.

## Migration Guide
No migration required. Simply update to version 1.2.0:
```bash
npm update -g network-performance-monitor
```

## Testing
New regression test suite added:
```bash
# Run all tests including build
npm run test:all

# Run scheduled speed test regression only
npm run test:scheduled
```

## Known Issues
None at this time.

## Next Steps
- Monitor scheduled speed tests to ensure reliability
- Consider adding more network detection methods for other platforms
- Explore options for handling speedtest-cli updates and deprecations