codescout 0.15.0

High-performance coding agent toolkit MCP server
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

//! Data types for the embedding index.

use serde::{Deserialize, Serialize};

/// A chunk of source code stored in the embedding index.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CodeChunk {
    /// Unique row ID (auto-assigned by SQLite)
    pub id: Option<i64>,
    /// File path relative to project root
    pub file_path: String,
    /// Programming language (e.g. "rust", "python")
    pub language: String,
    /// Source text of this chunk
    pub content: String,
    /// 1-indexed start line
    pub start_line: usize,
    /// 1-indexed end line (inclusive)
    pub end_line: usize,
    /// SHA-256 hash of the file content at index time (for incremental updates)
    pub file_hash: String,
    /// Source identifier: "project" for project files, "lib:<name>" for libraries
    pub source: String,
    /// Project identifier within a workspace (e.g. "my-service", "root")
    pub project_id: String,
    /// Searchable header prepended before embedding. NULL for non-AST chunks
    /// (markdown, plain text). NOT returned in semantic_search results.
    pub metadata: Option<String>,
}

/// A ranked result from a semantic search query.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SearchResult {
    /// Row id of the chunk in the `chunks` table.
    pub id: u64,
    pub file_path: String,
    pub language: String,
    pub content: String,
    pub start_line: usize,
    pub end_line: usize,
    /// Cosine similarity score in [0, 1]; higher is more relevant.
    pub score: f32,
    /// Source identifier: "project" or "lib:<name>"
    pub source: String,
    /// Project identifier this chunk belongs to (e.g. "mcp-server"). Empty string if unset.
    pub project_id: String,
}