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,34 +1,34 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Kneeling Hip Flexor Stretch</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="165.9" y1="108.8" x2="150.2" y2="151.3"><stop offset="0" stop-color="#6ac1b7"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-arm_l-0" gradientUnits="userSpaceOnUse" x1="195.4" y1="30.0" x2="199.8" y2="59.2"><stop offset="0" stop-color="#a2a8b3"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="194.5" y1="61.0" x2="200.3" y2="89.9"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#414652"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="165.9" y1="108.8" x2="150.2" y2="151.3"><stop offset="0" stop-color="#6dc3b8"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="206.0" y1="111.2" x2="206.0" y2="150.6"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#3b404c"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="206.0" y1="150.6" x2="216.9" y2="149.4"><stop offset="0" stop-color="#3b404c"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
</defs>
<path d="M 81.2 160.5 L 238.2 160.5 L 238.2 150.1 L 81.2 150.1 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 80.8 160.5 L 277.7 160.5 L 277.7 150.1 L 80.8 150.1 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 165.9 108.8 L 150.2 151.3" stroke="url(#grad-leg_l-0)" stroke-width="5.11488" stroke-linecap="round"/>
<path d="M 150.2 151.3 L 110.3 148.6" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
<path d="M 110.3 148.6 L 100.8 154.2" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
<path d="M 165.9 108.8 L 150.2 151.3" stroke="url(#grad-leg_l-0)" stroke-width="5.10264" stroke-linecap="round"/>
<path d="M 150.2 151.3 L 110.8 144.5" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
<path d="M 110.8 144.5 L 100.8 149.1" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 195.4 30.0 L 199.8 59.2" stroke="url(#grad-arm_l-0)" stroke-width="5.03096" stroke-linecap="round"/>
<path d="M 199.8 59.2 L 204.9 88.3" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 237.5 73.3 L 209.1 82.6" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 209.1 82.6 L 206.0 112.0" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 237.5 73.3 L 231.6 73.2 L 231.6 75.1" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 165.9 108.8 L 160.0 108.0 L 160.0 109.2" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 160.0 108.0 Q 183.9 64.5 231.6 73.2" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<g id="leg_r">
<path d="M 160.0 109.2 L 206.0 111.2" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 206.0 111.2 L 206.0 150.6" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 206.0 150.6 L 216.9 149.4" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 206.0 111.2 L 206.0 150.6" stroke="url(#grad-leg_r-1)" stroke-width="5.99516" stroke-linecap="round"/>
<path d="M 206.0 150.6 L 216.9 149.4" stroke="url(#grad-leg_r-2)" stroke-width="5.99516" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 195.4 30.0 L 189.5 29.9 L 189.5 31.8" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 165.9 108.8 L 160.0 108.0 L 160.0 109.2" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 160.0 108.0 Q 167.5 65.2 189.5 29.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<g id="arm_r">
<path d="M 189.5 31.8 L 194.5 61.0" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 194.5 61.0 L 200.3 89.9" stroke="url(#grad-arm_r-1)" stroke-width="5.97013" stroke-linecap="round"/>
<path d="M 231.6 75.1 L 203.1 84.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 203.1 84.3 L 202.0 113.8" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<circle id="head" cx="200.7" cy="13.6" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="210.0" y1="17.3" x2="216.5" y2="19.9" stroke="#3a3f4b" stroke-width="4" stroke-linecap="round"/>
<circle id="head" cx="251.6" cy="73.9" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="253.4" y1="83.7" x2="254.6" y2="90.5" stroke="#3a3f4b" stroke-width="4" 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.0 KiB

After

Width:  |  Height:  |  Size: 3.0 KiB