MaguyvaのLua対応: ゲーム、プラグイン、OpenRestyのコードグラフ

Luaが浅いAIツールをつまずかせるところ

Luaにはクラスを宣言するキーワードがありません。オブジェクトはテーブルで、メソッドはその中に格納された関数で、継承は setmetatable の呼び出しです。モジュールは require が返すものすべてです。構造は確かに存在しますが、それはテキスト検索には理解できない慣習の中にあります。

Maguyvaはそうした慣習を構造として読み取るため、エージェントはメソッドの呼び出し元や、基底を拡張しているテーブルを尋ねて、直接の答えを得られます。

MaguyvaがLuaで抽出するもの

Maguyvaは .lua ファイルに対応しています。関数宣言、local function の定義、関数式が抽出され、function Account:deposit() のようなコロンメソッドは、それを所有するテーブル Account に帰属されます。メソッドチェーンは呼び出しごとにたどられ、self に対する呼び出しはそれを囲むオブジェクトに結び付いたままです。

Luaの慣習は次のように関係性に対応付けられます。

• require、dofile、loadfile はインポートを記録します。
• モジュールレベルの setmetatable の呼び出しは継承を記録します。
• ClassName:new()、ClassName.new()、setmetatable({...}, ClassName) はインスタンス化として数えられます。
• error() はスローを、pcall と xpcall はキャッチを記録します。

グラフには、読み取りと書き込み、制御フローも記録されます。

エージェントへのプロンプト例

• 「Inventory:addItem を呼び出しているのは誰で、どのスクリプトからか？」（find_symbol、次に dependency_search の incoming）
• 「util.http をrequireしているモジュールはどれか？」（dependency_search）
• 「プレイヤーがダメージを受けたときに何が起きるかを追跡して。」（get_task_context）

既知の制限

• 約150個の名前が関係性から除外されます。Luaの標準ライブラリ（string、table、math、io、os、coroutine、debug、utf8）に加え、Neovimの vim.* とOpenRestyの ngx.* のAPIです。それらのAPIへの呼び出しはグラフのエッジにならないため、見つけるには text_pattern_search を使ってください。
• モジュールとクラスは通常の呼び出しとテーブルで作られるため、structural_search の classes と imports のプリセットはLuaでは何も選択しません。代わりに find_symbol か text_pattern_search を使ってください。
• Luaにはインターフェースも型注釈もないため、インターフェース実装と型参照の関係性は適用対象外とされています。

次のステップ

クイックスタートでリポジトリを接続し、互換性ページで対応マトリクスを確認してください。ネイティブコードにLuaを組み込むエンジンについては、Cガイドもご覧ください。