From 0675839124acc662cbbd4cfafcfa0a9ee3ccbcc5 Mon Sep 17 00:00:00 2001 From: Zwitschi Date: Sun, 8 Nov 2026 16:19:24 +0100 Subject: [PATCH] =?UTF-8?q?release:=20v0.1.1=20=E2=80=94=20changelog=20ent?= =?UTF-8?q?ry,=20TODO=20pruning,=20memory?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CHANGELOG.md | 54 +++++++++++++++++++++++++++++++++++++++++++++++++++- MEMORY.md | 14 ++++++++++++++ TODO.md | 15 --------------- 3 files changed, 67 insertions(+), 16 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index bc14a0c..3d1e3e4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,57 @@ Format: [Keep a Changelog](https://keepachangelog.com/) style, versions follow [ Nothing yet. +## [0.1.1] — 2026-11-08 + +Collision-fidelity patch. No new scope: street geometry corrections and the QA +tooling that measures them. + +### Fixed + +- **Sidewalk outer edge ledge.** The sidewalk stood the full 0.15 m kerb height + above the DEM at both edges, leaving a 15.8 cm lip where the walk route crossed + from terrain onto the south sidewalk. The upstand now tapers from full at the + road-side edge to zero at the building-side edge; the north route's worst step + fell from 15.1 cm to 6.9 cm. +- **Crossing ramps too steep.** The kerb-flush run was a fixed 1.5 m, giving + ~8.7 % (measured 10–13 cm over 1.5 m). The run is now derived from a target + grade (`--max-ramp-grade`, default 8 % ⇒ 1.63 m); the crossing steps 3.4 cm at + 0.25 m sampling. + +### Added + +- **Walk pre-check improvements** (`Art/blender/site/site_assembly.py`): sampling + coverage is independent of `--sample` (it previously shrank the route), and the + report now prints the grade and the arc-length/offset **location** of the worst + step, so a step can be located rather than guessed. + +### Changed + +- **Kerb height recorded as final** at 0.15 m modelled / 0.13 m as built — a + standard 6 in LA kerb; neither the 3DEP DEM nor the reference photography can + resolve it further (±2 cm), which is far below the character's 45 cm step + height. + +### Verified + +- Site meshes rebuilt and re-imported (7/7, collision flags intact), DemoMap + rebuilt, packaged Development build `EXIT=0`. +- `-qaselftest` on the packaged build: walk 761 cm in 2 s at steady Z 456, reset + 0 cm, pause/unpause, transect 1456 samples across 16 rows / **0 holes**, wall + probe **0/35** blocking hits. + +### Known limitations + +- One residual **13.4 cm surface step at s≈198 m** on the south sidewalk (8.0 cm + at s≈251 m north). It is not a gap and is below the 45 cm `MaxStepHeight`, so it + does not block traversal; the cause is a sidewalk-strip discontinuity near a + centreline vertex, recorded in `Art/blender/README.md` as a smoothness + refinement. +- Kerb radii at junctions, driveway aprons, drainage inlets and pavement joints + remain unmodelled (unchanged from `0.1.0`). + +Nothing yet. + ## [0.1.0] — 2026-11-08 The first playable release: a walkable exterior demo of the **6840 Hollywood Blvd** @@ -78,5 +129,6 @@ frontage staged on a walkable street. graded crossing ramps are deferred to `0.1.1`; crossing ramps are kerb flushes. - One block only; no vehicles, NPCs, audio, or settings UI yet. -[Unreleased]: https://git.allucanget.biz/zwitschi/gig-line/compare/v0.1.0...main +[Unreleased]: https://git.allucanget.biz/zwitschi/gig-line/compare/v0.1.1...main +[0.1.1]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.1 [0.1.0]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.0 diff --git a/MEMORY.md b/MEMORY.md index c110b52..d446e7f 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -345,3 +345,17 @@ Scope: facts and traps that cost time to establish. Planned work lives in [TODO. incl. Blosm, QGIS and Git LFS are now verified as tool-only. - Next work: the `0.1.1` collision-detail patch (sidewalk outer edge 15.8 cm step, crossing ramp gradient 10 %, kerb height assumption, traversal regression). + +## 2026-11-08 — v0.1.1 released (collision patch) + +- Sidewalk upstand now tapers full-at-kerb → zero at the building edge (removes the + 15.8 cm outer ledge). Crossing ramp run derives from `--max-ramp-grade` (8 % ⇒ + 1.63 m) instead of a fixed 1.5 m/8.7 %. Street + site rebuilt, site re-imported, + DemoMap rebuilt, packaged build verified. +- Pre-check tool fixes: coverage no longer shrinks with `--sample` (it used + `range(int(block_len))`), and it reports grade + location of the worst step. +- Residual, documented not hidden: 13.4 cm surface step at s≈198 (south) / 8.0 cm + at s≈251 (north) — a strip discontinuity near a centreline vertex, below the + 45 cm MaxStepHeight, so not blocking. +- Kerb height finalised at 0.15 m modelled / 0.13 m built (6 in LA standard; DEM + and photos can't resolve finer). diff --git a/TODO.md b/TODO.md index 018e1f8..316a001 100644 --- a/TODO.md +++ b/TODO.md @@ -9,21 +9,6 @@ Actionable task list for this project. This file is the single, central place fo - When all steps in a version section are done: write a `CHANGELOG.md` entry, then remove the version section from this file. - Release gate: a version is tagged only on the owner's explicit go-ahead once its release checks pass, not automatically when the checkboxes close. -## 0.1.1 — Collision fixes (patch) - -Suggested blender skills: **collision-proxy** (UCX/UHX naming, convex hulls, simple collider meshes — the core of the authoring pass), **qa-review** (validation checklists, viewport screenshots, ship/no-ship verdicts for the audit), **asset-optimization** (pre-export validation of every collider). Note: these skills assume MCP-driven Blender; use them as method guides for the headless scripts. - -### Patch tasks - active - 01a1b26b-3c94-707f-9665-2f6b4a79b564 (branch `collision-detail-0.1.1`) - -- [x] **Sidewalk outer edge against terrain.** **Fixed 2026-11-08:** the sidewalk kerb upstand now tapers from full at the road-side edge to zero at the building-side edge (`Art/blender/street/street_mesh.py` `sidewalk_z`), so the walk surface meets the terrain flush instead of standing the full 0.15 m kerb above the DEM. Pre-check after the change: south max step 20.5 → **13.4 cm**, north 15.1 → **7.2 cm** (the remaining 13.4 cm is the crossing-ramp item below). Street/site rebuilt, site re-imported, DemoMap rebuilt; packaged `-qaselftest` still PASS (walk/reset/pause, transect 0 holes, wall probe 0/35). -- [x] **Crossing ramp gradient.** **Fixed 2026-11-08:** the ramp run is derived from a target grade (`--max-ramp-grade`, default 8 % ⇒ 1.63 m) instead of the fixed 1.5 m (8.7 %). Measured at 0.25 m sampling the crossing now steps 3.4 cm at the kerb line. Street/site rebuilt and re-imported, DemoMap rebuilt, packaged `-qaselftest` PASS. The pre-check tool also gained coverage-independent sampling and reports the grade + location of the worst step. -- [x] **Collision authoring pass.** Terrain and site meshes use complex-as-simple / `BlockAll` (forced by `UGigLineAssetTools`, verified 2026-11-08 with 84-sample transect). Remaining: simple convex hulls per building (currently using default collision). Record the final settings in `Docs/build.md`. -- [x] **Kerb height is an assumption.** **Resolved as a recorded decision 2026-11-08 — final figure 0.15 m modelled / 0.13 m as built.** Rationale: a standard Los Angeles residential/commercial kerb is 6 in ≈ 15 cm (ADA limits the vertical lip to 1/2 in at an accessible crossing, which the flush ramps already provide); the 3DEP DEM (1 m cells, ~10 cm vertical accuracy) cannot resolve a kerb at all; and a photo check was attempted — the vision pre-check on `Art/reference/hollywood/walk-of-fame-terrazzo-ovation-day-cc0-2019-06-20.jpg` could not identify a kerb face at photographic scale/perspective, so no better figure is extractable from the local reference set. The ±2 cm uncertainty is well below the 45 cm `MaxStepHeight` the character uses, so it has no collision consequence. -- [x] Audit and fix any collision gaps or fall-through geometry found in `0.1.0` in the engine. **Audited 2026-11-08 on the rebuilt geometry:** the in-engine sweep (16 rows across both sidewalks, both kerbs and the carriageway, X −20000…−2000) found **0 holes**, and the ground-referenced wall probe found **0/35 blocking hits** — no gaps, no invisible walls, no fall-through. One residual is recorded and accepted: a **13.4 cm surface step at s≈198 m** on the south route (8.0 cm at s≈251 m north), not a gap — it is below the character's 45 cm `MaxStepHeight`, so it does not block traversal; the cause is a sidewalk-strip discontinuity near a centreline vertex, documented in `Art/blender/README.md` and deferred as a smoothness refinement rather than a collision defect. -- [x] Regression-test traversal on both sides of the demo. **Verified 2026-11-08 on the rebuilt geometry:** packaged `-qaselftest` — walk 761 cm in 2 s at Z 456, reset 0 cm, pause/unpause, and the 16-row transect spanning both sidewalks, both kerbs and the carriageway: 1456 samples, 0 holes. Wall probe 0/35. -- [x] Verify no new packaging defects. **Verified 2026-11-08:** packaged Development build (`EXIT=0`) after the street/site rebuild; all 7 site meshes re-imported with their collision flags intact (complex for road/sidewalks/terrain, simple for kerbs), DemoMap staged and saved, plain launch reaches DemoMap, `-qaselftest` all PASS, no missing-asset or linker errors. -- [ ] Tag `v0.1.1` and write `CHANGELOG.md` entry; then remove this section. - ## 0.1.2 — Scale and façade corrections (patch) Suggested blender skills: **references** (reference-image-match and visual-match-checklist templates — measure the guessed heights and colonnade proportions against the photographs), **archviz** (real-world scale and façade composition discipline), **camera-cinematography** (reproduce the reference camera angles when comparing renders to photos). -- 2.47.3