NATIVE-5K RECOVERY CARD
https://aquamarine.youens.com/

Before testing
--------------
1. Save all work.
2. Confirm the normal "Omarchy" session is still present at the SDDM login
   screen.
3. Keep a tested SSH session open from another device. A TTY verified under the
   stock session is a useful fallback, but VT switching is unproven under the
   candidate and must not be your only recovery path.
4. Record the two experimental files installed under /usr/local. The guided
   page uses only:

   /usr/local/bin/aquamarine-native5k-session
   /usr/local/share/wayland-sessions/aquamarine-native5k.desktop
5. Save the preflight report. Continue manually only if it says
   sddm_manual_selection_safe=yes. The candidate must never be the SDDM
   autologin session. If an agent temporarily disables autologin, keep its
   exact restoration command and root-owned backup outside every
   sddm.conf.d directory.

Normal rollback
---------------
Press Super+Shift+Escape in the bare experimental session, then choose the
normal Omarchy session at the login screen. The distro Aquamarine package and
normal Hyprland config were never replaced.

If SDDM normally autologs into an explicitly named stock session with
Relogin=false, do a normal logout only: the first autologin has already been
consumed and SDDM returns to its chooser. Do not reboot or restart SDDM between
installing the candidate entry and choosing it. An empty Autologin Session is
not safe because SDDM may reuse the last manually selected session next boot.

The candidate Hyprland config deliberately imports no Omarchy graphical shell,
modules, autostart, hooks, lock, idle blanking, Night Light, or output-management
bindings. SDDM still runs the account's Bash login profile before the wrapper;
review it before testing, and use the agent route if it has side effects. The
candidate does not implement display sleep, and the panel remains on until you exit. Do not run
`/usr/bin/hyprctl` DPMS, monitor keyword, reload, or CTM commands in the
candidate session.

Emergency rollback from SSH (TTY is secondary)
-----------------------------------------------
1. Connect over the already-tested SSH session. If that is unavailable, try
   Ctrl+Alt+F3 and log in.
2. Ask the candidate compositor to exit without restarting the display manager:

   pkill -TERM -u "$UID" -x Hyprland

   SDDM should return. If it does, choose the normal Omarchy session. If an
   agent changed autologin, follow its saved restoration plan; do not invent a
   backup path or leave a .bak file inside sddm.conf.d, because SDDM loads it.

3. Hide the experimental session without deleting it. A timestamp prevents an
   older saved copy from being overwritten:

   stamp=$(date +%Y%m%d-%H%M%S-%N)

   sudo mv -T --update=none-fail --no-copy \
     /usr/local/bin/aquamarine-native5k-session \
     "/usr/local/bin/aquamarine-native5k-session.disabled.$stamp"

   sudo mv -T --update=none-fail --no-copy \
     /usr/local/share/wayland-sessions/aquamarine-native5k.desktop \
     "/usr/local/share/wayland-sessions/aquamarine-native5k.desktop.disabled.$stamp"

4. If the graphical session is stuck, first prove that effective SDDM
   autologin is disabled or explicitly names the stock session. If it is
   unknown or names the candidate, stop and restore the saved configuration.
   Only then use this last-resort command; it closes every graphical application
   and returns to SDDM:

   sudo systemctl restart sddm

5. Choose the normal Omarchy session.

6. In stock Omarchy, verify that Hyprland maps the distro library and that the
   candidate variables did not leak into the persistent user manager:

   hypr_pid=$(pgrep -u "$UID" -n -x Hyprland)

   awk '/libaquamarine\.so/ {print $6}' \
     "/proc/$hypr_pid/maps" | sort -u

   systemctl --user show-environment | \
     grep -E '^(AQ_|LD_LIBRARY_PATH=)' || true

   Expected: an Aquamarine path under /usr/lib and no AQ_* or LD_LIBRARY_PATH
   lines. If either check fails, log out and have an experienced agent repair
   the stock environment before calling rollback complete.

The staged source and library remain under your home directory for inspection.
Do not delete them until the stock session has been verified.