merge: bring main (v0.1.6) into anim-body-0.2.0

Conflicts resolved by union, not by picking a side:

- AGENTS.md keeps the stronger visual-review rule (README updated with every visual
  change; a stale section is a defect).
- render_screenshots.sh keeps the absolute engine path from main and adds
  -thirdperson from this branch - both were needed and neither alone worked.
- Screenshots/README.md now lists six shots, retail and third-person both embedded;
  the known-issues tables merged, with the animation defect and unproven camera
  collision added to main's rows.
- visual_targets.json carries both expectations.
- Architecture docs: ADR-8 (realistic buildings) and ADR-9 (third-person body) both
  present and in numeric order; ADR-8 was mis-placed before the Quality Requirements
  heading in the combined document by an earlier edit, now fixed.
- Binary conflicts resolved to main's content, since the retail trim only exists
  there.

Checks: 82 tool tests, prettier clean, six embeds resolve.

Screenshots/README.md

@@ -22,7 +22,8 @@ Every shot is embedded below, in order, so the whole review happens in this file
 | 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 | [Third-person body](#5-third-person-body) | ☑ 2026-11-09 | ☐ pending |
+| 5 | [Retail frontage](#5-retail-frontage) | ☑ 2026-11-09 | ☑ 2026-11-09 |
+| 6 | [Third-person body](#6-third-person-body) | ☑ 2026-11-09 | ☐ pending |
 
 **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.
 
@@ -72,7 +73,28 @@ Every shot is embedded below, in order, so the whole review happens in this file
 
 ---
 
-## 5. Third-person body
+## 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:** 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.
+
+---
+
+## 6. Third-person body
 
 ![Third-person body: the player pawn seen from behind on the north sidewalk](demo/review-demo-third-person.png)
 
@@ -115,16 +137,19 @@ Every issue is tracked in `TODO.md` under the version that will fix it; an issue
 | Issue | Where it is tracked | State |
 | --- | --- | --- |
 | Hero stone renders pale — the material is a procedural graph and a generated texture set, not a measured surface | `0.9.0` → 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 are not positioned as the photographs show | `0.9.0` → per-building models, hero façade | Open |
-| Third-person body renders in bind pose: the clip is bound and `PlayAnimation` is called, but the pose does not apply | `0.2.0` → verify animation plays correctly | Open (blocking `0.2.0`) |
+| 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 | Open |
+| Nothing may 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 | Open |
+| Retail parapet has no moulded profile, and wall lettering built as a plate does not read at 40 m | `0.9.0` → 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` → photography gap | Deferred (moved out of `0.1.6`) |
+| Third-person body renders in bind pose: the clip is bound and `PlayAnimation` is called, but the pose does not apply | `0.2.0` → verify animation plays correctly | Open (blocks `0.2.0`) |
 | Camera collision is implemented but never exercised against a wall | `0.2.0` → camera collision | Open |
-| Between kerb and building line the walkable surface is the terrain mesh, not a modelled pavement | `0.6.0` → visual polish | Open |
+| Between kerb and building line the walkable surface is the terrain mesh, not a modelled pavement | `0.6.0` → model the pavement between kerb and building line | Open |
 
 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:
+Resolved and removed from this list on 2026-11-09:
 
 - "The El Capitan Theatre has no marquee or blade sign" — `Tools/ue_stage_theatre_trim.py` stages all six trim actors; verified in `/tmp/gigline/theatre-import.txt`.
-- "Materials are not yet created in Blender or fully integrated" — contradicted by the scene conventions above.
+- "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`.