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.