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,9 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Overhead Triceps Stretch</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="166.6" y1="88.2" x2="169.0" y2="121.2"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="158.1" y1="121.4" x2="158.7" y2="149.9"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#9da3ae"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="158.7" y1="149.9" x2="164.9" y2="150.9"><stop offset="0" stop-color="#9da3ae"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="166.6" y1="88.2" x2="167.8" y2="121.6"><stop offset="0" stop-color="#484d59"/><stop offset="1" stop-color="#8c919d"/></linearGradient>
<linearGradient id="grad-leg_l-1" gradientUnits="userSpaceOnUse" x1="167.8" y1="121.6" x2="161.5" y2="148.8"><stop offset="0" stop-color="#8c919d"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="158.1" y1="121.5" x2="158.5" y2="150.1"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#a3a9b4"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="158.5" y1="150.1" x2="164.7" y2="151.0"><stop offset="0" stop-color="#a3a9b4"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-arm_l-0" gradientUnits="userSpaceOnUse" x1="170.1" y1="27.0" x2="184.7" y2="15.4"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#9399a4"/></linearGradient>
<linearGradient id="grad-arm_l-1" gradientUnits="userSpaceOnUse" x1="184.7" y1="15.4" x2="188.1" y2="-5.8"><stop offset="0" stop-color="#9399a4"/><stop offset="1" stop-color="#505561"/></linearGradient>
<linearGradient id="grad-arm_r-0" gradientUnits="userSpaceOnUse" x1="156.5" y1="28.0" x2="164.5" y2="13.5"><stop offset="0" stop-color="#64beb4"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
@@ -11,14 +12,14 @@
</defs>
<path d="M 131.9 154.8 L 174.1 160.9 L 202.3 155.1 L 160.0 148.9 Z" fill="none" stroke="#b9bec9" stroke-width="2.19" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 166.6 88.2 L 169.0 121.2" stroke="url(#grad-leg_l-0)" stroke-width="4.015" stroke-linecap="round"/>
<path d="M 169.0 121.2 L 161.5 148.8" stroke="#a9afba" stroke-width="3.65" stroke-linecap="round"/>
<path d="M 161.5 148.8 L 169.1 151.0" stroke="#a9afba" stroke-width="3.65" stroke-linecap="round"/>
<path d="M 166.6 88.2 L 167.8 121.6" stroke="url(#grad-leg_l-0)" stroke-width="4.06721" stroke-linecap="round"/>
<path d="M 167.8 121.6 L 161.5 148.8" stroke="url(#grad-leg_l-1)" stroke-width="3.74678" stroke-linecap="round"/>
<path d="M 161.5 148.8 L 167.4 151.6" stroke="#a9afba" stroke-width="3.65" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 156.7 88.4 L 158.1 121.4" stroke="#3a3f4b" stroke-width="4.38" stroke-linecap="round"/>
<path d="M 158.1 121.4 L 158.7 149.9" stroke="url(#grad-leg_r-1)" stroke-width="4.05287" stroke-linecap="round"/>
<path d="M 158.7 149.9 L 164.9 150.9" stroke="url(#grad-leg_r-2)" stroke-width="4.05287" stroke-linecap="round"/>
<path d="M 156.7 88.4 L 158.1 121.5" stroke="#3a3f4b" stroke-width="4.38" stroke-linecap="round"/>
<path d="M 158.1 121.5 L 158.5 150.1" stroke="url(#grad-leg_r-1)" stroke-width="4.03337" stroke-linecap="round"/>
<path d="M 158.5 150.1 L 164.7 151.0" stroke="url(#grad-leg_r-2)" stroke-width="4.03337" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 170.1 27.0 L 161.7 26.9 L 156.5 28.0" stroke="#3a3f4b" stroke-width="3.65" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 166.6 88.2 L 160.0 87.8 L 156.7 88.4" stroke="#3a3f4b" stroke-width="3.65" stroke-linecap="round" stroke-linejoin="round"/>

Before

Width:  |  Height:  |  Size: 3.9 KiB

After

Width:  |  Height:  |  Size: 4.1 KiB

@@ -1,23 +1,24 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Overhead Triceps Stretch</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="166.6" y1="88.2" x2="169.0" y2="121.2"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="158.1" y1="121.4" x2="158.7" y2="149.9"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#9da3ae"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="158.7" y1="149.9" x2="164.9" y2="150.9"><stop offset="0" stop-color="#9da3ae"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="166.6" y1="88.2" x2="167.8" y2="121.6"><stop offset="0" stop-color="#484d59"/><stop offset="1" stop-color="#8c919d"/></linearGradient>
<linearGradient id="grad-leg_l-1" gradientUnits="userSpaceOnUse" x1="167.8" y1="121.6" x2="161.5" y2="148.8"><stop offset="0" stop-color="#8c919d"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="158.1" y1="121.5" x2="158.5" y2="150.1"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#a3a9b4"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="158.5" y1="150.1" x2="164.7" y2="151.0"><stop offset="0" stop-color="#a3a9b4"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-arm_l-0" gradientUnits="userSpaceOnUse" x1="175.2" y1="27.8" x2="181.5" y2="8.3"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#6c717d"/></linearGradient>
<linearGradient id="grad-arm_l-1" gradientUnits="userSpaceOnUse" x1="181.5" y1="8.3" x2="162.9" y2="2.0"><stop offset="0" stop-color="#6c717d"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="164.6" y1="5.3" x2="154.1" y2="20.2"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#53b6ab"/></linearGradient>
</defs>
<path d="M 131.9 154.8 L 174.1 160.9 L 202.3 155.1 L 160.0 148.9 Z" fill="none" stroke="#b9bec9" stroke-width="2.19" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 166.6 88.2 L 169.0 121.2" stroke="url(#grad-leg_l-0)" stroke-width="4.015" stroke-linecap="round"/>
<path d="M 169.0 121.2 L 161.5 148.8" stroke="#a9afba" stroke-width="3.65" stroke-linecap="round"/>
<path d="M 161.5 148.8 L 169.1 151.0" stroke="#a9afba" stroke-width="3.65" stroke-linecap="round"/>
<path d="M 166.6 88.2 L 167.8 121.6" stroke="url(#grad-leg_l-0)" stroke-width="4.06721" stroke-linecap="round"/>
<path d="M 167.8 121.6 L 161.5 148.8" stroke="url(#grad-leg_l-1)" stroke-width="3.74678" stroke-linecap="round"/>
<path d="M 161.5 148.8 L 167.4 151.6" stroke="#a9afba" stroke-width="3.65" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 156.7 88.4 L 158.1 121.4" stroke="#3a3f4b" stroke-width="4.38" stroke-linecap="round"/>
<path d="M 158.1 121.4 L 158.7 149.9" stroke="url(#grad-leg_r-1)" stroke-width="4.05287" stroke-linecap="round"/>
<path d="M 158.7 149.9 L 164.9 150.9" stroke="url(#grad-leg_r-2)" stroke-width="4.05287" stroke-linecap="round"/>
<path d="M 156.7 88.4 L 158.1 121.5" stroke="#3a3f4b" stroke-width="4.38" stroke-linecap="round"/>
<path d="M 158.1 121.5 L 158.5 150.1" stroke="url(#grad-leg_r-1)" stroke-width="4.03337" stroke-linecap="round"/>
<path d="M 158.5 150.1 L 164.7 151.0" stroke="url(#grad-leg_r-2)" stroke-width="4.03337" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 175.2 27.8 L 181.5 8.3" stroke="url(#grad-arm_l-0)" stroke-width="3.85047" stroke-linecap="round"/>

Before

Width:  |  Height:  |  Size: 3.7 KiB

After

Width:  |  Height:  |  Size: 3.9 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 222 KiB

After

Width:  |  Height:  |  Size: 217 KiB

@@ -1,23 +1,24 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Overhead Triceps Stretch</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="166.6" y1="88.2" x2="169.0" y2="121.2"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="158.1" y1="121.4" x2="158.7" y2="149.9"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#9da3ae"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="158.7" y1="149.9" x2="164.9" y2="150.9"><stop offset="0" stop-color="#9da3ae"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="166.6" y1="88.2" x2="167.8" y2="121.6"><stop offset="0" stop-color="#484d59"/><stop offset="1" stop-color="#8c919d"/></linearGradient>
<linearGradient id="grad-leg_l-1" gradientUnits="userSpaceOnUse" x1="167.8" y1="121.6" x2="161.5" y2="148.8"><stop offset="0" stop-color="#8c919d"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="158.1" y1="121.5" x2="158.5" y2="150.1"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#a3a9b4"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="158.5" y1="150.1" x2="164.7" y2="151.0"><stop offset="0" stop-color="#a3a9b4"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-arm_l-0" gradientUnits="userSpaceOnUse" x1="175.2" y1="27.8" x2="181.5" y2="8.3"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#6c717d"/></linearGradient>
<linearGradient id="grad-arm_l-1" gradientUnits="userSpaceOnUse" x1="181.5" y1="8.3" x2="162.9" y2="2.0"><stop offset="0" stop-color="#6c717d"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="164.6" y1="5.3" x2="154.1" y2="20.2"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#53b6ab"/></linearGradient>
</defs>
<path d="M 131.9 154.8 L 174.1 160.9 L 202.3 155.1 L 160.0 148.9 Z" fill="none" stroke="#b9bec9" stroke-width="2.19" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 166.6 88.2 L 169.0 121.2" stroke="url(#grad-leg_l-0)" stroke-width="4.015" stroke-linecap="round"/>
<path d="M 169.0 121.2 L 161.5 148.8" stroke="#a9afba" stroke-width="3.65" stroke-linecap="round"/>
<path d="M 161.5 148.8 L 169.1 151.0" stroke="#a9afba" stroke-width="3.65" stroke-linecap="round"/>
<path d="M 166.6 88.2 L 167.8 121.6" stroke="url(#grad-leg_l-0)" stroke-width="4.06721" stroke-linecap="round"/>
<path d="M 167.8 121.6 L 161.5 148.8" stroke="url(#grad-leg_l-1)" stroke-width="3.74678" stroke-linecap="round"/>
<path d="M 161.5 148.8 L 167.4 151.6" stroke="#a9afba" stroke-width="3.65" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 156.7 88.4 L 158.1 121.4" stroke="#3a3f4b" stroke-width="4.38" stroke-linecap="round"/>
<path d="M 158.1 121.4 L 158.7 149.9" stroke="url(#grad-leg_r-1)" stroke-width="4.05287" stroke-linecap="round"/>
<path d="M 158.7 149.9 L 164.9 150.9" stroke="url(#grad-leg_r-2)" stroke-width="4.05287" stroke-linecap="round"/>
<path d="M 156.7 88.4 L 158.1 121.5" stroke="#3a3f4b" stroke-width="4.38" stroke-linecap="round"/>
<path d="M 158.1 121.5 L 158.5 150.1" stroke="url(#grad-leg_r-1)" stroke-width="4.03337" stroke-linecap="round"/>
<path d="M 158.5 150.1 L 164.7 151.0" stroke="url(#grad-leg_r-2)" stroke-width="4.03337" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 175.2 27.8 L 181.5 8.3" stroke="url(#grad-arm_l-0)" stroke-width="3.85047" stroke-linecap="round"/>

Before

Width:  |  Height:  |  Size: 3.7 KiB

After

Width:  |  Height:  |  Size: 3.9 KiB