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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

use super::topology;
use crate::graph::v2::{GraphNodeId, GraphSnapshot};
use std::collections::{BTreeMap, BTreeSet, VecDeque};

/// The transitive dependents of a set of changed nodes: every node that can
/// reach a seed by following dependency edges (i.e. the importers, directly or
/// transitively). This is the blast radius of a change to the seeds.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct GraphBlastRadius {
    /// Provided seeds that exist in the snapshot, sorted and deduplicated.
    pub seeds: Vec<GraphNodeId>,
    /// Transitive dependents of the seeds, sorted, excluding the seeds.
    pub impacted: Vec<GraphNodeId>,
}

/// Walks dependency edges in reverse (`incoming`) from every seed, so the result
/// is "what is affected if these nodes change". Seeds missing from the snapshot
/// are ignored; cycles terminate because nodes are visited at most once.
pub fn blast_radius(snapshot: &GraphSnapshot, seeds: &[GraphNodeId]) -> GraphBlastRadius {
    let topology = topology(snapshot);
    let present_seeds = seeds
        .iter()
        .filter(|seed| topology.node_set.contains(seed))
        .cloned()
        .collect::<BTreeSet<_>>();

    let mut visited = present_seeds.clone();
    let mut queue = present_seeds.iter().cloned().collect::<VecDeque<_>>();

    while let Some(node) = queue.pop_front() {
        for dependent in &topology.incoming[&node] {
            if visited.insert(dependent.clone()) {
                queue.push_back(dependent.clone());
            }
        }
    }

    let impacted = visited
        .into_iter()
        .filter(|node| !present_seeds.contains(node))
        .collect::<Vec<_>>();

    GraphBlastRadius {
        seeds: present_seeds.into_iter().collect(),
        impacted,
    }
}

/// Direct (one-hop) dependents of every node: each node mapped to the nodes that
/// depend on it through an incoming dependency edge — its importer set. This is
/// the non-transitive counterpart to [`blast_radius`], used where a consumer
/// needs "who imports this file directly" rather than the full reachable set.
/// Every node is present; nodes with no dependents map to an empty set.
pub fn direct_dependents(snapshot: &GraphSnapshot) -> BTreeMap<GraphNodeId, BTreeSet<GraphNodeId>> {
    let topology = topology(snapshot);
    let mut dependents = topology
        .node_ids
        .iter()
        .cloned()
        .map(|id| (id, BTreeSet::new()))
        .collect::<BTreeMap<GraphNodeId, BTreeSet<GraphNodeId>>>();

    for edge in &topology.edges {
        if edge.kind.is_dependency() {
            dependents
                .get_mut(&edge.to)
                .expect("validated target node")
                .insert(edge.from.clone());
        }
    }

    dependents
}