# Visualizzazione graph: Mermaid e HTML locale

Per un frammento leggibile direttamente in chat, usare `docs_mindmap.map_path`
o `map_neighborhood` con `output_format:"mermaid"` oppure `"both"`. Il JSON
resta il contratto strutturato; il traversal e' bidirezionale e conserva
direzione, certainty, confidence e provenance degli edge.

Per una vista navigabile nel browser usare solo sullo shelf locale scrivibile:

1. scegliere `view:"path"` con `source` e `target`, oppure
   `view:"neighborhood"` con `center`; scegliere `view:"overview"` per una
   mappa sintetica dell'intero shelf;
2. mantenere `max_depth` entro 8 e `max_nodes` entro 200; gli edge ambiguous
   restano esclusi salvo `include_ambiguous:true`;
3. chiamare `docs_mindmap.export_mindmap_html` con `shelf` e `save_path`
   assoluto che termini in `.html`;
4. fornire all'utente il percorso restituito, senza avviare il browser in modo
   implicito.

L'HTML e' standalone e non usa CDN, rete o analytics. Overview incorpora tutti
i nodi/edge del solo shelf, ma visualizza inizialmente cluster semantici; la
ricerca e il click su un cluster materializzano dettagli gia' inclusi nel file.
La pagina mostra filtri, zoom/pan, inspector e fallback testuale accessibile.

Il file e' una vista derivata: non modifica SQLite, versioni, hash, change-log,
cursor o replica. Un file esistente viene sostituito soltanto con `force:true`
e con marker docs-node per lo stesso shelf. L'azione e' `local_only`, non e'
esposta dal remote-server e non esiste una variante `docs_remote`; gli snapshot
remoti continuano a offrire Mermaid mediante le azioni path/neighborhood
read-through.