
O cache que congelava a capa: quando renomear virou mudança de contrato
Trocar a imagem no mesmo caminho não muda nada para quem já baixou. O nome passou a carregar hash do conteúdo, e dois consumidores quebraram no mesmo instante.
7 posts

Trocar a imagem no mesmo caminho não muda nada para quem já baixou. O nome passou a carregar hash do conteúdo, e dois consumidores quebraram no mesmo instante.

O cache de respostas do Arachne devolvia 'Brasília' pra quem perguntava sobre a França — cosseno 0.8531 contra threshold 0.85. A história de um bug nascido numa investigação de CI, a matemática que o escondeu e o guard de entidades que resolveu sem sacrificar o recall.

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.

Um header Cache-Control errado no vercel.json sobrescrevia o revalidate=1800 do ISR e transformava a expiração do cache em duas chamadas síncronas ao GitHub dentro do TTFB. A história de como o cache frio virou quente: 3.6s pra 140ms.

O pipeline de visão do Arachne evoluiu: qwen2.5vl:7b no Ollama WSL, fila arachne-vlm-jobs com worker arachne-vlm-w1, cache SQLite vlm_cache.db (sha256) e polling GET /api/extract/image-jobs/{id}. Visão exige JWT, PYTHONPATH api/ e PostgreSQL (não SQLite).

O Portfólio estava 100% funcional, 218 testes passando, zero erros no CI. Mas usuários de mobile Chrome viam versões antigas ao restaurar abas. A causa: o bfcache do Chrome ignora headers HTTP — e a solução veio cruzada de outro projeto.

O scraper simples virou uma plataforma. Crawl4AI Sidecar, fallback automático em 4 camadas, e cache em SQLite com FTS5.