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
@@ -6,7 +6,7 @@
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="171.2" y1="111.6" x2="168.0" y2="150.9"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#3b404c"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="168.0" y1="150.9" x2="179.0" y2="151.7"><stop offset="0" stop-color="#3b404c"/><stop offset="1" stop-color="#3d424e"/></linearGradient>
</defs>
<path d="M 105.8 160.8 L 213.8 160.8 L 213.8 150.3 L 105.8 150.3 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 105.8 160.8 L 208.2 160.8 L 208.2 150.3 L 105.8 150.3 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 120.0 128.0 L 114.0 62.0 L 114.0 62.0 L 120.0 128.0 Z" fill="#c5cad4" stroke="#c5cad4" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 106.0 130.0 L 150.0 130.0 L 150.0 130.0 L 106.0 130.0 Z" fill="#c5cad4" stroke="#c5cad4" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 122.0 132.0 L 122.0 150.0" stroke="#c5cad4" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
@@ -18,8 +18,8 @@
<path d="M 172.0 148.4 L 182.9 149.6" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 130.9 42.5 L 159.5 33.6" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 159.5 33.6 L 143.5 8.6" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 130.9 42.5 L 132.4 72.0" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 132.4 72.0 L 161.0 63.1" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 130.9 42.5 L 125.0 42.4 L 125.0 44.3" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 133.9 126.8 L 128.0 126.0 L 128.0 127.2" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
@@ -30,10 +30,10 @@
<path d="M 168.0 150.9 L 179.0 151.7" stroke="url(#grad-leg_r-2)" stroke-width="5.97919" stroke-linecap="round"/>
</g>
<g id="arm_r">
<path d="M 125.0 44.3 L 153.6 35.4" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 153.6 35.4 L 137.5 10.5" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 125.0 44.3 L 126.4 73.8" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 126.4 73.8 L 155.0 64.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<path d="M 140.5 23.5 L 140.5 -4.5" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 158.0 78.0 L 158.0 50.0" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<circle id="head" cx="127.8" cy="22.9" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="137.7" y1="24.3" x2="144.6" y2="25.2" stroke="#3a3f4b" stroke-width="4" stroke-linecap="round"/>
<g font-family="-apple-system, Helvetica, sans-serif" font-size="11" fill="#6b7180">

Before

Width:  |  Height:  |  Size: 4.1 KiB

After

Width:  |  Height:  |  Size: 4.1 KiB

@@ -6,7 +6,7 @@
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="171.2" y1="111.6" x2="168.0" y2="150.9"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#3b404c"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="168.0" y1="150.9" x2="179.0" y2="151.7"><stop offset="0" stop-color="#3b404c"/><stop offset="1" stop-color="#3d424e"/></linearGradient>
</defs>
<path d="M 105.8 160.8 L 213.8 160.8 L 213.8 150.3 L 105.8 150.3 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 105.8 160.8 L 208.2 160.8 L 208.2 150.3 L 105.8 150.3 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 120.0 128.0 L 114.0 62.0 L 114.0 62.0 L 120.0 128.0 Z" fill="#c5cad4" stroke="#c5cad4" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 106.0 130.0 L 150.0 130.0 L 150.0 130.0 L 106.0 130.0 Z" fill="#c5cad4" stroke="#c5cad4" stroke-width="8" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 122.0 132.0 L 122.0 150.0" stroke="#c5cad4" stroke-width="4" stroke-linecap="round" stroke-linejoin="round"/>
@@ -18,8 +18,8 @@
<path d="M 172.0 148.4 L 182.9 149.6" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 173.5 57.8 L 201.8 47.9" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 201.8 47.9 L 178.7 29.0" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 173.5 57.8 L 167.7 86.8" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 167.7 86.8 L 196.0 76.8" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 173.5 57.8 L 167.6 57.7 L 167.6 59.6" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 133.9 126.8 L 128.0 126.0 L 128.0 127.2" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
@@ -30,10 +30,10 @@
<path d="M 168.0 150.9 L 179.0 151.7" stroke="url(#grad-leg_r-2)" stroke-width="5.97919" stroke-linecap="round"/>
</g>
<g id="arm_r">
<path d="M 167.6 59.6 L 195.9 49.7" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 195.9 49.7 L 172.7 30.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 167.6 59.6 L 161.7 88.6" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 161.7 88.6 L 190.0 78.7" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<path d="M 175.7 44.0 L 175.7 16.0" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 193.0 91.8 L 193.0 63.8" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<circle id="head" cx="186.2" cy="50.3" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="193.7" y1="57.0" x2="198.9" y2="61.6" stroke="#3a3f4b" stroke-width="4" stroke-linecap="round"/>
<g font-family="-apple-system, Helvetica, sans-serif" font-size="11" fill="#6b7180">

Before

Width:  |  Height:  |  Size: 4.1 KiB

After

Width:  |  Height:  |  Size: 4.1 KiB