agroplan-ai-cli 1.0.26 → 1.0.27

package/backend-template/VERSION.json

@@ -1,6 +1,6 @@
 {
-  "cli_version": "1.0.26",
-  "backend_template_version": "1.0.26",
+  "cli_version": "1.0.27",
+  "backend_template_version": "1.0.27",
   "zarc_index_version": "2025-2026-fast-index-v2",
   "price_index_version": "2025-05-reference-v1",
   "features": [
@@ -14,7 +14,8 @@
     "price_display_only",
     "price_unit_normalization",
     "market_profit_estimate",
-    "market_profit_validation"
+    "market_profit_validation",
+    "market_profit_confidence_refinement"
   ],
-  "generated_at": "2026-05-09T22:00:00Z"
+  "generated_at": "2026-05-09T23:00:00Z"
 }

package/backend-template/core/market_profit_validator.py

@@ -47,20 +47,27 @@ def classificar_confiabilidade_lucro(item: Dict) -> Dict:
     """
     Classifica confiabilidade do lucro de mercado para um item do plano.
     
+    Critérios refinados (Fase 9.5):
+    - Baixa: diferença >= 150%, dados incompletos, lucro invertido, fallback com diferença >= 100%
+    - Média: diferença 50-150%, fallback, lucro negativo
+    - Alta: diferença < 50%, sem fallback, dados completos
+    
     Args:
         item: Item do plano com dados de lucro
     
     Returns:
-        Dict com confiabilidade (alta/media/baixa) e motivos
+        Dict com confiabilidade (alta/media/baixa), motivos e flag crítico
     """
     motivos = []
+    critico = False
     
     # Verificar se tem preço normalizado
     preco_norm = item.get("preco_normalizado", {})
     if not preco_norm.get("normalizado"):
         return {
             "confiabilidade": "baixa",
-            "motivos": ["Preço não normalizado ou não disponível"]
+            "motivos": ["Preço não normalizado ou não disponível"],
+            "critico": True
         }
     
     # Verificar se tem produtividade e custo
@@ -76,7 +83,8 @@ def classificar_confiabilidade_lucro(item: Dict) -> Dict:
     if motivos:
         return {
             "confiabilidade": "baixa",
-            "motivos": motivos
+            "motivos": motivos,
+            "critico": True
         }
     
     # Verificar se tem lucro de mercado calculado
@@ -84,7 +92,8 @@ def classificar_confiabilidade_lucro(item: Dict) -> Dict:
     if lucro_mercado is None:
         return {
             "confiabilidade": "baixa",
-            "motivos": ["Lucro de mercado não calculado"]
+            "motivos": ["Lucro de mercado não calculado"],
+            "critico": True
         }
     
     # Calcular diferença com lucro do sistema
@@ -92,34 +101,61 @@ def classificar_confiabilidade_lucro(item: Dict) -> Dict:
     diferenca = calcular_diferenca_lucro(lucro_sistema, lucro_mercado)
     diferenca_percentual = abs(diferenca["diferenca_percentual"])
     
-    # Classificar baseado na diferença percentual
-    if diferenca_percentual > 100:
+    # Verificar se é fallback
+    preco_real = item.get("preco_real", {})
+    is_fallback = preco_real.get("fallback", False)
+    
+    # Verificar inversão de sinal (lucro vira prejuízo ou vice-versa)
+    lucro_invertido = (lucro_sistema > 0 and lucro_mercado < 0) or (lucro_sistema < 0 and lucro_mercado > 0)
+    
+    # CRITÉRIOS REFINADOS (Fase 9.5)
+    
+    # Baixa confiabilidade (crítico)
+    if diferenca_percentual >= 150:
+        confiabilidade = "baixa"
+        motivos.append(f"Diferença extrema ({diferenca_percentual:.1f}%) entre lucro sistema e mercado")
+        critico = True
+    elif lucro_invertido and lucro_sistema > 0:
+        confiabilidade = "baixa"
+        motivos.append("Lucro do sistema é positivo mas lucro de mercado indica prejuízo")
+        critico = True
+    elif is_fallback and diferenca_percentual >= 100:
+        confiabilidade = "baixa"
+        motivos.append(f"Preço de fallback com diferença muito alta ({diferenca_percentual:.1f}%)")
+        critico = True
+    elif diferenca_percentual >= 100:
+        # Diferença > 100% mesmo sem fallback é baixa confiabilidade
         confiabilidade = "baixa"
         motivos.append(f"Diferença muito alta ({diferenca_percentual:.1f}%) entre lucro sistema e mercado")
-    elif diferenca_percentual > 50:
+        critico = False  # Não crítico se não for fallback
+    
+    # Média confiabilidade
+    elif diferenca_percentual >= 50:
         confiabilidade = "media"
         motivos.append(f"Diferença moderada ({diferenca_percentual:.1f}%) entre lucro sistema e mercado")
+    elif is_fallback:
+        confiabilidade = "media"
+        motivos.append("Preço de referência (fallback) - pode não refletir mercado local")
+    elif lucro_mercado < 0:
+        confiabilidade = "media"
+        motivos.append("Lucro de mercado indica prejuízo - requer validação")
+    
+    # Alta confiabilidade
     else:
         confiabilidade = "alta"
         motivos.append(f"Diferença aceitável ({diferenca_percentual:.1f}%) entre lucro sistema e mercado")
+        if not is_fallback:
+            motivos.append("Preço real disponível (não fallback)")
     
-    # Verificar se lucro de mercado é negativo (prejuízo)
-    if lucro_mercado < 0:
-        if confiabilidade == "alta":
-            confiabilidade = "media"
-        motivos.append("Lucro de mercado indica prejuízo - requer validação de preço/produtividade")
-    
-    # Verificar se é fallback
-    preco_real = item.get("preco_real", {})
-    if preco_real.get("fallback"):
-        if confiabilidade == "alta":
-            confiabilidade = "media"
-        motivos.append("Preço usando fallback (referência) - pode não refletir mercado local")
+    # Adicionar informação sobre normalização bem-sucedida
+    if preco_norm.get("normalizado") and confiabilidade != "baixa":
+        motivos.append("Unidade comercial normalizada com sucesso")
     
     return {
         "confiabilidade": confiabilidade,
         "motivos": motivos,
-        "diferenca": diferenca
+        "diferenca": diferenca,
+        "critico": critico
     }
 
 
@@ -140,6 +176,7 @@ def validar_plano_lucro_mercado(resultado: Dict) -> Dict:
     alta_confiabilidade = 0
     media_confiabilidade = 0
     baixa_confiabilidade = 0
+    itens_criticos = 0
     alertas = []
     
     # Validar cada item do plano
@@ -160,11 +197,16 @@ def validar_plano_lucro_mercado(resultado: Dict) -> Dict:
             cultura = item.get("cultura", "desconhecida")
             talhao = item.get("talhao", "?")
             alertas.append(f"Talhão {talhao} ({cultura}): {', '.join(validacao['motivos'])}")
+        
+        # Contabilizar itens críticos
+        if validacao.get("critico", False):
+            itens_criticos += 1
     
     # Adicionar resumo de validação
     total = len(resultado["plano"])
     percentual_alta = (alta_confiabilidade / total * 100) if total > 0 else 0
     percentual_baixa = (baixa_confiabilidade / total * 100) if total > 0 else 0
+    percentual_critico = (itens_criticos / total * 100) if total > 0 else 0
     
     resultado["validacao_lucro_mercado"] = {
         "ativo": True,
@@ -172,31 +214,38 @@ def validar_plano_lucro_mercado(resultado: Dict) -> Dict:
         "itens_alta_confiabilidade": alta_confiabilidade,
         "itens_media_confiabilidade": media_confiabilidade,
         "itens_baixa_confiabilidade": baixa_confiabilidade,
+        "itens_criticos": itens_criticos,
         "percentual_alta_confiabilidade": round(percentual_alta, 1),
         "percentual_baixa_confiabilidade": round(percentual_baixa, 1),
+        "percentual_critico": round(percentual_critico, 1),
         "alertas": alertas[:5],  # Limitar a 5 alertas principais
         "total_alertas": len(alertas),
-        "recomendacao": _gerar_recomendacao(percentual_alta, percentual_baixa)
+        "recomendacao": _gerar_recomendacao(percentual_alta, percentual_baixa, percentual_critico)
     }
     
     return resultado
 
 
-def _gerar_recomendacao(percentual_alta: float, percentual_baixa: float) -> str:
+def _gerar_recomendacao(percentual_alta: float, percentual_baixa: float, percentual_critico: float = 0) -> str:
     """
     Gera recomendação baseada nos percentuais de confiabilidade.
     
     Args:
         percentual_alta: Percentual de itens com alta confiabilidade
         percentual_baixa: Percentual de itens com baixa confiabilidade
+        percentual_critico: Percentual de itens críticos
     
     Returns:
         String com recomendação
     """
-    if percentual_alta >= 70:
+    if percentual_critico >= 30:
+        return "Há valores críticos no lucro de mercado. Eles não devem ser usados para otimização sem validação manual."
+    elif percentual_alta >= 70:
         return "Lucro de mercado apresenta boa confiabilidade. Considere validação detalhada antes de ativar PRICE_APPLY_TO_PROFIT."
     elif percentual_baixa >= 50:
         return "Muitos itens com baixa confiabilidade. Valide preços, produtividades e custos antes de usar lucro de mercado."
+    elif percentual_critico > 0:
+        return "Alguns valores críticos detectados. Revise itens com baixa confiabilidade antes de usar lucro de mercado."
     else:
         return "Confiabilidade mista. Revise itens com baixa confiabilidade e valide dados de mercado."
 

package/backend-template/core/report_generator.py

@@ -279,14 +279,31 @@ def gerar_secao_validacao_lucro_mercado(resultado, formato='md'):
         alta = validacao.get("itens_alta_confiabilidade", 0)
         media = validacao.get("itens_media_confiabilidade", 0)
         baixa = validacao.get("itens_baixa_confiabilidade", 0)
+        criticos = validacao.get("itens_criticos", 0)
         
         perc_alta = validacao.get("percentual_alta_confiabilidade", 0)
         perc_baixa = validacao.get("percentual_baixa_confiabilidade", 0)
+        perc_critico = validacao.get("percentual_critico", 0)
         
         secao += f"- **Total de itens analisados**: {total}\n"
         secao += f"- **Alta confiabilidade**: {alta} ({perc_alta:.1f}%) 🟢\n"
         secao += f"- **Média confiabilidade**: {media} ({100 - perc_alta - perc_baixa:.1f}%) 🟡\n"
-        secao += f"- **Baixa confiabilidade**: {baixa} ({perc_baixa:.1f}%) 🔴\n\n"
+        secao += f"- **Baixa confiabilidade**: {baixa} ({perc_baixa:.1f}%) 🔴\n"
+        
+        if criticos > 0:
+            secao += f"- **⚠️ Itens críticos**: {criticos} ({perc_critico:.1f}%)\n"
+        
+        secao += "\n"
+        
+        # Aviso de itens críticos
+        if criticos > 0:
+            secao += "### ⚠️ ATENÇÃO: Valores Críticos Detectados\n\n"
+            secao += f"**{criticos} item(ns) apresenta(m) valores críticos** que indicam possível desalinhamento entre:\n"
+            secao += "- Preço de mercado vs preço interno\n"
+            secao += "- Produtividade estimada vs real\n"
+            secao += "- Custos operacionais\n"
+            secao += "- Unidade comercial\n\n"
+            secao += "**Estes valores não devem ser usados para otimização sem validação manual.**\n\n"
         
         # Recomendação
         recomendacao = validacao.get("recomendacao", "")
@@ -332,8 +349,14 @@ def gerar_secao_validacao_lucro_mercado(resultado, formato='md'):
                 diferenca_fmt = "N/A"
             
             confiabilidade = validacao_item.get("confiabilidade", "baixa")
-            conf_emoji = "🟢" if confiabilidade == "alta" else "🟡" if confiabilidade == "media" else "🔴"
-            conf_label = confiabilidade.title()
+            critico = validacao_item.get("critico", False)
+            
+            if critico:
+                conf_emoji = "⚠️🔴"
+                conf_label = "**CRÍTICO**"
+            else:
+                conf_emoji = "🟢" if confiabilidade == "alta" else "🟡" if confiabilidade == "media" else "🔴"
+                conf_label = confiabilidade.title()
             
             secao += f"| {talhao} | {cultura} | {lucro_sistema_fmt} | {lucro_mercado_fmt} | {diferenca_fmt} | {conf_emoji} {conf_label} |\n"
         
@@ -343,8 +366,9 @@ def gerar_secao_validacao_lucro_mercado(resultado, formato='md'):
         secao += "### 📊 Sobre a Classificação de Confiabilidade\n\n"
         secao += "A confiabilidade do lucro de mercado é classificada com base em:\n\n"
         secao += "- **Alta (🟢)**: Diferença < 50% entre lucro sistema e mercado, preço normalizado disponível\n"
-        secao += "- **Média (🟡)**: Diferença 50-100%, uso de fallback, ou lucro negativo\n"
-        secao += "- **Baixa (🔴)**: Diferença > 100%, dados incompletos, ou preço não disponível\n\n"
+        secao += "- **Média (🟡)**: Diferença 50-150%, uso de fallback, ou lucro negativo\n"
+        secao += "- **Baixa (🔴)**: Diferença > 150%, dados incompletos, ou preço não disponível\n"
+        secao += "- **⚠️ CRÍTICO**: Diferença extrema (>150%), lucro invertido, ou fallback com diferença >100%\n\n"
         
         secao += "### ⚠️ Aviso Importante\n\n"
         secao += "**O lucro de mercado ainda é experimental e não substitui o lucro principal do sistema.**\n\n"

package/package.json

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