Broadcom, Utils & Headless Fixes

- Removed dead Broadcom hardware IDs (4357/4358/4360/4727) from `_is_broadcom_b43`, retaining only valid ID 4352 to eliminate false positives in the case statement.
- Added a guard in `_handle_wireless` Level 3 to verify `linux-headers` availability via `apt-cache policy`. Skips DKMS compilation if headers are missing, preventing transaction failures during installation.
- Implemented Broadcom combo card detection (WiFi + Bluetooth) by scanning `PCI_BT_DEVS`. Automatically writes `/etc/modprobe.d/broadcom-combo.conf` with `softdep wl post: btusb` and warns users about potential reboot requirements.
- Enhanced Level 2 (`firmware-b43-installer`) with post-installation validation for `/lib/firmware/b43`. Provides clear recovery instructions via `sudo dpkg-reconfigure firmware-b43-installer` if the directory is empty or missing after installation.
- Created a new helper `_msg_red()` in `utils.sh` to handle critical error messages with colored Whiptail output, replacing standard alerts for migration warnings and failures.
- Updated `repos/migrate.sh` to use `_msg_red()` for branch migration warnings and failure states, ensuring visibility of critical issues while keeping completion messages informative.
- Verified headless mode guards across 16 separate extras files (`office.sh`, `fetch.sh`, `cursors.sh`, etc.), preventing unnecessary package installations on servers without display environments.
- Completed syntax verification (`bash -n`) across all core and extra modules, ensuring no errors in the updated logic for firmware, gaming, swap, or repository management scripts.
- update readme.md

README.md

@@ -50,15 +50,17 @@ After running the script:
 | **1** | [System Info](/docs/system_info.md) | Show detected OS, CPU, RAM, GPU and hardware details |
 | **2** | [User Privileges & Feedback](/docs/user_priv_feed.md) | Configure sudo group membership, enable passwordless sudo for frequent tasks, repair home directory ownership issues, and toggle visual password feedback (asterisks) in terminal |
 | **3** | [Configure Repositories](/docs/repos_config.md) | Setup official repos with non-free/contrib options, optional Backports support and Deb822/classic format injection.|
-| **4** | [Firmware & Wireless Drivers](/docs/firmware.md) | Install essential firmware for GPUs and wireless|
+| **4** | [Firmware, Wireless & Bluetooth](/docs/firmware.md) | Install essential firmware for GPUs and wireless|
 | **5** | [Graphics Drivers & Mesa Stack](/docs/gpu.md) | Configure AMD/Intel/NVIDIA drivers and Mesa graphics stack + monitoring tools |
 | **6** | [Backports Kernel](/docs/kernel.md) | Install latest kernel from Debian backports|
-| **7** | [Gaming Setup and Performance](/docs/gaming.md)| Steam, Heroic Games Launcher, [RetroArch](/docs/retroarch.md) GameMode, MangoHud, OpenRGB, Java JRE (Temurin 8/17/21) |
-| **8** | [Install ZRAM](/docs/zram.md)| Configure compressed RAM for memory optimization|
-| **9** | Install Programs and Software | Selection from several categories (Development, Themes, System, etc.) |
-| **10** | Exit | Return to terminal |
+| **7** | [Gaming Setup ](/docs/gaming.md)| Steam, Heroic Games Launcher, [RetroArch](/docs/retroarch.md) GameMode, MangoHud, OpenRGB, Java JRE (Temurin 8/17/21) |
+| **8** | [ZRAM](/docs/zram.md)| Configure compressed RAM for memory optimization|
+| **9** | Swap Management| Manage swap file or partition size and enable/disable swap space for system stability|
+| **10** | Install Programs and Software | Browse and install packages by category (Development, Themes, System Tools, etc.) using APT |
+| **11** | Boot Rescue & Repair| Fix GRUB bootloader issues, chroot repair, or restore system boot configuration|
+| **12** | Exit | Return to terminal |
 
-### Install Programs and Software (Option 9)
+### Install Programs and Software (Option 10)
 
 The submenu offers the next categories:
 
@@ -67,7 +69,7 @@ The submenu offers the next categories:
 | **0** | Essential Pack | Quick install of common tools (compression, system info, VLC, MS fonts)|
 | **1** | Customization System | Desktop themes, icon themes, cursor themes, and fonts |
 | **2** | Download & Network | Downloaders (aria2, ytdlp, FileZilla) + Torrent clients (qBittorrent, Deluge, Transmission) |
-| **3** | Internet (Browsers, Email Clients, VPN Tools) | Web browsers (Firefox/Mozilla, LibreWolf, Floorp, Chromium, Brave, Tor), email clients (Thunderbird), and VPN tools including Riseup |
+| **3** | Internet (Browsers, Email Clients, VPN) | Web browsers (Firefox/Mozilla, LibreWolf, Floorp, Chromium, Brave, Tor), email client (Thunderbird), and VPN tools (RiseUp, Proton, Mullvad)|
 | **4** | Media Players | Multimedia playback with VLC media player and MPV for advanced video/audio support |
 | **5** | Multimedia & Design | image editing (GIMP), video editing (Kdenlive, HandBrake), 3D modeling (Blender), audio recording (Audacity), and graphics design (Inkscape) |
 | **6** | Code Editors & IDEs | vim, vim-gtk3, Neovim, Helix, nano, Emacs, Kate, Mousepad, Gedit, Geany, GNOME Text Editor, and VSCodium (VS Code open-source) |
@@ -84,9 +86,42 @@ The submenu offers the next categories:
 
 | Directory/File | Description |
 |----------------|-------------|
-| `./debianito.sh` | Main entry point; handles menu navigation and system detection. |
-| `/modules/` | Modular scripts for specific tasks: sudo config, repos, firmware, gpu, kernel, gaming, zram. |
-| `/modules/extras/` | Split-by-category sub-modules for the "Install Programs and Software" menu (Option 9). |
+| `debianito.sh` | Main entry point; handles menu navigation and system detection. |
+| `docs/` | Documentation directory containing Markdown files for each module. |
+| `modules/` | Core modular scripts organized by category: repos, gpu, gaming, kernel, firmware, zram, etc. |
+| `modules/bullseye/` | Legacy Debian 11 (Bullseye) specific modules: `extras.sh`, `legacy.sh`, `repos.sh`. |
+| `modules/extras/` | Software installer sub-modules split by category (themes, downloaders, internet, dev tools, etc.). |
+| `modules/gaming/` | Gaming launcher and optimization scripts: Steam, Heroic, Lutris, performance tools. |
+| `modules/gpu/` | GPU driver installation scripts for AMD and NVIDIA with architecture detection. |
+| `modules/repos/` | Repository management scripts: migration tool (`migrate.sh`) and format detection (`repo_detect.sh`). |
+| `modules/extras/design/` | Multimedia & design tools installer (Blender, GIMP, Kdenlive, OBS). |
+| `modules/extras/dev/` | Development tools installer with special handling for Jellyfin and Java. |
+| `modules/extras/download/` | Download tools installer (aria2, FileZilla) and torrent clients (qBittorrent, Transmission). |
+| `modules/extras/essential/` | Essential package installer for basic system utilities on older Debian versions. |
+| `modules/extras/fetch/` | System information fetcher tools (neofetch, screenfetch, linuxlogo). |
+| `modules/extras/internet/` | Internet tools installer: browsers, email clients, download managers. |
+| `modules/extras/java.sh` | Java runtime installer for Minecraft and development (Temurin 8/17/21). |
+| `modules/extras/office/` | Office productivity suite installer (LibreOffice, GIMP alternatives). |
+| `modules/extras/players/` | Media player installer (MPV, VLC) with codec support. |
+| `modules/extras/programming/` | Code editors and IDEs installer (Vim, Neovim, Emacs, Kate). |
+| `modules/extras/security/` | Security tools installer: ClamAV, Fail2Ban, UFW, Wireshark. |
+| `modules/extras/system/` | System utilities installer with software center options (GNOME Software, Discover). |
+| `modules/extras/themes/` | Desktop customization installer: themes, icons, cursors, fonts. |
+| `modules/gaming/_helpers.sh` | Shared helper functions for gaming modules (32-bit support, Mesa drivers). |
+| `modules/gpu/amd_intel.sh` | AMD and Intel GPU firmware + monitoring tools (radeontop, nvtop, vainfo). |
+| `modules/gpu/_helpers.sh` | Shared helper functions for GPU detection (NVIDIA architecture checks). |
+| `modules/nvidia.sh` | NVIDIA driver installer with multi-architecture support (Kepler, Fermi, Maxwell, Pascal, Blackwell). |
+| `modules/amd_intel.sh` | AMD and Intel GPU firmware + monitoring tools installation. |
+| `modules/kernel.sh` | Kernel management: backports kernel installation and detection. |
+| `modules/repos/migrate.sh` | Branch migration tool for Debian stable → testing/SID with backup/rollback. |
+| `modules/repos/repo_detect.sh` | Repository format detection (DEB822 vs classic) for idempotent configuration. |
+| `modules/rescue.sh` | Boot rescue and repair tools: GRUB fix, chroot repair, system restore. |
+| `modules/sudo_config.sh` | Sudo configuration: group membership, passwordless sudo, home directory ownership. |
+| `modules/swap.sh` | Swap management: file/partition size configuration and enable/disable swap space. |
+| `modules/sysinfo.sh` | System information detection and display (OS, CPU, RAM, GPU, storage). |
+| `modules/utils.sh` | Utility functions shared across modules (color codes, confirmation dialogs, installation helpers). |
+| `modules/zram.sh` | ZRAM configuration for compressed RAM optimization. |
+| `README.md` | Project documentation and usage instructions. |
 
 ```bash
 ├── debianito.sh
@@ -158,15 +193,17 @@ The submenu offers the next categories:
 │   ├── gpu.sh
 │   ├── kernel.sh
 │   ├── repos
+│   │   ├── migrate.sh
 │   │   └── repo_detect.sh
 │   ├── repos.sh
+│   ├── rescue.sh
 │   ├── sudo_config.sh
+│   ├── swap.sh
 │   ├── sysinfo.sh
 │   ├── utils.sh
 │   └── zram.sh
 └── README.md
 ```
-
 ---
 
 > 🤖 **AI-Assisted Development Note**