Skip to content

GxObjGen v1.11.5 - gateway 8780 sem falha silenciosa

Latest

Choose a tag to compare

@franciscorizzo franciscorizzo released this 09 Jul 20:26
· 5 commits to main since this release

GxObjGen v1.11.5 — gateway 8780 sem falha silenciosa

Correção da issue #15 — obrigado, @bpessoni, pelo relato com evidências na medida!

O problema

O gateway multi-KB (porta 8780) é um script Python que a extensão lança ao abrir o IDE — e Python no PATH era um pré-requisito não documentado. Sem Python, o gateway não subia e nada aparecia no IDE (o motivo ia só para o log interno); como a doc inteira cravava 8780, o "connection refused" parecia MCP quebrado. O servidor por-KB (porta determinística, faixa 8787–8986, estável entre reaberturas) sempre esteve vivo — era a porta que o Output do IDE mostrava.

O que mudou

  • Status do gateway SEMPRE no Output do IDE (seção "GxObjGen MCP"): ATIVO / iniciado / NAO INICIADO: <motivo> (ex.: "Python nao encontrado no PATH") — com o workaround por-KB na própria mensagem.
  • A mensagem por-KB (a que aparece ao abrir a KB) ganhou uma linha com o estado real do gateway.
  • install.ps1 checa Python ao final: verde (gateway ok, registre a 8780) ou amarelo (conecte pela porta por-KB; para habilitar o gateway: winget install Python.Python.3.12).
  • Doc alinhada: README com as duas formas de conectar (gateway 8780 requer Python × porta por-KB sem dependência), GETTING-STARTED com o troubleshooting exato do sintoma ("connection refused na 8780 mas o IDE mostrou outra porta" → não reinstale), CLAUDE.md idem.

Validação

Deploy real: gateway ATIVO detectado e reportado no boot; regressão completa 24/24 PASS; as duas branches da detecção de Python do install.ps1 exercitadas.

Ação

  1. Atualize: git pull (repo de instalação) ou baixe o asset abaixo e rode install.ps1 (GeneXus fechado).
  2. /mcp no Claude Code p/ reconectar.

— Equipe CQ1