Skip to content

Hotspot analysis command (god nodes, fragile claims) #26

@gmoon

Description

@gmoon

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions