repotoire 0.5.1

Graph-powered code analysis CLI. 106 detectors for security, architecture, and code quality.
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

//! Data contract for rich report generation.
//!
//! `ReportContext` bundles the health report with optional graph, git, and
//! source data. Each sub-struct is independently optional — reporters degrade
//! gracefully when data is unavailable.

use crate::models::HealthReport;
use crate::calibrate::StyleProfile;

/// Full context for report rendering. Text and HTML reporters use graph/git
/// data for themed output and visualizations. JSON/SARIF/Markdown reporters
/// only need `health`.
pub struct ReportContext {
    pub health: HealthReport,
    pub graph_data: Option<GraphData>,
    pub git_data: Option<GitData>,
    pub source_snippets: Vec<FindingSnippet>,
    pub previous_health: Option<HealthReport>,
    pub style_profile: Option<StyleProfile>,
}

/// Data derived from the frozen CodeGraph and GraphPrimitives.
/// All NodeIndex values are pre-resolved to qualified name strings.
pub struct GraphData {
    pub modules: Vec<ModuleNode>,
    pub module_edges: Vec<ModuleEdge>,
    pub communities: Vec<Community>,
    pub modularity: f64,
    pub top_pagerank: Vec<(String, f64)>,
    pub top_betweenness: Vec<(String, f64)>,
    pub articulation_points: Vec<String>,
    pub call_cycles: Vec<Vec<String>>,
}

/// Data derived from git blame and CoChangeMatrix.
/// None if the repo has no git history.
pub struct GitData {
    pub hidden_coupling: Vec<(String, String, f32)>,
    pub top_co_change: Vec<(String, String, f32)>,
    pub file_ownership: Vec<FileOwnership>,
    pub bus_factor_files: Vec<(String, usize)>,
}

#[derive(Clone)]
pub struct ModuleNode {
    pub path: String,
    pub loc: usize,
    pub file_count: usize,
    pub finding_count: usize,
    pub finding_density: f64,
    pub avg_complexity: f64,
    pub community_id: Option<usize>,
    pub health_score: f64,
}

#[derive(Clone)]
pub struct ModuleEdge {
    pub from: String,
    pub to: String,
    pub weight: usize,
    pub is_cycle: bool,
}

pub struct Community {
    pub id: usize,
    pub modules: Vec<String>,
    pub label: String,
}

pub struct FileOwnership {
    pub path: String,
    pub authors: Vec<(String, f64)>,
    pub bus_factor: usize,
}

/// Source code snippet for a finding, read from disk.
pub struct FindingSnippet {
    pub finding_id: String,
    pub code: String,
    pub highlight_lines: Vec<u32>,
    pub language: String,
}