refactor-squatters

Detect namespace integrity violations by scanning project structure to surface misplaced concepts like utility dumps and semantic diffusion, producing a structured audit report with severity classifications and remediation hypotheses for human review.

Namespace squatters are modules occupying a namespace position they do not semantically own, creating navigational ambiguity and domain coherence issues. This structural smell includes patterns like stuttery siblings, thin wrappers, and axis violations.

Yes, you can audit large Python codebases to identify five namespace integrity violation patterns including semantic diffusion and thin wrappers, generating an actionable report with prioritized remediation directions like move, rename, or consolidate.

The best way to fix stuttery siblings and utility dumps is running a structural audit that surfaces these namespace violations, then applying prioritized remediation directions to move, rename, or consolidate the misplaced modules into coherent domain boundaries.

This namespace audit applies specifically to large Python projects. It scans project structure to surface misplaced concepts and domain coherence issues, making it most effective for codebases where navigational ambiguity and structural smells have accumulated.