symforge 8.8.1

SymForge — in-memory code intelligence MCP server for Claude Code, Codex, and Gemini CLI
Documentation
use tree_sitter::Node;

use super::{
    DocCommentSpec, SymbolSink, collect_symbols, has_child_kind, push_named_symbol, walk_children,
};

pub(super) const DOC_SPEC: DocCommentSpec = DocCommentSpec {
    comment_node_types: &["comment"],
    doc_prefixes: Some(&["///", "/**", "//!", "/*!"]),
    custom_doc_check: None,
};
use crate::domain::{SymbolKind, SymbolRecord};

pub fn extract_symbols(node: &Node, source: &str) -> Vec<SymbolRecord> {
    collect_symbols(node, source, walk_node)
}

fn walk_node(
    node: &Node,
    source: &str,
    depth: u32,
    sort_order: &mut u32,
    symbols: &mut Vec<SymbolRecord>,
) {
    let kind = match node.kind() {
        "function_definition" => Some(SymbolKind::Function),
        // Only extract struct/enum/class definitions (with a body), not type-reference
        // usages like `enum ggml_type param` in function signatures.
        "struct_specifier" if has_child_kind(node, "field_declaration_list") => {
            Some(SymbolKind::Struct)
        }
        "enum_specifier" if has_child_kind(node, "enumerator_list") => Some(SymbolKind::Enum),
        "enumerator" => Some(SymbolKind::Constant),
        "type_definition" => Some(SymbolKind::Type),
        "class_specifier" if has_child_kind(node, "field_declaration_list") => {
            Some(SymbolKind::Class)
        }
        "namespace_definition" => Some(SymbolKind::Module),
        // template_declaration: handled by walk_children recursion into inner symbol
        _ => None,
    };

    {
        let mut sink = SymbolSink::new(source, sort_order, symbols, &DOC_SPEC);
        push_named_symbol(
            node,
            depth,
            kind,
            |node, source, _| find_cpp_name(node, source),
            &mut sink,
        );
    }
    walk_children(node, source, depth, sort_order, symbols, kind, walk_node);
}

/// Find the name for C++ declarations.
fn find_cpp_name(node: &Node, source: &str) -> Option<String> {
    match node.kind() {
        "function_definition" => find_function_name(node, source),
        "struct_specifier" | "enum_specifier" | "class_specifier" => {
            let mut cursor = node.walk();
            for child in node.children(&mut cursor) {
                if child.kind() == "type_identifier" || child.kind() == "name" {
                    return Some(child.utf8_text(source.as_bytes()).unwrap_or("").to_string());
                }
            }
            None
        }
        "namespace_definition" => {
            let mut cursor = node.walk();
            for child in node.children(&mut cursor) {
                if child.kind() == "identifier" || child.kind() == "namespace_identifier" {
                    return Some(child.utf8_text(source.as_bytes()).unwrap_or("").to_string());
                }
            }
            // Anonymous namespace
            None
        }
        "type_definition" => {
            let mut cursor = node.walk();
            let children: Vec<_> = node.children(&mut cursor).collect();
            for child in children.iter().rev() {
                if child.kind() == "type_identifier" || child.kind() == "identifier" {
                    return Some(child.utf8_text(source.as_bytes()).unwrap_or("").to_string());
                }
            }
            None
        }
        "enumerator" => {
            let mut cursor = node.walk();
            for child in node.children(&mut cursor) {
                if child.kind() == "identifier" {
                    return Some(child.utf8_text(source.as_bytes()).unwrap_or("").to_string());
                }
            }
            None
        }
        _ => None,
    }
}

/// Walk the declarator chain for a function_definition to find the function name.
/// In C++, declarators may contain qualified_identifier (Foo::bar) or plain identifier.
fn find_function_name(node: &Node, source: &str) -> Option<String> {
    let mut cursor = node.walk();
    for child in node.children(&mut cursor) {
        match child.kind() {
            "declarator"
            | "pointer_declarator"
            | "reference_declarator"
            | "function_declarator" => {
                if let Some(name) = extract_declarator_name(&child, source) {
                    return Some(name);
                }
            }
            _ => {}
        }
    }
    None
}

/// Recursively walk a declarator node to extract the function identifier.
/// Handles: identifier, qualified_identifier (Foo::bar -> "bar"), pointer chains.
fn extract_declarator_name(node: &Node, source: &str) -> Option<String> {
    match node.kind() {
        "identifier" => Some(node.utf8_text(source.as_bytes()).unwrap_or("").to_string()),
        "qualified_identifier" => {
            // Preserve the full qualified name: "Foo::bar" stays "Foo::bar".
            // LLMs see the qualified form in source and will send it to edit tools.
            Some(node.utf8_text(source.as_bytes()).unwrap_or("").to_string())
        }
        "destructor_name" => {
            // ~ClassName
            let mut cursor = node.walk();
            for child in node.children(&mut cursor) {
                if child.kind() == "identifier" || child.kind() == "type_identifier" {
                    let name = child.utf8_text(source.as_bytes()).unwrap_or("");
                    return Some(format!("~{name}"));
                }
            }
            None
        }
        _ => {
            // Recurse through pointer_declarator, function_declarator, reference_declarator etc.
            let mut cursor = node.walk();
            for child in node.children(&mut cursor) {
                if let Some(name) = extract_declarator_name(&child, source) {
                    return Some(name);
                }
            }
            None
        }
    }
}

// ---------------------------------------------------------------------------
// Tests
// ---------------------------------------------------------------------------

#[cfg(test)]
mod tests {
    use super::*;
    use crate::domain::{FileOutcome, LanguageId};
    use crate::parsing::process_file;
    use tree_sitter::Parser;

    fn parse_cpp(source: &str) -> Vec<SymbolRecord> {
        let mut parser = Parser::new();
        let lang: tree_sitter::Language = tree_sitter_cpp::LANGUAGE.into();
        parser.set_language(&lang).expect("set C++ language");
        let tree = parser.parse(source, None).expect("parse C++ source");
        extract_symbols(&tree.root_node(), source)
    }

    #[test]
    fn test_cpp_language_function_definition() {
        let source = "int add(int a, int b) { return a + b; }";
        let symbols = parse_cpp(source);
        let func = symbols.iter().find(|s| s.kind == SymbolKind::Function);
        assert!(
            func.is_some(),
            "should extract function, got: {:?}",
            symbols
        );
        assert_eq!(func.unwrap().name, "add");
    }

    #[test]
    fn test_cpp_language_struct_specifier() {
        let source = "struct Point { int x; int y; };";
        let symbols = parse_cpp(source);
        let s = symbols.iter().find(|s| s.kind == SymbolKind::Struct);
        assert!(s.is_some(), "should extract struct, got: {:?}", symbols);
        assert_eq!(s.unwrap().name, "Point");
    }

    #[test]
    fn test_cpp_language_enum_specifier() {
        let source = "enum Color { RED, GREEN, BLUE };";
        let symbols = parse_cpp(source);
        let e = symbols.iter().find(|s| s.kind == SymbolKind::Enum);
        assert!(e.is_some(), "should extract enum, got: {:?}", symbols);
        assert_eq!(e.unwrap().name, "Color");
    }

    #[test]
    fn test_cpp_language_enum_variants_extracted() {
        let source = "enum class Direction { NORTH, SOUTH = 2, EAST, WEST };";
        let symbols = parse_cpp(source);
        let variants: Vec<_> = symbols
            .iter()
            .filter(|s| s.kind == SymbolKind::Constant)
            .collect();
        assert_eq!(
            variants.len(),
            4,
            "should extract 4 variants, got: {:?}",
            variants
        );
        let names: Vec<&str> = variants.iter().map(|s| s.name.as_str()).collect();
        assert!(names.contains(&"NORTH"), "missing NORTH");
        assert!(names.contains(&"SOUTH"), "missing SOUTH");
        assert!(names.contains(&"EAST"), "missing EAST");
        assert!(names.contains(&"WEST"), "missing WEST");
    }

    #[test]
    fn test_cpp_language_enum_variants_nested_under_enum() {
        let source = "enum Flags {\n    A = 1,\n    B = 2\n};";
        let symbols = parse_cpp(source);
        let enum_sym = symbols.iter().find(|s| s.kind == SymbolKind::Enum).unwrap();
        let variants: Vec<_> = symbols
            .iter()
            .filter(|s| s.kind == SymbolKind::Constant)
            .collect();
        for v in &variants {
            assert!(
                v.depth > enum_sym.depth,
                "variant {} depth {} should be > enum depth {}",
                v.name,
                v.depth,
                enum_sym.depth
            );
        }
    }

    #[test]
    fn test_cpp_language_class_specifier() {
        let source = "class MyClass { public: int x; };";
        let symbols = parse_cpp(source);
        let c = symbols.iter().find(|s| s.kind == SymbolKind::Class);
        assert!(c.is_some(), "should extract class, got: {:?}", symbols);
        assert_eq!(c.unwrap().name, "MyClass");
    }

    #[test]
    fn test_cpp_language_namespace_definition() {
        let source = "namespace myns { int x = 0; }";
        let symbols = parse_cpp(source);
        let ns = symbols.iter().find(|s| s.kind == SymbolKind::Module);
        assert!(ns.is_some(), "should extract namespace, got: {:?}", symbols);
        assert_eq!(ns.unwrap().name, "myns");
    }

    #[test]
    fn test_cpp_language_template_declaration_inner_class() {
        let source = "template<typename T> class Stack { T data; };";
        let symbols = parse_cpp(source);
        // template_declaration itself doesn't create a symbol; inner class_specifier does
        let c = symbols.iter().find(|s| s.kind == SymbolKind::Class);
        assert!(
            c.is_some(),
            "should extract inner class from template, got: {:?}",
            symbols
        );
        assert_eq!(c.unwrap().name, "Stack");
    }

    #[test]
    fn test_cpp_language_method_with_qualified_identifier() {
        let source = "void Foo::bar(int x) { }";
        let symbols = parse_cpp(source);
        let func = symbols.iter().find(|s| s.kind == SymbolKind::Function);
        assert!(
            func.is_some(),
            "should extract qualified method, got: {:?}",
            symbols
        );
        // Should preserve the full qualified name
        assert_eq!(func.unwrap().name, "Foo::bar");
    }

    #[test]
    fn test_cpp_language_process_file_returns_processed() {
        let source =
            b"#include <vector>\nclass Foo { public: void bar(); };\nvoid Foo::bar() { }\n";
        let result = process_file("test.cpp", source, LanguageId::Cpp);
        assert_eq!(
            result.outcome,
            FileOutcome::Processed,
            "outcome: {:?}",
            result.outcome
        );
        assert!(!result.symbols.is_empty(), "should have symbols");
        let class = result
            .symbols
            .iter()
            .find(|s| s.kind == SymbolKind::Class && s.name == "Foo");
        assert!(class.is_some(), "should have Foo class");
    }
}