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,27 +1,27 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Bodyweight Squat</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="164.1" y1="90.9" x2="169.8" y2="122.1"><stop offset="0" stop-color="#49b1a6"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="164.1" y1="90.9" x2="173.4" y2="121.3"><stop offset="0" stop-color="#27a195"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="166.4" y1="122.3" x2="160.0" y2="149.2"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#33a69b"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="160.0" y1="149.2" x2="167.5" y2="150.9"><stop offset="0" stop-color="#33a69b"/><stop offset="1" stop-color="#39aa9e"/></linearGradient>
<linearGradient id="grad-arm_l-0" gradientUnits="userSpaceOnUse" x1="168.3" y1="32.0" x2="169.0" y2="52.7"><stop offset="0" stop-color="#a2a8b3"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="160.0" y1="123.4" x2="160.0" y2="149.2"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#55b7ac"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="160.0" y1="149.2" x2="160.0" y2="152.2"><stop offset="0" stop-color="#55b7ac"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="164.9" y1="54.0" x2="167.4" y2="74.5"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#414652"/></linearGradient>
</defs>
<path d="M 141.8 157.5 L 232.3 157.5 L 232.3 150.2 L 141.8 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 164.1 90.9 L 169.8 122.1" stroke="url(#grad-leg_l-0)" stroke-width="3.67613" stroke-linecap="round"/>
<path d="M 169.8 122.1 L 162.8 148.9" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 162.8 148.9 L 170.3 150.7" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 164.1 90.9 L 173.4 121.3" stroke="url(#grad-leg_l-0)" stroke-width="3.77445" stroke-linecap="round"/>
<path d="M 173.4 121.3 L 162.8 146.8" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 162.8 146.8 L 169.9 149.7" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 160.0 91.3 L 166.4 122.3" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 166.4 122.3 L 160.0 149.2" stroke="url(#grad-leg_r-1)" stroke-width="4.09064" stroke-linecap="round"/>
<path d="M 160.0 149.2 L 167.5 150.9" stroke="url(#grad-leg_r-2)" stroke-width="3.96269" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 168.3 32.0 L 169.0 52.7" stroke="url(#grad-arm_l-0)" stroke-width="3.52319" stroke-linecap="round"/>
<path d="M 169.0 52.7 L 171.6 73.2" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 160.0 91.3 L 160.0 123.4" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 160.0 123.4 L 160.0 149.2" stroke="url(#grad-leg_r-1)" stroke-width="3.99232" stroke-linecap="round"/>
<path d="M 160.0 149.2 L 160.0 152.2" stroke="url(#grad-leg_r-2)" stroke-width="3.99232" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 168.3 32.0 L 164.2 31.9 L 164.2 33.3" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 164.1 90.9 L 160.0 90.4 L 160.0 91.3" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 160.0 90.4 Q 162.1 60.5 164.2 31.9" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round" stroke-linejoin="round"/>

Before

Width:  |  Height:  |  Size: 3.5 KiB

After

Width:  |  Height:  |  Size: 3.5 KiB

@@ -1,14 +1,15 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Bodyweight Squat</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="154.3" y1="120.3" x2="184.4" y2="131.7"><stop offset="0" stop-color="#6cc2b8"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="160.0" y1="149.6" x2="166.9" y2="152.9"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#199a8e"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="154.3" y1="120.3" x2="184.9" y2="130.3"><stop offset="0" stop-color="#6ec3b9"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="180.6" y1="131.0" x2="160.0" y2="149.6"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#0f9589"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="160.0" y1="149.6" x2="166.9" y2="152.9"><stop offset="0" stop-color="#0f9589"/><stop offset="1" stop-color="#1b9b8f"/></linearGradient>
</defs>
<path d="M 141.8 157.9 L 232.3 157.9 L 232.3 150.6 L 141.8 150.6 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 154.3 120.3 L 184.4 131.7" stroke="url(#grad-leg_l-0)" stroke-width="3.57578" stroke-linecap="round"/>
<path d="M 184.4 131.7 L 162.8 149.3" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 162.8 149.3 L 169.6 152.9" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 154.3 120.3 L 184.9 130.3" stroke="url(#grad-leg_l-0)" stroke-width="3.56863" stroke-linecap="round"/>
<path d="M 184.9 130.3 L 162.8 147.2" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 162.8 147.2 L 169.5 151.0" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 182.3 68.1 L 203.3 67.4" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
@@ -16,8 +17,8 @@
</g>
<g id="leg_r">
<path d="M 150.2 120.7 L 180.6 131.0" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 180.6 131.0 L 160.0 149.6" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 160.0 149.6 L 166.9 152.9" stroke="url(#grad-leg_r-2)" stroke-width="4.16575" stroke-linecap="round"/>
<path d="M 180.6 131.0 L 160.0 149.6" stroke="url(#grad-leg_r-1)" stroke-width="4.19339" stroke-linecap="round"/>
<path d="M 160.0 149.6 L 166.9 152.9" stroke="url(#grad-leg_r-2)" stroke-width="4.15199" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 182.3 68.1 L 178.1 68.1 L 178.1 69.4" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 154.3 120.3 L 150.2 119.8 L 150.2 120.7" stroke="#3a3f4b" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>

Before

Width:  |  Height:  |  Size: 2.8 KiB

After

Width:  |  Height:  |  Size: 3.0 KiB