codeix 0.5.0

Fast semantic code search for AI agents — find symbols, references, and callers across any codebase
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
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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

use serde::{Deserialize, Serialize};

/// `index.json` manifest — top-level metadata for a `.codeindex/` directory.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct IndexManifest {
    pub version: String,
    pub name: String,
    pub root: String,
    pub languages: Vec<String>,
}

/// One line in `files.jsonl` — metadata for a single indexed file.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct FileEntry {
    pub path: String,
    pub lang: Option<String>,
    pub hash: String,
    pub lines: u32,
    #[serde(default, skip_serializing_if = "String::is_empty")]
    pub project: String,
    /// File title extracted from the source (e.g., first heading, module doc).
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// File description extracted from the source (e.g., docstring, frontmatter).
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub description: Option<String>,
}

/// One line in `symbols.jsonl` — a symbol extracted from the AST.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SymbolEntry {
    pub file: String,
    pub name: String,
    pub kind: String,
    pub line: [u32; 2],
    #[serde(skip_serializing_if = "Option::is_none")]
    pub parent: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub tokens: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub alias: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub visibility: Option<String>,
    #[serde(default, skip_serializing_if = "String::is_empty")]
    pub project: String,
}

/// Symbol output for MCP responses — excludes fields visible in context snippet.
#[derive(Debug, Clone, Serialize)]
pub struct SymbolOutput {
    pub file: String,
    pub name: String,
    pub line: [u32; 2],
    #[serde(skip_serializing_if = "Option::is_none")]
    pub parent: Option<String>,
    #[serde(skip_serializing_if = "String::is_empty")]
    pub project: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub context: Option<String>,
}

impl SymbolOutput {
    pub fn from_entry(entry: &SymbolEntry, context: Option<String>) -> Self {
        Self {
            file: entry.file.clone(),
            name: entry.name.clone(),
            line: entry.line,
            parent: entry.parent.clone(),
            project: entry.project.clone(),
            context,
        }
    }
}

/// One line in `texts.jsonl` — a text block (docstring, comment, etc.).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TextEntry {
    pub file: String,
    pub kind: String,
    pub line: [u32; 2],
    pub text: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub parent: Option<String>,
    #[serde(default, skip_serializing_if = "String::is_empty")]
    pub project: String,
}

/// One line in `references.jsonl` — a reference to a symbol (call, import, type, etc.).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ReferenceEntry {
    /// File containing this reference
    pub file: String,
    /// Symbol being referenced (e.g. "os.path.join", "MyClass", "fetch")
    pub name: String,
    /// Kind of reference: "call", "import", "type_annotation", "instantiation", "definition"
    pub kind: String,
    /// Line range [start, end] where this reference appears (1-based)
    pub line: [u32; 2],
    /// Optional: enclosing symbol where this reference appears (e.g. "MyClass.method")
    #[serde(skip_serializing_if = "Option::is_none")]
    pub caller: Option<String>,
    /// Project path (relative from workspace root, empty for root project)
    #[serde(default, skip_serializing_if = "String::is_empty")]
    pub project: String,
}