release: v0.1.6 — retail frontage changelog entry, TODO pruning

Writes the 0.1.6 entry, removes the completed section from TODO.md (its goal stays in ROADMAP.md per the convention), and updates the roadmap status line. Release checks: 5/5 shots verify, scene audit 0 failures, 82 tool tests, LFS check clean, owner approval recorded for the retail shot.
review: owner approves the 0.1.6 retail frontage shot
2026-11-09 10:10:50 +01:00 · 2026-11-09 10:09:40 +01:00 · 2026-11-09 10:07:27 +01:00 · 2026-11-09 09:54:33 +01:00 · 2026-11-09 09:54:15 +01:00 · 2026-11-09 09:33:23 +01:00
124 changed files with 4895 additions and 518 deletions
@@ -47,6 +47,10 @@ Thumbs.db
 /Geo/raw/mapbox-cache/
 /Geo/verification/*mapbox*
 # Visual-loop iterations: generated comparisons stay uncommitted until the owner
 # confirms a shot. Only Screenshots/ is committed.
 /Art/reference/iterations/
 # Local, private reference material — never committed (see Docs/reference-notes-hollywood.md)
 /Art/reference/
 /Docs/data-inventory.md
@@ -67,6 +67,7 @@ Rules for `TODO.md`:
 - When **all** steps in a version section are done: write a short descriptive entry to `CHANGELOG.md`, remove the version section from `TODO.md`, and leave its goal in `ROADMAP.md`.
 - Release checks for each version are listed at the end of its `TODO.md` section; `Docs/release-checks.md` defines the checks themselves. If a check fails, do not tag the release; open a patch task in `TODO.md` and report the failing check in `CHANGELOG.md`.
 - Finish each milestone's release checks **before** expanding scope. Cut map size and simulation complexity before compromising the core walking/driving experience.
 - **Realism leads, performance is a floor.** When a realism improvement costs frame time, realism wins and the cost is paid — but 60 FPS at 1440p without frame generation must still be met at every release. If realism cannot fit the budget, reduce the realism scope deliberately and record it in `CHANGELOG.md`; never ship below the floor without the owner's approval. Walkability outranks realism in one direction only: a block the player falls through is not a demo.
 ## Git workflow
@@ -209,8 +210,8 @@ Any change that affects the game's appearance — meshes, materials, lighting, l
 1. Run `Tools/render_screenshots.sh` (rebuilds `Game/GigLine/Content/Test/ReviewMap.umap` from current content, runs the game on it, captures the fixed camera list, copies the PNGs into `Screenshots/`).
 2. Optional pre-check with a vision model: `Tools/judge_screenshot.py --image <shot.png> --expect "<what it should show>"` (or `--shots` to run every shot in the README) flags likely-missing content before a human looks. It reads `OPENROUTER_API_KEY` from `.env` (ignored). Small helper only — it never replaces the human verdict.
-3. Update `Screenshots/README.md`: one row per screenshot with what it shows and an approval state; describe any new shots or scene changes in the same change.
+3. Update `Screenshots/README.md`: the image is **embedded inline** (`![alt](demo/<shot>.png)`) with its view, expected content, verification and approval state, plus one row in the status table at the top. The point is that the review happens in the file; a path alone is not a review. Describe any new shots or scene changes in the same change.
 4. The PNGs **are committed** so reviewers see exactly what the build rendered (`.gitignore` does not exclude them). Keep them in sync with this README: drop retired shots in the same change.
-5. Wait for the user's approval before treating a visual change as done; record approval by ticking the table in `Screenshots/README.md`.
+5. Wait for the user's approval before treating a visual change as done; record approval by ticking both the shot's section and its row in the status table in `Screenshots/README.md`.
 New content that needs a different camera angle gets a new entry in the shot list in `Tools/ue_build_review_map.py`.
@@ -37,6 +37,15 @@
      ],
      "evidence": "6 columns at 4.96 m centres (sibling notes x measured frontage)"
    },
    {
      "object": "Hero_Flute_x120",
      "dims_m": [
        0.064,
        0.064,
        6.53
      ],
      "evidence": "photographs: fluted shafts; 20 grooves per column modelled as shallow cylinders in the shadow tone rather than boolean cut grooves"
    },
    {
      "object": "Hero_ColumnBase_x6",
      "dims_m": [
@@ -104,10 +113,10 @@
      "object": "Hero_MottoBand",
      "dims_m": [
        22.75,
-        0.08,
+        0.1,
        0.85
      ],
-      "evidence": "photographs: motto panel above the colonnade"
+      "evidence": "photographs: motto panel above the colonnade, now an inset panel with a moulded surround rather than a flat stripe"
    },
    {
      "object": "Hero_Medallion_x2",
@@ -0,0 +1,64 @@
 # Reference analysis — retail frontage, 0.1.6
 Phase 0 of the `references` pack (reference-image-match). Written before any geometry, because the pass that produced the hero façade skipped it and cost two rebuilds.
 ## Source
 |  |  |
 | --- | --- |
 | Image | `Art/reference/retail-neighbours/01-lee-drug-and-neighbor.jpg` (1920×953) |
 | Author / licence | Gb321, own work, **CC BY-SA 4.0** — attribution required |
 | Captured | 2024-07-19 11:11 local |
 | Description | "Lee Drug and 6806 Hollywood Buildings in Hollywood" |
 | Coverage | Both target buildings in one frame, mid-morning sun from the south-east |
 **One photograph is the whole evidence base for 6800 and 6806–6820.** It is a street-level oblique, not an elevation: verticals converge, the ground floor of 6806–6820 is partly behind a parked car, and the Lee Drug shopfront is behind a bus. Everything below that the photo does not resolve is marked _assumed_ and is carried into the part report.
 **6822 Budget has no photograph.** It is a 6.0 m × 5.5 m single-storey sliver west of 6806–6820, and the TODO item already records that Commons has nothing usable. It stays a blockout extrusion and the item is deferred rather than guessed.
 ## Measured (not from the photo)
 From `Geo/raw/osm-api-map-2026-11-06.osm` and the blockout, in the shared frame (metres, X east, Y north, Z from the project datum):
 | Building | OSM way | X | Front face Y | Height | Depth |
 | --- | --- | --- | --- | --- | --- |
 | 6800 Lee Drug | 424024149 | −33.20 … −14.37 | −14.63 | 12.10 m | 33.5 m |
 | 6806–6820 | 424024150 | −66.08 … −33.07 | −12.52 | 12.10 m | 30.8 m |
 | 6822 Budget | 424024144 | −78.54 … −72.52 | −12.92 | 5.50 m | 15.4 m |
 Both target buildings are 12.10 m tall, which makes the _relative_ proportions in the photo directly usable: the parapet line, the cornice and the shopfront line can be read as fractions of the frame height.
 ## 6800 Lee Drug — reading
 | Category | Observation |
 | --- | --- |
 | Subject | Corner retail block at Hollywood × Highland; the street face and the corner return are both visible |
 | Silhouette | Long low box, broken by a **rounded corner tower** that rises above the frontage parapet; the parapet is **stepped**, not flat |
 | Storeys | Two zones, not storeys: a tall shopfront zone and a single tall display wall above it |
 | Proportion (vertical) | Shopfront ≈ 0 → 0.36 H; bronze cornice ≈ 0.36 → 0.43 H; mural + lettering wall ≈ 0.43 → 0.82 H; stepped parapet ≈ 0.82 → 1.0 H (_assumed split; read off the frame, ±0.03 H_) |
 | Proportion (horizontal) | Corner tower occupies ≈ 4 m of the east end; eight mural panels at roughly 2.2 m centres along the frontage |
 | Colour | Cream stucco wall `#EDE6D8`, bronze/brown cornice `#6B4A2F`, near-black mural plates `#1C1A18`, dark glazing `#20262A` (_sampled from the frame_) |
 | Unique features | Stepped Deco parapet with 4 horizontal reveal lines; projecting bronze cornice; row of black celebrity-portrait panels; large dark "SOUVENIRS OF …" lettering on the upper wall; shopfront glazing with slim mullions |
 | Mood | 1930s Deco retail, freshly painted, bright midday |
 ## 6806–6820 — reading
 | Category | Observation |
 | --- | --- |
 | Silhouette | Flat-fronted two-storey block; parapet steps up in fins at the west end |
 | Proportion (vertical) | Shopfront ≈ 0 → 0.32 H; burgundy fascia band ≈ 0.32 → 0.38 H; window storey ≈ 0.38 → 0.62 H; blank wall + parapet ≈ 0.62 → 1.0 H (_assumed_) |
 | Horizontal | Brown pilaster strips divide the frontage into roughly 3 m bays; seven upper windows across 33 m |
 | Colour | Same cream stucco; brown pilasters `#6B4A2F`; **burgundy-green** fascia `#5B3A3A`; white window frames |
 | Unique features | Banded parapet with 3 reveal lines; white-framed upper windows with security bars; shopfront glazing behind a burgundy fascia |
 ## Camera match (for the review shot)
 The photo is a street-level oblique from the **north** side looking south-east, subject filling ~80 % of the frame width. The demo review shot must reproduce that: camera at 1.7 m on the north sidewalk, yaw toward the south frontage, 35–42° lens, both buildings in frame. A wide block view will not compare usefully against this crop.
 ## Assumptions to carry into the model report
 1. Vertical proportions, as above — the photo's convergence makes a pixel-perfect read impossible.
 2. Mural panel size and spacing; the lettering is modelled as a recessed plate, not as text.
 3. Shopfront bay spacing on both buildings; the bus hides most of Lee Drug's ground floor.
 4. Parapet reveal line count (4 on Lee Drug, 3 on 6806–6820).
 5. Corner tower radius; only the outer curve is visible.
@@ -8,6 +8,125 @@ Format: [Keep a Changelog](https://keepachangelog.com/) style, versions follow [
 Nothing yet.
 ## [0.1.6] — 2026-11-09
 Retail frontage. The two retail buildings beside the hero are modelled from their own photograph instead of the generic kit, and the photograph is treated as evidence: an analysis is written before any geometry, and every dimension the image does not resolve is carried into the part report as an assumption.
 ### Added
 - **`Tools/retail_frontage_build.py`**: 6800 Lee Drug and 6806–6820 built from the one usable reference (`Art/reference/retail-neighbours/`, Gb321, CC BY-SA 4.0). Lee Drug gets a bronze cornice, storefront glazing with mullions, framed portrait panels, a painted lettering band, two-tier parapet with reveals and a fluted corner tower; 6806–6820 gets a burgundy fascia, brown pilasters, white-framed windows with security bars and its own banded parapet. Built in world coordinates from the blockout bounds (Lee Drug X −33.20…−14.37, face Y −14.63, H 12.10 m; 6806–6820 X −66.08…−33.07), joined to one mesh per building with a JSON part report.
 - **`Tools/ue_import_retail_detail.py`**: imports the two meshes with complex-as-simple collision — trim decorates a solid the player already collides with and must not add snag points.
 - **`Art/blender/retail/ref-analysis.md`**: the reference analysis the `references` skill pack requires, written before modelling.
 - **`Tools/_common.py`** and `Tools/tests/test_retail_frontage.py`: the bay-layout arithmetic, extracted so it is testable without Blender (4 tests).
 - **Review shot 5**, `demo/review-demo-retail-frontage`, embedded in `Screenshots/README.md`.
 ### Changed
 - **The generic façade kit skips the two modelled buildings** (`MODELLED` list in `ue_apply_facade_kit.py`). It applies to every `Frontage_*`/`North_*` actor, so it was pasting a second, contradicting façade language over the new trim.
 - **Retail trim stages as `RetailTrim_*`** and is spawned through the demo builder, so it is regenerable rather than hand-placed.
 - Trim stucco, white and glass slots are mapped onto the demo's look-dev materials so the walls sit in the same noise and texture family as the rest of the block; the tones sampled from the photograph (bronze, burgundy, mural, lettering) stay as authored.
 ### Fixed
 - **`Tools/render_screenshots.sh` never captured anything.** The capture step called `./Engine/...` while every commandlet above it went through `run_cmdlet`'s `cd "$ENGINE"`. Under `set -e` the script died at exit 127 _after_ rebuilding the maps, so the PNGs silently stayed a day old and `--verify` never ran.
 - **Duplicate `RetailTrim_*` actors on every rebuild**: the demo builder's clear list did not include the new label, so each run stacked another copy. Caught by the scene audit, not by eye.
 - **Mural plates were placed 0.20 m inside the solid blockout volume** and never rendered; the inset is now faked with a proud frame and a near-flush plate.
 - **Trim detail sat 0.05 m off the wall**, under a pixel of depth at 40 m, so the wall won the depth test. Trim planes now stand 0.10–0.20 m proud.
 - **6806–6820 parapet started at 0.62 H**, leaving a 4.6 m blank band; the window storey and parapet moved up to follow the photograph.
 - **Mural panels, parapet and lettering were sized from the photograph's proportions, not the inherited defaults**: the first pass left a parapet that read as one blank white band.
 ### Verified
 - `render_screenshots.sh --verify`: **5/5 shots OK**; scene audit **0 failures** (every mesh materialed, all spans in tolerance, no duplicate labels).
 - Owner approved `demo-retail-frontage` (second pass) 2026-11-09; all five demo shots now carry approval.
 - 82 tool tests pass.
 ### Known limitations
 - **Wall lettering and the painted band do not read at 40 m.** A plate at 0.10 m still vanishes; this is a decal/texture problem, not geometry. Moved to `0.9.0 — Realistic buildings`.
 - **The parapet has no moulded profile** and the corner tower is a fluted cylinder with two cap rings — both need the façade system in `0.9.0`.
 - **6822 Budget is untouched**: no photograph of it exists. Deferred and blocked in `0.9.0`.
 - The only reference for these two buildings is a single street-level oblique with a bus across Lee Drug's shopfront and a car across 6806's; several vertical proportions are assumptions recorded in the part report.
 ## [0.1.5] — 2026-11-09
 Façade finishing. The kit gets the hero detail it was missing, and a class of silent defect is found and gated: the map had been rendering with **604 of 620 mesh actors unmaterialed** without a single error.
 ### Added
 - **Scene audit** (`Tools/ue_audit_scene.py`): fails when any staged mesh has no material, when a frontage building is more than ±1 m off its verified footprint, or when two actors share a label. Wired into `Tools/render_screenshots.sh`, which now runs the whole staging chain in the correct order and stops on an audit failure.
 - **`Tools/ue_placement.py`**: one source of truth for staged positions and the verified frontage spans, with `span_error` / `describe_span_failure` validators.
 - **Hero fluting**: 20 grooves per column as shallow shadow-tone cylinders (120 pieces) rather than boolean cuts.
 - **Presence of references for the retail run**: `Art/reference/retail-neighbours/` (6800 Lee Drug and its neighbour). Local only, not committed.
 ### Changed
 - **Motto band is a real recess** now — moulded surround 6 cm proud, panel 12 cm behind — instead of an 8 cm dark stripe. Hero: 148 parts / 3 044 tris → 271 / 5 492, still 14.50 m.
 - **Kit layout for wide and tall buildings**: bays are capped at 9 with the module widened (6922 was 13 bays across 65.8 m — a window every 4.96 m on a 37 m block), and the storey spread is derived from the available height so the top band always lands inside the volume.
 ### Fixed
 - **604 of 620 mesh actors rendered untextured.** `ensure_material` deleted and recreated each site material on every run, orphaning every reference held by the kit pieces and the theatre trim; the map looked only slightly flat. Materials are now updated in place.
 - **The hero could be teleported 13 m east onto the wrong side of the boulevard.** `ue_hero_facade_import.py` carried its own copy of the pre-`0.1.0` hero position; running the importer alone moved the building, invisible in a render and visible only as a reference-score drop. Placement now has one definition and the import asserts the staged span (`span ok: X -14644..-12028`).
 - **53 duplicated kit actor labels** (both shop piers of a bay shared one name).
 ### Verified
 - Scene audit: **0 failures** — every mesh materialed, all 7 verified spans within tolerance, no duplicate labels.
 - Packaged `-qaselftest`: walk, reset, pause/unpause, seam transect 1456 samples / 0 holes, wall probe 0/35, façade probe 0/9 — all PASS.
 - **1440p re-measured with the kit**: 2.76 ms average (**363 fps**), p99 3.64 ms, against `0.1.0`'s 2.42 ms (414 fps) — the 625 kit actors and 8 textures cost about 12 % and leave roughly six times the 60 fps floor. Series at `Docs/perf/0.1.5-kit-walk-frametimes.csv`.
 - 78 tool tests pass.
 ### Known limitations
 - **Retail neighbours 6822 and 6806–6820 are not modelled**: Commons holds no usable reference for either, and substituting the El Capitan Theatre's photographs would misattribute their façades. Tracked in `TODO.md`.
 - Cornice dentil spacing, abacus and plinth dimensions remain recorded assumptions.
 - Textures are generated, not authored — no decals, signage text or weathering maps.
 - The vision pre-check stays advisory; it has rejected shots the owner approved.
 ## [0.1.4] — 2026-11-09
 Building façades. The block goes from flat extruded boxes with flat colours to coursed, textured surfaces assembled from a reusable module kit, and the El Capitan Theatre gets the marquee and blade sign that make it read as itself.
 ### Added
 - **Façade module kit** at the measured **4.96 m bay** / **3.10 m storey**: pilaster, sill, lintel, window bay, shopfront bay, door bay, cornice, parapet and coping — 16 `SM_` meshes, each validated for manifold topology (12 tris each) and assembled onto **eight buildings, 625 pieces**, from each building's own world bounds.
 - **Generated surface textures** — deterministic stdlib PNGs for ashlar stone, stucco, asphalt and concrete (base colour + roughness), sampled world-aligned with per-material tiling; byte-identical on re-run.
 - **Materials**: masonry coursing and roughness variation in the material graphs; `M_FacadeStoneShadow`, `M_FacadeGlass` (specular 0.62 ≈ IOR 1.5) and `M_FacadeBanner`. Material assignment is now **per slot**, keyed on the imported slot material, instead of slot 0 only.
 - **El Capitan Theatre trim**: projecting marquee (12.0 × 2.60 m canopy at a 4.60 m soffit), illuminated fascia, recessed soffit, and a vertical blade sign (1.30 × 5.20 m) with frame and wall bracket.
 - **Visual review loop** (`Tools/visual_loop.py` + `visual_targets.json`): verifies every capture against an expectation (missing, blank, tone-less or wrong-size shots fail) and measures each render against its reference photograph, emitting feedback that names the discipline to consult. Iterations are written under `Art/reference/iterations/`, which is gitignored until a shot is confirmed.
 - **`Tools/fbx_export_preset.py`** — one export preset replacing six copies, and it exports smoothing groups (`FACE`), so round geometry is no longer faceted.
 - **`Tools/ue_common.py`** — clears the read-only bit an LFS `.umap` checks out with and makes a refused save loud.
 ### Changed
 - **Elevation cameras** are levelled (pitch 0, so verticals stay parallel) and use a 42–55° lens to fill the frame from across the street.
 - **`Screenshots/` holds demo-map captures only**; the review staging map is no longer rendered for review. Each shot carries its expected content and an approval state.
 ### Fixed
 - **Blockout frame**: the `0.1.2` regeneration had run without `--origin`, shifting the whole frontage ≈119 m in X and 2.4 m in Y and dropping the hero out of the 6902/6838 gap. Regenerated with the affine fit (residual 0.0 cm) and every span re-verified against the block verification notes.
 - **Kit placed ~12 km from its buildings** — it used the mesh-local bounding box, which excludes the actor offset.
 - **Marquee mirrored across the boulevard** (Blender +Y is Unreal −Y) and **hanging 5 cm above the pavement** (absolute Z instead of pavement-relative).
 - **Window bays invisible** inside the solid wall; the surround now projects with glazing inset.
 - **Glazing was not glass**: kit pieces kept the grey material the FBX import creates.
 - **Hero windows floated 1.44 m in front of the wall**; parapet medallions were flat discs on the coping.
 - **Imports could report success while saving nothing** (read-only LFS map), and the north-buildings import failed silently on a missing `import sys`.
 ### Verified
 - Packaged build `-qaselftest`: walk 761 cm, reset, pause/unpause, seam transect 1456 samples / 0 holes, wall probe 0/35, façade occlusion probe 0/9 — all PASS. Run twice; the harness is time-based and one loaded run reported a false failure.
 - All eight buildings probed against the verified world spans.
 - 67 tool tests pass.
 ### Known limitations
 - Kit pieces are boxes; cornice dentil spacing, abacus and plinth dimensions are recorded assumptions.
 - Textures are generated, not authored: no decals, signage text or weathering maps.
 - The vision pre-check remains advisory — it is unreliable on this content.
 - Retail neighbours, hero fluting and the blockout cleaning pass move to `0.1.5`.
 - Performance has not been re-measured since `0.1.0`; 625 kit actors are unmeasured.
 ## [0.1.3] — 2026-11-09
 Packaging and setup fixes. No gameplay or visual scope; this patch makes the pipeline and its documentation tell the truth about what `0.1.x` taught.
@@ -129,7 +248,9 @@ The first playable release: a walkable exterior demo of the **6840 Hollywood Blv
 - Kerb height (0.13 m as built vs 0.15 m assumed), kerb radii, driveway aprons and 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.3...main
+[Unreleased]: https://git.allucanget.biz/zwitschi/gig-line/compare/v0.1.5...main
 [0.1.5]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.5
 [0.1.4]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.4
 [0.1.3]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.3
 [0.1.2]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.2
 [0.1.1]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.1
@@ -20,11 +20,14 @@ Full requirements and progress are in [TODO.md](../../TODO.md); version directio
 | Priority | Quality Goal | Scenario |
 | --- | --- | --- |
-| 1 | **Performance efficiency** | 60 FPS at 2560×1440 on RTX 5070 Ti, documented preset, no frame generation |
+| 1 | **Visual realism** | Renders read as the reference photographs: façade identity, proportion, material and light — judged side by side, shot against photo |
-| 2 | **Terrain walkability** | Zero raycast holes across both sidewalks and the carriageway (84-sample transect passes) |
+| 2 | **Geographic fidelity** | Building placement and street scale match the measured data and the photographs |
-| 3 | **Geographic fidelity** | Building placement, street scale, and façade identity match reference photography |
+| 3 | **Terrain walkability** | Zero raycast holes across both sidewalks and the carriageway (84-sample transect passes) |
 | 4 | **Build reproducibility** | Fresh checkout + documented engine path produces a runnable Linux build |
 | 5 | **Provenance** | Every committed asset has recorded provenance |
 | 6 | **Performance efficiency** | 60 FPS at 2560×1440 on RTX 5070 Ti, documented preset, no frame generation |
 **How the order is used.** It decides trade-offs. When realism and performance disagree, realism wins and the cost is paid — but never by silently shipping a frame rate below the floor. The 60 FPS figure is a **budget that must still be met**, so the response to "realism costs too much frame time" is to cut the realism feature deliberately, record the cut, and keep the floor — not to let frames slip. Walkability outranks realism in one direction only: a beautiful block the player falls through is not a demo.
 ## Stakeholders
@@ -30,7 +30,8 @@ All modelling and geographic processing live outside the game project in `Art/`,
 ## Quality achievement
- **Performance**: dynamic-only lighting (no build step, no static shadow maps), world-space-noise materials (cheap procedural variation), minimal overdraw (simple street-level geometry).
+- **Realism first**: reference photography and measured data drive every façade decision; renders are compared against the photographs with `Tools/visual_loop.py`, and a façade is built from the shared 4.96 m module kit so the street wall reads consistently. Materials are authored in Unreal with world-aligned generated textures, and lighting is fixed daytime so a shot is comparable between runs.
 - **Performance as a budget, not a driver**: dynamic-only lighting (no build step, no static shadow maps), world-space-noise materials (cheap procedural variation), minimal overdraw for street-level geometry, and a 60 FPS at 1440p floor that every release must meet. It closes the quality list because it constrains how much realism fits, not what the block should look like.
 - **Walkability**: complex-as-simple collision on terrain (C++ helper forces the flag on the asset), block-all collision on every site mesh, swept transect QA verifies zero raycast holes.
@@ -47,6 +47,7 @@ Static meshes and materials in `/Game/Hollywood/Site/`:
 | `SM_HeroFacade` | El Capitan Entertainment Centre detailed façade |
 | `SM_ElCapitanTheatre`, `SM_Budget_6822`, `SM_Hollywood_6806`, `SM_Hollywood_6902`, `SM_Hollywood_6922`, `SM_LeeDrug_6800` | South block frontage (6 buildings) |
 | `SM_Madame_Tussauds`, `SM_TCL_Chinese_Theatre` | North-side buildings (within 50 m) |
 | `SM_Retail_LeeDrug`, `SM_Retail_6806` | Retail trim over 6800 and 6806–6820, modelled from their own photograph (`Tools/retail_frontage_build.py`, staged as `RetailTrim_*`). `6822 Budget` stays a bare volume: no photograph exists. |
 ### Art Pipeline
@@ -54,13 +55,14 @@ Python scripts in `Tools/` drive the content pipeline:
 | Script group | Purpose |
 | --- | --- |
-| `export_*`, `hero_facade_build` | Blender headless export (FBX) |
+| `export_*`, `hero_facade_build`, `retail_frontage_build`, `theatre_trim_build`, `facade_kit_build` | Blender headless export (FBX); trim builders work in world coordinates |
-| `ue_import_*`, `ue_hero_facade_import` | Unreal headless import + placement |
+| `ue_import_*`, `ue_hero_facade_import`, `ue_import_retail_detail` | Unreal headless import + placement |
 | `ue_build_demo_map`, `ue_build_review_map` | Map assembly (lighting, meshes, player start) |
 | `ue_create_input_assets` | Enhanced Input actions + mapping context |
 | `render_screenshots.sh` | Screenshot capture pipeline |
 | `judge_screenshot.py` | Vision-model pre-check (optional) |
 | `input_emulation.py`, `input_test.py` | OS-level virtual keyboard/mouse injection for input verification |
 | `Tools/_common.py` | Pure helper shared by Blender builders, importable without Blender (bay layout) |
 | `Tools/tests/` | Stdlib `unittest` tests for the pure parts of the tools (`requirements-tools.txt`) |
 | `Geo/tools/mapbox_buildings.py` | Second height source: Mapbox `mapbox-streets-v8` building data vs our OSM heights |
@@ -55,3 +55,11 @@
 - **Decision**: All Blender work driven by Python scripts in `Tools/`. Skill packs used as method guides (checklists, naming, proportions) only.
 - **Consequences**: Scripts are version-controlled and repeatable. No live Blender session needed for CI.
 ## ADR-8: Realistic building façades are a minor milestone, not a patch
 - **Context**: `0.1.4` carried the first façade pass as a _patch_, while the release policy says patches contain fixes and refinements and never new scope. The `0.1.6` retail pass then showed what that costs: a façade built in a patch has no release gate of its own, so a first pass that does not yet read as the building (`Screenshots/README.md`, 0.1.6 gaps) can sit inside a "done" patch series. Realism is also the project's leading quality goal, which a patch cannot carry.
 - **Decision**: Building realism gets its own minor milestone, `0.9.0 — Realistic buildings`, placed before the feature freeze. Its scope is the façade system (orders, profile library, storefront types, signage as decals), per-building photo-matched models, a measured material library with a texel-density rule, and LODs plus collision proxies. Patches keep fixes and refinements only. Renumbered by this decision: the former `0.9.0` freeze/beta/audit milestone becomes `0.10.0`, its patches `0.10.1`–`0.10.3`, and `1.0.0` moves to weeks 39–44.
 - **Consequences**: Façade work now has a release gate — every building measured against its own photograph, every building with a collision proxy and a LOD, no placeholder materials — so "modelled" means verified, not merely present. The price is that realism work stops being sliced into patches, and the schedule shifts by one minor cycle. Blockouts without a photograph stay blockouts and are listed as such, rather than being dressed up to fill the milestone.
@@ -2,24 +2,44 @@
 ## Quality Requirements Overview
-| Category | Requirement | Priority |
+Ordered by priority: realism first, performance last. The order decides design trade-offs; it does not license dropping a lower item silently (see the trade-off rule below the table).
 | Priority | Category | Requirement |
 | --- | --- | --- |
-| Performance efficiency | 60 FPS at 2560×1440, documented preset, no frame generation | 1 |
+| 1 | Realism / Fidelity | Façade identity, proportion, material and lighting read like the reference photographs when compared side by side |
-| Reliability / Terrain | Zero raycast holes across sidewalks and carriageway (84-sample transect) | 1 |
+| 2 | Realism / Fidelity | Building placement matches the measured footprints and the photographs (within ~1 m) |
-| Accuracy / Fidelity | Building placement matches reference photography within ~1 m | 2 |
+| 2 | Realism / Fidelity | Street scale (lane width, sidewalk width) within ~10 cm of the measured profile |
-| Accuracy / Fidelity | Street scale (lane width, sidewalk width) within ~10 cm of measured profile | 2 |
+| 3 | Reliability / Terrain | Zero raycast holes across sidewalks and carriageway (84-sample transect) |
-| Usability | WASD + mouse look, jump, reset (R), pause (Escape) — no tutorial needed | 2 |
+| 3 | Usability | WASD + mouse look, jump, reset (R), pause (Escape) — no tutorial needed |
-| Maintainability | Fresh checkout builds with documented engine installation | 2 |
+| 4 | Maintainability | Fresh checkout builds with the documented engine installation |
-| Portability | Linux build packages and runs; Windows build ships | 3 |
+| 4 | Portability | Linux build packages and runs; Windows build ships |
 | 5 | Provenance | Every committed asset has a recorded source and licence |
 | 6 | Performance efficiency | 60 FPS at 2560×1440, documented preset, no frame generation |
 **Trade-off rule.** Realism leads: when a realism improvement costs frame time, the improvement wins. Performance is still a **floor, not a preference** — 60 FPS at 1440p without frame generation must be met at every release. If realism cannot fit inside that budget, reduce the realism scope deliberately and record the reduction in `CHANGELOG.md`; never ship below the floor without the owner's explicit approval. Walkability outranks realism in one direction: a block the player falls through is not a demo, whatever it looks like.
 ## Quality Scenarios
 | ID | Source/Stimulus | Response | Metric |
 | --- | --- | --- | --- |
-| QS-1 | Player walks both sides of the demo | No fall-through, character stays at ground Z | 0 raycast holes in 84-sample transect |
+| QS-1 | Screenshot is compared against its reference photograph | The render reads as the same building | Similarity score and visual match confirmed by the owner; `Tools/visual_loop.py` reports the deltas |
-| QS-2 | Player holds W for 2 s on flat road | Character moves forward | ≥ 200 cm displacement, Z constant within ±5 cm |
+| QS-2 | A façade is placed from measured data | It sits on its verified footprint | World span probed against `Geo/verification/` within ~1 m |
-| QS-3 | Player presses R | Character teleports to spawn | < 100 cm from `StartLocation` |
+| QS-3 | Player walks both sides of the demo | No fall-through, character stays at ground Z | 0 raycast holes in 84-sample transect |
-| QS-4 | Player presses Escape | Game pauses, cursor appears | `IsGamePaused()` = true |
+| QS-4 | Player holds W for 2 s on flat road | Character moves forward | ≥ 200 cm displacement, Z constant within ±5 cm |
-| QS-5 | Player presses Escape while paused | Game unpauses, cursor hides | `IsGamePaused()` = false |
+| QS-5 | Player presses R | Character teleports to spawn | < 100 cm from `StartLocation` |
-| QS-6 | Game runs on dev workstation at 1440p | Frame rate stable | ≥ 60 FPS, 99th percentile ≥ 55 FPS |
+| QS-6 | Player presses Escape | Game pauses, cursor appears | `IsGamePaused()` = true |
-| QS-7 | Fresh checkout + engine install | Build succeeds | Exit code 0, runnable binary produced |
+| QS-7 | Player presses Escape while paused | Game unpauses, cursor hides | `IsGamePaused()` = false |
 | QS-8 | Fresh checkout + engine install | Build succeeds | Exit code 0, runnable binary produced |
 | QS-9 | Game runs on dev workstation at 1440p | Frame rate holds the floor | ≥ 60 FPS, 99th percentile ≥ 55 FPS |
 > QS-9 is last on purpose. Performance is a floor that every release must meet, not the goal that shapes the content: realism decides what gets built, the frame budget decides how much of it.
 ### Building realism gate (0.9.0)
 | ID | Check | Metric |
 | --- | --- | --- |
 | BR-1 | A building with a reference photograph has a review shot compared against it | Silhouette and proportion deltas recorded per building in `Screenshots/README.md`; owner approval per shot |
 | BR-2 | Every building is either photo-matched or explicitly recorded as an unfounded blockout | List in `TODO.md`; no building in an in-between state |
 | BR-3 | Every building has a collision proxy and at least one LOD | Count of buildings missing either = 0 |
 | BR-4 | No surface carries a placeholder material | Material audit in `Tools/ue_audit_scene.py` reports 0 placeholder slots |
 | BR-5 | The realism pass does not break the floor | QS-9 still holds at 1440p, with the measured cost of the pass recorded |
@@ -27,11 +27,14 @@ Full requirements and progress are in [TODO.md](../../TODO.md); version directio
 | Priority | Quality Goal | Scenario |
 | --- | --- | --- |
-| 1 | **Performance efficiency** | 60 FPS at 2560×1440 on RTX 5070 Ti, documented preset, no frame generation |
+| 1 | **Visual realism** | Renders read as the reference photographs: façade identity, proportion, material and light — judged side by side, shot against photo |
-| 2 | **Terrain walkability** | Zero raycast holes across both sidewalks and the carriageway (84-sample transect passes) |
+| 2 | **Geographic fidelity** | Building placement and street scale match the measured data and the photographs |
-| 3 | **Geographic fidelity** | Building placement, street scale, and façade identity match reference photography |
+| 3 | **Terrain walkability** | Zero raycast holes across both sidewalks and the carriageway (84-sample transect passes) |
 | 4 | **Build reproducibility** | Fresh checkout + documented engine path produces a runnable Linux build |
 | 5 | **Provenance** | Every committed asset has recorded provenance |
 | 6 | **Performance efficiency** | 60 FPS at 2560×1440 on RTX 5070 Ti, documented preset, no frame generation |
 **How the order is used.** It decides trade-offs. When realism and performance disagree, realism wins and the cost is paid — but never by silently shipping a frame rate below the floor. The 60 FPS figure is a **budget that must still be met**, so the response to "realism costs too much frame time" is to cut the realism feature deliberately, record the cut, and keep the floor — not to let frames slip. Walkability outranks realism in one direction only: a beautiful block the player falls through is not a demo.
 ## Stakeholders
@@ -129,7 +132,9 @@ All modelling and geographic processing live outside the game project in `Art/`,
 ## Quality achievement
- **Performance**: dynamic-only lighting (no build step, no static shadow maps), world-space-noise materials (cheap procedural variation), minimal overdraw (simple street-level geometry).
+- **Realism**: reference photography drives every façade decision, measured data fixes placement and scale, and renders are compared against the photographs (`Tools/visual_loop.py`, `Screenshots/README.md`). One module kit at the 4.96 m bay keeps the street wall coherent; materials are world-aligned and lit by a fixed daytime rig so a shot is comparable between runs.
 - **Performance holds the floor, it does not set the agenda**: dynamic-only lighting (no build step, no static shadow maps), cheap procedural materials, minimal overdraw for street-level geometry, and 60 FPS at 1440p as a budget every release must meet.
 - **Walkability**: complex-as-simple collision on terrain (C++ helper forces the flag on the asset), block-all collision on every site mesh, swept transect QA verifies zero raycast holes.
@@ -186,6 +191,7 @@ Static meshes and materials in `/Game/Hollywood/Site/`:
 | `SM_HeroFacade` | El Capitan Entertainment Centre detailed façade |
 | `SM_ElCapitanTheatre`, `SM_Budget_6822`, `SM_Hollywood_6806`, `SM_Hollywood_6902`, `SM_Hollywood_6922`, `SM_LeeDrug_6800` | South block frontage (6 buildings) |
 | `SM_Madame_Tussauds`, `SM_TCL_Chinese_Theatre` | North-side buildings (within 50 m) |
 | `SM_Retail_LeeDrug`, `SM_Retail_6806` | Retail trim over 6800 and 6806–6820, modelled from their own photograph (`Tools/retail_frontage_build.py`, staged as `RetailTrim_*`). `6822 Budget` stays a bare volume: no photograph exists. |
 ### Art Pipeline
@@ -193,13 +199,14 @@ Python scripts in `Tools/` drive the content pipeline:
 | Script group | Purpose |
 | --- | --- |
-| `export_*`, `hero_facade_build` | Blender headless export (FBX) |
+| `export_*`, `hero_facade_build`, `retail_frontage_build`, `theatre_trim_build`, `facade_kit_build` | Blender headless export (FBX); trim builders work in world coordinates |
-| `ue_import_*`, `ue_hero_facade_import` | Unreal headless import + placement |
+| `ue_import_*`, `ue_hero_facade_import`, `ue_import_retail_detail` | Unreal headless import + placement |
 | `ue_build_demo_map`, `ue_build_review_map` | Map assembly (lighting, meshes, player start) |
 | `ue_create_input_assets` | Enhanced Input actions + mapping context |
 | `render_screenshots.sh` | Screenshot capture pipeline |
 | `judge_screenshot.py` | Vision-model pre-check (optional) |
 | `input_emulation.py`, `input_test.py` | OS-level virtual keyboard/mouse injection for input verification |
 | `Tools/_common.py` | Pure helper shared by Blender builders, importable without Blender (bay layout) |
 | `Tools/tests/` | Stdlib `unittest` tests for the pure parts of the tools (`requirements-tools.txt`) |
 | `Geo/tools/mapbox_buildings.py` | Second height source: Mapbox `mapbox-streets-v8` building data vs our OSM heights |
@@ -448,29 +455,57 @@ Rule: place a building only against a neighbour or street mesh, never in isolati
 # Quality Requirements
 ## ADR-8: Realistic building façades are a minor milestone, not a patch
 - **Context**: `0.1.4` carried the first façade pass as a _patch_, while the release policy says patches contain fixes and refinements and never new scope. The `0.1.6` retail pass then showed what that costs: a façade built in a patch has no release gate of its own, so a first pass that does not yet read as the building (`Screenshots/README.md`, 0.1.6 gaps) can sit inside a "done" patch series. Realism is also the project's leading quality goal, which a patch cannot carry.
 - **Decision**: Building realism gets its own minor milestone, `0.9.0 — Realistic buildings`, placed before the feature freeze. Its scope is the façade system (orders, profile library, storefront types, signage as decals), per-building photo-matched models, a measured material library with a texel-density rule, and LODs plus collision proxies. Patches keep fixes and refinements only. Renumbered by this decision: the former `0.9.0` freeze/beta/audit milestone becomes `0.10.0`, its patches `0.10.1`–`0.10.3`, and `1.0.0` moves to weeks 39–44.
 - **Consequences**: Façade work now has a release gate — every building measured against its own photograph, every building with a collision proxy and a LOD, no placeholder materials — so "modelled" means verified, not merely present. The price is that realism work stops being sliced into patches, and the schedule shifts by one minor cycle. Blockouts without a photograph stay blockouts and are listed as such, rather than being dressed up to fill the milestone.
 ## Quality Requirements Overview
-| Category | Requirement | Priority |
+Ordered by priority: realism first, performance last. The order decides design trade-offs; it does not license dropping a lower item silently (see the trade-off rule below the table).
 | Priority | Category | Requirement |
 | --- | --- | --- |
-| Performance efficiency | 60 FPS at 2560×1440, documented preset, no frame generation | 1 |
+| 1 | Realism / Fidelity | Façade identity, proportion, material and lighting read like the reference photographs when compared side by side |
-| Reliability / Terrain | Zero raycast holes across sidewalks and carriageway (84-sample transect) | 1 |
+| 2 | Realism / Fidelity | Building placement matches the measured footprints and the photographs (within ~1 m) |
-| Accuracy / Fidelity | Building placement matches reference photography within ~1 m | 2 |
+| 2 | Realism / Fidelity | Street scale (lane width, sidewalk width) within ~10 cm of the measured profile |
-| Accuracy / Fidelity | Street scale (lane width, sidewalk width) within ~10 cm of measured profile | 2 |
+| 3 | Reliability / Terrain | Zero raycast holes across sidewalks and carriageway (84-sample transect) |
-| Usability | WASD + mouse look, jump, reset (R), pause (Escape) — no tutorial needed | 2 |
+| 3 | Usability | WASD + mouse look, jump, reset (R), pause (Escape) — no tutorial needed |
-| Maintainability | Fresh checkout builds with documented engine installation | 2 |
+| 4 | Maintainability | Fresh checkout builds with the documented engine installation |
-| Portability | Linux build packages and runs; Windows build ships | 3 |
+| 4 | Portability | Linux build packages and runs; Windows build ships |
 | 5 | Provenance | Every committed asset has a recorded source and licence |
 | 6 | Performance efficiency | 60 FPS at 2560×1440, documented preset, no frame generation |
 **Trade-off rule.** Realism leads: when a realism improvement costs frame time, the improvement wins. Performance is still a **floor, not a preference** — 60 FPS at 1440p without frame generation must be met at every release. If realism cannot fit inside that budget, reduce the realism scope deliberately and record the reduction in `CHANGELOG.md`; never ship below the floor without the owner's explicit approval. Walkability outranks realism in one direction: a block the player falls through is not a demo, whatever it looks like.
 ## Quality Scenarios
 | ID | Source/Stimulus | Response | Metric |
 | --- | --- | --- | --- |
-| QS-1 | Player walks both sides of the demo | No fall-through, character stays at ground Z | 0 raycast holes in 84-sample transect |
+| QS-1 | Screenshot is compared against its reference photograph | The render reads as the same building | Similarity score and visual match confirmed by the owner; `Tools/visual_loop.py` reports the deltas |
-| QS-2 | Player holds W for 2 s on flat road | Character moves forward | ≥ 200 cm displacement, Z constant within ±5 cm |
+| QS-2 | A façade is placed from measured data | It sits on its verified footprint | World span probed against `Geo/verification/` within ~1 m |
-| QS-3 | Player presses R | Character teleports to spawn | < 100 cm from `StartLocation` |
+| QS-3 | Player walks both sides of the demo | No fall-through, character stays at ground Z | 0 raycast holes in 84-sample transect |
-| QS-4 | Player presses Escape | Game pauses, cursor appears | `IsGamePaused()` = true |
+| QS-4 | Player holds W for 2 s on flat road | Character moves forward | ≥ 200 cm displacement, Z constant within ±5 cm |
-| QS-5 | Player presses Escape while paused | Game unpauses, cursor hides | `IsGamePaused()` = false |
+| QS-5 | Player presses R | Character teleports to spawn | < 100 cm from `StartLocation` |
-| QS-6 | Game runs on dev workstation at 1440p | Frame rate stable | ≥ 60 FPS, 99th percentile ≥ 55 FPS |
+| QS-6 | Player presses Escape | Game pauses, cursor appears | `IsGamePaused()` = true |
-| QS-7 | Fresh checkout + engine install | Build succeeds | Exit code 0, runnable binary produced |
+| QS-7 | Player presses Escape while paused | Game unpauses, cursor hides | `IsGamePaused()` = false |
 | QS-8 | Fresh checkout + engine install | Build succeeds | Exit code 0, runnable binary produced |
 | QS-9 | Game runs on dev workstation at 1440p | Frame rate holds the floor | ≥ 60 FPS, 99th percentile ≥ 55 FPS |
 > QS-9 is last on purpose. Performance is a floor that every release must meet, not the goal that shapes the content: realism decides what gets built, the frame budget decides how much of it.
 ### Building realism gate (0.9.0)
 | ID | Check | Metric |
 | --- | --- | --- |
 | BR-1 | A building with a reference photograph has a review shot compared against it | Silhouette and proportion deltas recorded per building in `Screenshots/README.md`; owner approval per shot |
 | BR-2 | Every building is either photo-matched or explicitly recorded as an unfounded blockout | List in `TODO.md`; no building in an in-between state |
 | BR-3 | Every building has a collision proxy and at least one LOD | Count of buildings missing either = 0 |
 | BR-4 | No surface carries a placeholder material | Material audit in `Tools/ue_audit_scene.py` reports 0 placeholder slots |
 | BR-5 | The realism pass does not break the floor | QS-9 still holds at 1440p, with the measured cost of the pass recorded |
 # Risks and Technical Debts
@@ -86,8 +86,13 @@ The hero block and the demo level are built by a fixed sequence. Each step write
 | North import | `Tools/ue_import_north_buildings.py` | `/Game/Hollywood/North/*` |
 | Hero import | `Tools/ue_hero_facade_import.py` | `/Game/Hollywood/ElCapitan/SM_HeroFacade` |
 | Demo map | `Tools/ue_build_demo_map.py` | `/Game/Hollywood/DemoMap` |
 | Façade kit assembly | `Tools/ue_apply_facade_kit.py` | kit actors in `DemoMap` |
 | Theatre trim | `Tools/ue_stage_theatre_trim.py` | marquee + blade sign actors |
 | Scene audit | `Tools/ue_audit_scene.py` | materials, placement spans, labels (gate) |
 | Review shots | `Tools/ue_build_review_map.py` + `Tools/render_screenshots.sh` | `Screenshots/` |
 **Order matters.** `ue_build_demo_map.py` rebuilds the site materials, so any actor staged by another tool must be (re)staged _after_ it, or it keeps a reference to a material that no longer exists — that is how 604 actors once ended up untethered from their materials while the map only looked slightly flat. `Tools/render_screenshots.sh` runs the full chain in the right order and gates on `ue_audit_scene.py`.
 Every Blender exporter calls [`Tools/fbx_export_preset.py`](../Tools/fbx_export_preset.py) (`ue_metric_v1` / `ue_character_v1`) instead of repeating the FBX argument block — one place for the scale conversion, the axis mapping and `mesh_smooth_type="FACE"` (without which every Unreal import warns about missing smoothing groups and round geometry arrives faceted).
 Two rules that the pipeline enforces rather than documents:
@@ -0,0 +1,728 @@
 frame,ms
 0,2.599
 1,2.877
 2,2.709
 3,2.646
 4,3.168
 5,2.729
 6,2.524
 7,2.726
 8,2.639
 9,2.814
 10,2.819
 11,2.708
 12,2.822
 13,2.703
 14,2.365
 15,2.796
 16,2.899
 17,2.972
 18,2.908
 19,2.356
 20,2.781
 21,2.574
 22,3.148
 23,2.306
 24,2.668
 25,2.855
 26,2.588
 27,3.321
 28,3.419
 29,3.121
 30,3.391
 31,2.355
 32,2.679
 33,3.463
 34,2.614
 35,2.922
 36,2.429
 37,2.830
 38,2.842
 39,2.782
 40,3.252
 41,2.731
 42,2.577
 43,2.363
 44,2.786
 45,2.547
 46,2.594
 47,2.652
 48,2.836
 49,2.792
 50,2.552
 51,2.792
 52,2.718
 53,3.333
 54,2.165
 55,2.880
 56,2.613
 57,2.460
 58,2.919
 59,2.770
 60,2.551
 61,2.622
 62,2.712
 63,2.818
 64,3.155
 65,2.472
 66,2.861
 67,2.651
 68,2.573
 69,2.892
 70,2.689
 71,2.729
 72,2.668
 73,2.753
 74,2.812
 75,2.606
 76,2.686
 77,2.842
 78,2.660
 79,2.903
 80,2.486
 81,2.591
 82,3.626
 83,2.455
 84,2.475
 85,2.922
 86,2.603
 87,2.728
 88,3.057
 89,2.731
 90,3.632
 91,1.950
 92,2.694
 93,3.020
 94,2.230
 95,2.796
 96,2.707
 97,2.807
 98,2.658
 99,2.697
 100,2.453
 101,3.051
 102,2.758
 103,2.662
 104,2.599
 105,2.733
 106,2.751
 107,2.894
 108,2.501
 109,2.753
 110,2.873
 111,2.439
 112,2.634
 113,2.682
 114,2.913
 115,2.692
 116,2.735
 117,2.758
 118,2.726
 119,2.907
 120,2.568
 121,2.764
 122,2.815
 123,2.530
 124,2.684
 125,2.719
 126,2.846
 127,2.879
 128,2.647
 129,2.770
 130,2.477
 131,2.657
 132,2.675
 133,2.917
 134,2.700
 135,2.493
 136,2.678
 137,2.786
 138,3.004
 139,2.697
 140,2.642
 141,2.624
 142,2.684
 143,2.717
 144,2.743
 145,2.740
 146,2.825
 147,2.849
 148,2.991
 149,2.297
 150,3.084
 151,2.459
 152,3.214
 153,2.260
 154,2.550
 155,2.621
 156,2.660
 157,2.739
 158,2.574
 159,3.078
 160,2.735
 161,2.607
 162,2.793
 163,2.798
 164,2.584
 165,2.637
 166,2.627
 167,2.726
 168,2.656
 169,2.788
 170,2.674
 171,2.782
 172,2.766
 173,2.613
 174,2.724
 175,2.770
 176,2.709
 177,2.700
 178,2.600
 179,2.686
 180,2.747
 181,2.841
 182,2.601
 183,2.666
 184,2.846
 185,2.599
 186,2.806
 187,3.126
 188,2.521
 189,2.634
 190,2.716
 191,2.584
 192,2.714
 193,2.923
 194,2.277
 195,2.706
 196,2.606
 197,2.758
 198,2.747
 199,2.958
 200,2.798
 201,2.387
 202,2.596
 203,2.861
 204,2.801
 205,2.521
 206,2.869
 207,2.884
 208,2.515
 209,2.592
 210,3.723
 211,2.474
 212,2.736
 213,2.774
 214,2.769
 215,3.007
 216,2.768
 217,2.716
 218,2.694
 219,2.722
 220,2.862
 221,2.587
 222,2.833
 223,2.792
 224,2.746
 225,2.585
 226,2.741
 227,2.585
 228,2.802
 229,2.674
 230,2.742
 231,2.718
 232,2.881
 233,2.707
 234,2.585
 235,2.810
 236,2.948
 237,2.718
 238,2.773
 239,2.571
 240,2.788
 241,2.702
 242,2.634
 243,2.788
 244,2.678
 245,2.914
 246,2.527
 247,2.637
 248,2.877
 249,2.693
 250,2.644
 251,2.670
 252,2.700
 253,2.877
 254,2.638
 255,2.617
 256,2.774
 257,2.660
 258,2.731
 259,2.671
 260,2.838
 261,2.726
 262,2.671
 263,2.744
 264,2.735
 265,2.684
 266,3.850
 267,2.120
 268,2.669
 269,2.729
 270,2.712
 271,2.817
 272,2.926
 273,2.678
 274,2.786
 275,2.927
 276,2.493
 277,2.846
 278,2.610
 279,2.644
 280,2.577
 281,2.939
 282,2.727
 283,2.595
 284,2.819
 285,2.778
 286,2.774
 287,2.628
 288,2.711
 289,2.699
 290,2.715
 291,2.763
 292,2.710
 293,2.892
 294,2.721
 295,2.575
 296,3.608
 297,2.811
 298,2.739
 299,2.751
 300,2.608
 301,2.913
 302,3.052
 303,2.862
 304,2.653
 305,2.727
 306,2.646
 307,2.888
 308,3.338
 309,2.743
 310,2.639
 311,2.681
 312,2.846
 313,2.766
 314,3.184
 315,2.834
 316,2.728
 317,2.581
 318,2.770
 319,3.351
 320,3.157
 321,2.508
 322,2.835
 323,2.754
 324,2.411
 325,3.398
 326,2.802
 327,2.611
 328,3.058
 329,2.407
 330,2.640
 331,3.645
 332,2.729
 333,2.580
 334,2.902
 335,2.523
 336,3.005
 337,3.173
 338,2.840
 339,2.610
 340,2.576
 341,2.706
 342,3.405
 343,2.849
 344,2.678
 345,2.796
 346,2.782
 347,2.636
 348,3.475
 349,2.798
 350,2.745
 351,2.564
 352,2.792
 353,2.714
 354,3.496
 355,2.841
 356,2.465
 357,2.708
 358,2.692
 359,2.934
 360,3.304
 361,2.561
 362,2.689
 363,2.749
 364,2.780
 365,2.940
 366,3.025
 367,2.706
 368,2.881
 369,2.619
 370,2.716
 371,3.133
 372,2.874
 373,2.816
 374,2.414
 375,2.737
 376,2.797
 377,2.651
 378,2.920
 379,3.032
 380,2.606
 381,2.710
 382,2.649
 383,2.700
 384,3.469
 385,2.224
 386,2.567
 387,2.733
 388,2.511
 389,2.950
 390,3.979
 391,2.798
 392,2.487
 393,2.740
 394,2.741
 395,2.718
 396,3.291
 397,2.769
 398,2.697
 399,2.796
 400,2.641
 401,2.652
 402,3.151
 403,2.673
 404,2.741
 405,2.606
 406,2.665
 407,2.859
 408,2.739
 409,2.586
 410,2.910
 411,2.745
 412,2.698
 413,2.670
 414,2.797
 415,2.829
 416,2.643
 417,2.776
 418,2.772
 419,2.530
 420,2.567
 421,2.826
 422,2.782
 423,2.738
 424,2.640
 425,2.967
 426,2.600
 427,3.020
 428,2.502
 429,2.642
 430,2.625
 431,2.770
 432,2.659
 433,2.717
 434,2.698
 435,2.780
 436,2.992
 437,2.686
 438,2.560
 439,3.048
 440,2.721
 441,2.507
 442,2.694
 443,2.695
 444,2.892
 445,3.443
 446,2.633
 447,2.908
 448,2.823
 449,2.346
 450,2.599
 451,2.914
 452,2.774
 453,3.391
 454,2.384
 455,2.585
 456,2.667
 457,2.704
 458,2.674
 459,2.755
 460,2.718
 461,2.804
 462,2.583
 463,2.694
 464,2.797
 465,3.079
 466,2.434
 467,2.723
 468,3.671
 469,2.211
 470,2.567
 471,2.701
 472,2.717
 473,2.657
 474,2.581
 475,2.889
 476,3.006
 477,2.595
 478,2.703
 479,2.498
 480,2.694
 481,2.915
 482,2.655
 483,2.686
 484,2.833
 485,2.717
 486,2.723
 487,2.451
 488,2.913
 489,2.784
 490,2.684
 491,2.651
 492,2.809
 493,2.819
 494,2.676
 495,2.851
 496,2.775
 497,2.638
 498,2.520
 499,2.824
 500,2.930
 501,2.757
 502,2.608
 503,2.808
 504,2.508
 505,2.819
 506,2.654
 507,2.748
 508,2.705
 509,2.798
 510,2.559
 511,2.694
 512,2.821
 513,2.706
 514,2.612
 515,2.928
 516,2.475
 517,2.830
 518,2.658
 519,2.784
 520,2.572
 521,2.935
 522,2.688
 523,2.600
 524,2.675
 525,2.828
 526,2.774
 527,2.848
 528,2.764
 529,2.379
 530,2.962
 531,2.989
 532,2.528
 533,2.639
 534,2.906
 535,2.543
 536,2.582
 537,2.949
 538,2.813
 539,2.504
 540,2.754
 541,2.638
 542,2.695
 543,2.662
 544,2.922
 545,2.616
 546,2.810
 547,2.675
 548,2.551
 549,2.894
 550,2.754
 551,2.632
 552,2.748
 553,2.827
 554,2.751
 555,2.759
 556,2.684
 557,2.766
 558,2.948
 559,2.461
 560,2.621
 561,2.772
 562,2.985
 563,2.582
 564,2.897
 565,2.574
 566,2.661
 567,2.742
 568,2.797
 569,2.632
 570,2.755
 571,2.878
 572,2.759
 573,3.812
 574,2.651
 575,2.862
 576,2.577
 577,2.634
 578,3.173
 579,2.418
 580,2.714
 581,2.746
 582,2.794
 583,2.774
 584,2.583
 585,3.659
 586,3.222
 587,2.489
 588,2.868
 589,2.558
 590,2.586
 591,2.599
 592,2.930
 593,2.401
 594,2.540
 595,2.889
 596,2.733
 597,2.664
 598,2.877
 599,2.588
 600,2.677
 601,2.897
 602,2.672
 603,2.780
 604,2.740
 605,2.780
 606,2.493
 607,2.794
 608,2.631
 609,2.768
 610,2.870
 611,2.626
 612,2.862
 613,2.602
 614,2.868
 615,2.627
 616,2.638
 617,2.702
 618,2.904
 619,2.918
 620,2.487
 621,3.225
 622,2.350
 623,2.820
 624,2.837
 625,2.408
 626,2.593
 627,3.526
 628,2.554
 629,2.746
 630,2.684
 631,2.729
 632,2.762
 633,2.768
 634,3.034
 635,2.514
 636,2.732
 637,2.739
 638,2.692
 639,2.832
 640,2.810
 641,2.484
 642,2.632
 643,3.284
 644,2.311
 645,3.079
 646,2.656
 647,2.683
 648,2.622
 649,2.668
 650,2.779
 651,2.796
 652,2.874
 653,2.427
 654,2.644
 655,2.872
 656,2.867
 657,2.404
 658,2.917
 659,2.773
 660,2.857
 661,2.789
 662,2.443
 663,2.651
 664,2.839
 665,2.814
 666,2.575
 667,2.796
 668,2.709
 669,2.873
 670,2.670
 671,2.936
 672,2.496
 673,2.608
 674,2.641
 675,2.793
 676,2.765
 677,2.736
 678,2.679
 679,2.987
 680,2.884
 681,2.469
 682,2.774
 683,2.948
 684,2.598
 685,3.478
 686,2.856
 687,4.623
 688,3.038
 689,2.507
 690,2.717
 691,2.682
 692,2.807
 693,2.778
 694,2.699
 695,2.802
 696,2.605
 697,2.650
 698,2.789
 699,2.791
 700,3.015
 701,2.539
 702,2.790
 703,2.698
 704,2.637
 705,2.657
 706,2.800
 707,2.720
 708,2.702
 709,2.845
 710,2.583
 711,2.780
 712,2.782
 713,2.593
 714,2.695
 715,2.747
 716,2.871
 717,2.671
 718,2.676
 719,2.991
 720,2.727
 721,2.576
 722,2.539
 723,2.770
 724,2.712
 725,2.818
 726,2.615
@@ -13,7 +13,19 @@ Record results in the table at the end of this file, with the date, the exact bu
 3. **Licensing.** Every new asset has provenance in `THIRD_PARTY_NOTICES.md`, or is recorded as unresolved and kept out of the build.
 4. **Version discipline.** Patch releases contain fixes, optimisation, docs, or tuning only — no new scope.
-## Performance check
+## `0.1.0` checks
 1. **Realism first.** Building placement, street width, sidewalk depth, material read and site identity match the reference photography. Compare side by side and note every deliberate deviation. "Looks right" is not evidence.
 2. Player traverses both the south-side frontage and the north-side frontage of the demo without falling through geometry, including the designated crossing. Walk the route twice: once normally, once with collision debug visualisation enabled.
 3. No blocking collision, no invisible walls, no gaps at sidewalk/road seams.
 4. Fresh checkout builds against the documented external engine installation.
 5. Linux build packaged and launched; controls documented in `Docs/` and shown in-game.
 6. **Performance last.** 60 FPS at 1440p per the performance check below — a floor every release meets, not the goal that shapes the content.
 7. Tag `v0.1.0`, write the `CHANGELOG.md` entry, then remove the completed section from `TODO.md` (its goal stays in `ROADMAP.md`).
 ## Performance check (last)
 Performance is the **last** check on purpose: realism leads the design and the frame budget only decides how much of it fits. It is still a floor — a release is not tagged below 60 FPS at 1440p without the owner's explicit approval.
 Measured at 1440p on the development workstation: Bazzite, Ryzen 7 7700X, 64 GB RAM, RTX 5070 Ti 16 GB.
@@ -22,16 +34,6 @@ Measured at 1440p on the development workstation: Bazzite, Ryzen 7 7700X, 64 GB
 - Target: 60 FPS at 1440p without frame generation.
 - Capture a frame-time graph over a fixed traversal route, not a single sample. State the route.
 ## `0.1.0` checks
 1. Player traverses both the south-side frontage and the north-side frontage of the demo without falling through geometry, including the designated crossing. Walk the route twice: once normally, once with collision debug visualisation enabled.
 2. Building placement, street width, sidewalk depth, and site identity match the reference photography. Compare side by side and note every deliberate deviation. "Looks right" is not evidence.
 3. No blocking collision, no invisible walls, no gaps at sidewalk/road seams.
 4. 60 FPS at 1440p per the performance check above.
 5. Fresh checkout builds against the documented external engine installation.
 6. Linux build packaged and launched; controls documented in `Docs/` and shown in-game.
 7. Tag `v0.1.0`, write the `CHANGELOG.md` entry, then remove the completed section from `TODO.md` (its goal stays in `ROADMAP.md`).
 ## Check-record template
 | Version | Check | Result | Evidence | Date |
@@ -125,6 +127,22 @@ Run on the packaged build (`GigLineQA`, Development, Vulkan SM5) with `-qaselfte
 Committed frame-time series: `Docs/perf/0.1.0-walk-frametimes.csv`.
 ### `0.1.5` re-measure with the façade kit in the map
 Same route, same preset, packaged Development build, **2560×1440**:
 | Metric  |           `0.1.0` | `0.1.5` (kit + textures) |
 | ------- | ----------------: | -----------------------: |
 | Average | 2.42 ms (414 fps) |    **2.76 ms (363 fps)** |
 | p50     |           2.38 ms |                  2.73 ms |
 | p95     |           2.71 ms |                  3.17 ms |
 | p99     |           3.01 ms |                  3.64 ms |
 | Max     |           4.00 ms |                  4.62 ms |
 The **625 kit actors and 8 generated textures cost about 12 %** of frame time and still leave **363 fps average, p99 3.64 ms** — roughly six times the 60 fps floor. Frame-time series: `Docs/perf/0.1.5-kit-walk-frametimes.csv`.
 **Measurement trap, again:** runs that reported ~105 fps were two game instances overlapping (a previous launch had not exited). Confirm a single instance (`pgrep -af Binaries/Linux/GigLine`) before trusting a figure — 363 fps reproduced twice on a clean run.
 ## `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:
@@ -0,0 +1,80 @@
 # `0.1.4` façade review — signoff
 Four demo-map captures from the `facades-0.1.4` branch, after the module kit, the textured materials and the theatre marquee went in. **All seven items signed off 2026-11-09** (owner review of the local renders).
 Reference photographs to compare against: `Art/reference/hollywood/` and `Art/reference/el-capitan-*` (local, not committed). Regenerate the set with `Tools/render_screenshots.sh --verify`; measure it with `python3 Tools/visual_loop.py --compare --iteration 5`.
 ## Signoff
 - [x] **1. Block from the north sidewalk** — hero between its neighbours, sidewalk and road read correctly
 - [x] **2. Street level** — colonnade, shopfronts and window rhythm hold up at eye height
 - [x] **3. Crossing** — zebra bars, kerb line and the frontage behind
 - [x] **4. North buildings** — TCL and Tussaud's framed across the boulevard
 - [x] **5. Materials** — stone reads as coursed stone, glazing as glass, not flat colour
 - [x] **6. Theatre trim** — marquee and blade sign proportions believable at street level
 - [x] **7. Approve** `v0.1.4` (kit + materials + theatre trim); remaining geometry moves to the next version
 ## 1. Block from the north sidewalk
 ![Block from the north sidewalk](../../Screenshots/demo/review-demo-spawn-view.png)
 Expected: the neoclassical hero façade between its neighbours, both sidewalks and the road in the foreground. _Metric: 0.68 similarity, edges 0.28× reference._
 ## 2. Street level
 ![Street level](../../Screenshots/demo/review-demo-street-level.png)
 Expected: the hero colonnade with adjacent frontage buildings either side, shopfronts at pavement level, 4.96 m bay rhythm. _Metric: 0.33, edges 0.27×._
 ## 3. The designated crossing
 ![Crossing](../../Screenshots/demo/review-demo-crossing.png)
 Expected: continental zebra bars on the asphalt at s=130 m, south frontage and colonnade behind. _Metric: 0.42, edges 0.34×._
 ## 4. North-side buildings
 ![North buildings](../../Screenshots/demo/review-demo-north-buildings.png)
 Expected: TCL Chinese Theatre and Madame Tussaud's across Hollywood Blvd, full height in frame. _Metric: 0.34, edges 0.14×._
 ---
 ## Appendix — what was checked, and what was broken
 ### Verified
 - **Behaviour**, packaged build, `-qaselftest`: walk 761 cm in 2 s (Z steady 456), reset 0 cm, pause/unpause, seam transect 1456 samples / **0 holes**, wall probe **0/35**, façade occlusion probe **0/9** — all PASS. Run twice: the harness is time-based and one loaded run reported a false failure (`walk 246 cm`, `pause FAIL`), an immediate re-run passed — re-run before believing a single FAIL.
 - **Placement**, probed from the live map against `Geo/verification/2026-11-06-el-capitan-block.md`: 6922 −24276…−17700, 6902 −17749…−14591, **hero −14644…−12028 between them**, theatre −12082…−8210, 6822 / 6806 / 6800 −7854…−1437, TCL −22889…−18442, Tussaud's −27071…−22799. Blockout affine residual **0.0 cm**.
 - **Budgets**: hero 148 parts / 3 044 tris · kit 16 meshes × 12 tris · 625 kit actors ≈ 7 500 tris · 8 × 512² textures (196 KB) · 67 tool tests pass.
 - **Topology**: every kit piece manifold, no loose geometry.
 ### Defects found this cycle
 Every one of these rendered convincingly; the placement ones were caught by coordinate probes, not by looking.
 | Sev | Defect | Root cause |
 | --- | --- | --- |
 | Blocker | Frontage shifted ≈119 m X / 2.4 m Y, hero outside its gap | Blockout regenerated without `--origin` |
 | Blocker | Kit placed ~12 km from its buildings | Used mesh-local bbox; actors carry the offset |
 | Blocker | Marquee on the far side of the boulevard | Blender +Y is Unreal −Y |
 | Major | Marquee canopy 5 cm above the pavement | Absolute Z; pavement is 4.56 m above datum |
 | Major | Window bays invisible, inside the solid wall | Piece modelled entirely at +Y |
 | Major | Glazing wasn't glass | Grey `M_Kit_*` from the FBX import, never overridden |
 | Major | Hero windows floated 1.44 m in front of the wall | Wrong Y in the builder |
 | Major | Parapet medallions were discs on the coping | Built with the Z-axis cylinder helper |
 | Major | Hero had no usable collision | Complex-only; traces use simple |
 | Minor | "No smoothing group information" on every import | `mesh_smooth_type="OFF"` in six exporters |
 | Minor | `save_map()` returned False silently | LFS `.umap` read-only, importer never chmod'd |
 | Minor | North-buildings import silently no-op | Missing `import sys` |
 | Minor | Kit folder held 24 assets (8 orphan materials) | No stale-asset sweep |
 | Minor | Edge-density metric counted PIL's border ring | `FIND_EDGES` leaves a 128 ring |
 | Minor | QA wall probe grazed the theatre wall | Scan row 1 cm from the building line |
 ### Limitations worth knowing
 - Kit pieces are boxes; dentil spacing, abacus and plinth dimensions are recorded assumptions, not measurements.
 - Textures are generated, not authored — no decals, signage text or weathering.
 - The vision pre-check stays advisory: it has rejected shots the owner approved.
 - The low edge ratios in the metrics are partly structural — a wide block view against a tight façade crop always scores low. Weigh the images, not the scores.
 - Performance has not been re-measured since `0.1.0`; the 625 kit actors are unmeasured (tracked in `TODO.md` under `0.1.5`).
@@ -379,7 +379,11 @@ void AGigLineCharacter::StartQASelfTest()
 				// trace at a fixed Z (e.g. 160) is wrong: the street is at Z ~366
 				// there, so a 160 cm probe starts inside the earth (dist 0).
 				int32 Walls = 0, WallSamples = 0;
-				static const float TraceYs[] = {-1400.0f, -167.0f, 1000.0f, -1382.0f, 1047.0f};
+				// Sample the street envelope only: the carriageway plus the walkable
 				// part of each sidewalk. Y 1000 used to be in this list and sits ~1 cm
 				// from the frontage building line, so it grazed the theatre wall once
 				// the kit's proud shopfronts went in - a probe artefact, not a blocker.
 				static const float TraceYs[] = {-1400.0f, -167.0f, 800.0f, -1382.0f, 718.0f};
 				for (float WallY : TraceYs)
 				{
 					for (float X0 = -19500.0f; X0 <= -3000.0f; X0 += 2500.0f)
@@ -1,6 +1,7 @@
 #include "GigLineShotActor.h"
 #include "Camera/CameraActor.h"
 #include "Camera/CameraComponent.h"
 #include "Engine/World.h"
 #include "GameFramework/PlayerController.h"
 #include "UnrealClient.h"
@@ -83,6 +84,15 @@ void AGigLineShotActor::NextShot()
 	Params.ObjectFlags |= RF_Transient;
 	CurrentCamera = GetWorld()->SpawnActor<ACameraActor>(
 		ACameraActor::StaticClass(), ShotLocations[CurrentShot], ShotRotations[CurrentShot], Params);
 	if (ShotFieldOfView.IsValidIndex(CurrentShot) && ShotFieldOfView[CurrentShot] > 0.0f)
 	{
 		if (UCameraComponent* Cam = CurrentCamera->GetCameraComponent())
 		{
 			// Long lens for elevations: fills the frame from across the street
 			// without pitching the camera, so verticals stay parallel.
 			Cam->SetFieldOfView(ShotFieldOfView[CurrentShot]);
 		}
 	}
 	PlayerController->SetViewTarget(CurrentCamera);
 	SettleCountdown = SettleSeconds;
@@ -36,6 +36,16 @@ public:
 	UPROPERTY(EditAnywhere, BlueprintReadWrite)
 	TArray<FString> ShotNames;
 	/**
 	 * Optional per-shot field of view (degrees), same index as ShotLocations.
 	 * Zero or missing entries keep the engine default (90 deg). Elevation shots
 	 * taken from across the street need a long lens: a level camera 45 m out with
 	 * the default FOV leaves the building small in frame, and tilting it up to fill
 	 * the frame is what breaks the verticals.
 	 */
 	UPROPERTY(EditAnywhere, BlueprintReadWrite)
 	TArray<float> ShotFieldOfView;
 	/** Seconds to let the view target settle before the capture. Resolution comes from the runner's -ResX/-ResY. */
 	UPROPERTY(EditAnywhere, BlueprintReadWrite)
 	float SettleSeconds = 0.35f;
@@ -239,289 +239,295 @@ Scope: facts and traps that cost time to establish. Planned work lives in [TODO.
 ## 2026-11-08 — reference photography gaps closed (local-only)
- Closed the two missing reference angles for the hero façade, both from Wikimedia
+- Closed the two missing reference angles for the hero façade, both from Wikimedia Commons (gitignored deliverables under `Art/reference/`, provenance in sidecars):
-  Commons (gitignored deliverables under `Art/reference/`, provenance in sidecars):
+  - `el-capitan-entrance/` — `File:Hollywood El Capitan entrance.jpg` (+ detail), Andreas Praefcke, CC BY 3.0. This is the isolated hero (6840) entrance/door recess that the notes doc had claimed Commons didn't hold. Query that found it: `--query "El Capitan entrance"`.
-  - `el-capitan-entrance/` — `File:Hollywood El Capitan entrance.jpg` (+ detail),
+  - `el-capitan-night/` — `File:El Capitan theater with Tron marquee.jpg` (CC BY-SA 3.0) + West Side Story premiere (Adam Jones, CC BY 2.0). The theatre is the building NEXT to 6840; treat as proximity evidence only, not the hero.
-    Andreas Praefcke, CC BY 3.0. This is the isolated hero (6840) entrance/door
+- Commons throttles hard: HTTP 429 after a batch. Fetch fewer files with `--delay`/separate calls and wait ~15-20s between runs (`queue.py` tool default 1 req/s is insufficient once rate limited).
-    recess that the notes doc had claimed Commons didn't hold. Query that found it:
+- Task was claimed on branch `ref-photo-0.1.2`; delivers only the TODO closure (all actual reference files are gitignored, so no code branch content). Reported to coordinator for merge/cleanup.
    `--query "El Capitan entrance"`.
  - `el-capitan-night/` — `File:El Capitan theater with Tron marquee.jpg`
    (CC BY-SA 3.0) + West Side Story premiere (Adam Jones, CC BY 2.0). The theatre is
    the building NEXT to 6840; treat as proximity evidence only, not the hero.
 - Commons throttles hard: HTTP 429 after a batch. Fetch fewer files with
  `--delay`/separate calls and wait ~15-20s between runs (`queue.py` tool default
  1 req/s is insufficient once rate limited).
 - Task was claimed on branch `ref-photo-0.1.2`; delivers only the TODO closure (all
  actual reference files are gitignored, so no code branch content). Reported to
  coordinator for merge/cleanup.
 ## 2026-11-08 — security-game scan: concepts copied, licensing ignored (owner)
- Scanned `/run/media/system/DATA/Documents/06-games/security-game` for reference
+- Scanned `/run/media/system/DATA/Documents/06-games/security-game` for reference material vs our `Art/reference/`. Result: its **photo set** (`docs/screens/refs/ hollywood/`, 9 files) is already fully duplicated in our `Art/reference/hollywood/` (with SIDECAR/BOARD copies) — nothing new there.
-  material vs our `Art/reference/`. Result: its **photo set** (`docs/screens/refs/
+- What we lacked: its **AI concept renders** (`docs/screens/concepts/ hollywood_boulevard/`, 12 PNGs + `.refgen.json`). Copied into `Art/reference/el-capitan-concepts/` with a folder README. **Owner explicitly said ignore licensing completely** — they are gitignored local development reference, never committed or shipped; `.refgen.json` still records the model and source photo per file for traceability.
-  hollywood/`, 9 files) is already fully duplicated in our `Art/reference/hollywood/`
+- Use concepts for mood/lighting intent only; geometry truth stays with the photo refs (facade, entrance, night marquee, TCL/Tussauds, Masonic 1922, etc.).
-  (with SIDECAR/BOARD copies) — nothing new there.
+- The security-game `realism/` A/B screenshots and `concepts/joke_shop/` are its own engine/venue renders — not relevant to our 6840 modeling.
 - What we lacked: its **AI concept renders** (`docs/screens/concepts/
  hollywood_boulevard/`, 12 PNGs + `.refgen.json`). Copied into
  `Art/reference/el-capitan-concepts/` with a folder README. **Owner explicitly
  said ignore licensing completely** — they are gitignored local development
  reference, never committed or shipped; `.refgen.json` still records the model
  and source photo per file for traceability.
 - Use concepts for mood/lighting intent only; geometry truth stays with the photo
  refs (facade, entrance, night marquee, TCL/Tussauds, Masonic 1922, etc.).
 - The security-game `realism/` A/B screenshots and `concepts/joke_shop/` are its
  own engine/venue renders — not relevant to our 6840 modeling.
 ## 2026-11-08 — ODbL review closed; remaining active TODO items finished
- Wrote `Docs/odbl-review.md` (decision 2026-11-08): the shipped block geometry
+- Wrote `Docs/odbl-review.md` (decision 2026-11-08): the shipped block geometry (streets/footprints/sidewalks) is a Produced Work of the OpenStreetMap database (ODbL 1.0). Obligations held: on-screen attribution via AGigLineHUD ("© OpenStreetMap contributors" + "Data © OSM, ODbL 1.0 — openstreetmap.org/copyright"), ODbL link, and the raw extract committed in Geo/ with a manifest (date, bbox, SHA-256). Share-alike is limited to the data layer; project code/art remain CC0 (Docs/licensing.md decision). 3DEP DEM is US Government public domain, unrelated to ODbL.
-  (streets/footprints/sidewalks) is a Produced Work of the OpenStreetMap database
+- Closed both [A] items in TODO: (1) sidewalks/roads/collision — collision verified; remaining kerb radii/aprons/kerb-height explicitly tracked as 0.1.1 patch tasks (Sidewalk outer edge, Crossing ramp gradient, Kerb height); (2) ODbL review — recorded. The [D] Blosm-import (blockout cleaning) item stays deferred (tracked separately).
  (ODbL 1.0). Obligations held: on-screen attribution via AGigLineHUD ("©
  OpenStreetMap contributors" + "Data © OSM, ODbL 1.0 — openstreetmap.org/copyright"),
  ODbL link, and the raw extract committed in Geo/ with a manifest (date, bbox,
  SHA-256). Share-alike is limited to the data layer; project code/art remain CC0
  (Docs/licensing.md decision). 3DEP DEM is US Government public domain, unrelated
  to ODbL.
 - Closed both [A] items in TODO: (1) sidewalks/roads/collision — collision
  verified; remaining kerb radii/aprons/kerb-height explicitly tracked as 0.1.1
  patch tasks (Sidewalk outer edge, Crossing ramp gradient, Kerb height);
  (2) ODbL review — recorded. The [D] Blosm-import (blockout cleaning) item stays
  deferred (tracked separately).
 - Branch: odbl-review-0.1.0 (docs + TODO closure only).
 ## 2026-11-08 — placement release check; north-buildings camera was 9.5 km off
- Release check 2 (placement vs references): rendered demo, probed DemoMap world
+- Release check 2 (placement vs references): rendered demo, probed DemoMap world positions, compared to Geo references. Matches: road 24.3 m (ref crossings 20.9-25.9), sidewalk centreline offsets 12.5/13.2 m (ref 12.6/13.6), hero frontage 26.0 m / setback ~13 m (ref 25.75/14.5), six south-frontage buildings
-  positions, compared to Geo references. Matches: road 24.3 m (ref crossings
+  - TCL/Tussaud's in verified OSM positions.
-  20.9-25.9), sidewalk centreline offsets 12.5/13.2 m (ref 12.6/13.6), hero
+- **Bug found:** the `demo-north-buildings` camera sat at X -22800 (the buildings' own X), aiming at its own position -> 85%-sky screenshot. Probed real geometry: TCL bbox X -22889..-18442, Y -9431..-1802; Tussaud's X -27071..-22799, Y -7586..-1888; hero at X -13336, Y +1307 (frontage 26 m). Camera now at (X -22750, Y +1600) looking north; sky fraction 85% -> 41%.
-  frontage 26.0 m / setback ~13 m (ref 25.75/14.5), six south-frontage buildings
+- Getting actor world bounds: spawn at loc(0,0,0) means static mesh bbox IS the world footprint (FBX carries the geo offset). Probe by loading the level explicitly (load_level) — a fresh commandlet starts on Untitled otherwise.
  + TCL/Tussaud's in verified OSM positions.
 - **Bug found:** the `demo-north-buildings` camera sat at X -22800 (the buildings'
  own X), aiming at its own position -> 85%-sky screenshot. Probed real geometry:
  TCL bbox X -22889..-18442, Y -9431..-1802; Tussaud's X -27071..-22799,
  Y -7586..-1888; hero at X -13336, Y +1307 (frontage 26 m). Camera now at
  (X -22750, Y +1600) looking north; sky fraction 85% -> 41%.
 - Getting actor world bounds: spawn at loc(0,0,0) means static mesh bbox IS the
  world footprint (FBX carries the geo offset). Probe by loading the level
  explicitly (load_level) — a fresh commandlet starts on Untitled otherwise.
 ## 2026-11-08 — collision/seam audit done; QA self-test extended
- `-qaselftest` transect widened from 84 samples (3 lane centres) to **1456
+- `-qaselftest` transect widened from 84 samples (3 lane centres) to **1456 samples / 16 rows** including kerb/road/sidewalk seam Ys (probed: N side -1912..-1053, kerb -1382..-1053, road -1382..+1047, kerb +718..+1047, S side +718..+1447). 0 holes.
-  samples / 16 rows** including kerb/road/sidewalk seam Ys (probed: N side
+- **New wall probe:** ground-referenced horizontal 30 m trace at +160 cm. First attempt used a fixed Z 160 and started INSIDE the earth (street is at Z ~366) -> every row reported a dist-0 blocker. Always ground the probe first.
-  -1912..-1053, kerb -1382..-1053, road -1382..+1047, kerb +718..+1047, S side
+- **Guard:** GigLineShotActor must skip rounds under `-qaselftest`, else bQuitWhenDone closes the game before the transect phase (observed: game exited at t=2s with "ShotActor: done (4 shots)" + RequestExit).
-  +718..+1447). 0 holes.
+- Results on packaged build: walk 761cm/2s, reset 0cm, pause/unpause, transect 0 holes, wall 0/35 -> all PASS. Evidence recorded in Docs/release-checks.md.
 - **New wall probe:** ground-referenced horizontal 30 m trace at +160 cm. First
  attempt used a fixed Z 160 and started INSIDE the earth (street is at Z ~366)
  -> every row reported a dist-0 blocker. Always ground the probe first.
 - **Guard:** GigLineShotActor must skip rounds under `-qaselftest`, else
  bQuitWhenDone closes the game before the transect phase (observed: game exited
  at t=2s with "ShotActor: done (4 shots)" + RequestExit).
 - Results on packaged build: walk 761cm/2s, reset 0cm, pause/unpause, transect
  0 holes, wall 0/35 -> all PASS. Evidence recorded in Docs/release-checks.md.
 ## 2026-11-08 — setup logs gated behind a cvar (diagnostics item)
- The remaining spawn/input setup logs (settle-timer "start captured", "GigLine
+- The remaining spawn/input setup logs (settle-timer "start captured", "GigLine IN:" pushed/bound/errors) are now gated behind `gigline.SetupLogs` (TAutoConsoleVariable, default **0** via `DefaultEngine.ini [ConsoleVariables]`). Re-enable at runtime: `gigline.SetupLogs 1`.
-  IN:" pushed/bound/errors) are now gated behind `gigline.SetupLogs`
+- The `-qaselftest` QA logs stay ungated (deliberate release-check feature per Docs/release-checks.md). Verified packaged build: 0 setup-log lines, QA suite still all PASS (walk/reset/pause/transect 0 holes/wall 0-35).
-  (TAutoConsoleVariable, default **0** via `DefaultEngine.ini [ConsoleVariables]`).
+- Branch qa-diagnostics-0.1.0. SIM/GROUND probes were removed earlier in the DefaultKeyMappings fix (PR #8).
  Re-enable at runtime: `gigline.SetupLogs 1`.
 - The `-qaselftest` QA logs stay ungated (deliberate release-check feature per
  Docs/release-checks.md). Verified packaged build: 0 setup-log lines, QA suite
  still all PASS (walk/reset/pause/transect 0 holes/wall 0-35).
 - Branch qa-diagnostics-0.1.0. SIM/GROUND probes were removed earlier in the
  DefaultKeyMappings fix (PR #8).
 ## 2026-11-08 — v0.1.0 released
- All six `0.1.0` release checks pass and are recorded in `Docs/release-checks.md`:
+- All six `0.1.0` release checks pass and are recorded in `Docs/release-checks.md`: traversal (seam transect 0 holes), placement vs references, collision+packaging (wall probe 0/35), 60 fps at 1440p (2.42 ms avg; TSR on, VSync off, no FG), fresh-checkout build, packaged Linux build with controls shown in-game.
-  traversal (seam transect 0 holes), placement vs references, collision+packaging
+- `CHANGELOG.md` gets the `0.1.0` entry; the completed `0.1.0` section was removed from `TODO.md` (goal stays in `ROADMAP.md`); tag `v0.1.0` cut on `main`.
  (wall probe 0/35), 60 fps at 1440p (2.42 ms avg; TSR on, VSync off, no FG),
  fresh-checkout build, packaged Linux build with controls shown in-game.
 - `CHANGELOG.md` gets the `0.1.0` entry; the completed `0.1.0` section was removed
  from `TODO.md` (goal stays in `ROADMAP.md`); tag `v0.1.0` cut on `main`.
 - Owner approved the regenerated screenshot set (PR #15) on 2026-11-08.
- THIRD_PARTY_NOTICES switched to checkbox statuses (`[x]`/`[P]`/`[ ]`); all tools
+- THIRD_PARTY_NOTICES switched to checkbox statuses (`[x]`/`[P]`/`[ ]`); all tools incl. Blosm, QGIS and Git LFS are now verified as tool-only.
-  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).
 - 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
+- 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.
-  15.8 cm outer ledge). Crossing ramp run derives from `--max-ramp-grade` (8 % ⇒
+- 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.
-  1.63 m) instead of a fixed 1.5 m/8.7 %. Street + site rebuilt, site re-imported,
+- 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.
-  DemoMap rebuilt, packaged build verified.
+- Kerb height finalised at 0.15 m modelled / 0.13 m built (6 in LA standard; DEM and photos can't resolve finer).
 - 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).
 ## 2026-11-09 — Mapbox building data as a second height source
- `Geo/tools/mapbox_buildings.py` (new, stdlib `urllib`) Tilequeries
+- `Geo/tools/mapbox_buildings.py` (new, stdlib `urllib`) Tilequeries `mapbox.mapbox-streets-v8` layer `building` at every building centroid in the extract and merges the answer with our OSM height + source. Token comes from `MAPBOX_ACCESS_TOKEN` in the ignored `.env`; responses cache to `Geo/raw/mapbox-cache/`.
-  `mapbox.mapbox-streets-v8` layer `building` at every building centroid in the
+- **Mapbox terms restrict persisting/redistributing their data**, so `.gitignore` now covers `/Geo/raw/mapbox-cache/` and `/Geo/verification/*mapbox*`. The tool also refuses to cache a response that contains the token.
  extract and merges the answer with our OSM height + source. Token comes from
  `MAPBOX_ACCESS_TOKEN` in the ignored `.env`; responses cache to
  `Geo/raw/mapbox-cache/`.
 - **Mapbox terms restrict persisting/redistributing their data**, so `.gitignore`
  now covers `/Geo/raw/mapbox-cache/` and `/Geo/verification/*mapbox*`. The tool
  also refuses to cache a response that contains the token.
 - **First run (72 buildings): 58 match, 5 close, 3 disagree, 6 non-building.**
-  - It independently classifies our roof/canopy/shelter volumes as `roof`/
+  - It independently classifies our roof/canopy/shelter volumes as `roof`/ `shelter` — corroborating the `0.1.2` finding that they are not buildings.
-    `shelter` — corroborating the `0.1.2` finding that they are not buildings.
+  - Remaining disagreements are untyped `building=yes`/`apartments` rear structures where our fallback guess (2 × 3.2 m = 6.4 m) meets Mapbox's 3.0 m.
-  - Remaining disagreements are untyped `building=yes`/`apartments` rear
+  - Every "close" case is a `building:levels × 3.2 m` building where Mapbox is **0.6 m lower per 6 levels** → Mapbox implies **3.1 m per level**, not 3.2. Worth revisiting `LEVEL_HEIGHT` if a measured storey height ever lands.
    structures where our fallback guess (2 × 3.2 m = 6.4 m) meets Mapbox's 3.0 m.
  - Every "close" case is a `building:levels × 3.2 m` building where Mapbox is
    **0.6 m lower per 6 levels** → Mapbox implies **3.1 m per level**, not 3.2.
    Worth revisiting `LEVEL_HEIGHT` if a measured storey height ever lands.
  - Its query API surface: `height`, `min_height`, `type`, `extrude` per polygon.
 ## 2026-11-09 — Mapbox calibration adopted into the blockout
 - Owner decision: adopt Mapbox. Applied:
-  - `LEVEL_HEIGHT` 3.2 → **3.1 m** in `Geo/tools/block_height_report.py`, and the
+  - `LEVEL_HEIGHT` 3.2 → **3.1 m** in `Geo/tools/block_height_report.py`, and the Blosm `--level-height` default in `Art/blender/blockout/blosm_blockout.py`.
-    Blosm `--level-height` default in `Art/blender/blockout/blosm_blockout.py`.
+  - `HEIGHT_OVERRIDES` in block_height_report: ways 1490910971, 1492058875, 1492747608 → 3.0 m (Mapbox single-storey; the 2-level guess gave 6.4 m).
-  - `HEIGHT_OVERRIDES` in block_height_report: ways 1490910971, 1492058875,
+  - `classify_height(tags, level_height, way_id)` now takes the way id so overrides apply; `mapbox_buildings.py` passes it, so the cross-check agrees with the height table.
    1492747608 → 3.0 m (Mapbox single-storey; the 2-level guess gave 6.4 m).
  - `classify_height(tags, level_height, way_id)` now takes the way id so
    overrides apply; `mapbox_buildings.py` passes it, so the cross-check agrees
    with the height table.
 - Re-running the cross-check: **66 match, 6 non-building, 0 close/disagree**.
- Geometry: blockout regenerated at 3.1 (object names preserved — the frontage
+- Geometry: blockout regenerated at 3.1 (object names preserved — the frontage exporter maps `element.020`/`element`/`element.019`/named buildings, all still present, 6/6 exported), frontage re-imported, DemoMap rebuilt, packaged build `-qaselftest` all PASS.
-  exporter maps `element.020`/`element`/`element.019`/named buildings, all still
+- **Blosm adds roof mass** on top of `levels × levelHeight`: 6922 39.1 m vs table 37.2, El Capitan Theatre 20.5 m vs 18.6 — both ~+1.9 m. That is a roof, not a height error; the table is the tagged height, the mesh is storey + roof.
-  present, 6/6 exported), frontage re-imported, DemoMap rebuilt, packaged build
+- Gotcha: regenerating the blockout is safe for names, but any future change to the import must re-verify the 6/6 frontage export and the `element.*` mapping.
  `-qaselftest` all PASS.
 - **Blosm adds roof mass** on top of `levels × levelHeight`: 6922 39.1 m vs table
  37.2, El Capitan Theatre 20.5 m vs 18.6 — both ~+1.9 m. That is a roof, not a
  height error; the table is the tagged height, the mesh is storey + roof.
 - Gotcha: regenerating the blockout is safe for names, but any future change to
  the import must re-verify the 6/6 frontage export and the `element.*` mapping.
 ## 2026-11-09 — hero colonnade proportion fixed (47.6 % → 53.1 %)
- The hero's colonnade (columns 2.00–7.95 + capitals 7.95–8.90) was 6.90 m of the
+- The hero's colonnade (columns 2.00–7.95 + capitals 7.95–8.90) was 6.90 m of the 14.50 m elevation = **47.6 %**, below the photographed 50–60 %, because the entablature (3.40 m) and parapet (2.20 m) used 5.60 m of the height.
-  14.50 m elevation = **47.6 %**, below the photographed 50–60 %, because the
+- Thinned ENTABLATURE_H 3.40 → 3.00 and PARAPET_H 2.20 → 1.80 in `Tools/hero_facade_build.py`; the colonnade grows to **7.70 m = 53.1 %** while the envelope, motto band and medallions keep their relationships (all positioned relative to those two constants).
-  entablature (3.40 m) and parapet (2.20 m) used 5.60 m of the height.
+- **Gotcha (cost a bad build):** `hero_facade_build.py` takes `--out` for the **FBX** and `--save-blend` for the `.blend`. Passing `--out <file>.blend` writes FBX bytes over the blend and Blender then reports "File format is not supported". Correct invocation: `--out /tmp/gigline/hero-facade.fbx --save-blend Art/...blend --report Art/...json`.
- Thinned ENTABLATURE_H 3.40 → 3.00 and PARAPET_H 2.20 → 1.80 in
+- Rebuilt hero → re-imported (`SM_HeroFacade`, bounds 2604 × 1257 × 1450 cm) → DemoMap rebuilt → screenshots re-rendered. Note `ue_hero_facade_import.py` saves the map, so `chmod u+w` the `.umap` first or the import silently does not persist.
  `Tools/hero_facade_build.py`; the colonnade grows to **7.70 m = 53.1 %** while the
  envelope, motto band and medallions keep their relationships (all positioned
  relative to those two constants).
 - **Gotcha (cost a bad build):** `hero_facade_build.py` takes `--out` for the
  **FBX** and `--save-blend` for the `.blend`. Passing `--out <file>.blend` writes
  FBX bytes over the blend and Blender then reports "File format is not supported".
  Correct invocation: `--out /tmp/gigline/hero-facade.fbx --save-blend Art/...blend
  --report Art/...json`.
 - Rebuilt hero → re-imported (`SM_HeroFacade`, bounds 2604 × 1257 × 1450 cm) →
  DemoMap rebuilt → screenshots re-rendered. Note `ue_hero_facade_import.py` saves
  the map, so `chmod u+w` the `.umap` first or the import silently does not persist.
 ## 2026-11-09 — AI detail plates from reference photos; floating windows fixed
- `Tools/facade_detail_concepts.py` generates architectural detail plates from one
+- `Tools/facade_detail_concepts.py` generates architectural detail plates from one local reference photograph via OpenRouter image models (default `google/gemini-2.5-flash-image`; the sibling project uses the same route in `tools/generate_textures.py` — chat/completions with a text + image_url content part, image returned as `message.images[].image_url.url`). Eight studies, `--list` free, `--all` generates, `-vN` never overwrites, `.refgen.json` sidecar per image, all output under gitignored `Art/reference/facade-details/`.
-  local reference photograph via OpenRouter image models (default
+- **Prompt gotcha:** the model refuses when the prompt describes features the reference photograph does not show ("the image you sent appears to be a decorative architectural detail, not an entrance with steps"). Prompts must describe the _reference subject_ and only restage light/people/surface.
  `google/gemini-2.5-flash-image`; the sibling project uses the same route in
  `tools/generate_textures.py` — chat/completions with a text + image_url content
  part, image returned as `message.images[].image_url.url`). Eight studies,
  `--list` free, `--all` generates, `-vN` never overwrites, `.refgen.json` sidecar
  per image, all output under gitignored `Art/reference/facade-details/`.
 - **Prompt gotcha:** the model refuses when the prompt describes features the
  reference photograph does not show ("the image you sent appears to be a
  decorative architectural detail, not an entrance with steps"). Prompts must
  describe the *reference subject* and only restage light/people/surface.
 - **Output is real:** 1184×864 to 1344×768 PNGs, ~2 MB each.
- **Measured defect found and fixed:** hero window panes sat at Y −1.98 while the
+- **Measured defect found and fixed:** hero window panes sat at Y −1.98 while the mass front is Y −0.50 and the columns reach −1.02 — i.e. glazing floating 1.44 m in front of the wall and ahead of the colonnade. Now `WINDOW_Y = −0.56` (6 cm proud of the wall, behind the columns). Visible as dark openings in `review-hero-facade-front`.
-  mass front is Y −0.50 and the columns reach −1.02 — i.e. glazing floating 1.44 m
+- Reminder: `.blend` is LFS read-only on checkout — `chmod u+w` or Blender fails with "Cannot save blend file … not writable" (this bit again here).
  in front of the wall and ahead of the colonnade. Now `WINDOW_Y = −0.56`
  (6 cm proud of the wall, behind the columns). Visible as dark openings in
  `review-hero-facade-front`.
 - Reminder: `.blend` is LFS read-only on checkout — `chmod u+w` or Blender fails
  with "Cannot save blend file … not writable" (this bit again here).
 ## 2026-11-09 — UE export hygiene: smoothing groups + facade collision
- **All our FBX exporters used `mesh_smooth_type="OFF"`**, which is why every Unreal
+- **All our FBX exporters used `mesh_smooth_type="OFF"`**, which is why every Unreal import logged "No smoothing group information was found for this mesh". The hero now exports `"FACE"` and its round parts are shaded with `shade_smooth_by_angle(35°)` before export: cylinders read as round instead of faceted, and the import warning is gone (6 → 0).
-  import logged "No smoothing group information was found for this mesh". The hero
+- **The hero façade had no simple collision** (complex-only), so line traces and capsule sweeps passed straight through it — the player could walk through the wall of the demo. Caught by a new `-qaselftest` **facade occlusion probe** (40 m sideways traces from the road centre at walking height).
-  now exports `"FACE"` and its round parts are shaded with
+- **Auto-generated convex collision on a 95-part 26 m façade is unusable**: it produced coarse hulls that bulged into the street and the wall probe went 0/35 → 2/35. Rejected in favour of `UseComplexAsSimple` via `UGigLineAssetTools.set_complex_collision_as_simple` (same reason the terrain uses it), saved on the asset.
-  `shade_smooth_by_angle(35°)` before export: cylinders read as round instead of
+- Probe expectations must mirror the staged buildings: the facade probe now carries explicit X spans per frontage (and the TCL/Tussaud's spans on the north side) so a gap between buildings is not reported as a defect.
  faceted, and the import warning is gone (6 → 0).
 - **The hero façade had no simple collision** (complex-only), so line traces and
  capsule sweeps passed straight through it — the player could walk through the
  wall of the demo. Caught by a new `-qaselftest` **facade occlusion probe** (40 m
  sideways traces from the road centre at walking height).
 - **Auto-generated convex collision on a 95-part 26 m façade is unusable**: it
  produced coarse hulls that bulged into the street and the wall probe went
  0/35 → 2/35. Rejected in favour of `UseComplexAsSimple` via
  `UGigLineAssetTools.set_complex_collision_as_simple` (same reason the terrain
  uses it), saved on the asset.
 - Probe expectations must mirror the staged buildings: the facade probe now carries
  explicit X spans per frontage (and the TCL/Tussaud's spans on the north side) so
  a gap between buildings is not reported as a defect.
 ## 2026-11-09 — one FBX export preset instead of six copies
- The `bpy.ops.export_scene.fbx(...)` argument block was duplicated in six scripts
+- The `bpy.ops.export_scene.fbx(...)` argument block was duplicated in six scripts (hero, block frontage, north buildings, site, scale test, MPFB character), and all six carried `mesh_smooth_type="OFF"` — hence the "No smoothing group information was found" warning on every import.
-  (hero, block frontage, north buildings, site, scale test, MPFB character), and
+- Now `Tools/fbx_export_preset.py` holds `ue_metric_v1` and `ue_character_v1`: `preset_kwargs()` (bpy-free, unit-tested) plus `export_static()` / `export_character()` wrappers that import `bpy` lazily. Every caller imports it and passes `selection=True/False`; the seven duplicated blocks are gone.
-  all six carried `mesh_smooth_type="OFF"` — hence the "No smoothing group
+- Callers in `Tools/` resolve the module with `sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))`; the Blender-side `Art/blender/site/export_site_fbx.py` computes the repo root (`..`, `..`, `..`) and joins `Tools`. Getting that wrong silently inserts `Tools/Tools` — check the import path when adding a caller.
-  information was found" warning on every import.
+- Verified end to end: scale test, hero, frontage (6/6), site (7/7) and north buildings all re-exported through the preset, re-imported with **0 smoothing warnings**, DemoMap rebuilt and `-qaselftest` all PASS (walk, transect 0 holes, wall probe 0/35, facade probe 0/9).
- Now `Tools/fbx_export_preset.py` holds `ue_metric_v1` and `ue_character_v1`:
+- `mpfb_character_export.py` was not re-run: it needs the MPFB add-on on `BLENDER_USER_SCRIPTS` ("Add-on not loaded: bl_ext.blender_org.mpfb"), which is pre-existing and unrelated; the character is not in `0.1.x` gameplay.
  `preset_kwargs()` (bpy-free, unit-tested) plus `export_static()` /
  `export_character()` wrappers that import `bpy` lazily. Every caller imports it
  and passes `selection=True/False`; the seven duplicated blocks are gone.
 - Callers in `Tools/` resolve the module with
  `sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))`; the Blender-side
  `Art/blender/site/export_site_fbx.py` computes the repo root
  (`..`, `..`, `..`) and joins `Tools`. Getting that wrong silently inserts
  `Tools/Tools` — check the import path when adding a caller.
 - Verified end to end: scale test, hero, frontage (6/6), site (7/7) and north
  buildings all re-exported through the preset, re-imported with **0 smoothing
  warnings**, DemoMap rebuilt and `-qaselftest` all PASS (walk, transect 0 holes,
  wall probe 0/35, facade probe 0/9).
 - `mpfb_character_export.py` was not re-run: it needs the MPFB add-on on
  `BLENDER_USER_SCRIPTS` ("Add-on not loaded: bl_ext.blender_org.mpfb"), which is
  pre-existing and unrelated; the character is not in `0.1.x` gameplay.
 ## 2026-11-09 — v0.1.2 released
- Cornice finished: projecting corona over a **52-dentil course** (0.18 × 0.30 ×
+- Cornice finished: projecting corona over a **52-dentil course** (0.18 × 0.30 × 0.22 m at 0.45 m centres, z 12.12–12.34, 0.25 m clear of the corona). Hero is now 3 044 tris across 148 parts, still 14.50 m. Verified: packaged `-qaselftest` all PASS (transect 0 holes, wall probe 0/35, facade probe 0/9).
-  0.22 m at 0.45 m centres, z 12.12–12.34, 0.25 m clear of the corona). Hero is now
+- `CHANGELOG.md` gets the `0.1.2` entry (added/changed/fixed/verified/limitations), the `0.1.2` section is removed from `TODO.md`, `ROADMAP.md` status updated, tag `v0.1.2` cut after the merge.
-  3 044 tris across 148 parts, still 14.50 m. Verified: packaged `-qaselftest` all
+- Assumptions recorded rather than hidden: dentil spacing, base and abacus dimensions are not resolvable in our reference photography.
  PASS (transect 0 holes, wall probe 0/35, facade probe 0/9).
 - `CHANGELOG.md` gets the `0.1.2` entry (added/changed/fixed/verified/limitations),
  the `0.1.2` section is removed from `TODO.md`, `ROADMAP.md` status updated, tag
  `v0.1.2` cut after the merge.
 - Assumptions recorded rather than hidden: dentil spacing, base and abacus
  dimensions are not resolvable in our reference photography.
 ## 2026-11-09 — elevation cameras levelled (straight verticals)
- archviz MUST: an elevation must not lean. `hero-facade-front` looked up ~4° from
+- archviz MUST: an elevation must not lean. `hero-facade-front` looked up ~4° from 4.2 m at a 7.6 m target; `demo-spawn-view` and `demo-street-level` were pitched too. All three now put the camera at the target's height, so `FindLookAtRotation` yields pitch 0 and roll 0 and verticals are parallel by construction.
-  4.2 m at a 7.6 m target; `demo-spawn-view` and `demo-street-level` were pitched
+- Do not try to _measure_ verticality from the rendered PNG with a naive edge scan: banners, windows and the parapet produce different edge sets at different heights and the pairwise match is meaningless (it reported a 418 px "drift"). Verify it geometrically in the camera list instead.
  too. All three now put the camera at the target's height, so
  `FindLookAtRotation` yields pitch 0 and roll 0 and verticals are parallel by
  construction.
 - Do not try to *measure* verticality from the rendered PNG with a naive edge
  scan: banners, windows and the parapet produce different edge sets at different
  heights and the pairwise match is meaningless (it reported a 418 px "drift").
  Verify it geometrically in the camera list instead.
 ## 2026-11-09 — 0.1.3 packaging/setup fixes
- **`Tools/ue_common.py`**: `make_writable()` clears the read-only bit an LFS
+- **`Tools/ue_common.py`**: `make_writable()` clears the read-only bit an LFS `.umap` checks out with (otherwise `save_map()` returns False with no error and the staged actors vanish), and `require_saved()` makes that failure visible. `ue_hero_facade_import.py` and `ue_import_north_buildings.py` never did this — which is why importing the hero appeared to succeed while saving nothing. Verified by forcing `chmod u-w` on DemoMap first: the run logged `map writable: chmod u+w … (was 0o444)`, then `save_map: True`, exit 0.
-  `.umap` checks out with (otherwise `save_map()` returns False with no error and
+- Gotcha while adding it: `ue_hero_facade_import.py` had **no** `import os`/`sys` (only `unreal`), so the sys.path line raised `NameError: name 'sys' is not defined` inside the commandlet — an exit code of 255 with no obvious cause.
-  the staged actors vanish), and `require_saved()` makes that failure visible.
+- Docs: `build.md` gained the current pipeline table (7 site FBXs, frontage, north, hero, map), the `Builds/GigLineQA` archive, the packaged-log path, `-qaselftest` usage and a **traps** table; `setup.md` marks the fresh-checkout build verified and documents the two optional API keys; architecture 07 + combined doc corrected the build-output path.
-  `ue_hero_facade_import.py` and `ue_import_north_buildings.py` never did this —
+
-  which is why importing the hero appeared to succeed while saving nothing.
+## 2026-11-09 — 0.1.4 materials + architecture-camera pass
-  Verified by forcing `chmod u-w` on DemoMap first: the run logged
+
-  `map writable: chmod u+w … (was 0o444)`, then `save_map: True`, exit 0.
+- **Material graphs**: `ensure_material()` now supports masonry coursing (`courses_m`) and roughness variation. **UE's `WorldPosition` is in CENTIMETRES**, so a course height in metres must be ×100 — the first attempt divided by 0.55 and produced coursing 100× too fine to see.
- Gotcha while adding it: `ue_hero_facade_import.py` had **no** `import os`/`sys`
+- **`connect_material_expressions` returns False instead of raising**, so an unknown pin name leaves an input unconnected and the material silently compiles with a default (a mask of 0 is invisible). All links now go through a `link()` helper that logs failures. There is also **no `MaterialExpressionLess`**; use `Frac → Divide → OneMinus → Clamp` for a soft threshold band, or `MaterialExpressionStep`/`SmoothStep` if a hard one is wanted.
-  (only `unreal`), so the sys.path line raised `NameError: name 'sys' is not
+- **Material assignment was slot-0-only**, which on the hero is the _banner_ — the stone, shadowed stone and glazing kept their flat Blender materials. Assignment is now per slot, keyed on the imported slot material's name (`glass`/`banner`/`stoneshadow`/`stone`/`roof`/`wall`). Hero: 4/4 slots.
-  defined` inside the commandlet — an exit code of 255 with no obvious cause.
+- New materials: `M_FacadeStoneShadow` (same coursing, a stop darker), `M_FacadeGlass` (roughness 0.14, specular 0.62 ≈ IOR 1.5 expressed without a refraction pass), `M_FacadeBanner` (the one saturated surface).
- Docs: `build.md` gained the current pipeline table (7 site FBXs, frontage, north,
+- **Camera FOV**: levelling the elevation cameras left the building small in frame (39 % sky). Added optional per-shot `ShotFieldOfView` to `AGigLineShotActor` and a 4th element on the shot tuples; a long lens (42–55°) fills the frame from across the street while the camera stays level, so verticals stay parallel. `review-hero-facade-front` sky 39 → 20 %, `demo-spawn-view` 23 → 16 %.
-  hero, map), the `Builds/GigLineQA` archive, the packaged-log path, `-qaselftest`
+
-  usage and a **traps** table; `setup.md` marks the fresh-checkout build verified and
+## 2026-11-09 — facade texture maps (0.1.4)
-  documents the two optional API keys; architecture 07 + combined doc corrected the
+
-  build-output path.
+- `Tools/generate_facade_textures.py` writes deterministic 512² base-colour and roughness maps (ashlar stone, stucco, asphalt, concrete) with a pure-zlib PNG encoder and hash-based value noise — no numpy/Pillow, ~14 s for all eight, and byte-identical on a re-run (checked by md5sum).
 - `ue_build_demo_map.py` imports them to `/Game/Hollywood/Textures` and samples them **world-aligned**: WorldPosition (cm) → ×(1/tile_cm) → ComponentMask(R,G) → TextureSample UVs. `tile_cm` per material: stone 440, stucco 260, asphalt 900, concrete 250.
 - Gotchas: `MaterialExpressionTextureSample`'s UV input pin is **"UVs"**, and the output pin for colour is **"RGB"** / roughness **"R"**. `ComponentMask` pins are R/G/B/A booleans. A textured material skips the graph coursing on purpose — overlaying both would double the course pattern.
 - The script needs `ROOT` in `ue_build_demo_map.py` and `sys` imported; forgetting either fails with `NameError` and an exit code of 0 from the commandlet (always read the result file under /tmp/gigline).
 ## 2026-11-09 — façade module kit (0.1.4)
 - `Tools/facade_kit_build.py` builds the kit at the measured **4.96 m bay** and **3.10 m storey**: pilaster, sill, lintel, window bay, shopfront bay, door bay, cornice, parapet + coping = 16 meshes, exported per-object with `fbx_export_preset` plus a JSON part report (dims + evidence per piece).
 - `Tools/ue_import_facade_kit.py` → `/Game/Hollywood/Kit/*`, complex-as-simple collision (a convex hull would fence off the shopfront glazing).
 - `Tools/ue_apply_facade_kit.py` lays the kit out from each building's own bbox: `bays = round(width / 496 cm)`, storeys from height minus the 310 cm ground floor. **638 pieces** over six frontage buildings + both north buildings.
 - **Bug worth remembering:** the first window piece was modelled entirely at +Y (into the wall), so every window sat _inside_ the solid blockout wall and was invisible in every render while the placement maths looked right. The kit now projects the surround 3 cm proud with the glazing 6 cm behind its face — a solid-wall blockout cannot carry a real recess, so the piece has to project.
 - Blender gotcha: clearing the scene _including materials_ invalidates handles already taken ("StructRNA of type Material has been removed"); clear objects and orphan meshes only, and create the material after the clear.
 - The kit meshes are spawned at the world origin with their position baked into the mesh (like the frontage exports), so placement uses the bbox directly and must not add the actor location.
 ## 2026-11-09 — CRITICAL: blockout must be regenerated with --origin
 - Regenerating the blockout in 0.1.2 (for the 3.1 m storey height) was run **without `--origin`**, so Blosm centred on the extract instead of fitting the project frame. The whole frontage shifted about **119 m in X and 2.4 m in Y**, and the hero ended up outside the 6902/6838 gap — the "verified placement" was undone silently, and every render still looked like a plausible block.
 - Correct invocation (README documents it, and the affine fit prints `frame correction residual: max 0.0 cm`): `blosm_blockout.py --osm … --bounds 34.1006,-118.3422,34.1020,-118.3370  --level-height 3.1 --origin 34.101545,-118.338718 --assets-dir … --out …`
 - After re-export + re-import, the frontage spans are back to the verified values: 6922 −24276..−17700, 6902 −17749..−14591, **hero −14644..−12028 between them**, theatre −12082..−8210, and the north buildings at −22889..−18442 / −27071..−22799.
 - **`ue_import_north_buildings.py` also lacked `import sys`**, so its sys.path line raised NameError and the import silently did nothing (exit 255). Same trap as the hero importer: these scripts imported only `unreal`.
 - Lesson: after any blockout regeneration, probe the staged buildings' world X spans and compare them with `Geo/verification/2026-11-06-el-capitan-block.md` before trusting a render. A shift of this size is invisible in a screenshot.
 ## 2026-11-09 — kit naming + topology validation (blender-modeler checklist)
 - Kit assets now follow the Unreal convention: the Blender object keeps its readable name (`Kit_Pilaster`), the exported asset and file are `SM_Kit_Pilaster`. The kit loader strips the `SM_` prefix so the layout code still addresses pieces by short name.
 - `facade_kit_build.py::validate()` runs the blender-modeler cleanup checklist on every piece before handoff — non-manifold edges, loose vertices, triangle count — and records the result in the part report. Current kit: 16 pieces, **all manifold, no loose geometry, 12 tris each**.
 - `ue_import_facade_kit.py` now deletes kit assets that the current build no longer produces, so a rename cannot leave two generations of the same piece in the folder (the rename from `Kit_*` to `SM_Kit_*` did exactly that until it did).
 ## 2026-11-09 — visual comparison loop; screenshots are demo-only
 - `Tools/visual_loop.py` closes the reference → render → feedback loop. `--verify` gates captures against `Tools/visual_targets.json` (blank, tone-less, wrong-size fail); `--compare` measures luma, RMS contrast, edge density, palette distance and a 3x3 luma grid against the reference and prints a 0–1 score; `--iteration N` writes `Art/reference/iterations/N/{metrics.json,feedback.md}`. The feedback names the skill to consult, so the next modelling pass starts from a measurement rather than an opinion.
 - **Iterations are gitignored** (`/Art/reference/iterations/`); only confirmed shots are promoted into `Screenshots/`. A test asserts the ignore rule and that every target is a demo-map shot.
 - `Screenshots/` now holds **demo-map captures only** — the review staging map is no longer rendered for review. `render_screenshots.sh --verify` renders the demo map, collects the shots and runs the verification gate in one step.
 - **PIL gotchas:** `FIND_EDGES` leaves its own border ring at 128 (236/3600 px on a 60x60 frame = 6.5% "detail" on a perfectly flat image), so crop **after** filtering — cropping before does not help, the new border gets the same treatment. Palette shares must divide by the full-image area, not the cropped one.
 - First comparison (iteration 2): spawn view 0.70, street level 0.35, crossing 0.41, north buildings 0.34. Edge density is the dominant gap everywhere (0.04–0.11 against 0.20–0.32 in the references) — the render still lacks the relief the photographs carry, which is exactly what the `0.1.4` façade work is for.
 ## 2026-11-09 — theatre marquee + blade sign
 - `Tools/theatre_trim_build.py` builds the El Capitan Theatre's signature features in **world coordinates**: marquee canopy 12.0 × 2.60 m at a 4.60 m soffit, illuminated fascia, recessed soffit, vertical blade sign 1.30 × 5.20 m with frame and bracket. `Tools/ue_stage_theatre_trim.py` imports to `/Game/Hollywood/Theatre` and stages one actor per piece (single spawn at the origin — no placement arithmetic).
 - **Two placement bugs, both invisible in a render:**
  1. **Axis sign.** Blender +Y is Unreal −Y, so a face at Unreal Y +1001 is Blender Y −10.01. Using +10.01 put the whole marquee on the far side of the boulevard.
  2. **Absolute Z.** Trim heights were absolute while the pavement at the theatre is 4.56 m above the project datum, so the canopy hung 5 cm above the pavement — the QA wall probe caught it as a knee-height blocker. `GROUND_Z` now offsets every height.
 - Wall probe: a scan row at Y 1000 sat ~1 cm from the frontage building line and grazed the theatre wall once the kit's proud shopfronts went in. Rows now sample the street envelope only (−1400, −167, 800, −1382, 718).
 ## 2026-11-09 — 0.1.4 signed off; 0.1.5 created for the carried geometry
 - Owner reviewed the four demo captures locally and approved the set. Signoff recorded in `Docs/reviews/0.1.4-review.md` (7/7 items) and in the per-shot `Approved` column of `Screenshots/README.md`.
 - The three geometry items that `0.1.4` did not finish — retail neighbours from their own references, hero fluting/motto band, blockout cleaning — move to a new **`0.1.5` Façade finishing** patch rather than growing this one, plus a much-needed **1440p performance re-measure** (625 kit actors have never been measured; `0.1.0` measured 414 fps).
 - Decision recorded because it sets a precedent: finish and sign off a version when its _stated_ scope is done, and carry leftover scope into the next patch — do not let a patch accumulate unmeasured geometry.
 ## 2026-11-09 — quality priority flipped: realism first, performance last
 - Owner decision: realism leads; performance closes the quality list. Applied in
  `Docs/Architecture/01_introduction_and_goals.md`, `10_quality_requirements.md`,
  `04_solution_strategy.md`, the combined `architecture.md`, `Docs/release-checks.md`
  (performance section now last, with the reason), `ROADMAP.md` (a "Quality priority"
  section) and `AGENTS.md` (the tie-break rule next to the scope-cutting rule).
 - Ordering used: 1 visual realism, 2 geographic fidelity, 3 walkability/usability,
  4 build reproducibility/portability, 5 provenance, 6 performance.
 - **Both revisions carry the same guard so the order cannot be used as an excuse:**
  performance is a *floor*, not a preference — 60 FPS at 1440p without frame
  generation must be met at every release, and if realism cannot fit, the realism
  scope is cut deliberately and recorded in `CHANGELOG.md`, never the frame rate.
  Walkability outranks realism in one direction: a block the player falls through is
  not a demo.
 ## 2026-11-09 — 0.1.5 start: retail reference + kit layout maths
 - Commons holds exactly **one** usable reference for the retail run:
  `Art/reference/retail-neighbours/01-lee-drug-and-neighbor.jpg` (Gb321, CC BY-SA
  4.0, 1920×953) — 6800 Lee Drug **and** its neighbour at street level, shopfronts
  and parapets visible (vision pre-check: yes). Nothing for 6822 or 6806–6820, so
  those two façades still have no reference and stay blocked.
 - **Kit layout was wrong for tall/wide buildings**, not just ugly: bays were
  `round(width / 496)`, so 6922 (65.8 m wide, 37.1 m tall) got **13 bays** — a
  window every 4.96 m across the whole frontage — and the storey count came out at
  11 × 310 cm = 34.1 m against a 35.7 m window zone, leaving bare wall under the
  cornice. Fixed: `MAX_BAYS = 9` (module widens instead of subdividing), and the
  storey spread is derived from the available height (`usable / storeys`) so the top
  band always lands inside the building. Result: 6922 9 × 11, theatre 8 × 6,
  6806 7 × 3, 6800 4 × 3, TCL 9 × 5.
 ## 2026-11-09 — hero fluting + motto band; and a silent placement divergence
 - Fluting: 20 grooves per column as thin shadow-tone cylinders set into the shaft
  (120 pieces) rather than boolean cuts — the eye reads them in silhouette and
  grazing light, booleans would cost far more for that. Motto band is now a real
  recess: surround 6 cm proud, panel 12 cm behind (was an 8 cm dark stripe).
  Hero 148 parts/3 044 tris -> 271/5 492, still 14.50 m.
 - **The real find:** `ue_hero_facade_import.py` had its own hero position
  `(-12024.5, -1450, 0)` — the pre-`0.1.0` value, before the frontage placement fix
  moved the hero to `(-13336, +1307)`. Running the importer on its own therefore
  teleported the hero **13 m east and onto the north side of the boulevard**, and
  nothing complained: a displaced building still renders. The only symptom was the
  reference score dropping 0.69 -> 0.56 with the 3x3 composition correlation
  flipping +0.54 -> -0.08.
 - Fix: `Tools/ue_placement.py` is now the single source of truth (hero position,
  verified frontage spans, `span_error`/`describe_span_failure`). Both
  `ue_hero_facade_import.py` and `ue_build_demo_map.py` import it, the import asserts
  the staged span and logs `PLACEMENT ERROR` when it does not match, and tests assert
  the stale literal cannot come back. Spawn-view score back to **0.72** (best yet).
 - Lesson to keep: **duplicated placement constants drift silently.** The metric that
  caught it was the composition correlation, not a visual review.
 ## 2026-11-09 — 1440p re-measured with the kit: 363 fps, ~12% cost
 - 2560×1440, Epic preset, TSR, VSync off, no frame generation: **2.76 ms average
  (363 fps)**, p50 2.73, p95 3.17, p99 3.64, max 4.62 — against `0.1.0`'s 2.42 ms
  (414 fps). The 625 kit actors + 8 generated textures cost about **12 %** and leave
  ~6× the 60 fps floor.
 - **Variance trap confirmed a third time:** runs reporting ~105 fps (9.5 ms) were
  two overlapping game instances — an earlier launch had not exited. `pgrep -af
  Binaries/Linux/GigLine` should show one wrapper + one binary; 363 fps reproduced
  twice on a clean run. Always count instances before believing a perf number.
 - Series committed at `Docs/perf/0.1.5-kit-walk-frametimes.csv`; comparison table in
  `Docs/release-checks.md`.
 ## 2026-11-09 — 604 unmaterialed actors: material rebuild was delete+recreate
 - The "blockout cleaning pass" turned out to need **material and placement hygiene,
  not more geometry**. `Tools/ue_audit_scene.py` (new) found **604 of 620 mesh actors
  with no material**: kit pieces and theatre trim all untextured.
 - **Cause:** `ensure_material` in `ue_build_demo_map.py` deleted and recreated each
  `/Game/Hollywood/Site/M_*` asset every run ("so a look change cannot be masked by a
  stale asset"). That orphane every reference: actors staged by other tools pointed at
  deleted assets and fell back to the default material. The map looked only *slightly*
  flat — no error, no warning.
 - **Fix:** update the material **in place** — load it, `MaterialEditingLibrary.
  delete_all_material_expressions(mat)`, rebuild the graph, recompile, save. Note
  `Material.expressions` is protected from Python; use the library's deleter.
 - **Ordering rule now documented and enforced:** the demo builder rebuilds materials,
  so kit and theatre staging must run *after* it. `render_screenshots.sh` now runs
  demo map → kit assembly → theatre trim → scene audit → shot cameras → capture, and
  **fails on a non-zero audit count**.
 - Second find: 53 duplicated kit labels (both shop piers of a bay shared one name).
 - Scene audit after the fixes: **0 failures** (all materialed, all spans verified, no
  duplicate labels). Packaged QA still PASS; spawn-view reference score 0.72.
 ## 2026-11-09 — v0.1.5 released
 - All actionable `0.1.5` work is done: hero fluting + recessed motto band, kit layout
  for wide/tall buildings, placement single-source-of-truth, 1440p re-measure
  (363 fps), and the material/placement hygiene that the "blockout cleaning" task
  actually needed (604 unmaterialed actors, 53 duplicate labels) with a new scene
  audit gate.
 - Only item carried forward is the **retail frontage (6822 / 6806–6820 / 6800)**,
  blocked because Commons holds no usable reference for two of the three buildings
  and substituting the theatre's photographs would misattribute the façades. It now
  lives in a `0.1.6` Retail frontage patch.
 - Precedent applied again: tag when the stated scope is done, carry blocked scope
  into the next patch rather than letting a release wait indefinitely on missing
  reference photography.
 ## 2026-11-09 — Retail frontage and two pipeline traps
 - **`Tools/render_screenshots.sh` called `./Engine/...` for the capture step** while every commandlet above went through `run_cmdlet`'s `cd "$ENGINE"`. With `set -e` the script died at exit 127 *after* rebuilding the maps, so the PNGs silently stayed a day old and `--verify` never ran. Fixed to `"$ENGINE/Engine/Binaries/..."`. Symptom to remember: maps rebuild, screenshots do not move.
 - **The generic façade kit is applied to every actor labelled `Frontage_*` or `North_*`**, so staging a hand-modelled façade under those labels gets the kit pasted over it — two contradicting façade languages on one wall. `ue_apply_facade_kit.py` now skips `MODELLED` labels, and retail trim stages as `RetailTrim_*`.
 - **A Blender builder cannot be imported by a unit test** (`import bpy` at module scope). Pure layout arithmetic lives in `Tools/_common.py`; `Tools/tests/test_retail_frontage.py` tests it there, and the builder delegates. Same trick `fbx_export_preset.py` uses for its preset dicts.
 - **Joining 85 parts into one mesh per building** before export cut the Unreal import from 85 assets to 2, and the staging step to two spawns. Record per-part dimensions *before* the join: after it only the joined bounds exist.
@@ -108,8 +108,9 @@ Solo-development estimate: **approximately 30–40 weeks**, subject to asset qua
 | `0.6.0` | 22–24 | Visual/audio pass and evening lighting preset | `0.6.1` lighting fixes; `0.6.2` material corrections; `0.6.3` audio balancing |
 | `0.7.0` | 25–27 | Settings, control rebinding, save/load, accessibility basics | `0.7.1` save fixes; `0.7.2` UI fixes; `0.7.3` input persistence fixes |
 | `0.8.0` | 28–30 | Performance budgets and broader Linux hardware testing | `0.8.1` VRAM reductions; `0.8.2` frame-time fixes; `0.8.3` compatibility fixes |
-| `0.9.0` | 31–34 | Feature freeze, public beta, license and build audit | `0.9.1` blocker fixes; `0.9.2` regression fixes; `0.9.3` documentation fixes |
+| `0.9.0` | 31–34 | Realistic buildings: façade system, per-building models, measured material library, LODs and collision proxies | `0.9.1` façade fixes |
-| `1.0.0` | 35–40 | Stable neighborhood-scale walking/driving release | `1.0.x` maintenance and compatibility fixes |
+| `0.10.0` | 35–38 | Feature freeze, public beta, license and build audit | `0.10.1` blocker fixes; `0.10.2` regression fixes; `0.10.3` documentation fixes |
 | `1.0.0` | 39–44 | Stable neighborhood-scale walking/driving release | `1.0.x` maintenance and compatibility fixes |
 Finish each milestone's release checks before expanding scope. Cut map size and simulation complexity before compromising the core walking/driving experience.
@@ -2,9 +2,13 @@
 Development roadmap for this project: milestone goals, scope, decisions, and release gates. Actionable tasks, claims, and progress marks live in [TODO.md](TODO.md).
 ## Quality priority
 **Realism leads; performance is a floor.** Façade identity, proportion, material and light are judged against the reference photographs and drive design decisions. Performance closes the quality list: 60 FPS at 1440p without frame generation is a budget every release must meet, and if realism cannot fit inside it the realism scope is cut deliberately and recorded — never the frame rate.
 ## Status at a glance — 2026-11-08 15:30
-Workstation, geo pipeline, and engine validation are done. The art pipeline has a first blockout, terrain, and street in metres, in one shared coordinate frame. **Project bootstrap is complete**: `Game/GigLine` builds, packages, and both content-acceptance tests (static-mesh scale, MPFB skeletal character) pass. **`v0.1.0` released 2026-11-08**: the walkable demo, hero façade, verified block frontage, first-person controls, ODbL attribution, and every release check pass (traversal, placement, collision, 60 fps at 1440p, fresh-checkout build, packaged build with controls). Next: the `0.1.1`–`0.1.4` patch series (collision detail, scale/façade corrections, packaging fixes, real building façades), then `0.2.0` (player body, third-person camera, animation).
+Workstation, geo pipeline, and engine validation are done. The art pipeline has a first blockout, terrain, and street in metres, in one shared coordinate frame. **Project bootstrap is complete**: `Game/GigLine` builds, packages, and both content-acceptance tests (static-mesh scale, MPFB skeletal character) pass. **`v0.1.0` released 2026-11-08**: the walkable demo, hero façade, verified block frontage, first-person controls, ODbL attribution, and every release check pass (traversal, placement, collision, 60 fps at 1440p, fresh-checkout build, packaged build with controls). Next: the `0.1.1`–`0.1.4` patch series (collision detail, scale/façade corrections, packaging fixes, real building façades), **`v0.1.6` released 2026-11-09**: retail frontage for 6800 Lee Drug and 6806–6820 modelled from their own photograph; 6822 Budget deferred (no reference) and the lettering/parapet detail moved to `0.9.0`. **Next:** `0.2.0` (player body, third-person camera, animation).
 | Area | State |
 | --- | --- |
@@ -164,22 +168,38 @@ Workstation, geo pipeline, and engine validation are done. The art pipeline has
 **Goal:** fix compatibility issues from the hardware testing matrix.
-## 0.9.0 — Feature freeze, public beta, license and build audit (weeks 31–34)
+## 0.9.0 — Realistic buildings (weeks 31–34)
 **Goal:** every building in the demo area reads as the building it is, at walking distance, judged against its own photograph — and where no photograph exists it stays an honest blockout rather than an invented façade. This is the milestone that turns the façade system from "a kit applied to volumes" into architecture: a shared bay-and-profile vocabulary, a material library with measured albedo and roughness, modelled storefronts and signage, and per-building reference matching with a measured tolerance.
 **Scope:**
 - A façade system that carries more than one order: Art Deco, neoclassical and streamline-moderne variants on the same 4.96 m bay module, with a profile library for cornices, copings, string courses and storefront surrounds.
 - Per-building façades for the six south-side buildings and the two north-side buildings inside the 50 m buffer, each from its own reference set; the hero keeps its existing model and gains the detail levels this pass defines.
 - Storefronts and signage as first-class geometry plus decals: mullions, bulkheads, recessed entries, awning and canopy brackets, painted wall lettering, blade and projecting signs. Wall lettering is a texture/decal problem, not a block of geometry — the `0.1.6` attempt proved plates do not read.
 - A material library with measured values per surface type (stucco, painted render, ashlar, brick, terrazzo, glazing, bronze and steel trim) and a texel-density rule, replacing per-building ad-hoc colours.
 - LOD chain and collision proxies per building, so realism does not cost the 60 FPS floor.
 **Out of scope:** interiors, night lighting and audio (the `0.6.0` evening preset owns those), vehicles, pedestrians, and any change to footprints or massing — OSM stays the source for those.
 **Release gate:** each building has a review shot compared against its own photograph with the silhouette and proportion deltas recorded in `Screenshots/README.md`; no building carries an unverified façade; every building has a collision proxy and at least one LOD; 60 FPS at 1440p holds; no surface is left with a placeholder material; `THIRD_PARTY_NOTICES.md` covers every photographic reference used.
 ## 0.10.0 — Feature freeze, public beta, license and build audit (weeks 35–38)
 **Goal:** freeze features, produce a public beta for testers, and complete the audits: licences for `THIRD_PARTY_NOTICES.md` and all MPFB, texture, animation, vehicle, and audio assets; Epic distribution requirements; and a fresh checkout that builds and packages reproducibly.
-## 0.9.1 — Blocker fixes (patch)
+## 0.10.1 — Blocker fixes (patch)
 **Goal:** fix blockers reported during the public beta.
-## 0.9.2 — Regression fixes (patch)
+## 0.10.2 — Regression fixes (patch)
-**Goal:** fix regressions introduced by `0.9.x` fixes.
+**Goal:** fix regressions introduced by `0.10.x` fixes.
-## 0.9.3 — Documentation fixes (patch)
+## 0.10.3 — Documentation fixes (patch)
 **Goal:** update all `Docs/` for accuracy before `1.0.0`.
-## 1.0.0 — Stable neighborhood-scale walking/driving release (weeks 35–40)
+## 1.0.0 — Stable neighborhood-scale walking/driving release (weeks 39–44)
 **Goal:** a final acceptance sweep across all `0.x` features, confirmation that the agreed scope (neighbourhood-scale walking and driving) is met, and final build, documentation, and licensing verification. `1.0.0` marks the stable scope, not completion of a whole city.
@@ -1,63 +1,136 @@
-# Screenshots — visual review
+# Screenshots — demo-map visual review
-Rendered in-game captures of the current project content, generated by [`Tools/render_screenshots.sh`](../Tools/render_screenshots.sh). The PNGs are committed alongside this README so a reviewer sees exactly what the build rendered.
+Rendered captures of **the demo map only** — what a player sees when the demo runs. Generated by [`Tools/render_screenshots.sh`](../Tools/render_screenshots.sh); the PNGs are committed so a reviewer sees exactly what the build rendered.
 The review staging map (`/Game/Test/ReviewMap`) is not part of this set: it exists to hold the camera list and the hero detail rig, and it is not what ships.
 ## How to regenerate
 ```bash
-Tools/render_screenshots.sh
+Tools/render_screenshots.sh --verify
 ```
-Rebuilds `Game/GigLine/Content/Test/ReviewMap.umap` from current content, runs the game on it (and on the DemoMap for the walkable views), walks the fixed camera list via `AGigLineShotActor`, captures each shot, copies the PNGs here and exits — about a minute. The camera list lives in `Tools/ue_build_review_map.py`; add new shots there, remove retired ones here.
+Stages the demo shot cameras, runs the game on `/Game/Hollywood/DemoMap`, copies the PNGs into `Screenshots/demo/` and then runs [`Tools/visual_loop.py`](../Tools/visual_loop.py) `--verify` to check that each shot still shows the content its expectation describes. About a minute.
-> Naming: shots use their stable camera name (no index prefix), so adding or reordering cameras never renumbers files or orphans the old ones. Click an image for the full-size PNG.
+## Status at a glance
-## Shot list
+Every shot is embedded below, in order, so the whole review happens in this file.
-**Status: whole set ☑ approved 2026-11-09** (owner review of PR #27). Every shot was re-rendered from current `main` content after the building-height calibration was adopted (`v0.1.2`): Mapbox-derived **3.1 m per level** (`Geo/tools/block_height_report.py`), explicit overrides for three rear outbuildings, and the regenerated blockout and frontage that follow — 6922 is now 39.1 m (was 42.1 m) and the El Capitan Theatre 20.5 m (was 20.0 m).
+| #   | Shot                                  | Verified     | Approved     |
 | --- | ------------------------------------- | ------------ | ------------ |
 | 1   | [Spawn view](#1-spawn-view)           | ☑ 2026-11-09 | ☑ 2026-11-09 |
 | 2   | [Street level](#2-street-level)       | ☑ 2026-11-09 | ☑ 2026-11-09 |
 | 3   | [Crossing](#3-crossing)               | ☑ 2026-11-09 | ☑ 2026-11-09 |
 | 4   | [North buildings](#4-north-buildings) | ☑ 2026-11-09 | ☑ 2026-11-09 |
 | 5   | [Retail frontage](#5-retail-frontage) | ☑ 2026-11-09 | ☑ 2026-11-09 |
-| Round | What changed |
+**Verified** is what `--verify` reports: the frame is not blank, is the right size, and has tonal range. **Approved** is the owner's verdict, recorded here. Each shot also has an **expectation** in [`Tools/visual_targets.json`](../Tools/visual_targets.json) describing the content it must show.
 | --- | --- |
 | 2026-11-07 | First approved set; block frontage pass corrected hero and north-building placement |
 | 2026-11-08 | Re-rendered after `0.1.1` street geometry (sidewalk upstand flush at the building edge, crossing ramps graded ≤ 8 %); `demo-north-buildings` camera re-pointed (was 9.5 km west, 85 % sky) |
 | 2026-11-09 | Re-rendered after the `0.1.2` building-height calibration (3.1 m per level). 12 of 14 PNGs changed; `review-demo-spawn-view` and `review-demo-street-level` are byte-identical to the `0.1.1` round, so the height change reads mostly on the frontage silhouettes |
-| # | File | Preview | Map | View | What it shows | ☑ |
+---
-| --- | --- | --- | --- | --- | --- | --- |
+
-| 1 | `review-overview.png` | [<img src="review-overview.png" alt="overview" width="180">](review-overview.png) | Review | 7 m up, NE | Whole review layout: character + both cubes on the floor | ☑ 2026-11-09 |
+## 1. Spawn view
-| 2 | `review-character.png` | [<img src="review-character.png" alt="character" width="180">](review-character.png) | Review | eye height, south | MPFB mannequin, idle pose + warm skin; feet meet the plane | ☑ 2026-11-09 |
+
-| 3 | `review-scale-cubes.png` | [<img src="review-scale-cubes.png" alt="scale cubes" width="180">](review-scale-cubes.png) | Review | south | Floating vs grounded cube: cast vs contact shadow | ☑ 2026-11-09 |
+![Spawn view: the whole south block from the north sidewalk](demo/review-demo-spawn-view.png)
-| 4 | `review-player-placement.png` | [<img src="review-player-placement.png" alt="player placement" width="180">](review-player-placement.png) | Review | spawn | The `AGigLineCharacter` pawn, capsule height and landing | ☑ 2026-11-09 |
+
-| 5 | `review-npc-prefab.png` | [<img src="review-npc-prefab.png" alt="npc prefab" width="180">](review-npc-prefab.png) | Review | mid, west | The `AGigLineNPCPerson` prefab: collision capsule + visible MPFB body, feet on Z 0 | ☑ 2026-11-09 |
+- **File:** `demo/review-demo-spawn-view.png`
-| 6 | `review-ground-contact.png` | [<img src="review-ground-contact.png" alt="ground contact" width="180">](review-ground-contact.png) | Review | knee height, feet | Floating/sinking character is obvious here | ☑ 2026-11-09 |
+- **View:** north sidewalk, 14 m back, level horizon
-| 7 | `review-shadow-compare.png` | [<img src="review-shadow-compare.png" alt="shadow compare" width="180">](review-shadow-compare.png) | Review | low angle | Detached (floating) vs touching (grounded) shadows | ☑ 2026-11-09 |
+- **Expected content:** the whole south block — the neoclassical hero façade between its neighbouring buildings, both sidewalks and the road in the foreground
-| 8 | `review-hero-portals.png` | [<img src="review-hero-portals.png" alt="hero portals" width="180">](review-hero-portals.png) | Review | 8 m, eye height | Three genuine 1.2 m portal recesses with flights and plinth | ☑ 2026-11-09 |
+- **Verified:** ☑ 2026-11-09 · **Approved:** ☑ 2026-11-09
-| 9 | `review-hero-facade-front.png` | [<img src="review-hero-facade-front.png" alt="hero facade front" width="180">](review-hero-facade-front.png) | Review | road side, straight-on | Hero façade elevation and column rhythm | ☑ 2026-11-09 |
+
-| 10 | `review-hero-facade-oblique.png` | [<img src="review-hero-facade-oblique.png" alt="hero facade oblique" width="180">](review-hero-facade-oblique.png) | Review | north-west | Body depth and column line standing proud of the mass | ☑ 2026-11-09 |
+---
-| 11 | `demo/review-demo-spawn-view.png` | [<img src="demo/review-demo-spawn-view.png" alt="spawn view" width="180">](demo/review-demo-spawn-view.png) | Demo | north sidewalk | The whole block: hero façade between its neighbours, both sidewalks and the road | ☑ 2026-11-09 |
+
-| 12 | `demo/review-demo-street-level.png` | [<img src="demo/review-demo-street-level.png" alt="street level" width="180">](demo/review-demo-street-level.png) | Demo | eye height, north side | The hero colonnade with the adjacent frontage buildings either side | ☑ 2026-11-09 |
+## 2. Street level
-| 13 | `demo/review-demo-crossing.png` | [<img src="demo/review-demo-crossing.png" alt="crossing" width="180">](demo/review-demo-crossing.png) | Demo | along the crosswalk | The designated mid-block crossing at s=130 m (UE X -14956): three zebra bars on the asphalt, with the south frontage and the hero colonnade behind | ☑ 2026-11-09 |
+
-| 14 | `demo/review-demo-north-buildings.png` | [<img src="demo/review-demo-north-buildings.png" alt="north buildings" width="180">](demo/review-demo-north-buildings.png) | Demo | across the Blvd | North-side buildings (TCL, Tussaud's) seen from the south side across the road. **2026-11-08:** camera re-pointed to the buildings' mass centre (was 9.5 km west → 85% sky); now frames both north buildings. Flat surfaces = `0.1.4` façade scope. | ☑ 2026-11-09 |
+![Street level: the hero colonnade at eye height](demo/review-demo-street-level.png)
 - **File:** `demo/review-demo-street-level.png`
 - **View:** eye height, north side
 - **Expected content:** the hero colonnade with the adjacent frontage buildings either side, shopfronts at pavement level
 - **Verified:** ☑ 2026-11-09 · **Approved:** ☑ 2026-11-09
 ---
 ## 3. Crossing
 ![Crossing: the designated mid-block crossing with zebra bars](demo/review-demo-crossing.png)
 - **File:** `demo/review-demo-crossing.png`
 - **View:** from the north sidewalk along the crosswalk
 - **Expected content:** the designated mid-block crossing (s=130 m, UE X −14956) — zebra bars on the asphalt, south frontage and colonnade behind
 - **Verified:** ☑ 2026-11-09 · **Approved:** ☑ 2026-11-09
 ---
 ## 4. North buildings
 ![North buildings: TCL Chinese Theatre and Madame Tussaud's from the south](demo/review-demo-north-buildings.png)
 - **File:** `demo/review-demo-north-buildings.png`
 - **View:** across the Boulevard from the south side
 - **Expected content:** the two north-side buildings (TCL Chinese Theatre, Madame Tussaud's), full height in frame
 - **Verified:** ☑ 2026-11-09 · **Approved:** ☑ 2026-11-09
 ---
 ## 5. Retail frontage
 ![Retail frontage: 6800 Lee Drug and 6806–6820 from across the street](demo/review-demo-retail-frontage.png)
 - **File:** `demo/review-demo-retail-frontage.png`
 - **View:** north sidewalk, level horizon, 68° lens
 - **Expected content:** 6800 Lee Drug and 6806–6820 façades, full width in frame, showing the parapet, mural row, and lettering band
 - **Verified:** ☑ 2026-11-09 · **Approved:** ☑ 2026-11-09
 - **Expected content:** the retail run beside the hero — 6800 Lee Drug's bronze cornice, mural row and parapet next to 6806–6820's burgundy fascia, pilasters and window storey
 - **Verified:** ☑ 2026-11-09 · **Approved:** ☑ 2026-11-09
 Read this one against the reference photograph it was modelled from: `Art/reference/retail-neighbours/01-lee-drug-and-neighbor.jpg` (Gb321, CC BY-SA 4.0).
 Known gaps in this first pass, recorded rather than hidden:
 - **The parapet still reads as a blank band.** It is now two tiers with three deeper reveals, and the step is visible, but there is no profile or shadow line to break the wall — a moulded coping and a modelled reveal need the `0.9.0` façade system.
 - **The mural row now reads** (framed plates standing 0.12–0.20 m off the wall), but **the lettering band does not**: it is a plate at 0.10 m and it disappears at 40 m. Wall lettering is a decal/texture problem, scoped in `0.9.0`; no amount of extra plate depth fixed it in the second pass.
 - **The corner tower is a plain cylinder with two cap rings** — the stepped Deco profile in the photograph is richer than that.
 - **The camera crops the east end** of Lee Drug at 68° from the north sidewalk.
 - **6822 Budget is untouched** and still a bare blockout volume: no photograph of it exists.
 ---
 ## The iteration loop (uncommitted)
 `Tools/visual_loop.py` measures each capture against its reference photograph and turns the deltas into modelling actions for the Blender skill packs:
 ```bash
 python3 Tools/visual_loop.py --compare --iteration 3   # writes Art/reference/iterations/3/
 ```
 That directory is **gitignored**: iterations stay uncommitted until a shot is confirmed, and only confirmed shots are promoted into `Screenshots/demo/`. The feedback file names the affected skill (`blender-modeler`, `archviz`, `materials`, `lookdev`, `camera-cinematography`) so the next modelling pass has a starting point rather than an opinion.
 Note the comparison is only meaningful when the shot and the reference frame the same subject — a wide block view measured against a tight façade crop will always report low edge similarity.
 ## Scene conventions
- **Review map** (`/Game/Test/ReviewMap`): 160 m floor, top face at Z 0; the character measures Z 0..83 cm. One warm key light plus sky fill.
+- **Demo map** (`/Game/Hollywood/DemoMap`): fixed daytime — sun pitch −62 / yaw 120 (intensity 4, warm), sky light 2.6, sky atmosphere, height fog, fixed exposure.
- **Cubes**: `Cube_ScaleTest_A` rests on the floor, `Cube_ScaleTest_B` floats at Z 2 m; both are exactly 1 m — the scale reference.
+- **Cameras**: elevation shots sit at their target height (pitch 0, so verticals stay parallel) and use a 42–68° lens to fill the frame from across the street.
- **Demo map** (`/Game/Hollywood/DemoMap`): fixed daytime — sun at pitch −50 / yaw 120 (intensity 4, warm), sky light 2.6, sky atmosphere, height fog, fixed exposure.
+- **Materials**: every surface carries a look-developed material from `Tools/ue_build_demo_map.py` — noise-blended base colour, masonry coursing, and a generated texture set (`Tools/generate_facade_textures.py`) sampled world-aligned. Explicit roughness and specular per surface type.
 - **Materials**: every exported surface carries a look-developed material built in `Tools/ue_build_demo_map.py` (`ensure_material`) because Blender's flat diffuse colours do not survive the FBX → Unreal import. Each has an explicit roughness and a subtle world-space noise blend between two shades: `M_Asphalt` (0.92), `M_Concrete` (0.88), `M_KerbConcrete` (0.85), `M_Ground` (0.98), `M_RoadPaint` (0.62), `M_FacadeStone` (0.72) and `M_Stucco` (0.86) for the north-side buildings.
 - **Lighting is dynamic-only** (`r.AllowStaticLighting=False`, all lights Movable), so no lighting build is ever required.
 ## What to look for
 - **Ground contact**: feet meet the plane with no gap and no shadow seam.
 - **Scale**: everything checks against the 1 m cubes.
 - **Façade rhythm**: six columns at 4.96 m across 25.75 m should read as the photographs in silhouette.
 - **Frontage heights (new in this round)**: 6922 and the El Capitan Theatre were re-cut to the 3.1 m storey height. Check they still read as the taller west end and the lower cinema respectively against `Art/reference/hollywood/el-capitan-theatre-blade-sign-day-wikimedia-2008-10.jpg`, and that the ordering of the six frontage buildings is unchanged.
 ## Known cosmetic issues
- Floor speckle from the `Constant3Vector` wiring in `Tools/ue_build_review_map.py`.
+Each issue is tracked in `TODO.md` under the version that will fix it; an issue with no ticket is a bug in the plan, not a note.
- Hero façade renders pale — Blender flat colours with no normal/roughness, so it reads as untextured stone (the `0.1.4` façade patch, not a lighting bug).
+
- Banners sit on the column line rather than the wall (acceptable: they hang on the columns in the photographs).
+| Issue | Where it is tracked | State |
- ~~Banners and window panels float detached from the colonnade wall~~ — **window panes fixed 2026-11-09**: they sat at Y −1.98, 1.44 m in _front_ of the wall and ahead of the column line; they now sit on the wall plane at Y −0.56, behind the columns, and read as dark openings (see `review-hero-facade-front`).
+| --- | --- | --- |
- Between kerb and building line, the walkable surface is the terrain mesh, not a modelled pavement.
+| Hero stone renders pale — the material is a procedural graph and a generated texture set, not a measured surface | `0.9.0` → Materials, UVs and performance: **measured material library** | Open |
 | Hero façade has no doors at street level left and right of the central bay, and the central bay elements (columns, stairs, set-back entrance, door frames, signage) are not positioned as the photographs show | `0.9.0` → Per-building models: **hero façade (6840)** | Open |
 | Nothing should stand in front of the hero façade that blocks it — no awning, no temporary structure | `0.9.0` → Per-building models: **hero façade (6840)**, same item | Open |
 | Between kerb and building line the walkable surface is the terrain mesh, not a modelled pavement | `0.6.0` → Look and sound: **model the pavement between kerb and building line** | Open |
 | Retail parapet has no moulded profile, and wall lettering built as a plate does not read at 40 m | `0.9.0` → Per-building models: **6800 Lee Drug and 6806–6820, second pass** | Open (moved out of `0.1.6`) |
 | 6822 Budget is a bare blockout volume — no photograph exists to model it from | `0.9.0` → Per-building models: **photography gap** | Deferred (moved out of `0.1.6`) |
 Accepted by the owner, not a defect:
 - Banners hang on the column line rather than flush to the wall — that is how they hang in the photographs.
 Resolved and removed from this list on 2026-11-09:
 - "The El Capitan Theatre has no marquee or blade sign" — the trim has been staged since `Tools/ue_stage_theatre_trim.py` landed; the demo map carries all six trim actors (`/tmp/gigline/theatre-import.txt`).
 - "Materials are not yet created in Blender or fully integrated" — contradicted by the Scene conventions above: every surface carries a look-dev material built in `Tools/ue_build_demo_map.py`.
@@ -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.4 — Proper building façades (patch)
 Suggested blender skills: **procedural-modeling** + **geometry-nodes** (the façade module kit — bay, pilaster, cornice, parapet, window, shopfront, door — as reusable node groups), **archviz** (real-world scale and façade composition), **materials** (procedural brick, concrete, stone, render, glass — the ported generators), **texture-workflow** (AO/curvature/normal bakes and decals for the motto band and medallions), **uv-workflow** (texel density and modular UV layouts for the kit), **scene-assembly** (assembling kit pieces onto the fifteen block buildings), **lookdev** (screenshot-comparison loop until shading reads correctly), **historical-worlds** or **realistic-style** (1920s Hollywood Blvd neoclassical direction), **asset-optimization** + **unreal-export** (pre-export validation, `ue_metric_v1` preset), **qa-review** (final gate before the `Tools/render_screenshots.sh` review).
 ### Patch tasks
 - [ ] **Finish the Blosm blockout cleaning/detailing (moved from the deferred `0.1.0` item).** Import state: `Art/blender/blockout/blockout-2026-11-06.blend` (86 meshes, EPSG:26911, 0.0 cm affine residual) with cleaning tooling in `Geo/tools/` and `Art/blender/blockout/blosm_blockout.py`. To do here: (a) untextured roofs/facades → **Replace placeholder materials** below; (b) Blosm `setupScript` façade styles → **Give OSM buildings a façade style** below; (c) the 3 of 15 buildings lacking height data are the `0.1.2` placeholder-heights item.
 - [ ] **Define the façade module.** One set of reusable pieces (bay, pilaster, cornice, parapet, window, shopfront, door) at a fixed module, exported with the `ue_metric_v1` preset so every building assembles from the same kit.
 - [ ] **Replace placeholder materials.** Every blockout building currently carries Blender flat colours. Port the procedural generators from `Tools/sibling_asset_audit.py`'s sibling project (`brick_facade`, `seamless_concrete`, `asphalt`) and add stone, render, and glass, then wire them through Unreal material instances.
 - [ ] **Give OSM buildings a façade style.** Blosm exposes `scene.blosm.setupScript` (`setup/neoclassical.py` is the example) so a building can carry a real elevation instead of a plain extrusion. Build one style script for the south frontage and one for the north.
 - [ ] **Hero façade detail pass.** Ionic capitals and fluting, the parapet motto band and medallions as geometry or decal, window rhythm behind the colonnade, and the three portal flights at their photographed proportions.
 - [ ] **El Capitan Theatre (6838) and the retail neighbours.** Model from the 18-frame 5472×3648 reference set; the theatre shares the measured 4.96 m bay rhythm with the temple.
 - [ ] Review every façade change with `Tools/render_screenshots.sh` before tagging.
 - [ ] Tag `v0.1.4` and write `CHANGELOG.md` entry; then remove this section.
 ## 0.2.0 — MPFB player body, third-person camera, basic animation (weeks 7–9)
 ### Character setup
@@ -187,6 +172,7 @@ Suggested blender skills: **procedural-modeling** + **geometry-nodes** (the faç
 - [ ] Create an evening lighting preset.
 - [ ] Complete a visual polish pass across the neighborhood.
 - [ ] Model the pavement between kerb and building line; today that strip is the terrain mesh, which reads as bare ground under the shopfronts (`Screenshots/README.md`). Carried over 2026-11-09.
 - [ ] Add ambient audio (city ambience, traffic, basic SFX).
 - [ ] Verify licenses for all added audio files.
@@ -290,7 +276,49 @@ Suggested blender skills: **procedural-modeling** + **geometry-nodes** (the faç
 - [ ] Fix compatibility issues from the hardware testing matrix.
 - [ ] Tag `v0.8.3` and write `CHANGELOG.md` entry; then remove this section.
-## 0.9.0 — Feature freeze, public beta, license and build audit (weeks 31–34)
+## 0.9.0 — Realistic buildings (weeks 31–34)
 Suggested blender skills: **archviz** (real-world scale, façade composition, elevation read), **references** (reference-image-match and visual-match checklists — every building is judged against its own photograph), **procedural-modeling** + **geometry-nodes** (the façades system: bay module, cornice and coping profiles, storefront types as reusable node groups), **materials** (measured albedo and roughness per surface type), **texture-workflow** (baked AO/curvature/normal, decals for painted lettering and signs), **uv-workflow** (texel density and modular UVs), **lod-pipeline** (LOD chain per building), **collision-proxy** (UCX proxies so detail geometry is not the collider), **lookdev** (screenshot comparison loop), **camera-cinematography** (reproducing each building's reference angle), **asset-optimization** + **unreal-export** (pre-export validation, `ue_metric_v1`), **qa-review** (the gate before every review shot).
 ### Façade system
 - [ ] **Extend the module kit beyond one order.** Art Deco, neoclassical and streamline-moderne variants on the shared 4.96 m bay: alternate window proportions, spandrel and transom bands, and the way each order terminates at the roof.
 - [ ] **Build a profile library** for cornices, copings, string courses, sills and storefront surrounds, so a building is assembled from named profiles rather than ad-hoc boxes.
 - [ ] **Storefront types**: recessed entry, bulkhead and kickplate, mullion spacing, transom, awning/canopy brackets, and grille/shutter variants.
 - [ ] **Signage and lettering as decals.** Painted wall lettering, blade signs and fascia panels become texture and decal work with a documented projection; `0.1.6` proved that lettering built as geometry plates cannot resolve at review distance.
 - [ ] Document the system in `Art/blender/README.md` and the arc42 building block view.
 ### Per-building models
 Each building needs its own reference set; where none exists the blockout stays and the item says so.
 - [ ] Hero façade (6840): raise to this pass's detail level — capitals and fluting, window rhythm behind the colonnade, parapet motto band and medallions.
 - [ ] Hero façade (6840), entrance: **doors at street level left and right of the central bay**, as the photographs show, and correct positioning of the central-bay elements (column bases, entrance stairs, set-back entrance, door frames, banners and signage). Nothing may stand in front of the façade that blocks it — no awning, no temporary structure. Carried over from `Screenshots/README.md`, 2026-11-09.
 - [ ] El Capitan Theatre (6838): marquee, blade sign, entrance and the theatre's own elevation from its 18-frame set.
 - [ ] 6800 Lee Drug and 6806–6820: second pass on the `0.1.6` trim. Moved here from that patch because geometry cannot close them: **wall lettering as a decal** (a plate at 0.10 m still vanishes at 40 m), a **moulded parapet profile** instead of a two-tier box, richer **corner-tower stepping**, and the portrait panels reworked as textures rather than framed plates.
 - [ ] **Photography gap — 6822 Budget** (deferred out of `0.1.6`, blocked): no photograph exists; the single-storey 6.0 × 5.5 m volume cannot be read from the neighbour shot, so it stays a bare blockout until references are acquired. Record the sources checked in `Geo/`. Also re-shoot 6806–6820 and 6800 from the south sidewalk: the only reference is one oblique with a bus across Lee Drug's shopfront and a car across 6806's.
 - [ ] 6902, 6922 and the remaining south frontage.
 - [ ] North side: TCL Chinese Theatre and Madame Tussaud's façades from their reference sets.
 - [ ] Reconcile every modelled height against `Geo/tools/block_height_report.py` and record the source per building.
 ### Materials, UVs and performance
 - [ ] **Measured material library**, including the hero's stone, which currently renders pale because it is a procedural graph and a generated texture set rather than a measured surface: stucco, painted render, ashlar, brick, terrazzo, glazing, bronze and steel trim, with albedo and roughness taken from the photographs rather than guessed; one Unreal material instance per surface type.
 - [ ] **Texel-density rule** per building class, applied through modular UVs; lightmap UVs where required.
 - [ ] **LOD chain and collision proxies** per building: UCX proxies for blocking volume, detail geometry non-colliding.
 - [ ] Re-validate the 60 FPS floor at 1440p once the detail lands, and record the cost of the pass.
 ### Release checks
 - [ ] Every building with a photograph has a review shot measured against it, with silhouette and proportion deltas recorded in `Screenshots/README.md`.
 - [ ] No building carries an unverified façade; blockouts without references are listed as such in `TODO.md`.
 - [ ] Every building has a collision proxy and at least one LOD.
 - [ ] No surface left on a placeholder material.
 - [ ] `THIRD_PARTY_NOTICES.md` covers every photographic reference used in this pass.
 - [ ] Performance target still met at 1440p.
 - [ ] Tag `v0.9.0` and write `CHANGELOG.md` entry; then remove this section.
 ## 0.10.0 — Feature freeze, public beta, license and build audit (weeks 35–38)
 ### Freeze and audit
@@ -302,29 +330,29 @@ Suggested blender skills: **procedural-modeling** + **geometry-nodes** (the faç
 ### Release checks
- [ ] Beta feedback triaged; blockers logged for `0.9.x`.
+- [ ] Beta feedback triaged; blockers logged for `0.10.x`.
- [ ] Tag `v0.9.0` and write `CHANGELOG.md` entry; then remove this section.
+- [ ] Tag `v0.10.0` and write `CHANGELOG.md` entry; then remove this section.
-## 0.9.1 — Blocker fixes (patch)
+## 0.10.1 — Blocker fixes (patch)
 ### Patch tasks
 - [ ] Fix blockers reported during the public beta.
- [ ] Tag `v0.9.1` and write `CHANGELOG.md` entry; then remove this section.
+- [ ] Tag `v0.10.1` and write `CHANGELOG.md` entry; then remove this section.
-## 0.9.2 — Regression fixes (patch)
+## 0.10.2 — Regression fixes (patch)
 ### Patch tasks
 - [ ] Fix regressions introduced by `0.9.x` fixes.
- [ ] Tag `v0.9.2` and write `CHANGELOG.md` entry; then remove this section.
+- [ ] Tag `v0.10.2` and write `CHANGELOG.md` entry; then remove this section.
-## 0.9.3 — Documentation fixes (patch)
+## 0.10.3 — Documentation fixes (patch)
 ### Patch tasks
 - [ ] Update all `Docs/` for accuracy before `1.0.0`.
- [ ] Tag `v0.9.3` and write `CHANGELOG.md` entry; then remove this section.
+- [ ] Tag `v0.10.3` and write `CHANGELOG.md` entry; then remove this section.
 ## 1.0.0 — Stable neighborhood-scale walking/driving release (weeks 35–40)
Author	SHA1	Message	Date
zwitschi	744bf8f357	release: v0.1.6 — retail frontage changelog entry, TODO pruning Writes the 0.1.6 entry, removes the completed section from TODO.md (its goal stays in ROADMAP.md per the convention), and updates the roadmap status line. Release checks: 5/5 shots verify, scene audit 0 failures, 82 tool tests, LFS check clean, owner approval recorded for the retail shot.	2026-11-09 10:10:50 +01:00
zwitschi	c72bc41af1	review: owner approves the 0.1.6 retail frontage shot Shot 5 approved 2026-11-09 (second pass). All five demo shots verified and approved; the --verify item in 0.1.6 is closed. Only the tag remains.	2026-11-09 10:09:40 +01:00
zwitschi	803e77473c	docs: give every known cosmetic issue a version, move blocked work out of 0.1.6 Screenshots/README.md's known-issues list had no tickets, so the same defects kept resurfacing as surprises. It is now a table with the issue, the version and item that owns it, and a state. Two entries were stale and are removed: the El Capitan Theatre marquee and blade sign have been staged since ue_stage_theatre_trim.py landed (six trim actors in the demo map), and 'materials are not yet created' contradicted the scene conventions in the same file. Moved out of 0.1.6, which is a patch and cannot carry new scope: - wall lettering decal, moulded parapet profile, tower stepping and portrait panels as textures -> 0.9.0 per-building models - 6822 Budget (blocked: no photograph exists) -> 0.9.0 photography gap The patch keeps what a patch can do: the trim that reads, the verified shot, the tag. Filed with their proper owners: hero entrance doors and central-bay positioning -> 0.9.0 hero item; pale hero stone -> 0.9.0 measured material library; pavement between kerb and building line -> 0.6.0 visual polish. The 0.1.6 claim is released: nothing left on this branch but the owner's approval and the tag.	2026-11-09 10:07:27 +01:00
zwitschi	3942e9a215	feat(facades): 0.1.6 retail second pass — relief, material mapping, framing What the first pass got wrong, and what changed: - The mural plates were placed 0.20 m INSIDE the solid blockout volume, so they never rendered. Nothing can be recessed into a solid we do not cut: the inset is now faked by a proud frame with a near-flush plate, and the row reads. - Detail sat 0.05 m off the wall, under a pixel of depth at 40 m. Trim planes now stand 0.10-0.20 m proud, and the parapet became two tiers with deeper reveals. - 6806's parapet started at 0.62 H and left a 4.6 m blank band; the window storey and parapet moved up to follow the photograph. - Security bars on the upper windows, twelve fluted fins on the corner tower. - The trim's stucco/white/glass slots are mapped onto the demo's look materials, so the walls sit in the same noise/texture family as the rest of the block; the colour slots sampled from the photograph stay as authored. - Review camera pulled back and widened to 66 deg so the east end is in frame. - The scene audit caught duplicate RetailTrim_ actors: the demo builder's clear list did not include the new label, so every rebuild stacked another copy. Still open and not fixable by geometry: wall lettering. A plate at 0.10 m does not read at 40 m, so it moves to the 0.9.0 decal route (TODO.md, Screenshots/README.md).	2026-11-09 09:54:33 +01:00
zwitschi	4132f42ca1	plan: give realistic buildings their own minor milestone (0.9.0) The facade work started as a patch (0.1.4) and the 0.1.6 retail pass showed what that costs: a patch has no release gate of its own, so a first pass that does not yet read as the building can sit inside a done patch series. Realism is also the leading quality goal, which a patch cannot carry. New 0.9.0 - Realistic buildings, before the feature freeze: facade system with more than one order, a profile library, storefront types, signage as decals, per-building photo-matched models, a measured material library with a texel-density rule, and LODs plus collision proxies. Former 0.9.0 freeze/beta/audit becomes 0.10.0 with patches 0.10.1-0.10.3; 1.0.0 moves to weeks 39-44. Recorded as ADR-8 (append-only) with a measurable gate BR-1..BR-5 in the quality requirements, mirrored into the combined architecture.md. The 0.1.6 item now says which of its gaps move to 0.9.0 and why more geometry cannot close them.	2026-11-09 09:54:15 +01:00
zwitschi	c53386fcf4	docs(review): embed every screenshot inline so the review happens in the file Each shot now has its own section with the image embedded, its view, expected content and both verdicts, plus a status table at the top that links to them. A path alone was not a review: the owner had to open five PNGs to judge a pass. Also recorded in AGENTS.md (a path is not a review; approval ticks both the section and the table row), the two retail assets and tools in the arc42 building block view and the combined architecture.md, and prettier-formatted the changed files.	2026-11-09 09:33:23 +01:00
zwitschi	2614d259aa	feat(facades): 0.1.6 retail frontage first pass — Lee Drug and 6806-6820 Models the two retail buildings beside the hero from their own photograph rather than the generic kit: bronze cornice, mural row, lettering band, stepped Deco parapet and rounded corner tower on 6800 Lee Drug; burgundy fascia, pilasters, white-framed windows and banded parapet on 6806-6820. Reference analysis written before any geometry (Art/blender/retail/ref-analysis.md), every unmeasured proportion carried into the part report as an assumption. 6822 Budget is deferred, not guessed: no photograph of it exists and the 6.0 x 5.5 m sliver cannot be read out of the neighbour shot. Pipeline fixes found on the way: - render_screenshots.sh called ./Engine/... for the capture step while every commandlet used the absolute path; set -e killed the script at 127 after the maps were rebuilt, so screenshots silently stayed a day old. - the facade kit applies to every Frontage_/North_ actor, so it pasted its own language over the new modelled facades; it now skips them, and the trim stages as RetailTrim_*. - pure bay arithmetic moved to Tools/_common.py so it is unit-testable without Blender (4 new tests, 82 total pass). Known gaps recorded in Screenshots/README.md, not hidden: the parapet reads as a blank band, murals and lettering do not resolve at review distance, the tower is a plain cylinder, and the review camera crops the east end.	2026-11-09 09:10:49 +01:00
zwitschi	4e703fcfd9	todo: claim 0.1.6 retail frontage on branch facade-retail-0.1.6	2026-11-09 08:59:07 +01:00
zwitschi	73aca9db80	feat(facades): 0.1.5 — hero detail, scene audit, material orphaning fixed (#32 ) Merged PR #32: 0.1.5 — hero detail, scene audit, material orphaning fixed Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 22:56:08 +01:00
zwitschi	743a290ac9	Merge pull request 'docs(arch): realism leads the quality list; performance moves to the end' (#31 ) from arch-quality-priority into main Reviewed-on: #31	2026-11-08 20:49:20 +01:00
zwitschi	71c7ca734b	docs(arch): realism leads the quality list; performance moves to the end Owner decision: prioritise realism, keep the performance target but put it last. Re-applied on a branch after the first attempt landed directly on main (reverted there; see `b8209ce`). - Quality goals (01 + combined architecture.md): 1 visual realism, 2 geographic fidelity, 3 walkability/usability, 4 reproducibility/portability, 5 provenance, 6 performance efficiency. - Quality requirements (10 + combined) reordered to match, with two realism requirements added (a façade reads like the photographs; placement within ~1 m) and the scenarios renumbered so QS-1 is the reference comparison, QS-9 the frame rate. - Guard on both documents so the order cannot become an excuse: performance is a floor, not a preference - 60 FPS at 1440p without frame generation must be met at every release; if realism cannot fit, cut the realism scope deliberately and record it, never the frame rate. Walkability outranks realism in one direction: a block you fall through is not a demo. - Solution strategy and 'quality achievement' lead with realism and describe performance as a budget, not a driver. - Docs/release-checks.md: the performance check is the last section and the per- version check list now opens with realism and closes with performance. - ROADMAP gains a 'Quality priority' section; AGENTS.md gains the tie-break rule beside the existing scope-cutting rule.	2026-11-08 20:37:32 +01:00
zwitschi	b8209ce82b	Revert "docs(arch): realism leads the quality list; performance moves to the end" This reverts commit `a1d52aa583`.	2026-11-08 20:37:19 +01:00
zwitschi	a1d52aa583	docs(arch): realism leads the quality list; performance moves to the end Owner decision: prioritise realism, keep the performance target but put it last. - Quality goals reordered (01 + combined architecture.md): 1 visual realism, 2 geographic fidelity, 3 walkability/usability, 4 reproducibility/portability, 5 provenance, 6 performance efficiency. - Quality requirements (10 + combined) reordered to match, with two new realism requirements (façade reads like the photographs; placement within ~1 m) and the quality scenarios renumbered so QS-1 is the reference comparison and QS-9 the frame rate. - Both documents carry the same guard so the order cannot become an excuse: performance is a floor, not a preference - 60 FPS at 1440p without frame generation must be met at every release; if realism cannot fit, the realism scope is cut deliberately and recorded, never the frame rate. Walkability outranks realism in one direction: a block you fall through is not a demo. - Solution strategy and 'quality achievement' now lead with realism and describe performance as a budget rather than a driver. - Docs/release-checks.md: the performance check is the last check, with that reason stated; ROADMAP gains a 'Quality priority' section; AGENTS.md gains the tie-break rule beside the existing scope-cutting rule.	2026-11-08 20:37:03 +01:00
zwitschi	5e2c5e29c0	feat(facades): 0.1.4 — module kit, textured materials, theatre trim (#30 ) Merged PR #30: 0.1.4 — facade module kit, textured materials, theatre trim Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 20:29:11 +01:00