Move hand gear forward into the palm

docs/blender_previews/README.md

@@ -50,6 +50,7 @@ Committed contact sheets and local Blender renders for the character, gear and p
 | <img src="sheet_npc_baseline_compare-torso.jpg" width="280" alt="sheet_npc_baseline_compare-torso.jpg"> | [`sheet_npc_baseline_compare-torso.jpg`](sheet_npc_baseline_compare-torso.jpg) |
 | <img src="sheet_npc_baseline_compare-face-detail.jpg" width="280" alt="sheet_npc_baseline_compare-face-detail.jpg"> | [`sheet_npc_baseline_compare-face-detail.jpg`](sheet_npc_baseline_compare-face-detail.jpg) |
 | <img src="sheet_npc_hands_compare.jpg" width="280" alt="sheet_npc_hands_compare.jpg"> | [`sheet_npc_hands_compare.jpg`](sheet_npc_hands_compare.jpg) |
+| <img src="sheet_npc_hands_grip_compare.jpg" width="280" alt="sheet_npc_hands_grip_compare.jpg"> | [`sheet_npc_hands_grip_compare.jpg`](sheet_npc_hands_grip_compare.jpg) |
 | <img src="sheet_npc_gear.jpg" width="280" alt="sheet_npc_gear.jpg"> | [`sheet_npc_gear.jpg`](sheet_npc_gear.jpg) |
 | <img src="sheet_props.jpg" width="280" alt="sheet_props.jpg"> | [`sheet_props.jpg`](sheet_props.jpg) |
 | <img src="shoulder_bag.png" width="280" alt="shoulder_bag.png"> | [`shoulder_bag.png`](shoulder_bag.png) |

docs/development-status.md

@@ -45,6 +45,7 @@ Implemented so far:
 - NPC mesh budget (0.9.4 work): the eight library variants now have an 8,000-triangle / 8,000-glTF-vertex cap (up from 6,000/5,000); the `npc_base` fallback remains 6,000/4,000. Current characters measure 4,226–5,218 triangles and 4,119–5,240 vertices.
 - NPC face-detail pass (0.9.4 work): ala wings and a smaller nose bridge/tip, one rounded mouth slot, and a darker ear concha; all eight rebuilt. The comparison is `sheet_npc_baseline_compare-face-detail.jpg`.
 - NPC headgear clearance (0.9.4 work): the 96-frame final-context review after the face-detail pass confirms the cap, firefighter helmet, hood and sunglasses clear the refined brow and eyes; no gear rebuild was needed.
+- NPC hand-item grip (0.9.4 work): runtime `HAND_ITEM_FORWARD` moves every hand gear 4 cm forward from the wrist proxy, so phone, cup, clipboard, camera, flashlight, wand and radio sit in the open palm instead of partly inside it. Finger curl/thumb contact remains open; the comparison is `sheet_npc_hands_grip_compare.jpg`.
 - NPC hand pass (0.9.4 work): wider, shallower palms; four two-segment bent fingers with rounded tips and a separate bent thumb; optional `--view=hand` capture at 0.80 m. The hand comparison is `sheet_npc_hands_compare.jpg`; item grip offsets remain open.
 - NPC proportion audit (0.9.4 work): `tools/npc_proportions.py` measures all eight GLBs against a stylized height/head/shoulder/hip/torso/leg/arm/foot guide. All variants pass; the head and broad-build silhouettes are the nearest upper bounds. Results are in [`npc-proportion-audit.md`](npc-proportion-audit.md).
 - NPC P1 portrait fixes (0.9.4 work): tourists now hide their photo-pose camera bag outside `photo`/`film` poses, removing the duplicate-backpack silhouette; the backpack gear was rebuilt with flattened, forward chest straps and a fresh AO map. The before/after sheet is [`blender_previews/sheet_npc_baseline_compare-p1.jpg`](blender_previews/sheet_npc_baseline_compare-p1.jpg); the face and remaining clothing/hand work stay open.

docs/npc-visual-review.md

@@ -9,8 +9,9 @@ Comparison sheets:
 [`sheet_npc_baseline_compare-body.jpg`](blender_previews/sheet_npc_baseline_compare-body.jpg)
 the latest [`sheet_npc_baseline_compare-torso.jpg`](blender_previews/sheet_npc_baseline_compare-torso.jpg),
 the face-detail pass [`sheet_npc_baseline_compare-face-detail.jpg`](blender_previews/sheet_npc_baseline_compare-face-detail.jpg),
-and the conversation-distance hand pass
-[`sheet_npc_hands_compare.jpg`](blender_previews/sheet_npc_hands_compare.jpg).
+the conversation-distance hand pass
+[`sheet_npc_hands_compare.jpg`](blender_previews/sheet_npc_hands_compare.jpg), and the
+forward-grip pass [`sheet_npc_hands_grip_compare.jpg`](blender_previews/sheet_npc_hands_grip_compare.jpg).
 
 ## What was captured
 
@@ -156,12 +157,14 @@ The refit backpack measures 380 triangles / 406 vertices.
 
 ### P2 — fix after the first P1 pass
 
-4. **Hands: first pass fixed 2026-11-02; grip alignment still open.** The palm
-   is wider and shallower, and each finger is now a two-segment bent tube with a
-   rounded tip and a separate bent thumb. The hand capture shows a readable
-   four-finger hand instead of flat bars. The camera, phone, cup, clipboard and
-   sign still need their attach offsets checked: several props occlude the palm
-   or read as floating beside it.
+4. **Hands: geometry and forward offset fixed 2026-11-02; finger curl still
+   open.** The palm is wider and shallower, and each finger is now a
+   two-segment bent tube with a rounded tip and a separate bent thumb. Hand gear
+   is authored around the wrist proxy, so the runtime now moves every hand item
+   `HAND_ITEM_FORWARD` (4 cm) into the open palm; the phone, flashlight, camera,
+   cup and clipboard are no longer buried inside the hand. The fingers are still
+   open, so a true wrap/thumb contact and the umbrella/sign grips remain to be
+   judged.
 5. **Clothing detail is tile-driven and transitional seams are visible.** The
    fabric pattern repeats strongly on the casual, coat and dress variants, and
    collar/cuff/waist edges are abrupt. This is more visible than the shoe/hem
@@ -210,14 +213,16 @@ The committed runs are
 and [`sheet_npc_baseline_compare-face.jpg`](blender_previews/sheet_npc_baseline_compare-face.jpg).
 The transition pass is [`sheet_npc_baseline_compare-torso.jpg`](blender_previews/sheet_npc_baseline_compare-torso.jpg).
 The face-detail pass is [`sheet_npc_baseline_compare-face-detail.jpg`](blender_previews/sheet_npc_baseline_compare-face-detail.jpg).
-The hand pass is [`sheet_npc_hands_compare.jpg`](blender_previews/sheet_npc_hands_compare.jpg).
+The hand pass is [`sheet_npc_hands_compare.jpg`](blender_previews/sheet_npc_hands_compare.jpg);
+the forward-grip pass is
+[`sheet_npc_hands_grip_compare.jpg`](blender_previews/sheet_npc_hands_grip_compare.jpg).
 Keep the baseline sheet as the before artifact and add a new comparison sheet
 rather than replacing it.
 
 ## Next implementation order
 
-1. Fix hand-item grip offsets (phone, cup, clipboard, camera, sign, flashlight,
-   wand and radio) against the new palm/finger geometry.
+1. Add finger curl/thumb contact for the hand items and judge the umbrella/sign
+   grips; the forward offset is already in place.
 2. Add the remaining body-shape variation between variants and re-measure the
    LOD/impostor silhouettes.
 3. Audit hems and footwear in walk/sit/block poses.