Add ADR-199: Sky Monitor and SkyGraph Appliance (Phases 1–4)

[ruvnet]

Summary

Implements ADR-199: a local sky-monitoring appliance that observes, projects, records, and explains activity above a fixed physical location. The appliance treats the sky as a continuously changing spatial graph, ingesting ADS-B aircraft tracking, weather overlays, and other sensor data into a unified intelligence substrate.

This is a complete reference implementation of Phases 1–4 (with deterministic synthetic ADS-B data) built on ruvector-core and ruvector-graph, including a browser-based dashboard and acceptance test suite.

Key Changes

Core Appliance (examples/sky-monitor/)

• ADR-199 Architecture Document (docs/adr/ADR-199-sky-monitor-skygraph-appliance.md): 639-line decision record covering context, goals, architecture, deployment, and governance (§1–31)

• Coordinate System (src/coords.rs): WGS-84 → ECEF → ENU → azimuth/elevation/range/bearing projection with observer-relative spherical frame (ObserverFrame)

• Observation Schema (src/observation.rs): Canonical normalized observation format (uuid, UTC time, entity type, location, observer frame, motion, confidence) that all sensors conform to

• ADS-B Sources (src/adsb.rs):

  • Deterministic seeded synthetic scenario generator (corridor flights, arrivals/departures, GA overhead pass, anomalous low/slow night track)
  • dump1090 aircraft.json parser for real RTL-SDR data

• Track Stitching (src/track.rs): Gap-based track stitching (60-second gap threshold), summary statistics, overhead candidate detection (range < 10 km AND elevation > 5°)

• SkyGraph (src/skygraph.rs): Graph-based sky model built on ruvector_graph::GraphDB with node types (Observer, Aircraft, Track, Observation, WeatherCell, TimeWindow, Anomaly) and edge vocabulary (part_of_track, observed_by, during, near, correlated_with, similar_to, anomalous_relative_to)

• Embeddings (src/embedding.rs): Engineered 32-dimensional track embeddings (altitude, speed, heading, time-of-day, range, elevation, duration, vertical rate, azimuth buckets, signal, variability, overhead flag) normalized to [0, 1] for interpretable Euclidean distance

• Anomaly Scoring (src/anomaly.rs): Composite 6-component scoring (route deviation, altitude deviation, time-of-day rarity, signal unusualness, cross-sensor confirmation, novelty) with human-readable explanations per ADR governance rule 2

• RuVector Indexer (src/indexer.rs): Wraps ruvector_core::VectorDB for similarity search and novelty scoring (calibrated to distinguish corridor repeats from off-corridor anomalies)

• Weather (src/weather.rs): Synthetic hourly weather windows (clear/cloudy/rain/thunderstorm/snow/fog) aligned to ADS-B timeline

• Daily Brief (src/brief.rs): Human-readable summary (aircraft count, overhead candidates, unusual tracks, weather events, most unusual event with confidence)

• Pipeline Orchestration (src/pipeline.rs): End-to-end Phase 1–4 runner: scenario → observations → tracks → baseline split → RuVector index → anomaly scores → SkyGraph → daily brief

• Configuration (src/config.rs): Observer and anomaly configuration (Oakville node defaults: 43.4675 N / −79.6877 E / 100 m; ADR §15 weights; 0.76 alert threshold)

• Demo Binary (src/main.rs): Runs full pipeline and optionally exports JSON/JS for dashboard

Browser Dashboard (examples/sky-monitor/ui/dashboard/)

• HTML + Canvas (index.html, sky.js):

https://claude.ai/code/session_013Nh9Naw8gim75DGY9LBvK7