Program Refactor Analysis

Analysis by Focus

Complexity (complexity or all)

Identify:

• Deep nesting: Functions with 4+ levels of nesting (if/for/try/switch chains)
• Long functions: Functions exceeding 50 lines (suggest extraction)
• Long parameter lists: Functions with 5+ parameters (suggest object parameter)
• Cyclomatic complexity: Functions with many conditional branches
• God files: Files exceeding 300 lines with mixed responsibilities
• Complex conditionals: Boolean expressions with 3+ conditions

For each finding, provide:

• File and approximate line location
• Current complexity indicator (nesting depth, line count, branch count)
• Suggested refactoring (extract function, extract class, simplify conditional)
• Before/after sketch (brief, showing the shape of the change)

Duplication (duplication or all)

Identify:

• Structural duplication: Similar code blocks (5+ lines) appearing in multiple files
• Pattern duplication: Same algorithm implemented differently in different places
• Copy-paste indicators: Nearly identical functions with minor variations
• Repeated boilerplate: Setup/teardown patterns that could be extracted

For each finding, provide:

• Files and approximate locations where duplication occurs
• Similarity estimate (exact match, near-match, structural)
• Suggested consolidation (extract shared function, create utility, use generics)
• Canonical location recommendation (where the shared code should live)

Coupling (coupling or all)

Identify:

• Circular dependencies: Module A imports B, B imports A (or longer cycles)
• Deep import chains: A -> B -> C -> D -> E (5+ hops to reach a dependency)
• Tight coupling: Module that imports 10+ other project modules
• Leaky abstractions: Internal implementation details exposed via exports
• God modules: Single module imported by 50%+ of the codebase

For each finding, provide:

• Import chain or dependency relationship
• Impact assessment (how many files affected by a change)
• Suggested decoupling (extract interface, dependency injection, barrel restructure)
• Risk level (low: cosmetic, medium: behavioral, high: architectural)

Output Format

Structure your report as:

## Refactoring Report

### Summary

{1-2 sentence overview of findings}

| Category | Findings | High Priority | Medium | Low |
|----------|----------|---------------|--------|-----|
| Complexity | {N} | {N} | {N} | {N} |
| Duplication | {N} | {N} | {N} | {N} |
| Coupling | {N} | {N} | {N} | {N} |

### High Priority

#### {finding title}
- **Category**: {complexity|duplication|coupling}
- **Location**: `{file}:{line}`
- **Issue**: {description}
- **Suggestion**: {refactoring approach}
- **Risk**: {low|medium|high}

**Before:**
```{lang}
{brief code showing current shape}

After:

{brief code showing suggested shape}

Medium Priority

{same format}

Low Priority

{same format}

## Telemetry

Include at the end of every report:

Telemetry

files_analyzed: {N} suggestions_found: {N} doc_type: refactor