Files
git.stella-ops.org/docs/features/unchecked/scanner/reachability-mini-map-visualization-api.md

1.4 KiB

Reachability Mini-Map Visualization API

Module

Scanner

Status

IMPLEMENTED

Description

Extracts a compact mini-map from full reachability graphs, providing a simplified topological view (MiniMapNode, MiniMapPath models) for quick visual orientation. Distinct from existing "Reachability Subgraph Extraction" which is about proof-of-exposure, not UI visualization.

Implementation Details

  • Mini-Map Extractor:
    • src/Scanner/__Libraries/StellaOps.Scanner.Reachability/MiniMap/MiniMapExtractor.cs - MiniMapExtractor extracts compact mini-map representations from full reachability graphs for quick visual orientation
    • src/Scanner/__Libraries/StellaOps.Scanner.Reachability/MiniMap/ReachabilityMiniMap.cs - ReachabilityMiniMap model containing MiniMapNode and MiniMapPath structures for simplified topological views

E2E Test Plan

  • Generate a mini-map from a reachability graph and verify it contains simplified nodes and paths
  • Verify the mini-map correctly preserves the topological structure (entrypoints, intermediate hops, vulnerable sinks)
  • Verify the mini-map node count is significantly smaller than the full reachability graph
  • Verify mini-map paths include key metadata (gate types, confidence levels) for each path segment
  • Verify the API returns the mini-map in a format suitable for UI rendering (JSON with coordinates/layout hints)