From 8c73d16a3961fa2136a237cfb7e88b95959a6994 Mon Sep 17 00:00:00 2001 From: Zwitschi Date: Fri, 6 Nov 2026 21:41:16 +0100 Subject: [PATCH] docs: record git-lfs/clang/cmake/ninja install and flag the stale QGIS flatpak git-lfs 3.7.1 with an active lfs filter, clang 23.1.4, cmake 4.3.0, ninja 1.13.2. The flathub lts branch installed QGIS 3.28.9 on an EOL Qt5 runtime, so it is recorded as an invalid pin with the replacement path. --- Docs/setup.md | 13 ++++++++----- Docs/toolchain.md | 7 ++++--- 2 files changed, 12 insertions(+), 8 deletions(-) diff --git a/Docs/setup.md b/Docs/setup.md index f65a2cd..dae3083 100644 --- a/Docs/setup.md +++ b/Docs/setup.md @@ -14,7 +14,8 @@ Anything marked **human step** needs credentials, licence acceptance, or a decis `ujust update` (or `rpm-ostree upgrade`) followed by a reboot. Deployment `45.20261105` is booted and default; `44.20261026` retained as rollback. - `[x]` Verify the NVIDIA driver and Vulkan from the desktop session. `nvidia-smi` names the RTX 5070 Ti on driver `615.78.08` and the Wayland desktop renders through it. Vulkan enumerates it as GPU0: discrete, proprietary driver `615.78.08`, API `1.4.351`, conformance `1.4.3.3`. The integrated RADV GPU is GPU1 — watch that the engine does not select it. Evidence in [environment.md](environment.md). -- `[ ]` Install `git-lfs`, `cmake`, `ninja-build`, `clang` as an ostree layer, reboot, then `git lfs install`. +- `[x]` Install `git-lfs`, `cmake`, `ninja-build`, `clang` as an ostree layer, reboot, then `git lfs install`. + Done: `git-lfs 3.7.1`, `clang 23.1.4`, `cmake 4.3.0`, `ninja 1.13.2`; lfs filter active, `Tools/check-lfs.sh` passes. ## 2. Engine acquisition @@ -28,7 +29,8 @@ Anything marked **human step** needs credentials, licence acceptance, or a decis ## 3. Tooling pins - `[x]` Blender 5.2 LTS (Flatpak) and MPFB 2.0.18 recorded. -- `[ ]` Install QGIS (`flatpak install flathub org.qgis.qgis`) and record its version. +- `[-]` Install QGIS and record its version. + The flathub `lts` branch installed **3.28.9** on an end-of-life Qt5 runtime — not an acceptable pin. Mirror the upstream LTR instead: `flatpak install flathub --user org.qgis.qgis//stable`, and if that is also stale, move QGIS into a distrobox container from the Fedora package. Details in [environment.md](environment.md). - `[ ]` Install Blosm in Blender, record its version, and confirm it loads on Blender 5.2. Fall back to a side-by-side Blender 4.5 LTS only for the blockout step if it does not. - `[ ]` Confirm the geo tool Python environment (venv with `pyproj`, `GDAL`, `shapely` from the QGIS or distrobox environment) and record it. @@ -60,7 +62,8 @@ Sizes: the engine lives outside the repository (pinned install path recorded in | Blocker | Owner | Needed for | | --- | --- | --- | -| Reboot into the staged `45.20261105` deployment | human | Everything; the current deployment is older than the staged one | | Epic account, license acceptance, engine download | human | All Unreal work | -| `git-lfs` package install (needs admin) | human | Any content commit | -| `nvidia-smi` / Vulkan confirmation in a normal terminal | human | Engine validation | +| QGIS pin: replace the stale `3.28.9` flatpak | human | Geo pipeline | +| Blosm install and Blender 5.2 compatibility check | human | OSM blockouts | + +Closed: Bazzite update and reboot, driver and Vulkan verification, `git-lfs`/`clang`/`cmake`/`ninja` layering. diff --git a/Docs/toolchain.md b/Docs/toolchain.md index 211b3d4..02e0a72 100644 --- a/Docs/toolchain.md +++ b/Docs/toolchain.md @@ -15,9 +15,10 @@ Audited 2026-11-06 on the development workstation. | Blender | `5.2` LTS (upstream patch `5.2.3`) | Flatpak `org.blender.Blender` | Installed. | | MPFB | `2.0.18` (extension `mpfb`, declares Blender >= 4.2) | Blender extensions platform | Installed. Load-and-export check on 5.2 still pending. | | Blosm | latest release at install time | blosm.com / Gumroad | Not installed. Version must be recorded before first use. | -| QGIS | `3.44.15` LTR | qgis.org | Not installed. | +| QGIS | `3.44.15` LTR targeted; installed flatpak is `3.28.9` | qgis.org / flathub | **Not a valid pin.** The `lts` flatpak branch is 3.28.9 on an end-of-life Qt5 runtime. Replace via `stable` or distrobox, then pin. See [environment.md](environment.md). | | Git | `2.56.0` | Bazzite image | Installed. | -| Git LFS | `3.x` | `rpm-ostree` layer | Not installed. **Required** before committing any file matched by `.gitattributes`. | +| Git LFS | `3.7.1` | `rpm-ostree` layer | Installed; `git lfs install` run, lfs filter active. | +| Host build tools | `clang 23.1.4`, `cmake 4.3.0`, `ninja 1.13.2` | `rpm-ostree` layer | Installed. These are host tools, not the engine toolchain. | | distrobox | `1.8.2.5` | Bazzite image | Installed. | | Python (tooling) | `3.14.8` system | Bazzite image | Installed. Use a venv for geo/tool scripts. | | ffmpeg | `8.1.3` | Bazzite image | Installed. | @@ -35,5 +36,5 @@ Unreal Engine 5.9 is in preview and Unreal Engine 6 has been announced as of Nov 1. **Blosm on Blender 5.2.** Blosm versions historically lag Blender releases. Verify Blosm against the installed Blender 5.2 before the blockout step. If it fails, add a side-by-side Blender 4.5 LTS Flatpak and convert that step's output only; do not mix Blender versions within one asset. 2. **MPFB 2.0.18 on Blender 5.2.** The extension declares Blender >= 4.2 but predates 5.x. The acceptance test is the `0.1.0` requirement to export one MPFB character with baked materials and a deform skeleton and import it into Unreal. -3. **QGIS LTR transition.** QGIS 4.4.0 entered LTR on 2026-10-30 but LTR binaries were still `3.44.15` at audit time. Do not pin `4.4.0` until its installers exist; switching LTR later is a documented migration. +3. **QGIS flatpak tracks a stale LTR.** The flathub `lts` branch is `3.28.9` (2022) on `org.kde.Platform 5.15-21.08`, which is end-of-life. A 2022 QGIS still converts CRS and edits vectors correctly, but its PROJ/GDAL data and processing algorithms are four years behind the current LTR, and the runtime gets no security fixes. Replace it before the geo pipeline depends on it; record whichever version ends up pinned. 4. **Driver and Vulkan validation on Bazzite.** Not an officially supported Unreal distribution. Validate before asset production, as `ROADMAP.md` requires.