bimagic 1.4.2

package/bimagic

@@ -0,0 +1,1310 @@
+#!/usr/bin/env bash
+
+VERSION="v1.4.2"
+
+if [[ "$1" == "--version" || "$1" == "-v" ]]; then
+  echo "Bimagic Git Wizard $VERSION"
+  exit 0
+fi
+
+# Configuration and Theme
+CONFIG_DIR="$HOME/.config/bimagic"
+THEME_FILE="$CONFIG_DIR/theme.wz"
+
+# Default colors (ANSI 0-255 or HEX)
+BIMAGIC_PRIMARY="212"
+BIMAGIC_SECONDARY="51"
+BIMAGIC_SUCCESS="46"
+BIMAGIC_ERROR="196"
+BIMAGIC_WARNING="214"
+BIMAGIC_INFO="39"
+BIMAGIC_MUTED="240"
+
+# Banner Colors
+BANNER_COLOR_1="51"
+BANNER_COLOR_2="45"
+BANNER_COLOR_3="39"
+BANNER_COLOR_4="99"
+BANNER_COLOR_5="135"
+
+# Load theme if it exists
+if [[ -f "$THEME_FILE" ]]; then
+  source "$THEME_FILE"
+fi
+
+# Function to get ANSI escape sequence for echo
+get_ansi_esc() {
+  local color=$1
+  if [[ "$color" =~ ^# ]]; then
+    local r=$(printf "%d" "0x${color:1:2}")
+    local g=$(printf "%d" "0x${color:3:2}")
+    local b=$(printf "%d" "0x${color:5:2}")
+    echo -e "\033[38;2;${r};${g};${b}m"
+  else
+    echo -e "\033[38;5;${color}m"
+  fi
+}
+
+# Colors for output (using theme)
+GREEN=$(get_ansi_esc "$BIMAGIC_SUCCESS")
+RED=$(get_ansi_esc "$BIMAGIC_ERROR")
+YELLOW=$(get_ansi_esc "$BIMAGIC_WARNING")
+BLUE=$(get_ansi_esc "$BIMAGIC_SECONDARY")
+PURPLE=$(get_ansi_esc "$BIMAGIC_PRIMARY")
+CYAN=$(get_ansi_esc "$BIMAGIC_INFO")
+NC='\033[0m' # No Color
+
+# Ensure gum is installed
+if ! command -v gum &>/dev/null; then
+  echo "Error: gum is not installed."
+  echo "Please install it: https://github.com/charmbracelet/gum"
+  exit 1
+fi
+
+echo "Welcome to the Git Wizard! Let's work some magic..."
+echo
+
+# Sound functions
+play_sound() {
+  local sound_type=$1
+  case "$sound_type" in
+  "success")
+    # Pleasant bell sound
+    echo -e "\a" # System bell
+    # Alternative: play a beep sequence
+    for i in {1..2}; do
+      printf "\a"
+      sleep 0.1
+    done
+    ;;
+  "error")
+    # Harsher error sound
+    for i in {1..3}; do
+      printf "\a"
+      sleep 0.05
+    done
+    ;;
+  "warning")
+    # Single warning beep
+    printf "\a"
+    ;;
+  "magic")
+    # Magical sequence for special operations
+    for i in {1..3}; do
+      printf "\a"
+      sleep 0.2
+    done
+    ;;
+  "progress")
+    # Subtle progress indicator
+    printf "\a"
+    ;;
+  esac
+}
+print_status() {
+  gum style --foreground "$BIMAGIC_PRIMARY" "$1"
+  play_sound "success"
+}
+
+print_error() {
+  gum style --foreground "$BIMAGIC_ERROR" "$1"
+  play_sound "error"
+}
+
+print_warning() {
+  gum style --foreground "$BIMAGIC_WARNING" "$1"
+  play_sound "warning"
+}
+
+# Function to get current branch with color
+get_current_branch() {
+  git branch --show-current 2>/dev/null || echo "main"
+}
+
+# Function to display branches with gum
+show_branches() {
+  local current_branch=$(get_current_branch)
+
+  # Get all branches and highlight current one
+  git branch -a --format='%(refname:short)' |
+    while read -r branch; do
+      if [[ "$branch" == "$current_branch" ]]; then
+        echo -e "${GREEN}➤ $branch${NC} (current)"
+      else
+        echo "  $branch"
+      fi
+    done | sort -u
+}
+
+# Function to setup or update a remote
+setup_remote() {
+  local remote_name=${1:-"origin"}
+
+  if ! git rev-parse --git-dir >/dev/null 2>&1; then
+    print_error "Not a git repository! Initialize it first."
+    return 1
+  fi
+
+  # Ask for protocol
+  local protocol=$(gum choose --header "Select protocol for '$remote_name':" "HTTPS (Token)" "SSH")
+
+  local remote_url=""
+  if [[ "$protocol" == "HTTPS (Token)" ]]; then
+    if [[ -z "$GITHUB_USER" ]] || [[ -z "$GITHUB_TOKEN" ]]; then
+      print_error "GITHUB_USER and GITHUB_TOKEN required for HTTPS!"
+      return 1
+    fi
+    local reponame=$(gum input --placeholder "Enter repo name (example: my-repo)")
+    [[ -z "$reponame" ]] && return 1
+    # Ensure it ends with .git consistently
+    reponame="${reponame%.git}.git"
+    remote_url="https://${GITHUB_TOKEN}@github.com/${GITHUB_USER}/${reponame}"
+  elif [[ "$protocol" == "SSH" ]]; then
+    remote_url=$(gum input --placeholder "Enter SSH URL (e.g., git@github.com:user/repo.git)")
+    [[ -z "$remote_url" ]] && return 1
+  else
+    print_warning "No protocol selected."
+    return 1
+  fi
+
+  if gum confirm "Set remote '$remote_name' to $remote_url?"; then
+    git remote remove "$remote_name" 2>/dev/null
+    git remote add "$remote_name" "$remote_url"
+    print_status " Remote '$remote_name' set to $remote_url"
+    return 0
+  else
+    print_status "Operation cancelled."
+    return 1
+  fi
+}
+
+show_repo_status() {
+  if ! git rev-parse --git-dir >/dev/null 2>&1; then
+    print_warning "Not inside a git repository!"
+    return
+  fi
+
+  local branch=$(get_current_branch)
+
+  # Ahead/behind info
+  local upstream=$(git rev-parse --abbrev-ref --symbolic-full-name @{u} 2>/dev/null)
+  local ahead behind
+  if [[ -n "$upstream" ]]; then
+    ahead=$(git rev-list --count "$upstream"..HEAD 2>/dev/null)
+    behind=$(git rev-list --count HEAD.."$upstream" 2>/dev/null)
+  else
+    ahead=0
+    behind=0
+  fi
+
+  # Working tree status
+  local status
+  if git diff --quiet 2>/dev/null && git diff --cached --quiet 2>/dev/null; then
+    if git ls-files -u | grep -q .; then
+      status="🔴 conflicts"
+      color="$BIMAGIC_ERROR"
+    else
+      status="🟢 clean"
+      color="$BIMAGIC_SUCCESS"
+    fi
+  else
+    status="🟡 uncommitted"
+    color="$BIMAGIC_WARNING"
+  fi
+
+  local display_user=${GITHUB_USER:-"SSH/Local"}
+  local content="GITHUB USER: $display_user
+BRANCH: $branch
+AHEAD: $ahead | BEHIND: $behind
+STATUS: $status"
+
+  echo
+  gum style \
+    --border rounded \
+    --margin "1 0" \
+    --padding "1 2" \
+    --border-foreground "$color" \
+    "$content"
+}
+
+generate_bar() {
+  local percentage=$1
+  local bar=""
+  # Convert float to integer for bar calculation
+  local int_percentage=${percentage%.*}
+  local bars=$((int_percentage / 2)) # Each █ represents 2%
+
+  for ((i = 0; i < bars; i++)); do
+    bar+="█"
+  done
+  echo "$bar"
+}
+
+# Function to get contributor statistics
+show_contributor_stats() {
+  if ! git rev-parse --git-dir >/dev/null 2>&1; then
+    print_error "Not a git repository!"
+    return 1
+  fi
+
+  # Time range selection
+  local time_range=$(gum choose --header "Select time range" \
+    "Last 7 days" \
+    "Last 30 days" \
+    "Last 90 days" \
+    "Last year" \
+    "All time")
+
+  local since=""
+  case "$time_range" in
+  "Last 7 days") since="--since='7 days ago'" ;;
+  "Last 30 days") since="--since='30 days ago'" ;;
+  "Last 90 days") since="--since='3 months ago'" ;;
+  "Last year") since="--since='1 year ago'" ;;
+  "All time") since="" ;;
+  *)
+    print_warning "No time range selected."
+    return 1
+    ;;
+  esac
+
+  print_status "Analyzing contributions ($time_range)..."
+  echo
+
+  # Temporary file for processing
+  local temp_file=$(mktemp)
+
+  # Get git log with numstat and format for processing
+  if [[ -n "$since" ]]; then
+    gum spin --title "Analyzing log..." -- bash -c "git log --pretty=format:'COMMIT|%aN' --numstat $since > $temp_file 2>/dev/null"
+  else
+    gum spin --title "Analyzing log..." -- bash -c "git log --pretty=format:'COMMIT|%aN' --numstat > $temp_file 2>/dev/null"
+  fi
+
+  # Check if we got any data
+  if [[ ! -s "$temp_file" ]]; then
+    print_error "No contribution data found for the selected period."
+    rm -f "$temp_file"
+    return 1
+  fi
+
+  # Process the data with awk
+  local stats=$(awk ' 
+    BEGIN {
+        total_lines = 0
+    }
+    /^COMMIT\|/ {
+        # Extract author name (everything after COMMIT|)
+        split($0, a, "|")
+        author = a[2]
+        author_commits[author]++
+        last_author = author
+    }
+    /^[0-9-]/ {
+        added = $1
+        deleted = $2
+        # Use 0 if added/deleted is "-" (binary files)
+        add_num = (added == "-" ? 0 : added)
+        del_num = (deleted == "-" ? 0 : deleted)
+        
+        author = last_author
+        if (author != "") {
+            author_lines[author] += add_num + del_num
+            total_lines += add_num + del_num
+        }
+    }
+    END {
+        for (author in author_commits) {
+            if (total_lines > 0) {
+                percentage = (author_lines[author] / total_lines) * 100
+            } else {
+                percentage = 0
+            }
+            printf "%s|%d|%d|%.1f\n", author, author_lines[author], author_commits[author], percentage
+        }
+    }' "$temp_file" | sort -t'|' -k2 -nr)
+
+  rm -f "$temp_file"
+
+  if [[ -z "$stats" ]]; then
+    print_error "No contribution data found for the selected period."
+    return 1
+  fi
+
+  # Calculate additional metrics
+  local most_active_author=""
+  local most_commits=0
+  local most_productive_author=""
+  local highest_avg=0
+
+  # Display header
+  echo -e "${PURPLE}Contribution Report ($time_range)${NC}"
+  echo "$(printf '─%.0s' $(seq 1 45))"
+
+  # Display each contributor
+  while IFS='|' read -r author lines commits percentage; do
+    # Clean up author name
+    author=$(echo "$author" | sed 's/^ *//;s/ *$//')
+
+    # Generate bar (max 50 characters for 100%)
+    local bar=$(generate_bar "$percentage")
+
+    printf "% -15s %-25s %5.1f%% (%d lines)\n" \
+      "$author" "$bar" "$percentage" "$lines"
+
+    # Track most active (most commits)
+    if [[ $commits -gt $most_commits ]]; then
+      most_commits=$commits
+      most_active_author="$author"
+    fi
+
+    # Track most productive (highest average lines per commit)
+    if [[ $commits -gt 0 ]]; then
+      local avg_lines=$((lines / commits))
+      if [[ $avg_lines -gt $highest_avg ]]; then
+        highest_avg=$avg_lines
+        most_productive_author="$author"
+      fi
+    fi
+
+  done <<<"$stats"
+
+  echo
+  echo -e "${CYAN}Highlights:${NC}"
+  if [[ -n "$most_active_author" ]]; then
+    echo -e "${BLUE}Most Active:${NC} $most_active_author ($most_commits commits)"
+  fi
+  if [[ -n "$most_productive_author" ]]; then
+    echo -e "${BLUE}Most Productive:${NC} $most_productive_author ($highest_avg lines/commit)"
+  fi
+
+  local total_contributors=$(echo "$stats" | wc -l)
+  echo -e "${BLUE}Total Contributors:${NC} $total_contributors"
+}
+
+# Function to clone a repository (Standard or Interactive)
+clone_repo() {
+  local url=$1
+  local interactive=$2
+
+  # Extract repo name from URL (basename, remove .git)
+  local repo_name=$(basename "$url" .git)
+
+  if [[ -d "$repo_name" ]]; then
+    print_error "Directory '$repo_name' already exists."
+    return 1
+  fi
+
+  if [[ "$interactive" == "true" ]]; then
+    print_status "Initializing interactive clone for $repo_name..."
+
+    # 1. Clone with --no-checkout and --filter=blob:none (downloads commits/trees, no file contents)
+    if ! gum spin --title "Cloning structure..." -- git clone --filter=blob:none --no-checkout "$url" "$repo_name"; then
+      print_error "Clone failed."
+      return 1
+    fi
+
+    pushd "$repo_name" >/dev/null || return 1
+
+    # 2. List all files (from HEAD) and let user select
+    print_status "Fetching file list..."
+    local selected_paths
+    # git ls-tree -r --name-only HEAD lists all files recursively
+    selected_paths=$(git ls-tree -r --name-only HEAD | gum filter --no-limit --placeholder "Select files/folders to download (Space to select)")
+
+    if [[ -z "$selected_paths" ]]; then
+      print_warning "No files selected. Aborting checkout."
+      popd >/dev/null
+      rm -rf "$repo_name"
+      return 1
+    fi
+
+    # 3. Configure sparse-checkout
+    # FIX: Add --no-cone so Git accepts individual file paths
+    gum spin --title "Configuring sparse checkout..." -- git sparse-checkout init --no-cone
+
+    # We use 'set' with the selected paths.
+    # Note: --cone mode works best with directories, but for specific files we might rely on the fact
+    # that sparse-checkout patterns handle full paths.
+    # However, 'git sparse-checkout set' treats arguments as patterns.
+    # We turn off cone for precise file selection transparency if needed, but standard 'set' often works.
+    # To be safe for exact file paths, we simply pass them.
+    # If the list is huge, this might fail on command line length.
+    # Ideally we pipe to 'git sparse-checkout set --stdin', but gum returns newline separated.
+
+    gum spin --title "Downloading selected files..." -- git checkout HEAD
+
+    popd >/dev/null
+    print_status "Successfully cloned selected files into '$repo_name'!"
+
+  else
+    # Standard clone
+    if gum spin --title "Cloning repository..." -- git clone "$url"; then
+      print_status "Successfully cloned '$url' into '$repo_name'!"
+    else
+      print_error "Clone failed."
+      return 1
+    fi
+  fi
+}
+
+# a .gitignore generator to your tool
+summon_gitignore() {
+  # Check for curl
+  if ! command -v curl &>/dev/null; then
+    print_error "Error: curl is not installed. Required to summon the Architect."
+    return 1
+  fi
+
+  print_status "📜 Summoning the Architect..."
+
+  # Check if .gitignore already exists
+  if [[ -f ".gitignore" ]]; then
+    print_warning "A .gitignore file already exists in this directory."
+    if ! gum confirm "Do you want to overwrite it?"; then
+      print_status "Operation cancelled."
+      return 0
+    fi
+  fi
+
+  # List of popular templates (curated from github/gitignore)
+  local templates=(
+    "Actionscript" "Ada" "Android" "Angular" "AppEngine" "ArchLinuxPackages" "Autotools"
+    "C++" "C" "CMake" "CUDA" "CakePHP" "ChefCookbook" "Clojure" "CodeIgniter" "Composer"
+    "Dart" "Delphi" "Dotnet" "Drupal" "Elixir" "Elm" "Erlang" "Flutter" "Fortran"
+    "Go" "Godot" "Gradle" "Grails" "Haskell" "Haxe" "Java" "Jekyll" "Joomla" "Julia"
+    "Kotlin" "Laravel" "Lua" "Magento" "Maven" "Nextjs" "Nim" "Nix" "Node" "Objective-C"
+    "Opa" "Perl" "Phalcon" "PlayFramework" "Prestashop" "Processing" "Python" "Qt"
+    "R" "ROS" "Rails" "Ruby" "Rust" "Scala" "Scheme" "Smalltalk" "Swift" "Symfony"
+    "Terraform" "TeX" "Unity" "UnrealEngine" "VisualStudio" "WordPress" "Zig"
+  )
+
+  # Use gum filter for a better selection experience
+  local template=$(printf "%s\n" "${templates[@]}" | gum filter --placeholder "Search for a blueprint (e.g., Python, Node, Rust)...")
+
+  if [[ -z "$template" ]]; then
+    print_status "Cancelled."
+    return 0
+  fi
+
+  # Fetch the template directly from GitHub's official repository
+  print_status "Drawing the magic circle for $template..."
+
+  local url="https://raw.githubusercontent.com/github/gitignore/main/${template}.gitignore"
+
+  if gum spin --title "Fetching template..." -- curl -sL "$url" -o .gitignore; then
+    # Verify the file is not empty (curl might return 404 text if URL is wrong)
+    if grep -q "404: Not Found" .gitignore; then
+      print_error "Failed to summon template: 404 Not Found at $url"
+      rm .gitignore
+      return 1
+    fi
+    print_status "✨ .gitignore for $template created successfully!"
+  else
+    print_error "Failed to summon template. Check your internet connection."
+    return 1
+  fi
+}
+
+# Function for Conventional Commits
+commit_wizard() {
+  echo -e "${PURPLE}=== The Alchemist's Commit ===${NC}"
+
+  # 1. Select Type
+  local type=$(gum choose --header "Select change type:" \
+    "feat: A new feature" \
+    "fix: A bug fix" \
+    "docs: Documentation only changes" \
+    "style: Changes that do not affect the meaning of the code" \
+    "refactor: A code change that neither fixes a bug nor adds a feature" \
+    "perf: A code change that improves performance" \
+    "test: Adding missing tests or correcting existing tests" \
+    "chore: Changes to the build process or auxiliary tools")
+
+  # Extract just the type (e.g., "feat") from the selection
+  type=$(echo "$type" | cut -d: -f1)
+  [[ -z "$type" ]] && return 1
+
+  # 2. Scope (Optional)
+  local scope=$(gum input --placeholder "Scope (optional, e.g., 'login', 'ui'). Press Enter to skip.")
+
+  # 3. Short Description
+  local summary=$(gum input --placeholder "Short description (imperative mood, e.g., 'add generic login')")
+  [[ -z "$summary" ]] && print_warning "Summary is required!" && return 1
+
+  # 4. Long Description (Optional)
+  local body=""
+  if gum confirm "Add a longer description (body)?"; then
+    body=$(gum write --placeholder "Enter detailed description...")
+  fi
+
+  # 5. Breaking Change?
+  local breaking=""
+  if gum confirm "Is this a BREAKING CHANGE?"; then
+    breaking="!"
+  fi
+
+  # Construct the message
+  local commit_msg=""
+  if [[ -n "$scope" ]]; then
+    commit_msg="${type}(${scope})${breaking}: ${summary}"
+  else
+    commit_msg="${type}${breaking}: ${summary}"
+  fi
+
+  # Append body if exists
+  if [[ -n "$body" ]]; then
+    commit_msg="${commit_msg}
+
+${body}"
+  fi
+
+  # Preview and Confirm
+  echo
+  gum style --border rounded --border-foreground "$BIMAGIC_PRIMARY" --padding "1 2" \
+    "PREVIEW:" "$commit_msg"
+  echo
+
+  if gum confirm "Commit with this message?"; then
+    git commit -m "$commit_msg"
+    print_status "󱝁 Mischief managed! (Commit successful)"
+  else
+    print_warning "Commit cancelled."
+  fi
+}
+
+#function to display git graph
+pretty_git_log() {
+  git log --graph \
+    --abbrev-commit \
+    --decorate \
+    --date=short \
+    --format="%C(auto)%h%Creset %C(blue)%ad%Creset %C(green)%an%Creset %C(yellow)%d%Creset %Creset%s" \
+    --all
+}
+
+# Check if environment variables are set (optional for SSH)
+if [[ -z "$GITHUB_USER" ]] || [[ -z "$GITHUB_TOKEN" ]]; then
+  print_warning "GITHUB_USER or GITHUB_TOKEN not set. Defaulting to SSH/Local mode."
+fi
+
+# Parse CLI arguments
+CLI_MODE=""
+CLI_URL=""
+CLI_MSG=""
+CLI_INTERACTIVE="false"
+
+# Preserve args in a loop
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+  -d)
+    CLI_MODE="clone"
+    shift
+    ;;
+  -i)
+    CLI_INTERACTIVE="true"
+    shift
+    ;;
+  -z)
+    CLI_MODE="lazy"
+    shift
+    ;;
+  -s)
+    CLI_MODE="status"
+    shift
+    ;;
+  -u)
+    CLI_MODE="undo"
+    shift
+    ;;
+  -g)
+    CLI_MODE="graph"
+    shift
+    ;;
+  -a | --architect)
+    CLI_MODE="architect"
+    shift
+    ;;
+  *)
+    # Argument handling based on current mode
+    if [[ "$CLI_MODE" == "clone" && -z "$CLI_URL" ]]; then
+      CLI_URL="$1"
+    elif [[ "$CLI_MODE" == "lazy" && -z "$CLI_MSG" ]]; then
+      CLI_MSG="$1"
+    fi
+    shift
+    ;;
+  esac
+done
+
+# --- Mode Handlers ---
+
+if [[ "$CLI_MODE" == "clone" ]]; then
+  if [[ -z "$CLI_URL" ]]; then
+    print_error "Error: Repository URL required with -d"
+    exit 1
+  fi
+  clone_repo "$CLI_URL" "$CLI_INTERACTIVE"
+  exit $?
+fi
+
+if [[ "$CLI_MODE" == "status" ]]; then
+  show_repo_status
+  exit 0
+fi
+
+if [[ "$CLI_MODE" == "graph" ]]; then
+  if ! git rev-parse --git-dir >/dev/null 2>&1; then
+    print_error "Not a git repository!"
+    exit 1
+  fi
+  pretty_git_log
+  exit 0
+fi
+
+if [[ "$CLI_MODE" == "architect" ]]; then
+  summon_gitignore
+  exit 0
+fi
+
+# Mode: Time Turner (Undo)
+if [[ "$CLI_MODE" == "undo" ]]; then
+  print_status "󱦟 Spinning the Time Turner..."
+
+  # Check if there is a commit to undo
+  if ! git rev-parse HEAD >/dev/null 2>&1; then
+    print_error "No commits to undo! This repo is empty."
+    exit 1
+  fi
+
+  # Check if we are on the initial commit (no parent)
+  is_initial_commit=false
+  if ! git rev-parse HEAD~1 >/dev/null 2>&1; then
+    is_initial_commit=true
+  fi
+
+  # Ask user for the type of undo
+  undo_type=$(gum choose --header "Select Undo Level:" \
+    "Soft (Undo commit, keep changes staged - Best for fixing typos)" \
+    "Mixed (Undo commit, keep changes unstaged - Best for splitting work)" \
+    "Hard (DESTROY changes - Revert to previous state)" \
+    "Cancel")
+
+  case "$undo_type" in
+  "Soft"*)
+    if [[ "$is_initial_commit" == "true" ]]; then
+      git update-ref -d HEAD
+    else
+      git reset --soft HEAD~1
+    fi
+    print_status "✨ Success! I undid the commit, but kept your files ready to commit again."
+    ;;
+  "Mixed"*)
+    if [[ "$is_initial_commit" == "true" ]]; then
+      git update-ref -d HEAD
+      git rm --cached -r -q .
+    else
+      git reset HEAD~1
+    fi
+    print_status "󱞈 Success! I undid the commit and unstaged the files."
+    ;;
+  "Hard"*)
+    if gum confirm " DANGER: This deletes your work forever. Are you sure?"; then
+      if [[ "$is_initial_commit" == "true" ]]; then
+        # Unstage everything first, then clean to ensure files are deleted
+        git update-ref -d HEAD
+        git rm --cached -r -q . >/dev/null 2>&1
+        git clean -fd
+      else
+        git reset --hard HEAD~1
+      fi
+      print_status "󱠇 Obliviate! The last commit and its changes are destroyed."
+    else
+      print_status "Operation cancelled."
+    fi
+    ;;
+  *)
+    print_status "Mischief managed (Cancelled)."
+    ;;
+  esac
+  exit 0
+fi
+
+if [[ "$CLI_MODE" == "lazy" ]]; then
+  if ! git rev-parse --git-dir >/dev/null 2>&1; then
+    print_error "Not a git repository!"
+    exit 1
+  fi
+
+  if [[ -z "$CLI_MSG" ]]; then
+    print_error "Error: Commit message required for Lazy Wizard (-z)"
+    echo "Usage: bimagic -z \"commit message\""
+    exit 1
+  fi
+
+  print_status "  Lazy Wizard invoked!"
+
+  # 1. Add all changes
+  if gum spin --title "Adding files..." -- git add .; then
+    print_status "Files added."
+  else
+    print_error "Failed to add files."
+    exit 1
+  fi
+
+  # 2. Commit
+  if git commit -m "$CLI_MSG"; then
+    print_status "Committed: $CLI_MSG"
+  else
+    print_error "Commit failed (nothing to commit?)"
+    exit 1
+  fi
+
+  # 3. Push
+  branch=$(get_current_branch)
+  print_status "Pushing to $branch..."
+
+  if gum spin --title "Pushing..." -- git push; then
+    print_status "󱝂 Magic complete!"
+  else
+    # Try setting upstream if standard push failed
+    print_warning "Standard push failed. Trying to set upstream..."
+    if gum spin --title "Pushing (upstream)..." -- git push -u origin "$branch"; then
+      print_status "󱝂 Magic complete (upstream set)!"
+    else
+      print_error "Push failed."
+      exit 1
+    fi
+  fi
+  exit 0
+fi
+
+CONFIG_DIR="$HOME/.config/bimagic"
+VERSION_FILE="$CONFIG_DIR/version"
+
+show_welcome_banner() {
+  clear
+  echo -e "$(get_ansi_esc "$BANNER_COLOR_1")▗▖   ▄ ▄▄▄▄   ▗▄▖  ▗▄▄▖▄  ▗▄▄▖\033[0m"
+  echo -e "$(get_ansi_esc "$BANNER_COLOR_2")▐▌   ▄ █ █ █ ▐▌ ▐▌▐▌   ▄ ▐▌   \033[0m"
+  echo -e "$(get_ansi_esc "$BANNER_COLOR_3")▐▛▀▚▖█ █   █ ▐▛▀▜▌▐▌▝▜▌█ ▐▌   \033[0m"
+  echo -e "$(get_ansi_esc "$BANNER_COLOR_4")▐▙▄▞▘█       ▐▌ ▐▌▝▚▄▞▘█ ▝▚▄▄▖\033[0m"
+  echo -e "$(get_ansi_esc "$BANNER_COLOR_5")                              \033[0m"
+
+  echo
+  gum style --foreground "$BIMAGIC_PRIMARY" --bold "✨ Welcome to Bimagic Git Wizard $VERSION ✨"
+  echo
+
+  if [[ ! -f "$VERSION_FILE" ]]; then
+    gum style --foreground "$BIMAGIC_SUCCESS" "It looks like this is your first time using Bimagic! Let's cast some spells."
+  else
+    gum style --foreground "$BIMAGIC_SUCCESS" "Bimagic has been updated to $VERSION! Enjoy the new magic."
+  fi
+  echo
+
+  # Save the current version so this doesn't show again until the next update
+  mkdir -p "$CONFIG_DIR"
+  echo "$VERSION" >"$VERSION_FILE"
+
+  gum style --foreground "$BIMAGIC_MUTED" "Press Enter to open the spellbook..."
+  read -r </dev/tty
+}
+
+if [[ -z "$CLI_MODE" ]]; then
+  # Check if the version file doesn't exist, OR if it doesn't match the current version
+  if [[ ! -f "$VERSION_FILE" ]] || [[ "$(cat "$VERSION_FILE")" != "$VERSION" ]]; then
+    show_welcome_banner
+  fi
+fi
+
+while true; do
+  clear
+  show_repo_status # <-- shows the status dashboard at the top
+  # gum menu
+  choice=$(
+    gum choose --header " Choose your spell: (j/k to navigate)" \
+      --cursor " " --cursor.foreground "$BIMAGIC_PRIMARY" \
+      " Clone repository" \
+      " Init new repo" \
+      " Add files" \
+      " Commit changes" \
+      " Push to remote" \
+      " Pull latest changes" \
+      " Create/switch branch" \
+      " Set remote" \
+      "󱖫 Show status" \
+      " Contributor Statistics" \
+      " Git graph" \
+      "󰓗 Summon the Architect (.gitignore)" \
+      "󰮘 Remove files/folders (rm)" \
+      " Merge branches" \
+      " Uninitialize repo" \
+      "󰁯 Revert commit(s)" \
+      "󰓗 Stash operations" \
+      "󰿅 Exit"
+  )
+  echo
+
+  case "$choice" in
+  " Clone repository")
+    repo_url=$(gum input --placeholder "Enter repository URL")
+    if [[ -z "$repo_url" ]]; then continue; fi
+
+    clone_mode=$(gum choose "Standard Clone" "Interactive (Select files)")
+
+    if [[ "$clone_mode" == "Interactive (Select files)" ]]; then
+      clone_repo "$repo_url" "true"
+    else
+      clone_repo "$repo_url" "false"
+    fi
+    ;;
+  "󰓗 Stash operations")
+    while true; do
+      stash_choice=$(gum choose --header "Stash Operations" \
+        "󱉛 Push (Save) changes" \
+        "󱉙 Pop latest stash" \
+        " List stashes" \
+        " Apply specific stash" \
+        " Drop specific stash" \
+        "󰎟 Clear all stashes" \
+        "󰌍 Back")
+
+      case "$stash_choice" in
+      "󱉛 Push (Save) changes")
+        msg=$(gum input --placeholder "Optional stash message")
+        # Ask about untracked files
+        if gum confirm "Include untracked files?"; then
+          include_untracked="-u"
+        else
+          include_untracked=""
+        fi
+
+        if git stash push $include_untracked -m "$msg"; then
+          print_status "Changes stashed successfully!"
+        else
+          print_error "Failed to stash changes."
+        fi
+        ;;
+      "󱉙 Pop latest stash")
+        if git stash pop; then
+          print_status "Stash popped successfully!"
+        else
+          print_error "Failed to pop stash (possible conflicts)."
+        fi
+        ;;
+      " List stashes")
+        if [[ -z "$(git stash list)" ]]; then
+          print_warning "No stashes found."
+        else
+          git stash list | gum style --border normal --padding "0 1"
+        fi
+        ;;
+      " Apply specific stash")
+        if [[ -z "$(git stash list)" ]]; then
+          print_warning "No stashes found."
+          continue
+        fi
+
+        stash_entry=$(git stash list | gum filter --placeholder "Select stash to apply")
+        if [[ -n "$stash_entry" ]]; then
+          stash_id=$(echo "$stash_entry" | cut -d: -f1)
+          if git stash apply "$stash_id"; then
+            print_status "Applied $stash_id"
+          else
+            print_error "Failed to apply $stash_id"
+          fi
+        fi
+        ;;
+      " Drop specific stash")
+        if [[ -z "$(git stash list)" ]]; then
+          print_warning "No stashes found."
+          continue
+        fi
+
+        stash_entry=$(git stash list | gum filter --placeholder "Select stash to drop")
+        if [[ -n "$stash_entry" ]]; then
+          stash_id=$(echo "$stash_entry" | cut -d: -f1)
+          if gum confirm "Are you sure you want to drop $stash_id?"; then
+            if git stash drop "$stash_id"; then
+              print_status "Dropped $stash_id"
+            else
+              print_error "Failed to drop $stash_id"
+            fi
+          fi
+        fi
+        ;;
+      "󰎟 Clear all stashes")
+        if [[ -z "$(git stash list)" ]]; then
+          print_warning "No stashes found."
+          continue
+        fi
+
+        if gum confirm "DANGER: This will delete ALL stashes. Continue?"; then
+          if git stash clear; then
+            print_status "All stashes cleared."
+          else
+            print_error "Failed to clear stashes."
+          fi
+        else
+          print_status "Operation cancelled."
+        fi
+        ;;
+      "󰌍 Back")
+        break
+        ;;
+      esac
+      echo
+      gum style --foreground "$BIMAGIC_MUTED" "Press Enter to continue..."
+      read -r </dev/tty
+    done
+    ;;
+  " Init new repo")
+    dirname=$(gum input --placeholder "Enter repo directory name (or '.' for current dir)")
+    if [[ -z "$dirname" ]]; then
+      print_warning "Operation cancelled."
+      continue
+    fi
+
+    if [[ "$dirname" == "." ]]; then
+      git init
+      print_status "Repo initialized in current directory: $(pwd)"
+    else
+      mkdir -p "$dirname"
+      # Run init and rename in a subshell to avoid directory tracking issues
+      (
+        cd "$dirname" || exit 1
+        git init
+        current_branch=$(git symbolic-ref --short HEAD 2>/dev/null)
+        if [[ "$current_branch" == "master" ]]; then
+          git branch -M main
+          echo "Default branch renamed from 'master' to 'main' in $dirname"
+        fi
+      )
+      print_status "Repo initialized in new directory: $dirname"
+    fi
+    ;;
+  " Add files")
+    # Show untracked + modified files, plus an [ALL] option
+    files=$( (
+      echo "[ALL]"
+      git ls-files --others --modified --exclude-standard
+    ) | gum filter --no-limit --placeholder "Select files to add")
+
+    if [[ -z "$files" ]]; then
+      print_warning "No files selected."
+    else
+      # gum filter returns selected items separated by newlines.
+      # We need to handle the case where [ALL] is selected along with other files.
+      if echo "$files" | grep -q "\[ALL\]"; then
+        git add .
+        print_status "All files staged."
+      else
+        # Correctly handle filenames with spaces by reading line by line
+        echo "$files" | while read -r f; do
+          [[ -n "$f" ]] && git add "$f"
+        done
+        print_status "Selected files staged."
+        # Optionally, list the files that were staged
+        echo "$files"
+      fi
+    fi
+    ;;
+  " Commit changes")
+    commit_mode=$(gum choose "󰦥 Magic Commit (Builder)" "󱐋 Quick Commit (One-line)")
+
+    if [[ "$commit_mode" == "󰦥 Magic Commit (Builder)" ]]; then
+      commit_wizard
+    else
+      msg=$(gum input --placeholder "Enter commit message")
+      if [[ -z "$msg" ]]; then
+        print_warning "No commit message provided. Cancelled."
+        continue
+      fi
+
+      if gum confirm "Commit changes?"; then
+        git commit -m "$msg"
+        print_status "Commit done!"
+      else
+        print_status "Commit cancelled."
+      fi
+    fi
+    ;;
+  " Push to remote")
+    branch=$(git symbolic-ref --short HEAD 2>/dev/null)
+    branch=${branch:-main}
+
+    remotes=$(git remote)
+
+    if [[ -z "$remotes" ]]; then
+      print_error "No remote set!"
+      if setup_remote "origin"; then
+        remote="origin"
+      else
+        continue
+      fi
+    else
+      # Select remote if multiple exist
+      if [[ $(echo "$remotes" | wc -l) -eq 1 ]]; then
+        remote="$remotes"
+      else
+        remote=$(echo "$remotes" | gum filter --placeholder "Select remote to push to")
+      fi
+    fi
+
+    [[ -z "$remote" ]] && continue
+
+    if gum confirm "Push branch '$branch' to '$remote'?"; then
+      echo "Pushing branch '$branch' to '$remote'..."
+      gum spin --title "Pushing..." -- git push -u "$remote" "$branch"
+    else
+      print_status "Push cancelled."
+    fi
+    ;;
+  " Pull latest changes")
+    # Auto-fetch before pulling
+    if gum spin --title "Fetching updates..." -- git fetch --all; then
+      print_status "Fetch complete."
+    else
+      print_warning "Fetch encountered issues."
+    fi
+
+    pull_choice=$(gum choose --header "Select pull mode" \
+      "Pull specific branch" \
+      "Pull all")
+
+    case "$pull_choice" in
+    "Pull all")
+      if gum confirm "Run 'git pull --all'?"; then
+        gum spin --title "Pulling all..." -- git pull --all
+        print_status "Pull all complete."
+      else
+        print_status "Pull cancelled."
+      fi
+      ;;
+    "Pull specific branch")
+      branch=$(gum input --value "main" --placeholder "Enter branch to pull")
+      branch=${branch:-main}
+
+      remotes=$(git remote 2>/dev/null)
+      if [[ -z "$remotes" ]]; then
+        print_error "No remote set! Cannot pull."
+      else
+        # Select remote if multiple exist
+        if [[ $(echo "$remotes" | wc -l) -eq 1 ]]; then
+          remote="$remotes"
+        else
+          remote=$(echo "$remotes" | gum filter --placeholder "Select remote to pull from")
+        fi
+
+        if [[ -n "$remote" ]]; then
+          if gum confirm "Pull branch '$branch' from '$remote'?"; then
+            gum spin --title "Pulling..." -- git pull "$remote" "$branch"
+          else
+            print_status "Pull cancelled."
+          fi
+        else
+          print_warning "No remote selected."
+        fi
+      fi
+      ;;
+    esac
+    ;;
+  " Create/switch branch")
+    # Show current branch and all available branches
+    current_branch=$(get_current_branch)
+    print_status "Current branch: $current_branch"
+    echo
+    print_status "Available branches:"
+    show_branches
+    echo
+
+    # Let user choose between existing branches or new branch
+    branch_option=$(gum choose "Switch to existing branch" "Create new branch")
+
+    case "$branch_option" in
+    "Switch to existing branch")
+      # Use gum filter to select from existing branches
+      existing_branch=$(git branch --format='%(refname:short)' | gum filter --placeholder "Select branch to switch to")
+      if [[ -n "$existing_branch" ]]; then
+        git checkout "$existing_branch"
+        print_status "Switched to branch: $existing_branch"
+      else
+        print_warning "No branch selected."
+      fi
+      ;;
+    "Create new branch")
+      new_branch=$(gum input --placeholder "Enter new branch name")
+      if [[ -n "$new_branch" ]]; then
+        git checkout -b "$new_branch"
+        print_status "Created and switched to new branch: $new_branch"
+      else
+        print_error "No branch name provided."
+      fi
+      ;;
+    *)
+      print_warning "Operation cancelled."
+      ;;
+    esac
+    ;;
+  " Set remote")
+    setup_remote "origin"
+    ;;
+  "󱖫 Show status")
+    git status
+    ;;
+  "󰮘 Remove files/folders (rm)")
+    # List tracked + untracked files for removal
+    files=$(git ls-files --cached --others --exclude-standard |
+      gum filter --no-limit --placeholder "Select files/folders to remove")
+
+    if [[ -z "$files" ]]; then
+      print_warning "No files selected."
+      continue # Use continue to go back to the main menu
+    fi
+
+    echo "Files selected for removal:"
+    # Use 'tput' for better visual separation and color
+    tput setaf 3
+    echo "$files"
+    tput sgr0
+    echo
+
+    if gum confirm "Confirm removal? This cannot be undone."; then
+      # Use a 'while read' loop to correctly handle filenames with spaces
+      echo "$files" | while read -r f; do
+        if [[ -z "$f" ]]; then continue; fi # Skip empty lines
+
+        # Check if the file is tracked by git
+        if git ls-files --error-unmatch "$f" >/dev/null 2>&1; then
+          # It's a tracked file, use 'git rm'
+          git rm -rf "$f"
+        else
+          # It's an untracked file, use 'rm'
+          rm -rf "$f"
+        fi
+      done
+      print_status "Selected files/folders have been removed."
+    else
+      print_status "Operation cancelled."
+    fi
+    ;;
+  " Uninitialize repo")
+    print_warning "This will completely uninitialize the Git repository in this folder."
+    echo "This action will delete the .git directory and cannot be undone!"
+    echo
+
+    if gum confirm "Are you sure you want to continue?"; then
+      if [ -d ".git" ]; then
+        rm -rf .git
+        print_status "Git repository has been uninitialized."
+      else
+        print_error "No .git directory found here. Nothing to do."
+      fi
+    else
+      print_status "Operation cancelled."
+    fi
+    ;;
+  "󰿅 Exit")
+    if gum confirm "Are you sure you want to exit?"; then
+      echo "Git Wizard vanishes in a puff of smoke..."
+      exit 0
+    else
+      continue
+    fi
+    ;;
+  " Merge branches")
+    current_branch=$(get_current_branch)
+    print_status "You are on branch: $current_branch"
+    echo
+
+    # Pick branch to merge from
+    merge_branch=$(git branch --format='%(refname:short)' |
+      grep -v "^$current_branch$" |
+      gum filter --placeholder "Select branch to merge into $current_branch")
+
+    if [[ -z "$merge_branch" ]]; then
+      print_warning "No branch selected. Merge cancelled."
+    else
+      if gum confirm "Merge branch '$merge_branch' into '$current_branch'?"; then
+        echo "Merging branch '$merge_branch' into '$current_branch'..."
+        if gum spin --title "Merging..." -- git merge "$merge_branch"; then
+          print_status "Merge successful!"
+        else
+          print_error "Merge had conflicts! Resolve them manually."
+        fi
+      else
+        print_status "Merge cancelled."
+      fi
+    fi
+    ;;
+  " Contributor Statistics")
+    show_contributor_stats
+    ;;
+
+  "󰓗 Summon the Architect (.gitignore)")
+    summon_gitignore
+    ;;
+
+  "󰁯 Revert commit(s)")
+    print_status "Fetching commit history..."
+    echo
+
+    # Show commits as "<hash> <message>" but keep hash separately
+    commits=$(git log --oneline --decorate |
+      gum filter --no-limit --placeholder "Select commit(s) to revert" |
+      awk '{print $1}')
+
+    if [[ -z "$commits" ]]; then
+      print_warning "No commit selected. Revert cancelled."
+      continue
+    fi
+
+    echo "You selected:"
+    echo "$commits"
+    echo
+
+    if gum confirm "Confirm revert?"; then
+      for c in $commits; do
+        echo "Reverting commit $c..."
+        if git revert --no-edit "$c"; then
+          print_status "Commit $c reverted."
+        else
+          print_error "Conflict occurred while reverting $c!"
+          echo "Please resolve conflicts, then run:"
+          echo "  git revert --continue"
+          break
+        fi
+      done
+    else
+      print_status "Revert cancelled."
+    fi
+    ;;
+
+  " Git graph")
+    color=${YELLOW}
+    line1="Git graph"
+    line2="[INFO] press 'q' to exit"
+
+    echo -e "${color}╭$(printf '─%.0s' $(seq 1 30))╮${NC}"
+    printf "${color}│${NC} %-*s ${color}│${NC}\n" 28 "$line1"
+    printf "${color}│${NC} %-*s ${color}│${NC}\n" 28 "$line2"
+    echo -e "${color}╰$(printf '─%.0s' $(seq 1 30))╯${NC}"
+
+    # Use gum spin while loading the graph.
+    # Since git log can be long, we pipe it to less if it's too big,
+    # but gum spin doesn't work well with interactive pagers.
+    # However, for a simple "pretty log", we can just run it.
+    gum spin --title "Drawing git graph..." -- sleep 2
+    pretty_git_log
+    ;;
+
+  *)
+    print_error "Invalid choice! Try again."
+    echo "Git Wizard vanishes in a puff of smoke..."
+    break
+    ;;
+  esac
+
+  echo
+  gum style --foreground "$BIMAGIC_MUTED" "Press Enter to continue..."
+  read -r </dev/tty
+done