symgraph 2026.6.14

Semantic code intelligence library and MCP server - build knowledge graphs of codebases
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

//! Shared formatting utilities for MCP tool outputs

use crate::types::Node;

/// Format a single node as a list item with location
pub fn format_node_list_item(node: &Node) -> String {
    format!(
        "- **{}** `{}` - {}:{}-{}",
        node.kind.as_str(),
        node.name,
        node.file_path,
        node.start_line,
        node.end_line
    )
}

/// Format a node with signature
pub fn format_node_with_signature(node: &Node) -> String {
    let mut output = format_node_list_item(node);
    if let Some(ref sig) = node.signature {
        output.push_str(&format!("\n  `{}`", sig));
    }
    output.push('\n');
    output
}

/// Format a node with basic location (for callers/callees)
pub fn format_node_simple(node: &Node) -> String {
    format!(
        "- **{}** `{}` - {}:{}",
        node.kind.as_str(),
        node.name,
        node.file_path,
        node.start_line
    )
}

/// Normalize file path (remove leading ./)
pub fn normalize_path(path: &str) -> &str {
    path.trim_start_matches("./")
}

/// Format a node with full details
pub fn format_node(node: &Node) -> String {
    let mut output = String::new();
    output.push_str(&format!("**{}** `{}`\n", node.kind.as_str(), node.name));
    output.push_str(&format!(
        "- Location: {}:{}-{}\n",
        node.file_path, node.start_line, node.end_line
    ));
    if let Some(ref sig) = node.signature {
        output.push_str(&format!("- Signature: `{}`\n", sig));
    }
    if let Some(ref doc) = node.docstring {
        output.push_str(&format!("- Doc: {}\n", doc));
    }
    output
}