Implement selective file watching to reduce watchers when --skip-projects or nested .claude exist

[konard]

Summary

Implements selective file watching in watch mode to reduce the number of filesystem watchers when --skip-projects is enabled or nested .claude directories exist, addressing issue #32.

Problem

Previously, watch mode would monitor ALL files and subdirectories recursively in the ~/.claude directory, including:

• Projects folder (even when --skip-projects was used)
• Nested .claude directories (which cause recursive monitoring issues)

This resulted in unnecessary filesystem watchers being created for files that were excluded from backups.

Solution

• Selective Directory Watching: When --skip-projects is enabled or selective filtering is needed, create individual watchers for each subdirectory instead of using recursive watching on the parent
• Projects Folder Exclusion: Skip creating watchers for the projects folder when --skip-projects is enabled
• Nested .claude Directory Filtering: Skip watching nested .claude directories to avoid recursive monitoring issues
• Runtime Filtering: Added shouldIgnoreFileChange() function to filter file change events using the same logic as the archiving process
• Consistent Logic: Uses the same filtering logic already implemented in the archiving process (from PR Fix watch mode issues and recursive .claude directory bug #19)

Key Changes

1. New setupSelectiveWatchers() function: Creates individual watchers for each subdirectory in ~/.claude with selective filtering
2. New shouldIgnoreFileChange() function: Filters file change events at runtime using path analysis
3. Enhanced watch setup logic: Detects when selective watching is needed and switches to selective mode
4. Comprehensive test suite: Added multiple test files to validate the functionality

Testing

• Unit Tests: examples/test-watch-filtering.js - validates file filtering logic
• Integration Tests: examples/test-watcher-setup.js - tests selective watcher setup
• Manual Testing: examples/test-watch-selective-monitoring.sh - helper for manual testing

Benefits

• Reduced Resource Usage: Fewer filesystem watchers when --skip-projects is used
• Better Performance: Eliminates unnecessary monitoring of excluded directories
• Consistency: Watch mode now respects the same filtering rules as backup creation
• Robust: Handles nested .claude directory edge cases

Impact

• Backwards Compatible: No changes to existing CLI interface or behavior
• Transparent: Users will see improved performance without changing their workflow
• Debug Friendly: Verbose mode shows which directories are being watched vs skipped

Fixes #32

🤖 Generated with Claude Code