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
+11 -11
View File
@@ -3,10 +3,10 @@
<defs>
<linearGradient id="grad-arm_l-1" gradientUnits="userSpaceOnUse" x1="180.3" y1="60.8" x2="188.7" y2="86.7"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="139.7" y1="60.8" x2="131.3" y2="86.7"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="167.0" y1="116.0" x2="190.0" y2="130.9"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="153.0" y1="116.0" x2="130.0" y2="130.9"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="167.0" y1="116.0" x2="190.0" y2="118.8"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="153.0" y1="116.0" x2="130.0" y2="118.8"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
</defs>
<path d="M 130.0 145.6 L 130.0 165.2 L 190.0 165.2 L 190.0 145.6 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 130.0 147.8 L 130.0 163.0 L 190.0 163.0 L 190.0 147.8 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 160.0 64.0 L 160.0 120.0 L 160.0 120.0 L 160.0 64.0 Z" fill="#c5cad4" stroke="#c5cad4" stroke-width="16" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 135.0 131.0 L 185.0 131.0 L 185.0 131.0 L 135.0 131.0 Z" fill="#c5cad4" stroke="#c5cad4" stroke-width="10" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 160.0 136.0 L 160.0 150.0" stroke="#c5cad4" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
@@ -22,17 +22,17 @@
<path d="M 139.7 60.8 L 131.3 86.7" stroke="url(#grad-arm_r-1)" stroke-width="5.5" stroke-linecap="round"/>
</g>
<g id="leg_l">
<path d="M 167.0 116.0 L 190.0 130.9" stroke="url(#grad-leg_l-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 190.0 130.9 L 199.4 169.8" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 199.4 169.8 L 204.2 168.1" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 167.0 116.0 L 190.0 118.8" stroke="url(#grad-leg_l-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 190.0 118.8 L 186.5 157.7" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 186.5 157.7 L 191.9 160.2" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 153.0 116.0 L 130.0 130.9" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 130.0 130.9 L 120.6 169.8" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 120.6 169.8 L 115.8 168.1" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 153.0 116.0 L 130.0 118.8" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 130.0 118.8 L 133.5 157.7" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 133.5 157.7 L 128.1 160.2" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
</g>
<path d="M 130.0 143.9 L 130.0 117.9" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 190.0 143.9 L 190.0 117.9" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 130.0 131.8 L 130.0 105.8" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 190.0 131.8 L 190.0 105.8" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<circle id="head" cx="160.0" cy="12.6" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<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"/>

Before

Width:  |  Height:  |  Size: 3.8 KiB

After

Width:  |  Height:  |  Size: 3.8 KiB

+11 -11
View File
@@ -3,10 +3,10 @@
<defs>
<linearGradient id="grad-arm_l-1" gradientUnits="userSpaceOnUse" x1="180.3" y1="60.8" x2="188.7" y2="86.7"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="139.7" y1="60.8" x2="131.3" y2="86.7"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="167.0" y1="116.0" x2="172.6" y2="133.1"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="153.0" y1="116.0" x2="147.4" y2="133.1"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="167.0" y1="116.0" x2="172.6" y2="119.2"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="153.0" y1="116.0" x2="147.4" y2="119.2"><stop offset="0" stop-color="#86cfc5"/><stop offset="1" stop-color="#0d9488"/></linearGradient>
</defs>
<path d="M 130.0 145.6 L 130.0 165.2 L 190.0 165.2 L 190.0 145.6 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 130.0 147.8 L 130.0 163.0 L 190.0 163.0 L 190.0 147.8 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 160.0 64.0 L 160.0 120.0 L 160.0 120.0 L 160.0 64.0 Z" fill="#c5cad4" stroke="#c5cad4" stroke-width="16" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 135.0 131.0 L 185.0 131.0 L 185.0 131.0 L 135.0 131.0 Z" fill="#c5cad4" stroke="#c5cad4" stroke-width="10" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 160.0 136.0 L 160.0 150.0" stroke="#c5cad4" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
@@ -22,17 +22,17 @@
<path d="M 139.7 60.8 L 131.3 86.7" stroke="url(#grad-arm_r-1)" stroke-width="5.5" stroke-linecap="round"/>
</g>
<g id="leg_l">
<path d="M 167.0 116.0 L 172.6 133.1" stroke="url(#grad-leg_l-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 172.6 133.1 L 174.9 172.8" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 174.9 172.8 L 176.1 171.7" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 167.0 116.0 L 172.6 119.2" stroke="url(#grad-leg_l-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 172.6 119.2 L 171.8 158.0" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 171.8 158.0 L 173.1 160.7" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 153.0 116.0 L 147.4 133.1" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 147.4 133.1 L 145.1 172.8" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 145.1 172.8 L 143.9 171.7" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 153.0 116.0 L 147.4 119.2" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 147.4 119.2 L 148.2 158.0" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
<path d="M 148.2 158.0 L 146.9 160.7" stroke="#0d9488" stroke-width="6" stroke-linecap="round"/>
</g>
<path d="M 147.4 146.1 L 147.4 120.1" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 172.6 146.1 L 172.6 120.1" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 147.4 132.2 L 147.4 106.2" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<path d="M 172.6 132.2 L 172.6 106.2" stroke="#6b7180" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<circle id="head" cx="160.0" cy="12.6" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<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"/>

Before

Width:  |  Height:  |  Size: 3.8 KiB

After

Width:  |  Height:  |  Size: 3.8 KiB