Lua in Maguyva: grafi del codice per giochi, plugin e OpenResty

Dove Lua fa inciampare gli strumenti di IA superficiali

Lua non ha una parola chiave per le classi. Gli oggetti sono tabelle, i metodi sono funzioni memorizzate al loro interno e l’ereditarietà è una chiamata a setmetatable. Un modulo è qualsiasi cosa restituisca require. La struttura è reale, ma vive in convenzioni che una ricerca testuale non capisce.

Maguyva legge queste convenzioni come struttura, così un agente può chiedere chi chiama un metodo o quali tabelle estendono una base e ottenere una risposta diretta.

Cosa estrae Maguyva in Lua

Maguyva copre i file .lua. Vengono estratte dichiarazioni di funzione, definizioni local function ed espressioni di funzione, e i metodi con i due punti come function Account:deposit() vengono attribuiti alla tabella proprietaria, Account. Le catene di metodi vengono seguite chiamata per chiamata, e le chiamate su self restano legate all’oggetto che le contiene.

Le convenzioni di Lua diventano relazioni:

• require, dofile e loadfile registrano import.
• Una chiamata a setmetatable a livello di modulo registra un’ereditarietà.
• ClassName:new(), ClassName.new() e setmetatable({...}, ClassName) contano come istanziazione.
• error() registra un throw, e pcall e xpcall registrano un catch.

Il grafo registra anche letture e scritture e flusso di controllo.

Esempi di prompt per agenti

• “Chi chiama Inventory:addItem, e da quali script?” (find_symbol, poi dependency_search incoming)
• “Quali moduli caricano util.http con require?” (dependency_search)
• “Traccia cosa succede quando il giocatore subisce danni.” (get_task_context)

Limiti noti

• Circa 150 nomi vengono filtrati dalle relazioni: la libreria standard di Lua (string, table, math, io, os, coroutine, debug e utf8) più le API vim.* di Neovim e ngx.* di OpenResty. Le chiamate a queste API non sono archi del grafo, quindi usa text_pattern_search per trovarle.
• Poiché moduli e classi sono costruiti con chiamate e tabelle normali, i preset classes e imports di structural_search non selezionano nulla per Lua. Usa invece find_symbol o text_pattern_search.
• Lua non ha interfacce né annotazioni di tipo, quindi le relazioni di implementazione di interfacce e di riferimento di tipo sono marcate come non applicabili.

Prossimi passi

Collega un repository con la guida rapida, poi consulta la matrice di supporto nella pagina di compatibilità. Per i motori che incorporano Lua nel codice nativo, leggi anche la guida a C.