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,31 +1,26 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Dumbbell Row</title>
<defs>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="173.9" y1="82.8" x2="161.2" y2="126.3"><stop offset="0" stop-color="#747985"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-arm_r-0" gradientUnits="userSpaceOnUse" x1="90.2" y1="67.5" x2="102.1" y2="94.6"><stop offset="0" stop-color="#82cdc3"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="173.9" y1="82.8" x2="211.1" y2="109.4"><stop offset="0" stop-color="#9ca2ad"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="211.1" y1="109.4" x2="241.6" y2="83.9"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#9fa5b0"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="241.6" y1="83.9" x2="247.2" y2="93.2"><stop offset="0" stop-color="#9fa5b0"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="168.0" y1="83.2" x2="162.4" y2="128.2"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#4e535f"/></linearGradient>
<linearGradient id="grad-leg_l-1" gradientUnits="userSpaceOnUse" x1="162.4" y1="128.2" x2="202.0" y2="122.6"><stop offset="0" stop-color="#4e535f"/><stop offset="1" stop-color="#414652"/></linearGradient>
<linearGradient id="grad-leg_l-2" gradientUnits="userSpaceOnUse" x1="202.0" y1="122.6" x2="211.3" y2="128.3"><stop offset="0" stop-color="#414652"/><stop offset="1" stop-color="#4e535f"/></linearGradient>
</defs>
<path d="M 42.3 160.1 L 259.2 160.1 L 259.2 149.7 L 42.3 149.7 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 42.3 160.1 L 223.3 160.1 L 223.3 149.7 L 42.3 149.7 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 100.0 124.0 L 215.0 124.0 L 215.0 124.0 L 100.0 124.0 Z" fill="#c5cad4" stroke="#c5cad4" stroke-width="9" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 118.0 129.0 L 118.0 150.0" stroke="#c5cad4" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 196.0 129.0 L 196.0 150.0" stroke="#c5cad4" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
<g id="leg_r">
<path d="M 173.9 82.8 L 161.2 126.3" stroke="url(#grad-leg_r-0)" stroke-width="5.23913" stroke-linecap="round"/>
<path d="M 161.2 126.3 L 196.0 145.8" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 196.0 145.8 L 186.5 151.3" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<g id="arm_r">
<path d="M 90.2 67.5 L 102.1 94.6" stroke="url(#grad-arm_r-0)" stroke-width="5.01819" stroke-linecap="round"/>
<path d="M 102.1 94.6 L 92.0 122.5" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 173.9 82.8 L 211.1 109.4" stroke="url(#grad-leg_r-0)" stroke-width="5.05663" stroke-linecap="round"/>
<path d="M 211.1 109.4 L 241.6 83.9" stroke="url(#grad-leg_r-1)" stroke-width="5.04492" stroke-linecap="round"/>
<path d="M 241.6 83.9 L 247.2 93.2" stroke="url(#grad-leg_r-2)" stroke-width="5.04492" stroke-linecap="round"/>
</g>
<g id="leg_l">
<path d="M 168.0 83.2 L 162.4 128.2" stroke="url(#grad-leg_l-0)" stroke-width="5.91075" stroke-linecap="round"/>
<path d="M 162.4 128.2 L 202.0 122.6" stroke="url(#grad-leg_l-1)" stroke-width="5.88088" stroke-linecap="round"/>
<path d="M 202.0 122.6 L 211.3 128.3" stroke="url(#grad-leg_l-2)" stroke-width="5.87931" stroke-linecap="round"/>
<path d="M 168.0 83.2 L 162.4 128.2" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 162.4 128.2 L 202.0 122.6" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 202.0 122.6 L 211.3 128.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 84.3 69.4 L 84.3 67.5 L 90.2 67.5" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 168.0 83.2 L 168.0 82.0 L 173.9 82.8" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>

Before

Width:  |  Height:  |  Size: 4.5 KiB

After

Width:  |  Height:  |  Size: 3.4 KiB