{
  "catalogVersion": 1,
  "models": [
    {
      "id": "planning",
      "title": "Planning documents",
      "owner": "Planning + PlanningNative",
      "maturity": "contract",
      "versions": "Intent 1.0; result, snapshot, draw and edit 1.1",
      "source": "modules/planning/schema/v1_1/README.md",
      "useCases": "Save editable intent, derive a route and publish accepted calculations with map ownership.",
      "consumers": "Rust CLI / C ABI producer; Swift coordinator; independent Python readers",
      "adoption": "Validate drafts before taking ownership. Capture resource identities, negotiate planning-v1.1, and admit a matched snapshot/draw pair.",
      "semantics": "Document, commit, stop, leg and element occurrence IDs have different lifetimes. WGS84 coordinates; explicit scientific and display altitude datums.",
      "failures": "A structurally valid draft may be incomplete. A usable path can have unavailable evaluation. Reject stale captures and unsupported versions.",
      "validator": "modules/planning/schema/v1_1/check.sh",
      "fixture": "modules/planning/examples/document-lifecycle/request.json",
      "guide": "/planning/quickstart",
      "release": "2026-11-21",
      "supersedes": null
    },
    {
      "id": "trips",
      "title": "Trips and flights",
      "owner": "Planning / FlightManagement",
      "maturity": "internal",
      "versions": "Portable planning intent 1.0; host store versions remain separate",
      "source": "apps/ios/Planning/Sources/Planning/TripStore.swift",
      "useCases": "Organize a journey and its leg occurrences, then connect durable plans to the host flight workflow.",
      "consumers": "Swift Planning stores and FlightManagement adapters",
      "adoption": "Use the existing coordinator for portable planning documents. Host Trip types are adapters; a universal trip/flight interchange contract is not yet certified.",
      "semantics": "A stop occurrence represents a visit, including repeated airports. A flight execution and its recorded track do not overwrite the saved plan.",
      "failures": "Divergent commits need explicit reconciliation; unknown legacy route components require an import assessment.",
      "validator": "apps/ios/Planning/Tests/PlanningTests/PlanningDocumentCoordinatorTests.swift",
      "fixture": null,
      "guide": "/tracks-and-trips",
      "release": "2026-11-21",
      "supersedes": null
    },
    {
      "id": "tracks",
      "title": "Recorded tracks and track logs",
      "owner": "PositionCore",
      "maturity": "internal",
      "versions": "CSV schema 2; Swift/SQLite records are internal",
      "source": "apps/ios/Position/Sources/PositionCore/TrackHistory/TrackHistoryCSV.swift",
      "useCases": "Preserve measured positions and export a flight history without turning missing samples into flown segments.",
      "consumers": "Swift PositionCore CSV import/export and track geometry",
      "adoption": "Use the owner CSV importer for the existing interchange. A portable JSON track contract and cross-client writer matrix remain pending.",
      "semantics": "Time is Unix seconds in current geometry; coordinates are degrees. Sensor altitude and ellipsoid altitude remain distinct. Preserve sample/source IDs and accuracy sentinels.",
      "failures": "Gaps split geometry runs. Display thinning does not change measured distance. A torn final CSV row can be reported and skipped.",
      "validator": "apps/ios/Aeronautiql/AeronautiqlTests/TrackHistoryCSVTests.swift",
      "fixture": null,
      "guide": "/tracks-and-trips",
      "release": "2026-11-21",
      "supersedes": null
    },
    {
      "id": "procedures",
      "title": "Procedures and dynamic procedures",
      "owner": "ARINC engine / Arinc",
      "maturity": "internal",
      "versions": "Owner-specific source, domain and geometry revisions",
      "source": "server/nasr/arinc424/engine/crates/a424-core/src/typed.rs",
      "useCases": "Select SID, STAR or approach transitions; retain coded leg constraints while deriving geometry.",
      "consumers": "Rust ARINC ingestion and geometry; Apple Arinc consumers",
      "adoption": "Inspect typed records and owner adapters. Dynamic parameters and generated geometry require different identities; a unified public writable procedure contract remains under audit.",
      "semantics": "Preserve source/cycle identity, airport and transition qualification, leg order, discontinuities and operational constraints.",
      "failures": "Do not replace coded procedure semantics with the rendered polyline or invent editable fixes from generated vertices.",
      "validator": null,
      "fixture": null,
      "guide": "/navigation",
      "release": "2026-11-21",
      "supersedes": null
    },
    {
      "id": "fixes",
      "title": "Fixes and navaids",
      "owner": "Navigation / ARINC / AeronauticMap",
      "maturity": "audited",
      "versions": "Existing navigation map schema; portable identity rules under review",
      "source": "docs/specs/nav/nav-map-element.schema.json",
      "useCases": "Resolve a navigation entity, qualify duplicate identifiers and draw a point.",
      "consumers": "Navigation pipeline and native map consumers",
      "adoption": "The existing schema describes map elements. Its namespace and qualified_ident fields are optional; clients must not treat schema acceptance as proof of globally unique identity.",
      "semantics": "Ident alone is not global identity. Preserve kind, region/namespace, qualified reference, cycle and WGS84 position.",
      "failures": "Ambiguous identities need resolution against a captured dataset; do not choose the first ident match.",
      "validator": null,
      "fixture": null,
      "guide": "/navigation",
      "release": "2026-11-21",
      "supersedes": null
    },
    {
      "id": "airways",
      "title": "Airways",
      "owner": "Navigation / Router",
      "maturity": "audited",
      "versions": "Existing map segments and owner routing graph",
      "source": "docs/specs/nav/nav-map-element.schema.json",
      "useCases": "Traverse constrained directed segments and display the selected route.",
      "consumers": "Router graph and native map projections",
      "adoption": "Keep endpoint qualification, direction and constraints in the domain graph. A map segment is a projection, not a complete routing contract.",
      "semantics": "Segment identity includes its endpoints and source scope; altitude restrictions need explicit unit and datum.",
      "failures": "Direction, availability, altitude and discontinuities must survive adapters; drawing connectivity alone does not prove routing eligibility.",
      "validator": null,
      "fixture": null,
      "guide": "/navigation",
      "release": "2026-11-21",
      "supersedes": null
    },
    {
      "id": "airspace",
      "title": "Airspace volumes",
      "owner": "Navigation / AeronauticMap",
      "maturity": "audited",
      "versions": "Existing airspace map schema; volume contract under review",
      "source": "docs/specs/nav/airspace-element.schema.json",
      "useCases": "Display lateral boundaries and evaluate vertical and temporal applicability.",
      "consumers": "Navigation pipeline and native AirspaceElement",
      "adoption": "Preserve boundary geometry and raw vertical restrictions. Model activation separately from static volume and separately from rendering.",
      "semantics": "Polygon coordinates are longitude/latitude. Local database row IDs are not portable identity; distinguish MSL, AGL, pressure, surface, unlimited and unknown.",
      "failures": "Nominal display heights are not operational vertical bounds. Missing activation is not proof of inactivity.",
      "validator": null,
      "fixture": null,
      "guide": "/navigation",
      "release": "2026-11-21",
      "supersedes": null
    },
    {
      "id": "weather",
      "title": "Observations and forecasts",
      "owner": "Weather service / Weather",
      "maturity": "internal",
      "versions": "Product-specific DTOs; common version negotiation pending",
      "source": "server/weather/src/main/java/co/postflight/aeronautiql/model/FusedWeatherData.java",
      "useCases": "Read METAR observations, TAF periods, PIREPs and weather hazards with their validity and source.",
      "consumers": "Java service, Swift Weather, web and MCP adapters",
      "adoption": "Use product-specific DTOs. A shared family catalog does not imply every consumer implements identical fields or update semantics.",
      "semantics": "Separate observation, issue, valid, ingestion and selection times. Probabilities and forecast conditions are not measurements.",
      "failures": "Missing, stale, unknown and unavailable are distinct; a successful response can be partial.",
      "validator": null,
      "fixture": null,
      "guide": "/weather",
      "release": "2026-11-21",
      "supersedes": null
    },
    {
      "id": "weather-fusion",
      "title": "Weather Fusion",
      "owner": "Weather service / native Weather Fusion",
      "maturity": "internal",
      "versions": "Existing aggregate and client selection models",
      "source": "apps/ios/Weather/Package/Sources/Weather/Fusion/WeatherFusion.swift",
      "useCases": "Combine product availability and selected weather into a client-facing view while retaining provenance.",
      "consumers": "Java FusedWeatherData; Swift Weather Fusion",
      "adoption": "Keep aggregate DTOs and the client selection/cache layer distinct. server/fusion is a dataset catalog, not this weather model owner.",
      "semantics": "A fused snapshot needs product-specific times, source identity, selection/freshness policy and partial state.",
      "failures": "Aggregate existence is not complete weather. Native and service Swift model copies need an ownership/conformance audit.",
      "validator": "apps/ios/Weather/Package/Tests/WeatherTests/Models/FusedWeatherDataTests.swift",
      "fixture": null,
      "guide": "/weather",
      "release": "2026-11-21",
      "supersedes": null
    },
    {
      "id": "mos",
      "title": "MOS guidance",
      "owner": "Weather MOS service / Weather / web / MCP",
      "maturity": "internal",
      "versions": "Auto, LAMP and NBM products; existing consumer DTOs",
      "source": "server/weather/src/main/java/co/postflight/aeronautiql/model/mos/MosGuidanceModels.java",
      "useCases": "Display station-hour guidance and explain why each selected field came from LAMP or NBM.",
      "consumers": "Java blender; Swift MosGuidance; web mosAPI; MCP MOS queries",
      "adoption": "Auto selects LAMP first with per-field NBM fallback. Preserve per-field sources, raw guidance and status; do not blend whole rows by source label.",
      "semantics": "Station, product, model run, valid time/interval, ingestion and projection hour differ. Unknown and unlimited ceiling remain distinct.",
      "failures": "Used, stale, future, missing and invalid source states matter. Missing probabilities are not zero.",
      "validator": "server/weather/src/test/java/co/postflight/aeronautiql/service/MosGuidanceBlenderTest.java",
      "fixture": "server/weather/docs/mos-fixtures/README.md",
      "guide": "/weather",
      "release": "2026-11-21",
      "supersedes": null
    },
    {
      "id": "winds",
      "title": "Gridded winds, soundings and hazards",
      "owner": "Weather / Winds / native planning",
      "maturity": "internal",
      "versions": "Owner-specific grids; planning captured-resource contract",
      "source": "modules/planning/rust/planning_engine/README.md",
      "useCases": "Sample atmospheric fields for trajectories, inspect vertical columns and retain temporal hazard geometry.",
      "consumers": "Native Winds and planning resource adapters; weather clients",
      "adoption": "Capture verified source coverage before evaluating. Portable provenance travels with the job; native handles remain host-local. Sounding and hazard interchange still needs a family audit.",
      "semantics": "Specify model run, grid axes, coordinate order, pressure/height levels, variable units and time interpolation policy.",
      "failures": "Unavailable coverage cannot silently become calm wind. Explicit estimates carry their own method and disclosure.",
      "validator": null,
      "fixture": null,
      "guide": "/weather",
      "release": "2026-11-21",
      "supersedes": null
    }
  ]
}
