codegraph

type Container struct {
	Label string `json:"label"`
	Kind  string `json:"kind"`
	Entry bool   `json:"entry,omitempty"`
	// Domain 是所属领域 id，必须是**叶子**领域。空串只在整图没有 domains 段时
	// 合法（旧扫描数据，消费方降级为单领域视图）。
	Domain string `json:"domain,omitempty"`
}

type Diff struct {
	View          string          `json:"view"`
	Base          string          `json:"base,omitempty"`
	Summary       string          `json:"summary,omitempty"`
	NodesAdded    map[string]Node `json:"nodesAdded,omitempty"`
	NodesModified map[string]Node `json:"nodesModified,omitempty"`
	NodesDeleted  []string        `json:"nodesDeleted,omitempty"`
	EdgesAdded    []Edge          `json:"edgesAdded,omitempty"`
	EdgesDeleted  []Edge          `json:"edgesDeleted,omitempty"`
}

type Domain struct {
	Label   string `json:"label"`
	Kind    string `json:"kind"`
	Summary string `json:"summary,omitempty"`
	Desc    string `json:"desc,omitempty"`
	Parent  string `json:"parent,omitempty"`
}

type DomainStat struct {
	ID         string   `json:"id"`
	Label      string   `json:"label"`
	Kind       string   `json:"kind"`
	Summary    string   `json:"summary,omitempty"`
	Desc       string   `json:"desc,omitempty"`
	Parent     string   `json:"parent,omitempty"`
	Children   []string `json:"children"`
	Containers []string `json:"containers"`
	Funcs      int      `json:"funcs"`
	Models     int      `json:"models"`
	Entries    int      `json:"entries"`
	Unscanned  int      `json:"unscannedEntries"`
	Interfaces []string `json:"interfaces"`
}

type Edge [2]string

type Graph struct {
	Meta Meta `json:"meta"`
	// Domains 是领域段，可为空——空即「该图未划分领域」，消费方降级为单领域视图。
	// **不得按包名伪造领域**：伪造出来的层级会被人和 agent 当成真实架构读。
	Domains    map[string]Domain    `json:"domains,omitempty"`
	Containers map[string]Container `json:"containers"`
	Nodes      map[string]Node      `json:"nodes"`
	Edges      []Edge               `json:"edges"`
}

type Meta struct {
	Project   string `json:"project"`
	Branch    string `json:"branch"`
	Commit    string `json:"commit"`
	ScannedAt string `json:"scannedAt"`
	Generator string `json:"generator"`
}

type Node struct {
	Kind         string     `json:"kind"`
	Container    string     `json:"container"`
	Order        int        `json:"order,omitempty"`
	Name         string     `json:"name"`
	File         string     `json:"file"`
	Line         int        `json:"line"`
	Signature    string     `json:"signature,omitempty"`
	SignatureOld string     `json:"signatureOld,omitempty"` // 仅出现在 diff 的 nodesModified 里
	Params       [][]string `json:"params,omitempty"`       // [名, 类型, 说明]
	Returns      string     `json:"returns,omitempty"`
	Summary      string     `json:"summary,omitempty"`
	Tests        []TestRef  `json:"tests,omitempty"`
	Fields       [][]string `json:"fields,omitempty"` // model 专用: [名, 类型, 说明]
	Unscanned    bool       `json:"unscanned,omitempty"`
}

type Result struct {
	View             string       `json:"view"`
	Foci             []string     `json:"foci"`
	Nodes            []ResultNode `json:"nodes"`
	Edges            []ViewEdge   `json:"edges"`
	UnscannedEntries int          `json:"unscannedEntries"`
	Warning          string       `json:"warning,omitempty"`
}

type ResultNode struct {
	ID   string `json:"id"`
	Dist int    `json:"dist"`
	ViewNode
}

type StaleNode struct {
	ID     string `json:"id"`
	File   string `json:"file"`
	Line   int    `json:"line"`
	Reason string `json:"reason"`
}

type TestRef struct {
	Name    string `json:"name"`
	File    string `json:"file"`
	Snippet string `json:"snippet,omitempty"`
}

type View struct {
	Name string `json:"view"`
	// Domains 原样来自基线：diff 只改节点与边，不改领域划分。
	Domains    map[string]Domain    `json:"domains,omitempty"`
	Containers map[string]Container `json:"containers"`
	Nodes      map[string]ViewNode  `json:"nodes"`
	Edges      []ViewEdge           `json:"edges"`
}

type ViewEdge struct {
	From   string `json:"from"`
	To     string `json:"to"`
	Status string `json:"status,omitempty"`
}

type ViewNode struct {
	Node
	Status string `json:"status,omitempty"` // "" | added | modified | deleted
}