refactor-squatters

What problem does it solve?

Detects modules or packages that occupy a namespace position they do not semantically own, helping teams maintain domain coherence and avoid navigational ambiguity in large codebases.

Core Features & Use Cases

• Identifies five namespace integrity violation patterns: utility dumps, stuttery siblings, thin wrappers, axis violations, and semantic diffusion.
• Scans project structure to surface misplaced concepts and provides prioritized remediation directions (move, rename, or consolidate).
• Generates a readable audit report and references for human review.

Quick Start

Run a structural audit to identify namespace squatters and report actionable remediation suggestions.