1use serde::{Deserialize, Serialize};
2use ucm_core::BlockId;
3
4#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Serialize, Deserialize, Default)]
5#[serde(rename_all = "snake_case")]
6pub enum GraphDetailLevel {
7 Stub,
8 #[default]
9 Summary,
10 Full,
11}
12
13#[derive(Debug, Clone, Serialize, Deserialize)]
14pub struct GraphNodeSummary {
15 pub block_id: BlockId,
16 pub label: String,
17 pub content_type: String,
18 #[serde(default, skip_serializing_if = "Option::is_none")]
19 pub semantic_role: Option<String>,
20 #[serde(default)]
21 pub tags: Vec<String>,
22 #[serde(default, skip_serializing_if = "Option::is_none")]
23 pub parent: Option<BlockId>,
24 pub children: usize,
25 pub outgoing_edges: usize,
26 pub incoming_edges: usize,
27}
28
29#[derive(Debug, Clone, Serialize, Deserialize)]
30pub struct GraphEdgeSummary {
31 pub source: BlockId,
32 pub target: BlockId,
33 pub relation: String,
34 pub direction: String,
35}
36
37#[derive(Debug, Clone, Serialize, Deserialize)]
38pub struct GraphPathHop {
39 pub from: BlockId,
40 pub to: BlockId,
41 pub relation: String,
42 pub direction: String,
43}
44
45#[derive(Debug, Clone, Serialize, Deserialize)]
46pub struct GraphPathResult {
47 pub start: GraphNodeSummary,
48 pub end: GraphNodeSummary,
49 #[serde(default)]
50 pub hops: Vec<GraphPathHop>,
51}