hammer-dependency-analyzer

What problem does it solve?

Complex C++ codebases often suffer from circular dependencies, tight coupling, and layer violations, leading to long compile times, fragile code, and architectural decay that is difficult to manage manually.

Core Features & Use Cases

• Circular Dependency Detection: Identifies and suggests fixes for include cycles that break compilation, ensuring a clean and deterministic build process.
• Layer Violation & Coupling Analysis: Enforces architectural rules (e.g., Managers don't depend on States) and quantifies coupling strength, highlighting areas for refactoring.
• Header Bloat & Compile Time Impact: Pinpoints headers causing excessive recompilation and suggests forward declaration opportunities to significantly reduce build times.
• Use Case: Before a major refactor, run a "Full Architecture Audit" to visualize the dependency graph, identify any new circular dependencies or layer violations, and get a health score for the codebase, ensuring architectural integrity.

Quick Start

Analyze dependencies for the entire HammerEngine codebase and check for circular dependencies.