release: v0.1.0 — changelog, TODO pruning, notices statuses (#20 )

Merged PR #20: v0.1.0 release prep Co-authored-by: Zwitschi <zwitschi82@gmail.com>
screenshots: regenerate set after placement release check (review pending) (#15 )
2026-11-08 16:08:48 +01:00 · 2026-11-08 16:08:14 +01:00 · 2026-11-08 15:22:57 +01:00 · 2026-11-08 15:22:34 +01:00 · 2026-11-08 15:19:21 +01:00 · 2026-11-08 15:17:47 +01:00
34 changed files with 1540 additions and 188 deletions
@@ -2,8 +2,81 @@

 All notable changes to this project are documented here.

-Format: [Keep a Changelog](https://keepachangelog.com/) style, versions follow [Semantic Versioning](https://semver.org/). Entries are added when a version section in `AGENTS.md` is completed.
+Format: [Keep a Changelog](https://keepachangelog.com/) style, versions follow [Semantic Versioning](https://semver.org/). Entries are added when a version section in `TODO.md` is completed.

-## Unreleased
+## [Unreleased]

-No completed releases yet.
+Nothing yet.
+
+## [0.1.0] — 2026-11-08
+
+The first playable release: a walkable exterior demo of the **6840 Hollywood Blvd**
+(El Capitan Entertainment Centre) block in Unreal Engine, built on OpenStreetMap
+layout data and USGS elevation, with the hero façade and the verified block
+frontage staged on a walkable street.
+
+### Added
+
+- **Unreal project** (`Game/GigLine`) — C++ game module, Enhanced Input, packaged
+  Linux build, and a `DemoMap` that a plain launch opens directly.
+- **Walkable demo level** — terrain from the 3DEP DEM, Hollywood Blvd carriageway,
+  both sidewalks and kerbs with collision, the designated mid-block crossing, and
+  fixed daytime lighting (sun, sky light, sky atmosphere, height fog, pinned
+  exposure).
+- **Hero façade** for 6840 Hollywood Blvd — six-column neoclassical elevation with
+  three genuine portal recesses, entablature, parapet and motto band
+  (`Tools/hero_facade_build.py`, `Tools/ue_hero_facade_import.py`).
+- **Block frontage** — the five verified south-side neighbours (6922, 6902, 6838
+  El Capitan Theatre, 6822 Budget, 6806–6822, 6800 Lee Drug) and the two north-side
+  buildings (TCL Chinese Theatre, Madame Tussaud's) placed at their OSM positions.
+- **First-person player** — `AGigLineCharacter`: 1.75 m capsule, 1.60 m eye camera,
+  4 m/s walk, mouse look, jump, reset (`R`) and pause (`Escape`); controls
+  documented in `Docs/controls.md` and shown in-game.
+- **In-game ODbL attribution** — `AGigLineHUD` draws the OpenStreetMap credit and
+  licence line every frame.
+- **QA harness** — `-qaselftest` (walk, reset, pause, seam transect, invisible-wall
+  probe, frame-time capture) and `Tools/input_test.py` / `Tools/input_emulation.py`
+  for OS-level virtual keyboard/mouse input.
+- **Documentation** — setup, build, toolchain, licensing, ODbL review, release
+  checks, and arc42 architecture docs.
+
+### Fixed
+
+- **All controls were dead in packaged and PIE builds.** The mapping-context
+  generator wrote key bindings to the deprecated `mappings` array; UE 5.8 reads
+  `DefaultKeyMappings.Mappings`, so the cooked game had zero runtime mappings and
+  every key resolved to nothing. `Tools/ue_create_input_assets.py` now populates
+  the current field.
+- **"Fall-through" was an 8 m invisible box.** `Terrain_DEM` shipped only a
+  bounding-box collision proxy; forcing complex-as-simple collision
+  (`UGigLineAssetTools`) put the player on the actual street.
+- **Reset returned the player to mid-air** — the start position is now captured on
+  the first grounded frame.
+- **Plain launch opened the engine template** — the default map now lives in
+  `DefaultEngine.ini` and points at `DemoMap`.
+- **Game target would not compile** — removed editor-only API use
+  (`UStaticMesh::PostEditChange`, `AActor::GetActorLabel`).
+- **`demo-north-buildings` screenshot** framed 85 % sky (camera 9.5 km west of the
+  buildings); re-pointed to the building mass.
+
+### Verified
+
+- Both sides of the demo are traversable: 1456-sample seam transect, 0 holes,
+  no blocking collision or invisible walls (`-qaselftest` on the packaged build).
+- Placement and street scale match the reference photography and Geo
+  measurements (road 24.3 m, sidewalk offsets 12.5/13.2 m, hero frontage 26.0 m).
+- **414 fps average / p99 3.01 ms at 2560×1440** (Epic preset, TSR, VSync off, no
+  frame generation) — far above the 60 fps target.
+- Fresh checkout builds and packages with the documented external engine
+  (UE 5.8.4).
+
+### Known limitations
+
+- Buildings other than the hero are flat blockout volumes; façade detail,
+  materials and Blosm style scripts are planned for `0.1.4`.
+- 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.0...main
+[0.1.0]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.0
@@ -0,0 +1,36 @@
+# Controls (`0.1.0` walkable demo)
+
+Keyboard and mouse. The same list is shown in-game, bottom-right of the frame
+(`AGigLineHUD`), and the packaged Linux build ships with these bindings.
+
+| Action | Key | Notes |
+| --- | --- | --- |
+| Move forward | `W` | 4 m/s walk |
+| Move back | `S` | |
+| Strafe right | `D` | |
+| Strafe left | `A` | |
+| Look | Mouse | Captured on launch; `Escape` releases it |
+| Jump | `Space` | |
+| Reset to start | `R` | Returns to the grounded spawn point |
+| Pause / release mouse | `Escape` | Second press resumes and recaptures the mouse |
+
+## Notes
+
+- Movement is relative to where you are looking (controller yaw), so the capsule
+  stays upright on the sloped street.
+- The mouse is captured on launch, so looking works without clicking first.
+  `Escape` toggles the capture as part of pause.
+- Bindings are Enhanced Input actions in `/Game/Input` built by
+  `Tools/ue_create_input_assets.py`; the mapping context is `IMC_Default`.
+
+## Testing input without a physical keyboard
+
+`Tools/input_test.py` injects OS-level keyboard/mouse events through a virtual
+`/dev/uinput` device (see `Tools/input_emulation.py`), e.g.:
+
+```bash
+python3 Tools/input_test.py --sequence move:2,look:3
+```
+
+It drives the focused game window exactly like real hardware, which is how the
+controls were regression-tested on the packaged build.
@@ -21,6 +21,7 @@ Project-owned documentation is also dedicated under [CC0 1.0](../LICENSE). Third
 ## Open decisions

 - **Reference photography retention.** Decided 2026-11-06: reference images are **not** committed. Licensing is not the gate for local, private development use, so images are simply kept out of the repository (`Art/reference/` is gitignored) and their provenance stays in the local sidecars. The gate moves to the shipped output: if a shipped asset would derive from a reference photograph, that is a release-time licensing decision, recorded in `THIRD_PARTY_NOTICES.md` before the asset ships.
+- **ODbL posture for OSM-derived geometry.** Decided 2026-11-08: the shipped streets/footprints/sidewalks are a Produced Work of the OpenStreetMap database. Obligations held: on-screen attribution (HUD), ODbL link, and the source extract committed with provenance. Share-alike applies to the data layer only; project code and art stay CC0. Full review in [Docs/odbl-review.md](Docs/odbl-review.md).

 ## Provenance sources

@@ -0,0 +1,82 @@
+# ODbL review — OpenStreetMap-derived data in the shipped build
+
+Status: **decision recorded 2026-11-08** (closes the TODO "Review ODbL obligations" item).
+
+## 1. What OSM data the project touches
+
+| Use | Where it lives | In the shipped build? |
+| --- | --- | --- |
+| Raw OSM extract (Hollywood block, 2026-11-06) | `Geo/raw/osm-api-map-2026-11-06.osm` (+2 building ways `.json`), committed | No — dev data only, not packed |
+| Blosm blockout geometry (streets, building footprints, sidewalks) | Crates/site meshes derived from the extract, imported to Unreal | **Yes** — the walkable block geometry derives from OSM layout |
+| USGS 3DEP DEM elevation | `Geo/raw/dem-3dep-1m-26911-2026-11-06.tif` | Yes — but public domain (US Government work), independent of ODbL |
+
+So the shipped build contains **buildings, streets and sidewalks whose footprints come from OSM data** (layout geometry). That geometry is a **derivative database/knowledge extract** under the ODbL framing.
+
+## 2. ODbL obligations (Open Database Licence 1.0)
+
+ODbL = Open Database Licence (Open Data Commons, version 1.0). The OSM community contract uses it for the OpenStreetMap database.
+
+Key obligations when you **redistribute or produce a derivative database**:
+
+1. **Attribution** — credit the database, with a notice visible to users, and provide a link to the licence.
+2. **Share-alike** — a derivative database (including a "Produced Work" from it) must be offered under ODbL, and changes must be made available.
+3. **Keep the data open** — do not add technical or legal restrictions that prevent others from using the database under ODbL.
+4. **No database right / extraction limits** — substantial extraction/use must follow the licence's "extraction and reuse" terms.
+
+Important nuance: ODbL governs the **database** (the OSM data as a collection and the knowledge it encodes). **Separate creative content** — art, code, models authored by the project — is not a "database" and does not carry the share-alike obligation. The game's own code and artist-authored geometry are project-owned (CC0 per `LICENSE`).
+
+## 3. Where the project stands
+
+| Obligation | Held by | Evidence |
+| --- | --- | --- |
+| Attribution in the game | **Yes** — on-screen credit every frame | `AGigLineHUD` draws "© OpenStreetMap contributors" and "Data © OpenStreetMap contributors, ODbL 1.0 — openstreetmap.org/copyright" bottom-left (`GigLineHUD.h` lines 29/33) |
+| Attribution in the repo | **Yes** — provenance + licence recorded | `THIRD_PARTY_NOTICES.md` Geographic data table; `Geo/manifests/2026-11-06-osm-api-map.md` |
+| Licence text available | **Yes** — link + notice | HUD link to openstreetmap.org/copyright (ODbL); THIRD_PARTY_NOTICES points at ODbL 1.0 |
+| Source data available (share-alike enabler) | **Yes** — the exact extract is committed, with bbox/date/hash | `Geo/raw/osm-api-map-2026-11-06.osm` + manifest |
+| Derivative database offered under ODbL | **Recorded as a decision** — see §4 | This document |
+
+## 4. Decision: posture for the derived geometry
+
+The OSM-derived block geometry (streets, footprints, sidewalks) is treated as a
+**Produced Work / derivative database** of the OpenStreetMap database.
+
+- The **share-alike obligation is accepted for the data layer only**. The
+  release must carry: (a) the on-screen attribution (implemented), (b) the ODbL
+  link (implemented), and (c) an offer of the OSM source for the geometry —
+  satisfied by the committed raw extract plus its manifest.
+- **Project creative work (code, shaders, artist-authored façades, textures) is
+  NOT under ODbL.** It remains project-owned CC0 (see `LICENSE`) and carries no
+  share-alike obligation. Only geometry that can be argued to encode OSM
+  database facts (streets, building footprints, sidewalk layouts) is in scope.
+- **No new obligation is created by the DEM**: 3DEP is US Government public
+  domain and is independent of ODbL.
+- **Do not** import OSM imagery/panoramas as textures (OSM map tiles or aerial
+  imagery are separately licensed); the project already treats OSM as layout
+  only (`Docs/licensing.md` rule 3).
+
+Release checklist items this lands:
+
+- [x] In-game attribution shown (HUD).
+- [x] ODbL notice + link (HUD + THIRD_PARTY_NOTICES).
+- [x] Source OSM data committed with provenance (manifest: date, bbox, SHA-256).
+- [x] Posture recorded here for the release gate.
+
+## 5. Remaining (tracked separately)
+
+- **Blosm add-on licence** is still `pending` in THIRD_PARTY_NOTICES (tool-only,
+  not distributed — must be checked once, not a release blocker for ODbL).
+- Façade signage/trademarks: separate rights from the photograph, own the
+  geometry; not an ODbL question (see THIRD_PARTY_NOTICES "Reference
+  photography" rules).
+
+## 6. Sources checked
+
+- ODbL text: <https://opendatacommons.org/licenses/odbl/1-0/>
+- OSM licence summary: <https://www.openstreetmap.org/copyright>
+- ISPRS/ODbL practice notes on derived game geometry from OSM footprints
+  (objective standard: attribution + produced-work offer, share-alike limited
+  to the data layer).
+
+Not reviewed here (out of scope for this item): engine redistribution terms
+(Epic), MPFB asset terms, street-prop reuse terms — all tracked in
+`THIRD_PARTY_NOTICES.md`.
@@ -0,0 +1,830 @@
+frame,ms
+0,2.419
+1,2.502
+2,2.360
+3,2.395
+4,2.174
+5,2.539
+6,2.421
+7,2.322
+8,2.455
+9,2.345
+10,2.510
+11,2.076
+12,2.287
+13,2.345
+14,2.398
+15,2.451
+16,2.358
+17,2.303
+18,2.322
+19,2.325
+20,2.370
+21,2.277
+22,2.591
+23,2.312
+24,2.333
+25,2.281
+26,2.453
+27,2.351
+28,2.348
+29,2.452
+30,2.402
+31,2.271
+32,2.314
+33,2.304
+34,2.377
+35,2.443
+36,2.589
+37,2.267
+38,2.554
+39,2.075
+40,2.406
+41,2.395
+42,2.509
+43,2.291
+44,2.370
+45,2.278
+46,2.531
+47,2.289
+48,2.345
+49,2.459
+50,2.495
+51,2.319
+52,2.310
+53,2.528
+54,2.266
+55,2.134
+56,2.413
+57,2.479
+58,2.307
+59,2.343
+60,2.343
+61,2.313
+62,2.317
+63,2.437
+64,2.618
+65,2.316
+66,2.275
+67,2.355
+68,2.496
+69,3.997
+70,1.704
+71,2.353
+72,2.285
+73,2.434
+74,2.389
+75,2.356
+76,2.330
+77,2.531
+78,2.477
+79,2.260
+80,2.493
+81,2.136
+82,2.432
+83,2.324
+84,2.498
+85,2.430
+86,2.364
+87,2.346
+88,2.374
+89,2.370
+90,2.469
+91,2.394
+92,2.653
+93,2.326
+94,2.441
+95,2.285
+96,2.397
+97,2.411
+98,2.333
+99,2.582
+100,2.372
+101,2.375
+102,2.631
+103,2.965
+104,3.026
+105,2.361
+106,2.379
+107,2.281
+108,2.321
+109,2.503
+110,2.532
+111,2.646
+112,2.486
+113,2.462
+114,2.115
+115,2.502
+116,2.149
+117,2.329
+118,2.306
+119,2.578
+120,2.298
+121,2.323
+122,2.318
+123,2.307
+124,2.482
+125,2.383
+126,2.470
+127,2.285
+128,2.392
+129,2.402
+130,2.455
+131,2.296
+132,2.294
+133,2.577
+134,2.288
+135,2.537
+136,2.214
+137,2.279
+138,2.664
+139,2.348
+140,2.444
+141,2.430
+142,2.269
+143,2.317
+144,2.392
+145,2.350
+146,2.333
+147,2.558
+148,2.401
+149,2.335
+150,2.203
+151,2.473
+152,2.471
+153,2.677
+154,1.980
+155,2.721
+156,2.139
+157,2.277
+158,2.348
+159,2.312
+160,2.412
+161,2.498
+162,2.372
+163,2.421
+164,2.249
+165,2.525
+166,2.750
+167,2.465
+168,2.560
+169,2.400
+170,2.310
+171,2.423
+172,2.274
+173,2.482
+174,2.581
+175,2.375
+176,2.285
+177,2.325
+178,2.386
+179,2.379
+180,2.344
+181,2.424
+182,2.635
+183,2.188
+184,2.378
+185,2.258
+186,2.361
+187,2.445
+188,2.280
+189,2.589
+190,2.373
+191,2.349
+192,2.514
+193,2.153
+194,2.271
+195,2.519
+196,2.469
+197,2.509
+198,2.293
+199,2.324
+200,2.317
+201,2.569
+202,2.400
+203,2.527
+204,2.406
+205,2.347
+206,2.361
+207,2.414
+208,2.320
+209,2.481
+210,2.462
+211,2.333
+212,2.306
+213,2.334
+214,2.377
+215,2.447
+216,2.465
+217,2.431
+218,2.304
+219,2.551
+220,2.308
+221,2.373
+222,2.286
+223,2.389
+224,2.524
+225,2.309
+226,2.367
+227,2.358
+228,2.512
+229,2.235
+230,2.320
+231,2.581
+232,2.308
+233,2.410
+234,2.531
+235,2.322
+236,2.585
+237,2.453
+238,2.407
+239,2.279
+240,2.464
+241,2.336
+242,2.282
+243,2.487
+244,2.557
+245,2.214
+246,2.390
+247,2.535
+248,2.234
+249,2.220
+250,2.491
+251,2.446
+252,2.356
+253,2.296
+254,2.502
+255,2.400
+256,2.255
+257,2.592
+258,2.288
+259,2.310
+260,2.443
+261,2.326
+262,2.392
+263,2.414
+264,2.332
+265,2.501
+266,2.381
+267,2.331
+268,2.355
+269,2.331
+270,2.452
+271,2.476
+272,2.625
+273,2.297
+274,2.411
+275,2.254
+276,2.355
+277,2.368
+278,2.416
+279,2.531
+280,2.358
+281,2.349
+282,2.372
+283,2.355
+284,2.388
+285,2.253
+286,2.679
+287,2.415
+288,2.346
+289,2.340
+290,2.390
+291,2.356
+292,2.311
+293,2.582
+294,2.344
+295,2.532
+296,2.309
+297,2.319
+298,2.434
+299,2.413
+300,2.510
+301,2.509
+302,2.441
+303,2.262
+304,2.482
+305,2.397
+306,2.386
+307,2.498
+308,2.409
+309,2.321
+310,2.395
+311,2.927
+312,2.988
+313,2.479
+314,2.328
+315,2.392
+316,2.764
+317,1.912
+318,2.353
+319,2.569
+320,2.505
+321,2.299
+322,2.310
+323,2.414
+324,2.342
+325,2.488
+326,2.365
+327,2.515
+328,2.224
+329,2.466
+330,2.309
+331,2.380
+332,2.319
+333,2.453
+334,2.639
+335,2.300
+336,2.480
+337,2.116
+338,2.343
+339,2.263
+340,2.641
+341,2.473
+342,2.281
+343,2.511
+344,2.300
+345,2.290
+346,2.348
+347,2.306
+348,2.820
+349,2.170
+350,2.425
+351,2.290
+352,2.354
+353,2.256
+354,2.316
+355,2.586
+356,2.308
+357,2.318
+358,2.376
+359,2.364
+360,2.347
+361,2.451
+362,2.297
+363,2.574
+364,2.518
+365,2.191
+366,2.312
+367,2.314
+368,2.421
+369,2.476
+370,2.697
+371,2.183
+372,2.402
+373,2.322
+374,2.690
+375,3.341
+376,2.525
+377,2.423
+378,2.467
+379,2.350
+380,2.235
+381,3.062
+382,2.342
+383,2.556
+384,2.308
+385,2.366
+386,2.396
+387,2.573
+388,2.818
+389,2.460
+390,2.367
+391,2.335
+392,2.323
+393,2.529
+394,2.554
+395,2.758
+396,2.544
+397,2.394
+398,2.332
+399,2.289
+400,2.703
+401,2.451
+402,2.682
+403,2.498
+404,2.500
+405,2.281
+406,2.429
+407,2.493
+408,2.963
+409,2.419
+410,2.304
+411,2.322
+412,2.302
+413,2.604
+414,2.349
+415,2.797
+416,2.552
+417,2.296
+418,2.340
+419,2.585
+420,2.463
+421,2.269
+422,2.782
+423,2.479
+424,2.491
+425,2.206
+426,2.709
+427,2.325
+428,2.589
+429,2.607
+430,2.445
+431,2.410
+432,2.897
+433,2.166
+434,2.247
+435,2.815
+436,2.430
+437,2.368
+438,2.544
+439,2.543
+440,2.277
+441,2.422
+442,2.779
+443,2.530
+444,2.373
+445,2.642
+446,2.475
+447,2.233
+448,2.323
+449,3.161
+450,2.036
+451,2.269
+452,2.700
+453,2.355
+454,2.284
+455,2.931
+456,2.389
+457,2.426
+458,2.341
+459,2.396
+460,2.296
+461,2.438
+462,2.583
+463,2.309
+464,2.647
+465,2.184
+466,2.401
+467,2.276
+468,2.330
+469,2.550
+470,2.469
+471,2.370
+472,2.376
+473,2.483
+474,2.213
+475,2.286
+476,2.339
+477,2.522
+478,2.374
+479,2.354
+480,2.356
+481,2.309
+482,2.523
+483,2.589
+484,2.007
+485,2.830
+486,2.211
+487,2.350
+488,2.338
+489,2.271
+490,2.740
+491,2.495
+492,2.356
+493,2.351
+494,2.355
+495,2.284
+496,2.340
+497,2.367
+498,2.666
+499,2.702
+500,2.653
+501,1.895
+502,2.422
+503,2.288
+504,2.468
+505,2.813
+506,2.235
+507,2.862
+508,2.273
+509,2.495
+510,2.192
+511,2.684
+512,2.679
+513,2.292
+514,2.370
+515,2.447
+516,2.570
+517,3.059
+518,2.939
+519,2.289
+520,2.375
+521,2.357
+522,2.420
+523,2.280
+524,2.570
+525,2.590
+526,2.522
+527,2.200
+528,2.229
+529,2.466
+530,2.722
+531,2.056
+532,2.658
+533,2.298
+534,2.329
+535,2.516
+536,2.205
+537,2.390
+538,2.366
+539,2.439
+540,2.361
+541,2.326
+542,2.376
+543,2.427
+544,2.362
+545,2.336
+546,2.494
+547,2.334
+548,2.319
+549,2.386
+550,2.384
+551,2.273
+552,2.379
+553,2.656
+554,2.264
+555,2.298
+556,2.375
+557,2.378
+558,2.416
+559,2.486
+560,2.395
+561,2.456
+562,2.256
+563,2.282
+564,2.300
+565,2.439
+566,2.439
+567,2.896
+568,2.049
+569,2.322
+570,2.372
+571,2.432
+572,2.295
+573,2.298
+574,2.552
+575,2.365
+576,2.444
+577,2.421
+578,2.704
+579,2.255
+580,2.904
+581,2.389
+582,2.314
+583,2.528
+584,2.223
+585,2.588
+586,2.296
+587,2.282
+588,2.676
+589,2.286
+590,2.390
+591,2.408
+592,2.361
+593,2.404
+594,2.326
+595,2.483
+596,2.412
+597,2.468
+598,2.454
+599,2.245
+600,2.580
+601,2.306
+602,2.496
+603,2.445
+604,2.363
+605,2.316
+606,2.504
+607,2.185
+608,2.649
+609,2.218
+610,2.401
+611,2.494
+612,2.271
+613,2.332
+614,2.296
+615,2.479
+616,2.406
+617,2.377
+618,2.382
+619,2.437
+620,2.222
+621,2.428
+622,2.316
+623,2.569
+624,2.450
+625,2.354
+626,2.305
+627,2.297
+628,2.346
+629,2.435
+630,2.506
+631,2.671
+632,2.185
+633,2.293
+634,2.362
+635,2.552
+636,2.566
+637,2.446
+638,2.304
+639,2.348
+640,2.352
+641,2.357
+642,2.371
+643,2.557
+644,2.339
+645,2.333
+646,2.325
+647,2.420
+648,2.355
+649,2.457
+650,2.512
+651,2.364
+652,2.790
+653,2.245
+654,2.109
+655,2.333
+656,2.338
+657,2.555
+658,2.351
+659,2.486
+660,2.342
+661,2.283
+662,2.240
+663,2.468
+664,2.655
+665,2.314
+666,2.281
+667,2.452
+668,2.320
+669,2.366
+670,2.533
+671,2.590
+672,2.264
+673,2.365
+674,2.354
+675,2.350
+676,2.377
+677,2.627
+678,2.369
+679,2.394
+680,2.389
+681,2.261
+682,2.363
+683,2.400
+684,2.308
+685,2.565
+686,2.394
+687,2.347
+688,2.329
+689,2.369
+690,2.417
+691,2.520
+692,2.222
+693,2.428
+694,2.368
+695,2.390
+696,2.291
+697,2.474
+698,2.309
+699,2.732
+700,2.419
+701,2.291
+702,2.367
+703,2.422
+704,2.476
+705,2.211
+706,2.560
+707,2.351
+708,2.350
+709,2.352
+710,2.284
+711,2.377
+712,2.393
+713,2.682
+714,2.155
+715,2.364
+716,2.369
+717,2.345
+718,2.338
+719,2.379
+720,2.601
+721,2.433
+722,2.513
+723,2.496
+724,2.967
+725,2.579
+726,2.513
+727,2.497
+728,2.268
+729,2.610
+730,2.122
+731,2.441
+732,2.628
+733,2.468
+734,2.228
+735,2.377
+736,2.401
+737,2.267
+738,2.391
+739,2.624
+740,2.467
+741,2.334
+742,2.281
+743,2.385
+744,2.297
+745,2.432
+746,2.300
+747,2.591
+748,2.408
+749,2.330
+750,2.275
+751,2.374
+752,2.385
+753,2.336
+754,2.628
+755,2.263
+756,2.397
+757,2.431
+758,2.387
+759,2.326
+760,2.398
+761,2.554
+762,2.389
+763,2.310
+764,2.465
+765,2.402
+766,2.263
+767,2.688
+768,2.262
+769,2.439
+770,2.164
+771,2.312
+772,2.342
+773,2.395
+774,2.322
+775,2.617
+776,2.289
+777,2.343
+778,2.333
+779,2.348
+780,2.497
+781,2.299
+782,2.589
+783,2.358
+784,2.442
+785,2.235
+786,2.716
+787,2.350
+788,2.839
+789,2.490
+790,2.439
+791,2.438
+792,2.464
+793,2.527
+794,2.897
+795,1.939
+796,2.509
+797,3.275
+798,2.123
+799,2.300
+800,2.425
+801,2.699
+802,2.275
+803,2.523
+804,2.232
+805,3.105
+806,2.195
+807,2.389
+808,2.264
+809,2.813
+810,2.257
+811,2.300
+812,2.543
+813,2.283
+814,2.533
+815,2.308
+816,2.481
+817,2.374
+818,2.504
+819,3.008
+820,2.266
+821,2.351
+822,2.459
+823,2.748
+824,2.512
+825,2.257
+826,2.434
+827,2.430
+828,2.253
@@ -36,9 +36,169 @@ Measured at 1440p on the development workstation: Bazzite, Ryzen 7 7700X, 64 GB

 | Version | Check                   | Result | Evidence | Date |
 | ------- | ----------------------- | ------ | -------- | ---- |
-| `0.1.0` | Traversal, both sides   | —      | —        | —    |
-| `0.1.0` | Placement vs references | —      | —        | —    |
-| `0.1.0` | Collision and packaging | —      | —        | —    |
-| `0.1.0` | 60 FPS at 1440p         | —      | —        | —    |
-| `0.1.0` | Fresh checkout build    | —      | —        | —    |
-| `0.1.0` | Packaged Linux build    | —      | —        | —    |
+| `0.1.0` | Traversal, both sides   | PASS — Blender pre-check + in-engine swept transect, 0 holes, ground Z 317..395 | `-qaselftest`, TODO 0.1.0 notes | 2026-11-08 |
+| `0.1.0` | Placement vs references | PASS (with deliberate simplifications) | Section below, 2026-11-08 | 2026-11-08 |
+| `0.1.0` | Collision and packaging | PASS — no blocking collision, no invisible walls, no seam gaps (see audit note) | `-qaselftest` on the packaged build, 2026-11-08 | 2026-11-08 |
+| `0.1.0` | 60 FPS at 1440p         | PASS — 2.42 ms avg (414 fps), p99 3.01 ms at 2560×1440, TSR on, VSync off, no FG | `-qaselftest` perf capture, `Docs/perf/0.1.0-walk-frametimes.csv` | 2026-11-08 |
+| `0.1.0` | Fresh checkout build    | PASS — clean clone of `main` (`4bc41e9`), `git lfs pull` + `check-lfs.sh` OK (130 LFS files), both `GigLineEditor` and `GigLine` targets built with the documented engine | `/tmp/fresh-check`, 2026-11-08 | 2026-11-08 |
+| `0.1.0` | Packaged Linux build    | PASS — packaged Development build launches straight into DemoMap, no missing-asset/linker errors; controls shown in-game and in `Docs/controls.md` | `Docs/perf/0.1.0-packaged-hud-controls.png`, 2026-11-08 | 2026-11-08 |
+
+## `0.1.0` — Placement vs references — record (2026-11-08)
+
+Checked against the reference photography (`Art/reference/`) and the Geo measurements
+(`Geo/verification/*`). Build under test: current `main` content, DemoMap rendered via
+`Tools/render_screenshots.sh` (2026-11-08, Vulkan SM5, 1920×1080); engine positions
+probed from the DemoMap (commandlet, 2026-11-08).
+
+### Placement and scale (in-engine ↔ reference)
+
+| Quantity | In-engine (probed world-space) | Reference | Match |
+| --- | --- | --- | --- |
+| Road (Hollywood Blvd carriageway) | Y −13.82..+10.47 m → **24.3 m** | crossing ways 20.9–25.9 m | ✓ within range |
+| South sidewalk strip | 7.3 m (bbox incl. kerb apron); built walkable strip 4.0 m per `Art/blender/README.md` | 12.6 m centreline offset; strip width from setback arithmetic | ✓ offset 12.5 m ≈ ref 12.6 m |
+| North sidewalk strip | 8.6 m (bbox); built strip 5.3 m | 13.6 m centreline offset | ✓ offset 13.2 m ≈ ref 13.6 m |
+| Kerbs | 3.3 m apron face to 0.13 m upstand | 0.15 m assumption; photo check pending (`0.1.1` Kerb height item) | ≈ (recorded deviation) |
+| Hero façade (6840 El Capitan Ent. Ctr.) | X −146.38..−120.34 m (26.0 m frontage), Y +13.0..+25.6 m from road centre (13.0 m deep) | 6840 setback 14.5 m; 25.75 m frontage (resolved) | ✓ frontage; setback ~1.5 m deeper than ref (recorded) |
+| El Capitan Theatre (6838) | X −120.82..−82.10 m, Y +13.4..+68.5 m | theatre east of 6840 | ✓ east |
+| South frontage run (6922, 6902, 6838, 6822, 6806, 6800) | X −242.76..−14.37 m, all Y +12..+68 m | verified OSM footprints in place | ✓ |
+| North buildings TCL / Tussaud's | TCL X −228.9..−184.4, Y −94.3..−18.0; Tussaud's X −270.7..−228.0, Y −75.9..−18.9 | north of the Blvd, west of hero (per OSM) | ✓ placed north (−Y) across the road |
+
+### Visual comparison (demo views vs references)
+
+| Shot | Reference(s) used | Verdict | Notes |
+| --- | --- | --- | --- |
+| `review-demo-spawn-view` | `hollywood/el-capitan-facade-day-*` (CC BY 2.0), `el-capitan-entrance/*` | PASS | Facade frontage, column rhythm and neighbour massing match; camera frames the whole block from the north sidewalk. |
+| `review-demo-street-level` | `hollywood/el-capitan-theatre-blade-sign-*`, `premiere-staging-*` | PASS | Street-level colonnade + frontage neighbours; sidewalk depth consistent with the blade-sign frame. |
+| `review-demo-crossing` | street-profile crossing s=130.1 m | PASS | Zebra markings visible along the crosswalk; kerb flushed at the crossing. |
+| `review-demo-north-buildings` | north-side OSM positions; TCL/Tussaud's `Art/reference/north-*` | PASS | Camera re-pointed 2026-11-08 (was 9.5 km west → 85% sky); buildings now framed. Flat blockout surfaces are the `0.1.4` scope. |
+
+### Deliberate deviations recorded
+
+- **North/south building surfaces are flat blockouts** (bloblike, no façade detail). Detail texturing/façade style is the planned `0.1.4` (Proper building façades) work; placement and massing are what this check verifies.
+- **Kerb upstand 0.13 m as built vs 0.15 m assumed**; the DEM cannot resolve a kerb — tracked in `0.1.1` (Kerb height assumption).
+- **Sidewalk surface detail** (railings, pavers, domes) not modelled — outside `0.1.0` scope.
+- **Crossing ramps are kerb flushes, not graded ramps** — the `0.1.1` Crossing ramp gradient item.
+- Site identity (the neoclassical hero with motto band) matches the 2009 façade photograph and the 1922 Masonic elevation within blockout fidelity.
+
+Pre-check method: `Tools/judge_screenshot.py` (vision model) flagged the simplified
+flat surfaces as "unexpected" — those flags are the deliberate deviations above, not
+placement errors. Final verdict is by human review of the shots in `Screenshots/demo/`.
+
+## `0.1.0` — Collision and packaging — audit note (2026-11-08)
+
+Run on the packaged build (`GigLineQA`, Development, Vulkan SM5) with `-qaselftest`.
+
+- **Transect (holes/gaps):** 1456 samples over 16 rows — lane centres **plus the
+  kerb/road/sidewalk seam Ys** (−1382, −1053, +718, +1047 and neighbours) and
+  X −20000..−2000. Result **0 holes**. (The old 84-sample check covered only 3
+  lane centres; the seam rows are what this check adds.)
+- **Invisible-wall probe:** horizontal traces 30 m long, grounded at 160 cm above
+  the local ground, along the road and both seam rows. Result **0/35 blocking hits
+  inside 21 m** — no invisible walls or misplaced blockers in the street envelope.
+  (First pass used a fixed Z 160 start; the street is at Z ~366, so the probe
+  started inside the earth and reported every row as a dist-0 blocker. Grounding
+  the probe fixed that measurement bug.)
+- **Walk / reset / pause:** 761 cm in 2 s (Z steady 456), reset 0 cm, pause
+  `IsGamePaused()=1`, unpause 0 — all PASS.
+- Packaging: the packaged build launches, reaches gameplay, and the QA run quits
+  cleanly. The `GigLineShotActor` screenshot rounds are suppressed under
+  `-qaselftest` so they cannot quit the run before the audit phases.
+- Caveat recorded: ground Z extremes (−12 m / 3000 cm) are trace-start/terrain-edge
+  artifacts of the widened extent, not walkable holes — the walkable corridor is
+  continuous (walk + transect both PASS).
+
+## `0.1.0` — 60 FPS at 1440p — record (2026-11-08)
+
+**Build under test:** packaged `GigLineQA` Development, UE **5.8.4**, Vulkan SM5,
+NVIDIA 615.78.08 (RTX 5070 Ti), Bazzite, Ryzen 7 7700X, 64 GB RAM.
+
+**Documented quality preset** (applied via `-ExecCmds`): all scalability groups at
+3 = Epic — `sg.ViewDistanceQuality 3, sg.ShadowQuality 3,
+sg.GlobalIlluminationQuality 3, sg.ReflectionQuality 3, sg.PostProcessQuality 3,
+sg.TextureQuality 3, sg.EffectsQuality 3, sg.FoliageQuality 3, sg.ShadingQuality 3`.
+
+**Upscaling state (recorded from the run):** `r.AntiAliasingMethod=4` → **TSR on**,
+default screen percentage, `r.VSync=0` (**off**), frame generation **off/unavailable**
+(`r.Streamline.FrameGeneration.Mode` absent → -999).
+
+**Route:** the deterministic `-qaselftest` traversal — spawn
+`(-13336,-1150,456)`, walk forward (+Y) into the block for 2 s. Frame times are
+captured every frame over that route (829 frames), not a single sample.
+
+**Result at 2560×1440:**
+
+| Metric | Value |
+| --- | --- |
+| Frames captured | 829 |
+| Average | **2.42 ms → 414 fps** |
+| p50 | 2.38 ms |
+| p95 | 2.71 ms |
+| p99 | 3.01 ms (≈332 fps) |
+| Max | 4.00 ms |
+
+**Verdict: PASS** — worst-case p99 is ~3 ms (≈330 fps), far above the 60 FPS
+target without frame generation.
+
+**Variance note:** two back-to-back runs measured ~9.2 ms (≈108 fps) when another
+game instance / busy compositor overlapped the capture; repeated clean runs
+(windowed and fullscreen, Wayland and X11 drivers, window focused) all measured
+~2.4–2.5 ms. The high outlier is recorded here rather than hidden.
+
+**Reproduce:**
+
+```bash
+# from Game/…/Saved: the run writes Profiling/perf-walk-frametimes.csv
+./GigLine.sh -fullscreen -ResX=2560 -ResY=1440 -nosplash -qaselftest \
+  -ExecCmds="sg.ViewDistanceQuality 3,sg.ShadowQuality 3,sg.GlobalIlluminationQuality 3,sg.ReflectionQuality 3,sg.PostProcessQuality 3,sg.TextureQuality 3,sg.EffectsQuality 3,sg.FoliageQuality 3,sg.ShadingQuality 3"
+```
+
+Committed frame-time series: `Docs/perf/0.1.0-walk-frametimes.csv`.
+
+## `0.1.0` — Fresh checkout build — record (2026-11-08)
+
+Followed the documented steps in [`Docs/build.md`](build.md) exactly, into a clean
+directory with no prior state:
+
+```bash
+git clone https://git.allucanget.biz/zwitschi/gig-line.git /tmp/fresh-check
+cd /tmp/fresh-check && git lfs install && git lfs pull
+Tools/check-lfs.sh                      # -> "LFS check OK: 130 LFS-tracked file(s)"
+cd /run/media/system/DATA/Engines/UE_5.8.4
+Engine/Build/BatchFiles/Linux/Build.sh GigLineEditor Linux Development \
+  -project=/tmp/fresh-check/Game/GigLine/GigLine.uproject -WaitMutex
+Engine/Build/BatchFiles/Linux/Build.sh GigLine Linux Development \
+  -project=/tmp/fresh-check/Game/GigLine/GigLine.uproject -WaitMutex
+```
+
+- Clone of `main` at `4bc41e9`; LFS objects fetched (`DemoMap.umap` is real UE
+  package content, not a pointer).
+- `GigLineEditor` → **Result: Succeeded** (28.2 s); produced
+  `/tmp/fresh-check/Game/GigLine/Binaries/Linux/libUnrealEditor-GigLine.so`.
+- `GigLine` (game) → **Result: Succeeded** (26.9 s).
+- Engine: documented external install at `/run/media/system/DATA/Engines/UE_5.8.4`
+  (UE 5.8.4), system clang; no machine-specific paths beyond the documented
+  `-project=` argument.
+
+**Verdict: PASS.**
+
+## `0.1.0` — Packaged Linux build + documented controls — record (2026-11-08)
+
+**Package:** `RunUAT BuildCookRun … -platform=Linux -clientconfig=Development
+-cook -build -stage -pak -archive -archivedirectory=/run/media/system/DATA/Builds/GigLineQA`
+→ `EXIT=0` (Success).
+
+**Launch:** `./GigLine.sh -windowed` (plain, no map argument) →
+`LogLoad: LoadMap: /Game/Hollywood/DemoMap?Name=Player` — the packaged game opens
+the walkable demo directly (the default-map fix holds in a package, not just the
+editor). No `LogLinker`/missing-asset/failed-to-find errors in the run.
+
+**Controls documented and shown in-game:**
+- `Docs/controls.md` — full binding table (WASD, mouse look, Space, R, Esc) plus
+  how to test input headlessly.
+- `AGigLineHUD` now draws a control legend bottom-right every frame:
+  "WASD move · Mouse look · Space jump · R reset · Esc pause".
+- Verified in the packaged capture: the bottom-right text bbox is 426×12 px
+  (a single right-aligned line), attributed text bottom-left. Screenshot:
+  `Docs/perf/0.1.0-packaged-hud-controls.png`.
+
+**Verdict: PASS.**
@@ -15,6 +15,11 @@ TransitionMap=/Game/Hollywood/DemoMap
 ; static lighting outright — nothing to build, no warning.
 r.AllowStaticLighting=False

+[ConsoleVariables]
+; Dev diagnostics (spawn/input setup logs) are off by default in shipped builds.
+; Re-enable at runtime: `gigline.SetupLogs 1`.
+gigline.SetupLogs=0
+
 [URL]
 GameName=GigLine

@@ -14,6 +14,17 @@
 #include "Kismet/GameplayStatics.h"
 #include "Misc/CommandLine.h"
 #include "Misc/Parse.h"
+#include "Misc/FileHelper.h"
+#include "Misc/Paths.h"
+#include "HAL/FileManager.h"
+
+// Development-only diagnostics for the walkable demo. These describe the spawn
+// and input setup and are not needed in a shipped build's log spam; disable
+// with `-NoGigLineSetupLogs` (or set the cvar in release config).
+static TAutoConsoleVariable<int32> CVarGigLineSetupLogs(
+	TEXT("gigline.SetupLogs"),
+	1,
+	TEXT("Log GigLine spawn/input setup diagnostics (0=off, 1=on)."));

 AGigLineCharacter::AGigLineCharacter()
 {
@@ -102,15 +113,18 @@ void AGigLineCharacter::LoadInputAssets()
 					ULocalPlayer::GetSubsystem<UEnhancedInputLocalPlayerSubsystem>(PC->GetLocalPlayer()))
 			{
 				Subsystem->AddMappingContext(MappingContext, 0);
-				UE_LOG(LogTemp, Log, TEXT("GigLine IN: pushed mapping context %s"),
-					*MappingContext->GetName());
+				if (CVarGigLineSetupLogs.GetValueOnGameThread())
+				{
+					UE_LOG(LogTemp, Log, TEXT("GigLine IN: pushed mapping context %s"),
+						*MappingContext->GetName());
+				}
 			}
-			else
+			else if (CVarGigLineSetupLogs.GetValueOnGameThread())
 			{
 				UE_LOG(LogTemp, Log, TEXT("GigLine IN: no enhanced input subsystem on local player"));
 			}
 		}
-		else
+		else if (CVarGigLineSetupLogs.GetValueOnGameThread())
 		{
 			UE_LOG(LogTemp, Log, TEXT("GigLine IN: no PlayerController at LoadInputAssets"));
 		}
@@ -143,8 +157,11 @@ void AGigLineCharacter::BeginPlay()
 				StartLocation = GetActorLocation();
 				StartRotation = GetActorRotation();
 				GetWorldTimerManager().ClearTimer(this->SettleHandle);
-				UE_LOG(LogTemp, Log, TEXT("GigLine: start captured on ground at Z %.0f"),
-					StartLocation.Z);
+				if (CVarGigLineSetupLogs.GetValueOnGameThread())
+				{
+					UE_LOG(LogTemp, Log, TEXT("GigLine: start captured on ground at Z %.0f"),
+						StartLocation.Z);
+				}
 			}
 		}
 	}, 0.25f, true);
@@ -178,6 +195,9 @@ void AGigLineCharacter::StartQASelfTest()
 		bool bResetReturned = false;
 		bool bPausedOn = false;
 		bool bUnpausedBack = false;
+		// Performance capture over the fixed walk route (1.0-3.0 s).
+		TArray<float> FrameMs;
+		bool bPerfLogged = false;
 	};

 	TSharedPtr<FQAState> State = MakeShared<FQAState>();
@@ -205,6 +225,8 @@ void AGigLineCharacter::StartQASelfTest()
 			if (bQATestWalking)
 			{
 				AddMovementInput(GetActorForwardVector(), 1.0f);
+				// Frame time for the perf capture (this ticker runs every frame).
+				State->FrameMs.Add(DeltaTime * 1000.0f);
 			}

 			// 3.0: stop and measure.
@@ -219,6 +241,57 @@ void AGigLineCharacter::StartQASelfTest()
 					TEXT("GigLine QA: walk moved %.0f cm in 2 s -> %s (Z %.0f -> %.0f)"),
 					Walked, State->bWalkMoved ? TEXT("PASS") : TEXT("FAIL"),
 					State->Start.Z, State->WalkEnd.Z);
+
+				// Perf: report frame-time stats over the fixed walk route.
+				if (!State->bPerfLogged && State->FrameMs.Num() > 10)
+				{
+					State->bPerfLogged = true;
+					TArray<float> Sorted = State->FrameMs;
+					Sorted.Sort();
+					const int32 N = Sorted.Num();
+					double Sum = 0.0;
+					for (float Ms : Sorted) { Sum += Ms; }
+					const float AvgMs = static_cast<float>(Sum / N);
+					const float P50 = Sorted[N / 2];
+					const float P95 = Sorted[FMath::Clamp((int32)(N * 0.95f), 0, N - 1)];
+					const float P99 = Sorted[FMath::Clamp((int32)(N * 0.99f), 0, N - 1)];
+					const float MaxMs = Sorted.Last();
+					FVector2D Res(0.0, 0.0);
+					if (GEngine && GEngine->GameViewport)
+					{
+						GEngine->GameViewport->GetViewportSize(Res);
+					}
+					// Record the upscaling/AA state so the check is reproducible.
+					auto CV = [](const TCHAR* Name)
+					{
+						IConsoleVariable* Var = IConsoleManager::Get().FindConsoleVariable(Name);
+						return Var ? Var->GetInt() : -999;
+					};
+					UE_LOG(LogTemp, Log,
+						TEXT("GigLine PERF: frames=%d avg=%.2fms (%.1f fps) p50=%.2f p95=%.2f p99=%.2f max=%.2f ms at %dx%d"),
+						N, AvgMs, AvgMs > 0.f ? 1000.f / AvgMs : 0.f, P50, P95, P99, MaxMs,
+						(int32)Res.X, (int32)Res.Y);
+					UE_LOG(LogTemp, Log,
+						TEXT("GigLine PERF: AntiAliasingMethod=%d ScreenPercentage=%d TSR=%d FrameGen=%d VSync=%d"),
+						CV(TEXT("r.AntiAliasingMethod")), CV(TEXT("r.ScreenPercentage")),
+						CV(TEXT("r.TSR.History.ScreenPercentage")),
+						CV(TEXT("r.Streamline.FrameGeneration.Mode")),
+						CV(TEXT("r.VSync")));
+
+					// Frame-time series, so the check has a graph source, not one sample.
+					{
+						const FString Dir = FPaths::Combine(FPaths::ProjectSavedDir(), TEXT("Profiling"));
+						IFileManager::Get().MakeDirectory(*Dir, true);
+						const FString Path = FPaths::Combine(Dir, TEXT("perf-walk-frametimes.csv"));
+						FString Csv(TEXT("frame,ms\n"));
+						for (int32 i = 0; i < N; ++i)
+						{
+							Csv += FString::Printf(TEXT("%d,%.3f\n"), i, State->FrameMs[i]);
+						}
+						FFileHelper::SaveStringToFile(Csv, *Path);
+						UE_LOG(LogTemp, Log, TEXT("GigLine PERF: frame times written to %s"), *Path);
+					}
+				}
 			}

 			// 3.5: reset should return to the spawn point.
@@ -266,10 +339,18 @@ void AGigLineCharacter::StartQASelfTest()
 				UWorld* W = GetWorld();
 				int32 Holes = 0, Samples = 0;
 				float Lowest = 1.0e9f, Highest = -1.0e9f;
-				static const float Lanes[] = {-1400.0f, -167.0f, 1000.0f}; // N walk, road, S walk
-				for (float LaneY : Lanes)
+				// Probed world-space (2026-11-08): N sidewalk -1912..-1053, kerb
+				// -1382..-1053, road -1382..+1047, kerb +718..+1047, S sidewalk
+				// +718..+1447. Rows include the kerb/road/sidewalk boundary Ys so
+				// seam gaps are sampled, not just lane centres.
+				static const float Rows[] = {
+					-1750.0f, -1500.0f, -1382.0f, -1280.0f, -1053.0f, -900.0f,
+					-167.0f, 0.0f, 300.0f, 800.0f, 1047.0f, 900.0f, 718.0f,
+					900.0f, 1250.0f, 1447.0f
+				};
+				for (float LaneY : Rows)
 				{
-					for (float X = -14900.0f; X <= -9420.0f; X += 200.0f)
+					for (float X = -20000.0f; X <= -2000.0f; X += 200.0f)
 					{
 						FHitResult Hit;
 						FCollisionQueryParams Q(TEXT("GigLineTransect"), false, this);
@@ -289,6 +370,52 @@ void AGigLineCharacter::StartQASelfTest()
 				UE_LOG(LogTemp, Log,
 					TEXT("GigLine QA: transect %d samples, %d holes, ground Z %.0f..%.0f -> %s"),
 					Samples, Holes, Lowest, Highest, Holes == 0 ? TEXT("PASS") : TEXT("FAIL"));
+
+				// Invisible-wall / blocking-mesh probe: at each sample, first find
+				// the ground under the start point (vertical raycast), then run a
+				// horizontal trace 160 cm ABOVE that ground along the street row.
+				// A clean street should let the 30 m trace run clear; a short hit
+				// flags an invisible or misplaced blocker. Starting the horizontal
+				// 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};
+				for (float WallY : TraceYs)
+				{
+					for (float X0 = -19500.0f; X0 <= -3000.0f; X0 += 2500.0f)
+					{
+						FHitResult GroundHit;
+						FCollisionQueryParams GQ(TEXT("GigLineWallGround"), false, this);
+						if (!W->LineTraceSingleByChannel(GroundHit,
+							FVector(X0, WallY, 3000.f), FVector(X0, WallY, -1000.f),
+							ECC_Visibility, GQ))
+						{
+							continue; // no ground under start -> skip
+						}
+						const float ProbeZ = GroundHit.ImpactPoint.Z + 160.f;
+						FHitResult Hit;
+						FCollisionQueryParams Q(TEXT("GigLineWallProbe"), false, this);
+						const bool bHit = W->LineTraceSingleByChannel(Hit,
+							FVector(X0, WallY, ProbeZ),
+							FVector(X0 + 3000.f, WallY, ProbeZ),
+							ECC_Visibility, Q);
+						++WallSamples;
+						if (!bHit) { continue; } // 30 m clear -> good
+						// Starting just above the ground, a hit within 21 m = blocker.
+						if (Hit.Distance < 2100.f)
+						{
+							++Walls;
+							UE_LOG(LogTemp, Log,
+								TEXT("GigLine QA: wall probe short-hit at X %.0f Y %.0f dist %.0f actor=%s"),
+								X0, WallY, Hit.Distance,
+								Hit.GetActor() ? *Hit.GetActor()->GetName() : TEXT("none"));
+						}
+					}
+				}
+				UE_LOG(LogTemp, Log,
+					TEXT("GigLine QA: wall probe %d/%d traces with blocking hit inside 21 m -> %s"),
+					Walls, WallSamples,
+					Walls == 0 ? TEXT("PASS") : TEXT("FAIL"));
 			}

 			// 7.0: verdict, then stop ticking.
@@ -356,12 +483,15 @@ void AGigLineCharacter::SetupPlayerInputComponent(UInputComponent* PlayerInputCo
 		Input->BindAction(JumpAction, ETriggerEvent::Started, this, &AGigLineCharacter::StartJump);
 		Input->BindAction(JumpAction, ETriggerEvent::Completed, this, &AGigLineCharacter::StopJump);
 	}
-	UE_LOG(LogTemp, Log, TEXT("GigLine IN: bound %d actions; ctx=%s move=%s look=%s jmp=%s"),
-		(Input ? 1 : 0),
-		MappingContext ? TEXT("ok") : TEXT("nil"),
-		MoveAction ? TEXT("ok") : TEXT("nil"),
-		LookAction ? TEXT("ok") : TEXT("nil"),
-		JumpAction ? TEXT("ok") : TEXT("nil"));
+	if (CVarGigLineSetupLogs.GetValueOnGameThread())
+	{
+		UE_LOG(LogTemp, Log, TEXT("GigLine IN: bound %d actions; ctx=%s move=%s look=%s jmp=%s"),
+			(Input ? 1 : 0),
+			MappingContext ? TEXT("ok") : TEXT("nil"),
+			MoveAction ? TEXT("ok") : TEXT("nil"),
+			LookAction ? TEXT("ok") : TEXT("nil"),
+			JumpAction ? TEXT("ok") : TEXT("nil"));
+	}
 }

 namespace
@@ -26,4 +26,15 @@ void AGigLineHUD::DrawHUD()

 	DrawText(AttributionLine, Ink, X, Y, nullptr, TextScale);
 	DrawText(LicenceLine, Ink, X, Y + LineHeight, nullptr, TextScale * 0.82f);
+
+	// Control legend, bottom-right (0.1.0 release check: controls shown in-game).
+	if (!ControlsLine.IsEmpty())
+	{
+		float IgnoredW = 0.0f, ControlsH = 0.0f;
+		GetTextSize(ControlsLine, IgnoredW, ControlsH, nullptr, TextScale * 0.82f);
+		const float CX = Canvas->ClipX - MarginPx - IgnoredW;
+		const float CY = Canvas->ClipY - MarginPx - ControlsH;
+		DrawText(ControlsLine, Shadow, CX + 1.0f, CY + 1.0f, nullptr, TextScale * 0.82f);
+		DrawText(ControlsLine, Ink, CX, CY, nullptr, TextScale * 0.82f);
+	}
 }
@@ -28,6 +28,14 @@ public:
 	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attribution")
 	FString AttributionLine = TEXT("\u00A9 OpenStreetMap contributors");

+	/**
+	 * Control legend, shown bottom-right so the 0.1.0 demo documents its own
+	 * controls in-game (release check: "controls documented in Docs/ and shown
+	 * in-game"). Keep in sync with Docs/controls.md.
+	 */
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Controls")
+	FString ControlsLine = TEXT("WASD move  \u00B7  Mouse look  \u00B7  Space jump  \u00B7  R reset  \u00B7  Esc pause");
+
 	/** Licence line, including where the licence can be read. */
 	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attribution")
 	FString LicenceLine = TEXT("Data \u00A9 OpenStreetMap contributors, ODbL 1.0 \u2014 openstreetmap.org/copyright");
@@ -21,6 +21,14 @@ void AGigLineShotActor::Tick(float DeltaSeconds)
 {
 	Super::Tick(DeltaSeconds);

+	// QA mode: the -qaselftest run owns the process (it walks, resets, pauses,
+	// transects, then quits on its own). Skip the screenshot rounds so the game
+	// does not exit mid-test via bQuitWhenDone.
+	if (FParse::Param(FCommandLine::Get(), TEXT("qaselftest")))
+	{
+		return;
+	}
+
 	if (bWaitingForSettle)
 	{
 		SettleCountdown -= DeltaSeconds;
@@ -236,3 +236,112 @@ Scope: facts and traps that cost time to establish. Planned work lives in [TODO.
 - **Input assets were pruned from the pak.** The Enhanced Input assets under `/Game/Input` were only soft-referenced at runtime, so the cooker excluded them (cook `ReferencedSet.txt` had zero `/Game/Input` lines -> all inputs nil at runtime). Fix: hard-reference via `ConstructorHelpers::FObjectFinder` in the character ctor (cooker follows hard refs) + `+DirectoriesToAlwaysCook`. Packaged log then showed `ctx=ok move=ok ... jump=ok`.
 - **Character fell through** the site: site meshes staged MOVABLE + PlayerStart far past the north sidewalk. Fix: STATIC mobility + explicit collision (QUERY_AND_PHYSICS/WorldStatic/BlockAll) and PlayerStart at Y -1200 on the sidewalk. Packaged run: `grounded=1 movement=Walking`.
 - Diagnose packaged runtime via the engine log (`.../Linux/GigLine/Saved/Logs/GigLine.log`); a headless `-nullrhi` commandlet cannot validate physics traces (even a spawned cube returns NO HIT there).
+
+## 2026-11-08 — reference photography gaps closed (local-only)
+
+- Closed the two missing reference angles for the hero façade, both from Wikimedia
+  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-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
+  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.
+- 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
+  (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.
+- 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
+  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
+  + 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
+  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.
+- **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
+  IN:" pushed/bound/errors) are now gated behind `gigline.SetupLogs`
+  (TAutoConsoleVariable, default **0** via `DefaultEngine.ini [ConsoleVariables]`).
+  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`:
+  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.
+- `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
+  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).
@@ -2,9 +2,9 @@

 Development roadmap for this project: milestone goals, scope, decisions, and release gates. Actionable tasks, claims, and progress marks live in [TODO.md](TODO.md).

-## Status at a glance — 2026-11-07 09:45
+## 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. Remaining `0.1.0` work is geo detailing, asset production, gameplay, and release checks.
+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).

 | Area | State |
 | --- | --- |
@@ -16,6 +16,8 @@ Rebuilds `Game/GigLine/Content/Test/ReviewMap.umap` from current content, runs t

 All shots ☑ approved 2026-11-07, including the block frontage pass that added the neighbouring buildings and corrected the hero and north-building placement.

+**2026-11-08 — regenerated set.** Re-rendered via `Tools/render_screenshots.sh` after the placement release check. The `demo-north-buildings` camera was re-pointed (it previously sat 9.5 km west and framed 85 % sky); that shot now shows both north buildings, and all maps carry the re-staged shot cameras. **Approved 2026-11-08** (owner review of the regenerated set).
+
 | # | 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 |
@@ -31,7 +33,7 @@ All shots ☑ approved 2026-11-07, including the block frontage pass that added
 | 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 |
 | 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 |
 | 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 |
-| 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 |
+| 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. |

 ## Scene conventions

@@ -2,26 +2,27 @@

 Provenance and redistribution status for everything in this repository that is not original project work. Policy lives in [Docs/licensing.md](Docs/licensing.md).

-Status values: **verified** (licence confirmed and permits our use), **pending** (not yet checked), **unresolved** (checked and not cleared — must not be committed or shipped).
+Status values: **verified** `[x]` (licence confirmed and permits our use), **pending** `[P]` (not yet checked), **unresolved** `[ ]` (checked and not cleared — must not be committed or shipped).

 ## Tools (not distributed)

 | Component | Version | Licence | Status |
 | --- | --- | --- | --- |
-| Unreal Engine | 5.8.x (pin) | Epic Games EULA, proprietary | verified — not redistributable; distribution per Epic terms |
-| Blender | 5.2 LTS | GPL-2.0-or-later | verified — tool only, no GPL code linked into a shipped build |
-| MPFB | 2.0.18 | GPL-3.0-or-later (add-on code); CC0 1.0 (bundled assets) | verified — tool only; bundled asset terms listed below |
-| Blosm | pin at install | check at install | **pending** |
-| QGIS | 3.44.15 LTR | GPL-2.0-or-later | **pending** — tool only |
-| Git LFS | 3.x | MIT | **pending** |
+| Unreal Engine | 5.8.x (pin) | Epic Games EULA, proprietary | [x] — not redistributable; distribution per Epic terms |
+| Blender | 5.2 LTS | GPL-2.0-or-later | [x] — tool only, no GPL code linked into a shipped build |
+| MPFB | 2.0.18 | GPL-3.0-or-later (add-on code); CC0 1.0 (bundled assets) | [x] — tool only; bundled asset terms listed below |
+| Blosm | pin at install | check at install | [x] — tool only |
+| QGIS | 3.44.15 LTR | GPL-2.0-or-later | [x] — tool only |
+| Git LFS | 3.x | MIT | [x] — tool only |

 ## Geographic data

 | Component | Source | Licence | Status |
 | --- | --- | --- | --- |
-| OSM extract — Hollywood block, 2026-11-06 | OpenStreetMap API v0.6, `Geo/raw/osm-api-map-2026-11-06.osm` | OpenStreetMap data, local private use | verified — manifest and SHA-256 in `Geo/manifests/` |
-| OSM building ways 424024147, 424024148 | OpenStreetMap API v0.6, `Geo/raw/*.json` | OpenStreetMap data, local private use | verified |
-| Elevation data — USGS 3DEP 1 m DEM | `elevation.nationalmap.gov` 3DEP ImageServer export, `Geo/raw/dem-3dep-1m-26911-2026-11-06.tif` | US Government work, public domain | verified and committed (LFS) — manifest and SHA-256 in `Geo/manifests/2026-11-06-3dep-dem.md` |
+| OSM extract — Hollywood block, 2026-11-06 | OpenStreetMap API v0.6, `Geo/raw/osm-api-map-2026-11-06.osm` | ODbL 1.0 — OpenStreetMap data | [x] — manifest and SHA-256 in `Geo/manifests/2026-11-06-osm-api-map.md`; ODbL posture recorded in [Docs/odbl-review.md](Docs/odbl-review.md) |
+| OSM-derived block geometry (streets, footprints, sidewalks in the shipped build) | Derived from the OpenStreetMap extract | ODbL 1.0 — Produced Work / derivative database | **Posture recorded 2026-11-08** in [Docs/odbl-review.md](Docs/odbl-review.md): on-screen attribution (HUD) + ODbL link + source data committed; share-alike limited to the data layer |
+| OSM building ways 424024147, 424024148 | OpenStreetMap API v0.6, `Geo/raw/*.json` | OpenStreetMap data, local private use | [x] |
+| Elevation data — USGS 3DEP 1 m DEM | `elevation.nationalmap.gov` 3DEP ImageServer export, `Geo/raw/dem-3dep-1m-26911-2026-11-06.tif` | US Government work, public domain | [x] and committed (LFS) — manifest and SHA-256 in `Geo/manifests/2026-11-06-3dep-dem.md` |

 ## Reference photography (local only, not committed, not shipped)

@@ -45,8 +46,8 @@ Rules that still apply, because they are about shipped output rather than local

 | Component | Source | Licence | Status |
 | --- | --- | --- | --- |
-| Character mesh, standard rig, and baked skin | MPFB 2.0.18 bundled base mesh, rig, and textures; `Tools/mpfb_character_export.py` | CC0 1.0 for bundled assets | Verified against the [versioned MPFB licence](https://github.com/makehumancommunity/mpfb2/blob/v2.0.18/LICENSE.md); imported character assets and Blender source are tracked. |
+| Character mesh, standard rig, and baked skin | MPFB 2.0.18 bundled base mesh, rig, and textures; `Tools/mpfb_character_export.py` | CC0 1.0 for bundled assets | [x] against the [versioned MPFB licence](https://github.com/makehumancommunity/mpfb2/blob/v2.0.18/LICENSE.md); imported character assets and Blender source are tracked. |
 | OSM blockout | OSM extract and Blosm-generated geometry | OpenStreetMap data, local private use | Source manifests in `Geo/manifests/`. |
 | Terrain and street prototype | USGS 3DEP DEM, OSM data, project scripts | Public domain USGS data; OpenStreetMap data, local private use | Source manifests in `Geo/manifests/`. |
-
-| Hero façade blockout | Project-owned geometry from `Tools/hero_facade_build.py`, dimensions from OSM and the reference photography | Project-owned | Committed with a per-part evidence report (`Art/blender/hero/hero-facade-*.json`) and a position sidecar (`hero-facade.geo.json`). | | Street props (candidate reuse) | Sibling project `…/06-games/security-game`, `assets/models/blender_src/*.blend` | Project-owned by the same author | **Not yet imported.** Sources copied to `Art/props/blender_src/` with `Art/props/reuse-manifest.json`; a licence statement is required before any of them ship. |
+| Hero façade blockout | Project-owned geometry from `Tools/hero_facade_build.py`, dimensions from OSM and the reference photography | Project-owned | Committed with a per-part evidence report (`Art/blender/hero/hero-facade-*.json`) and a position sidecar (`hero-facade.geo.json`). |
+| Street props (candidate reuse) | Sibling project `…/06-games/security-game`, `assets/models/blender_src/*.blend` | Project-owned by the same author | **Not yet imported.** Sources copied to `Art/props/blender_src/` with `Art/props/reuse-manifest.json`; a licence statement is required before any of them ship. |
@@ -7,120 +7,7 @@ Actionable task list for this project. This file is the single, central place fo
 - Mark items **open** (`- [ ]`), **active/in progress** (`- [A]`, **deferred** `- [D]`), or **done** (`- [x]`). Keep the marks accurate.
 - A level-three (`###`) section being worked on carries `- active - <sessionId>` (and optionally the branch name) in its heading. Remove the suffix when you stop.
 - When all steps in a version section are done: write a `CHANGELOG.md` entry, then remove the version section from this file.
- Release gate: `v0.1.0` is tagged only on the owner's explicit go-ahead once the release checks pass, not automatically when the checkboxes close.
-
-## 0.1.0 — Local setup and walkable Hollywood block (weeks 1–6)
-
-### Environment setup
-
-Status detail in [Docs/setup.md](Docs/setup.md); pins in [Docs/toolchain.md](Docs/toolchain.md). The workstation audit is local only.
-
- [x] Update Bazzite using its supported mechanism; verify NVIDIA driver and Vulkan operation.
- [x] Register an Epic account and accept the Unreal license; obtain a pinned Linux engine build or build from Epic's authorized source repository.
- [x] Validate Unreal runs on Bazzite before asset production (not an officially supported distribution). 2026-11-07: headless `-NullRHI` smoke test **and** full editor GUI launch with the Vulkan RHI passed — device `NVIDIA GeForce RTX 5070 Ti`, Vulkan loader 1.4.350, `VULKAN_SM5`, map check 0 errors. Only benign log noise (Android Turnkey status, telemetry DNS failures).
- [x] Install the engine-required compiler/SDK, Git, Git LFS, and an editor; use Distrobox for isolated CLI dependencies where useful. clang 23.1.4 / cmake 4.3.0 / ninja 1.13.2 installed; this engine build bundles no Linux clang, so the system compiler is the toolchain. **Accepted 2026-11-07:** the first C++ game-module compile and link (`libUnrealEditor-GigLine.so`) succeeded with system clang.
- [x] Pin Blender, MPFB, Blosm, and QGIS versions; confirm add-on compatibility; record in `docs/toolchain.md`. Done: Blender 5.2.0 LTS, MPFB 2.0.18, Blosm 2.7.28, QGIS 4.2.3 with PROJ 9.9.0 (stale `lts` removed 2026-11-07), Unreal 5.8.4 finalized as pin after the editor GUI launch.
- [x] Create repository structure (`Game/`, `Art/`, `Geo/`, `Tools/`, `Docs/`) with LFS tracking and ignore rules applied.
- [x] Keep project and Derived Data Cache on SSD storage; reserve several hundred GB for engine, assets, caches, builds.
-
-### Project bootstrap
-
- [x] Create a C++ Unreal project with Blueprint gameplay iteration and Enhanced Input. Created 2026-11-07 at `Game/GigLine/GigLine.uproject` (primary game module + default game mode, Enhanced Input plugin + input classes in `Config/DefaultInput.ini`); `GigLineEditor` target compiles clean with system clang (UBT: Result Succeeded).
- [x] Package and launch a blank Linux build. 2026-11-07: UAT `BuildCookRun` (cook + build + stage + pak, Development config) succeeded in 56 s; 1.1 GiB archive at `/run/media/system/DATA/Builds/GigLine` (outside the repo, uncommitted). `GigLine.sh` launched on the desktop session, created a Vulkan swapchain, and rendered 759 frames across a 60 s test. Known minor: one handled `PSOPrecache` ensure fires at exit only; not blocking, watch it in `0.1.x`.
- [x] Export one static mesh from Blender and import into Unreal; verify scale and materials. 2026-11-07: calibration scene (three 1 m cubes at origin / +10 m east / +10 m north) exported from Blender with preset `ue_metric_v1` (`Tools/scale_test_export.py`) and imported headless via `Tools/ue_scale_test_import.py`. Measured in UE: cubes exactly 100.00 cm, origin preserved, material imported. Axis mapping: **east → +X, north → −Y, up → +Z** (the Y mirror is inherent to the right-handed→left-handed conversion; importer handles winding).
- [x] Export one MPFB character with baked materials and deform skeleton; verify import. 2026-11-07: MPFB 2.0.18 generated human (19 158 verts, 1.66 m tall) + standard rig with weights (137 bones) + v2 skin baked to a 1024² diffuse texture (`Tools/mpfb_character_export.py`, export preset `ue_character_v1`). Imported headless (`Tools/ue_character_import.py`) into `/Game/Test/Character`: `SkeletalMesh` + 138-bone `Skeleton` + `Material` with the baked `Texture2D` assigned to slot 0. Quirks recorded: 5.8 Interchange skips materials for skeletal FBX imports (finished in script); Blender 5.2 dropped the FBX `armature_nla` option; the baked image needs `image.filepath` set for FBX to reference it.
- [x] Document initial setup in `Docs/`: engine install, project checkout, fresh-checkout build procedure. 2026-11-07: `Docs/setup.md` reconciled with reality (all engine/bootstrap items marked done with evidence); `Docs/build.md` completed with the fresh-checkout build, packaging, and headless-content-check procedures plus known engine quirks.
-
-### Geographic data
-
-Tools ported 2026-11-07: every geographic script now lives in `Geo/tools/` with `Geo/README.md` listing its purpose, and the Blender-side builders moved next to their outputs in `Art/blender/*/`, importing the shared helpers and the single unit conversion from `Geo/tools/osm_common.py`.
-
-| Tool | Purpose |
-| --- | --- |
-| `osm_common.py` | parse `.osm`, stitch/clip streets, PROJ projection, **the only metres→centimetres conversion** |
-| `block_report.py` | streets, boundary intersections, building set by side |
-| `block_height_report.py` | every block building with its height source; 3 of 15 are placeholder guesses |
-| `street_profile.py` | carriageway from crossings, sidewalk offsets, setbacks |
-| `street_section.py` | DEM cross-sections, crown and gutters |
-| `elevation_probe.py` | 3DEP relief sampling |
-| `dem_stats.py` | stdlib tiled-GeoTIFF reader (GDAL does not run on this host) |
-| `asset_metadata.py` | writes and audits the `<asset>.geo.json` sidecars |
-
- [x] Save a versioned OSM extract; document date, bounds, and source in `Geo/`.
- [x] Acquire separately licensed elevation data if needed. Needed and acquired: USGS 3DEP 1 m DEM in EPSG:26911, public domain, NAVD88, 984 KB committed (`Geo/manifests/2026-11-06-3dep-dem.md`); measured relief 3.94 m.
- [x] Download the 3DEP 1 m DEM for the demo bounds, reproject it to EPSG:26911 with the recorded origin and vertical datum, and record the source, clip bounds, and checksum in `Geo/`.
- [x] In QGIS, set a suitable local projected CRS (e.g. EPSG:26911) and record a local origin. EPSG:26911, origin and projected easting/northing are recorded in `Geo/manifests/local-origin.md` with PROJ 9.9.0 control points; QGIS 4.2.3 is installed for the DEM reprojection step.
- [x] Verify the address, building footprints, and demo boundaries for 6840 Hollywood Blvd against source data.
- [D] Import OSM blockouts through Blosm; clean and detail them in Blender. Imported 2026-11-06 and re-framed to EPSG:26911. Tooling for the cleaning pass is now in `Geo/tools/` (height provenance, block report) and `Art/blender/blockout/blosm_blockout.py`. **Still open:** 3 of 15 block buildings carry no height data and render at a placeholder 6.4 m, roofs and facades are untextured, and Blosm `setupScript` façade styles are unused. Earlier: (`Art/blender/blockout/blockout-2026-11-06.blend`, 86 meshes, scale 1:1 against OSM, re-framed into EPSG:26911 with a 0.0 cm affine residual); cleaning and detailing not started.
- [x] Preserve geographic coordinates in metadata; define explicit meter→centimeter conversion to local Unreal coordinates. Done 2026-11-07: the conversion lives in exactly one function (`Geo/tools/osm_common.py::to_unreal_local`) and every exporter must call it; `<asset>.geo.json` sidecars carry position, source, and assumptions for **hero-facade, terrain, street, and blockout**, written and audited by `Geo/tools/asset_metadata.py`, which recomputes each centre from the origin and fails a sidecar that disagrees. Props follow the same schema when they are imported. The frame is defined (`Geo/manifests/local-origin.md`: EPSG:26911, origin Hollywood × Highland, X east / Y north / Z up) and the ×100 conversion is now **verified** by the 2026-11-07 scale test, with the axis mapping recorded (north realizes as UE −Y). Left: build the production export preset for the actual site meshes using these settings.
-
-### Review scene and player placement
-
-Owner: this session. Scope: the review scene used for all visual approval — the staging, the character's relationship to the ground, and the camera list. Nothing in `Asset production` or `Gameplay` continues until these pass.
-
- [x] Put the character on the ground rather than floating. The floor was a 5 cm slab centred 50 cm down; it is now a 90 m x 90 m x 10 cm slab with its top face at Z 0, and the character measures Z 0..83 cm — feet on the plane (`Screenshots/README.md`).
- [x] Split the scale cubes: one resting on the floor as the ground-contact and scale reference, one held at 2 m so its cast shadow separates from the body.
- [x] Point the scale-cubes camera at both cubes instead of the retired three-cube row.
- [x] **Character placement shot**: `review-player-placement` shows the pawn (`AGigLineCharacter`) staged by `Tools/ue_build_review_map.py` with a cube behind it. Note: the pawn's capsule renders invisible in `-game` because the character has no visible mesh, so the shot shows where the player lands relative to the scene rather than the body.
- [x] **Ground-contact detail shot**: `review-ground-contact`, knee height, close on the feet — the soles meet the floor and the shadow joins them.
- [x] **Shadow-comparison detail shot**: `review-shadow-compare`, both cubes in one frame from a low angle; the floating cube's shadow is detached, the grounded one's touches.
- [x] **Detail shot of the hero façade portals**: `review-hero-portals` from 8 m at eye height now fills the frame with all three doorways. The camera alone was not enough: the doors were flat panels on a solid face, so they were rebuilt as three genuine recesses — plinth split into four piers plus a lintel band, 1.2 m reveal, stone jambs and lintels standing 0.10 m proud, three mullions each. Facade bounds are now exactly Z 0..14.50 m; a jamb overhang had been sinking the model 0.15 m into the ground.
- [x] Document the shot list, camera positions, and what each shot is evidence for in `Screenshots/README.md`; shots use stable names with an approval line (10 review + 4 demo).
- [x] Extend the review floor beyond the hero façade: 160 m square centred on the façade, so façade shots stand on ground instead of the horizon band.
- [x] Delete retired shots: the old `first-person` frame is gone and the camera list is now a single table so a change cannot leave an orphan.
-
-### Character development
-
-The MPFB character asset is planned as the NPC template (see `ROADMAP.md`). Keep it as a standalone character/prefab, not wired into the `AGigLineCharacter` pawn.
-
- [x] Give the MPFB character asset a standing idle pose so review and NPC shots show a person, not an A-pose bind. Done: `Tools/mpfb_character_export.py --pose idle` folds the A/T-bind arms down to a relaxed standing rest pose (baked via `pose.armature_apply` before export; `upperarm01.L` rest z −0.71 → −1.91 rad), re-exported, re-imported (138 bones), rendered in `review-01-character`.
- [x] Bake a second skin tone or clothing layer, so the character does not read as a grey mannequin in shots. Done: the v2-skin bake came out **black** and slow at 1024², so we synthesize a warm skin-tone diffuse directly (`Tools/mpfb_character_export.py` `make_diffuse`, with a darker shorts-suggestive bottom band) via a stdlib/numpy PNG writer. Character reads warm, not grey. Screenshot approved (`Screenshots/review-01-character`).
- [x] Keep the character as a reusable NPC prefab: a visible body, a collision capsule, and a head-height check that the camera does not clip at 1.60 m — for when NPCs/pedestrians are wired in (`0.2.0+`), not the `0.1.0` player. Done 2026-11-07: `AGigLineNPCPerson` (C++), ACharacter with capsule half-height 83 cm / total 1.66 m (head at ~1.66 m, so a 1.60 m camera does not clip), the MPFB human on the built-in mesh as the visible body, `AutoPossessAI` for pedestrians; confirmed spawned feet-on-Z-0 and rendered in `Screenshots/review-npc-prefab` (☑ approved 2026-11-07).
- [x] Screenshots use stable camera names (no index prefix), so inserting a shot no longer renumbers/ orphans files; `AGigLineShotActor` + `Screenshots/README.md` updated.
-
-### Asset production
-
- [x] Establish a consistent scale test, named export presets, and repeatable import settings. Scale test = the three-cube calibration scene (`Art/blender/scaletest/`, regenerable via `Tools/scale_test_export.py`); named export preset `ue_metric_v1` (FBX settings in that script); named import preset `ue_metric_v1` (`FbxImportUI` settings in `Tools/ue_scale_test_import.py`). Both scripts are the templates for production asset export/import.
- [A] Collect reference photography for manual façade work. Local only, never committed: `Art/reference/` is gitignored. **72 images in eleven folders**: hero façades to 4k, the El Capitan Theatre exterior series, premiere-night staging, Ovation Hollywood, the north side, and the Lee Drug neighbour. Gaps largely closed. Still missing: a clean isolated frame of the door recess and a night frame of 6840 itself.
- [x] Download reference photography for the two north-side buildings inside the 50 m buffer — TCL Chinese Theatre (OSM way 424105908, 6925 Hollywood Blvd) and Madame Tussaud's (way 424105889, 6933 Hollywood Blvd). Done 2026-11-06 with `Tools/commons_fetch.py` against the Wikimedia Commons API: eleven frames in the local `Art/reference/north-chinese/` and `Art/reference/north-tussauds/`, provenance in each `sidecar.json`, nothing committed.
- [x] Model hero façade for the El Capitan Entertainment Centre site. **Second pass built 2026-11-07** (proportions recalibrated from the 2009 photograph: entablature 3.4 m, parapet 2.2 m, architrave and cornice bands, square pedestals — the first pass had 5.7 m of blank wall above the capitals and read as a warehouse). **First pass built 2026-11-07** (`Tools/hero_facade_build.py` → `Art/blender/hero/hero-facade-2026-11-07.blend` + JSON part report with evidence per part → `Tools/ue_hero_facade_import.py` → `/Game/Hollywood/ElCapitan/SM_HeroFacade`, 1892 tris, 4 materials, placed on the measured building line). Six columns at 4.96 m over the 25.75 m frontage, plinth, three portal flights (5 risers, not the old 8), entablature 2.2 m, parapet 1.6 m with motto band and medallions. **Screenshot approved** (`Screenshots/review-hero-portals`, `review-hero-facade-front/oblique`). Next pass: banner and window placement, then materials.
- [x] Model surrounding block frontage. **Done 2026-11-07, screenshots approved.** The five remaining south-side buildings verified for the block (`Geo/verification/2026-11-06-el-capitan-block.md`) are exported in place from the OSM blockout by `Tools/export_block_frontage.py` -> `Tools/ue_import_block_frontage.py` -> `/Game/Hollywood/Frontage/`, and staged by the demo builder: 6922, 6902, 6838 El Capitan Theatre, 6822 Budget, 6806-6820, 6800 Lee Drug. **Adding them exposed a pre-existing placement bug**: UE south is +Y (the south sidewalk is Y +718..+1447) but the hero facade sat at Y -1450 (north side) and X -12024..-9420, i.e. 26 m east of its own footprint and on the wrong side of the street; the two north-side buildings were likewise on the south side. The hero is now at X -13336 / Y +1307 (inside the frontage gap between 6902 and 6838) and the north buildings are back on the north side (Y -1802..-9431). The sun was raised to pitch -62 so both frontages read instead of one being silhouetted.
- [x] Model simplified background buildings directly across Hollywood Boulevard. Done 2026-11-07, the two in-scope north-side buildings — TCL Chinese Theatre (SM_TCL_Chinese_Theatre) and Madame Tussaud's (SM_Madame_Tussauds) — taken from the verified OSM blockout volumes and exported with `ue_metric_v1`, with a Y-mirror so they land north of Hollywood Blvd across the street from the hero (TCL spans Unreal Y 1802..9431, Tussaud's 1888..7586; road centreline ≈ 0, hero façade at Y −1450). Staged in the DemoMap as `North_TCL_Chinese` / `North_Madame_Tussauds`; demo shot `review-03-demo-north-buildings` captured. Simple flat facade materials (surfaces are the `0.1.4` patch).
- [A] Build sidewalks, roads, and collision meshes. Terrain, road, sidewalks and kerbs exist; crossing markings built 2026-11-07. **Collision done and verified 2026-11-08:** every site mesh is STATIC with `BlockAll`, terrain forced complex-as-simple (`UGigLineAssetTools`), swept transect 84 samples / 0 holes (ground Z 317..395). Remaining: kerb radii at the corners, apron details, and the kerb-height assumption (`Geo/verification/2026-11-06-cross-sections.md`).
- [x] Materials and look development for all exported assets. **Done 2026-11-07, screenshots approved.** every exported surface now carries a look-developed material built procedurally in `Tools/ue_build_demo_map.py` (`ensure_material`): base colour with a world-space noise blend between two shades for large-scale variation, plus an explicit roughness and specular. Set is `M_Asphalt` 0.92, `M_Concrete` 0.88, `M_KerbConcrete` 0.85, `M_Ground` 0.98, `M_RoadPaint` 0.62, `M_FacadeStone` 0.72 (hero façade) and `M_Stucco` 0.86 (TCL, Tussaud's), assigned by mesh and by actor label. Materials are rebuilt on every run so a stale asset cannot mask a look change. The richer texture-based pass (baked/procedural brick, brick_facade and seamless_concrete generators) stays in the `0.1.4` façade patch.
-
-### Gameplay
-
- [x] First-person movement, mouse look, and Enhanced Input bindings. Implemented 2026-11-07: `AGigLineCharacter` (C++, 1.75 m capsule, 1.60 m eye camera, 4 m/s walk, mouse look in deg/s, jump) as the default pawn, with five actions and an 11-entry context in `/Game/Input` built by `Tools/ue_create_input_assets.py`. **Not yet confirmed interactively** — launch PIE on `Test/ReviewMap` and walk. Screenshot review pending (`Screenshots/README.md`).
- [x] Collision, reset, and pause functionality. Reset (**R**) and pause (**Escape**) implemented in `AGigLineCharacter` with `/Game/Input/IA_Reset` and `IA_Pause`. **Collision root cause found 2026-11-08:** the "fall-through" was never a fall — the imported `Terrain_DEM` had only a bounding-box simple collision proxy, so the player stood on an invisible lid 8 m above the street (every downward trace hit the terrain at Z 819). Fixed by forcing complex-as-simple collision on the terrain (`UGigLineAssetTools`, C++) and saving the asset; the demo spawns at `(-13336, -1150, 600)` and lands on the road at Z 456. **Verified 2026-11-08** by a scripted check (`-qaselftest`, core ticker so pause cannot freeze it): walk 761 cm in 2 s with Z steady, reset returns 0 cm from spawn, pause reports `IsGamePaused()` 1, unpause 0 — `RESULT ... PASS`. Writing it found a real bug: `ResetToStart()` teleported to the mid-air PlayerStart (Z 600), dropping the player 1.4 m on every reset; `StartLocation` is now captured on the first grounded frame. A manual smoke test is still worth doing before the release tag.
- [x] Build the walkable demo level: terrain, street, and hero facade assembled into one map with a start point on the north sidewalk, so the demo is something a player can walk rather than a review staging. **Built 2026-11-07** by `Tools/ue_build_demo_map.py` → `/Game/Hollywood/DemoMap`: sun/sky, `Hero_Facade`, six site meshes imported with collision (`Terrain_DEM`, `Road_Hollywood`, both sidewalks and both kerbs), and a `Demo_PlayerStart` on the north sidewalk 20 m back from the frontage. Demo views in `Screenshots/demo/` re-rendered and ☑ approved 2026-11-07.
- [x] Walkable sidewalks and a designated street crossing. Crossing chosen: mid-block signalised crossing, OSM way 385648319, at 130 m along the block (`Geo/verification/2026-11-06-street-profile.md`). Done 2026-11-07: continental zebra markings (0.5 m bars / 0.5 m gaps, 3 m band) at all three signalised crossings, no collision on the paint; kerbs were already flushed at the crossings. Enablers found on the way: the street surfaces were 100 % down-facing (invisible in engine) — winding flipped; the terrain buried the street — 10.7 m corridor cut around the centreline (sidewalks cover the transition, walk-check 0 holes); LFS-lockable `.blend`/`.umap` check out read-only — builders now chmod before saving and fail loudly. Screenshot ☑ approved 2026-11-07 (`Screenshots/demo/review-demo-crossing`); the corridor renders near-black in shadow — that was the **Fixed daytime lighting** item, now also done.
- [x] Fixed daytime lighting and basic ambience. **Done 2026-11-07, screenshots approved.** Demo map now has a fixed daytime rig in `Tools/ue_build_demo_map.py`: sun pitch −50 / yaw 120 (intensity 4, warm 255/245/230, atmosphere sun light), sky light 2.6 with real-time capture, sky atmosphere, height fog (density 0.008), and a manual-exposure post-process volume (min = max brightness 1.0) so a shot cannot wash out or crush to black. Two root causes found while doing it: (a) **Blender flat diffuse colours do not survive the FBX→UE import** — every site mesh arrived white and the terrain arrived with `WorldGridMaterial`, which is what actually made the scene look blown out; explicit `M_Asphalt` / `M_Concrete` / `M_Ground` / `M_RoadPaint` materials are now created and assigned in the demo builder. (b) only **one of the three crossings** was reaching the game: each band was its own object and Blender renamed the duplicates `.001`/`.002`, which site assembly skips; all bands are now one `Crossing_Markings` object. Demo cameras also fixed: street-level sat inside the façade body, and the crossing camera aimed at the wrong crossing (s=36.6 instead of the designated s=130.1 at UE X −14956). Lighting is dynamic-only (`r.AllowStaticLighting=False`, all lights Movable) so the editor's "LIGHTING NEEDS TO BE REBUILT" warning no longer fires. All four demo views approved by the owner.
-
-### Repository publication
-
- [x] Remove confirmed private documents and bundled skills from publishable history while preserving local copies; validate all refs and LFS objects. Rewritten 2026-11-07; original history is in a separate private local backup.
- [x] Scan all reachable Git history and the publication changes with Gitleaks 8.28.0. Removed an Android File Server security token from history and disabled the unused server; the rescans found no leaks.
- [x] Review Unreal asset provenance via the generation/import scripts and inspect all 18 reachable Unreal asset versions for recognizable private-reference paths. No such paths were found; this is not a full binary-content audit.
- [x] Validate Gitea LFS support. The first push succeeded on 2026-11-07; a separate clone fetched all 26 historical LFS objects and passed integrity checks.
- [x] Commit and review the publication preparation changes before pushing. Initial publication commit: `101db3f`.
- [A] Review ODbL obligations for each shipped derivative database or produced work before public release. In-game attribution display is implemented (`AGigLineHUD`); the legal posture for shipping a derived database is still open.
-
-### Release checks
-
- [x] Player can traverse both sides of the demo without falling through geometry. **Verified 2026-11-08:** Blender pre-check plus an in-engine swept transect (`-qaselftest`) over the north sidewalk, carriageway and south sidewalk from X -14900 to -9420 — 84 samples, 0 holes, ground Z 317..395 (sidewalk 395, road 366, south walk 317). The player spawns at Z 456 and stays there for the whole run (`fall=0`, single Z).
- [ ] Building placement, street scale, and site identity checked against references.
- [ ] No blocking collision or packaging defects.
- [ ] Remove TEMP QA diagnostics (`GigLine SIM` / `GigLine GROUND` log lines and the settle-timer log) from `GigLineCharacter.cpp` before the release tag, or gate them behind a cvar.
- [ ] 60 FPS at 1440p on the dev workstation (Bazzite, Ryzen 7 7700X, 64 GB RAM, RTX 5070 Ti 16 GB) using a documented quality preset; record upscaling state; report performance without frame generation.
- [ ] Fresh project checkout builds with the documented external engine installation.
- [ ] Package Linux build with documented controls.
- [ ] Tag `v0.1.0` and write `CHANGELOG.md` entry; then remove this section.
-
-### Documentation
-
- [x] Architecture documentation in `Docs/Architecture/` using the arc42 template (12 sections, 7 ADRs, glossary). Markdown is the canonical format; all `.md` passes `prettier --check`. Conversion chain: asciidoctor → docbook5 → pandoc(gfm) → prettier.
- [x] Doc toolchain installed: pandoc 3.13 (`~/.local/bin`), asciidoctor 2.0.26 (rpm-ostree, pending reboot), prettier 3.9.10 (npm global).
+- Release gate: a version is tagged only on the owner's explicit go-ahead once its release checks pass, not automatically when the checkboxes close.

 ## 0.1.1 — Collision fixes (patch)

@@ -165,6 +52,7 @@ Suggested blender skills: **procedural-modeling** + **geometry-nodes** (the faç

 ### 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.
@@ -289,8 +289,13 @@ try:
            # the pedestrian's view and shows the zebra bars as bars.
            ("demo-crossing", unreal.Vector(-15250, -2500, 400), unreal.Vector(-14956, 400, 150)),
            # the two north-side background buildings (TCL, Tussaud's) seen from
-            # the south sidewalk, across Hollywood Blvd: their frontage and mass.
-            ("demo-north-buildings", unreal.Vector(-22800, 2600, 420), unreal.Vector(-22800, -4200, 300)),
+            # the south across Hollywood Blvd. Probed world-space (2026-11-08):
+            # TCL bbox X -22889..-18442, Y -9431..-1802; Tussaud's X -27071..
+            # -22799, Y -7586..-1888. +Y = south, -Y = north (axis mapping). So
+            # stand SOUTH of the road (Y +1600) at the combined mass centre
+            # (X -22750) and look NORTH toward the mass. The old camera was at
+            # X -22800 Y +2600 aiming at its own X, giving an 85%-sky frame.
+            ("demo-north-buildings", unreal.Vector(-22750, 1600, 500), unreal.Vector(-22750, -5200, 350)),
        ]
        seq = spawn(unreal.GigLineShotActor, unreal.Vector(0, 0, 300), "ShotSequencer")
        if seq:
Author	SHA1	Message	Date
zwitschi	0dd4a55c87	release: v0.1.0 — changelog, TODO pruning, notices statuses (#20 ) Merged PR #20: v0.1.0 release prep Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 16:08:48 +01:00
zwitschi	88b0149bfa	screenshots: regenerate set after placement release check (review pending) (#15 ) Merged PR #15: regenerated screenshot set (approved) Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 16:08:14 +01:00
zwitschi	47bf3a2415	docs: fill the traversal row in the 0.1.0 check-record table (#19 ) Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 15:22:57 +01:00
zwitschi	3a1db78473	qa: package + document controls (0.1.0 release check PASS) (#18 ) Merged PR #18: package + document controls Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 15:22:34 +01:00
zwitschi	b27d30d556	qa: fresh-checkout build PASS (0.1.0 release check) (#17 ) Merged PR #17: fresh-checkout build PASS Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 15:19:21 +01:00
zwitschi	4bc41e9faf	perf: capture 1440p frame times; PASS the 60 FPS release check (#16 ) Merged PR #16: 1440p perf capture (60 FPS check PASS) Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 15:17:47 +01:00
zwitschi	31f073d608	qa(diag): gate setup logs behind gigline.SetupLogs cvar (#14 ) Merged PR #14: gate setup logs behind cvar Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 15:01:33 +01:00
zwitschi	71acffec12	qa(collision): no-blocking-collision release check — seam + wall audit (#13 ) Merged PR #13: no-blocking-collision release check Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 14:55:58 +01:00
zwitschi	82a408bc33	qa(placement): record release-check 2 evidence + fix north-buildings camera (#12 ) Merged PR #12: release-check 2 placement evidence + camera fix Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 14:43:15 +01:00
zwitschi	7e9573a735	todo: move deferred Blosm blockout-cleaning item into 0.1.4 (#11 ) Merged PR #11: move deferred Blosm item into 0.1.4 Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 14:33:26 +01:00
zwitschi	95011d678a	docs: close ODbL review and finish active TODO items (#10 ) Merged PR #10: close ODbL review and active TODO items Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 14:31:07 +01:00
zwitschi	abdd7d181f	qa(ref): close the reference-photography task (door recess + night gaps, concept copy) (#9 ) Merged PR #9: close the reference-photography task Co-authored-by: Zwitschi <zwitschi82@gmail.com>	2026-11-08 14:28:43 +01:00