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>Butterfly Stretch</title>
<defs>
<linearGradient id="grad-leg_l-2" gradientUnits="userSpaceOnUse" x1="193.5" y1="156.8" x2="202.9" y2="161.8"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#48b1a6"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="154.5" y1="118.7" x2="149.2" y2="133.4"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
<linearGradient id="grad-arm_r-0" gradientUnits="userSpaceOnUse" x1="185.5" y1="65.8" x2="183.4" y2="94.7"><stop offset="0" stop-color="#686d79"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_l-1" gradientUnits="userSpaceOnUse" x1="211.0" y1="129.6" x2="186.0" y2="154.4"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="154.5" y1="143.7" x2="154.7" y2="135.6"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
<linearGradient id="grad-arm_l-0" gradientUnits="userSpaceOnUse" x1="207.6" y1="91.1" x2="220.7" y2="105.9"><stop offset="0" stop-color="#808591"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
</defs>
<path d="M 122.3 155.5 L 178.0 167.9 L 225.2 161.5 L 169.6 149.1 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 125.6 156.6 L 181.1 169.0 L 228.4 162.5 L 172.9 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 169.2 118.5 L 214.3 126.3" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
<path d="M 214.3 126.3 L 193.5 156.8" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
<path d="M 193.5 156.8 L 202.9 161.8" stroke="url(#grad-leg_l-2)" stroke-width="5.25531" stroke-linecap="round"/>
<path d="M 169.2 143.5 L 211.0 129.6" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
<path d="M 211.0 129.6 L 186.0 154.4" stroke="url(#grad-leg_l-1)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 186.0 154.4 L 193.3 155.5" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 206.5 64.6 L 194.2 64.6 L 185.5 65.8" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 169.2 118.5 L 160.0 118.0 L 154.5 118.7" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 160.0 118.0 Q 169.4 77.2 194.2 64.6" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<path id="girdle" d="M 207.6 91.1 L 195.3 91.0 L 186.7 92.2" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 169.2 143.5 L 160.0 143.0 L 154.5 143.7" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 160.0 143.0 Q 171.2 104.4 195.3 91.0" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<g id="leg_r">
<path d="M 154.5 118.7 L 149.2 133.4" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 149.2 133.4 L 174.1 157.7" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 174.1 157.7 L 175.2 163.9" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 154.5 143.7 L 154.7 135.6" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 154.7 135.6 L 183.2 153.0" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 183.2 153.0 L 189.4 154.3" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 206.5 64.6 L 205.2 94.4" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 205.2 94.4 L 204.4 124.0" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 207.6 91.1 L 220.7 105.9" stroke="url(#grad-arm_l-0)" stroke-width="5.18602" stroke-linecap="round"/>
<path d="M 220.7 105.9 L 209.0 133.1" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<g id="arm_r">
<path d="M 185.5 65.8 L 183.4 94.7" stroke="url(#grad-arm_r-0)" stroke-width="5.79336" stroke-linecap="round"/>
<path d="M 183.4 94.7 L 181.7 123.5" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 186.7 92.2 L 170.1 117.2" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 170.1 117.2 L 162.0 145.7" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<circle id="head" cx="205.6" cy="59.8" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="209.6" y1="68.9" x2="212.3" y2="74.9" stroke="#3a3f4b" stroke-width="4" stroke-linecap="round"/>
<circle id="head" cx="206.2" cy="84.2" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="210.2" y1="93.3" x2="212.9" y2="99.4" 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