Anderson LimaSoftware Engineer & Architect
16 de octubre de 2026
5 min de lectura
42 visualizaciones
Cinco lições de manter o lemon-code e o app macOS em dois repositórios, com um contrato no meio e um banco SQLite que só um lado pode escrever
English summary: Five lessons from building lemon-code's CLI and native macOS app in parallel, including a startup cascade where a transient SQLite lock tripped the app's circuit breaker.
Publicado: 6 de novembro de 2026
Tempo de leitura: 8 min
Série: lemon-code em 30 dias, parte 9 de 13
Eu abria o app macOS do lemon-code e, em vez do chat, via dados de fallback e um aviso fixo na parte de baixo da tela, tapando o campo de digitação. O backend estava no ar. O problema era um lock momentâneo no SQLite, contado pelo app como se a conexão tivesse caído.
Esse efeito cascata virou a ADR 0032. Ele resume bem o que é desenvolver um CLI e um app nativo ao mesmo tempo: a maior parte dos bugs mora na fronteira entre os dois. Aqui estão as cinco lições que ficaram.
Pense num disjuntor de casa que desarma toda vez que a geladeira liga o motor. O pico é normal e passa em um segundo, mas o disjuntor entende como curto-circuito e corta a luz da casa inteira. O problema não é a geladeira. É o disjuntor sem calibragem.
O circuit breaker do app era esse disjuntor. Ele contava como falha de conexão erros RPC de domínio e respostas vazias, além das falhas de processo e transporte que realmente devem abrir o circuito.
A correção do disjuntor é classificar o erro antes de contar:
// Resumo da classificação usada pelo cliente RPC.
enum RPCFailure {
case launchFailed, noJSONResponse, requestTimedOut, rpc, emptyResult
}
func countsTowardBreaker(_ error: RPCFailure) -> Bool {
switch error {
case .launchFailed, .noJSONResponse, .requestTimedOut: return true
case .rpc, .emptyResult: return false
}
}
Erros RPC e resultados vazios continuam visíveis para o usuário. Só não contam para abrir o circuito.
Productos gratuitos y de pago para convertir ideas en una base que puedas lanzar.
13 productos disponibles
nextjs · boilerplate
Boilerplate de API em Python com FastAPI, organizado em Clean Architecture (router, service, repository e adapters por módulo). Inclui autenticação JWT com hashing bcrypt, MongoDB, testes com pytest e cobertura, Dockerfile e docker-compose para subir localmente, e documentação Swagger/OpenAPI automática. Repositório de origem privado; snapshot técnico verificado antes da publicação.
Ver producto
react · boilerplate
Base React Native para apps iOS y Android con Expo, Clean Architecture, MVVM, Firebase y módulos nativos. Referencia técnica de VaiDeFut, con distribución pública en Google Play y un flujo de publicación para iOS documentado.
Ver producto
nextjs · boilerplate
Kit gratuito y open source para comenzar con agentes de código en Claude Code, Codex, Gemini, Copilot y OpenCode. El repositorio público confirma una licencia MIT.
Ver producto
nextjs · boilerplate
Base AI-first white-label para lanzar productos SaaS con Next.js, chat, RAG, memoria, tenants y documentación. El snapshot verificado documenta Supabase, no MongoDB; la limitación está explícita. MongoDB, Redis y RabbitMQ requieren una integración/configuración compatible.
Ver producto
nextjs · boilerplate
Edición avanzada de una base white-label y multi-tenant AI-first para acelerar productos con Next.js, chat, RAG, memoria y documentación. El snapshot verificado no demuestra una capa Ultra distinta; la limitación y los cambios de provider, cache y colas quedan transparentes.
Ver producto
nextjs · boilerplate
Base white-label y multi-tenant para convertir una idea en un SaaS AI-first con Next.js, chat, RAG, memoria y seguridad documentada. El snapshot verificado usa Supabase; el nombre identifica el repositorio de origen. Los límites de provider, cache y colas son explícitos; Redis y RabbitMQ son integraciones configurables.
Ver producto
react · portfolio
Una contribución única para apoyar contenido técnico gratuito, investigación y la continuidad de proyectos relevantes publicados por Anderson Lima. Tú eliges el valor; no es una suscripción.
Ver producto
react · boilerplate
Starter React gratuito para crear una suite de pruebas confiable desde el primer commit con Vitest, Testing Library, Playwright, Vite, TypeScript, Zustand, React Query, MirageJS y PWA. El repositorio no declara una licencia SPDX; revisa sus términos antes del uso comercial.
Ver producto
react · portfolio
Monorepo público en React, TypeScript y Vite para explorar una biblioteca de componentes con lenguaje visual inspirado en interfaces nativas. El README actual es breve y no declara una licencia SPDX; trátalo como preview gratuito.
Ver producto
nextjs · saas
Boilerplate SaaS AI-first con Next.js, Supabase, Stripe y provider routing para avanzar desde el primer prompt hasta un despliegue real más rápido. Los cambios de IA, datos, email, cache y colas son explícitos; Redis y RabbitMQ son integraciones configurables.
Ver producto
react · saas
Starter React + TypeScript para SaaS multi-tenant con Firebase, Atomic Design, temas, PWA, pantallas de producto, MirageJS y chat Gemini extensible a otros providers. Valida requisitos de producción, costes e integraciones antes de publicar.
Ver producto
react · boilerplate
Starter React público con TypeScript, Zustand, React Query, Tailwind CSS, PWA e integraciones de IA documentadas. El repositorio no declara una licencia SPDX; revisa sus términos antes del uso comercial.
Ver producto
nextjs · saas
Landing SaaS para Next.js, TypeScript y Tailwind CSS con SEO, temas, i18n, PWA y puntos de integración para auth, Stripe e IA. Una base clara para dejar atrás la pantalla en blanco y dar forma a tu propuesta.
Ver productoContinúa explorando temas similares
O primeiro commit do app macOS do lemon-code não tinha nenhuma tela. Era o contrato com o CLI. Este post mostra por que essa ordem evitou reescrever o agente em Swift.
O lemon-code tem seis ADRs com o número 0049, todas criadas no mesmo dia. Esse erro ensina mais sobre memória de projeto com vários agentes do que qualquer ADR bem numerada.
Eu pagava API para tarefas que o Claude Code ou o Codex, já logados na minha máquina, resolveriam. A regra CLI-first do lemon-code cabe em quatro linhas de precedência.
Una lista de 47 puntos para encontrar errores, riesgos de seguridad y problemas de rendimiento antes del lanzamiento.
Templates probados en producción, usados por desarrolladores. Ahorra semanas de setup en tu próximo proyecto.
O primeiro commit do app foi o contrato com o CLI, não uma janela. Isso evitou a tentação de "só ler o SQLite direto para mostrar a lista de projetos". Cada vez que o app precisava de um dado, a pergunta era: qual método do contrato entrega isso?
As regras do repositório do app dizem: o lemon-code é o único motor de execução, o app nunca escreve no SQLite do core e os fluxos da UI precisam funcionar sem terminal. Com dois repositórios, isso é o que impede duas implementações divergentes da mesma regra de negócio.
A classificação atual conta falha ao iniciar o processo, ausência de resposta JSON e timeout da requisição. Erros RPC (incluindo mensagens de domínio ou validação) e resultado vazio não contam para abrir o circuito.
O core já usava SQLite em modo WAL com synchronous normal. Mesmo assim, conexões concorrentes ao banco de sessões ainda podiam retornar "database busy". As conexões relevantes do SqliteSessionStore usam busy_timeout de 5.000 ms, que espera até cinco segundos antes de desistir.
// conexão SQLite com espera em vez de erro imediato (ilustrativo, Bun)
import { Database } from "bun:sqlite";
const db = new Database("lemon.db");
db.exec("PRAGMA journal_mode = WAL;");
db.exec("PRAGMA synchronous = NORMAL;");
db.exec("PRAGMA busy_timeout = 5000;"); // espera até 5 s pelo lock
Notificações e avisos precisam ser fecháveis e ficar longe do campo de digitação. Isso também entrou na ADR 0032. Um aviso que tapa o input transforma um erro recuperável em app inutilizável.
Com dados do Git: o app tem 152 commits, 73 com prefixo feat e 24 com fix. O CLI tem 448 commits no total. Esses números mostram o ritmo de atividade e dão uma ideia do trabalho na fronteira; não medem qualidade.
busy_timeout.Construir CLI e app nativo juntos é, na maior parte do tempo, cuidar da fronteira. As regras que funcionaram foram simples: contrato primeiro, um motor só, disjuntor calibrado, banco que espera em vez de falhar e avisos que não atrapalham.
Na próxima parte, a série passa aos modelos de código locais no Mac.
Se o seu time mantém um core e um cliente desktop ou mobile em paralelo e os bugs estão sempre na fronteira, é um tipo de revisão de arquitetura que faço na LEMON.DEV.