wayland-only: remove X11/i3/sway, fix SDDM session, skwd-wall integration

- Remove all X11 packages (xorg-server, xorg-xwayland, xorg-xinit)
- Remove sway, i3-fallback, swaync, swaydesktop hooks
- Remove detect-legacy-hardware (blocks modern GPU path)
- Remove cage, weston, and other X11/wayland fallback compositors
- Add DisplayServer=wayland + SessionCommand to SDDM conf
- mados-auto-session: force hyprland path, remove sway-session fallback
- mados-sddm-env: detect GPU and switch SDDM rendering mode
- skwd-wall: add daemon wrapper, sources sync helper, install module
- mados-wallpaper-picker: point to mados-skwd-wall-daemon
- Wallpaper assets: copy to /usr/share/backgrounds too
- mados-shellbar-start: clean session detection and quickshell launch
- Add missing customize_airootfs modules (imperative-dots, mados-apps, etc.)
- profiledef.sh: add permissions for new scripts, remove i3-session entries
- run-qemu.sh: SSH_PORT default 2244, hostfwd configurable
- packages.x86_64: remove xorg, i3, sway, cage, weston, xdotool
- tests: remove obsolete X11/sway/i3 tests

Author: madkoding

.github/agents/docs.agent.md

@@ -19,9 +19,8 @@ You are the documentation specialist for the madOS project, an Arch Linux distri
 ### Project Docs (`docs/`)
 
 - `docs/README.md` — Main documentation index
-- `docs/PERSISTENCE.md` — Persistent USB storage user guide
-- `docs/PERSISTENCE_TESTING.md` — Persistence testing procedures
-- `docs/DEBUGGING.md` — Troubleshooting and debugging guide
+- `docs/HARDWARE_QUIRKS.md` — Hardware-specific configurations
+- `docs/SEQUENCE_DIAGRAMS.md` — System sequence diagrams
 - `docs/AUDIO_QUALITY.md` — Audio quality system documentation
 - `docs/INSTRUCTIONS.md` — General instructions
 
@@ -64,9 +63,8 @@ You are the documentation specialist for the madOS project, an Arch Linux distri
 
 ### Key Project Details for Documentation
 
-- **Hardware target**: 1.9GB RAM systems with Intel Atom processors
-- **Desktop**: Sway compositor with Nord color scheme
+- **Hardware target**: Modern hardware with GPU acceleration
+- **Desktop**: Hyprland compositor with Nord color scheme
 - **AI assistant**: OpenCode (installed via npm)
 - **Installer**: External GTK installer (in `/usr/local/bin/mados-installer`)
-- **Persistence**: Dynamic USB persistence with ext4 partition
 - **Services**: earlyoom, iwd, systemd-timesyncd, ZRAM

.github/copilot-instructions.md

@@ -2,7 +2,7 @@
 
 ## Project Overview
 
-madOS is an Arch Linux distribution built using `archiso`. It targets low-RAM systems (1.9GB) with Intel Atom processors and integrates OpenCode as an AI assistant. The project produces a custom live/installer ISO with a GTK graphical installer and pre-configured Sway desktop environment.
+madOS is an Arch Linux distribution built using `archiso`. It targets modern hardware with GPU acceleration and integrates OpenCode as an AI assistant. The project produces a custom live/installer ISO with a GTK graphical installer and pre-configured Hyprland desktop environment.
 
 ## Build Commands
 
@@ -35,9 +35,6 @@ python3 -m pytest tests/test_boot_scripts.py -v
 ### Integration Tests (require Docker with Arch Linux container)
 
 ```bash
-# USB Persistence tests
-docker run --privileged --rm -v $(pwd):/build archlinux:latest bash /build/tests/test-liveusb-persistence.sh
-
 # First-boot simulation
 docker run --privileged --rm -v $(pwd):/build archlinux:latest bash /build/tests/test-first-boot-simulation.sh
 
@@ -62,9 +59,8 @@ docker run --privileged --rm -v $(pwd):/build archlinux:latest bash /build/tests
 
 ### Boot Configuration
 
-- `grub/` — GRUB bootloader config (UEFI)
 - `syslinux/` — Syslinux config (BIOS)
-- `efiboot/` — EFI boot loader configuration
+- `efiboot/` — EFI boot loader configuration (systemd-boot)
 
 ### Root Filesystem (`airootfs/`)
 
@@ -75,13 +71,12 @@ docker run --privileged --rm -v $(pwd):/build archlinux:latest bash /build/tests
 ### Key Scripts
 
 - `airootfs/usr/local/bin/mados-installer-autostart` — Launcher for external installer
-- `airootfs/usr/local/bin/setup-persistence.sh` — Persistent storage setup
 
 ### Documentation
 
 - `docs/` — Project documentation and GitHub Pages site
-- `docs/PERSISTENCE.md` — Persistent storage documentation
-- `docs/DEBUGGING.md` — Debugging guide
+- `docs/HARDWARE_QUIRKS.md` — Hardware-specific configurations
+- `docs/SEQUENCE_DIAGRAMS.md` — System sequence diagrams
 
 ## Code Style and Conventions
 
@@ -107,8 +102,7 @@ GitHub Pages deployment is in `.github/workflows/pages.yml`.
 ## Important Guidelines
 
 - Keep `python`, `python-gobject`, and `gtk3` in `packages.x86_64` (required for the installer)
-- RAM optimizations target 1.9GB systems — avoid adding heavy packages without justification
 - When adding new scripts to `airootfs/usr/local/bin/`, update `profiledef.sh` with proper permissions
 - When modifying the installer, update tests in `tests/test_installer_config.py`
-- Desktop configs live in `airootfs/etc/skel/.config/` (Sway, Waybar, Foot, Wofi)
+- Desktop configs live in `airootfs/etc/skel/.config/` (Hyprland, Waybar, Foot, Wofi)
 - ZRAM and kernel tuning configs are in `airootfs/etc/sysctl.d/` and `airootfs/etc/systemd/`

AGENTS.md

@@ -2,7 +2,14 @@
 
 ## Project Overview
 
-madOS is an Arch Linux distribution built using `archiso`. It targets low-RAM systems (1.9GB) with Intel Atom processors and integrates OpenCode as an AI assistant. The project produces a custom live/installer ISO with a GTK graphical installer and pre-configured Sway desktop environment.
+madOS is an Arch Linux distribution built using `archiso`. It targets modern hardware with GPU acceleration and integrates OpenCode as an AI assistant. The project produces a custom live/installer ISO with a GTK graphical installer and pre-configured Hyprland desktop environment.
+
+### imperative-dots Live/Local Workflow
+
+- `../theme-imperative-dots` is the canonical working repository used to iterate on imperative-dots theme fixes.
+- The same theme is consumed by madOS during build/install under `/usr/share/mados/themes/imperative-dots`.
+- Development flow: edit and test behavior live from `theme-imperative-dots` against the local madOS environment, validate fixes in-session, then commit changes back to `theme-imperative-dots`.
+- When investigating visual mismatches, compare all theme files between the local runtime copy and `theme-imperative-dots` before fixing issues.
 
 ---
 
@@ -242,8 +249,8 @@ docker run --privileged --rm -v $(pwd):/build archlinux:latest bash /build/tests
 ### Documentation
 
 - `docs/` — Project documentation and GitHub Pages site
-- `docs/PERSISTENCE.md` — Persistent storage documentation
-- `docs/DEBUGGING.md` — Debugging guide
+- `docs/HARDWARE_QUIRKS.md` — Hardware-specific configurations
+- `docs/SEQUENCE_DIAGRAMS.md` — System sequence diagrams
 
 ---
 

README.md

@@ -1,16 +1,30 @@
 # madOS
 
-Arch Linux distribution built with `archiso`. Targets low-RAM systems (1.9GB) with Intel Atom processors, featuring OpenCode AI assistant, Sway/Hyprland desktop environments, and a GTK graphical installer.
+Arch Linux distribution built with `archiso`. Targets modern hardware with GPU acceleration, featuring OpenCode AI assistant, Hyprland desktop environment, and a GTK graphical installer.
 
 ## Features
 
-- **Low RAM optimized**: Runs on systems with as little as 1.9GB RAM
-- **Dual Compositors**: Sway (software rendering) and Hyprland (modern GPU)
+- **Modern GPU Acceleration**: Hyprland compositor with Vulkan/OpenGL support
+- **Multi-GPU Support**: NVIDIA, AMD, and Intel drivers included
+- **CUDA Support**: NVIDIA CUDA toolkit for GPU computing
 - **AI Assistant**: OpenCode integrated out-of-the-box
-- **Persistence**: Dynamic USB persistence with ext4 partition
-- **Multi-GPU Support**: Intel, AMD, and NVIDIA drivers included
 - **GTK Installer**: External installer (`/usr/local/bin/mados-installer`) for disk installation
 
+## Hardware Targets
+
+- **Minimum**: Intel/AMD integrated graphics, 2GB+ RAM
+- **Recommended**: Dedicated GPU (NVIDIA/AMD), 4GB+ RAM
+
+## Differences from madOS-lite
+
+| Feature | madOS | madOS-lite |
+|---------|-------|------------|
+| Compositor | Hyprland only | Sway only |
+| Display Manager | SDDM | greetd + tuigreet |
+| GPU Support | NVIDIA, AMD, Intel (modern) | Software rendering only |
+| RAM Target | 2GB+ | 1.5GB+ |
+| CUDA | ✅ | ❌ |
+
 ## Quick Start
 
 ```bash
@@ -32,19 +46,18 @@ Build requirements:
 
 ## Package Profiles
 
-- `packages.x86_64` is the default low-RAM profile used for ISO builds
+- `packages.x86_64` is the main profile with GPU acceleration and CUDA support
 - `packages.optional-heavy.x86_64` contains optional desktop-heavy extras
 - To install extras on an installed system: `sudo pacman -S --needed - < packages.optional-heavy.x86_64`
 - Base profile includes Steam + LibreOffice for Word/Excel/PowerPoint support
-- ONLYOFFICE is available as `onlyoffice-bin` from AUR (not in official Arch repos used by archiso)
 
 ## Project Structure
 
 ```
 .
 ├── airootfs/              # Root filesystem for the ISO
 │   ├── etc/               # System configuration
-│   │   ├── skel/          # User skeleton files (.config for Sway/Hyprland)
+│   │   ├── skel/          # User skeleton files (.config for Hyprland)
 │   │   └── systemd/       # Systemd units
 │   └── usr/local/bin/     # Custom scripts
 │       └── mados-*        # madOS utilities

THIRD_PARTY_LICENSES.md

@@ -19,7 +19,6 @@ The madOS repository license applies to madOS code and assets, not automatically
 - `alsa-firmware` (firmware blobs)
 - `sof-firmware` (firmware blobs)
 - `steam` (proprietary client/software distribution platform)
-- `code` (official Visual Studio Code build)
 
 These components are included for hardware compatibility and user experience, but they may not satisfy strict "100% free software" criteria.
 

airootfs/etc/gtk-3.0/settings.ini

@@ -1,5 +1,5 @@
 [Settings]
-gtk-theme-name=Nordic
+gtk-theme-name=adw-gtk-theme-dark
 gtk-icon-theme-name=Papirus
 gtk-font-name=FreeSans 11
 gtk-cursor-theme-name=Adwaita

airootfs/etc/mados/ventoy-persist.conf

@@ -3,24 +3,27 @@
 # Creates symlinks from /usr/share/music/* -> ~/Music/
 # and /usr/share/video/* -> ~/Videos/
 
+set -euo pipefail
+
 # Only run for interactive sessions with a real home
-[[ -z "$HOME" || "$HOME" == "/" ]] && return 0
-[[ ! -t 0 || ! -t 1 ]] && return 0
+[[ -z "$HOME" || "$HOME" == "/" ]] && exit 0
 
-MARKER="$HOME/.cache/.mados-media-linked"
+MARKER="${HOME}/.cache/.mados-media-linked"
 
 # Only run once per user
-[[ -f "$MARKER" ]] && return 0
+[[ -f "$MARKER" ]] && exit 0
 
 # Ensure user directories exist
-mkdir -p "$HOME/Music" "$HOME/Videos" "$HOME/.cache"
+mkdir -p "${HOME}/Music" "${HOME}/Videos" "${HOME}/.cache"
 
 # Link music files
 if [[ -d /usr/share/music ]]; then
     for f in /usr/share/music/*; do
         [[ -f "$f" ]] || continue
         base="$(basename "$f")"
-        [[ -e "$HOME/Music/$base" ]] || ln -s "$f" "$HOME/Music/$base" 2>/dev/null
+        if [[ ! -e "${HOME}/Music/$base" ]]; then
+            ln -s "$f" "${HOME}/Music/$base" 2>/dev/null || true
+        fi
     done
 fi
 
@@ -29,7 +32,9 @@ if [[ -d /usr/share/video ]]; then
     for f in /usr/share/video/*; do
         [[ -f "$f" ]] || continue
         base="$(basename "$f")"
-        [[ -e "$HOME/Videos/$base" ]] || ln -s "$f" "$HOME/Videos/$base" 2>/dev/null
+        if [[ ! -e "${HOME}/Videos/$base" ]]; then
+            ln -s "$f" "${HOME}/Videos/$base" 2>/dev/null || true
+        fi
     done
 fi
 

airootfs/etc/pacman.d/hooks/sway-desktop-override.hook

@@ -1,4 +1,4 @@
-gtk-theme-name="Nordic"
+gtk-theme-name="adw-gtk-theme-dark"
 gtk-icon-theme-name="Papirus"
 gtk-font-name="Sans 10"
 gtk-cursor-theme-name="Adwaita"