[meta]
source_os = "ipad"
target_distro_family = "fedora"

# iPad/iPhone user on their first Fedora install.
# Assumes NO terminal experience. Fedora GNOME is visually close to iPadOS.

[log_paths]
steam     = "~/.local/share/Steam/logs/content_log.txt"
proton    = "~/.local/share/Steam/logs/proton_log.txt"

# ── Package management ────────────────────────────────────────────────────────

[[patterns]]
id       = "dnf-lock"
sources  = ["journald"]
match_text = "Another app is currently holding the dnf lock"
severity = "warn"
title    = "Software installer is busy"
body     = "Fedora is doing automatic updates in the background — like iOS updating apps silently. Wait a minute and try again. You can see what's happening in GNOME Software (the App Store equivalent)."

[[patterns]]
id       = "dnf-dep-conflict"
sources  = ["journald"]
match_text = "conflicts with"
severity = "warn"
title    = "Two apps conflict with each other"
body     = "Two packages need something that can't coexist. Run: sudo dnf distro-sync — in a terminal to bring everything back into sync."

# ── SELinux ───────────────────────────────────────────────────────────────────

[[patterns]]
id       = "selinux-denial"
sources  = ["journald"]
match_text = "type=AVC"
severity = "info"
title    = "Security system blocked an action"
body     = "Fedora uses SELinux — a detailed security system that controls what each program can access. Think of it as a much stricter version of iOS app permissions. This log entry is usually routine. If an app keeps failing, GNOME's 'Setroubleshoot' tool will pop up with an explanation and fix."

# ── System ────────────────────────────────────────────────────────────────────

[[patterns]]
id       = "kernel-driver-firmware"
sources  = ["kmsg"]
match_text = "firmware: failed to load"
severity = "warn"
title    = "Hardware driver file missing"
body     = "Some hardware needs a driver installed separately. Fedora usually handles this automatically, but if a device isn't working: sudo dnf install linux-firmware — restart after."

[[patterns]]
id       = "oom-killer"
sources  = ["kmsg"]
match_text = "Out of memory: Kill process"
severity = "warn"
title    = "System ran out of memory"
body     = "Linux closed a program to free RAM — like iPadOS refreshing background apps. Close unused programs."

[[patterns]]
id       = "disk-io-error"
sources  = ["kmsg"]
match_text = "Buffer I/O error on device"
severity = "warn"
title    = "Storage error"
body     = "Install: sudo dnf install smartmontools — then check: sudo smartctl -a /dev/sda"

# ── Audio ─────────────────────────────────────────────────────────────────────

[[patterns]]
id       = "pipewire-connect-fail"
sources  = ["journald"]
match_text = "Failed to connect to PipeWire"
severity = "warn"
title    = "Sound system not responding"
body     = "Restart audio: systemctl --user restart pipewire pipewire-pulse wireplumber — or log out and back in."

[[patterns]]
id       = "bluetooth-rfkill-blocked"
sources  = ["journald"]
match_text = "Blocked through rfkill"
severity = "warn"
title    = "Bluetooth turned off by software"
body     = "Run: rfkill unblock bluetooth — in a terminal."

# ── Network ───────────────────────────────────────────────────────────────────

[[patterns]]
id       = "networkmanager-activation-fail"
sources  = ["journald"]
match_text = "Activation failed"
severity = "info"
title    = "Wi-Fi connection failed"
body     = "Check the network icon in the top bar, or: nmcli device status — in a terminal."

# ── Media ─────────────────────────────────────────────────────────────────────

[[patterns]]
id       = "missing-codec"
sources  = ["journald"]
match_text = "GStreamer: Failed to find plugin"
severity = "info"
title    = "Video or audio format not supported"
body     = "Fedora needs extra packages for some media formats. Enable RPM Fusion: sudo dnf install https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm — then: sudo dnf install gstreamer1-plugins-bad-free gstreamer1-plugins-ugly"