repopilot 0.17.0

Local-first CLI for reviewing Git changes, security boundaries, and blast radius before merge.
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

use super::GraphNodeId;

#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub enum GraphEdgeKind {
    Imports,
    ReExports,
    DependsOn,
    TestOf,
    GeneratedFrom,
    Configures,
}

impl GraphEdgeKind {
    /// Whether this edge represents a build/runtime dependency, as opposed to a
    /// structural or auxiliary relationship (e.g. `TestOf`, `Configures`).
    /// Dependency algorithms (coupling, layering, blast radius) should consider
    /// only these kinds.
    pub fn is_dependency(self) -> bool {
        matches!(self, Self::Imports | Self::ReExports | Self::DependsOn)
    }
}

/// Where an edge's evidence came from. Lets consumers weigh how an edge was
/// derived without re-deriving it.
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub enum GraphEdgeProvenance {
    /// Derived from an extracted import or module declaration.
    Import,
    /// Inferred from a test-file naming convention.
    TestHeuristic,
}

/// How strongly graph v2 trusts that an edge reflects a real relationship.
#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub enum GraphEdgeConfidence {
    /// The relationship was resolved to a concrete scanned file.
    High,
    /// A well-formed external dependency we cannot resolve to a scanned file.
    Medium,
    /// An import that looked local but did not resolve to any scanned file.
    Low,
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct GraphEdge {
    pub from: GraphNodeId,
    pub to: GraphNodeId,
    pub kind: GraphEdgeKind,
    pub provenance: GraphEdgeProvenance,
    pub confidence: GraphEdgeConfidence,
}