merge: Integrate multi-ecosystem scanner support v1.0.1

- Add 7 new scanner types: Flutter, Go, Python, Rust, Homebrew, Docker, Java/Kotlin
- Total 10 ecosystem scanners now supported (iOS, Android, Node + 7 new)
- Enhanced TUI with new scanner types
- All tests passing, 35 items scannable (43.2 GB)
- Version bumped to 1.0.1
- Documentation archived and updated

Author: thanhdevapp

.gitignore

@@ -58,7 +58,6 @@ GoogleService-Info.plist
 
 repomix-output.xml
 .serena/cache
-plans/**/*
 !plans/templates/*
 screenshots/*
 docs/screenshots/*
@@ -77,6 +76,11 @@ dev-cleaner
 .claude/settings.bak.json
 .claude
 CLAUDE.md
-plans
-docs
-design-mockups
+# plans
+# docs
+design-mockups
+/plans/templates/
+/.idea/git_toolbox_prj.xml
+/.idea/mac-dev-cleaner-cli.iml
+/.idea/modules.xml
+/.idea/vcs.xml

.idea/.gitignore

@@ -12,6 +12,13 @@ Mac Dev Cleaner is a CLI tool that helps developers reclaim disk space by removi
 - **Xcode** - DerivedData, Archives, Caches
 - **Android** - Gradle caches, SDK caches
 - **Node.js** - node_modules, npm/yarn/pnpm/bun caches
+- **Flutter/Dart** - .pub-cache, .dart_tool, build artifacts
+- **Python** - pip/poetry/uv caches, virtualenvs, __pycache__
+- **Rust** - Cargo registry, git caches, target directories
+- **Go** - build cache, module cache
+- **Homebrew** - download caches
+- **Docker** - unused images, containers, volumes, build cache
+- **Java/Kotlin** - Maven .m2, Gradle caches, build directories
 
 ## Installation
 
@@ -43,6 +50,13 @@ dev-cleaner scan
 dev-cleaner scan --ios
 dev-cleaner scan --android
 dev-cleaner scan --node
+dev-cleaner scan --flutter
+dev-cleaner scan --python
+dev-cleaner scan --rust
+dev-cleaner scan --go
+dev-cleaner scan --homebrew
+dev-cleaner scan --docker
+dev-cleaner scan --java
 ```
 
 **Example Output:**
@@ -102,6 +116,56 @@ dev-cleaner clean --ios --confirm
 - `~/.yarn/cache/`
 - `~/.bun/install/cache/`
 
+### Flutter/Dart
+- `~/.pub-cache/`
+- `~/.dart_tool/`
+- `~/Library/Caches/Flutter/`
+- `~/Library/Caches/dart/`
+- `*/build/` (in Flutter projects)
+- `*/.dart_tool/` (in Flutter projects)
+- `*/ios/build/`, `*/android/build/` (in Flutter projects)
+
+### Python
+- `~/.cache/pip/` (pip cache)
+- `~/.cache/pypoetry/` (Poetry cache)
+- `~/.cache/uv/` (uv cache)
+- `~/.cache/pdm/` (pdm cache)
+- `*/__pycache__/` (bytecode cache)
+- `*/venv/`, `*/.venv/` (virtual environments)
+- `*/.pytest_cache/` (pytest cache)
+- `*/.tox/` (tox environments)
+- `*/.mypy_cache/`, `*/.ruff_cache/` (linter caches)
+
+### Rust/Cargo
+- `~/.cargo/registry/` (package registry)
+- `~/.cargo/git/` (git dependencies)
+- `*/target/` (build artifacts, in Rust projects with Cargo.toml)
+
+### Go
+- `~/Library/Caches/go-build/` (build cache, or `$GOCACHE`)
+- `~/go/pkg/mod/` (module cache, or `$GOMODCACHE`)
+
+### Homebrew
+- `~/Library/Caches/Homebrew/` (user cache)
+- `/opt/homebrew/Library/Caches/Homebrew/` (Apple Silicon)
+- `/usr/local/Homebrew/Library/Caches/Homebrew/` (Intel)
+
+### Docker
+- Unused images (via `docker image prune`)
+- Stopped containers (via `docker container prune`)
+- Unused volumes (via `docker volume prune`)
+- Build cache (via `docker builder prune`)
+
+**Note:** Requires Docker daemon to be running.
+
+### Java/Kotlin
+- `~/.m2/repository/` (Maven local repository)
+- `~/.gradle/wrapper/` (Gradle wrapper distributions)
+- `~/.gradle/daemon/` (Gradle daemon logs)
+- `*/target/` (Maven build directories, with pom.xml)
+- `*/build/` (Gradle build directories, with build.gradle)
+- `*/.gradle/` (Project Gradle cache)
+
 ## Development
 
 ```bash
@@ -118,10 +182,11 @@ go test ./...
 ## Roadmap
 
 - [x] MVP: Scan and clean commands
-- [ ] TUI with interactive selection (BubbleTea)
+- [x] TUI with interactive selection (BubbleTea)
+- [x] Support for 10 development ecosystems
 - [ ] Config file support
 - [ ] Homebrew distribution
-- [ ] Progress bars
+- [ ] Scheduled automatic cleanup
 
 ## License
 

README.md

@@ -16,28 +16,77 @@ import (
 )
 
 var (
-	dryRun       bool
-	confirmFlag  bool
-	cleanIOS     bool
-	cleanAndroid bool
-	cleanNode    bool
-	useTUI       bool
+	dryRun        bool
+	confirmFlag   bool
+	cleanIOS      bool
+	cleanAndroid  bool
+	cleanNode     bool
+	cleanFlutter  bool
+	cleanPython   bool
+	cleanRust     bool
+	cleanGo       bool
+	cleanHomebrew bool
+	cleanDocker   bool
+	cleanJava     bool
+	useTUI        bool
 )
 
 // cleanCmd represents the clean command
 var cleanCmd = &cobra.Command{
-	Use:   "clean",
+	Use:   "clean [flags]",
 	Short: "Clean development artifacts",
 	Long: `Interactively select and clean development artifacts.
 
-By default, runs in TUI mode with interactive selection.
-Use --confirm to actually delete files (default is dry-run).
+By default, runs in TUI mode with interactive selection and dry-run
+enabled (preview only). Use --confirm to actually delete files.
+
+The TUI provides:
+  • Real-time deletion progress with package-manager style output
+  • Tree navigation for exploring nested folders
+  • Quick single-item cleanup or batch operations
+  • All operations logged to ~/.dev-cleaner.log
+
+Safety Features:
+  ✓ Dry-run mode by default (files are safe)
+  ✓ Confirmation required before deletion
+  ✓ Path validation (never touches system files)
+  ✓ All actions logged for audit trail
 
 Examples:
-  dev-cleaner clean              # Interactive TUI (dry-run)
-  dev-cleaner clean --confirm    # Interactive TUI (actually delete)
-  dev-cleaner clean --no-tui     # Simple text mode
-  dev-cleaner clean --ios        # Clean iOS artifacts only`,
+  dev-cleaner clean                   # Interactive TUI (dry-run)
+  dev-cleaner clean --confirm         # Interactive TUI (actually delete)
+  dev-cleaner clean --no-tui          # Simple text mode
+  dev-cleaner clean --ios --confirm   # Clean iOS artifacts only
+  dev-cleaner clean --node            # Preview Node.js cleanup (dry-run)
+
+Flags:
+  --confirm         Actually delete files (disables dry-run)
+  --dry-run         Preview only, don't delete (default: true)
+  --ios             Clean iOS/Xcode artifacts only
+  --android         Clean Android/Gradle artifacts only
+  --node            Clean Node.js artifacts only
+  --flutter         Clean Flutter/Dart artifacts only
+  --python          Clean Python caches
+  --rust            Clean Rust/Cargo caches
+  --go              Clean Go caches
+  --homebrew        Clean Homebrew caches
+  --docker          Clean Docker images, containers, volumes
+  --java            Clean Maven/Gradle caches
+  --no-tui, -T      Disable TUI, use simple text mode
+  --tui             Use interactive TUI mode (default: true)
+
+TUI Keyboard Shortcuts:
+  c            Quick clean current item (ignores selections)
+  Enter        Clean all selected items (batch mode)
+  Space        Toggle selection
+  a/n          Select all / none
+  →/l          Enter tree mode (explore folders)
+  ?            Show help screen
+
+Important:
+  • 'c' clears all selections and cleans ONLY the current item
+  • 'Enter' cleans ALL selected items (batch operation)
+  • Tree mode allows deletion at any folder level`,
 	Run: runClean,
 }
 
@@ -49,6 +98,13 @@ func init() {
 	cleanCmd.Flags().BoolVar(&cleanIOS, "ios", false, "Clean iOS/Xcode artifacts only")
 	cleanCmd.Flags().BoolVar(&cleanAndroid, "android", false, "Clean Android/Gradle artifacts only")
 	cleanCmd.Flags().BoolVar(&cleanNode, "node", false, "Clean Node.js artifacts only")
+	cleanCmd.Flags().BoolVar(&cleanFlutter, "flutter", false, "Clean Flutter/Dart artifacts only")
+	cleanCmd.Flags().BoolVar(&cleanPython, "python", false, "Clean Python caches")
+	cleanCmd.Flags().BoolVar(&cleanRust, "rust", false, "Clean Rust/Cargo caches")
+	cleanCmd.Flags().BoolVar(&cleanGo, "go", false, "Clean Go caches")
+	cleanCmd.Flags().BoolVar(&cleanHomebrew, "homebrew", false, "Clean Homebrew caches")
+	cleanCmd.Flags().BoolVar(&cleanDocker, "docker", false, "Clean Docker images, containers, volumes")
+	cleanCmd.Flags().BoolVar(&cleanJava, "java", false, "Clean Maven/Gradle caches")
 	cleanCmd.Flags().BoolVar(&useTUI, "tui", true, "Use interactive TUI mode (default)")
 	cleanCmd.Flags().BoolP("no-tui", "T", false, "Disable TUI, use simple text mode")
 }
@@ -76,14 +132,23 @@ func runClean(cmd *cobra.Command, args []string) {
 		MaxDepth: 3,
 	}
 
-	if cleanIOS || cleanAndroid || cleanNode {
+	specificFlagSet := cleanIOS || cleanAndroid || cleanNode || cleanFlutter ||
+		cleanPython || cleanRust || cleanGo || cleanHomebrew ||
+		cleanDocker || cleanJava
+
+	if specificFlagSet {
 		opts.IncludeXcode = cleanIOS
 		opts.IncludeAndroid = cleanAndroid
 		opts.IncludeNode = cleanNode
+		opts.IncludeFlutter = cleanFlutter
+		opts.IncludePython = cleanPython
+		opts.IncludeRust = cleanRust
+		opts.IncludeGo = cleanGo
+		opts.IncludeHomebrew = cleanHomebrew
+		opts.IncludeDocker = cleanDocker
+		opts.IncludeJava = cleanJava
 	} else {
-		opts.IncludeXcode = true
-		opts.IncludeAndroid = true
-		opts.IncludeNode = true
+		opts = types.DefaultScanOptions()
 	}
 
 	ui.PrintHeader("Scanning for development artifacts...")
@@ -104,7 +169,7 @@ func runClean(cmd *cobra.Command, args []string) {
 
 	// Use TUI or simple mode
 	if useTUI {
-		if err := tui.Run(results, dryRun); err != nil {
+		if err := tui.Run(results, dryRun, Version); err != nil {
 			fmt.Fprintf(os.Stderr, "TUI error: %v\n", err)
 			os.Exit(1)
 		}

cmd/root/clean.go

@@ -10,7 +10,7 @@ import (
 
 var (
 	// Version is set at build time
-	Version = "dev"
+	Version = "1.0.1"
 )
 
 // rootCmd represents the base command
@@ -20,16 +20,47 @@ var rootCmd = &cobra.Command{
 	Long: `Mac Dev Cleaner - A CLI tool to clean development project artifacts
 
 Quickly free up disk space by removing:
-  • Xcode DerivedData and caches
-  • Android Gradle caches
+  • Xcode DerivedData, Archives, and caches
+  • Android Gradle caches and SDK artifacts
   • Node.js node_modules directories
   • Package manager caches (npm, yarn, pnpm, bun)
+  • Flutter/Dart build artifacts and pub-cache
 
-Examples:
-  dev-cleaner scan              # Scan and show all cleanable items
-  dev-cleaner scan --ios        # Scan iOS/Xcode only
-  dev-cleaner clean             # Interactive clean (dry-run by default)
-  dev-cleaner clean --confirm   # Actually delete selected items`,
+Features:
+  ✨ Interactive TUI with keyboard navigation
+  ✨ Tree mode for exploring nested folders
+  ✨ Dry-run mode by default (safe preview)
+  ✨ Quick clean with single keypress
+  ✨ Batch operations for multiple items
+  ✨ Real-time deletion progress tracking
+
+Scan Examples:
+  dev-cleaner scan                    # Scan all + launch TUI
+  dev-cleaner scan --ios              # Scan iOS/Xcode only
+  dev-cleaner scan --android          # Scan Android/Gradle only
+  dev-cleaner scan --node             # Scan Node.js artifacts only
+  dev-cleaner scan --flutter          # Scan Flutter/Dart only
+  dev-cleaner scan --no-tui           # Text output without TUI
+
+Clean Examples:
+  dev-cleaner clean                   # Interactive TUI (dry-run)
+  dev-cleaner clean --confirm         # Interactive TUI (actually delete)
+  dev-cleaner clean --ios --confirm   # Clean iOS artifacts only
+  dev-cleaner clean --no-tui          # Simple text mode cleanup
+
+TUI Keyboard Shortcuts:
+  ↑/↓, k/j     Navigate up/down
+  Space        Toggle selection
+  a            Select all items
+  n            Deselect all items
+  c            Quick clean current item (single-item mode)
+  Enter        Clean all selected items (batch mode)
+  →/l          Drill down into folder (tree mode)
+  ←/h          Go back to parent (in tree mode)
+  ?            Show detailed help screen
+  q            Quit
+
+Tip: Use 'dev-cleaner scan' to start the interactive TUI mode!`,
 	Version: Version,
 }