Storage Guardian

Storage conservation guardian — duplicate detection, bloat detection, cold file detection, and budget tracking.

Installation

gem install storage-guardian

Usage

require "storage_guardian"

# Quick scan
report = StorageGuardian.scan("/path/to/project")
puts report

# With custom budget
budget = StorageGuardian::Budget.new(max_file_size_mb: 50, max_dir_size_mb: 500)
report = StorageGuardian.scan("/path/to/project", budget: budget, cold_threshold_days: 60)
puts report.summary

Features

• Duplicate Detection — SHA256 hash-based, groups identical files
• Bloat Detection — oversized files and directories vs budget
• Cold File Detection — files not modified in N days
• Budget Tracking — configurable limits

License

MIT