32 posts
A capa foi refeita duas vezes, o deploy servia os bytes novos — e o blog continuava mostrando a imagem velha. O culpado não era o build nem o CDN: era um header que prometia que o arquivo nunca ia mudar por um ano. A história da caçada, a matemática do cache imutável e a regra que ficou: rework de asset exige URL nova.
The cover was remade twice, the deployment served the new bytes — and the blog kept showing the old image. The culprit wasn't the build or the CDN: it was a header promising the file would never change for a year. The story of the hunt, the math of immutable caching, and the rule that stuck: reworking an asset requires a new URL.
Depois de um reboot, tudo voltou verde: processo de pé, health ok — e a página não abria em lugar nenhum. O serviço tinha ressuscitado com as instruções de uma vida passada, congeladas num arquivo de estado, enquanto o mundo lá fora mudava de endereço. O post cobre a caçada, o fix na fonte (estado velho morre a cada partida, endereço definido em um lugar só) e a segunda metade da história: um anúncio que só falava com uma interface de nome fixo, no dia em que o sistema decidiu renomeá-la.
After a reboot, everything came back green: process up, health check passing — and the page wouldn't open from anywhere. The service had resurrected with instructions from a past life, frozen in a state file, while the world outside had moved. This post covers the hunt, the fix at the source (stale state dies on every start, address defined in exactly one place) and the second half of the story: a network announcement that only talked to an interface with a fixed name, on the day the system renamed it.
Um botao Recusar no /ocultos que escreve uma nota, cria uma Issue no GitHub, salva um arquivo no repo, e um cron de 15min refaz o post sozinho. A historia de como o feedback humano virou pipeline.
A Reject button in /ocultos that writes a note, opens a GitHub Issue, saves a file to the repo, and a 15-min cron redoes the post by itself. The story of how human feedback became a pipeline.
Uma auditoria de acessibilidade no LifeLog virou uma caçada a quatro armadilhas de contraste: comentários de código com 3.9:1, badges de projeto que falhavam em 4 das 6 paletas, um seletor de tema que o scoping do Astro quebrava em silêncio, e o alpha que o axe-core se recusa a compor. No fim: 14 rotas x temas sem violações serious/critical.
An accessibility audit on LifeLog turned into a hunt for four contrast traps: code comments at 3.9:1, project badges failing in 4 of 6 palettes, a theme selector that Astro scoping silently broke, and the alpha that axe-core refuses to compose. The result: 14 routes x themes with zero serious/critical violations.
Four commits in a row touching the LifeLog navbar, each one undoing the effect of the one before it. Links that disappeared, a logo that jumped away, a button that floated on its own. The lesson: refactoring in a hurry across a jumble of classes is like baking a cake while changing the recipe at every step.
Quatro commits seguidos mexendo na navbar do LifeLog, cada um desfazendo o efeito do anterior. Links que somiam, logo que pulava, botão que flutuava. A lição: refatorar com pressa num asthma de classes é como assar um bolo mudando a receita a cada passo.
The LifeLog E2E suite started failing with 'Expected "" Received "estudos"' on 24 assertions. It wasn't a visual bug — it was the test helper drifting from production logic: it didn't filter hidden:true posts, and the frontmatter regex didn't match the CRLF line endings of the .mdx files. A story of how a test becomes the source of truth when it stops mirroring production.
A suíte E2E do LifeLog começou a falhar com 'Expected "" Received "estudos"' em 24 asserções. Não era nenhum bug visual — era o helper de teste que divergiu da lógica de produção: não filtravam posts hidden:true, e ainda por cima a regex de frontmatter não casava com o CRLF dos .mdx. Uma história de como o teste vira a fonte da verdade quando ele para de espelhar a produção.
Local services hanging intermittently: Qdrant on port 6333, helper APIs — everything pointing to 'localhost'. On Windows, 'localhost' resolves to IPv6 (::1) first — and the connection hangs. '127.0.0.1' forces IPv4 and works. Confirmed 88 times until it became a rule: always use 127.0.0.1.
Serviços locais travando de forma intermitente: o Qdrant na 6333, APIs de apoio, tudo que apontava para 'localhost'. No Windows, 'localhost' resolve para IPv6 (::1) primeiro — e a conexão trava. '127.0.0.1' força IPv4 e funciona. Confirmado 88 vezes até virar regra: usar 127.0.0.1 sempre.
TatuEngine had 5.7GB of AI models committed to git since day one. GitHub rejects objects above 2GB with a 422 error — that push would never succeed. The fix wasn't 'pushing through': it was an orphan branch that preserved code, tests, and docs and rewrote the repository's history from scratch.
O TatuEngine tinha 5.7GB de modelos de IA commitados no git desde o primeiro dia. O GitHub rejeita objetos acima de 2GB com erro 422 — o push nunca passaria. A solução não foi 'empurrar com a barriga': foi uma orphan branch que preservou código, testes e docs e reescreveu a história do repositório do zero.
Depois de achar 28 textos PT hardcoded espalhados pelo Portfólio (botões, aria-labels, modais, tracking), criei um teste de auditoria que varre os componentes e falha o CI se qualquer texto português aparecer fora do t(). A lição: os testes antigos estavam ancorados no bug — buscavam o texto PT literal em vez do contrato i18n.
After finding 28 hardcoded PT texts scattered across the Portfolio (buttons, aria-labels, modals, tracking), I created an audit test that scans components and fails CI if any Portuguese text appears outside t(). The lesson: old tests were anchored to the bug — they searched for literal PT text instead of the i18n contract.
O build do LifeLog quebrou com um erro misterioso de 'Named export parseCookie not found'. O código estava certo, o CI passava, mas local falhava. A causa: um node_modules de 253MB na ~/ com cookie@0.7.2 sequestrava a resolução de módulos de TODOS os projetos Node do WSL.
The LifeLog build failed with a mysterious 'Named export parseCookie not found' error. The code was right, the CI passed, but local builds broke. The cause: a 253MB node_modules in ~/ with cookie@0.7.2 hijacking module resolution for EVERY Node project on the WSL.
Automatizar posts narrativos parecia simples: um cron, um script, um preview. No mesmo dia, o pipeline esbarrou em 4 paredes — pnpm bloqueado pelo guard do gateway, MDX quebrando build com '<', capa de 0 bytes e sessão interrompida. Cada parede virou uma regra.
Automating narrative posts seemed simple: a cron, a script, a preview. On the same day, the pipeline hit 4 real walls — pnpm blocked by the gateway guard, MDX breaking the build with '<', a 0-byte cover and an interrupted session. Each wall became a rule.
MCP virou o conector universal (publicado no registry oficial), FTS5+vetorial virou busca híbrida com RRF, ai-jail isolou o agente e Ollama trouxe a IA pra casa — e as lições viraram regras: docs first, plan first, parar e perguntar.
MCP became the universal connector (published on the official registry), FTS5+vector became hybrid search with RRF, ai-jail isolated the agent and Ollama brought AI home — and the lessons became rules: docs first, plan first, stop and ask.
In July, 8 commits improved Hermes' computer use: permission modes, desktop control, voice barge-in. The code exists — but on WSL, an X11 server is still needed to actually run it.
Em julho, 8 commits melhoraram o computer use do Hermes: permission modes, desktop control, voice barge-in. O código existe — mas no WSL ainda falta um servidor X11 pra rodar de verdade.
From 3 projects in June to 5 in July, the Samuel ecosystem now has 2,396 commits, 3,647+ tests, and one agent orchestrating it all.
De 3 projetos em junho pra 5 em julho, o ecossistema Samuel agora tem 2.396 commits, 3.647+ testes, e um agente orquestrando tudo.
Explorando ferramentas de julho — aprendizados, desafios e descobertas.
Exploring July's tools — lessons, challenges, and discoveries.
Com 3 projetos rodando, a infraestrutura precisava ser robusta. Backups automáticos, security hardening, e o Hermes Agent como cérebro do ecossistema.
With 3 projects running, the infrastructure needed to be robust. Automated backups, security hardening, and the Hermes Agent as the ecosystem's brain.