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
@@ -7,7 +7,7 @@
<linearGradient id="grad-arm_l-0" gradientUnits="userSpaceOnUse" x1="169.3" y1="32.1" x2="169.3" y2="52.7"><stop offset="0" stop-color="#a2a8b3"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="165.2" y1="54.0" x2="167.0" y2="74.6"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#414652"/></linearGradient>
</defs>
<path d="M 121.0 157.5 L 207.2 157.5 L 207.2 150.2 L 121.0 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<path d="M 143.2 157.5 L 196.4 157.5 L 196.4 150.2 L 143.2 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 168.9 122.3" stroke="url(#grad-leg_l-0)" stroke-width="3.78058" stroke-linecap="round"/>
<path d="M 168.9 122.3 L 161.4 148.9" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>

Before

Width:  |  Height:  |  Size: 3.5 KiB

After

Width:  |  Height:  |  Size: 3.5 KiB

@@ -1,34 +1,34 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Standing Forward Fold</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="155.0" y1="92.3" x2="150.1" y2="123.7"><stop offset="0" stop-color="#2da498"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="146.9" y1="124.1" x2="129.4" y2="145.6"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#27a195"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="129.4" y1="145.6" x2="136.1" y2="149.3"><stop offset="0" stop-color="#27a195"/><stop offset="1" stop-color="#34a79c"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="155.7" y1="89.5" x2="159.2" y2="121.1"><stop offset="0" stop-color="#26a095"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="155.8" y1="121.3" x2="158.6" y2="148.7"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#35a89c"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="158.6" y1="148.7" x2="166.1" y2="147.2"><stop offset="0" stop-color="#35a89c"/><stop offset="1" stop-color="#30a599"/></linearGradient>
</defs>
<path d="M 121.0 157.5 L 207.2 157.5 L 207.2 150.2 L 121.0 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<path d="M 143.2 157.4 L 196.4 157.4 L 196.4 150.2 L 143.2 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="2.1" stroke-linejoin="round"/>
<g id="arm_l">
<path d="M 183.3 143.0 L 178.2 163.0" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 178.2 163.0 L 198.8 158.8" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 182.7 134.5 L 162.7 128.6" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 162.7 128.6 L 168.4 148.8" stroke="#a9afba" stroke-width="3.5" stroke-linecap="round"/>
</g>
<g id="leg_l">
<path d="M 155.0 92.3 L 150.1 123.7" stroke="url(#grad-leg_l-0)" stroke-width="3.75663" stroke-linecap="round"/>
<path d="M 150.1 123.7 L 131.5 144.3" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 131.5 144.3 L 138.0 148.3" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 183.3 143.0 L 179.2 142.9 L 179.2 144.3" stroke="#0d9488" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 155.0 92.3 L 150.9 91.8 L 150.9 92.7" stroke="#0d9488" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 150.9 91.8 Q 171.3 114.8 179.2 142.9" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round" stroke-linejoin="round"/>
<g id="arm_r">
<path d="M 179.2 144.3 L 175.7 164.7" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 175.7 164.7 L 195.5 157.7" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 155.7 89.5 L 159.2 121.1" stroke="url(#grad-leg_l-0)" stroke-width="3.77747" stroke-linecap="round"/>
<path d="M 159.2 121.1 L 161.4 148.5" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
<path d="M 161.4 148.5 L 168.9 147.2" stroke="#86cfc5" stroke-width="3.5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 182.7 134.5 L 178.6 134.5 L 178.6 135.8" stroke="#0d9488" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 155.7 89.5 L 151.6 89.0 L 151.6 89.9" stroke="#0d9488" stroke-width="3.5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 151.6 89.0 Q 188.0 99.4 178.6 134.5" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round" stroke-linejoin="round"/>
<g id="leg_r">
<path d="M 150.9 92.7 L 146.9 124.1" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 146.9 124.1 L 129.4 145.6" stroke="url(#grad-leg_r-1)" stroke-width="4.12577" stroke-linecap="round"/>
<path d="M 129.4 145.6 L 136.1 149.3" stroke="url(#grad-leg_r-2)" stroke-width="4.01252" stroke-linecap="round"/>
<path d="M 151.6 89.9 L 155.8 121.3" stroke="#0d9488" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 155.8 121.3 L 158.6 148.7" stroke="url(#grad-leg_r-1)" stroke-width="4.08327" stroke-linecap="round"/>
<path d="M 158.6 148.7 L 166.1 147.2" stroke="url(#grad-leg_r-2)" stroke-width="3.98294" stroke-linecap="round"/>
</g>
<circle id="head" cx="180.6" cy="156.6" r="7.0" fill="white" stroke="#3a3f4b" stroke-width="4.2"/>
<line id="nose" x1="177.3" y1="162.8" x2="175.0" y2="167.1" stroke="#3a3f4b" stroke-width="2.8" stroke-linecap="round"/>
<g id="arm_r">
<path d="M 178.6 135.8 L 158.3 132.3" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
<path d="M 158.3 132.3 L 165.6 151.3" stroke="#3a3f4b" stroke-width="4.2" stroke-linecap="round"/>
</g>
<circle id="head" cx="172.0" cy="146.6" r="7.0" fill="white" stroke="#3a3f4b" stroke-width="4.2"/>
<line id="nose" x1="165.8" y1="143.4" x2="161.5" y2="141.1" stroke="#3a3f4b" stroke-width="2.8" stroke-linecap="round"/>
<g font-family="-apple-system, Helvetica, sans-serif" font-size="11" fill="#6b7180">
<line x1="224" y1="16" x2="238" y2="16" stroke="#3a3f4b" stroke-width="4" stroke-linecap="round"/>
<text x="243" y="20">near</text>

Before

Width:  |  Height:  |  Size: 3.1 KiB

After

Width:  |  Height:  |  Size: 3.1 KiB