climate event brief derived

{
  "input": {
    "type": "http",
    "method": "GET",
    "queryParams": {
      "date": "2026-09-15",
      "lang": "es",
      "units": "metric",
      "location": "Napa, CA",
      "event_type": "wedding"
    }
  },
  "output": {
    "type": "json",
    "example": {
      "sources": [
        {
          "source": "MET Norway (Norwegian Meteorological Institute)",
          "licence": "CC BY 4.0"
        },
        {
          "source": "NASA POWER (MERRA-2 / GEOS reanalysis)"
        }
      ],
      "location": "Napa, CA, United States",
      "disclaimer": "Historical odds are climatology, not a forecast. Recheck at each decision point.",
      "event_date": "2026-09-15",
      "event_type": "wedding",
      "live_forecast": {
        "reason": "event is 65 days out — beyond the 10-day forecast window; climatology only",
        "available": false
      },
      "risk_assessment": {
        "cold": "low",
        "heat": "moderate",
        "rain": "low",
        "wind": "low",
        "overall": "moderate"
      },
      "contingency_plan": [
        "Book shade structures now",
        "Schedule ceremony after 5pm"
      ],
      "headline_verdict": "A historically dry, warm date — plan for afternoon heat, not rain.",
      "historical_stats": {
        "temps": {
          "p10_high": 75.2,
          "p90_high": 93.4,
          "record_low": 45.9,
          "average_low": 52.3,
          "record_high": 101.8,
          "average_high": 84.1
        },
        "data_source": "NASA POWER daily reanalysis (MERRA-2/GEOS) — 10 years, ±3-day window, 70 sampled days",
        "unavailable": [
          "thunderstorm probability — NASA POWER publishes no weather code, so thunder days are unmeasured (not zero)"
        ],
        "probabilities_pct": {
          "frost": 0,
          "windy": 4,
          "hot_day": 27,
          "any_rain": 6,
          "extreme_heat": 3,
          "thunderstorm": null,
          "significant_rain": 1
        },
        "exact_date_by_year": [
          {
            "low": 54.1,
            "high": 88.2,
            "year": 2025,
            "conditions": null,
            "precipitation": 0
          }
        ]
      },
      "decision_timeline": {
        "decision_points": [
          {
            "date": "2026-09-05",
            "milestone": "10-day forecast window opens — first model signal, low confidence",
            "days_before_event": 10
          }
        ],
        "forecast_status": "beyond_forecast_range",
        "days_until_event": 65
      }
    }
  }
}