Lua i Maguyva: kodgrafer för spel, plugins och OpenResty

Där Lua får ytliga AI-verktyg att snubbla

Lua har inget nyckelord för klasser. Objekt är tabeller, metoder är funktioner som lagras i dem och arv är ett anrop till setmetatable. En modul är vad require än returnerar. Strukturen är verklig, men den bor i konventioner som textsökning inte förstår.

Maguyva läser de konventionerna som struktur, så att en agent kan fråga vem som anropar en metod eller vilka tabeller som utökar en bas och få ett direkt svar.

Vad Maguyva extraherar i Lua

Maguyva täcker .lua-filer. Funktionsdeklarationer, local function-definitioner och funktionsuttryck extraheras, och kolonmetoder som function Account:deposit() knyts till sin ägartabell, Account. Metodkedjor följs anrop för anrop, och anrop på self förblir kopplade till det omgivande objektet.

Luas konventioner blir relationer så här:

• require, dofile och loadfile registrerar importer.
• Ett setmetatable-anrop på modulnivå registrerar arv.
• ClassName:new(), ClassName.new() och setmetatable({...}, ClassName) räknas som instansiering.
• error() registrerar ett throw, och pcall och xpcall registrerar en catch.

Grafen registrerar också läsningar och skrivningar samt kontrollflöde.

Exempel på prompter för agenter

• “Vem anropar Inventory:addItem, och från vilka skript?” (find_symbol, sedan dependency_search incoming)
• “Vilka moduler laddar util.http med require?” (dependency_search)
• “Spåra vad som händer när spelaren tar skada.” (get_task_context)

Kända begränsningar

• Omkring 150 namn filtreras bort från relationerna: Luas standardbibliotek (string, table, math, io, os, coroutine, debug och utf8) plus Neovims API vim.* och OpenRestys API ngx.*. Anrop till de API:erna är inga grafkanter, så använd text_pattern_search för att hitta dem.
• Eftersom moduler och klasser byggs av vanliga anrop och tabeller väljer presetet classes och imports i structural_search ingenting för Lua. Använd i stället find_symbol eller text_pattern_search.
• Lua har varken gränssnitt eller typannoteringar, så relationer för gränssnittsimplementering och typreferenser är markerade som ej tillämpliga.

Nästa steg

Anslut ett repo med snabbstarten och kontrollera sedan stödmatrisen på kompatibilitetssidan. För motorer som bäddar in Lua i native-kod, läs även guiden för C.