# viniciuslopesgit/prune architecture

> Architecture diagram of the GitHub repository viniciuslopesgit/prune, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/viniciuslopesgit/prune
- Repository: https://github.com/viniciuslopesgit/prune

## Overview

Prune is a native macOS maintenance and privacy app. Users choose Smart Scan or a feature, review scan results, then confirm cleanup or another operation; the README emphasizes that deletion is never automatic. The graph preserves the documented cleanup, privacy, system, application, file-management, dashboard, and menu-bar capabilities. Relationships are limited to README statements and SOURCE INDEX references; unsampled feature internals are represented by their exact enclosing directories.

Main entry points: [`Sources/Prune/App/AppState.swift`](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/App/AppState.swift) (App state), [`Sources/Prune/Core/Cleaning/Cleaner.swift`](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Cleaning/Cleaner.swift) (Confirmed cleaner), [`Sources/Prune/Core/Shell.swift`](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Shell.swift) (Command runner), [`Sources/Prune/Core/Cleaning/CleanItem.swift`](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Cleaning/CleanItem.swift) (Reviewable items)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_appstate["App state<br/>[AppState.swift]"]
  node_navigation["App navigation<br/>[ContentView.swift]"]
  node_smartscan["Smart Scan"]
  node_permissions["Full Disk Access<br/>[Permissions.swift]"]
  node_shell["Command runner<br/>[Shell.swift]"]
end

subgraph group_cleanup["Cleanup and privacy"]
  node_cleanupui["Cleanup interface"]
  node_cleanupmodel["Cleanup workflow<br/>[CleanupModel.swift]"]
  node_cleaner["Confirmed cleaner<br/>[Cleaner.swift]"]
  node_cleanitems["Reviewable items<br/>[CleanItem.swift]"]
  node_junk["Junk scanners"]
  node_privacy["Privacy scanner"]
  node_safety["Deletion safeguards<br/>[SafetyGuard.swift]"]
end

subgraph group_system["System monitoring"]
  node_dashboard["Dashboard"]
  node_stats["System statistics<br/>[SystemStats.swift]"]
  node_protection["Protection status"]
  node_optimization["System optimization"]
  node_maintenance["Maintenance tasks"]
  node_menubar["Menu bar<br/>[MenuBarView.swift]"]
end

subgraph group_apps["Application management"]
  node_uninstaller["App scanner<br/>[AppScanner.swift]"]
  node_updater["App updates"]
  node_extensions["Extensions"]
end

subgraph group_files["File tools"]
  node_spacelens["Disk map"]
  node_largefiles["Large files"]
  node_duplicates["Duplicate files"]
  node_shredder["Secure shredding<br/>[Shredder.swift]"]
end

node_user(("Mac user"))

node_user -->|"uses"| node_navigation
node_navigation -->|"selects modules"| node_appstate
node_appstate -->|"owns model"| node_smartscan
node_appstate -->|"creates workflows"| node_cleanupmodel
node_appstate -->|"configures scanner"| node_junk
node_appstate -->|"configures scanner"| node_privacy
node_appstate -->|"owns model"| node_optimization
node_appstate -->|"owns model"| node_maintenance
node_appstate -->|"owns model"| node_uninstaller
node_appstate -->|"owns model"| node_updater
node_appstate -->|"owns model"| node_extensions
node_appstate -->|"owns model"| node_spacelens
node_appstate -->|"owns model"| node_largefiles
node_appstate -->|"owns model"| node_duplicates
node_appstate -->|"owns model"| node_shredder
node_cleanupui -.->|"presents workflow"| node_cleanupmodel
node_cleanupmodel -->|"invokes cleanup"| node_cleaner
node_cleaner -->|"processes items"| node_cleanitems
node_cleaner -->|"checks paths"| node_safety
node_cleaner -->|"runs commands"| node_shell
node_junk -->|"produces candidates"| node_cleanitems
node_privacy -->|"produces candidates"| node_cleanitems
node_dashboard -->|"reads metrics"| node_stats
node_dashboard -->|"reads status"| node_protection
node_optimization -->|"runs commands"| node_shell
node_uninstaller -->|"finds leftovers"| node_cleanitems
node_uninstaller -->|"checks paths"| node_safety
node_extensions -->|"runs commands"| node_shell
node_shredder -->|"checks paths"| node_safety
node_permissions -->|"checks access"| node_shell
node_menubar -->|"shows metrics"| node_stats

click node_appstate "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/App/AppState.swift"
click node_navigation "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/App/ContentView.swift"
click node_smartscan "https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/SmartScan"
click node_cleanupui "https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/Cleanup"
click node_cleanupmodel "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Cleaning/CleanupModel.swift"
click node_cleaner "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Cleaning/Cleaner.swift"
click node_cleanitems "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Cleaning/CleanItem.swift"
click node_junk "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Cleanup/SystemJunkScanner.swift"
click node_privacy "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Privacy/PrivacyScanner.swift"
click node_dashboard "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Dashboard/DashboardView.swift"
click node_stats "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/SystemStats.swift"
click node_protection "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/SystemProtection.swift"
click node_optimization "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Optimization/OptimizationService.swift"
click node_maintenance "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Maintenance/MaintenanceTasks.swift"
click node_menubar "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/MenuBar/MenuBarView.swift"
click node_uninstaller "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Uninstaller/AppScanner.swift"
click node_updater "https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/Updater"
click node_extensions "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Extensions/ExtensionService.swift"
click node_spacelens "https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/SpaceLens"
click node_largefiles "https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/LargeFiles"
click node_duplicates "https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/Duplicates"
click node_shredder "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Shredder/Shredder.swift"
click node_permissions "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Permissions.swift"
click node_safety "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/SafetyGuard.swift"
click node_shell "https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Shell.swift"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_appstate,node_navigation,node_smartscan,node_permissions,node_shell,node_user toneBlue
class node_cleanupui,node_cleanupmodel,node_cleaner,node_cleanitems,node_junk,node_privacy,node_safety toneAmber
class node_dashboard,node_stats,node_protection,node_optimization,node_maintenance,node_menubar toneMint
class node_uninstaller,node_updater,node_extensions toneRose
class node_spacelens,node_largefiles,node_duplicates,node_shredder toneIndigo
```

## Components

### App and navigation

- [App state](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/App/AppState.swift): `Sources/Prune/App/AppState.swift`
- [App navigation](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/App/ContentView.swift): `Sources/Prune/App/ContentView.swift`
- [Smart Scan](https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/SmartScan): `Sources/Prune/Features/SmartScan`
- [Full Disk Access](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Permissions.swift): `Sources/Prune/Core/Permissions.swift`
- [Command runner](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Shell.swift): `Sources/Prune/Core/Shell.swift`

### Cleanup and privacy

- [Cleanup interface](https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/Cleanup): `Sources/Prune/Features/Cleanup`
- [Cleanup workflow](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Cleaning/CleanupModel.swift): `Sources/Prune/Core/Cleaning/CleanupModel.swift`
- [Confirmed cleaner](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Cleaning/Cleaner.swift): `Sources/Prune/Core/Cleaning/Cleaner.swift`
- [Reviewable items](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/Cleaning/CleanItem.swift): `Sources/Prune/Core/Cleaning/CleanItem.swift`
- [Junk scanners](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Cleanup/SystemJunkScanner.swift): `Sources/Prune/Features/Cleanup/SystemJunkScanner.swift`
- [Privacy scanner](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Privacy/PrivacyScanner.swift): `Sources/Prune/Features/Privacy/PrivacyScanner.swift`
- [Deletion safeguards](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/SafetyGuard.swift): `Sources/Prune/Core/SafetyGuard.swift`

### System monitoring

- [Dashboard](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Dashboard/DashboardView.swift): `Sources/Prune/Features/Dashboard/DashboardView.swift`
- [System statistics](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/SystemStats.swift): `Sources/Prune/Core/SystemStats.swift`
- [Protection status](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Core/SystemProtection.swift): `Sources/Prune/Core/SystemProtection.swift`
- [System optimization](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Optimization/OptimizationService.swift): `Sources/Prune/Features/Optimization/OptimizationService.swift`
- [Maintenance tasks](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Maintenance/MaintenanceTasks.swift): `Sources/Prune/Features/Maintenance/MaintenanceTasks.swift`
- [Menu bar](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/MenuBar/MenuBarView.swift): `Sources/Prune/Features/MenuBar/MenuBarView.swift`

### Application management

- [App scanner](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Uninstaller/AppScanner.swift): `Sources/Prune/Features/Uninstaller/AppScanner.swift`
- [App updates](https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/Updater): `Sources/Prune/Features/Updater`
- [Extensions](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Extensions/ExtensionService.swift): `Sources/Prune/Features/Extensions/ExtensionService.swift`

### File tools

- [Disk map](https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/SpaceLens): `Sources/Prune/Features/SpaceLens`
- [Large files](https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/LargeFiles): `Sources/Prune/Features/LargeFiles`
- [Duplicate files](https://github.com/viniciuslopesgit/prune/tree/main/Sources/Prune/Features/Duplicates): `Sources/Prune/Features/Duplicates`
- [Secure shredding](https://github.com/viniciuslopesgit/prune/blob/main/Sources/Prune/Features/Shredder/Shredder.swift): `Sources/Prune/Features/Shredder/Shredder.swift`

### Other components

- **Mac user**

## Connections

- Mac user → App navigation: uses (evidence: `README.md`)
- App navigation → App state: selects modules (evidence: `Sources/Prune/App/ContentView.swift`)
- App state → Smart Scan: owns model (evidence: `Sources/Prune/App/AppState.swift`)
- App state → Cleanup workflow: creates workflows (evidence: `Sources/Prune/App/AppState.swift`)
- App state → Junk scanners: configures scanner (evidence: `Sources/Prune/App/AppState.swift`)
- App state → Privacy scanner: configures scanner (evidence: `Sources/Prune/App/AppState.swift`)
- App state → System optimization: owns model (evidence: `Sources/Prune/App/AppState.swift`)
- App state → Maintenance tasks: owns model (evidence: `Sources/Prune/App/AppState.swift`)
- App state → App scanner: owns model (evidence: `Sources/Prune/App/AppState.swift`)
- App state → App updates: owns model (evidence: `Sources/Prune/App/AppState.swift`)
- App state → Extensions: owns model (evidence: `Sources/Prune/App/AppState.swift`)
- App state → Disk map: owns model (evidence: `Sources/Prune/App/AppState.swift`)
- App state → Large files: owns model (evidence: `Sources/Prune/App/AppState.swift`)
- App state → Duplicate files: owns model (evidence: `Sources/Prune/App/AppState.swift`)
- App state → Secure shredding: owns model (evidence: `Sources/Prune/App/AppState.swift`)
- Cleanup interface → Cleanup workflow: presents workflow
- Cleanup workflow → Confirmed cleaner: invokes cleanup (evidence: `Sources/Prune/Core/Cleaning/CleanupModel.swift`)
- Confirmed cleaner → Reviewable items: processes items (evidence: `Sources/Prune/Core/Cleaning/Cleaner.swift`)
- Confirmed cleaner → Deletion safeguards: checks paths (evidence: `Sources/Prune/Core/Cleaning/Cleaner.swift`)
- Confirmed cleaner → Command runner: runs commands (evidence: `Sources/Prune/Core/Cleaning/Cleaner.swift`)
- Junk scanners → Reviewable items: produces candidates (evidence: `Sources/Prune/Features/Cleanup/SystemJunkScanner.swift`)
- Privacy scanner → Reviewable items: produces candidates (evidence: `Sources/Prune/Features/Privacy/PrivacyScanner.swift`)
- Dashboard → System statistics: reads metrics (evidence: `Sources/Prune/Features/Dashboard/DashboardView.swift`)
- Dashboard → Protection status: reads status (evidence: `Sources/Prune/Features/Dashboard/DashboardView.swift`)
- System optimization → Command runner: runs commands (evidence: `Sources/Prune/Features/Optimization/OptimizationService.swift`)
- App scanner → Reviewable items: finds leftovers (evidence: `Sources/Prune/Features/Uninstaller/AppScanner.swift`)
- App scanner → Deletion safeguards: checks paths (evidence: `Sources/Prune/Features/Uninstaller/AppScanner.swift`)
- Extensions → Command runner: runs commands (evidence: `Sources/Prune/Features/Extensions/ExtensionService.swift`)
- Secure shredding → Deletion safeguards: checks paths (evidence: `Sources/Prune/Features/Shredder/Shredder.swift`)
- Full Disk Access → Command runner: checks access (evidence: `Sources/Prune/Core/Permissions.swift`)
- Menu bar → System statistics: shows metrics (evidence: `Sources/Prune/Features/MenuBar/MenuBarView.swift`)
