Lua en Maguyva: grafos de código para juegos, plugins y OpenResty

Dónde Lua hace tropezar a las herramientas de IA superficiales

Lua no tiene una palabra clave para clases. Los objetos son tablas, los métodos son funciones guardadas en ellas y la herencia es una llamada a setmetatable. Un módulo es lo que devuelva require. La estructura es real, pero vive en convenciones que una búsqueda de texto no entiende.

Maguyva lee esas convenciones como estructura, para que un agente pueda preguntar quién llama a un método o qué tablas extienden una base y obtener una respuesta directa.

Qué extrae Maguyva en Lua

Maguyva cubre archivos .lua. Se extraen declaraciones de funciones, definiciones local function y expresiones de función, y los métodos con dos puntos como function Account:deposit() se atribuyen a su tabla propietaria, Account. Las cadenas de métodos se siguen llamada a llamada, y las llamadas sobre self quedan ligadas al objeto que las contiene.

Las convenciones de Lua se convierten en relaciones:

• require, dofile y loadfile registran importaciones.
• Una llamada a setmetatable a nivel de módulo registra herencia.
• ClassName:new(), ClassName.new() y setmetatable({...}, ClassName) cuentan como instanciación.
• error() registra un throw, y pcall y xpcall registran un catch.

El grafo también registra lecturas y escrituras y flujo de control.

Ejemplos de prompts para agentes

• “¿Quién llama a Inventory:addItem y desde qué scripts?” (find_symbol, luego dependency_search incoming)
• “¿Qué módulos cargan util.http con require?” (dependency_search)
• “Rastrea qué pasa cuando el jugador recibe daño.” (get_task_context)

Limitaciones conocidas

• Unos 150 nombres se filtran de las relaciones: la biblioteca estándar de Lua (string, table, math, io, os, coroutine, debug y utf8) más las API vim.* de Neovim y ngx.* de OpenResty. Las llamadas a esas API no son aristas del grafo, así que usa text_pattern_search para encontrarlas.
• Como los módulos y las clases se construyen con llamadas y tablas normales, los presets classes y imports de structural_search no seleccionan nada para Lua. Usa en su lugar find_symbol o text_pattern_search.
• Lua no tiene interfaces ni anotaciones de tipo, así que las relaciones de implementación de interfaces y de referencia de tipos están marcadas como no aplicables.

Próximos pasos

Conecta un repositorio con el inicio rápido y luego revisa la matriz de compatibilidad en la página de compatibilidad. Para motores que embeben Lua en código nativo, lee también la guía de C.