magellan 3.1.9

Deterministic codebase mapping tool for local development
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

//! Metrics data structures for CodeGraph
//!
//! Pre-computed metrics (fan-in, fan-out, LOC, complexity) enable fast debug tool queries
//! without expensive SQL aggregations on graph_entities and graph_edges.

use serde::{Deserialize, Serialize};

/// File-level metrics for fast hotspots and complexity queries
///
/// Computed during file indexing and stored in file_metrics table.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct FileMetrics {
    /// File path (PRIMARY KEY)
    pub file_path: String,

    /// Number of symbols defined in this file
    pub symbol_count: i64,

    /// Actual line count (newline count + 1)
    pub loc: i64,

    /// Estimated LOC (bytes / 40.0 heuristic)
    pub estimated_loc: f64,

    /// Incoming edges from other files (references + calls into this file)
    pub fan_in: i64,

    /// Outgoing edges to other files (references + calls from this file)
    pub fan_out: i64,

    /// Weighted complexity score: loc*0.1 + fan_in*0.5 + fan_out*0.3
    pub complexity_score: f64,

    /// Unix timestamp (seconds) when metrics were last updated
    pub last_updated: i64,
}

/// Symbol-level metrics for detailed analysis
///
/// Computed during file indexing and stored in symbol_metrics table.
/// cyclomatic_complexity is set to 1 (placeholder) until Phase 35 CFG implementation.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SymbolMetrics {
    /// Symbol ID (PRIMARY KEY, FOREIGN KEY to graph_entities)
    pub symbol_id: i64,

    /// Symbol name for display
    pub symbol_name: String,

    /// Symbol kind (Function, Struct, Enum, etc.)
    pub kind: String,

    /// File path containing this symbol
    pub file_path: String,

    /// Lines of code (end_line - start_line + 1)
    pub loc: i64,

    /// Estimated LOC (bytes / 40.0 heuristic)
    pub estimated_loc: f64,

    /// Incoming reference/call edges
    pub fan_in: i64,

    /// Outgoing call edges
    pub fan_out: i64,

    /// Cyclomatic complexity (placeholder = 1, Phase 35 will compute properly)
    pub cyclomatic_complexity: i64,

    /// Unix timestamp (seconds) when metrics were last updated
    pub last_updated: i64,
}