[MarkSant]

Teste de instalação do zero em C:\DRerio\DRerio-LogAI depois do #561: o install.bat correu inteiro, mas o duplo-clique no ícone não fazia absolutamente nada. Pelo terminal, o app parava aqui e nunca mais saía:

logging.session.start
logging.configured  cwd=C:\DRerio\DRerio-LogAI

O atalho estava correto. O app é que travava — e só numa máquina limpa.

O defeito

Depois daquela linha vêm Tk(), root.withdraw() e o seletor de idioma de primeira execução. Ele chamava dialog.transient(root).

Uma janela transient herda o estado mapeado do master. Com o master withdrawn ela também fica withdrawn — e nem deiconify() nem lift() revertem. Medido no Windows:

transient only                 viewable=False state=withdrawn 1x1
transient + deiconify          viewable=False state=withdrawn 1x1
transient + deiconify + lift   viewable=False state=withdrawn 1x1
no transient                   viewable=True  state=normal    167x61

O chooser era criado, nunca aparecia, e o root.wait_window(dialog) seguinte bloqueava para sempre numa janela que ninguém podia ver, focar ou fechar.

O withdraw() não é o defeito e não foi mexido. Ele existe porque a pergunta de idioma tem de ser feita antes de load_settings() — é ela que escreve ui.language — e a janela principal não pode piscar antes disso. O que muda é o transient, agora aplicado só quando o master está visível: o caso de Configurações → Idioma, onde ele vale (empilhamento correto sobre a janela principal, sem segundo botão na barra de tarefas). Um TclError do root degrada para "sem transient" — perder o comportamento transient é cosmético, perder o diálogo para o app.

Só acontece com config.local.yaml ausente, ou seja só numa máquina limpa — precisamente a do operador, e nunca a de quem desenvolve. Foi por isso que passou despercebido até o teste de instalação real.

Conferido que o splash não tem o mesmo problema: ele usa overrideredirect(True), que não herda o estado do master.

Por que os testes não pegaram

Todos os 9 casos de tests/ui/test_language_dialog.py recebem um Toplevel visível da fixture tkinter_root. Nenhum reproduzia o root withdrawn do arranque real. Os três testes novos reproduzem, e o primeiro falha contra o código antigo com a mensagem exata do defeito:

the chooser was never mapped: state='withdrawn' size=(1, 1);
wait_window would block on it forever

Segundo commit: nada mais pode falhar em silêncio

Enquanto diagnosticava isto, ficou claro que o problema real não era o travamento em si — era não haver como saber qual era.

run_app converte falhas em diálogo, mas só a partir do ponto em que a raiz Tk existe. O parsing de argumentos, o _setup_logging e o próprio Tk() rodam antes disso, e uma falha do próprio handler de erro também escapa. Nesses casos o traceback vai para sys.stderr — e sob pythonw, escolhido no #561 justamente para não deixar um console atrás da janela, sys.stderr é None. O traceback vai para lugar nenhum e o processo morre calado.

Para quem tem terminal isso é um contratempo. Para o operador que só tem o ícone, é o pior desfecho possível.

__main__.main() agora envolve run_app e, quando não há stderr, mostra o traceback num message box junto com o caminho de logs/analysis.log e o comando que reproduz o erro. Com console é no-op deliberado: ali o traceback do próprio Python é melhor que um modal, e a suíte afirma sobre ele. SystemExit passa direto — o caminho de pesos ausentes já mostra um diálogo que nomeia a pasta e o remédio, e um segundo modal genérico só pioraria.

Validado sob pythonw de verdade, iniciado destacado como o Explorer faz (stderr=None confirmado no processo).

Verificação

• Suíte rápida contra o main atual: 6737 passed, 4 skipped
• GUI (-m gui -n0): 1209 passed
• ruff limpo; mypy limpo em 903 arquivos; pre-commit --all-files verde
• Cada teste novo conferido revertendo a metade correspondente da correção — os sete discriminam

🤖 Generated with Claude Code

[codecov]

Codecov Report

❌ Patch coverage is 94.11765% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
src/zebtrack/__main__.py	92.00%	2 Missing ⚠️

📢 Thoughts on this report? Let us know!