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
+7 -8
View File
@@ -1,26 +1,25 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Plank</title>
<defs>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="177.9" y1="114.8" x2="204.3" y2="151.9"><stop offset="0" stop-color="#868b97"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
<linearGradient id="grad-leg_l-2" gradientUnits="userSpaceOnUse" x1="238.4" y1="152.3" x2="238.4" y2="163.2"><stop offset="0" stop-color="#3a3f4b"/><stop offset="1" stop-color="#3e434f"/></linearGradient>
<linearGradient id="grad-leg_r-0" gradientUnits="userSpaceOnUse" x1="177.9" y1="114.8" x2="204.3" y2="151.9"><stop offset="0" stop-color="#9499a5"/><stop offset="1" stop-color="#a9afba"/></linearGradient>
</defs>
<path d="M 42.3 160.6 L 270.6 160.6 L 270.6 150.2 L 42.3 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 41.3 160.6 L 280.0 160.6 L 280.0 150.2 L 41.3 150.2 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<g id="arm_r">
<path d="M 93.2 121.4 L 93.2 150.9" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 93.2 150.9 L 63.2 150.9" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 177.9 114.8 L 204.3 151.9" stroke="url(#grad-leg_r-0)" stroke-width="5.15881" stroke-linecap="round"/>
<path d="M 204.3 151.9 L 244.3 151.9" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 244.3 151.9 L 244.3 162.7" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 177.9 114.8 L 204.3 151.9" stroke="url(#grad-leg_r-0)" stroke-width="5.09618" stroke-linecap="round"/>
<path d="M 204.3 151.9 L 242.5 140.3" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 242.5 140.3 L 245.8 150.7" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 87.3 123.2 L 87.3 121.3 L 93.2 121.4" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 172.0 115.2 L 172.0 114.0 L 177.9 114.8" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 172.0 114.0 Q 128.7 117.7 87.3 121.3" stroke="#0d9488" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 172.0 115.2 L 198.4 152.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 198.4 152.3 L 238.4 152.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 238.4 152.3 L 238.4 163.2" stroke="url(#grad-leg_l-2)" stroke-width="5.98121" stroke-linecap="round"/>
<path d="M 198.4 152.3 L 236.6 140.8" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 236.6 140.8 L 239.9 151.2" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 87.3 123.2 L 87.3 152.8" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>

Before

Width:  |  Height:  |  Size: 2.8 KiB

After

Width:  |  Height:  |  Size: 2.6 KiB

+16 -16
View File
@@ -1,29 +1,29 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Plank</title>
<path d="M 42.3 160.9 L 270.6 160.9 L 270.6 150.5 L 42.3 150.5 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 41.3 160.9 L 280.0 160.9 L 280.0 150.5 L 41.3 150.5 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<g id="arm_r">
<path d="M 90.2 122.5 L 90.2 152.1" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 90.2 152.1 L 60.2 152.1" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 90.2 121.5 L 89.2 151.0" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 89.2 151.0 L 59.2 150.0" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 173.9 137.8 L 219.2 145.6" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 219.2 145.6 L 258.6 152.5" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 258.6 152.5 L 256.7 163.1" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 173.9 136.8 L 219.2 144.6" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 219.2 144.6 L 259.1 141.9" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 259.1 141.9 L 268.0 148.2" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 84.3 124.4 L 84.3 122.5 L 90.2 122.5" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 168.0 138.2 L 168.0 137.0 L 173.9 137.8" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 168.0 137.0 Q 125.2 129.6 84.3 122.5" stroke="#0d9488" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<path id="girdle" d="M 84.3 123.4 L 84.3 121.5 L 90.2 121.5" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 168.0 137.2 L 168.0 136.0 L 173.9 136.8" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 168.0 136.0 Q 125.2 128.6 84.3 121.5" stroke="#0d9488" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 168.0 138.2 L 213.3 146.1" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 213.3 146.1 L 252.7 152.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 252.7 152.9 L 250.8 163.6" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 168.0 137.2 L 213.3 145.1" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 213.3 145.1 L 253.2 142.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 253.2 142.3 L 262.1 148.7" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 84.3 124.4 L 84.3 153.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 84.3 153.9 L 54.3 153.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 84.3 123.4 L 83.2 152.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 83.2 152.9 L 53.3 151.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<circle id="head" cx="64.6" cy="119.0" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="55.9" y1="124.0" x2="49.8" y2="127.4" stroke="#3a3f4b" stroke-width="4" stroke-linecap="round"/>
<circle id="head" cx="64.6" cy="118.0" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="55.9" y1="123.0" x2="49.8" y2="126.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: 2.3 KiB

After

Width:  |  Height:  |  Size: 2.3 KiB

+7 -7
View File
@@ -10,18 +10,18 @@
"neck": 0, "head": -65,
"shoulder_r": 95, "elbow_r": 90,
"shoulder_l": 95, "elbow_l": 90,
"hip_r": 60, "knee_r": 55,
"hip_l": 60, "knee_l": 55
"hip_r": 60, "knee_r": 72,
"hip_l": 60, "knee_l": 72
},
{
"hold": 1.8, "tween": 0.7,
"root": {"pos": [168, 137], "yaw": 180, "pitch": 80},
"root": {"pos": [168, 136], "yaw": 180, "pitch": 80},
"spine": [0, 0],
"neck": 0, "head": -50,
"shoulder_r": 80, "elbow_r": 90,
"shoulder_l": 80, "elbow_l": 90,
"hip_r": 0, "knee_r": 0,
"hip_l": 0, "knee_l": 0
"shoulder_r": 82, "elbow_r": 90,
"shoulder_l": 82, "elbow_l": 90,
"hip_r": 0, "knee_r": 14, "ankle_r": -50,
"hip_l": 0, "knee_l": 14, "ankle_l": -50
}
]
}
Binary file not shown.

Before

Width:  |  Height:  |  Size: 115 KiB

After

Width:  |  Height:  |  Size: 117 KiB

+16 -16
View File
@@ -1,29 +1,29 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 180" fill="none">
<title>Plank</title>
<path d="M 42.3 160.9 L 270.6 160.9 L 270.6 150.5 L 42.3 150.5 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<path d="M 41.3 160.9 L 280.0 160.9 L 280.0 150.5 L 41.3 150.5 Z" fill="none" stroke="#b9bec9" stroke-width="3" stroke-linejoin="round"/>
<g id="arm_r">
<path d="M 90.2 122.5 L 90.2 152.1" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 90.2 152.1 L 60.2 152.1" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 90.2 121.5 L 89.2 151.0" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 89.2 151.0 L 59.2 150.0" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<g id="leg_r">
<path d="M 173.9 137.8 L 219.2 145.6" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 219.2 145.6 L 258.6 152.5" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 258.6 152.5 L 256.7 163.1" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 173.9 136.8 L 219.2 144.6" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 219.2 144.6 L 259.1 141.9" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
<path d="M 259.1 141.9 L 268.0 148.2" stroke="#a9afba" stroke-width="5" stroke-linecap="round"/>
</g>
<path id="girdle" d="M 84.3 124.4 L 84.3 122.5 L 90.2 122.5" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 168.0 138.2 L 168.0 137.0 L 173.9 137.8" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 168.0 137.0 Q 125.2 129.6 84.3 122.5" stroke="#0d9488" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<path id="girdle" d="M 84.3 123.4 L 84.3 121.5 L 90.2 121.5" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="pelvisBar" d="M 168.0 137.2 L 168.0 136.0 L 173.9 136.8" stroke="#0d9488" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
<path id="spine" d="M 168.0 136.0 Q 125.2 128.6 84.3 121.5" stroke="#0d9488" stroke-width="6" stroke-linecap="round" stroke-linejoin="round"/>
<g id="leg_l">
<path d="M 168.0 138.2 L 213.3 146.1" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 213.3 146.1 L 252.7 152.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 252.7 152.9 L 250.8 163.6" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 168.0 137.2 L 213.3 145.1" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 213.3 145.1 L 253.2 142.3" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 253.2 142.3 L 262.1 148.7" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<g id="arm_l">
<path d="M 84.3 124.4 L 84.3 153.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 84.3 153.9 L 54.3 153.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 84.3 123.4 L 83.2 152.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
<path d="M 83.2 152.9 L 53.3 151.9" stroke="#3a3f4b" stroke-width="6" stroke-linecap="round"/>
</g>
<circle id="head" cx="64.6" cy="119.0" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="55.9" y1="124.0" x2="49.8" y2="127.4" stroke="#3a3f4b" stroke-width="4" stroke-linecap="round"/>
<circle id="head" cx="64.6" cy="118.0" r="10" fill="white" stroke="#3a3f4b" stroke-width="6"/>
<line id="nose" x1="55.9" y1="123.0" x2="49.8" y2="126.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: 2.3 KiB

After

Width:  |  Height:  |  Size: 2.3 KiB