codebase-recall 0.7.5

CLI based application for codebase dumper for LLMs and fast review/recall project
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

//! In-memory relation graph built from the cache, plus renderers.

pub mod community;
pub mod query;
pub mod render;
pub mod resolve;

use serde::Serialize;

/// A resolved code relation graph ready to render.
#[derive(Debug, Serialize)]
pub struct CodeGraph {
    pub version: u32,
    pub root: String,
    pub generated_at: u64,
    pub nodes: Vec<Node>,
    pub edges: Vec<Edge>,
    /// Subsystems detected over file-level import/call links; nodes refer to them by `community`.
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub communities: Vec<CommunityInfo>,
}

/// A detected subsystem, as shipped with the graph.
#[derive(Debug, Clone, Serialize)]
pub struct CommunityInfo {
    pub id: u32,
    pub label: String,
    /// Number of files in the community.
    pub size: usize,
}

#[derive(Debug, Clone, Serialize)]
pub struct Node {
    pub id: String,
    /// dir | file | function | method | struct | enum | trait | type | variable | module | impl | macro | external
    pub kind: String,
    pub label: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub path: Option<String>,
    /// Parent directory of `path` (project-relative), or `None` at the repo root.
    /// Lets the viewer group and roll a large graph up to a folder-level view.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub dir: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub language: Option<String>,
    pub exported: bool,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub lines: Option<[i64; 2]>,
    /// Count of incident relation edges (imports/calls/references, not `contains`).
    /// Used client-side to size hubs and to pick which symbols to drop first.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub degree: Option<u32>,
    /// Id into `CodeGraph::communities`; symbols inherit their file's community.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub community: Option<u32>,
}

#[derive(Debug, Clone, Serialize)]
pub struct Edge {
    pub source: String,
    pub target: String,
    /// imports | calls | references | contains
    pub kind: String,
    pub confidence: f32,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub external: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub line: Option<i64>,
}

/// Stable node id for a file.
pub fn file_id(rel_path: &str) -> String {
    format!("file:{rel_path}")
}

/// Stable node id for a directory roll-up node.
pub fn dir_id(rel_dir: &str) -> String {
    format!("dir:{rel_dir}")
}

/// Stable node id for a symbol.
pub fn symbol_id(rel_path: &str, name: &str, start_line: i64) -> String {
    format!("sym:{rel_path}#{name}@{start_line}")
}

/// Stable node id for an unresolved external module.
pub fn external_id(specifier: &str) -> String {
    format!("ext:{specifier}")
}