Repository Public License
1<!-- ORIX Clean / File: docs/research/competitive-analysis.md / Author: Simon-Pierre Boucher / Contact: contact@spboucher.ai -->2# Competitive analysis34A comparison of approaches in the macOS storage-utility space, and the choices ORIX Clean makes within it.56## Scope and caveats78- This document compares **categories of approach**. Products are named only as familiar examples of a category.9- Every statement about a third-party product is **to the best of public knowledge; not verified here**. No10 third-party product was installed, measured or tested for this document, and no version was pinned.11- No prices, licence terms, feature lists or performance figures of other products are given: they change, and12 none were checked.13- Statements about ORIX Clean are taken from its source code and can be checked there.1415## Categories1617| Category | Familiar examples | What the category is for | Typical way of working |18|---|---|---|---|19| Disk visualizers | DaisyDisk, GrandPerspective | Show where space goes | Scan a volume or folder, draw a sunburst or treemap, let the user drill down and remove items |20| General cleaners | CleanMyMac | Free space with little effort | Scan known categories of "junk", present a total, offer a single cleaning action, often alongside maintenance and protection modules |21| Uninstallers | AppCleaner | Remove an application with its support files | Match Library files to a bundle by identifier and name, list them, delete on confirmation |22| Duplicate finders | Gemini, dupeGuru | Find redundant files | Group by content hash or by similarity, suggest which copy to remove |2324(Examples to the best of public knowledge; not verified here.)2526## Where the approaches differ2728The interesting differences are not in feature lists but in a handful of design questions.2930| Question | Common answers in the field | ORIX Clean |31|---|---|---|32| What does a size mean? | Usually one number per item | Three measured numbers per file: content size, size on disk, and the APFS private size. Recoverable space is a range, minimum to maximum |33| What does "you will free X" mean? | Usually a single figure | A range when files share blocks; exact only when the filesystem reports nothing shared. Moving to the Trash is stated as freeing nothing until the Trash is emptied |34| Who decides what is removed? | Varies from fully manual to one-click or scheduled cleaning | Always the user, in a preview that lists the exact items. No one-click cleaning, no schedule, nothing preselected |35| How is the user motivated? | Varies; some products use health scores, alerts or reminders | Facts with their evidence. No score, no alarm styling, no countdown |36| How are protected locations reached? | Some utilities install a privileged helper or ask for an administrator password | No helper and no elevation. What the user cannot remove is reported as such |37| Does the utility use the network? | Commonly for updates, licensing or telemetry | No network code at all in 1.0; updates are manual downloads |38| Where is the result kept? | Varies | Scan results in memory only; a small local SQLite file for history and logs |3940(Left-hand answers to the best of public knowledge; not verified here.)4142## What ORIX Clean deliberately does differently4344### Measured sizes, and recoverable space as a range4546Sizes come from `getattrlistbulk(2)` during the scan. Each file carries its logical size, its allocated size47and, on APFS, the private size the filesystem reports. `RecoverableEstimate` keeps a minimum (sum of private48sizes) and a maximum (sum of allocated sizes) and is displayed as "A to B" unless both are equal. Hard-linked49copies in a duplicate group are stated to free nothing; clone groups are labelled as sharing storage. The50rationale is in `docs/architecture/storage-accounting.md`: on a copy-on-write filesystem a single figure is51either wrong or lucky.5253### No urgency in the interface5455`InfoBanner` is documented in the code as "never styled as an alarm". Recommendations are produced only from56data that has actually been analysed (`Findings` fields are optional and nil means "not analysed yet"), each57with a sentence of evidence, the measured size and the consequence. The low-space recommendation states the58measured percentage. The growth recommendation states that it is "a projection from past samples, not a59forecast". There is no health score.6061### No automatic cleanup6263- Nothing is ticked by default in any list; a UI test asserts it for the cache list.64- Removal requires a `CleanupAuthorization`, and the application creates one in a single place: the confirm65 button of the cleanup preview.66- Saved workflows (Actions) cannot skip the preview: `Workflow.validate` rejects a removal step that does not67 directly follow a review step.68- Permanent deletion exists only for items already in the Trash, behind a typed confirmation.69- There is no scheduler and no background agent; the app does nothing when it is not open.7071### No privileged helper7273The app runs as the user, with the Hardened Runtime and an empty entitlements file. It does not use74EndpointSecurity, a launch daemon or an authorization prompt. The cost is explicit: root-owned items and other75users' files cannot be removed, and the app says so per item instead of working around it.7677### No network7879There is no network code in the application or the core package; `Scripts/check.sh` fails the repository check80if `URLSession`, `NWConnection`, `CFSocket`, `import Network`, `URLRequest` or `WKWebView` appears in the81sources. Consequences: no account, no telemetry, no licence check, no crash upload, and no automatic updater.82Sparkle was evaluated and deferred because an updater requires network access, which contradicts the rule for831.0. Similar-image analysis runs locally with the Vision framework.8485### Conservative association and inference8687- Uninstall: each associated file carries a confidence (`identifier`, `sharedGroup`, `nameMatch`). Anything88 below an exact identifier match is classed high risk and needs an explicit acknowledgement.89- Leftovers: reported only when the name looks like a reverse-DNS identifier, no installed application shares90 the identifier or its vendor prefix, and Launch Services does not know it. The item states that it is91 "inferred from the name only. Not proof that the item is orphaned."92- Caches: `~/Library/Caches` entries beginning with `com.apple.` and a list of system service folders are never93 offered.9495## What ORIX Clean does not do9697Stated plainly, because several of these are common in the categories above (to the best of public knowledge;98not verified here):99100- No malware scanning, no memory or CPU "optimization", no login-item or extension management.101- No whole-volume sunburst; the map is a treemap of the scanned folder.102- No snapshot management and no control over purgeable space.103- No removal of system applications, simulator runtimes or Docker data (these are measured and explained).104- No cloud, mail-attachment or photo-library internal cleanup.105- No automatic updates.106- No Mac App Store distribution: the app is not sandboxed, by design, so that it can measure what the user asks107 it to measure.108109## Trade-offs accepted110111| Choice | Cost |112|---|---|113| Range instead of one figure | Less satisfying to read; requires a sentence of explanation in the interface |114| Preview before every removal | More clicks than a one-button cleaner |115| No helper | Some items can only be reported, not removed |116| No network | Updates are manual; no crash reports reach the author |117| Scan results in memory only | Every session starts with a new scan |118