Fix figure IK snapping and gate the library on a fail-hard motion checker

Three solver defects made limbs teleport, twist, or windmill: write-back
angles wrapped at ±180 and lerped the long way around; branch flips landed
on configurations the anatomical write-back cannot represent, silently
pulling pinned extremities off their pins; and the degenerate straight-limb
bend plane fell back to the camera axis instead of the anatomical anterior.
solve_limb now verifies each branch reproduces the solved end before
accepting it, resolve unwraps written-back angles toward the pose they
replace, and the degenerate plane comes from the parent's anterior axis.

render.py --check replays every exercise's full tween loop and fails hard
on six invariants (pin fidelity, continuity, wraps, authored-vs-resolved
drift, ground penetration, resolved ROM); --export refuses to ship a
failing exercise. All 66 motions re-authored or retouched to pass: honest
authored angles where pins used to override them silently, grounded feet
on the seated machines, a vertical bench-press bar path, straight-armed
child's pose, a butterfly stretch seated on the mat, and FK arms where
pins forced impossible reaches. MotionSolver.swift mirrors the solver
changes line for line, held by regenerated fixtures.

Claude-Session: https://claude.ai/code/session_01PKptrgbx74peTwHGRxBojv
This commit is contained in:
2026-07-12 00:37:23 -04:00
parent 400601283e
commit 79e75a9127
303 changed files with 3114 additions and 2272 deletions
@@ -11,8 +11,8 @@
<path d="M 78.0 129.0 L 78.0 150.0" stroke="#c5cad4" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 144.0 129.0 L 144.0 150.0" stroke="#c5cad4" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
<g id="arm_l">
<path d="M 70.9 116.1 L 95.0 133.7" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
<path d="M 95.0 133.7 L 98.0 104.3" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
<path d="M 70.9 116.1 L 99.6 124.7" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
<path d="M 99.6 124.7 L 80.0 102.3" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
</g>
<g id="leg_l">
<path d="M 155.9 116.8 L 201.2 108.9" stroke="url(#grad-leg_l-0)" stroke-width="5.06155" stroke-linecap="round"/>
@@ -28,15 +28,15 @@
<path d="M 196.0 148.7 L 206.9 147.6" stroke="url(#grad-leg_r-2)" stroke-width="5.96321" stroke-linecap="round"/>
</g>
<g id="arm_r">
<path d="M 65.0 117.9 L 89.0 135.6" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 89.0 135.6 L 90.0 106.1" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 65.0 117.9 L 94.4 123.8" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 94.4 123.8 L 72.0 104.1" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
</g>
<path d="M 83.0 105.9 L 97.0 106.3" stroke="#6b7180" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
<circle cx="83.0" cy="105.9" r="4.5" fill="#6b7180"/>
<circle cx="97.0" cy="106.3" r="4.5" fill="#6b7180"/>
<path d="M 91.0 103.6 L 105.0 105.0" stroke="#6b7180" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
<circle cx="91.0" cy="103.6" r="4.5" fill="#6b7180"/>
<circle cx="105.0" cy="105.0" r="4.5" fill="#6b7180"/>
<path d="M 67.4 109.4 L 76.6 98.9" stroke="#6b7180" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
<circle cx="67.4" cy="109.4" r="4.5" fill="#6b7180"/>
<circle cx="76.6" cy="98.9" r="4.5" fill="#6b7180"/>
<path d="M 74.7 106.9 L 85.3 97.7" stroke="#6b7180" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
<circle cx="74.7" cy="106.9" r="4.5" fill="#6b7180"/>
<circle cx="85.3" cy="97.7" r="4.5" fill="#6b7180"/>
<circle id="head" cx="45.2" cy="113.3" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="46.6" y1="103.4" x2="47.6" y2="96.5" stroke="#3a3f4b" stroke-width="4" stroke-linecap="round"/>
<g font-family="-apple-system, Helvetica, sans-serif" font-size="11" fill="#6b7180">

Before

Width:  |  Height:  |  Size: 4.1 KiB

After

Width:  |  Height:  |  Size: 4.1 KiB