swift-refactor

Swift Refactor Clean

Safely identify and remove dead code with test verification for iOS projects.

This command invokes the swift-refactor-cleaner agent.

What This Command Does

1. Analyze Dead Code - Run Periphery to find unused Swift code
2. Generate Report - Categorize findings by severity
3. Propose Safe Deletions - Start with low-risk items
4. Verify with Tests - Run tests before and after each change
5. Rollback on Failure - Revert if tests fail

Process

1. Run dead code analysis tools:

   • Periphery: Find unused code, protocols, functions
   • SPM: swift package diagnose-dependencies
   • Xcode: Build with -Wunused warnings

2. Generate report in .reports/dead-code-analysis.md

3. Categorize findings by severity:

   • SAFE: Unused private methods, test utilities
   • CAUTION: Unused public APIs, ViewModels
   • DANGER: Protocol extensions, @objc code, App entry points

4. Propose safe deletions only

5. Before each deletion:

   • Run full test suite
   • Verify tests pass
   • Apply change
   • Re-run tests
   • Rollback if tests fail

6. Show summary of cleaned items

Running Periphery

Installation

# Homebrew
brew install peripheryapp/periphery/periphery

# Or build from source
git clone https://github.com/peripheryapp/periphery
cd periphery && make install

Configuration

Create .periphery.yml in project root:

# .periphery.yml
project: MyApp.xcodeproj
schemes:
  - MyApp
targets:
  - MyApp
  - MyAppTests

# Exclude patterns
exclude:
  - "*.generated.swift"
  - "**/Preview Content/**"
  - "**/*+Preview.swift"

# Retain patterns (false positives)
retain_public: false
retain_objc_accessible: true
retain_unused_protocol_func_params: true

# Output
format: json
quiet: false

Running Analysis

# Full analysis
periphery scan --project MyApp.xcodeproj --schemes MyApp --targets MyApp

# With JSON output for parsing
periphery scan --format json > dead-code-report.json

# SPM project
periphery scan --setup

# Quick scan (faster, less accurate)
periphery scan --skip-build