0.1.3 packaging and setup fixes from what 0.1.x actually exposed.
- New Tools/ue_common.py: make_writable() clears the read-only bit an LFS .umap
checks out with (save_map() otherwise returns False silently and the staged actor
is lost) and require_saved() makes that failure visible. ue_hero_facade_import and
ue_import_north_buildings now call it; the map builders already did. Verified from
a forced 0o444 map: chmod logged, save_map True, exit 0.
- Docs/build.md: pipeline table now lists the seven site FBXs plus frontage, north,
hero and map steps and the shared FBX preset; packaging archive corrected to
Builds/GigLineQA; packaged-log location and -qaselftest usage documented; new
'Traps that cost real time in 0.1.x' table (read-only save, hero --out is the FBX,
MPFB add-on path, shot actor quitting under QA, null-RHI trace trap).
- Docs/setup.md: fresh-checkout build marked verified 2026-11-08 and the blocker
closed; new optional-keys section for OPENROUTER_API_KEY and MAPBOX_ACCESS_TOKEN
(gitignored .env, not needed by build/tests/release).
- Docs/Architecture 07 + architecture.md: build-output path corrected, marked
outside the repository.
- 5 new tests for ue_common (54 total).
Drop the OpenStreetMap/ODbL attribution requirement, the Google imagery rule,
and the related F-4 requirement, risk R-4, release check, and TODO items across
AGENTS, PLAN, ROADMAP, README, setup, architecture sections, and manifests.
OSM data is now documented as local private use only. Also normalize
numbered-list indentation in the architecture docs.
PIE — Play In Editor: an Unreal Editor feature that runs the current
map as a live game session inside the editor.
UE — Unreal Engine: Epic Games' real-time 3D creation platform,
comprising the editor (including PIE), C++ framework, and runtime.
- Converted 13 individual .adoc section files to .md via
asciidoctor→docbook5→pandoc(gfm) + post-processing, placed alongside
the .adoc sources in Docs/Architecture/
- Rebuilt architecture.md from the individual section .md files
- Ran prettier --write on all .md in the repo (23 files changed):
normalised table column alignment, trailing whitespace, line breaks
- Added .agents/ to .prettierignore (vendored third-party content)
- All .md now passes prettier --check
architecture.md is the combined 450-line single-page rendering of all 12
arc42 sections. The Asciidoctor source (.adoc) files remain for future
editing; the Markdown is the readable deliverable.
zwitschi