From c48404bd675a102fce938334ffc37e27a8645399 Mon Sep 17 00:00:00 2001 From: Zwitschi Date: Sun, 8 Nov 2026 15:19:13 +0100 Subject: [PATCH] qa: fresh-checkout build PASS (0.1.0 release check) Clean clone of main at 4bc41e9 + git lfs pull (check-lfs.sh OK, 130 files); GigLineEditor (28.2s) and GigLine (26.9s) both built from scratch with the documented external engine path. Evidence + exact steps recorded in Docs/release-checks.md; TODO item closed. --- Docs/release-checks.md | 29 ++++++++++++++++++++++++++++- TODO.md | 4 ++-- 2 files changed, 30 insertions(+), 3 deletions(-) diff --git a/Docs/release-checks.md b/Docs/release-checks.md index 839b641..b590a02 100644 --- a/Docs/release-checks.md +++ b/Docs/release-checks.md @@ -40,7 +40,7 @@ Measured at 1440p on the development workstation: Bazzite, Ryzen 7 7700X, 64 GB | `0.1.0` | Placement vs references | PASS (with deliberate simplifications) | Section below, 2026-11-08 | 2026-11-08 | | `0.1.0` | Collision and packaging | PASS — no blocking collision, no invisible walls, no seam gaps (see audit note) | `-qaselftest` on the packaged build, 2026-11-08 | 2026-11-08 | | `0.1.0` | 60 FPS at 1440p | PASS — 2.42 ms avg (414 fps), p99 3.01 ms at 2560×1440, TSR on, VSync off, no FG | `-qaselftest` perf capture, `Docs/perf/0.1.0-walk-frametimes.csv` | 2026-11-08 | -| `0.1.0` | Fresh checkout build | — | — | — | +| `0.1.0` | Fresh checkout build | PASS — clean clone of `main` (`4bc41e9`), `git lfs pull` + `check-lfs.sh` OK (130 LFS files), both `GigLineEditor` and `GigLine` targets built with the documented engine | `/tmp/fresh-check`, 2026-11-08 | 2026-11-08 | | `0.1.0` | Packaged Linux build | — | — | — | ## `0.1.0` — Placement vs references — record (2026-11-08) @@ -153,3 +153,30 @@ game instance / busy compositor overlapped the capture; repeated clean runs ``` Committed frame-time series: `Docs/perf/0.1.0-walk-frametimes.csv`. + +## `0.1.0` — Fresh checkout build — record (2026-11-08) + +Followed the documented steps in [`Docs/build.md`](build.md) exactly, into a clean +directory with no prior state: + +```bash +git clone https://git.allucanget.biz/zwitschi/gig-line.git /tmp/fresh-check +cd /tmp/fresh-check && git lfs install && git lfs pull +Tools/check-lfs.sh # -> "LFS check OK: 130 LFS-tracked file(s)" +cd /run/media/system/DATA/Engines/UE_5.8.4 +Engine/Build/BatchFiles/Linux/Build.sh GigLineEditor Linux Development \ + -project=/tmp/fresh-check/Game/GigLine/GigLine.uproject -WaitMutex +Engine/Build/BatchFiles/Linux/Build.sh GigLine Linux Development \ + -project=/tmp/fresh-check/Game/GigLine/GigLine.uproject -WaitMutex +``` + +- Clone of `main` at `4bc41e9`; LFS objects fetched (`DemoMap.umap` is real UE + package content, not a pointer). +- `GigLineEditor` → **Result: Succeeded** (28.2 s); produced + `/tmp/fresh-check/Game/GigLine/Binaries/Linux/libUnrealEditor-GigLine.so`. +- `GigLine` (game) → **Result: Succeeded** (26.9 s). +- Engine: documented external install at `/run/media/system/DATA/Engines/UE_5.8.4` + (UE 5.8.4), system clang; no machine-specific paths beyond the documented + `-project=` argument. + +**Verdict: PASS.** diff --git a/TODO.md b/TODO.md index 01a7602..5fb6cbc 100644 --- a/TODO.md +++ b/TODO.md @@ -106,14 +106,14 @@ The MPFB character asset is planned as the NPC template (see `ROADMAP.md`). Keep - [x] Commit and review the publication preparation changes before pushing. Initial publication commit: `101db3f`. - [x] Review ODbL obligations for each shipped derivative database or produced work before public release. **Done 2026-11-08** — full review recorded in `Docs/odbl-review.md`: the shipped streets/footprints/sidewalks are a Produced Work of the OpenStreetMap database; obligations held are on-screen attribution (`AGigLineHUD`), the ODbL link, and the committed source extract with provenance; share-alike applies to the data layer only (project code/art stay CC0). THIRD_PARTY_NOTICES and `Docs/licensing.md` updated. -### Release checks - active - 01a1b26b-3c94-707f-9665-2f6b4a79b564 (branch `fresh-checkout-0.1.0`) +### Release checks - [x] Player can traverse both sides of the demo without falling through geometry. **Verified 2026-11-08:** Blender pre-check plus an in-engine swept transect (`-qaselftest`) over the north sidewalk, carriageway and south sidewalk from X -14900 to -9420 — 84 samples, 0 holes, ground Z 317..395 (sidewalk 395, road 366, south walk 317). The player spawns at Z 456 and stays there for the whole run (`fall=0`, single Z). - [x] Building placement, street scale, and site identity checked against references. **Done 2026-11-08:** rendered current DemoMap content, probed world-space geometry (road 24.3 m vs ref 20.9–25.9 m; sidewalk centreline offsets 12.5/13.2 vs ref 12.6/13.6 m; hero frontage 26.0 m, setback ~13 m vs ref 25.75/14.5 m; frontage + north buildings in verified OSM positions), recorded PASS + deliberate deviations (flat blockout surfaces → `0.1.4`, kerb upstand → `0.1.1`, kerb-flush ramps → `0.1.1`) in `Docs/release-checks.md`, and fixed the mis-aimed north-buildings camera (was 9.5 km west → 85% sky; now frames the buildings). Final human verdict pending on `Screenshots/demo/*`. - [x] No blocking collision or packaging defects. **Done 2026-11-08:** extended `-qaselftest` — transect now 1456 samples / 16 rows including the kerb/road/sidewalk seam Ys (0 holes), plus a ground-referenced 30 m wall probe (0/35 blocking hits; no invisible walls). Walk/reset/pause all PASS on the packaged build; `GigLineShotActor` now skips under `-qaselftest`. Evidence in `Docs/release-checks.md` §`0.1.0` audit note. - [x] Remove TEMP QA diagnostics (`GigLine SIM` / `GigLine GROUND` log lines and the settle-timer log) from `GigLineCharacter.cpp` before the release tag, or gate them behind a cvar. **Done 2026-11-08:** SIM/GROUND probes were already removed in the input fix (PR #8); the remaining settle-timer + `GigLine IN:` input-setup logs are now gated behind the `gigline.SetupLogs` cvar (default 0 in `DefaultEngine.ini [ConsoleVariables]`, re-enable at runtime). Verified on the packaged build: 0 setup-log lines, `-qaselftest` still all PASS. - [x] 60 FPS at 1440p on the dev workstation (Bazzite, Ryzen 7 7700X, 64 GB RAM, RTX 5070 Ti 16 GB) using a documented quality preset; record upscaling state; report performance without frame generation. **Measured 2026-11-08:** Epic preset, TSR on, VSync off, no frame gen — **2.42 ms avg (414 fps), p99 3.01 ms** at 2560×1440 over the fixed `-qaselftest` walk route; frame-time series in `Docs/perf/0.1.0-walk-frametimes.csv`, record in `Docs/release-checks.md`. -- [A] Fresh project checkout builds with the documented external engine installation. +- [x] Fresh project checkout builds with the documented external engine installation. **Verified 2026-11-08:** clean clone of `main` (`4bc41e9`) + `git lfs pull` (`check-lfs.sh` OK, 130 files); `GigLineEditor` (28.2 s) and `GigLine` (26.9 s) both `Result: Succeeded` with the documented engine path. Record in `Docs/release-checks.md`. - [ ] Package Linux build with documented controls. - [ ] Tag `v0.1.0` and write `CHANGELOG.md` entry; then remove this section.