Verify the 0.9.6 integration checkpoint

CHANGELOG.md

@@ -4,6 +4,15 @@ All notable user-facing changes to Gig Line. The format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions use
 Semantic Versioning.
 
+## [0.9.6] — 2026-11-02
+
+### Changed
+
+- The UI, model and texture passes are now integrated into a verified checkpoint
+  build. The gallery, NPC portraits, realism captures, asset audits, smoke
+  matrix, 24-NPC budget and Web/Desktop HQ packages were regenerated and
+  re-checked; no gameplay or content changes were introduced.
+
 ## [0.9.5] — 2026-11-02
 
 ### Changed

MEMORY.md

@@ -182,7 +182,14 @@ Session memory for durable decisions, state, and gotchas. Keep concise, remove o
 - **Priority change (2026-11-02):** the map optimization, pre-build NPC revisit,
   0.9.3 UI polish, 0.9.4 NPC visual optimization and 0.9.5 texture/material pass
   are complete and in `DONE.md`. 0.9.6 integration and 0.10.0 release work are
-  next. The current source version is 0.9.5.
+  next. The current source version is 0.9.6.
+- **0.9.6 integration (2026-11-03):** no gameplay/content changes. A clean
+  detached worktree at `f5b8ef2` rebuilt Linux/Windows/macOS/Web/HQ without the
+  dirty tree's ignored `tmp/`/`build/` payload; the in-repo build was 1.6–3.1 GB
+  per artifact because those folders were packed, so always build release
+  artifacts from a clean checkout/worktree. Verification: 263/263 tests,
+  101/101 Python, 14 smokes, 24-NPC 6.90 ms / 168 meshes / 131,616 triangles,
+  gallery 21/0, screen judge 21/21, realism judge overall 2.1 / gap 0.291.
 - **Release v0.9.5 (2026-11-02):** commit `4bc6390` tagged `v0.9.5`; Gitea Actions run
   922 passed checks and the full build and published seven assets (Linux, Windows,
   macOS, NSIS setup, AppImage, Web, Desktop HQ). Release page:

PLAN.md

@@ -176,7 +176,7 @@ Primary decisions: [ADR-0007](docs/adr/0007-locomotion-and-input-layers.md), [AD
 
 ## Versioning and Delivery
 
-`config/version` in `project.godot` is the single version source (currently `0.9.5`). Releases are tagged `v<version>`; the CI pipeline builds and publishes the standard artifacts plus the optional Desktop HQ zip. Version bumps follow [Semantic Versioning](https://semver.org/). See [`docs/RELEASING.md`](docs/RELEASING.md) and [`README.md`](README.md) for commands.
+`config/version` in `project.godot` is the single version source (currently `0.9.6`). Releases are tagged `v<version>`; the CI pipeline builds and publishes the standard artifacts plus the optional Desktop HQ zip. Version bumps follow [Semantic Versioning](https://semver.org/). See [`docs/RELEASING.md`](docs/RELEASING.md) and [`README.md`](README.md) for commands.
 
 ## Design Direction
 

README.md

@@ -44,7 +44,7 @@ precision walk, the Joke Shop's Sunset Strip frontage, the TV Studio arrival, an
 > on top of the v0.9.4 NPC visual optimization, the Hollywood/Joke Shop maps and
 > the v0.9.3 UI/accessibility polish.
 >
-> **Current source: v0.9.5** — tagged and built from the same commit.
+> **Current source: v0.9.6** — tagged and built from the same commit.
 > Releases are built automatically when a `vX.Y.Z` tag is pushed
 > (see [`docs/RELEASING.md`](docs/RELEASING.md)); manual builds use
 > `./tools/build_releases.sh`. Installer/AppImage packaging runs in the same pipeline
@@ -129,8 +129,8 @@ Full setup, every run/test/smoke command, and the controls table are in
 
 ## Development Status
 
-v0.9.5 is the current source version: the completed texture and material
+v0.9.6 is the current source version: the integrated texture/material and UI
-refinement (256² NPC maps, a 4× fabric weave with baked-AO removal, repaired
+checkpoint on top of the 0.9.5 texture refinement (256² NPC maps, a 4× fabric weave with baked-AO removal, repaired
 Walk of Fame/awning surfaces and per-phase skyline haze), on top of the v0.9.4
 NPC visual optimization and the v0.9.3 UI/accessibility polish pass. It builds on
 v0.9.2's Hollywood/Joke Shop map rebuilds, v0.9.1's Godot 4.7.2 baseline,

TODO.md

@@ -50,40 +50,66 @@ 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 next. The source version
 is now 0.9.5; the v0.9.5 release is published.
 
-## Postponed — Patch 0.9.6 — Integration, performance and judge gate
+## Patch 0.9.6 — Integration, performance and judge gate
 
 Goal: integrate the UI/model/texture patches, prove the combined build on the
 target paths and leave a clean release-candidate handoff.
 
 ### Integration and asset rebuild
 
-- [ ] Rebuild all changed Blender/GLB/AO assets, re-import, and verify manifest/fit/
+- [x] Rebuild all changed Blender/GLB/AO assets, re-import, and verify manifest/fit/
-      audit coverage.
+      audit coverage. (The v0.9.5 commit already rebuilt the base, eight characters,
-- [ ] Run the complete headless suite, Python tooling and smoke matrix; fix any
+      gear and AO maps; this checkpoint re-imported them and re-ran
-      regression from the three polish patches.
+      `blender_assets.py audit`/`fit` and `npc_pipeline.py audit`, all exit 0.)
-- [ ] Re-run the 24-NPC budget smoke and record frame time, mesh count and any
+- [x] Run the complete headless suite, Python tooling and smoke matrix; fix any
-      texture-memory change; check Web and Desktop HQ if available.
+      regression from the three polish patches. (Godot 263/263, Python 101/101;
-- [ ] Verify save/campaign/tutorial behavior is unchanged by the visual/UI patches.
+      14 smokes green: audio, campaign, crowd, emergency, focus/radial, movement,
+      NPC budget, PLAN verbs, props, scenario content, session shell, timeline,
+      tutorial and UI flows. Campaign/tutorial used isolated `XDG_DATA_HOME`.)
+- [x] Re-run the 24-NPC budget smoke and record frame time, mesh count and any
+      texture-memory change; check Web and Desktop HQ if available. (24 avatars,
+      168 meshes, 131,616 triangles, 6.90 ms of 50 ms headless; NPC maps remain
+      0.48 MB. A clean detached worktree at `f5b8ef2` built Linux/Windows/macOS/
+      Web/HQ (`161.5/197.1/148.0/97.8/241.5 MB`); the Web zip has index.html,
+      wasm and pck, the HQ zip has `override.cfg`, and the HQ binary launches
+      headless with the Forward+ override.)
+- [x] Verify save/campaign/tutorial behavior is unchanged by the visual/UI patches.
+      (Persistence/session tests remain in the 263-test suite; campaign and tutorial
+      smokes passed with isolated `XDG_DATA_HOME`.)
 
 ### Visual gallery and judge gate
 
-- [ ] Recapture the full gallery, portraits, venue/realsim stages and Desktop HQ A/B
+- [x] Recapture the full gallery, portraits, venue/realsim stages and Desktop HQ A/B
-      as needed; no stale screenshots in the release set.
+      as needed; no stale screenshots in the release set. (Gallery 21/21,
-- [ ] Run `tools/check_screenshots.sh`, `screen_designs.py compare` and
+      NPC baseline 48 frames, final-context review 96 frames and a fresh 10-shot
-      `screen_designs.py judge` on the final captures.
+      realism run were recaptured. No Forward+ code changed since 0.7.1, so the
-- [ ] Run the realism judge for the affected concepts with a pinned model; record
+      HQ A/B was not re-staged; the HQ artifact is checked with the release build.)
-      model, attempt count, spend and verdicts.
+- [x] Run `tools/check_screenshots.sh`, `screen_designs.py compare` and
-- [ ] Review all `review` verdicts manually; convert unexplained layout/composition
+      `screen_designs.py judge` on the final captures. (21 good / 0 bad; compare
-      mismatches into fixes or explicit known limitations.
+      21 good / 0 bad; judge 21/21 match, 0 review, 0 diff.)
-- [ ] Ensure generated realism folders remain gitignored/local-only and only the
+- [x] Run the realism judge for the affected concepts with a pinned model; record
-      durable report decisions/docs are committed.
+      model, attempt count, spend and verdicts. (`z-ai/glm-5.3-flash`, 1 pass per
+      shot, 10 shots, no fallback/retry: mean overall 2.1, lighting 2.4, materials
+      2.1, texture 1.7, backdrop 2.3, characters 1.8, Pillow gap 0.291. The local
+      tool does not expose token spend; the report is gitignored under
+      `docs/screens/realism/2026-11-02-096/`.)
+- [x] Review all `review` verdicts manually; convert unexplained layout/composition
+      mismatches into fixes or explicit known limitations. (Screen judge has 0
+      `review` verdicts; the remaining realism comments are the known stylized
+      gaps already documented, not layout regressions.)
+- [x] Ensure generated realism folders remain gitignored/local-only and only the
+      durable report decisions/docs are committed. (`docs/screens/realism/` stays
+      ignored; `git status` shows no generated capture files.)
 
 ### Release-candidate handoff
 
-- [ ] Update README, architecture, development status, changelog and TODO with the
+- [x] Update README, architecture, development status, changelog and TODO with the
-      final patch-level results and any remaining gaps.
+      final patch-level results and any remaining gaps. (README/PLAN/architecture
-- [ ] Tag/version or otherwise freeze `0.9.6` as the integration checkpoint before
+      now point at 0.9.6; the changelog and development status record the
-      the `0.10.0` release candidate.
+      integration build, performance numbers, judge results and the clean-worktree
+      export rule; `docs/RELEASING.md` documents the ignored-folder trap.)
+- [-] Tag/version or otherwise freeze `0.9.6` as the integration checkpoint before
+      the `0.10.0` release candidate. (claimed; committing and tagging)
 - [ ] Exit: combined build is functionally green, visually reviewed, performance
       measured and ready for the 0.10.0 content-lock/playtest phase.
 

docs/RELEASING.md

@@ -103,6 +103,11 @@ The optional Desktop HQ zip is assembled by `tools/build_releases.sh` from
 `packaging/desktop_hq/`; keep `override.cfg` next to the extracted executable.
 It is not part of the default Compatibility/Web build.
 
+Always run the release build from a clean checkout or detached worktree. Godot
+can pack files from ignored `tmp/` and old `build/` folders into the PCK; the
+0.9.6 dirty-tree build produced 1.6–3.1 GB artifacts, while the clean worktree
+produced the expected ~160–240 MB packages.
+
 Locally you can build the AppImage with `bash packaging/linux/build_appimage.sh <version>`;
 the NSIS installer requires `makensis` (covered by CI).
 

docs/architecture.md

@@ -37,7 +37,7 @@ This document follows the structure of the arc42 architecture documentation temp
 - **MINOR** — new venues, NPC archetypes, systems, or features that are backward compatible.
 - **PATCH** — bug fixes and small polish that do not change behavior.
 
-The single source of truth for the version is `config/version` in `project.godot` (currently `0.9.5`). Each release is tagged in git as `v<version>` (e.g. `v0.6.0`). The `0.x` series is pre-stable, so MINOR bumps may introduce breaking changes while the prototype is still stabilizing. `tools/build_releases.sh` and `tools/publish_release.sh` read the version from `project.godot`, so bumping it there is the only required step before a release. The full bump checklist lives in [`RELEASING.md`](RELEASING.md).
+The single source of truth for the version is `config/version` in `project.godot` (currently `0.9.6`). Each release is tagged in git as `v<version>` (e.g. `v0.6.0`). The `0.x` series is pre-stable, so MINOR bumps may introduce breaking changes while the prototype is still stabilizing. `tools/build_releases.sh` and `tools/publish_release.sh` read the version from `project.godot`, so bumping it there is the only required step before a release. The full bump checklist lives in [`RELEASING.md`](RELEASING.md).
 
 ## 3. Context and Scope
 

docs/asset-tooling.md

@@ -268,6 +268,19 @@ photoreal renderer. The 0.9.5 before/after close-up sheet is
 the texture-adoption run itself was the earlier 0.8-style candidate comparison,
 and its report remains local/gitignored.
 
+For the 0.9.6 integration checkpoint the same judge was pinned to
+`z-ai/glm-5.3-flash` and run once per shot on the 10-shot set: mean overall 2.1,
+lighting 2.4, materials 2.1, texture 1.7, backdrop 2.3, characters 1.8, Pillow
+gap 0.291. No `review` verdicts were produced by the screen judge, so there was
+no manual layout verdict to convert into a fix; the remaining realism comments
+are the accepted stylized gaps.
+
+Build release artifacts from a clean checkout or detached worktree. A normal
+working tree may contain ignored `tmp/` captures and old `build/` artifacts, and
+Godot can pack enough of those into exports to inflate a 0.9.6 package from
+~160 MB to 1.6–3.1 GB. The 0.9.6 clean worktree produced 161.5 MB Linux,
+197.1 MB Windows, 148.0 MB macOS, 97.8 MB Web and 241.5 MB Desktop HQ.
+
 The Forward+ A/B compared the Compatibility entrance with the optional Desktop HQ
 preset. The gear-fit run checked the sunglasses, bag and helmet against measured
 head/skirt bounds with `python3 tools/blender_assets.py fit`; it also fixed the

docs/development-status.md

@@ -42,6 +42,7 @@ Implemented so far:
 - NPC neck/shoulder transition (0.9.4 work): the body graph now uses a fuller neck base, a slightly tapered neck top and a lower shoulder root, giving the head/neck/shoulder line a trapezius slope instead of a thin post. The full character library was rebuilt with a final degenerate-face cleanup; the baseline comparison is `sheet_npc_baseline_compare-body.jpg`.
 - NPC face-depth pass (0.9.4 work): sclera are recessed and capped by a thin upper lid, and the separate jaw/cheek spheres are replaced by a chin plate and cheekbones sculpted into the head mesh. The full library was rebuilt; the comparison is `sheet_npc_baseline_compare-face.jpg`.
 - NPC torso/hip transition (0.9.4 work): the pelvis and chest are slightly wider than the waist, giving shirts and jackets a readable taper into the hips without changing the build multipliers or the skeleton. The comparison is `sheet_npc_baseline_compare-torso.jpg`.
+- Integration checkpoint (0.9.6 work): the clean worktree at `f5b8ef2` rebuilt all five release packages and the Desktop HQ zip without ignored `tmp/`/`build/` content (Linux 161.5 MB, Windows 197.1 MB, macOS 148.0 MB, Web 97.8 MB, HQ 241.5 MB). The Web zip contains `index.html`, `index.wasm` and `index.pck`; the HQ zip contains `override.cfg` and launches headless with the Forward+ override. Current verification: Godot 263/263, Python 101/101, 14 smokes green, 24-NPC budget 6.90 ms / 168 meshes / 131,616 triangles, gallery 21 good / 0 bad, screen judge 21/21 match with 0 review/diff, and a pinned realism judge (`z-ai/glm-5.3-flash`, one pass per shot) at mean overall 2.1 and Pillow gap 0.291. No new gameplay or content changes.
 - Release v0.9.5 (2026-11-02): the tagged commit `4bc6390` passed Gitea Actions run 922 (checks + full build) and published seven artifacts (Linux, Windows, macOS, NSIS setup, AppImage, Web and Desktop HQ). Release page: <https://git.allucanget.biz/zwitschi/security-game/releases/tag/v0.9.5>.
 - Release v0.9.4 (2026-11-02): the tagged commit `a57b86c` passed the Gitea checks and full build and published seven artifacts (Linux, Windows, macOS, NSIS setup, AppImage, Web and Desktop HQ). Release page: <https://git.allucanget.biz/zwitschi/security-game/releases/tag/v0.9.4>.
 - Environment texture pass (0.9.5 work): `capture_realism.gd` now has hidden-HUD `surfaces`/`surfaces_joke` close-up stages. The Walk of Fame band uses the paver texture as dark terrazzo, the neighbour awning keeps its cream stripe, and the skyline shader blends its lower 42 m toward a per-phase haze colour. Brick, asphalt, limestone and paver UV scales/profiles passed without replacement.

project.godot

@@ -12,7 +12,7 @@ config_version=5
 
 config/name="Gig Line"
 config/description="Workplace security simulation about observation, access verification, and proportionate escalation."
-config/version="0.9.5"
+config/version="0.9.6"
 run/main_scene="res://scenes/main.tscn"
 config/features=PackedStringArray("4.7", "GL Compatibility")