Layout do código

O app inteiro mora sob src/. Sem módulos aninhados, sem pacote compartilhado. Tudo é importado por caminho relativo, então você pode ler o call graph direto do topo de cada arquivo.

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)

Direção das dependências

O grafo de imports é uma via só. De cima para baixo, cada linha importa só de linhas acima dela.

domain.ts é a fundação. Todo outro arquivo importa dele; ele não importa nada de volta. locallens.ts é o ápice. Todo outro arquivo está abaixo dele; ele junta todos.

Resumo em duas linhas

cli e server ambos consomem LocalLensApp de locallens.ts. LocalLensApp consome files, rag, qvac e store. Todos quatro consomem só domain.

Próximo

A próxima página no caminho de construção — Walkthrough da implementação — visita cada arquivo em ordem de construção e mostra o código mínimo que cada um precisa.

Se você só quer uma referência rápida para "o que X deveria possuir?", a página Estrutura do código tem a tabela completa.