feat(debug): add detailed debug output for clean operations

- Add classify_cleanup_risk() for risk level classification (LOW/MEDIUM/HIGH)
- Enhance safe_clean() with operation details and risk info
- Show item counts and file lists in debug mode
- Support for lib/clean/user.sh debug enhancements
- Part of GitHub issue #242 implementation

bin/clean.sh

@@ -44,6 +44,8 @@ if [[ -f "$HOME/.config/mole/whitelist" ]]; then
         [[ -z "$line" || "$line" =~ ^# ]] && continue
 
         [[ "$line" == ~* ]] && line="${line/#~/$HOME}"
+        line="${line//\$HOME/$HOME}"
+        line="${line//\$\{HOME\}/$HOME}"
         if [[ "$line" =~ \.\. ]]; then
             WHITELIST_WARNINGS+=("Path traversal not allowed: $line")
             continue
@@ -260,6 +262,46 @@ get_cleanup_path_size_kb() {
     get_path_size_kb "$path"
 }
 
+# Classification helper for cleanup risk levels
+# shellcheck disable=SC2329
+classify_cleanup_risk() {
+    local description="$1"
+    local path="${2:-}"
+
+    # HIGH RISK: System files, preference files, require sudo
+    if [[ "$description" =~ [Ss]ystem || "$description" =~ [Ss]udo || "$path" =~ ^/System || "$path" =~ ^/Library ]]; then
+        echo "HIGH|System files or requires admin access"
+        return
+    fi
+
+    # HIGH RISK: Preference files that might affect app functionality
+    if [[ "$description" =~ [Pp]reference || "$path" =~ /Preferences/ ]]; then
+        echo "HIGH|Preference files may affect app settings"
+        return
+    fi
+
+    # MEDIUM RISK: Installers, large files, app bundles
+    if [[ "$description" =~ [Ii]nstaller || "$description" =~ [Aa]pp.*[Bb]undle || "$description" =~ [Ll]arge ]]; then
+        echo "MEDIUM|Installer packages or app data"
+        return
+    fi
+
+    # MEDIUM RISK: Old backups, downloads
+    if [[ "$description" =~ [Bb]ackup || "$description" =~ [Dd]ownload || "$description" =~ [Oo]rphan ]]; then
+        echo "MEDIUM|Backup or downloaded files"
+        return
+    fi
+
+    # LOW RISK: Caches, logs, temporary files (automatically regenerated)
+    if [[ "$description" =~ [Cc]ache || "$description" =~ [Ll]og || "$description" =~ [Tt]emp || "$description" =~ [Tt]humbnail ]]; then
+        echo "LOW|Cache/log files, automatically regenerated"
+        return
+    fi
+
+    # DEFAULT: MEDIUM
+    echo "MEDIUM|User data files"
+}
+
 # shellcheck disable=SC2329
 safe_clean() {
     if [[ $# -eq 0 ]]; then
@@ -319,6 +361,26 @@ safe_clean() {
 
     debug_log "Cleaning: $description (${#existing_paths[@]} items)"
 
+    # Enhanced debug output with risk level and details
+    if [[ "${MO_DEBUG:-}" == "1" && ${#existing_paths[@]} -gt 0 ]]; then
+        # Determine risk level for this cleanup operation
+        local risk_info
+        risk_info=$(classify_cleanup_risk "$description" "${existing_paths[0]}")
+        local risk_level="${risk_info%%|*}"
+        local risk_reason="${risk_info#*|}"
+
+        debug_operation_start "$description"
+        debug_risk_level "$risk_level" "$risk_reason"
+        debug_operation_detail "Item count" "${#existing_paths[@]}"
+
+        # Log sample of files (first 10) with details
+        if [[ ${#existing_paths[@]} -le 10 ]]; then
+            debug_operation_detail "Files to be removed" "All files listed below"
+        else
+            debug_operation_detail "Files to be removed" "Showing first 10 of ${#existing_paths[@]} files"
+        fi
+    fi
+
     if [[ $skipped_count -gt 0 ]]; then
         ((whitelist_skipped_count += skipped_count))
     fi

lib/clean/user.sh

@@ -522,13 +522,25 @@ clean_browsers() {
     safe_clean ~/Library/Caches/company.thebrowser.Browser/* "Arc cache"
     safe_clean ~/Library/Caches/company.thebrowser.dia/* "Dia cache"
     safe_clean ~/Library/Caches/BraveSoftware/Brave-Browser/* "Brave cache"
-    safe_clean ~/Library/Caches/Firefox/* "Firefox cache"
+    local firefox_running=false
+    if pgrep -x "Firefox" > /dev/null 2>&1; then
+        firefox_running=true
+    fi
+    if [[ "$firefox_running" == "true" ]]; then
+        echo -e "  ${YELLOW}${ICON_WARNING}${NC} Firefox is running · cache cleanup skipped"
+    else
+        safe_clean ~/Library/Caches/Firefox/* "Firefox cache"
+    fi
     safe_clean ~/Library/Caches/com.operasoftware.Opera/* "Opera cache"
     safe_clean ~/Library/Caches/com.vivaldi.Vivaldi/* "Vivaldi cache"
     safe_clean ~/Library/Caches/Comet/* "Comet cache"
     safe_clean ~/Library/Caches/com.kagi.kagimacOS/* "Orion cache"
     safe_clean ~/Library/Caches/zen/* "Zen cache"
-    safe_clean ~/Library/Application\ Support/Firefox/Profiles/*/cache2/* "Firefox profile cache"
+    if [[ "$firefox_running" == "true" ]]; then
+        echo -e "  ${YELLOW}${ICON_WARNING}${NC} Firefox is running · profile cache cleanup skipped"
+    else
+        safe_clean ~/Library/Application\ Support/Firefox/Profiles/*/cache2/* "Firefox profile cache"
+    fi
     clean_chrome_old_versions
     clean_edge_old_versions
     clean_edge_updater_old_versions