I hate workflows

Author: freakdaniel

.github/workflows/build.yml

@@ -111,12 +111,21 @@ jobs:
 
       - name: Prepare Flatpak runtimes
         run: |
-          flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
-          flatpak install --user -y flathub \
+          sudo flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
+          sudo flatpak install -y flathub \
             org.freedesktop.Platform//24.08 \
             org.freedesktop.Sdk//24.08 \
             org.electronjs.Electron2.BaseApp//24.08
 
+      - name: Diagnose Flatpak environment
+        run: |
+          echo "=== flatpak --version ==="
+          flatpak --version
+          echo "=== system remotes ==="
+          flatpak remotes --system || true
+          echo "=== system runtimes (24.08 / Electron2) ==="
+          flatpak list --system --runtime | grep -E 'freedesktop|electronjs|24\.08|Electron2' || true
+
       - name: Build Linux ${{ matrix.arch }}
         run: |
           chmod +x Scripts/publish.sh

Docs/English/Development/Contributing.md

@@ -24,7 +24,8 @@
 - Linux package app ID is `com.hyprismteam.hyprism`.
 - AppStream metadata is injected for Linux packaging from `Packaging/linux/com.hyprismteam.hyprism.metainfo.xml`.
 - RPM repack step intentionally strips `/usr/lib/.build-id` payload and does not own system directories (`/`, `/usr`, `/usr/lib`) to avoid install conflicts on Fedora.
-- Flatpak packaging uses runtime/base `24.08`; CI prepares Flathub and installs `org.freedesktop.Platform`, `org.freedesktop.Sdk`, and `org.electronjs.Electron2.BaseApp` for that version before build.
+- Flatpak packaging uses runtime/base `24.08`; CI prepares Flathub with `sudo flatpak remote-add` and installs `org.freedesktop.Platform`, `org.freedesktop.Sdk`, and `org.electronjs.Electron2.BaseApp` at the **system** level before build.
+- Linux CI also prints Flatpak remotes/runtimes diagnostics after install to simplify troubleshooting when flatpak-bundler fails.
 
 ## Adding a New Feature
 

Docs/Russian/Development/Contributing.md

@@ -24,7 +24,8 @@
 - Linux package app ID: `com.hyprismteam.hyprism`.
 - AppStream-метаданные для Linux-пакетов берутся из `Packaging/linux/com.hyprismteam.hyprism.metainfo.xml`.
 - На этапе repack для RPM намеренно удаляется payload `/usr/lib/.build-id`, а системные директории (`/`, `/usr`, `/usr/lib`) не добавляются как владельцы пакета — это предотвращает конфликты установки на Fedora.
-- Для Flatpak используется runtime/base `24.08`; в CI перед сборкой подключается Flathub и устанавливаются `org.freedesktop.Platform`, `org.freedesktop.Sdk` и `org.electronjs.Electron2.BaseApp` этой версии.
+- Для Flatpak используется runtime/base `24.08`; в CI перед сборкой Flathub подключается через `sudo flatpak remote-add`, а `org.freedesktop.Platform`, `org.freedesktop.Sdk` и `org.electronjs.Electron2.BaseApp` устанавливаются на **system**-уровень.
+- После установки Linux CI выводит диагностику remotes/runtimes Flatpak, чтобы упрощать разбор сбоев flatpak-bundler.
 
 ## Добавление новой функции