Implementation Checkpoint

[ContinuumLS]

Summary

This PR brings the feature-ai branch up to a more capable real-time dashboard for the HamSCI Ground Magnetometer network inline with the minimum requirements. It adds live data ingestion over WebSocket and MQTT, a redesigned configuration panel, a tabbed multi-source interface, on-the-fly data processing (orientation transforms and moving-average filtering), configurable visualization, and the supporting Docker/AI-governance infrastructure.

All connection, processing, and multi-source behavior was verified end-to-end in a headless browser against local fake WebSocket/MQTT hosts; the moving-average algorithm also has unit tests.

Issues closed

• Closes Performance: Handle 1 Hz Data Without Memory Leaks #9 — Performance: handle 1 Hz data without memory leaks (bounded per-source buffers)
• Closes Implement Configurable Time Windows #17 — Configurable time windows (1m / 5m / 15m / 1h)
• Closes Calculate and Display Total Field Magnitude #18 — Calculate and display total-field magnitude
• Closes Implement MQTT-over-WebSocket Data Ingestion #19 — MQTT-over-WebSocket data ingestion
• Closes Implement Configuration Panel for Connection Settings #20 — Configuration panel for connection settings
• Closes Implement Tabbed Interface for Multiple Data Sources #21 — Tabbed interface for multiple data sources
• Closes Implement Configurable 90-Degree Orientation Transformations #22 — Configurable 90° orientation transformations
• Closes Implement Moving Average Filtering #24 — Moving-average filtering
• Closes Optional: Add Mini Sparkline Charts for Quick Overview #28 — Mini sparkline charts for a quick overview

Highlights

Data ingestion & connections (#19, #20)

• A per-source connection manager (js/transit.js) with pluggable WebSocket and MQTT-over-WebSocket transports, both emitting the same normalized readings. MQTT supports a configurable broker/topic, optional username/password auth (with an "Auth failed" status), and automatic reconnection. Vendors mqtt.js.
• A redesigned, opaque Configuration panel (sidebar): source name, a WebSocket / MQTT / File source-type selector with conditional fields, input validation, a single Connect action, and localStorage persistence with auto-reconnect on load.

Multiple data sources (#21)

• A tab bar for monitoring several stations at once. Each tab has an independent connection and data buffer; all tabs stay connected and keep buffering in the background, while the active tab drives the shared plots/spreadsheet/trends. Add / switch / close, per-tab status dots, live rename, and a source cap for performance.

Data processing (#22, #24)

• Orientation transforms: per-source 90° X/Y/Z rotations applied to the displayed field.
• Moving-average filtering: a trailing, time-based filter (10 / 30 / 60 s) overlaid on the raw data, with the raw series faded; handles data gaps gracefully. Includes unit tests (js/filter_test.js).

Visualization (#17, #18, #28)

• Configurable time window with autoscroll that the user can pause by zooming/panning.
• Total-field magnitude shown in the Current Reading panel, the spreadsheet, and as its own plot trace.
• Sparkline "Trends" for a compact at-a-glance overview.
• A static spreadsheet header over an independently scrolling body, and a layout bounded to the viewport.

Performance (#9)

• Per-source measurement and sparkline buffers are capped (rolling window) so a continuous 1 Hz feed doesn't grow unbounded.

Infrastructure & governance

• Docker/Deno serving, project docs, and the AI-governance scaffold. All AI-assisted commits are disclosed in ai/ai_usage_log.md per University of Scranton / HamSCI / NSF policy.

Testing

• Headless-browser (Playwright) verification of: WebSocket and MQTT connect/receive/render, MQTT auth accept/reject, connection-panel validation/persistence/auto-reconnect, file load, rotation, moving-average overlay, and the full multi-tab flow (two independent live sources, background buffering, persistence + reconnect-on-reload, clean switch between sources).
• Unit tests for the moving-average filter (deno test js/filter_test.js).

Notes

• Adds a vendored dependency: vendor/mqtt.min.js (MQTT.js 5.x).
• The Light/Dark mode toggle is present in the UI but not yet wired up.

🤖 Generated with Claude Code (minor edits by author)