Setup
Verificar el build
Corre lint, tipos, tests y build en una sola movida.
LocalLens incluye un script compuesto que corre cada chequeo del que se preocupa el proyecto:
bun run checkQué corre realmente
bun run check encadena cuatro pasos. Cada uno también está
expuesto por su cuenta:
| Paso | Comando | Qué chequea |
|---|---|---|
| Lint + format | bun run lint (biome check .) | Estilo y bugs obvios en todo el repo. Configurado en biome.json. |
| Tipos | bun run typecheck (tsc --noEmit) | TypeScript strict mode contra src/** y tests/**. |
| Tests | bun run test | Tests de Bun en tests/ — actualmente chunker.test.ts y prompt.test.ts. |
| Build | bun run build | bun build src/server.ts --target=bun --outdir=dist. Smoke-test de que nada rompa el bundler. |
Si algún paso falla, el script entero sale con código distinto de cero. CI corre el mismo script.
Los tests en particular
Solo hay dos archivos de test. Cubren las partes con más probabilidad de romperse silenciosamente:
tests/chunker.test.ts— verifica quechunkDocumentproduzca chunks solapados con metadata estable de la fuente, y rechace configuraciones de chunk inválidas.tests/prompt.test.ts— verifica quebuildGroundedHistoryincluya el contexto de la fuente y el fallback sin contexto, que el prompt del system imponga el grounding en fuentes, y que el formato de citas con corchetes esté en su lugar.
Cuando cambies algo en src/rag.ts o src/files.ts, esos tests
son tu primera línea de defensa.
Formatear al pasar
bun run formatCorre Biome con --write. Útil como paso pre-commit.