analysis

type Community struct {
	ID       string         `json:"id"`
	Name     string         `json:"name"`     // Label derived from dominant node hub
	Cohesion float64        `json:"cohesion"` // Edge density: 2 * E_in / (V * (V - 1))
	NodeIDs  []graph.NodeID `json:"node_ids"`
}

type Coverage struct {
	ImportEdgesTotal    int      `json:"import_edges_total"`
	ImportEdgesResolved int      `json:"import_edges_resolved"`
	CallEdgesTotal      int      `json:"call_edges_total"`
	CallEdgesResolved   int      `json:"call_edges_resolved"`
	Notes               []string `json:"notes,omitempty"`
}

type Cycle struct {
	Type   string         `json:"type"` // e.g. "import_cycle", "call_cycle"
	Length int            `json:"length"`
	Path   []graph.NodeID `json:"path"`
}

type DependencyView struct {
	Nodes    []graph.Node
	Edges    []graph.Edge // only resolved deps between files/modules (and resolved calls between defs)
	Coverage Coverage
}

type IndirectTrace struct {
	From string         `json:"from"`
	To   string         `json:"to"`
	Hops int            `json:"hops"`
	Path []graph.NodeID `json:"path"`
}

type KnowledgeGaps struct {
	IsolatedNodes   []graph.NodeID `json:"isolated_nodes"`
	ThinCommunities []string       `json:"thin_communities"`
}

type NodeCentrality struct {
	ID          graph.NodeID `json:"id"`
	Kind        string       `json:"kind"`
	Name        string       `json:"name"`
	Path        string       `json:"path"`
	PageRank    float64      `json:"pagerank"`
	Betweenness float64      `json:"betweenness"`
}

type Question struct {
	Text      string `json:"text"`
	Rationale string `json:"rationale"`
}