agroplan-ai-cli 1.0.36 → 1.0.37

package/backend-template/VERSION.json

@@ -1,6 +1,6 @@
 {
-  "cli_version": "1.0.36",
-  "backend_template_version": "1.0.36",
+  "cli_version": "1.0.37",
+  "backend_template_version": "1.0.37",
   "zarc_index_version": "2025-2026-fast-index-v2",
   "price_index_version": "2025-05-reference-v1",
   "features": [
@@ -25,7 +25,8 @@
     "calendar_date_safety",
     "calendar_weather_integration",
     "calendar_weather_dependency_fix",
-    "nasa_power_climatology"
+    "nasa_power_climatology",
+    "nasa_power_parser_fix"
   ],
-  "generated_at": "2026-05-10T23:00:00Z"
+  "generated_at": "2026-05-10T23:30:00Z"
 }

package/backend-template/api.py

@@ -415,6 +415,39 @@ def get_clima_nasa_power(
     except Exception as e:
         raise HTTPException(status_code=500, detail=str(e))
 
+@app.get("/dados/clima/nasa-power/debug")
+def get_clima_nasa_power_debug(
+    lat: Optional[float] = Query(None, description="Latitude"),
+    lon: Optional[float] = Query(None, description="Longitude"),
+    month: int = Query(None, description="Mês (1-12)")
+):
+    """Debug endpoint - mostra resposta bruta da NASA POWER para diagnóstico"""
+    try:
+        from providers.nasa_power_provider import buscar_climatologia_nasa_power_debug
+        
+        # Se lat ou lon não foram fornecidos, retornar informações
+        if lat is None or lon is None or month is None:
+            return {
+                "message": "Informe latitude, longitude e mês para debug NASA POWER.",
+                "exemplo": "/dados/clima/nasa-power/debug?lat=-21.56&lon=-50.45&month=5",
+                "parametros": {
+                    "lat": "Latitude da localização",
+                    "lon": "Longitude da localização",
+                    "month": "Mês (1-12)"
+                }
+            }
+        
+        if month < 1 or month > 12:
+            raise HTTPException(status_code=400, detail="Month deve estar entre 1 e 12")
+        
+        # Buscar debug info
+        debug_info = buscar_climatologia_nasa_power_debug(lat, lon, month)
+        
+        return debug_info
+        
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))
+
 @app.get("/dados/zarc")
 def get_zarc(
     cultura: Optional[str] = Query(None, description="Nome da cultura"),

package/backend-template/core/calendar_weather_adapter.py

@@ -136,7 +136,7 @@ def enriquecer_calendario_com_clima(
                 "source": weather_data.get("source", "unknown"),
                 "forecast_type": forecast_type,
                 "summary": summary,
-                "precipitation_mm": weather_data.get("precipitation_sum") or weather_data.get("precipitation_mm_avg"),
+                "precipitation_mm": weather_data.get("precipitation_sum") or weather_data.get("precipitation_monthly_total") or weather_data.get("precipitation_daily_avg"),
                 "precipitation_probability": weather_data.get("precipitation_probability"),
                 "temperature_min": weather_data.get("temperature_min"),
                 "temperature_max": weather_data.get("temperature_max"),

package/backend-template/providers/calendar_weather_provider.py

@@ -139,7 +139,8 @@ def buscar_climatologia_longo_prazo(
                 "temperature_min": nasa_data["temperature_min"],
                 "temperature_avg": nasa_data["temperature_avg"],
                 "precipitation_expected": nasa_data["precipitation_expected"],
-                "precipitation_mm_avg": nasa_data["precipitation_mm_avg"],
+                "precipitation_daily_avg": nasa_data["precipitation_daily_avg"],
+                "precipitation_monthly_total": nasa_data["precipitation_monthly_total"],
                 "confidence": "media",
                 "note": "Climatologia NASA POWER, não previsão exata"
             })
@@ -153,7 +154,7 @@ def buscar_climatologia_longo_prazo(
                 "temperature_max": climatology["temp_max"],
                 "temperature_min": climatology["temp_min"],
                 "precipitation_expected": climatology["precip_desc"],
-                "precipitation_mm_avg": climatology["precip_mm"],
+                "precipitation_daily_avg": climatology["precip_mm"],
                 "confidence": "baixa",
                 "note": "Climatologia simplificada, NASA POWER indisponível"
             })
@@ -251,7 +252,7 @@ def gerar_recomendacao_climatica(
     """
     
     forecast_type = weather_data.get("forecast_type", "climatology")
-    precip = weather_data.get("precipitation_sum") or weather_data.get("precipitation_mm_avg", 0)
+    precip = weather_data.get("precipitation_sum") or weather_data.get("precipitation_monthly_total") or weather_data.get("precipitation_daily_avg", 0)
     precip_prob = weather_data.get("precipitation_probability", 0)
     temp_max = weather_data.get("temperature_max", 25)
     temp_min = weather_data.get("temperature_min", 15)

package/backend-template/providers/nasa_power_provider.py

@@ -12,6 +12,58 @@ import requests
 from .cache import get_cache, set_cache
 
 
+# Mapeamento de mês numérico para chave NASA POWER
+MONTH_KEYS = {
+    1: "JAN",
+    2: "FEB",
+    3: "MAR",
+    4: "APR",
+    5: "MAY",
+    6: "JUN",
+    7: "JUL",
+    8: "AUG",
+    9: "SEP",
+    10: "OCT",
+    11: "NOV",
+    12: "DEC",
+}
+
+
+def get_month_value(parameter_data: Dict, month: int) -> Optional[float]:
+    """
+    Extrai valor mensal de parâmetro NASA POWER.
+    
+    Tenta múltiplos formatos de chave:
+    1. Chave alfabética (MAY, JUN, etc.) - formato padrão NASA POWER
+    2. Chave numérica string ("5", "6", etc.)
+    3. Chave numérica com zero ("05", "06", etc.)
+    
+    Args:
+        parameter_data: Dicionário com dados do parâmetro
+        month: Mês numérico (1-12)
+    
+    Returns:
+        Valor do parâmetro ou None se não encontrado
+    """
+    if not parameter_data:
+        return None
+    
+    # Tentativa 1: Chave alfabética (formato padrão NASA POWER)
+    month_key = MONTH_KEYS.get(month)
+    if month_key and month_key in parameter_data:
+        return parameter_data.get(month_key)
+    
+    # Tentativa 2: Chave numérica string
+    if str(month) in parameter_data:
+        return parameter_data.get(str(month))
+    
+    # Tentativa 3: Chave numérica com zero
+    if f"{month:02d}" in parameter_data:
+        return parameter_data.get(f"{month:02d}")
+    
+    return None
+
+
 def buscar_climatologia_nasa_power(
     lat: float,
     lon: float,
@@ -41,10 +93,11 @@ def buscar_climatologia_nasa_power(
         
         # Parâmetros climatológicos
         parameters = [
-            "T2M",           # Temperatura média a 2m
-            "T2M_MAX",       # Temperatura máxima a 2m
-            "T2M_MIN",       # Temperatura mínima a 2m
-            "PRECTOTCORR",   # Precipitação total corrigida
+            "T2M",              # Temperatura média a 2m
+            "T2M_MAX",          # Temperatura máxima a 2m
+            "T2M_MIN",          # Temperatura mínima a 2m
+            "PRECTOTCORR",      # Precipitação diária média corrigida
+            "PRECTOTCORR_SUM",  # Precipitação total mensal corrigida
         ]
         
         # Endpoint NASA POWER Climatology
@@ -58,33 +111,46 @@ def buscar_climatologia_nasa_power(
             "format": "JSON"
         }
         
-        response = requests.get(url, params=params, timeout=15)
+        response = requests.get(url, params=params, timeout=30)
         response.raise_for_status()
         data = response.json()
         
         # Extrair dados do mês específico
         properties = data.get("properties", {}).get("parameter", {})
         
-        # NASA POWER retorna dados mensais (1-12)
-        month_str = str(month)
+        # Usar helper para extrair valores com fallback robusto
+        month_key = MONTH_KEYS.get(month)
+        
+        temp_avg = get_month_value(properties.get("T2M"), month)
+        temp_max = get_month_value(properties.get("T2M_MAX"), month)
+        temp_min = get_month_value(properties.get("T2M_MIN"), month)
         
-        temp_avg = properties.get("T2M", {}).get(month_str)
-        temp_max = properties.get("T2M_MAX", {}).get(month_str)
-        temp_min = properties.get("T2M_MIN", {}).get(month_str)
-        precip = properties.get("PRECTOTCORR", {}).get(month_str)
+        # Precipitação: priorizar PRECTOTCORR_SUM (total mensal), fallback para PRECTOTCORR (média diária)
+        precip_sum = get_month_value(properties.get("PRECTOTCORR_SUM"), month)
+        precip_daily = get_month_value(properties.get("PRECTOTCORR"), month)
         
-        # Validar dados
-        if temp_avg is None or precip is None:
+        # Validar dados essenciais
+        if temp_avg is None:
+            return None
+        
+        # Calcular precipitação mensal
+        if precip_sum is not None:
+            precip_monthly = precip_sum
+            precip_daily_avg = precip_sum / 30  # Estimativa
+        elif precip_daily is not None:
+            precip_daily_avg = precip_daily
+            precip_monthly = precip_daily * 30  # Estimativa
+        else:
             return None
         
         # Classificar precipitação
-        if precip < 50:
+        if precip_monthly < 50:
             precip_desc = "Período seco"
-        elif precip < 100:
+        elif precip_monthly < 100:
             precip_desc = "Chuvas ocasionais"
-        elif precip < 150:
+        elif precip_monthly < 150:
             precip_desc = "Chuvas moderadas"
-        elif precip < 200:
+        elif precip_monthly < 200:
             precip_desc = "Chuvas frequentes"
         else:
             precip_desc = "Estação chuvosa"
@@ -93,11 +159,13 @@ def buscar_climatologia_nasa_power(
             "source": "nasa-power",
             "forecast_type": "climatology",
             "month": month,
+            "month_key": month_key,
             "temperature_avg": round(temp_avg, 1),
             "temperature_max": round(temp_max, 1) if temp_max else None,
             "temperature_min": round(temp_min, 1) if temp_min else None,
             "precipitation_expected": precip_desc,
-            "precipitation_mm_avg": round(precip, 1),
+            "precipitation_daily_avg": round(precip_daily_avg, 1),
+            "precipitation_monthly_total": round(precip_monthly, 1),
             "confidence": "media",
             "note": "Dados climatológicos/históricos NASA POWER, não previsão exata."
         }
@@ -108,13 +176,16 @@ def buscar_climatologia_nasa_power(
         return result
         
     except requests.exceptions.Timeout:
-        print(f"Timeout ao buscar NASA POWER para lat={lat}, lon={lon}, month={month}")
+        print(f"[NASA POWER] Timeout ao buscar dados para lat={lat}, lon={lon}, month={month}")
         return None
     except requests.exceptions.RequestException as e:
-        print(f"Erro ao buscar NASA POWER: {e}")
+        print(f"[NASA POWER] Erro de requisição: {e}")
+        return None
+    except KeyError as e:
+        print(f"[NASA POWER] Erro ao parsear resposta - chave ausente: {e}")
         return None
     except Exception as e:
-        print(f"Erro inesperado ao processar NASA POWER: {e}")
+        print(f"[NASA POWER] Erro inesperado: {e}")
         return None
 
 
@@ -129,8 +200,101 @@ def get_nasa_power_status() -> Dict:
         "provider": "NASA POWER",
         "type": "climatology",
         "source": "https://power.larc.nasa.gov/",
-        "parameters": ["T2M", "T2M_MAX", "T2M_MIN", "PRECTOTCORR"],
+        "parameters": ["T2M", "T2M_MAX", "T2M_MIN", "PRECTOTCORR", "PRECTOTCORR_SUM"],
         "community": "AG (Agricultural)",
         "cache_ttl": "7 days",
         "note": "Climatologia/histórico, não previsão exata"
     }
+
+
+def buscar_climatologia_nasa_power_debug(
+    lat: float,
+    lon: float,
+    month: int
+) -> Dict:
+    """
+    Versão debug que retorna resposta bruta da NASA POWER para diagnóstico.
+    
+    Args:
+        lat: Latitude
+        lon: Longitude
+        month: Mês (1-12)
+    
+    Returns:
+        Dicionário com resposta bruta e diagnóstico
+    """
+    try:
+        # Parâmetros climatológicos
+        parameters = [
+            "T2M",
+            "T2M_MAX",
+            "T2M_MIN",
+            "PRECTOTCORR",
+            "PRECTOTCORR_SUM",
+        ]
+        
+        # Endpoint NASA POWER Climatology
+        url = "https://power.larc.nasa.gov/api/temporal/climatology/point"
+        
+        params = {
+            "parameters": ",".join(parameters),
+            "community": "AG",
+            "longitude": lon,
+            "latitude": lat,
+            "format": "JSON"
+        }
+        
+        response = requests.get(url, params=params, timeout=30)
+        response.raise_for_status()
+        data = response.json()
+        
+        # Extrair informações para diagnóstico
+        properties = data.get("properties", {}).get("parameter", {})
+        
+        # Coletar chaves de cada parâmetro
+        parameter_keys = {}
+        for param in parameters:
+            param_data = properties.get(param, {})
+            if isinstance(param_data, dict):
+                parameter_keys[param] = list(param_data.keys())
+            else:
+                parameter_keys[param] = f"Not a dict: {type(param_data)}"
+        
+        # Tentar extrair valores para o mês solicitado
+        month_key = MONTH_KEYS.get(month)
+        extracted_values = {}
+        for param in parameters:
+            extracted_values[param] = get_month_value(properties.get(param), month)
+        
+        return {
+            "status": "success",
+            "url": url,
+            "params": params,
+            "status_code": response.status_code,
+            "month_requested": month,
+            "month_key": month_key,
+            "parameter_keys": parameter_keys,
+            "extracted_values": extracted_values,
+            "raw_response_keys": list(data.keys()),
+            "properties_keys": list(data.get("properties", {}).keys()),
+            "note": "Debug endpoint - mostra estrutura bruta da resposta NASA POWER"
+        }
+        
+    except requests.exceptions.Timeout:
+        return {
+            "status": "error",
+            "error_type": "timeout",
+            "message": "Timeout ao buscar NASA POWER"
+        }
+    except requests.exceptions.RequestException as e:
+        return {
+            "status": "error",
+            "error_type": "request_error",
+            "message": str(e)
+        }
+    except Exception as e:
+        return {
+            "status": "error",
+            "error_type": "unexpected_error",
+            "message": str(e)
+        }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agroplan-ai-cli",
-  "version": "1.0.36",
+  "version": "1.0.37",
   "description": "CLI global para AgroPlan AI - modo local acelerado",
   "type": "module",
   "bin": {