Layout del código fuente

Toda la app vive bajo src/. Sin módulos anidados, sin paquete compartido. Todo se importa por ruta relativa, así puedes leer el grafo de llamadas directo desde la parte superior de cada archivo.

src/domain.ts     shared types and AppError
src/files.ts      local + browser file adapters
src/rag.ts        chunking and grounded prompt
src/qvac.ts       QVAC integration
src/store.ts      JSON persistence
src/locallens.ts  application workflow
src/cli.ts        no-UI interface
src/server.ts     optional HTTP interface
src/ui/           optional browser UI (index.html, app.js, styles.css)

Dirección de dependencias

El grafo de imports es de una sola vía. De arriba a abajo, cada fila importa solo de las filas que están encima.

domain.ts es la base. Todos los otros archivos lo importan; él no importa nada de vuelta. locallens.ts es el ápice. Todos los otros archivos están debajo; él los junta a todos.

Resumen en dos líneas

cli y server consumen LocalLensApp desde locallens.ts. LocalLensApp consume files, rag, qvac y store. Los cuatro consumen solo domain.

Siguiente

La siguiente página en el camino de construcción — Walkthrough de implementación — visita cada archivo en orden de construcción y muestra el código mínimo que necesita cada uno.

Si solo quieres una referencia rápida para "¿qué debe poseer X?", la página de Estructura del código tiene la tabla completa.