codegraph

type Assignment struct {
	Path   string `json:"path"`
	Domain string `json:"domain"`
}

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 Contract struct {
	From         string   `json:"from"`
	To           string   `json:"to"`
	Entries      []string `json:"entries,omitempty"`
	Interfaces   []string `json:"interfaces,omitempty"`
	LegacyBudget int      `json:"legacyBudget,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"`
	ImplementsAdded   []Edge          `json:"implementsAdded,omitempty"`
	ImplementsDeleted []Edge          `json:"implementsDeleted,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 Finding struct {
	Kind   string `json:"kind"`
	From   string `json:"from,omitempty"`
	To     string `json:"to,omitempty"`
	Edge   *Edge  `json:"edge,omitempty"`
	Detail string `json:"detail"`
}

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"`
	// Implements 是接口满足边 [实现, 接口]。与 Edges 分列是 wire 兼容决策
	//（Edge 是二元组塞不进 kind 字段，spec §3）；语义上它们是 kind=implements 的边。
	Implements []Edge `json:"implements,omitempty"`
}

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 Report struct {
	Fails      []Finding      `json:"fails"`
	Warns      []Finding      `json:"warns"`
	LegacyHits map[string]int `json:"legacyHits,omitempty"` // "from->to" → 命中数
}

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 Target struct {
	Meta        TargetMeta     `json:"meta"`
	Domains     []TargetDomain `json:"domains"`
	Assignments []Assignment   `json:"assignments,omitempty"`
	Assembly    []string       `json:"assembly,omitempty"`
	Contracts   []Contract     `json:"contracts,omitempty"`
}

type TargetDomain struct {
	ID    string   `json:"id"`
	Name  string   `json:"name"`
	Type  string   `json:"type"`
	Paths []string `json:"paths"`
	Note  string   `json:"note,omitempty"`
}

type TargetMeta struct {
	Version int    `json:"version"`
	Project string `json:"project"`
}

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"`
	Implements []ViewEdge           `json:"implements"`
}

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
}