specs/002-add-graph-view/data-model.md

Data Model: Graph View

Entities

GraphNode

Represents a single note in the graph.

Field	Type	Description
id	str	Unique identifier (Note Path).
label	str	Display title of the note.
val	int	Weight/Size of the node (default: 1 + link_degree).
group	str	Grouping category (e.g., top-level folder).

GraphLink

Represents a directed connection between two notes.

Field	Type	Description
source	str	ID of the source note.
target	str	ID of the target note.

GraphData

The top-level payload returned by the API.

Field	Type	Description
nodes	List[GraphNode]	All notes in the vault.
links	List[GraphLink]	All resolved connections.

Database Mapping

• Nodes: Sourced from note_metadata table.
  • id <- note_path
  • label <- title
  • group <- note_path (parsed parent directory)
• Links: Sourced from note_links table.
  • source <- source_path
  • target <- target_path
  • Filter: is_resolved = 1