refactor

AI-Powered Code Refactoring

Refactor target: $ARGUMENTS

Parse $ARGUMENTS to extract:

• target: file path or directory path (required)
• --type: refactoring focus — extract, decompose, rename, cleanup, or all (default: all)
• --yes: skip confirmation prompt and apply all recommended refactorings automatically
• --dry-run: analyze and plan only, do not apply any changes
• --aggressive: lower thresholds (functions >30 lines, files >300 lines, nesting >3)
• --conservative: raise thresholds (functions >80 lines, files >800 lines, nesting >5)

If no target is provided, default to the current working directory.

---

Step 0: Safety — Worktree Isolation (MANDATORY before any mutation)

📖 CANONICAL REFERENCE: commands/references/WORKTREE_SAFETY.md defines the safety decision tree for all file-mutation commands. Load it and follow it BEFORE any Write / Edit / Bash mutation in this run.

Quick summary (full tree + rationale in the reference file):

1. Confirm scope with the user, then ask: isolated worktree (DEFAULT, recommended) vs current checkout (risky, requires opt-in) vs cancel.
2. Isolated worktree (default): either spawn the mutation phase as Agent({ ..., isolation: "worktree" }), OR manually git worktree add ../<repo>-refactor-$(date +%s) -b refactor/auto. After completion, show the diff and let the user merge / cherry-pick / discard.
3. Current checkout (only with explicit user opt-in): refuse if git status --porcelain is non-empty; create a savepoint commit before any mutation so rollback is git reset --hard HEAD~1.
4. No git: refuse to proceed.

Never start mutating files before completing this decision tree.

---

Step 0.5: Pre-Flight Validation

Before doing anything, validate the environment:

# Verify target exists
ls -la $TARGET 2>/dev/null || echo "ERROR: Target not found"

# Detect project language(s)
# Python: look for .py files, pyproject.toml, requirements.txt
# TypeScript: look for .ts/.tsx files, tsconfig.json, package.json
# JavaScript: look for .js/.jsx files, package.json
# Go: look for .go files, go.mod
# Rust: look for .rs files, Cargo.toml

# Check for git — we need it for safe rollback
git status 2>/dev/null || echo "WARNING: Not a git repo — no rollback safety net"

# Stash any uncommitted changes if present (safety)
git stash list 2>/dev/null