feat: Visible wizard runs, one-step VM reset and screenshots; skill updates

- scripts/vmreset.sh, vmwatch.sh (wizard in a visible Konsole), vmshot.sh.
- vmstate.sh: DKMS per kernel, DKMS override, headers service, dark LnF, wallpaper, layout backup.
- cmp.sh: also kcminputrc and ksplashrc.
- Skill: pitfalls and checks from testing cachyos-gamescope-boot 0.7.0.

scripts/cmp.sh

@@ -10,7 +10,7 @@ mode="${1:-diff}"
 # The guest login shell is fish, so pass values in through the bash script itself.
 { printf 'mode=%q base=%q\n' "$mode" "${BASELINE:-}"; cat << 'REMOTE'
 base="${base:-$HOME/.cache/vm-baseline}"
-files="kdeglobals plasmarc plasmashellrc kwinrc kwinrulesrc konsolerc kscreenlockerrc kglobalshortcutsrc gtk-3.0/settings.ini gtk-4.0/settings.ini plasma-org.kde.plasma.desktop-appletsrc"
+files="kdeglobals kcminputrc ksplashrc plasmarc plasmashellrc kwinrc kwinrulesrc konsolerc kscreenlockerrc kglobalshortcutsrc gtk-3.0/settings.ini gtk-4.0/settings.ini plasma-org.kde.plasma.desktop-appletsrc"
 if [ "$mode" = save ]; then
   for f in $files; do mkdir -p "$(dirname "$base/config/$f")"; cp -f ~/.config/"$f" "$base/config/$f" 2>/dev/null || true; done
   echo "baseline saved to $base"; exit 0

scripts/vmreset.sh

@@ -0,0 +1,45 @@
+#!/bin/bash
+# Reset the test VM to a snapshot and bring it up logged in to Plasma:
+# power off, restore the snapshot (disk + vars.fd), start it, mount the repo
+# on /mnt, set up the test autologin and wait for plasmashell.
+#   scripts/vmreset.sh [run.sh flags...]      e.g. scripts/vmreset.sh --fremont
+# Env: VM_USER / VM_PORT / VM_HOST, SNAPSHOT (ssh-ready),
+#      VM_DIR (where disk.qcow2 lives: this repo if it has one, else ~/vms/cachyos-test),
+#      VM_LOG (QEMU output, default $VM_DIR/vm.log).
+set -euo pipefail
+. "$(dirname "$0")/common.sh"
+repo="$(cd "$(dirname "$0")/.." && pwd)"
+if [[ -z "${VM_DIR:-}" ]]; then
+    if [[ -f "$repo/disk.qcow2" ]]; then VM_DIR="$repo"; else VM_DIR="$HOME/vms/cachyos-test"; fi
+fi
+SNAPSHOT="${SNAPSHOT:-ssh-ready}"
+VM_LOG="${VM_LOG:-$VM_DIR/vm.log}"
+
+if pgrep -f '^qemu-system' >/dev/null; then
+    echo "Powering off the running VM..."
+    vm_ssh sudo systemctl poweroff 2>/dev/null || true
+    for _ in $(seq 60); do pgrep -f '^qemu-system' >/dev/null || break; sleep 2; done
+    pgrep -f '^qemu-system' >/dev/null && { echo "VM didn't shut down; stop it first." >&2; exit 1; }
+fi
+
+echo "Restoring snapshot '$SNAPSHOT' in $VM_DIR..."
+cd "$VM_DIR"
+qemu-img snapshot -a "$SNAPSHOT" disk.qcow2
+cp "vars.$SNAPSHOT.fd" vars.fd
+
+echo "Starting the VM ($*)..."
+nohup ./run.sh "$@" > "$VM_LOG" 2>&1 &
+for _ in $(seq 100); do vm_ssh -o ConnectTimeout=3 true 2>/dev/null && break; sleep 3; done
+vm_ssh true || { echo "No SSH after 5 minutes; see $VM_LOG" >&2; exit 1; }
+
+vm_ssh bash -s << 'REMOTE'
+sudo mount -t 9p -o trans=virtio,version=9p2000.L repo /mnt
+sudo mkdir -p /etc/plasmalogin.conf.d
+printf '[Autologin]\nUser=%s\nSession=plasma.desktop\n' "$USER" | sudo tee /etc/plasmalogin.conf.d/00-test-autologin.conf >/dev/null
+sudo systemctl restart plasmalogin
+for _ in $(seq 40); do pgrep -u "$USER" -x plasmashell >/dev/null && break; sleep 3; done
+sleep 10
+# Windows the snapshot opens at login would cover the screenshots.
+pkill -u "$USER" systemsettings; pkill -u "$USER" cachyos-hello
+pgrep -u "$USER" -x plasmashell >/dev/null && echo "Logged in to Plasma." || { echo "Plasma did not start." >&2; exit 1; }
+REMOTE

scripts/vmshot.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+# Screenshot the guest's Plasma session to a file on the host.
+#   scripts/vmshot.sh <out.png>
+# spectacle started straight from SSH crashes; run it as a user unit so it
+# gets the session's environment.
+# Env: VM_USER (theupriser), VM_PORT (2222), VM_HOST (localhost), GUEST_UID (1000).
+set -euo pipefail
+. "$(dirname "$0")/common.sh"
+out="${1:?usage: $0 <out.png>}"
+{ printf 'uid=%q\n' "${GUEST_UID:-1000}"; cat << 'REMOTE'
+export XDG_RUNTIME_DIR=/run/user/$uid DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/$uid/bus
+rm -f /tmp/vmshot.png
+sleep 2
+systemd-run --user --wait -q spectacle -b -n -f -o /tmp/vmshot.png
+REMOTE
+} | vm_ssh bash -s
+scp -q -P "$VM_PORT" "$VM_USER@$VM_HOST:/tmp/vmshot.png" "$out"
+echo "$out"

scripts/vmstate.sh

@@ -9,11 +9,14 @@ echo "DM=$(systemctl show -p Id --value display-manager) sddm-autologin=$(yn /et
 echo "plasmalogin [Autologin]: $(sed -n '/^\[Autologin\]/,/^\[/p' /etc/plasmalogin.conf | grep -v '^\[' | tr '\n' ' ')"
 echo "shortcut=$(grep -h Exec= ~/Desktop/*Gaming*.desktop 2>/dev/null || echo none)"
 echo "steam-unit=$([ -f ~/.config/systemd/user/steam-desktop-autostart.service ] && systemctl --user is-enabled steam-desktop-autostart.service || echo none) glyphs=$(yn ~/.config/environment.d/99-gamescope-steam-glyphs.conf)"
-echo "lnf=$(kreadconfig6 --file kdeglobals --group KDE --key LookAndFeelPackage) scheme=$(kreadconfig6 --file kdeglobals --group General --key ColorScheme) gtk=$(kreadconfig6 --file ~/.config/gtk-3.0/settings.ini --group Settings --key gtk-theme-name) font=$(kreadconfig6 --file kdeglobals --group General --key font)"
+echo "lnf=$(kreadconfig6 --file kdeglobals --group KDE --key LookAndFeelPackage) dark-lnf=$(kreadconfig6 --file kdeglobals --group KDE --key DefaultDarkLookAndFeel) scheme=$(kreadconfig6 --file kdeglobals --group General --key ColorScheme) cursor=$(kreadconfig6 --file kcminputrc --group Mouse --key cursorTheme) vapor-pkg=$(pacman -Q cachyos-vapor 2>/dev/null || echo none) layout-backup=$(yn ~/.local/state/cachyos-gamescope-boot/theme-layout)"
+echo "wallpaper: $(grep -h '^Image=' ~/.config/plasma-org.kde.plasma.desktop-appletsrc | sort -u | tr '\n' ' ')"
 echo "lock_screen=$(kreadconfig6 --file kdeglobals --group 'KDE Action Restrictions' --key action/lock_screen) autolock=$(kreadconfig6 --file kscreenlockerrc --group Daemon --key Autolock) metaL=$(kreadconfig6 --file kglobalshortcutsrc --group ksmserver --key 'Lock Session' | cut -c1-12)"
 echo "panel: $(grep -A1 '^\[PlasmaViews\]\[Panel [0-9]*\]$' ~/.config/plasmashellrc | grep floating | tr '\n' ' ') $(grep -h 'thickness' ~/.config/plasmashellrc | tr '\n' ' ')"
 echo "kickoff: $(grep -E '^(primaryActions|systemFavorites|icon)=' ~/.config/plasma-org.kde.plasma.desktop-appletsrc | tr '\n' ' ')"
 echo "leds-pkg=$(pacman -Q leds-valve-dkms-git 2>/dev/null || echo none) steamos-manager=$(pacman -Q steamos-manager 2>/dev/null || echo none)/$(systemctl is-active steamos-manager 2>/dev/null) udev=$(yn /etc/udev/rules.d/70-valve-leds-user.rules) module=$(lsmod | grep -c leds_valve) leds=$(ls /sys/class/leds | grep -c valve)"
+echo "dkms: $(dkms status leds-valve-dkms 2>/dev/null | cut -d, -f2- | sed 's/, x86_64//' | tr '\n' ';') kernels: $(ls /usr/lib/modules | tr '\n' ' ')"
+echo "dkms-override=$(yn /etc/dkms/leds-valve-dkms.conf) headers-check=$(systemctl is-enabled ensure-kernel-headers.service 2>/dev/null || echo none)"
 echo "leds-owner=$(stat -c %U /sys/class/leds/valve-leds*/brightness 2>/dev/null | sort -u | tr '\n' ' ')"
 j=~/.local/state/cachyos-gamescope-boot
 echo "journals: $(ls "$j" 2>/dev/null | tr '\n' ' ')"

scripts/vmwatch.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+# Like vmrun.sh, but run the wizard in a visible Konsole window inside the
+# guest's Plasma session, so someone at the QEMU window can follow along.
+# Waits for the wizard to finish, then prints its log. The window stays open.
+#   scripts/vmwatch.sh '<menu input>' ["label shown in the window"]
+# Env: VM_USER (theupriser), VM_PORT (2222), VM_HOST (localhost),
+#      GUEST_REPO (/mnt), GUEST_UID (1000), WAIT (seconds, default 1800).
+set -euo pipefail
+. "$(dirname "$0")/common.sh"
+input="${1:?usage: $0 '<menu input>' [label]}"
+label="${2:-Running the wizard}"
+# The guest login shell is fish, so pass values in through the bash script itself.
+{ printf 'input=%q label=%q repo=%q uid=%q wait=%q\n' "$input" "$label" "${GUEST_REPO:-/mnt}" \
+    "${GUEST_UID:-1000}" "${WAIT:-1800}"; cat << 'REMOTE'
+export XDG_RUNTIME_DIR=/run/user/$uid DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/$uid/bus
+[ -x "$repo/setup-gamescope-boot.sh" ] || { echo "$repo/setup-gamescope-boot.sh missing: mount the repo (lost after a reboot)" >&2; exit 1; }
+rm -f /tmp/wizard.done
+{
+    echo '#!/bin/bash'
+    printf 'echo %q; echo %q; sleep 3\n' ">>> $label" ">>> menu input: $input"
+    # shellcheck disable=SC2016
+    printf 'printf %q | %q 2>&1 | tee /tmp/wizard.log\n' "$input" "$repo/setup-gamescope-boot.sh"
+    echo 'touch /tmp/wizard.done'
+} > /tmp/vmwatch-run.sh
+chmod +x /tmp/vmwatch-run.sh
+pkill -u "$USER" -x konsole || true
+systemd-run --user -q konsole --hold -e /tmp/vmwatch-run.sh
+for _ in $(seq $((wait / 2))); do [ -f /tmp/wizard.done ] && break; sleep 2; done
+[ -f /tmp/wizard.done ] || echo "(still running after ${wait}s)"
+sed 's/\x1b\[[0-9;]*m//g' /tmp/wizard.log
+REMOTE
+} | vm_ssh bash -s 2>&1