mac-deep-cleaner v2.0.0

v2.0.0 (2026-05-14)

Added

Cross-cutting Work

• Add new CLI subcommands and options in src/cli.py
• Extend config schema in src/config/config.py for new features
• Add logging and safe-path validation in src/core/safety.py where needed
• Expand reporting exports in src/reporting for new outputs
• Add tests for parsers and non-destructive scanners in tests/

External Dependencies (tentative)

• textual or prompt_toolkit for interactive TUI picker
• rumps for menu bar companion
• requests or urllib for HIBP API (prefer urllib to avoid new deps)
• pandas/pyarrow NOT planned (keep lightweight)

Safety Gates

• All destructive operations honor --dry-run and undo staging.
• Time Machine guard before bulk deletes.
• APFS snapshot support behind explicit flags.
• Restore checksum verification for staged files.

Open Decisions (needs confirmation)

• Preferred TUI library (textual vs prompt_toolkit)
• Whether to add optional dependencies vs strict core only
• Handling sudo-required operations (auto prompt vs printed instructions)
• HIBP API key provisioning and storage
• Minimum supported macOS version for system commands
• CI mode via mdc uninstall-cli ti uninstall this package

DOUCMENTATIONS

• Added the documentations for the command references and architecture

Changed

• CLI wiring for new feature commands
• Added reporting utilities
• Updated Readme for new features
• Version bump to v2.0.0 across docs and UI
• Updated the ci/cd pipelining to publish the newer version to pypi directly
• Updated the readme.md file for the references too