From ce2db25b4c02d0fea426af918d3a60c49fe41796 Mon Sep 17 00:00:00 2001 From: Davide Grilli Date: Sun, 15 Nov 2026 19:02:57 +0100 Subject: [PATCH] GRAFO.md: limiti noti allineati al grafo finale MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Gli avvisi di salute riguardano l'estrazione prima dell'unione, non il graph.json; styles.css manca perché graphify non ha un estrattore CSS. Co-Authored-By: Claude Sonnet 5.5 --- docs/GRAFO.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/GRAFO.md b/docs/GRAFO.md index 707008c..fd62701 100644 --- a/docs/GRAFO.md +++ b/docs/GRAFO.md @@ -76,11 +76,17 @@ per l'estrazione semantica serve `/graphify . --update`, che rielabora solo quei ## Limiti noti -- Il report segnala archi su nodi inesistenti e archi multipli collassati, soprattutto nelle - migrazioni SQL e nei template GitHub: il grafo può essere incompleto in quei punti. +- Gli avvisi di salute del build («archi su nodi inesistenti», «archi collassati») si + riferiscono all'estrazione prima dell'unione. Nel `graph.json` finale gli archi su nodi + inesistenti sono 0; gli archi tra la stessa coppia di nodi con relazioni diverse (import e + chiamata, o più righe) diventano uno solo e conservano le varianti in `also_seen`. I due + archi da un nodo a se stesso sono funzioni ricorsive vere. Per ricontrollare: + `graphify diagnose multigraph`. - La coesione bassa di una community non indica da sola un modulo da dividere: nei test, nei documenti-indice e nel file generato `routeTree.gen.ts` è normale. Rilette tutte le community da 25 nodi in su, nessuna mescola responsabilità diverse nel codice dell'app. - Un file letto solo in parte viene riprovato al giro successivo (`--update`). -- `src/styles.css` e i file di configurazione (Dockerfile, `.toml`, `.lock`, `.env.example`) - non sono nel grafo. `.env.example` non va mai incluso. +- `src/styles.css` non è nel grafo perché graphify non ha un estrattore per il CSS: l'import + in `__root.tsx` produce solo un nodo segnaposto `src_styles` senza file. I file di + configurazione (Dockerfile, `.toml`, `.lock`, `.env.example`) restano fuori di proposito: + `.env.example` non va mai incluso.