Documentation menu
Features

Knowledge Graph & Topic Evolution

Explore a bounded, accessible map of explicit and derived relationships across bookmarks, notes, annotations, objects, entities, and concepts.

Graph helps you inspect how owned knowledge connects. It opens a bounded recent view or a focused neighborhood instead of attempting to draw your entire collection at once.

Nodes and Relationships

Graph can project bookmarks, notes, daily notes, annotations, knowledge objects, entities, and concepts. Relationships include:

  • explicit links you created
  • source relationships
  • shared concepts
  • shared entities
  • semantic similarity when embeddings exist

Explicit links are canonical. Derived relationships are quieter, rebuildable, and include provenance and confidence where relevant. A missing model provider or embedding does not remove explicit, source, concept, or entity relationships.

Only supported, current derived material is eligible for Graph. Incomplete captures can remain in Library for later repair, while stale or unsupported generated concepts, entities, and relationships stay out of knowledge surfaces. Repair keeps your notes, annotations, and explicit links intact.

Focus the Graph

Choose a focus node to request its local neighborhood. The browser requests a deliberately bounded node and edge set, and the API enforces its own limits. Open a visual node to visit its saved knowledge destination.

The canvas provides Zoom out, Reset view, and Zoom in controls and remains pannable on constrained screens. Normal browser and pinch zoom also remain available.

Equivalent Accessible View

The always-visible Accessible node list contains the same nodes and saved-item destinations as the visual graph. Keyboard and screen-reader users can follow those links without relying on SVG position, color, or pointer precision. Focus selection still controls which local neighborhood Graph displays.

Topic Evolution

The existing topic-evolution entry point remains compatible and opens the related Insights context. Use it to revisit how a topic appears across saved material while keeping the original evidence available.

API Routes

Method Endpoint Purpose
GET /api/knowledge-graph/v2 Bounded typed graph with optional focus and depth
GET /api/insights Evidence-backed learning patterns

Older graph exploration and search routes remain available for compatibility. New integrations should use the v2 graph response with stable IDs, types, provenance, and confidence.