FOQA Narrative Generator

Paste deterministic summary JSON (or upload a file), then generate a narrative report using OpenAI.

Default loaded summary source: processed summary (data/processed/Demo_20260304_232306/summary.json)

Processed Flight

Model

Max Output Tokens

Safety Identifier (optional)

API Key Override (optional)

Upload Summary JSON (optional) Summary JSON

{
  "metadata": {
    "session_id": "Demo_20260304_232306",
    "started_at": "2026-03-05T04:23:06Z",
    "ended_at": "2026-03-05T04:41:22Z",
    "sample_rate": "medium",
    "app_version": "1.0 (2)",
    "device_model": "iPhone16,1",
    "system_version": "26.3",
    "enabled_sensors": [
      "accelerometer",
      "barometer",
      "deviceMotion",
      "gyroscope",
      "location",
      "magnetometer"
    ]
  },
  "key_metrics": {
    "duration_seconds": 1096.028,
    "max_groundspeed_kts": 110.0,
    "max_bank_angle_deg": 45.0,
    "max_abs_pitch_deg": 10.0,
    "touchdown_vertical_accel_g": 1.349
  },
  "quality_flags": [
    {
      "id": "possible_late_start",
      "severity": "low",
      "detected": false,
      "evidence": [
        "First valid groundspeed sample at t=30.5s was 1.2 kts.",
        "Low-speed movement was observed before acceleration."
      ]
    },
    {
      "id": "possible_early_stop",
      "severity": "low",
      "detected": false,
      "evidence": [
        "Last valid groundspeed sample at t=1095.7s was 6.0 kts.",
        "Low-speed segment present near recording end."
      ]
    },
    {
      "id": "device_mount_movement",
      "severity": "medium",
      "detected": true,
      "evidence": [
        "Max gravity-frame baseline shift 73.9 deg at t=630.0s.",
        "Shift exceeds movement threshold and may indicate mount disturbance."
      ]
    }
  ],
  "phase_timeline": [
    {
      "phase": "taxi_out",
      "start_s": 0.0,
      "end_s": 125.1
    },
    {
      "phase": "takeoff_roll",
      "start_s": 125.1,
      "end_s": 150.6
    },
    {
      "phase": "climb",
      "start_s": 150.6,
      "end_s": 270.83
    },
    {
      "phase": "cruise",
      "start_s": 270.83,
      "end_s": 775.1
    },
    {
      "phase": "descent",
      "start_s": 775.1,
      "end_s": 960.09
    },
    {
      "phase": "approach_landing",
      "start_s": 960.09,
      "end_s": 1020.59
    },
    {
      "phase": "taxi_in",
      "start_s": 1020.59,
      "end_s": 1096.03
    }
  ],
  "events": [
    {
      "id": "hard_landing_proxy",
      "severity": "low",
      "detected": false,
      "time_s": 1044.99,
      "metric": "touchdown_vertical_accel_g",
      "value": 1.349,
      "threshold": 1.8
    },
    {
      "id": "steep_turn",
      "severity": "medium",
      "detected": true,
      "time_s": 566.5,
      "metric": "bank_angle_deg",
      "value": 45.0,
      "threshold": 35.0
    }
  ],
  "notes": [
    "Enabled sensors: accelerometer, barometer, deviceMotion, gyroscope, location, magnetometer.",
    "Markers recorded: 0; scenePhase events: 24.",
    "events: 26 samples, max gap 681.84s.",
    "location: 1080 samples, max gap 1.04s.",
    "device_motion: 32879 samples, max gap 0.07s.",
    "accelerometer: 32879 samples, max gap 0.07s.",
    "gyroscope: 32879 samples, max gap 0.07s.",
    "magnetometer: 32879 samples, max gap 0.07s.",
    "barometer: 1080 samples, max gap 1.04s."
  ],
  "weather": {
    "provider": "metar_db",
    "status": "ok",
    "config": {
      "window_minutes": 90,
      "max_stations_per_anchor": 3,
      "station_search_radius_nm": 120.0,
      "stations_table": "wx_stations",
      "metars_table": "wx_metars_history"
    },
    "anchors": [
      {
        "id": "recording_start",
        "time_s": 0.027,
        "time_utc": "2026-03-05T04:23:06Z",
        "position": {
          "lat": 39.077999,
          "lon": -77.557503
        },
        "station_candidates": [
          {
            "station_id": "KJYO",
            "latitude": 39.0826,
            "longitude": -77.5605,
            "distance_nm": 0.31
          },
          {
            "station_id": "KIAD",
            "latitude": 38.9348,
            "longitude": -77.4473,
            "distance_nm": 10.02
          },
          {
            "station_id": "KGAI",
            "latitude": 39.1696,
            "longitude": -77.1653,
            "distance_nm": 19.08
          }
        ],
        "selected_station": {
          "station_id": "KJYO",
          "latitude": 39.0826,
          "longitude": -77.5605,
          "distance_nm": 0.31
        },
        "metar": {
          "observation_time": "2026-03-05T04:15:00Z",
          "age_minutes": 8.1,
          "raw_text": "METAR KJYO 050415Z AUTO 34003KT 1/4SM FG OVC003 07/07 A3023 RMK AO2",
          "flight_category": "LIFR",
          "temp_c": 7.0,
          "dewpoint_c": 7.0,
          "wind_dir_degrees": "340",
          "wind_speed_kt": 3,
          "wind_gust_kt": null,
          "visibility_statute_mi": "0.25",
          "altim_in_hg": 30.23,
          "wx_string": "FG",
          "sky_condition": "[{'sky_cover': 'OVC', 'cloud_base_ft_agl': '300'}]"
        }
      },
      {
        "id": "recording_midpoint",
        "time_s": 545.663,
        "time_utc": "2026-03-05T04:32:11Z",
        "position": {
          "lat": 38.932575,
          "lon": -77.389604
        },
        "station_candidates": [
          {
            "station_id": "KIAD",
            "latitude": 38.9348,
            "longitude": -77.4473,
            "distance_nm": 2.7
          },
          {
            "station_id": "KJYO",
            "latitude": 39.0826,
            "longitude": -77.5605,
            "distance_nm": 12.03
          },
          {
            "station_id": "KHEF",
            "latitude": 38.724,
            "longitude": -77.5175,
            "distance_nm": 13.88
          }
        ],
        "selected_station": {
          "station_id": "KIAD",
          "latitude": 38.9348,
          "longitude": -77.4473,
          "distance_nm": 2.7
        },
        "metar": {
          "observation_time": "2026-03-05T04:52:00Z",
          "age_minutes": 19.8,
          "raw_text": "METAR KIAD 050452Z 00000KT 1/2SM R01R/P6000FT FG BKN002 OVC050 09/08 A3021 RMK AO2 SLP231 T00890083 401170061 $",
          "flight_category": "LIFR",
          "temp_c": 8.9,
          "dewpoint_c": 8.3,
          "wind_dir_degrees": "0",
          "wind_speed_kt": 0,
          "wind_gust_kt": null,
          "visibility_statute_mi": "0.5",
          "altim_in_hg": 30.21,
          "wx_string": "FG",
          "sky_condition": "[{'sky_cover': 'BKN', 'cloud_base_ft_agl': '200'},{'sky_cover': 'OVC', 'cloud_base_ft_agl': '5000'}]"
        }
      },
      {
        "id": "recording_end",
        "time_s": 1095.697,
        "time_utc": "2026-03-05T04:41:21Z",
        "position": {
          "lat": 38.952148,
          "lon": -77.456455
        },
        "station_candidates": [
          {
            "station_id": "KIAD",
            "latitude": 38.9348,
            "longitude": -77.4473,
            "distance_nm": 1.13
          },
          {
            "station_id": "KJYO",
            "latitude": 39.0826,
            "longitude": -77.5605,
            "distance_nm": 9.21
          },
          {
            "station_id": "KHEF",
            "latitude": 38.724,
            "longitude": -77.5175,
            "distance_nm": 13.99
          }
        ],
        "selected_station": {
          "station_id": "KIAD",
          "latitude": 38.9348,
          "longitude": -77.4473,
          "distance_nm": 1.13
        },
        "metar": {
          "observation_time": "2026-03-05T04:52:00Z",
          "age_minutes": 10.7,
          "raw_text": "METAR KIAD 050452Z 00000KT 1/2SM R01R/P6000FT FG BKN002 OVC050 09/08 A3021 RMK AO2 SLP231 T00890083 401170061 $",
          "flight_category": "LIFR",
          "temp_c": 8.9,
          "dewpoint_c": 8.3,
          "wind_dir_degrees": "0",
          "wind_speed_kt": 0,
          "wind_gust_kt": null,
          "visibility_statute_mi": "0.5",
          "altim_in_hg": 30.21,
          "wx_string": "FG",
          "sky_condition": "[{'sky_cover': 'BKN', 'cloud_base_ft_agl': '200'},{'sky_cover': 'OVC', 'cloud_base_ft_agl': '5000'}]"
        }
      }
    ],
    "notes": [
      "Matched METAR for all 3 anchors."
    ]
  }
}

Upload Callback Tester

Send a test request to /api/cloudkit/upload-complete with the same shape mobile app uses.

Redis queue target: foqa:cloudkit:record_names

Response

No request sent yet.