feat(0129-ArmHandLandmarkSpecsCaptureCompare): arm/hand capture compare soft bi/tri

[Ryan-AI-Studios]

Summary

Track 0129 — arm/hand form-read landmark capture, compare, and soft placement.

• Frozen v1 ids (humeral_head, bi/tri belly, olecranon, fa_belly, palm_center, thumb CMC/tip, MCP index/pinky)
• arm_hand_metrics sidecar + blockout-arm-hand-compare CLI
• MCP mesh_proportion_blockout_arm_hand_compare — catalog 52 → 53
• Soft consume: measured bi_belly_* / tri_belly_* Y/Z after _apply_arm_muscle_softs (before breast)
• Capsule _delta_mm role-mapped p0/p1/midpoint (B39); Y/Z-only soft_adjust (B36/B40)
• Report stay 1.2.0; recipe stay 1.4.0; no remake/D7 (Package A lacks new ids)

Honesty

ARM_HAND_COMPARE_HONESTY — authoring QA only; not mesh or print success (Difficulty §12 / N6).

Verification

• ledgerful verify PASS (ruff / format / basedpyright / pytest)
• Codex R2 PASS WITH DEFERRED P3 (local wording only; fixed)

Out of scope

Pose/Hand-as-law; DEPTH_PAIRS arm; HAVE-id consume; humeral_head→delt; FA/finger/palm scale; session shoulder_ball emit; leftover #129 → 0135.

---

Note

Medium Risk
Touches recipe emit and 3D fuse for new landmarks, but is authoring-QA only with fail-closed dumps and no mesh/print path changes.

Overview
Adds track 0129 arm/hand form-read: new landmark ids, photo-vs-RECIPE compare, and measured bicep/triceps Y/Z overlay. Authoring QA only (ARM_HAND_COMPARE_HONESTY); report stays 1.2.0 and recipe 1.4.0.

New blockout-arm-hand-compare CLI/MCP tool (catalog 52 → 53) writes arm_hand_compare.json plus an arm_hand_metrics sidecar. Compare uses role-mapped capsule endpoints (p0/p1/midpoint) and only soft_adjusts bi/tri belly on Y/Z deltas.

Fuse/templates now carry the frozen v1 ids (humeral head, bi/tri belly, olecranon, FA belly, palm, thumb, MCP). Recipe emit overlays measured bi_belly_* / tri_belly_* Y/Z after _apply_arm_muscle_softs; other arm knobs stay hold-priors.

^{Reviewed by Cursor Bugbot for commit 170b569. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 170b569. Configure here.}

[cursor]

Past metrics ignore full UA chain

Medium Severity

bicep_front_past_m and triceps_rear_past_m take shaft Y from the midpoint of RECIPE_limb_upper_arm_* alone via _capsule_mid_y_r. Muscle placement in _apply_arm_muscle_softs uses the full-chain mid from _ua_shaft_metrics (limb.p0 → arm_taper_dist_ua.p1 at BICEP_ALONG_T / TRICEP_ALONG_T). On hanging arms those Ys differ, so the sidecar past values and bi_front_past / tri_rear_past form-read flags drift from the 0063 past they are meant to check. ua_dist is already loaded in build_arm_hand_metrics but unused for this mid.

Additional Locations (1)

• src/meshops/proportion/arm_hand_compare.py#L406-L431

 

^{Reviewed by Cursor Bugbot for commit 170b569. Configure here.}