CodeGraph Visual

Explorador visual, local y de solo lectura para índices de CodeGraph. Permite buscar símbolos, recorrer relaciones, analizar el radio de impacto de un cambio y ver el código fuente asociado sin subir el repositorio a ningún servidor.

Requisitos

• Chrome o Edge de escritorio.
• Un proyecto previamente indexado con CodeGraph.
• HTTPS en producción (Vercel lo proporciona automáticamente).

Antes de abrir un repositorio por primera vez:

codegraph init C:\ruta\al\proyecto

Para actualizar un índice existente:

codegraph sync C:\ruta\al\proyecto

La aplicación busca .codegraph/codegraph.db dentro de la carpeta seleccionada. El índice se copia por bloques al almacenamiento temporal OPFS del navegador y se consulta mediante SQLite WebAssembly. Los archivos fuente se leen directamente desde el permiso de carpeta concedido por el usuario.

Desarrollo

npm install
npm run dev

Validación completa:

npm test
npm run lint
npm run build

Tanto desarrollo como producción usan Webpack porque el paquete oficial de SQLite WASM contiene una URL dinámica que Turbopack todavía no puede resolver. El resultado estático queda en out/ y puede publicarse directamente en Vercel.

Privacidad y límites

• No existen rutas API, cuentas ni almacenamiento remoto.
• El proyecto debe volver a seleccionarse en cada sesión.
• El explorador de archivos permite recorrer carpetas, filtrar rutas y abrir los símbolos de un archivo directamente en el grafo.
• La vista se limita a 200 nodos y 500 relaciones por consulta.
• El modo Impacto recorre hasta 5 niveles, agrupa símbolos afectados por archivo e identifica pruebas conectadas.
• Impacto de Diff Git permite seleccionar varios archivos cambiados y calcular en conjunto qué símbolos, archivos y pruebas dependen de ellos.
• Cobertura de pruebas importa LCOV, Cobertura XML o JaCoCo XML, relaciona líneas y ramas con símbolos CodeGraph y colorea el mapa como cubierto, parcial o sin cubrir.
• Ruta entre símbolos encuentra el camino más corto entre un origen y un destino, con opción de respetar únicamente la dirección de las relaciones.
• Vista de arquitectura agrupa todo el índice por módulo, carpeta, archivo o lenguaje y agrega las dependencias entre grupos. Su drill-down abre los símbolos, archivos y relaciones internas de un grupo con doble clic.
• Proyectos múltiples cruza varios repositorios indexados, detecta dependencias mediante manifiestos de JavaScript, Python, Rust y Go, y permite añadir conexiones manuales para APIs, colas y eventos.
• Contratos entre proyectos analiza localmente endpoints HTTP, eventos, topics y esquemas Proto/GraphQL/JSON compartidos, conecta productores con consumidores y permite inspeccionar la evidencia por archivo y línea.
• Modo presentación captura vistas del grafo como pasos con título y explicación, permite reordenarlas, reproducirlas a pantalla enfocada con teclado y guardarlas localmente por proyecto o exportarlas como JSON.
• Asistente de arquitectura envía únicamente nodos, archivos y relaciones del subgrafo visible a un proveedor compatible con Responses API para generar explicaciones, resúmenes y preguntas. La API key se introduce en la web, permanece solo en memoria y se borra al cerrar el proyecto.
• Los accesos Callers y Callees aíslan las relaciones calls directas para ver quién invoca un símbolo o qué símbolos utiliza.
• Ruta de ejecución sigue llamadas salientes hasta 5 niveles y resume puntos finales, bifurcaciones y ciclos.
• Trazas reales importa OTLP/JSON de OpenTelemetry, reconstruye operaciones padre/hijo, muestra duración y errores, y relaciona cada span con símbolos del índice cuando existe una coincidencia exacta.
• Flamegraph convierte una traza en bloques proporcionales al tiempo, calcula el tiempo propio sin duplicar hijos solapados, permite enfocar ramas y ordena los principales cuellos de botella.
• Ruta de fallo parte de un span con error, aísla sus padres e hijos, abre el código asociado y superpone dos niveles de dependencias estáticas potencialmente afectadas.
• Detección de problemas señala funciones posiblemente sin uso, ciclos de calls/imports, archivos muy acoplados y nodos con demasiados vecinos. Los ciclos y archivos acoplados se abren como subgrafos; los falsos positivos pueden ocultarse y restaurarse localmente.
• Impacto, rutas, arquitectura, cobertura, proyectos múltiples, problemas y trazas se exportan localmente como PNG, SVG, JSON o Markdown sin incluir el contenido del código fuente.
• Los archivos fuente mayores de 5 MB no se cargan en el panel de código.
• Si codegraph.db-wal parece más reciente que la base principal, la interfaz recomienda ejecutar codegraph sync.