Skip to main content

codelens_engine/
call_graph.rs

1use crate::project::ProjectRoot;
2use anyhow::Result;
3use regex::Regex;
4use serde::Serialize;
5use std::collections::{HashMap, HashSet};
6use std::fs;
7use std::path::{Path, PathBuf};
8use std::sync::{Arc, LazyLock, Mutex};
9use streaming_iterator::StreamingIterator;
10use tree_sitter::{Language, Parser, Query, QueryCursor};
11
12use crate::import_graph::GraphCache;
13
14/// Cached compiled tree-sitter Query for call graph extraction.
15/// Key: (canonical language key, query string pointer as usize).
16type CallQueryCacheKey = (&'static str, usize);
17type CallQueryCache = Mutex<HashMap<CallQueryCacheKey, Arc<Query>>>;
18
19static CALL_QUERY_CACHE: LazyLock<CallQueryCache> = LazyLock::new(|| Mutex::new(HashMap::new()));
20static JS_IMPORT_FROM_RE: LazyLock<Regex> = LazyLock::new(|| {
21    Regex::new(r#"(?m)\bimport\s+([^;]+?)\s+from\s+["']([^"']+)["']"#).expect("import regex")
22});
23
24fn cached_call_query(
25    language_key: &'static str,
26    language: &Language,
27    query_str: &'static str,
28) -> Option<Arc<Query>> {
29    let key = (language_key, query_str.as_ptr() as usize);
30    let mut cache = CALL_QUERY_CACHE.lock().unwrap_or_else(|p| p.into_inner());
31    if let Some(q) = cache.get(&key) {
32        return Some(Arc::clone(q));
33    }
34    let q = match Query::new(language, query_str) {
35        Ok(q) => q,
36        Err(error) => {
37            #[cfg(test)]
38            {
39                panic!("invalid call graph query: {error}");
40            }
41            #[cfg(not(test))]
42            {
43                let _ = error;
44                return None;
45            }
46        }
47    };
48    let q = Arc::new(q);
49    cache.insert(key, Arc::clone(&q));
50    Some(q)
51}
52
53use crate::project::collect_files;
54
55#[derive(Debug, Clone, Serialize)]
56pub struct CallEdge {
57    pub caller_file: String,
58    pub caller_name: String,
59    pub callee_name: String,
60    pub line: usize,
61    /// Resolved file where the callee is defined (None if unresolved).
62    #[serde(skip_serializing_if = "Option::is_none")]
63    pub resolved_file: Option<String>,
64    /// Confidence of the resolution (0.0–1.0). Higher = more certain.
65    pub confidence: f64,
66    /// Which resolution strategy succeeded.
67    #[serde(skip_serializing_if = "Option::is_none")]
68    pub resolution_strategy: Option<&'static str>,
69    #[serde(skip_serializing)]
70    pub canonical_callee_name: Option<String>,
71}
72
73#[derive(Debug, Clone, Serialize)]
74pub struct CallerEntry {
75    pub file: String,
76    pub function: String,
77    pub line: usize,
78    /// Confidence that this caller actually calls the target (0.0–1.0).
79    pub confidence: f64,
80    #[serde(skip_serializing_if = "Option::is_none")]
81    pub resolution: Option<&'static str>,
82}
83
84#[derive(Debug, Clone, Serialize)]
85pub struct CalleeEntry {
86    pub name: String,
87    pub line: usize,
88    #[serde(skip_serializing_if = "Option::is_none")]
89    pub resolved_file: Option<String>,
90    pub confidence: f64,
91    #[serde(skip_serializing_if = "Option::is_none")]
92    pub resolution: Option<&'static str>,
93}
94
95struct CallLanguageConfig {
96    /// Stable language/cache key. JS and TS can share query text but not compiled queries.
97    language_key: &'static str,
98    language: Language,
99    /// Query to find function definitions: captures @func.name
100    func_query: &'static str,
101    /// Query to find call sites: captures @callee
102    call_query: &'static str,
103}
104
105#[derive(Debug, Clone)]
106struct JSImportBinding {
107    imported_name: Option<String>,
108    resolved_file: Option<String>,
109    external: bool,
110}
111
112type JSImportBindingIndex = HashMap<String, HashMap<String, JSImportBinding>>;
113
114/// Resolve call graph config via the unified language registry.
115/// Only a subset of languages have call graph queries defined.
116/// Filter out common std/builtin method calls that add noise to the call graph.
117/// Covers Rust std, Python builtins, JS/TS builtins, Go builtins, and Java/Kotlin stdlib.
118pub(crate) fn is_noise_callee(name: &str) -> bool {
119    matches!(
120        name,
121        // ── cross-language common ──
122        "get" | "set" | "push" | "pop" | "len" | "from" | "into"
123            | "map" | "filter" | "collect" | "contains" | "insert" | "remove"
124            | "format" | "print" | "clone" | "default" | "next" | "read"
125            | "write" | "open" | "close" | "keys" | "values" | "sort"
126            | "reverse" | "find" | "replace" | "delete" | "add" | "clear"
127            | "of" | "size" | "copy"
128            // ── Rust std ──
129            | "is_empty" | "to_string" | "to_owned" | "as_str" | "as_ref"
130            | "unwrap" | "expect" | "ok" | "err" | "and_then" | "or_else"
131            | "unwrap_or" | "unwrap_or_else" | "unwrap_or_default"
132            | "iter" | "into_iter" | "take" | "skip"
133            | "println" | "eprintln" | "drop" | "enter" | "lock" | "cloned"
134            // ── Python builtins ──
135            | "range" | "enumerate" | "zip" | "sorted" | "reversed"
136            | "isinstance" | "issubclass" | "hasattr" | "getattr" | "setattr" | "delattr"
137            | "type" | "super" | "str" | "int" | "float" | "bool"
138            | "list" | "dict" | "tuple" | "frozenset" | "bytes" | "bytearray"
139            | "repr" | "abs" | "min" | "max" | "sum" | "any" | "all"
140            | "ord" | "chr" | "hex" | "oct" | "bin" | "hash" | "id"
141            | "input" | "vars" | "dir" | "help" | "round"
142            | "append" | "extend" | "update" | "items" | "join" | "split"
143            | "strip" | "startswith" | "endswith" | "encode" | "decode"
144            | "upper" | "lower"
145            // ── JS/TS builtins ──
146            | "log" | "warn" | "error" | "info" | "debug"
147            | "toString" | "valueOf" | "JSON" | "parse" | "stringify" | "assign"
148            | "entries" | "forEach" | "reduce" | "findIndex" | "some" | "every"
149            | "includes" | "indexOf" | "slice" | "splice" | "concat"
150            | "flat" | "flatMap" | "fill" | "isArray"
151            | "Promise" | "resolve" | "reject" | "then" | "catch" | "finally"
152            | "setTimeout" | "setInterval" | "clearTimeout" | "clearInterval"
153            | "parseInt" | "parseFloat" | "isNaN" | "isFinite" | "require"
154            // ── Go builtins ──
155            | "make" | "cap" | "panic" | "recover" | "real" | "imag" | "complex"
156            | "Println" | "Printf" | "Sprintf" | "Fprintf" | "Errorf" | "New"
157            // ── Java/Kotlin stdlib ──
158            | "equals" | "hashCode" | "compareTo" | "getClass"
159            | "notify" | "notifyAll" | "wait" | "isEmpty"
160            | "addAll" | "containsKey" | "containsValue" | "put" | "putAll"
161            | "entrySet" | "keySet" | "charAt" | "substring" | "trim"
162            | "length" | "toArray" | "stream" | "asList"
163    )
164}
165
166/// Language-aware noise filter. Rust `new` is a constructor, not noise.
167pub(crate) fn is_noise_callee_for_lang(name: &str, lang: Option<&str>) -> bool {
168    if lang == Some("rs") && name == "new" {
169        return false;
170    }
171    is_noise_callee(name)
172}
173
174fn call_language_for_path(path: &Path) -> Option<CallLanguageConfig> {
175    let lang_config = crate::lang_config::language_for_path(path)?;
176    // Map canonical extension to call graph queries (not all languages support this)
177    let (language_key, func_query, call_query) = match lang_config.extension {
178        "py" => ("py", PYTHON_FUNC_QUERY, PYTHON_CALL_QUERY),
179        "js" => ("js", JS_FUNC_QUERY, JS_JSX_CALL_QUERY),
180        "ts" => ("ts", JS_FUNC_QUERY, JS_CALL_QUERY),
181        "tsx" => ("tsx", JS_FUNC_QUERY, JS_JSX_CALL_QUERY),
182        "go" => ("go", GO_FUNC_QUERY, GO_CALL_QUERY),
183        "java" => ("java", JAVA_FUNC_QUERY, JAVA_CALL_QUERY),
184        "kt" => ("kt", KOTLIN_FUNC_QUERY, JAVA_CALL_QUERY),
185        "rs" => ("rs", RUST_FUNC_QUERY, RUST_CALL_QUERY),
186        _ => return None,
187    };
188    Some(CallLanguageConfig {
189        language_key,
190        language: lang_config.language,
191        func_query,
192        call_query,
193    })
194}
195
196fn collect_candidate_files(root: &Path) -> Result<Vec<PathBuf>> {
197    collect_files(root, |path| call_language_for_path(path).is_some())
198}
199
200fn is_import_sensitive_path(path: &str) -> bool {
201    matches!(
202        Path::new(path)
203            .extension()
204            .and_then(|value| value.to_str())
205            .unwrap_or_default(),
206        "js" | "jsx" | "ts" | "tsx"
207    )
208}
209
210fn is_external_module_specifier(module: &str, resolved_file: Option<&String>) -> bool {
211    resolved_file.is_none() && !module.starts_with('.') && !module.starts_with('/')
212}
213
214fn insert_js_binding(
215    bindings: &mut HashMap<String, JSImportBinding>,
216    local_name: &str,
217    imported_name: Option<&str>,
218    resolved_file: Option<&String>,
219    external: bool,
220) {
221    let local_name = local_name.trim().trim_start_matches("type ").trim();
222    if local_name.is_empty() {
223        return;
224    }
225    bindings.insert(
226        local_name.to_owned(),
227        JSImportBinding {
228            imported_name: imported_name
229                .map(|value| value.trim().trim_start_matches("type ").to_owned()),
230            resolved_file: resolved_file.cloned(),
231            external,
232        },
233    );
234}
235
236fn parse_js_import_bindings(
237    bindings: &mut HashMap<String, JSImportBinding>,
238    clause: &str,
239    resolved_file: Option<&String>,
240    module: &str,
241) {
242    let clause = clause.trim().trim_start_matches("type ").trim();
243    if clause.is_empty() {
244        return;
245    }
246    let external = is_external_module_specifier(module, resolved_file);
247
248    if let Some(stripped) = clause.strip_prefix("* as ") {
249        insert_js_binding(bindings, stripped, Some("*"), resolved_file, external);
250        return;
251    }
252
253    let mut default_part = clause;
254    if let Some(start) = clause.find('{') {
255        default_part = clause[..start].trim().trim_end_matches(',').trim();
256        if let Some(end) = clause[start + 1..].find('}') {
257            let named = &clause[start + 1..start + 1 + end];
258            for item in named.split(',') {
259                let item = item.trim().trim_start_matches("type ").trim();
260                if item.is_empty() {
261                    continue;
262                }
263                if let Some((imported, local)) = item.split_once(" as ") {
264                    insert_js_binding(bindings, local, Some(imported), resolved_file, external);
265                } else {
266                    insert_js_binding(bindings, item, Some(item), resolved_file, external);
267                }
268            }
269        }
270    }
271
272    if !default_part.is_empty() {
273        insert_js_binding(bindings, default_part, None, resolved_file, external);
274    }
275}
276
277fn build_js_import_binding_index(project: &ProjectRoot, files: &[PathBuf]) -> JSImportBindingIndex {
278    let mut index = HashMap::new();
279    for file in files {
280        let relative = project.to_relative(file);
281        if !is_import_sensitive_path(&relative) {
282            continue;
283        }
284        let Ok(source) = fs::read_to_string(file) else {
285            continue;
286        };
287        let mut bindings = HashMap::new();
288        for capture in JS_IMPORT_FROM_RE.captures_iter(&source) {
289            let Some(clause) = capture.get(1).map(|value| value.as_str()) else {
290                continue;
291            };
292            let Some(module) = capture.get(2).map(|value| value.as_str()) else {
293                continue;
294            };
295            let resolved_file = crate::import_graph::resolve_module_for_file(project, file, module);
296            parse_js_import_bindings(&mut bindings, clause, resolved_file.as_ref(), module);
297        }
298        if !bindings.is_empty() {
299            index.insert(relative, bindings);
300        }
301    }
302    index
303}
304
305fn filter_external_import_edges(edges: &mut Vec<CallEdge>, import_bindings: &JSImportBindingIndex) {
306    edges.retain(|edge| {
307        import_bindings
308            .get(&edge.caller_file)
309            .and_then(|bindings| bindings.get(&edge.callee_name))
310            .map(|binding| !binding.external)
311            .unwrap_or(true)
312    });
313}
314
315fn maybe_import_graph(
316    project: &ProjectRoot,
317    files: &[PathBuf],
318    graph_cache: Option<&GraphCache>,
319) -> Option<Arc<HashMap<String, crate::import_graph::FileNode>>> {
320    let cache = graph_cache?;
321    let needs_import_graph = files.iter().any(|file| {
322        let relative = project.to_relative(file);
323        crate::import_graph::supports_import_graph(&relative)
324    });
325    if !needs_import_graph {
326        return None;
327    }
328    let mut graph = crate::import_graph::build_graph_pub(project, cache)
329        .map(|graph| (*graph).clone())
330        .unwrap_or_default();
331
332    for file in files {
333        let relative = project.to_relative(file);
334        if !crate::import_graph::supports_import_graph(&relative) {
335            continue;
336        }
337        let needs_patch = graph
338            .get(&relative)
339            .map(|node| node.imports.is_empty())
340            .unwrap_or(true);
341        if !needs_patch {
342            continue;
343        }
344
345        let imports: HashSet<String> = crate::import_graph::extract_imports_for_file(file)
346            .into_iter()
347            .filter_map(|module| {
348                crate::import_graph::resolve_module_for_file(project, file, &module)
349            })
350            .collect();
351        let entry =
352            graph
353                .entry(relative.clone())
354                .or_insert_with(|| crate::import_graph::FileNode {
355                    imports: HashSet::new(),
356                    imported_by: HashSet::new(),
357                });
358        entry.imports = imports.clone();
359
360        for imported_file in imports {
361            graph
362                .entry(imported_file)
363                .or_insert_with(|| crate::import_graph::FileNode {
364                    imports: HashSet::new(),
365                    imported_by: HashSet::new(),
366                })
367                .imported_by
368                .insert(relative.clone());
369        }
370    }
371
372    if graph.is_empty() {
373        None
374    } else {
375        Some(Arc::new(graph))
376    }
377}
378
379/// Parse a file and extract all call edges within each function.
380pub fn extract_calls(path: &Path) -> Vec<CallEdge> {
381    let Ok(source) = fs::read_to_string(path) else {
382        return Vec::new();
383    };
384    extract_calls_from_source(path, &source)
385}
386
387/// Extract call edges from already-loaded source content (avoids re-reading disk).
388pub fn extract_calls_from_source(path: &Path, source: &str) -> Vec<CallEdge> {
389    let Some(config) = call_language_for_path(path) else {
390        return Vec::new();
391    };
392
393    let mut parser = Parser::new();
394    if parser.set_language(&config.language).is_err() {
395        return Vec::new();
396    }
397    let Some(tree) = parser.parse(source, None) else {
398        return Vec::new();
399    };
400    let source_bytes = source.as_bytes();
401
402    // Build a map: byte_range_start -> caller_name for each function definition.
403    // We'll use this to find which function contains each call site.
404    let Some(func_query) =
405        cached_call_query(config.language_key, &config.language, config.func_query)
406    else {
407        return Vec::new();
408    };
409    let mut func_ranges: Vec<(usize, usize, String)> = Vec::new(); // (start, end, name)
410    let mut func_cursor = QueryCursor::new();
411    let mut func_matches = func_cursor.matches(&func_query, tree.root_node(), source_bytes);
412    while let Some(m) = func_matches.next() {
413        let mut def_range: Option<(usize, usize)> = None;
414        let mut func_name: Option<String> = None;
415        for cap in m.captures.iter() {
416            let cap_name = &func_query.capture_names()[cap.index as usize];
417            if *cap_name == "func.def" {
418                def_range = Some((cap.node.start_byte(), cap.node.end_byte()));
419            } else if *cap_name == "func.name" {
420                let start = cap.node.start_byte();
421                let end = cap.node.end_byte();
422                func_name = std::str::from_utf8(&source_bytes[start..end])
423                    .ok()
424                    .map(|s| s.trim().to_owned());
425            }
426        }
427        if let (Some((s, e)), Some(name)) = (def_range, func_name)
428            && !name.is_empty()
429        {
430            func_ranges.push((s, e, name));
431        }
432    }
433
434    // Parse call sites
435    let Some(call_query) =
436        cached_call_query(config.language_key, &config.language, config.call_query)
437    else {
438        return Vec::new();
439    };
440    let mut call_cursor = QueryCursor::new();
441    let mut call_matches = call_cursor.matches(&call_query, tree.root_node(), source_bytes);
442    let file_path = path.to_string_lossy().to_string();
443    let mut edges = Vec::new();
444
445    while let Some(m) = call_matches.next() {
446        for cap in m.captures.iter() {
447            let cap_name = &call_query.capture_names()[cap.index as usize];
448            if *cap_name != "callee" {
449                continue;
450            }
451            let start = cap.node.start_byte();
452            let end = cap.node.end_byte();
453            let Ok(callee_name) = std::str::from_utf8(&source_bytes[start..end]) else {
454                continue;
455            };
456            let callee_name = callee_name.trim().to_owned();
457            if callee_name.is_empty()
458                || is_noise_callee_for_lang(&callee_name, Some(config.language_key))
459            {
460                continue;
461            }
462            let line = cap.node.start_position().row + 1;
463
464            // Find the enclosing function
465            let caller_name = func_ranges
466                .iter()
467                .filter(|(fs, fe, _)| *fs <= start && *fe >= end)
468                // pick the innermost (smallest range)
469                .min_by_key(|(fs, fe, _)| fe - fs)
470                .map(|(_, _, name)| name.clone())
471                .unwrap_or_else(|| "<module>".to_owned());
472
473            edges.push(CallEdge {
474                caller_file: file_path.clone(),
475                caller_name,
476                callee_name,
477                line,
478                resolved_file: None,
479                confidence: 0.0,
480                resolution_strategy: None,
481                canonical_callee_name: None,
482            });
483        }
484    }
485
486    edges
487}
488
489// ── 6-stage call resolution cascade ──────────────────────────────────────
490
491/// Resolve callee names to their definition files using a 6-stage confidence cascade.
492/// Mutates edges in-place, setting resolved_file, confidence, and resolution_strategy.
493fn resolve_call_edges(
494    edges: &mut [CallEdge],
495    project: &ProjectRoot,
496    import_graph: Option<&HashMap<String, crate::import_graph::FileNode>>,
497    import_bindings: Option<&JSImportBindingIndex>,
498) {
499    // Build a name→files index from the symbol DB for stages 3-5
500    let db_path = crate::db::index_db_path(project.as_path());
501    let symbol_index: HashMap<String, Vec<String>> = crate::db::IndexDb::open(&db_path)
502        .and_then(|db| {
503            let all = db.all_symbol_names()?;
504            let mut map: HashMap<String, Vec<String>> = HashMap::new();
505            for (name, _kind, file, _line, _signature, _name_path) in all {
506                map.entry(name).or_default().push(file);
507            }
508            Ok(map)
509        })
510        .unwrap_or_default();
511
512    for edge in edges.iter_mut() {
513        if edge.confidence > 0.0 {
514            continue; // already resolved
515        }
516
517        let callee = &edge.callee_name;
518        let caller_file = &edge.caller_file;
519
520        // Stage 1: Same file — local definitions beat imported or project-wide matches (0.90)
521        if let Some(defs) = symbol_index.get(callee)
522            && defs.iter().any(|f| f == caller_file)
523        {
524            edge.resolved_file = Some(caller_file.clone());
525            edge.confidence = 0.90;
526            edge.resolution_strategy = Some("same_file");
527            continue;
528        }
529
530        // Stage 2: Import map — imported target defines the callee (0.95)
531        if let Some(binding) = import_bindings
532            .and_then(|index| index.get(caller_file))
533            .and_then(|bindings| bindings.get(callee))
534            && let Some(resolved_file) = binding.resolved_file.as_ref()
535        {
536            let canonical_name = binding.imported_name.as_deref().unwrap_or(callee);
537            if let Some(defs) = symbol_index.get(canonical_name)
538                && defs.iter().any(|f| f == resolved_file)
539            {
540                edge.resolved_file = Some(resolved_file.clone());
541                edge.confidence = 0.95;
542                edge.resolution_strategy = Some("import_map");
543                edge.canonical_callee_name = Some(canonical_name.to_owned());
544                continue;
545            }
546        }
547
548        if let Some(graph) = import_graph
549            && let Some(node) = graph.get(caller_file)
550        {
551            for imported_file in &node.imports {
552                // Check if imported file defines callee
553                if let Some(defs) = symbol_index.get(callee)
554                    && defs.iter().any(|f| f == imported_file)
555                {
556                    edge.resolved_file = Some(imported_file.clone());
557                    edge.confidence = 0.95;
558                    edge.resolution_strategy = Some("import_map");
559                    edge.canonical_callee_name = Some(callee.clone());
560                    break;
561                }
562            }
563        }
564        if edge.confidence > 0.0 {
565            continue;
566        }
567
568        // Stage 3: Import suffix — imported module suffix points at the callee (0.70)
569        if let Some(graph) = import_graph
570            && let Some(node) = graph.get(caller_file)
571            && let Some(defs) = symbol_index.get(callee)
572        {
573            // Pick the candidate that is also imported (transitively)
574            for def_file in defs {
575                if node.imports.iter().any(|imp| {
576                    // Match on full path suffix, not just filename
577                    def_file.ends_with(imp)
578                        || def_file.ends_with(&format!("/{imp}"))
579                        || imp.ends_with(def_file)
580                        || imp.ends_with(&format!("/{def_file}"))
581                }) {
582                    edge.resolved_file = Some(def_file.clone());
583                    edge.confidence = 0.70;
584                    edge.resolution_strategy = Some("import_suffix");
585                    edge.canonical_callee_name = Some(callee.clone());
586                    break;
587                }
588            }
589        }
590        if edge.confidence > 0.0 {
591            continue;
592        }
593
594        // Stage 4: Unique name — only one definition exists project-wide (0.65).
595        // For JS/TS cross-file calls without import evidence, keep this as a fallback.
596        if let Some(defs) = symbol_index.get(callee)
597            && defs.len() == 1
598        {
599            edge.resolved_file = Some(defs[0].clone());
600            if is_import_sensitive_path(caller_file) && defs[0].as_str() != caller_file.as_str() {
601                edge.confidence = 0.50;
602                edge.resolution_strategy = Some("path_proximity");
603            } else {
604                edge.confidence = 0.65;
605                edge.resolution_strategy = Some("unique_name");
606            }
607            continue;
608        }
609
610        // Stage 5: Multiple candidates — pick closest by path similarity (0.50)
611        if let Some(defs) = symbol_index.get(callee)
612            && !defs.is_empty()
613        {
614            // Pick the one with the most shared path prefix with caller_file
615            let best = defs
616                .iter()
617                .max_by_key(|f| {
618                    f.chars()
619                        .zip(caller_file.chars())
620                        .take_while(|(a, b)| a == b)
621                        .count()
622                })
623                .cloned();
624            if let Some(f) = best {
625                edge.resolved_file = Some(f);
626                edge.confidence = 0.50;
627                edge.resolution_strategy = Some("path_proximity");
628                continue;
629            }
630        }
631
632        // Stage 6: Unresolved — callee not found in symbol DB (0.25)
633        edge.confidence = 0.25;
634        edge.resolution_strategy = Some("unresolved");
635    }
636}
637
638/// Find all functions that call `function_name` across the project.
639/// Edges are resolved via the 6-stage confidence cascade when an import graph is available.
640pub fn get_callers(
641    project: &ProjectRoot,
642    function_name: &str,
643    file_path: Option<&str>,
644    max_results: usize,
645    graph_cache: Option<&GraphCache>,
646) -> Result<Vec<CallerEntry>> {
647    let files: Vec<PathBuf> = if let Some(fp) = file_path {
648        vec![project.resolve(fp)?]
649    } else {
650        collect_candidate_files(project.as_path())?
651    };
652    let mut all_edges: Vec<CallEdge> = Vec::new();
653
654    for file in &files {
655        let mut edges = extract_calls(file);
656        // Relativize caller_file paths
657        for edge in &mut edges {
658            edge.caller_file = project.to_relative(file);
659        }
660        all_edges.extend(edges);
661    }
662
663    let import_bindings = build_js_import_binding_index(project, &files);
664    filter_external_import_edges(&mut all_edges, &import_bindings);
665    let import_graph = maybe_import_graph(project, &files, graph_cache);
666    resolve_call_edges(
667        &mut all_edges,
668        project,
669        import_graph.as_deref(),
670        Some(&import_bindings),
671    );
672
673    // Filter to edges calling our target
674    let mut seen = std::collections::HashSet::new();
675    let mut results = Vec::new();
676
677    for edge in all_edges {
678        if edge.callee_name == function_name
679            || edge.canonical_callee_name.as_deref() == Some(function_name)
680        {
681            let key = (
682                edge.caller_file.clone(),
683                edge.caller_name.clone(),
684                edge.line,
685            );
686            if seen.insert(key) {
687                results.push(CallerEntry {
688                    file: edge.caller_file,
689                    function: edge.caller_name,
690                    line: edge.line,
691                    confidence: edge.confidence,
692                    resolution: edge.resolution_strategy,
693                });
694            }
695        }
696    }
697
698    // Sort by confidence descending
699    results.sort_by(|a, b| {
700        b.confidence
701            .partial_cmp(&a.confidence)
702            .unwrap_or(std::cmp::Ordering::Equal)
703    });
704    if max_results > 0 && results.len() > max_results {
705        results.truncate(max_results);
706    }
707    Ok(results)
708}
709
710/// Find all functions called by `function_name` (optionally restricted to a file).
711/// Callee names are resolved to their definition files via the 6-stage cascade.
712pub fn get_callees(
713    project: &ProjectRoot,
714    function_name: &str,
715    file_path: Option<&str>,
716    max_results: usize,
717    graph_cache: Option<&GraphCache>,
718) -> Result<Vec<CalleeEntry>> {
719    let files: Vec<PathBuf> = if let Some(fp) = file_path {
720        let resolved = project.resolve(fp)?;
721        vec![resolved]
722    } else {
723        collect_candidate_files(project.as_path())?
724    };
725
726    let mut all_edges: Vec<CallEdge> = Vec::new();
727    for file in &files {
728        let mut edges = extract_calls(file);
729        for edge in &mut edges {
730            edge.caller_file = project.to_relative(file);
731        }
732        all_edges.extend(edges);
733    }
734
735    let import_bindings = build_js_import_binding_index(project, &files);
736    filter_external_import_edges(&mut all_edges, &import_bindings);
737    let import_graph = maybe_import_graph(project, &files, graph_cache);
738    resolve_call_edges(
739        &mut all_edges,
740        project,
741        import_graph.as_deref(),
742        Some(&import_bindings),
743    );
744
745    let mut seen: HashMap<(String, usize), ()> = HashMap::new();
746    let mut results = Vec::new();
747
748    for edge in all_edges {
749        if edge.caller_name == function_name {
750            let key = (edge.callee_name.clone(), edge.line);
751            if seen.insert(key, ()).is_none() {
752                results.push(CalleeEntry {
753                    name: edge.callee_name,
754                    line: edge.line,
755                    resolved_file: edge.resolved_file,
756                    confidence: edge.confidence,
757                    resolution: edge.resolution_strategy,
758                });
759            }
760        }
761    }
762
763    results.sort_by(|a, b| {
764        b.confidence
765            .partial_cmp(&a.confidence)
766            .unwrap_or(std::cmp::Ordering::Equal)
767    });
768    if max_results > 0 && results.len() > max_results {
769        results.truncate(max_results);
770    }
771    Ok(results)
772}
773
774// ---- Tree-sitter queries ----
775
776const PYTHON_FUNC_QUERY: &str = r#"
777(function_definition name: (identifier) @func.name) @func.def
778"#;
779
780const PYTHON_CALL_QUERY: &str = r#"
781(call function: (identifier) @callee)
782(call function: (attribute attribute: (identifier) @callee))
783(decorator (identifier) @callee)
784(decorator (call function: (identifier) @callee))
785(decorator (attribute attribute: (identifier) @callee))
786(decorator (call function: (attribute attribute: (identifier) @callee)))
787"#;
788
789const JS_FUNC_QUERY: &str = r#"
790(function_declaration name: (identifier) @func.name) @func.def
791(method_definition name: (property_identifier) @func.name) @func.def
792(lexical_declaration
793    (variable_declarator
794    name: (identifier) @func.name
795    value: [(arrow_function) (function_expression)] @func.def))
796(variable_declaration
797  (variable_declarator
798    name: (identifier) @func.name
799    value: [(arrow_function) (function_expression)] @func.def))
800"#;
801
802const JS_CALL_QUERY: &str = r#"
803(call_expression function: (identifier) @callee)
804(call_expression function: (member_expression property: (property_identifier) @callee))
805"#;
806
807// JSX/TSX adds React-style component usage (`<Foo />`, `<Foo>`) as caller→callee
808// edges. Plain TypeScript (.ts) has no JSX node types — keep this off the JS/TS
809// path. tree-sitter-javascript also supports JSX, so .jsx files share this set.
810const JS_JSX_CALL_QUERY: &str = r#"
811(call_expression function: (identifier) @callee)
812(call_expression function: (member_expression property: (property_identifier) @callee))
813(jsx_self_closing_element name: (identifier) @callee)
814(jsx_opening_element name: (identifier) @callee)
815(jsx_self_closing_element name: (member_expression property: (property_identifier) @callee))
816(jsx_opening_element name: (member_expression property: (property_identifier) @callee))
817"#;
818
819const GO_FUNC_QUERY: &str = r#"
820(function_declaration name: (identifier) @func.name) @func.def
821(method_declaration name: (field_identifier) @func.name) @func.def
822"#;
823
824const GO_CALL_QUERY: &str = r#"
825(call_expression function: (identifier) @callee)
826(call_expression function: (selector_expression field: (field_identifier) @callee))
827"#;
828
829const JAVA_FUNC_QUERY: &str = r#"
830(method_declaration name: (identifier) @func.name) @func.def
831(constructor_declaration name: (identifier) @func.name) @func.def
832"#;
833
834const JAVA_CALL_QUERY: &str = r#"
835(method_invocation name: (identifier) @callee)
836(object_creation_expression type: (type_identifier) @callee)
837(method_reference (identifier) @callee)
838"#;
839
840const KOTLIN_FUNC_QUERY: &str = r#"
841(function_declaration name: (identifier) @func.name) @func.def
842"#;
843
844const RUST_FUNC_QUERY: &str = r#"
845(function_item name: (identifier) @func.name) @func.def
846"#;
847
848const RUST_CALL_QUERY: &str = r#"
849(call_expression function: (identifier) @callee)
850(call_expression function: (field_expression field: (field_identifier) @callee))
851(call_expression function: (scoped_identifier name: (identifier) @callee))
852(macro_invocation macro: (identifier) @callee)
853(macro_invocation macro: (scoped_identifier name: (identifier) @callee))
854"#;
855
856#[cfg(test)]
857mod tests {
858    use super::{CallEdge, extract_calls, get_callees, get_callers, resolve_call_edges};
859    use crate::GraphCache;
860    use crate::ProjectRoot;
861    use crate::db::{IndexDb, NewSymbol, index_db_path};
862    use std::fs;
863
864    fn temp_dir(name: &str) -> std::path::PathBuf {
865        let dir = std::env::temp_dir().join(format!(
866            "codelens-callgraph-{name}-{}",
867            std::time::SystemTime::now()
868                .duration_since(std::time::UNIX_EPOCH)
869                .expect("time")
870                .as_nanos()
871        ));
872        fs::create_dir_all(&dir).expect("create tempdir");
873        dir
874    }
875
876    #[test]
877    fn extracts_python_calls() {
878        let dir = temp_dir("py");
879        let path = dir.join("main.py");
880        fs::write(
881            &path,
882            "def greet(name):\n    return helper(name)\n\ndef helper(x):\n    return x\n",
883        )
884        .expect("write");
885        let edges = extract_calls(&path);
886        assert!(
887            edges
888                .iter()
889                .any(|e| e.caller_name == "greet" && e.callee_name == "helper"),
890            "expected greet->helper edge, got {edges:?}"
891        );
892    }
893
894    #[test]
895    fn extracts_python_decorator_callers() {
896        // Python decorator pattern is THE most common Flask/FastAPI/click usage.
897        // tree-sitter call extractor previously missed it entirely (Flask: 1/292
898        // recall on `route`). Decorators must be treated as caller→callee edges.
899        let dir = temp_dir("py-deco");
900        let path = dir.join("views.py");
901        fs::write(
902            &path,
903            "from flask import Flask\napp = Flask(__name__)\n\
904             @app.route('/')\ndef home():\n    return 'hi'\n\n\
905             @app.route('/x')\ndef x_view():\n    return 'x'\n",
906        )
907        .expect("write");
908        let edges = extract_calls(&path);
909        let route_edges = edges.iter().filter(|e| e.callee_name == "route").count();
910        assert!(
911            route_edges >= 2,
912            "expected at least 2 caller edges for `route` decorator, got {route_edges}: {edges:?}"
913        );
914    }
915
916    #[test]
917    fn extracts_jsx_component_callers() {
918        // JSX <Component /> usage is THE core React pattern. Previously
919        // tree-sitter call extractor missed it entirely (rg-family: 0/14
920        // on `<Footer />`). JSX elements must be treated as caller→callee
921        // edges to the component function.
922        let dir = temp_dir("tsx");
923        let path = dir.join("page.tsx");
924        fs::write(
925            &path,
926            "import Footer from './Footer';\nimport { Button } from './ui';\n\
927             export default function Page() {\n  return (<div><Footer />\n\
928             <Button>OK</Button></div>);\n}\n",
929        )
930        .expect("write");
931        let edges = extract_calls(&path);
932        let footer_edges = edges.iter().filter(|e| e.callee_name == "Footer").count();
933        let button_edges = edges.iter().filter(|e| e.callee_name == "Button").count();
934        assert!(
935            footer_edges >= 1,
936            "expected at least 1 caller edge for `<Footer />`, got {footer_edges}: {edges:?}"
937        );
938        assert!(
939            button_edges >= 1,
940            "expected at least 1 caller edge for `<Button>`, got {button_edges}: {edges:?}"
941        );
942    }
943
944    #[test]
945    fn extracts_rust_calls() {
946        let dir = temp_dir("rs");
947        let path = dir.join("main.rs");
948        fs::write(&path, "fn main() {\n    run();\n}\n\nfn run() {}\n").expect("write");
949        let edges = extract_calls(&path);
950        assert!(
951            edges
952                .iter()
953                .any(|e| e.caller_name == "main" && e.callee_name == "run"),
954            "expected main->run edge, got {edges:?}"
955        );
956    }
957
958    /// Rust macro invocations (`vec!`, `assert_eq!`, project-defined macros,
959    /// scoped macros like `mycrate::log!`) are extremely common — but before
960    /// 2026-04-26 they were silently dropped from the call graph because
961    /// `macro_invocation` is a distinct AST node from `call_expression`.
962    ///
963    /// `println!` / `eprintln!` / `format!` / `print!` are intentionally
964    /// filtered by `is_noise_callee` to keep std-debug lines out of the
965    /// graph; the query DOES discover them but the noise filter drops them.
966    /// Project-named macros and `vec!` / `assert_eq!` survive — those are
967    /// the meaningful edges this PR unlocks.
968    #[test]
969    fn extracts_rust_macro_invocations_as_callers() {
970        let dir = temp_dir("rs-macros");
971        let path = dir.join("macros.rs");
972        fs::write(
973            &path,
974            r#"macro_rules! my_log { ($($t:tt)*) => {} }
975fn run() {
976    let v = vec![1, 2, 3];
977    assert_eq!(v.len(), 3);
978    my_log!("hello");
979}
980"#,
981        )
982        .expect("write");
983        let edges = extract_calls(&path);
984        for expected in ["vec", "assert_eq", "my_log"] {
985            assert!(
986                edges
987                    .iter()
988                    .any(|e| e.caller_name == "run" && e.callee_name == expected),
989                "expected run->{expected} macro edge, got {edges:?}"
990            );
991        }
992    }
993
994    /// Scoped macro invocations (`mycrate::my_macro!`). Uses project-named
995    /// macros so they survive the std-noise filter.
996    #[test]
997    fn extracts_rust_scoped_macro_invocations() {
998        let dir = temp_dir("rs-scoped-macros");
999        let path = dir.join("scoped.rs");
1000        fs::write(
1001            &path,
1002            "fn run() {\n    mycrate::trace_event!(\"hi\");\n    helpers::record_metric!(42);\n}\n",
1003        )
1004        .expect("write");
1005        let edges = extract_calls(&path);
1006        for expected in ["trace_event", "record_metric"] {
1007            assert!(
1008                edges
1009                    .iter()
1010                    .any(|e| e.caller_name == "run" && e.callee_name == expected),
1011                "expected run->{expected} scoped macro edge, got {edges:?}"
1012            );
1013        }
1014    }
1015
1016    #[test]
1017    fn extracts_js_arrow_function_callers() {
1018        let dir = temp_dir("js-arrow");
1019        let path = dir.join("handler.js");
1020        fs::write(
1021            &path,
1022            "const handleRequest = async (req) => {\n    validateUser(req);\n    service.run(req);\n};\nfunction validateUser(req) { return req; }\n",
1023        )
1024        .expect("write");
1025        let edges = extract_calls(&path);
1026        assert!(
1027            edges
1028                .iter()
1029                .any(|e| e.caller_name == "handleRequest" && e.callee_name == "validateUser"),
1030            "expected handleRequest->validateUser edge, got {edges:?}"
1031        );
1032    }
1033
1034    /// Java `new Foo()` — `object_creation_expression`, NOT method_invocation.
1035    /// Before C-2 the constructor target was silently dropped; only the
1036    /// follow-up `.method()` call was captured.
1037    #[test]
1038    fn extracts_java_constructor_invocations() {
1039        let dir = temp_dir("java-ctor");
1040        let path = dir.join("App.java");
1041        fs::write(
1042            &path,
1043            "class App { void caller() { Foo f = new Foo(); Bar b = new Bar(1, 2); f.process(); } }\n",
1044        )
1045        .expect("write");
1046        let edges = extract_calls(&path);
1047        for expected in ["Foo", "Bar", "process"] {
1048            assert!(
1049                edges
1050                    .iter()
1051                    .any(|e| e.caller_name == "caller" && e.callee_name == expected),
1052                "expected caller->{expected} edge, got {edges:?}"
1053            );
1054        }
1055    }
1056
1057    /// Java method references (`Foo::bar`). Modern Java + streams uses
1058    /// these heavily; pre-C-3 they emitted no edges because tree-sitter-java
1059    /// models `method_reference` as a distinct AST node from
1060    /// `method_invocation`. Uses non-noise method names so edges survive
1061    /// the std-noise filter (forEach/stream/map/println/toUpperCase are
1062    /// all in is_noise_callee).
1063    #[test]
1064    fn extracts_java_method_references() {
1065        let dir = temp_dir("java-mref");
1066        let path = dir.join("App.java");
1067        fs::write(
1068            &path,
1069            "class App { void caller(Bus b) { b.attach(Handler::dispatchEvent); b.subscribe(MyService::handleRequest); } }\n",
1070        )
1071        .expect("write");
1072        let edges = extract_calls(&path);
1073        for expected in ["attach", "dispatchEvent", "subscribe", "handleRequest"] {
1074            assert!(
1075                edges
1076                    .iter()
1077                    .any(|e| e.caller_name == "caller" && e.callee_name == expected),
1078                "expected caller->{expected} edge, got {edges:?}"
1079            );
1080        }
1081    }
1082
1083    #[test]
1084    fn extracts_ts_typed_arrow_function_callers() {
1085        let dir = temp_dir("ts-arrow");
1086        let path = dir.join("handler.ts");
1087        fs::write(
1088            &path,
1089            "type Request = { userId: string };\nconst handleRequest = async (req: Request): Promise<Request> => {\n    return validateUser(req);\n};\nfunction validateUser(req: Request) { return req; }\n",
1090        )
1091        .expect("write");
1092        let edges = extract_calls(&path);
1093        assert!(
1094            edges
1095                .iter()
1096                .any(|e| e.caller_name == "handleRequest" && e.callee_name == "validateUser"),
1097            "expected handleRequest->validateUser edge, got {edges:?}"
1098        );
1099    }
1100
1101    #[test]
1102    fn shared_js_ts_queries_do_not_cross_language_cache() {
1103        let dir = temp_dir("js-ts-cache");
1104        let js_path = dir.join("handler.js");
1105        let ts_path = dir.join("handler.ts");
1106        fs::write(
1107            &js_path,
1108            "const handleJs = () => {\n    validateJs();\n};\nfunction validateJs() {}\n",
1109        )
1110        .expect("write js");
1111        fs::write(
1112            &ts_path,
1113            "type Request = { userId: string };\nconst handleTs = (req: Request): Request => {\n    return validateTs(req);\n};\nfunction validateTs(req: Request) { return req; }\n",
1114        )
1115        .expect("write ts");
1116
1117        let js_edges = extract_calls(&js_path);
1118        assert!(
1119            js_edges
1120                .iter()
1121                .any(|e| e.caller_name == "handleJs" && e.callee_name == "validateJs"),
1122            "expected handleJs->validateJs edge, got {js_edges:?}"
1123        );
1124
1125        let ts_edges = extract_calls(&ts_path);
1126        assert!(
1127            ts_edges
1128                .iter()
1129                .any(|e| e.caller_name == "handleTs" && e.callee_name == "validateTs"),
1130            "expected handleTs->validateTs edge after JS extraction, got {ts_edges:?}"
1131        );
1132    }
1133
1134    #[test]
1135    fn extracts_rust_scoped_function_calls() {
1136        let dir = temp_dir("rs-scoped");
1137        let path = dir.join("main.rs");
1138        fs::write(
1139            &path,
1140            "mod auth { pub fn verify() {} }\nfn handler() {\n    auth::verify();\n}\n",
1141        )
1142        .expect("write");
1143        let edges = extract_calls(&path);
1144        assert!(
1145            edges
1146                .iter()
1147                .any(|e| e.caller_name == "handler" && e.callee_name == "verify"),
1148            "expected handler->verify edge, got {edges:?}"
1149        );
1150    }
1151
1152    #[test]
1153    fn get_callers_finds_callers() {
1154        let dir = temp_dir("callers");
1155        fs::write(dir.join("a.py"), "def foo():\n    bar()\n    baz()\n").expect("write a");
1156        fs::write(dir.join("b.py"), "def qux():\n    bar()\n").expect("write b");
1157        fs::write(dir.join("c.py"), "def bar():\n    pass\n").expect("write c");
1158
1159        let project = ProjectRoot::new(&dir).expect("project");
1160        let callers = get_callers(&project, "bar", None, 50, None).expect("callers");
1161        let names: Vec<&str> = callers.iter().map(|c| c.function.as_str()).collect();
1162        assert!(
1163            names.contains(&"foo"),
1164            "expected foo as caller, got {names:?}"
1165        );
1166        assert!(
1167            names.contains(&"qux"),
1168            "expected qux as caller, got {names:?}"
1169        );
1170    }
1171
1172    #[test]
1173    fn get_callees_finds_callees() {
1174        let dir = temp_dir("callees");
1175        fs::write(
1176            dir.join("main.py"),
1177            "def main():\n    foo()\n    bar()\n\ndef foo():\n    pass\n\ndef bar():\n    pass\n",
1178        )
1179        .expect("write");
1180
1181        let project = ProjectRoot::new(&dir).expect("project");
1182        let callees = get_callees(&project, "main", None, 50, None).expect("callees");
1183        let names: Vec<&str> = callees.iter().map(|c| c.name.as_str()).collect();
1184        assert!(
1185            names.contains(&"foo"),
1186            "expected foo as callee, got {names:?}"
1187        );
1188        assert!(
1189            names.contains(&"bar"),
1190            "expected bar as callee, got {names:?}"
1191        );
1192    }
1193
1194    #[test]
1195    fn get_callees_resolves_definition_file_path() {
1196        let dir = temp_dir("callees-file-path");
1197        fs::write(dir.join("main.py"), "def main():\n    helper()\n").expect("write main");
1198        fs::write(dir.join("helpers.py"), "def helper():\n    pass\n").expect("write helper");
1199        let db = IndexDb::open(&index_db_path(&dir)).expect("db");
1200        let helper_file = db
1201            .upsert_file("helpers.py", 100, "helpers", 24, Some("py"))
1202            .expect("helpers file");
1203        db.insert_symbols(
1204            helper_file,
1205            &[NewSymbol {
1206                name: "helper",
1207                kind: "function",
1208                line: 1,
1209                column_num: 0,
1210                start_byte: 0,
1211                end_byte: 24,
1212                signature: "def helper():",
1213                name_path: "helper",
1214                parent_id: None,
1215            }],
1216        )
1217        .expect("helper symbol");
1218
1219        let project = ProjectRoot::new(&dir).expect("project");
1220        let callees = get_callees(&project, "main", Some("main.py"), 50, None).expect("callees");
1221        let helper = callees
1222            .iter()
1223            .find(|callee| callee.name == "helper")
1224            .expect("helper callee");
1225
1226        assert_eq!(helper.resolved_file.as_deref(), Some("helpers.py"));
1227    }
1228
1229    #[test]
1230    fn ts_cross_file_unique_resolution_is_fallback_without_import_evidence() {
1231        let dir = temp_dir("ts-cross-file-unique");
1232        fs::write(
1233            dir.join("page.tsx"),
1234            "export function Page() { handleSubmit(); }\n",
1235        )
1236        .expect("write page");
1237        fs::create_dir_all(dir.join("components")).expect("components");
1238        fs::write(
1239            dir.join("components").join("CommentSection.tsx"),
1240            "export function handleSubmit() {}\n",
1241        )
1242        .expect("write component");
1243        let db = IndexDb::open(&index_db_path(&dir)).expect("db");
1244        let file_id = db
1245            .upsert_file(
1246                "components/CommentSection.tsx",
1247                100,
1248                "component",
1249                34,
1250                Some("tsx"),
1251            )
1252            .expect("component file");
1253        db.insert_symbols(
1254            file_id,
1255            &[NewSymbol {
1256                name: "handleSubmit",
1257                kind: "function",
1258                line: 1,
1259                column_num: 0,
1260                start_byte: 0,
1261                end_byte: 34,
1262                signature: "export function handleSubmit() {}",
1263                name_path: "handleSubmit",
1264                parent_id: None,
1265            }],
1266        )
1267        .expect("component symbol");
1268
1269        let project = ProjectRoot::new(&dir).expect("project");
1270        let mut edges = vec![CallEdge {
1271            caller_file: "page.tsx".to_owned(),
1272            caller_name: "Page".to_owned(),
1273            callee_name: "handleSubmit".to_owned(),
1274            line: 1,
1275            resolved_file: None,
1276            confidence: 0.0,
1277            resolution_strategy: None,
1278            canonical_callee_name: None,
1279        }];
1280
1281        resolve_call_edges(&mut edges, &project, None, None);
1282
1283        assert_eq!(
1284            edges[0].resolved_file.as_deref(),
1285            Some("components/CommentSection.tsx")
1286        );
1287        assert_eq!(edges[0].resolution_strategy, Some("path_proximity"));
1288        assert!(edges[0].confidence <= 0.60);
1289    }
1290
1291    #[test]
1292    fn get_callees_scoped_to_file() {
1293        let dir = temp_dir("callees-file");
1294        fs::write(dir.join("a.py"), "def process():\n    helper()\n").expect("write a");
1295        fs::write(dir.join("b.py"), "def process():\n    other()\n").expect("write b");
1296
1297        let project = ProjectRoot::new(&dir).expect("project");
1298        let callees = get_callees(&project, "process", Some("a.py"), 50, None).expect("callees");
1299        let names: Vec<&str> = callees.iter().map(|c| c.name.as_str()).collect();
1300        assert!(names.contains(&"helper"), "expected helper, got {names:?}");
1301        assert!(!names.contains(&"other"), "should not have other from b.py");
1302    }
1303
1304    #[test]
1305    fn get_callers_scoped_to_file() {
1306        let dir = temp_dir("callers-file");
1307        fs::write(dir.join("a.py"), "def foo():\n    bar()\n").expect("write a");
1308        fs::write(dir.join("b.py"), "def qux():\n    bar()\n").expect("write b");
1309        fs::write(dir.join("c.py"), "def bar():\n    pass\n").expect("write c");
1310
1311        let project = ProjectRoot::new(&dir).expect("project");
1312        let callers = get_callers(&project, "bar", Some("a.py"), 50, None).expect("callers");
1313        let names: Vec<&str> = callers.iter().map(|c| c.function.as_str()).collect();
1314        assert_eq!(names, vec!["foo"]);
1315    }
1316
1317    #[test]
1318    fn ts_cross_file_resolution_prefers_import_evidence() {
1319        let dir = temp_dir("ts-import-map");
1320        fs::write(
1321            dir.join("page.tsx"),
1322            "import { handleSubmit } from \"./actions\";\nexport function Page() { handleSubmit(); }\n",
1323        )
1324        .expect("write page");
1325        fs::write(
1326            dir.join("actions.ts"),
1327            "export function handleSubmit() {}\n",
1328        )
1329        .expect("write actions");
1330        let db = IndexDb::open(&index_db_path(&dir)).expect("db");
1331        let file_id = db
1332            .upsert_file("actions.ts", 100, "actions", 34, Some("ts"))
1333            .expect("actions file");
1334        db.insert_symbols(
1335            file_id,
1336            &[NewSymbol {
1337                name: "handleSubmit",
1338                kind: "function",
1339                line: 1,
1340                column_num: 0,
1341                start_byte: 0,
1342                end_byte: 34,
1343                signature: "export function handleSubmit() {}",
1344                name_path: "handleSubmit",
1345                parent_id: None,
1346            }],
1347        )
1348        .expect("action symbol");
1349
1350        let project = ProjectRoot::new(&dir).expect("project");
1351        let cache = GraphCache::new(0);
1352        let callees =
1353            get_callees(&project, "Page", Some("page.tsx"), 50, Some(&cache)).expect("callees");
1354        let submit = callees
1355            .iter()
1356            .find(|callee| callee.name == "handleSubmit")
1357            .expect("handleSubmit callee");
1358        assert_eq!(submit.resolved_file.as_deref(), Some("actions.ts"));
1359        assert!(
1360            matches!(submit.resolution, Some("import_map" | "import_suffix")),
1361            "expected import evidence resolution, got {:?}",
1362            submit.resolution
1363        );
1364    }
1365
1366    #[test]
1367    fn same_file_beats_import_match() {
1368        let dir = temp_dir("same-file-over-import");
1369        fs::write(
1370            dir.join("page.ts"),
1371            "import { helper } from \"./helpers\";\nfunction helper() {}\nexport function main() { helper(); }\n",
1372        )
1373        .expect("write page");
1374        fs::write(dir.join("helpers.ts"), "export function helper() {}\n").expect("write helpers");
1375        let db = IndexDb::open(&index_db_path(&dir)).expect("db");
1376        let page_file = db
1377            .upsert_file("page.ts", 100, "page", 92, Some("ts"))
1378            .expect("page file");
1379        let helpers_file = db
1380            .upsert_file("helpers.ts", 100, "helpers", 28, Some("ts"))
1381            .expect("helpers file");
1382        db.insert_symbols(
1383            page_file,
1384            &[NewSymbol {
1385                name: "helper",
1386                kind: "function",
1387                line: 2,
1388                column_num: 0,
1389                start_byte: 37,
1390                end_byte: 57,
1391                signature: "function helper() {}",
1392                name_path: "helper",
1393                parent_id: None,
1394            }],
1395        )
1396        .expect("page helper symbol");
1397        db.insert_symbols(
1398            helpers_file,
1399            &[NewSymbol {
1400                name: "helper",
1401                kind: "function",
1402                line: 1,
1403                column_num: 0,
1404                start_byte: 0,
1405                end_byte: 28,
1406                signature: "export function helper() {}",
1407                name_path: "helper",
1408                parent_id: None,
1409            }],
1410        )
1411        .expect("imported helper symbol");
1412
1413        let project = ProjectRoot::new(&dir).expect("project");
1414        let cache = GraphCache::new(0);
1415        let callees =
1416            get_callees(&project, "main", Some("page.ts"), 50, Some(&cache)).expect("callees");
1417        let helper = callees
1418            .iter()
1419            .find(|callee| callee.name == "helper")
1420            .expect("helper callee");
1421        assert_eq!(helper.resolved_file.as_deref(), Some("page.ts"));
1422        assert_eq!(helper.resolution, Some("same_file"));
1423    }
1424
1425    #[test]
1426    fn ts_import_alias_resolves_and_callers_match_canonical_name() {
1427        let dir = temp_dir("ts-import-alias");
1428        fs::write(
1429            dir.join("page.tsx"),
1430            "import { handleSubmit as onSubmit } from \"./actions\";\nexport function Page() { onSubmit(); }\n",
1431        )
1432        .expect("write page");
1433        fs::write(
1434            dir.join("actions.ts"),
1435            "export function handleSubmit() {}\n",
1436        )
1437        .expect("write actions");
1438        let db = IndexDb::open(&index_db_path(&dir)).expect("db");
1439        let file_id = db
1440            .upsert_file("actions.ts", 100, "actions", 34, Some("ts"))
1441            .expect("actions file");
1442        db.insert_symbols(
1443            file_id,
1444            &[NewSymbol {
1445                name: "handleSubmit",
1446                kind: "function",
1447                line: 1,
1448                column_num: 0,
1449                start_byte: 0,
1450                end_byte: 34,
1451                signature: "export function handleSubmit() {}",
1452                name_path: "handleSubmit",
1453                parent_id: None,
1454            }],
1455        )
1456        .expect("action symbol");
1457
1458        let project = ProjectRoot::new(&dir).expect("project");
1459        let cache = GraphCache::new(0);
1460        let callees =
1461            get_callees(&project, "Page", Some("page.tsx"), 50, Some(&cache)).expect("callees");
1462        let submit = callees
1463            .iter()
1464            .find(|callee| callee.name == "onSubmit")
1465            .expect("aliased callee");
1466        assert_eq!(submit.resolved_file.as_deref(), Some("actions.ts"));
1467        assert_eq!(submit.resolution, Some("import_map"));
1468
1469        let callers =
1470            get_callers(&project, "handleSubmit", None, 50, Some(&cache)).expect("callers");
1471        let page = callers
1472            .iter()
1473            .find(|caller| caller.function == "Page")
1474            .expect("Page caller");
1475        assert_eq!(page.file, "page.tsx");
1476    }
1477
1478    #[test]
1479    fn ts_external_import_calls_are_filtered_from_project_graph() {
1480        let dir = temp_dir("ts-external-import-filter");
1481        fs::write(
1482            dir.join("page.tsx"),
1483            "import { useState } from \"react\";\nimport { handleSubmit } from \"./actions\";\nexport function Page() { useState(); handleSubmit(); }\n",
1484        )
1485        .expect("write page");
1486        fs::write(
1487            dir.join("actions.ts"),
1488            "export function handleSubmit() {}\n",
1489        )
1490        .expect("write actions");
1491        let db = IndexDb::open(&index_db_path(&dir)).expect("db");
1492        let file_id = db
1493            .upsert_file("actions.ts", 100, "actions", 34, Some("ts"))
1494            .expect("actions file");
1495        db.insert_symbols(
1496            file_id,
1497            &[NewSymbol {
1498                name: "handleSubmit",
1499                kind: "function",
1500                line: 1,
1501                column_num: 0,
1502                start_byte: 0,
1503                end_byte: 34,
1504                signature: "export function handleSubmit() {}",
1505                name_path: "handleSubmit",
1506                parent_id: None,
1507            }],
1508        )
1509        .expect("action symbol");
1510
1511        let project = ProjectRoot::new(&dir).expect("project");
1512        let cache = GraphCache::new(0);
1513        let callees =
1514            get_callees(&project, "Page", Some("page.tsx"), 50, Some(&cache)).expect("callees");
1515        assert!(
1516            callees.iter().any(|callee| callee.name == "handleSubmit"),
1517            "expected internal imported callee in {callees:?}"
1518        );
1519        assert!(
1520            !callees.iter().any(|callee| callee.name == "useState"),
1521            "external imported binding should not appear in project call graph: {callees:?}"
1522        );
1523    }
1524
1525    #[test]
1526    fn get_callers_finds_rust_new_constructor() {
1527        let dir = temp_dir("rs-callers-new");
1528        fs::write(
1529            dir.join("lib.rs"),
1530            r#"pub struct Foo;
1531impl Foo {
1532    pub fn new() -> Self { Self }
1533}
1534
1535pub fn make_foo() -> Foo {
1536    Foo::new()
1537}
1538
1539pub fn make_another() -> Foo {
1540    Self::new()
1541}
1542"#,
1543        )
1544        .expect("write lib.rs");
1545
1546        let project = ProjectRoot::new(&dir).expect("project");
1547        let callers = get_callers(&project, "new", None, 50, None).expect("callers");
1548        let names: Vec<&str> = callers.iter().map(|c| c.function.as_str()).collect();
1549        assert!(
1550            names.contains(&"make_foo"),
1551            "expected make_foo as caller of new, got {names:?}"
1552        );
1553        assert!(
1554            names.contains(&"make_another"),
1555            "expected make_another as caller of new, got {names:?}"
1556        );
1557    }
1558}