graph

type ClusteringEnvironment struct {
	PythonFound          bool   `json:"python_found"`
	PythonPath           string `json:"python_path,omitempty"`
	NetworkXAvailable    bool   `json:"networkx_available"`
	GraspologicAvailable bool   `json:"graspologic_available"`
	BaseInstallCommand   string `json:"base_install_command"`
	LeidenInstallCommand string `json:"leiden_install_command"`
}

type FreshnessStats struct {
	GraphPath          string
	ManifestPath       string
	ReportPath         string
	GraphUpdatedAt     time.Time
	ManifestUpdatedAt  time.Time
	ManifestPresent    bool
	ReportPresent      bool
	TrackedFiles       int
	BuildMode          string
	Status             string
	StaleFiles         []string
	RecommendedActions []string
}

type Graph struct {
	Directed      *simple.DirectedGraph
	NodeIndex     map[string]int64     // node ID string → gonum int64 ID
	NodeByID      map[int64]types.Node // gonum int64 ID → types.Node
	ResolvedEdges []types.Edge         // only edges where both endpoints resolved
	Nodes         []types.Node
}

type GraphLock struct {
	// contains filtered or unexported fields
}

type HealthMetrics struct {
	Path        string `json:"path"`
	GeneratedAt string `json:"generated_at,omitempty"`

	// Size
	Nodes int `json:"nodes"`
	Edges int `json:"edges"`

	// Coverage — breakdowns
	NodesByKind     map[string]int `json:"nodes_by_kind"`
	EdgesByRelation map[string]int `json:"edges_by_relation"`

	// Quality / resolution
	BrokenEdges    int     `json:"broken_edges"`
	SelfLoops      int     `json:"self_loops"`
	DuplicateEdges int     `json:"duplicate_edges"`
	ResolutionRate float64 `json:"resolution_rate"` // 0..1

	// Confidence
	ConfidenceDist map[string]int `json:"confidence_dist"`
	ExtractedRate  float64        `json:"extracted_rate"` // 0..1

	// Degree
	AvgDegree     float64 `json:"avg_degree"`
	MedianDegree  int     `json:"median_degree"`
	P95Degree     int     `json:"p95_degree"`
	MaxDegree     int     `json:"max_degree"`
	IsolatedNodes int     `json:"isolated_nodes"`
	HubNodes      int     `json:"hub_nodes"`  // total degree >= 10
	LeafNodes     int     `json:"leaf_nodes"` // total degree == 1
	ConnectedPct  int     `json:"connected_pct"`

	// Communities
	Communities          int     `json:"communities"`
	LargestCommunitySize int     `json:"largest_community_size"`
	SingletonCommunities int     `json:"singleton_communities"`
	Modularity           float64 `json:"modularity"`

	// Top nodes (length fixed via TopN when loading)
	TopByOutDegree []NodeRank `json:"top_by_out_degree"`
}

type MemoryReferenceBinding struct {
	State       types.VerificationState
	BoundTarget string
	Suggestions []string
	Evidence    string
}

type NodeRank struct {
	ID     string `json:"id"`
	Label  string `json:"label"`
	File   string `json:"file,omitempty"`
	Kind   string `json:"kind,omitempty"`
	OutDeg int    `json:"out_degree"`
	InDeg  int    `json:"in_degree"`
}

type ProjectStatus struct {
	Name          string `json:"name"`
	NodeID        string `json:"node_id"`
	Path          string `json:"path,omitempty"`
	Remote        string `json:"remote,omitempty"`
	Nodes         int    `json:"nodes"`
	Files         int    `json:"files"`
	Symbols       int    `json:"symbols"`
	OutgoingEdges int    `json:"outgoing_edges"`
}

type RegistryStatusSnapshot struct {
	Summary RegistrySummary      `json:"summary"`
	Repos   []RepoStatusSnapshot `json:"repos"`
}

type RegistrySummary struct {
	Repositories    int       `json:"repositories"`
	HealthyGraphs   int       `json:"healthy_graphs"`
	MissingGraphs   int       `json:"missing_graphs"`
	InstalledHooks  int       `json:"installed_hooks"`
	MissingHooks    int       `json:"missing_hooks"`
	MissingManifest int       `json:"missing_manifest"`
	MissingReport   int       `json:"missing_report"`
	Nodes           int       `json:"nodes"`
	Edges           int       `json:"edges"`
	BrokenEdges     int       `json:"broken_edges"`
	LatestGraphUTC  time.Time `json:"latest_graph_utc"`
}

type RepoOverrides struct {
	Domains      []string
	Packages     []string
	Dependencies []string // other repo names this repo depends on
}

type RepoRouteHit struct {
	Repo    string
	Score   float64
	Reasons []string
}

type RepoStatusSnapshot struct {
	RepoRoot      string         `json:"repo_root"`
	Name          string         `json:"name"`
	Remote        string         `json:"remote,omitempty"`
	GraphPath     string         `json:"graph_path,omitempty"`
	HookInstalled bool           `json:"hook_installed"`
	HookStatus    string         `json:"hook_status"`
	Snapshot      StatusSnapshot `json:"snapshot"`
	LoadError     string         `json:"load_error,omitempty"`
	TrackedAt     time.Time      `json:"tracked_at,omitempty"`
	ManifestPath  string         `json:"manifest_path,omitempty"`
	ReportPath    string         `json:"report_path,omitempty"`
}

type StatusSnapshot struct {
	GraphPath string          `json:"graph_path"`
	Metrics   HealthMetrics   `json:"metrics"`
	Freshness FreshnessStats  `json:"freshness"`
	Projects  []ProjectStatus `json:"projects"`
}

type WorkspaceGraph struct {
	Nodes []types.Node
	Edges []types.Edge
	// contains filtered or unexported fields
}