feat: skip already-excluded directories for faster subsequent runs

Use Spotlight metadata (mdfind) to identify directories already excluded
from Time Machine and skip them during the find traversal. Also fixes a
comment typo and removes duplicate Gradle sentinel entries.

Inspired by stevegrunwell#97, props @VladRassokhin.

Author: django23

CHANGELOG.md

@@ -32,11 +32,17 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ### Changed
 
+* Skip directories already excluded from Time Machine backups for faster subsequent runs (inspired by [stevegrunwell/asimov#97], props @VladRassokhin)
 * Migrated test suite from PHP/PHPUnit to [Bats](https://github.com/bats-core/bats-core) (Bash Automated Testing System), removing the PHP dependency for contributors
 * Replaced Travis CI pipeline with GitHub Actions (macOS 14 + 15 matrix)
 * Replaced PHP `tmutil` mock with a pure bash implementation
 * Moved install script to `scripts/install.sh` with shared variables, now copies binary instead of symlinking ([#35], props @sylver)
 
+### Fixed
+
+* Fixed duplicate Gradle sentinel entries in the sentinels list
+* Fixed typo in comment ("decendents" → "descendants")
+
 ### Removed
 
 * Removed PHP test infrastructure (`composer.json`, `phpunit.xml.dist`, and PHP test files)
@@ -117,3 +123,4 @@ Initial public release.
 [#55]: https://github.com/stevegrunwell/asimov/pull/55
 [#35]: https://github.com/stevegrunwell/asimov/pull/35
 [#56]: https://github.com/stevegrunwell/asimov/pull/56
+[stevegrunwell/asimov#97]: https://github.com/stevegrunwell/asimov/pull/97

Makefile

@@ -9,7 +9,7 @@ test: ## Run Bats tests
 	@bats tests/sentinels.bats tests/behavior.bats
 
 lint: ## Run Shellcheck on all shell scripts
-	@shellcheck asimov scripts/install.sh scripts/uninstall.sh tests/bin/run-tests.sh tests/bin/tmutil
+	@shellcheck asimov scripts/install.sh scripts/uninstall.sh tests/bin/run-tests.sh tests/bin/tmutil tests/bin/mdfind
 
 check: test lint ## Run tests and linting
 

asimov

@@ -20,7 +20,7 @@ set -Eeu -o pipefail
 readonly ASIMOV_ROOT=~
 
 # Paths to unconditionally skip over. This prevents Asimov from modifying the
-# Time Machine exclusions for these paths (and decendents). It has an important
+# Time Machine exclusions for these paths (and descendants). It has an important
 # side-effect of speeding up the search.
 readonly ASIMOV_SKIP_PATHS=(
     ~/.Trash
@@ -50,8 +50,6 @@ readonly ASIMOV_VENDOR_DIR_SENTINELS=(
     'Carthage Cartfile'                # Carthage
     'Pods Podfile'                     # CocoaPods
     'bower_components bower.json'      # Bower (JavaScript)
-    'build build.gradle'               # Gradle
-    'build build.gradle.kts'           # Gradle Kotlin Script
     'build pubspec.yaml'               # Flutter (Dart)
     'build setup.py'                   # Python
     'dist setup.py'                    # PyPI Publishing (Python)
@@ -116,6 +114,13 @@ for d in "${ASIMOV_SKIP_PATHS[@]}"; do
     find_parameters_skip+=( -not \( -path "${d}" -prune \) )
 done
 
+# Skip directories already excluded from Time Machine backups.
+# Uses Spotlight metadata which may not report all exclusions — any missed
+# directories are still handled by the tmutil isexcluded check in exclude_file().
+while IFS= read -r line; do
+    [[ -n "$line" ]] && find_parameters_skip+=( -not \( -path "${line}" -prune \) )
+done < <(mdfind -onlyin "${ASIMOV_ROOT}" "com_apple_backup_excludeItem = 'com.apple.backupd'" 2>/dev/null | sort -u)
+
 # Iterate over the directory/sentinel pairs to construct the `find` expression.
 declare -a find_parameters_vendor=()
 for i in "${ASIMOV_VENDOR_DIR_SENTINELS[@]}"; do

tests/behavior.bats

@@ -127,3 +127,27 @@ load test_helper
   refute_excluded "${HOME}/Code/My-Project/node_modules/dep/node_modules"
   [[ "$(count_exclusions)" -eq 1 ]]
 }
+
+# =============================================================================
+# Skip already-excluded directories (mdfind optimization)
+# =============================================================================
+
+@test "skips directories already excluded from Time Machine" {
+  create_project "Code/Already-Excluded" "package.json" "node_modules"
+  create_project "Code/New-Project" "package.json" "node_modules"
+
+  # Pre-exclude the first project manually
+  echo "${HOME}/Code/Already-Excluded/node_modules" > "$ASIMOV_TEST_EXCLUSIONS"
+
+  # Tell mock mdfind to report it as already excluded
+  ASIMOV_TEST_MDFIND_RESULTS="${TEST_TEMP_DIR}/.mdfind_results"
+  export ASIMOV_TEST_MDFIND_RESULTS
+  echo "${HOME}/Code/Already-Excluded" > "$ASIMOV_TEST_MDFIND_RESULTS"
+
+  run_asimov
+
+  # The new project should be excluded
+  assert_excluded "${HOME}/Code/New-Project/node_modules"
+  # The already-excluded one should still only have 1 entry (not duplicated)
+  [[ "$(count_exclusions)" -eq 2 ]]
+}

tests/bin/mdfind

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+# Mock mdfind for testing — returns nothing by default.
+# Set ASIMOV_TEST_MDFIND_RESULTS to a file path to return its contents.
+set -euo pipefail
+
+if [[ -n "${ASIMOV_TEST_MDFIND_RESULTS:-}" && -f "${ASIMOV_TEST_MDFIND_RESULTS}" ]]; then
+    cat "${ASIMOV_TEST_MDFIND_RESULTS}"
+fi