feat: rewrite bleach in bash with modular architecture and TUI

- Replaced Python codebase with a modular Bash architecture.
- Added gum based TUI for interactive menu selection.
- Implemented comprehensive cleanup modules:
  - System: APT, Docker, Logs, Temp, SSD Trim, Trash, Thumbnails.
  - Dev: Node (npm/pnpm/yarn), Python (deep __pycache__ scan), Build artifacts.
  - IDE: VS Code and JetBrains cache cleaning.
- Added install.sh for one-line installation and dependencies (gum).
- Implemented auto-update mechanism (weekly check + APT hook).
- Added storage freed reporting session summary.
- Removed legacy Python files and assets.

Author: maruf-pfc

CONTRIBUTING.md

@@ -1,55 +1,38 @@
 # Contributing to Bleach
 
-First off, thanks for taking the time to contribute! 🎉
-
-The following is a set of guidelines for contributing to Bleach. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
-
-## Code of Conduct
-
-This project and everyone participating in it is governed by the
-[Bleach Code of Conduct](CODE_OF_CONDUCT.md).
-By participating, you are expected to uphold this code.
-
-## How Can I Contribute?
-
-### Reporting Bugs
-
-- **Ensure the bug was not already reported** by searching on GitHub under [Issues].
-- If you're unable to find an open issue addressing the problem, open a new one. Be sure to include a **title and clear description**, as much relevant information as possible, and a **code sample** or an **executable test case** demonstrating the expected behavior that is not occurring.
-
-### Suggesting Enhancements
-
-- Open a new issue and purely describe the feature you would like to see.
-- Explain why this feature would be useful to most users.
-
-### Pull Requests
-
-1. Fork the repo and create your branch from `main` (or `dev`).
-2. If you've added code that should be tested, add tests.
-3. Ensure the test suite passes.
-4. Make sure your code lints (`ruff check .`).
-5. Issue that pull request!
-
-## Styleguides
-
-### Git Commit Messages
-
-- Use the present tense ("Add feature" not "Added feature")
-- Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
-- Limit the first line to 72 characters or less
-- Reference issues and pull requests liberally after the first line
-
-### Python Styleguide
-
-- We use [Ruff](https://beta.ruff.rs/docs/) for linting and formatting.
-- We use [MyPy](https://mypy-lang.org/) for static type checking.
-- All public functions and classes should have docstrings (Google style).
-
-## Development Setup
-
-1. Clone the repo
-2. Install dependencies: `pip install -e ".[dev]"`
-3. Run tests: `pytest`
-4. Run linter: `ruff check .`
-
-Thanks! ❤️
+Thank you for your interest in contributing to Bleach! We have moved to a modular Bash architecture to make system maintenance accessible and transparent.
+
+## Project Structure
+
+- **`bleach`**: The main entry point script.
+- **`install.sh`**: The one-line installer and updater.
+- **`src/core/`**: Core libraries (`tui.sh`, `logging.sh`, `state.sh`, `self_update.sh`).
+- **`src/modules/`**: Standalone scripts for specific tasks.
+    - `cleanup/`: Cleaning caches, logs, IDEs, trash, etc.
+    - `updates/`: System updates (APT, Snap, Flatpak).
+    - `maintenance/`: System optimization.
+
+## How to Add a New Module
+
+1. **Create a Script**: Add a new `.sh` file in the appropriate `src/modules/<category>/` directory.
+2. **Define a Function**: The script should export a function (e.g., `cleanup_myapp()`).
+3. **User Interaction**:
+    - Use `gum confirm` for yes/no prompts.
+    - Use `run_with_spinner` for long-running commands.
+    - Use `log_info` / `log_error` for feedback.
+4. **Register**: Add your function to the `run_<category>_menu` function in `src/modules/<category>/main.sh`.
+
+## Style Guide
+
+- **Shebang**: Always use `#!/usr/bin/env bash`.
+- **Safety**: Use `set -Eeuo pipefail` where possible, or handle errors explicitly.
+- **Indentation**: 4 spaces.
+- **Comments**: Comment complexity; keep it simple.
+
+## Pull Requests
+
+1. Fork the repo.
+2. Create a new branch (`git checkout -b feature/my-new-feature`).
+3. Commit your changes.
+4. Push to the branch.
+5. Open a Pull Request.

MANIFEST.in

@@ -1,109 +1,67 @@
-# Bleach
+# Bleach (Bash Edition)
 
-**A safe, cross-platform terminal-based system cleaner.**
+> **Automated System Cleanup & Maintenance Tool for Linux**
+> _Inspired by [ChrisTitusTech/linutil](https://github.com/ChrisTitusTech/linutil)_
 
-![License](https://img.shields.io/badge/license-MIT-blue.svg)
-![Python](https://img.shields.io/badge/python-3.8+-blue.svg)
+Bleach is a powerful, interactive terminal utility designed to keep your Linux system clean, fast, and private. Rewritten entirely in **Bash** for maximum portability and control, it uses [gum](https://github.com/charmbracelet/gum) to provide a modern, easy-to-use interface.
 
-**Bleach** is a modern system maintenance tool designed for developers. It helps you keep your Linux environment fast and clean by removing unused caches, logs, and temporary files safely.
-
-Unlike aggressive cleaning tools, Bleach respects your development environment—it never touches `.git` folders, source code, or active databases.
+![Demo](https://charm.sh/m/gum/demo.gif)
+*(Example of the Gum interface used in Bleach)*
 
 ## ✨ Features
 
-- **🖥️ Modern TUI**: built with [Textual](https://textual.textualize.io/) for a beautiful, interactive terminal experience.
-- **🛡️ Safe by Default**: Explicitly ignores `.git` directories and critical system files.
-- **🐧 Cross-Distro**: Smartly detects your package manager (APT, DNF, Pacman, etc.).
-- **🧹 Deep Cleaning**:
-  - **System**: Journal logs, temporary files, thumbnails.
-  - **Dev Tools**: Docker (unused images/containers), NPM cache, Pip cache.
-  - **Package Managers**: Clean APT/DNF/Pacman caches and autoremove unused packages.
-
-## 📦 Installation
-
-### Option 1: One-Line Installer (Recommended)
-
-Quickly install and setup Bleach with a single command:
-
-```bash
-curl -sL https://raw.githubusercontent.com/maruf-pfc/bleach/main/install.sh | bash
-```
-
-### Option 2: Debian/Ubuntu (.deb)
-
-Download the latest release from the [Releases Page](https://github.com/maruf-pfc/bleach/releases).
+- **Interactive TUI**: Navigate easy menus to select exactly what you want to clean.
+- **Deep Clean & Storage Recovery**:
+  - **System**: APT (autoremove/clean), Docker (prune), Logs (vacuum), Temp files (`/tmp`), Trash.
+  - **Dev**: Node (`npm`, `pnpm`, `yarn`), Python (deep `__pycache__` scan), Build Artifacts (`dist`, `build`).
+  - **IDE**: Clear caches for VS Code and JetBrains IDEs.
+  - **Privacy**: Clear user thumbnail caches.
+- **System Maintenance**:
+  - **SSD Trim**: Optimize SSD performance via `fstrim`.
+  - **Storage Reporting**: Tracks and reports exactly how much disk space was reclaimed after every session.
+- **Auto-Updates**:
+  - **Self-Update**: Built-in weekly check for new versions.
+  - **APT Hook**: Optional integration to check for Bleach updates whenever you run `sudo apt update`.
+- **Logging**: Detailed logs of every action kept in `~/.local/share/bleach/logs`.
+
+## 🚀 Installation
+
+### One-Line Installer
+This will install Bleach to `/opt/bleach`, create a symlink at `/usr/local/bin/bleach`, and install the `gum` dependency automatically.
 
 ```bash
-sudo dpkg -i bleach_*.deb
-sudo apt-get install -f  # Fix dependencies if needed
+curl -fsSL https://raw.githubusercontent.com/yourusername/bleach/main/install.sh | sudo bash
 ```
 
-### Option 2: Python (Universal)
+*(Note: If you are running from a local clone, just run `sudo ./install.sh`)*
 
-Install directly from the repository using `pip` (requires Python 3.8+):
-
-```bash
-pip install git+https://github.com/maruf-pfc/bleach.git
-```
+### Prerequisites
+Bleach uses **[gum](https://github.com/charmbracelet/gum)** for its UI. The installer handles this for you on Debian/Ubuntu systems.
 
-### Option 3: Build from Source
+## 🛠 Usage
 
-If you want to build the `.deb` package yourself:
-
-```bash
-git clone https://github.com/maruf-pfc/bleach.git
-cd bleach
-./build_deb.sh
-sudo dpkg -i build/bleach_0.1.0_all.deb
-```
-
-## 🚀 Usage
-
-Simply run `bleach` in your terminal:
+Run the tool anytime from your terminal:
 
 ```bash
 bleach
 ```
 
-- Navigate using **Arrow Keys** or **Mouse**.
-- Toggle items with **Space** or **Click**.
-- Run cleanup by clicking **"Run Cleanup"**.
-
-### CLI Options
+### Modes
+- **System Cleanup**: Quick access to disk space recovery tools.
+- **System Updates**: Centralized update management for APT, Flatpak, and Snap.
+- **Maintenance**: Utilities for long-term health (SSD Trim, etc.).
+- **View Logs**: Read what Bleach has done recently.
 
+### Auto-Update
+Bleach checks for updates weekly. You can also manually trigger a check:
 ```bash
-bleach --version   # Show version
-bleach --help      # Show help message
+bleach --check-update
 ```
 
-## 🛠️ Development
-
-We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
-
-1. **Clone the repo**
-   ```bash
-   git clone https://github.com/maruf-pfc/bleach.git
-   cd bleach
-   ```
-
-2. **Install dev dependencies**
-   ```bash
-   pip install -e ".[dev]"
-   ```
-
-3. **Run Linting & Tests**
-   ```bash
-   ruff check .
-   mypy .
-   pytest
-   ```
-
-## 📄 License
+## 🤝 Contributing
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to add new modules or improve existing ones.
 
----
+## 📜 License
 
-<p align="center">
-  Made with ❤️ by <a href="https://github.com/maruf-pfc">Md. Maruf Sarker</a>
-</p>
+MIT License. See [LICENSE](LICENSE) for details.