Corrige inicio do chat no desktop

docs/diagnostico-chat-desktop-2025-12-19.md

@@ -0,0 +1,38 @@
+# Diagnostico — Chat do desktop (2025-12-19)
+
+## Contexto
+Relato de instabilidade no chat do desktop (Raven): mensagens enviadas pela web nao chegavam ao app, e com multiplas sessoes a janela travava/nao abria.
+
+## Evidencias coletadas
+- `tickets:getById` confirmou ticket #41048 vinculado a maquina `jn7fc2d5dd8f1qw340ya092k6d7xjrps`, chat habilitado e maquina online.
+- `liveChat:getTicketSession` nao tinha sessao ativa antes do teste.
+- Teste ponta a ponta via Convex:
+  - `liveChat:startSession` + `tickets:postChatMessage` criaram sessao e mensagem.
+  - `liveChat:checkMachineUpdates` retornou `hasActiveSessions=true` e `unreadCount=1`.
+  - `liveChat:listMachineMessages` retornou a nova mensagem.
+  - `POST /api/machines/chat/poll` confirmou o mesmo unread.
+- Traefik (VPS): nao ha chamadas do desktop para `/api/machines/chat/*` nem `raven-chat/1.0` nas ultimas horas.
+- Logs locais do desktop:
+  - `raven-agent.log` sem entradas `[CHAT DEBUG]`.
+  - `app.log` sem `chat:started`.
+
+## Causa raiz
+O desktop nao estava iniciando o runtime de chat.
+Em `apps/desktop/src/main.tsx`, o `invoke("start_chat_polling", ...)` enviava `base_url` e `convex_url` em snake_case. No Tauri v2, o mapeamento esperado e camelCase (`baseUrl`, `convexUrl`). Com isso, o comando falha na desserializacao dos args e o chat nao inicia (sem polling/WebSocket), resultando em nenhuma mensagem chegando ao app.
+
+## Correcoes aplicadas
+- Ajustado `invoke("start_chat_polling")` para usar `baseUrl` e `convexUrl` (camelCase).
+
+## Arquivos alterados
+- `apps/desktop/src/main.tsx`
+
+## Testes recomendados
+- `bun run lint`
+- `bun test`
+- `bun run build:bun`
+
+## Validacao operativa (pos-build)
+1. Abrir o Raven com a maquina online.
+2. Enviar mensagem no ticket #41048.
+3. Confirmar em `raven-agent.log` a sequencia `[CHAT DEBUG] Iniciando sistema de chat` e eventos `chat:started` em `app.log`.
+4. Verificar no Traefik chamadas `/api/machines/chat/poll` ou conexoes WS do Convex com origin `http://tauri.localhost`.