Graft Manager Accesible: Grafo de Contexto y Ahorro de Tokens para Inteligencias Artificiales

Graft Manager Accesible es una herramienta de escritorio para Windows desarrollada en Python 3 y wxPython que permite indexar, estructurar y conectar cualquier repositorio o carpeta de código con modelos de Inteligencia Artificial (como Claude Code, Cursor IDE, Gemini, ChatGPT, GitHub Copilot, Windsurf o Codex) mediante Graft.

El motor central y la fuente que hace posible esta aplicación es el proyecto de código abierto Graft, desarrollado por Nanonets:

• Repositorio oficial de Graft en GitHub: github.com/NanoNets/Graft

Al procesar un proyecto, Graft genera un grafo determinista de dependencias y arquitecturas en la carpeta local graft/. Esto permite que las IAs consulten mapas precisos, firmas de funciones y análisis de impacto sin necesidad de leer archivos completos a ciegas, ahorrando más de un 40% en consumo de tokens y acelerando drásticamente el tiempo de respuesta.

La aplicación ha sido desarrollada por @XeBoLaX con un diseño centrado en la accesibilidad universal, garantizando una experiencia óptima para personas usuarias de lectores de pantalla como NVDA, JAWS y el Narrador de Windows.

1. Que es Graft y como reduce el consumo de tokens

Cuando un asistente de Inteligencia Artificial trabaja sobre un proyecto de programación convencional, suele requerir la lectura de archivos enteros repetidamente para entender cómo se relacionan las clases y funciones. Este proceso consume miles de tokens en cada consulta y agota rápidamente las ventanas de contexto.

Graft (github.com/NanoNets/Graft) es la fuente y motor que resuelve este problema mediante analizadores sintácticos de código (Tree-Sitter) que indexan el proyecto de forma local, determinista y gratuita (sin consumir saldo de API):

• Mapa de Repositorio Condensado (graft map): Ofrece un resumen estructurado del proyecto con directorios clave y puntos calientes (hotspots).
• Extracción de Esqueletos (graft skeleton): Extrae únicamente las firmas de métodos, clases y tipos omitiendo los cuerpos de las funciones, logrando un ahorro de tokens superior al 90% en inspecciones de librerías o módulos.
• Rastreo de Impacto (graft callers): Determina qué funciones llaman a un símbolo específico o a cuáles invoca antes de realizar una modificación compartida.
• Consultas Precisas (graft ask): Localiza las líneas y archivos exactos donde se implementa una funcionalidad concreta sin sobrecargar a la IA con código innecesario.
• Visualizador 3D Interactivo (graft viz): Levanta un servidor local para explorar la arquitectura del código en un mapa tridimensional interactivo en el navegador web.

2. Asistente Paso a Paso para Principiantes (Ctrl+W)

Para facilitar el uso sin necesidad de memorizar comandos de consola, Graft Manager incorpora un Asistente Guiado en 4 Pasos:

1. Paso 1 - Selección de Carpeta y Tipo de Contenido: Permite seleccionar la carpeta de trabajo y especificar si contiene código fuente o si se trata de una carpeta de documentación previa y especificaciones. Incluye la opción de generar una plantilla limpia inicial (README.md e instrucciones) si la carpeta está vacía.
2. Paso 2 - Elección de Asistentes de IA: Permite marcar mediante casillas accesibles las IAs con las que se va a trabajar (Cursor, Claude Code, Gemini, Copilot, ChatGPT, Windsurf, OpenCode, Kiro, AdaL).
3. Paso 3 - Opciones Avanzadas de Optimización:
   • Grafo Profundo (--deep): Añade resúmenes semánticos en lenguaje natural de cada componente.
   • Reconstrucción Limpia (--no-reuse): Re-analiza todos los archivos desde cero ignorando cachés previas.
   • Ganchos de Auto-Sincronización (Hooks): Mantiene el grafo actualizado automáticamente cada vez que el editor o la IA guardan cambios en el código.
   • Servidor de Herramientas MCP: Habilita el protocolo Model Context Protocol para que herramientas como Claude Code o Cursor interroguen al grafo como una herramienta nativa.
   • Protocolo de Ahorro de Tokens: Copia automáticamente al portapapeles el texto del prompt de optimización para pegar en el chat de la IA.
4. Paso 4 - Ejecución y Registro Explicativo: Ejecuta en segundo plano las fases de inicialización y construcción, informando del porcentaje de avance mediante una barra de progreso y locución por voz.

3. Suite de Gestion y Reparacion de Entorno

Desde el menú Herramientas, la aplicación proporciona utilidades integrales para gestionar todas las dependencias necesarias:

• Instalación Automatizada de Node.js LTS: Si el sistema no cuenta con Node.js, Graft Manager lo detecta, solicita confirmación al usuario y lo instala automáticamente en segundo plano mediante el gestor oficial de Windows (Winget), configurando las variables de entorno sin requerir reinicio.
• Instalación de Graft con Scripts Nativos (Ctrl+I): Instala @nanonets/graft globalmente aplicando la directiva --allow-scripts para compilar los analizadores de código en C++ de Tree-Sitter (Python, TypeScript, JavaScript, Java y Go).
• Actualización a la Última Versión (Ctrl+U): Actualiza el motor de Graft manteniendo la compatibilidad con todas las plataformas.
• Reparación de Analizadores: Reinstala y recompila de forma forzada las librerías nativas si se produce algún conflicto con el entorno de compilación.
• Informe de Diagnóstico del Sistema: Genera un análisis detallado del estado de Node.js, NPM, Graft, Winget, Git, Python y variables de ruta PATH.

4. Caracteristicas de Accesibilidad Universal

Graft Manager ha sido construido siguiendo directrices estrictas de diseño accesible para lectores de pantalla:

• Tutorial Contextual (Ctrl+H): Al situarse sobre cualquier control, botón o casilla y pulsar Ctrl+H, se abre una ventana modal accesible que explica detalladamente la función y las ventajas de esa opción, locutando el texto de inmediato.
• Navegación Directa por Pestañas (Alt+1 a Alt+4): Permite saltar directamente entre las cuatro secciones principales del programa (1. Integración con IAs, 2. Construcción de Grafo, 3. Consultas y Visualización, 4. Análisis y Firmas).
• Navegación Fluida por Tabulador: Los cuadros de texto multilínea están optimizados para transferir el foco inmediatamente al botón Aceptar con la tecla Tabulador sin capturar el cursor.
• Listas con Casillas Parlantes: Implementación accesible que verbaliza el estado de cada elemento (marcado / desmarcado) y permite alternarlo con la Barra Espaciadora.
• Textos sin Partición de Líneas: Las consolas de registro utilizan desplazamiento horizontal y lectura completa para evitar cortes de palabras en los sintetizadores de voz.
• Control Total por Teclado: Todas las ventanas secundarias y cuadros de confirmación se cierran inmediatamente con la tecla Escape o Intro.

5. Atajos de Teclado Principales

• Ctrl+W: Abrir el Asistente Paso a Paso para Novatos.
• Ctrl+H: Abrir el tutorial y explicación del control enfocado.
• Alt+1 a Alt+4: Cambiar entre las pestañas principales.
• Ctrl+P: Generar y copiar el Protocolo de Ahorro de Tokens al portapapeles.
• Ctrl+O: Seleccionar la carpeta o repositorio de trabajo.
• Ctrl+I: Instalar Graft globalmente con soporte de analizadores nativos.
• Ctrl+U: Actualizar Graft a la última versión disponible.
• F5: Comprobar el estado del entorno (Node.js y Graft).
• F2: Abrir el Manual Completo de Usuario.
• F1: Ver la información y créditos de la aplicación.
• Escape: Cerrar cualquier cuadro de diálogo o mensaje.

6. Requisitos del Sistema y Ejecucion

• Sistema Operativo: Windows 10 o Windows 11 (64 bits).
• Entorno: La versión distribuida en GraftManager.zip es un ejecutable autónomo que no requiere tener Python instalado. Para las funciones de indexación de código, la aplicación gestiona automáticamente la instalación de Node.js LTS si no estuviera presente.
• Instalación: Descomprime el archivo GraftManager.zip en cualquier carpeta de tu equipo y ejecuta GraftManager.exe.