How neilcochran/squawk works
@squawk is a modular TypeScript aviation toolkit rather than a single end-user application. Its principal workflow is to accept aviation records or queries, parse/decode or resolve them against FAA snapshots, and return structured aviation data or calculations; consumers can also reach these capabilities through the MCP server. The graph preserves the README’s weather, NOTAM, aeronautical-data, flight-planning, surveillance, and AI-integration branches, plus the three visible applications. Connections for unsampled subsystems reflect README/package descriptions, not inspected implementation details.
Main entry points: tools Aviation tool groups · src/index.ts Live ADS-B feeds · src/index.ts Weather parsing and fetch · src/index.ts Airport queries
Components 30
Weather and NOTAMs
- Weather parsing and fetch
packages/libs/weather/src/index.ts - NOTAM parsing
packages/libs/notams/src/index.ts
Aeronautical data
- Airport snapshot
packages/libs/airport-data/src/browser.ts - Airport queries
packages/libs/airports/src/index.ts - Airspace snapshot
packages/libs/airspace-data/src/browser.ts - Airspace queries
packages/libs/airspace/src/index.ts - Navaid snapshot
packages/libs/navaid-data/src/browser.ts - Navaid queries
packages/libs/navaids/src/index.ts - Fix snapshot
packages/libs/fix-data/src/browser.ts - Fix queries
packages/libs/fixes/src/index.ts - Airway snapshot
packages/libs/airway-data/src/browser.ts - Airway queries
packages/libs/airways/src/index.ts - Procedure snapshot
packages/libs/procedure-data/src/browser.ts - Procedure queries
packages/libs/procedures/src/index.ts
Flight planning
- Flight plan routing
packages/libs/flightplan/src/index.ts - Flight calculations
packages/libs/flight-math/src/index.ts - Geospatial utilities
packages/libs/geo/src/index.ts
ADS-B surveillance
- Live ADS-B feeds
packages/libs/adsb-feed/src/index.ts - Mode-S decoding
packages/libs/mode-s/src/index.ts - Beast stream parsing
packages/libs/beast/src/index.ts - Aircraft registry
packages/libs/icao-registry/src/index.ts
Applications and MCP
- MCP server
packages/libs/mcp/src/server.ts - Aviation tool groups
packages/libs/mcp/src/tools - Aeronautical chart app
apps/atlas/src/main.tsx - ADS-B scope app
apps/adsbscope/src/ui/main.tsx - ADS-B terminal app
apps/adsbtop/src/main.tsx
Other components
- Library consumer
- Aviation Weather Center
- FAA data sources
- MCP-compatible client
Connections 47
- Library consumer → Weather parsing and fetch: parses / fetches
- Library consumer → NOTAM parsing: parses
- Aviation Weather Center → Weather parsing and fetch: provides reports
- FAA data sources → Airport snapshot: supplies snapshot
- FAA data sources → Airspace snapshot: supplies snapshot
- FAA data sources → Navaid snapshot: supplies snapshot
- FAA data sources → Fix snapshot: supplies snapshot
- FAA data sources → Airway snapshot: supplies snapshot
- FAA data sources → Procedure snapshot: supplies snapshot
- Airport snapshot → Airport queries: provides records
- Airspace snapshot → Airspace queries: provides records
- Navaid snapshot → Navaid queries: provides records
- Fix snapshot → Fix queries: provides records
- Airway snapshot → Airway queries: provides records
- Procedure snapshot → Procedure queries: provides records
- Library consumer → Airport queries: queries
- Library consumer → Airspace queries: queries
- Library consumer → Navaid queries: queries
- Library consumer → Fix queries: queries
- Library consumer → Airway queries: queries
- Library consumer → Procedure queries: queries
- Library consumer → Flight plan routing: parses routes
- Library consumer → Flight calculations: calculates
- Library consumer → Geospatial utilities: computes geometry
- Library consumer → Live ADS-B feeds: connects feed
- Live ADS-B feeds → Mode-S decoding: decodes messages
- Live ADS-B feeds → Beast stream parsing: parses Beast
- Library consumer → Aircraft registry: looks up aircraft
- MCP-compatible client → MCP server: sends MCP requests
- MCP server → Aviation tool groups: registers tools
- Aviation tool groups → Weather parsing and fetch: exposes
- Aviation tool groups → NOTAM parsing: exposes
- Aviation tool groups → Airport queries: exposes
- Aviation tool groups → Airspace queries: exposes
- Aviation tool groups → Navaid queries: exposes
- Aviation tool groups → Fix queries: exposes
- Aviation tool groups → Airway queries: exposes
- Aviation tool groups → Procedure queries: exposes
- Aviation tool groups → Flight plan routing: exposes
- Aviation tool groups → Flight calculations: exposes
- Aviation tool groups → Geospatial utilities: exposes
- Aviation tool groups → Aircraft registry: exposes
- Library consumer → Aeronautical chart app: uses chart
- Library consumer → ADS-B scope app: monitors traffic
- Library consumer → ADS-B terminal app: monitors traffic
- ADS-B scope app → Live ADS-B feeds: consumes live feed
- ADS-B terminal app → Live ADS-B feeds: consumes live feed