Add MakeHuman head hair/body prototype and 12-variant rollout plan

docs/makehuman-head-review.md

@@ -1,9 +1,12 @@
 # MakeHuman head prototype
 
-Status: **local prototype, rejected by the automated visual gate, not integrated.**
-The asset is a standalone head/neck extracted from the CC0 MakeHuman base in
-`tmp/npc-research/makehuman/base.obj`. It is kept as a reviewable experiment and
-is not part of the shipped NPC contract.
+Status: **owner-accepted head, assembled prototype, not yet shipped.**
+The owner accepted the basic human head on 2026-11-04. The automated vision gate
+still records REJECT on the eye/lid region as deferred polish. The asset is a
+standalone head/neck extracted from the CC0 MakeHuman base in
+`tmp/npc-research/makehuman/base.obj`; the assembled path now adds hair, a hidden
+scalp trim and the procedural body. The 12 shipped GLBs have not been rebuilt
+with it yet.
 
 ## Asset
 
@@ -14,10 +17,12 @@ is not part of the shipped NPC contract.
   components, cuts an almond aperture through a skin eyelid mask, adds recessed
   eyeballs with flat iris/pupil discs, anchors brows to the face surface, renders
   front/three-quarter/profile and exports the standalone GLB.
-- Measurements (final build, `inspect`): **12,641 triangles / 7,690 split
-  vertices**; bounds approximately `x ±0.094 m`, `y -0.180…0.042 m`,
-  `z 1.530…1.803 m` in project Z-up space. It is inside the 16,000/16,000
-  character cap.
+- Measurements (final standalone build, `inspect`): **12,641 triangles / 7,690
+  split vertices**; bounds approximately `x ±0.094 m`, `y -0.180…0.042 m`,
+  `z 1.530…1.803 m` in project Z-up space.
+- Assembled `npc_casual --head mh`: **14,753 triangles / 12,823 seam-split
+  vertices / 14 bones / 9 materials**, `inspect` clean. All 12 variants count
+  14,693–15,987 triangles with the same head.
 - Materials used: `skin`, `eye_white`, `iris`, `pupil`, `hair`. No textures are
   baked into this prototype.
 
@@ -69,8 +74,10 @@ Accept only if:
 
 ## Judge result
 
-**VERDICT: REJECT** (vision judge `z-ai/glm-5.3-flash`, final build render set
-above). The gate is blocked; the prototype is not presented as an accepted head.
+**Owner verdict: ACCEPT (basic human head, 2026-11-04).**
+**Automated vision gate: REJECT** (vision judge `z-ai/glm-5.3-flash`, final
+standalone build render set above). The eye/lid findings below remain deferred
+polish; they are no longer a rollout blocker because the owner accepted the head.
 
 Blocking findings:
 
@@ -96,24 +103,37 @@ Should-fix findings:
 - the catchlight is baked geometry and is not consistent between eyes.
 
 What passed: the skin/eye material remap is correct, the eye openings are
-closed, the standalone GLB reports **12,641 triangles / 7,690 split vertices**
-with no issues, and an assembled `npc_casual` with this head passes `inspect` at
-**15,532 / 16,000 triangles, 13,310 split vertices, 14 bones, no issues**.
+closed, the standalone GLB reports **12,641 triangles / 7,690 split vertices**,
+and an assembled `npc_casual` with this head passes `inspect` at **14,753 /
+16,000 triangles, 12,823 seam-split vertices, 14 bones, no issues**.
 
 Known limits: bald mannequin-like presentation, stylized geometry-only
 iris/pupil, no rig, no UV texture pass, and the neck cap is a review cut rather
 than a body-welded seam.
 
-## Next steps after the gate passes
+## Assembled prototype (2026-11-04)
+
+- `_makehuman_head` imports the GLB and adds a **skull-conforming hair cap**
+  derived from the closed head shell (scaled shell + boolean front-sphere
+  cut + decimate). Hair skips the old `hair_normal.png` because the skull UVs
+  produced large dark tangent patches.
+- Head faces fully covered by the cap are deleted to recover ~950 triangles;
+  boundary faces stay as a safety band, so the accepted face geometry is
+  untouched. The hidden neck plug uses 12 segments.
+- The procedural body was narrowed at the neck and shoulders (chest 0.158,
+  neck base 0.060, neck top 0.054, shoulder root z 1.345) and its skin decimate
+  dropped to 0.21 so all 12 variants fit the 16,000 cap.
+- Local review renders: `tmp/npc-parts/prototype_mh/renders/` (portrait
+  front/three-quarter/profile and full-body front/three-quarter).
+
+## Deferred polish
 
 - Replace the radial lid mask with real upper/lower lid masses that fold over
   the globe, with pointed canthi, and pass the profile view.
 - Move the iris onto a curved cornea cap so its orientation follows the globe at
   three-quarter angles, and use a lighting-driven catchlight instead of baked
   white geometry.
-- Compare against the project `_face` baseline and decide whether this head is
-  the base for the local head/face overhaul.
-- Add a clean UV/material pass and a contract armature/weights if it becomes
-  part of a library character.
-- Keep the source script under `tmp/`; promote only the reviewed GLB and durable
-  docs/preview sheet.
+- Refine the hair cap silhouette (current short cap reads as a helmet) and
+  improve the full-body shoulder/arm shape before the 12-variant rollout.
+- Add a clean UV/material pass and a contract armature/weights when the head
+  becomes part of the shipped library characters.