diff --git a/src-tauri/patterns/linux-to-arch.toml b/src-tauri/patterns/linux-to-arch.toml new file mode 100644 index 0000000..5551a49 --- /dev/null +++ b/src-tauri/patterns/linux-to-arch.toml @@ -0,0 +1,219 @@ +[meta] +source_os = "linux" +target_distro_family = "arch" + +# Experienced Linux user on first Arch/CachyOS install. +# Body text assumes familiarity with the terminal, systemd, and package management. +# Explanations focus on Arch-specific divergence from Debian/Fedora conventions. + +[log_paths] +pacman = "/var/log/pacman.log" +steam = "~/.local/share/Steam/logs/content_log.txt" +proton = "~/.local/share/Steam/logs/proton_log.txt" +lutris = "~/.cache/lutris/logs/lutris.log" + +# ── pacman / AUR / Chaotic-AUR ─────────────────────────────────────────────── + +[[patterns]] +id = "pacman-db-lock" +sources = ["journald", "applog:pacman"] +match_text = "could not lock database: File exists" +severity = "warn" +title = "pacman database locked" +body = "Lock file left behind: sudo rm /var/lib/pacman/db.lck — verify nothing is actually running first (fuser /var/lib/pacman/db.lck)." + +[[patterns]] +id = "pacman-dep-conflict" +sources = ["journald", "applog:pacman"] +match_text = "conflicting dependencies" +severity = "warn" +title = "Dependency conflict" +body = "Unlike apt/dnf, pacman won't silently resolve conflicts — you have to decide. Read the conflict message; usually one package replaces another (e.g. pipewire-pulse replaces pulseaudio). Explicitly remove the conflicting package first." + +[[patterns]] +id = "pacman-conflicting-files" +sources = ["journald", "applog:pacman"] +match_text = "error: failed to commit transaction (conflicting files)" +severity = "warn" +title = "Conflicting files on install" +body = "A file owned by another package is in the way. Either the package is already partially installed, or there's a leftover file. Check which package owns it: pacman -Qo /path/to/file — then remove the conflict manually or use --overwrite if you're sure." + +[[patterns]] +id = "aur-build-failure" +sources = ["journald", "applog:pacman"] +match_text = "error: failed to build" +severity = "warn" +title = "AUR package build failed" +body = "makepkg failed. Read the full output — common causes: missing makedepends (check the PKGBUILD), upstream tarball moved (check AUR comments), or a bad patch. paru -Si shows the full dependency list." + +[[patterns]] +id = "aur-pgp-key" +sources = ["journald", "applog:pacman"] +match_text = "unknown public key" +severity = "warn" +title = "PGP key not in keyring" +body = "gpg --recv-keys — or if the AUR package's PKGBUILD specifies validpgpkeys, import exactly those. Don't set SKIP_PGP_CHECK unless you trust the source." + +[[patterns]] +id = "makepkg-missing-deps" +sources = ["journald", "applog:pacman"] +match_text = "Missing dependencies" +severity = "warn" +title = "AUR build dependencies missing" +body = "makepkg needs packages that aren't installed. paru/yay resolve makedepends automatically; if building manually, install them first: sudo pacman -S or paru -S for AUR deps." + +[[patterns]] +id = "partial-upgrade-warning" +sources = ["applog:pacman"] +match_text = "warning: database file for" +severity = "info" +title = "Package database out of sync" +body = "Running pacman -Sy without -u is dangerous on Arch — partial upgrades break things. Always use pacman -Syu. This is the biggest Arch-specific rule coming from Debian or Fedora where partial syncs are fine." + +[[patterns]] +id = "chaotic-aur-sig-fail" +sources = ["journald", "applog:pacman"] +match_text = "signature from" +severity = "warn" +title = "Package signature verification failed" +body = "A package signature isn't trusted. If it's from Chaotic-AUR: sudo pacman-key --recv-key 3056513887B78AEB --keyserver keyserver.ubuntu.com && sudo pacman-key --lsign-key 3056513887B78AEB — then retry." + +# ── Kernel / DKMS (rolling release gotcha) ─────────────────────────────────── + +[[patterns]] +id = "dkms-build-fail" +sources = ["journald"] +match_text = "Error! Build of" +severity = "warn" +title = "DKMS module failed to build" +body = "A kernel module didn't compile after a kernel update. More common on CachyOS than on stable distros because the kernel ships with custom patches. Check: dkms status — then reinstall the relevant dkms package or wait for an AUR update." + +[[patterns]] +id = "cachyos-kernel-module-fail" +sources = ["kmsg"] +match_text = "module verification failed" +severity = "warn" +title = "Kernel module signature mismatch" +body = "A module doesn't match the running kernel's signing key. On CachyOS this can happen with third-party modules after a cachyos-kernel update. Reinstall the dkms module package or check if a -cachyos suffixed build exists in the AUR." + +[[patterns]] +id = "kernel-driver-firmware" +sources = ["kmsg"] +match_text = "firmware: failed to load" +severity = "warn" +title = "Firmware file missing" +body = "sudo pacman -S linux-firmware — if it's a specific device (e.g. Realtek wifi), check linux-firmware-qlogic or a dedicated AUR package." + +# ── System ──────────────────────────────────────────────────────────────────── + +[[patterns]] +id = "locale-not-set" +sources = ["journald"] +match_text = "Cannot set LC_ALL to default locale" +severity = "info" +title = "Locale not generated" +body = "Unlike Debian/Ubuntu, Arch doesn't generate locales automatically. Edit /etc/locale.gen (uncomment your locale), then run: sudo locale-gen — and set LANG in /etc/locale.conf." + +[[patterns]] +id = "systemd-resolved-fail" +sources = ["journald"] +match_text = "Failed to set DNS configuration" +severity = "info" +title = "DNS configuration failed" +body = "systemd-resolved had trouble applying DNS settings. Check: resolvectl status — on Arch, /etc/resolv.conf should be a symlink to /run/systemd/resolve/stub-resolv.conf. If it's a plain file it may conflict." + +[[patterns]] +id = "oom-killer" +sources = ["kmsg"] +match_text = "Out of memory: Kill process" +severity = "warn" +title = "OOM killer fired" +body = "A process was killed for RAM. CachyOS ships uksmd (userspace KSM) to help with this — check it's running: systemctl status uksmd. Also consider zram: sudo pacman -S zram-generator." + +[[patterns]] +id = "disk-io-error" +sources = ["kmsg"] +match_text = "Buffer I/O error on device" +severity = "warn" +title = "Disk I/O error" +body = "Storage error on a block device. Check SMART: sudo smartctl -a /dev/sdX — or for NVMe: sudo nvme smart-log /dev/nvme0." + +# ── Audio / Bluetooth ───────────────────────────────────────────────────────── + +[[patterns]] +id = "pipewire-connect-fail" +sources = ["journald"] +match_text = "Failed to connect to PipeWire" +severity = "warn" +title = "PipeWire not responding" +body = "systemctl --user restart pipewire pipewire-pulse wireplumber — if it keeps failing, check: systemctl --user status pipewire" + +[[patterns]] +id = "wireplumber-fail" +sources = ["journald"] +match_text = "Failed to activate" +severity = "warn" +title = "WirePlumber activation error" +body = "systemctl --user restart wireplumber — if audio devices keep disappearing after suspend/resume, this is a known CachyOS/PipeWire interaction; check AUR for wireplumber-git." + +[[patterns]] +id = "bluetooth-rfkill-blocked" +sources = ["journald"] +match_text = "Blocked through rfkill" +severity = "warn" +title = "Bluetooth rfkill blocked" +body = "rfkill unblock bluetooth — if hard-blocked, check BIOS or a physical switch." + +[[patterns]] +id = "bluetooth-profile-unavailable" +sources = ["journald"] +match_text = "br-connection-profile-unavailable" +severity = "info" +title = "Bluetooth audio profile missing" +body = "Check pipewire-bluetooth is installed: pacman -Q pipewire-bluetooth — and that wireplumber is running. Some headsets need libspa-bluetooth." + +# ── GPU / display ───────────────────────────────────────────────────────────── + +[[patterns]] +id = "gpu-hang" +sources = ["kmsg"] +match_text = "GPU HANG" +severity = "warn" +title = "GPU hang" +body = "GPU stopped responding; driver recovered. On CachyOS with AMD: check if mesa-git (from Chaotic-AUR) is newer than the stable mesa and matches your kernel. On NVIDIA: check nvidia-dkms version vs kernel version." + +[[patterns]] +id = "xwayland-crash" +sources = ["journald"] +match_text = "XWayland server terminated unexpectedly" +severity = "warn" +title = "XWayland crashed" +body = "X11 apps will be dead until you restart your session. If this is reproducible with a specific app, try WAYLAND_DISPLAY= to force it onto XWayland explicitly, or check for a Wayland-native version." + +# ── Gaming ──────────────────────────────────────────────────────────────────── + +[[patterns]] +id = "proton-runtime-missing" +sources = ["applog:proton"] +match_text = "wine: cannot find" +severity = "warn" +title = "Proton runtime issue" +body = "Verify game files via Steam, or check that the Steam runtime is intact: ~/.steam/root/ubuntu12_32/" + +[[patterns]] +id = "lutris-wine-fail" +sources = ["applog:lutris"] +match_text = "Wine is not installed" +severity = "warn" +title = "Lutris: Wine not found" +body = "Lutris needs a Wine runner. In Lutris: Preferences -> Runners -> Wine -> Install — or install wine from the AUR: paru -S wine-staging" + +# ── Network ─────────────────────────────────────────────────────────────────── + +[[patterns]] +id = "networkmanager-activation-fail" +sources = ["journald"] +match_text = "Activation failed" +severity = "info" +title = "NetworkManager: connection failed" +body = "nmcli device status — if a wifi adapter is missing, check dmesg for firmware errors. CachyOS ships most firmware in linux-firmware but some chips (Realtek 8852) need AUR packages."