feat: implement Mr. Wiggles — real-time wireless signal fox hunting sonar visualizer

[Copilot]

Bootstraps the entire Mr. Wiggles application from an empty repo (only a placeholder README existed). Implements a full-stack real-time signal visualization tool with animated crescent ripples showing RSSI, Direction of Arrival, and frequency data on an HTML5 Canvas.

Backend (backend/src/)

• index.js — Express server + HTTP + WebSocket (/ws); serves frontend statically; REST API: GET /api/status, GET /api/signals, POST /api/target
• sdr/demoSDR.js — 5 synthetic Wi-Fi signals at 60 Hz with drifting DoA, fluctuating RSSI, and randomized tx bursts; no hardware required
• sdr/hardwareSDR.js — Spawns rtl_power (RTL-SDR) or hackrf_sweep (HackRF), parses CSV output, auto-detects available backend
• processors/signalManager.js — EMA smoothing on RSSI/DoA, RSSI threshold → located flag, stale signal pruning
• utils/wsServer.js — Rate-limited broadcast loop (default 60 Hz)
• utils/helpers.js — ema, rssiToStrength, normaliseDeg, randomId (crypto-backed), bufToMac

Frontend (frontend/)

• renderer.js — 240 Hz requestAnimationFrame loop; crescent arcs emanate from centre in DoA direction; arc span and line weight scale with RSSI strength; sinusoidal beat waves modulated along each crescent by beatFreq; nested ring layers (×3); green pulsing hard circle + banner when located
• app.js — Wires WebSocket updates → renderer + sidebar UI (signal selector, info table, signal list)
• wsClient.js — WebSocket client with exponential-backoff reconnect

Infrastructure

• scripts/install-sdr.sh — Interactive RTL-SDR / HackRF udev + driver installer for Ubuntu/Debian/RPi OS
• docs/extending-antennas.md — Frame contract, DoA estimation approaches (single antenna, rotating directional, phased array), supported protocol table (BLE, Zigbee, LoRa, ADS-B, etc.)
• .env.example — All tunable parameters: DEMO_MODE, SDR_TYPE, RSSI_THRESHOLD, DOA_SMOOTHING, WS_BROADCAST_RATE_HZ, etc.

Visual parameter mapping

Signal property	Canvas effect
RSSI (dBm)	Arc thickness + brightness
Direction of Arrival (°)	Crescent emanation angle
Frequency (MHz)	Ripple travel speed + beat wave rate
Active tx	Beat wave animation intensity
RSSI ≥ threshold	Glowing green circle + "Signal Located!" banner

[GG-93]

not rtl or hack rf hardware focused make it qctually functional and usable immediately using 2.4g wifi, 5 gwifi, luetooth and bluetooth low energy being received from internal or external computer hard wired wireless modules and or esp 32 chips that are hardwired to a computer. if any of that is possible on a phone that would be nice but i dont know how with ios locked down so tight and android inconsistent between manufacterers

[Copilot]

not rtl or hack rf hardware focused make it qctually functional and usable immediately using 2.4g wifi, 5 gwifi, luetooth and bluetooth low energy being received from internal or external computer har...

Done — the app no longer requires RTL-SDR or HackRF. The new DEMO_MODE=false mode uses three native scanners that work with hardware already in any laptop/desktop:

What works out of the box (zero extra deps):

• Wi-Fi 2.4 GHz + 5 GHz via OS commands (nmcli/iwlist on Linux, airport on macOS, netsh on Windows) — sees every AP your wireless card can see with real RSSI values.

Optional (one npm install):

• Bluetooth LE — npm install @abandonware/noble inside backend/. Works with any built-in Bluetooth adapter. Discovers nearby BLE devices (phones, earbuds, fitness trackers, beacons, etc.) with live RSSI.
• ESP32 via USB serial — npm install serialport + set ESP32_PORT=/dev/ttyUSB0 in .env. The ESP32 runs a small Arduino sketch (see docs/esp32-firmware-example.md) that scans Wi-Fi and BLE and streams JSON lines to the backend, so you can use cheap ESP32 modules as remote wireless probes.

Quick start:

cp backend/.env.example backend/.env
# Edit backend/.env → DEMO_MODE=false
npm install          # from repo root
npm start
# open http://localhost:3000

For BLE on Linux, also run sudo bash scripts/install-deps.sh (choice 2 installs BlueZ + noble and sets the required cap_net_raw capability so you don't need root).

Phone/tablet: Any device on the same network can open http://<your-host-ip>:3000 to view the visualizer in its browser. The scanning happens server-side, so iOS/Android limitations don't apply — the phone is just a display.

Demo mode now also includes synthetic BLE devices (iPhone, AirPods, Galaxy Watch, etc.) alongside the Wi-Fi APs so the UI previews realistically without any hardware.

[GG-93]

?