tree-sitter エンジン

v1.5.0 以降、LeanCTX は行単位の正規表現マッチングの代わりに tree-sitter をシグネチャ抽出に使用しています。tree-sitter はソースコードを完全な抽象構文木（AST）に解析し、正規表現では処理できない複数行シグネチャ、アロー関数、デコレータ、ネストされた定義の正確な抽出を可能にします。

なぜ tree-sitter か？

対応言語

各言語には、以下の定義タイプを抽出する専用の tree-sitter クエリがあります：

Svelte（.svelte）、Vue（.vue）、およびその他の未対応拡張子は、TS/JS ライクな構文の正規表現ベースエクストラクタに自動的にフォールバックします。

仕組み

ctx_read で --mode signatures または --mode map を使用する場合：

1. LeanCTX がファイル拡張子を検出し、対応する tree-sitter 文法をロードします。
2. ソースコードが1回のパスで AST に解析されます。
3. プリコンパイル済みの SCM クエリが定義ノード（関数、クラス、構造体など）にマッチします。
4. 各マッチは、名前、パラメータ、戻り値の型、可視性、非同期ステータスを含むコンパクトな Signature オブジェクトに変換されます。
5. シグネチャはコンパクト記法（または TDD 記法が有効な場合はそちら）でフォーマットされます。

例：複数行の Rust シグネチャ

正規表現エクストラクタはこの複数行関数を検出できません。tree-sitter は正しく処理します：

// Source (Rust)
pub fn complex_function<T: Display + Debug>(
    first_arg: &str,
    second_arg: Vec<T>,
    third_arg: Option<HashMap<String, Vec<u8>>>,
) -> Result<(), Box<dyn Error>> {
    Ok(())
}

// signatures mode output:
fn ⊛ complex_function(first_arg:&str, second_arg:Vec<T>, third_arg:Option<HashMap<String, Vec<u8>>>) → Result<(), Box<dyn Error>>

例：アロー関数（TypeScript）

// Source (TypeScript)
export const fetchData = async (url: string): Promise<Response> => {
    return fetch(url);
};

// signatures mode output:
fn ⊛ fetchData(url:s) → Promise<Response>

バイナリサイズ

tree-sitter の文法にはコンパイル済み C パーサーが含まれるため、バイナリサイズが 約5.7 MB から 約17 MB に増加します。サイズが重要な場合は、tree-sitter なしでビルドできます：

# Build from source without tree-sitter (regex-only, 4 languages)
cargo install lean-ctx --no-default-features

デフォルトの Homebrew フォーミュラおよび cargo install lean-ctx には、18言語すべてを含む tree-sitter が付属しています。

関連項目

• ctx_read - signatures モードと map モード
• Token Dense Dialect - TDD シグネチャフォーマット
• ctx_benchmark - 保存スコア付きのプロジェクト全体・ファイルごとのベンチマーク