Mappa del repository

Individua l'attuale applicazione open-source, i pacchetti, i worker, lo schema e i file di deployment.

Applicazioni

Path	Responsibility
`apps/web`	Administrator console, widget runtime, public pages, server actions e API v1.
`apps/docs`	Applicazione di documentazione Fumadocs e pipeline di traduzione.
`apps/desktop`	Ciele Desktop: la schermata di accesso e la procedura guidata di configurazione locale.

Percorso	Responsabilità
`packages/core`	Tipi di dominio, regole Flow pure, valori predefiniti, condizioni e logica di analisi.
`packages/db`	Interfacce di persistenza, mock storage e implementazione di Supabase.
`packages/agent`	Esecuzione dei turni, provider di modelli, strumenti Knowledge, ingestion e valutazione.
`packages/ops`	Operazioni dell'organizzazione condivisa utilizzate dalle azioni della console e dall'API v1.
`packages/client`	Typed client per API v1.
`packages/cli`	Interfaccia a riga di comando basata sul client tipizzato.
`packages/mcp`	MCP server sul typed client: uno strumento di identità e quindici strumenti di dominio.
`packages/ui`	Componenti condivisi dell'interfaccia utente.
`packages/charts`	Visualizzazioni di analisi condivise.

Path	Responsibility
`services/crawl4ai`	Configurazione facoltativa del crawler con rendering JavaScript.
`supabase/migrations`	Modifiche allo schema del database in ordine.
`deploy`	Deployment di Docker Compose su un singolo host e script di bootstrap.

Le pure rules appartengono a packages/core. Il comportamento di persistenza appartiene a packages/db.

Le mutazioni riutilizzabili appartengono a packages/ops. Il comportamento del modello e del recupero appartiene a packages/agent.

Gli adattatori di superficie in apps/web, packages/cli e packages/mcp non devono creare un comportamento di dominio separato.