Setup
Verificar o build
Rode lint, types, tests e build de uma vez.
O LocalLens entrega um script composto que roda toda checagem que o projeto se importa:
bun run checkO que ele de fato roda
bun run check encadeia quatro passos. Cada um também fica exposto por
conta própria:
| Passo | Comando | O que checa |
|---|---|---|
| Lint + format | bun run lint (biome check .) | Estilo e bugs óbvios no repositório. Configurado em biome.json. |
| Types | bun run typecheck (tsc --noEmit) | TypeScript em modo estrito contra src/** e tests/**. |
| Tests | bun run test | Testes Bun em tests/ — atualmente chunker.test.ts e prompt.test.ts. |
| Build | bun run build | bun build src/server.ts --target=bun --outdir=dist. Smoke test de que nada quebra o bundler. |
Se qualquer passo falhar, o script inteiro sai com código não-zero. CI roda o mesmo script.
Testes em particular
Existem só dois arquivos de teste. Eles cobrem as partes mais propensas a regredir em silêncio:
tests/chunker.test.ts— verifica quechunkDocumentproduz chunks com overlap e metadata de fonte estável, e rejeita configurações inválidas de chunk.tests/prompt.test.ts— verifica quebuildGroundedHistoryinclui contexto de fonte e o fallback de sem-contexto, que o system prompt impõe grounding na fonte, e que o formato de citação entre colchetes está no lugar.
Quando você muda qualquer coisa em src/rag.ts ou src/files.ts, esses
testes são sua primeira linha de defesa.
Formatar no caminho
bun run formatRoda o Biome com --write. Útil como passo de pre-commit.