{"id":51851178,"url":"https://github.com/phobos-dthorga/onair-wyrmgrid","last_synced_at":"2026-07-23T19:30:31.051Z","repository":{"id":371133596,"uuid":"1299326033","full_name":"phobos-dthorga/onair-wyrmgrid","owner":"phobos-dthorga","description":"A modular, open-source operations and intelligence platform for OnAir Airline Manager.","archived":false,"fork":false,"pushed_at":"2026-07-20T15:14:54.000Z","size":19637,"stargazers_count":0,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-20T17:14:48.295Z","etag":null,"topics":["flight-simulator","maplibre","onair-airline-manager","plugin-platform","rust","sqlite","svelte","tauri"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phobos-dthorga.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":"GOVERNANCE.md","roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-07-13T13:30:39.000Z","updated_at":"2026-07-20T11:55:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/phobos-dthorga/onair-wyrmgrid","commit_stats":null,"previous_names":["phobos-dthorga/onair-wyrmgrid"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/phobos-dthorga/onair-wyrmgrid","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phobos-dthorga%2Fonair-wyrmgrid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phobos-dthorga%2Fonair-wyrmgrid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phobos-dthorga%2Fonair-wyrmgrid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phobos-dthorga%2Fonair-wyrmgrid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phobos-dthorga","download_url":"https://codeload.github.com/phobos-dthorga/onair-wyrmgrid/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phobos-dthorga%2Fonair-wyrmgrid/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35814999,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-23T02:00:06.683Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flight-simulator","maplibre","onair-airline-manager","plugin-platform","rust","sqlite","svelte","tauri"],"created_at":"2026-07-23T19:30:30.323Z","updated_at":"2026-07-23T19:30:31.045Z","avatar_url":"https://github.com/phobos-dthorga.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OnAir WyrmGrid\n\n\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"assets/brand/key-art/derivatives/hero-dark.png\"\u003e\n  \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"assets/brand/key-art/derivatives/hero-light.png\"\u003e\n  \u003cimg alt=\"OnAir WyrmGrid — See the network. Command the skies.\" src=\"assets/brand/key-art/derivatives/hero-dark.png\"\u003e\n\u003c/picture\u003e\n\n**A modular, open-source operations and intelligence platform for OnAir Airline Manager.**\n\nOnAir WyrmGrid is a local-first desktop application for understanding fleets,\njobs, FBO networks, maintenance, finance, flight history, and simulator context\nthrough one connected world map. It is designed as a community platform: most\nfirst-party intelligence modules will use the same versioned, permission-aware\nplugin boundary available to third-party developers. Every component presented\nas a plugin or provider is intended to remain an external, independently\ninstallable artifact rather than a feature that exists only when compiled into\nWyrmGrid.\n\n\u003e **Project status:** foundation stage. Session-only OnAir connection, Atlas,\n\u003e Hoard, read-only Jobs-to-Dispatch comparison, and the first supervised Python\n\u003e plugin proof are implemented. The versioned Bridge supervisor, read-only MSFS\n\u003e 2024 SimConnect provider, desktop telemetry view, and permission-filtered\n\u003e plugin snapshots are also implemented. Ordinary plugin and simulator\n\u003e provider package version 1 add offline inspection and installation, immutable\n\u003e managed versions, disable, rollback, removal, and separately distributable\n\u003e first-party artifacts. Live simulator certification, external audio-provider\n\u003e packaging, broader user-token credential support, publisher signing,\n\u003e sandboxing, and broader operational integrations remain ahead.\n\n## Vision\n\n- **WyrmGrid Atlas** — universal operations map\n- **WyrmGrid Hoard** — local history and cached data\n- **WyrmGrid Forge** — plugin SDK and developer tools\n- **WyrmGrid Aerie** — future community plugin catalogue\n- **WyrmGrid Bridge** — MSFS 2024-first simulator and hardware integration\n- **WyrmGrid Oracle** — explainable scoring and recommendations\n- **WyrmGrid Watch** — alerts and monitoring\n- **WyrmGrid Dispatch** — canonical flight-plan inspection with a session-only,\n  read-only SimBrief latest-OFP developer preview, explainable OnAir fleet\n  and selected-job cross-checks, and session-cached airport METAR/TAF context\n\n## Technical foundation\n\n| Area                         | Initial choice                          |\n| ---------------------------- | --------------------------------------- |\n| Desktop shell                | Tauri 2                                 |\n| Core and services            | Rust 2024                               |\n| Interface                    | Svelte 5 and TypeScript                 |\n| Map                          | MapLibre GL JS                          |\n| Detailed weather             | Three.js WebGPU with WebGL2 fallback    |\n| Charts                       | Apache ECharts behind WyrmChart         |\n| Localization                 | Fluent with canonical `en-AU` fallback  |\n| Local storage                | SQLCipher-encrypted SQLite              |\n| Plugin boundary              | Out-of-process, versioned JSON messages |\n| Native simulator integration | Separate versioned provider sidecars    |\n\nThe Rust workspace currently uses eight cohesive libraries plus the desktop and\nSimConnect provider executables:\n\n- `wyrmgrid-domain` — stable application-owned types and provenance;\n- `wyrmgrid-onair-api` — credential-safe, read-only OnAir boundary;\n- `wyrmgrid-storage` — SQLCipher ownership, migrations, and portable backups;\n- `wyrmgrid-application` — interface-independent orchestration;\n- `wyrmgrid-bridge-protocol` — versioned simulator-provider framing and\n  manifests;\n- `wyrmgrid-audio-provider-protocol` — versioned audio-provider control and\n  bounded PCM framing;\n- `wyrmgrid-audio-codec-protocol` — versioned out-of-process encoding control\n  and bounded packet framing;\n- `wyrmgrid-plugin-protocol` — public manifest and permission contracts;\n- `wyrmgrid-simbrief-api` — bounded private SimBrief response translation;\n- `wyrmgrid-weather-api` — bounded AviationWeather.gov METAR/TAF translation.\n\n`wyrmgrid-simconnect-provider` is the first supervised Bridge sidecar and ships\nas a separately installable `.wyrmprovider` artifact. Other providers such as\nFSUIPC use the same stable boundary rather than linking a native simulator ABI\ninto the desktop process.\n\nAudio Capture Providers use the separate supervised audio protocol and ship as\nindependently installable `.wyrmaudio` artifacts. The current deterministic\nreference package is synthetic and does not claim native capture.\n\n## Core promises\n\n1. Plugins do not receive the raw OnAir API key.\n2. Raw facts, derived calculations, and recommendations remain distinguishable.\n3. OnAir access is treated as read-only unless current official documentation\n   proves otherwise.\n4. First-party modules prove the public plugin surface wherever practical.\n5. Cached data records when and where it was observed.\n6. Plugin permissions are explicit and deny-by-default.\n7. Unsupported browser or UI automation is outside the official platform.\n8. SimBrief, weather, online networks, navigation data, and simulators remain\n   optional providers behind application-owned models; the current SimBrief and\n   airport-weather flows are explicit, session-only, and read-only.\n9. Community language packs are bounded, data-only, locally validated, and\n   unable to replace protected legal, credential, permission, or error text.\n10. Plugins and providers can be installed, replaced, disabled, updated, and\n    removed without rebuilding WyrmGrid; first-party bundling is optional\n    convenience, not architectural privilege.\n\n## Development\n\n### Prerequisites\n\n- Rust 1.97 with the MSVC toolchain on Windows;\n- Node.js 22 and npm 10 or newer;\n- Tauri's platform prerequisites;\n- Microsoft Edge WebView2 on Windows.\n\nThe MSFS 2024 SDK is optional for ordinary builds. It is needed for local\nSimConnect development and live provider validation; Microsoft SDK binaries are\nnot stored in this repository.\n\nThen run:\n\n```powershell\nnpm install\ncargo test --workspace --exclude wyrmgrid-desktop\nnpm run check\nnpm run dev\n```\n\nNo OnAir credential is needed to compile or preview the foundation. Never put a\nreal API key in source code, test fixtures, issue reports, screenshots, or logs.\n\n### Connecting to OnAir\n\nFor now, obtain both the Company ID and API Key from **OnAir Client → Options →\nGlobal Settings**. During an authenticated WyrmGrid test on 2026-07-14, the\nstill-developing **OnAir Companion** supplied values that OnAir's public API\nrejected, while the Client-supplied values worked. Companion is expected to\nbecome OnAir's primary client, so this is a temporary compatibility rule that\nmust be retested when its API credential support reaches parity.\n\nSee [Development](docs/development.md), [Architecture](docs/architecture/overview.md),\n[Plugin platform](docs/plugins/overview.md),\n[display and performance launch options](docs/user-guide/display-and-performance.md),\n[settings and measurement units](docs/user-guide/settings-and-units.md),\n[remembered accounts and credentials](docs/user-guide/accounts-and-credentials.md),\n[External integrations](docs/integrations/README.md),\n[Simulator provider authoring](docs/integrations/simulator-provider-authoring.md),\nthe [simulator experience roadmap](docs/integrations/simulator-experience-roadmap.md),\nand [Contributing](CONTRIBUTING.md) before making structural changes.\n\n## Releases\n\nRoutine commits and pull requests compile-check the desktop without packaging\ninstallers. Every intentional semantic-version tag (`vX.Y.Z`, including\nsupported prereleases) runs the complete CI and security gates before GitHub\nbuilds platform packages and an NSIS setup executable. CI publishes checksums\nand build provenance into a draft prerelease for manual installation review.\nThe matching reviewed [changelog](CHANGELOG.md) entry supplies the GitHub\nrelease notes, including explicit new-feature, change, removal, and breaking-\nchange lists.\n\nThe WyrmGrid application does not contain, connect to, or require Hoardmind or\nany other AI assistant. Hoardmind is the maintainer's private local helper,\noutside the application and its release infrastructure. Contributors may work\nentirely by hand or, if they choose, use the optional bounded development-task\nhelpers with their own loopback Ollama or OpenAI-compatible local server. Those\nreview-only helpers cover change impact, test matrices, documentation sync,\nsynthetic fixtures, bounded implementation patches, sanitized failure triage,\nand release curation without entering the application. A maintainer may\nseparately publish a wholly generated patch as a bot-attributed commit and\nbranch through a least-privileged GitHub App, then open its draft PR under the\nhuman maintainer identity. The assistant never receives GitHub credentials or\nmerge authority. GitHub CI reads only reviewed, checked-in content and never\ncalls an AI service.\n\nNewer NSIS setups install over the existing per-user application and preserve\nits encrypted data; release CI verifies that path against the closest older\npublished setup.\nEarly releases remain drafts and prereleases until signing, updating, and live\nOnAir integration are deliberately enabled.\n\n## Licensing and trademarks\n\nSource code and documentation are available under the [MIT License](LICENSE).\nOfficial desktop builds present the current\n[Application Terms](docs/legal/terms-of-use.md) and\n[Privacy Notice](docs/legal/privacy-notice.md) before external map or optional\ndiagnostic connections begin. The Terms govern the official application without\nwithdrawing rights already granted under MIT.\n\nOnAir WyrmGrid is an independent community project. It is not affiliated with,\nendorsed by, or sponsored by OnAir Company or the developers of OnAir Airline\nManager. “OnAir” and related names may be trademarks of their respective owners.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphobos-dthorga%2Fonair-wyrmgrid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphobos-dthorga%2Fonair-wyrmgrid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphobos-dthorga%2Fonair-wyrmgrid/lists"}