2026-11-08 18:53:49 +01:00
2 changed files with 21 additions and 11 deletions
@@ -8,6 +8,25 @@ Format: [Keep a Changelog](https://keepachangelog.com/) style, versions follow [

 Nothing yet.

+## [0.1.3] — 2026-11-09
+
+Packaging and setup fixes. No gameplay or visual scope; this patch makes the pipeline and its documentation tell the truth about what `0.1.x` taught.
+
+### Fixed
+
+- **Map imports could report success while saving nothing.** `.umap` files are LFS-tracked and check out read-only, so `save_map()` returned `False` with no error and the staged actor vanished on the next load. New `Tools/ue_common.py` (`make_writable`, `require_saved`) clears the read-only bit and makes the failure loud; `ue_hero_facade_import.py` and `ue_import_north_buildings.py` now use it. Verified from a forced `0o444` map: chmod logged, `save_map: True`, exit 0.
+
+### Changed
+
+- `Docs/build.md`: content-pipeline table now lists every step as it exists (seven site FBXs, frontage, north buildings, hero, map) and the shared FBX preset; packaging archive corrected to `Builds/GigLineQA`; the packaged log location and `-qaselftest` usage are documented; new **traps** table covers the read-only save, the hero `--out`-is-the-FBX mistake, the MPFB add-on path, the shot actor quitting under QA, and the null-RHI trace trap.
+- `Docs/setup.md`: the fresh-checkout build is marked verified (2026-11-08) and its blocker closed; a new section documents the two optional keys (`OPENROUTER_API_KEY`, `MAPBOX_ACCESS_TOKEN`) and that neither is needed by the build, the tests or a release.
+- `Docs/Architecture/07_deployment_view.md` and the combined `architecture.md`: build-output path corrected and marked as living outside the repository.
+
+### Verified
+
+- 54 tool tests pass (5 new for `ue_common`).
+- Packaged build still launches into `DemoMap` and `-qaselftest` passes every phase.
+
 ## [0.1.2] — 2026-11-09

 Scale and façade correction patch. Buildings and the hero elevation now match the reference photography and the cross-checked height data; no new gameplay scope.
@@ -110,7 +129,8 @@ The first playable release: a walkable exterior demo of the **6840 Hollywood Blv
 - Kerb height (0.13 m as built vs 0.15 m assumed), kerb radii, driveway aprons and graded crossing ramps are deferred to `0.1.1`; crossing ramps are kerb flushes.
 - One block only; no vehicles, NPCs, audio, or settings UI yet.

-[Unreleased]: https://git.allucanget.biz/zwitschi/gig-line/compare/v0.1.2...main
+[Unreleased]: https://git.allucanget.biz/zwitschi/gig-line/compare/v0.1.3...main
+[0.1.3]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.3
 [0.1.2]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.2
 [0.1.1]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.1
 [0.1.0]: https://git.allucanget.biz/zwitschi/gig-line/releases/tag/v0.1.0
@@ -9,16 +9,6 @@ Actionable task list for this project. This file is the single, central place fo
 - When all steps in a version section are done: write a `CHANGELOG.md` entry, then remove the version section from this file.
 - Release gate: a version is tagged only on the owner's explicit go-ahead once its release checks pass, not automatically when the checkboxes close.

-## 0.1.3 — Packaging and setup fixes (patch)
-
-Suggested blender skills: **export-pipeline** and **unreal-export** (scale/pivot/normals/materials/collision verification) if any packaging defect traces back to the Blender export presets.
-
-### Patch tasks - active - 01a1b26b-3c94-707f-9665-2f6b4a79b564 (branch `packaging-setup-0.1.3`)
-
- [x] Fix any packaging or build issues encountered in `0.1.x`. **Done 2026-11-09.** New `Tools/ue_common.py`: `make_writable()` clears the read-only bit an LFS `.umap` checks out with, and `require_saved()` turns a silent `save_map(False)` into a logged failure. `ue_hero_facade_import.py` and `ue_import_north_buildings.py` now call it before saving (verified from a forced `0o444` map: chmod note logged, `save_map: True`, exit 0); the map builders already did. `Docs/build.md` also gained the current pipeline table (7 site FBXs, frontage, north, hero, map), the archive path `Builds/GigLineQA`, the packaged-log location, the `-qaselftest` usage, and a **traps** table covering the read-only save, the hero `--out`-is-FBX mistake, the MPFB add-on path, the shot actor quitting under QA, and the null-RHI trace trap.
- [x] Update `Docs/` setup instructions for anything that changed. **Done 2026-11-09.** `Docs/setup.md`: fresh-checkout build marked verified (2026-11-08) with the blocker closed, plus a new _optional keys_ section (`OPENROUTER_API_KEY`, `MAPBOX_ACCESS_TOKEN`, both from the gitignored `.env`, neither needed by build/tests/release). `Docs/build.md`: header reframed for the demo, packaging command and archive corrected to `Builds/GigLineQA`, packaged-log path documented. `Docs/Architecture/07` + `architecture.md`: build-output path corrected and marked outside the repo.
- [ ] Tag `v0.1.3` and write `CHANGELOG.md` entry; then remove this section.
-
 ## 0.1.4 — Proper building façades (patch)

 Suggested blender skills: **procedural-modeling** + **geometry-nodes** (the façade module kit — bay, pilaster, cornice, parapet, window, shopfront, door — as reusable node groups), **archviz** (real-world scale and façade composition), **materials** (procedural brick, concrete, stone, render, glass — the ported generators), **texture-workflow** (AO/curvature/normal bakes and decals for the motto band and medallions), **uv-workflow** (texel density and modular UV layouts for the kit), **scene-assembly** (assembling kit pieces onto the fifteen block buildings), **lookdev** (screenshot-comparison loop until shading reads correctly), **historical-worlds** or **realistic-style** (1920s Hollywood Blvd neoclassical direction), **asset-optimization** + **unreal-export** (pre-export validation, `ue_metric_v1` preset), **qa-review** (final gate before the `Tools/render_screenshots.sh` review).