#!/usr/bin/env bats setup_file() { PROJECT_ROOT="$(cd "${BATS_TEST_DIRNAME}/.." && pwd)" export PROJECT_ROOT ORIGINAL_HOME="${HOME:-}" export ORIGINAL_HOME HOME="$(mktemp -d "${BATS_TEST_DIRNAME}/tmp-user-core.XXXXXX")" export HOME mkdir -p "$HOME" } teardown_file() { rm -rf "$HOME" if [[ -n "${ORIGINAL_HOME:-}" ]]; then export HOME="$ORIGINAL_HOME" fi } @test "clean_user_essentials respects Trash whitelist" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" start_section_spinner() { :; } stop_section_spinner() { :; } safe_clean() { echo "$2"; } note_activity() { :; } is_path_whitelisted() { [[ "$1" == "$HOME/.Trash" ]]; } clean_user_essentials EOF [ "$status" -eq 0 ] # Whitelist-protected items no longer show output (UX improvement in V1.22.0) [[ "$output" != *"Trash"* ]] } @test "clean_app_caches includes macOS system caches" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" stop_section_spinner() { :; } start_section_spinner() { :; } safe_clean() { echo "$2"; } bytes_to_human() { echo "0B"; } note_activity() { :; } files_cleaned=0 total_size_cleaned=0 total_items=0 clean_app_caches EOF [ "$status" -eq 0 ] [[ "$output" == *"Saved application states"* ]] || [[ "$output" == *"App caches"* ]] } @test "clean_support_app_data targets crash, wallpaper, and messages preview caches only" { local support_home="$HOME/support-cache-home-1" run env HOME="$support_home" PROJECT_ROOT="$PROJECT_ROOT" bash --noprofile --norc <<'EOF' set -euo pipefail mkdir -p "$HOME" source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" safe_clean() { echo "$2"; } safe_find_delete() { echo "FIND:$1:$3:$4"; } pgrep() { return 1; } mkdir -p "$HOME/Library/Application Support/CrashReporter" mkdir -p "$HOME/Library/Application Support/com.apple.idleassetsd" clean_support_app_data rm -rf "$HOME/Library/Application Support/CrashReporter" rm -rf "$HOME/Library/Application Support/com.apple.idleassetsd" EOF [ "$status" -eq 0 ] [[ "$output" == *"FIND:$support_home/Library/Application Support/CrashReporter:30:f"* ]] [[ "$output" == *"FIND:$support_home/Library/Application Support/com.apple.idleassetsd:30:f"* ]] [[ "$output" == *"Messages sticker cache"* ]] [[ "$output" == *"Messages preview attachment cache"* ]] [[ "$output" == *"Messages preview sticker cache"* ]] [[ "$output" != *"Messages attachments"* ]] } @test "clean_support_app_data skips messages preview caches while Messages is running" { local support_home="$HOME/support-cache-home-2" run env HOME="$support_home" PROJECT_ROOT="$PROJECT_ROOT" bash --noprofile --norc <<'EOF' set -euo pipefail mkdir -p "$HOME" source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" safe_clean() { echo "$2"; } safe_find_delete() { :; } pgrep() { return 0; } clean_support_app_data EOF [ "$status" -eq 0 ] [[ "$output" == *"Messages is running"* ]] [[ "$output" != *"Messages sticker cache"* ]] [[ "$output" != *"Messages preview attachment cache"* ]] [[ "$output" != *"Messages preview sticker cache"* ]] } @test "clean_app_caches skips protected containers" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" DRY_RUN=true /bin/bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" start_section_spinner() { :; } stop_section_spinner() { :; } bytes_to_human() { echo "0B"; } note_activity() { :; } safe_clean() { :; } should_protect_data() { return 0; } is_critical_system_component() { return 0; } files_cleaned=0 total_size_cleaned=0 total_items=0 mkdir -p "$HOME/Library/Containers/com.example.app/Data/Library/Caches" touch "$HOME/Library/Containers/com.example.app/Data/Library/Caches/test.cache" clean_app_caches EOF [ "$status" -eq 0 ] [[ "$output" != *"App caches"* ]] || [[ "$output" == *"already clean"* ]] } @test "clean_group_container_caches keeps protected caches and cleans non-protected caches" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" DRY_RUN=false /bin/bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" start_section_spinner() { :; } stop_section_spinner() { :; } bytes_to_human() { echo "0B"; } note_activity() { :; } files_cleaned=0 total_size_cleaned=0 total_items=0 mkdir -p "$HOME/Library/Group Containers/group.com.microsoft.teams/Library/Logs" mkdir -p "$HOME/Library/Group Containers/group.com.microsoft.teams/Library/Caches" mkdir -p "$HOME/Library/Group Containers/group.com.example.tool/Library/Caches" echo "log" > "$HOME/Library/Group Containers/group.com.microsoft.teams/Library/Logs/log.txt" echo "cache" > "$HOME/Library/Group Containers/group.com.microsoft.teams/Library/Caches/cache.db" echo "cache" > "$HOME/Library/Group Containers/group.com.example.tool/Library/Caches/cache.db" clean_group_container_caches if [[ ! -e "$HOME/Library/Group Containers/group.com.microsoft.teams/Library/Logs/log.txt" ]] \ && [[ -e "$HOME/Library/Group Containers/group.com.microsoft.teams/Library/Caches/cache.db" ]] \ && [[ ! -e "$HOME/Library/Group Containers/group.com.example.tool/Library/Caches/cache.db" ]]; then echo "PASS" else echo "FAIL" exit 1 fi EOF [ "$status" -eq 0 ] [[ "$output" == *"Group Containers logs/caches"* ]] [[ "$output" == *"PASS"* ]] } @test "clean_group_container_caches respects whitelist entries" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" DRY_RUN=false /bin/bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" start_section_spinner() { :; } stop_section_spinner() { :; } bytes_to_human() { echo "0B"; } note_activity() { :; } files_cleaned=0 total_size_cleaned=0 total_items=0 mkdir -p "$HOME/Library/Group Containers/group.com.example.tool/Library/Caches" echo "protected" > "$HOME/Library/Group Containers/group.com.example.tool/Library/Caches/keep.db" echo "remove" > "$HOME/Library/Group Containers/group.com.example.tool/Library/Caches/drop.db" is_path_whitelisted() { [[ "$1" == *"/group.com.example.tool/Library/Caches/keep.db" ]] } clean_group_container_caches if [[ -e "$HOME/Library/Group Containers/group.com.example.tool/Library/Caches/keep.db" ]] \ && [[ ! -e "$HOME/Library/Group Containers/group.com.example.tool/Library/Caches/drop.db" ]]; then echo "PASS" else echo "FAIL" exit 1 fi EOF [ "$status" -eq 0 ] [[ "$output" == *"PASS"* ]] } @test "clean_group_container_caches skips systemgroup apple containers" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" DRY_RUN=false /bin/bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" start_section_spinner() { :; } stop_section_spinner() { :; } bytes_to_human() { echo "0B"; } note_activity() { :; } files_cleaned=0 total_size_cleaned=0 total_items=0 mkdir -p "$HOME/Library/Group Containers/systemgroup.com.apple.example/Library/Caches" echo "system-data" > "$HOME/Library/Group Containers/systemgroup.com.apple.example/Library/Caches/cache.db" clean_group_container_caches if [[ -e "$HOME/Library/Group Containers/systemgroup.com.apple.example/Library/Caches/cache.db" ]]; then echo "PASS" else echo "FAIL" exit 1 fi EOF [ "$status" -eq 0 ] [[ "$output" == *"PASS"* ]] } @test "clean_group_container_caches does not report when only whitelisted items exist" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" DRY_RUN=false /bin/bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" start_section_spinner() { :; } stop_section_spinner() { :; } bytes_to_human() { echo "0B"; } note_activity() { :; } files_cleaned=0 total_size_cleaned=0 total_items=0 mkdir -p "$HOME/Library/Group Containers/group.com.example.onlywhite/Library/Caches" echo "whitelisted" > "$HOME/Library/Group Containers/group.com.example.onlywhite/Library/Caches/keep.db" is_path_whitelisted() { [[ "$1" == *"/group.com.example.onlywhite/Library/Caches/keep.db" ]] } clean_group_container_caches if [[ -e "$HOME/Library/Group Containers/group.com.example.onlywhite/Library/Caches/keep.db" ]]; then echo "PASS" else echo "FAIL" exit 1 fi EOF [ "$status" -eq 0 ] [[ "$output" == *"PASS"* ]] [[ "$output" != *"Group Containers logs/caches"* ]] } @test "clean_finder_metadata respects protection flag" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" PROTECT_FINDER_METADATA=true /bin/bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" stop_section_spinner() { :; } note_activity() { :; } clean_finder_metadata EOF [ "$status" -eq 0 ] # Whitelist-protected items no longer show output (UX improvement in V1.22.0) [[ "$output" == "" ]] } @test "check_ios_device_backups returns when no backup dir" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" /bin/bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" check_ios_device_backups EOF [ "$status" -eq 0 ] } @test "clean_browsers calls expected cache paths" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" DRY_RUN=true bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" safe_clean() { echo "$2"; } note_activity() { :; } files_cleaned=0 total_size_cleaned=0 total_items=0 clean_browsers EOF [ "$status" -eq 0 ] [[ "$output" == *"Safari cache"* ]] [[ "$output" == *"Firefox cache"* ]] [[ "$output" == *"Puppeteer browser cache"* ]] } @test "clean_application_support_logs skips when no access" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" note_activity() { :; } clean_application_support_logs EOF [ "$status" -eq 0 ] [[ "$output" == *"Skipped: No permission"* ]] } @test "clean_apple_silicon_caches exits when not M-series" { run env HOME="$HOME" PROJECT_ROOT="$PROJECT_ROOT" IS_M_SERIES=false bash --noprofile --norc <<'EOF' set -euo pipefail source "$PROJECT_ROOT/lib/core/common.sh" source "$PROJECT_ROOT/lib/clean/user.sh" safe_clean() { echo "$2"; } clean_apple_silicon_caches EOF [ "$status" -eq 0 ] [[ -z "$output" ]] } @test "clean_user_essentials includes dotfiles in Trash cleanup" { mkdir -p "$HOME/.Trash" touch "$HOME/.Trash/.hidden_file" touch "$HOME/.Trash/.DS_Store" touch "$HOME/.Trash/regular_file.txt" mkdir -p "$HOME/.Trash/.hidden_dir" mkdir -p "$HOME/.Trash/regular_dir" run bash <<'EOF' set -euo pipefail count=0 while IFS= read -r -d '' item; do ((count++)) || true echo "FOUND: $(basename "$item")" done < <(command find "$HOME/.Trash" -mindepth 1 -maxdepth 1 -print0 2> /dev/null || true) echo "COUNT: $count" EOF [ "$status" -eq 0 ] [[ "$output" == *"COUNT: 5"* ]] [[ "$output" == *"FOUND: .hidden_file"* ]] [[ "$output" == *"FOUND: .DS_Store"* ]] [[ "$output" == *"FOUND: .hidden_dir"* ]] [[ "$output" == *"FOUND: regular_file.txt"* ]] }