fix

User Input

$ARGUMENTS

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

Goal

Fix bugs using a test-driven approach with automatic retry logic for failed fixes.

Purpose: Streamline bug fixing by combining bugfix workflow with retry logic and optional regression testing.

Workflow:

• Standard: Bugfix → Verify → (Retry if needed)
• With --regression-test: Create Test → Verify Fails → Bugfix → Verify Passes
• With --hotfix: Expedited workflow for production issues

User Experience:

• Single command instead of manual bugfix + validation
• Automatic retry if fix doesn't work
• Test-first approach ensures regression prevention
• Ready for final merge with /ss:ship

---

Pre-Flight Checks

# Parse arguments
BUG_DESC=""
REGRESSION_TEST=false
HOTFIX=false
MAX_RETRIES=2
BACKGROUND_MODE=false
NOTIFY_ON_COMPLETE=false
COORDINATE_MODE=false

# Extract bug description (first non-flag argument)
for arg in $ARGUMENTS; do
  if [ "${arg:0:2}" != "--" ] && [ -z "$BUG_DESC" ]; then
    BUG_DESC="$arg"
  elif [ "$arg" = "--regression-test" ]; then
    REGRESSION_TEST=true
  elif [ "$arg" = "--hotfix" ]; then
    HOTFIX=true
  elif [ "$arg" = "--max-retries" ]; then
    shift
    MAX_RETRIES="$1"
  elif [ "$arg" = "--background" ]; then
    BACKGROUND_MODE=true
  elif [ "$arg" = "--notify" ]; then
    NOTIFY_ON_COMPLETE=true
  elif [ "$arg" = "--coordinate" ]; then
    COORDINATE_MODE=true
  fi
done

# Validate bug description
if [ -z "$BUG_DESC" ]; then
  echo "❌ Error: Bug description required"
  echo ""
  echo "Usage: /ss:fix \"bug description\" [options]"
  echo ""
  echo "Options:"
  echo "  --regression-test  Create failing test first (TDD approach)"
  echo "  --hotfix           Expedited workflow for production issues"
  echo "  --max-retries N    Maximum fix retry attempts (default 2)"
  echo "  --coordinate       Multi-bug orchestrated debugging"
  echo "  --background       Run fix in background mode"
  echo ""
  echo "Examples:"
  echo "  /ss:fix \"Login fails with special characters in password\""
  echo "  /ss:fix \"Cart total incorrect with discounts\" --regression-test"
  echo "  /ss:fix \"Production API timeout\" --hotfix"
  echo "  /ss:fix \"Memory leak in dashboard\" --regression-test --max-retries 3"
  echo "  /ss:fix \"navbar broken, sign-out fails, like button error\" --coordinate"
  exit 1
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"

# Create session tracking for background mode
mkdir -p .specswarm/sessions

# Prune old sessions (keep last 20)
SESSION_COUNT=$(find .specswarm/sessions -name "*.json" -type f 2>/dev/null | wc -l)
if [ "$SESSION_COUNT" -gt 20 ]; then
  find .specswarm/sessions -name "*.json" -type f -printf '%T@ %p\n' | \
    sort -n | head -n $(( SESSION_COUNT - 20 )) | cut -d' ' -f2- | \
    xargs rm -f 2>/dev/null
fi

SESSION_ID="fix-$(date +%Y%m%d-%H%M%S)"

cat > ".specswarm/sessions/${SESSION_ID}.json" << EOF
{
  "type": "fix",
  "session_id": "$SESSION_ID",
  "bug_description": "$BUG_DESC",
  "started_at": "$(date -Iseconds 2>/dev/null || date -u +"%Y-%m-%dT%H:%M:%S%z")",
  "status": "running",
  "regression_test": $REGRESSION_TEST,
  "hotfix": $HOTFIX,
  "max_retries": $MAX_RETRIES,
  "current_retry": 0,
  "background_mode": $BACKGROUND_MODE,
  "notify_on_complete": $NOTIFY_ON_COMPLETE,
  "coordinate_mode": $COORDINATE_MODE
}
EOF

# If background mode, show session info
if [ "$BACKGROUND_MODE" = true ]; then
  echo ""
  echo "🔄 Fix started in background mode"
  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
  echo ""
  echo "Session ID: $SESSION_ID"
  echo "Bug: $BUG_DESC"
  echo ""
  echo "Track progress with:"
  echo "  /ss:status $SESSION_ID"
  echo ""
  if [ "$NOTIFY_ON_COMPLETE" = true ]; then
    echo "You will be notified when complete."
  fi
  echo ""
fi