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,20 +1,20 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Goblet Squat</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="164.3" y1="90.6" x2="173.6" y2="121.9"><stop offset="0" stop-color="#28a196"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="170.1" y1="122.0" x2="161.4" y2="149.1"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#2fa499"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="161.4" y1="149.1" x2="169.0" y2="151.4"><stop offset="0" stop-color="#2fa499"/><stop offset="1" stop-color="#37a99d"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="164.3" y1="90.6" x2="176.5" y2="120.9"><stop offset="0" stop-color="#2aa297"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="170.1" y1="122.0" x2="161.4" y2="149.1"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#31a59a"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="161.4" y1="149.1" x2="169.0" y2="151.4"><stop offset="0" stop-color="#31a59a"/><stop offset="1" stop-color="#39a99e"/></linearGradient>
</defs>
<path d="M 144.2 157.6 L 197.4 157.6 L 197.4 150.1 L 144.2 150.1 Z" fill="none" stroke="#b9bec9" stroke-width="2.16" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 164.3 90.6 L 173.6 121.9" stroke="url(#grad-leg_l-0)" stroke-width="3.87943" stroke-linecap="round"/>
<path d="M 173.6 121.9 L 164.3 148.8" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
<path d="M 164.3 148.8 L 171.8 151.3" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
<path d="M 164.3 90.6 L 176.5 120.9" stroke="url(#grad-leg_l-0)" stroke-width="3.8735" stroke-linecap="round"/>
<path d="M 176.5 120.9 L 164.3 146.7" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
<path d="M 164.3 146.7 L 171.5 149.9" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 160.0 91.0 L 170.1 122.0" stroke="#0d9488" stroke-width="4.32" stroke-linecap="round"/>
<path d="M 170.1 122.0 L 161.4 149.1" stroke="url(#grad-leg_r-1)" stroke-width="4.21977" stroke-linecap="round"/>
<path d="M 161.4 149.1 L 169.0 151.4" stroke="url(#grad-leg_r-2)" stroke-width="4.09468" stroke-linecap="round"/>
<path d="M 170.1 122.0 L 161.4 149.1" stroke="url(#grad-leg_r-1)" stroke-width="4.21384" stroke-linecap="round"/>
<path d="M 161.4 149.1 L 169.0 151.4" stroke="url(#grad-leg_r-2)" stroke-width="4.08282" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 169.6 30.1 L 163.7 50.5" stroke="#a9afba" stroke-width="3.6" stroke-linecap="round"/>

Before

Width:  |  Height:  |  Size: 3.3 KiB

After

Width:  |  Height:  |  Size: 3.3 KiB

@@ -1,14 +1,15 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Goblet Squat</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="157.1" y1="118.0" x2="187.1" y2="131.8"><stop offset="0" stop-color="#67c0b5"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="161.4" y1="149.5" x2="168.3" y2="153.3"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#1b9b8f"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="157.1" y1="118.0" x2="187.7" y2="130.5"><stop offset="0" stop-color="#69c1b7"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="183.3" y1="131.0" x2="161.4" y2="149.5"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#0f9589"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="161.4" y1="149.5" x2="168.3" y2="153.3"><stop offset="0" stop-color="#0f9589"/><stop offset="1" stop-color="#1d9c90"/></linearGradient>
</defs>
<path d="M 144.2 158.1 L 197.4 158.1 L 197.4 150.6 L 144.2 150.6 Z" fill="none" stroke="#b9bec9" stroke-width="2.16" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 157.1 118.0 L 187.1 131.8" stroke="url(#grad-leg_l-0)" stroke-width="3.69229" stroke-linecap="round"/>
<path d="M 187.1 131.8 L 164.3 149.2" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
<path d="M 164.3 149.2 L 171.0 153.4" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
<path d="M 157.1 118.0 L 187.7 130.5" stroke="url(#grad-leg_l-0)" stroke-width="3.68514" stroke-linecap="round"/>
<path d="M 187.7 130.5 L 164.3 147.1" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
<path d="M 164.3 147.1 L 170.9 151.5" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 178.0 60.9 L 170.7 80.9" stroke="#a9afba" stroke-width="3.6" stroke-linecap="round"/>
@@ -16,8 +17,8 @@
</g>
<g id="leg_r">
<path d="M 152.8 118.3 L 183.3 131.0" stroke="#0d9488" stroke-width="4.32" stroke-linecap="round"/>
<path d="M 183.3 131.0 L 161.4 149.5" stroke="#0d9488" stroke-width="4.31979" stroke-linecap="round"/>
<path d="M 161.4 149.5 L 168.3 153.3" stroke="url(#grad-leg_r-2)" stroke-width="4.27881" stroke-linecap="round"/>
<path d="M 183.3 131.0 L 161.4 149.5" stroke="url(#grad-leg_r-1)" stroke-width="4.31263" stroke-linecap="round"/>
<path d="M 161.4 149.5 L 168.3 153.3" stroke="url(#grad-leg_r-2)" stroke-width="4.26451" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 178.0 60.9 L 173.7 60.8 L 173.7 62.2" stroke="#3a3f4b" stroke-width="3.6" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 157.1 118.0 L 152.8 117.4 L 152.8 118.3" stroke="#3a3f4b" stroke-width="3.6" stroke-linecap="round" stroke-linejoin="round"/>

Before

Width:  |  Height:  |  Size: 3.1 KiB

After

Width:  |  Height:  |  Size: 3.3 KiB

+2 -2
View File
@@ -16,7 +16,7 @@
"shoulder_l": 5, "elbow_l": 140,
"hip_r": 5, "knee_r": 4, "ankle_r": 0,
"hip_l": 5, "knee_l": 4, "ankle_l": 0,
"pins": {"foot_r": [162, 148], "foot_l": [166, 150],
"pins": {"foot_r": [162, 148], "foot_l": [166, 147],
"hand_r": [185, -8], "hand_l": [189, -6]}
},
{
@@ -28,7 +28,7 @@
"shoulder_l": 15, "elbow_l": 135,
"hip_r": 96, "knee_r": 116, "ankle_r": 20,
"hip_l": 96, "knee_l": 116, "ankle_l": 20,
"pins": {"foot_r": [162, 148], "foot_l": [166, 150],
"pins": {"foot_r": [162, 148], "foot_l": [166, 147],
"hand_r": [196, 36], "hand_l": [200, 38]}
}
]
Binary file not shown.

Before

Width:  |  Height:  |  Size: 229 KiB

After

Width:  |  Height:  |  Size: 229 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 146 KiB

After

Width:  |  Height:  |  Size: 149 KiB

+8 -7
View File
@@ -1,14 +1,15 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Goblet Squat</title>
<defs>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="157.1" y1="118.0" x2="187.1" y2="131.8"><stop offset="0" stop-color="#67c0b5"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="161.4" y1="149.5" x2="168.3" y2="153.3"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#1b9b8f"/></linearGradient>
<linearGradient id="grad-leg_l-0" gradientUnits="userSpaceOnUse" x1="157.1" y1="118.0" x2="187.7" y2="130.5"><stop offset="0" stop-color="#69c1b7"/><stop offset="1" stop-color="#86cfc5"/></linearGradient>
<linearGradient id="grad-leg_r-1" gradientUnits="userSpaceOnUse" x1="183.3" y1="131.0" x2="161.4" y2="149.5"><stop offset="0" stop-color="#0d9488"/><stop offset="1" stop-color="#0f9589"/></linearGradient>
<linearGradient id="grad-leg_r-2" gradientUnits="userSpaceOnUse" x1="161.4" y1="149.5" x2="168.3" y2="153.3"><stop offset="0" stop-color="#0f9589"/><stop offset="1" stop-color="#1d9c90"/></linearGradient>
</defs>
<path d="M 144.2 158.1 L 197.4 158.1 L 197.4 150.6 L 144.2 150.6 Z" fill="none" stroke="#b9bec9" stroke-width="2.16" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 157.1 118.0 L 187.1 131.8" stroke="url(#grad-leg_l-0)" stroke-width="3.69229" stroke-linecap="round"/>
<path d="M 187.1 131.8 L 164.3 149.2" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
<path d="M 164.3 149.2 L 171.0 153.4" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
<path d="M 157.1 118.0 L 187.7 130.5" stroke="url(#grad-leg_l-0)" stroke-width="3.68514" stroke-linecap="round"/>
<path d="M 187.7 130.5 L 164.3 147.1" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
<path d="M 164.3 147.1 L 170.9 151.5" stroke="#86cfc5" stroke-width="3.6" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 178.0 60.9 L 170.7 80.9" stroke="#a9afba" stroke-width="3.6" stroke-linecap="round"/>
@@ -16,8 +17,8 @@
</g>
<g id="leg_r">
<path d="M 152.8 118.3 L 183.3 131.0" stroke="#0d9488" stroke-width="4.32" stroke-linecap="round"/>
<path d="M 183.3 131.0 L 161.4 149.5" stroke="#0d9488" stroke-width="4.31979" stroke-linecap="round"/>
<path d="M 161.4 149.5 L 168.3 153.3" stroke="url(#grad-leg_r-2)" stroke-width="4.27881" stroke-linecap="round"/>
<path d="M 183.3 131.0 L 161.4 149.5" stroke="url(#grad-leg_r-1)" stroke-width="4.31263" stroke-linecap="round"/>
<path d="M 161.4 149.5 L 168.3 153.3" stroke="url(#grad-leg_r-2)" stroke-width="4.26451" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 178.0 60.9 L 173.7 60.8 L 173.7 62.2" stroke="#3a3f4b" stroke-width="3.6" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 157.1 118.0 L 152.8 117.4 L 152.8 118.3" stroke="#3a3f4b" stroke-width="3.6" stroke-linecap="round" stroke-linejoin="round"/>

Before

Width:  |  Height:  |  Size: 3.1 KiB

After

Width:  |  Height:  |  Size: 3.3 KiB