Summary
Add a lattice hotspots command that identifies high-centrality nodes, fragile claims, and structural risks in the knowledge graph.
Motivation
As a lattice grows, some nodes become central bottlenecks while others are weakly supported. Users need visibility into:
- God nodes: Requirements with many dependents — high-risk if they change
- Fragile claims: Theses supported by only one source — weak justification
- Orphan nodes: Nodes with no edges (already planned in
REQ-LINT-001)
- Coverage gaps: Requirements with no implementations
Proposed Design
lattice hotspots
# Output:
# HIGH-DEGREE NODES (most connections):
# REQ-CORE-001 12 edges (6 satisfies, 3 depends_on, 3 derives)
# THX-PROSE-PRIMARY 8 edges
#
# FRAGILE CLAIMS (single-source theses):
# THX-COMPREHENSION-DEBT-DRIVER 1 source (SRC-COMPREHENSION-DEBT)
#
# UNCOVERED REQUIREMENTS:
# REQ-API-001 no implementations
# REQ-API-002 no implementations
#
# ISOLATED NODES:
# (none)
Options:
--json for machine-readable output
--type fragile|bottleneck|uncovered|orphan to filter
Prior Art
- Node centrality analysis (degree, betweenness) is foundational graph theory, widely used in social network analysis, dependency management, and risk assessment.
- Graphify applies "god node" detection to code graphs.
Lattice Impact
- Extends
REQ-LINT-001 (Lint warns on orphan nodes)
- Extends
REQ-CLI-011 (Summary Command)
- New requirement:
REQ-CLI-029
Summary
Add a
lattice hotspotscommand that identifies high-centrality nodes, fragile claims, and structural risks in the knowledge graph.Motivation
As a lattice grows, some nodes become central bottlenecks while others are weakly supported. Users need visibility into:
REQ-LINT-001)Proposed Design
Options:
--jsonfor machine-readable output--type fragile|bottleneck|uncovered|orphanto filterPrior Art
Lattice Impact
REQ-LINT-001(Lint warns on orphan nodes)REQ-CLI-011(Summary Command)REQ-CLI-029