MacSweep Guard - Release Notes

[1.0.1] - 2026-02-16

Improvements

• Improved startup performance:
  • Startup scan now runs only default categories (lighter load).
  • Safe Trash and Audit data loading is deferred until users open those sections.
• Optimized scan/preview/clean flow:
  • Orphan context is preloaded only when orphan categories are actually involved.
  • Reduced unnecessary heavy rescans after cleanup actions.

Safe Trash and Disk Reclaim

• Added Delete Entire Session in Safe Trash to remove a full session quickly and avoid leftover large files.
• Improved per-session item count visibility to reduce "0 item" misinterpretation.
• Updated cleanup result messaging:
  • Clear separation between "Moved" (to Safe Trash) and "Reclaimed Now".
  • Clarifies why disk space may not drop immediately if data is only moved to Safe Trash.

[1.0.0] - 2026-02-15

Highlights

• First public release of MacSweep Guard for macOS.
• Scans and cleans user-space junk data with safety-first behavior.
• Supports multiple data groups: caches, logs, Xcode/Simulator data, old Downloads, orphan data, browser data, iOS backups, duplicate files, and large/old files.
• Introduces Safe-Trash: files are moved before permanent deletion, with restore support.

Core Features

• Category-based scanning with preview before cleanup.
• Safety policy guardrails:
  • Blocks protected paths when strict mode is enabled.
  • Requires manual review for risk categories.
  • Skips symlinks during scanning.
• Flexible whitelist support:
  • Path-prefix rules.
  • Contains-token rules.
• Audit history:
  • Logs cleanup/restore actions.
  • Exports JSON/CSV reports.

Testing

• Local test run executed with swift test.
• Current result: all tests passing (14 tests, 0 failures).
• Automation coverage includes primary flows:
  • scan
  • whitelist
  • safe delete
  • restore
  • policy guardrails

Packaging and Distribution

• Distribution channel: outside the Mac App Store.
• Release workflow uses Developer ID + Notarization.
• Helper script for notarize/staple/checksum:
  • scripts/release-notarize.sh

Current Limitations

• The repository is currently a Swift Package executable; for long-term stable release operations, maintain a macOS App target in Xcode for archive/sign workflows.
• Some sensitive paths are intentionally blocked by strict policy to reduce accidental deletion risk.

Upgrade Notes

• For each new release, add a section using:
  • ## [x.y.z] - YYYY-MM-DD
• Publish SHA256 checksums with public artifacts (.dmg/.pkg).