Skip to content

PyAerial 0.22.0 - integrity checks and research archive

Choose a tag to compare

@quantumbagel quantumbagel released this 04 Nov 04:34
· 50 commits to master since this release

Originally released 2026-10-27.

Breaking changes

  • The SQLite archive now includes schema version tracking via PRAGMA user_version. Archives generated by version 0.21.0 will be rejected until recreated using pyaerial reset --yes, as automatic migrations are not provided across this boundary.
  • General flight retention defaults to archiving all observed flights having at least archive.min_positions samples (archive.flights: all), rather than saving only flights matched by an alert rule. To restore the previous selective behavior, set archive.flights: rules.
  • dump1090 receivers now default to Beast binary format unless connected to port 30002. If you are serving AVR text over a non-standard port, explicitly specify format: avr. The sample configuration file has been updated to connect to Beast on port 30005.

Added

  • Introduced a built-in integrity monitoring engine configured under integrity, which continuously scores aircraft from 0 to 1 (ok, suspect, or spoofed) across physical and protocol checks. Checks cover angle of arrival, TDOA multilateration with automatic receiver clock synchronization, signal strength decay curves, line-of-sight radio horizons, Mode S altitude corroboration, transmission intervals, kinematics, packet replays, duplicate ICAO detection, shared-emitter clustering, and FAA registration lookups.
  • Added optional cross-network verification via integrity.cross_network (targeting adsb.lol by default), querying an external aggregator to confirm whether reported aircraft positions match wider network observations.
  • Geofence rules can now evaluate an aircraft's integrity score directly within when condition blocks.
  • Added antenna position modeling for receivers, supporting fixed position coordinates, automatic polling via position_url (which queries dump1090's receiver.json before falling back to home), and antenna elevation settings via antenna_height.
  • Introduced the aoa receiver driver for ingesting angle-of-arrival sidecar streams.
  • Added comprehensive provenance tracking to the research archive, logging detecting receivers and active integrity verdicts alongside each telemetry sample, recording verdict transitions in an integrity table, and optionally saving all raw receiver frames when archive.raw_frames is enabled.
  • The web portal displays integrity status badges in flight lists, adds an integrity inspector drawer, styles aircraft tracks according to trust, and displays multilaterated transmitter markers when spoofing is detected.

Changed

  • The /ws/raw WebSocket returns a structured JSON stream containing engine receive timestamps and the full list of detecting receivers for each frame, feeding the portal's Raw viewer. The /ws/beast stream and Beast TCP feed remain binary Beast feeds.
  • The web map has been migrated entirely to MapLibre GL, removing Leaflet and reducing the client bundle size. Flight list sorting controls have been streamlined.

Full changelog: v0.21.0...v0.22.0