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
@@ -1,36 +1,38 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Barbell Squat</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="134.0" y1="121.7" x2="166.2" y2="122.0"><stop offset="0" stop-color="#7dcbc1"/><stop offset="1" stop-color="#7ecbc1"/></linearGradient>
<linearGradient id="grad-leg_l-1" gradientUnits="userSpaceOnUse" x1="166.2" y1="122.0" x2="162.8" y2="149.3"><stop offset="0" stop-color="#7ecbc1"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="162.1" y1="122.1" x2="160.0" y2="149.6"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#199a8e"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="160.0" y1="149.6" x2="167.3" y2="147.3"><stop offset="0" stop-color="#199a8e"/><stop offset="1" stop-color="#11968a"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="134.0" y1="121.7" x2="166.2" y2="120.6"><stop offset="0" stop-color="#7fccc2"/><stop offset="1" stop-color="#7bcabf"/></linearGradient>
<linearGradient id="grad-leg_l-1" gradientUnits="userSpaceOnUse" x1="166.2" y1="120.6" x2="162.8" y2="147.9"><stop offset="0" stop-color="#7bcabf"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-arm_l-1" gradientUnits="userSpaceOnUse" x1="154.7" y1="82.4" x2="167.4" y2="82.6"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#9da3ae"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="162.1" y1="122.1" x2="160.0" y2="149.6"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#1b9b8f"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="160.0" y1="149.6" x2="167.3" y2="147.3"><stop offset="0" stop-color="#1b9b8f"/><stop offset="1" stop-color="#13978b"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="150.6" y1="87.9" x2="163.3" y2="82.4"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#505561"/></linearGradient>
</defs>
<path d="M 121.5 157.9 L 193.9 157.9 L 193.9 150.6 L 121.5 150.6 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<path d="M 121.5 157.9 L 185.9 157.9 L 185.9 150.6 L 121.5 150.6 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 134.0 121.7 L 166.2 122.0" stroke="url(#grad-leg_l-0)" stroke-width="3.54768" stroke-linecap="round"/>
<path d="M 166.2 122.0 L 162.8 149.3" stroke="url(#grad-leg_l-1)" stroke-width="3.52262" stroke-linecap="round"/>
<path d="M 162.8 149.3 L 170.2 147.4" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 134.0 121.7 L 166.2 120.6" stroke="url(#grad-leg_l-0)" stroke-width="3.55135" stroke-linecap="round"/>
<path d="M 166.2 120.6 L 162.8 147.9" stroke="url(#grad-leg_l-1)" stroke-width="3.53182" stroke-linecap="round"/>
<path d="M 162.8 147.9 L 170.2 146.0" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 166.4 72.1 L 185.5 63.4" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 185.5 63.4 L 164.9 67.5" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 166.4 72.1 L 154.7 82.4" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 154.7 82.4 L 167.4 82.6" stroke="url(#grad-arm_l-1)" stroke-width="3.53667" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 129.9 122.1 L 162.1 122.1" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 162.1 122.1 L 160.0 149.6" stroke="url(#grad-leg_r-1)" stroke-width="4.16451" stroke-linecap="round"/>
<path d="M 160.0 149.6 L 167.3 147.3" stroke="url(#grad-leg_r-2)" stroke-width="4.1536" stroke-linecap="round"/>
<path d="M 162.1 122.1 L 160.0 149.6" stroke="url(#grad-leg_r-1)" stroke-width="4.15899" stroke-linecap="round"/>
<path d="M 160.0 149.6 L 167.3 147.3" stroke="url(#grad-leg_r-2)" stroke-width="4.14256" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 166.4 72.1 L 162.3 72.1 L 162.3 73.4" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 134.0 121.7 L 129.9 121.2 L 129.9 122.1" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 129.9 121.2 Q 148.2 97.2 162.3 72.1" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round" stroke-linejoin="round"/>
<g id="arm_r">
<path d="M 162.3 73.4 L 183.0 70.2" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 183.0 70.2 L 162.1 68.8" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 162.3 73.4 L 150.6 87.9" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 150.6 87.9 L 163.3 82.4" stroke="url(#grad-arm_r-1)" stroke-width="4.13151" stroke-linecap="round"/>
</g>
<path d="M 163.5 65.0 L 163.5 71.3" stroke="#6b7180" stroke-width="2.8" stroke-linecap="round" stroke-linejoin="round"/>
<circle cx="163.5" cy="65.0" r="9.799999999999999" fill="#6b7180"/>
<circle cx="163.5" cy="71.3" r="9.799999999999999" fill="#6b7180"/>
<path d="M 165.3 79.3 L 165.3 85.7" stroke="#6b7180" stroke-width="2.8" stroke-linecap="round" stroke-linejoin="round"/>
<circle cx="165.3" cy="79.3" r="9.799999999999999" fill="#6b7180"/>
<circle cx="165.3" cy="85.7" r="9.799999999999999" fill="#6b7180"/>
<circle id="head" cx="170.5" cy="60.9" r="7.0" fill="white" stroke="#3a3f4b" stroke-width="4.2"/>
<line id="nose" x1="177.5" y1="61.9" x2="182.3" y2="62.6" stroke="#3a3f4b" stroke-width="2.8" stroke-linecap="round"/>
<g font-family="-apple-system, Helvetica, sans-serif" font-size="11" fill="#6b7180">

Before

Width:  |  Height:  |  Size: 3.5 KiB

After

Width:  |  Height:  |  Size: 3.9 KiB