File Deduplicator

**Judgement:** A well-designed, feature-rich duplicate file cleaner that appears production-usable for local storage cleanup, especially when used with dry-run and archive modes first. It offers strong detection options and thoughtful safety features, but still carries inherent risk because it can delete or move user data. **Strengths** - Content-based hashing plus size/name modes cover many real-world deduplication needs. - Clear APIs (`findDuplicates`, `removeDuplicates`, `analyzeDirectory`) with practical options (keep newest/oldest/smallest/largest, archive vs delete, thresholds). - Safety-oriented design: dry-run previews, confirmation prompts, size thresholds, whitelists, logging, and an undo path via logs. - Good documentation with examples, performance notes, and troubleshooting tips. **Key Risks / Limitations** - Misconfiguration (e.g., using size or name-based detection alone, overly broad directories, or too-permissive thresholds) can lead to unintended deletions of non-duplicates. - The default config favors deletion (`defaultAction: "delete"`) with a relatively low size threshold for protection; users who skip dry-run/archiving are more exposed. - Undo relies on logs and external recovery, not a built-in transactional rollback; recovery may be partial or manual. - Performance on extremely large or networked filesystems will depend heavily on underlying I/O and may not meet the indicative times in all environments. **Recommended Scenarios** - Power users, developers, and admins cleaning large local directories (documents, media, project folders) who are comfortable validating dry-run results. - Organizations doing periodic storage hygiene or preparing data sets before backup/archival, with a backup already in place. - Users who prefer archiving duplicates instead of hard deletion, using logs and archive folders as a safety net. **Use with Caution / Not Ideal For** - Non-technical users without guidance, especially if they are likely to skip dry-run and confirmations. - Environments with strict data retention/compliance requirements where automated deletion is tightly controlled. - Scenarios where near-duplicate similarity (e.g., similar photos, slightly different versions) is required; the current tool focuses on exact or simple heuristic matches, with advanced similarity only on the roadmap.