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
+8 -8
View File
@@ -2,8 +2,8 @@
<title>Rotary</title>
<defs>
<linearGradient id="grad-arm_l-1" gradientUnits="userSpaceOnUse" x1="188.7" y1="50.1" x2="211.3" y2="58.5"><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="122.0" x2="179.7" y2="135.7"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="153.0" y1="122.0" x2="140.3" y2="135.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="122.0" x2="179.7" y2="118.9"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="153.0" y1="122.0" x2="140.3" y2="118.9"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-arm_r-0" gradientUnits="userSpaceOnUse" x1="152.9" y1="39.8" x2="174.5" y2="53.0"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
</defs>
<path d="M 130.0 144.5 L 130.0 166.5 L 190.0 166.5 L 190.0 144.5 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
@@ -18,14 +18,14 @@
<path d="M 188.7 50.1 L 211.3 58.5" stroke="url(#grad-arm_l-1)" stroke-width="5.5" stroke-linecap="round"/>
</g>
<g id="leg_l">
<path d="M 167.0 122.0 L 179.7 135.7" stroke="url(#grad-leg_l-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 179.7 135.7 L 183.5 175.5" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 183.5 175.5 L 186.3 175.0" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 167.0 122.0 L 179.7 118.9" stroke="url(#grad-leg_l-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 179.7 118.9 L 177.0 158.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 177.0 158.3 L 180.0 160.2" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 153.0 122.0 L 140.3 135.7" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 140.3 135.7 L 136.5 175.5" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 136.5 175.5 L 133.7 175.0" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 153.0 122.0 L 140.3 118.9" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 140.3 118.9 L 143.0 158.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 143.0 158.3 L 140.0 160.2" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="arm_r">
<path d="M 152.9 39.8 L 174.5 53.0" stroke="url(#grad-arm_r-0)" stroke-width="5.5" stroke-linecap="round"/>

Before

Width:  |  Height:  |  Size: 3.8 KiB

After

Width:  |  Height:  |  Size: 3.8 KiB

+8 -8
View File
@@ -2,8 +2,8 @@
<title>Rotary</title>
<defs>
<linearGradient id="grad-arm_r-1" gradientUnits="userSpaceOnUse" x1="131.3" y1="50.1" x2="108.7" y2="58.5"><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="122.0" x2="179.7" y2="135.7"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="153.0" y1="122.0" x2="140.3" y2="135.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="122.0" x2="179.7" y2="118.9"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="153.0" y1="122.0" x2="140.3" y2="118.9"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-arm_l-0" gradientUnits="userSpaceOnUse" x1="167.1" y1="39.8" x2="145.5" y2="53.0"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
</defs>
<path d="M 130.0 144.5 L 130.0 166.5 L 190.0 166.5 L 190.0 144.5 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
@@ -18,14 +18,14 @@
<path d="M 131.3 50.1 L 108.7 58.5" stroke="url(#grad-arm_r-1)" stroke-width="5.5" stroke-linecap="round"/>
</g>
<g id="leg_l">
<path d="M 167.0 122.0 L 179.7 135.7" stroke="url(#grad-leg_l-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 179.7 135.7 L 183.5 175.5" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 183.5 175.5 L 186.3 175.0" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 167.0 122.0 L 179.7 118.9" stroke="url(#grad-leg_l-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 179.7 118.9 L 177.0 158.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 177.0 158.3 L 180.0 160.2" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 153.0 122.0 L 140.3 135.7" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 140.3 135.7 L 136.5 175.5" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 136.5 175.5 L 133.7 175.0" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 153.0 122.0 L 140.3 118.9" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 140.3 118.9 L 143.0 158.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 143.0 158.3 L 140.0 160.2" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 167.1 39.8 L 145.5 53.0" stroke="url(#grad-arm_l-0)" stroke-width="5.5" stroke-linecap="round"/>

Before

Width:  |  Height:  |  Size: 3.8 KiB

After

Width:  |  Height:  |  Size: 3.8 KiB

+4 -4
View File
@@ -19,8 +19,8 @@
"neck": {"rotation": 18},
"shoulder_r": 70, "elbow_r": 10,
"shoulder_l": 70, "elbow_l": 10,
"hip_r": {"flexion": 82, "abduction": 16}, "knee_r": 70,
"hip_l": {"flexion": 82, "abduction": 16}, "knee_l": 70
"hip_r": {"flexion": 104, "abduction": 16}, "knee_r": 104,
"hip_l": {"flexion": 104, "abduction": 16}, "knee_l": 104
},
{
"hold": 0.4, "tween": 1.0,
@@ -29,8 +29,8 @@
"neck": {"rotation": -18},
"shoulder_r": 70, "elbow_r": 10,
"shoulder_l": 70, "elbow_l": 10,
"hip_r": {"flexion": 82, "abduction": 16}, "knee_r": 70,
"hip_l": {"flexion": 82, "abduction": 16}, "knee_l": 70
"hip_r": {"flexion": 104, "abduction": 16}, "knee_r": 104,
"hip_l": {"flexion": 104, "abduction": 16}, "knee_l": 104
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 189 KiB

After

Width:  |  Height:  |  Size: 184 KiB

+8 -8
View File
@@ -2,8 +2,8 @@
<title>Rotary</title>
<defs>
<linearGradient id="grad-arm_l-1" gradientUnits="userSpaceOnUse" x1="188.7" y1="50.1" x2="211.3" y2="58.5"><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="122.0" x2="179.7" y2="135.7"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="153.0" y1="122.0" x2="140.3" y2="135.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="122.0" x2="179.7" y2="118.9"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="153.0" y1="122.0" x2="140.3" y2="118.9"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
<linearGradient id="grad-arm_r-0" gradientUnits="userSpaceOnUse" x1="152.9" y1="39.8" x2="174.5" y2="53.0"><stop offset="0" stop-color="#a9afba"/><stop offset="1" stop-color="#3a3f4b"/></linearGradient>
</defs>
<path d="M 130.0 144.5 L 130.0 166.5 L 190.0 166.5 L 190.0 144.5 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
@@ -18,14 +18,14 @@
<path d="M 188.7 50.1 L 211.3 58.5" stroke="url(#grad-arm_l-1)" stroke-width="5.5" stroke-linecap="round"/>
</g>
<g id="leg_l">
<path d="M 167.0 122.0 L 179.7 135.7" stroke="url(#grad-leg_l-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 179.7 135.7 L 183.5 175.5" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 183.5 175.5 L 186.3 175.0" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 167.0 122.0 L 179.7 118.9" stroke="url(#grad-leg_l-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 179.7 118.9 L 177.0 158.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 177.0 158.3 L 180.0 160.2" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 153.0 122.0 L 140.3 135.7" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 140.3 135.7 L 136.5 175.5" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 136.5 175.5 L 133.7 175.0" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 153.0 122.0 L 140.3 118.9" stroke="url(#grad-leg_r-0)" stroke-width="5.5" stroke-linecap="round"/>
<path d="M 140.3 118.9 L 143.0 158.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 143.0 158.3 L 140.0 160.2" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="arm_r">
<path d="M 152.9 39.8 L 174.5 53.0" stroke="url(#grad-arm_r-0)" stroke-width="5.5" stroke-linecap="round"/>

Before

Width:  |  Height:  |  Size: 3.8 KiB

After

Width:  |  Height:  |  Size: 3.8 KiB