Bugscope Graph Visualizer

An interactive graph visualization tool for LadybugDB. Explore relationships between bugs, files, and other entities in your databases through an intuitive visual interface.

This is the native port of bugscope-tauri: no Tauri, no React, no webview. A single Rust binary with LadybugDB in-process and a native GPUI window.

Features

• Interactive Graph View - Navigate through connected data using a force-directed graph. Drag nodes to rearrange, zoom in/out, and pan around the canvas.
• Database Selection - Choose from available LadybugDB databases in the sidebar, or use Open file… to browse for any *.lbdb file.
• Visual Encoding - Node size reflects connection count (more connections = larger nodes), and colors differentiate entity types.
• Dark/Light Mode - Follows the system appearance automatically, same themes as the Tauri app.
• Relationship Labels - Hover over edges to see the type of relationship between connected nodes.
• Search + Focus - Substring search over node properties; click a match to focus its 1-hop neighborhood.
• Schema View - Toggle to see node tables instead of the edge graph.
• Live Layout - Force simulation (repulsion + springs + damping) runs at 30 Hz and settles when the layout goes quiet; pause/resume any time.
• Leiden Treemap - Header toggle switches the canvas between the graph and a squarified treemap of Leiden communities (in-process icebug Leiden, same family as GDS_LEIDEN); tile area follows PageRank weight. Double-click drills into a neighborhood.
• Insights Pane - Collapsible right pane with the top 10 nodes by PageRank plus the Leiden community summary; clicking a row focuses (PageRank) or selects (community) it.

Usage

1. Select a database from the sidebar on the left (scanned from the working directory), or click Open file… to pick a *.lbdb anywhere on disk
2. The graph will load and display nodes (entities) and edges (relationships)
3. Click and drag nodes to rearrange the layout
4. Scroll to zoom in/out (zooms at the cursor), click and drag the canvas to pan
5. Hover over nodes to see their labels
6. Hover over edges to see relationship types
7. Double-click a node (or select it and choose "Expand neighborhood") to focus its 1-hop neighborhood
8. Type in the query box and press Enter to search; click a match to focus it

Prerequisites

Just the Rust toolchain (rustup). No Node.js, no Tauri CLI, no WebKit/GTK system libraries, no vendored sigma.js fork — the UI is native GPUI, not a webview.

On macOS: Xcode command line tools (for any Rust build).

Run

cargo run --release

Working directory matters only for the initial sidebar scan: *.lbdb files under . are listed automatically. Anything else can be opened via Open file…, so you can run from anywhere.

Graph analytics (icebug / GDS)

Every connection runs LOAD algo (installing from the official repo at https://extension.ladybugdb.com on first use), so PageRank and friends work straight from the query box as Cypher table functions:

CALL PROJECT_GRAPH('G', ['N'], ['E']);
CALL GDS_PAGE_RANK('G') RETURN node.id, rank ORDER BY rank DESC;

Available: PROJECT_GRAPH, PAGE_RANK, GDS_PAGE_RANK, GDS_LOUVAIN, GDS_LEIDEN, GDS_PPR, GDS_NODE2VEC, k-core, components, spanning forest. Set BUGSCOPE_ALGO_EXTENSION to a local .lbug_extension file to override the downloaded one (e.g. a build from LadybugDB/extensions).

The treemap and insights pane run the same algorithms in-process over whatever is displayed (full scan, Cypher result, or neighborhood), with no PROJECT_GRAPH step: backend::graphr_leiden_full (Leiden + modularity) and backend::graphr_page_rank. backend::gds_leiden_communities reads CALL GDS_LEIDEN(...) rows back for an existing projection when you want the extension's own output.

From source:

bash scripts/download_icebug.sh      # prebuilt libnetworkit for your platform -> ./icebug/
bash scripts/download-liblbug.sh     # prebuilt shared liblbug (dlopen needs shared, not static) -> ./liblbug/
bash scripts/vendor_arrow.sh         # stage libarrow/libomp next to libnetworkit (the algo
                                      # extension references @rpath/libarrow, resolved via our rpaths)
cargo test --test gds_page_rank      # GDS_PAGE_RANK vs the expected ranks (skips when offline)
cargo test --test gds_leiden         # GDS_LEIDEN two-cliques structure + local Leiden cross-check

The icebug-analytics cargo feature (on by default; --no-default-features to skip) links the icebug Rust crate for in-process analytics such as backend::graphr_page_rank.

Bulk loading is tiered CSR → columnar Arrow → row-wise ids, so a silent-empty fast path can never hide the graph. Our arrow is pinned to 55 to match lbug (0.21.x builds its batches with arrow 55 — decoding them with another major silently yields zero rows); icebug 13.2.0 needs arrow 56, which lives behind the arrow56 alias for the analytics arrays only.

Project structure

Path	Contents
src/main.rs	App entry: window setup, titlebar, autofocus
src/backend.rs	Direct LadybugDB backend — open_connection, scan_for_databases, collect_edge_graph, collect_schema_graph, search_nodes, neighborhood, in-process PageRank/Leiden (graphr_page_rank, graphr_leiden_full) + GDS_LEIDEN readout (gds_leiden_communities)
src/clusters.rs	Squarified treemap layout over Leiden communities (disktree-inspired squarify + header bands + hit-testing), pure geometry with unit tests
src/model.rs	GraphModel (force layout tick, palette, picking) + Camera (world↔screen, cursor-anchored zoom, fit)
src/ui.rs	RootView — sidebar, insights pane, query box, canvas graph + treemap views, interaction
src/theme.rs	Vendored disktree theme (tokyo_night dark / flexoki_light light), selected via window.appearance() like disktree follows the system setting

The backend runs the same Cypher as the Tauri commands (MATCH (a)-[r]->(b) RETURN a, r, b, isolated-node scan, CALL SHOW_TABLES, node sampling) with direct lbug calls and no IPC boundary.

Deliberately out of scope for v1

Summary-space PageRank sidecars, LLM cluster naming, Voronoi overlay, the lever panel, Arrow IPC transport — all were web-renderer or sidecar concerns in bugscope-tauri. The native port loads the edge graph directly and lays it out live. The sunburst view is skipped for now (arc-heavy painting in GPUI needs more scaffolding than the treemap's rects).

Troubleshooting

• Window doesn't appear on launch - older versions scanned $HOME recursively on the UI thread before first paint and hung. Current versions only scan the working directory; update and retry.
• Load failed: ... in the status bar - the picked file isn't a readable LadybugDB database, or it's locked by another process.
• Search returns nothing - search scans node name/title/label/id plus all properties (first 50k nodes, 50 results); check the query box text and the selected database.