Release 0.9.5 texture and material refinement

TODO.md

@@ -5,7 +5,7 @@ see `AGENTS.md` for the workflow and `MEMORY.md` for the decisions behind these
 
 ## Gap Analysis and 0.x Roadmap
 
-Baseline: **v0.9.4** (2026-11-02). Three playable venues, tutorial/campaign/checkpoint resume,
+Baseline: **v0.9.5** (2026-11-02). Three playable venues, tutorial/campaign/checkpoint resume,
 difficulty/help, audio/accessibility settings, a 24-NPC budget baseline, a complete
 escalation/access/radio loop, shift review, the Blender asset library, 263 headless + 101 Python
 tests, a 21/21 clean screen-design judge and an optional Forward+ Desktop HQ build. This is a strong
@@ -37,7 +37,7 @@ release-candidate foundation, not yet a 0.10.0 release candidate.
 | Animation/presentation | Procedural pose layers, portrait captures, reduced hem clipping, 8,000/8,000 NPC cap | Thorough NPC silhouette/face/gear/pose/LOD optimization before visual QA | Close-up jank reduces perceived quality | Complete (0.9.4) |
 | Audio/accessibility | Procedural ambience/SFX, volume controls, captions/reduce-motion settings, searchable Help | Full accessibility/localization acceptance review, audio caption coverage and P0/P1 fixes | Public release cannot claim accessible play | 0.10.0 |
 | Localization | English JSON table, validation and input-generated Help | Pseudo-locale/layout audit and translator workflow sign-off | Text expansion/clipping at release | 0.10.0 |
-| Performance/platform | 24-NPC headless budget (6.9 ms), Compatibility/Web/HQ paths | Target hardware matrix, Web/HQ manual profiling, frame-time/memory evidence | Platform-specific drops or startup failures | 0.9.6 / 0.10.0 |
+| Performance/platform | 24-NPC headless budget (6.94 ms), Compatibility/Web/HQ paths | Target hardware matrix, Web/HQ manual profiling, frame-time/memory evidence | Platform-specific drops or startup failures | 0.9.6 / 0.10.0 |
 | Save lifecycle | Settings/campaign/history/checkpoint files, atomic writes | Migration fixtures from 0.8/0.9, fresh-install/upgrade verification, rollback instructions | Player progress loss on upgrade | 0.10.0 |
 | QA/CI | Headless suite, smokes, screenshot compare, 21/21 judge | Release-candidate smoke matrix, final gallery and release dry run | Regressions escape the release gate | 0.9.6 / 0.10.0 |
 | Release/legal | Unsigned desktop/macOS builds, Web/HQ packages | Signing/notarization decision, checksums, AI-asset provenance, credits, privacy/body-camera and rating review | Public release blocked by trust/policy | 0.10.0 |
@@ -45,12 +45,12 @@ release-candidate foundation, not yet a 0.10.0 release candidate.
 | Future 0.x | Stable 0.x feature set | Live replay, more venues, VO/music, image-to-mesh props and seasonal content | Scope creep before release | 0.11.0+ |
 
 **Current priority:** map optimization, the **pre-build NPC revisit**, the
-**0.9.3 UI polish** and **0.9.4 NPC visual optimization** passes are complete
-(all moved to `DONE.md` on 2026-11-02). 0.9.5 texture refinement, 0.9.6
-integration and the 0.10.0 release candidate are queued. The source version is
-now 0.9.4.
+**0.9.3 UI polish**, **0.9.4 NPC visual optimization** and **0.9.5 texture
+refinement** passes are complete (all moved to `DONE.md` on 2026-11-02).
+0.9.6 integration and the 0.10.0 release candidate are queued. The source
+version is now 0.9.5.
 
-## Postponed — Patch 0.9.5 — Texture and material refinement
+## Patch 0.9.5 — Texture and material refinement
 
 Goal: improve close-range surface and character texture quality while keeping GL
 Compatibility/Web parity, deterministic assets and offline CI.
@@ -82,20 +82,36 @@ Compatibility/Web parity, deterministic assets and offline CI.
       skin/hair/gear keep AO. Comparison `sheet_npc_baseline_compare-texuv.jpg`.)
 - [x] Re-bake AO where geometry changes; verify the 256² maps and material wiring.
       (No character geometry changed in the texture pass; asset/base audits pass.)
-- [ ] Audit library props and UI/card/icon textures at their actual screen sizes;
-      remove blurry/oversized or unused textures where safe.
-- [ ] Run texture audits, import, and the full asset test suite; record texture memory
-      and triangle/draw-call impact.
+- [x] Audit library props and UI/card/icon textures at their actual screen sizes;
+      remove blurry/oversized or unused textures where safe. (All 21 screen-art
+      textures are 1280×720 and referenced; access cards are 256×128, HUD icons
+      64×64; no oversized or unused runtime texture found. Legacy root textures
+      remain only as the `generate_textures.py`/asset-test fallback.)
+- [x] Run texture audits, import, and the full asset test suite; record texture memory
+      and triangle/draw-call impact. (Godot 263/263, Python 101/101; asset and base
+      audits pass; 24 NPCs = 168 meshes / 131,616 triangles / 6.94 ms. Compressed
+      payloads: picks 24.55 MB, UI art 22.67 MB, NPC maps 0.48 MB.)
 
 ### Visual verification
 
-- [ ] Run `python3 tools/scene_concepts.py realism` for the affected stages with the
-      judge enabled; record metric gaps and model/spend.
-- [ ] Re-run `tools/check_screenshots.sh` and the screen-design judge; clear all
-      `diff` verdicts.
-- [ ] Capture before/after close-ups for brick, pavement, asphalt, character cloth
-      and skyline; document accepted trade-offs.
-- [ ] Update asset docs and the changelog/status with the promoted texture versions.
+- [x] Run `python3 tools/scene_concepts.py realism` for the affected stages with the
+      judge enabled; record metric gaps and model/spend. (Run
+      `docs/screens/realism/2026-11-02-tex` with `z-ai/glm-5.3-flash`, one pass per
+      shot; mean `after` overall 1.8, lighting 2.3, materials 1.8, texture 1.2,
+      backdrop 2.0, characters 1.2, Pillow gap 0.306. The judge is optional and not
+      a CI gate; the report stays local.)
+- [x] Re-run `tools/check_screenshots.sh` and the screen-design judge; clear all
+      `diff` verdicts. (21 good / 0 bad; `screen_designs.py judge` = 21/21 match,
+      0 review, 0 diff.)
+- [x] Capture before/after close-ups for brick, pavement, asphalt, character cloth
+      and skyline; document accepted trade-offs. (Committed
+      `docs/blender_previews/sheet_texture_refinement_0.9.5.jpg`: Walk of Fame
+      pavers, asphalt aggregate, limestone facade, day skyline haze and NPC cloth;
+      asphalt/limestone picks intentionally held, no replacement.)
+- [x] Update asset docs and the changelog/status with the promoted texture versions.
+      (README/PLAN/architecture/status/MEMORY and the 0.9.5 changelog entry now
+      carry the texture results; the 0.9.5 section moved to `DONE.md` after the
+      release build.)
 
 ## Postponed — Patch 0.9.6 — Integration, performance and judge gate