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
@@ -3,10 +3,10 @@
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="155.9" y1="116.8" x2="201.2" y2="108.9"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#9ba1ac"/></linearGradient>
<linearGradient id="grad-leg_l-1" gradientUnits="userSpaceOnUse" x1="201.2" y1="108.9" x2="200.0" y2="148.3"><stop offset="0" stop-color="#9ba1ac"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-arm_l-1" gradientUnits="userSpaceOnUse" x1="65.9" y1="86.9" x2="50.6" y2="61.5"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#83cdc3"/></linearGradient>
<linearGradient id="grad-arm_l-1" gradientUnits="userSpaceOnUse" x1="77.0" y1="87.1" x2="72.0" y2="58.0"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#7fcbc1"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="195.3" y1="109.3" x2="196.0" y2="148.7"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#3f4450"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="196.0" y1="148.7" x2="206.9" y2="147.6"><stop offset="0" stop-color="#3f4450"/><stop offset="1" stop-color="#3d424e"/></linearGradient>
<linearGradient id="grad-arm_r-0" gradientUnits="userSpaceOnUse" x1="65.0" y1="117.9" x2="60.1" y2="88.8"><stop offset="0" stop-color="#12978b"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
<linearGradient id="grad-arm_r-0" gradientUnits="userSpaceOnUse" x1="65.0" y1="117.9" x2="70.9" y2="88.9"><stop offset="0" stop-color="#14988c"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
</defs>
<path d="M 23.2 160.6 L 223.0 160.6 L 223.0 150.2 L 23.2 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 58.0 124.0 L 162.0 124.0 L 162.0 124.0 L 58.0 124.0 Z" fill="#c5cad4" stroke="#c5cad4" stroke-width="9" stroke-linecap="round" stroke-linejoin="round"/>
@@ -18,8 +18,8 @@
<path d="M 200.0 148.3 L 211.0 147.7" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 70.9 116.1 L 65.9 86.9" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
<path d="M 65.9 86.9 L 50.6 61.5" stroke="url(#grad-arm_l-1)" stroke-width="5.01396" stroke-linecap="round"/>
<path d="M 70.9 116.1 L 77.0 87.1" stroke="#86cfc5" stroke-width="5" stroke-linecap="round"/>
<path d="M 77.0 87.1 L 72.0 58.0" stroke="url(#grad-arm_l-1)" stroke-width="5.03043" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 70.9 116.1 L 65.0 116.0 L 65.0 117.9" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 155.9 116.8 L 150.0 116.0 L 150.0 117.2" stroke="#3a3f4b" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
@@ -30,15 +30,15 @@
<path d="M 196.0 148.7 L 206.9 147.6" stroke="url(#grad-leg_r-2)" stroke-width="5.96321" stroke-linecap="round"/>
</g>
<g id="arm_r">
<path d="M 65.0 117.9 L 60.1 88.8" stroke="url(#grad-arm_r-0)" stroke-width="5.97737" stroke-linecap="round"/>
<path d="M 60.1 88.8 L 44.9 63.3" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 65.0 117.9 L 70.9 88.9" stroke="url(#grad-arm_r-0)" stroke-width="5.9699" stroke-linecap="round"/>
<path d="M 70.9 88.9 L 66.0 59.8" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
</g>
<path d="M 38.9 66.8 L 50.9 59.7" stroke="#6b7180" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
<circle cx="38.9" cy="66.8" r="4.5" fill="#6b7180"/>
<circle cx="50.9" cy="59.7" r="4.5" fill="#6b7180"/>
<path d="M 44.6 65.1 L 56.6 57.9" stroke="#6b7180" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
<circle cx="44.6" cy="65.1" r="4.5" fill="#6b7180"/>
<circle cx="56.6" cy="57.9" r="4.5" fill="#6b7180"/>
<path d="M 59.1 61.0 L 72.9 58.6" stroke="#6b7180" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
<circle cx="59.1" cy="61.0" r="4.5" fill="#6b7180"/>
<circle cx="72.9" cy="58.6" r="4.5" fill="#6b7180"/>
<path d="M 65.1 59.2 L 78.9 56.8" stroke="#6b7180" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
<circle cx="65.1" cy="59.2" r="4.5" fill="#6b7180"/>
<circle cx="78.9" cy="56.8" r="4.5" fill="#6b7180"/>
<circle id="head" cx="45.2" cy="113.3" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="46.6" y1="103.4" x2="47.6" y2="96.5" 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.5 KiB

After

Width:  |  Height:  |  Size: 4.5 KiB