arch-audit

Python module splitting and merging candidates are identified by analyzing import graphs, AST-based symbol analysis, and git churn metrics to rank files violating cohesion rules or requiring boundary consolidation.

Structural code analysis detects vague module boundaries, orphan files, and stability-mixed merges by evaluating codebase cohesion and churn ratios, preventing technical debt accumulation before major refactoring efforts.

Change impact assessment evaluates module stability using git churn ratios to prevent risky merges between high-churn and low-churn code areas, ensuring refactoring candidates maintain structural health.

Deterministic structural audits require Python 3.12+ and standard git tooling to execute AST-based symbol analysis and evaluate import graphs across the repository for refactoring candidates.

Static analysis detects orphan files and inlining opportunities by operating on import graphs and AST-based symbol analysis to identify tiny files that should be inlined or consolidated.

Run a structural health audit before a major refactor to identify reorg opportunities, including module splitting, file inlining, and boundary consolidation based on actual import graphs and co-edit patterns.