upgrade

User Input

$ARGUMENTS

You MUST consider the user input before proceeding (if not empty).

Goal

Upgrade dependencies or frameworks with automated breaking change analysis and code refactoring.

Purpose: Streamline complex upgrade processes by automating dependency updates, breaking change detection, and code refactoring.

Workflow: Analyze → Plan → Update → Refactor → Test → Report

Scope:

• Framework upgrades (React 18→19, Vue 2→3, Next.js 13→14, etc.)
• Dependency upgrades (specific packages or all dependencies)
• Breaking change detection from changelogs
• Automated code refactoring for breaking changes
• Test validation after upgrade

User Experience:

• Single command handles complex multi-step upgrades
• Automatic breaking change detection
• Guided refactoring with codemod suggestions
• Test-driven validation
• Clear migration report with manual tasks

---

Pre-Flight Checks

# Parse arguments
UPGRADE_TARGET=""
UPGRADE_ALL_DEPS=false
PACKAGE_NAME=""
DRY_RUN=false

# Extract upgrade target (first non-flag argument)
for arg in $ARGUMENTS; do
  if [ "${arg:0:2}" != "--" ] && [ -z "$UPGRADE_TARGET" ]; then
    UPGRADE_TARGET="$arg"
  elif [ "$arg" = "--deps" ]; then
    UPGRADE_ALL_DEPS=true
  elif [ "$arg" = "--package" ]; then
    shift
    PACKAGE_NAME="$1"
  elif [ "$arg" = "--dry-run" ]; then
    DRY_RUN=true
  fi
done

# Validate upgrade target
if [ -z "$UPGRADE_TARGET" ] && [ "$UPGRADE_ALL_DEPS" = false ] && [ -z "$PACKAGE_NAME" ]; then
  echo "❌ Error: Upgrade target required"
  echo ""
  echo "Usage: /ss:upgrade \"target\" [--deps] [--package name] [--dry-run]"
  echo ""
  echo "Examples:"
  echo "  /ss:upgrade \"React 18 to React 19\""
  echo "  /ss:upgrade \"Next.js 14 to Next.js 15\""
  echo "  /ss:upgrade --deps                    # All dependencies"
  echo "  /ss:upgrade --package react           # Specific package"
  echo "  /ss:upgrade \"Vue 2 to Vue 3\" --dry-run"
  exit 1
fi

# Normalize upgrade target
if [ "$UPGRADE_ALL_DEPS" = true ]; then
  UPGRADE_TARGET="all dependencies"
elif [ -n "$PACKAGE_NAME" ]; then
  UPGRADE_TARGET="$PACKAGE_NAME to latest"
fi

# Get project root
if ! git rev-parse --git-dir > /dev/null 2>&1; then
  echo "❌ Error: Not in a git repository"
  exit 1
fi

REPO_ROOT=$(git rev-parse --show-toplevel)
cd "$REPO_ROOT"

# Check for package.json
if [ ! -f "package.json" ]; then
  echo "❌ Error: package.json not found"
  echo "   This command currently supports Node.js/npm projects."
  exit 1
fi