Documentation
Knowledge Graph Features
Overview
The Knowledge Graph in StratoSort Stack provides an interactive visualization of your document organization. It moves beyond simple file lists to show you how your documents are connected semantically.
Core Features
Interactive Visualization
- React Flow Integration: Smooth, zoomable canvas interface.
- Auto-Layout: Uses ELK algorithms to organize nodes intelligently.
- Context Menus: Right-click on any node for quick actions (Open, Reveal in Explorer, Organize).
Semantic Clustering
The graph doesn't just show files; it shows meaning.
- Similarity Edges: Lines connect files that are semantically similar, with thickness indicating strength of relationship.
- Clusters: Files are automatically grouped into color-coded clusters based on topic.
- Query Nodes: When you search, your query appears as a central node, showing exactly which files match your intent.
Exploration Tools
- Focus Mode: Double-click any node to center the graph on it and reveal its specific connections.
- Expansion: Dynamically load more connections as you explore "hops" away from your starting point.
- Filtering: Use the legend to toggle visibility of clusters, file types, or confidence levels.
Technical Implementation
Frontend (Renderer)
src/renderer/components/search/UnifiedSearchModal.jsx: The Knowledge OS modal and its tabs (Search, Chat, Timeline, Relate, Atlas).src/renderer/components/search/GraphTabContent.jsx+search/hooks/useGraphTab.js: The Relate tab — the React Flow canvas, layout, expansion and graph interactions.src/renderer/hooks/useGraphState.js: Node/edge state used byuseGraphTab.
Backend (Main Process)
ClusteringService: Builds clusters and similarity edges (exposed via theembeddings:*IPC insemantic.js).RelationshipIndexService+EdgeAggregator: Knowledge-graph edges (knowledge IPC).OramaVectorService: Provides the raw vector data and similarity scores.SearchService: Backs query-node search within the graph. (Optional result reranking is handled byReRankerService, off by default — it is not part of graph edge construction.)
Usage Guide
- Search: Start by typing a query in the search bar (Ctrl+K / Cmd+K).
- Visual Results: Switch to the Relate tab or use "View in Graph" to see your results visualized.
- Explore:
- Click a node to select it.
- Double-click to focus and expand.
- Drag nodes to rearrange your view.
- Action: Right-click to open files or apply organization suggestions.
Other Knowledge OS views
Atlas (map) and Timeline (files by date) live in the same Knowledge OS surface as this graph. They read the same analysis: Atlas places similar files nearby; Timeline sorts by content date. See USER_GUIDE.md.