release: v0.1.1 — changelog entry, TODO pruning (#22)

Merged PR #22: v0.1.1 release prep

Co-authored-by: Zwitschi <zwitschi82@gmail.com>
This commit is contained in:
zwitschi authored and zwitschi committed 2026-11-08 16:19:30 +01:00
1 parent e75e5500a7
commit 74312ad6de
3 files changed
+67 -16

No files matched your search

+53 -1
View File
@@ -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
+14
View File
@@ -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).
-15
View File
@@ -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).