Lua no Maguyva: grafos de código para jogos, plugins e OpenResty

Onde Lua derruba ferramentas de IA superficiais

Lua não tem palavra-chave para classes. Objetos são tabelas, métodos são funções guardadas nelas, e herança é uma chamada a setmetatable. Um módulo é o que require retornar. A estrutura é real, mas vive em convenções que uma busca de texto não entende.

O Maguyva lê essas convenções como estrutura, para que um agente possa perguntar quem chama um método ou quais tabelas estendem uma base e receber uma resposta direta.

O que o Maguyva extrai em Lua

O Maguyva cobre arquivos .lua. Declarações de função, definições local function e expressões de função são extraídas, e métodos com dois-pontos como function Account:deposit() são atribuídos à tabela dona deles, Account. Cadeias de métodos são seguidas chamada a chamada, e chamadas em self continuam ligadas ao objeto que as contém.

As convenções do Lua viram relações:

• require, dofile e loadfile registram imports.
• Uma chamada a setmetatable no nível do módulo registra herança.
• ClassName:new(), ClassName.new() e setmetatable({...}, ClassName) contam como instanciação.
• error() registra um throw, e pcall e xpcall registram um catch.

O grafo também registra leituras e escritas e fluxo de controle.

Exemplos de prompts para agentes

• “Quem chama Inventory:addItem, e de quais scripts?” (find_symbol, depois dependency_search incoming)
• “Quais módulos carregam util.http com require?” (dependency_search)
• “Rastreie o que acontece quando o jogador leva dano.” (get_task_context)

Limitações conhecidas

• Cerca de 150 nomes são filtrados das relações: a biblioteca padrão do Lua (string, table, math, io, os, coroutine, debug e utf8) mais as APIs vim.* do Neovim e ngx.* do OpenResty. Chamadas a essas APIs não são arestas do grafo, então use text_pattern_search para encontrá-las.
• Como módulos e classes são montados com chamadas e tabelas comuns, os presets classes e imports do structural_search não selecionam nada para Lua. Use find_symbol ou text_pattern_search.
• Lua não tem interfaces nem anotações de tipo, então as relações de implementação de interface e de referência de tipo estão marcadas como não aplicáveis.

Próximos passos

Conecte um repositório pelo início rápido e depois confira a matriz de suporte na página de compatibilidade. Para engines que embarcam Lua em código nativo, leia também o guia de C.