How tiavina22/hoopix works
Hoopix is a macOS maintenance and system-visibility app. Users navigate its sections to inspect system state or discover cleanup, uninstall, and project-artifact targets; review a plan or confirmation; then approve changes, with operations recorded for History. Analyze also scans disk usage and moves selected items to Trash, while Optimize runs bounded maintenance tasks. The README documents a presentation/domain/data architecture and shared macOS process and file-operation support. Feature wiring is represented at subsystem level; sampled source primarily confirms native privileged deletion and Trash behavior.
Main entry points: app_shell.dart Section navigation · process_runner.dart Process runner · data Clean discovery and removal · optimize_task_runner.dart Task execution
Components 29
App interface
- App entry
lib/app.dart - Section navigation
lib/core/navigation/app_shell.dart - Clean review
lib/features/clean/presentation - Uninstall review
lib/features/uninstall/presentation - Purge review
lib/features/purge/presentation - Optimize controls
lib/features/optimize/presentation - Disk explorer
lib/features/analyze/presentation - Live status
lib/features/status/presentation - Operation history
lib/features/history/presentation
Maintenance actions
- Clean planning
lib/features/clean/domain/usecases - Clean discovery and removal
lib/features/clean/data - Uninstall discovery
lib/features/uninstall/domain/usecases - App removal actions
lib/features/uninstall/data - Artifact planning
lib/features/purge/domain/usecases - Artifact deletion
lib/features/purge/data - Maintenance tasks
lib/features/optimize/domain/usecases/run_optimize.dart - Task execution
lib/features/optimize/data/datasources/optimize_task_runner.dart
Inspection and history
- Disk scan operations
lib/features/analyze/domain/usecases - Disk scan sources
lib/features/analyze/data - System snapshot
lib/features/status/domain/usecases/watch_system_status.dart - System probes
lib/features/status/data/datasources - History reader
lib/features/history/data
Shared runtime
- Process runner
lib/core/process/process_runner.dart - File and system operations
lib/core/platform - Protected Trash channel
macos/Runner/TrashChannel.swift - Privileged delete channel
macos/Runner/PrivilegedDeleteChannel.swift
Other components
- Mac user
- macOS tools and filesystem
- Operation log
Connections 45
- Mac user → App entry: launches
- App entry → Section navigation: builds interface
- Mac user → Section navigation: selects section
- Section navigation → Clean review: shows
- Section navigation → Uninstall review: shows
- Section navigation → Purge review: shows
- Section navigation → Optimize controls: shows
- Section navigation → Disk explorer: shows
- Section navigation → Live status: shows
- Section navigation → Operation history: shows
- Clean review → Clean planning: requests plan
- Clean planning → Clean discovery and removal: requests discovery
- Clean review → Clean discovery and removal: approves removal
- Uninstall review → Uninstall discovery: requests inventory
- Uninstall discovery → App removal actions: discovers app
- Uninstall review → App removal actions: approves uninstall
- Purge review → Artifact planning: requests plan
- Artifact planning → Artifact deletion: discovers artifacts
- Purge review → Artifact deletion: approves deletion
- Optimize controls → Maintenance tasks: starts tasks
- Maintenance tasks → Task execution: dispatches tasks
- Disk explorer → Disk scan operations: requests scan
- Disk scan operations → Disk scan sources: requests filesystem data
- Disk explorer → File and system operations: requests Trash move
- Live status → System snapshot: watches status
- System snapshot → System probes: requests probes
- Operation history → History reader: fetches records
- Clean discovery and removal → Process runner: runs commands
- App removal actions → Process runner: runs commands
- Artifact deletion → Process runner: runs commands
- Task execution → Process runner: runs commands
- System probes → Process runner: runs probes
- Disk scan sources → File and system operations: scans paths
- File and system operations → Protected Trash channel: invokes channel
- Clean discovery and removal → Privileged delete channel: requests privileged delete
- Task execution → Privileged delete channel: requests privileged task
- Process runner → macOS tools and filesystem: runs native tools
- File and system operations → macOS tools and filesystem: reads and moves files
- Protected Trash channel → macOS tools and filesystem: moves to Trash
- Privileged delete channel → macOS tools and filesystem: deletes allowlisted paths
- Clean discovery and removal → Operation log: records operations
- App removal actions → Operation log: records operations
- Artifact deletion → Operation log: records operations
- Task execution → Operation log: records operations
- History reader → Operation log: reads operations