symgraph 2026.5.30

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

//! File listing handler

use crate::db::Database;
use crate::mcp::format::normalize_path;
use crate::mcp::types::FileRequest;
use crate::security::validate_relative;

pub fn handle_file(db: &Database, req: &FileRequest) -> Result<String, String> {
    let normalized = normalize_path(&req.path);
    let path = validate_relative(normalized).map_err(|e| e.to_string())?;

    let nodes = db.get_nodes_by_file(path).map_err(|e| e.to_string())?;

    if nodes.is_empty() {
        return Ok(format!(
            "No symbols found in '{}'. File may not be indexed.",
            path
        ));
    }

    let mut output = format!("## Symbols in `{}`\n\n", path);
    output.push_str(&format!("Found {} symbols:\n\n", nodes.len()));

    // Group by kind for better readability
    let mut by_kind: std::collections::HashMap<String, Vec<_>> = std::collections::HashMap::new();
    for node in &nodes {
        by_kind
            .entry(node.kind.as_str().to_string())
            .or_default()
            .push(node);
    }

    // Sort kinds for consistent output
    let mut kinds: Vec<_> = by_kind.keys().cloned().collect();
    kinds.sort();

    for kind in kinds {
        let nodes = &by_kind[&kind];
        output.push_str(&format!("### {} ({}):\n\n", kind, nodes.len()));
        for node in nodes {
            output.push_str(&format!(
                "- `{}` (lines {}-{})",
                node.name, node.start_line, node.end_line
            ));
            if let Some(ref sig) = node.signature {
                output.push_str(&format!(" - `{}`", sig));
            }
            output.push('\n');
        }
        output.push('\n');
    }

    Ok(output)
}